@zintrust/core 0.4.27 → 0.4.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.27",
+  "version": "0.4.29",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -34,6 +34,10 @@
       "types": "./src/proxy.d.ts",
       "import": "./src/proxy.js"
     },
+    "./proxy/*": {
+      "types": "./src/proxy/*.d.ts",
+      "import": "./src/proxy/*.js"
+    },
     "./collections": {
       "types": "./src/collections/index.d.ts",
       "import": "./src/collections/index.js"

package/src/cli/CLI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AAsPD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}
+{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AAwPD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}

package/src/cli/CLI.js

@@ -11,6 +11,7 @@ import { ContainerWorkersCommand } from './commands/ContainerWorkersCommand.js';
 import { AddMigrationCommand, CreateCommand, CreateMigrationCommand, } from './commands/CreateCommand.js';
 import { D1LearnCommand } from './commands/D1LearnCommand.js';
 import { D1MigrateCommand } from './commands/D1MigrateCommand.js';
+import { D1ProxyCommand } from './commands/D1ProxyCommand.js';
 import { DbSeedCommand } from './commands/DbSeedCommand.js';
 import { DebugCommand } from './commands/DebugCommand.js';
 import { DeployCommand } from './commands/DeployCommand.js';
@@ -28,6 +29,7 @@ import { InitProducerCommand } from './commands/InitProducerCommand.js';
 import { InitProxyCommand } from './commands/InitProxyCommand.js';
 import { JwtDevCommand } from './commands/JwtDevCommand.js';
 import { KeyGenerateCommand } from './commands/KeyGenerateCommand.js';
+import { KvProxyCommand } from './commands/KvProxyCommand.js';
 import { MakeMailTemplateCommand } from './commands/MakeMailTemplateCommand.js';
 import { MakeNotificationTemplateCommand } from './commands/MakeNotificationTemplateCommand.js';
 import { MigrateCommand } from './commands/MigrateCommand.js';
@@ -128,6 +130,8 @@ const buildCommandRegistry = () => {
         RoutesCommand.create(),
         JwtDevCommand,
         ProxyCommand.create(),
+        D1ProxyCommand.create(),
+        KvProxyCommand.create(),
         MySqlProxyCommand.create(),
         PostgresProxyCommand.create(),
         MongoDBProxyCommand.create(),

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

@@ -0,0 +1,6 @@
+import type { IBaseCommand } from '../BaseCommand';
+export declare const D1ProxyCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export default D1ProxyCommand;
+//# sourceMappingURL=D1ProxyCommand.d.ts.map

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

@@ -0,0 +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;AA4PrE,eAAO,MAAM,cAAc;cACf,YAAY;EAwCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cli/commands/D1ProxyCommand.js

@@ -0,0 +1,229 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { maybeRunProxyWatchMode } from '../commands/ProxyCommandUtils.js';
+import { SpawnUtil } from '../utils/spawn.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';
+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 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', '')) ??
+            findQuotedValue(fileContent, 'D1_BINDING') ??
+            findQuotedValue(fileContent, 'binding') ??
+            DEFAULT_BINDING,
+        databaseName: trimOption(options.databaseName) ??
+            trimOption(Env.get('D1_DATABASE_NAME', '')) ??
+            findQuotedValue(fileContent, 'database_name') ??
+            DEFAULT_DATABASE_NAME,
+        databaseId: trimOption(options.databaseId) ??
+            trimOption(Env.get('D1_DATABASE_ID', '')) ??
+            findQuotedValue(fileContent, 'database_id') ??
+            DEFAULT_DATABASE_ID,
+        migrationsDir: trimOption(options.migrationsDir) ??
+            findQuotedValue(fileContent, 'migrations_dir') ??
+            DEFAULT_MIGRATIONS_DIR,
+    };
+};
+const renderD1ProxyEnvBlock = (values) => {
+    return [
+        '    "d1-proxy": {',
+        '      "name": "zintrust-d1-proxy",',
+        '      "main": "./src/proxy/d1/ZintrustD1Proxy.ts",',
+        '      "compatibility_flags": ["nodejs_compat"],',
+        `      "compatibility_date": "${DEFAULT_COMPATIBILITY_DATE}",`,
+        '      "vars": {',
+        `        "D1_BINDING": "${values.binding}",`,
+        '        "ZT_PROXY_SIGNING_WINDOW_MS": "60000",',
+        '        "ZT_MAX_BODY_BYTES": "131072",',
+        '        "ZT_MAX_SQL_BYTES": "32768",',
+        '        "ZT_MAX_PARAMS": "256",',
+        '        "NODE_ENV": "development",',
+        String.raw `        "ZT_D1_STATEMENTS_JSON": "{\"health\":\"select 1 as ok\"}"`,
+        '      },',
+        '      "d1_databases": [',
+        '        {',
+        `          "binding": "${values.binding}",`,
+        `          "database_name": "${values.databaseName}",`,
+        `          "database_id": "${values.databaseId}",`,
+        `          "migrations_dir": "${values.migrationsDir}"`,
+        '        }',
+        '      ]',
+        '    }',
+    ].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 '../../proxy.js';",
+        "export { ZintrustD1Proxy as default } from '../../proxy.js';",
+        '',
+    ].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');
+    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');
+    command.option('--migrations-dir <path>', 'Cloudflare D1 migrations directory', DEFAULT_MIGRATIONS_DIR);
+};
+export const D1ProxyCommand = Object.freeze({
+    create() {
+        return BaseCommand.create({
+            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',
+            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);
+                }
+            },
+        });
+    },
+});
+export default D1ProxyCommand;

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

