wrangler 4.37.1 → 4.39.0

package/wrangler-dist/cli.d.ts

@@ -547,7 +547,7 @@ type WorkflowBinding = {
     class_name: string;
     /** The script where the Workflow is defined (if it's external to this Worker) */
     script_name?: string;
-    /** Whether the Workflow should be remote or not */
+    /** Whether the Workflow should be remote or not in local development */
     remote?: boolean;
 };
 /**
@@ -649,7 +649,7 @@ interface EnvironmentNonInheritable {
         id?: string;
         /** The ID of the KV namespace used during `wrangler dev` */
         preview_id?: string;
-        /** Whether the KV namespace should be remote or not */
+        /** Whether the KV namespace should be remote or not in local development */
         remote?: boolean;
     }[];
     /**
@@ -670,7 +670,9 @@ interface EnvironmentNonInheritable {
         destination_address?: string;
         /** If this binding should be restricted to a set of verified addresses */
         allowed_destination_addresses?: string[];
-        /** Whether the binding should be remote or not */
+        /** If this binding should be restricted to a set of sender addresses */
+        allowed_sender_addresses?: string[];
+        /** Whether the binding should be remote or not in local development */
         remote?: boolean;
     }[];
     /**
@@ -693,7 +695,7 @@ interface EnvironmentNonInheritable {
             queue: string;
             /** The number of seconds to wait before delivering a message */
             delivery_delay?: number;
-            /** Whether the Queue producer should be remote or not */
+            /** Whether the Queue producer should be remote or not in local development */
             remote?: boolean;
         }[];
         /** Consumer configuration */
@@ -738,7 +740,7 @@ interface EnvironmentNonInheritable {
         preview_bucket_name?: string;
         /** The jurisdiction that the bucket exists in. Default if not present. */
         jurisdiction?: string;
-        /** Whether the R2 bucket should be remote or not */
+        /** Whether the R2 bucket should be remote or not in local development */
         remote?: boolean;
     }[];
     /**
@@ -767,7 +769,7 @@ interface EnvironmentNonInheritable {
         migrations_dir?: string;
         /** Internal use only. */
         database_internal_env?: string;
-        /** Whether the D1 database should be remote or not */
+        /** Whether the D1 database should be remote or not in local development */
         remote?: boolean;
     }[];
     /**
@@ -786,7 +788,7 @@ interface EnvironmentNonInheritable {
         binding: string;
         /** The name of the index. */
         index_name: string;
-        /** Whether the Vectorize index should be remote or not */
+        /** Whether the Vectorize index should be remote or not in local development */
         remote?: boolean;
     }[];
     /**
@@ -839,7 +841,7 @@ interface EnvironmentNonInheritable {
         entrypoint?: string;
         /** Optional properties that will be made available to the service via ctx.props. */
         props?: Record<string, unknown>;
-        /** Whether the service binding should be remote or not */
+        /** Whether the service binding should be remote or not in local development */
         remote?: boolean;
     }[] | undefined;
     /**
@@ -872,7 +874,7 @@ interface EnvironmentNonInheritable {
      */
     browser: {
         binding: string;
-        /** Whether the Browser binding should be remote or not */
+        /** Whether the Browser binding should be remote or not in local development */
         remote?: boolean;
     } | undefined;
     /**
@@ -889,7 +891,7 @@ interface EnvironmentNonInheritable {
     ai: {
         binding: string;
         staging?: boolean;
-        /** Whether the AI binding should be remote or not */
+        /** Whether the AI binding should be remote or not in local development */
         remote?: boolean;
     } | undefined;
     /**
@@ -905,7 +907,7 @@ interface EnvironmentNonInheritable {
      */
     images: {
         binding: string;
-        /** Whether the Images binding should be remote or not */
+        /** Whether the Images binding should be remote or not in local development */
         remote?: boolean;
     } | undefined;
     /**
@@ -966,7 +968,7 @@ interface EnvironmentNonInheritable {
         binding: string;
         /** The uuid of the uploaded mTLS certificate */
         certificate_id: string;
-        /** Whether the mtls fetcher should be remote or not */
+        /** Whether the mtls fetcher should be remote or not in local development */
         remote?: boolean;
     }[];
     /**
@@ -997,7 +999,7 @@ interface EnvironmentNonInheritable {
         namespace: string;
         /** Details about the outbound Worker which will handle outbound requests from your namespace */
         outbound?: DispatchNamespaceOutbound;
-        /** Whether the Dispatch Namespace should be remote or not */
+        /** Whether the Dispatch Namespace should be remote or not in local development */
         remote?: boolean;
     }[];
     /**
@@ -1014,6 +1016,8 @@ interface EnvironmentNonInheritable {
         binding: string;
         /** Name of the Pipeline to bind */
         pipeline: string;
