@builder.io/ai-utils 0.66.0 → 0.66.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.66.0",
+  "version": "0.66.1",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/connectivity/browser.d.ts

@@ -1,7 +1,7 @@
 export type { Source, TestId, Test, RunChecksInput, ProgressEvent, CheckResult, CheckReport, ConnectivityErrorCode, CheckType, Recommendation, LikelyCause, ConnectivityStatus, AnalysisResult, AnalyzeConnectivityInput, } from "./types.js";
 export { runChecks } from "./run-checks.browser.js";
 export { mapNodeErrorToConnectivityCode, mapHttpStatusToErrorCode, mapFetchErrorToConnectivityCode, connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, SELF_SIGNED_CERT_ERRORS, CERT_EXPIRED_ERRORS, CERT_NOT_YET_VALID_ERRORS, CERT_INVALID_ERRORS, CERT_HOSTNAME_MISMATCH_ERRORS, SSL_PROTOCOL_ERRORS, SSL_HANDSHAKE_ERRORS, NETWORK_UNREACHABLE_ERRORS, TIMEOUT_ERRORS, PROXY_ERRORS, DNS_ERRORS, } from "./error-codes.js";
-export { BUILDER_TARGETS, DEFAULT_PORTS, resolveTarget, extractHostname, extractPort, } from "./targets.js";
+export { BUILDER_TARGETS, DEFAULT_PORTS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, resolveTarget, extractHostname, extractPort, } from "./targets.js";
 export { isBrowser, isNode, getCheckTypeForTestId, isCheckAvailable, getUnavailabilityReason, } from "./environment.js";
 export { httpCheck } from "./checks/http-check.js";
 export type { HttpCheckOptions } from "./checks/http-check.js";

package/src/connectivity/browser.js

@@ -1,5 +1,5 @@
 export { runChecks } from "./run-checks.browser.js";
 export { mapNodeErrorToConnectivityCode, mapHttpStatusToErrorCode, mapFetchErrorToConnectivityCode, connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, SELF_SIGNED_CERT_ERRORS, CERT_EXPIRED_ERRORS, CERT_NOT_YET_VALID_ERRORS, CERT_INVALID_ERRORS, CERT_HOSTNAME_MISMATCH_ERRORS, SSL_PROTOCOL_ERRORS, SSL_HANDSHAKE_ERRORS, NETWORK_UNREACHABLE_ERRORS, TIMEOUT_ERRORS, PROXY_ERRORS, DNS_ERRORS, } from "./error-codes.js";
-export { BUILDER_TARGETS, DEFAULT_PORTS, resolveTarget, extractHostname, extractPort, } from "./targets.js";
+export { BUILDER_TARGETS, DEFAULT_PORTS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, resolveTarget, extractHostname, extractPort, } from "./targets.js";
 export { isBrowser, isNode, getCheckTypeForTestId, isCheckAvailable, getUnavailabilityReason, } from "./environment.js";
 export { httpCheck } from "./checks/http-check.js";

package/src/connectivity/environment.js

