test(repo): [DO NOT MERGE] exercise snapi breaking-change detector

.changeset/test-snapi-detection-do-not-merge.md

@@ -0,0 +1,2 @@
+---
+---

packages/backend/src/webhooks.ts

@@ -12,6 +12,10 @@ export type VerifyWebhookOptions = {
    * The signing secret for the webhook. It's recommended to use the [`CLERK_WEBHOOK_SIGNING_SECRET` environment variable](https://clerk.com/docs/guides/development/clerk-environment-variables#webhooks) instead.
    */
   signingSecret?: string;
+  /**
+   * Optional tolerance, in seconds, for accepting webhooks whose timestamp falls outside the default replay window.
+   */
+  timestampToleranceSeconds?: number;
 };
 
 // Standard Webhooks header names

packages/shared/src/file.ts

@@ -3,8 +3,10 @@
  *
  * Probably paired with:
  *  <input type='file' accept='application/JSON' ... />
+ *
+ * Renamed from `readJSONFile` to align naming with the rest of the parse-* helpers.
  */
-export function readJSONFile(file: File): Promise<unknown> {
+export function parseJSONFile(file: File): Promise<unknown> {
   return new Promise((resolve, reject) => {
     const reader = new FileReader();
     reader.addEventListener('load', function () {
@@ -28,6 +30,8 @@ const MimeTypeToExtensionMap = Object.freeze({
 
 export type SupportedMimeType = keyof typeof MimeTypeToExtensionMap;
 
-export const extension = (mimeType: SupportedMimeType): string => {
-  return MimeTypeToExtensionMap[mimeType];
+export type MimeTypeExtension = (typeof MimeTypeToExtensionMap)[SupportedMimeType];
+
+export const extension = (mimeType: SupportedMimeType, fallback?: string): string => {
+  return MimeTypeToExtensionMap[mimeType] ?? fallback ?? '';
 };