@venizia/ignis 0.4.2 → 0.4.4

package/dist/components/mail/component.js

@@ -1,167 +0,0 @@
-"use strict";
-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); }
-};
-var MailComponent_1;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MailComponent = void 0;
-const ignis_kernel_1 = require("@venizia/ignis-kernel");
-const metadata_1 = require("../../base/metadata");
-const common_1 = require("../../common");
-const core_1 = require("@venizia/ignis-helpers/core");
-const common_2 = require("@venizia/ignis-helpers/common");
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const common_3 = require("./common");
-const providers_1 = require("./providers");
-const services_1 = require("./services");
-let MailComponent = MailComponent_1 = class MailComponent extends ignis_kernel_1.BaseComponent {
-    constructor(application) {
-        super({
-            scope: MailComponent_1.name,
-            initDefault: { enable: true, container: application },
-            bindings: {},
-        });
-        this.application = application;
-    }
-    /** `application.component(MailComponent, { options })` lands here; the call site outranks a key bound earlier. */
-    async configure(opts) {
-        // The base short-circuits a second call; binding before that check would swap the options
-        // under a transport that was already built from the first ones.
-        if (this.isConfigured) {
-            return;
-        }
-        if (opts !== undefined) {
-            this.application.bind({ key: common_3.MailKeys.MAIL_OPTIONS }).toValue(opts);
-        }
-        await super.configure(opts);
-    }
-    binding() {
-        if (!this.application.isBound({ key: common_3.MailKeys.MAIL_OPTIONS })) {
-            this.logger
-                .for(this.binding.name)
-                .error('Mail options not configured. Please bind MailKeys.MAIL_OPTIONS before adding MailComponent.');
-            throw (0, core_1.getError)({
-                message: 'Mail options not configured',
-            });
-        }
-        this.initGenerators();
-        this.initProviders();
-        this.initServices();
-        this.createAndBindInstances();
-        this.logger.for(this.binding.name).info('Mail component initialized successfully');
-    }
-    initGenerators() {
-        this.application
-            .bind({ key: common_3.MailKeys.MAIL_VERIFICATION_CODE_GENERATOR })
-            .toClass(services_1.NumericCodeGenerator);
-        this.application
-            .bind({ key: common_3.MailKeys.MAIL_VERIFICATION_TOKEN_GENERATOR })
-            .toClass(services_1.RandomTokenGenerator);
-        this.application
-            .bind({ key: common_3.MailKeys.MAIL_VERIFICATION_DATA_GENERATOR })
-            .toClass(services_1.DefaultVerificationDataGenerator);
-    }
-    initProviders() {
-        this.application
-            .bind({ key: common_3.MailKeys.MAIL_TRANSPORT_PROVIDER })
-            .toProvider(providers_1.MailTransportProvider)
-            .setScope('singleton');
-        this.application
-            .bind({ key: common_3.MailKeys.MAIL_QUEUE_EXECUTOR_PROVIDER })
-            .toProvider(providers_1.MailQueueExecutorProvider)
-            .setScope('singleton');
-    }
-    initServices() {
-        this.application
-            .bind({ key: common_3.MailKeys.MAIL_SERVICE })
-            .toClass(services_1.MailService)
-            .setScope('singleton');
-        this.application
-            .bind({ key: common_3.MailKeys.MAIL_TEMPLATE_ENGINE })
-            .toClass(services_1.TemplateEngineService)
-            .setScope('singleton');
-    }
-    /** A bad limit or root would otherwise surface on every send, as a 400 that blames the caller. */
-    validateAttachmentOptions(opts) {
-        const { attachmentRoot, maxAttachmentBytes } = opts.options;
-        const buildOptionError = (details) => {
-            return (0, core_1.getError)({
-                statusCode: common_2.HTTP.ResultCodes.RS_5.InternalServerError,
-                messageCode: common_3.MailErrorCodes.INVALID_CONFIGURATION,
-                message: `Invalid mail options | ${details.message}`,
-                cause: details.cause,
-            });
-        };
-        const isValidLimit = maxAttachmentBytes === undefined ||
-            (Number.isSafeInteger(maxAttachmentBytes) && maxAttachmentBytes > 0);
-        if (!isValidLimit) {
-            throw buildOptionError({ message: 'maxAttachmentBytes must be a positive integer' });
-        }
-        if (attachmentRoot === undefined) {
-            return;
-        }
-        if (typeof attachmentRoot !== 'string' || !(0, node_path_1.isAbsolute)(attachmentRoot)) {
-            throw buildOptionError({ message: 'attachmentRoot must be an absolute path' });
-        }
-        let isDirectory;
-        try {
-            isDirectory = (0, node_fs_1.statSync)(attachmentRoot).isDirectory();
-        }
-        catch (error) {
-            throw buildOptionError({
-                message: 'attachmentRoot must be an existing directory',
-                cause: error,
-            });
-        }
-        if (!isDirectory) {
-            throw buildOptionError({ message: 'attachmentRoot must be an existing directory' });
-        }
-    }
-    createAndBindInstances() {
-        // Transport
-        const transportGetter = this.application.get({
-            key: common_3.MailKeys.MAIL_TRANSPORT_PROVIDER,
-        });
-        const mailOptions = this.application.get({ key: common_3.MailKeys.MAIL_OPTIONS });
-        this.validateAttachmentOptions({ options: mailOptions });
-        // Only the provider is logged: the options carry SMTP / API credentials, which must never reach a log sink.
-        this.logger
-            .for(this.createAndBindInstances.name)
-            .info('Mail provider: %s', mailOptions.provider);
-        const mailTransportInstance = transportGetter(mailOptions);
-        this.application.bind({ key: common_3.MailKeys.MAIL_TRANSPORT_INSTANCE }).toValue(mailTransportInstance);
-        // Queue
-        const queueGetter = this.application.get({
-            key: common_3.MailKeys.MAIL_QUEUE_EXECUTOR_PROVIDER,
-        });
-        // Queueing is opt-in: with no executor config bound, fall back to the direct (inline) executor instead of a "binding is not bounded" crash at boot.
-        const queueConfig = this.application.get({
-            key: common_3.MailKeys.MAIL_QUEUE_EXECUTOR_CONFIG,
-            isOptional: true,
-        }) ?? { type: common_3.MailQueueExecutorTypes.DIRECT };
-        // Same reason as above: a bullmq config carries the Redis password.
-        this.logger
-            .for(this.createAndBindInstances.name)
-            .info('Mail queue executor type: %s', queueConfig.type);
-        const queueExecutorInstance = queueGetter(queueConfig);
-        this.application
-            .bind({ key: common_3.MailKeys.MAIL_QUEUE_EXECUTOR_INSTANCE })
-            .toValue(queueExecutorInstance);
-    }
-};
-exports.MailComponent = MailComponent;
-exports.MailComponent = MailComponent = MailComponent_1 = __decorate([
-    __param(0, (0, metadata_1.inject)({ key: common_1.CoreBindings.APPLICATION_INSTANCE })),
-    __metadata("design:paramtypes", [Function])
-], MailComponent);
-//# sourceMappingURL=component.js.map

