stratal 0.0.12 → 0.0.14

package/dist/queue/queue-manager.js

@@ -1,80 +0,0 @@
-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';
-/**
- * Queue Manager
- *
- * Singleton service for processing queue message batches.
- * Routes messages to consumers based on message type.
- *
- * **Message Routing:**
- * - Consumers declare message types they handle (e.g., ['email.send'])
- * - When a message arrives, consumers matching the message type are invoked
- * - A consumer can handle messages from ANY queue (routing is by type, not queue)
- *
- * **Note:** For sending messages to queues, use IQueueSender instances
- * obtained via @InjectQueue('queue-name') or module bindings.
- *
- * @example Processing a queue batch
- * ```typescript
- * // In Cloudflare Worker queue handler
- * await queueManager.processBatch('notifications-queue', batch)
- * ```
- */
-let QueueManager = class QueueManager {
-    registry;
-    constructor(registry) {
-        this.registry = registry;
-    }
-    /**
-     * Process a batch of queue messages
-     *
-     * Routes messages to registered consumers based on message type.
-     * Uses ConsumerRegistry to find matching consumers.
-     *
-     * @param _queueName - Name of the queue (for logging, not used for routing)
-     * @param batch - Batch of messages from Cloudflare Queue
-     */
-    async processBatch(_queueName, batch) {
-        for (const message of batch.messages) {
-            const queueMessage = message.body;
-            // Find consumers by message type (not by queue name)
-            const consumers = this.registry.getConsumers(queueMessage.type);
-            for (const consumer of consumers) {
-                try {
-                    await consumer.handle(queueMessage);
-                    message.ack();
-                }
-                catch (error) {
-                    const errorInstance = error instanceof Error
-                        ? error
-                        : new Error(String(error));
-                    if (consumer.onError) {
-                        await consumer.onError(errorInstance, queueMessage);
-                    }
-                    message.retry();
-                }
-            }
-        }
-    }
-};
-QueueManager = __decorate([
-    Transient(DI_TOKENS.Queue),
-    __param(0, inject(DI_TOKENS.ConsumerRegistry)),
-    __metadata("design:paramtypes", [ConsumerRegistry])
-], QueueManager);
-export { QueueManager };
-//# sourceMappingURL=queue-manager.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"queue-manager.js","sourceRoot":"","sources":["../../src/queue/queue-manager.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAGtD;;;;;;;;;;;;;;;;;;;GAmBG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAY;IAEgC;IADvD,YACuD,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAC9E,CAAC;IAEJ;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,KAAmB;QACxD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAoB,CAAA;YAEjD,qDAAqD;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;YAE/D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC;oBACH,MAAM,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;oBACnC,OAAO,CAAC,GAAG,EAAE,CAAA;gBACf,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,aAAa,GAAG,KAAK,YAAY,KAAK;wBAC1C,CAAC,CAAC,KAAK;wBACP,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;oBAE5B,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;wBACrB,MAAM,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;oBACrD,CAAC;oBACD,OAAO,CAAC,KAAK,EAAE,CAAA;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA;AAtCY,YAAY;IADxB,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;IAGtB,WAAA,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;qCAA4B,gBAAgB;GAFtE,YAAY,CAsCxB"}

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

@@ -1,50 +0,0 @@
-/**
- * Queue Name Type System with Module Augmentation
- *
- * This file provides a type-safe queue naming system using module augmentation.
- * Applications augment the QueueNames interface to get autocomplete for queue names.
- *
- * @example In apps/backend/src/types/queues.ts:
- * ```typescript
- * declare module 'stratal' {
- *   interface QueueNames {
- *     'notifications-queue': true
- *     'batch-notifications-queue': true
- *   }
- * }
- * ```
- *
- * When QueueNames is augmented, QueueName provides autocomplete.
- * When not augmented, QueueName falls back to string for flexibility.
- */
-/**
- * Augmentable interface for queue names.
- *
- * Applications extend this interface via module augmentation to define
- * their queue names. The keys become the valid queue name union type.
- *
- * @example
- * ```typescript
- * // In your application's type declarations
- * declare module 'stratal' {
- *   interface QueueNames {
- *     'notifications-queue': true
- *     'batch-notifications-queue': true
- *   }
- * }
- * ```
- */
-export interface QueueNames {
-}
-/**
- * Queue name type - extracts keys from QueueNames or falls back to string.
- *
- * When QueueNames is augmented with queue name keys, this type provides:
- * - Type safety: Only declared queue names are valid
- * - Autocomplete: IDE suggestions for available queue names
- *
- * When QueueNames is empty (not augmented), falls back to string
- * for flexibility during development or in non-typed contexts.
- */
-export type QueueName = keyof QueueNames extends never ? string : keyof QueueNames;
-//# sourceMappingURL=queue-name.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"queue-name.d.ts","sourceRoot":"","sources":["../../src/queue/queue-name.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;CAAI;AAE/B;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,UAAU,SAAS,KAAK,GAAG,MAAM,GAAG,MAAM,UAAU,CAAA"}

