stratal 0.0.1

package/dist/queue/decorators/inject-queue.decorator.d.ts

@@ -0,0 +1,31 @@
+import type { QueueName } from '../queue-name';
+/**
+ * Inject a queue sender by name.
+ *
+ * Queue names are typed via module augmentation of QueueNames interface.
+ * The queue name serves as both the identifier and the DI injection token.
+ *
+ * @param name - Queue name (typed with autocomplete if QueueNames is augmented)
+ * @returns Parameter decorator for constructor injection
+ *
+ * @example
+ * ```typescript
+ * // Direct injection by queue name
+ * constructor(
+ *   @InjectQueue('notifications-queue') private queue: IQueueSender
+ * ) {}
+ *
+ * // Usage
+ * await this.queue.dispatch({
+ *   type: 'email.send',
+ *   payload: { to: 'user@example.com', subject: 'Hello' }
+ * })
+ * ```
+ *
+ * @remarks
+ * The queue must be registered via `QueueModule.registerQueue(name)` before injection.
+ * For module-internal queue bindings (e.g., EmailModule), use `@inject(TOKEN)` with
+ * `useExisting` provider binding instead.
+ */
+export declare function InjectQueue(name: QueueName): ParameterDecorator;
+//# sourceMappingURL=inject-queue.decorator.d.ts.map

package/dist/queue/decorators/inject-queue.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-queue.decorator.d.ts","sourceRoot":"","sources":["../../../src/queue/decorators/inject-queue.decorator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,kBAAkB,CAE/D"}

package/dist/queue/decorators/inject-queue.decorator.js

@@ -0,0 +1,33 @@
+import { inject } from 'tsyringe';
+/**
+ * Inject a queue sender by name.
+ *
+ * Queue names are typed via module augmentation of QueueNames interface.
+ * The queue name serves as both the identifier and the DI injection token.
+ *
+ * @param name - Queue name (typed with autocomplete if QueueNames is augmented)
+ * @returns Parameter decorator for constructor injection
+ *
+ * @example
+ * ```typescript
+ * // Direct injection by queue name
+ * constructor(
+ *   @InjectQueue('notifications-queue') private queue: IQueueSender
+ * ) {}
+ *
+ * // Usage
+ * await this.queue.dispatch({
+ *   type: 'email.send',
+ *   payload: { to: 'user@example.com', subject: 'Hello' }
+ * })
+ * ```
+ *
+ * @remarks
+ * The queue must be registered via `QueueModule.registerQueue(name)` before injection.
+ * For module-internal queue bindings (e.g., EmailModule), use `@inject(TOKEN)` with
+ * `useExisting` provider binding instead.
+ */
+export function InjectQueue(name) {
+    return inject(name);
+}
+//# sourceMappingURL=inject-queue.decorator.js.map

package/dist/queue/decorators/inject-queue.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-queue.decorator.js","sourceRoot":"","sources":["../../../src/queue/decorators/inject-queue.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGjC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,WAAW,CAAC,IAAe;IACzC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAA;AACrB,CAAC"}

package/dist/queue/errors/index.d.ts

@@ -0,0 +1,3 @@
+export * from './queue-binding-not-found.error';
+export * from './queue-provider-not-supported.error';
+//# sourceMappingURL=index.d.ts.map

package/dist/queue/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/queue/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sCAAsC,CAAA"}

package/dist/queue/errors/index.js

@@ -0,0 +1,3 @@
+export * from './queue-binding-not-found.error';
+export * from './queue-provider-not-supported.error';
+//# sourceMappingURL=index.js.map

package/dist/queue/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/queue/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sCAAsC,CAAA"}

package/dist/queue/errors/queue-binding-not-found.error.d.ts

@@ -0,0 +1,12 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * QueueBindingNotFoundError
+ *
+ * Thrown when attempting to access a Cloudflare Queue binding that hasn't been configured.
+ * This typically indicates that the queue binding is missing from wrangler.jsonc
+ * or the environment variables are not properly set.
+ */
+export declare class QueueBindingNotFoundError extends ApplicationError {
+    constructor(queueName: string, bindingName: string);
+}
+//# sourceMappingURL=queue-binding-not-found.error.d.ts.map

package/dist/queue/errors/queue-binding-not-found.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-binding-not-found.error.d.ts","sourceRoot":"","sources":["../../../src/queue/errors/queue-binding-not-found.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;;GAMG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;gBACjD,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAOnD"}

