@grest-ts/testkit 0.0.5

package/dist/src/GGTestRunner.js

@@ -0,0 +1,242 @@
+import { GGLog } from "@grest-ts/logger";
+import { GGContext } from "@grest-ts/context";
+import { GG_TRACE } from "@grest-ts/trace";
+import { GGLocatorKey } from "@grest-ts/locator";
+import { TestableIPC } from "./callOn/TestableIPC.js";
+export const GG_TEST_RUNNER = new GGLocatorKey("GGTestRunner");
+/**
+ * Symbol for resources that support test operations.
+ * Resources implement this to expose operations like clone().
+ */
+export const GG_TEST_RESOURCE = Symbol('GG_TEST_RESOURCE');
+export class GGTestRunner {
+    /**
+     * Unique identifier for this test context.
+     * Used for test resource isolation (e.g., creating isolated DB schemas).
+     */
+    testId;
+    ipcServer;
+    discoveryServer;
+    config = {
+        serviceStartupTimeout: 30000,
+        verboseProxy: false
+    };
+    _started = false;
+    /**
+     * Runtimes added in the describe block (before start).
+     * These are managed by beforeAll/afterAll.
+     */
+    globalRuntimes = [];
+    /**
+     * Runtimes added within test blocks (after start).
+     * These are managed by afterEach and cleared after each test.
+     */
+    inTestRuntimes = [];
+    /**
+     * Extension instances - extensions are some "describe block level components".
+     * Some examples EventsServer, HttpInterceptorsServer, MockableInterceptorsServer etc.
+     */
+    extensionInstances = new Map();
+    hooks = new Map();
+    constructor(ipcServer, discoveryServer, userConfig) {
+        this.testId = "t" + Math.random().toString(36).substring(2, 8);
+        this.config = { ...this.config, ...userConfig };
+        this.ipcServer = ipcServer;
+        this.discoveryServer = discoveryServer;
+        // Register IPC handler for key registration from workers
+        this.ipcServer.onFrameworkMessage(TestableIPC.server.registerKeys, async (payload) => {
+            const runtime = this.getRuntimeById(payload.runtimeId);
+            if (runtime) {
+                runtime.registerLocatorKeys(payload.keys);
+                GGLog.debug(this, `Registered ${payload.keys.length} keys for runtime ${payload.runtimeId}`);
+            }
+            else {
+                GGLog.warn(this, `Received key registration for unknown runtime: ${payload.runtimeId}`);
+            }
+        });
+    }
+    // -----------------------------------------------
+    // Static component factory registry
+    // -----------------------------------------------
+    /**
+     * Extension factories - extensions are some "describe block level components".
+     * Some examples EventsServer, HttpInterceptorsServer, MockableInterceptorsServer etc.
+     */
+    static extensionFactories = [];
+    /**
+     * Register a component type.
+     * Components must accept GGTestRunner as their constructor argument.
+     */
+    static registerExtension(type) {
+        this.extensionFactories.push(type);
+    }
+    // -----------------------------------------------
+    // Component registry
+    // -----------------------------------------------
+    /**
+     * Get a component by type. Creates it lazily if not yet instantiated.
+     */
+    getExtensionInstance(type) {
+        if (!this.extensionInstances.has(type)) {
+            const instance = new type(this);
+            this.extensionInstances.set(type, instance);
+        }
+        return this.extensionInstances.get(type);
+    }
+    // -----------------------------------------------
+    // Instance methods
+    // -----------------------------------------------
+    /**
+     * Whether the test has started (services are running).
+     */
+    get started() {
+        return this._started;
+    }
+    /**
+     * Register a test lifecycle hook.
+     * Hooks run beforeAll (during start) and afterAll (during teardown).
+     * Duplicate registrations with the same keyName are skipped.
+     */
+    registerHook(hook) {
+        if (this.hooks.has(hook.keyName)) {
+            GGLog.debug(this, `Hook already registered for ${hook.keyName}, skipping duplicate`);
+            return;
+        }
+        this.hooks.set(hook.keyName, hook);
+    }
+    /**
+     * Send a command to ALL runtimes.
+     * Used by resource hooks (e.g., DB config) that apply globally.
+     */
+    async sendCommand(type, payload) {
+        const promises = this.globalRuntimes.map(runtime => runtime.sendCommand(type, payload));
+        await Promise.allSettled(promises);
+    }
+    /**
+     * Add a runtime to this test runner.
+     * Automatically routes to the appropriate list based on lifecycle stage.
+     */
+    addRuntime(runtime) {
+        if (this._started) {
+            // Added within a test block - managed by afterEach
+            this.inTestRuntimes.push(runtime);
+        }
+        else {
+            // Added in describe block - managed by beforeAll/afterAll
+            this.globalRuntimes.push(runtime);
+        }
+    }
+    /**
+     * Get all active runtimes (both global and in-test).
+     */
+    getAllRuntimes() {
+        return [...this.globalRuntimes, ...this.inTestRuntimes];
+    }
+    /**
+     * Find a runtime by its unique runtimeId.
+     */
+    getRuntimeById(runtimeId) {
+        return this.globalRuntimes.find(r => r.runtimeId === runtimeId)
+            ?? this.inTestRuntimes.find(r => r.runtimeId === runtimeId);
+    }
+    async start() {
+        await new GGContext("Test").run(async () => {
+            GG_TRACE.init();
+            if (this._started) {
+                throw new Error("Already started!");
+            }
+            // 0. Initialize extension (testkits already loaded by vitest setup)
+            for (const type of GGTestRunner.extensionFactories) {
+                // Create extension instance, which registers its IPC handlers
+                this.extensionInstances.set(type, new type(this));
+            }
+            // 1. Execute all hook beforeAll handlers in parallel
+            const hookPromises = Array.from(this.hooks.entries()).map(async ([keyName, hook]) => {
+                const startTime = performance.now();
+                GGLog.debug(this, `Running beforeAll hook: ${keyName}`);
+                await hook.beforeAll();
+                const duration = (performance.now() - startTime).toFixed(0);
+                GGLog.debug(this, `Completed beforeAll hook: ${keyName} (${duration}ms)`);
+                return keyName;
+            });
+            const results = await Promise.allSettled(hookPromises);
+            const failures = results.filter((r) => r.status === 'rejected');
+            if (failures.length > 0) {
+                const errorMessages = failures.map(f => {
+                    const reason = f.reason;
+                    if (reason instanceof AggregateError) {
+                        const innerErrors = reason.errors?.map((e) => e?.message || String(e)).join(', ');
+                        return `AggregateError[${innerErrors}]`;
+                    }
+                    return reason?.message || String(reason);
+                }).join('; ');
+                throw new Error(`Failed to run beforeAll hooks: ${errorMessages}`);
+            }
+            // 2. Start router
+            await this.discoveryServer.start();
+            // 3. Start components
+            for (const [type, component] of this.extensionInstances) {
+                if (component.start) {
+                    GGLog.debug(this, `Starting component: ${type.name}`);
+                    await component.start();
+                }
+            }
+            // 4. Start runtimes (they will receive commands via env)
+            for (const runtime of this.globalRuntimes) {
+                await runtime.start();
+            }
+            this._started = true;
+        });
+    }
+    async runAfterEachHooks() {
+        for (const [, component] of this.extensionInstances) {
+            await component.afterEach?.();
+        }
+        GGLog.debug(this, 'Stopping in-test runtimes...');
+        for (const runtime of this.inTestRuntimes) {
+            await runtime.shutdown();
+        }
+        this.inTestRuntimes.length = 0;
+        GGLog.debug(this, 'All in-test runtimes stopped!');
+    }
+    async teardown() {
+        await new GGContext("Test").run(async () => {
+            GG_TRACE.init();
+            // Stop global runtimes (teardown services, keep IPC alive)
+            GGLog.debug(this, 'Stopping global runtimes...');
+            for (const runtime of this.globalRuntimes) {
+                await runtime.stop();
+            }
+            // Shutdown global runtimes (terminate workers/processes)
+            GGLog.debug(this, 'Shutting down global runtimes...');
+            for (const runtime of this.globalRuntimes) {
+                await runtime.shutdown();
+            }
+            GGLog.debug(this, 'Tearing down router...');
+            await this.discoveryServer.teardown();
+            // Teardown components
+            for (const [type, component] of this.extensionInstances) {
+                if (component.teardown) {
+                    GGLog.debug(this, `Tearing down component: ${type.name}`);
+                    await component.teardown();
+                }
+            }
+            this.extensionInstances.clear();
+            GGLog.debug(this, 'Router torn down');
+            // Run afterAll hooks
+            GGLog.debug(this, 'Running afterAll hooks...');
+            for (const [keyName, hook] of this.hooks) {
+                try {
+                    await hook.afterAll();
+                    GGLog.debug(this, `Completed afterAll hook: ${keyName}`);
+                }
+                catch (error) {
+                    GGLog.error(this, `Failed afterAll hook ${keyName}:`, error);
+                }
+            }
+            this.globalRuntimes.length = 0;
+            this.hooks.clear();
+        });
+    }
+}
+//# sourceMappingURL=GGTestRunner.js.map

