@databehave/core 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+## [Unreleased]
+
+Upcoming package version: **0.2.0**. This section describes planned release contents, not a published release.
+
+### Breaking changes
+
+- Require Node.js 24.22.1+ within 24.x or 26.12.1+ within 26.x to enforce the updated security patch floors.
+
+### Changed
+
+- Refresh the shared build, test and release tooling dependencies.
+
+See [migration](../../MIGRATION.md) and [release procedures](../../docs/releasing.md).
+
+## [0.1.0]
+
+### Runtime requirements
+
+- Require Node.js 24 or 26; support and test majors 24 and 26. Node.js 18, 20 and 22 are unsupported.
+
+### Added
+
+- Typed versioned capabilities, explicit dependency validation and instance-local plugin registration.
+- Synchronous setup/sealing and separate prepare, activate and open barriers.
+- Idempotent startup/close, cancellation, ingress drain and reverse resource disposal with cleanup failure reporting.
+
+See [migration](../../MIGRATION.md) and [release procedures](../../docs/releasing.md).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ochairo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# @databehave/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Explicit, typed plugin composition with no product dependencies or global registry.
+
+Requires Node.js 24.22.1+ (24.x) or 26.12.1+ (26.x); supported majors are 24 and 26. See the
+[plugin author guide](../../docs/plugins.md) and [runnable plugin example](../../examples/plugin.mjs).
+
+```ts
+import { capability, createHost, type Plugin } from '@databehave/core'
+
+const greeting = capability<{ text: string }>('example/greeting', 1)
+const provider: Plugin = {
+  id: 'greeting',
+  apiVersion: 1,
+  provides: [greeting],
+  setup(ctx) { ctx.provide(greeting, { text: 'Hello' }) },
+}
+const consumer: Plugin = {
+  id: 'printer',
+  apiVersion: 1,
+  requires: [greeting],
+  setup() {},
+  activate(ctx) { console.log(ctx.use(greeting).text) },
+}
+const host = createHost({ plugins: [consumer, provider] })
+await host.start()
+await host.close()
+```
+
+Capability identity is its nonempty, trimmed name and positive integer version. Separate
+copies of a contract match by those values. Generic tokens connect the capability's
+value type to `provide`, `use`, and `get`; JavaScript values are trusted to honor that
+contract. Names should be package-qualified. Duplicate providers of the same name/version,
+missing requirements, duplicate plugin IDs, invalid API versions and cycles fail before
+setup. Different capability versions may coexist when explicitly provided and required.
+Plugins may only provide declared capabilities and consume declared requirements.
+`host.get(token)` is for the application's composition boundary; it does not extend the
+service's lifetime past host shutdown. Omitted plugins contribute no capabilities.
+
+`createHost` validates the complete graph, runs synchronous setup in dependency order,
+then invokes seal callbacks. Setup must not perform I/O or acquire resources. Async setup
+and seal callbacks are rejected; trusted plugin code is not sandboxed and cannot be
+forcibly undone. Setup contexts expire when their setup returns. Seal callbacks run after
+all setup contributions and should seal feature-owned registries. Register contributions
+through those feature contracts only while registration remains open.
+
+Registration snapshots plugin identities and callback references. Object literals and class implementations
+are supported; callbacks retain their original receiver, including private fields. Reassigning a handler
+after construction does not replace the registered handler. Receiver and closure state remain plugin-owned.
+
+Startup runs separate `prepare`, `activate`, then `open` barriers. Each phase is sequential:
+providers precede consumers, and available independent plugins follow configuration order.
+Context `order` always gives the original configuration index, allowing feature-owned
+middleware ordering independent of dependency ordering. All preparation finishes before
+any activation, and all activation finishes before any external ingress opens.
+
+Call `ctx.defer(dispose)` immediately when acquiring each resource. Only `open` may call
+`ctx.ownIngress({ stopAccepting, drainAndClose })`; do not also register the same ingress
+as an ordinary disposer. Close stops all registered ingress synchronously, aborts the
+lifetime signal, waits for the current startup hook, drains ingress in reverse acquisition
+order, and disposes other resources in reverse acquisition order. A hook completing after
+cancellation may still register its acquisitions; late ingress stops immediately. Its
+context expires on completion, so detached background acquisition is unsupported. Hooks
+must cooperate with cancellation, and ingress implementations own bounded draining.
+
+Concurrent `start()` calls share one promise, as do all `close()` calls. Close during
+startup prevents subsequent hooks/phases and rejects startup after cleanup. Repeated
+start after a completed start returns that original promise and never restarts the host.
+Closing before start rejects a later start. Failure is terminal: create a new host to retry.
+Cleanup continues after errors and rejects with `AggregateError`; startup cleanup errors
+also retain the original startup error as the first error and `cause`. If cleanup succeeds,
+startup rejects with the original failure and close succeeds. States are `ready`, `starting`,
+`running`, `closing`, `closed`, and `failed`.
+
+Run `pnpm typecheck`, `pnpm test`, and `pnpm build` in the project development container.
+The root `api:check` command verifies the package API report in `etc/core.api.md`.
+Use `api:update` when intentionally changing the public contract.

