blendsdk 5.33.0

package/dist/webafx-i18n/postgresql-source.d.ts

@@ -0,0 +1,101 @@
+import type { TranslationSource, TranslationCatalog } from "../i18n/index.js";
+/**
+ * Configuration for the PostgreSQL translation source.
+ */
+export interface PostgreSQLSourceConfig {
+    /**
+     * A function that executes a SQL query and returns rows.
+     *
+     * This is a callback rather than a direct database connection
+     * to decouple the source from any specific PostgreSQL client.
+     *
+     * @example
+     * queryFn: (sql) => database.query(sql)
+     */
+    queryFn: (sql: string) => Promise<Array<{
+        key: string;
+        locale: string;
+        value: string;
+    }>>;
+    /**
+     * The table name containing translations.
+     * @default "translations"
+     */
+    tableName?: string;
+    /**
+     * Optional WHERE clause filter (without the WHERE keyword).
+     * Useful for filtering by application, domain, or active status.
+     *
+     * @example
+     * filter: "active = true AND app = 'myapp'"
+     */
+    filter?: string;
+}
+/**
+ * Translation source that loads from a PostgreSQL database table.
+ *
+ * Reads all translation rows and normalizes them into a TranslationCatalog.
+ * Each row maps to one key-locale pair.
+ *
+ * The source supports plural values stored as JSON arrays in the `value` column:
+ * - Simple string: `"Hello"` → stored as `Hello`
+ * - Plural array: `["1 book", "N books"]` → stored as `["1 book","N books"]` (JSON string)
+ *
+ * @example
+ * ```typescript
+ * const source = new PostgreSQLSource({
+ *     queryFn: (sql) => database.query(sql),
+ *     tableName: "translations",
+ * });
+ * const catalog = await source.load();
+ * ```
+ */
+export declare class PostgreSQLSource implements TranslationSource {
+    /** @inheritdoc */
+    readonly name = "PostgreSQLSource";
+    /** Source configuration */
+    protected config: PostgreSQLSourceConfig;
+    /**
+     * Create a new PostgreSQLSource.
+     *
+     * @param config - PostgreSQL source configuration
+     */
+    constructor(config: PostgreSQLSourceConfig);
+    /**
+     * Load all translations from the configured PostgreSQL table.
+     *
+     * Builds a SQL query, executes it via the configured queryFn,
+     * and normalizes the rows into a TranslationCatalog.
+     *
+     * @returns The translation catalog from the database
+     * @throws Error if the query fails
+     */
+    load(): Promise<TranslationCatalog>;
+    /**
+     * Parse a value from the database.
+     *
+     * If the value is a JSON array (starts with '['), parse it as
+     * a [singular, plural] tuple. Otherwise, return as plain string.
+     *
+     * @param value - The raw string value from the database
+     * @returns Parsed TranslationValue
+     */
+    protected parseValue(value: string): string | [string, string];
+}
+/**
+ * Create a PostgreSQLSource instance. Convenience factory for plugin configuration.
+ *
+ * @param config - PostgreSQL source configuration
+ * @returns A new PostgreSQLSource instance
+ *
+ * @example
+ * ```typescript
+ * app.use(createI18nPlugin({
+ *     sources: [
+ *         postgresqlSource({ queryFn: (sql) => database.query(sql) }),
+ *     ],
+ * }));
+ * ```
+ */
+export declare function postgresqlSource(config: PostgreSQLSourceConfig): PostgreSQLSource;
+//# sourceMappingURL=postgresql-source.d.ts.map

package/dist/webafx-i18n/postgresql-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql-source.d.ts","sourceRoot":"","sources":["../src/postgresql-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC;;;;;;;;OAQG;IACH,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAEzF;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACtD,kBAAkB;IAClB,QAAQ,CAAC,IAAI,sBAAsB;IAEnC,2BAA2B;IAC3B,SAAS,CAAC,MAAM,EAAE,sBAAsB,CAAC;IAEzC;;;;OAIG;gBACS,MAAM,EAAE,sBAAsB;IAI1C;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAqBzC;;;;;;;;OAQG;IACH,SAAS,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;CAajE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,gBAAgB,CAEjF"}

package/dist/webafx-i18n/postgresql-source.js

