@riktajs/core 0.3.1 → 0.4.0-beta.2

package/dist/core/decorators/config-property.decorator.js

@@ -0,0 +1,205 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigProperty = ConfigProperty;
+exports.getConfigPropertyMappings = getConfigPropertyMappings;
+exports.hasConfigProperties = hasConfigProperties;
+exports.clearPropertyNameCache = clearPropertyNameCache;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+/**
+ * Cache for converted property names to avoid recomputation
+ * Map<propertyKey, envKey>
+ */
+const propertyNameCache = new Map();
+/**
+ * Convert a camelCase property name to UPPER_SNAKE_CASE
+ *
+ * @param propertyName - The property name to convert
+ * @returns The converted UPPER_SNAKE_CASE name
+ *
+ * @example
+ * ```typescript
+ * toUpperSnakeCase('dbHost')      // 'DB_HOST'
+ * toUpperSnakeCase('apiKey')      // 'API_KEY'
+ * toUpperSnakeCase('port')        // 'PORT'
+ * toUpperSnakeCase('maxRetries')  // 'MAX_RETRIES'
+ * ```
+ */
+function toUpperSnakeCase(propertyName) {
+    // Check cache first (tip: cache derived names)
+    if (propertyNameCache.has(propertyName)) {
+        return propertyNameCache.get(propertyName);
+    }
+    // Convert camelCase/PascalCase to UPPER_SNAKE_CASE
+    const envKey = propertyName
+        .replace(/([A-Z])/g, '_$1')
+        .toUpperCase()
+        .replace(/^_/, '');
+    // Cache for future use
+    propertyNameCache.set(propertyName, envKey);
+    return envKey;
+}
+/**
+ * @ConfigProperty() decorator
+ *
+ * Maps a class property to an environment variable. If no explicit env key is provided,
+ * automatically converts the property name from camelCase to UPPER_SNAKE_CASE.
+ *
+ * This decorator stores metadata that will be read by AbstractConfigProvider
+ * during the populate() phase to assign validated environment values to properties.
+ *
+ * @param envKey - Optional explicit environment variable name (must be UPPERCASE)
+ *
+ * @example Auto-mapping (property name → UPPER_SNAKE_CASE):
+ * ```typescript
+ * import { ConfigProperty, ProviderConfig, AbstractConfigProvider } from '@riktajs/core';
+ * import { z } from 'zod';
+ *
+ * @ProviderConfig()
+ * export class DatabaseConfigProvider extends AbstractConfigProvider {
+ *   schema() {
+ *     return z.object({
+ *       DB_HOST: z.string(),
+ *       DB_PORT: z.coerce.number().int(),
+ *       DB_NAME: z.string(),
+ *     });
+ *   }
+ *
+ *   @ConfigProperty()  // Maps to 'DB_HOST'
+ *   dbHost!: string;
+ *
+ *   @ConfigProperty()  // Maps to 'DB_PORT'
+ *   dbPort!: number;
+ *
+ *   @ConfigProperty()  // Maps to 'DB_NAME'
+ *   dbName!: string;
+ * }
+ * ```
+ *
+ * @example Custom env key mapping:
+ * ```typescript
+ * @ProviderConfig()
+ * export class AppConfigProvider extends AbstractConfigProvider {
+ *   schema() {
+ *     return z.object({
+ *       PORT: z.coerce.number().int(),
+ *       NODE_ENV: z.enum(['development', 'production', 'test']),
+ *       API_SECRET_KEY: z.string(),
+ *     });
+ *   }
+ *
+ *   @ConfigProperty('PORT')
+ *   serverPort!: number;
+ *
+ *   @ConfigProperty('NODE_ENV')
+ *   environment!: 'development' | 'production' | 'test';
+ *
+ *   @ConfigProperty('API_SECRET_KEY')
+ *   secret!: string;
+ * }
+ * ```
+ *
+ * @example Mixed auto and custom mapping:
+ * ```typescript
+ * @ProviderConfig()
+ * export class ApiConfigProvider extends AbstractConfigProvider {
+ *   schema() {
+ *     return z.object({
+ *       API_KEY: z.string(),
+ *       API_URL: z.string().url(),
+ *       TIMEOUT: z.coerce.number().int(),
+ *     });
+ *   }
+ *
+ *   @ConfigProperty()  // Auto: apiKey → API_KEY
+ *   apiKey!: string;
+ *
+ *   @ConfigProperty()  // Auto: apiUrl → API_URL
+ *   apiUrl!: string;
+ *
+ *   @ConfigProperty('TIMEOUT')  // Custom mapping
+ *   requestTimeout!: number;
+ * }
+ * ```
+ */
+function ConfigProperty(envKey) {
+    return (target, propertyKey) => {
+        if (typeof propertyKey === 'symbol') {
+            throw new Error(`@ConfigProperty: Symbol properties are not supported. ` +
+                `Property "${String(propertyKey)}" must be a string.`);
+        }
+        // Determine the environment variable name
+        const finalEnvKey = envKey ?? toUpperSnakeCase(propertyKey);
+        // Validate env key format
+        if (!finalEnvKey || typeof finalEnvKey !== 'string') {
+            throw new Error(`@ConfigProperty: Invalid env key for property "${propertyKey}". ` +
+                `Env key must be a non-empty string.`);
+        }
+        // Ensure env key is uppercase (convention)
+        if (finalEnvKey !== finalEnvKey.toUpperCase()) {
+            throw new Error(`@ConfigProperty: Env key "${finalEnvKey}" for property "${propertyKey}" must be UPPERCASE. ` +
+                `Use "${finalEnvKey.toUpperCase()}" instead.`);
+        }
+        // Get existing metadata or initialize
+        const constructor = target.constructor;
+        const existingMappings = Reflect.getMetadata(constants_1.CONFIG_PROPERTY_METADATA, constructor) || [];
+        // Check for duplicate property decorations
+        const duplicate = existingMappings.find(m => m.propertyKey === propertyKey);
+        if (duplicate) {
+            throw new Error(`@ConfigProperty: Property "${propertyKey}" on class "${constructor.name}" ` +
+                `is already decorated. Remove the duplicate @ConfigProperty decorator.`);
+        }
+        // Check for duplicate env key mappings
+        const duplicateEnvKey = existingMappings.find(m => m.envKey === finalEnvKey);
+        if (duplicateEnvKey) {
+            throw new Error(`@ConfigProperty: Env key "${finalEnvKey}" is already mapped to property "${duplicateEnvKey.propertyKey}" ` +
+                `on class "${constructor.name}". Each env key can only be mapped to one property.`);
+        }
+        // Add the new mapping
+        const newMapping = {
+            propertyKey,
+            envKey: finalEnvKey,
+        };
+        const updatedMappings = [...existingMappings, newMapping];
+        // Store metadata
+        Reflect.defineMetadata(constants_1.CONFIG_PROPERTY_METADATA, updatedMappings, constructor);
+    };
+}
+/**
+ * Helper to retrieve all config property mappings from a class
+ *
+ * @param target - The class constructor to retrieve mappings from
+ * @returns Array of property mappings, or empty array if none defined
+ *
+ * @example
+ * ```typescript
+ * const mappings = getConfigPropertyMappings(AppConfigProvider);
+ * console.log(mappings);
+ * // [
+ * //   { propertyKey: 'dbHost', envKey: 'DB_HOST' },
+ * //   { propertyKey: 'dbPort', envKey: 'DB_PORT' }
+ * // ]
+ * ```
+ */
+function getConfigPropertyMappings(target) {
+    return Reflect.getMetadata(constants_1.CONFIG_PROPERTY_METADATA, target) || [];
+}
+/**
+ * Check if a class has any @ConfigProperty decorated properties
+ *
+ * @param target - The class constructor to check
+ * @returns True if the class has at least one @ConfigProperty
+ */
+function hasConfigProperties(target) {
+    const mappings = getConfigPropertyMappings(target);
+    return mappings.length > 0;
+}
+/**
+ * Clear the property name conversion cache
+ *
+ * @internal Used for testing
+ */
+function clearPropertyNameCache() {
+    propertyNameCache.clear();
+}
+//# sourceMappingURL=config-property.decorator.js.map

