rampway 0.2.6 → 0.3.1

package/build/src/velocious/auth.js

@@ -0,0 +1,30 @@
+// @ts-check
+import crypto from "node:crypto";
+/**
+ * Compares two token strings without content-dependent timing once their
+ * byte lengths match.
+ *
+ * @param {string} left - Candidate token.
+ * @param {string} right - Configured token.
+ * @returns {boolean} Whether the values match.
+ */
+export function constantTimeEqual(left, right) {
+    // Compare fixed-length digests so even differently sized candidates reach
+    // timingSafeEqual instead of taking a length-mismatch branch.
+    const leftDigest = crypto.createHash("sha256").update(String(left)).digest();
+    const rightDigest = crypto.createHash("sha256").update(String(right)).digest();
+    return crypto.timingSafeEqual(leftDigest, rightDigest);
+}
+/**
+ * Extracts a bearer token from an Authorization header.
+ *
+ * @param {unknown} authorization - Header value.
+ * @returns {string|null} Token or null.
+ */
+export function bearerToken(authorization) {
+    if (typeof authorization !== "string")
+        return null;
+    const match = authorization.match(/^Bearer\s+([^\s].*)$/i);
+    return match ? match[1].trim() : null;
+}
+//# sourceMappingURL=auth.js.map

package/build/src/velocious/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/velocious/auth.js"],"names":[],"mappings":"AAAA,YAAY;AAEZ,OAAO,MAAM,MAAM,aAAa,CAAA;AAEhC;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAI,EAAE,KAAK;IAC3C,0EAA0E;IAC1E,8DAA8D;IAC9D,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IAC5E,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;IAC9E,OAAO,MAAM,CAAC,eAAe,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;AACxD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,aAAa;IACvC,IAAI,OAAO,aAAa,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAElD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAE1D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AACvC,CAAC"}

