@gravito/stream 1.0.0-alpha.6 → 1.0.0-beta.1

package/dist/drivers/QueueDriver.d.ts

@@ -1,89 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,79 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,100 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}