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

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

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

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

@@ -1,4 +1,5 @@
 export * from './api-command';
+export * from './api-state';
 export * from './compose';
 export * from './auth-hint';
 export * from './clear';
@@ -7,9 +8,12 @@ export * from './definition';
 export * from './git';
 export * from './help';
 export * from './load-definitions';
+export * from './lock';
 export * from './ports';
 export * from './resolve-checkout';
 export * from './run';
+export * from './run-locked';
+export * from './seeds';
 export * from './setup';
 export * from './state';
 export * from './suggest';

package/src/lib/api/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./api-command"), exports);
+tslib_1.__exportStar(require("./api-state"), exports);
 tslib_1.__exportStar(require("./compose"), exports);
 tslib_1.__exportStar(require("./auth-hint"), exports);
 tslib_1.__exportStar(require("./clear"), exports);
@@ -10,9 +11,12 @@ tslib_1.__exportStar(require("./definition"), exports);
 tslib_1.__exportStar(require("./git"), exports);
 tslib_1.__exportStar(require("./help"), exports);
 tslib_1.__exportStar(require("./load-definitions"), exports);
+tslib_1.__exportStar(require("./lock"), exports);
 tslib_1.__exportStar(require("./ports"), exports);
 tslib_1.__exportStar(require("./resolve-checkout"), exports);
 tslib_1.__exportStar(require("./run"), exports);
+tslib_1.__exportStar(require("./run-locked"), exports);
+tslib_1.__exportStar(require("./seeds"), exports);
 tslib_1.__exportStar(require("./setup"), exports);
 tslib_1.__exportStar(require("./state"), exports);
 tslib_1.__exportStar(require("./suggest"), exports);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,oDAA0B;AAC1B,sDAA4B;AAC5B,kDAAwB;AACxB,kDAAwB;AACxB,uDAA6B;AAC7B,gDAAsB;AACtB,iDAAuB;AACvB,6DAAmC;AACnC,kDAAwB;AACxB,6DAAmC;AACnC,gDAAsB;AACtB,kDAAwB;AACxB,kDAAwB;AACxB,oDAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/cli/src/lib/api/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,sDAA4B;AAC5B,oDAA0B;AAC1B,sDAA4B;AAC5B,kDAAwB;AACxB,kDAAwB;AACxB,uDAA6B;AAC7B,gDAAsB;AACtB,iDAAuB;AACvB,6DAAmC;AACnC,iDAAuB;AACvB,kDAAwB;AACxB,6DAAmC;AACnC,gDAAsB;AACtB,uDAA6B;AAC7B,kDAAwB;AACxB,kDAAwB;AACxB,kDAAwB;AACxB,oDAA0B"}

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 {};