@zintrust/core 0.1.28 → 0.1.29

package/src/tools/mail/templates/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Mail Templates (Core)
+ *
+ * This folder contains reusable email templates used by core mail tooling.
+ * Templates may be organized into subfolders (e.g., `auth/`, `orders/`) with
+ * both rich HTML and plain-text variants.
+ */
+export type MailTemplate = {
+    subject: string;
+    text: string;
+    html?: string;
+};
+export type MailTemplateRegistry = Record<string, unknown>;
+export declare const MailTemplateRenderer: Readonly<{
+    renderString: (template: string, data: Record<string, unknown>) => string;
+    render(template: MailTemplate, data: Record<string, unknown>): MailTemplate;
+}>;
+export declare const MailTemplates: Readonly<{
+    auth: Readonly<{
+        welcome: Readonly<{
+            subject: string;
+            text: string;
+            html: string;
+        }>;
+    }>;
+}>;
+export interface MarkdownTemplateMetadata {
+    subject?: string;
+    preheader?: string;
+    variables?: string[];
+    content: string;
+}
+export interface MarkdownRenderResult {
+    html: string;
+    meta: {
+        subject?: string;
+        content: string;
+        variables?: string[];
+    };
+}
+/**
+ * List all available HTML mail templates.
+ * Returns template names without the .html extension.
+ */
+export declare function listTemplates(): string[];
+/**
+ * Load a mail template by name.
+ * Note: HTML templates don't have embedded metadata like markdown templates did.
+ * This function returns the raw HTML content.
+ */
+export declare function loadTemplate(name: string): MarkdownTemplateMetadata;
+/**
+ * Render a mail template with variables.
+ * Note: This is a compatibility function. For production use, use MailTemplateRenderer instead.
+ */
+export declare function renderTemplate(name: string, variables?: Record<string, unknown>): MarkdownRenderResult;
+//# sourceMappingURL=index.d.ts.map

package/src/tools/mail/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/tools/mail/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAW3D,eAAO,MAAM,oBAAoB;6BATD,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MAAM;qBAY3D,YAAY,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;EAO3E,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;EASO,CAAC;AAYlC,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QACJ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAWxC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAiBnE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,oBAAoB,CAoBtB"}

package/src/tools/mail/templates/index.js

