@grest-ts/testkit 0.0.5

package/dist/src/callOn/GGTestActionForLocatorOnCall.js

@@ -0,0 +1,118 @@
+/**
+ * Test action for invoking methods via GGLocator lookup.
+ *
+ * Used for:
+ * - @testable services (key: @testable:ClassName)
+ * - Direct contract calls (key: @contract:ContractName)
+ * - Custom GGLocatorKey lookups
+ *
+ * Extends GGTestAction to support .with() for mocks/spies and
+ * response expectations like .toMatchObject(), .toEqual().
+ */
+import { GGTestAction } from "../testers/GGTestAction.js";
+import { GG_TEST_RUNNER } from "../GGTestRunner.js";
+import { TestableIPC } from "./TestableIPC.js";
+import { GGTestError } from "../utils/GGTestError.js";
+/**
+ * Serialize a GGContext to a plain object for IPC transfer.
+ * Flattens the context hierarchy into a single object.
+ */
+function serializeContext(ctx) {
+    const result = {};
+    // Access the private values map via type assertion
+    const ctxAny = ctx;
+    if (ctxAny.values instanceof Map) {
+        for (const [key, value] of ctxAny.values) {
+            result[key] = value;
+        }
+    }
+    // Also serialize parent context values (child values take precedence)
+    if (ctxAny.parent) {
+        const parentValues = serializeContext(ctxAny.parent);
+        return { ...parentValues, ...result };
+    }
+    return result;
+}
+/**
+ * Action for invoking a method via GGLocator lookup over IPC.
+ *
+ * @typeParam T - The expected return type of the method
+ */
+export class GGTestActionForLocatorOnCall extends GGTestAction {
+    keyName;
+    methodName;
+    args;
+    targetRuntimes;
+    constructor(ctx, keyName, methodName, args, targetRuntimes) {
+        const config = {
+            noResponse: false,
+            logData: {
+                message: `[${keyName}.${methodName}]`,
+                request: args.length > 0 ? args : undefined
+            }
+        };
+        super(ctx, config);
+        this.keyName = keyName;
+        this.methodName = methodName;
+        this.args = args;
+        this.targetRuntimes = targetRuntimes;
+    }
+    // -------------------------------------------------
+    // Action execution
+    // -------------------------------------------------
+    async executeAction() {
+        const runner = GG_TEST_RUNNER.get();
+        // Use target runtimes if provided, otherwise all runtimes
+        const searchRuntimes = this.targetRuntimes ?? runner.getAllRuntimes();
+        // Find runtimes that have this key registered
+        const candidates = searchRuntimes.filter(r => r.hasLocatorKey(this.keyName));
+        if (candidates.length === 0) {
+            // No runtime has this key - provide helpful error
+            const allRuntimes = runner.getAllRuntimes();
+            if (allRuntimes.length === 0) {
+                throw new GGTestError({
+                    test: `No runtimes available to invoke ${this.keyName}.${this.methodName}`,
+                    expected: "At least one runtime to be started",
+                    received: "No runtimes found"
+                });
+            }
+            throw new GGTestError({
+                test: `Instance '${this.keyName}' not found in any runtime`,
+                expected: `A @testable instance registered with key '${this.keyName}'`,
+                received: `Key not registered in any of ${allRuntimes.length} runtime(s): ${allRuntimes.map(r => r.name).join(', ')}`
+            });
+        }
+        if (candidates.length > 1) {
+            // Check if all candidates are the same runtime class - if so, just use first one
+            const uniqueClassNames = new Set(candidates.map(r => r.className));
+            if (uniqueClassNames.size > 1) {
+                // Different runtime classes have this key - actual ambiguity
+                throw new GGTestError({
+                    test: `Multiple different runtimes have '${this.keyName}' registered`,
+                    expected: `Key '${this.keyName}' to be unique across different runtime classes, or use explicit runtime targeting`,
+                    received: `Found in ${candidates.length} runtimes with different classes: ${[...uniqueClassNames].join(', ')}`
+                });
+            }
+            // Same runtime class - just use first instance (they're identical)
+        }
+        // Exactly one runtime has this key - send IPC directly
+        const runtime = candidates[0];
+        const context = this.ctx ? serializeContext(this.ctx) : undefined;
+        const result = await runtime.sendCommand(TestableIPC.invoke, {
+            keyName: this.keyName,
+            methodName: this.methodName,
+            args: this.args,
+            context
+        });
+        if (result.success) {
+            return result.result;
+        }
+        throw new GGTestError({
+            test: `Error invoking ${this.keyName}.${this.methodName}`,
+            expected: "Method to execute successfully",
+            received: result.error || "Unknown error",
+            extra: result.stack
+        });
+    }
+}
+//# sourceMappingURL=GGTestActionForLocatorOnCall.js.map

