di-craft 0.0.19 → 0.0.21

package/README.md

@@ -6,6 +6,8 @@
 
 <p align="center">
   <b>A tiny, type-safe dependency injection container for TypeScript</b>
+  <br />
+  <span>Framework-agnostic core with an optional Next.js App Router / RSC adapter</span>
 </p>
 
 <p align="center">
@@ -90,6 +92,7 @@ they still use explicit tokens.
 - Zero runtime dependencies
 - Type-safe tokens and factories
 - Optional `@Injectable` annotation for class providers
+- Optional Next.js App Router / React Server Components adapter
 - Optional dependencies via `optional()`
 - Singleton, transient, and scoped lifetimes
 - Hierarchical child containers

package/dist/container-l5DkUBUj.mjs

@@ -0,0 +1,323 @@
+//#region src/core/error/error.ts
+var DiError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "DiError";
+		const errorConstructor = Error;
+		const classConstructor = this.constructor;
+		if (errorConstructor.captureStackTrace) errorConstructor.captureStackTrace(this, classConstructor);
+	}
+};
+
+//#endregion
+//#region src/core/provider/errors.ts
+/**
+* Error thrown when a provider configuration cannot be used safely.
+*/
+var InvalidProviderError = class extends DiError {
+	constructor(message) {
+		super(message);
+		this.name = "InvalidProviderError";
+	}
+};
+
+//#endregion
+//#region src/core/scope/scope.ts
+/**
+* Built-in provider lifetimes.
+*/
+const Scopes = {
+	Singleton: "singleton",
+	Transient: "transient",
+	Scoped: "scoped"
+};
+
+//#endregion
+//#region src/core/provider/provider.ts
+/**
+* Creates a provider for an already constructed value.
+*
+* The value must match the token type.
+*
+* @example
+* ```ts
+* provideValue(PORT, 3000);
+* ```
+*/
+const provideValue = (token, useValue) => ({
+	provide: token,
+	useValue
+});
+/**
+* Creates a provider that lazily builds a value.
+*
+* Dependencies declared in `deps` become the object passed to `useFactory`.
+* The factory return type must match the token type.
+*
+* @example
+* ```ts
+* provideFactory(HTTP, {
+*   deps: { config: CONFIG },
+*   useFactory: ({ config }) => new HttpClient(config.apiUrl),
+* });
+* ```
+*/
+const provideFactory = (token, options) => {
+	if (options.scope === Scopes.Transient && options.onDispose) throw new InvalidProviderError(`onDispose is not supported for transient providers (token "${token.name}"): transient instances are not tracked, so the hook would never run.`);
+	return {
+		provide: token,
+		useFactory: options.useFactory,
+		scope: options.scope ?? Scopes.Singleton,
+		...options.deps ? { deps: options.deps } : {},
+		...options.onDispose ? { onDispose: options.onDispose } : {}
+	};
+};
+/**
+* Marks a token as optional.
+*
+* Optional dependencies resolve to `undefined` instead of throwing when no
+* provider exists in the container chain. They can be used in factory `deps`
+* or passed directly to `container.get`.
+*
+* @example
+* ```ts
+* const logger = container.get(optional(LOGGER));
+* ```
+*/
+const optional = (token) => ({
+	token,
+	optional: true
+});
+const isOptionalDependency = (dependency) => {
+	return dependency.optional === true;
+};
+const isValueProvider = (provider) => {
+	return "useValue" in provider;
+};
+
+//#endregion
+//#region src/core/registry/errors.ts
+/**
+* Error thrown when registering a provider for an already registered token.
+*/
+var DuplicateProviderError = class extends DiError {
+	constructor(tokenName) {
+		super(`Provider for token "${tokenName}" is already registered`);
+		this.name = "DuplicateProviderError";
+	}
+};
+
+//#endregion
+//#region src/core/registry/registry.ts
+var RegistryClass = class {
+	providers = /* @__PURE__ */ new Map();
+	register(provider, options) {
+		const existed = this.providers.has(provider.provide.id);
+		if (existed && !options?.allowOverride) throw new DuplicateProviderError(provider.provide.name);
+		this.providers.set(provider.provide.id, provider);
+		return existed;
+	}
+	get(token) {
+		return this.providers.get(token.id);
+	}
+	has(token) {
+		return this.providers.has(token.id);
+	}
+};
+const createRegistry = () => new RegistryClass();
+
+//#endregion
+//#region src/core/resolver/errors.ts
+/**
+* Error thrown when resolving a token without a registered provider.
+*/
+var MissingProviderError = class extends DiError {
+	constructor(tokenName) {
+		super(`Provider for token "${tokenName}" is not registered`);
+		this.name = "MissingProviderError";
+	}
+};
+/**
+* Error thrown when a dependency descriptor is invalid.
+*/
+var InvalidDependencyError = class extends DiError {
+	constructor(dependencyKey) {
+		super(`Invalid dependency "${dependencyKey}"`);
+		this.name = "InvalidDependencyError";
+	}
+};
+/**
+* Error thrown when provider dependencies form a cycle.
+*/
+var CircularDependencyError = class extends DiError {
+	constructor(tokenNames) {
+		super(`Circular dependency detected: ${tokenNames.join(" -> ")}`);
+		this.name = "CircularDependencyError";
+	}
+};
+
+//#endregion
+//#region src/core/store/store.ts
+var StoreClass = class {
+	instances = /* @__PURE__ */ new Map();
+	get(token) {
+		return this.instances.get(token.id);
+	}
+	set(token, record) {
+		this.instances.set(token.id, record);
+	}
+	delete(token) {
+		this.instances.delete(token.id);
+	}
+	async dispose() {
+		const records = [...this.instances.values()].reverse();
+		this.instances.clear();
+		for (const record of records) if (record.onDispose) await record.onDispose(record.value);
+	}
+};
+const createStore = () => new StoreClass();
+
+//#endregion
+//#region src/core/resolver/context.ts
+var ResolutionContext = class {
+	resolving = /* @__PURE__ */ new Set();
+	path = [];
+	enter(token) {
+		if (this.resolving.has(token.id)) {
+			const cycleStartIndex = this.path.findIndex((pathToken) => pathToken.id === token.id);
+			throw new CircularDependencyError([...this.path.slice(cycleStartIndex), token].map((cycleToken) => cycleToken.name));
+		}
+		this.resolving.add(token.id);
+		this.path.push(token);
+	}
+	exit(token) {
+		this.path.pop();
+		this.resolving.delete(token.id);
+	}
+};
+
+//#endregion
+//#region src/core/resolver/resolver.ts
+const lifetimeRank = (scope) => scope === Scopes.Scoped ? 1 : scope === Scopes.Transient ? 2 : 0;
+var ResolverClass = class {
+	registry;
+	store = createStore();
+	parent;
+	constructor(registry, parent) {
+		this.registry = registry;
+		this.parent = parent;
+	}
+	resolve(token) {
+		return this.resolveToken(token, void 0);
+	}
+	resolveOptional(token) {
+		return this.lookupOptional(token, void 0);
+	}
+	invalidate(token) {
+		this.store.delete(token);
+	}
+	hasDisposableInstance(token) {
+		return this.store.get(token)?.onDispose !== void 0;
+	}
+	dispose() {
+		return this.store.dispose();
+	}
+	resolveToken(token, context, consumerScope, consumerName) {
+		let owner = this;
+		let provider;
+		while (owner) {
+			provider = owner.registry.get(token);
+			if (provider) break;
+			owner = owner.parent;
+		}
+		if (!provider || !owner) throw new MissingProviderError(token.name);
+		if (isValueProvider(provider)) return provider.useValue;
+		if (consumerScope !== void 0 && lifetimeRank(provider.scope) > lifetimeRank(consumerScope)) throw new InvalidProviderError(`"${consumerName}" (${consumerScope}) cannot depend on "${token.name}" (${provider.scope ?? Scopes.Singleton}): a longer-lived provider would capture a shorter-lived one. Widen the dependency's scope or narrow the consumer's.`);
+		const host = this.selectHost(provider.scope, owner);
+		if (host) {
+			const cached = host.store.get(token);
+			if (cached) return cached.value;
+		}
+		const ctx = context ?? new ResolutionContext();
+		ctx.enter(token);
+		try {
+			const deps = (host ?? this).resolveDeps(provider.deps, ctx, provider.scope, token.name);
+			const value = provider.useFactory(deps);
+			if (host) host.store.set(token, {
+				value,
+				...provider.onDispose ? { onDispose: provider.onDispose } : {}
+			});
+			return value;
+		} finally {
+			ctx.exit(token);
+		}
+	}
+	selectHost(scope, owner) {
+		if (scope === Scopes.Transient) return;
+		if (scope === Scopes.Scoped) return this;
+		return owner;
+	}
+	resolveDeps(deps, context, consumerScope, consumerName) {
+		if (!deps) return {};
+		const resolvedDeps = {};
+		for (const key of Object.keys(deps)) {
+			const dependency = deps[key];
+			if (dependency === void 0) throw new InvalidDependencyError(String(key));
+			resolvedDeps[key] = isOptionalDependency(dependency) ? this.lookupOptional(dependency.token, context, consumerScope, consumerName) : this.resolveToken(dependency, context, consumerScope, consumerName);
+		}
+		return resolvedDeps;
+	}
+	lookupOptional(token, context, consumerScope, consumerName) {
+		let owner = this;
+		while (owner) {
+			if (owner.registry.has(token)) return this.resolveToken(token, context, consumerScope, consumerName);
+			owner = owner.parent;
+		}
+	}
+};
+const createResolver = (registry, parent) => new ResolverClass(registry, parent);
+
+//#endregion
+//#region src/core/container/container.ts
+var ContainerClass = class {
+	registry;
+	resolver;
+	parent;
+	constructor(providers = [], parent) {
+		this.parent = parent;
+		this.registry = createRegistry();
+		for (const provider of providers) this.registry.register(provider);
+		this.resolver = createResolver(this.registry, parent?.resolver);
+	}
+	register(provider, options) {
+		if (options?.allowOverride && this.resolver.hasDisposableInstance(provider.provide)) throw new InvalidProviderError(`Cannot override token "${provider.provide.name}": its instance was already created and has an onDispose hook. Dispose the container before replacing it.`);
+		if (this.registry.register(provider, options)) this.resolver.invalidate(provider.provide);
+	}
+	get(dependency) {
+		if (isOptionalDependency(dependency)) return this.resolver.resolveOptional(dependency.token);
+		return this.resolver.resolve(dependency);
+	}
+	has(token) {
+		return this.registry.has(token) || (this.parent?.has(token) ?? false);
+	}
+	dispose() {
+		return this.resolver.dispose();
+	}
+};
+/**
+* Creates a root container with optional initial providers.
+*
+* Root containers own singleton instances for providers registered in them.
+*/
+const createContainer = (providers = []) => new ContainerClass(providers);
+/**
+* Creates a child container that can resolve providers from its parent.
+*
+* Child containers may register their own providers while still reusing parent
+* providers. Scoped providers create one cached instance per resolving child.
+*/
+const createChildContainer = (parent, providers = []) => new ContainerClass(providers, parent);
+
+//#endregion
+export { MissingProviderError as a, provideFactory as c, InvalidProviderError as d, DiError as f, InvalidDependencyError as i, provideValue as l, createContainer as n, DuplicateProviderError as o, CircularDependencyError as r, optional as s, createChildContainer as t, Scopes as u };
+//# sourceMappingURL=container-l5DkUBUj.mjs.map

