@cloudflare/workers-utils 0.12.0 → 0.19.0

package/dist/{config-BQZJPwXe.d.mts → config-CnJQHRQs.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
@@ -1423,15 +1535,15 @@ interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
-     * @default undefined
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#secrets-configuration-property
+     *
      * @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 +1670,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 +1759,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 +1928,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 +2078,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 +2111,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;
+        /** Set to `true` to suppress the remote binding warning in local dev. Flagship bindings are always remote. */
+        remote?: boolean;
+    }[];
     /**
      * Specifies rate limit bindings that are bound to this Worker environment.
      *
@@ -1983,6 +2180,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 +2313,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 +2581,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 };