package/build/src/velocious/control-plane.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @typedef {object} DeploymentTarget
+ * @property {string} configPath - Backend-held Rampway config path.
+ * @property {string} releaseBranch - Approved release branch.
+ */
+/**
+ * @typedef {object} DeploymentMountOptions
+ * @property {string[]} accessTokens - Accepted tokens.
+ * @property {Record<string, any>} projects - Normalized allowlist.
+ * @property {number} staleRunTimeoutMs - Lease timeout.
+ */
+/**
+ * Looks up only explicit allowlist properties.
+ *
+ * @param {Record<string, any>} projects - Normalized project allowlist.
+ * @param {string} project - Project identifier.
+ * @param {string} stage - Stage identifier.
+ * @returns {DeploymentTarget|undefined} Target configuration.
+ */
+export function lookupTarget(projects: Record<string, any>, project: string, stage: string): DeploymentTarget | undefined;
+/**
+ * Framework-neutral deployment API behavior used by the Velocious controller.
+ *
+ * @template {import('./run-store.js').DeploymentRunStoreContract} TStore
+ */
+export class DeploymentControlPlane<TStore extends import("./run-store.js").DeploymentRunStoreContract> {
+    /**
+     * @param {object} args - Dependencies.
+     * @param {(callback: () => Promise<void>) => Promise<void>} args.detachedExecution - Starts work in a fresh connection context.
+     * @param {(payload: {context: string, error: unknown}) => void} args.emitFrameworkError - Reports internal failures.
+     * @param {import('./executor.js').RampwayDeploymentExecutor} args.executor - Rampway lifecycle executor.
+     * @param {() => number} [args.now] - Clock.
+     * @param {DeploymentMountOptions} args.options - Validated mount options.
+     * @param {TStore} args.store - Durable run store.
+     */
+    constructor({ detachedExecution, emitFrameworkError, executor, now, options, store }: {
+        detachedExecution: (callback: () => Promise<void>) => Promise<void>;
+        emitFrameworkError: (payload: {
+            context: string;
+            error: unknown;
+        }) => void;
+        executor: import("./executor.js").RampwayDeploymentExecutor;
+        now?: (() => number) | undefined;
+        options: DeploymentMountOptions;
+        store: TStore;
+    });
+    detachedExecution: (callback: () => Promise<void>) => Promise<void>;
+    emitFrameworkError: (payload: {
+        context: string;
+        error: unknown;
+    }) => void;
+    executor: import("./executor.js").RampwayDeploymentExecutor;
+    now: () => number;
+    options: DeploymentMountOptions;
+    store: TStore;
+    /**
+     * @param {unknown} authorization - Authorization header.
+     * @returns {boolean} Whether request is authorized.
+     */
+    _authorized(authorization: unknown): boolean;
+    /**
+     * @param {string} candidate - Value to compare with configured access tokens.
+     * @returns {boolean} Whether the value is an accepted access token.
+     */
+    _matchesAccessToken(candidate: string): boolean;
+    /**
+     * @param {string} candidate - Idempotency key candidate.
+     * @returns {boolean} Whether the key contains a configured access token.
+     */
+    _containsAccessToken(candidate: string): boolean;
+    /**
+     * Creates a deployment run.
+     *
+     * @param {{authorization: unknown, input: unknown}} args - Request data.
+     * @returns {Promise<{body: Record<string, any>, status: number}>} HTTP response.
+     */
+    create({ authorization, input }: {
+        authorization: unknown;
+        input: unknown;
+    }): Promise<{
+        body: Record<string, any>;
+        status: number;
+    }>;
+    /**
+     * @param {{authorization: unknown, id: string}} args - Request data.
+     * @returns {Promise<{body: Record<string, any>, status: number}>} HTTP response.
+     */
+    show({ authorization, id }: {
+        authorization: unknown;
+        id: string;
+    }): Promise<{
+        body: Record<string, any>;
+        status: number;
+    }>;
+    /**
+     * @param {{existing: import('./run-store.js').DeploymentRunRow, project: string, revision: string, stage: string}} args - Replay data.
+     * @returns {{body: Record<string, any>, status: number}} Response.
+     */
+    _existingResponse({ existing, project, revision, stage }: {
+        existing: import("./run-store.js").DeploymentRunRow;
+        project: string;
+        revision: string;
+        stage: string;
+    }): {
+        body: Record<string, any>;
+        status: number;
+    };
+    /**
+     * @param {{run: import('./run-store.js').DeploymentRunRow, target: DeploymentTarget}} args - Execution data.
+     * @returns {Promise<void>} Resolves after durable outcome.
+     */
+    _executeRun({ run, target }: {
+        run: import("./run-store.js").DeploymentRunRow;
+        target: DeploymentTarget;
+    }): Promise<void>;
+    /**
+     * @param {{event: string, payload: Record<string, unknown>, runId: string|null}} args - Event.
+     * @returns {Promise<void>} Resolves after persistence or reporting.
+     */
+    _audit({ event, payload, runId }: {
+        event: string;
+        payload: Record<string, unknown>;
+        runId: string | null;
+    }): Promise<void>;
+    /**
+     * @param {import('./run-store.js').DeploymentRunRow} run - Run.
+     * @returns {Record<string, any>} Public representation.
+     */
+    _serializeRun(run: import("./run-store.js").DeploymentRunRow): Record<string, any>;
+}
+export type DeploymentTarget = {
+    /**
+     * - Backend-held Rampway config path.
+     */
+    configPath: string;
+    /**
+     * - Approved release branch.
+     */
+    releaseBranch: string;
+};
+export type DeploymentMountOptions = {
+    /**
+     * - Accepted tokens.
+     */
+    accessTokens: string[];
+    /**
+     * - Normalized allowlist.
+     */
+    projects: Record<string, any>;
+    /**
+     * - Lease timeout.
+     */
+    staleRunTimeoutMs: number;
+};
+//# sourceMappingURL=control-plane.d.ts.map

