@ethlete/cli 3.0.0-next.17 → 3.0.0-next.18

package/src/lib/api/load-definitions.js

@@ -5,6 +5,7 @@ const fs_1 = require("fs");
 const module_1 = require("module");
 const path_1 = require("path");
 const definition_1 = require("./definition");
+const validate_definition_1 = require("./validate-definition");
 exports.API_DEFINITIONS_FILE_NAMES = ['ethlete.apis.js', 'ethlete.apis.cjs'];
 /**
  * Loads the repo's API definitions from `ethlete.apis.js`. The file is a module rather than JSON
@@ -25,6 +26,8 @@ const loadApiDefinitions = (root) => {
                 `which ${shadowing.length === 1 ? 'is a built-in command' : 'are built-in commands'}. Rename the entry.`);
         }
     }
+    for (const [name, api] of Object.entries(apis))
+        (0, validate_definition_1.validateApiDefinition)({ fileName, name, api });
     return { found: true, apis, fileName };
 };
 exports.loadApiDefinitions = loadApiDefinitions;

package/src/lib/api/load-definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-definitions.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/load-definitions.ts"],"names":[],"mappings":";;;AAAA,2BAAgC;AAChC,mCAAuC;AACvC,+BAA4B;AAC5B,6CAAqE;AAExD,QAAA,0BAA0B,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;AAKlF;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAA4B,EAAE;;IAC3E,MAAM,QAAQ,GAAG,kCAA0B,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAEnG,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAY,IAAA,sBAAa,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,IAAA,WAAI,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,MAAC,MAAuC,CAAC,OAAO,mCAAK,MAAyB,CAAC;IAC5F,MAAM,QAAQ,GAAa,CAAC,GAAG,kCAAqB,EAAE,MAAM,CAAC,CAAC;IAE9D,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,IAAI,mCAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAE/F,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,KAAK,IAAI,kBAAkB,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAC7F,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,uBAAuB,qBAAqB,CAC3G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC,CAAC;AArBW,QAAA,kBAAkB,sBAqB7B"}
+{"version":3,"file":"load-definitions.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/load-definitions.ts"],"names":[],"mappings":";;;AAAA,2BAAgC;AAChC,mCAAuC;AACvC,+BAA4B;AAC5B,6CAAqE;AACrE,+DAA8D;AAEjD,QAAA,0BAA0B,GAAG,CAAC,iBAAiB,EAAE,kBAAkB,CAAC,CAAC;AAKlF;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAA4B,EAAE;;IAC3E,MAAM,QAAQ,GAAG,kCAA0B,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAEnG,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAY,IAAA,sBAAa,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,IAAA,WAAI,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,MAAC,MAAuC,CAAC,OAAO,mCAAK,MAAyB,CAAC;IAC5F,MAAM,QAAQ,GAAa,CAAC,GAAG,kCAAqB,EAAE,MAAM,CAAC,CAAC;IAE9D,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,IAAI,mCAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAE/F,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,KAAK,IAAI,kBAAkB,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAC7F,SAAS,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,uBAAuB,qBAAqB,CAC3G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,IAAA,2CAAqB,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAE/F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC,CAAC;AAvBW,QAAA,kBAAkB,sBAuB7B"}

package/src/lib/api/lock.d.ts

@@ -0,0 +1,46 @@
+/** Who holds an API's lock. `token` is handed to the holder's command as `ETHLETE_API_LOCK`. */
+export type ApiLock = {
+    pid: number;
+    hostname: string;
+    command: string;
+    cwd: string;
+    startedAt: string;
+    token: string;
+};
+export declare const API_LOCK_ENV = "ETHLETE_API_LOCK";
+export type LockSystem = {
+    now: () => number;
+    sleep: (ms: number) => Promise<void>;
+    kill: (pid: number, signal: 0) => void;
+    hostname: () => string;
+    pid: number;
+};
+export declare const lockPath: (directory: string) => string;
+/** The current lock, or `undefined` when there is none or it cannot be read. */
+export declare const readApiLock: (directory: string, path?: string) => ApiLock | undefined;
+/** One line naming the holder, for the wait and timeout messages. */
+export declare const describeApiLock: (lock: ApiLock | undefined, directory: string) => string;
+export type AcquireApiLockResult = {
+    ok: true;
+    lock: ApiLock;
+} | {
+    ok: false;
+    holder: ApiLock | undefined;
+};
+/**
+ * Takes the lock in `directory`. A lock whose pid is dead on this host is taken over, and the state
+ * becomes dirty. Otherwise it polls every second for up to `wait` seconds, or without end when `wait`
+ * is `undefined`, and calls `onHeld` once with the holder.
+ */
+export declare const acquireApiLock: (options: {
+    directory: string;
+    command: string;
+    cwd: string;
+    wait?: number;
+    onHeld?: (holder: ApiLock | undefined) => void;
+    system?: LockSystem;
+}) => Promise<AcquireApiLockResult>;
+/** Removes the lock only while it is still the one `token` names. */
+export declare const releaseApiLock: (directory: string, token: string) => boolean;
+/** The current lock when `ETHLETE_API_LOCK` names it, so a command run under the lock does not wait for it. */
+export declare const heldLockFromEnv: (directory: string, env?: NodeJS.ProcessEnv) => ApiLock | undefined;