@@ -1 +1 @@
-{"version":3,"file":"InitContainerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/InitContainerCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqSlE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAqBtB,CAAC"}
+{"version":3,"file":"InitContainerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/InitContainerCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA8MlE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAqBtB,CAAC"}

package/src/cli/commands/InitContainerCommand.js

@@ -6,15 +6,14 @@ import { join } from '../../node-singletons/path.js';
 const DOCKER_COMPOSE_WORKERS_TEMPLATE = `name: zintrust-workers
 
 services:
-  # Workers/Jobs API Service (Port 7772)
-  # Exposes the Workers API to create/manage jobs using the project worker overlay image.
+  # Worker runtime service (Port 7772)
+  # Boots the full ZinTrust server so the worker pages stay reachable while workers auto-start.
   workers-api:
     image: \${WORKERS_IMAGE:-zintrust-workers-local:latest}
     build:
       context: .
       dockerfile: Dockerfile.workers
-      target: runtime
-    command: ["node", "--experimental-specifier-resolution=node", "dist/src/boot/bootstrap.js"]
+      target: worker
     environment:
       # Runtime
       - NODE_ENV=\${NODE_ENV:-development}
@@ -29,8 +28,8 @@ services:
       - LOG_LEVEL=\${LOG_LEVEL:-info}
 
       # Workers & Queue
-      - WORKER_ENABLED=\${WORKER_ENABLED:-false}
-      - WORKER_AUTO_START=\${WORKER_AUTO_START:-false}
+  - WORKER_ENABLED=\${WORKER_ENABLED:-true}
+  - WORKER_AUTO_START=\${WORKER_AUTO_START:-true}
       - QUEUE_ENABLED=true
       - QUEUE_MONITOR_ENABLED=\${QUEUE_MONITOR_ENABLED:-false}
       - QUEUE_MONITOR_MIDDLEWARE=\${QUEUE_MONITOR_MIDDLEWARE:-}
@@ -96,92 +95,6 @@ services:
     ports:
       - '7772:7772'
 
-  # Dedicated background worker runner.
-  # Uses the same project overlay image but boots the worker target.
-  worker-runner:
-    image: \${WORKERS_RUNNER_IMAGE:-zintrust-workers-local:latest}
-    build:
-      context: .
-      dockerfile: Dockerfile.workers
-      target: worker
-    environment:
-      # Runtime
-      - NODE_ENV=\${NODE_ENV:-development}
-      - HOST=0.0.0.0
-
-      # Application
-      - APP_NAME=\${APP_NAME:-ZinTrust}
-      - APP_KEY=\${APP_KEY}
-      - ENCRYPTION_CIPHER=\${ENCRYPTION_CIPHER:-aes-256-cbc}
-      - LOG_LEVEL=\${LOG_LEVEL:-info}
-
-      # Workers & Queue
-      - DOCKER_WORKER=true
-      - WORKER_ENABLED=\${WORKER_ENABLED:-true}
-      - WORKER_AUTO_START=\${WORKER_AUTO_START:-true}
-      - QUEUE_ENABLED=true
-      - QUEUE_MONITOR_ENABLED=\${QUEUE_MONITOR_ENABLED:-false}
-      - QUEUE_MONITOR_MIDDLEWARE=\${QUEUE_MONITOR_MIDDLEWARE:-}
-      - WORKER_PERSISTENCE_DRIVER=\${WORKER_PERSISTENCE_DRIVER:-redis}
-      - WORKER_PERSISTENCE_DB_CONNECTION=\${WORKER_PERSISTENCE_DB_CONNECTION:-mysql}
-      - WORKER_PERSISTENCE_REDIS_KEY_PREFIX=\${WORKER_PERSISTENCE_REDIS_KEY_PREFIX}
-      - QUEUE_DRIVER=\${QUEUE_DRIVER:-redis}
-      - QUEUE_CONNECTION=\${QUEUE_CONNECTION:-redis}
-      - CACHE_DRIVER=\${CACHE_DRIVER:-redis}
-
-      # Redis
-      - REDIS_HOST=\${DOCKER_REDIS_HOST:-host.docker.internal}
-      - REDIS_PORT=\${REDIS_PORT:-6379}
-      - REDIS_PASSWORD=\${REDIS_PASSWORD}
-      - REDIS_QUEUE_DB=\${REDIS_QUEUE_DB:-1}
-
-      # Database
-      - DB_CONNECTION=\${DB_CONNECTION:-postgres}
-      - DB_HOST=\${DOCKER_DB_HOST:-host.docker.internal}
-      - DB_PORT=\${DB_PORT:-3306}
-      - DB_DATABASE=\${DB_DATABASE:-zintrust}
-      - DB_USERNAME=\${DB_USERNAME:-zintrust}
-      - DB_PASSWORD=\${DB_PASSWORD:-}
-
-      # SMTP Mail
-      - MAIL_DRIVER=\${MAIL_DRIVER:-smtp}
-      - MAIL_CONNECTION=\${MAIL_CONNECTION:-smtp}
-      - MAIL_HOST=\${MAIL_HOST}
-      - MAIL_PORT=\${MAIL_PORT:-587}
-      - MAIL_SECURE=\${MAIL_SECURE:-false}
-      - MAIL_USERNAME=\${MAIL_USERNAME}
-      - MAIL_PASSWORD=\${MAIL_PASSWORD}
-      - MAIL_FROM_ADDRESS=\${MAIL_FROM_ADDRESS}
-      - MAIL_FROM_NAME=\${MAIL_FROM_NAME:-ZinTrust}
-
-      # PostgreSQL
-      - DB_PORT_POSTGRESQL=\${DB_PORT_POSTGRESQL:-5432}
-      - DB_DATABASE_POSTGRESQL=\${DB_DATABASE_POSTGRESQL:-zintrust}
-      - DB_USERNAME_POSTGRESQL=\${DB_USERNAME_POSTGRESQL:-zintrust}
-      - DB_PASSWORD_POSTGRESQL=\${DB_PASSWORD_POSTGRESQL:-}
-
-      # MySQL
-      - DB_PORT_MYSQL=\${DB_PORT_MYSQL:-3306}
-      - DB_DATABASE_MYSQL=\${DB_DATABASE_MYSQL:-zintrust}
-      - DB_USERNAME_MYSQL=\${DB_USERNAME_MYSQL:-zintrust}
-      - DB_PASSWORD_MYSQL=\${DB_PASSWORD_MYSQL:-}
-
-      # Cloudflare D1
-      - D1_DATABASE_ID=\${D1_DATABASE_ID}
-      - D1_ACCOUNT_ID=\${D1_ACCOUNT_ID}
-      - D1_API_TOKEN=\${D1_API_TOKEN}
-      - D1_REMOTE_URL=\${D1_REMOTE_URL}
-      - D1_REMOTE_KEY_ID=\${D1_REMOTE_KEY_ID}
-      - D1_REMOTE_SECRET=\${D1_REMOTE_SECRET}
-
-      # Cloudflare KV
-      - KV_NAMESPACE_ID=\${KV_NAMESPACE_ID}
-      - KV_ACCOUNT_ID=\${KV_ACCOUNT_ID}
-      - KV_API_TOKEN=\${KV_API_TOKEN}
-      - KV_REMOTE_URL=\${KV_REMOTE_URL}
-      - KV_REMOTE_KEY_ID=\${KV_REMOTE_KEY_ID}
-      - KV_REMOTE_SECRET=\${KV_REMOTE_SECRET}
-
 `;
 const DOCKERFILE_TEMPLATE = String.raw `# Multi-stage worker overlay image.
 #
@@ -229,15 +142,15 @@ COPY --from=worker-overlay --chown=nodejs:nodejs /overlay/dist/ /app/dist/
 
 FROM runtime AS worker
 
-ENV DOCKER_WORKER=true
 ENV WORKER_ENABLED=true
 ENV WORKER_AUTO_START=true
 ENV QUEUE_ENABLED=true
-ENV PORT=0
+ENV HOST=0.0.0.0
+ENV PORT=7772
 
 HEALTHCHECK NONE
 
-CMD ["node", "dist/bin/zin.js", "worker:start-all"]
+CMD ["node", "--experimental-specifier-resolution=node", "dist/src/boot/bootstrap.js"]
 `;
 const backupSuffix = () => new Date().toISOString().replaceAll(/[:.]/g, '-');
 const backupFileIfExists = (filePath) => {
@@ -290,7 +203,7 @@ export const InitContainerCommand = Object.freeze({
                 await writeDockerfile(cwd);
                 Logger.info('✅ Container worker scaffolding complete.');
                 Logger.info('Run with: docker compose -f docker-compose.workers.yml up');
-                Logger.info('Build worker runner with: docker build -f Dockerfile.workers --target worker .');
+                Logger.info('Build worker runtime with: docker build -f Dockerfile.workers --target worker .');
                 await Promise.resolve();
             },
         });

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

