wrangler 4.30.0 → 4.32.0

package/wrangler-dist/cli.d.ts

@@ -1,11 +1,11 @@
-import { Json, Request, Response as Response$1, DispatchFetch, NodeJSCompatMode, Miniflare, MiniflareOptions, Mutex, WorkerOptions, ModuleRule, RemoteProxyConnectionString } from 'miniflare';
+import { Json, Request, Response as Response$1, DispatchFetch, NodeJSCompatMode, Miniflare, WorkerRegistry, MiniflareOptions, Mutex, WorkerOptions, ModuleRule, RemoteProxyConnectionString } from 'miniflare';
 import * as undici from 'undici';
 import { RequestInfo, RequestInit, Response, FormData } from 'undici';
 import { CamelCaseKey, ArgumentsCamelCase, InferredOptionTypes, Alias, PositionalOptions, Options } from 'yargs';
 import { RouterConfig, AssetConfig } from '@cloudflare/workers-shared';
+import { Metafile } from 'esbuild';
 import { EventEmitter } from 'node:events';
 import Protocol from 'devtools-protocol/types/protocol-mapping';
-import { Metafile } from 'esbuild';
 import { ContainerNormalizedConfig } from '@cloudflare/containers-shared';
 import { IncomingRequestCfProperties } from '@cloudflare/workers-types/experimental';
 import { URLSearchParams } from 'node:url';
@@ -150,11 +150,22 @@ type ContainerApp = {
         namespace_id: string;
     };
     /**
-     * How a rollout should be done, defining the size of it
+     * Configures what percentage of instances should be updated at each step of a rollout.
+     * You can specify this as a single number, or an array of numbers.
+     *
+     * If this is a single number, each step will progress by that percentage.
+     * The options are 5, 10, 20, 25, 50 or 100.
+     *
+     * If this is an array, each step specifies the cumulative rollout progress.
+     * The final step must be 100.
+     *
+     * This can be overridden adhoc by deploying with the `--containers-rollout=immediate` flag,
+     * which will roll out to 100% of instances in one step.
+     *
      * @optional
-     * @default 25
+     * @default [10,100]
      * */
-    rollout_step_percentage?: number;
+    rollout_step_percentage?: number | number[];
     /**
      * How a rollout should be created. It supports the following modes:
      *  - full_auto: The container application will be rolled out fully automatically.
@@ -162,6 +173,7 @@ type ContainerApp = {
      *  - manual: The container application will be rollout fully by manually actioning progress steps.
      * @optional
      * @default "full_auto"
+     * @hidden
      */
     rollout_kind?: "full_auto" | "none" | "full_manual";
     /**
@@ -770,9 +782,18 @@ interface EnvironmentNonInheritable {
     services: {
         /** The binding name used to refer to the bound service. */
         binding: string;
-        /** The name of the service. */
+        /**
+         * The name of the service.
+         * To bind to a worker in a specific environment,
+         * you should use the format `<worker_name>-<environment_name>`.
+         */
         service: string;
-        /** The environment of the service (e.g. production, staging, etc). */
+        /**
+         * @hidden
+         * @deprecated you should use `service: <worker_name>-<environment_name>` instead.
+         * This refers to the deprecated concept of 'service environments'.
+         * The environment of the service (e.g. production, staging, etc).
+         */
         environment?: string;
         /** Optionally, the entrypoint (named export) of the service to bind to. */
         entrypoint?: string;
