@avijs/di 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christopher Robin Chase
+
+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,13 @@
-# Temporary Holding Version
+# @avijs/di
 
-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, reflection-free dependency injection for Avi.js: tokens, providers, scopes, module visibility and disposal.
+
+```sh
+npm install @avijs/di
+```
+
+Part of [Avi.js](https://github.com/chrischase011/avi-js), a TypeScript framework for Node.js with
+modules, controllers and dependency injection, without `reflect-metadata`. See the
+[tutorial](https://github.com/chrischase011/avi-js/blob/main/docs/tutorial/README.md) to get started.
+
+Requires Node.js 22.12 or newer. MIT licensed.

package/dist/container.d.ts

@@ -0,0 +1,65 @@
+import { type Provider, type Scope } from './provider.js';
+import { type Token } from './token.js';
+export interface ModuleDefinition {
+    readonly name?: string;
+    readonly imports?: readonly ModuleDefinition[];
+    readonly providers?: readonly Provider[];
+    /** Own providers, tokens re-exported from imports, or imported modules to re-export. */
+    readonly exports?: readonly (Token | ModuleDefinition)[];
+}
+export interface ContainerOptions {
+    /**
+     * Providers that replace the provider for the same token wherever it is declared. Meant for
+     * tests. An override that matches nothing is an error.
+     */
+    readonly overrides?: readonly Provider[];
+    /**
+     * Tokens whose values each request supplies through `requestScope()`, such as the request
+     * itself. Visible in every module, as request-scoped providers.
+     */
+    readonly requestTokens?: readonly Token[];
+}
+/** Request-scoped instances for one request. */
+export interface RequestScope {
+    /** Like `Container.resolve`, but request-scoped providers are created once for this scope. */
+    resolve(module: ModuleDefinition, token: Token): unknown;
+    /** Disposes this scope's instances in reverse creation order. */
+    dispose(): Promise<void>;
+}
+export interface ProviderDescription {
+    readonly token: string;
+    readonly kind: 'class' | 'value' | 'factory';
+    readonly scope: Scope;
+    readonly inject: readonly string[];
+}
+export interface ModuleDescription {
+    readonly name: string;
+    readonly imports: readonly string[];
+    readonly providers: readonly ProviderDescription[];
+    readonly exports: readonly string[];
+}
+/**
+ * Builds and validates the module graph on construction. `init()` creates every singleton,
+ * `dispose()` tears them down in reverse creation order.
+ */
+export declare class Container {
+    #private;
+    constructor(roots: readonly ModuleDefinition[], options?: ContainerOptions);
+    /** Module definitions in dependency order: imports before importers. */
+    get modules(): ModuleDefinition[];
+    /** A plain description of the validated graph, without creating any provider. */
+    describe(): ModuleDescription[];
+    /** Throws if `tokens` cannot all be resolved from `module`. `label` starts the error path. */
+    check(module: ModuleDefinition, tokens: readonly Token[], label: string): void;
+    /** True if resolving any of `tokens` from `module` needs a request scope. */
+    needsRequest(module: ModuleDefinition, tokens: readonly Token[]): boolean;
+    /** Starts a request scope. `values` supplies the `requestTokens`. */
+    requestScope(values: ReadonlyMap<Token, unknown>): RequestScope;
+    init(): Promise<void>;
+    /** Resolves `token` as seen from `module`. Transients are created on every call. */
+    resolve(module: ModuleDefinition, token: Token): unknown;
+    /** Resolves `token` from what the root modules can see. Meant for tests and scripts. */
+    get(token: Token): unknown;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,QAAQ,EAAqB,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAsB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACzC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,KAAK,GAAG,gBAAgB,CAAC,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CAC3C;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;IACzD,iEAAiE;IACjE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAsCD;;;GAGG;AACH,qBAAa,SAAS;;gBASR,KAAK,EAAE,SAAS,gBAAgB,EAAE,EAAE,OAAO,GAAE,gBAAqB;IAsC9E,wEAAwE;IACxE,IAAI,OAAO,IAAI,gBAAgB,EAAE,CAEhC;IAED,iFAAiF;IACjF,QAAQ,IAAI,iBAAiB,EAAE;IAc/B,8FAA8F;IAC9F,KAAK,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ9E,6EAA6E;IAC7E,YAAY,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,OAAO;IAKzE,qEAAqE;IACrE,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,YAAY;IAUzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,oFAAoF;IACpF,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO;IAKxD,wFAAwF;IACxF,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAgBpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA6K/B"}

package/dist/container.js

@@ -0,0 +1,368 @@
+import { normalizeProvider } from './provider.js';
+import { isToken, tokenName } from './token.js';
+const REQUEST_MODULE = {
+    definition: { name: 'request' },
+    name: 'request',
+    imports: [],
+    own: new Map(),
+    exported: new Map(),
+};
+/**
+ * Builds and validates the module graph on construction. `init()` creates every singleton,
+ * `dispose()` tears them down in reverse creation order.
+ */
+export class Container {
+    #modules = new Map();
+    #roots;
+    #created = [];
+    #overrides = new Map();
+    #overridden = new Set();
+    #supplied = new Map();
+    #state = 'new';
+    constructor(roots, options = {}) {
+        (options.overrides ?? []).forEach((provider, i) => {
+            const spec = normalizeProvider(provider, `overrides[${String(i)}]`);
+            if (this.#overrides.has(spec.token)) {
+                throw new Error(`${tokenName(spec.token)} is overridden twice`);
+            }
+            this.#overrides.set(spec.token, spec);
+        });
+        for (const token of options.requestTokens ?? []) {
+            this.#supplied.set(token, {
+                token,
+                kind: 'value',
+                scope: 'request',
+                deps: [],
+                create: () => undefined,
+                dispose: undefined,
+                module: REQUEST_MODULE,
+                links: [],
+                requestBound: true,
+                supplied: true,
+                state: 'checked',
+                instance: undefined,
+                ready: undefined,
+            });
+        }
+        this.#roots = roots.map((root, i) => this.#collect(root, [], `root module ${String(i)}`));
+        for (const token of this.#overrides.keys()) {
+            if (!this.#overridden.has(token)) {
+                throw new Error(`The override for ${tokenName(token)} matches no provider in the app`);
+            }
+        }
+        for (const module of this.#modules.values()) {
+            for (const record of module.own.values())
+                this.#check(record, [tokenName(record.token)]);
+        }
+    }
+    /** Module definitions in dependency order: imports before importers. */
+    get modules() {
+        return [...this.#modules.keys()];
+    }
+    /** A plain description of the validated graph, without creating any provider. */
+    describe() {
+        return [...this.#modules.values()].map((module) => ({
+            name: module.name,
+            imports: module.imports.map((imported) => imported.name),
+            providers: [...module.own.values()].map((record) => ({
+                token: tokenName(record.token),
+                kind: record.kind,
+                scope: record.scope,
+                inject: record.deps.map(tokenName),
+            })),
+            exports: [...module.exported.keys()].map(tokenName),
+        }));
+    }
+    /** Throws if `tokens` cannot all be resolved from `module`. `label` starts the error path. */
+    check(module, tokens, label) {
+        const record = this.#module(module);
+        for (const token of tokens) {
+            const target = this.#lookupOrThrow(record, token, [label]);
+            this.#check(target, [label, tokenName(token)]);
+        }
+    }
+    /** True if resolving any of `tokens` from `module` needs a request scope. */
+    needsRequest(module, tokens) {
+        const record = this.#module(module);
+        return tokens.some((token) => this.#lookupOrThrow(record, token, []).requestBound);
+    }
+    /** Starts a request scope. `values` supplies the `requestTokens`. */
+    requestScope(values) {
+        this.#assertReady();
+        const scope = { values, instances: new Map(), created: [] };
+        return {
+            resolve: (module, token) => this.#instance(this.#lookupOrThrow(this.#module(module), token, []), scope),
+            dispose: () => disposeAll(scope.created.splice(0)),
+        };
+    }
+    async init() {
+        if (this.#state !== 'new')
+            throw new Error(`Container is already ${this.#state}`);
+        this.#state = 'initializing';
+        try {
+            for (const module of this.#modules.values()) {
+                for (const record of module.own.values()) {
+                    if (record.scope === 'singleton')
+                        await this.#ensure(record);
+                    else
+                        await this.#ensureDeps(record);
+                }
+            }
+            this.#state = 'ready';
+        }
+        catch (error) {
+            await this.dispose().catch(() => undefined);
+            throw error;
+        }
+    }
+    /** Resolves `token` as seen from `module`. Transients are created on every call. */
+    resolve(module, token) {
+        this.#assertReady();
+        return this.#instance(this.#lookupOrThrow(this.#module(module), token, []));
+    }
+    /** Resolves `token` from what the root modules can see. Meant for tests and scripts. */
+    get(token) {
+        this.#assertReady();
+        const found = new Set();
+        for (const root of this.#roots) {
+            const hit = lookup(root, token);
+            if (hit && 'ambiguous' in hit) {
+                throw new Error(`${tokenName(token)} is exported to ${root.name} by more than one import`);
+            }
+            if (hit)
+                found.add(hit);
+        }
+        if (found.size === 0)
+            throw new Error(`${tokenName(token)} is not visible to the root modules`);
+        if (found.size > 1)
+            throw new Error(`${tokenName(token)} is provided by more than one root module`);
+        return this.#instance([...found][0]);
+    }
+    async dispose() {
+        this.#state = 'disposed';
+        await disposeAll(this.#created.splice(0).map((record) => ({ record, value: record.instance })));
+    }
+    #collect(definition, stack, where) {
+        if (typeof definition !== 'object' || definition === null) {
+            const value = definition;
+            const hint = value === undefined ? ' (is there a circular import?)' : '';
+            throw new TypeError(`Invalid module at ${where}: ${value === null ? 'null' : typeof value}${hint}`);
+        }
+        const existing = this.#modules.get(definition);
+        if (existing)
+            return existing;
+        const name = definition.name ?? '(anonymous module)';
+        if (stack.includes(definition)) {
+            const cycle = [...stack.slice(stack.indexOf(definition)), definition].map(moduleName);
+            throw new Error(`Module import cycle: ${cycle.join(' → ')}`);
+        }
+        const imports = (definition.imports ?? []).map((child, i) => this.#collect(child, [...stack, definition], `${name}.imports[${String(i)}]`));
+        const record = { definition, name, imports, own: new Map(), exported: new Map() };
+        (definition.providers ?? []).forEach((provider, i) => {
+            const declared = normalizeProvider(provider, `${name}.providers[${String(i)}]`);
+            if (record.own.has(declared.token)) {
+                throw new Error(`${tokenName(declared.token)} is provided twice in ${name}`);
+            }
+            const spec = this.#overrides.get(declared.token) ?? declared;
+            if (spec !== declared)
+                this.#overridden.add(declared.token);
+            record.own.set(spec.token, {
+                ...spec,
+                module: record,
+                links: [],
+                requestBound: false,
+                supplied: false,
+                state: 'unchecked',
+                instance: undefined,
+                ready: undefined,
+            });
+        });
+        for (const entry of definition.exports ?? [])
+            exportEntry(record, entry);
+        this.#modules.set(definition, record);
+        return record;
+    }
+    #module(definition) {
+        const record = this.#modules.get(definition);
+        if (!record)
+            throw new Error(`${moduleName(definition)} is not part of this application`);
+        return record;
+    }
+    #lookupOrThrow(module, token, path) {
+        const hit = lookup(module, token) ?? this.#supplied.get(token);
+        const chain = [...path, tokenName(token)].join(' → ');
+        if (!hit) {
+            const imports = module.imports.map((m) => m.name).join(', ') || 'none';
+            throw new Error(`Cannot resolve ${chain} in ${module.name}: ${tokenName(token)} is not provided by ${module.name} or exported by its imports (${imports})`);
+        }
+        if ('ambiguous' in hit) {
+            throw new Error(`Cannot resolve ${chain} in ${module.name}: ${tokenName(token)} is exported by more than one import (${hit.ambiguous.join(', ')})`);
+        }
+        return hit;
+    }
+    /** Links dependencies and detects missing providers and cycles. */
+    #check(record, path) {
+        if (record.state === 'checked')
+            return;
+        if (record.state === 'checking') {
+            const start = path.indexOf(tokenName(record.token));
+            throw new Error(`Dependency cycle: ${path.slice(start).join(' → ')}`);
+        }
+        record.state = 'checking';
+        record.links = record.deps.map((token) => {
+            const target = this.#lookupOrThrow(record.module, token, path);
+            this.#check(target, [...path, tokenName(token)]);
+            return target;
+        });
+        record.requestBound =
+            record.scope === 'request' ||
+                (record.scope === 'transient' && record.links.some((link) => link.requestBound));
+        const bound = record.scope === 'singleton' && record.links.find((link) => link.requestBound);
+        if (bound) {
+            const name = tokenName(record.token);
+            const chain = [...path, tokenName(bound.token)].join(' → ');
+            throw new Error(`Singleton ${name} in ${record.module.name} depends on request-scoped ${tokenName(bound.token)} (${chain}). A singleton outlives the request; make ${name} request-scoped or transient.`);
+        }
+        record.state = 'checked';
+    }
+    #ensure(record) {
+        record.ready ??= (async () => {
+            await this.#ensureDeps(record);
+            let value = this.#create(record);
+            if (record.kind === 'factory' && value instanceof Promise) {
+                try {
+                    value = await value;
+                }
+                catch (error) {
+                    throw creationError(record, error);
+                }
+            }
+            record.instance = value;
+            if (record.kind !== 'value')
+                this.#created.push(record);
+        })();
+        return record.ready;
+    }
+    async #ensureDeps(record) {
+        for (const dep of record.links) {
+            if (dep.scope === 'singleton')
+                await this.#ensure(dep);
+            else
+                await this.#ensureDeps(dep);
+        }
+    }
+    #create(record, scope) {
+        const deps = record.links.map((dep) => this.#instance(dep, scope));
+        try {
+            return record.create(deps);
+        }
+        catch (error) {
+            throw creationError(record, error);
+        }
+    }
+    #instance(record, scope) {
+        if (record.scope === 'singleton')
+            return record.instance;
+        if (record.scope === 'request') {
+            if (!scope) {
+                throw new Error(`${tokenName(record.token)} is request-scoped and can only be resolved while handling a request`);
+            }
+            if (record.supplied) {
+                if (!scope.values.has(record.token)) {
+                    throw new Error(`This request scope has no value for ${tokenName(record.token)}`);
+                }
+                return scope.values.get(record.token);
+            }
+            if (scope.instances.has(record))
+                return scope.instances.get(record);
+            const value = this.#createSync(record, scope);
+            scope.instances.set(record, value);
+            scope.created.push({ record, value });
+            return value;
+        }
+        return this.#createSync(record, scope);
+    }
+    #createSync(record, scope) {
+        const value = this.#create(record, scope);
+        if (record.kind === 'factory' && value instanceof Promise) {
+            value.catch(() => undefined);
+            const kind = record.scope === 'request' ? 'Request-scoped' : 'Transient';
+            throw new Error(`${kind} provider ${tokenName(record.token)} in ${record.module.name} returned a Promise; only singletons may be async`);
+        }
+        return value;
+    }
+    #assertReady() {
+        if (this.#state !== 'ready')
+            throw new Error('The container is not initialized; call init() first');
+    }
+}
+function lookup(module, token) {
+    const own = module.own.get(token);
+    if (own)
+        return own;
+    const hits = new Map();
+    for (const imported of module.imports) {
+        const hit = imported.exported.get(token);
+        if (hit && !hits.has(hit))
+            hits.set(hit, imported.name);
+    }
+    if (hits.size > 1)
+        return { ambiguous: [...hits.values()] };
+    return hits.keys().next().value;
+}
+function exportEntry(module, entry) {
+    const imported = module.imports.find((m) => m.definition === entry);
+    if (imported) {
+        for (const [token, record] of imported.exported)
+            module.exported.set(token, record);
+        return;
+    }
+    if (!isToken(entry)) {
+        throw new TypeError(`Invalid export in ${module.name}: expected a token or an imported module${entry === undefined ? ' (is there a circular import?)' : ''}`);
+    }
+    const hit = lookup(module, entry);
+    if (!hit) {
+        throw new Error(`${module.name} exports ${tokenName(entry)}, which it neither provides nor imports`);
+    }
+    if ('ambiguous' in hit) {
+        throw new Error(`${module.name} exports ${tokenName(entry)}, which more than one import provides (${hit.ambiguous.join(', ')})`);
+    }
+    module.exported.set(entry, hit);
+}
+/** Disposes in reverse order, continuing past failures. */
+async function disposeAll(created) {
+    const errors = [];
+    for (const { record, value } of [...created].reverse()) {
+        try {
+            await disposeValue(record, value);
+        }
+        catch (error) {
+            errors.push(error);
+        }
+    }
+    if (errors.length > 0) {
+        throw new AggregateError(errors, `Failed to dispose ${String(errors.length)} provider(s)`);
+    }
+}
+async function disposeValue(record, instance) {
+    if (record.dispose) {
+        await record.dispose(instance);
+        return;
+    }
+    const value = instance;
+    const asyncDispose = value?.[Symbol.asyncDispose];
+    const syncDispose = value?.[Symbol.dispose];
+    if (typeof asyncDispose === 'function')
+        await asyncDispose.call(value);
+    else if (typeof syncDispose === 'function')
+        syncDispose.call(value);
+}
+function creationError(record, cause) {
+    return new Error(`Failed to create ${tokenName(record.token)} in ${record.module.name}`, {
+        cause,
+    });
+}
+function moduleName(definition) {
+    return definition.name ?? '(anonymous module)';
+}
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Container } from './container.js';
+export type { ContainerOptions, ModuleDefinition, ModuleDescription, ProviderDescription, RequestScope, } from './container.js';
+export type { ClassProvider, FactoryProvider, Provider, Scope, ValueProvider } from './provider.js';
+export { createToken } from './token.js';
+export type { Class, Constructor, InjectionToken, ResolveTokens, Token, TokenType, } from './token.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,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EACV,KAAK,EACL,WAAW,EACX,cAAc,EACd,aAAa,EACb,KAAK,EACL,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { Container } from './container.js';
+export { createToken } from './token.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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAS3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,39 @@
+import { type Constructor, type Token } from './token.js';
+/**
+ * `singleton`: one instance per app. `transient`: a new one per injection. `request`: one per
+ * request, created on first use and disposed after the handler.
+ */
+export type Scope = 'singleton' | 'transient' | 'request';
+export interface ClassProvider<T = unknown> {
+    provide: Token<T>;
+    useClass: Constructor<T>;
+    scope?: Scope;
+}
+export interface ValueProvider<T = unknown> {
+    provide: Token<T>;
+    useValue: T;
+}
+export interface FactoryProvider<T = unknown> {
+    provide: Token<T>;
+    /** Receives `inject` in order. Only singleton factories may return a promise. */
+    useFactory: (...deps: never[]) => T | Promise<T>;
+    inject?: readonly Token[];
+    scope?: Scope;
+    /**
+     * Called with the created value on shutdown, or after the request for request scope. A method,
+     * so typed callbacks fit `Provider[]`.
+     */
+    dispose?(value: T): unknown;
+}
+export type Provider<T = unknown> = Constructor<T> | ClassProvider<T> | ValueProvider<T> | FactoryProvider<T>;
+export interface ProviderSpec {
+    readonly token: Token;
+    readonly kind: 'class' | 'value' | 'factory';
+    readonly scope: Scope;
+    readonly deps: readonly Token[];
+    readonly create: (deps: unknown[]) => unknown;
+    readonly dispose: ((value: unknown) => unknown) | undefined;
+}
+/** Validates a provider and converts it to one internal shape. `where` labels errors. */
+export declare function normalizeProvider(provider: unknown, where: string): ProviderSpec;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,QAAQ,EAAE,CAAC,CAAC;CACb;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,iFAAiF;IACjF,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAC9B,WAAW,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC;CAC7D;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAsEhF"}