package/dist/queue/queue-name.js

@@ -1,21 +0,0 @@
-/**
- * Queue Name Type System with Module Augmentation
- *
- * This file provides a type-safe queue naming system using module augmentation.
- * Applications augment the QueueNames interface to get autocomplete for queue names.
- *
- * @example In apps/backend/src/types/queues.ts:
- * ```typescript
- * declare module 'stratal' {
- *   interface QueueNames {
- *     'notifications-queue': true
- *     'batch-notifications-queue': true
- *   }
- * }
- * ```
- *
- * When QueueNames is augmented, QueueName provides autocomplete.
- * When not augmented, QueueName falls back to string for flexibility.
- */
-export {};
-//# sourceMappingURL=queue-name.js.map

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

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

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

@@ -1,46 +0,0 @@
-import type { II18nService } from '../i18n/i18n.types';
-import type { IQueueSender } from './queue-sender.interface';
-import { QueueProviderFactory } from './services';
-/**
- * Queue Registry
- *
- * Request-scoped factory service for creating QueueSender instances.
- * Caches senders per queue name within the request scope.
- *
- * This service is used internally by QueueModule.registerQueue() to provide
- * IQueueSender instances for each registered queue.
- *
- * **Why request-scoped?**
- * - Needs access to I18nService for locale-aware message metadata
- * - Provider is created once per request for consistency
- * - Queue senders are cached per request to avoid recreating them
- *
- * @example
- * ```typescript
- * // Used internally by QueueModule.registerQueue()
- * QueueModule.registerQueue('notifications-queue')
- *
- * // The module creates a factory provider:
- * {
- *   provide: 'notifications-queue',
- *   useFactory: (registry: QueueRegistry) => registry.getQueue('notifications-queue'),
- *   inject: [QUEUE_TOKENS.QueueRegistry],
- * }
- * ```
- */
-export declare class QueueRegistry {
-    private readonly i18n;
-    private readonly provider;
-    private readonly senders;
-    constructor(providerFactory: QueueProviderFactory, i18n: II18nService);
-    /**
-     * Get or create a QueueSender for the specified queue name.
-     *
-     * Senders are cached per queue name within the request scope.
-     *
-     * @param queueName - The queue name to get a sender for
-     * @returns QueueSender bound to the specified queue
-     */
-    getQueue(queueName: string): IQueueSender;
-}
-//# sourceMappingURL=queue-registry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"queue-registry.d.ts","sourceRoot":"","sources":["../../src/queue/queue-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,aAAa;IAMW,OAAO,CAAC,QAAQ,CAAC,IAAI;IALxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAGb,eAAe,EAAE,oBAAoB,EAC9B,IAAI,EAAE,YAAY;IAKtE;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY;CAU1C"}

package/dist/queue/queue-registry.js

