@gravito/stream 1.0.2 → 2.0.0

package/README.md

@@ -59,6 +59,48 @@ const consumer = new Consumer(manager, {
 })
 ```
 
+### 4. Concurrency & Groups
+
+```typescript
+const consumer = new Consumer(manager, {
+  queues: ['default'],
+  concurrency: 5,           // Process up to 5 jobs concurrently
+  groupJobsSequential: true // Ensure jobs with same groupId run sequentially (default: true)
+})
+```
+
+Jobs with the same `groupId` will always be processed in order, even with high concurrency. Jobs from different groups (or no group) will run in parallel.
+
+### 5. Polling & Batching Optimization
+
+```typescript
+const consumer = new Consumer(manager, {
+  queues: ['default'],
+  // Polling Strategy
+  pollInterval: 1000,       // Initial poll interval
+  minPollInterval: 100,     // Adaptive: reduce to 100ms when jobs found
+  maxPollInterval: 5000,    // Adaptive: backoff up to 5s when idle
+  backoffMultiplier: 1.5,   // Exponential backoff factor
+  
+  // Batch Consumption
+  batchSize: 10,            // Fetch 10 jobs at once (requires concurrency > 1 for parallel processing)
+  concurrency: 10,
+  
+  // Blocking Pop (Redis/SQS)
+  useBlocking: true,        // Use BLPOP when batchSize=1 (reduces CPU usage)
+  blockingTimeout: 5        // Block for 5 seconds
+})
+```
+
+### 6. Monitoring & Stats
+
+```typescript
+const stats = consumer.getStats()
+console.log(`Processed: ${stats.processed}, Failed: ${stats.failed}`)
+
+// Metrics are also included in the heartbeat if monitor is enabled
+```
+
 ### 2. Enqueue a job
 
 ```typescript
@@ -90,6 +132,27 @@ const core = await PlanetCore.boot({
 })
 ```
 
+### 5. Polling & Batching Optimization
+
+```typescript
+const consumer = new Consumer(manager, {
+  queues: ['default'],
+  // Polling Strategy
+  pollInterval: 1000,       // Initial poll interval
+  minPollInterval: 100,     // Adaptive: reduce to 100ms when jobs found
+  maxPollInterval: 5000,    // Adaptive: backoff up to 5s when idle
+  backoffMultiplier: 1.5,   // Exponential backoff factor
+  
+  // Batch Consumption
+  batchSize: 10,            // Fetch 10 jobs at once (requires concurrency > 1 for parallel processing)
+  concurrency: 10,
+  
+  // Blocking Pop (Redis/SQS)
+  useBlocking: true,        // Use BLPOP when batchSize=1 (reduces CPU usage)
+  blockingTimeout: 5        // Block for 5 seconds
+})
+```
+
 ## Database Driver Example
 
 ```typescript
@@ -155,9 +218,8 @@ CREATE TABLE jobs (
   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);
-CREATE INDEX idx_jobs_queue_available ON jobs(queue, available_at);
+-- Optimized index for batch popping with SKIP LOCKED
+CREATE INDEX idx_jobs_queue_available_reserved ON jobs(queue, available_at, reserved_at);
 CREATE INDEX idx_jobs_reserved ON jobs(reserved_at);
 ```
 
@@ -174,7 +236,9 @@ OrbitStream.configure({
     adapter: new SQLitePersistence(DB), // or MySQLPersistence
     archiveCompleted: true, // Archive jobs when they complete successfully
     archiveFailed: true,    // Archive jobs when they fail permanently
-    archiveEnqueued: true   // (Audit Mode) Archive jobs immediately when pushed
+    archiveEnqueued: true,  // (Audit Mode) Archive jobs immediately when pushed
+    bufferSize: 100,        // (Optional) Batch size for buffered writes. Recommended: 50-200. Default: 0 (disabled)
+    flushInterval: 1000     // (Optional) Max time (ms) to wait before flushing buffer. Default: 0
   }
 })
 ```
