@cloudflare/workers-utils 0.22.1 → 0.23.1

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, W as WorkerMetadataBinding } from './config-CXobNAeT.mjs';
-export { aw as AssetConfigMetadata, A as Assets, ax as AssetsOptions, aD as BinaryFile, r as CacheOptions, I as CfAIBinding, a1 as CfAISearch, a0 as CfAISearchNamespace, a3 as CfAgentMemory, ae as CfAnalyticsEngineDataset, a5 as CfArtifacts, aj as CfAssetsBinding, H as CfBrowserBinding, am as CfCapnp, _ as CfD1Database, N as CfDataBlobBindings, af as CfDispatchNamespace, Q as CfDurableObject, ao as CfDurableObjectMigrations, a7 as CfFlagship, a6 as CfHelloWorld, aa as CfHyperdrive, J as CfImagesBinding, y as CfKvNamespace, ah as CfLogfwdr, ai as CfLogfwdrBinding, ag as CfMTlsCertificate, K as CfMediaBinding, w as CfModule, v as CfModuleType, ak as CfPipeline, ap as CfPlacement, X as CfQueue, Y as CfR2Bucket, a9 as CfRateLimit, u as CfScriptFormat, a4 as CfSecretsStoreSecrets, z as CfSendEmailBindings, ab as CfService, L as CfStreamBinding, aq as CfTailConsumer, G as CfTextBlobBindings, an as CfUnsafe, al as CfUnsafeBinding, ar as CfUserLimits, x as CfVars, $ as CfVectorize, M as CfVersionMetadataBinding, ad as CfVpcNetwork, ac as CfVpcService, F as CfWasmModuleBindings, a2 as CfWebSearch, at as CfWorkerContext, as as CfWorkerInit, a8 as CfWorkerLoader, au as CfWorkerSourceMap, V as CfWorkflow, j as CloudchamberConfig, d as ConfigFields, p as ConfigModuleRuleType, k as ContainerApp, t as ContainerEngine, h as CustomDomainRoute, q as DispatchNamespaceOutbound, s as DockerConfiguration, l as DurableObjectBindings, D as DurableObjectMigration, aI as ENVIRONMENT_TAG_PREFIX, aF as Entry, E as Environment, n as EnvironmentNonInheritable, aC as File, aG as INHERIT_SYMBOL, aK as JSON_CONFIG_FORMATS, av as Json, ay as LegacyAssetPaths, O as Observability, aJ as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, c as RawDevConfig, e as RawEnvironment, a as RedirectedRawConfig, i as Route, o as Rule, aH as SERVICE_TAG_PREFIX, aB as ServiceFetch, aA as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, aE as Trigger, U as UserLimits, az as WorkerMetadata, m as WorkflowBinding, Z as ZoneIdRoute, g as ZoneNameRoute, f as defaultWranglerConfig } from './config-CXobNAeT.mjs';
+import { C as ComputedFields, B as Binding, R as RawConfig, b as Config, W as WorkerMetadataBinding, L as Logger, c as Route } from './config-DrgFpZpF.mjs';
+export { bv as ApiCredentials, az as AssetConfigMetadata, A as Assets, aA as AssetsOptions, aM as AsyncHook, aH as BinaryFile, a$ as COMPLIANCE_REGION_CONFIG_PUBLIC, b0 as COMPLIANCE_REGION_CONFIG_UNKNOWN, t as CacheOptions, K as CfAIBinding, a4 as CfAISearch, a3 as CfAISearchNamespace, aJ as CfAccount, a6 as CfAgentMemory, ah as CfAnalyticsEngineDataset, a8 as CfArtifacts, am as CfAssetsBinding, J as CfBrowserBinding, ap as CfCapnp, a1 as CfD1Database, X as CfDataBlobBindings, ai as CfDispatchNamespace, Y as CfDurableObject, ar as CfDurableObjectMigrations, aa as CfFlagship, a9 as CfHelloWorld, ad as CfHyperdrive, M as CfImagesBinding, F as CfKvNamespace, ak as CfLogfwdr, al as CfLogfwdrBinding, aj as CfMTlsCertificate, N as CfMediaBinding, y as CfModule, x as CfModuleType, an as CfPipeline, as as CfPlacement, $ as CfQueue, a0 as CfR2Bucket, ac as CfRateLimit, w as CfScriptFormat, a7 as CfSecretsStoreSecrets, G as CfSendEmailBindings, ae as CfService, Q as CfStreamBinding, at as CfTailConsumer, I as CfTextBlobBindings, aq as CfUnsafe, ao as CfUnsafeBinding, au as CfUserLimits, z as CfVars, a2 as CfVectorize, V as CfVersionMetadataBinding, ag as CfVpcNetwork, af as CfVpcService, H as CfWasmModuleBindings, a5 as CfWebSearch, aw as CfWorkerContext, av as CfWorkerInit, ab as CfWorkerLoader, ax as CfWorkerSourceMap, _ as CfWorkflow, l as CloudchamberConfig, a_ as ComplianceConfig, e as ConfigFields, r as ConfigModuleRuleType, m as ContainerApp, v as ContainerEngine, k as CustomDomainRoute, s as DispatchNamespaceOutbound, u as DockerConfiguration, n as DurableObjectBindings, D as DurableObjectMigration, aT as ENVIRONMENT_TAG_PREFIX, aQ as Entry, E as Environment, p as EnvironmentNonInheritable, bN as FetchKVGetValueFetcher, by as FetchListResultFetcher, bz as FetchPagedListResultFetcher, bw as FetchResult, bx as FetchResultFetcher, aG as File, aL as Hook, aK as HookValues, aR as INHERIT_SYMBOL, aV as JSON_CONFIG_FORMATS, ay as Json, h as LOGGER_LEVELS, aC as LegacyAssetPaths, aN as LogLevel, i as LoggerLevel, aO as NodeJSCompatMode, O as Observability, aU as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, d as RawDevConfig, f as RawEnvironment, a as RedirectedRawConfig, q as Rule, aS as SERVICE_TAG_PREFIX, aF as ServiceFetch, aE as ServiceMetadataRes, aP as StartDevWorkerInput, S as StreamingTailConsumer, T as TailConsumer, aI as Trigger, U as UserLimits, aB as ValidatedAssetsOptions, aD as WorkerMetadata, o as WorkflowBinding, Z as ZoneIdRoute, j as ZoneNameRoute, bK as addAuthorizationHeader, g as defaultWranglerConfig, bH as extractAccountTag, bG as extractWAFBlockRayId, bB as fetchInternalBase, bM as fetchKVGetValueBase, bD as fetchListResultBase, bC as fetchResultBase, bq as getBrowserRenderingHeadfulFromEnv, bc as getBuildConditionsFromEnv, bd as getBuildPlatformFromEnv, aW as getC3CommandFromEnv, ba as getCIGeneratePreviewAlias, b7 as getCIMatchTag, b8 as getCIOverrideName, b9 as getCIOverrideNetworkModeHost, br as getCfFetchEnabledFromEnv, bs as getCfFetchPathFromEnv, b2 as getCloudflareApiBaseUrl, aZ as getCloudflareApiEnvironmentFromEnv, b1 as getCloudflareComplianceRegion, bn as getCloudflareEnv, bj as getCloudflareIncludeProcessEnvFromEnv, bi as getCloudflareLoadDevVarsFromDotEnv, bu as getCloudflaredPathFromEnv, b3 as getComplianceRegionSubdomain, bf as getD1ExtraLocationChoices, bl as getDisableConfigWatching, bg as getDockerPath, bp as getLocalExplorerEnabledFromEnv, bo as getOpenNextDeployFromEnv, b5 as getOutputFileDirectoryFromEnv, b6 as getOutputFilePathFromEnv, be as getRegistryPath, b4 as getSanitizeLogs, bh as getSubdomainMixedStateCheckDisabled, bk as getTraceHeader, bb as getWorkersCIBranchName, bt as getWranglerCacheDirFromEnv, bm as getWranglerHideBanner, aY as getWranglerSendErrorReportsFromEnv, aX as getWranglerSendMetricsFromEnv, bO as hasCursor, bI as hasMorePages, bF as isWAFBlockResponse, bP as maybeAddTraceHeader, bA as performApiFetchBase, bJ as renderError, bL as throwFetchError, bE as truncate } from './config-DrgFpZpF.mjs';
 import * as jsoncParser from 'jsonc-parser';
 export { constructWranglerConfig } from './browser.mjs';
 export { Counter, MetricsRegistry } from './prometheus-metrics.mjs';
 import { ChildProcess } from 'node:child_process';