@@ -1,78 +0,0 @@
-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 { I18N_TOKENS } from '../i18n/i18n.tokens';
-import { QueueSender } from './queue-sender';
-import { QUEUE_TOKENS } from './queue.tokens';
-import { QueueProviderFactory } from './services';
-/**
- * Queue Registry
- *
- * Request-scoped factory service for creating QueueSender instances.
- * Caches senders per queue name within the request scope.
- *
- * This service is used internally by QueueModule.registerQueue() to provide
- * IQueueSender instances for each registered queue.
- *
- * **Why request-scoped?**
- * - Needs access to I18nService for locale-aware message metadata
- * - Provider is created once per request for consistency
- * - Queue senders are cached per request to avoid recreating them
- *
- * @example
- * ```typescript
- * // Used internally by QueueModule.registerQueue()
- * QueueModule.registerQueue('notifications-queue')
- *
- * // The module creates a factory provider:
- * {
- *   provide: 'notifications-queue',
- *   useFactory: (registry: QueueRegistry) => registry.getQueue('notifications-queue'),
- *   inject: [QUEUE_TOKENS.QueueRegistry],
- * }
- * ```
- */
-let QueueRegistry = class QueueRegistry {
-    i18n;
-    provider;
-    senders = new Map();
-    constructor(providerFactory, i18n) {
-        this.i18n = i18n;
-        this.provider = providerFactory.create();
-    }
-    /**
-     * Get or create a QueueSender for the specified queue name.
-     *
-     * Senders are cached per queue name within the request scope.
-     *
-     * @param queueName - The queue name to get a sender for
-     * @returns QueueSender bound to the specified queue
-     */
-    getQueue(queueName) {
-        let sender = this.senders.get(queueName);
-        if (!sender) {
-            sender = new QueueSender(queueName, this.provider, this.i18n);
-            this.senders.set(queueName, sender);
-        }
-        return sender;
-    }
-};
-QueueRegistry = __decorate([
-    Transient(QUEUE_TOKENS.QueueRegistry),
-    __param(0, inject(QUEUE_TOKENS.QueueProviderFactory)),
-    __param(1, inject(I18N_TOKENS.I18nService)),
-    __metadata("design:paramtypes", [QueueProviderFactory, Object])
-], QueueRegistry);
-export { QueueRegistry };
-//# sourceMappingURL=queue-registry.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"queue-registry.js","sourceRoot":"","sources":["../../src/queue/queue-registry.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAIjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEI,IAAM,aAAa,GAAnB,MAAM,aAAa;IAM4B;IALnC,QAAQ,CAAgB;IACxB,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAA;IAE1D,YAC6C,eAAqC,EAC9B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;QAEpE,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,CAAA;IAC1C,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAiB;QACxB,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAExC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;YAC7D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;QACrC,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;CACF,CAAA;AA7BY,aAAa;IADzB,SAAS,CAAC,YAAY,CAAC,aAAa,CAAC;IAMjC,WAAA,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAA;IACzC,WAAA,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;qCAD4B,oBAAoB;GALvE,aAAa,CA6BzB"}

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

@@ -1,38 +0,0 @@
-import type { II18nService } from '../i18n/i18n.types';
-import type { IQueueProvider } from './providers';
-import type { DispatchMessage, IQueueSender } from './queue-sender.interface';
-/**
- * Queue Sender
- *
- * Implementation of IQueueSender bound to a specific queue name.
- * Created by QueueRegistry for each registered queue.
- *
- * Automatically enriches messages with:
- * - `id`: UUID generated via crypto.randomUUID()
- * - `timestamp`: Current time in milliseconds
- * - `metadata.locale`: Current locale from I18n context
- *
- * @example
- * ```typescript
- * // Created by QueueRegistry, not directly instantiated
- * const sender = registry.getQueue('notifications-queue')
- *
- * await sender.dispatch({
- *   type: 'email.send',
- *   payload: { to: 'user@example.com', subject: 'Hello' }
- * })
- * ```
- */
-export declare class QueueSender implements IQueueSender {
-    private readonly queueName;
-    private readonly provider;
-    private readonly i18n;
-    constructor(queueName: string, provider: IQueueProvider, i18n: II18nService);
-    /**
-     * Dispatch a message to this queue.
-     *
-     * @param message - Message to dispatch (without id/timestamp)
-     */
-    dispatch<T>(message: DispatchMessage<T>): Promise<void>;
-}
-//# sourceMappingURL=queue-sender.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"queue-sender.d.ts","sourceRoot":"","sources":["../../src/queue/queue-sender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE7E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,WAAY,YAAW,YAAY;IAE5C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,YAAY;IAGrC;;;;OAIG;IACG,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB9D"}

package/dist/queue/queue-sender.interface.d.ts