package/dist/core/decorators/config-property.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-property.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/config-property.decorator.ts"],"names":[],"mappings":"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"}

package/dist/core/decorators/index.d.ts

@@ -4,4 +4,6 @@ export * from './route.decorator';
 export * from './param.decorator';
 export * from './autowired.decorator';
 export * from './provider.decorator';
+export * from './provider-config.decorator';
+export * from './config-property.decorator';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/decorators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC"}

package/dist/core/decorators/index.js

@@ -21,4 +21,6 @@ __exportStar(require("./route.decorator"), exports);
 __exportStar(require("./param.decorator"), exports);
 __exportStar(require("./autowired.decorator"), exports);
 __exportStar(require("./provider.decorator"), exports);
+__exportStar(require("./provider-config.decorator"), exports);
+__exportStar(require("./config-property.decorator"), exports);
 //# sourceMappingURL=index.js.map

package/dist/core/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wBAAwB;AACxB,yDAAuC;AACvC,yDAAuC;AACvC,oDAAkC;AAClC,oDAAkC;AAClC,wDAAsC;AACtC,uDAAqC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wBAAwB;AACxB,yDAAuC;AACvC,yDAAuC;AACvC,oDAAkC;AAClC,oDAAkC;AAClC,wDAAsC;AACtC,uDAAqC;AACrC,8DAA4C;AAC5C,8DAA4C"}