package/src/lib/api/lock.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.heldLockFromEnv = exports.releaseApiLock = exports.acquireApiLock = exports.describeApiLock = exports.readApiLock = exports.lockPath = exports.API_LOCK_ENV = void 0;
+const tslib_1 = require("tslib");
+const crypto_1 = require("crypto");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const promises_1 = require("timers/promises");
+const api_state_1 = require("./api-state");
+exports.API_LOCK_ENV = 'ETHLETE_API_LOCK';
+const realSystem = () => ({
+    now: () => Date.now(),
+    sleep: (ms) => tslib_1.__awaiter(void 0, void 0, void 0, function* () { return void (yield (0, promises_1.setTimeout)(ms)); }),
+    kill: (pid, signal) => void process.kill(pid, signal),
+    hostname: os_1.hostname,
+    pid: process.pid,
+});
+const POLL_MS = 1000;
+const lockPath = (directory) => (0, path_1.join)(directory, 'lock.json');
+exports.lockPath = lockPath;
+/** The current lock, or `undefined` when there is none or it cannot be read. */
+const readApiLock = (directory, path = (0, exports.lockPath)(directory)) => {
+    try {
+        const value = JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+        return typeof value.token === 'string' && typeof value.pid === 'number' ? value : undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+exports.readApiLock = readApiLock;
+/** One line naming the holder, for the wait and timeout messages. */
+const describeApiLock = (lock, directory) => lock
+    ? `pid ${lock.pid} on ${lock.hostname} since ${lock.startedAt}: ${lock.command} (in ${lock.cwd})`
+    : `an unreadable ${(0, exports.lockPath)(directory)}`;
+exports.describeApiLock = describeApiLock;
+const isAlive = (system, pid) => {
+    try {
+        system.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code !== 'ESRCH';
+    }
+};
+const isStale = (system, lock) => lock.hostname === system.hostname() && !isAlive(system, lock.pid);
+const tryCreate = (directory, lock) => {
+    try {
+        (0, fs_1.writeFileSync)((0, exports.lockPath)(directory), `${JSON.stringify(lock, null, 2)}\n`, { encoding: 'utf8', flag: 'wx' });
+        return true;
+    }
+    catch (error) {
+        if (error.code === 'EEXIST')
+            return false;
+        throw error;
+    }
+};
+/**
+ * Renames the stale lock away, so of several waiters only the one whose rename succeeds removes it.
+ * A rename that took a live lock a faster waiter had just created is linked back.
+ */
+const claimStaleLock = (options) => {
+    var _a;
+    const { directory, stale, system } = options;
+    const claimed = `${(0, exports.lockPath)(directory)}.stale-${system.pid}-${(0, crypto_1.randomUUID)()}`;
+    try {
+        (0, fs_1.renameSync)((0, exports.lockPath)(directory), claimed);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+    try {
+        if (((_a = (0, exports.readApiLock)(directory, claimed)) === null || _a === void 0 ? void 0 : _a.token) === stale.token) {
+            (0, api_state_1.markApiStateDirty)(directory, new Date(system.now()));
+            return;
+        }
+        try {
+            (0, fs_1.linkSync)(claimed, (0, exports.lockPath)(directory));
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST')
+                throw error;
+        }
+    }
+    finally {
+        (0, fs_1.rmSync)(claimed, { force: true });
+    }
+};
+/**
+ * Takes the lock in `directory`. A lock whose pid is dead on this host is taken over, and the state
+ * becomes dirty. Otherwise it polls every second for up to `wait` seconds, or without end when `wait`
+ * is `undefined`, and calls `onHeld` once with the holder.
+ */
+const acquireApiLock = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { directory, command, cwd, wait, onHeld, system = realSystem() } = options;
+    const startedAt = system.now();
+    let announced = false;
+    (0, fs_1.mkdirSync)(directory, { recursive: true });
+    for (;;) {
+        const lock = {
+            pid: system.pid,
+            hostname: system.hostname(),
+            command,
+            cwd,
+            startedAt: new Date(system.now()).toISOString(),
+            token: (0, crypto_1.randomUUID)(),
+        };
+        if (tryCreate(directory, lock))
+            return { ok: true, lock };
+        const holder = (0, exports.readApiLock)(directory);
+        if (holder && isStale(system, holder)) {
+            claimStaleLock({ directory, stale: holder, system });
+            continue;
+        }
+        if (!announced) {
+            announced = true;
+            onHeld === null || onHeld === void 0 ? void 0 : onHeld(holder);
+        }
+        if (wait !== undefined && system.now() - startedAt >= wait * 1000)
+            return { ok: false, holder };
+        yield system.sleep(POLL_MS);
+    }
+});
+exports.acquireApiLock = acquireApiLock;
+/** Removes the lock only while it is still the one `token` names. */
+const releaseApiLock = (directory, token) => {
+    var _a;
+    if (((_a = (0, exports.readApiLock)(directory)) === null || _a === void 0 ? void 0 : _a.token) !== token)
+        return false;
+    (0, fs_1.rmSync)((0, exports.lockPath)(directory), { force: true });
+    return true;
+};
+exports.releaseApiLock = releaseApiLock;
+/** The current lock when `ETHLETE_API_LOCK` names it, so a command run under the lock does not wait for it. */
+const heldLockFromEnv = (directory, env = process.env) => {
+    const token = env[exports.API_LOCK_ENV];
+    const lock = (0, exports.readApiLock)(directory);
+    return token && (lock === null || lock === void 0 ? void 0 : lock.token) === token ? lock : undefined;
+};
+exports.heldLockFromEnv = heldLockFromEnv;
+//# sourceMappingURL=lock.js.map

package/src/lib/api/lock.js.map

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

package/src/lib/api/parse-argv.d.ts

@@ -0,0 +1,12 @@
+export type ParsedApiArgv = {
+    /** Every argument before the first `--`, flags included. */
+    head: string[];
+    /** The non-flag arguments of `head`, without the values of `--profile` and `--wait`. */
+    positionals: string[];
+    /** Everything after the first `--`, unchanged. `undefined` when there is no `--`. */
+    rest: string[] | undefined;
+    profile: string | undefined;
+    wait: string | undefined;
+};
+/** Splits `et api` arguments at the first `--` and reads the value flags before it. */
+export declare const parseApiArgv: (argv: string[]) => ParsedApiArgv;

package/src/lib/api/parse-argv.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseApiArgv = void 0;
+const VALUE_FLAGS = ['--profile', '--wait'];
+/** Splits `et api` arguments at the first `--` and reads the value flags before it. */
+const parseApiArgv = (argv) => {
+    const separator = argv.indexOf('--');
+    const head = separator === -1 ? argv : argv.slice(0, separator);
+    const rest = separator === -1 ? undefined : argv.slice(separator + 1);
+    const positionals = [];
+    const values = {};
+    for (let index = 0; index < head.length; index++) {
+        const arg = head[index];
+        const flag = VALUE_FLAGS.find((candidate) => arg === candidate || arg.startsWith(`${candidate}=`));
+        if (flag !== undefined) {
+            if (arg === flag) {
+                values[flag] = head[index + 1];
+                index++;
+            }
+            else {
+                values[flag] = arg.slice(flag.length + 1);
+            }
+        }
+        else if (!arg.startsWith('-')) {
+            positionals.push(arg);
+        }
+    }
+    return { head, positionals, rest, profile: values['--profile'], wait: values['--wait'] };
+};
+exports.parseApiArgv = parseApiArgv;
+//# sourceMappingURL=parse-argv.js.map

package/src/lib/api/parse-argv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-argv.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/parse-argv.ts"],"names":[],"mappings":";;;AAAA,MAAM,WAAW,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAU,CAAC;AAarD,uFAAuF;AAChF,MAAM,YAAY,GAAG,CAAC,IAAc,EAAiB,EAAE;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IACtE,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,MAAM,GAAuC,EAAE,CAAC;IAEtD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAW,CAAC;QAClC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;QAEnG,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;gBAC/B,KAAK,EAAE,CAAC;YACV,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC3F,CAAC,CAAC;AAxBW,QAAA,YAAY,gBAwBvB"}

package/src/lib/api/run-locked.d.ts

@@ -0,0 +1,14 @@
+import { LockSystem } from './lock';
+export declare const LOCK_TIMEOUT_EXIT_CODE = 75;
+/**
+ * Runs `command` under the API lock in `directory` and returns its exit code, or 75 when the lock
+ * stayed taken for `wait` seconds. The state becomes dirty once the command ends.
+ */
+export declare const runLocked: (options: {
+    directory: string;
+    command: string[];
+    cwd: string;
+    wait?: number;
+    env?: NodeJS.ProcessEnv;
+    system?: LockSystem;
+}) => Promise<number>;

package/src/lib/api/run-locked.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLocked = exports.LOCK_TIMEOUT_EXIT_CODE = void 0;
+const tslib_1 = require("tslib");
+const child_process_1 = require("child_process");
+const os_1 = require("os");
+const api_state_1 = require("./api-state");
+const lock_1 = require("./lock");
+exports.LOCK_TIMEOUT_EXIT_CODE = 75;
+const FORWARDED_SIGNALS = ['SIGINT', 'SIGTERM'];
+const runChild = (options) => new Promise((resolve) => {
+    const { command, cwd, env } = options;
+    const [binary, ...args] = command;
+    const child = (0, child_process_1.spawn)(binary, args, { cwd, env, stdio: 'inherit' });
+    const forward = (signal) => void child.kill(signal);
+    const done = (code) => {
+        for (const signal of FORWARDED_SIGNALS)
+            process.off(signal, forward);
+        resolve(code);
+    };
+    for (const signal of FORWARDED_SIGNALS)
+        process.on(signal, forward);
+    child.once('error', (error) => {
+        console.error(`Could not run ${binary}: ${error.message}`);
+        done(127);
+    });
+    child.once('exit', (code, signal) => { var _a; return done(signal ? 128 + ((_a = os_1.constants.signals[signal]) !== null && _a !== void 0 ? _a : 0) : (code !== null && code !== void 0 ? code : 1)); });
+});
+/**
+ * Runs `command` under the API lock in `directory` and returns its exit code, or 75 when the lock
+ * stayed taken for `wait` seconds. The state becomes dirty once the command ends.
+ */
+const runLocked = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { directory, command, cwd, wait, env = process.env, system } = options;
+    const acquired = yield (0, lock_1.acquireApiLock)({
+        directory,
+        command: command.join(' '),
+        cwd,
+        wait,
+        system,
+        onHeld: (holder) => console.error(`Waiting for the API lock, held by ${(0, lock_1.describeApiLock)(holder, directory)}.`),
+    });
+    if (!acquired.ok) {
+        console.error(`Gave up after ${wait} s. The API lock is held by ${(0, lock_1.describeApiLock)(acquired.holder, directory)}.`);
+        return exports.LOCK_TIMEOUT_EXIT_CODE;
+    }
+    const { token } = acquired.lock;
+    const release = () => {
+        process.off('exit', release);
+        (0, api_state_1.markApiStateDirty)(directory);
+        (0, lock_1.releaseApiLock)(directory, token);
+    };
+    process.once('exit', release);
+    try {
+        return yield runChild({ command, cwd, env: Object.assign(Object.assign({}, env), { [lock_1.API_LOCK_ENV]: token }) });
+    }
+    finally {
+        release();
+    }
+});
+exports.runLocked = runLocked;
+//# sourceMappingURL=run-locked.js.map