package/dist/queue/errors/queue-binding-not-found.error.js

@@ -0,0 +1,15 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * QueueBindingNotFoundError
+ *
+ * Thrown when attempting to access a Cloudflare Queue binding that hasn't been configured.
+ * This typically indicates that the queue binding is missing from wrangler.jsonc
+ * or the environment variables are not properly set.
+ */
+export class QueueBindingNotFoundError extends ApplicationError {
+    constructor(queueName, bindingName) {
+        super('errors.queueBindingNotFound', ERROR_CODES.SYSTEM.QUEUE_BINDING_NOT_FOUND, { queueName, bindingName });
+    }
+}
+//# sourceMappingURL=queue-binding-not-found.error.js.map

package/dist/queue/errors/queue-binding-not-found.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-binding-not-found.error.js","sourceRoot":"","sources":["../../../src/queue/errors/queue-binding-not-found.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;;GAMG;AACH,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAC7D,YAAY,SAAiB,EAAE,WAAmB;QAChD,KAAK,CACH,6BAA6B,EAC7B,WAAW,CAAC,MAAM,CAAC,uBAAuB,EAC1C,EAAE,SAAS,EAAE,WAAW,EAAE,CAC3B,CAAA;IACH,CAAC;CACF"}

package/dist/queue/errors/queue-provider-not-supported.error.d.ts

@@ -0,0 +1,13 @@
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * QueueProviderNotSupportedError
+ *
+ * Thrown when attempting to use a queue provider that is not supported.
+ * Valid providers are: 'cloudflare', 'sync'
+ *
+ * This typically indicates an invalid QUEUE_PROVIDER environment variable.
+ */
+export declare class QueueProviderNotSupportedError extends ApplicationError {
+    constructor(provider: string);
+}
+//# sourceMappingURL=queue-provider-not-supported.error.d.ts.map

package/dist/queue/errors/queue-provider-not-supported.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-provider-not-supported.error.d.ts","sourceRoot":"","sources":["../../../src/queue/errors/queue-provider-not-supported.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;;;GAOG;AACH,qBAAa,8BAA+B,SAAQ,gBAAgB;gBACtD,QAAQ,EAAE,MAAM;CAO7B"}

package/dist/queue/errors/queue-provider-not-supported.error.js

@@ -0,0 +1,16 @@
+import { ERROR_CODES } from '../../errors';
+import { ApplicationError } from '../../infrastructure/error-handler';
+/**
+ * QueueProviderNotSupportedError
+ *
+ * Thrown when attempting to use a queue provider that is not supported.
+ * Valid providers are: 'cloudflare', 'sync'
+ *
+ * This typically indicates an invalid QUEUE_PROVIDER environment variable.
+ */
+export class QueueProviderNotSupportedError extends ApplicationError {
+    constructor(provider) {
+        super('errors.queueProviderNotSupported', ERROR_CODES.SYSTEM.QUEUE_PROVIDER_NOT_SUPPORTED, { provider });
+    }
+}
+//# sourceMappingURL=queue-provider-not-supported.error.js.map

package/dist/queue/errors/queue-provider-not-supported.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-provider-not-supported.error.js","sourceRoot":"","sources":["../../../src/queue/errors/queue-provider-not-supported.error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAErE;;;;;;;GAOG;AACH,MAAM,OAAO,8BAA+B,SAAQ,gBAAgB;IAClE,YAAY,QAAgB;QAC1B,KAAK,CACH,kCAAkC,EAClC,WAAW,CAAC,MAAM,CAAC,4BAA4B,EAC/C,EAAE,QAAQ,EAAE,CACb,CAAA;IACH,CAAC;CACF"}

package/dist/queue/index.d.ts

@@ -0,0 +1,14 @@
+export * from './queue-consumer';
+export * from './queue-manager';
+export * from './consumer-registry';
+export * from './queue-name';
+export * from './queue-sender.interface';
+export * from './queue-sender';
+export * from './queue-registry';
+export * from './decorators';
+export * from './queue.module';
+export * from './queue.tokens';
+export * from './providers';
+export * from './services';
+export * from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/queue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAGhC,cAAc,cAAc,CAAA;AAG5B,cAAc,gBAAgB,CAAA;AAG9B,cAAc,gBAAgB,CAAA;AAG9B,cAAc,aAAa,CAAA;AAG3B,cAAc,YAAY,CAAA;AAG1B,cAAc,UAAU,CAAA"}

