@gravito/stream 1.0.0-alpha.2

package/README.md

@@ -0,0 +1,319 @@
+# @gravito/stream
+
+輕量、高效的隊列系統，借鑑 Laravel 架構但保持 Gravito 的核心價值（高效能、低耗、輕量、AI 友善）。支援多種儲存驅動、內嵌與獨立 Consumer 模式，以及多種 Job 序列化方式。
+
+> **狀態**：v0.1.0 - 核心功能已完成，支援 Memory、Database、Redis、Kafka、SQS 驅動
+
+## 特性
+
+- **零運行時開銷**：純型別包裝，直接委派給驅動
+- **多驅動支援**：Memory、Database、Redis、Kafka、SQS 等
+- **完全模組化**：按需安裝驅動，核心包極小（< 50KB）
+- **內嵌與獨立模式**：開發時內嵌運行，生產環境可獨立部署
+- **AI 友善**：完整的型別推導、清晰的 JSDoc、直觀的 API
+
+## 安裝
+
+```bash
+bun add @gravito/stream
+```
+
+## 快速開始
+
+### 1. 建立 Job
+
+```typescript
+import { Job } from '@gravito/stream'
+
+export class SendWelcomeEmail extends Job {
+  constructor(private userId: string) {
+    super()
+  }
+
+  async handle(): Promise<void> {
+    // 處理邏輯
+    const user = await User.find(this.userId)
+    await mail.send(new WelcomeEmail(user))
+  }
+}
+```
+
+### 2. 推送 Job
+
+```typescript
+// 在 Controller 中
+const queue = c.get('queue')
+
+await queue.push(new SendWelcomeEmail(user.id))
+  .onQueue('emails')
+  .delay(60) // 延遲 60 秒
+```
+
+### 3. 配置 OrbitStream
+
+#### 使用 Memory Driver（開發用）
+
+```typescript
+import { OrbitStream } from '@gravito/stream'
+
+const core = await PlanetCore.boot({
+  orbits: [
+    OrbitStream.configure({
+      default: 'memory',
+      connections: {
+        memory: { driver: 'memory' }
+      },
+      autoStartWorker: true,
+      workerOptions: {
+        queues: ['default', 'emails']
+      }
+    })
+  ]
+})
+```
+
+#### 使用 Database Driver
+
+```typescript
+import { OrbitStream } from '@gravito/stream'
+import { OrbitDB } from '@gravito/db'
+
+const core = await PlanetCore.boot({
+  orbits: [
+    OrbitDB.configure({ db: drizzleClient }),
+    OrbitStream.configure({
+      default: 'database',
+      connections: {
+        database: { 
+          driver: 'database',
+          table: 'jobs' // 可選，預設為 'jobs'
+          // dbService 會自動從 Context 取得（如果 OrbitDB 已安裝）
+        }
+      }
+    })
+  ]
+})
+```
+
+#### 使用 Redis Driver
+
+```typescript
+import { OrbitStream } from '@gravito/stream'
+import Redis from 'ioredis'
+
+const redis = new Redis('redis://localhost:6379')
+
+const core = await PlanetCore.boot({
+  orbits: [
+    OrbitStream.configure({
+      default: 'redis',
+      connections: {
+        redis: { 
+          driver: 'redis',
+          client: redis,
+          prefix: 'queue:' // 可選
+        }
+      }
+    })
+  ]
+})
+```
+
+#### 使用 Kafka Driver
+
+```typescript
+import { OrbitStream } from '@gravito/stream'
+import { Kafka } from 'kafkajs'
+
+const kafka = new Kafka({
+  brokers: ['localhost:9092'],
+  clientId: 'gravito-app'
+})
+
+const core = await PlanetCore.boot({
+  orbits: [
+    OrbitStream.configure({
+      default: 'kafka',
+      connections: {
+        kafka: { 
+          driver: 'kafka',
+          client: kafka,
+          consumerGroupId: 'gravito-workers'
+        }
+      }
+    })
+  ]
+})
+```
+
+#### 使用 SQS Driver
+
+```typescript
+import { OrbitStream } from '@gravito/stream'
+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 core = await PlanetCore.boot({
+  orbits: [
+    OrbitStream.configure({
+      default: 'sqs',
+      connections: {
+        sqs: { 
+          driver: 'sqs',
+          client: sqs,
+          queueUrlPrefix: 'https://sqs.us-east-1.amazonaws.com/123456789012', // 可選
+          visibilityTimeout: 30, // 可選
+          waitTimeSeconds: 20 // 可選，長輪詢
+        }
+      }
+    })
+  ]
+})
+```
+
+## 資料庫 Schema
+
+如果使用 Database Driver，需要建立以下資料表：
+
+```sql
+CREATE TABLE jobs (
+  id BIGSERIAL PRIMARY KEY,
+  queue VARCHAR(255) NOT NULL,
+  payload TEXT NOT NULL,
+  attempts INT DEFAULT 0,
+  reserved_at TIMESTAMP,
+  available_at TIMESTAMP NOT NULL,
+  created_at TIMESTAMP NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX idx_jobs_queue_available ON jobs(queue, available_at);
+CREATE INDEX idx_jobs_reserved ON jobs(reserved_at);
+```
+
+## 獨立 Consumer（微服務模式）
+
+```bash
+# 使用 Database
+bun run packages/orbit-queue/cli/queue-worker.ts \
+  --connection=database \
+  --queues=default,emails \
+  --workers=4
+
+# 使用 Kafka
+bun run packages/orbit-queue/cli/queue-worker.ts \
+  --connection=kafka \
+  --queues=default,emails \
+  --consumer-group=gravito-workers
+
+# 使用 SQS
+bun run packages/orbit-queue/cli/queue-worker.ts \
+  --connection=sqs \
+  --queues=default,emails \
+  --region=us-east-1
+```
+
+## API 參考
+
+### Job
+
+```typescript
+abstract class Job implements Queueable {
+  abstract handle(): Promise<void>
+  async failed(error: Error): Promise<void>
+  
+  onQueue(queue: string): this
+  onConnection(connection: string): this
+  delay(seconds: number): this
+}
+```
+
+### QueueManager
+
+```typescript
+class QueueManager {
+  async push<T extends Job>(job: T): Promise<T>
+  async pushMany<T extends Job>(jobs: T[]): Promise<void>
+  async pop(queue?: string, connection?: string): Promise<Job | null>
+  async size(queue?: string, connection?: string): Promise<number>
+  async clear(queue?: string, connection?: string): Promise<void>
+  registerJobClasses(jobClasses: Array<new (...args: unknown[]) => Job>): void
+}
+```
+
+## 設計原則
+
+- **高效能**：零運行時開銷，直接委派給驅動，支援批量操作
+- **低耗**：最小化依賴，重用現有連接（DatabaseDriver 重用 orbit-db）
+- **輕量**：核心包極小（< 50KB），驅動完全模組化，按需載入
+- **AI 友善**：完整的型別推導，清晰的 JSDoc，直觀的 API
+
+## 已實作的驅動
+
+### 基礎驅動
+
+- ✅ **MemoryDriver** - 記憶體驅動（開發用，零配置）
+- ✅ **DatabaseDriver** - 資料庫驅動（PostgreSQL、MySQL、SQLite）
+- ✅ **RedisDriver** - Redis 驅動（支援延遲執行）
+
+### 企業級 Broker 驅動
+
+- ✅ **KafkaDriver** - Apache Kafka 驅動（支援 Topic、Consumer Groups）
+- ✅ **SQSDriver** - AWS SQS 驅動（支援標準/FIFO 隊列、長輪詢）
+
+## 未來規劃
+
+以下 broker 驅動計劃在後續版本中實作：
+
+### 計劃中的驅動
+
+- 🔜 **RabbitMQDriver** - RabbitMQ 驅動
+  - 支援 Exchange 和 Queue 管理
+  - 支援多種 Exchange 類型（direct、topic、fanout、headers）
+  - 支援持久化隊列
+  - 支援確認機制
+
+- 🔜 **NATSDriver** - NATS 驅動
+  - 支援 JetStream（持久化消息）
+  - 支援訂閱模式
+  - 支援請求/回應模式
+
+- 🔜 **GooglePubSubDriver** - Google Cloud Pub/Sub 驅動
+  - 支援 Topic 和 Subscription 管理
+  - 支援批量操作
+  - 支援死信主題（Dead Letter Topic）
+
+- 🔜 **AzureServiceBusDriver** - Azure Service Bus 驅動
+  - 支援 Queue 和 Topic 管理
+  - 支援會話（Sessions）
+  - 支援死信隊列
+
+- 🔜 **BeanstalkdDriver** - Beanstalkd 驅動
+  - 輕量級消息隊列
+  - 支援優先級和延遲
+  - 支援 TTR（Time To Run）
+
+### 貢獻指南
+
+如果您想為 Gravito Queue 添加新的 broker 驅動，請：
+
+1. 實作 `QueueDriver` 介面
+2. 確保符合核心原則（高效能、低耗、輕量、AI 友善）
+3. 添加完整的 JSDoc 註解
+4. 添加單元測試
+5. 更新 README 文件
+
+## 相關文件
+
+- [ROADMAP.md](./ROADMAP.md) - 詳細的路線圖和計劃
+- [MIGRATION.md](./MIGRATION.md) - 資料庫遷移腳本
+
+## 授權
+
+MIT

