voice-router-dev 0.8.8 → 0.9.0

package/dist/webhooks.d.mts

@@ -1,4 +1,4 @@
-import { gS as TranscriptionStatus, gP as Speaker, gQ as Word, gR as Utterance, V as CallbackTranscriptionSuccessPayload, K as CallbackTranscriptionErrorPayload, bv as Transcript, dx as ListenV1Response, eZ as RetrieveTranscriptResponse, fz as SpeechToTextChunkResponseModel } from './speechToTextChunkResponseModel-DmajV4F-.mjs';
+import { h2 as TranscriptionStatus, g$ as Speaker, h0 as Word, h1 as Utterance, V as CallbackTranscriptionSuccessPayload, K as CallbackTranscriptionErrorPayload, bt as Transcript, dw as ListenV1Response, eY as RetrieveTranscriptResponse, fL as SpeechToTextChunkResponseModel, fy as Transcription } from './speechToTextChunkResponseModel-D8VJ-wz6.mjs';
 import { T as TranscriptionProvider } from './provider-metadata-BJ29OPW1.mjs';
 import './constants.mjs';
 
@@ -258,6 +258,7 @@ type ProviderWebhookPayloadMap = {
     "openai-whisper": never;
     speechmatics: RetrieveTranscriptResponse;
     elevenlabs: SpeechToTextChunkResponseModel;
+    soniox: Transcription;
 };
 /**
  * Unified webhook event types
@@ -779,6 +780,73 @@ declare class ElevenLabsWebhookHandler extends BaseWebhookHandler {
  */
 declare function createElevenLabsWebhookHandler(): ElevenLabsWebhookHandler;
 
+/**
+ * Soniox webhook handler
+ * Parses and normalizes Soniox webhook callbacks
+ *
+ * Soniox webhooks are notification-only: payload is `{ id, status }`.
+ * The consumer must call `getTranscript(id)` to fetch the full transcript.
+ *
+ * @see https://soniox.com/docs/stt/async/webhooks
+ */
+
+/**
+ * Soniox webhook handler
+ *
+ * Handles webhook callbacks from Soniox async transcription API.
+ * Soniox sends minimal notification payloads with `{ id, status }`.
+ * No transcript data is included — use `getTranscript(id)` to fetch results.
+ *
+ * @example
+ * ```typescript
+ * import { SonioxWebhookHandler } from '@meeting-baas/sdk/webhooks';
+ *
+ * const handler = new SonioxWebhookHandler();
+ *
+ * const event = handler.parse(req.body);
+ * if (event.eventType === 'transcription.completed') {
+ *   // Fetch transcript via adapter
+ *   const result = await sonioxAdapter.getTranscript(event.data.id);
+ * }
+ * ```
+ */
+declare class SonioxWebhookHandler extends BaseWebhookHandler {
+    readonly provider: TranscriptionProvider;
+    /**
+     * Check if payload matches Soniox webhook format
+     *
+     * Soniox webhooks have a minimal `{ id, status }` shape.
+     * Excludes false positives by checking the payload does NOT have
+     * fields unique to other providers.
+     */
+    matches(payload: unknown, _options?: {
+        queryParams?: Record<string, string>;
+        userAgent?: string;
+    }): boolean;
+    /**
+     * Parse Soniox webhook payload to unified format
+     *
+     * Returns notification-only data (id + status). No transcript text
+     * is included — Soniox webhooks are notification-only.
+     */
+    parse(payload: unknown, _options?: {
+        queryParams?: Record<string, string>;
+    }): UnifiedWebhookEvent;
+    /**
+     * Verify Soniox webhook signature
+     *
+     * Soniox uses custom auth headers on webhook delivery rather than
+     * HMAC signature verification. No server-side verification is available.
+     *
+     * @returns Always returns true
+     */
+    verify(): boolean;
+}
+/**
+ * Factory function to create a Soniox webhook handler
+ */
+declare function createSonioxWebhookHandler(): SonioxWebhookHandler;
+
 /**
  * Webhook router with automatic provider detection
  * Routes webhook payloads to the correct provider handler
@@ -982,4 +1050,4 @@ declare class WebhookRouter {
  */
 declare function createWebhookRouter(): WebhookRouter;
 
