@zintrust/core 0.1.43 → 0.1.46

package/src/cli/commands/DockerPushCommand.js

@@ -0,0 +1,92 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { VersionChecker } from '../services/VersionChecker.js';
+import { SpawnUtil } from '../utils/spawn.js';
+import { Logger } from '../../config/logger.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+const parsePlatforms = (value) => {
+    const raw = (value ?? '').trim();
+    if (raw !== '')
+        return raw;
+    return 'linux/amd64,linux/arm64';
+};
+const parseTag = (value) => {
+    const raw = (value ?? '').trim();
+    if (raw === '') {
+        const currentVersion = VersionChecker.getCurrentVersion();
+        return currentVersion === '0.0.0' ? 'latest' : currentVersion;
+    }
+    return raw;
+};
+const resolvePublishTags = (tag, alsoLatest) => {
+    if (tag === 'latest')
+        return ['latest'];
+    if (alsoLatest === false)
+        return [tag];
+    return [tag, 'latest'];
+};
+const parseOnly = (value) => {
+    const raw = (value ?? '').trim().toLowerCase();
+    if (raw === 'runtime' || raw === 'gateway')
+        return raw;
+    return 'both';
+};
+const runPublishImages = async (options) => {
+    const tag = parseTag(options.tag);
+    const platforms = parsePlatforms(options.platforms);
+    const tags = resolvePublishTags(tag, options.alsoLatest);
+    const only = parseOnly(options.only);
+    const runtimeRepo = 'zintrust/zintrust';
+    const gatewayRepo = 'zintrust/zintrust-proxy-gateway';
+    const buildArgsFor = (repo, context) => {
+        const args = ['buildx', 'build', '--platform', platforms];
+        for (const t of tags)
+            args.push('-t', `${repo}:${t}`);
+        args.push('--push', context);
+        return args;
+    };
+    Logger.info('Publishing images to Docker Hub via buildx...', {
+        runtime: runtimeRepo,
+        gateway: gatewayRepo,
+        platforms,
+        tags,
+        only,
+    });
+    if (only === 'runtime' || only === 'both') {
+        const runtimeExit = await SpawnUtil.spawnAndWait({
+            command: 'docker',
+            args: buildArgsFor(runtimeRepo, '.'),
+            env: process.env,
+        });
+        if (runtimeExit !== 0) {
+            throw ErrorFactory.createCliError(`Failed to publish ${runtimeRepo} (exit code ${runtimeExit})`);
+        }
+    }
+    if (only === 'gateway' || only === 'both') {
+        const gatewayExit = await SpawnUtil.spawnAndWait({
+            command: 'docker',
+            args: buildArgsFor(gatewayRepo, './docker/proxy-gateway'),
+            env: process.env,
+        });
+        if (gatewayExit !== 0) {
+            throw ErrorFactory.createCliError(`Failed to publish ${gatewayRepo} (exit code ${gatewayExit})`);
+        }
+    }
+};
+export const DockerPushCommand = Object.freeze({
+    create() {
+        return BaseCommand.create({
+            name: 'docker:push',
+            aliases: ['docker-push'],
+            description: 'Build and push ZinTrust Docker images to Docker Hub',
+            addOptions: (command) => {
+                command.option('--tag <tag>', 'Docker image tag to publish. Defaults to current version and also tags :latest');
+                command.option('--platforms <list>', 'Comma-separated platforms for buildx', 'linux/amd64,linux/arm64');
+                command.option('--no-also-latest', 'When publishing a non-latest --tag, do not also push :latest');
+                command.option('--only <target>', 'Publish only one image: runtime|gateway|both', 'both');
+            },
+            execute: async (options) => {
+                await runPublishImages(options);
+            },
+        });
+    },
+});

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;AAmOlE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAkBtB,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;AAoOlE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAkBtB,CAAC"}

package/src/cli/commands/InitContainerCommand.js

@@ -9,6 +9,7 @@ services:
   # Workers/Jobs API Service (Port 7772)
   # Exposes the Workers API to create/manage jobs
   workers-api:
+    image: \${WORKERS_IMAGE:-zintrust/zintrust-workers:latest}
     build:
       context: .
       dockerfile: Dockerfile

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"InitContainersProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/InitContainersProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6JlE,eAAO,MAAM,0BAA0B;cAC3B,YAAY;EAuBtB,CAAC"}

