@antelopejs/interface-core 0.1.1 → 0.2.1

package/dist/caller-binding.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Binds the functions a caller hands to an interface proxy to the caller's
+ * module context, so they run as the caller's work whoever invokes them.
+ *
+ * Functions, and functions held in plain objects and arrays, are bound; plain
+ * data, class instances and proxies cross unchanged. A value is bound once per
+ * context, and a value that is already bound keeps its original context.
+ */
+export declare function bindCallerArguments<T extends unknown[]>(args: T): T;
+/** Binds a single caller function to the caller's module context. */
+export declare function bindCallerFunction<T extends (...args: any[]) => unknown>(callback: T): T;

package/dist/caller-binding.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindCallerArguments = bindCallerArguments;
+exports.bindCallerFunction = bindCallerFunction;
+const node_util_1 = require("node:util");
+const internal_1 = require("./internal");
+const bindingsBySource = new WeakMap();
+const boundValues = new WeakSet();
+function hasPlainPrototype(value) {
+    if (Array.isArray(value)) {
+        return true;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function isBindableContainer(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !node_util_1.types.isProxy(value) &&
+        hasPlainPrototype(value));
+}
+function holdsFunction(value, visited) {
+    if (typeof value === "function") {
+        return true;
+    }
+    if (!isBindableContainer(value) || visited.has(value)) {
+        return false;
+    }
+    visited.add(value);
+    return Object.values(value).some((member) => holdsFunction(member, visited));
+}
+function needsBinding(value) {
+    if (typeof value === "function") {
+        return !boundValues.has(value);
+    }
+    return (isBindableContainer(value) &&
+        !boundValues.has(value) &&
+        holdsFunction(value, new Set()));
+}
+function createFunctionBinding(target, context) {
+    return new Proxy(target, {
+        apply: (callable, thisArg, argumentsList) => (0, internal_1.runWithCapturedModuleContext)(context, () => callable.apply(thisArg, argumentsList)),
+        construct: (callable, argumentsList, newTarget) => (0, internal_1.runWithCapturedModuleContext)(context, () => Reflect.construct(callable, argumentsList, newTarget)),
+    });
+}
+function createContainerBinding(target, context) {
+    return new Proxy(target, {
+        get: (container, property) => {
+            const member = container[property];
+            const descriptor = Reflect.getOwnPropertyDescriptor(container, property);
+            const isFixed = descriptor !== undefined &&
+                !descriptor.configurable &&
+                "value" in descriptor &&
+                !descriptor.writable;
+            return isFixed ? member : bindValue(member, context);
+        },
+    });
+}
+function bindValue(value, context) {
+    if (!needsBinding(value)) {
+        return value;
+    }
+    const cached = bindingsBySource.get(value)?.get(context);
+    if (cached) {
+        return cached;
+    }
+    const bound = typeof value === "function"
+        ? createFunctionBinding(value, context)
+        : createContainerBinding(value, context);
+    const contexts = bindingsBySource.get(value) ??
+        new WeakMap();
+    contexts.set(context, bound);
+    bindingsBySource.set(value, contexts);
+    boundValues.add(bound);
+    return bound;
+}
+/**
+ * Binds the functions a caller hands to an interface proxy to the caller's
+ * module context, so they run as the caller's work whoever invokes them.
+ *
+ * Functions, and functions held in plain objects and arrays, are bound; plain
+ * data, class instances and proxies cross unchanged. A value is bound once per
+ * context, and a value that is already bound keeps its original context.
+ */
+function bindCallerArguments(args) {
+    const context = (0, internal_1.captureModuleContext)();
+    if (!context) {
+        return args;
+    }
+    return args.map((argument) => bindValue(argument, context));
+}
+/** Binds a single caller function to the caller's module context. */
+function bindCallerFunction(callback) {
+    const context = (0, internal_1.captureModuleContext)();
+    return context ? bindValue(callback, context) : callback;
+}
+//# sourceMappingURL=caller-binding.js.map

package/dist/caller-binding.js.map

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

package/dist/config.d.ts

@@ -73,9 +73,16 @@ export interface AntelopeConfig {
     environments?: Record<string, Partial<AntelopeConfig>>;
     test?: AntelopeTestConfig;
 }
+/**
+ * Binds an interface a module uses, directly or through the interfaces it uses,
+ * to one provider module. The first entry for an interface pins it; further
+ * entries are connections reached by `id`. An entry for a standalone interface
+ * may omit `source`: it then declares a connection to the self-hosted interface,
+ * built on that connection's other bindings.
+ */
 export interface ImportOverride {
     interface: string;
-    source: string;
+    source?: string;
     id?: string;
 }
 export interface AntelopeModuleConfig {
@@ -84,6 +91,25 @@ export interface AntelopeModuleConfig {
     config?: unknown;
     importOverrides?: ImportOverride[] | Record<string, string>;
     disabledExports?: string[];
+    /**
+     * Priority of this module as the default provider of the interfaces it
+     * implements, keyed by interface name. The provider with the highest priority
+     * is chosen where nothing pins the interface; unlisted interfaces have
+     * priority 0.
+     */
+    exportPriority?: Record<string, number>;
+    /**
+     * Keeps the module declared, with its configuration, without loading it.
+     * A disabled module is left out of the project as if it were not listed.
+     */
+    disabled?: boolean;
+    /**
+     * Lets the project start without this module. An optional module is
+     * loaded once the others have started; when it fails to download,
+     * construct or start, the failure is logged and the project runs on
+     * without it.
+     */
+    optional?: boolean;
 }
 export interface AntelopeLogging {
     enabled?: boolean;

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA,sBAAsB;;AAyItB,oCAEC;AAFD,SAAgB,YAAY,CAAC,KAAkB;IAC7C,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";AAAA,sBAAsB;;AAmKtB,oCAEC;AAFD,SAAgB,YAAY,CAAC,KAAkB;IAC7C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/internal.d.ts

@@ -1,15 +1,18 @@
 import { AsyncLocalStorage } from "node:async_hooks";
-export declare const RUNTIME_PROTOCOL_VERSION = 3;
+export declare const RUNTIME_PROTOCOL_VERSION = 4;
 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 to `require()` for the interface instance this connection is bound to. */
     path: string;
-    /** Module ID of the provider represented by this connection. */
-    provider: string;
-    /** Whether this provider is selected for unqualified interface calls. */
+    /**
+     * Module ID of the provider represented by this connection; absent for a
+     * connection to a self-hosted interface.
+     */
+    provider?: string;
+    /** Whether this connection is the one a plain import of the interface reaches. */
     selected: boolean;
 }
 /** Module identity and provider routes propagated through asynchronous work. */
@@ -32,10 +35,6 @@ export interface ProxyBrand {
     kind: "async" | "registering" | "event";
     identity: string;
 }
-export interface RuntimeProxyState {
-    kind: ProxyBrand["kind"];
-    value: unknown;
-}
 export interface RuntimeCleanup {
     cleanup(): void;
     unregisterModule?(module: string): void;
@@ -71,7 +70,6 @@ export interface InterfaceRuntime {
     interfaceConnections: Record<string, Record<string, InterfaceConnection[]>>;
     executionContext: AsyncLocalStorage<ActiveModuleExecutionContext>;
     activeOwnerTokens: Map<string, symbol>;
-    proxyStates: Map<string, RuntimeProxyState>;
     nextProxyIdentity: number;
     nextLeaseGeneration: number;
     maxPendingOperations: number;

package/dist/internal.js

@@ -9,7 +9,7 @@ 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_PROTOCOL_VERSION = 4;
 exports.RUNTIME_SYMBOL = Symbol.for("@antelopejs/interface-core/runtime");
 function addToMapSet(map, key, value) {
     const values = map.get(key) ?? new Set();
@@ -28,7 +28,6 @@ function createRuntime() {
         interfaceConnections: Object.create(null),
         executionContext: new node_async_hooks_1.AsyncLocalStorage(),
         activeOwnerTokens: new Map(),
-        proxyStates: new Map(),
         nextProxyIdentity: 1,
         nextLeaseGeneration: 1,
         maxPendingOperations: 1_000,

package/dist/internal.js.map

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

package/dist/modules.d.ts

@@ -1,3 +1,4 @@
+import type { AntelopeModuleConfig } from "./config";
 import { EventProxy } from "./proxies";
 import { type ModuleExecutionContext } from "./internal";
 /** Runs work with module ownership and an optional provider route across awaits. */
@@ -49,6 +50,13 @@ export declare namespace Events {
      */
     const ModuleDestroyed: EventProxy<(module: string) => void>;
 }
+/**
+ * Releases everything an owner that is not a module generation attached or
+ * registered, and invalidates its context, as a module's destruction does.
+ *
+ * @internal Used by the core to retire an interface instance's own owner.
+ */
+export declare function ReleaseOwner(owner: string): void;
 /**
  * Configuration for defining a module to be loaded into the system.
  *
@@ -169,3 +177,42 @@ export declare const DestroyModule: (module: string) => Promise<void>;
  * @throws Error if the module cannot be reloaded
  */
 export declare const ReloadModule: (module: string) => Promise<void>;
+/**
+ * A module as the project's configuration file declares it, under its key in
+ * `modules`, with the shorthand forms expanded.
+ */
+export type ModuleDeclaration = Pick<AntelopeModuleConfig, "source" | "config" | "disabled" | "optional">;
+/**
+ * The fields of a module's declaration to write. A field left out keeps what
+ * the file already holds.
+ */
+export type ModuleDeclarationChanges = Partial<ModuleDeclaration>;
+/**
+ * List the modules the project's configuration file declares, by key,
+ * disabled ones included.
+ *
+ * @returns The declarations of the top-level `modules` of the file
+ */
+export declare const ListModuleDeclarations: () => Promise<Record<string, ModuleDeclaration>>;
+/**
+ * Write a module's declaration into the project's configuration file.
+ *
+ * Only the given fields of the module's entry are rewritten, and the entry is
+ * added when the file has none: every other line of the file, comments and
+ * expressions included, stays as it was. The running project is not
+ * restarted for this write; the caller loads, stops or reloads the module
+ * itself.
+ *
+ * @param module The module's key in `modules`
+ * @param changes The fields to write
+ * @throws Error if the file has no `modules` object it can edit, such as a
+ *   configuration built by a function
+ */
+export declare const SaveModuleDeclaration: (module: string, changes: Partial<ModuleDeclaration>) => Promise<void>;
+/**
+ * Remove a module's entry from the project's configuration file, leaving the
+ * rest of the file as it was and the running project unrestarted.
+ *
+ * @param module The module's key in `modules`
+ */
+export declare const RemoveModuleDeclaration: (module: string) => Promise<void>;

package/dist/modules.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReloadModule = exports.DestroyModule = exports.StopModule = exports.StartModule = exports.LoadModule = exports.GetModuleInfo = exports.ListModules = exports.Events = void 0;
+exports.RemoveModuleDeclaration = exports.SaveModuleDeclaration = exports.ListModuleDeclarations = exports.ReloadModule = exports.DestroyModule = exports.StopModule = exports.StartModule = exports.LoadModule = exports.GetModuleInfo = exports.ListModules = exports.Events = void 0;
 exports.RunWithModuleContext = RunWithModuleContext;
 exports.GetModuleContext = GetModuleContext;
+exports.ReleaseOwner = ReleaseOwner;
 const proxies_1 = require("./proxies");
 const internal_1 = require("./internal");
 /** Runs work with module ownership and an optional provider route across awaits. */
@@ -121,8 +122,7 @@ function releaseOwnerRegistrations(module, owner) {
         }
     }
 }
-Events.ModuleDestroyed.register((module) => {
-    const owner = getDestroyedOwner(module);
+function releaseOwner(module, owner) {
     try {
         releaseOwnerRegistrations(module, owner);
     }
@@ -130,7 +130,19 @@ Events.ModuleDestroyed.register((module) => {
         // Only now: nothing else may claim to act for this generation.
         (0, internal_1.invalidateModuleContext)(owner);
     }
+}
+Events.ModuleDestroyed.register((module) => {
+    releaseOwner(module, getDestroyedOwner(module));
 });
+/**
+ * Releases everything an owner that is not a module generation attached or
+ * registered, and invalidates its context, as a module's destruction does.
+ *
+ * @internal Used by the core to retire an interface instance's own owner.
+ */
+function ReleaseOwner(owner) {
+    releaseOwner(owner, owner);
+}
 /**
  * List all loaded modules.
  *
@@ -202,4 +214,33 @@ exports.DestroyModule = (0, proxies_1.InterfaceFunction)("modules.DestroyModule"
  * @throws Error if the module cannot be reloaded
  */
 exports.ReloadModule = (0, proxies_1.InterfaceFunction)("modules.ReloadModule");
+/**
+ * List the modules the project's configuration file declares, by key,
+ * disabled ones included.
+ *
+ * @returns The declarations of the top-level `modules` of the file
+ */
+exports.ListModuleDeclarations = (0, proxies_1.InterfaceFunction)("modules.ListModuleDeclarations");
+/**
+ * Write a module's declaration into the project's configuration file.
+ *
+ * Only the given fields of the module's entry are rewritten, and the entry is
+ * added when the file has none: every other line of the file, comments and
+ * expressions included, stays as it was. The running project is not
+ * restarted for this write; the caller loads, stops or reloads the module
+ * itself.
+ *
+ * @param module The module's key in `modules`
+ * @param changes The fields to write
+ * @throws Error if the file has no `modules` object it can edit, such as a
+ *   configuration built by a function
+ */
+exports.SaveModuleDeclaration = (0, proxies_1.InterfaceFunction)("modules.SaveModuleDeclaration");
+/**
+ * Remove a module's entry from the project's configuration file, leaving the
+ * rest of the file as it was and the running project unrestarted.
+ *
+ * @param module The module's key in `modules`
+ */
+exports.RemoveModuleDeclaration = (0, proxies_1.InterfaceFunction)("modules.RemoveModuleDeclaration");
 //# sourceMappingURL=modules.js.map

package/dist/modules.js.map

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

package/dist/proxies.d.ts

@@ -5,51 +5,53 @@ type RID<T> = T extends (id: infer P, ...args: any[]) => void ? P : never;
 type RArgs<T> = T extends (id: any, ...args: infer P) => void ? P : never;
 type ProxyKind = ProxyBrand["kind"];
 declare const PROXY_BRAND: unique symbol;
+/** The handle of one provider attachment, used to detach exactly that attachment. */
 export interface AttachmentLease {
     generation: number;
     owner: string;
-    provider: string;
 }
 /** Returns whether a value implements this runtime's stable proxy protocol. */
 export declare function IsInterfaceProxy(value: unknown, kind?: ProxyKind): boolean;
-/** Returns the stable identity used to bind a proxy to a provider route. */
+/** Returns the identity a proxy was declared with, for diagnostics. */
 export declare function GetInterfaceProxyIdentity(value: unknown): string | undefined;
 /** @internal */
 export declare function InvalidateResponsibleModule(module: string): void;
 /** Runs work with explicit module ownership across asynchronous boundaries. */
 export declare function RunWithResponsibleModule<T>(module: string, callback: () => T): T;
-/** Proxy for an asynchronous interface function. */
+/** Proxy for an asynchronous interface function, served by a single provider. */
 export declare class AsyncProxy<T extends Func = Func, R = Awaited<ReturnType<T>>> {
     readonly [PROXY_BRAND]: ProxyBrand;
-    private readonly state;
+    private attachment?;
+    private queue;
     constructor(identity?: string);
-    /** Attaches a provider callback and replays compatible queued calls. */
+    /** Attaches the provider callback, replacing any previous one, and replays queued calls. */
     onCall(callback: T, manualDetach?: boolean): AttachmentLease;
-    /** Detaches one leased provider, or every provider when called without a lease. */
+    /** Detaches the leased attachment, or the current one when called without a lease. */
     detach(lease?: AttachmentLease): void;
-    /** Calls the provider selected by the current module execution context. */
+    /** Calls the provider, or queues the call until a provider attaches. */
     call(...args: Parameters<T>): Promise<R>;
     private invoke;
     private replayQueue;
 }
 /** Creates an interface function backed by an asynchronous proxy. */
 export declare function InterfaceFunction<T extends Func = Func, R = Awaited<ReturnType<T>>>(identity?: string): (...args: Parameters<T>) => Promise<R>;
-/** Proxy for provider-aware register and unregister handlers. */
+/** Proxy for register and unregister handlers, served by a single provider. */
 export declare class RegisteringProxy<T extends RegisterFunction = RegisterFunction> {
     readonly [PROXY_BRAND]: ProxyBrand;
-    private readonly state;
+    private handlers;
+    private readonly registered;
     constructor(identity?: string);
     /** Attaches a register callback. */
     onRegister(callback: T, manualDetach?: boolean): AttachmentLease;
-    /** Attaches an unregister callback to the current provider route. */
+    /** Attaches an unregister callback, sharing the register callback's owner when it is the caller's. */
     onUnregister(callback: (id: RID<T>) => void): AttachmentLease;
     /** Atomically attaches both registration handlers. */
     onHandlers(register: T, unregister: (id: RID<T>) => void, manualDetach?: boolean): AttachmentLease;
-    /** Detaches one leased provider, or every provider when called without a lease. */
+    /** Detaches the leased handlers, or both handlers when called without a lease. */
     detach(lease?: AttachmentLease): void;
-    /** Registers an entry with the selected provider and keeps it for replay on (re)attach. */
+    /** Registers an entry with the provider and keeps it for replay on (re)attach. */
     register(id: RID<T>, ...args: RArgs<T>): void;
-    /** Unregisters an entry from the provider that accepted it. */
+    /** Unregisters an entry from the provider. */
     unregister(id: RID<T>): void;
     /** Unregisters every entry owned by a destroyed module. */
     unregisterModule(module: string): void;
@@ -59,15 +61,14 @@ export declare class RegisteringProxy<T extends RegisterFunction = RegisterFunct
     private attachRegister;
     private attachUnregister;
     private trackAttachment;
-    private createLease;
     private createAttachment;
     private replayRegistrations;
 }
 type EventFunction = (...args: any[]) => void;
-/** Module-aware event handler collection. */
+/** Module-aware event handler collection; each handler runs in its registrant's context. */
 export declare class EventProxy<T extends EventFunction = EventFunction> {
     readonly [PROXY_BRAND]: ProxyBrand;
-    private readonly state;
+    private registered;
     constructor(identity?: string);
     /** Emits to every handler, reporting failures without aborting later handlers. */
     emit(...args: Parameters<T>): void;