@cloudflare/vite-plugin 1.45.1 → 1.46.0

package/README.md

@@ -23,14 +23,14 @@ Full documentation can be found [here](https://developers.cloudflare.com/workers
 - Uses the Vite [Environment API](https://vite.dev/guide/api-environment) to integrate Vite with the Workers runtime
 - Provides direct access to [Workers runtime APIs](https://developers.cloudflare.com/workers/runtime-apis/) and [bindings](https://developers.cloudflare.com/workers/runtime-apis/bindings/)
 - Builds your front-end assets for deployment to Cloudflare, enabling you to build static sites, SPAs, and full-stack applications
-- Official support for [TanStack Start](https://tanstack.com/start/) and [React Router v7](https://reactrouter.com/) with server-side rendering
+- Official support for [TanStack Start](https://tanstack.com/start/) and [React Router v8](https://reactrouter.com/) with server-side rendering
 - Leverages Vite's hot module replacement for consistently fast updates
 - Supports `vite preview` for previewing your build output in the Workers runtime prior to deployment
 
 ## Use cases
 
 - [TanStack Start](https://tanstack.com/start/)
-- [React Router v7](https://reactrouter.com/)
+- [React Router v8](https://reactrouter.com/)
 - Support for more full-stack frameworks is coming soon
 - Static sites, such as single-page applications, with or without an integrated backend API
 - Standalone Workers

package/dist/experimental-config.d.mts

@@ -1,6 +1,6 @@
 import { Pipeline, PipelineRecord } from "cloudflare:pipelines";
 
-//#region ../config/dist/public-m7PNfSwY.d.mts
+//#region ../config/dist/public-myuV_kLK.d.mts
 
 //#region src/utils.d.ts
 /**
@@ -134,7 +134,7 @@ interface D1Binding extends D1BindingOptions {
 }
 interface DispatchNamespaceBindingOptions {
   /** The namespace to bind to. */
-  namespace: string;
+  namespace?: string;
   /** Details about the outbound Worker which will handle outbound requests from your namespace. */
   outbound?: {
     /** Name of the Worker handling the outbound requests. */
@@ -182,7 +182,7 @@ interface TypedDurableObjectBinding<TConfig$1, TExportName$1 extends string> ext
 }
 interface FlagshipBindingOptions {
   /** The Flagship app ID to bind to. */
-  id: string;
+  id?: string;
   /** Set to `true` to suppress the remote binding warning in local dev. Flagship bindings are always remote. */
   remote?: boolean;
 }
@@ -295,7 +295,7 @@ interface TypedPipelineBinding<TRecord extends PipelineRecord = PipelineRecord>
 }
 interface QueueBindingOptions {
   /** The name of this Queue. */
-  name: string;
+  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. */
@@ -602,7 +602,7 @@ interface Bindings {
    *
    * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#dispatch-namespace-bindings-workers-for-platforms
    */
-  dispatchNamespace(options: DispatchNamespaceBindingOptions): DispatchNamespaceBinding;
+  dispatchNamespace(options?: DispatchNamespaceBindingOptions): DispatchNamespaceBinding;
   /**
    * Binding to a Durable Object class. `workerName` is the name of the Worker
    * that defines the class; `exportName` is the exported class name.
@@ -611,7 +611,7 @@ interface Bindings {
    */
   durableObject(options: DurableObjectBindingOptions): DurableObjectBinding;
   /** Binding to a Flagship feature-flag service. */
-  flagship(options: FlagshipBindingOptions): FlagshipBinding;
+  flagship(options?: FlagshipBindingOptions): FlagshipBinding;
   /**
    * Binding to a Hyperdrive configuration.
    *
@@ -652,7 +652,7 @@ interface Bindings {
    *
    * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#queues
    */
-  queue<TBody = unknown>(options: QueueBindingOptions): TypedQueueBinding<TBody>;
+  queue<TBody = unknown>(options?: QueueBindingOptions): TypedQueueBinding<TBody>;
   /**
    * Binding to an R2 bucket.
    *
@@ -1007,6 +1007,32 @@ interface Exports {
  * ```
  */
 declare const exports: Exports;
+//#endregion
+//#region src/definition.d.ts
+interface ConfigContext {
+  /**
+   * The mode the config is being evaluated in.
+   * Set via the `--mode` CLI flag.
+   * In Vite the mode defaults to `development` in `vite dev` and `production` in `vite build` ([more info](https://vite.dev/guide/env-and-mode.html#modes)).
+   * In Wrangler the mode defaults to `undefined`.
+   */
+  mode: string | undefined;
+}
+declare const DEFINITION: unique symbol;
+/**
+ * The authored config in any of its supported shapes: a plain value, a promise,
+ * or a function of {@link ConfigContext}.
+ */
+type ConfigInput<T$1> = T$1 | Promise<T$1> | ((ctx: ConfigContext) => T$1 | Promise<T$1>);
+/**
+ * Resolve any `cloudflare.config.ts` export to its plain config value.
+ *
+ * A `define*` helper stores its authored config plus `type` under the
+ * {@link DEFINITION} symbol; here we unwrap the config and stamp `type` back on.
+ * Every other export — a raw object/promise/function — is unwrapped as-is and
+ * already carries its own `type`. Discrimination happens afterwards via `type`.
+ */
+
 //#endregion
 //#region src/types.d.ts
 /**
@@ -1030,19 +1056,18 @@ type Export = DurableObjectCreatedExport | DurableObjectDeletedExport | DurableO
  * Fields are validated at runtime by `InputWorkerSchema` and normalised before
  * being passed to downstream tooling.
  */
-interface UserConfig {
+interface WorkerConfig {
   /**
-   * The name of your Worker.
+   * Discriminates this config as a Worker config.
+   *
+   * Injected automatically by `defineWorker`; only needs to be written by
+   * hand when authoring a raw config object without the helper.
    */
-  name: string;
+  type: "worker";
   /**
-   * This is the ID of the account associated with your zone.
-   * You might have more than one account, so make sure to use
-   * the ID of the account associated with the zone/route you
-   * provide, if you provide one. It can also be specified through
-   * the CLOUDFLARE_ACCOUNT_ID environment variable.
+   * The name of your Worker.
    */
-  accountId?: string;
+  name: string;
   /**
    * A date in the form yyyy-mm-dd, which will be used to determine
    * which version of the Workers runtime is used.
@@ -1231,13 +1256,6 @@ interface UserConfig {
    * @default false
    */
   previewUrls?: boolean;
-  /**
-   * Specify the compliance region mode of the Worker.
-   *
-   * Although if the user does not specify a compliance region, the default is `public`,
-   * it can be set to `undefined` in configuration to delegate to the CLOUDFLARE_COMPLIANCE_REGION environment variable.
-   */
-  complianceRegion?: "public" | "fedramp-high";
   /**
    * Designates this Worker as an internal-only "first-party" Worker.
    *
@@ -1289,29 +1307,51 @@ interface UserConfig {
    */
   exports?: Record<string, Export>;
 }
-//#endregion
-//#region src/worker-definition.d.ts
-interface ConfigContext {
+/**
+ * Settings shared by the other exports.
+ * Authored as a named `settings` export via
+ * `defineSettings`.
+ */
+interface SettingsConfig {
   /**
-   * The mode the config is being evaluated in.
-   * Set via the `--mode` CLI flag.
-   * In Vite the mode defaults to `development` in `vite dev` and `production` in `vite build` ([more info](https://vite.dev/guide/env-and-mode.html#modes)).
-   * In Wrangler the mode defaults to `undefined`.
+   * Discriminates this config as a settings config.
+   *
+   * Injected automatically by `defineSettings`; only needs to be written by
+   * hand when authoring a raw config object without the helper.
    */
-  mode: string | undefined;
+  type: "settings";
+  /**
+   * This is the ID of the account associated with your zone.
+   * You might have more than one account, so make sure to use
+   * the ID of the account associated with the zone/route you
+   * provide, if you provide one. It can also be specified through
+   * the CLOUDFLARE_ACCOUNT_ID environment variable.
+   */
+  accountId?: string;
+  /**
+   * Specify the compliance region mode of the Worker.
+   *
+   * Although if the user does not specify a compliance region, the default is `public`,
+   * it can be set to `undefined` in configuration to delegate to the CLOUDFLARE_COMPLIANCE_REGION environment variable.
+   */
+  complianceRegion?: "public" | "fedramp-high";
 }
-declare const CONFIG: unique symbol;
+//#endregion
+//#region src/worker-definition.d.ts
 /**
- * Base shape of a Worker definition. Carries the resolved config and the
- * untyped cross-worker binding helpers.
+ * Base shape of a Worker definition. Carries the authored config (under
+ * {@link DEFINITION}) and the untyped cross-worker binding helpers.
  */
-interface WorkerDefinition<TConfig$1 extends UserConfig = UserConfig> extends Pick<Bindings, "durableObject" | "worker"> {
-  [CONFIG]: TConfig$1 | Promise<TConfig$1> | ((ctx: ConfigContext) => TConfig$1 | Promise<TConfig$1>);
+interface WorkerDefinition<TConfig$1 extends WorkerConfig = WorkerConfig> extends Pick<Bindings, "durableObject" | "worker"> {
+  [DEFINITION]: {
+    config: ConfigInput<Omit<TConfig$1, "type">>;
+    type: "worker";
+  };
 }
 /**
  * Worker definition with typed cross-worker binding helpers.
  */
-interface TypedWorkerDefinition<TConfig$1 extends UserConfig, TWorkerName extends string = InferWorkerName<TConfig$1>> extends WorkerDefinition<TConfig$1> {
+interface TypedWorkerDefinition<TConfig$1 extends WorkerConfig, TWorkerName extends string = InferWorkerName<TConfig$1>> extends WorkerDefinition<TConfig$1> {
   /**
    * Binding to a Durable Object class. `workerName` is the name of the Worker
    * that defines the class; `exportName` is the exported class name.
@@ -1336,9 +1376,18 @@ interface TypedWorkerDefinition<TConfig$1 extends UserConfig, TWorkerName extend
     remote?: boolean;
   }): TypedWorkerBinding<TConfig$1, TExportName$1 extends string ? TExportName$1 : "default">;
 }
-type UserConfigExport<T$1 extends UserConfig = UserConfig> = T$1 | Promise<T$1> | ((ctx: ConfigContext) => T$1 | Promise<T$1>);
-declare function defineWorker<const T$1 extends UserConfig>(config: (ctx: ConfigContext) => (UserConfig & T$1) | Promise<UserConfig & T$1>): TypedWorkerDefinition<T$1>;
-declare function defineWorker<const T$1 extends UserConfig>(config: (UserConfig & T$1) | Promise<UserConfig & T$1>): TypedWorkerDefinition<T$1>;
+type WorkerConfigExport<T$1 extends WorkerConfig = WorkerConfig> = ConfigInput<T$1>;
+/**
+ * Authored Worker config shape — {@link WorkerConfig} without the `type`
+ * discriminant, which `defineWorker` injects.
+ */
+type WorkerConfigInput = Omit<WorkerConfig, "type">;
+declare function defineWorker<const T$1 extends WorkerConfigInput>(config: (ctx: ConfigContext) => (WorkerConfigInput & T$1) | Promise<WorkerConfigInput & T$1>): TypedWorkerDefinition<T$1 & {
+  type: "worker";
+}>;
+declare function defineWorker<const T$1 extends WorkerConfigInput>(config: (WorkerConfigInput & T$1) | Promise<WorkerConfigInput & T$1>): TypedWorkerDefinition<T$1 & {
+  type: "worker";
+}>;
 //#endregion
 //#region src/inference.d.ts
 /**
@@ -1476,7 +1525,7 @@ type InferWorkerEntrypointExports<TUnwrappedConfig$1> = Exclude<keyof InferMainM
  * Unwrap function and promise types to get the underlying config.
  * Use this to normalize a config before passing it to other inference utilities.
  */
-type UnwrapConfig<TConfig$1> = TConfig$1 extends WorkerDefinition<infer TUnwrappedConfig> ? TUnwrappedConfig : TConfig$1 extends UserConfigExport<infer TUnwrappedConfig> ? TUnwrappedConfig : never;
+type UnwrapConfig<TConfig$1> = TConfig$1 extends WorkerDefinition<infer TUnwrappedConfig> ? TUnwrappedConfig : TConfig$1 extends WorkerConfigExport<infer TUnwrappedConfig> ? TUnwrappedConfig : never;
 /**
  * Infer the `Env` interface type from a Worker config.
  *
@@ -1546,6 +1595,23 @@ type InferMainModule<TUnwrappedConfig$1> = TUnwrappedConfig$1 extends {
   entrypoint: infer TModule extends WorkerModule;
 } ? TModule : DefaultModule;
 //#endregion
+//#region src/settings-definition.d.ts
+/**
+ * Authored settings config shape — {@link SettingsConfig} without the `type`
+ * discriminant, which `defineSettings` injects.
+ */
+type SettingsConfigInput = Omit<SettingsConfig, "type">;
+/**
+ * Declare shared settings.
+ * Authored as a named `settings` export.
+ */
+declare function defineSettings(config: ConfigInput<SettingsConfigInput>): {
+  [DEFINITION]: {
+    config: ConfigInput<SettingsConfigInput>;
+    type: string;
+  };
+};
+//#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, StreamBinding$1 as StreamBinding, TextBinding, Triggers, TypedAiBinding, TypedDurableObjectBinding, TypedKvBinding, TypedPipelineBinding, TypedQueueBinding, TypedWorkerBinding, TypedWorkerDefinition, TypedWorkflowBinding, UnsafeBinding, UnwrapConfig, UserConfig, UserConfigExport, VectorizeBinding, VersionMetadataBinding, VpcNetworkBinding, VpcServiceBinding, WebSearchBinding, WorkerBinding, WorkerEntrypointExport, WorkerEntrypointExportOptions, WorkerLoaderBinding, WorkflowBinding, bindings, defineWorker, exports, triggers };
+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 };
 //# sourceMappingURL=experimental-config.d.mts.map