package/dist/capability.d.ts

@@ -0,0 +1,5 @@
+import type { Capability, CapabilityKey } from './contracts.js';
+/** Create a token; matching depends on name/version, never object or symbol identity. */
+export declare function capability<T>(name: string, version?: number): Capability<T>;
+export declare function capabilityId(token: CapabilityKey): string;
+//# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE/D,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAItE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAQzD"}

package/dist/capability.js

@@ -0,0 +1,16 @@
+/** Create a token; matching depends on name/version, never object or symbol identity. */
+export function capability(name, version = 1) {
+    const token = { name, version };
+    capabilityId(token);
+    return Object.freeze(token);
+}
+export function capabilityId(token) {
+    if (!token || typeof token.name !== 'string' || token.name.trim() !== token.name || !token.name) {
+        throw new Error('Capability name must be a nonempty trimmed string');
+    }
+    if (!Number.isSafeInteger(token.version) || token.version < 1) {
+        throw new Error(`Invalid capability version for ${token.name}`);
+    }
+    return JSON.stringify([token.name, token.version]);
+}
+//# sourceMappingURL=capability.js.map

package/dist/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAEA,yFAAyF;AACzF,MAAM,UAAU,UAAU,CAAI,IAAY,EAAE,OAAO,GAAG,CAAC;IACrD,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IAC/B,YAAY,CAAC,KAAK,CAAC,CAAA;IACnB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAA;IACtE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;AACpD,CAAC"}

package/dist/contracts.d.ts