package/build/src/velocious/control-plane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-plane.d.ts","sourceRoot":"","sources":["../../../src/velocious/control-plane.js"],"names":[],"mappings":"AASA;;;;GAIG;AAEH;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,uCALW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,WACnB,MAAM,SACN,MAAM,GACJ,gBAAgB,GAAC,SAAS,CAOtC;AAED;;;;GAIG;AACH,oCAFmE,MAAM,SAA5D,OAAQ,gBAAgB,EAAE,0BAA2B;IAGhE;;;;;;;;OAQG;IACH,sFAPG;QAA+D,iBAAiB,EAAxE,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC;QACW,kBAAkB,EAA7E,CAAC,OAAO,EAAE;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,CAAA;SAAC,KAAK,IAAI;QACI,QAAQ,EAAhE,OAAO,eAAe,EAAE,yBAAyB;QAC7B,GAAG,UAAjB,MAAM;QACiB,OAAO,EAApC,sBAAsB;QACT,KAAK,EAAlB,MAAM;KAChB,EAQA;IANC,8BARoB,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAQf;IAC1C,8BARmB;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,KAAK,IAAI,CAQjB;IAC5C,4DAAwB;IACxB,WARe,MAAM,CAQP;IACd,gCAAsB;IACtB,cAAkB;IAGpB;;;OAGG;IACH,2BAHW,OAAO,GACL,OAAO,CAKnB;IAED;;;OAGG;IACH,+BAHW,MAAM,GACJ,OAAO,CASnB;IAED;;;OAGG;IACH,gCAHW,MAAM,GACJ,OAAO,CAQnB;IAED;;;;;OAKG;IACH,iCAHW;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,GACtC,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAiDhE;IAED;;;OAGG;IACH,4BAHW;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAC,GAClC,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC,CAyBhE;IAED;;;OAGG;IACH,0DAHW;QAAC,QAAQ,EAAE,OAAO,gBAAgB,EAAE,gBAAgB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,GACrG;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAOvD;IAED;;;OAGG;IACH,6BAHW;QAAC,GAAG,EAAE,OAAO,gBAAgB,EAAE,gBAAgB,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAC,GACxE,OAAO,CAAC,IAAI,CAAC,CAsDzB;IAED;;;OAGG;IACH,kCAHW;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,GAAC,IAAI,CAAA;KAAC,GACnE,OAAO,CAAC,IAAI,CAAC,CAQzB;IAED;;;OAGG;IACH,mBAHW,OAAO,gBAAgB,EAAE,gBAAgB,GACvC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgB/B;CACF;;;;;gBA5Qa,MAAM;;;;mBACN,MAAM;;;;;;kBAKN,MAAM,EAAE;;;;cACR,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;uBACnB,MAAM"}

package/build/src/velocious/control-plane.js