package/src/lib/api/run-locked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-locked.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/run-locked.ts"],"names":[],"mappings":"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"}

package/src/lib/api/run-ready.d.ts

@@ -0,0 +1,60 @@
+import { ApiDefinition } from './definition';
+import { LockSystem } from './lock';
+import { SeedStep } from './seeds';
+type Parsed<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    problem: string;
+};
+/** One run of the seed machinery: manifest steps copied and run together, or one `exec` entry of the API. */
+export type ReadySeedUnit = {
+    kind: 'steps';
+    steps: SeedStep[];
+} | {
+    kind: 'exec';
+    name: string;
+};
+export declare const HEALTH_TIMEOUT_MS = 60000;
+export declare const HEALTH_RETRY_MS = 2000;
+/** Each name is `fixtures`, a seed of `.ethlete/seeds/<api>/seeds.json`, or an `exec` entry, checked in that order. */
+export declare const resolveProfileSeeds: (options: {
+    root: string;
+    name: string;
+    api: ApiDefinition;
+    profileName: string;
+    seeds: readonly string[];
+}) => Parsed<ReadySeedUnit[]>;
+/** GETs `url` until it answers `expect`, every `retryMs` for up to `timeoutMs`. */
+export declare const waitForHealth: (options: {
+    url: string;
+    expect: number;
+    fetch?: typeof fetch;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+    timeoutMs?: number;
+    retryMs?: number;
+}) => Promise<{
+    ok: true;
+} | {
+    ok: false;
+    last: string;
+}>;
+export type RunReadyOptions = {
+    root: string;
+    name: string;
+    api: ApiDefinition;
+    invocation: string;
+    profile: string | undefined;
+    wait: number | undefined;
+    up: () => Promise<number>;
+    runSeeds: (unit: ReadySeedUnit) => Promise<number>;
+    fetch?: typeof fetch;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+    lockSystem?: LockSystem;
+};
+/** Runs `ready <api> --profile <p>` and returns the exit code. */
+export declare const runReadyCommand: (options: RunReadyOptions) => Promise<number>;
+export {};

