@js-injection/service-provider 1.0.0-alpha.1

package/dist/types/src/service-provider.d.ts

@@ -0,0 +1,102 @@
+import type { Class, IServiceProvider, MapToInstance, ServiceDefinitionMap, TypeMap } from './types.js';
+export declare class ServiceProvider<T extends TypeMap> implements IServiceProvider<T> {
+    readonly name: string;
+    private definitions;
+    private parent?;
+    private readonly isAsyncScope;
+    private instances;
+    private resolving;
+    private path;
+    private disposed;
+    /**
+     * @param name The name of the service provider.
+     * @param definitions The service definitions map.
+     * @param parent The parent service provider, if any.
+     * @param isAsyncScope Whether this is an asynchronous scope.
+     */
+    constructor(name: string, definitions: ServiceDefinitionMap, parent?: ServiceProvider<T> | undefined, isAsyncScope?: boolean);
+    /**
+     * Creates a new scoped ServiceProvider.
+     * @param name The name of the scope.
+     * @example
+     * const scope = di.createScope('request-scope');
+     */
+    createScope(name?: string): IServiceProvider<T>;
+    /**
+     * Creates a new scoped ServiceProvider that supports asynchronous disposal.
+     * @param name The name of the scope.
+     * @example
+     * const scope = di.createAsyncScope('worker-scope');
+     */
+    createAsyncScope(name?: string): IServiceProvider<T>;
+    /**
+     * Resolves a service by its key.
+     * @param key The key to resolve.
+     * @example
+     * const logger = di.getService('Logger');
+     */
+    getService<K extends keyof T & (string | symbol)>(key: K): MapToInstance<T[K]>;
+    /**
+     * Resolves a service by its Class type.
+     * @param type The class type to resolve.
+     * @example
+     * const logger = di.getService(Logger);
+     */
+    getService<C extends Class>(type: C): InstanceType<C>;
+    /**
+     * Synchronously disposes of all resolved services.
+     * Throws AsyncDisposalError if this is an async scope or if any service disposal returns a Promise.
+     */
+    dispose(): void;
+    /**
+     * Asynchronously disposes of all resolved services.
+     */
+    disposeAsync(): Promise<void>;
+    /**
+     * Resolves a singleton value.
+     * @param uid The unique ID of the value.
+     * @param value The value to resolve.
+     */
+    private resolveValue;
+    /**
+     * Resolves an array of services.
+     * @param uid The unique ID of the service array.
+     * @param types The class types to resolve for the array.
+     */
+    private resolveArray;
+    /**
+     * Resolves a service via a factory.
+     * @param uid The unique ID of the service.
+     * @param factory The factory to use for resolution.
+     */
+    private resolveFactory;
+    /**
+     * Resolves a service via a function.
+     * @param uid The unique ID of the service.
+     * @param func The function to use for resolution.
+     * @param params The arguments for the function.
+     */
+    private resolveFunc;
+    /**
+     * Resolves a service via its class type.
+     * @param uid The unique ID of the service.
+     * @param type The class type to instantiate.
+     * @param params The constructor arguments.
+     */
+    private resolveClass;
+    /**
+     * Creates a proxy for the type map to allow resolving services by property access.
+     */
+    private createContainerProxy;
+    /**
+     * Gets the key for a given key or class type.
+     * @param keyOrType The key or class type.
+     */
+    private getKey;
+    /**
+     * Attempts to get the key for a given key or class type without throwing.
+     * @param keyOrType The key or class type.
+     */
+    private tryGetKey;
+}
+//# sourceMappingURL=service-provider.d.ts.map