-export { AssemblyAIWebhookHandler, type AssemblyAIWebhookPayload, AzureWebhookHandler, BaseWebhookHandler, DeepgramWebhookHandler, ListenV1Response as DeepgramWebhookPayload, ElevenLabsWebhookHandler, CallbackTranscriptionErrorPayload as GladiaWebhookErrorPayload, GladiaWebhookHandler, type GladiaWebhookPayload, CallbackTranscriptionSuccessPayload as GladiaWebhookSuccessPayload, type ProviderWebhookPayloadMap, SpeechmaticsWebhookHandler, type UnifiedWebhookEvent, type WebhookEventType, WebhookRouter, type WebhookRouterOptions, type WebhookRouterResult, type WebhookValidation, type WebhookVerificationOptions, createAssemblyAIWebhookHandler, createAzureWebhookHandler, createDeepgramWebhookHandler, createElevenLabsWebhookHandler, createGladiaWebhookHandler, createWebhookRouter };
+export { AssemblyAIWebhookHandler, type AssemblyAIWebhookPayload, AzureWebhookHandler, type AzureWebhookPayload, BaseWebhookHandler, DeepgramWebhookHandler, ListenV1Response as DeepgramWebhookPayload, ElevenLabsWebhookHandler, SpeechToTextChunkResponseModel as ElevenLabsWebhookPayload, CallbackTranscriptionErrorPayload as GladiaWebhookErrorPayload, GladiaWebhookHandler, type GladiaWebhookPayload, CallbackTranscriptionSuccessPayload as GladiaWebhookSuccessPayload, type ProviderWebhookPayloadMap, SonioxWebhookHandler, Transcription as SonioxWebhookPayload, SpeechmaticsWebhookHandler, RetrieveTranscriptResponse as SpeechmaticsWebhookPayload, type UnifiedWebhookEvent, type WebhookEventType, WebhookRouter, type WebhookRouterOptions, type WebhookRouterResult, type WebhookValidation, type WebhookVerificationOptions, createAssemblyAIWebhookHandler, createAzureWebhookHandler, createDeepgramWebhookHandler, createElevenLabsWebhookHandler, createGladiaWebhookHandler, createSonioxWebhookHandler, createWebhookRouter };

package/dist/webhooks.d.ts

@@ -1,4 +1,4 @@
-import { gS as TranscriptionStatus, gP as Speaker, gQ as Word, gR as Utterance, V as CallbackTranscriptionSuccessPayload, K as CallbackTranscriptionErrorPayload, bv as Transcript, dx as ListenV1Response, eZ as RetrieveTranscriptResponse, fz as SpeechToTextChunkResponseModel } from './speechToTextChunkResponseModel-B4kVoFc3.js';
+import { h2 as TranscriptionStatus, g$ as Speaker, h0 as Word, h1 as Utterance, V as CallbackTranscriptionSuccessPayload, K as CallbackTranscriptionErrorPayload, bt as Transcript, dw as ListenV1Response, eY as RetrieveTranscriptResponse, fL as SpeechToTextChunkResponseModel, fy as Transcription } from './speechToTextChunkResponseModel-CI-Aqxcr.js';
 import { T as TranscriptionProvider } from './provider-metadata-D1d-9cng.js';
 import './constants.js';
 
@@ -258,6 +258,7 @@ type ProviderWebhookPayloadMap = {
     "openai-whisper": never;
     speechmatics: RetrieveTranscriptResponse;
     elevenlabs: SpeechToTextChunkResponseModel;
+    soniox: Transcription;
 };
 /**
  * Unified webhook event types
@@ -779,6 +780,73 @@ declare class ElevenLabsWebhookHandler extends BaseWebhookHandler {
  */
 declare function createElevenLabsWebhookHandler(): ElevenLabsWebhookHandler;
 
