@signe/di 2.4.6 → 2.5.0

package/dist/index.d.ts

@@ -1,3 +1,30 @@
+/**
+ * Context class for managing dependency injection state
+ * @module @signe/di/context
+ */
+/**
+ * Stores and manages the state of injected dependencies
+ * @template TState - Type for the state
+ * @template TActions - Type for the actions
+ * @template TValues - Type for additional values
+ */
+declare class Context<TState = any, TActions = any, TValues extends Record<string, any> = Record<string, any>> {
+    /** Internal storage for injected values */
+    private values;
+    /**
+     * Sets a value in the context
+     * @param key - Unique identifier for the value
+     * @param value - Value to store
+     */
+    set<K extends keyof TValues>(key: K, value: TValues[K]): void;
+    /**
+     * Retrieves a value from the context
+     * @param key - Unique identifier for the value
+     * @returns The stored value or undefined if not found
+     */
+    get<K extends keyof TValues>(key: K): TValues[K];
+}
+
 /**
  * Type definitions for the dependency injection system
  * @module @signe/di/types
@@ -22,7 +49,51 @@ type FactoryFn = (context: ProviderContext) => any;
 interface ProviderMeta {
     [key: string]: any;
 }
-interface ValueProvider {
+/**
+ * Common options available to all providers
+ */
+interface ProviderOptions {
+    /**
+     * When true, allows multiple instances to be registered for the same token
+     */
+    multi?: boolean;
+    /**
+     * Optional name used to register and resolve a specific instance
+     */
+    name?: string;
+}
+/**
+ * Options that can be passed when calling {@link provide}
+ */
+interface ProvideOptions extends ProviderOptions {
+}
+/**
+ * Options that can be passed when calling {@link inject}
+ */
+interface InjectionOptions {
+    /**
+     * Optional name used to resolve a specific instance
+     */
+    name?: string;
+    /**
+     * When true, allows retrieving all instances registered with {@link ProviderOptions.multi}
+     */
+    multi?: boolean;
+    /**
+     * When true, `inject` will return `undefined` instead of throwing if the instance is missing
+     */
+    optional?: boolean;
+}
+/**
+ * Options used when checking if an instance exists in the context
+ */
+interface InstanceLookupOptions {
+    /**
+     * Optional name of the instance to check
+     */
+    name?: string;
+}
+interface ValueProvider extends ProviderOptions {
     /** Token to identify the provider */
     provide: ProviderToken;
     /** Value to be injected */
@@ -35,7 +106,7 @@ interface ValueProvider {
 /**
  * Provider configuration for class-based injection
  */
-interface ClassProvider {
+interface ClassProvider extends ProviderOptions {
     /** Token to identify the provider */
     provide: ProviderToken;
     /** Class to be instantiated */
@@ -48,7 +119,7 @@ interface ClassProvider {
 /**
  * Provider configuration for factory-based injection
  */
-interface FactoryProvider {
+interface FactoryProvider extends ProviderOptions {
     /** Token to identify the provider */
     provide: ProviderToken;
     /** Tokens that must be injected before this provider */
@@ -61,7 +132,7 @@ interface FactoryProvider {
 /**
  * Provider configuration for alias-based injection
  */
-interface ExistingProvider {
+interface ExistingProvider extends ProviderOptions {
     /** Token to identify the provider */
     provide: ProviderToken;
     /** Token of the existing provider to use */
@@ -96,33 +167,6 @@ type Provider = (new (...args: any[]) => any) | (ValueProvider & {
  */
 type Providers = (Provider | Providers)[];
 
-/**
- * Context class for managing dependency injection state
- * @module @signe/di/context
- */
-/**
- * Stores and manages the state of injected dependencies
- * @template TState - Type for the state
- * @template TActions - Type for the actions
- * @template TValues - Type for additional values
- */
-declare class Context<TState = any, TActions = any, TValues extends Record<string, any> = Record<string, any>> {
-    /** Internal storage for injected values */
-    private values;
-    /**
-     * Sets a value in the context
-     * @param key - Unique identifier for the value
-     * @param value - Value to store
-     */
-    set<K extends keyof TValues>(key: K, value: TValues[K]): void;
-    /**
-     * Retrieves a value from the context
-     * @param key - Unique identifier for the value
-     * @returns The stored value or undefined if not found
-     */
-    get<K extends keyof TValues>(key: K): TValues[K];
-}
-
 /**
  * Core functionality for dependency injection
  * @module @signe/di/inject
@@ -132,35 +176,43 @@ declare class Context<TState = any, TActions = any, TValues extends Record<strin
  * Provides a value to the dependency injection context
  * @template T - Type of the value being provided
  * @param context - The injection context
- * @param name - Identifier for the provided value
+ * @param token - Identifier for the provided value
  * @param value - The value to provide
+ * @param options - Configuration options for the provided value
  * @returns The provided value
  */
-declare function provide<T>(context: Context, name: string, value: T): T;
+declare function provide<T>(context: Context, token: ProviderToken | string, value: T, options?: ProvideOptions): T;
 /**
  * Checks if a service has been injected into the context
  * @param context - The injection context
- * @param name - Name of the service to check
+ * @param token - Token of the service to check
+ * @param options - Optional lookup configuration
  * @returns True if the service has been injected, false otherwise
  */
-declare function isInjected(context: Context, name: string): boolean;
+declare function isInjected(context: Context, token: ProviderToken | string, options?: InstanceLookupOptions): boolean;
 /**
  * Checks if a service has been provided in the context
  * @param context - The injection context
- * @param name - Name of the service to check
+ * @param token - Token of the service to check
+ * @param options - Optional lookup configuration
  * @returns True if the service has been provided, false otherwise
  */
-declare function isProvided(context: Context, name: string): boolean;
+declare function isProvided(context: Context, token: ProviderToken | string, options?: InstanceLookupOptions): boolean;
 /**
- * Retrieves a service from the dependency injection context
- * @template T - Type of the service to inject
+ * Checks if an instance exists in the context
  * @param context - The injection context
- * @param service - Class constructor or string identifier of the service
- * @param args - Optional arguments for service instantiation
- * @returns The injected service instance
- * @throws {Error} If the requested service is not found in the context
+ * @param token - Token of the service to check
+ * @param options - Optional lookup configuration
+ * @returns True if the instance exists, false otherwise
  */
-declare function inject<T>(context: Context, service: (new (...args: any[]) => T) | string, args?: any[]): T;
+declare function hasInstance(context: Context, token: ProviderToken | string, options?: InstanceLookupOptions): boolean;
+declare function inject<T>(context: Context, token: ProviderToken | string, options: InjectionOptions & {
+    multi: true;
+}): T[];
+declare function inject<T>(context: Context, token: ProviderToken | string, options: InjectionOptions & {
+    optional: true;
+}): T | undefined;
+declare function inject<T>(context: Context, token: ProviderToken | string, options?: InjectionOptions): T;
 /**
  * Overrides or adds a provider in the providers array
  * @param providers - Array of existing providers
@@ -242,4 +294,4 @@ declare function mergeConfig(baseConfig: AppConfig, config: AppConfig): AppConfi
  */
 declare function injector(context: Context, providers: Providers): Promise<void>;
 
-export { type AppConfig, type ClassProvider, Context, type ExistingProvider, type FactoryFn, type FactoryProvider, type Provider, type ProviderContext, type ProviderMeta, type ProviderToken, type Providers, type ValueProvider, findProvider, findProviders, inject, injector, isInjected, isProvided, mergeConfig, override, provide };
+export { type AppConfig, type ClassProvider, Context, type ExistingProvider, type FactoryFn, type FactoryProvider, type InjectionOptions, type InstanceLookupOptions, type ProvideOptions, type Provider, type ProviderContext, type ProviderMeta, type ProviderOptions, type ProviderToken, type Providers, type ValueProvider, findProvider, findProviders, hasInstance, inject, injector, isInjected, isProvided, mergeConfig, override, provide };

package/dist/index.js

@@ -2,29 +2,136 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/inject.ts
-function provide(context, name, value) {
-  context.set("inject:" + name, value);
+var DEFAULT_INSTANCE_KEY = "__default__";
+function toTokenName(token) {
+  return typeof token === "function" ? token.name : token;
+}
+__name(toTokenName, "toTokenName");
+function toInstanceKey(name) {
+  return name ?? DEFAULT_INSTANCE_KEY;
+}
+__name(toInstanceKey, "toInstanceKey");
+function getRecord(context, token) {
+  return context.get("inject:" + toTokenName(token));
+}
+__name(getRecord, "getRecord");
+function ensureRecord(context, token) {
+  const key = "inject:" + toTokenName(token);
+  let record = context.get(key);
+  if (!record) {
+    record = {
+      multi: false,
+      values: /* @__PURE__ */ new Map(),
+      injected: /* @__PURE__ */ new Set()
+    };
+  }
+  context.set(key, record);
+  return record;
+}
+__name(ensureRecord, "ensureRecord");
+function provide(context, token, value, options = {}) {
+  const record = ensureRecord(context, token);
+  const instanceKey = toInstanceKey(options.name);
+  if (options.multi) {
+    record.multi = true;
+  }
+  if (!record.multi && instanceKey !== DEFAULT_INSTANCE_KEY) {
+    record.multi = true;
+  }
+  record.values.set(instanceKey, value);
   return value;
 }
 __name(provide, "provide");
-function isInjected(context, name) {
-  return context.get("injected:" + name) === true;
+function isInjected(context, token, options = {}) {
+  const record = getRecord(context, token);
+  if (!record) {
+    return false;
+  }
+  if (options.name) {
+    return record.injected.has(toInstanceKey(options.name));
+  }
+  if (record.multi) {
+    return record.injected.size > 0;
+  }
+  return record.injected.has(DEFAULT_INSTANCE_KEY);
 }
 __name(isInjected, "isInjected");
-function isProvided(context, name) {
-  return context.get("inject:" + name) !== void 0;
+function isProvided(context, token, options = {}) {
+  const record = getRecord(context, token);
+  if (!record) {
+    return false;
+  }
+  if (options.name) {
+    return record.values.has(toInstanceKey(options.name));
+  }
+  if (record.multi) {
+    return record.values.size > 0;
+  }
+  return record.values.has(DEFAULT_INSTANCE_KEY);
 }
 __name(isProvided, "isProvided");
-function inject(context, service, args = []) {
-  const isClass = typeof service === "function";
-  const name = isClass ? service.name : service;
-  const value = context.get("inject:" + name);
-  if (value) {
-    context.set("injected:" + name, true);
-    return value;
+function hasInstance(context, token, options = {}) {
+  return isProvided(context, token, options);
+}
+__name(hasInstance, "hasInstance");
+function handleMissingInjection(token, options) {
+  const name = toTokenName(token);
+  if (options.name) {
+    throw new Error(`Injection provider ${name} with name ${options.name} not found`);
   }
   throw new Error(`Injection provider ${name} not found`);
 }
+__name(handleMissingInjection, "handleMissingInjection");
+function markInjected(record, key) {
+  record.injected.add(key);
+}
+__name(markInjected, "markInjected");
+function markAllInjected(record) {
+  for (const key of record.values.keys()) {
+    record.injected.add(key);
+  }
+}
+__name(markAllInjected, "markAllInjected");
+function inject(context, token, options = {}) {
+  const record = getRecord(context, token);
+  if (!record) {
+    if (options.optional) {
+      return options.multi ? [] : void 0;
+    }
+    return handleMissingInjection(token, options);
+  }
+  if (options.name) {
+    const instanceKey = toInstanceKey(options.name);
+    if (!record.values.has(instanceKey)) {
+      if (options.optional) {
+        return void 0;
+      }
+      return handleMissingInjection(token, options);
+    }
+    const value2 = record.values.get(instanceKey);
+    markInjected(record, instanceKey);
+    return value2;
+  }
+  if (options.multi || record.multi) {
+    if (record.values.size === 0) {
+      if (options.optional) {
+        return [];
+      }
+      return handleMissingInjection(token, options);
+    }
+    markAllInjected(record);
+    return Array.from(record.values.values());
+  }
+  const value = record.values.get(DEFAULT_INSTANCE_KEY);
+  if (value === void 0) {
+    if (options.optional) {
+      return void 0;
+    }
+    return handleMissingInjection(token, options);
+  }
+  markInjected(record, DEFAULT_INSTANCE_KEY);
+  return value;
+}
 __name(inject, "inject");
 function override(providers, newProvider, options) {
   let { upsert = false, key } = options ?? {};
@@ -131,6 +238,20 @@ function mergeConfig(baseConfig, config) {
 __name(mergeConfig, "mergeConfig");
 
 // src/provider.ts
+function extractProvideOptions(source) {
+  if (!source) {
+    return void 0;
+  }
+  const { multi, name } = source;
+  if (multi === void 0 && name === void 0) {
+    return void 0;
+  }
+  return {
+    multi,
+    name
+  };
+}
+__name(extractProvideOptions, "extractProvideOptions");
 function getDeps(provider) {
   if (typeof provider === "function") {
     return provider.deps ?? [];
@@ -143,7 +264,14 @@ function sortProviders(providers) {
   const map = /* @__PURE__ */ new Map();
   for (const p of providers) {
     const token = tokenName(typeof p === "function" ? p : p.provide);
-    map.set(token, p);
+    const list = map.get(token);
+    if (list) {
+      list.push(p);
+    } else {
+      map.set(token, [
+        p
+      ]);
+    }
   }
   const result = [];
   const visited = /* @__PURE__ */ new Set();
@@ -155,13 +283,15 @@ function sortProviders(providers) {
       throw new Error(`Circular dependency detected for provider ${name}`);
     }
     stack.add(name);
-    const provider = map.get(name);
-    if (provider) {
-      for (const dep of getDeps(provider)) {
-        visit(dep);
+    const providersForToken = map.get(name);
+    if (providersForToken) {
+      for (const provider of providersForToken) {
+        for (const dep of getDeps(provider)) {
+          visit(dep);
+        }
+        result.push(provider);
       }
       visited.add(name);
-      result.push(provider);
     }
     stack.delete(name);
   }, "visit");
@@ -178,11 +308,15 @@ async function injector(context, providers) {
   for (const provider of providers) {
     let token;
     let instance;
+    let options;
     if (typeof provider === "function") {
       token = provider;
       instance = new provider(context);
+      const diOptions = extractProvideOptions(provider.diOptions ?? provider.di);
+      options = diOptions;
     } else {
       token = provider.provide;
+      options = extractProvideOptions(provider);
       const provideUserClass = provider.useClass;
       const isClass = typeof provideUserClass === "function";
       if (isClass) {
@@ -198,8 +332,7 @@ async function injector(context, providers) {
         instance = inject(context, provider.useExisting);
       }
     }
-    const name = typeof token === "function" ? token.name : token;
-    provide(context, name, instance);
+    provide(context, token, instance, options);
   }
 }
 __name(injector, "injector");
@@ -232,6 +365,7 @@ export {
   Context,
   findProvider,
   findProviders,
+  hasInstance,
   inject,
   injector,
   isInjected,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/inject.ts","../src/merge-config.ts","../src/provider.ts","../src/context.ts"],"sourcesContent":["/**\n * Core functionality for dependency injection\n * @module @signe/di/inject\n */\n\nimport { Provider, Providers } from \"./types\";\nimport { Context } from \"./context\";\n\n/**\n * Provides a value to the dependency injection context\n * @template T - Type of the value being provided\n * @param context - The injection context\n * @param name - Identifier for the provided value\n * @param value - The value to provide\n * @returns The provided value\n */\nexport function provide<T>(context: Context, name: string, value: T): T {\n  context.set(\"inject:\" + name, value);\n  return value;\n}\n\n/**\n * Checks if a service has been injected into the context\n * @param context - The injection context\n * @param name - Name of the service to check\n * @returns True if the service has been injected, false otherwise\n */\nexport function isInjected(context: Context, name: string): boolean {\n  return context.get('injected:' + name) === true;\n}\n\n/**\n * Checks if a service has been provided in the context\n * @param context - The injection context\n * @param name - Name of the service to check\n * @returns True if the service has been provided, false otherwise\n */\nexport function isProvided(context: Context, name: string): boolean {\n  return context.get('inject:' + name) !== undefined;\n}\n\n/**\n * Retrieves a service from the dependency injection context\n * @template T - Type of the service to inject\n * @param context - The injection context\n * @param service - Class constructor or string identifier of the service\n * @param args - Optional arguments for service instantiation\n * @returns The injected service instance\n * @throws {Error} If the requested service is not found in the context\n */\nexport function inject<T>(\n  context: Context,\n  service: (new (...args: any[]) => T) | string,\n  args: any[] = []\n): T {\n  const isClass = typeof service === \"function\";\n  const name = isClass ? service.name : service;\n  const value = context.get(\"inject:\" + name);\n  if (value) {\n    context.set('injected:' + name, true)\n    return value as T;\n  }\n  throw new Error(`Injection provider ${name} not found`);\n}\n\n/**\n * Overrides or adds a provider in the providers array\n * @param providers - Array of existing providers\n * @param newProvider - Provider to add or replace with\n * @param options - Configuration options\n * @param options.upsert - If true, adds the provider when not found\n * @param options.key - Custom key to identify the provider\n * @returns Updated array of providers\n */\nexport function override(\n  providers: Providers,\n  newProvider: Provider,\n  options?: {\n    upsert?: boolean,\n    key?: string\n  }\n) {\n  let { upsert = false, key } = options ?? {};\n  if (!key) {\n    key = (\n      typeof newProvider === \"function\" ? newProvider.name : newProvider.provide\n    ) as string;\n  }\n\n  // Flatten the providers array\n  const flatProviders = providers.flat();\n  \n  // Check if provider exists\n  const exists = flatProviders.some(provider => {\n    if (typeof provider === \"function\") {\n      return provider.name === key;\n    } else if (typeof provider === \"object\") {\n      return (provider as any).provide === key;\n    }\n    return false;\n  });\n\n  // Map and replace if found\n  const mappedProviders = flatProviders.map((provider) => {\n    if (typeof provider === \"function\" && provider.name === key) {\n      return newProvider;\n    } else if (typeof provider === \"object\" && (provider as any).provide === key) {\n      return newProvider;\n    }\n    return provider;\n  });\n\n  // If upsert is true and provider wasn't found, add it to the end\n  if (upsert && !exists) {\n    mappedProviders.push(newProvider);\n  }\n\n  return mappedProviders;\n}\n\n/**\n * Finds all providers matching the given name or pattern\n * @template T - Type of provider to return\n * @param providers - Array of providers to search\n * @param name - String or RegExp to match against provider names\n * @returns Array of matching providers\n */\nexport function findProviders<T extends Provider = Provider>(providers: Providers, name: string | RegExp): T[] {\n  const results: any[] = [];\n  \n  for (const provider of providers) {\n    if (Array.isArray(provider)) {\n      // Recursively search in nested arrays and concat results\n      results.push(...findProviders(provider, name));\n    } else if (findProvider(provider as any, name)) {\n      // Add matching provider to results\n      results.push(provider as T);\n    }\n  }\n  \n  return results;\n}\n\n/**\n * Finds the first provider matching the given name or pattern\n * @template T - Type of provider to return\n * @param providers - Array of providers to search\n * @param name - String or RegExp to match against provider names\n * @returns Matching provider or null if not found\n */\nexport function findProvider<T extends Provider = Provider>(providers: Providers, name: string | RegExp): T | null {\n  // Handle single provider case\n  if (!Array.isArray(providers)) {\n    if (typeof providers === \"object\" && 'provide' in providers) {\n      const provider = providers as any\n      const providerName = typeof provider.provide === \"function\"\n        ? provider.provide.name \n        : provider.provide;\n\n      if (name instanceof RegExp) {\n        if (name.test(providerName)) return providers as T;\n      } else {\n        if (providerName === name) return providers as T;\n      }\n    }\n    return null;\n  }\n\n  // Original array handling logic\n  for (const provider of providers) {\n    // If provider is an array, recursively search in it\n    if (Array.isArray(provider)) {\n      const found = findProvider(provider, name);\n      if (found) return found as T;\n      continue;\n    }\n\n    // Check object provider\n    if (typeof provider === \"object\" && 'provide' in provider) {\n      const providerName = typeof provider.provide === \"function\" \n        ? provider.provide.name \n        : provider.provide;\n\n      // Handle RegExp matching\n      if (name instanceof RegExp) {\n        if (name.test(providerName)) return provider as T;\n      } else {\n        // Handle exact string matching\n        if (providerName === name) return provider as T;\n      }\n    }\n  }\n  return null;\n}\n","/**\n * Configuration merging functionality for dependency injection\n * @module @signe/di/merge-config\n */\n\nimport { findProvider, override } from \"./inject\";\n\n/**\n * Application configuration interface\n */\nexport interface AppConfig {\n    /** Array of dependency providers */\n    providers: any[];\n    /** Optional static files configuration */\n    staticFiles?: {\n        /** Path to static files */\n        path: string;\n        /** Static file serving configuration */\n        serve: any;\n    }\n}\n\n/**\n * Process a provider or nested provider array and add it to the merged config\n * @param mergedConfig - Configuration being built\n * @param baseConfig - Original base configuration \n * @param provider - Provider or nested provider array to process\n */\nfunction processProvider(mergedConfig: AppConfig, baseConfig: AppConfig, provider: any) {\n    // Handle nested arrays of providers\n    if (Array.isArray(provider)) {\n        for (const nestedProvider of provider) {\n            processProvider(mergedConfig, baseConfig, nestedProvider);\n        }\n        return;\n    }\n\n    // Handle individual provider\n    const existingProvider = findProvider(baseConfig.providers, provider.provide);\n    if (existingProvider) {\n        // Replace existing provider\n        mergedConfig.providers = override(mergedConfig.providers, provider);\n    } else {\n        // Add new provider\n        mergedConfig.providers.push(provider);\n    }\n}\n\n/**\n * Merges two application configurations\n * @param baseConfig - Base configuration to merge into\n * @param config - Configuration to merge with base\n * @returns Merged configuration with providers properly combined\n */\nexport function mergeConfig(baseConfig: AppConfig, config: AppConfig): AppConfig {\n    // Create a new config object with everything except providers\n    const mergedConfig: AppConfig = {\n        ...baseConfig,\n        ...config,\n        providers: [...baseConfig.providers] // Start with a copy of base providers\n    }\n\n    // Process each provider from the config to merge\n    for (const provider of config.providers) {\n        processProvider(mergedConfig, baseConfig, provider);\n    }\n\n    return mergedConfig;\n}\n","/**\n * Provider system implementation for dependency injection\n * @module @signe/di/provider\n */\n\nimport { ClassProvider, Provider, Providers, ProviderToken } from \"./types\";\nimport { inject, provide } from \"./inject\";\nimport { Context } from \"./context\";\n\n/**\n * Type guard to check if a provider is a ClassProvider\n * @param provider - Provider to check\n * @returns True if the provider is a ClassProvider\n */\nfunction isClassProvider(provider: Provider): provider is ClassProvider {\n    if (typeof provider === 'string') {\n        return false;\n    }\n    return 'useClass' in provider && typeof provider.useClass === 'function';\n}\n\n/**\n * Retrieves dependencies declared on a provider\n * @param provider - Provider to inspect\n * @returns Array of provider tokens this provider depends on\n */\nfunction getDeps(provider: Provider): ProviderToken[] {\n    if (typeof provider === 'function') {\n        return (provider as any).deps ?? [];\n    }\n    return (provider as any).deps ?? [];\n}\n\n/**\n * Sorts providers so that dependencies are instantiated first\n * @param providers - Array of providers to sort\n * @throws When a circular dependency is detected\n */\nfunction sortProviders(providers: Provider[]): Provider[] {\n    const tokenName = (t: ProviderToken) => typeof t === 'function' ? t.name : t;\n    const map = new Map<string, Provider>();\n    for (const p of providers) {\n        const token = tokenName(typeof p === 'function' ? p : (p as any).provide);\n        map.set(token, p);\n    }\n\n    const result: Provider[] = [];\n    const visited = new Set<string>();\n    const stack = new Set<string>();\n\n    const visit = (token: ProviderToken) => {\n        const name = tokenName(token);\n        if (visited.has(name)) return;\n        if (stack.has(name)) {\n            throw new Error(`Circular dependency detected for provider ${name}`);\n        }\n        stack.add(name);\n        const provider = map.get(name);\n        if (provider) {\n            for (const dep of getDeps(provider)) {\n                visit(dep);\n            }\n            visited.add(name);\n            result.push(provider);\n        }\n        stack.delete(name);\n    };\n\n    for (const p of providers) {\n        const token = typeof p === 'function' ? p : (p as any).provide;\n        visit(token);\n    }\n\n    return result;\n}\n\n/**\n * Processes and instantiates all providers in the given context\n * @param context - The injection context\n * @param providers - Array of providers to process\n * @returns Promise that resolves when all providers are processed\n * \n * @example\n * ```typescript\n * const context = new Context();\n * const providers = [\n *   UserService,\n *   { provide: 'CONFIG', useValue: { apiUrl: 'http://api.example.com' } },\n *   { provide: AuthService, useFactory: (ctx) => new AuthService(ctx) }\n * ];\n * \n * await injector(context, providers);\n * ```\n */\nexport async function injector(context: Context, providers: Providers) {\n    providers = providers.flat();\n    providers = sortProviders(providers as Provider[]);\n\n    for (const provider of providers) {\n        let token: ProviderToken;\n        let instance: any;\n\n        if (typeof provider === 'function') {\n            // If provider is a class, treat it as a ClassProvider\n            token = provider;\n            instance = new provider(context);\n        } else {\n            token = (provider as any).provide;\n            const provideUserClass = (provider as any).useClass;\n            const isClass = typeof provideUserClass === 'function';\n            if (isClass) {\n                instance = new provideUserClass(context);\n            } else if ('useValue' in provider) {\n                instance = provider.useValue;\n            } else if ('useFactory' in provider) {\n                instance = provider.useFactory?.(context);\n                if (instance instanceof Promise) {\n                    instance = await instance;\n                }\n            } else if ('useExisting' in provider) {\n                instance = inject(context, provider.useExisting);\n            }\n        }\n\n        const name = typeof token === 'function' ? token.name : token;\n        provide(context, name, instance);\n    }\n}","/**\n * Context class for managing dependency injection state\n * @module @signe/di/context\n */\n\n/**\n * Stores and manages the state of injected dependencies\n * @template TState - Type for the state\n * @template TActions - Type for the actions\n * @template TValues - Type for additional values\n */\nexport class Context<\n    TState = any,\n    TActions = any,\n    TValues extends Record<string, any> = Record<string, any>\n> {\n    /** Internal storage for injected values */\n    private values: TValues = {} as TValues\n\n    /**\n     * Sets a value in the context\n     * @param key - Unique identifier for the value\n     * @param value - Value to store\n     */\n    set<K extends keyof TValues>(key: K, value: TValues[K]) {\n        this.values[key] = value\n    }\n\n    /**\n     * Retrieves a value from the context\n     * @param key - Unique identifier for the value\n     * @returns The stored value or undefined if not found\n     */\n    get<K extends keyof TValues>(key: K): TValues[K] {\n        return this.values[key]\n    }\n}"],"mappings":"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","names":["provide","context","name","value","set","isInjected","get","isProvided","undefined","inject","service","args","isClass","Error","override","providers","newProvider","options","upsert","key","flatProviders","flat","exists","some","provider","mappedProviders","map","push","findProviders","results","Array","isArray","findProvider","providerName","RegExp","test","found","processProvider","mergedConfig","baseConfig","provider","Array","isArray","nestedProvider","existingProvider","findProvider","providers","provide","override","push","mergeConfig","config","getDeps","provider","deps","sortProviders","providers","tokenName","t","name","map","Map","p","token","provide","set","result","visited","Set","stack","visit","has","Error","add","get","dep","push","delete","injector","context","flat","instance","provideUserClass","useClass","isClass","useValue","useFactory","Promise","inject","useExisting","Context","values","set","key","value","get"]}
+{"version":3,"sources":["../src/inject.ts","../src/merge-config.ts","../src/provider.ts","../src/context.ts"],"sourcesContent":["/**\n * Core functionality for dependency injection\n * @module @signe/di/inject\n */\n\nimport { Context } from \"./context\";\nimport {\n  InjectionOptions,\n  InstanceLookupOptions,\n  ProvideOptions,\n  Provider,\n  ProviderToken,\n  Providers\n} from \"./types\";\n\nconst DEFAULT_INSTANCE_KEY = \"__default__\";\n\ninterface ProviderRecord {\n  multi: boolean;\n  values: Map<string, any>;\n  injected: Set<string>;\n}\n\nfunction toTokenName(token: ProviderToken | string): string {\n  return typeof token === \"function\" ? token.name : token;\n}\n\nfunction toInstanceKey(name?: string): string {\n  return name ?? DEFAULT_INSTANCE_KEY;\n}\n\nfunction getRecord(context: Context, token: ProviderToken | string): ProviderRecord | undefined {\n  return context.get(\"inject:\" + toTokenName(token));\n}\n\nfunction ensureRecord(context: Context, token: ProviderToken | string): ProviderRecord {\n  const key = \"inject:\" + toTokenName(token);\n  let record = context.get(key) as ProviderRecord | undefined;\n  if (!record) {\n    record = {\n      multi: false,\n      values: new Map<string, any>(),\n      injected: new Set<string>()\n    };\n  }\n  context.set(key, record);\n  return record;\n}\n\n/**\n * Provides a value to the dependency injection context\n * @template T - Type of the value being provided\n * @param context - The injection context\n * @param token - Identifier for the provided value\n * @param value - The value to provide\n * @param options - Configuration options for the provided value\n * @returns The provided value\n */\nexport function provide<T>(\n  context: Context,\n  token: ProviderToken | string,\n  value: T,\n  options: ProvideOptions = {}\n): T {\n  const record = ensureRecord(context, token);\n  const instanceKey = toInstanceKey(options.name);\n\n  if (options.multi) {\n    record.multi = true;\n  }\n\n  if (!record.multi && instanceKey !== DEFAULT_INSTANCE_KEY) {\n    // If we are switching from single to named instance without multi, enable multi mode implicitly\n    record.multi = true;\n  }\n\n  record.values.set(instanceKey, value);\n  return value;\n}\n\n/**\n * Checks if a service has been injected into the context\n * @param context - The injection context\n * @param token - Token of the service to check\n * @param options - Optional lookup configuration\n * @returns True if the service has been injected, false otherwise\n */\nexport function isInjected(\n  context: Context,\n  token: ProviderToken | string,\n  options: InstanceLookupOptions = {}\n): boolean {\n  const record = getRecord(context, token);\n  if (!record) {\n    return false;\n  }\n\n  if (options.name) {\n    return record.injected.has(toInstanceKey(options.name));\n  }\n\n  if (record.multi) {\n    return record.injected.size > 0;\n  }\n\n  return record.injected.has(DEFAULT_INSTANCE_KEY);\n}\n\n/**\n * Checks if a service has been provided in the context\n * @param context - The injection context\n * @param token - Token of the service to check\n * @param options - Optional lookup configuration\n * @returns True if the service has been provided, false otherwise\n */\nexport function isProvided(\n  context: Context,\n  token: ProviderToken | string,\n  options: InstanceLookupOptions = {}\n): boolean {\n  const record = getRecord(context, token);\n  if (!record) {\n    return false;\n  }\n\n  if (options.name) {\n    return record.values.has(toInstanceKey(options.name));\n  }\n\n  if (record.multi) {\n    return record.values.size > 0;\n  }\n\n  return record.values.has(DEFAULT_INSTANCE_KEY);\n}\n\n/**\n * Checks if an instance exists in the context\n * @param context - The injection context\n * @param token - Token of the service to check\n * @param options - Optional lookup configuration\n * @returns True if the instance exists, false otherwise\n */\nexport function hasInstance(\n  context: Context,\n  token: ProviderToken | string,\n  options: InstanceLookupOptions = {}\n): boolean {\n  return isProvided(context, token, options);\n}\n\nfunction handleMissingInjection(\n  token: ProviderToken | string,\n  options: InjectionOptions\n): never {\n  const name = toTokenName(token);\n  if (options.name) {\n    throw new Error(`Injection provider ${name} with name ${options.name} not found`);\n  }\n  throw new Error(`Injection provider ${name} not found`);\n}\n\nfunction markInjected(record: ProviderRecord, key: string) {\n  record.injected.add(key);\n}\n\nfunction markAllInjected(record: ProviderRecord) {\n  for (const key of record.values.keys()) {\n    record.injected.add(key);\n  }\n}\n\nexport function inject<T>(context: Context, token: ProviderToken | string, options: InjectionOptions & { multi: true }): T[];\nexport function inject<T>(context: Context, token: ProviderToken | string, options: InjectionOptions & { optional: true }): T | undefined;\nexport function inject<T>(context: Context, token: ProviderToken | string, options?: InjectionOptions): T;\n/**\n * Retrieves a service from the dependency injection context\n * @template T - Type of the service to inject\n * @param context - The injection context\n * @param token - Class constructor or string identifier of the service\n * @param options - Optional configuration for resolving the service\n * @returns The injected service instance or `undefined` when optional\n * @throws {Error} If the requested service is not found in the context\n */\nexport function inject<T>(\n  context: Context,\n  token: ProviderToken | string,\n  options: InjectionOptions = {}\n): T | T[] | undefined {\n  const record = getRecord(context, token);\n\n  if (!record) {\n    if (options.optional) {\n      return options.multi ? [] : undefined;\n    }\n    return handleMissingInjection(token, options);\n  }\n\n  if (options.name) {\n    const instanceKey = toInstanceKey(options.name);\n    if (!record.values.has(instanceKey)) {\n      if (options.optional) {\n        return undefined;\n      }\n      return handleMissingInjection(token, options);\n    }\n    const value = record.values.get(instanceKey);\n    markInjected(record, instanceKey);\n    return value as T;\n  }\n\n  if (options.multi || record.multi) {\n    if (record.values.size === 0) {\n      if (options.optional) {\n        return [];\n      }\n      return handleMissingInjection(token, options);\n    }\n    markAllInjected(record);\n    return Array.from(record.values.values()) as T[];\n  }\n\n  const value = record.values.get(DEFAULT_INSTANCE_KEY);\n  if (value === undefined) {\n    if (options.optional) {\n      return undefined;\n    }\n    return handleMissingInjection(token, options);\n  }\n\n  markInjected(record, DEFAULT_INSTANCE_KEY);\n  return value as T;\n}\n\n/**\n * Overrides or adds a provider in the providers array\n * @param providers - Array of existing providers\n * @param newProvider - Provider to add or replace with\n * @param options - Configuration options\n * @param options.upsert - If true, adds the provider when not found\n * @param options.key - Custom key to identify the provider\n * @returns Updated array of providers\n */\nexport function override(\n  providers: Providers,\n  newProvider: Provider,\n  options?: {\n    upsert?: boolean,\n    key?: string\n  }\n) {\n  let { upsert = false, key } = options ?? {};\n  if (!key) {\n    key = (\n      typeof newProvider === \"function\" ? newProvider.name : newProvider.provide\n    ) as string;\n  }\n\n  // Flatten the providers array\n  const flatProviders = providers.flat();\n\n  // Check if provider exists\n  const exists = flatProviders.some(provider => {\n    if (typeof provider === \"function\") {\n      return provider.name === key;\n    } else if (typeof provider === \"object\") {\n      return (provider as any).provide === key;\n    }\n    return false;\n  });\n\n  // Map and replace if found\n  const mappedProviders = flatProviders.map((provider) => {\n    if (typeof provider === \"function\" && provider.name === key) {\n      return newProvider;\n    } else if (typeof provider === \"object\" && (provider as any).provide === key) {\n      return newProvider;\n    }\n    return provider;\n  });\n\n  // If upsert is true and provider wasn't found, add it to the end\n  if (upsert && !exists) {\n    mappedProviders.push(newProvider);\n  }\n\n  return mappedProviders;\n}\n\n/**\n * Finds all providers matching the given name or pattern\n * @template T - Type of provider to return\n * @param providers - Array of providers to search\n * @param name - String or RegExp to match against provider names\n * @returns Array of matching providers\n */\nexport function findProviders<T extends Provider = Provider>(providers: Providers, name: string | RegExp): T[] {\n  const results: any[] = [];\n\n  for (const provider of providers) {\n    if (Array.isArray(provider)) {\n      // Recursively search in nested arrays and concat results\n      results.push(...findProviders(provider, name));\n    } else if (findProvider(provider as any, name)) {\n      // Add matching provider to results\n      results.push(provider as T);\n    }\n  }\n\n  return results;\n}\n\n/**\n * Finds the first provider matching the given name or pattern\n * @template T - Type of provider to return\n * @param providers - Array of providers to search\n * @param name - String or RegExp to match against provider names\n * @returns Matching provider or null if not found\n */\nexport function findProvider<T extends Provider = Provider>(providers: Providers, name: string | RegExp): T | null {\n  // Handle single provider case\n  if (!Array.isArray(providers)) {\n    if (typeof providers === \"object\" && 'provide' in providers) {\n      const provider = providers as any\n      const providerName = typeof provider.provide === \"function\"\n        ? provider.provide.name\n        : provider.provide;\n\n      if (name instanceof RegExp) {\n        if (name.test(providerName)) return providers as T;\n      } else {\n        if (providerName === name) return providers as T;\n      }\n    }\n    return null;\n  }\n\n  // Original array handling logic\n  for (const provider of providers) {\n    // If provider is an array, recursively search in it\n    if (Array.isArray(provider)) {\n      const found = findProvider(provider, name);\n      if (found) return found as T;\n      continue;\n    }\n\n    // Check object provider\n    if (typeof provider === \"object\" && 'provide' in provider) {\n      const providerName = typeof provider.provide === \"function\"\n        ? provider.provide.name\n        : provider.provide;\n\n      // Handle RegExp matching\n      if (name instanceof RegExp) {\n        if (name.test(providerName)) return provider as T;\n      } else {\n        // Handle exact string matching\n        if (providerName === name) return provider as T;\n      }\n    }\n  }\n  return null;\n}\n","/**\n * Configuration merging functionality for dependency injection\n * @module @signe/di/merge-config\n */\n\nimport { findProvider, override } from \"./inject\";\n\n/**\n * Application configuration interface\n */\nexport interface AppConfig {\n    /** Array of dependency providers */\n    providers: any[];\n    /** Optional static files configuration */\n    staticFiles?: {\n        /** Path to static files */\n        path: string;\n        /** Static file serving configuration */\n        serve: any;\n    }\n}\n\n/**\n * Process a provider or nested provider array and add it to the merged config\n * @param mergedConfig - Configuration being built\n * @param baseConfig - Original base configuration \n * @param provider - Provider or nested provider array to process\n */\nfunction processProvider(mergedConfig: AppConfig, baseConfig: AppConfig, provider: any) {\n    // Handle nested arrays of providers\n    if (Array.isArray(provider)) {\n        for (const nestedProvider of provider) {\n            processProvider(mergedConfig, baseConfig, nestedProvider);\n        }\n        return;\n    }\n\n    // Handle individual provider\n    const existingProvider = findProvider(baseConfig.providers, provider.provide);\n    if (existingProvider) {\n        // Replace existing provider\n        mergedConfig.providers = override(mergedConfig.providers, provider);\n    } else {\n        // Add new provider\n        mergedConfig.providers.push(provider);\n    }\n}\n\n/**\n * Merges two application configurations\n * @param baseConfig - Base configuration to merge into\n * @param config - Configuration to merge with base\n * @returns Merged configuration with providers properly combined\n */\nexport function mergeConfig(baseConfig: AppConfig, config: AppConfig): AppConfig {\n    // Create a new config object with everything except providers\n    const mergedConfig: AppConfig = {\n        ...baseConfig,\n        ...config,\n        providers: [...baseConfig.providers] // Start with a copy of base providers\n    }\n\n    // Process each provider from the config to merge\n    for (const provider of config.providers) {\n        processProvider(mergedConfig, baseConfig, provider);\n    }\n\n    return mergedConfig;\n}\n","/**\n * Provider system implementation for dependency injection\n * @module @signe/di/provider\n */\n\nimport { ClassProvider, ProvideOptions, Provider, Providers, ProviderToken } from \"./types\";\nimport { inject, provide } from \"./inject\";\nimport { Context } from \"./context\";\n\nfunction extractProvideOptions(source: { multi?: boolean; name?: string } | undefined): ProvideOptions | undefined {\n    if (!source) {\n        return undefined;\n    }\n\n    const { multi, name } = source;\n    if (multi === undefined && name === undefined) {\n        return undefined;\n    }\n\n    return { multi, name };\n}\n\n/**\n * Type guard to check if a provider is a ClassProvider\n * @param provider - Provider to check\n * @returns True if the provider is a ClassProvider\n */\nfunction isClassProvider(provider: Provider): provider is ClassProvider {\n    if (typeof provider === 'string') {\n        return false;\n    }\n    return 'useClass' in provider && typeof provider.useClass === 'function';\n}\n\n/**\n * Retrieves dependencies declared on a provider\n * @param provider - Provider to inspect\n * @returns Array of provider tokens this provider depends on\n */\nfunction getDeps(provider: Provider): ProviderToken[] {\n    if (typeof provider === 'function') {\n        return (provider as any).deps ?? [];\n    }\n    return (provider as any).deps ?? [];\n}\n\n/**\n * Sorts providers so that dependencies are instantiated first\n * @param providers - Array of providers to sort\n * @throws When a circular dependency is detected\n */\nfunction sortProviders(providers: Provider[]): Provider[] {\n    const tokenName = (t: ProviderToken) => typeof t === 'function' ? t.name : t;\n    const map = new Map<string, Provider[]>();\n    for (const p of providers) {\n        const token = tokenName(typeof p === 'function' ? p : (p as any).provide);\n        const list = map.get(token);\n        if (list) {\n            list.push(p);\n        } else {\n            map.set(token, [p]);\n        }\n    }\n\n    const result: Provider[] = [];\n    const visited = new Set<string>();\n    const stack = new Set<string>();\n\n    const visit = (token: ProviderToken) => {\n        const name = tokenName(token);\n        if (visited.has(name)) return;\n        if (stack.has(name)) {\n            throw new Error(`Circular dependency detected for provider ${name}`);\n        }\n        stack.add(name);\n        const providersForToken = map.get(name);\n        if (providersForToken) {\n            for (const provider of providersForToken) {\n                for (const dep of getDeps(provider)) {\n                    visit(dep);\n                }\n                result.push(provider);\n            }\n            visited.add(name);\n        }\n        stack.delete(name);\n    };\n\n    for (const p of providers) {\n        const token = typeof p === 'function' ? p : (p as any).provide;\n        visit(token);\n    }\n\n    return result;\n}\n\n/**\n * Processes and instantiates all providers in the given context\n * @param context - The injection context\n * @param providers - Array of providers to process\n * @returns Promise that resolves when all providers are processed\n * \n * @example\n * ```typescript\n * const context = new Context();\n * const providers = [\n *   UserService,\n *   { provide: 'CONFIG', useValue: { apiUrl: 'http://api.example.com' } },\n *   { provide: AuthService, useFactory: (ctx) => new AuthService(ctx) }\n * ];\n * \n * await injector(context, providers);\n * ```\n */\nexport async function injector(context: Context, providers: Providers) {\n    providers = providers.flat();\n    providers = sortProviders(providers as Provider[]);\n\n    for (const provider of providers) {\n        let token: ProviderToken;\n        let instance: any;\n        let options: ProvideOptions | undefined;\n\n        if (typeof provider === 'function') {\n            // If provider is a class, treat it as a ClassProvider\n            token = provider;\n            instance = new provider(context);\n            const diOptions = extractProvideOptions((provider as any).diOptions ?? (provider as any).di);\n            options = diOptions;\n        } else {\n            token = (provider as any).provide;\n            options = extractProvideOptions(provider as any);\n            const provideUserClass = (provider as any).useClass;\n            const isClass = typeof provideUserClass === 'function';\n            if (isClass) {\n                instance = new provideUserClass(context);\n            } else if ('useValue' in provider) {\n                instance = provider.useValue;\n            } else if ('useFactory' in provider) {\n                instance = provider.useFactory?.(context);\n                if (instance instanceof Promise) {\n                    instance = await instance;\n                }\n            } else if ('useExisting' in provider) {\n                instance = inject(context, provider.useExisting);\n            }\n        }\n\n        provide(context, token, instance, options);\n    }\n}","/**\n * Context class for managing dependency injection state\n * @module @signe/di/context\n */\n\n/**\n * Stores and manages the state of injected dependencies\n * @template TState - Type for the state\n * @template TActions - Type for the actions\n * @template TValues - Type for additional values\n */\nexport class Context<\n    TState = any,\n    TActions = any,\n    TValues extends Record<string, any> = Record<string, any>\n> {\n    /** Internal storage for injected values */\n    private values: TValues = {} as TValues\n\n    /**\n     * Sets a value in the context\n     * @param key - Unique identifier for the value\n     * @param value - Value to store\n     */\n    set<K extends keyof TValues>(key: K, value: TValues[K]) {\n        this.values[key] = value\n    }\n\n    /**\n     * Retrieves a value from the context\n     * @param key - Unique identifier for the value\n     * @returns The stored value or undefined if not found\n     */\n    get<K extends keyof TValues>(key: K): TValues[K] {\n        return this.values[key]\n    }\n}"],"mappings":"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","names":["DEFAULT_INSTANCE_KEY","toTokenName","token","name","toInstanceKey","getRecord","context","get","ensureRecord","key","record","multi","values","Map","injected","Set","set","provide","value","options","instanceKey","isInjected","has","size","isProvided","hasInstance","handleMissingInjection","Error","markInjected","add","markAllInjected","keys","inject","optional","undefined","Array","from","override","providers","newProvider","upsert","flatProviders","flat","exists","some","provider","mappedProviders","map","push","findProviders","results","isArray","findProvider","providerName","RegExp","test","found","processProvider","mergedConfig","baseConfig","provider","Array","isArray","nestedProvider","existingProvider","findProvider","providers","provide","override","push","mergeConfig","config","extractProvideOptions","source","undefined","multi","name","getDeps","provider","deps","sortProviders","providers","tokenName","t","name","map","Map","p","token","provide","list","get","push","set","result","visited","Set","stack","visit","has","Error","add","providersForToken","dep","delete","injector","context","flat","instance","options","diOptions","extractProvideOptions","di","provideUserClass","useClass","isClass","useValue","useFactory","Promise","inject","useExisting","Context","values","set","key","value","get"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signe/di",
-  "version": "2.4.6",
+  "version": "2.5.0",
   "description": "",
   "main": "./dist/index.js",
   "exports": {

package/readme.md

@@ -20,13 +20,15 @@ pnpm add @signe/di
 - Context-based injection
 - Override capabilities for testing and customization
 - Support for nested providers
+- Optional injection resolution helpers
+- Support for multiple named instances per token
 
 ## Usage
 
 ### Basic Usage
 
 ```typescript
-import { provide, inject, Context, Providers } from '@signe/di';
+import { provide, inject, Context, Providers, injector } from '@signe/di';
 
 const context = new Context();
 
@@ -57,8 +59,8 @@ const providers: Providers = [
   }
 ];
 
-// Provide the service
-provide(context, providers);
+// Register the services
+await injector(context, providers);
 
 // Inject and use the service
 const userService = inject(context, UserService);
@@ -83,6 +85,36 @@ const updatedProviders = override(providers, {
 }, { upsert: true });
 ```
 
+### Optional injection
+
+```typescript
+import { inject } from '@signe/di';
+
+const maybeService = inject(context, 'UNKNOWN_SERVICE', { optional: true });
+if (!maybeService) {
+  // Handle missing service without throwing an exception
+}
+```
+
+### Multiple named instances
+
+```typescript
+import { provide, inject } from '@signe/di';
+
+provide(context, UserService, new UserService('primary'), {
+  multi: true,
+  name: 'primary'
+});
+
+provide(context, UserService, new UserService('secondary'), {
+  multi: true,
+  name: 'secondary'
+});
+
+const allInstances = inject<UserService>(context, UserService, { multi: true });
+const secondary = inject<UserService>(context, UserService, { name: 'secondary' });
+```
+
 ### Check Injection Status
 
 ```typescript
@@ -93,6 +125,68 @@ if (isInjected(context, UserService)) {
 }
 ```
 
+### Dependency Declaration
+
+You can declare dependencies using the `deps` property. The injector will automatically sort providers to ensure dependencies are instantiated before the services that need them.
+
+```typescript
+import { provide, inject, Context, Providers, injector } from '@signe/di';
+
+const context = new Context();
+
+class DatabaseService {
+  connect() {
+    return 'Connected to database';
+  }
+}
+
+class UserRepository {
+  constructor(context: Context) {
+    this.db = inject(context, DatabaseService);
+  }
+  
+  static deps = [DatabaseService];
+}
+
+class UserService {
+  constructor(context: Context) {
+    this.repository = inject(context, UserRepository);
+  }
+  
+  static deps = [UserRepository];
+}
+
+const providers: Providers = [
+  UserService,
+  UserRepository,
+  DatabaseService
+];
+
+// The injector will automatically sort: DatabaseService -> UserRepository -> UserService
+await injector(context, providers);
+```
+
+You can also declare dependencies on provider objects:
+
+```typescript
+const providers: Providers = [
+  {
+    provide: 'API_CLIENT',
+    useFactory: (context) => {
+      const config = inject(context, 'CONFIG');
+      return new ApiClient(config);
+    },
+    deps: ['CONFIG']
+  },
+  {
+    provide: 'CONFIG',
+    useValue: { apiUrl: 'https://api.example.com' }
+  }
+];
+```
+
+**Note:** The injector will detect and throw an error if circular dependencies are found.
+
 ### Find Providers
 
 ```typescript
@@ -107,14 +201,27 @@ const allServices = findProviders(providers, /Service$/);
 
 ## API Reference
 
-### `provide(context, key, value)`
+### `provide(context, token, value, options?)`
 Stores a value in the context for dependency injection.
 
-### `inject(context, key)`
+- `options.multi` — When `true`, allows multiple instances for the same token
+- `options.name` — Registers the instance under a specific name
+
+### `inject(context, token, options?)`
 Retrieves an injected value from the context.
 
-### `isInjected(context, key)`
-Checks if a value has been injected.
+- `options.optional` — Returns `undefined`/`[]` instead of throwing when missing
+- `options.multi` — Returns all registered instances as an array
+- `options.name` — Retrieves a specific named instance
+
+### `isInjected(context, token, options?)`
+Checks if a value has been injected. Supports named lookups via the `name` option.
+
+### `isProvided(context, token, options?)`
+Checks if a value has been registered in the context.
+
+### `hasInstance(context, token, options?)`
+Alias of `isProvided`, kept for readability when checking for instance existence.
 
 ### `override(providers, newProvider, options?)`
 Overrides or adds new providers to the existing provider array.

package/src/inject.ts

@@ -3,64 +3,233 @@
  * @module @signe/di/inject
  */
 
-import { Provider, Providers } from "./types";
 import { Context } from "./context";
+import {
+  InjectionOptions,
+  InstanceLookupOptions,
+  ProvideOptions,
+  Provider,
+  ProviderToken,
+  Providers
+} from "./types";
+
+const DEFAULT_INSTANCE_KEY = "__default__";
+
+interface ProviderRecord {
+  multi: boolean;
+  values: Map<string, any>;
+  injected: Set<string>;
+}
+
+function toTokenName(token: ProviderToken | string): string {
+  return typeof token === "function" ? token.name : token;
+}
+
+function toInstanceKey(name?: string): string {
+  return name ?? DEFAULT_INSTANCE_KEY;
+}
+
+function getRecord(context: Context, token: ProviderToken | string): ProviderRecord | undefined {
+  return context.get("inject:" + toTokenName(token));
+}
+
+function ensureRecord(context: Context, token: ProviderToken | string): ProviderRecord {
+  const key = "inject:" + toTokenName(token);
+  let record = context.get(key) as ProviderRecord | undefined;
+  if (!record) {
+    record = {
+      multi: false,
+      values: new Map<string, any>(),
+      injected: new Set<string>()
+    };
+  }
+  context.set(key, record);
+  return record;
+}
 
 /**
  * Provides a value to the dependency injection context
  * @template T - Type of the value being provided
  * @param context - The injection context
- * @param name - Identifier for the provided value
+ * @param token - Identifier for the provided value
  * @param value - The value to provide
+ * @param options - Configuration options for the provided value
  * @returns The provided value
  */
-export function provide<T>(context: Context, name: string, value: T): T {
-  context.set("inject:" + name, value);
+export function provide<T>(
+  context: Context,
+  token: ProviderToken | string,
+  value: T,
+  options: ProvideOptions = {}
+): T {
+  const record = ensureRecord(context, token);
+  const instanceKey = toInstanceKey(options.name);
+
+  if (options.multi) {
+    record.multi = true;
+  }
+
+  if (!record.multi && instanceKey !== DEFAULT_INSTANCE_KEY) {
+    // If we are switching from single to named instance without multi, enable multi mode implicitly
+    record.multi = true;
+  }
+
+  record.values.set(instanceKey, value);
   return value;
 }
 
 /**
  * Checks if a service has been injected into the context
  * @param context - The injection context
- * @param name - Name of the service to check
+ * @param token - Token of the service to check
+ * @param options - Optional lookup configuration
  * @returns True if the service has been injected, false otherwise
  */
-export function isInjected(context: Context, name: string): boolean {
-  return context.get('injected:' + name) === true;
+export function isInjected(
+  context: Context,
+  token: ProviderToken | string,
+  options: InstanceLookupOptions = {}
+): boolean {
+  const record = getRecord(context, token);
+  if (!record) {
+    return false;
+  }
+
+  if (options.name) {
+    return record.injected.has(toInstanceKey(options.name));
+  }
+
+  if (record.multi) {
+    return record.injected.size > 0;
+  }
+
+  return record.injected.has(DEFAULT_INSTANCE_KEY);
 }
 
 /**
  * Checks if a service has been provided in the context
  * @param context - The injection context
- * @param name - Name of the service to check
+ * @param token - Token of the service to check
+ * @param options - Optional lookup configuration
  * @returns True if the service has been provided, false otherwise
  */
-export function isProvided(context: Context, name: string): boolean {
-  return context.get('inject:' + name) !== undefined;
+export function isProvided(
+  context: Context,
+  token: ProviderToken | string,
+  options: InstanceLookupOptions = {}
+): boolean {
+  const record = getRecord(context, token);
+  if (!record) {
+    return false;
+  }
+
+  if (options.name) {
+    return record.values.has(toInstanceKey(options.name));
+  }
+
+  if (record.multi) {
+    return record.values.size > 0;
+  }
+
+  return record.values.has(DEFAULT_INSTANCE_KEY);
+}
+
+/**
+ * Checks if an instance exists in the context
+ * @param context - The injection context
+ * @param token - Token of the service to check
+ * @param options - Optional lookup configuration
+ * @returns True if the instance exists, false otherwise
+ */
+export function hasInstance(
+  context: Context,
+  token: ProviderToken | string,
+  options: InstanceLookupOptions = {}
+): boolean {
+  return isProvided(context, token, options);
+}
+
+function handleMissingInjection(
+  token: ProviderToken | string,
+  options: InjectionOptions
+): never {
+  const name = toTokenName(token);
+  if (options.name) {
+    throw new Error(`Injection provider ${name} with name ${options.name} not found`);
+  }
+  throw new Error(`Injection provider ${name} not found`);
+}
+
+function markInjected(record: ProviderRecord, key: string) {
+  record.injected.add(key);
 }
 
+function markAllInjected(record: ProviderRecord) {
+  for (const key of record.values.keys()) {
+    record.injected.add(key);
+  }
+}
+
+export function inject<T>(context: Context, token: ProviderToken | string, options: InjectionOptions & { multi: true }): T[];
+export function inject<T>(context: Context, token: ProviderToken | string, options: InjectionOptions & { optional: true }): T | undefined;
+export function inject<T>(context: Context, token: ProviderToken | string, options?: InjectionOptions): T;
 /**
  * Retrieves a service from the dependency injection context
  * @template T - Type of the service to inject
  * @param context - The injection context
- * @param service - Class constructor or string identifier of the service
- * @param args - Optional arguments for service instantiation
- * @returns The injected service instance
+ * @param token - Class constructor or string identifier of the service
+ * @param options - Optional configuration for resolving the service
+ * @returns The injected service instance or `undefined` when optional
  * @throws {Error} If the requested service is not found in the context
  */
 export function inject<T>(
   context: Context,
-  service: (new (...args: any[]) => T) | string,
-  args: any[] = []
-): T {
-  const isClass = typeof service === "function";
-  const name = isClass ? service.name : service;
-  const value = context.get("inject:" + name);
-  if (value) {
-    context.set('injected:' + name, true)
+  token: ProviderToken | string,
+  options: InjectionOptions = {}
+): T | T[] | undefined {
+  const record = getRecord(context, token);
+
+  if (!record) {
+    if (options.optional) {
+      return options.multi ? [] : undefined;
+    }
+    return handleMissingInjection(token, options);
+  }
+
+  if (options.name) {
+    const instanceKey = toInstanceKey(options.name);
+    if (!record.values.has(instanceKey)) {
+      if (options.optional) {
+        return undefined;
+      }
+      return handleMissingInjection(token, options);
+    }
+    const value = record.values.get(instanceKey);
+    markInjected(record, instanceKey);
     return value as T;
   }
-  throw new Error(`Injection provider ${name} not found`);
+
+  if (options.multi || record.multi) {
+    if (record.values.size === 0) {
+      if (options.optional) {
+        return [];
+      }
+      return handleMissingInjection(token, options);
+    }
+    markAllInjected(record);
+    return Array.from(record.values.values()) as T[];
+  }
+
+  const value = record.values.get(DEFAULT_INSTANCE_KEY);
+  if (value === undefined) {
+    if (options.optional) {
+      return undefined;
+    }
+    return handleMissingInjection(token, options);
+  }
+
+  markInjected(record, DEFAULT_INSTANCE_KEY);
+  return value as T;
 }
 
 /**
@@ -89,7 +258,7 @@ export function override(
 
   // Flatten the providers array
   const flatProviders = providers.flat();
-  
+
   // Check if provider exists
   const exists = flatProviders.some(provider => {
     if (typeof provider === "function") {
@@ -127,7 +296,7 @@ export function override(
  */
 export function findProviders<T extends Provider = Provider>(providers: Providers, name: string | RegExp): T[] {
   const results: any[] = [];
-  
+
   for (const provider of providers) {
     if (Array.isArray(provider)) {
       // Recursively search in nested arrays and concat results
@@ -137,7 +306,7 @@ export function findProviders<T extends Provider = Provider>(providers: Provider
       results.push(provider as T);
     }
   }
-  
+
   return results;
 }
 
@@ -154,7 +323,7 @@ export function findProvider<T extends Provider = Provider>(providers: Providers
     if (typeof providers === "object" && 'provide' in providers) {
       const provider = providers as any
       const providerName = typeof provider.provide === "function"
-        ? provider.provide.name 
+        ? provider.provide.name
         : provider.provide;
 
       if (name instanceof RegExp) {
@@ -177,8 +346,8 @@ export function findProvider<T extends Provider = Provider>(providers: Providers
 
     // Check object provider
     if (typeof provider === "object" && 'provide' in provider) {
-      const providerName = typeof provider.provide === "function" 
-        ? provider.provide.name 
+      const providerName = typeof provider.provide === "function"
+        ? provider.provide.name
         : provider.provide;
 
       // Handle RegExp matching

package/src/provider.ts

@@ -3,10 +3,23 @@
  * @module @signe/di/provider
  */
 
-import { ClassProvider, Provider, Providers, ProviderToken } from "./types";
+import { ClassProvider, ProvideOptions, Provider, Providers, ProviderToken } from "./types";
 import { inject, provide } from "./inject";
 import { Context } from "./context";
 
+function extractProvideOptions(source: { multi?: boolean; name?: string } | undefined): ProvideOptions | undefined {
+    if (!source) {
+        return undefined;
+    }
+
+    const { multi, name } = source;
+    if (multi === undefined && name === undefined) {
+        return undefined;
+    }
+
+    return { multi, name };
+}
+
 /**
  * Type guard to check if a provider is a ClassProvider
  * @param provider - Provider to check
@@ -38,10 +51,15 @@ function getDeps(provider: Provider): ProviderToken[] {
  */
 function sortProviders(providers: Provider[]): Provider[] {
     const tokenName = (t: ProviderToken) => typeof t === 'function' ? t.name : t;
-    const map = new Map<string, Provider>();
+    const map = new Map<string, Provider[]>();
     for (const p of providers) {
         const token = tokenName(typeof p === 'function' ? p : (p as any).provide);
-        map.set(token, p);
+        const list = map.get(token);
+        if (list) {
+            list.push(p);
+        } else {
+            map.set(token, [p]);
+        }
     }
 
     const result: Provider[] = [];
@@ -55,13 +73,15 @@ function sortProviders(providers: Provider[]): Provider[] {
             throw new Error(`Circular dependency detected for provider ${name}`);
         }
         stack.add(name);
-        const provider = map.get(name);
-        if (provider) {
-            for (const dep of getDeps(provider)) {
-                visit(dep);
+        const providersForToken = map.get(name);
+        if (providersForToken) {
+            for (const provider of providersForToken) {
+                for (const dep of getDeps(provider)) {
+                    visit(dep);
+                }
+                result.push(provider);
             }
             visited.add(name);
-            result.push(provider);
         }
         stack.delete(name);
     };
@@ -99,13 +119,17 @@ export async function injector(context: Context, providers: Providers) {
     for (const provider of providers) {
         let token: ProviderToken;
         let instance: any;
+        let options: ProvideOptions | undefined;
 
         if (typeof provider === 'function') {
             // If provider is a class, treat it as a ClassProvider
             token = provider;
             instance = new provider(context);
+            const diOptions = extractProvideOptions((provider as any).diOptions ?? (provider as any).di);
+            options = diOptions;
         } else {
             token = (provider as any).provide;
+            options = extractProvideOptions(provider as any);
             const provideUserClass = (provider as any).useClass;
             const isClass = typeof provideUserClass === 'function';
             if (isClass) {
@@ -122,7 +146,6 @@ export async function injector(context: Context, providers: Providers) {
             }
         }
 
-        const name = typeof token === 'function' ? token.name : token;
-        provide(context, name, instance);
+        provide(context, token, instance, options);
     }
 }

package/src/types.ts

@@ -27,7 +27,54 @@ export interface ProviderMeta {
   [key: string]: any;
 }
 
-export interface ValueProvider {
+/**
+ * Common options available to all providers
+ */
+export interface ProviderOptions {
+  /**
+   * When true, allows multiple instances to be registered for the same token
+   */
+  multi?: boolean;
+  /**
+   * Optional name used to register and resolve a specific instance
+   */
+  name?: string;
+}
+
+/**
+ * Options that can be passed when calling {@link provide}
+ */
+export interface ProvideOptions extends ProviderOptions {}
+
+/**
+ * Options that can be passed when calling {@link inject}
+ */
+export interface InjectionOptions {
+  /**
+   * Optional name used to resolve a specific instance
+   */
+  name?: string;
+  /**
+   * When true, allows retrieving all instances registered with {@link ProviderOptions.multi}
+   */
+  multi?: boolean;
+  /**
+   * When true, `inject` will return `undefined` instead of throwing if the instance is missing
+   */
+  optional?: boolean;
+}
+
+/**
+ * Options used when checking if an instance exists in the context
+ */
+export interface InstanceLookupOptions {
+  /**
+   * Optional name of the instance to check
+   */
+  name?: string;
+}
+
+export interface ValueProvider extends ProviderOptions {
   /** Token to identify the provider */
   provide: ProviderToken;
   /** Value to be injected */
@@ -41,7 +88,7 @@ export interface ValueProvider {
 /**
  * Provider configuration for class-based injection
  */
-export interface ClassProvider {
+export interface ClassProvider extends ProviderOptions {
   /** Token to identify the provider */
   provide: ProviderToken;
   /** Class to be instantiated */
@@ -55,7 +102,7 @@ export interface ClassProvider {
 /**
  * Provider configuration for factory-based injection
  */
-export interface FactoryProvider {
+export interface FactoryProvider extends ProviderOptions {
   /** Token to identify the provider */
   provide: ProviderToken;
   /** Tokens that must be injected before this provider */
@@ -69,7 +116,7 @@ export interface FactoryProvider {
 /**
  * Provider configuration for alias-based injection
  */
-export interface ExistingProvider {
+export interface ExistingProvider extends ProviderOptions {
   /** Token to identify the provider */
   provide: ProviderToken;
   /** Token of the existing provider to use */