@@ -1,46 +0,0 @@
-import type { QueueMessage } from './queue-consumer';
-/**
- * Message input for queue dispatch (without auto-generated fields)
- *
- * When dispatching a message, the id and timestamp are auto-generated.
- * You only need to provide the type, payload, and optional metadata.
- */
-export type DispatchMessage<T = unknown> = Omit<QueueMessage<T>, 'id' | 'timestamp'>;
-/**
- * Queue sender interface for dispatching messages to a queue.
- *
- * Each IQueueSender instance is bound to a specific queue name.
- * Messages are dispatched with auto-generated id, timestamp, and locale metadata.
- *
- * @example
- * ```typescript
- * // Injected via @InjectQueue or token binding
- * constructor(
- *   @InjectQueue('notifications-queue') private queue: IQueueSender
- * ) {}
- *
- * // Dispatch a message
- * await this.queue.dispatch({
- *   type: 'email.send',
- *   payload: {
- *     to: 'user@example.com',
- *     subject: 'Welcome',
- *     html: '<h1>Hello!</h1>'
- *   }
- * })
- * ```
- */
-export interface IQueueSender {
-    /**
-     * Dispatch a message to this queue.
-     *
-     * Auto-adds:
-     * - `id`: Unique message identifier (UUID)
-     * - `timestamp`: Current timestamp in milliseconds
-     * - `metadata.locale`: Current locale from i18n context
-     *
-     * @param message - Message to dispatch (without id/timestamp)
-     */
-    dispatch<T>(message: DispatchMessage<T>): Promise<void>;
-}
-//# sourceMappingURL=queue-sender.interface.d.ts.map

package/dist/queue/queue-sender.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue-sender.interface.d.ts","sourceRoot":"","sources":["../../src/queue/queue-sender.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,CAAA;AAEpF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;OASG;IACH,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxD"}

package/dist/queue/queue-sender.interface.js

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

package/dist/queue/queue-sender.interface.js.map

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

package/dist/queue/queue-sender.js

@@ -1,54 +0,0 @@
-/**
- * Queue Sender
- *
- * Implementation of IQueueSender bound to a specific queue name.
- * Created by QueueRegistry for each registered queue.
- *
- * Automatically enriches messages with:
- * - `id`: UUID generated via crypto.randomUUID()
- * - `timestamp`: Current time in milliseconds
- * - `metadata.locale`: Current locale from I18n context
- *
- * @example
- * ```typescript
- * // Created by QueueRegistry, not directly instantiated
- * const sender = registry.getQueue('notifications-queue')
- *
- * await sender.dispatch({
- *   type: 'email.send',
- *   payload: { to: 'user@example.com', subject: 'Hello' }
- * })
- * ```
- */
-export class QueueSender {
-    queueName;
-    provider;
-    i18n;
-    constructor(queueName, provider, i18n) {
-        this.queueName = queueName;
-        this.provider = provider;
-        this.i18n = i18n;
-    }
-    /**
-     * Dispatch a message to this queue.
-     *
-     * @param message - Message to dispatch (without id/timestamp)
-     */
-    async dispatch(message) {
-        const metadata = { ...message.metadata };
-        if (!metadata.locale) {
-            const locale = this.i18n.getLocale();
-            if (locale) {
-                metadata.locale = locale;
-            }
-        }
-        const fullMessage = {
-            id: crypto.randomUUID(),
-            timestamp: Date.now(),
-            ...message,
-            metadata: Object.keys(metadata).length > 0 ? metadata : undefined
-        };
-        await this.provider.send(this.queueName, fullMessage);
-    }
-}
-//# sourceMappingURL=queue-sender.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"queue-sender.js","sourceRoot":"","sources":["../../src/queue/queue-sender.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,WAAW;IAEH;IACA;IACA;IAHnB,YACmB,SAAiB,EACjB,QAAwB,EACxB,IAAkB;QAFlB,cAAS,GAAT,SAAS,CAAQ;QACjB,aAAQ,GAAR,QAAQ,CAAgB;QACxB,SAAI,GAAJ,IAAI,CAAc;IAClC,CAAC;IAEJ;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAI,OAA2B;QAC3C,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAA;QAExC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;YACpC,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAA;YAC1B,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAoB;YACnC,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;YACvB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,GAAG,OAAO;YACV,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SAClE,CAAA;QAED,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;IACvD,CAAC;CACF"}