package/dist/types/src/service-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-provider.d.ts","sourceRoot":"","sources":["../../../src/service-provider.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,KAAK,EAGL,gBAAgB,EAChB,aAAa,EAEb,oBAAoB,EACpB,OAAO,EACR,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe,CAAC,CAAC,SAAS,OAAO,CAAE,YAAW,gBAAgB,CAAC,CAAC,CAAC;aAa1D,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,MAAM,CAAC;IACf,OAAO,CAAC,QAAQ,CAAC,YAAY;IAf/B,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,QAAQ,CAAS;IAEzB;;;;;OAKG;gBAEe,IAAI,EAAE,MAAM,EACpB,WAAW,EAAE,oBAAoB,EACjC,MAAM,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,YAAA,EAClB,YAAY,GAAE,OAAe;IAGhD;;;;;OAKG;IACH,WAAW,CAAC,IAAI,GAAE,MAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAKxD;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,GAAE,MAAsB,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAKnE;;;;;OAKG;IACH,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E;;;;;OAKG;IACH,UAAU,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAmDrD;;;OAGG;IACH,OAAO,IAAI,IAAI;IAyBf;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBnC;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAKpB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAanB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAapB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;;OAGG;IACH,OAAO,CAAC,MAAM;IAYd;;;OAGG;IACH,OAAO,CAAC,SAAS;CA8BlB"}

package/dist/types/src/types.d.ts