package/dist/container-l5DkUBUj.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-l5DkUBUj.mjs","names":[],"sources":["../src/core/error/error.ts","../src/core/provider/errors.ts","../src/core/scope/scope.ts","../src/core/provider/provider.ts","../src/core/registry/errors.ts","../src/core/registry/registry.ts","../src/core/resolver/errors.ts","../src/core/store/store.ts","../src/core/resolver/context.ts","../src/core/resolver/resolver.ts","../src/core/container/container.ts"],"sourcesContent":["/**\n * Base class for all di-craft runtime errors.\n */\ntype ErrorConstructorWithStackTrace = ErrorConstructor & {\n\treadonly captureStackTrace?: (\n\t\terror: Error,\n\t\tconstructorFunction: (...args: never[]) => unknown,\n\t) => void;\n};\n\nexport class DiError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\n\t\tthis.name = \"DiError\";\n\n\t\tconst errorConstructor = Error as ErrorConstructorWithStackTrace;\n\t\tconst classConstructor = this.constructor as (...args: never[]) => unknown;\n\n\t\tif (errorConstructor.captureStackTrace) {\n\t\t\terrorConstructor.captureStackTrace(this, classConstructor);\n\t\t}\n\t}\n}\n","import { DiError } from \"../error\";\n\n/**\n * Error thrown when a provider configuration cannot be used safely.\n */\nexport class InvalidProviderError extends DiError {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\n\t\tthis.name = \"InvalidProviderError\";\n\t}\n}\n","/**\n * Built-in provider lifetimes.\n */\nexport const Scopes = {\n\tSingleton: \"singleton\",\n\tTransient: \"transient\",\n\tScoped: \"scoped\",\n} as const;\n\n/**\n * Provider lifetime.\n *\n * - `singleton`: one cached instance in the container that owns the provider.\n * - `scoped`: one cached instance in the container that resolves the provider.\n * - `transient`: a new instance for every resolution.\n */\nexport type Scope = (typeof Scopes)[keyof typeof Scopes];\n","import { type Scope, Scopes } from \"../scope\";\nimport type { Token } from \"../token\";\nimport { InvalidProviderError } from \"./errors\";\nimport type {\n\tAnyFactoryProvider,\n\tDependency,\n\tDepsMap,\n\tDisposeHook,\n\tFactory,\n\tFactoryProvider,\n\tOptionalDependency,\n\tProvider,\n\tValueProvider,\n} from \"./types\";\n\n/**\n * Creates a provider for an already constructed value.\n *\n * The value must match the token type.\n *\n * @example\n * ```ts\n * provideValue(PORT, 3000);\n * ```\n */\nexport const provideValue = <T>(\n\ttoken: Token<T>,\n\tuseValue: T,\n): ValueProvider<T> => ({\n\tprovide: token,\n\tuseValue,\n});\n\n/**\n * Creates a provider that lazily builds a value.\n *\n * Dependencies declared in `deps` become the object passed to `useFactory`.\n * The factory return type must match the token type.\n *\n * @example\n * ```ts\n * provideFactory(HTTP, {\n *   deps: { config: CONFIG },\n *   useFactory: ({ config }) => new HttpClient(config.apiUrl),\n * });\n * ```\n */\nexport const provideFactory = <T, TDeps extends DepsMap = Record<never, never>>(\n\ttoken: Token<T>,\n\toptions: {\n\t\treadonly deps?: TDeps;\n\t\treadonly scope?: Scope;\n\t\treadonly useFactory: Factory<T, TDeps>;\n\t\treadonly onDispose?: DisposeHook<T>;\n\t},\n): FactoryProvider<T, TDeps> => {\n\t// Transient instances aren't cached, so onDispose could never run.\n\tif (options.scope === Scopes.Transient && options.onDispose) {\n\t\tthrow new InvalidProviderError(\n\t\t\t`onDispose is not supported for transient providers (token \"${token.name}\"): transient instances are not tracked, so the hook would never run.`,\n\t\t);\n\t}\n\n\treturn {\n\t\tprovide: token,\n\t\tuseFactory: options.useFactory,\n\t\tscope: options.scope ?? Scopes.Singleton,\n\t\t...(options.deps ? { deps: options.deps } : {}),\n\t\t...(options.onDispose ? { onDispose: options.onDispose } : {}),\n\t};\n};\n\n/**\n * Marks a token as optional.\n *\n * Optional dependencies resolve to `undefined` instead of throwing when no\n * provider exists in the container chain. They can be used in factory `deps`\n * or passed directly to `container.get`.\n *\n * @example\n * ```ts\n * const logger = container.get(optional(LOGGER));\n * ```\n */\nexport const optional = <T>(token: Token<T>): OptionalDependency<T> => ({\n\ttoken,\n\toptional: true,\n});\n\nexport const isOptionalDependency = <T>(\n\tdependency: Dependency<T>,\n): dependency is OptionalDependency<T> => {\n\treturn (dependency as OptionalDependency<T>).optional === true;\n};\n\nexport const isValueProvider = (\n\tprovider: Provider,\n): provider is ValueProvider<unknown> => {\n\treturn \"useValue\" in provider;\n};\n\nexport const isFactoryProvider = (\n\tprovider: Provider,\n): provider is AnyFactoryProvider => {\n\treturn \"useFactory\" in provider;\n};\n","import { DiError } from \"../error\";\n\n/**\n * Error thrown when registering a provider for an already registered token.\n */\nexport class DuplicateProviderError extends DiError {\n\tconstructor(tokenName: string) {\n\t\tsuper(`Provider for token \"${tokenName}\" is already registered`);\n\n\t\tthis.name = \"DuplicateProviderError\";\n\t}\n}\n","import type { Provider } from \"../provider\";\nimport type { Token } from \"../token\";\nimport { DuplicateProviderError } from \"./errors\";\nimport type { RegisterOptions, Registry } from \"./types\";\n\nclass RegistryClass implements Registry {\n\tprivate readonly providers = new Map<symbol, Provider>();\n\n\tregister(provider: Provider, options?: RegisterOptions): boolean {\n\t\tconst existed = this.providers.has(provider.provide.id);\n\n\t\tif (existed && !options?.allowOverride) {\n\t\t\tthrow new DuplicateProviderError(provider.provide.name);\n\t\t}\n\n\t\tthis.providers.set(provider.provide.id, provider);\n\n\t\t// true if an existing provider was replaced (override).\n\t\treturn existed;\n\t}\n\n\tget(token: Token<unknown>): Provider | undefined {\n\t\treturn this.providers.get(token.id);\n\t}\n\n\thas(token: Token<unknown>): boolean {\n\t\treturn this.providers.has(token.id);\n\t}\n}\n\nexport const createRegistry = (): Registry => new RegistryClass();\n","import { DiError } from \"../error\";\n\n/**\n * Error thrown when resolving a token without a registered provider.\n */\nexport class MissingProviderError extends DiError {\n\tconstructor(tokenName: string) {\n\t\tsuper(`Provider for token \"${tokenName}\" is not registered`);\n\n\t\tthis.name = \"MissingProviderError\";\n\t}\n}\n\n/**\n * Error thrown when a dependency descriptor is invalid.\n */\nexport class InvalidDependencyError extends DiError {\n\tconstructor(dependencyKey: string) {\n\t\tsuper(`Invalid dependency \"${dependencyKey}\"`);\n\n\t\tthis.name = \"InvalidDependencyError\";\n\t}\n}\n\n/**\n * Error thrown when provider dependencies form a cycle.\n */\nexport class CircularDependencyError extends DiError {\n\tconstructor(tokenNames: string[]) {\n\t\tsuper(`Circular dependency detected: ${tokenNames.join(\" -> \")}`);\n\n\t\tthis.name = \"CircularDependencyError\";\n\t}\n}\n","import type { Token } from \"../token\";\nimport type { InstanceRecord, Store } from \"./types\";\n\nclass StoreClass implements Store {\n\tprivate readonly instances = new Map<symbol, InstanceRecord>();\n\n\tget(token: Token<unknown>): InstanceRecord | undefined {\n\t\treturn this.instances.get(token.id);\n\t}\n\n\tset(token: Token<unknown>, record: InstanceRecord): void {\n\t\tthis.instances.set(token.id, record);\n\t}\n\n\tdelete(token: Token<unknown>): void {\n\t\tthis.instances.delete(token.id);\n\t}\n\n\tasync dispose(): Promise<void> {\n\t\t// Snapshot and clear first so dispose() is idempotent and re-entrancy safe.\n\t\tconst records = [...this.instances.values()].reverse();\n\n\t\tthis.instances.clear();\n\n\t\tfor (const record of records) {\n\t\t\tif (record.onDispose) {\n\t\t\t\tawait record.onDispose(record.value);\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport const createStore = (): Store => new StoreClass();\n","import type { Token } from \"../token\";\nimport { CircularDependencyError } from \"./errors\";\n\nexport class ResolutionContext {\n\tprivate readonly resolving = new Set<symbol>();\n\tprivate readonly path: Token<unknown>[] = [];\n\n\tenter(token: Token<unknown>): void {\n\t\tif (this.resolving.has(token.id)) {\n\t\t\tconst cycleStartIndex = this.path.findIndex(\n\t\t\t\t(pathToken) => pathToken.id === token.id,\n\t\t\t);\n\n\t\t\tconst cycle = [...this.path.slice(cycleStartIndex), token];\n\n\t\t\tthrow new CircularDependencyError(\n\t\t\t\tcycle.map((cycleToken) => cycleToken.name),\n\t\t\t);\n\t\t}\n\n\t\tthis.resolving.add(token.id);\n\t\tthis.path.push(token);\n\t}\n\n\texit(token: Token<unknown>): void {\n\t\tthis.path.pop();\n\t\tthis.resolving.delete(token.id);\n\t}\n}\n","import type { DepsMap, Provider, ResolveDeps } from \"../provider\";\nimport {\n\tInvalidProviderError,\n\tisOptionalDependency,\n\tisValueProvider,\n} from \"../provider\";\nimport type { Registry } from \"../registry\";\nimport { type Scope, Scopes } from \"../scope\";\nimport { createStore, type Store } from \"../store\";\nimport type { Token } from \"../token\";\nimport { ResolutionContext } from \"./context\";\nimport { InvalidDependencyError, MissingProviderError } from \"./errors\";\nimport type { Resolver } from \"./types\";\n\n// Lifetime ordering: longer-lived scopes rank lower. A provider may only depend\n// on dependencies that live at least as long as itself.\nconst lifetimeRank = (scope: Scope | undefined): number =>\n\tscope === Scopes.Scoped ? 1 : scope === Scopes.Transient ? 2 : 0;\n\nclass ResolverClass implements Resolver {\n\tprivate readonly registry: Registry;\n\tprivate readonly store: Store = createStore();\n\tprivate readonly parent: ResolverClass | undefined;\n\n\tconstructor(registry: Registry, parent?: ResolverClass) {\n\t\tthis.registry = registry;\n\t\tthis.parent = parent;\n\t}\n\n\tresolve<T>(token: Token<T>): T {\n\t\treturn this.resolveToken(token, undefined);\n\t}\n\n\tresolveOptional<T>(token: Token<T>): T | undefined {\n\t\treturn this.lookupOptional(token, undefined);\n\t}\n\n\tinvalidate(token: Token<unknown>): void {\n\t\tthis.store.delete(token);\n\t}\n\n\t// True if a locally-cached instance has an onDispose hook.\n\thasDisposableInstance(token: Token<unknown>): boolean {\n\t\treturn this.store.get(token)?.onDispose !== undefined;\n\t}\n\n\tdispose(): Promise<void> {\n\t\treturn this.store.dispose();\n\t}\n\n\t// context is allocated lazily by the first building factory (zero-alloc cache hits).\n\t// consumerScope/consumerName describe the provider depending on this token, if any.\n\tprivate resolveToken<T>(\n\t\ttoken: Token<T>,\n\t\tcontext: ResolutionContext | undefined,\n\t\tconsumerScope?: Scope,\n\t\tconsumerName?: string,\n\t): T {\n\t\t// Single walk up the parent chain, fetching the provider directly.\n\t\tlet owner: ResolverClass | undefined = this;\n\t\tlet provider: Provider | undefined;\n\n\t\twhile (owner) {\n\t\t\tprovider = owner.registry.get(token);\n\n\t\t\tif (provider) {\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\towner = owner.parent;\n\t\t}\n\n\t\tif (!provider || !owner) {\n\t\t\tthrow new MissingProviderError(token.name);\n\t\t}\n\n\t\t// Values outlive every scope, so they are always a safe dependency.\n\t\tif (isValueProvider(provider)) {\n\t\t\treturn provider.useValue as T;\n\t\t}\n\n\t\t// Otherwise it is a factory provider (the only remaining variant).\n\t\t// Reject capturing a shorter-lived dependency into a longer-lived consumer.\n\t\tif (\n\t\t\tconsumerScope !== undefined &&\n\t\t\tlifetimeRank(provider.scope) > lifetimeRank(consumerScope)\n\t\t) {\n\t\t\tthrow new InvalidProviderError(\n\t\t\t\t`\"${consumerName}\" (${consumerScope}) cannot depend on \"${token.name}\" (${provider.scope ?? Scopes.Singleton}): a longer-lived provider would capture a shorter-lived one. Widen the dependency's scope or narrow the consumer's.`,\n\t\t\t);\n\t\t}\n\n\t\t// Scope decides the host: singleton on owner, scoped on this, transient nowhere.\n\t\tconst host = this.selectHost(provider.scope, owner);\n\n\t\tif (host) {\n\t\t\tconst cached = host.store.get(token);\n\n\t\t\tif (cached) {\n\t\t\t\treturn cached.value as T;\n\t\t\t}\n\t\t}\n\n\t\t// Allocate cycle detection only now, threading it through the build.\n\t\tconst ctx = context ?? new ResolutionContext();\n\t\tctx.enter(token);\n\n\t\ttry {\n\t\t\t// Resolve deps from the host: scoped sees this container, singleton sees owner.\n\t\t\tconst deps = (host ?? this).resolveDeps(\n\t\t\t\tprovider.deps,\n\t\t\t\tctx,\n\t\t\t\tprovider.scope,\n\t\t\t\ttoken.name,\n\t\t\t);\n\t\t\tconst value = provider.useFactory(deps) as T;\n\n\t\t\tif (host) {\n\t\t\t\thost.store.set(token, {\n\t\t\t\t\tvalue,\n\t\t\t\t\t...(provider.onDispose ? { onDispose: provider.onDispose } : {}),\n\t\t\t\t});\n\t\t\t}\n\n\t\t\treturn value;\n\t\t} finally {\n\t\t\tctx.exit(token);\n\t\t}\n\t}\n\n\tprivate selectHost(\n\t\tscope: Scope | undefined,\n\t\towner: ResolverClass,\n\t): ResolverClass | undefined {\n\t\tif (scope === Scopes.Transient) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\tif (scope === Scopes.Scoped) {\n\t\t\treturn this;\n\t\t}\n\n\t\treturn owner;\n\t}\n\n\tprivate resolveDeps<TDeps extends DepsMap>(\n\t\tdeps: TDeps | undefined,\n\t\tcontext: ResolutionContext,\n\t\tconsumerScope: Scope | undefined,\n\t\tconsumerName: string,\n\t): ResolveDeps<TDeps> {\n\t\tif (!deps) {\n\t\t\treturn {} as ResolveDeps<TDeps>;\n\t\t}\n\n\t\tconst resolvedDeps: Partial<ResolveDeps<TDeps>> = {};\n\n\t\tfor (const key of Object.keys(deps) as Array<keyof TDeps>) {\n\t\t\tconst dependency = deps[key];\n\n\t\t\tif (dependency === undefined) {\n\t\t\t\tthrow new InvalidDependencyError(String(key));\n\t\t\t}\n\n\t\t\tresolvedDeps[key] = (\n\t\t\t\tisOptionalDependency(dependency)\n\t\t\t\t\t? this.lookupOptional(\n\t\t\t\t\t\t\tdependency.token,\n\t\t\t\t\t\t\tcontext,\n\t\t\t\t\t\t\tconsumerScope,\n\t\t\t\t\t\t\tconsumerName,\n\t\t\t\t\t\t)\n\t\t\t\t\t: this.resolveToken(dependency, context, consumerScope, consumerName)\n\t\t\t) as ResolveDeps<TDeps>[typeof key];\n\t\t}\n\n\t\treturn resolvedDeps as ResolveDeps<TDeps>;\n\t}\n\n\t// Absent provider -> undefined; a present one resolves normally (its errors surface).\n\tprivate lookupOptional<T>(\n\t\ttoken: Token<T>,\n\t\tcontext: ResolutionContext | undefined,\n\t\tconsumerScope?: Scope,\n\t\tconsumerName?: string,\n\t): T | undefined {\n\t\tlet owner: ResolverClass | undefined = this;\n\n\t\twhile (owner) {\n\t\t\tif (owner.registry.has(token)) {\n\t\t\t\treturn this.resolveToken(token, context, consumerScope, consumerName);\n\t\t\t}\n\n\t\t\towner = owner.parent;\n\t\t}\n\n\t\treturn undefined;\n\t}\n}\n\nexport const createResolver = (\n\tregistry: Registry,\n\tparent?: Resolver,\n): Resolver => new ResolverClass(registry, parent as ResolverClass | undefined);\n","import {\n\ttype Dependency,\n\tInvalidProviderError,\n\tisOptionalDependency,\n\ttype OptionalDependency,\n\ttype Provider,\n} from \"../provider\";\nimport {\n\tcreateRegistry,\n\ttype RegisterOptions,\n\ttype Registry,\n} from \"../registry\";\nimport { createResolver, type Resolver } from \"../resolver\";\nimport type { Token } from \"../token\";\nimport type { Container } from \"./types\";\n\nclass ContainerClass implements Container {\n\tprivate readonly registry: Registry;\n\tprivate readonly resolver: Resolver;\n\tprivate readonly parent: ContainerClass | undefined;\n\n\tconstructor(providers: readonly Provider[] = [], parent?: ContainerClass) {\n\t\tthis.parent = parent;\n\t\tthis.registry = createRegistry();\n\n\t\tfor (const provider of providers) {\n\t\t\tthis.registry.register(provider);\n\t\t}\n\n\t\tthis.resolver = createResolver(this.registry, parent?.resolver);\n\t}\n\n\tregister(provider: Provider, options?: RegisterOptions): void {\n\t\t// Don't silently drop a live disposable instance; require explicit dispose.\n\t\tif (\n\t\t\toptions?.allowOverride &&\n\t\t\tthis.resolver.hasDisposableInstance(provider.provide)\n\t\t) {\n\t\t\tthrow new InvalidProviderError(\n\t\t\t\t`Cannot override token \"${provider.provide.name}\": its instance was already created and has an onDispose hook. Dispose the container before replacing it.`,\n\t\t\t);\n\t\t}\n\n\t\tconst overridden = this.registry.register(provider, options);\n\n\t\tif (overridden) {\n\t\t\tthis.resolver.invalidate(provider.provide);\n\t\t}\n\t}\n\n\tget<T>(token: Token<T>): T;\n\tget<T>(dependency: OptionalDependency<T>): T | undefined;\n\tget<T>(dependency: Dependency<T>): T | undefined {\n\t\tif (isOptionalDependency(dependency)) {\n\t\t\treturn this.resolver.resolveOptional(dependency.token);\n\t\t}\n\n\t\treturn this.resolver.resolve(dependency);\n\t}\n\n\thas(token: Token<unknown>): boolean {\n\t\treturn this.registry.has(token) || (this.parent?.has(token) ?? false);\n\t}\n\n\tdispose(): Promise<void> {\n\t\treturn this.resolver.dispose();\n\t}\n}\n\n/**\n * Creates a root container with optional initial providers.\n *\n * Root containers own singleton instances for providers registered in them.\n */\nexport const createContainer = (\n\tproviders: readonly Provider[] = [],\n): Container => new ContainerClass(providers);\n\n/**\n * Creates a child container that can resolve providers from its parent.\n *\n * Child containers may register their own providers while still reusing parent\n * providers. Scoped providers create one cached instance per resolving child.\n */\nexport const createChildContainer = (\n\tparent: Container,\n\tproviders: readonly Provider[] = [],\n): Container => new ContainerClass(providers, parent as ContainerClass);\n"],"mappings":"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"}

