rampway 0.5.0 → 0.5.2

package/build/src/runtimes/compose-runtime.js

@@ -0,0 +1,106 @@
+import { createHash } from "node:crypto";
+import path from "node:path";
+export class ComposeRuntime {
+    /** @type {"compose"} */
+    static type = "compose";
+    /** @type {true} */
+    requiresStableState = true;
+    /** @returns {"compose"} */
+    get type() {
+        return "compose";
+    }
+    /**
+     * @param {import("#types").ComposeRuntimeConfig} config
+     */
+    constructor(config) {
+        /** @type {import("#types").ComposeRuntimeConfig} */
+        this.config = { ...config, type: "compose" };
+    }
+    /** @returns {string[]} */
+    plan() {
+        return ["run configured Compose handoff", "run configured Compose health check"];
+    }
+    /**
+     * Runtime state deliberately records only a hash of trusted commands. The
+     * commands themselves may reference credentials through their environment.
+     *
+     * @returns {Promise<import("#types").RuntimeSnapshot>}
+     */
+    async prepare() {
+        return {
+            schemaVersion: 1,
+            type: "compose",
+            contractDigest: `sha256:${this.contractDigest()}`,
+            composeRoot: this.config.composeRoot
+        };
+    }
+    /**
+     * @param {import("#types").RuntimeSnapshot} snapshot
+     * @returns {void}
+     */
+    validateSnapshot(snapshot) {
+        if (snapshot.type !== "compose")
+            throw new Error("Stored Compose runtime state has an invalid runtime type.");
+        if (!/^sha256:[0-9a-f]{64}$/u.test(snapshot.contractDigest ?? "")) {
+            throw new Error("Stored Compose runtime state is missing a valid known-good contract digest.");
+        }
+        if (typeof snapshot.composeRoot !== "string" || !isAbsolutePath(snapshot.composeRoot)) {
+            throw new Error("Stored Compose runtime state has an unsafe absolute compose root.");
+        }
+    }
+    /**
+     * @param {import("#types").Transport} transport
+     * @param {{currentSnapshot?: import("#types").RuntimeSnapshot, releaseId?: string, releasePath?: string, targetSnapshot?: import("#types").RuntimeSnapshot}} opts
+     * @returns {Promise<{status: string}>}
+     */
+    async deploy(transport, { currentSnapshot, releaseId, releasePath, targetSnapshot } = {}) {
+        if (currentSnapshot)
+            this.assertConfiguredContract(currentSnapshot);
+        if (targetSnapshot)
+            this.assertConfiguredContract(targetSnapshot);
+        const env = {
+            RAMPWAY_RELEASE_ID: String(releaseId ?? ""),
+            RAMPWAY_RELEASE_PATH: String(releasePath ?? "")
+        };
+        try {
+            await transport.run(this.config.handoffCommand, { cwd: this.config.composeRoot, env });
+        }
+        catch (error) {
+            throw new Error(`Compose handoff failed: ${ /** @type {Error} */(error).message}`);
+        }
+        try {
+            await transport.run(this.config.healthCommand, { cwd: this.config.composeRoot, env });
+        }
+        catch (error) {
+            throw new Error(`Compose health check failed: ${ /** @type {Error} */(error).message}`);
+        }
+        return { status: "deployed" };
+    }
+    /**
+     * @param {import("#types").RuntimeSnapshot} snapshot
+     * @returns {void}
+     */
+    assertConfiguredContract(snapshot) {
+        this.validateSnapshot(snapshot);
+        if (snapshot.composeRoot !== this.config.composeRoot || snapshot.contractDigest !== `sha256:${this.contractDigest()}`) {
+            throw new Error("Stored Compose runtime state does not match the configured Compose contract.");
+        }
+    }
+    /** @returns {string} */
+    contractDigest() {
+        return createHash("sha256").update(JSON.stringify({
+            type: "compose",
+            composeRoot: this.config.composeRoot,
+            handoffCommand: this.config.handoffCommand,
+            healthCommand: this.config.healthCommand
+        })).digest("hex");
+    }
+}
+/**
+ * @param {string} value
+ * @returns {boolean}
+ */
+function isAbsolutePath(value) {
+    return path.posix.isAbsolute(value) || path.win32.isAbsolute(value);
+}
+//# sourceMappingURL=compose-runtime.js.map

