@zintrust/core 1.8.0 → 1.8.2

package/bin/z.js

@@ -3,5 +3,18 @@
  * ZinTrust CLI Shortcut - 'z'
  * Mirrors bin/zintrust.ts for convenience
  */
-import { runCliWrapper } from './launcher.js';
+const importCliWrapper = async () => {
+    try {
+        return await import(new URL('./launcher.ts', import.meta.url).href);
+    }
+    catch (error) {
+        if (!(error instanceof Error) ||
+            error.code !== 'ERR_MODULE_NOT_FOUND') {
+            throw error;
+        }
+        return import(new URL('./launcher.js', import.meta.url).href);
+    }
+};
+const { runCliWrapper } = await importCliWrapper();
 await runCliWrapper();
+export {};

package/bin/zin.js

@@ -3,5 +3,18 @@
  * ZinTrust CLI Shortcut - 'zin'
  * Mirrors bin/zintrust.ts for convenience
  */
-import { runCliWrapper } from './launcher.js';
+const importCliWrapper = async () => {
+    try {
+        return await import(new URL('./launcher.ts', import.meta.url).href);
+    }
+    catch (error) {
+        if (!(error instanceof Error) ||
+            error.code !== 'ERR_MODULE_NOT_FOUND') {
+            throw error;
+        }
+        return import(new URL('./launcher.js', import.meta.url).href);
+    }
+};
+const { runCliWrapper } = await importCliWrapper();
 await runCliWrapper({ traceName: 'cli-wrapper' });
+export {};

package/bin/zintrust-main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAiYF,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAMzC;AAED,eAAO,MAAM,mBAAmB;;qCAhWQ,MAAM,KAAG,qBAAqB,GAAG,SAAS;mCA6C5C,MAAM,GAAG,IAAI,UAAU,MAAM,CAAC,OAAO,GAAG,IAAI,KAAG,MAAM;iCAnEzD,MAAM;8BAIP,MAAM,KAAG,MAAM;uCAoGtC,qBAAqB,WACpB,MAAM,EAAE,KAChB,OAAO,CAAC,KAAK,CAAC;oCA9FsB,MAAM,sBAAsB,MAAM,KAAG,OAAO;6CAkI7B,MAAM,EAAE,KAAG,OAAO,CAAC,OAAO,CAAC;yCA7F1E,MAAM,sBACS,MAAM,QACrB,MAAM,CAAC,UAAU,KACrB,qBAAqB,GAAG,SAAS;EA4UlC,CAAC;AAaH,OAAO,EAAE,CAAC"}
+{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAmaF,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAMzC;AAED,eAAO,MAAM,mBAAmB;;qCAlYQ,MAAM,KAAG,qBAAqB,GAAG,SAAS;mCA6C5C,MAAM,GAAG,IAAI,UAAU,MAAM,CAAC,OAAO,GAAG,IAAI,KAAG,MAAM;iCAnEzD,MAAM;8BAIP,MAAM,KAAG,MAAM;uCAoGtC,qBAAqB,WACpB,MAAM,EAAE,KAChB,OAAO,CAAC,KAAK,CAAC;oCA9FsB,MAAM,sBAAsB,MAAM,KAAG,OAAO;6CAkI7B,MAAM,EAAE,KAAG,OAAO,CAAC,OAAO,CAAC;yCA7F1E,MAAM,sBACS,MAAM,QACrB,MAAM,CAAC,UAAU,KACrB,qBAAqB,GAAG,SAAS;EA8WlC,CAAC;AAaH,OAAO,EAAE,CAAC"}

package/bin/zintrust-main.js

@@ -253,7 +253,33 @@ const handleCliFatal = async (error, context) => {
     }
     process.exit(1);
 };