package/dist/hydration-BJ-gWd38.d.mts

@@ -171,4 +171,5 @@ declare const dehydrate: <const TSchema extends HydrationSchema>(options: Dehydr
 */
 declare const hydrate: <const TSchema extends HydrationSchema>(options: HydrateOptions<TSchema>) => void;
 //#endregion
-export { Hydratable as a, HydrationSnapshot as c, RunWithRequestContainerOptions as d, Serializable as f, DehydrateOptions as i, NextDiAdapter as l, hydrate as n, HydrateOptions as o, SerializablePrimitive as p, CreateNextDiOptions as r, HydrationSchema as s, dehydrate as t, RequestCache as u };
+export { Hydratable as a, HydrationSnapshot as c, RunWithRequestContainerOptions as d, Serializable as f, DehydrateOptions as i, NextDiAdapter as l, hydrate as n, HydrateOptions as o, SerializablePrimitive as p, CreateNextDiOptions as r, HydrationSchema as s, dehydrate as t, RequestCache as u };
+//# sourceMappingURL=hydration-BJ-gWd38.d.mts.map

package/dist/hydration-CLZgCNpJ.mjs

@@ -0,0 +1,60 @@
+//#region src/adapters/next/hydration.ts
+/**
+* Reads serializable snapshots from hydratable entities declared in a schema.
+*
+* Use this on the server side before crossing into a Client Component. Only the
+* returned snapshot should cross the boundary, not the container or service
+* instances themselves.
+*
+* @example
+* ```ts
+* const hydration = { user: USER_STATE };
+* const snapshot = dehydrate({
+*   container: getRequestContainer(),
+*   schema: hydration,
+* });
+* ```
+*/
+const dehydrate = (options) => {
+	const snapshot = {};
+	for (const key of Object.keys(options.schema)) {
+		const token = options.schema[key];
+		const isMissingToken = token === void 0;
+		const snapshotKey = String(key);
+		if (isMissingToken) throw new Error(`Missing hydration token for key "${snapshotKey}".`);
+		snapshot[snapshotKey] = options.container.get(token).dehydrate();
+	}
+	return snapshot;
+};
+/**
+* Restores serializable snapshots into hydratable entities declared in a schema.
+*
+* Use this with a client-safe container and the snapshot received through a
+* Client Component prop.
+*
+* @example
+* ```ts
+* hydrate({
+*   container: clientContainer,
+*   schema: hydration,
+*   snapshot,
+* });
+* ```
+*/
+const hydrate = (options) => {
+	const snapshotRecord = options.snapshot;
+	for (const key of Object.keys(options.schema)) {
+		const token = options.schema[key];
+		const snapshotKey = String(key);
+		const value = snapshotRecord[snapshotKey];
+		const isMissingToken = token === void 0;
+		const isMissingSnapshot = value === void 0;
+		if (isMissingToken) throw new Error(`Missing hydration token for key "${snapshotKey}".`);
+		if (isMissingSnapshot) throw new Error(`Missing hydration snapshot for key "${snapshotKey}".`);
+		options.container.get(token).hydrate(value);
+	}
+};
+
+//#endregion
+export { hydrate as n, dehydrate as t };
+//# sourceMappingURL=hydration-CLZgCNpJ.mjs.map

package/dist/hydration-CLZgCNpJ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration-CLZgCNpJ.mjs","names":[],"sources":["../src/adapters/next/hydration.ts"],"sourcesContent":["import type {\n\tDehydrateOptions,\n\tHydrateOptions,\n\tHydrationSchema,\n\tHydrationSnapshot,\n\tSerializable,\n} from \"./types\";\n\n/**\n * Reads serializable snapshots from hydratable entities declared in a schema.\n *\n * Use this on the server side before crossing into a Client Component. Only the\n * returned snapshot should cross the boundary, not the container or service\n * instances themselves.\n *\n * @example\n * ```ts\n * const hydration = { user: USER_STATE };\n * const snapshot = dehydrate({\n *   container: getRequestContainer(),\n *   schema: hydration,\n * });\n * ```\n */\nexport const dehydrate = <const TSchema extends HydrationSchema>(\n\toptions: DehydrateOptions<TSchema>,\n): HydrationSnapshot<TSchema> => {\n\tconst snapshot: Record<string, Serializable> = {};\n\n\tfor (const key of Object.keys(options.schema) as Array<keyof TSchema>) {\n\t\tconst token = options.schema[key];\n\t\tconst isMissingToken = token === undefined;\n\t\tconst snapshotKey = String(key);\n\n\t\tif (isMissingToken) {\n\t\t\tthrow new Error(`Missing hydration token for key \"${snapshotKey}\".`);\n\t\t}\n\n\t\tsnapshot[snapshotKey] = options.container.get(token).dehydrate();\n\t}\n\n\treturn snapshot as HydrationSnapshot<TSchema>;\n};\n\n/**\n * Restores serializable snapshots into hydratable entities declared in a schema.\n *\n * Use this with a client-safe container and the snapshot received through a\n * Client Component prop.\n *\n * @example\n * ```ts\n * hydrate({\n *   container: clientContainer,\n *   schema: hydration,\n *   snapshot,\n * });\n * ```\n */\nexport const hydrate = <const TSchema extends HydrationSchema>(\n\toptions: HydrateOptions<TSchema>,\n): void => {\n\tconst snapshotRecord = options.snapshot as Record<\n\t\tstring,\n\t\tSerializable | undefined\n\t>;\n\n\tfor (const key of Object.keys(options.schema) as Array<keyof TSchema>) {\n\t\tconst token = options.schema[key];\n\t\tconst snapshotKey = String(key);\n\t\tconst value = snapshotRecord[snapshotKey];\n\n\t\tconst isMissingToken = token === undefined;\n\t\tconst isMissingSnapshot = value === undefined;\n\n\t\tif (isMissingToken) {\n\t\t\tthrow new Error(`Missing hydration token for key \"${snapshotKey}\".`);\n\t\t}\n\n\t\tif (isMissingSnapshot) {\n\t\t\tthrow new Error(`Missing hydration snapshot for key \"${snapshotKey}\".`);\n\t\t}\n\n\t\toptions.container.get(token).hydrate(value);\n\t}\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAwBA,MAAa,aACZ,YACgC;CAChC,MAAM,WAAyC,CAAC;CAEhD,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,GAA2B;EACtE,MAAM,QAAQ,QAAQ,OAAO;EAC7B,MAAM,iBAAiB,UAAU;EACjC,MAAM,cAAc,OAAO,GAAG;EAE9B,IAAI,gBACH,MAAM,IAAI,MAAM,oCAAoC,YAAY,GAAG;EAGpE,SAAS,eAAe,QAAQ,UAAU,IAAI,KAAK,CAAC,CAAC,UAAU;CAChE;CAEA,OAAO;AACR;;;;;;;;;;;;;;;;AAiBA,MAAa,WACZ,YACU;CACV,MAAM,iBAAiB,QAAQ;CAK/B,KAAK,MAAM,OAAO,OAAO,KAAK,QAAQ,MAAM,GAA2B;EACtE,MAAM,QAAQ,QAAQ,OAAO;EAC7B,MAAM,cAAc,OAAO,GAAG;EAC9B,MAAM,QAAQ,eAAe;EAE7B,MAAM,iBAAiB,UAAU;EACjC,MAAM,oBAAoB,UAAU;EAEpC,IAAI,gBACH,MAAM,IAAI,MAAM,oCAAoC,YAAY,GAAG;EAGpE,IAAI,mBACH,MAAM,IAAI,MAAM,uCAAuC,YAAY,GAAG;EAGvE,QAAQ,UAAU,IAAI,KAAK,CAAC,CAAC,QAAQ,KAAK;CAC3C;AACD"}

