@wisemen/nestjs-mail 0.0.0 → 0.0.2

package/dist/modules/mail.module-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.module-definitions.js","sourceRoot":"","sources":["../../lib/modules/mail.module-definitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAG,oCAAoC,CAAA;AAEvE,MAAM,UAAU,mBAAmB,CAAE,OAA0B;IAC7D,OAAO,OAAO,CAAC,gBAAgB,IAAI,uBAAuB,EAAE,CAAA;AAC9D,CAAC;AAED,SAAS,uBAAuB;IAC9B,OAAO,OAAO,CAAC,GAAG,EAAE,GAAG,mBAAmB,CAAA;AAC5C,CAAC"}

package/dist/modules/mail.module-options.d.ts

@@ -0,0 +1,88 @@
+import type { FactoryProvider, ModuleMetadata } from '@nestjs/common';
+import { MailProvider } from '../enums/mail-provider.enum.js';
+/**
+ * Options for configuring a MailPit-backed mail client.
+ */
+export interface MailPitMailClientOptions {
+    /** Selects the MailPit client implementation. */
+    type: 'mailpit';
+    /** Base URL of the MailPit HTTP API. */
+    url: string;
+    /** Default sender address used when `sendMail()` omits `from`. */
+    defaultFrom?: string;
+    /** Optional HTTP basic auth credentials for protected MailPit instances. */
+    auth?: {
+        /** MailPit username. */
+        username: string;
+        /** MailPit password. */
+        password: string;
+    };
+    /** Optional MailPit tag added to every message. */
+    tag?: string;
+}
+/**
+ * Options for configuring the Scaleway transactional email client.
+ */
+export interface ScalewayMailClientOptions {
+    /** Selects the Scaleway client implementation. */
+    type: MailProvider.SCALEWAY;
+    /** Scaleway project identifier used for transactional email. */
+    projectId: string;
+    /** Default sender address used when `sendMail()` omits `from`. */
+    from: string;
+    /** Scaleway API token used for authenticated requests. */
+    apiKey: string;
+    /** Scaleway region. Defaults to `fr-par` when omitted. */
+    region?: string;
+}
+/**
+ * Options for configuring the SendGrid client.
+ */
+export interface SendGridMailClientOptions {
+    /** Selects the SendGrid client implementation. */
+    type: MailProvider.SEND_GRID;
+    /** Default sender address used when `sendMail()` omits `from`. */
+    defaultFrom: string;
+    /** SendGrid API token used for authenticated requests. */
+    apiToken: string;
+}
+/**
+ * Options for configuring a no-op test client.
+ */
+export interface MockMailClientOptions {
+    /** Selects the mock client implementation. */
+    type: 'mock';
+}
+/**
+ * Supported concrete mail client configurations.
+ */
+export type MailClientOptions = MailPitMailClientOptions | ScalewayMailClientOptions | SendGridMailClientOptions | MockMailClientOptions;
+/**
+ * Synchronous configuration for `MailModule.forRoot(...)`.
+ */
+export interface MailModuleOptions {
+    /**
+     * Base path used by `HandlebarsRenderer` to resolve template file paths.
+     *
+     * Defaults to `<cwd>/dist/src/modules`.
+     */
+    templateRootPath?: string;
+    /** Concrete mail client configuration to register in Nest DI. */
+    client: MailClientOptions;
+}
+/**
+ * Async configuration for `MailModule.forRootAsync(...)`.
+ */
+export interface MailModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    /**
+     * Optional modules that should be imported before resolving the factory.
+     */
+    imports?: ModuleMetadata['imports'];
+    /**
+     * Factory that resolves the module options from config, secrets, feature
+     * flags, or test setup.
+     */
+    useFactory: (...args: unknown[]) => Promise<MailModuleOptions> | MailModuleOptions;
+    /** Dependencies injected into `useFactory`. */
+    inject?: FactoryProvider['inject'];
+}

package/dist/modules/mail.module-options.js

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

package/dist/modules/mail.module-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.module-options.js","sourceRoot":"","sources":["../../lib/modules/mail.module-options.ts"],"names":[],"mappings":""}

package/dist/modules/mail.module.d.ts

