voice-router-dev 0.7.9 → 0.8.1

package/dist/webhooks.d.mts

@@ -1,5 +1,5 @@
-import { eC as TranscriptionStatus, ez as Speaker, eA as Word, eB as Utterance, Q as CallbackTranscriptionSuccessPayload, J as CallbackTranscriptionErrorPayload, cf as TranscriptWebhookNotification, d2 as ListenV1Response } from './transcriptWebhookNotification-DCcbnAKP.mjs';
-import { T as TranscriptionProvider } from './provider-metadata-DVQcYIHe.mjs';
+import { fo as TranscriptionStatus, fl as Speaker, fm as Word, fn as Utterance, Q as CallbackTranscriptionSuccessPayload, J as CallbackTranscriptionErrorPayload, cf as TranscriptWebhookNotification, d2 as ListenV1Response } from './transcriptWebhookNotification-CNFpns9f.mjs';
+import { T as TranscriptionProvider } from './provider-metadata-BnkedpXm.mjs';
 import './constants.mjs';
 
 /**
@@ -322,7 +322,7 @@ declare function createGladiaWebhookHandler(): GladiaWebhookHandler;
  *
  * AssemblyAI supports webhook signature verification using HMAC-SHA256.
  *
- * @example Basic usage
+ * @example Basic usage (full transcript body)
  * ```typescript
  * import { AssemblyAIWebhookHandler } from '@meeting-baas/sdk';
  *
@@ -334,10 +334,23 @@ declare function createGladiaWebhookHandler(): GladiaWebhookHandler;
  *   return res.status(400).json({ error: validation.error });
  * }
  *
- * // Parse webhook
+ * // Parse webhook — works with both notification and full transcript formats
  * const event = handler.parse(req.body);
  * if (event.eventType === 'transcription.completed') {
  *   console.log('Transcript ID:', event.data?.id);
+ *   console.log('Text:', event.data?.text);
+ *   console.log('Duration:', event.data?.duration);
+ *   console.log('Confidence:', event.data?.confidence);
+ *
+ *   // Word-level timestamps (seconds)
+ *   event.data?.words?.forEach(w => {
+ *     console.log(`${w.word}: ${w.start}s - ${w.end}s`);
+ *   });
+ *
+ *   // Speaker-segmented utterances
+ *   event.data?.utterances?.forEach(u => {
+ *     console.log(`Speaker ${u.speaker}: ${u.text}`);
+ *   });
  * }
  * ```
  *
@@ -359,17 +372,35 @@ declare class AssemblyAIWebhookHandler extends BaseWebhookHandler {
     readonly provider: TranscriptionProvider;
     /**
      * Check if payload matches AssemblyAI webhook format
+     *
+     * Supports two formats:
+     * - Notification format: `{ transcript_id, status }` (lightweight callback)
+     * - Full transcript format: `{ id, status, audio_url, text, words, ... }` (complete response)
      */
     matches(payload: unknown, _options?: {
         queryParams?: Record<string, string>;
         userAgent?: string;
     }): boolean;
+    /**
+     * Determine if the payload is a full transcript (vs a lightweight notification)
+     */
+    private isFullTranscript;
     /**
      * Parse AssemblyAI webhook payload to unified format
+     *
+     * Supports two payload formats:
+     * - Notification: `{ transcript_id, status }` — returns minimal event (ID + status only)
+     * - Full transcript: `{ id, status, text, words, utterances, ... }` — returns complete data
      */
     parse(payload: unknown, _options?: {
         queryParams?: Record<string, string>;
     }): UnifiedWebhookEvent;