package/dist/queue/queue.module.d.ts

@@ -1,80 +0,0 @@
-/**
- * Queue Module
- *
- * Provides declarative queue infrastructure with provider abstraction.
- *
- * **Usage:**
- * ```typescript
- * // 1. Configure provider (once, in app root)
- * QueueModule.forRootAsync({
- *   inject: [CONFIG_TOKENS.ConfigService],
- *   useFactory: (config) => ({ provider: config.get('queue').provider })
- * })
- *
- * // 2. Register queues (queue name IS the injection token)
- * QueueModule.registerQueue('notifications-queue')
- * QueueModule.registerQueue('batch-notifications-queue')
- *
- * // 3. Inject and use
- * constructor(@InjectQueue('notifications-queue') private queue: IQueueSender) {}
- * await this.queue.dispatch({ type: 'email.send', payload: {...} })
- * ```
- *
- * **Providers:**
- * - `cloudflare`: Production provider using Cloudflare Queue bindings
- * - `sync`: Testing provider that processes messages immediately
- */
-import type { AsyncModuleOptions, DynamicModule } from '../module/types';
-import type { QueueName } from './queue-name';
-/**
- * Queue module configuration options
- */
-export interface QueueModuleOptions {
-    /**
-     * Queue provider type
-     * - 'cloudflare': Production provider using Cloudflare Queue bindings
-     * - 'sync': Testing provider that processes messages immediately
-     */
-    provider: 'cloudflare' | 'sync';
-}
-export declare class QueueModule {
-    /**
-     * Configure queue infrastructure with async factory.
-     *
-     * Use when provider configuration depends on other services like ConfigService.
-     *
-     * @param options - Async configuration with factory and inject tokens
-     * @returns Dynamic module with queue infrastructure
-     *
-     * @example
-     * ```typescript
-     * QueueModule.forRootAsync({
-     *   inject: [CONFIG_TOKENS.ConfigService],
-     *   useFactory: (config: IConfigService) => ({
-     *     provider: config.get('queue').provider
-     *   })
-     * })
-     * ```
-     */
-    static forRootAsync(options: AsyncModuleOptions<QueueModuleOptions>): DynamicModule;
-    /**
-     * Register a queue for injection.
-     *
-     * The queue name serves as both the identifier and the DI injection token.
-     * Queue names are typed via module augmentation of QueueNames interface.
-     *
-     * @param name - Queue name (typed with autocomplete if QueueNames is augmented)
-     * @returns Dynamic module that provides the queue sender
-     *
-     * @example
-     * ```typescript
-     * // In AppModule imports
-     * QueueModule.registerQueue('notifications-queue')
-     *
-     * // Then inject using the queue name
-     * constructor(@InjectQueue('notifications-queue') private queue: IQueueSender) {}
-     * ```
-     */
-    static registerQueue(name: QueueName): DynamicModule;
-}
-//# sourceMappingURL=queue.module.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"queue.module.d.ts","sourceRoot":"","sources":["../../src/queue/queue.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAkB,MAAM,iBAAiB,CAAA;AAExF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAM7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,EAAE,YAAY,GAAG,MAAM,CAAA;CAChC;AAED,qBAOa,WAAW;IACtB;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,GAAG,aAAa;IAanF;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,aAAa;CAYrD"}

package/dist/queue/queue.module.js

