@zintrust/core 1.6.0 → 1.6.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -57,14 +57,14 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@cloudflare/containers": "^0.3.2",
+    "@cloudflare/containers": "^0.3.3",
     "bcryptjs": "^3.0.3",
-    "bullmq": "^5.76.1",
+    "bullmq": "^5.76.4",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
-    "inquirer": "^13.4.1",
+    "inquirer": "^13.4.2",
     "jsonwebtoken": "^9.0.3",
-    "mysql2": "^3.22.1",
+    "mysql2": "^3.22.3",
     "pg": "^8.20.0",
     "tsx": "^4.21.0"
   },

package/src/boot/registry/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAUvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAkQ9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA6BlF,CAAC;AA8UF,KAAK,eAAe,GAAG;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,CAAC;AA4HF,eAAO,MAAM,eAAe,GAC1B,QAAQ,eAAe,KACtB;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAK5D,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAUvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA0Q9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA6BlF,CAAC;AAyVF,KAAK,eAAe,GAAG;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,CAAC;AA4HF,eAAO,MAAM,eAAe,GAC1B,QAAQ,eAAe,KACtB;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAK5D,CAAC"}

package/src/boot/registry/runtime.js

@@ -49,12 +49,19 @@ const loadBundledSystemTraceModule = async () => {
         return undefined;
     }
 };