@@ -0,0 +1,104 @@
+/**
+ * Mail Templates (Core)
+ *
+ * This folder contains reusable email templates used by core mail tooling.
+ * Templates may be organized into subfolders (e.g., `auth/`, `orders/`) with
+ * both rich HTML and plain-text variants.
+ */
+const renderString = (template, data) => {
+    let out = template;
+    for (const [key, value] of Object.entries(data)) {
+        const replacement = value === null || value === undefined ? '' : String(value);
+        out = out.replaceAll(new RegExp(String.raw `{{\s*${key}\s*}}`, 'g'), replacement);
+    }
+    return out;
+};
+export const MailTemplateRenderer = Object.freeze({
+    renderString,
+    render(template, data) {
+        return {
+            subject: renderString(template.subject, data),
+            text: renderString(template.text, data),
+            html: typeof template.html === 'string' ? renderString(template.html, data) : undefined,
+        };
+    },
+});
+export const MailTemplates = Object.freeze({
+    auth: Object.freeze({
+        // Example template. Apps can add their own workflows under app/Toolkit/Mail.
+        welcome: Object.freeze({
+            subject: 'Welcome, {{name}}!',
+            text: 'Hi {{name}},\n\nWelcome to ZinTrust.',
+            html: '<p>Hi {{name}},</p><p>Welcome to ZinTrust.</p>',
+        }),
+    }),
+});
+import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
+/**
+ * Markdown template compatibility exports
+ * Mail templates are now pure HTML files.
+ * These exports provide backward compatibility for CLI and node.ts exports.
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * List all available HTML mail templates.
+ * Returns template names without the .html extension.
+ */
+export function listTemplates() {
+    try {
+        const templatesDir = join(process.cwd(), 'src/tools/mail/templates');
+        const files = readdirSync(templatesDir);
+        return files
+            .filter((file) => file.endsWith('.html'))
+            .map((file) => file.replace('.html', ''))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Load a mail template by name.
+ * Note: HTML templates don't have embedded metadata like markdown templates did.
+ * This function returns the raw HTML content.
+ */
+export function loadTemplate(name) {
+    try {
+        const templatesDir = join(process.cwd(), 'src/tools/mail/templates');
+        const filePath = join(templatesDir, `${name}.html`);
+        const content = readFileSync(filePath, 'utf8');
+        return {
+            subject: undefined,
+            preheader: undefined,
+            variables: undefined,
+            content,
+        };
+    }
+    catch (error) {
+        throw ErrorFactory.createTryCatchError(`Template "${name}" not found: ${error.message}`);
+    }
+}
+/**
+ * Render a mail template with variables.
+ * Note: This is a compatibility function. For production use, use MailTemplateRenderer instead.
+ */
+export function renderTemplate(name, variables) {
+    const template = loadTemplate(name);
+    let html = template.content;
+    // Simple variable interpolation
+    if (variables) {
+        for (const [key, value] of Object.entries(variables)) {
+            const regex = new RegExp(String.raw `{{\s*${key}\s*}}`, 'g');
+            html = html.replace(regex, String(value ?? ''));
+        }
+    }
+    return {
+        html,
+        meta: {
+            subject: template.subject,
+            content: template.content,
+            variables: template.variables,
+        },
+    };
+}

package/src/tools/mail/testing.d.ts

@@ -0,0 +1,41 @@
+type SentRecord = {
+    to: string[];
+    subject: string;
+    text: string;
+    html?: string;
+    from?: {
+        address?: string;
+        name?: string;
+    };
+    attachments?: Array<{
+        filename: string;
+        content: Buffer;
+    }>;
+};
+type FakeSendInput = {
+    to: string | string[];
+    subject: string;
+    text: string;
+    html?: string;
+    from?: {
+        address?: string;
+        name?: string;
+    };
+    attachments?: Array<{
+        filename: string;
+        content: Buffer;
+    }>;
+};
+export declare const MailFake: Readonly<{
+    _sent: Array<SentRecord>;
+    send(input: FakeSendInput): Promise<{
+        ok: boolean;
+        driver: string;
+    }>;
+    assertSent(predicate: (r: SentRecord) => boolean): void;
+    assertNotSent(predicate: (r: SentRecord) => boolean): void;
+    getSent(): SentRecord[];
+    reset(): void;
+}>;
+export default MailFake;
+//# sourceMappingURL=testing.d.ts.map

package/src/tools/mail/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../../src/tools/mail/testing.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,GAAG;IAChB,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D,CAAC;AAEF,eAAO,MAAM,QAAQ;WACN,KAAK,CAAC,UAAU,CAAC;gBAEZ,aAAa,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;0BAcpD,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO;6BAMvB,CAAC,CAAC,EAAE,UAAU,KAAK,OAAO;;;EAanD,CAAC;AAEH,eAAe,QAAQ,CAAC"}

package/src/tools/mail/testing.js

@@ -0,0 +1,34 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+export const MailFake = Object.freeze({
+    _sent: [],
+    async send(input) {
+        const to = Array.isArray(input.to) ? input.to : [input.to];
+        this._sent.push({
+            to,
+            subject: input.subject,
+            text: input.text,
+            html: input.html,
+            from: input.from,
+            attachments: input.attachments,
+        });
+        await Promise.resolve();
+        return { ok: true, driver: 'disabled' };
+    },
+    assertSent(predicate) {
+        if (!this._sent.some(predicate)) {
+            throw ErrorFactory.createValidationError('Expected a sent mail matching predicate');
+        }
+    },
+    assertNotSent(predicate) {
+        if (this._sent.some(predicate)) {
+            throw ErrorFactory.createValidationError('Expected no sent mail matching predicate');
+        }
+    },
+    getSent() {
+        return this._sent.slice();
+    },
+    reset() {
+        this._sent.length = 0;
+    },
+});
+export default MailFake;

package/src/tools/notification/Driver.d.ts

@@ -0,0 +1,11 @@
+export interface INotificationDriver {
+    send(recipient: string, message: string, options?: Record<string, unknown>): Promise<unknown>;
+}
+export type NotificationPayload = {
+    recipient: string;
+    message: string;
+    options?: Record<string, unknown>;
+};
+declare const _default: INotificationDriver;
+export default _default;
+//# sourceMappingURL=Driver.d.ts.map

package/src/tools/notification/Driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Driver.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/Driver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/F;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;wBAE8B,mBAAmB;AAAnD,wBAAoD"}

package/src/tools/notification/Driver.js

@@ -0,0 +1 @@
+export default {};

package/src/tools/notification/Notification.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Notification - Public API entry point
+ *
+ * A small wrapper over NotificationService to provide the expected module name.
+ */
+export declare const Notification: Readonly<{
+    send: (recipient: string, message: string, options?: Record<string, unknown>) => Promise<unknown>;
+    NotifyNow: (recipient: string, message: string, options?: Record<string, unknown>) => Promise<unknown>;
+    NotifyLater(recipient: string, message: string, notifyOptions?: Record<string, unknown>, queueOptions?: {
+        queueName?: string;
+        timestamp?: number;
+    }): Promise<string>;
+    queue(queueName: string): Readonly<{
+        NotifyLater: (recipient: string, message: string, notifyOptions?: Record<string, unknown>, queueOptions?: {
+            timestamp?: number;
+        }) => Promise<string>;
+    }>;
+    channel: (name: string) => Readonly<{
+        send: (recipient: string, message: string, options?: Record<string, unknown>) => Promise<unknown>;
+    }>;
+    listDrivers: () => string[];
+}>;
+export default Notification;
+//# sourceMappingURL=Notification.d.ts.map

package/src/tools/notification/Notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Notification.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/Notification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,YAAY;;;2BAQV,MAAM,WACR,MAAM,kBACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBACxB;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACvD,OAAO,CAAC,MAAM,CAAC;qBAcD,MAAM;iCAGN,MAAM,WACR,MAAM,kBACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBACxB;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE;;oBAM1B,MAAM;0BAEM,MAAM,WAAW,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EAItF,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/src/tools/notification/Notification.js

@@ -0,0 +1,35 @@
+/**
+ * Notification - Public API entry point
+ *
+ * A small wrapper over NotificationService to provide the expected module name.
+ */
+import { NotificationService } from './Service.js';
+export const Notification = Object.freeze({
+    send: NotificationService.send,
+    // Alias for send() - explicit intent for immediate notification
+    NotifyNow: NotificationService.send,
+    // Queue notification for async processing
+    async NotifyLater(recipient, message, notifyOptions = {}, queueOptions = {}) {
+        const { queueName = 'notifications', timestamp = Date.now() } = queueOptions;
+        const { Queue } = await import('../queue/Queue.js');
+        const messageId = await Queue.enqueue(queueName, {
+            type: 'notification',
+            recipient,
+            message,
+            options: notifyOptions,
+            timestamp,
+            attempts: 0,
+        });
+        return messageId;
+    },
+    queue(queueName) {
+        return Object.freeze({
+            NotifyLater: async (recipient, message, notifyOptions = {}, queueOptions = {}) => Notification.NotifyLater(recipient, message, notifyOptions, { ...queueOptions, queueName }),
+        });
+    },
+    channel: (name) => Object.freeze({
+        send: async (recipient, message, options) => NotificationService.sendVia(name, recipient, message, options),
+    }),
+    listDrivers: NotificationService.listDrivers,
+});
+export default Notification;

package/src/tools/notification/NotificationChannelRegistry.d.ts

@@ -0,0 +1,15 @@
+import type { KnownNotificationDriverConfig } from '../../config/type';
+declare function register(name: string, config: KnownNotificationDriverConfig): void;
+declare function has(name: string): boolean;
+declare function get(name: string): KnownNotificationDriverConfig;
+declare function list(): string[];
+declare function reset(): void;
+export declare const NotificationChannelRegistry: Readonly<{
+    register: typeof register;
+    has: typeof has;
+    get: typeof get;
+    list: typeof list;
+    reset: typeof reset;
+}>;
+export default NotificationChannelRegistry;
+//# sourceMappingURL=NotificationChannelRegistry.d.ts.map

package/src/tools/notification/NotificationChannelRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationChannelRegistry.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/NotificationChannelRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAUlE,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,6BAA6B,GAAG,IAAI,CAI3E;AAED,iBAAS,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElC;AAED,iBAAS,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,6BAA6B,CAOxD;AAED,iBAAS,IAAI,IAAI,MAAM,EAAE,CAExB;AAED,iBAAS,KAAK,IAAI,IAAI,CAErB;AAED,eAAO,MAAM,2BAA2B;;;;;;EAMtC,CAAC;AAEH,eAAe,2BAA2B,CAAC"}

package/src/tools/notification/NotificationChannelRegistry.js

@@ -0,0 +1,36 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+const registry = new Map();
+const normalizeKey = (name) => String(name ?? '')
+    .trim()
+    .toLowerCase();
+function register(name, config) {
+    const key = normalizeKey(name);
+    if (key === '')
+        return;
+    registry.set(key, config);
+}
+function has(name) {
+    return registry.has(normalizeKey(name));
+}
+function get(name) {
+    const key = normalizeKey(name);
+    const cfg = registry.get(key);
+    if (cfg === undefined) {
+        throw ErrorFactory.createConfigError(`Notification channel not registered: ${name}`);
+    }
+    return cfg;
+}
+function list() {
+    return Array.from(registry.keys()).sort((a, b) => a.localeCompare(b));
+}
+function reset() {
+    registry.clear();
+}
+export const NotificationChannelRegistry = Object.freeze({
+    register,
+    has,
+    get,
+    list,
+    reset,
+});
+export default NotificationChannelRegistry;

package/src/tools/notification/NotificationRuntimeRegistration.d.ts

@@ -0,0 +1,13 @@
+import type { NotificationConfigInput } from '../../config/type';
+/**
+ * Register notification channels from runtime config.
+ *
+ * - Every `notificationConfig.drivers[name]` is registered under `name`.
+ * - The configured default is also registered as `default`.
+ */
+export declare function registerNotificationChannelsFromRuntimeConfig(config: Pick<NotificationConfigInput, 'default' | 'drivers'>): void;
+export declare const NotificationRuntimeRegistration: Readonly<{
+    registerNotificationChannelsFromRuntimeConfig: typeof registerNotificationChannelsFromRuntimeConfig;
+}>;
+export default NotificationRuntimeRegistration;
+//# sourceMappingURL=NotificationRuntimeRegistration.d.ts.map

package/src/tools/notification/NotificationRuntimeRegistration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/NotificationRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAI5D;;;;;GAKG;AACH,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,CAAC,GAC3D,IAAI,CAiBN;AAED,eAAO,MAAM,+BAA+B;;EAE1C,CAAC;AAEH,eAAe,+BAA+B,CAAC"}

package/src/tools/notification/NotificationRuntimeRegistration.js

@@ -0,0 +1,25 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { NotificationChannelRegistry } from './NotificationChannelRegistry.js';
+/**
+ * Register notification channels from runtime config.
+ *
+ * - Every `notificationConfig.drivers[name]` is registered under `name`.
+ * - The configured default is also registered as `default`.
+ */
+export function registerNotificationChannelsFromRuntimeConfig(config) {
+    for (const [name, driverConfig] of Object.entries(config.drivers)) {
+        NotificationChannelRegistry.register(name, driverConfig);
+    }
+    const defaultName = (config.default ?? '').toString().trim().toLowerCase();
+    if (defaultName.length === 0) {
+        throw ErrorFactory.createConfigError('Notification default channel is not configured');
+    }
+    if (!NotificationChannelRegistry.has(defaultName)) {
+        throw ErrorFactory.createConfigError(`Notification default channel not configured: ${defaultName}`);
+    }
+    NotificationChannelRegistry.register('default', NotificationChannelRegistry.get(defaultName));
+}
+export const NotificationRuntimeRegistration = Object.freeze({
+    registerNotificationChannelsFromRuntimeConfig,
+});
+export default NotificationRuntimeRegistration;

package/src/tools/notification/Registry.d.ts

@@ -0,0 +1,10 @@
+type DriverLike = {
+    send(recipient: string, message: string, options?: Record<string, unknown>): Promise<unknown>;
+};
+export declare const NotificationRegistry: Readonly<{
+    register(name: string, driver: DriverLike): void;
+    get(name: string): DriverLike;
+    list(): string[];
+}>;
+export default NotificationRegistry;
+//# sourceMappingURL=Registry.d.ts.map

package/src/tools/notification/Registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registry.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/Registry.ts"],"names":[],"mappings":"AAMA,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/F,CAAC;AASF,eAAO,MAAM,oBAAoB;mBAChB,MAAM,UAAU,UAAU;cAI/B,MAAM,GAAG,UAAU;YAOrB,MAAM,EAAE;EAGhB,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/src/tools/notification/Registry.js

@@ -0,0 +1,26 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { ConsoleDriver } from './drivers/Console.js';
+import { SlackNotificationDriver } from './drivers/SlackNotification.js';
+import { TermiiDriver } from './drivers/Termii.js';
+import { TwilioNotificationDriver } from './drivers/TwilioNotification.js';
+const drivers = new Map();
+drivers.set('termii', TermiiDriver);
+drivers.set('console', ConsoleDriver);
+drivers.set('slack', SlackNotificationDriver);
+drivers.set('twilio', TwilioNotificationDriver);
+export const NotificationRegistry = Object.freeze({
+    register(name, driver) {
+        drivers.set(name.toLowerCase(), driver);
+    },
+    get(name) {
+        const key = (name ?? '').toString().trim().toLowerCase();
+        const drv = drivers.get(key);
+        if (!drv)
+            throw ErrorFactory.createConfigError(`Notification driver not registered: ${name}`);
+        return drv;
+    },
+    list() {
+        return Array.from(drivers.keys()).sort((a, b) => a.localeCompare(b));
+    },
+});
+export default NotificationRegistry;

package/src/tools/notification/Service.d.ts

@@ -0,0 +1,7 @@
+export declare const NotificationService: Readonly<{
+    send(recipient: string, message: string, options?: Record<string, unknown>): Promise<unknown>;
+    sendVia(channelName: string, recipient: string, message: string, options?: Record<string, unknown>): Promise<unknown>;
+    listDrivers(): string[];
+}>;
+export default NotificationService;
+//# sourceMappingURL=Service.d.ts.map

package/src/tools/notification/Service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Service.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/Service.ts"],"names":[],"mappings":"AAoEA,eAAO,MAAM,mBAAmB;oBACR,MAAM,WAAW,MAAM,YAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBAUhE,MAAM,aACR,MAAM,WACR,MAAM,YACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;mBAgDnB,MAAM,EAAE;EAGvB,CAAC;AAEH,eAAe,mBAAmB,CAAC"}

package/src/tools/notification/Service.js

@@ -0,0 +1,91 @@
+import notificationConfig from '../../config/notification.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { NotificationConfig } from './config.js';
+import { ConsoleDriver } from './drivers/Console.js';
+import { SlackDriver } from './drivers/Slack.js';
+import { TwilioDriver } from './drivers/Twilio.js';
+import { NotificationChannelRegistry } from './NotificationChannelRegistry.js';
+import { NotificationRegistry } from './Registry.js';
+const assertValidRecipientAndMessage = (recipient, message) => {
+    if (typeof recipient !== 'string' || recipient.trim() === '') {
+        throw ErrorFactory.createValidationError('Recipient required');
+    }
+    if (typeof message !== 'string' || message.trim() === '') {
+        throw ErrorFactory.createValidationError('Message required');
+    }
+};
+const resolveChannelConfig = (channelName) => {
+    const selected = String(channelName ?? '').trim();
+    const hasSelection = selected.length > 0;
+    return hasSelection && NotificationChannelRegistry.has(selected)
+        ? NotificationChannelRegistry.get(selected)
+        : notificationConfig.getDriverConfig(selected);
+};
+const sendTermii = async (cfg, recipient, message, options) => {
+    const apiKey = String(cfg.apiKey ?? '');
+    if (apiKey.trim() === '') {
+        throw ErrorFactory.createConfigError('TERMII_API_KEY is not configured');
+    }
+    const url = String(cfg.endpoint ?? '').trim();
+    if (url === '') {
+        throw ErrorFactory.createConfigError('TERMII_ENDPOINT is not configured');
+    }
+    const payload = {
+        to: recipient,
+        from: cfg.sender,
+        sms: message,
+        api_key: apiKey,
+        ...options,
+    };
+    const res = await globalThis.fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(payload),
+    });
+    if (!res.ok) {
+        const txt = await res.text().catch(() => '');
+        throw ErrorFactory.createTryCatchError(`Termii request failed (${res.status})`, {
+            status: res.status,
+            body: txt,
+        });
+    }
+    return res.json().catch(() => ({}));
+};
+export const NotificationService = Object.freeze({
+    async send(recipient, message, options = {}) {
+        assertValidRecipientAndMessage(recipient, message);
+        const driverName = NotificationConfig.getDriver();
+        const driver = NotificationRegistry.get(driverName);
+        return driver.send(recipient, message, options);
+    },
+    async sendVia(channelName, recipient, message, options = {}) {
+        assertValidRecipientAndMessage(recipient, message);
+        const cfg = resolveChannelConfig(channelName);
+        switch (cfg.driver) {
+            case 'console':
+                return ConsoleDriver.send(recipient, message, options);
+            case 'slack': {
+                const slackCfg = cfg;
+                const payload = { text: message, ...options };
+                return SlackDriver.send({ webhookUrl: slackCfg.webhookUrl }, payload);
+            }
+            case 'twilio': {
+                const twilioCfg = cfg;
+                return TwilioDriver.send({
+                    accountSid: twilioCfg.accountSid,
+                    authToken: twilioCfg.authToken,
+                    from: twilioCfg.fromNumber,
+                }, { to: recipient, body: message });
+            }
+            case 'termii': {
+                return sendTermii(cfg, recipient, message, options);
+            }
+            default:
+                throw ErrorFactory.createConfigError(`Notification: unsupported driver: ${String(cfg?.driver)}`);
+        }
+    },
+    listDrivers() {
+        return NotificationRegistry.list();
+    },
+});
+export default NotificationService;

