@shohaghinfo/aerojs 0.1.2 → 0.3.0

package/dist/notifications/notification-manager.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @file notification-manager.ts
+ * @description Central Notification Dispatcher and Facade for AeroJS.
+ * Dispatches notifications across multiple channels (mail, database, broadcast, sms, custom).
+ */
+import type { Notification } from './notification.js';
+export type ChannelHandler = (notifiable: any, notification: Notification) => Promise<any> | any;
+export interface SentNotificationRecord {
+    notifiable: any;
+    notification: Notification;
+    channels: string[];
+}
+export declare class NotificationManager {
+    private channels;
+    private isFaked;
+    private sentRecords;
+    constructor();
+    private registerDefaultChannels;
+    extend(channelName: string, handler: ChannelHandler): this;
+    /**
+     * Dispatches a notification to one or multiple notifiable recipients.
+     */
+    send(notifiables: any | any[], notification: Notification): Promise<void>;
+    /**
+     * Enables mock recording for testing assertions.
+     */
+    fake(): void;
+    restore(): void;
+    getSent(): SentNotificationRecord[];
+    assertSentTo(notifiable: any, notificationClass: any, callback?: (notification: any) => boolean): void;
+    assertNotSentTo(notifiable: any, notificationClass: any): void;
+}
+export declare const Notifications: NotificationManager;
+/**
+ * Mixin / Helper function to send notification from a user/patient model.
+ * Example: notify(user, new InvoiceNotification(inv));
+ */
+export declare function notify(notifiable: any, notification: Notification): Promise<void>;
+//# sourceMappingURL=notification-manager.d.ts.map

package/dist/notifications/notification-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-manager.d.ts","sourceRoot":"","sources":["../../src/notifications/notification-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAA8B,MAAM,mBAAmB,CAAC;AAIlF,MAAM,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAEjG,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,GAAG,CAAC;IAChB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAgC;;IAMnD,OAAO,CAAC,uBAAuB;IAiDxB,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI;IAKjE;;OAEG;IACU,IAAI,CACf,WAAW,EAAE,GAAG,GAAG,GAAG,EAAE,EACxB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,IAAI,CAAC;IAoBhB;;OAEG;IACI,IAAI,IAAI,IAAI;IAKZ,OAAO,IAAI,IAAI;IAKf,OAAO,IAAI,sBAAsB,EAAE;IAInC,YAAY,CACjB,UAAU,EAAE,GAAG,EACf,iBAAiB,EAAE,GAAG,EACtB,QAAQ,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,KAAK,OAAO,GACxC,IAAI;IAaA,eAAe,CAAC,UAAU,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,GAAG,IAAI;CAWtE;AAED,eAAO,MAAM,aAAa,qBAA4B,CAAC;AAEvD;;;GAGG;AACH,wBAAsB,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvF"}

package/dist/notifications/notification-manager.js

