@zintrust/core 0.4.40 → 0.4.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.40",
+  "version": "0.4.42",
   "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.40",
+    "@zintrust/workers": "^0.4.42",
     "bcryptjs": "^3.0.3",
     "bullmq": "^5.71.1",
     "chalk": "^5.6.2",
@@ -71,6 +71,7 @@
   "overrides": {
     "ajv": "^8.18.0",
     "axios": "^1.13.5",
+    "@tootallnate/once": "^3.0.1",
     "node-forge": "^1.4.0",
     "brace-expansion": "^5.0.5",
     "picomatch": "^4.0.4",

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":"AAeA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAsJ9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA4BlF,CAAC;AA2LF,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;CA6E7D,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;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"}

package/src/boot/registry/runtime.js

@@ -2,6 +2,7 @@ import * as RuntimeConfig from '../../config/index.js';
 import { StartupHealthChecks } from '../../health/StartupHealthChecks.js';
 import { loadQueueMonitorModule, loadWorkersModule } from '../../runtime/WorkersModule.js';
 import { registerCachesFromRuntimeConfig } from '../../cache/CacheRuntimeRegistration.js';
+import { readEnvString } from '../../common/ExternalServiceUtils.js';
 import broadcastConfig from '../../config/broadcast.js';
 import { Cloudflare } from '../../config/cloudflare.js';
 import { FeatureFlags } from '../../config/features.js';
@@ -11,6 +12,7 @@ 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';
@@ -19,6 +21,44 @@ import { registerBroadcastersFromRuntimeConfig } from '../../tools/broadcast/Bro
 import { registerNotificationChannelsFromRuntimeConfig } from '../../tools/notification/NotificationRuntimeRegistration.js';
 import { registerQueuesFromRuntimeConfig } from '../../tools/queue/QueueRuntimeRegistration.js';
 import { registerDisksFromRuntimeConfig } from '../../tools/storage/StorageRuntimeRegistration.js';
+const importFromExistingCandidates = async (moduleCandidates) => {
+    for (const modulePath of moduleCandidates) {
+        if (!existsSync(modulePath))
+            continue;
+        try {
+            const url = pathToFileURL(modulePath).href;
+            // eslint-disable-next-line no-await-in-loop
+            return (await import(url));
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return undefined;
+};
+const loadLocalSystemDebuggerModule = async () => {
+    const globalDebuggerPluginState = globalThis;
+    if (globalDebuggerPluginState.__zintrust_system_debugger_runtime__ !== undefined) {
+        return globalDebuggerPluginState.__zintrust_system_debugger_runtime__;
+    }
+    const projectRoot = typeof process !== 'undefined' && typeof process.cwd === 'function' ? process.cwd() : '';
+    if (projectRoot !== '') {
+        const moduleCandidates = [
+            path.join(projectRoot, 'src', 'runtime', 'plugins', 'system-debugger-runtime.ts'),
+            path.join(projectRoot, 'src', 'runtime', 'plugins', 'system-debugger-runtime.js'),
+            path.join(projectRoot, 'dist', 'runtime', 'plugins', 'system-debugger-runtime.js'),
+            path.join(projectRoot, 'dist', 'src', 'runtime', 'plugins', 'system-debugger-runtime.js'),
+        ];
+        const localModule = await importFromExistingCandidates(moduleCandidates);
+        if (localModule !== undefined) {
+            if (typeof localModule.isAvailable === 'function' && localModule.isAvailable() === false) {
+                return undefined;
+            }
+            return localModule;
+        }
+    }
+    return tryImportOptional('@runtime/plugins/system-debugger-runtime');
+};
 const loadRuntimeQueueConfig = async () => {
     try {
         const modulePath = '@runtime-config/queue';
@@ -308,6 +348,85 @@ const initializeScheduleHttpGateway = async (router) => {
         Logger.warn('Failed to register Schedule HTTP gateway routes', error);
     }
 };
+const isDebuggerEnabled = () => {
+    const raw = readEnvString('DEBUGGER_ENABLED').trim().toLowerCase();
+    return raw === '1' || raw === 'true';
+};
+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) => {
+    if (!isSystemDebuggerPluginRequested()) {
+        Logger.debug('System Debugger plugin is not enabled in zintrust.plugins.*. Skipping mount.');
+        return;
+    }
+    if (!isDebuggerEnabled())
+        return;
+    const debuggerModule = (await tryImportOptional('@zintrust/system-debugger')) ??
+        (await loadLocalSystemDebuggerModule());
+    if (debuggerModule === undefined) {
+        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}`);
+    }
+    catch (error) {
+        Logger.warn('Failed to register System Debugger routes', error);
+    }
+};
 export const createLifecycle = (params) => {
     const boot = async () => {
         if (params.getBooted())
@@ -335,6 +454,7 @@ export const createLifecycle = (params) => {
         await registerFromRuntimeConfig();
         await initializeArtifactDirectories(params.resolvedBasePath);
         await registerMasterRoutes(params.resolvedBasePath, params.router);
+        await initializeSystemDebugger(params.router);
         if (Cloudflare.getWorkersEnv() === null &&
             appConfig.dockerWorker === false &&
             appConfig.worker === true) {

package/src/cache/Cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/Cache.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmJtD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,WAAW,CAAC;CAC9B,CAAC,CAAC;AA8CH,eAAO,MAAM,KAAK;UAlGC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UASlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAQjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAQtB,OAAO,CAAC,IAAI,CAAC;eAOb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAS3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuCvB,IAAI;EAcpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;UAhHC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UASlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAQjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAQtB,OAAO,CAAC,IAAI,CAAC;eAOb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAS3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuCvB,IAAI;EAmBI,CAAC"}
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/Cache.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA8JtD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,WAAW,CAAC;CAC9B,CAAC,CAAC;AA8DH,eAAO,MAAM,KAAK;UA5HC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAWlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAUjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAUtB,OAAO,CAAC,IAAI,CAAC;eASb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAW3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuDvB,IAAI;EAcpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;UA1IC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAWlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAUjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAUtB,OAAO,CAAC,IAAI,CAAC;eASb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAW3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuDvB,IAAI;EAmBI,CAAC"}

package/src/cache/Cache.js

@@ -11,6 +11,7 @@ import { MemoryDriver } from './drivers/MemoryDriver.js';
 import { MongoDriver } from './drivers/MongoDriver.js';
 import { RedisDriver } from './drivers/RedisDriver.js';
 import { cacheConfig } from '../config/cache.js';
+import { SystemDebuggerBridge } from '../debugger/SystemDebuggerBridge.js';
 import { Env } from '../config/env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 const instances = new Map();
@@ -85,7 +86,9 @@ function getDriverInstance(storeName) {
  */
 const get = async (key) => {
     const prefixedKey = autoPrefixKey(key);
+    const startedAt = Date.now();
     const value = await getDriverInstance().get(prefixedKey);
+    SystemDebuggerBridge.emitCache('get', prefixedKey, Date.now() - startedAt, value !== null);
     return value;
 };
 /**
@@ -93,27 +96,35 @@ const get = async (key) => {
  */
 const set = async (key, value, ttl) => {
     const prefixedKey = autoPrefixKey(key);
+    const startedAt = Date.now();
     await getDriverInstance().set(prefixedKey, value, ttl);
+    SystemDebuggerBridge.emitCache('set', prefixedKey, Date.now() - startedAt);
 };
 /**
  * Remove an item from the cache
  */
 const del = async (key) => {
     const prefixedKey = autoPrefixKey(key);
+    const startedAt = Date.now();
     await getDriverInstance().delete(prefixedKey);
+    SystemDebuggerBridge.emitCache('delete', prefixedKey, Date.now() - startedAt);
 };
 /**
  * Clear all items from the cache
  */
 const clear = async () => {
+    const startedAt = Date.now();
     await getDriverInstance().clear();
+    SystemDebuggerBridge.emitCache('clear', 'zt:*', Date.now() - startedAt);
 };
 /**
  * Check if an item exists in the cache
  */
 const has = async (key) => {
     const prefixedKey = autoPrefixKey(key);
+    const startedAt = Date.now();
     const exists = await getDriverInstance().has(prefixedKey);
+    SystemDebuggerBridge.emitCache('has', prefixedKey, Date.now() - startedAt, exists);
     return exists;
 };
 /**
@@ -125,22 +136,34 @@ const getDriver = () => {
 const store = (name) => {
     const getFromStore = async (key) => {
         const prefixedKey = autoPrefixKey(key);
-        return getDriverInstance(name).get(prefixedKey);
+        const startedAt = Date.now();
+        const value = await getDriverInstance(name).get(prefixedKey);
+        SystemDebuggerBridge.emitCache('get', prefixedKey, Date.now() - startedAt, value !== null);
+        return value;
     };
     const setInStore = async (key, value, ttl) => {
         const prefixedKey = autoPrefixKey(key);
+        const startedAt = Date.now();
         await getDriverInstance(name).set(prefixedKey, value, ttl);
+        SystemDebuggerBridge.emitCache('set', prefixedKey, Date.now() - startedAt);
     };
     const delFromStore = async (key) => {
         const prefixedKey = autoPrefixKey(key);
+        const startedAt = Date.now();
         await getDriverInstance(name).delete(prefixedKey);
+        SystemDebuggerBridge.emitCache('delete', prefixedKey, Date.now() - startedAt);
     };
     const clearStore = async () => {
+        const startedAt = Date.now();
         await getDriverInstance(name).clear();
+        SystemDebuggerBridge.emitCache('clear', `store:${String(name ?? 'default')}`, Date.now() - startedAt);
     };
     const hasInStore = async (key) => {
         const prefixedKey = autoPrefixKey(key);
-        return getDriverInstance(name).has(prefixedKey);
+        const startedAt = Date.now();
+        const exists = await getDriverInstance(name).has(prefixedKey);
+        SystemDebuggerBridge.emitCache('has', prefixedKey, Date.now() - startedAt, exists);
+        return exists;
     };
     const getStoreDriver = () => {
         return getDriverInstance(name);

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

@@ -1 +1 @@
-{"version":3,"file":"BaseCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,IAAI,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;WACI,CAAC,SAAS,YAAY,yBAAyB;QACpD,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,mEAAmE;QACnE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;QACxC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5D,GAAG,CAAC;EA6DL,CAAC"}
+{"version":3,"file":"BaseCommand.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,IAAI,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAQD;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;WACI,CAAC,SAAS,YAAY,yBAAyB;QACpD,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,mEAAmE;QACnE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC5B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;QACxC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5D,GAAG,CAAC;EA6EL,CAAC"}

package/src/cli/BaseCommand.js

@@ -2,9 +2,13 @@
  * Base Command - Abstract Command Class
  * All CLI commands extend this class
  */
+import { SystemDebuggerBridge } from '../debugger/SystemDebuggerBridge.js';
 import { ErrorHandler } from './ErrorHandler.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { Command } from 'commander';
+const toCommandArguments = (options) => {
+    return Object.fromEntries(Object.entries(options).filter(([, value]) => typeof value !== 'function'));
+};
 /**
  * Command Factory Helper
  * Sealed namespace for immutability
@@ -37,10 +41,14 @@ export const BaseCommand = Object.freeze({
                 const options = args.at(-2);
                 const commandArgs = args.slice(0, -2);
                 options.args = commandArgs;
+                const startedAt = Date.now();
                 try {
                     await config.execute(options);
+                    SystemDebuggerBridge.emitCommand(config.name, toCommandArguments(options), 0, Date.now() - startedAt);
                 }
                 catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    SystemDebuggerBridge.emitCommand(config.name, toCommandArguments(options), 1, Date.now() - startedAt, message);
                     if (error instanceof Error) {
                         ErrorFactory.createTryCatchError('Command execution failed', error);
                         ErrorHandler.handle(error, undefined, false);

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

@@ -1 +1 @@
-{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AAwPD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}
+{"version":3,"file":"CLI.d.ts","sourceRoot":"","sources":["../../../src/cli/CLI.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,MAAM,WAAW,IAAI;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,IAAI,OAAO,CAAC;CACvB;AAyPD;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;cACJ,IAAI;EAed,CAAC"}

package/src/cli/CLI.js

@@ -60,6 +60,7 @@ import { SqlServerProxyCommand } from './commands/SqlServerProxyCommand.js';
 import { StartCommand } from './commands/StartCommand.js';
 import { TemplatesCommand } from './commands/TemplatesCommand.js';
 import { UpgradeCommand } from './commands/UpgradeCommand.js';
+import { WranglerDevVarsCommand } from './commands/WranglerDevVarsCommand.js';
 import { ErrorHandler } from './ErrorHandler.js';
 import { OptionalCliCommandRegistry } from './OptionalCliCommandRegistry.js';
 import { VersionChecker } from './services/VersionChecker.js';
@@ -81,6 +82,7 @@ const buildCommandRegistry = () => {
         NewCommand.create(),
         UpgradeCommand.create(),
         PrepareCommand,
+        WranglerDevVarsCommand.create(),
         InitContainerCommand.create(),
         InitContainersProxyCommand.create(),
         InitProxyCommand.create(),

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

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

package/src/cli/OptionalCliExtensions.js

@@ -63,6 +63,18 @@ const OPTIONAL_CLI_EXTENSIONS = Object.freeze([
             path.join(packageRoot, 'dist', 'packages', 'workers', 'src', 'register.js'),
         ],
     },
+    {
+        packageName: '@zintrust/system-debugger',
+        specifier: '@zintrust/system-debugger/cli-register',
+        commands: ['debugger:prune', 'debugger:clear', 'debugger:status', 'migrate:debugger'],
+        installCommand: 'npm install @zintrust/system-debugger',
+        localCandidates: [
+            path.join(packageRoot, 'packages', 'system-debugger', 'src', 'cli-register.ts'),
+            path.join(packageRoot, 'packages', 'system-debugger', 'src', 'cli-register.js'),
+            path.join(packageRoot, 'packages', 'system-debugger', 'dist', 'cli-register.js'),
+            path.join(packageRoot, 'dist', 'packages', 'system-debugger', 'src', 'cli-register.js'),
+        ],
+    },
 ]);
 const getProjectLocalCandidates = (entry) => {
     const projectRoot = resolveProjectRoot();

package/src/cli/cloudflare/CloudflareSecretSync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CloudflareSecretSync.d.ts","sourceRoot":"","sources":["../../../../src/cli/cloudflare/CloudflareSecretSync.ts"],"names":[],"mappings":"AAYA,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAaF,KAAK,wBAAwB,GAAG;IAC9B,GAAG,EAAE,mBAAmB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,2BAA2B,EAAE,CAAC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAiJF,eAAO,MAAM,0BAA0B,GACrC,KAAK,mBAAmB,EACxB,QAAQ,IAAI,CAAC,0BAA0B,EAAE,QAAQ,GAAG,UAAU,CAAC,KAC9D,IAYF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAU,kGAUzC,wBAAwB,KAAG,OAAO,CAAC,0BAA0B,CAwC/D,CAAC;;8HAxCC,wBAAwB,KAAG,OAAO,CAAC,0BAA0B,CAAC;sCA1B1D,mBAAmB,UAChB,IAAI,CAAC,0BAA0B,EAAE,QAAQ,GAAG,UAAU,CAAC,KAC9D,IAAI;;AAkEP,wBAGG"}
+{"version":3,"file":"CloudflareSecretSync.d.ts","sourceRoot":"","sources":["../../../../src/cli/cloudflare/CloudflareSecretSync.ts"],"names":[],"mappings":"AAYA,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAaF,KAAK,wBAAwB,GAAG;IAC9B,GAAG,EAAE,mBAAmB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,2BAA2B,EAAE,CAAC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAiJF,eAAO,MAAM,0BAA0B,GACrC,KAAK,mBAAmB,EACxB,QAAQ,IAAI,CAAC,0BAA0B,EAAE,QAAQ,GAAG,UAAU,CAAC,KAC9D,IAcF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAU,kGAUzC,wBAAwB,KAAG,OAAO,CAAC,0BAA0B,CAqC/D,CAAC;;8HArCC,wBAAwB,KAAG,OAAO,CAAC,0BAA0B,CAAC;sCA5B1D,mBAAmB,UAChB,IAAI,CAAC,0BAA0B,EAAE,QAAQ,GAAG,UAAU,CAAC,KAC9D,IAAI;;AAiEP,wBAGG"}

package/src/cli/cloudflare/CloudflareSecretSync.js

@@ -117,8 +117,7 @@ export const reportCloudflareSecretSync = (log, result) => {
 };
 export const syncCloudflareSecrets = async ({ log, cwd, wranglerEnvs, envPath, dryRun = false, configGroups = [], configPath, target, requireSelection = true, }) => {
     const normalizedConfigPath = typeof configPath === 'string' && configPath.trim() !== '' ? configPath.trim() : undefined;
-    if (normalizedConfigPath !== undefined &&
-        !existsSync(path.join(cwd, normalizedConfigPath))) {
+    if (normalizedConfigPath !== undefined && !existsSync(path.join(cwd, normalizedConfigPath))) {
         throw ErrorFactory.createCliError(`Wrangler config not found: ${normalizedConfigPath}`);
     }
     const config = readZintrustConfig(cwd);

package/src/cli/cloudflare/CloudflareWranglerDevEnv.d.ts

@@ -0,0 +1,24 @@
+type WranglerDevEnvArgs = {
+    cwd: string;
+    projectRoot: string;
+    envName?: string;
+    envPath?: string;
+    configPath?: string;
+    target?: string;
+    runtimeEnv?: NodeJS.ProcessEnv;
+    requireSelection?: boolean;
+};
+export type WranglerDevEnvMaterializationResult = {
+    filePath: string;
+    selectedKeys: string[];
+    missingKeys: string[];
+    values: Record<string, string>;
+};
+export declare const materializeWranglerDevVars: (args: WranglerDevEnvArgs) => Promise<WranglerDevEnvMaterializationResult>;
+export declare const withWranglerDevVarsSnapshot: <T>(args: WranglerDevEnvArgs, fn: () => Promise<T>) => Promise<T>;
+declare const _default: Readonly<{
+    materializeWranglerDevVars: (args: WranglerDevEnvArgs) => Promise<WranglerDevEnvMaterializationResult>;
+    withWranglerDevVarsSnapshot: <T>(args: WranglerDevEnvArgs, fn: () => Promise<T>) => Promise<T>;
+}>;
+export default _default;
+//# sourceMappingURL=CloudflareWranglerDevEnv.d.ts.map

package/src/cli/cloudflare/CloudflareWranglerDevEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CloudflareWranglerDevEnv.d.ts","sourceRoot":"","sources":["../../../../src/cli/cloudflare/CloudflareWranglerDevEnv.ts"],"names":[],"mappings":"AAUA,KAAK,kBAAkB,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAyJF,eAAO,MAAM,0BAA0B,GACrC,MAAM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAmB7C,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAU,CAAC,EACjD,MAAM,kBAAkB,EACxB,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CA8BX,CAAC;;uCAvDM,kBAAkB,KACvB,OAAO,CAAC,mCAAmC,CAAC;kCAqBG,CAAC,QAC3C,kBAAkB,MACpB,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CAAC;;AAgCb,wBAGG"}

package/src/cli/cloudflare/CloudflareWranglerDevEnv.js

@@ -0,0 +1,174 @@
+import { readZintrustConfig, resolveCloudflareEnvKeys, } from '../cloudflare/CloudflareEnvTargetConfig.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { isNonEmptyString } from '../../helper/index.js';
+import { existsSync, renameSync, unlinkSync } from '../../node-singletons/fs.js';
+import * as path from '../../node-singletons/path.js';
+import { EnvFile } from '../../toolkit/Secrets/EnvFile.js';
+const WRANGLER_RUNTIME_ENV_KEYS = Object.freeze([
+    'APP_PORT',
+    'CLOUDFLARE_WORKER',
+    'DOCKER_WORKER',
+    'ENVIRONMENT',
+    'HOST',
+    'NODE_ENV',
+    'PORT',
+    'RUNTIME',
+    'SERVICE_DOMAIN',
+    'SERVICE_NAME',
+    'SERVICE_PORT',
+    'WORKER_ENABLED',
+    'ZINTRUST_PROJECT_ROOT',
+]);
+const isAsciiUppercaseLetter = (value) => value >= 'A' && value <= 'Z';
+const isAsciiDigit = (value) => value >= '0' && value <= '9';
+const isWranglerWordCharacter = (value) => isAsciiUppercaseLetter(value) || isAsciiDigit(value) || value === '_';
+const isWranglerVarName = (value) => {
+    if (value.length === 0)
+        return false;
+    const first = value[0] ?? '';
+    if (!(isAsciiUppercaseLetter(first) || first === '_'))
+        return false;
+    for (let index = 1; index < value.length; index += 1) {
+        if (!isWranglerWordCharacter(value[index] ?? ''))
+            return false;
+    }
+    return true;
+};
+const uniq = (items) => {
+    const seen = new Set();
+    const output = [];
+    for (const item of items) {
+        const normalized = item.trim();
+        if (normalized === '' || seen.has(normalized))
+            continue;
+        seen.add(normalized);
+        output.push(normalized);
+    }
+    return output;
+};
+const getNormalizedEnvName = (envName) => {
+    return typeof envName === 'string' ? envName.trim() : '';
+};
+const getWranglerDevVarsFileName = (envName) => {
+    const normalizedEnv = getNormalizedEnvName(envName);
+    return normalizedEnv === '' ? '.dev.vars' : `.dev.vars.${normalizedEnv}`;
+};
+const getWranglerDevVarsBackupPath = (targetPath) => `${targetPath}.disabled-by-zin`;
+const reconcileWranglerEnvBackup = (targetPath, backupPath) => {
+    const hasTarget = existsSync(targetPath);
+    const hasBackup = existsSync(backupPath);
+    if (!hasBackup)
+        return;
+    if (!hasTarget) {
+        renameSync(backupPath, targetPath);
+        return;
+    }
+    unlinkSync(backupPath);
+};
+const resolveRuntimeEnvMap = (runtimeEnv) => {
+    return Object.fromEntries(Object.entries(runtimeEnv).filter((entry) => {
+        return typeof entry[1] === 'string';
+    }));
+};
+const resolveSelectedKeys = (args) => {
+    const zintrustConfigPath = path.join(args.projectRoot, '.zintrust.json');
+    if (!existsSync(zintrustConfigPath)) {
+        if (args.requireSelection === true) {
+            throw ErrorFactory.createCliError('No .zintrust.json found. Add a Cloudflare env manifest before generating Wrangler dev vars.');
+        }
+        return [];
+    }
+    const selectedKeys = resolveCloudflareEnvKeys({
+        config: readZintrustConfig(args.projectRoot),
+        projectRoot: args.projectRoot,
+        cwd: args.cwd,
+        ...(isNonEmptyString(args.configPath) ? { configPath: args.configPath.trim() } : {}),
+        ...(isNonEmptyString(args.envName) ? { wranglerEnv: args.envName.trim() } : {}),
+        ...(isNonEmptyString(args.target) ? { target: args.target.trim() } : {}),
+    });
+    if (selectedKeys.length === 0 && args.requireSelection === true) {
+        throw ErrorFactory.createCliError('No Wrangler dev env keys resolved from .zintrust.json cloudflare.shared_env/cloudflare.targets/cloudflare.wrangler_envs.');
+    }
+    return selectedKeys;
+};
+const collectWranglerDevVarValues = async (args, selectedKeys) => {
+    const runtimeEnv = resolveRuntimeEnvMap(args.runtimeEnv ?? process.env);
+    const envPath = isNonEmptyString(args.envPath) ? args.envPath.trim() : '.env';
+    const envFileValues = await EnvFile.read({
+        cwd: args.projectRoot,
+        path: envPath,
+    });
+    const allowedKeys = selectedKeys.length === 0
+        ? undefined
+        : new Set([...WRANGLER_RUNTIME_ENV_KEYS, ...selectedKeys]);
+    const candidateKeys = allowedKeys === undefined
+        ? uniq([...Object.keys(runtimeEnv), ...Object.keys(envFileValues)]).filter(isWranglerVarName)
+        : [...allowedKeys].filter(isWranglerVarName);
+    const values = {};
+    const missingKeys = [];
+    for (const key of candidateKeys) {
+        const value = envFileValues[key] ?? runtimeEnv[key];
+        if (typeof value !== 'string') {
+            if (selectedKeys.includes(key))
+                missingKeys.push(key);
+            continue;
+        }
+        values[key] = value;
+    }
+    return { values, missingKeys };
+};
+export const materializeWranglerDevVars = async (args) => {
+    const selectedKeys = resolveSelectedKeys(args);
+    const { values, missingKeys } = await collectWranglerDevVarValues(args, selectedKeys);
+    const fileName = getWranglerDevVarsFileName(args.envName);
+    const filePath = path.join(args.cwd, fileName);
+    await EnvFile.write({
+        cwd: args.cwd,
+        path: fileName,
+        values,
+        mode: 'overwrite',
+    });
+    return {
+        filePath,
+        selectedKeys,
+        missingKeys,
+        values,
+    };
+};
+export const withWranglerDevVarsSnapshot = async (args, fn) => {
+    const targetPath = path.join(args.cwd, getWranglerDevVarsFileName(args.envName));
+    const backupPath = getWranglerDevVarsBackupPath(targetPath);
+    try {
+        reconcileWranglerEnvBackup(targetPath, backupPath);
+    }
+    catch {
+        // noop
+    }
+    if (existsSync(targetPath)) {
+        renameSync(targetPath, backupPath);
+    }
+    try {
+        await materializeWranglerDevVars(args);
+        return await fn();
+    }
+    finally {
+        try {
+            if (existsSync(targetPath))
+                unlinkSync(targetPath);
+        }
+        catch {
+            // noop
+        }
+        try {
+            if (existsSync(backupPath))
+                renameSync(backupPath, targetPath);
+        }
+        catch {
+            // noop
+        }
+    }
+};
+export default Object.freeze({
+    materializeWranglerDevVars,
+    withWranglerDevVarsSnapshot,
+});

package/src/cli/commands/DebuggerCommand.d.ts

@@ -0,0 +1,18 @@
+export { DebuggerCommands } from '../commands/DebuggerCommands';
+export declare const DebuggerPruneCommand: Readonly<{
+    name: string;
+    getCommand: () => import("commander").Command;
+}>;
+export declare const DebuggerClearCommand: Readonly<{
+    name: string;
+    getCommand: () => import("commander").Command;
+}>;
+export declare const DebuggerStatusCommand: Readonly<{
+    name: string;
+    getCommand: () => import("commander").Command;
+}>;
+export declare const DebuggerMigrateCommand: Readonly<{
+    name: string;
+    getCommand: () => import("commander").Command;
+}>;
+//# sourceMappingURL=DebuggerCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DebuggerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/DebuggerCommand.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;EAAiD,CAAC;AAEnF,eAAO,MAAM,oBAAoB;;;EAAiD,CAAC;AAEnF,eAAO,MAAM,qBAAqB;;;EAAkD,CAAC;AAErF,eAAO,MAAM,sBAAsB;;;EAAmD,CAAC"}

package/src/cli/commands/DebuggerCommand.js

@@ -0,0 +1,6 @@
+import { DebuggerCommands } from '../commands/DebuggerCommands.js';
+export { DebuggerCommands } from '../commands/DebuggerCommands.js';
+export const DebuggerPruneCommand = DebuggerCommands.createDebuggerPruneProvider();
+export const DebuggerClearCommand = DebuggerCommands.createDebuggerClearProvider();
+export const DebuggerStatusCommand = DebuggerCommands.createDebuggerStatusProvider();
+export const DebuggerMigrateCommand = DebuggerCommands.createDebuggerMigrateProvider();