@zintrust/core 0.1.14 → 0.1.16

package/src/collections/Collection.d.ts

@@ -0,0 +1,30 @@
+export type PrimitiveKey = string | number | boolean | null | undefined;
+export type ICollection<T> = Readonly<{
+    all: () => T[];
+    toArray: () => T[];
+    count: () => number;
+    isEmpty: () => boolean;
+    map: <U>(fn: (item: T, index: number) => U) => ICollection<U>;
+    filter: (fn: (item: T, index: number) => boolean) => ICollection<T>;
+    reduce: <U>(fn: (acc: U, item: T, index: number) => U, initial: U) => U;
+    first: (fn?: (item: T, index: number) => boolean) => T | undefined;
+    last: (fn?: (item: T, index: number) => boolean) => T | undefined;
+    pluck: <K extends keyof T>(key: K) => ICollection<T[K]>;
+    where: <K extends keyof T>(key: K, value: T[K]) => ICollection<T>;
+    unique: (keySelector?: (item: T) => PrimitiveKey) => ICollection<T>;
+    sortBy: (keySelector: (item: T) => PrimitiveKey) => ICollection<T>;
+    chunk: (size: number) => ICollection<T[]>;
+    take: (n: number) => ICollection<T>;
+    skip: (n: number) => ICollection<T>;
+    keyBy: <K extends PropertyKey>(keySelector: (item: T) => K) => ReadonlyMap<K, T>;
+    groupBy: <K extends PropertyKey>(keySelector: (item: T) => K) => ReadonlyMap<K, ICollection<T>>;
+    tap: (fn: (items: T[]) => void) => ICollection<T>;
+    [Symbol.iterator]: () => Iterator<T>;
+}>;
+export declare const Collection: Readonly<{
+    from: <T>(items: Iterable<T> | ArrayLike<T> | null | undefined) => ICollection<T>;
+    of: <T>(...items: T[]) => ICollection<T>;
+    isCollection: (value: unknown) => value is ICollection<unknown>;
+}>;
+export declare function collect<T>(items: Iterable<T> | ArrayLike<T> | null | undefined): ICollection<T>;
+//# sourceMappingURL=Collection.d.ts.map

package/src/collections/Collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Collection.d.ts","sourceRoot":"","sources":["../../../src/collections/Collection.ts"],"names":[],"mappings":"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"}

package/src/collections/Collection.js

