varlock 0.7.1 → 0.7.2

package/dist/auto-load.js

@@ -1,7 +1,7 @@
-import './chunk-BEV4WCAI.js';
+import './chunk-GYK3QFZB.js';
 import './chunk-LVZSZAKN.js';
 import './chunk-MYHVSJ3X.js';
-import './chunk-K6M42GW2.js';
+import './chunk-N5O4Z32O.js';
 import './chunk-BC7LU4LG.js';
 import './chunk-IMB5QAZS.js';
 import './chunk-XLYSNOR3.js';

package/dist/chunk-3I5FHXMJ.js

@@ -0,0 +1,162 @@
+import { define } from './chunk-4A54P4EM.js';
+import { checkForSchemaErrors, checkForNoEnvFiles } from './chunk-EPWHAD6X.js';
+import { loadVarlockEnvGraph } from './chunk-BIIYEXRU.js';
+import { gracefulExit } from './chunk-CHQDS2PI.js';
+import { CliExitError, formattedValue } from './chunk-LQ25CRHF.js';
+import { StaticValueResolver, ansis_default } from './chunk-G2GPGCAP.js';
+import { my_dash_default } from './chunk-6CCHLM3U.js';
+import { redactString } from './chunk-XLYSNOR3.js';
+import { __name } from './chunk-6PEHRAEP.js';
+
+// src/cli/commands/explain.command.ts
+var commandSpec = define({
+  name: "explain",
+  description: "Show detailed information about how a config item is resolved",
+  args: {
+    env: {
+      type: "string",
+      description: "Set the environment (e.g., production, development, etc)"
+    },
+    path: {
+      type: "string",
+      short: "p",
+      description: "Path to a specific .env file or directory to use as the entry point"
+    }
+  },
+  examples: `
+Shows detailed information about all definitions, sources, and overrides
+that feed into a single config item. Useful for debugging why a value
+is not what you expect.
+
+Examples:
+  varlock explain DATABASE_URL          # Explain how DATABASE_URL is resolved
+  varlock explain --env production API_KEY  # Explain in production context
+`.trim()
+});
+function describeResolver(resolver, indent = "") {
+  if (resolver instanceof StaticValueResolver) {
+    return `${indent}static value`;
+  }
+  const fnName = resolver.fnName;
+  if (fnName && !fnName.startsWith("\0")) {
+    return `${indent}${fnName}()`;
+  }
+  return `${indent}(resolver)`;
+}
+__name(describeResolver, "describeResolver");
+var commandFn = /* @__PURE__ */ __name(async (ctx) => {
+  const positionals = (ctx.positionals ?? []).slice(ctx.commandPath?.length ?? 0);
+  if (!positionals.length) {
+    throw new CliExitError("Missing required argument: variable name", {
+      suggestion: "Run `varlock explain MY_VAR` to explain a config item"
+    });
+  }
+  const varName = positionals[0];
+  const envGraph = await loadVarlockEnvGraph({
+    currentEnvFallback: ctx.values.env,
+    entryFilePath: ctx.values.path
+  });
+  checkForSchemaErrors(envGraph);
+  checkForNoEnvFiles(envGraph);
+  if (!(varName in envGraph.configSchema)) {
+    throw new CliExitError(`Variable "${varName}" not found in schema`);
+  }
+  await envGraph.resolveEnvValues();
+  const item = envGraph.configSchema[varName];
+  const isSensitive = item.isSensitive;
+  console.log("");
+  console.log(ansis_default.bold.cyan(`  ${item.key}`));
+  console.log("");
+  if (item.description) {
+    console.log(`  ${ansis_default.gray("Description:")} ${item.description}`);
+  }
+  if (item.dataType) {
+    console.log(`  ${ansis_default.gray("Type:")} ${item.dataType.name}`);
+  }
+  const props = [];
+  if (item.isRequired) props.push("required");
+  else props.push("optional");
+  if (isSensitive) props.push("sensitive");
+  else props.push("public");
+  console.log(`  ${ansis_default.gray("Properties:")} ${props.join(", ")}`);
+  console.log("");
+  console.log(ansis_default.bold("  Resolved value"));
+  if (item.validationState === "error") {
+    console.log(`  ${ansis_default.red("  (resolution failed)")}`);
+    for (const err of item.errors) {
+      console.log(`  ${ansis_default.red(`  - ${err.message}`)}`);
+    }
+  } else {
+    let valStr = formattedValue(item.resolvedValue, true);
+    if (isSensitive && item.resolvedValue && my_dash_default.isString(item.resolvedValue)) {
+      valStr = redactString(item.resolvedValue);
+    }
+    console.log(`    ${valStr}`);
+    if (item.isCoerced) {
+      let rawStr = formattedValue(item.resolvedRawValue, true);
+      if (isSensitive && item.resolvedRawValue && my_dash_default.isString(item.resolvedRawValue)) {
+        rawStr = redactString(item.resolvedRawValue);
+      }
+      console.log(`    ${ansis_default.gray.italic(`coerced from ${rawStr}`)}`);
+    }
+  }
+  console.log("");
+  console.log(ansis_default.bold("  Value source"));
+  if (item.isOverridden) {
+    console.log(`    ${ansis_default.yellow("\u26A1 process.env override")} ${ansis_default.yellow.bold("(active)")}`);
+    const activeValueDef = item.activeValueDef;
+    if (activeValueDef) {
+      const sourceLabel = activeValueDef.source?.label || "internal";
+      const resolverDesc = activeValueDef.itemDef.resolver ? describeResolver(activeValueDef.itemDef.resolver) : "no value";
+      console.log(`    ${ansis_default.gray("\u2514")} ${ansis_default.gray.italic(`would use ${resolverDesc} from ${sourceLabel} without override`)}`);
+    }
+  } else {
+    const activeValueDef = item.activeValueDef;
+    if (activeValueDef) {
+      const sourceLabel = activeValueDef.source?.label || "internal";
+      const resolverDesc = activeValueDef.itemDef.resolver ? describeResolver(activeValueDef.itemDef.resolver) : "no value";
+      console.log(`    ${resolverDesc} from ${ansis_default.cyan(sourceLabel)}`);
+    } else {
+      console.log(`    ${ansis_default.gray("(no value set)")}`);
+    }
+  }
+  const defs = item.defs;
+  if (defs.length) {
+    console.log("");
+    console.log(ansis_default.bold("  All definitions") + ansis_default.gray(` (${defs.length} source${defs.length > 1 ? "s" : ""}, highest priority first)`));
+    for (let i = 0; i < defs.length; i++) {
+      const def = defs[i];
+      const sourceLabel = def.source?.label || "internal (builtin)";
+      const sourceType = def.source?.type || "builtin";
+      const isActiveSource = !item.isOverridden && def === item.activeValueDef;
+      const marker = isActiveSource ? ansis_default.green(" \u2190 active") : "";
+      console.log(`    ${ansis_default.gray(`${i + 1}.`)} ${ansis_default.cyan(sourceLabel)} ${ansis_default.gray(`(${sourceType})`)}${marker}`);
+      if (def.itemDef.resolver) {
+        console.log(`       ${ansis_default.gray("value:")} ${describeResolver(def.itemDef.resolver)}`);
+      } else {
+        console.log(`       ${ansis_default.gray("value:")} ${ansis_default.gray.italic("(none - decorators only)")}`);
+      }
+      const decNames = def.itemDef.decorators?.map((d) => `@${d.name}`).join(", ");
+      if (decNames) {
+        console.log(`       ${ansis_default.gray("decorators:")} ${ansis_default.magenta(decNames)}`);
+      }
+    }
+  }
+  const docsLinks = item.docsLinks;
+  if (docsLinks.length) {
+    console.log("");
+    console.log(ansis_default.bold("  Documentation"));
+    for (const link of docsLinks) {
+      const label = link.description ? `${link.description}: ` : "";
+      console.log(`    ${label}${ansis_default.underline(link.url)}`);
+    }
+  }
+  console.log("");
+  if (item.validationState === "error") {
+    gracefulExit(1);
+  }
+}, "commandFn");
+
+export { commandFn, commandSpec };
+//# sourceMappingURL=chunk-3I5FHXMJ.js.map
+//# sourceMappingURL=chunk-3I5FHXMJ.js.map

