@scenar/cli 0.3.0 → 0.4.0

package/src/__tests__/deploy-command.test.ts

@@ -1,45 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import { createProgram } from "../index.js";
-
-describe("scenar deploy", () => {
-  let stderrOutput: string;
-
-  beforeEach(() => {
-    stderrOutput = "";
-    vi.spyOn(process.stderr, "write").mockImplementation((chunk) => {
-      stderrOutput += String(chunk);
-      return true;
-    });
-    process.exitCode = undefined;
-  });
-
-  it("registers the deploy command", () => {
-    const program = createProgram();
-    const cmd = program.commands.find((c) => c.name() === "deploy");
-    expect(cmd).toBeDefined();
-    expect(cmd!.description()).toContain("embed URL");
-  });
-
-  it("accepts a bundle directory argument and exposes its options", () => {
-    const program = createProgram();
-    const cmd = program.commands.find((c) => c.name() === "deploy");
-    expect(cmd!.registeredArguments[0]!.name()).toBe("bundleDir");
-    const opts = cmd!.options.map((o) => o.long);
-    expect(opts).toContain("--backend");
-    expect(opts).toContain("--org");
-    expect(opts).toContain("--slug");
-    expect(opts).toContain("--name");
-  });
-
-  it("fails clearly when the bundle directory does not exist", async () => {
-    const program = createProgram();
-    program.exitOverride();
-    try {
-      await program.parseAsync(["node", "scenar", "deploy", "/tmp/__no_bundle__", "--org", "acme"]);
-    } catch {
-      // exitOverride
-    }
-    expect(process.exitCode).toBe(1);
-    expect(stderrOutput).toContain("Error");
-  });
-});

package/src/__tests__/deploy-flow.test.ts