@@ -0,0 +1,168 @@
+export type Class = abstract new (...args: any[]) => any;
+export type ConcreteClass<T extends Class = Class> = new (...args: any[]) => InstanceType<T>;
+/**
+ * Maps a value from a TypeMap to its resolved instance type.
+ */
+export type MapToInstance<T> = T extends abstract new (...args: any[]) => infer R ? R : (T extends (infer C)[] ? (C extends abstract new (...args: any[]) => infer R ? R[] : T) : T);
+/**
+ * Represents an object that can be disposed synchronously.
+ */
+export interface IDisposable {
+    dispose(): void;
+}
+/**
+ * Represents an object that can be disposed asynchronously.
+ */
+export interface IAsyncDisposable {
+    disposeAsync(): Promise<void>;
+}
+/**
+ * Interface for the ServiceProvider to avoid circular dependencies in types.
+ */
+export interface IServiceProvider<T extends TypeMap> {
+    /**
+     * The name of the service provider.
+     */
+    readonly name: string;
+    /**
+     * Synchronously disposes of all resolved services.
+     * Throws if any service requires asynchronous disposal.
+     */
+    dispose(): void;
+    /**
+     * Asynchronously disposes of all resolved services.
+     */
+    disposeAsync(): Promise<void>;
+    /**
+     * Creates a new scoped ServiceProvider.
+     */
+    createScope(): IServiceProvider<T>;
+    /**
+     * Creates a new scoped ServiceProvider that supports asynchronous disposal.
+     */
+    createAsyncScope(): IServiceProvider<T>;
+    /**
+     * Resolves a service by its key.
+     */
+    getService<K extends keyof T & (string | symbol)>(key: K): MapToInstance<T[K]>;
+    /**
+     * Resolves a service by its Class type.
+     */
+    getService<C extends Class>(type: C): InstanceType<C>;
+    /**
+     * Resolves a service by its key or its Class type.
+     */
+    getService<K extends keyof T & (string | symbol)>(keyOrType: K | T[K]): MapToInstance<T[K]>;
+}
+/**
+ * Maps all keys in a TypeMap to their resolved instance types.
+ */
+export type ResolvedTypeMap<T extends TypeMap> = {
+    [K in keyof T & (string | symbol)]: MapToInstance<T[K]>;
+};
+/**
+ * A factory function that creates an instance of a service.
+ */
+export type ImplementationFactory<T extends TypeMap, R> = (container: ResolvedTypeMap<T>, sp: IServiceProvider<T>) => R;
+/**
+ * Resolves the arguments for a given function.
+ * Each argument can be its actual type or a key from the DI container.
+ */
+export type FuncArgs<F extends (...args: any[]) => any, T extends TypeMap> = Parameters<F> extends infer P ? (P extends any[] ? {
+    [K in keyof P]: P[K] | FilterKeys<T, P[K]> | (P[K] extends abstract new (...args: any[]) => infer R ? FilterKeys<T, abstract new (...args: any[]) => R> : never);
+} : never) : never;
+/**
+ * Resolves the constructor arguments for a given class.
+ * Each argument can be its actual type or a key from the DI container.
+ */
+export type ClassArgs<T extends Class, Keys extends (string | symbol)> = ConstructorParameters<T> extends infer P ? (P extends any[] ? {
+    [K in keyof P]: P[K] | Keys | Class;
+} : never) : never;
+/**
+ * Represents the lifetime of a service.
+ */
+export type ServiceLifetime = 'singleton' | 'scoped';
+/**
+ * A registration for a service created via a function.
+ */
+export type FunctionRegistration<F extends (...args: any[]) => any, L extends ServiceLifetime, T extends TypeMap> = {
+    kind: 'function';
+    lifetime: L;
+    func: F;
+    params: FuncArgs<F, T>;
+};
+/**
+ * A registration for a service created via a factory.
+ */
+export type FactoryRegistration<C extends Class, L extends ServiceLifetime> = {
+    kind: 'service';
+    lifetime: L;
+    type: C;
+    factory: ImplementationFactory<any, any>;
+};
+/**
+ * A registration for a service created via constructor injection.
+ */
+export type ClassRegistration<C extends Class, L extends ServiceLifetime, Keys extends (string | symbol)> = {
+    kind: 'service';
+    lifetime: L;
+    type: C;
+    params: ClassArgs<C, Keys>;
+};
+/**
+ * A registration for an array of services (multiple implementations).
+ */
+export type ArrayRegistration<C extends Class[], L extends ServiceLifetime> = {
+    kind: 'service';
+    lifetime: L;
+    type: C;
+};
+/**
+ * A registration for a constant value.
+ */
+export type ValueRegistration<V, L extends ServiceLifetime> = {
+    kind: 'value';
+    lifetime: L;
+    value: V;
+};
+/**
+ * Internal runtime definition for a service or value.
+ */
+export interface ServiceDefinition<T> {
+    kind: 'service' | 'value' | 'function';
+    lifetime: 'singleton' | 'scoped';
+    uid: string | symbol;
+    type?: T;
+    params?: any[];
+    factory?: T extends Class ? ImplementationFactory<any, any> : never;
+    value?: T;
+    func?: (...args: any[]) => any;
+}
+/**
+ * A record of all registered services and their internal definitions.
+ */
+export type ServiceDefinitionMap = Record<string | symbol, ServiceDefinition<any>>;
+/**
+ * A record mapping string keys to Class constructors, arrays of constructors, or values.
+ */
+export type TypeMap = Record<string | symbol, any>;
+/**
+ * Filters keys of M that match type V.
+ */
+export type FilterKeys<M, V> = {
+    [K in keyof M]: M[K] extends V ? K : never;
+}[keyof M] & (string | symbol);
+/**
+ * Filters out keys from TypeMap that are primarily used for service registration.
+ */
+export type FilterValueKeys<M extends TypeMap> = {
+    [K in keyof M]: M[K] extends abstract new (...args: any[]) => any ? never : (M[K] extends (abstract new (...args: any[]) => any)[] ? never : (M[K] extends (...args: any[]) => any ? never : K));
+}[keyof M] & (string | symbol);
+/**
+ * Filters keys of M that are functions, promises, or async functions.
+ * Excludes class constructors and promises that resolve to class constructors.
+ */
+export type FilterFuncKeys<M extends TypeMap> = {
+    [K in keyof M]: (M[K] extends ((...args: any[]) => any) | Promise<any> ? ((M[K] extends Promise<infer R> ? R : M[K]) extends abstract new (...args: any[]) => any ? never : K) : never);
+}[keyof M] & (string | symbol);
+//# sourceMappingURL=types.d.ts.map

package/dist/types/src/types.d.ts.map

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

package/docs/CHEATSHEET.md

