@shohaghinfo/aerojs 0.1.0

package/dist/pdf/pdf.js

@@ -0,0 +1,237 @@
+/**
+ * @file pdf.ts
+ * @description Zero-Dependency PDF & ESC/POS Thermal Receipt Generator for AeroJS.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Minimal zero-dependency PDF 1.4 document builder.
+ */
+function createMinimalPdf(contentLines, title = 'Document') {
+    const sanitizedLines = contentLines
+        .map((l) => l.replace(/[\r\n]+/g, ' ').replace(/[\\()]/g, '\\$&'))
+        .slice(0, 50);
+    let streamContent = 'BT\n/F1 12 Tf\n50 780 Td\n16 TL\n';
+    for (const line of sanitizedLines) {
+        streamContent += `(${line}) '\n`;
+    }
+    streamContent += 'ET\n';
+    const streamLength = Buffer.byteLength(streamContent, 'utf-8');
+    const objects = [
+        // 1: Catalog
+        '1 0 obj\n<< /Type /Catalog /Pages 2 0 R >>\nendobj\n',
+        // 2: Pages
+        '2 0 obj\n<< /Type /Pages /Kids [3 0 R] /Count 1 >>\nendobj\n',
+        // 3: Page
+        '3 0 obj\n<< /Type /Page /Parent 2 0 R /MediaBox [0 0 595.28 841.89] /Resources << /Font << /F1 4 0 R >> >> /Contents 5 0 R >>\nendobj\n',
+        // 4: Font
+        '4 0 obj\n<< /Type /Font /Subtype /Type1 /BaseFont /Helvetica >>\nendobj\n',
+        // 5: Contents
+        `5 0 obj\n<< /Length ${streamLength} >>\nstream\n${streamContent}endstream\nendobj\n`,
+    ];
+    let body = '%PDF-1.4\n';
+    const offsets = [0];
+    for (const obj of objects) {
+        offsets.push(Buffer.byteLength(body, 'utf-8'));
+        body += obj;
+    }
+    const xrefOffset = Buffer.byteLength(body, 'utf-8');
+    body += `xref\n0 ${objects.length + 1}\n0000000000 65535 f \n`;
+    for (let i = 1; i <= objects.length; i++) {
+        const offsetStr = String(offsets[i]).padStart(10, '0');
+        body += `${offsetStr} 00000 n \n`;
+    }
+    body += `trailer\n<< /Size ${objects.length + 1} /Root 1 0 R >>\nstartxref\n${xrefOffset}\n%%EOF\n`;
+    return Buffer.from(body, 'utf-8');
+}
+export class PDF {
+    /**
+     * Generates a PDF Buffer from HTML or text.
+     */
+    static async fromHtml(html, options = {}) {
+        // Strip simple HTML tags to get readable text lines
+        const text = html
+            .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
+            .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
+            .replace(/<h[1-6][^>]*>(.*?)<\/h[1-6]>/gi, '$1\n')
+            .replace(/<p[^>]*>(.*?)<\/p>/gi, '$1\n')
+            .replace(/<br\s*[\/]?>/gi, '\n')
+            .replace(/<li[^>]*>(.*?)<\/li>/gi, '• $1\n')
+            .replace(/<[^>]+>/g, '')
+            .replace(/&nbsp;/g, ' ')
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>');
+        const lines = text
+            .split('\n')
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0);
+        return createMinimalPdf(lines, options.title);
+    }
+    /**
+     * Generates a PDF by loading an HTML template or interpolating data.
+     */
+    static async generate(options) {
+        let html = options.html || '';
+        if (options.template) {
+            const templatePaths = [
+                path.resolve(process.cwd(), 'views/pdf', `${options.template}.html`),
+                path.resolve(process.cwd(), 'views', `${options.template}.html`),
+                path.resolve(process.cwd(), options.template),
+            ];
+            for (const p of templatePaths) {
+                if (fs.existsSync(p)) {
+                    html = fs.readFileSync(p, 'utf-8');
+                    break;
+                }
+            }
+            if (!html) {
+                html = `<h1>${options.template}</h1>`;
+            }
+        }
+        if (options.data) {
+            for (const [key, val] of Object.entries(options.data)) {
+                const regex = new RegExp(`{{\\s*${key}\\s*}}`, 'g');
+                html = html.replace(regex, String(val ?? ''));
+            }
+        }
+        return this.fromHtml(html, { paper: options.paper });
+    }
+}
+/**
+ * Fluent ESC/POS Thermal Receipt Builder (Standard 80mm / 58mm).
+ */
+export class ThermalReceipt {
+    buffer = [];
+    constructor() {
+        this.init();
+    }
+    static build() {
+        return new ThermalReceipt();
+    }
+    /**
+     * Initialize printer (ESC @)
+     */
+    init() {
+        this.buffer.push(0x1b, 0x40);
+        return this;
+    }
+    /**
+     * Align left (ESC a 0)
+     */
+    left(text) {
+        this.buffer.push(0x1b, 0x61, 0x00);
+        if (text)
+            this.line(text);
+        return this;
+    }
+    /**
+     * Align center (ESC a 1)
+     */
+    center(text) {
+        this.buffer.push(0x1b, 0x61, 0x01);
+        if (text)
+            this.line(text);
+        return this;
+    }
+    /**
+     * Align right (ESC a 2)
+     */
+    right(text) {
+        this.buffer.push(0x1b, 0x61, 0x02);
+        if (text)
+            this.line(text);
+        return this;
+    }
+    /**
+     * Set bold mode on/off (ESC E n)
+     */
+    bold(enable = true) {
+        this.buffer.push(0x1b, 0x45, enable ? 0x01 : 0x00);
+        return this;
+    }
+    /**
+     * Large Header text (Double height & width)
+     */
+    header(text) {
+        this.center();
+        this.buffer.push(0x1d, 0x21, 0x11); // Double size
+        this.bold(true);
+        this.line(text);
+        this.buffer.push(0x1d, 0x21, 0x00); // Normal size
+        this.bold(false);
+        return this;
+    }
+    /**
+     * Append text line with \n
+     */
+    line(text = '') {
+        const bytes = Buffer.from(text + '\n', 'utf-8');
+        for (const b of bytes)
+            this.buffer.push(b);
+        return this;
+    }
+    /**
+     * Print divider rule
+     */
+    divider(char = '-', length = 48) {
+        return this.line(char.repeat(length));
+    }
+    /**
+     * Print 2-column key/value row (e.g. "Total:       $150.00")
+     */
+    row(left, right, width = 48) {
+        const spaces = Math.max(1, width - left.length - right.length);
+        return this.line(left + ' '.repeat(spaces) + right);
+    }
+    /**
+     * Print simple Code 128 / Code 39 Barcode
+     */
+    barcode(data) {
+        this.center();
+        // GS h 80 (Height 80)
+        this.buffer.push(0x1d, 0x68, 80);
+        // GS w 2 (Width)
+        this.buffer.push(0x1d, 0x77, 2);
+        // GS k 4 (Code 39)
+        this.buffer.push(0x1d, 0x6b, 0x04);
+        const bytes = Buffer.from(data + '\0', 'ascii');
+        for (const b of bytes)
+            this.buffer.push(b);
+        return this;
+    }
+    /**
+     * Print QR code
+     */
+    qr(data) {
+        this.center();
+        const len = data.length + 3;
+        const pL = len % 256;
+        const pH = Math.floor(len / 256);
+        // Function 180: Store QR code data in symbol storage area
+        this.buffer.push(0x1d, 0x28, 0x6b, pL, pH, 0x31, 0x50, 0x30);
+        const bytes = Buffer.from(data, 'utf-8');
+        for (const b of bytes)
+            this.buffer.push(b);
+        // Function 181: Print the symbol data
+        this.buffer.push(0x1d, 0x28, 0x6b, 0x03, 0x00, 0x31, 0x51, 0x30);
+        return this;
+    }
+    /**
+     * Paper feed & cut (GS V 66 0)
+     */
+    cut() {
+        // Feed 3 lines
+        this.buffer.push(0x1b, 0x64, 0x03);
+        // Cut command
+        this.buffer.push(0x1d, 0x56, 0x42, 0x00);
+        return this;
+    }
+    /**
+     * Returns Uint8Array of ESC/POS bytes.
+     */
+    toBuffer() {
+        return new Uint8Array(this.buffer);
+    }
+}
+//# sourceMappingURL=pdf.js.map

