@cloudflare/workers-utils 0.28.0 → 0.30.0

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { T as TailConsumer, aK as WorkerMetadata, R as RawConfig } from './config-BadLPAp8.mjs';
+import { T as TailConsumer, aL as WorkerMetadata, R as RawConfig } from './config-BEcnaWpD.mjs';
 import { AssetConfig } from '@cloudflare/workers-shared';
 import { Cloudflare } from 'cloudflare';
 import 'node:url';

package/dist/{chunk-Y3JVLYM6.mjs → chunk-3K53PSCY.mjs}

@@ -2382,10 +2382,20 @@ var APIError = class extends ParseError {
    * endpoint-specific structured error payloads.
    */
   meta;
-  constructor({ status, ...rest }) {
+  /**
+   * Optional number of milliseconds the API asked us to wait before retrying,
+   * derived from the response's `Retry-After` header (if present).
+   */
+  retryAfterMs;
+  constructor({
+    status,
+    retryAfterMs,
+    ...rest
+  }) {
     super(rest);
     this.name = this.constructor.name;
     this.#status = status;
+    this.retryAfterMs = retryAfterMs;
   }
   get status() {
     return this.#status;

package/dist/{config-BadLPAp8.d.mts → config-BEcnaWpD.d.mts}

@@ -204,6 +204,21 @@ declare const getOpenNextDeployFromEnv: () => string | undefined;
  * `X_LOCAL_EXPLORER` enables the local explorer UI at /cdn-cgi/explorer.
  */
 declare const getLocalExplorerEnabledFromEnv: () => boolean;
+/**
+ * `X_LOCAL_OBSERVABILITY` turns on local-dev observability capture. Both
+ * `wrangler dev` and the Vite plugin read it and pass it through as the one
+ * `unsafeObservability` Miniflare option, which makes core attach the trace
+ * collector to each user worker.
+ *
+ * Temporarily defaults to `false` for release: defaulting it on attaches extra
+ * per-worker services (collector + streaming tail) that destabilise the
+ * multi-process dev-registry scenario on Windows (workerd socket "fetch
+ * failed"). Capture is now opt-in — set `X_LOCAL_OBSERVABILITY=true`, or turn it
+ * on from the Local Explorer's Observability tab (Vite dev), which reloads the
+ * runtime with capture enabled. The explorer UI itself (`X_LOCAL_EXPLORER`)
+ * stays on by default so the tab is always available.
+ */
+declare const getLocalObservabilityEnabledFromEnv: () => boolean;
 /**
  * `X_BROWSER_HEADFUL` opens the browser in headful (visible) mode when using the
  * Browser Run API in local development.
@@ -317,11 +332,22 @@ declare function performApiFetchBase(complianceConfig: ComplianceConfig, resourc
 declare function fetchInternalBase<ResponseType>(complianceConfig: ComplianceConfig, resource: string, init: RequestInit | undefined, userAgent: string, logger: Logger, queryParams?: URLSearchParams, abortSignal?: AbortSignal, credentials?: ApiCredentials): Promise<{
     response: ResponseType;
     status: number;
+    retryAfterMs?: number;
 }>;
 declare function fetchResultBase<ResponseType>(complianceConfig: ComplianceConfig, resource: string, init: RequestInit | undefined, userAgent: string, logger: Logger, queryParams?: URLSearchParams, abortSignal?: AbortSignal, credentials?: ApiCredentials): Promise<ResponseType>;
 declare function fetchListResultBase<ResponseType>(complianceConfig: ComplianceConfig, resource: string, init: RequestInit | undefined, userAgent: string, logger: Logger, queryParams?: URLSearchParams, credentials?: ApiCredentials): Promise<ResponseType[]>;
 declare function truncate(text: string, maxLength: number): string;
 declare function isWAFBlockResponse(headers: Headers): boolean;
+/**
+ * Parses a `Retry-After` header value (https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After)
+ * into milliseconds to wait before retrying, or `undefined` if absent/unparsable.
+ *
+ * Per the HTTP spec, `Retry-After` may either be a number of delay-seconds,
+ * or an HTTP-date after which the request may be retried.
+ */
+declare function parseRetryAfterValue(retryAfter: string | null | undefined): number | undefined;
+/** Same as {@link parseRetryAfterValue}, reading the value from a `Headers` object. */
+declare function parseRetryAfterMs(headers: Headers): number | undefined;
 declare function extractWAFBlockRayId(headers: Headers): string | undefined;
 declare function extractAccountTag(resource: string): string | undefined;
 interface PageResultInfo {
@@ -337,7 +363,7 @@ declare function renderError(err: FetchError | {
     documentation_url?: string;
 }, level?: number): string;
 declare function addAuthorizationHeader(headers: Headers, auth: ApiCredentials, overrideExisting?: boolean): void;
-declare function throwFetchError(resource: string, response: FetchResult<unknown>, status: number): never;
+declare function throwFetchError(resource: string, response: FetchResult<unknown>, status: number, retryAfterMs?: number): never;
 /**
  * Fetch a raw KV value from the Cloudflare API.
  *
@@ -542,6 +568,11 @@ interface CfR2Bucket {
     jurisdiction?: string;
     remote?: boolean;
     raw?: boolean;
+    /** Settings that only apply to local development */
+    local_dev?: {
+        /** EXPERIMENTAL: credentials for the local S3-compatible endpoint */
+        experimental_s3_credentials?: LocalS3Credentials;
+    };
 }
 interface CfD1Database {
     binding: string;
@@ -1565,6 +1596,11 @@ type Entry = {
 interface Environment extends EnvironmentInheritable, EnvironmentNonInheritable {
 }
 type SimpleRoute = string;
+/** AWS SigV4 credentials for miniflare's local S3-compatible endpoint */
+interface LocalS3Credentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+}
 type ZoneIdRoute = {
     pattern: string;
     zone_id: string;
@@ -2487,6 +2523,16 @@ interface EnvironmentNonInheritable {
         jurisdiction?: string;
         /** Whether the R2 bucket should be remote or not in local development */
         remote?: boolean;
+        /** Settings that only apply to local development */
+        local_dev?: {
+            /**
+             * EXPERIMENTAL: AWS SigV4 credentials for the local S3-compatible
+             * endpoint. When set, the bucket is served at
+             * `/cdn-cgi/local/r2/s3/<bucket-name>` during local development.
+             * Ignored when the bucket runs remotely.
+             */
+            experimental_s3_credentials?: LocalS3Credentials;
+        };
     }[];
     /**
      * Specifies D1 databases that are bound to this Worker environment.
@@ -3447,4 +3493,4 @@ interface EnvironmentMap {
 }
 declare const defaultWranglerConfig: Config;
 
-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 };
+export { type CfMediaBinding as $, type Assets as A, type Binding as B, type ComputedFields as C, type DurableObjectExport as D, type Exports as E, type DockerConfiguration as F, type ContainerEngine as G, type CfScriptFormat as H, type CfModuleType as I, type CfModule as J, type CfVars as K, type Logger as L, type CfKvNamespace as M, type CfSendEmailBindings as N, type Observability as O, type PreviewsConfig as P, type CfWasmModuleBindings as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfTextBlobBindings as V, type WorkerEntrypointExport as W, type CfBrowserBinding as X, type CfAIBinding as Y, type ZoneIdRoute as Z, type CfImagesBinding as _, type RedirectedRawConfig as a, type Hook as a$, type CfStreamBinding as a0, type CfVersionMetadataBinding as a1, type CfDataBlobBindings as a2, type CfDurableObject as a3, type CfWorkflow as a4, type CfQueue as a5, type CfR2Bucket as a6, type CfD1Database as a7, type CfVectorize as a8, type CfAISearchNamespace as a9, type CfPlacement as aA, type CfTailConsumer as aB, type CfUserLimits as aC, type CfWorkerInit as aD, type CfWorkerContext as aE, type CfWorkerSourceMap as aF, type Json as aG, type AssetConfigMetadata as aH, type AssetsOptions as aI, type ValidatedAssetsOptions as aJ, type LegacyAssetPaths as aK, type WorkerMetadata as aL, type ExportsReconciliationEntryBase as aM, type ExportsReconciliationInfo as aN, type ExportsReconciliationWarning as aO, type ExportsReconciliationErrorDetail as aP, type ExportsReconciliationRename as aQ, type ExportsReconciliationTransfer as aR, type ExportsReconciliationTransferPending as aS, type ExportsReconciliationResult as aT, type ServiceMetadataRes as aU, type ServiceFetch as aV, type File as aW, type BinaryFile as aX, type Trigger as aY, type CfAccount as aZ, type HookValues as a_, type CfAISearch as aa, type CfWebSearch as ab, type CfAgentMemory as ac, type CfSecretsStoreSecrets as ad, type CfArtifacts as ae, type CfHelloWorld as af, type CfFlagship as ag, type CfWorkerLoader as ah, type CfRateLimit as ai, type CfHyperdrive as aj, type CfDevPluginCfg as ak, type CfService as al, type CfVpcService as am, type CfVpcNetwork as an, type CfAnalyticsEngineDataset as ao, type CfDispatchNamespace as ap, type CfMTlsCertificate as aq, type CfLogfwdr as ar, type CfLogfwdrBinding as as, type CfAssetsBinding as at, type CfPipeline as au, type CfUnsafeBinding as av, type CfCapnp as aw, type CfUnsafe as ax, type CfDurableObjectMigrations as ay, type CfExports as az, type Config as b, hasMorePages as b$, type AsyncHook as b0, type LogLevel as b1, type NodeJSCompatMode as b2, type StartDevWorkerInput as b3, type Entry as b4, INHERIT_SYMBOL as b5, SERVICE_TAG_PREFIX as b6, ENVIRONMENT_TAG_PREFIX as b7, PATH_TO_DEPLOY_CONFIG as b8, JSON_CONFIG_FORMATS as b9, getTraceHeader as bA, getDisableConfigWatching as bB, getWranglerHideBanner as bC, getCloudflareEnv as bD, getOpenNextDeployFromEnv as bE, getLocalExplorerEnabledFromEnv as bF, getLocalObservabilityEnabledFromEnv as bG, getBrowserRenderingHeadfulFromEnv as bH, getCfFetchEnabledFromEnv as bI, getCfFetchPathFromEnv as bJ, getWranglerCacheDirFromEnv as bK, getCloudflaredPathFromEnv as bL, type ApiCredentials as bM, type FetchResult as bN, type FetchResultFetcher as bO, type FetchListResultFetcher as bP, type FetchPagedListResultFetcher as bQ, performApiFetchBase as bR, fetchInternalBase as bS, fetchResultBase as bT, fetchListResultBase as bU, truncate as bV, isWAFBlockResponse as bW, parseRetryAfterValue as bX, parseRetryAfterMs as bY, extractWAFBlockRayId as bZ, extractAccountTag as b_, getC3CommandFromEnv as ba, getWranglerSendMetricsFromEnv as bb, getWranglerSendErrorReportsFromEnv as bc, getCloudflareApiEnvironmentFromEnv as bd, type ComplianceConfig as be, COMPLIANCE_REGION_CONFIG_PUBLIC as bf, COMPLIANCE_REGION_CONFIG_UNKNOWN as bg, getCloudflareComplianceRegion as bh, getCloudflareApiBaseUrl as bi, getComplianceRegionSubdomain as bj, getSanitizeLogs as bk, getOutputFileDirectoryFromEnv as bl, getOutputFilePathFromEnv as bm, getCIMatchTag as bn, getCIOverrideName as bo, getCIOverrideNetworkModeHost as bp, getCIGeneratePreviewAlias as bq, getWorkersCIBranchName as br, getBuildConditionsFromEnv as bs, getBuildPlatformFromEnv as bt, getRegistryPath as bu, getD1ExtraLocationChoices as bv, getDockerPath as bw, getSubdomainMixedStateCheckDisabled as bx, getCloudflareLoadDevVarsFromDotEnv as by, getCloudflareIncludeProcessEnvFromEnv as bz, type WorkerMetadataBinding as c, renderError as c0, addAuthorizationHeader as c1, throwFetchError as c2, fetchKVGetValueBase as c3, type FetchKVGetValueFetcher as c4, hasCursor as c5, maybeAddTraceHeader as c6, 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 LocalS3Credentials as l, type ZoneNameRoute as m, type CustomDomainRoute as n, type CloudchamberConfig as o, type ContainerApp as p, type DurableObjectMigration as q, type DurableObjectExportStorage as r, type ConfiguredExport as s, type DurableObjectBindings as t, type WorkflowBinding as u, type EnvironmentNonInheritable as v, type Rule as w, type ConfigModuleRuleType as x, type DispatchNamespaceOutbound as y, type CacheOptions as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, E as Exports, D as DurableObjectExport, W as WorkerEntrypointExport, c as WorkerMetadataBinding, L as Logger, d as Route } from './config-BadLPAp8.mjs';
-export { bK as ApiCredentials, aG as AssetConfigMetadata, A as Assets, aH as AssetsOptions, a$ as AsyncHook, aW as BinaryFile, be as COMPLIANCE_REGION_CONFIG_PUBLIC, bf as COMPLIANCE_REGION_CONFIG_UNKNOWN, y as CacheOptions, X as CfAIBinding, a9 as CfAISearch, a8 as CfAISearchNamespace, aY as CfAccount, ab as CfAgentMemory, an as CfAnalyticsEngineDataset, ad as CfArtifacts, as as CfAssetsBinding, V as CfBrowserBinding, av as CfCapnp, a6 as CfD1Database, a1 as CfDataBlobBindings, aj as CfDevPluginCfg, ao as CfDispatchNamespace, a2 as CfDurableObject, ax as CfDurableObjectMigrations, ay as CfExports, af as CfFlagship, ae as CfHelloWorld, ai as CfHyperdrive, Y as CfImagesBinding, K as CfKvNamespace, aq as CfLogfwdr, ar as CfLogfwdrBinding, ap as CfMTlsCertificate, _ as CfMediaBinding, I as CfModule, H as CfModuleType, at as CfPipeline, az as CfPlacement, a4 as CfQueue, a5 as CfR2Bucket, ah as CfRateLimit, G as CfScriptFormat, ac as CfSecretsStoreSecrets, M as CfSendEmailBindings, ak as CfService, $ as CfStreamBinding, aA as CfTailConsumer, Q as CfTextBlobBindings, aw as CfUnsafe, au as CfUnsafeBinding, aB as CfUserLimits, J as CfVars, a7 as CfVectorize, a0 as CfVersionMetadataBinding, am as CfVpcNetwork, al as CfVpcService, N as CfWasmModuleBindings, aa as CfWebSearch, aD as CfWorkerContext, aC as CfWorkerInit, ag as CfWorkerLoader, aE as CfWorkerSourceMap, a3 as CfWorkflow, n as CloudchamberConfig, bd as ComplianceConfig, f as ConfigFields, w as ConfigModuleRuleType, r as ConfiguredExport, o as ContainerApp, F as ContainerEngine, m as CustomDomainRoute, x as DispatchNamespaceOutbound, z as DockerConfiguration, s as DurableObjectBindings, q as DurableObjectExportStorage, p as DurableObjectMigration, b6 as ENVIRONMENT_TAG_PREFIX, b3 as Entry, k as Environment, u as EnvironmentNonInheritable, aL as ExportsReconciliationEntryBase, aO as ExportsReconciliationErrorDetail, aM as ExportsReconciliationInfo, aP as ExportsReconciliationRename, aS as ExportsReconciliationResult, aQ as ExportsReconciliationTransfer, aR as ExportsReconciliationTransferPending, aN as ExportsReconciliationWarning, c0 as FetchKVGetValueFetcher, bN as FetchListResultFetcher, bO as FetchPagedListResultFetcher, bL as FetchResult, bM as FetchResultFetcher, aV as File, a_ as Hook, aZ as HookValues, b4 as INHERIT_SYMBOL, b8 as JSON_CONFIG_FORMATS, aF as Json, i as LOGGER_LEVELS, aJ as LegacyAssetPaths, b0 as LogLevel, j as LoggerLevel, b1 as NodeJSCompatMode, O as Observability, b7 as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, e as RawDevConfig, g as RawEnvironment, a as RedirectedRawConfig, v as Rule, b5 as SERVICE_TAG_PREFIX, aU as ServiceFetch, aT as ServiceMetadataRes, b2 as StartDevWorkerInput, S as StreamingTailConsumer, T as TailConsumer, aX as Trigger, U as UserLimits, aI as ValidatedAssetsOptions, aK as WorkerMetadata, t as WorkflowBinding, Z as ZoneIdRoute, l as ZoneNameRoute, bZ as addAuthorizationHeader, h as defaultWranglerConfig, bW as extractAccountTag, bV as extractWAFBlockRayId, bQ as fetchInternalBase, b$ as fetchKVGetValueBase, bS as fetchListResultBase, bR as fetchResultBase, bF as getBrowserRenderingHeadfulFromEnv, br as getBuildConditionsFromEnv, bs as getBuildPlatformFromEnv, b9 as getC3CommandFromEnv, bp as getCIGeneratePreviewAlias, bm as getCIMatchTag, bn as getCIOverrideName, bo as getCIOverrideNetworkModeHost, bG as getCfFetchEnabledFromEnv, bH as getCfFetchPathFromEnv, bh as getCloudflareApiBaseUrl, bc as getCloudflareApiEnvironmentFromEnv, bg as getCloudflareComplianceRegion, bC as getCloudflareEnv, by as getCloudflareIncludeProcessEnvFromEnv, bx as getCloudflareLoadDevVarsFromDotEnv, bJ as getCloudflaredPathFromEnv, bi as getComplianceRegionSubdomain, bu as getD1ExtraLocationChoices, bA as getDisableConfigWatching, bv as getDockerPath, bE as getLocalExplorerEnabledFromEnv, bD as getOpenNextDeployFromEnv, bk as getOutputFileDirectoryFromEnv, bl as getOutputFilePathFromEnv, bt as getRegistryPath, bj as getSanitizeLogs, bw as getSubdomainMixedStateCheckDisabled, bz as getTraceHeader, bq as getWorkersCIBranchName, bI as getWranglerCacheDirFromEnv, bB as getWranglerHideBanner, bb as getWranglerSendErrorReportsFromEnv, ba as getWranglerSendMetricsFromEnv, c1 as hasCursor, bX as hasMorePages, bU as isWAFBlockResponse, c2 as maybeAddTraceHeader, bP as performApiFetchBase, bY as renderError, b_ as throwFetchError, bT as truncate } from './config-BadLPAp8.mjs';
+import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, E as Exports, D as DurableObjectExport, W as WorkerEntrypointExport, c as WorkerMetadataBinding, L as Logger, d as Route } from './config-BEcnaWpD.mjs';
+export { bM as ApiCredentials, aH as AssetConfigMetadata, A as Assets, aI as AssetsOptions, b0 as AsyncHook, aX as BinaryFile, bf as COMPLIANCE_REGION_CONFIG_PUBLIC, bg as COMPLIANCE_REGION_CONFIG_UNKNOWN, z as CacheOptions, Y as CfAIBinding, aa as CfAISearch, a9 as CfAISearchNamespace, aZ as CfAccount, ac as CfAgentMemory, ao as CfAnalyticsEngineDataset, ae as CfArtifacts, at as CfAssetsBinding, X as CfBrowserBinding, aw as CfCapnp, a7 as CfD1Database, a2 as CfDataBlobBindings, ak as CfDevPluginCfg, ap as CfDispatchNamespace, a3 as CfDurableObject, ay as CfDurableObjectMigrations, az as CfExports, ag as CfFlagship, af as CfHelloWorld, aj as CfHyperdrive, _ as CfImagesBinding, M as CfKvNamespace, ar as CfLogfwdr, as as CfLogfwdrBinding, aq as CfMTlsCertificate, $ as CfMediaBinding, J as CfModule, I as CfModuleType, au as CfPipeline, aA as CfPlacement, a5 as CfQueue, a6 as CfR2Bucket, ai as CfRateLimit, H as CfScriptFormat, ad as CfSecretsStoreSecrets, N as CfSendEmailBindings, al as CfService, a0 as CfStreamBinding, aB as CfTailConsumer, V as CfTextBlobBindings, ax as CfUnsafe, av as CfUnsafeBinding, aC as CfUserLimits, K as CfVars, a8 as CfVectorize, a1 as CfVersionMetadataBinding, an as CfVpcNetwork, am as CfVpcService, Q as CfWasmModuleBindings, ab as CfWebSearch, aE as CfWorkerContext, aD as CfWorkerInit, ah as CfWorkerLoader, aF as CfWorkerSourceMap, a4 as CfWorkflow, o as CloudchamberConfig, be as ComplianceConfig, f as ConfigFields, x as ConfigModuleRuleType, s as ConfiguredExport, p as ContainerApp, G as ContainerEngine, n as CustomDomainRoute, y as DispatchNamespaceOutbound, F as DockerConfiguration, t as DurableObjectBindings, r as DurableObjectExportStorage, q as DurableObjectMigration, b7 as ENVIRONMENT_TAG_PREFIX, b4 as Entry, k as Environment, v as EnvironmentNonInheritable, aM as ExportsReconciliationEntryBase, aP as ExportsReconciliationErrorDetail, aN as ExportsReconciliationInfo, aQ as ExportsReconciliationRename, aT as ExportsReconciliationResult, aR as ExportsReconciliationTransfer, aS as ExportsReconciliationTransferPending, aO as ExportsReconciliationWarning, c4 as FetchKVGetValueFetcher, bP as FetchListResultFetcher, bQ as FetchPagedListResultFetcher, bN as FetchResult, bO as FetchResultFetcher, aW as File, a$ as Hook, a_ as HookValues, b5 as INHERIT_SYMBOL, b9 as JSON_CONFIG_FORMATS, aG as Json, i as LOGGER_LEVELS, aK as LegacyAssetPaths, l as LocalS3Credentials, b1 as LogLevel, j as LoggerLevel, b2 as NodeJSCompatMode, O as Observability, b8 as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, e as RawDevConfig, g as RawEnvironment, a as RedirectedRawConfig, w as Rule, b6 as SERVICE_TAG_PREFIX, aV as ServiceFetch, aU as ServiceMetadataRes, b3 as StartDevWorkerInput, S as StreamingTailConsumer, T as TailConsumer, aY as Trigger, U as UserLimits, aJ as ValidatedAssetsOptions, aL as WorkerMetadata, u as WorkflowBinding, Z as ZoneIdRoute, m as ZoneNameRoute, c1 as addAuthorizationHeader, h as defaultWranglerConfig, b_ as extractAccountTag, bZ as extractWAFBlockRayId, bS as fetchInternalBase, c3 as fetchKVGetValueBase, bU as fetchListResultBase, bT as fetchResultBase, bH as getBrowserRenderingHeadfulFromEnv, bs as getBuildConditionsFromEnv, bt as getBuildPlatformFromEnv, ba as getC3CommandFromEnv, bq as getCIGeneratePreviewAlias, bn as getCIMatchTag, bo as getCIOverrideName, bp as getCIOverrideNetworkModeHost, bI as getCfFetchEnabledFromEnv, bJ as getCfFetchPathFromEnv, bi as getCloudflareApiBaseUrl, bd as getCloudflareApiEnvironmentFromEnv, bh as getCloudflareComplianceRegion, bD as getCloudflareEnv, bz as getCloudflareIncludeProcessEnvFromEnv, by as getCloudflareLoadDevVarsFromDotEnv, bL as getCloudflaredPathFromEnv, bj as getComplianceRegionSubdomain, bv as getD1ExtraLocationChoices, bB as getDisableConfigWatching, bw as getDockerPath, bF as getLocalExplorerEnabledFromEnv, bG as getLocalObservabilityEnabledFromEnv, bE as getOpenNextDeployFromEnv, bl as getOutputFileDirectoryFromEnv, bm as getOutputFilePathFromEnv, bu as getRegistryPath, bk as getSanitizeLogs, bx as getSubdomainMixedStateCheckDisabled, bA as getTraceHeader, br as getWorkersCIBranchName, bK as getWranglerCacheDirFromEnv, bC as getWranglerHideBanner, bc as getWranglerSendErrorReportsFromEnv, bb as getWranglerSendMetricsFromEnv, c5 as hasCursor, b$ as hasMorePages, bW as isWAFBlockResponse, c6 as maybeAddTraceHeader, bY as parseRetryAfterMs, bX as parseRetryAfterValue, bR as performApiFetchBase, c0 as renderError, c2 as throwFetchError, bV as truncate } from './config-BEcnaWpD.mjs';
 import * as jsoncParser from 'jsonc-parser';
 export { constructWranglerConfig } from './browser.mjs';
 export { GetGlobalConfigPathOptions, getGlobalConfigPath, getGlobalWranglerCachePath } from './global-wrangler-config-path.mjs';
@@ -283,8 +283,14 @@ declare class APIError extends ParseError {
     meta?: {
         details?: unknown;
     } & Record<string, unknown>;
-    constructor({ status, ...rest }: MessageInit & {
+    /**
+     * Optional number of milliseconds the API asked us to wait before retrying,
+     * derived from the response's `Retry-After` header (if present).
+     */
+    retryAfterMs?: number;
+    constructor({ status, retryAfterMs, ...rest }: MessageInit & {
         status?: number;
+        retryAfterMs?: number;
     });
     get status(): number | undefined;
     isGatewayError(): boolean;
@@ -560,6 +566,8 @@ type VariableNames =
  | "CLOUDFLARE_AUTH_USE_KEYRING"
 /** Enable the local explorer UI at /cdn-cgi/explorer (experimental, default: false). */
  | "X_LOCAL_EXPLORER"
+/** Enable local-dev observability capture (experimental, default: false). */
+ | "X_LOCAL_OBSERVABILITY"
 /** Open the browser in headful (visible) mode when using the Browser Run API in local dev (default: false). */
  | "X_BROWSER_HEADFUL"
 /** Override command used by `wrangler init` (default: "create cloudflare"). */
@@ -1016,9 +1024,29 @@ declare function getWorkerName(projectOrWorkerName: string | undefined, projectP
  */
 declare function getWorkerNameFromProject(projectPath: string): string;
 
+type DiscriminatedPath<Discriminator extends string> = string & {
+    _discriminator: Discriminator;
+};
+/**
+ * A branded string that expects to be URL compatible.
+ *
+ * Require this type when you want callers to ensure that they have converted file-path strings into URL-safe paths.
+ */
+type UrlPath = DiscriminatedPath<"UrlPath">;
+/**
+ * Convert a file-path string to a URL-path string.
+ *
+ * Use this helper to convert a `string` to a `UrlPath` when it is not clear whether the string needs normalizing.
+ * Replaces all back-slashes with forward-slashes, and throws an error if the path contains a drive letter (e.g. `C:`).
+ *
+ * @param filePath - The file path to convert
+ * @returns The URL-safe path
+ */
+declare function toUrlPath(filePath: string): UrlPath;
+
 /**
  * @deprecated new code should use getBindingTypeFriendlyName() instead
  */
 declare const friendlyBindingNames: Record<ConfigBindingFieldName, string>;
 
-export { APIError, Binding, type BindingLocalSupport, BunPackageManager, CommandLineArgsError, type CompatDate, Config, type ConfigBindingFieldName, type ConfigBindingOptions, type ConfigCache, type ConfigCacheOptions, DeprecationError, Diagnostics, DurableObjectExport, type EphemeralDirectory, type ExportType, Exports, FatalError, JsonFriendlyFatalError, type Location, Logger, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, NpmPackageManager, type NpmVersionCheckResult, NubPackageManager, type PackageJSON, type PackageManager, ParseError, type ParseFile, type PartitionedExports, PatchConfigError, PnpmPackageManager, RawConfig, type ResolveConfigPathOptions, Route, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerEntrypointExport, WorkerMetadataBinding, YarnPackageManager, assertNever, bucketFormatMessage, checkWorkerNameValidity, configFileName, configFormat, createConfigCache, createFatalError, experimental_patchConfig, experimental_readRawConfig, fetchLatestNpmVersion, findWranglerConfig, formatConfigSnippet, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getDurableObjectExports, getEnvironmentVariableFactory, getHostFromRoute, getHostFromUrl, getInstalledPackageVersion, getPackagePath, getTodaysCompatDate, getWorkerName, getWorkerNameFromProject, getWranglerHiddenDirPath, getWranglerTmpDir, getZoneFromRoute, hasDurableObjectExports, hasProperty, indexLocation, isCI, isCompatDate, isDockerfile, isInteractive, isNonInteractiveOrCI, isOptionalProperty, isPackageInstalled, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, openInBrowser, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveWranglerConfigPath, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, toValidWorkerName, validatePagesConfig };
+export { APIError, Binding, type BindingLocalSupport, BunPackageManager, CommandLineArgsError, type CompatDate, Config, type ConfigBindingFieldName, type ConfigBindingOptions, type ConfigCache, type ConfigCacheOptions, DeprecationError, Diagnostics, DurableObjectExport, type EphemeralDirectory, type ExportType, Exports, FatalError, JsonFriendlyFatalError, type Location, Logger, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, NpmPackageManager, type NpmVersionCheckResult, NubPackageManager, type PackageJSON, type PackageManager, ParseError, type ParseFile, type PartitionedExports, PatchConfigError, PnpmPackageManager, RawConfig, type ResolveConfigPathOptions, Route, type TelemetryMessage, type Tunnel, type TunnelOptions, type UrlPath, UserError, WorkerEntrypointExport, WorkerMetadataBinding, YarnPackageManager, assertNever, bucketFormatMessage, checkWorkerNameValidity, configFileName, configFormat, createConfigCache, createFatalError, experimental_patchConfig, experimental_readRawConfig, fetchLatestNpmVersion, findWranglerConfig, formatConfigSnippet, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getDurableObjectExports, getEnvironmentVariableFactory, getHostFromRoute, getHostFromUrl, getInstalledPackageVersion, getPackagePath, getTodaysCompatDate, getWorkerName, getWorkerNameFromProject, getWranglerHiddenDirPath, getWranglerTmpDir, getZoneFromRoute, hasDurableObjectExports, hasProperty, indexLocation, isCI, isCompatDate, isDockerfile, isInteractive, isNonInteractiveOrCI, isOptionalProperty, isPackageInstalled, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, openInBrowser, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveWranglerConfigPath, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, toUrlPath, toValidWorkerName, validatePagesConfig };

package/dist/index.mjs

@@ -2,8 +2,8 @@ export { assertNever, constructWranglerConfig, getTodaysCompatDate, isCompatDate
 import { getGlobalConfigPath } from './chunk-34VZWBGB.mjs';
 export { getGlobalConfigPath, getGlobalWranglerCachePath } from './chunk-34VZWBGB.mjs';
 export { MetricsRegistry } from './chunk-Z62CVNHJ.mjs';
-import { partitionExports, UserError, dedent, isRedirectedRawConfig, configFileName, formatConfigSnippet, FatalError, parsePackageJSON, readFileSync, ParseError, parseJSON, APIError, dir, parseTOML, modify, applyEdits, format, dist_default, parseJSONC } from './chunk-Y3JVLYM6.mjs';
-export { APIError, CommandLineArgsError, DeprecationError, ENVIRONMENT_TAG_PREFIX, FatalError, INHERIT_SYMBOL, JSON_CONFIG_FORMATS, JsonFriendlyFatalError, MissingConfigError, PATH_TO_DEPLOY_CONFIG, ParseError, SERVICE_TAG_PREFIX, UserError, configFileName, configFormat, createFatalError, experimental_readRawConfig, findWranglerConfig, formatConfigSnippet, indexLocation, isRedirectedConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveWranglerConfigPath, searchLocation } from './chunk-Y3JVLYM6.mjs';
+import { partitionExports, UserError, isRedirectedRawConfig, dedent, configFileName, formatConfigSnippet, FatalError, parsePackageJSON, readFileSync, ParseError, parseJSON, APIError, dir, parseTOML, modify, applyEdits, format, dist_default, parseJSONC } from './chunk-3K53PSCY.mjs';
+export { APIError, CommandLineArgsError, DeprecationError, ENVIRONMENT_TAG_PREFIX, FatalError, INHERIT_SYMBOL, JSON_CONFIG_FORMATS, JsonFriendlyFatalError, MissingConfigError, PATH_TO_DEPLOY_CONFIG, ParseError, SERVICE_TAG_PREFIX, UserError, configFileName, configFormat, createFatalError, experimental_readRawConfig, findWranglerConfig, formatConfigSnippet, indexLocation, isRedirectedConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, partitionExports, readFileSync, readFileSyncToBuffer, resolveWranglerConfigPath, searchLocation } from './chunk-3K53PSCY.mjs';
 import { isDirectory, removeDirSync } from './chunk-53IMCORZ.mjs';
 export { isDirectory, removeDir, removeDirSync } from './chunk-53IMCORZ.mjs';
 import { __commonJS, __name, __require, __export, __toESM } from './chunk-Q72B4Q5Z.mjs';
@@ -18,6 +18,7 @@ import { fetch, Headers, FormData, Response } from 'undici';
 import { URLSearchParams } from 'node:url';
 import * as timersPromises from 'node:timers/promises';
 import { setTimeout as setTimeout$1 } from 'node:timers/promises';
+import { assert as assert$1 } from 'node:console';
 
 // ../../node_modules/.pnpm/ci-info@4.4.0/node_modules/ci-info/vendors.json
 var require_vendors = __commonJS({
@@ -16992,6 +16993,10 @@ var getLocalExplorerEnabledFromEnv = getBooleanEnvironmentVariableFactory({
   variableName: "X_LOCAL_EXPLORER",
   defaultValue: true
 });
+var getLocalObservabilityEnabledFromEnv = getBooleanEnvironmentVariableFactory({
+  variableName: "X_LOCAL_OBSERVABILITY",
+  defaultValue: false
+});
 var getBrowserRenderingHeadfulFromEnv = getBooleanEnvironmentVariableFactory({
   variableName: "X_BROWSER_HEADFUL",
   defaultValue: false
@@ -17520,14 +17525,21 @@ function normalizeAndValidateConfig(rawConfig, configPath, userConfigPath, args,
   const diagnostics = new Diagnostics(
     `Processing ${configPath ? path2__default.relative(process.cwd(), configPath) : "wrangler"} configuration:`
   );
+  const isRedirectedConfig2 = isRedirectedRawConfig(
+    rawConfig,
+    configPath,
+    userConfigPath
+  );
   if ("legacy_env" in rawConfig) {
-    diagnostics.errors.push(
-      dedent`
-				The "legacy_env" field is no longer supported, so please remove it from your configuration file.
-				Service environments have been removed, and each environment is now deployed as its own Worker named "<name>-<environment>". This matches the behaviour of "legacy_env = true", which was the default, so removing the field will not change how your Worker is deployed.
-				Refer to https://developers.cloudflare.com/workers/wrangler/environments/ for more information.
-			`
-    );
+    if (!isRedirectedConfig2) {
+      diagnostics.errors.push(
+        dedent`
+					The "legacy_env" field is no longer supported, so please remove it from your configuration file.
+					Service environments have been removed, and each environment is now deployed as its own Worker named "<name>-<environment>". This matches the behaviour of "legacy_env = true", which was the default, so removing the field will not change how your Worker is deployed.
+					Refer to https://developers.cloudflare.com/workers/wrangler/environments/ for more information.
+				`
+      );
+    }
     delete rawConfig.legacy_env;
   }
   validateOptionalProperty(
@@ -17603,11 +17615,6 @@ function normalizeAndValidateConfig(rawConfig, configPath, userConfigPath, args,
     isDispatchNamespace,
     preserveOriginalMain
   );
-  const isRedirectedConfig2 = isRedirectedRawConfig(
-    rawConfig,
-    configPath,
-    userConfigPath
-  );
   const definedEnvironments = Object.keys(rawConfig.env ?? {});
   if (isRedirectedConfig2 && definedEnvironments.length > 0) {
     diagnostics.errors.push(
@@ -20592,12 +20599,47 @@ var validateR2Binding = /* @__PURE__ */ __name((diagnostics, field, value) => {
   if (!isRemoteValid(value, field, diagnostics)) {
     isValid = false;
   }
+  if (hasProperty(value, "local_dev")) {
+    const localDev = value.local_dev;
+    if (typeof localDev !== "object" || localDev === null) {
+      diagnostics.errors.push(
+        `"${field}" bindings should, optionally, have an object "local_dev" field but got ${JSON.stringify(
+          value
+        )}.`
+      );
+      isValid = false;
+    } else {
+      experimental(
+        diagnostics,
+        { local_dev: localDev },
+        "local_dev.experimental_s3_credentials"
+      );
+      if (hasProperty(localDev, "experimental_s3_credentials")) {
+        const credentials = localDev.experimental_s3_credentials;
+        if (typeof credentials !== "object" || credentials === null || !isRequiredProperty(credentials, "accessKeyId", "string") || !isRequiredProperty(credentials, "secretAccessKey", "string")) {
+          diagnostics.errors.push(
+            `"${field}" bindings should, optionally, have a "local_dev.experimental_s3_credentials" field with string "accessKeyId" and "secretAccessKey" fields, but got ${JSON.stringify(
+              value
+            )}.`
+          );
+          isValid = false;
+        }
+      }
+      validateAdditionalProperties(
+        diagnostics,
+        `${field}.local_dev`,
+        Object.keys(localDev),
+        ["experimental_s3_credentials"]
+      );
+    }
+  }
   validateAdditionalProperties(diagnostics, field, Object.keys(value), [
     "binding",
     "bucket_name",
     "preview_bucket_name",
     "jurisdiction",
-    "remote"
+    "remote",
+    "local_dev"
   ]);
   return isValid;
 }, "validateR2Binding");
@@ -24052,6 +24094,7 @@ async function fetchInternalBase(complianceConfig, resource, init = {}, userAgen
   logHeaders(response.headers, logger);
   logger.debugWithSanitization?.("RESPONSE:", jsonText);
   logger.debug("-- END CF API RESPONSE");
+  const retryAfterMs = parseRetryAfterMs(response.headers);
   if (!jsonText && (response.status === 204 || response.status === 205)) {
     return {
       response: {
@@ -24060,7 +24103,8 @@ async function fetchInternalBase(complianceConfig, resource, init = {}, userAgen
         errors: [],
         messages: []
       },
-      status: response.status
+      status: response.status,
+      retryAfterMs
     };
   }
   if (isWAFBlockResponse(response.headers)) {
@@ -24069,12 +24113,13 @@ async function fetchInternalBase(complianceConfig, resource, init = {}, userAgen
       method,
       resource,
       response.status,
-      response.statusText
+      response.statusText,
+      retryAfterMs
     );
   }
   try {
     const json2 = parseJSON(jsonText);
-    return { response: json2, status: response.status };
+    return { response: json2, status: response.status, retryAfterMs };
   } catch {
     const rayId = extractWAFBlockRayId(response.headers);
     throw new APIError({
@@ -24089,13 +24134,18 @@ async function fetchInternalBase(complianceConfig, resource, init = {}, userAgen
         ...rayId ? [{ text: `Cloudflare Ray ID: ${rayId}` }] : []
       ],
       status: response.status,
+      retryAfterMs,
       telemetryMessage: false
     });
   }
 }
 __name(fetchInternalBase, "fetchInternalBase");
 async function fetchResultBase(complianceConfig, resource, init = {}, userAgent, logger, queryParams, abortSignal, credentials) {
-  const { response: json2, status } = await fetchInternalBase(
+  const {
+    response: json2,
+    status,
+    retryAfterMs
+  } = await fetchInternalBase(
     complianceConfig,
     resource,
     init,
@@ -24108,7 +24158,7 @@ async function fetchResultBase(complianceConfig, resource, init = {}, userAgent,
   if (json2.success) {
     return json2.result;
   } else {
-    throwFetchError(resource, json2, status);
+    throwFetchError(resource, json2, status, retryAfterMs);
   }
 }
 __name(fetchResultBase, "fetchResultBase");
@@ -24121,7 +24171,11 @@ async function fetchListResultBase(complianceConfig, resource, init = {}, userAg
       queryParams = new URLSearchParams(queryParams);
       queryParams.set("cursor", cursor);
     }
-    const { response: json2, status } = await fetchInternalBase(
+    const {
+      response: json2,
+      status,
+      retryAfterMs
+    } = await fetchInternalBase(
       complianceConfig,
       resource,
       init,
@@ -24139,7 +24193,7 @@ async function fetchListResultBase(complianceConfig, resource, init = {}, userAg
         getMoreResults = false;
       }
     } else {
-      throwFetchError(resource, json2, status);
+      throwFetchError(resource, json2, status, retryAfterMs);
     }
   }
   return results;
@@ -24157,6 +24211,24 @@ function isWAFBlockResponse(headers) {
   return headers.get("cf-mitigated") === "challenge";
 }
 __name(isWAFBlockResponse, "isWAFBlockResponse");
+function parseRetryAfterValue(retryAfter) {
+  if (!retryAfter) {
+    return void 0;
+  }
+  if (/^\d+$/.test(retryAfter.trim())) {
+    return Number(retryAfter) * 1e3;
+  }
+  const retryAfterDate = new Date(retryAfter);
+  if (!Number.isNaN(retryAfterDate.getTime())) {
+    return Math.max(0, retryAfterDate.getTime() - Date.now());
+  }
+  return void 0;
+}
+__name(parseRetryAfterValue, "parseRetryAfterValue");
+function parseRetryAfterMs(headers) {
+  return parseRetryAfterValue(headers.get("Retry-After"));
+}
+__name(parseRetryAfterMs, "parseRetryAfterMs");
 function extractWAFBlockRayId(headers) {
   return headers.get("cf-ray") ?? void 0;
 }
@@ -24236,7 +24308,7 @@ function escapeCharacter(character) {
   }).join("");
 }
 __name(escapeCharacter, "escapeCharacter");
-function throwFetchError(resource, response, status) {
+function throwFetchError(resource, response, status, retryAfterMs) {
   const errors = response.errors ?? [];
   for (const error52 of errors) {
     maybeThrowFriendlyError(error52);
@@ -24254,10 +24326,19 @@ function throwFetchError(resource, response, status) {
       notes.push({ text: fallbackMessage });
     }
   }
+  if (retryAfterMs !== void 0) {
+    notes.push({
+      text: `The API responded with a "Retry-After" header indicating you should wait ${Math.ceil(retryAfterMs / 1e3)} second(s) before retrying.`
+    });
+  }
   const error51 = new APIError({
     text: `A request to the Cloudflare API (${resource}) failed.`,
     notes,
     status,
+    // hoist the parsed `Retry-After` header (if any) so consumers such as
+    // `retryOnAPIFailure()` can back off for the amount of time the API
+    // asked us to wait, e.g. when rate limited (HTTP 429).
+    retryAfterMs,
     telemetryMessage: false
   });
   const code = errors[0]?.code;
@@ -24272,7 +24353,7 @@ function throwFetchError(resource, response, status) {
   throw error51;
 }
 __name(throwFetchError, "throwFetchError");
-function throwWAFBlockError(headers, method, resource, status, statusText) {
+function throwWAFBlockError(headers, method, resource, status, statusText, retryAfterMs) {
   const rayId = extractWAFBlockRayId(headers);
   throw new APIError({
     text: "The Cloudflare API responded with a WAF block page instead of the expected JSON response",
@@ -24289,6 +24370,7 @@ function throwWAFBlockError(headers, method, resource, status, statusText) {
       }
     ],
     status,
+    retryAfterMs,
     telemetryMessage: false
   });
 }
@@ -24401,23 +24483,41 @@ ${url2}`
 }
 __name(handleBrowserOpenError, "handleBrowserOpenError");
 var MAX_ATTEMPTS = 3;
+var MAX_RETRY_AFTER_MS = 6e4;
 async function retryOnAPIFailure(action, logger, backoff = 0, attempts = MAX_ATTEMPTS, abortSignal) {
   try {
     return await action();
   } catch (err) {
     if (err instanceof APIError) {
-      if (!err.isRetryable()) {
+      if (!err.isRetryable() && err.status !== 429) {
         throw err;
       }
     } else if (err instanceof DOMException && err.name === "TimeoutError") ; else if (!(err instanceof TypeError)) {
       throw err;
     }
-    logger.debug(`Retrying API call after error...`);
-    logger.debug(err);
+    const retryAfterMs = err instanceof APIError ? err.retryAfterMs : void 0;
+    if (retryAfterMs !== void 0 && retryAfterMs > MAX_RETRY_AFTER_MS) {
+      throw err;
+    }
     if (attempts <= 1) {
       throw err;
     }
-    await setTimeout$1(backoff, void 0, { signal: abortSignal });
+    const jitter = Math.random() * 1e3;
+    let wait = backoff;
+    if (retryAfterMs !== void 0) {
+      wait = retryAfterMs + jitter;
+    } else if (err instanceof APIError && err.status === 429) {
+      wait = Math.max(backoff, 1e3) + jitter;
+    }
+    if (retryAfterMs !== void 0) {
+      logger.info(
+        `Received a "Retry-After" header from the Cloudflare API. Waiting ${Math.ceil(retryAfterMs / 1e3)} second(s) before retrying...`
+      );
+    } else {
+      logger.debug(`Retrying API call after error...`);
+      logger.debug(err);
+    }
+    await setTimeout$1(wait, void 0, { signal: abortSignal });
     return retryOnAPIFailure(
       action,
       logger,
@@ -24564,6 +24664,14 @@ function getWorkerNameFromProject(projectPath) {
   return getWorkerName(packageJsonName, projectPath);
 }
 __name(getWorkerNameFromProject, "getWorkerNameFromProject");
+function toUrlPath(filePath) {
+  assert$1(
+    !/^[a-z]:/i.test(filePath),
+    "Tried to convert a Windows file path with a drive to a URL path."
+  );
+  return filePath.replace(/\\/g, "/");
+}
+__name(toUrlPath, "toUrlPath");
 
 // src/index.ts
 var friendlyBindingNames2 = friendlyBindingNames;
@@ -24601,4 +24709,4 @@ safe-buffer/index.js:
   (*! safe-buffer. MIT License. Feross Aboukhadijeh <https://feross.org/opensource> *)
 */
 
-export { BunPackageManager, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, Diagnostics, LOGGER_LEVELS, NpmPackageManager, NubPackageManager, PatchConfigError, PnpmPackageManager, YarnPackageManager, addAuthorizationHeader, bucketFormatMessage, checkWorkerNameValidity, createConfigCache, defaultWranglerConfig, experimental_patchConfig, extractAccountTag, extractWAFBlockRayId, fetchInternalBase, fetchKVGetValueBase, fetchLatestNpmVersion, fetchListResultBase, fetchResultBase, formatTime, friendlyBindingNames2 as friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getBrowserRenderingHeadfulFromEnv, getBuildConditionsFromEnv, getBuildPlatformFromEnv, getC3CommandFromEnv, getCIGeneratePreviewAlias, getCIMatchTag, getCIOverrideName, getCIOverrideNetworkModeHost, getCfFetchEnabledFromEnv, getCfFetchPathFromEnv, getCloudflareApiBaseUrl, getCloudflareApiEnvironmentFromEnv, getCloudflareComplianceRegion, getCloudflareEnv, getCloudflareIncludeProcessEnvFromEnv, getCloudflareLoadDevVarsFromDotEnv, getCloudflaredPathFromEnv, getComplianceRegionSubdomain, getD1ExtraLocationChoices, getDisableConfigWatching, getDockerPath, getDurableObjectExports, getEnvironmentVariableFactory, getHostFromRoute, getHostFromUrl, getInstalledPackageVersion, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getPackagePath, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTraceHeader, getWorkerName, getWorkerNameFromProject, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHiddenDirPath, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, getWranglerTmpDir, getZoneFromRoute, hasCursor, hasDurableObjectExports, hasMorePages, hasProperty, isCI, isDockerfile, isInteractive, isNonInteractiveOrCI, isOptionalProperty, isPackageInstalled, isPagesConfig, isRequiredProperty, isValidR2BucketName, isWAFBlockResponse, maybeAddTraceHeader, normalizeAndValidateConfig, openInBrowser, performApiFetchBase, renderError, retryOnAPIFailure, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, throwFetchError, toValidWorkerName, truncate, validatePagesConfig };
+export { BunPackageManager, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, Diagnostics, LOGGER_LEVELS, NpmPackageManager, NubPackageManager, PatchConfigError, PnpmPackageManager, YarnPackageManager, addAuthorizationHeader, bucketFormatMessage, checkWorkerNameValidity, createConfigCache, defaultWranglerConfig, experimental_patchConfig, extractAccountTag, extractWAFBlockRayId, fetchInternalBase, fetchKVGetValueBase, fetchLatestNpmVersion, fetchListResultBase, fetchResultBase, formatTime, friendlyBindingNames2 as friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getBrowserRenderingHeadfulFromEnv, getBuildConditionsFromEnv, getBuildPlatformFromEnv, getC3CommandFromEnv, getCIGeneratePreviewAlias, getCIMatchTag, getCIOverrideName, getCIOverrideNetworkModeHost, getCfFetchEnabledFromEnv, getCfFetchPathFromEnv, getCloudflareApiBaseUrl, getCloudflareApiEnvironmentFromEnv, getCloudflareComplianceRegion, getCloudflareEnv, getCloudflareIncludeProcessEnvFromEnv, getCloudflareLoadDevVarsFromDotEnv, getCloudflaredPathFromEnv, getComplianceRegionSubdomain, getD1ExtraLocationChoices, getDisableConfigWatching, getDockerPath, getDurableObjectExports, getEnvironmentVariableFactory, getHostFromRoute, getHostFromUrl, getInstalledPackageVersion, getLocalExplorerEnabledFromEnv, getLocalObservabilityEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getPackagePath, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTraceHeader, getWorkerName, getWorkerNameFromProject, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHiddenDirPath, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, getWranglerTmpDir, getZoneFromRoute, hasCursor, hasDurableObjectExports, hasMorePages, hasProperty, isCI, isDockerfile, isInteractive, isNonInteractiveOrCI, isOptionalProperty, isPackageInstalled, isPagesConfig, isRequiredProperty, isValidR2BucketName, isWAFBlockResponse, maybeAddTraceHeader, normalizeAndValidateConfig, openInBrowser, parseRetryAfterMs, parseRetryAfterValue, performApiFetchBase, renderError, retryOnAPIFailure, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, throwFetchError, toUrlPath, toValidWorkerName, truncate, validatePagesConfig };