@venizia/ignis 0.4.3 → 0.4.5

package/dist/components/mail/common/errors.js

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MailErrors = void 0;
-const core_1 = require("@venizia/ignis-helpers/core");
-const common_1 = require("@venizia/ignis-helpers/common");
-/** Codes a client branches on for a mail request it can fix - a missing template, a message that is not sendable. Delivery failures are NOT here: they are 5xx and stay codeless, because a client cannot act on the remote provider being down. */
-/** Codes are LITERAL strings, deliberately not `MailErrorCodes.*`: `MessageCode.build()` returns `string`, which erases the literal type `TRegisterErrors` is built on and silently kills autocomplete. The values are identical to what those constants produce - they are a public contract and must not shift. */
-exports.MailErrors = {
-    TEMPLATE_NOT_FOUND: {
-        message: { text: 'Mail template not found', code: 'core.mail.template_not_found' },
-        statusCode: common_1.HTTP.ResultCodes.RS_4.NotFound,
-        category: core_1.ErrorScopes.BUSINESS,
-    },
-    INVALID_CONFIGURATION: {
-        message: { text: 'Invalid mail configuration', code: 'core.mail.invalid_configuration' },
-        statusCode: common_1.HTTP.ResultCodes.RS_4.BadRequest,
-        category: core_1.ErrorScopes.VALIDATION,
-    },
-    INVALID_RECIPIENT: {
-        message: { text: 'Invalid mail recipient', code: 'core.mail.invalid_recipient' },
-        statusCode: common_1.HTTP.ResultCodes.RS_4.BadRequest,
-        category: core_1.ErrorScopes.VALIDATION,
-    },
-    /** One answer for every refused source - outside the root, missing, not a file - so a caller cannot probe which files exist. */
-    ATTACHMENT_PATH_REFUSED: {
-        message: {
-            text: 'Mail attachment path refused',
-            code: 'core.mail.attachment_path_refused',
-        },
-        statusCode: common_1.HTTP.ResultCodes.RS_4.BadRequest,
-        category: core_1.ErrorScopes.VALIDATION,
-    },
-    ATTACHMENT_TOO_LARGE: {
-        message: {
-            text: 'Mail attachments are larger than the maximum allowed',
-            code: 'core.mail.attachment_too_large',
-        },
-        statusCode: common_1.HTTP.ResultCodes.RS_4.ContentTooLarge,
-        category: core_1.ErrorScopes.VALIDATION,
-    },
-    BODY_SOURCE_REFUSED: {
-        message: { text: 'Mail body must be text', code: 'core.mail.body_source_refused' },
-        statusCode: common_1.HTTP.ResultCodes.RS_4.BadRequest,
-        category: core_1.ErrorScopes.VALIDATION,
-    },
-};
-//# sourceMappingURL=errors.js.map