package/src/lib/api/run-ready.js

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runReadyCommand = exports.waitForHealth = exports.resolveProfileSeeds = exports.HEALTH_RETRY_MS = exports.HEALTH_TIMEOUT_MS = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const promises_1 = require("timers/promises");
+const api_context_1 = require("./api-context");
+const api_state_1 = require("./api-state");
+const compose_1 = require("./compose");
+const doctor_1 = require("./doctor");
+const fingerprint_1 = require("./fingerprint");
+const lock_1 = require("./lock");
+const resolve_checkout_1 = require("./resolve-checkout");
+const run_locked_1 = require("./run-locked");
+const run_snapshot_1 = require("./run-snapshot");
+const seeds_1 = require("./seeds");
+const suggest_1 = require("./suggest");
+const snapshot_1 = require("./snapshot");
+exports.HEALTH_TIMEOUT_MS = 60000;
+exports.HEALTH_RETRY_MS = 2000;
+const has = (record, key) => Object.prototype.hasOwnProperty.call(record, key);
+/** Each name is `fixtures`, a seed of `.ethlete/seeds/<api>/seeds.json`, or an `exec` entry, checked in that order. */
+const resolveProfileSeeds = (options) => {
+    var _a, _b;
+    const { root, name, api, profileName, seeds } = options;
+    const manifest = (0, seeds_1.readSeedManifest)(root, name);
+    const units = [];
+    for (const seed of seeds) {
+        const fromManifest = manifest.ok && (seed === 'fixtures' ? manifest.value.fixtures !== undefined : has(manifest.value.seeds, seed))
+            ? (0, seeds_1.seedSteps)({
+                manifest: manifest.value,
+                names: seed === 'fixtures' ? [] : [seed],
+                withFixtures: seed === 'fixtures',
+                api: name,
+            })
+            : undefined;
+        if (fromManifest === null || fromManifest === void 0 ? void 0 : fromManifest.ok) {
+            const last = units[units.length - 1];
+            if ((last === null || last === void 0 ? void 0 : last.kind) === 'steps')
+                last.steps.push(...fromManifest.value);
+            else
+                units.push({ kind: 'steps', steps: [...fromManifest.value] });
+            continue;
+        }
+        if (((_a = api.exec) === null || _a === void 0 ? void 0 : _a[seed]) !== undefined) {
+            units.push({ kind: 'exec', name: seed });
+            continue;
+        }
+        const candidates = [
+            ...(manifest.ok && manifest.value.fixtures ? ['fixtures'] : []),
+            ...(manifest.ok ? Object.keys(manifest.value.seeds) : []),
+            ...Object.keys((_b = api.exec) !== null && _b !== void 0 ? _b : {}),
+        ];
+        return {
+            ok: false,
+            problem: `The ${profileName} profile of the ${name} API names "${seed}", which is no seed, fixtures list or exec entry.` +
+                `${(0, suggest_1.didYouMean)(seed, candidates)}\n\nKnown: ${candidates.length > 0 ? candidates.join(', ') : 'none'}` +
+                (manifest.ok ? '' : `\n\n${manifest.problem}`),
+        };
+    }
+    return { ok: true, value: units };
+};
+exports.resolveProfileSeeds = resolveProfileSeeds;
+/** GETs `url` until it answers `expect`, every `retryMs` for up to `timeoutMs`. */
+const waitForHealth = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { url, expect, fetch: get = fetch, sleep = (ms) => tslib_1.__awaiter(void 0, void 0, void 0, function* () { return void (yield (0, promises_1.setTimeout)(ms)); }), now = Date.now, timeoutMs = exports.HEALTH_TIMEOUT_MS, retryMs = exports.HEALTH_RETRY_MS, } = options;
+    const startedAt = now();
+    for (;;) {
+        let last;
+        try {
+            const left = Math.max(1, timeoutMs - (now() - startedAt));
+            const response = yield get(url, { signal: AbortSignal.timeout(Math.min(retryMs * 5, left)) });
+            if (response.status === expect)
+                return { ok: true };
+            last = `status ${response.status}`;
+        }
+        catch (error) {
+            last = error.message;
+        }
+        if (now() - startedAt >= timeoutMs)
+            return { ok: false, last };
+        yield sleep(retryMs);
+    }
+});
+exports.waitForHealth = waitForHealth;
+const step = (text) => console.error(`\n==> ${text}`);
+/** Runs `ready <api> --profile <p>` and returns the exit code. */
+const runReadyCommand = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    var _a, _b, _c, _d, _e;
+    const { root, name, api, invocation, profile: profileName, wait, now = Date.now } = options;
+    const startedAt = now();
+    const profileNames = Object.keys((_a = api.profiles) !== null && _a !== void 0 ? _a : {});
+    const profile = profileName === undefined ? undefined : (_b = api.profiles) === null || _b === void 0 ? void 0 : _b[profileName];
+    if (profileName === undefined || profile === undefined) {
+        console.error((profileName === undefined
+            ? `ready needs a profile: ${invocation} ready ${name} --profile <profile>.`
+            : `The ${name} API has no profile "${profileName}".${(0, suggest_1.didYouMean)(profileName, profileNames)}`) +
+            `\n\nProfiles: ${profileNames.length > 0 ? profileNames.join(', ') : 'none'}`);
+        return 1;
+    }
+    const units = (0, exports.resolveProfileSeeds)({ root, name, api, profileName, seeds: profile.seeds });
+    if (!units.ok) {
+        console.error(units.problem);
+        return 1;
+    }
+    const context = (0, api_context_1.stateDirectoryOf)({ root, name, api });
+    if (!context.ok) {
+        console.error((0, resolve_checkout_1.checkoutProblem)({ failure: context, name, invocation }));
+        return 1;
+    }
+    const tool = (0, compose_1.resolveComposeTool)();
+    if (!tool) {
+        console.error(`No compose tool found. Tried: ${(0, compose_1.composeToolNames)().join(', ')}.`);
+        return 1;
+    }
+    const { checkout, directory } = context;
+    const env = Object.assign(Object.assign(Object.assign({}, (0, compose_1.engineEnv)(tool.engine)), process.env), (0, api_context_1.definedEntries)((_d = (_c = api.env) === null || _c === void 0 ? void 0 : _c.call(api)) !== null && _d !== void 0 ? _d : {}));
+    let token;
+    if ((0, lock_1.heldLockFromEnv)(directory)) {
+        step('Using the API lock this command runs under');
+    }
+    else {
+        step('Taking the API lock');
+        const acquired = yield (0, lock_1.acquireApiLock)({
+            directory,
+            command: `${invocation} ready ${name} --profile ${profileName}`,
+            cwd: root,
+            wait,
+            system: options.lockSystem,
+            onHeld: (holder) => console.error(`Waiting for the API lock, held by ${(0, lock_1.describeApiLock)(holder, directory)}.`),
+        });
+        if (!acquired.ok) {
+            console.error(`Gave up after ${wait} s. The API lock is held by ${(0, lock_1.describeApiLock)(acquired.holder, directory)}.`);
+            return run_locked_1.LOCK_TIMEOUT_EXIT_CODE;
+        }
+        token = acquired.lock.token;
+    }
+    try {
+        step(`Starting ${name}`);
+        const upCode = yield options.up();
+        if (upCode !== 0)
+            return upCode;
+        step('Checking the API (doctor --fix)');
+        if (!(0, doctor_1.runDoctor)({ name, api, tool, cwd: checkout.composePath, env, invocation, fix: true }).ok)
+            return 1;
+        const fingerprint = (0, fingerprint_1.fingerprintApi)({
+            root,
+            name,
+            repoPath: checkout.repoPath,
+            migrationsDir: api.migrationsDir,
+            seeds: profile.seeds,
+        });
+        const state = (0, api_state_1.readApiState)(directory);
+        const [binary, ...prefix] = tool.compose;
+        const compose = { binary, prefix, cwd: checkout.composePath, env };
+        const file = (0, snapshot_1.snapshotFilePath)({ root, api: name, name: profileName, fingerprint });
+        if (state && !state.dirty && state.profile === profileName && state.fingerprint === fingerprint) {
+            step(`Already ready: ${profileName} at ${fingerprint}`);
+        }
+        else if (profile.snapshot && (0, fs_1.existsSync)(file)) {
+            step(`Restoring the ${profileName} snapshot ${fingerprint}`);
+            const restored = yield (0, snapshot_1.restoreSnapshot)({
+                file,
+                snapshot: profile.snapshot,
+                compose,
+                state: { directory, profile: profileName, fingerprint },
+            });
+            if (restored !== 0)
+                return restored;
+        }
+        else {
+            (0, api_state_1.markApiStateDirty)(directory);
+            for (const unit of units.value) {
+                step(`Seeding ${unit.kind === 'exec' ? unit.name : unit.steps.map(({ label }) => label).join(', ')}`);
+                const seeded = yield options.runSeeds(unit);
+                if (seeded !== 0)
+                    return seeded;
+            }
+            if (profile.snapshot) {
+                step(`Saving the ${profileName} snapshot ${fingerprint}`);
+                (0, run_snapshot_1.warnUnlessSnapshotIgnored)(root, file);
+                const saved = yield (0, snapshot_1.saveSnapshot)({ file, snapshot: profile.snapshot, compose });
+                if (saved !== 0)
+                    return saved;
+            }
+            (0, api_state_1.writeApiState)({ directory, state: { profile: profileName, fingerprint, dirty: false } });
+        }
+        if (profile.health) {
+            const expect = (_e = profile.health.expect) !== null && _e !== void 0 ? _e : 200;
+            step(`Waiting for ${profile.health.url} to answer ${expect}`);
+            const health = yield (0, exports.waitForHealth)({
+                url: profile.health.url,
+                expect,
+                fetch: options.fetch,
+                sleep: options.sleep,
+                now,
+            });
+            if (!health.ok) {
+                console.error(`${profile.health.url} did not answer ${expect} within ${exports.HEALTH_TIMEOUT_MS / 1000} s. Last: ${health.last}.`);
+                return 1;
+            }
+        }
+        console.log(`${name} is ready: profile ${profileName}, fingerprint ${fingerprint}, in ${((now() - startedAt) / 1000).toFixed(1)} s.`);
+        return 0;
+    }
+    finally {
+        if (token !== undefined)
+            (0, lock_1.releaseApiLock)(directory, token);
+    }
+});
+exports.runReadyCommand = runReadyCommand;
+//# sourceMappingURL=run-ready.js.map