package/dist/src/GGTestRunner.js.map

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

package/dist/src/GGTestRuntime.d.ts

@@ -0,0 +1,103 @@
+import { IPCClientRequest } from "@grest-ts/ipc";
+import type { GGTestRunner } from "./GGTestRunner";
+/**
+ * Lifecycle state of a runtime instance.
+ */
+export declare enum GGTestRuntimeState {
+    /** Initial state, not yet started */
+    CREATED = "created",
+    /** Running successfully */
+    STARTED = "started",
+    /** Startup failed, but worker/IPC still alive for diagnostics */
+    FAILED = "failed",
+    /** Runtime stopped, but worker/IPC still alive for log retrieval */
+    STOPPED = "stopped",
+    /** Fully shut down, no IPC available */
+    SHUTDOWN = "shutdown"
+}
+export interface GGTestEnvConfig {
+    executablePath: string;
+    className: string;
+    testRouterPort: number;
+    testId: string;
+    runtimeId: string;
+    initialCommands: GGTestCommand[];
+    /** When true, the runtime runs inline (same process). Affects module loading strategy. */
+    inline?: boolean;
+}
+export interface GGTestCommand<Payload = unknown> {
+    method: string;
+    payload: Payload;
+}
+export interface GGTestRuntimeConfig {
+    mode?: GGTestMode;
+}
+export declare enum GGTestMode {
+    INLINE = "INLINE",
+    WORKER = "WORKER",
+    ISOLATED = "ISOLATED"
+}
+export declare class GGTestRuntime {
+    readonly runner: GGTestRunner;
+    /**
+     * Unique identifier for this runtime instance.
+     * Used for targeted communication (e.g., "checklist-0", "checklist-1").
+     */
+    readonly runtimeId: string;
+    /**
+     * The runtime name used for selector access (e.g., "checklist").
+     * This is the static NAME property from the runtime class.
+     */
+    readonly name: string;
+    /**
+     * The class name of the runtime (e.g., "ChecklistRuntime").
+     * Used for file matching and logging.
+     */
+    readonly className: string;
+    /**
+     * Lifecycle state of this runtime instance.
+     */
+    private _state;
+    get state(): GGTestRuntimeState;
+    /**
+     * Locator keys registered by this runtime.
+     * Populated via IPC after compose completes.
+     */
+    private readonly registeredLocatorKeys;
+    /**
+     * Commands to be sent to this runtime on startup.
+     * Queued before start(), passed to worker via env.
+     */
+    private readonly initialCommands;
+    private readonly executablePath;
+    private readonly config;
+    private runtimeRunner?;
+    /** Factory to create the runtime without dynamic import (used by inline mode) */
+    runtimeFactory?: () => any;
+    /** Counter for generating unique runtime IDs per name */
+    private static runtimeCounters;
+    constructor(runner: GGTestRunner, executablePath: string, className: string, name: string, config?: GGTestRuntimeConfig);
+    private static generateRuntimeId;
+    start(): Promise<this>;
+    /**
+     * Stop the GGRuntime (teardown services) but keep worker/IPC alive.
+     * This allows log retrieval after the runtime has stopped.
+     * Idempotent - safe to call multiple times.
+     */
+    stop(): Promise<void>;
+    /**
+     * Fully shutdown the runtime and worker. IPC will be disconnected.
+     * After this, no commands can be sent.
+     */
+    shutdown(): Promise<void>;
+    sendCommand<Payload, Result>(type: IPCClientRequest<Payload, Result>, payload: Payload): Promise<Result>;
+    /**
+     * Register multiple locator keys at once.
+     */
+    registerLocatorKeys(keys: string[]): void;
+    /**
+     * Check if this runtime has a specific locator key.
+     */
+    hasLocatorKey(key: string): boolean;
+}
+//# sourceMappingURL=GGTestRuntime.d.ts.map

