@cloudflare/vite-plugin 1.53.0 → 1.54.0

package/dist/experimental-config.d.mts

@@ -1,6 +1,6 @@
 import { Pipeline, PipelineRecord } from "cloudflare:pipelines";
 
-//#region ../config/dist/public-CwG0JcrK.d.mts
+//#region ../config/dist/public-C3uXDKsB.d.mts
 
 //#region src/utils.d.ts
 /**
@@ -11,11 +11,16 @@ type Json = string | number | boolean | null | Json[] | {
 };
 //#endregion
 //#region src/bindings.d.ts
+/** Options that control a binding during local development. */
+interface BindingDevOptions {
+  /** Whether the binding should connect to the remote resource. */
+  remote?: boolean;
+}
 interface AgentMemoryBindingOptions {
   /** The user-chosen namespace name. Must exist in Cloudflare at deploy time. */
   namespace: string;
-  /** Whether the Agent Memory binding should be remote in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Agent Memory namespace binding. Each binding is scoped to a namespace and
@@ -25,8 +30,8 @@ interface AgentMemoryBinding extends AgentMemoryBindingOptions {
   type: "agent-memory";
 }
 interface AiBindingOptions {
-  /** Whether the AI binding should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Binding to the Workers AI project.
@@ -48,8 +53,8 @@ interface TypedAiBinding<TAiModelList extends AiModelListType = AiModels> extend
 interface AiSearchBindingOptions {
   /** The user-chosen instance name. Must exist in Cloudflare at deploy time. */
   name: string;
-  /** Whether the AI Search instance binding should be remote in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * AI Search instance binding. Each binding is bound directly to a single
@@ -61,8 +66,8 @@ interface AiSearchBinding extends AiSearchBindingOptions {
 interface AiSearchNamespaceBindingOptions {
   /** 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;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * AI Search namespace binding. Each binding is scoped to a namespace and
@@ -86,8 +91,8 @@ interface AnalyticsEngineDatasetBinding extends AnalyticsEngineDatasetBindingOpt
 interface ArtifactsBindingOptions {
   /** The namespace to use. */
   namespace: string;
-  /** Whether to use the remote Artifacts service in local dev. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Binding to an Artifacts instance. Artifacts provides git-compatible file
@@ -105,8 +110,8 @@ interface AssetsBinding {
   type: "assets";
 }
 interface BrowserBindingOptions {
-  /** Whether the Browser binding should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Binding to a headless browser usable from the Worker.
@@ -121,8 +126,8 @@ interface D1BindingOptions {
   id?: string;
   /** The name of this D1 database. */
   name?: string;
-  /** Whether the D1 database should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Binding to a D1 database.
@@ -142,8 +147,8 @@ interface DispatchNamespaceBindingOptions {
     /** (Optional) List of parameter names, for sending context from your dispatch Worker to the outbound handler. */
     parameters?: string[];
   };
-  /** Whether the Dispatch Namespace should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Binding to a Workers for Platforms dispatch namespace.
@@ -183,8 +188,8 @@ interface TypedDurableObjectBinding<TConfig$1, TExportName$1 extends string> ext
 interface FlagshipBindingOptions {
   /** The Flagship app ID to bind to. */
   id?: string;
