rampway 0.2.1

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

@@ -0,0 +1,224 @@
+import { shellQuote } from "../transports/ssh-transport.js";
+export class RollbridgeRuntime {
+    /** @type {"rollbridge"} */
+    static type = "rollbridge";
+    /**
+     * @param {Partial<import('#types').RollbridgeRuntimeConfig>} [config]
+     */
+    constructor(config = {}) {
+        /** @type {import('#types').RollbridgeRuntimeConfig} */
+        this.config = {
+            type: "rollbridge",
+            ...config,
+            command: config.command ?? "npx rollbridge",
+            packageDir: config.packageDir ?? "."
+        };
+    }
+    /**
+     * @returns {string[]}
+     */
+    plan() {
+        return [
+            "validate Rollbridge config",
+            "deploy Rollbridge release with --ensure-daemon",
+            "check Rollbridge runtime health"
+        ];
+    }
+    /**
+     * @param {{releasePath: string, releaseId: string, revision: string}} opts
+     * @returns {string}
+     */
+    deployCommand({ releasePath, releaseId, revision }) {
+        const args = [
+            "--ensure-daemon",
+            "--release-path", releasePath,
+            "--release-id", releaseId,
+            "--revision", revision
+        ];
+        if (this.config.daemonLogPath)
+            args.push("--daemon-log-path", this.config.daemonLogPath);
+        if (this.config.daemonPidPath)
+            args.push("--daemon-pid-path", this.config.daemonPidPath);
+        if (this.config.daemonStartTimeoutMs)
+            args.push("--daemon-start-timeout-ms", String(this.config.daemonStartTimeoutMs));
+        return this.rollbridgeCommand("deploy", args);
+    }
+    /**
+     * @returns {string}
+     */
+    validateCommand() {
+        return this.rollbridgeCommand("validate");
+    }
+    /**
+     * @returns {string}
+     */
+    statusCommand() {
+        return this.rollbridgeCommand("status");
+    }
+    /**
+     * @returns {string}
+     */
+    logsCommand() {
+        return this.rollbridgeCommand("logs");
+    }
+    /**
+     * @param {{force?: boolean}} [opts]
+     * @returns {string}
+     */
+    recoverCommand({ force = true } = {}) {
+        const args = [];
+        if (force)
+            args.push("--force");
+        return this.rollbridgeCommand("recover", args);
+    }
+    /**
+     * @returns {string}
+     */
+    shutdownCommand() {
+        return this.rollbridgeCommand("shutdown");
+    }
+    /**
+     * @returns {string}
+     */
+    versionCommand() {
+        return `cd ${shellQuote(this.config.packageDir)} && node -p ${shellQuote("require('./package-lock.json').packages['node_modules/rollbridge']?.version || ''")}`;
+    }
+    /**
+     * @returns {string}
+     */
+    terminateStuckDaemonCommand() {
+        const commands = [];
+        if (this.config.daemonPidPath) {
+            const pidPath = shellQuote(this.config.daemonPidPath);
+            commands.push(`if [ -f ${pidPath} ]; then pid=$(cat ${pidPath}); if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then kill "$pid" 2>/dev/null || true; fi; fi`);
+        }
+        if (this.config.socketPath)
+            commands.push(`rm -f ${shellQuote(this.config.socketPath)}`);
+        return commands.join("; ");
+    }
+    /**
+     * @param {string} subcommand
+     * @param {string[]} [args]
+     * @returns {string}
+     */
+    rollbridgeCommand(subcommand, args = []) {
+        const commandArgs = [subcommand];
+        if (this.config.config)
+            commandArgs.push("--config", this.config.config);
+        commandArgs.push(...args);
+        const quotedArgs = commandArgs.map(arg => shellQuote(String(arg))).join(" ");
+        return `cd ${shellQuote(this.config.packageDir)} && ${this.config.command} ${quotedArgs}`;
+    }
+    /**
+     * @param {import('#types').Transport} transport
+     * @param {{releasePath: string, releaseId: string, revision: string, currentPath?: string}} opts
+     * @returns {Promise<{status: string}>}
+     */
+    async deploy(transport, { releasePath, releaseId, revision, currentPath }) {
+        try {
+            await this.validate(transport, { releasePath });
+        }
+        catch (error) {
+            throw new Error(`Rollbridge validation failed: ${ /** @type {Error} */(error).message}`);
+        }
+        const releaseVersion = await this.prepareVersionChange(transport, { releasePath, currentPath });
+        try {
+            await transport.run(this.deployCommand({ releasePath, releaseId, revision }), { cwd: releasePath });
+        }
+        catch (error) {
+            throw new Error(`Rollbridge deploy failed: ${ /** @type {Error} */(error).message}`);
+        }
+        try {
+            await this.healthCheck(transport, { releasePath });
+            if (releaseVersion && this.config.versionPath)
+                await transport.writeFile(this.config.versionPath, `${releaseVersion}\n`);
+        }
+        catch (error) {
+            throw new Error(`Rollbridge health check failed: ${ /** @type {Error} */(error).message}`);
+        }
+        return { status: "deployed" };
+    }
+    /**
+     * @param {import('#types').Transport} transport
+     * @param {{releasePath: string}} opts
+     * @returns {Promise<import('#types').SpawnResult>}
+     */
+    async healthCheck(transport, { releasePath }) {
+        return await this.status(transport, { releasePath });
+    }
+    /**
+     * @param {import('#types').Transport} transport
+     * @param {{releasePath: string, currentPath?: string}} opts
+     * @returns {Promise<string|undefined>}
+     */
+    async prepareVersionChange(transport, { releasePath, currentPath }) {
+        if (!this.config.versionPath)
+            return undefined;
+        const releaseVersion = (await transport.run(this.versionCommand(), { cwd: releasePath })).output.trim();
+        if (!releaseVersion)
+            return undefined;
+        const deployedVersion = await this.deployedVersion(transport);
+        if (deployedVersion && deployedVersion !== releaseVersion && currentPath)
+            await this.shutdownChangedVersion(transport, { currentPath });
+        return releaseVersion;
+    }
+    /**
+     * @param {import('#types').Transport} transport
+     * @returns {Promise<string|undefined>}
+     */
+    async deployedVersion(transport) {
+        if (!this.config.versionPath || !await transport.exists(this.config.versionPath))
+            return undefined;
+        return (await transport.readFile(this.config.versionPath)).trim() || undefined;
+    }
+    /**
+     * @param {import('#types').Transport} transport
+     * @param {{currentPath: string}} opts
+     * @returns {Promise<void>}
+     */
+    async shutdownChangedVersion(transport, { currentPath }) {
+        try {
+            await this.status(transport, { releasePath: currentPath });
+        }
+        catch {
+            return;
+        }
+        await transport.run(this.shutdownCommand(), { cwd: currentPath });
+        const terminateCommand = this.terminateStuckDaemonCommand();
+        if (terminateCommand)
+            await transport.run(terminateCommand, { cwd: currentPath });
+    }
+    /**
+     * @param {import('#types').Transport} transport
+     * @param {{releasePath: string}} opts
+     * @returns {Promise<import('#types').SpawnResult>}
+     */
+    async validate(transport, { releasePath }) {
+        return await transport.run(this.validateCommand(), { cwd: releasePath });
+    }
+    /**
+     * @param {import('#types').Transport} transport
+     * @param {{releasePath: string}} opts
+     * @returns {Promise<import('#types').SpawnResult>}
+     */
+    async status(transport, { releasePath }) {
+        return await transport.run(this.statusCommand(), { cwd: releasePath });
+    }
+    /**
+     * @param {import('#types').Transport} transport
+     * @param {{releasePath: string}} opts
+     * @returns {Promise<import('#types').SpawnResult>}
+     */
+    async logs(transport, { releasePath }) {
+        return await transport.run(this.logsCommand(), { cwd: releasePath });
+    }
+    /**
+     * @param {import('#types').Transport} transport
+     * @param {{releasePath: string, force?: boolean}} opts
+     * @returns {Promise<import('#types').SpawnResult>}
+     */
+    async recover(transport, { releasePath, force = true }) {
+        return await transport.run(this.recoverCommand({ force }), { cwd: releasePath });
+    }
+}
+//# sourceMappingURL=rollbridge-runtime.js.map

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

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

