@navios/di 0.8.0 → 0.9.0

package/lib/browser/container/scoped-container.mjs

@@ -0,0 +1,119 @@
+import { InjectableScope } from "../enums/injectable-scope.enum.mjs";
+import { UnifiedStorage } from "../internal/holder/unified-storage.mjs";
+import { AbstractContainer } from "./abstract-container.mjs";
+
+//#region src/container/scoped-container.mts
+/**
+* Request-scoped dependency injection container.
+*
+* Wraps a parent Container and provides isolated request-scoped instances
+* while delegating singleton and transient resolution to the parent.
+* This design eliminates race conditions that can occur with async operations
+* when multiple requests are processed concurrently.
+*/ var ScopedContainer = class extends AbstractContainer {
+	parent;
+	registry;
+	requestId;
+	defaultScope = InjectableScope.Request;
+	storage;
+	disposed = false;
+	metadata;
+	constructor(parent, registry, requestId, metadata) {
+		super(), this.parent = parent, this.registry = registry, this.requestId = requestId;
+		this.storage = new UnifiedStorage(InjectableScope.Request);
+		this.metadata = metadata || {};
+	}
+	getStorage() {
+		return this.storage;
+	}
+	getRegistry() {
+		return this.registry;
+	}
+	getTokenResolver() {
+		return this.parent.getTokenResolver();
+	}
+	getNameResolver() {
+		return this.parent.getNameResolver();
+	}
+	getServiceInvalidator() {
+		return this.parent.getServiceInvalidator();
+	}
+	/**
+	* Gets the request ID for this scoped container.
+	*/ getRequestId() {
+		return this.requestId;
+	}
+	/**
+	* Gets the parent container.
+	*/ getParent() {
+		return this.parent;
+	}
+	/**
+	* Gets metadata from the request context.
+	*/ getMetadata(key) {
+		return this.metadata[key];
+	}
+	/**
+	* Sets metadata on the request context.
+	*/ setMetadata(key, value) {
+		this.metadata[key] = value;
+	}
+	async get(token, args) {
+		if (this.disposed) throw new Error("ScopedContainer has been disposed");
+		const realToken = this.getTokenResolver().getRegistryToken(token);
+		if (this.registry.has(realToken)) {
+			if (this.registry.get(realToken).scope === InjectableScope.Request) {
+				const [error$1, instance$1] = await this.parent.getInstanceResolver().resolveRequestScopedInstance(token, args, this);
+				if (error$1) throw error$1;
+				return instance$1;
+			}
+		}
+		const [error, instance] = await this.parent.getInstanceResolver().resolveInstance(token, args, this, this.storage, this.requestId);
+		if (error) throw error;
+		return instance;
+	}
+	/**
+	* Invalidates a service and its dependencies.
+	*/ async invalidate(service) {
+		const holder = this.storage.findByInstance(service);
+		if (!holder) return this.parent.invalidate(service);
+		await this.getServiceInvalidator().invalidateWithStorage(holder.name, this.storage);
+	}
+	/**
+	* Disposes the container and cleans up all resources.
+	* Alias for endRequest().
+	*/ async dispose() {
+		return this.endRequest();
+	}
+	/**
+	* @internal
+	* Attempts to get an instance synchronously if it already exists.
+	* Checks request storage first, then delegates to parent.
+	*/ tryGetSync(token, args) {
+		const realToken = this.getTokenResolver().getRegistryToken(token);
+		if ((this.registry.has(realToken) ? this.registry.get(realToken).scope : InjectableScope.Singleton) === InjectableScope.Request) {
+			const result = this.tryGetSyncFromStorage(token, args, this.storage, this.requestId);
+			if (result !== null) return result;
+		}
+		return this.parent.tryGetSync(token, args, this.requestId);
+	}
+	/**
+	* Adds an instance to the container.
+	* Overrides base class to check disposed state.
+	*/ addInstance(token, instance) {
+		if (this.disposed) throw new Error("ScopedContainer has been disposed");
+		super.addInstance(token, instance);
+	}
+	/**
+	* Ends the request and cleans up all request-scoped services.
+	*/ async endRequest() {
+		if (this.disposed) return;
+		this.disposed = true;
+		await this.getServiceInvalidator().clearAllWithStorage(this.storage);
+		this.parent.removeRequestId(this.requestId);
+	}
+};
+
+//#endregion
+export { ScopedContainer };
+//# sourceMappingURL=scoped-container.mjs.map

