@brianmcd/di 0.0.1

package/dist/cjs/lib/types/factory-provider.d.ts

@@ -0,0 +1,18 @@
+import type { ResolveDeps } from './resolvers.js';
+import type { Token } from './tokens.js';
+export interface FactoryProvider<T, Deps extends readonly Token<any>[] = readonly Token<any>[], DestroyDeps extends readonly Token<any>[] = readonly []> {
+    provide: Token<T>;
+    deps: Deps;
+    factory: FactoryFn<T, Deps>;
+    onDestroy?: {
+        deps?: DestroyDeps;
+        handler: (...args: ResolveDeps<DestroyDeps>) => void | Promise<void>;
+    };
+}
+/**
+ * Factory function type - can be sync or async.
+ * Parameters must match the types resolved from deps.
+ */
+type FactoryFn<T, Deps extends readonly Token<any>[] = readonly Token<any>[]> = (...args: ResolveDeps<Deps>) => T | Promise<T>;
+export {};
+//# sourceMappingURL=factory-provider.d.ts.map

package/dist/cjs/lib/types/factory-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-provider.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/factory-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,eAAe,CAC9B,CAAC,EACD,IAAI,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EAC1D,WAAW,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,EAAE;IAEvD,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5B,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,WAAW,CAAC;QACnB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACtE,CAAC;CACH;AAED;;;GAGG;AACH,KAAK,SAAS,CAAC,CAAC,EAAE,IAAI,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAC9E,GAAG,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,KACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC"}

package/dist/cjs/lib/types/factory-provider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=factory-provider.js.map

package/dist/cjs/lib/types/factory-provider.js.map

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

package/dist/cjs/lib/types/injectable-class.d.ts

@@ -0,0 +1,11 @@
+import { ResolveDeps } from './resolvers.js';
+import { Token } from './tokens.js';
+/**
+ * Interface for classes with static deps property.
+ * Enforces that the constructor parameters must match the types resolved from deps.
+ */
+export interface InjectableClass<T = unknown, Deps extends readonly Token<any>[] = readonly Token<any>[]> {
+    deps: Deps;
+    new (...args: ResolveDeps<Deps>): T;
+}
+//# sourceMappingURL=injectable-class.d.ts.map

package/dist/cjs/lib/types/injectable-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectable-class.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/injectable-class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,eAAe,CAC9B,CAAC,GAAG,OAAO,EACX,IAAI,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE;IAE1D,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,GAAG,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;CACrC"}

package/dist/cjs/lib/types/injectable-class.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=injectable-class.js.map

package/dist/cjs/lib/types/injectable-class.js.map

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