@@ -0,0 +1,146 @@
+function normalizeToArray(items) {
+    if (items === null || items === undefined)
+        return [];
+    if (typeof items[Symbol.iterator] === 'function') {
+        return Array.from(items);
+    }
+    return Array.from(items);
+}
+function stableArray(items) {
+    return items.slice();
+}
+function firstMatch(snapshot, fn) {
+    if (!fn)
+        return snapshot[0];
+    for (let i = 0; i < snapshot.length; i += 1) {
+        if (fn(snapshot[i], i))
+            return snapshot[i];
+    }
+    return undefined;
+}
+function lastMatch(snapshot, fn) {
+    if (!fn)
+        return snapshot.at(-1);
+    for (let i = snapshot.length - 1; i >= 0; i -= 1) {
+        if (fn(snapshot[i], i))
+            return snapshot[i];
+    }
+    return undefined;
+}
+function uniqueItems(snapshot, keySelector) {
+    const seen = new Set();
+    const out = [];
+    for (const item of snapshot) {
+        const key = keySelector ? keySelector(item) : item;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(item);
+    }
+    return out;
+}
+function sortByKey(snapshot, keySelector) {
+    const out = snapshot.slice();
+    out.sort((a, b) => {
+        const ka = keySelector(a);
+        const kb = keySelector(b);
+        const aNil = ka === null || ka === undefined;
+        const bNil = kb === null || kb === undefined;
+        if (aNil && bNil)
+            return 0;
+        if (aNil)
+            return 1;
+        if (bNil)
+            return -1;
+        if (typeof ka === 'number' && typeof kb === 'number')
+            return ka - kb;
+        return String(ka).localeCompare(String(kb));
+    });
+    return out;
+}
+function chunkItems(snapshot, size) {
+    const n = Math.floor(size);
+    if (!Number.isFinite(n) || n <= 0)
+        return [];
+    const out = [];
+    for (let i = 0; i < snapshot.length; i += n) {
+        out.push(snapshot.slice(i, i + n));
+    }
+    return out;
+}
+function keyByItems(snapshot, keySelector) {
+    const out = new Map();
+    for (const item of snapshot) {
+        out.set(keySelector(item), item);
+    }
+    return out;
+}
+function groupByItems(snapshot, keySelector) {
+    const groups = new Map();
+    for (const item of snapshot) {
+        const key = keySelector(item);
+        const bucket = groups.get(key);
+        if (bucket)
+            bucket.push(item);
+        else
+            groups.set(key, [item]);
+    }
+    const out = new Map();
+    for (const [k, bucket] of groups.entries()) {
+        out.set(k, makeCollection(bucket));
+    }
+    return out;
+}
+function makeCollection(items) {
+    const snapshot = stableArray(items);
+    const api = Object.freeze({
+        all: () => snapshot.slice(),
+        toArray: () => snapshot.slice(),
+        count: () => snapshot.length,
+        isEmpty: () => snapshot.length === 0,
+        map: (fn) => makeCollection(snapshot.map(fn)),
+        filter: (fn) => makeCollection(snapshot.filter(fn)),
+        reduce: (fn, initial) => snapshot.reduce(fn, initial),
+        first: (fn) => firstMatch(snapshot, fn),
+        last: (fn) => lastMatch(snapshot, fn),
+        pluck: (key) => makeCollection(snapshot.map((item) => item[key])),
+        where: (key, value) => makeCollection(snapshot.filter((item) => item[key] === value)),
+        unique: (keySelector) => makeCollection(uniqueItems(snapshot, keySelector)),
+        sortBy: (keySelector) => makeCollection(sortByKey(snapshot, keySelector)),
+        chunk: (size) => makeCollection(chunkItems(snapshot, size)),
+        take: (n) => {
+            const count = Math.max(0, Math.floor(n));
+            return makeCollection(snapshot.slice(0, count));
+        },
+        skip: (n) => {
+            const count = Math.max(0, Math.floor(n));
+            return makeCollection(snapshot.slice(count));
+        },
+        keyBy: (keySelector) => keyByItems(snapshot, keySelector),
+        groupBy: (keySelector) => groupByItems(snapshot, keySelector),
+        tap: (fn) => {
+            fn(snapshot.slice());
+            return makeCollection(snapshot);
+        },
+        [Symbol.iterator]: function* () {
+            for (const item of snapshot)
+                yield item;
+        },
+    });
+    return api;
+}
+export const Collection = Object.freeze({
+    from: (items) => makeCollection(normalizeToArray(items)),
+    of: (...items) => makeCollection(items),
+    isCollection: (value) => {
+        if (value === null || value === undefined)
+            return false;
+        return (typeof value === 'object' &&
+            typeof value.all === 'function' &&
+            typeof value.map === 'function' &&
+            typeof value[Symbol.iterator] === 'function');
+    },
+});
+export function collect(items) {
+    return Collection.from(items);
+}

package/src/collections/index.d.ts

@@ -0,0 +1,3 @@
+export { collect, Collection } from '../collections/Collection';
+export type { ICollection, PrimitiveKey } from '../collections/Collection';
+//# sourceMappingURL=index.d.ts.map

package/src/collections/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/src/collections/index.js

@@ -0,0 +1 @@
+export { collect, Collection } from '../collections/Collection.js';

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

