@workflow/world-testing 4.0.1-beta.24 → 4.0.1-beta.25

package/dist/.well-known/workflow/v1/step.js

@@ -9098,7 +9098,7 @@ var require_client = __commonJS({
             return client[kPipelining] ?? client[kHTTPContext]?.defaultPipelining ?? 1;
         }
         __name(getPipelining, "getPipelining");
-        var Client = class extends DispatcherBase {
+        var Client2 = class extends DispatcherBase {
             static {
                 __name(this, "Client");
             }
@@ -9532,7 +9532,7 @@ var require_client = __commonJS({
             }
         }
         __name(_resume, "_resume");
-        module2.exports = Client;
+        module2.exports = Client2;
     }
 });
 // ../../node_modules/.pnpm/undici@6.19.0/node_modules/undici/lib/dispatcher/fixed-queue.js
@@ -9813,7 +9813,7 @@ var require_pool = __commonJS({
     "../../node_modules/.pnpm/undici@6.19.0/node_modules/undici/lib/dispatcher/pool.js"(exports2, module2) {
         "use strict";
         var { PoolBase, kClients, kNeedDrain, kAddClient, kGetDispatcher } = require_pool_base();
-        var Client = require_client();
+        var Client2 = require_client();
         var { InvalidArgumentError } = require_errors();
         var util = require_util();
         var { kUrl, kInterceptors } = require_symbols();
@@ -9822,7 +9822,7 @@ var require_pool = __commonJS({
         var kConnections = Symbol("connections");
         var kFactory = Symbol("factory");
         function defaultFactory(origin, opts) {
-            return new Client(origin, opts);
+            return new Client2(origin, opts);
         }
         __name(defaultFactory, "defaultFactory");
         var Pool = class extends PoolBase {
@@ -10023,7 +10023,7 @@ var require_agent = __commonJS({
         var { kClients, kRunning, kClose, kDestroy, kDispatch, kInterceptors } = require_symbols();
         var DispatcherBase = require_dispatcher_base();
         var Pool = require_pool();
-        var Client = require_client();
+        var Client2 = require_client();
         var util = require_util();
         var createRedirectInterceptor = require_redirect_interceptor();
         var kOnConnect = Symbol("onConnect");
@@ -10034,7 +10034,7 @@ var require_agent = __commonJS({
         var kFactory = Symbol("factory");
         var kOptions = Symbol("options");
         function defaultFactory(origin, opts) {
-            return opts && opts.connections === 1 ? new Client(origin, opts) : new Pool(origin, opts);
+            return opts && opts.connections === 1 ? new Client2(origin, opts) : new Pool(origin, opts);
         }
         __name(defaultFactory, "defaultFactory");
         var Agent2 = class extends DispatcherBase {
@@ -12597,13 +12597,13 @@ var require_mock_client = __commonJS({
     "../../node_modules/.pnpm/undici@6.19.0/node_modules/undici/lib/mock/mock-client.js"(exports2, module2) {
         "use strict";
         var { promisify: promisify2 } = require("node:util");
-        var Client = require_client();
+        var Client2 = require_client();
         var { buildMockDispatch } = require_mock_utils();
         var { kDispatches, kMockAgent, kClose, kOriginalClose, kOrigin, kOriginalDispatch, kConnected } = require_mock_symbols();
         var { MockInterceptor } = require_mock_interceptor();
         var Symbols = require_symbols();
         var { InvalidArgumentError } = require_errors();
-        var MockClient = class extends Client {
+        var MockClient = class extends Client2 {
             static {
                 __name(this, "MockClient");
             }
@@ -20102,7 +20102,7 @@ var require_eventsource = __commonJS({
 var require_undici = __commonJS({
     "../../node_modules/.pnpm/undici@6.19.0/node_modules/undici/index.js"(exports2, module2) {
         "use strict";
-        var Client = require_client();
+        var Client2 = require_client();
         var Dispatcher = require_dispatcher();
         var Pool = require_pool();
         var BalancedPool = require_balanced_pool();
@@ -20126,7 +20126,7 @@ var require_undici = __commonJS({
         var createRedirectInterceptor = require_redirect_interceptor();
         Object.assign(Dispatcher.prototype, api);
         module2.exports.Dispatcher = Dispatcher;
-        module2.exports.Client = Client;
+        module2.exports.Client = Client2;
         module2.exports.Pool = Pool;
         module2.exports.BalancedPool = BalancedPool;
         module2.exports.Agent = Agent2;
@@ -23661,17 +23661,6 @@ __name(__builtin_response_text, "__builtin_response_text");
 registerStepFunction("__builtin_response_array_buffer", __builtin_response_array_buffer);
 registerStepFunction("__builtin_response_json", __builtin_response_json);
 registerStepFunction("__builtin_response_text", __builtin_response_text);
-// workflows/addition.ts
-async function add(num, num2) {
-    return num + num2;
-}
-__name(add, "add");
-async function addition(num, num2) {
-    throw new Error("You attempted to execute workflow addition function directly. To start a workflow, use start(addition) from workflow/api");
-}
-__name(addition, "addition");
-addition.workflowId = "workflow//workflows/addition.ts//addition";
-registerStepFunction("step//workflows/addition.ts//add", add);
 // ../utils/dist/index.js
 var import_ms = __toESM(require_ms(), 1);
 function once(fn) {
@@ -25015,7 +25004,7 @@ var StreamingMultipartParser = class {
         }
     }
 };
-// ../../node_modules/.pnpm/@vercel+queue@0.0.0-alpha.29/node_modules/@vercel/queue/dist/index.mjs
+// ../../node_modules/.pnpm/@vercel+queue@0.0.0-alpha.33/node_modules/@vercel/queue/dist/index.mjs
 var import_oidc = __toESM(require_dist(), 1);
 async function streamToBuffer(stream) {
     let totalLength = 0;
@@ -25148,6 +25137,10 @@ var InvalidLimitError = class extends Error {
         this.name = "InvalidLimitError";
     }
 };
+function isDebugEnabled() {
+    return process.env.VERCEL_QUEUE_DEBUG === "1" || process.env.VERCEL_QUEUE_DEBUG === "true";
+}
+__name(isDebugEnabled, "isDebugEnabled");
 async function consumeStream(stream) {
     const reader = stream.getReader();
     try {
@@ -25162,6 +25155,31 @@ async function consumeStream(stream) {
     }
 }
 __name(consumeStream, "consumeStream");
+function parseRetryAfter(headers) {
+    const retryAfterHeader = headers.get("Retry-After");
+    if (retryAfterHeader) {
+        const parsed = parseInt(retryAfterHeader, 10);
+        return Number.isNaN(parsed) ? void 0 : parsed;
+    }
+    return void 0;
+}
+__name(parseRetryAfter, "parseRetryAfter");
+function throwCommonHttpError(status, statusText, errorText, operation, badRequestDefault = "Invalid parameters") {
+    if (status === 400) {
+        throw new BadRequestError(errorText || badRequestDefault);
+    }
+    if (status === 401) {
+        throw new UnauthorizedError(errorText || void 0);
+    }
+    if (status === 403) {
+        throw new ForbiddenError(errorText || void 0);
+    }
+    if (status >= 500) {
+        throw new InternalServerError(errorText || `Server error: ${status} ${statusText}`);
+    }
+    throw new Error(`Failed to ${operation}: ${status} ${statusText}`);
+}
+__name(throwCommonHttpError, "throwCommonHttpError");
 function parseQueueHeaders(headers) {
     const messageId = headers.get("Vqs-Message-Id");
     const deliveryCountStr = headers.get("Vqs-Delivery-Count") || "0";
@@ -25172,7 +25190,7 @@ function parseQueueHeaders(headers) {
         return null;
     }
     const deliveryCount = parseInt(deliveryCountStr, 10);
-    if (isNaN(deliveryCount)) {
+    if (Number.isNaN(deliveryCount)) {
         return null;
     }
     return {
@@ -25190,22 +25208,22 @@ var QueueClient = class {
     }
     baseUrl;
     basePath;
-    customHeaders = {};
+    customHeaders;
+    providedToken;
     /**
     * Create a new Vercel Queue Service client
-    * @param options Client configuration options
+    * @param options QueueClient configuration options
     */
     constructor(options = {}) {
         this.baseUrl = options.baseUrl || process.env.VERCEL_QUEUE_BASE_URL || "https://vercel-queue.com";
         this.basePath = options.basePath || process.env.VERCEL_QUEUE_BASE_PATH || "/api/v2/messages";
-        const VERCEL_QUEUE_HEADER_PREFIX = "VERCEL_QUEUE_HEADER_";
-        this.customHeaders = Object.fromEntries(Object.entries(process.env).filter(([key]) => key.startsWith(VERCEL_QUEUE_HEADER_PREFIX)).map(([key, value]) => [
-            // This allows headers to use dashes independent of shell used
-            key.replace(VERCEL_QUEUE_HEADER_PREFIX, "").replaceAll("__", "-"),
-            value || ""
-        ]));
+        this.customHeaders = options.headers || {};
+        this.providedToken = options.token;
     }
     async getToken() {
+        if (this.providedToken) {
+            return this.providedToken;
+        }
         const token = await (0, import_oidc.getVercelOidcToken)();
         if (!token) {
             throw new Error("Failed to get OIDC token from Vercel Functions. Make sure you are running in a Vercel Function environment, or provide a token explicitly.\n\nTo set up your environment:\n1. Link your project: 'vercel link'\n2. Pull environment variables: 'vercel env pull'\n3. Run with environment: 'dotenv -e .env.local -- your-command'");
@@ -25213,6 +25231,48 @@ var QueueClient = class {
         return token;
     }
     /**
+    * Internal fetch wrapper that automatically handles debug logging
+    * when VERCEL_QUEUE_DEBUG is enabled
+    */
+    async fetch(url2, init) {
+        const method = init.method || "GET";
+        if (isDebugEnabled()) {
+            const logData = {
+                method,
+                url: url2,
+                headers: init.headers
+            };
+            const body = init.body;
+            if (body !== void 0 && body !== null) {
+                if (body instanceof ArrayBuffer) {
+                    logData.bodySize = body.byteLength;
+                }
+                else if (body instanceof Uint8Array) {
+                    logData.bodySize = body.byteLength;
+                }
+                else if (typeof body === "string") {
+                    logData.bodySize = body.length;
+                }
+                else {
+                    logData.bodyType = typeof body;
+                }
+            }
+            console.debug("[VQS Debug] Request:", JSON.stringify(logData, null, 2));
+        }
+        const response = await fetch(url2, init);
+        if (isDebugEnabled()) {
+            const logData = {
+                method,
+                url: url2,
+                status: response.status,
+                statusText: response.statusText,
+                headers: response.headers
+            };
+            console.debug("[VQS Debug] Response:", JSON.stringify(logData, null, 2));
+        }
+        return response;
+    }
+    /**
     * Send a message to a queue
     * @param options Send message options
     * @param transport Serializer/deserializer for the payload
@@ -25241,29 +25301,17 @@ var QueueClient = class {
             headers.set("Vqs-Retention-Seconds", retentionSeconds.toString());
         }
         const body = transport.serialize(payload);
-        const response = await fetch(`${this.baseUrl}${this.basePath}`, {
+        const response = await this.fetch(`${this.baseUrl}${this.basePath}`, {
             method: "POST",
             body,
             headers
         });
         if (!response.ok) {
-            if (response.status === 400) {
-                const errorText = await response.text();
-                throw new BadRequestError(errorText || "Invalid parameters");
-            }
-            if (response.status === 401) {
-                throw new UnauthorizedError();
-            }
-            if (response.status === 403) {
-                throw new ForbiddenError();
-            }
+            const errorText = await response.text();
             if (response.status === 409) {
                 throw new Error("Duplicate idempotency key detected");
             }
-            if (response.status >= 500) {
-                throw new InternalServerError(`Server error: ${response.status} ${response.statusText}`);
-            }
-            throw new Error(`Failed to send message: ${response.status} ${response.statusText}`);
+            throwCommonHttpError(response.status, response.statusText, errorText, "send message");
         }
         const responseData = await response.json();
         return responseData;
@@ -25299,7 +25347,7 @@ var QueueClient = class {
         if (limit !== void 0) {
             headers.set("Vqs-Limit", limit.toString());
         }
-        const response = await fetch(`${this.baseUrl}${this.basePath}`, {
+        const response = await this.fetch(`${this.baseUrl}${this.basePath}`, {
             method: "GET",
             headers
         });
@@ -25307,29 +25355,11 @@ var QueueClient = class {
             throw new QueueEmptyError(queueName, consumerGroup);
         }
         if (!response.ok) {
-            if (response.status === 400) {
-                const errorText = await response.text();
-                throw new BadRequestError(errorText || "Invalid parameters");
-            }
-            if (response.status === 401) {
-                throw new UnauthorizedError();
-            }
-            if (response.status === 403) {
-                throw new ForbiddenError();
-            }
+            const errorText = await response.text();
             if (response.status === 423) {
-                const retryAfterHeader = response.headers.get("Retry-After");
-                let retryAfter;
-                if (retryAfterHeader) {
-                    const parsed = parseInt(retryAfterHeader, 10);
-                    retryAfter = isNaN(parsed) ? void 0 : parsed;
-                }
-                throw new MessageLockedError("next message", retryAfter);
+                throw new MessageLockedError("next message", parseRetryAfter(response.headers));
             }
-            if (response.status >= 500) {
-                throw new InternalServerError(`Server error: ${response.status} ${response.statusText}`);
-            }
-            throw new Error(`Failed to receive messages: ${response.status} ${response.statusText}`);
+            throwCommonHttpError(response.status, response.statusText, errorText, "receive messages");
         }
         for await (const multipartMessage of parseMultipartStream(response)) {
             try {
@@ -25367,40 +25397,22 @@ var QueueClient = class {
         if (skipPayload) {
             headers.set("Vqs-Skip-Payload", "1");
         }
-        const response = await fetch(`${this.baseUrl}${this.basePath}/${encodeURIComponent(messageId)}`, {
+        const response = await this.fetch(`${this.baseUrl}${this.basePath}/${encodeURIComponent(messageId)}`, {
             method: "GET",
             headers
         });
         if (!response.ok) {
-            if (response.status === 400) {
-                const errorText = await response.text();
-                throw new BadRequestError(errorText || "Invalid parameters");
-            }
-            if (response.status === 401) {
-                throw new UnauthorizedError();
-            }
-            if (response.status === 403) {
-                throw new ForbiddenError();
-            }
+            const errorText = await response.text();
             if (response.status === 404) {
                 throw new MessageNotFoundError(messageId);
             }
-            if (response.status === 423) {
-                const retryAfterHeader = response.headers.get("Retry-After");
-                let retryAfter;
-                if (retryAfterHeader) {
-                    const parsed = parseInt(retryAfterHeader, 10);
-                    retryAfter = isNaN(parsed) ? void 0 : parsed;
-                }
-                throw new MessageLockedError(messageId, retryAfter);
-            }
             if (response.status === 409) {
                 throw new MessageNotAvailableError(messageId);
             }
-            if (response.status >= 500) {
-                throw new InternalServerError(`Server error: ${response.status} ${response.statusText}`);
+            if (response.status === 423) {
+                throw new MessageLockedError(messageId, parseRetryAfter(response.headers));
             }
-            throw new Error(`Failed to receive message by ID: ${response.status} ${response.statusText}`);
+            throwCommonHttpError(response.status, response.statusText, errorText, "receive message by ID");
         }
         if (skipPayload && response.status === 204) {
             const parsedHeaders = parseQueueHeaders(response.headers);
@@ -25464,7 +25476,7 @@ var QueueClient = class {
     */
     async deleteMessage(options) {
         const { queueName, consumerGroup, messageId, ticket } = options;
-        const response = await fetch(`${this.baseUrl}${this.basePath}/${encodeURIComponent(messageId)}`, {
+        const response = await this.fetch(`${this.baseUrl}${this.basePath}/${encodeURIComponent(messageId)}`, {
             method: "DELETE",
             headers: new Headers({
                 Authorization: `Bearer ${await this.getToken()}`,
@@ -25475,25 +25487,14 @@ var QueueClient = class {
             })
         });
         if (!response.ok) {
-            if (response.status === 400) {
-                throw new BadRequestError("Missing or invalid ticket");
-            }
-            if (response.status === 401) {
-                throw new UnauthorizedError();
-            }
-            if (response.status === 403) {
-                throw new ForbiddenError();
-            }
+            const errorText = await response.text();
             if (response.status === 404) {
                 throw new MessageNotFoundError(messageId);
             }
             if (response.status === 409) {
-                throw new MessageNotAvailableError(messageId, "Invalid ticket, message not in correct state, or already processed");
+                throw new MessageNotAvailableError(messageId, errorText || "Invalid ticket, message not in correct state, or already processed");
             }
-            if (response.status >= 500) {
-                throw new InternalServerError(`Server error: ${response.status} ${response.statusText}`);
-            }
-            throw new Error(`Failed to delete message: ${response.status} ${response.statusText}`);
+            throwCommonHttpError(response.status, response.statusText, errorText, "delete message", "Missing or invalid ticket");
         }
         return {
             deleted: true
@@ -25512,7 +25513,7 @@ var QueueClient = class {
     */
     async changeVisibility(options) {
         const { queueName, consumerGroup, messageId, ticket, visibilityTimeoutSeconds } = options;
-        const response = await fetch(`${this.baseUrl}${this.basePath}/${encodeURIComponent(messageId)}`, {
+        const response = await this.fetch(`${this.baseUrl}${this.basePath}/${encodeURIComponent(messageId)}`, {
             method: "PATCH",
             headers: new Headers({
                 Authorization: `Bearer ${await this.getToken()}`,
@@ -25524,165 +25525,33 @@ var QueueClient = class {
             })
         });
         if (!response.ok) {
-            if (response.status === 400) {
-                throw new BadRequestError("Missing ticket or invalid visibility timeout");
-            }
-            if (response.status === 401) {
-                throw new UnauthorizedError();
-            }
-            if (response.status === 403) {
-                throw new ForbiddenError();
-            }
+            const errorText = await response.text();
             if (response.status === 404) {
                 throw new MessageNotFoundError(messageId);
             }
             if (response.status === 409) {
-                throw new MessageNotAvailableError(messageId, "Invalid ticket, message not in correct state, or already processed");
-            }
-            if (response.status >= 500) {
-                throw new InternalServerError(`Server error: ${response.status} ${response.statusText}`);
+                throw new MessageNotAvailableError(messageId, errorText || "Invalid ticket, message not in correct state, or already processed");
             }
-            throw new Error(`Failed to change visibility: ${response.status} ${response.statusText}`);
+            throwCommonHttpError(response.status, response.statusText, errorText, "change visibility", "Missing ticket or invalid visibility timeout");
         }
         return {
             updated: true
         };
     }
 };
-function validateWildcardPattern(pattern) {
-    const firstIndex = pattern.indexOf("*");
-    const lastIndex = pattern.lastIndexOf("*");
-    if (firstIndex !== lastIndex) {
-        return false;
-    }
-    if (firstIndex === -1) {
-        return false;
-    }
-    if (firstIndex !== pattern.length - 1) {
-        return false;
-    }
-    return true;
-}
-__name(validateWildcardPattern, "validateWildcardPattern");
-function matchesWildcardPattern(topicName, pattern) {
-    const prefix = pattern.slice(0, -1);
-    return topicName.startsWith(prefix);
-}
-__name(matchesWildcardPattern, "matchesWildcardPattern");
-function findTopicHandler(queueName, handlers) {
-    const exactHandler = handlers[queueName];
-    if (exactHandler) {
-        return exactHandler;
-    }
-    for (const pattern in handlers) {
-        if (pattern.includes("*") && matchesWildcardPattern(queueName, pattern)) {
-            return handlers[pattern];
-        }
-    }
-    return null;
-}
-__name(findTopicHandler, "findTopicHandler");
-async function parseCallback(request) {
-    const contentType = request.headers.get("content-type");
-    if (!contentType || !contentType.includes("application/cloudevents+json")) {
-        throw new Error("Invalid content type: expected 'application/cloudevents+json'");
-    }
-    let cloudEvent;
-    try {
-        cloudEvent = await request.json();
-    }
-    catch (error45) {
-        throw new Error("Failed to parse CloudEvent from request body");
-    }
-    if (!cloudEvent.type || !cloudEvent.source || !cloudEvent.id || typeof cloudEvent.data !== "object" || cloudEvent.data == null) {
-        throw new Error("Invalid CloudEvent: missing required fields");
-    }
-    if (cloudEvent.type !== "com.vercel.queue.v1beta") {
-        throw new Error(`Invalid CloudEvent type: expected 'com.vercel.queue.v1beta', got '${cloudEvent.type}'`);
-    }
-    const missingFields = [];
-    if (!("queueName" in cloudEvent.data))
-        missingFields.push("queueName");
-    if (!("consumerGroup" in cloudEvent.data))
-        missingFields.push("consumerGroup");
-    if (!("messageId" in cloudEvent.data))
-        missingFields.push("messageId");
-    if (missingFields.length > 0) {
-        throw new Error(`Missing required CloudEvent data fields: ${missingFields.join(", ")}`);
-    }
-    const { messageId, queueName, consumerGroup } = cloudEvent.data;
-    return {
-        queueName,
-        consumerGroup,
-        messageId
-    };
-}
-__name(parseCallback, "parseCallback");
-function handleCallback(handlers) {
-    for (const topicPattern in handlers) {
-        if (topicPattern.includes("*")) {
-            if (!validateWildcardPattern(topicPattern)) {
-                throw new Error(`Invalid wildcard pattern "${topicPattern}": * may only appear once and must be at the end of the topic name`);
-            }
-        }
-    }
-    const routeHandler = /* @__PURE__ */ __name(async (request) => {
-        try {
-            const { queueName, consumerGroup, messageId } = await parseCallback(request);
-            const topicHandler = findTopicHandler(queueName, handlers);
-            if (!topicHandler) {
-                const availableTopics = Object.keys(handlers).join(", ");
-                return Response.json({
-                    error: `No handler found for topic: ${queueName}`,
-                    availableTopics
-                }, {
-                    status: 404
-                });
-            }
-            const consumerGroupHandler = topicHandler[consumerGroup];
-            if (!consumerGroupHandler) {
-                const availableGroups = Object.keys(topicHandler).join(", ");
-                return Response.json({
-                    error: `No handler found for consumer group "${consumerGroup}" in topic "${queueName}".`,
-                    availableGroups
-                }, {
-                    status: 404
-                });
-            }
-            const client = new QueueClient();
-            const topic = new Topic(client, queueName);
-            const cg = topic.consumerGroup(consumerGroup);
-            await cg.consume(consumerGroupHandler, {
-                messageId
-            });
-            return Response.json({
-                status: "success"
-            });
-        }
-        catch (error45) {
-            console.error("Queue callback error:", error45);
-            if (error45 instanceof Error && (error45.message.includes("Missing required CloudEvent data fields") || error45.message.includes("Invalid CloudEvent") || error45.message.includes("Invalid CloudEvent type") || error45.message.includes("Invalid content type") || error45.message.includes("Failed to parse CloudEvent"))) {
-                return Response.json({
-                    error: error45.message
-                }, {
-                    status: 400
-                });
-            }
-            return Response.json({
-                error: "Failed to process queue message"
-            }, {
-                status: 500
-            });
-        }
-    }, "routeHandler");
-    if (isDevMode()) {
-        registerDevRouteHandler(routeHandler, handlers);
+var GLOBAL_KEY = Symbol.for("@vercel/queue.devHandlers");
+function getDevHandlerState() {
+    const g = globalThis;
+    if (!g[GLOBAL_KEY]) {
+        g[GLOBAL_KEY] = {
+            devRouteHandlers: /* @__PURE__ */ new Map(),
+            wildcardRouteHandlers: /* @__PURE__ */ new Map()
+        };
     }
-    return routeHandler;
+    return g[GLOBAL_KEY];
 }
-__name(handleCallback, "handleCallback");
-var devRouteHandlers = /* @__PURE__ */ new Map();
-var wildcardRouteHandlers = /* @__PURE__ */ new Map();
+__name(getDevHandlerState, "getDevHandlerState");
+var { devRouteHandlers, wildcardRouteHandlers } = getDevHandlerState();
 function cleanupDeadRefs(key, refs) {
     const aliveRefs = refs.filter((ref) => ref.deref() !== void 0);
     if (aliveRefs.length === 0) {
@@ -26092,9 +25961,144 @@ var Topic = class {
         return this.transport;
     }
 };
+function validateWildcardPattern(pattern) {
+    const firstIndex = pattern.indexOf("*");
+    const lastIndex = pattern.lastIndexOf("*");
+    if (firstIndex !== lastIndex) {
+        return false;
+    }
+    if (firstIndex === -1) {
+        return false;
+    }
+    if (firstIndex !== pattern.length - 1) {
+        return false;
+    }
+    return true;
+}
+__name(validateWildcardPattern, "validateWildcardPattern");
+function matchesWildcardPattern(topicName, pattern) {
+    const prefix = pattern.slice(0, -1);
+    return topicName.startsWith(prefix);
+}
+__name(matchesWildcardPattern, "matchesWildcardPattern");
+function findTopicHandler(queueName, handlers) {
+    const exactHandler = handlers[queueName];
+    if (exactHandler) {
+        return exactHandler;
+    }
+    for (const pattern in handlers) {
+        if (pattern.includes("*") && matchesWildcardPattern(queueName, pattern)) {
+            return handlers[pattern];
+        }
+    }
+    return null;
+}
+__name(findTopicHandler, "findTopicHandler");
+async function parseCallback(request) {
+    const contentType = request.headers.get("content-type");
+    if (!contentType || !contentType.includes("application/cloudevents+json")) {
+        throw new Error("Invalid content type: expected 'application/cloudevents+json'");
+    }
+    let cloudEvent;
+    try {
+        cloudEvent = await request.json();
+    }
+    catch (error45) {
+        throw new Error("Failed to parse CloudEvent from request body");
+    }
+    if (!cloudEvent.type || !cloudEvent.source || !cloudEvent.id || typeof cloudEvent.data !== "object" || cloudEvent.data == null) {
+        throw new Error("Invalid CloudEvent: missing required fields");
+    }
+    if (cloudEvent.type !== "com.vercel.queue.v1beta") {
+        throw new Error(`Invalid CloudEvent type: expected 'com.vercel.queue.v1beta', got '${cloudEvent.type}'`);
+    }
+    const missingFields = [];
+    if (!("queueName" in cloudEvent.data))
+        missingFields.push("queueName");
+    if (!("consumerGroup" in cloudEvent.data))
+        missingFields.push("consumerGroup");
+    if (!("messageId" in cloudEvent.data))
+        missingFields.push("messageId");
+    if (missingFields.length > 0) {
+        throw new Error(`Missing required CloudEvent data fields: ${missingFields.join(", ")}`);
+    }
+    const { messageId, queueName, consumerGroup } = cloudEvent.data;
+    return {
+        queueName,
+        consumerGroup,
+        messageId
+    };
+}
+__name(parseCallback, "parseCallback");
+function createCallbackHandler(handlers, client) {
+    for (const topicPattern in handlers) {
+        if (topicPattern.includes("*")) {
+            if (!validateWildcardPattern(topicPattern)) {
+                throw new Error(`Invalid wildcard pattern "${topicPattern}": * may only appear once and must be at the end of the topic name`);
+            }
+        }
+    }
+    const routeHandler = /* @__PURE__ */ __name(async (request) => {
+        try {
+            const { queueName, consumerGroup, messageId } = await parseCallback(request);
+            const topicHandler = findTopicHandler(queueName, handlers);
+            if (!topicHandler) {
+                const availableTopics = Object.keys(handlers).join(", ");
+                return Response.json({
+                    error: `No handler found for topic: ${queueName}`,
+                    availableTopics
+                }, {
+                    status: 404
+                });
+            }
+            const consumerGroupHandler = topicHandler[consumerGroup];
+            if (!consumerGroupHandler) {
+                const availableGroups = Object.keys(topicHandler).join(", ");
+                return Response.json({
+                    error: `No handler found for consumer group "${consumerGroup}" in topic "${queueName}".`,
+                    availableGroups
+                }, {
+                    status: 404
+                });
+            }
+            const topic = new Topic(client, queueName);
+            const cg = topic.consumerGroup(consumerGroup);
+            await cg.consume(consumerGroupHandler, {
+                messageId
+            });
+            return Response.json({
+                status: "success"
+            });
+        }
+        catch (error45) {
+            console.error("Queue callback error:", error45);
+            if (error45 instanceof Error && (error45.message.includes("Missing required CloudEvent data fields") || error45.message.includes("Invalid CloudEvent") || error45.message.includes("Invalid CloudEvent type") || error45.message.includes("Invalid content type") || error45.message.includes("Failed to parse CloudEvent"))) {
+                return Response.json({
+                    error: error45.message
+                }, {
+                    status: 400
+                });
+            }
+            return Response.json({
+                error: "Failed to process queue message"
+            }, {
+                status: 500
+            });
+        }
+    }, "routeHandler");
+    if (isDevMode()) {
+        registerDevRouteHandler(routeHandler, handlers);
+    }
+    return routeHandler;
+}
+__name(createCallbackHandler, "createCallbackHandler");
+function handleCallback(handlers, client) {
+    return createCallbackHandler(handlers, client || new QueueClient());
+}
+__name(handleCallback, "handleCallback");
 async function send(topicName, payload, options) {
     const transport = options?.transport || new JsonTransport();
-    const client = new QueueClient();
+    const client = options?.client || new QueueClient();
     const result = await client.sendMessage({
         queueName: topicName,
         payload,
@@ -26110,6 +26114,55 @@ async function send(topicName, payload, options) {
     };
 }
 __name(send, "send");
+var Client = class {
+    static {
+        __name(this, "Client");
+    }
+    client;
+    /**
+    * Create a new Client
+    * @param options QueueClient configuration options
+    */
+    constructor(options = {}) {
+        this.client = new QueueClient(options);
+    }
+    /**
+    * Send a message to a topic
+    * @param topicName Name of the topic to send to
+    * @param payload The data to send
+    * @param options Optional publish options and transport
+    * @returns Promise with the message ID
+    * @throws {BadRequestError} When request parameters are invalid
+    * @throws {UnauthorizedError} When authentication fails
+    * @throws {ForbiddenError} When access is denied (environment mismatch)
+    * @throws {InternalServerError} When server encounters an error
+    */
+    async send(topicName, payload, options) {
+        return send(topicName, payload, {
+            ...options,
+            client: this.client
+        });
+    }
+    /**
+    * Create a callback handler for processing queue messages
+    * Returns a Next.js route handler function that routes messages to appropriate handlers
+    * @param handlers Object with topic-specific handlers organized by consumer groups
+    * @returns A Next.js route handler function
+    *
+    * @example
+    * ```typescript
+    * export const POST = client.handleCallback({
+    *   "user-events": {
+    *     "welcome": (user, metadata) => console.log("Welcoming user", user),
+    *     "analytics": (user, metadata) => console.log("Tracking user", user),
+    *   },
+    * });
+    * ```
+    */
+    handleCallback(handlers) {
+        return handleCallback(handlers, this.client);
+    }
+};
 // ../../node_modules/.pnpm/zod@4.1.11/node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -41333,7 +41386,7 @@ __name(createLocalWorld, "createLocalWorld");
 var import_node_os = __toESM(require("node:os"), 1);
 var import_oidc2 = __toESM(require_dist(), 1);
 // ../world-vercel/dist/version.js
-var version2 = "4.0.1-beta.14";
+var version2 = "4.0.1-beta.15";
 // ../world-vercel/dist/utils.js
 var DEFAULT_RESOLVE_DATA_OPTION2 = "all";
 function dateToStringReplacer(_key, value) {
@@ -41475,19 +41528,12 @@ var VERCEL_QUEUE_MAX_VISIBILITY = 82800;
 function createQueue2(config3) {
     const { baseUrl, usingProxy } = getHttpUrl(config3);
     const headers = getHeaders(config3);
-    if (usingProxy) {
-        process.env.VERCEL_QUEUE_BASE_URL = `${baseUrl}`;
-        process.env.VERCEL_QUEUE_BASE_PATH = "/queues/v2/messages";
-        if (config3?.token) {
-            process.env.VERCEL_QUEUE_TOKEN = config3.token;
-        }
-        if (headers) {
-            headers.forEach((value, key) => {
-                const sanitizedKey = key.replaceAll("-", "__");
-                process.env[`VERCEL_QUEUE_HEADER_${sanitizedKey}`] = value;
-            });
-        }
-    }
+    const queueClient = new Client({
+        baseUrl: usingProxy ? baseUrl : void 0,
+        basePath: usingProxy ? "/queues/v2/messages" : void 0,
+        token: usingProxy ? config3?.token : void 0,
+        headers: Object.fromEntries(headers.entries())
+    });
     const queue = /* @__PURE__ */ __name(async (queueName, x, opts) => {
         const hasEncoder = typeof MessageWrapper.encode === "function";
         if (!hasEncoder) {
@@ -41499,13 +41545,13 @@ function createQueue2(config3) {
             queueName
         });
         const sanitizedQueueName = queueName.replace(/[^A-Za-z0-9-_]/g, "-");
-        const { messageId } = await send(sanitizedQueueName, encoded, opts);
+        const { messageId } = await queueClient.send(sanitizedQueueName, encoded, opts);
         return {
             messageId: MessageId.parse(messageId)
         };
     }, "queue");
     const createQueueHandler = /* @__PURE__ */ __name((prefix, handler) => {
-        return handleCallback({
+        return queueClient.handleCallback({
             [`${prefix}*`]: {
                 default: /* @__PURE__ */ __name(async (body, meta) => {
                     const { payload, queueName } = MessageWrapper.parse(body);
@@ -42944,17 +42990,6 @@ async function brokenWf() {
 __name(brokenWf, "brokenWf");
 brokenWf.workflowId = "workflow//workflows/noop.ts//brokenWf";
 registerStepFunction("step//workflows/noop.ts//noop", noop);
-// workflows/null-byte.ts
-async function nullByteStep() {
-    return "null byte \0";
-}
-__name(nullByteStep, "nullByteStep");
-async function nullByteWorkflow() {
-    throw new Error("You attempted to execute workflow nullByteWorkflow function directly. To start a workflow, use start(nullByteWorkflow) from workflow/api");
-}
-__name(nullByteWorkflow, "nullByteWorkflow");
-nullByteWorkflow.workflowId = "workflow//workflows/null-byte.ts//nullByteWorkflow";
-registerStepFunction("step//workflows/null-byte.ts//nullByteStep", nullByteStep);
 // workflows/retriable-and-fatal.ts
 async function retryableAndFatalErrorWorkflow() {
     throw new Error("You attempted to execute workflow retryableAndFatalErrorWorkflow function directly. To start a workflow, use start(retryableAndFatalErrorWorkflow) from workflow/api");
@@ -42982,6 +43017,28 @@ async function stepThatFails() {
 __name(stepThatFails, "stepThatFails");
 registerStepFunction("step//workflows/retriable-and-fatal.ts//stepThatThrowsRetryableError", stepThatThrowsRetryableError);
 registerStepFunction("step//workflows/retriable-and-fatal.ts//stepThatFails", stepThatFails);
+// workflows/null-byte.ts
+async function nullByteStep() {
+    return "null byte \0";
+}
+__name(nullByteStep, "nullByteStep");
+async function nullByteWorkflow() {
+    throw new Error("You attempted to execute workflow nullByteWorkflow function directly. To start a workflow, use start(nullByteWorkflow) from workflow/api");
+}
+__name(nullByteWorkflow, "nullByteWorkflow");
+nullByteWorkflow.workflowId = "workflow//workflows/null-byte.ts//nullByteWorkflow";
+registerStepFunction("step//workflows/null-byte.ts//nullByteStep", nullByteStep);
+// workflows/addition.ts
+async function add(num, num2) {
+    return num + num2;
+}
+__name(add, "add");
+async function addition(num, num2) {
+    throw new Error("You attempted to execute workflow addition function directly. To start a workflow, use start(addition) from workflow/api");
+}
+__name(addition, "addition");
+addition.workflowId = "workflow//workflows/addition.ts//addition";
+registerStepFunction("step//workflows/addition.ts//add", add);
 // ../core/dist/runtime.js
 var import_functions4 = __toESM(require_functions(), 1);
 // ../core/dist/logger.js