package/dist/Consumer.d.ts

@@ -0,0 +1,67 @@
+import type { QueueManager } from './QueueManager';
+import type { WorkerOptions } from './Worker';
+/**
+ * Consumer options.
+ */
+export interface ConsumerOptions {
+    /**
+     * Queues to listen on.
+     */
+    queues: string[];
+    /**
+     * Connection name.
+     */
+    connection?: string;
+    /**
+     * Worker options.
+     */
+    workerOptions?: WorkerOptions;
+    /**
+     * Polling interval (milliseconds).
+     */
+    pollInterval?: number;
+    /**
+     * Whether to keep polling when queues are empty.
+     */
+    keepAlive?: boolean;
+}
+/**
+ * Consumer
+ *
+ * Consumes and executes jobs from queues.
+ * Supports embedded mode (inside the main app) and standalone mode (as a worker service).
+ *
+ * @example
+ * ```typescript
+ * // Embedded mode
+ * const consumer = new Consumer(queueManager, {
+ *   queues: ['default', 'emails'],
+ *   pollInterval: 1000
+ * })
+ *
+ * consumer.start()
+ *
+ * // Standalone mode (CLI)
+ * // Start via CLI tooling with graceful shutdown
+ * ```
+ */
+export declare class Consumer {
+    private queueManager;
+    private options;
+    private running;
+    private stopRequested;
+    constructor(queueManager: QueueManager, options: ConsumerOptions);
+    /**
+     * Start the consumer loop.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the consumer loop (graceful shutdown).
+     */
+    stop(): Promise<void>;
+    /**
+     * Check whether the consumer is running.
+     */
+    isRunning(): boolean;
+}
+//# sourceMappingURL=Consumer.d.ts.map