@@ -0,0 +1,9 @@
+import { DynamicModule } from '@nestjs/common';
+import type { MailModuleAsyncOptions, MailModuleOptions } from './mail.module-options.js';
+export declare class MailModule {
+    static forRoot(options: MailModuleOptions): DynamicModule;
+    static forRootAsync(options: MailModuleAsyncOptions): DynamicModule;
+    private static createOptionsProvider;
+    private static createMailClientProvider;
+    private static createHandlebarsOptionsProvider;
+}

package/dist/modules/mail.module.js

@@ -0,0 +1,63 @@
+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 MailModule_1;
+import { Module } from '@nestjs/common';
+import { HANDLEBARS_MODULE_OPTIONS, HandlebarsRenderer } from '@wisemen/nestjs-handlebars';
+import { createMailClient } from '../clients/mail-client.factory.js';
+import { MailClient } from '../clients/mail.client.js';
+import { MAIL_MODULE_OPTIONS } from './mail.module-definitions.js';
+let MailModule = MailModule_1 = class MailModule {
+    static forRoot(options) {
+        return this.forRootAsync({
+            useFactory: () => options
+        });
+    }
+    static forRootAsync(options) {
+        return {
+            module: MailModule_1,
+            imports: options.imports ?? [],
+            providers: [
+                this.createOptionsProvider(options),
+                this.createMailClientProvider(),
+                this.createHandlebarsOptionsProvider(),
+                HandlebarsRenderer
+            ],
+            exports: [
+                HandlebarsRenderer,
+                MailClient
+            ]
+        };
+    }
+    static createOptionsProvider(options) {
+        return {
+            provide: MAIL_MODULE_OPTIONS,
+            useFactory: options.useFactory,
+            inject: options.inject ?? []
+        };
+    }
+    static createMailClientProvider() {
+        return {
+            provide: MailClient,
+            useFactory: (options) => createMailClient(options.client),
+            inject: [MAIL_MODULE_OPTIONS]
+        };
+    }
+    static createHandlebarsOptionsProvider() {
+        return {
+            provide: HANDLEBARS_MODULE_OPTIONS,
+            useFactory: (options) => ({
+                templateRootPath: options.templateRootPath
+            }),
+            inject: [MAIL_MODULE_OPTIONS]
+        };
+    }
+};
+MailModule = MailModule_1 = __decorate([
+    Module({})
+], MailModule);
+export { MailModule };
+//# sourceMappingURL=mail.module.js.map

package/dist/modules/mail.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.module.js","sourceRoot":"","sources":["../../lib/modules/mail.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAiB,MAAM,EAAY,MAAM,gBAAgB,CAAA;AAChE,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAgC,MAAM,4BAA4B,CAAA;AACxH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAI3D,IAAM,UAAU,kBAAhB,MAAM,UAAU;IACrB,MAAM,CAAC,OAAO,CAAE,OAA0B;QACxC,OAAO,IAAI,CAAC,YAAY,CAAC;YACvB,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO;SAC1B,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAE,OAA+B;QAClD,OAAO;YACL,MAAM,EAAE,YAAU;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE;gBACT,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC;gBACnC,IAAI,CAAC,wBAAwB,EAAE;gBAC/B,IAAI,CAAC,+BAA+B,EAAE;gBACtC,kBAAkB;aACnB;YACD,OAAO,EAAE;gBACP,kBAAkB;gBAClB,UAAU;aACX;SACF,CAAA;IACH,CAAC;IAEO,MAAM,CAAC,qBAAqB,CAAE,OAA+B;QACnE,OAAO;YACL,OAAO,EAAE,mBAAmB;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAA;IACH,CAAC;IAEO,MAAM,CAAC,wBAAwB;QACrC,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,UAAU,EAAE,CAAC,OAA0B,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5E,MAAM,EAAE,CAAC,mBAAmB,CAAC;SAC9B,CAAA;IACH,CAAC;IAEO,MAAM,CAAC,+BAA+B;QAC5C,OAAO;YACL,OAAO,EAAE,yBAAyB;YAClC,UAAU,EAAE,CAAC,OAA0B,EAA2B,EAAE,CAAC,CAAC;gBACpE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;aAC3C,CAAC;YACF,MAAM,EAAE,CAAC,mBAAmB,CAAC;SAC9B,CAAA;IACH,CAAC;CACF,CAAA;AAjDY,UAAU;IADtB,MAAM,CAAC,EAAE,CAAC;GACE,UAAU,CAiDtB"}

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