package/build/src/runtimes/compose-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-runtime.js","sourceRoot":"","sources":["../../../src/runtimes/compose-runtime.js"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAA;AACtC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,OAAO,cAAc;IACzB,wBAAwB;IACxB,MAAM,CAAC,IAAI,GAAG,SAAS,CAAA;IAEvB,mBAAmB;IACnB,mBAAmB,GAAG,IAAI,CAAA;IAE1B,2BAA2B;IAC3B,IAAI,IAAI;QACN,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;OAEG;IACH,YAAY,MAAM;QAChB,oDAAoD;QACpD,IAAI,CAAC,MAAM,GAAG,EAAC,GAAG,MAAM,EAAE,IAAI,EAAE,SAAS,EAAC,CAAA;IAC5C,CAAC;IAED,0BAA0B;IAC1B,IAAI;QACF,OAAO,CAAC,gCAAgC,EAAE,qCAAqC,CAAC,CAAA;IAClF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO;QACX,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,IAAI,EAAE,SAAS;YACf,cAAc,EAAE,UAAU,IAAI,CAAC,cAAc,EAAE,EAAE;YACjD,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;SACrC,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,QAAQ;QACvB,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAA;QAC7G,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,EAAE,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAA;QAChG,CAAC;QACD,IAAI,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;QACtF,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,EAAC,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAC,GAAG,EAAE;QACpF,IAAI,eAAe;YAAE,IAAI,CAAC,wBAAwB,CAAC,eAAe,CAAC,CAAA;QACnE,IAAI,cAAc;YAAE,IAAI,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAA;QACjE,MAAM,GAAG,GAAG;YACV,kBAAkB,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;YAC3C,oBAAoB,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;SAChD,CAAA;QACD,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAC,CAAC,CAAA;QACtF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAA,oBAAqB,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QACpF,CAAC;QACD,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAC,CAAC,CAAA;QACrF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAA,oBAAqB,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QACzF,CAAC;QACD,OAAO,EAAC,MAAM,EAAE,UAAU,EAAC,CAAA;IAC7B,CAAC;IAED;;;OAGG;IACH,wBAAwB,CAAC,QAAQ;QAC/B,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC/B,IAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,cAAc,KAAK,UAAU,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,CAAC;YACtH,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAA;QACjG,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,cAAc;QACZ,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;YAChD,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;YACpC,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC1C,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;SACzC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACnB,CAAC;;AAGH;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAK;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;AACrE,CAAC"}

package/build/src/runtimes/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtimes/index.js"],"names":[],"mappings":"AAuCA;;;GAGG;AACH,gDAHW,KAAK,CAAC,WAAS,CAAC,MAAM,EAAE,OAAO,QAAQ,EAAE,eAAe,CAAC,CAAC,GACxD;IAAC,QAAQ,WAAW;IAAC,UAAU,WAAW;IAAC,SAAS,WAAU;CAAC,CAmC3E;AAED;;;GAGG;AACH,6CAHW,MAAM,WAAS,YACf,OAAO,QAAQ,EAAE,eAAe,QAI1C;AAED;;;GAGG;AACH,kCAHW,OAAO,QAAQ,EAAE,WAAW,GAC1B,OAAO,QAAQ,EAAE,cAAc,CAI3C;AAED;;GAEG;AACH,oCAFa,MAAM,EAAE,CAIpB;AAhGD;IACE;;OAEG;IACH,qBAFW,OAAO,CAAC,OAAO,QAAQ,EAAE,aAAa,CAAC,EAKjD;IAFC,6CAA6C;IAC7C,QADW,OAAO,QAAQ,EAAE,aAAa,CAC8C;IAGzF,wBAAwB;IACxB,YADc,MAAM,CAGnB;IAED;;OAEG;IACH,QAFa,MAAM,EAAE,CAIpB;IAED;;OAEG;IACH,UAFa,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAIrC;IAED;;OAEG;IACH,UAFa,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAInD;CACF;AAiGD;;;;EAA6F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtimes/index.js"],"names":[],"mappings":"AAwCA;;;GAGG;AACH,gDAHW,KAAK,CAAC,WAAS,CAAC,MAAM,EAAE,OAAO,QAAQ,EAAE,eAAe,CAAC,CAAC,GACxD;IAAC,QAAQ,WAAW;IAAC,UAAU,WAAW;IAAC,SAAS,WAAU;CAAC,CAmC3E;AAED;;;GAGG;AACH,6CAHW,MAAM,WAAS,YACf,OAAO,QAAQ,EAAE,eAAe,QAI1C;AAED;;;GAGG;AACH,kCAHW,OAAO,QAAQ,EAAE,WAAW,GAC1B,OAAO,QAAQ,EAAE,cAAc,CAI3C;AAED;;GAEG;AACH,oCAFa,MAAM,EAAE,CAIpB;AAhGD;IACE;;OAEG;IACH,qBAFW,OAAO,CAAC,OAAO,QAAQ,EAAE,aAAa,CAAC,EAKjD;IAFC,6CAA6C;IAC7C,QADW,OAAO,QAAQ,EAAE,aAAa,CAC8C;IAGzF,wBAAwB;IACxB,YADc,MAAM,CAGnB;IAED;;OAEG;IACH,QAFa,MAAM,EAAE,CAIpB;IAED;;OAEG;IACH,UAFa,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAIrC;IAED;;OAEG;IACH,UAFa,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAInD;CACF;AAiGD;;;;EAA6G"}

