starskiff 0.6.1 → 0.7.0

package/README.md

@@ -32,7 +32,7 @@ Inspired by [prool](https://github.com/wevm/prool) (test instances for Ethereum)
 | `Instance.marood()` | **required** — `image` or `binary` (private) | Cosmos SDK + **EVM** + maroo modules      | maroo chain (viem `marooTestnet`) |
 | `Instance.hermes()` | binary `hermes`                        | — (IBC relayer)                                 | Relaying between two instances |
 
-Every instance is **image-first**: where a usable, version-pinned image exists it's the default (Docker required); pass `binary` to run a local executable, or `image` to bind your own. Where none exists (`marood` — private node source) the source is **required**: constructing without `image` or `binary` throws. `hermes` is a relayer run as a host binary, not a chain node. See the docs [container runtime guide](./../docs/src/pages/docs/guides/docker.mdx).
+Every instance is **image-first**: where a usable, version-pinned image exists it's the default (Docker required); pass `binary` to run a local executable, or `image` to bind your own. The two overrides are mutually exclusive in TypeScript and at runtime. Where none exists (`marood` — private node source) exactly one source is **required** by its TypeScript signature, with runtime validation retained for JavaScript callers. `hermes` is a relayer run as a host binary, not a chain node. See the docs [container runtime guide](./../docs/src/pages/docs/guides/docker.mdx).
 
 > `evmd`'s default image is built from cosmos/evm source by the `publish-images` workflow and pinned by multi-arch manifest **digest** — the default always resolves to the exact published artifact.
 
@@ -42,6 +42,8 @@ Every instance is **image-first**: where a usable, version-pinned image exists i
 pnpm add -D starskiff
 ```
 
+starskiff is ESM-only and supports Node.js 22 or newer.
+
 ### Prerequisites
 
 Image-backed instances (`simd`, `wasmd`, `gaiad`, `xplad`, `xrplevm`, `mantra`, `evmd`) need only a running **Docker** — the image is pulled on first use. The `hermes` relayer needs its binary on `PATH` (official releases at [informalsystems/hermes](https://github.com/informalsystems/hermes/releases)); `marood` (no default image) needs an injected source — an `image`, or a binary on `PATH`.
@@ -275,12 +277,20 @@ const instance = Instance.wasmd({ chainId: 'test-1' }, { timeout: 30_000 });
 
 | Method                | Description                                                            |
 | --------------------- | ---------------------------------------------------------------------- |
-| `start()`             | Start the instance. Returns a stop function.                           |
+| `start()`             | Start the instance; resolves when it is ready.                         |
 | `stop()`              | Stop the instance and cleanup temp directory.                          |
 | `restart()`           | Stop then start.                                                       |
 | `on(event, handler)`  | Listen to events (`message`, `stdout`, `stderr`, `listening`, `exit`). |
 | `off(event, handler)` | Remove event listener.                                                 |
 
+Instances also implement `Symbol.asyncDispose`, so `await using` scopes stop
+them automatically:
+
+```ts
+await using instance = Instance.wasmd();
+await instance.start();
+```
+
 ### Instance properties
 
 | Property   | Type     | Description                                                             |
@@ -328,14 +338,9 @@ Recommended: fund multiple accounts in genesis, assign each test its own account
 | State reset  | Helm redeploy (minutes)    | kill + restart (~3s) |
 | Best for     | Production simulation      | Dev/test             |
 
-## TODO
-
-- [ ] `starskiff.config.ts` — config-based chain + relayer declaration
-- [ ] `starskiff/vitest` — vitest plugin (automatic setup/teardown via `vitestPlugin(config)`)
-- [ ] `starskiff/playwright` — playwright plugin (`playwrightPlugin(config)`)
-- [ ] `starskiff/setup-binaries` GitHub Action for CI binary setup
+## Roadmap
 
-Shipped: `cosmosEvmBase` (EVM JSON-RPC instances), `findFreePorts()` (port allocation), the container runtime (`image` parameter).
+See the [roadmap to v1.0](https://github.com/2wheeh/starskiff/blob/main/ROADMAP.md) for planned API, runtime, artifact, and integration work.
 
 ## License
 

package/dist/Instance.d.ts

@@ -27,8 +27,8 @@ export type Instance = {
         /** Get all buffered messages. */
         get(): string[];
     };
-    /** Start the instance. Returns a stop function. */
-    start(): Promise<() => void>;
+    /** Start the instance. */
+    start(): Promise<void>;
     /** Stop the instance and clean up resources. */
     stop(): Promise<void>;
     /** Stop then start the instance. */
@@ -37,6 +37,8 @@ export type Instance = {
     on: Emitter<EventTypes>['on'];
     /** Unsubscribe from instance events. */
     off: Emitter<EventTypes>['off'];
+    /** Stop the instance when leaving an `await using` scope. */
+    [Symbol.asyncDispose](): Promise<void>;
 };
 export type InstanceOptions = {
     /** Number of messages to store in-memory. @default 20 */
@@ -49,29 +51,43 @@ export type InstanceStartOptions = {
 };
 export type InstanceStartContext = {
     emitter: Emitter<EventTypes>;
+    /** Aborted when the managed start operation times out. */
+    signal: AbortSignal;
+    /** Record the active startup phase for actionable failure diagnostics. */
+    setStartDiagnostics(diagnostics: InstanceStartDiagnostics): void;
     setEndpoint?(endpoint: {
         host?: string;
         port?: number;
     }): void;
     status: InstanceStatus;
 };
+export type InstanceStartDiagnostics = {
+    /** Human-readable startup phase, such as `init` or `readiness`. */
+    phase: string;
+    /** Logical command, excluding runtime wrappers and injected environment. */
+    command?: string;
+};
 export type InstanceStopContext = {
     emitter: Emitter<EventTypes>;
     status: InstanceStatus;
 };
-type DefineFnResult = {
+/** Values supplied by an instance definition before lifecycle management is applied. */
+export type InstanceDefinition = {
     name: string;
     host: string;
     port: number;
     start(options: InstanceStartOptions, context: InstanceStartContext): Promise<void>;
     stop(context: InstanceStopContext): Promise<void>;
 };
+/** Callable returned by {@link define}. */
+export type InstanceFactory<P, R extends InstanceDefinition = InstanceDefinition> = (...args: undefined extends P ? [parameters?: P, options?: InstanceOptions] : [parameters: P, options?: InstanceOptions]) => Omit<R, keyof Instance> & Instance;
 /**
  * Creates an instance definition.
  *
- * Takes a factory function that returns the instance's name, host, port,
- * and start/stop implementations. Returns a callable that creates
- * managed instances with lifecycle control.
+ * Takes a definition function that returns the instance's name, host, port,
+ * and start/stop implementations. The returned callable always treats its
+ * first argument as definition parameters and its second as lifecycle
+ * options. For a parameterless definition, pass `undefined` before options.
  *
  * @example
  * ```ts
@@ -79,14 +95,15 @@ type DefineFnResult = {
  *   name: 'simd',
  *   host: 'localhost',
  *   port: 26657,
+ *   chainId: params?.chainId ?? 'test-1',
  *   async start(opts, ctx) { ... },
  *   async stop(ctx) { ... },
  * }))
  *
