@o/cli 0.0.0-bootstrap.0 → 0.16.14

package/README.md

@@ -0,0 +1,17 @@
+# @o/cli
+
+Typed command definitions, subprocess execution, and process cleanup for project
+tooling.
+
+```ts
+import { cmd, handleProcessExit, run } from '@o/cli'
+```
+
+Run package scripts in parallel with the `o` binary:
+
+```sh
+o run-all --flags=last api dev
+```
+
+Add `--pty` for the interactive terminal supervisor and `--watch` to restart
+failed children.

package/dist/args.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ultra simple typed arg parsing
+ *
+ * @example
+ * const { port, verbose, rest } = args`--port number --verbose boolean`
+ * // port: number | undefined
+ * // verbose: boolean
+ * // rest: string[] - positional args that don't match any flag
+ */
+type ParseType<T extends string> = T extends 'number' ? number | undefined : T extends 'boolean' ? boolean : T extends 'string' ? string | undefined : never;
+type ParseFlag<S extends string> = S extends `--${infer Name} ${infer Type}` ? {
+    [K in Name as KebabToCamel<K>]: ParseType<Type>;
+} : S extends `-${infer Name} ${infer Type}` ? {
+    [K in Name as KebabToCamel<K>]: ParseType<Type>;
+} : object;
+type KebabToCamel<S extends string> = S extends `${infer A}-${infer B}` ? `${A}${Capitalize<KebabToCamel<B>>}` : S;
+type Trim<S extends string> = S extends ` ${infer R}` ? Trim<R> : S extends `${infer R} ` ? Trim<R> : S extends `\n${infer R}` ? Trim<R> : S extends `${infer R}\n` ? Trim<R> : S;
+type ParseFlags<S extends string> = Trim<S> extends `${infer Flag} --${infer Rest}` ? ParseFlag<Trim<Flag>> & ParseFlags<`--${Rest}`> : Trim<S> extends `${infer Flag}\n--${infer Rest}` ? ParseFlag<Trim<Flag>> & ParseFlags<`--${Rest}`> : Trim<S> extends `${infer Flag} -${infer Rest}` ? ParseFlag<Trim<Flag>> & ParseFlags<`-${Rest}`> : Trim<S> extends `${infer Flag}\n-${infer Rest}` ? ParseFlag<Trim<Flag>> & ParseFlags<`-${Rest}`> : ParseFlag<Trim<S>>;
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type Args<S extends string> = Prettify<ParseFlags<S> & {
+    rest: string[];
+}>;
+export declare function args<const S extends string>(spec: S): Args<S>;
+export {};
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,QAAQ,GACjD,MAAM,GAAG,SAAS,GAClB,CAAC,SAAS,SAAS,GACjB,OAAO,GACP,CAAC,SAAS,QAAQ,GAChB,MAAM,GAAG,SAAS,GAClB,KAAK,CAAA;AAEb,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,KAAK,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GACxE;KAAG,CAAC,IAAI,IAAI,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC;CAAE,GACnD,CAAC,SAAS,IAAI,MAAM,IAAI,IAAI,MAAM,IAAI,EAAE,GACtC;KAAG,CAAC,IAAI,IAAI,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC;CAAE,GACnD,MAAM,CAAA;AAEZ,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,GACnE,GAAG,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,GACpC,CAAC,CAAA;AAGL,KAAK,IAAI,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,GACjD,IAAI,CAAC,CAAC,CAAC,GACP,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,GACrB,IAAI,CAAC,CAAC,CAAC,GACP,CAAC,SAAS,KAAK,MAAM,CAAC,EAAE,GACtB,IAAI,CAAC,CAAC,CAAC,GACP,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,GACtB,IAAI,CAAC,CAAC,CAAC,GACP,CAAC,CAAA;AAGX,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,IAC9B,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,MAAM,IAAI,EAAE,GAC3C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,GAC/C,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,IAAI,OAAO,MAAM,IAAI,EAAE,GAC9C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,GAC/C,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,IAAI,KAAK,MAAM,IAAI,EAAE,GAC5C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,GAC9C,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,MAAM,IAAI,MAAM,MAAM,IAAI,EAAE,GAC7C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,GAC9C,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;AAG9B,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAA;AAEhD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAA;AAEjF,wBAAgB,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA"}