+        /** Whether the pipeline should be remote or not in local development */
+        remote?: boolean;
     }[];
     /**
      * Specifies Secret Store bindings that are bound to this Worker environment.
@@ -1069,6 +1073,36 @@ interface EnvironmentNonInheritable {
             period: 10 | 60;
         };
     }[];
+    /**
+     * Specifies Worker Loader 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
+     */
+    worker_loaders: {
+        /** The binding name used to refer to the Worker Loader in the Worker. */
+        binding: string;
+    }[];
+    /**
+     * Specifies VPC services 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_services: {
+        /** The binding name used to refer to the VPC service in the Worker. */
+        binding: string;
+        /** The service ID of the VPC connectivity service. */
+        service_id: string;
+        /** Whether the VPC service is remote or not */
+        remote?: boolean;
+    }[];
 }
 /**
  * The raw environment configuration that we read from the config file.
@@ -1249,7 +1283,17 @@ type CfSendEmailBindings = {
     destination_address?: string;
 } | {
     allowed_destination_addresses?: string[];
+} | {
+    allowed_sender_addresses?: string[];
 });
+/**
+ * A binding to a browser
+ */
+interface CfBrowserBinding {
+    binding: string;
+    raw?: boolean;
+    remote?: boolean;
+}
 /**
  * A binding to the AI project
  */
@@ -1259,6 +1303,14 @@ interface CfAIBinding {
     remote?: boolean;
     raw?: boolean;
 }
+/**
+ * A binding to Cloudflare Images
+ */
+interface CfImagesBinding {
+    binding: string;
+    raw?: boolean;
+    remote?: boolean;
+}
 /**
  * A Durable Object.
  */
@@ -1316,6 +1368,9 @@ interface CfHelloWorld {
     binding: string;
     enable_timer?: boolean;
 }
+interface CfWorkerLoader {
+    binding: string;
+}
 interface CfRateLimit {
     name: string;
     namespace_id: string;
@@ -1337,6 +1392,11 @@ interface CfService {
     props?: Record<string, unknown>;
     remote?: boolean;
 }
+interface CfVpcService {
+    binding: string;
+    service_id: string;
+    remote?: boolean;
+}
 interface CfAnalyticsEngineDataset {
     binding: string;
     dataset?: string;
@@ -1708,7 +1768,7 @@ type ReadConfigOptions = ResolveConfigPathOptions & {
     hideWarnings?: boolean;
     preserveOriginalMain?: boolean;
 };
-type ConfigBindingOptions = Pick<Config, "ai" | "browser" | "d1_databases" | "dispatch_namespaces" | "durable_objects" | "queues" | "r2_buckets" | "services" | "kv_namespaces" | "mtls_certificates" | "vectorize" | "workflows">;
+type ConfigBindingOptions = Pick<Config, "ai" | "browser" | "d1_databases" | "dispatch_namespaces" | "durable_objects" | "queues" | "r2_buckets" | "services" | "kv_namespaces" | "mtls_certificates" | "vectorize" | "workflows" | "vpc_services">;
 /**
  * Get the Wrangler configuration; read it from the give `configPath` if available.
  */
@@ -2294,13 +2354,13 @@ type Binding = {
 } | {
     type: "text_blob";
     source: File;
-} | {
-    type: "browser";
 } | ({
+    type: "browser";
+} & BindingOmit<CfBrowserBinding>) | ({
     type: "ai";
-} & BindingOmit<CfAIBinding>) | {
+} & BindingOmit<CfAIBinding>) | ({
     type: "images";
-} | {
+} & BindingOmit<CfImagesBinding>) | {
     type: "version_metadata";
 } | {
     type: "data_blob";
@@ -2340,7 +2400,11 @@ type Binding = {
     type: "unsafe_hello_world";
 } & BindingOmit<CfHelloWorld>) | ({
     type: "ratelimit";
-} & NameOmit<CfRateLimit>) | {
+} & NameOmit<CfRateLimit>) | ({
+    type: "worker_loader";
+} & BindingOmit<CfWorkerLoader>) | ({
+    type: "vpc_service";
+} & BindingOmit<CfVpcService>) | {
     type: `unsafe_${string}`;
 } | {
     type: "assets";
@@ -2752,10 +2816,6 @@ declare function unstable_getMiniflareWorkerOptions(config: Config, env?: string
     containerBuildId?: string;
 }): Unstable_MiniflareWorkerOptions;
 
-type RemoteProxySession = Pick<Worker, "ready" | "dispose"> & {
-    updateBindings: (bindings: StartDevWorkerInput["bindings"]) => Promise<void>;
-    remoteProxyConnectionString: RemoteProxyConnectionString;
-};
 type StartRemoteProxySessionOptions = {
     workerName?: string;
     auth?: NonNullable<StartDevWorkerInput["dev"]>["auth"];
@@ -2763,6 +2823,11 @@ type StartRemoteProxySessionOptions = {
     complianceRegion?: Config["compliance_region"];
 };
 declare function startRemoteProxySession(bindings: StartDevWorkerInput["bindings"], options?: StartRemoteProxySessionOptions): Promise<RemoteProxySession>;
+type RemoteProxySession = Pick<Worker, "ready" | "dispose"> & {
+    updateBindings: (bindings: StartDevWorkerInput["bindings"]) => Promise<void>;
+    remoteProxyConnectionString: RemoteProxyConnectionString;
+};
+
 type WranglerConfigObject = {
     /** The path to the wrangler config file */
     path: string;