+const resolveLocalSystemTraceProjectRoot = () => {
+    const configuredProjectRoot = readEnvString('ZINTRUST_PROJECT_ROOT').trim();
+    if (configuredProjectRoot !== '') {
+        return configuredProjectRoot;
+    }
+    return typeof process !== 'undefined' && typeof process.cwd === 'function' ? process.cwd() : '';
+};
 const loadLocalSystemTraceModule = async () => {
     const globalTracePluginState = globalThis;
     if (globalTracePluginState.__zintrust_system_trace_runtime__ !== undefined) {
         return globalTracePluginState.__zintrust_system_trace_runtime__;
     }
-    const projectRoot = typeof process !== 'undefined' && typeof process.cwd === 'function' ? process.cwd() : '';
+    const projectRoot = resolveLocalSystemTraceProjectRoot();
     if (projectRoot !== '') {
         const moduleCandidates = [
             path.join(projectRoot, 'src', 'runtime', 'plugins', 'trace-runtime.ts'),
@@ -411,6 +418,12 @@ const isTraceDashboardAutoMountEnabled = () => {
     const raw = readEnvString('TRACE_AUTO_MOUNT').trim().toLowerCase();
     return raw === '1' || raw === 'true';
 };
+const isTraceProxySenderEnabled = () => {
+    const proxyEnabled = readEnvString('TRACE_PROXY').trim().toLowerCase();
+    if (proxyEnabled !== '1' && proxyEnabled !== 'true')
+        return false;
+    return readEnvString('TRACE_PROXY_URL').trim() !== '';
+};
 const resolveTraceDashboardBasePath = () => {
     const raw = readEnvString('TRACE_BASE_PATH').trim();
     if (raw === '')
@@ -447,6 +460,9 @@ const initializeSystemTrace = async (router) => {
             return;
         }
         if (!isTraceDashboardAutoMountEnabled()) {
+            if (isTraceProxySenderEnabled()) {
+                return;
+            }
             Logger.info('System Trace runtime activated. Set TRACE_AUTO_MOUNT=true or register dashboard routes manually if needed.');
             return;
         }

package/src/cli/cloudflare/CloudflareWranglerDevEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudflareWranglerDevEnv.d.ts","sourceRoot":"","sources":["../../../../src/cli/cloudflare/CloudflareWranglerDevEnv.ts"],"names":[],"mappings":"AAUA,KAAK,kBAAkB,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAyJF,eAAO,MAAM,0BAA0B,GACrC,MAAM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAmB7C,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAU,CAAC,EACjD,MAAM,kBAAkB,EACxB,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CA8BX,CAAC;;uCAvDM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAAC;kCAqBG,CAAC,QAC3C,kBAAkB,MACpB,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CAAC;;AAgCb,wBAGG"}
+{"version":3,"file":"CloudflareWranglerDevEnv.d.ts","sourceRoot":"","sources":["../../../../src/cli/cloudflare/CloudflareWranglerDevEnv.ts"],"names":[],"mappings":"AAUA,KAAK,kBAAkB,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AA+MF,eAAO,MAAM,0BAA0B,GACrC,MAAM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAmB7C,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAU,CAAC,EACjD,MAAM,kBAAkB,EACxB,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CAkCX,CAAC;;uCA3DM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAAC;kCAqBG,CAAC,QAC3C,kBAAkB,MACpB,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CAAC;;AAoCb,wBAGG"}

package/src/cli/cloudflare/CloudflareWranglerDevEnv.js

@@ -70,6 +70,42 @@ const resolveRuntimeEnvMap = (runtimeEnv) => {
         return typeof entry[1] === 'string';
     }));
 };
+const readExistingWranglerDevVars = async (args) => {
+    const fileName = getWranglerDevVarsFileName(args.envName);
+    const targetPath = path.join(args.cwd, fileName);
+    const backupPath = getWranglerDevVarsBackupPath(targetPath);
+    let sourcePath;
+    if (existsSync(targetPath)) {
+        sourcePath = fileName;
+    }
+    else if (existsSync(backupPath)) {
+        sourcePath = path.basename(backupPath);
+    }
+    if (sourcePath === undefined)
+        return {};
+    return EnvFile.read({
+        cwd: args.cwd,
+        path: sourcePath,
+    });
+};
+const isTruthyEnvValue = (value) => {
+    if (!isNonEmptyString(value))
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
+};
+const shouldUseEnvFileDirectly = async (args) => {
+    const runtimeEnv = resolveRuntimeEnvMap(args.runtimeEnv ?? process.env);
+    if (isTruthyEnvValue(runtimeEnv['USE_ENV'])) {
+        return true;
+    }
+    const envPath = isNonEmptyString(args.envPath) ? args.envPath.trim() : '.env';
+    const envFileValues = await EnvFile.read({
+        cwd: args.projectRoot,
+        path: envPath,
+    });
+    return isTruthyEnvValue(envFileValues['USE_ENV']);
+};
 const resolveSelectedKeys = (args) => {
     const zintrustConfigPath = path.join(args.projectRoot, '.zintrust.json');
     if (!existsSync(zintrustConfigPath)) {
@@ -93,6 +129,7 @@ const resolveSelectedKeys = (args) => {
 };
 const collectWranglerDevVarValues = async (args, selectedKeys) => {
     const runtimeEnv = resolveRuntimeEnvMap(args.runtimeEnv ?? process.env);
+    const existingDevVarValues = await readExistingWranglerDevVars(args);
     const envPath = isNonEmptyString(args.envPath) ? args.envPath.trim() : '.env';
     const envFileValues = await EnvFile.read({
         cwd: args.projectRoot,
@@ -100,14 +137,22 @@ const collectWranglerDevVarValues = async (args, selectedKeys) => {
     });
     const allowedKeys = selectedKeys.length === 0
         ? undefined
-        : new Set([...WRANGLER_RUNTIME_ENV_KEYS, ...selectedKeys]);
+        : new Set([
+            ...WRANGLER_RUNTIME_ENV_KEYS,
+            ...selectedKeys,
+            ...Object.keys(existingDevVarValues),
+        ]);
     const candidateKeys = allowedKeys === undefined
-        ? uniq([...Object.keys(runtimeEnv), ...Object.keys(envFileValues)]).filter(isWranglerVarName)
+        ? uniq([
+            ...Object.keys(runtimeEnv),
+            ...Object.keys(envFileValues),
+            ...Object.keys(existingDevVarValues),
+        ]).filter(isWranglerVarName)
         : [...allowedKeys].filter(isWranglerVarName);
     const values = {};
     const missingKeys = [];
     for (const key of candidateKeys) {
-        const value = envFileValues[key] ?? runtimeEnv[key];
+        const value = existingDevVarValues[key] ?? envFileValues[key] ?? runtimeEnv[key];
         if (typeof value !== 'string') {
             if (selectedKeys.includes(key))
                 missingKeys.push(key);
@@ -136,6 +181,9 @@ export const materializeWranglerDevVars = async (args) => {
     };
 };
 export const withWranglerDevVarsSnapshot = async (args, fn) => {
+    if (await shouldUseEnvFileDirectly(args)) {
+        return fn();
+    }
     const targetPath = path.join(args.cwd, getWranglerDevVarsFileName(args.envName));
     const backupPath = getWranglerDevVarsBackupPath(targetPath);
     try {

package/src/cli/commands/StartCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAugCvF,eAAO,MAAM,YAAY;cACb,YAAY;;mCA38BU,MAAM,KAAG,OAAO;4CAaP,MAAM,KAAG,MAAM;4CA4Bf,MAAM,KAAG,OAAO;sCAetB,MAAM,WAAW,MAAM,KAAG,OAAO;oCAmBnC,MAAM,KAAG,OAAO;;EA26BjD,CAAC"}
+{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAygCvF,eAAO,MAAM,YAAY;cACb,YAAY;;mCA78BU,MAAM,KAAG,OAAO;4CAaP,MAAM,KAAG,MAAM;4CA4Bf,MAAM,KAAG,OAAO;sCAetB,MAAM,WAAW,MAAM,KAAG,OAAO;oCAmBnC,MAAM,KAAG,OAAO;;EA66BjD,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -320,10 +320,12 @@ const readPackageJsonFromDir = (dir) => {
     }
 };
 const resolveStartContext = (cwd) => {
-    const projectRoot = findNearestPackageJsonDir(cwd) ?? cwd;
-    const packageDir = findNearestPackageJsonDir(cwd);
+    const configuredProjectRoot = (process.env['ZINTRUST_PROJECT_ROOT'] ?? '').trim();
+    const effectiveCwd = configuredProjectRoot === '' ? cwd : configuredProjectRoot;
+    const projectRoot = findNearestPackageJsonDir(effectiveCwd) ?? effectiveCwd;
+    const packageDir = findNearestPackageJsonDir(effectiveCwd);
     return {
-        cwd,
+        cwd: effectiveCwd,
         projectRoot,
         ...(packageDir === undefined ? {} : { packageJson: readPackageJsonFromDir(packageDir) }),
     };

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/env.ts"],"names":[],"mappings":"AAmiBA,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,QAAQ,MAAM,EACd,oBAAoB,MAAM,EAC1B,SAAS,MAAM,EAAE,EACjB,cAAc,MAAM,KACnB,MAAM,EAWR,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/env.ts"],"names":[],"mappings":"AAqiBA,eAAO,MAAM,OAAO,GAClB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,QAAQ,MAAM,EACd,oBAAoB,MAAM,EAC1B,SAAS,MAAM,EAAE,EACjB,cAAc,MAAM,KACnB,MAAM,EAWR,CAAC"}

package/src/cli/scaffolding/env.js

@@ -26,6 +26,8 @@ const HeaderAndApp = (name, port, baseUrl, appKey) => [
     '',
     '# Cloudflare Workers (TCP sockets) — set true if using TCP adapters on Workers.',
     'ENABLE_CLOUDFLARE_SOCKETS=false',
+    '# When true, Wrangler reads .env directly and ZinTrust will not materialize .dev.vars files.',
+    'USE_ENV=false',
     '',
     '# CLI / tooling',
     'ZINTRUST_RUN_FROM_SOURCE=0',

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v1.6.0
+ * @zintrust/core v1.6.2
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-29T16:55:46.596Z
+ *   Built: 2026-04-30T16:12:18.041Z
  *   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-29T16:55:46.563Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-30T16:12:18.008Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/orm/adapters/SQLiteAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SQLiteAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/SQLiteAdapter.ts"],"names":[],"mappings":"AACA;;;GAGG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AA+N1F,iBAAS,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CA0FrE;AAED,eAAO,MAAM,aAAa;;EAExB,CAAC"}
+{"version":3,"file":"SQLiteAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/SQLiteAdapter.ts"],"names":[],"mappings":"AACA;;;GAGG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAuO1F,iBAAS,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CA0FrE;AAED,eAAO,MAAM,aAAa;;EAExB,CAAC"}

package/src/orm/adapters/SQLiteAdapter.js

@@ -4,6 +4,7 @@
  * Production Implementation
  */
 import { databaseConfig } from '../../config/database.js';
+import { Env } from '../../config/env.js';
 import { FeatureFlags } from '../../config/features.js';
 import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
@@ -60,7 +61,15 @@ async function importSqliteDatabaseConstructor() {
 }
 function normalizeFilename(database) {
     const value = (database ?? '').trim();
-    return value.length > 0 ? value : ':memory:';
+    if (value.length === 0)
+        return ':memory:';
+    if (value === ':memory:' || value.startsWith('/') || /^[A-Za-z]:[\\/]/.test(value)) {
+        return value;
+    }
+    const configuredProjectRoot = Env.ZINTRUST_PROJECT_ROOT.trim();
+    if (configuredProjectRoot !== '')
+        return path.join(configuredProjectRoot, value);
+    return value;
 }
 function isSelectQuery(sql) {
     const normalized = sql.trimStart().toLowerCase();

package/src/templates/project/basic/config/database.ts.tpl

@@ -17,7 +17,7 @@ const parseReadHosts = (raw: string): string[] | undefined => {
 };
 
 export default {
-  default: Env.get('DB_CONNECTION', 'mysql'),
+  default: Env.get('DB_CONNECTION', Env.getBool('CLOUDFLARE_WORKER', false) ? 'd1' : 'sqlite'),
   connections: {
     sqlite: {
       driver: 'sqlite' as const,

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;