@nightintelligence/cloudflare-workers-utils 0.35.0-patch1

package/dist/local-env.d.mts

@@ -0,0 +1,54 @@
+type LocalEnvValueSource = {
+    type: "file";
+    path: string;
+} | {
+    type: "process";
+};
+interface LoadedEnv {
+    values: Record<string, string>;
+    sources: Record<string, LocalEnvValueSource>;
+}
+/**
+ * Returns the local `.env` candidates in increasing precedence order.
+ *
+ * @param envDir The resolved environment directory. `false` disables file
+ * loading, matching Vite's `envDir` convention.
+ * @param mode The optional mode used for mode-specific files.
+ * @returns Absolute candidate paths in load order.
+ */
+declare function getEnvPaths(envDir: string | false, mode?: string): string[];
+/**
+ * Returns the `.dev.vars` candidates in decreasing selection priority.
+ *
+ * @param envDir The resolved environment directory. `false` disables file
+ * loading, matching Vite's `envDir` convention.
+ * @param mode The optional mode used to select `.dev.vars.<mode>`.
+ * @returns Absolute candidate paths in selection order.
+ */
+declare function getDevVarsCandidatePaths(envDir: string | false, mode?: string): string[];
+/**
+ * Loads local `.env` files using Vite-compatible file precedence and
+ * Wrangler-compatible parsing and expansion.
+ *
+ * Expansion is progressive: references can use process values and values
+ * declared earlier in the merged environment, but not values declared later.
+ * Loading has no process-global side effects.
+ *
+ * @param envDir The resolved environment directory. `false` disables file
+ * loading, matching Vite's `envDir` convention.
+ * @param mode The optional mode used for mode-specific files.
+ * @returns Resolved values and metadata describing their sources.
+ */
+declare function loadEnv(envDir: string | false, mode?: string): Promise<LoadedEnv>;
+/**
+ * Loads the first existing `.dev.vars` candidate without merging it with other
+ * files or process-environment values.
+ *
+ * @param envDir The resolved environment directory. `false` disables file
+ * loading, matching Vite's `envDir` convention.
+ * @param mode The optional mode used to select `.dev.vars.<mode>`.
+ * @returns The selected `.dev.vars` values, or `undefined` when no candidate exists.
+ */
+declare function loadDevVars(envDir: string | false, mode?: string): Promise<Record<string, string> | undefined>;
+
+export { type LoadedEnv, type LocalEnvValueSource, getDevVarsCandidatePaths, getEnvPaths, loadDevVars, loadEnv };

package/dist/local-env.mjs

