@cloudflare/workers-utils 0.12.0 → 0.18.0

package/dist/{config-BQZJPwXe.d.mts → config-_M2XwEUI.d.mts}

@@ -136,6 +136,13 @@ interface CfMediaBinding {
     binding: string;
     remote?: boolean;
 }
+/**
+ * A binding to Cloudflare Stream
+ */
+interface CfStreamBinding {
+    binding: string;
+    remote?: boolean;
+}
 /**
  * A binding to the Worker Version's metadata
  */
@@ -164,6 +171,9 @@ interface CfWorkflow {
     script_name?: string;
     remote?: boolean;
     raw?: boolean;
+    limits?: {
+        steps?: number;
+    };
 }
 interface CfQueue {
     binding: string;
@@ -196,15 +206,35 @@ interface CfVectorize {
     raw?: boolean;
     remote?: boolean;
 }
+interface CfAISearchNamespace {
+    binding: string;
+    namespace: string | typeof INHERIT_SYMBOL;
+    remote?: boolean;
+}
+interface CfAISearch {
+    binding: string;
+    instance_name: string;
+    remote?: boolean;
+}
 interface CfSecretsStoreSecrets {
     binding: string;
     store_id: string;
     secret_name: string;
 }
+interface CfArtifacts {
+    binding: string;
+    namespace: string;
+    remote?: boolean;
+}
 interface CfHelloWorld {
     binding: string;
     enable_timer?: boolean;
 }
+interface CfFlagship {
+    binding: string;
+    app_id: string;
+    remote?: boolean;
+}
 interface CfWorkerLoader {
     binding: string;
 }
@@ -235,6 +265,12 @@ interface CfVpcService {
     service_id: string;
     remote?: boolean;
 }
+interface CfVpcNetwork {
+    binding: string;
+    tunnel_id?: string;
+    network_id?: string;
+    remote?: boolean;
+}
 interface CfAnalyticsEngineDataset {
     binding: string;
     dataset?: string;
@@ -460,6 +496,9 @@ type WorkerMetadataBinding = {
     type: "images";
     name: string;
     raw?: boolean;
+} | {
+    type: "stream";
+    name: string;
 } | {
     type: "version_metadata";
     name: string;
@@ -467,6 +506,14 @@ type WorkerMetadataBinding = {
     type: "data_blob";
     name: string;
     part: string;
+} | {
+    type: "ai_search_namespace";
+    name: string;
+    namespace: string;
+} | {
+    type: "ai_search";
+    name: string;
+    instance_name: string;
 } | {
     type: "kv_namespace";
     name: string;
@@ -560,10 +607,18 @@ type WorkerMetadataBinding = {
     name: string;
     store_id: string;
     secret_name: string;
+} | {
+    type: "artifacts";
+    name: string;
+    namespace: string;
 } | {
     type: "unsafe_hello_world";
     name: string;
     enable_timer?: boolean;
+} | {
+    type: "flagship";
+    name: string;
+    app_id: string;
 } | {
     type: "ratelimit";
     name: string;
@@ -576,6 +631,11 @@ type WorkerMetadataBinding = {
     type: "vpc_service";
     name: string;
     service_id: string;
+} | {
+    type: "vpc_network";
+    name: string;
+    tunnel_id?: string;
+    network_id?: string;
 } | {
     type: "worker_loader";
     name: string;
@@ -689,7 +749,7 @@ type Trigger = {
     cron: string;
 } | ({
     type: "queue-consumer";
-} & QueueConsumer);
+} & Omit<QueueConsumer, "type">);
 type BindingOmit<T> = Omit<T, "binding">;
 type NameOmit<T> = Omit<T, "name">;
 type Binding = {
@@ -723,7 +783,9 @@ type Binding = {
     type: "ai";
 } & BindingOmit<CfAIBinding>) | ({
     type: "images";
-} & BindingOmit<CfImagesBinding>) | {
+} & BindingOmit<CfImagesBinding>) | ({
+    type: "stream";
+} & BindingOmit<CfStreamBinding>) | {
     type: "version_metadata";
 } | {
     type: "data_blob";
@@ -741,6 +803,10 @@ type Binding = {
 } & BindingOmit<CfD1Database>) | ({
     type: "vectorize";
 } & BindingOmit<CfVectorize>) | ({
+    type: "ai_search_namespace";
+} & BindingOmit<CfAISearchNamespace>) | ({
+    type: "ai_search";
+} & BindingOmit<CfAISearch>) | ({
     type: "hyperdrive";
 } & BindingOmit<CfHyperdrive>) | ({
     type: "service";
@@ -758,16 +824,22 @@ type Binding = {
 } & BindingOmit<CfPipeline>) | ({
     type: "secrets_store_secret";
 } & BindingOmit<CfSecretsStoreSecrets>) | ({
+    type: "artifacts";
+} & BindingOmit<CfArtifacts>) | ({
     type: "logfwdr";
 } & NameOmit<CfLogfwdrBinding>) | ({
     type: "unsafe_hello_world";
 } & BindingOmit<CfHelloWorld>) | ({
+    type: "flagship";
+} & BindingOmit<CfFlagship>) | ({
     type: "ratelimit";
 } & NameOmit<CfRateLimit>) | ({
     type: "worker_loader";
 } & BindingOmit<CfWorkerLoader>) | ({
     type: "vpc_service";
 } & BindingOmit<CfVpcService>) | ({
+    type: "vpc_network";
+} & BindingOmit<CfVpcNetwork>) | ({
     type: "media";
 } & BindingOmit<CfMediaBinding>) | ({
     type: `unsafe_${string}`;
@@ -799,6 +871,8 @@ type ZoneNameRoute = {
 type CustomDomainRoute = {
     pattern: string;
     custom_domain: boolean;
+    enabled?: boolean;
+    previews_enabled?: boolean;
 };
 type Route = SimpleRoute | ZoneIdRoute | ZoneNameRoute | CustomDomainRoute;
 /**
@@ -911,7 +985,7 @@ type ContainerApp = {
         /** @defaults to 2 GB */
         disk_mb?: number;
     };
-    wrangler_ssh?: {
+    ssh?: {
         /**
          * If enabled, those with write access to a container will be able to SSH into it through Wrangler.
          * @default false
@@ -923,6 +997,14 @@ type ContainerApp = {
          */
         port?: number;
     };
+    /**
+     * @deprecated Use `ssh` instead.
+     * @hidden
+     */
+    wrangler_ssh?: {
+        enabled: boolean;
+        port?: number;
+    };
     /**
      * SSH public keys to put in the container's authorized_keys file.
      */
@@ -961,16 +1043,29 @@ type ContainerApp = {
         memory_mib?: number;
     };
     /**
-     * Scheduling constraints
-     * @hidden
+     * Scheduling constraints for container placement.
      */
     constraints?: {
-        regions?: string[];
+        /**
+         * Limit container placement to specific geographic regions.
+         */
+        regions?: ("ENAM" | "WNAM" | "EEUR" | "WEUR" | "APAC" | "SAM" | "ME" | "OC" | "AFR")[];
+        /**
+         * Restrict containers to compliance boundaries.
+         */
+        jurisdiction?: "eu" | "fedramp";
+        /**
+         * @hidden
+         */
         cities?: string[];
         /**
          * @deprecated Use `tiers` instead
+         * @hidden
          */
         tier?: number;
+        /**
+         * @hidden
+         */
         tiers?: number[];
     };
     /**
@@ -1364,6 +1459,18 @@ interface EnvironmentInheritable {
          */
         exclude: string[];
     };
+    /**
+     * Configuration for Worker Previews.
+     *
+     * Previews are branches of your Worker's main instance used to test features
+     * in development outside of production. This block defines the settings
+     * used when creating Preview deployments via `wrangler preview`.
+     *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#previews
+     *
+     * @inheritable
+     */
+    previews: PreviewsConfig | undefined;
 }
 type DurableObjectBindings = {
     /** The name of the binding used to refer to the Durable Object */
@@ -1386,6 +1493,11 @@ type WorkflowBinding = {
     script_name?: string;
     /** Whether the Workflow should be remote or not in local development */
     remote?: boolean;
+    /** Optional limits for the Workflow */
+    limits?: {
+        /** Maximum number of steps a Workflow instance can execute */
+        steps?: number;
+    };
 };
 /**
  * The `EnvironmentNonInheritable` interface declares all the configuration fields for an environment
@@ -1418,20 +1530,18 @@ interface EnvironmentNonInheritable {
      */
     vars: Record<string, string | Json>;
     /**
-     * Secrets configuration.
+     * Secrets configuration (experimental).
      *
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default undefined
      * @nonInheritable
      */
     secrets?: {
         /**
          * List of secret names that are required by your Worker.
          * When defined, this property:
-         * - Replaces .dev.vars/.env inference for type generation
-         * - Enables deploy-time validation to ensure secrets are configured
+         * - Replaces .dev.vars/.env/process.env inference for type generation
          * - Enables local dev validation with warnings for missing secrets
          */
         required?: string[];
@@ -1558,8 +1668,8 @@ interface EnvironmentNonInheritable {
         consumers?: {
             /** The name of the queue from which this consumer should consume. */
             queue: string;
-            /** The consumer type, e.g., worker, http-pull, r2-bucket, etc. Default is worker. */
-            type?: string;
+            /** The consumer type. Only "worker" is supported in wrangler config. Default is "worker". */
+            type?: "worker";
             /** The maximum number of messages per batch */
             max_batch_size?: number;
             /** The maximum number of seconds to wait to fill a batch with messages. */
@@ -1647,6 +1757,42 @@ interface EnvironmentNonInheritable {
         /** Whether the Vectorize index should be remote or not in local development */
         remote?: boolean;
     }[];
+    /**
+     * Specifies AI Search namespace bindings that are bound to this Worker environment.
+     * Each binding is scoped to a namespace and allows dynamic instance CRUD within it.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default []
+     * @nonInheritable
+     */
+    ai_search_namespaces: {
+        /** The binding name used to refer to the AI Search namespace in the Worker. */
+        binding: string;
+        /** The user-chosen namespace name. Must exist in Cloudflare at deploy time. */
+        namespace: string;
+        /** Whether the AI Search namespace binding should be remote in local development */
+        remote?: boolean;
+    }[];
+    /**
+     * Specifies AI Search instance bindings that are bound to this Worker environment.
+     * Each binding is bound directly to a single pre-existing instance within the "default" namespace.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default []
+     * @nonInheritable
+     */
+    ai_search: {
+        /** The binding name used to refer to the AI Search instance in the Worker. */
+        binding: string;
+        /** The user-chosen instance name. Must exist in Cloudflare at deploy time. */
+        instance_name: string;
+        /** Whether the AI Search instance binding should be remote in local development */
+        remote?: boolean;
+    }[];
     /**
      * Specifies Hyperdrive configs that are bound to this Worker environment.
      *
@@ -1780,6 +1926,20 @@ interface EnvironmentNonInheritable {
         /** Whether the Media binding should be remote or not */
         remote?: boolean;
     } | undefined;
+    /**
+     * Binding to Cloudflare Stream
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default {}
+     * @nonInheritable
+     */
+    stream: {
+        binding: string;
+        /** Whether the Stream binding should be remote or not in local development */
+        remote?: boolean;
+    } | undefined;
     /**
      * Binding to the Worker Version's metadata
      */
@@ -1916,6 +2076,24 @@ interface EnvironmentNonInheritable {
         /** Name of the secret */
         secret_name: string;
     }[];
+    /**
+     * Specifies Artifacts bindings that are bound to this Worker environment.
+     * Artifacts provides git-compatible file storage on Cloudflare Workers.
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @default []
+     * @nonInheritable
+     */
+    artifacts: {
+        /** The binding name used to refer to the Artifacts instance. */
+        binding: string;
+        /** The namespace to use. */
+        namespace: string;
+        /** Whether to use the remote Artifacts service in local dev. */
+        remote?: boolean;
+    }[];
     /**
      * **DO NOT USE**. Hello World Binding Config to serve as an explanatory example.
      *
@@ -1931,6 +2109,23 @@ interface EnvironmentNonInheritable {
         /** Whether the timer is enabled */
         enable_timer?: boolean;
     }[];
+    /**
+     * Specifies Flagship feature flag 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
+     */
+    flagship: {
+        /** The binding name used to refer to the bound Flagship service. */
+        binding: string;
+        /** The Flagship app ID to bind to. */
+        app_id: string;
+        /** Whether to use the remote Flagship service for flag evaluation in local dev. */
+        remote?: boolean;
+    }[];
     /**
      * Specifies rate limit bindings that are bound to this Worker environment.
      *
@@ -1983,6 +2178,30 @@ interface EnvironmentNonInheritable {
         /** Whether the VPC service is remote or not */
         remote?: boolean;
     }[];
+    /**
+     * Specifies VPC networks 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
+     */
+    vpc_networks: ({
+        /** The binding name used to refer to the VPC network in the Worker. */
+        binding: string;
+        /** The tunnel ID of the Cloudflare Tunnel to route traffic through. Mutually exclusive with network_id. */
+        tunnel_id: string;
+        /** Whether the VPC network is remote or not */
+        remote?: boolean;
+    } | {
+        /** The binding name used to refer to the VPC network in the Worker. */
+        binding: string;
+        /** The network ID to route traffic through. Mutually exclusive with tunnel_id. */
+        network_id: string;
+        /** Whether the VPC network is remote or not */
+        remote?: boolean;
+    })[];
 }
 /**
  * The raw environment configuration that we read from the config file.
@@ -2092,10 +2311,27 @@ interface CacheOptions {
 type DockerConfiguration = {
     /** Socket used by miniflare to communicate with Docker */
     socketPath: string;
+    /** Docker image name for the container egress interceptor sidecar */
+    containerEgressInterceptorImage?: string;
 };
 type ContainerEngine = {
     localDocker: DockerConfiguration;
 } | string;
+/**
+ * Configuration for Worker Previews.
+ *
+ * This defines the settings used when creating Preview deployments.
+ * Previews are branches of your Worker's main instance used to test features
+ * during feature development outside of production.
+ *
+ * The `previews` block contains any intentionally divergent configuration intended solely for Previews, including:
+ * - All non-inheritable properties (environment variables and bindings like KV, D1, R2, etc.)
+ * - Select inheritable properties: `logpush`, `observability`, `limits`
+ *
+ * @inheritable
+ */
+interface PreviewsConfig extends Partial<EnvironmentNonInheritable>, Partial<Pick<EnvironmentInheritable, "logpush" | "observability" | "limits">> {
+}
 
 /**
  * This is the static type definition for the configuration object.
@@ -2343,4 +2579,4 @@ interface EnvironmentMap {
 }
 declare const defaultWranglerConfig: Config;
 
-export { type CfWorkerLoader as $, type Assets as A, type Binding as B, type Config as C, type DurableObjectMigration as D, type Environment as E, type CfTextBlobBindings as F, type CfBrowserBinding as G, type CfAIBinding as H, type CfImagesBinding as I, type CfMediaBinding as J, type CfVersionMetadataBinding as K, type CfDataBlobBindings as L, type CfDurableObject as M, type CfWorkflow as N, type Observability as O, type CfQueue as P, type CfR2Bucket as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfD1Database as V, type WorkerMetadataBinding as W, type CfVectorize as X, type CfSecretsStoreSecrets as Y, type ZoneIdRoute as Z, type CfHelloWorld as _, type RedirectedRawConfig as a, type CfRateLimit as a0, type CfHyperdrive as a1, type CfService as a2, type CfVpcService as a3, type CfAnalyticsEngineDataset as a4, type CfDispatchNamespace as a5, type CfMTlsCertificate as a6, type CfLogfwdr as a7, type CfLogfwdrBinding as a8, type CfAssetsBinding as a9, type CfPipeline as aa, type CfUnsafeBinding as ab, type CfCapnp as ac, type CfUnsafe as ad, type CfDurableObjectMigrations as ae, type CfPlacement as af, type CfTailConsumer as ag, type CfUserLimits as ah, type CfWorkerInit as ai, type CfWorkerContext as aj, type CfWorkerSourceMap as ak, type Json as al, type AssetConfigMetadata as am, type WorkerMetadata as an, type ServiceMetadataRes as ao, type ServiceFetch as ap, type File as aq, type BinaryFile as ar, type Trigger as as, INHERIT_SYMBOL as at, SERVICE_TAG_PREFIX as au, ENVIRONMENT_TAG_PREFIX as av, PATH_TO_DEPLOY_CONFIG as aw, JSON_CONFIG_FORMATS as ax, type RawDevConfig as b, type ConfigFields as c, type RawEnvironment as d, defaultWranglerConfig as e, type ZoneNameRoute as f, type CustomDomainRoute as g, type Route as h, type CloudchamberConfig as i, type ContainerApp as j, type DurableObjectBindings as k, type WorkflowBinding as l, type EnvironmentNonInheritable as m, type Rule as n, type ConfigModuleRuleType as o, type DispatchNamespaceOutbound as p, type CacheOptions as q, type DockerConfiguration as r, type ContainerEngine as s, type CfScriptFormat as t, type CfModuleType as u, type CfModule as v, type CfVars as w, type CfKvNamespace as x, type CfSendEmailBindings as y, type CfWasmModuleBindings as z };
+export { type CfAISearchNamespace as $, type Assets as A, type Binding as B, type Config as C, type DurableObjectMigration as D, type Environment as E, type CfTextBlobBindings as F, type CfBrowserBinding as G, type CfAIBinding as H, type CfImagesBinding as I, type CfMediaBinding as J, type CfStreamBinding as K, type CfVersionMetadataBinding as L, type CfDataBlobBindings as M, type CfDurableObject as N, type Observability as O, type PreviewsConfig as P, type CfWorkflow as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfQueue as V, type WorkerMetadataBinding as W, type CfR2Bucket as X, type CfD1Database as Y, type ZoneIdRoute as Z, type CfVectorize as _, type RedirectedRawConfig as a, type CfAISearch as a0, type CfSecretsStoreSecrets as a1, type CfArtifacts as a2, type CfHelloWorld as a3, type CfFlagship as a4, type CfWorkerLoader as a5, type CfRateLimit as a6, type CfHyperdrive as a7, type CfService as a8, type CfVpcService as a9, INHERIT_SYMBOL as aA, SERVICE_TAG_PREFIX as aB, ENVIRONMENT_TAG_PREFIX as aC, PATH_TO_DEPLOY_CONFIG as aD, JSON_CONFIG_FORMATS as aE, type CfVpcNetwork as aa, type CfAnalyticsEngineDataset as ab, type CfDispatchNamespace as ac, type CfMTlsCertificate as ad, type CfLogfwdr as ae, type CfLogfwdrBinding as af, type CfAssetsBinding as ag, type CfPipeline as ah, type CfUnsafeBinding as ai, type CfCapnp as aj, type CfUnsafe as ak, type CfDurableObjectMigrations as al, type CfPlacement as am, type CfTailConsumer as an, type CfUserLimits as ao, type CfWorkerInit as ap, type CfWorkerContext as aq, type CfWorkerSourceMap as ar, type Json as as, type AssetConfigMetadata as at, type WorkerMetadata as au, type ServiceMetadataRes as av, type ServiceFetch as aw, type File as ax, type BinaryFile as ay, type Trigger as az, type RawDevConfig as b, type ConfigFields as c, type RawEnvironment as d, defaultWranglerConfig as e, type ZoneNameRoute as f, type CustomDomainRoute as g, type Route as h, type CloudchamberConfig as i, type ContainerApp as j, type DurableObjectBindings as k, type WorkflowBinding as l, type EnvironmentNonInheritable as m, type Rule as n, type ConfigModuleRuleType as o, type DispatchNamespaceOutbound as p, type CacheOptions as q, type DockerConfiguration as r, type ContainerEngine as s, type CfScriptFormat as t, type CfModuleType as u, type CfModule as v, type CfVars as w, type CfKvNamespace as x, type CfSendEmailBindings as y, type CfWasmModuleBindings as z };

package/dist/index.d.mts

@@ -1,7 +1,8 @@
-import { B as Binding, R as RawConfig, C as Config, W as WorkerMetadataBinding } from './config-BQZJPwXe.mjs';
-export { am as AssetConfigMetadata, A as Assets, ar as BinaryFile, q as CacheOptions, H as CfAIBinding, a4 as CfAnalyticsEngineDataset, a9 as CfAssetsBinding, G as CfBrowserBinding, ac as CfCapnp, V as CfD1Database, L as CfDataBlobBindings, a5 as CfDispatchNamespace, M as CfDurableObject, ae as CfDurableObjectMigrations, _ as CfHelloWorld, a1 as CfHyperdrive, I as CfImagesBinding, x as CfKvNamespace, a7 as CfLogfwdr, a8 as CfLogfwdrBinding, a6 as CfMTlsCertificate, J as CfMediaBinding, v as CfModule, u as CfModuleType, aa as CfPipeline, af as CfPlacement, P as CfQueue, Q as CfR2Bucket, a0 as CfRateLimit, t as CfScriptFormat, Y as CfSecretsStoreSecrets, y as CfSendEmailBindings, a2 as CfService, ag as CfTailConsumer, F as CfTextBlobBindings, ad as CfUnsafe, ab as CfUnsafeBinding, ah as CfUserLimits, w as CfVars, X as CfVectorize, K as CfVersionMetadataBinding, a3 as CfVpcService, z as CfWasmModuleBindings, aj as CfWorkerContext, ai as CfWorkerInit, $ as CfWorkerLoader, ak as CfWorkerSourceMap, N as CfWorkflow, i as CloudchamberConfig, c as ConfigFields, o as ConfigModuleRuleType, j as ContainerApp, s as ContainerEngine, g as CustomDomainRoute, p as DispatchNamespaceOutbound, r as DockerConfiguration, k as DurableObjectBindings, D as DurableObjectMigration, av as ENVIRONMENT_TAG_PREFIX, E as Environment, m as EnvironmentNonInheritable, aq as File, at as INHERIT_SYMBOL, ax as JSON_CONFIG_FORMATS, al as Json, O as Observability, aw as PATH_TO_DEPLOY_CONFIG, b as RawDevConfig, d as RawEnvironment, a as RedirectedRawConfig, h as Route, n as Rule, au as SERVICE_TAG_PREFIX, ap as ServiceFetch, ao as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, as as Trigger, U as UserLimits, an as WorkerMetadata, l as WorkflowBinding, Z as ZoneIdRoute, f as ZoneNameRoute, e as defaultWranglerConfig } from './config-BQZJPwXe.mjs';
+import { B as Binding, R as RawConfig, C as Config, W as WorkerMetadataBinding } from './config-_M2XwEUI.mjs';
+export { at as AssetConfigMetadata, A as Assets, ay as BinaryFile, q as CacheOptions, H as CfAIBinding, a0 as CfAISearch, $ as CfAISearchNamespace, ab as CfAnalyticsEngineDataset, a2 as CfArtifacts, ag as CfAssetsBinding, G as CfBrowserBinding, aj as CfCapnp, Y as CfD1Database, M as CfDataBlobBindings, ac as CfDispatchNamespace, N as CfDurableObject, al as CfDurableObjectMigrations, a4 as CfFlagship, a3 as CfHelloWorld, a7 as CfHyperdrive, I as CfImagesBinding, x as CfKvNamespace, ae as CfLogfwdr, af as CfLogfwdrBinding, ad as CfMTlsCertificate, J as CfMediaBinding, v as CfModule, u as CfModuleType, ah as CfPipeline, am as CfPlacement, V as CfQueue, X as CfR2Bucket, a6 as CfRateLimit, t as CfScriptFormat, a1 as CfSecretsStoreSecrets, y as CfSendEmailBindings, a8 as CfService, K as CfStreamBinding, an as CfTailConsumer, F as CfTextBlobBindings, ak as CfUnsafe, ai as CfUnsafeBinding, ao as CfUserLimits, w as CfVars, _ as CfVectorize, L as CfVersionMetadataBinding, aa as CfVpcNetwork, a9 as CfVpcService, z as CfWasmModuleBindings, aq as CfWorkerContext, ap as CfWorkerInit, a5 as CfWorkerLoader, ar as CfWorkerSourceMap, Q as CfWorkflow, i as CloudchamberConfig, c as ConfigFields, o as ConfigModuleRuleType, j as ContainerApp, s as ContainerEngine, g as CustomDomainRoute, p as DispatchNamespaceOutbound, r as DockerConfiguration, k as DurableObjectBindings, D as DurableObjectMigration, aC as ENVIRONMENT_TAG_PREFIX, E as Environment, m as EnvironmentNonInheritable, ax as File, aA as INHERIT_SYMBOL, aE as JSON_CONFIG_FORMATS, as as Json, O as Observability, aD as PATH_TO_DEPLOY_CONFIG, P as PreviewsConfig, b as RawDevConfig, d as RawEnvironment, a as RedirectedRawConfig, h as Route, n as Rule, aB as SERVICE_TAG_PREFIX, aw as ServiceFetch, av as ServiceMetadataRes, S as StreamingTailConsumer, T as TailConsumer, az as Trigger, U as UserLimits, au as WorkerMetadata, l as WorkflowBinding, Z as ZoneIdRoute, f as ZoneNameRoute, e as defaultWranglerConfig } from './config-_M2XwEUI.mjs';
 import * as jsoncParser from 'jsonc-parser';
 export { constructWranglerConfig } from './browser.mjs';
+export { Counter, MetricsRegistry } from './prometheus-metrics.mjs';
 import '@cloudflare/workers-shared';
 import 'cloudflare';
 
@@ -49,6 +50,8 @@ declare class Diagnostics {
     errors: string[];
     warnings: string[];
     children: Diagnostics[];
+    /** Set to true when an unexpected/unknown field is encountered during validation. */
+    hasUnexpectedFields: boolean;
     /**
      * Create a new Diagnostics object.
      * @param description A general description of this collection of messages.
@@ -60,6 +63,8 @@ declare class Diagnostics {
     addChild(diagnostics: Diagnostics): void;
     /** Does this or any of its children have errors. */
     hasErrors(): boolean;
+    /** Does this or any of its children have unexpected fields. */
+    hasUnexpectedFieldsInTree(): boolean;
     /** Render the errors of this and all its children. */
     renderErrors(): string;
     /** Does this or any of its children have warnings. */
@@ -83,7 +88,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" | "hyperdrive" | "r2_buckets" | "logfwdr" | "services" | "analytics_engine_datasets" | "text_blobs" | "browser" | "ai" | "images" | "media" | "version_metadata" | "unsafe" | "vars" | "wasm_modules" | "dispatch_namespaces" | "mtls_certificates" | "workflows" | "pipelines" | "secrets_store_secrets" | "ratelimits" | "assets" | "unsafe_hello_world" | "worker_loaders" | "vpc_services";
+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";
 /**
  * @deprecated new code should use getBindingTypeFriendlyName() instead
  */
@@ -133,6 +138,8 @@ declare function normalizeAndValidateConfig(rawConfig: RawConfig, configPath: st
  */
 declare function isDockerfile(imagePath: string, configPath: string | undefined): boolean;
 
+type ConfigBindingOptions = Pick<Config, "ai" | "browser" | "d1_databases" | "dispatch_namespaces" | "durable_objects" | "queues" | "r2_buckets" | "services" | "kv_namespaces" | "mtls_certificates" | "vectorize" | "workflows" | "vpc_services">;
+
 declare function configFormat(configPath: string | undefined): "json" | "jsonc" | "toml" | "none";
 declare function configFileName(configPath: string | undefined): "wrangler.json" | "wrangler.jsonc" | "wrangler.toml" | "Wrangler configuration";
 declare function formatConfigSnippet(snippet: RawConfig, configPath: Config["configPath"], formatted?: boolean): string;
@@ -252,6 +259,7 @@ declare class APIError extends ParseError {
     constructor({ status, ...rest }: Message & {
         status?: number;
     });
+    get status(): number | undefined;
     isGatewayError(): boolean;
     isRetryable(): boolean;
     get reportable(): boolean;
@@ -432,6 +440,8 @@ type VariableNames =
  | "CLOUDFLARE_ENV"
 /** Custom directory for Wrangler's cache files (overrides `node_modules/.cache/wrangler`). */
  | "WRANGLER_CACHE_DIR"
+/** Custom path to cloudflared binary (overrides automatic binary management). */
+ | "CLOUDFLARED_PATH"
 /** Set to "staging" to use staging APIs instead of production. */
  | "WRANGLER_API_ENVIRONMENT"
 /** Custom auth domain (usually auto-configured). */
@@ -446,8 +456,14 @@ type VariableNames =
  | "WRANGLER_REVOKE_URL"
 /** Direct authorization token for API requests. */
  | "WRANGLER_CF_AUTHORIZATION_TOKEN"
+/** Cloudflare Access Service Token Client ID. Used to authenticate with Access-protected domains in non-interactive environments (e.g. CI). */
+ | "CLOUDFLARE_ACCESS_CLIENT_ID"
+/** Cloudflare Access Service Token Client Secret. Used with CLOUDFLARE_ACCESS_CLIENT_ID. */
+ | "CLOUDFLARE_ACCESS_CLIENT_SECRET"
 /** Enable the local explorer UI at /cdn-cgi/explorer (experimental, default: false). */
  | "X_LOCAL_EXPLORER"
+/** Open the browser in headful (visible) mode when using the Browser Run API in local dev (default: false). */
+ | "X_BROWSER_HEADFUL"
 /** Override command used by `wrangler init` (default: "create cloudflare"). */
  | "WRANGLER_C3_COMMAND"
 /** Enable/disable telemetry data collection. */
@@ -694,9 +710,23 @@ declare const getCloudflareEnv: () => string | undefined;
 declare const getOpenNextDeployFromEnv: () => string | undefined;
 /**
  * `X_LOCAL_EXPLORER` enables the local explorer UI at /cdn-cgi/explorer.
- * This is an experimental feature flag. Defaults to false when not set.
  */
 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.
@@ -733,6 +763,13 @@ declare const getCfFetchPathFromEnv: () => string | undefined;
  * Useful for Yarn PnP or projects without node_modules.
  */
 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;
 
@@ -743,24 +780,6 @@ type DD = `${number}${number}`;
  * Represents a valid compatibility date, a string such as `2025-09-27`
  */
 type CompatDate = `${YYYY}-${MM}-${DD}`;
-type GetCompatDateOptions = {
-    projectPath?: string;
-};
-type GetCompatDateResult = {
-    date: CompatDate;
-    source: "workerd" | "fallback";
-};
-/**
- * Gets the compatibility date of the locally installed workerd package.
- *
- * If the package is not found the fallback date of 2025-09-27 is returned instead.
- *
- * Additionally, if the workerd date is set to the future then the current date is returned instead.
- *
- * @param options.projectPath the path to the project
- * @returns an object including the compatibility date and its source
- */
-declare function getLocalWorkerdCompatibilityDate({ projectPath, }?: GetCompatDateOptions): GetCompatDateResult;
 /**
  * Discern whether a string represents a compatibility date (`YYYY-MM-DD`)
  *
@@ -769,12 +788,9 @@ declare function getLocalWorkerdCompatibilityDate({ projectPath, }?: GetCompatDa
  */
 declare function isCompatDate(str: string): str is CompatDate;
 /**
- * Returns the date formatted as a compatibility date
- *
- * @param date The target date to convert
- * @returns The date as a CompatDate string (a string following the format `YYYY-MM-DD`)
+ * Returns today's date as a compatibility date string (`YYYY-MM-DD`).
  */
-declare function formatCompatibilityDate(date: Date): CompatDate;
+declare function getTodaysCompatDate(): CompatDate;
 
 /**
  * Returns whether the given path is a directory
@@ -815,4 +831,4 @@ declare function removeDir(dirPath: string, options?: {
  */
 declare function removeDirSync(dirPath: string): void;
 
-export { APIError, Binding, COMPLIANCE_REGION_CONFIG_PUBLIC, COMPLIANCE_REGION_CONFIG_UNKNOWN, CommandLineArgsError, type CompatDate, type ComplianceConfig, Config, type ConfigBindingFieldName, DeprecationError, FatalError, JsonFriendlyFatalError, type Location, type Message, MissingConfigError, type NormalizeAndValidateConfigArgs, type PackageJSON, ParseError, type ParseFile, PatchConfigError, RawConfig, type ResolveConfigPathOptions, type TelemetryMessage, UserError, WorkerMetadataBinding, assertNever, bucketFormatMessage, configFileName, configFormat, createFatalError, experimental_patchConfig, experimental_readRawConfig, findWranglerConfig, formatCompatibilityDate, formatConfigSnippet, friendlyBindingNames, getBindingTypeFriendlyName, getBooleanEnvironmentVariableFactory, getBuildConditionsFromEnv, getBuildPlatformFromEnv, getC3CommandFromEnv, getCIGeneratePreviewAlias, getCIMatchTag, getCIOverrideName, getCIOverrideNetworkModeHost, getCfFetchEnabledFromEnv, getCfFetchPathFromEnv, getCloudflareApiBaseUrl, getCloudflareApiEnvironmentFromEnv, getCloudflareComplianceRegion, getCloudflareEnv, getCloudflareIncludeProcessEnvFromEnv, getCloudflareLoadDevVarsFromDotEnv, getComplianceRegionSubdomain, getD1ExtraLocationChoices, getDisableConfigWatching, getDockerPath, getEnvironmentVariableFactory, getGlobalWranglerConfigPath, getLocalExplorerEnabledFromEnv, getLocalWorkerdCompatibilityDate, getOpenNextDeployFromEnv, getOutputFileDirectoryFromEnv, getOutputFilePathFromEnv, getRegistryPath, getSanitizeLogs, getSubdomainMixedStateCheckDisabled, getTraceHeader, getWorkersCIBranchName, getWranglerCacheDirFromEnv, getWranglerHideBanner, getWranglerSendErrorReportsFromEnv, getWranglerSendMetricsFromEnv, hasProperty, indexLocation, isCompatDate, isDirectory, isDockerfile, isOptionalProperty, isPagesConfig, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation, validatePagesConfig };
+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, 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, isRequiredProperty, isValidR2BucketName, mapWorkerMetadataBindings, normalizeAndValidateConfig, parseByteSize, parseHumanDuration, parseJSON, parseJSONC, parseNonHyphenedUuid, parsePackageJSON, parseTOML, readFileSync, readFileSyncToBuffer, removeDir, removeDirSync, resolveWranglerConfigPath, searchLocation, validatePagesConfig };