+/**
+ * Soniox webhook handler
+ * Parses and normalizes Soniox webhook callbacks
+ *
+ * Soniox webhooks are notification-only: payload is `{ id, status }`.
+ * The consumer must call `getTranscript(id)` to fetch the full transcript.
+ *
+ * @see https://soniox.com/docs/stt/async/webhooks
+ */
+
+/**
+ * Soniox webhook handler
+ *
+ * Handles webhook callbacks from Soniox async transcription API.
+ * Soniox sends minimal notification payloads with `{ id, status }`.
+ * No transcript data is included — use `getTranscript(id)` to fetch results.
+ *
+ * @example
+ * ```typescript
+ * import { SonioxWebhookHandler } from '@meeting-baas/sdk/webhooks';
+ *
+ * const handler = new SonioxWebhookHandler();
+ *
+ * const event = handler.parse(req.body);
+ * if (event.eventType === 'transcription.completed') {
+ *   // Fetch transcript via adapter
+ *   const result = await sonioxAdapter.getTranscript(event.data.id);
+ * }
+ * ```
+ */
+declare class SonioxWebhookHandler extends BaseWebhookHandler {
+    readonly provider: TranscriptionProvider;
+    /**
+     * Check if payload matches Soniox webhook format
+     *
+     * Soniox webhooks have a minimal `{ id, status }` shape.
+     * Excludes false positives by checking the payload does NOT have
+     * fields unique to other providers.
+     */
+    matches(payload: unknown, _options?: {
+        queryParams?: Record<string, string>;
+        userAgent?: string;
+    }): boolean;
+    /**
+     * Parse Soniox webhook payload to unified format
+     *
+     * Returns notification-only data (id + status). No transcript text
+     * is included — Soniox webhooks are notification-only.
+     */
+    parse(payload: unknown, _options?: {
+        queryParams?: Record<string, string>;
+    }): UnifiedWebhookEvent;
+    /**
+     * Verify Soniox webhook signature
+     *
+     * Soniox uses custom auth headers on webhook delivery rather than
+     * HMAC signature verification. No server-side verification is available.
+     *
+     * @returns Always returns true
+     */
+    verify(): boolean;
+}
+/**
+ * Factory function to create a Soniox webhook handler
+ */
+declare function createSonioxWebhookHandler(): SonioxWebhookHandler;
+
 /**
  * Webhook router with automatic provider detection
  * Routes webhook payloads to the correct provider handler
@@ -982,4 +1050,4 @@ declare class WebhookRouter {
  */
 declare function createWebhookRouter(): WebhookRouter;
 
-export { AssemblyAIWebhookHandler, type AssemblyAIWebhookPayload, AzureWebhookHandler, BaseWebhookHandler, DeepgramWebhookHandler, ListenV1Response as DeepgramWebhookPayload, ElevenLabsWebhookHandler, CallbackTranscriptionErrorPayload as GladiaWebhookErrorPayload, GladiaWebhookHandler, type GladiaWebhookPayload, CallbackTranscriptionSuccessPayload as GladiaWebhookSuccessPayload, type ProviderWebhookPayloadMap, SpeechmaticsWebhookHandler, type UnifiedWebhookEvent, type WebhookEventType, WebhookRouter, type WebhookRouterOptions, type WebhookRouterResult, type WebhookValidation, type WebhookVerificationOptions, createAssemblyAIWebhookHandler, createAzureWebhookHandler, createDeepgramWebhookHandler, createElevenLabsWebhookHandler, createGladiaWebhookHandler, createWebhookRouter };
+export { AssemblyAIWebhookHandler, type AssemblyAIWebhookPayload, AzureWebhookHandler, type AzureWebhookPayload, BaseWebhookHandler, DeepgramWebhookHandler, ListenV1Response as DeepgramWebhookPayload, ElevenLabsWebhookHandler, SpeechToTextChunkResponseModel as ElevenLabsWebhookPayload, CallbackTranscriptionErrorPayload as GladiaWebhookErrorPayload, GladiaWebhookHandler, type GladiaWebhookPayload, CallbackTranscriptionSuccessPayload as GladiaWebhookSuccessPayload, type ProviderWebhookPayloadMap, SonioxWebhookHandler, Transcription as SonioxWebhookPayload, SpeechmaticsWebhookHandler, RetrieveTranscriptResponse as SpeechmaticsWebhookPayload, type UnifiedWebhookEvent, type WebhookEventType, WebhookRouter, type WebhookRouterOptions, type WebhookRouterResult, type WebhookValidation, type WebhookVerificationOptions, createAssemblyAIWebhookHandler, createAzureWebhookHandler, createDeepgramWebhookHandler, createElevenLabsWebhookHandler, createGladiaWebhookHandler, createSonioxWebhookHandler, createWebhookRouter };

package/dist/webhooks.js

