@cloudflare/workers-utils 0.22.0 → 0.23.0

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { T as TailConsumer, az as WorkerMetadata, R as RawConfig } from './config-CXobNAeT.mjs';
+import { T as TailConsumer, az as WorkerMetadata, R as RawConfig } from './config-BT23LDfr.mjs';
 import { AssetConfig } from '@cloudflare/workers-shared';
 import { Cloudflare } from 'cloudflare';
 
@@ -34,9 +34,12 @@ interface APIWorkerConfig {
     };
 }
 /**
- * Given the information of multiple Workers (representing different environments),
+ * Given information about a Worker,
  * construct a Wrangler config file for the application.
+ *
+ * @param config - The Worker configuration sourced from the Cloudflare API
+ * @returns A Wrangler-compatible raw config object
  */
-declare function constructWranglerConfig(workerOrWorkers: APIWorkerConfig | APIWorkerConfig[]): RawConfig;
+declare function constructWranglerConfig(config: APIWorkerConfig): RawConfig;
 
 export { constructWranglerConfig };

package/dist/browser.mjs

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

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

@@ -1,4 +1,3 @@
-import { ENVIRONMENT_TAG_PREFIX, SERVICE_TAG_PREFIX } from './chunk-OZQVB3L3.mjs';
 import { __name } from './chunk-DCOBXSFB.mjs';
 import assert from 'node:assert';
 
@@ -38,8 +37,7 @@ function mapWorkerMetadataBindings(bindings) {
         {
           configObj.vars = {
             ...configObj.vars ?? {},
-            name: binding.name,
-            json: binding.json
+            [binding.name]: binding.json
           };
         }
         break;
@@ -300,9 +298,9 @@ function mapWorkerMetadataBindings(bindings) {
           }
         ];
         break;
