@zintrust/core 0.4.31 → 0.4.33

package/README.md

@@ -30,6 +30,21 @@ If you’re targeting a different runtime:
 
 The canonical CLI is `zin`. `z` is a shorthand alias.
 
+## Reuse The Stock Bootstrap
+
+If your project needs a `src/boot/bootstrap.ts` entry for Docker, Node, or custom startup layout, you do not need to copy the full ZinTrust bootstrap implementation into your app.
+
+Use a thin bootstrap file that delegates to the published core boot entrypoint:
+
+```typescript
+// src/boot/bootstrap.ts
+import '@zintrust/core/boot';
+
+export {};
+```
+
+Use a full custom bootstrap only when you intentionally need behavior different from the stock ZinTrust bootstrap. If you replace it completely, you are also responsible for running any worker startup lifecycle that your app depends on.
+
 ## Install adapters (database/cache/etc.)
 
 ZinTrust keeps the core package minimal. Integrations like database drivers are installed explicitly via adapter packages.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.31",
+  "version": "0.4.33",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -22,6 +22,10 @@
       "types": "./src/start.d.ts",
       "import": "./src/start.js"
     },
+    "./boot": {
+      "types": "./src/boot.d.ts",
+      "import": "./src/boot.js"
+    },
     "./cli": {
       "types": "./src/cli.d.ts",
       "import": "./src/cli.js"

package/src/boot.d.ts

@@ -0,0 +1,3 @@
+import './boot/bootstrap';
+export {};
+//# sourceMappingURL=boot.d.ts.map

package/src/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/boot.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,CAAC;AAEzB,OAAO,EAAE,CAAC"}

package/src/boot.js

@@ -0,0 +1 @@
+import './boot/bootstrap.js';

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;AA6PrE,eAAO,MAAM,cAAc;cACf,YAAY;EAwCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"D1ProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/D1ProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmHrD,eAAO,MAAM,cAAc;cACf,YAAY;EAkBtB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cli/commands/D1ProxyCommand.js

@@ -1,12 +1,7 @@
-import { BaseCommand } from '../BaseCommand.js';
-import { maybeRunProxyWatchMode } from '../commands/ProxyCommandUtils.js';
-import { SpawnUtil } from '../utils/spawn.js';
+import { findQuotedValue, trimNonEmptyOption } from '../commands/ProxyScaffoldUtils.js';
+import { addWranglerProxyBaseOptions, createWranglerProxyCommand, } from '../commands/WranglerProxyCommandUtils.js';
 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, 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_DB';
@@ -14,76 +9,25 @@ 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 DEFAULT_ROUTE_PATTERN = 'd1-proxy.example.com';
 const CORE_PROXY_MODULE = ['@zintrust', 'core', 'proxy'].join('/');
-const trimOption = (value) => {
-    if (!isNonEmptyString(value))
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-};
-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 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 ?? '';
     return {
-        binding: trimOption(options.binding) ??
-            trimOption(Env.get('D1_BINDING', '')) ??
+        binding: trimNonEmptyOption(options.binding) ??
+            trimNonEmptyOption(Env.get('D1_BINDING', '')) ??
             findQuotedValue(fileContent, 'D1_BINDING') ??
             findQuotedValue(fileContent, 'binding') ??
             DEFAULT_BINDING,
-        databaseName: trimOption(options.databaseName) ??
-            trimOption(Env.get('D1_DATABASE_NAME', '')) ??
+        databaseName: trimNonEmptyOption(options.databaseName) ??
+            trimNonEmptyOption(Env.get('D1_DATABASE_NAME', '')) ??
             findQuotedValue(fileContent, 'database_name') ??
             DEFAULT_DATABASE_NAME,
-        databaseId: trimOption(options.databaseId) ??
-            trimOption(Env.get('D1_DATABASE_ID', '')) ??
+        databaseId: trimNonEmptyOption(options.databaseId) ??
+            trimNonEmptyOption(Env.get('D1_DATABASE_ID', '')) ??
             findQuotedValue(fileContent, 'database_id') ??
             DEFAULT_DATABASE_ID,
-        migrationsDir: trimOption(options.migrationsDir) ??
+        migrationsDir: trimNonEmptyOption(options.migrationsDir) ??
             findQuotedValue(fileContent, 'migrations_dir') ??
             DEFAULT_MIGRATIONS_DIR,
     };
@@ -111,81 +55,19 @@ const renderD1ProxyEnvBlock = (values) => {
         `          "database_id": "${values.databaseId}",`,
         `          "migrations_dir": "${values.migrationsDir}"`,
         '        }',
-        '      ]',
+        '      ],',
+        '      // Add routes here when ready:',
+        `      // "routes": [{ "pattern": "${DEFAULT_ROUTE_PATTERN}", "custom_domain": true }]`,
         '    }',
     ].join('\n');
 };