@@ -0,0 +1,275 @@
+// @ts-check
+import { bearerToken, constantTimeEqual } from "./auth.js";
+import { heartbeatIntervalMs, registerActiveDeploymentRun, unregisterActiveDeploymentRun } from "./run-store.js";
+import { sanitizeAdapterValue, sanitizeErrorPayload } from "./sanitize.js";
+const REVISION_PATTERN = /^[0-9a-f]{40}$/;
+const MAX_IDEMPOTENCY_KEY_LENGTH = 255;
+/**
+ * @typedef {object} DeploymentTarget
+ * @property {string} configPath - Backend-held Rampway config path.
+ * @property {string} releaseBranch - Approved release branch.
+ */
+/**
+ * @typedef {object} DeploymentMountOptions
+ * @property {string[]} accessTokens - Accepted tokens.
+ * @property {Record<string, any>} projects - Normalized allowlist.
+ * @property {number} staleRunTimeoutMs - Lease timeout.
+ */
+/**
+ * Looks up only explicit allowlist properties.
+ *
+ * @param {Record<string, any>} projects - Normalized project allowlist.
+ * @param {string} project - Project identifier.
+ * @param {string} stage - Stage identifier.
+ * @returns {DeploymentTarget|undefined} Target configuration.
+ */
+export function lookupTarget(projects, project, stage) {
+    if (!Object.hasOwn(projects, project))
+        return undefined;
+    const stages = projects[project].stages;
+    if (!Object.hasOwn(stages, stage))
+        return undefined;
+    return stages[stage];
+}
+/**
+ * Framework-neutral deployment API behavior used by the Velocious controller.
+ *
+ * @template {import('./run-store.js').DeploymentRunStoreContract} TStore
+ */
+export class DeploymentControlPlane {
+    /**
+     * @param {object} args - Dependencies.
+     * @param {(callback: () => Promise<void>) => Promise<void>} args.detachedExecution - Starts work in a fresh connection context.
+     * @param {(payload: {context: string, error: unknown}) => void} args.emitFrameworkError - Reports internal failures.
+     * @param {import('./executor.js').RampwayDeploymentExecutor} args.executor - Rampway lifecycle executor.
+     * @param {() => number} [args.now] - Clock.
+     * @param {DeploymentMountOptions} args.options - Validated mount options.
+     * @param {TStore} args.store - Durable run store.
+     */
+    constructor({ detachedExecution, emitFrameworkError, executor, now = Date.now, options, store }) {
+        this.detachedExecution = detachedExecution;
+        this.emitFrameworkError = emitFrameworkError;
+        this.executor = executor;
+        this.now = now;
+        this.options = options;
+        this.store = store;
+    }
+    /**
+     * @param {unknown} authorization - Authorization header.
+     * @returns {boolean} Whether request is authorized.
+     */
+    _authorized(authorization) {
+        const token = bearerToken(authorization);
+        return token ? this._matchesAccessToken(token) : false;
+    }
+    /**
+     * @param {string} candidate - Value to compare with configured access tokens.
+     * @returns {boolean} Whether the value is an accepted access token.
+     */
+    _matchesAccessToken(candidate) {
+        let matches = false;
+        for (const accessToken of this.options.accessTokens) {
+            // Do every configured comparison instead of exposing which rotation token matched.
+            matches = constantTimeEqual(candidate, accessToken) || matches;
+        }
+        return matches;
+    }
+    /**
+     * @param {string} candidate - Idempotency key candidate.
+     * @returns {boolean} Whether the key contains a configured access token.
+     */
+    _containsAccessToken(candidate) {
+        let contains = false;
+        for (const accessToken of this.options.accessTokens) {
+            contains = candidate.includes(accessToken) || contains;
+        }
+        return contains;
+    }
+    /**
+     * Creates a deployment run.
+     *
+     * @param {{authorization: unknown, input: unknown}} args - Request data.
+     * @returns {Promise<{body: Record<string, any>, status: number}>} HTTP response.
+     */
+    async create({ authorization, input }) {
+        if (!this._authorized(authorization))
+            return { body: { error: "unauthorized" }, status: 401 };
+        const params = input && typeof input === "object" ? /** @type {Record<string, unknown>} */ (input) : {};
+        const revision = typeof params.revision === "string" ? params.revision : null;
+        const idempotencyKey = typeof params.idempotencyKey === "string" ? params.idempotencyKey : null;
+        const invalidFields = [];
+        if (!revision || !REVISION_PATTERN.test(revision))
+            invalidFields.push("revision");
+        if (!idempotencyKey || idempotencyKey.length > MAX_IDEMPOTENCY_KEY_LENGTH || this._containsAccessToken(idempotencyKey)) {
+            invalidFields.push("idempotencyKey");
+        }
+        if (invalidFields.length > 0)
+            return { body: { error: "invalid_params", fields: invalidFields }, status: 422 };
+        const validRevision = /** @type {string} */ (revision);
+        const validIdempotencyKey = /** @type {string} */ (idempotencyKey);
+        const project = typeof params.project === "string" ? params.project : "";
+        const stage = typeof params.stage === "string" ? params.stage : "";
+        const target = lookupTarget(this.options.projects, project, stage);
+        if (!target)
+            return { body: { error: "not_found" }, status: 404 };
+        const outcome = await this.store.createRunIfPossible({ idempotencyKey: validIdempotencyKey, project, revision: validRevision, stage });
+        if (outcome.outcome === "replay" || outcome.outcome === "conflict") {
+            if (!outcome.run)
+                throw new Error(`Run store returned ${outcome.outcome} without a run`);
+            return this._existingResponse({ existing: outcome.run, project, revision: validRevision, stage });
+        }
+        if (outcome.outcome === "in_progress") {
+            return { body: { error: "deployment_in_progress", runId: outcome.run?.id }, status: 409 };
+        }
+        if (outcome.outcome === "reconciliation_required") {
+            if (!outcome.run)
+                throw new Error("Run store returned reconciliation_required without a run");
+            return { body: { error: "deployment_reconciliation_required", runId: outcome.run.id }, status: 409 };
+        }
+        if (!outcome.run)
+            throw new Error("Run store returned created without a run");
+        const run = outcome.run;
+        await this._audit({ event: "run_requested", payload: { project, revision: validRevision, stage }, runId: run.id });
+        await this.detachedExecution(async () => {
+            try {
+                await this._executeRun({ run, target });
+            }
+            catch (error) {
+                this.emitFrameworkError({ context: "rampway-deployment-api-execute-run", error });
+            }
+        });
+        return { body: { run: this._serializeRun(run) }, status: 202 };
+    }
+    /**
+     * @param {{authorization: unknown, id: string}} args - Request data.
+     * @returns {Promise<{body: Record<string, any>, status: number}>} HTTP response.
+     */
+    async show({ authorization, id }) {
+        if (!this._authorized(authorization))
+            return { body: { error: "unauthorized" }, status: 401 };
+        const run = await this.store.findRunById(id);
+        if (!run)
+            return { body: { error: "not_found" }, status: 404 };
+        const target = lookupTarget(this.options.projects, run.project, run.stage);
+        if (!target)
+            return { body: { error: "not_found" }, status: 404 };
+        /** @type {Record<string, any>} */
+        const body = { run: this._serializeRun(run) };
+        if (this.executor.readStatus) {
+            try {
+                const current = await this.executor.readStatus({ project: run.project, stage: run.stage, target });
+                body.current = sanitizeAdapterValue(current, this.options.accessTokens) ?? null;
+            }
+            catch (error) {
+                const liveStatusError = sanitizeErrorPayload(error, this.options.accessTokens);
+                body.live_status = null;
+                body.live_status_error = liveStatusError;
+                this.emitFrameworkError({ context: "rampway-deployment-api-live-status", error: liveStatusError });
+            }
+        }
+        return { body, status: 200 };
+    }
+    /**
+     * @param {{existing: import('./run-store.js').DeploymentRunRow, project: string, revision: string, stage: string}} args - Replay data.
+     * @returns {{body: Record<string, any>, status: number}} Response.
+     */
+    _existingResponse({ existing, project, revision, stage }) {
+        const same = existing.project === project && existing.stage === stage && existing.revision === revision;
+        return same
+            ? { body: { replayed: true, run: this._serializeRun(existing) }, status: 200 }
+            : { body: { error: "idempotency_conflict", runId: existing.id }, status: 409 };
+    }
+    /**
+     * @param {{run: import('./run-store.js').DeploymentRunRow, target: DeploymentTarget}} args - Execution data.
+     * @returns {Promise<void>} Resolves after durable outcome.
+     */
+    async _executeRun({ run, target }) {
+        if (!run.ownerToken)
+            throw new Error(`Deployment run ${run.id} has no owner token`);
+        const ownerToken = run.ownerToken;
+        registerActiveDeploymentRun(run.id);
+        /** @type {ReturnType<typeof setInterval>|null} */
+        let heartbeat = null;
+        try {
+            await this.store.markRunning({ id: run.id, startedAtMs: this.now() });
+            heartbeat = setInterval(() => {
+                this.store.heartbeat({ heartbeatAtMs: this.now(), id: run.id }).catch(error => {
+                    this.emitFrameworkError({ context: "rampway-deployment-api-heartbeat", error });
+                });
+            }, heartbeatIntervalMs(this.options.staleRunTimeoutMs));
+            heartbeat.unref();
+            await this._audit({ event: "run_started", payload: { project: run.project, revision: run.revision, stage: run.stage }, runId: run.id });
+            let report;
+            try {
+                const reachable = await this.executor.validateRevision({ project: run.project, revision: run.revision, stage: run.stage, target });
+                if (!reachable)
+                    throw new Error(`Revision ${run.revision} is not reachable from approved release branch ${target.releaseBranch}`);
+                report = await this.executor.deploy({ project: run.project, revision: run.revision, runId: run.id, stage: run.stage, target });
+            }
+            catch (error) {
+                const safeError = sanitizeErrorPayload(error, this.options.accessTokens);
+                try {
+                    await this.store.markFailed({ error: safeError, finishedAtMs: this.now(), id: run.id, ownerToken });
+                    await this._audit({ event: "run_failed", payload: { message: safeError.message, project: run.project, revision: run.revision, stage: run.stage }, runId: run.id });
+                }
+                catch (storeError) {
+                    this.emitFrameworkError({ context: "rampway-deployment-api-record-failure", error: storeError });
+                }
+                return;
+            }
+            try {
+                const result = sanitizeAdapterValue(report ?? {}, this.options.accessTokens) ?? {};
+                await this.store.markSucceeded({ finishedAtMs: this.now(), id: run.id, ownerToken, result });
+                await this._audit({ event: "run_succeeded", payload: { project: run.project, revision: run.revision, stage: run.stage }, runId: run.id });
+            }
+            catch (error) {
+                this.emitFrameworkError({ context: "rampway-deployment-api-record-success", error });
+                const reconciliationError = { message: "Deployment activation succeeded, but its result could not be persisted; operator reconciliation is required" };
+                try {
+                    await this.store.markReconciliationRequired({ error: reconciliationError, finishedAtMs: this.now(), id: run.id, ownerToken });
+                    await this._audit({ event: "run_reconciliation_required", payload: { ...reconciliationError, project: run.project, revision: run.revision, stage: run.stage }, runId: run.id });
+                }
+                catch (persistenceError) {
+                    this.emitFrameworkError({ context: "rampway-deployment-api-record-reconciliation-required", error: persistenceError });
+                }
+            }
+        }
+        finally {
+            if (heartbeat)
+                clearInterval(heartbeat);
+            unregisterActiveDeploymentRun(run.id);
+        }
+    }
+    /**
+     * @param {{event: string, payload: Record<string, unknown>, runId: string|null}} args - Event.
+     * @returns {Promise<void>} Resolves after persistence or reporting.
+     */
+    async _audit({ event, payload, runId }) {
+        try {
+            await this.store.addAuditEvent({ event, payload: sanitizeAdapterValue(payload, this.options.accessTokens) ?? {}, runId });
+        }
+        catch (error) {
+            this.emitFrameworkError({ context: "rampway-deployment-api-audit", error });
+        }
+    }
+    /**
+     * @param {import('./run-store.js').DeploymentRunRow} run - Run.
+     * @returns {Record<string, any>} Public representation.
+     */
+    _serializeRun(run) {
+        return {
+            error: run.error,
+            finishedAtMs: run.finishedAtMs,
+            id: run.id,
+            idempotencyKey: run.idempotencyKey,
+            project: run.project,
+            requestedAtMs: run.requestedAtMs,
+            result: run.result,
+            revision: run.revision,
+            stage: run.stage,
+            startedAtMs: run.startedAtMs,
+            status: run.status
+        };
+    }
+}
+//# sourceMappingURL=control-plane.js.map