@@ -0,0 +1,179 @@
+# DI Service Provider Cheatsheet
+
+Quick reference for the Type-Safe Dependency Injection container.
+
+## Table of Contents
+1. [Setup & TypeMap](#1-setup--typemap)
+2. [Class Registration](#2-class-registration)
+3. [Factory Registration](#3-factory-registration)
+4. [Function Registration](#4-function-registration)
+5. [Array Registration](#5-array-registration)
+6. [Value Registration](#6-value-registration)
+7. [Service Retrieval](#7-service-retrieval)
+8. [Scopes](#8-scopes)
+9. [Disposal](#9-disposal)
+
+---
+
+## 1. Setup & TypeMap
+The `TypeMap` defines the contract of your container.
+
+```typescript
+import { ServiceCollection } from '@js-injection/service-provider';
+
+interface MyMap {
+  logger: ILogger;
+  database: Database;
+  userService: UserService;
+  apiClient: ApiClient;
+  config: Config;
+  plugins: Plugin[];
+  generateId: () => string;
+}
+```
+
+---
+
+## 2. Class Registration
+Standard constructor injection. Dependencies are automatically resolved.
+
+```typescript
+class Logger implements ILogger {
+  log(msg: string) { console.log(msg); }
+}
+
+class UserService {
+  constructor(public logger: ILogger) {}
+}
+
+class ApiClient {
+  constructor(public logger: ILogger) {}
+}
+
+const sp = new ServiceCollection<MyMap>()
+  // Singleton (one instance global)
+  .addSingletonClass(Logger)
+  .addSingletonClass(UserService, Logger)
+  // Scoped (one instance per scope)
+  .addScopedClass(ApiClient)
+  // Build the service provider
+  .build();
+```
+
+---
+
+## 3. Factory Registration
+Use factories for complex logic or when you need access to the container.
+
+```typescript
+class Database {
+  constructor(public connectionString: string) {}
+}
+
+const sp = new ServiceCollection<MyMap>()
+  // Singleton Factory
+  .addSingletonFactory(Database, (container) => {
+    const connectionString = container.config.dbUrl;
+    return new Database(connectionString);
+  })
+  // Scoped Factory
+  .addScopedFactory('apiClient', (container, sp) => {
+    return new ApiClient(container.logger);
+  })
+  // Build the service provider
+  .build();
+```
+
+---
+
+## 4. Function Registration
+Register a function as a service. Arguments are auto-injected.
+
+```typescript
+function createIdGenerator(prefix: string) {
+  return () => `${prefix}-${Math.random()}`;
+}
+
+// Arguments can be literal values or other services
+const sp = new ServiceCollection<MyMap>()
+  .addSingletonFunc('generateId', createIdGenerator, 'APP')
+  // Build the service provider
+  .build();
+```
+
+---
+
+## 5. Array Registration
+Map multiple implementations to a single key. Returns an array.
+
+```typescript
+interface Plugin { name: string; }
+class AuthPlugin implements Plugin { name = 'auth'; }
+class LogPlugin implements Plugin { name = 'log'; }
+
+// Individual classes are auto-registered if needed
+const sp = new ServiceCollection<MyMap>()
+  .addSingletonArray('plugins', AuthPlugin, LogPlugin)
+  // Build the service provider
+  .build();
+
+// Retrieval
+const plugins = sp.getService('plugins'); // [AuthPlugin, LogPlugin]
+```
+
+---
+
+## 6. Value Registration
+Register constant values or configuration objects.
+
+```typescript
+interface Config { dbUrl: string; }
+const config: Config = { dbUrl: 'postgres://localhost:5432' };
+
+const sp = new ServiceCollection<MyMap>()
+  .addSingletonValue('config', config)
+  // Build the service provider
+  .build();
+```
+
+---
+
+## 7. Service Retrieval
+Resolve services from the built provider.
+
+```typescript
+const sp = new ServiceCollection<MyMap>().build();
+
+// 1. Resolve by Class (returns Implementation type)
+const userService = sp.getService(UserService);
+
+// 2. Resolve by Key (returns Interface type from TypeMap)
+const logger = sp.getService('logger');
+```
+
+---
+
+## 8. Scopes
+Create child containers for unit-of-work isolation.
+
+```typescript
+// Standard Scope
+const scope = sp.createScope();
+const scopedSvc = scope.getService(ApiClient);
+
+// Async Scope (supports async disposal)
+const asyncScope = sp.createAsyncScope();
+```
+
+---
+
+## 9. Disposal
+Clean up resources for `IDisposable` and `IAsyncDisposable` services.
+
+```typescript
+// Synchronous (throws if any service is async)
+sp.dispose();
+
+// Asynchronous (recommended)
+await sp.disposeAsync();
+```

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@js-injection/service-provider",
+  "version": "1.0.0-alpha.1",
+  "description": "",
+  "license": "ISC",
+  "author": "",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/js-injection/service-provider.git"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/js-injection/service-provider/issues"
+  },
+  "homepage": "https://gitlab.com/js-injection/service-provider#readme",
+  "engines": {
+    "node": ">=22"
+  },
+  "type": "module",
+  "types": "./dist/types/src/index.d.ts",
+  "main": "./dist/legacy.cjs",
+  "imports": {
+    "#src/*": "./out/src/*"
+  },
+  "exports": {
+    "import": "./dist/index.js",
+    "types": "./dist/types/src/index.d.ts",
+    "require": "./dist/legacy.cjs"
+  },
+  "devDependencies": {
+    "@types/mocha": "10.0.10",
+    "@types/node": "22.19.15",
+    "@types/source-map-support": "0.5.10",
+    "c8": "11.0.0",
+    "esbuild": "0.27.4",
+    "js-build-tasks": "1.0.0-rc.18",
+    "mocha": "11.7.5",
+    "mocha-ui-esm": "1.0.0-beta.17",
+    "rimraf": "6.1.3",
+    "source-map-support": "0.5.21",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "compile": "task",
+    "bundle": "task",
+    "test": "task",
+    "coverage": "task",
+    "start": "task compile bundle:smoke && node ./dist/test/smoke/async-func.js",
+    "prepublishOnly": "task"
+  }
+}

package/src/errors.ts

@@ -0,0 +1,49 @@
+/**
+ * Thrown when a circular dependency is detected.
+ */
+export class CircularDependencyError extends Error {
+  constructor(path: string) {
+    super(`Circular dependency detected: ${path}`);
+    this.name = 'CircularDependencyError';
+  }
+}
+
+/**
+ * Thrown when a service cannot be resolved.
+ */
+export class ServiceNotFoundError extends Error {
+  constructor(identifier: string) {
+    super(`Service not registered for identifier: ${identifier}`);
+    this.name = 'ServiceNotFoundError';
+  }
+}
+
+/**
+ * Thrown when a registration is invalid.
+ */
+export class RegistrationError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'RegistrationError';
+  }
+}
+
+/**
+ * Thrown when a service provider has been disposed.
+ */
+export class ServiceProviderDisposedError extends Error {
+  constructor() {
+    super('ServiceProvider has been disposed and cannot resolve services.');
+    this.name = 'ServiceProviderDisposedError';
+  }
+}
+
+/**
+ * Thrown when a synchronous dispose is called on a scope containing services that require asynchronous disposal.
+ */
+export class AsyncDisposalError extends Error {
+  constructor(serviceKey: string) {
+    super(`Service "${serviceKey}" requires asynchronous disposal but a synchronous dispose was called. Please use await disposeAsync() instead.`);
+    this.name = 'AsyncDisposalError';
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from './errors.js';
+export * from './service-collection.js';
+export * from './service-provider.js';
+export * from './types.js';

package/src/registry.ts

@@ -0,0 +1,17 @@
+import type { Class } from './types.js';
+
+const classKeyRegistry = new WeakMap<Class, symbol>();
+
+/**
+ * Resolves a stable Symbol for a given class constructor.
+ * This is used to ensure that DI resolution remains stable even after minification.
+ * @param type The class constructor.
+ */
+export function getStableKey(type: Class): symbol {
+  let key = classKeyRegistry.get(type);
+  if (!key) {
+    key = Symbol(type.name || 'AnonymousClass');
+    classKeyRegistry.set(type, key);
+  }
+  return key;
+}