@buenojs/bueno 0.8.6 → 0.8.8

package/dist/config/types.d.ts

@@ -0,0 +1,322 @@
+/**
+ * Configuration type definitions for Bueno Framework
+ */
+import type { StandardSchema } from "../types";
+export interface ServerConfig {
+    /** Server port (default: 3000) */
+    port?: number;
+    /** Server host (default: 'localhost') */
+    host?: string;
+    /** Enable development mode */
+    development?: boolean;
+}
+export interface DatabaseConfig {
+    /** Database connection URL */
+    url?: string;
+    /** Connection pool size */
+    poolSize?: number;
+    /** Enable database metrics */
+    enableMetrics?: boolean;
+    /** Slow query threshold in milliseconds */
+    slowQueryThreshold?: number;
+}
+export interface CacheConfig {
+    /** Cache driver type */
+    driver?: "redis" | "memory";
+    /** Redis connection URL */
+    url?: string;
+    /** Default TTL in seconds */
+    ttl?: number;
+    /** Key prefix for namespacing */
+    keyPrefix?: string;
+    /** Enable cache metrics */
+    enableMetrics?: boolean;
+}
+export type LogLevel = "debug" | "info" | "warn" | "error" | "fatal";
+export interface LoggerConfig {
+    /** Log level (default: 'info') */
+    level?: LogLevel;
+    /** Pretty print logs (default: true in development) */
+    pretty?: boolean;
+    /** Output destination */
+    output?: "console" | "stdout";
+}
+export interface HealthConfig {
+    /** Enable health check endpoints */
+    enabled?: boolean;
+    /** Health check endpoint path (default: '/health') */
+    healthPath?: string;
+    /** Readiness check endpoint path (default: '/ready') */
+    readyPath?: string;
+}
+export interface MetricsConfig {
+    /** Enable metrics collection */
+    enabled?: boolean;
+    /** Collection interval in milliseconds */
+    collectInterval?: number;
+    /** Maximum history size */
+    maxHistorySize?: number;
+}
+export interface ObservabilityConfig {
+    /** Enable the observability integration layer */
+    enabled?: boolean;
+    /** Maximum breadcrumb ring buffer size (default: 20) */
+    breadcrumbsSize?: number;
+    /** HTTP status codes to suppress from error reporting (e.g. [404, 401]) */
+    ignoreStatusCodes?: number[];
+}
+export interface TelemetryConfig {
+    /** Enable OpenTelemetry tracing */
+    enabled?: boolean;
+    /** Service name for tracing */
+    serviceName?: string;
+    /** OTLP endpoint URL */
+    endpoint?: string;
+    /** Sampling rate (0.0 to 1.0) */
+    sampleRate?: number;
+}
+export interface JobsConfig {
+    /** Enable background jobs */
+    enabled?: boolean;
+    /** Job queue driver type */
+    driver?: "redis" | "memory";
+    /** Redis connection URL */
+    url?: string;
+    /** Key prefix for jobs (default: 'jobs:') */
+    keyPrefix?: string;
+    /** Max concurrent jobs (default: 10) */
+    concurrency?: number;
+    /** Max retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Retry delay in seconds (default: 1) */
+    retryDelay?: number;
+    /** Job batch size (default: 10) */
+    batchSize?: number;
+    /** Poll interval in milliseconds (default: 1000) */
+    pollInterval?: number;
+    /** Job timeout in milliseconds (default: 300000 / 5 minutes) */
+    jobTimeout?: number;
+    /** Enable metrics collection */
+    enableMetrics?: boolean;
+}
+export interface TemplateConfig {
+    /** Enable template system */
+    enabled?: boolean;
+    /** Base path to templates directory (default: 'resources/templates') */
+    basePath?: string;
+    /** Cache configuration */
+    cache?: {
+        /** Enable template caching (default: true) */
+        enabled?: boolean;
+        /** Cache TTL in seconds (default: 3600) */
+        ttl?: number;
+        /** Maximum templates in cache (default: 100) */
+        maxSize?: number;
+    };
+    /** Enable file watching for hot reload in development */
+    watch?: boolean;
+    /** Default output format: 'html' or 'text' */
+    defaultFormat?: "html" | "text";
+    /** Channel to variant mapping for auto-detection */
+    channelVariantMap?: Record<string, string>;
+}
+export interface NotificationConfig {
+    /** Enable notification service */
+    enabled?: boolean;
+    /** Enable metrics collection */
+    enableMetrics?: boolean;
+    /** Default channel for sending */
+    defaultChannel?: string;
+    /** Enable job queue integration for async sending */
+    queue?: boolean;
+    /** Email channel configuration */
+    email?: {
+        enabled?: boolean;
+        driver?: "smtp" | "sendgrid" | "brevo" | "resend";
+        from?: string;
+        fromName?: string;
+        dryRun?: boolean;
+        smtp?: {
+            host?: string;
+            port?: number;
+            secure?: boolean;
+            username?: string;
+            password?: string;
+        };
+        apiKey?: string;
+    };
+    /** SMS channel configuration */
+    sms?: {
+        enabled?: boolean;
+        driver?: "twilio" | "aws-sns" | "custom";
+        dryRun?: boolean;
+        accountSid?: string;
+        authToken?: string;
+        fromNumber?: string;
+        apiKey?: string;
+    };
+    /** WhatsApp channel configuration */
+    whatsapp?: {
+        enabled?: boolean;
+        driver?: "twilio" | "custom";
+        dryRun?: boolean;
+        accountSid?: string;
+        authToken?: string;
+        businessPhoneNumber?: string;
+        apiKey?: string;
+    };
+    /** Push notification channel configuration */
+    push?: {
+        enabled?: boolean;
+        driver?: "firebase" | "apns" | "custom";
+        dryRun?: boolean;
+        serverKey?: string;
+        certificatePath?: string;
+        apiKey?: string;
+    };
+}
+export interface I18nConfig {
+    /** Enable i18n system */
+    enabled?: boolean;
+    /** Default locale — used as fallback when requested locale has missing keys (default: "en") */
+    defaultLocale?: string;
+    /** List of supported locale identifiers (default: ["en"]) */
+    supportedLocales?: string[];
+    /** Base directory for locale JSON files (default: "resources/i18n") */
+    basePath?: string;
+    /**
+     * Fall back to defaultLocale when a key is missing in the requested locale.
+     * (default: true)
+     */
+    fallbackToDefault?: boolean;
+    /** Cookie name used to persist locale choice (default: "bueno_locale") */
+    cookieName?: string;
+    /** Cookie max-age in seconds (default: 31536000 — 1 year) */
+    cookieMaxAge?: number;
+    /** Enable file watching for hot reload in development */
+    watch?: boolean;
+}
+export interface FrontendConfig {
+    /** Enable development server */
+    devServer?: boolean;
+    /** Enable Hot Module Replacement */
+    hmr?: boolean;
+    /** Frontend dev server port */
+    port?: number;
+}
+export interface GraphQLConfig {
+    /** Enable GraphQL support (default: false) */
+    enabled?: boolean;
+    /** HTTP path for GraphQL endpoint (default: '/graphql') */
+    path?: string;
+    /** Enable GraphiQL playground (default: auto — true with adapter, false with built-in) */
+    playground?: boolean;
+    /** Enable SDL introspection endpoint at GET <path>/schema (default: true) */
+    introspection?: boolean;
+    /** Maximum query complexity score (default: 1000) */
+    complexityLimit?: number;
+    /** Maximum query depth (default: 10) */
+    maxDepth?: number;
+    /** Enable WebSocket subscriptions (default: false) */
+    subscriptions?: boolean;
+}
+/**
+ * Main configuration interface for Bueno Framework
+ */
+export interface BuenoConfig {
+    /** Server configuration */
+    server?: ServerConfig;
+    /** Database configuration */
+    database?: DatabaseConfig;
+    /** Cache configuration */
+    cache?: CacheConfig;
+    /** Jobs configuration */
+    jobs?: JobsConfig;
+    /** Template configuration */
+    template?: TemplateConfig;
+    /** Notification configuration */
+    notification?: NotificationConfig;
+    /** i18n configuration */
+    i18n?: I18nConfig;
+    /** Logger configuration */
+    logger?: LoggerConfig;
+    /** Health check configuration */
+    health?: HealthConfig;
+    /** Metrics configuration */
+    metrics?: MetricsConfig;
+    /** Telemetry configuration */
+    telemetry?: TelemetryConfig;
+    /** Observability / error tracking configuration */
+    observability?: ObservabilityConfig;
+    /** Frontend configuration */
+    frontend?: FrontendConfig;
+    /** GraphQL configuration */
+    graphql?: GraphQLConfig;
+}
+export interface ConfigManagerOptions {
+    /** Path to config file (default: auto-detect) */
+    configPath?: string;
+    /** Whether to load environment variables (default: true) */
+    loadEnv?: boolean;
+    /** Whether to validate config (default: true) */
+    validate?: boolean;
+    /** Custom validation schema */
+    schema?: StandardSchema<BuenoConfig>;
+    /** Environment to load (.env.{NODE_ENV}) */
+    env?: string;
+}
+export type ConfigSource = "default" | "file" | "env" | "cli" | "runtime";
+export interface ConfigSourceInfo {
+    /** Source of the configuration value */
+    source: ConfigSource;
+    /** File path if from file */
+    filePath?: string;
+    /** Environment variable name if from env */
+    envVar?: string;
+}
+export interface ConfigChangeEvent {
+    /** Key that changed (dot notation) */
+    key: string;
+    /** Previous value */
+    oldValue: unknown;
+    /** New value */
+    newValue: unknown;
+    /** Source of the change */
+    source: ConfigSource;
+    /** Timestamp of the change */
+    timestamp: Date;
+}
+export type ConfigWatchCallback = (event: ConfigChangeEvent) => void;
+/**
+ * Infer configuration type from a schema
+ */
+export type InferConfig<T extends StandardSchema<BuenoConfig>> = NonNullable<T["~standard"]["types"]>["output"];
+/**
+ * Deep partial type for configuration
+ */
+export type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * User configuration type (alias for DeepPartial<BuenoConfig>)
+ */
+export type UserConfig<T extends BuenoConfig = BuenoConfig> = DeepPartial<T>;
+/**
+ * User configuration function type
+ */
+export type UserConfigFn<T extends BuenoConfig = BuenoConfig> = (env: string) => UserConfig<T> | Promise<UserConfig<T>>;
+/**
+ * Configuration value type for a given key path
+ */
+export type ConfigValueForKey<TKey extends string> = TKey extends `${infer T}.${infer Rest}` ? T extends keyof BuenoConfig ? Rest extends string ? ConfigValueForKey<Rest> : BuenoConfig[T] : unknown : TKey extends keyof BuenoConfig ? BuenoConfig[TKey] : unknown;
+export declare const DEFAULT_CONFIG: Required<BuenoConfig>;
+export interface EnvMapping {
+    /** Environment variable name */
+    envVar: string;
+    /** Config key path (dot notation) */
+    configKey: string;
+    /** Optional transformer function */
+    transform?: (value: string) => unknown;
+}
+export declare const ENV_MAPPINGS: EnvMapping[];
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/config/validation.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Configuration validation for Bueno Framework
+ * Supports Standard Schema validators (Zod, Valibot, ArkType)
+ */
+import type { StandardIssue, StandardSchema } from "../types";
+import type { BuenoConfig, DeepPartial } from "./types";
+/**
+ * Validation result
+ */
+export interface ConfigValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Validation errors if any */
+    errors: ConfigValidationError[];
+    /** Warnings (non-critical issues) */
+    warnings: ConfigValidationWarning[];
+}
+/**
+ * Validation error
+ */
+export interface ConfigValidationError {
+    /** Error message */
+    message: string;
+    /** Path to the invalid field */
+    path?: string;
+    /** Expected type or value */
+    expected?: string;
+    /** Actual value received */
+    received?: unknown;
+    /** Original issue from schema validator */
+    issue?: StandardIssue;
+}
+/**
+ * Validation warning
+ */
+export interface ConfigValidationWarning {
+    /** Warning message */
+    message: string;
+    /** Path to the field */
+    path?: string;
+}
+/**
+ * Check if a value is a Standard Schema
+ */
+export declare function isStandardSchema(value: unknown): value is StandardSchema;
+/**
+ * Validate config against a Standard Schema
+ */
+export declare function validateWithSchema<T>(config: unknown, schema: StandardSchema<T>): Promise<ConfigValidationResult>;
+/**
+ * Validation rule
+ */
+interface ValidationRule {
+    /** Path to the field to validate */
+    path: string;
+    /** Validation function */
+    validate: (value: unknown, config: DeepPartial<BuenoConfig>) => ValidationResult;
+}
+/**
+ * Validation result from a rule
+ */
+interface ValidationResult {
+    valid: boolean;
+    message?: string;
+    expected?: string;
+    received?: unknown;
+}
+/**
+ * Validate config using default rules
+ */
+export declare function validateConfigDefaults(config: DeepPartial<BuenoConfig>): ConfigValidationResult;
+/**
+ * Validate configuration
+ * Supports both Standard Schema and default validation rules
+ */
+export declare function validateConfig<T extends BuenoConfig = BuenoConfig>(config: unknown, schema?: StandardSchema<T>): Promise<ConfigValidationResult>;
+/**
+ * Validate configuration synchronously
+ * Note: Standard Schema validation may be async, so this only works with default rules
+ */
+export declare function validateConfigSync(config: DeepPartial<BuenoConfig>): ConfigValidationResult;
+/**
+ * Create a validation error with helpful message
+ */
+export declare function createConfigError(result: ConfigValidationResult): ConfigValidationError;
+/**
+ * Format validation errors for display
+ */
+export declare function formatValidationErrors(errors: ConfigValidationError[]): string;
+/**
+ * Assert that configuration is valid
+ * Throws an error if validation fails
+ */
+export declare function assertValidConfig<T extends BuenoConfig = BuenoConfig>(config: unknown, schema?: StandardSchema<T>): Promise<void>;
+/**
+ * Add custom validation rules
+ */
+export declare function createCustomValidator(rules: ValidationRule[]): (config: DeepPartial<BuenoConfig>) => ConfigValidationResult;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/config/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/config/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,+BAA+B;IAC/B,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,qCAAqC;IACrC,QAAQ,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAQxE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACzC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAsBjC;AAmVD;;GAEG;AACH,UAAU,cAAc;IACvB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,QAAQ,EAAE,CACT,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,KAC5B,gBAAgB,CAAC;CACtB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAsBD;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,GAC9B,sBAAsB,CA0CxB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACvE,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,sBAAsB,CAAC,CAQjC;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,GAC9B,sBAAsB,CAExB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,EAAE,sBAAsB,GAC5B,qBAAqB,CAevB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,qBAAqB,EAAE,GAC7B,MAAM,CAoBR;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC1E,MAAM,EAAE,OAAO,EACf,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,cAAc,EAAE,GACrB,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,KAAK,sBAAsB,CAwB9D"}

