@sentry/junior 0.71.0 → 0.71.2

package/dist/app.js

@@ -93,8 +93,8 @@ import {
   pluginCatalogConfigFromPluginSet,
   pluginHookRegistrationsFromPluginSet,
   resolveConversationWorkQueueTopic,
-  verifySignedConversationQueueMessage
-} from "./chunk-IGLNC5H6.js";
+  verifyConversationQueueMessage
+} from "./chunk-XE2VFQQN.js";
 import {
   SlackActionError,
   createSlackDestination,
@@ -23259,6 +23259,21 @@ import {
   registerDevConsumer
 } from "@vercel/queue";
 
+// src/chat/task-execution/queue.ts
+var ConversationQueueMessageRejectedError = class extends Error {
+  conversationId;
+  reason;
+  constructor(reason, message, options = {}) {
+    super(message);
+    this.name = "ConversationQueueMessageRejectedError";
+    this.reason = reason;
+    this.conversationId = options.conversationId;
+  }
+};
+function isConversationQueueMessageRejectedError(error) {
+  return error instanceof ConversationQueueMessageRejectedError;
+}
+
 // src/chat/task-execution/worker.ts
 var CONVERSATION_WORK_DEFER_DELAY_MS = 15e3;
 var CONVERSATION_WORK_SOFT_YIELD_AFTER_MS = 24e4;
@@ -23279,11 +23294,21 @@ async function sendWakeNudge(args) {
       idempotencyKey: args.idempotencyKey
     }
   );
