@alwaysmeticulous/cli 2.314.0 → 2.316.0

package/dist/commands/record/__tests__/backend.command.spec.js

@@ -0,0 +1,219 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="03de1404-1280-5229-8aa8-98fba2b88cb6")}catch(e){}}();
+
+Object.defineProperty(exports, "__esModule", { value: true });
+const events_1 = require("events");
+const vitest_1 = require("vitest");
+const backend_command_1 = require("../backend.command");
+const loggerMock = {
+    info: vitest_1.vi.fn(),
+    warn: vitest_1.vi.fn(),
+    error: vitest_1.vi.fn(),
+    debug: vitest_1.vi.fn(),
+};
+class FakeChild extends events_1.EventEmitter {
+    exitCode = null;
+    signalCode = null;
+    kill = vitest_1.vi.fn();
+}
+const mocks = vitest_1.vi.hoisted(() => ({
+    resolveApiTokenWithOAuth: vitest_1.vi.fn(),
+    createClientWithOAuth: vitest_1.vi.fn(),
+    getProject: vitest_1.vi.fn(),
+    resolveProjectIdentifier: vitest_1.vi.fn(),
+    fetchAsset: vitest_1.vi.fn(),
+    resolveSidecarPort: vitest_1.vi.fn(),
+    startSidecar: vitest_1.vi.fn(),
+    spawn: vitest_1.vi.fn(),
+}));
+vitest_1.vi.mock("../../../command-utils/sentry.utils", () => ({
+    wrapHandler: (fn) => fn,
+}));
+vitest_1.vi.mock("@alwaysmeticulous/common", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        initLogger: () => loggerMock,
+    };
+});
+vitest_1.vi.mock("@alwaysmeticulous/client", () => ({
+    resolveApiTokenWithOAuth: mocks.resolveApiTokenWithOAuth,
+    createClientWithOAuth: mocks.createClientWithOAuth,
+    getProject: mocks.getProject,
+}));
+vitest_1.vi.mock("@alwaysmeticulous/downloading-helpers", () => ({
+    fetchAsset: mocks.fetchAsset,
+}));
+vitest_1.vi.mock("../../../utils/resolve-project-identifier", () => ({
+    resolveProjectIdentifier: mocks.resolveProjectIdentifier,
+}));
+vitest_1.vi.mock("../backend-sidecar.utils", async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        resolveSidecarPort: mocks.resolveSidecarPort,
+        startSidecar: mocks.startSidecar,
+    };
+});
+vitest_1.vi.mock("child_process", () => ({
+    spawn: mocks.spawn,
+}));
+const runHandler = (args = {}) => backend_command_1.recordBackendCommand.handler({
+    apiToken: null,
+    recordingToken: null,
+    port: 9670,
+    exportMode: "s3",
+    localOutputDir: null,
+    injectSidecarVar: true,
+    ...args,
+});
+const SIDECAR_URL = "http://127.0.0.1:9670";
+(0, vitest_1.describe)("record backend command", () => {
+    const originalArgv = process.argv;
+    let sidecarHandle;
+    let child;
+    let signalSnapshot;
+    (0, vitest_1.beforeEach)(() => {
+        vitest_1.vi.clearAllMocks();
+        process.argv = ["node", "main.js", "record", "backend"];
+        sidecarHandle = {
+            url: SIDECAR_URL,
+            port: 9670,
+            flush: vitest_1.vi.fn().mockResolvedValue(undefined),
+            stop: vitest_1.vi.fn().mockResolvedValue(undefined),
+        };
+        child = new FakeChild();
+        mocks.fetchAsset.mockResolvedValue("/tmp/sidecar.bundle.cjs");
+        mocks.resolveSidecarPort.mockResolvedValue(9670);
+        mocks.startSidecar.mockResolvedValue(sidecarHandle);
+        mocks.spawn.mockReturnValue(child);
+        signalSnapshot = {
+            INT: process.listeners("SIGINT"),
+            TERM: process.listeners("SIGTERM"),
+        };
+    });
+    (0, vitest_1.afterEach)(() => {
+        process.argv = originalArgv;
+        // The handler registers process signal listeners; drop the ones this test added.
+        for (const listener of process.listeners("SIGINT")) {
+            if (!signalSnapshot.INT.includes(listener)) {
+                process.removeListener("SIGINT", listener);
+            }
+        }
+        for (const listener of process.listeners("SIGTERM")) {
+            if (!signalSnapshot.TERM.includes(listener)) {
+                process.removeListener("SIGTERM", listener);
+            }
+        }
+    });
+    const runWrapped = async (args, passthrough) => {
+        process.argv = [
+            "node",
+            "main.js",
+            "record",
+            "backend",
+            "--",
+            ...passthrough,
+        ];
+        const handlerDone = runHandler(args);
+        // Let the handler reach the spawn before the child "exits".
+        await vitest_1.vi.waitFor(() => (0, vitest_1.expect)(mocks.spawn).toHaveBeenCalled());
+        child.exitCode = 0;
+        child.emit("exit", 0, null);
+        await handlerDone;
+    };
+    (0, vitest_1.it)("uses --recordingToken without touching the API", async () => {
+        await runWrapped({ recordingToken: "direct-token" }, ["node", "dev.js"]);
+        (0, vitest_1.expect)(mocks.resolveApiTokenWithOAuth).not.toHaveBeenCalled();
+        (0, vitest_1.expect)(mocks.getProject).not.toHaveBeenCalled();
+        (0, vitest_1.expect)(mocks.startSidecar).toHaveBeenCalledWith(vitest_1.expect.objectContaining({
+            env: vitest_1.expect.objectContaining({
+                METICULOUS_RECORDING_TOKEN: "direct-token",
+                METICULOUS_EXPORT_MODE: "s3",
+            }),
+        }));
+        (0, vitest_1.expect)(sidecarHandle.stop).toHaveBeenCalled();
+    });
+    (0, vitest_1.it)("resolves the recording token and project name via the API", async () => {
+        mocks.resolveApiTokenWithOAuth.mockResolvedValue("api-token");
+        mocks.resolveProjectIdentifier.mockResolvedValue({ projectId: "p-1" });
+        mocks.createClientWithOAuth.mockResolvedValue({});
+        mocks.getProject.mockResolvedValue({
+            recordingToken: "project-recording-token",
+            name: "my-project",
+            organization: { name: "my-org" },
+        });
+        await runWrapped({}, ["node", "dev.js"]);
+        (0, vitest_1.expect)(mocks.startSidecar).toHaveBeenCalledWith(vitest_1.expect.objectContaining({
+            env: vitest_1.expect.objectContaining({
+                METICULOUS_RECORDING_TOKEN: "project-recording-token",
+                METICULOUS_PROJECT_NAME: "my-project",
+            }),
+        }));
+    });
+    (0, vitest_1.it)("fails cleanly when the project has no recording token", async () => {
+        mocks.resolveApiTokenWithOAuth.mockResolvedValue("api-token");
+        mocks.resolveProjectIdentifier.mockResolvedValue({ projectId: "p-1" });
+        mocks.createClientWithOAuth.mockResolvedValue({});
+        mocks.getProject.mockResolvedValue({
+            recordingToken: null,
+            name: "my-project",
+            organization: { name: "my-org" },
+        });
+        process.argv = ["node", "main.js", "record", "backend", "--", "node"];
+        await (0, vitest_1.expect)(runHandler({})).rejects.toThrow(/recording token/);
+        (0, vitest_1.expect)(mocks.startSidecar).not.toHaveBeenCalled();
+    });
+    (0, vitest_1.it)("injects --var into a recognized wrangler dev command", async () => {
+        await runWrapped({ recordingToken: "t" }, ["npx", "wrangler", "dev"]);
+        (0, vitest_1.expect)(mocks.spawn).toHaveBeenCalledWith("npx", ["wrangler", "dev", "--var", `METICULOUS_SIDECAR_URL:${SIDECAR_URL}`], vitest_1.expect.objectContaining({
+            stdio: "inherit",
+            env: vitest_1.expect.objectContaining({
+                METICULOUS_SIDECAR_URL: SIDECAR_URL,
+            }),
+        }));
+    });
+    (0, vitest_1.it)("does not inject with --no-injectSidecarVar and prints instructions", async () => {
+        await runWrapped({ recordingToken: "t", injectSidecarVar: false }, [
+            "npx",
+            "wrangler",
+            "dev",
+        ]);
+        (0, vitest_1.expect)(mocks.spawn).toHaveBeenCalledWith("npx", ["wrangler", "dev"], vitest_1.expect.anything());
+        (0, vitest_1.expect)(loggerMock.info).toHaveBeenCalledWith(vitest_1.expect.stringContaining("wrangler dev --var METICULOUS_SIDECAR_URL:"));
+    });
+    (0, vitest_1.it)("prints instructions for unrecognized dev commands", async () => {
+        await runWrapped({ recordingToken: "t" }, ["npm", "run", "dev"]);
+        (0, vitest_1.expect)(mocks.spawn).toHaveBeenCalledWith("npm", ["run", "dev"], vitest_1.expect.anything());
+        (0, vitest_1.expect)(loggerMock.info).toHaveBeenCalledWith(vitest_1.expect.stringContaining(".dev.vars"));
+    });
+    (0, vitest_1.it)("rejects a positional dev command passed without --", async () => {
+        process.argv = [
+            "node",
+            "main.js",
+            "record",
+            "backend",
+            "npx",
+            "wrangler",
+            "dev",
+        ];
+        await (0, vitest_1.expect)(runHandler({
+            recordingToken: "t",
+            devCommand: ["npx", "wrangler", "dev"],
+        })).rejects.toThrow(/-- separator/);
+        (0, vitest_1.expect)(mocks.startSidecar).not.toHaveBeenCalled();
+        (0, vitest_1.expect)(mocks.spawn).not.toHaveBeenCalled();
+    });
+    (0, vitest_1.it)("runs sidecar-only mode until a signal arrives", async () => {
+        process.argv = ["node", "main.js", "record", "backend"];
+        const handlerDone = runHandler({ recordingToken: "t" });
+        await vitest_1.vi.waitFor(() => (0, vitest_1.expect)(mocks.startSidecar).toHaveBeenCalled());
+        await vitest_1.vi.waitFor(() => (0, vitest_1.expect)(loggerMock.info).toHaveBeenCalledWith(vitest_1.expect.stringContaining("Ctrl-C")));
+        process.emit("SIGINT");
+        await handlerDone;
+        (0, vitest_1.expect)(sidecarHandle.stop).toHaveBeenCalled();
+        (0, vitest_1.expect)(mocks.spawn).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=backend.command.spec.js.map
+//# debugId=03de1404-1280-5229-8aa8-98fba2b88cb6

package/dist/commands/record/__tests__/backend.command.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.command.spec.js","sources":["../../../../src/commands/record/__tests__/backend.command.spec.ts"],"sourceRoot":"","names":[],"mappings":"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","debugId":"03de1404-1280-5229-8aa8-98fba2b88cb6"}

package/dist/commands/record/backend-dev-command.utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Pure helpers for `meticulous record backend`: extracting the passthrough
+ * dev command from raw argv and injecting the sidecar URL into recognized
+ * wrangler invocations.
+ */
+/**
+ * Returns the tokens after the first standalone `--` in the given argv, or
+ * null when there is no `--` (or nothing follows it). Reads raw argv rather
+ * than yargs' parsed positionals so passthrough flags (e.g. `--port` meant
+ * for wrangler) and numeric-looking tokens survive untouched.
+ */
+export declare const extractPassthroughCommand: (argv: string[]) => string[] | null;
+export type DevCommandKind = "wrangler-dev" | "wrangler-pages-dev" | "unknown";
+/**
+ * Classifies a passthrough dev command so the sidecar URL can be injected
+ * with the right wrangler flag. Only positively-recognized invocations are
+ * classified — anything else (npm scripts, custom wrappers) is "unknown" and
+ * gets printed instructions instead of argv surgery.
+ */
+export declare const classifyDevCommand: (tokens: string[]) => DevCommandKind;
+export declare const SIDECAR_URL_VAR_NAME = "METICULOUS_SIDECAR_URL";
+/**
+ * Appends the flag that exposes the sidecar URL to the worker as a var:
+ * `wrangler dev` takes `--var KEY:VALUE`, `wrangler pages dev` takes
+ * `--binding KEY=VALUE`. Unknown commands are returned unchanged — the
+ * caller prints manual instructions instead.
+ */
+export declare const injectSidecarVar: (tokens: string[], kind: DevCommandKind, sidecarUrl: string) => string[];
+//# sourceMappingURL=backend-dev-command.utils.d.ts.map

package/dist/commands/record/backend-dev-command.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-dev-command.utils.d.ts","sourceRoot":"","sources":["../../../src/commands/record/backend-dev-command.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,SAAU,MAAM,EAAE,KAAG,MAAM,EAAE,GAAG,IAOrE,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,oBAAoB,GAAG,SAAS,CAAC;AAa/E;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,WAAY,MAAM,EAAE,KAAG,cA+BrD,CAAC;AAEF,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,WACnB,MAAM,EAAE,QACV,cAAc,cACR,MAAM,KACjB,MAAM,EASR,CAAC"}

package/dist/commands/record/backend-dev-command.utils.js

@@ -0,0 +1,91 @@
+"use strict";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9f9f2445-b2f8-5f94-89e2-77d47ff1d9ab")}catch(e){}}();
+
+/**
+ * Pure helpers for `meticulous record backend`: extracting the passthrough
+ * dev command from raw argv and injecting the sidecar URL into recognized
+ * wrangler invocations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.injectSidecarVar = exports.SIDECAR_URL_VAR_NAME = exports.classifyDevCommand = exports.extractPassthroughCommand = void 0;
+/**
+ * Returns the tokens after the first standalone `--` in the given argv, or
+ * null when there is no `--` (or nothing follows it). Reads raw argv rather
+ * than yargs' parsed positionals so passthrough flags (e.g. `--port` meant
+ * for wrangler) and numeric-looking tokens survive untouched.
+ */
+const extractPassthroughCommand = (argv) => {
+    const separatorIndex = argv.indexOf("--");
+    if (separatorIndex === -1) {
+        return null;
+    }
+    const passthrough = argv.slice(separatorIndex + 1);
+    return passthrough.length > 0 ? passthrough : null;
+};
+exports.extractPassthroughCommand = extractPassthroughCommand;
+/** Package-runner prefixes to skip when looking for the real binary. */
+const RUNNERS = new Set(["npx", "bunx", "yarn"]);
+const PNPM_SUBCOMMANDS = new Set(["exec", "dlx", "run"]);
+const RUNNER_FLAGS = new Set(["-y", "--yes", "-q", "--quiet", "--silent"]);
+const isWranglerToken = (token) => token === "wrangler" ||
+    token.endsWith("/wrangler") ||
+    token.endsWith("/wrangler.cmd") ||
+    token === "wrangler.cmd";
+/**
+ * Classifies a passthrough dev command so the sidecar URL can be injected
+ * with the right wrangler flag. Only positively-recognized invocations are
+ * classified — anything else (npm scripts, custom wrappers) is "unknown" and
+ * gets printed instructions instead of argv surgery.
+ */
+const classifyDevCommand = (tokens) => {
+    let index = 0;
+    // Skip package runners and their common flags: `npx [-y] wrangler ...`,
+    // `pnpm [exec|dlx] wrangler ...`, `yarn wrangler ...`, `bunx wrangler ...`.
+    if (index < tokens.length) {
+        const first = tokens[index];
+        if (RUNNERS.has(first)) {
+            index++;
+        }
+        else if (first === "pnpm") {
+            index++;
+            if (index < tokens.length && PNPM_SUBCOMMANDS.has(tokens[index])) {
+                index++;
+            }
+        }
+        while (index < tokens.length && RUNNER_FLAGS.has(tokens[index])) {
+            index++;
+        }
+    }
+    if (index >= tokens.length || !isWranglerToken(tokens[index])) {
+        return "unknown";
+    }
+    index++;
+    if (tokens[index] === "dev") {
+        return "wrangler-dev";
+    }
+    if (tokens[index] === "pages" && tokens[index + 1] === "dev") {
+        return "wrangler-pages-dev";
+    }
+    return "unknown";
+};
+exports.classifyDevCommand = classifyDevCommand;
+exports.SIDECAR_URL_VAR_NAME = "METICULOUS_SIDECAR_URL";
+/**
+ * Appends the flag that exposes the sidecar URL to the worker as a var:
+ * `wrangler dev` takes `--var KEY:VALUE`, `wrangler pages dev` takes
+ * `--binding KEY=VALUE`. Unknown commands are returned unchanged — the
+ * caller prints manual instructions instead.
+ */
+const injectSidecarVar = (tokens, kind, sidecarUrl) => {
+    switch (kind) {
+        case "wrangler-dev":
+            return [...tokens, "--var", `${exports.SIDECAR_URL_VAR_NAME}:${sidecarUrl}`];
+        case "wrangler-pages-dev":
+            return [...tokens, "--binding", `${exports.SIDECAR_URL_VAR_NAME}=${sidecarUrl}`];
+        case "unknown":
+            return tokens;
+    }
+};
+exports.injectSidecarVar = injectSidecarVar;
+//# sourceMappingURL=backend-dev-command.utils.js.map
+//# debugId=9f9f2445-b2f8-5f94-89e2-77d47ff1d9ab

package/dist/commands/record/backend-dev-command.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-dev-command.utils.js","sources":["../../../src/commands/record/backend-dev-command.utils.ts"],"sourceRoot":"","names":[],"mappings":";;;AAAA;;;;GAIG;;;AAEH;;;;;GAKG;AACI,MAAM,yBAAyB,GAAG,CAAC,IAAc,EAAmB,EAAE;IAC3E,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;IACnD,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC,CAAC;AAPW,QAAA,yBAAyB,6BAOpC;AAIF,wEAAwE;AACxE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACjD,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AACzD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAE3E,MAAM,eAAe,GAAG,CAAC,KAAa,EAAW,EAAE,CACjD,KAAK,KAAK,UAAU;IACpB,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC;IAC3B,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;IAC/B,KAAK,KAAK,cAAc,CAAC;AAE3B;;;;;GAKG;AACI,MAAM,kBAAkB,GAAG,CAAC,MAAgB,EAAkB,EAAE;IACrE,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,wEAAwE;IACxE,4EAA4E;IAC5E,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvB,KAAK,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;YAC5B,KAAK,EAAE,CAAC;YACR,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjE,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QACD,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAChE,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IAED,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9D,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,KAAK,EAAE,CAAC;IAER,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC;QAC5B,OAAO,cAAc,CAAC;IACxB,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QAC7D,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AA/BW,QAAA,kBAAkB,sBA+B7B;AAEW,QAAA,oBAAoB,GAAG,wBAAwB,CAAC;AAE7D;;;;;GAKG;AACI,MAAM,gBAAgB,GAAG,CAC9B,MAAgB,EAChB,IAAoB,EACpB,UAAkB,EACR,EAAE;IACZ,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,cAAc;YACjB,OAAO,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,4BAAoB,IAAI,UAAU,EAAE,CAAC,CAAC;QACvE,KAAK,oBAAoB;YACvB,OAAO,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,4BAAoB,IAAI,UAAU,EAAE,CAAC,CAAC;QAC3E,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAbW,QAAA,gBAAgB,oBAa3B","debugId":"9f9f2445-b2f8-5f94-89e2-77d47ff1d9ab"}

package/dist/commands/record/backend-sidecar.utils.d.ts

@@ -0,0 +1,39 @@
+export declare const DEFAULT_SIDECAR_PORT = 9670;
+export interface SidecarHandle {
+    url: string;
+    port: number;
+    /** Best-effort force-flush of buffered spans (never rejects). */
+    flush: () => Promise<void>;
+    /** Flushes then terminates the sidecar process. Idempotent. */
+    stop: () => Promise<void>;
+}
+export interface StartSidecarOptions {
+    /** Path to the fetched sidecar bundle (node-runnable .cjs). */
+    bundlePath: string;
+    /** Concrete port — resolve with resolveSidecarPort first. */
+    port: number;
+    /** Recorder env (METICULOUS_*) merged over the CLI's own process.env. */
+    env: Record<string, string>;
+    /**
+     * Called when the sidecar exits unexpectedly and the single automatic
+     * restart has already been used — recording has stopped for good.
+     */
+    onRecordingStopped?: () => void;
+}
+/**
+ * Resolves the port the sidecar will listen on. `requested === 0` always
+ * picks an ephemeral port. A busy requested port falls back to an ephemeral
+ * one in wrapped mode (the CLI controls the URL injected into the worker) but
+ * is a hard error in sidecar-only mode, where the user is about to configure
+ * the printed URL by hand and needs it predictable.
+ */
+export declare const resolveSidecarPort: (requested: number, mode: "wrapped" | "sidecar-only") => Promise<number>;
+/**
+ * Spawns the sidecar bundle as a detached child process, waits for it to
+ * become healthy, and supervises it: one automatic restart on the same port
+ * if it dies unexpectedly (the worker holds the old URL, so the port must be
+ * reused), after which recording is declared stopped without affecting the
+ * wrapped dev command.
+ */
+export declare const startSidecar: (options: StartSidecarOptions) => Promise<SidecarHandle>;
+//# sourceMappingURL=backend-sidecar.utils.d.ts.map

package/dist/commands/record/backend-sidecar.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-sidecar.utils.d.ts","sourceRoot":"","sources":["../../../src/commands/record/backend-sidecar.utils.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAQzC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC;AA6BD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,cAClB,MAAM,QACX,SAAS,GAAG,cAAc,KAC/B,OAAO,CAAC,MAAM,CAiBhB,CAAC;AA8HF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,YACd,mBAAmB,KAC3B,OAAO,CAAC,aAAa,CAmGvB,CAAC"}