@@ -0,0 +1 @@
+export declare const MAIL_QUEUE_NAME = "mail";

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

@@ -0,0 +1,2 @@
+export const MAIL_QUEUE_NAME = 'mail';
+//# sourceMappingURL=mail-queue-name.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail-queue-name.js","sourceRoot":"","sources":["../../lib/queue/mail-queue-name.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAA"}

package/dist/queue/mail-queue.module-options.d.ts

@@ -0,0 +1,11 @@
+import type { ModuleMetadata } from '@nestjs/common';
+/**
+ * Configuration for `MailQueueModule.forRoot(...)`.
+ */
+export interface MailQueueModuleOptions {
+    /**
+     * Modules imported into the queue module so the mail job handlers can
+     * resolve dependencies such as `MailClient` and `HandlebarsRenderer`.
+     */
+    imports?: ModuleMetadata['imports'];
+}

package/dist/queue/mail-queue.module-options.js

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

package/dist/queue/mail-queue.module-options.js.map

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

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

@@ -0,0 +1,5 @@
+import { DynamicModule } from '@nestjs/common';
+import type { MailQueueModuleOptions } from './mail-queue.module-options.js';
+export declare class MailQueueModule {
+    static forRoot(options?: MailQueueModuleOptions): DynamicModule;
+}

package/dist/queue/mail-queue.module.js

@@ -0,0 +1,27 @@
+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 MailQueueModule_1;
+import { Module } from '@nestjs/common';
+import { SendHtmlMailJobHandler } from './send-html-mail.job-handler.js';
+import { SendTemplateMailJobHandler } from './send-template-mail.job-handler.js';
+let MailQueueModule = MailQueueModule_1 = class MailQueueModule {
+    static forRoot(options = {}) {
+        return {
+            module: MailQueueModule_1,
+            imports: options.imports ?? [],
+            providers: [
+                SendHtmlMailJobHandler,
+                SendTemplateMailJobHandler
+            ]
+        };
+    }
+};
+MailQueueModule = MailQueueModule_1 = __decorate([
+    Module({})
+], MailQueueModule);
+export { MailQueueModule };
+//# sourceMappingURL=mail-queue.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail-queue.module.js","sourceRoot":"","sources":["../../lib/queue/mail-queue.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAiB,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AAExE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAA;AAGzE,IAAM,eAAe,uBAArB,MAAM,eAAe;IAC1B,MAAM,CAAC,OAAO,CAAE,UAAkC,EAAE;QAClD,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE;gBACT,sBAAsB;gBACtB,0BAA0B;aAC3B;SACF,CAAA;IACH,CAAC;CACF,CAAA;AAXY,eAAe;IAD3B,MAAM,CAAC,EAAE,CAAC;GACE,eAAe,CAW3B"}

package/dist/queue/send-html-mail.job-handler.d.ts

@@ -0,0 +1,8 @@
+import { JobHandler } from '@wisemen/pgboss-nestjs-job';
+import { MailClient } from '../clients/mail.client.js';
+import { SendHtmlMailJob, type SendHtmlMailJobData } from './send-html-mail.job.js';
+export declare class SendHtmlMailJobHandler extends JobHandler<SendHtmlMailJob> {
+    private mailClient;
+    constructor(mailClient: MailClient);
+    run(mail: SendHtmlMailJobData): Promise<void>;
+}

package/dist/queue/send-html-mail.job-handler.js

@@ -0,0 +1,39 @@
+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);
+};
+import { Injectable } from '@nestjs/common';
+import { JobHandler, PgBossJobHandler } from '@wisemen/pgboss-nestjs-job';
+import { MailClient } from '../clients/mail.client.js';
+import { SendHtmlMailJob } from './send-html-mail.job.js';
+let SendHtmlMailJobHandler = class SendHtmlMailJobHandler extends JobHandler {
+    mailClient;
+    constructor(mailClient) {
+        super();
+        this.mailClient = mailClient;
+    }
+    async run(mail) {
+        await this.mailClient.sendMail({
+            to: mail.to,
+            cc: mail.cc,
+            bcc: mail.bcc,
+            from: mail.from,
+            replyTo: mail.replyTo,
+            subject: mail.subject,
+            text: mail.text,
+            html: mail.html
+        });
+    }
+};
+SendHtmlMailJobHandler = __decorate([
+    Injectable(),
+    PgBossJobHandler(SendHtmlMailJob),
+    __metadata("design:paramtypes", [MailClient])
+], SendHtmlMailJobHandler);
+export { SendHtmlMailJobHandler };
+//# sourceMappingURL=send-html-mail.job-handler.js.map

