@antelopejs/interface-core 0.0.9 → 0.0.11

package/dist/errors.d.ts

@@ -1,4 +1,6 @@
 export declare const MISSING_PROVIDER_CODE = "ERR_NO_PROVIDER";
+export declare const AMBIGUOUS_PROVIDER_CODE = "ERR_AMBIGUOUS_PROVIDER";
+export declare const PROVIDER_QUEUE_FULL_CODE = "ERR_PROVIDER_QUEUE_FULL";
 export declare const MODULE_CONTEXT_INVALIDATED_CODE = "ERR_MODULE_CONTEXT_INVALIDATED";
 /**
  * Error emitted when a proxy is used without an attached provider in test
@@ -12,6 +14,16 @@ export declare class MissingProviderError extends Error {
     readonly code = "ERR_NO_PROVIDER";
     constructor(detail?: string);
 }
+/** Error emitted when a call cannot be routed between multiple providers. */
+export declare class AmbiguousProviderError extends Error {
+    readonly code = "ERR_AMBIGUOUS_PROVIDER";
+    constructor(proxyIdentity: string, providers: string[]);
+}
+/** Error emitted when an unattached proxy's bounded queue is full. */
+export declare class ProviderQueueFullError extends Error {
+    readonly code = "ERR_PROVIDER_QUEUE_FULL";
+    constructor(proxyIdentity: string, limit: number);
+}
 /**
  * Error emitted when work inherited ownership from a destroyed module.
  */

package/dist/errors.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ModuleContextInvalidatedError = exports.MissingProviderError = exports.MODULE_CONTEXT_INVALIDATED_CODE = exports.MISSING_PROVIDER_CODE = void 0;
+exports.ModuleContextInvalidatedError = exports.ProviderQueueFullError = exports.AmbiguousProviderError = exports.MissingProviderError = exports.MODULE_CONTEXT_INVALIDATED_CODE = exports.PROVIDER_QUEUE_FULL_CODE = exports.AMBIGUOUS_PROVIDER_CODE = exports.MISSING_PROVIDER_CODE = void 0;
 exports.isMissingProviderError = isMissingProviderError;
 exports.MISSING_PROVIDER_CODE = "ERR_NO_PROVIDER";
+exports.AMBIGUOUS_PROVIDER_CODE = "ERR_AMBIGUOUS_PROVIDER";
+exports.PROVIDER_QUEUE_FULL_CODE = "ERR_PROVIDER_QUEUE_FULL";
 exports.MODULE_CONTEXT_INVALIDATED_CODE = "ERR_MODULE_CONTEXT_INVALIDATED";
 const MISSING_PROVIDER_MESSAGE = "Interface function called without implementation in test environment. " +
     "Ensure the required module is loaded in your test config.";
@@ -22,6 +24,24 @@ class MissingProviderError extends Error {
     }
 }
 exports.MissingProviderError = MissingProviderError;
