@codefast/di 0.5.0-canary.5 → 0.5.0-canary.7

package/dist/decorators/inject.d.mts

@@ -1,49 +0,0 @@
-import { Constructor } from "../constructor-type.mjs";
-import { Token } from "../token.mjs";
-import { BindingTag } from "../types.mjs";
-
-//#region src/decorators/inject.d.ts
-/**
- * @since 0.3.16-canary.0
- */
-interface InjectOptions {
-  name?: string;
-  tags?: ReadonlyArray<BindingTag>;
-}
-/**
- * @since 0.3.16-canary.0
- */
-interface InjectionDescriptor<Value = unknown> {
-  readonly token: Token<Value> | Constructor<Value>;
-  readonly optional: boolean;
-  readonly multi: boolean;
-  readonly name?: string;
-  readonly tags?: ReadonlyArray<BindingTag>;
-}
-/**
- * @since 0.3.16-canary.0
- */
-type InjectableDependency<Value = unknown> = Token<Value> | Constructor<Value> | InjectionDescriptor<Value>;
-/**
- * @since 0.3.16-canary.0
- */
-declare function isInjectionDescriptor(value: unknown): value is InjectionDescriptor;
-/**
- * @since 0.3.16-canary.0
- */
-declare function normalizeToDescriptor(dependency: InjectableDependency): InjectionDescriptor;
-type ClassAccessorDecorator<This, Value> = (target: ClassAccessorDecoratorTarget<This, Value>, context: ClassAccessorDecoratorContext<This, Value>) => ClassAccessorDecoratorResult<This, Value> | void;
-/**
- * @since 0.3.16-canary.0
- */
-declare function inject<const Value>(token: Token<Value> | Constructor<Value>, options?: InjectOptions): InjectionDescriptor<Value> & ClassAccessorDecorator<unknown, Value>;
-/**
- * @since 0.3.16-canary.0
- */
-declare function optional<const Value>(token: Token<Value> | Constructor<Value>, options?: InjectOptions): InjectionDescriptor<Value | undefined>;
-/**
- * @since 0.3.16-canary.0
- */
-declare function injectAll<const Value>(token: Token<Value> | Constructor<Value>, options?: InjectOptions): InjectionDescriptor<Array<Value>>;
-//#endregion
-export { InjectOptions, InjectableDependency, InjectionDescriptor, inject, injectAll, isInjectionDescriptor, normalizeToDescriptor, optional };

package/dist/decorators/inject.mjs