-  await markConversationWorkEnqueued({
-    conversationId: args.conversationId,
-    nowMs: args.nowMs,
-    state: args.options.state
-  });
+  try {
+    await markConversationWorkEnqueued({
+      conversationId: args.conversationId,
+      nowMs: args.nowMs,
+      state: args.options.state
+    });
+  } catch (error) {
+    logException(
+      error,
+      "conversation_work_enqueue_marker_failed",
+      { conversationId: args.conversationId },
+      {},
+      "Conversation work enqueue marker failed after queue acceptance"
+    );
+  }
 }
 async function requestLostLeaseRecovery(args) {
   const continuationMarked = await requestConversationContinuation({
@@ -23361,8 +23386,10 @@ async function processConversationWork(message, options) {
     return { status: "no_work" };
   }
   if (!sameDestination(initial.destination, message.destination)) {
-    throw new Error(
-      `Conversation work queue destination changed for ${conversationId}`
+    throw new ConversationQueueMessageRejectedError(
+      "destination_mismatch",
+      `Conversation work queue destination changed for ${conversationId}`,
+      { conversationId }
     );
   }
   const destination = initial.destination;
@@ -23711,19 +23738,59 @@ async function processConversationQueueMessage(message, options) {
     state: options.state
   });
 }
-async function handleConversationQueueMessage(message, options) {
-  const verified = verifySignedConversationQueueMessage(message);
-  if (!verified) {
-    throw new Error("Unauthorized conversation queue message");
+async function handleConversationQueueMessage(message, metadata, options) {
+  const verification = verifyConversationQueueMessage(message);
+  if (verification.status === "rejected") {
+    logConversationQueueMessageRejected(verification.reason, metadata);
+    return;
+  }
+  if (verification.status === "unavailable") {
+    throw new Error(
+      `Conversation queue message verification unavailable: ${verification.reason}`
+    );
+  }
+  try {
+    await runWithTurnRequestDeadline(
+      () => processConversationQueueMessage(verification.message, options)
+    );
+  } catch (error) {
+    if (isConversationQueueMessageRejectedError(error)) {
+      logConversationQueueMessageRejected(error.reason, metadata, {
+        conversationId: error.conversationId
+      });
+      return;
+    }
+    throw error;
   }
-  await runWithTurnRequestDeadline(
-    () => processConversationQueueMessage(verified, options)
+}
+function logConversationQueueMessageRejected(reason, metadata, context = {}) {
+  logWarn(
+    "conversation_queue_message_rejected",
+    context.conversationId ? { conversationId: context.conversationId } : {},
+    {
+      "app.queue.consumer_group": metadata.consumerGroup,
+      "app.queue.delivery_count": metadata.deliveryCount,
+      "app.queue.message_id": metadata.messageId,
+      "app.queue.reject_reason": reason,
+      "app.queue.topic_name": metadata.topicName
+    },
+    "Conversation queue message rejected without retry"
   );
 }
+function handleConversationQueueRetry(error, metadata) {
+  if (!isConversationQueueMessageRejectedError(error)) {
+    return void 0;
+  }
+  logConversationQueueMessageRejected(error.reason, metadata, {
+    conversationId: error.conversationId
+  });
+  return { acknowledge: true };
+}
 function createVercelConversationWorkCallback(options) {
   return handleCallback(
-    (message) => handleConversationQueueMessage(message, options),
+    (message, metadata) => handleConversationQueueMessage(message, metadata, options),
     {
+      retry: handleConversationQueueRetry,
       visibilityTimeoutSeconds: options.visibilityTimeoutSeconds ?? resolveConversationWorkVisibilityTimeoutSeconds()
     }
   );
@@ -23735,7 +23802,8 @@ function registerVercelConversationWorkDevConsumer(options) {
   return registerDevConsumer({
     client: new QueueClient(),
     consumerGroup: CONVERSATION_WORK_DEV_CONSUMER_GROUP,
-    handler: (message) => handleConversationQueueMessage(message, options),
+    handler: (message, metadata) => handleConversationQueueMessage(message, metadata, options),
+    retry: handleConversationQueueRetry,
     topic: resolveConversationWorkQueueTopic(options),
     visibilityTimeoutSeconds: options.visibilityTimeoutSeconds ?? resolveConversationWorkVisibilityTimeoutSeconds()
   });

package/dist/chat/task-execution/queue-signing.d.ts

@@ -1,12 +1,25 @@
 import type { ConversationQueueMessage } from "./queue";
 declare const CONVERSATION_WORK_QUEUE_SIGNATURE_VERSION = "v1";
+export declare const CONVERSATION_WORK_QUEUE_SIGNATURE_MAX_SKEW_MS: number;
 interface SignedConversationQueueMessage extends ConversationQueueMessage {
     signature: string;
     signatureVersion: typeof CONVERSATION_WORK_QUEUE_SIGNATURE_VERSION;
     signedAtMs: number;
 }
+export type ConversationQueueMessageVerificationResult = {
+    message: ConversationQueueMessage;
+    status: "verified";
+} | {
+    reason: "expired" | "malformed" | "signature_mismatch";
+    status: "rejected";
+} | {
+    reason: "invalid_clock" | "missing_secret";
+    status: "unavailable";
+};
 /** Sign a conversation queue payload before it crosses the public callback route. */
 export declare function signConversationQueueMessage(message: ConversationQueueMessage, nowMs?: number): SignedConversationQueueMessage;
+/** Explain whether a queue payload is verified, rejected, or temporarily unverifiable. */
+export declare function verifyConversationQueueMessage(value: unknown, nowMs?: number): ConversationQueueMessageVerificationResult;
 /** Verify a signed conversation queue payload from the Vercel Queue callback. */
 export declare function verifySignedConversationQueueMessage(value: unknown, nowMs?: number): ConversationQueueMessage | undefined;
 export {};

package/dist/chat/task-execution/queue.d.ts

@@ -3,6 +3,16 @@ export interface ConversationQueueMessage {
     conversationId: string;
     destination: Destination;
 }
+export type ConversationQueueMessageRejectReason = "destination_mismatch" | "expired" | "malformed" | "signature_mismatch" | "unauthorized";
+export declare class ConversationQueueMessageRejectedError extends Error {
+    conversationId?: string;
+    reason: ConversationQueueMessageRejectReason;
+    constructor(reason: ConversationQueueMessageRejectReason, message: string, options?: {
+        conversationId?: string;
+    });
+}
+/** Return whether a queue payload was permanently rejected at the message boundary. */
+export declare function isConversationQueueMessageRejectedError(error: unknown): error is ConversationQueueMessageRejectedError;
 export interface ConversationQueueSendOptions {
     delayMs?: number;
     idempotencyKey?: string;

package/dist/chat/task-execution/vercel-callback.d.ts

@@ -1,5 +1,5 @@
 import type { StateAdapter } from "chat";
-import type { ConversationWorkQueue } from "./queue";
+import { type ConversationWorkQueue } from "./queue";
 import { type ConversationWorkProcessResult, type ConversationWorkerResult, type ConversationWorkerContext } from "./worker";
 export declare const CONVERSATION_WORK_VISIBILITY_TIMEOUT_BUFFER_SECONDS = 30;
 export declare const CONVERSATION_WORK_DEV_CONSUMER_GROUP = "junior_conversation_work_dev";

package/dist/chat/task-execution/vercel-queue.d.ts

@@ -1,6 +1,7 @@
 import type { SendOptions, SendResult } from "@vercel/queue";
 import type { ConversationWorkQueue } from "./queue";
 export declare const DEFAULT_CONVERSATION_WORK_QUEUE_TOPIC = "junior_conversation_work";
+export declare const CONVERSATION_WORK_QUEUE_RETENTION_SECONDS: number;
 interface QueueSender {
     send<T = unknown>(topicName: string, payload: T, options?: SendOptions): Promise<SendResult>;
 }

package/dist/chat/task-execution/worker.d.ts

@@ -1,6 +1,6 @@
 import type { StateAdapter } from "chat";
 import type { Destination } from "@sentry/junior-plugin-api";
-import type { ConversationQueueMessage, ConversationWorkQueue } from "./queue";
+import { type ConversationQueueMessage, type ConversationWorkQueue } from "./queue";
 import { type InboundMessageRecord } from "./store";
 export declare const CONVERSATION_WORK_DEFER_DELAY_MS = 15000;
 export declare const CONVERSATION_WORK_SOFT_YIELD_AFTER_MS = 240000;

package/dist/{chunk-IGLNC5H6.js → chunk-XE2VFQQN.js}

@@ -163,24 +163,37 @@ function signConversationQueueMessage(message, nowMs = Date.now()) {
     signature: signPayload(message, nowMs, secret)
   };
 }
-function verifySignedConversationQueueMessage(value, nowMs = Date.now()) {
+function verifyConversationQueueMessage(value, nowMs = Date.now()) {
   const message = parseSignedConversationQueueMessage(value);
+  if (!message) {
+    return { status: "rejected", reason: "malformed" };
+  }
   const secret = getConversationWorkQueueSecret();
-  if (!message || !secret || !Number.isFinite(nowMs) || Math.abs(nowMs - message.signedAtMs) > CONVERSATION_WORK_QUEUE_SIGNATURE_MAX_SKEW_MS) {
-    return void 0;
+  if (!secret) {
+    return { status: "unavailable", reason: "missing_secret" };
+  }
+  if (!Number.isFinite(nowMs)) {
+    return { status: "unavailable", reason: "invalid_clock" };
+  }
+  if (Math.abs(nowMs - message.signedAtMs) > CONVERSATION_WORK_QUEUE_SIGNATURE_MAX_SKEW_MS) {
+    return { status: "rejected", reason: "expired" };
   }
   const expected = signPayload(message, message.signedAtMs, secret);
   if (!timingSafeMatch(expected, message.signature)) {
-    return void 0;
+    return { status: "rejected", reason: "signature_mismatch" };
   }
   return {
-    conversationId: message.conversationId,
-    destination: message.destination
+    status: "verified",
+    message: {
+      conversationId: message.conversationId,
+      destination: message.destination
+    }
   };
 }
 
 // src/chat/task-execution/vercel-queue.ts
 var DEFAULT_CONVERSATION_WORK_QUEUE_TOPIC = "junior_conversation_work";
+var CONVERSATION_WORK_QUEUE_RETENTION_SECONDS = CONVERSATION_WORK_QUEUE_SIGNATURE_MAX_SKEW_MS / 1e3;
 var defaultQueue;
 function resolveConversationWorkQueueTopic(options = {}) {
   const topic = options.topic?.trim();
@@ -203,7 +216,7 @@ function createVercelConversationWorkQueue(options = {}) {
         {
           idempotencyKey: sendOptions?.idempotencyKey,
           delaySeconds: toDelaySeconds(sendOptions),
-          retentionSeconds: options.retentionSeconds
+          retentionSeconds: options.retentionSeconds ?? CONVERSATION_WORK_QUEUE_RETENTION_SECONDS
         }
       );
       return result.messageId ? { messageId: result.messageId } : {};
@@ -219,7 +232,7 @@ export {
   defineJuniorPlugins,
   pluginCatalogConfigFromPluginSet,
   pluginHookRegistrationsFromPluginSet,
-  verifySignedConversationQueueMessage,
+  verifyConversationQueueMessage,
   resolveConversationWorkQueueTopic,
   getVercelConversationWorkQueue
 };

package/dist/nitro.js

@@ -2,7 +2,7 @@ import {
   pluginCatalogConfigFromPluginSet,
   pluginHookRegistrationsFromPluginSet,
   resolveConversationWorkQueueTopic
-} from "./chunk-IGLNC5H6.js";
+} from "./chunk-XE2VFQQN.js";
 import "./chunk-76YMBKW7.js";
 import {
   JUNIOR_CONVERSATION_WORK_CALLBACK_ROUTE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior",
-  "version": "0.71.0",
+  "version": "0.71.2",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -65,7 +65,7 @@
     "node-html-markdown": "^2.0.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.71.0"
+    "@sentry/junior-plugin-api": "0.71.2"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -78,7 +78,7 @@
     "typescript": "^6.0.3",
     "vercel": "^54.4.0",
     "vitest": "^4.1.7",
-    "@sentry/junior-scheduler": "0.71.0"
+    "@sentry/junior-scheduler": "0.71.2"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly",