flashq 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,184 @@
+/**
+ * flashQ Events - Real-time event subscriptions
+ *
+ * Supports:
+ * - SSE (Server-Sent Events) - Unidirectional, auto-reconnect
+ * - WebSocket - Bidirectional, low latency
+ *
+ * @example
+ * ```typescript
+ * import { EventSubscriber } from 'flashq';
+ *
+ * const events = new EventSubscriber({ host: 'localhost', httpPort: 6790 });
+ *
+ * events.on('completed', (event) => {
+ *   console.log(`Job ${event.jobId} completed`);
+ * });
+ *
+ * events.on('failed', (event) => {
+ *   console.log(`Job ${event.jobId} failed: ${event.error}`);
+ * });
+ *
+ * await events.connect();
+ * ```
+ */
+import { EventEmitter } from 'events';
+export type EventType = 'pushed' | 'completed' | 'failed' | 'progress' | 'timeout';
+export interface JobEvent {
+    /** Event type */
+    eventType: EventType;
+    /** Queue name */
+    queue: string;
+    /** Job ID */
+    jobId: number;
+    /** Event timestamp (ms) */
+    timestamp: number;
+    /** Job data (for pushed events) */
+    data?: unknown;
+    /** Error message (for failed events) */
+    error?: string;
+    /** Progress percentage (for progress events) */
+    progress?: number;
+}
+export interface EventSubscriberOptions {
+    /** Server host (default: localhost) */
+    host?: string;
+    /** HTTP port (default: 6790) */
+    httpPort?: number;
+    /** Authentication token */
+    token?: string;
+    /** Filter to specific queue */
+    queue?: string;
+    /** Connection type: 'sse' or 'websocket' (default: 'sse') */
+    type?: 'sse' | 'websocket';
+    /** Auto-reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Reconnect delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Max reconnect attempts (default: 10, 0 = infinite) */
+    maxReconnectAttempts?: number;
+}
+export interface EventSubscriberEvents {
+    /** Emitted when connected */
+    connected: () => void;
+    /** Emitted when disconnected */
+    disconnected: () => void;
+    /** Emitted on reconnect attempt */
+    reconnecting: (attempt: number) => void;
+    /** Emitted on error */
+    error: (error: Error) => void;
+    /** Emitted for all job events */
+    event: (event: JobEvent) => void;
+    /** Emitted when a job is pushed */
+    pushed: (event: JobEvent) => void;
+    /** Emitted when a job completes */
+    completed: (event: JobEvent) => void;
+    /** Emitted when a job fails */
+    failed: (event: JobEvent) => void;
+    /** Emitted on job progress update */
+    progress: (event: JobEvent) => void;
+    /** Emitted when a job times out */
+    timeout: (event: JobEvent) => void;
+}
+/**
+ * Real-time event subscriber for flashQ
+ *
+ * @example
+ * ```typescript
+ * // SSE (default, auto-reconnect)
+ * const events = new EventSubscriber({
+ *   host: 'localhost',
+ *   httpPort: 6790,
+ *   queue: 'emails', // Optional: filter to one queue
+ * });
+ *
+ * events.on('completed', (e) => console.log(`Job ${e.jobId} done!`));
+ * events.on('failed', (e) => console.log(`Job ${e.jobId} failed: ${e.error}`));
+ *
+ * await events.connect();
+ *
+ * // Later...
+ * events.close();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // WebSocket
+ * const events = new EventSubscriber({
+ *   type: 'websocket',
+ *   token: 'your-auth-token',
+ * });
+ *
+ * await events.connect();
+ * ```
+ */
+export declare class EventSubscriber extends EventEmitter {
+    private options;
+    private eventSource;
+    private websocket;
+    private connected;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private closed;
+    private sseHandlers;
+    private wsMessageHandler;
+    constructor(options?: EventSubscriberOptions);
+    on<K extends keyof EventSubscriberEvents>(event: K, listener: EventSubscriberEvents[K]): this;
+    off<K extends keyof EventSubscriberEvents>(event: K, listener: EventSubscriberEvents[K]): this;
+    emit<K extends keyof EventSubscriberEvents>(event: K, ...args: Parameters<EventSubscriberEvents[K]>): boolean;
+    /**
+     * Connect to the event stream
+     */
+    connect(): Promise<void>;
+    /**
+     * Close the connection
+     */
+    close(): void;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    private connectSSE;
+    private connectWebSocket;
+    private normalizeEvent;
+    private scheduleReconnect;
+}
+/**
+ * Create an SSE event subscriber
+ *
+ * @example
+ * ```typescript
+ * const events = createEventSubscriber({ queue: 'emails' });
+ * events.on('completed', (e) => console.log(e));
+ * await events.connect();
+ * ```
+ */
+export declare function createEventSubscriber(options?: EventSubscriberOptions): EventSubscriber;
+/**
+ * Create a WebSocket event subscriber
+ *
+ * @example
+ * ```typescript
+ * const events = createWebSocketSubscriber({ token: 'xxx' });
+ * events.on('completed', (e) => console.log(e));
+ * await events.connect();
+ * ```
+ */
+export declare function createWebSocketSubscriber(options?: EventSubscriberOptions): EventSubscriber;
+/**
+ * Subscribe to events with a simple callback
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = await subscribeToEvents(
+ *   { queue: 'emails' },
+ *   (event) => console.log(event)
+ * );
+ *
+ * // Later...
+ * unsubscribe();
+ * ```
+ */
+export declare function subscribeToEvents(options: EventSubscriberOptions, callback: (event: JobEvent) => void): Promise<() => void>;
+export default EventSubscriber;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,340 @@
+"use strict";
+/**
+ * flashQ Events - Real-time event subscriptions
+ *
+ * Supports:
+ * - SSE (Server-Sent Events) - Unidirectional, auto-reconnect
+ * - WebSocket - Bidirectional, low latency
+ *
+ * @example
+ * ```typescript
+ * import { EventSubscriber } from 'flashq';
+ *
+ * const events = new EventSubscriber({ host: 'localhost', httpPort: 6790 });
+ *
+ * events.on('completed', (event) => {
+ *   console.log(`Job ${event.jobId} completed`);
+ * });
+ *
+ * events.on('failed', (event) => {
+ *   console.log(`Job ${event.jobId} failed: ${event.error}`);
+ * });
+ *
+ * await events.connect();
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventSubscriber = void 0;
+exports.createEventSubscriber = createEventSubscriber;
+exports.createWebSocketSubscriber = createWebSocketSubscriber;
+exports.subscribeToEvents = subscribeToEvents;
+const events_1 = require("events");
+// ============== EventSubscriber ==============
+/**
+ * Real-time event subscriber for flashQ
+ *
+ * @example
+ * ```typescript
+ * // SSE (default, auto-reconnect)
+ * const events = new EventSubscriber({
+ *   host: 'localhost',
+ *   httpPort: 6790,
+ *   queue: 'emails', // Optional: filter to one queue
+ * });
+ *
+ * events.on('completed', (e) => console.log(`Job ${e.jobId} done!`));
+ * events.on('failed', (e) => console.log(`Job ${e.jobId} failed: ${e.error}`));
+ *
+ * await events.connect();
+ *
+ * // Later...
+ * events.close();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // WebSocket
+ * const events = new EventSubscriber({
+ *   type: 'websocket',
+ *   token: 'your-auth-token',
+ * });
+ *
+ * await events.connect();
+ * ```
+ */
+class EventSubscriber extends events_1.EventEmitter {
+    options;
+    eventSource = null;
+    websocket = null;
+    connected = false;
+    reconnectAttempts = 0;
+    reconnectTimer = null;
+    closed = false;
+    // Store handlers for proper cleanup
+    sseHandlers = new Map();
+    wsMessageHandler = null;
+    constructor(options = {}) {
+        super();
+        this.options = {
+            host: options.host ?? 'localhost',
+            httpPort: options.httpPort ?? 6790,
+            token: options.token ?? '',
+            queue: options.queue ?? '',
+            type: options.type ?? 'sse',
+            autoReconnect: options.autoReconnect ?? true,
+            reconnectDelay: options.reconnectDelay ?? 1000,
+            maxReconnectAttempts: options.maxReconnectAttempts ?? 10,
+        };
+    }
+    // Typed event emitter overrides
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    /**
+     * Connect to the event stream
+     */
+    async connect() {
+        this.closed = false;
+        this.reconnectAttempts = 0;
+        if (this.options.type === 'websocket') {
+            await this.connectWebSocket();
+        }
+        else {
+            await this.connectSSE();
+        }
+    }
+    /**
+     * Close the connection
+     */
+    close() {
+        this.closed = true;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        // Clean up SSE handlers to prevent memory leak
+        if (this.eventSource) {
+            for (const [eventType, handler] of this.sseHandlers) {
+                this.eventSource.removeEventListener(eventType, handler);
+            }
+            this.sseHandlers.clear();
+            this.eventSource.close();
+            this.eventSource = null;
+        }
+        // Clean up WebSocket
+        if (this.websocket) {
+            this.wsMessageHandler = null;
+            this.websocket.close();
+            this.websocket = null;
+        }
+        if (this.connected) {
+            this.connected = false;
+            this.emit('disconnected');
+        }
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return this.connected;
+    }
+    // ============== SSE ==============
+    async connectSSE() {
+        return new Promise((resolve, reject) => {
+            const baseUrl = `http://${this.options.host}:${this.options.httpPort}`;
+            const url = this.options.queue
+                ? `${baseUrl}/queues/${this.options.queue}/events`
+                : `${baseUrl}/events`;
+            try {
+                this.eventSource = new EventSource(url);
+                this.eventSource.onopen = () => {
+                    this.connected = true;
+                    this.reconnectAttempts = 0;
+                    this.emit('connected');
+                    resolve();
+                };
+                this.eventSource.onerror = (error) => {
+                    const wasConnected = this.connected;
+                    this.connected = false;
+                    if (wasConnected) {
+                        this.emit('disconnected');
+                    }
+                    if (!this.closed && this.options.autoReconnect) {
+                        this.scheduleReconnect();
+                    }
+                    else if (!wasConnected) {
+                        reject(new Error('Failed to connect to SSE'));
+                    }
+                };
+                // Clear any existing handlers
+                this.sseHandlers.clear();
+                // Listen for specific event types
+                const eventTypes = ['pushed', 'completed', 'failed', 'progress', 'timeout'];
+                for (const eventType of eventTypes) {
+                    const handler = (e) => {
+                        try {
+                            const messageEvent = e;
+                            const rawEvent = JSON.parse(messageEvent.data);
+                            const event = this.normalizeEvent(rawEvent);
+                            this.emit('event', event);
+                            this.emit(eventType, event);
+                        }
+                        catch {
+                            // Ignore parse errors
+                        }
+                    };
+                    this.sseHandlers.set(eventType, handler);
+                    this.eventSource.addEventListener(eventType, handler);
+                }
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    // ============== WebSocket ==============
+    async connectWebSocket() {
+        return new Promise((resolve, reject) => {
+            const protocol = this.options.host === 'localhost' ? 'ws' : 'wss';
+            let url = `${protocol}://${this.options.host}:${this.options.httpPort}`;
+            if (this.options.queue) {
+                url += `/ws/${this.options.queue}`;
+            }
+            else {
+                url += '/ws';
+            }
+            if (this.options.token) {
+                url += `?token=${encodeURIComponent(this.options.token)}`;
+            }
+            try {
+                this.websocket = new WebSocket(url);
+                this.websocket.onopen = () => {
+                    this.connected = true;
+                    this.reconnectAttempts = 0;
+                    this.emit('connected');
+                    resolve();
+                };
+                this.websocket.onclose = () => {
+                    const wasConnected = this.connected;
+                    this.connected = false;
+                    if (wasConnected) {
+                        this.emit('disconnected');
+                    }
+                    if (!this.closed && this.options.autoReconnect) {
+                        this.scheduleReconnect();
+                    }
+                };
+                this.websocket.onerror = () => {
+                    this.emit('error', new Error('WebSocket error'));
+                    if (!this.connected) {
+                        reject(new Error('Failed to connect to WebSocket'));
+                    }
+                };
+                // Store message handler for cleanup
+                this.wsMessageHandler = (e) => {
+                    try {
+                        const rawEvent = JSON.parse(e.data);
+                        const event = this.normalizeEvent(rawEvent);
+                        this.emit('event', event);
+                        this.emit(event.eventType, event);
+                    }
+                    catch {
+                        // Ignore parse errors
+                    }
+                };
+                this.websocket.onmessage = this.wsMessageHandler;
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    // ============== Helpers ==============
+    normalizeEvent(raw) {
+        return {
+            eventType: (raw.event_type ?? raw.eventType),
+            queue: raw.queue,
+            jobId: (raw.job_id ?? raw.jobId),
+            timestamp: raw.timestamp,
+            data: raw.data,
+            error: raw.error,
+            progress: raw.progress,
+        };
+    }
+    scheduleReconnect() {
+        if (this.closed)
+            return;
+        const maxAttempts = this.options.maxReconnectAttempts;
+        if (maxAttempts > 0 && this.reconnectAttempts >= maxAttempts) {
+            this.emit('error', new Error('Max reconnect attempts reached'));
+            return;
+        }
+        this.reconnectAttempts++;
+        this.emit('reconnecting', this.reconnectAttempts);
+        // Exponential backoff with jitter
+        const delay = Math.min(this.options.reconnectDelay * Math.pow(1.5, this.reconnectAttempts - 1) +
+            Math.random() * 1000, 30000);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect().catch(() => {
+                // Error will trigger another reconnect
+            });
+        }, delay);
+    }
+}
+exports.EventSubscriber = EventSubscriber;
+// ============== Convenience Functions ==============
+/**
+ * Create an SSE event subscriber
+ *
+ * @example
+ * ```typescript
+ * const events = createEventSubscriber({ queue: 'emails' });
+ * events.on('completed', (e) => console.log(e));
+ * await events.connect();
+ * ```
+ */
+function createEventSubscriber(options) {
+    return new EventSubscriber({ ...options, type: 'sse' });
+}
+/**
+ * Create a WebSocket event subscriber
+ *
+ * @example
+ * ```typescript
+ * const events = createWebSocketSubscriber({ token: 'xxx' });
+ * events.on('completed', (e) => console.log(e));
+ * await events.connect();
+ * ```
+ */
+function createWebSocketSubscriber(options) {
+    return new EventSubscriber({ ...options, type: 'websocket' });
+}
+/**
+ * Subscribe to events with a simple callback
+ *
+ * @example
+ * ```typescript
+ * const unsubscribe = await subscribeToEvents(
+ *   { queue: 'emails' },
+ *   (event) => console.log(event)
+ * );
+ *
+ * // Later...
+ * unsubscribe();
+ * ```
+ */
+async function subscribeToEvents(options, callback) {
+    const subscriber = new EventSubscriber(options);
+    subscriber.on('event', callback);
+    await subscriber.connect();
+    return () => subscriber.close();
+}
+exports.default = EventSubscriber;
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * flashQ - High-performance Job Queue (BullMQ-compatible)
+ *
+ * @example
+ * ```typescript
+ * import { Queue, Worker } from 'flashq';
+ *
+ * // Add jobs
+ * const queue = new Queue('emails');
+ * await queue.add('send', { to: 'user@example.com' });
+ *
+ * // Process jobs (auto-starts)
+ * const worker = new Worker('emails', async (job) => {
+ *   await sendEmail(job.data);
+ *   return { sent: true };
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { Queue } from './queue';
+export type { QueueOptions, JobOptions } from './queue';
+export { Worker } from './worker';
+export type { BullMQWorkerOptions } from './worker';
+export { FlashQ, FlashQ as default } from './client';
+export { MAX_BATCH_SIZE, MAX_JOB_DATA_SIZE } from './client/core';
+export { validateQueueName, validateJobDataSize } from './client/connection';
+export { EventSubscriber } from './events';
+export type { Job, JobState, PushOptions, WorkerOptions, ClientOptions, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,YAAY,EACV,GAAG,EACH,QAAQ,EACR,WAAW,EACX,aAAa,EACb,aAAa,GACd,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * flashQ - High-performance Job Queue (BullMQ-compatible)
+ *
+ * @example
+ * ```typescript
+ * import { Queue, Worker } from 'flashq';
+ *
+ * // Add jobs
+ * const queue = new Queue('emails');
+ * await queue.add('send', { to: 'user@example.com' });
+ *
+ * // Process jobs (auto-starts)
+ * const worker = new Worker('emails', async (job) => {
+ *   await sendEmail(job.data);
+ *   return { sent: true };
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventSubscriber = exports.validateJobDataSize = exports.validateQueueName = exports.MAX_JOB_DATA_SIZE = exports.MAX_BATCH_SIZE = exports.default = exports.FlashQ = exports.Worker = exports.Queue = void 0;
+// BullMQ-compatible API
+var queue_1 = require("./queue");
+Object.defineProperty(exports, "Queue", { enumerable: true, get: function () { return queue_1.Queue; } });
+var worker_1 = require("./worker");
+Object.defineProperty(exports, "Worker", { enumerable: true, get: function () { return worker_1.Worker; } });
+// Low-level API
+var client_1 = require("./client");
+Object.defineProperty(exports, "FlashQ", { enumerable: true, get: function () { return client_1.FlashQ; } });
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return client_1.FlashQ; } });
+// Constants and validation utilities
+var core_1 = require("./client/core");
+Object.defineProperty(exports, "MAX_BATCH_SIZE", { enumerable: true, get: function () { return core_1.MAX_BATCH_SIZE; } });
+Object.defineProperty(exports, "MAX_JOB_DATA_SIZE", { enumerable: true, get: function () { return core_1.MAX_JOB_DATA_SIZE; } });
+var connection_1 = require("./client/connection");
+Object.defineProperty(exports, "validateQueueName", { enumerable: true, get: function () { return connection_1.validateQueueName; } });
+Object.defineProperty(exports, "validateJobDataSize", { enumerable: true, get: function () { return connection_1.validateJobDataSize; } });
+// Optional: Real-time events
+var events_1 = require("./events");
+Object.defineProperty(exports, "EventSubscriber", { enumerable: true, get: function () { return events_1.EventSubscriber; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,wBAAwB;AACxB,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AAGd,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AAGf,gBAAgB;AAChB,mCAAqD;AAA5C,gGAAA,MAAM,OAAA;AAAE,iGAAA,MAAM,OAAW;AAElC,qCAAqC;AACrC,sCAAkE;AAAzD,sGAAA,cAAc,OAAA;AAAE,yGAAA,iBAAiB,OAAA;AAC1C,kDAA6E;AAApE,+GAAA,iBAAiB,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAE/C,6BAA6B;AAC7B,mCAA2C;AAAlC,yGAAA,eAAe,OAAA"}