package/dist/queue/send-html-mail.job-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-html-mail.job-handler.js","sourceRoot":"","sources":["../../lib/queue/send-html-mail.job-handler.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,EAAE,eAAe,EAA4B,MAAM,yBAAyB,CAAA;AAI5E,IAAM,sBAAsB,GAA5B,MAAM,sBAAuB,SAAQ,UAA2B;IAE3D;IADV,YACU,UAAsB;QAE9B,KAAK,EAAE,CAAA;QAFC,eAAU,GAAV,UAAU,CAAY;IAGhC,CAAC;IAED,KAAK,CAAC,GAAG,CAAE,IAAyB;QAClC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC7B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAnBY,sBAAsB;IAFlC,UAAU,EAAE;IACZ,gBAAgB,CAAC,eAAe,CAAC;qCAGV,UAAU;GAFrB,sBAAsB,CAmBlC"}

package/dist/queue/send-html-mail.job.d.ts

@@ -0,0 +1,15 @@
+import { BaseJob } from '@wisemen/pgboss-nestjs-job';
+export interface SendHtmlMailJobData {
+    from?: string;
+    to: string;
+    cc?: string;
+    bcc?: string;
+    replyTo?: string;
+    subject: string;
+    data: Record<string, unknown>;
+    text: string;
+    html: string;
+}
+export declare class SendHtmlMailJob extends BaseJob<SendHtmlMailJobData> {
+    constructor(data: SendHtmlMailJobData);
+}

package/dist/queue/send-html-mail.job.js

@@ -0,0 +1,22 @@
+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);
+};
+import { BaseJob, PgBossJob } from '@wisemen/pgboss-nestjs-job';
+import { MAIL_QUEUE_NAME } from './mail-queue-name.js';
+let SendHtmlMailJob = class SendHtmlMailJob extends BaseJob {
+    constructor(data) {
+        super(data);
+    }
+};
+SendHtmlMailJob = __decorate([
+    PgBossJob(MAIL_QUEUE_NAME),
+    __metadata("design:paramtypes", [Object])
+], SendHtmlMailJob);
+export { SendHtmlMailJob };
+//# sourceMappingURL=send-html-mail.job.js.map

package/dist/queue/send-html-mail.job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-html-mail.job.js","sourceRoot":"","sources":["../../lib/queue/send-html-mail.job.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,OAAO,EAAG,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAe/C,IAAM,eAAe,GAArB,MAAM,eAAgB,SAAQ,OAA4B;IAC/D,YAAa,IAAyB;QACpC,KAAK,CAAC,IAAI,CAAC,CAAA;IACb,CAAC;CACF,CAAA;AAJY,eAAe;IAD3B,SAAS,CAAC,eAAe,CAAC;;GACd,eAAe,CAI3B"}

package/dist/queue/send-template-mail.job-handler.d.ts

@@ -0,0 +1,10 @@
+import { HandlebarsRenderer } from '@wisemen/nestjs-handlebars';
+import { JobHandler } from '@wisemen/pgboss-nestjs-job';
+import { MailClient } from '../clients/mail.client.js';
+import { SendTemplateMailJob, type SendTemplateMailJobData } from './send-template-mail.job.js';
+export declare class SendTemplateMailJobHandler extends JobHandler<SendTemplateMailJob> {
+    private mailClient;
+    private handlebarsRenderer;
+    constructor(mailClient: MailClient, handlebarsRenderer: HandlebarsRenderer);
+    run(mail: SendTemplateMailJobData): Promise<void>;
+}

package/dist/queue/send-template-mail.job-handler.js