- * const instance = simd({ chainId: 'test-1' })
+ * const instance = simd({ chainId: 'test-1' }, { timeout: 30_000 })
  * instance.chainId // string — extra field preserved
  * await instance.start()
  * ```
  */
-export declare function define<P = undefined, R extends DefineFnResult = DefineFnResult>(fn: (parameters: P) => R): (...args: P extends undefined ? [options?: InstanceOptions] : [parameters: P, options?: InstanceOptions]) => Omit<R, keyof DefineFnResult> & Instance;
+export declare function define<P = undefined, R extends InstanceDefinition = InstanceDefinition>(fn: (parameters: P) => R): InstanceFactory<P, R>;
 //# sourceMappingURL=Instance.d.ts.map

package/dist/Instance.d.ts.map

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

package/dist/Instance.js

@@ -8,12 +8,36 @@ export { xrplevm } from './instances/xrplevm.js';
 export { evmd } from './instances/evmd.js';
 export { marood } from './instances/marood.js';
 export { hermes } from './instances/hermes.js';
+const DIAGNOSTIC_OUTPUT_LIMIT = 64 * 1024;
+const DIAGNOSTIC_LINE_LIMIT = 50;
+function outputTail(output) {
+    const normalized = output.slice(-DIAGNOSTIC_OUTPUT_LIMIT).trimEnd();
+    if (!normalized)
+        return undefined;
+    return normalized.split(/\r?\n/).slice(-DIAGNOSTIC_LINE_LIMIT).join('\n');
+}
+function startError(name, cause, diagnostics, output, timedOut) {
+    const phase = diagnostics ? ` during ${diagnostics.phase}` : '';
+    const lines = [
+        `Instance "${name}" failed to start${timedOut ? ' in time' : ''}${phase}.`,
+    ];
+    if (diagnostics?.command)
+        lines.push(`command: ${diagnostics.command}`);
+    const detail = outputTail(cause instanceof Error ? cause.message : String(cause));
+    if (!timedOut && detail)
+        lines.push(`details:\n${detail}`);
+    const tail = outputTail(output);
+    if (tail)
+        lines.push(`last ${DIAGNOSTIC_LINE_LIMIT} lines:\n${tail}`);
+    return new Error(lines.join('\n'), { cause });
+}
 /**
  * Creates an instance definition.
  *
- * Takes a factory function that returns the instance's name, host, port,
- * and start/stop implementations. Returns a callable that creates
- * managed instances with lifecycle control.
+ * Takes a definition function that returns the instance's name, host, port,
+ * and start/stop implementations. The returned callable always treats its
+ * first argument as definition parameters and its second as lifecycle
+ * options. For a parameterless definition, pass `undefined` before options.
  *
  * @example
  * ```ts
