@zintrust/core 0.4.30 → 0.4.32

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/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.30
+ * @zintrust/core v0.4.32
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-29T12:25:46.484Z
+ *   Built: 2026-03-29T15:48:46.014Z
  *   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:25:46.451Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-29T15:48:45.972Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/proxy/d1/ZintrustD1Proxy.d.ts

@@ -1,3 +1,48 @@
-export declare const ZintrustD1Proxy: Record<string, unknown>;
+type KvGetType = 'text' | 'json' | 'arrayBuffer';
+type KVNamespacePutOptions = {
+    expirationTtl?: number;
+};
+type KVNamespace = {
+    get: {
+        (key: string): Promise<string | null>;
+        (key: string, type: 'json'): Promise<Record<string, unknown> | null>;
+        (key: string, type: 'arrayBuffer'): Promise<ArrayBuffer | null>;
+        (key: string, type: KvGetType): Promise<Record<string, unknown> | ArrayBuffer | string | null>;
+    };
+    put: (key: string, value: string, options?: KVNamespacePutOptions) => Promise<void>;
+};
+type D1AllResult<T> = {
+    results?: T[];
+};
+type D1RunResult = {
+    meta?: unknown;
+};
+type D1PreparedStatement = {
+    bind: (...values: unknown[]) => D1PreparedStatement;
+    all: <T = unknown>() => Promise<D1AllResult<T>>;
+    first: <T = unknown>() => Promise<T | null>;
+    run: () => Promise<D1RunResult>;
+};
+type D1Database = {
+    prepare: (sql: string) => D1PreparedStatement;
+};
+type D1Env = {
+    DB?: D1Database;
+    D1_BINDING?: string;
+    APP_KEY?: string;
+    D1_REMOTE_SECRET?: string;
+    ZT_PROXY_SIGNING_WINDOW_MS?: string;
+    ZT_NONCES?: KVNamespace;
+    ZT_PROXY_DEBUG?: string;
+    ZT_MAX_BODY_BYTES?: string;
+    ZT_MAX_SQL_BYTES?: string;
+    ZT_MAX_PARAMS?: string;
+    ZT_D1_STATEMENTS_JSON?: string;
+};
+export declare const ZintrustD1Proxy: Readonly<{
+    _ZINTRUST_CLOUDFLARE_D1_PROXY_VERSION: "0.1.15";
+    _ZINTRUST_CLOUDFLARE_D1_PROXY_BUILD_DATE: "__BUILD_DATE__";
+    fetch(request: Request, env: D1Env): Promise<Response>;
+}>;
 export default ZintrustD1Proxy;
 //# sourceMappingURL=ZintrustD1Proxy.d.ts.map

package/src/proxy/d1/ZintrustD1Proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZintrustD1Proxy.d.ts","sourceRoot":"","sources":["../../../../src/proxy/d1/ZintrustD1Proxy.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,eAAe,EAyBZ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExC,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ZintrustD1Proxy.d.ts","sourceRoot":"","sources":["../../../../src/proxy/d1/ZintrustD1Proxy.ts"],"names":[],"mappings":"AAMA,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAEjD,KAAK,qBAAqB,GAAG;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,GAAG,EAAE;QACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;KAChG,CAAC;IACF,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF,CAAC;AAEF,KAAK,WAAW,CAAC,CAAC,IAAI;IACpB,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;CACf,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,mBAAmB,CAAC;IACpD,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5C,GAAG,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,mBAAmB,CAAC;CAC/C,CAAC;AAEF,KAAK,KAAK,GAAG;IACX,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAkZF,eAAO,MAAM,eAAe;;;mBAGL,OAAO,OAAO,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;EAqB5D,CAAC;AAEH,eAAe,eAAe,CAAC"}