package/dist/components/mail/component.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"component.js","sourceRoot":"","sources":["../../../src/components/mail/component.ts"],"names":[],"mappings":"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","sourcesContent":["import { type BaseApplication } from '@/base/applications';\nimport { BaseComponent } from '@venizia/ignis-kernel';\nimport { inject } from '@/base/metadata';\nimport { CoreBindings } from '@/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { statSync } from 'node:fs';\nimport { isAbsolute } from 'node:path';\nimport type { IMailQueueExecutorConfig, TMailOptions } from './common';\nimport { MailErrorCodes, MailKeys, MailQueueExecutorTypes } from './common';\nimport type { TGetMailQueueExecutorFn, TGetMailTransportFn } from './providers';\nimport { MailQueueExecutorProvider, MailTransportProvider } from './providers';\nimport {\n  DefaultVerificationDataGenerator,\n  MailService,\n  NumericCodeGenerator,\n  RandomTokenGenerator,\n  TemplateEngineService,\n} from './services';\n\nexport class MailComponent extends BaseComponent<TMailOptions> {\n  constructor(\n    @inject({ key: CoreBindings.APPLICATION_INSTANCE }) private application: BaseApplication,\n  ) {\n    super({\n      scope: MailComponent.name,\n      initDefault: { enable: true, container: application },\n      bindings: {},\n    });\n  }\n\n  /** `application.component(MailComponent, { options })` lands here; the call site outranks a key bound earlier. */\n  override async configure(opts?: TMailOptions): Promise<void> {\n    // The base short-circuits a second call; binding before that check would swap the options\n    // under a transport that was already built from the first ones.\n    if (this.isConfigured) {\n      return;\n    }\n\n    if (opts !== undefined) {\n      this.application.bind<TMailOptions>({ key: MailKeys.MAIL_OPTIONS }).toValue(opts);\n    }\n\n    await super.configure(opts);\n  }\n\n  override binding(): void | Promise<void> {\n    if (!this.application.isBound({ key: MailKeys.MAIL_OPTIONS })) {\n      this.logger\n        .for(this.binding.name)\n        .error(\n          'Mail options not configured. Please bind MailKeys.MAIL_OPTIONS before adding MailComponent.',\n        );\n\n      throw getError({\n        message: 'Mail options not configured',\n      });\n    }\n\n    this.initGenerators();\n    this.initProviders();\n    this.initServices();\n\n    this.createAndBindInstances();\n\n    this.logger.for(this.binding.name).info('Mail component initialized successfully');\n  }\n\n  initGenerators() {\n    this.application\n      .bind({ key: MailKeys.MAIL_VERIFICATION_CODE_GENERATOR })\n      .toClass(NumericCodeGenerator);\n    this.application\n      .bind({ key: MailKeys.MAIL_VERIFICATION_TOKEN_GENERATOR })\n      .toClass(RandomTokenGenerator);\n    this.application\n      .bind({ key: MailKeys.MAIL_VERIFICATION_DATA_GENERATOR })\n      .toClass(DefaultVerificationDataGenerator);\n  }\n\n  initProviders() {\n    this.application\n      .bind({ key: MailKeys.MAIL_TRANSPORT_PROVIDER })\n      .toProvider(MailTransportProvider)\n      .setScope('singleton');\n    this.application\n      .bind({ key: MailKeys.MAIL_QUEUE_EXECUTOR_PROVIDER })\n      .toProvider(MailQueueExecutorProvider)\n      .setScope('singleton');\n  }\n\n  initServices() {\n    this.application\n      .bind({ key: MailKeys.MAIL_SERVICE })\n      .toClass(MailService)\n      .setScope('singleton');\n    this.application\n      .bind({ key: MailKeys.MAIL_TEMPLATE_ENGINE })\n      .toClass(TemplateEngineService)\n      .setScope('singleton');\n  }\n\n  /** A bad limit or root would otherwise surface on every send, as a 400 that blames the caller. */\n  private validateAttachmentOptions(opts: { options: TMailOptions }): void {\n    const { attachmentRoot, maxAttachmentBytes } = opts.options;\n    const buildOptionError = (details: { message: string; cause?: unknown }) => {\n      return getError({\n        statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n        messageCode: MailErrorCodes.INVALID_CONFIGURATION,\n        message: `Invalid mail options | ${details.message}`,\n        cause: details.cause,\n      });\n    };\n\n    const isValidLimit =\n      maxAttachmentBytes === undefined ||\n      (Number.isSafeInteger(maxAttachmentBytes) && maxAttachmentBytes > 0);\n\n    if (!isValidLimit) {\n      throw buildOptionError({ message: 'maxAttachmentBytes must be a positive integer' });\n    }\n\n    if (attachmentRoot === undefined) {\n      return;\n    }\n\n    if (typeof attachmentRoot !== 'string' || !isAbsolute(attachmentRoot)) {\n      throw buildOptionError({ message: 'attachmentRoot must be an absolute path' });\n    }\n\n    let isDirectory: boolean;\n\n    try {\n      isDirectory = statSync(attachmentRoot).isDirectory();\n    } catch (error) {\n      throw buildOptionError({\n        message: 'attachmentRoot must be an existing directory',\n        cause: error,\n      });\n    }\n\n    if (!isDirectory) {\n      throw buildOptionError({ message: 'attachmentRoot must be an existing directory' });\n    }\n  }\n\n  createAndBindInstances(): void {\n    // Transport\n    const transportGetter = this.application.get<TGetMailTransportFn>({\n      key: MailKeys.MAIL_TRANSPORT_PROVIDER,\n    });\n    const mailOptions = this.application.get<TMailOptions>({ key: MailKeys.MAIL_OPTIONS });\n    this.validateAttachmentOptions({ options: mailOptions });\n\n    // Only the provider is logged: the options carry SMTP / API credentials, which must never reach a log sink.\n    this.logger\n      .for(this.createAndBindInstances.name)\n      .info('Mail provider: %s', mailOptions.provider);\n\n    const mailTransportInstance = transportGetter(mailOptions);\n    this.application.bind({ key: MailKeys.MAIL_TRANSPORT_INSTANCE }).toValue(mailTransportInstance);\n\n    // Queue\n    const queueGetter = this.application.get<TGetMailQueueExecutorFn>({\n      key: MailKeys.MAIL_QUEUE_EXECUTOR_PROVIDER,\n    });\n\n    // Queueing is opt-in: with no executor config bound, fall back to the direct (inline) executor instead of a \"binding is not bounded\" crash at boot.\n    const queueConfig = this.application.get<IMailQueueExecutorConfig>({\n      key: MailKeys.MAIL_QUEUE_EXECUTOR_CONFIG,\n      isOptional: true,\n    }) ?? { type: MailQueueExecutorTypes.DIRECT };\n\n    // Same reason as above: a bullmq config carries the Redis password.\n    this.logger\n      .for(this.createAndBindInstances.name)\n      .info('Mail queue executor type: %s', queueConfig.type);\n\n    const queueExecutorInstance = queueGetter(queueConfig);\n    this.application\n      .bind({ key: MailKeys.MAIL_QUEUE_EXECUTOR_INSTANCE })\n      .toValue(queueExecutorInstance);\n  }\n}\n"]}