package/dist/queue/index.js

@@ -0,0 +1,21 @@
+// Core exports
+export * from './queue-consumer';
+export * from './queue-manager';
+export * from './consumer-registry';
+export * from './queue-name';
+export * from './queue-sender.interface';
+export * from './queue-sender';
+export * from './queue-registry';
+// Decorators
+export * from './decorators';
+// Module export
+export * from './queue.module';
+// Tokens
+export * from './queue.tokens';
+// Providers
+export * from './providers';
+// Services
+export * from './services';
+// Errors
+export * from './errors';
+//# sourceMappingURL=index.js.map

package/dist/queue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/queue/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAEhC,aAAa;AACb,cAAc,cAAc,CAAA;AAE5B,gBAAgB;AAChB,cAAc,gBAAgB,CAAA;AAE9B,SAAS;AACT,cAAc,gBAAgB,CAAA;AAE9B,YAAY;AACZ,cAAc,aAAa,CAAA;AAE3B,WAAW;AACX,cAAc,YAAY,CAAA;AAE1B,SAAS;AACT,cAAc,UAAU,CAAA"}

package/dist/queue/providers/cloudflare-queue.provider.d.ts

@@ -0,0 +1,42 @@
+import { type StratalEnv } from '../../env';
+import type { QueueMessage } from '../queue-consumer';
+import type { IQueueProvider } from './queue-provider.interface';
+/**
+ * Cloudflare Queue Provider
+ *
+ * Sends messages to Cloudflare Queues by resolving bindings from the environment.
+ * Used in production environments where Cloudflare Workers handle queue processing.
+ *
+ * **Binding Resolution:**
+ * Queue names are converted to binding names:
+ * - `notifications-queue` → `NOTIFICATIONS_QUEUE`
+ *
+ * @example
+ * ```typescript
+ * const provider = new CloudflareQueueProvider(env)
+ * await provider.send('notifications-queue', message)
+ * ```
+ */
+export declare class CloudflareQueueProvider implements IQueueProvider {
+    private readonly env;
+    constructor(env: StratalEnv);
+    /**
+     * Send a message to a Cloudflare Queue
+     *
+     * @param queueName - Queue name (e.g., 'notifications-queue')
+     * @param message - Complete message with id, timestamp, and payload
+     * @throws {QueueBindingNotFoundError} If queue binding is not configured
+     */
+    send<T>(queueName: string, message: QueueMessage<T>): Promise<void>;
+    /**
+     * Resolve queue binding from Cloudflare environment
+     *
+     * Converts kebab-case queue name to UPPER_SNAKE_CASE binding name.
+     *
+     * @param queueName - Queue name (e.g., 'notifications-queue')
+     * @returns Cloudflare Queue binding
+     * @throws {QueueBindingNotFoundError} If binding not found in env
+     */
+    private getQueue;
+}
+//# sourceMappingURL=cloudflare-queue.provider.d.ts.map

package/dist/queue/providers/cloudflare-queue.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-queue.provider.d.ts","sourceRoot":"","sources":["../../../src/queue/providers/cloudflare-queue.provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAI3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,qBACa,uBAAwB,YAAW,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,UAAU;IAGnE;;;;;;OAMG;IACG,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ;CAUjB"}

package/dist/queue/providers/cloudflare-queue.provider.js

