@zintrust/core 0.4.40 → 0.4.42

package/src/cli/commands/StartCommand.js

@@ -1,5 +1,5 @@
 import { BaseCommand } from '../BaseCommand.js';
-import { readZintrustConfig, resolveCloudflareEnvKeys, } from '../cloudflare/CloudflareEnvTargetConfig.js';
+import { withWranglerDevVarsSnapshot } from '../cloudflare/CloudflareWranglerDevEnv.js';
 import { createDenoRunnerSource, createLambdaRunnerSource } from '../commands/runner/index.js';
 import { EnvFileLoader } from '../utils/EnvFileLoader.js';
 import { SpawnUtil } from '../utils/spawn.js';
@@ -7,7 +7,7 @@ import { readEnvString } from '../../common/ExternalServiceUtils.js';
 import * as Common from '../../common/index.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { isNonEmptyString } from '../../helper/index.js';
-import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from '../../node-singletons/fs.js';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
 import { ProjectRuntime } from '../../runtime/ProjectRuntime.js';
 const isAsciiUppercaseLetter = (value) => value >= 'A' && value <= 'Z';
@@ -337,82 +337,6 @@ const buildStartEnv = (projectRoot) => ({
     ...process.env,
     ZINTRUST_PROJECT_ROOT: projectRoot,
 });