package/dist/container/forward-ref.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Forward Reference for Circular Dependencies
+ *
+ * Provides a way to resolve circular dependencies by deferring the resolution
+ * of a dependency until it's actually needed. This allows two or more services
+ * to depend on each other without causing infinite loops during instantiation.
+ */
+/**
+ * Forward reference container for lazy resolution of circular dependencies.
+ *
+ * @template T - The type of the referenced value
+ *
+ * @example
+ * ```typescript
+ * // Creating a forward reference
+ * const ref = forwardRef(() => ServiceB);
+ *
+ * // Using with @Inject decorator
+ * @Injectable()
+ * class ServiceA {
+ *   constructor(
+ *     @Inject(forwardRef(() => ServiceB))
+ *     private serviceB: ServiceB
+ *   ) {}
+ * }
+ * ```
+ */
+export interface ForwardRef<T> {
+    /**
+     * The unique symbol identifying this as a ForwardRef
+     */
+    readonly __forwardRef: unique symbol;
+    /**
+     * Factory function that returns the actual value when called.
+     * This is invoked lazily when the dependency is first accessed.
+     */
+    forwardRef: () => T;
+}
+/**
+ * Create a forward reference for circular dependency resolution.
+ *
+ * The provided factory function is called lazily when the dependency
+ * is actually resolved, allowing the referenced class to be defined
+ * later in the module loading process.
+ *
+ * @template T - The type of the referenced value
+ * @param fn - Factory function that returns the actual token or value
+ * @returns A ForwardRef object that can be used with @Inject()
+ *
+ * @example
+ * ```typescript
+ * // service-a.ts
+ * @Injectable()
+ * export class ServiceA {
+ *   constructor(
+ *     @Inject(forwardRef(() => ServiceB))
+ *     private serviceB: ServiceB
+ *   ) {}
+ *
+ *   doSomething() {
+ *     return this.serviceB.help();
+ *   }
+ * }
+ *
+ * // service-b.ts
+ * @Injectable()
+ * export class ServiceB {
+ *   constructor(
+ *     @Inject(forwardRef(() => ServiceA))
+ *     private serviceA: ServiceA
+ *   ) {}
+ *
+ *   help() {
+ *     return 'helping';
+ *   }
+ * }
+ * ```
+ */
+export declare function forwardRef<T>(fn: () => T): ForwardRef<T>;
+/**
+ * Type guard to check if a value is a ForwardRef.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a ForwardRef, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const ref = forwardRef(() => MyService);
+ * if (isForwardRef(ref)) {
+ *   const actualToken = resolveForwardRef(ref);
+ * }
+ * ```
+ */
+export declare function isForwardRef(value: unknown): value is ForwardRef<unknown>;
+/**
+ * Resolve a forward reference to its actual value.
+ *
+ * If the provided value is a ForwardRef, this function calls its
+ * factory function to get the actual value. If it's not a ForwardRef,
+ * the value is returned as-is.
+ *
+ * @template T - The expected type of the resolved value
+ * @param ref - Either a ForwardRef or a direct value
+ * @returns The resolved value
+ *
+ * @example
+ * ```typescript
+ * const token = Token<ServiceB>('ServiceB');
+ * const ref = forwardRef(() => token);
+ *
+ * // Resolves to the token
+ * const actualToken = resolveForwardRef(ref);
+ * ```
+ */
+export declare function resolveForwardRef<T>(ref: ForwardRef<T> | T): T;
+//# sourceMappingURL=forward-ref.d.ts.map