package/dist/core/decorators/provider-config.decorator.d.ts

@@ -0,0 +1,107 @@
+import 'reflect-metadata';
+import { Constructor } from '../types';
+/**
+ * Config provider metadata stored on the class
+ */
+export interface ConfigProviderMetadata {
+    /**
+     * The injection token for this config provider
+     * @example 'APP_CONFIG', 'DATABASE_CONFIG'
+     */
+    token: string;
+}
+/**
+ * @ProviderConfig() decorator
+ *
+ * Marks a class as a configuration provider that will be auto-discovered.
+ * Config providers extend AbstractConfigProvider and manage environment variables,
+ * validation with Zod schemas, and property mapping via @ConfigProperty.
+ *
+ * The decorator automatically generates an injection token from the class name
+ * if not explicitly provided, following the pattern: ClassName → CLASS_NAME_CONFIG
+ *
+ * @param token - Optional custom injection token (must be UPPERCASE)
+ *
+ * @example Auto-generated token:
+ * ```typescript
+ * import { ProviderConfig, AbstractConfigProvider } from '@riktajs/core';
+ * import { z } from 'zod';
+ *
+ * @ProviderConfig() // Token: 'APP_CONFIG'
+ * export class AppConfigProvider extends AbstractConfigProvider {
+ *   schema() {
+ *     return z.object({
+ *       PORT: z.coerce.number().int().min(1).max(65535),
+ *       HOST: z.string().default('localhost'),
+ *     });
+ *   }
+ *
+ *   @ConfigProperty()
+ *   port!: number;
+ *
+ *   @ConfigProperty()
+ *   host!: string;
+ * }
+ *
+ * // Inject with auto-generated token
+ * @Injectable()
+ * class MyService {
+ *   @Autowired('APP_CONFIG')
+ *   private config!: AppConfigProvider;
+ * }
+ * ```
+ *
+ * @example Custom token:
+ * ```typescript
+ * @ProviderConfig('DATABASE_CONFIG')
+ * export class DbConfigProvider extends AbstractConfigProvider {
+ *   schema() {
+ *     return z.object({
+ *       DB_HOST: z.string(),
+ *       DB_PORT: z.coerce.number().int(),
+ *       DB_NAME: z.string(),
+ *     });
+ *   }
+ * }
+ *
+ * // Inject with custom token
+ * @Injectable()
+ * class DatabaseService {
+ *   @Autowired('DATABASE_CONFIG')
+ *   private config!: DbConfigProvider;
+ * }
+ * ```
+ *
+ * @example Type-safe token export:
+ * ```typescript
+ * export const APP_CONFIG = 'APP_CONFIG' as const;
+ *
+ * @ProviderConfig(APP_CONFIG)
+ * export class AppConfigProvider extends AbstractConfigProvider {
+ *   // ...
+ * }
+ *
+ * // Type-safe injection
+ * @Injectable()
+ * class MyService {
+ *   @Autowired(APP_CONFIG)
+ *   private config!: AppConfigProvider;
+ * }
+ * ```
+ */
+export declare function ProviderConfig(token?: string): ClassDecorator;
+/**
+ * Helper to retrieve config provider metadata from a class
+ *
+ * @param target - The class to retrieve metadata from
+ * @returns The config provider metadata or undefined
+ */
+export declare function getConfigProviderMetadata(target: Constructor): ConfigProviderMetadata | undefined;
+/**
+ * Check if a class has @ProviderConfig decorator
+ *
+ * @param target - The class to check
+ * @returns True if the class is decorated with @ProviderConfig
+ */
+export declare function isConfigProvider(target: Constructor): boolean;
+//# sourceMappingURL=provider-config.decorator.d.ts.map