package/dist/index.d.mts

@@ -1,9 +1,6 @@
 import { a as DisposeHook, c as OptionalDependency, d as Token, f as Scope, i as DepsMap, l as Provider, n as RegisterOptions, o as Factory, p as Scopes, r as Dependency, s as FactoryProvider, t as Container, u as ValueProvider } from "./types-BzLfq9VA.mjs";
 
 //#region src/core/error/error.d.ts
-/**
-* Base class for all di-craft runtime errors.
-*/
 declare class DiError extends Error {
   constructor(message: string);
 }
@@ -178,4 +175,5 @@ declare class CircularDependencyError extends DiError {
   constructor(tokenNames: string[]);
 }
 //#endregion
-export { CircularDependencyError, type Container, type Dependency, DiError, type DisposeHook, DuplicateProviderError, type FactoryProvider, Injectable, InvalidDependencyError, InvalidProviderError, MissingProviderError, type OptionalDependency, type Provider, type RegisterOptions, type Scope, Scopes, type Token, type ValueProvider, createChildContainer, createContainer, createToken, optional, provideFactory, provideInjectable, provideValue };
+export { CircularDependencyError, type Container, type Dependency, DiError, type DisposeHook, DuplicateProviderError, type FactoryProvider, Injectable, InvalidDependencyError, InvalidProviderError, MissingProviderError, type OptionalDependency, type Provider, type RegisterOptions, type Scope, Scopes, type Token, type ValueProvider, createChildContainer, createContainer, createToken, optional, provideFactory, provideInjectable, provideValue };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1 +1,103 @@
-import{a as e,c as t,d as n,f as r,i,l as a,n as o,o as s,r as c,s as l,t as u,u as d}from"./container-C6GcrdNn.mjs";const f=e=>{if(e.length!==0)return Object.fromEntries(e.entries())},p=new WeakMap,m=e=>p.get(e),h=e=>{p.set(e.target,e.metadata)},g=e=>{let{context:t,target:r}=e;if(!(t.kind===`class`&&typeof r==`function`))throw new n(`@Injectable can only decorate classes`)};function _(e){return(t,n)=>{g({target:t,context:n}),h({target:t,metadata:e})}}function v(e){let r=m(e);if(!r)throw new n(`Class "${e.name||`<anonymous>`}" is not marked as injectable. Add @Injectable({ token: TOKEN }) before calling provideInjectable().`);let{deps:i=[],onDispose:a,scope:o,token:s}=r,c=f(i),l=e;return t(s,{useFactory:e=>new l(...i.map((t,n)=>e[String(n)])),...c?{deps:c}:{},...o?{scope:o}:{},...a?{onDispose:a}:{}})}var y=class{name;id;constructor(e){this.name=e,this.id=Symbol(e)}};const b=e=>new y(e);export{c as CircularDependencyError,r as DiError,s as DuplicateProviderError,_ as Injectable,i as InvalidDependencyError,n as InvalidProviderError,e as MissingProviderError,d as Scopes,u as createChildContainer,o as createContainer,b as createToken,l as optional,t as provideFactory,v as provideInjectable,a as provideValue};
+import { a as MissingProviderError, c as provideFactory, d as InvalidProviderError, f as DiError, i as InvalidDependencyError, l as provideValue, n as createContainer, o as DuplicateProviderError, r as CircularDependencyError, s as optional, t as createChildContainer, u as Scopes } from "./container-l5DkUBUj.mjs";
+
+//#region src/core/annotation/deps.ts
+const tupleDepsToMap = (deps) => {
+	if (deps.length === 0) return;
+	return Object.fromEntries(deps.entries());
+};
+
+//#endregion
+//#region src/core/annotation/metadata.ts
+const injectableMetadata = /* @__PURE__ */ new WeakMap();
+const getInjectableMetadata = (target) => injectableMetadata.get(target);
+const setInjectableMetadata = (options) => {
+	injectableMetadata.set(options.target, options.metadata);
+};
+
+//#endregion
+//#region src/core/annotation/annotation.ts
+const ANONYMOUS_CLASS_NAME = "<anonymous>";
+const assertClassDecorator = (options) => {
+	const { context, target } = options;
+	if (!(context.kind === "class" && typeof target === "function")) throw new InvalidProviderError("@Injectable can only decorate classes");
+};
+/**
+* Marks a class as an injectable provider for a token.
+*
+* Dependencies are explicit and ordered by constructor parameter position. No
+* `reflect-metadata`, parameter decorators, or global container are used.
+*
+* @example
+* ```ts
+* @Injectable({ token: USER_SERVICE, deps: [LOGGER] })
+* class UserService {
+*   private readonly logger: Logger;
+*
+*   constructor(logger: Logger) {
+*     this.logger = logger;
+*   }
+* }
+* ```
+*/
+function Injectable(options) {
+	return (target, context) => {
+		assertClassDecorator({
+			target,
+			context
+		});
+		setInjectableMetadata({
+			target,
+			metadata: options
+		});
+	};
+}
+/**
+* Creates a factory provider from a class marked with `@Injectable`.
+*
+* The returned provider is a normal di-craft factory provider, so scopes,
+* optional dependencies, disposal hooks, overrides, and cycle detection behave
+* the same as with `provideFactory`.
+*/
+function provideInjectable(target) {
+	const metadata = getInjectableMetadata(target);
+	if (!metadata) throw new InvalidProviderError(`Class "${target.name || ANONYMOUS_CLASS_NAME}" is not marked as injectable. Add @Injectable({ token: TOKEN }) before calling provideInjectable().`);
+	const { deps = [], onDispose, scope, token } = metadata;
+	const depsMap = tupleDepsToMap(deps);
+	const Constructor = target;
+	const useFactory = (resolvedDeps) => {
+		return new Constructor(...deps.map((_, index) => resolvedDeps[String(index)]));
+	};
+	return provideFactory(token, {
+		useFactory,
+		...depsMap ? { deps: depsMap } : {},
+		...scope ? { scope } : {},
+		...onDispose ? { onDispose } : {}
+	});
+}
+
+//#endregion
+//#region src/core/token/token.ts
+var TokenClass = class {
+	name;
+	id;
+	constructor(name) {
+		this.name = name;
+		this.id = Symbol(name);
+	}
+};
+/**
+* Creates a unique typed token.
+*
+* The `name` is used only for diagnostics. Token identity is unique per call,
+* so two tokens with the same name do not collide.
+*
+* @example
+* ```ts
+* const CONFIG = createToken<Config>("config");
+* ```
+*/
+const createToken = (name) => new TokenClass(name);
+
+//#endregion
+export { CircularDependencyError, DiError, DuplicateProviderError, Injectable, InvalidDependencyError, InvalidProviderError, MissingProviderError, Scopes, createChildContainer, createContainer, createToken, optional, provideFactory, provideInjectable, provideValue };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/core/annotation/deps.ts","../src/core/annotation/metadata.ts","../src/core/annotation/annotation.ts","../src/core/token/token.ts"],"sourcesContent":["import type { Dependency, DepsMap } from \"../provider\";\n\nexport const tupleDepsToMap = (\n\tdeps: readonly Dependency<unknown>[],\n): DepsMap | undefined => {\n\tif (deps.length === 0) {\n\t\treturn undefined;\n\t}\n\n\treturn Object.fromEntries(deps.entries());\n};\n","import type { InjectableClass, InjectableOptions } from \"./types\";\n\ntype InjectableMetadata = InjectableOptions<unknown>;\n\nconst injectableMetadata = new WeakMap<InjectableClass, InjectableMetadata>();\n\nexport const getInjectableMetadata = (\n\ttarget: InjectableClass,\n): InjectableMetadata | undefined => injectableMetadata.get(target);\n\nexport const setInjectableMetadata = <T>(options: {\n\treadonly target: InjectableClass<T>;\n\treadonly metadata: InjectableOptions<T>;\n}): void => {\n\tinjectableMetadata.set(\n\t\toptions.target,\n\t\toptions.metadata as InjectableOptions<unknown>,\n\t);\n};\n","import {\n\ttype Dependency,\n\ttype DepsMap,\n\ttype DisposeHook,\n\ttype FactoryProvider,\n\tInvalidProviderError,\n\tprovideFactory,\n\ttype ResolveDeps,\n} from \"../provider\";\nimport type { Token } from \"../token\";\nimport { tupleDepsToMap } from \"./deps\";\nimport { getInjectableMetadata, setInjectableMetadata } from \"./metadata\";\nimport type {\n\tInjectableClass,\n\tInjectableConstructor,\n\tInjectableOptions,\n} from \"./types\";\n\ntype Constructable<T> = new (...args: unknown[]) => T;\ntype InjectableDecorator<TTarget> = (\n\ttarget: TTarget,\n\tcontext: ClassDecoratorContext,\n) => void;\n\ntype InjectableOptionsWithoutDeps<T> = Omit<\n\tInjectableOptions<T, readonly []>,\n\t\"deps\"\n>;\n\nconst ANONYMOUS_CLASS_NAME = \"<anonymous>\";\n\nconst assertClassDecorator = (options: {\n\treadonly target: InjectableClass;\n\treadonly context: ClassDecoratorContext;\n}): void => {\n\tconst { context, target } = options;\n\tconst isClassDecorator =\n\t\tcontext.kind === \"class\" && typeof target === \"function\";\n\n\tif (!isClassDecorator) {\n\t\tthrow new InvalidProviderError(\"@Injectable can only decorate classes\");\n\t}\n};\n\n// Overloads keep constructor parameters aligned with explicit deps. The single\n// runtime implementation is below.\nexport function Injectable<\n\tT,\n\tconst TDeps extends readonly Dependency<unknown>[],\n>(\n\toptions: InjectableOptions<T, TDeps> & { readonly deps: TDeps },\n): InjectableDecorator<InjectableConstructor<T, TDeps>>;\n\nexport function Injectable<T>(\n\toptions: InjectableOptionsWithoutDeps<T>,\n): InjectableDecorator<InjectableConstructor<T, readonly []>>;\n/**\n * Marks a class as an injectable provider for a token.\n *\n * Dependencies are explicit and ordered by constructor parameter position. No\n * `reflect-metadata`, parameter decorators, or global container are used.\n *\n * @example\n * ```ts\n * @Injectable({ token: USER_SERVICE, deps: [LOGGER] })\n * class UserService {\n *   private readonly logger: Logger;\n *\n *   constructor(logger: Logger) {\n *     this.logger = logger;\n *   }\n * }\n * ```\n */\nexport function Injectable<T>(\n\toptions: InjectableOptions<T>,\n): InjectableDecorator<InjectableClass<T>> {\n\treturn (target: InjectableClass<T>, context: ClassDecoratorContext): void => {\n\t\tassertClassDecorator({ target, context });\n\t\tsetInjectableMetadata({ target, metadata: options });\n\t};\n}\n\n/**\n * Creates a factory provider from a class marked with `@Injectable`.\n *\n * The returned provider is a normal di-craft factory provider, so scopes,\n * optional dependencies, disposal hooks, overrides, and cycle detection behave\n * the same as with `provideFactory`.\n */\nexport function provideInjectable<T>(\n\ttarget: InjectableClass<T>,\n): FactoryProvider<T, DepsMap> {\n\tconst metadata = getInjectableMetadata(target);\n\n\tif (!metadata) {\n\t\tconst className = target.name || ANONYMOUS_CLASS_NAME;\n\n\t\tthrow new InvalidProviderError(\n\t\t\t`Class \"${className}\" is not marked as injectable. Add @Injectable({ token: TOKEN }) before calling provideInjectable().`,\n\t\t);\n\t}\n\n\tconst { deps = [], onDispose, scope, token } = metadata;\n\tconst depsMap = tupleDepsToMap(deps);\n\tconst Constructor = target as unknown as Constructable<T>;\n\n\tconst useFactory = (resolvedDeps: ResolveDeps<DepsMap>): T => {\n\t\tconst args = deps.map((_, index): unknown => resolvedDeps[String(index)]);\n\n\t\treturn new Constructor(...args);\n\t};\n\n\treturn provideFactory(token as Token<T>, {\n\t\tuseFactory,\n\t\t...(depsMap ? { deps: depsMap } : {}),\n\t\t...(scope ? { scope } : {}),\n\t\t...(onDispose ? { onDispose: onDispose as DisposeHook<T> } : {}),\n\t});\n}\n","import type { Token } from \"./types\";\n\nclass TokenClass<T> implements Token<T> {\n\treadonly name: string;\n\treadonly id: symbol;\n\n\tdeclare readonly __type?: T;\n\n\tconstructor(name: string) {\n\t\tthis.name = name;\n\t\tthis.id = Symbol(name);\n\t}\n}\n\n/**\n * Creates a unique typed token.\n *\n * The `name` is used only for diagnostics. Token identity is unique per call,\n * so two tokens with the same name do not collide.\n *\n * @example\n * ```ts\n * const CONFIG = createToken<Config>(\"config\");\n * ```\n */\nexport const createToken = <T>(name: string): Token<T> =>\n\tnew TokenClass<T>(name);\n"],"mappings":";;;AAEA,MAAa,kBACZ,SACyB;CACzB,IAAI,KAAK,WAAW,GACnB;CAGD,OAAO,OAAO,YAAY,KAAK,QAAQ,CAAC;AACzC;;;;ACNA,MAAM,qCAAqB,IAAI,QAA6C;AAE5E,MAAa,yBACZ,WACoC,mBAAmB,IAAI,MAAM;AAElE,MAAa,yBAA4B,YAG7B;CACX,mBAAmB,IAClB,QAAQ,QACR,QAAQ,QACT;AACD;;;;ACWA,MAAM,uBAAuB;AAE7B,MAAM,wBAAwB,YAGlB;CACX,MAAM,EAAE,SAAS,WAAW;CAI5B,IAAI,EAFH,QAAQ,SAAS,WAAW,OAAO,WAAW,aAG9C,MAAM,IAAI,qBAAqB,uCAAuC;AAExE;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,WACf,SAC0C;CAC1C,QAAQ,QAA4B,YAAyC;EAC5E,qBAAqB;GAAE;GAAQ;EAAQ,CAAC;EACxC,sBAAsB;GAAE;GAAQ,UAAU;EAAQ,CAAC;CACpD;AACD;;;;;;;;AASA,SAAgB,kBACf,QAC8B;CAC9B,MAAM,WAAW,sBAAsB,MAAM;CAE7C,IAAI,CAAC,UAGJ,MAAM,IAAI,qBACT,UAHiB,OAAO,QAAQ,qBAGZ,qGACrB;CAGD,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,OAAO,UAAU;CAC/C,MAAM,UAAU,eAAe,IAAI;CACnC,MAAM,cAAc;CAEpB,MAAM,cAAc,iBAA0C;EAG7D,OAAO,IAAI,YAAY,GAFV,KAAK,KAAK,GAAG,UAAmB,aAAa,OAAO,KAAK,EAEzC,CAAC;CAC/B;CAEA,OAAO,eAAe,OAAmB;EACxC;EACA,GAAI,UAAU,EAAE,MAAM,QAAQ,IAAI,CAAC;EACnC,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;EACzB,GAAI,YAAY,EAAa,UAA4B,IAAI,CAAC;CAC/D,CAAC;AACF;;;;ACrHA,IAAM,aAAN,MAAwC;CACvC,AAAS;CACT,AAAS;CAIT,YAAY,MAAc;EACzB,KAAK,OAAO;EACZ,KAAK,KAAK,OAAO,IAAI;CACtB;AACD;;;;;;;;;;;;AAaA,MAAa,eAAkB,SAC9B,IAAI,WAAc,IAAI"}