-import { URLSearchParams } from 'node:url';
-import { RequestInit, Response, Headers } from 'undici';
+import 'node:url';
+import 'undici';
 import '@cloudflare/workers-shared';
 import 'cloudflare';
 
@@ -92,7 +92,7 @@ declare const bucketFormatMessage = "Bucket names must begin and end with an alp
  * Config field names for bindings (e.g., "kv_namespaces", "d1_databases").
  * These are the keys used in Wrangler's config file
  */
-type ConfigBindingFieldName = "data_blobs" | "durable_objects" | "kv_namespaces" | "send_email" | "queues" | "d1_databases" | "vectorize" | "ai_search_namespaces" | "ai_search" | "web_search" | "agent_memory" | "hyperdrive" | "r2_buckets" | "logfwdr" | "services" | "analytics_engine_datasets" | "text_blobs" | "browser" | "ai" | "images" | "stream" | "media" | "version_metadata" | "unsafe" | "vars" | "wasm_modules" | "dispatch_namespaces" | "mtls_certificates" | "workflows" | "pipelines" | "secrets_store_secrets" | "artifacts" | "ratelimits" | "assets" | "unsafe_hello_world" | "flagship" | "worker_loaders" | "vpc_services" | "vpc_networks";
+type ConfigBindingFieldName = "data_blobs" | "durable_objects" | "kv_namespaces" | "send_email" | "queues" | "d1_databases" | "vectorize" | "ai_search_namespaces" | "ai_search" | "websearch" | "agent_memory" | "hyperdrive" | "r2_buckets" | "logfwdr" | "services" | "analytics_engine_datasets" | "text_blobs" | "browser" | "ai" | "images" | "stream" | "media" | "version_metadata" | "unsafe" | "vars" | "wasm_modules" | "dispatch_namespaces" | "mtls_certificates" | "workflows" | "pipelines" | "secrets_store_secrets" | "artifacts" | "ratelimits" | "assets" | "unsafe_hello_world" | "flagship" | "worker_loaders" | "vpc_services" | "vpc_networks";
 /**
  * @deprecated new code should use getBindingTypeFriendlyName() instead
  */
