@objectstack/service-queue 9.4.0 → 9.5.1

package/README.md

@@ -1,17 +1,26 @@
 # @objectstack/service-queue
 
-Queue Service for ObjectStack — implements `IQueueService` with in-memory and BullMQ adapters.
+Queue Service for ObjectStack — implements `IQueueService` with an in-memory
+adapter and a durable, database-backed adapter (`sys_job_queue`).
 
-## Features
+## Adapters
 
-- **Multiple Adapters**: In-memory (development) and BullMQ/Redis (production)
-- **Job Queues**: Organize work into named queues with priorities
-- **Worker Pools**: Process jobs concurrently with configurable workers
-- **Retry Logic**: Automatic retry with exponential backoff
-- **Job Scheduling**: Delay job execution or schedule for future
-- **Progress Tracking**: Track job progress and completion
-- **Job Events**: Listen to job lifecycle events (active, completed, failed)
-- **Rate Limiting**: Control job processing rate
+| Adapter | Durable | Multi-node | Use |
+| --- | --- | --- | --- |
+| `memory` | No (in-process) | No | dev / test / ephemeral work |
+| `db` | Yes (`sys_job_queue`) | Yes (lease-based claim) | **production default** |
+| `auto` *(default)* | — | — | `db` when an ObjectQL engine is present, else `memory` |
+
+The `db` adapter persists messages, retries, and the dead-letter queue to the
+`sys_job_queue` object. Multiple worker processes claim messages from the
+shared table with a lease (`leaseMs`), so it works across a multi-node
+deployment **without any external broker** — no Redis required. Studio can list
+and replay the DLQ because `sys_job_queue` is a first-class object.
+
+> A BullMQ/Redis adapter is **not** shipped. The durable path is the DB adapter;
+> it rides on the same datasource the runtime already uses. If you genuinely
+> need a Redis-backed broker, register a custom `IQueueService` via
+> `ctx.registerService('queue', myAdapter)`.
 
 ## Installation
 
@@ -19,435 +28,79 @@ Queue Service for ObjectStack — implements `IQueueService` with in-memory and
 pnpm add @objectstack/service-queue
 ```
 
-For BullMQ adapter (production):
-```bash
-pnpm add bullmq ioredis
-```
-
-## Basic Usage
-
-```typescript
-import { defineStack } from '@objectstack/spec';
-import { ServiceQueue } from '@objectstack/service-queue';
-
-const stack = defineStack({
-  services: [
-    ServiceQueue.configure({
-      adapter: 'memory', // or 'bullmq'
-      defaultQueue: 'default',
-    }),
-  ],
-});
-```
-
-## Configuration
-
-### In-Memory Adapter (Development)
-
-```typescript
-ServiceQueue.configure({
-  adapter: 'memory',
-  concurrency: 5, // Max concurrent jobs
-});
-```
-
-### BullMQ Adapter (Production)
-
-```typescript
-ServiceQueue.configure({
-  adapter: 'bullmq',
-  redis: {
-    host: 'localhost',
-    port: 6379,
-    password: process.env.REDIS_PASSWORD,
-  },
-  queues: {
-    default: { concurrency: 10 },
-    email: { concurrency: 5, rateLimit: { max: 100, duration: 60000 } },
-    reports: { concurrency: 2 },
-  },
-});
-```
-
-## Service API
-
-```typescript
-// Get queue service
-const queue = kernel.getService<IQueueService>('queue');
-```
-
-### Adding Jobs
-
-```typescript
-// Add a simple job
-await queue.add('email', 'send_welcome', {
-  to: 'user@example.com',
-  template: 'welcome',
-});
-
-// Add job with options
-await queue.add('reports', 'generate_monthly', {
-  month: '2024-01',
-  format: 'pdf',
-}, {
-  priority: 1, // Higher number = higher priority
-  attempts: 3, // Retry up to 3 times
-  backoff: {
-    type: 'exponential',
-    delay: 1000,
-  },
-});
-
-// Add delayed job (runs in 1 hour)
-await queue.add('notifications', 'reminder', {
-  userId: '123',
-  message: 'Don't forget!',
-}, {
-  delay: 3600000, // 1 hour in milliseconds
-});
-
-// Schedule job for specific time
-await queue.add('cleanup', 'old_files', {}, {
-  timestamp: new Date('2024-12-31T23:59:59Z').getTime(),
-});
-```
-
-### Processing Jobs
-
-```typescript
-// Register a job processor
-queue.process('email', async (job) => {
-  console.log('Processing email job:', job.data);
-
-  // Access job data
-  const { to, template } = job.data;
-
-  // Update progress
-  await job.updateProgress(25);
-
-  // Send email
-  await sendEmail(to, template);
-
-  await job.updateProgress(100);
-
-  // Return result
-  return { sent: true, messageId: 'msg_123' };
-});
-
-// Process with concurrency
-queue.process('reports', 5, async (job) => {
-  // Up to 5 reports generated concurrently
-  return await generateReport(job.data);
-});
-
-// Process with named handler
-queue.process('default', 'calculate_metrics', async (job) => {
-  return await calculateMetrics(job.data);
-});
-```
-
-### Job Management
-
-```typescript
-// Get job by ID
-const job = await queue.getJob('email', 'job_abc123');
-
-// Get job status
-const status = await job.getState();
-// 'waiting' | 'active' | 'completed' | 'failed' | 'delayed'
-
-// Remove job
-await queue.removeJob('email', 'job_abc123');
-
-// Retry failed job
-await queue.retryJob('email', 'job_abc123');
-
-// Get job result
-const result = await job.returnvalue;
-```
-
-### Queue Operations
-
-```typescript
-// Pause queue (stop processing new jobs)
-await queue.pause('email');
-
-// Resume queue
-await queue.resume('email');
-
-// Clear all jobs in queue
-await queue.clear('email');
-
-// Get queue statistics
-const stats = await queue.getStats('email');
-// {
-//   waiting: 45,
-//   active: 5,
-//   completed: 1250,
-//   failed: 12,
-//   delayed: 3
-// }
-```
-
-## Advanced Features
-
-### Job Events
-
-```typescript
-// Listen to job lifecycle events
-queue.on('email', 'completed', async (job, result) => {
-  console.log(`Email sent: ${result.messageId}`);
-});
-
-queue.on('email', 'failed', async (job, error) => {
-  console.error(`Email failed: ${error.message}`);
-  // Send alert to admin
-});
-
-queue.on('email', 'progress', async (job, progress) => {
-  console.log(`Email progress: ${progress}%`);
-});
-
-queue.on('email', 'active', async (job) => {
-  console.log(`Email job started: ${job.id}`);
-});
-```
-
-### Bulk Operations
-
-```typescript
-// Add multiple jobs at once
-await queue.addBulk('email', [
-  { name: 'send_welcome', data: { to: 'user1@example.com' } },
-  { name: 'send_welcome', data: { to: 'user2@example.com' } },
-  { name: 'send_welcome', data: { to: 'user3@example.com' } },
-]);
-
-// Get multiple jobs
-const jobs = await queue.getJobs('email', ['waiting', 'active']);
-```
-
-### Job Patterns
-
-#### Worker Pattern
-
-```typescript
-// Dedicated worker process
-queue.process('heavy_processing', async (job) => {
-  // CPU-intensive work
-  const result = await processLargeDataset(job.data);
-  return result;
-});
-```
-
-#### Fan-Out Pattern
-
-```typescript
-// Split work across multiple jobs
-await queue.add('orchestrator', 'process_batch', { batchId: '123' });
-
-queue.process('orchestrator', async (job) => {
-  const items = await loadBatchItems(job.data.batchId);
-
-  // Create sub-jobs for each item
-  for (const item of items) {
-    await queue.add('worker', 'process_item', { item });
-  }
-});
-
-queue.process('worker', async (job) => {
-  return await processItem(job.data.item);
-});
-```
-
-#### Priority Queues
-
-```typescript
-// High priority
-await queue.add('tasks', 'urgent', data, { priority: 10 });
-
-// Normal priority
-await queue.add('tasks', 'normal', data, { priority: 5 });
-
-// Low priority
-await queue.add('tasks', 'background', data, { priority: 1 });
-```
-
-### Rate Limiting
-
-```typescript
-// Limit queue to 100 jobs per minute
-ServiceQueue.configure({
-  adapter: 'bullmq',
-  queues: {
-    api_calls: {
-      concurrency: 5,
-      rateLimit: {
-        max: 100,
-        duration: 60000, // 1 minute
-      },
-    },
-  },
-});
-```
-
-### Repeatable Jobs
+## Usage
 
 ```typescript