package/dist/next/client.mjs

@@ -1 +1,3 @@
-import{n as e}from"../hydration-DsCFyhuJ.mjs";export{e as hydrate};
+import { n as hydrate } from "../hydration-CLZgCNpJ.mjs";
+
+export { hydrate };

package/dist/next/server.d.mts

@@ -30,4 +30,5 @@ declare const createNextDi: ({
   requestProviders
 }: CreateNextDiOptions) => NextDiAdapter;
 //#endregion
-export { type CreateNextDiOptions, type DehydrateOptions, type Hydratable, type HydrationSchema, type HydrationSnapshot, type NextDiAdapter, type RequestCache, type RunWithRequestContainerOptions, type Serializable, type SerializablePrimitive, createNextDi, dehydrate };
+export { type CreateNextDiOptions, type DehydrateOptions, type Hydratable, type HydrationSchema, type HydrationSnapshot, type NextDiAdapter, type RequestCache, type RunWithRequestContainerOptions, type Serializable, type SerializablePrimitive, createNextDi, dehydrate };
+//# sourceMappingURL=server.d.mts.map

package/dist/next/server.mjs

@@ -1 +1,53 @@
-import{n as e,t}from"../container-C6GcrdNn.mjs";import{t as n}from"../hydration-DsCFyhuJ.mjs";const r=()=>{if(`window`in globalThis)throw Error(`di-craft/next/server can only be used in a server runtime.`)},i=({cache:n,providers:i=[],requestProviders:a})=>{r();let o=e(i),s=(e=[])=>t(o,[...a?.()??[],...e]);return{getRootContainer:()=>o,getRequestContainer:n(()=>s()),createRequestContainer:s,runWithRequestContainer:async({providers:e=[],run:t})=>{let n=s(e);try{return await t(n)}finally{await n.dispose()}},disposeRootContainer:()=>o.dispose()}};export{i as createNextDi,n as dehydrate};
+import { n as createContainer, t as createChildContainer } from "../container-l5DkUBUj.mjs";
+import { t as dehydrate } from "../hydration-CLZgCNpJ.mjs";
+
+//#region src/adapters/next/server.ts
+const assertServerRuntime = () => {
+	if ("window" in globalThis) throw new Error("di-craft/next/server can only be used in a server runtime.");
+};
+/**
+* Creates a server adapter for Next.js App Router and React Server Components.
+*
+* The root container is created once. `getRequestContainer` creates a child
+* container through the provided React request cache, so repeated calls inside
+* one RSC request resolve through the same scoped dependency graph.
+*
+* Import this helper from a server-only composition file. The adapter does not
+* import React itself; pass `cache` from `react` so React/Next owns request
+* memoization.
+*
+* @example
+* ```ts
+* import "server-only";
+* import { cache } from "react";
+* import { createNextDi } from "di-craft/next/server";
+*
+* export const { getRequestContainer } = createNextDi({
+*   cache,
+*   providers,
+* });
+* ```
+*/
+const createNextDi = ({ cache, providers = [], requestProviders }) => {
+	assertServerRuntime();
+	const rootContainer = createContainer(providers);
+	const createRequestContainer = (providers = []) => createChildContainer(rootContainer, [...requestProviders?.() ?? [], ...providers]);
+	return {
+		getRootContainer: () => rootContainer,
+		getRequestContainer: cache(() => createRequestContainer()),
+		createRequestContainer,
+		runWithRequestContainer: async ({ providers = [], run }) => {
+			const container = createRequestContainer(providers);
+			try {
+				return await run(container);
+			} finally {
+				await container.dispose();
+			}
+		},
+		disposeRootContainer: () => rootContainer.dispose()
+	};
+};
+
+//#endregion
+export { createNextDi, dehydrate };
+//# sourceMappingURL=server.mjs.map

