@cloudflare/workers-utils 0.24.0 → 0.25.1

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { T as TailConsumer, aE as WorkerMetadata, R as RawConfig } from './config-8UymS5SL.mjs';
+import { T as TailConsumer, aK as WorkerMetadata, R as RawConfig } from './config-B_-PmLum.mjs';
 import { AssetConfig } from '@cloudflare/workers-shared';
 import { Cloudflare } from 'cloudflare';
 import 'node:url';

package/dist/browser.mjs

@@ -1,2 +1,2 @@
-export { constructWranglerConfig } from './chunk-J6D57QVQ.mjs';
-import './chunk-DCOBXSFB.mjs';
+export { constructWranglerConfig } from './chunk-ELQRF72O.mjs';
+import './chunk-DDRU76YD.mjs';

package/dist/{chunk-ULVYGN52.mjs → chunk-27EBTAT2.mjs}

@@ -1,7 +1,23 @@
-import { __name } from './chunk-DCOBXSFB.mjs';
-import fs, { readFileSync as readFileSync$1, statSync, existsSync } from 'node:fs';
+import { __name } from './chunk-DDRU76YD.mjs';
+import { readFileSync as readFileSync$1, statSync, existsSync } from 'node:fs';
 import path, { resolve, isAbsolute, dirname, join } from 'node:path';
 