+/** Error emitted when a call cannot be routed between multiple providers. */
+class AmbiguousProviderError extends Error {
+    code = exports.AMBIGUOUS_PROVIDER_CODE;
+    constructor(proxyIdentity, providers) {
+        super(`Interface proxy ${proxyIdentity} has multiple providers (${providers.join(", ")}); run the call in a module execution context with an explicit provider route.`);
+        this.name = "AmbiguousProviderError";
+    }
+}
+exports.AmbiguousProviderError = AmbiguousProviderError;
+/** Error emitted when an unattached proxy's bounded queue is full. */
+class ProviderQueueFullError extends Error {
+    code = exports.PROVIDER_QUEUE_FULL_CODE;
+    constructor(proxyIdentity, limit) {
+        super(`Interface proxy ${proxyIdentity} has ${limit} pending operations without a provider.`);
+        this.name = "ProviderQueueFullError";
+    }
+}
+exports.ProviderQueueFullError = ProviderQueueFullError;
 /**
  * Error emitted when work inherited ownership from a destroyed module.
  */

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAyDA,wDAOC;AAhEY,QAAA,qBAAqB,GAAG,iBAAiB,CAAC;AAC1C,QAAA,+BAA+B,GAAG,gCAAgC,CAAC;AAEhF,MAAM,wBAAwB,GAC5B,wEAAwE;IACxE,2DAA2D,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7B,IAAI,GAAG,6BAAqB,CAAC;IAE7C,YAAmB,MAAe;QAChC,KAAK,CAAC,MAAM,IAAI,wBAAwB,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAPD,oDAOC;AAED;;GAEG;AACH,MAAa,6BAA8B,SAAQ,KAAK;IACtC,IAAI,GAAG,uCAA+B,CAAC;IAEvD,YAAmB,MAAc;QAC/B,KAAK,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAPD,sEAOC;AAED;;;;;;;GAOG;AACH,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,CACL,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,gBAAgB;QAC1D,KAAK,YAAY,KAAK,CACvB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,KAAc;IAEd,OAAO,CACL,OAAO,CAAC,KAAK,CAAC;QACb,KAA8B,CAAC,IAAI,KAAK,6BAAqB,CAC/D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAmFA,wDAOC;AA1FY,QAAA,qBAAqB,GAAG,iBAAiB,CAAC;AAC1C,QAAA,uBAAuB,GAAG,wBAAwB,CAAC;AACnD,QAAA,wBAAwB,GAAG,yBAAyB,CAAC;AACrD,QAAA,+BAA+B,GAAG,gCAAgC,CAAC;AAEhF,MAAM,wBAAwB,GAC5B,wEAAwE;IACxE,2DAA2D,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7B,IAAI,GAAG,6BAAqB,CAAC;IAE7C,YAAmB,MAAe;QAChC,KAAK,CAAC,MAAM,IAAI,wBAAwB,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAPD,oDAOC;AAED,6EAA6E;AAC7E,MAAa,sBAAuB,SAAQ,KAAK;IAC/B,IAAI,GAAG,+BAAuB,CAAC;IAE/C,YAAmB,aAAqB,EAAE,SAAmB;QAC3D,KAAK,CACH,mBAAmB,aAAa,4BAA4B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gFAAgF,CACjK,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AATD,wDASC;AAED,sEAAsE;AACtE,MAAa,sBAAuB,SAAQ,KAAK;IAC/B,IAAI,GAAG,gCAAwB,CAAC;IAEhD,YAAmB,aAAqB,EAAE,KAAa;QACrD,KAAK,CACH,mBAAmB,aAAa,QAAQ,KAAK,yCAAyC,CACvF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AATD,wDASC;AAED;;GAEG;AACH,MAAa,6BAA8B,SAAQ,KAAK;IACtC,IAAI,GAAG,uCAA+B,CAAC;IAEvD,YAAmB,MAAc;QAC/B,KAAK,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAPD,sEAOC;AAED;;;;;;;GAOG;AACH,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,CACL,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,gBAAgB;QAC1D,KAAK,YAAY,KAAK,CACvB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,KAAc;IAEd,OAAO,CACL,OAAO,CAAC,KAAK,CAAC;QACb,KAA8B,CAAC,IAAI,KAAK,6BAAqB,CAC/D,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,8 +1,10 @@
 import "reflect-metadata";
 import type { Class } from "./decorators";
-import { EventProxy, RegisteringProxy } from "./proxies";
+import { type InterfaceConnection } from "./internal";
+import { AsyncProxy, type EventProxy, type RegisteringProxy } from "./proxies";
 export * from "./errors";
-export { AsyncProxy, EventProxy, GetResponsibleModule, RegisteringProxy, RunWithResponsibleModule, } from "./proxies";
+export type { InterfaceConnection } from "./internal";
+export { AsyncProxy, EventProxy, GetInterfaceProxyIdentity, GetResponsibleModule, IsInterfaceProxy, RegisteringProxy, RunWithResponsibleModule, } from "./proxies";
 /**
  * Gets metadata for a target object using the specified metadata class.
  *
@@ -26,12 +28,12 @@ type Func<A extends any[] = any[], R = any> = (...args: A) => R;
  *
  * @returns A function that proxies calls to the implementation when available
  */