package/dist/src/GGTestRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGTestRuntime.d.ts","sourceRoot":"","sources":["../../src/GGTestRuntime.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAK/C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,oBAAY,kBAAkB;IAC1B,qCAAqC;IACrC,OAAO,YAAY;IACnB,2BAA2B;IAC3B,OAAO,YAAY;IACnB,iEAAiE;IACjE,MAAM,WAAW;IACjB,oEAAoE;IACpE,OAAO,YAAY;IACnB,wCAAwC;IACxC,QAAQ,aAAa;CACxB;AAED,MAAM,WAAW,eAAe;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,OAAO;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAChC,IAAI,CAAC,EAAE,UAAU,CAAA;CACpB;AAED,oBAAY,UAAU;IAClB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,QAAQ,aAAa;CACxB;AAED,qBAAa,aAAa;IAEtB,SAAgB,MAAM,EAAE,YAAY,CAAC;IAErC;;;OAGG;IACH,SAAgB,SAAS,EAAE,MAAM,CAAA;IAEjC;;;OAGG;IACH,SAAgB,IAAI,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,SAAgB,SAAS,EAAE,MAAM,CAAA;IAEjC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAiD;IAE/D,IAAW,KAAK,IAAI,kBAAkB,CAErC;IAED;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAyB;IAE/D;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;IAEtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,iFAAiF;IAC1E,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC;IAElC,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,eAAe,CAAkC;gBAE7C,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB;IAW9H,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAMnB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiDnC;;;;OAIG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BlC;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBzB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBrH;;OAEG;IACI,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAMhD;;OAEG;IACI,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CAI7C"}

