@gravito/stream 1.0.0-alpha.2

package/dist/orbit-queue/src/drivers/KafkaDriver.d.ts

@@ -0,0 +1,134 @@
+import type { SerializedJob, TopicOptions } from '../types';
+import type { QueueDriver } from './QueueDriver';
+/**
+ * Kafka driver configuration.
+ */
+export interface KafkaDriverConfig {
+    /**
+     * Kafka client instance (kafkajs).
+     */
+    client: {
+        producer: () => {
+            connect: () => Promise<void>;
+            send: (args: {
+                topic: string;
+                messages: Array<{
+                    key?: string;
+                    value: string;
+                }>;
+            }) => Promise<void>;
+            disconnect: () => Promise<void>;
+        };
+        admin: () => {
+            connect: () => Promise<void>;
+            createTopics: (args: {
+                topics: Array<{
+                    topic: string;
+                    numPartitions?: number;
+                    replicationFactor?: number;
+                }>;
+            }) => Promise<void>;
+            deleteTopics: (args: {
+                topics: string[];
+            }) => Promise<void>;
+            disconnect: () => Promise<void>;
+        };
+        consumer: (args: {
+            groupId: string;
+        }) => {
+            connect: () => Promise<void>;
+            subscribe: (args: {
+                topics: string[];
+            }) => Promise<void>;
+            run: (args: {
+                eachMessage: (args: {
+                    topic: string;
+                    partition: number;
+                    message: {
+                        key?: Buffer;
+                        value: Buffer;
+                        offset: string;
+                    };
+                }) => Promise<void>;
+            }) => Promise<void>;
+            disconnect: () => Promise<void>;
+        };
+    };
+    /**
+     * Consumer group ID (for consuming messages).
+     */
+    consumerGroupId?: string;
+}
+/**
+ * Kafka Driver
+ *
+ * Uses Apache Kafka as the queue backend.
+ * Supports topic management, consumer groups, and batch operations.
+ *
+ * Requires `kafkajs`.
+ *
+ * @example
+ * ```typescript
+ * import { Kafka } from 'kafkajs'
+ *
+ * const kafka = new Kafka({
+ *   brokers: ['localhost:9092'],
+ *   clientId: 'gravito-app'
+ * })
+ *
+ * const driver = new KafkaDriver({ client: kafka, consumerGroupId: 'workers' })
+ * await driver.push('default', serializedJob)
+ * ```
+ */
+export declare class KafkaDriver implements QueueDriver {
+    private client;
+    private consumerGroupId;
+    private producer?;
+    private admin?;
+    constructor(config: KafkaDriverConfig);
+    /**
+     * Ensure the producer is connected.
+     */
+    private ensureProducer;
+    /**
+     * Ensure the admin client is connected.
+     */
+    private ensureAdmin;
+    /**
+     * Push a job to a topic.
+     */
+    push(queue: string, job: SerializedJob): Promise<void>;
+    /**
+     * Pop is not supported for Kafka.
+     *
+     * Note: Kafka uses a push-based model, so you should use `subscribe()`.
+     */
+    pop(_queue: string): Promise<SerializedJob | null>;
+    /**
+     * Kafka does not provide a direct queue size.
+     *
+     * Returns 0; use Kafka tooling/metrics for lag/size insights.
+     */
+    size(_queue: string): Promise<number>;
+    /**
+     * Clear a queue by deleting the topic.
+     */
+    clear(queue: string): Promise<void>;
+    /**
+     * Push multiple jobs.
+     */
+    pushMany(queue: string, jobs: SerializedJob[]): Promise<void>;
+    /**
+     * Create a topic.
+     */
+    createTopic(topic: string, options?: TopicOptions): Promise<void>;
+    /**
+     * Delete a topic.
+     */
+    deleteTopic(topic: string): Promise<void>;
+    /**
+     * Subscribe to a topic (push-based model).
+     */
+    subscribe(queue: string, callback: (job: SerializedJob) => Promise<void>): Promise<void>;
+}
+//# sourceMappingURL=KafkaDriver.d.ts.map