package/build/src/runtimes/index.js

@@ -1,3 +1,4 @@
+import { ComposeRuntime } from "./compose-runtime.js";
 import { NoneRuntime } from "./none-runtime.js";
 import { RollbridgeRuntime } from "./rollbridge-runtime.js";
 export class BaseRuntime {
@@ -128,5 +129,5 @@ function runtimeForStage(stage, factories) {
         runtime.plan = () => [];
     return runtime;
 }
-export const defaultRuntimeRegistry = createRuntimeRegistry([NoneRuntime, RollbridgeRuntime]);
+export const defaultRuntimeRegistry = createRuntimeRegistry([ComposeRuntime, NoneRuntime, RollbridgeRuntime]);
 //# sourceMappingURL=index.js.map

package/build/src/runtimes/index.js.map

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

package/build/src/types.d.ts

@@ -7,6 +7,32 @@ export type TransportConfig = {
     sshOptions?: string[] | undefined;
     extra?: Record<string, unknown> | undefined;
 };
+export type HttpTransportConfig = {
+    /**
+     * - Base URL of the mounted control plane, e.g. `https://app.example/rampway/deployments`.
+     */
+    endpoint: string;
+    /**
+     * - Bearer token for the control plane.
+     */
+    accessToken?: string | undefined;
+    /**
+     * - Environment variable holding the bearer token, when `accessToken` is not inline.
+     */
+    accessTokenEnv?: string | undefined;
+    /**
+     * - Control-plane project identifier; defaults to the stage application.
+     */
+    project?: string | undefined;
+    /**
+     * - Polling interval while waiting for a run to finish.
+     */
+    pollIntervalMs?: number | undefined;
+    /**
+     * - Maximum time to wait for a run to reach a terminal status.
+     */
+    timeoutMs?: number | undefined;
+};
 export type LinkedEntry = {
     path: string;
     required: boolean;
@@ -27,6 +53,9 @@ export type RuntimeConfig = {
     socketPath?: string | undefined;
     versionPath?: string | undefined;
     env?: Record<string, string> | undefined;
+    composeRoot?: string | undefined;
+    handoffCommand?: string | undefined;
+    healthCommand?: string | undefined;
 };
 export type TaskEntry = {
     name?: string | undefined;
@@ -67,6 +96,7 @@ export type StageConfig = {
     deployTo: string;
     strategy: "local-copy" | "remote-git" | "archive-upload";
     transport: TransportConfig;
+    http?: HttpTransportConfig | undefined;
     hosts?: {
         host: string;
         user?: string;
@@ -109,6 +139,7 @@ export type RuntimeSnapshot = {
     socketPath?: string | undefined;
     versionPath?: string | undefined;
     envNames?: string[] | undefined;
+    composeRoot?: string | undefined;
 };
 export type RuntimeRelease = {
     releaseId: string;
@@ -139,6 +170,14 @@ export type DeployReport = {
     healthChecks?: string | undefined;
     runtime?: object | undefined;
     cleanupRemoved?: string[] | undefined;
+    /**
+     * - Control-plane run identifier, when deployed over HTTP.
+     */
+    runId?: string | undefined;
+    /**
+     * - Transport actually used for the deploy.
+     */
+    transport?: "local" | "ssh" | "http" | undefined;
 };
 export type RollbackReport = {
     application: string;
@@ -250,6 +289,10 @@ export type CommandOptions = {
     to?: string | undefined;
     releasePath?: string | undefined;
     dir?: string | undefined;
+    /**
+     * - Deploy transport selection. `auto` (default) tries the HTTP control plane first and falls back to the direct transport only when the endpoint is unavailable or not deployed.
+     */
+    transport?: "ssh" | "http" | "auto" | undefined;
 };
 export type CommandArgs = {
     stageName: string;
@@ -385,6 +428,12 @@ export type RollbridgeRuntimeConfig = {
     versionPath?: string | undefined;
     env?: Record<string, string> | undefined;
 };
+export type ComposeRuntimeConfig = {
+    type: "compose";
+    composeRoot: string;
+    handoffCommand: string;
+    healthCommand: string;
+};
 export type SpawnResult = {
     code: number;
     output: string;

package/build/src/types.d.ts.map

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

package/build/src/velocious/client.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Whether a control-plane failure is eligible for the SSH/direct fallback.
+ *
+ * The control plane is tried first only while it is unavailable or not
+ * deployed; authentication and validation decisions (401/403/409/422) and any
+ * failure after a run was admitted are always surfaced instead.
+ *
+ * @param {unknown} error
+ * @returns {boolean}
+ */
+export function isFallbackEligible(error: unknown): boolean;
+/**
+ * @param {unknown} value
+ * @returns {value is string} Whether the value is a full 40-character commit SHA.
+ */
+export function isFullCommitSha(value: unknown): value is string;
+/**
+ * Resolves the immutable revision a control-plane deploy requires. A full
+ * 40-character SHA is used as-is; otherwise the configured release branch is
+ * resolved to its current tip with `git ls-remote`.
+ *
+ * @param {{repo?: string, revision?: string, branch?: string}} args
+ * @returns {Promise<string>} Full commit SHA.
+ */
+export function resolveControlPlaneRevision({ repo, revision, branch }: {
+    repo?: string;
+    revision?: string;
+    branch?: string;
+}): Promise<string>;
+/**
+ * Creates a deployment run on the control plane and classifies the outcome.
+ *
+ * @param {{endpoint: string, accessToken: string, project: string, stage: string, revision: string, idempotencyKey: string, fetchImpl?: typeof fetch}} args
+ * @returns {Promise<{run: DeploymentRun, replayed: boolean}>}
+ */
+export function createDeploymentRun({ endpoint, accessToken, project, stage, revision, idempotencyKey, fetchImpl }: {
+    endpoint: string;
+    accessToken: string;
+    project: string;
+    stage: string;
+    revision: string;
+    idempotencyKey: string;
+    fetchImpl?: typeof fetch;
+}): Promise<{
+    run: DeploymentRun;
+    replayed: boolean;
+}>;
+/**
+ * Polls a control-plane run until it reaches a terminal status. Any failure
+ * after admission (including lost contact) is a hard error: the run exists on
+ * the control plane, so there is nothing left to fall back to.
+ *
+ * @param {{endpoint: string, accessToken: string, runId: string, pollIntervalMs?: number, timeoutMs?: number, fetchImpl?: typeof fetch, now?: () => number, reporter?: Reporter}} args
+ * @returns {Promise<DeploymentRun>}
+ */
+export function pollDeploymentRun({ endpoint, accessToken, runId, pollIntervalMs, timeoutMs, fetchImpl, now, reporter }: {
+    endpoint: string;
+    accessToken: string;
+    runId: string;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+    reporter?: Reporter;
+}): Promise<DeploymentRun>;
+/**
+ * Deploys a stage through the mounted control plane: resolves the immutable
+ * revision, creates an idempotent run, polls it to completion, and returns the
+ * control-plane deploy report annotated with the run identifier.
+ *
+ * @param {{stage: import('#types').StageConfig, httpConfig: import('#types').HttpTransportConfig, revision?: string, reporter?: Reporter, fetchImpl?: typeof fetch}} args
+ * @returns {Promise<import('#types').DeployReport>}
+ */
+export function deployViaControlPlane({ stage, httpConfig, revision, reporter, fetchImpl }: {
+    stage: import("#types").StageConfig;
+    httpConfig: import("#types").HttpTransportConfig;
+    revision?: string;
+    reporter?: Reporter;
+    fetchImpl?: typeof fetch;
+}): Promise<import("#types").DeployReport>;
+/**
+ * Builds a client-generated idempotency key that is stable per invocation, so
+ * retrying the same command replays an existing admitted run instead of
+ * creating a duplicate.
+ *
+ * @param {string} project
+ * @param {string} stage
+ * @param {string} revision
+ * @returns {string}
+ */
+export function controlPlaneIdempotencyKey(project: string, stage: string, revision: string): string;
+/**
+ * @name DeploymentRun
+ * @description Public representation of a control-plane deployment run.
+ * @typedef {object} DeploymentRun
+ * @property {string} id
+ * @property {string} status
+ * @property {Record<string, any>} [result]
+ * @property {{message?: string, recovery?: any}} [error]
+ */
+/**
+ * Control-plane failure that must not trigger a transport fallback: an
+ * authenticated admission decision (401/403/409/422), a 5xx that already
+ * admitted a run, or an interruption after a run was admitted.
+ */
+export class ControlPlaneError extends Error {
+    /**
+     * @param {string} message
+     * @param {{status?: number, cause?: unknown, runId?: string|null}} [opts]
+     */
+    constructor(message: string, { status, cause, runId }?: {
+        status?: number;
+        cause?: unknown;
+        runId?: string | null;
+    });
+    /** @type {number|null} */
+    status: number | null;
+    /** @type {string|null} */
+    runId: string | null;
+}
+/**
+ * Control-plane unavailability that may fall back to the direct transport:
+ * network-level failure, a not-deployed endpoint/target (404), or a 5xx
+ * without any admitted run.
+ */
+export class ControlPlaneUnavailableError extends ControlPlaneError {
+    /**
+     * @param {string} message
+     * @param {{status?: number, cause?: unknown}} [opts]
+     */
+    constructor(message: string, { status, cause }?: {
+        status?: number;
+        cause?: unknown;
+    });
+}
+export type DeploymentRun = {
+    id: string;
+    status: string;
+    result?: Record<string, any> | undefined;
+    error?: {
+        message?: string;
+        recovery?: any;
+    } | undefined;
+};
+import { Reporter } from "../core/reporter.js";
+//# sourceMappingURL=client.d.ts.map

package/build/src/velocious/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/velocious/client.js"],"names":[],"mappings":"AA2DA;;;;;;;;;GASG;AACH,0CAHW,OAAO,GACL,OAAO,CAInB;AAED;;;GAGG;AACH,uCAHW,OAAO,GACL,KAAK,IAAI,MAAM,CAI3B;AAED;;;;;;;GAOG;AACH,wEAHW;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAC,GACjD,OAAO,CAAC,MAAM,CAAC,CAe3B;AAED;;;;;GAKG;AACH,oHAHW;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAC,GACzI,OAAO,CAAC;IAAC,GAAG,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAC,CAAC,CAmC5D;AAED;;;;;;;GAOG;AACH,yHAHW;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAC,GACpK,OAAO,CAAC,aAAa,CAAC,CA6BlC;AAED;;;;;;;GAOG;AACH,4FAHW;IAAC,KAAK,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,OAAO,QAAQ,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAC,GACvJ,OAAO,CAAC,OAAO,QAAQ,EAAE,YAAY,CAAC,CAgClD;AAED;;;;;;;;;GASG;AACH,oDALW,MAAM,SACN,MAAM,YACN,MAAM,GACJ,MAAM,CAIlB;AA3ND;;;;;;;;GAQG;AAEH;;;;GAIG;AACH;IACE;;;OAGG;IACH,qBAHW,MAAM,6BACN;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAC,IAAI,CAAA;KAAC,EAQjE;IAJC,0BAA0B;IAC1B,QADW,MAAM,GAAC,IAAI,CACM;IAC5B,0BAA0B;IAC1B,OADW,MAAM,GAAC,IAAI,CACJ;CAErB;AAED;;;;GAIG;AACH;IACE;;;OAGG;IACH,qBAHW,MAAM,sBACN;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAC,EAI5C;CACF;;QAtCa,MAAM;YACN,MAAM;;;kBAEK,MAAM;mBAAa,GAAG;;;yBAhBxB,qBAAqB"}