@siglo/bullmq 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Jerico de guzman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,232 @@
-# Temporary Holding Version
+# @siglo/bullmq Adapter Guide
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@siglo/bullmq` provides a high-throughput, Redis-backed job queue consumer and worker processor adapter for `Siglo` workflows. It bridges BullMQ workers with the Siglo execution engine, offering payload unwrapping, distributed idempotency deduplication, timeout enforcement, tenant namespace partitioning, and graceful failure handling.
+
+---
+
+## 1. Overview & Architecture
+
+When executing distributed workflows across worker clusters, BullMQ distributes asynchronous jobs backed by Redis. The `@siglo/bullmq` adapter wraps workflow execution within a standard BullMQ worker processor function (`(job: Job) => Promise<any>`).
+
+```mermaid
+flowchart TD
+    Queue["Redis Queue (BullMQ)"] -->|Job Polling| Worker["BullMQ Worker"]
+    Worker --> Processor["createBullMQProcessor<br/>• Extract job.id / claim<br/>• Input transformation<br/>• Namespace resolution<br/>• Timeout enforcement"]
+    Processor --> WF["Siglo Workflow<br/>(Flow&lt;TInput, TOutput&gt;)"]
+    WF -->|On Success| Success["Store Result (idempotencyStore)<br/>Return Clean Context"]
+    WF -->|On Failure| Failure["Clear/Fail Claim (idempotencyStore)<br/>Re-throw to Worker"]
+```
+
+---
+
+## 2. Installation & Requirements
+
+### Package Dependencies
+
+Install `@siglo/bullmq` alongside `Siglo`. BullMQ and ioredis are declared as optional peer dependencies so you control the exact version:
+
+```bash
+npm install @siglo/core @siglo/bullmq bullmq ioredis
+```
+
+Peer dependency matrix:
+- `Siglo`: `*` (v1.0.0+)
+- `bullmq`: `^5.0.0`
+- `ioredis`: `^5.0.0 || ^6.0.0`
+
+---
+
+## 3. API Reference
+
+### `createBullMQProcessor(workflow, options)`
+
+Creates a BullMQ-compliant worker processor function:
+
+```typescript
+function createBullMQProcessor<TInput = any, TOutput = any, TJob = any>(
+    workflow: Flow<TInput, TOutput>,
+    options?: SigloBullMQOptions<TJob, TInput, TOutput>
+): (job: any) => Promise<any>;
+```
+
+#### Parameters:
+- `workflow` (`Flow<TInput, TOutput>`): The compiled `Siglo` workflow instance to execute.
+- `options` (`SigloBullMQOptions<TJob, TInput, TOutput>`): Optional configuration dictionary.
+
+---
+
+## 4. Configuration Options (`SigloBullMQOptions`)
+
+| Option | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `input` | `(job: TJob) => Promise<TInput> \| TInput` | `(job) => job.data` | Custom mapper to transform the BullMQ `Job` into workflow inputs. |
+| `output` | `(result: any, job: TJob) => Promise<TOutput> \| TOutput` | `(result) => result` | Custom mapper to format or filter the workflow result before returning to BullMQ. |
+| `idempotencyStore` | `IdempotencyStore` | `undefined` | Distributed store (e.g., `RedisIdempotencyStore` or `PostgresIdempotencyStore`) to guarantee exactly-once processing. |
+| `idempotencyTtlMs` | `number` | `86400000` (24h) | Time-to-live for the idempotency claim in milliseconds. |
+| `timeout` | `number` | `undefined` | SLA deadline in milliseconds for workflow execution. Throws `StepTimeoutException` / `FlowTimeoutException` if exceeded. |
+| `namespace` | `string \| ((job: TJob) => string \| undefined)` | `job.data?.namespace` | Target namespace for state partitioning and checkpoint isolation. |
+
+---
+
+## 5. Execution Lifecycle & Data Flow
+
+1. **Job Identification & Idempotency Key**:
+   - The adapter generates an idempotency key: `bullmq:job:${job.id || String(Date.now())}`.
+   - If `idempotencyStore` is provided, the key is atomically claimed:
+     - `'completed'`: Returns cached result immediately via `store.getResult(key)` without re-running the workflow.
+     - `'in-progress'`: Throws `Error('Job ... is already in-progress concurrently')`, signaling BullMQ to avoid concurrent race conditions.
+     - `'claimed'`: Proceeds to workflow execution.
+
+2. **Input Mapping**:
+   - If `options.input` is defined, it is invoked with `job`.
+   - Otherwise, `job.data || {}` is passed directly as the initial workflow input parameter.
+
+3. **Namespace Resolution**:
+   - If `options.namespace` is a function, `options.namespace(job)` is called.
+   - If `options.namespace` is a static string, it is used.
+   - Otherwise, the adapter inspects `job.data?.namespace`.
+
+4. **Workflow Execution & Context Unwrapping**:
+   - The workflow executes with `{ timeout: options.timeout, namespace }`.
+   - Results are automatically unwrapped (`unwrapContext`), removing internal engine properties (keys prefixed with `$`) and resolving getter accessor functions into standard JSON-serializable primitives.
+
+5. **Completion & Failure Handling**:
+   - **Success**: If an idempotency store is configured, `store.complete(idempKey, cleanResult)` is called, and `options.output` (if provided) shapes the return value.
+   - **Failure**: If an error is thrown, `store.fail(idempKey, err)` is called to release the in-flight lock, enabling BullMQ retry strategies. The error is re-thrown to trigger BullMQ failure handling.
+
+---
+
+## 6. Complete Production Examples
+
+### Basic Media Transcoder Worker
+
+```typescript
+import { Worker, Job } from 'bullmq';
+import { Step, flow } from '@siglo/core';
+import { createBullMQProcessor } from '@siglo/bullmq';
+import { Redis } from 'ioredis';
+
+const connection = new Redis(process.env.REDIS_URL || 'redis://localhost:6379', {
+    maxRetriesPerRequest: null,
+});
+
+// 1. Define workflow steps
+interface VideoJobData {
+    videoId: string;
+    sourceBucket: string;
+    resolutions: ('720p' | '1080p' | '4k')[];
+}
+
+const downloadSource = Step.create('downloadSource', async (param: VideoJobData) => {
+    console.log(`Downloading video ${param.videoId} from ${param.sourceBucket}`);
+    return { localPath: `/tmp/${param.videoId}.mp4` };
+});
+
+const transcode = Step.create('transcode', async (param: any) => {
+    console.log(`Transcoding ${param.localPath} into ${param.resolutions.join(', ')}`);
+    return {
+        transcodedFiles: param.resolutions.map((r: string) => `/tmp/${param.videoId}_${r}.mp4`),
+        durationSec: 124,
+    };
+});
+
+const uploadCdn = Step.create('uploadCdn', async (param: any) => {
+    console.log(`Uploading ${param.transcodedFiles.length} files to CDN`);
+    return {
+        cdnUrls: param.transcodedFiles.map((f: string) => `https://cdn.example.com/${param.videoId}`),
+        status: 'READY',
+    };
+});
+
+const transcodeFlow = flow(downloadSource, transcode, uploadCdn);
+
+// 2. Create BullMQ worker with processor adapter
+const worker = new Worker<VideoJobData>(
+    'video-processing-queue',
+    createBullMQProcessor(transcodeFlow, {
+        timeout: 120000, // 2-minute deadline
+        input: (job: Job<VideoJobData>) => ({
+            videoId: job.data.videoId,
+            sourceBucket: job.data.sourceBucket,
+            resolutions: job.data.resolutions,
+        }),
+        output: (result, job) => ({
+            jobId: job.id,
+            videoId: job.data.videoId,
+            cdnUrls: result.cdnUrls,
+            durationSec: result.durationSec,
+        }),
+    }),
+    { connection, concurrency: 5 }
+);
+
+worker.on('completed', (job, returnvalue) => {
+    console.log(`Job ${job.id} completed. Transcoded video ready:`, returnvalue.cdnUrls);
+});
+
+worker.on('failed', (job, err) => {
+    console.error(`Job ${job?.id} failed: ${err.message}`);
+});
+```
+
+---
+
+### Distributed Idempotent Worker with `@siglo/redis`
+
+In high-concurrency environments with Redis clusters, duplicate job events or worker restarts should never cause duplicate processing:
+
+```typescript
+import { Worker } from 'bullmq';
+import { Step, flow } from '@siglo/core';
+import { createBullMQProcessor } from '@siglo/bullmq';
+import { RedisIdempotencyStore, RedisStorageAdapter } from '@siglo/redis';
+import { Redis } from 'ioredis';
+
+const redis = new Redis('redis://localhost:6379');
+
+// Configure global storage for checkpoints
+Step.useStorage(new RedisStorageAdapter({ client: redis }));
+
+// Configure distributed idempotency store
+const idempotencyStore = new RedisIdempotencyStore({
+    client: redis,
+    keyPrefix: 'siglo:idemp:bullmq:',
+    defaultTtlMs: 3600000, // 1 hour
+});
+
+const billingWorkflow = flow(
+    Step.create('chargeInvoice', async ({ invoiceId, amount }: any) => {
+        // Charging payment gateway
+        return { chargeId: `ch_${invoiceId}`, settled: true };
+    })
+);
+
+const worker = new Worker(
+    'billing-queue',
+    createBullMQProcessor(billingWorkflow, {
+        idempotencyStore,
+        idempotencyTtlMs: 3600000,
+        timeout: 10000,
+        namespace: (job) => job.data.tenantId, // Multi-tenant namespace
+    }),
+    { connection: redis, concurrency: 10 }
+);
+```
+
+---
+
+## 7. Graceful Shutdown & Connection Draining
+
+Ensure that ongoing workflow executions finish gracefully when the host process terminates (e.g., during Kubernetes pod evictions):
+
+```typescript
+async function shutdown() {
+    console.log('Shutting down BullMQ worker...');
+    await worker.close();
+    await redis.quit();
+    process.exit(0);
+}
+
+process.on('SIGTERM', shutdown);
+process.on('SIGINT', shutdown);
+```

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { Flow, IdempotencyStore } from '@siglo/core';
+export interface SigloBullMQOptions<TJob = any, TInput = any, TOutput = any> {
+    input?: (job: TJob) => Promise<TInput> | TInput;
+    output?: (result: any, job: TJob) => Promise<TOutput> | TOutput;
+    idempotencyStore?: IdempotencyStore;
+    idempotencyTtlMs?: number;
+    timeout?: number;
+    namespace?: string | ((job: TJob) => string | undefined);
+}
+/**
+ * Creates a BullMQ worker processor function that runs a siglo workflow.
+ */
+export declare function createBullMQProcessor<TInput = any, TOutput = any, TJob = any>(workflow: Flow<TInput, TOutput>, options?: SigloBullMQOptions<TJob, TInput, TOutput>): (job: any) => Promise<any>;
+export type RivuletBullMQOptions<TJob = any, TInput = any, TOutput = any> = SigloBullMQOptions<TJob, TInput, TOutput>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAoB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,MAAM,WAAW,kBAAkB,CAAC,IAAI,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACvE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAChD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAChE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,MAAM,GAAG,SAAS,CAAC,CAAC;CAC5D;AAiBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAAE,IAAI,GAAG,GAAG,EACzE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,GAAE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAM,SAEpC,GAAG,KAAG,OAAO,CAAC,GAAG,CAAC,CAmDxC;AAGD,MAAM,MAAM,oBAAoB,CAAC,IAAI,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/index.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBullMQProcessor = createBullMQProcessor;
+function unwrapContext(obj) {
+    if (!obj || typeof obj !== 'object') {
+        return obj;
+    }
+    const clean = {};
+    for (const key of Object.keys(obj)) {
+        if (key.startsWith('$')) {
+            continue;
+        }
+        const val = typeof obj[key] === 'function' ? (obj[key].val !== undefined ? obj[key].val : (obj[key].length === 0 ? obj[key]() : obj[key])) : obj[key];
+        clean[key] = val;
+    }
+    return clean;
+}
+/**
+ * Creates a BullMQ worker processor function that runs a siglo workflow.
+ */
+function createBullMQProcessor(workflow, options = {}) {
+    return async (job) => {
+        const jobId = job.id || String(Date.now());
+        const idempKey = `bullmq:job:${jobId}`;
+        // Idempotency check if store is provided
+        if (options.idempotencyStore) {
+            const status = await options.idempotencyStore.claim(idempKey, options.idempotencyTtlMs);
+            if (status === 'completed') {
+                return options.idempotencyStore.getResult?.(idempKey) ?? { alreadyProcessed: true };
+            }
+            if (status === 'in-progress') {
+                throw new Error(`Job ${jobId} is already in-progress concurrently`);
+            }
+        }
+        try {
+            const inputData = options.input ? await options.input(job) : (job.data || {});
+            let namespace;
+            if (typeof options.namespace === 'function') {
+                namespace = options.namespace(job);
+            }
+            else if (options.namespace) {
+                namespace = options.namespace;
+            }
+            else if (job.data?.namespace) {
+                namespace = job.data.namespace;
+            }
+            const execOptions = {
+                timeout: options.timeout,
+                namespace,
+            };
+            const rawResult = await workflow.run(inputData, execOptions);
+            const cleanResult = unwrapContext(rawResult);
+            if (options.idempotencyStore) {
+                await options.idempotencyStore.complete(idempKey, cleanResult);
+            }
+            if (options.output) {
+                return await options.output(cleanResult, job);
+            }
+            return cleanResult;
+        }
+        catch (err) {
+            if (options.idempotencyStore) {
+                await options.idempotencyStore.fail(idempKey, err);
+            }
+            throw err;
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@siglo/bullmq",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "BullMQ job queue consumer and worker adapter for Siglo workflows",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && mocha -r tsx 'src/**/*.test.ts'"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jsoftgem/siglo.git",
+    "directory": "packages/bullmq"
+  },
+  "author": "Jerico de Guzman",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/jsoftgem/siglo/issues"
+  },
+  "homepage": "https://github.com/jsoftgem/siglo#readme",
+  "dependencies": {
+    "@siglo/core": "^1.0.0"
+  },
+  "peerDependencies": {
+    "bullmq": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "bullmq": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.3",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^26.6.5",
+    "chai": "^3.5.0",
+    "mocha": "^12.0.3",
+    "tsx": "^4.23.15",
+    "typescript": "~5.7.0"
+  }
+}