package/dist/core/decorators/provider-config.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-config.decorator.d.ts","sourceRoot":"","sources":["../../../src/core/decorators/provider-config.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,CAgC7D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,WAAW,GAClB,sBAAsB,GAAG,SAAS,CAEpC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAE7D"}

package/dist/core/decorators/provider-config.decorator.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProviderConfig = ProviderConfig;
+exports.getConfigProviderMetadata = getConfigProviderMetadata;
+exports.isConfigProvider = isConfigProvider;
+require("reflect-metadata");
+const constants_1 = require("../constants");
+/**
+ * Convert a class name to an uppercase config token
+ *
+ * @param className - The class name to convert
+ * @returns Uppercase token name
+ *
+ * @example
+ * ```typescript
+ * generateToken('AppConfigProvider') // Returns 'APP_CONFIG'
+ * generateToken('DatabaseConfigProvider') // Returns 'DATABASE_CONFIG'
+ * generateToken('MyCustomConfig') // Returns 'MY_CUSTOM_CONFIG'
+ * ```
+ */
+function generateTokenFromClassName(className) {
+    // Remove 'Provider' suffix if present
+    let tokenName = className.replace(/Provider$/, '');
+    // Convert camelCase/PascalCase to UPPER_SNAKE_CASE
+    tokenName = tokenName
+        .replace(/([A-Z])/g, '_$1')
+        .toUpperCase()
+        .replace(/^_/, '');
+    // Ensure it ends with _CONFIG if not already present
+    // But don't add it if the name already ends with CONFIG (after conversion)
+    if (!tokenName.endsWith('_CONFIG') && tokenName !== 'CONFIG') {
+        tokenName = `${tokenName}_CONFIG`;
+    }
+    return tokenName;
+}
+/**
+ * @ProviderConfig() decorator
+ *
+ * Marks a class as a configuration provider that will be auto-discovered.
+ * Config providers extend AbstractConfigProvider and manage environment variables,
+ * validation with Zod schemas, and property mapping via @ConfigProperty.
+ *
+ * The decorator automatically generates an injection token from the class name
+ * if not explicitly provided, following the pattern: ClassName → CLASS_NAME_CONFIG
+ *
+ * @param token - Optional custom injection token (must be UPPERCASE)
+ *
+ * @example Auto-generated token:
+ * ```typescript
+ * import { ProviderConfig, AbstractConfigProvider } from '@riktajs/core';
+ * import { z } from 'zod';
+ *
+ * @ProviderConfig() // Token: 'APP_CONFIG'
+ * export class AppConfigProvider extends AbstractConfigProvider {
+ *   schema() {
+ *     return z.object({
+ *       PORT: z.coerce.number().int().min(1).max(65535),
+ *       HOST: z.string().default('localhost'),
+ *     });
+ *   }
+ *
+ *   @ConfigProperty()
+ *   port!: number;
+ *
+ *   @ConfigProperty()
+ *   host!: string;
+ * }
+ *
+ * // Inject with auto-generated token
+ * @Injectable()
+ * class MyService {
+ *   @Autowired('APP_CONFIG')
+ *   private config!: AppConfigProvider;
+ * }
+ * ```
+ *
+ * @example Custom token:
+ * ```typescript
+ * @ProviderConfig('DATABASE_CONFIG')
+ * export class DbConfigProvider extends AbstractConfigProvider {
+ *   schema() {
+ *     return z.object({
+ *       DB_HOST: z.string(),
+ *       DB_PORT: z.coerce.number().int(),
+ *       DB_NAME: z.string(),
+ *     });
+ *   }
+ * }
+ *
+ * // Inject with custom token
+ * @Injectable()
+ * class DatabaseService {
+ *   @Autowired('DATABASE_CONFIG')
+ *   private config!: DbConfigProvider;
+ * }
+ * ```
+ *
+ * @example Type-safe token export:
+ * ```typescript
+ * export const APP_CONFIG = 'APP_CONFIG' as const;
+ *
+ * @ProviderConfig(APP_CONFIG)
+ * export class AppConfigProvider extends AbstractConfigProvider {
+ *   // ...
+ * }
+ *
+ * // Type-safe injection
+ * @Injectable()
+ * class MyService {
+ *   @Autowired(APP_CONFIG)
+ *   private config!: AppConfigProvider;
+ * }
+ * ```
+ */
+function ProviderConfig(token) {
+    return (target) => {
+        const className = target.name;
+        // Generate token from class name if not provided
+        const configToken = token ?? generateTokenFromClassName(className);
+        // Validate token format
+        if (!configToken || typeof configToken !== 'string') {
+            throw new Error(`@ProviderConfig: Invalid token for class "${className}". Token must be a non-empty string.`);
+        }
+        // Ensure token is uppercase (convention)
+        if (configToken !== configToken.toUpperCase()) {
+            throw new Error(`@ProviderConfig: Token "${configToken}" for class "${className}" must be UPPERCASE. ` +
+                `Use "${configToken.toUpperCase()}" instead.`);
+        }
+        // Store metadata
+        const metadata = {
+            token: configToken,
+        };
+        Reflect.defineMetadata(constants_1.CONFIG_PROVIDER_METADATA, metadata, target);
+        // Note: Registration with the Registry will happen during auto-discovery (Step 3)
+        // For now, we just store the metadata
+    };
+}
+/**
+ * Helper to retrieve config provider metadata from a class
+ *
+ * @param target - The class to retrieve metadata from
+ * @returns The config provider metadata or undefined
+ */
+function getConfigProviderMetadata(target) {
+    return Reflect.getMetadata(constants_1.CONFIG_PROVIDER_METADATA, target);
+}
+/**
+ * Check if a class has @ProviderConfig decorator
+ *
+ * @param target - The class to check
+ * @returns True if the class is decorated with @ProviderConfig
+ */
+function isConfigProvider(target) {
+    return Reflect.hasMetadata(constants_1.CONFIG_PROVIDER_METADATA, target);
+}
+//# sourceMappingURL=provider-config.decorator.js.map

