@digilogiclabs/platform-core 1.0.0 → 1.1.0

package/dist/{ConsoleEmail-XeUBAnwc.d.mts → ConsoleEmail-Drr30nct.d.mts}

@@ -217,24 +217,54 @@ interface IEmail {
 /**
  * Queue abstraction interface
  * Provides a vendor-agnostic way to work with job queues
+ *
+ * Design Principles:
+ * - Self-hostable: Works with Redis (BullMQ) or in-memory for testing
+ * - No cloud lock-in: All adapters use open-source technologies
+ * - Backward compatible: All new fields/methods are optional
+ * - Zero external costs: Only requires self-hosted Redis for production
  */
+interface BackoffOptions {
+    type: 'fixed' | 'exponential';
+    delay: number;
+    /** Maximum delay for exponential backoff (ms) */
+    maxDelay?: number;
+}
+interface RepeatOptions {
+    /** Repeat every N milliseconds */
+    every?: number;
+    /** Cron expression (e.g., "0 * * * *" for hourly) */
+    cron?: string;
+    /** Timezone for cron (e.g., "America/New_York") */
+    tz?: string;
+    /** Maximum number of times to repeat */
+    limit?: number;
+}
 interface JobOptions {
     /** Delay before job is processed (ms) */
     delay?: number;
     /** Number of retry attempts */
     attempts?: number;
     /** Backoff strategy */
-    backoff?: {
-        type: 'fixed' | 'exponential';
-        delay: number;
-    };
+    backoff?: BackoffOptions;
     /** Job priority (higher = more priority) */
     priority?: number;
     /** Remove job after completion */
     removeOnComplete?: boolean | number;
     /** Remove job after failure */
     removeOnFail?: boolean | number;
+    /** Job timeout in milliseconds (new) */
+    timeout?: number;
+    /** Custom job ID (new) */
+    jobId?: string;
+    /** Repeat/cron options (new) */
+    repeat?: RepeatOptions;
+    /** Correlation ID for tracing (new) */
+    correlationId?: string;
+    /** Custom metadata (new) */
+    metadata?: Record<string, unknown>;
 }
+type JobState = 'waiting' | 'active' | 'completed' | 'failed' | 'delayed';
 interface Job<T = unknown> {
     id: string;
     name: string;
@@ -242,12 +272,52 @@ interface Job<T = unknown> {
     attemptsMade: number;
     progress: number;
     timestamp: number;
+    /** Job state (new, optional) */
+    state?: JobState;
+    /** Processing start time (new, optional) */
+    processedOn?: number;
+    /** Completion time (new, optional) */
+    finishedOn?: number;
+    /** Failure reason (new, optional) */
+    failedReason?: string;
+    /** Correlation ID (new, optional) */
+    correlationId?: string;
+    /** Custom metadata (new, optional) */
+    metadata?: Record<string, unknown>;
 }
 interface JobResult<T = unknown> {
     jobId: string;
     result?: T;
     error?: Error;
+    /** Duration in ms (new, optional) */
+    duration?: number;
+}
+interface JobContext<T = unknown> {
+    job: Job<T>;
+    /** Update job progress (0-100) */
+    updateProgress(progress: number): Promise<void>;
+    /** Log message for this job */
+    log(message: string): void;
+    /** Check if job timed out */
+    isTimedOut(): boolean;
 }
+interface QueueStats {
+    waiting: number;
+    active: number;
+    completed: number;
+    failed: number;
+    delayed: number;
+}
+type JobEventType = 'completed' | 'failed' | 'progress' | 'active' | 'stalled';
+interface JobEvent<T = unknown> {
+    type: JobEventType;
+    job: Job<T>;
+    result?: unknown;
+    error?: Error;
+    progress?: number;
+    timestamp: number;
+}
+type JobEventHandler<T = unknown> = (event: JobEvent<T>) => void | Promise<void>;
 interface IQueue<T = unknown> {
     /**
      * Add a job to the queue
@@ -262,9 +332,12 @@ interface IQueue<T = unknown> {
         options?: JobOptions;
     }>): Promise<Job<T>[]>;
     /**
-     * Process jobs
+     * Process jobs (backward compatible signature)
+     * New signature with options is also supported
      */
-    process(handler: (job: Job<T>) => Promise<unknown>): void;
+    process(handler: (job: Job<T>) => Promise<unknown>, options?: {
+        concurrency?: number;
+    }): void;
     /**
      * Get a job by ID
      */
@@ -284,13 +357,7 @@ interface IQueue<T = unknown> {
     /**
      * Get queue statistics
      */
-    getStats(): Promise<{
-        waiting: number;
-        active: number;
-        completed: number;
-        failed: number;
-        delayed: number;
-    }>;
+    getStats(): Promise<QueueStats>;
     /**
      * Check queue connectivity
      */
@@ -299,7 +366,62 @@ interface IQueue<T = unknown> {
      * Close queue connection
      */
     close(): Promise<void>;
+    /**
+     * Add a recurring job (cron/interval)
+     * @throws {Error} If adapter doesn't support recurring jobs
+     */
+    addRecurring?(name: string, data: T, repeat: RepeatOptions, options?: Omit<JobOptions, 'repeat'>): Promise<Job<T>>;
+    /**
+     * Get jobs by state
+     */
+    getJobs?(state: JobState | JobState[], start?: number, end?: number): Promise<Job<T>[]>;
+    /**
+     * Get failed jobs (dead letter queue)
+     */
+    getFailedJobs?(start?: number, end?: number): Promise<Job<T>[]>;
+    /**
+     * Retry a failed job
+     */
+    retryJob?(id: string): Promise<void>;
+    /**
+     * Replay all failed jobs
+     */
+    replayAllFailed?(): Promise<number>;
+    /**
+     * Update job progress
+     */
+    updateProgress?(id: string, progress: number): Promise<void>;
+    /**
+     * Clean old jobs
+     */
+    clean?(grace: number, limit: number, state: JobState): Promise<string[]>;
+    /**
+     * Remove all jobs
+     */
+    obliterate?(options?: {
+        force?: boolean;
+    }): Promise<void>;
+    /**
+     * Subscribe to job events
+     */
+    on?(event: JobEventType, handler: JobEventHandler<T>): void;
+    /**
+     * Unsubscribe from job events
+     */
+    off?(event: JobEventType, handler: JobEventHandler<T>): void;
+    /**
+     * Get queue name
+     */
+    getName?(): string;
 }
+/**
+ * Calculate exponential backoff delay
+ */
+declare function calculateBackoff(attempt: number, options: BackoffOptions): number;
+/**
+ * Generate a unique job ID
+ */
+declare function generateJobId(): string;
 
 /**
  * Logger Interface
@@ -1143,8 +1265,8 @@ declare const StorageConfigSchema: z.ZodEffects<z.ZodObject<{
     bucket?: string | undefined;
     publicUrl?: string | undefined;
 }, {
-    provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
     endpoint?: string | undefined;
+    provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
     region?: string | undefined;
     accessKey?: string | undefined;
     secretKey?: string | undefined;
@@ -1163,8 +1285,8 @@ declare const StorageConfigSchema: z.ZodEffects<z.ZodObject<{
     bucket?: string | undefined;
     publicUrl?: string | undefined;
 }, {
-    provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
     endpoint?: string | undefined;
+    provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
     region?: string | undefined;
     accessKey?: string | undefined;
     secretKey?: string | undefined;
@@ -1185,7 +1307,7 @@ declare const EmailConfigSchema: z.ZodEffects<z.ZodObject<{
     replyTo: z.ZodOptional<z.ZodString>;
     rateLimitPerSecond: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    provider: "console" | "memory" | "smtp" | "resend";
+    provider: "console" | "smtp" | "memory" | "resend";
     secure: boolean;
     rateLimitPerSecond: number;
     host?: string | undefined;
@@ -1196,7 +1318,7 @@ declare const EmailConfigSchema: z.ZodEffects<z.ZodObject<{
     from?: string | undefined;
     replyTo?: string | undefined;
 }, {
-    provider?: "console" | "memory" | "smtp" | "resend" | undefined;
+    provider?: "console" | "smtp" | "memory" | "resend" | undefined;
     host?: string | undefined;
     port?: number | undefined;
     secure?: boolean | undefined;
@@ -1207,7 +1329,7 @@ declare const EmailConfigSchema: z.ZodEffects<z.ZodObject<{
     replyTo?: string | undefined;
     rateLimitPerSecond?: number | undefined;
 }>, {
-    provider: "console" | "memory" | "smtp" | "resend";
+    provider: "console" | "smtp" | "memory" | "resend";
     secure: boolean;
     rateLimitPerSecond: number;
     host?: string | undefined;
@@ -1218,7 +1340,7 @@ declare const EmailConfigSchema: z.ZodEffects<z.ZodObject<{
     from?: string | undefined;
     replyTo?: string | undefined;
 }, {
-    provider?: "console" | "memory" | "smtp" | "resend" | undefined;
+    provider?: "console" | "smtp" | "memory" | "resend" | undefined;
     host?: string | undefined;
     port?: number | undefined;
     secure?: boolean | undefined;
@@ -1239,41 +1361,41 @@ declare const QueueConfigSchema: z.ZodEffects<z.ZodObject<{
     removeOnComplete: z.ZodDefault<z.ZodBoolean>;
     removeOnFail: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    removeOnComplete: boolean;
+    removeOnFail: boolean;
     provider: "memory" | "bullmq";
     maxRetries: number;
     queueName: string;
     concurrency: number;
     retryDelay: number;
-    removeOnComplete: boolean;
-    removeOnFail: boolean;
     redisUrl?: string | undefined;
 }, {
+    removeOnComplete?: boolean | undefined;
+    removeOnFail?: boolean | undefined;
     provider?: "memory" | "bullmq" | undefined;
     maxRetries?: number | undefined;
     redisUrl?: string | undefined;
     queueName?: string | undefined;
     concurrency?: number | undefined;
     retryDelay?: number | undefined;
-    removeOnComplete?: boolean | undefined;
-    removeOnFail?: boolean | undefined;
 }>, {
+    removeOnComplete: boolean;
+    removeOnFail: boolean;
     provider: "memory" | "bullmq";
     maxRetries: number;
     queueName: string;
     concurrency: number;
     retryDelay: number;
-    removeOnComplete: boolean;
-    removeOnFail: boolean;
     redisUrl?: string | undefined;
 }, {
+    removeOnComplete?: boolean | undefined;
+    removeOnFail?: boolean | undefined;
     provider?: "memory" | "bullmq" | undefined;
     maxRetries?: number | undefined;
     redisUrl?: string | undefined;
     queueName?: string | undefined;
     concurrency?: number | undefined;
     retryDelay?: number | undefined;
-    removeOnComplete?: boolean | undefined;
-    removeOnFail?: boolean | undefined;
 }>;
 declare const RetryConfigSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1325,20 +1447,20 @@ declare const TimeoutConfigSchema: z.ZodObject<{
     email: z.ZodDefault<z.ZodNumber>;
     queue: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    email: number;
     enabled: boolean;
     default: number;
     database: number;
     cache: number;
     storage: number;
-    email: number;
     queue: number;
 }, {
+    email?: number | undefined;
     enabled?: boolean | undefined;
     default?: number | undefined;
     database?: number | undefined;
     cache?: number | undefined;
     storage?: number | undefined;
-    email?: number | undefined;
     queue?: number | undefined;
 }>;
 declare const BulkheadConfigSchema: z.ZodObject<{
@@ -1347,15 +1469,15 @@ declare const BulkheadConfigSchema: z.ZodObject<{
     maxQueued: z.ZodDefault<z.ZodNumber>;
     timeout: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
+    timeout: number;
     enabled: boolean;
     maxConcurrent: number;
     maxQueued: number;
-    timeout: number;
 }, {
+    timeout?: number | undefined;
     enabled?: boolean | undefined;
     maxConcurrent?: number | undefined;
     maxQueued?: number | undefined;
-    timeout?: number | undefined;
 }>;
 declare const ResilienceConfigSchema: z.ZodObject<{
     retry: z.ZodDefault<z.ZodObject<{
@@ -1408,20 +1530,20 @@ declare const ResilienceConfigSchema: z.ZodObject<{
         email: z.ZodDefault<z.ZodNumber>;
         queue: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
+        email: number;
         enabled: boolean;
         default: number;
         database: number;
         cache: number;
         storage: number;
-        email: number;
         queue: number;
     }, {
+        email?: number | undefined;
         enabled?: boolean | undefined;
         default?: number | undefined;
         database?: number | undefined;
         cache?: number | undefined;
         storage?: number | undefined;
-        email?: number | undefined;
         queue?: number | undefined;
     }>>;
     bulkhead: z.ZodDefault<z.ZodObject<{
@@ -1430,24 +1552,24 @@ declare const ResilienceConfigSchema: z.ZodObject<{
         maxQueued: z.ZodDefault<z.ZodNumber>;
         timeout: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
+        timeout: number;
         enabled: boolean;
         maxConcurrent: number;
         maxQueued: number;
-        timeout: number;
     }, {
+        timeout?: number | undefined;
         enabled?: boolean | undefined;
         maxConcurrent?: number | undefined;
         maxQueued?: number | undefined;
-        timeout?: number | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     timeout: {
+        email: number;
         enabled: boolean;
         default: number;
         database: number;
         cache: number;
         storage: number;
-        email: number;
         queue: number;
     };
     retry: {
@@ -1466,19 +1588,19 @@ declare const ResilienceConfigSchema: z.ZodObject<{
         monitorInterval: number;
     };
     bulkhead: {
+        timeout: number;
         enabled: boolean;
         maxConcurrent: number;
         maxQueued: number;
-        timeout: number;
     };
 }, {
     timeout?: {
+        email?: number | undefined;
         enabled?: boolean | undefined;
         default?: number | undefined;
         database?: number | undefined;
         cache?: number | undefined;
         storage?: number | undefined;
-        email?: number | undefined;
         queue?: number | undefined;
     } | undefined;
     retry?: {
@@ -1497,10 +1619,10 @@ declare const ResilienceConfigSchema: z.ZodObject<{
         monitorInterval?: number | undefined;
     } | undefined;
     bulkhead?: {
+        timeout?: number | undefined;
         enabled?: boolean | undefined;
         maxConcurrent?: number | undefined;
         maxQueued?: number | undefined;
-        timeout?: number | undefined;
     } | undefined;
 }>;
 declare const LoggingConfigSchema: z.ZodObject<{
@@ -1552,8 +1674,8 @@ declare const TracingConfigSchema: z.ZodObject<{
     endpoint: z.ZodOptional<z.ZodString>;
     exporterType: z.ZodDefault<z.ZodEnum<["otlp-http", "otlp-grpc", "console"]>>;
 }, "strip", z.ZodTypeAny, {
-    provider: "otlp" | "memory" | "noop";
     enabled: boolean;
+    provider: "otlp" | "memory" | "noop";
     sampleRate: number;
     propagateContext: boolean;
     exporterType: "console" | "otlp-http" | "otlp-grpc";
@@ -1563,9 +1685,9 @@ declare const TracingConfigSchema: z.ZodObject<{
     serviceVersion?: string | undefined;
 }, {
     environment?: string | undefined;
-    provider?: "otlp" | "memory" | "noop" | undefined;
     endpoint?: string | undefined;
     enabled?: boolean | undefined;
+    provider?: "otlp" | "memory" | "noop" | undefined;
     serviceName?: string | undefined;
     serviceVersion?: string | undefined;
     sampleRate?: number | undefined;
@@ -1622,8 +1744,8 @@ declare const ObservabilityConfigSchema: z.ZodObject<{
         endpoint: z.ZodOptional<z.ZodString>;
         exporterType: z.ZodDefault<z.ZodEnum<["otlp-http", "otlp-grpc", "console"]>>;
     }, "strip", z.ZodTypeAny, {
-        provider: "otlp" | "memory" | "noop";
         enabled: boolean;
+        provider: "otlp" | "memory" | "noop";
         sampleRate: number;
         propagateContext: boolean;
         exporterType: "console" | "otlp-http" | "otlp-grpc";
@@ -1633,9 +1755,9 @@ declare const ObservabilityConfigSchema: z.ZodObject<{
         serviceVersion?: string | undefined;
     }, {
         environment?: string | undefined;
-        provider?: "otlp" | "memory" | "noop" | undefined;
         endpoint?: string | undefined;
         enabled?: boolean | undefined;
+        provider?: "otlp" | "memory" | "noop" | undefined;
         serviceName?: string | undefined;
         serviceVersion?: string | undefined;
         sampleRate?: number | undefined;
@@ -1658,8 +1780,8 @@ declare const ObservabilityConfigSchema: z.ZodObject<{
         histogramBuckets: number[];
     };
     tracing: {
-        provider: "otlp" | "memory" | "noop";
         enabled: boolean;
+        provider: "otlp" | "memory" | "noop";
         sampleRate: number;
         propagateContext: boolean;
         exporterType: "console" | "otlp-http" | "otlp-grpc";
@@ -1685,9 +1807,9 @@ declare const ObservabilityConfigSchema: z.ZodObject<{
     } | undefined;
     tracing?: {
         environment?: string | undefined;
-        provider?: "otlp" | "memory" | "noop" | undefined;
         endpoint?: string | undefined;
         enabled?: boolean | undefined;
+        provider?: "otlp" | "memory" | "noop" | undefined;
         serviceName?: string | undefined;
         serviceVersion?: string | undefined;
         sampleRate?: number | undefined;
@@ -1713,17 +1835,17 @@ declare const MiddlewareConfigSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         defaultTTL: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        defaultTTL: number;
         enabled: boolean;
+        defaultTTL: number;
     }, {
-        defaultTTL?: number | undefined;
         enabled?: boolean | undefined;
+        defaultTTL?: number | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     enabled: boolean;
     cache: {
-        defaultTTL: number;
         enabled: boolean;
+        defaultTTL: number;
     };
     logging: boolean;
     metrics: boolean;
@@ -1734,8 +1856,8 @@ declare const MiddlewareConfigSchema: z.ZodObject<{
 }, {
     enabled?: boolean | undefined;
     cache?: {
-        defaultTTL?: number | undefined;
         enabled?: boolean | undefined;
+        defaultTTL?: number | undefined;
     } | undefined;
     logging?: boolean | undefined;
     metrics?: boolean | undefined;
@@ -1872,8 +1994,8 @@ declare const PlatformConfigSchema: z.ZodObject<{
         bucket?: string | undefined;
         publicUrl?: string | undefined;
     }, {
-        provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
         endpoint?: string | undefined;
+        provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
         region?: string | undefined;
         accessKey?: string | undefined;
         secretKey?: string | undefined;
@@ -1892,8 +2014,8 @@ declare const PlatformConfigSchema: z.ZodObject<{
         bucket?: string | undefined;
         publicUrl?: string | undefined;
     }, {
-        provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
         endpoint?: string | undefined;
+        provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
         region?: string | undefined;
         accessKey?: string | undefined;
         secretKey?: string | undefined;
@@ -1914,7 +2036,7 @@ declare const PlatformConfigSchema: z.ZodObject<{
         replyTo: z.ZodOptional<z.ZodString>;
         rateLimitPerSecond: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        provider: "console" | "memory" | "smtp" | "resend";
+        provider: "console" | "smtp" | "memory" | "resend";
         secure: boolean;
         rateLimitPerSecond: number;
         host?: string | undefined;
@@ -1925,7 +2047,7 @@ declare const PlatformConfigSchema: z.ZodObject<{
         from?: string | undefined;
         replyTo?: string | undefined;
     }, {
-        provider?: "console" | "memory" | "smtp" | "resend" | undefined;
+        provider?: "console" | "smtp" | "memory" | "resend" | undefined;
         host?: string | undefined;
         port?: number | undefined;
         secure?: boolean | undefined;
@@ -1936,7 +2058,7 @@ declare const PlatformConfigSchema: z.ZodObject<{
         replyTo?: string | undefined;
         rateLimitPerSecond?: number | undefined;
     }>, {
-        provider: "console" | "memory" | "smtp" | "resend";
+        provider: "console" | "smtp" | "memory" | "resend";
         secure: boolean;
         rateLimitPerSecond: number;
         host?: string | undefined;
@@ -1947,7 +2069,7 @@ declare const PlatformConfigSchema: z.ZodObject<{
         from?: string | undefined;
         replyTo?: string | undefined;
     }, {
-        provider?: "console" | "memory" | "smtp" | "resend" | undefined;
+        provider?: "console" | "smtp" | "memory" | "resend" | undefined;
         host?: string | undefined;
         port?: number | undefined;
         secure?: boolean | undefined;
@@ -1968,41 +2090,41 @@ declare const PlatformConfigSchema: z.ZodObject<{
         removeOnComplete: z.ZodDefault<z.ZodBoolean>;
         removeOnFail: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
+        removeOnComplete: boolean;
+        removeOnFail: boolean;
         provider: "memory" | "bullmq";
         maxRetries: number;
         queueName: string;
         concurrency: number;
         retryDelay: number;
-        removeOnComplete: boolean;
-        removeOnFail: boolean;
         redisUrl?: string | undefined;
     }, {
+        removeOnComplete?: boolean | undefined;
+        removeOnFail?: boolean | undefined;
         provider?: "memory" | "bullmq" | undefined;
         maxRetries?: number | undefined;
         redisUrl?: string | undefined;
         queueName?: string | undefined;
         concurrency?: number | undefined;
         retryDelay?: number | undefined;
-        removeOnComplete?: boolean | undefined;
-        removeOnFail?: boolean | undefined;
     }>, {
+        removeOnComplete: boolean;
+        removeOnFail: boolean;
         provider: "memory" | "bullmq";
         maxRetries: number;
         queueName: string;
         concurrency: number;
         retryDelay: number;
-        removeOnComplete: boolean;
-        removeOnFail: boolean;
         redisUrl?: string | undefined;
     }, {
+        removeOnComplete?: boolean | undefined;
+        removeOnFail?: boolean | undefined;
         provider?: "memory" | "bullmq" | undefined;
         maxRetries?: number | undefined;
         redisUrl?: string | undefined;
         queueName?: string | undefined;
         concurrency?: number | undefined;
         retryDelay?: number | undefined;
-        removeOnComplete?: boolean | undefined;
-        removeOnFail?: boolean | undefined;
     }>>;
     resilience: z.ZodDefault<z.ZodObject<{
         retry: z.ZodDefault<z.ZodObject<{
@@ -2055,20 +2177,20 @@ declare const PlatformConfigSchema: z.ZodObject<{
             email: z.ZodDefault<z.ZodNumber>;
             queue: z.ZodDefault<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
+            email: number;
             enabled: boolean;
             default: number;
             database: number;
             cache: number;
             storage: number;
-            email: number;
             queue: number;
         }, {
+            email?: number | undefined;
             enabled?: boolean | undefined;
             default?: number | undefined;
             database?: number | undefined;
             cache?: number | undefined;
             storage?: number | undefined;
-            email?: number | undefined;
             queue?: number | undefined;
         }>>;
         bulkhead: z.ZodDefault<z.ZodObject<{
@@ -2077,24 +2199,24 @@ declare const PlatformConfigSchema: z.ZodObject<{
             maxQueued: z.ZodDefault<z.ZodNumber>;
             timeout: z.ZodDefault<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
+            timeout: number;
             enabled: boolean;
             maxConcurrent: number;
             maxQueued: number;
-            timeout: number;
         }, {
+            timeout?: number | undefined;
             enabled?: boolean | undefined;
             maxConcurrent?: number | undefined;
             maxQueued?: number | undefined;
-            timeout?: number | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         timeout: {
+            email: number;
             enabled: boolean;
             default: number;
             database: number;
             cache: number;
             storage: number;
-            email: number;
             queue: number;
         };
         retry: {
@@ -2113,19 +2235,19 @@ declare const PlatformConfigSchema: z.ZodObject<{
             monitorInterval: number;
         };
         bulkhead: {
+            timeout: number;
             enabled: boolean;
             maxConcurrent: number;
             maxQueued: number;
-            timeout: number;
         };
     }, {
         timeout?: {
+            email?: number | undefined;
             enabled?: boolean | undefined;
             default?: number | undefined;
             database?: number | undefined;
             cache?: number | undefined;
             storage?: number | undefined;
-            email?: number | undefined;
             queue?: number | undefined;
         } | undefined;
         retry?: {
@@ -2144,10 +2266,10 @@ declare const PlatformConfigSchema: z.ZodObject<{
             monitorInterval?: number | undefined;
         } | undefined;
         bulkhead?: {
+            timeout?: number | undefined;
             enabled?: boolean | undefined;
             maxConcurrent?: number | undefined;
             maxQueued?: number | undefined;
-            timeout?: number | undefined;
         } | undefined;
     }>>;
     observability: z.ZodDefault<z.ZodObject<{
@@ -2200,8 +2322,8 @@ declare const PlatformConfigSchema: z.ZodObject<{
             endpoint: z.ZodOptional<z.ZodString>;
             exporterType: z.ZodDefault<z.ZodEnum<["otlp-http", "otlp-grpc", "console"]>>;
         }, "strip", z.ZodTypeAny, {
-            provider: "otlp" | "memory" | "noop";
             enabled: boolean;
+            provider: "otlp" | "memory" | "noop";
             sampleRate: number;
             propagateContext: boolean;
             exporterType: "console" | "otlp-http" | "otlp-grpc";
@@ -2211,9 +2333,9 @@ declare const PlatformConfigSchema: z.ZodObject<{
             serviceVersion?: string | undefined;
         }, {
             environment?: string | undefined;
-            provider?: "otlp" | "memory" | "noop" | undefined;
             endpoint?: string | undefined;
             enabled?: boolean | undefined;
+            provider?: "otlp" | "memory" | "noop" | undefined;
             serviceName?: string | undefined;
             serviceVersion?: string | undefined;
             sampleRate?: number | undefined;
@@ -2236,8 +2358,8 @@ declare const PlatformConfigSchema: z.ZodObject<{
             histogramBuckets: number[];
         };
         tracing: {
-            provider: "otlp" | "memory" | "noop";
             enabled: boolean;
+            provider: "otlp" | "memory" | "noop";
             sampleRate: number;
             propagateContext: boolean;
             exporterType: "console" | "otlp-http" | "otlp-grpc";
@@ -2263,9 +2385,9 @@ declare const PlatformConfigSchema: z.ZodObject<{
         } | undefined;
         tracing?: {
             environment?: string | undefined;
-            provider?: "otlp" | "memory" | "noop" | undefined;
             endpoint?: string | undefined;
             enabled?: boolean | undefined;
+            provider?: "otlp" | "memory" | "noop" | undefined;
             serviceName?: string | undefined;
             serviceVersion?: string | undefined;
             sampleRate?: number | undefined;
@@ -2291,17 +2413,17 @@ declare const PlatformConfigSchema: z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
             defaultTTL: z.ZodDefault<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            defaultTTL: number;
             enabled: boolean;
+            defaultTTL: number;
         }, {
-            defaultTTL?: number | undefined;
             enabled?: boolean | undefined;
+            defaultTTL?: number | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
         cache: {
-            defaultTTL: number;
             enabled: boolean;
+            defaultTTL: number;
         };
         logging: boolean;
         metrics: boolean;
@@ -2312,8 +2434,8 @@ declare const PlatformConfigSchema: z.ZodObject<{
     }, {
         enabled?: boolean | undefined;
         cache?: {
-            defaultTTL?: number | undefined;
             enabled?: boolean | undefined;
+            defaultTTL?: number | undefined;
         } | undefined;
         logging?: boolean | undefined;
         metrics?: boolean | undefined;
@@ -2323,6 +2445,18 @@ declare const PlatformConfigSchema: z.ZodObject<{
         } | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    email: {
+        provider: "console" | "smtp" | "memory" | "resend";
+        secure: boolean;
+        rateLimitPerSecond: number;
+        host?: string | undefined;
+        port?: number | undefined;
+        username?: string | undefined;
+        password?: string | undefined;
+        apiKey?: string | undefined;
+        from?: string | undefined;
+        replyTo?: string | undefined;
+    };
     database: {
         provider: "memory" | "postgres" | "supabase";
         poolSize: number;
@@ -2356,36 +2490,24 @@ declare const PlatformConfigSchema: z.ZodObject<{
         bucket?: string | undefined;
         publicUrl?: string | undefined;
     };
-    email: {
-        provider: "console" | "memory" | "smtp" | "resend";
-        secure: boolean;
-        rateLimitPerSecond: number;
-        host?: string | undefined;
-        port?: number | undefined;
-        username?: string | undefined;
-        password?: string | undefined;
-        apiKey?: string | undefined;
-        from?: string | undefined;
-        replyTo?: string | undefined;
-    };
     queue: {
+        removeOnComplete: boolean;
+        removeOnFail: boolean;
         provider: "memory" | "bullmq";
         maxRetries: number;
         queueName: string;
         concurrency: number;
         retryDelay: number;
-        removeOnComplete: boolean;
-        removeOnFail: boolean;
         redisUrl?: string | undefined;
     };
     resilience: {
         timeout: {
+            email: number;
             enabled: boolean;
             default: number;
             database: number;
             cache: number;
             storage: number;
-            email: number;
             queue: number;
         };
         retry: {
@@ -2404,10 +2526,10 @@ declare const PlatformConfigSchema: z.ZodObject<{
             monitorInterval: number;
         };
         bulkhead: {
+            timeout: number;
             enabled: boolean;
             maxConcurrent: number;
             maxQueued: number;
-            timeout: number;
         };
     };
     observability: {
@@ -2426,8 +2548,8 @@ declare const PlatformConfigSchema: z.ZodObject<{
             histogramBuckets: number[];
         };
         tracing: {
-            provider: "otlp" | "memory" | "noop";
             enabled: boolean;
+            provider: "otlp" | "memory" | "noop";
             sampleRate: number;
             propagateContext: boolean;
             exporterType: "console" | "otlp-http" | "otlp-grpc";
@@ -2440,8 +2562,8 @@ declare const PlatformConfigSchema: z.ZodObject<{
     middleware: {
         enabled: boolean;
         cache: {
-            defaultTTL: number;
             enabled: boolean;
+            defaultTTL: number;
         };
         logging: boolean;
         metrics: boolean;
@@ -2451,6 +2573,18 @@ declare const PlatformConfigSchema: z.ZodObject<{
         };
     };
 }, {
+    email?: {
+        provider?: "console" | "smtp" | "memory" | "resend" | undefined;
+        host?: string | undefined;
+        port?: number | undefined;
+        secure?: boolean | undefined;
+        username?: string | undefined;
+        password?: string | undefined;
+        apiKey?: string | undefined;
+        from?: string | undefined;
+        replyTo?: string | undefined;
+        rateLimitPerSecond?: number | undefined;
+    } | undefined;
     database?: {
         provider?: "memory" | "postgres" | "supabase" | undefined;
         url?: string | undefined;
@@ -2474,8 +2608,8 @@ declare const PlatformConfigSchema: z.ZodObject<{
         maxRetries?: number | undefined;
     } | undefined;
     storage?: {
-        provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
         endpoint?: string | undefined;
+        provider?: "memory" | "supabase" | "s3" | "minio" | "r2" | undefined;
         region?: string | undefined;
         accessKey?: string | undefined;
         secretKey?: string | undefined;
@@ -2484,36 +2618,24 @@ declare const PlatformConfigSchema: z.ZodObject<{
         forcePathStyle?: boolean | undefined;
         signedUrlExpiry?: number | undefined;
     } | undefined;
-    email?: {
-        provider?: "console" | "memory" | "smtp" | "resend" | undefined;
-        host?: string | undefined;
-        port?: number | undefined;
-        secure?: boolean | undefined;
-        username?: string | undefined;
-        password?: string | undefined;
-        apiKey?: string | undefined;
-        from?: string | undefined;
-        replyTo?: string | undefined;
-        rateLimitPerSecond?: number | undefined;
-    } | undefined;
     queue?: {
+        removeOnComplete?: boolean | undefined;
+        removeOnFail?: boolean | undefined;
         provider?: "memory" | "bullmq" | undefined;
         maxRetries?: number | undefined;
         redisUrl?: string | undefined;
         queueName?: string | undefined;
         concurrency?: number | undefined;
         retryDelay?: number | undefined;
-        removeOnComplete?: boolean | undefined;
-        removeOnFail?: boolean | undefined;
     } | undefined;
     resilience?: {
         timeout?: {
+            email?: number | undefined;
             enabled?: boolean | undefined;
             default?: number | undefined;
             database?: number | undefined;
             cache?: number | undefined;
             storage?: number | undefined;
-            email?: number | undefined;
             queue?: number | undefined;
         } | undefined;
         retry?: {
@@ -2532,10 +2654,10 @@ declare const PlatformConfigSchema: z.ZodObject<{
             monitorInterval?: number | undefined;
         } | undefined;
         bulkhead?: {
+            timeout?: number | undefined;
             enabled?: boolean | undefined;
             maxConcurrent?: number | undefined;
             maxQueued?: number | undefined;
-            timeout?: number | undefined;
         } | undefined;
     } | undefined;
     observability?: {
@@ -2555,9 +2677,9 @@ declare const PlatformConfigSchema: z.ZodObject<{
         } | undefined;
         tracing?: {
             environment?: string | undefined;
-            provider?: "otlp" | "memory" | "noop" | undefined;
             endpoint?: string | undefined;
             enabled?: boolean | undefined;
+            provider?: "otlp" | "memory" | "noop" | undefined;
             serviceName?: string | undefined;
             serviceVersion?: string | undefined;
             sampleRate?: number | undefined;
@@ -2568,8 +2690,8 @@ declare const PlatformConfigSchema: z.ZodObject<{
     middleware?: {
         enabled?: boolean | undefined;
         cache?: {
-            defaultTTL?: number | undefined;
             enabled?: boolean | undefined;
+            defaultTTL?: number | undefined;
         } | undefined;
         logging?: boolean | undefined;
         metrics?: boolean | undefined;
@@ -2720,45 +2842,86 @@ declare class MemoryEmail implements IEmail {
     get size(): number;
 }
 
+/**
+ * Enhanced Memory Queue Implementation
+ *
+ * Full-featured in-memory queue for testing with:
+ * - Retry/backoff support
+ * - Job state management
+ * - Event emitters
+ * - Dead letter queue (failed jobs)
+ * - Recurring job support
+ *
+ * Design: Self-contained, no external dependencies, full IQueue compliance
+ */
+
 declare class MemoryQueue<T = unknown> implements IQueue<T> {
     private jobs;
     private handlers;
+    private eventHandlers;
+    private paused;
+    private processingConcurrency;
+    private activeCount;
+    private repeatIntervals;
+    private queueName;
+    private processingQueue;
+    private isProcessing;
+    constructor(name?: string);
     add(name: string, data: T, options?: JobOptions): Promise<Job<T>>;
     addBulk(jobs: Array<{
         name: string;
         data: T;
         options?: JobOptions;
     }>): Promise<Job<T>[]>;
-    process(handler: (job: Job<T>) => Promise<unknown>): void;
+    process(handler: (job: Job<T>) => Promise<unknown>, options?: {
+        concurrency?: number;
+    }): void;
     getJob(id: string): Promise<Job<T> | null>;
     removeJob(id: string): Promise<void>;
     pause(): Promise<void>;
     resume(): Promise<void>;
-    getStats(): Promise<{
-        waiting: number;
-        active: number;
-        completed: number;
-        failed: number;
-        delayed: number;
-    }>;
+    getStats(): Promise<QueueStats>;
     healthCheck(): Promise<boolean>;
     close(): Promise<void>;
+    addRecurring(name: string, data: T, repeat: RepeatOptions, options?: Omit<JobOptions, "repeat">): Promise<Job<T>>;
+    getJobs(state: JobState | JobState[], start?: number, end?: number): Promise<Job<T>[]>;
+    getFailedJobs(start?: number, end?: number): Promise<Job<T>[]>;
+    retryJob(id: string): Promise<void>;
+    replayAllFailed(): Promise<number>;
+    updateProgress(id: string, progress: number): Promise<void>;
+    clean(grace: number, limit: number, state: JobState): Promise<string[]>;
+    obliterate(options?: {
+        force?: boolean;
+    }): Promise<void>;
+    on(event: JobEventType, handler: JobEventHandler<T>): void;
+    off(event: JobEventType, handler: JobEventHandler<T>): void;
+    getName(): string;
     /**
      * Clear all jobs (for testing)
      */
     clear(): void;
     /**
-     * Get all jobs (for testing)
+     * Get all jobs regardless of state (for testing)
      */
-    getJobs(): Job<T>[];
+    getAllJobs(): Job<T>[];
     /**
-     * Get pending jobs (for testing)
+     * Get pending (waiting) jobs (for testing)
      */
     getPendingJobs(): Job<T>[];
     /**
      * Get number of jobs (for testing)
      */
     get size(): number;
+    /**
+     * Wait for all jobs to complete (for testing)
+     */
+    drain(timeout?: number): Promise<void>;
+    private hasWaitingJobs;
+    private processNext;
+    private executeWithTimeout;
+    private handleJobFailure;
+    private emitEvent;
+    private toPublicJob;
 }
 
 /**
@@ -2783,4 +2946,4 @@ declare class ConsoleEmail implements IEmail {
     private formatAddresses;
 }
 
-export { type SpanContext as $, type LoggerConfig as A, type MetricTags as B, ConsoleEmail as C, type Secret as D, EnvSecrets as E, type SecretMetadata as F, type GetSecretOptions as G, type HistogramStats as H, type IPlatform as I, type Job as J, type SetSecretOptions as K, type LogLevel as L, MemoryDatabase as M, NoopLogger as N, type RotationResult as O, type PlatformHealthStatus as P, type QueryResult as Q, type RotateSecretOptions as R, type StorageFile as S, type TimingStats as T, type UploadOptions as U, createPlatformAsync as V, createScopedMetrics as W, MemoryTracing as X, NoopTracing as Y, type ITracing as Z, type ISpan as _, MemoryCache as a, type SpanOptions as a0, type SpanStatus as a1, type SpanKind as a2, type TracingConfig as a3, type EmailAddress as a4, type EmailAttachment as a5, type SpanStatusCode as a6, type SpanEvent as a7, DatabaseProviderSchema as a8, CacheProviderSchema as a9, type QueueConfig as aA, type ResilienceConfig as aB, type ObservabilityConfig as aC, type MiddlewareConfig as aD, loadConfig as aE, validateConfig as aF, safeValidateConfig as aG, getDefaultConfig as aH, StorageProviderSchema as aa, EmailProviderSchema as ab, QueueProviderSchema as ac, TracingProviderSchema as ad, LogLevelSchema as ae, DatabaseConfigSchema as af, CacheConfigSchema as ag, StorageConfigSchema as ah, EmailConfigSchema as ai, QueueConfigSchema as aj, RetryConfigSchema as ak, CircuitBreakerConfigSchema as al, TimeoutConfigSchema as am, BulkheadConfigSchema as an, ResilienceConfigSchema as ao, LoggingConfigSchema as ap, MetricsConfigSchema as aq, TracingConfigSchema as ar, ObservabilityConfigSchema as as, MiddlewareConfigSchema as at, PlatformConfigSchema as au, type PlatformConfig as av, type DatabaseConfig as aw, type CacheConfig as ax, type StorageConfig as ay, type EmailConfig as az, MemoryStorage as b, MemoryEmail as c, MemoryQueue as d, type IDatabase as e, MemorySecrets as f, createPlatform as g, ConsoleLogger as h, MemoryMetrics as i, NoopMetrics as j, type IQueryBuilder as k, type ICache as l, type IStorage as m, type IEmail as n, type IQueue as o, type ILogger as p, type IMetrics as q, type ISecrets as r, type JobOptions as s, type EmailMessage as t, type MetricsSummary as u, type EmailResult as v, type ICacheOptions as w, type JobResult as x, type LogMeta as y, type LogEntry as z };
+export { type RotateSecretOptions as $, type JobResult as A, type JobContext as B, ConsoleEmail as C, type JobEvent as D, EnvSecrets as E, type QueueStats as F, type BackoffOptions as G, type LogMeta as H, type IPlatform as I, type Job as J, type LogEntry as K, type LogLevel as L, MemoryDatabase as M, NoopLogger as N, type LoggerConfig as O, type PlatformHealthStatus as P, type QueryResult as Q, type RepeatOptions as R, type StorageFile as S, type MetricTags as T, type UploadOptions as U, type HistogramStats as V, type TimingStats as W, type Secret as X, type SecretMetadata as Y, type GetSecretOptions as Z, type SetSecretOptions as _, MemoryCache as a, type RotationResult as a0, createPlatformAsync as a1, createScopedMetrics as a2, MemoryTracing as a3, NoopTracing as a4, type ITracing as a5, type ISpan as a6, type SpanContext as a7, type SpanOptions as a8, type SpanStatus as a9, MetricsConfigSchema as aA, TracingConfigSchema as aB, ObservabilityConfigSchema as aC, MiddlewareConfigSchema as aD, PlatformConfigSchema as aE, type PlatformConfig as aF, type DatabaseConfig as aG, type CacheConfig as aH, type StorageConfig as aI, type EmailConfig as aJ, type QueueConfig as aK, type ResilienceConfig as aL, type ObservabilityConfig as aM, type MiddlewareConfig as aN, loadConfig as aO, validateConfig as aP, safeValidateConfig as aQ, getDefaultConfig as aR, type SpanKind as aa, type TracingConfig as ab, type EmailAddress as ac, type EmailAttachment as ad, calculateBackoff as ae, generateJobId as af, type SpanStatusCode as ag, type SpanEvent as ah, DatabaseProviderSchema as ai, CacheProviderSchema as aj, StorageProviderSchema as ak, EmailProviderSchema as al, QueueProviderSchema as am, TracingProviderSchema as an, LogLevelSchema as ao, DatabaseConfigSchema as ap, CacheConfigSchema as aq, StorageConfigSchema as ar, EmailConfigSchema as as, QueueConfigSchema as at, RetryConfigSchema as au, CircuitBreakerConfigSchema as av, TimeoutConfigSchema as aw, BulkheadConfigSchema as ax, ResilienceConfigSchema as ay, LoggingConfigSchema as az, MemoryStorage as b, MemoryEmail as c, MemoryQueue as d, type IDatabase as e, MemorySecrets as f, createPlatform as g, ConsoleLogger as h, MemoryMetrics as i, NoopMetrics as j, type IQueryBuilder as k, type ICache as l, type IStorage as m, type IEmail as n, type IQueue as o, type ILogger as p, type IMetrics as q, type ISecrets as r, type JobOptions as s, type EmailMessage as t, type MetricsSummary as u, type EmailResult as v, type JobState as w, type JobEventType as x, type JobEventHandler as y, type ICacheOptions as z };