package/dist/components/mail/common/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/components/mail/common/errors.ts"],"names":[],"mappings":";;;AACA,sDAA0D;AAC1D,0DAAqD;AAErD,oPAAoP;AACpP,qTAAqT;AACxS,QAAA,UAAU,GAAG;IACxB,kBAAkB,EAAE;QAClB,OAAO,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,IAAI,EAAE,8BAA8B,EAAE;QAClF,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ;QAC1C,QAAQ,EAAE,kBAAW,CAAC,QAAQ;KAC/B;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE,EAAE,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,iCAAiC,EAAE;QACxF,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,kBAAW,CAAC,UAAU;KACjC;IACD,iBAAiB,EAAE;QACjB,OAAO,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,6BAA6B,EAAE;QAChF,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,kBAAW,CAAC,UAAU;KACjC;IACD,gIAAgI;IAChI,uBAAuB,EAAE;QACvB,OAAO,EAAE;YACP,IAAI,EAAE,8BAA8B;YACpC,IAAI,EAAE,mCAAmC;SAC1C;QACD,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,kBAAW,CAAC,UAAU;KACjC;IACD,oBAAoB,EAAE;QACpB,OAAO,EAAE;YACP,IAAI,EAAE,sDAAsD;YAC5D,IAAI,EAAE,gCAAgC;SACvC;QACD,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe;QACjD,QAAQ,EAAE,kBAAW,CAAC,UAAU;KACjC;IACD,mBAAmB,EAAE;QACnB,OAAO,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,+BAA+B,EAAE;QAClF,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU;QAC5C,QAAQ,EAAE,kBAAW,CAAC,UAAU;KACjC;CACkD,CAAC","sourcesContent":["import type { TErrorDefinition, TRegisterErrors } from '@venizia/ignis-helpers/core';\nimport { ErrorScopes } from '@venizia/ignis-helpers/core';\nimport { HTTP } from '@venizia/ignis-helpers/common';\n\n/** Codes a client branches on for a mail request it can fix - a missing template, a message that is not sendable. Delivery failures are NOT here: they are 5xx and stay codeless, because a client cannot act on the remote provider being down. */\n/** Codes are LITERAL strings, deliberately not `MailErrorCodes.*`: `MessageCode.build()` returns `string`, which erases the literal type `TRegisterErrors` is built on and silently kills autocomplete. The values are identical to what those constants produce - they are a public contract and must not shift. */\nexport const MailErrors = {\n  TEMPLATE_NOT_FOUND: {\n    message: { text: 'Mail template not found', code: 'core.mail.template_not_found' },\n    statusCode: HTTP.ResultCodes.RS_4.NotFound,\n    category: ErrorScopes.BUSINESS,\n  },\n  INVALID_CONFIGURATION: {\n    message: { text: 'Invalid mail configuration', code: 'core.mail.invalid_configuration' },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  INVALID_RECIPIENT: {\n    message: { text: 'Invalid mail recipient', code: 'core.mail.invalid_recipient' },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  /** One answer for every refused source - outside the root, missing, not a file - so a caller cannot probe which files exist. */\n  ATTACHMENT_PATH_REFUSED: {\n    message: {\n      text: 'Mail attachment path refused',\n      code: 'core.mail.attachment_path_refused',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n  ATTACHMENT_TOO_LARGE: {\n    message: {\n      text: 'Mail attachments are larger than the maximum allowed',\n      code: 'core.mail.attachment_too_large',\n    },\n    statusCode: HTTP.ResultCodes.RS_4.ContentTooLarge,\n    category: ErrorScopes.VALIDATION,\n  },\n  BODY_SOURCE_REFUSED: {\n    message: { text: 'Mail body must be text', code: 'core.mail.body_source_refused' },\n    statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n    category: ErrorScopes.VALIDATION,\n  },\n} as const satisfies Record<string, TErrorDefinition>;\n\n/** Registers these codes with the shared key registry so a consumer gets autocomplete on `messageCode`. */\ndeclare module '@venizia/ignis-helpers' {\n  interface IErrorKeyRegistry extends TRegisterErrors<typeof MailErrors> {}\n}\n"]}

package/dist/components/mail/common/index.d.ts

@@ -1,5 +0,0 @@
-export * from './errors';
-export * from './constants';
-export * from './keys';
-export * from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/mail/common/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/dist/components/mail/common/index.js

@@ -1,21 +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("./errors"), exports);
-__exportStar(require("./constants"), exports);
-__exportStar(require("./keys"), exports);
-__exportStar(require("./types"), exports);
-//# sourceMappingURL=index.js.map

package/dist/components/mail/common/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/mail/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,8CAA4B;AAC5B,yCAAuB;AACvB,0CAAwB","sourcesContent":["export * from './errors';\nexport * from './constants';\nexport * from './keys';\nexport * from './types';\n"]}

package/dist/components/mail/common/keys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../src/components/mail/common/keys.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ;IAEnB,MAAM,CAAC,QAAQ,CAAC,YAAY,kCAAkC;IAC9D,MAAM,CAAC,QAAQ,CAAC,0BAA0B,gDAAgD;IAG1F,MAAM,CAAC,QAAQ,CAAC,uBAAuB,6CAA6C;IACpF,MAAM,CAAC,QAAQ,CAAC,uBAAuB,6CAA6C;IAGpF,MAAM,CAAC,QAAQ,CAAC,oBAAoB,mDAAmD;IACvF,MAAM,CAAC,QAAQ,CAAC,YAAY,kCAAkC;IAG9D,MAAM,CAAC,QAAQ,CAAC,gCAAgC,sDACK;IACrD,MAAM,CAAC,QAAQ,CAAC,iCAAiC,uDACK;IACtD,MAAM,CAAC,QAAQ,CAAC,gCAAgC,sDACK;IAGrD,MAAM,CAAC,QAAQ,CAAC,4BAA4B,kDAAkD;IAC9F,MAAM,CAAC,QAAQ,CAAC,4BAA4B,kDAAkD;CAC/F"}

package/dist/components/mail/common/keys.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MailKeys = void 0;
-class MailKeys {
-    // Options & Configs
-    static { this.MAIL_OPTIONS = '@app/components/mail/options'; }
-    static { this.MAIL_QUEUE_EXECUTOR_CONFIG = '@app/components/mail/queue/executor-config'; }
-    // Transporter
-    static { this.MAIL_TRANSPORT_PROVIDER = '@app/components/mail/transport-provider'; }
-    static { this.MAIL_TRANSPORT_INSTANCE = '@app/components/mail/transport-instance'; }
-    // Services
-    static { this.MAIL_TEMPLATE_ENGINE = '@app/components/mail/services/template-engine'; }
-    static { this.MAIL_SERVICE = '@app/components/mail/service'; }
-    // Generators
-    static { this.MAIL_VERIFICATION_CODE_GENERATOR = '@app/components/mail/verification/code-generator'; }
-    static { this.MAIL_VERIFICATION_TOKEN_GENERATOR = '@app/components/mail/verification/token-generator'; }
-    static { this.MAIL_VERIFICATION_DATA_GENERATOR = '@app/components/mail/verification/data-generator'; }
-    // Queue
-    static { this.MAIL_QUEUE_EXECUTOR_PROVIDER = '@app/components/mail/queue-executor-provider'; }
-    static { this.MAIL_QUEUE_EXECUTOR_INSTANCE = '@app/components/mail/queue-executor-instance'; }
-}
-exports.MailKeys = MailKeys;
-//# sourceMappingURL=keys.js.map

package/dist/components/mail/common/keys.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../../src/components/mail/common/keys.ts"],"names":[],"mappings":";;;AAAA,MAAa,QAAQ;IACnB,oBAAoB;aACJ,iBAAY,GAAG,8BAA8B,CAAC;aAC9C,+BAA0B,GAAG,4CAA4C,CAAC;IAE1F,cAAc;aACE,4BAAuB,GAAG,yCAAyC,CAAC;aACpE,4BAAuB,GAAG,yCAAyC,CAAC;IAEpF,WAAW;aACK,yBAAoB,GAAG,+CAA+C,CAAC;aACvE,iBAAY,GAAG,8BAA8B,CAAC;IAE9D,aAAa;aACG,qCAAgC,GAC9C,kDAAkD,CAAC;aACrC,sCAAiC,GAC/C,mDAAmD,CAAC;aACtC,qCAAgC,GAC9C,kDAAkD,CAAC;IAErD,QAAQ;aACQ,iCAA4B,GAAG,8CAA8C,CAAC;aAC9E,iCAA4B,GAAG,8CAA8C,CAAC;;AAvBhG,4BAwBC","sourcesContent":["export class MailKeys {\n  // Options & Configs\n  static readonly MAIL_OPTIONS = '@app/components/mail/options';\n  static readonly MAIL_QUEUE_EXECUTOR_CONFIG = '@app/components/mail/queue/executor-config';\n\n  // Transporter\n  static readonly MAIL_TRANSPORT_PROVIDER = '@app/components/mail/transport-provider';\n  static readonly MAIL_TRANSPORT_INSTANCE = '@app/components/mail/transport-instance';\n\n  // Services\n  static readonly MAIL_TEMPLATE_ENGINE = '@app/components/mail/services/template-engine';\n  static readonly MAIL_SERVICE = '@app/components/mail/service';\n\n  // Generators\n  static readonly MAIL_VERIFICATION_CODE_GENERATOR =\n    '@app/components/mail/verification/code-generator';\n  static readonly MAIL_VERIFICATION_TOKEN_GENERATOR =\n    '@app/components/mail/verification/token-generator';\n  static readonly MAIL_VERIFICATION_DATA_GENERATOR =\n    '@app/components/mail/verification/data-generator';\n\n  // Queue\n  static readonly MAIL_QUEUE_EXECUTOR_PROVIDER = '@app/components/mail/queue-executor-provider';\n  static readonly MAIL_QUEUE_EXECUTOR_INSTANCE = '@app/components/mail/queue-executor-instance';\n}\n"]}

package/dist/components/mail/common/types/index.d.ts

@@ -1,6 +0,0 @@
-export * from './message';
-export * from './options';
-export * from './queue';
-export * from './template';
-export * from './verification';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/mail/common/types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/components/mail/common/types/index.js

@@ -1,22 +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("./message"), exports);
-__exportStar(require("./options"), exports);
-__exportStar(require("./queue"), exports);
-__exportStar(require("./template"), exports);
-__exportStar(require("./verification"), exports);
-//# sourceMappingURL=index.js.map

package/dist/components/mail/common/types/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,4CAA0B;AAC1B,0CAAwB;AACxB,6CAA2B;AAC3B,iDAA+B","sourcesContent":["export * from './message';\nexport * from './options';\nexport * from './queue';\nexport * from './template';\nexport * from './verification';\n"]}

package/dist/components/mail/common/types/message.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC/E,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACtD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACtD,SAAS,CACP,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GACA,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC9B,YAAY,CAAC,IAAI,EAAE;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1B,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B"}

package/dist/components/mail/common/types/message.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=message.js.map

package/dist/components/mail/common/types/message.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/message.ts"],"names":[],"mappings":"","sourcesContent":["import type { Readable } from 'node:stream';\n\nexport interface IMailAttachment {\n  filename?: string;\n  contentType?: string;\n  /** A file under the mail options' `attachmentRoot`; refused when no root is set. */\n  path?: string;\n  content?: string | Buffer | Uint8Array | Readable | ReadableStream<Uint8Array>;\n  encoding?: BufferEncoding;\n  cid?: string;\n  [key: string]: any;\n}\n\nexport interface IMailMessage {\n  from?: string;\n  to: string | string[];\n  cc?: string | string[];\n  bcc?: string | string[];\n  replyTo?: string;\n  subject: string;\n  text?: string;\n  html?: string;\n  attachments?: IMailAttachment[];\n  headers?: Record<string, string>;\n  requireValidate?: boolean;\n  [key: string]: any;\n}\n\nexport interface IMailSendResult {\n  success: boolean;\n  messageId?: string;\n  response?: any;\n  error?: string;\n}\n\nexport interface IMailTransport {\n  send(message: IMailMessage): Promise<IMailSendResult>;\n  verify(): Promise<boolean>;\n  close?(): Promise<void>;\n}\n\nexport interface IMailService {\n  send(message: IMailMessage): Promise<IMailSendResult>;\n  sendBatch(\n    messages: IMailMessage[],\n    options?: {\n      concurrency?: number;\n    },\n  ): Promise<IMailSendResult[]>;\n  sendTemplate(opts: {\n    templateName: string;\n    data: Record<string, any>;\n    recipients: string | string[];\n    options?: Partial<IMailMessage>;\n  }): Promise<IMailSendResult>;\n  verify(): Promise<boolean>;\n}\n"]}

package/dist/components/mail/common/types/options.d.ts

@@ -1,72 +0,0 @@
-import type { AnyType } from '@venizia/ignis-helpers/common';
-import type SMTPTransport from 'nodemailer/lib/smtp-transport';
-import type { IMailTransport } from './message';
-export interface IBaseMailOptions {
-    from?: string;
-    fromName?: string;
-    /**
-     * The only directory an `attachment.path` may be read from; `path` is resolved against it and
-     * refused if it lands outside, symlinks included. Unset, every `path` is refused.
-     */
-    attachmentRoot?: string;
-    /** Bytes of attachment content one message may carry, all attachments together. Default 25 MB. */
-    maxAttachmentBytes?: number;
-}
-export interface INodemailerMailOptions extends IBaseMailOptions {
-    provider: 'nodemailer';
-    config: TNodemailerConfig;
-    module?: TNodemailerModule;
-}
-export interface IMailgunMailOptions extends IBaseMailOptions {
-    provider: 'mailgun';
-    config: TMailgunConfig;
-    module?: TMailgunModule;
-}
-export interface IAmazonSesMailOptions extends IBaseMailOptions {
-    provider: 'amazon-ses';
-    config: TAmazonSesConfig;
-    module?: TAmazonSesModule;
-}
-export interface ICustomMailOptions extends IBaseMailOptions {
-    provider: 'custom';
-    config: IMailTransport;
-}
-export interface IGenericMailOptions extends IBaseMailOptions {
-    provider: string;
-    config: Record<string, AnyType>;
-}
-export type TMailOptions = INodemailerMailOptions | IAmazonSesMailOptions | IMailgunMailOptions | ICustomMailOptions | IGenericMailOptions;
-export type TNodemailerConfig = SMTPTransport | SMTPTransport.Options | string;
-export type TMailgunConfig = AnyType & {
-    domain: string;
-};
-/**
- * The peer module itself, handed over by an application that already holds it. A `bun build
- * --compile` binary carries no `node_modules`, so the runtime lookup these transports fall back to
- * has nothing to resolve against - passing the module through the options is what a compiled
- * application does instead. Typed as the shape each transport actually uses, so a wrong module is
- * a compile error rather than a boot crash.
- */
-export type TNodemailerModule = {
-    createTransport: (config: AnyType, defaults?: AnyType) => AnyType;
-};
-export type TMailgunModule = new (formData: AnyType) => AnyType;
-export type TAmazonSesConfig = {
-    region: string;
-    credentials?: {
-        accessKeyId: string;
-        secretAccessKey: string;
-        sessionToken?: string;
-    };
-    endpoint?: string;
-};
-/** Same story as {@link TNodemailerModule} - a compiled binary hands this over explicitly since there is no `node_modules` to resolve `@aws-sdk/client-sesv2` against. */
-export type TAmazonSesModule<TConfig extends AnyType = AnyType, TClient extends AnyType = AnyType> = {
-    SESv2Client: new (config: TConfig) => TClient;
-    SendEmailCommand: new (input: AnyType) => AnyType;
-    GetAccountCommand: new (input?: AnyType) => AnyType;
-};
-export type TAmazonSesClient = Pick<TAmazonSesModule, 'SendEmailCommand' | 'GetAccountCommand'> & {
-    client: AnyType;
-};
-//# sourceMappingURL=options.d.ts.map

package/dist/components/mail/common/types/options.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,aAAa,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kGAAkG;IAClG,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,MAAM,WAAW,qBAAsB,SAAQ,gBAAgB;IAC7D,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,YAAY,GACpB,sBAAsB,GACtB,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,CAAC;AAExB,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC;AAG/E,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,eAAe,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,KAAK,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,0KAA0K;AAC1K,MAAM,MAAM,gBAAgB,CAC1B,OAAO,SAAS,OAAO,GAAG,OAAO,EACjC,OAAO,SAAS,OAAO,GAAG,OAAO,IAC/B;IACF,WAAW,EAAE,KAAK,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAC9C,gBAAgB,EAAE,KAAK,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAClD,iBAAiB,EAAE,KAAK,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,GAAG,mBAAmB,CAAC,GAAG;IAChG,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC"}

package/dist/components/mail/common/types/options.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=options.js.map

package/dist/components/mail/common/types/options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/options.ts"],"names":[],"mappings":"","sourcesContent":["import type { AnyType } from '@venizia/ignis-helpers/common';\nimport type SMTPTransport from 'nodemailer/lib/smtp-transport';\nimport type { IMailTransport } from './message';\n\nexport interface IBaseMailOptions {\n  from?: string;\n  fromName?: string;\n  /**\n   * The only directory an `attachment.path` may be read from; `path` is resolved against it and\n   * refused if it lands outside, symlinks included. Unset, every `path` is refused.\n   */\n  attachmentRoot?: string;\n  /** Bytes of attachment content one message may carry, all attachments together. Default 25 MB. */\n  maxAttachmentBytes?: number;\n}\n\nexport interface INodemailerMailOptions extends IBaseMailOptions {\n  provider: 'nodemailer';\n  config: TNodemailerConfig;\n  module?: TNodemailerModule;\n}\n\nexport interface IMailgunMailOptions extends IBaseMailOptions {\n  provider: 'mailgun';\n  config: TMailgunConfig;\n  module?: TMailgunModule;\n}\n\nexport interface IAmazonSesMailOptions extends IBaseMailOptions {\n  provider: 'amazon-ses';\n  config: TAmazonSesConfig;\n  module?: TAmazonSesModule;\n}\n\nexport interface ICustomMailOptions extends IBaseMailOptions {\n  provider: 'custom';\n  config: IMailTransport;\n}\n\nexport interface IGenericMailOptions extends IBaseMailOptions {\n  provider: string;\n  config: Record<string, AnyType>;\n}\n\nexport type TMailOptions =\n  | INodemailerMailOptions\n  | IAmazonSesMailOptions\n  | IMailgunMailOptions\n  | ICustomMailOptions\n  | IGenericMailOptions;\n\nexport type TNodemailerConfig = SMTPTransport | SMTPTransport.Options | string;\n\n// MailgunClientOptions & {domain: string}\nexport type TMailgunConfig = AnyType & { domain: string };\n\n/**\n * The peer module itself, handed over by an application that already holds it. A `bun build\n * --compile` binary carries no `node_modules`, so the runtime lookup these transports fall back to\n * has nothing to resolve against - passing the module through the options is what a compiled\n * application does instead. Typed as the shape each transport actually uses, so a wrong module is\n * a compile error rather than a boot crash.\n */\nexport type TNodemailerModule = {\n  createTransport: (config: AnyType, defaults?: AnyType) => AnyType;\n};\n\nexport type TMailgunModule = new (formData: AnyType) => AnyType;\n\nexport type TAmazonSesConfig = {\n  region: string;\n  credentials?: { accessKeyId: string; secretAccessKey: string; sessionToken?: string };\n  endpoint?: string;\n};\n\n/** Same story as {@link TNodemailerModule} - a compiled binary hands this over explicitly since there is no `node_modules` to resolve `@aws-sdk/client-sesv2` against. */\nexport type TAmazonSesModule<\n  TConfig extends AnyType = AnyType,\n  TClient extends AnyType = AnyType,\n> = {\n  SESv2Client: new (config: TConfig) => TClient;\n  SendEmailCommand: new (input: AnyType) => AnyType;\n  GetAccountCommand: new (input?: AnyType) => AnyType;\n};\n\nexport type TAmazonSesClient = Pick<TAmazonSesModule, 'SendEmailCommand' | 'GetAccountCommand'> & {\n  client: AnyType;\n};\n"]}

package/dist/components/mail/common/types/queue.d.ts

@@ -1,57 +0,0 @@
-import type { TMailBackoffType } from '../constants';
-import type { TConstValue } from '@venizia/ignis-helpers/common';
-import type { IRedisSingleHelperOptions } from '@venizia/ignis-helpers';
-import type { BullMQExecutorModes, MailQueueExecutorTypes } from '../constants';
-export interface IMailQueueOptions {
-    priority?: number;
-    delay?: number;
-    attempts?: number;
-    backoff?: {
-        type: TMailBackoffType;
-        delay: number;
-    };
-}
-export interface IMailProcessorResult {
-    success: boolean;
-    message: string;
-    expiresInMinutes: number;
-    nextResendAt?: string;
-}
-export interface IMailQueueResult {
-    jobId?: string;
-    queued: boolean;
-    message: string;
-    result?: IMailProcessorResult;
-}
-export interface IMailQueueExecutor {
-    enqueueVerificationEmail(email: string, options?: IMailQueueOptions): Promise<IMailQueueResult>;
-    setProcessor(processor: (email: string) => Promise<IMailProcessorResult>): void;
-}
-/** Envelope every queue-backed executor stores for one pending verification email. */
-export interface IQueueJobPayload {
-    id: string;
-    email: string;
-    options?: IMailQueueOptions;
-    attempts: number;
-    scheduledAt: number;
-}
-export interface IInternalQueueMailExecutorOpts {
-    identifier: string;
-}
-export interface IBullMQMailExecutorOpts {
-    /** `redis.module` passes `ioredis` itself - see `module` below for why. */
-    redis: IRedisSingleHelperOptions;
-    queue: {
-        identifier: string;
-        name: string;
-    };
-    mode: TConstValue<typeof BullMQExecutorModes>;
-    /** `bullmq` itself, for a `bun build --compile` binary that has no `node_modules` to load it from. */
-    module?: typeof import('bullmq');
-}
-export interface IMailQueueExecutorConfig {
-    type: TConstValue<typeof MailQueueExecutorTypes>;
-    internalQueue?: IInternalQueueMailExecutorOpts;
-    bullmq?: IBullMQMailExecutorOpts;
-}
-//# sourceMappingURL=queue.d.ts.map

package/dist/components/mail/common/types/queue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE;QACR,IAAI,EAAE,gBAAgB,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,oBAAoB,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChG,YAAY,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC;CACjF;AAED,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,KAAK,EAAE,yBAAyB,CAAC;IACjC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,IAAI,EAAE,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAC;IAC9C,sGAAsG;IACtG,MAAM,CAAC,EAAE,cAAc,QAAQ,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAC;IACjD,aAAa,CAAC,EAAE,8BAA8B,CAAC;IAC/C,MAAM,CAAC,EAAE,uBAAuB,CAAC;CAClC"}

package/dist/components/mail/common/types/queue.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=queue.js.map

package/dist/components/mail/common/types/queue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/queue.ts"],"names":[],"mappings":"","sourcesContent":["import type { TMailBackoffType } from '../constants';\nimport type { TConstValue } from '@venizia/ignis-helpers/common';\nimport type { IRedisSingleHelperOptions } from '@venizia/ignis-helpers';\nimport type { BullMQExecutorModes, MailQueueExecutorTypes } from '../constants';\n\nexport interface IMailQueueOptions {\n  priority?: number;\n  delay?: number;\n  attempts?: number;\n  backoff?: {\n    type: TMailBackoffType;\n    delay: number;\n  };\n}\n\nexport interface IMailProcessorResult {\n  success: boolean;\n  message: string;\n  expiresInMinutes: number;\n  nextResendAt?: string;\n}\n\nexport interface IMailQueueResult {\n  jobId?: string;\n  queued: boolean;\n  message: string;\n  result?: IMailProcessorResult;\n}\n\nexport interface IMailQueueExecutor {\n  enqueueVerificationEmail(email: string, options?: IMailQueueOptions): Promise<IMailQueueResult>;\n  setProcessor(processor: (email: string) => Promise<IMailProcessorResult>): void;\n}\n\n/** Envelope every queue-backed executor stores for one pending verification email. */\nexport interface IQueueJobPayload {\n  id: string;\n  email: string;\n  options?: IMailQueueOptions;\n  attempts: number;\n  scheduledAt: number;\n}\n\nexport interface IInternalQueueMailExecutorOpts {\n  identifier: string;\n}\n\nexport interface IBullMQMailExecutorOpts {\n  /** `redis.module` passes `ioredis` itself - see `module` below for why. */\n  redis: IRedisSingleHelperOptions;\n  queue: { identifier: string; name: string };\n  mode: TConstValue<typeof BullMQExecutorModes>;\n  /** `bullmq` itself, for a `bun build --compile` binary that has no `node_modules` to load it from. */\n  module?: typeof import('bullmq');\n}\n\nexport interface IMailQueueExecutorConfig {\n  type: TConstValue<typeof MailQueueExecutorTypes>;\n  internalQueue?: IInternalQueueMailExecutorOpts;\n  bullmq?: IBullMQMailExecutorOpts;\n}\n"]}

package/dist/components/mail/common/types/template.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/template.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAE7D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,IAAI,EAAE;QACX,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,MAAM,CAAC;IACX,gBAAgB,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChE,oBAAoB,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG;QAC3E,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACjD,aAAa,IAAI,SAAS,EAAE,CAAC;IAC7B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC"}

package/dist/components/mail/common/types/template.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=template.js.map

package/dist/components/mail/common/types/template.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/template.ts"],"names":[],"mappings":"","sourcesContent":["import type { AnyType } from '@venizia/ignis-helpers/common';\n\nexport interface ITemplate {\n  name: string;\n  content?: string;\n  render?: (data: Record<string, AnyType>) => string;\n  subject?: string;\n  description?: string;\n}\n\nexport interface IMailTemplateEngine {\n  render(opts: {\n    templateData?: string;\n    templateName?: string;\n    data: Record<string, any>;\n    requireValidate?: boolean;\n  }): string;\n  registerTemplate(opts: { name: string; content: string }): void;\n  validateTemplateData(opts: { template: string; data: Record<string, any> }): {\n    isValid: boolean;\n    missingKeys: string[];\n    allKeys: string[];\n  };\n  getTemplate(name: string): ITemplate | undefined;\n  listTemplates(): ITemplate[];\n  hasTemplate(name: string): boolean;\n  removeTemplate(name: string): boolean;\n}\n"]}

package/dist/components/mail/common/types/verification.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/verification.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IAErB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IAEvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,wBAAwB,CAAC,OAAO,EAAE,8BAA8B,GAAG,iBAAiB,CAAC;CACtF"}

package/dist/components/mail/common/types/verification.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=verification.js.map

package/dist/components/mail/common/types/verification.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"verification.js","sourceRoot":"","sources":["../../../../../src/components/mail/common/types/verification.ts"],"names":[],"mappings":"","sourcesContent":["export interface IVerificationGenerationOptions {\n  codeLength: number;\n  tokenBytes: number;\n  codeExpiryMinutes: number;\n  tokenExpiryHours: number;\n}\n\nexport interface IVerificationData {\n  verificationCode: string;\n  codeGeneratedAt: string;\n  codeExpiresAt: string;\n  codeAttempts: number;\n\n  verificationToken: string;\n  tokenGeneratedAt: string;\n  tokenExpiresAt: string;\n\n  lastCodeSentAt: string;\n}\n\nexport interface IVerificationCodeGenerator {\n  generateCode(length: number): string;\n}\n\nexport interface IVerificationTokenGenerator {\n  generateToken(bytes: number): string;\n}\n\nexport interface IVerificationDataGenerator {\n  generateVerificationData(options: IVerificationGenerationOptions): IVerificationData;\n}\n"]}

package/dist/components/mail/component.d.ts

@@ -1,17 +0,0 @@
-import { type BaseApplication } from '../../base/applications';
-import { BaseComponent } from '@venizia/ignis-kernel';
-import type { TMailOptions } from './common';
-export declare class MailComponent extends BaseComponent<TMailOptions> {
-    private application;
-    constructor(application: BaseApplication);
-    /** `application.component(MailComponent, { options })` lands here; the call site outranks a key bound earlier. */
-    configure(opts?: TMailOptions): Promise<void>;
-    binding(): void | Promise<void>;
-    initGenerators(): void;
-    initProviders(): void;
-    initServices(): void;
-    /** A bad limit or root would otherwise surface on every send, as a 400 that blames the caller. */
-    private validateAttachmentOptions;
-    createAndBindInstances(): void;
-}
-//# sourceMappingURL=component.d.ts.map

package/dist/components/mail/component.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../../src/components/mail/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAOtD,OAAO,KAAK,EAA4B,YAAY,EAAE,MAAM,UAAU,CAAC;AAYvE,qBAAa,aAAc,SAAQ,aAAa,CAAC,YAAY,CAAC;IAEN,OAAO,CAAC,WAAW;gBAAX,WAAW,EAAE,eAAe;IAS1F,kHAAkH;IACnG,SAAS,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnD,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBxC,cAAc;IAYd,aAAa;IAWb,YAAY;IAWZ,kGAAkG;IAClG,OAAO,CAAC,yBAAyB;IA2CjC,sBAAsB,IAAI,IAAI;CAqC/B"}

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"]}