@@ -1 +1 @@
-{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../../src/config/broadcast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAGL,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,+BAA+B,EAChC,MAAM,cAAc,CAAC;;IA0EpB;;OAEG;sBACY,MAAM;IAIrB;;;;;OAKG;;2BAEe,6BAA6B;;;;;IAc/C;;OAEG;kCACc,MAAM;IAIvB;;;OAGG;sCACoB,MAAM,KAAG,0BAA0B;;AAK5D,wBAAiD"}
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../../src/config/broadcast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAGL,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,+BAA+B,EAChC,MAAM,cAAc,CAAC;;IA4EpB;;OAEG;sBACY,MAAM;IAIrB;;;;;OAKG;;2BAEe,6BAA6B;;;;;IAc/C;;OAEG;kCACc,MAAM;IAIvB;;;OAGG;sCACoB,MAAM,KAAG,0BAA0B;;AAK5D,wBAAiD"}

package/src/config/broadcast.js

@@ -11,11 +11,13 @@ const hasOwn = (obj, key) => {
     return Object.prototype.hasOwnProperty.call(obj, key);
 };
 const getDefaultBroadcaster = (drivers) => {
-    const value = normalizeDriverName(Env.get('BROADCAST_DRIVER', 'inmemory'));
-    if (value.length > 0 && hasOwn(drivers, value)) {
+    const envSelectedRaw = Env.get('BROADCAST_CONNECTION', Env.get('BROADCAST_DRIVER', 'inmemory'));
+    const value = normalizeDriverName(envSelectedRaw ?? 'inmemory');
+    if (value.length > 0 && hasOwn(drivers, value))
         return value;
+    if (envSelectedRaw.trim().length > 0) {
+        throw ErrorFactory.createConfigError(`Broadcast driver not configured: ${value}`);
     }
-    // Backwards-compatible default.
     return hasOwn(drivers, 'inmemory') ? 'inmemory' : (Object.keys(drivers)[0] ?? 'inmemory');
 };
 const getPusherConfig = () => ({

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

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/config/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAoB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA+EnE,eAAO,MAAM,WAAW;IArDtB;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BH;;OAEG;qBACc,MAAM,GAAG,iBAAiB;IAI3C;;OAEG;;IAGH;;OAEG;;EAImD,CAAC;AACzD,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/config/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAoB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA2FnE,eAAO,MAAM,WAAW;IA/DtB;;OAEG;;IAaH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BH;;OAEG;qBACc,MAAM,GAAG,iBAAiB;IAI3C;;OAEG;;IAGH;;OAEG;;EAImD,CAAC;AACzD,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC"}

package/src/config/cache.js

@@ -17,17 +17,23 @@ const getCacheDriver = (config, name) => {
     if (isExplicitSelection) {
         throw ErrorFactory.createConfigError(`Cache store not configured: ${storeName}`);
     }
-    // Backwards-compatible fallback.
-    const fallback = config.drivers['memory'] ?? Object.values(config.drivers)[0];
-    if (fallback !== undefined)
-        return fallback;
-    throw ErrorFactory.createConfigError('No cache stores are configured');
+    if (Object.keys(config.drivers ?? {}).length === 0) {
+        throw ErrorFactory.createConfigError('No cache stores are configured');
+    }
+    throw ErrorFactory.createConfigError(`Cache default store not configured: ${storeName || '<empty>'}`);
 };
 const cacheConfigObj = {
     /**
      * Default cache driver
      */
-    default: Env.CACHE_DRIVER,
+    default: (() => {
+        const envConnection = Env.get('CACHE_CONNECTION', '').trim();
+        const envDriver = typeof Env.CACHE_DRIVER === 'string'
+            ? String(Env.CACHE_DRIVER)
+            : Env.get('CACHE_DRIVER', 'memory');
+        const selected = envConnection.length > 0 ? envConnection : String(envDriver ?? 'memory');
+        return selected.trim().toLowerCase();
+    })(),
     /**
      * Cache drivers
      */

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

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/config/database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAuB,MAAM,cAAc,CAAC;AAkHlG,eAAO,MAAM,cAAc;IAzCzB;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH;;OAEG;wBACiB,mBAAmB,GAAG,wBAAwB;IAIlE;;OAEG;;;;;IAMH;;OAEG;;;;;IAMH;;OAEG;;;;EAMyD,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/config/database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAuB,MAAM,cAAc,CAAC;AAoHlG,eAAO,MAAM,cAAc;IAzCzB;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH;;OAEG;wBACiB,mBAAmB,GAAG,wBAAwB;IAIlE;;OAEG;;;;;IAMH;;OAEG;;;;;IAMH;;OAEG;;;;EAMyD,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC"}

package/src/config/database.js

@@ -9,11 +9,13 @@ const hasOwn = (obj, key) => {
     return Object.prototype.hasOwnProperty.call(obj, key);
 };
 const getDefaultConnection = (connections) => {
-    const value = String(Env.DB_CONNECTION || '').trim();
-    if (value.length > 0 && hasOwn(connections, value)) {
+    const envSelectedRaw = Env.get('DB_CONNECTION', '');
+    const value = String(envSelectedRaw ?? '').trim();
+    if (value.length > 0 && hasOwn(connections, value))
         return value;
+    if (envSelectedRaw.trim().length > 0) {
+        throw ErrorFactory.createConfigError(`Database connection not configured: ${value}`);
     }
-    // Backwards-compatible default.
     return hasOwn(connections, 'sqlite') ? 'sqlite' : (Object.keys(connections)[0] ?? 'sqlite');
 };
 const getDatabaseConnection = (config) => {

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;AAwGtE,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;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"}

package/src/config/mail.js

@@ -5,33 +5,40 @@
  */
 import { Env } from './env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
+const isMailDriverConfig = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (!('driver' in value))
+        return false;
+    const driver = value.driver;
+    return typeof driver === 'string' && driver.trim().length > 0;
+};
 const getMailDriver = (config, name) => {
-    const selected = (name ?? config.default).toString().trim();
+    const drivers = config.drivers;
+    const envSelectedRaw = Env.get('MAIL_CONNECTION', Env.get('MAIL_DRIVER', '')).trim();
+    const selected = (name ??
+        (envSelectedRaw.length > 0 ? envSelectedRaw : undefined) ??
+        config.default)
+        .toString()
+        .trim();
     if (selected.length === 0) {
-        const disabled = config.drivers['disabled'];
-        if (disabled !== undefined)
+        const disabled = drivers['disabled'];
+        if (isMailDriverConfig(disabled))
             return disabled;
         throw ErrorFactory.createConfigError('Mail driver not configured: disabled');
     }
-    if (Object.hasOwn(config.drivers, selected)) {
-        const resolved = config.drivers[selected];
-        if (resolved !== undefined)
+    if (Object.hasOwn(drivers, selected)) {
+        const resolved = drivers[selected];
+        if (isMailDriverConfig(resolved))
             return resolved;
     }
-    // Backward-compatible fallback: if the default is misconfigured, treat mail as disabled.
-    if (name === undefined) {
-        const disabled = config.drivers['disabled'];
-        if (disabled !== undefined)
-            return disabled;
-        throw ErrorFactory.createConfigError('Mail driver not configured: disabled');
-    }
     throw ErrorFactory.createConfigError(`Mail driver not configured: ${selected}`);
 };
 const mailConfigObj = {
     /**
      * Default mail driver
      */
-    default: Env.get('MAIL_DRIVER', 'disabled').trim().toLowerCase() || 'disabled',
+    default: Env.get('MAIL_CONNECTION', Env.get('MAIL_DRIVER', 'disabled')).trim().toLowerCase(),
     /**
      * Default "From" identity
      */

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;AA2GtB,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;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"}

package/src/config/notification.js

@@ -11,9 +11,13 @@ const hasOwn = (obj, key) => {
     return Object.prototype.hasOwnProperty.call(obj, key);
 };
 const getDefaultChannel = (drivers) => {
-    const value = normalizeName(Env.get('NOTIFICATION_DRIVER', 'console'));
+    const envSelectedRaw = Env.get('NOTIFICATION_CONNECTION', Env.get('NOTIFICATION_DRIVER', 'console'));
+    const value = normalizeName(envSelectedRaw ?? 'console');
     if (value.length > 0 && hasOwn(drivers, value))
         return value;
+    if (envSelectedRaw.trim().length > 0) {
+        throw ErrorFactory.createConfigError(`Notification channel not configured: ${value}`);
+    }
     return hasOwn(drivers, 'console') ? 'console' : (Object.keys(drivers)[0] ?? 'console');
 };
 const getNotificationDriver = (config, name) => {
@@ -27,13 +31,14 @@ const getNotificationDriver = (config, name) => {
         if (resolved !== undefined)
             return resolved;
     }
+    if (Object.keys(config.drivers ?? {}).length === 0) {
+        throw ErrorFactory.createConfigError('No notification channels are configured');
+    }
     if (isExplicitSelection) {
         throw ErrorFactory.createConfigError(`Notification channel not configured: ${channelName}`);
     }
-    const fallback = config.drivers['console'] ?? Object.values(config.drivers)[0];
-    if (fallback !== undefined)
-        return fallback;
-    throw ErrorFactory.createConfigError('No notification channels are configured');
+    // Default selection is strict: if `default` points at an unconfigured channel, throw.
+    throw ErrorFactory.createConfigError(`Notification channel not configured: ${channelName}`);
 };
 const getBaseProviders = () => {
     return {

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

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/config/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAiI9F,eAAO,MAAM,aAAa;IAhExB;;OAEG;sBACY,MAAM;IAIrB;;OAEG;sBACY,cAAc;IAI7B;;OAEG;oBACa,oBAAoB,GAAG,mBAAmB;IAI1D;;;;;;OAMG;0BACmB,oBAAoB,SAAS,MAAM,GAAG,mBAAmB;IAI/E;;OAEG;mBACS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAO5C;;OAEG;sBACY;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAQtE;;OAEG;sBACY;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;EAQW,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/config/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAmI9F,eAAO,MAAM,aAAa;IAhExB;;OAEG;sBACY,MAAM;IAIrB;;OAEG;sBACY,cAAc;IAI7B;;OAEG;oBACa,oBAAoB,GAAG,mBAAmB;IAI1D;;;;;;OAMG;0BACmB,oBAAoB,SAAS,MAAM,GAAG,mBAAmB;IAI/E;;OAEG;mBACS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAO5C;;OAEG;sBACY;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAQtE;;OAEG;sBACY;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;EAQW,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC"}

package/src/config/storage.js

@@ -20,11 +20,10 @@ const getStorageDriver = (config, name) => {
     if (isExplicitSelection) {
         throw ErrorFactory.createConfigError(`Storage disk not configured: ${diskName}`);
     }
-    // Backwards-compatible fallback.
-    const fallback = config.drivers['local'] ?? Object.values(config.drivers)[0];
-    if (fallback !== undefined)
-        return fallback;
-    throw ErrorFactory.createConfigError('No storage disks are configured');
+    if (Object.keys(config.drivers ?? {}).length === 0) {
+        throw ErrorFactory.createConfigError('No storage disks are configured');
+    }
+    throw ErrorFactory.createConfigError(`Storage default disk not configured: ${diskName || '<empty>'}`);
 };
 const getDrivers = () => ({
     local: {
@@ -65,7 +64,7 @@ const storageConfigObj = {
      * Default storage driver (dynamic; tests may mutate process.env)
      */
     get default() {
-        return Env.get('STORAGE_DRIVER', 'local');
+        return Env.get('STORAGE_CONNECTION', Env.get('STORAGE_DRIVER', 'local')).trim().toLowerCase();
     },
     /**
      * Storage drivers configuration (dynamic; tests may mutate process.env)

package/src/events/EventDispatcher.d.ts

@@ -0,0 +1,16 @@
+export type EventMap = Record<string, unknown>;
+export type EventListener<TPayload> = (payload: TPayload) => void | Promise<void>;
+export interface IEventDispatcher<TEvents extends EventMap = EventMap> {
+    on<K extends keyof TEvents & string>(event: K, listener: EventListener<TEvents[K]>): () => void;
+    once<K extends keyof TEvents & string>(event: K, listener: EventListener<TEvents[K]>): () => void;
+    off<K extends keyof TEvents & string>(event: K, listener: EventListener<TEvents[K]>): void;
+    emit<K extends keyof TEvents & string>(event: K, payload: TEvents[K]): void;
+    emitAsync<K extends keyof TEvents & string>(event: K, payload: TEvents[K]): Promise<void>;
+    listenerCount<K extends keyof TEvents & string>(event: K): number;
+    clear<K extends keyof TEvents & string>(event?: K): void;
+}
+export declare const EventDispatcher: Readonly<{
+    create<TEvents extends EventMap = EventMap>(): IEventDispatcher<TEvents>;
+}>;
+export default EventDispatcher;
+//# sourceMappingURL=EventDispatcher.d.ts.map

package/src/events/EventDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventDispatcher.d.ts","sourceRoot":"","sources":["../../../src/events/EventDispatcher.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC/C,MAAM,MAAM,aAAa,CAAC,QAAQ,IAAI,CAAC,OAAO,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElF,MAAM,WAAW,gBAAgB,CAAC,OAAO,SAAS,QAAQ,GAAG,QAAQ;IACnE,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAChG,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAClG,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC3F,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5E,SAAS,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,aAAa,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC;IAClE,KAAK,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;CAC1D;AAwBD,eAAO,MAAM,eAAe;WACnB,OAAO,SAAS,QAAQ,gBAAgB,gBAAgB,CAAC,OAAO,CAAC;EAiGxE,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/src/events/EventDispatcher.js

@@ -0,0 +1,90 @@
+import { Logger } from '../config/logger.js';
+function getOrCreateSet(store, event) {
+    const existing = store.get(event);
+    if (existing !== undefined)
+        return existing;
+    const created = new Set();
+    store.set(event, created);
+    return created;
+}
+function safeFireAndForget(listener, payload, event) {
+    const result = listener(payload);
+    if (result instanceof Promise) {
+        void result.catch((error) => {
+            Logger.error('Unhandled async event listener error', { event, error });
+        });
+    }
+}
+export const EventDispatcher = Object.freeze({
+    create() {
+        const listeners = new Map();
+        return {
+            on(event, listener) {
+                const set = getOrCreateSet(listeners, event);
+                set.add(listener);
+                return () => {
+                    this.off(event, listener);
+                };
+            },
+            once(event, listener) {
+                const wrapped = async (payload) => {
+                    this.off(event, wrapped);
+                    return listener(payload);
+                };
+                const set = getOrCreateSet(listeners, event);
+                set.add(wrapped);
+                return () => {
+                    this.off(event, wrapped);
+                };
+            },
+            off(event, listener) {
+                const set = listeners.get(event);
+                if (set === undefined)
+                    return;
+                set.delete(listener);
+                if (set.size === 0) {
+                    listeners.delete(event);
+                }
+            },
+            emit(event, payload) {
+                const set = listeners.get(event);
+                if (set === undefined)
+                    return;
+                // Snapshot to avoid mutation during iteration affecting dispatch.
+                const snapshot = Array.from(set);
+                for (const listener of snapshot) {
+                    safeFireAndForget(listener, payload, event);
+                }
+            },
+            async emitAsync(event, payload) {
+                const set = listeners.get(event);
+                if (set === undefined)
+                    return;
+                const snapshot = Array.from(set);
+                const results = await Promise.allSettled(snapshot.map(async (listener) => {
+                    await listener(payload);
+                }));
+                const errors = results
+                    .filter((r) => r.status === 'rejected')
+                    .map((r) => r.reason);
+                if (errors.length === 1) {
+                    throw errors[0];
+                }
+                if (errors.length > 1) {
+                    throw new AggregateError(errors, `Multiple event listeners failed for "${event}"`);
+                }
+            },
+            listenerCount(event) {
+                return listeners.get(event)?.size ?? 0;
+            },
+            clear(event) {
+                if (event !== undefined) {
+                    listeners.delete(event);
+                    return;
+                }
+                listeners.clear();
+            },
+        };
+    },
+});
+export default EventDispatcher;

package/src/events/index.d.ts

@@ -0,0 +1,3 @@
+export { EventDispatcher } from './EventDispatcher';
+export type { EventListener, EventMap, IEventDispatcher } from './EventDispatcher';
+//# sourceMappingURL=index.d.ts.map

package/src/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/src/events/index.js

@@ -0,0 +1 @@
+export { EventDispatcher } from './EventDispatcher.js';

package/src/features/Queue.js

@@ -11,7 +11,7 @@ export const Queue = Object.freeze({
      * Add a job to the queue
      */
     async add(data) {
-        const id = await generateSecureJobId();
+        const id = generateSecureJobId();
         const job = {
             id,
             data,

package/src/http/Response.d.ts

@@ -8,8 +8,8 @@ export interface IResponse {
     setStatus(code: number): IResponse;
     getStatus(): number;
     readonly statusCode: number;
-    setHeader(name: string, value: string): IResponse;
-    getHeader(name: string): string | undefined;
+    setHeader(name: string, value: string | string[]): IResponse;
+    getHeader(name: string): string | string[] | undefined;
     json(data: unknown): void;
     text(text: string): void;
     html(html: string): void;

package/src/http/Response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Response.d.ts","sourceRoot":"","sources":["../../../src/http/Response.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,SAAS,IAAI,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,MAAM,IAAI,IAAI,CAAC,cAAc,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ;IACnB;;OAEG;gBACS,IAAI,CAAC,cAAc,GAAG,SAAS;EA0D3C,CAAC;AAEH,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Response.d.ts","sourceRoot":"","sources":["../../../src/http/Response.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAE9C,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,SAAS,IAAI,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,MAAM,IAAI,IAAI,CAAC,cAAc,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ;IACnB;;OAEG;gBACS,IAAI,CAAC,cAAc,GAAG,SAAS;EA0D3C,CAAC;AAEH,eAAe,QAAQ,CAAC"}

package/src/index.d.ts

@@ -65,6 +65,7 @@ export { MiddlewareStack } from './middleware/MiddlewareStack';
 export type { Middleware } from './middleware/MiddlewareStack';
 export { RateLimiter } from './middleware/RateLimiter';
 export { SecurityMiddleware } from './middleware/SecurityMiddleware';
+export { SessionMiddleware } from './middleware/SessionMiddleware';
 export { MySQLAdapter } from './orm/adapters/MySQLAdapter';
 export { PostgreSQLAdapter } from './orm/adapters/PostgreSQLAdapter';
 export { SQLiteAdapter } from './orm/adapters/SQLiteAdapter';
@@ -81,6 +82,8 @@ export type { IRouter } from './routing/Router';
 export { delay, ensureDirSafe } from './common/index';
 export { generateSecureJobId, generateUuid } from './common/uuid';
 export { ZintrustAwsSigV4 as AwsSigV4 };
+export { collect, Collection } from './collections/index';
+export type { ICollection, PrimitiveKey } from './collections/index';
 export { HttpClient } from './tools/http/Http';
 export type { IHttpRequest, IHttpResponse } from './tools/http/Http';
 export type { DatabaseConfig, ID1Database } from './orm/DatabaseAdapter';
@@ -99,10 +102,16 @@ export { Encryptor } from './security/Encryptor';
 export { Hash } from './security/Hash';
 export { JwtManager } from './security/JwtManager';
 export type { IJwtManager, JwtAlgorithm, JwtManagerType, JwtOptions, JwtPayload, } from './security/JwtManager';
+export { PasswordResetTokenBroker } from './security/PasswordResetTokenBroker';
+export type { IPasswordResetTokenBroker, IPasswordResetTokenStore, PasswordResetTokenBrokerOptions, PasswordResetTokenBrokerType, PasswordResetTokenRecord, } from './security/PasswordResetTokenBroker';
 export { Xss } from './security/Xss';
 export { XssProtection } from './security/XssProtection';
 export { ZintrustSignedRequest as SignedRequest };
 export { ErrorFactory } from './exceptions/ZintrustError';
+export { EventDispatcher } from './events/EventDispatcher';
+export type { EventListener, EventMap, IEventDispatcher } from './events/EventDispatcher';
+export { SessionManager } from './session/SessionManager';
+export type { ISession, ISessionManager, SessionData, SessionManagerOptions, } from './session/SessionManager';
 export { Env } from './config/env';
 export { Logger } from './config/logger';
 export { appConfig } from './config/app';
@@ -154,9 +163,11 @@ export { Notification } from './tools/notification/Notification';
 export { NotificationRegistry } from './tools/notification/Registry';
 export { MarkdownRenderer } from './tools/templates';
 export { RuntimeHealthProbes } from './health/RuntimeHealthProbes';
+export { BroadcastWorker } from './workers/BroadcastWorker';
 export { Broadcast } from './tools/broadcast/Broadcast';
 export { BroadcastRegistry } from './tools/broadcast/BroadcastRegistry';
 export { registerBroadcastersFromRuntimeConfig } from './tools/broadcast/BroadcastRuntimeRegistration';
+export { NotificationWorker } from './workers/NotificationWorker';
 export { Storage } from './tools/storage/index';
 export { LocalSignedUrl } from './tools/storage/LocalSignedUrl';
 export { StorageDriverRegistry } from './tools/storage/StorageDriverRegistry';