wrangler 4.15.2 → 4.16.1

package/wrangler-dist/cli.d.ts

@@ -329,7 +329,7 @@ declare type Binding = {
 
 declare type BindingOmit<T> = Omit<T, "binding">;
 
-declare type BindingsOpt = StartDevWorkerInput["bindings"];
+declare type BindingsOpt = NonNullable<StartDevWorkerInput["bindings"]>;
 
 declare interface BlobPropertyBag {
     type?: string
@@ -588,6 +588,7 @@ declare interface CfD1Database {
     migrations_table?: string;
     migrations_dir?: string;
     remote?: boolean;
+    raw?: boolean;
 }
 
 declare interface CfDispatchNamespace {
@@ -623,6 +624,7 @@ declare interface CfKvNamespace {
     binding: string;
     id?: string | typeof INHERIT_SYMBOL;
     remote?: boolean;
+    raw?: boolean;
 }
 
 declare interface CfLogfwdrBinding {
@@ -695,6 +697,7 @@ declare interface CfQueue {
     queue_name: string;
     delivery_delay?: number;
     remote?: boolean;
+    raw?: boolean;
 }
 
 declare interface CfR2Bucket {
@@ -702,6 +705,7 @@ declare interface CfR2Bucket {
     bucket_name?: string | typeof INHERIT_SYMBOL;
     jurisdiction?: string;
     remote?: boolean;
+    raw?: boolean;
 }
 
 /**
@@ -756,6 +760,7 @@ declare type CfUnsafeMetadata = Record<string, unknown>;
 declare interface CfVectorize {
     binding: string;
     index_name: string;
+    raw?: boolean;
 }
 
 declare interface CfWorkerSourceMap {
@@ -790,6 +795,7 @@ declare interface CfWorkflow {
     binding: string;
     script_name?: string;
     remote?: boolean;
+    raw?: boolean;
 }
 
 /**
@@ -956,6 +962,8 @@ declare interface ConfigFields<Dev extends RawDevConfig> {
     send_metrics: boolean | undefined;
     /**
      * Options to configure the development server that your worker will use.
+     *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#local-development-settings
      */
     dev: Dev;
     /**
@@ -963,6 +971,8 @@ declare interface ConfigFields<Dev extends RawDevConfig> {
      * static assets with your Worker.
      *
      * More details at https://developers.cloudflare.com/workers/platform/sites
+     *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#workers-sites
      */
     site: {
         /**
@@ -1027,6 +1037,8 @@ declare interface ConfigFields<Dev extends RawDevConfig> {
     /**
      * A map of module aliases. Lets you swap out a module for any others.
      * Corresponds with esbuild's `alias` config
+     *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#module-aliasing
      */
     alias: {
         [key: string]: string;
@@ -1109,6 +1121,13 @@ declare type ContainerApp = {
     };
     /** How a rollout should be done, defining the size of it */
     rollout_step_percentage?: number;
+    /**
+     * How a rollout should be created. It supports the following modes:
+     *  - full_auto: The container application will be rolled out fully automatically.
+     *  - none: The container application won't have a roll out or update.
+     *  - manual: The container application will be rollout fully by manually actioning progress steps.
+     */
+    rollout_kind?: "full_auto" | "none" | "full_manual";
 };
 
 declare abstract class Controller<EventMap extends ControllerEventMap = ControllerEventMap> extends TypedEventEmitterImpl<EventMap> {
@@ -1718,6 +1737,7 @@ declare interface EnvironmentInheritable {
      * Whether we use <name>.<subdomain>.workers.dev to
      * test and deploy your Worker.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#workersdev
      *
      * @default true
      * @breaking
@@ -1738,6 +1758,8 @@ declare interface EnvironmentInheritable {
      *
      * Only required when workers_dev is false, and there's no scheduled Worker (see `triggers`)
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#types-of-routes
+     *
      * @inheritable
      */
     routes: Route[] | undefined;
@@ -1789,16 +1811,20 @@ declare interface EnvironmentInheritable {
      *
      * More details here https://developers.cloudflare.com/workers/platform/cron-triggers
      *
-     * @default {crons:[]}
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#triggers
+     *
+     * @default {crons: undefined}
      * @inheritable
      */
     triggers: {
-        crons: string[];
+        crons: string[] | undefined;
     };
     /**
      * Specify limits for runtime behavior.
      * Only supported for the "standard" Usage Model
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#limits
+     *
      * @inheritable
      */
     limits: UserLimits | undefined;
@@ -1808,6 +1834,8 @@ declare interface EnvironmentInheritable {
      * to use Text, Data, and CompiledWasm modules, or when you wish to
      * have a .js file be treated as an ESModule instead of CommonJS.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#bundling
+     *
      * @inheritable
      */
     rules: Rule[];
@@ -1817,6 +1845,8 @@ declare interface EnvironmentInheritable {
      * Refer to the [custom builds documentation](https://developers.cloudflare.com/workers/cli-wrangler/configuration#build)
      * for more details.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#custom-builds
+     *
      * @default {watch_dir:"./src"}
      */
     build: {
@@ -1877,6 +1907,9 @@ declare interface EnvironmentInheritable {
     logpush: boolean | undefined;
     /**
      * Include source maps when uploading this worker.
+     *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#source-maps
+     *
      * @inheritable
      */
     upload_source_maps: boolean | undefined;
@@ -1896,12 +1929,16 @@ declare interface EnvironmentInheritable {
      *
      * More details at https://developers.cloudflare.com/workers/frameworks/
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#assets
+     *
      * @inheritable
      */
     assets: Assets | undefined;
     /**
      * Specify the observability behavior of the Worker.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#observability
+     *
      * @inheritable
      */
     observability: Observability | undefined;
@@ -1949,6 +1986,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#environment-variables
+     *
      * @default {}
      * @nonInheritable
      */
@@ -1962,6 +2001,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects
+     *
      * @default {bindings:[]}
      * @nonInheritable
      */
@@ -2005,6 +2046,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#kv-namespaces
+     *
      * @default []
      * @nonInheritable
      */
@@ -2024,6 +2067,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#email-bindings
+     *
      * @default []
      * @nonInheritable
      */
@@ -2041,6 +2086,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#queues
+     *
      * @default {consumers:[],producers:[]}
      * @nonInheritable
      */
@@ -2084,6 +2131,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#r2-buckets
+     *
      * @default []
      * @nonInheritable
      */
@@ -2105,6 +2154,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#d1-databases
+     *
      * @default []
      * @nonInheritable
      */
@@ -2132,6 +2183,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#vectorize-indexes
+     *
      * @default []
      * @nonInheritable
      */
@@ -2147,6 +2200,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#hyperdrive
+     *
      * @default []
      * @nonInheritable
      */
@@ -2164,6 +2219,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#service-bindings
+     *
      * @default []
      * @nonInheritable
      */
@@ -2187,6 +2244,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#analytics-engine-datasets
+     *
      * @default []
      * @nonInheritable
      */
@@ -2202,6 +2261,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#browser-rendering
+     *
      * @default {}
      * @nonInheritable
      */
@@ -2214,6 +2275,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#workers-ai
+     *
      * @default {}
      * @nonInheritable
      */
@@ -2227,6 +2290,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#images
+     *
      * @default {}
      * @nonInheritable
      */
@@ -2285,6 +2350,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#mtls-certificates
+     *
      * @default []
      * @nonInheritable
      */
@@ -2310,6 +2377,8 @@ declare interface EnvironmentNonInheritable {
      * NOTE: This field is not automatically inherited from the top level environment,
      * and so must be specified in every named environment.
      *
+     * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#dispatch-namespace-bindings-workers-for-platforms
+     *
      * @default []
      * @nonInheritable
      */
@@ -2562,6 +2631,7 @@ declare type EventTarget_2 = typeof globalThis extends { EventTarget: infer T }
 declare class ExecutionContext {
     waitUntil(promise: Promise<any>): void;
     passThroughOnException(): void;
+    props: any;
 }
 
 export declare const experimental_patchConfig: (configPath: string, patch: Unstable_RawConfig, isArrayInsertion?: boolean) => string;
@@ -2950,8 +3020,8 @@ declare interface MIMEType {
 declare type MiniflareWorker = Awaited<ReturnType<Miniflare["getWorker"]>>;
 
 declare type MixedModeSession = Pick<Worker, "ready" | "dispose"> & {
-    ["setConfig"]: (bindings: BindingsOpt) => Promise<void>;
-    ["mixedModeConnectionString"]: MixedModeConnectionString;
+    updateBindings: (bindings: BindingsOpt) => Promise<void>;
+    mixedModeConnectionString: MixedModeConnectionString;
 };
 
 /** A mocked Agent class that implements the Agent API. It allows one to intercept HTTP requests made through undici and return mocked responses instead. */
@@ -26234,8 +26304,8 @@ declare interface StartDevWorkerInput {
             port?: number;
             secure?: boolean;
         };
-        /** Whether the worker runs on the edge or locally. */
-        remote?: boolean;
+        /** Whether the worker runs on the edge or locally. Can also be set to "minimal" for minimal mode. */
+        remote?: boolean | "minimal";
         /** Cloudflare Account credentials. Can be provided upfront or as a function which will be called only when required. */
         auth?: AsyncHook<CfAccount, [Pick<Unstable_Config, "account_id">]>;
         /** Whether local storage (KV, Durable Objects, R2, D1, etc) is persisted. You can also specify the directory to persist data to. */
@@ -26613,11 +26683,17 @@ export declare interface Unstable_DevWorker {
 export declare const unstable_generateASSETSBinding: (opts: Unstable_ASSETSBindingsOptions) => (request: Request_3) => Promise<Response_3>;
 
 export declare function unstable_getMiniflareWorkerOptions(configPath: string, env?: string, options?: {
-    imagesLocalMode: boolean;
+    imagesLocalMode?: boolean;
+    overrides?: {
+        assets?: Partial<AssetsOptions>;
+    };
 }): Unstable_MiniflareWorkerOptions;
 
 export declare function unstable_getMiniflareWorkerOptions(config: Unstable_Config, env?: string, options?: {
-    imagesLocalMode: boolean;
+    imagesLocalMode?: boolean;
+    overrides?: {
+        assets?: Partial<AssetsOptions>;
+    };
 }): Unstable_MiniflareWorkerOptions;
 
 export declare interface Unstable_MiniflareWorkerOptions {