env-runner 0.1.15 → 0.2.0

package/dist/runners/node-worker/worker.d.mts

@@ -1 +1 @@
-export { };
+export {}

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

@@ -1,9 +1,64 @@
-import { MessageHandler, RetryHandler } from "@vercel/queue";
+import { RuntimeDep } from "../../_chunks/common-runtime-deps.mjs";
+/** Metadata passed alongside each delivered message (`MessageMetadata`). */
+interface VercelQueueMessageMetadata {
+  messageId: string;
+  deliveryCount: number;
+  createdAt: Date;
+  expiresAt: Date;
+  topicName: string;
+  consumerGroup: string;
+  /** Vercel region the client is targeting. */
+  region: string;
+}
+/** Instruction returned by a retry handler when the message handler throws. */
+type VercelQueueRetryDirective = {
+  afterSeconds: number;
+} | {
+  acknowledge: true;
+};
+/** Function invoked with each delivered message (`MessageHandler`). */
+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 {
+  QueueClient: new (options?: any) => any;
+  registerDevConsumer?: (options: {
+    topic: string;
+    client: any;
+    handler: VercelQueueMessageHandler;
+    consumerGroup?: string;
+    visibilityTimeoutSeconds?: number;
+    retry?: VercelQueueRetryHandler;
+  }) => () => void;
+  [key: string]: unknown;
+}
 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.
+   */
+  sdk?: RuntimeDep<VercelQueueSdk>;
   /** Topic name. Wildcard patterns (e.g. `"user-*"`) are supported. */
   topic: string;
   /** Function invoked with each delivered message. */
-  handler: MessageHandler;
+  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
@@ -27,18 +82,18 @@ interface VercelQueueDevConsumer {
    * `{ afterSeconds }` to reschedule, `{ acknowledge: true }` to drop, or
    * `undefined` to let the error propagate.
    */
-  retry?: RetryHandler;
+  retry?: VercelQueueRetryHandler;
 }
 /**
  * Bind a handler to a topic. Resolves to an unregister function.
  *
- * The first call across the worker process lazily loads `@vercel/queue` and
- * constructs a shared `QueueClient`. Re-registering with the same topic
+ * 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 `@vercel/queue` is not installed or does not expose `registerDevConsumer`,
+ * If no SDK is available, or it does not expose `registerDevConsumer`,
  * resolves to a no-op unregister and logs a one-time warning.
  */
 declare function registerVercelQueueConsumer(consumer: VercelQueueDevConsumer): Promise<() => void>;
-export { VercelQueueDevConsumer, registerVercelQueueConsumer };
+export { VercelQueueDevConsumer, VercelQueueMessageHandler, VercelQueueMessageMetadata, VercelQueueRetryDirective, VercelQueueRetryHandler, VercelQueueSdk, registerVercelQueueConsumer };

package/dist/runners/vercel/queue-dev.mjs

@@ -1,10 +1,31 @@
+import { resolveRuntimeDep } from "../../_chunks/common-runtime-deps.mjs";
 const DEFAULT_CONSUMER_GROUP = "env-runner-vercel-dev";