package/dist/Consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Consumer.d.ts","sourceRoot":"","sources":["../src/Consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAG7C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAA;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAQ;IAKjB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IALjB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,aAAa,CAAQ;gBAGnB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,eAAe;IAGlC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmD5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAU3B;;OAEG;IACH,SAAS,IAAI,OAAO;CAGrB"}

package/dist/Job.d.ts

@@ -0,0 +1,76 @@
+import type { Queueable } from './Queueable';
+/**
+ * Base Job.
+ *
+ * All tasks that should be pushed to a queue should extend this class.
+ * Implements the `Queueable` interface, providing a fluent API for queue/connection/delay.
+ *
+ * @example
+ * ```typescript
+ * class SendWelcomeEmail extends Job {
+ *   constructor(private userId: string) {
+ *     super()
+ *   }
+ *
+ *   async handle(): Promise<void> {
+ *     const user = await User.find(this.userId)
+ *     await mail.send(new WelcomeEmail(user))
+ *   }
+ * }
+ *
+ * // Usage
+ * await queue.push(new SendWelcomeEmail('123'))
+ *   .onQueue('emails')
+ *   .delay(60)
+ * ```
+ */
+export declare abstract class Job implements Queueable {
+    /**
+     * Queue name.
+     */
+    queueName?: string;
+    /**
+     * Connection name.
+     */
+    connectionName?: string;
+    /**
+     * Delay before execution (seconds).
+     */
+    delaySeconds?: number;
+    /**
+     * Current attempt number.
+     */
+    attempts?: number;
+    /**
+     * Maximum attempts.
+     */
+    maxAttempts?: number;
+    /**
+     * Set target queue.
+     */
+    onQueue(queue: string): this;
+    /**
+     * Set target connection.
+     */
+    onConnection(connection: string): this;
+    /**
+     * Set delay (seconds).
+     */
+    delay(delay: number): this;
+    /**
+     * Job handler logic.
+     *
+     * Subclasses must implement this method.
+     */
+    abstract handle(): Promise<void>;
+    /**
+     * Failure handler (optional).
+     *
+     * Called when the job fails and reaches the maximum number of attempts.
+     * Subclasses can override to implement custom failure handling.
+     *
+     * @param error - Error instance
+     */
+    failed(_error: Error): Promise<void>;
+}
+//# sourceMappingURL=Job.d.ts.map

