@zintrust/core 0.1.41 → 0.1.43

package/src/cli/commands/schedule/ScheduleCliSupport.js

@@ -0,0 +1,55 @@
+import { databaseConfig } from '../../../config/database.js';
+import { registerDatabasesFromRuntimeConfig } from '../../../orm/DatabaseRuntimeRegistration.js';
+import { SchedulerRuntime } from '../../../scheduler/SchedulerRuntime.js';
+const isSchedule = (value) => {
+    if (value === undefined || value === null || typeof value !== 'object')
+        return false;
+    return 'name' in value && typeof value.name === 'string';
+};
+const loadScheduleModules = async () => {
+    const coreSchedules = await import('../../../schedules/index.js');
+    let appSchedules = {};
+    try {
+        appSchedules = (await import('../../../../app/Schedules/index.js'));
+    }
+    catch {
+        appSchedules = {};
+    }
+    return {
+        core: Object.values(coreSchedules).filter(isSchedule),
+        app: Object.values(appSchedules).filter(isSchedule),
+    };
+};
+const shutdownCliResources = async () => {
+    try {
+        const mod = await import('../../../orm/ConnectionManager.js');
+        await mod.ConnectionManager.shutdownIfInitialized();
+    }
+    catch {
+        // best-effort
+    }
+    try {
+        const mod = await import('../../../orm/Database.js');
+        await mod.resetDatabase();
+    }
+    catch {
+        // best-effort
+    }
+    try {
+        const mod = (await import('../../../tools/queue/LockProvider.js'));
+        await mod.closeLockProvider?.();
+    }
+    catch {
+        // best-effort
+    }
+};
+export const ScheduleCliSupport = Object.freeze({
+    async registerAll() {
+        registerDatabasesFromRuntimeConfig(databaseConfig);
+        const modules = await loadScheduleModules();
+        SchedulerRuntime.registerMany(modules.core, 'core');
+        SchedulerRuntime.registerMany(modules.app, 'app');
+    },
+    shutdownCliResources,
+});
+export default ScheduleCliSupport;