@@ -557,248 +557,35 @@ declare function getEnvironmentVariableFactory<Choices extends readonly string[]
     readonly choices?: Choices;
 }): () => ElementType<Choices>;
 
+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;
+}
 /**
- * `WRANGLER_C3_COMMAND` can override the command used by `wrangler init` when delegating to C3.
- *
- * By default this will use `create cloudflare`.
- *
- * To run against the beta release of C3 use:
- *
- * ```sh
- * # Tell Wrangler to use the beta version of create-cloudflare
- * WRANGLER_C3_COMMAND="create cloudflare@beta" npx wrangler init
- * ```
- *
- * To test the integration between wrangler and C3 locally, use:
- *
- * ```sh
- * # Ensure both Wrangler and C3 are built
- * npm run build
- * # Tell Wrangler to use the local version of create-cloudflare
- * WRANGLER_C3_COMMAND="exec ./packages/create-cloudflare" npx wrangler init temp
- * ```
- *
- * Note that you cannot use `WRANGLER_C3_COMMAND="create cloudflare@2"` if you are
- * running Wrangler from inside the monorepo as the bin paths get messed up.
- */
-declare const getC3CommandFromEnv: () => string;
-/**
- * `WRANGLER_SEND_METRICS` can override whether we attempt to send metrics information to Sparrow.
- */
-declare const getWranglerSendMetricsFromEnv: () => boolean | undefined;
-/**
- * `WRANGLER_SEND_ERROR_REPORTS` controls whether we attempt to send error reports to Sentry.
- *
- * Defaults to `false` to avoid noisy false-positive reports. Users can opt in
- * by setting `WRANGLER_SEND_ERROR_REPORTS=true`.
- */
-declare const getWranglerSendErrorReportsFromEnv: () => boolean;
-/**
- * Set `WRANGLER_API_ENVIRONMENT` environment variable to "staging" to tell Wrangler to hit the staging APIs rather than production.
- */
-declare const getCloudflareApiEnvironmentFromEnv: () => "staging" | "production";
-/**
- * The compliance region to use for the API requests.
- */
-type ComplianceConfig = Partial<Pick<Config, "compliance_region">>;
-/** Used for commands that explicitly do not support compliance regions other than "public" */
-declare const COMPLIANCE_REGION_CONFIG_PUBLIC: ComplianceConfig;
-/**
- * Used for commands where there is no configuration available and
- * we rely upon the CLOUDFLARE_COMPLIANCE_REGION environment variable
- * to determine the compliance region.
- */
-declare const COMPLIANCE_REGION_CONFIG_UNKNOWN: ComplianceConfig;
-/**
- * Set `CLOUDFLARE_COMPLIANCE_REGION` environment variable to "fedramp_high"
- * or set the `compliance_region` property in the Wrangler configuration
- * to tell Wrangler to run in FedRAMP High compliance region mode, rather than "public" mode.
- */
-declare const getCloudflareComplianceRegion: (complianceConfig: ComplianceConfig) => "public" | "fedramp_high";
-/**
- * `CLOUDFLARE_API_BASE_URL` specifies the URL to the Cloudflare API.
- *
- * If this environment variable is not set, it will default to a URL computed from the
- * Cloudflare compliance region and the API environment.
- */
-declare const getCloudflareApiBaseUrl: (complianceConfig: ComplianceConfig) => string;
-/**
- * Compute the subdomain for the compliance region.
- */
-declare function getComplianceRegionSubdomain(complianceConfig: ComplianceConfig): string;
-/**
- * `WRANGLER_LOG_SANITIZE` specifies whether we sanitize debug logs.
- *
- * By default we do, since debug logs could be added to GitHub issues and shouldn't include sensitive information.
- */
-declare const getSanitizeLogs: () => boolean;
-/**
- * `WRANGLER_OUTPUT_FILE_DIRECTORY` specifies a directory where we should write a file containing output data in ND-JSON format.
- *
- * If this is set a random file will be created in this directory, and certain Wrangler commands will write entries to this file.
- * This is overridden by the `WRANGLER_OUTPUT_FILE_PATH` environment variable.
- */
-declare const getOutputFileDirectoryFromEnv: () => string | undefined;
-/**
- * `WRANGLER_OUTPUT_FILE_PATH` specifies a path to a file where we should write output data in ND-JSON format.
- *
- * If this is set certain Wrangler commands will write entries to this file.
- * This overrides the `WRANGLER_OUTPUT_FILE_DIRECTORY` environment variable.
- */
-declare const getOutputFilePathFromEnv: () => string | undefined;
-/**
- * `WRANGLER_CI_MATCH_TAG` specifies a Worker tag
- *
- * If this is set, Wrangler will ensure the Worker being targeted has this tag
- */
-declare const getCIMatchTag: () => string | undefined;
-/**
- * `WRANGLER_CI_OVERRIDE_NAME` specifies a Worker name
- *
- * If this is set, Wrangler will override the Worker name with this one
- */
-declare const getCIOverrideName: () => string | undefined;
-/**
- * `WRANGLER_CI_OVERRIDE_NETWORK_MODE_HOST` specifies whether --network=host should be set
- *
- * If this is set to true, Wrangler will use the --network=host flag when calling out to docker to build container images
- */
-declare const getCIOverrideNetworkModeHost: () => string | undefined;
-/**
- * `WRANGLER_CI_GENERATE_PREVIEW_ALIAS` specifies whether to generate a preview alias during version upload
- *
- * If this is set to true, Wrangler will attempt to autogenerate the preview alias by using the branch
- * name. If the branch name is too long and an alias cannot be created, a warning will be printed to the console.
- */
-declare const getCIGeneratePreviewAlias: () => "true" | "false";
-/**
- * `WORKERS_CI_BRANCH` is the branch name exposed by Workers CI
- *
- */
-declare const getWorkersCIBranchName: () => string | undefined;
-/**
- * `WRANGLER_BUILD_CONDITIONS` specifies the "build conditions" to use when importing packages at build time.
- *
- * See https://nodejs.org/api/packages.html#conditional-exports
- * and https://esbuild.github.io/api/#how-conditions-work.
- *
- * If this is set, Wrangler will configure esbuild to use this list of conditions.
- * The format is a string of comma separated conditions.
- */
-declare const getBuildConditionsFromEnv: () => string | undefined;
-/**
- * `WRANGLER_BUILD_PLATFORM` specifies the "build platform" to use when importing packages at build time.
- *
- * See https://esbuild.github.io/api/#platform
- * and https://esbuild.github.io/api/#how-conditions-work.
- *
- * If this is set, Wrangler will configure esbuild to use this platform.
- */
-declare const getBuildPlatformFromEnv: () => string | undefined;
-/**
- * `WRANGLER_REGISTRY_PATH` specifies the file based dev registry folder
- */
-declare const getRegistryPath: () => string;
-/**
- * `WRANGLER_D1_EXTRA_LOCATION_CHOICES` is an internal variable to let D1 team target their testing environments.
- *
- * External accounts cannot access testing environments, so should not set this variable.
- */
-declare const getD1ExtraLocationChoices: () => string | undefined;
-/**
- * `WRANGLER_DOCKER_BIN` specifies the path to a docker binary.
- *
- * By default it's `docker`.
- */
-declare const getDockerPath: () => string;
-declare const getSubdomainMixedStateCheckDisabled: () => boolean;
-/**
-/**
- * `CLOUDFLARE_LOAD_DEV_VARS_FROM_DOT_ENV` specifies whether to load vars for local dev from `.env` files.
- */
-declare const getCloudflareLoadDevVarsFromDotEnv: () => boolean;
-/**
- * `CLOUDFLARE_INCLUDE_PROCESS_ENV` specifies whether to include the `process.env` in vars loaded from `.env` for local development.
- */
-declare const getCloudflareIncludeProcessEnvFromEnv: () => boolean;
-declare const getTraceHeader: () => string | undefined;
-declare const getDisableConfigWatching: () => boolean;
-/**
- * Hide the Wrangler version banner and command status (deprecated/experimental) warnings
- */
-declare const getWranglerHideBanner: () => boolean;
-/**
- * `CLOUDFLARE_ENV` specifies the currently selected Wrangler/Cloudflare environment.
- */
-declare const getCloudflareEnv: () => string | undefined;
-/**
- * `OPEN_NEXT_DEPLOY` is an environment variables that indicates that the current process is being
- * run by the open-next deploy command
- */
-declare const getOpenNextDeployFromEnv: () => string | undefined;
-/**
- * `X_LOCAL_EXPLORER` enables the local explorer UI at /cdn-cgi/explorer.
- */
-declare const getLocalExplorerEnabledFromEnv: () => boolean;
-/**
- * `X_BROWSER_HEADFUL` opens the browser in headful (visible) mode when using the
- * Browser Run API in local development.
- *
- * Set to "true" to enable:
- *
- * ```sh
- * X_BROWSER_HEADFUL=true vite dev
- * ```
- *
- * Note: when using `@cloudflare/playwright`, two Chrome windows may appear — the initial blank
- * page and the one created by `browser.newPage()`. This is expected due to how Playwright handles
- * browser contexts via CDP.
- */
-declare const getBrowserRenderingHeadfulFromEnv: () => boolean;
-/**
- * `CLOUDFLARE_CF_FETCH_ENABLED` controls whether Miniflare fetches the `cf.json` file
- * containing request.cf properties from workers.cloudflare.com.
- *
- * - If set to "false", disables fetching and uses fallback data (no files created)
- * - If set to "true" or not set, uses the default behavior (fetches and caches cf.json)
- *
- * This is particularly useful for non-JavaScript projects that don't want
- * a node_modules directory created automatically.
- *
- * Example:
- * ```sh
- * # Disable cf fetching entirely
- * CLOUDFLARE_CF_FETCH_ENABLED=false npx wrangler dev
- * ```
- */
-declare const getCfFetchEnabledFromEnv: () => boolean;
-/**
- * `CLOUDFLARE_CF_FETCH_PATH` specifies a custom path for caching the cf.json file.
- *
- * - If set, uses the specified path instead of the default node_modules/.mf/cf.json
- * - If not set, uses the default location (node_modules/.mf/cf.json)
+ * Resolve the global config directory for a Cloudflare CLI.
  *
- * Example:
- * ```sh
- * # Use a custom cache location
- * CLOUDFLARE_CF_FETCH_PATH=/tmp/cf-cache.json npx wrangler dev
- * ```
+ * 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 const getCfFetchPathFromEnv: () => string | undefined;
+declare function getGlobalConfigPath({ appName, leadingDot, useLegacyHomeDir, }?: GetGlobalConfigPathOptions): string;
 /**
- * `WRANGLER_CACHE_DIR` specifies a custom directory for Wrangler's cache files.
- * This overrides the default `node_modules/.cache/wrangler` location.
- * Useful for Yarn PnP or projects without node_modules.
+ * @deprecated Use {@link getGlobalConfigPath} instead.
  */