package/build/src/tasks.d.ts

@@ -0,0 +1,5 @@
+export { checkExpoWebArtifacts } from "./core/expo-web-artifacts.js";
+export { velociousMigrate } from "./core/velocious-migrate.js";
+export { onlyIfChanged } from "./core/path-change-gate.js";
+export { nodePackageInstall, npmInstall, pnpmInstall, yarnInstall, bunInstall } from "./core/node-package-tasks.js";
+//# sourceMappingURL=tasks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tasks.js"],"names":[],"mappings":""}

package/build/src/tasks.js

@@ -0,0 +1,5 @@
+export { nodePackageInstall, npmInstall, pnpmInstall, yarnInstall, bunInstall } from "./core/node-package-tasks.js";
+export { checkExpoWebArtifacts } from "./core/expo-web-artifacts.js";
+export { velociousMigrate } from "./core/velocious-migrate.js";
+export { onlyIfChanged } from "./core/path-change-gate.js";
+//# sourceMappingURL=tasks.js.map

package/build/src/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tasks.js"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAC,MAAM,8BAA8B,CAAA;AACjH,OAAO,EAAC,qBAAqB,EAAC,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAA"}

package/build/src/test-helpers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Run a shell command and return the result.
+ *
+ * @param {string} command
+ * @param {string} cwd
+ * @returns {import("node:child_process").SpawnSyncReturns<string>}
+ */
+export function runShell(command: string, cwd: string): import("node:child_process").SpawnSyncReturns<string>;
+/**
+ * Create a temporary directory that is cleaned up after the test.
+ *
+ * @param {import("node:test").TestContext} t
+ * @param {string} prefix
+ * @returns {string}
+ */
+export function makeTempDir(t: import("node:test").TestContext, prefix: string): string;
+/**
+ * Retrieve and validate a named task group from a stage config.
+ *
+ * @param {import('#types').StageConfig} stageConfig
+ * @param {string} groupName
+ * @returns {import('#types').TaskEntry[]}
+ */
+export function taskEntries(stageConfig: import("#types").StageConfig, groupName: string): import("#types").TaskEntry[];
+//# sourceMappingURL=test-helpers.d.ts.map

