@zintrust/core 0.1.13 → 0.1.14

package/src/tools/broadcast/Broadcast.js

@@ -4,34 +4,58 @@ import { RedisDriver } from './drivers/Redis.js';
 import { RedisHttpsDriver } from './drivers/RedisHttps.js';
 import broadcastConfig from '../../config/broadcast.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
-export const Broadcast = Object.freeze({
-    async send(channel, event, data) {
-        const driver = broadcastConfig.getDriverName();
-        const config = broadcastConfig.getDriverConfig();
-        if (driver === 'inmemory') {
-            const result = await InMemoryDriver.send(undefined, channel, event, data);
-            return result;
+const resolveBroadcasterConfig = async (name) => {
+    const selection = (name ?? broadcastConfig.getDriverName()).toString().trim().toLowerCase();
+    try {
+        const { BroadcastRegistry } = await import('./BroadcastRegistry.js');
+        if (BroadcastRegistry.has(selection)) {
+            return BroadcastRegistry.get(selection);
         }
-        if (driver === 'pusher') {
-            if (config.driver !== 'pusher') {
-                throw ErrorFactory.createConfigError('Broadcast driver config mismatch: expected pusher');
-            }
-            return PusherDriver.send(config, channel, event, data);
+        try {
+            const { registerBroadcastersFromRuntimeConfig } = await import('./BroadcastRuntimeRegistration.js');
+            registerBroadcastersFromRuntimeConfig(broadcastConfig);
         }
-        if (driver === 'redis') {
-            if (config.driver !== 'redis') {
-                throw ErrorFactory.createConfigError('Broadcast driver config mismatch: expected redis');
-            }
-            return RedisDriver.send(config, channel, event, data);
+        catch {
+            // best-effort
         }
-        if (driver === 'redishttps') {
-            if (config.driver !== 'redishttps') {
-                throw ErrorFactory.createConfigError('Broadcast driver config mismatch: expected redishttps');
-            }
-            return RedisHttpsDriver.send(config, channel, event, data);
+        if (BroadcastRegistry.has(selection)) {
+            return BroadcastRegistry.get(selection);
         }
-        const err = ErrorFactory.createConfigError(`Broadcast driver not implemented: ${driver}`);
-        throw err;
+    }
+    catch {
+        // best-effort
+    }
+    // Fallback to config lookup (throws on explicit unknown).
+    return broadcastConfig.getDriverConfig(name);
+};
+const sendWithConfig = async (config, channel, event, data) => {
+    const driverName = config.driver;
+    if (driverName === 'inmemory') {
+        return InMemoryDriver.send(undefined, channel, event, data);
+    }
+    if (driverName === 'pusher') {
+        return PusherDriver.send(config, channel, event, data);
+    }
+    if (driverName === 'redis') {
+        return RedisDriver.send(config, channel, event, data);
+    }
+    if (driverName === 'redishttps') {
+        return RedisHttpsDriver.send(config, channel, event, data);
+    }
+    throw ErrorFactory.createConfigError(`Broadcast driver not implemented: ${driverName}`);
+};
+export const Broadcast = Object.freeze({
+    async send(channel, event, data) {
+        const config = await resolveBroadcasterConfig();
+        return sendWithConfig(config, channel, event, data);
+    },
+    broadcaster(name) {
+        return Object.freeze({
+            send: async (channel, event, data) => {
+                const config = await resolveBroadcasterConfig(name);
+                return sendWithConfig(config, channel, event, data);
+            },
+        });
     },
 });
 export default Broadcast;

package/src/tools/broadcast/BroadcastRegistry.d.ts

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

package/src/tools/broadcast/BroadcastRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BroadcastRegistry.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/BroadcastRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAQ/D,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAExE;AAED,iBAAS,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,CAKrD;AAED,iBAAS,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElC;AAED,iBAAS,IAAI,IAAI,MAAM,EAAE,CAExB;AAED,iBAAS,KAAK,IAAI,IAAI,CAErB;AAED,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}

package/src/tools/broadcast/BroadcastRegistry.js

@@ -0,0 +1,29 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+const registry = new Map();
+const normalize = (value) => value.trim().toLowerCase();
+function register(name, config) {
+    registry.set(normalize(name), config);
+}
+function get(name) {
+    const key = normalize(name);
+    const found = registry.get(key);
+    if (found !== undefined)
+        return found;
+    throw ErrorFactory.createConfigError(`Broadcast driver not configured: ${key}`);
+}
+function has(name) {
+    return registry.has(normalize(name));
+}
+function list() {
+    return Array.from(registry.keys());
+}
+function reset() {
+    registry.clear();
+}
+export const BroadcastRegistry = Object.freeze({
+    register,
+    get,
+    has,
+    list,
+    reset,
+});

package/src/tools/broadcast/BroadcastRuntimeRegistration.d.ts

@@ -0,0 +1,11 @@
+import type { BroadcastConfigInput } from '../../config/type';
+/**
+ * Register broadcasters from runtime config.
+ *
+ * This follows the framework's config-driven availability pattern:
+ * - Every `broadcastConfig.drivers[name]` is registered under `name`.
+ * - The configured default name is also registered as `'default'`.
+ * - Unknown names throw when selected via `BroadcastRegistry.get(name)`.
+ */
+export declare function registerBroadcastersFromRuntimeConfig(config: Pick<BroadcastConfigInput, 'default' | 'drivers'>): void;
+//# sourceMappingURL=BroadcastRuntimeRegistration.d.ts.map

package/src/tools/broadcast/BroadcastRuntimeRegistration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BroadcastRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/BroadcastRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,SAAS,CAAC,GACxD,IAAI,CAWN"}

package/src/tools/broadcast/BroadcastRuntimeRegistration.js

@@ -0,0 +1,20 @@
+import { BroadcastRegistry } from './BroadcastRegistry.js';
+/**
+ * Register broadcasters from runtime config.
+ *
+ * This follows the framework's config-driven availability pattern:
+ * - Every `broadcastConfig.drivers[name]` is registered under `name`.
+ * - The configured default name is also registered as `'default'`.
+ * - Unknown names throw when selected via `BroadcastRegistry.get(name)`.
+ */
+export function registerBroadcastersFromRuntimeConfig(config) {
+    for (const [name, driverConfig] of Object.entries(config.drivers)) {
+        BroadcastRegistry.register(name, driverConfig);
+    }
+    const defaultName = (config.default ?? '').toString().trim().toLowerCase();
+    if (defaultName.length === 0)
+        return;
+    if (BroadcastRegistry.has(defaultName)) {
+        BroadcastRegistry.register('default', BroadcastRegistry.get(defaultName));
+    }
+}

package/src/tools/broadcast/index.d.ts

@@ -1,4 +1,6 @@
 export { Broadcast } from './Broadcast';
+export { BroadcastRegistry } from './BroadcastRegistry';
+export { registerBroadcastersFromRuntimeConfig } from './BroadcastRuntimeRegistration';
 export { BaseDriver } from './drivers/BaseDriver';
 export { InMemoryDriver } from './drivers/InMemory';
 export { PusherDriver } from './drivers/Pusher';

package/src/tools/broadcast/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,qCAAqC,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC"}

package/src/tools/broadcast/index.js

@@ -1,4 +1,6 @@
 export { Broadcast } from './Broadcast.js';
+export { BroadcastRegistry } from './BroadcastRegistry.js';
+export { registerBroadcastersFromRuntimeConfig } from './BroadcastRuntimeRegistration.js';
 export { BaseDriver } from './drivers/BaseDriver.js';
 export { InMemoryDriver } from './drivers/InMemory.js';
 export { PusherDriver } from './drivers/Pusher.js';

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

@@ -16,6 +16,14 @@ export type SendMailResult = {
     messageId?: string;
 };
 export declare const Mail: Readonly<{
+    /**
+     * Select a named mailer (key from mailConfig.drivers).
+     *
+     * Example: `Mail.mailer('transactional').send(...)`
+     */
+    mailer(name: string): Readonly<{
+        send: (input: SendMailInput) => Promise<SendMailResult>;
+    }>;
     send(input: SendMailInput): Promise<SendMailResult>;
 }>;
 export default Mail;

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

@@ -1 +1 @@
-{"version":3,"file":"Mail.d.ts","sourceRoot":"","sources":["../../../../src/tools/mail/Mail.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAI7E,MAAM,MAAM,aAAa,GAAG;IAC1B,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;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAuHF,eAAO,MAAM,IAAI;gBACG,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;EAqBzD,CAAC;AAEH,eAAe,IAAI,CAAC"}
+{"version":3,"file":"Mail.d.ts","sourceRoot":"","sources":["../../../../src/tools/mail/Mail.ts"],"names":[],"mappings":"AAMA,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAI7E,MAAM,MAAM,aAAa,GAAG;IAC1B,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;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAoJF,eAAO,MAAM,IAAI;IACf;;;;OAIG;iBACU,MAAM;cAhCb,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC;;gBAoCrC,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;EAGzD,CAAC;AAEH,eAAe,IAAI,CAAC"}

package/src/tools/mail/Mail.js

@@ -75,9 +75,9 @@ const sendWithDriver = async (driver, message) => {
         throw err;
     }
 };
-export const Mail = Object.freeze({
+const createMailer = (name) => Object.freeze({
     async send(input) {
-        const driver = mailConfig.getDriver();
+        const driver = mailConfig.getDriver(name);
         if (driver.driver === 'disabled') {
             const err = ErrorFactory.createConfigError('Mail driver is disabled (set MAIL_DRIVER)');
             throw err;
@@ -95,4 +95,17 @@ export const Mail = Object.freeze({
         });
     },
 });
+export const Mail = Object.freeze({
+    /**
+     * Select a named mailer (key from mailConfig.drivers).
+     *
+     * Example: `Mail.mailer('transactional').send(...)`
+     */
+    mailer(name) {
+        return createMailer(name);
+    },
+    async send(input) {
+        return createMailer().send(input);
+    },
+});
 export default Mail;

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

@@ -6,11 +6,13 @@ declare function register(driver: string, handler: MailSendHandler): void;
 declare function get(driver: string): MailSendHandler | undefined;
 declare function has(driver: string): boolean;
 declare function list(): string[];
+declare function reset(): void;
 export declare const MailDriverRegistry: Readonly<{
     register: typeof register;
     get: typeof get;
     has: typeof has;
     list: typeof list;
+    reset: typeof reset;
 }>;
 export {};
 //# sourceMappingURL=MailDriverRegistry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MailDriverRegistry.d.ts","sourceRoot":"","sources":["../../../../src/tools/mail/MailDriverRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,KACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAIlD,iBAAS,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAEhE;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAExD;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpC;AAED,iBAAS,IAAI,IAAI,MAAM,EAAE,CAExB;AAED,eAAO,MAAM,kBAAkB;;;;;EAK7B,CAAC"}
+{"version":3,"file":"MailDriverRegistry.d.ts","sourceRoot":"","sources":["../../../../src/tools/mail/MailDriverRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,CAC5B,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,KACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAIlD,iBAAS,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAEhE;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAExD;AAED,iBAAS,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpC;AAED,iBAAS,IAAI,IAAI,MAAM,EAAE,CAExB;AAED,iBAAS,KAAK,IAAI,IAAI,CAErB;AAED,eAAO,MAAM,kBAAkB;;;;;;EAM7B,CAAC"}

package/src/tools/mail/MailDriverRegistry.js

@@ -11,9 +11,13 @@ function has(driver) {
 function list() {
     return Array.from(registry.keys());
 }
+function reset() {
+    registry.clear();
+}
 export const MailDriverRegistry = Object.freeze({
     register,
     get,
     has,
     list,
+    reset,
 });

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

@@ -5,6 +5,9 @@
  */
 export declare const Notification: Readonly<{
     send: (recipient: string, message: string, options?: Record<string, unknown>) => Promise<unknown>;
+    channel: (name: string) => Readonly<{
+        send: (recipient: string, message: string, options?: Record<string, unknown>) => Promise<unknown>;
+    }>;
     listDrivers: () => string[];
 }>;
 export default Notification;

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

@@ -1 +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"}
+{"version":3,"file":"Notification.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/Notification.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,eAAO,MAAM,YAAY;;oBAEP,MAAM;0BAEM,MAAM,WAAW,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;EAItF,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/src/tools/notification/Notification.js

@@ -6,6 +6,9 @@
 import { NotificationService } from './Service.js';
 export const Notification = Object.freeze({
     send: NotificationService.send,
+    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;AAG5D;;;;;GAKG;AACH,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,CAAC,GAC3D,IAAI,CAWN;AAED,eAAO,MAAM,+BAA+B;;EAE1C,CAAC;AAEH,eAAe,+BAA+B,CAAC"}

package/src/tools/notification/NotificationRuntimeRegistration.js

@@ -0,0 +1,22 @@
+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)
+        return;
+    if (NotificationChannelRegistry.has(defaultName)) {
+        NotificationChannelRegistry.register('default', NotificationChannelRegistry.get(defaultName));
+    }
+}
+export const NotificationRuntimeRegistration = Object.freeze({
+    registerNotificationChannelsFromRuntimeConfig,
+});
+export default NotificationRuntimeRegistration;

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

@@ -1 +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"}
+{"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

@@ -1,9 +1,13 @@
 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);

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

@@ -1,5 +1,6 @@
 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;

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

@@ -1 +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"}
+{"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

@@ -1,16 +1,89 @@
+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 = {}) {
-        if (!recipient || typeof recipient !== 'string')
-            throw ErrorFactory.createValidationError('Recipient required');
-        if (!message || typeof message !== 'string')
-            throw ErrorFactory.createValidationError('Message required');
+        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();
     },

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

@@ -0,0 +1,8 @@
+export declare const SlackNotificationDriver: Readonly<{
+    send(_recipient: string, message: string, options?: Record<string, unknown>): Promise<{
+        ok: boolean;
+        status?: number;
+    }>;
+}>;
+export default SlackNotificationDriver;
+//# sourceMappingURL=SlackNotification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SlackNotification.d.ts","sourceRoot":"","sources":["../../../../../src/tools/notification/drivers/SlackNotification.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,uBAAuB;qBACX,MAAM,WAAW,MAAM,YAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;EAUhF,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

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

@@ -0,0 +1,13 @@
+import notificationConfig from '../../../config/notification.js';
+import { SlackDriver } from '../drivers/Slack.js';
+export const SlackNotificationDriver = Object.freeze({
+    async send(_recipient, message, options = {}) {
+        const cfg = notificationConfig.providers.slack;
+        const payload = {
+            text: message,
+            ...options,
+        };
+        return SlackDriver.send({ webhookUrl: cfg.webhookUrl }, payload);
+    },
+});
+export default SlackNotificationDriver;

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

@@ -0,0 +1,8 @@
+export declare const TwilioNotificationDriver: Readonly<{
+    send(recipient: string, message: string): Promise<{
+        ok: boolean;
+        status?: number;
+    }>;
+}>;
+export default TwilioNotificationDriver;
+//# sourceMappingURL=TwilioNotification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TwilioNotification.d.ts","sourceRoot":"","sources":["../../../../../src/tools/notification/drivers/TwilioNotification.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB;oBACb,MAAM,WAAW,MAAM;;;;EAY7C,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

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

@@ -0,0 +1,13 @@
+import notificationConfig from '../../../config/notification.js';
+import { TwilioDriver } from '../drivers/Twilio.js';
+export const TwilioNotificationDriver = Object.freeze({
+    async send(recipient, message) {
+        const cfg = notificationConfig.providers.twilio;
+        return TwilioDriver.send({
+            accountSid: cfg.accountSid,
+            authToken: cfg.authToken,
+            from: cfg.fromNumber,
+        }, { to: recipient, body: message });
+    },
+});
+export default TwilioNotificationDriver;

package/src/tools/queue/Queue.d.ts

@@ -12,6 +12,7 @@ interface IQueueDriver {
 }
 export declare const Queue: Readonly<{
     register(name: string, driver: IQueueDriver): void;
+    reset(): void;
     get(name?: string): IQueueDriver;
     enqueue<T = unknown>(queue: string, payload: T, driverName?: string): Promise<string>;
     dequeue<T = unknown>(queue: string, driverName?: string): Promise<QueueMessage<T> | undefined>;

package/src/tools/queue/Queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/Queue.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,UAAU,YAAY;IACpB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAID,eAAO,MAAM,KAAK;mBACD,MAAM,UAAU,YAAY;eAIhC,MAAM,GAAG,YAAY;YAUlB,CAAC,mBAAmB,MAAM,WAAW,CAAC,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAK7E,CAAC,mBACN,MAAM,eACA,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;eAKtB,MAAM,MAAM,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;kBAKpD,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;iBAK9C,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EAI9D,CAAC;AAEH,eAAe,KAAK,CAAC"}
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/Queue.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,UAAU,YAAY;IACpB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAID,eAAO,MAAM,KAAK;mBACD,MAAM,UAAU,YAAY;aAIlC,IAAI;eAIF,MAAM,GAAG,YAAY;YAUlB,CAAC,mBAAmB,MAAM,WAAW,CAAC,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAK7E,CAAC,mBACN,MAAM,eACA,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;eAKtB,MAAM,MAAM,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;kBAKpD,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;iBAK9C,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EAI9D,CAAC;AAEH,eAAe,KAAK,CAAC"}

package/src/tools/queue/Queue.js

@@ -4,6 +4,9 @@ export const Queue = Object.freeze({
     register(name, driver) {
         drivers.set(name.toLowerCase(), driver);
     },
+    reset() {
+        drivers.clear();
+    },
     get(name) {
         const driverName = (name ?? process.env['QUEUE_DRIVER'] ?? 'inmemory')
             .toString()