@@ -189,12 +253,46 @@ When Audit Mode is enabled, every job pushed to the queue is immediately written
 ## Standalone Worker
 
 ```bash
-bun run packages/orbit-queue/cli/queue-worker.ts \
+bun run packages/stream/cli/queue-worker.ts \
   --connection=database \
   --queues=default,emails \
   --workers=4
 ```
 
+## Debugging & Monitoring
+
+### Enable Debug Mode
+
+Enable verbose logging to see detailed information about job lifecycle events (enqueue, process, complete, fail).
+
+```typescript
+OrbitStream.configure({
+  debug: true, // Enable debug logging
+  // ...
+})
+```
+
+```typescript
+const consumer = new Consumer(manager, {
+  debug: true, // Enable consumer debug logging
+  // ...
+})
+```
+
+### Monitoring
+
+The Consumer emits events that you can listen to for custom monitoring:
+
+```typescript
+consumer.on('job:started', ({ job, queue }) => {
+  console.log(`Job ${job.id} started on ${queue}`)
+})
+
+consumer.on('job:failed', ({ job, error }) => {
+  console.error(`Job ${job.id} failed: ${error.message}`)
+})
+```
+
 ## API Reference
 
 ### Job
@@ -241,6 +339,13 @@ class QueueManager {
 - **SQSDriver** - standard/FIFO queues and long polling
 - **RabbitMQDriver** - exchanges, queues, and advanced confirm mode
 
+## Best Practices
+
+1.  **Idempotency**: Ensure your jobs are idempotent. Jobs may be retried if they fail or if the worker crashes.
+2.  **Granularity**: Keep jobs small and focused. Large jobs can block workers and increase memory usage.
+3.  **Timeouts**: Set appropriate timeouts for your jobs to prevent them from hanging indefinitely.
+4.  **Error Handling**: Use the `failed` method or throw errors to trigger retries. Avoid swallowing errors unless you want to suppress retries.
+
 ## License
 
 MIT

package/dist/index.cjs

@@ -2198,6 +2198,7 @@ var OrbitStream = class _OrbitStream {
    */
   install(core) {
     this.queueManager = new QueueManager(this.options);
+    core.container.instance("queue", this.queueManager);
     core.adapter.use("*", async (c, next) => {
       if (this.queueManager && this.options.connections) {
         for (const [name, config] of Object.entries(this.options.connections)) {
@@ -2371,9 +2372,15 @@ var MySQLPersistence = class {
    */
   async listLogs(options = {}) {
     let query = this.db.table(this.logsTable);
-    if (options.level) query = query.where("level", options.level);
-    if (options.workerId) query = query.where("worker_id", options.workerId);
-    if (options.queue) query = query.where("queue", options.queue);
+    if (options.level) {
+      query = query.where("level", options.level);
+    }
+    if (options.workerId) {
+      query = query.where("worker_id", options.workerId);
+    }
+    if (options.queue) {
+      query = query.where("queue", options.queue);
+    }
     if (options.search) {
       query = query.where("message", "like", `%${options.search}%`);
     }
@@ -2390,9 +2397,15 @@ var MySQLPersistence = class {
    */
   async countLogs(options = {}) {
     let query = this.db.table(this.logsTable);
-    if (options.level) query = query.where("level", options.level);
-    if (options.workerId) query = query.where("worker_id", options.workerId);
-    if (options.queue) query = query.where("queue", options.queue);
+    if (options.level) {
+      query = query.where("level", options.level);
+    }
+    if (options.workerId) {
+      query = query.where("worker_id", options.workerId);
+    }
+    if (options.queue) {
+      query = query.where("queue", options.queue);
+    }
     if (options.search) {
       query = query.where("message", "like", `%${options.search}%`);
     }
@@ -2445,7 +2458,9 @@ var MySQLPersistence = class {
   }
   async setupJobsTable() {
     const exists = await import_atlas.Schema.hasTable(this.table);
-    if (exists) return;
+    if (exists) {
+      return;
+    }
     await import_atlas.Schema.create(this.table, (table) => {
       table.id();
       table.string("job_id", 64);
@@ -2464,7 +2479,9 @@ var MySQLPersistence = class {
   }
   async setupLogsTable() {
     const exists = await import_atlas.Schema.hasTable(this.logsTable);
-    if (exists) return;
+    if (exists) {
+      return;
+    }
     await import_atlas.Schema.create(this.logsTable, (table) => {
       table.id();
       table.string("level", 20);
@@ -2594,9 +2611,15 @@ var SQLitePersistence = class {
    */
   async listLogs(options = {}) {
     let query = this.db.table(this.logsTable);
-    if (options.level) query = query.where("level", options.level);
-    if (options.workerId) query = query.where("worker_id", options.workerId);
-    if (options.queue) query = query.where("queue", options.queue);
+    if (options.level) {
+      query = query.where("level", options.level);
+    }
+    if (options.workerId) {
+      query = query.where("worker_id", options.workerId);
+    }
+    if (options.queue) {
+      query = query.where("queue", options.queue);
+    }
     if (options.search) {
       query = query.where("message", "like", `%${options.search}%`);
     }
@@ -2613,9 +2636,15 @@ var SQLitePersistence = class {
    */
   async countLogs(options = {}) {
     let query = this.db.table(this.logsTable);
-    if (options.level) query = query.where("level", options.level);
-    if (options.workerId) query = query.where("worker_id", options.workerId);
-    if (options.queue) query = query.where("queue", options.queue);
+    if (options.level) {
+      query = query.where("level", options.level);
+    }
+    if (options.workerId) {
+      query = query.where("worker_id", options.workerId);
+    }
+    if (options.queue) {
+      query = query.where("queue", options.queue);
+    }
     if (options.search) {
       query = query.where("message", "like", `%${options.search}%`);
     }
@@ -2668,7 +2697,9 @@ var SQLitePersistence = class {
   }
   async setupJobsTable() {
     const exists = await import_atlas2.Schema.hasTable(this.table);
-    if (exists) return;
+    if (exists) {
+      return;
+    }
     await import_atlas2.Schema.create(this.table, (table) => {
       table.id();
       table.string("job_id", 64);
@@ -2685,7 +2716,9 @@ var SQLitePersistence = class {
   }
   async setupLogsTable() {
     const exists = await import_atlas2.Schema.hasTable(this.logsTable);
-    if (exists) return;
+    if (exists) {
+      return;
+    }
     await import_atlas2.Schema.create(this.logsTable, (table) => {
       table.id();
       table.string("level", 20);

package/dist/index.d.cts

@@ -1,94 +1,59 @@
 import { GravitoOrbit, PlanetCore } from '@gravito/core';
 
 /**
- * Serialized job payload.
+ * Represents a job that has been serialized for storage in a queue.
+ * @public
  */
 interface SerializedJob {
-    /**
-     * Unique job identifier.
-     */
+    /** Unique job identifier */
     id: string;
-    /**
-     * Serializer type: `'json'` or `'class'`.
-     */
+    /** Serializer type: 'json' for plain objects or 'class' for instances */
     type: 'json' | 'class';
-    /**
-     * Serialized data.
-     */
+    /** Serialized data string */
     data: string;
-    /**
-     * Class name (only for `type === 'class'`).
-     */
+    /** Fully qualified class name (only used for 'class' type) */
     className?: string;
-    /**
-     * Created timestamp.
-     */
+    /** Timestamp when the job was created */
     createdAt: number;
-    /**
-     * Delay before execution (seconds).
-     */
+    /** Optional delay in seconds before the job becomes available for processing */
     delaySeconds?: number;
-    /**
-     * Current attempt number.
-     */
+    /** Number of times the job has been attempted */
     attempts?: number;
-    /**
-     * Maximum attempts.
-     */
+    /** Maximum number of retry attempts before the job is marked as failed */
     maxAttempts?: number;
-    /**
-     * Group ID for FIFO ordering.
-     */
+    /** Group ID for FIFO (strictly sequential) processing */
     groupId?: string;
-    /**
-     * Initial retry delay (seconds).
-     */
+    /** Initial delay in seconds before first retry attempt */
     retryAfterSeconds?: number;
-    /**
-     * Retry delay multiplier.
-     */
+    /** Multiplier for exponential backoff on retries */
     retryMultiplier?: number;
-    /**
-     * Last error message.
-     */
+    /** Last error message if the job failed */
     error?: string;
-    /**
-     * Timestamp when the job failed permanently.
-     */
+    /** Timestamp when the job finally failed after max attempts */
     failedAt?: number;
-    /**
-     * Job priority.
-     */
+    /** Optional priority for the job (string or numeric) */
     priority?: string | number;
 }
 /**
- * Topic options (for Kafka, etc.).
+ * Advanced topic options for distributed queues (e.g., Kafka).
+ * @public
  */
 interface TopicOptions {
-    /**
-     * Number of partitions.
-     */
+    /** Number of partitions for the topic */
     partitions?: number;
-    /**
-     * Replication factor.
-     */
+    /** Number of replicas for each partition */
     replicationFactor?: number;
-    /**
-     * Additional config.
-     */
+    /** Additional driver-specific configurations */
     config?: Record<string, string>;
 }
 /**
- * Queue connection config.
+ * Configuration for a specific queue connection.
+ * @public
  */
 interface QueueConnectionConfig {
-    /**
-     * Driver type.
-     */
+    /** The driver type to use for this connection */
     driver: 'memory' | 'database' | 'redis' | 'kafka' | 'sqs' | 'rabbitmq' | 'nats';
-    /**
-     * Driver-specific config.
-     */
+    /** Driver-specific settings (e.g., connection string, table name) */
     [key: string]: unknown;
 }
 /**
@@ -1434,41 +1399,36 @@ declare class SQSDriver implements QueueDriver {
 }
 
 /**
- * Orbit Queue configuration options.
+ * Options for configuring OrbitStream (Queue Orbit).
+ * @public
  */
 interface OrbitStreamOptions extends QueueConfig {
     /**
-     * Whether to auto-start an embedded worker in development.
+     * Whether to automatically start an embedded worker in development mode.
+     * Useful for simple local testing without running a separate worker process.
      */
     autoStartWorker?: boolean;
     /**
-     * Embedded worker options.
+     * Configuration for the embedded worker/consumer.
      */
     workerOptions?: ConsumerOptions;
 }
 /**
- * Orbit Queue
- *
- * Gravito Orbit implementation providing queue functionality.
- * Integrates with PlanetCore and injects a `queue` service into the Photon Context.
+ * OrbitStream provides a powerful, multi-driver queue system for Gravito.
+ * It integrates with various backends (Redis, Database, SQS, RabbitMQ)
+ * and supports job serialization, delayed jobs, and FIFO processing.
  *
  * @example
  * ```typescript
- * const core = await PlanetCore.boot({
- *   orbits: [
- *     OrbitStream.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'))
+ * const stream = new OrbitStream({
+ *   default: 'redis',
+ *   connections: {
+ *     redis: { driver: 'redis', host: 'localhost' }
+ *   }
+ * });
+ * core.addOrbit(stream);
  * ```
+ * @public
  */
 declare class OrbitStream implements GravitoOrbit {
     private options;
@@ -1695,19 +1655,47 @@ declare class SQLitePersistence implements PersistenceAdapter {
     private setupLogsTable;
 }
 
+/**
+ * Configuration for a recurring scheduled job.
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface ScheduledJobConfig {
+    /** Unique identifier for the scheduled task. */
     id: string;
+    /** Cron expression defining the schedule (e.g., '* * * * *'). */
     cron: string;
+    /** The target queue name where the job should be pushed. */
     queue: string;
+    /** The serialized job data. */
     job: SerializedJob;
+    /** Timestamp of the last successful execution in milliseconds. */
     lastRun?: number;
+    /** Timestamp of the next scheduled execution in milliseconds. */
     nextRun?: number;
+    /** Whether the scheduled job is active. */
     enabled: boolean;
 }
 /**
- * Scheduler
+ * Scheduler manages recurring (cron) jobs in Gravito.
+ *
+ * It uses Redis to store schedule metadata and coordinates distributed
+ * execution using locks to ensure jobs are triggered exactly once per interval.
+ *
+ * @example
+ * ```typescript
+ * const scheduler = new Scheduler(queueManager);
+ * await scheduler.register({
+ *   id: 'daily-cleanup',
+ *   cron: '0 0 * * *',
+ *   queue: 'default',
+ *   job: myJob.serialize()
+ * });
+ * ```
  *
- * Manages recurring (cron) jobs.
+ * @public
+ * @since 3.0.0
  */
 declare class Scheduler {
     private manager;

package/dist/index.d.ts

@@ -1,94 +1,59 @@
 import { GravitoOrbit, PlanetCore } from '@gravito/core';
 
 /**
- * Serialized job payload.
+ * Represents a job that has been serialized for storage in a queue.
+ * @public
  */
 interface SerializedJob {
-    /**
-     * Unique job identifier.
-     */
+    /** Unique job identifier */
     id: string;
-    /**
-     * Serializer type: `'json'` or `'class'`.
-     */
+    /** Serializer type: 'json' for plain objects or 'class' for instances */
     type: 'json' | 'class';
-    /**
-     * Serialized data.
-     */
+    /** Serialized data string */
     data: string;
-    /**
-     * Class name (only for `type === 'class'`).
-     */
+    /** Fully qualified class name (only used for 'class' type) */
     className?: string;
-    /**
-     * Created timestamp.
-     */
+    /** Timestamp when the job was created */
     createdAt: number;
-    /**
-     * Delay before execution (seconds).
-     */
+    /** Optional delay in seconds before the job becomes available for processing */
     delaySeconds?: number;
-    /**
-     * Current attempt number.
-     */
+    /** Number of times the job has been attempted */
     attempts?: number;
-    /**
-     * Maximum attempts.
-     */
+    /** Maximum number of retry attempts before the job is marked as failed */
     maxAttempts?: number;
-    /**
-     * Group ID for FIFO ordering.
-     */
+    /** Group ID for FIFO (strictly sequential) processing */
     groupId?: string;
-    /**
-     * Initial retry delay (seconds).
-     */
+    /** Initial delay in seconds before first retry attempt */
     retryAfterSeconds?: number;
-    /**
-     * Retry delay multiplier.
-     */
+    /** Multiplier for exponential backoff on retries */
     retryMultiplier?: number;
-    /**
-     * Last error message.
-     */
+    /** Last error message if the job failed */
     error?: string;
-    /**
-     * Timestamp when the job failed permanently.
-     */
+    /** Timestamp when the job finally failed after max attempts */
     failedAt?: number;
-    /**
-     * Job priority.
-     */
+    /** Optional priority for the job (string or numeric) */
     priority?: string | number;
 }
 /**
- * Topic options (for Kafka, etc.).
+ * Advanced topic options for distributed queues (e.g., Kafka).
+ * @public
  */
 interface TopicOptions {
-    /**
-     * Number of partitions.
-     */
+    /** Number of partitions for the topic */
     partitions?: number;
-    /**
-     * Replication factor.
-     */
+    /** Number of replicas for each partition */
     replicationFactor?: number;
-    /**
-     * Additional config.
-     */
+    /** Additional driver-specific configurations */
     config?: Record<string, string>;
 }
 /**
- * Queue connection config.
+ * Configuration for a specific queue connection.
+ * @public
  */
 interface QueueConnectionConfig {
-    /**
-     * Driver type.
-     */
+    /** The driver type to use for this connection */
     driver: 'memory' | 'database' | 'redis' | 'kafka' | 'sqs' | 'rabbitmq' | 'nats';
-    /**
-     * Driver-specific config.
-     */
+    /** Driver-specific settings (e.g., connection string, table name) */
     [key: string]: unknown;
 }
 /**
@@ -1434,41 +1399,36 @@ declare class SQSDriver implements QueueDriver {
 }
 
 /**
- * Orbit Queue configuration options.
+ * Options for configuring OrbitStream (Queue Orbit).
+ * @public
  */
 interface OrbitStreamOptions extends QueueConfig {
     /**
-     * Whether to auto-start an embedded worker in development.
+     * Whether to automatically start an embedded worker in development mode.
+     * Useful for simple local testing without running a separate worker process.
      */
     autoStartWorker?: boolean;
     /**
-     * Embedded worker options.
+     * Configuration for the embedded worker/consumer.
      */
     workerOptions?: ConsumerOptions;
 }
 /**
- * Orbit Queue
- *
- * Gravito Orbit implementation providing queue functionality.
- * Integrates with PlanetCore and injects a `queue` service into the Photon Context.
+ * OrbitStream provides a powerful, multi-driver queue system for Gravito.
+ * It integrates with various backends (Redis, Database, SQS, RabbitMQ)
+ * and supports job serialization, delayed jobs, and FIFO processing.
  *
  * @example
  * ```typescript
- * const core = await PlanetCore.boot({
- *   orbits: [
- *     OrbitStream.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'))
+ * const stream = new OrbitStream({
+ *   default: 'redis',
+ *   connections: {
+ *     redis: { driver: 'redis', host: 'localhost' }
+ *   }
+ * });
+ * core.addOrbit(stream);
  * ```
+ * @public
  */
 declare class OrbitStream implements GravitoOrbit {
     private options;
@@ -1695,19 +1655,47 @@ declare class SQLitePersistence implements PersistenceAdapter {
     private setupLogsTable;
 }
 
+/**
+ * Configuration for a recurring scheduled job.
+ *
+ * @public
+ * @since 3.0.0
+ */
 interface ScheduledJobConfig {
+    /** Unique identifier for the scheduled task. */
     id: string;
+    /** Cron expression defining the schedule (e.g., '* * * * *'). */
     cron: string;
+    /** The target queue name where the job should be pushed. */
     queue: string;
+    /** The serialized job data. */
     job: SerializedJob;
+    /** Timestamp of the last successful execution in milliseconds. */
     lastRun?: number;
+    /** Timestamp of the next scheduled execution in milliseconds. */
     nextRun?: number;
+    /** Whether the scheduled job is active. */
     enabled: boolean;
 }
 /**
- * Scheduler
+ * Scheduler manages recurring (cron) jobs in Gravito.
+ *
+ * It uses Redis to store schedule metadata and coordinates distributed
+ * execution using locks to ensure jobs are triggered exactly once per interval.
+ *
+ * @example
+ * ```typescript
+ * const scheduler = new Scheduler(queueManager);
+ * await scheduler.register({
+ *   id: 'daily-cleanup',
+ *   cron: '0 0 * * *',
+ *   queue: 'default',
+ *   job: myJob.serialize()
+ * });
+ * ```
  *
- * Manages recurring (cron) jobs.
+ * @public
+ * @since 3.0.0
  */
 declare class Scheduler {
     private manager;

package/dist/index.js

@@ -2171,6 +2171,7 @@ var OrbitStream = class _OrbitStream {
    */
   install(core) {
     this.queueManager = new QueueManager(this.options);
+    core.container.instance("queue", this.queueManager);
     core.adapter.use("*", async (c, next) => {
       if (this.queueManager && this.options.connections) {
         for (const [name, config] of Object.entries(this.options.connections)) {
@@ -2344,9 +2345,15 @@ var MySQLPersistence = class {
    */
   async listLogs(options = {}) {
     let query = this.db.table(this.logsTable);
-    if (options.level) query = query.where("level", options.level);
-    if (options.workerId) query = query.where("worker_id", options.workerId);
-    if (options.queue) query = query.where("queue", options.queue);
+    if (options.level) {
+      query = query.where("level", options.level);
+    }
+    if (options.workerId) {
+      query = query.where("worker_id", options.workerId);
+    }
+    if (options.queue) {
+      query = query.where("queue", options.queue);
+    }
     if (options.search) {
       query = query.where("message", "like", `%${options.search}%`);
     }
@@ -2363,9 +2370,15 @@ var MySQLPersistence = class {
    */
   async countLogs(options = {}) {
     let query = this.db.table(this.logsTable);
-    if (options.level) query = query.where("level", options.level);
-    if (options.workerId) query = query.where("worker_id", options.workerId);
-    if (options.queue) query = query.where("queue", options.queue);
+    if (options.level) {
+      query = query.where("level", options.level);
+    }
+    if (options.workerId) {
+      query = query.where("worker_id", options.workerId);
+    }
+    if (options.queue) {
+      query = query.where("queue", options.queue);
+    }
     if (options.search) {
       query = query.where("message", "like", `%${options.search}%`);
     }
@@ -2418,7 +2431,9 @@ var MySQLPersistence = class {
   }
   async setupJobsTable() {
     const exists = await Schema.hasTable(this.table);
-    if (exists) return;
+    if (exists) {
+      return;
+    }
     await Schema.create(this.table, (table) => {
       table.id();
       table.string("job_id", 64);
@@ -2437,7 +2452,9 @@ var MySQLPersistence = class {
   }
   async setupLogsTable() {
     const exists = await Schema.hasTable(this.logsTable);
-    if (exists) return;
+    if (exists) {
+      return;
+    }
     await Schema.create(this.logsTable, (table) => {
       table.id();
       table.string("level", 20);
@@ -2567,9 +2584,15 @@ var SQLitePersistence = class {
    */
   async listLogs(options = {}) {
     let query = this.db.table(this.logsTable);
-    if (options.level) query = query.where("level", options.level);
-    if (options.workerId) query = query.where("worker_id", options.workerId);
-    if (options.queue) query = query.where("queue", options.queue);
+    if (options.level) {
+      query = query.where("level", options.level);
+    }
+    if (options.workerId) {
+      query = query.where("worker_id", options.workerId);
+    }
+    if (options.queue) {
+      query = query.where("queue", options.queue);
+    }
     if (options.search) {
       query = query.where("message", "like", `%${options.search}%`);
     }
@@ -2586,9 +2609,15 @@ var SQLitePersistence = class {
    */
   async countLogs(options = {}) {
     let query = this.db.table(this.logsTable);
-    if (options.level) query = query.where("level", options.level);
-    if (options.workerId) query = query.where("worker_id", options.workerId);
-    if (options.queue) query = query.where("queue", options.queue);
+    if (options.level) {
+      query = query.where("level", options.level);
+    }
+    if (options.workerId) {
+      query = query.where("worker_id", options.workerId);
+    }
+    if (options.queue) {
+      query = query.where("queue", options.queue);
+    }
     if (options.search) {
       query = query.where("message", "like", `%${options.search}%`);
     }
@@ -2641,7 +2670,9 @@ var SQLitePersistence = class {
   }
   async setupJobsTable() {
     const exists = await Schema2.hasTable(this.table);
-    if (exists) return;
+    if (exists) {
+      return;
+    }
     await Schema2.create(this.table, (table) => {
       table.id();
       table.string("job_id", 64);
@@ -2658,7 +2689,9 @@ var SQLitePersistence = class {
   }
   async setupLogsTable() {
     const exists = await Schema2.hasTable(this.logsTable);
-    if (exists) return;
+    if (exists) {
+      return;
+    }
     await Schema2.create(this.logsTable, (table) => {
       table.id();
       table.string("level", 20);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/stream",
-  "version": "1.0.2",
+  "version": "2.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -25,8 +25,8 @@
     "build": "bun run build.ts",
     "test": "bun test",
     "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
-    "test:coverage": "bun test --coverage --coverage-threshold=80",
-    "test:ci": "bun test --coverage --coverage-threshold=80"
+    "test:coverage": "bun test --coverage --coverage-threshold=70",
+    "test:ci": "bun test --coverage --coverage-threshold=70"
   },
   "keywords": [
     "gravito",
@@ -47,7 +47,10 @@
     "cron-parser": "^5.4.0"
   },
   "devDependencies": {
+    "@types/ioredis": "^5.0.0",
     "bun-types": "latest",
+    "ioredis": "^5.9.2",
+    "mitata": "^1.0.34",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
@@ -57,4 +60,4 @@
     "url": "git+https://github.com/gravito-framework/gravito.git",
     "directory": "packages/stream"
   }
-}
+}