@cloudflare/workers-utils 0.21.1 → 0.22.1

package/dist/browser.d.mts

@@ -1,4 +1,4 @@
-import { T as TailConsumer, av as WorkerMetadata, R as RawConfig } from './config-BH_2HMEf.mjs';
+import { T as TailConsumer, az as WorkerMetadata, R as RawConfig } from './config-CXobNAeT.mjs';
 import { AssetConfig } from '@cloudflare/workers-shared';
 import { Cloudflare } from 'cloudflare';
 

package/dist/browser.mjs

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

package/dist/{chunk-BLWXWFJK.mjs → chunk-UFU4JGIG.mjs}

@@ -38,8 +38,7 @@ function mapWorkerMetadataBindings(bindings) {
         {
           configObj.vars = {
             ...configObj.vars ?? {},
-            name: binding.name,
-            json: binding.json
+            [binding.name]: binding.json
           };
         }
         break;
@@ -300,6 +299,23 @@ function mapWorkerMetadataBindings(bindings) {
           }
         ];
         break;
+      case "web_search":
+        {
+          configObj.web_search = {
+            binding: binding.name
+          };
+        }
+        break;
+      case "agent_memory": {
+        configObj.agent_memory = [
+          ...configObj.agent_memory ?? [],
+          {
+            binding: binding.name,
+            namespace: binding.namespace
+          }
+        ];
+        break;
+      }
       case "hyperdrive":
         configObj.hyperdrive = [
           ...configObj.hyperdrive ?? [],
@@ -323,7 +339,9 @@ function mapWorkerMetadataBindings(bindings) {
           ...configObj.pipelines ?? [],
           {
             binding: binding.name,
-            pipeline: binding.pipeline
+            // NOTE: stream is the primary field, but we also support pipeline for backward compatibility
+            ...binding.stream && { stream: binding.stream },
+            ...binding.pipeline && { pipeline: binding.pipeline }
           }
         ];
         break;

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

@@ -174,7 +174,7 @@ interface CfWorkflow {
     limits?: {
         steps?: number;
     };
-    schedule?: string | string[];
+    schedules?: string | string[];
 }
 interface CfQueue {
     binding: string;
@@ -217,6 +217,15 @@ interface CfAISearch {
     instance_name: string;
     remote?: boolean;
 }
+interface CfWebSearch {
+    binding: string;
+    remote?: boolean;
+}
+interface CfAgentMemory {
+    binding: string;
+    namespace: string | typeof INHERIT_SYMBOL;
+    remote?: boolean;
+}
 interface CfSecretsStoreSecrets {
     binding: string;
     store_id: string;
@@ -303,7 +312,8 @@ interface CfAssetsBinding {
 }
 interface CfPipeline {
     binding: string;
-    pipeline: string;
+    stream?: string;
+    pipeline?: string;
     remote?: boolean;
 }
 interface CfUnsafeBinding {
@@ -515,6 +525,13 @@ type WorkerMetadataBinding = {
     type: "ai_search";
     name: string;
     instance_name: string;
+} | {
+    type: "web_search";
+    name: string;
+} | {
+    type: "agent_memory";
+    name: string;
+    namespace: string;
 } | {
     type: "kv_namespace";
     name: string;
@@ -602,7 +619,8 @@ type WorkerMetadataBinding = {
 } | {
     type: "pipelines";
     name: string;
-    pipeline: string;
+    stream?: string;
+    pipeline?: string;
 } | {
     type: "secrets_store_secret";
     name: string;
@@ -655,6 +673,38 @@ type AssetConfigMetadata = {
     _redirects?: string;
     _headers?: string;
 };
+type AssetsOptions = {
+    directory: string;
+    binding?: string;
+    routerConfig: RouterConfig;
+    assetConfig: AssetConfig;
+    _redirects?: string;
+    _headers?: string;
+    run_worker_first?: boolean | string[];
+};
+/**
+ * Information about the assets that should be uploaded
+ */
+interface LegacyAssetPaths {
+    /**
+     * Absolute path to the root of the project.
+     *
+     * This is the directory containing wrangler.toml or cwd if no config.
+     */
+    baseDirectory: string;
+    /**
+     * The path to the assets directory, relative to the `baseDirectory`.
+     */
+    assetDirectory: string;
+    /**
+     * An array of patterns that match files that should be uploaded.
+     */
+    includePatterns: string[];
+    /**
+     * An array of patterns that match files that should not be uploaded.
+     */
+    excludePatterns: string[];
+}
 type WorkerMetadataPut = {
     /** The name of the entry point module. Only exists when the worker is in the ES module format */
     main_module?: string;
@@ -808,6 +858,10 @@ type Binding = {
 } & BindingOmit<CfAISearchNamespace>) | ({
     type: "ai_search";
 } & BindingOmit<CfAISearch>) | ({
+    type: "web_search";
+} & BindingOmit<CfWebSearch>) | ({
+    type: "agent_memory";
+} & BindingOmit<CfAgentMemory>) | ({
     type: "hyperdrive";
 } & BindingOmit<CfHyperdrive>) | ({
     type: "service";
@@ -849,6 +903,29 @@ type Binding = {
 } | {
     type: "inherit";
 };
+/**
+ * An entry point for the Worker.
+ *
+ * It consists not just of a `file`, but also of a `directory` that is used to resolve relative paths.
+ */
+type Entry = {
+    /** A worker's entrypoint */
+    file: string;
+    /** A worker's directory. Usually where the Wrangler configuration file is located */
+    projectRoot: string;
+    /** The path to the config file, if it exists. */
+    configPath: string | undefined;
+    /** Is this a module worker or a service worker? */
+    format: CfScriptFormat;
+    /** The directory that contains all of a `--no-bundle` worker's modules. Usually `${directory}/src`. Defaults to path.dirname(file) */
+    moduleRoot: string;
+    /**
+     * A worker's name
+     */
+    name?: string | undefined;
+    /** Export from a Worker's entrypoint */
+    exports: string[];
+};
 
 /**
  * The `Environment` interface declares all the configuration fields that
@@ -1499,7 +1576,7 @@ type WorkflowBinding = {
         steps?: number;
     };
     /** Optional cron schedule(s) for automatically triggering workflow instances */
-    schedule?: string | string[];
+    schedules?: string | string[];
 };
 /**
  * The `EnvironmentNonInheritable` interface declares all the configuration fields for an environment
@@ -1797,6 +1874,40 @@ interface EnvironmentNonInheritable {
         /** Whether the AI Search instance binding should be remote in local development */
         remote?: boolean;
     }[];
+    /**
+     * Specifies Agent Memory namespace bindings that are bound to this Worker environment.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default []
+     * @nonInheritable
+     */
+    agent_memory: {
+        /** The binding name used to refer to the Agent Memory namespace in the Worker. */
+        binding: string;
+        /** The user-chosen namespace name. Must exist in Cloudflare at deploy time. */
+        namespace: string;
+        /** Whether the Agent Memory binding should be remote in local development */
+        remote?: boolean;
+    }[];
+    /**
+     * Cloudflare Web Search binding. There is exactly one shared web corpus, so the
+     * binding is zero-config -- only the variable name is required, declared as a
+     * single object (not an array).
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default {}
+     * @nonInheritable
+     */
+    web_search: {
+        /** 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 */
+        remote?: boolean;
+    } | undefined;
     /**
      * Specifies Hyperdrive configs that are bound to this Worker environment.
      *
@@ -2058,8 +2169,13 @@ interface EnvironmentNonInheritable {
     pipelines: {
         /** The binding name used to refer to the bound service. */
         binding: string;
-        /** Name of the Pipeline to bind */
-        pipeline: string;
+        /** Id of the Stream to bind */
+        stream?: string;
+        /**
+         * Id of the Stream to bind
+         * @deprecated Use `stream` instead.
+         */
+        pipeline?: string;
         /** Whether the pipeline should be remote or not in local development */
         remote?: boolean;
     }[];
@@ -2583,4 +2699,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 CfSecretsStoreSecrets as a2, type CfArtifacts as a3, type CfHelloWorld as a4, type CfFlagship as a5, type CfWorkerLoader as a6, type CfRateLimit as a7, type CfHyperdrive as a8, type CfService as a9, type Trigger as aA, INHERIT_SYMBOL as aB, SERVICE_TAG_PREFIX as aC, ENVIRONMENT_TAG_PREFIX as aD, PATH_TO_DEPLOY_CONFIG as aE, JSON_CONFIG_FORMATS as aF, type CfVpcService as aa, type CfVpcNetwork as ab, type CfAnalyticsEngineDataset as ac, type CfDispatchNamespace as ad, type CfMTlsCertificate as ae, type CfLogfwdr as af, type CfLogfwdrBinding as ag, type CfAssetsBinding as ah, type CfPipeline as ai, type CfUnsafeBinding as aj, type CfCapnp as ak, type CfUnsafe as al, type CfDurableObjectMigrations as am, type CfPlacement as an, type CfTailConsumer as ao, type CfUserLimits as ap, type CfWorkerInit as aq, type CfWorkerContext as ar, type CfWorkerSourceMap as as, type Json as at, type AssetConfigMetadata as au, type WorkerMetadata as av, type ServiceMetadataRes as aw, type ServiceFetch as ax, type File as ay, type BinaryFile 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 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 };

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-BH_2HMEf.mjs';
-export { au as AssetConfigMetadata, A as Assets, az as BinaryFile, r as CacheOptions, I as CfAIBinding, a1 as CfAISearch, a0 as CfAISearchNamespace, ac as CfAnalyticsEngineDataset, a3 as CfArtifacts, ah as CfAssetsBinding, H as CfBrowserBinding, ak as CfCapnp, _ as CfD1Database, N as CfDataBlobBindings, ad as CfDispatchNamespace, Q as CfDurableObject, am as CfDurableObjectMigrations, a5 as CfFlagship, a4 as CfHelloWorld, a8 as CfHyperdrive, J as CfImagesBinding, y as CfKvNamespace, af as CfLogfwdr, ag as CfLogfwdrBinding, ae as CfMTlsCertificate, K as CfMediaBinding, w as CfModule, v as CfModuleType, ai as CfPipeline, an as CfPlacement, X as CfQueue, Y as CfR2Bucket, a7 as CfRateLimit, u as CfScriptFormat, a2 as CfSecretsStoreSecrets, z as CfSendEmailBindings, a9 as CfService, L as CfStreamBinding, ao as CfTailConsumer, G as CfTextBlobBindings, al as CfUnsafe, aj as CfUnsafeBinding, ap as CfUserLimits, x as CfVars, $ as CfVectorize, M as CfVersionMetadataBinding, ab as CfVpcNetwork, aa as CfVpcService, F as CfWasmModuleBindings, ar as CfWorkerContext, aq as CfWorkerInit, a6 as CfWorkerLoader, as 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, aD as ENVIRONMENT_TAG_PREFIX, E as Environment, n as EnvironmentNonInheritable, ay as File, aB as INHERIT_SYMBOL, aF as JSON_CONFIG_FORMATS, at as Json, O as Observability, aE as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, c as RawDevConfig, e as RawEnvironment, a as RedirectedRawConfig, i as Route, o as Rule, aC as SERVICE_TAG_PREFIX, ax as ServiceFetch, aw as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, aA as Trigger, U as UserLimits, av as WorkerMetadata, m as WorkflowBinding, Z as ZoneIdRoute, g as ZoneNameRoute, f as defaultWranglerConfig } from './config-BH_2HMEf.mjs';
+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 * 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" | "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" | "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";
 /**
  * @deprecated new code should use getBindingTypeFriendlyName() instead
  */
@@ -329,6 +331,22 @@ declare function parseHumanDuration(s: string): number;
 declare function parseNonHyphenedUuid(uuid: string | null): string | null;
 declare function parseByteSize(s: string, base?: number | undefined): number;
 
+/**
+ * Local-dev capability of each binding type. Source of truth for
+ * `pickRemoteBindings()` and `warnOrError()`.
+ *
+ * - `local-and-remote`: local simulator; `remote: true` opts into proxying.
+ * - `local-only`: local simulator only; `remote: true` is a config error.
+ * - `remote`: no local simulator *yet* — requires explicit `remote: true`.
+ *   Move to `local-and-remote` once a simulator lands.
+ * - `DO-NOT-USE-this-resource-will-never-have-a-local-simulator`: no local
+ *   simulator, *ever* — fundamentally remote-only. Always auto-routed; user
+ *   is warned about usage charges. Adding here is permanent; prefer any
+ *   other variant if a simulator is plausible.
+ */
+type BindingLocalSupport = "local-and-remote" | "local-only" | "remote" | "DO-NOT-USE-this-resource-will-never-have-a-local-simulator";
+declare function getBindingLocalSupport(type: Binding["type"]): BindingLocalSupport;
+
 /**
  * Pages now supports configuration via a Wrangler configuration file. As opposed to
  * Workers however, Pages only supports a limited subset of all available
@@ -569,9 +587,12 @@ declare const getC3CommandFromEnv: () => string;
  */
 declare const getWranglerSendMetricsFromEnv: () => boolean | undefined;
 /**
- * `WRANGLER_SEND_ERROR_REPORTS` can override whether we attempt to send error reports to Sentry.
+ * `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 | undefined;
+declare const getWranglerSendErrorReportsFromEnv: () => boolean;
 /**
  * Set `WRANGLER_API_ENVIRONMENT` environment variable to "staging" to tell Wrangler to hit the staging APIs rather than production.
  */
@@ -838,6 +859,35 @@ declare function removeDir(dirPath: string, options?: {
  */
 declare function removeDirSync(dirPath: string): void;
 
+/**
+ * A short-lived directory. Automatically removed when the process exits, but
+ * can be removed earlier by calling `remove()`.
+ */
+interface EphemeralDirectory {
+    path: string;
+    remove(): void;
+}
+/**
+ * Gets the path to the project's `.wrangler` folder.
+ */
+declare function getWranglerHiddenDirPath(projectRoot: string | undefined): string;
+/**
+ * Removes stale `.wrangler/tmp/*` entries left behind by previous wrangler
+ * sessions that exited abnormally (SIGKILL, OOM, host crash) and so missed
+ * the `signal-exit` cleanup. Runs at most once per tmp root per process.
+ *
+ * Exported for tests.
+ */
+declare function sweepStaleWranglerTmpDirs(tmpRoot: string): void;
+/**
+ * Gets a temporary directory in the project's `.wrangler` folder with the
+ * specified prefix. We create temporary directories in `.wrangler` as opposed
+ * to the OS's temporary directory to avoid issues with different drive letters
+ * on Windows. For example, when `esbuild` outputs a file to a different drive
+ * than the input sources, the generated source maps are incorrect.
+ */
+declare function getWranglerTmpDir(projectRoot: string | undefined, prefix: string, cleanup?: boolean): EphemeralDirectory;
+
 /**
  * cloudflared binary management for Wrangler tunnel commands.
  *
@@ -846,7 +896,7 @@ declare function removeDirSync(dirPath: string): void;
  * 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;
@@ -859,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 {
@@ -883,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.
@@ -895,4 +945,96 @@ interface TunnelOptions {
  */
 declare function startTunnel(options: TunnelOptions): Tunnel;
 
-export { APIError, Binding, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, CommandLineArgsError, type CompatDate, type ComplianceConfig, Config, type ConfigBindingFieldName, type ConfigBindingOptions, DeprecationError, Diagnostics, FatalError, JsonFriendlyFatalError, type Location, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, 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, findWranglerConfig, formatConfigSnippet, friendlyBindingNames, 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, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, 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, validatePagesConfig };
+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>;
+/**
+ *
+ * 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";
+} | {
+    status: "update-available";
+    latest: string;
+} | {
+    status: "failed";
+};
+/**
+ * Checks if a newer version of a package is available on npm.
+ *
+ * Uses the `update-check` library to query the npm registry for the latest
+ * version. The dist tag used for comparison depends on the current version —
+ * "beta" for pre-release versions (0.0.0-*) and "latest" for stable versions.
+ *
+ * @param name - The npm package name to check
+ * @param version - The current version to compare against
+ * @returns A discriminated result:
+ *   - `{ status: "update-available", latest: string }` if a newer version exists
+ *   - `{ status: "up-to-date" }` if the installed version is already the latest
+ *   - `{ status: "failed" }` if the check could not be completed (network error, timeout, etc.)
+ */
+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 };