+    /**
+     * Parse a full AssemblyAI transcript response into unified format
+     *
+     * AssemblyAI times are in milliseconds — converted to seconds for unified format.
+     */
+    private parseFullTranscript;
     /**
      * Verify AssemblyAI webhook signature
      *
@@ -656,6 +687,72 @@ declare class SpeechmaticsWebhookHandler extends BaseWebhookHandler {
     }): UnifiedWebhookEvent;
 }
 
+/**
+ * ElevenLabs webhook handler
+ * Parses and normalizes ElevenLabs webhook callbacks
+ */
+
+/**
+ * ElevenLabs webhook handler
+ *
+ * Handles webhook callbacks from ElevenLabs Speech-to-Text API.
+ * ElevenLabs sends the full transcription result to the webhook URL
+ * when transcription is complete. The payload includes the `SpeechToTextChunkResponseModel`
+ * with words, entities, and language detection.
+ *
+ * Note: ElevenLabs webhook signature verification uses the `webhook_id` and
+ * request signing. For security, use HTTPS and validate the request source.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { ElevenLabsWebhookHandler } from '@meeting-baas/sdk/webhooks';
+ *
+ * const handler = new ElevenLabsWebhookHandler();
+ *
+ * const validation = handler.validate(req.body);
+ * if (!validation.valid) {
+ *   return res.status(400).json({ error: validation.error });
+ * }
+ *
+ * const event = handler.parse(req.body);
+ * console.log('Event type:', event.eventType);
+ * console.log('Transcript:', event.data?.text);
+ * ```
+ */
+declare class ElevenLabsWebhookHandler extends BaseWebhookHandler {
+    readonly provider: TranscriptionProvider;
+    /**
+     * Check if payload matches ElevenLabs webhook format
+     *
+     * ElevenLabs webhook payloads contain the full transcription result
+     * with `words` array and `language_code` / `language_probability` fields.
+     */
+    matches(payload: unknown, _options?: {
+        queryParams?: Record<string, string>;
+        userAgent?: string;
+    }): boolean;
+    /**
+     * Parse ElevenLabs webhook payload to unified format
+     */
+    parse(payload: unknown, _options?: {
+        queryParams?: Record<string, string>;
+    }): UnifiedWebhookEvent;
+    /**
+     * Verify ElevenLabs webhook signature
+     *
+     * Note: ElevenLabs does not currently provide a standard webhook signature
+     * verification mechanism for STT webhooks. For security, use HTTPS and
+     * validate the request source.
+     *
+     * @returns Always returns true (no verification available)
+     */
+    verify(): boolean;
+}
+/**
+ * Factory function to create an ElevenLabs webhook handler
+ */
+declare function createElevenLabsWebhookHandler(): ElevenLabsWebhookHandler;
+
 /**
  * Webhook router with automatic provider detection
  * Routes webhook payloads to the correct provider handler
@@ -859,4 +956,4 @@ declare class WebhookRouter {
  */
 declare function createWebhookRouter(): WebhookRouter;
 
-export { AssemblyAIWebhookHandler, TranscriptWebhookNotification as AssemblyAIWebhookPayload, AzureWebhookHandler, BaseWebhookHandler, DeepgramWebhookHandler, ListenV1Response as DeepgramWebhookPayload, 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, createGladiaWebhookHandler, createWebhookRouter };
+export { AssemblyAIWebhookHandler, TranscriptWebhookNotification as 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 };

package/dist/webhooks.d.ts

@@ -1,5 +1,5 @@
-import { eC as TranscriptionStatus, ez as Speaker, eA as Word, eB as Utterance, Q as CallbackTranscriptionSuccessPayload, J as CallbackTranscriptionErrorPayload, cf as TranscriptWebhookNotification, d2 as ListenV1Response } from './transcriptWebhookNotification-BTxv69ck.js';
-import { T as TranscriptionProvider } from './provider-metadata-Derls1wa.js';
+import { fo as TranscriptionStatus, fl as Speaker, fm as Word, fn as Utterance, Q as CallbackTranscriptionSuccessPayload, J as CallbackTranscriptionErrorPayload, cf as TranscriptWebhookNotification, d2 as ListenV1Response } from './transcriptWebhookNotification-BJk1CEF5.js';
+import { T as TranscriptionProvider } from './provider-metadata-DbsSGAO7.js';
 import './constants.js';
 
 /**
@@ -322,7 +322,7 @@ declare function createGladiaWebhookHandler(): GladiaWebhookHandler;
  *
  * AssemblyAI supports webhook signature verification using HMAC-SHA256.
  *
- * @example Basic usage
+ * @example Basic usage (full transcript body)
  * ```typescript
  * import { AssemblyAIWebhookHandler } from '@meeting-baas/sdk';
  *
@@ -334,10 +334,23 @@ declare function createGladiaWebhookHandler(): GladiaWebhookHandler;
  *   return res.status(400).json({ error: validation.error });
  * }
  *
- * // Parse webhook
+ * // Parse webhook — works with both notification and full transcript formats
  * const event = handler.parse(req.body);
  * if (event.eventType === 'transcription.completed') {
  *   console.log('Transcript ID:', event.data?.id);
+ *   console.log('Text:', event.data?.text);
+ *   console.log('Duration:', event.data?.duration);
+ *   console.log('Confidence:', event.data?.confidence);
+ *
+ *   // Word-level timestamps (seconds)
+ *   event.data?.words?.forEach(w => {
+ *     console.log(`${w.word}: ${w.start}s - ${w.end}s`);
+ *   });
+ *
+ *   // Speaker-segmented utterances
+ *   event.data?.utterances?.forEach(u => {
+ *     console.log(`Speaker ${u.speaker}: ${u.text}`);
+ *   });
  * }
  * ```
  *
@@ -359,17 +372,35 @@ declare class AssemblyAIWebhookHandler extends BaseWebhookHandler {
     readonly provider: TranscriptionProvider;
     /**
      * Check if payload matches AssemblyAI webhook format
+     *
+     * Supports two formats:
+     * - Notification format: `{ transcript_id, status }` (lightweight callback)
+     * - Full transcript format: `{ id, status, audio_url, text, words, ... }` (complete response)
      */
     matches(payload: unknown, _options?: {
         queryParams?: Record<string, string>;
         userAgent?: string;
     }): boolean;