@@ -0,0 +1,47 @@
+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);
+};
+import { Injectable } from '@nestjs/common';
+import { HandlebarsRenderer } from '@wisemen/nestjs-handlebars';
+import { JobHandler, PgBossJobHandler } from '@wisemen/pgboss-nestjs-job';
+import { MailClient } from '../clients/mail.client.js';
+import { SendTemplateMailJob } from './send-template-mail.job.js';
+let SendTemplateMailJobHandler = class SendTemplateMailJobHandler extends JobHandler {
+    mailClient;
+    handlebarsRenderer;
+    constructor(mailClient, handlebarsRenderer) {
+        super();
+        this.mailClient = mailClient;
+        this.handlebarsRenderer = handlebarsRenderer;
+    }
+    async run(mail) {
+        const [html, text] = await Promise.all([
+            this.handlebarsRenderer.render(mail.htmlHbsFilePath, mail.data),
+            this.handlebarsRenderer.render(mail.textHbsFilePath, mail.data)
+        ]);
+        await this.mailClient.sendMail({
+            to: mail.to,
+            cc: mail.cc,
+            bcc: mail.bcc,
+            from: mail.from,
+            replyTo: mail.replyTo,
+            subject: mail.subject,
+            text,
+            html
+        });
+    }
+};
+SendTemplateMailJobHandler = __decorate([
+    Injectable(),
+    PgBossJobHandler(SendTemplateMailJob),
+    __metadata("design:paramtypes", [MailClient,
+        HandlebarsRenderer])
+], SendTemplateMailJobHandler);
+export { SendTemplateMailJobHandler };
+//# sourceMappingURL=send-template-mail.job-handler.js.map

package/dist/queue/send-template-mail.job-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-template-mail.job-handler.js","sourceRoot":"","sources":["../../lib/queue/send-template-mail.job-handler.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,EAAE,mBAAmB,EAAgC,MAAM,6BAA6B,CAAA;AAIxF,IAAM,0BAA0B,GAAhC,MAAM,0BAA2B,SAAQ,UAA+B;IAEnE;IACA;IAFV,YACU,UAAsB,EACtB,kBAAsC;QAE9C,KAAK,EAAE,CAAA;QAHC,eAAU,GAAV,UAAU,CAAY;QACtB,uBAAkB,GAAlB,kBAAkB,CAAoB;IAGhD,CAAC;IAED,KAAK,CAAC,GAAG,CAAE,IAA6B;QACtC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACrC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC;YAC/D,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC;SAChE,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC7B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI;YACJ,IAAI;SACL,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAzBY,0BAA0B;IAFtC,UAAU,EAAE;IACZ,gBAAgB,CAAC,mBAAmB,CAAC;qCAGd,UAAU;QACF,kBAAkB;GAHrC,0BAA0B,CAyBtC"}

package/dist/queue/send-template-mail.job.d.ts

@@ -0,0 +1,15 @@
+import { BaseJob } from '@wisemen/pgboss-nestjs-job';
+export interface SendTemplateMailJobData {
+    from?: string;
+    to: string;
+    cc?: string;
+    bcc?: string;
+    replyTo?: string;
+    subject: string;
+    data: Record<string, unknown>;
+    textHbsFilePath: string;
+    htmlHbsFilePath: string;
+}
+export declare class SendTemplateMailJob extends BaseJob<SendTemplateMailJobData> {
+    constructor(data: SendTemplateMailJobData);
+}

package/dist/queue/send-template-mail.job.js

@@ -0,0 +1,22 @@
+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);
+};
+import { BaseJob, PgBossJob } from '@wisemen/pgboss-nestjs-job';
+import { MAIL_QUEUE_NAME } from './mail-queue-name.js';
+let SendTemplateMailJob = class SendTemplateMailJob extends BaseJob {
+    constructor(data) {
+        super(data);
+    }
+};
+SendTemplateMailJob = __decorate([
+    PgBossJob(MAIL_QUEUE_NAME),
+    __metadata("design:paramtypes", [Object])
+], SendTemplateMailJob);
+export { SendTemplateMailJob };
+//# sourceMappingURL=send-template-mail.job.js.map

package/dist/queue/send-template-mail.job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-template-mail.job.js","sourceRoot":"","sources":["../../lib/queue/send-template-mail.job.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAe/C,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,OAAgC;IACvE,YAAa,IAA6B;QACxC,KAAK,CAAC,IAAI,CAAC,CAAA;IACb,CAAC;CACF,CAAA;AAJY,mBAAmB;IAD/B,SAAS,CAAC,eAAe,CAAC;;GACd,mBAAmB,CAI/B"}

