@zintrust/core 0.4.42 → 0.4.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.42",
+  "version": "0.4.49",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -58,7 +58,7 @@
   },
   "dependencies": {
     "@cloudflare/containers": "^0.2.0",
-    "@zintrust/workers": "^0.4.42",
+    "@zintrust/workers": "0.4.49",
     "bcryptjs": "^3.0.3",
     "bullmq": "^5.71.1",
     "chalk": "^5.6.2",

package/src/boot/bootstrap.js

@@ -6,6 +6,7 @@
 import { Application } from './Application.js';
 import { Server } from './Server.js';
 import { appConfig } from '../config/app.js';
+import { Cloudflare } from '../config/cloudflare.js';
 import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
@@ -16,6 +17,9 @@ let appInstance;
 let serverInstance;
 let isShuttingDown = false;
 let shutdownHandlersRegistered = false;
+const shouldSkipProjectPluginAutoImports = () => {
+    return appConfig.cloudflareWorker === true || Cloudflare.getWorkersEnv() !== null;
+};
 const logBootstrapErrorDetails = (error) => {
     // Best-effort: surface startup config validation details (already redacted)
     // so container runs show which env vars are missing/misconfigured.
@@ -210,9 +214,11 @@ const BootstrapFunctions = Object.freeze({
                         Logger.warn('Official plugin auto-imports failed:', ErrorFactory.createGeneralError('officialImports', officialImports.errorMessage));
                     }
                 }
-                const projectImports = await PluginAutoImports.tryImportProjectAutoImports();
-                if (!projectImports.ok && projectImports.reason !== 'not-found') {
-                    Logger.warn('Project plugin auto-imports failed:', ErrorFactory.createGeneralError('projectImports', projectImports.errorMessage));
+                if (!shouldSkipProjectPluginAutoImports()) {
+                    const projectImports = await PluginAutoImports.tryImportProjectAutoImports();
+                    if (!projectImports.ok && projectImports.reason !== 'not-found') {
+                        Logger.warn('Project plugin auto-imports failed:', ErrorFactory.createGeneralError('projectImports', projectImports.errorMessage));
+                    }
                 }
             }
             catch (error) {

package/src/boot/registry/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA+N9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA4BlF,CAAC;AA6RF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CA8E7D,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAiN9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA4BlF,CAAC;AA8NF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CA8E7D,CAAC"}

package/src/boot/registry/runtime.js

@@ -5,6 +5,7 @@ import { registerCachesFromRuntimeConfig } from '../../cache/CacheRuntimeRegistr
 import { readEnvString } from '../../common/ExternalServiceUtils.js';
 import broadcastConfig from '../../config/broadcast.js';
 import { Cloudflare } from '../../config/cloudflare.js';
+import { databaseConfig as liveDatabaseConfig } from '../../config/database.js';
 import { FeatureFlags } from '../../config/features.js';
 import { Logger } from '../../config/logger.js';
 import notificationConfig from '../../config/notification.js';
@@ -12,7 +13,6 @@ import { StartupConfigValidator } from '../../config/StartupConfigValidator.js';
 import { existsSync } from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
 import { pathToFileURL } from '../../node-singletons/url.js';
-import { useDatabase } from '../../orm/Database.js';
 import { registerDatabasesFromRuntimeConfig } from '../../orm/DatabaseRuntimeRegistration.js';
 import { registerMasterRoutes, tryImportOptional } from './registerRoute.js';
 import { registerWorkerShutdownHook } from './worker.js';
@@ -85,15 +85,14 @@ const appConfig = readRuntimeConfig('appConfig', {
 });
 // exported solely for tests to exercise the default detectRuntime handler
 const cacheConfig = readRuntimeConfig('cacheConfig', RuntimeConfig.cacheConfig);
-const databaseConfig = readRuntimeConfig('databaseConfig', {
-    default: 'sqlite',
-    connections: {},
-});
 const queueConfig = readRuntimeConfig('queueConfig', RuntimeConfig.queueConfig);
 const storageConfig = readRuntimeConfig('storageConfig', RuntimeConfig.storageConfig);
+const getDatabaseConfig = () => {
+    return readRuntimeConfig('databaseConfig', liveDatabaseConfig);
+};
 // eslint-disable-next-line @typescript-eslint/require-await
 const dbLoader = async () => {
-    registerDatabasesFromRuntimeConfig(databaseConfig);
+    registerDatabasesFromRuntimeConfig(getDatabaseConfig());
 };
 const queuesLoader = async () => {
     await registerQueuesFromRuntimeConfig(queueConfig);
@@ -356,75 +355,24 @@ const isSystemDebuggerPluginRequested = () => {
     const globalDebuggerPluginState = globalThis;
     return globalDebuggerPluginState.__zintrust_system_debugger_plugin_requested__ === true;
 };
-const resolveDebuggerBasePath = () => {
-    const raw = readEnvString('DEBUGGER_BASE_PATH').trim();
-    if (raw === '')
-        return '/debugger';
-    return raw.startsWith('/') ? raw : `/${raw}`;
-};
-const resolveDebuggerMiddleware = () => {
-    const raw = readEnvString('DEBUGGER_MIDDLEWARE').trim();
-    if (raw === '')
-        return [];
-    return raw
-        .split(',')
-        .map((segment) => segment.trim())
-        .filter((segment) => segment !== '');
-};
-const resolveDebuggerConnectionName = (configuredConnection) => {
-    const explicitConnection = configuredConnection?.trim();
-    if (explicitConnection !== undefined && explicitConnection !== '')
-        return explicitConnection;
-    const defaultConnection = readEnvString('DB_CONNECTION').trim();
-    if (defaultConnection === '')
-        return 'default';
-    return defaultConnection;
-};
-const hasDebuggerRouteRegistered = (router, basePath) => {
-    return router.routes.some((route) => {
-        return (route.path === basePath ||
-            route.path === `${basePath}/*` ||
-            route.path.startsWith(`${basePath}/api`));
-    });
-};
-const initializeSystemDebugger = async (router) => {
+const initializeSystemDebugger = async () => {
     if (!isSystemDebuggerPluginRequested()) {
-        Logger.debug('System Debugger plugin is not enabled in zintrust.plugins.*. Skipping mount.');
+        Logger.debug('System Debugger plugin is not enabled in zintrust.plugins.*. Skipping init.');
         return;
     }
     if (!isDebuggerEnabled())
         return;
-    const debuggerModule = (await tryImportOptional('@zintrust/system-debugger')) ??
-        (await loadLocalSystemDebuggerModule());
-    if (debuggerModule === undefined) {
+    const debuggerModule = (await tryImportOptional('@runtime/plugins/system-debugger-runtime')) ?? (await loadLocalSystemDebuggerModule());
+    if (debuggerModule === undefined || debuggerModule.isAvailable?.() === false) {
         Logger.debug('System Debugger is enabled but the optional package is unavailable.');
         return;
     }
-    const debuggerRegisterModule = await tryImportOptional('@zintrust/system-debugger/register');
-    if (debuggerRegisterModule === undefined) {
-        const localDebuggerModule = await loadLocalSystemDebuggerModule();
-        if (localDebuggerModule === undefined) {
-            Logger.warn('System Debugger plugin was requested but the register module could not be loaded.');
-            return;
-        }
-        Logger.debug('System Debugger register module is unavailable in source mode. Mounting dashboard routes without source fallback auto-registration.');
-    }
-    const config = debuggerModule.DebuggerConfig.merge();
-    const basePath = resolveDebuggerBasePath();
-    if (hasDebuggerRouteRegistered(router, basePath))
-        return;
     try {
-        const db = useDatabase(undefined, resolveDebuggerConnectionName(config.connection));
-        const storage = debuggerModule.DebuggerStorage.resolveStorage(db);
-        const middleware = resolveDebuggerMiddleware();
-        debuggerModule.registerDebuggerRoutes(router, storage, {
-            basePath,
-            middleware: middleware.length > 0 ? middleware : undefined,
-        });
-        Logger.info(`System Debugger routes registered at http://127.0.0.1:${appConfig.port}${basePath}`);
+        await debuggerModule.ensureSystemDebuggerRegistered();
+        Logger.info('System Debugger runtime activated. Register dashboard routes manually if needed.');
     }
     catch (error) {
-        Logger.warn('Failed to register System Debugger routes', error);
+        Logger.warn('Failed to initialize System Debugger runtime', error);
     }
 };
 export const createLifecycle = (params) => {
@@ -454,7 +402,7 @@ export const createLifecycle = (params) => {
         await registerFromRuntimeConfig();
         await initializeArtifactDirectories(params.resolvedBasePath);
         await registerMasterRoutes(params.resolvedBasePath, params.router);
-        await initializeSystemDebugger(params.router);
+        await initializeSystemDebugger();
         if (Cloudflare.getWorkersEnv() === null &&
             appConfig.dockerWorker === false &&
             appConfig.worker === true) {

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

@@ -1 +1 @@
-{"version":3,"file":"DebuggerCommands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/DebuggerCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqBrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqhBzC,eAAO,MAAM,gBAAgB;sCACK,YAAY;sCAQZ,YAAY;uCAaX,YAAY;wCAgBX,YAAY;;cA7C5B,MAAM;oBAAc,MAAM,OAAO;;;cAAjC,MAAM;oBAAc,MAAM,OAAO;;;cAAjC,MAAM;oBAAc,MAAM,OAAO;;;cAAjC,MAAM;oBAAc,MAAM,OAAO;;EAoEnD,CAAC"}
+{"version":3,"file":"DebuggerCommands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/DebuggerCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAsBrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0oBzC,eAAO,MAAM,gBAAgB;sCACK,YAAY;sCAQZ,YAAY;uCAaX,YAAY;wCAgBX,YAAY;;cA7C5B,MAAM;oBAAc,MAAM,OAAO;;;cAAjC,MAAM;oBAAc,MAAM,OAAO;;;cAAjC,MAAM;oBAAc,MAAM,OAAO;;;cAAjC,MAAM;oBAAc,MAAM,OAAO;;EAoEnD,CAAC"}

package/src/cli/commands/DebuggerCommands.js

@@ -9,6 +9,7 @@ import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { isNonEmptyString } from '../../helper/index.js';
 import { Migrator } from '../../migrations/Migrator.js';
+import { existsSync } from '../../node-singletons/fs.js';
 import { createRequire } from '../../node-singletons/module.js';
 import * as path from '../../node-singletons/path.js';
 import { Database } from '../../orm/Database.js';
@@ -56,14 +57,47 @@ const resolveDashboardUrl = () => {
     const port = readEnvString('PORT').trim() || readEnvString('APP_PORT').trim() || '7777';
     return `http://${host}:${port}${resolveDashboardBasePath()}`;
 };
-const resolveDebuggerMigrationDir = () => {
+const resolveDebuggerMigrationTargetFromResolvedPath = (resolvedPath) => {
+    const extension = path.extname(resolvedPath).toLowerCase();
+    const dir = path.dirname(resolvedPath);
+    if (extension === '.js' || extension === '.mjs' || extension === '.cjs') {
+        return {
+            dir,
+            extension: extension.slice(1),
+        };
+    }
+    if (extension === '.ts') {
+        const baseName = path.basename(resolvedPath, extension);
+        for (const candidateExt of ['.js', '.mjs', '.cjs']) {
+            const candidatePath = path.join(dir, `${baseName}${candidateExt}`);
+            if (!existsSync(candidatePath))
+                continue;
+            return {
+                dir,
+                extension: candidateExt.slice(1),
+            };
+        }
+        throw ErrorFactory.createCliError('Installed package "@zintrust/system-debugger" exposes TypeScript-only migrations. Upgrade to a version that publishes runnable JavaScript migrations.');
+    }
+    return {
+        dir,
+        extension: databaseConfig.migrations.extension,
+    };
+};
+const resolveDebuggerMigrationTarget = () => {
     const requireFromProject = createRequire(path.join(process.cwd(), 'package.json'));
     try {
         const resolved = requireFromProject.resolve('@zintrust/system-debugger/migrations');
-        return path.dirname(resolved);
+        return resolveDebuggerMigrationTargetFromResolvedPath(resolved);
     }
-    catch {
-        return path.join(process.cwd(), 'packages', 'system-debugger', 'migrations');
+    catch (error) {
+        if (error instanceof Error && error.message.includes('TypeScript-only migrations')) {
+            throw error;
+        }
+        return {
+            dir: path.join(process.cwd(), 'packages', 'system-debugger', 'migrations'),
+            extension: 'ts',
+        };
     }
 };
 const getD1DatabaseName = (options) => {
@@ -82,11 +116,40 @@ const getD1DatabaseName = (options) => {
     return 'zintrust_db';
 };
 const getInteractive = (options) => options['interactive'] !== false;
+const resolveRuntimeDefaultConnectionName = () => {
+    const configuredDefault = String(databaseConfig.default ?? '').trim();
+    return configuredDefault === '' ? 'default' : configuredDefault;
+};
+const normalizeConnectionName = (value) => {
+    const normalized = value.trim();
+    if (normalized === '' || normalized === 'default') {
+        return resolveRuntimeDefaultConnectionName();
+    }
+    return normalized;
+};
 const resolveDebuggerConnectionName = (options) => {
     if (isNonEmptyString(options['connection'])) {
-        return String(options['connection']).trim();
+        return normalizeConnectionName(String(options['connection']));
     }
-    return readEnvString('DEBUGGER_DB_CONNECTION').trim() || 'default';
+    return normalizeConnectionName(readEnvString('DEBUGGER_DB_CONNECTION').trim());
+};
+const withConfiguredDebuggerConnection = (options, configuredConnection) => {
+    if (isNonEmptyString(options['connection'])) {
+        return {
+            ...options,
+            connection: resolveDebuggerConnectionName(options),
+        };
+    }
+    if (isNonEmptyString(configuredConnection)) {
+        return {
+            ...options,
+            connection: normalizeConnectionName(configuredConnection),
+        };
+    }
+    return {
+        ...options,
+        connection: resolveDebuggerConnectionName(options),
+    };
 };
 const resolveDebuggerConnectionConfig = (options) => {
     const selected = resolveDebuggerConnectionName(options);
@@ -97,9 +160,24 @@ const isD1ConnectionDriver = (driver) => driver === 'd1' || driver === 'd1-remot
 const resolveD1ExecutionMode = (options) => {
     return options['local'] === true || options['remote'] !== true;
 };
-const ANSI_ESCAPE_PATTERN = new RegExp(String.raw `\u001b\[[0-9;]*m`, 'g');
+const ANSI_ESCAPE = String.fromCodePoint(27);
 const stripAnsi = (value) => {
-    return value.replaceAll(ANSI_ESCAPE_PATTERN, '');
+    let output = '';
+    for (let index = 0; index < value.length; index += 1) {
+        const char = value[index];
+        if (char !== ANSI_ESCAPE) {
+            output += char;
+            continue;
+        }
+        if (value[index + 1] !== '[') {
+            continue;
+        }
+        index += 2;
+        while (index < value.length && value[index] !== 'm') {
+            index += 1;
+        }
+    }
+    return output;
 };
 const extractWranglerJson = (output) => {
     const normalized = stripAnsi(output);
@@ -131,6 +209,26 @@ const parseWranglerTable = (output) => {
         return Object.fromEntries(headers.map((header, index) => [header, cells[index] ?? '']));
     });
 };
+const buildStatsFromJsonPayload = (payload) => {
+    const stats = {};
+    for (const row of payload[0]?.results ?? []) {
+        if (typeof row.type === 'string') {
+            stats[row.type] = typeof row.cnt === 'number' ? row.cnt : 0;
+        }
+    }
+    return stats;
+};
+const buildStatsFromTableRows = (rows) => {
+    const stats = {};
+    for (const row of rows) {
+        const key = row['type'] ?? '';
+        const count = Number.parseInt(row['cnt'] ?? '0', 10);
+        if (key !== '') {
+            stats[key] = Number.isNaN(count) ? 0 : count;
+        }
+    }
+    return stats;
+};
 const withSqlDebuggerStorage = async (options, callback) => {
     const { DebuggerStorage } = await loadDebuggerModule();
     const conn = resolveDebuggerConnectionConfig(options);
@@ -152,24 +250,9 @@ const executeD1Stats = (options) => {
     });
     const payload = extractWranglerJson(output);
     if (payload !== null) {
-        const stats = {};
-        for (const row of payload[0]?.results ?? []) {
-            if (typeof row.type === 'string') {
-                stats[row.type] = typeof row.cnt === 'number' ? row.cnt : 0;
-            }
-        }
-        return stats;
-    }
-    const rows = parseWranglerTable(output);
-    const stats = {};
-    for (const row of rows) {
-        const key = row['type'] ?? '';
-        const count = Number.parseInt(row['cnt'] ?? '0', 10);
-        if (key !== '') {
-            stats[key] = Number.isNaN(count) ? 0 : count;
-        }
+        return buildStatsFromJsonPayload(payload);
     }
-    return stats;
+    return buildStatsFromTableRows(parseWranglerTable(output));
 };
 const executeD1Delete = (options, sql) => {
     const output = WranglerD1.executeSql({
@@ -196,53 +279,50 @@ const isDestructiveAction = (options) => options['fresh'] === true || options['r
 const executePrune = async (options) => {
     const { DebuggerConfig } = await loadDebuggerModule();
     const config = DebuggerConfig.merge();
+    const resolvedOptions = withConfiguredDebuggerConnection(options, config.connection);
     const hours = typeof options['hours'] === 'string' && options['hours'] !== ''
         ? Number.parseInt(options['hours'], 10)
         : config.pruneAfterHours;
     const olderThanMs = hours * 60 * 60 * 1000;
     const keepExceptions = options['keepExceptions'] === true;
-    const conn = resolveDebuggerConnectionConfig({
-        ...options,
-        connection: config.connection ?? 'default',
-    });
+    const conn = resolveDebuggerConnectionConfig(resolvedOptions);
     const threshold = Date.now() - olderThanMs;
     const pruneSql = keepExceptions
         ? `DELETE FROM zin_debugger_entries WHERE created_at < ${String(threshold)} AND type != 'exception'`
         : `DELETE FROM zin_debugger_entries WHERE created_at < ${String(threshold)}`;
     Logger.info(`Pruning debugger entries older than ${hours}h...`);
     const deleted = isD1ConnectionDriver(conn.driver)
-        ? await executeD1Delete(options, pruneSql)
-        : await withSqlDebuggerStorage({ ...options, connection: config.connection ?? 'default' }, async (storage) => storage.prune(olderThanMs, keepExceptions));
+        ? executeD1Delete(options, pruneSql)
+        : await withSqlDebuggerStorage(resolvedOptions, async (storage) => storage.prune(olderThanMs, keepExceptions));
     Logger.info(`Done - removed ${deleted} entries.`);
 };
 const executeClear = async (options) => {
     const { DebuggerConfig } = await loadDebuggerModule();
     const config = DebuggerConfig.merge();
-    const conn = resolveDebuggerConnectionConfig({
-        ...options,
-        connection: config.connection ?? 'default',
-    });
+    const resolvedOptions = withConfiguredDebuggerConnection(options, config.connection);
+    const conn = resolveDebuggerConnectionConfig(resolvedOptions);
     Logger.info('Clearing all debugger entries...');
     if (isD1ConnectionDriver(conn.driver)) {
-        await executeD1Delete(options, 'DELETE FROM zin_debugger_entries');
+        executeD1Delete(options, 'DELETE FROM zin_debugger_entries');
     }
     else {
-        await withSqlDebuggerStorage({ ...options, connection: config.connection ?? 'default' }, async (storage) => storage.clear());
+        await withSqlDebuggerStorage(resolvedOptions, async (storage) => storage.clear());
     }
     Logger.info('Done - all entries cleared.');
 };
 const executeStatus = async (options, cmd) => {
     const { DebuggerConfig } = await loadDebuggerModule();
     const config = DebuggerConfig.merge();
-    const connection = config.connection ?? 'default';
-    const conn = resolveDebuggerConnectionConfig({ ...options, connection });
+    const resolvedOptions = withConfiguredDebuggerConnection(options, config.connection);
+    const connection = resolveDebuggerConnectionName(resolvedOptions);
+    const conn = resolveDebuggerConnectionConfig(resolvedOptions);
     const stats = isD1ConnectionDriver(conn.driver)
-        ? await executeD1Stats(options)
-        : await withSqlDebuggerStorage({ ...options, connection }, async (storage) => storage.stats());
+        ? executeD1Stats(options)
+        : await withSqlDebuggerStorage(resolvedOptions, async (storage) => storage.stats());
     cmd.info(`Debugger enabled via env: ${readEnvString('DEBUGGER_ENABLED').trim() || 'false'}`);
     cmd.info(`Connection: ${connection}`);
     cmd.info(`Prune after hours: ${String(config.pruneAfterHours)}`);
-    cmd.info(`Dashboard: ${resolveDashboardUrl()}`);
+    cmd.info(`Expected dashboard URL (if mounted): ${resolveDashboardUrl()}`);
     const keys = Object.keys(stats).sort((left, right) => left.localeCompare(right));
     if (keys.length === 0) {
         cmd.info('Stored entries: 0');
@@ -322,14 +402,15 @@ const runMigrationsForConnection = async (conn, options, cmd, interactive) => {
             options['rollback'] === true) {
             throw ErrorFactory.createCliError('D1-backed debugger migrations currently support apply only. Run `zin migrate:debugger --local|--remote` without status or rollback flags.');
         }
+        const migrationTarget = resolveDebuggerMigrationTarget();
         const projectRoot = process.cwd();
         const dbName = getD1DatabaseName(options);
         const isLocal = options['local'] === true || options['remote'] !== true;
         const outputDir = path.join(projectRoot, WranglerConfig.getD1MigrationsDir(projectRoot, dbName));
         await D1SqlMigrations.compileAndWrite({
             projectRoot,
-            globalDir: resolveDebuggerMigrationDir(),
-            extension: databaseConfig.migrations.extension,
+            globalDir: migrationTarget.dir,
+            extension: migrationTarget.extension,
             includeGlobal: true,
             outputDir,
         });
@@ -344,11 +425,12 @@ const runMigrationsForConnection = async (conn, options, cmd, interactive) => {
     const db = Database.create(ormConfig);
     await db.connect();
     try {
+        const migrationTarget = resolveDebuggerMigrationTarget();
         const migrator = Migrator.create({
             db,
             projectRoot: process.cwd(),
-            globalDir: resolveDebuggerMigrationDir(),
-            extension: databaseConfig.migrations.extension,
+            globalDir: migrationTarget.dir,
+            extension: migrationTarget.extension,
             separateTracking: true,
         });
         await runMigrationActions(migrator, options, cmd, conn.driver);

package/src/cli/commands/MigrateCommand.js

@@ -215,7 +215,7 @@ const warnIfAdapterMissing = (cmd, conn) => {
     if (conn.driver === 'mysql' && DatabaseAdapterRegistry.get('mysql') === undefined) {
         cmd.warn('MySQL adapter is not installed/registered; migrations may not hit a real MySQL DB.');
         cmd.warn('Install via `zin plugin install adapter:mysql` (or `zin add db:mysql`).');
-        cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "../../../packages/db-mysql/src/register";');
+        cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "@zintrust/db-mysql/register";');
     }
     if (conn.driver === 'postgresql' && DatabaseAdapterRegistry.get('postgresql') === undefined) {
         cmd.warn('PostgreSQL adapter is not installed/registered; migrations may not hit a real PostgreSQL DB.');

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

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/config/database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAItB,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC,CAAC,CAAC;AAuQH,QAAA,MAAM,oBAAoB,QAAO;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,mBAAmB,CAAC;IACjC,aAAa,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,wBAAwB,CAAC;IACvE,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAyEhC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAqBrE,eAAO,MAAM,cAAc,EAAE,cAY3B,CAAC"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/config/database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAItB,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,mBAAmB,CAAC;IACjC,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC,CAAC,CAAC;AA+QH,QAAA,MAAM,oBAAoB,QAAO;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,mBAAmB,CAAC;IACjC,aAAa,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,wBAAwB,CAAC;IACvE,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,UAAU,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAyEhC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAqBrE,eAAO,MAAM,cAAc,EAAE,cAY3B,CAAC"}

package/src/config/database.js

@@ -152,15 +152,21 @@ const normalizeReadHosts = (primaryHost, hosts) => {
     const filtered = hosts.filter((host) => host !== '' && host !== primary);
     return filtered.length > 0 ? filtered : undefined;
 };
+const resolveImplicitDefaultConnection = (connections) => {
+    return hasOwn(connections, 'sqlite') ? 'sqlite' : (Object.keys(connections)[0] ?? 'sqlite');
+};
 const getDefaultConnection = (connections) => {
     const envSelectedRaw = Env.get('DB_CONNECTION', '');
     const value = String(envSelectedRaw ?? '').trim();
     if (value.length > 0 && hasOwn(connections, value))
         return value;
+    if (value === 'default') {
+        return resolveImplicitDefaultConnection(connections);
+    }
     if (envSelectedRaw.trim().length > 0) {
         throw ErrorFactory.createConfigError(`Database connection not configured: ${value}`);
     }
-    return hasOwn(connections, 'sqlite') ? 'sqlite' : (Object.keys(connections)[0] ?? 'sqlite');
+    return resolveImplicitDefaultConnection(connections);
 };
 const getDatabaseConnection = (config) => {
     const connName = config.default;

package/src/functions/cloudflare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../../src/functions/cloudflare.ts"],"names":[],"mappings":";mBAqPuB,OAAO,QAAQ,OAAO,QAAQ,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;AADhF,wBAwCE"}
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../../../src/functions/cloudflare.ts"],"names":[],"mappings":";mBAgOuB,OAAO,QAAQ,OAAO,QAAQ,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;;AADhF,wBAmCE"}

package/src/functions/cloudflare.js

@@ -1,8 +1,5 @@
-import { appConfig } from '../config/index.js';
-import { Application } from '../boot/Application.js';
 import { Logger } from '../config/logger.js';
 import { clearMiddlewareConfigCache } from '../config/middleware.js';
-import { Kernel } from '../http/Kernel.js';
 import { CloudflareAdapter } from '../runtime/adapters/CloudflareAdapter.js';
 import mergeOverrideValues from '../runtime/OverrideValueMerge.js';
 import { ProjectRuntime } from '../runtime/ProjectRuntime.js';
@@ -174,17 +171,6 @@ const ensureStartupConfigOverridesLoaded = async () => {
     startupConfigOverridesPromise ??= applyStartupConfigOverrides();
     await startupConfigOverridesPromise;
 };
-const resolveRequestKernel = async () => {
-    if (!appConfig.isDevelopment()) {
-        return { kernel: await getKernel() };
-    }
-    const app = Application.create();
-    await app.boot();
-    return {
-        kernel: Kernel.create(app.getRouter(), app.getContainer()),
-        shutdown: app.shutdown,
-    };
-};
 export default {
     async fetch(request, _env, _ctx) {
         try {
@@ -199,19 +185,14 @@ export default {
             await ensureStartupConfigOverridesLoaded();
             await WorkerAdapterImports.ready; // NOSONAR - Ensure adapter imports are ready before handling requests.
             await injectIoredisModule();
-            const runtimeKernel = await resolveRequestKernel();
-            try {
-                const adapter = CloudflareAdapter.create({
-                    handler: async (req, res) => {
-                        await runtimeKernel.kernel.handle(req, res);
-                    },
-                });
-                const platformResponse = await adapter.handle(request);
-                return adapter.formatResponse(platformResponse);
-            }
-            finally {
-                await runtimeKernel.shutdown?.();
-            }
+            const kernel = await getKernel();
+            const adapter = CloudflareAdapter.create({
+                handler: async (req, res) => {
+                    await kernel.handle(req, res);
+                },
+            });
+            const platformResponse = await adapter.handle(request);
+            return adapter.formatResponse(platformResponse);
         }
         catch (error) {
             const err = error;

package/src/index.d.ts

@@ -46,6 +46,7 @@ export { SQLiteAdapter } from './orm/adapters/SQLiteAdapter';
 export { SQLServerAdapter } from './orm/adapters/SQLServerAdapter';
 export { Database, resetDatabase, useDatabase, useEnsureDbConnected } from './orm/Database';
 export type { IDatabase } from './orm/Database';
+export { DatabaseConnectionRegistry } from './orm/DatabaseConnectionRegistry';
 export { Model } from './orm/Model';
 export type { IModel, ModelConfig, ModelStatic } from './orm/Model';
 export { QueryBuilder } from './orm/QueryBuilder';
@@ -98,9 +99,9 @@ export { Xss } from './security/Xss';
 export { XssProtection } from './security/XssProtection';
 export { ErrorFactory } from './exceptions/ZintrustError';
 export { detectCloudflareWorkers, detectRuntimePlatform, RUNTIME_PLATFORM, RuntimeServices, type RuntimeCrypto, type RuntimeEnvReader, type RuntimeFs, type RuntimePlatform, type RuntimeServices as RuntimeServicesType, type RuntimeTimers, } from './runtime/RuntimeServices';
+export { SystemDebuggerBridge } from './debugger/SystemDebuggerBridge';
 export { EventDispatcher } from './events/EventDispatcher';
 export type { EventListener, EventMap, IEventDispatcher } from './events/EventDispatcher';
-export { SystemDebuggerBridge } from './debugger/SystemDebuggerBridge';
 export { SessionManager } from './session/SessionManager';
 export type { ISession, ISessionManager, SessionData, SessionManagerOptions, } from './session/SessionManager';
 export { defaultMiddlewareFailureResponder, respondWithMiddlewareFailure, } from './middleware/MiddlewareFailureResponder';