@@ -1417,6 +1438,7 @@ interface CfKvNamespace {
  */
 type CfSendEmailBindings = {
     name: string;
+    experimental_remote?: boolean;
 } & ({
     destination_address?: string;
 } | {
@@ -1527,6 +1549,7 @@ interface CfLogfwdrBinding {
 interface CfPipeline {
     binding: string;
     pipeline: string;
+    experimental_remote?: boolean;
 }
 interface CfUnsafeBinding {
     name: string;
@@ -1775,7 +1798,6 @@ declare function deploy({ directory, accountId, projectName, branch, skipCaching
         modified_on: string;
         short_id: string;
         build_image_major_version: number;
-        kv_namespaces?: any;
         source?: {
             type: "github" | "gitlab";
             config: {
@@ -1790,6 +1812,7 @@ declare function deploy({ directory, accountId, projectName, branch, skipCaching
                 preview_branch_excludes?: string[] | undefined;
             };
         } | undefined;
+        kv_namespaces?: any;
         env_vars?: any;
         durable_object_namespaces?: any;
         is_skipped?: boolean | undefined;
@@ -1809,26 +1832,6 @@ declare const unstable_pages: {
  */
 type ComplianceConfig = Partial<Pick<Config, "compliance_region">>;
 
-type WorkerRegistry = Record<string, WorkerDefinition>;
-type WorkerEntrypointsDefinition = Record<"default" | string, {
-    host: string;
-    port: number;
-} | undefined>;
-type WorkerDefinition = {
-    port: number | undefined;
-    protocol: "http" | "https" | undefined;
-    host: string | undefined;
-    mode: "local" | "remote";
-    headers?: Record<string, string>;
-    entrypointAddresses?: WorkerEntrypointsDefinition;
-    durableObjects: {
-        name: string;
-        className: string;
-    }[];
-    durableObjectsHost?: string;
-    durableObjectsPort?: number;
-};
-
 type _Params<ParamsArray extends [unknown?]> = ParamsArray extends [infer P] ? P : undefined;
 type _EventMethods = keyof Protocol.Events;
 type DevToolsEvent<Method extends _EventMethods> = Method extends unknown ? {
@@ -1946,6 +1949,7 @@ declare class ConfigController extends Controller<ConfigControllerEventMap> {
     latestConfig?: StartDevWorkerOptions;
     set(input: StartDevWorkerInput, throwErrors?: boolean): Promise<StartDevWorkerOptions | undefined>;
     patch(input: Partial<StartDevWorkerInput>): Promise<StartDevWorkerOptions | undefined>;
+    onDevRegistryUpdate(event: DevRegistryUpdateEvent): void;
     teardown(): Promise<void>;
     emitConfigUpdateEvent(config: StartDevWorkerOptions): void;
 }
@@ -2071,8 +2075,6 @@ interface StartDevWorkerInput {
         outboundService?: ServiceFetch;
         /** An undici MockAgent to declaratively mock fetch calls to particular resources. */
         mockFetch?: undici.MockAgent;
-        /** Describes the registry of other Workers running locally */
-        registry?: WorkerRegistry | null;
         testScheduled?: boolean;
         /** Whether to use Vectorize as a remote binding -- the worker is run locally but accesses to Vectorize are made remotely */
         bindVectorizeToProd?: boolean;
@@ -2085,6 +2087,8 @@ interface StartDevWorkerInput {
         containerBuildId?: string;
         /** Whether to build and connect to containers during local dev. Requires Docker daemon to be running. Defaults to true. */
         enableContainers?: boolean;
+        /** Path to the dev registry directory */
+        registry?: string;
         /** Path to the docker executable. Defaults to 'docker' */
         dockerPath?: string;
         /** Options for the container engine */
@@ -2260,6 +2264,10 @@ type ReloadCompleteEvent = {
     bundle: Bundle;
     proxyData: ProxyData;
 };
+type DevRegistryUpdateEvent = {
+    type: "devRegistryUpdate";
+    registry: WorkerRegistry;
+};
 type PreviewTokenExpiredEvent = {
     type: "previewTokenExpired";
     proxyData: ProxyData;
@@ -2322,8 +2330,6 @@ type ProxyData = {
     headers: Record<string, string>;
     liveReload?: boolean;
     proxyLogsToController?: boolean;
-    internalDurableObjects?: CfDurableObject[];
-    entrypointAddresses: WorkerEntrypointsDefinition | undefined;
 };
 
 interface TypedEventEmitter<EventMap extends Record<string | symbol, unknown[]>> extends EventEmitter {
@@ -2352,6 +2358,7 @@ declare abstract class Controller<EventMap extends ControllerEventMap = Controll
 type RuntimeControllerEventMap = ControllerEventMap & {
     reloadStart: [ReloadStartEvent];
     reloadComplete: [ReloadCompleteEvent];
+    devRegistryUpdate: [DevRegistryUpdateEvent];
 };
 declare abstract class RuntimeController extends Controller<RuntimeControllerEventMap> {
     abstract onBundleStart(_: BundleStartEvent): void;
@@ -2653,9 +2660,6 @@ type WorkerConfigObject = {
 /**
  * Utility for potentially starting or updating a remote proxy session.
  *
- * It uses an internal map for storing existing remote proxy session indexed by worker names. If no worker name is provided
- * the remote proxy session won't be retrieved nor saved to/from the internal map.
- *
  * @param wranglerOrWorkerConfigObject either a file path to a wrangler configuration file or an object containing the name of
  *                                 the target worker alongside its bindings.
  * @param preExistingRemoteProxySessionData the optional data of a pre-existing remote proxy session if there was one, this
@@ -2740,6 +2744,7 @@ type ExperimentalFlags = {
     MULTIWORKER: boolean;
     RESOURCES_PROVISION: boolean;
     REMOTE_BINDINGS: boolean;
+    DEPLOY_REMOTE_DIFF_CHECK: boolean;
 };
 
 // Team names from https://wiki.cfdata.org/display/EW/Developer+Platform+Components+and+Pillar+Ownership