@@ -0,0 +1,130 @@
+/**
+ * @file notification-manager.ts
+ * @description Central Notification Dispatcher and Facade for AeroJS.
+ * Dispatches notifications across multiple channels (mail, database, broadcast, sms, custom).
+ */
+import * as crypto from 'node:crypto';
+import { Mail } from '../mail/mailer.js';
+import { DB } from '../database/connection.js';
+export class NotificationManager {
+    channels = new Map();
+    isFaked = false;
+    sentRecords = [];
+    constructor() {
+        this.registerDefaultChannels();
+    }
+    registerDefaultChannels() {
+        // 1. Mail Channel
+        this.channels.set('mail', async (notifiable, notification) => {
+            if (typeof notification.toMail !== 'function')
+                return;
+            const mailMessage = await notification.toMail(notifiable);
+            // If no explicit recipient on message, infer from notifiable
+            if (mailMessage.toAddresses.length === 0) {
+                const email = notifiable.email || notifiable.emailAddress;
+                if (email) {
+                    mailMessage.to(email);
+                }
+            }
+            return await Mail.send(mailMessage);
+        });
+        // 2. Database Channel
+        this.channels.set('database', async (notifiable, notification) => {
+            if (typeof notification.toDatabase !== 'function')
+                return;
+            const data = await notification.toDatabase(notifiable);
+            const id = notification.id || crypto.randomUUID();
+            const record = {
+                id,
+                type: notification.constructor.name,
+                notifiableType: notifiable.constructor?.name || 'User',
+                notifiableId: notifiable.id,
+                data,
+                readAt: null,
+                createdAt: new Date(),
+            };
+            try {
+                await DB.table('notifications').insert(record);
+            }
+            catch {
+                // Fallback if table doesn't exist yet in tests
+            }
+            return record;
+        });
+        // 3. Broadcast Channel
+        this.channels.set('broadcast', async (notifiable, notification) => {
+            if (typeof notification.toBroadcast !== 'function')
+                return;
+            const broadcastData = await notification.toBroadcast(notifiable);
+            return broadcastData;
+        });
+    }
+    extend(channelName, handler) {
+        this.channels.set(channelName.toLowerCase(), handler);
+        return this;
+    }
+    /**
+     * Dispatches a notification to one or multiple notifiable recipients.
+     */
+    async send(notifiables, notification) {
+        const list = Array.isArray(notifiables) ? notifiables : [notifiables];
+        for (const notifiable of list) {
+            const channels = await notification.via(notifiable);
+            if (this.isFaked) {
+                this.sentRecords.push({ notifiable, notification, channels });
+                continue;
+            }
+            for (const channel of channels) {
+                const handler = this.channels.get(channel.toLowerCase());
+                if (handler) {
+                    await handler(notifiable, notification);
+                }
+            }
+        }
+    }
+    /**
+     * Enables mock recording for testing assertions.
+     */
+    fake() {
+        this.isFaked = true;
+        this.sentRecords = [];
+    }
+    restore() {
+        this.isFaked = false;
+        this.sentRecords = [];
+    }
+    getSent() {
+        return this.sentRecords;
+    }
+    assertSentTo(notifiable, notificationClass, callback) {
+        const found = this.sentRecords.some((record) => {
+            const matchesNotifiable = record.notifiable === notifiable || record.notifiable.id === notifiable.id;
+            const matchesClass = record.notification instanceof notificationClass || record.notification.constructor.name === notificationClass.name;
+            if (!matchesNotifiable || !matchesClass)
+                return false;
+            return callback ? callback(record.notification) : true;
+        });
+        if (!found) {
+            throw new Error(`Expected notification ${notificationClass.name} was not sent to notifiable.`);
+        }
+    }
+    assertNotSentTo(notifiable, notificationClass) {
+        const found = this.sentRecords.some((record) => {
+            const matchesNotifiable = record.notifiable === notifiable || record.notifiable.id === notifiable.id;
+            const matchesClass = record.notification instanceof notificationClass || record.notification.constructor.name === notificationClass.name;
+            return matchesNotifiable && matchesClass;
+        });
+        if (found) {
+            throw new Error(`Unexpected notification ${notificationClass.name} was sent to notifiable.`);
+        }
+    }
+}
+export const Notifications = new NotificationManager();
+/**
+ * Mixin / Helper function to send notification from a user/patient model.
+ * Example: notify(user, new InvoiceNotification(inv));
+ */
+export async function notify(notifiable, notification) {
+    return await Notifications.send(notifiable, notification);
+}
+//# sourceMappingURL=notification-manager.js.map

package/dist/notifications/notification-manager.js.map

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

