@upstash/qstash 2.10.1 → 2.11.0

package/nextjs.mjs

@@ -1,21 +1,25 @@
 import {
   Receiver,
-  serve
-} from "./chunk-35B33QW3.mjs";
+  ensureDevelopmentServer,
+  serve,
+  shouldUseDevelopmentMode
+} from "./chunk-LB3C5PJP.mjs";
 
 // platforms/nextjs.ts
 var BAD_REQUEST = 400;
 function verifySignature(handler, config) {
   const currentSigningKey = config?.currentSigningKey ?? process.env.QSTASH_CURRENT_SIGNING_KEY;
   const nextSigningKey = config?.nextSigningKey ?? process.env.QSTASH_NEXT_SIGNING_KEY;
-  if (!currentSigningKey && !nextSigningKey && !process.env.QSTASH_REGION) {
+  const devMode = shouldUseDevelopmentMode(config?.devMode, process.env);
+  if (!devMode && !currentSigningKey && !nextSigningKey && !process.env.QSTASH_REGION) {
     throw new Error(
       "currentSigningKey and nextSigningKey are required, either in the config or as env variables (QSTASH_CURRENT_SIGNING_KEY and QSTASH_NEXT_SIGNING_KEY)"
     );
   }
   const receiver = new Receiver({
     currentSigningKey,
-    nextSigningKey
+    nextSigningKey,
+    devMode: config?.devMode
   });
   return async (request, response) => {
     const signature = request.headers["upstash-signature"];
@@ -57,14 +61,16 @@ function verifySignature(handler, config) {
 function verifySignatureEdge(handler, config) {
   const currentSigningKey = config?.currentSigningKey ?? process.env.QSTASH_CURRENT_SIGNING_KEY;
   const nextSigningKey = config?.nextSigningKey ?? process.env.QSTASH_NEXT_SIGNING_KEY;
-  if (!currentSigningKey && !nextSigningKey && !process.env.QSTASH_REGION) {
+  const devMode = shouldUseDevelopmentMode(config?.devMode, process.env);
+  if (!devMode && !currentSigningKey && !nextSigningKey && !process.env.QSTASH_REGION) {
     throw new Error(
       "currentSigningKey and nextSigningKey are required, either in the config or as env variables (QSTASH_CURRENT_SIGNING_KEY and QSTASH_NEXT_SIGNING_KEY)"
     );
   }
   const receiver = new Receiver({
     currentSigningKey,
-    nextSigningKey
+    nextSigningKey,
+    devMode: config?.devMode
   });
   return async (request, nfe) => {
     const requestClone = request.clone();
@@ -94,14 +100,16 @@ function verifySignatureEdge(handler, config) {
 function verifySignatureAppRouter(handler, config) {
   const currentSigningKey = config?.currentSigningKey ?? process.env.QSTASH_CURRENT_SIGNING_KEY;
   const nextSigningKey = config?.nextSigningKey ?? process.env.QSTASH_NEXT_SIGNING_KEY;
-  if (!currentSigningKey && !nextSigningKey && !process.env.QSTASH_REGION) {
+  const devMode = shouldUseDevelopmentMode(config?.devMode, process.env);
+  if (!devMode && !currentSigningKey && !nextSigningKey && !process.env.QSTASH_REGION) {
     throw new Error(
       "currentSigningKey and nextSigningKey are required, either in the config or as env variables (QSTASH_CURRENT_SIGNING_KEY and QSTASH_NEXT_SIGNING_KEY)"
     );
   }
   const receiver = new Receiver({
     currentSigningKey,
-    nextSigningKey
+    nextSigningKey,
+    devMode: config?.devMode
   });
   return async (request, params) => {
     const requestClone = request.clone();
@@ -159,7 +167,15 @@ var servePagesRouter = (routeFunction, options) => {
     res.status(response.status).json(await response.json());
   };
 };
+async function registerQStashDev() {
+  if (process.env.NODE_ENV === "production")
+    return;
+  if (process.env.NEXT_PHASE === "phase-production-build")
+    return;
+  await ensureDevelopmentServer(void 0, true);
+}
 export {
+  registerQStashDev,
   serve2 as serve,
   servePagesRouter,
   verifySignature,

package/nuxt.js

@@ -362,8 +362,13 @@ var jose = __toESM(require("jose"));
 var import_crypto_js = __toESM(require("crypto-js"));
 
 // src/client/utils.ts
+function _processGlobal() {
+  const proc = globalThis["process"];
+  return proc;
+}
 function getSafeEnvironment() {
-  return typeof process === "undefined" ? {} : process.env;
+  const proc = _processGlobal();
+  return proc?.env ?? {};
 }
 
 // src/client/multi-region/utils.ts
@@ -403,12 +408,71 @@ function normalizeRegionHeader(region) {
   return void 0;
 }
 
+// src/dev-server/constants.ts
+var DEFAULT_DEV_PORT = 8080;
+var DEV_CREDENTIALS = {
+  token: "eyJVc2VySUQiOiJkZWZhdWx0VXNlciIsIlBhc3N3b3JkIjoiZGVmYXVsdFBhc3N3b3JkIn0=",
+  currentSigningKey: "sig_7kYjw48mhY7kAjqNGcy6cr29RJ6r",
+  nextSigningKey: "sig_5ZB6DVzB1wjE8S6rZ7eenA8Pdnhs"
+};
+var DEV_PREFIX = "\x1B[2m[QStash Dev]\x1B[0m";
+
+// src/dev-server/index.ts
+var _processGlobal2 = () => {
+  const proc = globalThis["process"];
+  return proc;
+};
+var shouldUseDevelopmentMode = (devMode, env) => {
+  if (devMode !== void 0)
+    return devMode;
+  const value = env?.QSTASH_DEV ?? getProcessEnvironment("QSTASH_DEV");
+  if (value === void 0 || value === "" || value === "false" || value === "0")
+    return false;
+  if (value === "true" || value === "1")
+    return true;
+  throw new Error(`[QStash Dev] Invalid value for QSTASH_DEV in environment: ${value}`);
+};
+var getDevelopmentCredentials = (env) => {
+  return {
+    ...DEV_CREDENTIALS,
+    baseUrl: getDevUrl(env)
+  };
+};
+var getDevUrl = (env) => {
+  const portString = env?.QSTASH_DEV_PORT ?? getProcessEnvironment("QSTASH_DEV_PORT");
+  let port = DEFAULT_DEV_PORT;
+  if (portString) {
+    const parsed = Number.parseInt(portString, 10);
+    if (!Number.isNaN(parsed) && parsed > 0) {
+      port = parsed;
+    }
+  }
+  return `http://127.0.0.1:${port}`;
+};
+var getProcessEnvironment = (key) => {
+  const proc = _processGlobal2();
+  return proc?.env ? proc.env[key] : void 0;
+};
+
 // src/client/multi-region/incoming.ts
 var getReceiverSigningKeys = ({
   environment,
   regionFromHeader,
-  config
+  config,
+  devMode
 }) => {
+  if (shouldUseDevelopmentMode(devMode, environment)) {
+    if (config?.currentSigningKey || config?.nextSigningKey) {
+      console.warn(
+        `${DEV_PREFIX} Dev mode is active. Ignoring signing keys from config. Set devMode: false to use your own keys.`
+      );
+    }
+    const developmentCreds = getDevelopmentCredentials(environment);
+    return {
+      currentSigningKey: developmentCreds.currentSigningKey,
+      nextSigningKey: developmentCreds.nextSigningKey
+    };
+  }
   if (config?.currentSigningKey && config.nextSigningKey) {
     return {
       currentSigningKey: config.currentSigningKey,
@@ -456,9 +520,11 @@ var SignatureError = class extends Error {
 var Receiver = class {
   currentSigningKey;
   nextSigningKey;
+  devMode;
   constructor(config) {
     this.currentSigningKey = config?.currentSigningKey;
     this.nextSigningKey = config?.nextSigningKey;
+    this.devMode = config?.devMode;
   }
   /**
    * Verify the signature of a request.
@@ -477,7 +543,8 @@ var Receiver = class {
       config: {
         currentSigningKey: this.currentSigningKey,
         nextSigningKey: this.nextSigningKey
-      }
+      },
+      devMode: this.devMode
     });
     if (!signingKeys) {
       throw new Error(

package/nuxt.mjs

@@ -1,8 +1,8 @@
 import {
   verifySignatureH3
-} from "./chunk-PIBVA43B.mjs";
-import "./chunk-Z37KJCW7.mjs";
-import "./chunk-35B33QW3.mjs";
+} from "./chunk-JQP6NQUW.mjs";
+import "./chunk-7DSF3QVE.mjs";
+import "./chunk-LB3C5PJP.mjs";
 
 // platforms/nuxt.ts
 var verifySignatureNuxt = verifySignatureH3;

package/package.json

@@ -1 +1 @@
-{"version":"2.10.1","name":"@upstash/qstash","description":"Official Typescript client for QStash","author":"Andreas Thomas <dev@chronark.com>","license":"MIT","homepage":"https://github.com/upstash/qstash-js#readme","repository":{"type":"git","url":"git+https://github.com/upstash/qstash-js.git"},"bugs":{"url":"https://github.com/upstash/qstash-js/issues"},"main":"./index.js","module":"./index.mjs","types":"./index.d.ts","files":["./*"],"exports":{".":{"import":"./index.mjs","require":"./index.js"},"./dist/nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./h3":{"import":"./h3.mjs","require":"./h3.js"},"./nuxt":{"import":"./nuxt.mjs","require":"./nuxt.js"},"./svelte":{"import":"./svelte.mjs","require":"./svelte.js"},"./solidjs":{"import":"./solidjs.mjs","require":"./solidjs.js"},"./workflow":{"import":"./workflow.mjs","require":"./workflow.js"},"./hono":{"import":"./hono.mjs","require":"./hono.js"},"./cloudflare":{"import":"./cloudflare.mjs","require":"./cloudflare.js"}},"keywords":["qstash","queue","events","serverless","upstash"],"scripts":{"build":"tsup && cp README.md ./dist/ && cp package.json ./dist/ && cp LICENSE ./dist/","test":"bun test src","fmt":"prettier --write .","lint":"tsc && eslint \"{src,platforms}/**/*.{js,ts,tsx}\" --quiet --fix","check-exports":"bun run build && cd dist && attw -P"},"devDependencies":{"@commitlint/cli":"^19.2.2","@commitlint/config-conventional":"^19.2.2","@eslint/eslintrc":"^3.1.0","@eslint/js":"^9.10.0","@solidjs/start":"^1.0.6","@sveltejs/kit":"^2.5.18","@types/bun":"^1.1.1","@types/crypto-js":"^4.2.0","@typescript-eslint/eslint-plugin":"^8.4.0","@typescript-eslint/parser":"^8.4.0","bun-types":"^1.1.7","eslint":"^9.10.0","eslint-plugin-unicorn":"^51.0.1","h3":"^1.12.0","hono":"^4.5.8","husky":"^9.0.10","next":"^14.0.2","prettier":"^3.2.5","tsup":"latest","typescript":"^5.4.5","undici-types":"^6.16.0","vitest":"latest"},"dependencies":{"crypto-js":">=4.2.0","jose":"^5.2.3","neverthrow":"^7.0.1"}}
+{"version":"2.11.0","name":"@upstash/qstash","description":"Official Typescript client for QStash","author":"Andreas Thomas <dev@chronark.com>","license":"MIT","homepage":"https://github.com/upstash/qstash-js#readme","repository":{"type":"git","url":"git+https://github.com/upstash/qstash-js.git"},"bugs":{"url":"https://github.com/upstash/qstash-js/issues"},"main":"./index.js","module":"./index.mjs","types":"./index.d.ts","files":["./*"],"exports":{".":{"import":"./index.mjs","require":"./index.js"},"./dist/nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./nextjs":{"import":"./nextjs.mjs","require":"./nextjs.js"},"./h3":{"import":"./h3.mjs","require":"./h3.js"},"./nuxt":{"import":"./nuxt.mjs","require":"./nuxt.js"},"./svelte":{"import":"./svelte.mjs","require":"./svelte.js"},"./solidjs":{"import":"./solidjs.mjs","require":"./solidjs.js"},"./workflow":{"import":"./workflow.mjs","require":"./workflow.js"},"./hono":{"import":"./hono.mjs","require":"./hono.js"},"./cloudflare":{"import":"./cloudflare.mjs","require":"./cloudflare.js"}},"keywords":["qstash","queue","events","serverless","upstash"],"scripts":{"build":"tsup && cp README.md ./dist/ && cp package.json ./dist/ && cp LICENSE ./dist/","test":"bun test src","fmt":"prettier --write .","lint":"tsc && eslint \"{src,platforms}/**/*.{js,ts,tsx}\" --quiet --fix","check-exports":"bun run build && cd dist && attw -P"},"devDependencies":{"@commitlint/cli":"^19.2.2","@commitlint/config-conventional":"^19.2.2","@eslint/eslintrc":"^3.1.0","@eslint/js":"^9.10.0","@solidjs/start":"^1.0.6","@sveltejs/kit":"^2.5.18","@types/bun":"^1.1.1","@types/crypto-js":"^4.2.0","@typescript-eslint/eslint-plugin":"^8.4.0","@typescript-eslint/parser":"^8.4.0","bun-types":"^1.1.7","eslint":"^9.10.0","eslint-plugin-unicorn":"^51.0.1","h3":"^1.12.0","hono":"^4.5.8","husky":"^9.0.10","next":"^14.0.2","prettier":"^3.2.5","tsup":"latest","typescript":"^5.4.5","undici-types":"^6.16.0","vitest":"latest"},"dependencies":{"crypto-js":">=4.2.0","jose":"^5.2.3","neverthrow":"^7.0.1"}}

package/solidjs.d.mts

@@ -1,5 +1,5 @@
 import { APIHandler, APIEvent } from '@solidjs/start/server';
-import { ae as RouteFunction, af as WorkflowServeOptions } from './client-CsM1dTnz.mjs';
+import { ae as RouteFunction, af as WorkflowServeOptions } from './client-CUioGZfg.mjs';
 import 'neverthrow';
 
 type VerifySignatureConfig = {

package/solidjs.d.ts

@@ -1,5 +1,5 @@
 import { APIHandler, APIEvent } from '@solidjs/start/server';
-import { ae as RouteFunction, af as WorkflowServeOptions } from './client-CsM1dTnz.js';
+import { ae as RouteFunction, af as WorkflowServeOptions } from './client-CUioGZfg.js';
 import 'neverthrow';
 
 type VerifySignatureConfig = {