+    /**
+     * Determine if the payload is a full transcript (vs a lightweight notification)
+     */
+    private isFullTranscript;
     /**
      * Parse AssemblyAI webhook payload to unified format
+     *
+     * Supports two payload formats:
+     * - Notification: `{ transcript_id, status }` — returns minimal event (ID + status only)
+     * - Full transcript: `{ id, status, text, words, utterances, ... }` — returns complete data
      */
     parse(payload: unknown, _options?: {
         queryParams?: Record<string, string>;
     }): UnifiedWebhookEvent;
+    /**
+     * Parse a full AssemblyAI transcript response into unified format
+     *
+     * AssemblyAI times are in milliseconds — converted to seconds for unified format.
+     */
+    private parseFullTranscript;
     /**
      * Verify AssemblyAI webhook signature
      *
@@ -656,6 +687,72 @@ declare class SpeechmaticsWebhookHandler extends BaseWebhookHandler {
     }): UnifiedWebhookEvent;
 }
 
+/**
+ * ElevenLabs webhook handler
+ * Parses and normalizes ElevenLabs webhook callbacks
+ */
+
+/**
+ * ElevenLabs webhook handler
+ *
+ * Handles webhook callbacks from ElevenLabs Speech-to-Text API.
+ * ElevenLabs sends the full transcription result to the webhook URL
+ * when transcription is complete. The payload includes the `SpeechToTextChunkResponseModel`
+ * with words, entities, and language detection.
+ *
+ * Note: ElevenLabs webhook signature verification uses the `webhook_id` and
+ * request signing. For security, use HTTPS and validate the request source.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { ElevenLabsWebhookHandler } from '@meeting-baas/sdk/webhooks';
+ *
+ * const handler = new ElevenLabsWebhookHandler();
+ *
+ * const validation = handler.validate(req.body);
+ * if (!validation.valid) {
+ *   return res.status(400).json({ error: validation.error });
+ * }
+ *
+ * const event = handler.parse(req.body);
+ * console.log('Event type:', event.eventType);
+ * console.log('Transcript:', event.data?.text);
+ * ```
+ */
+declare class ElevenLabsWebhookHandler extends BaseWebhookHandler {
+    readonly provider: TranscriptionProvider;
+    /**
+     * Check if payload matches ElevenLabs webhook format
+     *
+     * ElevenLabs webhook payloads contain the full transcription result
+     * with `words` array and `language_code` / `language_probability` fields.
+     */
+    matches(payload: unknown, _options?: {
+        queryParams?: Record<string, string>;
+        userAgent?: string;
+    }): boolean;
+    /**
+     * Parse ElevenLabs webhook payload to unified format
+     */
+    parse(payload: unknown, _options?: {
+        queryParams?: Record<string, string>;
+    }): UnifiedWebhookEvent;
+    /**
+     * Verify ElevenLabs webhook signature
+     *
+     * Note: ElevenLabs does not currently provide a standard webhook signature
+     * verification mechanism for STT webhooks. For security, use HTTPS and
+     * validate the request source.
+     *
+     * @returns Always returns true (no verification available)
+     */
+    verify(): boolean;
+}
+/**
+ * Factory function to create an ElevenLabs webhook handler
+ */
+declare function createElevenLabsWebhookHandler(): ElevenLabsWebhookHandler;
+
 /**
  * Webhook router with automatic provider detection
  * Routes webhook payloads to the correct provider handler
@@ -859,4 +956,4 @@ declare class WebhookRouter {
  */
 declare function createWebhookRouter(): WebhookRouter;
 
-export { AssemblyAIWebhookHandler, TranscriptWebhookNotification as AssemblyAIWebhookPayload, AzureWebhookHandler, BaseWebhookHandler, DeepgramWebhookHandler, ListenV1Response as DeepgramWebhookPayload, 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, createGladiaWebhookHandler, createWebhookRouter };
+export { AssemblyAIWebhookHandler, TranscriptWebhookNotification as 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 };