@gravito/stream 1.0.0-alpha.2

package/dist/core/src/types/events.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Event system type definitions.
+ */
+/**
+ * Listener interface.
+ *
+ * All event listeners must implement this interface.
+ */
+export interface Listener<TEvent extends Event = Event> {
+    /**
+     * Handle an event.
+     * @param event - Event instance
+     */
+    handle(event: TEvent): Promise<void> | void;
+}
+/**
+ * Marker interface for listeners that should be queued.
+ *
+ * Listeners implementing this interface can be dispatched asynchronously via a queue.
+ */
+export interface ShouldQueue {
+    /**
+     * Queue name (optional).
+     */
+    queue?: string;
+    /**
+     * Connection name (optional).
+     */
+    connection?: string;
+    /**
+     * Delay before execution (seconds).
+     */
+    delay?: number;
+}
+/**
+ * Marker interface for events that should be broadcast.
+ *
+ * Events implementing this interface can be automatically broadcast to clients.
+ */
+export interface ShouldBroadcast {
+    /**
+     * Define the broadcast channel.
+     * @returns Channel name or channel object
+     */
+    broadcastOn(): string | Channel;
+    /**
+     * Define broadcast payload (optional).
+     * If omitted, public event properties will be used.
+     * @returns Broadcast payload
+     */
+    broadcastWith?(): Record<string, unknown>;
+    /**
+     * Define the broadcast event name (optional).
+     * If omitted, the event class name will be used.
+     * @returns Event name
+     */
+    broadcastAs?(): string;
+}
+/**
+ * Channel interface.
+ */
+export interface Channel {
+    /**
+     * Channel name.
+     */
+    name: string;
+    /**
+     * Channel type.
+     */
+    type: 'public' | 'private' | 'presence';
+}
+/**
+ * Base event class.
+ *
+ * All events should extend this class.
+ */
+export declare abstract class Event {
+    /**
+     * Whether this event should be broadcast.
+     */
+    shouldBroadcast(): boolean;
+    /**
+     * Get broadcast channel.
+     */
+    getBroadcastChannel(): string | Channel | null;
+    /**
+     * Get broadcast payload.
+     */
+    getBroadcastData(): Record<string, unknown>;
+    /**
+     * Get broadcast event name.
+     */
+    getBroadcastEventName(): string;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/core/src/types/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../../core/src/types/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,WAAW,QAAQ,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK;IACpD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,WAAW,IAAI,MAAM,GAAG,OAAO,CAAA;IAE/B;;;;OAIG;IACH,aAAa,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEzC;;;;OAIG;IACH,WAAW,CAAC,IAAI,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;CACxC;AAED;;;;GAIG;AACH,8BAAsB,KAAK;IACzB;;OAEG;IACH,eAAe,IAAI,OAAO;IAO1B;;OAEG;IACH,mBAAmB,IAAI,MAAM,GAAG,OAAO,GAAG,IAAI;IAO9C;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAkB3C;;OAEG;IACH,qBAAqB,IAAI,MAAM;CAUhC"}

package/dist/drivers/DatabaseDriver.d.ts

@@ -0,0 +1,60 @@
+import type { DBService } from '@gravito/orbit-db';
+import type { SerializedJob } from '../types';
+import type { QueueDriver } from './QueueDriver';
+/**
+ * Database driver configuration.
+ */
+export interface DatabaseDriverConfig {
+    /**
+     * Table name (default: `jobs`).
+     */
+    table?: string;
+    /**
+     * DBService instance (from `orbit-db`).
+     * If not provided, it can be resolved from Context in OrbitQueue.
+     */
+    dbService?: DBService;
+}
+/**
+ * Database Driver
+ *
+ * Uses a database as the queue backend.
+ * Reuses the `orbit-db` connection instead of creating a new connection.
+ *
+ * Requires `@gravito/orbit-db` to be installed and configured.
+ *
+ * @example
+ * ```typescript
+ * // Get DBService from Context
+ * const dbService = c.get('db')
+ * const driver = new DatabaseDriver({ dbService, table: 'jobs' })
+ *
+ * await driver.push('default', serializedJob)
+ * ```
+ */
+export declare class DatabaseDriver implements QueueDriver {
+    private tableName;
+    private dbService;
+    constructor(config: DatabaseDriverConfig);
+    /**
+     * Push a job to a queue.
+     */
+    push(queue: string, job: SerializedJob): Promise<void>;
+    /**
+     * Pop a job from the queue (FIFO, with delay support).
+     */
+    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>;
+}
+//# sourceMappingURL=DatabaseDriver.d.ts.map

package/dist/drivers/DatabaseDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseDriver.d.ts","sourceRoot":"","sources":["../../src/drivers/DatabaseDriver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAW;gBAEhB,MAAM,EAAE,oBAAoB;IAWxC;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5D;;OAEG;IACG,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAyEvD;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAa1C;;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;CAoBpE"}

package/dist/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/drivers/KafkaDriver.d.ts.map

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

package/dist/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/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/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/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/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/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/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/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"}