@@ -0,0 +1,101 @@
+/**
+ * Translation source that loads from a PostgreSQL database table.
+ *
+ * Reads all translation rows and normalizes them into a TranslationCatalog.
+ * Each row maps to one key-locale pair.
+ *
+ * The source supports plural values stored as JSON arrays in the `value` column:
+ * - Simple string: `"Hello"` → stored as `Hello`
+ * - Plural array: `["1 book", "N books"]` → stored as `["1 book","N books"]` (JSON string)
+ *
+ * @example
+ * ```typescript
+ * const source = new PostgreSQLSource({
+ *     queryFn: (sql) => database.query(sql),
+ *     tableName: "translations",
+ * });
+ * const catalog = await source.load();
+ * ```
+ */
+export class PostgreSQLSource {
+    /** @inheritdoc */
+    name = "PostgreSQLSource";
+    /** Source configuration */
+    config;
+    /**
+     * Create a new PostgreSQLSource.
+     *
+     * @param config - PostgreSQL source configuration
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Load all translations from the configured PostgreSQL table.
+     *
+     * Builds a SQL query, executes it via the configured queryFn,
+     * and normalizes the rows into a TranslationCatalog.
+     *
+     * @returns The translation catalog from the database
+     * @throws Error if the query fails
+     */
+    async load() {
+        const tableName = this.config.tableName ?? "translations";
+        let sql = `SELECT key, locale, value FROM ${tableName}`;
+        if (this.config.filter) {
+            sql += ` WHERE ${this.config.filter}`;
+        }
+        sql += ` ORDER BY key, locale`;
+        const rows = await this.config.queryFn(sql);
+        const catalog = {};
+        for (const row of rows) {
+            if (!catalog[row.key]) {
+                catalog[row.key] = {};
+            }
+            catalog[row.key][row.locale] = this.parseValue(row.value);
+        }
+        return catalog;
+    }
+    /**
+     * Parse a value from the database.
+     *
+     * If the value is a JSON array (starts with '['), parse it as
+     * a [singular, plural] tuple. Otherwise, return as plain string.
+     *
+     * @param value - The raw string value from the database
+     * @returns Parsed TranslationValue
+     */
+    parseValue(value) {
+        if (value.startsWith("[")) {
+            try {
+                const parsed = JSON.parse(value);
+                if (Array.isArray(parsed) && parsed.length === 2 && typeof parsed[0] === "string" && typeof parsed[1] === "string") {
+                    return parsed;
+                }
+            }
+            catch {
+                // Not valid JSON — return as plain string
+            }
+        }
+        return value;
+    }
+}
+/**
+ * Create a PostgreSQLSource instance. Convenience factory for plugin configuration.
+ *
+ * @param config - PostgreSQL source configuration
+ * @returns A new PostgreSQLSource instance
+ *
+ * @example
+ * ```typescript
+ * app.use(createI18nPlugin({
+ *     sources: [
+ *         postgresqlSource({ queryFn: (sql) => database.query(sql) }),
+ *     ],
+ * }));
+ * ```
+ */
+export function postgresqlSource(config) {
+    return new PostgreSQLSource(config);
+}
+//# sourceMappingURL=postgresql-source.js.map

package/dist/webafx-i18n/postgresql-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresql-source.js","sourceRoot":"","sources":["../src/postgresql-source.ts"],"names":[],"mappings":"AAiCA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAgB;IACzB,kBAAkB;IACT,IAAI,GAAG,kBAAkB,CAAC;IAEnC,2BAA2B;IACjB,MAAM,CAAyB;IAEzC;;;;OAIG;IACH,YAAY,MAA8B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,IAAI;QACN,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,cAAc,CAAC;QAC1D,IAAI,GAAG,GAAG,kCAAkC,SAAS,EAAE,CAAC;QACxD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACrB,GAAG,IAAI,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1C,CAAC;QACD,GAAG,IAAI,uBAAuB,CAAC;QAE/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAuB,EAAE,CAAC;QAEvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YAC1B,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACO,UAAU,CAAC,KAAa;QAC9B,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACjC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACjH,OAAO,MAA0B,CAAC;gBACtC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,0CAA0C;YAC9C,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA8B;IAC3D,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC"}

package/dist/webafx-i18n/types.d.ts