package/dist/src/GGTestRuntime.js

@@ -0,0 +1,219 @@
+import { GGLog } from "@grest-ts/logger";
+import { withTimeout } from "@grest-ts/common";
+import { GGContext } from "@grest-ts/context";
+import { GG_TRACE } from "@grest-ts/trace";
+import { InlineRunner } from "./runner/InlineRunner.js";
+import { WorkerRunner } from "./runner/WorkerRunner.js";
+import { IsolatedRunner } from "./runner/IsolatedRunner.js";
+/**
+ * Lifecycle state of a runtime instance.
+ */
+export var GGTestRuntimeState;
+(function (GGTestRuntimeState) {
+    /** Initial state, not yet started */
+    GGTestRuntimeState["CREATED"] = "created";
+    /** Running successfully */
+    GGTestRuntimeState["STARTED"] = "started";
+    /** Startup failed, but worker/IPC still alive for diagnostics */
+    GGTestRuntimeState["FAILED"] = "failed";
+    /** Runtime stopped, but worker/IPC still alive for log retrieval */
+    GGTestRuntimeState["STOPPED"] = "stopped";
+    /** Fully shut down, no IPC available */
+    GGTestRuntimeState["SHUTDOWN"] = "shutdown";
+})(GGTestRuntimeState || (GGTestRuntimeState = {}));
+export var GGTestMode;
+(function (GGTestMode) {
+    GGTestMode["INLINE"] = "INLINE";
+    GGTestMode["WORKER"] = "WORKER";
+    GGTestMode["ISOLATED"] = "ISOLATED";
+})(GGTestMode || (GGTestMode = {}));
+export class GGTestRuntime {
+    runner;
+    /**
+     * Unique identifier for this runtime instance.
+     * Used for targeted communication (e.g., "checklist-0", "checklist-1").
+     */
+    runtimeId;
+    /**
+     * The runtime name used for selector access (e.g., "checklist").
+     * This is the static NAME property from the runtime class.
+     */
+    name;
+    /**
+     * The class name of the runtime (e.g., "ChecklistRuntime").
+     * Used for file matching and logging.
+     */
+    className;
+    /**
+     * Lifecycle state of this runtime instance.
+     */
+    _state = GGTestRuntimeState.CREATED;
+    get state() {
+        return this._state;
+    }
+    /**
+     * Locator keys registered by this runtime.
+     * Populated via IPC after compose completes.
+     */
+    registeredLocatorKeys = new Set();
+    /**
+     * Commands to be sent to this runtime on startup.
+     * Queued before start(), passed to worker via env.
+     */
+    initialCommands = [];
+    executablePath;
+    config;
+    runtimeRunner;
+    /** Factory to create the runtime without dynamic import (used by inline mode) */
+    runtimeFactory;
+    /** Counter for generating unique runtime IDs per name */
+    static runtimeCounters = new Map();
+    constructor(runner, executablePath, className, name, config) {
+        this.executablePath = executablePath;
+        this.className = className;
+        this.name = name;
+        this.runtimeId = GGTestRuntime.generateRuntimeId(name);
+        this.config = config ?? {};
+        this.config.mode ??= GGTestMode.WORKER;
+        this.runner = runner;
+        this.runner.addRuntime(this);
+    }
+    static generateRuntimeId(name) {
+        const count = GGTestRuntime.runtimeCounters.get(name) ?? 0;
+        GGTestRuntime.runtimeCounters.set(name, count + 1);
+        return `${name}-${count}`;
+    }
+    async start() {
+        if (this._state !== GGTestRuntimeState.CREATED) {
+            throw new Error("Can only start runtimes if they are in CREATED state! Current state: " + this._state);
+        }
+        await new GGContext("Test").run(async () => {
+            GG_TRACE.init();
+            GGLog.debug(this, 'Launching ' + this.className + ' in ' + this.config.mode + ' mode...');
+            const config = {
+                executablePath: this.executablePath,
+                className: this.className,
+                testRouterPort: this.runner.ipcServer.getPort(),
+                testId: this.runner.testId,
+                runtimeId: this.runtimeId,
+                initialCommands: this.initialCommands
+            };
+            switch (this.config.mode) {
+                case GGTestMode.INLINE:
+                    config.inline = true;
+                    this.runtimeRunner = new InlineRunner(config, this.runtimeFactory);
+                    break;
+                case GGTestMode.WORKER:
+                    this.runtimeRunner = new WorkerRunner(config);
+                    break;
+                case GGTestMode.ISOLATED:
+                    this.runtimeRunner = new IsolatedRunner(config);
+                    break;
+                default:
+                    throw new Error(`Unknown test mode: ${this.config.mode}`);
+            }
+            const startupTimeout = 30000;
+            try {
+                await withTimeout(this.runtimeRunner.start(), startupTimeout, 'Service ' + this.className + ' failed to start within ' + startupTimeout + 'ms');
+                this._state = GGTestRuntimeState.STARTED;
+                GGLog.debug(this, this.className + ' started successfully');
+            }
+            catch (error) {
+                // Mark as failed but keep runner alive for diagnostics (e.g., log retrieval)
+                this._state = GGTestRuntimeState.FAILED;
+                throw error;
+            }
+        });
+        return this;
+    }
+    /**
+     * Stop the GGRuntime (teardown services) but keep worker/IPC alive.
+     * This allows log retrieval after the runtime has stopped.
+     * Idempotent - safe to call multiple times.
+     */
+    async stop() {
+        await new GGContext("Test").run(async () => {
+            GG_TRACE.init();
+            if (this._state === GGTestRuntimeState.STOPPED || this._state === GGTestRuntimeState.SHUTDOWN) {
+                // Already stopped or shutdown, nothing to do
+                return;
+            }
+            if (this._state === GGTestRuntimeState.FAILED) {
+                // Already failed, just mark as stopped
+                this._state = GGTestRuntimeState.STOPPED;
+                return;
+            }
+            if (this._state === GGTestRuntimeState.CREATED) {
+                // Never started (e.g., another runtime or hook failed first), nothing to stop
+                this._state = GGTestRuntimeState.STOPPED;
+                return;
+            }
+            if (this._state !== GGTestRuntimeState.STARTED) {
+                throw new Error("Can only stop runtimes in STARTED state! Current state: " + this._state);
+            }
+            GGLog.debug(this, 'Stopping ' + this.className + '...');
+            try {
+                await this.runtimeRunner?.stopRuntime();
+            }
+            catch (error) {
+                GGLog.error(this, 'Error stopping ' + this.className, error);
+            }
+            this._state = GGTestRuntimeState.STOPPED;
+            GGLog.debug(this, this.className + ' stopped');
+        });
+    }
+    /**
+     * Fully shutdown the runtime and worker. IPC will be disconnected.
+     * After this, no commands can be sent.
+     */
+    async shutdown() {
+        await new GGContext("Test").run(async () => {
+            GG_TRACE.init();
+            if (this._state === GGTestRuntimeState.SHUTDOWN) {
+                return; // Already shutdown
+            }
+            GGLog.debug(this, 'Shutting down ' + this.className + '...');
+            try {
+                await this.runtimeRunner?.shutdown();
+            }
+            catch (error) {
+                GGLog.error(this, 'Error shutting down ' + this.className, error);
+            }
+            this.runtimeRunner = undefined;
+            this._state = GGTestRuntimeState.SHUTDOWN;
+            GGLog.debug(this, this.className + ' shut down');
+        });
+    }
+    async sendCommand(type, payload) {
+        switch (this._state) {
+            case GGTestRuntimeState.CREATED:
+                this.initialCommands.push({ method: type, payload: payload });
+                return undefined;
+            case GGTestRuntimeState.STARTED:
+            case GGTestRuntimeState.FAILED:
+            case GGTestRuntimeState.STOPPED:
+                // IPC still available in these states
+                return await this.runner.ipcServer.sendFrameworkMessage(this.runtimeId, type, payload);
+            case GGTestRuntimeState.SHUTDOWN:
+                throw new Error(`Cannot send command to shut down runtime ${this.className}`);
+        }
+    }
+    // -----------
+    // Key registration (for callOn routing)
+    // -----------
+    /**
+     * Register multiple locator keys at once.
+     */
+    registerLocatorKeys(keys) {
+        for (const key of keys) {
+            this.registeredLocatorKeys.add(key);
+        }
+    }
+    /**
+     * Check if this runtime has a specific locator key.
+     */
+    hasLocatorKey(key) {
+        return this.registeredLocatorKeys.has(key);
+    }
+}
+//# sourceMappingURL=GGTestRuntime.js.map