package/build/src/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/test-helpers.js"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,kCAJW,MAAM,OACN,MAAM,GACJ,OAAO,oBAAoB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAIjE;AAED;;;;;;GAMG;AACH,+BAJW,OAAO,WAAW,EAAE,WAAW,UAC/B,MAAM,GACJ,MAAM,CAMlB;AAED;;;;;;GAMG;AACH,yCAJW,OAAO,QAAQ,EAAE,WAAW,aAC5B,MAAM,GACJ,OAAO,QAAQ,EAAE,SAAS,EAAE,CAMxC"}

package/build/src/test-helpers.js

@@ -0,0 +1,40 @@
+import assert from "node:assert/strict";
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/**
+ * Run a shell command and return the result.
+ *
+ * @param {string} command
+ * @param {string} cwd
+ * @returns {import("node:child_process").SpawnSyncReturns<string>}
+ */
+export function runShell(command, cwd) {
+    return spawnSync("bash", ["-c", command], { cwd, encoding: "utf8" });
+}
+/**
+ * Create a temporary directory that is cleaned up after the test.
+ *
+ * @param {import("node:test").TestContext} t
+ * @param {string} prefix
+ * @returns {string}
+ */
+export function makeTempDir(t, prefix) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+    t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
+    return dir;
+}
+/**
+ * Retrieve and validate a named task group from a stage config.
+ *
+ * @param {import('#types').StageConfig} stageConfig
+ * @param {string} groupName
+ * @returns {import('#types').TaskEntry[]}
+ */
+export function taskEntries(stageConfig, groupName) {
+    const entries = stageConfig.tasks[groupName];
+    assert.ok(Array.isArray(entries), `expected task group '${groupName}' to be an array`);
+    return entries;
+}
+//# sourceMappingURL=test-helpers.js.map