-      case "web_search":
+      case "websearch":
         {
-          configObj.web_search = {
+          configObj.websearch = {
             binding: binding.name
           };
         }
@@ -437,7 +435,7 @@ function mapWorkerMetadataBindings(bindings) {
 __name(mapWorkerMetadataBindings, "mapWorkerMetadataBindings");
 
 // src/construct-wrangler-config.ts
-function convertWorkerToWranglerConfig(config) {
+function constructWranglerConfig(config) {
   const mappedBindings = mapWorkerMetadataBindings(config.bindings);
   const durableObjectClassNames = config.bindings.filter(
     (binding) => binding.type === "durable_object_namespace" && binding.script_name === config.name
@@ -485,42 +483,6 @@ function convertWorkerToWranglerConfig(config) {
     ...mappedBindings
   };
 }
-__name(convertWorkerToWranglerConfig, "convertWorkerToWranglerConfig");
-function constructWranglerConfig(workerOrWorkers) {
-  let workers;
-  if (Array.isArray(workerOrWorkers)) {
-    workers = workerOrWorkers;
-  } else {
-    workers = [workerOrWorkers];
-  }
-  const topLevelEnv = workers.find(
-    (w) => !w.tags?.some((t) => t.startsWith(ENVIRONMENT_TAG_PREFIX))
-  );
-  const workerName = topLevelEnv?.name ?? workers[0].name;
-  const entrypoint = topLevelEnv?.entrypoint ?? workers[0].entrypoint;
-  let combinedConfig;
-  if (topLevelEnv) {
-    combinedConfig = convertWorkerToWranglerConfig(topLevelEnv);
-  } else {
-    combinedConfig = {
-      name: workerName,
-      main: entrypoint
-    };
-  }
-  for (const env of workers) {
-    const serviceTag = env.tags?.find(
-      (t) => t === `${SERVICE_TAG_PREFIX}${workerName}`
-    );
-    const envTag = env.tags?.find((t) => t.startsWith(ENVIRONMENT_TAG_PREFIX));
-    if (serviceTag !== `${SERVICE_TAG_PREFIX}${workerName}` || envTag === void 0) {
-      continue;
-    }
-    const [_, envName] = envTag.split("=");
-    combinedConfig.env ??= {};
-    combinedConfig.env[envName] = convertWorkerToWranglerConfig(env);
-  }
-  return combinedConfig;
-}
 __name(constructWranglerConfig, "constructWranglerConfig");
 
 export { assertNever, constructWranglerConfig, getTodaysCompatDate, isCompatDate, mapWorkerMetadataBindings };

package/dist/{chunk-GMTGAG26.mjs → chunk-ULVYGN52.mjs}

@@ -1,4 +1,3 @@
-import { PATH_TO_DEPLOY_CONFIG } from './chunk-OZQVB3L3.mjs';
 import { __name } from './chunk-DCOBXSFB.mjs';
 import fs, { readFileSync as readFileSync$1, statSync, existsSync } from 'node:fs';
 import path, { resolve, isAbsolute, dirname, join } from 'node:path';
@@ -2652,6 +2651,13 @@ function removeBOMAndValidate(buffer, file2) {
   return content;
 }
 __name(removeBOMAndValidate, "removeBOMAndValidate");
+
+// src/constants.ts
+var INHERIT_SYMBOL = Symbol.for("inherit_binding");
+var SERVICE_TAG_PREFIX = "cf:service=";
+var ENVIRONMENT_TAG_PREFIX = "cf:environment=";
+var PATH_TO_DEPLOY_CONFIG = ".wrangler/deploy/config.json";
+var JSON_CONFIG_FORMATS = ["json", "jsonc"];
 function absolute(input, root) {
   return isAbsolute(input) ? input : resolve(root || ".", input);
 }
@@ -3179,4 +3185,4 @@ smol-toml/dist/index.js:
    *)
 */
 
-export { APIError, CommandLineArgsError, DeprecationError, FatalError, JsonFriendlyFatalError, MissingConfigError, ParseError, 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, isDirectory, isRedirectedConfig, isRedirectedRawConfig, modify, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation };

package/dist/{config-CXobNAeT.d.mts → config-BT23LDfr.d.mts}

@@ -198,6 +198,7 @@ interface CfD1Database {
     database_internal_env?: string;
     migrations_table?: string;
     migrations_dir?: string;
+    migrations_pattern?: string;
     remote?: boolean;
     raw?: boolean;
 }
@@ -526,7 +527,7 @@ type WorkerMetadataBinding = {
     name: string;
     instance_name: string;
 } | {
-    type: "web_search";
+    type: "websearch";
     name: string;
 } | {
     type: "agent_memory";
@@ -858,7 +859,7 @@ type Binding = {
 } & BindingOmit<CfAISearchNamespace>) | ({
     type: "ai_search";
 } & BindingOmit<CfAISearch>) | ({
-    type: "web_search";
+    type: "websearch";
 } & BindingOmit<CfWebSearch>) | ({
     type: "agent_memory";
 } & BindingOmit<CfAgentMemory>) | ({
@@ -927,6 +928,14 @@ type Entry = {
     exports: string[];
 };
 
+/**
+ * Wrangler configuration types. The JSDoc on these fields is also the source
+ * of truth for the equivalent fields in `@cloudflare/config`
+ * (`packages/config/src/types.ts` — `UserConfig` — and the binding option
+ * interfaces in `packages/config/src/config.ts`). When editing prose here,
+ * mirror the changes there.
+ */
+
 /**
  * The `Environment` interface declares all the configuration fields that
  * can be specified for an environment.
@@ -1814,6 +1823,21 @@ interface EnvironmentNonInheritable {
         migrations_table?: string;
         /** The path to the directory of migrations for this D1 database (defaults to './migrations'). */
         migrations_dir?: string;
+        /**
+         * A glob pattern (relative to the Wrangler config file) used to discover
+         * migration files for this D1 database. Defaults to `${migrations_dir}/*.sql`
+         * if not specified.
+         *
+         * Use this to opt in to nested layouts such as `migrations/*\/migration.sql`
+         * (as produced by some ORMs).
+         *
+         * When `migrations_pattern` is set, `migrations_dir` must also be set, and
+         * `migrations_pattern` must start with `${migrations_dir}/`. This keeps the
+         * relationship between the two settings explicit and lets Wrangler record
+         * each migration's name in the migrations table as a path relative to
+         * `migrations_dir`.
+         */
+        migrations_pattern?: string;
         /** Internal use only. */
         database_internal_env?: string;
         /** Whether the D1 database should be remote or not in local development */
@@ -1902,7 +1926,7 @@ interface EnvironmentNonInheritable {
      * @default {}
      * @nonInheritable
      */
-    web_search: {
+    websearch: {
         /** The binding name used to refer to Web Search in the Worker. */
         binding: string;
         /** Whether the Web Search binding should be remote or not in local development */
@@ -2699,4 +2723,4 @@ interface EnvironmentMap {
 }
 declare const defaultWranglerConfig: Config;
 
-export { type CfVectorize as $, type Assets as A, type Binding as B, type ComputedFields as C, type DurableObjectMigration as D, type Environment as E, type CfWasmModuleBindings as F, type CfTextBlobBindings as G, type CfBrowserBinding as H, type CfAIBinding as I, type CfImagesBinding as J, type CfMediaBinding as K, type CfStreamBinding as L, type CfVersionMetadataBinding as M, type CfDataBlobBindings as N, type Observability as O, type PreviewsConfig as P, type CfDurableObject as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfWorkflow as V, type WorkerMetadataBinding as W, type CfQueue as X, type CfR2Bucket as Y, type ZoneIdRoute as Z, type CfD1Database as _, type RedirectedRawConfig as a, type CfAISearchNamespace as a0, type CfAISearch as a1, type CfWebSearch as a2, type CfAgentMemory as a3, type CfSecretsStoreSecrets as a4, type CfArtifacts as a5, type CfHelloWorld as a6, type CfFlagship as a7, type CfWorkerLoader as a8, type CfRateLimit as a9, type ServiceMetadataRes as aA, type ServiceFetch as aB, type File as aC, type BinaryFile as aD, type Trigger as aE, type Entry as aF, INHERIT_SYMBOL as aG, SERVICE_TAG_PREFIX as aH, ENVIRONMENT_TAG_PREFIX as aI, PATH_TO_DEPLOY_CONFIG as aJ, JSON_CONFIG_FORMATS as aK, type CfHyperdrive as aa, type CfService as ab, type CfVpcService as ac, type CfVpcNetwork as ad, type CfAnalyticsEngineDataset as ae, type CfDispatchNamespace as af, type CfMTlsCertificate as ag, type CfLogfwdr as ah, type CfLogfwdrBinding as ai, type CfAssetsBinding as aj, type CfPipeline as ak, type CfUnsafeBinding as al, type CfCapnp as am, type CfUnsafe as an, type CfDurableObjectMigrations as ao, type CfPlacement as ap, type CfTailConsumer as aq, type CfUserLimits as ar, type CfWorkerInit as as, type CfWorkerContext as at, type CfWorkerSourceMap as au, type Json as av, type AssetConfigMetadata as aw, type AssetsOptions as ax, type LegacyAssetPaths as ay, type WorkerMetadata as az, type Config as b, type RawDevConfig as c, type ConfigFields as d, type RawEnvironment as e, defaultWranglerConfig as f, type ZoneNameRoute as g, type CustomDomainRoute as h, type Route as i, type CloudchamberConfig as j, type ContainerApp as k, type DurableObjectBindings as l, type WorkflowBinding as m, type EnvironmentNonInheritable as n, type Rule as o, type ConfigModuleRuleType as p, type DispatchNamespaceOutbound as q, type CacheOptions as r, type DockerConfiguration as s, type ContainerEngine as t, type CfScriptFormat as u, type CfModuleType as v, type CfModule as w, type CfVars as x, type CfKvNamespace as y, type CfSendEmailBindings as z };
+export { type CfVectorize as $, type Assets as A, type Binding as B, type ComputedFields as C, type DurableObjectMigration as D, type Environment as E, type CfWasmModuleBindings as F, type CfTextBlobBindings as G, type CfBrowserBinding as H, type CfAIBinding as I, type CfImagesBinding as J, type CfMediaBinding as K, type CfStreamBinding as L, type CfVersionMetadataBinding as M, type CfDataBlobBindings as N, type Observability as O, type PreviewsConfig as P, type CfDurableObject as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfWorkflow as V, type WorkerMetadataBinding as W, type CfQueue as X, type CfR2Bucket as Y, type ZoneIdRoute as Z, type CfD1Database as _, type RedirectedRawConfig as a, type CfAISearchNamespace as a0, type CfAISearch as a1, type CfWebSearch as a2, type CfAgentMemory as a3, type CfSecretsStoreSecrets as a4, type CfArtifacts as a5, type CfHelloWorld as a6, type CfFlagship as a7, type CfWorkerLoader as a8, type CfRateLimit as a9, type ServiceMetadataRes as aA, type ServiceFetch as aB, type File as aC, type BinaryFile as aD, type Trigger as aE, type Entry as aF, INHERIT_SYMBOL as aG, SERVICE_TAG_PREFIX as aH, ENVIRONMENT_TAG_PREFIX as aI, PATH_TO_DEPLOY_CONFIG as aJ, JSON_CONFIG_FORMATS as aK, type CfHyperdrive as aa, type CfService as ab, type CfVpcService as ac, type CfVpcNetwork as ad, type CfAnalyticsEngineDataset as ae, type CfDispatchNamespace as af, type CfMTlsCertificate as ag, type CfLogfwdr as ah, type CfLogfwdrBinding as ai, type CfAssetsBinding as aj, type CfPipeline as ak, type CfUnsafeBinding as al, type CfCapnp as am, type CfUnsafe as an, type CfDurableObjectMigrations as ao, type CfPlacement as ap, type CfTailConsumer as aq, type CfUserLimits as ar, type CfWorkerInit as as, type CfWorkerContext as at, type CfWorkerSourceMap as au, type Json as av, type AssetConfigMetadata as aw, type AssetsOptions as ax, type LegacyAssetPaths as ay, type WorkerMetadata as az, type Config as b, type Route as c, type RawDevConfig as d, type ConfigFields as e, type RawEnvironment as f, defaultWranglerConfig as g, type ZoneNameRoute as h, type CustomDomainRoute as i, type CloudchamberConfig as j, type ContainerApp as k, type DurableObjectBindings as l, type WorkflowBinding as m, type EnvironmentNonInheritable as n, type Rule as o, type ConfigModuleRuleType as p, type DispatchNamespaceOutbound as q, type CacheOptions as r, type DockerConfiguration as s, type ContainerEngine as t, type CfScriptFormat as u, type CfModuleType as v, type CfModule as w, type CfVars as x, type CfKvNamespace as y, type CfSendEmailBindings as z };

package/dist/index.d.mts

@@ -1,9 +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, c as Route } from './config-BT23LDfr.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, e as ConfigFields, p as ConfigModuleRuleType, k as ContainerApp, t as ContainerEngine, i 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, d as RawDevConfig, f as RawEnvironment, a as RedirectedRawConfig, 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, h as ZoneNameRoute, g as defaultWranglerConfig } from './config-BT23LDfr.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 '@cloudflare/workers-shared';
 import 'cloudflare';
 
@@ -90,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
  */
@@ -894,7 +896,7 @@ declare function getWranglerTmpDir(projectRoot: string | undefined, prefix: stri
  * the latest version and download URL, matching cloudflared's own update mechanism.
  */
 
-interface Logger {
+interface Logger$1 {
     log: typeof console.log;
     warn: typeof console.warn;
     debug: typeof console.debug;
@@ -907,7 +909,7 @@ declare function spawnCloudflared(args: string[], options?: {
     env?: Record<string, string>;
     skipVersionCheck?: boolean;
     confirmDownload?: (message: string) => Promise<boolean>;
-    logger?: Logger;
+    logger?: Logger$1;
 }): Promise<ChildProcess>;
 
 interface QuickTunnelResult {
@@ -931,7 +933,7 @@ interface TunnelOptions {
     expiryMs?: number;
     reminderIntervalMs?: number;
     extendHint?: string;
-    logger?: Logger;
+    logger?: Logger$1;
 }
 /**
  * Start a Cloudflare Quick Tunnel for a local dev origin.
@@ -943,6 +945,75 @@ 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>;
+type FetchListResultFetcher = <ResponseType>(complianceConfig: ComplianceConfig, resource: string, init?: RequestInit, queryParams?: URLSearchParams) => Promise<ResponseType[]>;
+/**
+ *
+ * Note this requires its caller to handle credentials
+ * (need to call requireLoggedIn and requireApiToken)
+ */
+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;
+
 type NpmVersionCheckResult = {
     status: "up-to-date";
 } | {
@@ -967,4 +1038,41 @@ type NpmVersionCheckResult = {
  */
 declare function fetchLatestNpmVersion(name: string, version: string): Promise<NpmVersionCheckResult>;
 
-export { APIError, 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, JsonFriendlyFatalError, type Location, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type NpmVersionCheckResult, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, type TelemetryMessage, type Tunnel, type TunnelOptions, UserError, WorkerMetadataBinding, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, fetchLatestNpmVersion, 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, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRedirectedConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, 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, 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 FetchListResultFetcher, 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, Route, 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, formatTime, 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, getHostFromRoute, getHostFromUrl, getLocalExplorerEnabledFromEnv, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTodaysCompatDate, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHiddenDirPath, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, getWranglerTmpDir, getZoneFromRoute, 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, retryOnAPIFailure, searchLocation, spawnCloudflared, startTunnel, sweepStaleWranglerTmpDirs, throwFetchError, truncate, validatePagesConfig };