-declare const getWranglerCacheDirFromEnv: () => string | undefined;
-/**
- * `CLOUDFLARED_PATH` specifies a custom path to a cloudflared binary.
- *
- * If set, Wrangler will use this cloudflared binary instead of downloading one.
- * The path must point to an existing executable file.
- */
-declare const getCloudflaredPathFromEnv: () => string | undefined;
-
 declare function getGlobalWranglerConfigPath(): string;
 
 type YYYY = `${number}${number}${number}${number}`;
@@ -888,30 +675,6 @@ declare function sweepStaleWranglerTmpDirs(tmpRoot: string): void;
  */
 declare function getWranglerTmpDir(projectRoot: string | undefined, prefix: string, cleanup?: boolean): EphemeralDirectory;
 
-/**
- * cloudflared binary management for Wrangler tunnel commands.
- *
- * This module handles downloading, caching, and running the cloudflared binary.
- * It uses the Cloudflare update worker (update.argotunnel.com) to resolve
- * the latest version and download URL, matching cloudflared's own update mechanism.
- */
-
-interface Logger$1 {
-    log: typeof console.log;
-    warn: typeof console.warn;
-    debug: typeof console.debug;
-}
-/**
- * Spawn cloudflared process with automatic binary management
- */
-declare function spawnCloudflared(args: string[], options?: {
-    stdio?: "inherit" | "pipe";
-    env?: Record<string, string>;
-    skipVersionCheck?: boolean;
-    confirmDownload?: (message: string) => Promise<boolean>;
-    logger?: Logger$1;
-}): Promise<ChildProcess>;
-
 interface QuickTunnelResult {
     mode: "quick";
     publicUrl: URL;
@@ -933,7 +696,7 @@ interface TunnelOptions {
     expiryMs?: number;
     reminderIntervalMs?: number;
     extendHint?: string;
-    logger?: Logger$1;
+    logger?: Pick<Logger, "debug" | "log" | "warn">;
 }
 /**
  * Start a Cloudflare Quick Tunnel for a local dev origin.
@@ -945,73 +708,24 @@ interface TunnelOptions {
  */
 declare function startTunnel(options: TunnelOptions): Tunnel;
 
-interface FetchError {
-    code: number;
-    documentation_url?: string;
-    message: string;
-    error_chain?: FetchError[];
-}
-
-type Logger = {
-    debug: (...args: unknown[]) => void;
-    debugWithSanitization: (label: string, ...args: unknown[]) => void;
-    log: (...args: unknown[]) => void;
-    info: (...args: unknown[]) => void;
-    warn: (...args: unknown[]) => void;
-    error: (...args: unknown[]) => void;
-};
-
-type ApiCredentials = {
-    apiToken: string;
-} | {
-    authKey: string;
-    authEmail: string;
-};
-interface FetchResult<ResponseType = unknown> {
-    success: boolean;
-    result: ResponseType;
-    errors: FetchError[];
-    messages?: (string | {
-        code?: number;
-        message: string;
-    })[];
-    result_info?: unknown;
-}
-type FetchResultFetcher = <ResponseType>(complianceConfig: ComplianceConfig, resource: string, init?: RequestInit, queryParams?: URLSearchParams, abortSignal?: AbortSignal) => Promise<ResponseType>;
 /**
+ * cloudflared binary management for Wrangler tunnel commands.
  *
- * Note this requires its caller to handle credentials
- * (need to call requireLoggedIn and requireApiToken)
+ * This module handles downloading, caching, and running the cloudflared binary.
+ * It uses the Cloudflare update worker (update.argotunnel.com) to resolve
+ * the latest version and download URL, matching cloudflared's own update mechanism.
  */
-declare function performApiFetchBase(complianceConfig: ComplianceConfig, resource: string, init: RequestInit | undefined, userAgent: string, logger: Logger, queryParams?: URLSearchParams, abortSignal?: AbortSignal, credentials?: ApiCredentials): Promise<Response>;
-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;
-}>;
-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;
-declare function extractWAFBlockRayId(headers: Headers): string | undefined;
-declare function extractAccountTag(resource: string): string | undefined;
-interface PageResultInfo {
-    page: number;
-    per_page: number;
-    count: number;
-    total_count: number;
-}
-declare function hasMorePages(result_info: unknown): result_info is PageResultInfo;
-declare function renderError(err: FetchError | {
-    code?: number;
-    message?: string;
-    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 hasCursor(result_info: unknown): result_info is {
-    cursor: string;
-};
-declare function maybeAddTraceHeader(headers: Headers): void;
+
+/**
+ * Spawn cloudflared process with automatic binary management
+ */
+declare function spawnCloudflared(args: string[], options?: {
+    stdio?: "inherit" | "pipe";
+    env?: Record<string, string>;
+    skipVersionCheck?: boolean;
+    confirmDownload?: (message: string) => Promise<boolean>;
+    logger?: Pick<Logger, "debug" | "log" | "warn">;
+}): Promise<ChildProcess>;
 
 type NpmVersionCheckResult = {
     status: "up-to-date";
@@ -1037,4 +751,41 @@ type NpmVersionCheckResult = {
  */
 declare function fetchLatestNpmVersion(name: string, version: string): Promise<NpmVersionCheckResult>;
 
-export { APIError, type ApiCredentials, Binding, type BindingLocalSupport, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, CommandLineArgsError, type CompatDate, type ComplianceConfig, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, type EphemeralDirectory, FatalError, type FetchResult, type FetchResultFetcher, JsonFriendlyFatalError, type Location, type Logger, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type NpmVersionCheckResult, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerMetadataBinding, addAuthorizationHeader, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, extractAccountTag, extractWAFBlockRayId, fetchInternalBase, fetchLatestNpmVersion, fetchListResultBase, fetchResultBase, findWranglerConfig, formatConfigSnippet, 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, getEnvironmentVariableFactory, getGlobalWranglerConfigPath, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTodaysCompatDate, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHiddenDirPath, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, getWranglerTmpDir, hasCursor, hasMorePages, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, isWAFBlockResponse, mapWorkerMetadataBindings, maybeAddTraceHeader, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, performApiFetchBase, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, renderError, resolveWranglerConfigPath, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, throwFetchError, truncate, validatePagesConfig };
+declare function retryOnAPIFailure<T>(action: () => T | Promise<T>, logger: Logger, backoff?: number, attempts?: number, abortSignal?: AbortSignal): Promise<T>;
+
+declare function formatTime(duration: number): string;
+
+/**
+ * Get the hostname on which to run a Worker.
+ *
+ * The most accurate place is usually
+ * `route.pattern`, as that includes any subdomains. For example:
+ * ```js
+ * {
+ * 	pattern: foo.example.com
+ * 	zone_name: example.com
+ * }
+ * ```
+ * However, in the case of patterns that _can't_ be parsed as a hostname
+ * (primarily the pattern `*/ declare function getHostFromRoute(route: Route): string | undefined;
+/**
+ * Best-effort derivation of the Cloudflare zone name that owns a given route,
+ * for use as the `CF-Worker` header value on outbound subrequests in local
+ * development (see https://developers.cloudflare.com/fundamentals/reference/http-headers/#cf-worker).
+ *
+ * In production, `CF-Worker` is set to the zone name — for a route
+ * `foo.example.com/*` on zone `example.com`, the header is `example.com`.
+ * When the user has explicitly told us the zone name in their route config
+ * (`zone_name`), use it. Otherwise, fall back to {@link getHostFromRoute},
+ * which returns the route pattern's hostname — this is the closest local
+ * approximation without performing an API lookup, and matches the behaviour
+ * users see when their route's hostname is already the apex (e.g.
+ * `example.com/*`).
+ */
+declare function getZoneFromRoute(route: Route): string | undefined;
+/**
+ * Given something that resembles a URL, try to extract a host from it.
+ */
+declare function getHostFromUrl(urlLike: string): string | undefined;
+
+export { APIError, Binding, type BindingLocalSupport, CommandLineArgsError, type CompatDate, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, type EphemeralDirectory, FatalError, type GetGlobalConfigPathOptions, JsonFriendlyFatalError, type Location, Logger, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type NpmVersionCheckResult, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, Route, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerMetadataBinding, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, fetchLatestNpmVersion, findWranglerConfig, formatConfigSnippet, formatTime, friendlyBindingNames, getBindingLocalSupport, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getEnvironmentVariableFactory, getGlobalConfigPath, getGlobalWranglerConfigPath, getHostFromRoute, getHostFromUrl, getTodaysCompatDate, getWranglerHiddenDirPath, getWranglerTmpDir, getZoneFromRoute, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, validatePagesConfig };