package/build/src/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../../src/test-helpers.js"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAA;AACvC,OAAO,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAO,EAAE,GAAG;IACnC,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAA;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,CAAC,EAAE,MAAM;IACnC,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC,CAAA;IAC1D,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAC,CAAC,CAAC,CAAA;IAC7D,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,WAAW,EAAE,SAAS;IAChD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,wBAAwB,SAAS,kBAAkB,CAAC,CAAA;IACtF,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/build/src/transports/local-transport.d.ts

@@ -0,0 +1,67 @@
+export class LocalTransport {
+    /**
+     * @param {string} targetPath
+     * @returns {Promise<void>}
+     */
+    mkdirp(targetPath: string): Promise<void>;
+    /**
+     * @param {string} targetPath
+     * @returns {Promise<boolean>}
+     */
+    exists(targetPath: string): Promise<boolean>;
+    /**
+     * @param {string} target
+     * @param {string} linkPath
+     * @param {string} [type]
+     * @returns {Promise<void>}
+     */
+    symlink(target: string, linkPath: string, type?: string): Promise<void>;
+    /**
+     * @param {string} linkPath
+     * @returns {Promise<string>}
+     */
+    readlink(linkPath: string): Promise<string>;
+    /**
+     * @param {string} targetPath
+     * @returns {Promise<void>}
+     */
+    rm(targetPath: string): Promise<void>;
+    /**
+     * @param {string} from
+     * @param {string} to
+     * @returns {Promise<void>}
+     */
+    rename(from: string, to: string): Promise<void>;
+    /**
+     * @param {string} filePath
+     * @param {string} content
+     * @returns {Promise<void>}
+     */
+    writeFile(filePath: string, content: string): Promise<void>;
+    /**
+     * @param {string} filePath
+     * @returns {Promise<string>}
+     */
+    readFile(filePath: string): Promise<string>;
+    /**
+     * @param {string} targetPath
+     * @returns {Promise<string[]>}
+     */
+    list(targetPath: string): Promise<string[]>;
+    /**
+     * @param {string} from
+     * @param {string} to
+     * @returns {Promise<void>}
+     */
+    copyDir(from: string, to: string): Promise<void>;
+    /**
+     * @param {string} command
+     * @param {{cwd?: string, env?: Record<string, string>}} [opts]
+     * @returns {Promise<import('#types').SpawnResult>}
+     */
+    run(command: string, { cwd, env }?: {
+        cwd?: string;
+        env?: Record<string, string>;
+    }): Promise<import("#types").SpawnResult>;
+}
+//# sourceMappingURL=local-transport.d.ts.map

package/build/src/transports/local-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-transport.d.ts","sourceRoot":"","sources":["../../../src/transports/local-transport.js"],"names":[],"mappings":"AAKA;IACE;;;OAGG;IACH,mBAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAIzB;IAED;;;OAGG;IACH,mBAHW,MAAM,GACJ,OAAO,CAAC,OAAO,CAAC,CAW5B;IAED;;;;;OAKG;IACH,gBALW,MAAM,YACN,MAAM,SACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAIzB;IAED;;;OAGG;IACH,mBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAI3B;IAED;;;OAGG;IACH,eAHW,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAIzB;IAED;;;;OAIG;IACH,aAJW,MAAM,MACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAIzB;IAED;;;;OAIG;IACH,oBAJW,MAAM,WACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAKzB;IAED;;;OAGG;IACH,mBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,CAI3B;IAED;;;OAGG;IACH,iBAHW,MAAM,GACJ,OAAO,CAAC,MAAM,EAAE,CAAC,CAU7B;IAED;;;;OAIG;IACH,cAJW,MAAM,MACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAIzB;IAED;;;;OAIG;IACH,aAJW,MAAM,iBACN;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAC,GAC1C,OAAO,CAAC,OAAO,QAAQ,EAAE,WAAW,CAAC,CAejD;CACF"}

