@zintrust/core 0.1.20 → 0.1.21

package/src/config/mail.d.ts

@@ -3,61 +3,25 @@
  * Runtime mail drivers and settings
  * Sealed namespace for immutability
  */
-import type { MailDriverConfig } from './type';
-export declare const mailConfig: Readonly<{
-    /**
-     * Default mail driver
-     */
-    readonly default: string;
-    /**
-     * Default "From" identity
-     */
-    readonly from: {
-        readonly address: string;
-        readonly name: string;
+import type { MailConfigInput, MailDriverConfig } from './type';
+export type MailConfigOverrides = Partial<{
+    default: string;
+    from: {
+        address: string;
+        name: string;
     };
-    /**
-     * Driver configs
-     */
-    readonly drivers: {
-        readonly disabled: {
-            readonly driver: "disabled";
-        };
-        readonly sendgrid: {
-            readonly driver: "sendgrid";
-            readonly apiKey: string;
-        };
-        readonly mailgun: {
-            readonly driver: "mailgun";
-            readonly apiKey: string;
-            readonly domain: string;
-            readonly baseUrl: string;
-        };
-        readonly smtp: {
-            readonly driver: "smtp";
-            readonly host: string;
-            readonly port: number;
-            readonly username: string;
-            readonly password: string;
-            readonly secure: boolean | "starttls";
-        };
-        readonly nodemailer: {
-            readonly driver: "nodemailer";
-            readonly host: string;
-            readonly port: number;
-            readonly username: string;
-            readonly password: string;
-            readonly secure: boolean | "starttls";
-        };
-        readonly ses: {
-            readonly driver: "ses";
-            readonly region: string;
-        };
-    };
-    /**
-     * Get selected driver config
-     */
-    readonly getDriver: (name?: string) => MailDriverConfig;
+    drivers: Record<string, MailDriverConfig>;
 }>;
-export type MailConfig = typeof mailConfig;
+declare const createMailConfig: () => {
+    default: string;
+    from: {
+        address: string;
+        name: string;
+    };
+    drivers: Record<string, MailDriverConfig>;
+    getDriver: (this: MailConfigInput, name?: string) => MailDriverConfig;
+};
+export type MailConfig = ReturnType<typeof createMailConfig>;
+export declare const mailConfig: MailConfig;
+export {};
 //# sourceMappingURL=mail.d.ts.map

package/src/config/mail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../../src/config/mail.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAkHtE,eAAO,MAAM,UAAU;IA7ErB;;OAEG;;IAGH;;OAEG;;;;;IAMH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsDH;;OAEG;gCACc,MAAM,KAAG,gBAAgB;EAKU,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC"}
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../../src/config/mail.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGtE,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC3C,CAAC,CAAC;AAmCH,QAAA,MAAM,gBAAgB,QAAO;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,SAAS,EAAE,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,gBAAgB,CAAC;CAgGvE,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAqB7D,eAAO,MAAM,UAAU,EAAE,UAYvB,CAAC"}

package/src/config/mail.js

@@ -3,6 +3,7 @@
  * Runtime mail drivers and settings
  * Sealed namespace for immutability
  */
+import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';
 import { Env } from './env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 const isMailDriverConfig = (value) => {
@@ -34,22 +35,16 @@ const getMailDriver = (config, name) => {
     }
     throw ErrorFactory.createConfigError(`Mail driver not configured: ${selected}`);
 };
-const mailConfigObj = {
-    /**
-     * Default mail driver
-     */
-    default: Env.get('MAIL_CONNECTION', Env.get('MAIL_DRIVER', 'disabled')).trim().toLowerCase(),
-    /**
-     * Default "From" identity
-     */
-    from: {
+const createMailConfig = () => {
+    const overrides = StartupConfigFileRegistry.get(StartupConfigFile.Mail) ?? {};
+    const baseDefault = Env.get('MAIL_CONNECTION', Env.get('MAIL_DRIVER', 'disabled'))
+        .trim()
+        .toLowerCase();
+    const baseFrom = {
         address: Env.get('MAIL_FROM_ADDRESS', ''),
         name: Env.get('MAIL_FROM_NAME', ''),
-    },
-    /**
-     * Driver configs
-     */
-    drivers: {
+    };
+    const baseDrivers = {
         disabled: {
             driver: 'disabled',
         },
@@ -101,12 +96,59 @@ const mailConfigObj = {
             driver: 'ses',
             region: Env.get('AWS_REGION', 'us-east-1'),
         },
+    };
+    const mailConfigObj = {
+        /**
+         * Default mail driver
+         */
+        default: (overrides.default ?? baseDefault).trim().toLowerCase(),
+        /**
+         * Default "From" identity
+         */
+        from: {
+            ...baseFrom,
+            ...(overrides.from ?? {}),
+        },
+        /**
+         * Driver configs
+         */
+        drivers: {
+            ...baseDrivers,
+            ...(overrides.drivers ?? {}),
+        },
+        /**
+         * Get selected driver config
+         */
+        getDriver(name) {
+            return getMailDriver(this, name);
+        },
+    };
+    return Object.freeze(mailConfigObj);
+};
+let cached = null;
+const proxyTarget = {};
+const ensureMailConfig = () => {
+    if (cached)
+        return cached;
+    cached = createMailConfig();
+    try {
+        Object.defineProperties(proxyTarget, Object.getOwnPropertyDescriptors(cached));
+    }
+    catch {
+        // best-effort
+    }
+    return cached;
+};
+export const mailConfig = new Proxy(proxyTarget, {
+    get(_target, prop) {
+        return ensureMailConfig()[prop];
     },
-    /**
-     * Get selected driver config
-     */
-    getDriver(name) {
-        return getMailDriver(this, name);
+    ownKeys() {
+        ensureMailConfig();
+        return Reflect.ownKeys(proxyTarget);
     },
-};
-export const mailConfig = Object.freeze(mailConfigObj);
+    getOwnPropertyDescriptor(_target, prop) {
+        ensureMailConfig();
+        return Object.getOwnPropertyDescriptor(proxyTarget, prop);
+    },
+});

package/src/config/middleware.d.ts

@@ -1,4 +1,28 @@
 import type { MiddlewareConfigType } from './type';
+export declare enum MiddlewareBody {
+    email = "email",
+    password = "password",
+    name = "name",
+    count = "count"
+}
+export type MiddlewaresType = {
+    skipPaths: string[];
+    fillRateLimit: {
+        windowMs: number;
+        max: number;
+        message: string;
+    };
+    authRateLimit: {
+        windowMs: number;
+        max: number;
+        message: string;
+    };
+    userMutationRateLimit: {
+        windowMs: number;
+        max: number;
+        message: string;
+    };
+};
 export declare const MiddlewareKeys: Readonly<{
     log: true;
     error: true;

package/src/config/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/config/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AA8DzD,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;EAiBuB,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AA2KxD,wBAAgB,sBAAsB,IAAI,oBAAoB,CAkB7D;AA0BD,eAAO,MAAM,gBAAgB,EAAE,oBAY7B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/config/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AA8DzD,oBAAY,cAAc;IACxB,KAAK,UAAU;IACf,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,qBAAqB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3E,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;EAiBuB,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AA0MxD,wBAAgB,sBAAsB,IAAI,oBAAoB,CAqB7D;AA0BD,eAAO,MAAM,gBAAgB,EAAE,oBAY7B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/src/config/middleware.js

@@ -1,4 +1,4 @@
-import { Env } from './env.js';
+import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';
 import { bodyParsingMiddleware } from '../http/middleware/BodyParsingMiddleware.js';
 import { fileUploadMiddleware } from '../http/middleware/FileUploadMiddleware.js';
 import { AuthMiddleware } from '../middleware/AuthMiddleware.js';
@@ -12,6 +12,13 @@ import { SecurityMiddleware } from '../middleware/SecurityMiddleware.js';
 import { ValidationMiddleware } from '../middleware/ValidationMiddleware.js';
 import { Sanitizer } from '../security/Sanitizer.js';
 import { Schema } from '../validation/Validator.js';
+export var MiddlewareBody;
+(function (MiddlewareBody) {
+    MiddlewareBody["email"] = "email";
+    MiddlewareBody["password"] = "password";
+    MiddlewareBody["name"] = "name";
+    MiddlewareBody["count"] = "count";
+})(MiddlewareBody || (MiddlewareBody = {}));
 export const MiddlewareKeys = Object.freeze({
     log: true,
     error: true,
@@ -33,45 +40,60 @@ export const MiddlewareKeys = Object.freeze({
 // Ensure `ValidationMiddleware` is strongly typed here to avoid `error`-typed values
 // triggering `@typescript-eslint/no-unsafe-*` rules.
 const Validation = ValidationMiddleware;
-function createRateLimitMiddlewares() {
+const resolveFillRateLimit = (loadMiddlewareConfig) => {
+    return {
+        windowMs: loadMiddlewareConfig.fillRateLimit?.windowMs ?? 60_000,
+        max: loadMiddlewareConfig.fillRateLimit?.max ?? 5,
+        message: loadMiddlewareConfig.fillRateLimit?.message ??
+            'Too many requests, please try again after 1 minute.',
+    };
+};
+const resolveAuthRateLimit = (loadMiddlewareConfig) => {
+    return {
+        windowMs: loadMiddlewareConfig.authRateLimit?.windowMs ?? 60_000,
+        max: loadMiddlewareConfig.authRateLimit?.max ?? 10,
+        message: loadMiddlewareConfig.authRateLimit?.message ??
+            'Too many login attempts, please try again after 1 minute.',
+    };
+};
+const resolveUserMutationRateLimit = (loadMiddlewareConfig) => {
+    return {
+        windowMs: loadMiddlewareConfig.userMutationRateLimit?.windowMs ?? 60_000,
+        max: loadMiddlewareConfig.userMutationRateLimit?.max ?? 20,
+        message: loadMiddlewareConfig.userMutationRateLimit?.message ??
+            'Too many user requests, please try again after 1 minute.',
+    };
+};
+function createRateLimitMiddlewares(loadMiddlewareConfig) {
+    const fillRateLimit = RateLimiter.create(resolveFillRateLimit(loadMiddlewareConfig));
+    const authRateLimit = RateLimiter.create(resolveAuthRateLimit(loadMiddlewareConfig));
+    const userMutationRateLimit = RateLimiter.create(resolveUserMutationRateLimit(loadMiddlewareConfig));
     return Object.freeze({
         rateLimit: RateLimiter.create(),
-        fillRateLimit: RateLimiter.create({
-            windowMs: 60_000,
-            max: 5,
-            message: 'Too many fill requests, please try again later.',
-        }),
-        authRateLimit: RateLimiter.create({
-            windowMs: 60_000,
-            max: 10,
-            message: 'Too many authentication requests, please try again later.',
-        }),
-        userMutationRateLimit: RateLimiter.create({
-            windowMs: 60_000,
-            max: 20,
-            message: 'Too many write requests, please try again later.',
-        }),
+        fillRateLimit,
+        authRateLimit,
+        userMutationRateLimit,
     });
 }
 function createAuthValidationMiddlewares() {
     return {
         validateLogin: Validation.createBodyWithSanitization(Schema.typed()
-            .required('email')
-            .email('email')
-            .required('password')
-            .string('password'), {
+            .required(MiddlewareBody.email)
+            .email(MiddlewareBody.email)
+            .required(MiddlewareBody.password)
+            .string(MiddlewareBody.password), {
             email: (v) => Sanitizer.email(v).trim().toLowerCase(),
             password: (v) => Sanitizer.safePasswordChars(v),
         }),
         validateRegister: Validation.createBodyWithSanitization(Schema.typed()
-            .required('name')
-            .string('name')
-            .minLength('name', 1)
-            .required('email')
-            .email('email')
-            .required('password')
-            .string('password')
-            .minLength('password', 8), {
+            .required(MiddlewareBody.name)
+            .string(MiddlewareBody.name)
+            .minLength(MiddlewareBody.name, 1)
+            .required(MiddlewareBody.email)
+            .email(MiddlewareBody.email)
+            .required(MiddlewareBody.password)
+            .string(MiddlewareBody.password)
+            .minLength(MiddlewareBody.password, 8), {
             name: (v) => Sanitizer.nameText(v).trim(),
             email: (v) => Sanitizer.email(v).trim().toLowerCase(),
             password: (v) => Sanitizer.safePasswordChars(v),
@@ -81,32 +103,32 @@ function createAuthValidationMiddlewares() {
 function createUserValidationMiddlewares() {
     return {
         validateUserStore: Validation.createBodyWithSanitization(Schema.typed()
-            .required('name')
-            .string('name')
-            .minLength('name', 1)
-            .required('email')
-            .email('email')
-            .required('password')
-            .string('password')
-            .minLength('password', 8), {
+            .required(MiddlewareBody.name)
+            .string(MiddlewareBody.name)
+            .minLength(MiddlewareBody.name, 1)
+            .required(MiddlewareBody.email)
+            .email(MiddlewareBody.email)
+            .required(MiddlewareBody.password)
+            .string(MiddlewareBody.password)
+            .minLength(MiddlewareBody.password, 8), {
             name: (v) => Sanitizer.nameText(v).trim(),
             email: (v) => Sanitizer.email(v).trim().toLowerCase(),
             password: (v) => Sanitizer.safePasswordChars(v),
         }),
         validateUserUpdate: Validation.createBodyWithSanitization(Schema.typed()
-            .custom('name', (v) => v === undefined || typeof v === 'string', 'name must be a string')
-            .minLength('name', 1)
-            .custom('email', (v) => v === undefined || typeof v === 'string', 'email must be a string')
-            .custom('password', (v) => v === undefined || typeof v === 'string', 'password must be a string')
-            .minLength('password', 8), {
+            .custom(MiddlewareBody.name, (v) => v === undefined || typeof v === 'string', MiddlewareBody.name + ' must be a string')
+            .minLength(MiddlewareBody.name, 1)
+            .custom(MiddlewareBody.email, (v) => v === undefined || typeof v === 'string', MiddlewareBody.email + ' must be a string')
+            .custom(MiddlewareBody.password, (v) => v === undefined || typeof v === 'string', MiddlewareBody.password + ' must be a string')
+            .minLength(MiddlewareBody.password, 8), {
             name: (v) => Sanitizer.nameText(v).trim(),
             email: (v) => Sanitizer.email(v).trim().toLowerCase(),
             password: (v) => Sanitizer.safePasswordChars(v),
         }),
         validateUserFill: Validation.createBodyWithSanitization(Schema.typed()
-            .custom('count', (v) => v === undefined || (typeof v === 'number' && Number.isFinite(v)), 'count must be a number')
-            .min('count', 1)
-            .max('count', 100)),
+            .custom(MiddlewareBody.count, (v) => v === undefined || (typeof v === 'number' && Number.isFinite(v)), MiddlewareBody.count + ' must be a number')
+            .min(MiddlewareBody.count, 1)
+            .max(MiddlewareBody.count, 100)),
     };
 }
 function createValidationMiddlewares() {
@@ -115,8 +137,8 @@ function createValidationMiddlewares() {
         ...createUserValidationMiddlewares(),
     });
 }
-function createSharedMiddlewares() {
-    const rateLimits = createRateLimitMiddlewares();
+function createSharedMiddlewares(loadMiddlewareConfig) {
+    const rateLimits = createRateLimitMiddlewares(loadMiddlewareConfig);
     const validations = createValidationMiddlewares();
     return Object.freeze({
         log: LoggingMiddleware.create(),
@@ -125,10 +147,7 @@ function createSharedMiddlewares() {
         sanitizeBody: SanitizeBodyMiddleware.create(),
         ...rateLimits,
         csrf: CsrfMiddleware.create({
-            skipPaths: Env.get('CSRF_SKIP_PATHS', '')
-                .split(',')
-                .map((p) => p.trim())
-                .filter((p) => p.length > 0),
+            skipPaths: loadMiddlewareConfig?.skipPaths ?? [],
         }),
         auth: AuthMiddleware.create(),
         jwt: JwtAuthMiddleware.create(),
@@ -136,7 +155,8 @@ function createSharedMiddlewares() {
     });
 }
 export function createMiddlewareConfig() {
-    const shared = createSharedMiddlewares();
+    const loadMiddlewareConfig = StartupConfigFileRegistry.get(StartupConfigFile.Middleware) ?? {};
+    const shared = createSharedMiddlewares(loadMiddlewareConfig);
     const middlewareConfigObj = {
         global: [
             shared.log,

package/src/config/notification.d.ts

@@ -5,33 +5,20 @@
  * Driver selection must be dynamic (tests may mutate process.env).
  */
 import type { KnownNotificationDriverConfig, NotificationDrivers, NotificationProviders } from './type';
-export declare const notificationConfig: Readonly<{
-    /**
-     * Default notification channel name (normalized).
-     */
-    readonly default: string;
-    /**
-     * Notification channels.
-     *
-     * You may add custom named channels (e.g. `opsSlack`, `smsMarketing`) that
-     * point to any known driver config.
-     */
-    readonly drivers: NotificationDrivers;
-    /**
-     * Legacy provider configs (kept for backwards compatibility with wrappers).
-     */
-    readonly providers: NotificationProviders;
-    /**
-     * Normalized notification channel name.
-     */
-    readonly getDriverName: () => string;
-    /**
-     * Resolve a channel config.
-     * - Unknown names throw when explicitly selected.
-     * - `default` is a reserved alias of the configured default.
-     */
-    readonly getDriverConfig: (name?: string) => KnownNotificationDriverConfig;
+export type NotificationConfigOverrides = Partial<{
+    default: string;
+    drivers: NotificationDrivers;
+    providers: NotificationProviders;
 }>;
-export type NotificationConfig = typeof notificationConfig;
+type NotificationRuntimeConfig = {
+    default: string;
+    drivers: NotificationDrivers;
+    providers: NotificationProviders;
+    getDriverName: () => string;
+    getDriverConfig: (name?: string) => KnownNotificationDriverConfig;
+};
+declare const createNotificationConfig: () => NotificationRuntimeConfig;
+export type NotificationConfig = ReturnType<typeof createNotificationConfig>;
+export declare const notificationConfig: NotificationConfig;
 export default notificationConfig;
 //# sourceMappingURL=notification.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../../src/config/notification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,6BAA6B,EAE7B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AAuHtB,eAAO,MAAM,kBAAkB;IA1C7B;;OAEG;sBACY,MAAM;IAIrB;;;;;OAKG;sBACY,mBAAmB;IAKlC;;OAEG;wBACc,qBAAqB;IAItC;;OAEG;kCACc,MAAM;IAIvB;;;;OAIG;sCACoB,MAAM,KAAG,6BAA6B;EAKO,CAAC;AACvE,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../../src/config/notification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,6BAA6B,EAE7B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AAGtB,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,qBAAqB,CAAC;CAClC,CAAC,CAAC;AAEH,KAAK,yBAAyB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,qBAAqB,CAAC;IACjC,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,6BAA6B,CAAC;CACnE,CAAC;AA2EF,QAAA,MAAM,wBAAwB,QAAO,yBA+DpC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAqB7E,eAAO,MAAM,kBAAkB,EAAE,kBAY/B,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/src/config/notification.js

@@ -4,6 +4,7 @@
  * Config-first mapping of notification providers/channels.
  * Driver selection must be dynamic (tests may mutate process.env).
  */
+import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';
 import { Env } from './env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 const normalizeName = (value) => value.trim().toLowerCase();
@@ -61,43 +62,88 @@ const getBaseProviders = () => {
         },
     };
 };
-const notificationConfigObj = {
-    /**
-     * Default notification channel name (normalized).
-     */
-    get default() {
-        return getDefaultChannel(this.drivers);
-    },
-    /**
-     * Notification channels.
-     *
-     * You may add custom named channels (e.g. `opsSlack`, `smsMarketing`) that
-     * point to any known driver config.
-     */
-    get drivers() {
-        // Return a record of channels; can be extended by app-level config.
-        return getBaseProviders();
-    },
-    /**
-     * Legacy provider configs (kept for backwards compatibility with wrappers).
-     */
-    get providers() {
-        return getBaseProviders();
+const createNotificationConfig = () => {
+    const overrides = StartupConfigFileRegistry.get(StartupConfigFile.Notification) ??
+        {};
+    const notificationConfigObj = {
+        /**
+         * Default notification channel name (normalized).
+         */
+        get default() {
+            const overrideDefault = overrides.default;
+            if (typeof overrideDefault === 'string' && overrideDefault.trim().length > 0) {
+                const value = normalizeName(overrideDefault);
+                if (value.length > 0 && hasOwn(this.drivers, value))
+                    return value;
+                throw ErrorFactory.createConfigError(`Notification channel not configured: ${value}`);
+            }
+            return getDefaultChannel(this.drivers);
+        },
+        /**
+         * Notification channels.
+         *
+         * You may add custom named channels (e.g. `opsSlack`, `smsMarketing`) that
+         * point to any known driver config.
+         */
+        get drivers() {
+            // Return a record of channels; can be extended by app-level config.
+            return {
+                ...getBaseProviders(),
+                ...(overrides.providers ?? {}),
+                ...(overrides.drivers ?? {}),
+            };
+        },
+        /**
+         * Legacy provider configs (kept for backwards compatibility with wrappers).
+         */
+        get providers() {
+            return {
+                ...getBaseProviders(),
+                ...(overrides.providers ?? {}),
+            };
+        },
+        /**
+         * Normalized notification channel name.
+         */
+        getDriverName() {
+            return normalizeName(this.default);
+        },
+        /**
+         * Resolve a channel config.
+         * - Unknown names throw when explicitly selected.
+         * - `default` is a reserved alias of the configured default.
+         */
+        getDriverConfig(name) {
+            return getNotificationDriver(this, name);
+        },
+    };
+    return Object.freeze(notificationConfigObj);
+};
+let cached = null;
+const proxyTarget = {};
+const ensureNotificationConfig = () => {
+    if (cached)
+        return cached;
+    cached = createNotificationConfig();
+    try {
+        Object.defineProperties(proxyTarget, Object.getOwnPropertyDescriptors(cached));
+    }
+    catch {
+        // best-effort
+    }
+    return cached;
+};
+export const notificationConfig = new Proxy(proxyTarget, {
+    get(_target, prop) {
+        return ensureNotificationConfig()[prop];
     },
-    /**
-     * Normalized notification channel name.
-     */
-    getDriverName() {
-        return normalizeName(this.default);
+    ownKeys() {
+        ensureNotificationConfig();
+        return Reflect.ownKeys(proxyTarget);
     },
-    /**
-     * Resolve a channel config.
-     * - Unknown names throw when explicitly selected.
-     * - `default` is a reserved alias of the configured default.
-     */
-    getDriverConfig(name) {
-        return getNotificationDriver(this, name);
+    getOwnPropertyDescriptor(_target, prop) {
+        ensureNotificationConfig();
+        return Object.getOwnPropertyDescriptor(proxyTarget, prop);
     },
-};
-export const notificationConfig = Object.freeze(notificationConfigObj);
+});
 export default notificationConfig;