bunqueue 1.0.0

package/dist/shared/lock.js

@@ -0,0 +1,207 @@
+/**
+ * Async Lock implementation
+ * Provides read-write locks with timeout support
+ */
+/** Lock timeout error */
+export class LockTimeoutError extends Error {
+    constructor(message = 'Lock acquisition timed out') {
+        super(message);
+        this.name = 'LockTimeoutError';
+    }
+}
+/**
+ * Simple async mutex lock
+ * FIFO ordering for fairness
+ */
+export class AsyncLock {
+    locked = false;
+    queue = [];
+    /**
+     * Acquire the lock
+     * @param timeoutMs - Maximum time to wait (default: 5000ms)
+     */
+    async acquire(timeoutMs = 5000) {
+        const start = Date.now();
+        while (this.locked) {
+            const remaining = timeoutMs - (Date.now() - start);
+            if (remaining <= 0) {
+                throw new LockTimeoutError();
+            }
+            await new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    const idx = this.queue.indexOf(resolve);
+                    if (idx !== -1)
+                        this.queue.splice(idx, 1);
+                    resolve();
+                }, remaining);
+                this.queue.push(() => {
+                    clearTimeout(timer);
+                    resolve();
+                });
+            });
+        }
+        this.locked = true;
+        return {
+            release: () => {
+                this.locked = false;
+                const next = this.queue.shift();
+                if (next)
+                    next();
+            },
+        };
+    }
+    /** Check if lock is held */
+    isLocked() {
+        return this.locked;
+    }
+    /** Get queue length */
+    getQueueLength() {
+        return this.queue.length;
+    }
+}
+/**
+ * Read-Write Lock
+ * Multiple readers OR single writer
+ * Writers have priority to prevent starvation
+ */
+export class RWLock {
+    readers = 0;
+    writer = false;
+    writerWaiting = 0;
+    readerQueue = [];
+    writerQueue = [];
+    /**
+     * Acquire read lock
+     * Multiple readers can hold simultaneously
+     */
+    async acquireRead(timeoutMs = 5000) {
+        const start = Date.now();
+        // Wait if writer is active or writers are waiting (writer priority)
+        while (this.writer || this.writerWaiting > 0) {
+            const remaining = timeoutMs - (Date.now() - start);
+            if (remaining <= 0) {
+                throw new LockTimeoutError('Read lock acquisition timed out');
+            }
+            await new Promise((resolve) => {
+                const timer = setTimeout(() => {
+                    const idx = this.readerQueue.indexOf(resolve);
+                    if (idx !== -1)
+                        this.readerQueue.splice(idx, 1);
+                    resolve();
+                }, remaining);
+                this.readerQueue.push(() => {
+                    clearTimeout(timer);
+                    resolve();
+                });
+            });
+        }
+        this.readers++;
+        return {
+            release: () => {
+                this.readers--;
+                if (this.readers === 0 && this.writerWaiting > 0) {
+                    const next = this.writerQueue.shift();
+                    if (next)
+                        next();
+                }
+            },
+        };
+    }
+    /**
+     * Acquire write lock
+     * Exclusive access, no readers or other writers
+     */
+    async acquireWrite(timeoutMs = 5000) {
+        const start = Date.now();
+        this.writerWaiting++;
+        try {
+            while (this.writer || this.readers > 0) {
+                const remaining = timeoutMs - (Date.now() - start);
+                if (remaining <= 0) {
+                    throw new LockTimeoutError('Write lock acquisition timed out');
+                }
+                await new Promise((resolve) => {
+                    const timer = setTimeout(() => {
+                        const idx = this.writerQueue.indexOf(resolve);
+                        if (idx !== -1)
+                            this.writerQueue.splice(idx, 1);
+                        resolve();
+                    }, remaining);
+                    this.writerQueue.push(() => {
+                        clearTimeout(timer);
+                        resolve();
+                    });
+                });
+            }
+            this.writerWaiting--;
+            this.writer = true;
+            return {
+                release: () => {
+                    this.writer = false;
+                    // Notify waiting writers first (priority)
+                    if (this.writerWaiting > 0) {
+                        const next = this.writerQueue.shift();
+                        if (next)
+                            next();
+                    }
+                    else {
+                        // Then notify all waiting readers
+                        const readers = this.readerQueue.splice(0);
+                        for (const reader of readers) {
+                            reader();
+                        }
+                    }
+                },
+            };
+        }
+        catch (e) {
+            this.writerWaiting--;
+            throw e;
+        }
+    }
+    /** Get current state */
+    getState() {
+        return {
+            readers: this.readers,
+            writer: this.writer,
+            writerWaiting: this.writerWaiting,
+        };
+    }
+}
+/**
+ * Execute with lock, ensuring release on error
+ */
+export async function withLock(lock, fn, timeoutMs) {
+    const guard = await lock.acquire(timeoutMs);
+    try {
+        return await fn();
+    }
+    finally {
+        guard.release();
+    }
+}
+/**
+ * Execute with read lock
+ */
+export async function withReadLock(lock, fn, timeoutMs) {
+    const guard = await lock.acquireRead(timeoutMs);
+    try {
+        return await fn();
+    }
+    finally {
+        guard.release();
+    }
+}
+/**
+ * Execute with write lock
+ */
+export async function withWriteLock(lock, fn, timeoutMs) {
+    const guard = await lock.acquireWrite(timeoutMs);
+    try {
+        return await fn();
+    }
+    finally {
+        guard.release();
+    }
+}
+//# sourceMappingURL=lock.js.map

