@cloudflare/vite-plugin 1.42.3 → 1.43.0

package/dist/experimental-config.d.mts

@@ -1,6 +1,6 @@
 import { Pipeline, PipelineRecord } from "cloudflare:pipelines";
 
-//#region ../config/dist/public-Bc6GRLbW.d.mts
+//#region ../config/dist/public-cHlOGnI4.d.mts
 
 //#region src/utils.d.ts
 /**
@@ -838,7 +838,16 @@ interface Triggers {
 declare const triggers: Triggers;
 //#endregion
 //#region src/exports.d.ts
-interface DurableObjectExportOptions {
+/**
+ * Declares a provisioned Durable Object class exported from this Worker.
+ *
+ * For more information about Durable Objects, see the documentation at
+ * https://developers.cloudflare.com/workers/learning/using-durable-objects
+ *
+ * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects
+ */
+interface DurableObjectCreatedExportOptions {
+  state?: "created";
   /**
    * Storage backend for the Durable Object.
    *
@@ -849,30 +858,75 @@ interface DurableObjectExportOptions {
   storage: "sqlite" | "legacy-kv";
 }
 /**
- * Declares a Durable Object class defined by this Worker.
+ * Retire a provisioned Durable Object namespace whose class has
+ * been removed from code.
  *
- * For more information about Durable Objects, see the documentation at
- * https://developers.cloudflare.com/workers/learning/using-durable-objects
- *
- * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects
+ * During deploy, the class must not be exported in the uploaded code, and no
+ * other Worker may hold a `durableObject` binding to the namespace.
  */
-interface DurableObjectExport extends DurableObjectExportOptions {
+interface DurableObjectDeletedExportOptions {
+  state: "deleted";
+}
+/**
+ * Rename a provisioned Durable Object namespace's class. The
+ * `renamedTo` value must also appear as a live (`state: "created"`)
+ * `durableObject` entry in the same `exports` map.
+ */
+interface DurableObjectRenamedExportOptions {
+  state: "renamed";
+  /**
+   * The destination class name. Must be a valid JavaScript identifier and
+   * must appear as a live (`state: "created"`) `durableObject` entry in the
+   * same `exports` map.
+   */
+  renamedTo: string;
+}
+/**
+ * Transfer ownership of a Durable Object namespace to another Worker in the same account.
+ * The target Worker must first deploy an `expectingTransfer` entry naming this Worker via `transferFrom`.
+ */
+interface DurableObjectTransferredExportOptions {
+  state: "transferred";
+  /**
+   * The destination Worker. Must reference a Worker in the same account.
+   */
+  transferredTo: string;
+}
+/**
+ * Prepare to receive cross-Worker Durable Object transfer.
+ * Once the source Worker's `transferred` export is deployed, this entry becomes a normal live `durable-object` export.
+ */
+interface DurableObjectExpectingTransferExportOptions {
+  state: "expecting-transfer";
+  storage: "sqlite" | "legacy-kv";
+  /**
+   * The source Worker for the two-phase cross-Worker transfer.
+   */
+  transferFrom: string;
+}
+interface DurableObjectCreatedExport extends DurableObjectCreatedExportOptions {
   type: "durable-object";
 }
-interface WorkflowExportOptions {
-  /** The name of the Workflow. */
-  name: string;
-  /** Optional limits for the Workflow. */
-  limits?: {
-    /** Maximum number of steps a Workflow instance can execute. */
-    steps?: number;
+interface DurableObjectDeletedExport extends DurableObjectDeletedExportOptions {
+  type: "durable-object";
+}
+interface DurableObjectRenamedExport extends DurableObjectRenamedExportOptions {
+  type: "durable-object";
+}
+interface DurableObjectTransferredExport extends DurableObjectTransferredExportOptions {
+  type: "durable-object";
+}
+interface DurableObjectExpectingTransferExport extends DurableObjectExpectingTransferExportOptions {
+  type: "durable-object";
+}
+interface WorkerEntrypointExportOptions {
+  cache?: {
+    /** Whether cache is enabled for this entrypoint. */
+    enabled: boolean;
   };
-  /** Optional cron schedules for automatically triggering workflow instances. */
-  schedules?: string[];
 }
-/** Declares a Workflow defined by this Worker. */
-interface WorkflowExport extends WorkflowExportOptions {
-  type: "workflow";
+interface WorkerEntrypointExport extends WorkerEntrypointExportOptions {
+  type: "worker";
 }
 /**
  * Configuration for named exports declared by the Worker. Each entry's
@@ -887,7 +941,26 @@ interface Exports {
    *
    * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects
    */
-  durableObject(options: DurableObjectExportOptions): DurableObjectExport;
+  durableObject(options: DurableObjectCreatedExportOptions): DurableObjectCreatedExport;
+  /**
+   * Retire a provisioned Durable Object namespace whose class has been removed from code.
+   */
+  durableObject(options: DurableObjectDeletedExportOptions): DurableObjectDeletedExport;
+  /**
+   * Rename a provisioned Durable Object namespace's class.
+   */
+  durableObject(options: DurableObjectRenamedExportOptions): DurableObjectRenamedExport;
+  /**
+   * Transfer ownership of a Durable Object namespace to another Worker in the same account.
+   */
+  durableObject(options: DurableObjectTransferredExportOptions): DurableObjectTransferredExport;
+  /**
+   * Prepare to receive cross-Worker Durable Object transfer.
+   * The source Worker must follow up with a deployment containing a `transferred` export to commit the transfer.
+   */
+  durableObject(options: DurableObjectExpectingTransferExportOptions): DurableObjectExpectingTransferExport;
+  /** Declares a WorkerEntrypoint export defined by this Worker. */
+  worker(options?: WorkerEntrypointExportOptions): WorkerEntrypointExport;
 }
 /**
  * Exports builder for configuring Worker exports.
@@ -899,6 +972,10 @@ interface Exports {
  * export default defineWorker({
  *   exports: {
  *     MyDurableObject: exports.durableObject({ storage: "sqlite" }),
+ *     OldClass:        exports.durableObject({ state: "deleted" }),
+ *     OldName:         exports.durableObject({ state: "renamed", renamedTo: "NewName" }),
+ *     Outgoing:        exports.durableObject({ state: "transferred", transferredTo: "target-worker" }),
+ *     Incoming:        exports.durableObject({ state: "expecting-transfer", storage: "sqlite", transferFrom: "source-worker" }),
  *   },
  * });
  * ```
@@ -915,9 +992,11 @@ type Binding = AgentMemoryBinding | AiBinding | AiSearchBinding | AiSearchNamesp
  */
 type Trigger = FetchTrigger | QueueConsumerTrigger | ScheduledTrigger;
 /**
- * Union of all export definitions accepted in `exports`.
+ * Union of all export definitions accepted in `exports`. Worker entries
+ * configure WorkerEntrypoint exports. Durable Object entries configure live
+ * classes and tombstone lifecycle operations.
  */
-type Export = DurableObjectExport;
+type Export = DurableObjectCreatedExport | DurableObjectDeletedExport | DurableObjectRenamedExport | DurableObjectTransferredExport | DurableObjectExpectingTransferExport | WorkerEntrypointExport;
 /**
  * Worker configuration. This is the input shape passed to
  * [`defineWorker`](https://developers.cloudflare.com/workers/wrangler/configuration/).
@@ -1020,6 +1099,8 @@ interface UserConfig {
   cache?: {
     /** If cache is enabled for this Worker. */
     enabled: boolean;
+    /** Whether cached assets may be reused across Worker versions. */
+    crossVersionCache?: boolean;
   };
   /**
    * Specify how the Worker should be located to minimize round-trip time.
@@ -1170,19 +1251,14 @@ interface UserConfig {
   /**
    * Configuration for named exports declared by the Worker. Each entry's
    * key is the exported class name; the value configures the export.
-   * Construct entries with `exports.durableObject(...)` or
-   * `exports.workflow(...)`.
    *
-   * Two export kinds are supported:
+   * Only one export kind is currently supported:
    *
-   * - `durable-object`: declares a Durable Object class defined by this
-   *   Worker. For more information about Durable Objects, see the
-   *   documentation at
-   *   https://developers.cloudflare.com/workers/learning/using-durable-objects
-   *
-   *   For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects
-   *
-   * - `workflow`: declares a Workflow defined by this Worker.
+   * - Construct entries with `exports.durableObject(...)`.
+   * - Declares Durable Object classes exported from this Worker.
+   *   For more information about Durable Objects, see the documentation at
+   *   https://developers.cloudflare.com/workers/learning/using-durable-objects.
+   *   For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects.
    */
   exports?: Record<string, Export>;
 }
@@ -1215,7 +1291,7 @@ interface TypedWorkerDefinition<TConfig$1 extends UserConfig, TWorkerName extend
    *
    * For reference, see https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects
    */
-  durableObject<TExportName$1 extends InferExportsByType<TConfig$1, "durable-object">>(options: {
+  durableObject<TExportName$1 extends InferDurableNamespaces<TConfig$1>>(options: {
     workerName: TWorkerName;
     exportName: TExportName$1;
   }): TypedDurableObjectBinding<TConfig$1, TExportName$1>;
@@ -1402,7 +1478,11 @@ type InferEnv<TUnwrappedConfig$1> = TUnwrappedConfig$1 extends {
 } ? { [K in keyof TEnv]: InferBindingType<TEnv[K]> } : never;
 /**
  * Infer the Durable Object namespace names from a Worker config's exports.
- * Returns a union of export names that have `type: "durable-object"`.
+ * Returns a union of export names that declare a *live* Durable Object —
+ * `type: "durable-object"` with `state` either omitted, `"created"`, or
+ * `"expecting-transfer"`. Tombstone entries (`deleted`, `renamed`,
+ * `transferred`) are excluded because they retire the namespace and a
+ * binding to a tombstoned class would fail at deploy time.
  *
  * @example
  * ```typescript
@@ -1412,16 +1492,24 @@ type InferEnv<TUnwrappedConfig$1> = TUnwrappedConfig$1 extends {
  * const config = defineWorker({
  *   exports: {
  *     MyDurableObject: { type: "durable-object", storage: "sqlite" },
- *     MyWorkflow: { type: "workflow", name: "my-workflow" },
+ *     OldGone:         { type: "durable-object", state: "deleted" },
  *   },
  * });
  *
  * type WorkerConfig = UnwrapConfig<typeof config>;
- * // Inferred as: "MyDurableObject"
+ * // Inferred as: "MyDurableObject" (the deleted tombstone is excluded)
  * type DurableNamespaces = InferDurableNamespaces<WorkerConfig>;
  * ```
  */
-type InferDurableNamespaces<TUnwrappedConfig$1> = InferExportsByType<TUnwrappedConfig$1, "durable-object">;
+type InferDurableNamespaces<TUnwrappedConfig$1> = TUnwrappedConfig$1 extends {
+  exports: infer TExports extends Record<string, {
+    type: string;
+  }>;
+} ? { [K in keyof TExports]: TExports[K] extends {
+  type: "durable-object";
+} ? TExports[K] extends {
+  state: "deleted" | "renamed" | "transferred";
+} ? never : K & string : never }[keyof TExports] : never;
 /**
  * Infer the main module type from a Worker config's entrypoint.
  * If entrypoint is a module namespace object, returns that type.
@@ -1432,5 +1520,5 @@ type InferMainModule<TUnwrappedConfig$1> = TUnwrappedConfig$1 extends {
 } ? TModule : DefaultModule;
 //#endregion
 //#endregion
-export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, Bindings, BrowserBinding, ConfigContext, D1Binding, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectExport, 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, WorkerLoaderBinding, WorkflowBinding, WorkflowExport, bindings, defineWorker, exports, triggers };
+export { AgentMemoryBinding, AiBinding, AiSearchBinding, AiSearchNamespaceBinding, AnalyticsEngineDatasetBinding, ArtifactsBinding, AssetsBinding, Bindings, BrowserBinding, ConfigContext, D1Binding, DispatchNamespaceBinding, DurableObjectBinding, DurableObjectCreatedExport, DurableObjectDeletedExport, DurableObjectExpectingTransferExport, DurableObjectRenamedExport, DurableObjectTransferredExport, 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 };
 //# sourceMappingURL=experimental-config.d.mts.map