@zintrust/core 0.1.12 → 0.1.14

package/src/templates/project/basic/config/type.ts.tpl

@@ -1,5 +1,5 @@
-import { Env } from './env';
-import type { Middleware as MiddlewareFn } from '../middleware/MiddlewareStack';
+import { Env } from '@config/env';
+import type { Middleware as MiddlewareFn } from '@middleware/MiddlewareStack';
 
 export type Environment =
   | 'development'
@@ -50,15 +50,15 @@ export type GcsStorageDriverConfig = {
   url: EnvGetValue;
 };
 
-export type StorageDrivers = {
-  local: LocalStorageDriverConfig;
-  s3: S3StorageDriverConfig;
-  r2: R2StorageDriverConfig;
-  gcs: GcsStorageDriverConfig;
-};
+export type StorageDriverConfig =
+  | LocalStorageDriverConfig
+  | S3StorageDriverConfig
+  | R2StorageDriverConfig
+  | GcsStorageDriverConfig;
+
+export type StorageDrivers = Record<string, StorageDriverConfig>;
 
 export type StorageDriverName = keyof StorageDrivers;
-export type StorageDriverConfig = StorageDrivers[StorageDriverName];
 
 export type StorageConfigRuntime = {
   readonly default: string;
@@ -194,6 +194,13 @@ export type KnownNotificationDriverConfig =
   | TwilioNotificationDriverConfig
   | SlackNotificationDriverConfig;
 
+export type NotificationDrivers = Record<string, KnownNotificationDriverConfig>;
+
+export type NotificationConfigInput = {
+  default: string;
+  drivers: NotificationDrivers;
+};
+
 export type NotificationProviders = {
   console: ConsoleNotificationDriverConfig;
   termii: TermiiNotificationDriverConfig;
@@ -256,17 +263,16 @@ export type MailDriverConfig =
   | NodemailerMailDriverConfig
   | SesMailDriverConfig;
 
-export type MailDrivers = {
-  disabled: DisabledMailDriverConfig;
-  sendgrid: SendGridMailDriverConfig;
-  mailgun: MailgunMailDriverConfig;
-  smtp: SmtpMailDriverConfig;
-  nodemailer: NodemailerMailDriverConfig;
-  ses: SesMailDriverConfig;
-};
+export type MailDrivers = Record<string, MailDriverConfig>;
 
 export type MailConfigInput = {
-  default: MailDriverName;
+  /**
+   * Default mailer key name.
+   *
+   * This is intentionally a string to support named mailers (e.g. 'transactional', 'marketing').
+   * The underlying driver is selected by the `driver` field within each mailer config.
+   */
+  default: string;
   from: {
     address: string;
     name: string;
@@ -317,17 +323,23 @@ export type MysqlConnectionConfig = {
   };
 };
 
-export type DatabaseConnections = {
-  sqlite: SqliteConnectionConfig;
-  postgresql: PostgresqlConnectionConfig;
-  mysql: MysqlConnectionConfig;
-};
+export type DatabaseConnectionConfig =
+  | SqliteConnectionConfig
+  | PostgresqlConnectionConfig
+  | MysqlConnectionConfig;
 
-export type DatabaseConnectionName = keyof DatabaseConnections;
-export type DatabaseConnectionConfig = DatabaseConnections[DatabaseConnectionName];
+/**
+ * Named database connection configs.
+ *
+ * Keys represent connection names (e.g. 'default', 'auth', 'tasks', 'db1').
+ */
+export type DatabaseConnections = Record<string, DatabaseConnectionConfig>;
 
+/**
+ * Default connection name.
+ */
 export type DatabaseConfigShape = {
-  default: DatabaseConnectionName;
+  default: string;
   connections: DatabaseConnections;
 };
 
@@ -382,13 +394,7 @@ export type CacheDriverConfig =
   | KvCacheDriverConfig
   | KvRemoteCacheDriverConfig;
 
-export type CacheDrivers = {
-  memory: MemoryCacheDriverConfig;
-  redis: RedisCacheDriverConfig;
-  mongodb: MongoCacheDriverConfig;
-  kv: KvCacheDriverConfig;
-  'kv-remote': KvRemoteCacheDriverConfig;
-};
+export type CacheDrivers = Record<string, CacheDriverConfig>;
 
 export type CacheConfigInput = {
   default: string;
@@ -430,3 +436,10 @@ export type KnownBroadcastDriverConfig =
   | PusherBroadcastDriverConfig
   | RedisBroadcastDriverConfig
   | RedisHttpsBroadcastDriverConfig;
+
+export type BroadcastDrivers = Record<string, KnownBroadcastDriverConfig>;
+
+export type BroadcastConfigInput = {
+  default: string;
+  drivers: BroadcastDrivers;
+};

package/src/templates/project/basic/routes/health.ts.tpl

@@ -3,17 +3,13 @@
  * Provides health, liveness, and readiness endpoints.
  */
 
-import {
-  Env,
-  Logger,
-  QueryBuilder,
-  RuntimeHealthProbes,
-  type IRouter,
-  Router,
-  useDatabase,
-} from '@zintrust/core';
-
-import { appConfig } from '../config';
+import { appConfig } from '../config/app';
+import { Env } from '../config/env';
+import { Logger } from '../config/logger';
+import { RuntimeHealthProbes } from '@zintrust/core';
+import { useDatabase } from '@zintrust/core';
+import { QueryBuilder } from '@zintrust/core';
+import { type IRouter, Router } from '@zintrust/core';
 
 export function registerHealthRoutes(router: IRouter): void {
   registerHealthRoute(router);
@@ -27,6 +23,13 @@ function registerHealthRoute(router: IRouter): void {
 
     try {
       const db = useDatabase();
+      const maybeIsConnected = (db as unknown as { isConnected?: unknown }).isConnected;
+      const maybeConnect = (db as unknown as { connect?: unknown }).connect;
+      if (typeof maybeIsConnected === 'function' && maybeIsConnected.call(db) === false) {
+        if (typeof maybeConnect === 'function') {
+          await maybeConnect.call(db);
+        }
+      }
       await QueryBuilder.ping(db);
 
       const uptime =
@@ -79,6 +82,13 @@ function registerHealthReadyRoute(router: IRouter): void {
 
     try {
       const db = useDatabase();
+      const maybeIsConnected = (db as unknown as { isConnected?: unknown }).isConnected;
+      const maybeConnect = (db as unknown as { connect?: unknown }).connect;
+      if (typeof maybeIsConnected === 'function' && maybeIsConnected.call(db) === false) {
+        if (typeof maybeConnect === 'function') {
+          await maybeConnect.call(db);
+        }
+      }
       await QueryBuilder.ping(db);
 
       databaseResponseTime = Date.now() - startTime;

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

@@ -1,7 +1,9 @@
+type Broadcaster = Readonly<{
+    send: (channel: string, event: string, data: unknown) => Promise<unknown>;
+}>;
 export declare const Broadcast: Readonly<{
-    send(channel: string, event: string, data: unknown): Promise<{
-        ok: boolean;
-    }>;
+    send(channel: string, event: string, data: unknown): Promise<unknown>;
+    broadcaster(name?: string): Broadcaster;
 }>;
 export default Broadcast;
 //# sourceMappingURL=Broadcast.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Broadcast.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/Broadcast.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,SAAS;kBACA,MAAM,SAAS,MAAM,QAAQ,OAAO;;;EAmCxD,CAAC;AAEH,eAAe,SAAS,CAAC"}
+{"version":3,"file":"Broadcast.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/Broadcast.ts"],"names":[],"mappings":"AAQA,KAAK,WAAW,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC3E,CAAC,CAAC;AAyDH,eAAO,MAAM,SAAS;kBACA,MAAM,SAAS,MAAM,QAAQ,OAAO;uBAKrC,MAAM,GAAG,WAAW;EAQvC,CAAC;AAEH,eAAe,SAAS,CAAC"}

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"}