package/dist/notifications/notification.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file notification.ts
+ * @description Base Notification class for AeroJS multi-channel dispatch.
+ */
+import { MailMessage } from '../mail/message.js';
+export interface DatabaseNotificationRecord {
+    id: string;
+    type: string;
+    notifiableType?: string;
+    notifiableId?: string | number;
+    data: Record<string, any>;
+    readAt?: Date | null;
+    createdAt: Date;
+}
+export interface BroadcastNotificationData {
+    channel: string;
+    event: string;
+    data: Record<string, any>;
+}
+export interface SmsNotificationData {
+    to: string;
+    message: string;
+}
+export declare abstract class Notification {
+    id?: string;
+    /**
+     * Defines which channels this notification should be sent through.
+     * E.g. ['mail', 'database', 'broadcast', 'sms']
+     */
+    abstract via(notifiable: any): string[] | Promise<string[]>;
+    /**
+     * Builds the email representation of the notification.
+     */
+    toMail?(notifiable: any): MailMessage | Promise<MailMessage>;
+    /**
+     * Builds the database representation of the notification.
+     */
+    toDatabase?(notifiable: any): Record<string, any> | Promise<Record<string, any>>;
+    /**
+     * Builds the realtime broadcast payload.
+     */
+    toBroadcast?(notifiable: any): BroadcastNotificationData | Promise<BroadcastNotificationData>;
+    /**
+     * Builds the SMS payload.
+     */
+    toSms?(notifiable: any): SmsNotificationData | Promise<SmsNotificationData>;
+}
+//# sourceMappingURL=notification.d.ts.map

package/dist/notifications/notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/notifications/notification.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1B,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8BAAsB,YAAY;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;aACa,GAAG,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAElE;;OAEG;IACI,MAAM,CAAC,CAAC,UAAU,EAAE,GAAG,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAEnE;;OAEG;IACI,UAAU,CAAC,CAAC,UAAU,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvF;;OAEG;IACI,WAAW,CAAC,CAAC,UAAU,EAAE,GAAG,GAAG,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAEpG;;OAEG;IACI,KAAK,CAAC,CAAC,UAAU,EAAE,GAAG,GAAG,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;CACnF"}

package/dist/notifications/notification.js

@@ -0,0 +1,9 @@
+/**
+ * @file notification.ts
+ * @description Base Notification class for AeroJS multi-channel dispatch.
+ */
+import { MailMessage } from '../mail/message.js';
+export class Notification {
+    id;
+}
+//# sourceMappingURL=notification.js.map

package/dist/notifications/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../src/notifications/notification.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAuBjD,MAAM,OAAgB,YAAY;IACzB,EAAE,CAAU;CA2BpB"}

package/dist/queue/drivers/redis-queue-driver.d.ts

@@ -1,14 +1,34 @@
+/**
+ * @file redis-queue-driver.ts
+ * @description Production-grade Redis Queue Driver for AeroJS.
+ * Supports FIFO queueing (LPUSH/RPOP), delayed dispatch (ZADD/ZRANGEBYSCORE),
+ * job reservation tracking (HSET), release with backoff retry, and DLQ (Dead Letter Queue).
+ */
 import type { QueueDriver, QueuedJobRecord, PushOptions } from './queue-driver.js';
 import { RedisClient } from '../../redis/redis-client.js';