package/dist/src/callOn/GGTestActionForLocatorOnCall.js.map

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

package/dist/src/callOn/TestableIPC.d.ts

@@ -0,0 +1,72 @@
+/**
+ * IPC protocol definitions for GGLocator-based service invocation.
+ *
+ * Defines the messages exchanged between test runner and runtime worker
+ * for invoking methods on registered instances (@testable, @contract, etc.).
+ */
+/**
+ * Serialized context data for IPC transfer.
+ * Contains flattened key-value pairs from GGContext.
+ */
+export type SerializedContext = Record<string, any>;
+/**
+ * Payload for invoking a method on a registered instance.
+ */
+export interface TestableInvokePayload {
+    /** The GGLocatorKey name (e.g., "@testable:ServiceB", "@contract:ChainApi", or custom key) */
+    keyName: string;
+    /** The method name to invoke */
+    methodName: string;
+    /** Arguments to pass to the method (as array) */
+    args: any[];
+    /** Serialized GGContext data to restore on the worker side */
+    context?: SerializedContext;
+}
+/**
+ * Result from invoking a testable method.
+ */
+export interface TestableInvokeResult {
+    /** Whether the invocation succeeded */
+    success: boolean;
+    /** The return value from the method (if success) */
+    result?: any;
+    /** Error message (if failed) */
+    error?: string;
+    /** Error stack trace (if failed) */
+    stack?: string;
+}
+/**
+ * Payload for registering locator keys from a runtime.
+ */
+export interface KeyRegistrationPayload {
+    /** Runtime ID sending the registration */
+    runtimeId: string;
+    /** All GGLocatorKey names registered in this runtime */
+    keys: string[];
+}
+/**
+ * IPC endpoints for testable service invocation.
+ */
+export declare const TestableIPC: {
+    /**
+     * Messages FROM test server TO worker.
+     */
+    client: {
+        /**
+         * Invoke a method on a testable service instance.
+         */
+        invoke: import("@grest-ts/ipc").IPCClientRequest<TestableInvokePayload, TestableInvokeResult>;
+    };
+    /**
+     * Messages FROM worker TO test server.
+     */
+    server: {
+        /**
+         * Register all locator keys available in a runtime.
+         * Sent from worker to test runner after compose completes.
+         */
+        registerKeys: import("@grest-ts/ipc").IPCServerRequest<KeyRegistrationPayload, void>;
+    };
+    invoke: import("@grest-ts/ipc").IPCClientRequest<TestableInvokePayload, TestableInvokeResult>;
+};
+//# sourceMappingURL=TestableIPC.d.ts.map

package/dist/src/callOn/TestableIPC.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestableIPC.d.ts","sourceRoot":"","sources":["../../../src/callOn/TestableIPC.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,8FAA8F;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,8DAA8D;IAC9D,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;IACpB;;OAEG;;QAEC;;WAEG;;;IAIP;;OAEG;;QAEC;;;WAGG;;;;CAMV,CAAC"}

package/dist/src/callOn/TestableIPC.js