@@ -0,0 +1,52 @@
+/** Stable identity shared by separately installed copies of a capability contract. */
+export interface CapabilityKey {
+    readonly name: string;
+    readonly version: number;
+}
+/** Typed capability identity. The optional phantom member carries no runtime state. */
+export interface Capability<T> extends CapabilityKey {
+    readonly __valueType?: (value: T) => T;
+}
+/** Synchronous, effect-free registration, available only during the plugin's setup. */
+export interface SetupContext {
+    /** Original configuration index, independent of dependency ordering. */
+    readonly order: number;
+    use<T>(token: Capability<T>): T;
+    provide<T>(token: Capability<T>, value: T): void;
+    onSeal(fn: () => void): void;
+}
+/** External ingress stops synchronously before lifetime cancellation and draining. */
+export interface IngressHandle {
+    stopAccepting(): void;
+    drainAndClose(): Promise<void>;
+}
+/** Resource ownership for one running hook; register cleanup immediately on acquisition. */
+export interface LifecycleContext {
+    /** Original configuration index, independent of dependency ordering. */
+    readonly order: number;
+    use<T>(token: Capability<T>): T;
+    readonly signal: AbortSignal;
+    defer(dispose: () => void | Promise<void>): void;
+    ownIngress(handle: IngressHandle): void;
+}
+/** An explicit capability provider/consumer using host contract version 1. */
+export interface Plugin {
+    readonly id: string;
+    readonly apiVersion: 1;
+    readonly provides?: readonly CapabilityKey[];
+    readonly requires?: readonly CapabilityKey[];
+    setup(ctx: SetupContext): void;
+    prepare?(ctx: LifecycleContext): void | Promise<void>;
+    activate?(ctx: LifecycleContext): void | Promise<void>;
+    open?(ctx: LifecycleContext): void | Promise<void>;
+}
+/** A host is terminal after close or failure; create another host to restart. */
+export type HostState = 'ready' | 'starting' | 'running' | 'closing' | 'closed' | 'failed';
+/** Independently owned application lifetime and its sealed capabilities. */
+export interface Host {
+    readonly state: HostState;
+    start(): Promise<void>;
+    close(): Promise<void>;
+    get<T>(token: Capability<T>): T;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,uFAAuF;AACvF,MAAM,WAAW,UAAU,CAAC,CAAC,CAAE,SAAQ,aAAa;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAA;CACvC;AAED,uFAAuF;AACvF,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAC/B,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAA;IAChD,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;CAC7B;AAED,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC5B,aAAa,IAAI,IAAI,CAAA;IACrB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED,4FAA4F;AAC5F,MAAM,WAAW,gBAAgB;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAChD,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;CACxC;AAED,8EAA8E;AAC9E,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAA;IAC5C,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAAA;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrD,QAAQ,CAAC,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,IAAI,CAAC,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD;AAED,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE1F,4EAA4E;AAC5E,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;CAChC"}

package/dist/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":""}

package/dist/host.d.ts

@@ -0,0 +1,6 @@
+import type { Host, Plugin } from './contracts.js';
+/** Validate, register and seal plugins synchronously, without starting their effects. */
+export declare function createHost(options: {
+    readonly plugins: readonly Plugin[];
+}): Host;
+//# sourceMappingURL=host.d.ts.map

package/dist/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA8C,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAG9F,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAsHjF"}

package/dist/host.js

@@ -0,0 +1,147 @@
+import { register } from './registration.js';
+/** Validate, register and seal plugins synchronously, without starting their effects. */
+export function createHost(options) {
+    const registration = register(options.plugins);
+    const lifetime = new AbortController();
+    const disposers = [];
+    const ingress = [];
+    const stopped = new Set();
+    const cleanupErrors = [];
+    let state = 'ready';
+    let startPromise;
+    let execution;
+    let closePromise;
+    let failed = false;
+    let startupError;
+    let closing = false;
+    function stopAccepting(handle) {
+        if (stopped.has(handle))
+            return;
+        stopped.add(handle);
+        try {
+            handle.stopAccepting();
+        }
+        catch (error) {
+            cleanupErrors.push(error);
+        }
+    }
+    function beginClose() {
+        closing = true;
+        state = 'closing';
+        for (const handle of ingress)
+            stopAccepting(handle);
+        lifetime.abort();
+    }
+    async function cleanup() {
+        // A completing hook still owns its context, and can register a newly acquired resource.
+        try {
+            await execution;
+        }
+        catch { /* Startup failure is retained separately. */ }
+        for (const handle of [...ingress].reverse()) {
+            try {
+                await handle.drainAndClose();
+            }
+            catch (error) {
+                cleanupErrors.push(error);
+            }
+        }
+        for (const dispose of disposers.reverse()) {
+            try {
+                await dispose();
+            }
+            catch (error) {
+                cleanupErrors.push(error);
+            }
+        }
+        state = failed || cleanupErrors.length ? 'failed' : 'closed';
+        if (cleanupErrors.length) {
+            throw new AggregateError(failed ? [startupError, ...cleanupErrors] : cleanupErrors, 'Host cleanup failed', failed ? { cause: startupError } : undefined);
+        }
+    }
+    function close() {
+        if (!closePromise) {
+            // Schedule cleanup after installing the shared promise, before invoking plugin callbacks.
+            closePromise = Promise.resolve().then(cleanup);
+            beginClose();
+        }
+        return closePromise;
+    }
+    async function run() {
+        for (const phase of ['prepare', 'activate', 'open']) {
+            for (const owner of registration.ordered) {
+                if (closing)
+                    return;
+                const hook = owner.plugin[phase];
+                if (!hook)
+                    continue;
+                let active = true;
+                function assertActive() {
+                    if (!active)
+                        throw new Error(`Lifecycle context expired for ${owner.plugin.id}:${phase}`);
+                }
+                const context = {
+                    order: owner.order,
+                    signal: lifetime.signal,
+                    use(token) {
+                        assertActive();
+                        return registration.use(owner, token);
+                    },
+                    defer(dispose) {
+                        assertActive();
+                        if (typeof dispose !== 'function')
+                            throw new Error('Disposer must be a function');
+                        disposers.push(dispose);
+                    },
+                    ownIngress(handle) {
+                        assertActive();
+                        if (phase !== 'open')
+                            throw new Error('Ingress may only be acquired during open');
+                        if (!handle || typeof handle.stopAccepting !== 'function' || typeof handle.drainAndClose !== 'function') {
+                            throw new Error('Invalid ingress handle');
+                        }
+                        if (ingress.includes(handle))
+                            throw new Error('Ingress handle already owned');
+                        ingress.push(handle);
+                        if (closing)
+                            stopAccepting(handle);
+                    },
+                };
+                try {
+                    await hook.call(owner.plugin, context);
+                }
+                finally {
+                    active = false;
+                }
+            }
+        }
+    }
+    function start() {
+        if (!startPromise) {
+            if (closing) {
+                startPromise = Promise.reject(new Error('Cannot start a closed host'));
+            }
+            else {
+                state = 'starting';
+                execution = Promise.resolve().then(run).catch((error) => {
+                    failed = true;
+                    startupError = error;
+                    throw error;
+                });
+                startPromise = execution.then(async () => {
+                    if (closing) {
+                        await close();
+                        throw new Error('Host closed during startup');
+                    }
+                    state = 'running';
+                }, async (error) => {
+                    await close();
+                    throw error;
+                });
+            }
+        }
+        return startPromise;
+    }
+    return { start, close, get: registration.get, get state() { return state; } };
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { Capability, CapabilityKey, Host, HostState, IngressHandle, LifecycleContext, Plugin, SetupContext, } from './contracts.js';
+export { capability } from './capability.js';
+export { createHost } from './host.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,aAAa,EACb,IAAI,EACJ,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,MAAM,EACN,YAAY,GACb,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { capability } from './capability.js';
+export { createHost } from './host.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA"}

package/dist/registration.d.ts

@@ -0,0 +1,17 @@
+import type { Capability, Plugin } from './contracts.js';
+/** Validated snapshot of one plugin and its declared capability identities. */
+export interface RegisteredPlugin {
+    readonly order: number;
+    readonly plugin: Plugin;
+    readonly provides: ReadonlySet<string>;
+    readonly requires: ReadonlySet<string>;
+}
+/** The sealed, instance-local service registry and deterministic dependency order. */
+export interface Registration {
+    readonly ordered: readonly RegisteredPlugin[];
+    get<T>(token: Capability<T>): T;
+    use<T>(owner: RegisteredPlugin, token: Capability<T>): T;
+}
+export declare function assertSynchronous(result: unknown, label: string): void;
+export declare function register(plugins: readonly Plugin[]): Registration;
+//# sourceMappingURL=registration.d.ts.map

package/dist/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../src/registration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEvE,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACtC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CACvC;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAA;IAC7C,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAC/B,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;CACzD;AAaD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOtE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAsGjE"}

package/dist/registration.js

@@ -0,0 +1,141 @@
+import { capabilityId } from './capability.js';
+function keys(tokens, owner) {
+    if (tokens !== undefined && !Array.isArray(tokens))
+        throw new Error(`Invalid capabilities in ${owner}`);
+    const result = new Set();
+    for (const token of tokens ?? []) {
+        const key = capabilityId(token);
+        if (result.has(key))
+            throw new Error(`Duplicate capability declaration ${key} in ${owner}`);
+        result.add(key);
+    }
+    return result;
+}
+export function assertSynchronous(result, label) {
+    if (result !== null && (typeof result === 'object' || typeof result === 'function') &&
+        'then' in result && typeof result.then === 'function') {
+        // A rejected async hook must not become an unhandled rejection after construction fails.
+        void Promise.resolve(result).catch(() => { });
+        throw new Error(`${label} must be synchronous`);
+    }
+}
+export function register(plugins) {
+    if (!Array.isArray(plugins))
+        throw new Error('plugins must be an array');
+    const ids = new Set();
+    const providers = new Map();
+    const entries = plugins.map((input, order) => {
+        if (!input || typeof input.id !== 'string' || !input.id || input.id.trim() !== input.id) {
+            throw new Error('Plugin id must be a nonempty trimmed string');
+        }
+        if (ids.has(input.id))
+            throw new Error(`Duplicate plugin id ${input.id}`);
+        ids.add(input.id);
+        if (input.apiVersion !== 1)
+            throw new Error(`Unsupported host API version in ${input.id}`);
+        if (typeof input.setup !== 'function')
+            throw new Error(`Missing setup in ${input.id}`);
+        for (const phase of ['prepare', 'activate', 'open']) {
+            if (input[phase] !== undefined && typeof input[phase] !== 'function') {
+                throw new Error(`Invalid ${phase} hook in ${input.id}`);
+            }
+        }
+        const entry = {
+            order,
+            // Capture public callbacks while retaining the extension's receiver (including private fields).
+            plugin: {
+                id: input.id,
+                apiVersion: input.apiVersion,
+                setup: input.setup.bind(input),
+                ...(input.prepare === undefined ? {} : { prepare: input.prepare.bind(input) }),
+                ...(input.activate === undefined ? {} : { activate: input.activate.bind(input) }),
+                ...(input.open === undefined ? {} : { open: input.open.bind(input) }),
+            },
+            provides: keys(input.provides, input.id),
+            requires: keys(input.requires, input.id),
+        };
+        for (const key of entry.provides) {
+            const previous = providers.get(key);
+            if (previous)
+                throw new Error(`Duplicate provider for ${key}: ${previous.plugin.id}, ${input.id}`);
+            providers.set(key, entry);
+        }
+        return entry;
+    });
+    for (const entry of entries) {
+        for (const key of entry.requires) {
+            if (!providers.has(key))
+                throw new Error(`Missing capability ${key} required by ${entry.plugin.id}`);
+        }
+    }
+    const ordered = [];
+    const remaining = new Set(entries);
+    const resolved = new Set();
+    while (remaining.size) {
+        const next = entries.find(entry => remaining.has(entry) && [...entry.requires].every(key => resolved.has(key)));
+        if (!next)
+            throw new Error(`Capability dependency cycle: ${[...remaining].map(e => e.plugin.id).join(', ')}`);
+        remaining.delete(next);
+        ordered.push(next);
+        for (const key of next.provides)
+            resolved.add(key);
+    }
+    const services = new Map();
+    const seals = [];
+    function get(token) {
+        const key = capabilityId(token);
+        if (!services.has(key))
+            throw new Error(`Capability unavailable: ${key}`);
+        // provide() pairs each typed token with its value; name/version is the public identity boundary.
+        return services.get(key);
+    }
+    function use(owner, token) {
+        const key = capabilityId(token);
+        if (!owner.requires.has(key))
+            throw new Error(`Undeclared requirement ${key} in ${owner.plugin.id}`);
+        return get(token);
+    }
+    for (const owner of ordered) {
+        let registering = true;
+        function assertRegistering() {
+            if (!registering)
+                throw new Error(`Registration sealed for ${owner.plugin.id}`);
+        }
+        try {
+            const result = owner.plugin.setup({
+                order: owner.order,
+                use(token) {
+                    assertRegistering();
+                    return use(owner, token);
+                },
+                provide(token, value) {
+                    assertRegistering();
+                    const key = capabilityId(token);
+                    if (!owner.provides.has(key))
+                        throw new Error(`Undeclared provider ${key} in ${owner.plugin.id}`);
+                    if (services.has(key))
+                        throw new Error(`Capability already provided: ${key}`);
+                    services.set(key, value);
+                },
+                onSeal(fn) {
+                    assertRegistering();
+                    if (typeof fn !== 'function')
+                        throw new Error('Seal callback must be a function');
+                    seals.push(fn);
+                },
+            });
+            assertSynchronous(result, `Setup for ${owner.plugin.id}`);
+            for (const key of owner.provides) {
+                if (!services.has(key))
+                    throw new Error(`Declared capability ${key} not provided by ${owner.plugin.id}`);
+            }
+        }
+        finally {
+            registering = false;
+        }
+    }
+    for (const seal of seals)
+        assertSynchronous(seal(), 'Seal callback');
+    return { ordered, get, use };
+}
+//# sourceMappingURL=registration.js.map

package/dist/registration.js.map

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

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@databehave/core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Instance-local typed plugin composition and application lifecycle.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ochairo/databehave.git",
+    "directory": "packages/core"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": "^24.22.1 || ^26.12.1"
+  },
+  "devDependencies": {
+    "typescript": "6.0.3",
+    "@types/node": "24.19.2"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:test": "tsc -p tsconfig.test.json",
+    "typecheck": "tsc --noEmit",
+    "pretest": "pnpm build:test",
+    "test": "node --test dist-test/test/*.test.js",
+    "clean": "rm -rf dist dist-test"
+  }
 }