@zintrust/core 0.1.23 → 0.1.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {

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

@@ -1 +1 @@
-{"version":3,"file":"DbSeedCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/DbSeedCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA6MrE,eAAO,MAAM,aAAa;cACd,YAAY;EAUtB,CAAC"}
+{"version":3,"file":"DbSeedCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/DbSeedCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkKrE,eAAO,MAAM,aAAa;cACd,YAAY;EAUtB,CAAC"}

package/src/cli/commands/DbSeedCommand.js

@@ -5,7 +5,7 @@
 import { SeederDiscovery } from '../../seeders/SeederDiscovery.js';
 import { SeederLoader } from '../../seeders/SeederLoader.js';
 import { BaseCommand } from '../BaseCommand.js';
-import { PromptHelper } from '../PromptHelper.js';
+import { confirmProductionRun, mapConnectionToOrmConfig } from '../utils/DatabaseCliUtils.js';
 import { databaseConfig } from '../../config/database.js';
 import { Env } from '../../config/env.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
@@ -23,42 +23,6 @@ const ensureNonD1Driver = (driver) => {
         throw ErrorFactory.createCliError('This project is configured for D1. Seeding via `zin db:seed` is not supported yet.');
     }
 };
-const mapConnectionToOrmConfig = (conn) => {
-    switch (conn.driver) {
-        case 'sqlite':
-            return { driver: 'sqlite', database: conn.database };
-        case 'postgresql':
-            return {
-                driver: 'postgresql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        case 'mysql':
-            return {
-                driver: 'mysql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        default:
-            return { driver: 'sqlite', database: ':memory:' };
-    }
-};
-const confirmProductionRun = async (cmd, interactive) => {
-    if (Env.NODE_ENV !== 'production')
-        return true;
-    const confirmed = await PromptHelper.confirm('NODE_ENV=production. Continue running seeders?', false, interactive);
-    if (!confirmed) {
-        cmd.warn('Cancelled.');
-        return false;
-    }
-    return true;
-};
 const getServiceArgs = (options) => {
     let serviceArg;
     if (typeof options['onlyService'] === 'string') {
@@ -105,7 +69,11 @@ const selectSeederFiles = (files, seederName) => {
 };
 const executeSeed = async (options, cmd) => {
     const interactive = getInteractive(options);
-    const okToProceed = await confirmProductionRun(cmd, interactive);
+    const okToProceed = await confirmProductionRun({
+        cmd,
+        interactive,
+        message: 'NODE_ENV=production. Continue running seeders?',
+    });
     if (!okToProceed)
         return;
     const conn = databaseConfig.getConnection();

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

@@ -1 +1 @@
-{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkdrE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EAUtB,CAAC"}
+{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA4ZrE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EAUtB,CAAC"}

package/src/cli/commands/MigrateCommand.js

@@ -7,8 +7,9 @@ import { D1SqlMigrations } from '../d1/D1SqlMigrations.js';
 import { WranglerConfig } from '../d1/WranglerConfig.js';
 import { WranglerD1 } from '../d1/WranglerD1.js';
 import { PromptHelper } from '../PromptHelper.js';
+import { confirmProductionRun, mapConnectionToOrmConfig, parseRollbackSteps, } from '../utils/DatabaseCliUtils.js';
+import { readEnvString } from '../../common/ExternalServiceUtils.js';
 import { databaseConfig } from '../../config/database.js';
-import { Env } from '../../config/env.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { Migrator } from '../../migrations/Migrator.js';
 import * as path from '../../node-singletons/path.js';
@@ -32,9 +33,10 @@ const addMigrateOptions = (command) => {
 };
 const getInteractive = (options) => options['interactive'] !== false;
 const getMigrationDirs = () => {
-    const globalDir = Env.get('MIGRATIONS_GLOBAL_DIR', databaseConfig.migrations.directory);
+    const globalDir = readEnvString('MIGRATIONS_GLOBAL_DIR', databaseConfig.migrations.directory);
     const extension = databaseConfig.migrations.extension;
-    const separateTracking = Env.getBool('MIGRATIONS_SEPARATE_TRACKING', false);
+    const separateTrackingRaw = readEnvString('MIGRATIONS_SEPARATE_TRACKING', '').trim();
+    const separateTracking = separateTrackingRaw === '1' || separateTrackingRaw.toLowerCase() === 'true';
     return { globalDir, extension, separateTracking };
 };
 const getServiceArgs = (options) => {
@@ -64,53 +66,6 @@ const describeTargetDatabase = (conn) => {
             return `${conn.driver}`;
     }
 };
-const mapConnectionToOrmConfig = (conn) => {
-    switch (conn.driver) {
-        case 'sqlite':
-            return { driver: 'sqlite', database: conn.database };
-        case 'postgresql':
-            return {
-                driver: 'postgresql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        case 'mysql':
-            return {
-                driver: 'mysql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        case 'sqlserver':
-            return {
-                driver: 'sqlserver',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        default:
-            return { driver: 'sqlite', database: ':memory:' };
-    }
-};
-const confirmProductionRun = async (cmd, interactive, destructive, force) => {
-    if (Env.NODE_ENV !== 'production')
-        return true;
-    if (force)
-        return true;
-    const confirmed = await PromptHelper.confirm(`NODE_ENV=production. Continue running migrations${destructive ? ' (destructive)' : ''}?`, false, interactive);
-    if (!confirmed) {
-        cmd.warn('Cancelled.');
-        return false;
-    }
-    return true;
-};
 const printStatus = (cmd, rows) => {
     if (rows.length === 0) {
         cmd.info('No migrations found.');
@@ -133,10 +88,6 @@ const logAppliedMigrations = (cmd, appliedNames) => {
         cmd.info(`✓ ${name}`);
     }
 };
-const parseRollbackSteps = (options) => {
-    const stepRaw = typeof options['step'] === 'string' ? options['step'] : '1';
-    return Math.max(1, Number.parseInt(stepRaw, 10) || 1);
-};
 const handleStatusAction = async (migrator, cmd, driver) => {
     cmd.info(`Adapter: ${driver}`);
     const rows = await migrator.status();
@@ -267,7 +218,13 @@ const processConnection = async (conn, options, cmd, interactive) => {
     const ormConfig = mapConnectionToOrmConfig(conn);
     const destructive = isDestructiveAction(options);
     const force = options['force'] === true;
-    const okToProceed = await confirmProductionRun(cmd, interactive, destructive, force);
+    const okToProceed = await confirmProductionRun({
+        cmd,
+        interactive,
+        destructive,
+        force,
+        message: 'NODE_ENV=production. Continue running migrations?',
+    });
     if (!okToProceed)
         return;
     cmd.info(`[i] Target database: ${describeTargetDatabase(conn)}`);

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

@@ -1 +1 @@
-{"version":3,"file":"MigrateWorkerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateWorkerCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAkOrE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAUtB,CAAC"}
+{"version":3,"file":"MigrateWorkerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateWorkerCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAmKrE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAUtB,CAAC"}

package/src/cli/commands/MigrateWorkerCommand.js

@@ -3,9 +3,8 @@
  * Run worker package migrations
  */
 import { BaseCommand } from '../BaseCommand.js';
-import { PromptHelper } from '../PromptHelper.js';
+import { confirmProductionRun, mapConnectionToOrmConfig, parseRollbackSteps, } from '../utils/DatabaseCliUtils.js';
 import { databaseConfig } from '../../config/database.js';
-import { Env } from '../../config/env.js';
 import { Migrator } from '../../migrations/Migrator.js';
 import * as path from '../../node-singletons/path.js';
 import { Database } from '../../orm/Database.js';
@@ -22,58 +21,7 @@ const addOptions = (command) => {
         .option('--no-interactive', 'Disable interactive prompts (useful for CI/CD)');
 };
 const getInteractive = (options) => options['interactive'] !== false;
-const mapConnectionToOrmConfig = (conn) => {
-    switch (conn.driver) {
-        case 'sqlite':
-            return { driver: 'sqlite', database: conn.database };
-        case 'postgresql':
-            return {
-                driver: 'postgresql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        case 'mysql':
-            return {
-                driver: 'mysql',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        case 'sqlserver':
-            return {
-                driver: 'sqlserver',
-                host: conn.host,
-                port: conn.port,
-                database: conn.database,
-                username: conn.username,
-                password: conn.password,
-            };
-        default:
-            return { driver: 'sqlite', database: ':memory:' };
-    }
-};
 const isDestructiveAction = (options) => options['fresh'] === true || options['reset'] === true || options['rollback'] === true;
-const parseRollbackSteps = (options) => {
-    const stepRaw = typeof options['step'] === 'string' ? options['step'] : '1';
-    return Math.max(1, Number.parseInt(stepRaw, 10) || 1);
-};
-const confirmProductionRun = async (cmd, interactive, destructive, force) => {
-    if (Env.NODE_ENV !== 'production')
-        return true;
-    if (force)
-        return true;
-    const confirmed = await PromptHelper.confirm(`NODE_ENV=production. Continue running worker migrations${destructive ? ' (destructive)' : ''}?`, false, interactive);
-    if (!confirmed) {
-        cmd.warn('Cancelled.');
-        return false;
-    }
-    return true;
-};
 const printStatus = async (migrator, cmd) => {
     const rows = await migrator.status();
     if (rows.length === 0) {
@@ -123,7 +71,13 @@ const runActions = async (migrator, options, cmd, driver) => {
 };
 const runForConnection = async (conn, options, cmd, interactive) => {
     const destructive = isDestructiveAction(options);
-    const proceed = await confirmProductionRun(cmd, interactive, destructive, options['force'] === true);
+    const proceed = await confirmProductionRun({
+        cmd,
+        interactive,
+        destructive,
+        force: options['force'] === true,
+        message: 'NODE_ENV=production. Continue running worker migrations?',
+    });
     if (!proceed)
         return;
     if (!DatabaseAdapterRegistry.has(conn.driver)) {

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

@@ -1 +1 @@
-{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAerE,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAYhF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAmQhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAwOD;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}
+{"version":3,"file":"NewCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/NewCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAerE,KAAK,YAAY,GAAG,OAAO,GAAG,KAAK,GAAG,cAAc,GAAG,WAAW,CAAC;AACnE,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAC;AAYhF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,KAAK,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAwPhD,UAAU,WAAY,SAAQ,YAAY;IACxC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACxF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACzF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,GAAG,gBAAgB,EAAE,CAAC;IACjF,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IAChC,YAAY,IAAI,MAAM,CAAC;IACvB,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,sBAAsB,EAC9B,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACpE;AAwOD;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;cACO,WAAW;EAGrB,CAAC"}

package/src/cli/commands/NewCommand.js

@@ -3,9 +3,9 @@ import { PromptHelper } from '../PromptHelper.js';
 import { GovernanceScaffolder } from '../scaffolding/GovernanceScaffolder.js';
 import { ProjectScaffolder } from '../scaffolding/ProjectScaffolder.js';
 import { SpawnUtil } from '../utils/spawn.js';
+import { readEnvString } from '../../common/ExternalServiceUtils.js';
 import { extractErrorMessage, resolvePackageManager } from '../../common/index.js';
 import { appConfig } from '../../config/app.js';
-import { Env } from '../../config/env.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { execFileSync } from '../../node-singletons/child-process.js';
 import * as path from '../../node-singletons/path.js';
@@ -193,18 +193,6 @@ const promptForPackageManager = async (defaultPm) => {
 };
 const installDependencies = async (projectPath, log, packageManager, force = false) => {
     // Respect CI by default — avoid network installs in CI unless explicitly allowed
-    const readEnvString = (key) => {
-        const anyEnv = Env;
-        const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get(key, '') : '';
-        if (typeof fromEnv === 'string' && fromEnv.trim() !== '')
-            return fromEnv;
-        if (typeof process !== 'undefined') {
-            const raw = process.env?.[key];
-            if (typeof raw === 'string')
-                return raw;
-        }
-        return fromEnv ?? '';
-    };
     const ciRaw = readEnvString('CI').trim().toLowerCase();
     const isCi = ciRaw !== '' && ciRaw !== '0' && ciRaw !== 'false';
     const allowAuto = readEnvString('ZINTRUST_ALLOW_AUTO_INSTALL') === '1' || force;

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;AAoavF,eAAO,MAAM,YAAY;cACb,YAAY;EAyBtB,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;AAyZvF,eAAO,MAAM,YAAY;cACb,YAAY;EAyBtB,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -2,8 +2,8 @@ import { BaseCommand } from '../BaseCommand.js';
 import { DENO_RUNNER_SOURCE, LAMBDA_RUNNER_SOURCE } from '../commands/runner/index.js';
 import { EnvFileLoader } from '../utils/EnvFileLoader.js';
 import { SpawnUtil } from '../utils/spawn.js';
+import { readEnvString } from '../../common/ExternalServiceUtils.js';
 import { resolveNpmPath } from '../../common/index.js';
-import { Env } from '../../config/env.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
@@ -20,18 +20,6 @@ const normalizeMode = (value) => {
         return 'testing';
     return 'development';
 };
-const readEnvString = (key) => {
-    const anyEnv = Env;
-    const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get(key, '') : '';
-    if (typeof fromEnv === 'string' && fromEnv.trim() !== '')
-        return fromEnv;
-    if (typeof process !== 'undefined') {
-        const raw = process.env?.[key];
-        if (typeof raw === 'string')
-            return raw;
-    }
-    return fromEnv ?? '';
-};
 const resolveModeFromAppMode = () => {
     const raw = readEnvString('APP_MODE').trim();
     const normalized = raw.toLowerCase();

package/src/cli/utils/DatabaseCliUtils.d.ts

@@ -0,0 +1,20 @@
+import type { CommandOptions, IBaseCommand } from '../BaseCommand';
+import type { DatabaseConfig as OrmDatabaseConfig } from '../../orm/DatabaseAdapter';
+export type ConnectionConfig = {
+    driver: string;
+    host?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    password?: string;
+};
+export declare const mapConnectionToOrmConfig: (conn: ConnectionConfig) => OrmDatabaseConfig;
+export declare const parseRollbackSteps: (options: CommandOptions) => number;
+export declare const confirmProductionRun: (params: {
+    cmd: IBaseCommand;
+    interactive: boolean;
+    message: string;
+    destructive?: boolean;
+    force?: boolean;
+}) => Promise<boolean>;
+//# sourceMappingURL=DatabaseCliUtils.d.ts.map

package/src/cli/utils/DatabaseCliUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatabaseCliUtils.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/DatabaseCliUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,KAAK,EAAE,cAAc,IAAI,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,MAAM,gBAAgB,KAAG,iBAkCjE,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,SAAS,cAAc,KAAG,MAG5D,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAU,QAAQ;IACjD,GAAG,EAAE,YAAY,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,KAAG,OAAO,CAAC,OAAO,CAalB,CAAC"}

package/src/cli/utils/DatabaseCliUtils.js

@@ -0,0 +1,54 @@
+import { PromptHelper } from '../PromptHelper.js';
+import { Env } from '../../config/env.js';
+export const mapConnectionToOrmConfig = (conn) => {
+    switch (conn.driver) {
+        case 'sqlite':
+            return { driver: 'sqlite', database: conn.database ?? ':memory:' };
+        case 'postgresql':
+            return {
+                driver: 'postgresql',
+                host: conn.host,
+                port: conn.port,
+                database: conn.database,
+                username: conn.username,
+                password: conn.password,
+            };
+        case 'mysql':
+            return {
+                driver: 'mysql',
+                host: conn.host,
+                port: conn.port,
+                database: conn.database,
+                username: conn.username,
+                password: conn.password,
+            };
+        case 'sqlserver':
+            return {
+                driver: 'sqlserver',
+                host: conn.host,
+                port: conn.port,
+                database: conn.database,
+                username: conn.username,
+                password: conn.password,
+            };
+        default:
+            return { driver: 'sqlite', database: ':memory:' };
+    }
+};
+export const parseRollbackSteps = (options) => {
+    const stepRaw = typeof options['step'] === 'string' ? options['step'] : '1';
+    return Math.max(1, Number.parseInt(stepRaw, 10) || 1);
+};
+export const confirmProductionRun = async (params) => {
+    if (Env.NODE_ENV !== 'production')
+        return true;
+    if (params.force === true)
+        return true;
+    const prompt = params.destructive === true ? `${params.message} (destructive)` : params.message;
+    const confirmed = await PromptHelper.confirm(prompt, false, params.interactive);
+    if (!confirmed) {
+        params.cmd.warn('Cancelled.');
+        return false;
+    }
+    return true;
+};

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.1.23
+ * @zintrust/core v0.1.24
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-01-21T12:25:54.552Z
+ *   Built: 2026-01-21T15:09:58.669Z
  *   Node: >=20.0.0
  *   License: MIT
  *
@@ -199,7 +199,7 @@ export { randomBytes } from './node-singletons/crypto.js';
  * Available at runtime for debugging and health checks
  */
 export const ZINTRUST_VERSION = '0.1.23';
-export const ZINTRUST_BUILD_DATE = '2026-01-21T12:25:54.523Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-01-21T15:09:58.638Z'; // Replaced during build
 export { createRedisConnection, workersConfig } from './config/workers.js';
 // NOTE: Node-only exports (like FileLogWriter, process) are intentionally not
 // exported from this root entrypoint. Use the '@zintrust/core/node' subpath.

package/src/runtime/PluginAutoImports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginAutoImports.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginAutoImports.ts"],"names":[],"mappings":"AAOA,KAAK,YAAY,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAmCN,eAAO,MAAM,iBAAiB;IAC5B;;;;;;OAMG;mCACkC,OAAO,CAAC,YAAY,CAAC;EAgC1D,CAAC"}
+{"version":3,"file":"PluginAutoImports.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginAutoImports.ts"],"names":[],"mappings":"AAOA,KAAK,YAAY,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAChC;IACE,EAAE,EAAE,KAAK,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAwBN,eAAO,MAAM,iBAAiB;IAC5B;;;;;;OAMG;mCACkC,OAAO,CAAC,YAAY,CAAC;EAgC1D,CAAC"}

package/src/runtime/PluginAutoImports.js

@@ -1,21 +1,9 @@
 import { pathToFileURL } from '../node-singletons/url.js';
-import { Env } from '../config/env.js';
+import { readEnvString } from '../common/ExternalServiceUtils.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { existsSync } from '../node-singletons/fs.js';
 import * as path from '../node-singletons/path.js';
-const readEnvString = (key) => {
-    const anyEnv = Env;
-    const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get(key, '') : '';
-    if (typeof fromEnv === 'string' && fromEnv.trim() !== '')
-        return fromEnv;
-    if (typeof process !== 'undefined') {
-        const raw = process.env?.[key];
-        if (typeof raw === 'string')
-            return raw;
-    }
-    return fromEnv ?? '';
-};
 const getProjectCwd = () => process.cwd();
 const getProjectRootEnv = () => readEnvString('ZINTRUST_PROJECT_ROOT');
 const resolveProjectRoot = () => {

package/src/runtime/PluginManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginManager.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA2ShE,eAAO,MAAM,aAAa;IACxB;;OAEG;YACK,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIxC;;OAEG;yBACkB,MAAM,GAAG,MAAM,GAAG,IAAI;IAW3C;;OAEG;0BACyB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0DrD;;OAEG;sBACqB,MAAM,YAAY;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrF;;;;OAIG;wBACuB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EA2ChD,CAAC"}
+{"version":3,"file":"PluginManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/PluginManager.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAgShE,eAAO,MAAM,aAAa;IACxB;;OAEG;YACK,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAIxC;;OAEG;yBACkB,MAAM,GAAG,MAAM,GAAG,IAAI;IAW3C;;OAEG;0BACyB,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA0DrD;;OAEG;sBACqB,MAAM,YAAY;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BrF;;;;OAIG;wBACuB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EA2ChD,CAAC"}

package/src/runtime/PluginManager.js

@@ -5,8 +5,8 @@
  */
 import { execSync } from '../node-singletons/child-process.js';
 import { SpawnUtil } from '../cli/utils/spawn.js';
+import { readEnvString } from '../common/ExternalServiceUtils.js';
 import { esmDirname, resolvePackageManager } from '../common/index.js';
-import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { existsSync, fsPromises as fs } from '../node-singletons/fs.js';
@@ -27,18 +27,6 @@ function findPackageRoot(startDir) {
     // Fallback to a reasonable default if package.json isn't found.
     return path.resolve(startDir, '../..');
 }
-const readEnvString = (key) => {
-    const anyEnv = Env;
-    const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get(key, '') : '';
-    if (typeof fromEnv === 'string' && fromEnv.trim() !== '')
-        return fromEnv;
-    if (typeof process !== 'undefined') {
-        const raw = process.env?.[key];
-        if (typeof raw === 'string')
-            return raw;
-    }
-    return fromEnv ?? '';
-};
 const getProjectCwd = () => process.cwd();
 const getProjectRootEnv = () => readEnvString('ZINTRUST_PROJECT_ROOT');
 const getAllowPostInstallEnv = () => readEnvString('ZINTRUST_ALLOW_POSTINSTALL').trim();

package/src/toolkit/Secrets/providers/AwsSecretsManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AwsSecretsManager.d.ts","sourceRoot":"","sources":["../../../../../src/toolkit/Secrets/providers/AwsSecretsManager.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAqHF,eAAO,MAAM,iBAAiB;qBACX;QACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACzE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC9D;iBAsDY,MAAM,EAAE;EAcrB,CAAC;AAEH,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"AwsSecretsManager.d.ts","sourceRoot":"","sources":["../../../../../src/toolkit/Secrets/providers/AwsSecretsManager.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AA0GF,eAAO,MAAM,iBAAiB;qBACX;QACf,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACzE,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC9D;iBAsDY,MAAM,EAAE;EAcrB,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/src/toolkit/Secrets/providers/AwsSecretsManager.js

@@ -1,19 +1,7 @@
+import { readEnvString } from '../../../common/ExternalServiceUtils.js';
 import { AwsSigV4 } from '../../../common/index.js';
-import { Env } from '../../../config/env.js';
 import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
 const sha256Hex = (data) => AwsSigV4.sha256Hex(data);
-const readEnvString = (key) => {
-    const anyEnv = Env;
-    const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get(key, '') : '';
-    if (typeof fromEnv === 'string' && fromEnv.trim() !== '')
-        return fromEnv;
-    if (typeof process !== 'undefined') {
-        const raw = process.env?.[key];
-        if (typeof raw === 'string')
-            return raw;
-    }
-    return fromEnv ?? '';
-};
 const buildAuthorization = (params) => {
     const canonicalUri = '/';
     const canonicalQueryString = '';

package/src/toolkit/Secrets/providers/CloudflareKv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudflareKv.d.ts","sourceRoot":"","sources":["../../../../../src/toolkit/Secrets/providers/CloudflareKv.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY;qBACN;QACf,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACxE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/E;iBAiFY,MAAM,EAAE;EAgBrB,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"CloudflareKv.d.ts","sourceRoot":"","sources":["../../../../../src/toolkit/Secrets/providers/CloudflareKv.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY;qBACN;QACf,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACxE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/E;iBAsEY,MAAM,EAAE;EAcrB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/src/toolkit/Secrets/providers/CloudflareKv.js

@@ -1,19 +1,7 @@
-import { Env } from '../../../config/env.js';
+import { readEnvString } from '../../../common/ExternalServiceUtils.js';
 import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
 export const CloudflareKv = Object.freeze({
     createFromEnv() {
-        const readEnvString = (key) => {
-            const anyEnv = Env;
-            const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get(key, '') : '';
-            if (typeof fromEnv === 'string' && fromEnv.trim() !== '')
-                return fromEnv;
-            if (typeof process !== 'undefined') {
-                const raw = process.env?.[key];
-                if (typeof raw === 'string')
-                    return raw;
-            }
-            return fromEnv ?? '';
-        };
         const accountId = readEnvString('CLOUDFLARE_ACCOUNT_ID');
         const apiToken = readEnvString('CLOUDFLARE_API_TOKEN');
         const defaultNamespaceId = readEnvString('CLOUDFLARE_KV_NAMESPACE_ID');
@@ -71,13 +59,13 @@ export const CloudflareKv = Object.freeze({
     },
     doctorEnv() {
         const missing = [];
-        const accountId = (Env.get?.('CLOUDFLARE_ACCOUNT_ID', '') ?? Env.CLOUDFLARE_ACCOUNT_ID).trim();
+        const accountId = readEnvString('CLOUDFLARE_ACCOUNT_ID').trim();
         if (accountId === '')
             missing.push('CLOUDFLARE_ACCOUNT_ID');
-        const apiToken = (Env.get?.('CLOUDFLARE_API_TOKEN', '') ?? Env.CLOUDFLARE_API_TOKEN).trim();
+        const apiToken = readEnvString('CLOUDFLARE_API_TOKEN').trim();
         if (apiToken === '')
             missing.push('CLOUDFLARE_API_TOKEN');
-        const namespaceId = (Env.get?.('CLOUDFLARE_KV_NAMESPACE_ID', '') ?? Env.CLOUDFLARE_KV_NAMESPACE_ID).trim();
+        const namespaceId = readEnvString('CLOUDFLARE_KV_NAMESPACE_ID').trim();
         if (namespaceId === '')
             missing.push('CLOUDFLARE_KV_NAMESPACE_ID');
         return missing;

package/src/tools/storage/drivers/S3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"S3.d.ts","sourceRoot":"","sources":["../../../../../src/tools/storage/drivers/S3.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAqHF,eAAO,MAAM,QAAQ;gBACD,QAAQ,OAAO,MAAM,WAAW,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBA8CjE,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;mBA0CpC,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;mBAkCxC,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBAoC9C,QAAQ,OAAO,MAAM,GAAG,MAAM;oBAOhC,QAAQ,OACX,MAAM,YACD;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;KAAE,GACvD,MAAM;EAqDT,CAAC;AAEH,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"S3.d.ts","sourceRoot":"","sources":["../../../../../src/tools/storage/drivers/S3.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAwGF,eAAO,MAAM,QAAQ;gBACD,QAAQ,OAAO,MAAM,WAAW,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBA8CjE,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;mBA0CpC,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;mBAkCxC,QAAQ,OAAO,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;gBAoC9C,QAAQ,OAAO,MAAM,GAAG,MAAM;oBAOhC,QAAQ,OACX,MAAM,YACD;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAA;KAAE,GACvD,MAAM;EAqDT,CAAC;AAEH,eAAe,QAAQ,CAAC"}

package/src/tools/storage/drivers/S3.js

@@ -1,5 +1,5 @@
+import { readEnvString } from '../../../common/ExternalServiceUtils.js';
 import { AwsSigV4 } from '../../../common/index.js';
-import { Env } from '../../../config/env.js';
 import { ErrorFactory } from '../../../exceptions/ZintrustError.js';
 import { createHash, createHmac } from '../../../node-singletons/crypto.js';
 const sha256Hex = (data) => createHash('sha256').update(data).digest('hex');
@@ -52,21 +52,9 @@ const buildCanonicalQueryString = (params) => {
     return entries.map(([k, v]) => `${k}=${v}`).join('&');
 };
 const getCredentials = (config) => {
-    const readEnvString = (key) => {
-        const anyEnv = Env;
-        const fromEnv = typeof anyEnv.get === 'function' ? anyEnv.get(key, '') : '';
-        if (typeof fromEnv === 'string' && fromEnv.trim() !== '')
-            return fromEnv;
-        if (typeof process !== 'undefined') {
-            const raw = process.env?.[key];
-            if (typeof raw === 'string')
-                return raw;
-        }
-        return fromEnv ?? '';
-    };
-    const accessKeyId = config.accessKeyId || readEnvString('AWS_ACCESS_KEY_ID') || Env.AWS_ACCESS_KEY_ID;
-    const secretAccessKey = config.secretAccessKey || readEnvString('AWS_SECRET_ACCESS_KEY') || Env.AWS_SECRET_ACCESS_KEY;
-    const sessionToken = readEnvString('AWS_SESSION_TOKEN') || Env.AWS_SESSION_TOKEN || undefined;
+    const accessKeyId = config.accessKeyId || readEnvString('AWS_ACCESS_KEY_ID');
+    const secretAccessKey = config.secretAccessKey || readEnvString('AWS_SECRET_ACCESS_KEY');
+    const sessionToken = readEnvString('AWS_SESSION_TOKEN') || undefined;
     if (accessKeyId.trim() === '' || secretAccessKey.trim() === '') {
         throw ErrorFactory.createConfigError('S3: missing AWS credentials');
     }