@@ -0,0 +1,34 @@
+/**
+ * IPC protocol definitions for GGLocator-based service invocation.
+ *
+ * Defines the messages exchanged between test runner and runtime worker
+ * for invoking methods on registered instances (@testable, @contract, etc.).
+ */
+import { IPCClient, IPCServer } from "@grest-ts/ipc";
+/**
+ * IPC endpoints for testable service invocation.
+ */
+export const TestableIPC = {
+    /**
+     * Messages FROM test server TO worker.
+     */
+    client: {
+        /**
+         * Invoke a method on a testable service instance.
+         */
+        invoke: IPCClient.defineRequest("testable/invoke"),
+    },
+    /**
+     * Messages FROM worker TO test server.
+     */
+    server: {
+        /**
+         * Register all locator keys available in a runtime.
+         * Sent from worker to test runner after compose completes.
+         */
+        registerKeys: IPCServer.defineRequest("testable/register-keys"),
+    },
+    // Legacy alias for backwards compatibility
+    invoke: IPCClient.defineRequest("testable/invoke"),
+};
+//# sourceMappingURL=TestableIPC.js.map

package/dist/src/callOn/TestableIPC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestableIPC.js","sourceRoot":"","sources":["../../../src/callOn/TestableIPC.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,eAAe,CAAC;AA8CnD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB;;OAEG;IACH,MAAM,EAAE;QACJ;;WAEG;QACH,MAAM,EAAE,SAAS,CAAC,aAAa,CAA8C,iBAAiB,CAAC;KAClG;IAED;;OAEG;IACH,MAAM,EAAE;QACJ;;;WAGG;QACH,YAAY,EAAE,SAAS,CAAC,aAAa,CAA+B,wBAAwB,CAAC;KAChG;IAED,2CAA2C;IAC3C,MAAM,EAAE,SAAS,CAAC,aAAa,CAA8C,iBAAiB,CAAC;CAClG,CAAC"}