package/dist/src/GGTestRuntime.js.map

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

package/dist/src/GGTestRuntimeWorker.d.ts

@@ -0,0 +1,41 @@
+import { IPCClient, IPCClientRequest } from "@grest-ts/ipc";
+import { GGRuntime } from "@grest-ts/runtime";
+import { GGLocatorKey } from "@grest-ts/locator";
+import { GGTestCommand, GGTestEnvConfig } from "./GGTestRuntime";
+export declare const GG_TEST_RUNTIME_WORKER: GGLocatorKey<GGTestRuntimeWorker>;
+export declare class GGTestRuntimeWorker {
+    private static beforeRuntimeStartHandlers;
+    private static beforeRuntimeStartExecuted;
+    readonly ipcClient: IPCClient;
+    readonly config: GGTestEnvConfig;
+    runtime: GGRuntime;
+    private runtimeStopped;
+    private readonly scope;
+    constructor(config: GGTestEnvConfig);
+    /**
+     * Register a function to be called before the runtime starts.
+     * Safe to call at module load time - just adds to array.
+     * Handlers are executed during start() after extensions are loaded but before runtime creation.
+     */
+    static onBeforeRuntimeStart(handler: () => void): void;
+    start(createRuntime?: () => GGRuntime): Promise<void>;
+    /**
+     * Stop the GGRuntime (teardown services) but keep IPC alive.
+     * The runtime reference is kept so IPC handlers can still access
+     * async contexts (logs, metrics, config) via runInContext().
+     */
+    stopRuntime(): Promise<void>;
+    /**
+     * Register an IPC request handler that automatically runs within the runtime's context.
+     * Use this instead of ipcClient.onFrameworkRequest() for handlers that need access to
+     * runtime services (logs, metrics, config, etc.) even after runtime.stop().
+     */
+    onIpcRequest<Req, Res>(type: IPCClientRequest<Req, Res>, handler: (payload: Req) => Res | Promise<Res>): void;
+    /**
+     * Fully shutdown the worker, including IPC disconnection.
+     * Calls stopRuntime() if not already stopped.
+     */
+    shutdown(): Promise<void>;
+    getInitialCommandsFor<Payload>(type: IPCClientRequest<Payload, any>): GGTestCommand<Payload>[];
+}
+//# sourceMappingURL=GGTestRuntimeWorker.d.ts.map