-export declare function InterfaceFunction<T extends Func = Func, R = Awaited<ReturnType<T>>>(): (...args: Parameters<T>) => Promise<R>;
+export declare function InterfaceFunction<T extends Func = Func, R = Awaited<ReturnType<T>>>(identity?: string): (...args: Parameters<T>) => Promise<R>;
 type RID<T> = T extends (id: infer P, ...args: any[]) => void ? P : never;
 type InterfaceImplType<T> = T extends RegisteringProxy<infer P> ? {
     register: P;
     unregister: (id: RID<P>) => void;
-} : T extends EventProxy ? never : T extends (...args: infer A) => infer R ? (...args: A) => Awaited<R> | R : T extends Record<string, any> ? InterfaceToImpl<T> : never;
+} : T extends AsyncProxy<infer P> ? P : T extends EventProxy ? never : T extends (...args: infer A) => infer R ? (...args: A) => Awaited<R> | R : T extends Record<string, any> ? InterfaceToImpl<T> : never;
 type InterfaceToImpl<T> = T extends infer P ? {
     [K in keyof P]?: InterfaceImplType<P[K]>;
 } : never;
@@ -52,14 +54,10 @@ export declare function ImplementInterface<T extends Record<string, unknown>, T2
 /**
  * @deprecated Please use the non-async version of this function.
  */
