@zintrust/core 0.7.2 → 0.7.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.7.2",
+  "version": "0.7.7",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {

package/src/cache/drivers/KVRemoteDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KVRemoteDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/KVRemoteDriver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2YtD,eAAO,MAAM,cAAc;kBA5FM,WAAW;EA8F1C,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"KVRemoteDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/KVRemoteDriver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA6YtD,eAAO,MAAM,cAAc;kBAvEM,WAAW;EAyE1C,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cache/drivers/KVRemoteDriver.js

@@ -206,6 +206,25 @@ const createCloudflareKvApiClient = (resolveNamespaceId) => {
     };
     return { getJson, putJson, deleteKey };
 };
+const logKvRemoteProxyFallback = (operation, error) => {
+    Logger.warn(`KV remote proxy ${operation} failed; falling back to Cloudflare KV API`, Logger.withTraceSkipContext({
+        error: error instanceof Error ? error.message : String(error),
+    }));
+};
+const clearKvRemoteDriver = async () => {
+    Logger.warn('KV remote clear() is not implemented.');
+    await Promise.resolve();
+};
+const createKvRemoteHas = (getJson) => {
+    return async function has(key) {
+        if (!hasCloudflareApiCreds())
+            return (await this.get(key)) !== null;
+        const settings = getSettings();
+        if (!hasProxySigningCreds(settings))
+            return (await getJson(key)) !== null;
+        return (await this.get(key)) !== null;
+    };
+};
 const createKvRemoteDriver = () => {
     const resolveNamespaceId = createCloudflareNamespaceIdResolver();
     const cf = createCloudflareKvApiClient(resolveNamespaceId);
@@ -226,11 +245,7 @@ const createKvRemoteDriver = () => {
             catch (error) {
                 if (!hasCloudflareApiCreds())
                     throw error;
-                Logger.warn('KV remote proxy GET failed; falling back to Cloudflare KV API', {
-                    ...Logger.withTraceSkipContext({
-                        error: error instanceof Error ? error.message : String(error),
-                    }),
-                });
+                logKvRemoteProxyFallback('GET', error);
                 return cf.getJson(key);
             }
         },
@@ -252,11 +267,7 @@ const createKvRemoteDriver = () => {
             catch (error) {
                 if (!hasCloudflareApiCreds())
                     throw error;
-                Logger.warn('KV remote proxy PUT failed; falling back to Cloudflare KV API', {
-                    ...Logger.withTraceSkipContext({
-                        error: error instanceof Error ? error.message : String(error),
-                    }),
-                });
+                logKvRemoteProxyFallback('PUT', error);
                 await cf.putJson(key, value, ttl);
             }
         },
@@ -276,26 +287,12 @@ const createKvRemoteDriver = () => {
             catch (error) {
                 if (!hasCloudflareApiCreds())
                     throw error;
-                Logger.warn('KV remote proxy DELETE failed; falling back to Cloudflare KV API', {
-                    ...Logger.withTraceSkipContext({
-                        error: error instanceof Error ? error.message : String(error),
-                    }),
-                });
+                logKvRemoteProxyFallback('DELETE', error);
                 await cf.deleteKey(key);
             }
         },
-        async clear() {
-            Logger.warn('KV remote clear() is not implemented.');
-            await Promise.resolve();
-        },
-        async has(key) {
-            if (!hasCloudflareApiCreds())
-                return (await this.get(key)) !== null;
-            const settings = getSettings();
-            if (!hasProxySigningCreds(settings))
-                return (await cf.getJson(key)) !== null;
-            return (await this.get(key)) !== null;
-        },
+        clear: clearKvRemoteDriver,
+        has: createKvRemoteHas(cf.getJson),
     };
 };
 export const KVRemoteDriver = Object.freeze({

package/src/cli/commands/schedule/ScheduleCliSupport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScheduleCliSupport.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/schedule/ScheduleCliSupport.ts"],"names":[],"mappings":"AAsMA,eAAO,MAAM,kBAAkB;sCA1Ec,OAAO,CAAC,OAAO,CAAC;mBA4EtC,OAAO,CAAC,IAAI,CAAC;gCA3BG,OAAO,CAAC,IAAI,CAAC;EAqClD,CAAC;AAEH,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"ScheduleCliSupport.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/schedule/ScheduleCliSupport.ts"],"names":[],"mappings":"AAyNA,eAAO,MAAM,kBAAkB;sCAzEc,OAAO,CAAC,OAAO,CAAC;mBA2EtC,OAAO,CAAC,IAAI,CAAC;gCA3BG,OAAO,CAAC,IAAI,CAAC;EAqClD,CAAC;AAEH,eAAe,kBAAkB,CAAC"}