package/dist/next/server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.mjs","names":[],"sources":["../../src/adapters/next/server.ts"],"sourcesContent":["/**\n * Server-side Next.js App Router adapter for request-scoped containers.\n *\n * @module\n */\n\nimport type { Container } from \"../../core/container\";\nimport { createChildContainer, createContainer } from \"../../core/container\";\nimport type { Provider } from \"../../core/provider\";\nimport type {\n\tCreateNextDiOptions,\n\tNextDiAdapter,\n\tRunWithRequestContainerOptions,\n} from \"./types\";\n\nexport { dehydrate } from \"./hydration\";\nexport type {\n\tCreateNextDiOptions,\n\tDehydrateOptions,\n\tHydratable,\n\tHydrationSchema,\n\tHydrationSnapshot,\n\tNextDiAdapter,\n\tRequestCache,\n\tRunWithRequestContainerOptions,\n\tSerializable,\n\tSerializablePrimitive,\n} from \"./types\";\n\nconst assertServerRuntime = (): void => {\n\tif (\"window\" in globalThis) {\n\t\tthrow new Error(\n\t\t\t\"di-craft/next/server can only be used in a server runtime.\",\n\t\t);\n\t}\n};\n\n/**\n * Creates a server adapter for Next.js App Router and React Server Components.\n *\n * The root container is created once. `getRequestContainer` creates a child\n * container through the provided React request cache, so repeated calls inside\n * one RSC request resolve through the same scoped dependency graph.\n *\n * Import this helper from a server-only composition file. The adapter does not\n * import React itself; pass `cache` from `react` so React/Next owns request\n * memoization.\n *\n * @example\n * ```ts\n * import \"server-only\";\n * import { cache } from \"react\";\n * import { createNextDi } from \"di-craft/next/server\";\n *\n * export const { getRequestContainer } = createNextDi({\n *   cache,\n *   providers,\n * });\n * ```\n */\nexport const createNextDi = ({\n\tcache,\n\tproviders = [],\n\trequestProviders,\n}: CreateNextDiOptions): NextDiAdapter => {\n\tassertServerRuntime();\n\n\tconst rootContainer = createContainer(providers);\n\tconst createRequestContainer = (\n\t\tproviders: readonly Provider[] = [],\n\t): Container =>\n\t\tcreateChildContainer(rootContainer, [\n\t\t\t...(requestProviders?.() ?? []),\n\t\t\t...providers,\n\t\t]);\n\tconst getRequestContainer = cache(() => createRequestContainer());\n\n\treturn {\n\t\tgetRootContainer: () => rootContainer,\n\t\tgetRequestContainer,\n\t\tcreateRequestContainer,\n\t\trunWithRequestContainer: async <TResult>({\n\t\t\tproviders = [],\n\t\t\trun,\n\t\t}: RunWithRequestContainerOptions<TResult>): Promise<Awaited<TResult>> => {\n\t\t\tconst container = createRequestContainer(providers);\n\n\t\t\ttry {\n\t\t\t\treturn await run(container);\n\t\t\t} finally {\n\t\t\t\tawait container.dispose();\n\t\t\t}\n\t\t},\n\t\tdisposeRootContainer: () => rootContainer.dispose(),\n\t};\n};\n"],"mappings":";;;;AA6BA,MAAM,4BAAkC;CACvC,IAAI,YAAY,YACf,MAAM,IAAI,MACT,4DACD;AAEF;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAa,gBAAgB,EAC5B,OACA,YAAY,CAAC,GACb,uBACyC;CACzC,oBAAoB;CAEpB,MAAM,gBAAgB,gBAAgB,SAAS;CAC/C,MAAM,0BACL,YAAiC,CAAC,MAElC,qBAAqB,eAAe,CACnC,GAAI,mBAAmB,KAAK,CAAC,GAC7B,GAAG,SACJ,CAAC;CAGF,OAAO;EACN,wBAAwB;EACxB,qBAJ2B,YAAY,uBAAuB,CAI5C;EAClB;EACA,yBAAyB,OAAgB,EACxC,YAAY,CAAC,GACb,UACyE;GACzE,MAAM,YAAY,uBAAuB,SAAS;GAElD,IAAI;IACH,OAAO,MAAM,IAAI,SAAS;GAC3B,UAAU;IACT,MAAM,UAAU,QAAQ;GACzB;EACD;EACA,4BAA4B,cAAc,QAAQ;CACnD;AACD"}