-let sdkPromise;
-let client;
+const _clients = /* @__PURE__ */ new WeakMap();
+const _warned = /* @__PURE__ */ new WeakSet();
+let _warnedMissing = false;
+let _importedSdk;
 const noop = () => {};
 async function registerVercelQueueConsumer(consumer) {
-	const sdk = await ensureSdk();
-	if (!sdk || !client) return noop;
+	const sdk = await resolveSdk(consumer.sdk);
+	if (!sdk) {
+		if (!_warnedMissing) {
+			_warnedMissing = true;
+			console.warn("[env-runner:vercel-queue] `@vercel/queue` is not installed and no `sdk` was passed. Local queue delivery is disabled.");
+		}
+		return noop;
+	}
+	if (typeof sdk.registerDevConsumer !== "function") {
+		if (!_warned.has(sdk)) {
+			_warned.add(sdk);
+			console.warn("[env-runner:vercel-queue] The `@vercel/queue` SDK in use does not export `registerDevConsumer`. Upgrade @vercel/queue@^0.2.0 to enable local queue delivery.");
+		}
+		return noop;
+	}
+	let client = _clients.get(sdk);
+	if (!client) {
+		client = new sdk.QueueClient();
+		_clients.set(sdk, client);
+	}
 	return sdk.registerDevConsumer({
 		topic: consumer.topic,
 		client,
@@ -14,23 +35,16 @@ async function registerVercelQueueConsumer(consumer) {
 		retry: consumer.retry ?? (consumer.retryAfterSeconds === void 0 ? void 0 : () => ({ afterSeconds: consumer.retryAfterSeconds }))
 	});
 }
-function ensureSdk() {
-	if (sdkPromise) return sdkPromise;
-	sdkPromise = (async () => {
-		let mod;
-		try {
-			mod = await import("@vercel/queue");
-		} catch {
-			console.warn("[env-runner:vercel-queue] `@vercel/queue` is not installed. Local queue delivery is disabled.");
-			return null;
-		}
-		if (typeof mod.registerDevConsumer !== "function") {
-			console.warn("[env-runner:vercel-queue] Installed `@vercel/queue` does not export `registerDevConsumer`. Upgrade @vercel/queue@^0.2.0 to enable local queue delivery.");
-			return null;
-		}
-		client = new mod.QueueClient();
-		return mod;
-	})();
-	return sdkPromise;
+function resolveSdk(value) {
+	if (value !== void 0) return resolveRuntimeDep({
+		name: "@vercel/queue",
+		option: "sdk",
+		value
+	});
+	_importedSdk ??= resolveRuntimeDep({
+		name: "@vercel/queue",
+		option: "sdk"
+	});
+	return _importedSdk;
 }
 export { registerVercelQueueConsumer };

package/dist/runners/vercel/worker.d.mts

@@ -1 +1 @@
-export { };
+export {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "env-runner",
-  "version": "0.1.15",
+  "version": "0.2.0",
   "description": "Generic environment runner for JavaScript runtimes.",
   "license": "MIT",
   "repository": "unjs/env-runner",
@@ -40,52 +40,31 @@
     "env-runner": "node ./src/cli.ts",
     "release": "pnpm test && pnpm build && changelogen --release && npm publish && git push --follow-tags",
     "test": "pnpm lint && pnpm typecheck && vitest run --coverage",
-    "typecheck": "tsgo --noEmit --skipLibCheck"
+    "typecheck": "tsc --noEmit --skipLibCheck"
   },
   "dependencies": {
-    "crossws": "^0.4.6",
-    "exsolve": "^1.1.0",
-    "httpxy": "^0.5.3",
-    "srvx": "^0.11.17"
+    "crossws": "^0.4.11",
+    "exsolve": "^1.1.1",
+    "httpxy": "^0.5.5",
+    "srvx": "^0.12.7"
   },
   "devDependencies": {
-    "@netlify/runtime": "^4.1.25",
-    "@types/node": "^26.0.1",
-    "@typescript/native-preview": "7.0.0-dev.20260629.1",
-    "@vercel/queue": "^0.3.1",
-    "@vitest/coverage-v8": "^4.1.9",
+    "@netlify/runtime": "^5",
+    "@types/node": "^26.2.0",
+    "@vercel/queue": "^0.4",
+    "@vitest/coverage-v8": "^4.1.11",
     "automd": "^0.4.3",
     "changelogen": "^0.6.2",
-    "cjs-module-lexer": "^2.2.0",
+    "cjs-module-lexer": "^2.2.1",
     "env-runner-fixture": "link:",
-    "es-module-lexer": "^2.2.0",
-    "miniflare": "^4.20260625.0",
-    "obuild": "^0.4.37",
-    "oxfmt": "^0.56.0",
-    "oxlint": "^1.71.0",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.9",
-    "wrangler": "^4.105.0"
+    "es-module-lexer": "^2.3.2",
+    "miniflare": "^4",
+    "obuild": "^0.4.38",
+    "oxfmt": ">=0.64.0",
+    "oxlint": "^1.79.0",
+    "typescript": "^7",
+    "vitest": "^4.1.11",
+    "wrangler": "^4.124.0"
   },
-  "peerDependencies": {
-    "@netlify/runtime": "^4.1.23",
-    "@vercel/queue": ">=0.2.0",
-    "miniflare": "^4.20260515.0",
-    "wrangler": "^4.0.0"
-  },
-  "peerDependenciesMeta": {
-    "miniflare": {
-      "optional": true
-    },
-    "@netlify/runtime": {
-      "optional": true
-    },
-    "@vercel/queue": {
-      "optional": true
-    },
-    "wrangler": {
-      "optional": true
-    }
-  },
-  "packageManager": "pnpm@11.9.0"
+  "packageManager": "pnpm@11.22.0"
 }