package/dist/orbit-queue/src/drivers/KafkaDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KafkaDriver.d.ts","sourceRoot":"","sources":["../../../../src/drivers/KafkaDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM;YACd,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;YAC5B,IAAI,EAAE,CAAC,IAAI,EAAE;gBACX,KAAK,EAAE,MAAM,CAAA;gBACb,QAAQ,EAAE,KAAK,CAAC;oBAAE,GAAG,CAAC,EAAE,MAAM,CAAC;oBAAC,KAAK,EAAE,MAAM,CAAA;iBAAE,CAAC,CAAA;aACjD,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;YACnB,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;SAChC,CAAA;QACD,KAAK,EAAE,MAAM;YACX,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;YAC5B,YAAY,EAAE,CAAC,IAAI,EAAE;gBACnB,MAAM,EAAE,KAAK,CAAC;oBAAE,KAAK,EAAE,MAAM,CAAC;oBAAC,aAAa,CAAC,EAAE,MAAM,CAAC;oBAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAC,CAAA;aACrF,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;YACnB,YAAY,EAAE,CAAC,IAAI,EAAE;gBAAE,MAAM,EAAE,MAAM,EAAE,CAAA;aAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;YAC3D,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;SAChC,CAAA;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,KAAK;YACvC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;YAC5B,SAAS,EAAE,CAAC,IAAI,EAAE;gBAAE,MAAM,EAAE,MAAM,EAAE,CAAA;aAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;YACxD,GAAG,EAAE,CAAC,IAAI,EAAE;gBACV,WAAW,EAAE,CAAC,IAAI,EAAE;oBAClB,KAAK,EAAE,MAAM,CAAA;oBACb,SAAS,EAAE,MAAM,CAAA;oBACjB,OAAO,EAAE;wBAAE,GAAG,CAAC,EAAE,MAAM,CAAC;wBAAC,KAAK,EAAE,MAAM,CAAC;wBAAC,MAAM,EAAE,MAAM,CAAA;qBAAE,CAAA;iBACzD,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;aACpB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;YACnB,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;SAChC,CAAA;KACF,CAAA;IAED;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,WAAY,YAAW,WAAW;IAC7C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAqD;IACtE,OAAO,CAAC,KAAK,CAAC,CAAkD;gBAEpD,MAAM,EAAE,iBAAiB;IASrC;;OAEG;YACW,cAAc;IAQ5B;;OAEG;YACW,WAAW;IAQzB;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5D;;;;OAIG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAKxD;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BnE;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAavE;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAiC/F"}

package/dist/orbit-queue/src/drivers/MemoryDriver.d.ts

@@ -0,0 +1,45 @@
+import type { SerializedJob } from '../types';
+import type { QueueDriver } from './QueueDriver';
+/**
+ * Memory Driver
+ *
+ * In-memory driver for development and testing.
+ * All data is stored in memory and will be lost when the process restarts.
+ *
+ * Zero-config: works out of the box.
+ *
+ * @example
+ * ```typescript
+ * const driver = new MemoryDriver()
+ * await driver.push('default', serializedJob)
+ * const job = await driver.pop('default')
+ * ```
+ */
+export declare class MemoryDriver implements QueueDriver {
+    private queues;
+    /**
+     * Push a job to a queue.
+     */
+    push(queue: string, job: SerializedJob): Promise<void>;
+    /**
+     * Pop a job from a queue (FIFO).
+     */
+    pop(queue: string): Promise<SerializedJob | null>;
+    /**
+     * Get queue size.
+     */
+    size(queue: string): Promise<number>;
+    /**
+     * Clear a queue.
+     */
+    clear(queue: string): Promise<void>;
+    /**
+     * Push multiple jobs.
+     */
+    pushMany(queue: string, jobs: SerializedJob[]): Promise<void>;
+    /**
+     * Pop multiple jobs.
+     */
+    popMany(queue: string, count: number): Promise<SerializedJob[]>;
+}
+//# sourceMappingURL=MemoryDriver.d.ts.map

package/dist/orbit-queue/src/drivers/MemoryDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryDriver.d.ts","sourceRoot":"","sources":["../../../../src/drivers/MemoryDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAa,YAAW,WAAW;IAC9C,OAAO,CAAC,MAAM,CAAqC;IAEnD;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAmBvD;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI1C;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAYtE"}

package/dist/orbit-queue/src/drivers/QueueDriver.d.ts