package/src/cli/commands/InitContainersProxyCommand.js

@@ -0,0 +1,159 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { PromptHelper } from '../PromptHelper.js';
+import { Logger } from '../../config/logger.js';
+import { copyFileSync, existsSync, mkdirSync, writeFileSync } from '../../node-singletons/fs.js';
+import { join } from '../../node-singletons/path.js';
+const WRANGLER_CONTAINERS_PROXY_TEMPLATE = `/**
+ * ============================================================================
+ * ZinTrust Cloudflare Containers Proxy
+ * ============================================================================
+ * This Worker acts as the "gateway" for the DB/KV/SMTP proxy stack.
+ *
+ * Requests are routed by path prefix:
+ *   /mysql/*     -> ZintrustMySqlProxyContainer (port 8789)
+ *   /postgres/*  -> ZintrustPostgresProxyContainer (port 8790)
+ *   /redis/*     -> ZintrustRedisProxyContainer (port 8791)
+ *   /mongodb/*   -> ZintrustMongoDbProxyContainer (port 8792)
+ *   /sqlserver/* -> ZintrustSqlServerProxyContainer (port 8793)
+ *   /smtp/*      -> ZintrustSmtpProxyContainer (port 8794)
+ *
+ * Notes:
+ * - You must install the runtime package: "@zintrust/cloudflare-containers-proxy".
+ * - Secrets should be uploaded with the same config file.
+ * ============================================================================
+ */
+
+{
+  "name": "zintrust-containers-proxy",
+  "main": "./src/containers-proxy.ts",
+
+  "compatibility_date": "2025-04-21",
+  "compatibility_flags": ["nodejs_compat"],
+
+  "workers_dev": true,
+  "minify": false,
+
+  "containers": [
+    { "class_name": "ZintrustMySqlProxyContainer", "image": "./Dockerfile", "max_instances": 10 },
+    { "class_name": "ZintrustPostgresProxyContainer", "image": "./Dockerfile", "max_instances": 10 },
+    { "class_name": "ZintrustRedisProxyContainer", "image": "./Dockerfile", "max_instances": 10 },
+    { "class_name": "ZintrustMongoDbProxyContainer", "image": "./Dockerfile", "max_instances": 10 },
+    { "class_name": "ZintrustSqlServerProxyContainer", "image": "./Dockerfile", "max_instances": 10 },
+    { "class_name": "ZintrustSmtpProxyContainer", "image": "./Dockerfile", "max_instances": 10 }
+  ],
+
+  "durable_objects": {
+    "bindings": [
+      { "name": "ZT_PROXY_MYSQL", "class_name": "ZintrustMySqlProxyContainer" },
+      { "name": "ZT_PROXY_POSTGRES", "class_name": "ZintrustPostgresProxyContainer" },
+      { "name": "ZT_PROXY_REDIS", "class_name": "ZintrustRedisProxyContainer" },
+      { "name": "ZT_PROXY_MONGODB", "class_name": "ZintrustMongoDbProxyContainer" },
+      { "name": "ZT_PROXY_SQLSERVER", "class_name": "ZintrustSqlServerProxyContainer" },
+      { "name": "ZT_PROXY_SMTP", "class_name": "ZintrustSmtpProxyContainer" }
+    ]
+  },
+
+  "migrations": [
+    {
+      "tag": "containers-proxy-v1",
+      "new_sqlite_classes": [
+        "ZintrustMySqlProxyContainer",
+        "ZintrustPostgresProxyContainer",
+        "ZintrustRedisProxyContainer",
+        "ZintrustMongoDbProxyContainer",
+        "ZintrustSqlServerProxyContainer",
+        "ZintrustSmtpProxyContainer"
+      ]
+    }
+  ],
+
+  "env": {
+    "staging": {
+      "name": "zintrust-containers-proxy-staging",
+      "minify": false,
+      "vars": {
+        "ENVIRONMENT": "staging",
+        "APP_NAME": "ZinTrust",
+        "CSRF_SKIP_PATHS": "/api/*,/queue-monitor/*"
+      },
+      // Add routes here when ready:
+      // "routes": [{ "pattern": "proxy-staging.example.com", "custom_domain": true }]
+    },
+    "production": {
+      "name": "zintrust-containers-proxy-production",
+      "minify": true,
+      "vars": {
+        "ENVIRONMENT": "production",
+        "APP_NAME": "ZinTrust",
+        "CSRF_SKIP_PATHS": "/api/*,/queue-monitor/*"
+      },
+      // Add routes here when ready:
+      // "routes": [{ "pattern": "proxy.example.com", "custom_domain": true }]
+    }
+  }
+}
+`;
+const WORKER_ENTRY_TEMPLATE = `export { default } from '@zintrust/cloudflare-containers-proxy';
+export * from '@zintrust/cloudflare-containers-proxy';
+`;
+const backupSuffix = () => new Date().toISOString().replaceAll(/[:.]/g, '-');
+const backupFileIfExists = (filePath) => {
+    if (!existsSync(filePath))
+        return;
+    const backupPath = `${filePath}.bak.${backupSuffix()}`;
+    copyFileSync(filePath, backupPath);
+    Logger.info(`🗂️ Backup created: ${backupPath}`);
+};
+async function writeWranglerConfig(cwd) {
+    const configPath = join(cwd, 'wrangler.containers-proxy.jsonc');
+    let shouldWrite = true;
+    if (existsSync(configPath)) {
+        shouldWrite = await PromptHelper.confirm('wrangler.containers-proxy.jsonc already exists. Overwrite?', false);
+    }
+    if (!shouldWrite) {
+        Logger.info('Skipped wrangler.containers-proxy.jsonc');
+        return;
+    }
+    backupFileIfExists(configPath);
+    writeFileSync(configPath, WRANGLER_CONTAINERS_PROXY_TEMPLATE);
+    Logger.info('✅ Created wrangler.containers-proxy.jsonc');
+}
+async function writeWorkerEntry(cwd) {
+    const srcDir = join(cwd, 'src');
+    const entryPath = join(srcDir, 'containers-proxy.ts');
+    if (!existsSync(srcDir)) {
+        mkdirSync(srcDir, { recursive: true });
+    }
+    let shouldWrite = true;
+    if (existsSync(entryPath)) {
+        shouldWrite = await PromptHelper.confirm('src/containers-proxy.ts already exists. Overwrite?', false);
+    }
+    if (!shouldWrite) {
+        Logger.info('Skipped src/containers-proxy.ts');
+        return;
+    }
+    backupFileIfExists(entryPath);
+    writeFileSync(entryPath, WORKER_ENTRY_TEMPLATE);
+    Logger.info('✅ Created src/containers-proxy.ts');
+}
+export const InitContainersProxyCommand = Object.freeze({
+    create() {
+        return BaseCommand.create({
+            name: 'init:containers-proxy',
+            aliases: ['init:ccp', 'init:cf-containers-proxy'],
+            description: 'Scaffold Cloudflare Containers proxy Worker (wrangler.containers-proxy.jsonc)',
+            async execute() {
+                Logger.info('Initializing Cloudflare Containers proxy scaffolding...');
+                const cwd = process.cwd();
+                await writeWranglerConfig(cwd);
+                await writeWorkerEntry(cwd);
+                Logger.info('✅ Containers proxy scaffolding complete.');
+                Logger.info('Install runtime: npm i @zintrust/cloudflare-containers-proxy');
+                Logger.info('Dev (Wrangler + Docker): zin docker --wrangler-config wrangler.containers-proxy.jsonc --env staging');
+                Logger.info('Dev (short): zin dk -e staging');
+                Logger.info('Deploy (short): zin d:ccp');
+                await Promise.resolve();
+            },
+        });
+    },
+});

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