package/src/tools/notification/config.d.ts

@@ -0,0 +1,5 @@
+export declare const NotificationConfig: Readonly<{
+    getDriver: () => string;
+}>;
+export default NotificationConfig;
+//# sourceMappingURL=config.d.ts.map

package/src/tools/notification/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,kBAAkB;qBACd,MAAM;EACrB,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/src/tools/notification/config.js

@@ -0,0 +1,5 @@
+import { Env } from '../../config/env.js';
+export const NotificationConfig = Object.freeze({
+    getDriver: () => Env.get('NOTIFICATION_DRIVER', 'console').trim().toLowerCase(),
+});
+export default NotificationConfig;

package/src/tools/notification/drivers/BaseDriver.d.ts

@@ -0,0 +1,5 @@
+export declare const BaseDriver: Readonly<{
+    send(): Promise<unknown>;
+}>;
+export default BaseDriver;
+//# sourceMappingURL=BaseDriver.d.ts.map

package/src/tools/notification/drivers/BaseDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseDriver.d.ts","sourceRoot":"","sources":["../../../../../src/tools/notification/drivers/BaseDriver.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;YACP,OAAO,CAAC,OAAO,CAAC;EAI9B,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/src/tools/notification/drivers/BaseDriver.js

@@ -0,0 +1,8 @@
+import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
+export const BaseDriver = Object.freeze({
+    async send() {
+        await Promise.resolve();
+        throw ErrorFactory.createConfigError('Notification driver must implement send()');
+    },
+});
+export default BaseDriver;

package/src/tools/notification/drivers/Console.d.ts

@@ -0,0 +1,7 @@
+export declare const ConsoleDriver: Readonly<{
+    send(_recipient: string, _message: string, _options?: Record<string, unknown>): Promise<{
+        ok: boolean;
+    }>;
+}>;
+export default ConsoleDriver;
+//# sourceMappingURL=Console.d.ts.map

package/src/tools/notification/drivers/Console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Console.d.ts","sourceRoot":"","sources":["../../../../../src/tools/notification/drivers/Console.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;qBAEV,MAAM,YACR,MAAM,aACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;EAU3B,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/src/tools/notification/drivers/Console.js

@@ -0,0 +1,13 @@
+export const ConsoleDriver = Object.freeze({
+    async send(_recipient, _message, _options = {}) {
+        // Console driver is for development & simple systems — it should not throw
+        // Keep implementation minimal and synchronous-friendly
+        // Use out of band logging via ErrorHandler/Logger if required by callers
+        // Here we simply return a small payload indicating success
+        // Example: { ok: true }
+        // NOTE: keep body small to avoid leaking test runner logs
+        await Promise.resolve();
+        return { ok: true };
+    },
+});
+export default ConsoleDriver;