package/lib/browser/container/scoped-container.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-container.mjs","names":["InjectableScope","UnifiedStorage","AbstractContainer","ScopedContainer","defaultScope","Request","storage","disposed","metadata","parent","registry","requestId","getStorage","getRegistry","getTokenResolver","getNameResolver","getServiceInvalidator","getRequestId","getParent","getMetadata","key","setMetadata","value","get","token","args","Error","tokenResolver","realToken","getRegistryToken","has","record","scope","error","instance","getInstanceResolver","resolveRequestScopedInstance","resolveInstance","invalidate","service","holder","findByInstance","invalidateWithStorage","name","dispose","endRequest","tryGetSync","Singleton","result","tryGetSyncFromStorage","addInstance","clearAllWithStorage","removeRequestId"],"sources":["../../../src/container/scoped-container.mts"],"sourcesContent":["import type { z, ZodType } from 'zod/v4'\n\nimport type { Factorable } from '../interfaces/factory.interface.mjs'\nimport type {\n  ClassType,\n  ClassTypeWithArgument,\n  FactoryInjectionToken,\n  InjectionTokenSchemaType,\n} from '../token/injection-token.mjs'\nimport type { Registry } from '../token/registry.mjs'\nimport type { Join, UnionToArray } from '../utils/types.mjs'\nimport type { NameResolver } from '../internal/core/name-resolver.mjs'\nimport type { ServiceInvalidator } from '../internal/core/service-invalidator.mjs'\nimport type { TokenResolver } from '../internal/core/token-resolver.mjs'\n\nimport { InjectableScope } from '../enums/index.mjs'\nimport { UnifiedStorage } from '../internal/holder/unified-storage.mjs'\nimport {\n  BoundInjectionToken,\n  InjectionToken,\n} from '../token/injection-token.mjs'\nimport { AbstractContainer } from './abstract-container.mjs'\nimport { Container } from './container.mjs'\n\n/**\n * Request-scoped dependency injection container.\n *\n * Wraps a parent Container and provides isolated request-scoped instances\n * while delegating singleton and transient resolution to the parent.\n * This design eliminates race conditions that can occur with async operations\n * when multiple requests are processed concurrently.\n */\nexport class ScopedContainer extends AbstractContainer {\n  protected readonly defaultScope = InjectableScope.Request\n\n  private readonly storage: UnifiedStorage\n  private disposed = false\n  private readonly metadata: Record<string, any>\n\n  constructor(\n    private readonly parent: Container,\n    private readonly registry: Registry,\n    public readonly requestId: string,\n    metadata?: Record<string, any>,\n  ) {\n    super()\n    // Create own unified storage for request-scoped services\n    this.storage = new UnifiedStorage(InjectableScope.Request)\n    this.metadata = metadata || {}\n  }\n\n  // ============================================================================\n  // ABSTRACT METHOD IMPLEMENTATIONS - Delegate to parent\n  // ============================================================================\n\n  getStorage(): UnifiedStorage {\n    return this.storage\n  }\n\n  protected getRegistry(): Registry {\n    return this.registry\n  }\n\n  protected getTokenResolver(): TokenResolver {\n    return this.parent.getTokenResolver()\n  }\n\n  protected getNameResolver(): NameResolver {\n    return this.parent.getNameResolver()\n  }\n\n  protected getServiceInvalidator(): ServiceInvalidator {\n    return this.parent.getServiceInvalidator()\n  }\n\n  // ============================================================================\n  // SCOPED CONTAINER SPECIFIC METHODS\n  // ============================================================================\n\n  /**\n   * Gets the request ID for this scoped container.\n   */\n  getRequestId(): string {\n    return this.requestId\n  }\n\n  /**\n   * Gets the parent container.\n   */\n  getParent(): Container {\n    return this.parent\n  }\n\n  /**\n   * Gets metadata from the request context.\n   */\n  getMetadata(key: string): any | undefined {\n    return this.metadata[key]\n  }\n\n  /**\n   * Sets metadata on the request context.\n   */\n  setMetadata(key: string, value: any): void {\n    this.metadata[key] = value\n  }\n\n  /**\n   * Gets an instance from the container.\n   * Request-scoped services are resolved from this container's storage.\n   * All other services are delegated to the parent container.\n   */\n  // #1 Simple class\n  get<T extends ClassType>(\n    token: T,\n  ): InstanceType<T> extends Factorable<infer R>\n    ? Promise<R>\n    : Promise<InstanceType<T>>\n  // #1.1 Simple class with args\n  get<T extends ClassTypeWithArgument<R>, R>(\n    token: T,\n    args: R,\n  ): Promise<InstanceType<T>>\n  // #2 Token with required Schema\n  get<T, S extends InjectionTokenSchemaType>(\n    token: InjectionToken<T, S>,\n    args: z.input<S>,\n  ): Promise<T>\n  // #3 Token with optional Schema\n  get<T, S extends InjectionTokenSchemaType, R extends boolean>(\n    token: InjectionToken<T, S, R>,\n  ): R extends false\n    ? Promise<T>\n    : S extends ZodType<infer Type>\n      ? `Error: Your token requires args: ${Join<\n          UnionToArray<keyof Type>,\n          ', '\n        >}`\n      : 'Error: Your token requires args'\n  // #4 Token with no Schema\n  get<T>(token: InjectionToken<T, undefined>): Promise<T>\n  get<T>(token: BoundInjectionToken<T, any>): Promise<T>\n  get<T>(token: FactoryInjectionToken<T, any>): Promise<T>\n\n  async get(\n    token:\n      | ClassType\n      | InjectionToken<any>\n      | BoundInjectionToken<any, any>\n      | FactoryInjectionToken<any, any>,\n    args?: unknown,\n  ) {\n    if (this.disposed) {\n      throw new Error('ScopedContainer has been disposed')\n    }\n\n    // Check if this is a request-scoped service\n    const tokenResolver = this.getTokenResolver()\n    const realToken = tokenResolver.getRegistryToken(token)\n\n    if (this.registry.has(realToken)) {\n      const record = this.registry.get(realToken)\n      if (record.scope === InjectableScope.Request) {\n        // Resolve request-scoped service from this container\n        const [error, instance] = await this.parent\n          .getInstanceResolver()\n          .resolveRequestScopedInstance(token, args, this)\n\n        if (error) {\n          throw error\n        }\n\n        return instance\n      }\n    }\n\n    // Delegate singleton/transient services to parent\n    const [error, instance] = await this.parent\n      .getInstanceResolver()\n      .resolveInstance(token, args, this, this.storage, this.requestId)\n\n    if (error) {\n      throw error\n    }\n\n    return instance\n  }\n\n  /**\n   * Invalidates a service and its dependencies.\n   */\n  async invalidate(service: unknown): Promise<void> {\n    // Find the service by instance in request storage\n    const holder = this.storage.findByInstance(service)\n    if (!holder) {\n      // Try parent storage\n      return this.parent.invalidate(service)\n    }\n\n    await this.getServiceInvalidator().invalidateWithStorage(\n      holder.name,\n      this.storage,\n    )\n  }\n\n  /**\n   * Disposes the container and cleans up all resources.\n   * Alias for endRequest().\n   */\n  async dispose(): Promise<void> {\n    return this.endRequest()\n  }\n\n  /**\n   * @internal\n   * Attempts to get an instance synchronously if it already exists.\n   * Checks request storage first, then delegates to parent.\n   */\n  override tryGetSync<T>(token: any, args?: any): T | null {\n    // Check request storage first for request-scoped services\n    const tokenResolver = this.getTokenResolver()\n    const realToken = tokenResolver.getRegistryToken(token)\n    const scope = this.registry.has(realToken)\n      ? this.registry.get(realToken).scope\n      : InjectableScope.Singleton\n\n    if (scope === InjectableScope.Request) {\n      const result = this.tryGetSyncFromStorage<T>(\n        token,\n        args,\n        this.storage,\n        this.requestId,\n      )\n      if (result !== null) {\n        return result\n      }\n    }\n\n    // Delegate to parent for singleton/transient\n    return this.parent.tryGetSync<T>(token, args, this.requestId)\n  }\n\n  /**\n   * Adds an instance to the container.\n   * Overrides base class to check disposed state.\n   */\n  override addInstance<T>(\n    token: ClassType | InjectionToken<T, any> | BoundInjectionToken<T, any>,\n    instance: T,\n  ): void {\n    if (this.disposed) {\n      throw new Error('ScopedContainer has been disposed')\n    }\n\n    super.addInstance(token, instance)\n  }\n\n  /**\n   * Ends the request and cleans up all request-scoped services.\n   */\n  async endRequest(): Promise<void> {\n    if (this.disposed) {\n      return\n    }\n\n    this.disposed = true\n\n    // Clear all request-scoped services\n    await this.getServiceInvalidator().clearAllWithStorage(this.storage)\n\n    // Remove request ID from parent\n    this.parent.removeRequestId(this.requestId)\n  }\n}\n"],"mappings":";;;;;;;;;;;;GAgCA,IAAaG,kBAAb,cAAqCD,kBAAAA;;;;CAChBE,eAAeJ,gBAAgBK;CAEjCC;CACTC,WAAW;CACFC;CAEjB,YACE,QACA,UACA,WACAA,UACA;AACA,SAAK,EAAA,KALYC,SAAAA,QAAAA,KACAC,WAAAA,UAAAA,KACDC,YAAAA;AAKhB,OAAKL,UAAU,IAAIL,eAAeD,gBAAgBK,QAAO;AACzD,OAAKG,WAAWA,YAAY,EAAC;;CAO/BI,aAA6B;AAC3B,SAAO,KAAKN;;CAGJO,cAAwB;AAChC,SAAO,KAAKH;;CAGJI,mBAAkC;AAC1C,SAAO,KAAKL,OAAOK,kBAAgB;;CAG3BC,kBAAgC;AACxC,SAAO,KAAKN,OAAOM,iBAAe;;CAG1BC,wBAA4C;AACpD,SAAO,KAAKP,OAAOO,uBAAqB;;;;IAU1CC,eAAuB;AACrB,SAAO,KAAKN;;;;IAMdO,YAAuB;AACrB,SAAO,KAAKT;;;;IAMdU,YAAYC,KAA8B;AACxC,SAAO,KAAKZ,SAASY;;;;IAMvBC,YAAYD,KAAaE,OAAkB;AACzC,OAAKd,SAASY,OAAOE;;CAwCvB,MAAMC,IACJC,OAKAC,MACA;AACA,MAAI,KAAKlB,SACP,OAAM,IAAImB,MAAM,oCAAA;EAKlB,MAAME,YADgB,KAAKd,kBAAgB,CACXe,iBAAiBL,MAAAA;AAEjD,MAAI,KAAKd,SAASoB,IAAIF,UAAAA,EAEpB;OADe,KAAKlB,SAASa,IAAIK,UAAAA,CACtBI,UAAUhC,gBAAgBK,SAAS;IAE5C,MAAM,CAAC4B,SAAOC,cAAY,MAAM,KAAKzB,OAClC0B,qBAAmB,CACnBC,6BAA6BZ,OAAOC,MAAM,KAAI;AAEjD,QAAIQ,QACF,OAAMA;AAGR,WAAOC;;;EAKX,MAAM,CAACD,OAAOC,YAAY,MAAM,KAAKzB,OAClC0B,qBAAmB,CACnBE,gBAAgBb,OAAOC,MAAM,MAAM,KAAKnB,SAAS,KAAKK,UAAS;AAElE,MAAIsB,MACF,OAAMA;AAGR,SAAOC;;;;IAMT,MAAMI,WAAWC,SAAiC;EAEhD,MAAMC,SAAS,KAAKlC,QAAQmC,eAAeF,QAAAA;AAC3C,MAAI,CAACC,OAEH,QAAO,KAAK/B,OAAO6B,WAAWC,QAAAA;AAGhC,QAAM,KAAKvB,uBAAqB,CAAG0B,sBACjCF,OAAOG,MACP,KAAKrC,QAAO;;;;;IAQhB,MAAMsC,UAAyB;AAC7B,SAAO,KAAKC,YAAU;;;;;;IAQxB,WAAuBrB,OAAYC,MAAsB;EAGvD,MAAMG,YADgB,KAAKd,kBAAgB,CACXe,iBAAiBL,MAAAA;AAKjD,OAJc,KAAKd,SAASoB,IAAIF,UAAAA,GAC5B,KAAKlB,SAASa,IAAIK,UAAAA,CAAWI,QAC7BhC,gBAAgB+C,eAEN/C,gBAAgBK,SAAS;GACrC,MAAM2C,SAAS,KAAKC,sBAClBzB,OACAC,MACA,KAAKnB,SACL,KAAKK,UAAS;AAEhB,OAAIqC,WAAW,KACb,QAAOA;;AAKX,SAAO,KAAKvC,OAAOqC,WAActB,OAAOC,MAAM,KAAKd,UAAS;;;;;IAO9D,YACEa,OACAU,UACM;AACN,MAAI,KAAK3B,SACP,OAAM,IAAImB,MAAM,oCAAA;AAGlB,QAAMwB,YAAY1B,OAAOU,SAAAA;;;;IAM3B,MAAMW,aAA4B;AAChC,MAAI,KAAKtC,SACP;AAGF,OAAKA,WAAW;AAGhB,QAAM,KAAKS,uBAAqB,CAAGmC,oBAAoB,KAAK7C,QAAO;AAGnE,OAAKG,OAAO2C,gBAAgB,KAAKzC,UAAS"}

package/lib/browser/decorators/factory.decorator.d.mts

@@ -0,0 +1,26 @@
+import { ClassTypeWithInstance, InjectionToken, InjectionTokenSchemaType } from "../token/injection-token.mjs";
+import { InjectableScope } from "../enums/injectable-scope.enum.mjs";
+import { Factorable, FactorableWithArgs } from "../interfaces/factory.interface.mjs";
+import { Registry } from "../token/registry.mjs";
+
+//#region src/decorators/factory.decorator.d.mts
+interface FactoryOptions {
+  scope?: InjectableScope;
+  token?: InjectionToken<any, any>;
+  registry?: Registry;
+  priority?: number;
+}
+declare function Factory<R>(options?: {
+  scope?: InjectableScope;
+  registry?: Registry;
+  priority?: number;
+}): <T extends ClassTypeWithInstance<Factorable<R>>>(target: T, context?: ClassDecoratorContext) => T;
+declare function Factory<R, S>(options: {
+  scope?: InjectableScope;
+  token: InjectionToken<R, S>;
+  registry?: Registry;
+  priority?: number;
+}): R extends undefined ? never : S extends InjectionTokenSchemaType ? <T extends ClassTypeWithInstance<FactorableWithArgs<R, S>>>(target: T, context?: ClassDecoratorContext) => T : S extends undefined ? <T extends ClassTypeWithInstance<Factorable<R>>>(target: T, context?: ClassDecoratorContext) => T : never;
+//#endregion
+export { Factory, FactoryOptions };
+//# sourceMappingURL=factory.decorator.d.mts.map

package/lib/browser/decorators/factory.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.decorator.d.mts","names":[],"sources":["../../../src/decorators/factory.decorator.mts"],"sourcesContent":[],"mappings":";;;;;;UAYiB,cAAA;EAAA,KAAA,CAAA,EACP,eADqB;EACrB,KAAA,CAAA,EACA,cADA,CAAA,GAAA,EAAA,GAAA,CAAA;EACA,QAAA,CAAA,EACG,QADH;EACG,QAAA,CAAA,EAAA,MAAA;;AAKG,iBAAA,OAAO,CAAA,CAAA,CAAA,CAAA,OAIc,CAJd,EAAA;EACb,KAAA,CAAA,EAAA,eAAA;EACG,QAAA,CAAA,EAAA,QAAA;EAEmC,QAAA,CAAA,EAAA,MAAA;CAAX,CAAA,EAAA,CAAA,UAAtB,qBAAsB,CAAA,UAAA,CAAW,CAAX,CAAA,CAAA,CAAA,CAAA,MAAA,EAC3B,CAD2B,EAAA,OAAA,CAAA,EAEzB,qBAFyB,EAAA,GAGhC,CAHgC;AAAtB,iBAMC,OAND,CAAA,CAAA,EAAA,CAAA,CAAA,CAAA,OAAA,EAAA;EACL,KAAA,CAAA,EAMA,eANA;EACE,KAAA,EAMH,cANG,CAMY,CANZ,EAMe,CANf,CAAA;EACP,QAAA,CAAA,EAMQ,QANR;EAAC,QAAA,CAAA,EAAA,MAAA;AAGN,CAAA,CAAA,EAKI,CALY,SAAO,SAAA,GAAA,KAAA,GAOnB,CAPmB,SAOT,wBAPS,GAAA,CAAA,UAQN,qBARM,CAQgB,kBARhB,CAQmC,CARnC,EAQsC,CARtC,CAAA,CAAA,CAAA,CAAA,MAAA,EASP,CATO,EAAA,OAAA,CAAA,EAUL,qBAVK,EAAA,GAWZ,CAXY,GAYjB,CAZiB,SAAA,SAAA,GAAA,CAAA,UAaJ,qBAbI,CAakB,UAblB,CAa6B,CAb7B,CAAA,CAAA,CAAA,CAAA,MAAA,EAcL,CAdK,EAAA,OAAA,CAAA,EAeH,qBAfG,EAAA,GAgBV,CAhBU,GAAA,KAAA"}

package/lib/browser/decorators/factory.decorator.mjs

@@ -0,0 +1,20 @@
+import { InjectableScope } from "../enums/injectable-scope.enum.mjs";
+import { InjectableType } from "../enums/injectable-type.enum.mjs";
+import { InjectableTokenMeta } from "../symbols/injectable-token.mjs";
+import { InjectionToken } from "../token/injection-token.mjs";
+import { globalRegistry } from "../token/registry.mjs";
+
+//#region src/decorators/factory.decorator.mts
+function Factory({ scope = InjectableScope.Singleton, token, registry = globalRegistry, priority = 0 } = {}) {
+	return (target, context) => {
+		if (context && context.kind !== "class" || target instanceof Function && !context) throw new Error("[DI] @Factory decorator can only be used on classes.");
+		let injectableToken = token ?? InjectionToken.create(target);
+		registry.set(injectableToken, scope, target, InjectableType.Factory, priority);
+		target[InjectableTokenMeta] = injectableToken;
+		return target;
+	};
+}
+
+//#endregion
+export { Factory };
+//# sourceMappingURL=factory.decorator.mjs.map

package/lib/browser/decorators/factory.decorator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.decorator.mjs","names":["InjectableScope","InjectableType","InjectableTokenMeta","InjectionToken","globalRegistry","Factory","scope","Singleton","token","registry","priority","target","context","kind","Function","Error","injectableToken","create","set"],"sources":["../../../src/decorators/factory.decorator.mts"],"sourcesContent":["import type { Factorable, FactorableWithArgs } from '../interfaces/index.mjs'\nimport type {\n  ClassTypeWithInstance,\n  InjectionTokenSchemaType,\n} from '../token/injection-token.mjs'\nimport type { Registry } from '../token/registry.mjs'\n\nimport { InjectableScope, InjectableType } from '../enums/index.mjs'\nimport { InjectableTokenMeta } from '../symbols/index.mjs'\nimport { InjectionToken } from '../token/injection-token.mjs'\nimport { globalRegistry } from '../token/registry.mjs'\n\nexport interface FactoryOptions {\n  scope?: InjectableScope\n  token?: InjectionToken<any, any>\n  registry?: Registry\n  priority?: number\n}\n\n// #1 Factory without arguments\nexport function Factory<R>(options?: {\n  scope?: InjectableScope\n  registry?: Registry\n  priority?: number\n}): <T extends ClassTypeWithInstance<Factorable<R>>>(\n  target: T,\n  context?: ClassDecoratorContext,\n) => T\n\n// #2 Factory with typed token\nexport function Factory<R, S>(options: {\n  scope?: InjectableScope\n  token: InjectionToken<R, S>\n  registry?: Registry\n  priority?: number\n}): R extends undefined\n  ? never\n  : S extends InjectionTokenSchemaType\n    ? <T extends ClassTypeWithInstance<FactorableWithArgs<R, S>>>(\n        target: T,\n        context?: ClassDecoratorContext,\n      ) => T\n    : S extends undefined\n      ? <T extends ClassTypeWithInstance<Factorable<R>>>(\n          target: T,\n          context?: ClassDecoratorContext,\n        ) => T\n      : never\n\nexport function Factory({\n  scope = InjectableScope.Singleton,\n  token,\n  registry = globalRegistry,\n  priority = 0,\n}: FactoryOptions = {}) {\n  return <\n    T extends ClassTypeWithInstance<\n      Factorable<any> | FactorableWithArgs<any, any>\n    >,\n  >(\n    target: T,\n    context?: ClassDecoratorContext,\n  ): T => {\n    if (\n      (context && context.kind !== 'class') ||\n      (target instanceof Function && !context)\n    ) {\n      throw new Error(\n        '[DI] @Factory decorator can only be used on classes.',\n      )\n    }\n\n    let injectableToken: InjectionToken<any, any> =\n      token ?? InjectionToken.create(target)\n\n    registry.set(injectableToken, scope, target, InjectableType.Factory, priority)\n\n    // @ts-expect-error\n    target[InjectableTokenMeta] = injectableToken\n\n    return target\n  }\n}\n\n"],"mappings":";;;;;;;AAiDA,SAAgBK,QAAQ,EACtBC,QAAQN,gBAAgBO,WACxBC,OACAC,WAAWL,gBACXM,WAAW,MACO,EAAE,EAAA;AACpB,SAKEC,QACAC,YAAAA;AAEA,MACE,WAAYA,QAAQC,SAAS,WAC5BF,kBAAkBG,YAAY,CAACF,QAEhC,OAAM,IAAIG,MACR,uDAAA;EAIJ,IAAIC,kBACFR,SAASL,eAAec,OAAON,OAAAA;AAEjCF,WAASS,IAAIF,iBAAiBV,OAAOK,QAAQV,eAAeI,SAASK,SAAAA;AAGrEC,SAAOT,uBAAuBc;AAE9B,SAAOL"}

package/lib/browser/decorators/injectable.decorator.d.mts

@@ -0,0 +1,38 @@
+import { BaseInjectionTokenSchemaType, ClassTypeWithArgument, ClassTypeWithInstance, ClassTypeWithInstanceAndArgument, ClassTypeWithInstanceAndOptionalArgument, ClassTypeWithOptionalArgument, ClassTypeWithoutArguments, InjectionToken, InjectionTokenSchemaType, OptionalInjectionTokenSchemaType } from "../token/injection-token.mjs";
+import { InjectableScope } from "../enums/injectable-scope.enum.mjs";
+import { Registry } from "../token/registry.mjs";
+import { z } from "zod/v4";
+
+//#region src/decorators/injectable.decorator.d.mts
+interface InjectableOptions {
+  scope?: InjectableScope;
+  token?: InjectionToken<any, any>;
+  schema?: InjectionTokenSchemaType;
+  registry?: Registry;
+  priority?: number;
+}
+declare function Injectable(): <T extends ClassTypeWithoutArguments>(target: T, context?: ClassDecoratorContext) => T;
+declare function Injectable(options: {
+  scope?: InjectableScope;
+  registry: Registry;
+  priority?: number;
+}): <T extends ClassTypeWithoutArguments>(target: T, context?: ClassDecoratorContext) => T;
+declare function Injectable(options: {
+  scope: InjectableScope;
+  priority?: number;
+}): <T extends ClassTypeWithoutArguments>(target: T, context?: ClassDecoratorContext) => T;
+declare function Injectable<Schema extends InjectionTokenSchemaType>(options: {
+  scope?: InjectableScope;
+  schema: Schema;
+  registry?: Registry;
+  priority?: number;
+}): <T extends ClassTypeWithArgument<z.output<Schema>>>(target: T, context?: ClassDecoratorContext) => T;
+declare function Injectable<Type, Schema>(options: {
+  scope?: InjectableScope;
+  token: InjectionToken<Type, Schema>;
+  registry?: Registry;
+  priority?: number;
+}): Schema extends BaseInjectionTokenSchemaType ? Type extends undefined ? <T extends ClassTypeWithArgument<z.output<Schema>>>(target: T, context?: ClassDecoratorContext) => T : <T extends ClassTypeWithInstanceAndArgument<Type, z.output<Schema>>>(target: T, context?: ClassDecoratorContext) => T : Schema extends OptionalInjectionTokenSchemaType ? Type extends undefined ? <T extends ClassTypeWithOptionalArgument<z.output<Schema>>>(target: T, context?: ClassDecoratorContext) => T : <T extends ClassTypeWithInstanceAndOptionalArgument<Type, z.output<Schema>>>(target: T, context?: ClassDecoratorContext) => T : Schema extends undefined ? <R extends ClassTypeWithInstance<Type>>(target: R, context?: ClassDecoratorContext) => R : never;
+//#endregion
+export { Injectable, InjectableOptions };
+//# sourceMappingURL=injectable.decorator.d.mts.map

package/lib/browser/decorators/injectable.decorator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable.decorator.d.mts","names":[],"sources":["../../../src/decorators/injectable.decorator.mts"],"sourcesContent":[],"mappings":";;;;;;UAqBiB,iBAAA;EAAA,KAAA,CAAA,EACP,eADwB;EACxB,KAAA,CAAA,EACA,cADA,CAAA,GAAA,EAAA,GAAA,CAAA;EACA,MAAA,CAAA,EACC,wBADD;EACC,QAAA,CAAA,EACE,QADF;EACE,QAAA,CAAA,EAAA,MAAA;;AAKG,iBAAA,UAAA,CAAA,CAAU,EAAA,CAAA,UAAe,yBAAf,CAAA,CAAA,MAAA,EAChB,CADgB,EAAA,OAAA,CAAA,EAEd,qBAFc,EAAA,GAGrB,CAHqB;AAAe,iBAIzB,UAAA,CAJyB,OAAA,EAAA;EAC/B,KAAA,CAAA,EAIA,eAJA;EACE,QAAA,EAIA,QAJA;EACP,QAAA,CAAA,EAAA,MAAA;CAAC,CAAA,EAAA,CAAA,UAKS,yBALT,CAAA,CAAA,MAAA,EAMI,CANJ,EAAA,OAAA,CAAA,EAOM,qBAPN,EAAA,GAQD,CARC;AACU,iBAQA,UAAA,CARU,OAAA,EAAA;EAChB,KAAA,EAQD,eARC;EACE,QAAA,CAAA,EAAA,MAAA;CAEG,CAAA,EAAA,CAAA,UAOA,yBAPA,CAAA,CAAA,MAAA,EAQL,CARK,EAAA,OAAA,CAAA,EASH,qBATG,EAAA,GAUV,CAVU;AACL,iBAWM,UAXN,CAAA,eAWgC,wBAXhC,CAAA,CAAA,OAAA,EAAA;EACE,KAAA,CAAA,EAWF,eAXE;EACP,MAAA,EAWK,MAXL;EAAC,QAAA,CAAA,EAYO,QAZP;EACU,QAAA,CAAA,EAAA,MAAU;CACjB,CAAA,EAAA,CAAA,UAYM,qBAZN,CAY4B,CAAA,CAAE,MAZ9B,CAYqC,MAZrC,CAAA,CAAA,CAAA,CAAA,MAAA,EAaC,CAbD,EAAA,OAAA,CAAA,EAcG,qBAdH,EAAA,GAeJ,CAfI;AAEM,iBAgBC,UAhBD,CAAA,IAAA,EAAA,MAAA,CAAA,CAAA,OAAA,EAAA;EACL,KAAA,CAAA,EAgBA,eAhBA;EACE,KAAA,EAgBH,cAhBG,CAgBY,IAhBZ,EAgBkB,MAhBlB,CAAA;EACP,QAAA,CAAA,EAgBQ,QAhBR;EAAC,QAAA,CAAA,EAAA,MAAA;AAEN,CAAA,CAAA,EAgBI,MAhBY,SAgBG,4BAhBO,GAiBtB,IAjBsB,SAAA,SAAA,GAAA,CAAA,UAkBT,qBAlBS,CAkBa,CAAA,CAAE,MAlBf,CAkBsB,MAlBtB,CAAA,CAAA,CAAA,CAAA,MAAA,EAmBV,CAnBU,EAAA,OAAA,CAAA,EAoBR,qBApBQ,EAAA,GAqBf,CArBe,GAAA,CAAA,UAsBT,gCAtBS,CAsBwB,IAtBxB,EAsB8B,CAAA,CAAE,MAtBhC,CAsBuC,MAtBvC,CAAA,CAAA,CAAA,CAAA,MAAA,EAuBV,CAvBU,EAAA,OAAA,CAAA,EAwBR,qBAxBQ,EAAA,GAyBf,CAzBe,GA0BtB,MA1BsB,SA0BP,gCA1BO,GA2BpB,IA3BoB,SAAA,SAAA,GAAA,CAAA,UA4BP,6BA5BO,CA4BuB,CAAA,CAAE,MA5BzB,CA4BgC,MA5BhC,CAAA,CAAA,CAAA,CAAA,MAAA,EA6BR,CA7BQ,EAAA,OAAA,CAAA,EA8BN,qBA9BM,EAAA,GA+Bb,CA/Ba,GAAA,CAAA,UAiCN,wCAjCM,CAkCd,IAlCc,EAmCd,CAAA,CAAE,MAnCY,CAmCL,MAnCK,CAAA,CAAA,CAAA,CAAA,MAAA,EAsCR,CAtCQ,EAAA,OAAA,CAAA,EAuCN,qBAvCM,EAAA,GAwCb,CAxCa,GAyCpB,MAzCoB,SAAA,SAAA,GAAA,CAAA,UA0CP,qBA1CO,CA0Ce,IA1Cf,CAAA,CAAA,CAAA,MAAA,EA2CR,CA3CQ,EAAA,OAAA,CAAA,EA4CN,qBA5CM,EAAA,GA6Cb,CA7Ca,GAAA,KAAA"}

package/lib/browser/decorators/injectable.decorator.mjs

@@ -0,0 +1,21 @@
+import { InjectableScope } from "../enums/injectable-scope.enum.mjs";
+import { InjectableType } from "../enums/injectable-type.enum.mjs";
+import { InjectableTokenMeta } from "../symbols/injectable-token.mjs";
+import { InjectionToken } from "../token/injection-token.mjs";
+import { globalRegistry } from "../token/registry.mjs";
+
+//#region src/decorators/injectable.decorator.mts
+function Injectable({ scope = InjectableScope.Singleton, token, schema, registry = globalRegistry, priority = 0 } = {}) {
+	return (target, context) => {
+		if (context && context.kind !== "class" || target instanceof Function && !context) throw new Error("[DI] @Injectable decorator can only be used on classes.");
+		if (schema && token) throw new Error("[DI] @Injectable decorator cannot have both a token and a schema");
+		let injectableToken = token ?? InjectionToken.create(target, schema);
+		registry.set(injectableToken, scope, target, InjectableType.Class, priority);
+		target[InjectableTokenMeta] = injectableToken;
+		return target;
+	};
+}
+
+//#endregion
+export { Injectable };
+//# sourceMappingURL=injectable.decorator.mjs.map

package/lib/browser/decorators/injectable.decorator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable.decorator.mjs","names":["InjectableScope","InjectableType","InjectableTokenMeta","InjectionToken","globalRegistry","Injectable","scope","Singleton","token","schema","registry","priority","target","context","kind","Function","Error","injectableToken","create","set","Class"],"sources":["../../../src/decorators/injectable.decorator.mts"],"sourcesContent":["import type { z } from 'zod/v4'\n\nimport type {\n  BaseInjectionTokenSchemaType,\n  ClassType,\n  ClassTypeWithArgument,\n  ClassTypeWithInstance,\n  ClassTypeWithInstanceAndArgument,\n  ClassTypeWithInstanceAndOptionalArgument,\n  ClassTypeWithOptionalArgument,\n  ClassTypeWithoutArguments,\n  InjectionTokenSchemaType,\n  OptionalInjectionTokenSchemaType,\n} from '../token/injection-token.mjs'\nimport type { Registry } from '../token/registry.mjs'\n\nimport { InjectableScope, InjectableType } from '../enums/index.mjs'\nimport { InjectableTokenMeta } from '../symbols/index.mjs'\nimport { InjectionToken } from '../token/injection-token.mjs'\nimport { globalRegistry } from '../token/registry.mjs'\n\nexport interface InjectableOptions {\n  scope?: InjectableScope\n  token?: InjectionToken<any, any>\n  schema?: InjectionTokenSchemaType\n  registry?: Registry\n  priority?: number\n}\n\n// #1 Simple constructorless class\nexport function Injectable(): <T extends ClassTypeWithoutArguments>(\n  target: T,\n  context?: ClassDecoratorContext,\n) => T\nexport function Injectable(options: {\n  scope?: InjectableScope\n  registry: Registry\n  priority?: number\n}): <T extends ClassTypeWithoutArguments>(\n  target: T,\n  context?: ClassDecoratorContext,\n) => T\nexport function Injectable(options: {\n  scope: InjectableScope\n  priority?: number\n}): <T extends ClassTypeWithoutArguments>(\n  target: T,\n  context?: ClassDecoratorContext,\n) => T\n// #2 Class with schema\nexport function Injectable<Schema extends InjectionTokenSchemaType>(options: {\n  scope?: InjectableScope\n  schema: Schema\n  registry?: Registry\n  priority?: number\n}): <T extends ClassTypeWithArgument<z.output<Schema>>>(\n  target: T,\n  context?: ClassDecoratorContext,\n) => T\n\n// #3 Class with typeless token and schema\nexport function Injectable<Type, Schema>(options: {\n  scope?: InjectableScope\n  token: InjectionToken<Type, Schema>\n  registry?: Registry\n  priority?: number\n}): Schema extends BaseInjectionTokenSchemaType\n  ? Type extends undefined\n    ? <T extends ClassTypeWithArgument<z.output<Schema>>>(\n        target: T,\n        context?: ClassDecoratorContext,\n      ) => T\n    : <T extends ClassTypeWithInstanceAndArgument<Type, z.output<Schema>>>(\n        target: T,\n        context?: ClassDecoratorContext,\n      ) => T\n  : Schema extends OptionalInjectionTokenSchemaType\n    ? Type extends undefined\n      ? <T extends ClassTypeWithOptionalArgument<z.output<Schema>>>(\n          target: T,\n          context?: ClassDecoratorContext,\n        ) => T\n      : <\n          T extends ClassTypeWithInstanceAndOptionalArgument<\n            Type,\n            z.output<Schema>\n          >,\n        >(\n          target: T,\n          context?: ClassDecoratorContext,\n        ) => T\n    : Schema extends undefined\n      ? <R extends ClassTypeWithInstance<Type>>(\n          target: R,\n          context?: ClassDecoratorContext,\n        ) => R\n      : never\n\nexport function Injectable({\n  scope = InjectableScope.Singleton,\n  token,\n  schema,\n  registry = globalRegistry,\n  priority = 0,\n}: InjectableOptions = {}) {\n  return <T extends ClassType>(\n    target: T,\n    context?: ClassDecoratorContext,\n  ): T => {\n    if (\n      (context && context.kind !== 'class') ||\n      (target instanceof Function && !context)\n    ) {\n      throw new Error('[DI] @Injectable decorator can only be used on classes.')\n    }\n    if (schema && token) {\n      throw new Error(\n        '[DI] @Injectable decorator cannot have both a token and a schema',\n      )\n    }\n    let injectableToken: InjectionToken<any, any> =\n      token ?? InjectionToken.create(target, schema as InjectionTokenSchemaType)\n\n    registry.set(injectableToken, scope, target, InjectableType.Class, priority)\n\n    // @ts-expect-error\n    target[InjectableTokenMeta] = injectableToken\n\n    return target\n  }\n}\n"],"mappings":";;;;;;;AAkGA,SAAgBK,WAAW,EACzBC,QAAQN,gBAAgBO,WACxBC,OACAC,QACAC,WAAWN,gBACXO,WAAW,MACU,EAAE,EAAA;AACvB,SACEC,QACAC,YAAAA;AAEA,MACE,WAAYA,QAAQC,SAAS,WAC5BF,kBAAkBG,YAAY,CAACF,QAEhC,OAAM,IAAIG,MAAM,0DAAA;AAElB,MAAIP,UAAUD,MACZ,OAAM,IAAIQ,MACR,mEAAA;EAGJ,IAAIC,kBACFT,SAASL,eAAee,OAAON,QAAQH,OAAAA;AAEzCC,WAASS,IAAIF,iBAAiBX,OAAOM,QAAQX,eAAemB,OAAOT,SAAAA;AAGnEC,SAAOV,uBAAuBe;AAE9B,SAAOL"}

package/lib/browser/enums/injectable-scope.enum.d.mts

@@ -0,0 +1,18 @@
+//#region src/enums/injectable-scope.enum.d.mts
+declare enum InjectableScope {
+  /**
+   * Singleton scope: The instance is created once and shared across the application.
+   */
+  Singleton = "Singleton",
+  /**
+   * Instance scope: A new instance is created for each injection.
+   */
+  Transient = "Transient",
+  /**
+   * Request scope: The instance is created once per request and shared within that request context.
+   */
+  Request = "Request",
+}
+//#endregion
+export { InjectableScope };
+//# sourceMappingURL=injectable-scope.enum.d.mts.map

package/lib/browser/enums/injectable-scope.enum.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable-scope.enum.d.mts","names":[],"sources":["../../../src/enums/injectable-scope.enum.mts"],"sourcesContent":[],"mappings":";aAAY,eAAA;EAAA"}

package/lib/browser/enums/injectable-scope.enum.mjs

@@ -0,0 +1,20 @@
+//#region src/enums/injectable-scope.enum.mts
+let InjectableScope = /* @__PURE__ */ function(InjectableScope$1) {
+	/**
+	* Singleton scope: The instance is created once and shared across the application.
+	*/
+	InjectableScope$1["Singleton"] = "Singleton";
+	/**
+	* Instance scope: A new instance is created for each injection.
+	*/
+	InjectableScope$1["Transient"] = "Transient";
+	/**
+	* Request scope: The instance is created once per request and shared within that request context.
+	*/
+	InjectableScope$1["Request"] = "Request";
+	return InjectableScope$1;
+}({});
+
+//#endregion
+export { InjectableScope };
+//# sourceMappingURL=injectable-scope.enum.mjs.map

package/lib/browser/enums/injectable-scope.enum.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable-scope.enum.mjs","names":[],"sources":["../../../src/enums/injectable-scope.enum.mts"],"sourcesContent":["export enum InjectableScope {\n  /**\n   * Singleton scope: The instance is created once and shared across the application.\n   */\n  Singleton = 'Singleton',\n  /**\n   * Instance scope: A new instance is created for each injection.\n   */\n  Transient = 'Transient',\n  /**\n   * Request scope: The instance is created once per request and shared within that request context.\n   */\n  Request = 'Request',\n}\n\n"],"mappings":";AAAA,IAAY,8DAAL;;;;AAIL;;;;AAIA;;;;AAIA"}

package/lib/browser/enums/injectable-type.enum.d.mts

@@ -0,0 +1,8 @@
+//#region src/enums/injectable-type.enum.d.mts
+declare enum InjectableType {
+  Class = "Class",
+  Factory = "Factory",
+}
+//#endregion
+export { InjectableType };
+//# sourceMappingURL=injectable-type.enum.d.mts.map

package/lib/browser/enums/injectable-type.enum.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable-type.enum.d.mts","names":[],"sources":["../../../src/enums/injectable-type.enum.mts"],"sourcesContent":[],"mappings":";aAAY,cAAA;EAAA,KAAA,GAAA,OAAA"}

package/lib/browser/enums/injectable-type.enum.mjs

@@ -0,0 +1,10 @@
+//#region src/enums/injectable-type.enum.mts
+let InjectableType = /* @__PURE__ */ function(InjectableType$1) {
+	InjectableType$1["Class"] = "Class";
+	InjectableType$1["Factory"] = "Factory";
+	return InjectableType$1;
+}({});
+
+//#endregion
+export { InjectableType };
+//# sourceMappingURL=injectable-type.enum.mjs.map

package/lib/browser/enums/injectable-type.enum.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable-type.enum.mjs","names":[],"sources":["../../../src/enums/injectable-type.enum.mts"],"sourcesContent":["export enum InjectableType {\n  Class = 'Class',\n  Factory = 'Factory',\n}\n\n"],"mappings":";AAAA,IAAY,4DAAL;AACL;AACA"}

package/lib/browser/errors/di-error.d.mts

@@ -0,0 +1,43 @@
+import { InjectionTokenSchemaType } from "../token/injection-token.mjs";
+import { FactoryRecord } from "../token/registry.mjs";
+
+//#region src/errors/di-error.d.mts
+declare enum DIErrorCode {
+  FactoryNotFound = "FactoryNotFound",
+  FactoryTokenNotResolved = "FactoryTokenNotResolved",
+  InstanceNotFound = "InstanceNotFound",
+  InstanceDestroying = "InstanceDestroying",
+  CircularDependency = "CircularDependency",
+  TokenValidationError = "TokenValidationError",
+  TokenSchemaRequiredError = "TokenSchemaRequiredError",
+  ClassNotInjectable = "ClassNotInjectable",
+  ScopeMismatchError = "ScopeMismatchError",
+  PriorityConflictError = "PriorityConflictError",
+  StorageError = "StorageError",
+  InitializationError = "InitializationError",
+  DependencyResolutionError = "DependencyResolutionError",
+  UnknownError = "UnknownError",
+}
+declare class DIError extends Error {
+  readonly code: DIErrorCode;
+  readonly message: string;
+  readonly context?: Record<string, unknown>;
+  constructor(code: DIErrorCode, message: string, context?: Record<string, unknown>);
+  static factoryNotFound(name: string): DIError;
+  static factoryTokenNotResolved(token: string | symbol | unknown): DIError;
+  static instanceNotFound(name: string): DIError;
+  static instanceDestroying(name: string): DIError;
+  static unknown(message: string | Error, context?: Record<string, unknown>): DIError;
+  static circularDependency(cycle: string[]): DIError;
+  static tokenValidationError(message: string, schema: InjectionTokenSchemaType | undefined, value: unknown): DIError;
+  static tokenSchemaRequiredError(token: string | symbol | unknown): DIError;
+  static classNotInjectable(className: string): DIError;
+  static scopeMismatchError(token: string | symbol | unknown, expectedScope: string, actualScope: string): DIError;
+  static priorityConflictError(token: string | symbol | unknown, records: FactoryRecord[]): DIError;
+  static storageError(message: string, operation: string, instanceName?: string): DIError;
+  static initializationError(serviceName: string, error: Error | string): DIError;
+  static dependencyResolutionError(serviceName: string, dependencyName: string, error: Error | string): DIError;
+}
+//#endregion
+export { DIError, DIErrorCode };
+//# sourceMappingURL=di-error.d.mts.map

package/lib/browser/errors/di-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"di-error.d.mts","names":[],"sources":["../../../src/errors/di-error.mts"],"sourcesContent":[],"mappings":";;;;aAGY,WAAA;;EAAA,uBAAW,GAAA,yBAAA;EAiBV,gBAAQ,GAAA,kBAAA;EAIK,kBAAA,GAAA,oBAAA;EAHE,kBAAA,GAAA,oBAAA;EAGF,oBAAA,GAAA,sBAAA;EAEZ,wBAAA,GAAA,0BAAA;EAQ0B,kBAAA,GAAA,oBAAA;EAQ4B,kBAAA,GAAA,oBAAA;EAQ3B,qBAAA,GAAA,uBAAA;EAQE,YAAA,GAAA,cAAA;EASrB,mBAAA,GAAA,qBAAA;EACR,yBAAA,GAAA,2BAAA;EACT,YAAA,GAAA,cAAA;;AAqBO,cAtEC,OAAA,SAAgB,KAAA,CAsEjB;EAEP,SAAA,IAAA,EApEqB,WAoErB;EAOgE,SAAA,OAAA,EAAA,MAAA;EAQrB,SAAA,OAAA,CAAA,EAtFpB,MAsFoB,CAAA,MAAA,EAAA,OAAA,CAAA;EAY3C,WAAA,CAAA,IAAA,EA/FqB,WA+FrB,EAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EA7FS,MA6FT,CAAA,MAAA,EAAA,OAAA,CAAA;EAUQ,OAAA,eAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EA/F2B,OA+F3B;EACR,OAAA,uBAAA,CAAA,KAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA,CAAA,EAxF+D,OAwF/D;EAYA,OAAA,gBAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EA5FoC,OA4FpC;EASM,OAAA,kBAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EA7FgC,OA6FhC;EACN,OAAA,OAAA,CAAA,OAAA,EAAA,MAAA,GArFiB,KAqFjB,EAAA,OAAA,CAAA,EApFS,MAoFT,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,EAnFA,OAmFA;EAWM,OAAA,kBAAA,CAAA,KAAA,EAAA,MAAA,EAAA,CAAA,EApFmC,OAoFnC;EACN,OAAA,oBAAA,CAAA,OAAA,EAAA,MAAA,EAAA,MAAA,EA1EO,wBA0EP,GAAA,SAAA,EAAA,KAAA,EAAA,OAAA,CAAA,EAxEA,OAwEA;EAhJwB,OAAA,wBAAA,CAAA,KAAA,EAAA,MAAA,GAAA,MAAA,GAAA,OAAA,CAAA,EA+EwC,OA/ExC;EAAK,OAAA,kBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EAuFc,OAvFd;2GAmG7B;0EAUQ,kBACR;kFAYA;yDASM,iBACN;uFAWM,iBACN"}

package/lib/browser/errors/di-error.mjs

@@ -0,0 +1,98 @@
+//#region src/errors/di-error.mts
+var DIErrorCode = /* @__PURE__ */ function(DIErrorCode$1) {
+	DIErrorCode$1["FactoryNotFound"] = "FactoryNotFound";
+	DIErrorCode$1["FactoryTokenNotResolved"] = "FactoryTokenNotResolved";
+	DIErrorCode$1["InstanceNotFound"] = "InstanceNotFound";
+	DIErrorCode$1["InstanceDestroying"] = "InstanceDestroying";
+	DIErrorCode$1["CircularDependency"] = "CircularDependency";
+	DIErrorCode$1["TokenValidationError"] = "TokenValidationError";
+	DIErrorCode$1["TokenSchemaRequiredError"] = "TokenSchemaRequiredError";
+	DIErrorCode$1["ClassNotInjectable"] = "ClassNotInjectable";
+	DIErrorCode$1["ScopeMismatchError"] = "ScopeMismatchError";
+	DIErrorCode$1["PriorityConflictError"] = "PriorityConflictError";
+	DIErrorCode$1["StorageError"] = "StorageError";
+	DIErrorCode$1["InitializationError"] = "InitializationError";
+	DIErrorCode$1["DependencyResolutionError"] = "DependencyResolutionError";
+	DIErrorCode$1["UnknownError"] = "UnknownError";
+	return DIErrorCode$1;
+}({});
+var DIError = class DIError extends Error {
+	code;
+	message;
+	context;
+	constructor(code, message, context) {
+		super(message), this.code = code, this.message = message;
+		this.context = context;
+		this.name = "DIError";
+	}
+	static factoryNotFound(name) {
+		return new DIError("FactoryNotFound", `Factory ${name} not found`, { name });
+	}
+	static factoryTokenNotResolved(token) {
+		return new DIError("FactoryTokenNotResolved", `Factory token not resolved: ${token?.toString() ?? "unknown"}`, { token });
+	}
+	static instanceNotFound(name) {
+		return new DIError("InstanceNotFound", `Instance ${name} not found`, { name });
+	}
+	static instanceDestroying(name) {
+		return new DIError("InstanceDestroying", `Instance ${name} destroying`, { name });
+	}
+	static unknown(message, context) {
+		if (message instanceof Error) return new DIError("UnknownError", message.message, {
+			...context,
+			parent: message
+		});
+		return new DIError("UnknownError", message, context);
+	}
+	static circularDependency(cycle) {
+		return new DIError("CircularDependency", `Circular dependency detected: ${cycle.join(" -> ")}`, { cycle });
+	}
+	static tokenValidationError(message, schema, value) {
+		return new DIError("TokenValidationError", message, {
+			schema,
+			value
+		});
+	}
+	static tokenSchemaRequiredError(token) {
+		return new DIError("TokenSchemaRequiredError", `Token ${token?.toString() ?? "unknown"} requires schema arguments and cannot be used with addInstance. Use BoundInjectionToken or provide arguments when resolving.`, { token });
+	}
+	static classNotInjectable(className) {
+		return new DIError("ClassNotInjectable", `Class ${className} is not decorated with @Injectable.`, { className });
+	}
+	static scopeMismatchError(token, expectedScope, actualScope) {
+		return new DIError("ScopeMismatchError", `Scope mismatch for ${token?.toString() ?? "unknown"}: expected ${expectedScope}, got ${actualScope}`, {
+			token,
+			expectedScope,
+			actualScope
+		});
+	}
+	static priorityConflictError(token, records) {
+		return new DIError("PriorityConflictError", `Priority conflict for ${token?.toString() ?? "unknown"}: multiple bindings with same priority`, {
+			token,
+			records
+		});
+	}
+	static storageError(message, operation, instanceName) {
+		return new DIError("StorageError", `Storage error: ${message}`, {
+			operation,
+			instanceName
+		});
+	}
+	static initializationError(serviceName, error) {
+		return new DIError("InitializationError", `Service ${serviceName} initialization failed: ${error instanceof Error ? error.message : error}`, {
+			serviceName,
+			error
+		});
+	}
+	static dependencyResolutionError(serviceName, dependencyName, error) {
+		return new DIError("DependencyResolutionError", `Failed to resolve dependency ${dependencyName} for service ${serviceName}: ${error instanceof Error ? error.message : error}`, {
+			serviceName,
+			dependencyName,
+			error
+		});
+	}
+};
+
+//#endregion
+export { DIError, DIErrorCode };
+//# sourceMappingURL=di-error.mjs.map

package/lib/browser/errors/di-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"di-error.mjs","names":["DIErrorCode","DIError","Error","context","code","message","name","factoryNotFound","factoryTokenNotResolved","token","toString","instanceNotFound","instanceDestroying","unknown","parent","circularDependency","cycle","cycleStr","join","tokenValidationError","schema","value","tokenSchemaRequiredError","classNotInjectable","className","scopeMismatchError","expectedScope","actualScope","priorityConflictError","records","storageError","operation","instanceName","initializationError","serviceName","error","dependencyResolutionError","dependencyName"],"sources":["../../../src/errors/di-error.mts"],"sourcesContent":["import type { InjectionTokenSchemaType } from '../token/injection-token.mjs'\nimport type { FactoryRecord } from '../token/registry.mjs'\n\nexport enum DIErrorCode {\n  FactoryNotFound = 'FactoryNotFound',\n  FactoryTokenNotResolved = 'FactoryTokenNotResolved',\n  InstanceNotFound = 'InstanceNotFound',\n  InstanceDestroying = 'InstanceDestroying',\n  CircularDependency = 'CircularDependency',\n  TokenValidationError = 'TokenValidationError',\n  TokenSchemaRequiredError = 'TokenSchemaRequiredError',\n  ClassNotInjectable = 'ClassNotInjectable',\n  ScopeMismatchError = 'ScopeMismatchError',\n  PriorityConflictError = 'PriorityConflictError',\n  StorageError = 'StorageError',\n  InitializationError = 'InitializationError',\n  DependencyResolutionError = 'DependencyResolutionError',\n  UnknownError = 'UnknownError',\n}\n\nexport class DIError extends Error {\n  public readonly context?: Record<string, unknown>\n\n  constructor(\n    public readonly code: DIErrorCode,\n    public readonly message: string,\n    context?: Record<string, unknown>,\n  ) {\n    super(message)\n    this.context = context\n    this.name = 'DIError'\n  }\n\n  // Static factory methods for common error types\n  static factoryNotFound(name: string): DIError {\n    return new DIError(\n      DIErrorCode.FactoryNotFound,\n      `Factory ${name} not found`,\n      { name },\n    )\n  }\n\n  static factoryTokenNotResolved(token: string | symbol | unknown): DIError {\n    return new DIError(\n      DIErrorCode.FactoryTokenNotResolved,\n      `Factory token not resolved: ${token?.toString() ?? 'unknown'}`,\n      { token },\n    )\n  }\n\n  static instanceNotFound(name: string): DIError {\n    return new DIError(\n      DIErrorCode.InstanceNotFound,\n      `Instance ${name} not found`,\n      { name },\n    )\n  }\n\n  static instanceDestroying(name: string): DIError {\n    return new DIError(\n      DIErrorCode.InstanceDestroying,\n      `Instance ${name} destroying`,\n      { name },\n    )\n  }\n\n  static unknown(\n    message: string | Error,\n    context?: Record<string, unknown>,\n  ): DIError {\n    if (message instanceof Error) {\n      return new DIError(DIErrorCode.UnknownError, message.message, {\n        ...context,\n        parent: message,\n      })\n    }\n    return new DIError(DIErrorCode.UnknownError, message, context)\n  }\n\n  static circularDependency(cycle: string[]): DIError {\n    const cycleStr = cycle.join(' -> ')\n    return new DIError(\n      DIErrorCode.CircularDependency,\n      `Circular dependency detected: ${cycleStr}`,\n      { cycle },\n    )\n  }\n\n  static tokenValidationError(\n    message: string,\n    schema: InjectionTokenSchemaType | undefined,\n    value: unknown,\n  ): DIError {\n    return new DIError(DIErrorCode.TokenValidationError, message, {\n      schema,\n      value,\n    })\n  }\n\n  static tokenSchemaRequiredError(token: string | symbol | unknown): DIError {\n    return new DIError(\n      DIErrorCode.TokenSchemaRequiredError,\n      `Token ${token?.toString() ?? 'unknown'} requires schema arguments and cannot be used with addInstance. Use BoundInjectionToken or provide arguments when resolving.`,\n      { token },\n    )\n  }\n\n  static classNotInjectable(className: string): DIError {\n    return new DIError(\n      DIErrorCode.ClassNotInjectable,\n      `Class ${className} is not decorated with @Injectable.`,\n      { className },\n    )\n  }\n\n  static scopeMismatchError(\n    token: string | symbol | unknown,\n    expectedScope: string,\n    actualScope: string,\n  ): DIError {\n    return new DIError(\n      DIErrorCode.ScopeMismatchError,\n      `Scope mismatch for ${token?.toString() ?? 'unknown'}: expected ${expectedScope}, got ${actualScope}`,\n      { token, expectedScope, actualScope },\n    )\n  }\n\n  static priorityConflictError(\n    token: string | symbol | unknown,\n    records: FactoryRecord[],\n  ): DIError {\n    return new DIError(\n      DIErrorCode.PriorityConflictError,\n      `Priority conflict for ${token?.toString() ?? 'unknown'}: multiple bindings with same priority`,\n      { token, records },\n    )\n  }\n\n  static storageError(\n    message: string,\n    operation: string,\n    instanceName?: string,\n  ): DIError {\n    return new DIError(DIErrorCode.StorageError, `Storage error: ${message}`, {\n      operation,\n      instanceName,\n    })\n  }\n\n  static initializationError(\n    serviceName: string,\n    error: Error | string,\n  ): DIError {\n    return new DIError(\n      DIErrorCode.InitializationError,\n      `Service ${serviceName} initialization failed: ${error instanceof Error ? error.message : error}`,\n      { serviceName, error },\n    )\n  }\n\n  static dependencyResolutionError(\n    serviceName: string,\n    dependencyName: string,\n    error: Error | string,\n  ): DIError {\n    return new DIError(\n      DIErrorCode.DependencyResolutionError,\n      `Failed to resolve dependency ${dependencyName} for service ${serviceName}: ${error instanceof Error ? error.message : error}`,\n      { serviceName, dependencyName, error },\n    )\n  }\n}\n"],"mappings":";AAGA,IAAO,cAAKA,yBAAAA,eAAAA;;;;;;;;;;;;;;;QAAAA;;AAiBZ,IAAaC,UAAb,MAAaA,gBAAgBC,MAAAA;;;CACXC;CAEhB,YACE,MACA,SACAA,SACA;AACA,QAAME,QAAAA,EAAAA,KAJUD,OAAAA,MAAAA,KACAC,UAAAA;AAIhB,OAAKF,UAAUA;AACf,OAAKG,OAAO;;CAId,OAAOC,gBAAgBD,MAAuB;AAC5C,SAAO,IAAIL,QAAAA,mBAET,WAAWK,KAAK,aAChB,EAAEA,MAAK,CAAA;;CAIX,OAAOE,wBAAwBC,OAA2C;AACxE,SAAO,IAAIR,QAAAA,2BAET,+BAA+BQ,OAAOC,UAAAA,IAAc,aACpD,EAAED,OAAM,CAAA;;CAIZ,OAAOE,iBAAiBL,MAAuB;AAC7C,SAAO,IAAIL,QAAAA,oBAET,YAAYK,KAAK,aACjB,EAAEA,MAAK,CAAA;;CAIX,OAAOM,mBAAmBN,MAAuB;AAC/C,SAAO,IAAIL,QAAAA,sBAET,YAAYK,KAAK,cACjB,EAAEA,MAAK,CAAA;;CAIX,OAAOO,QACLR,SACAF,SACS;AACT,MAAIE,mBAAmBH,MACrB,QAAO,IAAID,QAAAA,gBAAkCI,QAAQA,SAAS;GAC5D,GAAGF;GACHW,QAAQT;GACV,CAAA;AAEF,SAAO,IAAIJ,QAAAA,gBAAkCI,SAASF,QAAAA;;CAGxD,OAAOY,mBAAmBC,OAA0B;AAElD,SAAO,IAAIf,QAAAA,sBAET,iCAHee,MAAME,KAAK,OAAA,IAI1B,EAAEF,OAAM,CAAA;;CAIZ,OAAOG,qBACLd,SACAe,QACAC,OACS;AACT,SAAO,IAAIpB,QAAAA,wBAA0CI,SAAS;GAC5De;GACAC;GACF,CAAA;;CAGF,OAAOC,yBAAyBb,OAA2C;AACzE,SAAO,IAAIR,QAAAA,4BAET,SAASQ,OAAOC,UAAAA,IAAc,UAAU,+HACxC,EAAED,OAAM,CAAA;;CAIZ,OAAOc,mBAAmBC,WAA4B;AACpD,SAAO,IAAIvB,QAAAA,sBAET,SAASuB,UAAU,sCACnB,EAAEA,WAAU,CAAA;;CAIhB,OAAOC,mBACLhB,OACAiB,eACAC,aACS;AACT,SAAO,IAAI1B,QAAAA,sBAET,sBAAsBQ,OAAOC,UAAAA,IAAc,UAAU,aAAagB,cAAc,QAAQC,eACxF;GAAElB;GAAOiB;GAAeC;GAAY,CAAA;;CAIxC,OAAOC,sBACLnB,OACAoB,SACS;AACT,SAAO,IAAI5B,QAAAA,yBAET,yBAAyBQ,OAAOC,UAAAA,IAAc,UAAU,yCACxD;GAAED;GAAOoB;GAAQ,CAAA;;CAIrB,OAAOC,aACLzB,SACA0B,WACAC,cACS;AACT,SAAO,IAAI/B,QAAAA,gBAAkC,kBAAkBI,WAAW;GACxE0B;GACAC;GACF,CAAA;;CAGF,OAAOC,oBACLC,aACAC,OACS;AACT,SAAO,IAAIlC,QAAAA,uBAET,WAAWiC,YAAY,0BAA0BC,iBAAiBjC,QAAQiC,MAAM9B,UAAU8B,SAC1F;GAAED;GAAaC;GAAM,CAAA;;CAIzB,OAAOC,0BACLF,aACAG,gBACAF,OACS;AACT,SAAO,IAAIlC,QAAAA,6BAET,gCAAgCoC,eAAe,eAAeH,YAAY,IAAIC,iBAAiBjC,QAAQiC,MAAM9B,UAAU8B,SACvH;GAAED;GAAaG;GAAgBF;GAAM,CAAA"}