+export interface FailedJobDetails extends QueuedJobRecord {
+    failedAt: Date;
+    error?: string;
+}
 export declare class RedisQueueDriver implements QueueDriver {
     private client;
     constructor(client: RedisClient);
     private queueKey;
     private delayedKey;
+    private reservedKey;
+    private failedKey;
     push(payload: string, options?: PushOptions): Promise<string | number>;
     pop(queue?: string): Promise<QueuedJobRecord | null>;
     delete(id: string | number, queue?: string): Promise<boolean>;
     release(id: string | number, delaySeconds?: number, queue?: string): Promise<boolean>;
+    /**
+     * Moves a permanently failed job to Dead Letter Queue (DLQ).
+     */
+    fail(id: string | number, error?: any, queue?: string): Promise<boolean>;
+    /**
+     * Retrieves all failed jobs from the Dead Letter Queue.
+     */
+    getFailed(queue?: string): Promise<FailedJobDetails[]>;
     size(queue?: string): Promise<number>;
     clear(queue?: string): Promise<void>;
     private migrateDelayedJobs;

package/dist/queue/drivers/redis-queue-driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-queue-driver.d.ts","sourceRoot":"","sources":["../../../src/queue/drivers/redis-queue-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAI/B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;IAIL,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IA6BtE,GAAG,CAAC,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAc/D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAMxE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,SAAI,EAAE,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3F,IAAI,CAAC,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD,KAAK,CAAC,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YAK9C,kBAAkB;CAsBjC"}
+{"version":3,"file":"redis-queue-driver.d.ts","sourceRoot":"","sources":["../../../src/queue/drivers/redis-queue-driver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAI/B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;IAIJ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IA+BtE,GAAG,CAAC,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAkB/D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,SAAI,EAAE,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IA2BxG;;OAEG;IACU,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBhG;;OAEG;IACU,SAAS,CAAC,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAKjE,IAAI,CAAC,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD,KAAK,CAAC,KAAK,GAAE,MAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;YAS9C,kBAAkB;CA0BjC"}

package/dist/queue/drivers/redis-queue-driver.js

@@ -1,3 +1,9 @@
+/**
+ * @file redis-queue-driver.ts
+ * @description Production-grade Redis Queue Driver for AeroJS.
+ * Supports FIFO queueing (LPUSH/RPOP), delayed dispatch (ZADD/ZRANGEBYSCORE),
+ * job reservation tracking (HSET), release with backoff retry, and DLQ (Dead Letter Queue).
+ */
 import { RedisClient } from '../../redis/redis-client.js';
 import * as crypto from 'node:crypto';
 export class RedisQueueDriver {
@@ -11,6 +17,12 @@ export class RedisQueueDriver {
     delayedKey(queue) {
         return `queue:${queue}:delayed`;
     }
+    reservedKey(queue) {
+        return `queue:${queue}:reserved`;
+    }
+    failedKey(queue) {
+        return `queue:${queue}:failed`;
+    }
     async push(payload, options) {
         const queue = options?.queue || 'default';
         const delay = options?.delay || 0;
@@ -22,14 +34,16 @@ export class RedisQueueDriver {
             attempts: 0,
             reservedAt: null,
             availableAt: new Date(Date.now() + delay * 1000),
-            createdAt: new Date()
+            createdAt: new Date(),
         };
         const serialized = JSON.stringify(jobRecord);
         if (delay > 0) {
-            // In a full implementation we'd use ZADD for delayed jobs.
-            // Since our simple client might not have ZADD exposed yet, we'll expose a raw command wrapper or add zadd
-            // Let's use the raw command wrapper directly:
-            await this.client.getRawConnection().sendCommand(['ZADD', this.delayedKey(queue), jobRecord.availableAt.getTime(), serialized]);
+            await this.client.getRawConnection().sendCommand([
+                'ZADD',
+                this.delayedKey(queue),
+                jobRecord.availableAt.getTime(),
+                serialized,
+            ]);
         }
         else {
             await this.client.lpush(this.queueKey(queue), serialized);
@@ -37,56 +51,101 @@ export class RedisQueueDriver {
         return id;
     }
     async pop(queue = 'default') {
-        // First, migrate delayed jobs that are ready
+        // 1. Migrate delayed jobs that are ready to run
         await this.migrateDelayedJobs(queue);
+        // 2. Pop next available job
         const data = await this.client.rpop(this.queueKey(queue));
         if (!data)
             return null;
         const job = JSON.parse(data);
         job.attempts += 1;
         job.reservedAt = new Date();
+        // 3. Track in reserved hash while worker is processing
+        await this.client.hset(this.reservedKey(queue), String(job.id), JSON.stringify(job));
         return job;
     }
     async delete(id, queue = 'default') {
-        // Since jobs are removed from the list when popped, delete is effectively a no-op
-        // unless we were keeping them in a processing set.
-        return true;
+        const deleted = await this.client.hdel(this.reservedKey(queue), String(id));
+        return deleted > 0;
     }
     async release(id, delaySeconds = 0, queue = 'default') {
-        // We don't have the job payload here directly in this API signature if we just use id.
-        // In a full implementation, the QueueManager passes the whole job or payload, but QueueDriver release only takes ID.
-        // This implies we need to store job state, or perhaps we just return false if we can't implement it perfectly without a payload.
-        // Assuming we can't easily release without the payload unless we fetch it, but it was already popped.
-        // This is a common flaw in simple interfaces. We will return false for now or throw.
-        return false;
+        const raw = await this.client.hget(this.reservedKey(queue), String(id));
+        if (!raw)
+            return false;
+        // Remove from reserved
+        await this.client.hdel(this.reservedKey(queue), String(id));
+        const job = JSON.parse(raw);
+        job.reservedAt = null;
+        job.availableAt = new Date(Date.now() + delaySeconds * 1000);
+        const serialized = JSON.stringify(job);
+        if (delaySeconds > 0) {
+            await this.client.getRawConnection().sendCommand([
+                'ZADD',
+                this.delayedKey(queue),
+                job.availableAt.getTime(),
+                serialized,
+            ]);
+        }
+        else {
+            await this.client.lpush(this.queueKey(queue), serialized);
+        }
+        return true;
+    }
+    /**
+     * Moves a permanently failed job to Dead Letter Queue (DLQ).
+     */
+    async fail(id, error, queue = 'default') {
+        const raw = await this.client.hget(this.reservedKey(queue), String(id));
+        if (!raw)
+            return false;
+        await this.client.hdel(this.reservedKey(queue), String(id));
+        const job = JSON.parse(raw);
+        const failedRecord = {
+            ...job,
+            failedAt: new Date(),
+            error: error instanceof Error ? error.stack || error.message : String(error || 'Unknown error'),
+        };
+        await this.client.hset(this.failedKey(queue), String(id), JSON.stringify(failedRecord));
+        return true;
+    }
+    /**
+     * Retrieves all failed jobs from the Dead Letter Queue.
+     */
+    async getFailed(queue = 'default') {
+        const records = await this.client.hgetall(this.failedKey(queue));
+        return Object.values(records).map((r) => JSON.parse(r));
     }
     async size(queue = 'default') {
-        return this.client.llen(this.queueKey(queue));
+        return await this.client.llen(this.queueKey(queue));
     }
     async clear(queue = 'default') {
-        await this.client.del(this.queueKey(queue));
-        await this.client.del(this.delayedKey(queue));
+        await this.client.del(this.queueKey(queue), this.delayedKey(queue), this.reservedKey(queue), this.failedKey(queue));
     }
     async migrateDelayedJobs(queue) {
         const now = Date.now();
-        // Using raw commands for ZRANGEBYSCORE and ZREM
-        // ZRANGEBYSCORE key -inf <now>
-        const readyJobs = await this.client.getRawConnection().sendCommand([
-            'ZRANGEBYSCORE',
-            this.delayedKey(queue),
-            '-inf',
-            now
-        ]);
-        if (readyJobs && readyJobs.length > 0) {
-            for (const job of readyJobs) {
-                // ZREM returns 1 if the element was removed, 0 if it was already removed by another worker
-                const removed = await this.client.getRawConnection().sendCommand(['ZREM', this.delayedKey(queue), job]);
-                if (removed === 1) {
-                    // Push only the jobs this worker successfully claimed
-                    await this.client.rpush(this.queueKey(queue), job);
+        try {
+            const readyJobs = await this.client.getRawConnection().sendCommand([
+                'ZRANGEBYSCORE',
+                this.delayedKey(queue),
+                '-inf',
+                now,
+            ]);
+            if (readyJobs && readyJobs.length > 0) {
+                for (const job of readyJobs) {
+                    const removed = await this.client.getRawConnection().sendCommand([
+                        'ZREM',
+                        this.delayedKey(queue),
+                        job,
+                    ]);
+                    if (removed === 1) {
+                        await this.client.rpush(this.queueKey(queue), job);
+                    }
                 }
             }
         }
+        catch {
+            // In case sorted set does not exist yet
+        }
     }
 }
 //# sourceMappingURL=redis-queue-driver.js.map

package/dist/queue/drivers/redis-queue-driver.js.map

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

package/dist/queue/queue-manager.d.ts

@@ -5,10 +5,13 @@
 import type { QueueDriver, PushOptions } from './drivers/queue-driver.js';
 import { QueueWorker, type WorkerOptions } from './worker.js';
 import { Job } from './job.js';
+import { RedisClient } from '../redis/redis-client.js';
 export interface QueueConnectionConfig {
-    driver: 'memory' | 'database' | string;
+    driver: 'memory' | 'database' | 'redis' | string;
     table?: string;
     connection?: string;
+    redis?: RedisClient;
+    redisOptions?: any;
 }
 export interface QueueConfig {
     default?: string;

package/dist/queue/queue-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue-manager.d.ts","sourceRoot":"","sources":["../../src/queue/queue-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACrD;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,iBAAiB,CAAY;IACrC,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,WAAW,CAAkD;gBAEzD,MAAM,GAAE,WAAgB;IAI7B,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAYpC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI;IAKtE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW;IA2BzC;;OAEG;IACU,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAgB1F;;OAEG;IACU,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAIjD;;OAEG;IACI,YAAY,CAAC,OAAO,GAAE,aAAkB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,WAAW;IAY/E,KAAK,IAAI,IAAI;CAKrB;AAED,eAAO,MAAM,KAAK,cAAqB,CAAC"}
+{"version":3,"file":"queue-manager.d.ts","sourceRoot":"","sources":["../../src/queue/queue-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;CACrD;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,iBAAiB,CAAY;IACrC,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,WAAW,CAAkD;gBAEzD,MAAM,GAAE,WAAgB;IAI7B,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAYpC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,IAAI;IAKtE,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW;IAgCzC;;OAEG;IACU,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAgB1F;;OAEG;IACU,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAIjD;;OAEG;IACI,YAAY,CAAC,OAAO,GAAE,aAAkB,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,WAAW;IAY/E,KAAK,IAAI,IAAI;CAKrB;AAED,eAAO,MAAM,KAAK,cAAqB,CAAC"}

package/dist/queue/queue-manager.js

@@ -6,6 +6,8 @@ import { MemoryQueueDriver } from './drivers/memory-queue-driver.js';
 import { DatabaseQueueDriver } from './drivers/database-queue-driver.js';
 import { QueueWorker } from './worker.js';
 import { Job } from './job.js';
+import { RedisQueueDriver } from './drivers/redis-queue-driver.js';
+import { RedisClient } from '../redis/redis-client.js';
 export class QueueManager {
     defaultConnection = 'memory';
     connectionConfigs = new Map();
@@ -34,9 +36,14 @@ export class QueueManager {
         if (this.instantiatedDrivers.has(connName)) {
             return this.instantiatedDrivers.get(connName);
         }
-        const cfg = this.connectionConfigs.get(connName) || { driver: connName === 'database' ? 'database' : 'memory' };
+        const cfg = this.connectionConfigs.get(connName) || { driver: connName === 'database' ? 'database' : (connName === 'redis' ? 'redis' : 'memory') };
         let driverInstance;
         switch (cfg.driver) {
+            case 'redis': {
+                const client = cfg.redis || new RedisClient(cfg.redisOptions);
+                driverInstance = new RedisQueueDriver(client);
+                break;
+            }
             case 'database':
                 driverInstance = new DatabaseQueueDriver({
                     table: cfg.table,

package/dist/queue/queue-manager.js.map

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

package/dist/security/index.d.ts

@@ -3,11 +3,12 @@
  * @description Security modules for Aero Web Framework: JWT, Rate Limiter, Security Headers, and CSRF.
  */
 export { jwt, sign, verify, decode, jwtAuth, parseTimespan, JsonWebTokenError, TokenExpiredError, NotBeforeError, type JwtAlgorithm, type JwtHeader, type JwtPayload, type JwtSignOptions, type JwtVerifyOptions, type JwtAuthOptions, } from './jwt.js';
-export { rateLimit, MemoryRateLimitStore, TooManyRequestsError, type RateLimitOptions, type RateLimitStore, type RateLimitInfo, } from './rate-limiter.js';
+export { rateLimit, MemoryRateLimitStore, RedisRateLimitStore, TooManyRequestsError, type RateLimitOptions, type RateLimitStore, type RateLimitInfo, type RedisRateLimitStoreOptions, } from './rate-limiter.js';
 export { securityHeaders, type SecurityHeadersOptions, type HstsOptions, type ContentSecurityPolicyDirectives, } from './headers.js';
 export { csrf, type CsrfOptions, } from './csrf.js';
 export { Hash, hash, hashVerify, type ScryptOptions, } from './hash.js';
 export { cors, type CorsOptions, } from '../middleware/cors.js';
 export * from './totp.js';
 export * from './vault.js';
+export * from './signed-url.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,GAAG,EACH,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,+BAA+B,GACrC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,IAAI,EACJ,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,IAAI,EACJ,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAE/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,GAAG,EACH,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,0BAA0B,GAChC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,+BAA+B,GACrC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,IAAI,EACJ,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,UAAU,EACV,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,IAAI,EACJ,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAE/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/security/index.js

@@ -3,11 +3,12 @@
  * @description Security modules for Aero Web Framework: JWT, Rate Limiter, Security Headers, and CSRF.
  */
 export { jwt, sign, verify, decode, jwtAuth, parseTimespan, JsonWebTokenError, TokenExpiredError, NotBeforeError, } from './jwt.js';
-export { rateLimit, MemoryRateLimitStore, TooManyRequestsError, } from './rate-limiter.js';
+export { rateLimit, MemoryRateLimitStore, RedisRateLimitStore, TooManyRequestsError, } from './rate-limiter.js';
 export { securityHeaders, } from './headers.js';
 export { csrf, } from './csrf.js';
 export { Hash, hash, hashVerify, } from './hash.js';
 export { cors, } from '../middleware/cors.js';
 export * from './totp.js';
 export * from './vault.js';
+export * from './signed-url.js';
 //# sourceMappingURL=index.js.map

package/dist/security/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,GAAG,EACH,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GAOf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,oBAAoB,GAIrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,eAAe,GAIhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,IAAI,GAEL,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,UAAU,GAEX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,IAAI,GAEL,MAAM,uBAAuB,CAAC;AAE/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,GAAG,EACH,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,GAOf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,SAAS,EACT,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GAKrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,eAAe,GAIhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,IAAI,GAEL,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,UAAU,GAEX,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,IAAI,GAEL,MAAM,uBAAuB,CAAC;AAE/B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/security/rate-limiter.d.ts

@@ -73,6 +73,26 @@ export declare class MemoryRateLimitStore implements RateLimitStore {
     cleanup(): void;
     destroy(): void;
 }
+export interface RedisRateLimitStoreOptions {
+    client: any;
+    prefix?: string;
+    fallbackToMemory?: boolean;
+}
+/**
+ * Distributed, multi-instance Rate Limiter Store backed by Redis.
+ * Uses atomic INCR and TTL expiration to synchronize rate limits across server clusters.
+ */
+export declare class RedisRateLimitStore implements RateLimitStore {
+    private client;
+    private prefix;
+    private fallbackStore?;
+    constructor(options: RedisRateLimitStoreOptions);
+    increment(key: string, windowMs: number): Promise<RateLimitInfo>;
+    decrement(key: string): Promise<void>;
+    resetKey(key: string): Promise<void>;
+    resetAll(): Promise<void>;
+    destroy(): void;
+}
 /**
  * Creates a Rate Limiter middleware for Aero applications.
  */