@antelopejs/interface-core 0.0.10 → 0.0.12

package/dist/tests/provider-context.test.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const __1 = require("..");
+const modules_1 = require("../modules");
+function observeContext() {
+    const context = (0, modules_1.GetModuleContext)();
+    return {
+        module: context?.module,
+        owner: context?.owner,
+        provider: context?.provider,
+    };
+}
+describe("provider callback context", () => {
+    it("restores async provider context across awaits and nested calls", async () => {
+        const nested = new __1.AsyncProxy("context.nested");
+        const outer = new __1.AsyncProxy("context.outer");
+        const nestedIdentity = (0, __1.GetInterfaceProxyIdentity)(nested);
+        const outerIdentity = (0, __1.GetInterfaceProxyIdentity)(outer);
+        (0, modules_1.RunWithModuleContext)({ module: "nested-owner", owner: "nested#1", provider: "nested" }, () => nested.onCall(() => `${observeContext().owner}:value`));
+        (0, modules_1.RunWithModuleContext)({
+            module: "provider-owner",
+            owner: "provider-owner#1",
+            provider: "provider-a",
+            providerRoutes: { [nestedIdentity]: "nested" },
+        }, () => outer.onCall(async () => {
+            const beforeAwait = observeContext();
+            await Promise.resolve();
+            const afterAwait = observeContext();
+            (0, chai_1.expect)(await nested.call()).to.equal("nested#1:value");
+            return [beforeAwait, afterAwait, observeContext()];
+        }));
+        const observations = await (0, modules_1.RunWithModuleContext)({
+            module: "consumer",
+            owner: "consumer#1",
+            providerRoutes: { [outerIdentity]: "provider-a" },
+        }, () => outer.call());
+        (0, chai_1.expect)(observations).to.deep.equal(Array.from({ length: 3 }, () => ({
+            module: "provider-owner",
+            owner: "provider-owner#1",
+            provider: "provider-a",
+        })));
+    });
+    it("restores registering context for replay, register and unregister", () => {
+        const proxy = new __1.RegisteringProxy("context.registering");
+        const identity = (0, __1.GetInterfaceProxyIdentity)(proxy);
+        const observations = [];
+        (0, modules_1.RunWithModuleContext)({ module: "consumer", owner: "consumer#1" }, () => {
+            proxy.register("queued");
+        });
+        (0, modules_1.RunWithModuleContext)({ module: "provider-owner", owner: "provider#1", provider: "provider" }, () => {
+            proxy.onHandlers((id) => observations.push({
+                operation: `register:${id}`,
+                context: observeContext(),
+            }), (id) => observations.push({
+                operation: `unregister:${id}`,
+                context: observeContext(),
+            }));
+        });
+        (0, modules_1.RunWithModuleContext)({
+            module: "consumer",
+            owner: "consumer#1",
+            providerRoutes: { [identity]: "provider" },
+        }, () => {
+            proxy.register("direct");
+            proxy.unregister("queued");
+            proxy.unregister("direct");
+        });
+        (0, chai_1.expect)(observations.map(({ operation }) => operation)).to.deep.equal([
+            "register:queued",
+            "register:direct",
+            "unregister:queued",
+            "unregister:direct",
+        ]);
+        (0, chai_1.expect)(observations.map(({ context }) => context)).to.deep.equal(Array.from({ length: 4 }, () => ({
+            module: "provider-owner",
+            owner: "provider#1",
+            provider: "provider",
+        })));
+    });
+    it("preserves synchronous registering callback throws", () => {
+        const proxy = new __1.RegisteringProxy("context.registering-throw");
+        const failure = new Error("register failed");
+        (0, modules_1.RunWithModuleContext)({ module: "provider", owner: "provider-throw#1", provider: "provider" }, () => proxy.onHandlers(() => {
+            (0, chai_1.expect)(observeContext().owner).to.equal("provider-throw#1");
+            throw failure;
+        }, () => undefined));
+        (0, chai_1.expect)(() => proxy.register("item")).to.throw(failure);
+    });
+    it("rejects callbacks captured from an invalidated owner", async () => {
+        const proxy = new __1.AsyncProxy("context.invalidated");
+        const identity = (0, __1.GetInterfaceProxyIdentity)(proxy);
+        (0, modules_1.RunWithModuleContext)({ module: "provider", owner: "provider-old#1", provider: "provider" }, () => {
+            proxy.onCall(() => "stale", true);
+            modules_1.Events.ModuleDestroyed.emit("provider");
+        });
+        const error = await (0, modules_1.RunWithModuleContext)({
+            module: "consumer",
+            owner: "consumer#1",
+            providerRoutes: { [identity]: "provider" },
+        }, () => proxy.call().then(() => undefined, (reason) => reason));
+        (0, chai_1.expect)(error).to.be.instanceOf(__1.ModuleContextInvalidatedError);
+    });
+    it("rejects registering handlers captured from an invalidated owner", () => {
+        const proxy = new __1.RegisteringProxy("context.invalidated-registering");
+        (0, modules_1.RunWithModuleContext)({
+            module: "provider",
+            owner: "provider-register#old",
+            provider: "provider",
+        }, () => {
+            proxy.onHandlers(() => undefined, () => undefined, true);
+            modules_1.Events.ModuleDestroyed.emit("provider");
+        });
+        (0, chai_1.expect)(() => proxy.register("item")).to.throw(__1.ModuleContextInvalidatedError);
+    });
+});
+//# sourceMappingURL=provider-context.test.js.map