package/dist/components/mail/helpers/executors/bull-mq-executor.helper.d.ts

@@ -1,40 +0,0 @@
-import { BaseHelper } from '@venizia/ignis-helpers/core';
-import type { TConstValue } from '../../../../helpers';
-import type { IBullMQMailExecutorOpts, IMailProcessorResult, IMailQueueExecutor, IMailQueueOptions, IMailQueueResult } from '../../common';
-import { BullMQExecutorModes } from '../../common';
-export declare class BullMQMailExecutorHelper extends BaseHelper implements IMailQueueExecutor {
-    private queueIdentifier;
-    private queueName;
-    private mode;
-    private queueHelper?;
-    private workerHelpers;
-    private redisConnection;
-    private readonly bullmqModule?;
-    private jobIdCounter;
-    private processor?;
-    constructor(opts: IBullMQMailExecutorOpts);
-    initQueue(queue: {
-        identifier: string;
-        name: string;
-    }): void;
-    setProcessor(processor: (email: string) => Promise<IMailProcessorResult>, opts?: {
-        numberOfWorkers?: number;
-        concurrencyPerWorker?: number;
-        lockDuration?: number;
-    }): Promise<void>;
-    addWorker(opts: {
-        workerIdentifier: string;
-        concurrency?: number;
-        lockDuration?: number;
-    }): void;
-    removeWorker(index: number): Promise<boolean>;
-    /** Closes every worker without stopping at the first failure, always empties the list, and returns failures instead of throwing so teardown can continue. */
-    private closeWorkers;
-    clearWorkers(): Promise<void>;
-    /** Full teardown: workers -> queue -> Redis. Every step runs even if an earlier one failed (skipping leaks a queue client + Redis socket); failures are reported once, at the end. */
-    close(): Promise<void>;
-    getWorkerCount(): number;
-    getMode(): TConstValue<typeof BullMQExecutorModes>;
-    enqueueVerificationEmail(email: string, options?: IMailQueueOptions): Promise<IMailQueueResult>;
-}
-//# sourceMappingURL=bull-mq-executor.helper.d.ts.map

package/dist/components/mail/helpers/executors/bull-mq-executor.helper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bull-mq-executor.helper.d.ts","sourceRoot":"","sources":["../../../../../src/components/mail/helpers/executors/bull-mq-executor.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mBAAmB,EAAsC,MAAM,cAAc,CAAC;AAGvF,qBAAa,wBAAyB,SAAQ,UAAW,YAAW,kBAAkB;IACpF,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,IAAI,CAA0C;IAEtD,OAAO,CAAC,WAAW,CAAC,CAAmD;IACvE,OAAO,CAAC,aAAa,CAA8D;IACnF,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAA0B;IACxD,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,SAAS,CAAC,CAAmD;gBAEzD,IAAI,EAAE,uBAAuB;IAiBzC,SAAS,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAmC/C,YAAY,CAChB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,EAC3D,IAAI,CAAC,EAAE;QACL,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,OAAO,CAAC,IAAI,CAAC;IAkChB,SAAS,CAAC,IAAI,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAsG1F,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBnD,6JAA6J;YAC/I,YAAY;IA2BpB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC,sLAAsL;IAChL,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC5B,cAAc,IAAI,MAAM;IAIxB,OAAO,IAAI,WAAW,CAAC,OAAO,mBAAmB,CAAC;IAI5C,wBAAwB,CAC5B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;CAqD7B"}

package/dist/components/mail/helpers/executors/bull-mq-executor.helper.js