+const maybeRunVersionCheckChild = async () => {
+    if (process.env['ZINTRUST_VERSION_CHECK_CHILD'] !== 'true') {
+        return false;
+    }
+    const { VersionChecker } = await import('../src/cli/services/VersionChecker.js');
+    await VersionChecker.runVersionCheckInline();
+    return true;
+};
+const loadOptionalCliExtensionsForArgs = async (args) => {
+    let optionalCliExtensions;
+    let optionalCliStatuses = [];
+    try {
+        ({ OptionalCliExtensions: optionalCliExtensions } = await import('../src/cli/OptionalCliExtensions.js'));
+        optionalCliStatuses = await optionalCliExtensions.loadForArgs(args);
+    }
+    catch {
+        // best-effort; missing optional extensions must not block the CLI
+    }
+    return {
+        optionalCliExtensions,
+        optionalCliStatuses,
+    };
+};
 const runCliInternal = async () => {
+    if (await maybeRunVersionCheckChild()) {
+        return;
+    }
     const { rawArgs: rawArgs0, args: args0 } = getArgsFromProcess();
     if (await maybeHandoffToProjectLocalCli(rawArgs0)) {
         return;
@@ -266,15 +292,7 @@ const runCliInternal = async () => {
     const { EnvFileLoader } = await import('../src/cli/utils/EnvFileLoader.js');
     EnvFileLoader.ensureLoaded();
     // Auto-load install-only CLI extension packages that self-register commands.
-    let optionalCliExtensions;
-    let optionalCliStatuses = [];
-    try {
-        ({ OptionalCliExtensions: optionalCliExtensions } = await import('../src/cli/OptionalCliExtensions.js'));
-        optionalCliStatuses = await optionalCliExtensions.loadForArgs(args0);
-    }
-    catch {
-        // best-effort; missing optional extensions must not block the CLI
-    }
+    const { optionalCliExtensions, optionalCliStatuses } = await loadOptionalCliExtensionsForArgs(args0);
     const missingOptionalExtension = optionalCliExtensions?.findMissingExtensionForArgs(args0, optionalCliStatuses);
     if (missingOptionalExtension !== undefined) {
         const { ErrorFactory } = await import('../src/exceptions/ZintrustError.js');

package/bin/zintrust.js

@@ -6,5 +6,18 @@
  * bin/zintrust-main.ts. Keeping the implementation hashbang-free allows other
  * shortcuts (zin/z/zt) to reuse the same launcher behavior.
  */
-import { runCliWrapper } from './launcher.js';
+const importCliWrapper = async () => {
+    try {
+        return await import(new URL('./launcher.ts', import.meta.url).href);
+    }
+    catch (error) {
+        if (!(error instanceof Error) ||
+            error.code !== 'ERR_MODULE_NOT_FOUND') {
+            throw error;
+        }
+        return import(new URL('./launcher.js', import.meta.url).href);
+    }
+};
+const { runCliWrapper } = await importCliWrapper();
 await runCliWrapper();
+export {};

package/bin/zt.js

@@ -3,5 +3,18 @@
  * ZinTrust CLI Shortcut - 'zt'
  * Mirrors bin/zintrust.ts for convenience
  */
-import { runCliWrapper } from './launcher.js';
+const importCliWrapper = async () => {
+    try {
+        return await import(new URL('./launcher.ts', import.meta.url).href);
+    }
+    catch (error) {
+        if (!(error instanceof Error) ||
+            error.code !== 'ERR_MODULE_NOT_FOUND') {
+            throw error;
+        }
+        return import(new URL('./launcher.js', import.meta.url).href);
+    }
+};
+const { runCliWrapper } = await importCliWrapper();
 await runCliWrapper();
+export {};

package/package.json

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

package/src/cli/services/VersionChecker.d.ts

@@ -17,6 +17,9 @@ interface VersionCheckConfig {
     skipVersionCheck: boolean;
 }
 export declare const VersionChecker: Readonly<{
+    isDetachedChildProcess(): boolean;
+    shouldSkipVersionCheckForArgs(args: Set<string>): boolean;
+    hasFreshVersionCheck(checkInterval: number): boolean;
     /**
      * Resolve the nearest package.json from a starting directory.
      */
@@ -81,6 +84,8 @@ export declare const VersionChecker: Readonly<{
      * Display update notification to user
      */
     displayUpdateNotification(result: VersionCheckResult): void;
+    spawnDetachedVersionCheck(): void;
+    runVersionCheckInline(): Promise<void>;
     /**
      * Run version check and display notification if needed
      */

package/src/cli/services/VersionChecker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VersionChecker.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/VersionChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKlE,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc;IACzB;;OAEG;qCAC8B,MAAM,GAAG,MAAM,GAAG,IAAI;IAcvD;;OAEG;yBACkB,MAAM;IAkB3B;;OAEG;iBACU,kBAAkB;IAQ/B;;OAEG;0BACmB,OAAO;IAyC7B;;OAEG;oCAC6B,MAAM,GAAG,MAAM,GAAG,IAAI;IAwBtD;;OAEG;gCACyB,MAAM,GAAG,IAAI;IAezC;;OAEG;0BACyB,OAAO,CAAC,MAAM,CAAC;IA6B3C;;OAEG;4BAC2B,OAAO,CAAC,aAAa,CAAC;IAQpD;;OAEG;uBACgB,MAAM;IAIzB;;OAEG;qCAC8B,OAAO,GAAG,MAAM;IAuBjD;;OAEG;8BACuB,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInE;;OAEG;uCACgC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAY1E;;OAEG;oCAC6B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAQvE;;OAEG;6BACsB,MAAM,UAAU,MAAM,GAAG,MAAM;IAuBxD;;OAEG;oBACmB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAyBxD;;OAEG;sCAC+B,kBAAkB,GAAG,IAAI;IA4B3D;;OAEG;uBACsB,OAAO,CAAC,IAAI,CAAC;EAUtC,CAAC"}
+{"version":3,"file":"VersionChecker.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/VersionChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMlE,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAID,eAAO,MAAM,cAAc;8BACC,OAAO;wCAIG,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO;wCAYrB,MAAM,GAAG,OAAO;IAapD;;OAEG;qCAC8B,MAAM,GAAG,MAAM,GAAG,IAAI;IAcvD;;OAEG;yBACkB,MAAM;IAkB3B;;OAEG;iBACU,kBAAkB;IAQ/B;;OAEG;0BACmB,OAAO;IA0B7B;;OAEG;oCAC6B,MAAM,GAAG,MAAM,GAAG,IAAI;IAwBtD;;OAEG;gCACyB,MAAM,GAAG,IAAI;IAezC;;OAEG;0BACyB,OAAO,CAAC,MAAM,CAAC;IA6B3C;;OAEG;4BAC2B,OAAO,CAAC,aAAa,CAAC;IAQpD;;OAEG;uBACgB,MAAM;IAIzB;;OAEG;qCAC8B,OAAO,GAAG,MAAM;IAuBjD;;OAEG;8BACuB,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInE;;OAEG;uCACgC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAY1E;;OAEG;oCAC6B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAQvE;;OAEG;6BACsB,MAAM,UAAU,MAAM,GAAG,MAAM;IAuBxD;;OAEG;oBACmB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAyBxD;;OAEG;sCAC+B,kBAAkB,GAAG,IAAI;iCA4B9B,IAAI;6BAkCF,OAAO,CAAC,IAAI,CAAC;IAW5C;;OAEG;uBACsB,OAAO,CAAC,IAAI,CAAC;EAQtC,CAAC"}

package/src/cli/services/VersionChecker.js

@@ -4,11 +4,35 @@
  * Checks if the current CLI version is outdated and warns users
  * when a newer version is available from npm registry.
  */
+import { Logger } from '../../config/logger.js';
 import { HttpClient } from '../../tools/http/Http.js';
+import { spawn } from '../../node-singletons/child-process.js';
 import { existsSync, readFileSync } from '../../node-singletons/fs.js';
 import { dirname, join } from '../../node-singletons/path.js';
 import { fileURLToPath } from '../../node-singletons/url.js';
+const VERSION_CHECK_CHILD_ENV = 'ZINTRUST_VERSION_CHECK_CHILD';
 export const VersionChecker = Object.freeze({
+    isDetachedChildProcess() {
+        return process.env[VERSION_CHECK_CHILD_ENV] === 'true';
+    },
+    shouldSkipVersionCheckForArgs(args) {
+        return (args.has('-v') ||
+            args.has('--version') ||
+            args.has('help') ||
+            args.has('new') ||
+            args.has('migrate') ||
+            args.has('schedule:run') ||
+            args.has('schedule:list'));
+    },
+    hasFreshVersionCheck(checkInterval) {
+        const lastCheck = globalThis.localStorage?.getItem?.('zintrust_last_version_check');
+        if (lastCheck === null || lastCheck === undefined) {
+            return false;
+        }
+        const lastCheckTime = Number.parseInt(lastCheck, 10);
+        const hoursSinceLastCheck = (Date.now() - lastCheckTime) / (1000 * 60 * 60);
+        return hoursSinceLastCheck < checkInterval;
+    },
     /**
      * Resolve the nearest package.json from a starting directory.
      */
@@ -57,6 +81,9 @@ export const VersionChecker = Object.freeze({
      * Check if version check should be performed
      */
     shouldCheckVersion() {
+        if (this.isDetachedChildProcess()) {
+            return true;
+        }
         const config = this.getConfig();
         // Skip if disabled
         if (!config.enabled || config.skipVersionCheck) {
@@ -64,27 +91,12 @@ export const VersionChecker = Object.freeze({
         }
         // Skip for version commands
         const args = new Set(process.argv.slice(2));
-        if (args.has('-v') ||
-            args.has('--version') ||
-            args.has('help') ||
-            args.has('new') ||
-            args.has('migrate') ||
-            // One-shot schedule commands should exit cleanly and not keep the event loop alive
-            // due to background network requests/keep-alive sockets.
-            args.has('schedule:run') ||
-            args.has('schedule:list')) {
+        if (this.shouldSkipVersionCheckForArgs(args)) {
             return false;
         }
         // Check last check time
-        const lastCheckKey = 'zintrust_last_version_check';
-        const lastCheck = globalThis.localStorage?.getItem?.(lastCheckKey);
-        if (lastCheck !== null && lastCheck !== undefined) {
-            const lastCheckTime = Number.parseInt(lastCheck, 10);
-            const now = Date.now();
-            const hoursSinceLastCheck = (now - lastCheckTime) / (1000 * 60 * 60);
-            if (hoursSinceLastCheck < config.checkInterval) {
-                return false;
-            }
+        if (this.hasFreshVersionCheck(config.checkInterval)) {
+            return false;
         }
         return true;
     },
@@ -298,10 +310,33 @@ export const VersionChecker = Object.freeze({
         ].join('\n');
         process.stdout.write(output);
     },
-    /**
-     * Run version check and display notification if needed
-     */
-    async runVersionCheck() {
+    spawnDetachedVersionCheck() {
+        if (!this.shouldCheckVersion()) {
+            return;
+        }
+        const entrypoint = process.argv[1];
+        if (typeof entrypoint !== 'string' || entrypoint.trim() === '') {
+            return;
+        }
+        try {
+            const child = spawn(process.execPath, [...process.execArgv, entrypoint, ...process.argv.slice(2)], {
+                detached: true,
+                env: {
+                    ...process.env,
+                    [VERSION_CHECK_CHILD_ENV]: 'true',
+                },
+                stdio: 'ignore',
+            });
+            child.once('error', (error) => {
+                Logger.debug('Detached version check failed to start', error);
+            });
+            child.unref();
+        }
+        catch (error) {
+            Logger.debug('Detached version check spawn failed', error);
+        }
+    },
+    async runVersionCheckInline() {
         try {
             const result = await this.checkVersion();
             if (result) {
@@ -312,4 +347,14 @@ export const VersionChecker = Object.freeze({
             // Version check should never crash the CLI
         }
     },
+    /**
+     * Run version check and display notification if needed
+     */
+    async runVersionCheck() {
+        if (this.isDetachedChildProcess()) {
+            await this.runVersionCheckInline();
+            return;
+        }
+        this.spawnDetachedVersionCheck();
+    },
 });

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v1.8.0
+ * @zintrust/core v1.8.2
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-05-04T17:50:45.702Z
+ *   Built: 2026-05-06T12:08:48.296Z
  *   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-05-04T17:50:45.666Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-05-06T12:08:48.262Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/zintrust.plugins.d.ts

@@ -1,7 +1,10 @@
 /**
- * Auto-generated fallback module.
- * This file is created by scripts/ensure-worker-plugins.mjs when missing.
- * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
+ * ZinTrust plugin auto-imports
+ *
+ * In real projects, this file is managed by `zin plugin install` and contains
+ * side-effect imports (e.g. `@zintrust/db-sqlite/register`) that register
+ * optional adapters/drivers into core registries.
+ *
  */
 export type {};
 export declare const __zintrustGeneratedPluginStub = "zintrust.plugins.ts";

package/src/zintrust.plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,YAAY,EAAE,CAAC;AAgBf,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}
+{"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,YAAY,EAAE,CAAC;AAgBf,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}

package/src/zintrust.plugins.js

@@ -1,7 +1,10 @@
 /**
- * Auto-generated fallback module.
- * This file is created by scripts/ensure-worker-plugins.mjs when missing.
- * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
+ * ZinTrust plugin auto-imports
+ *
+ * In real projects, this file is managed by `zin plugin install` and contains
+ * side-effect imports (e.g. `@zintrust/db-sqlite/register`) that register
+ * optional adapters/drivers into core registries.
+ *
  */
 import * as TraceRuntime from './runtime/plugins/trace-runtime.js';
 globalThis.__zintrust_system_trace_plugin_requested__ = true;