package/dist/shared/lock.js.map

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

package/dist/shared/logger.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Structured Logger
+ * JSON-formatted logging for production environments
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    timestamp: string;
+    level: LogLevel;
+    component: string;
+    message: string;
+    reqId?: string;
+    data?: Record<string, unknown>;
+}
+/** Logger class for structured logging */
+export declare class Logger {
+    private readonly component;
+    private static jsonMode;
+    constructor(component: string);
+    /** Enable JSON output mode */
+    static enableJsonMode(): void;
+    /** Disable JSON output mode (use human-readable) */
+    static disableJsonMode(): void;
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    private log;
+}
+/** Create a logger for a component */
+export declare function createLogger(component: string): Logger;
+/** Global loggers */
+export declare const serverLog: Logger;
+export declare const tcpLog: Logger;
+export declare const httpLog: Logger;
+export declare const wsLog: Logger;
+export declare const cronLog: Logger;
+export declare const statsLog: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/shared/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/shared/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,0CAA0C;AAC1C,qBAAa,MAAM;IAGL,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAS;gBAEH,SAAS,EAAE,MAAM;IAE9C,8BAA8B;IAC9B,MAAM,CAAC,cAAc,IAAI,IAAI;IAI7B,oDAAoD;IACpD,MAAM,CAAC,eAAe,IAAI,IAAI;IAI9B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,OAAO,CAAC,GAAG;CA6BZ;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,qBAAqB;AACrB,eAAO,MAAM,SAAS,QAAyB,CAAC;AAChD,eAAO,MAAM,MAAM,QAAsB,CAAC;AAC1C,eAAO,MAAM,OAAO,QAAuB,CAAC;AAC5C,eAAO,MAAM,KAAK,QAAqB,CAAC;AACxC,eAAO,MAAM,OAAO,QAAuB,CAAC;AAC5C,eAAO,MAAM,QAAQ,QAAwB,CAAC"}

package/dist/shared/logger.js

@@ -0,0 +1,74 @@
+/**
+ * Structured Logger
+ * JSON-formatted logging for production environments
+ */
+/** Logger class for structured logging */
+export class Logger {
+    component;
+    static jsonMode = false;
+    constructor(component) {
+        this.component = component;
+    }
+    /** Enable JSON output mode */
+    static enableJsonMode() {
+        Logger.jsonMode = true;
+    }
+    /** Disable JSON output mode (use human-readable) */
+    static disableJsonMode() {
+        Logger.jsonMode = false;
+    }
+    debug(message, data) {
+        this.log('debug', message, data);
+    }
+    info(message, data) {
+        this.log('info', message, data);
+    }
+    warn(message, data) {
+        this.log('warn', message, data);
+    }
+    error(message, data) {
+        this.log('error', message, data);
+    }
+    log(level, message, data) {
+        if (Logger.jsonMode) {
+            const entry = {
+                timestamp: new Date().toISOString(),
+                level,
+                component: this.component,
+                message,
+                ...(data && { data }),
+            };
+            console.log(JSON.stringify(entry));
+        }
+        else {
+            const prefix = `[${this.component}]`;
+            const dataStr = data ? ` ${JSON.stringify(data)}` : '';
+            switch (level) {
+                case 'debug':
+                    console.debug(`${prefix} ${message}${dataStr}`);
+                    break;
+                case 'info':
+                    console.log(`${prefix} ${message}${dataStr}`);
+                    break;
+                case 'warn':
+                    console.warn(`${prefix} ${message}${dataStr}`);
+                    break;
+                case 'error':
+                    console.error(`${prefix} ${message}${dataStr}`);
+                    break;
+            }
+        }
+    }
+}
+/** Create a logger for a component */
+export function createLogger(component) {
+    return new Logger(component);
+}
+/** Global loggers */
+export const serverLog = createLogger('Server');
+export const tcpLog = createLogger('TCP');
+export const httpLog = createLogger('HTTP');
+export const wsLog = createLogger('WS');
+export const cronLog = createLogger('Cron');
+export const statsLog = createLogger('Stats');
+//# sourceMappingURL=logger.js.map

package/dist/shared/logger.js.map

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