package/dist/types-BzLfq9VA.d.mts

@@ -137,4 +137,5 @@ type Container = {
   dispose(): Promise<void>;
 };
 //#endregion
-export { DisposeHook as a, OptionalDependency as c, Token as d, Scope as f, DepsMap as i, Provider as l, RegisterOptions as n, Factory as o, Scopes as p, Dependency as r, FactoryProvider as s, Container as t, ValueProvider as u };
+export { DisposeHook as a, OptionalDependency as c, Token as d, Scope as f, DepsMap as i, Provider as l, RegisterOptions as n, Factory as o, Scopes as p, Dependency as r, FactoryProvider as s, Container as t, ValueProvider as u };
+//# sourceMappingURL=types-BzLfq9VA.d.mts.map

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "di-craft",
-	"version": "0.0.19",
-	"description": "A tiny, type-safe dependency injection container for TypeScript",
+	"version": "0.0.21",
+	"description": "A tiny, type-safe dependency injection container for TypeScript with an optional Next.js App Router adapter",
 	"license": "MIT",
 	"author": {
 		"name": "Egor Bezmen",
@@ -38,7 +38,7 @@
 	"scripts": {
 		"build": "tsdown",
 		"test": "bun test",
-		"typecheck": "tsc --noEmit",
+		"typecheck": "tsc --noEmit -p tsconfig.src.json && tsc --noEmit -p tsconfig.test.json",
 		"lint": "biome check .",
 		"format": "biome check --write .",
 		"publint": "publint",
@@ -61,7 +61,17 @@
 		"zero dependencies",
 		"lightweight",
 		"tiny",
-		"tree-shakable"
+		"tree-shakable",
+		"nextjs",
+		"next.js",
+		"app router",
+		"react server components",
+		"rsc",
+		"server components",
+		"request scope",
+		"ssr",
+		"state hydration",
+		"next adapter"
 	],
 	"homepage": "https://github.com/bezmen-e/di-craft",
 	"repository": {
@@ -72,11 +82,11 @@
 		"url": "https://github.com/bezmen-e/di-craft/issues"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "2.4.16",
+		"@biomejs/biome": "2.5.1",
 		"@types/bun": "1.3.14",
 		"publint": "0.3.21",
 		"simple-git-hooks": "2.13.1",
-		"tsdown": "0.22.0",
+		"tsdown": "0.22.3",
 		"typescript": "6.0.3"
 	}
 }