package/lib/browser/event-emitter.d.mts

@@ -0,0 +1,16 @@
+//#region src/event-emitter.d.mts
+type EventsConfig = {
+  [event: string]: any[];
+};
+type EventsNames<Events extends EventsConfig> = Exclude<keyof Events, symbol | number>;
+type EventsArgs<Events extends EventsConfig, Name extends EventsNames<Events>> = Events[Name] extends any[] ? Events[Name] : [];
+declare class EventEmitter<Events extends EventsConfig = {}> {
+  private listeners;
+  on<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): () => void;
+  off<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): void;
+  once<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, listener: (...args: Args) => void | Promise<void>): () => void;
+  emit<E extends EventsNames<Events>, Args extends EventsArgs<Events, E>>(event: E, ...args: Args): Promise<any>;
+}
+//#endregion
+export { EventEmitter, EventsArgs, EventsConfig, EventsNames };
+//# sourceMappingURL=event-emitter.d.mts.map

package/lib/browser/event-emitter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.mts","names":[],"sources":["../../src/event-emitter.mts"],"sourcesContent":[],"mappings":";KAQY,YAAA;EAAA,CAAA,KAAA,EAAA,MAAA,CAAY,EAAA,GAAA,EAAA;AAGxB,CAAA;AAAuC,KAA3B,WAA2B,CAAA,eAAA,YAAA,CAAA,GAAgB,OAAhB,CAAA,MAC/B,MAD+B,EAAA,MAAA,GAAA,MAAA,CAAA;AAC/B,KAGI,UAHJ,CAAA,eAIS,YAJT,EAAA,aAKO,WALP,CAKmB,MALnB,CAAA,CAAA,GAMJ,MANI,CAMG,IANH,CAAA,SAAA,GAAA,EAAA,GAMyB,MANzB,CAMgC,IANhC,CAAA,GAAA,EAAA;AAD+C,cAU1C,YAV0C,CAAA,eAUd,YAVc,GAAA,CAAA,CAAA,CAAA,CAAA;EAAO,QAAA,SAAA;EAIlD,EAAA,CAAA,UASG,WATO,CASK,MATL,CAAA,EAAA,aAS2B,UAT3B,CASsC,MATtC,EAS8C,CAT9C,CAAA,CAAA,CAAA,KAAA,EAUX,CAVW,EAAA,QAAA,EAAA,CAAA,GAAA,IAAA,EAWE,IAXF,EAAA,GAAA,IAAA,GAWkB,OAXlB,CAAA,IAAA,CAAA,CAAA,EAAA,GAAA,GAAA,IAAA;EACL,GAAA,CAAA,UAuBD,WAvBC,CAuBW,MAvBX,CAAA,EAAA,aAuBiC,UAvBjC,CAuB4C,MAvB5C,EAuBoD,CAvBpD,CAAA,CAAA,CAAA,KAAA,EAwBN,CAxBM,EAAA,QAAA,EAAA,CAAA,GAAA,IAAA,EAyBO,IAzBP,EAAA,GAAA,IAAA,GAyBuB,OAzBvB,CAAA,IAAA,CAAA,CAAA,EAAA,IAAA;EACU,IAAA,CAAA,UAoCV,WApCU,CAoCE,MApCF,CAAA,EAAA,aAoCwB,UApCxB,CAoCmC,MApCnC,EAoC2C,CApC3C,CAAA,CAAA,CAAA,KAAA,EAqChB,CArCgB,EAAA,QAAA,EAAA,CAAA,GAAA,IAAA,EAsCH,IAtCG,EAAA,GAAA,IAAA,GAsCa,OAtCb,CAAA,IAAA,CAAA,CAAA,EAAA,GAAA,GAAA,IAAA;EAAZ,IAAA,CAAA,UAiDQ,WAjDR,CAiDoB,MAjDpB,CAAA,EAAA,aAiD0C,UAjD1C,CAiDqD,MAjDrD,EAiD6D,CAjD7D,CAAA,CAAA,CAAA,KAAA,EAkDJ,CAlDI,EAAA,GAAA,IAAA,EAmDF,IAnDE,CAAA,EAoDV,OApDU,CAAA,GAAA,CAAA"}