@@ -37,6 +37,7 @@ __export(webhooks_exports, {
   DeepgramWebhookHandler: () => DeepgramWebhookHandler,
   ElevenLabsWebhookHandler: () => ElevenLabsWebhookHandler,
   GladiaWebhookHandler: () => GladiaWebhookHandler,
+  SonioxWebhookHandler: () => SonioxWebhookHandler,
   SpeechmaticsWebhookHandler: () => SpeechmaticsWebhookHandler,
   WebhookRouter: () => WebhookRouter,
   createAssemblyAIWebhookHandler: () => createAssemblyAIWebhookHandler,
@@ -44,6 +45,7 @@ __export(webhooks_exports, {
   createDeepgramWebhookHandler: () => createDeepgramWebhookHandler,
   createElevenLabsWebhookHandler: () => createElevenLabsWebhookHandler,
   createGladiaWebhookHandler: () => createGladiaWebhookHandler,
+  createSonioxWebhookHandler: () => createSonioxWebhookHandler,
   createWebhookRouter: () => createWebhookRouter
 });
 module.exports = __toCommonJS(webhooks_exports);
@@ -1108,6 +1110,113 @@ function createElevenLabsWebhookHandler() {
   return new ElevenLabsWebhookHandler();
 }
 
+// src/generated/soniox/schema/transcriptionStatus.ts
+var TranscriptionStatus = {
+  queued: "queued",
+  processing: "processing",
+  completed: "completed",
+  error: "error"
+};
+
+// src/webhooks/soniox-webhook.ts
+var SonioxWebhookHandler = class extends BaseWebhookHandler {
+  constructor() {
+    super(...arguments);
+    this.provider = "soniox";
+  }
+  /**
+   * Check if payload matches Soniox webhook format
+   *
+   * Soniox webhooks have a minimal `{ id, status }` shape.
+   * Excludes false positives by checking the payload does NOT have
+   * fields unique to other providers.
+   */
+  matches(payload, _options) {
+    if (!payload || typeof payload !== "object") {
+      return false;
+    }
+    const obj = payload;
+    if (typeof obj.id !== "string" || typeof obj.status !== "string") {
+      return false;
+    }
+    const validStatuses = Object.values(TranscriptionStatus);
+    if (!validStatuses.includes(obj.status)) {
+      return false;
+    }
+    if ("language_code" in obj && "words" in obj) {
+      return false;
+    }
+    if ("metadata" in obj) {
+      const meta = obj.metadata;
+      if (meta && typeof meta === "object" && "model_info" in meta) {
+        return false;
+      }
+    }
+    if ("results" in obj && Array.isArray(obj.results)) {
+      return false;
+    }
+    if ("event" in obj) {
+      return false;
+    }
+    if ("transcript_id" in obj) {
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Parse Soniox webhook payload to unified format
+   *
+   * Returns notification-only data (id + status). No transcript text
+   * is included — Soniox webhooks are notification-only.
+   */
+  parse(payload, _options) {
+    if (!this.matches(payload)) {
+      return this.createErrorEvent(payload, "Invalid Soniox webhook payload");
+    }
+    const data = payload;
+    let eventType;
+    switch (data.status) {
+      case TranscriptionStatus.completed:
+        eventType = "transcription.completed";
+        break;
+      case TranscriptionStatus.error:
+        eventType = "transcription.failed";
+        break;
+      case TranscriptionStatus.processing:
+        eventType = "transcription.processing";
+        break;
+      default:
+        eventType = "transcription.created";
+    }
+    return {
+      success: data.status !== TranscriptionStatus.error,
+      provider: this.provider,
+      eventType,
+      data: {
+        id: data.id,
+        status: data.status === TranscriptionStatus.completed ? "completed" : data.status === TranscriptionStatus.error ? "error" : "processing",
+        error: data.error_message ?? void 0
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      raw: payload
+    };
+  }
+  /**
+   * Verify Soniox webhook signature
+   *
+   * Soniox uses custom auth headers on webhook delivery rather than
+   * HMAC signature verification. No server-side verification is available.
+   *
+   * @returns Always returns true
+   */
+  verify() {
+    return true;
+  }
+};
+function createSonioxWebhookHandler() {
+  return new SonioxWebhookHandler();
+}
+
 // src/webhooks/webhook-router.ts
 var WebhookRouter = class {
   constructor() {
@@ -1117,7 +1226,8 @@ var WebhookRouter = class {
       ["deepgram", new DeepgramWebhookHandler()],
       ["azure-stt", new AzureWebhookHandler()],
       ["speechmatics", new SpeechmaticsWebhookHandler()],
-      ["elevenlabs", new ElevenLabsWebhookHandler()]
+      ["elevenlabs", new ElevenLabsWebhookHandler()],
+      ["soniox", new SonioxWebhookHandler()]
     ]);
   }
   /**
@@ -1299,6 +1409,7 @@ function createWebhookRouter() {
   DeepgramWebhookHandler,
   ElevenLabsWebhookHandler,
   GladiaWebhookHandler,
+  SonioxWebhookHandler,
   SpeechmaticsWebhookHandler,
   WebhookRouter,
   createAssemblyAIWebhookHandler,
@@ -1306,6 +1417,7 @@ function createWebhookRouter() {
   createDeepgramWebhookHandler,
   createElevenLabsWebhookHandler,
   createGladiaWebhookHandler,
+  createSonioxWebhookHandler,
   createWebhookRouter
 });
 //# sourceMappingURL=webhooks.js.map

package/dist/webhooks.mjs

@@ -1060,6 +1060,113 @@ function createElevenLabsWebhookHandler() {
   return new ElevenLabsWebhookHandler();
 }
 
+// src/generated/soniox/schema/transcriptionStatus.ts
+var TranscriptionStatus = {
+  queued: "queued",
+  processing: "processing",
+  completed: "completed",
+  error: "error"
+};
+
+// src/webhooks/soniox-webhook.ts
+var SonioxWebhookHandler = class extends BaseWebhookHandler {
+  constructor() {
+    super(...arguments);
+    this.provider = "soniox";
+  }
+  /**
+   * Check if payload matches Soniox webhook format
+   *
+   * Soniox webhooks have a minimal `{ id, status }` shape.
+   * Excludes false positives by checking the payload does NOT have
+   * fields unique to other providers.
+   */
+  matches(payload, _options) {
+    if (!payload || typeof payload !== "object") {
+      return false;
+    }
+    const obj = payload;
+    if (typeof obj.id !== "string" || typeof obj.status !== "string") {
+      return false;
+    }
+    const validStatuses = Object.values(TranscriptionStatus);
+    if (!validStatuses.includes(obj.status)) {
+      return false;
+    }
+    if ("language_code" in obj && "words" in obj) {
+      return false;
+    }
+    if ("metadata" in obj) {
+      const meta = obj.metadata;
+      if (meta && typeof meta === "object" && "model_info" in meta) {
+        return false;
+      }
+    }
+    if ("results" in obj && Array.isArray(obj.results)) {
+      return false;
+    }
+    if ("event" in obj) {
+      return false;
+    }
+    if ("transcript_id" in obj) {
+      return false;
+    }
+    return true;
+  }
+  /**
+   * Parse Soniox webhook payload to unified format
+   *
+   * Returns notification-only data (id + status). No transcript text
+   * is included — Soniox webhooks are notification-only.
+   */
+  parse(payload, _options) {
+    if (!this.matches(payload)) {
+      return this.createErrorEvent(payload, "Invalid Soniox webhook payload");
+    }
+    const data = payload;
+    let eventType;
+    switch (data.status) {
+      case TranscriptionStatus.completed:
+        eventType = "transcription.completed";
+        break;
+      case TranscriptionStatus.error:
+        eventType = "transcription.failed";
+        break;
+      case TranscriptionStatus.processing:
+        eventType = "transcription.processing";
+        break;
+      default:
+        eventType = "transcription.created";
+    }
+    return {
+      success: data.status !== TranscriptionStatus.error,
+      provider: this.provider,
+      eventType,
+      data: {
+        id: data.id,
+        status: data.status === TranscriptionStatus.completed ? "completed" : data.status === TranscriptionStatus.error ? "error" : "processing",
+        error: data.error_message ?? void 0
+      },
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      raw: payload
+    };
+  }
+  /**
+   * Verify Soniox webhook signature
+   *
+   * Soniox uses custom auth headers on webhook delivery rather than
+   * HMAC signature verification. No server-side verification is available.
+   *
+   * @returns Always returns true
+   */
+  verify() {
+    return true;
+  }
+};
+function createSonioxWebhookHandler() {
+  return new SonioxWebhookHandler();
+}
+
 // src/webhooks/webhook-router.ts
 var WebhookRouter = class {
   constructor() {
@@ -1069,7 +1176,8 @@ var WebhookRouter = class {
       ["deepgram", new DeepgramWebhookHandler()],
       ["azure-stt", new AzureWebhookHandler()],
       ["speechmatics", new SpeechmaticsWebhookHandler()],
-      ["elevenlabs", new ElevenLabsWebhookHandler()]
+      ["elevenlabs", new ElevenLabsWebhookHandler()],
+      ["soniox", new SonioxWebhookHandler()]
     ]);
   }
   /**
@@ -1250,6 +1358,7 @@ export {
   DeepgramWebhookHandler,
   ElevenLabsWebhookHandler,
   GladiaWebhookHandler,
+  SonioxWebhookHandler,
   SpeechmaticsWebhookHandler,
   WebhookRouter,
   createAssemblyAIWebhookHandler,
@@ -1257,6 +1366,7 @@ export {
   createDeepgramWebhookHandler,
   createElevenLabsWebhookHandler,
   createGladiaWebhookHandler,
+  createSonioxWebhookHandler,
   createWebhookRouter
 };
 //# sourceMappingURL=webhooks.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "voice-router-dev",
-  "version": "0.8.8",
+  "version": "0.9.0",
   "description": "Universal speech-to-text router for Gladia, AssemblyAI, Deepgram, Azure, OpenAI Whisper, Speechmatics, Soniox, and ElevenLabs",
   "main": "dist/index.js",
   "module": "dist/index.mjs",