package/dist/src/GGTestRuntimeWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GGTestRuntimeWorker.d.ts","sourceRoot":"","sources":["../../src/GGTestRuntimeWorker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAG1D,OAAO,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAC,YAAY,EAAiB,MAAM,mBAAmB,CAAC;AAE/D,OAAO,EAAC,aAAa,EAAE,eAAe,EAAC,MAAM,iBAAiB,CAAC;AAQ/D,eAAO,MAAM,sBAAsB,mCAA+D,CAAC;AAEnG,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,MAAM,CAAC,0BAA0B,CAAsB;IAC/D,OAAO,CAAC,MAAM,CAAC,0BAA0B,CAAS;IAElD,SAAgB,SAAS,EAAE,SAAS,CAAC;IACrC,SAAgB,MAAM,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,SAAS,CAAY;IACrC,OAAO,CAAC,cAAc,CAAS;IAE/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;gBAE3B,MAAM,EAAE,eAAe;IASnC;;;;OAIG;WACW,oBAAoB,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAOhD,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAiElE;;;;OAIG;IACU,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAQzC;;;;OAIG;IACI,YAAY,CAAC,GAAG,EAAE,GAAG,EACxB,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,EAChC,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAC9C,IAAI;IASP;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAO/B,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,EAAE;CAGxG"}