@@ -0,0 +1,178 @@
+import { __commonJS, __name, __toESM } from './chunk-6LYDFTTF.mjs';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { parse } from 'dotenv';
+
+// ../../node_modules/.pnpm/dotenv-expand@13.0.0/node_modules/dotenv-expand/lib/main.js
+var require_main = __commonJS({
+  "../../node_modules/.pnpm/dotenv-expand@13.0.0/node_modules/dotenv-expand/lib/main.js"(exports$1, module) {
+    function _resolveEscapeSequences(value) {
+      return value.replace(/\\\$/g, "$");
+    }
+    __name(_resolveEscapeSequences, "_resolveEscapeSequences");
+    function expandValue(value, processEnv, runningParsed) {
+      const env = { ...runningParsed, ...processEnv };
+      const regex = /(?<!\\)\${([^{}]+)}|(?<!\\)\$([A-Za-z_][A-Za-z0-9_]*)/g;
+      let result = value;
+      let match;
+      const seen = /* @__PURE__ */ new Set();
+      while ((match = regex.exec(result)) !== null) {
+        seen.add(result);
+        const [template, bracedExpression, unbracedExpression] = match;
+        const expression = bracedExpression || unbracedExpression;
+        const opRegex = /(:\+|\+|:-|-)/;
+        const opMatch = expression.match(opRegex);
+        const splitter = opMatch ? opMatch[0] : null;
+        const r = expression.split(splitter);
+        let defaultValue;
+        let value2;
+        const key = r.shift();
+        if ([":+", "+"].includes(splitter)) {
+          defaultValue = env[key] ? r.join(splitter) : "";
+          value2 = null;
+        } else {
+          defaultValue = r.join(splitter);
+          value2 = env[key];
+        }
+        if (value2) {
+          if (seen.has(value2)) {
+            result = result.replace(template, defaultValue);
+          } else {
+            result = result.replace(template, value2);
+          }
+        } else {
+          result = result.replace(template, defaultValue);
+        }
+        if (result === runningParsed[key]) {
+          break;
+        }
+        regex.lastIndex = 0;
+      }
+      return result;
+    }
+    __name(expandValue, "expandValue");
+    function expand2(options) {
+      const runningParsed = {};
+      let processEnv = process.env;
+      if (options && options.processEnv != null) {
+        processEnv = options.processEnv;
+      }
+      for (const key in options.parsed) {
+        let value = options.parsed[key];
+        if (processEnv[key] && processEnv[key] !== value) {
+          value = processEnv[key];
+        } else {
+          value = expandValue(value, processEnv, runningParsed);
+        }
+        options.parsed[key] = _resolveEscapeSequences(value);
+        runningParsed[key] = _resolveEscapeSequences(value);
+      }
+      for (const processKey in options.parsed) {
+        processEnv[processKey] = options.parsed[processKey];
+      }
+      return options;
+    }
+    __name(expand2, "expand");
+    module.exports.expand = expand2;
+  }
+});
+
+// src/local-env.ts
+var import_dotenv_expand = __toESM(require_main());
+function getEnvPaths(envDir, mode) {
+  if (envDir === false) {
+    return [];
+  }
+  const filenames = [
+    ".env",
+    ".env.local",
+    ...mode === void 0 ? [] : [`.env.${mode}`, `.env.${mode}.local`]
+  ];
+  return filenames.map((filename) => path.resolve(envDir, filename));
+}
+__name(getEnvPaths, "getEnvPaths");
+function getDevVarsCandidatePaths(envDir, mode) {
+  if (envDir === false) {
+    return [];
+  }
+  return [
+    ...mode === void 0 ? [] : [`.dev.vars.${mode}`],
+    ".dev.vars"
+  ].map((filename) => path.resolve(envDir, filename));
+}
+__name(getDevVarsCandidatePaths, "getDevVarsCandidatePaths");
+async function loadEnv(envDir, mode) {
+  if (mode === "local") {
+    throw new Error(
+      '"local" cannot be used as a mode name because it conflicts with the .local postfix for .env files.'
+    );
+  }
+  const candidateFiles = getEnvPaths(envDir, mode);
+  const parsed = {};
+  const parsedSources = {};
+  for (const candidate of candidateFiles) {
+    const loaded = await tryParseFile(candidate, parse);
+    if (loaded === void 0) {
+      continue;
+    }
+    for (const [key, value] of Object.entries(loaded.values)) {
+      parsed[key] = value;
+      parsedSources[key] = { type: "file", path: loaded.path };
+    }
+  }
+  const processEnv = copyProcessEnv();
+  (0, import_dotenv_expand.expand)({ parsed, processEnv: { ...processEnv } });
+  const values = { ...parsed };
+  const sources = { ...parsedSources };
+  for (const [key, value] of Object.entries(processEnv)) {
+    values[key] = value;
+    sources[key] = { type: "process" };
+  }
+  return { values, sources };
+}
+__name(loadEnv, "loadEnv");
+async function loadDevVars(envDir, mode) {
+  const candidateFiles = getDevVarsCandidatePaths(envDir, mode);
+  for (const candidate of candidateFiles) {
+    const loaded = await tryParseFile(candidate, parse);
+    if (loaded === void 0) {
+      continue;
+    }
+    return loaded.values;
+  }
+}
+__name(loadDevVars, "loadDevVars");
+async function tryParseFile(filePath, parse) {
+  try {
+    const stat2 = await fs.stat(filePath);
+    if (!stat2.isFile() && !stat2.isFIFO()) {
+      return;
+    }
+    return {
+      path: filePath,
+      values: parse(await fs.readFile(filePath, "utf8"))
+    };
+  } catch (error) {
+    if (isMissingFileError(error)) {
+      return;
+    }
+    throw error;
+  }
+}
+__name(tryParseFile, "tryParseFile");
+function isMissingFileError(error) {
+  return error instanceof Error && "code" in error && (error.code === "ENOENT" || error.code === "ENOTDIR");
+}
+__name(isMissingFileError, "isMissingFileError");
+function copyProcessEnv() {
+  return Object.fromEntries(
+    Object.entries(process.env).filter(
+      (entry) => entry[1] !== void 0
+    )
+  );
+}
+__name(copyProcessEnv, "copyProcessEnv");
+
+export { getDevVarsCandidatePaths, getEnvPaths, loadDevVars, loadEnv };
+//# sourceMappingURL=local-env.mjs.map
+//# sourceMappingURL=local-env.mjs.map