@@ -1,136 +0,0 @@
-import { InternalError, MissingContainerContextError } from "../errors.mjs";
-import { getActiveContainer } from "../environment.mjs";
-import { INJECT_ACCESSOR_KEY } from "../metadata/metadata-keys.mjs";
-import { injectionSlotToResolveOptions } from "../resolve-options.mjs";
-//#region src/decorators/inject.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function isInjectionDescriptor(value) {
-	if (value === null || value === void 0) return false;
-	const type = typeof value;
-	if (type !== "object" && type !== "function") return false;
-	return "token" in value && "optional" in value && "multi" in value && typeof value.optional === "boolean" && typeof value.multi === "boolean";
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function normalizeToDescriptor(dependency) {
-	if (isInjectionDescriptor(dependency)) return materializeInjectionDescriptor(dependency);
-	return {
-		token: dependency,
-		optional: false,
-		multi: false
-	};
-}
-/**
-* Dual-role `inject()` values are functions: [[Function]].name must not be treated as a DI slot name.
-* Only enumerable own `name` / `tags` from `Object.defineProperties` are real injection options.
-*/
-function materializeInjectionDescriptor(dependency) {
-	if (typeof dependency !== "function") return dependency;
-	const dualRole = dependency;
-	const base = {
-		token: dualRole.token,
-		optional: dualRole.optional,
-		multi: dualRole.multi
-	};
-	const nameDesc = Object.getOwnPropertyDescriptor(dualRole, "name");
-	const tagsDesc = Object.getOwnPropertyDescriptor(dualRole, "tags");
-	const explicitName = nameDesc?.enumerable === true && typeof nameDesc.value === "string" ? nameDesc.value : void 0;
-	const explicitTags = tagsDesc?.enumerable === true ? tagsDesc.value : void 0;
-	if (explicitName !== void 0 && explicitTags !== void 0) return {
-		...base,
-		name: explicitName,
-		tags: explicitTags
-	};
-	if (explicitName !== void 0) return {
-		...base,
-		name: explicitName
-	};
-	if (explicitTags !== void 0) return {
-		...base,
-		tags: explicitTags
-	};
-	return base;
-}
-function withOptions(base, options) {
-	if (options?.name !== void 0 && options.tags !== void 0) return {
-		...base,
-		name: options.name,
-		tags: options.tags
-	};
-	if (options?.name !== void 0) return {
-		...base,
-		name: options.name
-	};
-	if (options?.tags !== void 0) return {
-		...base,
-		tags: options.tags
-	};
-	return base;
-}
-function buildInjectionDescriptor(token, options) {
-	return withOptions({
-		token,
-		optional: false,
-		multi: false
-	}, options);
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function inject(token, options) {
-	const descriptor = buildInjectionDescriptor(token, options);
-	const decoratorFn = (_target, context) => {
-		if (context.static) throw new InternalError("@inject() on static accessors is not supported; only instance accessors participate in runWithContainer-based property injection.");
-		const meta = context.metadata;
-		if (!Array.isArray(meta[INJECT_ACCESSOR_KEY])) meta[INJECT_ACCESSOR_KEY] = [];
-		meta[INJECT_ACCESSOR_KEY].push({
-			key: context.name,
-			descriptor
-		});
-		context.addInitializer(function() {
-			const container = getActiveContainer();
-			if (container === void 0) throw new MissingContainerContextError(String(context.name));
-			const resolveOptions = options === void 0 ? void 0 : injectionSlotToResolveOptions({
-				...options.name !== void 0 ? { name: options.name } : {},
-				...options.tags !== void 0 ? { tags: options.tags } : {}
-			});
-			const value = descriptor.optional ? container.resolveOptional(token, resolveOptions) : container.resolve(token, resolveOptions);
-			context.access.set(this, value);
-		});
-		return {};
-	};
-	const props = {};
-	for (const key of Object.keys(descriptor)) props[key] = {
-		value: descriptor[key],
-		writable: true,
-		enumerable: true,
-		configurable: true
-	};
-	Object.defineProperties(decoratorFn, props);
-	return decoratorFn;
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function optional(token, options) {
-	return withOptions({
-		token,
-		optional: true,
-		multi: false
-	}, options);
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function injectAll(token, options) {
-	return withOptions({
-		token,
-		optional: false,
-		multi: true
-	}, options);
-}
-//#endregion
-export { inject, injectAll, isInjectionDescriptor, normalizeToDescriptor, optional };

package/dist/decorators/injectable.d.mts

@@ -1,32 +0,0 @@
-import { Constructor } from "../constructor-type.mjs";
-import { BindingScope } from "../types.mjs";
-import { InjectableDependency } from "./inject.mjs";
-
-//#region src/decorators/injectable.d.ts
-/**
- * @since 0.3.16-canary.0
- */
-interface AutoRegisterRegistry {
-  register(target: Constructor, scope: BindingScope): void;
-  entries(): ReadonlyArray<{
-    target: Constructor;
-    scope: BindingScope;
-  }>;
-}
-/**
- * @since 0.3.16-canary.0
- */
-declare function createAutoRegisterRegistry(): AutoRegisterRegistry;
-/**
- * @since 0.3.16-canary.0
- */
-interface InjectableOptions {
-  autoRegister?: AutoRegisterRegistry;
-  scope?: BindingScope;
-}
-/**
- * @since 0.3.16-canary.0
- */
-declare function injectable(deps?: ReadonlyArray<InjectableDependency>, options?: InjectableOptions): (target: unknown, context: ClassDecoratorContext) => void;
-//#endregion
-export { AutoRegisterRegistry, type InjectableDependency, InjectableOptions, createAutoRegisterRegistry, injectable };

package/dist/decorators/injectable.mjs

@@ -1,57 +0,0 @@
-import { INJECTABLE_KEY } from "../metadata/metadata-keys.mjs";
-import { normalizeToDescriptor } from "./inject.mjs";
-//#region src/decorators/injectable.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function createAutoRegisterRegistry() {
-	const _registeredEntries = [];
-	return {
-		register(target, scope) {
-			_registeredEntries.push({
-				target,
-				scope
-			});
-		},
-		entries() {
-			return _registeredEntries;
-		}
-	};
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function injectable(deps, options) {
-	return function(target, context) {
-		const parameterMetadataList = (deps ?? []).map((dependency, index) => {
-			const descriptor = normalizeToDescriptor(dependency);
-			const baseParameterMetadata = {
-				index,
-				token: descriptor.token,
-				optional: descriptor.optional,
-				multi: descriptor.multi
-			};
-			if (descriptor.name !== void 0 && descriptor.tags !== void 0) return {
-				...baseParameterMetadata,
-				name: descriptor.name,
-				tags: descriptor.tags
-			};
-			if (descriptor.name !== void 0) return {
-				...baseParameterMetadata,
-				name: descriptor.name
-			};
-			if (descriptor.tags !== void 0) return {
-				...baseParameterMetadata,
-				tags: descriptor.tags
-			};
-			return baseParameterMetadata;
-		});
-		context.metadata[INJECTABLE_KEY] = { params: parameterMetadataList };
-		if (options?.autoRegister !== void 0) {
-			const scope = options.scope ?? "transient";
-			options.autoRegister.register(target, scope);
-		}
-	};
-}
-//#endregion
-export { createAutoRegisterRegistry, injectable };

package/dist/decorators/lifecycle-decorators.d.mts

@@ -1,11 +0,0 @@
-//#region src/decorators/lifecycle-decorators.d.ts
-/**
- * @since 0.3.16-canary.0
- */
-declare function postConstruct(): (target: unknown, context: ClassMethodDecoratorContext) => void;
-/**
- * @since 0.3.16-canary.0
- */
-declare function preDestroy(): (target: unknown, context: ClassMethodDecoratorContext) => void;
-//#endregion
-export { postConstruct, preDestroy };

package/dist/decorators/lifecycle-decorators.mjs

@@ -1,38 +0,0 @@
-import { InternalError } from "../errors.mjs";
-import { LIFECYCLE_KEY } from "../metadata/metadata-keys.mjs";
-//#region src/decorators/lifecycle-decorators.ts
-function appendUniqueMethod(metadata, phase, methodName) {
-	if (!metadata[phase].includes(methodName)) metadata[phase].push(methodName);
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function postConstruct() {
-	return function(target, context) {
-		if (context.static) throw new InternalError("@postConstruct() applies to instance methods only; static methods are not invoked during instance lifecycle.");
-		const methodName = String(context.name);
-		const meta = context.metadata;
-		if (!meta[LIFECYCLE_KEY]) meta[LIFECYCLE_KEY] = {
-			postConstruct: [],
-			preDestroy: []
-		};
-		appendUniqueMethod(meta[LIFECYCLE_KEY], "postConstruct", methodName);
-	};
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function preDestroy() {
-	return function(target, context) {
-		if (context.static) throw new InternalError("@preDestroy() applies to instance methods only; static methods are not invoked during instance teardown.");
-		const methodName = String(context.name);
-		const meta = context.metadata;
-		if (!meta[LIFECYCLE_KEY]) meta[LIFECYCLE_KEY] = {
-			postConstruct: [],
-			preDestroy: []
-		};
-		appendUniqueMethod(meta[LIFECYCLE_KEY], "preDestroy", methodName);
-	};
-}
-//#endregion
-export { postConstruct, preDestroy };

package/dist/dependency-graph.d.mts

@@ -1,43 +0,0 @@
-import { BindingScope } from "./types.mjs";
-import { MetadataReader } from "./metadata/metadata-types.mjs";
-import { BindingRegistry } from "./registry.mjs";
-
-//#region src/dependency-graph.d.ts
-/**
- * @since 0.3.16-canary.0
- */
-interface GraphNode {
-  readonly id: string;
-  readonly tokenName: string;
-  readonly kind: string;
-  readonly scope: BindingScope;
-  readonly fromParent: boolean;
-}
-/**
- * @since 0.3.16-canary.0
- */
-interface GraphEdge {
-  readonly from: string;
-  readonly to: string;
-  readonly label?: string;
-}
-/**
- * @since 0.3.16-canary.0
- */
-interface ContainerGraphJson {
-  readonly nodes: ReadonlyArray<GraphNode>;
-  readonly edges: ReadonlyArray<GraphEdge>;
-  readonly includesParent: boolean;
-}
-/**
- * @since 0.3.16-canary.0
- */
-interface GraphOptions {
-  readonly includeParent?: boolean;
-}
-/**
- * @since 0.3.16-canary.0
- */
-declare function buildDependencyGraph(registry: BindingRegistry, metadataReader: MetadataReader, options: GraphOptions | undefined, parentRegistry?: BindingRegistry): ContainerGraphJson;
-//#endregion
-export { ContainerGraphJson, GraphEdge, GraphNode, GraphOptions, buildDependencyGraph };

package/dist/dependency-graph.mjs

@@ -1,63 +0,0 @@
-import { effectiveBindingScope } from "./binding-scope.mjs";
-import { tokenName } from "./token.mjs";
-//#region src/dependency-graph.ts
-/**
-* @since 0.3.16-canary.0
-*/
-function buildDependencyGraph(registry, metadataReader, options, parentRegistry) {
-	const nodes = [];
-	const edges = [];
-	const includesParent = options?.includeParent === true;
-	const addBindings = (sourceRegistry, fromParent) => {
-		for (const binding of sourceRegistry.allBindings()) {
-			const scope = effectiveBindingScope(binding);
-			nodes.push({
-				id: binding.id,
-				tokenName: tokenName(binding.token),
-				kind: binding.kind,
-				scope,
-				fromParent
-			});
-			if (binding.kind === "class") {
-				const meta = metadataReader.getConstructorMetadata(binding.target);
-				if (meta !== void 0) for (let index = 0; index < meta.params.length; index += 1) {
-					const param = meta.params[index];
-					const dependencyBinding = sourceRegistry.getAll(param.token)[0];
-					if (dependencyBinding !== void 0) edges.push({
-						from: binding.id,
-						to: dependencyBinding.id,
-						label: `[${index}]`
-					});
-				}
-			} else if (binding.kind === "resolved" || binding.kind === "resolved-async") for (let index = 0; index < binding.deps.length; index += 1) {
-				const dependency = binding.deps[index];
-				const dependencyBindings = sourceRegistry.getAll(dependency.token);
-				if (dependencyBindings.length > 0 && dependencyBindings[0] !== void 0) {
-					const label = dependency.name !== void 0 ? `name:${dependency.name}` : dependency.tags !== void 0 && dependency.tags.length > 0 ? `tag:${dependency.tags[0]?.[0]}=${String(dependency.tags[0]?.[1])}` : `[${index}]`;
-					edges.push({
-						from: binding.id,
-						to: dependencyBindings[0].id,
-						label
-					});
-				}
-			}
-			else if (binding.kind === "alias") {
-				const targetBindings = sourceRegistry.getAll(binding.target);
-				if (targetBindings.length > 0 && targetBindings[0] !== void 0) edges.push({
-					from: binding.id,
-					to: targetBindings[0].id,
-					label: "alias"
-				});
-			}
-		}
-	};
-	addBindings(registry, false);
-	if (includesParent && parentRegistry !== void 0) addBindings(parentRegistry, true);
-	return {
-		nodes,
-		edges,
-		includesParent
-	};
-}
-//#endregion
-export { buildDependencyGraph };

package/dist/environment.d.mts

@@ -1,55 +0,0 @@
-import { Constructor } from "./constructor-type.mjs";
-import { Token } from "./token.mjs";
-import { BindingIdentifier, BindingKind, BindingScope, ConstraintContext, ResolutionContext, ResolutionFrame, ResolveOptions } from "./types.mjs";
-import { Container } from "./container.mjs";
-
-//#region src/environment.d.ts
-/**
- * @since 0.3.16-canary.0
- */
-declare function runWithContainer<Result>(container: Container, fn: () => Result): Result;
-/**
- * @since 0.3.16-canary.0
- */
-declare function getActiveContainer(): Container | undefined;
-/**
- * @since 0.3.16-canary.0
- */
-interface ResolverCallbacks {
-  resolveFromContext<const Value>(token: Token<Value> | Constructor<Value>, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>): Value;
-  resolve<const Value>(token: Token<Value> | Constructor<Value>, options: ResolveOptions | undefined, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>): Value;
-  resolveAsyncFromContext<const Value>(token: Token<Value> | Constructor<Value>, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>): Promise<Value>;
-  resolveAsync<const Value>(token: Token<Value> | Constructor<Value>, options: ResolveOptions | undefined, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>): Promise<Value>;
-  resolveOptional<const Value>(token: Token<Value> | Constructor<Value>, options: ResolveOptions | undefined, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>): Value | undefined;
-  resolveOptionalAsync<const Value>(token: Token<Value> | Constructor<Value>, options: ResolveOptions | undefined, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>): Promise<Value | undefined>;
-  resolveAll<const Value>(token: Token<Value> | Constructor<Value>, options: ResolveOptions | undefined, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>): Array<Value>;
-  resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, options: ResolveOptions | undefined, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>): Promise<Array<Value>>;
-}
-/**
- * @since 0.3.16-canary.0
- */
-declare class DefaultResolutionContext implements ResolutionContext {
-  private _resolver;
-  private _resolutionPath;
-  private _resolutionStack;
-  private _currentOptions;
-  constructor(resolver: ResolverCallbacks, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>, currentOptions: ResolveOptions | undefined);
-  private _graph;
-  get graph(): ConstraintContext;
-  reset(resolver: ResolverCallbacks, resolutionPath: Array<string>, resolutionStack: Array<ResolutionFrame>, currentOptions: ResolveOptions | undefined): void;
-  resolve<const Value>(token: Token<Value> | Constructor<Value>, options?: ResolveOptions): Value;
-  resolveAsync<const Value>(token: Token<Value> | Constructor<Value>, options?: ResolveOptions): Promise<Value>;
-  resolveOptional<const Value>(token: Token<Value> | Constructor<Value>, options?: ResolveOptions): Value | undefined;
-  resolveOptionalAsync<const Value>(token: Token<Value> | Constructor<Value>, options?: ResolveOptions): Promise<Value | undefined>;
-  resolveAll<const Value>(token: Token<Value> | Constructor<Value>, options?: ResolveOptions): Array<Value>;
-  resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, options?: ResolveOptions): Promise<Array<Value>>;
-}
-/**
- * @since 0.3.16-canary.0
- */
-declare function buildResolutionFrame(tokenName: string, scope: BindingScope, bindingId: BindingIdentifier, kind: BindingKind, slot: {
-  name: string | undefined;
-  tags: ReadonlyArray<readonly [string, unknown]>;
-}): ResolutionFrame;
-//#endregion
-export { DefaultResolutionContext, ResolverCallbacks, buildResolutionFrame, getActiveContainer, runWithContainer };

package/dist/environment.mjs

@@ -1,98 +0,0 @@
-//#region src/environment.ts
-let _activeContainer;
-/**
-* @since 0.3.16-canary.0
-*/
-function runWithContainer(container, fn) {
-	const prev = _activeContainer;
-	_activeContainer = container;
-	try {
-		return fn();
-	} finally {
-		_activeContainer = prev;
-	}
-}
-/**
-* @since 0.3.16-canary.0
-*/
-function getActiveContainer() {
-	return _activeContainer;
-}
-/**
-* @since 0.3.16-canary.0
-*/
-var DefaultResolutionContext = class {
-	_resolver;
-	_resolutionPath;
-	_resolutionStack;
-	_currentOptions;
-	constructor(resolver, resolutionPath, resolutionStack, currentOptions) {
-		this._resolver = resolver;
-		this._resolutionPath = resolutionPath;
-		this._resolutionStack = resolutionStack;
-		this._currentOptions = currentOptions;
-	}
-	_graph;
-	get graph() {
-		if (this._graph === void 0) this._graph = new DefaultConstraintContext(this._resolutionPath, this._resolutionStack, this._currentOptions);
-		return this._graph;
-	}
-	reset(resolver, resolutionPath, resolutionStack, currentOptions) {
-		this._resolver = resolver;
-		this._resolutionPath = resolutionPath;
-		this._resolutionStack = resolutionStack;
-		this._currentOptions = currentOptions;
-		this._graph = void 0;
-	}
-	resolve(token, options) {
-		if (options === void 0) return this._resolver.resolveFromContext(token, this._resolutionPath, this._resolutionStack);
-		return this._resolver.resolve(token, options, this._resolutionPath, this._resolutionStack);
-	}
-	resolveAsync(token, options) {
-		if (options === void 0) return this._resolver.resolveAsyncFromContext(token, this._resolutionPath, this._resolutionStack);
-		return this._resolver.resolveAsync(token, options, this._resolutionPath, this._resolutionStack);
-	}
-	resolveOptional(token, options) {
-		return this._resolver.resolveOptional(token, options, this._resolutionPath, this._resolutionStack);
-	}
-	resolveOptionalAsync(token, options) {
-		return this._resolver.resolveOptionalAsync(token, options, this._resolutionPath, this._resolutionStack);
-	}
-	resolveAll(token, options) {
-		return this._resolver.resolveAll(token, options, this._resolutionPath, this._resolutionStack);
-	}
-	resolveAllAsync(token, options) {
-		return this._resolver.resolveAllAsync(token, options, this._resolutionPath, this._resolutionStack);
-	}
-};
-var DefaultConstraintContext = class {
-	resolutionPath;
-	resolutionStack;
-	parent;
-	currentResolveOptions;
-	constructor(resolutionPath, resolutionStack, currentResolveOptions) {
-		this.resolutionPath = resolutionPath;
-		this.resolutionStack = resolutionStack;
-		this.parent = resolutionStack.at(-1);
-		this.currentResolveOptions = currentResolveOptions;
-	}
-	_ancestors;
-	get ancestors() {
-		if (this._ancestors === void 0) this._ancestors = this.resolutionStack.length > 1 ? this.resolutionStack.slice(0, -1) : [];
-		return this._ancestors;
-	}
-};
-/**
-* @since 0.3.16-canary.0
-*/
-function buildResolutionFrame(tokenName, scope, bindingId, kind, slot) {
-	return {
-		tokenName,
-		scope,
-		bindingId,
-		kind,
-		slot
-	};
-}
-//#endregion
-export { DefaultResolutionContext, buildResolutionFrame, getActiveContainer, runWithContainer };