package/dist/src/callOn/callOn.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Unified callOn function for invoking methods on runtime instances.
+ *
+ * Works with:
+ * - @testable classes: Direct service invocation via IPC
+ * - GGLocatorKey: Direct instance lookup via IPC
+ * - GGContractClass: Contract implementation lookup via IPC
+ * - Contract holders (HTTP APIs, etc.): Delegated to their own factory
+ *
+ * @example
+ * // Call @testable service
+ * await callOn(MyService).doSomething("hello")
+ *
+ * // Call HTTP API (goes through HTTP transport)
+ * await callOn(ChainApi).quickWeatherCheck({city: "NYC"})
+ *
+ * // Call contract directly (skips HTTP, uses IPC)
+ * await callOn(ChainApiContract).quickWeatherCheck({city: "NYC"})
+ *
+ * // With context
+ * await callOn(MyService, ctx).doSomething("hello")
+ */
+import { GGLocatorKey } from "@grest-ts/locator";
+import { GGTestActionForLocatorOnCall } from "./GGTestActionForLocatorOnCall";
+import { GGContractApiDefinition, GGContractClass, GGContractMethod } from "@grest-ts/schema";
+import { GGContext } from "@grest-ts/context";
+import type { GGTestRuntime } from "../GGTestRuntime";
+/**
+ * Symbol used by contract holders (HTTP APIs, WebSocket APIs, etc.) to provide
+ * their own callOn proxy. This allows protocols to control how calls are made
+ * without callOn needing to know about specific protocols.
+ *
+ * The factory can return anything - there's no constraint on the return type.
+ * Each protocol fully controls what methods and types are available.
+ */
+export declare const CALL_ON_FACTORY: unique symbol;
+/**
+ * Marker interface for targets that provide their own callOn proxy.
+ * The factory can return any type - protocols have full control.
+ */
+export interface GGCallOnFactory {
+    [CALL_ON_FACTORY](ctx?: GGContext): unknown;
+}
+/**
+ * Maps a class's async methods to GGLocatorLookupTestAction calls.
+ * Used for @testable classes and GGLocatorKey lookups.
+ */
+export type LocatorLookupAccess<T> = {
+    [K in keyof T]: T[K] extends (...args: infer A) => Promise<infer R> ? (...args: A) => GGTestActionForLocatorOnCall<R> : never;
+};
+/**
+ * Maps contract methods to GGLocatorLookupTestAction calls.
+ * Used for direct GGContractClass lookups via IPC.
+ */
+export type ContractLocatorAccess<TContract> = {
+    [K in keyof TContract]: TContract[K] extends GGContractMethod<infer Input, infer Output> ? Input extends undefined ? () => GGTestActionForLocatorOnCall<Output> : (data: Input) => GGTestActionForLocatorOnCall<Output> : never;
+};
+export type GGTestCallOnCollection<T> = {
+    [K in keyof T]: GGTestCallOn<T[K]>;
+};
+/**
+ * Resolves the return type for callOn(target):
+ * - Factory targets → extract factory's return type (protocol controls everything)
+ * - GGContractClass → ContractLocatorAccess (IPC)
+ * - Constructor/GGLocatorKey → LocatorLookupAccess (IPC)
+ * - Plain objects → recurse into properties
+ */
+export type GGTestCallOn<T> = T extends {
+    [CALL_ON_FACTORY]: (ctx?: GGContext) => infer R;
+} ? R : T extends GGContractClass<infer TContract> ? ContractLocatorAccess<TContract> : T extends GGLocatorKey<infer Instance> ? LocatorLookupAccess<Instance> : T extends new (...args: any[]) => infer Instance ? LocatorLookupAccess<Instance> : T extends object ? {
+    [K in keyof T]: GGTestCallOn<T[K]>;
+} : never;
+/**
+ * Invoke methods on runtime instances via a unified interface.
+ *
+ * Resolution order:
+ * 1. Factory symbol (HTTP APIs, WebSocket APIs provide their own)
+ * 2. GGContractClass → IPC lookup via @contract: prefix
+ * 3. GGLocatorKey → IPC lookup via key name
+ * 4. Simple class → IPC lookup via @testable: prefix
+ *
+ * @example
+ * await callOn(MyService, ctx).doSomething("hello")
+ * await callOn(ChainApi, ctx).quickWeatherCheck({city: "NYC"})
+ * await callOn(ChainApiContract, ctx).quickWeatherCheck({city: "NYC"})
+ */
+export declare function callOn<T extends GGCallOnFactory>(target: T, ctx?: GGContext): GGTestCallOn<T>;
+export declare function callOn<T extends GGContractApiDefinition>(target: GGContractClass<T>, ctx?: GGContext): ContractLocatorAccess<T>;
+export declare function callOn<T>(target: GGLocatorKey<T>, ctx?: GGContext): LocatorLookupAccess<T>;
+export declare function callOn<T extends new (...args: any[]) => any>(target: T, ctx?: GGContext): LocatorLookupAccess<InstanceType<T>>;
+export declare function callOn<T extends object>(target: T, ctx?: GGContext): GGTestCallOn<T>;
+/**
+ * Invoke methods on runtime instances, targeting specific runtimes.
+ * Use this when you need to explicitly select which runtime to call
+ * when multiple different runtime classes have the same service.
+ *
+ * @param target - The target to call (class, GGLocatorKey, or GGContractClass)
+ * @param runtimes - The specific runtimes to target
+ * @param ctx - Optional context for the call
+ *
+ * @example
+ * const f = GGTest.startWorker({chain: ChainRuntime, weather: WeatherOnlyRuntime});
+ * // Both have WeatherService - explicitly target one:
+ * await f.chain.callOn(WeatherService).getWeather("Test")
+ */
+export declare function callOnTargeted<T>(target: T, runtimes: GGTestRuntime[], ctx?: GGContext): GGTestCallOn<T>;
+/**
+ * Process a collection of targets and create callOn proxies for each.
+ * It can be a recursive object where all "testable things" are replaced with callOn(X) handlers.
+ * {serviceA: ApiA, sub: { serviceB: ApiB}} -> {serviceA: callOn(ApiA), sub: { serviceB: callOn(ApiB)}}
+ */
+export declare function callOnCollection<T extends object | any[]>(target: T, ctx?: GGContext): GGTestCallOnCollection<T>;
+//# sourceMappingURL=callOn.d.ts.map

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

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

package/dist/src/callOn/callOn.js

