flashq 0.1.0

package/dist/queue.d.ts

@@ -0,0 +1,104 @@
+import type { Job, ClientOptions } from './types';
+export interface QueueOptions extends ClientOptions {
+    /** Default job options for all jobs in this queue */
+    defaultJobOptions?: JobOptions;
+}
+export interface JobOptions {
+    /** Job priority (higher = first) */
+    priority?: number;
+    /** Delay in ms */
+    delay?: number;
+    /** Number of retry attempts (BullMQ-compatible alias for max_attempts) */
+    attempts?: number;
+    /** Backoff configuration */
+    backoff?: number | {
+        type: 'exponential' | 'fixed';
+        delay: number;
+    };
+    /** Job timeout in ms */
+    timeout?: number;
+    /** Time-to-live in ms */
+    ttl?: number;
+    /** Unique key for deduplication */
+    jobId?: string;
+    /** Remove job on completion */
+    removeOnComplete?: boolean | number;
+    /** Remove job on failure */
+    removeOnFail?: boolean | number;
+}
+/**
+ * BullMQ-compatible Queue class
+ *
+ * @example
+ * ```typescript
+ * import { Queue } from 'flashq';
+ *
+ * const emailQueue = new Queue('emails');
+ *
+ * await emailQueue.add('send', { to: 'user@example.com' }, {
+ *   attempts: 3,
+ *   backoff: { type: 'exponential', delay: 1000 }
+ * });
+ * ```
+ */
+export declare class Queue<T = unknown> {
+    private client;
+    private defaultJobOptions;
+    readonly name: string;
+    constructor(name: string, options?: QueueOptions);
+    /**
+     * Add a job to the queue (BullMQ-compatible)
+     */
+    add(name: string, data: T, options?: JobOptions): Promise<Job<T>>;
+    /**
+     * Add multiple jobs (BullMQ-compatible)
+     */
+    addBulk(jobs: Array<{
+        name: string;
+        data: T;
+        opts?: JobOptions;
+    }>): Promise<Job<T>[]>;
+    /**
+     * Get a job by ID
+     */
+    getJob(jobId: number): Promise<Job<T> | null>;
+    /**
+     * Pause the queue
+     */
+    pause(): Promise<void>;
+    /**
+     * Resume the queue
+     */
+    resume(): Promise<void>;
+    /**
+     * Check if queue is paused
+     */
+    isPaused(): Promise<boolean>;
+    /**
+     * Get job counts by state
+     */
+    getJobCounts(): Promise<{
+        waiting: number;
+        active: number;
+        completed: number;
+        failed: number;
+        delayed: number;
+    }>;
+    /**
+     * Drain the queue (remove all waiting jobs)
+     */
+    drain(): Promise<void>;
+    /**
+     * Obliterate the queue (remove all data)
+     */
+    obliterate(): Promise<void>;
+    /**
+     * Clean jobs by state and age
+     */
+    clean(grace: number, limit: number, type: 'completed' | 'failed' | 'delayed' | 'waiting'): Promise<number[]>;
+    /**
+     * Close the queue connection
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../src/queue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAe,aAAa,EAAE,MAAM,SAAS,CAAC;AAE/D,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,UAAU,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC,4BAA4B;IAC5B,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACjC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,KAAK,CAAC,CAAC,GAAG,OAAO;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAa;IAEtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB;IAMpD;;OAEG;IACG,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAyB3E;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,CAAC,EAAE,UAAU,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAuB3F;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKnD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAIlC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAIF;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKlH;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/queue.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Queue = void 0;
+/**
+ * BullMQ-compatible Queue class
+ */
+const client_1 = require("./client");
+/**
+ * BullMQ-compatible Queue class
+ *
+ * @example
+ * ```typescript
+ * import { Queue } from 'flashq';
+ *
+ * const emailQueue = new Queue('emails');
+ *
+ * await emailQueue.add('send', { to: 'user@example.com' }, {
+ *   attempts: 3,
+ *   backoff: { type: 'exponential', delay: 1000 }
+ * });
+ * ```
+ */
+class Queue {
+    client;
+    defaultJobOptions;
+    name;
+    constructor(name, options = {}) {
+        this.name = name;
+        this.client = new client_1.FlashQ(options);
+        this.defaultJobOptions = options.defaultJobOptions || {};
+    }
+    /**
+     * Add a job to the queue (BullMQ-compatible)
+     */
+    async add(name, data, options = {}) {
+        const opts = { ...this.defaultJobOptions, ...options };
+        // Convert BullMQ options to flashQ options
+        const pushOpts = {
+            priority: opts.priority,
+            delay: opts.delay,
+            max_attempts: opts.attempts,
+            timeout: opts.timeout,
+            ttl: opts.ttl,
+            jobId: opts.jobId,
+        };
+        // Handle backoff (BullMQ uses object, flashQ uses number)
+        if (opts.backoff) {
+            if (typeof opts.backoff === 'number') {
+                pushOpts.backoff = opts.backoff;
+            }
+            else {
+                pushOpts.backoff = opts.backoff.delay;
+            }
+        }
+        return this.client.add(this.name, { name, ...data }, pushOpts);
+    }
+    /**
+     * Add multiple jobs (BullMQ-compatible)
+     */
+    async addBulk(jobs) {
+        const flashqJobs = jobs.map(job => {
+            const opts = { ...this.defaultJobOptions, ...job.opts };
+            return {
+                data: { name: job.name, ...job.data },
+                priority: opts.priority,
+                delay: opts.delay,
+                max_attempts: opts.attempts,
+                timeout: opts.timeout,
+                ttl: opts.ttl,
+                jobId: opts.jobId,
+                backoff: typeof opts.backoff === 'number' ? opts.backoff : opts.backoff?.delay,
+            };
+        });
+        const ids = await this.client.addBulk(this.name, flashqJobs);
+        return ids.map((id, i) => ({
+            id,
+            queue: this.name,
+            data: jobs[i].data,
+        }));
+    }
+    /**
+     * Get a job by ID
+     */
+    async getJob(jobId) {
+        const result = await this.client.getJob(jobId);
+        return result?.job;
+    }
+    /**
+     * Pause the queue
+     */
+    async pause() {
+        await this.client.pause(this.name);
+    }
+    /**
+     * Resume the queue
+     */
+    async resume() {
+        await this.client.resume(this.name);
+    }
+    /**
+     * Check if queue is paused
+     */
+    async isPaused() {
+        return this.client.isPaused(this.name);
+    }
+    /**
+     * Get job counts by state
+     */
+    async getJobCounts() {
+        return this.client.getJobCounts(this.name);
+    }
+    /**
+     * Drain the queue (remove all waiting jobs)
+     */
+    async drain() {
+        await this.client.drain(this.name);
+    }
+    /**
+     * Obliterate the queue (remove all data)
+     */
+    async obliterate() {
+        await this.client.obliterate(this.name);
+    }
+    /**
+     * Clean jobs by state and age
+     */
+    async clean(grace, limit, type) {
+        const count = await this.client.clean(this.name, grace, type, limit);
+        return Array(count).fill(0);
+    }
+    /**
+     * Close the queue connection
+     */
+    async close() {
+        await this.client.close();
+    }
+}
+exports.Queue = Queue;
+//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,185 @@
+/**
+ * flashQ TypeScript SDK Types
+ */
+export interface Job<T = unknown> {
+    id: number;
+    queue: string;
+    data: T;
+    priority: number;
+    attempts: number;
+    created_at: number;
+    run_at: number;
+    started_at: number;
+    max_attempts: number;
+    backoff: number;
+    ttl: number;
+    timeout: number;
+    progress: number;
+    unique_key?: string;
+    custom_id?: string;
+    tags: string[];
+    depends_on: number[];
+    parent_id?: number;
+    children_ids: number[];
+    children_completed: number;
+    lifo: boolean;
+    remove_on_complete: boolean;
+    remove_on_fail: boolean;
+    last_heartbeat: number;
+    stall_timeout: number;
+    stall_count: number;
+    keep_completed_age: number;
+    keep_completed_count: number;
+    completed_at: number;
+}
+export type JobState = 'waiting' | 'delayed' | 'active' | 'completed' | 'failed';
+export interface JobWithState<T = unknown> {
+    job: Job<T>;
+    state: JobState;
+}
+export interface PushOptions {
+    /** Higher = processed first (default: 0) */
+    priority?: number;
+    /** Delay in ms before job is available */
+    delay?: number;
+    /** Max retry attempts (default: 0 = no retry) */
+    max_attempts?: number;
+    /** Backoff base in ms (exponential: backoff * 2^attempt) */
+    backoff?: number;
+    /** Job timeout in ms */
+    timeout?: number;
+    /** Time-to-live in ms (job expires after) */
+    ttl?: number;
+    /** Unique key for deduplication */
+    unique_key?: string;
+    /** Custom ID for lookup */
+    jobId?: string;
+    /** Job IDs that must complete first */
+    depends_on?: number[];
+    /** Tags for filtering */
+    tags?: string[];
+    /** LIFO mode (stack) */
+    lifo?: boolean;
+    /** Remove from completed set immediately */
+    remove_on_complete?: boolean;
+    /** Remove from DLQ immediately */
+    remove_on_fail?: boolean;
+    /** Stall detection timeout in ms */
+    stall_timeout?: number;
+    /** Debounce ID for grouping */
+    debounce_id?: string;
+    /** Debounce window in ms */
+    debounce_ttl?: number;
+    /** Keep completed job result for this duration (ms) */
+    keepCompletedAge?: number;
+    /** Keep completed job in last N completed */
+    keepCompletedCount?: number;
+}
+export interface WorkerOptions {
+    /** Worker ID */
+    id?: string;
+    /** Parallel job processing (default: 10) */
+    concurrency?: number;
+    /** Jobs per batch (default: 100) */
+    batchSize?: number;
+    /** Heartbeat interval in ms (default: 1000) */
+    heartbeatInterval?: number;
+    /** Auto-ack on success (default: true) */
+    autoAck?: boolean;
+}
+export interface ClientOptions {
+    /** Server host (default: localhost) */
+    host?: string;
+    /** TCP port (default: 6789) */
+    port?: number;
+    /** HTTP port (default: 6790) */
+    httpPort?: number;
+    /** Unix socket path (alternative to TCP) */
+    socketPath?: string;
+    /** Auth token */
+    token?: string;
+    /** Connection timeout in ms (default: 5000) */
+    timeout?: number;
+    /** Use HTTP instead of TCP */
+    useHttp?: boolean;
+    /** Use binary (MessagePack) protocol */
+    useBinary?: boolean;
+    /** Enable auto-reconnect on connection loss (default: true) */
+    autoReconnect?: boolean;
+    /** Max reconnect attempts (default: 10, 0 = infinite) */
+    maxReconnectAttempts?: number;
+    /** Initial reconnect delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Max reconnect delay in ms (default: 30000) */
+    maxReconnectDelay?: number;
+}
+export interface QueueInfo {
+    name: string;
+    pending: number;
+    processing: number;
+    dlq: number;
+    paused: boolean;
+}
+export interface QueueStats {
+    queued: number;
+    processing: number;
+    delayed: number;
+    dlq: number;
+}
+export interface CronOptions {
+    queue: string;
+    data: unknown;
+    /** Cron expression: "sec min hour day month weekday" */
+    schedule?: string;
+    /** Or repeat every N ms */
+    repeat_every?: number;
+    priority?: number;
+    limit?: number;
+}
+export interface CronJob {
+    name: string;
+    queue: string;
+    data: unknown;
+    schedule?: string;
+    repeat_every?: number;
+    priority: number;
+    next_run: number;
+    executions: number;
+    limit?: number;
+}
+export interface Metrics {
+    total_pushed: number;
+    total_completed: number;
+    total_failed: number;
+    jobs_per_second: number;
+    avg_latency_ms: number;
+    queues: QueueMetrics[];
+}
+export interface QueueMetrics {
+    name: string;
+    pending: number;
+    processing: number;
+    dlq: number;
+}
+export interface FlowChild {
+    queue: string;
+    data: unknown;
+    priority?: number;
+    delay?: number;
+}
+export interface FlowResult {
+    parent_id: number;
+    children_ids: number[];
+}
+export interface JobLogEntry {
+    timestamp: number;
+    message: string;
+    level: 'info' | 'warn' | 'error';
+}
+export interface ApiResponse<T = unknown> {
+    ok: boolean;
+    data?: T;
+    error?: string;
+}
+export type JobProcessor<T = unknown, R = unknown> = (job: Job<T>) => R | Promise<R>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * flashQ TypeScript SDK Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/worker.d.ts

@@ -0,0 +1,88 @@
+import { EventEmitter } from 'events';
+import type { JobProcessor, WorkerOptions, ClientOptions } from './types';
+export interface BullMQWorkerOptions extends WorkerOptions, ClientOptions {
+    /** Auto-start worker (BullMQ-compatible, default: true) */
+    autorun?: boolean;
+}
+type WorkerState = 'idle' | 'starting' | 'running' | 'stopping' | 'stopped';
+/**
+ * FlashQ Worker (BullMQ-compatible)
+ *
+ * @example
+ * ```typescript
+ * // BullMQ-style: auto-starts by default
+ * const worker = new Worker('emails', async (job) => {
+ *   await sendEmail(job.data.to);
+ *   return { sent: true };
+ * });
+ *
+ * // With options
+ * const worker = new Worker('tasks', processor, {
+ *   concurrency: 10,
+ *   autorun: false,  // disable auto-start
+ * });
+ * await worker.start();
+ *
+ * // Graceful shutdown
+ * process.on('SIGTERM', () => worker.close());
+ * ```
+ */
+export declare class Worker<T = unknown, R = unknown> extends EventEmitter {
+    private clients;
+    private clientOptions;
+    private queues;
+    private processor;
+    private options;
+    private state;
+    private processing;
+    private jobsProcessed;
+    private workers;
+    private heartbeatTimer?;
+    private startPromise;
+    private stopPromise;
+    constructor(queues: string | string[], processor: JobProcessor<T, R>, options?: BullMQWorkerOptions);
+    /**
+     * Start processing jobs
+     */
+    start(): Promise<void>;
+    private doStart;
+    /**
+     * Close the worker (BullMQ-compatible alias for stop)
+     */
+    close(): Promise<void>;
+    /**
+     * Stop processing jobs (graceful shutdown)
+     */
+    stop(): Promise<void>;
+    private doStop;
+    /**
+     * Check if worker is running
+     */
+    isRunning(): boolean;
+    /**
+     * Get current worker state
+     */
+    getState(): WorkerState;
+    /**
+     * Get number of jobs currently being processed
+     */
+    getProcessingCount(): number;
+    /**
+     * Get total number of jobs processed by this worker
+     */
+    getJobsProcessed(): number;
+    /**
+     * Batch worker loop - pulls and processes jobs in batches for maximum throughput
+     */
+    private batchWorkerLoop;
+    private processJob;
+    private startHeartbeat;
+    private sleep;
+    /**
+     * Update progress for the current job
+     * (Use this within your processor function)
+     */
+    updateProgress(jobId: number, progress: number, message?: string): Promise<void>;
+}
+export default Worker;
+//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAEV,YAAY,EACZ,aAAa,EACb,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,mBAAoB,SAAQ,aAAa,EAAE,aAAa;IACvE,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,KAAK,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,CAAE,SAAQ,YAAY;IAChE,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,OAAO,CAAiD;IAChE,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,WAAW,CAA8B;gBAG/C,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,SAAS,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAC7B,OAAO,GAAE,mBAAwB;IA4BnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAyBd,OAAO;IAoBrB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA2Bb,MAAM;IAoBpB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;YACW,eAAe;YAqFf,UAAU;IAIxB,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,KAAK;IAIb;;;OAGG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKvF;AAED,eAAe,MAAM,CAAC"}