package/dist/pdf/pdf.js.map

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

package/dist/plugins/plugin.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file plugin.ts
+ * @description Fastify-style plugin system with scope encapsulation, options, and metadata.
+ */
+import type { Aero } from '../core/application.js';
+import type { DefaultState } from '../core/context.js';
+export interface PluginOptions {
+    prefix?: string;
+    [key: string]: unknown;
+}
+export declare const SKIP_OVERRIDE: unique symbol;
+export interface PluginMetadata {
+    name?: string;
+    version?: string;
+    dependencies?: string[];
+    [SKIP_OVERRIDE]?: boolean;
+}
+export type AeroPlugin<Options = Record<string, unknown>, State = DefaultState> = ((app: Aero<State>, options?: Options) => void | Promise<void>) & PluginMetadata;
+/**
+ * Marks a plugin to skip encapsulation so that its decorators, hooks,
+ * and middleware are registered directly onto the root/parent application scope.
+ * (Equivalent to fastify-plugin).
+ */
+export declare function createPlugin<Options = Record<string, unknown>, State = DefaultState>(fn: (app: Aero<State>, options?: Options) => void | Promise<void>, metadata?: PluginMetadata): AeroPlugin<Options, State>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,aAAa,EAAE,OAAO,MAAqC,CAAC;AAEzE,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,UAAU,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAG,YAAY,IAAI,CAAC,CACjF,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAChB,OAAO,CAAC,EAAE,OAAO,KACd,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACxB,cAAc,CAAC;AAEjB;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAG,YAAY,EAClF,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACjE,QAAQ,GAAE,cAAmB,GAC5B,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAK5B"}