package/dist/core/decorators/provider-config.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-config.decorator.js","sourceRoot":"","sources":["../../../src/core/decorators/provider-config.decorator.ts"],"names":[],"mappings":";;AA8HA,wCAgCC;AAQD,8DAIC;AAQD,4CAEC;AApLD,4BAA0B;AAC1B,4CAAwD;AAcxD;;;;;;;;;;;;GAYG;AACH,SAAS,0BAA0B,CAAC,SAAiB;IACnD,sCAAsC;IACtC,IAAI,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAEnD,mDAAmD;IACnD,SAAS,GAAG,SAAS;SAClB,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,WAAW,EAAE;SACb,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAErB,qDAAqD;IACrD,2EAA2E;IAC3E,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC7D,SAAS,GAAG,GAAG,SAAS,SAAS,CAAC;IACpC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,CAA6B,MAAiB,EAAE,EAAE;QACvD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC;QAE9B,iDAAiD;QACjD,MAAM,WAAW,GAAG,KAAK,IAAI,0BAA0B,CAAC,SAAS,CAAC,CAAC;QAEnE,wBAAwB;QACxB,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,6CAA6C,SAAS,sCAAsC,CAC7F,CAAC;QACJ,CAAC;QAED,yCAAyC;QACzC,IAAI,WAAW,KAAK,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CACb,2BAA2B,WAAW,gBAAgB,SAAS,uBAAuB;gBACtF,QAAQ,WAAW,CAAC,WAAW,EAAE,YAAY,CAC9C,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,MAAM,QAAQ,GAA2B;YACvC,KAAK,EAAE,WAAqB;SAC7B,CAAC;QAEF,OAAO,CAAC,cAAc,CAAC,oCAAwB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAEnE,kFAAkF;QAClF,sCAAsC;IACxC,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CACvC,MAAmB;IAEnB,OAAO,OAAO,CAAC,WAAW,CAAC,oCAAwB,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,MAAmB;IAClD,OAAO,OAAO,CAAC,WAAW,CAAC,oCAAwB,EAAE,MAAM,CAAC,CAAC;AAC/D,CAAC"}