@@ -0,0 +1,73 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject } from 'tsyringe';
+import { Transient } from '../../di/decorators';
+import { DI_TOKENS } from '../../di/tokens';
+import { QueueBindingNotFoundError } from '../errors';
+/**
+ * Cloudflare Queue Provider
+ *
+ * Sends messages to Cloudflare Queues by resolving bindings from the environment.
+ * Used in production environments where Cloudflare Workers handle queue processing.
+ *
+ * **Binding Resolution:**
+ * Queue names are converted to binding names:
+ * - `notifications-queue` → `NOTIFICATIONS_QUEUE`
+ *
+ * @example
+ * ```typescript
+ * const provider = new CloudflareQueueProvider(env)
+ * await provider.send('notifications-queue', message)
+ * ```
+ */
+let CloudflareQueueProvider = class CloudflareQueueProvider {
+    env;
+    constructor(env) {
+        this.env = env;
+    }
+    /**
+     * Send a message to a Cloudflare Queue
+     *
+     * @param queueName - Queue name (e.g., 'notifications-queue')
+     * @param message - Complete message with id, timestamp, and payload
+     * @throws {QueueBindingNotFoundError} If queue binding is not configured
+     */
+    async send(queueName, message) {
+        const queue = this.getQueue(queueName);
+        await queue.send(message);
+    }
+    /**
+     * Resolve queue binding from Cloudflare environment
+     *
+     * Converts kebab-case queue name to UPPER_SNAKE_CASE binding name.
+     *
+     * @param queueName - Queue name (e.g., 'notifications-queue')
+     * @returns Cloudflare Queue binding
+     * @throws {QueueBindingNotFoundError} If binding not found in env
+     */
+    getQueue(queueName) {
+        const bindingName = queueName.toUpperCase().replace(/-/g, '_');
+        const queue = this.env[bindingName];
+        if (!queue) {
+            throw new QueueBindingNotFoundError(queueName, bindingName);
+        }
+        return queue;
+    }
+};
+CloudflareQueueProvider = __decorate([
+    Transient(),
+    __param(0, inject(DI_TOKENS.CloudflareEnv)),
+    __metadata("design:paramtypes", [Object])
+], CloudflareQueueProvider);
+export { CloudflareQueueProvider };
+//# sourceMappingURL=cloudflare-queue.provider.js.map

package/dist/queue/providers/cloudflare-queue.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudflare-queue.provider.js","sourceRoot":"","sources":["../../../src/queue/providers/cloudflare-queue.provider.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,WAAW,CAAA;AAIrD;;;;;;;;;;;;;;;GAeG;AAEI,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAEkB;IADpD,YACoD,GAAe;QAAf,QAAG,GAAH,GAAG,CAAY;IAC/D,CAAC;IAEL;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAI,SAAiB,EAAE,OAAwB;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;QACtC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACK,QAAQ,CAAC,SAAiB;QAChC,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;QAC9D,MAAM,KAAK,GAAI,IAAI,CAAC,GAA0C,CAAC,WAAW,CAAsB,CAAA;QAEhG,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,yBAAyB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;QAC7D,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;CACF,CAAA;AApCY,uBAAuB;IADnC,SAAS,EAAE;IAGP,WAAA,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAA;;GAFvB,uBAAuB,CAoCnC"}

package/dist/queue/providers/index.d.ts

@@ -0,0 +1,4 @@
+export * from './queue-provider.interface';
+export * from './cloudflare-queue.provider';
+export * from './sync-queue.provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/queue/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/queue/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA"}

package/dist/queue/providers/index.js

@@ -0,0 +1,4 @@
+export * from './queue-provider.interface';
+export * from './cloudflare-queue.provider';
+export * from './sync-queue.provider';
+//# sourceMappingURL=index.js.map

package/dist/queue/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/queue/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,uBAAuB,CAAA"}

package/dist/queue/providers/queue-provider.interface.d.ts

@@ -0,0 +1,34 @@
+import type { QueueMessage } from '../queue-consumer';
+/**
+ * Queue Provider Interface
+ *
+ * Defines the contract for queue providers. Each provider handles
+ * the actual message delivery mechanism.
+ *
+ * **Available Providers:**
+ * - `cloudflare`: Uses Cloudflare Queue bindings (production)
+ * - `sync`: Processes messages immediately (testing/development)
+ *
+ * @example Implementing a custom provider
+ * ```typescript
+ * export class CustomQueueProvider implements IQueueProvider {
+ *   async send<T>(queueName: string, message: QueueMessage<T>): Promise<void> {
+ *     // Custom implementation
+ *   }
+ * }
+ * ```
+ */
+export interface IQueueProvider {
+    /**
+     * Send a message to a queue
+     *
+     * Provider handles the actual delivery mechanism:
+     * - CloudflareQueueProvider: Resolves CF binding and calls queue.send()
+     * - SyncQueueProvider: Finds matching consumers and calls handle() directly
+     *
+     * @param queueName - Queue name
+     * @param message - Complete message with id, timestamp, and metadata
+     */
+    send<T>(queueName: string, message: QueueMessage<T>): Promise<void>;
+}
+//# sourceMappingURL=queue-provider.interface.d.ts.map