package/dist/plugins/plugin.js

@@ -0,0 +1,17 @@
+/**
+ * @file plugin.ts
+ * @description Fastify-style plugin system with scope encapsulation, options, and metadata.
+ */
+export const SKIP_OVERRIDE = Symbol('aero.skip-override');
+/**
+ * Marks a plugin to skip encapsulation so that its decorators, hooks,
+ * and middleware are registered directly onto the root/parent application scope.
+ * (Equivalent to fastify-plugin).
+ */
+export function createPlugin(fn, metadata = {}) {
+    const plugin = fn;
+    Object.assign(plugin, metadata);
+    plugin[SKIP_OVERRIDE] = true;
+    return plugin;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugins/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugins/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,CAAC,MAAM,aAAa,GAAkB,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAezE;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,EAAiE,EACjE,WAA2B,EAAE;IAE7B,MAAM,MAAM,GAAG,EAAgC,CAAC;IAChD,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,MAAM,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC7B,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * @file database-queue-driver.ts
+ * @description Database-backed persistent queue broker for AeroJS.
+ * Persists background tasks to the 'jobs' table with retry attempts, backoff, and reserved tracking.
+ */
+import type { QueueDriver, QueuedJobRecord, PushOptions } from './queue-driver.js';
+export declare class DatabaseQueueDriver implements QueueDriver {
+    private tableName;
+    private connection;
+    constructor(options?: {
+        table?: string;
+        connection?: string;
+    });
+    push(payload: string, options?: PushOptions): Promise<string | number>;
+    pop(queue?: string): Promise<QueuedJobRecord | null>;
+    delete(id: string | number): Promise<boolean>;
+    release(id: string | number, delaySeconds?: number): Promise<boolean>;
+    size(queue?: string): Promise<number>;
+    clear(queue?: string): Promise<void>;
+}
+//# sourceMappingURL=database-queue-driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database-queue-driver.d.ts","sourceRoot":"","sources":["../../../src/queue/drivers/database-queue-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnF,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;IAKpD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAkB1E,GAAG,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAgCvD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO7C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,SAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAWhE,IAAI,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxC,KAAK,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAKrD"}

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

@@ -0,0 +1,84 @@
+/**
+ * @file database-queue-driver.ts
+ * @description Database-backed persistent queue broker for AeroJS.
+ * Persists background tasks to the 'jobs' table with retry attempts, backoff, and reserved tracking.
+ */
+import { Database } from '../../database/connection.js';
+export class DatabaseQueueDriver {
+    tableName;
+    connection;
+    constructor(options = {}) {
+        this.tableName = options.table || 'aero_jobs';
+        this.connection = options.connection || 'default';
+    }
+    async push(payload, options = {}) {
+        const queue = options.queue || 'default';
+        const now = new Date();
+        const delayMs = (options.delay || 0) * 1000;
+        const availableAt = new Date(now.getTime() + delayMs).toISOString();
+        const res = await Database.table(this.tableName, this.connection).insert({
+            queue,
+            payload,
+            attempts: 0,
+            reserved_at: null,
+            available_at: availableAt,
+            created_at: now.toISOString(),
+        });
+        return res.insertId || Date.now();
+    }
+    async pop(queue = 'default') {
+        const now = new Date().toISOString();
+        const row = await Database.table(this.tableName, this.connection)
+            .where('queue', queue)
+            .whereNull('reserved_at')
+            .where('available_at', '<=', now)
+            .orderBy('id', 'ASC')
+            .first();
+        if (!row)
+            return null;
+        // Reserve the job
+        const attempts = Number(row.attempts || 0) + 1;
+        await Database.table(this.tableName, this.connection)
+            .where('id', row.id)
+            .update({
+            reserved_at: now,
+            attempts,
+        });
+        return {
+            id: row.id,
+            queue: row.queue,
+            payload: row.payload,
+            attempts,
+            reservedAt: new Date(now),
+            availableAt: new Date(row.available_at),
+            createdAt: new Date(row.created_at),
+        };
+    }
+    async delete(id) {
+        const deleted = await Database.table(this.tableName, this.connection)
+            .where('id', id)
+            .delete();
+        return deleted > 0;
+    }
+    async release(id, delaySeconds = 0) {
+        const availableAt = new Date(Date.now() + delaySeconds * 1000).toISOString();
+        const updated = await Database.table(this.tableName, this.connection)
+            .where('id', id)
+            .update({
+            reserved_at: null,
+            available_at: availableAt,
+        });
+        return updated > 0;
+    }
+    async size(queue = 'default') {
+        return await Database.table(this.tableName, this.connection)
+            .where('queue', queue)
+            .count();
+    }
+    async clear(queue = 'default') {
+        await Database.table(this.tableName, this.connection)
+            .where('queue', queue)
+            .delete();
+    }
+}
+//# sourceMappingURL=database-queue-driver.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * @file memory-queue-driver.ts
+ * @description In-memory background task queue driver for AeroJS.
+ * Ideal for local development, fast unit tests, and lightweight concurrency.
+ */
+import type { QueueDriver, QueuedJobRecord, PushOptions } from './queue-driver.js';
+export declare class MemoryQueueDriver implements QueueDriver {
+    private jobs;
+    private nextId;
+    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>;
+    size(queue?: string): Promise<number>;
+    clear(queue?: string): Promise<void>;
+}
+//# sourceMappingURL=memory-queue-driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-queue-driver.d.ts","sourceRoot":"","sources":["../../../src/queue/drivers/memory-queue-driver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnF,qBAAa,iBAAkB,YAAW,WAAW;IACnD,OAAO,CAAC,IAAI,CAAwC;IACpD,OAAO,CAAC,MAAM,CAAK;IAEN,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAyB1E,GAAG,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAiBvD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,SAAI,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAYnF,IAAI,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAKxC,KAAK,CAAC,KAAK,SAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAGrD"}

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

@@ -0,0 +1,71 @@
+/**
+ * @file memory-queue-driver.ts
+ * @description In-memory background task queue driver for AeroJS.
+ * Ideal for local development, fast unit tests, and lightweight concurrency.
+ */
+export class MemoryQueueDriver {
+    jobs = new Map();
+    nextId = 1;
+    async push(payload, options = {}) {
+        const queue = options.queue || 'default';
+        const id = this.nextId++;
+        const now = new Date();
+        const delayMs = (options.delay || 0) * 1000;
+        const availableAt = new Date(now.getTime() + delayMs);
+        const record = {
+            id,
+            queue,
+            payload,
+            attempts: 0,
+            reservedAt: null,
+            availableAt,
+            createdAt: now,
+        };
+        if (!this.jobs.has(queue)) {
+            this.jobs.set(queue, []);
+        }
+        this.jobs.get(queue).push(record);
+        return id;
+    }
+    async pop(queue = 'default') {
+        const queueList = this.jobs.get(queue);
+        if (!queueList || queueList.length === 0)
+            return null;
+        const now = new Date();
+        const index = queueList.findIndex((job) => job.reservedAt === null && job.availableAt <= now);
+        if (index === -1)
+            return null;
+        const job = queueList[index];
+        job.reservedAt = now;
+        job.attempts += 1;
+        return { ...job };
+    }
+    async delete(id, queue = 'default') {
+        const queueList = this.jobs.get(queue);
+        if (!queueList)
+            return false;
+        const initialLength = queueList.length;
+        const filtered = queueList.filter((j) => j.id !== id);
+        this.jobs.set(queue, filtered);
+        return filtered.length < initialLength;
+    }
+    async release(id, delaySeconds = 0, queue = 'default') {
+        const queueList = this.jobs.get(queue);
+        if (!queueList)
+            return false;
+        const job = queueList.find((j) => j.id === id);
+        if (!job)
+            return false;
+        job.reservedAt = null;
+        job.availableAt = new Date(Date.now() + delaySeconds * 1000);
+        return true;
+    }
+    async size(queue = 'default') {
+        const queueList = this.jobs.get(queue);
+        return queueList ? queueList.length : 0;
+    }
+    async clear(queue = 'default') {
+        this.jobs.set(queue, []);
+    }
+}
+//# sourceMappingURL=memory-queue-driver.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * @file queue-driver.ts
+ * @description QueueDriver interface for background job broker adapters in AeroJS.
+ */
+export interface QueuedJobRecord {
+    id: string | number;
+    queue: string;
+    payload: string;
+    attempts: number;
+    reservedAt: Date | null;
+    availableAt: Date;
+    createdAt: Date;
+}
+export interface PushOptions {
+    queue?: string;
+    delay?: number;
+}
+export interface QueueDriver {
+    /**
+     * Pushes a job or serialized payload onto the queue.
+     */
+    push(payload: string, options?: PushOptions): Promise<string | number>;
+    /**
+     * Pops the next available job for processing.
+     */
+    pop(queue?: string): Promise<QueuedJobRecord | null>;
+    /**
+     * Acknowledges and deletes a job after successful completion.
+     */
+    delete(id: string | number, queue?: string): Promise<boolean>;
+    /**
+     * Releases a job back to the queue (e.g. after a retryable failure).
+     */
+    release(id: string | number, delaySeconds?: number, queue?: string): Promise<boolean>;
+    /**
+     * Returns the count of pending jobs in a queue.
+     */
+    size(queue?: string): Promise<number>;
+    /**
+     * Clears all jobs in a queue.
+     */
+    clear(queue?: string): Promise<void>;
+}
+//# sourceMappingURL=queue-driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-driver.d.ts","sourceRoot":"","sources":["../../../src/queue/drivers/queue-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAEvE;;OAEG;IACH,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9D;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtF;;OAEG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtC;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC"}

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

@@ -0,0 +1,6 @@
+/**
+ * @file queue-driver.ts
+ * @description QueueDriver interface for background job broker adapters in AeroJS.
+ */
+export {};
+//# sourceMappingURL=queue-driver.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-driver.js","sourceRoot":"","sources":["../../../src/queue/drivers/queue-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,16 @@
+import type { QueueDriver, QueuedJobRecord, PushOptions } from './queue-driver.js';
+import { RedisClient } from '../../redis/redis-client.js';
+export declare class RedisQueueDriver implements QueueDriver {
+    private client;
+    constructor(client: RedisClient);
+    private queueKey;
+    private delayedKey;
+    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>;
+    size(queue?: string): Promise<number>;
+    clear(queue?: string): Promise<void>;
+    private migrateDelayedJobs;
+}
+//# sourceMappingURL=redis-queue-driver.d.ts.map

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

@@ -0,0 +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"}