@@ -0,0 +1,122 @@
+/**
+ * Unified callOn function for invoking methods on runtime instances.
+ *
+ * Works with:
+ * - @testable classes: Direct service invocation via IPC
+ * - GGLocatorKey: Direct instance lookup via IPC
+ * - GGContractClass: Contract implementation lookup via IPC
+ * - Contract holders (HTTP APIs, etc.): Delegated to their own factory
+ *
+ * @example
+ * // Call @testable service
+ * await callOn(MyService).doSomething("hello")
+ *
+ * // Call HTTP API (goes through HTTP transport)
+ * await callOn(ChainApi).quickWeatherCheck({city: "NYC"})
+ *
+ * // Call contract directly (skips HTTP, uses IPC)
+ * await callOn(ChainApiContract).quickWeatherCheck({city: "NYC"})
+ *
+ * // With context
+ * await callOn(MyService, ctx).doSomething("hello")
+ */
+import { GGLocatorKey } from "@grest-ts/locator";
+import { GGTestActionForLocatorOnCall } from "./GGTestActionForLocatorOnCall.js";
+import { LOCATOR_KEY_PREFIX_FOR_TESTABLE } from "@grest-ts/testkit-runtime";
+import { GGContractClass } from "@grest-ts/schema";
+import { GGContext } from "@grest-ts/context";
+import { LOCATOR_KEY_PREFIX_FOR_CONTRACT } from "./GGContractClass.implement.js";
+// ============================================================================
+// Factory symbol for protocol-specific callOn support
+// ============================================================================
+/**
+ * Symbol used by contract holders (HTTP APIs, WebSocket APIs, etc.) to provide
+ * their own callOn proxy. This allows protocols to control how calls are made
+ * without callOn needing to know about specific protocols.
+ *
+ * The factory can return anything - there's no constraint on the return type.
+ * Each protocol fully controls what methods and types are available.
+ */
+export const CALL_ON_FACTORY = Symbol.for("gg:callOnFactory");
+// ============================================================================
+// The callOn function
+// ============================================================================
+/**
+ * Check if target implements the CALL_ON_FACTORY interface.
+ */
+function hasCallOnFactory(target) {
+    return target != null && typeof target[CALL_ON_FACTORY] === 'function';
+}
+/**
+ * Check if target is a simple class (constructor function).
+ */
+function isSimpleClass(value) {
+    return typeof value === 'function' && value.prototype !== undefined && value.prototype.constructor === value;
+}
+export function callOn(target, ctx) {
+    ctx ??= new GGContext("Test");
+    if (hasCallOnFactory(target)) {
+        return target[CALL_ON_FACTORY](ctx);
+    }
+    const keyName = resolveKeyName(target);
+    return createCallOnProxy(keyName, ctx);
+}
+// ============================================================================
+// Helper functions for key resolution
+// ============================================================================
+/**
+ * Resolve a target to its locator key name.
+ * Handles GGContractClass, GGLocatorKey, and simple classes.
+ */
+function resolveKeyName(target) {
+    if (target instanceof GGContractClass) {
+        return LOCATOR_KEY_PREFIX_FOR_CONTRACT + target.name;
+    }
+    if (target instanceof GGLocatorKey) {
+        return target.name;
+    }
+    if (isSimpleClass(target)) {
+        return LOCATOR_KEY_PREFIX_FOR_TESTABLE + target.name;
+    }
+    throw new Error(`Unknown callOn target: ${target?.name ?? target?.constructor?.name ?? typeof target}`);
+}
+/**
+ * Create a proxy that intercepts method calls and returns GGTestActionForLocatorOnCall.
+ */
+function createCallOnProxy(keyName, ctx, targetRuntimes) {
+    return new Proxy({}, {
+        get(_, methodName) {
+            return (...args) => new GGTestActionForLocatorOnCall(ctx, keyName, methodName, args, targetRuntimes);
+        }
+    });
+}
+export function callOnTargeted(target, runtimes, ctx) {
+    ctx ??= new GGContext("Test");
+    // Factory targets don't support runtime targeting - they control their own routing
+    if (hasCallOnFactory(target)) {
+        return target[CALL_ON_FACTORY](ctx);
+    }
+    const keyName = resolveKeyName(target);
+    return createCallOnProxy(keyName, ctx, runtimes);
+}
+/**
+ * Process a collection of targets and create callOn proxies for each.
+ * It can be a recursive object where all "testable things" are replaced with callOn(X) handlers.
+ * {serviceA: ApiA, sub: { serviceB: ApiB}} -> {serviceA: callOn(ApiA), sub: { serviceB: callOn(ApiB)}}
+ */
+export function callOnCollection(target, ctx) {
+    const result = Array.isArray(target) ? [] : {};
+    for (const key in target) {
+        const value = target[key];
+        if (value != null) {
+            if (hasCallOnFactory(value) || value instanceof GGContractClass || value instanceof GGLocatorKey || isSimpleClass(value)) {
+                result[key] = callOn(value, ctx);
+            }
+            else if (typeof value === 'object') {
+                result[key] = callOnCollection(value, ctx);
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=callOn.js.map

package/dist/src/callOn/callOn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callOn.js","sourceRoot":"","sources":["../../../src/callOn/callOn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAC,+BAA+B,EAAC,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAA0B,eAAe,EAAmB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAC,+BAA+B,EAAC,MAAM,6BAA6B,CAAC;AAG5E,+EAA+E;AAC/E,sDAAsD;AACtD,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAmD9D,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,gBAAgB,CAAC,MAAe;IACrC,OAAO,MAAM,IAAI,IAAI,IAAI,OAAQ,MAAc,CAAC,eAAe,CAAC,KAAK,UAAU,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,UAAU,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,KAAK,KAAK,CAAC;AACjH,CAAC;AAqBD,MAAM,UAAU,MAAM,CAAC,MAAW,EAAE,GAAe;IAC/C,GAAG,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC,CAAA;IAE7B,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAE/E;;;GAGG;AACH,SAAS,cAAc,CAAC,MAAW;IAC/B,IAAI,MAAM,YAAY,eAAe,EAAE,CAAC;QACpC,OAAO,+BAA+B,GAAG,MAAM,CAAC,IAAI,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,YAAY,YAAY,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC;IACvB,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,+BAA+B,GAAG,MAAM,CAAC,IAAI,CAAC;IACzD,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,IAAI,IAAI,MAAM,EAAE,WAAW,EAAE,IAAI,IAAI,OAAO,MAAM,EAAE,CAAC,CAAC;AAC5G,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,OAAe,EAAE,GAAc,EAAE,cAAgC;IACxF,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE;QACjB,GAAG,CAAC,CAAC,EAAE,UAAkB;YACrB,OAAO,CAAC,GAAG,IAAW,EAAE,EAAE,CAAC,IAAI,4BAA4B,CAAM,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACrH,CAAC;KACJ,CAAC,CAAC;AACP,CAAC;AAqBD,MAAM,UAAU,cAAc,CAAC,MAAW,EAAE,QAAyB,EAAE,GAAe;IAClF,GAAG,KAAK,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAE9B,mFAAmF;IACnF,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,iBAAiB,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAA2B,MAAS,EAAE,GAAe;IACjF,MAAM,MAAM,GAAQ,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAChB,IAAI,gBAAgB,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,eAAe,IAAI,KAAK,YAAY,YAAY,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvH,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAY,EAAE,GAAG,CAAC,CAAC;YAC5C,CAAC;iBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACnC,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAC/C,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/src/callOn/registerOnCallHandler.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Worker-side handler for GGLocator-based service invocation.
+ *
+ * Receives IPC requests from tests to invoke methods on registered instances
+ * (@testable, @contract, etc.) and returns the results.
+ */
+import { GGTestRuntimeWorker } from "../GGTestRuntimeWorker";
+/**
+ * Register the locator lookup handler on the worker.
+ * Called during worker initialization.
+ */
+export declare function registerOnCallHandler(worker: GGTestRuntimeWorker): void;
+//# sourceMappingURL=registerOnCallHandler.d.ts.map

package/dist/src/callOn/registerOnCallHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerOnCallHandler.d.ts","sourceRoot":"","sources":["../../../src/callOn/registerOnCallHandler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAC,mBAAmB,EAAC,MAAM,wBAAwB,CAAC;AAsB3D;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CA8DvE"}

package/dist/src/callOn/registerOnCallHandler.js

@@ -0,0 +1,111 @@
+/**
+ * Worker-side handler for GGLocator-based service invocation.
+ *
+ * Receives IPC requests from tests to invoke methods on registered instances
+ * (@testable, @contract, etc.) and returns the results.
+ */
+import { GGLocator, GGLocatorKey } from "@grest-ts/locator";
+import { GGLog } from "@grest-ts/logger";
+import { TestableIPC } from "./TestableIPC.js";
+import { GGContext } from "@grest-ts/context";
+/**
+ * Context for logging
+ */
+const LOG_CONTEXT = { name: "GGLocatorWorkerHandler" };
+/**
+ * Deserialize context data into a GGContext.
+ * Directly populates the internal values map.
+ */
+function deserializeContext(data) {
+    const ctx = new GGContext("ipc-context");
+    // Access internal values map and populate directly
+    const ctxAny = ctx;
+    for (const [keyName, value] of Object.entries(data)) {
+        ctxAny.values.set(keyName, value);
+    }
+    return ctx;
+}
+/**
+ * Register the locator lookup handler on the worker.
+ * Called during worker initialization.
+ */
+export function registerOnCallHandler(worker) {
+    worker.onIpcRequest(TestableIPC.invoke, async (payload) => {
+        const { keyName, methodName, args, context } = payload;
+        GGLog.debug(LOG_CONTEXT, `Invoking ${keyName}.${methodName}`, { args, hasContext: !!context });
+        try {
+            // Look up the instance in the current scope
+            const scope = GGLocator.tryGetScope();
+            if (!scope) {
+                return {
+                    success: false,
+                    error: `No GGLocator scope available - is the runtime running?`
+                };
+            }
+            const key = new GGLocatorKey(keyName);
+            const instance = scope.tryGet(key);
+            if (!instance) {
+                return {
+                    success: false,
+                    error: `Instance '${keyName}' not found in GGLocator. ` +
+                        `Make sure the class is decorated with @testable or registered during compose().`
+                };
+            }
+            // Check if method exists
+            const method = instance[methodName];
+            if (typeof method !== 'function') {
+                return {
+                    success: false,
+                    error: `Method '${methodName}' not found on instance '${keyName}'. ` +
+                        `Available methods: ${getMethodNames(instance).join(', ')}`
+                };
+            }
+            // Invoke the method, optionally within the provided context
+            let result;
+            if (context) {
+                const ctx = deserializeContext(context);
+                result = await ctx.run(() => method.apply(instance, args));
+            }
+            else {
+                result = await method.apply(instance, args);
+            }
+            GGLog.debug(LOG_CONTEXT, `Invocation ${keyName}.${methodName} completed`, { result });
+            return {
+                success: true,
+                result
+            };
+        }
+        catch (error) {
+            GGLog.error(LOG_CONTEXT, `Error invoking ${keyName}.${methodName}`, error);
+            return {
+                success: false,
+                error: error.message || String(error),
+                stack: error.stack
+            };
+        }
+    });
+}
+/**
+ * Get method names from an instance for error messages.
+ */
+function getMethodNames(instance) {
+    const names = [];
+    let proto = Object.getPrototypeOf(instance);
+    while (proto && proto !== Object.prototype) {
+        const propNames = Object.getOwnPropertyNames(proto)
+            .filter(name => {
+            if (name === 'constructor')
+                return false;
+            try {
+                return typeof proto[name] === 'function';
+            }
+            catch {
+                return false;
+            }
+        });
+        names.push(...propNames);
+        proto = Object.getPrototypeOf(proto);
+    }
+    return [...new Set(names)].sort();
+}
+//# sourceMappingURL=registerOnCallHandler.js.map

package/dist/src/callOn/registerOnCallHandler.js.map

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