@@ -1 +1 @@
-{"version":3,"file":"PutCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/PutCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmNvF,eAAO,MAAM,UAAU;cACX,YAAY;EAWtB,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"PutCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/PutCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA0OvF,eAAO,MAAM,UAAU;cACX,YAAY;EAWtB,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/src/cli/commands/PutCommand.js

@@ -74,9 +74,14 @@ const getPutTimeoutMs = () => {
         return 120000;
     return parsed;
 };
-const putSecret = (wranglerEnv, key, value) => {
+const putSecret = (wranglerEnv, key, value, configPath) => {
     const npmPath = resolveNpmPath();
-    execFileSync(npmPath, ['exec', '--yes', '--', 'wrangler', 'secret', 'put', key, '--env', wranglerEnv], {
+    const args = ['exec', '--yes', '--', 'wrangler'];
+    if (typeof configPath === 'string' && configPath.trim().length > 0) {
+        args.push('--config', configPath.trim());
+    }
+    args.push('secret', 'put', key, '--env', wranglerEnv);
+    execFileSync(npmPath, args, {
         stdio: ['pipe', 'inherit', 'inherit'],
         input: value,
         encoding: 'utf8',
@@ -91,6 +96,7 @@ const addOptions = (command) => {
         .option('--wg <env...>', 'Wrangler environment target(s), e.g. d1-proxy kv-proxy')
         .option('--var <configKey...>', 'Config array key(s) from .zintrust.json (e.g. d1_env kv_env)')
         .option('--env_path <path>', 'Path to env file used as source values', '.env')
+        .option('-c, --config <path>', 'Wrangler config file to target (optional)')
         .option('--dry-run', 'Show what would be uploaded without calling wrangler');
 };
 const ensureCloudflareProvider = (providerRaw) => {
@@ -122,7 +128,7 @@ const reportResult = (cmd, pushed, failures) => {
         cmd.warn(`${item.key} -> ${item.wranglerEnv}: ${item.reason}`);
     }
 };
-const processPut = (cmd, wranglerEnvs, selectedKeys, envMap, dryRun) => {
+const processPut = (cmd, wranglerEnvs, selectedKeys, envMap, dryRun, configPath) => {
     let pushed = 0;
     const failures = [];
     for (const wranglerEnv of wranglerEnvs) {
@@ -135,7 +141,7 @@ const processPut = (cmd, wranglerEnvs, selectedKeys, envMap, dryRun) => {
             try {
                 if (!dryRun) {
                     cmd.info(`putting ${key} -> ${wranglerEnv}...`);
-                    putSecret(wranglerEnv, key, value);
+                    putSecret(wranglerEnv, key, value, configPath);
                 }
                 pushed += 1;
                 cmd.info(`${dryRun ? '[dry-run] ' : ''}put ${key} -> ${wranglerEnv}`);
@@ -156,7 +162,11 @@ const execute = async (cmd, options) => {
     const envMap = await EnvFile.read({ cwd, path: envFilePath });
     const wranglerEnvs = resolveWranglerEnvs(options);
     const dryRun = options.dryRun === true;
-    const result = processPut(cmd, wranglerEnvs, selectedKeys, envMap, dryRun);
+    const configPath = typeof options.config === 'string' ? options.config.trim() : '';
+    if (configPath !== '' && !existsSync(path.join(cwd, configPath))) {
+        throw ErrorFactory.createCliError(`Wrangler config not found: ${configPath}`);
+    }
+    const result = processPut(cmd, wranglerEnvs, selectedKeys, envMap, dryRun, configPath === '' ? undefined : configPath);
     reportResult(cmd, result.pushed, result.failures);
 };
 export const PutCommand = Object.freeze({

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

@@ -1 +1 @@
-{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2lBvF,eAAO,MAAM,YAAY;cACb,YAAY;EA4BtB,CAAC"}
+{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAwnBvF,eAAO,MAAM,YAAY;cACb,YAAY;EA6BtB,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -241,16 +241,29 @@ const resolveNodeProdCommand = (cwd) => {
     }
     return { command: 'node', args: [compiled] };
 };
-const executeWranglerStart = async (cmd, cwd, port, runtime, envName) => {
+const executeWranglerStart = async (cmd, cwd, port, runtime, envName, wranglerConfig) => {
     if (runtime !== undefined) {
         throw ErrorFactory.createCliError('Error: --runtime is not supported with --wrangler (Wrangler controls Workers runtime).');
     }
-    const configPath = findWranglerConfig(cwd);
+    const normalizedConfig = typeof wranglerConfig === 'string' ? wranglerConfig.trim() : '';
+    const explicitConfigFullPath = normalizedConfig.length > 0 ? path.join(cwd, normalizedConfig) : undefined;
+    const configPath = explicitConfigFullPath ?? findWranglerConfig(cwd);
     const entry = resolveWranglerEntry(cwd);
+    if (explicitConfigFullPath !== undefined) {
+        if (existsSync(explicitConfigFullPath)) {
+            // ok
+        }
+        else {
+            throw ErrorFactory.createCliError(`Error: Wrangler config not found: ${normalizedConfig}`);
+        }
+    }
     if (configPath === undefined && entry === undefined) {
         throw ErrorFactory.createCliError("Error: wrangler config not found (wrangler.toml/json). Run 'wrangler init' first.");
     }
     const wranglerArgs = ['dev'];
+    if (normalizedConfig !== '') {
+        wranglerArgs.push('--config', normalizedConfig);
+    }
     if (configPath === undefined && entry !== undefined) {
         wranglerArgs.push(entry);
     }
@@ -429,7 +442,10 @@ const executeStart = async (options, cmd) => {
         ...(typeof cacheEnabled === 'boolean' ? { cacheEnabled } : {}),
     });
     if (variant === 'wrangler') {
-        await executeWranglerStart(cmd, cwd, port, runtime, envName === '' ? undefined : envName);
+        const wranglerConfig = typeof options.wranglerConfig === 'string' && options.wranglerConfig.trim() !== ''
+            ? options.wranglerConfig.trim()
+            : undefined;
+        await executeWranglerStart(cmd, cwd, port, runtime, envName === '' ? undefined : envName, wranglerConfig);
         return;
     }
     if (envName !== '') {
@@ -461,6 +477,7 @@ export const StartCommand = Object.freeze({
                 .option('--no-watch', 'Disable watch mode (Node only)')
                 .option('--mode <development|production|testing>', 'Override app mode')
                 .option('--env <name>', 'Wrangler environment name (Wrangler mode only)')
+                .option('--wrangler-config <path>', 'Wrangler config path (Wrangler mode only)')
                 .option('--runtime <nodejs|cloudflare|lambda|deno|auto>', 'Set RUNTIME for spawned Node')
                 .option('-p, --port <number>', 'Override server port');
         };

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

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGhG,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC,CAAC;AA+EH;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,kBA4DnC,CAAC;AAsBH,QAAA,MAAM,iBAAiB,QAAO;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,CAAC,YAAY,EAAE,sBAAsB,KAAK,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACzF,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CAuEH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAqB/D,eAAO,MAAM,WAAW,EAAE,WAYxB,CAAC"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGhG,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC,CAAC;AA+EH;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,kBA4DnC,CAAC;AA8CH,QAAA,MAAM,iBAAiB,QAAO;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,CAAC,YAAY,EAAE,sBAAsB,KAAK,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACzF,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CAuEH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAqB/D,eAAO,MAAM,WAAW,EAAE,WAYxB,CAAC"}

package/src/config/queue.js

@@ -5,6 +5,9 @@
  */
 import { Cloudflare } from './cloudflare.js';
 import { Env } from './env.js';
+import { Logger } from './logger.js';
+import { middlewareConfig } from './middleware.js';
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { ZintrustLang } from '../lang/lang.js';
 import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';
 const getQueueDriver = (driverConfig) => {
@@ -113,16 +116,32 @@ export const createBaseDrivers = () => ({
 /**
  * Helper: Create monitor configuration from environment
  */
-const createBaseMonitor = () => ({
-    enabled: Env.getBool('QUEUE_MONITOR_ENABLED', false),
-    basePath: Env.get('QUEUE_MONITOR_BASE_PATH', '/queue-monitor'),
-    middleware: Env.get('QUEUE_MONITOR_MIDDLEWARE', '')
+const createBaseMonitor = () => {
+    const enabled = Env.getBool('QUEUE_MONITOR_ENABLED', false);
+    const basePath = Env.get('QUEUE_MONITOR_BASE_PATH', '/queue-monitor');
+    const middleware = Env.get('QUEUE_MONITOR_MIDDLEWARE', '')
         .split(',')
         .map((m) => m.trim())
-        .filter((m) => m.length > 0),
-    autoRefresh: Env.getBool('QUEUE_MONITOR_AUTO_REFRESH', true),
-    refreshIntervalMs: Env.getInt('QUEUE_MONITOR_REFRESH_MS', 5000),
-});
+        .filter((m) => m.length > 0);
+    if (enabled && middleware.length > 0) {
+        const knownKeys = new Set(Object.keys(middlewareConfig.route ?? {}));
+        const unknownKeys = middleware.filter((name) => !knownKeys.has(name));
+        if (unknownKeys.length > 0) {
+            Logger.error('Unknown QUEUE_MONITOR_MIDDLEWARE keys configured', {
+                unknownKeys,
+                basePath,
+            });
+            throw ErrorFactory.createConfigError(`Unknown QUEUE_MONITOR_MIDDLEWARE key(s): ${unknownKeys.join(', ')}. These must match registered route middleware keys in your app.`);
+        }
+    }
+    return {
+        enabled,
+        basePath,
+        middleware,
+        autoRefresh: Env.getBool('QUEUE_MONITOR_AUTO_REFRESH', true),
+        refreshIntervalMs: Env.getInt('QUEUE_MONITOR_REFRESH_MS', 5000),
+    };
+};
 const createQueueConfig = () => {
     const overrides = StartupConfigFileRegistry.get(StartupConfigFile.Queue) ?? {};
     const baseDefault = Env.get('QUEUE_DRIVER', 'sync');

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.1.43
+ * @zintrust/core v0.1.46
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-02-18T18:05:00.416Z
+ *   Built: 2026-02-22T15:47:02.870Z
  *   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-02-18T18:05:00.386Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-02-22T15:47:02.841Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/orm/Database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../../src/orm/Database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAUxD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrF,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACzE,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1F,cAAc,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1E,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3F,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACvD,OAAO,IAAI,eAAe,CAAC;IAC3B,SAAS,IAAI,cAAc,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AA2eD,eAAO,MAAM,QAAQ;IACnB;;OAEG;oBACa,cAAc,GAAG,SAAS;EAI1C,CAAC;AAIH,eAAO,MAAM,oBAAoB,GAC/B,SAAQ,cAAc,GAAG,SAAqB,EAC9C,uBAA0B,KACzB,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAMxC,CAAC;AAEF,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,UAAU,SAAY,GAAG,SAAS,CAoBtF;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAWnD"}
+{"version":3,"file":"Database.d.ts","sourceRoot":"","sources":["../../../src/orm/Database.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAWxD,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,MAAM,QAAQ,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACjF,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACrF,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IACnC,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACzE,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1F,cAAc,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1E,aAAa,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3F,kBAAkB,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;IACvD,OAAO,IAAI,eAAe,CAAC;IAC3B,SAAS,IAAI,cAAc,CAAC;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AA4gBD,eAAO,MAAM,QAAQ;IACnB;;OAEG;oBACa,cAAc,GAAG,SAAS;EAI1C,CAAC;AAIH,eAAO,MAAM,oBAAoB,GAC/B,SAAQ,cAAc,GAAG,SAAqB,EAC9C,uBAA0B,KACzB,OAAO,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAMxC,CAAC;AAEF,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,UAAU,SAAY,GAAG,SAAS,CAoBtF;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAWnD"}

package/src/orm/Database.js

@@ -16,6 +16,7 @@ import { PostgreSQLAdapter } from './adapters/PostgreSQLAdapter.js';
 import { PostgreSQLProxyAdapter } from './adapters/PostgreSQLProxyAdapter.js';
 import { SQLiteAdapter } from './adapters/SQLiteAdapter.js';
 import { SQLServerAdapter } from './adapters/SQLServerAdapter.js';
+import { createSqlServerProxyAdapter } from './adapters/SqlServerProxyAdapter.js';
 import { DatabaseAdapterRegistry } from './DatabaseAdapterRegistry.js';
 import { QueryBuilder } from './QueryBuilder.js';
 /**
@@ -31,7 +32,7 @@ const resolveMySqlProxyAdapter = (cfg) => {
     const proxyUrl = Env.get('MYSQL_PROXY_URL', '').trim();
     const useProxy = Env.getBool('USE_MYSQL_PROXY', false);
     if (useProxy || proxyUrl.length > 0) {
-        Logger.info('[Database] Selecting MySQL proxy adapter for Workers runtime', {
+        Logger.info('[Database] Selecting MySQL proxy adapter', {
             driver: cfg.driver,
             useMySqlProxy: useProxy,
             mysqlProxyUrlConfigured: proxyUrl.length > 0,
@@ -47,7 +48,7 @@ const resolvePostgresProxyAdapter = (cfg) => {
     const proxyUrl = Env.get('POSTGRES_PROXY_URL', '').trim();
     const useProxy = Env.getBool('USE_POSTGRES_PROXY', false);
     if (useProxy || proxyUrl.length > 0) {
-        Logger.info('[Database] Selecting PostgreSQL proxy adapter for Workers runtime', {
+        Logger.info('[Database] Selecting PostgreSQL proxy adapter', {
             driver: cfg.driver,
             usePostgresProxy: useProxy,
             postgresProxyUrlConfigured: proxyUrl.length > 0,
@@ -57,6 +58,36 @@ const resolvePostgresProxyAdapter = (cfg) => {
     }
     return null;
 };
+const resolveSqlServerProxyAdapter = (cfg) => {
+    if (cfg.driver !== 'sqlserver')
+        return null;
+    const proxyUrl = Env.get('SQLSERVER_PROXY_URL', '').trim();
+    const useProxy = Env.getBool('USE_SQLSERVER_PROXY', false);
+    if (useProxy || proxyUrl.length > 0) {
+        Logger.info('[Database] Selecting SQL Server proxy adapter', {
+            driver: cfg.driver,
+            useSqlServerProxy: useProxy,
+            sqlServerProxyUrlConfigured: proxyUrl.length > 0,
+            sqlServerProxyUrl: proxyUrl,
+        });
+        return createSqlServerProxyAdapter();
+    }
+    return null;
+};
+const resolveExplicitProxyAdapter = (cfg) => {
+    // Allow proxy adapters to be forced in any runtime (Node or Workers) when
+    // the feature flags or proxy URLs are configured.
+    const mysqlProxy = resolveMySqlProxyAdapter(cfg);
+    if (mysqlProxy)
+        return mysqlProxy;
+    const postgresProxy = resolvePostgresProxyAdapter(cfg);
+    if (postgresProxy)
+        return postgresProxy;
+    const sqlServerProxy = resolveSqlServerProxyAdapter(cfg);
+    if (sqlServerProxy)
+        return sqlServerProxy;
+    return null;
+};
 const ensureCloudflareSocketSupport = (cfg) => {
     const isSocketDriver = cfg.driver === 'postgresql' || cfg.driver === 'mysql';
     if (!isSocketDriver)
@@ -92,6 +123,9 @@ const resolveWorkersAdapter = (cfg) => {
     return null;
 };
 const createAdapter = (cfg) => {
+    const explicitProxy = resolveExplicitProxyAdapter(cfg);
+    if (explicitProxy)
+        return explicitProxy;
     const workersAdapter = resolveWorkersAdapter(cfg);
     if (workersAdapter)
         return workersAdapter;

package/src/performance/Optimizer.js

@@ -469,7 +469,7 @@ export function createMemoized(fn, options = {}) {
                 typeof a === 'string' ||
                 typeof a === 'number' ||
                 typeof a === 'boolean' ||
-                a === 'undefined');
+                a === undefined);
             key = arePrimitives ? args.join('|') : JSON.stringify(args);
         }
         else {

package/src/proxy/ProxyServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProxyServer.d.ts","sourceRoot":"","sources":["../../../src/proxy/ProxyServer.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,MAAM,EAEZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAA+B,MAAM,qBAAqB,CAAC;AAErF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,CACP,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E,CAAC,CAAC;AA0CH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,kBAAkB,KAC1B,QAAQ,CAAC;IACV,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAsDA,CAAC"}
+{"version":3,"file":"ProxyServer.d.ts","sourceRoot":"","sources":["../../../src/proxy/ProxyServer.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,MAAM,EAEZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAA+B,MAAM,qBAAqB,CAAC;AAErF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,CACP,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E,CAAC,CAAC;AA0CH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,kBAAkB,KAC1B,QAAQ,CAAC;IACV,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAkEA,CAAC"}

package/src/proxy/ProxyServer.js

@@ -38,6 +38,15 @@ export const createProxyServer = (options) => {
     const server = createServer(async (req, res) => {
         try {
             const body = await readBody(req, options.maxBodyBytes);
+            const rawUrl = req.url ?? '';
+            if (rawUrl.startsWith('/containerstarthealthcheck') ||
+                rawUrl.startsWith('containerstarthealthcheck')) {
+                respond(res, {
+                    status: 200,
+                    body: { status: 'ok' },
+                });
+                return;
+            }
             if ((req.url ?? '').startsWith('/health')) {
                 const response = await options.backend.health();
                 respond(res, response);

package/src/session/SessionManager.js

@@ -8,7 +8,7 @@ const DEFAULT_OPTIONS = {
 };
 function isUnrefableTimer(value) {
     return (typeof value === 'object' &&
-        value !== null &&
+        value instanceof Object &&
         'unref' in value &&
         typeof value.unref === 'function');
 }