package/dist/args.js

@@ -0,0 +1,46 @@
+/**
+ * ultra simple typed arg parsing
+ *
+ * @example
+ * const { port, verbose, rest } = args`--port number --verbose boolean`
+ * // port: number | undefined
+ * // verbose: boolean
+ * // rest: string[] - positional args that don't match any flag
+ */
+export function args(strings) {
+    const spec = typeof strings === 'string' ? strings : strings[0] || '';
+    const argv = process.argv.slice(2);
+    // parse spec: "--port number --verbose boolean"
+    const schema = {};
+    const matches = spec.matchAll(/--?([a-z0-9-]+)\s+(string|number|boolean)/gi);
+    for (const [, flag, type] of matches) {
+        const camel = flag.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+        schema[camel] = type;
+    }
+    const result = {};
+    const rest = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith('-')) {
+            const key = arg
+                .replace(/^--?/, '')
+                .replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+            const type = schema[key];
+            if (type === 'boolean') {
+                result[key] = true;
+            }
+            else if (type === 'string' || type === 'number') {
+                const val = argv[++i];
+                result[key] = type === 'number' ? Number(val) : val;
+            }
+            else {
+                rest.push(arg);
+            }
+        }
+        else {
+            rest.push(arg);
+        }
+    }
+    return { ...result, rest };
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiDH,MAAM,UAAU,IAAI,CAAyB,OAAiC;IAC5E,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACrE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAElC,gDAAgD;IAChD,MAAM,MAAM,GAAoD,EAAE,CAAA;IAClE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,6CAA6C,CAAC,CAAA;IAE5E,KAAK,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAK,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;QACtE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAuC,CAAA;IACzD,CAAC;IAED,MAAM,MAAM,GAA0D,EAAE,CAAA;IACxE,MAAM,IAAI,GAAa,EAAE,CAAA;IAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAA;QAEpB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,GAAG;iBACZ,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;iBACnB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAA;YACrD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;YAExB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;YACpB,CAAC;iBAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAClD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;gBACrB,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;YACrD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,MAAM,EAAE,IAAI,EAAa,CAAA;AACvC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { parseRunArgs, runParallelScripts } from './run-all.js';
+async function main() {
+    const [command, ...args] = process.argv.slice(2);
+    if (command !== 'run-all') {
+        console.error('Usage: o run-all [--pty] [--watch] [--flags=last] <script...>');
+        process.exitCode = 1;
+        return;
+    }
+    const usePty = args.includes('--pty');
+    const filteredArgs = args.filter((arg) => arg !== '--pty');
+    if (!usePty) {
+        await runParallelScripts(parseRunArgs(filteredArgs));
+        return;
+    }
+    const scriptPath = fileURLToPath(new URL('./run-pty.mjs', import.meta.url));
+    const child = spawn(process.execPath, [scriptPath, ...filteredArgs], {
+        stdio: 'inherit',
+        shell: false,
+    });
+    const code = await new Promise((resolve) => {
+        child.on('exit', (exitCode) => resolve(exitCode ?? 0));
+    });
+    process.exitCode = code;
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAE/D,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAChD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAA;QAC9E,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;QACpB,OAAM;IACR,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACrC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,OAAO,CAAC,CAAA;IAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,kBAAkB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;QACpD,OAAM;IACR,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC3E,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,GAAG,YAAY,CAAC,EAAE;QACnE,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,KAAK;KACb,CAAC,CAAA;IACF,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACjD,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAA;IACxD,CAAC,CAAC,CAAA;IACF,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAA;AACzB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACrE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA"}

package/dist/cmd.d.ts

@@ -0,0 +1,32 @@
+type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type CmdContext = {
+    $: typeof import('bun').$;
+    colors: typeof import('picocolors');
+    prompt: typeof import('@clack/prompts');
+    run: typeof import('./run.js').run;
+    fs: typeof import('node:fs');
+    path: typeof import('node:path');
+    os: typeof import('node:os');
+};
+type Args<S extends string> = import('./args.js').Args<S>;
+type RunFn<S extends string> = (fn: (ctx: Prettify<{
+    args: Args<S>;
+} & CmdContext>) => Promise<void> | void) => Promise<void>;
+export declare function setInterceptCmd(fn: ((info: {
+    description: string;
+    args?: string;
+}) => void) | undefined): void;
+declare function createCmd(description: string): {
+    env(vars: Record<string, string>): /*elided*/ any;
+    args<const S extends string>(spec: S): {
+        env(vars: Record<string, string>): /*elided*/ any;
+        run: RunFn<S>;
+    };
+    run: RunFn<"">;
+};
+export declare function cmd(description: string): ReturnType<typeof createCmd>;
+export declare function cmd(strings: TemplateStringsArray): ReturnType<typeof createCmd>;
+export {};
+//# sourceMappingURL=cmd.d.ts.map

package/dist/cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd.d.ts","sourceRoot":"","sources":["../src/cmd.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAA;AAEhD,KAAK,UAAU,GAAG;IAChB,CAAC,EAAE,cAAc,KAAK,EAAE,CAAC,CAAA;IACzB,MAAM,EAAE,cAAc,YAAY,CAAC,CAAA;IACnC,MAAM,EAAE,cAAc,gBAAgB,CAAC,CAAA;IACvC,GAAG,EAAE,cAAc,UAAU,EAAE,GAAG,CAAA;IAClC,EAAE,EAAE,cAAc,SAAS,CAAC,CAAA;IAC5B,IAAI,EAAE,cAAc,WAAW,CAAC,CAAA;IAChC,EAAE,EAAE,cAAc,SAAS,CAAC,CAAA;CAC7B,CAAA;AAED,KAAK,IAAI,CAAC,CAAC,SAAS,MAAM,IAAI,OAAO,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;AAEzD,KAAK,KAAK,CAAC,CAAC,SAAS,MAAM,IAAI,CAC7B,EAAE,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;CAAE,GAAG,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KACxE,OAAO,CAAC,IAAI,CAAC,CAAA;AAIlB,wBAAgB,eAAe,CAC7B,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAC,GAAG,SAAS,QAGzE;AAED,iBAAS,SAAS,CAAC,WAAW,EAAE,MAAM;cA6DxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;eAIrB,CAAC,SAAS,MAAM,QAAQ,CAAC;kBAbxB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;EAmBrC;AAED,wBAAgB,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA;AACtE,wBAAgB,GAAG,CAAC,OAAO,EAAE,oBAAoB,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAA"}

package/dist/cmd.js

@@ -0,0 +1,70 @@
+let _interceptCmd;
+export function setInterceptCmd(fn) {
+    _interceptCmd = fn;
+}
+function createCmd(description) {
+    let argsSpec;
+    let envVars = {};
+    function makeRun(spec) {
+        return async (fn) => {
+            if (_interceptCmd) {
+                _interceptCmd({ description, args: argsSpec });
+                return;
+            }
+            const colors = (await import(`picocolors`)).default;
+            if (process.argv.includes(`--help`) || process.argv.includes(`-h`)) {
+                console.info();
+                console.info(colors.bold(description));
+                if (argsSpec) {
+                    console.info();
+                    const flags = [...argsSpec.matchAll(/--?([a-z-]+)\s+(string|number|boolean)/gi)];
+                    for (const [, flag, type] of flags) {
+                        console.info(`  --${flag}  ${colors.dim(type)}`);
+                    }
+                }
+                console.info();
+                process.exit(0);
+            }
+            // apply env vars before running
+            for (const [key, value] of Object.entries(envVars)) {
+                process.env[key] = value;
+            }
+            const [{ $ }, prompt, { run }, { args: parseArgs }, fs, path, os] = await Promise.all([
+                import(`bun`),
+                import(`@clack/prompts`),
+                import(`./run.js`),
+                import(`./args.js`),
+                import(`node:fs`),
+                import(`node:path`),
+                import(`node:os`),
+            ]);
+            const args = spec ? parseArgs(spec) : { rest: [] };
+            await fn({ args, $, colors, prompt, run, fs, path, os });
+        };
+    }
+    function makeChainable(spec) {
+        return {
+            env(vars) {
+                Object.assign(envVars, vars);
+                return this;
+            },
+            run: makeRun(spec),
+        };
+    }
+    return {
+        env(vars) {
+            Object.assign(envVars, vars);
+            return this;
+        },
+        args(spec) {
+            argsSpec = spec;
+            return makeChainable(spec);
+        },
+        run: makeRun(``),
+    };
+}
+export function cmd(input) {
+    const description = typeof input === `string` ? input : input[0] || ``;
+    return createCmd(description);
+}
+//# sourceMappingURL=cmd.js.map

package/dist/cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd.js","sourceRoot":"","sources":["../src/cmd.ts"],"names":[],"mappings":"AAkBA,IAAI,aAAmF,CAAA;AAEvF,MAAM,UAAU,eAAe,CAC7B,EAAwE;IAExE,aAAa,GAAG,EAAE,CAAA;AACpB,CAAC;AAED,SAAS,SAAS,CAAC,WAAmB;IACpC,IAAI,QAA4B,CAAA;IAChC,IAAI,OAAO,GAA2B,EAAE,CAAA;IAExC,SAAS,OAAO,CAAmB,IAAO;QACxC,OAAO,KAAK,EAAE,EAAE,EAAE,EAAE;YAClB,IAAI,aAAa,EAAE,CAAC;gBAClB,aAAa,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;gBAC9C,OAAM;YACR,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAA;YAEnD,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnE,OAAO,CAAC,IAAI,EAAE,CAAA;gBACd,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAA;gBACtC,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,EAAE,CAAA;oBACd,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,0CAA0C,CAAC,CAAC,CAAA;oBAChF,KAAK,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;wBACnC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,MAAM,CAAC,GAAG,CAAC,IAAK,CAAC,EAAE,CAAC,CAAA;oBACnD,CAAC;gBACH,CAAC;gBACD,OAAO,CAAC,IAAI,EAAE,CAAA;gBACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;YAED,gCAAgC;YAChC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YAC1B,CAAC;YAED,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,GAC/D,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,MAAM,CAAC,KAAK,CAAC;gBACb,MAAM,CAAC,gBAAgB,CAAC;gBACxB,MAAM,CAAC,UAAU,CAAC;gBAClB,MAAM,CAAC,WAAW,CAAC;gBACnB,MAAM,CAAC,SAAS,CAAC;gBACjB,MAAM,CAAC,WAAW,CAAC;gBACnB,MAAM,CAAC,SAAS,CAAC;aAClB,CAAC,CAAA;YAEJ,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,EAAE,EAAc,CAAA;YAC/D,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAEpD,CAAC,CAAA;QACJ,CAAC,CAAA;IACH,CAAC;IAED,SAAS,aAAa,CAAmB,IAAO;QAC9C,OAAO;YACL,GAAG,CAAC,IAA4B;gBAC9B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;gBAC5B,OAAO,IAAI,CAAA;YACb,CAAC;YACD,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC;SACnB,CAAA;IACH,CAAC;IAED,OAAO;QACL,GAAG,CAAC,IAA4B;YAC9B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;YAC5B,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAyB,IAAO;YAClC,QAAQ,GAAG,IAAI,CAAA;YACf,OAAO,aAAa,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC;QACD,GAAG,EAAE,OAAO,CAAC,EAAQ,CAAC;KACvB,CAAA;AACH,CAAC;AAID,MAAM,UAAU,GAAG,CAAC,KAAoC;IACtD,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACtE,OAAO,SAAS,CAAC,WAAW,CAAC,CAAA;AAC/B,CAAC"}

package/dist/handle-process-exit.d.ts

@@ -0,0 +1,14 @@
+import { type ProcessHandler } from './process-state.js';
+type ExitCallback = (info: {
+    signal: string;
+}) => void | Promise<void>;
+interface HandleProcessExitReturn {
+    addChildProcess: ProcessHandler;
+    cleanup: () => Promise<void>;
+    exit: (code?: number) => Promise<void>;
+}
+export declare function handleProcessExit({ onExit, }?: {
+    onExit?: ExitCallback;
+}): HandleProcessExitReturn;
+export {};
+//# sourceMappingURL=handle-process-exit.d.ts.map

package/dist/handle-process-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-process-exit.d.ts","sourceRoot":"","sources":["../src/handle-process-exit.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,oBAAoB,CAAA;AAE3B,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEtE,UAAU,uBAAuB;IAC/B,eAAe,EAAE,cAAc,CAAA;IAC/B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC;AA0ED,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,GACP,GAAE;IACD,MAAM,CAAC,EAAE,YAAY,CAAA;CACjB,GAAG,uBAAuB,CAuI/B"}

package/dist/handle-process-exit.js

@@ -0,0 +1,191 @@
+import { execSync } from 'node:child_process';
+import { appendFileSync, rmSync } from 'node:fs';
+import { addProcessHandler, setExitCleanupState, } from './process-state.js';
+const pidFilePath = `/tmp/o-run-${process.pid}.pids`;
+function writePidFile(pid) {
+    try {
+        appendFileSync(pidFilePath, `${pid}\n`);
+    }
+    catch { }
+}
+function removePidFile() {
+    try {
+        rmSync(pidFilePath, { force: true });
+    }
+    catch { }
+}
+// find descendant pids that survived the group kill
+// uses pgrep -P instead of ps (ps is a setuid binary blocked by sandbox-exec)
+function findStragglers(trackedPids) {
+    try {
+        const descendants = new Set();
+        const queue = [...trackedPids];
+        while (queue.length > 0) {
+            const current = queue.pop();
+            try {
+                const output = execSync(`pgrep -P ${current}`, {
+                    encoding: 'utf-8',
+                    timeout: 2000,
+                });
+                for (const line of output.trim().split('\n')) {
+                    const pid = parseInt(line, 10);
+                    if (!isNaN(pid) && !descendants.has(pid)) {
+                        descendants.add(pid);
+                        queue.push(pid);
+                    }
+                }
+            }
+            catch {
+                // pgrep exits 1 when no children found, that's fine
+            }
+        }
+        return [...descendants];
+    }
+    catch {
+        return [];
+    }
+}
+// kill entire process group to prevent orphaned descendants
+function killProcess(pid, signal = 'SIGTERM', forceful = false) {
+    // kill process group first (negative pid), then direct process
+    try {
+        process.kill(-pid, signal);
+    }
+    catch (_) { }
+    try {
+        process.kill(pid, signal);
+    }
+    catch (_) { }
+    if (forceful && signal !== 'SIGKILL') {
+        setTimeout(() => {
+            try {
+                process.kill(-pid, 'SIGKILL');
+            }
+            catch (_) { }
+            try {
+                process.kill(pid, 'SIGKILL');
+            }
+            catch (_) { }
+        }, 100);
+    }
+}
+let isHandling = false;
+export function handleProcessExit({ onExit, } = {}) {
+    if (isHandling) {
+        throw new Error(`Only one handleProcessExit per process should be registered!`);
+    }
+    isHandling = true;
+    const processes = [];
+    let cleanupPromise = null;
+    const cleanup = (signal = 'SIGTERM') => {
+        // return existing cleanup promise if already running, so process.exit
+        // override waits for the real cleanup instead of exiting early
+        if (cleanupPromise)
+            return cleanupPromise;
+        cleanupPromise = doCleanup(signal);
+        return cleanupPromise;
+    };
+    const doCleanup = async (signal) => {
+        setExitCleanupState(true);
+        if (onExit) {
+            try {
+                await onExit({ signal });
+            }
+            catch (error) {
+                console.error('Error in exit callback:', error);
+            }
+        }
+        if (processes.length === 0) {
+            return;
+        }
+        const isInterrupt = signal === 'SIGINT';
+        const killSignal = isInterrupt ? 'SIGTERM' : signal;
+        for (const proc of processes) {
+            if (proc.pid) {
+                killProcess(proc.pid, killSignal, isInterrupt);
+            }
+        }
+        // brief wait for graceful shutdown
+        await new Promise((res) => setTimeout(res, isInterrupt ? 80 : 200));
+        // force kill any remaining
+        for (const proc of processes) {
+            if (proc.pid && !proc.exitCode) {
+                killProcess(proc.pid, 'SIGKILL');
+            }
+        }
+        // straggler walk: find any descendants that survived the group kill
+        const trackedPids = processes.map((p) => p.pid).filter(Boolean);
+        if (trackedPids.length > 0) {
+            const stragglers = findStragglers(trackedPids);
+            for (const pid of stragglers) {
+                try {
+                    process.kill(pid, 'SIGKILL');
+                }
+                catch { }
+            }
+        }
+        removePidFile();
+    };
+    const addChildProcess = (proc) => {
+        processes.push(proc);
+        if (proc.pid)
+            writePidFile(proc.pid);
+    };
+    addProcessHandler(addChildProcess);
+    let finalized = false;
+    const finalizeWithSignal = (signal, fallbackCode) => {
+        if (finalized)
+            return;
+        finalized = true;
+        process.off('SIGINT', sigintHandler);
+        process.off('SIGTERM', sigtermHandler);
+        process.off('SIGHUP', sighupHandler);
+        process.off('beforeExit', beforeExitHandler);
+        process.exit = originalExit;
+        try {
+            process.kill(process.pid, signal);
+        }
+        catch {
+            originalExit(fallbackCode);
+        }
+    };
+    const sigtermHandler = () => {
+        cleanup('SIGTERM').then(() => {
+            finalizeWithSignal('SIGTERM', 143);
+        });
+    };
+    const sigintHandler = () => {
+        cleanup('SIGINT').then(() => {
+            finalizeWithSignal('SIGINT', 130);
+        });
+    };
+    const sighupHandler = () => {
+        cleanup('SIGHUP').then(() => {
+            finalizeWithSignal('SIGHUP', 129);
+        });
+    };
+    // intercept process.exit to ensure cleanup completes before exiting.
+    // if cleanup is already running, this awaits the SAME promise instead of
+    // early-returning and calling originalExit prematurely.
+    const originalExit = process.exit;
+    process.exit = ((code) => {
+        cleanup('SIGTERM').then(() => {
+            originalExit(code);
+        });
+    });
+    const beforeExitHandler = () => cleanup('SIGTERM');
+    process.on('beforeExit', beforeExitHandler);
+    process.on('SIGINT', sigintHandler);
+    process.on('SIGTERM', sigtermHandler);
+    process.on('SIGHUP', sighupHandler);
+    const exit = async (code = 0) => {
+        await cleanup('SIGTERM');
+        process.exit(code);
+    };
+    return {
+        addChildProcess,
+        cleanup,
+        exit,
+    };
+}
+//# sourceMappingURL=handle-process-exit.js.map

package/dist/handle-process-exit.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { cmd } from './cmd.js';
+export { handleProcessExit } from './handle-process-exit.js';
+export { run } from './run.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { cmd } from './cmd.js';
+export { handleProcessExit } from './handle-process-exit.js';
+export { run } from './run.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA"}

package/dist/process-state.d.ts

@@ -0,0 +1,8 @@
+import { type ChildProcess } from 'node:child_process';
+export type ProcessType = ChildProcess;
+export type ProcessHandler = (process: ProcessType) => void;
+export declare function setExitCleanupState(state: boolean): void;
+export declare function getIsExiting(): boolean;
+export declare const addProcessHandler: (cb: ProcessHandler) => void;
+export declare function notifyProcessHandlers(proc: ProcessType): void;
+//# sourceMappingURL=process-state.d.ts.map

package/dist/process-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-state.d.ts","sourceRoot":"","sources":["../src/process-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,MAAM,WAAW,GAAG,YAAY,CAAA;AACtC,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;AAK3D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,QAEjD;AAED,wBAAgB,YAAY,YAE3B;AAKD,eAAO,MAAM,iBAAiB,GAAI,IAAI,cAAc,SAEnD,CAAA;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,QAEtD"}

package/dist/process-state.js

@@ -0,0 +1,17 @@
+// shared state: tracks if we're in cleanup (another process failed)
+let isInExitCleanup = false;
+export function setExitCleanupState(state) {
+    isInExitCleanup = state;
+}
+export function getIsExiting() {
+    return isInExitCleanup;
+}
+// handlers called when any process is spawned via run()
+const processHandlers = new Set();
+export const addProcessHandler = (cb) => {
+    processHandlers.add(cb);
+};
+export function notifyProcessHandlers(proc) {
+    processHandlers.forEach((cb) => cb(proc));
+}
+//# sourceMappingURL=process-state.js.map

package/dist/process-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-state.js","sourceRoot":"","sources":["../src/process-state.ts"],"names":[],"mappings":"AAKA,oEAAoE;AACpE,IAAI,eAAe,GAAG,KAAK,CAAA;AAE3B,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,eAAe,GAAG,KAAK,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,eAAe,CAAA;AACxB,CAAC;AAED,wDAAwD;AACxD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAA;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,EAAkB,EAAE,EAAE;IACtD,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACzB,CAAC,CAAA;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAiB;IACrD,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;AAC3C,CAAC"}

package/dist/resolve-script.d.ts

@@ -0,0 +1,26 @@
+export interface FlattenedScript {
+    name: string;
+    command: string;
+    /** true when the script name doesn't exist in package.json */
+    isRaw: boolean;
+    /** scripts to spawn in parallel after command completes successfully */
+    deferredScripts?: FlattenedScript[];
+}
+export interface FlattenOptions {
+    /** scripts already running (from BUN_RUN_SCRIPTS), will be filtered out */
+    runningScripts?: string[];
+}
+/**
+ * split a shell command on &&, ||, ; while respecting quotes.
+ * returns null if no operators found (command is not a compound).
+ */
+export declare function splitCompound(command: string): {
+    segments: string[];
+    operators: string[];
+} | null;
+/**
+ * recursively flatten script references into leaf commands.
+ * resolves o run-all chains AND shell compounds (&&, ;, ||).
+ */
+export declare function flattenScripts(commands: string[], packageJsonScripts: Record<string, string>, options?: FlattenOptions): FlattenedScript[];
+//# sourceMappingURL=resolve-script.d.ts.map

package/dist/resolve-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-script.d.ts","sourceRoot":"","sources":["../src/resolve-script.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAA;IACd,wEAAwE;IACxE,eAAe,CAAC,EAAE,eAAe,EAAE,CAAA;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;CAC1B;AA8BD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAmDpD;AAkBD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAAE,EAClB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,OAAO,CAAC,EAAE,cAAc,GACvB,eAAe,EAAE,CAkGnB"}