@@ -0,0 +1,6 @@
+import type { IBaseCommand } from '../BaseCommand';
+export declare const KvProxyCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export default KvProxyCommand;
+//# sourceMappingURL=KvProxyCommand.d.ts.map

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

@@ -0,0 +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;AAyOrE,eAAO,MAAM,cAAc;cACf,YAAY;EAwCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cli/commands/KvProxyCommand.js

@@ -0,0 +1,217 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { maybeRunProxyWatchMode } from '../commands/ProxyCommandUtils.js';
+import { SpawnUtil } from '../utils/spawn.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 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', '')) ??
+        findQuotedValue(fileContent, 'preview_id') ??
+        findQuotedValue(fileContent, 'id') ??
+        DEFAULT_NAMESPACE_ID;
+    return {
+        binding: trimOption(options.binding) ??
+            trimOption(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', '')) ??
+            findQuotedValue(fileContent, 'preview_id') ??
+            namespaceId,
+    };
+};
+const renderKvProxyEnvBlock = (values) => {
+    return [
+        '    "kv-proxy": {',
+        '      "name": "zintrust-kv-proxy",',
+        '      "main": "./src/proxy/kv/ZintrustKvProxy.ts",',
+        '      "compatibility_flags": ["nodejs_compat"],',
+        `      "compatibility_date": "${DEFAULT_COMPATIBILITY_DATE}",`,
+        '      "vars": {',
+        `        "KV_NAMESPACE": "${values.binding}",`,
+        '        "NODE_ENV": "development"',
+        '      },',
+        '      "kv_namespaces": [',
+        '        {',
+        `          "binding": "${values.binding}",`,
+        `          "id": "${values.namespaceId}",`,
+        `          "preview_id": "${values.previewId}",`,
+        '          "remote": false',
+        '        }',
+        '      ]',
+        '    }',
+    ].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 '../../proxy.js';",
+        "export { ZintrustKvProxy as default } from '../../proxy.js';",
+        '',
+    ].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');
+    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({
+            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',
+            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);
+                }
+            },
+        });
+    },
+});
+export default KvProxyCommand;

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/commands/ProxyCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMrE,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,0BAA0B,CAAC;AAClC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AAyD9B,eAAO,MAAM,YAAY;cACb,YAAY;EAyBtB,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"ProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMrE,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,0BAA0B,CAAC;AAClC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AA2D9B,eAAO,MAAM,YAAY;cACb,YAAY;EAyBtB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/src/cli/commands/ProxyCommand.js