package/dist/utils/exhaustive-check.d.ts

@@ -0,0 +1 @@
+export declare function exhaustiveCheck(value: never): never;

package/dist/utils/exhaustive-check.js

@@ -0,0 +1,4 @@
+export function exhaustiveCheck(value) {
+    throw new Error(`Unhandled value: ${String(value)}`);
+}
+//# sourceMappingURL=exhaustive-check.js.map

package/dist/utils/exhaustive-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exhaustive-check.js","sourceRoot":"","sources":["../../lib/utils/exhaustive-check.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,eAAe,CAAE,KAAY;IAC3C,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AACtD,CAAC"}

package/package.json

@@ -1,11 +1,48 @@
 {
   "name": "@wisemen/nestjs-mail",
-  "version": "0.0.0",
-  "license": "SEE LICENSE IN LICENSE.md",
+  "version": "0.0.2",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist/",
+    "skills/"
+  ],
+  "peerDependencies": {
+    "@nestjs/common": "^11.1.19",
+    "@wisemen/api-error": "^1.0.0",
+    "@wisemen/nestjs-handlebars": "^0.0.1"
+  },
+  "dependencies": {
+    "mailpit-api": "^2.0.0",
+    "@wisemen/pgboss-nestjs-job": "5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.3.0",
+    "eslint": "10.2.1",
+    "oxlint": "1.59.0",
+    "oxlint-tsgolint": "0.20.0",
+    "typescript": "^5.9.3",
+    "@wisemen/eslint-config-nestjs": "1.1.1"
+  },
   "author": "Wisemen",
+  "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
     "type": "git",
     "url": "https://github.com/wisemen-digital/wisemen-core",
     "directory": "packages/api/nestjs-mail"
+  },
+  "scripts": {
+    "lint:oxlint": "oxlint --type-aware lib",
+    "lint:eslint": "eslint lib",
+    "lint": "pnpm run lint:oxlint && pnpm run lint:eslint",
+    "prebuild": "rm -rf ./dist",
+    "clean": "rm -rf ./dist",
+    "build": "tsc",
+    "prerelease": "npm run build",
+    "release": "pnpx release-it"
   }
-}
+}

package/skills/getting-started/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: getting-started
+description: Use when configuring transactional mail delivery in NestJS APIs with @wisemen/nestjs-mail.
+---
+
+# @wisemen/nestjs-mail - Getting Started
+
+Use `MailModule.forRootAsync(...)` to register a shared `MailClient` and
+`HandlebarsRenderer`, then keep provider selection in your application layer.
+
+## Send Mail
+
+Inject `MailClient` into a use case, service, or job handler and call
+`sendMail(...)` with html or text content.
+
+```ts
+import { Injectable } from '@nestjs/common'
+import { MailClient } from '@wisemen/nestjs-mail'
+
+@Injectable()
+export class SendWelcomeMailUseCase {
+  constructor(private readonly mailClient: MailClient) {}
+
+  async send(to: string): Promise<void> {
+    await this.mailClient.sendMail({
+      to,
+      subject: 'Welcome',
+      text: 'Welcome to the platform'
+    })
+  }
+}
+```
+
+## Render Handlebars Templates
+
+Use `HandlebarsRenderer` when the mail body should come from `.hbs` templates in
+your built application output.
+
+```ts
+import { Injectable } from '@nestjs/common'
+import { HandlebarsRenderer } from '@wisemen/nestjs-handlebars'
+import { MailClient } from '@wisemen/nestjs-mail'
+
+@Injectable()
+export class SendTemplateMailUseCase {
+  constructor(
+    private readonly mailClient: MailClient,
+    private readonly renderer: HandlebarsRenderer
+  ) {}
+
+  async send(to: string, data: Record<string, unknown>): Promise<void> {
+    const [html, text] = await Promise.all([
+      this.renderer.render('mail/templates/welcome.html.hbs', data),
+      this.renderer.render('mail/templates/welcome.text.hbs', data)
+    ])
+
+    await this.mailClient.sendMail({
+      to,
+      subject: 'Welcome',
+      html,
+      text
+    })
+  }
+}
+```