package/build/src/velocious/control-plane.js.map

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

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

@@ -0,0 +1,39 @@
+/**
+ * Creates a scheduler that breaks away from the closing request scope and
+ * establishes a new Velocious connection context for background execution.
+ *
+ * @param {object} args - Scheduler dependencies.
+ * @param {any} args.configuration - Velocious configuration.
+ * @param {(payload: {context: string, error: unknown}) => void} args.emitFrameworkError - Failure reporter.
+ * @returns {(callback: () => Promise<void>) => Promise<void>} Detached scheduler.
+ */
+export function createDetachedExecution({ configuration, emitFrameworkError }: {
+    configuration: any;
+    emitFrameworkError: (payload: {
+        context: string;
+        error: unknown;
+    }) => void;
+}): (callback: () => Promise<void>) => Promise<void>;
+/** Velocious HTTP adapter for Rampway's deployment control plane. */
+export default class RampwayDeploymentApiController extends Controller {
+    /** @returns {Record<string, any>} Mount options. */
+    _mountOptions(): Record<string, any>;
+    /** @returns {DeploymentRunStore} Store. */
+    _store(): DeploymentRunStore;
+    deploymentRunStore: DeploymentRunStore | undefined;
+    /** @returns {DeploymentControlPlane<DeploymentRunStore>} Control plane. */
+    _controlPlane(): DeploymentControlPlane<DeploymentRunStore>;
+    /** @param {{context: string, error: unknown}} args - Failure. @returns {void} */
+    _emitFrameworkError({ context, error }: {
+        context: string;
+        error: unknown;
+    }): void;
+    /** @returns {Promise<void>} */
+    create(): Promise<void>;
+    /** @returns {Promise<void>} */
+    show(): Promise<void>;
+}
+import Controller from "velocious/build/src/controller.js";
+import DeploymentRunStore from "./run-store.js";
+import { DeploymentControlPlane } from "./control-plane.js";
+//# sourceMappingURL=controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/velocious/controller.js"],"names":[],"mappings":"AAQA;;;;;;;;GAQG;AACH,+EAJG;IAAkB,aAAa,EAAvB,GAAG;IACwD,kBAAkB,EAA7E,CAAC,OAAO,EAAE;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,KAAK,IAAI;CAC5D,GAAU,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAU5D;AAED,qEAAqE;AACrE;IACE,oDAAoD;IACpD,iBADc,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAMhC;IAED,2CAA2C;IAC3C,UADc,kBAAkB,CAY/B;IARG,mDAKE;IAKN,2EAA2E;IAC3E,iBADc,sBAAsB,CAAC,kBAAkB,CAAC,CAYvD;IAED,iFAAiF;IACjF,wCADY;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,GAA4B,IAAI,CAQ5E;IAED,+BAA+B;IAC/B,UADc,OAAO,CAAC,IAAI,CAAC,CAO1B;IAED,+BAA+B;IAC/B,QADc,OAAO,CAAC,IAAI,CAAC,CAO1B;CACF;uBA1FsB,mCAAmC;+BAG3B,gBAAgB;uCADV,oBAAoB"}