@@ -10,6 +10,8 @@ import '../../proxy/postgres/register.js';
 import '../../proxy/redis/register.js';
 import '../../proxy/smtp/register.js';
 const PROXY_TARGET_MAP = Object.freeze({
+    d1: 'proxy:d1',
+    kv: 'proxy:kv',
     mysql: 'proxy:mysql',
     my: 'proxy:mysql',
     postgres: 'proxy:postgres',

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

@@ -6,8 +6,10 @@ export { BroadcastWorkCommand } from '../commands/BroadcastWorkCommand';
 export { ConfigCommand } from '../commands/ConfigCommand';
 export { ContainerWorkersCommand } from '../commands/ContainerWorkersCommand';
 export { AddMigrationCommand, CreateCommand, CreateMigrationCommand, } from '../commands/CreateCommand';
+export { D1ProxyCommand } from '../commands/D1ProxyCommand';
 export { DebugCommand } from '../commands/DebugCommand';
 export { JwtDevCommand } from '../commands/JwtDevCommand';
+export { KvProxyCommand } from '../commands/KvProxyCommand';
 export { LogsCleanupCommand } from '../commands/LogsCleanupCommand';
 export { MakeMailTemplateCommand } from '../commands/MakeMailTemplateCommand';
 export { MakeNotificationTemplateCommand } from '../commands/MakeNotificationTemplateCommand';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,+CAA+C,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,+CAA+C,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/src/cli/commands/index.js

@@ -6,8 +6,10 @@ export { BroadcastWorkCommand } from '../commands/BroadcastWorkCommand.js';
 export { ConfigCommand } from '../commands/ConfigCommand.js';
 export { ContainerWorkersCommand } from '../commands/ContainerWorkersCommand.js';
 export { AddMigrationCommand, CreateCommand, CreateMigrationCommand, } from '../commands/CreateCommand.js';
+export { D1ProxyCommand } from '../commands/D1ProxyCommand.js';
 export { DebugCommand } from '../commands/DebugCommand.js';
 export { JwtDevCommand } from '../commands/JwtDevCommand.js';
+export { KvProxyCommand } from '../commands/KvProxyCommand.js';
 export { LogsCleanupCommand } from '../commands/LogsCleanupCommand.js';
 export { MakeMailTemplateCommand } from '../commands/MakeMailTemplateCommand.js';
 export { MakeNotificationTemplateCommand } from '../commands/MakeNotificationTemplateCommand.js';

package/src/cli/index.d.ts

@@ -8,7 +8,9 @@ export { EXIT_CODES, ErrorHandler } from './ErrorHandler';
 export { PromptHelper, type PromptOptions } from './PromptHelper';
 export { AddCommand } from './commands/AddCommand';
 export { ConfigCommand } from './commands/ConfigCommand';
+export { D1ProxyCommand } from './commands/D1ProxyCommand';
 export { DebugCommand } from './commands/DebugCommand';
+export { KvProxyCommand } from './commands/KvProxyCommand';
 export { MigrateCommand } from './commands/MigrateCommand';
 export { MySqlProxyCommand } from './commands/MySqlProxyCommand';
 export { NewCommand } from './commands/NewCommand';

package/src/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/src/cli/index.js

@@ -9,7 +9,9 @@ export { PromptHelper } from './PromptHelper.js';
 // Export commands
 export { AddCommand } from './commands/AddCommand.js';
 export { ConfigCommand } from './commands/ConfigCommand.js';
+export { D1ProxyCommand } from './commands/D1ProxyCommand.js';
 export { DebugCommand } from './commands/DebugCommand.js';
+export { KvProxyCommand } from './commands/KvProxyCommand.js';
 export { MigrateCommand } from './commands/MigrateCommand.js';
 export { MySqlProxyCommand } from './commands/MySqlProxyCommand.js';
 export { NewCommand } from './commands/NewCommand.js';

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;AAmBH,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;AA8RH,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

@@ -6,6 +6,7 @@
  * - Architecture tests (Vitest)
  */
 import { FileGenerator } from '../scaffolding/FileGenerator.js';
+import { VersionChecker } from '../services/VersionChecker.js';
 import { SpawnUtil } from '../utils/spawn.js';
 import { resolvePackageManager } from '../../common/index.js';
 import { Logger } from '../../config/logger.js';
@@ -49,12 +50,55 @@ 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() !== '')
-        return core;
-    return '^0.1.0';
+    if (typeof core === 'string' && core.trim() !== '') {
+        const compatibleFromCore = toCompatibleGovernanceVersion(core);
+        if (compatibleFromCore !== undefined)
+            return compatibleFromCore;
+    }
+    const currentVersion = VersionChecker.getCurrentVersion().trim();
+    if (currentVersion !== '' && currentVersion !== '0.0.0') {
+        const compatibleFromCli = toCompatibleGovernanceVersion(currentVersion);
+        if (compatibleFromCli !== undefined)
+            return compatibleFromCli;
+    }
+    return '^0.4.0';
 };
 const writeEslintConfig = (projectRoot) => {
     const eslintConfigPath = path.join(projectRoot, 'eslint.config.mjs');

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;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;AA6ID;;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,6 +20,40 @@ 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)) {
@@ -239,11 +273,11 @@ const readTemplateJson = (templateJsonPath) => {
     }
 };
 const resolveTemplateMetadata = (templateName, meta, fallback) => {
-    const name = typeof meta.name === 'string' ? meta.name : fallback?.name ?? templateName;
-    const description = typeof meta.description === 'string' ? meta.description : fallback?.description ?? '';
+    const name = typeof meta.name === 'string' ? meta.name : (fallback?.name ?? templateName);
+    const description = typeof meta.description === 'string' ? meta.description : (fallback?.description ?? '');
     const directories = Array.isArray(meta.directories)
         ? coerceStringArray(meta.directories)
-        : fallback?.directories ?? [];
+        : (fallback?.directories ?? []);
     return { name, description, directories };
 };
 const loadTemplateFiles = (templateDir) => {
@@ -451,6 +485,8 @@ const prepareContext = (state, options) => {
         .replaceAll(/[-:T.Z]/g, '')
         .slice(0, 14);
     state.variables = {
+        coreVersion: loadCoreVersion(),
+        governanceVersion: toCompatibleGovernanceVersion(loadCoreVersion()),
         projectName: options.name,
         projectSlug: options.name,
         author: options.author ?? 'Your Name',
@@ -459,7 +495,6 @@ const prepareContext = (state, options) => {
         database: options.database ?? 'sqlite',
         template: state.templateName,
         migrationTimestamp,
-        coreVersion: loadCoreVersion(),
     };
 };
 const createDirectoriesForState = (state) => {

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`.
-     * This is intended for local dev/simulate apps, not publishing.
+     * 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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DistPackager.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/DistPackager.ts"],"names":[],"mappings":"AAsLA,eAAO,MAAM,YAAY;IACvB;;;OAGG;sBACe,MAAM,aAAY,MAAM,GAAmB,IAAI;EAgBjE,CAAC"}
+{"version":3,"file":"DistPackager.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/DistPackager.ts"],"names":[],"mappings":"AAmKA,eAAO,MAAM,YAAY;IACvB;;;OAGG;sBACe,MAAM,aAAY,MAAM,GAAmB,IAAI;EAgBjE,CAAC"}

package/src/cli/utils/DistPackager.js

@@ -30,7 +30,6 @@ const buildDistPackageJson = (rootPkg) => {
     return {
         name,
         version,
-        private: true,
         type: 'module',
         main: './index.js',
         types: './index.d.ts',
@@ -57,6 +56,10 @@ const buildDistPackageJson = (rootPkg) => {
                 types: './src/proxy.d.ts',
                 default: './src/proxy.js',
             },
+            './proxy/*': {
+                types: './src/proxy/*.d.ts',
+                default: './src/proxy/*.js',
+            },
             './collections': {
                 types: './src/collections/index.d.ts',
                 default: './src/collections/index.js',
@@ -76,6 +79,9 @@ const buildDistPackageJson = (rootPkg) => {
             './package.json': './package.json',
         },
         dependencies: coerceDependencies(rootPkg.dependencies),
+        publishConfig: {
+            access: 'public',
+        },
     };
 };
 const writeDistEntrypoints = (distPath) => {
@@ -110,8 +116,8 @@ const warnIfMissingDistArtifacts = (distPath) => {
 };
 export const DistPackager = Object.freeze({
     /**
-     * Creates minimal metadata so `dist/` can be installed via `file:/.../dist`.
-     * This is intended for local dev/simulate apps, not publishing.
+     * 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.27
+ * @zintrust/core v0.4.29
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-28T14:15:33.465Z
+ *   Built: 2026-03-29T12:19:31.273Z
  *   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-28T14:15:33.427Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-29T12:19:31.239Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/proxy.d.ts

@@ -1,4 +1,6 @@
 export { ErrorHandler } from './proxy/ErrorHandler';
 export { RequestValidator } from './proxy/RequestValidator';
 export { SigningService } from './proxy/SigningService';
+export { ZintrustD1Proxy } from './proxy/d1/ZintrustD1Proxy';
+export { ZintrustKvProxy } from './proxy/kv/ZintrustKvProxy';
 //# sourceMappingURL=proxy.d.ts.map

package/src/proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}

package/src/proxy.js

@@ -1,3 +1,5 @@
 export { ErrorHandler } from './proxy/ErrorHandler.js';
 export { RequestValidator } from './proxy/RequestValidator.js';
 export { SigningService } from './proxy/SigningService.js';
+export { ZintrustD1Proxy } from './proxy/d1/ZintrustD1Proxy.js';
+export { ZintrustKvProxy } from './proxy/kv/ZintrustKvProxy.js';

package/src/templates/project/basic/package.json.tpl

@@ -13,7 +13,7 @@
   "dependencies": {
     "@zintrust/core": "^{{coreVersion}}",
     "@zintrust/d1-migrator": "^0.4.6",
-    "@zintrust/governance": "^0.1.25"
+    "@zintrust/governance": "{{governanceVersion}}"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",