@@ -7,8 +7,7 @@ export function isNode() {
         process.versions.node != null);
 }
 export function getCheckTypeForTestId(testId) {
-    if (testId === "health.builderio.xyz:ws" ||
-        testId === "health.builderio.dev:ws") {
+    if (testId === "builderio.xyz:ws" || testId === "builderio.dev:ws") {
         return "websocket";
     }
     if (testId.startsWith("git-host:")) {

package/src/connectivity/node.d.ts

@@ -1,7 +1,7 @@
 export type { Source, TestId, Test, RunChecksInput, ProgressEvent, CheckResult, CheckReport, ConnectivityErrorCode, CheckType, Recommendation, LikelyCause, ConnectivityStatus, AnalysisResult, AnalyzeConnectivityInput, ConnectivityFetchFn, } from "./types.js";
 export { runChecks } from "./run-checks.js";
 export { mapNodeErrorToConnectivityCode, mapHttpStatusToErrorCode, mapFetchErrorToConnectivityCode, connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, SELF_SIGNED_CERT_ERRORS, CERT_EXPIRED_ERRORS, CERT_NOT_YET_VALID_ERRORS, CERT_INVALID_ERRORS, CERT_HOSTNAME_MISMATCH_ERRORS, SSL_PROTOCOL_ERRORS, SSL_HANDSHAKE_ERRORS, NETWORK_UNREACHABLE_ERRORS, TIMEOUT_ERRORS, PROXY_ERRORS, DNS_ERRORS, } from "./error-codes.js";
-export { BUILDER_TARGETS, DEFAULT_PORTS, resolveTarget, extractHostname, extractPort, } from "./targets.js";
+export { BUILDER_TARGETS, DEFAULT_PORTS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, resolveTarget, extractHostname, extractPort, } from "./targets.js";
 export { isBrowser, isNode, getCheckTypeForTestId, isCheckAvailable, getUnavailabilityReason, } from "./environment.js";
 export { httpCheck } from "./checks/http-check.js";
 export type { HttpCheckOptions } from "./checks/http-check.js";

package/src/connectivity/node.js

@@ -1,6 +1,6 @@
 export { runChecks } from "./run-checks.js";
 export { mapNodeErrorToConnectivityCode, mapHttpStatusToErrorCode, mapFetchErrorToConnectivityCode, connectivityErrorCodeToLikelyCause, mapConnectivityErrorMessage, SELF_SIGNED_CERT_ERRORS, CERT_EXPIRED_ERRORS, CERT_NOT_YET_VALID_ERRORS, CERT_INVALID_ERRORS, CERT_HOSTNAME_MISMATCH_ERRORS, SSL_PROTOCOL_ERRORS, SSL_HANDSHAKE_ERRORS, NETWORK_UNREACHABLE_ERRORS, TIMEOUT_ERRORS, PROXY_ERRORS, DNS_ERRORS, } from "./error-codes.js";
-export { BUILDER_TARGETS, DEFAULT_PORTS, resolveTarget, extractHostname, extractPort, } from "./targets.js";
+export { BUILDER_TARGETS, DEFAULT_PORTS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, resolveTarget, extractHostname, extractPort, } from "./targets.js";
 export { isBrowser, isNode, getCheckTypeForTestId, isCheckAvailable, getUnavailabilityReason, } from "./environment.js";
 export { httpCheck } from "./checks/http-check.js";
 export { dnsCheck } from "./checks/dns-check.js";

package/src/connectivity/targets.d.ts

@@ -1,5 +1,17 @@
-import type { TestId } from "./types.js";
+import type { Test, TestId } from "./types.js";
 export declare const BUILDER_TARGETS: Record<string, string>;
+/**
+ * Canonical ordered list of Builder-service connectivity tests, matching what
+ * the Builder app's ConnectivityService runs locally. Includes the four kube
+ * domain health probes (HTTP + WebSocket) for both *.builderio.xyz and
+ * *.builderio.dev.
+ */
+export declare const DEFAULT_LOCAL_BUILDER_TESTS: Test[];
+/**
+ * Human-readable display names for Builder service testIds. Used by CLI and
+ * UI surfaces to show friendly labels instead of raw testId strings.
+ */
+export declare const BUILDER_TEST_DISPLAY_NAMES: Partial<Record<TestId, string>>;
 export declare const DEFAULT_PORTS: Record<string, number>;
 export declare function resolveTarget(testId: TestId, gitHost?: string): string;
 export declare function extractHostname(target: string): string;

package/src/connectivity/targets.js

@@ -3,12 +3,41 @@ export const BUILDER_TARGETS = {
     "builder.codes": "https://test.projects.builder.codes/proxy-health",
     "api.builder.io": "https://api.builder.io/codegen/health",
     "cdn.builder.io": "https://cdn.builder.io/api/v1/image/assets/TEMP/75a212ab82b6175c9862b125e0e23db8d369a58a?width=100",
-    "health.builderio.xyz": "https://health.builderio.xyz/health",
-    "health.builderio.xyz:ws": "wss://health.builderio.xyz/ws",
-    "health.builderio.dev": "https://health.builderio.dev/health",
-    "health.builderio.dev:ws": "wss://health.builderio.dev/ws",
+    // Health subdomains — dedicated endpoints for VPN/firewall diagnostics.
+    // The testId omits the "health." prefix for readability; the URL still
+    // targets health.builderio.* so wildcard allowlists are verified.
+    "builderio.xyz": "https://health.builderio.xyz/health",
+    "builderio.xyz:ws": "wss://health.builderio.xyz/ws",
+    "builderio.dev": "https://health.builderio.dev/health",
+    "builderio.dev:ws": "wss://health.builderio.dev/ws",
     "fly.dev": "https://fly.dev",
 };
+/**
+ * Canonical ordered list of Builder-service connectivity tests, matching what
+ * the Builder app's ConnectivityService runs locally. Includes the four kube
+ * domain health probes (HTTP + WebSocket) for both *.builderio.xyz and
+ * *.builderio.dev.
+ */
+export const DEFAULT_LOCAL_BUILDER_TESTS = [
+    { source: "local", testId: "builder.io" },
+    { source: "local", testId: "builder.codes" },
+    { source: "local", testId: "api.builder.io" },
+    { source: "local", testId: "cdn.builder.io" },
+    { source: "local", testId: "builderio.xyz" },
+    { source: "local", testId: "builderio.xyz:ws" },
+    { source: "local", testId: "builderio.dev" },
+    { source: "local", testId: "builderio.dev:ws" },
+];
+/**
+ * Human-readable display names for Builder service testIds. Used by CLI and
+ * UI surfaces to show friendly labels instead of raw testId strings.
+ */
+export const BUILDER_TEST_DISPLAY_NAMES = {
+    "builderio.xyz": "*.builderio.xyz",
+    "builderio.xyz:ws": "*.builderio.xyz (WebSocket)",
+    "builderio.dev": "*.builderio.dev",
+    "builderio.dev:ws": "*.builderio.dev (WebSocket)",
+};
 export const DEFAULT_PORTS = {
     http: 443,
     https: 443,

package/src/connectivity/targets.spec.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { extractPort, extractExplicitPort } from "./targets";
+import { extractPort, extractExplicitPort, BUILDER_TARGETS, DEFAULT_LOCAL_BUILDER_TESTS, BUILDER_TEST_DISPLAY_NAMES, } from "./targets";
 describe("extractPort", () => {
     it("returns explicit port from URL", () => {
         expect(extractPort("https://git.amazon.com:2222", 443)).toBe(2222);
@@ -43,3 +43,36 @@ describe("extractExplicitPort", () => {
         expect(extractExplicitPort("not-a-url", 22)).toBe(22);
     });
 });
+describe("DEFAULT_LOCAL_BUILDER_TESTS", () => {
+    const KUBE_IDS = [
+        "builderio.xyz",
+        "builderio.xyz:ws",
+        "builderio.dev",
+        "builderio.dev:ws",
+    ];
+    it("includes all four kube domain test IDs", () => {
+        const ids = DEFAULT_LOCAL_BUILDER_TESTS.map((t) => t.testId);
+        for (const id of KUBE_IDS) {
+            expect(ids).toContain(id);
+        }
+    });
+    it("all tests have source=local", () => {
+        for (const t of DEFAULT_LOCAL_BUILDER_TESTS) {
+            expect(t.source).toBe("local");
+        }
+    });
+    it("kube testIds resolve to health subdomain URLs (testId omits health. prefix; URL does not)", () => {
+        expect(BUILDER_TARGETS["builderio.xyz"]).toBe("https://health.builderio.xyz/health");
+        expect(BUILDER_TARGETS["builderio.xyz:ws"]).toBe("wss://health.builderio.xyz/ws");
+        expect(BUILDER_TARGETS["builderio.dev"]).toBe("https://health.builderio.dev/health");
+        expect(BUILDER_TARGETS["builderio.dev:ws"]).toBe("wss://health.builderio.dev/ws");
+    });
+});
+describe("BUILDER_TEST_DISPLAY_NAMES", () => {
+    it("maps all four kube testIds to user-friendly labels", () => {
+        expect(BUILDER_TEST_DISPLAY_NAMES["builderio.xyz"]).toBe("*.builderio.xyz");
+        expect(BUILDER_TEST_DISPLAY_NAMES["builderio.xyz:ws"]).toBe("*.builderio.xyz (WebSocket)");
+        expect(BUILDER_TEST_DISPLAY_NAMES["builderio.dev"]).toBe("*.builderio.dev");
+        expect(BUILDER_TEST_DISPLAY_NAMES["builderio.dev:ws"]).toBe("*.builderio.dev (WebSocket)");
+    });
+});

package/src/connectivity/types.d.ts

@@ -1,5 +1,5 @@
 export type Source = "local" | "cloud" | "static-ip";
-export type TestId = "builder.io" | "builder.codes" | "api.builder.io" | "cdn.builder.io" | "health.builderio.xyz" | "health.builderio.xyz:ws" | "health.builderio.dev" | "health.builderio.dev:ws" | "fly.dev" | "git-host:http" | "git-host:dns" | "git-host:tcp" | "git-host:tls" | "git-host:ssh";
+export type TestId = "builder.io" | "builder.codes" | "api.builder.io" | "cdn.builder.io" | "builderio.xyz" | "builderio.xyz:ws" | "builderio.dev" | "builderio.dev:ws" | "fly.dev" | "git-host:http" | "git-host:dns" | "git-host:tcp" | "git-host:tls" | "git-host:ssh";
 export interface Test {
     source: Source;
     testId: TestId;