@@ -0,0 +1,89 @@
+import type { SerializedJob, TopicOptions } from '../types';
+/**
+ * Queue driver interface.
+ *
+ * All queue drivers must implement this interface.
+ * Defines basic queue operations plus optional enterprise-grade capabilities.
+ *
+ * @example
+ * ```typescript
+ * class MyDriver implements QueueDriver {
+ *   async push(queue: string, job: SerializedJob): Promise<void> {
+ *     // push a job
+ *   }
+ *
+ *   async pop(queue: string): Promise<SerializedJob | null> {
+ *     // pop a job
+ *   }
+ *
+ *   async size(queue: string): Promise<number> {
+ *     // queue size
+ *   }
+ *
+ *   async clear(queue: string): Promise<void> {
+ *     // clear queue
+ *   }
+ * }
+ * ```
+ */
+export interface QueueDriver {
+    /**
+     * Push a job to a queue.
+     * @param queue - Queue name
+     * @param job - Serialized job
+     */
+    push(queue: string, job: SerializedJob): Promise<void>;
+    /**
+     * Pop a job from a queue (non-blocking).
+     * @param queue - Queue name
+     * @returns Serialized job, or `null` if the queue is empty
+     */
+    pop(queue: string): Promise<SerializedJob | null>;
+    /**
+     * Get queue size.
+     * @param queue - Queue name
+     * @returns Number of jobs in the queue
+     */
+    size(queue: string): Promise<number>;
+    /**
+     * Clear a queue.
+     * @param queue - Queue name
+     */
+    clear(queue: string): Promise<void>;
+    /**
+     * Push multiple jobs (optional, higher throughput).
+     * @param queue - Queue name
+     * @param jobs - Serialized job array
+     */
+    pushMany?(queue: string, jobs: SerializedJob[]): Promise<void>;
+    /**
+     * Pop multiple jobs (optional, higher throughput).
+     * @param queue - Queue name
+     * @param count - Max number of jobs to pop
+     * @returns Serialized job array
+     */
+    popMany?(queue: string, count: number): Promise<SerializedJob[]>;
+    /**
+     * Acknowledge a message (enterprise capability, e.g. Kafka/SQS).
+     * @param messageId - Message ID
+     */
+    acknowledge?(messageId: string): Promise<void>;
+    /**
+     * Subscribe to a queue (push-based model, e.g. Kafka/SQS).
+     * @param queue - Queue name
+     * @param callback - Callback to process jobs
+     */
+    subscribe?(queue: string, callback: (job: SerializedJob) => Promise<void>): Promise<void>;
+    /**
+     * Create a topic (Kafka, etc.).
+     * @param topic - Topic name
+     * @param options - Topic options
+     */
+    createTopic?(topic: string, options?: TopicOptions): Promise<void>;
+    /**
+     * Delete a topic (Kafka, etc.).
+     * @param topic - Topic name
+     */
+    deleteTopic?(topic: string): Promise<void>;
+}
+//# sourceMappingURL=QueueDriver.d.ts.map

package/dist/orbit-queue/src/drivers/QueueDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueDriver.d.ts","sourceRoot":"","sources":["../../../../src/drivers/QueueDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtD;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;IAEjD;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEpC;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9D;;;;;OAKG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;IAEhE;;;OAGG;IACH,WAAW,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE9C;;;;OAIG;IACH,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzF;;;;OAIG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElE;;;OAGG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3C"}

package/dist/orbit-queue/src/drivers/RedisDriver.d.ts

@@ -0,0 +1,79 @@
+import type { SerializedJob } from '../types';
+import type { QueueDriver } from './QueueDriver';
+/**
+ * Redis driver configuration.
+ */
+export interface RedisDriverConfig {
+    /**
+     * Redis client instance (ioredis or node-redis).
+     */
+    client: {
+        lpush: (key: string, ...values: string[]) => Promise<number>;
+        rpop: (key: string) => Promise<string | null>;
+        llen: (key: string) => Promise<number>;
+        del: (key: string) => Promise<number>;
+        lpushx?: (key: string, ...values: string[]) => Promise<number>;
+        rpoplpush?: (src: string, dst: string) => Promise<string | null>;
+        [key: string]: unknown;
+    };
+    /**
+     * Key prefix (default: `queue:`).
+     */
+    prefix?: string;
+}
+/**
+ * Redis Driver
+ *
+ * Uses Redis as the queue backend.
+ * Implements FIFO via Redis Lists (LPUSH/RPOP).
+ *
+ * Requires `ioredis` or `redis`.
+ *
+ * @example
+ * ```typescript
+ * import Redis from 'ioredis'
+ *
+ * const redis = new Redis('redis://localhost:6379')
+ * const driver = new RedisDriver({ client: redis })
+ *
+ * await driver.push('default', serializedJob)
+ * ```
+ */
+export declare class RedisDriver implements QueueDriver {
+    private prefix;
+    private client;
+    constructor(config: RedisDriverConfig);
+    /**
+     * Get full Redis key for a queue.
+     */
+    private getKey;
+    /**
+     * Push a job (LPUSH).
+     */
+    push(queue: string, job: SerializedJob): Promise<void>;
+    /**
+     * Pop a job (RPOP, FIFO).
+     */
+    pop(queue: string): Promise<SerializedJob | null>;
+    /**
+     * Parse Redis payload.
+     */
+    private parsePayload;
+    /**
+     * Get queue size.
+     */
+    size(queue: string): Promise<number>;
+    /**
+     * Clear a queue.
+     */
+    clear(queue: string): Promise<void>;
+    /**
+     * Push multiple jobs.
+     */
+    pushMany(queue: string, jobs: SerializedJob[]): Promise<void>;
+    /**
+     * Pop multiple jobs.
+     */
+    popMany(queue: string, count: number): Promise<SerializedJob[]>;
+}
+//# sourceMappingURL=RedisDriver.d.ts.map