+// src/config/exports.ts
+function partitionExports(exports) {
+  const partitioned = {
+    "durable-object": {},
+    worker: {}
+  };
+  if (exports === void 0) {
+    return partitioned;
+  }
+  for (const [name, entry] of Object.entries(exports)) {
+    partitioned[entry.type][name] = entry;
+  }
+  return partitioned;
+}
+__name(partitionExports, "partitionExports");
+
 // src/errors.ts
 var UserError = class extends Error {
   static {
@@ -2360,6 +2376,12 @@ var APIError = class extends ParseError {
   #status;
   code;
   accountTag;
+  /**
+   * Optional structured metadata hoisted from the first `FetchError.meta`
+   * on the v4 response envelope. Consumers can inspect this to render
+   * endpoint-specific structured error payloads.
+   */
+  meta;
   constructor({ status, ...rest }) {
     super(rest);
     this.name = this.constructor.name;
@@ -2893,34 +2915,6 @@ var experimental_readRawConfig = /* @__PURE__ */ __name((args, options = {}) =>
     redirected
   };
 }, "experimental_readRawConfig");
-function isDirectory(path2) {
-  return fs.statSync(path2, { throwIfNoEntry: false })?.isDirectory() ?? false;
-}
-__name(isDirectory, "isDirectory");
-function removeDir(dirPath, { fireAndForget = false } = {}) {
-  const result = fs.promises.rm(dirPath, {
-    recursive: true,
-    force: true,
-    maxRetries: 5,
-    retryDelay: 100
-  });
-  if (fireAndForget) {
-    void result.catch(() => {
-    });
-  } else {
-    return result;
-  }
-}
-__name(removeDir, "removeDir");
-function removeDirSync(dirPath) {
-  fs.rmSync(dirPath, {
-    recursive: true,
-    force: true,
-    maxRetries: 5,
-    retryDelay: 100
-  });
-}
-__name(removeDirSync, "removeDirSync");
 /*! Bundled license information:
 
 smol-toml/dist/error.js:
@@ -3185,4 +3179,4 @@ smol-toml/dist/index.js:
    *)
 */
 
-export { APIError, CommandLineArgsError, DeprecationError, ENVIRONMENT_TAG_PREFIX, FatalError, INHERIT_SYMBOL, JSON_CONFIG_FORMATS, JsonFriendlyFatalError, MissingConfigError, PATH_TO_DEPLOY_CONFIG, ParseError, SERVICE_TAG_PREFIX, UserError, applyEdits, configFileName, configFormat, createFatalError, dedent, dist_default, experimental_readRawConfig, findWranglerConfig, format2 as format, formatConfigSnippet, indexLocation, isDirectory, isRedirectedConfig, isRedirectedRawConfig, modify, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation };
+export { APIError, CommandLineArgsError, DeprecationError, ENVIRONMENT_TAG_PREFIX, FatalError, INHERIT_SYMBOL, JSON_CONFIG_FORMATS, JsonFriendlyFatalError, MissingConfigError, PATH_TO_DEPLOY_CONFIG, ParseError, SERVICE_TAG_PREFIX, UserError, applyEdits, configFileName, configFormat, createFatalError, dedent, dist_default, experimental_readRawConfig, findWranglerConfig, format2 as format, formatConfigSnippet, indexLocation, isRedirectedConfig, isRedirectedRawConfig, modify, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveWranglerConfigPath, searchLocation };

package/dist/{chunk-DCOBXSFB.mjs → chunk-DDRU76YD.mjs}

@@ -14,10 +14,6 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 var __commonJS = (cb, mod) => function __require2() {
   return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -26,7 +22,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
   // If the importer is in node compatibility mode or this is not an ESM
   // file that has been converted to a CommonJS file using a Babel-
@@ -36,4 +31,4 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-export { __commonJS, __export, __name, __reExport, __require, __toESM };
+export { __commonJS, __name, __require, __toESM };

package/dist/{chunk-J6D57QVQ.mjs → chunk-ELQRF72O.mjs}

@@ -1,4 +1,4 @@
-import { __name } from './chunk-DCOBXSFB.mjs';
+import { __name } from './chunk-DDRU76YD.mjs';
 import assert from 'node:assert';
 
 function isCompatDate(str) {

package/dist/chunk-OC543JY3.mjs

@@ -0,0 +1,33 @@
+import { __name } from './chunk-DDRU76YD.mjs';
+import fs from 'node:fs';
+
+function isDirectory(path) {
+  return fs.statSync(path, { throwIfNoEntry: false })?.isDirectory() ?? false;
+}
+__name(isDirectory, "isDirectory");
+function removeDir(dirPath, { fireAndForget = false } = {}) {
+  const result = fs.promises.rm(dirPath, {
+    recursive: true,
+    force: true,
+    maxRetries: 5,
+    retryDelay: 100
+  });
+  if (fireAndForget) {
+    void result.catch(() => {
+    });
+  } else {
+    return result;
+  }
+}
+__name(removeDir, "removeDir");
+function removeDirSync(dirPath) {
+  fs.rmSync(dirPath, {
+    recursive: true,
+    force: true,
+    maxRetries: 5,
+    retryDelay: 100
+  });
+}
+__name(removeDirSync, "removeDirSync");
+
+export { isDirectory, removeDir, removeDirSync };

package/dist/chunk-OTBYAUQ6.mjs

@@ -0,0 +1,155 @@
+import { isDirectory } from './chunk-OC543JY3.mjs';
+import { __name } from './chunk-DDRU76YD.mjs';
+import os from 'node:os';
+import path from 'node:path';
+
+function isWindows() {
+  return /^win/i.test(process.platform);
+}
+__name(isWindows, "isWindows");
+function isMacOS() {
+  return /^darwin$/i.test(process.platform);
+}
+__name(isMacOS, "isMacOS");
+function isNonEmpty(value) {
+  return !!value;
+}
+__name(isNonEmpty, "isNonEmpty");
+function getEnv(name) {
+  return process.env[name];
+}
+__name(getEnv, "getEnv");
+function normalizePath(p) {
+  return p ? path.normalize(path.join(p, ".")) : void 0;
+}
+__name(normalizePath, "normalizePath");
+function homeDir() {
+  if (isWindows()) {
+    const priorityList = [
+      os.homedir(),
+      getEnv("USERPROFILE"),
+      getEnv("HOME"),
+      // NOTE: `os-paths@7` uses `||` here (not `&&`), so a home directory is
+      // derived even when only one of HOMEDRIVE/HOMEPATH is set. This is
+      // preserved deliberately for byte-for-byte parity — see the parity
+      // tests, which compare this branch against the real package.
+      getEnv("HOMEDRIVE") || getEnv("HOMEPATH") ? path.join(getEnv("HOMEDRIVE") ?? "", getEnv("HOMEPATH") ?? "") : void 0
+    ];
+    return normalizePath(priorityList.find(isNonEmpty));
+  }
+  return normalizePath(os.homedir() || getEnv("HOME"));
+}
+__name(homeDir, "homeDir");
+function joinToBase(base, segments) {
+  return base ? path.join(base, ...segments) : void 0;
+}
+__name(joinToBase, "joinToBase");
+function tempDir() {
+  if (isWindows()) {
+    const fallback2 = "C:\\Temp";
+    const priorityListLazy = [
+      () => os.tmpdir(),
+      () => getEnv("TEMP"),
+      () => getEnv("TMP"),
+      () => joinToBase(getEnv("LOCALAPPDATA"), ["Temp"]),
+      () => joinToBase(homeDir(), ["AppData", "Local", "Temp"]),
+      () => joinToBase(getEnv("ALLUSERSPROFILE"), ["Temp"]),
+      () => joinToBase(getEnv("SystemRoot"), ["Temp"]),
+      () => joinToBase(getEnv("windir"), ["Temp"]),
+      () => joinToBase(getEnv("SystemDrive"), ["\\", "Temp"])
+    ];
+    const found = priorityListLazy.find((fn) => isNonEmpty(fn()));
+    return found && normalizePath(found()) || fallback2;
+  }
+  const fallback = "/tmp";
+  const priorityList = [
+    os.tmpdir(),
+    getEnv("TMPDIR"),
+    getEnv("TEMP"),
+    getEnv("TMP")
+  ];
+  return normalizePath(priorityList.find(isNonEmpty)) || fallback;
+}
+__name(tempDir, "tempDir");
+function baseDir() {
+  return homeDir() || tempDir();
+}
+__name(baseDir, "baseDir");
+function valOrPath(value, segments) {
+  return value || path.join(...segments);
+}
+__name(valOrPath, "valOrPath");
+function windowsAppData() {
+  return valOrPath(getEnv("APPDATA"), [baseDir(), "AppData", "Roaming"]);
+}
+__name(windowsAppData, "windowsAppData");
+function windowsLocalAppData() {
+  return valOrPath(getEnv("LOCALAPPDATA"), [baseDir(), "AppData", "Local"]);
+}
+__name(windowsLocalAppData, "windowsLocalAppData");
+function xdgConfig() {
+  if (isMacOS()) {
+    return valOrPath(getEnv("XDG_CONFIG_HOME"), [
+      baseDir(),
+      "Library",
+      "Preferences"
+    ]);
+  }
+  if (isWindows()) {
+    return valOrPath(getEnv("XDG_CONFIG_HOME"), [
+      windowsAppData(),
+      "xdg.config"
+    ]);
+  }
+  return valOrPath(getEnv("XDG_CONFIG_HOME"), [baseDir(), ".config"]);
+}
+__name(xdgConfig, "xdgConfig");
+function xdgCache() {
+  if (isMacOS()) {
+    return valOrPath(getEnv("XDG_CACHE_HOME"), [
+      baseDir(),
+      "Library",
+      "Caches"
+    ]);
+  }
+  if (isWindows()) {
+    return valOrPath(getEnv("XDG_CACHE_HOME"), [
+      windowsLocalAppData(),
+      "xdg.cache"
+    ]);
+  }
+  return valOrPath(getEnv("XDG_CACHE_HOME"), [baseDir(), ".cache"]);
+}
+__name(xdgCache, "xdgCache");
+function xdgAppPaths(name) {
+  const segment = path.parse(name).name;
+  return {
+    config: /* @__PURE__ */ __name(() => path.join(xdgConfig(), segment), "config"),
+    cache: /* @__PURE__ */ __name(() => path.join(xdgCache(), segment), "cache")
+  };
+}
+__name(xdgAppPaths, "xdgAppPaths");
+
+// src/global-wrangler-config-path.ts
+function getGlobalConfigPath({
+  appName = "wrangler",
+  leadingDot = true,
+  useLegacyHomeDir = true
+} = {}) {
+  const dirName = `${leadingDot ? "." : ""}${appName}`;
+  const configDir = xdgAppPaths(dirName).config();
+  if (useLegacyHomeDir) {
+    const legacyConfigDir = path.join(os.homedir(), dirName);
+    if (isDirectory(legacyConfigDir)) {
+      return legacyConfigDir;
+    }
+  }
+  return configDir;
+}
+__name(getGlobalConfigPath, "getGlobalConfigPath");
+function getGlobalWranglerCachePath() {
+  return xdgAppPaths(".wrangler").cache();
+}
+__name(getGlobalWranglerCachePath, "getGlobalWranglerCachePath");
+
+export { getGlobalConfigPath, getGlobalWranglerCachePath };

package/dist/{chunk-O4YGOZSW.mjs → chunk-TJ6ANXA2.mjs}

@@ -1,4 +1,4 @@
-import { __name } from './chunk-DCOBXSFB.mjs';
+import { __name } from './chunk-DDRU76YD.mjs';
 
 // src/prometheus-metrics.ts
 var MetricsRegistry = class {

package/dist/{config-8UymS5SL.d.mts → config-B_-PmLum.d.mts}

@@ -7,6 +7,18 @@ interface FetchError {
     documentation_url?: string;
     message: string;
     error_chain?: FetchError[];
+    /**
+     * Optional structured error metadata returned alongside the message. The
+     * Cloudflare v4 envelope permits a `meta` object whose shape varies by
+     * endpoint; consumers are expected to validate the shape at use site
+     * before relying on any field.
+     *
+     * Known usage: declarative DO exports reconciliation returns `meta.details`
+     * as an array of per-class errors.
+     */
+    meta?: {
+        details?: unknown;
+    } & Record<string, unknown>;
 }
 
 /**
@@ -709,6 +721,12 @@ interface CfDurableObjectMigrations {
         deleted_classes?: string[];
     }[];
 }
+/**
+ * The declarative `exports` map keyed by class name.
+ *
+ * Durable Objects can only be configured by `exports` or `migrations`, not both.
+ */
+type CfExports = Exports;
 type CfPlacement = {
     mode: "smart";
     hint?: string;
@@ -754,6 +772,11 @@ interface CfWorkerInit {
         class_name: string;
     }[] | undefined;
     migrations: CfDurableObjectMigrations | undefined;
+    /**
+     * Declarative exports configuration. Durable Object entries are sent instead
+     * of `migrations`.
+     */
+    exports: CfExports | undefined;
     compatibility_date: string | undefined;
     compatibility_flags: string[] | undefined;
     keepVars: boolean | undefined;
@@ -1067,6 +1090,7 @@ type WorkerMetadataPut = {
     compatibility_flags?: string[];
     usage_model?: "bundled" | "unbound";
     migrations?: CfDurableObjectMigrations;
+    exports?: CfExports;
     capnp_schema?: string;
     bindings: WorkerMetadataBinding[];
     keep_bindings?: (WorkerMetadataBinding["type"] | "secret_text" | "secret_key")[];
@@ -1089,6 +1113,62 @@ type WorkerMetadataVersionsPost = WorkerMetadataPut & {
     annotations?: Record<string, string>;
 };
 type WorkerMetadata = WorkerMetadataPut | WorkerMetadataVersionsPost;
+/**
+ * Structured per-class entry returned by the declarative exports
+ * reconciliation flow.
+ *
+ * The same shape is used for both successful info entries (under
+ * `exports_reconciliation.info[]`) and blocking errors (under the v4 error
+ * envelope's `meta.details[]`). The `scenario` tag is the stable, machine-
+ * readable identifier of which reconciliation case produced the entry.
+ */
+type ExportsReconciliationEntryBase = {
+    class: string;
+    scenario: string;
+    message: string;
+    namespace_id?: string;
+};
+type ExportsReconciliationInfo = ExportsReconciliationEntryBase & {
+    /**
+     * Workers in the account that still bind to the source class name and must
+     * be redeployed before the tombstone is safe to remove.
+     */
+    referencing_scripts?: string[];
+};
+type ExportsReconciliationWarning = ExportsReconciliationEntryBase;
+type ExportsReconciliationErrorDetail = ExportsReconciliationEntryBase & {
+    suggestion?: string;
+    referencing_scripts?: string[];
+};
+type ExportsReconciliationRename = {
+    from: string;
+    to: string;
+};
+type ExportsReconciliationTransfer = {
+    class: string;
+    to: string;
+    phase: "committed";
+};
+type ExportsReconciliationTransferPending = {
+    class: string;
+    from: string;
+};
+/**
+ * The customer-visible summary of a successful exports reconciliation,
+ * embedded in the upload response under `exports_reconciliation`. All arrays
+ * are present, and are empty when there are no entries to report.
+ */
+type ExportsReconciliationResult = {
+    created: string[];
+    updated: string[];
+    deleted: string[];
+    renamed: ExportsReconciliationRename[];
+    transferred: ExportsReconciliationTransfer[];
+    transfer_pending: ExportsReconciliationTransferPending[];
+    warnings: ExportsReconciliationWarning[];
+    info: ExportsReconciliationInfo[];
+    removable_entries: string[];
+};
 type ServiceMetadataRes = {
     id: string;
     default_environment: {
@@ -1312,6 +1392,7 @@ interface StartDevWorkerInput {
         type: "plain_text";
     }>>;
     migrations?: DurableObjectMigration[];
+    exports?: Exports;
     containers?: ContainerApp[];
     /** The triggers which will cause the worker's exported default handlers to be called. */
     triggers?: Trigger[];
@@ -1753,6 +1834,66 @@ type DurableObjectMigration = {
     /** The Durable Objects being removed. */
     deleted_classes?: string[];
 };
+/**
+ * Storage backend for a declarative Durable Object export. See
+ * {@link DurableObjectExport}.
+ */
+type DurableObjectExportStorage = "sqlite" | "legacy-kv";
+/**
+ * A single declarative Durable Object export entry in the `exports` config
+ * map. `type` is reserved for the export kind. `state` carries the Durable
+ * Object lifecycle and defaults to `"created"` (live) when omitted.
+ *
+ * Mutually exclusive with {@link DurableObjectMigration} at the config-
+ * validation boundary.
+ *
+ *  - `created` (default, live): `storage` is required.
+ *  - `deleted` (tombstone): retire a provisioned namespace whose class has
+ *    been removed from code.
+ *  - `renamed` (tombstone): rewrite a provisioned namespace's class name to
+ *    `renamed_to`. The target name must also appear as a live (state
+ *    `"created"`) `durable-object` entry in the same map.
+ *  - `transferred` (tombstone): hand ownership of the namespace to another
+ *    script in the same account (`transferred_to`). Two-phase commit;
+ *    the target must first deploy an `expecting-transfer` entry naming this
+ *    script via `transfer_from`.
+ *  - `expecting-transfer` (live): receiving side of a two-phase transfer;
+ *    `storage` and `transfer_from` are both required.
+ */
+type DurableObjectExport = {
+    type: "durable-object";
+    state?: "created";
+    storage: DurableObjectExportStorage;
+} | {
+    type: "durable-object";
+    state: "deleted";
+} | {
+    type: "durable-object";
+    state: "renamed";
+    renamed_to: string;
+} | {
+    type: "durable-object";
+    state: "transferred";
+    transferred_to: string;
+} | {
+    type: "durable-object";
+    state: "expecting-transfer";
+    storage: DurableObjectExportStorage;
+    transfer_from: string;
+};
+interface WorkerEntrypointExport {
+    type: "worker";
+    cache?: {
+        /** Whether cache is enabled for this entrypoint. */
+        enabled: boolean;
+    };
+}
+type ConfiguredExport = DurableObjectExport | WorkerEntrypointExport;
+/**
+ * The declarative `exports` map keyed by export name. Durable Object exports
+ * are mutually exclusive with `migrations` at the wrangler config layer.
+ */
+type Exports = Record<string, ConfiguredExport>;
 /**
  * The `EnvironmentInheritable` interface declares all the configuration fields for an environment
  * that can be inherited (and overridden) from the top-level environment.
@@ -1894,6 +2035,15 @@ interface EnvironmentInheritable {
      * @inheritable
      */
     migrations: DurableObjectMigration[];
+    /**
+     * Declarative exports configuration — a map of class name to export configuration.
+     *
+     * The configuration of Durable Objects via `exports` is mutually exclusive with `migrations`.
+     *
+     * @default {}
+     * @inheritable
+     */
+    exports: Exports;
     /**
      * "Cron" definitions to trigger a Worker's "scheduled" function.
      *
@@ -2977,6 +3127,8 @@ interface Observability {
 interface CacheOptions {
     /** If cache is enabled for this Worker */
     enabled: boolean;
+    /** Whether cached assets may be reused across Worker versions. */
+    cross_version_cache?: boolean;
 }
 type DockerConfiguration = {
     /** Socket used by miniflare to communicate with Docker */
@@ -3249,4 +3401,4 @@ interface EnvironmentMap {
 }
 declare const defaultWranglerConfig: Config;
 
-export { type CfQueue as $, type Assets as A, type Binding as B, type ComputedFields as C, type DurableObjectMigration as D, type Environment as E, type CfKvNamespace as F, type CfSendEmailBindings as G, type CfWasmModuleBindings as H, type CfTextBlobBindings as I, type CfBrowserBinding as J, type CfAIBinding as K, type Logger as L, type CfImagesBinding as M, type CfMediaBinding as N, type Observability as O, type PreviewsConfig as P, type CfStreamBinding as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfVersionMetadataBinding as V, type WorkerMetadataBinding as W, type CfDataBlobBindings as X, type CfDurableObject as Y, type ZoneIdRoute as Z, type CfWorkflow as _, type RedirectedRawConfig as a, type ComplianceConfig as a$, type CfR2Bucket as a0, type CfD1Database as a1, type CfVectorize as a2, type CfAISearchNamespace as a3, type CfAISearch as a4, type CfWebSearch as a5, type CfAgentMemory as a6, type CfSecretsStoreSecrets as a7, type CfArtifacts as a8, type CfHelloWorld as a9, type AssetConfigMetadata as aA, type AssetsOptions as aB, type ValidatedAssetsOptions as aC, type LegacyAssetPaths as aD, type WorkerMetadata as aE, type ServiceMetadataRes as aF, type ServiceFetch as aG, type File as aH, type BinaryFile as aI, type Trigger as aJ, type CfAccount as aK, type HookValues as aL, type Hook as aM, type AsyncHook as aN, type LogLevel as aO, type NodeJSCompatMode as aP, type StartDevWorkerInput as aQ, type Entry as aR, INHERIT_SYMBOL as aS, SERVICE_TAG_PREFIX as aT, ENVIRONMENT_TAG_PREFIX as aU, PATH_TO_DEPLOY_CONFIG as aV, JSON_CONFIG_FORMATS as aW, getC3CommandFromEnv as aX, getWranglerSendMetricsFromEnv as aY, getWranglerSendErrorReportsFromEnv as aZ, getCloudflareApiEnvironmentFromEnv as a_, type CfFlagship as aa, type CfWorkerLoader as ab, type CfRateLimit as ac, type CfHyperdrive as ad, type CfDevPluginCfg as ae, type CfService as af, type CfVpcService as ag, type CfVpcNetwork as ah, type CfAnalyticsEngineDataset as ai, type CfDispatchNamespace as aj, type CfMTlsCertificate as ak, type CfLogfwdr as al, type CfLogfwdrBinding as am, type CfAssetsBinding as an, type CfPipeline as ao, type CfUnsafeBinding as ap, type CfCapnp as aq, type CfUnsafe as ar, type CfDurableObjectMigrations as as, type CfPlacement as at, type CfTailConsumer as au, type CfUserLimits as av, type CfWorkerInit as aw, type CfWorkerContext as ax, type CfWorkerSourceMap as ay, type Json as az, type Config as b, COMPLIANCE_REGION_CONFIG_PUBLIC as b0, COMPLIANCE_REGION_CONFIG_UNKNOWN as b1, getCloudflareComplianceRegion as b2, getCloudflareApiBaseUrl as b3, getComplianceRegionSubdomain as b4, getSanitizeLogs as b5, getOutputFileDirectoryFromEnv as b6, getOutputFilePathFromEnv as b7, getCIMatchTag as b8, getCIOverrideName as b9, type FetchPagedListResultFetcher as bA, performApiFetchBase as bB, fetchInternalBase as bC, fetchResultBase as bD, fetchListResultBase as bE, truncate as bF, isWAFBlockResponse as bG, extractWAFBlockRayId as bH, extractAccountTag as bI, hasMorePages as bJ, renderError as bK, addAuthorizationHeader as bL, throwFetchError as bM, fetchKVGetValueBase as bN, type FetchKVGetValueFetcher as bO, hasCursor as bP, maybeAddTraceHeader as bQ, getCIOverrideNetworkModeHost as ba, getCIGeneratePreviewAlias as bb, getWorkersCIBranchName as bc, getBuildConditionsFromEnv as bd, getBuildPlatformFromEnv as be, getRegistryPath as bf, getD1ExtraLocationChoices as bg, getDockerPath as bh, getSubdomainMixedStateCheckDisabled as bi, getCloudflareLoadDevVarsFromDotEnv as bj, getCloudflareIncludeProcessEnvFromEnv as bk, getTraceHeader as bl, getDisableConfigWatching as bm, getWranglerHideBanner as bn, getCloudflareEnv as bo, getOpenNextDeployFromEnv as bp, getLocalExplorerEnabledFromEnv as bq, getBrowserRenderingHeadfulFromEnv as br, getCfFetchEnabledFromEnv as bs, getCfFetchPathFromEnv as bt, getWranglerCacheDirFromEnv as bu, getCloudflaredPathFromEnv as bv, type ApiCredentials as bw, type FetchResult as bx, type FetchResultFetcher as by, type FetchListResultFetcher as bz, type Route as c, type RawDevConfig as d, type ConfigFields as e, type RawEnvironment as f, defaultWranglerConfig as g, LOGGER_LEVELS as h, type LoggerLevel as i, type ZoneNameRoute as j, type CustomDomainRoute as k, type CloudchamberConfig as l, type ContainerApp as m, type DurableObjectBindings as n, type WorkflowBinding as o, type EnvironmentNonInheritable as p, type Rule as q, type ConfigModuleRuleType as r, type DispatchNamespaceOutbound as s, type CacheOptions as t, type DockerConfiguration as u, type ContainerEngine as v, type CfScriptFormat as w, type CfModuleType as x, type CfModule as y, type CfVars as z };
+export { type CfStreamBinding as $, type Assets as A, type Binding as B, type ComputedFields as C, type DurableObjectExport as D, type Exports as E, type ContainerEngine as F, type CfScriptFormat as G, type CfModuleType as H, type CfModule as I, type CfVars as J, type CfKvNamespace as K, type Logger as L, type CfSendEmailBindings as M, type CfWasmModuleBindings as N, type Observability as O, type PreviewsConfig as P, type CfTextBlobBindings as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfBrowserBinding as V, type WorkerEntrypointExport as W, type CfAIBinding as X, type CfImagesBinding as Y, type ZoneIdRoute as Z, type CfMediaBinding as _, type RedirectedRawConfig as a, type AsyncHook as a$, type CfVersionMetadataBinding as a0, type CfDataBlobBindings as a1, type CfDurableObject as a2, type CfWorkflow as a3, type CfQueue as a4, type CfR2Bucket as a5, type CfD1Database as a6, type CfVectorize as a7, type CfAISearchNamespace as a8, type CfAISearch as a9, type CfTailConsumer as aA, type CfUserLimits as aB, type CfWorkerInit as aC, type CfWorkerContext as aD, type CfWorkerSourceMap as aE, type Json as aF, type AssetConfigMetadata as aG, type AssetsOptions as aH, type ValidatedAssetsOptions as aI, type LegacyAssetPaths as aJ, type WorkerMetadata as aK, type ExportsReconciliationEntryBase as aL, type ExportsReconciliationInfo as aM, type ExportsReconciliationWarning as aN, type ExportsReconciliationErrorDetail as aO, type ExportsReconciliationRename as aP, type ExportsReconciliationTransfer as aQ, type ExportsReconciliationTransferPending as aR, type ExportsReconciliationResult as aS, type ServiceMetadataRes as aT, type ServiceFetch as aU, type File as aV, type BinaryFile as aW, type Trigger as aX, type CfAccount as aY, type HookValues as aZ, type Hook as a_, type CfWebSearch as aa, type CfAgentMemory as ab, type CfSecretsStoreSecrets as ac, type CfArtifacts as ad, type CfHelloWorld as ae, type CfFlagship as af, type CfWorkerLoader as ag, type CfRateLimit as ah, type CfHyperdrive as ai, type CfDevPluginCfg as aj, type CfService as ak, type CfVpcService as al, type CfVpcNetwork as am, type CfAnalyticsEngineDataset as an, type CfDispatchNamespace as ao, type CfMTlsCertificate as ap, type CfLogfwdr as aq, type CfLogfwdrBinding as ar, type CfAssetsBinding as as, type CfPipeline as at, type CfUnsafeBinding as au, type CfCapnp as av, type CfUnsafe as aw, type CfDurableObjectMigrations as ax, type CfExports as ay, type CfPlacement as az, type Config as b, fetchKVGetValueBase as b$, type LogLevel as b0, type NodeJSCompatMode as b1, type StartDevWorkerInput as b2, type Entry as b3, INHERIT_SYMBOL as b4, SERVICE_TAG_PREFIX as b5, ENVIRONMENT_TAG_PREFIX as b6, PATH_TO_DEPLOY_CONFIG as b7, JSON_CONFIG_FORMATS as b8, getC3CommandFromEnv as b9, getDisableConfigWatching as bA, getWranglerHideBanner as bB, getCloudflareEnv as bC, getOpenNextDeployFromEnv as bD, getLocalExplorerEnabledFromEnv as bE, getBrowserRenderingHeadfulFromEnv as bF, getCfFetchEnabledFromEnv as bG, getCfFetchPathFromEnv as bH, getWranglerCacheDirFromEnv as bI, getCloudflaredPathFromEnv as bJ, type ApiCredentials as bK, type FetchResult as bL, type FetchResultFetcher as bM, type FetchListResultFetcher as bN, type FetchPagedListResultFetcher as bO, performApiFetchBase as bP, fetchInternalBase as bQ, fetchResultBase as bR, fetchListResultBase as bS, truncate as bT, isWAFBlockResponse as bU, extractWAFBlockRayId as bV, extractAccountTag as bW, hasMorePages as bX, renderError as bY, addAuthorizationHeader as bZ, throwFetchError as b_, getWranglerSendMetricsFromEnv as ba, getWranglerSendErrorReportsFromEnv as bb, getCloudflareApiEnvironmentFromEnv as bc, type ComplianceConfig as bd, COMPLIANCE_REGION_CONFIG_PUBLIC as be, COMPLIANCE_REGION_CONFIG_UNKNOWN as bf, getCloudflareComplianceRegion as bg, getCloudflareApiBaseUrl as bh, getComplianceRegionSubdomain as bi, getSanitizeLogs as bj, getOutputFileDirectoryFromEnv as bk, getOutputFilePathFromEnv as bl, getCIMatchTag as bm, getCIOverrideName as bn, getCIOverrideNetworkModeHost as bo, getCIGeneratePreviewAlias as bp, getWorkersCIBranchName as bq, getBuildConditionsFromEnv as br, getBuildPlatformFromEnv as bs, getRegistryPath as bt, getD1ExtraLocationChoices as bu, getDockerPath as bv, getSubdomainMixedStateCheckDisabled as bw, getCloudflareLoadDevVarsFromDotEnv as bx, getCloudflareIncludeProcessEnvFromEnv as by, getTraceHeader as bz, type WorkerMetadataBinding as c, type FetchKVGetValueFetcher as c0, hasCursor as c1, maybeAddTraceHeader as c2, type Route as d, type RawDevConfig as e, type ConfigFields as f, type RawEnvironment as g, defaultWranglerConfig as h, LOGGER_LEVELS as i, type LoggerLevel as j, type Environment as k, type ZoneNameRoute as l, type CustomDomainRoute as m, type CloudchamberConfig as n, type ContainerApp as o, type DurableObjectMigration as p, type DurableObjectExportStorage as q, type ConfiguredExport as r, type DurableObjectBindings as s, type WorkflowBinding as t, type EnvironmentNonInheritable as u, type Rule as v, type ConfigModuleRuleType as w, type DispatchNamespaceOutbound as x, type CacheOptions as y, type DockerConfiguration as z };

package/dist/fs-helpers.d.mts

@@ -0,0 +1,40 @@
+/**
+ * Returns whether the given path is a directory
+ *
+ * Note: this function never throws; if the path does not exist or is inaccessible, it returns false.
+ *
+ * @param path The file system path to check
+ * @returns `true` if the path is a directory, `false` otherwise
+ */
+declare function isDirectory(path: string): boolean;
+/**
+ * Recursively remove a directory without waiting for completion or throwing any errors.
+ *
+ * @param dirPath The directory path to remove
+ * @param options An object with a `fireAndForget` property set to `true`
+ * @return `void` - the removal is fire-and-forget with errors suppressed
+ */
+declare function removeDir(dirPath: string, { fireAndForget }: {
+    fireAndForget: true;
+}): void;
+/**
+ * Recursively remove a directory with retries for Windows compatibility.
+ *
+ * @param dirPath The directory path to remove
+ * @param options An optional object with a `fireAndForget` property set to `false`, if defined
+ * @return `Promise<void>` - resolves when the removal is complete, or rejects if the removal fails
+ */
+declare function removeDir(dirPath: string, options?: {
+    fireAndForget?: false;
+}): Promise<void>;
+/**
+ * Synchronously and recursively remove a directory, with retries for Windows compatibility.
+ *
+ * @see {@link removeDir} for the async version and rationale.
+ *
+ * @param dirPath The directory path to remove
+ * @throws If the removal fails after retries, an error will be thrown
+ */
+declare function removeDirSync(dirPath: string): void;
+
+export { isDirectory, removeDir, removeDirSync };

package/dist/fs-helpers.mjs

@@ -0,0 +1,2 @@
+export { isDirectory, removeDir, removeDirSync } from './chunk-OC543JY3.mjs';
+import './chunk-DDRU76YD.mjs';

package/dist/global-wrangler-config-path.d.mts

@@ -0,0 +1,35 @@
+interface GetGlobalConfigPathOptions {
+    /**
+     * The application namespace. Defaults to `"wrangler"`.
+     */
+    appName?: string;
+    /**
+     * Whether to prepend a `.` to `appName` when resolving the XDG path and the
+     * legacy `$HOME` directory. Defaults to `true` to match wrangler's
+     * historical behaviour (`.wrangler`).
+     */
+    leadingDot?: boolean;
+    /**
+     * When `true` (the default, matching wrangler's historical behaviour), a
+     * pre-existing `~/.<appName>` directory takes precedence over the XDG path.
+     * Pass `false` to always use the XDG-compliant path.
+     */
+    useLegacyHomeDir?: boolean;
+}
+/**
+ * Resolve the global config directory for a Cloudflare CLI.
+ *
+ * Defaults to wrangler's directory (`.wrangler`) so existing callers are
+ * unaffected, but accepts an `appName` so other first-party CLIs (e.g. `cf`)
+ * can reuse the same XDG-compliant resolution under their own namespace.
+ */
+declare function getGlobalConfigPath({ appName, leadingDot, useLegacyHomeDir, }?: GetGlobalConfigPathOptions): string;
+/**
+ * Resolve the XDG-compliant global cache directory for wrangler (`.wrangler`).
+ *
+ * Unlike {@link getGlobalConfigPath}, this never falls back to a legacy
+ * `~/.wrangler` directory.
+ */
+declare function getGlobalWranglerCachePath(): string;
+
+export { type GetGlobalConfigPathOptions, getGlobalConfigPath, getGlobalWranglerCachePath };

package/dist/global-wrangler-config-path.mjs

@@ -0,0 +1,3 @@
+export { getGlobalConfigPath, getGlobalWranglerCachePath } from './chunk-OTBYAUQ6.mjs';
+import './chunk-OC543JY3.mjs';
+import './chunk-DDRU76YD.mjs';