package/dist/tests/provider-context.test.js.map

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

package/dist/tests/root-declarations.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/root-declarations.test.js

@@ -0,0 +1,94 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = require("node:path");
+const chai_1 = require("chai");
+const declarations = __importStar(require(".."));
+const modules = __importStar(require("../modules"));
+const runtime = __importStar(require("../runtime"));
+const PACKAGE_ROOT = (0, node_path_1.resolve)(__dirname, "..", "..");
+const FRESH_PROCESS_CONTRACT = `
+const assert = require("node:assert/strict");
+const path = require("node:path");
+const root = process.env.INTERFACE_CORE_ROOT;
+const entries = {
+  root: path.join(root, "dist"),
+  modules: path.join(root, "dist", "modules.js"),
+  runtime: path.join(root, "dist", "runtime.js"),
+};
+const loaded = Object.fromEntries(
+  process.env.INTERFACE_CORE_ORDER.split(",").map((entry) => [entry, require(entries[entry])]),
+);
+const core = loaded.root;
+const modules = loaded.modules;
+const runtime = loaded.runtime;
+assert.equal(core.Events, modules.Events);
+assert.equal(core.ListModules, modules.ListModules);
+assert.equal(core.GetModuleInfo, modules.GetModuleInfo);
+assert.equal(core.GetRuntimeInfo, runtime.GetRuntimeInfo);
+assert.equal(core.RegisterDevServer, runtime.RegisterDevServer);
+assert.equal(core.IsInterfaceProxy(core.ListModules.proxy), true);
+assert.equal(core.IsInterfaceProxy(core.GetRuntimeInfo.proxy), true);
+assert.equal(core.GetInterfaceProxyIdentity(core.ListModules.proxy), "async:modules.ListModules");
+assert.equal(core.GetInterfaceProxyIdentity(core.GetRuntimeInfo.proxy), "async:runtime.GetRuntimeInfo");
+`;
+function runFreshProcess(order) {
+    (0, node_child_process_1.execFileSync)(process.execPath, ["-e", FRESH_PROCESS_CONTRACT], {
+        env: {
+            ...process.env,
+            INTERFACE_CORE_ORDER: order,
+            INTERFACE_CORE_ROOT: PACKAGE_ROOT,
+        },
+    });
+}
+describe("root interface declarations", () => {
+    it("exports the canonical runtime proxies", () => {
+        (0, chai_1.expect)(declarations.GetRuntimeInfo).to.equal(runtime.GetRuntimeInfo);
+        (0, chai_1.expect)(declarations.RegisterDevServer).to.equal(runtime.RegisterDevServer);
+    });
+    it("exports the canonical module proxies", () => {
+        (0, chai_1.expect)(declarations.Events).to.equal(modules.Events);
+        (0, chai_1.expect)(declarations.ListModules).to.equal(modules.ListModules);
+        (0, chai_1.expect)(declarations.GetModuleInfo).to.equal(modules.GetModuleInfo);
+    });
+    it("loads complete canonical declarations when the root loads first", () => {
+        runFreshProcess("root,runtime,modules");
+    });
+    it("loads complete canonical declarations when subpaths load first", () => {
+        runFreshProcess("modules,runtime,root");
+    });
+});
+//# sourceMappingURL=root-declarations.test.js.map

