@zintrust/core 0.4.1 → 0.4.3

package/bin/zintrust-main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuGH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CzC;AAED,OAAO,EAAE,CAAC"}
+{"version":3,"file":"zintrust-main.d.ts","sourceRoot":"","sources":["../../bin/zintrust-main.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuGH,wBAAsB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAsEzC;AAED,OAAO,EAAE,CAAC"}

package/bin/zintrust-main.js

@@ -99,6 +99,23 @@ export async function run() {
         }
         const { EnvFileLoader } = await import('../src/cli/utils/EnvFileLoader.js');
         EnvFileLoader.ensureLoaded();
+        // Auto-load install-only CLI extension packages that self-register commands.
+        let optionalCliExtensions;
+        let optionalCliStatuses = [];
+        try {
+            ({ OptionalCliExtensions: optionalCliExtensions } =
+                await import('../src/cli/OptionalCliExtensions.js'));
+            optionalCliStatuses = await optionalCliExtensions.loadForArgs(args0);
+        }
+        catch {
+            // best-effort; missing optional extensions must not block the CLI
+        }
+        const missingOptionalExtension = optionalCliExtensions?.findMissingExtensionForArgs(args0, optionalCliStatuses);
+        if (missingOptionalExtension !== undefined) {
+            const { ErrorFactory } = await import('../src/exceptions/ZintrustError.js');
+            throw ErrorFactory.createCliError(optionalCliExtensions?.getMissingExtensionMessage(missingOptionalExtension) ??
+                `Missing optional CLI package: ${missingOptionalExtension.packageName}`);
+        }
         // Ensure project-installed adapters/drivers are registered for CLI commands.
         // (This is driven by src/zintrust.plugins.ts generated by `zin plugin install`.)
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -46,14 +46,14 @@
   },
   "dependencies": {
     "@cloudflare/containers": "^0.1.1",
-    "@zintrust/workers": "^0.1.54",
+    "@zintrust/workers": "^0.4.0",
     "bcryptjs": "^3.0.3",
-    "bullmq": "^5.70.4",
+    "bullmq": "^5.71.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
-    "inquirer": "^13.3.0",
+    "inquirer": "^13.3.2",
     "jsonwebtoken": "^9.0.3",
-    "mysql2": "^3.19.0",
+    "mysql2": "^3.20.0",
     "pg": "^8.20.0"
   },
   "overrides": {
@@ -64,7 +64,16 @@
     "glob": "^11.1.0",
     "minimatch": "^10.2.2",
     "rollup": "^4.59.0",
-    "undici": "^6.23.0"
+    "flatted": "^3.4.2",
+    "@actions/github": {
+      "undici": "^6.24.0"
+    },
+    "@actions/http-client": {
+      "undici": "^6.24.0"
+    },
+    "miniflare": {
+      "undici": "^7.24.4"
+    }
   },
   "bin": {
     "zintrust": "bin/zintrust.js",

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;AAuEH,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;AA6PD;;;;;;;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;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"}

package/src/cli/CLI.js

@@ -58,15 +58,14 @@ import { SqlServerProxyCommand } from './commands/SqlServerProxyCommand.js';
 import { StartCommand } from './commands/StartCommand.js';
 import { TemplatesCommand } from './commands/TemplatesCommand.js';
 import { UpgradeCommand } from './commands/UpgradeCommand.js';
-import { WorkerCommands } from './commands/WorkerCommands.js';
 import { ErrorHandler } from './ErrorHandler.js';
+import { OptionalCliCommandRegistry } from './OptionalCliCommandRegistry.js';
 import { VersionChecker } from './services/VersionChecker.js';
 import { esmDirname } from '../common/index.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { readFileSync } from '../node-singletons/fs.js';
 import { join } from '../node-singletons/path.js';
-import { D1Migrator } from '../../packages/d1-migrator/src/index.js';
 import { Command } from 'commander';
 const __dirname = esmDirname(import.meta.url);
 const isCommandProvider = (command) => {
@@ -106,7 +105,6 @@ const buildCommandRegistry = () => {
         DbSeedCommand.create(),
         D1LearnCommand.create(),
         D1MigrateCommand.create(),
-        D1Migrator.MigrateToD1Command,
         DebugCommand.create(),
         SecretsCommand.create(),
         ConfigCommand.create(),
@@ -136,13 +134,7 @@ const buildCommandRegistry = () => {
         SqlServerProxyCommand.create(),
         RedisProxyCommand.create(),
         SmtpProxyCommand.create(),
-        WorkerCommands.createWorkerListCommand(),
-        WorkerCommands.createWorkerStatusCommand(),
-        WorkerCommands.createWorkerStartCommand(),
-        WorkerCommands.createWorkerStartAllCommand(),
-        WorkerCommands.createWorkerStopCommand(),
-        WorkerCommands.createWorkerRestartCommand(),
-        WorkerCommands.createWorkerSummaryCommand(),
+        ...OptionalCliCommandRegistry.list(),
     ];
 };
 /**

package/src/cli/OptionalCliCommandRegistry.d.ts

@@ -0,0 +1,12 @@
+import type { Command } from 'commander';
+export type CliCommandProvider = {
+    getCommand: () => Command;
+    name?: string;
+};
+export declare const OptionalCliCommandRegistry: Readonly<{
+    register(id: string, provider: CliCommandProvider): void;
+    get(id: string): CliCommandProvider | undefined;
+    has(id: string): boolean;
+    list(): CliCommandProvider[];
+}>;
+//# sourceMappingURL=OptionalCliCommandRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OptionalCliCommandRegistry.d.ts","sourceRoot":"","sources":["../../../src/cli/OptionalCliCommandRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAiBF,eAAO,MAAM,0BAA0B;iBACxB,MAAM,YAAY,kBAAkB,GAAG,IAAI;YAMhD,MAAM,GAAG,kBAAkB,GAAG,SAAS;YAIvC,MAAM,GAAG,OAAO;YAIhB,kBAAkB,EAAE;EAG5B,CAAC"}

package/src/cli/OptionalCliCommandRegistry.js

@@ -0,0 +1,25 @@
+import { isObject } from '../helper/index.js';
+const globalWithRegistry = globalThis;
+const registry = globalWithRegistry.__zintrust_cli_command_registry__ ??
+    (globalWithRegistry.__zintrust_cli_command_registry__ = new Map());
+const isCliCommandProvider = (value) => {
+    return isObject(value) && typeof value['getCommand'] === 'function';
+};
+const normalizeId = (id) => id.trim();
+export const OptionalCliCommandRegistry = Object.freeze({
+    register(id, provider) {
+        const normalizedId = normalizeId(id);
+        if (normalizedId === '' || !isCliCommandProvider(provider))
+            return;
+        registry.set(normalizedId, provider);
+    },
+    get(id) {
+        return registry.get(normalizeId(id));
+    },
+    has(id) {
+        return registry.has(normalizeId(id));
+    },
+    list() {
+        return Array.from(registry.values());
+    },
+});

package/src/cli/OptionalCliExtensions.d.ts

@@ -0,0 +1,41 @@
+export type OptionalCliExtension = {
+    packageName: string;
+    specifier: string;
+    commands: string[];
+    installCommand: string;
+    localCandidates: string[];
+};
+type OptionalCliExtensionLoadSource = 'project' | 'package' | 'local-fallback' | 'missing';
+export type OptionalCliExtensionStatus = Readonly<{
+    packageName: string;
+    commands: string[];
+    installCommand: string;
+    loaded: boolean;
+    source: OptionalCliExtensionLoadSource;
+}>;
+type OptionalCliExtensionLoadOptions = Readonly<{
+    logFailures?: boolean;
+}>;
+export declare const OptionalCliExtensions: Readonly<{
+    tryImportInstalledExtensions(): Promise<OptionalCliExtensionStatus[]>;
+    loadForArgs(args: string[]): Promise<OptionalCliExtensionStatus[]>;
+    findMissingExtensionForArgs(args: string[], statuses: ReadonlyArray<OptionalCliExtensionStatus>): OptionalCliExtensionStatus | undefined;
+    getMissingExtensionMessage(status: OptionalCliExtensionStatus): string;
+    findRequestedExtension: (args: string[]) => OptionalCliExtension | undefined;
+}>;
+export declare const OptionalCliExtensionsInternal: Readonly<{
+    getProjectCwd: () => string;
+    resolveProjectRoot: () => string;
+    resolveProjectInstalledUrl: (entry: OptionalCliExtension, options?: OptionalCliExtensionLoadOptions) => string | null;
+    shouldLogFailures: (options?: OptionalCliExtensionLoadOptions) => boolean;
+    debugFailure: (message: string, meta: Record<string, unknown>, options?: OptionalCliExtensionLoadOptions) => void;
+    tryImportProjectInstalledPackage: (entry: OptionalCliExtension, options?: OptionalCliExtensionLoadOptions) => Promise<boolean>;
+    tryImportLocalCandidate: (entry: OptionalCliExtension, options?: OptionalCliExtensionLoadOptions) => Promise<boolean>;
+    tryImportPackageSpecifier: (entry: OptionalCliExtension, options?: OptionalCliExtensionLoadOptions) => Promise<boolean>;
+    tryImportExtension: (entry: OptionalCliExtension, options?: OptionalCliExtensionLoadOptions) => Promise<OptionalCliExtensionStatus>;
+    getRequestedCommand: (args: string[]) => string | undefined;
+    findRequestedExtension: (args: string[]) => OptionalCliExtension | undefined;
+    isRootHelpRequest: (args: string[]) => boolean;
+}>;
+export {};
+//# sourceMappingURL=OptionalCliExtensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OptionalCliExtensions.d.ts","sourceRoot":"","sources":["../../../src/cli/OptionalCliExtensions.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAEF,KAAK,8BAA8B,GAAG,SAAS,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAE3F,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,8BAA8B,CAAC;CACxC,CAAC,CAAC;AAEH,KAAK,+BAA+B,GAAG,QAAQ,CAAC;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC,CAAC;AAoPH,eAAO,MAAM,qBAAqB;oCACM,OAAO,CAAC,0BAA0B,EAAE,CAAC;sBAQnD,MAAM,EAAE,GAAG,OAAO,CAAC,0BAA0B,EAAE,CAAC;sCAmBhE,MAAM,EAAE,YACJ,aAAa,CAAC,0BAA0B,CAAC,GAClD,0BAA0B,GAAG,SAAS;uCASN,0BAA0B,GAAG,MAAM;mCArDlC,MAAM,EAAE,KAAG,oBAAoB,GAAG,SAAS;EA8D/E,CAAC;AAEH,eAAO,MAAM,6BAA6B;yBAjShB,MAAM;8BAQD,MAAM;wCAsD5B,oBAAoB,YACjB,+BAA+B,KACxC,MAAM,GAAG,IAAI;kCAlDqB,+BAA+B,KAAG,OAAO;4BAMnE,MAAM,QACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YACnB,+BAA+B,KACxC,IAAI;8CA+DE,oBAAoB,YACjB,+BAA+B,KACxC,OAAO,CAAC,OAAO,CAAC;qCA0BV,oBAAoB,YACjB,+BAA+B,KACxC,OAAO,CAAC,OAAO,CAAC;uCAgCV,oBAAoB,YACjB,+BAA+B,KACxC,OAAO,CAAC,OAAO,CAAC;gCAuBV,oBAAoB,YACjB,+BAA+B,KACxC,OAAO,CAAC,0BAA0B,CAAC;gCAwCH,MAAM,EAAE,KAAG,MAAM,GAAG,SAAS;mCAU1B,MAAM,EAAE,KAAG,oBAAoB,GAAG,SAAS;8BAOhD,MAAM,EAAE,KAAG,OAAO;EAsEjD,CAAC"}

package/src/cli/OptionalCliExtensions.js

@@ -0,0 +1,244 @@
+import { readEnvString } from '../common/ExternalServiceUtils.js';
+import { esmDirname } from '../common/index.js';
+import { Logger } from '../config/logger.js';
+import { existsSync } from '../node-singletons/fs.js';
+import { createRequire } from '../node-singletons/module.js';
+import * as path from '../node-singletons/path.js';
+import { pathToFileURL } from '../node-singletons/url.js';
+const __dirname = esmDirname(import.meta.url);
+const packageRoot = path.resolve(__dirname, '../..');
+const getProjectCwd = () => {
+    if (typeof process !== 'undefined' && typeof process.cwd === 'function') {
+        return process.cwd();
+    }
+    return packageRoot;
+};
+const resolveProjectRoot = () => {
+    const configured = readEnvString('ZINTRUST_PROJECT_ROOT').trim();
+    if (configured !== '')
+        return configured;
+    return getProjectCwd();
+};
+const shouldLogFailures = (options) => {
+    if (options?.logFailures === true)
+        return true;
+    return readEnvString('ZINTRUST_DEBUG_OPTIONAL_CLI_EXTENSIONS').trim() === '1';
+};
+const debugFailure = (message, meta, options) => {
+    if (!shouldLogFailures(options))
+        return;
+    Logger.debug(message, meta);
+};
+const OPTIONAL_CLI_EXTENSIONS = Object.freeze([
+    {
+        packageName: '@zintrust/d1-migrator',
+        specifier: '@zintrust/d1-migrator/register',
+        commands: ['migrate-to-d1', 'd1:transfer'],
+        installCommand: 'npm install @zintrust/d1-migrator',
+        localCandidates: [
+            path.join(packageRoot, 'packages', 'd1-migrator', 'src', 'register.ts'),
+            path.join(packageRoot, 'packages', 'd1-migrator', 'src', 'register.js'),
+            path.join(packageRoot, 'dist', 'packages', 'd1-migrator', 'src', 'register.js'),
+        ],
+    },
+    {
+        packageName: '@zintrust/workers',
+        specifier: '@zintrust/workers/register',
+        commands: [
+            'worker:list',
+            'worker:status',
+            'worker:start',
+            'worker:start-all',
+            'worker:stop',
+            'worker:restart',
+            'worker:summary',
+        ],
+        installCommand: 'npm install @zintrust/workers',
+        localCandidates: [
+            path.join(packageRoot, 'packages', 'workers', 'src', 'register.ts'),
+            path.join(packageRoot, 'packages', 'workers', 'src', 'register.js'),
+            path.join(packageRoot, 'dist', 'packages', 'workers', 'src', 'register.js'),
+        ],
+    },
+]);
+const resolveProjectInstalledUrl = (entry, options) => {
+    try {
+        const projectRoot = resolveProjectRoot();
+        const requireFromProject = createRequire(path.join(projectRoot, 'package.json'));
+        const resolved = requireFromProject.resolve(entry.specifier);
+        return pathToFileURL(resolved).href;
+    }
+    catch (error) {
+        debugFailure('[cli] Optional CLI extension not resolved from project root', {
+            packageName: entry.packageName,
+            specifier: entry.specifier,
+            projectRoot: resolveProjectRoot(),
+            error: error instanceof Error ? error.message : String(error),
+        }, options);
+        return null;
+    }
+};
+const tryImportProjectInstalledPackage = async (entry, options) => {
+    const resolvedUrl = resolveProjectInstalledUrl(entry, options);
+    if (resolvedUrl === null)
+        return false;
+    try {
+        await import(resolvedUrl);
+        Logger.debug('[cli] Loaded optional CLI extension from project install', {
+            packageName: entry.packageName,
+            resolvedUrl,
+        });
+        return true;
+    }
+    catch (error) {
+        debugFailure('[cli] Optional CLI extension project import failed', {
+            packageName: entry.packageName,
+            resolvedUrl,
+            error: error instanceof Error ? error.message : String(error),
+        }, options);
+        return false;
+    }
+};
+const tryImportLocalCandidate = async (entry, options) => {
+    const existingCandidates = entry.localCandidates.filter((candidate) => existsSync(candidate));
+    if (existingCandidates.length === 0)
+        return false;
+    const results = await Promise.all(existingCandidates.map(async (candidate) => {
+        try {
+            await import(pathToFileURL(candidate).href);
+            Logger.debug('[cli] Loaded optional CLI extension from local fallback', {
+                packageName: entry.packageName,
+                candidate,
+            });
+            return true;
+        }
+        catch (error) {
+            debugFailure('[cli] Optional CLI extension local fallback failed', {
+                packageName: entry.packageName,
+                candidate,
+                error: error instanceof Error ? error.message : String(error),
+            }, options);
+            return false;
+        }
+    }));
+    return results.some(Boolean);
+};
+const tryImportPackageSpecifier = async (entry, options) => {
+    try {
+        await import(entry.specifier);
+        Logger.debug('[cli] Loaded optional CLI extension package', {
+            packageName: entry.packageName,
+            specifier: entry.specifier,
+        });
+        return true;
+    }
+    catch (error) {
+        debugFailure('[cli] Optional CLI extension package not loaded', {
+            packageName: entry.packageName,
+            specifier: entry.specifier,
+            error: error instanceof Error ? error.message : String(error),
+        }, options);
+        return false;
+    }
+};
+const tryImportExtension = async (entry, options) => {
+    if (await tryImportProjectInstalledPackage(entry, options)) {
+        return {
+            packageName: entry.packageName,
+            commands: [...entry.commands],
+            installCommand: entry.installCommand,
+            loaded: true,
+            source: 'project',
+        };
+    }
+    if (await tryImportPackageSpecifier(entry, options)) {
+        return {
+            packageName: entry.packageName,
+            commands: [...entry.commands],
+            installCommand: entry.installCommand,
+            loaded: true,
+            source: 'package',
+        };
+    }
+    if (await tryImportLocalCandidate(entry, options)) {
+        return {
+            packageName: entry.packageName,
+            commands: [...entry.commands],
+            installCommand: entry.installCommand,
+            loaded: true,
+            source: 'local-fallback',
+        };
+    }
+    return {
+        packageName: entry.packageName,
+        commands: [...entry.commands],
+        installCommand: entry.installCommand,
+        loaded: false,
+        source: 'missing',
+    };
+};
+const getRequestedCommand = (args) => {
+    if (args.length === 0)
+        return undefined;
+    if (args[0] === 'help') {
+        return typeof args[1] === 'string' && args[1].trim() !== '' ? args[1].trim() : undefined;
+    }
+    return typeof args[0] === 'string' && args[0].trim() !== '' ? args[0].trim() : undefined;
+};
+const findRequestedExtension = (args) => {
+    const requestedCommand = getRequestedCommand(args);
+    if (requestedCommand === undefined)
+        return undefined;
+    return OPTIONAL_CLI_EXTENSIONS.find((entry) => entry.commands.includes(requestedCommand));
+};
+const isRootHelpRequest = (args) => {
+    if (args.length === 0)
+        return true;
+    const first = typeof args[0] === 'string' ? args[0].trim() : '';
+    if (first === '' || first === '-h' || first === '--help')
+        return true;
+    return first === 'help' && getRequestedCommand(args) === undefined;
+};
+export const OptionalCliExtensions = Object.freeze({
+    async tryImportInstalledExtensions() {
+        return Promise.all(OPTIONAL_CLI_EXTENSIONS.map(async (entry) => tryImportExtension(entry, { logFailures: false })));
+    },
+    async loadForArgs(args) {
+        const requestedExtension = findRequestedExtension(args);
+        if (requestedExtension !== undefined) {
+            return [await tryImportExtension(requestedExtension, { logFailures: false })];
+        }
+        if (isRootHelpRequest(args)) {
+            return Promise.all(OPTIONAL_CLI_EXTENSIONS.map(async (entry) => tryImportExtension(entry, { logFailures: false })));
+        }
+        return [];
+    },
+    findMissingExtensionForArgs(args, statuses) {
+        const requestedCommand = getRequestedCommand(args);
+        if (requestedCommand === undefined)
+            return undefined;
+        return statuses.find((status) => status.loaded !== true && status.commands.includes(requestedCommand));
+    },
+    getMissingExtensionMessage(status) {
+        const primaryCommand = status.commands[0] ?? status.packageName;
+        return [
+            `Command "${primaryCommand}" requires optional package "${status.packageName}".`,
+            `Install it and try again: ${status.installCommand}`,
+        ].join(' ');
+    },
+    findRequestedExtension,
+});
+export const OptionalCliExtensionsInternal = Object.freeze({
+    getProjectCwd,
+    resolveProjectRoot,
+    resolveProjectInstalledUrl,
+    shouldLogFailures,
+    debugFailure,
+    tryImportProjectInstalledPackage,
+    tryImportLocalCandidate,
+    tryImportPackageSpecifier,
+    tryImportExtension,
+    getRequestedCommand,
+    findRequestedExtension,
+    isRootHelpRequest,
+});

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;AAwnBvF,eAAO,MAAM,YAAY;cACb,YAAY;EA6BtB,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;AAspBvF,eAAO,MAAM,YAAY;cACb,YAAY;EA6BtB,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -79,6 +79,28 @@ const resolveRuntime = (options) => {
     const raw = typeof options.runtime === 'string' ? options.runtime.trim() : '';
     return raw === '' ? undefined : raw;
 };
+const resolveConfiguredRuntime = (options) => {
+    const cliRuntime = resolveRuntime(options);
+    if (cliRuntime !== undefined && cliRuntime !== 'auto')
+        return cliRuntime;
+    const envRuntime = readEnvString('RUNTIME').trim();
+    if (envRuntime === '' || envRuntime === 'auto')
+        return undefined;
+    return envRuntime;
+};
+const isCloudflareRuntimeRequest = (runtime) => {
+    if (typeof runtime !== 'string')
+        return false;
+    const normalized = runtime.trim().toLowerCase();
+    return normalized === 'cloudflare' || normalized === 'cloudflare-workers';
+};
+const assertCompatibleStartVariant = (variant, configuredRuntime) => {
+    if (variant !== 'node')
+        return;
+    if (!isCloudflareRuntimeRequest(configuredRuntime))
+        return;
+    throw ErrorFactory.createCliError('Error: Cloudflare runtime requires Wrangler dev mode. Run "zin start --wg" (or "zin s --wg") instead of plain "zin start".');
+};
 const resolveStartVariant = (options) => {
     const wantWrangler = options.wrangler === true || options.wg === true;
     const wantDeno = options.deno === true;
@@ -423,6 +445,7 @@ const executeStart = async (options, cmd) => {
     const mode = resolveMode(options);
     const port = resolvePort(options);
     const runtime = resolveRuntime(options);
+    const configuredRuntime = resolveConfiguredRuntime(options);
     const variant = resolveStartVariant(options);
     const envName = typeof options.env === 'string' ? options.env.trim() : '';
     let effectiveRuntime = runtime;
@@ -434,6 +457,7 @@ const executeStart = async (options, cmd) => {
         await executeSplitStart(cmd, cwd, options);
         return;
     }
+    assertCompatibleStartVariant(variant, configuredRuntime);
     const cacheEnabled = resolveCacheEnabledPreference(options);
     EnvFileLoader.applyCliOverrides({
         nodeEnv: mode,

package/src/cli/index.d.ts

@@ -16,4 +16,5 @@ export { PostgresProxyCommand } from './commands/PostgresProxyCommand';
 export { ProxyCommand } from './commands/ProxyCommand';
 export { RedisProxyCommand } from './commands/RedisProxyCommand';
 export { SecretsCommand } from './commands/SecretsCommand';
+export { WorkerCommands } from './commands/WorkerCommands';
 //# sourceMappingURL=index.d.ts.map

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"}
+{"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"}

package/src/cli/index.js

@@ -17,3 +17,4 @@ export { PostgresProxyCommand } from './commands/PostgresProxyCommand.js';
 export { ProxyCommand } from './commands/ProxyCommand.js';
 export { RedisProxyCommand } from './commands/RedisProxyCommand.js';
 export { SecretsCommand } from './commands/SecretsCommand.js';
+export { WorkerCommands } from './commands/WorkerCommands.js';

package/src/cli/scaffolding/GovernanceScaffolder.js

@@ -67,8 +67,7 @@ export default zintrustAppEslintConfig({
     const wrote = FileGenerator.writeFile(eslintConfigPath, content, { overwrite: false });
     return wrote ? [eslintConfigPath] : [];
 };
-const IMPORT_BOUNDARIES_ARCH_TEST_CONTENT = `import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
+const IMPORT_BOUNDARIES_ARCH_TEST_CONTENT = `import { fs, path } from '@zintrust/core/node';
 import * as ts from 'typescript';
 import { describe, expect, it } from 'vitest';
 
@@ -84,6 +83,7 @@ type Violation = {
 };
 
 const repoRoot = process.cwd();
+const fsPromises = fs.fsPromises;
 
 const isTsFile = (filePath: string): boolean => {
   if (!filePath.endsWith('.ts')) return false;
@@ -92,7 +92,7 @@ const isTsFile = (filePath: string): boolean => {
 };
 
 const walkTsFiles = async (dir: string): Promise<string[]> => {
-  const entries = await fs.readdir(dir, { withFileTypes: true });
+  const entries = await fsPromises.readdir(dir, { withFileTypes: true });
 
   const files = entries
     .filter((ent) => ent.isFile())
@@ -162,7 +162,7 @@ const findViolations = async (
 ): Promise<Violation[]> => {
   const perFile = await Promise.all(
     files.map(async (file): Promise<Violation[]> => {
-      const contents = await fs.readFile(file, 'utf-8');
+      const contents = await fsPromises.readFile(file, 'utf-8');
       const imports = extractImportSpecifiers(contents, file);
 
       return imports

package/src/cli.d.ts

@@ -1,5 +1,8 @@
 export { BaseCommand } from './cli/BaseCommand';
 export type { CommandOptions } from './cli/BaseCommand';
 export { CLI } from './cli/CLI';
-export { EXIT_CODES, ErrorHandler } from './cli/ErrorHandler';
+export { ErrorHandler, EXIT_CODES } from './cli/ErrorHandler';
+export { WorkerCommands } from './cli/commands/WorkerCommands';
+export { OptionalCliCommandRegistry } from './cli/OptionalCliCommandRegistry';
+export type { CliCommandProvider } from './cli/OptionalCliCommandRegistry';
 //# sourceMappingURL=cli.d.ts.map

package/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}

package/src/cli.js

@@ -1,4 +1,6 @@
 // CLI utilities (for build tools and scripting)
 export { BaseCommand } from './cli/BaseCommand.js';
 export { CLI } from './cli/CLI.js';
-export { EXIT_CODES, ErrorHandler } from './cli/ErrorHandler.js';
+export { ErrorHandler, EXIT_CODES } from './cli/ErrorHandler.js';
+export { WorkerCommands } from './cli/commands/WorkerCommands.js';
+export { OptionalCliCommandRegistry } from './cli/OptionalCliCommandRegistry.js';

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.1
+ * @zintrust/core v0.4.3
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-10T13:33:51.043Z
+ *   Built: 2026-03-20T12:13:34.410Z
  *   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-10T13:33:51.010Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-20T12:13:34.378Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/node.d.ts

@@ -1,4 +1,9 @@
+export * as crypto from './node-singletons/crypto';
+export * as fs from './node-singletons/fs';
+export * as path from './node-singletons/path';
+export { performance } from './node-singletons/perf-hooks';
 export { default, default as process } from './node-singletons/process';
+export * as url from './node-singletons/url';
 export { cleanOnce, FileLogWriter } from './config/FileLogWriter';
 export { listTemplates, loadTemplate, renderTemplate } from './tools/mail/templates';
 export { MailFake } from './tools/mail/testing';

package/src/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/node.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,IAAI,yBAAyB,EAC1C,YAAY,IAAI,wBAAwB,EACxC,cAAc,IAAI,0BAA0B,GAC7C,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/node.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,MAAM,MAAM,yBAAyB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,KAAK,IAAI,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,GAAG,MAAM,sBAAsB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EACV,gBAAgB,EAChB,sBAAsB,EACtB,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EACxB,gBAAgB,EAChB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,aAAa,IAAI,yBAAyB,EAC1C,YAAY,IAAI,wBAAwB,EACxC,cAAc,IAAI,0BAA0B,GAC7C,MAAM,kCAAkC,CAAC"}

package/src/node.js

@@ -4,7 +4,12 @@ const __coverageMarker = true;
 if (__coverageMarker !== true) {
     throw Logger.error('Unreachable');
 }
+export * as crypto from './node-singletons/crypto.js';
+export * as fs from './node-singletons/fs.js';
+export * as path from './node-singletons/path.js';
+export { performance } from './node-singletons/perf-hooks.js';
 export { default, default as process } from './node-singletons/process.js';
+export * as url from './node-singletons/url.js';
 export { cleanOnce, FileLogWriter } from './config/FileLogWriter.js';
 export { listTemplates, loadTemplate, renderTemplate } from './tools/mail/templates/index.js';
 export { MailFake } from './tools/mail/testing.js';

package/src/templates/adapters/SQLiteAdapter.ts.tpl

@@ -7,9 +7,7 @@
 import { FeatureFlags } from '@zintrust/core';
 import { Logger } from '@zintrust/core';
 import { ErrorFactory } from '@zintrust/core';
-import fs from 'node:fs';
-import * as path from 'node:path';
-import { performance } from 'node:perf_hooks';
+import { fs, path, performance } from '@zintrust/core/node';
 import { DatabaseConfig, IDatabaseAdapter, QueryResult } from '@zintrust/core';
 import { QueryBuilder } from '@zintrust/core';
 

package/src/templates/project/basic/database/seeders/DatabaseSeeder.ts.tpl

@@ -1,7 +1,7 @@
 import { SeederDiscovery } from '@zintrust/core/seeders';
 import { SeederLoader } from '@zintrust/core/seeders';
 import { CommonUtils } from '@zintrust/core/common';
-import * as path from 'node:path';
+import { path } from '@zintrust/core/node';
 import type { IDatabase } from '@zintrust/core/orm';
 
 export const DatabaseSeeder = Object.freeze({