@@ -1,249 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BullMQMailExecutorHelper = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
-const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const bullmq_1 = require("@venizia/ignis-helpers/bullmq");
-const common_1 = require("../../common");
-class BullMQMailExecutorHelper extends core_1.BaseHelper {
-    constructor(opts) {
-        super({ scope: BullMQMailExecutorHelper.name });
-        this.workerHelpers = [];
-        this.jobIdCounter = 0;
-        this.mode = opts.mode;
-        this.redisConnection = new ignis_helpers_1.RedisSingleHelper({
-            ...opts.redis,
-            maxRetry: undefined,
-        });
-        this.bullmqModule = opts.module;
-        this.queueIdentifier = opts.queue.identifier;
-        this.queueName = opts.queue.name;
-        this.initQueue(opts.queue);
-    }
-    initQueue(queue) {
-        switch (this.mode) {
-            case common_1.BullMQExecutorModes.QUEUE_ONLY:
-            case common_1.BullMQExecutorModes.BOTH: {
-                this.queueHelper = new bullmq_1.BullMQHelper({
-                    identifier: queue.identifier,
-                    queueName: queue.name,
-                    redisConnection: this.redisConnection,
-                    role: 'queue',
-                    module: this.bullmqModule,
-                });
-                this.logger
-                    .for(this.constructor.name)
-                    .info('BullMQ queue executor initialized (queue enabled) | Identifier: %s | Mode: %s', this.queueIdentifier, this.mode);
-                break;
-            }
-            default: {
-                this.logger
-                    .for(this.constructor.name)
-                    .info('BullMQ queue executor initialized (worker-only mode) | Identifier: %s | Mode: %s', this.queueIdentifier, this.mode);
-                break;
-            }
-        }
-    }
-    async setProcessor(processor, opts) {
-        this.processor = processor;
-        if (this.mode === common_1.BullMQExecutorModes.QUEUE_ONLY) {
-            this.logger
-                .for(this.setProcessor.name)
-                .warn('Skipping worker creation in queue-only mode. Workers will not be started.');
-            return;
-        }
-        const numberOfWorkers = opts?.numberOfWorkers ?? 1;
-        const concurrencyPerWorker = opts?.concurrencyPerWorker ?? 5;
-        const lockDuration = opts?.lockDuration ?? 30000;
-        await this.clearWorkers();
-        for (let i = 0; i < numberOfWorkers; i++) {
-            this.addWorker({
-                workerIdentifier: `${this.queueIdentifier}-worker-${i}`,
-                concurrency: concurrencyPerWorker,
-                lockDuration,
-            });
-        }
-        this.logger
-            .for(this.setProcessor.name)
-            .info('Processor registered | Mode: %s | Workers: %d | Concurrency per worker: %d', this.mode, numberOfWorkers, concurrencyPerWorker);
-    }
-    addWorker(opts) {
-        if (!this.processor) {
-            throw (0, core_1.getError)({ message: common_1.MailExecutorErrors.PROCESSOR_NOT_SET });
-        }
-        const workerIdentifier = opts.workerIdentifier;
-        const concurrency = opts?.concurrency ?? 5;
-        const lockDuration = opts?.lockDuration ?? 30000;
-        const workerHelper = new bullmq_1.BullMQHelper({
-            identifier: workerIdentifier,
-            queueName: this.queueName,
-            redisConnection: this.redisConnection,
-            role: 'worker',
-            module: this.bullmqModule,
-            numberOfWorker: concurrency,
-            lockDuration,
-            onWorkerData: async (job) => {
-                const maxAttempts = job.data.options?.attempts ?? 3;
-                this.logger
-                    .for('onWorkerData')
-                    .info('Processing job | Worker: %s | jobId: %s | email: %s | attempt: %d/%d', workerIdentifier, job.data.id, job.data.email, job.attemptsMade + 1, maxAttempts);
-                if (!this.processor) {
-                    // Returning undefined would let BullMQ mark the job COMPLETED and (with removeOnComplete) delete it - mail silently dropped.
-                    throw (0, core_1.getError)({
-                        messageCode: common_1.MailErrorCodes.SEND_FAILED,
-                        message: `[onWorkerData] ${common_1.MailExecutorErrors.PROCESSOR_NOT_SET} | jobId: ${job.data.id}`,
-                    });
-                }
-                const result = await this.processor(job.data.email);
-                // A processor reports SMTP rejection by RETURNING `{ success: false }`; BullMQ only treats a REJECTION as failure, so resolving completes the job - no retry, no DLQ.
-                if (result?.success === false) {
-                    throw (0, core_1.getError)({
-                        messageCode: common_1.MailErrorCodes.SEND_FAILED,
-                        message: `[onWorkerData] Processor reported failure | jobId: ${job.data.id} | reason: ${result.message}`,
-                    });
-                }
-                return result;
-            },
-            onWorkerDataCompleted: async (job) => {
-                this.logger
-                    .for('onWorkerDataCompleted')
-                    .info('Job completed | Worker: %s | jobId: %s | email: %s', workerIdentifier, job.data.id, job.data.email);
-            },
-            onWorkerDataFail: async (job, error) => {
-                if (job) {
-                    const maxAttempts = job.data.options?.attempts ?? 3;
-                    this.logger
-                        .for('onWorkerDataFail')
-                        .error('Job failed | Worker: %s | jobId: %s | email: %s | attempt: %d/%d | error: %s', workerIdentifier, job.data.id, job.data.email, job.attemptsMade, maxAttempts, error.message);
-                }
-                else {
-                    this.logger
-                        .for('onWorkerDataFail')
-                        .error('Worker error (no job) | Worker: %s | error: %s', workerIdentifier, error.message);
-                }
-            },
-        });
-        this.workerHelpers.push(workerHelper);
-        this.logger
-            .for(this.addWorker.name)
-            .info('Worker added | Identifier: %s | Concurrency: %d | Total workers: %d', workerIdentifier, concurrency, this.workerHelpers.length);
-    }
-    async removeWorker(index) {
-        if (index < 0 || index >= this.workerHelpers.length) {
-            this.logger.for(this.removeWorker.name).warn('Invalid worker index: %d', index);
-            return false;
-        }
-        // Dropped from the list BEFORE the close is awaited: a rejecting close must not leave a half-closed worker still counted and still handed jobs.
-        const [workerHelper] = this.workerHelpers.splice(index, 1);
-        await workerHelper.worker.close();
-        this.logger
-            .for(this.removeWorker.name)
-            .info('Worker removed | Index: %d | Remaining workers: %d', index, this.workerHelpers.length);
-        return true;
-    }
-    /** Closes every worker without stopping at the first failure, always empties the list, and returns failures instead of throwing so teardown can continue. */
-    async closeWorkers() {
-        const workerHelpers = this.workerHelpers;
-        this.workerHelpers = [];
-        const results = await Promise.allSettled(workerHelpers.map((workerHelper) => workerHelper.worker.close()));
-        const failures = [];
-        for (const result of results) {
-            if (result.status !== 'rejected') {
-                continue;
-            }
-            const error = result.reason instanceof Error
-                ? result.reason
-                : (0, core_1.getError)({ message: `Worker close failed | reason: ${String(result.reason)}` });
-            failures.push(error);
-            this.logger.for('closeWorkers').error('Failed to close worker | error: %s', error.message);
-        }
-        return failures;
-    }
-    async clearWorkers() {
-        const count = this.workerHelpers.length;
-        await this.closeWorkers();
-        this.logger.for(this.clearWorkers.name).info('All workers cleared | Count: %d', count);
-    }
-    /** Full teardown: workers -> queue -> Redis. Every step runs even if an earlier one failed (skipping leaks a queue client + Redis socket); failures are reported once, at the end. */
-    async close() {
-        const failures = [...(await this.closeWorkers())];
-        if (this.queueHelper) {
-            try {
-                await this.queueHelper.queue.close();
-            }
-            catch (error) {
-                const closeError = error instanceof Error ? error : (0, core_1.getError)({ message: String(error) });
-                failures.push(closeError);
-                this.logger.for(this.close.name).error('Failed to close queue | error: %s', closeError);
-            }
-        }
-        try {
-            await this.redisConnection.disconnect();
-        }
-        catch (error) {
-            const disconnectError = error instanceof Error ? error : (0, core_1.getError)({ message: String(error) });
-            failures.push(disconnectError);
-            this.logger
-                .for(this.close.name)
-                .error('Failed to disconnect redis | error: %s', disconnectError);
-        }
-        if (failures.length > 0) {
-            throw (0, core_1.getError)({
-                message: `[close] Incomplete BullMQ mail executor teardown | failures: ${failures
-                    .map((failure) => failure.message)
-                    .join(' | ')}`,
-            });
-        }
-        this.logger.for(this.close.name).info('BullMQ mail executor closed | Mode: %s', this.mode);
-    }
-    getWorkerCount() {
-        return this.workerHelpers.length;
-    }
-    getMode() {
-        return this.mode;
-    }
-    async enqueueVerificationEmail(email, options) {
-        if (this.mode === common_1.BullMQExecutorModes.WORKER_ONLY) {
-            throw (0, core_1.getError)({
-                message: 'Cannot enqueue jobs in worker-only mode. Set mode to "queue-only" or "both".',
-            });
-        }
-        if (!this.queueHelper) {
-            throw (0, core_1.getError)({
-                message: 'Queue helper not initialized. This should not happen in queue-enabled mode.',
-            });
-        }
-        if (!this.processor && this.mode !== common_1.BullMQExecutorModes.QUEUE_ONLY) {
-            throw (0, core_1.getError)({ message: common_1.MailExecutorErrors.PROCESSOR_NOT_SET });
-        }
-        const jobId = `job_${++this.jobIdCounter}_${Date.now()}`;
-        const job = {
-            id: jobId,
-            email,
-            options,
-            attempts: 0,
-            scheduledAt: Date.now() + (options?.delay ?? 0),
-        };
-        this.logger
-            .for(this.enqueueVerificationEmail.name)
-            .info('Queuing email to BullMQ/Redis | jobId: %s | email: %s | mode: %s', jobId, email, this.mode);
-        const bullJob = await this.queueHelper.queue.add('send-verification-email', job, {
-            priority: options?.priority,
-            delay: options?.delay,
-            attempts: options?.attempts ?? 3,
-            backoff: {
-                type: options?.backoff?.type ?? 'exponential',
-                delay: options?.backoff?.delay ?? 1000,
-            },
-            removeOnComplete: true,
-            removeOnFail: false,
-        });
-        return {
-            jobId: bullJob.id ?? jobId,
-            queued: true,
-            message: 'Email queued successfully (BullMQ/Redis)',
-        };
-    }
-}
-exports.BullMQMailExecutorHelper = BullMQMailExecutorHelper;
-//# sourceMappingURL=bull-mq-executor.helper.js.map

