@cloudflare/workers-utils 0.11.2 → 0.18.0

package/dist/{config-DAxLpjUL.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;
@@ -385,6 +421,7 @@ interface CfWorkerInit {
         _headers?: string;
     } | undefined;
     observability: Observability | undefined;
+    cache: CacheOptions | undefined;
 }
 interface CfWorkerContext {
     env: string | undefined;
@@ -459,6 +496,9 @@ type WorkerMetadataBinding = {
     type: "images";
     name: string;
     raw?: boolean;
+} | {
+    type: "stream";
+    name: string;
 } | {
     type: "version_metadata";
     name: string;
@@ -466,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;
@@ -559,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;
@@ -575,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;
@@ -688,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 = {
@@ -722,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";
@@ -740,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";
@@ -757,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}`;
@@ -798,6 +871,8 @@ type ZoneNameRoute = {
 type CustomDomainRoute = {
     pattern: string;
     custom_domain: boolean;
+    enabled?: boolean;
+    previews_enabled?: boolean;
 };
 type Route = SimpleRoute | ZoneIdRoute | ZoneNameRoute | CustomDomainRoute;
 /**
@@ -910,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
@@ -922,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.
      */
@@ -960,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[];
     };
     /**
@@ -1334,6 +1430,13 @@ interface EnvironmentInheritable {
      * @inheritable
      */
     observability: Observability | undefined;
+    /**
+     * Specify the cache behavior of the Worker.
+     *
+     * @inheritable
+     * @hidden
+     */
+    cache: CacheOptions | undefined;
     /**
      * Specify the compliance region mode of the Worker.
      *
@@ -1356,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 */
@@ -1378,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
@@ -1409,6 +1529,23 @@ interface EnvironmentNonInheritable {
      * @nonInheritable
      */
     vars: Record<string, string | Json>;
+    /**
+     * Secrets configuration (experimental).
+     *
+     * NOTE: This field is not automatically inherited from the top level environment,
+     * and so must be specified in every named environment.
+     *
+     * @nonInheritable
+     */
+    secrets?: {
+        /**
+         * List of secret names that are required by your Worker.
+         * When defined, this property:
+         * - Replaces .dev.vars/.env/process.env inference for type generation
+         * - Enables local dev validation with warnings for missing secrets
+         */
+        required?: string[];
+    };
     /**
      * A list of durable objects that your Worker should be bound to.
      *
@@ -1531,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. */
@@ -1620,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.
      *
@@ -1753,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
      */
@@ -1889,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.
      *
@@ -1904,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.
      *
@@ -1956,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.
@@ -2058,13 +2304,34 @@ interface Observability {
         destinations?: string[];
     };
 }
+interface CacheOptions {
+    /** If cache is enabled for this Worker */
+    enabled: boolean;
+}
 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.
@@ -2312,4 +2579,4 @@ interface EnvironmentMap {
 }
 declare const defaultWranglerConfig: Config;
 
-export { type CfRateLimit as $, type Assets as A, type Binding as B, type Config as C, type DurableObjectMigration as D, type Environment as E, type CfBrowserBinding as F, type CfAIBinding as G, type CfImagesBinding as H, type CfMediaBinding as I, type CfVersionMetadataBinding as J, type CfDataBlobBindings as K, type CfDurableObject as L, type CfWorkflow as M, type CfQueue as N, type Observability as O, type CfR2Bucket as P, type CfD1Database as Q, type RawConfig as R, type StreamingTailConsumer as S, type TailConsumer as T, type UserLimits as U, type CfVectorize as V, type WorkerMetadataBinding as W, type CfSecretsStoreSecrets as X, type CfHelloWorld as Y, type ZoneIdRoute as Z, type CfWorkerLoader as _, type RedirectedRawConfig as a, type CfHyperdrive as a0, type CfService as a1, type CfVpcService as a2, type CfAnalyticsEngineDataset as a3, type CfDispatchNamespace as a4, type CfMTlsCertificate as a5, type CfLogfwdr as a6, type CfLogfwdrBinding as a7, type CfAssetsBinding as a8, type CfPipeline as a9, type CfUnsafeBinding as aa, type CfCapnp as ab, type CfUnsafe as ac, type CfDurableObjectMigrations as ad, type CfPlacement as ae, type CfTailConsumer as af, type CfUserLimits as ag, type CfWorkerInit as ah, type CfWorkerContext as ai, type CfWorkerSourceMap as aj, type Json as ak, type AssetConfigMetadata as al, type WorkerMetadata as am, type ServiceMetadataRes as an, type ServiceFetch as ao, type File as ap, type BinaryFile as aq, type Trigger as ar, INHERIT_SYMBOL as as, SERVICE_TAG_PREFIX as at, ENVIRONMENT_TAG_PREFIX as au, PATH_TO_DEPLOY_CONFIG as av, JSON_CONFIG_FORMATS as aw, 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 DockerConfiguration as q, type ContainerEngine as r, type CfScriptFormat as s, type CfModuleType as t, type CfModule as u, type CfVars as v, type CfKvNamespace as w, type CfSendEmailBindings as x, type CfWasmModuleBindings as y, type CfTextBlobBindings 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 };