-const renderDefaultWranglerConfig = (values) => {
-    return [
-        '{',
-        '  "name": "zintrust-api",',
-        '  "main": "./src/functions/cloudflare.ts",',
-        `  "compatibility_date": "${DEFAULT_COMPATIBILITY_DATE}",`,
-        '  "compatibility_flags": ["nodejs_compat"],',
-        '  "env": {',
-        renderD1ProxyEnvBlock(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 (hasEnvBlock(content, 'd1-proxy'))
-        return content;
-    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 (envObjectStart >= 0) {
-        return `${content.slice(0, envObjectStart + 1)}\n${block},${content.slice(envObjectStart + 1)}`;
-    }
-    const closingIndex = content.lastIndexOf('}');
-    if (closingIndex < 0) {
-        throw ErrorFactory.createCliError('Invalid wrangler.jsonc: missing closing brace.');
-    }
-    const before = content.slice(0, closingIndex).trimEnd();
-    const suffix = before.endsWith('{') ? '\n' : ',\n';
-    return `${before}${suffix}  "env": {\n${block}\n  }\n}\n`;
-};
-const ensureWranglerConfig = (configPath, options) => {
-    if (!existsSync(configPath)) {
-        const values = resolveConfigValues(undefined, options);
-        writeFileSync(configPath, renderDefaultWranglerConfig(values), 'utf-8');
-        return { createdFile: true, insertedEnv: true, values };
-    }
-    const content = readFileSync(configPath, 'utf-8');
-    const values = resolveConfigValues(content, options);
-    const next = injectEnvBlock(content, renderD1ProxyEnvBlock(values));
-    if (next !== content) {
-        writeFileSync(configPath, next, 'utf-8');
-        return { createdFile: false, insertedEnv: true, values };
-    }
-    return { createdFile: false, insertedEnv: false, values };
-};
 const warnOnPlaceholderDatabaseId = (values) => {
     if (values.databaseId !== DEFAULT_DATABASE_ID)
         return;
     Logger.warn('Could not resolve a D1 database id automatically. Update wrangler.jsonc or pass --database-id before relying on the generated d1-proxy environment.');
 };
 const addOptions = (command) => {
-    command.option('-c, --config <path>', 'Wrangler config file', DEFAULT_CONFIG);
-    command.option('--watch', 'Auto-restart proxy on file changes');
+    addWranglerProxyBaseOptions(command, DEFAULT_CONFIG);
     command.option('--binding <name>', 'D1 binding name', DEFAULT_BINDING);
     command.option('--database-name <name>', 'Cloudflare D1 database name');
     command.option('--database-id <id>', 'Cloudflare D1 database id');
@@ -193,37 +75,20 @@ const addOptions = (command) => {
 };
 export const D1ProxyCommand = Object.freeze({
     create() {
-        return BaseCommand.create({
+        return createWranglerProxyCommand({
             name: 'proxy:d1',
             aliases: ['d1:proxy'],
             description: 'Start the local Cloudflare D1 proxy Worker via Wrangler and scaffold env.d1-proxy in wrangler.jsonc when missing',
+            envName: 'd1-proxy',
+            defaultConfig: DEFAULT_CONFIG,
+            compatibilityDate: DEFAULT_COMPATIBILITY_DATE,
+            entryFile: DEFAULT_ENTRY_FILE,
+            exportName: 'ZintrustD1Proxy',
+            moduleSpecifier: CORE_PROXY_MODULE,
             addOptions,
-            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.`);
-                }
-                else if (result.insertedEnv) {
-                    Logger.info(`Added env.d1-proxy to ${configPath}.`);
-                }
-                warnOnPlaceholderDatabaseId(result.values);
-                const exitCode = await SpawnUtil.spawnAndWait({
-                    command: 'wrangler',
-                    args: ['dev', '--config', configPath, '--env', 'd1-proxy'],
-                    env: process.env,
-                    forwardSignals: false,
-                });
-                if (exitCode !== 0) {
-                    process.exit(exitCode);
-                }
-            },
+            resolveValues: resolveConfigValues,
+            renderEnvBlock: renderD1ProxyEnvBlock,
+            afterConfigResolved: warnOnPlaceholderDatabaseId,
         });
     },
 });

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;AA0OrE,eAAO,MAAM,cAAc;cACf,YAAY;EAwCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"KvProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/KvProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmGrD,eAAO,MAAM,cAAc;cACf,YAAY;EAkBtB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cli/commands/KvProxyCommand.js

@@ -1,83 +1,30 @@
-import { BaseCommand } from '../BaseCommand.js';
-import { maybeRunProxyWatchMode } from '../commands/ProxyCommandUtils.js';
-import { SpawnUtil } from '../utils/spawn.js';
+import { findQuotedValue, trimNonEmptyOption } from '../commands/ProxyScaffoldUtils.js';
+import { addWranglerProxyBaseOptions, createWranglerProxyCommand, } from '../commands/WranglerProxyCommandUtils.js';
 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, 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 DEFAULT_ROUTE_PATTERN = 'kv-proxy.example.com';
 const CORE_PROXY_MODULE = ['@zintrust', 'core', 'proxy'].join('/');
-const trimOption = (value) => {
-    if (!isNonEmptyString(value))
-        return undefined;
-    const trimmed = value.trim();
-    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 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 ?? '';
-    const namespaceId = trimOption(options.namespaceId) ??
-        trimOption(Env.get('KV_NAMESPACE_ID', '')) ??
+    const namespaceId = trimNonEmptyOption(options.namespaceId) ??
+        trimNonEmptyOption(Env.get('KV_NAMESPACE_ID', '')) ??
         findQuotedValue(fileContent, 'preview_id') ??
         findQuotedValue(fileContent, 'id') ??
         DEFAULT_NAMESPACE_ID;
     return {
-        binding: trimOption(options.binding) ??
-            trimOption(Env.get('KV_NAMESPACE', '')) ??
+        binding: trimNonEmptyOption(options.binding) ??
+            trimNonEmptyOption(Env.get('KV_NAMESPACE', '')) ??
             findQuotedValue(fileContent, 'KV_NAMESPACE') ??
             findQuotedValue(fileContent, 'binding') ??
             DEFAULT_BINDING,
         namespaceId,
-        previewId: trimOption(options.previewId) ??
-            trimOption(Env.get('KV_NAMESPACE_PREVIEW_ID', '')) ??
+        previewId: trimNonEmptyOption(options.previewId) ??
+            trimNonEmptyOption(Env.get('KV_NAMESPACE_PREVIEW_ID', '')) ??
             findQuotedValue(fileContent, 'preview_id') ??
             namespaceId,
     };
@@ -100,118 +47,39 @@ const renderKvProxyEnvBlock = (values) => {
         `          "preview_id": "${values.previewId}",`,
         '          "remote": false',
         '        }',
-        '      ]',
+        '      ],',
+        '      // Add routes here when ready:',
+        `      // "routes": [{ "pattern": "${DEFAULT_ROUTE_PATTERN}", "custom_domain": true }]`,
         '    }',
     ].join('\n');
 };
-const renderDefaultWranglerConfig = (values) => {
-    return [
-        '{',
-        '  "name": "zintrust-api",',
-        '  "main": "./src/functions/cloudflare.ts",',
-        `  "compatibility_date": "${DEFAULT_COMPATIBILITY_DATE}",`,
-        '  "compatibility_flags": ["nodejs_compat"],',
-        '  "env": {',
-        renderKvProxyEnvBlock(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 (hasEnvBlock(content, 'kv-proxy'))
-        return content;
-    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 (envObjectStart >= 0) {
-        return `${content.slice(0, envObjectStart + 1)}\n${block},${content.slice(envObjectStart + 1)}`;
-    }
-    const closingIndex = content.lastIndexOf('}');
-    if (closingIndex < 0) {
-        throw ErrorFactory.createCliError('Invalid wrangler.jsonc: missing closing brace.');
-    }
-    const before = content.slice(0, closingIndex).trimEnd();
-    const suffix = before.endsWith('{') ? '\n' : ',\n';
-    return `${before}${suffix}  "env": {\n${block}\n  }\n}\n`;
-};
-const ensureWranglerConfig = (configPath, options) => {
-    if (!existsSync(configPath)) {
-        const values = resolveConfigValues(undefined, options);
-        writeFileSync(configPath, renderDefaultWranglerConfig(values), 'utf-8');
-        return { createdFile: true, insertedEnv: true, values };
-    }
-    const content = readFileSync(configPath, 'utf-8');
-    const values = resolveConfigValues(content, options);
-    const next = injectEnvBlock(content, renderKvProxyEnvBlock(values));
-    if (next !== content) {
-        writeFileSync(configPath, next, 'utf-8');
-        return { createdFile: false, insertedEnv: true, values };
-    }
-    return { createdFile: false, insertedEnv: false, values };
-};
 const warnOnPlaceholderNamespaceId = (values) => {
     if (values.namespaceId !== DEFAULT_NAMESPACE_ID)
         return;
     Logger.warn('Could not resolve a KV namespace id automatically. Update wrangler.jsonc or pass --namespace-id before relying on the generated kv-proxy environment.');
 };
 const addOptions = (command) => {
-    command.option('-c, --config <path>', 'Wrangler config file', DEFAULT_CONFIG);
-    command.option('--watch', 'Auto-restart proxy on file changes');
+    addWranglerProxyBaseOptions(command, DEFAULT_CONFIG);
     command.option('--binding <name>', 'KV binding name', DEFAULT_BINDING);
     command.option('--namespace-id <id>', 'Cloudflare KV namespace id');
     command.option('--preview-id <id>', 'Cloudflare KV preview namespace id');
 };
 export const KvProxyCommand = Object.freeze({
     create() {
-        return BaseCommand.create({
+        return createWranglerProxyCommand({
             name: 'proxy:kv',
             aliases: ['kv:proxy'],
             description: 'Start the local Cloudflare KV proxy Worker via Wrangler and scaffold env.kv-proxy in wrangler.jsonc when missing',
+            envName: 'kv-proxy',
+            defaultConfig: DEFAULT_CONFIG,
+            compatibilityDate: DEFAULT_COMPATIBILITY_DATE,
+            entryFile: DEFAULT_ENTRY_FILE,
+            exportName: 'ZintrustKvProxy',
+            moduleSpecifier: CORE_PROXY_MODULE,
             addOptions,
-            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.`);
-                }
-                else if (result.insertedEnv) {
-                    Logger.info(`Added env.kv-proxy to ${configPath}.`);
-                }
-                warnOnPlaceholderNamespaceId(result.values);
-                const exitCode = await SpawnUtil.spawnAndWait({
-                    command: 'wrangler',
-                    args: ['dev', '--config', configPath, '--env', 'kv-proxy'],
-                    env: process.env,
-                    forwardSignals: false,
-                });
-                if (exitCode !== 0) {
-                    process.exit(exitCode);
-                }
-            },
+            resolveValues: resolveConfigValues,
+            renderEnvBlock: renderKvProxyEnvBlock,
+            afterConfigResolved: warnOnPlaceholderNamespaceId,
         });
     },
 });

package/src/cli/commands/ProxyScaffoldUtils.d.ts

@@ -0,0 +1,31 @@
+type EnsureProxyEntrypointOptions = {
+    cwd: string;
+    entryFile: string;
+    exportName: string;
+    moduleSpecifier: string;
+};
+type EnsureWranglerConfigOptions<TValues, TOptions> = {
+    configPath: string;
+    options: TOptions;
+    envName: string;
+    resolveValues: (content: string | undefined, options: TOptions) => TValues;
+    renderEnvBlock: (values: TValues) => string;
+    compatibilityDate: string;
+};
+type EnsureWranglerConfigResult<TValues> = {
+    createdFile: boolean;
+    insertedEnv: boolean;
+    values: TValues;
+};
+export declare const trimNonEmptyOption: (value: string | undefined) => string | undefined;
+export declare const resolveConfigPath: (raw: string | undefined, fallback?: string) => string;
+export declare const findQuotedValue: (content: string, key: string) => string | undefined;
+export declare const injectEnvBlock: (content: string, envName: string, block: string) => string;
+export declare const renderDefaultWranglerConfig: (envBlock: string, compatibilityDate: string) => string;
+export declare const ensureProxyEntrypoint: (options: EnsureProxyEntrypointOptions) => {
+    created: boolean;
+    entryFilePath: string;
+};
+export declare const ensureWranglerConfig: <TValues, TOptions>(options: EnsureWranglerConfigOptions<TValues, TOptions>) => EnsureWranglerConfigResult<TValues>;
+export {};
+//# sourceMappingURL=ProxyScaffoldUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProxyScaffoldUtils.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ProxyScaffoldUtils.ts"],"names":[],"mappings":"AAKA,KAAK,4BAA4B,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,KAAK,2BAA2B,CAAC,OAAO,EAAE,QAAQ,IAAI;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,QAAQ,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;IAC3E,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IAC5C,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,KAAK,0BAA0B,CAAC,OAAO,IAAI;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SAIvE,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,GAAG,SAAS,EAAE,iBAA2B,KAAG,MAExF,CAAC;AAmBF,eAAO,MAAM,eAAe,GAAI,SAAS,MAAM,EAAE,KAAK,MAAM,KAAG,MAAM,GAAG,SAQvE,CAAC;AAmBF,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,EAAE,OAAO,MAAM,KAAG,MAuBhF,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,UAAU,MAAM,EAChB,mBAAmB,MAAM,KACxB,MAaF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,SAAS,4BAA4B,KACpC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAoB3C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,EAAE,QAAQ,EACpD,SAAS,2BAA2B,CAAC,OAAO,EAAE,QAAQ,CAAC,KACtD,0BAA0B,CAAC,OAAO,CAqBpC,CAAC"}

package/src/cli/commands/ProxyScaffoldUtils.js

@@ -0,0 +1,120 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { isNonEmptyString } from '../../helper/index.js';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
+import { join } from '../../node-singletons/path.js';
+export const trimNonEmptyOption = (value) => {
+    if (!isNonEmptyString(value))
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+};
+export const resolveConfigPath = (raw, fallback = 'wrangler.jsonc') => {
+    return trimNonEmptyOption(raw) ?? fallback;
+};
+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;
+};
+export const findQuotedValue = (content, key) => {
+    const valueStart = findJsonKeyValueStart(content, key);
+    if (valueStart < 0 || content[valueStart] !== '"')
+        return undefined;
+    const valueEnd = content.indexOf('"', valueStart + 1);
+    if (valueEnd < 0)
+        return undefined;
+    return trimNonEmptyOption(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] === '}';
+};
+export const injectEnvBlock = (content, envName, block) => {
+    if (hasEnvBlock(content, envName))
+        return content;
+    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 (envObjectStart >= 0) {
+        return `${content.slice(0, envObjectStart + 1)}\n${block},${content.slice(envObjectStart + 1)}`;
+    }
+    const closingIndex = content.lastIndexOf('}');
+    if (closingIndex < 0) {
+        throw ErrorFactory.createCliError('Invalid wrangler.jsonc: missing closing brace.');
+    }
+    const before = content.slice(0, closingIndex).trimEnd();
+    const suffix = before.endsWith('{') ? '\n' : ',\n';
+    return `${before}${suffix}  "env": {\n${block}\n  }\n}\n`;
+};
+export const renderDefaultWranglerConfig = (envBlock, compatibilityDate) => {
+    return [
+        '{',
+        '  "name": "zintrust-api",',
+        '  "main": "./src/functions/cloudflare.ts",',
+        `  "compatibility_date": "${compatibilityDate}",`,
+        '  "compatibility_flags": ["nodejs_compat"],',
+        '  "env": {',
+        envBlock,
+        '  }',
+        '}',
+        '',
+    ].join('\n');
+};
+export const ensureProxyEntrypoint = (options) => {
+    const entryFilePath = join(options.cwd, options.entryFile);
+    if (existsSync(entryFilePath)) {
+        return { created: false, entryFilePath };
+    }
+    const lastSlashIndex = entryFilePath.lastIndexOf('/');
+    const entryDir = lastSlashIndex > 0 ? entryFilePath.slice(0, lastSlashIndex) : options.cwd;
+    mkdirSync(entryDir, { recursive: true });
+    writeFileSync(entryFilePath, [
+        `export { ${options.exportName} } from '${options.moduleSpecifier}';`,
+        `export { ${options.exportName} as default } from '${options.moduleSpecifier}';`,
+        '',
+    ].join('\n'), 'utf-8');
+    return { created: true, entryFilePath };
+};
+export const ensureWranglerConfig = (options) => {
+    if (!existsSync(options.configPath)) {
+        const values = options.resolveValues(undefined, options.options);
+        writeFileSync(options.configPath, renderDefaultWranglerConfig(options.renderEnvBlock(values), options.compatibilityDate), 'utf-8');
+        return { createdFile: true, insertedEnv: true, values };
+    }
+    const content = readFileSync(options.configPath, 'utf-8');
+    const values = options.resolveValues(content, options.options);
+    const next = injectEnvBlock(content, options.envName, options.renderEnvBlock(values));
+    if (next !== content) {
+        writeFileSync(options.configPath, next, 'utf-8');
+        return { createdFile: false, insertedEnv: true, values };
+    }
+    return { createdFile: false, insertedEnv: false, values };
+};

package/src/cli/commands/WranglerProxyCommandUtils.d.ts

@@ -0,0 +1,26 @@
+import type { CommandOptions, IBaseCommand } from '../BaseCommand';
+import type { Command } from 'commander';
+export type WranglerProxyCommandOptions = CommandOptions & {
+    config?: string;
+    port?: string;
+    watch?: boolean;
+};
+type CreateWranglerProxyCommandInput<TValues, TOptions extends WranglerProxyCommandOptions> = {
+    name: string;
+    aliases: string[];
+    description: string;
+    envName: string;
+    defaultConfig: string;
+    compatibilityDate: string;
+    entryFile: string;
+    exportName: string;
+    moduleSpecifier: string;
+    addOptions: (command: Command) => void;
+    resolveValues: (content: string | undefined, options: TOptions) => TValues;
+    renderEnvBlock: (values: TValues) => string;
+    afterConfigResolved?: (values: TValues) => void;
+};
+export declare const addWranglerProxyBaseOptions: (command: Command, defaultConfig: string) => void;
+export declare const createWranglerProxyCommand: <TValues, TOptions extends WranglerProxyCommandOptions>(input: CreateWranglerProxyCommandInput<TValues, TOptions>) => IBaseCommand;
+export {};
+//# sourceMappingURL=WranglerProxyCommandUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WranglerProxyCommandUtils.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/WranglerProxyCommandUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAWrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,2BAA2B,GAAG,cAAc,GAAG;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,KAAK,+BAA+B,CAAC,OAAO,EAAE,QAAQ,SAAS,2BAA2B,IAAI;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;IAC3E,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IAC5C,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACjD,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,SAAS,OAAO,EAAE,eAAe,MAAM,KAAG,IAIrF,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,OAAO,EAAE,QAAQ,SAAS,2BAA2B,EAC9F,OAAO,+BAA+B,CAAC,OAAO,EAAE,QAAQ,CAAC,KACxD,YA0DF,CAAC"}

package/src/cli/commands/WranglerProxyCommandUtils.js

@@ -0,0 +1,63 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { maybeRunProxyWatchMode, parseIntOption } from '../commands/ProxyCommandUtils.js';
+import { ensureProxyEntrypoint, ensureWranglerConfig, resolveConfigPath, } from '../commands/ProxyScaffoldUtils.js';
+import { SpawnUtil } from '../utils/spawn.js';
+import { Logger } from '../../config/logger.js';
+import { join } from '../../node-singletons/path.js';
+export const addWranglerProxyBaseOptions = (command, defaultConfig) => {
+    command.option('-c, --config <path>', 'Wrangler config file', defaultConfig);
+    command.option('--port <port>', 'Local Wrangler dev port');
+    command.option('--watch', 'Auto-restart proxy on file changes');
+};
+export const createWranglerProxyCommand = (input) => {
+    return BaseCommand.create({
+        name: input.name,
+        aliases: input.aliases,
+        description: input.description,
+        addOptions: input.addOptions,
+        execute: async (options) => {
+            const typedOptions = options;
+            await maybeRunProxyWatchMode(typedOptions.watch);
+            const port = parseIntOption(typedOptions.port, 'port');
+            const cwd = process.cwd();
+            const entrypoint = ensureProxyEntrypoint({
+                cwd,
+                entryFile: input.entryFile,
+                exportName: input.exportName,
+                moduleSpecifier: input.moduleSpecifier,
+            });
+            const configPath = join(cwd, resolveConfigPath(typedOptions.config, input.defaultConfig));
+            const result = ensureWranglerConfig({
+                configPath,
+                options: typedOptions,
+                envName: input.envName,
+                resolveValues: input.resolveValues,
+                renderEnvBlock: input.renderEnvBlock,
+                compatibilityDate: input.compatibilityDate,
+            });
+            if (entrypoint.created) {
+                Logger.info(`Created ${entrypoint.entryFilePath} from @zintrust/core proxy entrypoint.`);
+            }
+            if (result.createdFile) {
+                Logger.info(`Created ${configPath} with a default ${input.envName} environment.`);
+            }
+            else if (result.insertedEnv) {
+                Logger.info(`Added env.${input.envName} to ${configPath}.`);
+            }
+            input.afterConfigResolved?.(result.values);
+            const args = ['dev', '--config', configPath, '--env', input.envName];
+            if (port !== undefined) {
+                args.push('--port', String(port));
+            }
+            const exitCode = await SpawnUtil.spawnAndWait({
+                command: 'wrangler',
+                args,
+                env: process.env,
+                forwardSignals: false,
+            });
+            if (exitCode !== 0) {
+                process.exit(exitCode);
+            }
+        },
+    });
+};

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;AA8UH,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;AAqBH,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;AAsSH,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

@@ -6,6 +6,7 @@
  * - Architecture tests (Vitest)
  */
 import { FileGenerator } from '../scaffolding/FileGenerator.js';
+import { toCompatibleGovernanceVersion } from '../scaffolding/ScaffoldingVersionUtils.js';
 import { VersionChecker } from '../services/VersionChecker.js';
 import { SpawnUtil } from '../utils/spawn.js';
 import { resolvePackageManager } from '../../common/index.js';
@@ -50,53 +51,15 @@ 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 parsed = extractMajorMinorVersion(value);
-    if (parsed === undefined)
-        return undefined;
-    return `^${parsed.major}.${parsed.minor}.0`;
-};
 const inferGovernanceVersion = (pkg) => {
     const deps = getStringRecord(pkg.dependencies);
     const core = deps?.['@zintrust/core'];
     if (typeof core === 'string' && core.trim() !== '') {
-        const compatibleFromCore = toCompatibleGovernanceVersion(core);
-        if (compatibleFromCore !== undefined)
-            return compatibleFromCore;
+        return toCompatibleGovernanceVersion(core);
     }
     const currentVersion = VersionChecker.getCurrentVersion().trim();
     if (currentVersion !== '' && currentVersion !== '0.0.0') {
-        const compatibleFromCli = toCompatibleGovernanceVersion(currentVersion);
-        if (compatibleFromCli !== undefined)
-            return compatibleFromCli;
+        return toCompatibleGovernanceVersion(currentVersion);
     }
     return '^0.4.0';
 };

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;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"}
+{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,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;AAodD,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

@@ -4,6 +4,7 @@
  */
 import { EnvFileBackfill } from '../env/EnvFileBackfill.js';
 import { EnvData } from '../scaffolding/env.js';
+import { toCompatibleGovernanceVersion } from '../scaffolding/ScaffoldingVersionUtils.js';
 import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { randomBytes } from '../../node-singletons/crypto.js';
@@ -20,40 +21,6 @@ const loadCoreVersion = () => {
         return '0.0.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) => {
     let count = 0;
     if (!fs.existsSync(projectPath)) {

package/src/cli/scaffolding/ScaffoldingVersionUtils.d.ts

@@ -0,0 +1,6 @@
+export declare const extractMajorMinorVersion: (value: string) => {
+    major: string;
+    minor: string;
+} | undefined;
+export declare const toCompatibleGovernanceVersion: (value: string, fallback?: string) => string;
+//# sourceMappingURL=ScaffoldingVersionUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScaffoldingVersionUtils.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ScaffoldingVersionUtils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,GACnC,OAAO,MAAM,KACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SA6BrC,CAAC;AAEF,eAAO,MAAM,6BAA6B,GAAI,OAAO,MAAM,EAAE,iBAAmB,KAAG,MAKlF,CAAC"}

package/src/cli/scaffolding/ScaffoldingVersionUtils.js

@@ -0,0 +1,34 @@
+export 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 };
+};
+export const toCompatibleGovernanceVersion = (value, fallback = '^0.4.0') => {
+    const parsed = extractMajorMinorVersion(value);
+    if (parsed === undefined)
+        return fallback;
+    return `^${parsed.major}.${parsed.minor}.0`;
+};

package/src/config/middleware.d.ts

@@ -1,6 +1,6 @@
 import type { MiddlewareConfigType } from './type';
-import type { Middleware } from '../middleware/MiddlewareStack';
 import type { MiddlewareFailureResponder } from '../middleware/MiddlewareFailureResponder';
+import type { Middleware } from '../middleware/MiddlewareStack';
 type SharedMiddlewares = {
     log: Middleware;
     error: Middleware;
@@ -68,7 +68,10 @@ export declare const MiddlewareKeys: Readonly<{
     validateUserUpdate: true;
     validateUserFill: true;
 }>;
-export type MiddlewareKey = keyof typeof MiddlewareKeys;
+export type ParameterizedRateLimitMiddlewareKey = `rateLimit:${number}:${number}`;
+type StaticMiddlewareKey = keyof typeof MiddlewareKeys;
+export type MiddlewareKey = StaticMiddlewareKey | ParameterizedRateLimitMiddlewareKey;
+export declare const isKnownMiddlewareName: (value: string) => value is MiddlewareKey;
 export declare function createMiddlewareConfig(): MiddlewareConfigType;
 /**
  * Clear the middleware configuration cache

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

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/config/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAUzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAK9D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAgCzF,KAAK,iBAAiB,GAAG;IACvB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,UAAU,CAAC;IACtB,YAAY,EAAE,UAAU,CAAC;IACzB,aAAa,EAAE,UAAU,CAAC;IAC1B,aAAa,EAAE,UAAU,CAAC;IAC1B,qBAAqB,EAAE,UAAU,CAAC;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,WAAW,EAAE,UAAU,CAAC;IACxB,aAAa,EAAE,UAAU,CAAC;IAC1B,gBAAgB,EAAE,UAAU,CAAC;IAC7B,iBAAiB,EAAE,UAAU,CAAC;IAC9B,kBAAkB,EAAE,UAAU,CAAC;IAC/B,gBAAgB,EAAE,UAAU,CAAC;CAC9B,CAAC;AAEF,KAAK,sBAAsB,GAAG,MAAM,iBAAiB,CAAC;AACtD,KAAK,yBAAyB,GAAG,OAAO,CACtC,MAAM,CAAC,sBAAsB,EAAE,0BAA0B,CAAC,CAC3D,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,qBAAqB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,MAAM,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAkBuB,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,cAAc,CAAC;AA2RxD,wBAAgB,sBAAsB,IAAI,oBAAoB,CA0C7D;AAID;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAO,IAE7C,CAAC;AAwBF,eAAO,MAAM,gBAAgB,EAAE,oBAY7B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/config/middleware.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAUzD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAoC9D,KAAK,iBAAiB,GAAG;IACvB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,UAAU,CAAC;IACrB,SAAS,EAAE,UAAU,CAAC;IACtB,YAAY,EAAE,UAAU,CAAC;IACzB,aAAa,EAAE,UAAU,CAAC;IAC1B,aAAa,EAAE,UAAU,CAAC;IAC1B,qBAAqB,EAAE,UAAU,CAAC;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,UAAU,CAAC;IAChB,WAAW,EAAE,UAAU,CAAC;IACxB,aAAa,EAAE,UAAU,CAAC;IAC1B,gBAAgB,EAAE,UAAU,CAAC;IAC7B,iBAAiB,EAAE,UAAU,CAAC;IAC9B,kBAAkB,EAAE,UAAU,CAAC;IAC/B,gBAAgB,EAAE,UAAU,CAAC;CAC9B,CAAC;AAEF,KAAK,sBAAsB,GAAG,MAAM,iBAAiB,CAAC;AACtD,KAAK,yBAAyB,GAAG,OAAO,CACtC,MAAM,CAAC,sBAAsB,EAAE,0BAA0B,CAAC,CAC3D,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,qBAAqB,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,UAAU,CAAC,EAAE,yBAAyB,CAAC;IACvC,MAAM,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EAkBuB,CAAC;AAEnD,MAAM,MAAM,mCAAmC,GAAG,aAAa,MAAM,IAAI,MAAM,EAAE,CAAC;AAElF,KAAK,mBAAmB,GAAG,MAAM,OAAO,cAAc,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,mCAAmC,CAAC;AAyBtF,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,KAAK,IAAI,aAI9D,CAAC;AAuUF,wBAAgB,sBAAsB,IAAI,oBAAoB,CA4C7D;AAID;;;GAGG;AACH,eAAO,MAAM,0BAA0B,QAAO,IAE7C,CAAC;AAwBF,eAAO,MAAM,gBAAgB,EAAE,oBAY7B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/src/config/middleware.js

@@ -40,6 +40,24 @@ export const MiddlewareKeys = Object.freeze({
     validateUserUpdate: true,
     validateUserFill: true,
 });
+const parseParameterizedRateLimitKey = (value) => {
+    const match = /^rateLimit:(\d+):(\d+(?:\.\d+)?)$/.exec(value.trim());
+    if (!match)
+        return undefined;
+    const max = Number.parseInt(match[1] ?? '', 10);
+    const windowMinutes = Number.parseFloat(match[2] ?? '');
+    if (!Number.isInteger(max) || max < 1)
+        return undefined;
+    if (!Number.isFinite(windowMinutes) || windowMinutes <= 0)
+        return undefined;
+    const windowMs = Math.round(windowMinutes * 60_000);
+    if (!Number.isFinite(windowMs) || windowMs < 1)
+        return undefined;
+    return Object.freeze({ max, windowMs });
+};
+export const isKnownMiddlewareName = (value) => {
+    return (Object.hasOwn(MiddlewareKeys, value) || parseParameterizedRateLimitKey(value) !== undefined);
+};
 // Ensure `ValidationMiddleware` is strongly typed here to avoid `error`-typed values
 // triggering `@typescript-eslint/no-unsafe-*` rules.
 const Validation = ValidationMiddleware;
@@ -207,6 +225,42 @@ const applySharedMiddlewareOverrides = (shared, projectRoute) => {
     }
     return Object.freeze(overridden);
 };
+const createRouteMiddlewareRegistry = (resolvedShared, projectRoute, responders) => {
+    const target = Object.freeze({
+        ...resolvedShared,
+        ...projectRoute,
+    });
+    const dynamicRateLimits = new Map();
+    return new Proxy(target, {
+        get(currentTarget, prop, receiver) {
+            if (typeof prop !== 'string') {
+                return Reflect.get(currentTarget, prop, receiver);
+            }
+            const resolved = currentTarget[prop];
+            if (typeof resolved === 'function')
+                return resolved;
+            const cached = dynamicRateLimits.get(prop);
+            if (cached !== undefined)
+                return cached;
+            const parsed = parseParameterizedRateLimitKey(prop);
+            if (parsed === undefined)
+                return undefined;
+            const middleware = RateLimiter.create({
+                max: parsed.max,
+                windowMs: parsed.windowMs,
+                onFailure: responders.rateLimit,
+            });
+            dynamicRateLimits.set(prop, middleware);
+            return middleware;
+        },
+        ownKeys(currentTarget) {
+            return Reflect.ownKeys(currentTarget);
+        },
+        getOwnPropertyDescriptor(currentTarget, prop) {
+            return Reflect.getOwnPropertyDescriptor(currentTarget, prop);
+        },
+    });
+};
 export function createMiddlewareConfig() {
     const loadMiddlewareConfig = StartupConfigFileRegistry.get(StartupConfigFile.Middleware) ?? {};
     const skipPathsFromEnv = Env.get('CSRF_SKIP_PATHS', '')
@@ -224,6 +278,7 @@ export function createMiddlewareConfig() {
     const projectGlobal = resolveProjectGlobalMiddlewares(effectiveMiddlewareConfig);
     const projectRoute = resolveProjectRouteMiddlewares(effectiveMiddlewareConfig);
     const resolvedShared = applySharedMiddlewareOverrides(shared, projectRoute);
+    const routeMiddlewareRegistry = createRouteMiddlewareRegistry(resolvedShared, projectRoute, responders);
     const middlewareConfigObj = {
         global: [
             resolvedShared.log,
@@ -236,10 +291,7 @@ export function createMiddlewareConfig() {
             resolvedShared.sanitizeBody,
             ...projectGlobal,
         ],
-        route: {
-            ...resolvedShared,
-            ...projectRoute,
-        },
+        route: routeMiddlewareRegistry,
     };
     return Object.freeze(middlewareConfigObj);
 }

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.31
+ * @zintrust/core v0.4.33
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-29T12:34:52.815Z
+ *   Built: 2026-03-29T18:23:05.480Z
  *   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-29T12:34:52.781Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-29T18:23:05.446Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/proxy/kv/ZintrustKvProxy.js

@@ -89,7 +89,7 @@ const verifySignedRequest = async (request, env, bodyBytes) => {
         body: bodyBytes,
         headers: request.headers,
         windowMs,
-        getSecretForKeyId: async (_keyId) => secret,
+        getSecretForKeyId: (_keyId) => secret,
         verifyNonce: env.ZT_NONCES === undefined
             ? undefined
             : async (keyId, nonce, ttlMs) => verifyNonceKv(env.ZT_NONCES, keyId, nonce, ttlMs),

package/src/templates/project/basic/src/boot/bootstrap.ts.tpl

@@ -0,0 +1,3 @@
+import '@zintrust/core/boot';
+
+export {};