-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 buildWorkerDevVarsContent = (selectedKeys) => {
-    const allowedKeys = selectedKeys === undefined || selectedKeys.length === 0
-        ? undefined
-        : new Set([...WRANGLER_RUNTIME_ENV_KEYS, ...selectedKeys]);
-    return (Object.entries(process.env)
-        .filter((entry) => {
-        const [key, value] = entry;
-        return (isWranglerVarName(key) &&
-            typeof value === 'string' &&
-            (allowedKeys === undefined || allowedKeys.has(key)));
-    })
-        .map(([key, value]) => `${key}=${JSON.stringify(value)}`)
-        .join('\n') + '\n');
-};
-const getWranglerEnvBackupPath = (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);
-};
-async function withWranglerEnvSnapshot(cwd, envName, selectedKeys, fn) {
-    const normalizedEnv = typeof envName === 'string' ? envName.trim() : '';
-    const targetName = normalizedEnv === '' ? '.dev.vars' : `.dev.vars.${normalizedEnv}`;
-    const targetPath = path.join(cwd, targetName);
-    const backupPath = getWranglerEnvBackupPath(targetPath);
-    try {
-        reconcileWranglerEnvBackup(targetPath, backupPath);
-    }
-    catch {
-        // noop
-    }
-    if (existsSync(targetPath)) {
-        renameSync(targetPath, backupPath);
-    }
-    try {
-        writeFileSync(targetPath, buildWorkerDevVarsContent(selectedKeys), 'utf-8');
-        return await fn();
-    }
-    finally {
-        try {
-            if (existsSync(targetPath))
-                unlinkSync(targetPath);
-        }
-        catch {
-            // noop
-        }
-        try {
-            if (existsSync(backupPath))
-                renameSync(backupPath, targetPath);
-        }
-        catch {
-            // noop
-        }
-    }
-}
 const resolveManifestServiceEnvDir = (projectRoot, entry) => {
     const configRoot = entry.configRoot;
     if (isNonEmptyString(configRoot)) {
@@ -564,19 +488,7 @@ const buildWranglerDevArgs = (args) => {
     }
     return wranglerArgs;
 };
-const resolveWranglerSelectedEnvKeys = (context, configPath, envName) => {
-    const zintrustConfigPath = path.join(context.projectRoot, '.zintrust.json');
-    if (!existsSync(zintrustConfigPath))
-        return undefined;
-    return resolveCloudflareEnvKeys({
-        config: readZintrustConfig(context.projectRoot),
-        projectRoot: context.projectRoot,
-        cwd: context.cwd,
-        ...(configPath === undefined ? {} : { configPath }),
-        ...(envName === undefined ? {} : { wranglerEnv: envName }),
-    });
-};
-const executeWranglerStart = async (cmd, context, port, runtime, envName, wranglerConfig) => {
+const executeWranglerStart = async (cmd, context, port, runtime, envName, wranglerConfig, envPath) => {
     if (runtime !== undefined) {
         throw ErrorFactory.createCliError('Error: --runtime is not supported with --wrangler (Wrangler controls Workers runtime).');
     }
@@ -591,8 +503,13 @@ const executeWranglerStart = async (cmd, context, port, runtime, envName, wrangl
     });
     logMySqlProxyHint(cmd);
     cmd.info('Starting in Wrangler dev mode...');
-    const selectedEnvKeys = resolveWranglerSelectedEnvKeys(context, configPath, envName);
-    const exitCode = await withWranglerEnvSnapshot(context.cwd, envName, selectedEnvKeys, async () => {
+    const exitCode = await withWranglerDevVarsSnapshot({
+        cwd: context.cwd,
+        projectRoot: context.projectRoot,
+        envName,
+        ...(envPath === undefined ? {} : { envPath }),
+        ...(configPath === undefined ? {} : { configPath }),
+    }, async () => {
         const startEnv = {
             ...buildStartEnv(context.projectRoot),
             WORKER_ENABLED: 'false',
@@ -805,7 +722,8 @@ const executeStart = async (options, cmd) => {
         const wranglerConfig = typeof options.wranglerConfig === 'string' && options.wranglerConfig.trim() !== ''
             ? options.wranglerConfig.trim()
             : undefined;
-        await executeWranglerStart(cmd, context, port, runtime, envName === '' ? undefined : envName, wranglerConfig);
+        const envPath = resolveEnvPath(options, context.projectRoot);
+        await executeWranglerStart(cmd, context, port, runtime, envName === '' ? undefined : envName, wranglerConfig, envPath);
         return;
     }
     if (envName !== '') {

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

@@ -0,0 +1,6 @@
+import { type IBaseCommand } from '../BaseCommand';
+export declare const WranglerDevVarsCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export default WranglerDevVarsCommand;
+//# sourceMappingURL=WranglerDevVarsCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WranglerDevVarsCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/WranglerDevVarsCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2DvF,eAAO,MAAM,sBAAsB;cACvB,YAAY;EAYtB,CAAC;AAEH,eAAe,sBAAsB,CAAC"}

package/src/cli/commands/WranglerDevVarsCommand.js

@@ -0,0 +1,52 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { materializeWranglerDevVars } from '../cloudflare/CloudflareWranglerDevEnv.js';
+const optionalTrimmed = (value) => {
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed === '' ? undefined : trimmed;
+};
+const addOptions = (command) => {
+    command
+        .option('--env <name>', 'Wrangler environment name used for .dev.vars.<env> output')
+        .option('--env-path <path>', 'Env file used as source values for generated Wrangler dev vars', '.env')
+        .option('--target <id>', 'Cloudflare worker target key from .zintrust.json cloudflare.targets')
+        .option('-c, --config <path>', 'Wrangler config file used for target inference (optional)');
+};
+const execute = async (cmd, options) => {
+    const result = await materializeWranglerDevVars({
+        cwd: process.cwd(),
+        projectRoot: process.cwd(),
+        ...(optionalTrimmed(options.env) === undefined
+            ? {}
+            : { envName: optionalTrimmed(options.env) }),
+        ...(optionalTrimmed(options.envPath) === undefined
+            ? {}
+            : { envPath: optionalTrimmed(options.envPath) }),
+        ...(optionalTrimmed(options.target) === undefined
+            ? {}
+            : { target: optionalTrimmed(options.target) }),
+        ...(optionalTrimmed(options.config) === undefined
+            ? {}
+            : { configPath: optionalTrimmed(options.config) }),
+        requireSelection: true,
+    });
+    cmd.success(`Wrangler dev vars prepared at ${result.filePath}`);
+    cmd.info(`Selected keys: ${result.selectedKeys.length}`);
+    if (result.missingKeys.length > 0) {
+        cmd.warn(`Missing keys: ${result.missingKeys.join(', ')}`);
+    }
+};
+export const WranglerDevVarsCommand = Object.freeze({
+    create() {
+        const cmd = BaseCommand.create({
+            name: 'wrangler:dev-vars',
+            description: 'Generate manifest-scoped Wrangler .dev.vars files for local Worker development',
+            aliases: ['cloudflare:dev-vars'],
+            addOptions,
+            execute: async (options) => execute(cmd, options),
+        });
+        return cmd;
+    },
+});
+export default WranglerDevVarsCommand;

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

@@ -8,6 +8,7 @@ export { ContainerWorkersCommand } from '../commands/ContainerWorkersCommand';
 export { AddMigrationCommand, CreateCommand, CreateMigrationCommand, } from '../commands/CreateCommand';
 export { D1ProxyCommand } from '../commands/D1ProxyCommand';
 export { DebugCommand } from '../commands/DebugCommand';
+export { DebuggerCommands } from '../commands/DebuggerCommands';
 export { JwtDevCommand } from '../commands/JwtDevCommand';
 export { KvProxyCommand } from '../commands/KvProxyCommand';
 export { LogsCleanupCommand } from '../commands/LogsCleanupCommand';
@@ -25,4 +26,5 @@ export { RoutesCommand } from '../commands/RoutesCommand';
 export { SecretsCommand } from '../commands/SecretsCommand';
 export { StartCommand } from '../commands/StartCommand';
 export { TemplatesCommand } from '../commands/TemplatesCommand';
+export { WranglerDevVarsCommand } from '../commands/WranglerDevVarsCommand';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,+CAA+C,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,+CAA+C,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC"}

package/src/cli/commands/index.js

@@ -8,6 +8,7 @@ export { ContainerWorkersCommand } from '../commands/ContainerWorkersCommand.js'
 export { AddMigrationCommand, CreateCommand, CreateMigrationCommand, } from '../commands/CreateCommand.js';
 export { D1ProxyCommand } from '../commands/D1ProxyCommand.js';
 export { DebugCommand } from '../commands/DebugCommand.js';
+export { DebuggerCommands } from '../commands/DebuggerCommands.js';
 export { JwtDevCommand } from '../commands/JwtDevCommand.js';
 export { KvProxyCommand } from '../commands/KvProxyCommand.js';
 export { LogsCleanupCommand } from '../commands/LogsCleanupCommand.js';
@@ -25,3 +26,4 @@ export { RoutesCommand } from '../commands/RoutesCommand.js';
 export { SecretsCommand } from '../commands/SecretsCommand.js';
 export { StartCommand } from '../commands/StartCommand.js';
 export { TemplatesCommand } from '../commands/TemplatesCommand.js';
+export { WranglerDevVarsCommand } from '../commands/WranglerDevVarsCommand.js';

package/src/cli/index.d.ts

@@ -10,6 +10,7 @@ export { AddCommand } from './commands/AddCommand';
 export { ConfigCommand } from './commands/ConfigCommand';
 export { D1ProxyCommand } from './commands/D1ProxyCommand';
 export { DebugCommand } from './commands/DebugCommand';
+export { DebuggerCommands } from './commands/DebuggerCommands';
 export { KvProxyCommand } from './commands/KvProxyCommand';
 export { MigrateCommand } from './commands/MigrateCommand';
 export { MySqlProxyCommand } from './commands/MySqlProxyCommand';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/src/cli/index.js

@@ -11,6 +11,7 @@ export { AddCommand } from './commands/AddCommand.js';
 export { ConfigCommand } from './commands/ConfigCommand.js';
 export { D1ProxyCommand } from './commands/D1ProxyCommand.js';
 export { DebugCommand } from './commands/DebugCommand.js';
+export { DebuggerCommands } from './commands/DebuggerCommands.js';
 export { KvProxyCommand } from './commands/KvProxyCommand.js';
 export { MigrateCommand } from './commands/MigrateCommand.js';
 export { MySqlProxyCommand } from './commands/MySqlProxyCommand.js';

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":"AASA,KAAK,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAmIzD,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,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;AAaF,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;AAgMF,eAAO,MAAM,aAAa;qBAjDH,WAAW,KAAQ,SAAS;6BAapB,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,KAAQ,SAAS;mCAG/C,YAAY,KAAG,IAAI;oBA+BpC,SAAS;EAO5B,CAAC"}
+{"version":3,"file":"EnvFileLoader.d.ts","sourceRoot":"","sources":["../../../../src/cli/utils/EnvFileLoader.ts"],"names":[],"mappings":"AASA,KAAK,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AA8IzD,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,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;AAaF,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;AAwMF,eAAO,MAAM,aAAa;qBAjDH,WAAW,KAAQ,SAAS;6BAapB,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,KAAQ,SAAS;mCAG/C,YAAY,KAAG,IAAI;oBA+BpC,SAAS;EAO5B,CAAC"}

package/src/cli/utils/EnvFileLoader.js

@@ -2,10 +2,8 @@ import { Env } from '../../config/env.js';
 import { isArray, isNonEmptyString } from '../../helper/index.js';
 import { existsSync, readFileSync } from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
+const PACK_CONTROL_KEYS = new Set(['USE_PACK', 'PACK_KEYS']);
 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;
@@ -109,6 +107,18 @@ const readEnvFileIfExists = (cwd, filename) => {
     const raw = readFileSync(fullPath, 'utf-8');
     return parseEnvFile(raw);
 };
+const readPackEnvFileIfExists = (cwd) => {
+    const parsed = readEnvFileIfExists(cwd, '.env.pack');
+    if (parsed === undefined)
+        return undefined;
+    const filtered = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        if (PACK_CONTROL_KEYS.has(key))
+            continue;
+        filtered[key] = value;
+    }
+    return filtered;
+};
 const resolveAppMode = (cwd) => {
     const existing = safeEnvGet('NODE_ENV', '');
     if (existing.trim() !== '')
@@ -143,11 +153,13 @@ let cached;
 const loadFromCwd = (cwd, overrideExisting) => {
     const mode = resolveAppMode(cwd);
     const files = filesLoader(cwd, mode);
+    const loadedFiles = [];
     let baseApplied = false;
     for (const file of files) {
         const parsed = readEnvFileIfExists(cwd, file);
         if (!parsed)
             continue;
+        loadedFiles.push(file);
         if (file === '.env') {
             applyToProcessEnv(parsed, overrideExisting);
             baseApplied = true;
@@ -156,11 +168,16 @@ const loadFromCwd = (cwd, overrideExisting) => {
         // .env is primary: overlays only fill missing values and never override base.
         applyToProcessEnv(parsed, baseApplied ? false : overrideExisting);
     }
+    const packedEnv = readPackEnvFileIfExists(cwd);
+    if (packedEnv !== undefined) {
+        applyToProcessEnv(packedEnv, false);
+        loadedFiles.push('.env.pack');
+    }
     // Set NODE_ENV to the normalized mode if we have one (after applying files)
     if (mode !== undefined) {
         safeEnvSet('NODE_ENV', mode);
     }
-    return { loadedFiles: files, mode };
+    return { loadedFiles, mode };
 };
 const loadFromFile = (filePath, overrideExisting) => {
     if (!existsSync(filePath))

package/src/cli.d.ts

@@ -2,6 +2,7 @@ export { BaseCommand } from './cli/BaseCommand';
 export type { CommandOptions } from './cli/BaseCommand';
 export { CLI } from './cli/CLI';
 export { ErrorHandler, EXIT_CODES } from './cli/ErrorHandler';
+export { DebuggerCommands } from './cli/commands/DebuggerCommands';
 export { WorkerCommands } from './cli/commands/WorkerCommands';
 export { OptionalCliCommandRegistry } from './cli/OptionalCliCommandRegistry';
 export type { CliCommandProvider } from './cli/OptionalCliCommandRegistry';

package/src/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,YAAY,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC"}

package/src/cli.js

@@ -2,5 +2,6 @@
 export { BaseCommand } from './cli/BaseCommand.js';
 export { CLI } from './cli/CLI.js';
 export { ErrorHandler, EXIT_CODES } from './cli/ErrorHandler.js';
+export { DebuggerCommands } from './cli/commands/DebuggerCommands.js';
 export { WorkerCommands } from './cli/commands/WorkerCommands.js';
 export { OptionalCliCommandRegistry } from './cli/OptionalCliCommandRegistry.js';

package/src/config/env.d.ts

@@ -7,8 +7,19 @@
  */
 import type { ProcessLike } from './type';
 export type EnvSource = Record<string, unknown> | (() => Record<string, unknown>);
+export type ResolvedEnvState = {
+    values: Record<string, string>;
+    sources: Record<string, string>;
+    packedEnabled: boolean;
+    packedKeys: string[];
+};
 export declare const getProcessLike: () => ProcessLike | undefined;
 export declare const dirnameFromExecPath: (execPath: string, platform?: string) => string;
+export declare const getOptional: (key: string) => string | undefined;
+export declare const has: (key: string) => boolean;
+export declare const getSourceOf: (key: string) => string | undefined;
+export declare const snapshotSources: () => Record<string, string>;
+export declare const getResolvedState: () => ResolvedEnvState;
 export declare const get: (key: string, defaultValue?: string) => string;
 export declare const getInt: (key: string, defaultValue: number) => number;
 export declare const getFloat: (key: string, defaultValue?: number) => number;
@@ -21,13 +32,18 @@ export declare const getDefaultLogLevel: () => "debug" | "info" | "warn" | "erro
 export declare const ZT_PROXY_TIMEOUT_MS: number;
 export declare const Env: Readonly<{
     get: (key: string, defaultValue?: string) => string;
+    getOptional: (key: string) => string | undefined;
     getInt: (key: string, defaultValue: number) => number;
     getBool: (key: string, defaultValue?: boolean) => boolean;
     getFloat: (key: string, defaultValue?: number) => number;
+    has: (key: string) => boolean;
     set: (key: string, value: string) => void;
     unset: (key: string) => void;
     setSource: (source: EnvSource | null) => void;
     snapshot: () => Record<string, string>;
+    getSourceOf: (key: string) => string | undefined;
+    snapshotSources: () => Record<string, string>;
+    getResolvedState: () => ResolvedEnvState;
     NODE_ENV: NodeJS.ProcessEnv["NODE_ENV"];
     PORT: number;
     HOST: string;

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

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/config/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAsClF,eAAO,MAAM,cAAc,QAAO,WAAW,GAAG,SAAwB,CAAC;AAEzE,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAKzE,CAAC;AAGF,eAAO,MAAM,GAAG,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,MAIxD,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,cAAc,MAAM,KAAG,MAI1D,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,eAAe,MAAM,KAAG,MAI7D,CAAC;AAEF,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,eAAe,OAAO,KAAG,OAI7D,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,IAGhD,CAAC;AAEF,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,KAAG,IAInC,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,QAAQ,SAAS,GAAG,IAAI,KAAG,IAEpD,CAAC;AAEF,eAAO,MAAM,QAAQ,QAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAOhD,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAO,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAKjE,CAAC;AACF,eAAO,MAAM,mBAAmB,QAAuC,CAAC;AAKxE,eAAO,MAAM,GAAG;eA3DS,MAAM,iBAAiB,MAAM,KAAG,MAAM;kBAMnC,MAAM,gBAAgB,MAAM,KAAG,MAAM;mBAYpC,MAAM,iBAAiB,OAAO,KAAG,OAAO;oBANvC,MAAM,iBAAiB,MAAM,KAAG,MAAM;eAY3C,MAAM,SAAS,MAAM,KAAG,IAAI;iBAK1B,MAAM,KAAG,IAAI;wBAMN,SAAS,GAAG,IAAI,KAAG,IAAI;oBAI7B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;cAgCJ,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAgOpB,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoFxF,CAAC;AAEH,eAAO,MAAM,aAAa,QAAO,MAchC,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/config/env.ts"],"names":[],"mappings":"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"}

package/src/config/env.js

@@ -5,16 +5,32 @@
  * Sealed namespace pattern - all exports through Env namespace
  * Safe for both Node.js and serverless runtimes (Cloudflare Workers, Deno, Lambda)
  */
+import { isArray, isNonEmptyString, isObject } from '../helper/index.js';
 // Cache process check once at module load time
 const processLike = typeof process === 'undefined' ? undefined : process;
 let externalEnvSource = null;
+const DIRECT_ENV_SOURCE = 'direct-env';
+const PACKED_ENV_ENABLE_KEY = 'USE_PACK';
+const PACKED_ENV_KEYS_KEY = 'PACK_KEYS';
+const PACKED_ENV_CONTROL_KEYS = new Set([PACKED_ENV_ENABLE_KEY, PACKED_ENV_KEYS_KEY]);
+const createPackedEnvError = (message, details) => {
+    const error = Object.create(globalThis.Error.prototype);
+    error.name = 'ConfigError';
+    error.message = message;
+    error.code = 'CONFIG_ERROR';
+    error.statusCode = 500;
+    if (details !== undefined) {
+        error.details = details;
+    }
+    return error;
+};
 const getGlobalEnv = () => {
     const env = globalThis.env;
     if (env === undefined || env === null || typeof env !== 'object')
         return undefined;
     return env;
 };
-const getEnvSource = () => {
+const getRawEnvSource = () => {
     if (typeof externalEnvSource === 'function')
         return externalEnvSource();
     if (externalEnvSource !== null)
@@ -28,6 +44,14 @@ const getEnvSource = () => {
     }
     return processLike?.env ?? {};
 };
+const normalizePackedScalar = (packName, key, value) => {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    throw createPackedEnvError(`${packName} contains unsupported value for ${key}. Expected a flat string-compatible value.`);
+};
 const normalizeEnvValue = (value) => {
     if (value === null || value === undefined)
         return '';
@@ -38,6 +62,86 @@ const normalizeEnvValue = (value) => {
     }
     return '';
 };
+const isDirectEnvScalar = (value) => {
+    return (value === null ||
+        value === undefined ||
+        typeof value === 'string' ||
+        typeof value === 'number' ||
+        typeof value === 'boolean' ||
+        typeof value === 'bigint');
+};
+const parsePackedEnvKeys = (env) => {
+    const enabled = normalizeEnvValue(env[PACKED_ENV_ENABLE_KEY]).trim().toLowerCase() === 'true';
+    if (!enabled) {
+        return { enabled: false, packKeys: [] };
+    }
+    const raw = normalizeEnvValue(env[PACKED_ENV_KEYS_KEY]);
+    const packKeys = raw
+        .split(',')
+        .map((item) => item.trim())
+        .filter((item, index, items) => item !== '' && items.indexOf(item) === index);
+    if (packKeys.length === 0) {
+        throw createPackedEnvError('USE_PACK is true but PACK_KEYS is empty');
+    }
+    return { enabled: true, packKeys };
+};
+const parsePackedPayload = (packName, payload) => {
+    if (!isNonEmptyString(normalizeEnvValue(payload))) {
+        throw createPackedEnvError(`PACK_KEYS contains ${packName} but env.${packName} is missing`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(normalizeEnvValue(payload));
+    }
+    catch (error) {
+        throw createPackedEnvError(`${packName} did not parse as a JSON object`, error);
+    }
+    if (!isObject(parsed) || isArray(parsed)) {
+        throw createPackedEnvError(`${packName} did not parse as a JSON object`);
+    }
+    return parsed;
+};
+const applyPackedPayload = (values, sources, packName, payload) => {
+    for (const [rawKey, rawValue] of Object.entries(payload)) {
+        const key = rawKey.trim();
+        if (!isNonEmptyString(key))
+            continue;
+        if (PACKED_ENV_CONTROL_KEYS.has(key))
+            continue;
+        if (isObject(rawValue) || isArray(rawValue) || rawValue === null || rawValue === undefined) {
+            throw createPackedEnvError(`${packName} contains unsupported value for ${key}. Nested or null values are not supported.`);
+        }
+        values[key] = normalizePackedScalar(packName, key, rawValue);
+        sources[key] = packName;
+    }
+};
+const overlayDirectEnvValues = (values, sources, env) => {
+    for (const [key, rawValue] of Object.entries(env)) {
+        if (!isDirectEnvScalar(rawValue))
+            continue;
+        values[key] = normalizeEnvValue(rawValue);
+        sources[key] = DIRECT_ENV_SOURCE;
+    }
+};
+const resolvePackedEnvState = (env) => {
+    const values = {};
+    const sources = {};
+    const { enabled, packKeys } = parsePackedEnvKeys(env);
+    if (enabled) {
+        for (const packName of packKeys) {
+            applyPackedPayload(values, sources, packName, parsePackedPayload(packName, env[packName]));
+        }
+    }
+    overlayDirectEnvValues(values, sources, env);
+    return {
+        values,
+        sources,
+        packedEnabled: enabled,
+        packedKeys: packKeys,
+    };
+};
+const getResolvedEnvState = () => resolvePackedEnvState(getRawEnvSource());
+const getEnvSource = () => getResolvedEnvState().values;
 export const getProcessLike = () => processLike;
 export const dirnameFromExecPath = (execPath, platform) => {
     const separator = platform === 'win32' ? '\\' : '/';
@@ -46,11 +150,26 @@ export const dirnameFromExecPath = (execPath, platform) => {
         return '';
     return execPath.slice(0, lastSep);
 };
+export const getOptional = (key) => {
+    const env = getEnvSource();
+    return Object.prototype.hasOwnProperty.call(env, key) ? normalizeEnvValue(env[key]) : undefined;
+};
+export const has = (key) => {
+    const env = getEnvSource();
+    return Object.prototype.hasOwnProperty.call(env, key);
+};
+export const getSourceOf = (key) => {
+    return getResolvedEnvState().sources[key];
+};
+export const snapshotSources = () => {
+    return { ...getResolvedEnvState().sources };
+};
+export const getResolvedState = () => getResolvedEnvState();
 // Private helper functions
 export const get = (key, defaultValue) => {
     const env = getEnvSource();
     const value = normalizeEnvValue(env[key]);
-    return value === '' ? defaultValue ?? '' : value;
+    return value === '' ? (defaultValue ?? '') : value;
 };
 export const getInt = (key, defaultValue) => {
     const value = get(key, String(defaultValue ?? 0));
@@ -107,13 +226,18 @@ const PROXY_SECRET_FALLBACK = get('APP_KEY', '');
 export const Env = Object.freeze({
     // Helper functions
     get,
+    getOptional,
     getInt,
     getBool,
     getFloat,
+    has,
     set,
     unset,
     setSource,
     snapshot,
+    getSourceOf,
+    snapshotSources,
+    getResolvedState,
     // Core
     NODE_ENV: get('NODE_ENV', 'development'),
     // Prefer PORT, fallback to APP_PORT for compatibility

package/src/config/logger.d.ts

@@ -1,3 +1,4 @@
+import type { LogLevel } from './type';
 interface ILogger {
     debug(message: string, data?: unknown, category?: string): void;
     info(message: string, data?: unknown, category?: string): void;
@@ -5,6 +6,11 @@ interface ILogger {
     error(message: string, error?: unknown, category?: string): void;
     fatal(message: string, error?: unknown, category?: string): void;
 }
+/**
+ * External log sink. Receives every log line after the built-in sinks have fired.
+ * Return value is ignored; errors are swallowed to protect the caller.
+ */
+export type LogSink = (level: LogLevel, message: string, context?: Record<string, unknown>) => void;
 export declare const cleanLogsOnce: () => Promise<string[]>;
 export declare const Logger: Readonly<{
     debug: (message: string, data?: unknown, category?: string) => void;
@@ -14,6 +20,7 @@ export declare const Logger: Readonly<{
     fatal: (message: string, error?: unknown, category?: string) => void;
     cleanLogsOnce: () => Promise<string[]>;
     scope: (scope: string) => ILogger;
+    addSink: (fn: LogSink) => (() => void);
 }>;
 export default Logger;
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/config/logger.ts"],"names":[],"mappings":"AAUA,UAAU,OAAO;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClE;AA8aD,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,MAAM,EAAE,CAYtD,CAAC;AAEF,eAAO,MAAM,MAAM;qBA5JQ,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAqBjD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAqBhD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;qBAqB/C,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;qBA2BjD,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;yBAoDrC,OAAO,CAAC,MAAM,EAAE,CAAC;mBArBtB,MAAM,KAAG,OAAO;EA2ChD,CAAC;AAEH,eAAe,MAAM,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/config/logger.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,UAAU,OAAO;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClE;AAubD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAkCpG,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,MAAM,EAAE,CAYtD,CAAC;AAEF,eAAO,MAAM,MAAM;qBA3MQ,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAuBjD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;oBAuBhD,MAAM,SAAS,OAAO,aAAa,MAAM,KAAG,IAAI;qBAuB/C,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;qBA6BjD,MAAM,UAAU,OAAO,aAAa,MAAM,KAAG,IAAI;yBA2FrC,OAAO,CAAC,MAAM,EAAE,CAAC;mBA1DtB,MAAM,KAAG,OAAO;kBAiD7B,OAAO,KAAG,CAAC,MAAM,IAAI,CAAC;EAgCzC,CAAC;AAEH,eAAe,MAAM,CAAC"}