package/dist/container/forward-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward-ref.d.ts","sourceRoot":"","sources":["../../src/container/forward-ref.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,OAAO,MAAM,CAAC;IAErC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC,CAAC;CACpB;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAKxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC,CAQzE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAK9D"}

package/dist/container/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Dependency Injection Container
+ *
+ * Provides inversion of control for managing dependencies
+ * with support for constructor injection, factories, and scopes.
+ * Supports circular dependency resolution via forward references.
+ */
+import type { Provider } from "../types";
+import { type ForwardRef, forwardRef, isForwardRef, resolveForwardRef } from "./forward-ref";
+export type { Provider } from "../types";
+export { type ForwardRef, forwardRef, isForwardRef, resolveForwardRef };
+/**
+ * Token type - represents an injection token
+ */
+export type Token<T = unknown> = symbol & {
+    readonly __type?: T;
+};
+/**
+ * Creates a typed injection token (symbol-based)
+ */
+export declare function createToken<T>(description: string): Token<T>;
+/**
+ * Token function - creates a typed injection token (symbol-based)
+ */
+export declare const Token: typeof createToken;
+export declare class Container {
+    private providers;
+    private resolutionStack;
+    /**
+     * Register a single provider
+     */
+    register<T>(provider: Provider<T>): void;
+    /**
+     * Register multiple providers at once
+     */
+    registerAll(providers: Provider[]): void;
+    /**
+     * Check if a token is registered
+     */
+    has(token: Token): boolean;
+    /**
+     * Resolve a token to its value
+     */
+    resolve<T>(token: Token<T>): T;
+    /**
+     * Create a lazy proxy for circular dependency resolution.
+     * The proxy will resolve the actual instance on first property access.
+     */
+    private createLazyProxy;
+    /**
+     * Create an instance from a provider
+     */
+    private createInstance;
+    /**
+     * Resolve an array of dependency tokens (including ForwardRef support)
+     */
+    private resolveDeps;
+    /**
+     * Clear all registrations
+     */
+    clear(): void;
+    /**
+     * Get all registered tokens
+     */
+    getTokens(): Token[];
+    /**
+     * Create a child container (for request-scoped containers)
+     */
+    createChild(): Container;
+}
+declare function setContainerMetadata(target: object, key: string, value: unknown): void;
+declare function getContainerMetadata<T>(target: object, key: string): T | undefined;
+/**
+ * Helper to create injectable class decorator
+ */
+export declare function Injectable(token?: Token): ClassDecorator;
+/**
+ * Helper to create parameter injection metadata.
+ * Supports both Token and ForwardRef<Token> for circular dependency resolution.
+ *
+ * @param token - The injection token or a forward reference to the token
+ * @returns A parameter decorator that registers the injection metadata
+ *
+ * @example
+ * ```typescript
+ * // Regular injection
+ * constructor(@Inject(MY_TOKEN) private service: MyService) {}
+ *
+ * // Forward reference for circular dependency
+ * constructor(@Inject(forwardRef(() => ServiceB)) private serviceB: ServiceB) {}
+ * ```
+ */
+export declare function Inject(token: Token | ForwardRef<Token>): ParameterDecorator;
+export { getContainerMetadata as getInjectTokens, setContainerMetadata, getContainerMetadata, };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/container/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACN,KAAK,UAAU,EACf,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAIxE;;GAEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAElE;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAE5D;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,oBAAc,CAAC;AAyEjC,qBAAa,SAAS;IACrB,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,eAAe,CAAyB;IAEhD;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAexC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI;IAMxC;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAI1B;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IAoC9B;;;OAGG;IACH,OAAO,CAAC,eAAe;IA8EvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IAEH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,SAAS,IAAI,KAAK,EAAE;IAIpB;;OAEG;IACH,WAAW,IAAI,SAAS;CAUxB;AAOD,iBAAS,oBAAoB,CAC5B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACZ,IAAI,CAKN;AAED,iBAAS,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAE3E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,cAAc,CAQxD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAe3E;AAGD,OAAO,EACN,oBAAoB,IAAI,eAAe,EACvC,oBAAoB,EACpB,oBAAoB,GACpB,CAAC"}