package/dist/queue/providers/queue-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-provider.interface.d.ts","sourceRoot":"","sources":["../../../src/queue/providers/queue-provider.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;OASG;IACH,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpE"}

package/dist/queue/providers/queue-provider.interface.js

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

package/dist/queue/providers/queue-provider.interface.js.map

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

package/dist/queue/providers/sync-queue.provider.d.ts

@@ -0,0 +1,48 @@
+import { ConsumerRegistry } from '../consumer-registry';
+import type { QueueMessage } from '../queue-consumer';
+import type { IQueueProvider } from './queue-provider.interface';
+/**
+ * Sync Queue Provider
+ *
+ * Processes messages immediately by finding matching consumers and calling
+ * their handle() method directly. Used for testing and development where
+ * real queue infrastructure is not available.
+ *
+ * **Behavior:**
+ * - Messages are processed synchronously when send() is called
+ * - Matching consumers are found via ConsumerRegistry by message type
+ * - All matching consumers are called sequentially
+ * - Errors are re-thrown after onError() is called (fail-fast for testing)
+ *
+ * **Consumer Matching:**
+ * - Consumers are matched by message type, not queue name
+ * - Wildcard ('*') matches all message types
+ *
+ * @example Testing with sync provider
+ * ```typescript
+ * const provider = new SyncQueueProvider(registry)
+ * await provider.send('notifications-queue', {
+ *   id: '123',
+ *   timestamp: Date.now(),
+ *   type: 'email.send',
+ *   payload: { to: 'test@example.com' }
+ * })
+ * // Consumer's handle() is called immediately!
+ * ```
+ */
+export declare class SyncQueueProvider implements IQueueProvider {
+    private readonly registry;
+    constructor(registry: ConsumerRegistry);
+    /**
+     * Process a message synchronously
+     *
+     * Finds all matching consumers by message type and calls their handle() method.
+     * If any consumer throws, onError() is called and the error is re-thrown.
+     *
+     * @param _queueName - Queue name (not used for routing, consumers match by message type)
+     * @param message - Complete message with id, timestamp, and payload
+     * @throws Re-throws any error from consumer.handle() after calling onError()
+     */
+    send<T>(_queueName: string, message: QueueMessage<T>): Promise<void>;
+}
+//# sourceMappingURL=sync-queue.provider.d.ts.map

package/dist/queue/providers/sync-queue.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-queue.provider.d.ts","sourceRoot":"","sources":["../../../src/queue/providers/sync-queue.provider.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBACa,iBAAkB,YAAW,cAAc;IAEhB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,gBAAgB;IAGjF;;;;;;;;;OASG;IACG,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAuB3E"}

package/dist/queue/providers/sync-queue.provider.js

@@ -0,0 +1,89 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject } from 'tsyringe';
+import { Transient } from '../../di/decorators';
+import { DI_TOKENS } from '../../di/tokens';
+import { ConsumerRegistry } from '../consumer-registry';
+/**
+ * Sync Queue Provider
+ *
+ * Processes messages immediately by finding matching consumers and calling
+ * their handle() method directly. Used for testing and development where
+ * real queue infrastructure is not available.
+ *
+ * **Behavior:**
+ * - Messages are processed synchronously when send() is called
+ * - Matching consumers are found via ConsumerRegistry by message type
+ * - All matching consumers are called sequentially
+ * - Errors are re-thrown after onError() is called (fail-fast for testing)
+ *
+ * **Consumer Matching:**
+ * - Consumers are matched by message type, not queue name
+ * - Wildcard ('*') matches all message types
+ *
+ * @example Testing with sync provider
+ * ```typescript
+ * const provider = new SyncQueueProvider(registry)
+ * await provider.send('notifications-queue', {
+ *   id: '123',
+ *   timestamp: Date.now(),
+ *   type: 'email.send',
+ *   payload: { to: 'test@example.com' }
+ * })
+ * // Consumer's handle() is called immediately!
+ * ```
+ */
+let SyncQueueProvider = class SyncQueueProvider {
+    registry;
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Process a message synchronously
+     *
+     * Finds all matching consumers by message type and calls their handle() method.
+     * If any consumer throws, onError() is called and the error is re-thrown.
+     *
+     * @param _queueName - Queue name (not used for routing, consumers match by message type)
+     * @param message - Complete message with id, timestamp, and payload
+     * @throws Re-throws any error from consumer.handle() after calling onError()
+     */
+    async send(_queueName, message) {
+        // Consumers are matched by message type, not queue name
+        const consumers = this.registry.getConsumers(message.type);
+        // Process synchronously - call each matching consumer
+        for (const consumer of consumers) {
+            try {
+                await consumer.handle(message);
+            }
+            catch (error) {
+                const errorInstance = error instanceof Error
+                    ? error
+                    : new Error(String(error));
+                // Call onError hook if defined
+                if (consumer.onError) {
+                    await consumer.onError(errorInstance, message);
+                }
+                // Re-throw for fail-fast behavior in tests
+                throw errorInstance;
+            }
+        }
+    }
+};
+SyncQueueProvider = __decorate([
+    Transient(),
+    __param(0, inject(DI_TOKENS.ConsumerRegistry)),
+    __metadata("design:paramtypes", [ConsumerRegistry])
+], SyncQueueProvider);
+export { SyncQueueProvider };
+//# sourceMappingURL=sync-queue.provider.js.map