package/build/src/velocious/controller.js

@@ -0,0 +1,86 @@
+// @ts-check
+import Controller from "velocious/build/src/controller.js";
+import { DeploymentControlPlane } from "./control-plane.js";
+import DeploymentRunStore from "./run-store.js";
+import { getDeploymentMount } from "./registry.js";
+/**
+ * Creates a scheduler that breaks away from the closing request scope and
+ * establishes a new Velocious connection context for background execution.
+ *
+ * @param {object} args - Scheduler dependencies.
+ * @param {any} args.configuration - Velocious configuration.
+ * @param {(payload: {context: string, error: unknown}) => void} args.emitFrameworkError - Failure reporter.
+ * @returns {(callback: () => Promise<void>) => Promise<void>} Detached scheduler.
+ */
+export function createDetachedExecution({ configuration, emitFrameworkError }) {
+    return async (callback) => {
+        globalThis.setImmediate(() => {
+            configuration.withConnections({
+                name: "Rampway detached deployment"
+            }, callback).catch((/** @type {unknown} */ error) => emitFrameworkError({ context: "rampway-deployment-api-detached-context", error }));
+        });
+    };
+}
+/** Velocious HTTP adapter for Rampway's deployment control plane. */
+export default class RampwayDeploymentApiController extends Controller {
+    /** @returns {Record<string, any>} Mount options. */
+    _mountOptions() {
+        const at = /** @type {string} */ (this.params().rampwayDeploymentMountAt);
+        const options = getDeploymentMount(this.getConfiguration(), at);
+        if (!options)
+            throw new Error(`No Rampway deployment API mount registered at ${at}`);
+        return options;
+    }
+    /** @returns {DeploymentRunStore} Store. */
+    _store() {
+        if (!this.deploymentRunStore) {
+            const options = this._mountOptions();
+            this.deploymentRunStore = new DeploymentRunStore({
+                configuration: this.getConfiguration(),
+                databaseIdentifier: options.databaseIdentifier,
+                mountIdentifier: options.mountIdentifier,
+                staleRunTimeoutMs: options.staleRunTimeoutMs
+            });
+        }
+        return this.deploymentRunStore;
+    }
+    /** @returns {DeploymentControlPlane<DeploymentRunStore>} Control plane. */
+    _controlPlane() {
+        const options = /** @type {import('./control-plane.js').DeploymentMountOptions & {databaseIdentifier: string, executor: import('./executor.js').RampwayDeploymentExecutor}} */ (this._mountOptions());
+        const configuration = this.getConfiguration();
+        const emitFrameworkError = (/** @type {{context: string, error: unknown}} */ { context, error }) => this._emitFrameworkError({ context, error });
+        return new DeploymentControlPlane({
+            detachedExecution: createDetachedExecution({ configuration, emitFrameworkError }),
+            emitFrameworkError,
+            executor: options.executor,
+            options,
+            store: this._store()
+        });
+    }
+    /** @param {{context: string, error: unknown}} args - Failure. @returns {void} */
+    _emitFrameworkError({ context, error }) {
+        const events = this.getConfiguration().getErrorEvents();
+        // Never attach the request: it retains the bearer header and would make
+        // unsafe framework reporters capable of serializing the credential.
+        const payload = { context, error };
+        events.emit("framework-error", payload);
+        events.emit("all-error", { ...payload, errorType: "framework-error" });
+    }
+    /** @returns {Promise<void>} */
+    async create() {
+        const response = await this._controlPlane().create({
+            authorization: this.request().header("authorization"),
+            input: this.params()
+        });
+        await this.render({ json: response.body, status: response.status });
+    }
+    /** @returns {Promise<void>} */
+    async show() {
+        const response = await this._controlPlane().show({
+            authorization: this.request().header("authorization"),
+            id: /** @type {string} */ (this.params().id)
+        });
+        await this.render({ json: response.body, status: response.status });
+    }
+}
+//# sourceMappingURL=controller.js.map

package/build/src/velocious/controller.js.map

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