ci: update artifact hub metadata for v0.2.3

- Add isFullUrl() helper to detect full vs proxy URLs
- Support both K8s proxy URLs and direct HTTP/HTTPS URLs
- Use fetch() for full URLs, ApiProxy for K8s proxy URLs
- Improve error messages with context-specific guidance
- Update settings with examples for both URL types
- Version bump to 0.2.3

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>

artifacthub-pkg.yml

@@ -1,4 +1,4 @@
-version: 0.2.2
+version: 0.2.3
 name: headlamp-polaris-plugin
 displayName: Polaris
 createdAt: "2026-02-05T19:00:00Z"
@@ -28,7 +28,7 @@ maintainers:
   - name: cpfarhood
     email: "chris@farhood.org"
 annotations:
-  headlamp/plugin/archive-url: "https://github.com/cpfarhood/headlamp-polaris-plugin/releases/download/v0.2.2/headlamp-polaris-plugin-0.2.2.tar.gz"
+  headlamp/plugin/archive-url: "https://github.com/cpfarhood/headlamp-polaris-plugin/releases/download/v0.2.3/headlamp-polaris-plugin-0.2.3.tar.gz"
   headlamp/plugin/version-compat: ">=0.26"
-  headlamp/plugin/archive-checksum: sha256:22400516eed9645e463873e7a5ab6c2dab8bfa8fca8a51bb51b0475079ca8c83
+  headlamp/plugin/archive-checksum: sha256:20f0a39450cb45258b5b8f10252a6d9ce1d6bdccd39c2347f5b316020ac2cb01
   headlamp/plugin/distro-compat: in-cluster

package.json

@@ -1,6 +1,6 @@
 {
   "name": "headlamp-polaris-plugin",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Headlamp plugin for Fairwinds Polaris audit results",
   "scripts": {
     "start": "headlamp-plugin start",

src/api/polaris.ts

@@ -178,6 +178,10 @@ function getPolarisApiPath(): string {
   return baseUrl.endsWith('/') ? `${baseUrl}results.json` : `${baseUrl}/results.json`;
 }
 
+function isFullUrl(url: string): boolean {
+  return url.startsWith('http://') || url.startsWith('https://');
+}
+
 interface PolarisDataState {
   data: AuditData | null;
   loading: boolean;
@@ -195,7 +199,21 @@ export function usePolarisData(refreshIntervalSeconds: number): PolarisDataState
 
     async function fetchData() {
       try {
-        const result: AuditData = await ApiProxy.request(getPolarisApiPath());
+        const apiPath = getPolarisApiPath();
+        let result: AuditData;
+
+        if (isFullUrl(apiPath)) {
+          // Direct fetch for full URLs
+          const response = await fetch(apiPath);
+          if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+          }
+          result = await response.json();
+        } else {
+          // Kubernetes proxy for relative URLs
+          result = await ApiProxy.request(apiPath);
+        }
+
         if (!cancelled) {
           setData(result);
           setError(null);
@@ -203,17 +221,31 @@ export function usePolarisData(refreshIntervalSeconds: number): PolarisDataState
         }
       } catch (err: unknown) {
         if (cancelled) return;
+        const apiPath = getPolarisApiPath();
         const status = (err as { status?: number }).status;
-        if (status === 403) {
+
-          setError(
+        if (isFullUrl(apiPath)) {
-            'Access denied (403). Check that your RBAC permissions allow proxying to the Polaris service.'
+          // Full URL errors
-          );
+          if (status === 403) {
-        } else if (status === 404 || status === 503) {
+            setError('Access denied (403). Check authentication and CORS configuration.');
-          setError(
+          } else if (status === 404) {
-            'Polaris dashboard not reachable. Ensure Polaris is installed in the polaris namespace.'
+            setError('Polaris dashboard not found (404). Verify the URL is correct.');
-          );
+          } else {
+            setError(`Failed to fetch from ${apiPath}: ${String(err)}`);
+          }
         } else {
-          setError(`Failed to fetch Polaris data: ${String(err)}`);
+          // Kubernetes proxy errors
+          if (status === 403) {
+            setError(
+              'Access denied (403). Check that your RBAC permissions allow proxying to the Polaris service.'
+            );
+          } else if (status === 404 || status === 503) {
+            setError(
+              'Polaris dashboard not reachable. Ensure Polaris is installed in the configured namespace.'
+            );
+          } else {
+            setError(`Failed to fetch Polaris data: ${String(err)}`);
+          }
         }
         setLoading(false);
       }

src/components/PolarisSettings.tsx

@@ -43,19 +43,26 @@ export default function PolarisSettings(props: PluginSettingsProps) {
           {
             name: 'Dashboard URL',
             value: (
-              <input
+              <div>
-                type="text"
+                <input
-                value={currentUrl}
+                  type="text"
-                onChange={handleUrlChange}
+                  value={currentUrl}
-                placeholder="/api/v1/namespaces/polaris/services/polaris-dashboard:80/proxy/"
+                  onChange={handleUrlChange}
-                style={{
+                  placeholder="/api/v1/namespaces/polaris/services/polaris-dashboard:80/proxy/"
-                  width: '100%',
+                  style={{
-                  padding: '4px 8px',
+                    width: '100%',
-                  border: '1px solid #ccc',
+                    padding: '4px 8px',
-                  borderRadius: '4px',
+                    border: '1px solid #ccc',
-                  fontSize: '14px',
+                    borderRadius: '4px',
-                }}
+                    fontSize: '14px',
-              />
+                  }}
+                />
+                <div style={{ fontSize: '12px', color: '#666', marginTop: '4px' }}>
+                  Examples:<br />
+                  • K8s proxy: <code>/api/v1/namespaces/polaris/services/polaris-dashboard:80/proxy/</code><br />
+                  • Full URL: <code>https://my-polaris.example.com</code>
+                </div>
+              </div>
             ),
           },
         ]}