package/dist/chunk-3I5FHXMJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/explain.command.ts"],"names":[],"mappings":"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","file":"chunk-3I5FHXMJ.js","sourcesContent":["import ansis from 'ansis';\nimport { define } from 'gunshi';\nimport { gracefulExit } from 'exit-hook';\n\nimport { loadVarlockEnvGraph } from '../../lib/load-graph';\nimport { formattedValue } from '../../lib/formatting';\nimport { redactString } from '../../runtime/lib/redaction';\nimport {\n  checkForSchemaErrors, checkForNoEnvFiles,\n} from '../helpers/error-checks';\nimport { type TypedGunshiCommandFn } from '../helpers/gunshi-type-utils';\nimport { CliExitError } from '../helpers/exit-error';\nimport { StaticValueResolver } from '../../env-graph/lib/resolver';\nimport _ from '@env-spec/utils/my-dash';\n\nexport const commandSpec = define({\n  name: 'explain',\n  description: 'Show detailed information about how a config item is resolved',\n  args: {\n    env: {\n      type: 'string',\n      description: 'Set the environment (e.g., production, development, etc)',\n    },\n    path: {\n      type: 'string',\n      short: 'p',\n      description: 'Path to a specific .env file or directory to use as the entry point',\n    },\n  },\n  examples: `\nShows detailed information about all definitions, sources, and overrides\nthat feed into a single config item. Useful for debugging why a value\nis not what you expect.\n\nExamples:\n  varlock explain DATABASE_URL          # Explain how DATABASE_URL is resolved\n  varlock explain --env production API_KEY  # Explain in production context\n`.trim(),\n});\n\nfunction describeResolver(resolver: any, indent = ''): string {\n  if (resolver instanceof StaticValueResolver) {\n    return `${indent}static value`;\n  }\n  const fnName = resolver.fnName;\n  if (fnName && !fnName.startsWith('\\0')) {\n    return `${indent}${fnName}()`;\n  }\n  return `${indent}(resolver)`;\n}\n\nexport const commandFn: TypedGunshiCommandFn<typeof commandSpec> = async (ctx) => {\n  const positionals = (ctx.positionals ?? []).slice(ctx.commandPath?.length ?? 0);\n  if (!positionals.length) {\n    throw new CliExitError('Missing required argument: variable name', {\n      suggestion: 'Run `varlock explain MY_VAR` to explain a config item',\n    });\n  }\n  const varName = positionals[0];\n\n  const envGraph = await loadVarlockEnvGraph({\n    currentEnvFallback: ctx.values.env,\n    entryFilePath: ctx.values.path,\n  });\n\n  checkForSchemaErrors(envGraph);\n  checkForNoEnvFiles(envGraph);\n\n  if (!(varName in envGraph.configSchema)) {\n    throw new CliExitError(`Variable \"${varName}\" not found in schema`);\n  }\n\n  await envGraph.resolveEnvValues();\n\n  const item = envGraph.configSchema[varName];\n  const isSensitive = item.isSensitive;\n\n  // Header\n  console.log('');\n  console.log(ansis.bold.cyan(`  ${item.key}`));\n  console.log('');\n\n  // Description\n  if (item.description) {\n    console.log(`  ${ansis.gray('Description:')} ${item.description}`);\n  }\n\n  // Type info\n  if (item.dataType) {\n    console.log(`  ${ansis.gray('Type:')} ${item.dataType.name}`);\n  }\n\n  // Properties\n  const props = [];\n  if (item.isRequired) props.push('required');\n  else props.push('optional');\n  if (isSensitive) props.push('sensitive');\n  else props.push('public');\n  console.log(`  ${ansis.gray('Properties:')} ${props.join(', ')}`);\n\n  // Resolved value\n  console.log('');\n  console.log(ansis.bold('  Resolved value'));\n  if (item.validationState === 'error') {\n    console.log(`  ${ansis.red('  (resolution failed)')}`);\n    for (const err of item.errors) {\n      console.log(`  ${ansis.red(`  - ${err.message}`)}`);\n    }\n  } else {\n    let valStr = formattedValue(item.resolvedValue, true);\n    if (isSensitive && item.resolvedValue && _.isString(item.resolvedValue)) {\n      valStr = redactString(item.resolvedValue)!;\n    }\n    console.log(`    ${valStr}`);\n    if (item.isCoerced) {\n      let rawStr = formattedValue(item.resolvedRawValue, true);\n      if (isSensitive && item.resolvedRawValue && _.isString(item.resolvedRawValue)) {\n        rawStr = redactString(item.resolvedRawValue)!;\n      }\n      console.log(`    ${ansis.gray.italic(`coerced from ${rawStr}`)}`);\n    }\n  }\n\n  // Value source\n  console.log('');\n  console.log(ansis.bold('  Value source'));\n\n  if (item.isOverridden) {\n    console.log(`    ${ansis.yellow('⚡ process.env override')} ${ansis.yellow.bold('(active)')}`);\n    const activeValueDef = item.activeValueDef;\n    if (activeValueDef) {\n      const sourceLabel = activeValueDef.source?.label || 'internal';\n      const resolverDesc = activeValueDef.itemDef.resolver\n        ? describeResolver(activeValueDef.itemDef.resolver)\n        : 'no value';\n      console.log(`    ${ansis.gray('└')} ${ansis.gray.italic(`would use ${resolverDesc} from ${sourceLabel} without override`)}`);\n    }\n  } else {\n    const activeValueDef = item.activeValueDef;\n    if (activeValueDef) {\n      const sourceLabel = activeValueDef.source?.label || 'internal';\n      const resolverDesc = activeValueDef.itemDef.resolver\n        ? describeResolver(activeValueDef.itemDef.resolver)\n        : 'no value';\n      console.log(`    ${resolverDesc} from ${ansis.cyan(sourceLabel)}`);\n    } else {\n      console.log(`    ${ansis.gray('(no value set)')}`);\n    }\n  }\n\n  // All definitions\n  const defs = item.defs;\n  if (defs.length) {\n    console.log('');\n    console.log(ansis.bold('  All definitions') + ansis.gray(` (${defs.length} source${defs.length > 1 ? 's' : ''}, highest priority first)`));\n\n    for (let i = 0; i < defs.length; i++) {\n      const def = defs[i];\n      const sourceLabel = def.source?.label || 'internal (builtin)';\n      const sourceType = def.source?.type || 'builtin';\n\n      const isActiveSource = !item.isOverridden && def === item.activeValueDef;\n      const marker = isActiveSource ? ansis.green(' ← active') : '';\n\n      console.log(`    ${ansis.gray(`${i + 1}.`)} ${ansis.cyan(sourceLabel)} ${ansis.gray(`(${sourceType})`)}${marker}`);\n\n      // Show resolver info\n      if (def.itemDef.resolver) {\n        console.log(`       ${ansis.gray('value:')} ${describeResolver(def.itemDef.resolver)}`);\n      } else {\n        console.log(`       ${ansis.gray('value:')} ${ansis.gray.italic('(none - decorators only)')}`);\n      }\n\n      // Show decorators from this definition\n      const decNames = def.itemDef.decorators?.map((d) => `@${d.name}`).join(', ');\n      if (decNames) {\n        console.log(`       ${ansis.gray('decorators:')} ${ansis.magenta(decNames)}`);\n      }\n    }\n  }\n\n  // Docs links\n  const docsLinks = item.docsLinks;\n  if (docsLinks.length) {\n    console.log('');\n    console.log(ansis.bold('  Documentation'));\n    for (const link of docsLinks) {\n      const label = link.description ? `${link.description}: ` : '';\n      console.log(`    ${label}${ansis.underline(link.url)}`);\n    }\n  }\n\n  console.log('');\n\n  if (item.validationState === 'error') {\n    gracefulExit(1);\n  }\n};\n"]}

package/dist/{chunk-EQGPMXDI.js → chunk-3LT4WWHG.js}

@@ -1,7 +1,8 @@
-import { fmt } from './chunk-WHSHSZQR.js';
+import { fmt } from './chunk-EBOBYFMY.js';
 import { define } from './chunk-4A54P4EM.js';
-import { CliExitError, gracefulExit } from './chunk-TQDVHRUW.js';
-import { getUserVarlockDir } from './chunk-B6SVDIAN.js';
+import { gracefulExit } from './chunk-CHQDS2PI.js';
+import { CliExitError } from './chunk-LQ25CRHF.js';
+import { getUserVarlockDir } from './chunk-G2GPGCAP.js';
 import { __name } from './chunk-6PEHRAEP.js';
 import { join } from 'path';
 import { mkdir, readFile, writeFile } from 'fs/promises';
@@ -62,5 +63,5 @@ var commandFn = /* @__PURE__ */ __name(async (ctx) => {
 }, "commandFn");
 
 export { commandFn, commandSpec };
-//# sourceMappingURL=chunk-EQGPMXDI.js.map
-//# sourceMappingURL=chunk-EQGPMXDI.js.map
+//# sourceMappingURL=chunk-3LT4WWHG.js.map
+//# sourceMappingURL=chunk-3LT4WWHG.js.map

package/dist/chunk-3LT4WWHG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/telemetry.command.ts"],"names":[],"mappings":";;;;;;;;;;AAWO,IAAM,cAAc,MAAA,CAAO;AAAA,EAChC,IAAA,EAAM,WAAA;AAAA,EACN,WAAA,EAAa,0CAAA;AAAA,EACb,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM;AAAA,MACJ,IAAA,EAAM,YAAA;AAAA,MACN,WAAA,EAAa;AAAA;AACf,GACF;AAAA,EACA,QAAA,EAAU;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA;;AAAA;AAAA;AAAA,EAAA,CAAA,CAWR,IAAA;AACJ,CAAC;AAEM,IAAM,SAAA,iCAA6D,GAAA,KAAQ;AAEhF,EAAA,IAAI,CAAC,CAAC,QAAA,EAAU,SAAS,EAAE,QAAA,CAAS,GAAA,CAAI,MAAA,CAAO,IAAI,CAAA,EAAG;AACpD,IAAA,MAAM,IAAI,aAAa,8CAAA,EAAgD;AAAA,MACrE,SAAA,EAAW;AAAA,KACZ,CAAA;AAAA,EACH;AAEA,EAAA,MAAM,YAAY,iBAAA,EAAkB;AACpC,EAAA,MAAM,UAAA,GAAa,IAAA,CAAK,SAAA,EAAW,aAAa,CAAA;AAEhD,EAAA,IAAI;AAEF,IAAA,IAAI,CAAC,UAAA,CAAW,SAAS,CAAA,EAAG;AAC1B,MAAA,MAAM,KAAA,CAAM,SAAA,EAAW,EAAE,SAAA,EAAW,MAAM,CAAA;AAAA,IAC5C;AAGA,IAAA,IAAI,SAA8B,EAAC;AACnC,IAAA,IAAI,UAAA,CAAW,UAAU,CAAA,EAAG;AAC1B,MAAA,MAAM,aAAA,GAAgB,MAAM,QAAA,CAAS,UAAA,EAAY,OAAO,CAAA;AACxD,MAAA,MAAA,GAAS,IAAA,CAAK,MAAM,aAAa,CAAA;AAAA,IACnC;AAGA,IAAA,IAAI,GAAA,CAAI,MAAA,CAAO,IAAA,KAAS,SAAA,SAAkB,iBAAA,GAAoB,IAAA;AAAA,gBAClD,MAAA,CAAO,iBAAA;AACnB,IAAA,MAAM,UAAU,UAAA,EAAY,IAAA,CAAK,UAAU,MAAA,EAAQ,IAAA,EAAM,CAAC,CAAC,CAAA;AAE3D,IAAA,IAAI,GAAA,CAAI,MAAA,CAAO,IAAA,KAAS,QAAA,EAAU;AAChC,MAAA,OAAA,CAAQ,IAAI,uDAAkD,CAAA;AAAA,IAChE,CAAA,MAAO;AACL,MAAA,OAAA,CAAQ,IAAI,wDAAmD,CAAA;AAAA,IACjE;AACA,IAAA,OAAA,CAAQ,GAAA,CAAI,aAAA,EAAe,GAAA,CAAI,QAAA,CAAS,UAAU,CAAC,CAAA;AAAA,EACrD,SAAS,KAAA,EAAO;AACd,IAAA,OAAA,CAAQ,KAAA,CAAM,mCAAmC,KAAK,CAAA;AACtD,IAAA,OAAO,aAAa,CAAC,CAAA;AAAA,EACvB;AACF,CAAA,EAvCmE,WAAA","file":"chunk-3LT4WWHG.js","sourcesContent":["import { join } from 'node:path';\nimport { mkdir, writeFile, readFile } from 'node:fs/promises';\nimport { existsSync } from 'node:fs';\nimport { define } from 'gunshi';\nimport { type TypedGunshiCommandFn } from '../helpers/gunshi-type-utils';\nimport { gracefulExit } from 'exit-hook';\nimport { fmt } from '../helpers/pretty-format';\nimport { CliExitError } from '../helpers/exit-error';\nimport { getUserVarlockDir } from '../../lib/user-config-dir';\n\n\nexport const commandSpec = define({\n  name: 'telemetry',\n  description: 'Enable/disable anonymous usage analytics',\n  args: {\n    mode: {\n      type: 'positional',\n      description: '\"enable\" or \"disable\"',\n    },\n  },\n  examples: `\nOpts in/out of anonymous usage analytics. This command creates/updates a configuration\nfile at $XDG_CONFIG_HOME/varlock/config.json (or ~/.config/varlock/config.json) saving\nyour preference.\n\nExamples:\n  varlock telemetry disable    # Opt out of telemetry\n  varlock telemetry enable     # Opt in to telemetry\n\n💡 Tip: You can also temporarily opt out by setting VARLOCK_TELEMETRY_DISABLED=1\nFor more information, visit https://varlock.dev/guides/telemetry/\n  `.trim(),\n});\n\nexport const commandFn: TypedGunshiCommandFn<typeof commandSpec> = async (ctx) => {\n  // TODO: remove this when gunshi supports types/validation for positional args\n  if (!['enable', 'disable'].includes(ctx.values.mode)) {\n    throw new CliExitError('additional arg must be \"enable\" or \"disable\"', {\n      forceExit: true,\n    });\n  }\n\n  const configDir = getUserVarlockDir();\n  const configPath = join(configDir, 'config.json');\n\n  try {\n    // Create .varlock directory if it doesn't exist\n    if (!existsSync(configDir)) {\n      await mkdir(configDir, { recursive: true });\n    }\n\n    // Read existing config if it exists\n    let config: Record<string, any> = {};\n    if (existsSync(configPath)) {\n      const configContent = await readFile(configPath, 'utf-8');\n      config = JSON.parse(configContent);\n    }\n\n    // update config `telemetryDisabled` setting\n    if (ctx.values.mode === 'disable') config.telemetryDisabled = true;\n    else delete config.telemetryDisabled;\n    await writeFile(configPath, JSON.stringify(config, null, 2));\n\n    if (ctx.values.mode === 'enable') {\n      console.log('✅ Successfully enabled anonymous usage analytics');\n    } else {\n      console.log('✅ Successfully disabled anonymous usage analytics');\n    }\n    console.log('> saved in:', fmt.filePath(configPath));\n  } catch (error) {\n    console.error('Failed to opt out of analytics:', error);\n    return gracefulExit(1);\n  }\n};\n"]}

package/dist/{chunk-UGUCGDKH.js → chunk-AJCLNVYI.js}

@@ -1,7 +1,8 @@
 import { define } from './chunk-4A54P4EM.js';
-import { checkForSchemaErrors } from './chunk-4KSIULUK.js';
-import { loadVarlockEnvGraph } from './chunk-GCEP6UVQ.js';
-import { CliExitError, gracefulExit } from './chunk-TQDVHRUW.js';
+import { checkForSchemaErrors } from './chunk-EPWHAD6X.js';
+import { loadVarlockEnvGraph } from './chunk-BIIYEXRU.js';
+import { gracefulExit } from './chunk-CHQDS2PI.js';
+import { CliExitError } from './chunk-LQ25CRHF.js';
 import { __name } from './chunk-6PEHRAEP.js';
 
 // src/cli/commands/printenv.command.ts
@@ -63,5 +64,5 @@ var commandFn = /* @__PURE__ */ __name(async (ctx) => {
 }, "commandFn");
 
 export { commandFn, commandSpec };
-//# sourceMappingURL=chunk-UGUCGDKH.js.map
-//# sourceMappingURL=chunk-UGUCGDKH.js.map
+//# sourceMappingURL=chunk-AJCLNVYI.js.map
+//# sourceMappingURL=chunk-AJCLNVYI.js.map

package/dist/chunk-AJCLNVYI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/printenv.command.ts"],"names":[],"mappings":";;;;;;;;AAQO,IAAM,cAAc,MAAA,CAAO;AAAA,EAChC,IAAA,EAAM,UAAA;AAAA,EACN,WAAA,EAAa,2DAAA;AAAA,EACb,IAAA,EAAM;AAAA,IACJ,IAAA,EAAM;AAAA,MACJ,IAAA,EAAM,QAAA;AAAA,MACN,KAAA,EAAO,GAAA;AAAA,MACP,WAAA,EAAa;AAAA;AACf,GACF;AAAA,EACA,QAAA,EAAU;AAAA;AAAA;;AAAA;AAAA;AAAA;AAAA;;AAAA;AAAA;;AAAA;AAAA;AAAA,EAAA,CAAA,CAcR,IAAA;AACJ,CAAC;AAEM,IAAM,SAAA,iCAA6D,GAAA,KAAQ;AAGhF,EAAA,MAAM,WAAA,GAAA,CAAe,IAAI,WAAA,IAAe,IAAI,KAAA,CAAM,GAAA,CAAI,WAAA,EAAa,MAAA,IAAU,CAAC,CAAA;AAC9E,EAAA,IAAI,CAAC,YAAY,MAAA,EAAQ;AACvB,IAAA,MAAM,IAAI,aAAa,0CAAA,EAA4C;AAAA,MACjE,UAAA,EAAY;AAAA,KACb,CAAA;AAAA,EACH;AACA,EAAA,MAAM,OAAA,GAAU,YAAY,CAAC,CAAA;AAE7B,EAAA,MAAM,QAAA,GAAW,MAAM,mBAAA,CAAoB;AAAA,IACzC,aAAA,EAAe,IAAI,MAAA,CAAO;AAAA,GAC3B,CAAA;AACD,EAAA,oBAAA,CAAqB,QAAQ,CAAA;AAE7B,EAAA,IAAI,EAAE,OAAA,IAAW,QAAA,CAAS,YAAA,CAAA,EAAe;AACvC,IAAA,MAAM,IAAI,YAAA,CAAa,CAAA,UAAA,EAAa,OAAO,CAAA,qBAAA,CAAuB,CAAA;AAAA,EACpE;AAGA,EAAA,MAAM,QAAA,CAAS,oBAAoB,OAAO,CAAA;AAE1C,EAAA,MAAM,IAAA,GAAO,QAAA,CAAS,YAAA,CAAa,OAAO,CAAA;AAC1C,EAAA,IAAI,IAAA,CAAK,oBAAoB,OAAA,EAAS;AACpC,IAAA,KAAA,MAAW,GAAA,IAAO,KAAK,MAAA,EAAQ;AAC7B,MAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,UAAA,EAAM,GAAA,CAAI,OAAO,CAAA,CAAE,CAAA;AAAA,IACnC;AACA,IAAA,OAAO,aAAa,CAAC,CAAA;AAAA,EACvB;AAEA,EAAA,MAAM,QAAQ,IAAA,CAAK,aAAA;AACnB,EAAA,IAAI,KAAA,KAAU,MAAA,IAAa,KAAA,KAAU,IAAA,EAAM;AACzC,IAAA,OAAA,CAAQ,IAAI,EAAE,CAAA;AAAA,EAChB,CAAA,MAAO;AACL,IAAA,OAAA,CAAQ,GAAA,CAAI,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,EAC3B;AACF,CAAA,EArCmE,WAAA","file":"chunk-AJCLNVYI.js","sourcesContent":["import { define } from 'gunshi';\nimport { gracefulExit } from 'exit-hook';\n\nimport { loadVarlockEnvGraph } from '../../lib/load-graph';\nimport { checkForSchemaErrors } from '../helpers/error-checks';\nimport { type TypedGunshiCommandFn } from '../helpers/gunshi-type-utils';\nimport { CliExitError } from '../helpers/exit-error';\n\nexport const commandSpec = define({\n  name: 'printenv',\n  description: 'Print the resolved value of a single environment variable',\n  args: {\n    path: {\n      type: 'string',\n      short: 'p',\n      description: 'Path to a specific .env file or directory (with trailing slash) to use as the entry point',\n    },\n  },\n  examples: `\nPrints the resolved value of a single environment variable.\nUseful within larger shell commands where you need a single env var value.\n\nExamples:\n  varlock printenv MY_VAR                    # Print the value of MY_VAR\n  varlock printenv --path .env.prod MY_VAR   # Use a specific .env file\n  varlock printenv --path ./config/ MY_VAR   # Use a specific directory\n\n📍 Note: Use sh -c to embed this in shell commands, e.g.:\n       sh -c 'do-something --token $(varlock printenv MY_TOKEN)'\n\n💡 Tip: Unlike \\`varlock run -- echo $MY_VAR\\`, this works because the shell\n       expansion happens after varlock has printed the value.\n  `.trim(),\n});\n\nexport const commandFn: TypedGunshiCommandFn<typeof commandSpec> = async (ctx) => {\n  // ctx.positionals includes the subcommand name(s) themselves, so we skip them\n  // by slicing off ctx.commandPath.length entries (e.g. skips 'printenv' at index 0)\n  const positionals = (ctx.positionals ?? []).slice(ctx.commandPath?.length ?? 0);\n  if (!positionals.length) {\n    throw new CliExitError('Missing required argument: variable name', {\n      suggestion: 'Run `varlock printenv MY_VAR` to print the value of MY_VAR',\n    });\n  }\n  const varName = positionals[0];\n\n  const envGraph = await loadVarlockEnvGraph({\n    entryFilePath: ctx.values.path,\n  });\n  checkForSchemaErrors(envGraph);\n\n  if (!(varName in envGraph.configSchema)) {\n    throw new CliExitError(`Variable \"${varName}\" not found in schema`);\n  }\n\n  // Resolve only the requested item and its transitive dependencies\n  await envGraph.resolveItemWithDeps(varName);\n\n  const item = envGraph.configSchema[varName];\n  if (item.validationState === 'error') {\n    for (const err of item.errors) {\n      console.error(`🚨 ${err.message}`);\n    }\n    return gracefulExit(1);\n  }\n\n  const value = item.resolvedValue;\n  if (value === undefined || value === null) {\n    console.log('');\n  } else {\n    console.log(String(value));\n  }\n};\n"]}

package/dist/chunk-AKWP77PS.js

@@ -0,0 +1,387 @@
+import { spawnAsync } from './chunk-GGBNUVWR.js';
+import { detectJsPackageManager, logLines, fmt, installJsDependency } from './chunk-EBOBYFMY.js';
+import { define } from './chunk-4A54P4EM.js';
+import { gracefulExit } from './chunk-CHQDS2PI.js';
+import { envSpecUpdater, ParsedEnvSpecStaticValue, tryCatch, parseEnvSpecDotEnvFile, Jt, Ct, ansis_default, prompts_default, pathExists } from './chunk-G2GPGCAP.js';
+import { __name } from './chunk-6PEHRAEP.js';
+import path2, { dirname } from 'path';
+import fs3 from 'fs/promises';
+
+async function checkIsFileGitIgnored(path3, warnIfNotGitRepo = false) {
+  try {
+    await spawnAsync("git", ["check-ignore", path3, "-q"], { cwd: dirname(path3) });
+    return true;
+  } catch (err) {
+    const errorOutput = err.data;
+    if (err.exitCode === 127 || errorOutput.includes("not found") || errorOutput.includes("not recognized")) {
+      return void 0;
+    }
+    if (err.code === "ENOENT") return void 0;
+    if (errorOutput === "") return false;
+    if (errorOutput.includes("not a git repository")) {
+      if (warnIfNotGitRepo) {
+        console.log("\u{1F536} Your code is not currently in a git repository - run `git init` to initialize a new repo.");
+      }
+      return false;
+    }
+    if (errorOutput.includes("is outside repository")) {
+      return void 0;
+    }
+    throw err;
+  }
+}
+__name(checkIsFileGitIgnored, "checkIsFileGitIgnored");
+var PUBLIC_PREFIXES = [
+  "PUBLIC",
+  "VITE",
+  "NEXT_PUBLIC",
+  "NUXT_PUBLIC"
+];
+var PUBLIC_KEYWORDS = ["PUBLIC"];
+var SENSITIVE_KEYWORDS = [
+  "SECRET",
+  "API_KEY",
+  "PASSWORD",
+  "TOKEN",
+  "PRIVATE",
+  "CREDENTIALS"
+];
+function isValidUrl(val) {
+  try {
+    const u = new URL(val);
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+__name(isValidUrl, "isValidUrl");
+var EMAIL_REGEX = /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
+var VALID_NUMBER_REGEX = /^(0|([1-9][0-9]*))?(\.[0-9]+)?$/;
+function inferItemDecorators(file, itemKey, valueStr) {
+  let itemIsPublic = false;
+  if (PUBLIC_PREFIXES.some((prefix) => itemKey.startsWith(prefix))) itemIsPublic = true;
+  if (PUBLIC_KEYWORDS.some((keyword) => itemKey.includes(keyword))) itemIsPublic = true;
+  let itemIsSensitive = false;
+  if (SENSITIVE_KEYWORDS.some((keyword) => itemKey.includes(keyword))) itemIsSensitive = true;
+  if (itemIsPublic) ; else if (itemIsSensitive) {
+    envSpecUpdater.setItemDecorator(file, itemKey, "sensitive", "true");
+  }
+  if (itemKey === "PORT" || itemKey.endsWith("_PORT")) {
+    envSpecUpdater.setItemDecorator(file, itemKey, "type", "port");
+  } else if (itemKey.endsWith("_EMAIL")) {
+    envSpecUpdater.setItemDecorator(file, itemKey, "type", "email");
+  } else if (itemKey.endsWith("_URL") || itemKey.endsWith("_URI")) {
+    envSpecUpdater.setItemDecorator(file, itemKey, "type", "url");
+  } else if (valueStr) {
+    if (valueStr.startsWith("<") && valueStr.endsWith(">")) {
+      envSpecUpdater.setItemDecorator(file, itemKey, "example", valueStr);
+    }
+    if (valueStr === "true" || valueStr === "false") {
+      envSpecUpdater.setItemDecorator(file, itemKey, "type", "boolean");
+    } else if (EMAIL_REGEX.test(valueStr)) {
+      envSpecUpdater.setItemDecorator(file, itemKey, "type", "email");
+    } else if (valueStr !== "0" && valueStr !== "1" && VALID_NUMBER_REGEX.test(valueStr)) {
+      envSpecUpdater.setItemDecorator(file, itemKey, "type", "number");
+    } else if (isValidUrl(valueStr)) {
+      envSpecUpdater.setItemDecorator(file, itemKey, "type", "url");
+    }
+  }
+}
+__name(inferItemDecorators, "inferItemDecorators");
+function inferSchemaUpdates(file) {
+  for (const item of file.configItems) {
+    const valueStr = item.value instanceof ParsedEnvSpecStaticValue && item.value.value?.toString() || "";
+    inferItemDecorators(file, item.key, valueStr);
+  }
+}
+__name(inferSchemaUpdates, "inferSchemaUpdates");
+function ensureAllItemsExist(schemaFile, otherFiles) {
+  const addedItemKeys = [];
+  for (const otherFile of otherFiles) {
+    for (const item of otherFile.parsedFile.configItems) {
+      const itemInSchema = schemaFile.configItems.find((i) => i.key === item.key);
+      if (itemInSchema) continue;
+      if (addedItemKeys.length === 0) {
+        envSpecUpdater.injectFromStr(schemaFile, [
+          "",
+          "# items added to schema by `varlock init`",
+          "# that were missing in example, but detected in other .env files",
+          "# PLEASE REVIEW THESE!",
+          "# ---",
+          ""
+        ].join("\n"), { location: "end" });
+      }
+      addedItemKeys.push(item.key);
+      envSpecUpdater.injectFromStr(schemaFile, `${item.key}=`);
+      const itemValue = item.value instanceof ParsedEnvSpecStaticValue && item.value.value?.toString() || "";
+      inferItemDecorators(schemaFile, item.key, String(itemValue));
+    }
+  }
+}
+__name(ensureAllItemsExist, "ensureAllItemsExist");
+async function detectRedundantValues(schemaFile, otherFiles, opts = {}) {
+  const redundantItemsBySourcePath = {};
+  const schemaValues = schemaFile.toSimpleObj();
+  for (const otherFile of Object.values(otherFiles)) {
+    if (otherFile.fileName.startsWith(".env.schema") || otherFile.fileName.startsWith(".env.example") || otherFile.fileName.startsWith(".env.sample") || otherFile.fileName.startsWith(".env.default")) continue;
+    const otherFileValues = otherFile.parsedFile.toSimpleObj();
+    for (const itemKey in otherFileValues) {
+      if (!(itemKey in schemaValues)) continue;
+      if (otherFileValues[itemKey] !== schemaValues[itemKey]) continue;
+      redundantItemsBySourcePath[otherFile.fullPath] ||= [];
+      redundantItemsBySourcePath[otherFile.fullPath].push(itemKey);
+      if (opts.delete) {
+        envSpecUpdater.deleteItem(otherFile.parsedFile, itemKey);
+      }
+    }
+    if (opts.delete) {
+      await fs3.writeFile(otherFile.fullPath, otherFile.parsedFile.toString(), "utf8");
+    }
+  }
+  return redundantItemsBySourcePath;
+}
+__name(detectRedundantValues, "detectRedundantValues");
+var SKIP_FILE_TYPES = [".md", ".d.ts"];
+async function findEnvFiles(opts) {
+  const cwd = opts?.cwd || process.cwd();
+  const envFiles = [];
+  const filesWithinDir = await fs3.readdir(cwd);
+  for (const fileName of filesWithinDir) {
+    if (fileName === ".env" || fileName.startsWith(".env.")) {
+      let skip = false;
+      for (const fileType of SKIP_FILE_TYPES) {
+        if (fileName.endsWith(fileType)) skip = true;
+      }
+      if (skip) continue;
+      envFiles.push(path2.join(cwd, fileName));
+    }
+  }
+  return envFiles;
+}
+__name(findEnvFiles, "findEnvFiles");
+
+// src/cli/commands/init.command.ts
+var commandSpec = define({
+  name: "init",
+  description: "Set up varlock in the current project",
+  args: {},
+  examples: `
+This command starts an interactive onboarding process to help you get started with Varlock.
+It will:
+  - Scan for existing .env files in your project
+  - Help create a .env.schema file from your .env.example or .env.sample file
+  - Install varlock as a dependency in package.json (if applicable)
+
+\u{1F4CD} Run this command in directories that contain .env or .env.* files
+
+Examples:
+  varlock init                    # Run in the current directory
+  cd path/to/your/project && varlock init
+
+For more information, visit https://varlock.dev/getting-started/installation
+  `.trim()
+});
+var commandFn = /* @__PURE__ */ __name(async (ctx) => {
+  const jsPackageManager = detectJsPackageManager();
+  console.log("\u{1F9D9} Hello and welcome to Varlock \u{1F512}\u{1F525}\u2728");
+  const envFilePaths = await findEnvFiles();
+  const parsedEnvFiles = {};
+  for (const filePath of envFilePaths) {
+    const fileContents = await fs3.readFile(filePath, "utf-8");
+    const fileName = path2.basename(filePath);
+    const parsedFile = await tryCatch(async () => parseEnvSpecDotEnvFile(fileContents), () => {
+      logLines([
+        "",
+        `Unable to parse ${fmt.filePath(filePath)}`,
+        "This file will be skipped."
+      ]);
+    });
+    if (!parsedFile) {
+      continue;
+    }
+    parsedEnvFiles[fileName] = {
+      fileName,
+      fullPath: filePath,
+      parsedFile
+    };
+  }
+  const existingSchemaFile = parsedEnvFiles[".env.schema"];
+  if (existingSchemaFile) {
+    logLines([
+      `It looks like you already have a ${fmt.fileName(".env.schema")} file \u{1F389}`,
+      "This init helper is meant to help you get a new project set up.",
+      "If you need to make changes to your schema or values, you can update your files directly.",
+      "See more docs at https://varlock.dev/guides/schema"
+    ]);
+  } else {
+    const allExampleFileNames = Object.keys(parsedEnvFiles).filter((fileName) => {
+      return fileName.startsWith(".env.example") || fileName.startsWith(".env.sample");
+    });
+    let exampleFileToConvert;
+    if (allExampleFileNames.length === 1) {
+      exampleFileToConvert = parsedEnvFiles[allExampleFileNames[0]];
+    } else if (allExampleFileNames.length > 1) {
+      console.log("");
+      const selectedExample = await Jt({
+        message: `We detected more than one example .env file. Which one should we use to create your new ${fmt.fileName(".env.schema")}?`,
+        options: allExampleFileNames.map((fileName) => ({
+          label: fileName,
+          value: parsedEnvFiles[fileName]
+        }))
+      });
+      if (Ct(selectedExample)) return gracefulExit(0);
+      exampleFileToConvert = selectedExample;
+    }
+    const parsedEnvSchemaFile = exampleFileToConvert?.parsedFile || parseEnvSpecDotEnvFile("");
+    if (!parsedEnvSchemaFile) throw new Error("expected parsed .env example file");
+    envSpecUpdater.ensureHeader(parsedEnvSchemaFile, [
+      "This env file uses @env-spec - see https://varlock.dev/env-spec for more info",
+      ""
+      // TODO: add env spec version? real links?
+    ].join("\n"));
+    envSpecUpdater.setRootDecorator(parsedEnvSchemaFile, "defaultRequired", "infer", { explicitTrue: true });
+    envSpecUpdater.setRootDecorator(parsedEnvSchemaFile, "defaultSensitive", "false", { explicitTrue: true });
+    envSpecUpdater.setRootDecorator(parsedEnvSchemaFile, "generateTypes", "lang=ts, path=env.d.ts", { bareFnArgs: true });
+    envSpecUpdater.injectFromStr(parsedEnvSchemaFile, [
+      "",
+      "# example env variable injected by `varlock init` \u26A0\uFE0F DELETE THIS ITEM! \u26A0\uFE0F",
+      '# @required @sensitive @example="example value"',
+      'EXAMPLE_ITEM="delete me!"',
+      ""
+    ].join("\n"), { location: "after_header" });
+    inferSchemaUpdates(parsedEnvSchemaFile);
+    ensureAllItemsExist(parsedEnvSchemaFile, Object.values(parsedEnvFiles));
+    const schemaFilePath = path2.join(process.cwd(), ".env.schema");
+    await fs3.writeFile(schemaFilePath, parsedEnvSchemaFile.toString());
+    if (exampleFileToConvert) {
+      logLines([
+        "",
+        `Your ${fmt.fileName(exampleFileToConvert.fileName)} has been used to generate your new ${fmt.fileName(".env.schema")}:`,
+        fmt.filePath(schemaFilePath)
+      ]);
+    } else {
+      logLines([
+        "",
+        `Your new ${fmt.fileName(".env.schema")} file has been created:`,
+        fmt.filePath(schemaFilePath)
+      ]);
+    }
+    if (await checkIsFileGitIgnored(schemaFilePath)) {
+      logLines([ansis_default.dim(`(and updated ${fmt.fileName(".gitignore")} to ensure it will be tracked by git)`)]);
+      await fs3.appendFile(".gitignore", "\n!.env.schema");
+    }
+    logLines([
+      "",
+      ansis_default.bold(`\u{1F6A7} Please review and update your new ${fmt.fileName(".env.schema")} file! \u{1F6A7}`),
+      `We've done our best to get you started, but you must review and make sure it is correct!`,
+      "",
+      `\u{1F449} Some helpful pointers to get you started:`,
+      `- add a description to each item when the name is not self explanatory - it will come through in generated types`,
+      `- use ${fmt.decorator("@required")} (or ${fmt.decorator("@optional")}) to tag items that should fail validation when empty`,
+      `- use ${fmt.decorator("@sensitive")} to tag items that contain sensitive secrets, and must be handled accordingly`,
+      `- use ${fmt.decorator("@type")} to set an item's data type (if not a basic string), which affects validation and coercion logic`,
+      `- if an item value is a ${ansis_default.italic("useful example")} rather than a default, use ${fmt.decorator("@example")}`,
+      `- if an item value is just a dummy placeholder, delete it`
+    ]);
+    const confirmReviewed = await prompts_default.confirm({
+      message: `Have you reviewed and updated your new ${fmt.fileName(".env.schema")} file?`
+    });
+    if (Ct(confirmReviewed)) return gracefulExit(0);
+    const reloadedSchemaFile = await parseEnvSpecDotEnvFile(await fs3.readFile(schemaFilePath, "utf-8"));
+    if (reloadedSchemaFile.configItems.find((i) => i.key === "EXAMPLE_ITEM")) {
+      logLines([
+        "",
+        ansis_default.bold(`\u{1F6A8} Really? ${ansis_default.red("You didn't remove the EXAMPLE_ITEM!")}`),
+        `Please make sure your schema is all correct before using it...`
+      ]);
+    }
+    if (exampleFileToConvert) {
+      const confirmDeleteExample = await prompts_default.confirm({
+        message: `Should we delete your ${fmt.fileName(exampleFileToConvert.fileName)} file? ${ansis_default.italic.gray("(you can always do this yourself later)")}`
+      });
+      if (Ct(confirmDeleteExample)) return gracefulExit(0);
+      if (confirmDeleteExample) {
+        await fs3.unlink(exampleFileToConvert.fullPath);
+      }
+    }
+    const defaultsFile = Object.values(parsedEnvFiles).find((f) => {
+      return f.fileName.startsWith(".env.default");
+    });
+    if (defaultsFile) {
+      logLines([
+        "",
+        `\u{1F6A7} We detected a ${fmt.fileName(defaultsFile.fileName)} file in your project`,
+        `You should migrate these default values into ${fmt.fileName(".env.schema")} and delete it.`
+      ]);
+    }
+    const redundantInfo = await detectRedundantValues(parsedEnvSchemaFile, parsedEnvFiles);
+    if (Object.keys(redundantInfo).length > 0) {
+      logLines([
+        "",
+        ansis_default.bold("\u203C\uFE0F  Now that your schema contains defaults, some values in your other .env files are redundant:")
+      ]);
+      for (const [sourcePath, itemKeys] of Object.entries(redundantInfo)) {
+        console.log(fmt.filePath(sourcePath));
+        console.log("  ", itemKeys.map((k) => ansis_default.italic(k)).join(", "));
+      }
+      const confirmDeleteRedundant = await prompts_default.confirm({
+        message: "Should we delete these redundant values from your other .env files?"
+      });
+      if (Ct(confirmDeleteRedundant)) return gracefulExit(0);
+      if (confirmDeleteRedundant) {
+        await detectRedundantValues(parsedEnvSchemaFile, parsedEnvFiles, { delete: true });
+      }
+    }
+    logLines([
+      "",
+      ansis_default.bold("\u{1F389} Great!"),
+      `You can run ${fmt.command("varlock load", { jsPackageManager })} to attempt loading your env vars validate against your new schema.`,
+      "",
+      "Check out our docs for more info about integrating into your application.",
+      "",
+      "\u{1F4D6} https://varlock.dev \u{1F448}",
+      ""
+    ]);
+  }
+  if (jsPackageManager && await pathExists(path2.join(process.cwd(), "package.json"))) {
+    const installResult = installJsDependency({
+      packageManager: jsPackageManager.name,
+      packageName: "varlock"
+    });
+    if (installResult) {
+      logLines([
+        "",
+        `\u2705 Added ${fmt.packageName("varlock")} as a dependency in your package.json`
+      ]);
+    }
+  }
+  if (jsPackageManager?.name === "bun") {
+    const bunfigPath = path2.join(process.cwd(), "bunfig.toml");
+    const bunfigExists = await pathExists(bunfigPath);
+    if (bunfigExists) {
+      const bunfigContents = await fs3.readFile(bunfigPath, "utf-8");
+      if (!/^\s*env\s*=\s*false\s*$/m.test(bunfigContents)) {
+        await fs3.writeFile(bunfigPath, `env = false
+${bunfigContents}`);
+        logLines([
+          "",
+          `\u2705 Added ${ansis_default.bold("env = false")} to your existing ${fmt.fileName("bunfig.toml")}`,
+          ansis_default.dim("This disables Bun's automatic .env loading, which conflicts with Varlock."),
+          ansis_default.dim(`See ${ansis_default.underline("https://varlock.dev/integrations/bun")} for more info.`)
+        ]);
+      }
+    } else {
+      await fs3.writeFile(bunfigPath, "env = false\n");
+      logLines([
+        "",
+        `\u2705 Created ${fmt.fileName("bunfig.toml")} with ${ansis_default.bold("env = false")}`,
+        ansis_default.dim("This disables Bun's automatic .env loading, which conflicts with Varlock."),
+        ansis_default.dim(`See ${ansis_default.underline("https://varlock.dev/integrations/bun")} for more info.`)
+      ]);
+    }
+  }
+}, "commandFn");
+
+export { commandFn, commandSpec };
+//# sourceMappingURL=chunk-AKWP77PS.js.map
+//# sourceMappingURL=chunk-AKWP77PS.js.map