package/dist/orbit-queue/src/drivers/RedisDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedisDriver.d.ts","sourceRoot":"","sources":["../../../../src/drivers/RedisDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,EAAE;QACN,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QAC5D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;QAC7C,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QACtC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QACrC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QAC9D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;QAChE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,WAAY,YAAW,WAAW;IAC7C,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAA6B;gBAE/B,MAAM,EAAE,iBAAiB;IAWrC;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA6B5D;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA4BvD;;OAEG;IACH,OAAO,CAAC,YAAY;IAcpB;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK1C;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzC;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBnE;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;CAetE"}

package/dist/orbit-queue/src/drivers/SQSDriver.d.ts

@@ -0,0 +1,100 @@
+import type { SerializedJob } from '../types';
+import type { QueueDriver } from './QueueDriver';
+/**
+ * SQS driver configuration.
+ */
+export interface SQSDriverConfig {
+    /**
+     * SQS client instance (`@aws-sdk/client-sqs`).
+     */
+    client: {
+        send: (command: unknown) => Promise<{
+            MessageId?: string;
+            Messages?: Array<{
+                MessageId?: string;
+                ReceiptHandle?: string;
+                Body?: string;
+            }>;
+        }>;
+    };
+    /**
+     * Queue URL prefix (used to build full queue URLs).
+     */
+    queueUrlPrefix?: string;
+    /**
+     * Visibility timeout (seconds, default: 30).
+     */
+    visibilityTimeout?: number;
+    /**
+     * Long-polling duration (seconds, default: 20).
+     */
+    waitTimeSeconds?: number;
+}
+/**
+ * SQS Driver
+ *
+ * Uses AWS SQS as the queue backend.
+ * Supports standard/FIFO queues, long polling, DLQ setups, etc.
+ *
+ * Requires `@aws-sdk/client-sqs`.
+ *
+ * @example
+ * ```typescript
+ * import { SQSClient } from '@aws-sdk/client-sqs'
+ *
+ * const sqs = new SQSClient({
+ *   region: 'us-east-1',
+ *   credentials: {
+ *     accessKeyId: process.env.AWS_ACCESS_KEY_ID!,
+ *     secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY!,
+ *   }
+ * })
+ *
+ * const driver = new SQSDriver({ client: sqs })
+ * await driver.push('default', serializedJob)
+ * ```
+ */
+export declare class SQSDriver implements QueueDriver {
+    private client;
+    private queueUrlPrefix;
+    private visibilityTimeout;
+    private waitTimeSeconds;
+    private queueUrls;
+    constructor(config: SQSDriverConfig);
+    /**
+     * Resolve the full queue URL.
+     */
+    private getQueueUrl;
+    /**
+     * Push a job to SQS.
+     */
+    push(queue: string, job: SerializedJob): Promise<void>;
+    /**
+     * Pop a job (long polling).
+     */
+    pop(queue: string): Promise<SerializedJob | null>;
+    /**
+     * Get queue size (approximate).
+     */
+    size(queue: string): Promise<number>;
+    /**
+     * Clear a queue by receiving and deleting messages.
+     *
+     * Note: SQS does not provide a direct "purge" API via this wrapper. This method will
+     * keep receiving and deleting messages until the queue is empty.
+     */
+    clear(queue: string): Promise<void>;
+    /**
+     * Push multiple jobs.
+     */
+    pushMany(queue: string, jobs: SerializedJob[]): Promise<void>;
+    /**
+     * Acknowledge is not supported via messageId.
+     */
+    acknowledge(_messageId: string): Promise<void>;
+    /**
+     * Delete a message (acknowledge processing completion).
+     */
+    deleteMessage(queue: string, receiptHandle: string): Promise<void>;
+}
+//# sourceMappingURL=SQSDriver.d.ts.map