package/build/src/transports/local-transport.js

@@ -0,0 +1,121 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { redactText } from "../core/redaction.js";
+export class LocalTransport {
+    /**
+     * @param {string} targetPath
+     * @returns {Promise<void>}
+     */
+    async mkdirp(targetPath) {
+        await fs.mkdir(targetPath, { recursive: true });
+    }
+    /**
+     * @param {string} targetPath
+     * @returns {Promise<boolean>}
+     */
+    async exists(targetPath) {
+        try {
+            await fs.lstat(targetPath);
+            return true;
+        }
+        catch (error) {
+            const err = /** @type {{code?: string}} */ (error);
+            if (err.code === "ENOENT")
+                return false;
+            throw err;
+        }
+    }
+    /**
+     * @param {string} target
+     * @param {string} linkPath
+     * @param {string} [type]
+     * @returns {Promise<void>}
+     */
+    async symlink(target, linkPath, type = undefined) {
+        await fs.symlink(target, linkPath, type);
+    }
+    /**
+     * @param {string} linkPath
+     * @returns {Promise<string>}
+     */
+    async readlink(linkPath) {
+        return await fs.readlink(linkPath);
+    }
+    /**
+     * @param {string} targetPath
+     * @returns {Promise<void>}
+     */
+    async rm(targetPath) {
+        await fs.rm(targetPath, { recursive: true, force: true });
+    }
+    /**
+     * @param {string} from
+     * @param {string} to
+     * @returns {Promise<void>}
+     */
+    async rename(from, to) {
+        await fs.rename(from, to);
+    }
+    /**
+     * @param {string} filePath
+     * @param {string} content
+     * @returns {Promise<void>}
+     */
+    async writeFile(filePath, content) {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, content);
+    }
+    /**
+     * @param {string} filePath
+     * @returns {Promise<string>}
+     */
+    async readFile(filePath) {
+        return await fs.readFile(filePath, "utf8");
+    }
+    /**
+     * @param {string} targetPath
+     * @returns {Promise<string[]>}
+     */
+    async list(targetPath) {
+        try {
+            return await fs.readdir(targetPath);
+        }
+        catch (error) {
+            const err = /** @type {{code?: string}} */ (error);
+            if (err.code === "ENOENT")
+                return [];
+            throw err;
+        }
+    }
+    /**
+     * @param {string} from
+     * @param {string} to
+     * @returns {Promise<void>}
+     */
+    async copyDir(from, to) {
+        await fs.cp(from, to, { recursive: true, force: false, errorOnExist: true });
+    }
+    /**
+     * @param {string} command
+     * @param {{cwd?: string, env?: Record<string, string>}} [opts]
+     * @returns {Promise<import('#types').SpawnResult>}
+     */
+    async run(command, { cwd, env = {} } = {}) {
+        return await new Promise((resolve, reject) => {
+            const child = spawn(command, { cwd, env: { ...process.env, ...env }, shell: true });
+            let output = "";
+            child.stdout.on("data", /** @param {Buffer|string} chunk */ /** @param {Buffer|string} chunk */ chunk => { output += chunk.toString(); process.stdout.write(redactText(chunk.toString())); });
+            child.stderr.on("data", /** @param {Buffer|string} chunk */ /** @param {Buffer|string} chunk */ chunk => { output += chunk.toString(); process.stderr.write(redactText(chunk.toString())); });
+            child.on("error", reject);
+            child.on("close", /** @param {number|null} code */ /** @param {number|null} code */ code => {
+                if (code === 0)
+                    resolve({ code, output: redactText(output) });
+                else
+                    reject(new Error(`Command failed with exit ${code}: ${redactText(command)}
+${redactText(output)}`));
+            });
+        });
+    }
+}
+//# sourceMappingURL=local-transport.js.map

package/build/src/transports/local-transport.js.map

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