@@ -1,125 +0,0 @@
-import { describe, it, expect, vi } from "vitest";
-import {
-  runDeployFlow,
-  toDeclaredFiles,
-  localViewUrl,
-  type DeployFlowDeps,
-  type UploadTarget,
-} from "../deploy/deploy-flow.js";
-import type { PackManifest } from "../pack/pack-manifest.js";
-
-const MANIFEST: PackManifest = {
-  schemaVersion: 1,
-  scenarioId: "welcome-tour",
-  files: [
-    { path: "index.html", sha256: "a".repeat(64), sizeBytes: 397, contentType: "text/html" },
-    { path: "assets/app.js", sha256: "b".repeat(64), sizeBytes: 356965, contentType: "text/javascript" },
-    { path: "scenario.json", sha256: "c".repeat(64), sizeBytes: 91, contentType: "application/json" },
-  ],
-};
-
-describe("toDeclaredFiles", () => {
-  it("maps manifest files to declared files with bigint sizes and lowercase-hex sha256", () => {
-    const declared = toDeclaredFiles(MANIFEST);
-    expect(declared).toHaveLength(3);
-    expect(declared[0]).toEqual({
-      relativePath: "index.html",
-      sha256: "a".repeat(64),
-      sizeBytes: 397n,
-      contentType: "text/html",
-    });
-    expect(typeof declared[1]!.sizeBytes).toBe("bigint");
-    expect(declared[1]!.sizeBytes).toBe(356965n);
-  });
-});
-
-describe("runDeployFlow", () => {
-  it("ensures the scenario before creating the session, then uploads then completes", async () => {
-    const calls: string[] = [];
-    const targets: UploadTarget[] = [
-      {
-        relativePath: "index.html",
-        presignedPutUrl: "https://store/idx",
-        requiredHeaders: { "Content-Type": "text/html", "x-amz-checksum-sha256": "AAAA" },
-      },
-      {
-        relativePath: "assets/app.js",
-        presignedPutUrl: "https://store/js",
-        requiredHeaders: { "Content-Type": "text/javascript", "x-amz-checksum-sha256": "BBBB" },
-      },
-    ];
-
-    const uploaded: Array<{ target: UploadTarget; bytes: number }> = [];
-
-    const deps: DeployFlowDeps = {
-      applyScenario: vi.fn(async (input) => {
-        calls.push("apply");
-        expect(input).toEqual({ org: "acme", slug: "welcome-tour", name: "Welcome" });
-        return "scn_123";
-      }),
-      createSession: vi.fn(async (scenarioId, files) => {
-        calls.push("create");
-        expect(scenarioId).toBe("scn_123");
-        expect(files).toHaveLength(3);
-        return { deployId: "dep_456", uploadTargets: targets };
-      }),
-      readBundleFile: vi.fn(async (rel) => new Uint8Array(rel.length)),
-      uploadFile: vi.fn(async (target, bytes) => {
-        calls.push(`upload:${target.relativePath}`);
-        uploaded.push({ target, bytes: bytes.byteLength });
-      }),
-      completeSession: vi.fn(async (deployId) => {
-        calls.push("complete");
-        expect(deployId).toBe("dep_456");
-        return "https://d-dep_456.localhost:8787/";
-      }),
-      log: () => {},
-    };
-
-    const result = await runDeployFlow(deps, {
-      manifest: MANIFEST,
-      org: "acme",
-      slug: "welcome-tour",
-      name: "Welcome",
-    });
-
-    expect(result).toEqual({ deployId: "dep_456", embedUrl: "https://d-dep_456.localhost:8787/" });
-    // Ordering: ensure -> create -> upload each (in target order) -> complete.
-    expect(calls).toEqual(["apply", "create", "upload:index.html", "upload:assets/app.js", "complete"]);
-    // Required headers are passed through verbatim to each upload.
-    expect(uploaded[0]!.target.requiredHeaders).toEqual(targets[0]!.requiredHeaders);
-    expect(uploaded[1]!.target.requiredHeaders).toEqual(targets[1]!.requiredHeaders);
-  });
-
-  it("propagates a missing-embed-url failure from completion", async () => {
-    const deps: DeployFlowDeps = {
-      applyScenario: async () => "scn_1",
-      createSession: async () => ({ deployId: "dep_1", uploadTargets: [] }),
-      readBundleFile: async () => new Uint8Array(),
-      uploadFile: async () => {},
-      completeSession: async () => {
-        throw new Error("deploy completed but returned no embed_url");
-      },
-      log: () => {},
-    };
-
-    await expect(
-      runDeployFlow(deps, { manifest: MANIFEST, org: "acme", slug: "welcome-tour", name: "x" }),
-    ).rejects.toThrow(/embed_url/);
-  });
-});
-
-describe("localViewUrl", () => {
-  it("downgrades https to http for *.localhost hosts (wrangler dev serves http)", () => {
-    expect(localViewUrl("https://d-abc.localhost:8787/")).toBe("http://d-abc.localhost:8787/");
-    expect(localViewUrl("https://localhost:8787/")).toBe("http://localhost:8787/");
-  });
-
-  it("leaves production https URLs untouched", () => {
-    expect(localViewUrl("https://d-abc.scenar.ai/")).toBe("https://d-abc.scenar.ai/");
-  });
-
-  it("returns non-URL input unchanged", () => {
-    expect(localViewUrl("not a url")).toBe("not a url");
-  });
-});

package/src/__tests__/deploy-upload.test.ts

@@ -1,39 +0,0 @@
-import { describe, it, expect, vi, afterEach } from "vitest";
-import { putFile } from "../deploy/upload.js";
-
-const realFetch = globalThis.fetch;
-
-afterEach(() => {
-  globalThis.fetch = realFetch;
-  vi.restoreAllMocks();
-});
-
-describe("putFile", () => {
-  it("PUTs the raw bytes and replays required headers verbatim", async () => {
-    const seen: { url?: string; init?: RequestInit } = {};
-    globalThis.fetch = vi.fn(async (url: any, init: any) => {
-      seen.url = String(url);
-      seen.init = init;
-      return new Response(null, { status: 200 });
-    }) as unknown as typeof fetch;
-
-    const bytes = new Uint8Array([1, 2, 3]);
-    const headers = { "Content-Type": "text/html", "x-amz-checksum-sha256": "AAAA" };
-    await putFile("https://store/key", headers, bytes);
-
-    expect(seen.url).toBe("https://store/key");
-    expect(seen.init!.method).toBe("PUT");
-    expect(seen.init!.headers).toEqual(headers);
-    expect(seen.init!.body).toBe(bytes);
-  });
-
-  it("throws with the status and body detail on a non-2xx response", async () => {
-    globalThis.fetch = vi.fn(async () =>
-      new Response("SignatureDoesNotMatch", { status: 403, statusText: "Forbidden" }),
-    ) as unknown as typeof fetch;
-
-    await expect(putFile("https://store/key", {}, new Uint8Array())).rejects.toThrow(
-      /upload failed \(403 Forbidden\): SignatureDoesNotMatch/,
-    );
-  });
-});