-export declare function ImplementInterface<T extends Record<string, unknown>, T2 extends InterfaceToImpl<T>>(declaration: T | Promise<T>, implementation: T2 | Promise<T2>): Promise<{
+export declare function ImplementInterface<T extends Record<string, unknown>, T2 extends InterfaceToImpl<T>>(declaration: T | PromiseLike<T>, implementation: T2 | PromiseLike<T2>): Promise<{
     declaration: Awaited<T>;
     implementation: T2;
 }>;
-interface InterfaceConnection {
-    id?: string;
-    path: string;
-}
 /**
  * Gets all instances of a specific interface across the system.
  *

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RunWithResponsibleModule = exports.RegisteringProxy = exports.GetResponsibleModule = exports.EventProxy = exports.AsyncProxy = void 0;
+exports.RunWithResponsibleModule = exports.RegisteringProxy = exports.IsInterfaceProxy = exports.GetResponsibleModule = exports.GetInterfaceProxyIdentity = exports.EventProxy = exports.AsyncProxy = void 0;
 exports.GetMetadata = GetMetadata;
 exports.InterfaceFunction = InterfaceFunction;
 exports.ImplementInterface = ImplementInterface;
@@ -28,7 +28,9 @@ __exportStar(require("./errors"), exports);
 var proxies_2 = require("./proxies");
 Object.defineProperty(exports, "AsyncProxy", { enumerable: true, get: function () { return proxies_2.AsyncProxy; } });
 Object.defineProperty(exports, "EventProxy", { enumerable: true, get: function () { return proxies_2.EventProxy; } });
+Object.defineProperty(exports, "GetInterfaceProxyIdentity", { enumerable: true, get: function () { return proxies_2.GetInterfaceProxyIdentity; } });
 Object.defineProperty(exports, "GetResponsibleModule", { enumerable: true, get: function () { return proxies_2.GetResponsibleModule; } });
+Object.defineProperty(exports, "IsInterfaceProxy", { enumerable: true, get: function () { return proxies_2.IsInterfaceProxy; } });
 Object.defineProperty(exports, "RegisteringProxy", { enumerable: true, get: function () { return proxies_2.RegisteringProxy; } });
 Object.defineProperty(exports, "RunWithResponsibleModule", { enumerable: true, get: function () { return proxies_2.RunWithResponsibleModule; } });
 internal_1.internal.asyncContextReporter = (trace) => {
@@ -84,42 +86,107 @@ function GetMetadata(target, meta, inherit = true) {
  *
  * @returns A function that proxies calls to the implementation when available
  */
-function InterfaceFunction() {
-    const proxy = new proxies_1.AsyncProxy();
+function InterfaceFunction(identity) {
+    const proxy = new proxies_1.AsyncProxy(identity);
     const func = (...args) => proxy.call(...args);
     func.proxy = proxy;
     return func;
 }
-function implement(decl, impl) {
-    for (const key in decl) {
-        if (key in impl) {
-            const val = decl[key];
-            if (val instanceof proxies_1.RegisteringProxy) {
-                val.onRegister(impl[key].register);
-                val.onUnregister(impl[key].unregister);
-            }
-            else if (typeof val === "function" && val.proxy instanceof proxies_1.AsyncProxy) {
-                val.proxy.onCall(impl[key]);
-            }
-            else if (val instanceof proxies_1.AsyncProxy) {
-                val.onCall(impl[key]);
-            }
-            else if (!(val instanceof proxies_1.EventProxy)) {
-                implement(val, impl[key]);
-            }
+function isObject(value) {
+    return typeof value === "object" && value !== null;
+}
+function assertAcyclic(value, label) {
+    const visited = new WeakSet();
+    const active = new WeakSet();
+    const visit = (current, path) => {
+        if (!isObject(current) || visited.has(current)) {
+            return;
+        }
+        if (active.has(current)) {
+            throw new TypeError(`${label} contains a cycle at ${path}.`);
         }
+        active.add(current);
+        for (const [key, child] of Object.entries(current)) {
+            visit(child, `${path}.${key}`);
+        }
+        active.delete(current);
+        visited.add(current);
+    };
+    visit(value, label);
+}
+function requireFunction(value, path) {
+    if (typeof value !== "function") {
+        throw new TypeError(`Missing or malformed interface handler at ${path}.`);
     }
+    return value;
+}
+function planProxyAttachment(proxy, implementation, path) {
+    if ((0, proxies_1.IsInterfaceProxy)(proxy, "event")) {
+        return;
+    }
+    if ((0, proxies_1.IsInterfaceProxy)(proxy, "async")) {
+        const callback = requireFunction(implementation, path);
+        return {
+            attach: () => proxy.onCall(callback),
+        };
+    }
+    if (!(0, proxies_1.IsInterfaceProxy)(proxy, "registering")) {
+        return;
+    }
+    if (!isObject(implementation)) {
+        throw new TypeError(`Missing or malformed interface handler at ${path}.`);
+    }
+    const register = requireFunction(implementation.register, `${path}.register`);
+    const unregister = requireFunction(implementation.unregister, `${path}.unregister`);
+    return {
+        attach: () => proxy.onHandlers(register, unregister),
+    };
+}
+function createAttachmentPlan(declaration, implementation, path = "implementation") {
+    const plans = [];
+    for (const [key, declared] of Object.entries(declaration)) {
+        const implemented = implementation[key];
+        const proxy = typeof declared === "function" && "proxy" in declared
+            ? declared.proxy
+            : declared;
+        const proxyPlan = planProxyAttachment(proxy, implemented, `${path}.${key}`);
+        if (proxyPlan) {
+            plans.push(proxyPlan);
+            continue;
+        }
+        if (isObject(declared) && !(0, proxies_1.IsInterfaceProxy)(declared)) {
+            const nestedImplementation = isObject(implemented) ? implemented : {};
+            plans.push(...createAttachmentPlan(declared, nestedImplementation, `${path}.${key}`));
+        }
+    }
+    return plans;
+}
+function attachImplementation(declaration, implementation) {
+    if (!isObject(declaration) || !isObject(implementation)) {
+        throw new TypeError("Interface declaration and implementation must be objects.");
+    }
+    assertAcyclic(declaration, "declaration");
+    assertAcyclic(implementation, "implementation");
+    const plans = createAttachmentPlan(declaration, implementation);
+    plans.forEach((plan) => {
+        plan.attach();
+    });
+}
+function isThenable(value) {
+    return ((typeof value === "object" || typeof value === "function") &&
+        value !== null &&
+        typeof value.then === "function");
 }
 function ImplementInterface(declaration, implementation) {
-    if (declaration instanceof Promise || implementation instanceof Promise) {
+    if (isThenable(declaration) || isThenable(implementation)) {
         return Promise.all([declaration, implementation]).then(([decl, impl]) => {
-            implement(decl, impl);
+            attachImplementation(decl, impl);
             return { declaration: decl, implementation: impl };
         });
     }
     const decl = declaration;
     const impl = implementation;
-    implement(decl, impl);
+    attachImplementation(decl, impl);
     return { declaration: decl, implementation: impl };
 }
 /**
@@ -134,8 +201,7 @@ function GetInterfaceInstances(interfaceID) {
     const module = (0, proxies_1.GetResponsibleModule)();
     if (!module || !(module in internal_1.internal.interfaceConnections))
         return [];
-    const connections = internal_1.internal.interfaceConnections[module];
-    return connections[interfaceID] ?? [];
+    return internal_1.internal.interfaceConnections[module][interfaceID] ?? [];
 }
 /**
  * Gets a specific instance of an interface by ID.

package/dist/index.js.map

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

package/dist/internal.d.ts

@@ -1,21 +1,96 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+export declare const RUNTIME_PROTOCOL_VERSION = 3;
+export declare const RUNTIME_SYMBOL: unique symbol;
+/** Provider connection metadata visible to an interface consumer. */
 export interface InterfaceConnection {
+    /** Optional connection alias. */
     id?: string;
+    /** Resolved interface package path. */
     path: string;
+    /** Module ID of the provider represented by this connection. */
+    provider: string;
+    /** Whether this provider is selected for unqualified interface calls. */
+    selected: boolean;
 }
-/** @internal */
-export declare const internal: {
-    moduleByFolder: {
+/** Module identity and provider routes propagated through asynchronous work. */
+export interface ModuleExecutionContext {
+    /** Stable module ID used by existing lifecycle and attribution APIs. */
+    module: string;
+    /** Unique lifecycle generation ID. Defaults to the module ID when omitted. */
+    owner?: string;
+    /** Provider ID used when attaching implementations. */
+    provider?: string;
+    /** Provider selections keyed by stable interface proxy identity. */
+    providerRoutes?: Readonly<Record<string, string>>;
+}
+interface ActiveModuleExecutionContext extends ModuleExecutionContext {
+    owner: string;
+    ownershipToken: symbol;
+}
+export interface ProxyBrand {
+    protocol: number;
+    kind: "async" | "registering" | "event";
+    identity: string;
+}
+export interface RuntimeProxyState {
+    kind: ProxyBrand["kind"];
+    value: unknown;
+}
+export interface RuntimeCleanup {
+    cleanup(): void;
+    unregisterModule?(module: string): void;
+}
+export interface RuntimeErrorDetails {
+    operation: string;
+    module?: string;
+    proxyIdentity?: string;
+    registrationId?: unknown;
+}
+export interface InterfaceRuntime {
+    protocol: number;
+    moduleByFolder: Array<{
         dir: string;
         id: string;
         isImplementor?: boolean;
-    }[];
+    }>;
     testStubMode: boolean;
-    knownAsync: Map<string, any[]>;
-    knownRegisters: Map<string, any[]>;
-    knownEvents: any[];
+    knownAsync: Map<string, Set<RuntimeCleanup | {
+        detach(): void;
+    }>>;
+    knownRegisters: Map<string, Set<RuntimeCleanup | {
+        detach(): void;
+    }>>;
+    registeringProxies: Set<{
+        unregisterModule(module: string): void;
+        unregisterOwner(owner: string): void;
+    }>;
+    knownEvents: Set<{
+        unregisterModule(module: string): void;
+        unregisterOwner(owner: string): void;
+    }>;
     interfaceConnections: Record<string, Record<string, InterfaceConnection[]>>;
-    asyncContextReporter: ((trace: NodeJS.CallSite[]) => void) | undefined;
-    replayErrorReporter: ((id: unknown, err: unknown) => void) | undefined;
-    addAsyncProxy(module: string, proxy: any): void;
-    addRegisteringProxy(module: string, proxy: any): void;
-};
+    executionContext: AsyncLocalStorage<ActiveModuleExecutionContext>;
+    activeOwnerTokens: Map<string, symbol>;
+    proxyStates: Map<string, RuntimeProxyState>;
+    nextProxyIdentity: number;
+    nextLeaseGeneration: number;
+    maxPendingOperations: number;
+    asyncContextReporter?: (trace: NodeJS.CallSite[]) => void;
+    runtimeErrorReporter?: (error: unknown, details: RuntimeErrorDetails) => void;
+    replayErrorReporter?: (id: unknown, error: unknown) => void;
+    addAsyncProxy(module: string, proxy: RuntimeCleanup | {
+        detach(): void;
+    }): void;
+    addRegisteringProxy(module: string, proxy: RuntimeCleanup | {
+        detach(): void;
+    }): void;
+}
+/** @internal */
+export declare const internal: InterfaceRuntime;
+export declare function runWithModuleContext<T>(context: ModuleExecutionContext, callback: () => T): T;
+export declare function captureModuleContext(): ActiveModuleExecutionContext | undefined;
+export declare function runWithCapturedModuleContext<T>(context: ActiveModuleExecutionContext, callback: () => T): T;
+export declare function peekModuleContext(): ModuleExecutionContext | undefined;
+export declare function getModuleContext(): ModuleExecutionContext | undefined;
+export declare function invalidateModuleContext(owner: string): void;
+export {};

package/dist/internal.js

@@ -1,27 +1,114 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.internal = void 0;
-function addToMapArray(map, key, value) {
-    if (!map.has(key)) {
-        map.set(key, []);
+exports.internal = exports.RUNTIME_SYMBOL = exports.RUNTIME_PROTOCOL_VERSION = void 0;
+exports.runWithModuleContext = runWithModuleContext;
+exports.captureModuleContext = captureModuleContext;
+exports.runWithCapturedModuleContext = runWithCapturedModuleContext;
+exports.peekModuleContext = peekModuleContext;
+exports.getModuleContext = getModuleContext;
+exports.invalidateModuleContext = invalidateModuleContext;
+const node_async_hooks_1 = require("node:async_hooks");
+const errors_1 = require("./errors");
+exports.RUNTIME_PROTOCOL_VERSION = 3;
+exports.RUNTIME_SYMBOL = Symbol.for("@antelopejs/interface-core/runtime");
+function addToMapSet(map, key, value) {
+    const values = map.get(key) ?? new Set();
+    values.add(value);
+    map.set(key, values);
+}
+function createRuntime() {
+    const runtime = {
+        protocol: exports.RUNTIME_PROTOCOL_VERSION,
+        moduleByFolder: [],
+        testStubMode: false,
+        knownAsync: new Map(),
+        knownRegisters: new Map(),
+        registeringProxies: new Set(),
+        knownEvents: new Set(),
+        interfaceConnections: Object.create(null),
+        executionContext: new node_async_hooks_1.AsyncLocalStorage(),
+        activeOwnerTokens: new Map(),
+        proxyStates: new Map(),
+        nextProxyIdentity: 1,
+        nextLeaseGeneration: 1,
+        maxPendingOperations: 1_000,
+        addAsyncProxy(module, proxy) {
+            addToMapSet(runtime.knownAsync, module, proxy);
+        },
+        addRegisteringProxy(module, proxy) {
+            addToMapSet(runtime.knownRegisters, module, proxy);
+        },
+    };
+    return runtime;
+}
+function getRuntime() {
+    const globals = globalThis;
+    const existing = globals[exports.RUNTIME_SYMBOL];
+    if (existing && existing.protocol !== exports.RUNTIME_PROTOCOL_VERSION) {
+        throw new Error(`Incompatible @antelopejs/interface-core runtime protocol: expected ${exports.RUNTIME_PROTOCOL_VERSION}, received ${existing.protocol}`);
     }
-    map.get(key)?.push(value);
+    if (existing) {
+        return existing;
+    }
+    const runtime = createRuntime();
+    Object.defineProperty(globals, exports.RUNTIME_SYMBOL, {
+        configurable: false,
+        enumerable: false,
+        writable: false,
+        value: runtime,
+    });
+    return runtime;
 }
 /** @internal */
-exports.internal = {
-    moduleByFolder: [],
-    testStubMode: false,
-    knownAsync: new Map(),
-    knownRegisters: new Map(),
-    knownEvents: [],
-    interfaceConnections: {},
-    asyncContextReporter: undefined,
-    replayErrorReporter: undefined,
-    addAsyncProxy(module, proxy) {
-        addToMapArray(exports.internal.knownAsync, module, proxy);
-    },
-    addRegisteringProxy(module, proxy) {
-        addToMapArray(exports.internal.knownRegisters, module, proxy);
-    },
-};
+exports.internal = getRuntime();
+function getOwnerToken(owner) {
+    const activeToken = exports.internal.activeOwnerTokens.get(owner);
+    if (activeToken) {
+        return activeToken;
+    }
+    const token = Symbol(owner);
+    exports.internal.activeOwnerTokens.set(owner, token);
+    return token;
+}
+function assertActiveModuleContext(context) {
+    if (exports.internal.activeOwnerTokens.get(context.owner) !== context.ownershipToken) {
+        throw new errors_1.ModuleContextInvalidatedError(context.module);
+    }
+}
+function runWithModuleContext(context, callback) {
+    const inheritedContext = exports.internal.executionContext.getStore();
+    if (inheritedContext) {
+        assertActiveModuleContext(inheritedContext);
+    }
+    if (!context.module) {
+        throw new Error("Module execution context requires a module ID.");
+    }
+    const owner = context.owner ?? context.module;
+    const activeContext = {
+        ...context,
+        owner,
+        ownershipToken: getOwnerToken(owner),
+    };
+    return exports.internal.executionContext.run(activeContext, callback);
+}
+function captureModuleContext() {
+    const context = exports.internal.executionContext.getStore();
+    if (context) {
+        assertActiveModuleContext(context);
+    }
+    return context;
+}
+function runWithCapturedModuleContext(context, callback) {
+    assertActiveModuleContext(context);
+    return exports.internal.executionContext.run(context, callback);
+}
+function peekModuleContext() {
+    return exports.internal.executionContext.getStore();
+}
+function getModuleContext() {
+    return captureModuleContext();
+}
+function invalidateModuleContext(owner) {
+    exports.internal.activeOwnerTokens.delete(owner);
+}
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":";;;AAKA,SAAS,aAAa,CAAC,GAA4B,EAAE,GAAW,EAAE,KAAU;IAC1E,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnB,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,gBAAgB;AACH,QAAA,QAAQ,GAAG;IACtB,cAAc,EAAE,EAIb;IACH,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,IAAI,GAAG,EAAsB;IACzC,cAAc,EAAE,IAAI,GAAG,EAAsB;IAC7C,WAAW,EAAE,EAAW;IACxB,oBAAoB,EAAE,EAGrB;IACD,oBAAoB,EAAE,SAET;IACb,mBAAmB,EAAE,SAER;IAEb,aAAa,CAAC,MAAc,EAAE,KAAU;QACtC,aAAa,CAAC,gBAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,mBAAmB,CAAC,MAAc,EAAE,KAAU;QAC5C,aAAa,CAAC,gBAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;CACF,CAAC"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"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"}

package/dist/modules.d.ts

@@ -1,4 +1,10 @@
 import { EventProxy } from ".";
+import { type ModuleExecutionContext } from "./internal";
+/** Runs work with module ownership and an optional provider route across awaits. */
+export declare function RunWithModuleContext<T>(context: ModuleExecutionContext, callback: () => T): T;
+/** Returns the active module execution context, if one exists. */
+export declare function GetModuleContext(): ModuleExecutionContext | undefined;
+export type { ModuleExecutionContext } from "./internal";
 /**
  * Contains events related to module lifecycle management.
  *