package/dist/Job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Job.d.ts","sourceRoot":"","sources":["../src/Job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,8BAAsB,GAAI,YAAW,SAAS;IAC5C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAEhC;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3C"}

package/dist/OrbitQueue.d.ts

@@ -0,0 +1,74 @@
+import type { GravitoOrbit, PlanetCore } from 'gravito-core';
+import type { ConsumerOptions } from './Consumer';
+import { QueueManager } from './QueueManager';
+import type { QueueConfig } from './types';
+/**
+ * Orbit Queue configuration options.
+ */
+export interface OrbitQueueOptions extends QueueConfig {
+    /**
+     * Whether to auto-start an embedded worker in development.
+     */
+    autoStartWorker?: boolean;
+    /**
+     * Embedded worker options.
+     */
+    workerOptions?: ConsumerOptions;
+}
+/**
+ * Orbit Queue
+ *
+ * Gravito Orbit implementation providing queue functionality.
+ * Integrates with PlanetCore and injects a `queue` service into the Hono Context.
+ *
+ * @example
+ * ```typescript
+ * const core = await PlanetCore.boot({
+ *   orbits: [
+ *     OrbitQueue.configure({
+ *       default: 'database',
+ *       connections: {
+ *         database: { driver: 'database', table: 'jobs' }
+ *       }
+ *     })
+ *   ]
+ * })
+ *
+ * // Use in a controller/handler
+ * const queue = c.get('queue')
+ * await queue.push(new SendEmail('user@example.com'))
+ * ```
+ */
+export declare class OrbitQueue implements GravitoOrbit {
+    private options;
+    private queueManager?;
+    private consumer?;
+    constructor(options?: OrbitQueueOptions);
+    /**
+     * Static configuration helper.
+     */
+    static configure(options: OrbitQueueOptions): OrbitQueue;
+    /**
+     * Install into PlanetCore.
+     */
+    install(core: PlanetCore): void;
+    /**
+     * Start embedded worker.
+     */
+    startWorker(options: ConsumerOptions): void;
+    /**
+     * Stop embedded worker.
+     */
+    stopWorker(): Promise<void>;
+    /**
+     * Get QueueManager instance.
+     */
+    getQueueManager(): QueueManager | undefined;
+}
+declare module 'hono' {
+    interface ContextVariableMap {
+        queue: QueueManager;
+        db?: unknown;
+    }
+}
+//# sourceMappingURL=OrbitQueue.d.ts.map

package/dist/OrbitQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrbitQueue.d.ts","sourceRoot":"","sources":["../src/OrbitQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IAEzB;;OAEG;IACH,aAAa,CAAC,EAAE,eAAe,CAAA;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,UAAW,YAAW,YAAY;IAIjC,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,CAAU;gBAEP,OAAO,GAAE,iBAAsB;IAEnD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU;IAIxD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAqD/B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAe3C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,SAAS;CAG5C;AAED,OAAO,QAAQ,MAAM,CAAC;IACpB,UAAU,kBAAkB;QAC1B,KAAK,EAAE,YAAY,CAAA;QACnB,EAAE,CAAC,EAAE,OAAO,CAAA;KACb;CACF"}

package/dist/QueueManager.d.ts