package/src/commands/deploy.d.ts

@@ -1,3 +0,0 @@
-import { Command } from "commander";
-export declare function registerDeployCommand(program: Command): void;
-//# sourceMappingURL=deploy.d.ts.map

package/src/commands/deploy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqF5D"}

package/src/commands/deploy.js

@@ -1,150 +0,0 @@
-import { resolve, join } from "node:path";
-import { readFile, stat } from "node:fs/promises";
-import { PACK_MANIFEST_FILE } from "../pack/pack-manifest.js";
-import { readBundleViewport } from "../bundle/read-viewport.js";
-import { createBackendClients } from "../deploy/client.js";
-import { putFile } from "../deploy/upload.js";
-import { buildEmbedSnippet } from "../deploy/embed-snippet.js";
-import { runDeployFlow, localViewUrl } from "../deploy/deploy-flow.js";
-/** Default local backend (gRPC). Local dev shifts off 8080 to avoid colliding with stigmer-service. */
-const DEFAULT_BACKEND = "http://localhost:8090";
-/** Slug rule from ApiResourceMetadata: lowercase, hyphens, start letter, end alphanumeric. */
-const SLUG_PATTERN = /^[a-z][a-z0-9-]*[a-z0-9]$/;
-export function registerDeployCommand(program) {
-    program
-        .command("deploy")
-        .description("Deploy a packed bundle to Scenar Cloud and print its embed URL.\n\n" +
-        "Takes a bundle directory produced by `scenar pack` (containing\n" +
-        "pack-manifest.json). It ensures the parent scenario exists, opens a\n" +
-        "two-phase upload session, uploads every file directly to object\n" +
-        "storage via presigned URLs, completes the session, and prints the\n" +
-        "deploy's embed URL.\n\n" +
-        "Backend defaults to http://localhost:8090 (override with --backend or\n" +
-        "SCENAR_BACKEND). The owning org is required (--org or SCENAR_ORG).")
-        .argument("<bundleDir>", "path to a packed bundle directory (from scenar pack)")
-        .option("--backend <url>", "backend gRPC endpoint (default: $SCENAR_BACKEND or http://localhost:8090)")
-        .option("--org <org>", "owning organization (default: $SCENAR_ORG)")
-        .option("--slug <slug>", "scenario slug (default: the packed scenario id)")
-        .option("--name <name>", "scenario display name (default: the slug)")
-        .action(async (bundleDir, options) => {
-        const resolvedDir = resolve(bundleDir);
-        try {
-            const info = await stat(resolvedDir).catch(() => null);
-            if (!info || !info.isDirectory()) {
-                throw new Error(`${bundleDir} is not a directory. Pass a bundle produced by \`scenar pack\`.`);
-            }
-            const manifest = await readPackManifest(resolvedDir);
-            const backend = options.backend ?? process.env.SCENAR_BACKEND ?? DEFAULT_BACKEND;
-            const org = options.org ?? process.env.SCENAR_ORG;
-            if (!org) {
-                throw new Error("an owning org is required: pass --org <org> or set SCENAR_ORG.");
-            }
-            const slug = options.slug ?? manifest.scenarioId;
-            if (!SLUG_PATTERN.test(slug)) {
-                throw new Error(`invalid scenario slug "${slug}". Slugs are lowercase letters, digits,\n` +
-                    "and hyphens, starting with a letter and ending alphanumeric. Pass --slug to override.");
-            }
-            const name = options.name ?? slug;
-            process.stderr.write(`Bundle:   ${resolvedDir}\n`);
-            process.stderr.write(`Backend:  ${backend}\n`);
-            process.stderr.write(`Org:      ${org}\n`);
-            process.stderr.write(`Scenario: ${slug}\n\n`);
-            const clients = createBackendClients(backend);
-            const deps = makeDeps(clients, resolvedDir);
-            const { deployId, embedUrl } = await runDeployFlow(deps, { manifest, org, slug, name });
-            process.stderr.write(`\n\x1b[32m✓\x1b[0m Deployed ${deployId}\n`);
-            process.stdout.write(`${embedUrl}\n`);
-            const localUrl = localViewUrl(embedUrl);
-            if (localUrl !== embedUrl) {
-                process.stderr.write(`  Local view: ${localUrl}\n`);
-            }
-            // Embed snippet (guidance → stderr; stdout stays the bare URL for
-            // piping). Responsive iframe at the bundle's canonical aspect ratio
-            // (DD-002/DD-004); falls back to the default viewport for bundles packed
-            // before the viewport was recorded.
-            const { viewport, recorded } = await readBundleViewport(resolvedDir);
-            if (!recorded) {
-                process.stderr.write(`  Note: no recorded viewport for "${name}"; ` +
-                    `snippet uses the default ${viewport.width}x${viewport.height}. ` +
-                    "Re-pack with the current CLI to embed at the exact aspect ratio.\n");
-            }
-            process.stderr.write("\n  Embed snippet (paste into any page):\n\n");
-            process.stderr.write(`${indent(buildEmbedSnippet({ embedUrl, viewport, title: name }))}\n`);
-        }
-        catch (error) {
-            const msg = error instanceof Error ? error.message : String(error);
-            process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
-            process.exitCode = 1;
-        }
-    });
-}
-/** Build the flow dependencies from real Connect clients + the bundle on disk. */
-function makeDeps(clients, bundleDir) {
-    return {
-        async applyScenario({ org, slug, name }) {
-            // Idempotent upsert by (org, slug). The spec is a minimal valid placeholder
-            // (one step) — the embed plays from the packed JS, so the Scenario resource
-            // serves as the authorization parent and publication anchor, not the
-            // serving source. A richer spec projection is a deliberate follow-up.
-            const scenario = await clients.scenario.apply({
-                apiVersion: "scenario.scenar.ai/v1",
-                kind: "Scenario",
-                metadata: { org, slug, name },
-                spec: { steps: [{ view: "scenario", delayMs: 0 }] },
-            });
-            const id = scenario.metadata?.id;
-            if (!id) {
-                throw new Error("scenario apply returned no metadata.id");
-            }
-            return id;
-        },
-        async createSession(scenarioId, files) {
-            const response = await clients.deploy.createDeployUploadSession({ scenarioId, files });
-            return {
-                deployId: response.deployId,
-                uploadTargets: response.uploadTargets.map((target) => ({
-                    relativePath: target.relativePath,
-                    presignedPutUrl: target.presignedPutUrl,
-                    requiredHeaders: target.requiredHeaders,
-                })),
-            };
-        },
-        readBundleFile(relativePath) {
-            return readFile(join(bundleDir, ...relativePath.split("/")));
-        },
-        uploadFile(target, bytes) {
-            return putFile(target.presignedPutUrl, target.requiredHeaders, bytes);
-        },
-        async completeSession(deployId) {
-            const deploy = await clients.deploy.completeDeployUploadSession({ deployId });
-            const embedUrl = deploy.status?.embedUrl;
-            if (!embedUrl) {
-                throw new Error("deploy completed but returned no embed_url");
-            }
-            return embedUrl;
-        },
-        log(message) {
-            process.stderr.write(`${message}\n`);
-        },
-    };
-}
-/** Indent every line by two spaces (for nesting a block under a heading). */
-function indent(block) {
-    return block.replace(/^/gm, "  ");
-}
-async function readPackManifest(bundleDir) {
-    const manifestPath = join(bundleDir, PACK_MANIFEST_FILE);
-    let raw;
-    try {
-        raw = await readFile(manifestPath, "utf-8");
-    }
-    catch {
-        throw new Error(`no ${PACK_MANIFEST_FILE} in ${bundleDir}. Run \`scenar pack\` to produce a bundle first.`);
-    }
-    const parsed = JSON.parse(raw);
-    if (!parsed.scenarioId || !Array.isArray(parsed.files) || parsed.files.length === 0) {
-        throw new Error(`${PACK_MANIFEST_FILE} is malformed or lists no files.`);
-    }
-    return parsed;
-}
-//# sourceMappingURL=deploy.js.map

