@capixjs/transport-queue 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Capix Contributors
+
+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

@@ -0,0 +1,159 @@
+# @capixjs/transport-queue
+
+Queue transport for [Capix](https://github.com/capix/capix). Process background jobs by routing queue messages to capability resolvers — no HTTP, no WebSocket, just workers consuming from a queue adapter.
+
+## Install
+
+```bash
+npm install @capixjs/core @capixjs/transport-queue zod
+```
+
+## Usage
+
+```ts
+import { createServer } from '@capixjs/core';
+import { queueTransport, MemoryQueueAdapter, createQueueClient } from '@capixjs/transport-queue';
+import { buildContext, capabilities } from './capabilities.js';
+
+const adapter  = new MemoryQueueAdapter();
+const jobQueue = createQueueClient(adapter, 'jobs');
+
+createServer({
+  context: buildContext,
+  capabilities,
+  transports: [
+    queueTransport({ queues: ['jobs'], adapter }),
+  ],
+}).start();
+
+// Enqueue a job from anywhere in your application:
+await jobQueue.enqueue('jobs.processOrder', { orderId: '123' });
+```
+
+## Adapters
+
+### `MemoryQueueAdapter`
+
+In-process queue, suitable for development and testing. Jobs are not persisted — they are lost if the process restarts.
+
+```ts
+import { MemoryQueueAdapter } from '@capixjs/transport-queue';
+const adapter = new MemoryQueueAdapter();
+```
+
+### BullMQ adapter (Redis)
+
+```ts
+import { Queue, Worker } from 'bullmq';
+import type { QueueAdapter, QueueMessage } from '@capixjs/transport-queue';
+
+class BullMQAdapter implements QueueAdapter {
+  private workers = new Map<string, Worker>();
+  private queues  = new Map<string, Queue>();
+
+  async start(queue: string, handler: (msg: QueueMessage) => Promise<unknown>): Promise<void> {
+    const worker = new Worker(queue, async (job) => handler(job.data as QueueMessage), {
+      connection: { host: 'localhost', port: 6379 },
+    });
+    this.workers.set(queue, worker);
+  }
+
+  async enqueue(queue: string, msg: QueueMessage): Promise<void> {
+    if (!this.queues.has(queue)) {
+      this.queues.set(queue, new Queue(queue, { connection: { host: 'localhost', port: 6379 } }));
+    }
+    await this.queues.get(queue)!.add(msg.capability, msg);
+  }
+
+  async stop(): Promise<void> {
+    await Promise.all([
+      ...[...this.workers.values()].map((w) => w.close()),
+      ...[...this.queues.values()].map((q) => q.close()),
+    ]);
+  }
+}
+```
+
+### Custom adapters
+
+Implement the `QueueAdapter` interface to connect to SQS, Faktory, or any queue system:
+
+```ts
+import type { QueueAdapter, QueueMessage } from '@capixjs/transport-queue';
+
+class BullMQAdapter implements QueueAdapter {
+  async start(queue: string, handler: (msg: QueueMessage) => Promise<unknown>): Promise<void> {
+    // Subscribe to the BullMQ queue and call handler for each job
+  }
+  async enqueue(queue: string, msg: QueueMessage): Promise<void> {
+    // Add job to BullMQ queue
+  }
+  async stop(): Promise<void> {
+    // Drain and close connections
+  }
+}
+```
+
+## `createQueueClient`
+
+Creates a typed client for enqueueing jobs:
+
+```ts
+const jobQueue = createQueueClient(adapter, 'jobs');
+
+// Enqueue with capability name and input
+const jobId = await jobQueue.enqueue('jobs.sendEmail', { to: 'user@example.com' });
+```
+
+## Queue transport vs HTTP
+
+The queue transport invokes capabilities through the same execution engine as REST and WebSocket — guards run, input is validated, context is built. The key difference: the caller is the queue adapter, not an HTTP client.
+
+```ts
+// jobs-only capabilities never exposed over HTTP
+createServer({
+  context: buildContext,
+  transports: [
+    restTransport({ port: 3000, capabilities: publicCaps }),
+    queueTransport({ queues: ['jobs'], adapter, capabilities: jobCaps }),
+  ],
+});
+```
+
+## Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `queues` | `string[]` | Queue names to listen on |
+| `adapter` | `QueueAdapter` | Queue backend implementation |
+| `capabilities` | `GroupTree` | Per-transport capability registry (optional) |
+
+## Message format
+
+The wire format is the `QueueMessage` type. Any system that can enqueue a JSON object to your queue can trigger Capix capabilities:
+
+```ts
+type QueueMessage = {
+  capability: string;  // dot-path, e.g. 'jobs.processOrder'
+  input:      unknown; // passed to the capability's input validator
+};
+```
+
+## Security note
+
+The queue transport does **not** enforce authentication by default. Jobs arrive with a minimal context (just `requestId`) — there is no `Authorization` header. Guards using `ctx.user` will always see `null` for queue-originated jobs unless you explicitly populate the user field in your context builder by reading from the job input or a service account.
+
+For queue jobs that should run with service-account privileges, pattern the context builder to check for a job-specific header or trust flag:
+
+```ts
+const buildContext = defineContext(async (req) => ({
+  requestId: crypto.randomUUID(),
+  user: req.headers['x-service-account'] === process.env.QUEUE_SECRET
+    ? SERVICE_ACCOUNT
+    : await verifyJwt(req.headers.authorization),
+}));
+```
+
+## License
+
+MIT

package/dist/adapters/bullmq.d.ts

@@ -0,0 +1,21 @@
+import type { QueueAdapter, QueueMessage, QueueResult } from '../types.js';
+export type BullMQAdapterOptions = {
+    connection: {
+        host: string;
+        port: number;
+    } | {
+        url: string;
+    };
+    concurrency?: number;
+    removeOnComplete?: number;
+    removeOnFail?: number;
+};
+export declare class BullMQAdapter implements QueueAdapter {
+    private options;
+    private workers;
+    constructor(options: BullMQAdapterOptions);
+    start(queueName: string, onMessage: (msg: QueueMessage) => Promise<QueueResult>): Promise<void>;
+    enqueue(queueName: string, msg: QueueMessage): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=bullmq.d.ts.map

package/dist/adapters/bullmq.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullmq.d.ts","sourceRoot":"","sources":["../../src/adapters/bullmq.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa3E,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,OAAO,CAAiD;gBAEpD,OAAO,EAAE,oBAAoB;IAInC,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC;IAwBV,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAM5B"}

package/dist/adapters/bullmq.js

@@ -0,0 +1,46 @@
+async function loadBullMQ() {
+    try {
+        return await import('bullmq');
+    }
+    catch {
+        throw new Error('[capix] capix-transport-queue BullMQ adapter requires bullmq and ioredis.\n' +
+            'Install them: pnpm add bullmq ioredis');
+    }
+}
+export class BullMQAdapter {
+    options;
+    workers = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    async start(queueName, onMessage) {
+        const { Worker } = await loadBullMQ();
+        const worker = new Worker(queueName, async (job) => {
+            const result = await onMessage(job.data);
+            if (!result.ok) {
+                throw new Error(JSON.stringify(result.error));
+            }
+            return result.data;
+        }, {
+            connection: this.options.connection,
+            concurrency: this.options.concurrency ?? 10,
+            removeOnComplete: { count: this.options.removeOnComplete ?? 100 },
+            removeOnFail: { count: this.options.removeOnFail ?? 1000 },
+        });
+        this.workers.set(queueName, worker);
+        console.log(`[capix] Queue transport processing: ${queueName}`);
+    }
+    async enqueue(queueName, msg) {
+        const { Queue } = await loadBullMQ();
+        const queue = new Queue(queueName, { connection: this.options.connection });
+        await queue.add(msg.capability, msg, { jobId: msg.id });
+        await queue.close();
+    }
+    async stop() {
+        for (const worker of this.workers.values()) {
+            await worker.close();
+        }
+        this.workers.clear();
+    }
+}
+//# sourceMappingURL=bullmq.js.map

package/dist/adapters/bullmq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullmq.js","sourceRoot":"","sources":["../../src/adapters/bullmq.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,UAAU;IACvB,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,6EAA6E;YAC7E,uCAAuC,CACxC,CAAC;IACJ,CAAC;AACH,CAAC;AASD,MAAM,OAAO,aAAa;IAChB,OAAO,CAAuB;IAC9B,OAAO,GAAG,IAAI,GAAG,EAAsC,CAAC;IAEhE,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAK,CACT,SAAiB,EACjB,SAAsD;QAEtD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,EAAE,CAAC;QAEtC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,SAAS,EACT,KAAK,EAAE,GAA2B,EAAE,EAAE;YACpC,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC,EACD;YACE,UAAU,EAAQ,IAAI,CAAC,OAAO,CAAC,UAAU;YACzC,WAAW,EAAO,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE;YAChD,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,gBAAgB,IAAI,GAAG,EAAE;YACjE,YAAY,EAAM,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,EAAE;SAC/D,CACF,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAoC,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,uCAAuC,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,GAAiB;QAChD,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,UAAU,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5E,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YAC3C,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/adapters/memory.d.ts

@@ -0,0 +1,11 @@
+import type { QueueAdapter, QueueMessage, QueueResult } from '../types.js';
+export declare class MemoryQueueAdapter implements QueueAdapter {
+    private queues;
+    private handlers;
+    private running;
+    start(queueName: string, onMessage: (msg: QueueMessage) => Promise<QueueResult>): Promise<void>;
+    enqueue(queueName: string, msg: QueueMessage): Promise<void>;
+    private processQueue;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/adapters/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/adapters/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM3E,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,QAAQ,CAAkE;IAClF,OAAO,CAAC,OAAO,CAAU;IAEnB,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC;IAMV,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAelE,OAAO,CAAC,YAAY;IAcd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B"}

package/dist/adapters/memory.js

@@ -0,0 +1,44 @@
+export class MemoryQueueAdapter {
+    queues = new Map();
+    handlers = new Map();
+    running = false;
+    async start(queueName, onMessage) {
+        this.handlers.set(queueName, onMessage);
+        this.running = true;
+        this.processQueue(queueName);
+    }
+    async enqueue(queueName, msg) {
+        const handler = this.handlers.get(queueName);
+        if (handler && this.running) {
+            setImmediate(() => {
+                handler(msg).catch(() => {
+                    // Silently drop failed jobs — caller should handle errors in onMessage
+                });
+            });
+        }
+        else {
+            if (!this.queues.has(queueName))
+                this.queues.set(queueName, []);
+            this.queues.get(queueName).push({ msg });
+        }
+    }
+    processQueue(queueName) {
+        const pending = this.queues.get(queueName);
+        if (!pending || pending.length === 0)
+            return;
+        const handler = this.handlers.get(queueName);
+        if (!handler)
+            return;
+        this.queues.set(queueName, []);
+        for (const job of pending) {
+            setImmediate(() => {
+                handler(job.msg).catch(() => { });
+            });
+        }
+    }
+    async stop() {
+        this.running = false;
+        this.handlers.clear();
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/adapters/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/adapters/memory.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,kBAAkB;IACrB,MAAM,GAAK,IAAI,GAAG,EAAwB,CAAC;IAC3C,QAAQ,GAAG,IAAI,GAAG,EAAuD,CAAC;IAC1E,OAAO,GAAI,KAAK,CAAC;IAEzB,KAAK,CAAC,KAAK,CACT,SAAiB,EACjB,SAAsD;QAEtD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,SAAiB,EAAE,GAAiB;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE7C,IAAI,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,YAAY,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;oBACtB,uEAAuE;gBACzE,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAChE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,SAAiB;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,OAAO;QAErB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,YAAY,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { queueTransport, createQueueClient } from './transport.js';
+export { MemoryQueueAdapter } from './adapters/memory.js';
+export { BullMQAdapter } from './adapters/bullmq.js';
+export type { QueueAdapter, QueueMessage, QueueResult } from './types.js';
+export type { QueueTransportOptions } from './transport.js';
+export type { BullMQAdapterOptions } from './adapters/bullmq.js';
+//# 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,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAqB,sBAAsB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAA0B,sBAAsB,CAAC;AACzE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,MAAa,gBAAgB,CAAC;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { queueTransport, createQueueClient } from './transport.js';
+export { MemoryQueueAdapter } from './adapters/memory.js';
+export { BullMQAdapter } from './adapters/bullmq.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAqB,sBAAsB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAA0B,sBAAsB,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,13 @@
+import type { GroupTree, TransportWithCapabilities } from '@capixjs/core';
+import type { QueueAdapter } from './types.js';
+export type QueueTransportOptions = {
+    queues: string[];
+    adapter: QueueAdapter;
+    /** Capability registry for this transport only. Overrides the server-level default. */
+    capabilities?: GroupTree;
+};
+export declare function queueTransport(options: QueueTransportOptions): TransportWithCapabilities;
+export declare function createQueueClient(adapter: QueueAdapter, queueName: string): {
+    enqueue(capability: string, input: unknown, headers?: Record<string, string>): Promise<string>;
+};
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqC,SAAS,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC7G,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAoD,YAAY,CAAC;AAG3G,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAI,MAAM,EAAE,CAAC;IACnB,OAAO,EAAG,YAAY,CAAC;IACvB,uFAAuF;IACvF,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,yBAAyB,CAqBxF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM;wBAGxD,MAAM,SACN,OAAO,YACP,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC;EAMrB"}

package/dist/transport.js

@@ -0,0 +1,31 @@
+import { randomUUID } from 'node:crypto';
+export function queueTransport(options) {
+    return {
+        ...(options.capabilities !== undefined ? { _capabilities: options.capabilities } : {}),
+        async mount(invoke, _mountOptions) {
+            for (const queueName of options.queues) {
+                await options.adapter.start(queueName, async (msg) => {
+                    return invoke({
+                        capability: msg.capability,
+                        input: msg.input,
+                        headers: msg.headers,
+                        signal: AbortSignal.timeout(300_000),
+                    });
+                });
+            }
+        },
+        async unmount() {
+            await options.adapter.stop();
+        },
+    };
+}
+export function createQueueClient(adapter, queueName) {
+    return {
+        async enqueue(capability, input, headers = {}) {
+            const id = randomUUID();
+            await adapter.enqueue(queueName, { id, capability, input, headers });
+            return id;
+        },
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAyE,aAAa,CAAC;AAS5G,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,OAAO;QACL,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAEtF,KAAK,CAAC,KAAK,CAAC,MAAgB,EAAE,aAA2B;YACvD,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvC,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,GAAiB,EAAE,EAAE;oBACjE,OAAO,MAAM,CAAC;wBACZ,UAAU,EAAE,GAAG,CAAC,UAAU;wBAC1B,KAAK,EAAO,GAAG,CAAC,KAAK;wBACrB,OAAO,EAAK,GAAG,CAAC,OAAO;wBACvB,MAAM,EAAM,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;qBACzC,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,KAAK,CAAC,OAAO;YACX,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAqB,EAAE,SAAiB;IACxE,OAAO;QACL,KAAK,CAAC,OAAO,CACX,UAAkB,EAClB,KAAmB,EACnB,UAAqC,EAAE;YAEvC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YACxB,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YACrE,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,24 @@
+export type QueueMessage = {
+    id: string;
+    capability: string;
+    input: unknown;
+    headers: Record<string, string>;
+};
+export type QueueResult = {
+    ok: true;
+    data: unknown;
+} | {
+    ok: false;
+    error: {
+        status: number;
+        error: string;
+        message: string;
+        meta?: Record<string, unknown>;
+    };
+};
+export interface QueueAdapter {
+    start(queueName: string, onMessage: (msg: QueueMessage) => Promise<QueueResult>): Promise<void>;
+    enqueue(queueName: string, msg: QueueMessage): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAU,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAO,OAAO,CAAC;IACpB,OAAO,EAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,CAAC;AAE7G,MAAM,WAAW,YAAY;IAC3B,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@capixjs/transport-queue",
+  "version": "0.1.0-alpha.1",
+  "description": "Message queue transport for Capix (BullMQ + in-memory)",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./memory": {
+      "import": "./dist/adapters/memory.js",
+      "types": "./dist/adapters/memory.d.ts"
+    },
+    "./bullmq": {
+      "import": "./dist/adapters/bullmq.js",
+      "types": "./dist/adapters/bullmq.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "LICENSE"
+  ],
+  "keywords": [
+    "capix",
+    "queue",
+    "bullmq",
+    "redis",
+    "transport",
+    "background-jobs",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@capixjs/core": ">=0.1.0-0"
+  },
+  "peerDependenciesMeta": {
+    "bullmq": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "bullmq": "^5.0.0",
+    "ioredis": "^5.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^1.6.0",
+    "zod": "^3.23.0",
+    "@capixjs/core": "workspace:*"
+  }
+}