package/src/cli/commands/schedule/ScheduleCliSupport.js

@@ -33,16 +33,33 @@ const getProjectSourceCliEntry = (projectRoot) => {
     }
     return undefined;
 };
-const isRunningProjectSourceCli = (projectRoot) => {
+const getCurrentCliScript = () => {
     const script = String(process.argv[1] ?? '').trim();
     if (script.length === 0)
-        return false;
+        return undefined;
     const resolvedScript = path.resolve(script);
+    return existsSync(resolvedScript) ? resolvedScript : undefined;
+};
+const isRunningProjectSourceCli = (projectRoot) => {
+    const resolvedScript = getCurrentCliScript();
+    if (resolvedScript === undefined)
+        return false;
     const sourceCliEntry = getProjectSourceCliEntry(projectRoot);
     if (sourceCliEntry === undefined)
         return false;
     return resolvedScript === path.resolve(sourceCliEntry);
 };
+const getScheduleReentryScript = (projectRoot) => {
+    const sourceCliEntry = getProjectSourceCliEntry(projectRoot);
+    if (sourceCliEntry !== undefined) {
+        return path.relative(projectRoot, sourceCliEntry);
+    }
+    const currentCliScript = getCurrentCliScript();
+    if (currentCliScript === undefined)
+        return undefined;
+    const relativeCurrentScript = path.relative(projectRoot, currentCliScript);
+    return relativeCurrentScript.startsWith('..') ? currentCliScript : relativeCurrentScript;
+};
 const getExistingProjectSchedulePath = () => {
     for (const loader of getProjectScheduleLoaders()) {
         if (loader.exists())
@@ -108,14 +125,13 @@ const ensureProjectSourceContext = async () => {
     if (isRunningProjectSourceCli(projectRoot)) {
         return false;
     }
-    const sourceCliEntry = getProjectSourceCliEntry(projectRoot);
-    if (sourceCliEntry === undefined) {
-        throw ErrorFactory.createCliError('Source schedules require a project CLI entrypoint at bin/zin.ts or bin/zintrust.ts');
+    const reentryScript = getScheduleReentryScript(projectRoot);
+    if (reentryScript === undefined) {
+        throw ErrorFactory.createCliError('Source schedules require either a project CLI entrypoint at bin/zin.ts or bin/zintrust.ts, or a resolvable current CLI script.');
     }
-    const relativeSourceCliEntry = path.relative(projectRoot, sourceCliEntry);
     const exitCode = await SpawnUtil.spawnAndWait({
         command: 'tsx',
-        args: [relativeSourceCliEntry, ...process.argv.slice(2)],
+        args: [reentryScript, ...process.argv.slice(2)],
         cwd: projectRoot,
         env: {
             ...process.env,

package/src/cli/scaffolding/ProjectScaffolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,cAAc,IAAI,MAAM,CAAC;IACzB,sBAAsB,IAAI,OAAO,CAAC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtD,gBAAgB,IAAI,OAAO,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AA0kBD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAsBrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AA8ID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAsB/F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}
+{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,cAAc,IAAI,MAAM,CAAC;IACzB,sBAAsB,IAAI,OAAO,CAAC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtD,gBAAgB,IAAI,OAAO,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AAumBD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAsBrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AAwJD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAsB/F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}

package/src/cli/scaffolding/ProjectScaffolder.js

@@ -7,6 +7,7 @@ import { EnvData } from '../scaffolding/env.js';
 import { extractMajorMinorVersion, toCompatibleGovernanceVersion, } from '../scaffolding/ScaffoldingVersionUtils.js';
 import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { isNonEmptyString } from '../../helper/index.js';
 import { randomBytes } from '../../node-singletons/crypto.js';
 import fs from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
@@ -24,11 +25,38 @@ const readBundledGovernancePackage = () => {
 const SAFE_PATH = '/usr/local/bin:/usr/bin:/bin';
 const NPM_VIEW_TIMEOUT_MS = 1500;
 const publishedVersionCache = new Map();
-const createSafeNpmEnv = () => ({
-    ...process.env,
-    NODE_ENV: process.env['NODE_ENV'] ?? 'development',
-    PATH: SAFE_PATH,
-});
+const SAFE_NPM_ENV_KEYS = Object.freeze([
+    'HOME',
+    'USERPROFILE',
+    'APPDATA',
+    'LOCALAPPDATA',
+    'npm_config_userconfig',
+    'npm_config_cache',
+    'NPM_CONFIG_CACHE',
+    'npm_config_registry',
+    'NPM_CONFIG_REGISTRY',
+    'HTTP_PROXY',
+    'HTTPS_PROXY',
+    'NO_PROXY',
+    'http_proxy',
+    'https_proxy',
+    'no_proxy',
+    'SSL_CERT_FILE',
+    'NODE_EXTRA_CA_CERTS',
+]);
+const createSafeNpmEnv = () => {
+    const env = {
+        NODE_ENV: process.env['NODE_ENV'] ?? 'development',
+        PATH: SAFE_PATH,
+    };
+    for (const key of SAFE_NPM_ENV_KEYS) {
+        const value = process.env[key];
+        if (isNonEmptyString(value)) {
+            env[key] = value;
+        }
+    }
+    return env;
+};
 const loadPublishedNpmVersion = (packageName) => {
     if (publishedVersionCache.has(packageName)) {
         return publishedVersionCache.get(packageName);
@@ -563,6 +591,14 @@ const createDirectoriesForState = (state) => {
     const template = resolveTemplate(state.templateName);
     return createDirectories(state.projectPath, template?.directories ?? []);
 };
+const canReuseExistingProjectPath = (projectPath) => {
+    try {
+        return fs.statSync(projectPath).isDirectory() && fs.readdirSync(projectPath).length === 0;
+    }
+    catch {
+        return false;
+    }
+};
 const createFilesForState = (state) => {
     const template = resolveTemplate(state.templateName);
     const variables = state.variables;
@@ -622,9 +658,12 @@ const scaffoldWithState = async (state, options
         }
         prepareContext(state, options);
         if (fs.existsSync(state.projectPath)) {
-            if (options.overwrite === true) {
+            if (options.overwrite === true || options.force === true) {
                 fs.rmSync(state.projectPath, { recursive: true, force: true });
             }
+            else if (canReuseExistingProjectPath(state.projectPath)) {
+                Logger.info(`Reusing empty project directory: ${state.projectPath}`);
+            }
             else {
                 return {
                     success: false,

package/src/cli/utils/spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/spawn.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA0CD,eAAO,MAAM,SAAS;wBACM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;EAiF7D,CAAC"}
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/spawn.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAiDD,eAAO,MAAM,SAAS;wBACM,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;EAiF7D,CAAC"}

package/src/cli/utils/spawn.js

@@ -3,6 +3,7 @@ import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { spawn } from '../../node-singletons/child-process.js';
 import { existsSync } from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
+import { fileURLToPath } from '../../node-singletons/url.js';
 const getExitCode = (exitCode, signal) => {
     if (typeof exitCode === 'number')
         return exitCode;
@@ -10,22 +11,28 @@ const getExitCode = (exitCode, signal) => {
         return 0;
     return 1;
 };
+const CURRENT_PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
+const buildBinCandidates = (binDir, command) => process.platform === 'win32'
+    ? [
+        path.join(binDir, `${command}.cmd`),
+        path.join(binDir, `${command}.exe`),
+        path.join(binDir, `${command}.bat`),
+        path.join(binDir, command),
+    ]
+    : [path.join(binDir, command)];
 const resolveLocalBin = (command, cwd) => {
     // If command is already a path, leave it alone.
     if (command.includes('/') || command.includes('\\'))
         return command;
-    const binDir = path.join(cwd, 'node_modules', '.bin');
-    const candidates = process.platform === 'win32'
-        ? [
-            path.join(binDir, `${command}.cmd`),
-            path.join(binDir, `${command}.exe`),
-            path.join(binDir, `${command}.bat`),
-            path.join(binDir, command),
-        ]
-        : [path.join(binDir, command)];
-    for (const candidate of candidates) {
-        if (existsSync(candidate))
-            return candidate;
+    const binDirs = [
+        path.join(cwd, 'node_modules', '.bin'),
+        path.join(CURRENT_PACKAGE_ROOT, 'node_modules', '.bin'),
+    ].filter((value, index, items) => items.indexOf(value) === index);
+    for (const binDir of binDirs) {
+        for (const candidate of buildBinCandidates(binDir, command)) {
+            if (existsSync(candidate))
+                return candidate;
+        }
     }
     return command;
 };
@@ -34,7 +41,6 @@ const buildCommandNotFoundMessage = (command) => {
         return [
             "Error: 'tsx' not found on PATH.",
             'Install it in the project with "npm install -D tsx".',
-            'If you want a machine-wide fallback, install it globally with "npm install -g tsx".',
         ].join(' ');
     }
     return `Error: '${command}' not found on PATH.`;

package/src/config/logger.d.ts

@@ -6,23 +6,21 @@ interface ILogger {
     error(message: string, error?: unknown, category?: string): void;
     fatal(message: string, error?: unknown, category?: string): void;
 }
+interface ILoggerNamespace extends ILogger {
+    cleanLogsOnce(): Promise<string[]>;
+    scope(scope: string): ILogger;
+    addSink(fn: LogSink): () => void;
+    withTraceSkipContext(context?: Record<string, unknown>): Record<string, unknown>;
+    shouldSkipTraceLogContext(context?: Record<string, unknown>): boolean;
+}
 /**
  * External log sink. Receives every log line after the built-in sinks have fired.
  * Return value is ignored; errors are swallowed to protect the caller.
  */
 export type LogSink = (level: LogLevel, message: string, context?: Record<string, unknown>) => void;
+export declare const withTraceSkipContext: (context?: Record<string, unknown>) => Record<string, unknown>;
+export declare const shouldSkipTraceLogContext: (context?: Record<string, unknown>) => boolean;
 export declare const cleanLogsOnce: () => Promise<string[]>;
-export declare const Logger: Readonly<{
-    debug: (message: string, data?: unknown, category?: string) => void;
-    info: (message: string, data?: unknown, category?: string) => void;
-    warn: (message: string, data?: unknown, category?: string) => void;
-    error: (message: string, error?: unknown, category?: string) => void;
-    fatal: (message: string, error?: unknown, category?: string) => void;
-    cleanLogsOnce: () => Promise<string[]>;
-    scope: (scope: string) => ILogger;
-    addSink: (fn: LogSink) => (() => void);
-    withTraceSkipContext: (context?: Record<string, unknown>) => Record<string, unknown>;
-    shouldSkipTraceLogContext: (context?: Record<string, unknown>) => boolean;
-}>;
+export declare const Logger: ILoggerNamespace;
 export default Logger;
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/config/logger.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,UAAU,OAAO;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClE;AAkzBD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AA+CpG,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,MAAM,EAAE,CAYtD,CAAC;AAEF,eAAO,MAAM,MAAM;qBAxNQ,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAuBjD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAuBhD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;qBAuB/C,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;qBA6BjD,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;yBAwGrC,OAAO,CAAC,MAAM,EAAE,CAAC;mBAvEtB,MAAM,KAAG,OAAO;kBA8D7B,OAAO,KAAG,CAAC,MAAM,IAAI,CAAC;qCAlCH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;0CAO5C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO;EA6D5E,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/config/logger.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,UAAU,OAAO;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClE;AAED,UAAU,gBAAiB,SAAQ,OAAO;IACxC,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,IAAI,CAAC;IACjC,oBAAoB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjF,yBAAyB,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CACvE;AAkzBD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAIpG,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CASxB,CAAC;AAEF,eAAO,MAAM,yBAAyB,GAAI,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAE7E,CAAC;AAkCF,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,MAAM,EAAE,CAYtD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAWnB,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/src/config/logger.js

@@ -741,13 +741,16 @@ const createLoggerScope = (scope) => {
     };
 };
 const TRACE_SKIP_LOG_CONTEXT_KEY = '__zintrustSkipTraceLog';
-const withTraceSkipContext = (context) => {
+export const withTraceSkipContext = (context) => {
+    if (context === undefined) {
+        return { [TRACE_SKIP_LOG_CONTEXT_KEY]: true };
+    }
     return {
-        ...(context ?? {}),
+        ...context,
         [TRACE_SKIP_LOG_CONTEXT_KEY]: true,
     };
 };
-const shouldSkipTraceLogContext = (context) => {
+export const shouldSkipTraceLogContext = (context) => {
     return context?.[TRACE_SKIP_LOG_CONTEXT_KEY] === true;
 };
 const loggerSinks = [];

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.7.2
+ * @zintrust/core v0.7.7
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-18T19:22:40.542Z
+ *   Built: 2026-04-19T15:28:44.954Z
  *   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-04-18T19:22:40.508Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-19T15:28:44.919Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/proxy/ProxyServerUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProxyServerUtils.d.ts","sourceRoot":"","sources":["../../../src/proxy/ProxyServerUtils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAI7D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,kBAAkB,EAC7B,QAAQ,MAAM,EACd,WAAW;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KACjE,eAUF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,WAAW,kBAAkB,EAC7B,QAAQ,MAAM,KACb;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CAOtB,CAAC;AAEL,eAAO,MAAM,sBAAsB,GACjC,KAAK,eAAe,EACpB,MAAM,MAAM,EACZ,QAAQ;IAAE,OAAO,EAAE,kBAAkB,CAAA;CAAE,EACvC,aAAa,MAAM,KAClB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAkCtE,CAAC"}
+{"version":3,"file":"ProxyServerUtils.d.ts","sourceRoot":"","sources":["../../../src/proxy/ProxyServerUtils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAI7D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAuCH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,kBAAkB,EAC7B,QAAQ,MAAM,EACd,WAAW;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KACjE,eAUF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,WAAW,kBAAkB,EAC7B,QAAQ,MAAM,KACb;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CAOtB,CAAC;AAEL,eAAO,MAAM,sBAAsB,GACjC,KAAK,eAAe,EACpB,MAAM,MAAM,EACZ,QAAQ;IAAE,OAAO,EAAE,kBAAkB,CAAA;CAAE,EACvC,aAAa,MAAM,KAClB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAoCtE,CAAC"}

package/src/proxy/ProxyServerUtils.js

@@ -1,7 +1,42 @@
 import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
+import { isNonEmptyString } from '../helper/index.js';
 import { resolveProxySigningConfig } from './ProxySigningConfigResolver.js';
 import { extractSigningHeaders, verifyProxySignatureIfNeeded } from './ProxySigningRequest.js';
+const PROXY_DEBUG_ENV_BY_SERVICE = Object.freeze({
+    MySQLProxyServer: 'MYSQL_PROXY_DEBUG',
+    PostgresProxyServer: 'POSTGRES_PROXY_DEBUG',
+    RedisProxyServer: 'REDIS_PROXY_DEBUG',
+    SqlServerProxyServer: 'SQLSERVER_PROXY_DEBUG',
+});
+const parseProxyDebugValue = (raw) => {
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === 'true' || normalized === '1' || normalized === 'yes')
+        return true;
+    if (normalized === 'false' || normalized === '0' || normalized === 'no')
+        return false;
+    return undefined;
+};
+const resolveProxyDebugEnabled = (serviceName) => {
+    const serviceEnvKey = PROXY_DEBUG_ENV_BY_SERVICE[serviceName];
+    const serviceRaw = serviceEnvKey ? Env.get(serviceEnvKey, '') : '';
+    if (isNonEmptyString(serviceRaw)) {
+        const parsed = parseProxyDebugValue(serviceRaw);
+        if (parsed !== undefined)
+            return parsed;
+    }
+    const sharedRaw = Env.get('ZT_PROXY_DEBUG', '');
+    if (isNonEmptyString(sharedRaw)) {
+        const parsed = parseProxyDebugValue(sharedRaw);
+        if (parsed !== undefined)
+            return parsed;
+    }
+    return false;
+};
+const withTraceSkipProxyContext = (context) => ({
+    ...context,
+    __zintrustSkipTraceLog: true,
+});
 export const resolveBaseConfig = (overrides, prefix, defaults) => {
     const host = overrides.host ?? Env.get(`${prefix}_PROXY_HOST`, Env.HOST ?? defaults?.host ?? '127.0.0.1');
     const port = overrides.port ?? Env.getInt(`${prefix}_PROXY_PORT`, Env.PORT ?? defaults?.port ?? 3000);
@@ -18,22 +53,24 @@ export const resolveBaseSigningConfig = (overrides, prefix) => resolveProxySigni
 export const verifyRequestSignature = async (req, body, config, serviceName) => {
     const headers = extractSigningHeaders(req);
     const hasAnySigningHeader = Object.values(headers).some((value) => typeof value === 'string' && value.trim() !== '');
-    Logger.debug(`[${serviceName}] Verifying request signature`, {
-        ...Logger.withTraceSkipContext({
-            path: req.url ?? '',
-            method: req.method ?? 'POST',
-            requireSigning: config.signing.require,
-            hasAnySigningHeader,
-            configuredKeyId: config.signing.keyId,
-            hasConfiguredSecret: config.signing.secret.trim() !== '',
-            bodyBytes: body.length,
-        }),
-    });
+    if (resolveProxyDebugEnabled(serviceName)) {
+        Logger.debug(`[${serviceName}] Verifying request signature`, {
+            ...withTraceSkipProxyContext({
+                path: req.url ?? '',
+                method: req.method ?? 'POST',
+                requireSigning: config.signing.require,
+                hasAnySigningHeader,
+                configuredKeyId: config.signing.keyId,
+                hasConfiguredSecret: config.signing.secret.trim() !== '',
+                bodyBytes: body.length,
+            }),
+        });
+    }
     const verified = await verifyProxySignatureIfNeeded(req, body, config.signing);
     if (!verified.ok) {
         const error = verified.error ?? { status: 401, message: 'Unauthorized' };
         Logger.warn(`[${serviceName}] Signature verification failed`, {
-            ...Logger.withTraceSkipContext({
+            ...withTraceSkipProxyContext({
                 path: req.url ?? '',
                 method: req.method ?? 'POST',
                 status: error.status,