@zintrust/core 0.4.28 → 0.4.30

package/package.json

@@ -1,51 +1,54 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.28",
-  "type": "module",
-  "main": "./index.js",
-  "types": "./index.d.ts",
-  "bin": {
-    "zintrust": "./bin/zintrust.js",
-    "zin": "./bin/zin.js",
-    "z": "./bin/z.js",
-    "zt": "./bin/zt.js"
+  "version": "0.4.30",
+  "description": "Production-grade TypeScript backend framework for JavaScript",
+  "homepage": "https://zintrust.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ZinTrust/ZinTrust.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ZinTrust/ZinTrust/issues"
   },
+  "type": "module",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
   "exports": {
     ".": {
-      "types": "./index.d.ts",
-      "default": "./index.js"
+      "types": "./src/index.d.ts",
+      "import": "./src/index.js"
     },
     "./start": {
-      "types": "./start.d.ts",
-      "default": "./start.js"
+      "types": "./src/start.d.ts",
+      "import": "./src/start.js"
     },
     "./cli": {
       "types": "./src/cli.d.ts",
-      "default": "./src/cli.js"
+      "import": "./src/cli.js"
+    },
+    "./worker-commands": {
+      "types": "./src/worker-commands.d.ts",
+      "import": "./src/worker-commands.js"
     },
     "./proxy": {
       "types": "./src/proxy.d.ts",
-      "default": "./src/proxy.js"
+      "import": "./src/proxy.js"
     },
     "./proxy/*": {
       "types": "./src/proxy/*.d.ts",
-      "default": "./src/proxy/*.js"
+      "import": "./src/proxy/*.js"
     },
     "./collections": {
       "types": "./src/collections/index.d.ts",
-      "default": "./src/collections/index.js"
+      "import": "./src/collections/index.js"
     },
     "./helper": {
       "types": "./src/helper/index.d.ts",
-      "default": "./src/helper/index.js"
+      "import": "./src/helper/index.js"
     },
     "./node": {
       "types": "./src/node.d.ts",
-      "default": "./src/node.js"
-    },
-    "./routes/*": {
-      "types": "./routes/*.d.ts",
-      "default": "./routes/*.js"
+      "import": "./src/node.js"
     },
     "./package.json": "./package.json"
   },
@@ -61,6 +64,58 @@
     "mysql2": "^3.20.0",
     "pg": "^8.20.0"
   },
+  "overrides": {
+    "ajv": "^8.18.0",
+    "axios": "^1.13.5",
+    "node-forge": "^1.4.0",
+    "brace-expansion": "^5.0.5",
+    "picomatch": "^4.0.4",
+    "cross-spawn": "^7.0.5",
+    "glob": "^11.1.0",
+    "minimatch": "^10.2.2",
+    "rollup": "^4.59.0",
+    "flatted": "^3.4.2",
+    "@actions/github": {
+      "undici": "^6.24.0"
+    },
+    "@actions/http-client": {
+      "undici": "^6.24.0"
+    },
+    "miniflare": {
+      "undici": "^7.24.4"
+    }
+  },
+  "bin": {
+    "zintrust": "bin/zintrust.js",
+    "zin": "bin/zin.js",
+    "z": "bin/z.js",
+    "zt": "bin/zt.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "public"
+  ],
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=9.0.0"
+  },
+  "keywords": [
+    "framework",
+    "typescript",
+    "backend",
+    "orm",
+    "query-builder",
+    "rest-api",
+    "react",
+    "react-api",
+    "vue",
+    "vue-api",
+    "symfony",
+    "laravel"
+  ],
+  "author": "ZinTrust Team",
+  "license": "MIT",
   "publishConfig": {
     "access": "public"
   }

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