package/dist/tests/root-declarations.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-declarations.test.js","sourceRoot":"","sources":["../../src/tests/root-declarations.test.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2DAAkD;AAClD,yCAAoC;AACpC,+BAA8B;AAC9B,iDAAmC;AACnC,oDAAsC;AACtC,oDAAsC;AAEtC,MAAM,YAAY,GAAG,IAAA,mBAAO,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACpD,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwB9B,CAAC;AAEF,SAAS,eAAe,CAAC,KAAa;IACpC,IAAA,iCAAY,EAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,sBAAsB,CAAC,EAAE;QAC7D,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,oBAAoB,EAAE,KAAK;YAC3B,mBAAmB,EAAE,YAAY;SAClC;KACF,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,IAAA,aAAM,EAAC,YAAY,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACrE,IAAA,aAAM,EAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,IAAA,aAAM,EAAC,YAAY,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACrD,IAAA,aAAM,EAAC,YAAY,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/D,IAAA,aAAM,EAAC,YAAY,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,eAAe,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,eAAe,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tests/runtime-protocol.test.js

@@ -5,6 +5,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const chai_1 = require("chai");
 const __1 = require("..");
+const modules_1 = require("../modules");
 describe("global runtime protocol", () => {
     let copyPath;
     afterEach(() => {
@@ -18,16 +19,19 @@ describe("global runtime protocol", () => {
         copyPath = (0, node_path_1.join)(temporary, "dist");
         (0, node_fs_1.cpSync)((0, node_path_1.join)(__dirname, ".."), copyPath, { recursive: true });
         const foreign = require((0, node_path_1.join)(copyPath, "index.js"));
+        const foreignModules = require((0, node_path_1.join)(copyPath, "modules.js"));
         const localProxy = new __1.AsyncProxy("test.cross-copy");
         const foreignProxy = new foreign.AsyncProxy("test.cross-copy");
         (0, chai_1.expect)(foreignProxy).not.to.be.instanceOf(__1.AsyncProxy);
         (0, chai_1.expect)((0, __1.RunWithResponsibleModule)("shared-owner", () => foreign.GetResponsibleModule())).to.equal("shared-owner");
-        foreign.ImplementInterface({ proxy: localProxy }, { proxy: () => "shared" });
-        (0, chai_1.expect)(await foreignProxy.call()).to.equal("shared");
-        (0, __1.ImplementInterface)({ proxy: foreignProxy }, {
-            proxy: () => "local",
-        });
-        (0, chai_1.expect)(await localProxy.call()).to.equal("local");
+        (0, modules_1.RunWithModuleContext)({ module: "provider", owner: "provider#copy", provider: "provider" }, () => foreign.ImplementInterface({ proxy: localProxy }, {
+            proxy: () => foreignModules.GetModuleContext()?.owner ?? "missing",
+        }));
+        (0, chai_1.expect)(await (0, modules_1.RunWithModuleContext)({
+            module: "consumer",
+            owner: "consumer#copy",
+            providerRoutes: { "async:test.cross-copy": "provider" },
+        }, () => foreignProxy.call())).to.equal("provider#copy");
     });
     it("fails clearly when a realm already contains an incompatible protocol", () => {
         const internalPath = (0, node_path_1.join)(__dirname, "..", "internal.js");

package/dist/tests/runtime-protocol.test.js.map

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

package/docs/2.proxies.md

@@ -31,6 +31,8 @@ const greeting = await proxy.call("Bob"); // "Hello, Bob!"
 
 Attaches a callback function to the proxy. The proxy automatically tracks the calling module and detaches the callback when that module is unloaded. Pass `manualDetach: true` to disable automatic cleanup.
 
+When attachment occurs inside `RunWithModuleContext`, calls execute in the captured provider context rather than the consumer context. The captured module, owner generation, provider, and provider routes remain available across nested calls and `await`. Calls reject with `ModuleContextInvalidatedError` if the captured owner has been destroyed.
+
 ```ts
 // Automatic cleanup (default) - detaches when the module unloads
 proxy.onCall(myHandler);
@@ -127,10 +129,14 @@ routeRegistry.unregister("about");
 
 Attaches the register callback. Any previously registered entries replay through this callback immediately. Automatic module-aware detachment applies unless `manualDetach` is `true`.
 
+Register replay and direct registration execute in the provider context captured when the callback attaches.
+
 ### `onUnregister(callback)`
 
 Attaches the unregister callback. This callback is detached at the same time as the register callback.
 
+Unregistration executes in the context captured when this callback attaches.
+
 ### `register(id, ...args)`
 
 Registers an entry with the given identifier. If a register callback is attached, it executes immediately. Otherwise, the entry is stored and replayed when a callback is attached. The calling module is tracked for automatic cleanup.
@@ -208,6 +214,17 @@ const connections = GetInterfaceInstances("database");
 const primary = GetInterfaceInstance("database", "primary");
 ```
 
+Each `InterfaceConnection` includes the provider module ID and whether that provider is selected for unqualified calls:
+
+```ts
+interface InterfaceConnection {
+  id?: string;
+  path: string;
+  provider: string;
+  selected: boolean;
+}
+```
+
 ## `GetResponsibleModule`
 
 `GetResponsibleModule` inspects the call stack to determine which module is responsible for the current execution. The proxy classes use this internally for automatic cleanup tracking.
@@ -235,7 +252,7 @@ await RunWithResponsibleModule("my-module", async () => {
 
 The module loader should wrap known module-owned entry points, including module evaluation and lifecycle hooks. Existing callers need no migration: outside an explicit context, `GetResponsibleModule` retains stack-based resolution as a backward-compatible fallback. Automatic proxy detachment and registration cleanup use the resolved module in both paths.
 
-Ownership contexts are scoped to a loaded module generation. `ModuleDestroyed` invalidates that generation before cleanup, so detached asynchronous work cannot add stale providers or handlers afterward. Such work receives a `ModuleContextInvalidatedError`. A later invocation for the same module ID creates a fresh generation without reactivating older contexts.
+Ownership contexts are scoped to a loaded module generation. Loaders that can overlap old and replacement instances should use `RunWithModuleContext` and provide a unique `owner` for every generation. `ModuleDestroyed` invalidates and cleans only the active event context's owner while preserving the existing module ID event contract. Detached asynchronous work from that owner then receives a `ModuleContextInvalidatedError`.
 
 ## Next steps
 

package/docs/5.modules.md

@@ -35,6 +35,26 @@ loaded -> constructed -> active -> constructed -> loaded
 | `active`      | Module is fully started and providing services               |
 | `unknown`     | Module status cannot be determined                           |
 
+## Module execution context
+
+`RunWithModuleContext` propagates module ownership and provider routing through synchronous and asynchronous work:
+
+```ts
+import { RunWithModuleContext } from "@antelopejs/interface-core/modules";
+
+await RunWithModuleContext(
+  {
+    module: "search-provider",
+    owner: "search-provider#42",
+    provider: "search-provider",
+    providerRoutes: routes,
+  },
+  () => constructModule(),
+);
+```
+
+`module` remains the stable public module ID. `owner` identifies one lifecycle generation and should be unique when old and replacement instances can overlap. Providers capture this full context when attaching callbacks. `GetModuleContext` returns the active context and throws `ModuleContextInvalidatedError` after its owner is destroyed.
+
 ## Lifecycle events
 
 The `Events` namespace exposes four `EventProxy` instances that fire during module lifecycle transitions.
@@ -81,6 +101,8 @@ Events.ModuleDestroyed.register((moduleId: string) => {
 });
 ```
 
+The event signature remains the module ID. When emitted inside `RunWithModuleContext`, cleanup targets that context's `owner`; without an explicit owner it retains the module-level behavior used by earlier releases.
+
 ## Management functions
 
 These functions are declared as `InterfaceFunction` proxies. They are available once the core runtime provides their implementation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/interface-core",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "AntelopeJS core interface primitives - proxies, decorators, interface functions, and logging",
   "keywords": [
     "antelopejs",
@@ -78,7 +78,8 @@
     "lint": "biome check .",
     "prepack": "pnpm run build",
     "release": "pnpm run lint && pnpm run prepack && release-it",
-    "test": "pnpm run build && ajs module test ."
+    "test": "pnpm run build && ajs module test .",
+    "test:package": "node test/package-consumer.mjs"
   },
   "antelopeJs": {
     "test": "src/antelope.test.ts",