@zintrust/core 0.4.39 → 0.4.41

package/src/config/env.js

@@ -5,16 +5,32 @@
  * Sealed namespace pattern - all exports through Env namespace
  * Safe for both Node.js and serverless runtimes (Cloudflare Workers, Deno, Lambda)
  */
+import { isArray, isNonEmptyString, isObject } from '../helper/index.js';
 // Cache process check once at module load time
 const processLike = typeof process === 'undefined' ? undefined : process;
 let externalEnvSource = null;
+const DIRECT_ENV_SOURCE = 'direct-env';
+const PACKED_ENV_ENABLE_KEY = 'USE_PACK';
+const PACKED_ENV_KEYS_KEY = 'PACK_KEYS';
+const PACKED_ENV_CONTROL_KEYS = new Set([PACKED_ENV_ENABLE_KEY, PACKED_ENV_KEYS_KEY]);
+const createPackedEnvError = (message, details) => {
+    const error = Object.create(globalThis.Error.prototype);
+    error.name = 'ConfigError';
+    error.message = message;
+    error.code = 'CONFIG_ERROR';
+    error.statusCode = 500;
+    if (details !== undefined) {
+        error.details = details;
+    }
+    return error;
+};
 const getGlobalEnv = () => {
     const env = globalThis.env;
     if (env === undefined || env === null || typeof env !== 'object')
         return undefined;
     return env;
 };