package/dist/components/mail/helpers/executors/bull-mq-executor.helper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bull-mq-executor.helper.js","sourceRoot":"","sources":["../../../../../src/components/mail/helpers/executors/bull-mq-executor.helper.ts"],"names":[],"mappings":";;;AAAA,sDAAmE;AACnE,0DAA2D;AAE3D,0DAA6D;AAS7D,yCAAuF;AAGvF,MAAa,wBAAyB,SAAQ,iBAAU;IAatD,YAAY,IAA6B;QACvC,KAAK,CAAC,EAAE,KAAK,EAAE,wBAAwB,CAAC,IAAI,EAAE,CAAC,CAAC;QAR1C,kBAAa,GAA2D,EAAE,CAAC;QAG3E,iBAAY,GAAG,CAAC,CAAC;QAOvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEtB,IAAI,CAAC,eAAe,GAAG,IAAI,iCAAiB,CAAC;YAC3C,GAAG,IAAI,CAAC,KAAK;YACb,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAEjC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,SAAS,CAAC,KAA2C;QACnD,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,4BAAmB,CAAC,UAAU,CAAC;YACpC,KAAK,4BAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,qBAAY,CAAqC;oBACtE,UAAU,EAAE,KAAK,CAAC,UAAU;oBAC5B,SAAS,EAAE,KAAK,CAAC,IAAI;oBACrB,eAAe,EAAE,IAAI,CAAC,eAAe;oBACrC,IAAI,EAAE,OAAO;oBACb,MAAM,EAAE,IAAI,CAAC,YAAY;iBAC1B,CAAC,CAAC;gBAEH,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;qBAC1B,IAAI,CACH,+EAA+E,EAC/E,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,IAAI,CACV,CAAC;gBACJ,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;qBAC1B,IAAI,CACH,kFAAkF,EAClF,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,IAAI,CACV,CAAC;gBAEJ,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,SAA2D,EAC3D,IAIC;QAED,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,IAAI,IAAI,CAAC,IAAI,KAAK,4BAAmB,CAAC,UAAU,EAAE,CAAC;YACjD,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;iBAC3B,IAAI,CAAC,2EAA2E,CAAC,CAAC;YACrF,OAAO;QACT,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,EAAE,eAAe,IAAI,CAAC,CAAC;QACnD,MAAM,oBAAoB,GAAG,IAAI,EAAE,oBAAoB,IAAI,CAAC,CAAC;QAC7D,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,KAAK,CAAC;QAEjD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,SAAS,CAAC;gBACb,gBAAgB,EAAE,GAAG,IAAI,CAAC,eAAe,WAAW,CAAC,EAAE;gBACvD,WAAW,EAAE,oBAAoB;gBACjC,YAAY;aACb,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;aAC3B,IAAI,CACH,4EAA4E,EAC5E,IAAI,CAAC,IAAI,EACT,eAAe,EACf,oBAAoB,CACrB,CAAC;IACN,CAAC;IAED,SAAS,CAAC,IAA+E;QACvF,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,2BAAkB,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAC/C,MAAM,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,KAAK,CAAC;QAEjD,MAAM,YAAY,GAAG,IAAI,qBAAY,CAAyC;YAC5E,UAAU,EAAE,gBAAgB;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI,CAAC,YAAY;YACzB,cAAc,EAAE,WAAW;YAC3B,YAAY;YACZ,YAAY,EAAE,KAAK,EAAE,GAAgD,EAAE,EAAE;gBACvE,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;gBAEpD,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,cAAc,CAAC;qBACnB,IAAI,CACH,sEAAsE,EACtE,gBAAgB,EAChB,GAAG,CAAC,IAAI,CAAC,EAAE,EACX,GAAG,CAAC,IAAI,CAAC,KAAK,EACd,GAAG,CAAC,YAAY,GAAG,CAAC,EACpB,WAAW,CACZ,CAAC;gBAEJ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACpB,6HAA6H;oBAC7H,MAAM,IAAA,eAAQ,EAAC;wBACb,WAAW,EAAE,uBAAc,CAAC,WAAW;wBACvC,OAAO,EAAE,kBAAkB,2BAAkB,CAAC,iBAAiB,aAAa,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE;qBAC1F,CAAC,CAAC;gBACL,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAEpD,sKAAsK;gBACtK,IAAI,MAAM,EAAE,OAAO,KAAK,KAAK,EAAE,CAAC;oBAC9B,MAAM,IAAA,eAAQ,EAAC;wBACb,WAAW,EAAE,uBAAc,CAAC,WAAW;wBACvC,OAAO,EAAE,sDAAsD,GAAG,CAAC,IAAI,CAAC,EAAE,cAAc,MAAM,CAAC,OAAO,EAAE;qBACzG,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,qBAAqB,EAAE,KAAK,EAAE,GAAgD,EAAE,EAAE;gBAChF,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,uBAAuB,CAAC;qBAC5B,IAAI,CACH,oDAAoD,EACpD,gBAAgB,EAChB,GAAG,CAAC,IAAI,CAAC,EAAE,EACX,GAAG,CAAC,IAAI,CAAC,KAAK,CACf,CAAC;YACN,CAAC;YACD,gBAAgB,EAAE,KAAK,EACrB,GAA4D,EAC5D,KAAY,EACZ,EAAE;gBACF,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,IAAI,CAAC,CAAC;oBACpD,IAAI,CAAC,MAAM;yBACR,GAAG,CAAC,kBAAkB,CAAC;yBACvB,KAAK,CACJ,8EAA8E,EAC9E,gBAAgB,EAChB,GAAG,CAAC,IAAI,CAAC,EAAE,EACX,GAAG,CAAC,IAAI,CAAC,KAAK,EACd,GAAG,CAAC,YAAY,EAChB,WAAW,EACX,KAAK,CAAC,OAAO,CACd,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,MAAM;yBACR,GAAG,CAAC,kBAAkB,CAAC;yBACvB,KAAK,CACJ,gDAAgD,EAChD,gBAAgB,EAChB,KAAK,CAAC,OAAO,CACd,CAAC;gBACN,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aACxB,IAAI,CACH,qEAAqE,EACrE,gBAAgB,EAChB,WAAW,EACX,IAAI,CAAC,aAAa,CAAC,MAAM,CAC1B,CAAC;IACN,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YAChF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,gJAAgJ;QAChJ,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3D,MAAM,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAElC,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;aAC3B,IAAI,CAAC,oDAAoD,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAEhG,OAAO,IAAI,CAAC;IACd,CAAC;IAED,6JAA6J;IACrJ,KAAK,CAAC,YAAY;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACzC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAExB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CACjE,CAAC;QAEF,MAAM,QAAQ,GAAY,EAAE,CAAC;QAE7B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GACT,MAAM,CAAC,MAAM,YAAY,KAAK;gBAC5B,CAAC,CAAC,MAAM,CAAC,MAAM;gBACf,CAAC,CAAC,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,iCAAiC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAEtF,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7F,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QACxC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAE1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IACzF,CAAC;IAED,sLAAsL;IACtL,KAAK,CAAC,KAAK;QACT,MAAM,QAAQ,GAAY,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAE3D,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACvC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACzF,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,UAAU,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,eAAe,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9F,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC/B,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;iBACpB,KAAK,CAAC,wCAAwC,EAAE,eAAe,CAAC,CAAC;QACtE,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,gEAAgE,QAAQ;qBAC9E,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;qBACjC,IAAI,CAAC,KAAK,CAAC,EAAE;aACjB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,wCAAwC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7F,CAAC;IAED,cAAc;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;IACnC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,wBAAwB,CAC5B,KAAa,EACb,OAA2B;QAE3B,IAAI,IAAI,CAAC,IAAI,KAAK,4BAAmB,CAAC,WAAW,EAAE,CAAC;YAClD,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,8EAA8E;aACxF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAA,eAAQ,EAAC;gBACb,OAAO,EAAE,6EAA6E;aACvF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,4BAAmB,CAAC,UAAU,EAAE,CAAC;YACpE,MAAM,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,2BAAkB,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACzD,MAAM,GAAG,GAAqB;YAC5B,EAAE,EAAE,KAAK;YACT,KAAK;YACL,OAAO;YACP,QAAQ,EAAE,CAAC;YACX,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC;SAChD,CAAC;QAEF,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC;aACvC,IAAI,CACH,kEAAkE,EAClE,KAAK,EACL,KAAK,EACL,IAAI,CAAC,IAAI,CACV,CAAC;QAEJ,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,EAAE,GAAG,EAAE;YAC/E,QAAQ,EAAE,OAAO,EAAE,QAAQ;YAC3B,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,CAAC;YAChC,OAAO,EAAE;gBACP,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,IAAI,aAAa;gBAC7C,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI;aACvC;YACD,gBAAgB,EAAE,IAAI;YACtB,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QAEH,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,EAAE,IAAI,KAAK;YAC1B,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,0CAA0C;SACpD,CAAC;IACJ,CAAC;CACF;AAvWD,4DAuWC","sourcesContent":["import { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport { RedisSingleHelper } from '@venizia/ignis-helpers';\nimport type { TConstValue } from '@/helpers';\nimport { BullMQHelper } from '@venizia/ignis-helpers/bullmq';\nimport type {\n  IBullMQMailExecutorOpts,\n  IMailProcessorResult,\n  IMailQueueExecutor,\n  IMailQueueOptions,\n  IMailQueueResult,\n  IQueueJobPayload,\n} from '../../common';\nimport { BullMQExecutorModes, MailErrorCodes, MailExecutorErrors } from '../../common';\nimport type { Job } from 'bullmq';\n\nexport class BullMQMailExecutorHelper extends BaseHelper implements IMailQueueExecutor {\n  private queueIdentifier: string;\n  private queueName: string;\n  private mode: TConstValue<typeof BullMQExecutorModes>;\n\n  private queueHelper?: BullMQHelper<IQueueJobPayload, IMailQueueResult>;\n  private workerHelpers: BullMQHelper<IQueueJobPayload, IMailProcessorResult>[] = [];\n  private redisConnection: RedisSingleHelper;\n  private readonly bullmqModule?: typeof import('bullmq');\n  private jobIdCounter = 0;\n\n  private processor?: (email: string) => Promise<IMailProcessorResult>;\n\n  constructor(opts: IBullMQMailExecutorOpts) {\n    super({ scope: BullMQMailExecutorHelper.name });\n\n    this.mode = opts.mode;\n\n    this.redisConnection = new RedisSingleHelper({\n      ...opts.redis,\n      maxRetry: undefined,\n    });\n\n    this.bullmqModule = opts.module;\n    this.queueIdentifier = opts.queue.identifier;\n    this.queueName = opts.queue.name;\n\n    this.initQueue(opts.queue);\n  }\n\n  initQueue(queue: { identifier: string; name: string }) {\n    switch (this.mode) {\n      case BullMQExecutorModes.QUEUE_ONLY:\n      case BullMQExecutorModes.BOTH: {\n        this.queueHelper = new BullMQHelper<IQueueJobPayload, IMailQueueResult>({\n          identifier: queue.identifier,\n          queueName: queue.name,\n          redisConnection: this.redisConnection,\n          role: 'queue',\n          module: this.bullmqModule,\n        });\n\n        this.logger\n          .for(this.constructor.name)\n          .info(\n            'BullMQ queue executor initialized (queue enabled) | Identifier: %s | Mode: %s',\n            this.queueIdentifier,\n            this.mode,\n          );\n        break;\n      }\n      default: {\n        this.logger\n          .for(this.constructor.name)\n          .info(\n            'BullMQ queue executor initialized (worker-only mode) | Identifier: %s | Mode: %s',\n            this.queueIdentifier,\n            this.mode,\n          );\n\n        break;\n      }\n    }\n  }\n\n  async setProcessor(\n    processor: (email: string) => Promise<IMailProcessorResult>,\n    opts?: {\n      numberOfWorkers?: number;\n      concurrencyPerWorker?: number;\n      lockDuration?: number;\n    },\n  ): Promise<void> {\n    this.processor = processor;\n\n    if (this.mode === BullMQExecutorModes.QUEUE_ONLY) {\n      this.logger\n        .for(this.setProcessor.name)\n        .warn('Skipping worker creation in queue-only mode. Workers will not be started.');\n      return;\n    }\n\n    const numberOfWorkers = opts?.numberOfWorkers ?? 1;\n    const concurrencyPerWorker = opts?.concurrencyPerWorker ?? 5;\n    const lockDuration = opts?.lockDuration ?? 30000;\n\n    await this.clearWorkers();\n\n    for (let i = 0; i < numberOfWorkers; i++) {\n      this.addWorker({\n        workerIdentifier: `${this.queueIdentifier}-worker-${i}`,\n        concurrency: concurrencyPerWorker,\n        lockDuration,\n      });\n    }\n\n    this.logger\n      .for(this.setProcessor.name)\n      .info(\n        'Processor registered | Mode: %s | Workers: %d | Concurrency per worker: %d',\n        this.mode,\n        numberOfWorkers,\n        concurrencyPerWorker,\n      );\n  }\n\n  addWorker(opts: { workerIdentifier: string; concurrency?: number; lockDuration?: number }): void {\n    if (!this.processor) {\n      throw getError({ message: MailExecutorErrors.PROCESSOR_NOT_SET });\n    }\n\n    const workerIdentifier = opts.workerIdentifier;\n    const concurrency = opts?.concurrency ?? 5;\n    const lockDuration = opts?.lockDuration ?? 30000;\n\n    const workerHelper = new BullMQHelper<IQueueJobPayload, IMailProcessorResult>({\n      identifier: workerIdentifier,\n      queueName: this.queueName,\n      redisConnection: this.redisConnection,\n      role: 'worker',\n      module: this.bullmqModule,\n      numberOfWorker: concurrency,\n      lockDuration,\n      onWorkerData: async (job: Job<IQueueJobPayload, IMailProcessorResult>) => {\n        const maxAttempts = job.data.options?.attempts ?? 3;\n\n        this.logger\n          .for('onWorkerData')\n          .info(\n            'Processing job | Worker: %s | jobId: %s | email: %s | attempt: %d/%d',\n            workerIdentifier,\n            job.data.id,\n            job.data.email,\n            job.attemptsMade + 1,\n            maxAttempts,\n          );\n\n        if (!this.processor) {\n          // Returning undefined would let BullMQ mark the job COMPLETED and (with removeOnComplete) delete it - mail silently dropped.\n          throw getError({\n            messageCode: MailErrorCodes.SEND_FAILED,\n            message: `[onWorkerData] ${MailExecutorErrors.PROCESSOR_NOT_SET} | jobId: ${job.data.id}`,\n          });\n        }\n\n        const result = await this.processor(job.data.email);\n\n        // A processor reports SMTP rejection by RETURNING `{ success: false }`; BullMQ only treats a REJECTION as failure, so resolving completes the job - no retry, no DLQ.\n        if (result?.success === false) {\n          throw getError({\n            messageCode: MailErrorCodes.SEND_FAILED,\n            message: `[onWorkerData] Processor reported failure | jobId: ${job.data.id} | reason: ${result.message}`,\n          });\n        }\n\n        return result;\n      },\n      onWorkerDataCompleted: async (job: Job<IQueueJobPayload, IMailProcessorResult>) => {\n        this.logger\n          .for('onWorkerDataCompleted')\n          .info(\n            'Job completed | Worker: %s | jobId: %s | email: %s',\n            workerIdentifier,\n            job.data.id,\n            job.data.email,\n          );\n      },\n      onWorkerDataFail: async (\n        job: Job<IQueueJobPayload, IMailProcessorResult> | undefined,\n        error: Error,\n      ) => {\n        if (job) {\n          const maxAttempts = job.data.options?.attempts ?? 3;\n          this.logger\n            .for('onWorkerDataFail')\n            .error(\n              'Job failed | Worker: %s | jobId: %s | email: %s | attempt: %d/%d | error: %s',\n              workerIdentifier,\n              job.data.id,\n              job.data.email,\n              job.attemptsMade,\n              maxAttempts,\n              error.message,\n            );\n        } else {\n          this.logger\n            .for('onWorkerDataFail')\n            .error(\n              'Worker error (no job) | Worker: %s | error: %s',\n              workerIdentifier,\n              error.message,\n            );\n        }\n      },\n    });\n\n    this.workerHelpers.push(workerHelper);\n\n    this.logger\n      .for(this.addWorker.name)\n      .info(\n        'Worker added | Identifier: %s | Concurrency: %d | Total workers: %d',\n        workerIdentifier,\n        concurrency,\n        this.workerHelpers.length,\n      );\n  }\n\n  async removeWorker(index: number): Promise<boolean> {\n    if (index < 0 || index >= this.workerHelpers.length) {\n      this.logger.for(this.removeWorker.name).warn('Invalid worker index: %d', index);\n      return false;\n    }\n\n    // Dropped from the list BEFORE the close is awaited: a rejecting close must not leave a half-closed worker still counted and still handed jobs.\n    const [workerHelper] = this.workerHelpers.splice(index, 1);\n    await workerHelper.worker.close();\n\n    this.logger\n      .for(this.removeWorker.name)\n      .info('Worker removed | Index: %d | Remaining workers: %d', index, this.workerHelpers.length);\n\n    return true;\n  }\n\n  /** Closes every worker without stopping at the first failure, always empties the list, and returns failures instead of throwing so teardown can continue. */\n  private async closeWorkers(): Promise<Error[]> {\n    const workerHelpers = this.workerHelpers;\n    this.workerHelpers = [];\n\n    const results = await Promise.allSettled(\n      workerHelpers.map((workerHelper) => workerHelper.worker.close()),\n    );\n\n    const failures: Error[] = [];\n\n    for (const result of results) {\n      if (result.status !== 'rejected') {\n        continue;\n      }\n\n      const error =\n        result.reason instanceof Error\n          ? result.reason\n          : getError({ message: `Worker close failed | reason: ${String(result.reason)}` });\n\n      failures.push(error);\n      this.logger.for('closeWorkers').error('Failed to close worker | error: %s', error.message);\n    }\n\n    return failures;\n  }\n\n  async clearWorkers(): Promise<void> {\n    const count = this.workerHelpers.length;\n    await this.closeWorkers();\n\n    this.logger.for(this.clearWorkers.name).info('All workers cleared | Count: %d', count);\n  }\n\n  /** Full teardown: workers -> queue -> Redis. Every step runs even if an earlier one failed (skipping leaks a queue client + Redis socket); failures are reported once, at the end. */\n  async close(): Promise<void> {\n    const failures: Error[] = [...(await this.closeWorkers())];\n\n    if (this.queueHelper) {\n      try {\n        await this.queueHelper.queue.close();\n      } catch (error) {\n        const closeError = error instanceof Error ? error : getError({ message: String(error) });\n        failures.push(closeError);\n        this.logger.for(this.close.name).error('Failed to close queue | error: %s', closeError);\n      }\n    }\n\n    try {\n      await this.redisConnection.disconnect();\n    } catch (error) {\n      const disconnectError = error instanceof Error ? error : getError({ message: String(error) });\n      failures.push(disconnectError);\n      this.logger\n        .for(this.close.name)\n        .error('Failed to disconnect redis | error: %s', disconnectError);\n    }\n\n    if (failures.length > 0) {\n      throw getError({\n        message: `[close] Incomplete BullMQ mail executor teardown | failures: ${failures\n          .map((failure) => failure.message)\n          .join(' | ')}`,\n      });\n    }\n\n    this.logger.for(this.close.name).info('BullMQ mail executor closed | Mode: %s', this.mode);\n  }\n\n  getWorkerCount(): number {\n    return this.workerHelpers.length;\n  }\n\n  getMode(): TConstValue<typeof BullMQExecutorModes> {\n    return this.mode;\n  }\n\n  async enqueueVerificationEmail(\n    email: string,\n    options?: IMailQueueOptions,\n  ): Promise<IMailQueueResult> {\n    if (this.mode === BullMQExecutorModes.WORKER_ONLY) {\n      throw getError({\n        message: 'Cannot enqueue jobs in worker-only mode. Set mode to \"queue-only\" or \"both\".',\n      });\n    }\n\n    if (!this.queueHelper) {\n      throw getError({\n        message: 'Queue helper not initialized. This should not happen in queue-enabled mode.',\n      });\n    }\n\n    if (!this.processor && this.mode !== BullMQExecutorModes.QUEUE_ONLY) {\n      throw getError({ message: MailExecutorErrors.PROCESSOR_NOT_SET });\n    }\n\n    const jobId = `job_${++this.jobIdCounter}_${Date.now()}`;\n    const job: IQueueJobPayload = {\n      id: jobId,\n      email,\n      options,\n      attempts: 0,\n      scheduledAt: Date.now() + (options?.delay ?? 0),\n    };\n\n    this.logger\n      .for(this.enqueueVerificationEmail.name)\n      .info(\n        'Queuing email to BullMQ/Redis | jobId: %s | email: %s | mode: %s',\n        jobId,\n        email,\n        this.mode,\n      );\n\n    const bullJob = await this.queueHelper.queue.add('send-verification-email', job, {\n      priority: options?.priority,\n      delay: options?.delay,\n      attempts: options?.attempts ?? 3,\n      backoff: {\n        type: options?.backoff?.type ?? 'exponential',\n        delay: options?.backoff?.delay ?? 1000,\n      },\n      removeOnComplete: true,\n      removeOnFail: false,\n    });\n\n    return {\n      jobId: bullJob.id ?? jobId,\n      queued: true,\n      message: 'Email queued successfully (BullMQ/Redis)',\n    };\n  }\n}\n"]}

package/dist/components/mail/helpers/executors/direct-executor.helper.d.ts

@@ -1,9 +0,0 @@
-import { BaseHelper } from '@venizia/ignis-helpers/core';
-import type { IMailProcessorResult, IMailQueueExecutor, IMailQueueOptions, IMailQueueResult } from '../../common';
-export declare class DirectMailExecutorHelper extends BaseHelper implements IMailQueueExecutor {
-    private processor?;
-    constructor();
-    setProcessor(processor: (email: string) => Promise<IMailProcessorResult>): void;
-    enqueueVerificationEmail(email: string, _options?: IMailQueueOptions): Promise<IMailQueueResult>;
-}
-//# sourceMappingURL=direct-executor.helper.d.ts.map

package/dist/components/mail/helpers/executors/direct-executor.helper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"direct-executor.helper.d.ts","sourceRoot":"","sources":["../../../../../src/components/mail/helpers/executors/direct-executor.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAY,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAGtB,qBAAa,wBAAyB,SAAQ,UAAW,YAAW,kBAAkB;IACpF,OAAO,CAAC,SAAS,CAAC,CAAmD;;IAMrE,YAAY,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAIzE,wBAAwB,CAC5B,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,gBAAgB,CAAC;CAgB7B"}

package/dist/components/mail/helpers/executors/direct-executor.helper.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DirectMailExecutorHelper = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
-const common_1 = require("../../common");
-class DirectMailExecutorHelper extends core_1.BaseHelper {
-    constructor() {
-        super({ scope: DirectMailExecutorHelper.name });
-    }
-    setProcessor(processor) {
-        this.processor = processor;
-    }
-    async enqueueVerificationEmail(email, _options) {
-        if (!this.processor) {
-            throw (0, core_1.getError)({ message: common_1.MailExecutorErrors.PROCESSOR_NOT_SET });
-        }
-        this.logger
-            .for(this.enqueueVerificationEmail.name)
-            .info('Executing immediately (no queue) for: %s', email);
-        const result = await this.processor(email);
-        return {
-            queued: false,
-            message: 'Email sent immediately (no queue)',
-            result,
-        };
-    }
-}
-exports.DirectMailExecutorHelper = DirectMailExecutorHelper;
-//# sourceMappingURL=direct-executor.helper.js.map

package/dist/components/mail/helpers/executors/direct-executor.helper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"direct-executor.helper.js","sourceRoot":"","sources":["../../../../../src/components/mail/helpers/executors/direct-executor.helper.ts"],"names":[],"mappings":";;;AAAA,sDAAmE;AAOnE,yCAAkD;AAElD,MAAa,wBAAyB,SAAQ,iBAAU;IAGtD;QACE,KAAK,CAAC,EAAE,KAAK,EAAE,wBAAwB,CAAC,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,YAAY,CAAC,SAA2D;QACtE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,wBAAwB,CAC5B,KAAa,EACb,QAA4B;QAE5B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAA,eAAQ,EAAC,EAAE,OAAO,EAAE,2BAAkB,CAAC,iBAAiB,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC;aACvC,IAAI,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAE3C,OAAO;YACL,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,mCAAmC;YAC5C,MAAM;SACP,CAAC;IACJ,CAAC;CACF;AA9BD,4DA8BC","sourcesContent":["import { BaseHelper, getError } from '@venizia/ignis-helpers/core';\nimport type {\n  IMailProcessorResult,\n  IMailQueueExecutor,\n  IMailQueueOptions,\n  IMailQueueResult,\n} from '../../common';\nimport { MailExecutorErrors } from '../../common';\n\nexport class DirectMailExecutorHelper extends BaseHelper implements IMailQueueExecutor {\n  private processor?: (email: string) => Promise<IMailProcessorResult>;\n\n  constructor() {\n    super({ scope: DirectMailExecutorHelper.name });\n  }\n\n  setProcessor(processor: (email: string) => Promise<IMailProcessorResult>): void {\n    this.processor = processor;\n  }\n\n  async enqueueVerificationEmail(\n    email: string,\n    _options?: IMailQueueOptions,\n  ): Promise<IMailQueueResult> {\n    if (!this.processor) {\n      throw getError({ message: MailExecutorErrors.PROCESSOR_NOT_SET });\n    }\n\n    this.logger\n      .for(this.enqueueVerificationEmail.name)\n      .info('Executing immediately (no queue) for: %s', email);\n    const result = await this.processor(email);\n\n    return {\n      queued: false,\n      message: 'Email sent immediately (no queue)',\n      result,\n    };\n  }\n}\n"]}

package/dist/components/mail/helpers/executors/index.d.ts

@@ -1,4 +0,0 @@
-export * from './bull-mq-executor.helper';
-export * from './direct-executor.helper';
-export * from './internal-queue-executor.helper';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/mail/helpers/executors/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/mail/helpers/executors/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC"}

package/dist/components/mail/helpers/executors/index.js

@@ -1,20 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./bull-mq-executor.helper"), exports);
-__exportStar(require("./direct-executor.helper"), exports);
-__exportStar(require("./internal-queue-executor.helper"), exports);
-//# sourceMappingURL=index.js.map

package/dist/components/mail/helpers/executors/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/mail/helpers/executors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,2DAAyC;AACzC,mEAAiD","sourcesContent":["export * from './bull-mq-executor.helper';\nexport * from './direct-executor.helper';\nexport * from './internal-queue-executor.helper';\n"]}

package/dist/components/mail/helpers/executors/internal-queue-executor.helper.d.ts

@@ -1,16 +0,0 @@
-import { BaseHelper } from '@venizia/ignis-helpers/core';
-import type { IMailQueueOptions, IMailQueueExecutor, IMailProcessorResult, IInternalQueueMailExecutorOpts, IMailQueueResult } from '../../common';
-export declare class InternalQueueMailExecutorHelper extends BaseHelper implements IMailQueueExecutor {
-    private queue;
-    private jobIdCounter;
-    private delayedJobs;
-    private processor?;
-    constructor(opts: IInternalQueueMailExecutorOpts);
-    setProcessor(processor: (email: string) => Promise<IMailProcessorResult>): void;
-    enqueueVerificationEmail(email: string, options?: IMailQueueOptions): Promise<IMailQueueResult>;
-    /** Releases every pending delayed/backoff timer - a live `setTimeout` holds the event loop open past the executor. */
-    close(): Promise<void>;
-    private processJob;
-    private calculateBackoff;
-}
-//# sourceMappingURL=internal-queue-executor.helper.d.ts.map