package/dist/local-env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../node_modules/.pnpm/dotenv-expand@13.0.0/node_modules/dotenv-expand/lib/main.js","../src/local-env.ts"],"names":["exports","value","expand","parseDotEnv","stat"],"mappings":";;;;;;AAAA,IAAA,YAAA,GAAA,UAAA,CAAA;AAAA,EAAA,sFAAA,CAAAA,SAAA,EAAA,MAAA,EAAA;AAEA,IAAA,SAAS,wBAAyB,KAAA,EAAO;AACvC,MAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,OAAA,EAAS,GAAG,CAAA;AAAA,IACnC;AAFS,IAAA,MAAA,CAAA,uBAAA,EAAA,yBAAA,CAAA;AAIT,IAAA,SAAS,WAAA,CAAa,KAAA,EAAO,UAAA,EAAY,aAAA,EAAe;AACtD,MAAA,MAAM,GAAA,GAAM,EAAE,GAAG,aAAA,EAAe,GAAG,UAAA,EAAW;AAE9C,MAAA,MAAM,KAAA,GAAQ,wDAAA;AAEd,MAAA,IAAI,MAAA,GAAS,KAAA;AACb,MAAA,IAAI,KAAA;AACJ,MAAA,MAAM,IAAA,uBAAW,GAAA,EAAI;AAErB,MAAA,OAAA,CAAQ,KAAA,GAAQ,KAAA,CAAM,IAAA,CAAK,MAAM,OAAO,IAAA,EAAM;AAC5C,QAAA,IAAA,CAAK,IAAI,MAAM,CAAA;AAEf,QAAA,MAAM,CAAC,QAAA,EAAU,gBAAA,EAAkB,kBAAkB,CAAA,GAAI,KAAA;AACzD,QAAA,MAAM,aAAa,gBAAA,IAAoB,kBAAA;AAGvC,QAAA,MAAM,OAAA,GAAU,eAAA;AAEhB,QAAA,MAAM,OAAA,GAAU,UAAA,CAAW,KAAA,CAAM,OAAO,CAAA;AACxC,QAAA,MAAM,QAAA,GAAW,OAAA,GAAU,OAAA,CAAQ,CAAC,CAAA,GAAI,IAAA;AAExC,QAAA,MAAM,CAAA,GAAI,UAAA,CAAW,KAAA,CAAM,QAAQ,CAAA;AAEnC,QAAA,IAAI,YAAA;AACJ,QAAA,IAAIC,MAAAA;AAEJ,QAAA,MAAM,GAAA,GAAM,EAAE,KAAA,EAAM;AAEpB,QAAA,IAAI,CAAC,IAAA,EAAM,GAAG,CAAA,CAAE,QAAA,CAAS,QAAQ,CAAA,EAAG;AAClC,UAAA,YAAA,GAAe,IAAI,GAAG,CAAA,GAAI,CAAA,CAAE,IAAA,CAAK,QAAQ,CAAA,GAAI,EAAA;AAC7C,UAAAA,MAAAA,GAAQ,IAAA;AAAA,QACV,CAAA,MAAO;AACL,UAAA,YAAA,GAAe,CAAA,CAAE,KAAK,QAAQ,CAAA;AAC9B,UAAAA,MAAAA,GAAQ,IAAI,GAAG,CAAA;AAAA,QACjB;AAEA,QAAA,IAAIA,MAAAA,EAAO;AAET,UAAA,IAAI,IAAA,CAAK,GAAA,CAAIA,MAAK,CAAA,EAAG;AACnB,YAAA,MAAA,GAAS,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,YAAY,CAAA;AAAA,UAChD,CAAA,MAAO;AACL,YAAA,MAAA,GAAS,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAUA,MAAK,CAAA;AAAA,UACzC;AAAA,QACF,CAAA,MAAO;AACL,UAAA,MAAA,GAAS,MAAA,CAAO,OAAA,CAAQ,QAAA,EAAU,YAAY,CAAA;AAAA,QAChD;AAGA,QAAA,IAAI,MAAA,KAAW,aAAA,CAAc,GAAG,CAAA,EAAG;AACjC,UAAA;AAAA,QACF;AAEA,QAAA,KAAA,CAAM,SAAA,GAAY,CAAA;AAAA,MACpB;AAEA,MAAA,OAAO,MAAA;AAAA,IACT;AAxDS,IAAA,MAAA,CAAA,WAAA,EAAA,aAAA,CAAA;AA0DT,IAAA,SAASC,QAAQ,OAAA,EAAS;AAExB,MAAA,MAAM,gBAAgB,EAAC;AAEvB,MAAA,IAAI,aAAa,OAAA,CAAQ,GAAA;AACzB,MAAA,IAAI,OAAA,IAAW,OAAA,CAAQ,UAAA,IAAc,IAAA,EAAM;AACzC,QAAA,UAAA,GAAa,OAAA,CAAQ,UAAA;AAAA,MACvB;AAGA,MAAA,KAAA,MAAW,GAAA,IAAO,QAAQ,MAAA,EAAQ;AAChC,QAAA,IAAI,KAAA,GAAQ,OAAA,CAAQ,MAAA,CAAO,GAAG,CAAA;AAG9B,QAAA,IAAI,WAAW,GAAG,CAAA,IAAK,UAAA,CAAW,GAAG,MAAM,KAAA,EAAO;AAChD,UAAA,KAAA,GAAQ,WAAW,GAAG,CAAA;AAAA,QACxB,CAAA,MAAO;AACL,UAAA,KAAA,GAAQ,WAAA,CAAY,KAAA,EAAO,UAAA,EAAY,aAAa,CAAA;AAAA,QACtD;AAEA,QAAA,OAAA,CAAQ,MAAA,CAAO,GAAG,CAAA,GAAI,uBAAA,CAAwB,KAAK,CAAA;AAGnD,QAAA,aAAA,CAAc,GAAG,CAAA,GAAI,uBAAA,CAAwB,KAAK,CAAA;AAAA,MACpD;AAEA,MAAA,KAAA,MAAW,UAAA,IAAc,QAAQ,MAAA,EAAQ;AACvC,QAAA,UAAA,CAAW,UAAU,CAAA,GAAI,OAAA,CAAQ,MAAA,CAAO,UAAU,CAAA;AAAA,MACpD;AAEA,MAAA,OAAO,OAAA;AAAA,IACT;AA/BS,IAAA,MAAA,CAAAA,OAAAA,EAAA,QAAA,CAAA;AAiCT,IAAA,MAAA,CAAO,QAAQ,MAAA,GAASA,OAAAA;AAAA,EAAA;AAAA,CAAA,CAAA;;;AC9FxB,IAAA,oBAAA,GAAuB,OAAA,CAAA,YAAA,EAAA,CAAA;AAwBhB,SAAS,WAAA,CAAY,QAAwB,IAAA,EAAyB;AAC5E,EAAA,IAAI,WAAW,KAAA,EAAO;AACrB,IAAA,OAAO,EAAC;AAAA,EACT;AAEA,EAAA,MAAM,SAAA,GAAY;AAAA,IACjB,MAAA;AAAA,IACA,YAAA;AAAA,IACA,GAAI,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,CAAC,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAA,EAAI,CAAA,KAAA,EAAQ,IAAI,CAAA,MAAA,CAAQ;AAAA,GACpE;AACA,EAAA,OAAO,UAAU,GAAA,CAAI,CAAC,aAAkB,IAAA,CAAA,OAAA,CAAQ,MAAA,EAAQ,QAAQ,CAAC,CAAA;AAClE;AAXgB,MAAA,CAAA,WAAA,EAAA,aAAA,CAAA;AAqBT,SAAS,wBAAA,CACf,QACA,IAAA,EACW;AACX,EAAA,IAAI,WAAW,KAAA,EAAO;AACrB,IAAA,OAAO,EAAC;AAAA,EACT;AAEA,EAAA,OAAO;AAAA,IACN,GAAI,SAAS,MAAA,GAAY,KAAK,CAAC,CAAA,UAAA,EAAa,IAAI,CAAA,CAAE,CAAA;AAAA,IAClD;AAAA,IACC,GAAA,CAAI,CAAC,aAAkB,IAAA,CAAA,OAAA,CAAQ,MAAA,EAAQ,QAAQ,CAAC,CAAA;AACnD;AAZgB,MAAA,CAAA,wBAAA,EAAA,0BAAA,CAAA;AA2BhB,eAAsB,OAAA,CACrB,QACA,IAAA,EACqB;AACrB,EAAA,IAAI,SAAS,OAAA,EAAS;AACrB,IAAA,MAAM,IAAI,KAAA;AAAA,MACT;AAAA,KACD;AAAA,EACD;AAEA,EAAA,MAAM,cAAA,GAAiB,WAAA,CAAY,MAAA,EAAQ,IAAI,CAAA;AAC/C,EAAA,MAAM,SAAiC,EAAC;AACxC,EAAA,MAAM,gBAAqD,EAAC;AAE5D,EAAA,KAAA,MAAW,aAAa,cAAA,EAAgB;AACvC,IAAA,MAAM,MAAA,GAAS,MAAM,YAAA,CAAa,SAAA,EAAWC,KAAW,CAAA;AACxD,IAAA,IAAI,WAAW,MAAA,EAAW;AACzB,MAAA;AAAA,IACD;AAEA,IAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,MAAM,CAAA,EAAG;AACzD,MAAA,MAAA,CAAO,GAAG,CAAA,GAAI,KAAA;AACd,MAAA,aAAA,CAAc,GAAG,CAAA,GAAI,EAAE,MAAM,MAAA,EAAQ,IAAA,EAAM,OAAO,IAAA,EAAK;AAAA,IACxD;AAAA,EACD;AAEA,EAAA,MAAM,aAAa,cAAA,EAAe;AAClC,EAAA,IAAA,oBAAA,CAAA,MAAA,EAAO,EAAE,MAAA,EAAQ,UAAA,EAAY,EAAE,GAAG,UAAA,IAAc,CAAA;AAEhD,EAAA,MAAM,MAAA,GAAS,EAAE,GAAG,MAAA,EAAO;AAC3B,EAAA,MAAM,OAAA,GAAU,EAAE,GAAG,aAAA,EAAc;AAEnC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,KAAK,KAAK,MAAA,CAAO,OAAA,CAAQ,UAAU,CAAA,EAAG;AACtD,IAAA,MAAA,CAAO,GAAG,CAAA,GAAI,KAAA;AACd,IAAA,OAAA,CAAQ,GAAG,CAAA,GAAI,EAAE,IAAA,EAAM,SAAA,EAAU;AAAA,EAClC;AAEA,EAAA,OAAO,EAAE,QAAQ,OAAA,EAAQ;AAC1B;AAtCsB,MAAA,CAAA,OAAA,EAAA,SAAA,CAAA;AAiDtB,eAAsB,WAAA,CACrB,QACA,IAAA,EAC8C;AAC9C,EAAA,MAAM,cAAA,GAAiB,wBAAA,CAAyB,MAAA,EAAQ,IAAI,CAAA;AAC5D,EAAA,KAAA,MAAW,aAAa,cAAA,EAAgB;AACvC,IAAA,MAAM,MAAA,GAAS,MAAM,YAAA,CAAa,SAAA,EAAWA,KAAW,CAAA;AACxD,IAAA,IAAI,WAAW,MAAA,EAAW;AACzB,MAAA;AAAA,IACD;AAEA,IAAA,OAAO,MAAA,CAAO,MAAA;AAAA,EACf;AACD;AAbsB,MAAA,CAAA,WAAA,EAAA,aAAA,CAAA;AAetB,eAAe,YAAA,CACd,UACA,KAAA,EACkC;AAClC,EAAA,IAAI;AACH,IAAA,MAAMC,KAAAA,GAAO,MAAS,EAAA,CAAA,IAAA,CAAK,QAAQ,CAAA;AACnC,IAAA,IAAI,CAACA,KAAAA,CAAK,MAAA,MAAY,CAACA,KAAAA,CAAK,QAAO,EAAG;AACrC,MAAA;AAAA,IACD;AACA,IAAA,OAAO;AAAA,MACN,IAAA,EAAM,QAAA;AAAA,MACN,QAAQ,KAAA,CAAM,MAAS,EAAA,CAAA,QAAA,CAAS,QAAA,EAAU,MAAM,CAAC;AAAA,KAClD;AAAA,EACD,SAAS,KAAA,EAAO;AACf,IAAA,IAAI,kBAAA,CAAmB,KAAK,CAAA,EAAG;AAC9B,MAAA;AAAA,IACD;AACA,IAAA,MAAM,KAAA;AAAA,EACP;AACD;AAnBe,MAAA,CAAA,YAAA,EAAA,cAAA,CAAA;AAqBf,SAAS,mBAAmB,KAAA,EAAyB;AACpD,EAAA,OACC,KAAA,YAAiB,SACjB,MAAA,IAAU,KAAA,KACT,MAAM,IAAA,KAAS,QAAA,IAAY,MAAM,IAAA,KAAS,SAAA,CAAA;AAE7C;AANS,MAAA,CAAA,kBAAA,EAAA,oBAAA,CAAA;AAQT,SAAS,cAAA,GAAyC;AACjD,EAAA,OAAO,MAAA,CAAO,WAAA;AAAA,IACb,MAAA,CAAO,OAAA,CAAQ,OAAA,CAAQ,GAAG,CAAA,CAAE,MAAA;AAAA,MAC3B,CAAC,KAAA,KAAqC,KAAA,CAAM,CAAC,CAAA,KAAM;AAAA;AACpD,GACD;AACD;AANS,MAAA,CAAA,cAAA,EAAA,gBAAA,CAAA","file":"local-env.mjs","sourcesContent":["'use strict'\n\nfunction _resolveEscapeSequences (value) {\n  return value.replace(/\\\\\\$/g, '$')\n}\n\nfunction expandValue (value, processEnv, runningParsed) {\n  const env = { ...runningParsed, ...processEnv } // process.env wins\n\n  const regex = /(?<!\\\\)\\${([^{}]+)}|(?<!\\\\)\\$([A-Za-z_][A-Za-z0-9_]*)/g\n\n  let result = value\n  let match\n  const seen = new Set() // self-referential checker\n\n  while ((match = regex.exec(result)) !== null) {\n    seen.add(result)\n\n    const [template, bracedExpression, unbracedExpression] = match\n    const expression = bracedExpression || unbracedExpression\n\n    // match the operators `:+`, `+`, `:-`, and `-`\n    const opRegex = /(:\\+|\\+|:-|-)/\n    // find first match\n    const opMatch = expression.match(opRegex)\n    const splitter = opMatch ? opMatch[0] : null\n\n    const r = expression.split(splitter)\n\n    let defaultValue\n    let value\n\n    const key = r.shift()\n\n    if ([':+', '+'].includes(splitter)) {\n      defaultValue = env[key] ? r.join(splitter) : ''\n      value = null\n    } else {\n      defaultValue = r.join(splitter)\n      value = env[key]\n    }\n\n    if (value) {\n      // self-referential check\n      if (seen.has(value)) {\n        result = result.replace(template, defaultValue)\n      } else {\n        result = result.replace(template, value)\n      }\n    } else {\n      result = result.replace(template, defaultValue)\n    }\n\n    // if the result equaled what was in process.env and runningParsed then stop expanding\n    if (result === runningParsed[key]) {\n      break\n    }\n\n    regex.lastIndex = 0 // reset regex search position to re-evaluate after each replacement\n  }\n\n  return result\n}\n\nfunction expand (options) {\n  // for use with progressive expansion\n  const runningParsed = {}\n\n  let processEnv = process.env\n  if (options && options.processEnv != null) {\n    processEnv = options.processEnv\n  }\n\n  // dotenv.config() ran before this so the assumption is process.env has already been set\n  for (const key in options.parsed) {\n    let value = options.parsed[key]\n\n    // short-circuit scenario: process.env was already set prior to the file value\n    if (processEnv[key] && processEnv[key] !== value) {\n      value = processEnv[key]\n    } else {\n      value = expandValue(value, processEnv, runningParsed)\n    }\n\n    options.parsed[key] = _resolveEscapeSequences(value)\n\n    // for use with progressive expansion\n    runningParsed[key] = _resolveEscapeSequences(value)\n  }\n\n  for (const processKey in options.parsed) {\n    processEnv[processKey] = options.parsed[processKey]\n  }\n\n  return options\n}\n\nmodule.exports.expand = expand\n","import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport { parse as parseDotEnv } from \"dotenv\";\nimport { expand } from \"dotenv-expand\";\n\nexport type LocalEnvValueSource =\n\t| { type: \"file\"; path: string }\n\t| { type: \"process\" };\n\nexport interface LoadedEnv {\n\tvalues: Record<string, string>;\n\tsources: Record<string, LocalEnvValueSource>;\n}\n\ninterface ParsedFile {\n\tpath: string;\n\tvalues: Record<string, string>;\n}\n\n/**\n * Returns the local `.env` candidates in increasing precedence order.\n *\n * @param envDir The resolved environment directory. `false` disables file\n * loading, matching Vite's `envDir` convention.\n * @param mode The optional mode used for mode-specific files.\n * @returns Absolute candidate paths in load order.\n */\nexport function getEnvPaths(envDir: string | false, mode?: string): string[] {\n\tif (envDir === false) {\n\t\treturn [];\n\t}\n\n\tconst filenames = [\n\t\t\".env\",\n\t\t\".env.local\",\n\t\t...(mode === undefined ? [] : [`.env.${mode}`, `.env.${mode}.local`]),\n\t];\n\treturn filenames.map((filename) => path.resolve(envDir, filename));\n}\n\n/**\n * Returns the `.dev.vars` candidates in decreasing selection priority.\n *\n * @param envDir The resolved environment directory. `false` disables file\n * loading, matching Vite's `envDir` convention.\n * @param mode The optional mode used to select `.dev.vars.<mode>`.\n * @returns Absolute candidate paths in selection order.\n */\nexport function getDevVarsCandidatePaths(\n\tenvDir: string | false,\n\tmode?: string\n): string[] {\n\tif (envDir === false) {\n\t\treturn [];\n\t}\n\n\treturn [\n\t\t...(mode === undefined ? [] : [`.dev.vars.${mode}`]),\n\t\t\".dev.vars\",\n\t].map((filename) => path.resolve(envDir, filename));\n}\n\n/**\n * Loads local `.env` files using Vite-compatible file precedence and\n * Wrangler-compatible parsing and expansion.\n *\n * Expansion is progressive: references can use process values and values\n * declared earlier in the merged environment, but not values declared later.\n * Loading has no process-global side effects.\n *\n * @param envDir The resolved environment directory. `false` disables file\n * loading, matching Vite's `envDir` convention.\n * @param mode The optional mode used for mode-specific files.\n * @returns Resolved values and metadata describing their sources.\n */\nexport async function loadEnv(\n\tenvDir: string | false,\n\tmode?: string\n): Promise<LoadedEnv> {\n\tif (mode === \"local\") {\n\t\tthrow new Error(\n\t\t\t'\"local\" cannot be used as a mode name because it conflicts with the .local postfix for .env files.'\n\t\t);\n\t}\n\n\tconst candidateFiles = getEnvPaths(envDir, mode);\n\tconst parsed: Record<string, string> = {};\n\tconst parsedSources: Record<string, LocalEnvValueSource> = {};\n\n\tfor (const candidate of candidateFiles) {\n\t\tconst loaded = await tryParseFile(candidate, parseDotEnv);\n\t\tif (loaded === undefined) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const [key, value] of Object.entries(loaded.values)) {\n\t\t\tparsed[key] = value;\n\t\t\tparsedSources[key] = { type: \"file\", path: loaded.path };\n\t\t}\n\t}\n\n\tconst processEnv = copyProcessEnv();\n\texpand({ parsed, processEnv: { ...processEnv } });\n\n\tconst values = { ...parsed };\n\tconst sources = { ...parsedSources };\n\n\tfor (const [key, value] of Object.entries(processEnv)) {\n\t\tvalues[key] = value;\n\t\tsources[key] = { type: \"process\" };\n\t}\n\n\treturn { values, sources };\n}\n\n/**\n * Loads the first existing `.dev.vars` candidate without merging it with other\n * files or process-environment values.\n *\n * @param envDir The resolved environment directory. `false` disables file\n * loading, matching Vite's `envDir` convention.\n * @param mode The optional mode used to select `.dev.vars.<mode>`.\n * @returns The selected `.dev.vars` values, or `undefined` when no candidate exists.\n */\nexport async function loadDevVars(\n\tenvDir: string | false,\n\tmode?: string\n): Promise<Record<string, string> | undefined> {\n\tconst candidateFiles = getDevVarsCandidatePaths(envDir, mode);\n\tfor (const candidate of candidateFiles) {\n\t\tconst loaded = await tryParseFile(candidate, parseDotEnv);\n\t\tif (loaded === undefined) {\n\t\t\tcontinue;\n\t\t}\n\n\t\treturn loaded.values;\n\t}\n}\n\nasync function tryParseFile(\n\tfilePath: string,\n\tparse: (contents: string) => Record<string, string>\n): Promise<ParsedFile | undefined> {\n\ttry {\n\t\tconst stat = await fs.stat(filePath);\n\t\tif (!stat.isFile() && !stat.isFIFO()) {\n\t\t\treturn;\n\t\t}\n\t\treturn {\n\t\t\tpath: filePath,\n\t\t\tvalues: parse(await fs.readFile(filePath, \"utf8\")),\n\t\t};\n\t} catch (error) {\n\t\tif (isMissingFileError(error)) {\n\t\t\treturn;\n\t\t}\n\t\tthrow error;\n\t}\n}\n\nfunction isMissingFileError(error: unknown): boolean {\n\treturn (\n\t\terror instanceof Error &&\n\t\t\"code\" in error &&\n\t\t(error.code === \"ENOENT\" || error.code === \"ENOTDIR\")\n\t);\n}\n\nfunction copyProcessEnv(): Record<string, string> {\n\treturn Object.fromEntries(\n\t\tObject.entries(process.env).filter(\n\t\t\t(entry): entry is [string, string] => entry[1] !== undefined\n\t\t)\n\t);\n}\n"]}