@@ -0,0 +1,70 @@
+import type { TranslationSource } from "../i18n/index.js";
+/**
+ * Configuration for the i18n WebAFX plugin.
+ */
+export interface I18nPluginConfig {
+    /**
+     * The default locale used as fallback when no locale can be resolved.
+     * @default "en"
+     */
+    defaultLocale?: string;
+    /**
+     * Array of translation sources to load at startup.
+     * Sources are loaded in order; later sources override earlier ones
+     * for the same key+locale combination.
+     *
+     * @example
+     * sources: [
+     *     jsonFileSource({ paths: ["./translations/*.json"] }),
+     *     postgresqlSource({ queryFn: (sql) => db.query(sql) }),
+     * ]
+     */
+    sources: TranslationSource[];
+    /**
+     * Service name for registering the Translator in the service container.
+     * @default "i18n"
+     */
+    serviceName?: string;
+    /**
+     * Service name for registering the resolved locale as a per-request service.
+     * @default "locale"
+     */
+    localeServiceName?: string;
+    /**
+     * Optional: Pub/Sub channel name for distributed reload.
+     *
+     * When set, the plugin subscribes to this channel via the PubSubProvider
+     * registered in the service container (from @blendsdk/webafx-cache plugin).
+     * When a message is received on this channel, all sources are reloaded
+     * and the translator catalog is atomically swapped.
+     *
+     * Requires @blendsdk/webafx-cache pub/sub plugin to be installed.
+     *
+     * @example
+     * reloadChannel: "i18n:reload"
+     */
+    reloadChannel?: string;
+    /**
+     * Service name of the PubSubProvider in the service container.
+     * Only used when `reloadChannel` is set.
+     * @default "pubsub"
+     */
+    pubsubServiceName?: string;
+    /**
+     * Optional callback invoked when a translation key is not found.
+     * Passed through to the Translator instance.
+     */
+    onMissingTranslation?: (key: string, locale: string) => void;
+    /**
+     * Cookie name for persisting the user's locale preference.
+     * Set to `false` to disable locale persistence.
+     * @default "locale"
+     */
+    localeCookieName?: string | false;
+    /**
+     * Plugin installation priority. Lower numbers install first.
+     * @default 40
+     */
+    priority?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/webafx-i18n/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;;;;;;;OAUG;IACH,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAE7B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAE7D;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/webafx-i18n/types.js

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

package/dist/webafx-i18n/types.js.map

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

package/dist/webafx-mailer/abstract-mail-provider.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Abstract base class for all mail provider implementations.
+ *
+ * All mail backends (SMTP, Memory) derive from this class, providing
+ * a uniform API for sending emails with health check and graceful
+ * shutdown support. This mirrors the CacheProvider pattern from
+ * @blendsdk/webafx-cache.
+ *
+ * @example
+ * ```typescript
+ * // Usage via concrete provider:
+ * const mailer: MailProvider = new SmtpMailProvider({ host: "smtp.example.com", port: 587 });
+ * const result = await mailer.send({ from: "a@b.com", to: "c@d.com", subject: "Hi", text: "Hello" });
+ * ```
+ */
+import type { MailMessage, MailProviderConfig, MailResult } from "./types.js";
+export declare abstract class MailProvider {
+    /**
+     * Service name used for WebAFX service container registration.
+     * Defaults to "mailer" unless overridden in config.
+     */
+    protected _serviceName: string;
+    /**
+     * @param config - Base provider configuration with optional service name
+     */
+    constructor(config: MailProviderConfig);
+    /**
+     * Get the service name used for WebAFX service container registration.
+     * This name is used when registering the provider as a singleton service.
+     */
+    get serviceName(): string;
+    /**
+     * Send an email message.
+     *
+     * @param message - The email message to send (from, to, subject, body, etc.)
+     * @returns Result with accepted/rejected recipients and server-assigned message ID
+     * @throws Error if sending fails (connection issues, auth failures, etc.)
+     */
+    abstract send(message: MailMessage): Promise<MailResult>;
+    /**
+     * Health check — returns true if the backend is operational.
+     *
+     * For SMTP: verifies the transport connection via EHLO/HELO.
+     * For Memory: always returns true (no external dependencies).
+     */
+    abstract health(): Promise<boolean>;
+    /**
+     * Graceful shutdown — close connections and release resources.
+     *
+     * For SMTP: closes the nodemailer transport and connection pool.
+     * For Memory: clears all stored messages.
+     */
+    abstract shutdown(): Promise<void>;
+}
+//# sourceMappingURL=abstract-mail-provider.d.ts.map

package/dist/webafx-mailer/abstract-mail-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-mail-provider.d.ts","sourceRoot":"","sources":["../src/abstract-mail-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9E,8BAAsB,YAAY;IAC9B;;;OAGG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,CAAC;IAE/B;;OAEG;gBACS,MAAM,EAAE,kBAAkB;IAItC;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAExD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAEnC;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CACrC"}

package/dist/webafx-mailer/abstract-mail-provider.js

@@ -0,0 +1,37 @@
+/**
+ * Abstract base class for all mail provider implementations.
+ *
+ * All mail backends (SMTP, Memory) derive from this class, providing
+ * a uniform API for sending emails with health check and graceful
+ * shutdown support. This mirrors the CacheProvider pattern from
+ * @blendsdk/webafx-cache.
+ *
+ * @example
+ * ```typescript
+ * // Usage via concrete provider:
+ * const mailer: MailProvider = new SmtpMailProvider({ host: "smtp.example.com", port: 587 });
+ * const result = await mailer.send({ from: "a@b.com", to: "c@d.com", subject: "Hi", text: "Hello" });
+ * ```
+ */
+import { DEFAULT_SERVICE_NAME } from "./types.js";
+export class MailProvider {
+    /**
+     * Service name used for WebAFX service container registration.
+     * Defaults to "mailer" unless overridden in config.
+     */
+    _serviceName;
+    /**
+     * @param config - Base provider configuration with optional service name
+     */
+    constructor(config) {
+        this._serviceName = config.serviceName ?? DEFAULT_SERVICE_NAME;
+    }
+    /**
+     * Get the service name used for WebAFX service container registration.
+     * This name is used when registering the provider as a singleton service.
+     */
+    get serviceName() {
+        return this._serviceName;
+    }
+}
+//# sourceMappingURL=abstract-mail-provider.js.map

package/dist/webafx-mailer/abstract-mail-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract-mail-provider.js","sourceRoot":"","sources":["../src/abstract-mail-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,OAAgB,YAAY;IAC9B;;;OAGG;IACO,YAAY,CAAS;IAE/B;;OAEG;IACH,YAAY,MAA0B;QAClC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,IAAI,oBAAoB,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,IAAI,WAAW;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;CA0BJ"}

package/dist/webafx-mailer/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @blendsdk/webafx-mailer — Email sending plugin for WebAFX
+ *
+ * Provides an email sending abstraction with two backends:
+ *
+ * - MailProvider (abstract) → SmtpMailProvider, MemoryMailProvider
+ * - Plugin factories: createMailPlugin(), smtpMailPlugin(), memoryMailPlugin(), createMailProvider()
+ *
+ * The SMTP backend uses nodemailer for reliable email delivery.
+ * The Memory backend stores messages in-memory for testing.
+ *
+ * Both integrate with WebAFX via convenience plugin factory functions that
+ * register providers as application-wide singleton services.
+ *
+ * @packageDocumentation
+ */
+export type { MailAttachment, MailMessage, MailResult } from "./types.js";
+export type { MailProviderConfig, SmtpMailConfig, MemoryMailConfig, MailFactoryConfig, } from "./types.js";
+export { DEFAULT_SERVICE_NAME } from "./types.js";
+export { MailProvider } from "./abstract-mail-provider.js";
+export { SmtpMailProvider } from "./smtp-mail-provider.js";
+export { MemoryMailProvider, type SentMailEntry } from "./memory-mail-provider.js";
+export { createMailPlugin, smtpMailPlugin, memoryMailPlugin, createMailProvider, } from "./mail-plugin.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/webafx-mailer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK1E,YAAY,EACR,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKlD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAK3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAKnF,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/webafx-mailer/index.js

@@ -0,0 +1,34 @@
+/**
+ * @blendsdk/webafx-mailer — Email sending plugin for WebAFX
+ *
+ * Provides an email sending abstraction with two backends:
+ *
+ * - MailProvider (abstract) → SmtpMailProvider, MemoryMailProvider
+ * - Plugin factories: createMailPlugin(), smtpMailPlugin(), memoryMailPlugin(), createMailProvider()
+ *
+ * The SMTP backend uses nodemailer for reliable email delivery.
+ * The Memory backend stores messages in-memory for testing.
+ *
+ * Both integrate with WebAFX via convenience plugin factory functions that
+ * register providers as application-wide singleton services.
+ *
+ * @packageDocumentation
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export { DEFAULT_SERVICE_NAME } from "./types.js";
+// ---------------------------------------------------------------------------
+// Abstract Base Class
+// ---------------------------------------------------------------------------
+export { MailProvider } from "./abstract-mail-provider.js";
+// ---------------------------------------------------------------------------
+// Provider Implementations
+// ---------------------------------------------------------------------------
+export { SmtpMailProvider } from "./smtp-mail-provider.js";
+export { MemoryMailProvider } from "./memory-mail-provider.js";
+// ---------------------------------------------------------------------------
+// Plugin Integration (WebAFX)
+// ---------------------------------------------------------------------------
+export { createMailPlugin, smtpMailPlugin, memoryMailPlugin, createMailProvider, } from "./mail-plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/webafx-mailer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiBH,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAsB,MAAM,2BAA2B,CAAC;AAEnF,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAC9E,OAAO,EACH,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,GACrB,MAAM,kBAAkB,CAAC"}

package/dist/webafx-mailer/mail-plugin.d.ts

@@ -0,0 +1,98 @@
+/**
+ * WebAFX plugin integration for mail providers.
+ *
+ * Provides convenience factory functions that wire a MailProvider instance
+ * into a WebAFX application as a singleton service with health check and
+ * graceful shutdown support.
+ *
+ * This is the ONLY file in @blendsdk/webafx-mailer that imports from @blendsdk/webafx,
+ * which is why webafx is an optional peer dependency (not a hard dependency).
+ *
+ * The design mirrors @blendsdk/webafx-cache's cache-plugin.ts exactly.
+ *
+ * @packageDocumentation
+ */
+import type { PluginDefinition } from "../webafx/index.js";
+import { MailProvider } from "./abstract-mail-provider.js";
+import type { MailFactoryConfig, MemoryMailConfig, SmtpMailConfig } from "./types.js";
+/**
+ * Create a WebAFX PluginDefinition from any MailProvider instance.
+ *
+ * This is the core function that wires a mail provider into WebAFX:
+ * 1. Registers the provider as a singleton service in the service container
+ * 2. Hooks the provider's health() into the /health endpoint
+ * 3. Hooks the provider's shutdown() into graceful shutdown
+ *
+ * The service name is read from `provider.serviceName` (defaults to "mailer").
+ *
+ * @param provider - Any MailProvider instance (SMTP, Memory, or custom)
+ * @param options - Optional overrides for plugin priority
+ * @returns A WebAFX PluginDefinition ready to pass to app.use()
+ *
+ * @example
+ * ```typescript
+ * const mailer = new SmtpMailProvider({ host: "smtp.example.com", port: 587 });
+ * app.use(createMailPlugin(mailer));
+ * ```
+ */
+export declare function createMailPlugin(provider: MailProvider, options?: {
+    priority?: number;
+}): PluginDefinition;
+/**
+ * Create a WebAFX mail plugin with an SMTP backend. One-liner registration.
+ *
+ * Creates a SmtpMailProvider internally and returns a PluginDefinition.
+ * The user never needs to instantiate the provider manually.
+ *
+ * @param config - SMTP configuration (host, port, auth, TLS options)
+ * @returns A WebAFX PluginDefinition ready to pass to app.use()
+ *
+ * @example
+ * ```typescript
+ * app.use(smtpMailPlugin({
+ *     host: "smtp.example.com",
+ *     port: 587,
+ *     secure: false,
+ *     auth: { user: "user@example.com", pass: "secret" },
+ * }));
+ * ```
+ */
+export declare function smtpMailPlugin(config: SmtpMailConfig): PluginDefinition;
+/**
+ * Create a WebAFX mail plugin with an In-Memory backend. One-liner registration.
+ *
+ * Creates a MemoryMailProvider internally and returns a PluginDefinition.
+ * Ideal for development and testing — no emails are actually sent.
+ *
+ * @param config - Optional memory configuration (serviceName override)
+ * @returns A WebAFX PluginDefinition ready to pass to app.use()
+ *
+ * @example
+ * ```typescript
+ * app.use(memoryMailPlugin());
+ * ```
+ */
+export declare function memoryMailPlugin(config?: MemoryMailConfig): PluginDefinition;
+/**
+ * Create a MailProvider based on configuration type.
+ *
+ * Factory function for environment-based backend switching.
+ * Returns the appropriate provider based on `config.type`.
+ * Use with `createMailPlugin()` to register in WebAFX.
+ *
+ * @param config - Mail factory configuration with type discriminator
+ * @returns A MailProvider instance (SMTP or Memory)
+ * @throws Error if config.type is not "smtp" or "memory"
+ *
+ * @example
+ * ```typescript
+ * const mailer = createMailProvider({
+ *     type: process.env.NODE_ENV === "production" ? "smtp" : "memory",
+ *     host: process.env.SMTP_HOST,
+ *     port: Number(process.env.SMTP_PORT || 587),
+ * });
+ * app.use(createMailPlugin(mailer));
+ * ```
+ */
+export declare function createMailProvider(config: MailFactoryConfig): MailProvider;
+//# sourceMappingURL=mail-plugin.d.ts.map

package/dist/webafx-mailer/mail-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-plugin.d.ts","sourceRoot":"","sources":["../src/mail-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAatF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAChC,gBAAgB,CA6BlB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAGvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAG5E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,YAAY,CA0B1E"}