@@ -21,43 +45,69 @@ export { hermes } from './instances/hermes.js';
  *   name: 'simd',
  *   host: 'localhost',
  *   port: 26657,
+ *   chainId: params?.chainId ?? 'test-1',
  *   async start(opts, ctx) { ... },
  *   async stop(ctx) { ... },
  * }))
  *
- * const instance = simd({ chainId: 'test-1' })
+ * const instance = simd({ chainId: 'test-1' }, { timeout: 30_000 })
  * instance.chainId // string — extra field preserved
  * await instance.start()
  * ```
  */
 export function define(fn) {
-    return (...[parametersOrOptions, options_]) => {
-        const isInstanceOptions = (v) => v != null && typeof v === 'object' && ('messageBuffer' in v || 'timeout' in v);
-        // When P = undefined: (options?) → first arg is options
-        // When P is defined: (params, options?) → first arg is params, second is options
-        const parameters = (options_ !== undefined || !isInstanceOptions(parametersOrOptions)
-            ? parametersOrOptions
-            : undefined);
-        const options = options_ ?? (isInstanceOptions(parametersOrOptions) ? parametersOrOptions : {});
+    return ((parameters, options = {}) => {
         const raw = fn(parameters);
         const { name, start, stop } = raw;
         let host = raw.host;
         let port = raw.port;
         const { messageBuffer = 20, timeout = 60_000 } = options;
-        let startResolver = Promise.withResolvers();
-        let stopResolver = Promise.withResolvers();
-        let restartResolver = Promise.withResolvers();
+        let startOperation;
+        let stopOperation;
+        let stopCleanupOperation;
+        let restartOperation;
         const emitter = mitt();
         let messages = [];
+        let diagnosticOutput = '';
+        let startDiagnostics;
         let status = 'idle';
         let restarting = false;
         const onMessage = (message) => {
             messages.push(message);
             if (messages.length > messageBuffer)
                 messages.shift();
+            diagnosticOutput += message;
+            if (diagnosticOutput.length > DIAGNOSTIC_OUTPUT_LIMIT) {
+                diagnosticOutput = diagnosticOutput.slice(-DIAGNOSTIC_OUTPUT_LIMIT);
+            }
+        };
+        const onListening = () => {
+            if (status === 'starting')
+                status = 'started';
+        };
+        const onExit = () => {
+            // A managed stop owns the transition to `stopped` after all cleanup is
+            // complete. Exit events only represent an unexpected running-process
+            // exit; changing state while `stopping` would reopen start too early.
+            if (status === 'started')
+                status = 'stopped';
+        };
+        const subscribe = () => {
+            emitter.on('message', onMessage);
+            emitter.on('listening', onListening);
+            emitter.on('exit', onExit);
+        };
+        const unsubscribe = () => {
+            emitter.off('message', onMessage);
+            emitter.off('listening', onListening);
+            emitter.off('exit', onExit);
+        };
+        const clearRuntimeState = () => {
+            self.messages.clear();
+            diagnosticOutput = '';
+            startDiagnostics = undefined;
+            unsubscribe();
         };
-        const onListening = () => { status = 'started'; };
-        const onExit = () => { status = 'stopped'; };
         const self = {
             get host() { return host; },
             name,
@@ -72,138 +122,164 @@ export function define(fn) {
                 get() { return [...messages]; },
             },
             async start() {
-                if (status === 'starting')
-                    return startResolver.promise;
+                if (status === 'starting' && startOperation)
+                    return startOperation;
                 if (status !== 'idle' && status !== 'stopped')
                     throw new Error(`Instance "${name}" is not in an idle or stopped state. Status: ${status}`);
-                let startTimer;
-                // Guards the in-flight start(...) call's .then/.catch below: once the
-                // timeout fires, status/resolvers have already been reset (and a
-                // retry may be in flight), so a late settle must not touch them.
-                let timedOut = false;
-                if (typeof timeout === 'number') {
-                    startTimer = setTimeout(() => {
-                        timedOut = true;
-                        status = 'idle';
-                        self.messages.clear();
-                        emitter.off('message', onMessage);
-                        emitter.off('listening', onListening);
-                        emitter.off('exit', onExit);
-                        startResolver.reject(new Error(`Instance "${name}" failed to start in time.`));
-                        startResolver = Promise.withResolvers();
-                        // Best-effort: the child may still be running post-timeout, so
-                        // ask the underlying stop to tear it down. Never let this throw —
-                        // the instance must remain retryable regardless of the outcome.
-                        try {
-                            void stop({ emitter, status: self.status }).catch(() => { });
-                        }
-                        catch {
-                            // ignore
-                        }
-                    }, timeout);
-                }
-                emitter.on('message', onMessage);
-                emitter.on('listening', onListening);
-                emitter.on('exit', onExit);
                 status = 'starting';
-                start({ port }, {
-                    emitter,
-                    setEndpoint(endpoint) {
-                        if (endpoint.host)
-                            host = endpoint.host;
-                        if (endpoint.port)
-                            port = endpoint.port;
-                    },
-                    status: self.status,
-                })
-                    .then(() => {
-                    if (startTimer)
-                        clearTimeout(startTimer);
-                    if (timedOut)
-                        return;
-                    status = 'started';
-                    stopResolver = Promise.withResolvers();
-                    startResolver.resolve(self.stop.bind(self));
-                })
-                    .catch((error) => {
-                    if (startTimer)
-                        clearTimeout(startTimer);
-                    if (timedOut)
-                        return;
-                    status = 'idle';
-                    self.messages.clear();
-                    emitter.off('message', onMessage);
-                    emitter.off('listening', onListening);
-                    emitter.off('exit', onExit);
-                    startResolver.reject(error);
-                    startResolver = Promise.withResolvers();
-                });
-                return startResolver.promise;
+                diagnosticOutput = '';
+                startDiagnostics = undefined;
+                subscribe();
+                const controller = new AbortController();
+                startOperation = (async () => {
+                    let startTimer;
+                    let timedOut = false;
+                    const startTimeout = new Promise((_, reject) => {
+                        startTimer = setTimeout(() => {
+                            timedOut = true;
+                            const timeoutCause = new Error(`Instance "${name}" exceeded its ${timeout}ms start timeout.`);
+                            const error = startError(name, timeoutCause, startDiagnostics, diagnosticOutput, true);
+                            controller.abort(error);
+                            reject(error);
+                        }, timeout);
+                    });
+                    const rawStart = Promise.resolve().then(() => start({ port }, {
+                        emitter,
+                        signal: controller.signal,
+                        setStartDiagnostics(diagnostics) {
+                            startDiagnostics = { ...diagnostics };
+                        },
+                        setEndpoint(endpoint) {
+                            if (endpoint.host !== undefined)
+                                host = endpoint.host;
+                            if (endpoint.port !== undefined)
+                                port = endpoint.port;
+                        },
+                        status: self.status,
+                    }));
+                    try {
+                        await Promise.race([rawStart, startTimeout]);
+                        status = 'started';
+                    }
+                    catch (error) {
+                        if (!timedOut) {
+                            status = 'idle';
+                            const enriched = startDiagnostics
+                                ? startError(name, error, startDiagnostics, diagnosticOutput, false)
+                                : error;
+                            clearRuntimeState();
+                            throw enriched;
+                        }
+                        // A timed-out start is not retryable until its teardown finishes.
+                        // Keeping the instance in `stopping` prevents an old child from
+                        // racing with a new start and overwriting shared runtime state.
+                        status = 'stopping';
+                        stopCleanupOperation = Promise.resolve()
+                            .then(() => stop({ emitter, status: self.status }))
+                            .then(() => {
+                            status = 'idle';
+                            clearRuntimeState();
+                        }, () => {
+                            // Startup never completed, so keep new starts blocked. A
+                            // later stop() can retry teardown from this state.
+                            status = 'stopping';
+                        })
+                            .finally(() => {
+                            startOperation = undefined;
+                            stopCleanupOperation = undefined;
+                        });
+                        throw error;
+                    }
+                    finally {
+                        if (startTimer)
+                            clearTimeout(startTimer);
+                        if (!timedOut)
+                            startOperation = undefined;
+                    }
+                })();
+                return startOperation;
             },
             async stop() {
-                if (status === 'stopping')
-                    return stopResolver.promise;
+                if (status === 'stopping' && stopOperation)
+                    return stopOperation;
+                if (status === 'stopping' && stopCleanupOperation) {
+                    await stopCleanupOperation;
+                    const settledStatus = status;
+                    if (settledStatus === 'idle' || settledStatus === 'stopped')
+                        return;
+                    return self.stop();
+                }
                 if (status === 'starting')
                     throw new Error(`Instance "${name}" is starting.`);
-                let stopTimer;
-                if (typeof timeout === 'number') {
-                    stopTimer = setTimeout(() => {
-                        stopResolver.reject(new Error(`Instance "${name}" failed to stop in time.`));
-                    }, timeout);
-                }
                 status = 'stopping';
-                stop({
-                    emitter,
-                    status: self.status,
-                })
-                    .then((...args) => {
-                    if (stopTimer)
-                        clearTimeout(stopTimer);
-                    status = 'stopped';
-                    self.messages.clear();
-                    emitter.off('message', onMessage);
-                    emitter.off('listening', onListening);
-                    emitter.off('exit', onExit);
-                    startResolver = Promise.withResolvers();
-                    stopResolver.resolve(...args);
-                })
-                    .catch((error) => {
-                    if (stopTimer)
-                        clearTimeout(stopTimer);
-                    status = 'started';
-                    stopResolver.reject(error);
-                    stopResolver = Promise.withResolvers();
-                });
-                return stopResolver.promise;
+                stopOperation = (async () => {
+                    let stopTimer;
+                    let timedOut = false;
+                    const stopTimeout = new Promise((_, reject) => {
+                        stopTimer = setTimeout(() => {
+                            timedOut = true;
+                            reject(new Error(`Instance "${name}" failed to stop in time.`));
+                        }, timeout);
+                    });
+                    const rawStop = Promise.resolve().then(() => stop({ emitter, status: self.status }));
+                    try {
+                        await Promise.race([rawStop, stopTimeout]);
+                        status = 'stopped';
+                        clearRuntimeState();
+                    }
+                    catch (error) {
+                        if (!timedOut) {
+                            status = 'started';
+                        }
+                        else {
+                            // Keep `stopping` until the original teardown settles. A stop
+                            // timeout must not make a still-running instance restartable.
+                            stopCleanupOperation = rawStop
+                                .then(() => {
+                                status = 'stopped';
+                                clearRuntimeState();
+                            })
+                                .catch(() => {
+                                status = 'started';
+                            })
+                                .finally(() => {
+                                stopCleanupOperation = undefined;
+                            });
+                        }
+                        throw error;
+                    }
+                    finally {
+                        if (stopTimer)
+                            clearTimeout(stopTimer);
+                        stopOperation = undefined;
+                    }
+                })();
+                return stopOperation;
             },
             async restart() {
-                if (restarting)
-                    return restartResolver.promise;
+                if (restarting && restartOperation)
+                    return restartOperation;
                 restarting = true;
-                self.stop()
+                restartOperation = self.stop()
                     .then(() => self.start())
-                    .then(() => {
-                    restarting = false;
-                    restartResolver.resolve();
-                    restartResolver = Promise.withResolvers();
-                })
-                    .catch((error) => {
+                    .then(() => { })
+                    .finally(() => {
                     restarting = false;
-                    restartResolver.reject(error);
-                    restartResolver = Promise.withResolvers();
+                    restartOperation = undefined;
                 });
-                return restartResolver.promise;
+                return restartOperation;
             },
             on: emitter.on.bind(emitter),
             off: emitter.off.bind(emitter),
+            [Symbol.asyncDispose]() {
+                return self.stop();
+            },
         };
-        const knownKeys = new Set(['name', 'host', 'port', 'start', 'stop']);
-        const extra = {};
-        for (const key of Object.keys(raw)) {
-            if (!knownKeys.has(key))
-                extra[key] = raw[key];
-        }
-        return Object.assign(self, extra);
-    };
+        const knownKeys = new Set(Reflect.ownKeys(self));
+        const extraDescriptors = Object.fromEntries(Reflect.ownKeys(raw)
+            .filter((key) => !knownKeys.has(key))
+            .map((key) => [key, Object.getOwnPropertyDescriptor(raw, key)]));
+        return Object.defineProperties(self, extraDescriptors);
+    });
 }
 //# sourceMappingURL=Instance.js.map

package/dist/Instance.js.map

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