package/dist/queue/providers/sync-queue.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-queue.provider.js","sourceRoot":"","sources":["../../../src/queue/providers/sync-queue.provider.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAIvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEI,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAE2B;IADvD,YACuD,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAC9E,CAAC;IAEJ;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,CAAI,UAAkB,EAAE,OAAwB;QACxD,wDAAwD;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAE1D,sDAAsD;QACtD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAChC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,aAAa,GAAG,KAAK,YAAY,KAAK;oBAC1C,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;gBAE5B,+BAA+B;gBAC/B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACrB,MAAM,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;gBAChD,CAAC;gBAED,2CAA2C;gBAC3C,MAAM,aAAa,CAAA;YACrB,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA;AAtCY,iBAAiB;IAD7B,SAAS,EAAE;IAGP,WAAA,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;qCAA4B,gBAAgB;GAFtE,iBAAiB,CAsC7B"}

package/dist/queue/queue-consumer.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Queue message structure
+ *
+ * All messages dispatched to queues follow this structure.
+ * The `id` and `timestamp` are auto-generated by QueueSender.
+ */
+export interface QueueMessage<T = unknown> {
+    /** Unique message identifier (UUID) */
+    id: string;
+    /** Timestamp when message was dispatched (milliseconds since epoch) */
+    timestamp: number;
+    /** Message type for routing to consumers */
+    type: string;
+    /** Optional tenant ID for multi-tenant context */
+    tenantId?: string;
+    /** Message payload */
+    payload: T;
+    /** Optional metadata including locale for i18n */
+    metadata?: {
+        locale?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Queue consumer interface
+ *
+ * Consumers handle messages based on their `messageTypes` declaration.
+ * A consumer receives messages of the declared types from ANY queue.
+ *
+ * @example
+ * ```typescript
+ * @Transient()
+ * export class EmailConsumer implements IQueueConsumer<SendEmailInput> {
+ *   readonly messageTypes = ['email.send', 'email.batch.send']
+ *
+ *   async handle(message: QueueMessage<SendEmailInput>): Promise<void> {
+ *     // Process email...
+ *   }
+ * }
+ * ```
+ */
+export interface IQueueConsumer<T = unknown> {
+    /**
+     * Message types this consumer handles.
+     *
+     * The consumer receives messages matching these types from ANY queue.
+     * Use '*' to match all message types (wildcard consumer).
+     */
+    readonly messageTypes: string[];
+    /**
+     * Handle an incoming message
+     *
+     * @param message - The queue message to process
+     */
+    handle(message: QueueMessage<T>): Promise<void>;
+    /**
+     * Optional error handler for failed message processing
+     *
+     * @param error - The error that occurred
+     * @param message - The message that failed to process
+     */
+    onError?(error: Error, message: QueueMessage<T>): Promise<void>;
+}
+//# sourceMappingURL=queue-consumer.d.ts.map

package/dist/queue/queue-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-consumer.d.ts","sourceRoot":"","sources":["../../src/queue/queue-consumer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAA;IACV,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAA;IACjB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,sBAAsB;IACtB,OAAO,EAAE,CAAC,CAAA;IACV,kDAAkD;IAClD,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAA;IAE/B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/C;;;;;OAKG;IACH,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE"}

package/dist/queue/queue-consumer.js

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

package/dist/queue/queue-consumer.js.map

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