@sxl-studio/bridge 1.7.2 → 1.8.0

package/dist/bridge-live-validation-cli.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "node:url";
+import { runBridgeLiveValidation } from "./bridge-live-validation.js";
+function usage() {
+    return [
+        "Usage: sxl-bridge validate [--url <baseUrl>] [--auth-token <token>] [--timeout-ms <ms>] [--suite baseline|all] [--write-canary] [--cleanup] [--json]",
+        "",
+        "Runs a non-destructive live validation suite against a running Bridge + connected SXL Studio plugin.",
+        "baseline: REST/MCP status/read/tooling + Design DSL dry-run. all: adds Code Connect registry/status plus template dry-run, database lists/payload dry-run, and component analytics.",
+        "Use --write-canary only with explicit approval to create a tiny validation frame. Add --cleanup to delete that frame after verifying creation.",
+    ].join("\n");
+}
+function parseArgs(argv) {
+    const args = { json: false, writeCanary: false, cleanup: 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 === "--json") {
+            args.json = true;
+            continue;
+        }
+        if (arg === "--write-canary") {
+            args.writeCanary = true;
+            continue;
+        }
+        if (arg === "--cleanup") {
+            args.cleanup = 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;
+        }
+        if (arg === "--suite") {
+            const value = argv[i + 1];
+            if (value !== "baseline" && value !== "all") {
+                throw new Error("--suite must be baseline or all.");
+            }
+            args.suite = value;
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    return args;
+}
+function renderText(report) {
+    const lines = [];
+    const canary = report.writeCanary ? report.cleanup ? ", write-canary+cleanup" : ", write-canary" : "";
+    lines.push(`SXL Bridge live validation: ${report.status.toUpperCase()} (${report.suite}${canary})`);
+    lines.push(`Version: ${report.bridgeVersion}`);
+    lines.push(`Base URL: ${report.baseUrl}`);
+    lines.push("");
+    for (const step of report.steps) {
+        const command = step.commandType ? ` [${step.commandType}]` : "";
+        const timing = typeof step.durationMs === "number" ? ` ${step.durationMs}ms` : "";
+        lines.push(`- ${step.status.toUpperCase()} ${step.name}${command}${timing}`);
+    }
+    if (report.findings.length > 0) {
+        lines.push("");
+        lines.push("Findings:");
+        for (const finding of report.findings) {
+            const step = finding.step ? ` ${finding.step}` : "";
+            lines.push(`- ${finding.severity.toUpperCase()} ${finding.code}${step}: ${finding.message}`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function runBridgeLiveValidationCli(argv = process.argv.slice(2)) {
+    const args = parseArgs(argv);
+    const report = await runBridgeLiveValidation({
+        baseUrl: args.baseUrl,
+        authToken: args.authToken,
+        timeoutMs: args.timeoutMs,
+        suite: args.suite,
+        writeCanary: args.writeCanary,
+        cleanup: args.cleanup,
+    });
+    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) {
+    runBridgeLiveValidationCli().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        console.error("");
+        console.error(usage());
+        process.exit(2);
+    });
+}
+//# sourceMappingURL=bridge-live-validation-cli.js.map

package/dist/bridge-live-validation-cli.js.map

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

package/dist/bridge-live-validation.d.ts

@@ -0,0 +1,39 @@
+export type BridgeLiveValidationSeverity = "error" | "warning" | "info";
+export type BridgeLiveValidationFinding = {
+    severity: BridgeLiveValidationSeverity;
+    code: string;
+    message: string;
+    step?: string;
+};
+export type BridgeLiveValidationStep = {
+    name: string;
+    kind: "http" | "mcp" | "command" | "local";
+    ok: boolean;
+    status: "pass" | "warn" | "fail";
+    durationMs?: number;
+    commandType?: string;
+    details?: Record<string, unknown>;
+};
+export type BridgeLiveValidationReport = {
+    ok: boolean;
+    status: "pass" | "warn" | "fail";
+    version: 1;
+    bridgeVersion: string;
+    generatedAt: string;
+    baseUrl: string;
+    suite: "baseline" | "all";
+    writeCanary: boolean;
+    cleanup: boolean;
+    steps: BridgeLiveValidationStep[];
+    findings: BridgeLiveValidationFinding[];
+};
+export type BridgeLiveValidationOptions = {
+    baseUrl?: string;
+    authToken?: string;
+    timeoutMs?: number;
+    suite?: "baseline" | "all";
+    writeCanary?: boolean;
+    cleanup?: boolean;
+    fetchImpl?: typeof fetch;
+};
+export declare function runBridgeLiveValidation(options?: BridgeLiveValidationOptions): Promise<BridgeLiveValidationReport>;