package/src/cli/config/ConfigManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../../../src/cli/config/ConfigManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAYjD,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,IAAI,aAAa,CAAC;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC7C,MAAM,IAAI,MAAM,CAAC;IACjB,UAAU,IAAI,MAAM,EAAE,CAAC;CACxB;AAkHD;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;wBACgB,MAAM,GAAgC,cAAc;IAqCvE;;OAEG;6BAC4B,OAAO,CAAC,IAAI,CAAC;IAS5C;;OAEG;uBACsB,OAAO,CAAC,cAAc,CAAC;IAOhD;;OAEG;wBACuB,OAAO,CAAC,cAAc,CAAC;EAKjD,CAAC"}
+{"version":3,"file":"ConfigManager.d.ts","sourceRoot":"","sources":["../../../../src/cli/config/ConfigManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAgB9D,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,SAAS,IAAI,aAAa,CAAC;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IAC7C,MAAM,IAAI,MAAM,CAAC;IACjB,UAAU,IAAI,MAAM,EAAE,CAAC;CACxB;AAqHD;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB;;OAEG;wBACgB,MAAM,GAAgC,cAAc;IAqCvE;;OAEG;6BAC4B,OAAO,CAAC,IAAI,CAAC;IAU5C;;OAEG;uBACsB,OAAO,CAAC,cAAc,CAAC;IAOhD;;OAEG;wBACuB,OAAO,CAAC,cAAc,CAAC;EAKjD,CAAC"}

package/src/cli/config/ConfigManager.js

@@ -5,8 +5,11 @@
 import { ConfigPaths, DEFAULT_CONFIG, getConfigValue, setConfigValue, } from '../config/ConfigSchema.js';
 import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
-import { fsPromises as fs } from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
+const loadFsPromises = async () => {
+    const mod = await import('../../node-singletons/fs.js');
+    return mod.fsPromises;
+};
 /**
  * Deep merge helper
  */
@@ -27,6 +30,7 @@ const deepMerge = (target, source) => {
  */
 async function loadConfig(state) {
     try {
+        const fs = await loadFsPromises();
         const content = await fs.readFile(state.configPath, 'utf-8');
         state.config = JSON.parse(content);
         return state.config;
@@ -50,6 +54,7 @@ async function saveConfig(state, newConfig) {
         throw ErrorFactory.createConfigError('No configuration to save');
     }
     try {
+        const fs = await loadFsPromises();
         // Ensure directory exists
         const dir = path.dirname(state.configPath);
         if (dir !== '.') {
@@ -77,6 +82,7 @@ function getConfig(state) {
  */
 async function configExists(configPath) {
     try {
+        const fs = await loadFsPromises();
         await fs.access(configPath);
         return true;
     }
@@ -148,6 +154,7 @@ export const ConfigManager = Object.freeze({
      */
     async ensureGlobalConfigDir() {
         try {
+            const fs = await loadFsPromises();
             await fs.mkdir(ConfigPaths.GLOBAL_DIR, { recursive: true });
         }
         catch (err) {

package/src/cli/d1/D1SqlMigrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"D1SqlMigrations.d.ts","sourceRoot":"","sources":["../../../../src/cli/d1/D1SqlMigrations.ts"],"names":[],"mappings":"AAYA,KAAK,6BAA6B,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAoOF,eAAO,MAAM,eAAe;0BACE,6BAA6B,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;EAmC5F,CAAC"}
+{"version":3,"file":"D1SqlMigrations.d.ts","sourceRoot":"","sources":["../../../../src/cli/d1/D1SqlMigrations.ts"],"names":[],"mappings":"AAYA,KAAK,6BAA6B,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AA6OF,eAAO,MAAM,eAAe;0BACE,6BAA6B,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;EAmC5F,CAAC"}

package/src/cli/d1/D1SqlMigrations.js

@@ -25,6 +25,16 @@ const normalizeSql = (sql) => {
         return '';
     return trimmed.endsWith(';') ? trimmed : `${trimmed};`;
 };
+const normalizeAlterTableAddColumn = (sql) => {
+    const lowered = sql.trimStart().toLowerCase();
+    if (!lowered.startsWith('alter table'))
+        return sql;
+    if (!/\badd\b/i.test(sql))
+        return sql;
+    if (/\badd\s+column\b/i.test(sql))
+        return sql;
+    return sql.replace(/\bADD\b\s+(?!COLUMN\b)/i, 'ADD COLUMN ');
+};
 const interpolateSql = (sql, parameters) => {
     const placeholders = (sql.match(/\?/g) ?? []).length;
     if (placeholders !== parameters.length) {
@@ -90,7 +100,7 @@ const captureSql = (onSql, sql, parameters) => {
     const compiled = parameters.length > 0 ? interpolateSql(sql, parameters) : sql;
     if (!isMutatingSql(compiled))
         return;
-    const normalized = normalizeSql(compiled);
+    const normalized = normalizeSql(normalizeAlterTableAddColumn(compiled));
     if (normalized !== '')
         onSql(normalized);
 };

package/src/cli/d1/WranglerConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WranglerConfig.d.ts","sourceRoot":"","sources":["../../../../src/cli/d1/WranglerConfig.ts"],"names":[],"mappings":"AA2HA,eAAO,MAAM,cAAc;oCACO,MAAM,WAAW,MAAM,GAAG,MAAM;EAqBhE,CAAC"}
+{"version":3,"file":"WranglerConfig.d.ts","sourceRoot":"","sources":["../../../../src/cli/d1/WranglerConfig.ts"],"names":[],"mappings":"AA+KA,eAAO,MAAM,cAAc;oCACO,MAAM,WAAW,MAAM,GAAG,MAAM;EAqBhE,CAAC"}

package/src/cli/d1/WranglerConfig.js

@@ -98,6 +98,38 @@ const stripJsonc = (input) => {
     }
     return out.join('');
 };
+const createTrailingCommaState = () => ({
+    inString: false,
+    escaped: false,
+});
+const isWhitespace = (ch) => ch === ' ' || ch === '\n' || ch === '\r' || ch === '\t';
+const shouldDropTrailingComma = (input, fromIndex) => {
+    let j = fromIndex;
+    while (j < input.length) {
+        const next = input[j] ?? '';
+        if (isWhitespace(next)) {
+            j += 1;
+            continue;
+        }
+        return next === '}' || next === ']';
+    }
+    return true;
+};
+const stripTrailingCommas = (input) => {
+    const state = createTrailingCommaState();
+    const out = [];
+    for (let i = 0; i < input.length; i += 1) {
+        const ch = input[i] ?? '';
+        if (handleString(state, ch, out))
+            continue;
+        if (tryStartString(state, ch, out))
+            continue;
+        if (ch === ',' && shouldDropTrailingComma(input, i + 1))
+            continue;
+        out.push(ch);
+    }
+    return out.join('');
+};
 export const WranglerConfig = Object.freeze({
     getD1MigrationsDir(projectRoot, dbName) {
         const configPath = path.join(projectRoot, 'wrangler.jsonc');
@@ -105,12 +137,12 @@ export const WranglerConfig = Object.freeze({
             return 'migrations';
         try {
             const raw = fs.readFileSync(configPath, 'utf8');
-            const parsed = JSON.parse(stripJsonc(raw));
+            const parsed = JSON.parse(stripTrailingCommas(stripJsonc(raw)));
             const list = parsed.d1_databases;
             if (!Array.isArray(list) || list.length === 0)
                 return 'migrations';
             const match = typeof dbName === 'string'
-                ? list.find((d) => d.database_name === dbName)
+                ? list.find((d) => d.binding === dbName || d.database_name === dbName)
                 : (list[0] ?? undefined);
             const dir = match?.migrations_dir;
             return typeof dir === 'string' && dir.trim() !== '' ? dir : 'migrations';

package/src/cli/scaffolding/ProjectScaffolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,cAAc,IAAI,MAAM,CAAC;IACzB,sBAAsB,IAAI,OAAO,CAAC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtD,gBAAgB,IAAI,OAAO,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AA+eD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAsBrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AA4ID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAsB/F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}
+{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,cAAc,IAAI,MAAM,CAAC;IACzB,sBAAsB,IAAI,OAAO,CAAC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtD,gBAAgB,IAAI,OAAO,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AA8eD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAsBrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AA4ID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAsB/F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}

package/src/cli/scaffolding/ProjectScaffolder.js

@@ -125,41 +125,56 @@ const toSafeDbBasename = (raw) => {
     }
     return out === '' ? 'zintrust' : out;
 };
-const buildDatabaseEnvLinesWithName = (database, name) => {
-    if (database === 'postgresql' || database === 'postgres') {
-        return [
-            'DB_HOST=localhost',
-            'DB_PORT=5432',
-            'DB_DATABASE=zintrust',
-            'DB_USERNAME=postgres',
-            'DB_PASSWORD=',
-        ];
+const readEnvScaffoldTemplate = () => {
+    const templateUrl = new URL('./templates/env.scaffold.dotenv.tpl', import.meta.url);
+    return fs.readFileSync(templateUrl, 'utf8');
+};
+const renderEnvScaffold = (template, vars) => {
+    let out = template;
+    for (const [key, value] of Object.entries(vars)) {
+        out = out.replaceAll(`{{${key}}}`, value);
     }
-    if (database === 'mysql') {
-        return [
-            'DB_HOST=localhost',
-            'DB_PORT=3306',
-            'DB_DATABASE=zintrust',
-            'DB_USERNAME=root',
-            'DB_PASSWORD=',
-        ];
+    // Normalize: if a placeholder resolves to empty, prevent excessive blank blocks.
+    out = out.replaceAll('\n\n\n', '\n\n');
+    return out;
+};
+const buildDbOverrides = (dbConnection) => {
+    const normalized = dbConnection.trim().toLowerCase();
+    if (normalized === 'mysql') {
+        return {
+            dbLines: [
+                'DB_HOST=localhost',
+                'DB_PORT=3306',
+                'DB_DATABASE=zintrust',
+                'DB_USERNAME=root',
+                'DB_PASSWORD=',
+            ],
+        };
     }
-    if (database === 'sqlite') {
-        // Provide both DB_DATABASE (used by the framework) and DB_PATH (common alias)
-        const base = toSafeDbBasename(name);
-        return [`DB_DATABASE=.zintrust/dbs/${base}.sqlite`, `DB_PATH=.zintrust/dbs/${base}.sqlite`];
+    if (normalized === 'postgres' || normalized === 'postgresql') {
+        return {
+            dbLines: [
+                'DB_HOST=localhost',
+                'DB_PORT=5432',
+                'DB_DATABASE=zintrust',
+                'DB_USERNAME=postgres',
+                'DB_PASSWORD=',
+            ],
+        };
     }
-    if (database === 'd1-remote' || database === 'd1-proxy') {
-        return [
-            '# Cloudflare D1 Remote Proxy (HTTPS)',
-            'D1_REMOTE_URL=',
-            'D1_REMOTE_KEY_ID=',
-            'D1_REMOTE_SECRET=',
-            'D1_REMOTE_MODE=registry',
-            'ZT_PROXY_TIMEOUT_MS=15000',
-        ];
+    if (normalized === 'sqlserver' || normalized === 'mssql') {
+        return {
+            dbLines: [
+                'DB_HOST_MSSQL=localhost',
+                'DB_PORT_MSSQL=1433',
+                'DB_DATABASE_MSSQL=zintrust',
+                'DB_USERNAME_MSSQL=sa',
+                'DB_PASSWORD_MSSQL=',
+            ],
+        };
     }
-    return [];
+    // sqlite/d1/d1-remote/etc: no overrides here (DB_PATH is handled via SQLITE_DB_PATH placeholder)
+    return { dbLines: [] };
 };
 const createEnvFile = (projectPath, variables) => {
     try {
@@ -174,56 +189,33 @@ const createEnvFile = (projectPath, variables) => {
                 HOST: 'localhost',
                 PORT: String(Number(variables['port'] ?? 7777)),
                 LOG_LEVEL: 'debug',
-                CSRF_SKIP_PATHS: '/api/*,/queue-monitor/*',
+                CSRF_SKIP_PATHS: '/api/*,/queue-monitor/*,/api/_sys/queue/*,/api/_sys/schedule/*',
             });
             return true;
         }
         const name = typeof variables['projectName'] === 'string' ? variables['projectName'] : 'zintrust-app';
         const port = Number(variables['port'] ?? 7777);
         const database = typeof variables['database'] === 'string' ? variables['database'] : 'sqlite';
+        const baseUrl = `http://localhost:${port}`;
+        const dbConnection = database.trim().toLowerCase();
+        const sqliteDbPath = `.zintrust/dbs/${toSafeDbBasename(name)}.sqlite`;
         // Generate a secure APP_KEY (32 bytes = 256-bit, base64 encoded)
         const appKeyBytes = randomBytes(32);
-        const appKey = appKeyBytes.toString('base64');
-        const baseLines = [
-            'NODE_ENV=development',
-            'STARTUP_REQUIRE_ENV=true',
-            `APP_NAME=${name}`,
-            'HOST=localhost',
-            `PORT=${port}`,
-            'APP_DEBUG=true',
-            // Auto-generated secure key for storage signing and encryption
-            `APP_KEY=${appKey}`,
-            `DB_CONNECTION=${database}`,
-        ];
-        const dbLines = buildDatabaseEnvLinesWithName(database, name);
-        const placeholderLines = [
-            '',
-            '# Logging',
-            'LOG_LEVEL=debug',
-            'LOG_CHANNEL=file',
-            'LOG_FORMAT=text',
-            '',
-            '# Auth / Security',
-            'JWT_SECRET=',
-            'JWT_EXPIRES_IN=1h',
-            'CSRF_SECRET=',
-            'CSRF_SKIP_PATHS=/api/*,/queue-monitor/*',
-            'ENCRYPTION_CIPHER=aes-256-cbc',
-            'APP_PREVIOUS_KEYS=',
-            '',
-            '# Cache / Queue',
-            'CACHE_DRIVER=memory',
-            'CACHE_TTL=300',
-            'QUEUE_DRIVER=sync',
-            '',
-            '# Microservices',
-            'SERVICE_DISCOVERY_ENABLED=false',
-            'SERVICE_DISCOVERY_TYPE=filesystem',
-            'SERVICE_NAME=',
-            'SERVICE_VERSION=1.0.0',
-        ];
-        const lines = [...baseLines, ...dbLines, ...placeholderLines];
-        fs.writeFileSync(fullPath, lines.join('\n') + '\n');
+        // Keep consistent with `zin key:generate` output.
+        const appKey = `base64:${appKeyBytes.toString('base64')}`;
+        const { dbLines } = buildDbOverrides(dbConnection);
+        const dbLinesBlock = dbLines.join('\n');
+        const template = readEnvScaffoldTemplate();
+        const content = renderEnvScaffold(template, {
+            APP_NAME: name,
+            PORT: String(port),
+            BASE_URL: baseUrl,
+            APP_KEY: appKey,
+            DB_CONNECTION: dbConnection,
+            SQLITE_DB_PATH: sqliteDbPath,
+            DB_LINES: dbLinesBlock,
+        });
+        fs.writeFileSync(fullPath, content.endsWith('\n') ? content : content + '\n');
         return true;
     }
     catch {

package/src/cli/services/VersionChecker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VersionChecker.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/VersionChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKlE,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc;IACzB;;OAEG;qCAC8B,MAAM,GAAG,MAAM,GAAG,IAAI;IAcvD;;OAEG;yBACkB,MAAM;IAkB3B;;OAEG;iBACU,kBAAkB;IAQ/B;;OAEG;0BACmB,OAAO;IAqC7B;;OAEG;oCAC6B,MAAM,GAAG,MAAM,GAAG,IAAI;IAwBtD;;OAEG;gCACyB,MAAM,GAAG,IAAI;IAezC;;OAEG;0BACyB,OAAO,CAAC,MAAM,CAAC;IA6B3C;;OAEG;4BAC2B,OAAO,CAAC,aAAa,CAAC;IAQpD;;OAEG;uBACgB,MAAM;IAIzB;;OAEG;qCAC8B,OAAO,GAAG,MAAM;IAuBjD;;OAEG;8BACuB,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInE;;OAEG;uCACgC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAY1E;;OAEG;oCAC6B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAQvE;;OAEG;6BACsB,MAAM,UAAU,MAAM,GAAG,MAAM;IAuBxD;;OAEG;oBACmB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAyBxD;;OAEG;sCAC+B,kBAAkB,GAAG,IAAI;IA4B3D;;OAEG;uBACsB,OAAO,CAAC,IAAI,CAAC;EAUtC,CAAC"}
+{"version":3,"file":"VersionChecker.d.ts","sourceRoot":"","sources":["../../../../src/cli/services/VersionChecker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKlE,UAAU,kBAAkB;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc;IACzB;;OAEG;qCAC8B,MAAM,GAAG,MAAM,GAAG,IAAI;IAcvD;;OAEG;yBACkB,MAAM;IAkB3B;;OAEG;iBACU,kBAAkB;IAQ/B;;OAEG;0BACmB,OAAO;IAyC7B;;OAEG;oCAC6B,MAAM,GAAG,MAAM,GAAG,IAAI;IAwBtD;;OAEG;gCACyB,MAAM,GAAG,IAAI;IAezC;;OAEG;0BACyB,OAAO,CAAC,MAAM,CAAC;IA6B3C;;OAEG;4BAC2B,OAAO,CAAC,aAAa,CAAC;IAQpD;;OAEG;uBACgB,MAAM;IAIzB;;OAEG;qCAC8B,OAAO,GAAG,MAAM;IAuBjD;;OAEG;8BACuB,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInE;;OAEG;uCACgC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAY1E;;OAEG;oCAC6B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;IAQvE;;OAEG;6BACsB,MAAM,UAAU,MAAM,GAAG,MAAM;IAuBxD;;OAEG;oBACmB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAyBxD;;OAEG;sCAC+B,kBAAkB,GAAG,IAAI;IA4B3D;;OAEG;uBACsB,OAAO,CAAC,IAAI,CAAC;EAUtC,CAAC"}

package/src/cli/services/VersionChecker.js

@@ -68,7 +68,11 @@ export const VersionChecker = Object.freeze({
             args.has('--version') ||
             args.has('help') ||
             args.has('new') ||
-            args.has('migrate')) {
+            args.has('migrate') ||
+            // One-shot schedule commands should exit cleanly and not keep the event loop alive
+            // due to background network requests/keep-alive sockets.
+            args.has('schedule:run') ||
+            args.has('schedule:list')) {
             return false;
         }
         // Check last check time

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

@@ -1 +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"}
+{"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;AAIrE,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,iBAwCjE,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

@@ -1,7 +1,12 @@
 import { PromptHelper } from '../PromptHelper.js';
 import { Env } from '../../config/env.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 export const mapConnectionToOrmConfig = (conn) => {
     switch (conn.driver) {
+        case 'd1':
+            return { driver: 'd1' };
+        case 'd1-remote':
+            return { driver: 'd1-remote' };
         case 'sqlite':
             return { driver: 'sqlite', database: conn.database ?? ':memory:' };
         case 'postgresql':
@@ -32,7 +37,7 @@ export const mapConnectionToOrmConfig = (conn) => {
                 password: conn.password,
             };
         default:
-            return { driver: 'sqlite', database: ':memory:' };
+            throw ErrorFactory.createCliError(`Unsupported database driver for ORM migrations: ${String(conn.driver)}`);
     }
 };
 export const parseRollbackSteps = (options) => {

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

@@ -1 +1 @@
-{"version":3,"file":"DistPackager.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/DistPackager.ts"],"names":[],"mappings":"AAoIA,eAAO,MAAM,YAAY;IACvB;;;OAGG;sBACe,MAAM,aAAY,MAAM,GAAmB,IAAI;EAgBjE,CAAC"}
+{"version":3,"file":"DistPackager.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/DistPackager.ts"],"names":[],"mappings":"AAsLA,eAAO,MAAM,YAAY;IACvB;;;OAGG;sBACe,MAAM,aAAY,MAAM,GAAmB,IAAI;EAgBjE,CAAC"}

package/src/cli/utils/DistPackager.js

@@ -49,6 +49,31 @@ const buildDistPackageJson = (rootPkg) => {
                 types: './start.d.ts',
                 default: './start.js',
             },
+            './cli': {
+                types: './src/cli.d.ts',
+                default: './src/cli.js',
+            },
+            './proxy': {
+                types: './src/proxy.d.ts',
+                default: './src/proxy.js',
+            },
+            './collections': {
+                types: './src/collections/index.d.ts',
+                default: './src/collections/index.js',
+            },
+            './helper': {
+                types: './src/helper/index.d.ts',
+                default: './src/helper/index.js',
+            },
+            './node': {
+                types: './src/node.d.ts',
+                default: './src/node.js',
+            },
+            './routes/*': {
+                types: './routes/*.d.ts',
+                default: './routes/*.js',
+            },
+            './package.json': './package.json',
         },
         dependencies: coerceDependencies(rootPkg.dependencies),
     };

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

@@ -11,6 +11,7 @@ type CliOverrides = {
     nodeEnv?: node_env;
     port?: number;
     runtime?: string;
+    cacheEnabled?: boolean;
 };
 export declare const EnvFileLoader: Readonly<{
     load: (options?: LoadOptions) => LoadState;

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

@@ -1 +1 @@
-{"version":3,"file":"EnvFileLoader.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/EnvFileLoader.ts"],"names":[],"mappings":"AAQA,KAAK,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAoGzD,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA2FF,eAAO,MAAM,aAAa;qBAlEH,WAAW,KAAQ,SAAS;wBAmC1B,SAAS;mCAEI,YAAY,KAAG,IAAI;oBA2BpC,SAAS;EAO5B,CAAC"}
+{"version":3,"file":"EnvFileLoader.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/EnvFileLoader.ts"],"names":[],"mappings":"AAQA,KAAK,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAmIzD,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AA+FF,eAAO,MAAM,aAAa;qBAtEH,WAAW,KAAQ,SAAS;wBAmC1B,SAAS;mCAEI,YAAY,KAAG,IAAI;oBA+BpC,SAAS;EAO5B,CAAC"}

package/src/cli/utils/EnvFileLoader.js

@@ -1,6 +1,25 @@
 import { Env } from '../../config/env.js';
 import { existsSync, readFileSync } from '../../node-singletons/fs.js';
 import { join } from '../../node-singletons/path.js';
+const safeEnvGet = (key, defaultValue = '') => {
+    const envAny = Env;
+    if (typeof envAny.get === 'function')
+        return envAny.get(key, defaultValue);
+    const fromProcess = typeof process === 'undefined' ? undefined : process.env?.[key];
+    if (typeof fromProcess === 'string' && fromProcess !== '')
+        return fromProcess;
+    return defaultValue;
+};
+const safeEnvSet = (key, value) => {
+    const envAny = Env;
+    if (typeof envAny.set === 'function') {
+        envAny.set(key, value);
+        return;
+    }
+    if (typeof process === 'undefined' || process.env === undefined)
+        return;
+    process.env[key] = value;
+};
 const normalizeAppMode = (value) => {
     const normalized = value.trim().toLowerCase();
     if (normalized === 'production' || normalized === 'pro' || normalized === 'prod')
@@ -56,19 +75,30 @@ const parseEnvFile = (raw) => {
         const rhs = withoutExport.slice(eq + 1);
         const withoutComment = stripInlineComment(rhs);
         const value = unquote(withoutComment);
+        // DX: treat empty assignments as "no-op" if the key already had a non-empty value earlier
+        // in the same file. This prevents accidental overrides like:
+        //   KV_NAMESPACE_ID=abc
+        //   ...
+        //   KV_NAMESPACE_ID=
+        if (value.trim() === '' && (result[key]?.trim() ?? '') !== '')
+            continue;
         result[key] = value;
     }
     return result;
 };
 const applyToProcessEnv = (values, overrideExisting) => {
     for (const [key, value] of Object.entries(values)) {
-        if (!overrideExisting && Env.get(key, '') !== '')
+        if (!overrideExisting && safeEnvGet(key, '') !== '')
+            continue;
+        // DX: don't wipe an already-populated env var with an empty value from an env file.
+        // This avoids surprising behavior when env templates include duplicate keys with blanks.
+        if (value.trim() === '' && safeEnvGet(key, '').trim() !== '')
             continue;
-        Env.set(key, value);
+        safeEnvSet(key, value);
     }
     // Compatibility helpers
-    if (Env.get('PORT', '') === '' && Env.get('APP_PORT', '') !== '') {
-        Env.set('PORT', Env.get('APP_PORT', ''));
+    if (safeEnvGet('PORT', '') === '' && safeEnvGet('APP_PORT', '') !== '') {
+        safeEnvSet('PORT', safeEnvGet('APP_PORT', ''));
     }
 };
 const readEnvFileIfExists = (cwd, filename) => {
@@ -79,7 +109,7 @@ const readEnvFileIfExists = (cwd, filename) => {
     return parseEnvFile(raw);
 };
 const resolveAppMode = (cwd) => {
-    const existing = Env.get('NODE_ENV', '');
+    const existing = safeEnvGet('NODE_ENV', '');
     if (existing.trim() !== '')
         return normalizeAppMode(existing);
     const fromDotEnv = readEnvFileIfExists(cwd, '.env');
@@ -131,7 +161,7 @@ const load = (options = {}) => {
     }
     // Set NODE_ENV to the normalized mode if we have one (after applying files)
     if (mode !== undefined) {
-        Env.set('NODE_ENV', mode);
+        safeEnvSet('NODE_ENV', mode);
     }
     cached = { loadedFiles: files, mode };
     return cached;
@@ -141,21 +171,24 @@ const applyCliOverrides = (overrides) => {
     // Ensure base env is loaded first.
     ensureLoaded();
     if (typeof overrides.runtime === 'string' && overrides.runtime.trim() !== '') {
-        Env.set('RUNTIME', overrides.runtime.trim());
+        safeEnvSet('RUNTIME', overrides.runtime.trim());
     }
     if (typeof overrides.nodeEnv === 'string') {
-        Env.set('NODE_ENV', overrides.nodeEnv);
+        safeEnvSet('NODE_ENV', overrides.nodeEnv);
     }
     if (typeof overrides.port === 'number') {
-        Env.set('PORT', String(overrides.port));
-        Env.set('APP_PORT', String(overrides.port));
+        safeEnvSet('PORT', String(overrides.port));
+        safeEnvSet('APP_PORT', String(overrides.port));
+    }
+    if (typeof overrides.cacheEnabled === 'boolean') {
+        safeEnvSet('CACHE_ENABLED', String(overrides.cacheEnabled));
     }
     // Keep PORT/APP_PORT in sync if only one exists.
-    if (Env.get('PORT', '') === '' && Env.get('APP_PORT', '') !== '') {
-        Env.set('PORT', Env.get('APP_PORT', ''));
+    if (safeEnvGet('PORT', '') === '' && safeEnvGet('APP_PORT', '') !== '') {
+        safeEnvSet('PORT', safeEnvGet('APP_PORT', ''));
     }
-    if (Env.get('APP_PORT', '') === '' && Env.get('PORT', '') !== '') {
-        Env.set('APP_PORT', Env.get('PORT', ''));
+    if (safeEnvGet('APP_PORT', '') === '' && safeEnvGet('PORT', '') !== '') {
+        safeEnvSet('APP_PORT', safeEnvGet('PORT', ''));
     }
 };
 const getState = () => ensureLoaded();

package/src/cli.d.ts

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

package/src/cli.d.ts.map

@@ -0,0 +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,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/src/cli.js

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

package/src/collections/index.d.ts

@@ -1,3 +1,3 @@
-export { collect, Collection } from '../collections/Collection';
-export type { ICollection, PrimitiveKey } from '../collections/Collection';
+export { collect, Collection } from './Collection';
+export type { ICollection, PrimitiveKey } from './Collection';
 //# sourceMappingURL=index.d.ts.map

package/src/collections/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/src/collections/index.js

@@ -1 +1 @@
-export { collect, Collection } from '../collections/Collection.js';
+export { collect, Collection } from './Collection.js';

package/src/common/RemoteSignedJson.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteSignedJson.d.ts","sourceRoot":"","sources":["../../../src/common/RemoteSignedJson.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB,EAAE,MAAM,CAAC;IAElC,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAiEF,eAAO,MAAM,gBAAgB;YACb,CAAC,YACH,wBAAwB,QAC5B,MAAM,WACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;EAuDb,CAAC;AAEH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"RemoteSignedJson.d.ts","sourceRoot":"","sources":["../../../src/common/RemoteSignedJson.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAEpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yBAAyB,EAAE,MAAM,CAAC;IAElC,QAAQ,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAoHF,eAAO,MAAM,gBAAgB;YACb,CAAC,YACH,wBAAwB,QAC5B,MAAM,WACH,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;EA0Cb,CAAC;AAEH,eAAe,gBAAgB,CAAC"}