package/src/commands/deploy.js.map

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

package/src/commands/deploy.ts

@@ -1,186 +0,0 @@
-import { resolve, join } from "node:path";
-import { readFile, stat } from "node:fs/promises";
-import { Command } from "commander";
-import type { PackManifest } from "../pack/pack-manifest.js";
-import { PACK_MANIFEST_FILE } from "../pack/pack-manifest.js";
-import { readBundleViewport } from "../bundle/read-viewport.js";
-import { createBackendClients } from "../deploy/client.js";
-import { putFile } from "../deploy/upload.js";
-import { buildEmbedSnippet } from "../deploy/embed-snippet.js";
-import { runDeployFlow, localViewUrl, type DeployFlowDeps } from "../deploy/deploy-flow.js";
-
-/** Default local backend (gRPC). Local dev shifts off 8080 to avoid colliding with stigmer-service. */
-const DEFAULT_BACKEND = "http://localhost:8090";
-
-/** Slug rule from ApiResourceMetadata: lowercase, hyphens, start letter, end alphanumeric. */
-const SLUG_PATTERN = /^[a-z][a-z0-9-]*[a-z0-9]$/;
-
-interface DeployOptions {
-  backend?: string;
-  org?: string;
-  slug?: string;
-  name?: string;
-}
-
-export function registerDeployCommand(program: Command): void {
-  program
-    .command("deploy")
-    .description(
-      "Deploy a packed bundle to Scenar Cloud and print its embed URL.\n\n" +
-        "Takes a bundle directory produced by `scenar pack` (containing\n" +
-        "pack-manifest.json). It ensures the parent scenario exists, opens a\n" +
-        "two-phase upload session, uploads every file directly to object\n" +
-        "storage via presigned URLs, completes the session, and prints the\n" +
-        "deploy's embed URL.\n\n" +
-        "Backend defaults to http://localhost:8090 (override with --backend or\n" +
-        "SCENAR_BACKEND). The owning org is required (--org or SCENAR_ORG).",
-    )
-    .argument("<bundleDir>", "path to a packed bundle directory (from scenar pack)")
-    .option("--backend <url>", "backend gRPC endpoint (default: $SCENAR_BACKEND or http://localhost:8090)")
-    .option("--org <org>", "owning organization (default: $SCENAR_ORG)")
-    .option("--slug <slug>", "scenario slug (default: the packed scenario id)")
-    .option("--name <name>", "scenario display name (default: the slug)")
-    .action(async (bundleDir: string, options: DeployOptions) => {
-      const resolvedDir = resolve(bundleDir);
-
-      try {
-        const info = await stat(resolvedDir).catch(() => null);
-        if (!info || !info.isDirectory()) {
-          throw new Error(
-            `${bundleDir} is not a directory. Pass a bundle produced by \`scenar pack\`.`,
-          );
-        }
-
-        const manifest = await readPackManifest(resolvedDir);
-
-        const backend = options.backend ?? process.env.SCENAR_BACKEND ?? DEFAULT_BACKEND;
-        const org = options.org ?? process.env.SCENAR_ORG;
-        if (!org) {
-          throw new Error(
-            "an owning org is required: pass --org <org> or set SCENAR_ORG.",
-          );
-        }
-        const slug = options.slug ?? manifest.scenarioId;
-        if (!SLUG_PATTERN.test(slug)) {
-          throw new Error(
-            `invalid scenario slug "${slug}". Slugs are lowercase letters, digits,\n` +
-              "and hyphens, starting with a letter and ending alphanumeric. Pass --slug to override.",
-          );
-        }
-        const name = options.name ?? slug;
-
-        process.stderr.write(`Bundle:   ${resolvedDir}\n`);
-        process.stderr.write(`Backend:  ${backend}\n`);
-        process.stderr.write(`Org:      ${org}\n`);
-        process.stderr.write(`Scenario: ${slug}\n\n`);
-
-        const clients = createBackendClients(backend);
-        const deps = makeDeps(clients, resolvedDir);
-
-        const { deployId, embedUrl } = await runDeployFlow(deps, { manifest, org, slug, name });
-
-        process.stderr.write(`\n\x1b[32m✓\x1b[0m Deployed ${deployId}\n`);
-        process.stdout.write(`${embedUrl}\n`);
-
-        const localUrl = localViewUrl(embedUrl);
-        if (localUrl !== embedUrl) {
-          process.stderr.write(`  Local view: ${localUrl}\n`);
-        }
-
-        // Embed snippet (guidance → stderr; stdout stays the bare URL for
-        // piping). Responsive iframe at the bundle's canonical aspect ratio
-        // (DD-002/DD-004); falls back to the default viewport for bundles packed
-        // before the viewport was recorded.
-        const { viewport, recorded } = await readBundleViewport(resolvedDir);
-        if (!recorded) {
-          process.stderr.write(
-            `  Note: no recorded viewport for "${name}"; ` +
-              `snippet uses the default ${viewport.width}x${viewport.height}. ` +
-              "Re-pack with the current CLI to embed at the exact aspect ratio.\n",
-          );
-        }
-        process.stderr.write("\n  Embed snippet (paste into any page):\n\n");
-        process.stderr.write(`${indent(buildEmbedSnippet({ embedUrl, viewport, title: name }))}\n`);
-      } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        process.stderr.write(`\x1b[31mError:\x1b[0m ${msg}\n`);
-        process.exitCode = 1;
-      }
-    });
-}
-
-/** Build the flow dependencies from real Connect clients + the bundle on disk. */
-function makeDeps(
-  clients: ReturnType<typeof createBackendClients>,
-  bundleDir: string,
-): DeployFlowDeps {
-  return {
-    async applyScenario({ org, slug, name }) {
-      // Idempotent upsert by (org, slug). The spec is a minimal valid placeholder
-      // (one step) — the embed plays from the packed JS, so the Scenario resource
-      // serves as the authorization parent and publication anchor, not the
-      // serving source. A richer spec projection is a deliberate follow-up.
-      const scenario = await clients.scenario.apply({
-        apiVersion: "scenario.scenar.ai/v1",
-        kind: "Scenario",
-        metadata: { org, slug, name },
-        spec: { steps: [{ view: "scenario", delayMs: 0 }] },
-      });
-      const id = scenario.metadata?.id;
-      if (!id) {
-        throw new Error("scenario apply returned no metadata.id");
-      }
-      return id;
-    },
-    async createSession(scenarioId, files) {
-      const response = await clients.deploy.createDeployUploadSession({ scenarioId, files });
-      return {
-        deployId: response.deployId,
-        uploadTargets: response.uploadTargets.map((target) => ({
-          relativePath: target.relativePath,
-          presignedPutUrl: target.presignedPutUrl,
-          requiredHeaders: target.requiredHeaders,
-        })),
-      };
-    },
-    readBundleFile(relativePath) {
-      return readFile(join(bundleDir, ...relativePath.split("/")));
-    },
-    uploadFile(target, bytes) {
-      return putFile(target.presignedPutUrl, target.requiredHeaders, bytes);
-    },
-    async completeSession(deployId) {
-      const deploy = await clients.deploy.completeDeployUploadSession({ deployId });
-      const embedUrl = deploy.status?.embedUrl;
-      if (!embedUrl) {
-        throw new Error("deploy completed but returned no embed_url");
-      }
-      return embedUrl;
-    },
-    log(message) {
-      process.stderr.write(`${message}\n`);
-    },
-  };
-}
-
-/** Indent every line by two spaces (for nesting a block under a heading). */
-function indent(block: string): string {
-  return block.replace(/^/gm, "  ");
-}
-
-async function readPackManifest(bundleDir: string): Promise<PackManifest> {
-  const manifestPath = join(bundleDir, PACK_MANIFEST_FILE);
-  let raw: string;
-  try {
-    raw = await readFile(manifestPath, "utf-8");
-  } catch {
-    throw new Error(
-      `no ${PACK_MANIFEST_FILE} in ${bundleDir}. Run \`scenar pack\` to produce a bundle first.`,
-    );
-  }
-  const parsed = JSON.parse(raw) as PackManifest;
-  if (!parsed.scenarioId || !Array.isArray(parsed.files) || parsed.files.length === 0) {
-    throw new Error(`${PACK_MANIFEST_FILE} is malformed or lists no files.`);
-  }
-  return parsed;
-}