-  /** Set to `true` to suppress the remote binding warning in local dev. Flagship bindings are always remote. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /** Binding to a Flagship feature-flag service. */
 interface FlagshipBinding extends FlagshipBindingOptions {
@@ -193,8 +198,11 @@ interface FlagshipBinding extends FlagshipBindingOptions {
 interface HyperdriveBindingOptions {
   /** The ID of the Hyperdrive configuration. */
   id: string;
-  /** The local database connection string used during local development. */
-  localConnectionString?: string;
+  /** Options that only apply during local development. */
+  dev?: {
+    /** The database connection string used during local development. */
+    connectionString?: string;
+  };
 }
 /**
  * Binding to a Hyperdrive configuration.
@@ -205,8 +213,8 @@ interface HyperdriveBinding extends HyperdriveBindingOptions {
   type: "hyperdrive";
 }
 interface ImagesBindingOptions {
-  /** Whether the Images binding should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Binding to Cloudflare Images.
@@ -228,8 +236,8 @@ interface JsonBinding<T$1 extends Json = Json> {
 interface KvBindingOptions {
   /** The ID of the KV namespace. */
   id?: string;
-  /** Whether the KV namespace should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Binding to a Workers KV namespace.
@@ -257,8 +265,8 @@ interface LogfwdrBinding extends LogfwdrBindingOptions {
   type: "logfwdr";
 }
 interface MediaBindingOptions {
-  /** Whether the Media binding should be remote or not. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /** Binding to Cloudflare Media Transformations. */
 interface MediaBinding$1 extends MediaBindingOptions {
@@ -267,8 +275,8 @@ interface MediaBinding$1 extends MediaBindingOptions {
 interface MtlsCertificateBindingOptions {
   /** The UUID of the uploaded mTLS certificate. */
   id: string;
-  /** Whether the mTLS fetcher should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Binding to an uploaded mTLS certificate.
@@ -281,8 +289,8 @@ interface MtlsCertificateBinding extends MtlsCertificateBindingOptions {
 interface PipelineBindingOptions {
   /** Name of the Pipeline to bind. */
   name: string;
-  /** Whether the pipeline should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /** Binding to a Cloudflare Pipeline. */
 interface PipelineBinding extends PipelineBindingOptions {
@@ -298,8 +306,8 @@ interface QueueBindingOptions {
   name?: string;
   /** The number of seconds to wait before delivering a message. */
   deliveryDelay?: number;
-  /** Whether the Queue producer should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Producer binding to a Cloudflare Queue.
@@ -323,8 +331,14 @@ interface R2BindingOptions {
   name?: string;
   /** The jurisdiction that the bucket exists in. Default if not present. */
   jurisdiction?: string;
-  /** Whether the R2 bucket should be remote or not in local development. */
-  remote?: boolean;
+  /** Settings that only apply to local development. */
+  dev?: BindingDevOptions & {
+    /** EXPERIMENTAL: credentials for the local S3-compatible endpoint. */
+    experimentalS3Credentials?: {
+      accessKeyId: string;
+      secretAccessKey: string;
+    };
+  };
 }
 /**
  * Binding to an R2 bucket.
@@ -372,27 +386,35 @@ interface SecretsStoreSecretBindingOptions {
 interface SecretsStoreSecretBinding extends SecretsStoreSecretBindingOptions {
   type: "secrets-store-secret";
 }
-interface SendEmailBindingOptions {
+type SendEmailDestinationOptions = {
   /** If this binding should be restricted to a specific verified address. */
-  destinationAddress?: string;
+  destinationAddress: string;
+  allowedDestinationAddresses?: never;
+} | {
+  destinationAddress?: never;
   /** If this binding should be restricted to a set of verified addresses. */
-  allowedDestinationAddresses?: string[];
+  allowedDestinationAddresses: string[];
+} | {
+  destinationAddress?: never;
+  allowedDestinationAddresses?: never;
+};
+type SendEmailBindingOptions = SendEmailDestinationOptions & {
   /** If this binding should be restricted to a set of sender addresses. */
   allowedSenderAddresses?: string[];
-  /** Whether the binding should be remote or not in local development. */
-  remote?: boolean;
-}
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
+};
 /**
  * Binding for sending email from inside the Worker.
  *
  * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#email-bindings
  */
-interface SendEmailBinding extends SendEmailBindingOptions {
+type SendEmailBinding = SendEmailBindingOptions & {
   type: "send-email";
-}
+};
 interface StreamBindingOptions {
-  /** Whether the Stream binding should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /** Binding to Cloudflare Stream. */
 interface StreamBinding$1 extends StreamBindingOptions {
@@ -433,8 +455,8 @@ interface UnsafeBinding extends UnsafeBindingOptions {
 interface VectorizeBindingOptions {
   /** The name of the Vectorize index. */
   name: string;
-  /** Whether the Vectorize index should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Binding to a Vectorize index.
@@ -451,13 +473,15 @@ interface VersionMetadataBinding {
 type VpcNetworkBindingOptions = {
   /** The tunnel ID of the Cloudflare Tunnel to route traffic through. Mutually exclusive with `networkId`. */
   tunnelId: string;
-  /** Whether the VPC network is remote or not. */
-  remote?: boolean;
+  networkId?: never;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 } | {
+  tunnelId?: never;
   /** The network ID to route traffic through. Mutually exclusive with `tunnelId`. */
   networkId: string;
-  /** Whether the VPC network is remote or not. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 };
 /** Binding to a VPC network. */
 type VpcNetworkBinding = VpcNetworkBindingOptions & {
@@ -466,16 +490,16 @@ type VpcNetworkBinding = VpcNetworkBindingOptions & {
 interface VpcServiceBindingOptions {
   /** The service ID of the VPC connectivity service. */
   id: string;
-  /** Whether the VPC service is remote or not. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /** Binding to a VPC service. */
 interface VpcServiceBinding extends VpcServiceBindingOptions {
   type: "vpc-service";
 }
 interface WebSearchBindingOptions {
-  /** Whether the Web Search binding should be remote or not in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Cloudflare Web Search binding. There is exactly one shared web corpus, so
@@ -491,8 +515,8 @@ interface WorkerBindingOptions {
   exportName?: 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 in local development. */
-  remote?: boolean;
+  /** Options that only apply during local development. */
+  dev?: BindingDevOptions;
 }
 /**
  * Service binding (Worker-to-Worker). `workerName` is the name of the bound
@@ -526,8 +550,6 @@ interface WorkflowBindingOptions {
   workerName: string;
   /** The exported class name of the Workflow. */
   exportName: string;
-  /** Whether the Workflow binding should be remote or not in local development. */
-  remote?: boolean;
 }
 /**
  * Binding to a Workflow. `workerName` is the name of the Worker that defines
@@ -806,11 +828,27 @@ interface EmailTriggerOptions {
 interface EmailTrigger extends EmailTriggerOptions {
   type: "email";
 }
+interface ConnectTriggerOptions {
+  /** The transport protocol to listen for. */
+  protocol: "tcp";
+  /** The port to listen on. */
+  port: number;
+  /** The address to bind to. Defaults to `127.0.0.1`. */
+  address?: string;
+}
+/**
+ * Connect trigger — invokes this Worker's `connect(socket, env, ctx)`
+ * handler for raw socket connections received on the configured
+ * protocol/port.
+ */
+interface ConnectTrigger extends ConnectTriggerOptions {
+  type: "connect";
+}
 /**
- * Event triggers — fetch routes, queue consumers, cron schedules, and Email
- * Routing addresses — that invoke this Worker. Construct entries with
- * `triggers.fetch(...)`, `triggers.queue(...)`, `triggers.scheduled(...)`, or
- * `triggers.email(...)`.
+ * Event triggers — fetch routes, queue consumers, cron schedules, Email
+ * Routing addresses, and raw sockets — that invoke this Worker.
+ * Construct entries with `triggers.fetch(...)`, `triggers.queue(...)`,
+ * `triggers.scheduled(...)`, `triggers.email(...)`, or `triggers.connect(...)`.
  *
  * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#triggers
  */
@@ -839,6 +877,12 @@ interface Triggers {
    * addresses.
    */
   email(options: EmailTriggerOptions): EmailTrigger;
+  /**
+   * Connect trigger — invokes this Worker's `connect(socket, env, ctx)`
+   * handler for raw socket connections received on the configured
+   * protocol/port.
+   */
+  connect(options: ConnectTriggerOptions): ConnectTrigger;
 }
 /**
  * Triggers builder for configuring event triggers.
@@ -854,6 +898,7 @@ interface Triggers {
  *     triggers.scheduled({ schedule: "0 * * * *" }),
  *     triggers.scheduled({ schedule: "30 0 * * *" }),
  *     triggers.email({ addresses: ["support@example.com"] }),
+ *     triggers.connect({ protocol: "tcp", port: 5432 }),
  *   ],
  * });
  * ```
@@ -1055,7 +1100,7 @@ type Binding = AgentMemoryBinding | AiBinding | AiSearchBinding | AiSearchNamesp
 /**
  * Union of all trigger definitions accepted in `triggers`.
  */
-type Trigger = EmailTrigger | FetchTrigger | QueueConsumerTrigger | ScheduledTrigger;
+type Trigger = ConnectTrigger | EmailTrigger | FetchTrigger | QueueConsumerTrigger | ScheduledTrigger;
 /**
  * Union of all export definitions accepted in `exports`. Worker entries
  * configure WorkerEntrypoint exports. Durable Object entries configure live
@@ -1136,10 +1181,11 @@ interface WorkerConfig {
    */
   domains?: string[];
   /**
-   * Event triggers — fetch routes, queue consumers, cron schedules, and Email
-   * Routing addresses
-   * — that invoke this Worker. Construct entries with `triggers.fetch(...)`,
-   * `triggers.queue(...)`, `triggers.scheduled(...)`, or `triggers.email(...)`.
+   * Event triggers — fetch routes, queue consumers, cron schedules, Email
+   * Routing addresses, and raw sockets — that invoke this Worker.
+   * Construct entries with `triggers.fetch(...)`, `triggers.queue(...)`,
+   * `triggers.scheduled(...)`, `triggers.email(...)`, or
+   * `triggers.connect(...)`.
    *
    * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#triggers
    */
@@ -1386,7 +1432,7 @@ interface TypedWorkerDefinition<TConfig$1 extends WorkerConfig, TWorkerName exte
     workerName: TWorkerName;
     exportName?: TExportName$1;
     props?: Record<string, unknown>;
-    remote?: boolean;
+    dev?: BindingDevOptions;
   }): TypedWorkerBinding<TConfig$1, TExportName$1 extends string ? TExportName$1 : "default">;
 }
 type WorkerConfigExport<T$1 extends WorkerConfig = WorkerConfig> = ConfigInput<T$1>;
@@ -1615,16 +1661,20 @@ type InferMainModule<TUnwrappedConfig$1> = TUnwrappedConfig$1 extends {
  */
 type SettingsConfigInput = Omit<SettingsConfig, "type">;
 /**
- * Declare shared settings.
- * Authored as a named `settings` export.
+ * A settings definition created by {@link defineSettings}.
  */
-declare function defineSettings(config: ConfigInput<SettingsConfigInput>): {
+interface SettingsDefinition {
   [DEFINITION]: {
     config: ConfigInput<SettingsConfigInput>;
-    type: string;
+    type: "settings";
   };
-};
+}
+/**
+ * Declare shared settings.
+ * Authored as a named `settings` export.
+ */
+declare function defineSettings(config: ConfigInput<SettingsConfigInput>): SettingsDefinition;
 //#endregion
 //#endregion
-export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, Bindings, BrowserBinding, ConfigContext, D1Binding, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectCreatedExport, DurableObjectDeletedExport, DurableObjectExpectingTransferExport, DurableObjectRenamedExport, DurableObjectTransferredExport, EmailTrigger, Exports, FetchTrigger, FlagshipBinding, HyperdriveBinding, ImagesBinding$1 as ImagesBinding, InferDurableNamespaces, InferEnv, InferMainModule, JsonBinding, KvBinding, LogfwdrBinding, MediaBinding$1 as MediaBinding, MtlsCertificateBinding, PipelineBinding, QueueBinding, QueueConsumerTrigger, R2Binding, RateLimitBinding, ScheduledTrigger, SecretBinding, SecretsStoreSecretBinding, SendEmailBinding, SettingsConfig, SettingsConfigInput, StreamBinding$1 as StreamBinding, TextBinding, Triggers, TypedAiBinding, TypedDurableObjectBinding, TypedKvBinding, TypedPipelineBinding, TypedQueueBinding, TypedWorkerBinding, TypedWorkerDefinition, TypedWorkflowBinding, UnsafeBinding, UnwrapConfig, VectorizeBinding, VersionMetadataBinding, VpcNetworkBinding, VpcServiceBinding, WebSearchBinding, WorkerBinding, WorkerConfig, WorkerConfigExport, WorkerConfigInput, WorkerEntrypointExport, WorkerEntrypointExportOptions, WorkerLoaderBinding, WorkflowBinding, bindings, defineSettings, defineWorker, exports, triggers };
+export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, BindingDevOptions, Bindings, BrowserBinding, ConfigContext, ConnectTrigger, D1Binding, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectCreatedExport, DurableObjectDeletedExport, DurableObjectExpectingTransferExport, DurableObjectRenamedExport, DurableObjectTransferredExport, EmailTrigger, Exports, FetchTrigger, FlagshipBinding, HyperdriveBinding, ImagesBinding$1 as ImagesBinding, InferDurableNamespaces, InferEnv, InferMainModule, JsonBinding, KvBinding, LogfwdrBinding, MediaBinding$1 as MediaBinding, MtlsCertificateBinding, PipelineBinding, QueueBinding, QueueConsumerTrigger, R2Binding, RateLimitBinding, ScheduledTrigger, SecretBinding, SecretsStoreSecretBinding, SendEmailBinding, SettingsConfig, SettingsConfigInput, SettingsDefinition, StreamBinding$1 as StreamBinding, TextBinding, Triggers, TypedAiBinding, TypedDurableObjectBinding, TypedKvBinding, TypedPipelineBinding, TypedQueueBinding, TypedWorkerBinding, TypedWorkerDefinition, TypedWorkflowBinding, UnsafeBinding, UnwrapConfig, VectorizeBinding, VersionMetadataBinding, VpcNetworkBinding, VpcServiceBinding, WebSearchBinding, WorkerBinding, WorkerConfig, WorkerConfigExport, WorkerConfigInput, WorkerEntrypointExport, WorkerEntrypointExportOptions, WorkerLoaderBinding, WorkflowBinding, bindings, defineSettings, defineWorker, exports, triggers };
 //# sourceMappingURL=experimental-config.d.mts.map