@@ -1 +1 @@
-{"version":3,"file":"D1ProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1ProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6LrE,eAAO,MAAM,cAAc;cACf,YAAY;EAmCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"D1ProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1ProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6PrE,eAAO,MAAM,cAAc;cACf,YAAY;EAwCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cli/commands/D1ProxyCommand.js

@@ -5,7 +5,7 @@ import { Env } from '../../config/env.js';
 import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { isNonEmptyString } from '../../helper/index.js';
-import { existsSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
 import { join } from '../../node-singletons/path.js';
 const DEFAULT_CONFIG = 'wrangler.jsonc';
 const DEFAULT_COMPATIBILITY_DATE = '2026-03-12';
@@ -13,6 +13,8 @@ const DEFAULT_BINDING = 'ZIN_DB';
 const DEFAULT_DATABASE_NAME = 'd1-proxy-db';
 const DEFAULT_DATABASE_ID = '<your-d1-database-id>';
 const DEFAULT_MIGRATIONS_DIR = 'database/migrations/d1';
+const DEFAULT_ENTRY_FILE = 'src/proxy/d1/ZintrustD1Proxy.ts';
+const CORE_PROXY_MODULE = ['@zintrust', 'core', 'proxy'].join('/');
 const trimOption = (value) => {
     if (!isNonEmptyString(value))
         return undefined;
@@ -23,10 +25,47 @@ const resolveConfigPath = (raw) => {
     const trimmed = trimOption(raw);
     return trimmed ?? DEFAULT_CONFIG;
 };
+const isJsonWhitespace = (char) => {
+    return char === ' ' || char === '\n' || char === '\r' || char === '\t';
+};
+const findJsonKeyValueStart = (content, key) => {
+    const keyPosition = content.indexOf(`"${key}"`);
+    if (keyPosition < 0)
+        return -1;
+    let cursor = keyPosition + key.length + 2;
+    while (isJsonWhitespace(content[cursor]))
+        cursor++;
+    if (content[cursor] !== ':')
+        return -1;
+    cursor++;
+    while (isJsonWhitespace(content[cursor]))
+        cursor++;
+    return cursor;
+};
 const findQuotedValue = (content, key) => {
-    const pattern = new RegExp(String.raw `"${key}"\s*:\s*"([^"]+)"`);
-    const match = pattern.exec(content);
-    return trimOption(match?.[1]);
+    const valueStart = findJsonKeyValueStart(content, key);
+    if (valueStart < 0 || content[valueStart] !== '"')
+        return undefined;
+    const valueEnd = content.indexOf('"', valueStart + 1);
+    if (valueEnd < 0)
+        return undefined;
+    return trimOption(content.slice(valueStart + 1, valueEnd));
+};
+const hasEnvBlock = (content, envName) => {
+    const valueStart = findJsonKeyValueStart(content, envName);
+    return valueStart >= 0 && content[valueStart] === '{';
+};
+const findEnvObjectStart = (content) => {
+    const valueStart = findJsonKeyValueStart(content, 'env');
+    if (valueStart < 0 || content[valueStart] !== '{')
+        return -1;
+    return valueStart;
+};
+const isObjectEffectivelyEmpty = (content, objectStart) => {
+    let cursor = objectStart + 1;
+    while (isJsonWhitespace(content[cursor]))
+        cursor++;
+    return content[cursor] === '}';
 };
 const resolveConfigValues = (content, options) => {
     const fileContent = content ?? '';
@@ -90,14 +129,31 @@ const renderDefaultWranglerConfig = (values) => {
         '',
     ].join('\n');
 };
+const ensureProxyEntrypoint = (cwd) => {
+    const entryFilePath = join(cwd, DEFAULT_ENTRY_FILE);
+    if (existsSync(entryFilePath)) {
+        return { created: false, entryFilePath };
+    }
+    mkdirSync(join(cwd, 'src/proxy/d1'), { recursive: true });
+    writeFileSync(entryFilePath, [
+        `export { ZintrustD1Proxy } from '${CORE_PROXY_MODULE}';`,
+        `export { ZintrustD1Proxy as default } from '${CORE_PROXY_MODULE}';`,
+        '',
+    ].join('\n'), 'utf-8');
+    return { created: true, entryFilePath };
+};
 const injectEnvBlock = (content, block) => {
-    if (/"d1-proxy"\s*:\s*\{/.test(content))
+    if (hasEnvBlock(content, 'd1-proxy'))
         return content;
-    if (/"env"\s*:\s*\{\s*\}/m.test(content)) {
-        return content.replace(/"env"\s*:\s*\{\s*\}/m, `"env": {\n${block}\n  }`);
+    const envObjectStart = findEnvObjectStart(content);
+    if (envObjectStart >= 0 && isObjectEffectivelyEmpty(content, envObjectStart)) {
+        const closingBraceIndex = content.indexOf('}', envObjectStart);
+        if (closingBraceIndex >= 0) {
+            return `${content.slice(0, envObjectStart)}{\n${block}\n  }${content.slice(closingBraceIndex + 1)}`;
+        }
     }
-    if (/"env"\s*:\s*\{/m.test(content)) {
-        return content.replace(/"env"\s*:\s*\{/m, (match) => `${match}\n${block},`);
+    if (envObjectStart >= 0) {
+        return `${content.slice(0, envObjectStart + 1)}\n${block},${content.slice(envObjectStart + 1)}`;
     }
     const closingIndex = content.lastIndexOf('}');
     if (closingIndex < 0) {
@@ -145,8 +201,12 @@ export const D1ProxyCommand = Object.freeze({
             execute: async (options) => {
                 await maybeRunProxyWatchMode(options.watch);
                 const cwd = process.cwd();
+                const entrypoint = ensureProxyEntrypoint(cwd);
                 const configPath = join(cwd, resolveConfigPath(options.config));
                 const result = ensureWranglerConfig(configPath, options);
+                if (entrypoint.created) {
+                    Logger.info(`Created ${entrypoint.entryFilePath} from @zintrust/core proxy entrypoint.`);
+                }
                 if (result.createdFile) {
                     Logger.info(`Created ${configPath} with a default d1-proxy environment.`);
                 }

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

@@ -1 +1 @@
-{"version":3,"file":"KvProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/KvProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA0KrE,eAAO,MAAM,cAAc;cACf,YAAY;EAmCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"KvProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/KvProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA0OrE,eAAO,MAAM,cAAc;cACf,YAAY;EAwCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cli/commands/KvProxyCommand.js

@@ -5,12 +5,14 @@ import { Env } from '../../config/env.js';
 import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { isNonEmptyString } from '../../helper/index.js';
-import { existsSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
 import { join } from '../../node-singletons/path.js';
 const DEFAULT_CONFIG = 'wrangler.jsonc';
 const DEFAULT_COMPATIBILITY_DATE = '2026-03-12';
 const DEFAULT_BINDING = 'ZIN_KV';
 const DEFAULT_NAMESPACE_ID = '<your-kv-namespace-id>';
+const DEFAULT_ENTRY_FILE = 'src/proxy/kv/ZintrustKvProxy.ts';
+const CORE_PROXY_MODULE = ['@zintrust', 'core', 'proxy'].join('/');
 const trimOption = (value) => {
     if (!isNonEmptyString(value))
         return undefined;
@@ -18,10 +20,47 @@ const trimOption = (value) => {
     return trimmed.length > 0 ? trimmed : undefined;
 };
 const resolveConfigPath = (raw) => trimOption(raw) ?? DEFAULT_CONFIG;
+const isJsonWhitespace = (char) => {
+    return char === ' ' || char === '\n' || char === '\r' || char === '\t';
+};
+const findJsonKeyValueStart = (content, key) => {
+    const keyPosition = content.indexOf(`"${key}"`);
+    if (keyPosition < 0)
+        return -1;
+    let cursor = keyPosition + key.length + 2;
+    while (isJsonWhitespace(content[cursor]))
+        cursor++;
+    if (content[cursor] !== ':')
+        return -1;
+    cursor++;
+    while (isJsonWhitespace(content[cursor]))
+        cursor++;
+    return cursor;
+};
 const findQuotedValue = (content, key) => {
-    const pattern = new RegExp(String.raw `"${key}"\s*:\s*"([^"]+)"`);
-    const match = pattern.exec(content);
-    return trimOption(match?.[1]);
+    const valueStart = findJsonKeyValueStart(content, key);
+    if (valueStart < 0 || content[valueStart] !== '"')
+        return undefined;
+    const valueEnd = content.indexOf('"', valueStart + 1);
+    if (valueEnd < 0)
+        return undefined;
+    return trimOption(content.slice(valueStart + 1, valueEnd));
+};
+const hasEnvBlock = (content, envName) => {
+    const valueStart = findJsonKeyValueStart(content, envName);
+    return valueStart >= 0 && content[valueStart] === '{';
+};
+const findEnvObjectStart = (content) => {
+    const valueStart = findJsonKeyValueStart(content, 'env');
+    if (valueStart < 0 || content[valueStart] !== '{')
+        return -1;
+    return valueStart;
+};
+const isObjectEffectivelyEmpty = (content, objectStart) => {
+    let cursor = objectStart + 1;
+    while (isJsonWhitespace(content[cursor]))
+        cursor++;
+    return content[cursor] === '}';
 };
 const resolveConfigValues = (content, options) => {
     const fileContent = content ?? '';
@@ -79,14 +118,31 @@ const renderDefaultWranglerConfig = (values) => {
         '',
     ].join('\n');
 };
+const ensureProxyEntrypoint = (cwd) => {
+    const entryFilePath = join(cwd, DEFAULT_ENTRY_FILE);
+    if (existsSync(entryFilePath)) {
+        return { created: false, entryFilePath };
+    }
+    mkdirSync(join(cwd, 'src/proxy/kv'), { recursive: true });
+    writeFileSync(entryFilePath, [
+        `export { ZintrustKvProxy } from '${CORE_PROXY_MODULE}';`,
+        `export { ZintrustKvProxy as default } from '${CORE_PROXY_MODULE}';`,
+        '',
+    ].join('\n'), 'utf-8');
+    return { created: true, entryFilePath };
+};
 const injectEnvBlock = (content, block) => {
-    if (/"kv-proxy"\s*:\s*\{/.test(content))
+    if (hasEnvBlock(content, 'kv-proxy'))
         return content;
-    if (/"env"\s*:\s*\{\s*\}/m.test(content)) {
-        return content.replace(/"env"\s*:\s*\{\s*\}/m, `"env": {\n${block}\n  }`);
+    const envObjectStart = findEnvObjectStart(content);
+    if (envObjectStart >= 0 && isObjectEffectivelyEmpty(content, envObjectStart)) {
+        const closingBraceIndex = content.indexOf('}', envObjectStart);
+        if (closingBraceIndex >= 0) {
+            return `${content.slice(0, envObjectStart)}{\n${block}\n  }${content.slice(closingBraceIndex + 1)}`;
+        }
     }
-    if (/"env"\s*:\s*\{/m.test(content)) {
-        return content.replace(/"env"\s*:\s*\{/m, (match) => `${match}\n${block},`);
+    if (envObjectStart >= 0) {
+        return `${content.slice(0, envObjectStart + 1)}\n${block},${content.slice(envObjectStart + 1)}`;
     }
     const closingIndex = content.lastIndexOf('}');
     if (closingIndex < 0) {
@@ -133,8 +189,12 @@ export const KvProxyCommand = Object.freeze({
             execute: async (options) => {
                 await maybeRunProxyWatchMode(options.watch);
                 const cwd = process.cwd();
+                const entrypoint = ensureProxyEntrypoint(cwd);
                 const configPath = join(cwd, resolveConfigPath(options.config));
                 const result = ensureWranglerConfig(configPath, options);
+                if (entrypoint.created) {
+                    Logger.info(`Created ${entrypoint.entryFilePath} from @zintrust/core proxy entrypoint.`);
+                }
                 if (result.createdFile) {
                     Logger.info(`Created ${configPath} with a default kv-proxy environment.`);
                 }

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

@@ -1 +1 @@
-{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgBrE,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,IAAI,GAAG,WAAW,CAAC;AAYvF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0PhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AA8RD;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}
+{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAerE,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,IAAI,GAAG,WAAW,CAAC;AAYvF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA0PhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAoQD;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}

package/src/cli/commands/NewCommand.js

@@ -8,7 +8,6 @@ import { extractErrorMessage, resolvePackageManager } from '../../common/index.j
 import { appConfig } from '../../config/app.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { execFileSync } from '../../node-singletons/child-process.js';
-import fs from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
 import chalk from 'chalk';
 const getGitBinary = () => 'git';
@@ -237,38 +236,19 @@ const addOptions = (command) => {
     command.option('--install', 'Force dependency installation (useful to override CI defaults)');
     command.option('--package-manager <manager>', 'Package manager to use (npm, yarn, pnpm)');
     command.option('--governance', 'Install governance tooling (ESLint + architecture tests)', false);
-    command.option('--with-d1-proxy', 'Add @zintrust/cloudflare-d1-proxy to package.json (for deploying the D1 proxy worker)', false);
+    command.option('--with-d1-proxy', 'Show D1 proxy setup guidance for repo-managed proxy Workers', false);
     command.option('--force', 'Overwrite existing directory');
     command.option('--overwrite', 'Overwrite existing directory');
 };
-const maybeAddD1ProxyDependency = (projectPath, options, log) => {
+const maybeAddD1ProxyDependency = (options, log) => {
     const enabled = options['withD1Proxy'] === true || options['with-d1-proxy'] === true;
     if (!enabled)
         return;
-    const packageJsonPath = path.join(projectPath, 'package.json');
-    if (!fs.existsSync(packageJsonPath)) {
-        log.warn(`Could not add @zintrust/cloudflare-d1-proxy (missing package.json at ${packageJsonPath})`);
-        return;
-    }
-    try {
-        const raw = fs.readFileSync(packageJsonPath, 'utf8');
-        const pkg = JSON.parse(raw);
-        const dependencies = { ...pkg.dependencies };
-        if (typeof dependencies['@zintrust/cloudflare-d1-proxy'] !== 'string') {
-            // Avoid pinning to core version (they can differ). Use a safe caret range.
-            dependencies['@zintrust/cloudflare-d1-proxy'] = '^0.1.42';
-        }
-        const next = {
-            ...pkg,
-            dependencies,
-        };
-        fs.writeFileSync(packageJsonPath, JSON.stringify(next, null, 2) + '\n');
-        log.info('✅ Added @zintrust/cloudflare-d1-proxy to dependencies');
-    }
-    catch (error) {
-        ErrorFactory.createCliError('Failed to update package.json with D1 proxy dependency', error);
-        log.warn('Please add @zintrust/cloudflare-d1-proxy manually if you need the proxy worker.');
-    }
+    log.info([
+        'D1 proxy Workers are now repo-managed and are not scaffolded as a standalone app dependency.',
+        'Use @zintrust/core/proxy for the Worker entrypoint export,',
+        'run zin proxy:d1 for local dev, and zin deploy d1-proxy for deployment.',
+    ].join(' '));
 };
 const resolveProjectName = async (options) => {
     const argName = options.args?.[0];
@@ -320,7 +300,7 @@ const createProject = async (target, options, command) => {
         }
     }
     // Optional dependency injection must happen before `npm/yarn/pnpm install`.
-    maybeAddD1ProxyDependency(target.projectPath, options, command);
+    maybeAddD1ProxyDependency(options, command);
 };
 const maybeInitializeGit = (options, command, target) => {
     if (options['git'] !== false) {

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

@@ -1 +1 @@
-{"version":3,"file":"GovernanceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/GovernanceScaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAgTH,eAAO,MAAM,oBAAoB;0BAEhB,MAAM,YACV,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC;EA+DpC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"GovernanceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/GovernanceScaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AA8UH,eAAO,MAAM,oBAAoB;0BAEhB,MAAM,YACV,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC;EA+DpC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/src/cli/scaffolding/GovernanceScaffolder.js

@@ -50,12 +50,39 @@ const ensureDevDependency = (devDependencies, name, version) => {
         devDependencies[name] = version;
     }
 };
+const extractMajorMinorVersion = (value) => {
+    const trimmed = value.trim();
+    let start = -1;
+    for (let index = 0; index < trimmed.length; index++) {
+        const char = trimmed[index];
+        if (char !== undefined && char >= '0' && char <= '9') {
+            start = index;
+            break;
+        }
+    }
+    if (start < 0)
+        return undefined;
+    let end = start;
+    while (end < trimmed.length) {
+        const char = trimmed[end];
+        const isDigit = char !== undefined && char >= '0' && char <= '9';
+        if (!isDigit && char !== '.')
+            break;
+        end++;
+    }
+    const parts = trimmed.slice(start, end).split('.');
+    if (parts.length < 3)
+        return undefined;
+    const [major, minor, patch] = parts;
+    if (!major || !minor || !patch)
+        return undefined;
+    return { major, minor };
+};
 const toCompatibleGovernanceVersion = (value) => {
-    const match = /(\d+)\.(\d+)\.(\d+)/.exec(value);
-    if (match === null)
+    const parsed = extractMajorMinorVersion(value);
+    if (parsed === undefined)
         return undefined;
-    const [, major, minor] = match;
-    return `^${major}.${minor}.0`;
+    return `^${parsed.major}.${parsed.minor}.0`;
 };
 const inferGovernanceVersion = (pkg) => {
     const deps = getStringRecord(pkg.dependencies);

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;AAWH,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;AA8dD,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;AAWH,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;AA0fD,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"}

package/src/cli/scaffolding/ProjectScaffolder.js

@@ -20,12 +20,38 @@ const loadCoreVersion = () => {
         return '0.0.0';
     }
 };
-const toCompatibleGovernanceVersion = (version) => {
-    const match = /(\d+)\.(\d+)\.(\d+)/.exec(version);
-    if (match !== null) {
-        const [, major, minor] = match;
-        return `^${major}.${minor}.0`;
+const extractMajorMinorVersion = (value) => {
+    const trimmed = value.trim();
+    let start = -1;
+    for (let index = 0; index < trimmed.length; index++) {
+        const char = trimmed[index];
+        if (char !== undefined && char >= '0' && char <= '9') {
+            start = index;
+            break;
+        }
+    }
+    if (start < 0)
+        return undefined;
+    let end = start;
+    while (end < trimmed.length) {
+        const char = trimmed[end];
+        const isDigit = char !== undefined && char >= '0' && char <= '9';
+        if (!isDigit && char !== '.')
+            break;
+        end++;
     }
+    const parts = trimmed.slice(start, end).split('.');
+    if (parts.length < 3)
+        return undefined;
+    const [major, minor, patch] = parts;
+    if (!major || !minor || !patch)
+        return undefined;
+    return { major, minor };
+};
+const toCompatibleGovernanceVersion = (version) => {
+    const parsed = extractMajorMinorVersion(version);
+    if (parsed !== undefined)
+        return `^${parsed.major}.${parsed.minor}.0`;
     return '^0.4.0';
 };
 const createDirectories = (projectPath, directories) => {

package/src/cli/utils/DistPackager.d.ts

@@ -1,7 +1,7 @@
 export declare const DistPackager: Readonly<{
     /**
-    * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`
-    * without clobbering the publishable package manifest.
+     * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`
+     * without clobbering the publishable package manifest.
      */
     prepare(distPath: string, rootPath?: string): void;
 }>;

package/src/cli/utils/DistPackager.js

@@ -116,8 +116,8 @@ const warnIfMissingDistArtifacts = (distPath) => {
 };
 export const DistPackager = Object.freeze({
     /**
-    * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`
-    * without clobbering the publishable package manifest.
+     * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`
+     * without clobbering the publishable package manifest.
      */
     prepare(distPath, rootPath = process.cwd()) {
         if (!fs.existsSync(distPath)) {

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.28
+ * @zintrust/core v0.4.30
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-29T11:38:07.594Z
+ *   Built: 2026-03-29T12:25:46.484Z
  *   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-29T11:38:07.522Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-29T12:25:46.451Z'; // 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.js

@@ -10,7 +10,7 @@
 // Uncomment and adapt to your project as needed.
 //
 // import { ZinTrustProcessor } from '../app/Workers/AdvancEmailWorker';
-// import { WorkerFactory, type WorkerFactoryConfig } from '@zintrust/workers';
+// import { WorkerFactory, type WorkerFactoryConfig } from '../packages/workers/src/index.js';
 //
 // type PreRegisteredProcessorSpec = {
 //   processorSpec: string;

package/app/Controllers/AuthController.d.ts

@@ -1,10 +0,0 @@
-/**
- * Auth Controller
- * Minimal, real auth endpoints backing the example API routes.
- */
-import type { AuthControllerApi } from '../Types/controller';
-export declare const AuthController: Readonly<{
-    create(): AuthControllerApi;
-}>;
-export default AuthController;
-//# sourceMappingURL=AuthController.d.ts.map

package/app/Controllers/AuthController.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AuthController.d.ts","sourceRoot":"","sources":["../../../app/Controllers/AuthController.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAuB,MAAM,uBAAuB,CAAC;AAmPpF,eAAO,MAAM,cAAc;cACf,iBAAiB;EAS3B,CAAC;AAEH,eAAe,cAAc,CAAC"}