@@ -0,0 +1,86 @@
+import type { QueueDriver } from './drivers/QueueDriver';
+import type { Job } from './Job';
+import type { Queueable } from './Queueable';
+import type { JobSerializer } from './serializers/JobSerializer';
+import type { QueueConfig } from './types';
+/**
+ * Queue Manager
+ *
+ * Manages multiple queue connections and drivers, exposing a unified API for pushing and consuming jobs.
+ * Supports lazy-loading drivers to keep the core lightweight.
+ *
+ * @example
+ * ```typescript
+ * const manager = new QueueManager({
+ *   default: 'database',
+ *   connections: {
+ *     database: { driver: 'database', table: 'jobs' },
+ *     redis: { driver: 'redis', url: 'redis://...' }
+ *   }
+ * })
+ *
+ * await manager.push(new SendEmail('user@example.com'))
+ * ```
+ */
+export declare class QueueManager {
+    private drivers;
+    private serializers;
+    private defaultConnection;
+    private defaultSerializer;
+    constructor(config?: QueueConfig);
+    /**
+     * Register a connection.
+     * @param name - Connection name
+     * @param config - Connection config
+     */
+    registerConnection(name: string, config: unknown): void;
+    /**
+     * Get a driver for a connection.
+     * @param connection - Connection name
+     * @returns Driver instance
+     */
+    getDriver(connection: string): QueueDriver;
+    /**
+     * Get a serializer.
+     * @param type - Serializer type
+     * @returns Serializer instance
+     */
+    getSerializer(type?: string): JobSerializer;
+    /**
+     * Register Job classes (used by ClassNameSerializer).
+     * @param jobClasses - Job class array
+     */
+    registerJobClasses(jobClasses: Array<new (...args: unknown[]) => Job>): void;
+    /**
+     * Push a Job to the queue.
+     * @param job - Job instance
+     * @returns The same job instance (for fluent chaining)
+     */
+    push<T extends Job & Queueable>(job: T): Promise<T>;
+    /**
+     * Push multiple jobs.
+     * @param jobs - Job array
+     */
+    pushMany<T extends Job & Queueable>(jobs: T[]): Promise<void>;
+    /**
+     * Pop a job from the queue.
+     * @param queue - Queue name
+     * @param connection - Connection name
+     * @returns Job instance or null
+     */
+    pop(queue?: string, connection?: string): Promise<Job | null>;
+    /**
+     * Get queue size.
+     * @param queue - Queue name
+     * @param connection - Connection name
+     * @returns Number of jobs in the queue
+     */
+    size(queue?: string, connection?: string): Promise<number>;
+    /**
+     * Clear a queue.
+     * @param queue - Queue name
+     * @param connection - Connection name
+     */
+    clear(queue?: string, connection?: string): Promise<void>;
+}
+//# sourceMappingURL=QueueManager.d.ts.map

package/dist/QueueManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueManager.d.ts","sourceRoot":"","sources":["../src/QueueManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,SAAS,CAAA;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,iBAAiB,CAAe;gBAE5B,MAAM,GAAE,WAAgB;IAwBpC;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IA6FvD;;;;OAIG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW;IAQ1C;;;;OAIG;IACH,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa;IAW3C;;;OAGG;IACH,kBAAkB,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,GAAG,IAAI;IAM5E;;;;OAIG;IACG,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAezD;;;OAGG;IACG,QAAQ,CAAC,CAAC,SAAS,GAAG,GAAG,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCnE;;;;;OAKG;IACG,GAAG,CAAC,KAAK,SAAY,EAAE,UAAU,GAAE,MAA+B,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAkB9F;;;;;OAKG;IACG,IAAI,CAAC,KAAK,SAAY,EAAE,UAAU,GAAE,MAA+B,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3F;;;;OAIG;IACG,KAAK,CAAC,KAAK,SAAY,EAAE,UAAU,GAAE,MAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;CAI3F"}

package/dist/Queueable.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Queueable interface.
+ *
+ * Classes implementing this interface can be pushed to a queue for execution.
+ * Provides a fluent API for queue/connection/delay configuration.
+ *
+ * @example
+ * ```typescript
+ * class MyJob implements Queueable {
+ *   queueName?: string
+ *   connectionName?: string
+ *   delaySeconds?: number
+ *
+ *   onQueue(queue: string): this {
+ *     this.queueName = queue
+ *     return this
+ *   }
+ *
+ *   onConnection(connection: string): this {
+ *     this.connectionName = connection
+ *     return this
+ *   }
+ *
+ *   delay(seconds: number): this {
+ *     this.delaySeconds = seconds
+ *     return this
+ *   }
+ * }
+ * ```
+ */
+export interface Queueable {
+    /**
+     * Queue name where the job should be pushed.
+     */
+    queueName?: string;
+    /**
+     * Connection name the job should use.
+     */
+    connectionName?: string;
+    /**
+     * Delay before execution (seconds).
+     */
+    delaySeconds?: number;
+    /**
+     * Set target queue.
+     * @param queue - Queue name
+     * @returns Self for fluent chaining
+     */
+    onQueue(queue: string): this;
+    /**
+     * Set target connection.
+     * @param connection - Connection name
+     * @returns Self for fluent chaining
+     */
+    onConnection(connection: string): this;
+    /**
+     * Set delay (seconds).
+     * @param delay - Delay seconds
+     * @returns Self for fluent chaining
+     */
+    delay(delay: number): this;
+}
+//# sourceMappingURL=Queueable.d.ts.map

package/dist/Queueable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Queueable.d.ts","sourceRoot":"","sources":["../src/Queueable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAE5B;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtC;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B"}