env-runner 0.2.1 → 0.2.3

package/dist/runners/vercel/queue-dev.d.mts

@@ -1,6 +1,6 @@
 import { RuntimeDep } from "../../_chunks/common-runtime-deps.mjs";
 /** Metadata passed alongside each delivered message (`MessageMetadata`). */
-interface VercelQueueMessageMetadata {
+export interface VercelQueueMessageMetadata {
   messageId: string;
   deliveryCount: number;
   createdAt: Date;
@@ -11,21 +11,17 @@ interface VercelQueueMessageMetadata {
   region: string;
 }
 /** Instruction returned by a retry handler when the message handler throws. */
-type VercelQueueRetryDirective = {
+export type VercelQueueRetryDirective = {
   afterSeconds: number;
 } | {
   acknowledge: true;
 };
 /** Function invoked with each delivered message (`MessageHandler`). */
-type VercelQueueMessageHandler<T = unknown> = (message: T, metadata: VercelQueueMessageMetadata) => Promise<void> | void;
+export type VercelQueueMessageHandler<T = unknown> = (message: T, metadata: VercelQueueMessageMetadata) => Promise<void> | void;
 /** Called when the message handler throws (`RetryHandler`). */
-type VercelQueueRetryHandler = (error: unknown, metadata: VercelQueueMessageMetadata) => VercelQueueRetryDirective | void | undefined;
-/**
- * The `@vercel/queue` package, as imported by the consumer
- * (`import * as queue from "@vercel/queue"`). Structurally typed so the real
- * module namespace is assignable without env-runner depending on the package.
- */
-interface VercelQueueSdk {
+export type VercelQueueRetryHandler = (error: unknown, metadata: VercelQueueMessageMetadata) => VercelQueueRetryDirective | void | undefined;
+/** `@vercel/queue` namespace, structurally typed to avoid depending on the package. */
+export interface VercelQueueSdk {
   QueueClient: new (options?: any) => any;
   registerDevConsumer?: (options: {
     topic: string;
@@ -37,22 +33,10 @@ interface VercelQueueSdk {
   }) => () => void;
   [key: string]: unknown;
 }
-interface VercelQueueDevConsumer {
+export interface VercelQueueDevConsumer {
   /**
-   * The `@vercel/queue` package: the imported module, or a specifier for it.
-   *
-   * ```ts
-   * import * as sdk from "@vercel/queue";
-   * await registerVercelQueueConsumer({ sdk, topic: "orders", handler });
-   *
-   * // or, equivalently
-   * await registerVercelQueueConsumer({ sdk: "@vercel/queue", topic, handler });
-   * ```
-   *
-   * Passing it explicitly is preferred (`@vercel/queue` is not a dependency of
-   * `env-runner`). Bare specifiers resolve from the current working directory.
-   * When omitted, `@vercel/queue` is imported optionally and registration
-   * becomes a no-op if the package isn't installed.
+   * The `@vercel/queue` package (`import * as sdk from "@vercel/queue"`) or a
+   * specifier resolved from cwd. Omitted: imported optionally.
    */
   sdk?: RuntimeDep<VercelQueueSdk>;
   /** Topic name. Wildcard patterns (e.g. `"user-*"`) are supported. */
@@ -60,40 +44,19 @@ interface VercelQueueDevConsumer {
   /** Function invoked with each delivered message. */
   handler: VercelQueueMessageHandler;
   /**
-   * Logical consumer identifier. Re-registering with the same group on the same
-   * topic replaces the previous handler (HMR-safe). Use distinct groups to fan
-   * a topic out to multiple coexisting handlers.
-   *
+   * Same group + topic replaces the handler; distinct groups coexist.
    * @default "env-runner-vercel-dev"
    */
   consumerGroup?: string;
-  /**
-   * Lock duration for in-flight messages. Forwarded to the SDK's
-   * `coreHandleCallback`.
-   */
+  /** Lock duration for in-flight messages (SDK `coreHandleCallback`). */
   visibilityTimeoutSeconds?: number;
-  /**
-   * Convenience: rescheduled re-delivery delay applied when the handler throws.
-   * Equivalent to `retry: () => ({ afterSeconds })`. Ignored if `retry` is set.
-   */
+  /** Re-delivery delay when the handler throws; shorthand for `retry` (which wins). */
   retryAfterSeconds?: number;
-  /**
-   * Full retry handler. Receives the thrown error and message metadata; return
-   * `{ afterSeconds }` to reschedule, `{ acknowledge: true }` to drop, or
-   * `undefined` to let the error propagate.
-   */
+  /** Return `{ afterSeconds }` to reschedule, `{ acknowledge: true }` to drop, or `undefined` to rethrow. */
   retry?: VercelQueueRetryHandler;
 }
 /**
- * Bind a handler to a topic. Resolves to an unregister function.
- *
- * A shared `QueueClient` is constructed from `sdk` on first use and reused for
- * later registrations with the same SDK. Re-registering with the same topic
- * replaces the handler (HMR-safe; the SDK keys consumers by `consumerGroup`,
- * so calling unregister on a replaced registration is a no-op).
- *
- * If no SDK is available, or it does not expose `registerDevConsumer`,
- * resolves to a no-op unregister and logs a one-time warning.
+ * Bind a handler to a topic; resolves to an unregister function (a no-op once
+ * replaced). Without a usable SDK, warns once and no-ops.
  */
-declare function registerVercelQueueConsumer(consumer: VercelQueueDevConsumer): Promise<() => void>;
-export { VercelQueueDevConsumer, VercelQueueMessageHandler, VercelQueueMessageMetadata, VercelQueueRetryDirective, VercelQueueRetryHandler, VercelQueueSdk, registerVercelQueueConsumer };
+export declare function registerVercelQueueConsumer(consumer: VercelQueueDevConsumer): Promise<() => void>;

package/dist/vite.d.mts

@@ -1,29 +1,18 @@
 import { RunnerRPCHooks } from "./_chunks/types.mjs";
 /** Vite HotChannel-compatible interface (avoids hard dependency on vite types). */
-interface ViteHotChannel {
+export interface ViteHotChannel {
   send: (data: any) => void;
   on: (event: string, handler: (...args: any[]) => void) => void;
   off: (event: string, handler: (...args: any[]) => void) => void;
 }
 /** Vite ModuleRunner transport-compatible interface. */
-interface ViteTransport {
+export interface ViteTransport {
   connect: (handlers: {
     onMessage: (payload: any) => void;
   }) => void;
   send: (payload: any) => void;
 }
-/**
- * Create a Vite `HotChannel` from an env-runner's RPC hooks.
- *
- * Use on the **host side** to bridge env-runner IPC → Vite's DevEnvironment transport.
- * Messages are namespaced by `envName` so multiple Vite environments can share one runner.
- */
-declare function createViteHotChannel(hooks: RunnerRPCHooks, envName: string): ViteHotChannel;
-/**
- * Create a Vite `ModuleRunner` transport from worker-side IPC primitives.
- *
- * Use on the **worker side** to bridge worker IPC → Vite's `ModuleRunner` transport.
- * Filters messages by `envName` so multiple Vite environments can share one IPC channel.
- */
-declare function createViteTransport(sendMessage: (data: any) => void, onMessage: (listener: (value: any) => void) => void, envName: string): ViteTransport;
-export { ViteHotChannel, ViteTransport, createViteHotChannel, createViteTransport };
+/** Host-side Vite `HotChannel`, namespaced by `envName` so environments can share a runner. */
+export declare function createViteHotChannel(hooks: RunnerRPCHooks, envName: string): ViteHotChannel;
+/** Worker-side Vite `ModuleRunner` transport, filtered by `envName` to share one IPC channel. */
+export declare function createViteTransport(sendMessage: (data: any) => void, onMessage: (listener: (value: any) => void) => void, envName: string): ViteTransport;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "env-runner",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Generic environment runner for JavaScript runtimes.",
   "license": "MIT",
   "repository": {
@@ -38,25 +38,25 @@
     "crossws": "^0.4.12",
     "exsolve": "^1.1.1",
     "httpxy": "^0.5.5",
-    "srvx": "^1.0.0"
+    "srvx": "^1.0.5"
   },
   "devDependencies": {
-    "@netlify/runtime": "^5.0.2",
-    "@types/node": "^26.4.0",
+    "@netlify/runtime": "^5.0.3",
+    "@types/node": "^26.5.1",
     "@vercel/queue": "^0.5.1",
-    "@vitest/coverage-v8": "^4.1.11",
+    "@vitest/coverage-v8": "^5.0.0",
     "automd": "^0.4.3",
     "changelogen": "^0.6.2",
     "cjs-module-lexer": "^2.2.1",
     "env-runner-fixture": "link:",
-    "es-module-lexer": "^2.3.2",
+    "es-module-lexer": "^3.0.2",
     "miniflare": "^4.20260730.0",
-    "obuild": "^0.4.38",
-    "oxfmt": "^0.65.0",
-    "oxlint": "^1.80.0",
+    "obuild": "^0.4.39",
+    "oxfmt": ">=0.67.0",
+    "oxlint": "^1.82.0",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.11",
-    "wrangler": "^4.127.1"
+    "vitest": "^5.0.0",
+    "wrangler": "^4.131.0"
   },
   "scripts": {
     "build": "obuild",