@zintrust/core 0.4.1 → 0.4.2

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.tryImportInstalledExtensions();
+        }
+        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.2",
   "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,32 @@
+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;
+}>;
+export declare const OptionalCliExtensions: Readonly<{
+    tryImportInstalledExtensions(): Promise<OptionalCliExtensionStatus[]>;
+    findMissingExtensionForArgs(args: string[], statuses: ReadonlyArray<OptionalCliExtensionStatus>): OptionalCliExtensionStatus | undefined;
+    getMissingExtensionMessage(status: OptionalCliExtensionStatus): string;
+}>;
+export declare const OptionalCliExtensionsInternal: Readonly<{
+    getProjectCwd: () => string;
+    resolveProjectRoot: () => string;
+    resolveProjectInstalledUrl: (entry: OptionalCliExtension) => string | null;
+    tryImportProjectInstalledPackage: (entry: OptionalCliExtension) => Promise<boolean>;
+    tryImportLocalCandidate: (entry: OptionalCliExtension) => Promise<boolean>;
+    tryImportPackageSpecifier: (entry: OptionalCliExtension) => Promise<boolean>;
+    tryImportExtension: (entry: OptionalCliExtension) => Promise<OptionalCliExtensionStatus>;
+    getRequestedCommand: (args: string[]) => string | undefined;
+}>;
+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;AA2LH,eAAO,MAAM,qBAAqB;oCACM,OAAO,CAAC,0BAA0B,EAAE,CAAC;sCAKnE,MAAM,EAAE,YACJ,aAAa,CAAC,0BAA0B,CAAC,GAClD,0BAA0B,GAAG,SAAS;uCASN,0BAA0B,GAAG,MAAM;EAOtE,CAAC;AAEH,eAAO,MAAM,6BAA6B;yBAhNhB,MAAM;8BAQD,MAAM;wCAuCM,oBAAoB,KAAG,MAAM,GAAG,IAAI;8CAiBxB,oBAAoB,KAAG,OAAO,CAAC,OAAO,CAAC;qCAqBhD,oBAAoB,KAAG,OAAO,CAAC,OAAO,CAAC;uCA2BrC,oBAAoB,KAAG,OAAO,CAAC,OAAO,CAAC;gCAmB9E,oBAAoB,KAC1B,OAAO,CAAC,0BAA0B,CAAC;gCAwCH,MAAM,EAAE,KAAG,MAAM,GAAG,SAAS;EA6C9D,CAAC"}

package/src/cli/OptionalCliExtensions.js

@@ -0,0 +1,205 @@
+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 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) => {
+    try {
+        const projectRoot = resolveProjectRoot();
+        const requireFromProject = createRequire(path.join(projectRoot, 'package.json'));
+        const resolved = requireFromProject.resolve(entry.specifier);
+        return pathToFileURL(resolved).href;
+    }
+    catch (error) {
+        Logger.debug('[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),
+        });
+        return null;
+    }
+};
+const tryImportProjectInstalledPackage = async (entry) => {
+    const resolvedUrl = resolveProjectInstalledUrl(entry);
+    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) {
+        Logger.debug('[cli] Optional CLI extension project import failed', {
+            packageName: entry.packageName,
+            resolvedUrl,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return false;
+    }
+};
+const tryImportLocalCandidate = async (entry) => {
+    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) {
+            Logger.debug('[cli] Optional CLI extension local fallback failed', {
+                packageName: entry.packageName,
+                candidate,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return false;
+        }
+    }));
+    return results.some(Boolean);
+};
+const tryImportPackageSpecifier = async (entry) => {
+    try {
+        await import(entry.specifier);
+        Logger.debug('[cli] Loaded optional CLI extension package', {
+            packageName: entry.packageName,
+            specifier: entry.specifier,
+        });
+        return true;
+    }
+    catch (error) {
+        Logger.debug('[cli] Optional CLI extension package not loaded', {
+            packageName: entry.packageName,
+            specifier: entry.specifier,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return false;
+    }
+};
+const tryImportExtension = async (entry) => {
+    if (await tryImportProjectInstalledPackage(entry)) {
+        return {
+            packageName: entry.packageName,
+            commands: [...entry.commands],
+            installCommand: entry.installCommand,
+            loaded: true,
+            source: 'project',
+        };
+    }
+    if (await tryImportPackageSpecifier(entry)) {
+        return {
+            packageName: entry.packageName,
+            commands: [...entry.commands],
+            installCommand: entry.installCommand,
+            loaded: true,
+            source: 'package',
+        };
+    }
+    if (await tryImportLocalCandidate(entry)) {
+        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;
+};
+export const OptionalCliExtensions = Object.freeze({
+    async tryImportInstalledExtensions() {
+        return Promise.all(OPTIONAL_CLI_EXTENSIONS.map(tryImportExtension));
+    },
+    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(' ');
+    },
+});
+export const OptionalCliExtensionsInternal = Object.freeze({
+    getProjectCwd,
+    resolveProjectRoot,
+    resolveProjectInstalledUrl,
+    tryImportProjectInstalledPackage,
+    tryImportLocalCandidate,
+    tryImportPackageSpecifier,
+    tryImportExtension,
+    getRequestedCommand,
+});

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.2
  *
  * 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-20T09:35:09.203Z
  *   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-20T09:35:09.174Z'; // 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({