-const getEnvSource = () => {
+const getRawEnvSource = () => {
     if (typeof externalEnvSource === 'function')
         return externalEnvSource();
     if (externalEnvSource !== null)
@@ -28,6 +44,14 @@ const getEnvSource = () => {
     }
     return processLike?.env ?? {};
 };
+const normalizePackedScalar = (packName, key, value) => {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    throw createPackedEnvError(`${packName} contains unsupported value for ${key}. Expected a flat string-compatible value.`);
+};
 const normalizeEnvValue = (value) => {
     if (value === null || value === undefined)
         return '';
@@ -38,6 +62,86 @@ const normalizeEnvValue = (value) => {
     }
     return '';
 };
+const isDirectEnvScalar = (value) => {
+    return (value === null ||
+        value === undefined ||
+        typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean' ||
+        typeof value === 'bigint');
+};
+const parsePackedEnvKeys = (env) => {
+    const enabled = normalizeEnvValue(env[PACKED_ENV_ENABLE_KEY]).trim().toLowerCase() === 'true';
+    if (!enabled) {
+        return { enabled: false, packKeys: [] };
+    }
+    const raw = normalizeEnvValue(env[PACKED_ENV_KEYS_KEY]);
+    const packKeys = raw
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item, index, items) => item !== '' && items.indexOf(item) === index);
+    if (packKeys.length === 0) {
+        throw createPackedEnvError('USE_PACK is true but PACK_KEYS is empty');
+    }
+    return { enabled: true, packKeys };
+};
+const parsePackedPayload = (packName, payload) => {
+    if (!isNonEmptyString(normalizeEnvValue(payload))) {
+        throw createPackedEnvError(`PACK_KEYS contains ${packName} but env.${packName} is missing`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(normalizeEnvValue(payload));
+    }
+    catch (error) {
+        throw createPackedEnvError(`${packName} did not parse as a JSON object`, error);
+    }
+    if (!isObject(parsed) || isArray(parsed)) {
+        throw createPackedEnvError(`${packName} did not parse as a JSON object`);
+    }
+    return parsed;
+};
+const applyPackedPayload = (values, sources, packName, payload) => {
+    for (const [rawKey, rawValue] of Object.entries(payload)) {
+        const key = rawKey.trim();
+        if (!isNonEmptyString(key))
+            continue;
+        if (PACKED_ENV_CONTROL_KEYS.has(key))
+            continue;
+        if (isObject(rawValue) || isArray(rawValue) || rawValue === null || rawValue === undefined) {
+            throw createPackedEnvError(`${packName} contains unsupported value for ${key}. Nested or null values are not supported.`);
+        }
+        values[key] = normalizePackedScalar(packName, key, rawValue);
+        sources[key] = packName;
+    }
+};
+const overlayDirectEnvValues = (values, sources, env) => {
+    for (const [key, rawValue] of Object.entries(env)) {
+        if (!isDirectEnvScalar(rawValue))
+            continue;
+        values[key] = normalizeEnvValue(rawValue);
+        sources[key] = DIRECT_ENV_SOURCE;
+    }
+};
+const resolvePackedEnvState = (env) => {
+    const values = {};
+    const sources = {};
+    const { enabled, packKeys } = parsePackedEnvKeys(env);
+    if (enabled) {
+        for (const packName of packKeys) {
+            applyPackedPayload(values, sources, packName, parsePackedPayload(packName, env[packName]));
+        }
+    }
+    overlayDirectEnvValues(values, sources, env);
+    return {
+        values,
+        sources,
+        packedEnabled: enabled,
+        packedKeys: packKeys,
+    };
+};
+const getResolvedEnvState = () => resolvePackedEnvState(getRawEnvSource());
+const getEnvSource = () => getResolvedEnvState().values;
 export const getProcessLike = () => processLike;
 export const dirnameFromExecPath = (execPath, platform) => {
     const separator = platform === 'win32' ? '\\' : '/';
@@ -46,11 +150,26 @@ export const dirnameFromExecPath = (execPath, platform) => {
         return '';
     return execPath.slice(0, lastSep);
 };
+export const getOptional = (key) => {
+    const env = getEnvSource();
+    return Object.prototype.hasOwnProperty.call(env, key) ? normalizeEnvValue(env[key]) : undefined;
+};
+export const has = (key) => {
+    const env = getEnvSource();
+    return Object.prototype.hasOwnProperty.call(env, key);
+};
+export const getSourceOf = (key) => {
+    return getResolvedEnvState().sources[key];
+};
+export const snapshotSources = () => {
+    return { ...getResolvedEnvState().sources };
+};
+export const getResolvedState = () => getResolvedEnvState();
 // Private helper functions
 export const get = (key, defaultValue) => {
     const env = getEnvSource();
     const value = normalizeEnvValue(env[key]);
-    return value === '' ? defaultValue ?? '' : value;
+    return value === '' ? (defaultValue ?? '') : value;
 };
 export const getInt = (key, defaultValue) => {
     const value = get(key, String(defaultValue ?? 0));
@@ -107,13 +226,18 @@ const PROXY_SECRET_FALLBACK = get('APP_KEY', '');
 export const Env = Object.freeze({
     // Helper functions
     get,
+    getOptional,
     getInt,
     getBool,
     getFloat,
+    has,
     set,
     unset,
     setSource,
     snapshot,
+    getSourceOf,
+    snapshotSources,
+    getResolvedState,
     // Core
     NODE_ENV: get('NODE_ENV', 'development'),
     // Prefer PORT, fallback to APP_PORT for compatibility

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.39
+ * @zintrust/core v0.4.41
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-30T20:09:19.868Z
+ *   Built: 2026-03-31T14:32:01.889Z
  *   Node: >=20.0.0
  *   License: MIT
  *
@@ -21,7 +21,7 @@
  * Available at runtime for debugging and health checks
  */
 export const ZINTRUST_VERSION = '0.1.41';
-export const ZINTRUST_BUILD_DATE = '2026-03-30T20:09:19.808Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-31T14:32:01.844Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/runtime/RuntimeServices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RuntimeServices.d.ts","sourceRoot":"","sources":["../../../src/runtime/RuntimeServices.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;AAEtF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACzD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,UAAU,GACV,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,eAAe,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IAC9D,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,aAAa,EAAE,OAAO,aAAa,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,KAAK,MAAM,GAAG,MAAM,CAAC;IAC3E,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACxC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,GAAG,EAAE,gBAAgB,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAO,OAE1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAO,eAGxC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAAyC,CAAC;AAwIzE,eAAO,MAAM,eAAe;qBACT,eAAe,GAAG,eAAe;EAqBlD,CAAC;AAEH,eAAe,eAAe,CAAC"}
+{"version":3,"file":"RuntimeServices.d.ts","sourceRoot":"","sources":["../../../src/runtime/RuntimeServices.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;AAEtF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACpD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACzD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,iBAAiB,GACjB,WAAW,GACX,WAAW,GACX,SAAS,GACT,UAAU,GACV,UAAU,GACV,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,YAAY,CAAC;IACrB,eAAe,EAAE,CAAC,CAAC,SAAS,iBAAiB,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;IAC9D,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,aAAa,EAAE,OAAO,aAAa,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,KAAK,MAAM,GAAG,MAAM,CAAC;IAC3E,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACxC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,GAAG,EAAE,gBAAgB,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAO,OAE1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAAO,eAGxC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,eAAyC,CAAC;AA2GzE,eAAO,MAAM,eAAe;qBACT,eAAe,GAAG,eAAe;EAqBlD,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/src/runtime/RuntimeServices.js

@@ -17,42 +17,12 @@ export const detectRuntimePlatform = () => {
     return 'nodejs';
 };
 export const RUNTIME_PLATFORM = detectRuntimePlatform();
-const normalizeEnvValue = (value) => {
-    if (value === null || value === undefined)
-        return '';
-    if (typeof value === 'string')
-        return value;
-    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
-        return String(value);
-    }
-    return '';
-};
-const readEnvFromRecord = (record, key) => {
-    return normalizeEnvValue(record[key]);
-};
 const createWorkersEnvReader = () => {
     return {
-        get(key, defaultValue = '') {
-            const env = Cloudflare.getWorkersEnv() ?? {};
-            const value = readEnvFromRecord(env, key);
-            return value === '' ? defaultValue : value;
-        },
-        getInt(key, defaultValue = 0) {
-            const raw = this.get(key, String(defaultValue));
-            const parsed = Number.parseInt(raw, 10);
-            return Number.isFinite(parsed) ? parsed : defaultValue;
-        },
-        getFloat(key, defaultValue = 0) {
-            const raw = this.get(key, String(defaultValue));
-            const parsed = Number.parseFloat(raw);
-            return Number.isFinite(parsed) ? parsed : defaultValue;
-        },
-        getBool(key, defaultValue = false) {
-            const raw = this.get(key, defaultValue ? 'true' : 'false').toLowerCase();
-            if (raw === '')
-                return defaultValue;
-            return raw === 'true' || raw === '1';
-        },
+        get: (key, defaultValue) => Env.get(key, defaultValue),
+        getInt: (key, defaultValue) => Env.getInt(key, defaultValue ?? 0),
+        getFloat: (key, defaultValue) => Env.getFloat(key, defaultValue ?? 0),
+        getBool: (key, defaultValue) => Env.getBool(key, defaultValue),
     };
 };
 const createNodeEnvReader = () => {