package/src/commands/preview.d.ts

@@ -1,3 +0,0 @@
-import { Command } from "commander";
-export declare function registerPreviewCommand(program: Command): void;
-//# sourceMappingURL=preview.d.ts.map

package/src/commands/preview.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/commands/preview.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuB7D"}

package/src/commands/preview.js

@@ -1,93 +0,0 @@
-import * as path from "path";
-import { scanProject, generate, initMswServiceWorker } from "@scenar/preview";
-export function registerPreviewCommand(program) {
-    const preview = program
-        .command("preview")
-        .description("Scan a React project and generate a preview view registry.");
-    preview
-        .command("init")
-        .description("Scan a project and generate the .scenar/ directory.")
-        .option("-s, --source <path>", "project to scan (default: cwd)")
-        .option("-o, --output <path>", "output directory for generated files (default: .scenar relative to cwd)")
-        .option("--reset-providers", "force-regenerate providers.tsx")
-        .action(async (options) => {
-        await runPreviewInit(options);
-    });
-    preview
-        .command("sync")
-        .description("Re-scan and update scanner-owned files (preserves user files).")
-        .option("-s, --source <path>", "project to scan (default: cwd)")
-        .option("-o, --output <path>", "output directory for generated files (default: .scenar relative to cwd)")
-        .action(async (options) => {
-        await runPreviewSync(options);
-    });
-}
-async function runPreviewInit(options) {
-    const sourceRoot = path.resolve(options.source ?? process.cwd());
-    const outputDir = path.resolve(options.output ?? ".scenar");
-    process.stdout.write(`\x1b[36m●\x1b[0m Scanning project: ${sourceRoot}\n`);
-    const scanResult = scanProject(sourceRoot);
-    process.stdout.write(`  Found ${scanResult.discovered.length} components, ` +
-        `skipped ${scanResult.skipped.length}\n`);
-    process.stdout.write(`  Framework: ${scanResult.framework}, ` +
-        `entry: ${scanResult.entryPoint ?? "none detected"}\n`);
-    if (scanResult.detectedProviders.length > 0) {
-        process.stdout.write(`  Providers: ${scanResult.detectedProviders.join(", ")}\n`);
-    }
-    const relOutput = path.relative(process.cwd(), outputDir);
-    process.stdout.write(`\n\x1b[36m●\x1b[0m Generating ${relOutput}/\n`);
-    const result = generate(scanResult, {
-        sourceRoot,
-        outputDir,
-        isInit: true,
-        resetProviders: options.resetProviders,
-    });
-    for (const file of result.written) {
-        process.stdout.write(`  \x1b[32m✓\x1b[0m ${file}\n`);
-    }
-    for (const file of result.preserved) {
-        process.stdout.write(`  \x1b[33m●\x1b[0m ${file} (preserved)\n`);
-    }
-    // --- MSW service worker ---
-    const projectRoot = path.resolve(path.dirname(outputDir));
-    const mswResult = initMswServiceWorker(projectRoot, scanResult.framework);
-    if (mswResult.status === "created") {
-        process.stdout.write(`\n\x1b[36m●\x1b[0m MSW service worker\n` +
-            `  \x1b[32m✓\x1b[0m ${path.relative(process.cwd(), mswResult.path)}\n`);
-    }
-    else if (mswResult.status === "exists") {
-        process.stdout.write(`\n\x1b[36m●\x1b[0m MSW service worker\n` +
-            `  \x1b[33m●\x1b[0m ${path.relative(process.cwd(), mswResult.path)} (exists)\n`);
-    }
-    else if (mswResult.status === "error") {
-        process.stdout.write(`\n\x1b[33m⚠\x1b[0m Could not generate MSW service worker: ${mswResult.error}\n` +
-            `  Run \`npx msw init public/\` manually.\n`);
-    }
-    process.stdout.write(`\n\x1b[32m✓\x1b[0m Preview initialized.\n`);
-    process.stdout.write(`  Review ${relOutput}/report.md for scan details.\n`);
-    process.stdout.write(`  Add custom views in ${relOutput}/views.custom.tsx.\n`);
-    process.stdout.write(`  Customize providers in ${relOutput}/providers.tsx.\n`);
-}
-async function runPreviewSync(options) {
-    const sourceRoot = path.resolve(options.source ?? process.cwd());
-    const outputDir = path.resolve(options.output ?? ".scenar");
-    process.stdout.write(`\x1b[36m●\x1b[0m Re-scanning project: ${sourceRoot}\n`);
-    const scanResult = scanProject(sourceRoot);
-    process.stdout.write(`  Found ${scanResult.discovered.length} components, ` +
-        `skipped ${scanResult.skipped.length}\n`);
-    const relOutput = path.relative(process.cwd(), outputDir);
-    process.stdout.write(`\n\x1b[36m●\x1b[0m Updating ${relOutput}/\n`);
-    const result = generate(scanResult, {
-        sourceRoot,
-        outputDir,
-        isInit: false,
-    });
-    for (const file of result.written) {
-        process.stdout.write(`  \x1b[32m✓\x1b[0m ${file} (updated)\n`);
-    }
-    for (const file of result.preserved) {
-        process.stdout.write(`  \x1b[33m●\x1b[0m ${file} (preserved)\n`);
-    }
-    process.stdout.write(`\n\x1b[32m✓\x1b[0m Preview synced.\n`);
-}
-//# sourceMappingURL=preview.js.map