@zintrust/core 0.1.1 → 0.1.2

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

@@ -0,0 +1,17 @@
+export declare const loadTemplate: (name: string) => {
+    subject?: string;
+    preheader?: string;
+    variables?: string[];
+    content: string;
+};
+export { listTemplates, renderTemplate } from '../../templates/markdown/registry';
+declare const _default: {
+    loadTemplate: (name: string) => {
+        subject?: string;
+        preheader?: string;
+        variables?: string[];
+        content: string;
+    };
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/mail/templates/markdown/index.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,KACX;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAkD/E,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;;yBArD1E,MAAM,KACX;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;;AAsDlF,wBAAgC"}

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

@@ -0,0 +1,49 @@
+import { readFileSync } from '../../../../node-singletons/fs';
+import { join } from '../../../../node-singletons/path';
+export const loadTemplate = (name) => {
+    // name e.g. 'auth/welcome'
+    const parts = name.split('/');
+    // Safe parser for top comment metadata <!-- Key: Value --> lines to avoid regex backtracking
+    const dir = join(process.cwd(), 'src', 'tools', 'mail', 'templates', 'markdown', ...parts.slice(0, -1));
+    const leaf = parts.at(-1) ?? '';
+    const filePath = join(dir, `${leaf}.md`);
+    const raw = readFileSync(filePath, 'utf-8');
+    const meta = {};
+    const parseMetaLine = (line) => {
+        // Must start with <!-- and end with --> exactly; trim the inner part and split at first colon
+        if (!line.startsWith('<!--') || !line.endsWith('-->'))
+            return null;
+        const inner = line.slice('<!--'.length, -'-->'.length).trim();
+        const idx = inner.indexOf(':');
+        if (idx === -1)
+            return null;
+        const key = inner.slice(0, idx).trim().toLowerCase();
+        const val = inner.slice(idx + 1).trim();
+        if (!key)
+            return null;
+        return [key, val];
+    };
+    // Parse top comment metadata <!-- Key: Value --> lines
+    const lines = raw.split(/\r?\n/);
+    let i = 0;
+    for (; i < lines.length; i++) {
+        const kv = parseMetaLine(lines[i]);
+        if (!kv)
+            break;
+        const [key, val] = kv;
+        if (key === 'subject')
+            meta.subject = val;
+        if (key === 'preheader')
+            meta.preheader = val;
+        if (key === 'variables') {
+            meta.variables = val
+                .split(',')
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+    }
+    const content = lines.slice(i).join('\n').trim();
+    return { content, ...meta };
+};
+export { listTemplates, renderTemplate } from '../../templates/markdown/registry';
+export default { loadTemplate };

package/src/tools/mail/templates/markdown/registry.d.ts

@@ -0,0 +1,15 @@
+import { loadTemplate } from '../../templates/markdown';
+export declare const listTemplates: () => string[];
+export declare const renderTemplate: (name: string, vars?: Record<string, unknown>) => {
+    html: string;
+    meta: ReturnType<typeof loadTemplate>;
+};
+declare const _default: {
+    listTemplates: () => string[];
+    renderTemplate: (name: string, vars?: Record<string, unknown>) => {
+        html: string;
+        meta: ReturnType<typeof loadTemplate>;
+    };
+};
+export default _default;
+//# sourceMappingURL=registry.d.ts.map

package/src/tools/mail/templates/markdown/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/mail/templates/markdown/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AA2BxD,eAAO,MAAM,aAAa,QAAO,MAAM,EAEtC,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,MAAM,MAAM,EACZ,OAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,KACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;CAKvD,CAAC;;yBAZ+B,MAAM,EAAE;2BAKjC,MAAM,SACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;KAAE;;AAO1D,wBAAiD"}

package/src/tools/mail/templates/markdown/registry.js

@@ -0,0 +1,34 @@
+import { loadTemplate } from '../../templates/markdown';
+import { validateTemplateMeta } from '../../templates/markdown/validator';
+import { readdirSync, statSync } from '../../../../node-singletons/fs';
+import { join, relative } from '../../../../node-singletons/path';
+import { MarkdownRenderer } from '../../../templates';
+const BASE = join(process.cwd(), 'src', 'tools', 'mail', 'templates', 'markdown');
+const walkDir = (dir, base = dir) => {
+    const entries = readdirSync(dir);
+    let files = [];
+    for (const e of entries) {
+        const p = join(dir, e);
+        const s = statSync(p);
+        if (s.isDirectory()) {
+            files = files.concat(walkDir(p, base));
+            continue;
+        }
+        if (e.endsWith('.md')) {
+            const rel = relative(base, p).replaceAll('\\', '/');
+            const withoutExt = rel.toLowerCase().endsWith('.md') ? rel.slice(0, -3) : rel;
+            files.push(withoutExt);
+        }
+    }
+    return files;
+};
+export const listTemplates = () => {
+    return walkDir(BASE);
+};
+export const renderTemplate = (name, vars = {}) => {
+    const tpl = loadTemplate(name);
+    validateTemplateMeta(name, tpl);
+    const html = MarkdownRenderer.render(tpl.content, vars);
+    return { html, meta: tpl };
+};
+export default { listTemplates, renderTemplate };

package/src/tools/mail/templates/markdown/validator.d.ts

@@ -0,0 +1,16 @@
+export declare const validateTemplateMeta: (name: string, tpl: {
+    subject?: string;
+    preheader?: string;
+    variables?: string[];
+    content: string;
+}) => true;
+declare const _default: {
+    validateTemplateMeta: (name: string, tpl: {
+        subject?: string;
+        preheader?: string;
+        variables?: string[];
+        content: string;
+    }) => true;
+};
+export default _default;
+//# sourceMappingURL=validator.d.ts.map

package/src/tools/mail/templates/markdown/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/mail/templates/markdown/validator.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,KAAK;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,KACA,IA0BF,CAAC;;iCAjCM,MAAM,OACP;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB,KACA,IAAI;;AA4BP,wBAAwC"}

package/src/tools/mail/templates/markdown/validator.js

@@ -0,0 +1,24 @@
+import { ErrorFactory } from '../../../../exceptions/ZintrustError';
+export const validateTemplateMeta = (name, tpl) => {
+    if (tpl.subject === null || tpl.subject === undefined || tpl.subject.trim() === '') {
+        throw ErrorFactory.createValidationError('Template missing subject', { name });
+    }
+    const placeholders = new Set();
+    const rx = /{{\s*([a-zA-Z0-9_.-]+)\s*}}/g;
+    let m;
+    while ((m = rx.exec(tpl.content)) !== null) {
+        placeholders.add(m[1]);
+    }
+    const metaVars = new Set((tpl.variables ?? []).map((s) => s.trim()).filter(Boolean));
+    const missingInContent = Array.from(metaVars).filter((v) => !placeholders.has(v));
+    const missingInMeta = Array.from(placeholders).filter((v) => !metaVars.has(v));
+    if (missingInContent.length > 0 || missingInMeta.length > 0) {
+        throw ErrorFactory.createValidationError('Template variables mismatch', {
+            name,
+            missingInContent,
+            missingInMeta,
+        });
+    }
+    return true;
+};
+export default { validateTemplateMeta };

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';
+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,11 @@
+/**
+ * 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>;
+    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;;;EAGvB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/src/tools/notification/Notification.js

@@ -0,0 +1,11 @@
+/**
+ * Notification - Public API entry point
+ *
+ * A small wrapper over NotificationService to provide the expected module name.
+ */
+import { NotificationService } from './Service';
+export const Notification = Object.freeze({
+    send: NotificationService.send,
+    listDrivers: NotificationService.listDrivers,
+});
+export default Notification;

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":"AAIA,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;AAOF,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,22 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError';
+import { ConsoleDriver } from './drivers/Console';
+import { TermiiDriver } from './drivers/Termii';
+const drivers = new Map();
+drivers.set('termii', TermiiDriver);
+drivers.set('console', ConsoleDriver);
+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,6 @@
+export declare const NotificationService: Readonly<{
+    send(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":"AAIA,eAAO,MAAM,mBAAmB;oBACR,MAAM,WAAW,MAAM,YAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;mBAYhE,MAAM,EAAE;EAGvB,CAAC;AAEH,eAAe,mBAAmB,CAAC"}

package/src/tools/notification/Service.js

@@ -0,0 +1,18 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError';
+import { NotificationConfig } from './config';
+import { NotificationRegistry } from './Registry';
+export const NotificationService = Object.freeze({
+    async send(recipient, message, options = {}) {
+        if (!recipient || typeof recipient !== 'string')
+            throw ErrorFactory.createValidationError('Recipient required');
+        if (!message || typeof message !== 'string')
+            throw ErrorFactory.createValidationError('Message required');
+        const driverName = NotificationConfig.getDriver();
+        const driver = NotificationRegistry.get(driverName);
+        return driver.send(recipient, message, options);
+    },
+    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';
+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';
+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;

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

@@ -0,0 +1,16 @@
+export type SlackConfig = {
+    webhookUrl: string;
+};
+export type SlackMessage = Record<string, unknown>;
+export declare const SlackDriver: Readonly<{
+    send(config: SlackConfig, payload: SlackMessage): Promise<{
+        ok: boolean;
+        status?: number;
+    }>;
+}>;
+export declare const sendSlackWebhook: (config: SlackConfig, payload: SlackMessage) => Promise<{
+    ok: boolean;
+    status?: number;
+}>;
+export default SlackDriver;
+//# sourceMappingURL=Slack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Slack.d.ts","sourceRoot":"","sources":["../../../../../src/tools/notification/drivers/Slack.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,eAAO,MAAM,WAAW;iBAEZ,WAAW,WACV,YAAY,GACpB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;EAsB5C,CAAC;AAEH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,WAAW,EACnB,SAAS,YAAY,KACpB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAsC,CAAC;AAElF,eAAe,WAAW,CAAC"}

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

@@ -0,0 +1,24 @@
+import { ErrorFactory } from '../../../exceptions/ZintrustError';
+export const SlackDriver = Object.freeze({
+    async send(config, payload) {
+        const url = config.webhookUrl ?? '';
+        if (typeof url !== 'string' || url.trim() === '') {
+            throw ErrorFactory.createConfigError('Slack: missing webhook URL');
+        }
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw ErrorFactory.createConnectionError(`Slack webhook failed (${res.status})`, {
+                status: res.status,
+                body: text,
+            });
+        }
+        return { ok: true, status: res.status };
+    },
+});
+export const sendSlackWebhook = async (config, payload) => SlackDriver.send(config, payload);
+export default SlackDriver;

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

@@ -0,0 +1,10 @@
+/**
+ * Termii SMS Driver (skeleton)
+ * - Reads TERMII_API_KEY and TERMII_SENDER from env
+ * - POSTs to Termii API endpoint
+ */
+export declare const TermiiDriver: Readonly<{
+    send(recipient: string, message: string, options?: Record<string, unknown>): Promise<unknown>;
+}>;
+export default TermiiDriver;
+//# sourceMappingURL=Termii.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Termii.d.ts","sourceRoot":"","sources":["../../../../../src/tools/notification/drivers/Termii.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,YAAY;oBACD,MAAM,WAAW,MAAM,YAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EA6C/E,CAAC;AAEH,eAAe,YAAY,CAAC"}

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

@@ -0,0 +1,47 @@
+import { ErrorFactory } from '../../../exceptions/ZintrustError';
+/**
+ * Termii SMS Driver (skeleton)
+ * - Reads TERMII_API_KEY and TERMII_SENDER from env
+ * - POSTs to Termii API endpoint
+ */
+export const TermiiDriver = Object.freeze({
+    async send(recipient, message, options = {}) {
+        if (!recipient || typeof recipient !== 'string') {
+            throw ErrorFactory.createValidationError('Recipient phone number is required');
+        }
+        if (!message || typeof message !== 'string') {
+            throw ErrorFactory.createValidationError('Message body is required');
+        }
+        const apiKey = process.env['TERMII_API_KEY'] ?? '';
+        const sender = process.env['TERMII_SENDER'] ?? 'Zintrust';
+        if (!apiKey) {
+            throw ErrorFactory.createConfigError('TERMII_API_KEY is not configured');
+        }
+        const payload = {
+            to: recipient,
+            from: sender,
+            sms: message,
+            api_key: apiKey,
+            ...options,
+        };
+        // Use global fetch — tests will mock this
+        const url = 'https://api.termii.com/sms/send';
+        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,
+            });
+        }
+        const json = await res.json().catch(() => ({}));
+        return json;
+    },
+});
+export default TermiiDriver;

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

@@ -0,0 +1,21 @@
+export type TwilioConfig = {
+    accountSid: string;
+    authToken: string;
+    from: string;
+};
+export type TwilioMessage = {
+    to: string;
+    body: string;
+};
+export declare const TwilioDriver: Readonly<{
+    send(config: TwilioConfig, payload: TwilioMessage): Promise<{
+        ok: boolean;
+        status?: number;
+    }>;
+}>;
+export declare const sendSms: (config: TwilioConfig, payload: TwilioMessage) => Promise<{
+    ok: boolean;
+    status?: number;
+}>;
+export default TwilioDriver;
+//# sourceMappingURL=Twilio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Twilio.d.ts","sourceRoot":"","sources":["../../../../../src/tools/notification/drivers/Twilio.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAOF,eAAO,MAAM,YAAY;iBAEb,YAAY,WACX,aAAa,GACrB,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;EA+C5C,CAAC;AAEH,eAAO,MAAM,OAAO,GAClB,QAAQ,YAAY,EACpB,SAAS,aAAa,KACrB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAuC,CAAC;AAEnF,eAAe,YAAY,CAAC"}

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

@@ -0,0 +1,48 @@
+import { ErrorFactory } from '../../../exceptions/ZintrustError';
+const buildUrl = (accountSid) => {
+    const base = 'https://api.twilio.com/2010-04-01/Accounts/';
+    return `${base}${accountSid}/Messages.json`;
+};
+export const TwilioDriver = Object.freeze({
+    async send(config, payload) {
+        const accountSid = config.accountSid ?? '';
+        const authToken = config.authToken ?? '';
+        const from = config.from ?? '';
+        if (typeof accountSid !== 'string' || accountSid.trim() === '') {
+            throw ErrorFactory.createConfigError('Twilio: missing accountSid');
+        }
+        if (typeof authToken !== 'string' || authToken.trim() === '') {
+            throw ErrorFactory.createConfigError('Twilio: missing authToken');
+        }
+        if (typeof from !== 'string' || from.trim() === '') {
+            throw ErrorFactory.createConfigError('Twilio: missing from number');
+        }
+        if (typeof payload.to !== 'string' || payload.to.trim() === '') {
+            throw ErrorFactory.createValidationError('Twilio: missing to number');
+        }
+        const url = buildUrl(accountSid);
+        const params = new URLSearchParams();
+        params.append('To', payload.to);
+        params.append('From', from);
+        params.append('Body', payload.body);
+        const basic = Buffer.from(`${accountSid}:${authToken}`).toString('base64');
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: {
+                Authorization: `Basic ${basic}`,
+                'content-type': 'application/x-www-form-urlencoded',
+            },
+            body: params.toString(),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw ErrorFactory.createConnectionError(`Twilio API failed (${res.status})`, {
+                status: res.status,
+                body,
+            });
+        }
+        return { ok: true, status: res.status };
+    },
+});
+export const sendSms = async (config, payload) => TwilioDriver.send(config, payload);
+export default TwilioDriver;

package/src/tools/notification/templates/markdown/index.d.ts

@@ -0,0 +1,15 @@
+export declare const loadTemplate: (name: string) => {
+    subject?: string;
+    content: string;
+    variables?: string[];
+};
+export { listTemplates, renderTemplate } from '../../templates/markdown/registry';
+declare const _default: {
+    loadTemplate: (name: string) => {
+        subject?: string;
+        content: string;
+        variables?: string[];
+    };
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map