@sxl-studio/bridge 1.7.2 → 1.7.3

package/dist/bridge-health-cli.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "node:url";
+import { runBridgeHealthCheck } from "./bridge-health.js";
+function usage() {
+    return [
+        "Usage: sxl-bridge-health [--runtime] [--require-plugin] [--url <baseUrl>] [--auth-token <token>] [--timeout-ms <ms>] [--json]",
+        "",
+        "Examples:",
+        "  sxl-bridge-health",
+        "  sxl-bridge-health --runtime",
+        "  sxl-bridge-health --runtime --require-plugin --url http://127.0.0.1:37830",
+    ].join("\n");
+}
+function parseArgs(argv) {
+    const args = {
+        runtime: false,
+        json: false,
+        requirePlugin: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            console.log(usage());
+            process.exit(0);
+        }
+        if (arg === "--local") {
+            args.runtime = false;
+            continue;
+        }
+        if (arg === "--runtime") {
+            args.runtime = true;
+            continue;
+        }
+        if (arg === "--json") {
+            args.json = true;
+            continue;
+        }
+        if (arg === "--require-plugin") {
+            args.requirePlugin = true;
+            args.runtime = true;
+            continue;
+        }
+        if (arg === "--url") {
+            args.baseUrl = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--auth-token") {
+            args.authToken = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--timeout-ms") {
+            const value = Number.parseInt(argv[i + 1] ?? "", 10);
+            if (!Number.isFinite(value) || value <= 0) {
+                throw new Error("--timeout-ms must be a positive integer.");
+            }
+            args.timeoutMs = value;
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    if (args.baseUrl === undefined && args.runtime) {
+        args.baseUrl = `http://127.0.0.1:${process.env["BRIDGE_PORT"] || "37830"}`;
+    }
+    return args;
+}
+function renderText(report) {
+    const lines = [];
+    lines.push(`SXL Bridge health: ${report.status.toUpperCase()} (${report.mode})`);
+    lines.push(`Version: ${report.bridgeVersion}`);
+    if (report.baseUrl)
+        lines.push(`Base URL: ${report.baseUrl}`);
+    lines.push("");
+    for (const check of report.checks) {
+        lines.push(`- ${check.status.toUpperCase()} ${check.name}`);
+    }
+    if (report.findings.length > 0) {
+        lines.push("");
+        lines.push("Findings:");
+        for (const finding of report.findings) {
+            const endpoint = finding.endpoint ? ` ${finding.endpoint}` : "";
+            lines.push(`- ${finding.severity.toUpperCase()} ${finding.code}${endpoint}: ${finding.message}`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function runBridgeHealthCli(argv = process.argv.slice(2)) {
+    const args = parseArgs(argv);
+    const report = await runBridgeHealthCheck({
+        runtime: args.runtime,
+        baseUrl: args.baseUrl,
+        authToken: args.authToken,
+        timeoutMs: args.timeoutMs,
+        requirePlugin: args.requirePlugin,
+    });
+    if (args.json) {
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        console.log(renderText(report));
+    }
+    process.exit(report.ok ? 0 : 1);
+}
+const isCliEntry = process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isCliEntry) {
+    runBridgeHealthCli().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        console.error("");
+        console.error(usage());
+        process.exit(2);
+    });
+}
+//# sourceMappingURL=bridge-health-cli.js.map

package/dist/bridge-health-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-health-cli.js","sourceRoot":"","sources":["../src/bridge-health-cli.ts"],"names":[],"mappings":"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"}

package/dist/bridge-health.d.ts

@@ -0,0 +1,33 @@
+export type BridgeHealthSeverity = "error" | "warning" | "info";
+export type BridgeHealthFinding = {
+    severity: BridgeHealthSeverity;
+    code: string;
+    message: string;
+    endpoint?: string;
+};
+export type BridgeHealthCheck = {
+    name: string;
+    ok: boolean;
+    status: "pass" | "warn" | "fail";
+    details?: Record<string, unknown>;
+};
+export type BridgeHealthReport = {
+    ok: boolean;
+    status: "pass" | "warn" | "fail";
+    version: 1;
+    bridgeVersion: string;
+    generatedAt: string;
+    mode: "local" | "runtime";
+    baseUrl?: string;
+    checks: BridgeHealthCheck[];
+    findings: BridgeHealthFinding[];
+};
+export type BridgeHealthOptions = {
+    runtime?: boolean;
+    baseUrl?: string;
+    authToken?: string;
+    timeoutMs?: number;
+    requirePlugin?: boolean;
+    fetchImpl?: typeof fetch;
+};
+export declare function runBridgeHealthCheck(options?: BridgeHealthOptions): Promise<BridgeHealthReport>;