@@ -1,113 +0,0 @@
-/**
- * Queue Module
- *
- * Provides declarative queue infrastructure with provider abstraction.
- *
- * **Usage:**
- * ```typescript
- * // 1. Configure provider (once, in app root)
- * QueueModule.forRootAsync({
- *   inject: [CONFIG_TOKENS.ConfigService],
- *   useFactory: (config) => ({ provider: config.get('queue').provider })
- * })
- *
- * // 2. Register queues (queue name IS the injection token)
- * QueueModule.registerQueue('notifications-queue')
- * QueueModule.registerQueue('batch-notifications-queue')
- *
- * // 3. Inject and use
- * constructor(@InjectQueue('notifications-queue') private queue: IQueueSender) {}
- * await this.queue.dispatch({ type: 'email.send', payload: {...} })
- * ```
- *
- * **Providers:**
- * - `cloudflare`: Production provider using Cloudflare Queue bindings
- * - `sync`: Testing provider that processes messages immediately
- */
-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 QueueModule_1;
-import { DI_TOKENS } from '../di/tokens';
-import { Scope } from '../di/types';
-import { Module } from '../module';
-import { ConsumerRegistry } from './consumer-registry';
-import { QueueRegistry } from './queue-registry';
-import { QUEUE_TOKENS } from './queue.tokens';
-import { QueueProviderFactory } from './services';
-let QueueModule = QueueModule_1 = class QueueModule {
-    /**
-     * Configure queue infrastructure with async factory.
-     *
-     * Use when provider configuration depends on other services like ConfigService.
-     *
-     * @param options - Async configuration with factory and inject tokens
-     * @returns Dynamic module with queue infrastructure
-     *
-     * @example
-     * ```typescript
-     * QueueModule.forRootAsync({
-     *   inject: [CONFIG_TOKENS.ConfigService],
-     *   useFactory: (config: IConfigService) => ({
-     *     provider: config.get('queue').provider
-     *   })
-     * })
-     * ```
-     */
-    static forRootAsync(options) {
-        return {
-            module: QueueModule_1,
-            providers: [
-                {
-                    provide: QUEUE_TOKENS.QueueModuleOptions,
-                    useFactory: options.useFactory,
-                    inject: options.inject,
-                },
-            ],
-        };
-    }
-    /**
-     * Register a queue for injection.
-     *
-     * The queue name serves as both the identifier and the DI injection token.
-     * Queue names are typed via module augmentation of QueueNames interface.
-     *
-     * @param name - Queue name (typed with autocomplete if QueueNames is augmented)
-     * @returns Dynamic module that provides the queue sender
-     *
-     * @example
-     * ```typescript
-     * // In AppModule imports
-     * QueueModule.registerQueue('notifications-queue')
-     *
-     * // Then inject using the queue name
-     * constructor(@InjectQueue('notifications-queue') private queue: IQueueSender) {}
-     * ```
-     */
-    static registerQueue(name) {
-        return {
-            module: QueueModule_1,
-            providers: [
-                {
-                    provide: name,
-                    useFactory: (registry) => registry.getQueue(name),
-                    inject: [QUEUE_TOKENS.QueueRegistry],
-                },
-            ],
-        };
-    }
-};
-QueueModule = QueueModule_1 = __decorate([
-    Module({
-        providers: [
-            { provide: DI_TOKENS.ConsumerRegistry, useClass: ConsumerRegistry, scope: Scope.Singleton },
-            { provide: QUEUE_TOKENS.QueueProviderFactory, useClass: QueueProviderFactory, scope: Scope.Singleton },
-            { provide: QUEUE_TOKENS.QueueRegistry, useClass: QueueRegistry },
-        ],
-    })
-], QueueModule);
-export { QueueModule };
-//# sourceMappingURL=queue.module.js.map

package/dist/queue/queue.module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.module.js","sourceRoot":"","sources":["../../src/queue/queue.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;;;;;;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAqB1C,IAAM,WAAW,mBAAjB,MAAM,WAAW;IACtB;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,YAAY,CAAC,OAA+C;QACjE,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,YAAY,CAAC,kBAAkB;oBACxC,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB;aACF;SACF,CAAA;IACH,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,aAAa,CAAC,IAAe;QAClC,OAAO;YACL,MAAM,EAAE,aAAW;YACnB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,IAAoC;oBAC7C,UAAU,EAAE,CAAC,QAAuB,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAChE,MAAM,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC;iBACrC;aACF;SACF,CAAA;IACH,CAAC;CACF,CAAA;AA9DY,WAAW;IAPvB,MAAM,CAAC;QACN,SAAS,EAAE;YACT,EAAE,OAAO,EAAE,SAAS,CAAC,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE;YAC3F,EAAE,OAAO,EAAE,YAAY,CAAC,oBAAoB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE;YACtG,EAAE,OAAO,EAAE,YAAY,CAAC,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE;SACjE;KACF,CAAC;GACW,WAAW,CA8DvB"}