package/dist/orbit-queue/src/drivers/SQSDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SQSDriver.d.ts","sourceRoot":"","sources":["../../../../src/drivers/SQSDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;YAClC,SAAS,CAAC,EAAE,MAAM,CAAA;YAClB,QAAQ,CAAC,EAAE,KAAK,CAAC;gBACf,SAAS,CAAC,EAAE,MAAM,CAAA;gBAClB,aAAa,CAAC,EAAE,MAAM,CAAA;gBACtB,IAAI,CAAC,EAAE,MAAM,CAAA;aACd,CAAC,CAAA;SACH,CAAC,CAAA;KACH,CAAA;IAED;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,SAAU,YAAW,WAAW;IAC3C,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,SAAS,CAA4B;gBAEjC,MAAM,EAAE,eAAe;IAanC;;OAEG;YACW,WAAW;IAiBzB;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B5D;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkCvD;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAmB1C;;;;;OAKG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBzC;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCnE;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAWzE"}

package/dist/orbit-queue/src/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @gravito/orbit-queue
+ *
+ * Lightweight, high-performance queue system inspired by Laravel while keeping Gravito's core values.
+ * Supports multiple storage drivers, embedded/standalone consumer modes, and multiple job serialization strategies.
+ *
+ * @example
+ * ```typescript
+ * import { OrbitQueue, Job } from '@gravito/orbit-queue'
+ *
+ * // Create a Job
+ * class SendEmail extends Job {
+ *   async handle() {
+ *     // handle logic
+ *   }
+ * }
+ *
+ * // Push a Job
+ * await queue.push(new SendEmail())
+ * ```
+ */
+export type { ConsumerOptions } from './Consumer';
+export { Consumer } from './Consumer';
+export type { DatabaseDriverConfig } from './drivers/DatabaseDriver';
+export { DatabaseDriver } from './drivers/DatabaseDriver';
+export type { KafkaDriverConfig } from './drivers/KafkaDriver';
+export { KafkaDriver } from './drivers/KafkaDriver';
+export { MemoryDriver } from './drivers/MemoryDriver';
+export type { QueueDriver } from './drivers/QueueDriver';
+export type { RedisDriverConfig } from './drivers/RedisDriver';
+export { RedisDriver } from './drivers/RedisDriver';
+export type { SQSDriverConfig } from './drivers/SQSDriver';
+export { SQSDriver } from './drivers/SQSDriver';
+export { Job } from './Job';
+export type { OrbitQueueOptions } from './OrbitQueue';
+export { OrbitQueue } from './OrbitQueue';
+export type { Queueable } from './Queueable';
+export { QueueManager } from './QueueManager';
+export { ClassNameSerializer } from './serializers/ClassNameSerializer';
+export type { JobSerializer } from './serializers/JobSerializer';
+export { JsonSerializer } from './serializers/JsonSerializer';
+export type { QueueConfig, QueueConnectionConfig, SerializedJob, TopicOptions, } from './types';
+export type { WorkerOptions } from './Worker';
+export { Worker } from './Worker';
+//# sourceMappingURL=index.d.ts.map

package/dist/orbit-queue/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAErD,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAG/C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAA;AAEvE,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,YAAY,EACV,WAAW,EACX,qBAAqB,EACrB,aAAa,EACb,YAAY,GACb,MAAM,SAAS,CAAA;AAEhB,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA"}

package/dist/orbit-queue/src/serializers/ClassNameSerializer.d.ts

