env-runner 0.2.3 → 0.3.0

package/dist/_chunks/miniflare-runner.d.mts

@@ -1,4 +1,4 @@
-import { WorkerHooks } from "./types.mjs";
+import { ResolvedVirtualModule, WorkerHooks } from "./types.mjs";
 import { BaseEnvRunner, EnvRunnerData } from "./common-base-runner.mjs";
 import { RuntimeDep } from "./common-runtime-deps.mjs";
 import { IncomingMessage } from "node:http";
@@ -19,11 +19,13 @@ export interface TransformResult {
 export interface MiniflareExportInfo {
   type?: "DurableObject" | "WorkerEntrypoint" | "class";
 }
-/** The `miniflare` package namespace, as imported by the app. */
+/** The `miniflare` package namespace (v4 or v5), as imported by the app. */
 export interface MiniflareModule {
   Miniflare: new (options: any) => any;
-  /** Newest date the installed `workerd` supports, clamped to today. */
+  /** Newest date the installed `workerd` supports, clamped to today (v4 only). */
   supportedCompatibilityDate?: string;
+  /** Converts v4 options, which the runner builds, to the v5 format (v5 only). */
+  convertV4MiniflareOptions?: (options: any) => any;
   [key: string]: unknown;
 }
 export interface MiniflareEnvRunnerOptions {
@@ -51,9 +53,15 @@ export interface MiniflareEnvRunnerOptions {
   transformRequest?: (id: string) => Promise<TransformResult | null | undefined>;
   /**
    * Named exports (Durable Objects, WorkerEntrypoints) to bind and re-export.
-   * `true` detects `export class`; a record merges with detected ones.
+   * Default (or `true`): detect `export class` in the entry and auto-bind them;
+   * a record merges with detected ones; `false` disables it.
+   * A module specifier (absolute path or `data.virtual` key; relative paths
+   * resolve from the entry's directory) is re-exported with `export *` instead:
+   * nothing is detected or auto-bound (configure bindings with `wrangler` or
+   * `miniflareOptions`) and the entry's own classes are not re-exported.
+   * Exports load at startup, so changes need a new runner (not `reloadModule()`).
    */
-  exports?: Record<string, MiniflareExportInfo> | boolean;
+  exports?: Record<string, MiniflareExportInfo> | boolean | string;
   /** Reuse the Miniflare instance across runner swaps; only `dispose()` destroys it. */
   persistent?: boolean;
   /** Wrap the user's `fetch` in a try/catch that returns structured JSON error responses. Default: `true`. */
@@ -71,10 +79,11 @@ export interface MiniflareEnvRunnerOptions {
    *
    * Options a single dev worker can't run (`assets`, services, queue consumers,
    * workflows, tails, other-script Durable Objects) are dropped with a warning.
-   * `defaultPersistRoot` defaults to `.wrangler/state/v3` next to the config
-   * (else cwd), shared with `wrangler dev`. The `wrangler` package gives full
-   * fidelity (and may run its npm update check); without it only plain JSON is
-   * read. `miniflareOptions` always win.
+   * `defaultPersistRoot` (v5: `resourcePersistencePath`) defaults to
+   * `.wrangler/state/v3` next to the config (else cwd), shared with
+   * `wrangler dev`. The `wrangler` package gives full fidelity (and may run its
+   * npm update check); without it only plain JSON is read. `miniflareOptions`
+   * always win.
    */
   wrangler?: boolean | string | WranglerInlineConfig;
   /**
@@ -108,10 +117,10 @@ export declare class MiniflareEnvRunner extends BaseEnvRunner {
   /** Hot-reload the entry without recreating the Miniflare instance. */
   reloadModule(timeout?: number): Promise<void>;
   /**
-   * Host-side only: the fallback service serves a live map, so bumping versions
-   * (see {@link rewriteVirtualImports}) is enough.
+   * Host-side only: the fallback service serves a live map, so changing it and
+   * bumping versions (see {@link applyVirtualVersions}) is enough.
    */
-  invalidateModule(specifier: string, _timeout?: number): Promise<void>;
+  protected _applyVirtualUpdates(changes: Record<string, ResolvedVirtualModule | null>): Promise<void>;
   protected _hasRuntime(): boolean;
   protected _runtimeType(): string;
   protected _closeRuntime(): Promise<void>;