package/dist/container-C6GcrdNn.mjs

@@ -1 +0,0 @@
-var e=class extends Error{constructor(e){super(e),this.name=`DiError`,Error.captureStackTrace&&Error.captureStackTrace(this,this.constructor)}},t=class extends e{constructor(e){super(e),this.name=`InvalidProviderError`}};const n={Singleton:`singleton`,Transient:`transient`,Scoped:`scoped`},r=(e,t)=>({provide:e,useValue:t}),i=(e,r)=>{if(r.scope===n.Transient&&r.onDispose)throw new t(`onDispose is not supported for transient providers (token "${e.name}"): transient instances are not tracked, so the hook would never run.`);return{provide:e,useFactory:r.useFactory,scope:r.scope??n.Singleton,...r.deps?{deps:r.deps}:{},...r.onDispose?{onDispose:r.onDispose}:{}}},a=e=>({token:e,optional:!0}),o=e=>e.optional===!0,s=e=>`useValue`in e;var c=class extends e{constructor(e){super(`Provider for token "${e}" is already registered`),this.name=`DuplicateProviderError`}},l=class{providers=new Map;register(e,t){let n=this.providers.has(e.provide.id);if(n&&!t?.allowOverride)throw new c(e.provide.name);return this.providers.set(e.provide.id,e),n}get(e){return this.providers.get(e.id)}has(e){return this.providers.has(e.id)}};const u=()=>new l;var d=class extends e{constructor(e){super(`Provider for token "${e}" is not registered`),this.name=`MissingProviderError`}},f=class extends e{constructor(e){super(`Invalid dependency "${e}"`),this.name=`InvalidDependencyError`}},p=class extends e{constructor(e){super(`Circular dependency detected: ${e.join(` -> `)}`),this.name=`CircularDependencyError`}},m=class{instances=new Map;get(e){return this.instances.get(e.id)}set(e,t){this.instances.set(e.id,t)}delete(e){this.instances.delete(e.id)}async dispose(){let e=[...this.instances.values()].reverse();this.instances.clear();for(let t of e)t.onDispose&&await t.onDispose(t.value)}};const h=()=>new m;var g=class{resolving=new Set;path=[];enter(e){if(this.resolving.has(e.id)){let t=this.path.findIndex(t=>t.id===e.id);throw new p([...this.path.slice(t),e].map(e=>e.name))}this.resolving.add(e.id),this.path.push(e)}exit(e){this.path.pop(),this.resolving.delete(e.id)}};const _=e=>e===n.Scoped?1:e===n.Transient?2:0;var v=class{registry;store=h();parent;constructor(e,t){this.registry=e,this.parent=t}resolve(e){return this.resolveToken(e,void 0)}resolveOptional(e){return this.lookupOptional(e,void 0)}invalidate(e){this.store.delete(e)}hasDisposableInstance(e){return this.store.get(e)?.onDispose!==void 0}dispose(){return this.store.dispose()}resolveToken(e,r,i,a){let o=this,c;for(;o&&(c=o.registry.get(e),!c);)o=o.parent;if(!c||!o)throw new d(e.name);if(s(c))return c.useValue;if(i!==void 0&&_(c.scope)>_(i))throw new t(`"${a}" (${i}) cannot depend on "${e.name}" (${c.scope??n.Singleton}): a longer-lived provider would capture a shorter-lived one. Widen the dependency's scope or narrow the consumer's.`);let l=this.selectHost(c.scope,o);if(l){let t=l.store.get(e);if(t)return t.value}let u=r??new g;u.enter(e);try{let t=(l??this).resolveDeps(c.deps,u,c.scope,e.name),n=c.useFactory(t);return l&&l.store.set(e,{value:n,...c.onDispose?{onDispose:c.onDispose}:{}}),n}finally{u.exit(e)}}selectHost(e,t){if(e!==n.Transient)return e===n.Scoped?this:t}resolveDeps(e,t,n,r){if(!e)return{};let i={};for(let a of Object.keys(e)){let s=e[a];if(s===void 0)throw new f(String(a));i[a]=o(s)?this.lookupOptional(s.token,t,n,r):this.resolveToken(s,t,n,r)}return i}lookupOptional(e,t,n,r){let i=this;for(;i;){if(i.registry.has(e))return this.resolveToken(e,t,n,r);i=i.parent}}};const y=(e,t)=>new v(e,t);var b=class{registry;resolver;parent;constructor(e=[],t){this.parent=t,this.registry=u();for(let t of e)this.registry.register(t);this.resolver=y(this.registry,t?.resolver)}register(e,n){if(n?.allowOverride&&this.resolver.hasDisposableInstance(e.provide))throw new t(`Cannot override token "${e.provide.name}": its instance was already created and has an onDispose hook. Dispose the container before replacing it.`);this.registry.register(e,n)&&this.resolver.invalidate(e.provide)}get(e){return o(e)?this.resolver.resolveOptional(e.token):this.resolver.resolve(e)}has(e){return this.registry.has(e)||(this.parent?.has(e)??!1)}dispose(){return this.resolver.dispose()}};const x=(e=[])=>new b(e),S=(e,t=[])=>new b(t,e);export{d as a,i as c,t as d,e as f,f as i,r as l,x as n,c as o,p as r,a as s,S as t,n as u};

package/dist/hydration-DsCFyhuJ.mjs

@@ -1 +0,0 @@
-const e=e=>{let t={};for(let n of Object.keys(e.schema)){let r=e.schema[n],i=r===void 0,a=String(n);if(i)throw Error(`Missing hydration token for key "${a}".`);t[a]=e.container.get(r).dehydrate()}return t},t=e=>{let t=e.snapshot;for(let n of Object.keys(e.schema)){let r=e.schema[n],i=String(n),a=t[i],o=r===void 0,s=a===void 0;if(o)throw Error(`Missing hydration token for key "${i}".`);if(s)throw Error(`Missing hydration snapshot for key "${i}".`);e.container.get(r).hydrate(a)}};export{t as n,e as t};