package/dist/cjs/lib/types/lifecycle.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Interface for services that need initialization after all dependencies are resolved
+ */
+export interface OnInit {
+    onInit(): Promise<void> | void;
+}
+/**
+ * Interface for services that need cleanup on container destruction
+ */
+export interface OnDestroy {
+    onDestroy(): Promise<void> | void;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/cjs/lib/types/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/lifecycle.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnC"}

package/dist/cjs/lib/types/lifecycle.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=lifecycle.js.map

package/dist/cjs/lib/types/lifecycle.js.map

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

package/dist/cjs/lib/types/options.d.ts

@@ -0,0 +1,5 @@
+import type { Scope } from './scope.js';
+export interface RegistrationOptions {
+    scope?: Scope;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/cjs/lib/types/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf"}

package/dist/cjs/lib/types/options.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=options.js.map

package/dist/cjs/lib/types/options.js.map

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

package/dist/cjs/lib/types/resolvers.d.ts

@@ -0,0 +1,15 @@
+import type { TypedToken, Token } from './tokens.js';
+/**
+ * Extract the resolved type from a service token.
+ * - For TypedToken<T> → returns T
+ * - For class constructor → returns the instance type
+ */
+export type ResolveToken<T> = T extends TypedToken<infer U> ? U : T extends new (...args: any[]) => infer U ? U : never;
+/**
+ * Extract types from a deps array as a tuple.
+ * Maps each token to its resolved type.
+ */
+export type ResolveDeps<T extends readonly Token<any>[]> = {
+    [K in keyof T]: ResolveToken<T[K]>;
+};
+//# sourceMappingURL=resolvers.d.ts.map

package/dist/cjs/lib/types/resolvers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvers.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/resolvers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IACxB,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE5F;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI;KACxD,CAAC,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnC,CAAC"}

package/dist/cjs/lib/types/resolvers.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=resolvers.js.map

package/dist/cjs/lib/types/resolvers.js.map

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

package/dist/cjs/lib/types/scope.d.ts

@@ -0,0 +1,6 @@
+export declare const Scope: {
+    readonly Singleton: "singleton";
+    readonly Scoped: "scoped";
+};
+export type Scope = (typeof Scope)[keyof typeof Scope];
+//# sourceMappingURL=scope.d.ts.map

package/dist/cjs/lib/types/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/scope.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;;;CAGR,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC"}

package/dist/cjs/lib/types/scope.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Scope = void 0;
+exports.Scope = {
+    Singleton: 'singleton',
+    Scoped: 'scoped',
+};
+//# sourceMappingURL=scope.js.map

package/dist/cjs/lib/types/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../../../src/lib/types/scope.ts"],"names":[],"mappings":";;;AAAa,QAAA,KAAK,GAAG;IACnB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;CACR,CAAC"}

package/dist/cjs/lib/types/tokens.d.ts

@@ -0,0 +1,13 @@
+/**
+ *
+ * Service token types - can be a class constructor or a typed symbol
+ */
+export type Token<T> = TypedToken<T> | (new (...args: any[]) => T);
+/**
+ * A branded symbol type that carries type information at the type level.
+ * Use createToken<T>() to create typed tokens for non-class dependencies.
+ */
+export type TypedToken<T> = symbol & {
+    readonly __type?: T;
+};
+//# sourceMappingURL=tokens.d.ts.map

package/dist/cjs/lib/types/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../../src/lib/types/tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC"}

package/dist/cjs/lib/types/tokens.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tokens.js.map

package/dist/cjs/lib/types/tokens.js.map

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

package/dist/cjs/lib/utils/create-token.d.ts

@@ -0,0 +1,10 @@
+import type { TypedToken } from '../types/tokens.js';
+/**
+ * Create a typed token for non-class dependencies (like database connections).
+ * The type parameter T specifies what type the token resolves to.
+ *
+ * @example
+ * export const DATABASE = createToken<Database>('DATABASE');
+ */
+export declare function createToken<T>(name: string): TypedToken<T>;
+//# sourceMappingURL=create-token.d.ts.map

package/dist/cjs/lib/utils/create-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-token.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/create-token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAE1D"}

package/dist/cjs/lib/utils/create-token.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createToken = createToken;
+/**
+ * Create a typed token for non-class dependencies (like database connections).
+ * The type parameter T specifies what type the token resolves to.
+ *
+ * @example
+ * export const DATABASE = createToken<Database>('DATABASE');
+ */
+function createToken(name) {
+    return Symbol.for(name);
+}
+//# sourceMappingURL=create-token.js.map

package/dist/cjs/lib/utils/create-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-token.js","sourceRoot":"","sources":["../../../../src/lib/utils/create-token.ts"],"names":[],"mappings":";;AASA,kCAEC;AATD;;;;;;GAMG;AACH,SAAgB,WAAW,CAAI,IAAY;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAkB,CAAC;AAC3C,CAAC"}

package/dist/cjs/lib/utils/define-factory.d.ts

@@ -0,0 +1,28 @@
+import type { FactoryProvider } from '../types/factory-provider.js';
+import type { Token } from '../types/tokens.js';
+/**
+ * Helper to define factories with type inference.
+ *
+ * This function is an identity function that returns the config object unchanged.
+ * Its purpose is to provide automatic type inference for the generic parameters,
+ * so you don't have to manually specify them when creating a FactoryProvider.
+ *
+ * Without defineFactory:
+ *   const factory: FactoryProvider<DbType, readonly [typeof CONFIG]> = { ... };
+ *
+ * With defineFactory:
+ *   const factory = defineFactory({ ... }); // Types inferred from provide and deps
+ *
+ * @example
+ * const dbFactory = defineFactory({
+ *   provide: DATABASE,
+ *   deps: [DB_CONTAINER_OPTIONS] as const,
+ *   factory: (options) => new Database(options.connectionString),
+ *   onDestroy: {
+ *     deps: [DATABASE] as const,
+ *     handler: async (db) => await db.destroy()
+ *   }
+ * });
+ */
+export declare function defineFactory<T, Deps extends readonly Token<any>[], DestroyDeps extends readonly Token<any>[] = readonly []>(config: FactoryProvider<T, Deps, DestroyDeps>): FactoryProvider<T, Deps, DestroyDeps>;
+//# sourceMappingURL=define-factory.d.ts.map

package/dist/cjs/lib/utils/define-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-factory.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/define-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EACD,IAAI,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EAClC,WAAW,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,EAAE,EACvD,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAEtF"}

package/dist/cjs/lib/utils/define-factory.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineFactory = defineFactory;
+/**
+ * Helper to define factories with type inference.
+ *
+ * This function is an identity function that returns the config object unchanged.
+ * Its purpose is to provide automatic type inference for the generic parameters,
+ * so you don't have to manually specify them when creating a FactoryProvider.
+ *
+ * Without defineFactory:
+ *   const factory: FactoryProvider<DbType, readonly [typeof CONFIG]> = { ... };
+ *
+ * With defineFactory:
+ *   const factory = defineFactory({ ... }); // Types inferred from provide and deps
+ *
+ * @example
+ * const dbFactory = defineFactory({
+ *   provide: DATABASE,
+ *   deps: [DB_CONTAINER_OPTIONS] as const,
+ *   factory: (options) => new Database(options.connectionString),
+ *   onDestroy: {
+ *     deps: [DATABASE] as const,
+ *     handler: async (db) => await db.destroy()
+ *   }
+ * });
+ */
+function defineFactory(config) {
+    return config;
+}
+//# sourceMappingURL=define-factory.js.map

package/dist/cjs/lib/utils/define-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-factory.js","sourceRoot":"","sources":["../../../../src/lib/utils/define-factory.ts"],"names":[],"mappings":";;AA2BA,sCAMC;AA9BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,aAAa,CAI3B,MAA6C;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/lib/utils/has-on-destroy.d.ts

@@ -0,0 +1,6 @@
+import type { OnDestroy } from '../types/lifecycle.js';
+/**
+ * Type guard to check if an instance implements OnDestroy
+ */
+export declare function hasOnDestroy(instance: unknown): instance is OnDestroy;
+//# sourceMappingURL=has-on-destroy.d.ts.map

package/dist/cjs/lib/utils/has-on-destroy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-on-destroy.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/has-on-destroy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,SAAS,CAErE"}

package/dist/cjs/lib/utils/has-on-destroy.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasOnDestroy = hasOnDestroy;
+/**
+ * Type guard to check if an instance implements OnDestroy
+ */
+function hasOnDestroy(instance) {
+    return typeof instance.onDestroy === 'function';
+}
+//# sourceMappingURL=has-on-destroy.js.map

package/dist/cjs/lib/utils/has-on-destroy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-on-destroy.js","sourceRoot":"","sources":["../../../../src/lib/utils/has-on-destroy.ts"],"names":[],"mappings":";;AAKA,oCAEC;AALD;;GAEG;AACH,SAAgB,YAAY,CAAC,QAAiB;IAC5C,OAAO,OAAQ,QAAsB,CAAC,SAAS,KAAK,UAAU,CAAC;AACjE,CAAC"}

package/dist/cjs/lib/utils/has-on-init.d.ts

@@ -0,0 +1,6 @@
+import type { OnInit } from '../types/lifecycle.js';
+/**
+ * Type guard to check if an instance implements OnInit
+ */
+export declare function hasOnInit(instance: unknown): instance is OnInit;
+//# sourceMappingURL=has-on-init.d.ts.map

package/dist/cjs/lib/utils/has-on-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-on-init.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/has-on-init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI,MAAM,CAE/D"}

package/dist/cjs/lib/utils/has-on-init.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasOnInit = hasOnInit;
+/**
+ * Type guard to check if an instance implements OnInit
+ */
+function hasOnInit(instance) {
+    return typeof instance.onInit === 'function';
+}
+//# sourceMappingURL=has-on-init.js.map

package/dist/cjs/lib/utils/has-on-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-on-init.js","sourceRoot":"","sources":["../../../../src/lib/utils/has-on-init.ts"],"names":[],"mappings":";;AAKA,8BAEC;AALD;;GAEG;AACH,SAAgB,SAAS,CAAC,QAAiB;IACzC,OAAO,OAAQ,QAAmB,CAAC,MAAM,KAAK,UAAU,CAAC;AAC3D,CAAC"}

package/dist/cjs/lib/utils/token-to-string.d.ts

@@ -0,0 +1,6 @@
+import type { Token } from '../types/tokens.js';
+/**
+ * Convert a service token to a string for error messages
+ */
+export declare function tokenToString(token: Token<unknown>): string;
+//# sourceMappingURL=token-to-string.d.ts.map

package/dist/cjs/lib/utils/token-to-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-to-string.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/token-to-string.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAK3D"}

package/dist/cjs/lib/utils/token-to-string.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenToString = tokenToString;
+/**
+ * Convert a service token to a string for error messages
+ */
+function tokenToString(token) {
+    if (typeof token === 'symbol') {
+        return token.description ?? token.toString();
+    }
+    return token.name;
+}
+//# sourceMappingURL=token-to-string.js.map

package/dist/cjs/lib/utils/token-to-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-to-string.js","sourceRoot":"","sources":["../../../../src/lib/utils/token-to-string.ts"],"names":[],"mappings":";;AAKA,sCAKC;AARD;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAqB;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/dist/esm/index.d.ts

@@ -0,0 +1,12 @@
+export { Container } from './lib/container.js';
+export { ContainerBuilder } from './lib/container-builder.js';
+export { ScopedContainer } from './lib/scoped-container.js';
+export type { OnDestroy, OnInit } from './lib/types/lifecycle.js';
+export type { FactoryProvider } from './lib/types/factory-provider.js';
+export type { RegistrationOptions } from './lib/types/options.js';
+export { Scope } from './lib/types/scope.js';
+export type { Scope as ScopeType } from './lib/types/scope.js';
+export type { Token, TypedToken } from './lib/types/tokens.js';
+export { createToken } from './lib/utils/create-token.js';
+export { defineFactory } from './lib/utils/define-factory.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,YAAY,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+export { Container } from './lib/container.js';
+export { ContainerBuilder } from './lib/container-builder.js';
+export { ScopedContainer } from './lib/scoped-container.js';
+export { Scope } from './lib/types/scope.js';
+export { createToken } from './lib/utils/create-token.js';
+export { defineFactory } from './lib/utils/define-factory.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAK5D,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAI7C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/esm/lib/container-builder.d.ts

@@ -0,0 +1,76 @@
+import { Container } from './container.js';
+import type { FactoryProvider } from './types/factory-provider.js';
+import type { InjectableClass } from './types/injectable-class.js';
+import type { RegistrationOptions } from './types/options.js';
+import type { Token } from './types/tokens.js';
+/**
+ * ContainerBuilder is the class you use to configure a Container.
+ *
+ * The ContainerBuilder has 2 main responsibilities:
+ *   1. Collect all provider registrations, which can be defined in any order.
+ *     - Handled by register* methods.
+ *   2. Instantiate instances and register them in a new Container.
+ *     - Handled by `.build()`.
+ *
+ * The ContainerBuilder does a topological sort to ensure that instances are created and destroyed
+ * in the correct order (e.g. all of a providers dependencies must be created before that
+ * provider's instance can be created, and destruction needs to happen in the opposite order).
+ */
+export declare class ContainerBuilder {
+    private readonly registrations;
+    /**
+     * Register a static value.
+     */
+    registerValue<T>(token: Token<T>, value: T): this;
+    /**
+     * Register a class with static deps property.
+     * Dependencies are resolved automatically during build().
+     * Type safety between the deps array and constructor params is enforced at this method.
+     */
+    registerClass<T, Deps extends readonly Token<any>[]>(Class: InjectableClass<T, Deps>, options?: RegistrationOptions): this;
+    /**
+     * Register a factory provider, which can be async or sync and can inject other dependencies.
+     */
+    registerFactory<T, Deps extends readonly Token<any>[], DestroyDeps extends readonly Token<any>[]>(provider: FactoryProvider<T, Deps, DestroyDeps>, options?: RegistrationOptions): this;
+    /**
+     * Merge providers from another container.
+     *
+     * This is useful for creating standalone packages/libraries that export a ContainerBuilder.
+     * You can use `merge` to bring these standalone packages together into a single Container.
+     */
+    merge(other: ContainerBuilder): this;
+    /**
+     * Override an existing provider with a value; intended for mocking during tests.
+     */
+    override<T>(token: Token<T>, value: T): this;
+    /**
+     * Build the container - topologically sorts providers and instantiates singletons.
+     * Scoped providers are validated but not instantiated - they're stored for later use in Scopes.
+     * By default, also initializes the container (calls onInit on all services).
+     */
+    build(options?: {
+        init?: boolean;
+    }): Promise<Container>;
+    /**
+     * Topologically sort providers by their dependencies using Kahn's algorithm.
+     *
+     * This ensures that dependent providers are created and initialized BEFORE the providers that
+     * depend on them, and that dependent providers are destroyed AFTER providers that depend on them.
+     *
+     * Also validates that singleton providers do not depend on scoped providers.
+     */
+    private topologicalSort;
+    /**
+     * Find a cycle path using DFS with coloring.
+     * Returns the cycle as an array of tokens ending with the repeated token.
+     */
+    private findCyclePath;
+    private addRegistration;
+    private isScoped;
+    private isSingleton;
+    /**
+     * Resolve dependencies from the instances map.
+     */
+    private resolveDeps;
+}
+//# sourceMappingURL=container-builder.d.ts.map

package/dist/esm/lib/container-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-builder.d.ts","sourceRoot":"","sources":["../../../src/lib/container-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAkB,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;IAE9E;;OAEG;IACI,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAKxD;;;;OAIG;IACI,aAAa,CAAC,CAAC,EAAE,IAAI,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EACxD,KAAK,EAAE,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,EAC/B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,IAAI;IAYP;;OAEG;IACI,eAAe,CACpB,CAAC,EACD,IAAI,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EAClC,WAAW,SAAS,SAAS,KAAK,CAAC,GAAG,CAAC,EAAE,EACzC,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAYvF;;;;;OAKG;IACI,KAAK,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAO3C;;OAEG;IACI,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQnD;;;;OAIG;IACU,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IA+DpE;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IA+EvB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAmDrB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,WAAW;CAYpB"}