chore(backend): break-check validation probe (do not merge)

Author: jacekradko

.changeset/break-check-test-probe.md

@@ -0,0 +1,5 @@
+---
+'@clerk/backend': patch
+---
+
+Break-check validation probe. Do not merge.

packages/backend/src/webhooks.ts

@@ -87,7 +87,7 @@ function createStandardWebhookHeaders(request: Request): Record<string, string>
  * }
  * ```
  */
-export async function verifyWebhook(request: Request, options: VerifyWebhookOptions = {}): Promise<WebhookEvent> {
+export async function verifyWebhook(request: Request, options: VerifyWebhookOptions): Promise<WebhookEvent> {
   const secret = options.signingSecret ?? getEnvVariable('CLERK_WEBHOOK_SIGNING_SECRET');
 
   if (!secret) {
@@ -140,3 +140,14 @@ export async function verifyWebhook(request: Request, options: VerifyWebhookOpti
     return errorThrower.throw(`Unable to verify incoming webhook: ${e instanceof Error ? e.message : 'Unknown error'}`);
   }
 }
+
+/**
+ * Returns the Standard Webhooks header names this verifier reads from incoming requests.
+ */
+export function getStandardWebhookHeaderNames(): { id: string; timestamp: string; signature: string } {
+  return {
+    id: STANDARD_WEBHOOK_ID_HEADER,
+    timestamp: STANDARD_WEBHOOK_TIMESTAMP_HEADER,
+    signature: STANDARD_WEBHOOK_SIGNATURE_HEADER,
+  };
+}