-// Add cron-based repeatable job
-await queue.addRepeatable('cleanup', 'old_sessions', {}, {
-  cron: '0 2 * * *', // Daily at 2 AM
-});
-
-// Add interval-based repeatable job
-await queue.addRepeatable('sync', 'data', {}, {
-  every: 300000, // Every 5 minutes
-});
-
-// Remove repeatable job
-await queue.removeRepeatable('cleanup', 'old_sessions');
-```
+import { ObjectKernel } from '@objectstack/core';
+import { QueueServicePlugin } from '@objectstack/service-queue';
 
-## Common Use Cases
+const kernel = new ObjectKernel();
+// 'auto' (default): durable DbQueueAdapter when ObjectQL is available, else memory
+kernel.use(new QueueServicePlugin({ adapter: 'auto' }));
+await kernel.bootstrap();
 
-### Email Queue
+const queue = kernel.getService('queue'); // IQueueService
 
-```typescript
-queue.process('email', async (job) => {
-  const { to, subject, body, template } = job.data;
-
-  try {
-    const result = await emailProvider.send({
-      to,
-      subject,
-      html: renderTemplate(template, job.data),
-    });
-
-    return { messageId: result.id, sentAt: new Date() };
-  } catch (error) {
-    // Throw error to trigger retry
-    throw new Error(`Failed to send email: ${error.message}`);
-  }
+// Publish a message
+await queue.subscribe('email', async (msg) => {
+  await sendEmail(msg.data);
 });
 
-// Add email job
-await queue.add('email', 'welcome', {
-  to: 'newuser@example.com',
-  template: 'welcome',
-  name: 'John Doe',
-}, {
+await queue.publish('email', { to: 'user@example.com', template: 'welcome' }, {
+  // delay / priority / retries (see QueuePublishOptions)
   attempts: 3,
-  backoff: { type: 'exponential', delay: 5000 },
-});
-```
-
-### Report Generation
-
-```typescript
-queue.process('reports', async (job) => {
-  const { reportType, userId, dateRange } = job.data;
-
-  await job.updateProgress(10);
-
-  // Fetch data
-  const data = await fetchReportData(reportType, dateRange);
-
-  await job.updateProgress(50);
-
-  // Generate report
-  const report = await generatePDF(data);
-
-  await job.updateProgress(90);
-
-  // Upload to storage
-  const url = await uploadReport(report);
-
-  await job.updateProgress(100);
-
-  // Notify user
-  await notifyUser(userId, { reportUrl: url });
-
-  return { url, size: report.length };
 });
 ```
 
-### Webhook Processing
+### Configuration
 
 ```typescript
-queue.process('webhooks', async (job) => {
-  const { url, payload, headers } = job.data;
-
-  const response = await fetch(url, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify(payload),
-  });
-
-  if (!response.ok) {
-    throw new Error(`Webhook failed: ${response.status}`);
-  }
-
-  return { status: response.status, responseTime: Date.now() - job.timestamp };
+// Force the durable DB adapter (requires an ObjectQL engine)
+new QueueServicePlugin({
+  adapter: 'db',
+  db: {
+    pollIntervalMs: 1000,   // worker poll cadence
+    batchSize: 10,          // messages claimed per tick
+    leaseMs: 30000,         // lease before another worker may reclaim
+    idempotencyWindowMs: 24 * 60 * 60 * 1000,
+  },
 });
-```
 
-## REST API Endpoints
-
-```
-POST   /api/v1/queues/:queue/jobs           # Add job
-GET    /api/v1/queues/:queue/jobs/:id       # Get job
-DELETE /api/v1/queues/:queue/jobs/:id       # Remove job
-POST   /api/v1/queues/:queue/jobs/:id/retry # Retry failed job
-GET    /api/v1/queues/:queue/stats          # Get queue stats
-POST   /api/v1/queues/:queue/pause          # Pause queue
-POST   /api/v1/queues/:queue/resume         # Resume queue
-DELETE /api/v1/queues/:queue                # Clear queue
+// In-process only (non-durable) — dev / test
+new QueueServicePlugin({ adapter: 'memory' });
 ```
 
-## Best Practices
-
-1. **Idempotent Jobs**: Design jobs to be safely retried
-2. **Error Handling**: Always handle errors and throw to trigger retry
-3. **Progress Updates**: Update progress for long-running jobs
-4. **Resource Limits**: Set appropriate concurrency limits
-5. **Job Data**: Keep job data small (< 1MB)
-6. **Monitoring**: Track queue metrics and job failure rates
-7. **Cleanup**: Remove completed jobs periodically
-
-## Performance Considerations
-
-- **Concurrency**: Tune based on system resources and external API limits
-- **Rate Limiting**: Prevent overwhelming external services
-- **Job Size**: Keep job payloads small for faster serialization
-- **Redis Connection**: Use connection pooling for BullMQ
-- **Queue Organization**: Use separate queues for different job types
-
-## Contract Implementation
+## Service API
 
 Implements `IQueueService` from `@objectstack/spec/contracts`:
 
 ```typescript
 interface IQueueService {
-  add(queue: string, name: string, data: any, options?: JobOptions): Promise<Job>;
-  addBulk(queue: string, jobs: JobDefinition[]): Promise<Job[]>;
-  process(queue: string, handler: JobHandler): void;
-  getJob(queue: string, jobId: string): Promise<Job | null>;
-  removeJob(queue: string, jobId: string): Promise<void>;
-  retryJob(queue: string, jobId: string): Promise<void>;
-  getStats(queue: string): Promise<QueueStats>;
-  pause(queue: string): Promise<void>;
-  resume(queue: string): Promise<void>;
-  clear(queue: string): Promise<void>;
-  on(queue: string, event: JobEvent, handler: EventHandler): void;
+  publish<T>(queue: string, data: T, options?: QueuePublishOptions): Promise<string>;
+  subscribe<T>(queue: string, handler: QueueHandler<T>): Promise<void>;
+  unsubscribe(queue: string): Promise<void>;
+  getQueueSize?(queue: string): Promise<number>;
+  purge?(queue: string): Promise<void>;
+  // Dead-letter queue (db adapter)
+  listFailed?(queue?: string, options?: { limit?: number; offset?: number }): Promise<QueueMessageRecord[]>;
+  replay?(messageId: string): Promise<void>;
+  purgeFailed?(messageId: string): Promise<void>;
 }
 ```
 
+## Best Practices
+
+1. **Idempotent handlers** — messages may be re-delivered after a lease expires.
+2. **Small payloads** — keep message data compact for fast serialization.
+3. **Handle the DLQ** — monitor `listFailed()` and `replay()` poisoned messages.
+4. **Use `db` in production** — `memory` loses in-flight work on restart and does
+   not coordinate across nodes.
+
 ## License
 
 Apache-2.0. See [LICENSING.md](../../../LICENSING.md).
 
 ## See Also
 
-- [BullMQ Documentation](https://docs.bullmq.io/)
-- [@objectstack/spec/contracts](../../spec/src/contracts/)
-- [Queue Patterns Guide](/content/docs/guides/queues/)
+- [@objectstack/spec/contracts](../../spec/src/contracts/queue-service.ts)
+- [@objectstack/trigger-schedule](../../triggers/trigger-schedule) — cron/interval triggers on top of the job service

package/dist/index.cjs

@@ -20,7 +20,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  BullMQQueueAdapter: () => BullMQQueueAdapter,
   DbQueueAdapter: () => DbQueueAdapter,
   MemoryQueueAdapter: () => MemoryQueueAdapter,
   QueueServicePlugin: () => QueueServicePlugin
@@ -451,11 +450,6 @@ var QueueServicePlugin = class {
       ctx.logger.warn("QueueServicePlugin: manifest service unavailable; sys_job_queue not registered", err);
     }
     const choice = this.options.adapter ?? "auto";
-    if (choice === "bullmq") {
-      throw new Error(
-        'BullMQ queue adapter is not yet implemented (M10.43). Use adapter: "auto", "db", or "memory", or provide a custom IQueueService.'
-      );
-    }
     if (choice === "memory") {
       const q = new MemoryQueueAdapter(this.options.memory);
       ctx.registerService("queue", q);
@@ -499,31 +493,8 @@ var QueueServicePlugin = class {
     await this.dbAdapter?.stop();
   }
 };
-
-// src/bullmq-queue-adapter.ts
-var BullMQQueueAdapter = class {
-  constructor(options) {
-    this.redisUrl = options.redisUrl;
-  }
-  async publish(_queue, _data, _options) {
-    throw new Error(`BullMQQueueAdapter not yet implemented (url: ${this.redisUrl})`);
-  }
-  async subscribe(_queue, _handler) {
-    throw new Error("BullMQQueueAdapter not yet implemented");
-  }
-  async unsubscribe(_queue) {
-    throw new Error("BullMQQueueAdapter not yet implemented");
-  }
-  async getQueueSize(_queue) {
-    throw new Error("BullMQQueueAdapter not yet implemented");
-  }
-  async purge(_queue) {
-    throw new Error("BullMQQueueAdapter not yet implemented");
-  }
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  BullMQQueueAdapter,
   DbQueueAdapter,
   MemoryQueueAdapter,
   QueueServicePlugin

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/queue-service-plugin.ts","../src/memory-queue-adapter.ts","../src/common.ts","../src/db-queue-adapter.ts","../src/bullmq-queue-adapter.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { QueueServicePlugin } from './queue-service-plugin.js';\nexport type { QueueServicePluginOptions } from './queue-service-plugin.js';\nexport { MemoryQueueAdapter } from './memory-queue-adapter.js';\nexport type { MemoryQueueAdapterOptions } from './memory-queue-adapter.js';\nexport { BullMQQueueAdapter } from './bullmq-queue-adapter.js';\nexport type { BullMQQueueAdapterOptions } from './bullmq-queue-adapter.js';\nexport { DbQueueAdapter } from './db-queue-adapter.js';\nexport type { DbQueueAdapterOptions } from './db-queue-adapter.js';\nexport type { JobEngine, JobClock, JobLogger } from './common.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { SysJobQueue } from '@objectstack/platform-objects/audit';\nimport { MemoryQueueAdapter } from './memory-queue-adapter.js';\nimport type { MemoryQueueAdapterOptions } from './memory-queue-adapter.js';\nimport { DbQueueAdapter } from './db-queue-adapter.js';\nimport type { DbQueueAdapterOptions } from './db-queue-adapter.js';\n\n/**\n * Configuration options for the QueueServicePlugin.\n */\nexport interface QueueServicePluginOptions {\n  /**\n   * Queue adapter type.\n   *  - 'auto' (default): use DbQueueAdapter when objectql engine available, else MemoryQueueAdapter\n   *  - 'db': require objectql; persists messages, retries, and DLQ to sys_job_queue\n   *  - 'memory': in-process MemoryQueueAdapter (non-durable, dev/test)\n   *  - 'bullmq': reserved for M10.43 (throws today)\n   */\n  adapter?: 'auto' | 'db' | 'memory' | 'bullmq';\n  /** Options for the memory queue adapter */\n  memory?: MemoryQueueAdapterOptions;\n  /** Options for the DB adapter (polling, batch, lease, idempotency window…) */\n  db?: DbQueueAdapterOptions;\n  /** Redis connection URL (reserved for bullmq) */\n  redisUrl?: string;\n}\n\n/**\n * QueueServicePlugin — Production IQueueService implementation.\n *\n * Default: registers MemoryQueueAdapter synchronously so producers can\n * publish during plugin init; upgrades to DbQueueAdapter on `kernel:ready`\n * when an ObjectQL engine is available. Subscribers registered against\n * the (now-replaced) memory queue must re-subscribe after upgrade — for\n * that reason most plugins register subscribers inside their own\n * `kernel:ready` hook, which fires after this one.\n */\nexport class QueueServicePlugin implements Plugin {\n  name = 'com.objectstack.service.queue';\n  version = '1.1.0';\n  type = 'standard';\n\n  private readonly options: QueueServicePluginOptions;\n  private dbAdapter?: DbQueueAdapter;\n\n  constructor(options: QueueServicePluginOptions = {}) {\n    this.options = { adapter: 'auto', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    // Register sys_job_queue (also serves as DLQ view) so Studio can list/replay.\n    try {\n      ctx.getService<{ register(m: any): void }>('manifest').register({\n        id: 'com.objectstack.service.queue',\n        name: 'Queue Service',\n        version: '1.1.0',\n        type: 'plugin',\n        scope: 'system',\n        defaultDatasource: 'cloud',\n        namespace: 'sys',\n        objects: [SysJobQueue],\n      });\n    } catch (err) {\n      ctx.logger.warn('QueueServicePlugin: manifest service unavailable; sys_job_queue not registered', err as any);\n    }\n\n    const choice = this.options.adapter ?? 'auto';\n\n    if (choice === 'bullmq') {\n      throw new Error(\n        'BullMQ queue adapter is not yet implemented (M10.43). ' +\n        'Use adapter: \"auto\", \"db\", or \"memory\", or provide a custom IQueueService.',\n      );\n    }\n\n    if (choice === 'memory') {\n      const q = new MemoryQueueAdapter(this.options.memory);\n      ctx.registerService('queue', q);\n      ctx.logger.info('QueueServicePlugin: registered MemoryQueueAdapter');\n      return;\n    }\n\n    // auto / db — register memory placeholder, upgrade on kernel:ready\n    ctx.registerService('queue', new MemoryQueueAdapter(this.options.memory));\n\n    ctx.hook('kernel:ready', async () => {\n      let engine: any = null;\n      try { engine = ctx.getService<any>('objectql'); }\n      catch { try { engine = ctx.getService<any>('data'); } catch { /* ignore */ } }\n\n      if (!engine) {\n        if (choice === 'db') {\n          ctx.logger.warn('QueueServicePlugin: db adapter requested but no ObjectQL engine — staying on MemoryQueueAdapter');\n        } else {\n          ctx.logger.info('QueueServicePlugin: no ObjectQL engine — staying on MemoryQueueAdapter');\n        }\n        return;\n      }\n\n      this.dbAdapter = new DbQueueAdapter({\n        engine,\n        logger: ctx.logger,\n        options: this.options.db,\n      });\n\n      try {\n        (ctx as any).replaceService?.('queue', this.dbAdapter);\n        this.dbAdapter.start();\n        ctx.logger.info('QueueServicePlugin: upgraded to DbQueueAdapter (sys_job_queue persistence)');\n      } catch (err) {\n        ctx.logger.warn('QueueServicePlugin: replaceService failed; staying on MemoryQueueAdapter', err as any);\n      }\n    });\n  }\n\n  async destroy(): Promise<void> {\n    await this.dbAdapter?.stop();\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IQueueService, QueuePublishOptions, QueueMessage, QueueHandler } from '@objectstack/spec/contracts';\n\n/**\n * Configuration options for MemoryQueueAdapter.\n */\nexport interface MemoryQueueAdapterOptions {\n  /** Maximum number of messages retained per queue (0 = unlimited) */\n  maxQueueSize?: number;\n}\n\n/**\n * In-memory queue adapter implementing IQueueService.\n *\n * Provides synchronous in-process pub/sub delivery.\n * Suitable for single-process environments, development, and testing.\n */\nexport class MemoryQueueAdapter implements IQueueService {\n  private readonly handlers = new Map<string, QueueHandler[]>();\n  private readonly deadLetters: QueueMessage[] = [];\n  private msgCounter = 0;\n  private readonly maxQueueSize: number;\n\n  constructor(options: MemoryQueueAdapterOptions = {}) {\n    this.maxQueueSize = options.maxQueueSize ?? 0;\n  }\n\n  async publish<T = unknown>(queue: string, data: T, options?: QueuePublishOptions): Promise<string> {\n    const id = `msg-${++this.msgCounter}`;\n    const msg: QueueMessage<T> = {\n      id,\n      data,\n      attempts: 0,\n      timestamp: Date.now(),\n    };\n\n    const fns = this.handlers.get(queue) ?? [];\n    if (fns.length === 0) {\n      // No subscribers — retain as dead letter if within limits\n      if (this.maxQueueSize === 0 || this.deadLetters.length < this.maxQueueSize) {\n        this.deadLetters.push(msg);\n      }\n      return id;\n    }\n\n    const maxRetries = options?.retries ?? 0;\n    for (const handler of fns) {\n      let attempt = 0;\n      let success = false;\n      while (!success && attempt <= maxRetries) {\n        try {\n          msg.attempts = attempt + 1;\n          await handler(msg as QueueMessage);\n          success = true;\n        } catch {\n          attempt++;\n        }\n      }\n    }\n\n    return id;\n  }\n\n  async subscribe<T = unknown>(queue: string, handler: QueueHandler<T>): Promise<void> {\n    const existing = this.handlers.get(queue) ?? [];\n    this.handlers.set(queue, [...existing, handler as QueueHandler]);\n  }\n\n  async unsubscribe(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n\n  async getQueueSize(_queue: string): Promise<number> {\n    // In-memory: no persistent queue depth tracking\n    return 0;\n  }\n\n  async purge(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Narrow ObjectQL engine surface used by job/queue adapters.\n * Keeps the adapter testable without booting a real kernel.\n *\n * IMPORTANT: matches the canonical engine API:\n *   - find: `where:` (NOT `filter:`)\n *   - update: `(table, {id, ...patch}, opts)`\n */\nexport interface JobEngine {\n  find(object: string, options?: any): Promise<any[]>;\n  insert(object: string, data: any, options?: any): Promise<any>;\n  update(object: string, idOrData: any, dataOrOptions?: any, options?: any): Promise<any>;\n  delete(object: string, options?: any): Promise<any>;\n}\n\n/** Stamped only in tests to make `now` deterministic. */\nexport interface JobClock { now(): Date }\n\nexport interface JobLogger {\n  info(msg: string, meta?: unknown): void;\n  warn(msg: string, meta?: unknown): void;\n  error?(msg: string, meta?: unknown): void;\n}\n\nexport const SYSTEM_CTX = { isSystem: true, roles: [], permissions: [] } as const;\n\nexport function uid(prefix: string): string {\n  const g: any = globalThis as any;\n  if (g.crypto?.randomUUID) return `${prefix}_${g.crypto.randomUUID()}`;\n  return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function nowIso(clock?: JobClock): string {\n  return (clock?.now() ?? new Date()).toISOString();\n}\n\nexport function parseJson<T = unknown>(raw: unknown, fallback?: T): T | undefined {\n  if (raw == null) return fallback;\n  if (typeof raw === 'string') {\n    try { return JSON.parse(raw) as T; } catch { return fallback; }\n  }\n  if (typeof raw === 'object') return raw as T;\n  return fallback;\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n  IQueueService,\n  QueuePublishOptions,\n  QueueMessage,\n  QueueMessageRecord,\n  QueueHandler,\n} from '@objectstack/spec/contracts';\nimport {\n  SYSTEM_CTX,\n  uid,\n  nowIso,\n  parseJson,\n  type JobEngine,\n  type JobClock,\n  type JobLogger,\n} from './common.js';\n\nconst QUEUE_TABLE = 'sys_job_queue';\n\nexport interface DbQueueAdapterOptions {\n  /** Polling interval for the worker loop (ms, default 1000) */\n  pollIntervalMs?: number;\n  /** Max messages claimed per poll tick (default 10) */\n  batchSize?: number;\n  /** Lease duration before another worker may reclaim (ms, default 30000) */\n  leaseMs?: number;\n  /** Idempotency window — how long the same key blocks re-publish (ms, default 24h) */\n  idempotencyWindowMs?: number;\n  /** Default maxAttempts when publish doesn't specify (default 3) */\n  defaultMaxAttempts?: number;\n  /** Unique identifier for this worker (default: random) */\n  workerId?: string;\n  /** Whether to auto-start the polling worker (default true) */\n  autoStart?: boolean;\n}\n\ninterface RegisteredHandler {\n  queue: string;\n  fn: QueueHandler;\n}\n\n/**\n * DbQueueAdapter — durable, polling, DB-backed IQueueService.\n *\n * Persists every message to `sys_job_queue`. A polling worker leases\n * pending messages (CAS update status pending→running with a lease),\n * invokes registered subscribers, and retries with backoff on failure.\n * Messages that exceed `max_attempts` land in `status='dlq'`.\n *\n * Idempotency: publish suppresses duplicates within a configurable\n * window when `(queue, idempotencyKey)` is non-null.\n *\n * Designed for SQLite and Postgres alike — uses CAS via WHERE-clauses,\n * not row-level locking.\n */\nexport class DbQueueAdapter implements IQueueService {\n  private readonly engine: JobEngine;\n  private readonly logger?: JobLogger;\n  private readonly clock?: JobClock;\n  private readonly opts: Required<Omit<DbQueueAdapterOptions, 'workerId'>> & { workerId: string };\n\n  private readonly handlers = new Map<string, RegisteredHandler[]>();\n  private timer?: ReturnType<typeof setInterval>;\n  private running = false;\n\n  constructor(args: {\n    engine: JobEngine;\n    logger?: JobLogger;\n    clock?: JobClock;\n    options?: DbQueueAdapterOptions;\n  }) {\n    this.engine = args.engine;\n    this.logger = args.logger;\n    this.clock = args.clock;\n    const o = args.options ?? {};\n    this.opts = {\n      pollIntervalMs: o.pollIntervalMs ?? 1000,\n      batchSize: o.batchSize ?? 10,\n      leaseMs: o.leaseMs ?? 30_000,\n      idempotencyWindowMs: o.idempotencyWindowMs ?? 24 * 60 * 60 * 1000,\n      defaultMaxAttempts: o.defaultMaxAttempts ?? 3,\n      autoStart: o.autoStart ?? true,\n      workerId: o.workerId ?? uid('worker'),\n    };\n  }\n\n  // ── IQueueService ────────────────────────────────────────────────\n\n  async publish<T = unknown>(\n    queue: string,\n    data: T,\n    options?: QueuePublishOptions,\n  ): Promise<string> {\n    const opts = options ?? {};\n    const now = this.now();\n\n    // Idempotency check\n    if (opts.idempotencyKey) {\n      const windowStart = new Date(now.getTime() - this.opts.idempotencyWindowMs).toISOString();\n      const existing = await this.engine.find(QUEUE_TABLE, {\n        where: {\n          queue,\n          idempotency_key: opts.idempotencyKey,\n          // Only block if not yet terminal — completed/dlq dedup is by window via created_at\n        },\n        limit: 5,\n        context: SYSTEM_CTX,\n      });\n      const blocking = (existing ?? []).find((row: any) => {\n        if (row.status === 'pending' || row.status === 'running') return true;\n        return String(row.created_at ?? '') >= windowStart;\n      });\n      if (blocking) return String(blocking.id);\n    }\n\n    const id = uid('msg');\n    const scheduledFor = opts.scheduledFor\n      ? new Date(opts.scheduledFor).toISOString()\n      : opts.delay\n        ? new Date(now.getTime() + opts.delay).toISOString()\n        : now.toISOString();\n\n    const maxAttempts = opts.maxAttempts\n      ?? (opts.retries != null ? opts.retries + 1 : this.opts.defaultMaxAttempts);\n    const backoff = opts.backoff ?? { type: 'exponential' as const, delayMs: 1000 };\n\n    await this.engine.insert(QUEUE_TABLE, {\n      id,\n      queue,\n      idempotency_key: opts.idempotencyKey ?? null,\n      payload_json: JSON.stringify(data ?? null),\n      metadata_json: opts.metadata ? JSON.stringify(opts.metadata) : null,\n      status: 'pending',\n      priority: opts.priority ?? 100,\n      attempts: 0,\n      max_attempts: maxAttempts,\n      backoff_type: backoff.type,\n      backoff_delay_ms: backoff.delayMs,\n      backoff_max_delay_ms: backoff.maxDelayMs ?? null,\n      scheduled_for: scheduledFor,\n      created_at: now.toISOString(),\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n\n    return id;\n  }\n\n  async subscribe<T = unknown>(queue: string, handler: QueueHandler<T>): Promise<void> {\n    const existing = this.handlers.get(queue) ?? [];\n    existing.push({ queue, fn: handler as QueueHandler });\n    this.handlers.set(queue, existing);\n    if (this.opts.autoStart) this.start();\n  }\n\n  async unsubscribe(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n\n  async getQueueSize(queue: string): Promise<number> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: 10_000,\n      context: SYSTEM_CTX,\n    });\n    return rows?.length ?? 0;\n  }\n\n  async purge(queue: string): Promise<void> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: 10_000,\n      context: SYSTEM_CTX,\n    });\n    for (const row of rows ?? []) {\n      try { await this.engine.delete(QUEUE_TABLE, { id: row.id, context: SYSTEM_CTX }); }\n      catch (err) { this.logger?.warn?.('DbQueueAdapter: purge delete failed', err as any); }\n    }\n  }\n\n  async listFailed(\n    queue?: string,\n    options?: { limit?: number; offset?: number },\n  ): Promise<QueueMessageRecord[]> {\n    const where: any = { status: 'dlq' };\n    if (queue) where.queue = queue;\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where,\n      limit: options?.limit ?? 100,\n      offset: options?.offset,\n      orderBy: [{ field: 'created_at', order: 'desc' }],\n      context: SYSTEM_CTX,\n    });\n    return (rows ?? []).map((r: any) => this.rowToRecord(r));\n  }\n\n  async replay(messageId: string): Promise<void> {\n    const row = await this.loadById(messageId);\n    if (!row) throw new Error(`MESSAGE_NOT_FOUND: ${messageId}`);\n    if (row.status !== 'dlq' && row.status !== 'failed') {\n      throw new Error(`INVALID_STATE: cannot replay message in status=${row.status}`);\n    }\n    const now = this.now();\n    await this.engine.update(QUEUE_TABLE, {\n      id: messageId,\n      status: 'pending',\n      attempts: 0,\n      last_error: null,\n      locked_by: null,\n      locked_until: null,\n      scheduled_for: now.toISOString(),\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n  }\n\n  async purgeFailed(messageId: string): Promise<void> {\n    const row = await this.loadById(messageId);\n    if (!row) return;\n    if (row.status !== 'dlq' && row.status !== 'failed') {\n      throw new Error(`INVALID_STATE: cannot purge message in status=${row.status}`);\n    }\n    await this.engine.delete(QUEUE_TABLE, { id: messageId, context: SYSTEM_CTX });\n  }\n\n  // ── Worker lifecycle ─────────────────────────────────────────────\n\n  start(): void {\n    if (this.timer) return;\n    this.timer = setInterval(() => {\n      if (this.running) return;\n      this.running = true;\n      this.pollOnce()\n        .catch((err) => { this.logger?.warn?.('DbQueueAdapter: poll tick failed', err); })\n        .finally(() => { this.running = false; });\n    }, this.opts.pollIntervalMs);\n    (this.timer as any)?.unref?.();\n  }\n\n  async stop(): Promise<void> {\n    if (this.timer) { clearInterval(this.timer); this.timer = undefined; }\n  }\n\n  /** Test-friendly synchronous poll. */\n  async pollOnce(): Promise<number> {\n    const queues = [...this.handlers.keys()];\n    if (queues.length === 0) return 0;\n\n    let processed = 0;\n    for (const queue of queues) {\n      const claimed = await this.claimBatch(queue, this.opts.batchSize);\n      for (const row of claimed) {\n        await this.dispatch(row);\n        processed++;\n      }\n    }\n    return processed;\n  }\n\n  // ── Internals ────────────────────────────────────────────────────\n\n  private async claimBatch(queue: string, max: number): Promise<any[]> {\n    const now = this.now();\n    const candidates = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: max * 3, // over-fetch in case of CAS contention\n      orderBy: [\n        { field: 'priority', order: 'asc' },\n        { field: 'scheduled_for', order: 'asc' },\n      ],\n      context: SYSTEM_CTX,\n    });\n\n    const out: any[] = [];\n    for (const row of candidates ?? []) {\n      if (out.length >= max) break;\n      const sched = row.scheduled_for ? new Date(row.scheduled_for).getTime() : 0;\n      if (sched > now.getTime()) continue;\n      // Honor existing lease\n      const lockedUntil = row.locked_until ? new Date(row.locked_until).getTime() : 0;\n      if (row.locked_by && lockedUntil > now.getTime()) continue;\n\n      // CAS — only update if still pending (best-effort with engine.update which\n      // typically does row-level update by id; concurrent workers will overwrite\n      // each other but the dispatcher tolerates duplicate delivery via attempts).\n      try {\n        await this.engine.update(QUEUE_TABLE, {\n          id: row.id,\n          status: 'running',\n          locked_by: this.opts.workerId,\n          locked_until: new Date(now.getTime() + this.opts.leaseMs).toISOString(),\n          updated_at: now.toISOString(),\n        }, { context: SYSTEM_CTX });\n        out.push({ ...row, status: 'running' });\n      } catch (err) {\n        this.logger?.warn?.('DbQueueAdapter: claim CAS failed', err as any);\n      }\n    }\n    return out;\n  }\n\n  private async dispatch(row: any): Promise<void> {\n    const handlers = this.handlers.get(row.queue) ?? [];\n    if (handlers.length === 0) {\n      // No handler — release lease so another process can pick it up\n      await this.releasePending(row.id);\n      return;\n    }\n\n    const msg: QueueMessage = {\n      id: String(row.id),\n      data: parseJson(row.payload_json),\n      attempts: (row.attempts ?? 0) + 1,\n      timestamp: row.created_at ? new Date(row.created_at).getTime() : Date.now(),\n    };\n\n    let success = true;\n    let lastError: string | undefined;\n    for (const h of handlers) {\n      try { await h.fn(msg); }\n      catch (err) {\n        success = false;\n        lastError = err instanceof Error ? err.message : String(err);\n        this.logger?.warn?.(`DbQueueAdapter: handler failed on ${row.queue}`, err as any);\n        break;\n      }\n    }\n\n    const now = this.now();\n    if (success) {\n      await this.engine.update(QUEUE_TABLE, {\n        id: row.id,\n        status: 'completed',\n        attempts: msg.attempts,\n        completed_at: now.toISOString(),\n        locked_by: null,\n        locked_until: null,\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n      return;\n    }\n\n    const attempts = msg.attempts;\n    const max = row.max_attempts ?? this.opts.defaultMaxAttempts;\n    if (attempts >= max) {\n      await this.engine.update(QUEUE_TABLE, {\n        id: row.id,\n        status: 'dlq',\n        attempts,\n        last_error: lastError ?? 'unknown error',\n        completed_at: now.toISOString(),\n        locked_by: null,\n        locked_until: null,\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n      return;\n    }\n\n    const backoffMs = this.computeBackoff(row, attempts);\n    await this.engine.update(QUEUE_TABLE, {\n      id: row.id,\n      status: 'pending',\n      attempts,\n      last_error: lastError ?? 'unknown error',\n      scheduled_for: new Date(now.getTime() + backoffMs).toISOString(),\n      locked_by: null,\n      locked_until: null,\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n  }\n\n  private computeBackoff(row: any, attempt: number): number {\n    const base = row.backoff_delay_ms ?? 1000;\n    const cap = row.backoff_max_delay_ms ?? undefined;\n    if ((row.backoff_type ?? 'exponential') === 'fixed') return base;\n    const exp = base * Math.pow(2, Math.max(0, attempt - 1));\n    return cap ? Math.min(exp, cap) : exp;\n  }\n\n  private async releasePending(id: string): Promise<void> {\n    const now = this.now();\n    try {\n      await this.engine.update(QUEUE_TABLE, {\n        id,\n        status: 'pending',\n        locked_by: null,\n        locked_until: null,\n        scheduled_for: new Date(now.getTime() + this.opts.pollIntervalMs * 5).toISOString(),\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n    } catch (err) {\n      this.logger?.warn?.('DbQueueAdapter: release failed', err as any);\n    }\n  }\n\n  private async loadById(id: string): Promise<any | null> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { id },\n      limit: 1,\n      context: SYSTEM_CTX,\n    });\n    return rows?.[0] ?? null;\n  }\n\n  private rowToRecord(r: any): QueueMessageRecord {\n    return {\n      id: String(r.id),\n      queue: String(r.queue),\n      data: parseJson(r.payload_json),\n      status: r.status,\n      attempts: r.attempts ?? 0,\n      maxAttempts: r.max_attempts ?? this.opts.defaultMaxAttempts,\n      scheduledFor: r.scheduled_for ?? undefined,\n      lockedBy: r.locked_by ?? undefined,\n      lockedUntil: r.locked_until ?? undefined,\n      lastError: r.last_error ?? undefined,\n      idempotencyKey: r.idempotency_key ?? undefined,\n      metadata: parseJson(r.metadata_json),\n      createdAt: r.created_at ?? nowIso(this.clock),\n      updatedAt: r.updated_at ?? undefined,\n      completedAt: r.completed_at ?? undefined,\n    };\n  }\n\n  private now(): Date {\n    return this.clock?.now() ?? new Date();\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IQueueService, QueuePublishOptions, QueueHandler } from '@objectstack/spec/contracts';\n\n/**\n * Configuration for the BullMQ queue adapter.\n */\nexport interface BullMQQueueAdapterOptions {\n  /** Redis connection URL (e.g. 'redis://localhost:6379') */\n  redisUrl: string;\n  /** Default job options */\n  defaultJobOptions?: {\n    /** Number of retry attempts */\n    attempts?: number;\n    /** Backoff strategy */\n    backoff?: { type: 'fixed' | 'exponential'; delay: number };\n  };\n}\n\n/**\n * BullMQ queue adapter skeleton implementing IQueueService.\n *\n * This is a placeholder for future BullMQ integration.\n * Concrete implementation will use the `bullmq` package.\n *\n * @example\n * ```ts\n * const queue = new BullMQQueueAdapter({ redisUrl: 'redis://localhost:6379' });\n * await queue.publish('orders', { orderId: 123 });\n * ```\n */\nexport class BullMQQueueAdapter implements IQueueService {\n  private readonly redisUrl: string;\n\n  constructor(options: BullMQQueueAdapterOptions) {\n    this.redisUrl = options.redisUrl;\n  }\n\n  async publish<T = unknown>(_queue: string, _data: T, _options?: QueuePublishOptions): Promise<string> {\n    throw new Error(`BullMQQueueAdapter not yet implemented (url: ${this.redisUrl})`);\n  }\n\n  async subscribe<T = unknown>(_queue: string, _handler: QueueHandler<T>): Promise<void> {\n    throw new Error('BullMQQueueAdapter not yet implemented');\n  }\n\n  async unsubscribe(_queue: string): Promise<void> {\n    throw new Error('BullMQQueueAdapter not yet implemented');\n  }\n\n  async getQueueSize(_queue: string): Promise<number> {\n    throw new Error('BullMQQueueAdapter not yet implemented');\n  }\n\n  async purge(_queue: string): Promise<void> {\n    throw new Error('BullMQQueueAdapter not yet implemented');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/queue-service-plugin.ts","../src/memory-queue-adapter.ts","../src/common.ts","../src/db-queue-adapter.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nexport { QueueServicePlugin } from './queue-service-plugin.js';\nexport type { QueueServicePluginOptions } from './queue-service-plugin.js';\nexport { MemoryQueueAdapter } from './memory-queue-adapter.js';\nexport type { MemoryQueueAdapterOptions } from './memory-queue-adapter.js';\nexport { DbQueueAdapter } from './db-queue-adapter.js';\nexport type { DbQueueAdapterOptions } from './db-queue-adapter.js';\nexport type { JobEngine, JobClock, JobLogger } from './common.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { SysJobQueue } from '@objectstack/platform-objects/audit';\nimport { MemoryQueueAdapter } from './memory-queue-adapter.js';\nimport type { MemoryQueueAdapterOptions } from './memory-queue-adapter.js';\nimport { DbQueueAdapter } from './db-queue-adapter.js';\nimport type { DbQueueAdapterOptions } from './db-queue-adapter.js';\n\n/**\n * Configuration options for the QueueServicePlugin.\n */\nexport interface QueueServicePluginOptions {\n  /**\n   * Queue adapter type.\n   *  - 'auto' (default): use DbQueueAdapter when objectql engine available, else MemoryQueueAdapter\n   *  - 'db': require objectql; persists messages, retries, and DLQ to sys_job_queue\n   *  - 'memory': in-process MemoryQueueAdapter (non-durable, dev/test)\n   */\n  adapter?: 'auto' | 'db' | 'memory';\n  /** Options for the memory queue adapter */\n  memory?: MemoryQueueAdapterOptions;\n  /** Options for the DB adapter (polling, batch, lease, idempotency window…) */\n  db?: DbQueueAdapterOptions;\n}\n\n/**\n * QueueServicePlugin — Production IQueueService implementation.\n *\n * Default: registers MemoryQueueAdapter synchronously so producers can\n * publish during plugin init; upgrades to DbQueueAdapter on `kernel:ready`\n * when an ObjectQL engine is available. Subscribers registered against\n * the (now-replaced) memory queue must re-subscribe after upgrade — for\n * that reason most plugins register subscribers inside their own\n * `kernel:ready` hook, which fires after this one.\n */\nexport class QueueServicePlugin implements Plugin {\n  name = 'com.objectstack.service.queue';\n  version = '1.1.0';\n  type = 'standard';\n\n  private readonly options: QueueServicePluginOptions;\n  private dbAdapter?: DbQueueAdapter;\n\n  constructor(options: QueueServicePluginOptions = {}) {\n    this.options = { adapter: 'auto', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    // Register sys_job_queue (also serves as DLQ view) so Studio can list/replay.\n    try {\n      ctx.getService<{ register(m: any): void }>('manifest').register({\n        id: 'com.objectstack.service.queue',\n        name: 'Queue Service',\n        version: '1.1.0',\n        type: 'plugin',\n        scope: 'system',\n        defaultDatasource: 'cloud',\n        namespace: 'sys',\n        objects: [SysJobQueue],\n      });\n    } catch (err) {\n      ctx.logger.warn('QueueServicePlugin: manifest service unavailable; sys_job_queue not registered', err as any);\n    }\n\n    const choice = this.options.adapter ?? 'auto';\n\n    if (choice === 'memory') {\n      const q = new MemoryQueueAdapter(this.options.memory);\n      ctx.registerService('queue', q);\n      ctx.logger.info('QueueServicePlugin: registered MemoryQueueAdapter');\n      return;\n    }\n\n    // auto / db — register memory placeholder, upgrade on kernel:ready\n    ctx.registerService('queue', new MemoryQueueAdapter(this.options.memory));\n\n    ctx.hook('kernel:ready', async () => {\n      let engine: any = null;\n      try { engine = ctx.getService<any>('objectql'); }\n      catch { try { engine = ctx.getService<any>('data'); } catch { /* ignore */ } }\n\n      if (!engine) {\n        if (choice === 'db') {\n          ctx.logger.warn('QueueServicePlugin: db adapter requested but no ObjectQL engine — staying on MemoryQueueAdapter');\n        } else {\n          ctx.logger.info('QueueServicePlugin: no ObjectQL engine — staying on MemoryQueueAdapter');\n        }\n        return;\n      }\n\n      this.dbAdapter = new DbQueueAdapter({\n        engine,\n        logger: ctx.logger,\n        options: this.options.db,\n      });\n\n      try {\n        (ctx as any).replaceService?.('queue', this.dbAdapter);\n        this.dbAdapter.start();\n        ctx.logger.info('QueueServicePlugin: upgraded to DbQueueAdapter (sys_job_queue persistence)');\n      } catch (err) {\n        ctx.logger.warn('QueueServicePlugin: replaceService failed; staying on MemoryQueueAdapter', err as any);\n      }\n    });\n  }\n\n  async destroy(): Promise<void> {\n    await this.dbAdapter?.stop();\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IQueueService, QueuePublishOptions, QueueMessage, QueueHandler } from '@objectstack/spec/contracts';\n\n/**\n * Configuration options for MemoryQueueAdapter.\n */\nexport interface MemoryQueueAdapterOptions {\n  /** Maximum number of messages retained per queue (0 = unlimited) */\n  maxQueueSize?: number;\n}\n\n/**\n * In-memory queue adapter implementing IQueueService.\n *\n * Provides synchronous in-process pub/sub delivery.\n * Suitable for single-process environments, development, and testing.\n */\nexport class MemoryQueueAdapter implements IQueueService {\n  private readonly handlers = new Map<string, QueueHandler[]>();\n  private readonly deadLetters: QueueMessage[] = [];\n  private msgCounter = 0;\n  private readonly maxQueueSize: number;\n\n  constructor(options: MemoryQueueAdapterOptions = {}) {\n    this.maxQueueSize = options.maxQueueSize ?? 0;\n  }\n\n  async publish<T = unknown>(queue: string, data: T, options?: QueuePublishOptions): Promise<string> {\n    const id = `msg-${++this.msgCounter}`;\n    const msg: QueueMessage<T> = {\n      id,\n      data,\n      attempts: 0,\n      timestamp: Date.now(),\n    };\n\n    const fns = this.handlers.get(queue) ?? [];\n    if (fns.length === 0) {\n      // No subscribers — retain as dead letter if within limits\n      if (this.maxQueueSize === 0 || this.deadLetters.length < this.maxQueueSize) {\n        this.deadLetters.push(msg);\n      }\n      return id;\n    }\n\n    const maxRetries = options?.retries ?? 0;\n    for (const handler of fns) {\n      let attempt = 0;\n      let success = false;\n      while (!success && attempt <= maxRetries) {\n        try {\n          msg.attempts = attempt + 1;\n          await handler(msg as QueueMessage);\n          success = true;\n        } catch {\n          attempt++;\n        }\n      }\n    }\n\n    return id;\n  }\n\n  async subscribe<T = unknown>(queue: string, handler: QueueHandler<T>): Promise<void> {\n    const existing = this.handlers.get(queue) ?? [];\n    this.handlers.set(queue, [...existing, handler as QueueHandler]);\n  }\n\n  async unsubscribe(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n\n  async getQueueSize(_queue: string): Promise<number> {\n    // In-memory: no persistent queue depth tracking\n    return 0;\n  }\n\n  async purge(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Narrow ObjectQL engine surface used by job/queue adapters.\n * Keeps the adapter testable without booting a real kernel.\n *\n * IMPORTANT: matches the canonical engine API:\n *   - find: `where:` (NOT `filter:`)\n *   - update: `(table, {id, ...patch}, opts)`\n */\nexport interface JobEngine {\n  find(object: string, options?: any): Promise<any[]>;\n  insert(object: string, data: any, options?: any): Promise<any>;\n  update(object: string, idOrData: any, dataOrOptions?: any, options?: any): Promise<any>;\n  delete(object: string, options?: any): Promise<any>;\n}\n\n/** Stamped only in tests to make `now` deterministic. */\nexport interface JobClock { now(): Date }\n\nexport interface JobLogger {\n  info(msg: string, meta?: unknown): void;\n  warn(msg: string, meta?: unknown): void;\n  error?(msg: string, meta?: unknown): void;\n}\n\nexport const SYSTEM_CTX = { isSystem: true, roles: [], permissions: [] } as const;\n\nexport function uid(prefix: string): string {\n  const g: any = globalThis as any;\n  if (g.crypto?.randomUUID) return `${prefix}_${g.crypto.randomUUID()}`;\n  return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function nowIso(clock?: JobClock): string {\n  return (clock?.now() ?? new Date()).toISOString();\n}\n\nexport function parseJson<T = unknown>(raw: unknown, fallback?: T): T | undefined {\n  if (raw == null) return fallback;\n  if (typeof raw === 'string') {\n    try { return JSON.parse(raw) as T; } catch { return fallback; }\n  }\n  if (typeof raw === 'object') return raw as T;\n  return fallback;\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n  IQueueService,\n  QueuePublishOptions,\n  QueueMessage,\n  QueueMessageRecord,\n  QueueHandler,\n} from '@objectstack/spec/contracts';\nimport {\n  SYSTEM_CTX,\n  uid,\n  nowIso,\n  parseJson,\n  type JobEngine,\n  type JobClock,\n  type JobLogger,\n} from './common.js';\n\nconst QUEUE_TABLE = 'sys_job_queue';\n\nexport interface DbQueueAdapterOptions {\n  /** Polling interval for the worker loop (ms, default 1000) */\n  pollIntervalMs?: number;\n  /** Max messages claimed per poll tick (default 10) */\n  batchSize?: number;\n  /** Lease duration before another worker may reclaim (ms, default 30000) */\n  leaseMs?: number;\n  /** Idempotency window — how long the same key blocks re-publish (ms, default 24h) */\n  idempotencyWindowMs?: number;\n  /** Default maxAttempts when publish doesn't specify (default 3) */\n  defaultMaxAttempts?: number;\n  /** Unique identifier for this worker (default: random) */\n  workerId?: string;\n  /** Whether to auto-start the polling worker (default true) */\n  autoStart?: boolean;\n}\n\ninterface RegisteredHandler {\n  queue: string;\n  fn: QueueHandler;\n}\n\n/**\n * DbQueueAdapter — durable, polling, DB-backed IQueueService.\n *\n * Persists every message to `sys_job_queue`. A polling worker leases\n * pending messages (CAS update status pending→running with a lease),\n * invokes registered subscribers, and retries with backoff on failure.\n * Messages that exceed `max_attempts` land in `status='dlq'`.\n *\n * Idempotency: publish suppresses duplicates within a configurable\n * window when `(queue, idempotencyKey)` is non-null.\n *\n * Designed for SQLite and Postgres alike — uses CAS via WHERE-clauses,\n * not row-level locking.\n */\nexport class DbQueueAdapter implements IQueueService {\n  private readonly engine: JobEngine;\n  private readonly logger?: JobLogger;\n  private readonly clock?: JobClock;\n  private readonly opts: Required<Omit<DbQueueAdapterOptions, 'workerId'>> & { workerId: string };\n\n  private readonly handlers = new Map<string, RegisteredHandler[]>();\n  private timer?: ReturnType<typeof setInterval>;\n  private running = false;\n\n  constructor(args: {\n    engine: JobEngine;\n    logger?: JobLogger;\n    clock?: JobClock;\n    options?: DbQueueAdapterOptions;\n  }) {\n    this.engine = args.engine;\n    this.logger = args.logger;\n    this.clock = args.clock;\n    const o = args.options ?? {};\n    this.opts = {\n      pollIntervalMs: o.pollIntervalMs ?? 1000,\n      batchSize: o.batchSize ?? 10,\n      leaseMs: o.leaseMs ?? 30_000,\n      idempotencyWindowMs: o.idempotencyWindowMs ?? 24 * 60 * 60 * 1000,\n      defaultMaxAttempts: o.defaultMaxAttempts ?? 3,\n      autoStart: o.autoStart ?? true,\n      workerId: o.workerId ?? uid('worker'),\n    };\n  }\n\n  // ── IQueueService ────────────────────────────────────────────────\n\n  async publish<T = unknown>(\n    queue: string,\n    data: T,\n    options?: QueuePublishOptions,\n  ): Promise<string> {\n    const opts = options ?? {};\n    const now = this.now();\n\n    // Idempotency check\n    if (opts.idempotencyKey) {\n      const windowStart = new Date(now.getTime() - this.opts.idempotencyWindowMs).toISOString();\n      const existing = await this.engine.find(QUEUE_TABLE, {\n        where: {\n          queue,\n          idempotency_key: opts.idempotencyKey,\n          // Only block if not yet terminal — completed/dlq dedup is by window via created_at\n        },\n        limit: 5,\n        context: SYSTEM_CTX,\n      });\n      const blocking = (existing ?? []).find((row: any) => {\n        if (row.status === 'pending' || row.status === 'running') return true;\n        return String(row.created_at ?? '') >= windowStart;\n      });\n      if (blocking) return String(blocking.id);\n    }\n\n    const id = uid('msg');\n    const scheduledFor = opts.scheduledFor\n      ? new Date(opts.scheduledFor).toISOString()\n      : opts.delay\n        ? new Date(now.getTime() + opts.delay).toISOString()\n        : now.toISOString();\n\n    const maxAttempts = opts.maxAttempts\n      ?? (opts.retries != null ? opts.retries + 1 : this.opts.defaultMaxAttempts);\n    const backoff = opts.backoff ?? { type: 'exponential' as const, delayMs: 1000 };\n\n    await this.engine.insert(QUEUE_TABLE, {\n      id,\n      queue,\n      idempotency_key: opts.idempotencyKey ?? null,\n      payload_json: JSON.stringify(data ?? null),\n      metadata_json: opts.metadata ? JSON.stringify(opts.metadata) : null,\n      status: 'pending',\n      priority: opts.priority ?? 100,\n      attempts: 0,\n      max_attempts: maxAttempts,\n      backoff_type: backoff.type,\n      backoff_delay_ms: backoff.delayMs,\n      backoff_max_delay_ms: backoff.maxDelayMs ?? null,\n      scheduled_for: scheduledFor,\n      created_at: now.toISOString(),\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n\n    return id;\n  }\n\n  async subscribe<T = unknown>(queue: string, handler: QueueHandler<T>): Promise<void> {\n    const existing = this.handlers.get(queue) ?? [];\n    existing.push({ queue, fn: handler as QueueHandler });\n    this.handlers.set(queue, existing);\n    if (this.opts.autoStart) this.start();\n  }\n\n  async unsubscribe(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n\n  async getQueueSize(queue: string): Promise<number> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: 10_000,\n      context: SYSTEM_CTX,\n    });\n    return rows?.length ?? 0;\n  }\n\n  async purge(queue: string): Promise<void> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: 10_000,\n      context: SYSTEM_CTX,\n    });\n    for (const row of rows ?? []) {\n      try { await this.engine.delete(QUEUE_TABLE, { id: row.id, context: SYSTEM_CTX }); }\n      catch (err) { this.logger?.warn?.('DbQueueAdapter: purge delete failed', err as any); }\n    }\n  }\n\n  async listFailed(\n    queue?: string,\n    options?: { limit?: number; offset?: number },\n  ): Promise<QueueMessageRecord[]> {\n    const where: any = { status: 'dlq' };\n    if (queue) where.queue = queue;\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where,\n      limit: options?.limit ?? 100,\n      offset: options?.offset,\n      orderBy: [{ field: 'created_at', order: 'desc' }],\n      context: SYSTEM_CTX,\n    });\n    return (rows ?? []).map((r: any) => this.rowToRecord(r));\n  }\n\n  async replay(messageId: string): Promise<void> {\n    const row = await this.loadById(messageId);\n    if (!row) throw new Error(`MESSAGE_NOT_FOUND: ${messageId}`);\n    if (row.status !== 'dlq' && row.status !== 'failed') {\n      throw new Error(`INVALID_STATE: cannot replay message in status=${row.status}`);\n    }\n    const now = this.now();\n    await this.engine.update(QUEUE_TABLE, {\n      id: messageId,\n      status: 'pending',\n      attempts: 0,\n      last_error: null,\n      locked_by: null,\n      locked_until: null,\n      scheduled_for: now.toISOString(),\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n  }\n\n  async purgeFailed(messageId: string): Promise<void> {\n    const row = await this.loadById(messageId);\n    if (!row) return;\n    if (row.status !== 'dlq' && row.status !== 'failed') {\n      throw new Error(`INVALID_STATE: cannot purge message in status=${row.status}`);\n    }\n    await this.engine.delete(QUEUE_TABLE, { id: messageId, context: SYSTEM_CTX });\n  }\n\n  // ── Worker lifecycle ─────────────────────────────────────────────\n\n  start(): void {\n    if (this.timer) return;\n    this.timer = setInterval(() => {\n      if (this.running) return;\n      this.running = true;\n      this.pollOnce()\n        .catch((err) => { this.logger?.warn?.('DbQueueAdapter: poll tick failed', err); })\n        .finally(() => { this.running = false; });\n    }, this.opts.pollIntervalMs);\n    (this.timer as any)?.unref?.();\n  }\n\n  async stop(): Promise<void> {\n    if (this.timer) { clearInterval(this.timer); this.timer = undefined; }\n  }\n\n  /** Test-friendly synchronous poll. */\n  async pollOnce(): Promise<number> {\n    const queues = [...this.handlers.keys()];\n    if (queues.length === 0) return 0;\n\n    let processed = 0;\n    for (const queue of queues) {\n      const claimed = await this.claimBatch(queue, this.opts.batchSize);\n      for (const row of claimed) {\n        await this.dispatch(row);\n        processed++;\n      }\n    }\n    return processed;\n  }\n\n  // ── Internals ────────────────────────────────────────────────────\n\n  private async claimBatch(queue: string, max: number): Promise<any[]> {\n    const now = this.now();\n    const candidates = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: max * 3, // over-fetch in case of CAS contention\n      orderBy: [\n        { field: 'priority', order: 'asc' },\n        { field: 'scheduled_for', order: 'asc' },\n      ],\n      context: SYSTEM_CTX,\n    });\n\n    const out: any[] = [];\n    for (const row of candidates ?? []) {\n      if (out.length >= max) break;\n      const sched = row.scheduled_for ? new Date(row.scheduled_for).getTime() : 0;\n      if (sched > now.getTime()) continue;\n      // Honor existing lease\n      const lockedUntil = row.locked_until ? new Date(row.locked_until).getTime() : 0;\n      if (row.locked_by && lockedUntil > now.getTime()) continue;\n\n      // CAS — only update if still pending (best-effort with engine.update which\n      // typically does row-level update by id; concurrent workers will overwrite\n      // each other but the dispatcher tolerates duplicate delivery via attempts).\n      try {\n        await this.engine.update(QUEUE_TABLE, {\n          id: row.id,\n          status: 'running',\n          locked_by: this.opts.workerId,\n          locked_until: new Date(now.getTime() + this.opts.leaseMs).toISOString(),\n          updated_at: now.toISOString(),\n        }, { context: SYSTEM_CTX });\n        out.push({ ...row, status: 'running' });\n      } catch (err) {\n        this.logger?.warn?.('DbQueueAdapter: claim CAS failed', err as any);\n      }\n    }\n    return out;\n  }\n\n  private async dispatch(row: any): Promise<void> {\n    const handlers = this.handlers.get(row.queue) ?? [];\n    if (handlers.length === 0) {\n      // No handler — release lease so another process can pick it up\n      await this.releasePending(row.id);\n      return;\n    }\n\n    const msg: QueueMessage = {\n      id: String(row.id),\n      data: parseJson(row.payload_json),\n      attempts: (row.attempts ?? 0) + 1,\n      timestamp: row.created_at ? new Date(row.created_at).getTime() : Date.now(),\n    };\n\n    let success = true;\n    let lastError: string | undefined;\n    for (const h of handlers) {\n      try { await h.fn(msg); }\n      catch (err) {\n        success = false;\n        lastError = err instanceof Error ? err.message : String(err);\n        this.logger?.warn?.(`DbQueueAdapter: handler failed on ${row.queue}`, err as any);\n        break;\n      }\n    }\n\n    const now = this.now();\n    if (success) {\n      await this.engine.update(QUEUE_TABLE, {\n        id: row.id,\n        status: 'completed',\n        attempts: msg.attempts,\n        completed_at: now.toISOString(),\n        locked_by: null,\n        locked_until: null,\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n      return;\n    }\n\n    const attempts = msg.attempts;\n    const max = row.max_attempts ?? this.opts.defaultMaxAttempts;\n    if (attempts >= max) {\n      await this.engine.update(QUEUE_TABLE, {\n        id: row.id,\n        status: 'dlq',\n        attempts,\n        last_error: lastError ?? 'unknown error',\n        completed_at: now.toISOString(),\n        locked_by: null,\n        locked_until: null,\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n      return;\n    }\n\n    const backoffMs = this.computeBackoff(row, attempts);\n    await this.engine.update(QUEUE_TABLE, {\n      id: row.id,\n      status: 'pending',\n      attempts,\n      last_error: lastError ?? 'unknown error',\n      scheduled_for: new Date(now.getTime() + backoffMs).toISOString(),\n      locked_by: null,\n      locked_until: null,\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n  }\n\n  private computeBackoff(row: any, attempt: number): number {\n    const base = row.backoff_delay_ms ?? 1000;\n    const cap = row.backoff_max_delay_ms ?? undefined;\n    if ((row.backoff_type ?? 'exponential') === 'fixed') return base;\n    const exp = base * Math.pow(2, Math.max(0, attempt - 1));\n    return cap ? Math.min(exp, cap) : exp;\n  }\n\n  private async releasePending(id: string): Promise<void> {\n    const now = this.now();\n    try {\n      await this.engine.update(QUEUE_TABLE, {\n        id,\n        status: 'pending',\n        locked_by: null,\n        locked_until: null,\n        scheduled_for: new Date(now.getTime() + this.opts.pollIntervalMs * 5).toISOString(),\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n    } catch (err) {\n      this.logger?.warn?.('DbQueueAdapter: release failed', err as any);\n    }\n  }\n\n  private async loadById(id: string): Promise<any | null> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { id },\n      limit: 1,\n      context: SYSTEM_CTX,\n    });\n    return rows?.[0] ?? null;\n  }\n\n  private rowToRecord(r: any): QueueMessageRecord {\n    return {\n      id: String(r.id),\n      queue: String(r.queue),\n      data: parseJson(r.payload_json),\n      status: r.status,\n      attempts: r.attempts ?? 0,\n      maxAttempts: r.max_attempts ?? this.opts.defaultMaxAttempts,\n      scheduledFor: r.scheduled_for ?? undefined,\n      lockedBy: r.locked_by ?? undefined,\n      lockedUntil: r.locked_until ?? undefined,\n      lastError: r.last_error ?? undefined,\n      idempotencyKey: r.idempotency_key ?? undefined,\n      metadata: parseJson(r.metadata_json),\n      createdAt: r.created_at ?? nowIso(this.clock),\n      updatedAt: r.updated_at ?? undefined,\n      completedAt: r.completed_at ?? undefined,\n    };\n  }\n\n  private now(): Date {\n    return this.clock?.now() ?? new Date();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -128,15 +128,12 @@ interface QueueServicePluginOptions {
      *  - 'auto' (default): use DbQueueAdapter when objectql engine available, else MemoryQueueAdapter
      *  - 'db': require objectql; persists messages, retries, and DLQ to sys_job_queue
      *  - 'memory': in-process MemoryQueueAdapter (non-durable, dev/test)
-     *  - 'bullmq': reserved for M10.43 (throws today)
      */
-    adapter?: 'auto' | 'db' | 'memory' | 'bullmq';
+    adapter?: 'auto' | 'db' | 'memory';
     /** Options for the memory queue adapter */
     memory?: MemoryQueueAdapterOptions;
     /** Options for the DB adapter (polling, batch, lease, idempotency window…) */
     db?: DbQueueAdapterOptions;
-    /** Redis connection URL (reserved for bullmq) */
-    redisUrl?: string;
 }
 /**
  * QueueServicePlugin — Production IQueueService implementation.
@@ -159,43 +156,4 @@ declare class QueueServicePlugin implements Plugin {
     destroy(): Promise<void>;
 }
 
-/**
- * Configuration for the BullMQ queue adapter.
- */
-interface BullMQQueueAdapterOptions {
-    /** Redis connection URL (e.g. 'redis://localhost:6379') */
-    redisUrl: string;
-    /** Default job options */
-    defaultJobOptions?: {
-        /** Number of retry attempts */
-        attempts?: number;
-        /** Backoff strategy */
-        backoff?: {
-            type: 'fixed' | 'exponential';
-            delay: number;
-        };
-    };
-}
-/**
- * BullMQ queue adapter skeleton implementing IQueueService.
- *
- * This is a placeholder for future BullMQ integration.
- * Concrete implementation will use the `bullmq` package.
- *
- * @example
- * ```ts
- * const queue = new BullMQQueueAdapter({ redisUrl: 'redis://localhost:6379' });
- * await queue.publish('orders', { orderId: 123 });
- * ```
- */
-declare class BullMQQueueAdapter implements IQueueService {
-    private readonly redisUrl;
-    constructor(options: BullMQQueueAdapterOptions);
-    publish<T = unknown>(_queue: string, _data: T, _options?: QueuePublishOptions): Promise<string>;
-    subscribe<T = unknown>(_queue: string, _handler: QueueHandler<T>): Promise<void>;
-    unsubscribe(_queue: string): Promise<void>;
-    getQueueSize(_queue: string): Promise<number>;
-    purge(_queue: string): Promise<void>;
-}
-
-export { BullMQQueueAdapter, type BullMQQueueAdapterOptions, DbQueueAdapter, type DbQueueAdapterOptions, type JobClock, type JobEngine, type JobLogger, MemoryQueueAdapter, type MemoryQueueAdapterOptions, QueueServicePlugin, type QueueServicePluginOptions };
+export { DbQueueAdapter, type DbQueueAdapterOptions, type JobClock, type JobEngine, type JobLogger, MemoryQueueAdapter, type MemoryQueueAdapterOptions, QueueServicePlugin, type QueueServicePluginOptions };

package/dist/index.d.ts

@@ -128,15 +128,12 @@ interface QueueServicePluginOptions {
      *  - 'auto' (default): use DbQueueAdapter when objectql engine available, else MemoryQueueAdapter
      *  - 'db': require objectql; persists messages, retries, and DLQ to sys_job_queue
      *  - 'memory': in-process MemoryQueueAdapter (non-durable, dev/test)
-     *  - 'bullmq': reserved for M10.43 (throws today)
      */
-    adapter?: 'auto' | 'db' | 'memory' | 'bullmq';
+    adapter?: 'auto' | 'db' | 'memory';
     /** Options for the memory queue adapter */
     memory?: MemoryQueueAdapterOptions;
     /** Options for the DB adapter (polling, batch, lease, idempotency window…) */
     db?: DbQueueAdapterOptions;
-    /** Redis connection URL (reserved for bullmq) */
-    redisUrl?: string;
 }
 /**
  * QueueServicePlugin — Production IQueueService implementation.
@@ -159,43 +156,4 @@ declare class QueueServicePlugin implements Plugin {
     destroy(): Promise<void>;
 }
 
-/**
- * Configuration for the BullMQ queue adapter.
- */
-interface BullMQQueueAdapterOptions {
-    /** Redis connection URL (e.g. 'redis://localhost:6379') */
-    redisUrl: string;
-    /** Default job options */
-    defaultJobOptions?: {
-        /** Number of retry attempts */
-        attempts?: number;
-        /** Backoff strategy */
-        backoff?: {
-            type: 'fixed' | 'exponential';
-            delay: number;
-        };
-    };
-}
-/**
- * BullMQ queue adapter skeleton implementing IQueueService.
- *
- * This is a placeholder for future BullMQ integration.
- * Concrete implementation will use the `bullmq` package.
- *
- * @example
- * ```ts
- * const queue = new BullMQQueueAdapter({ redisUrl: 'redis://localhost:6379' });
- * await queue.publish('orders', { orderId: 123 });
- * ```
- */
-declare class BullMQQueueAdapter implements IQueueService {
-    private readonly redisUrl;
-    constructor(options: BullMQQueueAdapterOptions);
-    publish<T = unknown>(_queue: string, _data: T, _options?: QueuePublishOptions): Promise<string>;
-    subscribe<T = unknown>(_queue: string, _handler: QueueHandler<T>): Promise<void>;
-    unsubscribe(_queue: string): Promise<void>;
-    getQueueSize(_queue: string): Promise<number>;
-    purge(_queue: string): Promise<void>;
-}
-
-export { BullMQQueueAdapter, type BullMQQueueAdapterOptions, DbQueueAdapter, type DbQueueAdapterOptions, type JobClock, type JobEngine, type JobLogger, MemoryQueueAdapter, type MemoryQueueAdapterOptions, QueueServicePlugin, type QueueServicePluginOptions };
+export { DbQueueAdapter, type DbQueueAdapterOptions, type JobClock, type JobEngine, type JobLogger, MemoryQueueAdapter, type MemoryQueueAdapterOptions, QueueServicePlugin, type QueueServicePluginOptions };

package/dist/index.js

@@ -422,11 +422,6 @@ var QueueServicePlugin = class {
       ctx.logger.warn("QueueServicePlugin: manifest service unavailable; sys_job_queue not registered", err);
     }
     const choice = this.options.adapter ?? "auto";
-    if (choice === "bullmq") {
-      throw new Error(
-        'BullMQ queue adapter is not yet implemented (M10.43). Use adapter: "auto", "db", or "memory", or provide a custom IQueueService.'
-      );
-    }
     if (choice === "memory") {
       const q = new MemoryQueueAdapter(this.options.memory);
       ctx.registerService("queue", q);
@@ -470,30 +465,7 @@ var QueueServicePlugin = class {
     await this.dbAdapter?.stop();
   }
 };
-
-// src/bullmq-queue-adapter.ts
-var BullMQQueueAdapter = class {
-  constructor(options) {
-    this.redisUrl = options.redisUrl;
-  }
-  async publish(_queue, _data, _options) {
-    throw new Error(`BullMQQueueAdapter not yet implemented (url: ${this.redisUrl})`);
-  }
-  async subscribe(_queue, _handler) {
-    throw new Error("BullMQQueueAdapter not yet implemented");
-  }
-  async unsubscribe(_queue) {
-    throw new Error("BullMQQueueAdapter not yet implemented");
-  }
-  async getQueueSize(_queue) {
-    throw new Error("BullMQQueueAdapter not yet implemented");
-  }
-  async purge(_queue) {
-    throw new Error("BullMQQueueAdapter not yet implemented");
-  }
-};
 export {
-  BullMQQueueAdapter,
   DbQueueAdapter,
   MemoryQueueAdapter,
   QueueServicePlugin

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/queue-service-plugin.ts","../src/memory-queue-adapter.ts","../src/common.ts","../src/db-queue-adapter.ts","../src/bullmq-queue-adapter.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { SysJobQueue } from '@objectstack/platform-objects/audit';\nimport { MemoryQueueAdapter } from './memory-queue-adapter.js';\nimport type { MemoryQueueAdapterOptions } from './memory-queue-adapter.js';\nimport { DbQueueAdapter } from './db-queue-adapter.js';\nimport type { DbQueueAdapterOptions } from './db-queue-adapter.js';\n\n/**\n * Configuration options for the QueueServicePlugin.\n */\nexport interface QueueServicePluginOptions {\n  /**\n   * Queue adapter type.\n   *  - 'auto' (default): use DbQueueAdapter when objectql engine available, else MemoryQueueAdapter\n   *  - 'db': require objectql; persists messages, retries, and DLQ to sys_job_queue\n   *  - 'memory': in-process MemoryQueueAdapter (non-durable, dev/test)\n   *  - 'bullmq': reserved for M10.43 (throws today)\n   */\n  adapter?: 'auto' | 'db' | 'memory' | 'bullmq';\n  /** Options for the memory queue adapter */\n  memory?: MemoryQueueAdapterOptions;\n  /** Options for the DB adapter (polling, batch, lease, idempotency window…) */\n  db?: DbQueueAdapterOptions;\n  /** Redis connection URL (reserved for bullmq) */\n  redisUrl?: string;\n}\n\n/**\n * QueueServicePlugin — Production IQueueService implementation.\n *\n * Default: registers MemoryQueueAdapter synchronously so producers can\n * publish during plugin init; upgrades to DbQueueAdapter on `kernel:ready`\n * when an ObjectQL engine is available. Subscribers registered against\n * the (now-replaced) memory queue must re-subscribe after upgrade — for\n * that reason most plugins register subscribers inside their own\n * `kernel:ready` hook, which fires after this one.\n */\nexport class QueueServicePlugin implements Plugin {\n  name = 'com.objectstack.service.queue';\n  version = '1.1.0';\n  type = 'standard';\n\n  private readonly options: QueueServicePluginOptions;\n  private dbAdapter?: DbQueueAdapter;\n\n  constructor(options: QueueServicePluginOptions = {}) {\n    this.options = { adapter: 'auto', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    // Register sys_job_queue (also serves as DLQ view) so Studio can list/replay.\n    try {\n      ctx.getService<{ register(m: any): void }>('manifest').register({\n        id: 'com.objectstack.service.queue',\n        name: 'Queue Service',\n        version: '1.1.0',\n        type: 'plugin',\n        scope: 'system',\n        defaultDatasource: 'cloud',\n        namespace: 'sys',\n        objects: [SysJobQueue],\n      });\n    } catch (err) {\n      ctx.logger.warn('QueueServicePlugin: manifest service unavailable; sys_job_queue not registered', err as any);\n    }\n\n    const choice = this.options.adapter ?? 'auto';\n\n    if (choice === 'bullmq') {\n      throw new Error(\n        'BullMQ queue adapter is not yet implemented (M10.43). ' +\n        'Use adapter: \"auto\", \"db\", or \"memory\", or provide a custom IQueueService.',\n      );\n    }\n\n    if (choice === 'memory') {\n      const q = new MemoryQueueAdapter(this.options.memory);\n      ctx.registerService('queue', q);\n      ctx.logger.info('QueueServicePlugin: registered MemoryQueueAdapter');\n      return;\n    }\n\n    // auto / db — register memory placeholder, upgrade on kernel:ready\n    ctx.registerService('queue', new MemoryQueueAdapter(this.options.memory));\n\n    ctx.hook('kernel:ready', async () => {\n      let engine: any = null;\n      try { engine = ctx.getService<any>('objectql'); }\n      catch { try { engine = ctx.getService<any>('data'); } catch { /* ignore */ } }\n\n      if (!engine) {\n        if (choice === 'db') {\n          ctx.logger.warn('QueueServicePlugin: db adapter requested but no ObjectQL engine — staying on MemoryQueueAdapter');\n        } else {\n          ctx.logger.info('QueueServicePlugin: no ObjectQL engine — staying on MemoryQueueAdapter');\n        }\n        return;\n      }\n\n      this.dbAdapter = new DbQueueAdapter({\n        engine,\n        logger: ctx.logger,\n        options: this.options.db,\n      });\n\n      try {\n        (ctx as any).replaceService?.('queue', this.dbAdapter);\n        this.dbAdapter.start();\n        ctx.logger.info('QueueServicePlugin: upgraded to DbQueueAdapter (sys_job_queue persistence)');\n      } catch (err) {\n        ctx.logger.warn('QueueServicePlugin: replaceService failed; staying on MemoryQueueAdapter', err as any);\n      }\n    });\n  }\n\n  async destroy(): Promise<void> {\n    await this.dbAdapter?.stop();\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IQueueService, QueuePublishOptions, QueueMessage, QueueHandler } from '@objectstack/spec/contracts';\n\n/**\n * Configuration options for MemoryQueueAdapter.\n */\nexport interface MemoryQueueAdapterOptions {\n  /** Maximum number of messages retained per queue (0 = unlimited) */\n  maxQueueSize?: number;\n}\n\n/**\n * In-memory queue adapter implementing IQueueService.\n *\n * Provides synchronous in-process pub/sub delivery.\n * Suitable for single-process environments, development, and testing.\n */\nexport class MemoryQueueAdapter implements IQueueService {\n  private readonly handlers = new Map<string, QueueHandler[]>();\n  private readonly deadLetters: QueueMessage[] = [];\n  private msgCounter = 0;\n  private readonly maxQueueSize: number;\n\n  constructor(options: MemoryQueueAdapterOptions = {}) {\n    this.maxQueueSize = options.maxQueueSize ?? 0;\n  }\n\n  async publish<T = unknown>(queue: string, data: T, options?: QueuePublishOptions): Promise<string> {\n    const id = `msg-${++this.msgCounter}`;\n    const msg: QueueMessage<T> = {\n      id,\n      data,\n      attempts: 0,\n      timestamp: Date.now(),\n    };\n\n    const fns = this.handlers.get(queue) ?? [];\n    if (fns.length === 0) {\n      // No subscribers — retain as dead letter if within limits\n      if (this.maxQueueSize === 0 || this.deadLetters.length < this.maxQueueSize) {\n        this.deadLetters.push(msg);\n      }\n      return id;\n    }\n\n    const maxRetries = options?.retries ?? 0;\n    for (const handler of fns) {\n      let attempt = 0;\n      let success = false;\n      while (!success && attempt <= maxRetries) {\n        try {\n          msg.attempts = attempt + 1;\n          await handler(msg as QueueMessage);\n          success = true;\n        } catch {\n          attempt++;\n        }\n      }\n    }\n\n    return id;\n  }\n\n  async subscribe<T = unknown>(queue: string, handler: QueueHandler<T>): Promise<void> {\n    const existing = this.handlers.get(queue) ?? [];\n    this.handlers.set(queue, [...existing, handler as QueueHandler]);\n  }\n\n  async unsubscribe(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n\n  async getQueueSize(_queue: string): Promise<number> {\n    // In-memory: no persistent queue depth tracking\n    return 0;\n  }\n\n  async purge(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Narrow ObjectQL engine surface used by job/queue adapters.\n * Keeps the adapter testable without booting a real kernel.\n *\n * IMPORTANT: matches the canonical engine API:\n *   - find: `where:` (NOT `filter:`)\n *   - update: `(table, {id, ...patch}, opts)`\n */\nexport interface JobEngine {\n  find(object: string, options?: any): Promise<any[]>;\n  insert(object: string, data: any, options?: any): Promise<any>;\n  update(object: string, idOrData: any, dataOrOptions?: any, options?: any): Promise<any>;\n  delete(object: string, options?: any): Promise<any>;\n}\n\n/** Stamped only in tests to make `now` deterministic. */\nexport interface JobClock { now(): Date }\n\nexport interface JobLogger {\n  info(msg: string, meta?: unknown): void;\n  warn(msg: string, meta?: unknown): void;\n  error?(msg: string, meta?: unknown): void;\n}\n\nexport const SYSTEM_CTX = { isSystem: true, roles: [], permissions: [] } as const;\n\nexport function uid(prefix: string): string {\n  const g: any = globalThis as any;\n  if (g.crypto?.randomUUID) return `${prefix}_${g.crypto.randomUUID()}`;\n  return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function nowIso(clock?: JobClock): string {\n  return (clock?.now() ?? new Date()).toISOString();\n}\n\nexport function parseJson<T = unknown>(raw: unknown, fallback?: T): T | undefined {\n  if (raw == null) return fallback;\n  if (typeof raw === 'string') {\n    try { return JSON.parse(raw) as T; } catch { return fallback; }\n  }\n  if (typeof raw === 'object') return raw as T;\n  return fallback;\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n  IQueueService,\n  QueuePublishOptions,\n  QueueMessage,\n  QueueMessageRecord,\n  QueueHandler,\n} from '@objectstack/spec/contracts';\nimport {\n  SYSTEM_CTX,\n  uid,\n  nowIso,\n  parseJson,\n  type JobEngine,\n  type JobClock,\n  type JobLogger,\n} from './common.js';\n\nconst QUEUE_TABLE = 'sys_job_queue';\n\nexport interface DbQueueAdapterOptions {\n  /** Polling interval for the worker loop (ms, default 1000) */\n  pollIntervalMs?: number;\n  /** Max messages claimed per poll tick (default 10) */\n  batchSize?: number;\n  /** Lease duration before another worker may reclaim (ms, default 30000) */\n  leaseMs?: number;\n  /** Idempotency window — how long the same key blocks re-publish (ms, default 24h) */\n  idempotencyWindowMs?: number;\n  /** Default maxAttempts when publish doesn't specify (default 3) */\n  defaultMaxAttempts?: number;\n  /** Unique identifier for this worker (default: random) */\n  workerId?: string;\n  /** Whether to auto-start the polling worker (default true) */\n  autoStart?: boolean;\n}\n\ninterface RegisteredHandler {\n  queue: string;\n  fn: QueueHandler;\n}\n\n/**\n * DbQueueAdapter — durable, polling, DB-backed IQueueService.\n *\n * Persists every message to `sys_job_queue`. A polling worker leases\n * pending messages (CAS update status pending→running with a lease),\n * invokes registered subscribers, and retries with backoff on failure.\n * Messages that exceed `max_attempts` land in `status='dlq'`.\n *\n * Idempotency: publish suppresses duplicates within a configurable\n * window when `(queue, idempotencyKey)` is non-null.\n *\n * Designed for SQLite and Postgres alike — uses CAS via WHERE-clauses,\n * not row-level locking.\n */\nexport class DbQueueAdapter implements IQueueService {\n  private readonly engine: JobEngine;\n  private readonly logger?: JobLogger;\n  private readonly clock?: JobClock;\n  private readonly opts: Required<Omit<DbQueueAdapterOptions, 'workerId'>> & { workerId: string };\n\n  private readonly handlers = new Map<string, RegisteredHandler[]>();\n  private timer?: ReturnType<typeof setInterval>;\n  private running = false;\n\n  constructor(args: {\n    engine: JobEngine;\n    logger?: JobLogger;\n    clock?: JobClock;\n    options?: DbQueueAdapterOptions;\n  }) {\n    this.engine = args.engine;\n    this.logger = args.logger;\n    this.clock = args.clock;\n    const o = args.options ?? {};\n    this.opts = {\n      pollIntervalMs: o.pollIntervalMs ?? 1000,\n      batchSize: o.batchSize ?? 10,\n      leaseMs: o.leaseMs ?? 30_000,\n      idempotencyWindowMs: o.idempotencyWindowMs ?? 24 * 60 * 60 * 1000,\n      defaultMaxAttempts: o.defaultMaxAttempts ?? 3,\n      autoStart: o.autoStart ?? true,\n      workerId: o.workerId ?? uid('worker'),\n    };\n  }\n\n  // ── IQueueService ────────────────────────────────────────────────\n\n  async publish<T = unknown>(\n    queue: string,\n    data: T,\n    options?: QueuePublishOptions,\n  ): Promise<string> {\n    const opts = options ?? {};\n    const now = this.now();\n\n    // Idempotency check\n    if (opts.idempotencyKey) {\n      const windowStart = new Date(now.getTime() - this.opts.idempotencyWindowMs).toISOString();\n      const existing = await this.engine.find(QUEUE_TABLE, {\n        where: {\n          queue,\n          idempotency_key: opts.idempotencyKey,\n          // Only block if not yet terminal — completed/dlq dedup is by window via created_at\n        },\n        limit: 5,\n        context: SYSTEM_CTX,\n      });\n      const blocking = (existing ?? []).find((row: any) => {\n        if (row.status === 'pending' || row.status === 'running') return true;\n        return String(row.created_at ?? '') >= windowStart;\n      });\n      if (blocking) return String(blocking.id);\n    }\n\n    const id = uid('msg');\n    const scheduledFor = opts.scheduledFor\n      ? new Date(opts.scheduledFor).toISOString()\n      : opts.delay\n        ? new Date(now.getTime() + opts.delay).toISOString()\n        : now.toISOString();\n\n    const maxAttempts = opts.maxAttempts\n      ?? (opts.retries != null ? opts.retries + 1 : this.opts.defaultMaxAttempts);\n    const backoff = opts.backoff ?? { type: 'exponential' as const, delayMs: 1000 };\n\n    await this.engine.insert(QUEUE_TABLE, {\n      id,\n      queue,\n      idempotency_key: opts.idempotencyKey ?? null,\n      payload_json: JSON.stringify(data ?? null),\n      metadata_json: opts.metadata ? JSON.stringify(opts.metadata) : null,\n      status: 'pending',\n      priority: opts.priority ?? 100,\n      attempts: 0,\n      max_attempts: maxAttempts,\n      backoff_type: backoff.type,\n      backoff_delay_ms: backoff.delayMs,\n      backoff_max_delay_ms: backoff.maxDelayMs ?? null,\n      scheduled_for: scheduledFor,\n      created_at: now.toISOString(),\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n\n    return id;\n  }\n\n  async subscribe<T = unknown>(queue: string, handler: QueueHandler<T>): Promise<void> {\n    const existing = this.handlers.get(queue) ?? [];\n    existing.push({ queue, fn: handler as QueueHandler });\n    this.handlers.set(queue, existing);\n    if (this.opts.autoStart) this.start();\n  }\n\n  async unsubscribe(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n\n  async getQueueSize(queue: string): Promise<number> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: 10_000,\n      context: SYSTEM_CTX,\n    });\n    return rows?.length ?? 0;\n  }\n\n  async purge(queue: string): Promise<void> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: 10_000,\n      context: SYSTEM_CTX,\n    });\n    for (const row of rows ?? []) {\n      try { await this.engine.delete(QUEUE_TABLE, { id: row.id, context: SYSTEM_CTX }); }\n      catch (err) { this.logger?.warn?.('DbQueueAdapter: purge delete failed', err as any); }\n    }\n  }\n\n  async listFailed(\n    queue?: string,\n    options?: { limit?: number; offset?: number },\n  ): Promise<QueueMessageRecord[]> {\n    const where: any = { status: 'dlq' };\n    if (queue) where.queue = queue;\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where,\n      limit: options?.limit ?? 100,\n      offset: options?.offset,\n      orderBy: [{ field: 'created_at', order: 'desc' }],\n      context: SYSTEM_CTX,\n    });\n    return (rows ?? []).map((r: any) => this.rowToRecord(r));\n  }\n\n  async replay(messageId: string): Promise<void> {\n    const row = await this.loadById(messageId);\n    if (!row) throw new Error(`MESSAGE_NOT_FOUND: ${messageId}`);\n    if (row.status !== 'dlq' && row.status !== 'failed') {\n      throw new Error(`INVALID_STATE: cannot replay message in status=${row.status}`);\n    }\n    const now = this.now();\n    await this.engine.update(QUEUE_TABLE, {\n      id: messageId,\n      status: 'pending',\n      attempts: 0,\n      last_error: null,\n      locked_by: null,\n      locked_until: null,\n      scheduled_for: now.toISOString(),\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n  }\n\n  async purgeFailed(messageId: string): Promise<void> {\n    const row = await this.loadById(messageId);\n    if (!row) return;\n    if (row.status !== 'dlq' && row.status !== 'failed') {\n      throw new Error(`INVALID_STATE: cannot purge message in status=${row.status}`);\n    }\n    await this.engine.delete(QUEUE_TABLE, { id: messageId, context: SYSTEM_CTX });\n  }\n\n  // ── Worker lifecycle ─────────────────────────────────────────────\n\n  start(): void {\n    if (this.timer) return;\n    this.timer = setInterval(() => {\n      if (this.running) return;\n      this.running = true;\n      this.pollOnce()\n        .catch((err) => { this.logger?.warn?.('DbQueueAdapter: poll tick failed', err); })\n        .finally(() => { this.running = false; });\n    }, this.opts.pollIntervalMs);\n    (this.timer as any)?.unref?.();\n  }\n\n  async stop(): Promise<void> {\n    if (this.timer) { clearInterval(this.timer); this.timer = undefined; }\n  }\n\n  /** Test-friendly synchronous poll. */\n  async pollOnce(): Promise<number> {\n    const queues = [...this.handlers.keys()];\n    if (queues.length === 0) return 0;\n\n    let processed = 0;\n    for (const queue of queues) {\n      const claimed = await this.claimBatch(queue, this.opts.batchSize);\n      for (const row of claimed) {\n        await this.dispatch(row);\n        processed++;\n      }\n    }\n    return processed;\n  }\n\n  // ── Internals ────────────────────────────────────────────────────\n\n  private async claimBatch(queue: string, max: number): Promise<any[]> {\n    const now = this.now();\n    const candidates = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: max * 3, // over-fetch in case of CAS contention\n      orderBy: [\n        { field: 'priority', order: 'asc' },\n        { field: 'scheduled_for', order: 'asc' },\n      ],\n      context: SYSTEM_CTX,\n    });\n\n    const out: any[] = [];\n    for (const row of candidates ?? []) {\n      if (out.length >= max) break;\n      const sched = row.scheduled_for ? new Date(row.scheduled_for).getTime() : 0;\n      if (sched > now.getTime()) continue;\n      // Honor existing lease\n      const lockedUntil = row.locked_until ? new Date(row.locked_until).getTime() : 0;\n      if (row.locked_by && lockedUntil > now.getTime()) continue;\n\n      // CAS — only update if still pending (best-effort with engine.update which\n      // typically does row-level update by id; concurrent workers will overwrite\n      // each other but the dispatcher tolerates duplicate delivery via attempts).\n      try {\n        await this.engine.update(QUEUE_TABLE, {\n          id: row.id,\n          status: 'running',\n          locked_by: this.opts.workerId,\n          locked_until: new Date(now.getTime() + this.opts.leaseMs).toISOString(),\n          updated_at: now.toISOString(),\n        }, { context: SYSTEM_CTX });\n        out.push({ ...row, status: 'running' });\n      } catch (err) {\n        this.logger?.warn?.('DbQueueAdapter: claim CAS failed', err as any);\n      }\n    }\n    return out;\n  }\n\n  private async dispatch(row: any): Promise<void> {\n    const handlers = this.handlers.get(row.queue) ?? [];\n    if (handlers.length === 0) {\n      // No handler — release lease so another process can pick it up\n      await this.releasePending(row.id);\n      return;\n    }\n\n    const msg: QueueMessage = {\n      id: String(row.id),\n      data: parseJson(row.payload_json),\n      attempts: (row.attempts ?? 0) + 1,\n      timestamp: row.created_at ? new Date(row.created_at).getTime() : Date.now(),\n    };\n\n    let success = true;\n    let lastError: string | undefined;\n    for (const h of handlers) {\n      try { await h.fn(msg); }\n      catch (err) {\n        success = false;\n        lastError = err instanceof Error ? err.message : String(err);\n        this.logger?.warn?.(`DbQueueAdapter: handler failed on ${row.queue}`, err as any);\n        break;\n      }\n    }\n\n    const now = this.now();\n    if (success) {\n      await this.engine.update(QUEUE_TABLE, {\n        id: row.id,\n        status: 'completed',\n        attempts: msg.attempts,\n        completed_at: now.toISOString(),\n        locked_by: null,\n        locked_until: null,\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n      return;\n    }\n\n    const attempts = msg.attempts;\n    const max = row.max_attempts ?? this.opts.defaultMaxAttempts;\n    if (attempts >= max) {\n      await this.engine.update(QUEUE_TABLE, {\n        id: row.id,\n        status: 'dlq',\n        attempts,\n        last_error: lastError ?? 'unknown error',\n        completed_at: now.toISOString(),\n        locked_by: null,\n        locked_until: null,\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n      return;\n    }\n\n    const backoffMs = this.computeBackoff(row, attempts);\n    await this.engine.update(QUEUE_TABLE, {\n      id: row.id,\n      status: 'pending',\n      attempts,\n      last_error: lastError ?? 'unknown error',\n      scheduled_for: new Date(now.getTime() + backoffMs).toISOString(),\n      locked_by: null,\n      locked_until: null,\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n  }\n\n  private computeBackoff(row: any, attempt: number): number {\n    const base = row.backoff_delay_ms ?? 1000;\n    const cap = row.backoff_max_delay_ms ?? undefined;\n    if ((row.backoff_type ?? 'exponential') === 'fixed') return base;\n    const exp = base * Math.pow(2, Math.max(0, attempt - 1));\n    return cap ? Math.min(exp, cap) : exp;\n  }\n\n  private async releasePending(id: string): Promise<void> {\n    const now = this.now();\n    try {\n      await this.engine.update(QUEUE_TABLE, {\n        id,\n        status: 'pending',\n        locked_by: null,\n        locked_until: null,\n        scheduled_for: new Date(now.getTime() + this.opts.pollIntervalMs * 5).toISOString(),\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n    } catch (err) {\n      this.logger?.warn?.('DbQueueAdapter: release failed', err as any);\n    }\n  }\n\n  private async loadById(id: string): Promise<any | null> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { id },\n      limit: 1,\n      context: SYSTEM_CTX,\n    });\n    return rows?.[0] ?? null;\n  }\n\n  private rowToRecord(r: any): QueueMessageRecord {\n    return {\n      id: String(r.id),\n      queue: String(r.queue),\n      data: parseJson(r.payload_json),\n      status: r.status,\n      attempts: r.attempts ?? 0,\n      maxAttempts: r.max_attempts ?? this.opts.defaultMaxAttempts,\n      scheduledFor: r.scheduled_for ?? undefined,\n      lockedBy: r.locked_by ?? undefined,\n      lockedUntil: r.locked_until ?? undefined,\n      lastError: r.last_error ?? undefined,\n      idempotencyKey: r.idempotency_key ?? undefined,\n      metadata: parseJson(r.metadata_json),\n      createdAt: r.created_at ?? nowIso(this.clock),\n      updatedAt: r.updated_at ?? undefined,\n      completedAt: r.completed_at ?? undefined,\n    };\n  }\n\n  private now(): Date {\n    return this.clock?.now() ?? new Date();\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IQueueService, QueuePublishOptions, QueueHandler } from '@objectstack/spec/contracts';\n\n/**\n * Configuration for the BullMQ queue adapter.\n */\nexport interface BullMQQueueAdapterOptions {\n  /** Redis connection URL (e.g. 'redis://localhost:6379') */\n  redisUrl: string;\n  /** Default job options */\n  defaultJobOptions?: {\n    /** Number of retry attempts */\n    attempts?: number;\n    /** Backoff strategy */\n    backoff?: { type: 'fixed' | 'exponential'; delay: number };\n  };\n}\n\n/**\n * BullMQ queue adapter skeleton implementing IQueueService.\n *\n * This is a placeholder for future BullMQ integration.\n * Concrete implementation will use the `bullmq` package.\n *\n * @example\n * ```ts\n * const queue = new BullMQQueueAdapter({ redisUrl: 'redis://localhost:6379' });\n * await queue.publish('orders', { orderId: 123 });\n * ```\n */\nexport class BullMQQueueAdapter implements IQueueService {\n  private readonly redisUrl: string;\n\n  constructor(options: BullMQQueueAdapterOptions) {\n    this.redisUrl = options.redisUrl;\n  }\n\n  async publish<T = unknown>(_queue: string, _data: T, _options?: QueuePublishOptions): Promise<string> {\n    throw new Error(`BullMQQueueAdapter not yet implemented (url: ${this.redisUrl})`);\n  }\n\n  async subscribe<T = unknown>(_queue: string, _handler: QueueHandler<T>): Promise<void> {\n    throw new Error('BullMQQueueAdapter not yet implemented');\n  }\n\n  async unsubscribe(_queue: string): Promise<void> {\n    throw new Error('BullMQQueueAdapter not yet implemented');\n  }\n\n  async getQueueSize(_queue: string): Promise<number> {\n    throw new Error('BullMQQueueAdapter not yet implemented');\n  }\n\n  async purge(_queue: string): Promise<void> {\n    throw new Error('BullMQQueueAdapter not yet implemented');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/queue-service-plugin.ts","../src/memory-queue-adapter.ts","../src/common.ts","../src/db-queue-adapter.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport { SysJobQueue } from '@objectstack/platform-objects/audit';\nimport { MemoryQueueAdapter } from './memory-queue-adapter.js';\nimport type { MemoryQueueAdapterOptions } from './memory-queue-adapter.js';\nimport { DbQueueAdapter } from './db-queue-adapter.js';\nimport type { DbQueueAdapterOptions } from './db-queue-adapter.js';\n\n/**\n * Configuration options for the QueueServicePlugin.\n */\nexport interface QueueServicePluginOptions {\n  /**\n   * Queue adapter type.\n   *  - 'auto' (default): use DbQueueAdapter when objectql engine available, else MemoryQueueAdapter\n   *  - 'db': require objectql; persists messages, retries, and DLQ to sys_job_queue\n   *  - 'memory': in-process MemoryQueueAdapter (non-durable, dev/test)\n   */\n  adapter?: 'auto' | 'db' | 'memory';\n  /** Options for the memory queue adapter */\n  memory?: MemoryQueueAdapterOptions;\n  /** Options for the DB adapter (polling, batch, lease, idempotency window…) */\n  db?: DbQueueAdapterOptions;\n}\n\n/**\n * QueueServicePlugin — Production IQueueService implementation.\n *\n * Default: registers MemoryQueueAdapter synchronously so producers can\n * publish during plugin init; upgrades to DbQueueAdapter on `kernel:ready`\n * when an ObjectQL engine is available. Subscribers registered against\n * the (now-replaced) memory queue must re-subscribe after upgrade — for\n * that reason most plugins register subscribers inside their own\n * `kernel:ready` hook, which fires after this one.\n */\nexport class QueueServicePlugin implements Plugin {\n  name = 'com.objectstack.service.queue';\n  version = '1.1.0';\n  type = 'standard';\n\n  private readonly options: QueueServicePluginOptions;\n  private dbAdapter?: DbQueueAdapter;\n\n  constructor(options: QueueServicePluginOptions = {}) {\n    this.options = { adapter: 'auto', ...options };\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    // Register sys_job_queue (also serves as DLQ view) so Studio can list/replay.\n    try {\n      ctx.getService<{ register(m: any): void }>('manifest').register({\n        id: 'com.objectstack.service.queue',\n        name: 'Queue Service',\n        version: '1.1.0',\n        type: 'plugin',\n        scope: 'system',\n        defaultDatasource: 'cloud',\n        namespace: 'sys',\n        objects: [SysJobQueue],\n      });\n    } catch (err) {\n      ctx.logger.warn('QueueServicePlugin: manifest service unavailable; sys_job_queue not registered', err as any);\n    }\n\n    const choice = this.options.adapter ?? 'auto';\n\n    if (choice === 'memory') {\n      const q = new MemoryQueueAdapter(this.options.memory);\n      ctx.registerService('queue', q);\n      ctx.logger.info('QueueServicePlugin: registered MemoryQueueAdapter');\n      return;\n    }\n\n    // auto / db — register memory placeholder, upgrade on kernel:ready\n    ctx.registerService('queue', new MemoryQueueAdapter(this.options.memory));\n\n    ctx.hook('kernel:ready', async () => {\n      let engine: any = null;\n      try { engine = ctx.getService<any>('objectql'); }\n      catch { try { engine = ctx.getService<any>('data'); } catch { /* ignore */ } }\n\n      if (!engine) {\n        if (choice === 'db') {\n          ctx.logger.warn('QueueServicePlugin: db adapter requested but no ObjectQL engine — staying on MemoryQueueAdapter');\n        } else {\n          ctx.logger.info('QueueServicePlugin: no ObjectQL engine — staying on MemoryQueueAdapter');\n        }\n        return;\n      }\n\n      this.dbAdapter = new DbQueueAdapter({\n        engine,\n        logger: ctx.logger,\n        options: this.options.db,\n      });\n\n      try {\n        (ctx as any).replaceService?.('queue', this.dbAdapter);\n        this.dbAdapter.start();\n        ctx.logger.info('QueueServicePlugin: upgraded to DbQueueAdapter (sys_job_queue persistence)');\n      } catch (err) {\n        ctx.logger.warn('QueueServicePlugin: replaceService failed; staying on MemoryQueueAdapter', err as any);\n      }\n    });\n  }\n\n  async destroy(): Promise<void> {\n    await this.dbAdapter?.stop();\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { IQueueService, QueuePublishOptions, QueueMessage, QueueHandler } from '@objectstack/spec/contracts';\n\n/**\n * Configuration options for MemoryQueueAdapter.\n */\nexport interface MemoryQueueAdapterOptions {\n  /** Maximum number of messages retained per queue (0 = unlimited) */\n  maxQueueSize?: number;\n}\n\n/**\n * In-memory queue adapter implementing IQueueService.\n *\n * Provides synchronous in-process pub/sub delivery.\n * Suitable for single-process environments, development, and testing.\n */\nexport class MemoryQueueAdapter implements IQueueService {\n  private readonly handlers = new Map<string, QueueHandler[]>();\n  private readonly deadLetters: QueueMessage[] = [];\n  private msgCounter = 0;\n  private readonly maxQueueSize: number;\n\n  constructor(options: MemoryQueueAdapterOptions = {}) {\n    this.maxQueueSize = options.maxQueueSize ?? 0;\n  }\n\n  async publish<T = unknown>(queue: string, data: T, options?: QueuePublishOptions): Promise<string> {\n    const id = `msg-${++this.msgCounter}`;\n    const msg: QueueMessage<T> = {\n      id,\n      data,\n      attempts: 0,\n      timestamp: Date.now(),\n    };\n\n    const fns = this.handlers.get(queue) ?? [];\n    if (fns.length === 0) {\n      // No subscribers — retain as dead letter if within limits\n      if (this.maxQueueSize === 0 || this.deadLetters.length < this.maxQueueSize) {\n        this.deadLetters.push(msg);\n      }\n      return id;\n    }\n\n    const maxRetries = options?.retries ?? 0;\n    for (const handler of fns) {\n      let attempt = 0;\n      let success = false;\n      while (!success && attempt <= maxRetries) {\n        try {\n          msg.attempts = attempt + 1;\n          await handler(msg as QueueMessage);\n          success = true;\n        } catch {\n          attempt++;\n        }\n      }\n    }\n\n    return id;\n  }\n\n  async subscribe<T = unknown>(queue: string, handler: QueueHandler<T>): Promise<void> {\n    const existing = this.handlers.get(queue) ?? [];\n    this.handlers.set(queue, [...existing, handler as QueueHandler]);\n  }\n\n  async unsubscribe(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n\n  async getQueueSize(_queue: string): Promise<number> {\n    // In-memory: no persistent queue depth tracking\n    return 0;\n  }\n\n  async purge(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * Narrow ObjectQL engine surface used by job/queue adapters.\n * Keeps the adapter testable without booting a real kernel.\n *\n * IMPORTANT: matches the canonical engine API:\n *   - find: `where:` (NOT `filter:`)\n *   - update: `(table, {id, ...patch}, opts)`\n */\nexport interface JobEngine {\n  find(object: string, options?: any): Promise<any[]>;\n  insert(object: string, data: any, options?: any): Promise<any>;\n  update(object: string, idOrData: any, dataOrOptions?: any, options?: any): Promise<any>;\n  delete(object: string, options?: any): Promise<any>;\n}\n\n/** Stamped only in tests to make `now` deterministic. */\nexport interface JobClock { now(): Date }\n\nexport interface JobLogger {\n  info(msg: string, meta?: unknown): void;\n  warn(msg: string, meta?: unknown): void;\n  error?(msg: string, meta?: unknown): void;\n}\n\nexport const SYSTEM_CTX = { isSystem: true, roles: [], permissions: [] } as const;\n\nexport function uid(prefix: string): string {\n  const g: any = globalThis as any;\n  if (g.crypto?.randomUUID) return `${prefix}_${g.crypto.randomUUID()}`;\n  return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;\n}\n\nexport function nowIso(clock?: JobClock): string {\n  return (clock?.now() ?? new Date()).toISOString();\n}\n\nexport function parseJson<T = unknown>(raw: unknown, fallback?: T): T | undefined {\n  if (raw == null) return fallback;\n  if (typeof raw === 'string') {\n    try { return JSON.parse(raw) as T; } catch { return fallback; }\n  }\n  if (typeof raw === 'object') return raw as T;\n  return fallback;\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type {\n  IQueueService,\n  QueuePublishOptions,\n  QueueMessage,\n  QueueMessageRecord,\n  QueueHandler,\n} from '@objectstack/spec/contracts';\nimport {\n  SYSTEM_CTX,\n  uid,\n  nowIso,\n  parseJson,\n  type JobEngine,\n  type JobClock,\n  type JobLogger,\n} from './common.js';\n\nconst QUEUE_TABLE = 'sys_job_queue';\n\nexport interface DbQueueAdapterOptions {\n  /** Polling interval for the worker loop (ms, default 1000) */\n  pollIntervalMs?: number;\n  /** Max messages claimed per poll tick (default 10) */\n  batchSize?: number;\n  /** Lease duration before another worker may reclaim (ms, default 30000) */\n  leaseMs?: number;\n  /** Idempotency window — how long the same key blocks re-publish (ms, default 24h) */\n  idempotencyWindowMs?: number;\n  /** Default maxAttempts when publish doesn't specify (default 3) */\n  defaultMaxAttempts?: number;\n  /** Unique identifier for this worker (default: random) */\n  workerId?: string;\n  /** Whether to auto-start the polling worker (default true) */\n  autoStart?: boolean;\n}\n\ninterface RegisteredHandler {\n  queue: string;\n  fn: QueueHandler;\n}\n\n/**\n * DbQueueAdapter — durable, polling, DB-backed IQueueService.\n *\n * Persists every message to `sys_job_queue`. A polling worker leases\n * pending messages (CAS update status pending→running with a lease),\n * invokes registered subscribers, and retries with backoff on failure.\n * Messages that exceed `max_attempts` land in `status='dlq'`.\n *\n * Idempotency: publish suppresses duplicates within a configurable\n * window when `(queue, idempotencyKey)` is non-null.\n *\n * Designed for SQLite and Postgres alike — uses CAS via WHERE-clauses,\n * not row-level locking.\n */\nexport class DbQueueAdapter implements IQueueService {\n  private readonly engine: JobEngine;\n  private readonly logger?: JobLogger;\n  private readonly clock?: JobClock;\n  private readonly opts: Required<Omit<DbQueueAdapterOptions, 'workerId'>> & { workerId: string };\n\n  private readonly handlers = new Map<string, RegisteredHandler[]>();\n  private timer?: ReturnType<typeof setInterval>;\n  private running = false;\n\n  constructor(args: {\n    engine: JobEngine;\n    logger?: JobLogger;\n    clock?: JobClock;\n    options?: DbQueueAdapterOptions;\n  }) {\n    this.engine = args.engine;\n    this.logger = args.logger;\n    this.clock = args.clock;\n    const o = args.options ?? {};\n    this.opts = {\n      pollIntervalMs: o.pollIntervalMs ?? 1000,\n      batchSize: o.batchSize ?? 10,\n      leaseMs: o.leaseMs ?? 30_000,\n      idempotencyWindowMs: o.idempotencyWindowMs ?? 24 * 60 * 60 * 1000,\n      defaultMaxAttempts: o.defaultMaxAttempts ?? 3,\n      autoStart: o.autoStart ?? true,\n      workerId: o.workerId ?? uid('worker'),\n    };\n  }\n\n  // ── IQueueService ────────────────────────────────────────────────\n\n  async publish<T = unknown>(\n    queue: string,\n    data: T,\n    options?: QueuePublishOptions,\n  ): Promise<string> {\n    const opts = options ?? {};\n    const now = this.now();\n\n    // Idempotency check\n    if (opts.idempotencyKey) {\n      const windowStart = new Date(now.getTime() - this.opts.idempotencyWindowMs).toISOString();\n      const existing = await this.engine.find(QUEUE_TABLE, {\n        where: {\n          queue,\n          idempotency_key: opts.idempotencyKey,\n          // Only block if not yet terminal — completed/dlq dedup is by window via created_at\n        },\n        limit: 5,\n        context: SYSTEM_CTX,\n      });\n      const blocking = (existing ?? []).find((row: any) => {\n        if (row.status === 'pending' || row.status === 'running') return true;\n        return String(row.created_at ?? '') >= windowStart;\n      });\n      if (blocking) return String(blocking.id);\n    }\n\n    const id = uid('msg');\n    const scheduledFor = opts.scheduledFor\n      ? new Date(opts.scheduledFor).toISOString()\n      : opts.delay\n        ? new Date(now.getTime() + opts.delay).toISOString()\n        : now.toISOString();\n\n    const maxAttempts = opts.maxAttempts\n      ?? (opts.retries != null ? opts.retries + 1 : this.opts.defaultMaxAttempts);\n    const backoff = opts.backoff ?? { type: 'exponential' as const, delayMs: 1000 };\n\n    await this.engine.insert(QUEUE_TABLE, {\n      id,\n      queue,\n      idempotency_key: opts.idempotencyKey ?? null,\n      payload_json: JSON.stringify(data ?? null),\n      metadata_json: opts.metadata ? JSON.stringify(opts.metadata) : null,\n      status: 'pending',\n      priority: opts.priority ?? 100,\n      attempts: 0,\n      max_attempts: maxAttempts,\n      backoff_type: backoff.type,\n      backoff_delay_ms: backoff.delayMs,\n      backoff_max_delay_ms: backoff.maxDelayMs ?? null,\n      scheduled_for: scheduledFor,\n      created_at: now.toISOString(),\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n\n    return id;\n  }\n\n  async subscribe<T = unknown>(queue: string, handler: QueueHandler<T>): Promise<void> {\n    const existing = this.handlers.get(queue) ?? [];\n    existing.push({ queue, fn: handler as QueueHandler });\n    this.handlers.set(queue, existing);\n    if (this.opts.autoStart) this.start();\n  }\n\n  async unsubscribe(queue: string): Promise<void> {\n    this.handlers.delete(queue);\n  }\n\n  async getQueueSize(queue: string): Promise<number> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: 10_000,\n      context: SYSTEM_CTX,\n    });\n    return rows?.length ?? 0;\n  }\n\n  async purge(queue: string): Promise<void> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: 10_000,\n      context: SYSTEM_CTX,\n    });\n    for (const row of rows ?? []) {\n      try { await this.engine.delete(QUEUE_TABLE, { id: row.id, context: SYSTEM_CTX }); }\n      catch (err) { this.logger?.warn?.('DbQueueAdapter: purge delete failed', err as any); }\n    }\n  }\n\n  async listFailed(\n    queue?: string,\n    options?: { limit?: number; offset?: number },\n  ): Promise<QueueMessageRecord[]> {\n    const where: any = { status: 'dlq' };\n    if (queue) where.queue = queue;\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where,\n      limit: options?.limit ?? 100,\n      offset: options?.offset,\n      orderBy: [{ field: 'created_at', order: 'desc' }],\n      context: SYSTEM_CTX,\n    });\n    return (rows ?? []).map((r: any) => this.rowToRecord(r));\n  }\n\n  async replay(messageId: string): Promise<void> {\n    const row = await this.loadById(messageId);\n    if (!row) throw new Error(`MESSAGE_NOT_FOUND: ${messageId}`);\n    if (row.status !== 'dlq' && row.status !== 'failed') {\n      throw new Error(`INVALID_STATE: cannot replay message in status=${row.status}`);\n    }\n    const now = this.now();\n    await this.engine.update(QUEUE_TABLE, {\n      id: messageId,\n      status: 'pending',\n      attempts: 0,\n      last_error: null,\n      locked_by: null,\n      locked_until: null,\n      scheduled_for: now.toISOString(),\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n  }\n\n  async purgeFailed(messageId: string): Promise<void> {\n    const row = await this.loadById(messageId);\n    if (!row) return;\n    if (row.status !== 'dlq' && row.status !== 'failed') {\n      throw new Error(`INVALID_STATE: cannot purge message in status=${row.status}`);\n    }\n    await this.engine.delete(QUEUE_TABLE, { id: messageId, context: SYSTEM_CTX });\n  }\n\n  // ── Worker lifecycle ─────────────────────────────────────────────\n\n  start(): void {\n    if (this.timer) return;\n    this.timer = setInterval(() => {\n      if (this.running) return;\n      this.running = true;\n      this.pollOnce()\n        .catch((err) => { this.logger?.warn?.('DbQueueAdapter: poll tick failed', err); })\n        .finally(() => { this.running = false; });\n    }, this.opts.pollIntervalMs);\n    (this.timer as any)?.unref?.();\n  }\n\n  async stop(): Promise<void> {\n    if (this.timer) { clearInterval(this.timer); this.timer = undefined; }\n  }\n\n  /** Test-friendly synchronous poll. */\n  async pollOnce(): Promise<number> {\n    const queues = [...this.handlers.keys()];\n    if (queues.length === 0) return 0;\n\n    let processed = 0;\n    for (const queue of queues) {\n      const claimed = await this.claimBatch(queue, this.opts.batchSize);\n      for (const row of claimed) {\n        await this.dispatch(row);\n        processed++;\n      }\n    }\n    return processed;\n  }\n\n  // ── Internals ────────────────────────────────────────────────────\n\n  private async claimBatch(queue: string, max: number): Promise<any[]> {\n    const now = this.now();\n    const candidates = await this.engine.find(QUEUE_TABLE, {\n      where: { queue, status: 'pending' },\n      limit: max * 3, // over-fetch in case of CAS contention\n      orderBy: [\n        { field: 'priority', order: 'asc' },\n        { field: 'scheduled_for', order: 'asc' },\n      ],\n      context: SYSTEM_CTX,\n    });\n\n    const out: any[] = [];\n    for (const row of candidates ?? []) {\n      if (out.length >= max) break;\n      const sched = row.scheduled_for ? new Date(row.scheduled_for).getTime() : 0;\n      if (sched > now.getTime()) continue;\n      // Honor existing lease\n      const lockedUntil = row.locked_until ? new Date(row.locked_until).getTime() : 0;\n      if (row.locked_by && lockedUntil > now.getTime()) continue;\n\n      // CAS — only update if still pending (best-effort with engine.update which\n      // typically does row-level update by id; concurrent workers will overwrite\n      // each other but the dispatcher tolerates duplicate delivery via attempts).\n      try {\n        await this.engine.update(QUEUE_TABLE, {\n          id: row.id,\n          status: 'running',\n          locked_by: this.opts.workerId,\n          locked_until: new Date(now.getTime() + this.opts.leaseMs).toISOString(),\n          updated_at: now.toISOString(),\n        }, { context: SYSTEM_CTX });\n        out.push({ ...row, status: 'running' });\n      } catch (err) {\n        this.logger?.warn?.('DbQueueAdapter: claim CAS failed', err as any);\n      }\n    }\n    return out;\n  }\n\n  private async dispatch(row: any): Promise<void> {\n    const handlers = this.handlers.get(row.queue) ?? [];\n    if (handlers.length === 0) {\n      // No handler — release lease so another process can pick it up\n      await this.releasePending(row.id);\n      return;\n    }\n\n    const msg: QueueMessage = {\n      id: String(row.id),\n      data: parseJson(row.payload_json),\n      attempts: (row.attempts ?? 0) + 1,\n      timestamp: row.created_at ? new Date(row.created_at).getTime() : Date.now(),\n    };\n\n    let success = true;\n    let lastError: string | undefined;\n    for (const h of handlers) {\n      try { await h.fn(msg); }\n      catch (err) {\n        success = false;\n        lastError = err instanceof Error ? err.message : String(err);\n        this.logger?.warn?.(`DbQueueAdapter: handler failed on ${row.queue}`, err as any);\n        break;\n      }\n    }\n\n    const now = this.now();\n    if (success) {\n      await this.engine.update(QUEUE_TABLE, {\n        id: row.id,\n        status: 'completed',\n        attempts: msg.attempts,\n        completed_at: now.toISOString(),\n        locked_by: null,\n        locked_until: null,\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n      return;\n    }\n\n    const attempts = msg.attempts;\n    const max = row.max_attempts ?? this.opts.defaultMaxAttempts;\n    if (attempts >= max) {\n      await this.engine.update(QUEUE_TABLE, {\n        id: row.id,\n        status: 'dlq',\n        attempts,\n        last_error: lastError ?? 'unknown error',\n        completed_at: now.toISOString(),\n        locked_by: null,\n        locked_until: null,\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n      return;\n    }\n\n    const backoffMs = this.computeBackoff(row, attempts);\n    await this.engine.update(QUEUE_TABLE, {\n      id: row.id,\n      status: 'pending',\n      attempts,\n      last_error: lastError ?? 'unknown error',\n      scheduled_for: new Date(now.getTime() + backoffMs).toISOString(),\n      locked_by: null,\n      locked_until: null,\n      updated_at: now.toISOString(),\n    }, { context: SYSTEM_CTX });\n  }\n\n  private computeBackoff(row: any, attempt: number): number {\n    const base = row.backoff_delay_ms ?? 1000;\n    const cap = row.backoff_max_delay_ms ?? undefined;\n    if ((row.backoff_type ?? 'exponential') === 'fixed') return base;\n    const exp = base * Math.pow(2, Math.max(0, attempt - 1));\n    return cap ? Math.min(exp, cap) : exp;\n  }\n\n  private async releasePending(id: string): Promise<void> {\n    const now = this.now();\n    try {\n      await this.engine.update(QUEUE_TABLE, {\n        id,\n        status: 'pending',\n        locked_by: null,\n        locked_until: null,\n        scheduled_for: new Date(now.getTime() + this.opts.pollIntervalMs * 5).toISOString(),\n        updated_at: now.toISOString(),\n      }, { context: SYSTEM_CTX });\n    } catch (err) {\n      this.logger?.warn?.('DbQueueAdapter: release failed', err as any);\n    }\n  }\n\n  private async loadById(id: string): Promise<any | null> {\n    const rows = await this.engine.find(QUEUE_TABLE, {\n      where: { id },\n      limit: 1,\n      context: SYSTEM_CTX,\n    });\n    return rows?.[0] ?? null;\n  }\n\n  private rowToRecord(r: any): QueueMessageRecord {\n    return {\n      id: String(r.id),\n      queue: String(r.queue),\n      data: parseJson(r.payload_json),\n      status: r.status,\n      attempts: r.attempts ?? 0,\n      maxAttempts: r.max_attempts ?? this.opts.defaultMaxAttempts,\n      scheduledFor: r.scheduled_for ?? undefined,\n      lockedBy: r.locked_by ?? undefined,\n      lockedUntil: r.locked_until ?? undefined,\n      lastError: r.last_error ?? undefined,\n      idempotencyKey: r.idempotency_key ?? undefined,\n      metadata: parseJson(r.metadata_json),\n      createdAt: r.created_at ?? nowIso(this.clock),\n      updatedAt: r.updated_at ?? undefined,\n      completedAt: r.completed_at ?? undefined,\n    };\n  }\n\n  private now(): Date {\n    return this.clock?.now() ?? new Date();\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@objectstack/service-queue",
-  "version": "9.4.0",
+  "version": "9.5.1",
   "license": "Apache-2.0",
-  "description": "Queue Service for ObjectStack — implements IQueueService with in-memory and BullMQ adapters",
+  "description": "Queue Service for ObjectStack — implements IQueueService with in-memory and durable DB-backed (sys_job_queue) adapters",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,9 +14,9 @@
     }
   },
   "dependencies": {
-    "@objectstack/core": "9.4.0",
-    "@objectstack/platform-objects": "9.4.0",
-    "@objectstack/spec": "9.4.0"
+    "@objectstack/core": "9.5.1",
+    "@objectstack/platform-objects": "9.5.1",
+    "@objectstack/spec": "9.5.1"
   },
   "devDependencies": {
     "@types/node": "^25.9.2",