package/dist/core/discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"AAoEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,GAAE,MAAM,EAAuB,EACvC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,EAAE,CAAC,CAqEnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"AAsEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CACnC,QAAQ,GAAE,MAAM,EAAuB,EACvC,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,EAAE,CAAC,CAqEnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/core/discovery.js

@@ -83,10 +83,12 @@ const DECORATOR_PATTERNS = [
     /@Controller\s*\(/, // @Controller() or @Controller('/path')
     /@Injectable\s*\(/, // @Injectable() or @Injectable({ scope: 'singleton' })
     /@Provider\s*\(/, // @Provider(TOKEN)
+    /@ProviderConfig\s*\(/, // @ProviderConfig(TOKEN)
     // Compiled JavaScript patterns (e.g., (0, core_1.Controller)('/path'))
     /\.\s*Controller\s*\)\s*\(/,
     /\.\s*Injectable\s*\)\s*\(/,
     /\.\s*Provider\s*\)\s*\(/,
+    /\.\s*ProviderConfig\s*\)\s*\(/,
 ];
 /**
  * Check if a file contains Rikta decorators (@Controller, @Injectable, or @Provider)

package/dist/core/discovery.js.map

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

package/dist/core/exceptions/config.exceptions.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Exception thrown when attempting to register a config provider with a token
+ * that is already registered.
+ */
+export declare class ConfigProviderAlreadyRegisteredException extends Error {
+    constructor(token: string, existingClass: string, newClass: string);
+}
+/**
+ * Exception thrown when attempting to retrieve a config provider that
+ * has not been registered.
+ */
+export declare class ConfigProviderNotFoundException extends Error {
+    constructor(token: string, availableTokens?: string[]);
+}
+/**
+ * Exception thrown when a config provider fails to instantiate.
+ */
+export declare class ConfigProviderInstantiationException extends Error {
+    constructor(token: string, className: string, cause: Error);
+}
+//# sourceMappingURL=config.exceptions.d.ts.map

package/dist/core/exceptions/config.exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.exceptions.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/config.exceptions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,wCAAyC,SAAQ,KAAK;gBACrD,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CASnE;AAED;;;GAGG;AACH,qBAAa,+BAAgC,SAAQ,KAAK;gBAC5C,KAAK,EAAE,MAAM,EAAE,eAAe,GAAE,MAAM,EAAO;CAc1D;AAED;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,KAAK;gBACjD,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;CAY3D"}

package/dist/core/exceptions/config.exceptions.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigProviderInstantiationException = exports.ConfigProviderNotFoundException = exports.ConfigProviderAlreadyRegisteredException = void 0;
+/**
+ * Exception thrown when attempting to register a config provider with a token
+ * that is already registered.
+ */
+class ConfigProviderAlreadyRegisteredException extends Error {
+    constructor(token, existingClass, newClass) {
+        super(`Config provider with token "${token}" is already registered.\n` +
+            `Existing: ${existingClass}\n` +
+            `Attempted: ${newClass}\n` +
+            `Use a different token or remove the duplicate registration.`);
+        this.name = 'ConfigProviderAlreadyRegisteredException';
+    }
+}
+exports.ConfigProviderAlreadyRegisteredException = ConfigProviderAlreadyRegisteredException;
+/**
+ * Exception thrown when attempting to retrieve a config provider that
+ * has not been registered.
+ */
+class ConfigProviderNotFoundException extends Error {
+    constructor(token, availableTokens = []) {
+        const suggestion = availableTokens.length > 0
+            ? `\n\nAvailable tokens: ${availableTokens.join(', ')}`
+            : '';
+        super(`Config provider with token "${token}" not found.${suggestion}\n` +
+            `Make sure the provider class is:\n` +
+            `1. Decorated with @ProviderConfig('${token}')\n` +
+            `2. Located in a file matching the autowired patterns\n` +
+            `3. Properly exported from its module`);
+        this.name = 'ConfigProviderNotFoundException';
+    }
+}
+exports.ConfigProviderNotFoundException = ConfigProviderNotFoundException;
+/**
+ * Exception thrown when a config provider fails to instantiate.
+ */
+class ConfigProviderInstantiationException extends Error {
+    constructor(token, className, cause) {
+        super(`Failed to instantiate config provider "${className}" (token: "${token}").\n` +
+            `Cause: ${cause.message}\n\n` +
+            `Check that the provider:\n` +
+            `1. Has a valid constructor\n` +
+            `2. All constructor dependencies are registered\n` +
+            `3. The provide() method is correctly implemented`);
+        this.name = 'ConfigProviderInstantiationException';
+        this.cause = cause;
+    }
+}
+exports.ConfigProviderInstantiationException = ConfigProviderInstantiationException;
+//# sourceMappingURL=config.exceptions.js.map

package/dist/core/exceptions/config.exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.exceptions.js","sourceRoot":"","sources":["../../../src/core/exceptions/config.exceptions.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,wCAAyC,SAAQ,KAAK;IACjE,YAAY,KAAa,EAAE,aAAqB,EAAE,QAAgB;QAChE,KAAK,CACH,+BAA+B,KAAK,4BAA4B;YAChE,aAAa,aAAa,IAAI;YAC9B,cAAc,QAAQ,IAAI;YAC1B,6DAA6D,CAC9D,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0CAA0C,CAAC;IACzD,CAAC;CACF;AAVD,4FAUC;AAED;;;GAGG;AACH,MAAa,+BAAgC,SAAQ,KAAK;IACxD,YAAY,KAAa,EAAE,kBAA4B,EAAE;QACvD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC;YAC3C,CAAC,CAAC,yBAAyB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACvD,CAAC,CAAC,EAAE,CAAC;QAEP,KAAK,CACH,+BAA+B,KAAK,eAAe,UAAU,IAAI;YACjE,oCAAoC;YACpC,sCAAsC,KAAK,MAAM;YACjD,wDAAwD;YACxD,sCAAsC,CACvC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,iCAAiC,CAAC;IAChD,CAAC;CACF;AAfD,0EAeC;AAED;;GAEG;AACH,MAAa,oCAAqC,SAAQ,KAAK;IAC7D,YAAY,KAAa,EAAE,SAAiB,EAAE,KAAY;QACxD,KAAK,CACH,0CAA0C,SAAS,cAAc,KAAK,OAAO;YAC7E,UAAU,KAAK,CAAC,OAAO,MAAM;YAC7B,4BAA4B;YAC5B,8BAA8B;YAC9B,kDAAkD;YAClD,kDAAkD,CACnD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sCAAsC,CAAC;QACnD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAbD,oFAaC"}

package/dist/core/exceptions/index.d.ts

@@ -3,4 +3,5 @@ export { ValidationException, ValidationErrorDetails } from './validation.except
 export { BadRequestException, UnauthorizedException, ForbiddenException, NotFoundException, MethodNotAllowedException, NotAcceptableException, RequestTimeoutException, ConflictException, GoneException, PayloadTooLargeException, UnsupportedMediaTypeException, UnprocessableEntityException, TooManyRequestsException, InternalServerErrorException, NotImplementedException, BadGatewayException, ServiceUnavailableException, GatewayTimeoutException, } from './exceptions';
 export { ExceptionFilter, ExceptionContext, ErrorResponse, GlobalExceptionFilter, GlobalExceptionFilterOptions, createExceptionHandler, } from './exception-filter';
 export { Catch, CatchMetadata, CATCH_METADATA, getCatchMetadata } from './catch.decorator';
+export { ConfigProviderAlreadyRegisteredException, ConfigProviderNotFoundException, ConfigProviderInstantiationException, } from './config.exceptions';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/exceptions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGrF,OAAO,EAEL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EAExB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/exceptions/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAG3F,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGrF,OAAO,EAEL,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EAExB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG3F,OAAO,EACL,wCAAwC,EACxC,+BAA+B,EAC/B,oCAAoC,GACrC,MAAM,qBAAqB,CAAC"}