package/dist/shared/serialization.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Serialization utilities
+ * Handle BigInt and other special types for JSON serialization
+ */
+import type { Job } from '../domain/types/job';
+/**
+ * Serialize a Job for JSON output
+ * Converts BigInt IDs to strings
+ */
+export declare function serializeJob(job: Job): Record<string, unknown>;
+/**
+ * Serialize multiple jobs
+ */
+export declare function serializeJobs(jobs: Job[]): Record<string, unknown>[];
+/**
+ * Custom JSON replacer for BigInt
+ */
+export declare function bigIntReplacer(_key: string, value: unknown): unknown;
+/**
+ * Stringify with BigInt support
+ */
+export declare function jsonStringify(value: unknown): string;
+//# sourceMappingURL=serialization.d.ts.map

package/dist/shared/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../../src/shared/serialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgC9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAEpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD"}

package/dist/shared/serialization.js

@@ -0,0 +1,63 @@
+/**
+ * Serialization utilities
+ * Handle BigInt and other special types for JSON serialization
+ */
+/**
+ * Serialize a Job for JSON output
+ * Converts BigInt IDs to strings
+ */
+export function serializeJob(job) {
+    return {
+        id: job.id.toString(),
+        queue: job.queue,
+        data: job.data,
+        priority: job.priority,
+        createdAt: job.createdAt,
+        runAt: job.runAt,
+        startedAt: job.startedAt,
+        completedAt: job.completedAt,
+        attempts: job.attempts,
+        maxAttempts: job.maxAttempts,
+        backoff: job.backoff,
+        ttl: job.ttl,
+        timeout: job.timeout,
+        uniqueKey: job.uniqueKey,
+        customId: job.customId,
+        dependsOn: job.dependsOn.map((id) => id.toString()),
+        parentId: job.parentId?.toString() ?? null,
+        childrenIds: job.childrenIds.map((id) => id.toString()),
+        childrenCompleted: job.childrenCompleted,
+        tags: job.tags,
+        groupId: job.groupId,
+        progress: job.progress,
+        progressMessage: job.progressMessage,
+        removeOnComplete: job.removeOnComplete,
+        removeOnFail: job.removeOnFail,
+        lastHeartbeat: job.lastHeartbeat,
+        stallTimeout: job.stallTimeout,
+        stallCount: job.stallCount,
+        lifo: job.lifo,
+    };
+}
+/**
+ * Serialize multiple jobs
+ */
+export function serializeJobs(jobs) {
+    return jobs.map(serializeJob);
+}
+/**
+ * Custom JSON replacer for BigInt
+ */
+export function bigIntReplacer(_key, value) {
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    return value;
+}
+/**
+ * Stringify with BigInt support
+ */
+export function jsonStringify(value) {
+    return JSON.stringify(value, bigIntReplacer);
+}
+//# sourceMappingURL=serialization.js.map

package/dist/shared/serialization.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../src/shared/serialization.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAQ;IACnC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE;QACrB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;QACnD,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,IAAI;QAC1C,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;QACvD,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;QACxC,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,eAAe,EAAE,GAAG,CAAC,eAAe;QACpC,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;QACtC,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAW;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAc;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;AAC/C,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "bunqueue",
+  "version": "1.0.0",
+  "description": "High-performance job queue server for Bun. SQLite persistence, cron jobs, priorities, DLQ. Zero external dependencies.",
+  "type": "module",
+  "main": "dist/main.js",
+  "types": "dist/main.d.ts",
+  "bin": {
+    "bunqueue": "./dist/main.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "import": "./dist/main.js"
+    },
+    "./queue": {
+      "types": "./dist/application/queueManager.d.ts",
+      "import": "./dist/application/queueManager.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prepare": "git config core.hooksPath .husky",
+    "dev": "bun run --watch src/main.ts",
+    "start": "bun run src/main.ts",
+    "build": "bun build --compile --minify src/main.ts --outfile dist/bunqueue",
+    "build:lib": "tsc -p tsconfig.build.json",
+    "test": "bun test",
+    "bench": "bun run benchmarks/index.ts",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "check": "bun run typecheck && bun run lint && bun run format:check",
+    "prepublishOnly": "bun run build:lib"
+  },
+  "dependencies": {
+    "croner": "^9.0.0",
+    "@msgpack/msgpack": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.3",
+    "@eslint/js": "^9.18.0",
+    "typescript-eslint": "^8.21.0",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "prettier": "^3.4.2"
+  },
+  "peerDependencies": {
+    "bun": ">=1.0.0"
+  },
+  "keywords": [
+    "job-queue",
+    "task-queue",
+    "background-jobs",
+    "bun",
+    "sqlite",
+    "cron",
+    "worker",
+    "queue"
+  ],
+  "author": "egeominotti",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/egeominotti/bunQ.git"
+  },
+  "bugs": {
+    "url": "https://github.com/egeominotti/bunQ/issues"
+  },
+  "homepage": "https://github.com/egeominotti/bunQ#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "bun": ">=1.0.0"
+  }
+}