@@ -0,0 +1,46 @@
+import type { Job } from '../Job';
+import type { SerializedJob } from '../types';
+import type { JobSerializer } from './JobSerializer';
+/**
+ * Class name serializer (Laravel-style).
+ *
+ * Stores the class name and properties, then recreates an instance at runtime.
+ * This is the recommended serializer because it can restore class instances correctly.
+ *
+ * Requirement: Job classes must be dynamically loadable (by class name).
+ *
+ * @example
+ * ```typescript
+ * const serializer = new ClassNameSerializer()
+ * const serialized = serializer.serialize(new SendEmail('user@example.com'))
+ * // serialized.data contains class name and properties
+ *
+ * const job = serializer.deserialize(serialized)
+ * // job is an instance of SendEmail
+ * ```
+ */
+export declare class ClassNameSerializer implements JobSerializer {
+    /**
+     * Job class registry (for resolving classes by name).
+     */
+    private jobClasses;
+    /**
+     * Register a Job class.
+     * @param jobClass - Job class
+     */
+    register(jobClass: new (...args: unknown[]) => Job): void;
+    /**
+     * Register multiple Job classes.
+     * @param jobClasses - Job class array
+     */
+    registerMany(jobClasses: Array<new (...args: unknown[]) => Job>): void;
+    /**
+     * Serialize a Job.
+     */
+    serialize(job: Job): SerializedJob;
+    /**
+     * Deserialize a Job.
+     */
+    deserialize(serialized: SerializedJob): Job;
+}
+//# sourceMappingURL=ClassNameSerializer.d.ts.map

package/dist/orbit-queue/src/serializers/ClassNameSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClassNameSerializer.d.ts","sourceRoot":"","sources":["../../../../src/serializers/ClassNameSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD;;OAEG;IACH,OAAO,CAAC,UAAU,CAAqD;IAEvE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,GAAG,GAAG,IAAI;IAIzD;;;OAGG;IACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,GAAG,IAAI;IAMtE;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa;IA8BlC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,GAAG,GAAG;CAqC5C"}

package/dist/orbit-queue/src/serializers/JobSerializer.d.ts

@@ -0,0 +1,36 @@
+import type { Job } from '../Job';
+import type { SerializedJob } from '../types';
+/**
+ * Job serializer interface.
+ *
+ * Responsible for serializing and deserializing jobs.
+ * Supports multiple strategies (JSON, class-name, etc.).
+ *
+ * @example
+ * ```typescript
+ * class MySerializer implements JobSerializer {
+ *   serialize(job: Job): SerializedJob {
+ *     // serialization logic
+ *   }
+ *
+ *   deserialize(serialized: SerializedJob): Job {
+ *     // deserialization logic
+ *   }
+ * }
+ * ```
+ */
+export interface JobSerializer {
+    /**
+     * Serialize a job.
+     * @param job - Job instance
+     * @returns Serialized job payload
+     */
+    serialize(job: Job): SerializedJob;
+    /**
+     * Deserialize a job.
+     * @param serialized - Serialized job payload
+     * @returns Job instance
+     */
+    deserialize(serialized: SerializedJob): Job;
+}
+//# sourceMappingURL=JobSerializer.d.ts.map

package/dist/orbit-queue/src/serializers/JobSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JobSerializer.d.ts","sourceRoot":"","sources":["../../../../src/serializers/JobSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAAA;IAElC;;;;OAIG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,GAAG,GAAG,CAAA;CAC5C"}

package/dist/orbit-queue/src/serializers/JsonSerializer.d.ts

@@ -0,0 +1,32 @@
+import type { Job } from '../Job';
+import type { SerializedJob } from '../types';
+import type { JobSerializer } from './JobSerializer';
+/**
+ * JSON Serializer
+ *
+ * Serializes jobs using JSON.
+ * Suitable for simple scenarios where you only need to persist plain properties.
+ *
+ * Limitation: cannot restore class instances, functions, or complex objects.
+ *
+ * @example
+ * ```typescript
+ * const serializer = new JsonSerializer()
+ * const serialized = serializer.serialize(job)
+ * const job = serializer.deserialize(serialized)
+ * ```
+ */
+export declare class JsonSerializer implements JobSerializer {
+    /**
+     * Serialize a job.
+     */
+    serialize(job: Job): SerializedJob;
+    /**
+     * Deserialize a job.
+     *
+     * Note: this implementation only restores properties and does not recreate class instances.
+     * For class instances, use `ClassNameSerializer`.
+     */
+    deserialize(serialized: SerializedJob): Job;
+}
+//# sourceMappingURL=JsonSerializer.d.ts.map

package/dist/orbit-queue/src/serializers/JsonSerializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonSerializer.d.ts","sourceRoot":"","sources":["../../../../src/serializers/JsonSerializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa;IAiBlC;;;;;OAKG;IACH,WAAW,CAAC,UAAU,EAAE,aAAa,GAAG,GAAG;CAW5C"}