@jambonz/sdk 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/client/index.cjs +60 -13
- package/dist/client/index.cjs.map +1 -1
- package/dist/client/index.d.cts +36 -7
- package/dist/client/index.d.ts +36 -7
- package/dist/client/index.js +59 -13
- package/dist/client/index.js.map +1 -1
- package/dist/common-BWUBZtju.d.cts +30 -0
- package/dist/common-BWUBZtju.d.ts +30 -0
- package/dist/index.cjs +364 -32
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +8 -7
- package/dist/index.d.ts +8 -7
- package/dist/index.js +360 -32
- package/dist/index.js.map +1 -1
- package/dist/rest-BF9HKZrA.d.ts +136 -0
- package/dist/rest-v8weIueZ.d.cts +136 -0
- package/dist/session-DHc6G_9y.d.cts +112 -0
- package/dist/session-DHc6G_9y.d.ts +112 -0
- package/dist/types/index.d.cts +4 -3
- package/dist/types/index.d.ts +4 -3
- package/dist/{verb-builder-But-DJle.d.cts → verb-builder-Dg_IPC4I.d.ts} +35 -2
- package/dist/{verb-builder-CO_qoYxC.d.ts → verb-builder-DkHAJrk4.d.cts} +35 -2
- package/dist/{verbs-B_afNNUM.d.cts → verbs-fjJjfGEt.d.cts} +40 -14
- package/dist/{verbs-B_afNNUM.d.ts → verbs-fjJjfGEt.d.ts} +40 -14
- package/dist/webhook/index.cjs +68 -8
- package/dist/webhook/index.cjs.map +1 -1
- package/dist/webhook/index.d.cts +45 -3
- package/dist/webhook/index.d.ts +45 -3
- package/dist/webhook/index.js +68 -9
- package/dist/webhook/index.js.map +1 -1
- package/dist/websocket/index.cjs +291 -19
- package/dist/websocket/index.cjs.map +1 -1
- package/dist/websocket/index.d.cts +198 -4
- package/dist/websocket/index.d.ts +198 -4
- package/dist/websocket/index.js +290 -20
- package/dist/websocket/index.js.map +1 -1
- package/package.json +19 -6
- package/schema/callbacks/base.schema.json +29 -0
- package/schema/callbacks/call-status.schema.json +22 -0
- package/schema/callbacks/conference-status.schema.json +24 -0
- package/schema/callbacks/conference-wait.schema.json +11 -0
- package/schema/callbacks/conference.schema.json +11 -0
- package/schema/callbacks/dequeue.schema.json +19 -0
- package/schema/callbacks/dial-dtmf.schema.json +18 -0
- package/schema/callbacks/dial-hold.schema.json +22 -0
- package/schema/callbacks/dial-refer.schema.json +28 -0
- package/schema/callbacks/dial.schema.json +31 -0
- package/schema/callbacks/enqueue-wait.schema.json +17 -0
- package/schema/callbacks/enqueue.schema.json +27 -0
- package/schema/callbacks/gather-partial.schema.json +54 -0
- package/schema/callbacks/gather.schema.json +60 -0
- package/schema/callbacks/listen.schema.json +21 -0
- package/schema/callbacks/llm.schema.json +30 -0
- package/schema/callbacks/message.schema.json +35 -0
- package/schema/callbacks/play.schema.json +36 -0
- package/schema/callbacks/session-new.schema.json +143 -0
- package/schema/callbacks/session-reconnect.schema.json +9 -0
- package/schema/callbacks/session-redirect.schema.json +38 -0
- package/schema/callbacks/sip-refer-event.schema.json +20 -0
- package/schema/callbacks/sip-refer.schema.json +22 -0
- package/schema/callbacks/sip-request.schema.json +27 -0
- package/schema/callbacks/transcribe-translation.schema.json +24 -0
- package/schema/callbacks/transcribe.schema.json +46 -0
- package/schema/callbacks/verb-status.schema.json +57 -0
- package/schema/components/actionHook.schema.json +36 -0
- package/schema/components/actionHookDelayAction.schema.json +37 -0
- package/schema/components/amd.schema.json +68 -0
- package/schema/components/auth.schema.json +18 -0
- package/schema/components/bidirectionalAudio.schema.json +22 -0
- package/schema/components/fillerNoise.schema.json +25 -0
- package/schema/components/recognizer-assemblyAiOptions.schema.json +35 -0
- package/schema/components/recognizer-awsOptions.schema.json +52 -0
- package/schema/components/recognizer-azureOptions.schema.json +32 -0
- package/schema/components/recognizer-cobaltOptions.schema.json +34 -0
- package/schema/components/recognizer-customOptions.schema.json +27 -0
- package/schema/components/recognizer-deepgramOptions.schema.json +147 -0
- package/schema/components/recognizer-elevenlabsOptions.schema.json +39 -0
- package/schema/components/recognizer-gladiaOptions.schema.json +8 -0
- package/schema/components/recognizer-googleOptions.schema.json +35 -0
- package/schema/components/recognizer-houndifyOptions.schema.json +53 -0
- package/schema/components/recognizer-ibmOptions.schema.json +54 -0
- package/schema/components/recognizer-nuanceOptions.schema.json +150 -0
- package/schema/components/recognizer-nvidiaOptions.schema.json +39 -0
- package/schema/components/recognizer-openaiOptions.schema.json +59 -0
- package/schema/components/recognizer-sonioxOptions.schema.json +46 -0
- package/schema/components/recognizer-speechmaticsOptions.schema.json +91 -0
- package/schema/components/recognizer-verbioOptions.schema.json +46 -0
- package/schema/components/recognizer.schema.json +212 -0
- package/schema/components/synthesizer.schema.json +82 -0
- package/schema/components/target.schema.json +105 -0
- package/schema/components/vad.schema.json +48 -0
- package/schema/jambonz-app.schema.json +106 -0
- package/schema/verbs/alert.schema.json +20 -0
- package/schema/verbs/answer.schema.json +12 -0
- package/schema/verbs/conference.schema.json +43 -0
- package/schema/verbs/config.schema.json +170 -0
- package/schema/verbs/dequeue.schema.json +36 -0
- package/schema/verbs/dial.schema.json +153 -0
- package/schema/verbs/dtmf.schema.json +27 -0
- package/schema/verbs/dub.schema.json +52 -0
- package/schema/verbs/enqueue.schema.json +38 -0
- package/schema/verbs/gather.schema.json +145 -0
- package/schema/verbs/hangup.schema.json +29 -0
- package/schema/verbs/leave.schema.json +12 -0
- package/schema/verbs/listen.schema.json +109 -0
- package/schema/verbs/llm.schema.json +131 -0
- package/schema/verbs/message.schema.json +30 -0
- package/schema/verbs/pause.schema.json +26 -0
- package/schema/verbs/pipeline.schema.json +61 -0
- package/schema/verbs/play.schema.json +69 -0
- package/schema/verbs/redirect.schema.json +23 -0
- package/schema/verbs/say.schema.json +84 -0
- package/schema/verbs/sip-decline.schema.json +31 -0
- package/schema/verbs/sip-refer.schema.json +41 -0
- package/schema/verbs/sip-request.schema.json +33 -0
- package/schema/verbs/stream.schema.json +30 -0
- package/schema/verbs/tag.schema.json +21 -0
- package/schema/verbs/transcribe.schema.json +48 -0
- package/dist/common-Bsqv1Brz.d.cts +0 -69
- package/dist/common-Bsqv1Brz.d.ts +0 -69
- package/dist/rest-BV_FsqnH.d.cts +0 -97
- package/dist/rest-CthGXHnw.d.ts +0 -97
|
@@ -224,6 +224,30 @@ interface ActionHookDelayAction {
|
|
|
224
224
|
/** Verbs to execute if webhook never responds. */
|
|
225
225
|
giveUpActions?: Record<string, unknown>[];
|
|
226
226
|
}
|
|
227
|
+
/** Answering machine detection timer settings. */
|
|
228
|
+
interface AmdTimers {
|
|
229
|
+
/** Milliseconds to wait for any speech before returning amd_no_speech_detected. Default: 5000. */
|
|
230
|
+
noSpeechTimeoutMs?: number;
|
|
231
|
+
/** Milliseconds before returning amd_decision_timeout. Default: 15000. */
|
|
232
|
+
decisionTimeoutMs?: number;
|
|
233
|
+
/** Milliseconds to wait for beep/tone detection. Default: 20000. */
|
|
234
|
+
toneTimeoutMs?: number;
|
|
235
|
+
/** Milliseconds of silence after speech before greeting is considered complete. Default: 2000. */
|
|
236
|
+
greetingCompletionTimeoutMs?: number;
|
|
237
|
+
}
|
|
238
|
+
/** Answering machine detection configuration. */
|
|
239
|
+
interface Amd {
|
|
240
|
+
/** Webhook to receive AMD events. */
|
|
241
|
+
actionHook: ActionHook;
|
|
242
|
+
/** Spoken word count that triggers machine detection. Default: 9. */
|
|
243
|
+
thresholdWordCount?: number;
|
|
244
|
+
/** Digit count in greeting to trigger detection. 0 disables. Default: 0. */
|
|
245
|
+
digitCount?: number;
|
|
246
|
+
/** Timer settings for detection windows. */
|
|
247
|
+
timers?: AmdTimers;
|
|
248
|
+
/** Override STT recognizer for AMD. Uses session default with enhancedModel if omitted. */
|
|
249
|
+
recognizer?: Recognizer;
|
|
250
|
+
}
|
|
227
251
|
|
|
228
252
|
/**
|
|
229
253
|
* Verb types for all 26 jambonz verbs.
|
|
@@ -395,7 +419,7 @@ interface ListenVerb {
|
|
|
395
419
|
/** Inactivity timeout in seconds. */
|
|
396
420
|
timeout?: number;
|
|
397
421
|
/** Simultaneous transcription config. */
|
|
398
|
-
transcribe?:
|
|
422
|
+
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
399
423
|
/** Stream before call is answered. */
|
|
400
424
|
earlyMedia?: boolean;
|
|
401
425
|
/** Specific audio channel to stream. */
|
|
@@ -431,13 +455,15 @@ interface StreamVerb {
|
|
|
431
455
|
/** Inactivity timeout in seconds. */
|
|
432
456
|
timeout?: number;
|
|
433
457
|
/** Simultaneous transcription config. */
|
|
434
|
-
transcribe?:
|
|
458
|
+
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
435
459
|
/** Stream before call is answered. */
|
|
436
460
|
earlyMedia?: boolean;
|
|
437
461
|
}
|
|
438
462
|
interface TranscribeVerb {
|
|
439
463
|
verb: 'transcribe';
|
|
440
464
|
id?: string;
|
|
465
|
+
/** Enable or disable transcription (used in nested config/dial context). */
|
|
466
|
+
enable?: boolean;
|
|
441
467
|
/** Webhook for transcription results. */
|
|
442
468
|
transcriptionHook?: string;
|
|
443
469
|
/** Webhook for translated results. */
|
|
@@ -483,11 +509,11 @@ interface DialVerb {
|
|
|
483
509
|
/** Audio signal boost/attenuation in dB. */
|
|
484
510
|
boostAudioSignal?: number | string;
|
|
485
511
|
/** Audio streaming config for bridged call. */
|
|
486
|
-
listen?:
|
|
512
|
+
listen?: Omit<ListenVerb, 'verb'>;
|
|
487
513
|
/** Audio streaming config (alias for listen). */
|
|
488
|
-
stream?:
|
|
514
|
+
stream?: Omit<StreamVerb, 'verb'>;
|
|
489
515
|
/** Transcription config for bridged call. */
|
|
490
|
-
transcribe?:
|
|
516
|
+
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
491
517
|
/** Max bridged call duration in seconds. */
|
|
492
518
|
timeLimit?: number;
|
|
493
519
|
/** Seconds to wait for answer. */
|
|
@@ -495,9 +521,9 @@ interface DialVerb {
|
|
|
495
521
|
/** SIP proxy for outbound call. */
|
|
496
522
|
proxy?: string;
|
|
497
523
|
/** Answering machine detection config. */
|
|
498
|
-
amd?:
|
|
524
|
+
amd?: Amd;
|
|
499
525
|
/** Audio dubbing tracks. */
|
|
500
|
-
dub?:
|
|
526
|
+
dub?: Omit<DubVerb, 'verb'>[];
|
|
501
527
|
/** Metadata for this call leg. */
|
|
502
528
|
tag?: Record<string, unknown>;
|
|
503
529
|
/** Forward P-Asserted-Identity header. */
|
|
@@ -537,7 +563,7 @@ interface ConferenceVerb {
|
|
|
537
563
|
/** Conference recording config. */
|
|
538
564
|
record?: Record<string, unknown>;
|
|
539
565
|
/** Audio streaming config. */
|
|
540
|
-
listen?:
|
|
566
|
+
listen?: Omit<ListenVerb, 'verb'>;
|
|
541
567
|
/** Distribute DTMF to all participants. */
|
|
542
568
|
distributeDtmf?: boolean;
|
|
543
569
|
}
|
|
@@ -652,13 +678,13 @@ interface ConfigVerb {
|
|
|
652
678
|
/** Session-level recording config. */
|
|
653
679
|
record?: Record<string, unknown>;
|
|
654
680
|
/** Session-level audio streaming config. */
|
|
655
|
-
listen?:
|
|
681
|
+
listen?: Omit<ListenVerb, 'verb'>;
|
|
656
682
|
/** Session-level audio streaming (alias). */
|
|
657
|
-
stream?:
|
|
683
|
+
stream?: Omit<StreamVerb, 'verb'>;
|
|
658
684
|
/** Session-level transcription config. */
|
|
659
|
-
transcribe?:
|
|
685
|
+
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
660
686
|
/** Answering machine detection config. */
|
|
661
|
-
amd?:
|
|
687
|
+
amd?: Amd;
|
|
662
688
|
/** Default filler noise config. */
|
|
663
689
|
fillerNoise?: FillerNoise;
|
|
664
690
|
/** Default VAD config. */
|
|
@@ -734,7 +760,7 @@ interface DubVerb {
|
|
|
734
760
|
/** Audio URL for playOnTrack. */
|
|
735
761
|
play?: string;
|
|
736
762
|
/** Text or config for sayOnTrack. */
|
|
737
|
-
say?: string |
|
|
763
|
+
say?: string | Omit<SayVerb, 'verb'>;
|
|
738
764
|
/** Loop audio continuously. */
|
|
739
765
|
loop?: boolean;
|
|
740
766
|
/** Track gain in dB. */
|
|
@@ -767,4 +793,4 @@ type JambonzApp = Verb[];
|
|
|
767
793
|
/** All valid verb names. */
|
|
768
794
|
type VerbName = Verb['verb'];
|
|
769
795
|
|
|
770
|
-
export type { ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, HangupVerb as H, JambonzApp as J, LeaveVerb as L, McpServerConfig as M, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b, AlertVerb as c,
|
|
796
|
+
export type { ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, HangupVerb as H, JambonzApp as J, LeaveVerb as L, McpServerConfig as M, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b, AlertVerb as c, Amd as d, AmdTimers as e, AnswerVerb as f, Auth as g, ConfigVerb as h, DialVerb as i, DtmfVerb as j, DubVerb as k, ListenVerb as l, LlmVerb as m, MessageVerb as n, PipelineVerb as o, PlayVerb as p, RedirectVerb as q, SipDeclineVerb as r, SipReferVerb as s, SipRequestVerb as t, StreamVerb as u, Synthesizer as v, Target as w, TranscribeVerb as x, Verb as y, VerbName as z };
|
|
@@ -224,6 +224,30 @@ interface ActionHookDelayAction {
|
|
|
224
224
|
/** Verbs to execute if webhook never responds. */
|
|
225
225
|
giveUpActions?: Record<string, unknown>[];
|
|
226
226
|
}
|
|
227
|
+
/** Answering machine detection timer settings. */
|
|
228
|
+
interface AmdTimers {
|
|
229
|
+
/** Milliseconds to wait for any speech before returning amd_no_speech_detected. Default: 5000. */
|
|
230
|
+
noSpeechTimeoutMs?: number;
|
|
231
|
+
/** Milliseconds before returning amd_decision_timeout. Default: 15000. */
|
|
232
|
+
decisionTimeoutMs?: number;
|
|
233
|
+
/** Milliseconds to wait for beep/tone detection. Default: 20000. */
|
|
234
|
+
toneTimeoutMs?: number;
|
|
235
|
+
/** Milliseconds of silence after speech before greeting is considered complete. Default: 2000. */
|
|
236
|
+
greetingCompletionTimeoutMs?: number;
|
|
237
|
+
}
|
|
238
|
+
/** Answering machine detection configuration. */
|
|
239
|
+
interface Amd {
|
|
240
|
+
/** Webhook to receive AMD events. */
|
|
241
|
+
actionHook: ActionHook;
|
|
242
|
+
/** Spoken word count that triggers machine detection. Default: 9. */
|
|
243
|
+
thresholdWordCount?: number;
|
|
244
|
+
/** Digit count in greeting to trigger detection. 0 disables. Default: 0. */
|
|
245
|
+
digitCount?: number;
|
|
246
|
+
/** Timer settings for detection windows. */
|
|
247
|
+
timers?: AmdTimers;
|
|
248
|
+
/** Override STT recognizer for AMD. Uses session default with enhancedModel if omitted. */
|
|
249
|
+
recognizer?: Recognizer;
|
|
250
|
+
}
|
|
227
251
|
|
|
228
252
|
/**
|
|
229
253
|
* Verb types for all 26 jambonz verbs.
|
|
@@ -395,7 +419,7 @@ interface ListenVerb {
|
|
|
395
419
|
/** Inactivity timeout in seconds. */
|
|
396
420
|
timeout?: number;
|
|
397
421
|
/** Simultaneous transcription config. */
|
|
398
|
-
transcribe?:
|
|
422
|
+
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
399
423
|
/** Stream before call is answered. */
|
|
400
424
|
earlyMedia?: boolean;
|
|
401
425
|
/** Specific audio channel to stream. */
|
|
@@ -431,13 +455,15 @@ interface StreamVerb {
|
|
|
431
455
|
/** Inactivity timeout in seconds. */
|
|
432
456
|
timeout?: number;
|
|
433
457
|
/** Simultaneous transcription config. */
|
|
434
|
-
transcribe?:
|
|
458
|
+
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
435
459
|
/** Stream before call is answered. */
|
|
436
460
|
earlyMedia?: boolean;
|
|
437
461
|
}
|
|
438
462
|
interface TranscribeVerb {
|
|
439
463
|
verb: 'transcribe';
|
|
440
464
|
id?: string;
|
|
465
|
+
/** Enable or disable transcription (used in nested config/dial context). */
|
|
466
|
+
enable?: boolean;
|
|
441
467
|
/** Webhook for transcription results. */
|
|
442
468
|
transcriptionHook?: string;
|
|
443
469
|
/** Webhook for translated results. */
|
|
@@ -483,11 +509,11 @@ interface DialVerb {
|
|
|
483
509
|
/** Audio signal boost/attenuation in dB. */
|
|
484
510
|
boostAudioSignal?: number | string;
|
|
485
511
|
/** Audio streaming config for bridged call. */
|
|
486
|
-
listen?:
|
|
512
|
+
listen?: Omit<ListenVerb, 'verb'>;
|
|
487
513
|
/** Audio streaming config (alias for listen). */
|
|
488
|
-
stream?:
|
|
514
|
+
stream?: Omit<StreamVerb, 'verb'>;
|
|
489
515
|
/** Transcription config for bridged call. */
|
|
490
|
-
transcribe?:
|
|
516
|
+
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
491
517
|
/** Max bridged call duration in seconds. */
|
|
492
518
|
timeLimit?: number;
|
|
493
519
|
/** Seconds to wait for answer. */
|
|
@@ -495,9 +521,9 @@ interface DialVerb {
|
|
|
495
521
|
/** SIP proxy for outbound call. */
|
|
496
522
|
proxy?: string;
|
|
497
523
|
/** Answering machine detection config. */
|
|
498
|
-
amd?:
|
|
524
|
+
amd?: Amd;
|
|
499
525
|
/** Audio dubbing tracks. */
|
|
500
|
-
dub?:
|
|
526
|
+
dub?: Omit<DubVerb, 'verb'>[];
|
|
501
527
|
/** Metadata for this call leg. */
|
|
502
528
|
tag?: Record<string, unknown>;
|
|
503
529
|
/** Forward P-Asserted-Identity header. */
|
|
@@ -537,7 +563,7 @@ interface ConferenceVerb {
|
|
|
537
563
|
/** Conference recording config. */
|
|
538
564
|
record?: Record<string, unknown>;
|
|
539
565
|
/** Audio streaming config. */
|
|
540
|
-
listen?:
|
|
566
|
+
listen?: Omit<ListenVerb, 'verb'>;
|
|
541
567
|
/** Distribute DTMF to all participants. */
|
|
542
568
|
distributeDtmf?: boolean;
|
|
543
569
|
}
|
|
@@ -652,13 +678,13 @@ interface ConfigVerb {
|
|
|
652
678
|
/** Session-level recording config. */
|
|
653
679
|
record?: Record<string, unknown>;
|
|
654
680
|
/** Session-level audio streaming config. */
|
|
655
|
-
listen?:
|
|
681
|
+
listen?: Omit<ListenVerb, 'verb'>;
|
|
656
682
|
/** Session-level audio streaming (alias). */
|
|
657
|
-
stream?:
|
|
683
|
+
stream?: Omit<StreamVerb, 'verb'>;
|
|
658
684
|
/** Session-level transcription config. */
|
|
659
|
-
transcribe?:
|
|
685
|
+
transcribe?: Omit<TranscribeVerb, 'verb'>;
|
|
660
686
|
/** Answering machine detection config. */
|
|
661
|
-
amd?:
|
|
687
|
+
amd?: Amd;
|
|
662
688
|
/** Default filler noise config. */
|
|
663
689
|
fillerNoise?: FillerNoise;
|
|
664
690
|
/** Default VAD config. */
|
|
@@ -734,7 +760,7 @@ interface DubVerb {
|
|
|
734
760
|
/** Audio URL for playOnTrack. */
|
|
735
761
|
play?: string;
|
|
736
762
|
/** Text or config for sayOnTrack. */
|
|
737
|
-
say?: string |
|
|
763
|
+
say?: string | Omit<SayVerb, 'verb'>;
|
|
738
764
|
/** Loop audio continuously. */
|
|
739
765
|
loop?: boolean;
|
|
740
766
|
/** Track gain in dB. */
|
|
@@ -767,4 +793,4 @@ type JambonzApp = Verb[];
|
|
|
767
793
|
/** All valid verb names. */
|
|
768
794
|
type VerbName = Verb['verb'];
|
|
769
795
|
|
|
770
|
-
export type { ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, HangupVerb as H, JambonzApp as J, LeaveVerb as L, McpServerConfig as M, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b, AlertVerb as c,
|
|
796
|
+
export type { ActionHook as A, BidirectionalAudio as B, ConferenceVerb as C, DequeueVerb as D, EnqueueVerb as E, FillerNoise as F, GatherVerb as G, HangupVerb as H, JambonzApp as J, LeaveVerb as L, McpServerConfig as M, PauseVerb as P, Recognizer as R, SayVerb as S, TagVerb as T, Vad as V, ActionHookDelayAction as a, ActionHookObject as b, AlertVerb as c, Amd as d, AmdTimers as e, AnswerVerb as f, Auth as g, ConfigVerb as h, DialVerb as i, DtmfVerb as j, DubVerb as k, ListenVerb as l, LlmVerb as m, MessageVerb as n, PipelineVerb as o, PlayVerb as p, RedirectVerb as q, SipDeclineVerb as r, SipReferVerb as s, SipRequestVerb as t, StreamVerb as u, Synthesizer as v, Target as w, TranscribeVerb as x, Verb as y, VerbName as z };
|
package/dist/webhook/index.cjs
CHANGED
|
@@ -15,13 +15,31 @@ var Ajv__default = /*#__PURE__*/_interopDefault(Ajv);
|
|
|
15
15
|
var COMPONENT_SCHEMAS = [
|
|
16
16
|
"auth",
|
|
17
17
|
"actionHook",
|
|
18
|
-
"
|
|
19
|
-
"
|
|
20
|
-
"target",
|
|
21
|
-
"vad",
|
|
18
|
+
"actionHookDelayAction",
|
|
19
|
+
"amd",
|
|
22
20
|
"bidirectionalAudio",
|
|
23
21
|
"fillerNoise",
|
|
24
|
-
"
|
|
22
|
+
"recognizer",
|
|
23
|
+
"recognizer-assemblyAiOptions",
|
|
24
|
+
"recognizer-awsOptions",
|
|
25
|
+
"recognizer-azureOptions",
|
|
26
|
+
"recognizer-cobaltOptions",
|
|
27
|
+
"recognizer-customOptions",
|
|
28
|
+
"recognizer-deepgramOptions",
|
|
29
|
+
"recognizer-elevenlabsOptions",
|
|
30
|
+
"recognizer-gladiaOptions",
|
|
31
|
+
"recognizer-googleOptions",
|
|
32
|
+
"recognizer-houndifyOptions",
|
|
33
|
+
"recognizer-ibmOptions",
|
|
34
|
+
"recognizer-nuanceOptions",
|
|
35
|
+
"recognizer-nvidiaOptions",
|
|
36
|
+
"recognizer-openaiOptions",
|
|
37
|
+
"recognizer-sonioxOptions",
|
|
38
|
+
"recognizer-speechmaticsOptions",
|
|
39
|
+
"recognizer-verbioOptions",
|
|
40
|
+
"synthesizer",
|
|
41
|
+
"target",
|
|
42
|
+
"vad"
|
|
25
43
|
];
|
|
26
44
|
var VERB_SCHEMAS = [
|
|
27
45
|
"answer",
|
|
@@ -59,9 +77,9 @@ function findSchemaDir() {
|
|
|
59
77
|
const currentDir = typeof __dirname !== "undefined" ? __dirname : path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
|
|
60
78
|
const candidates = [
|
|
61
79
|
path.resolve(currentDir, "../../schema"),
|
|
62
|
-
// from src/
|
|
63
|
-
path.resolve(currentDir, "
|
|
64
|
-
// from dist/
|
|
80
|
+
// from typescript/src/
|
|
81
|
+
path.resolve(currentDir, "../schema")
|
|
82
|
+
// from dist/ (tsup bundles to package-root/dist/)
|
|
65
83
|
];
|
|
66
84
|
for (const candidate of candidates) {
|
|
67
85
|
try {
|
|
@@ -124,6 +142,9 @@ function formatErrors(errors) {
|
|
|
124
142
|
var VerbBuilder = class {
|
|
125
143
|
verbs = [];
|
|
126
144
|
validator;
|
|
145
|
+
/**
|
|
146
|
+
* @param opts - Options for validation and schema directory.
|
|
147
|
+
*/
|
|
127
148
|
constructor(opts) {
|
|
128
149
|
if (opts?.validate === false) {
|
|
129
150
|
this.validator = null;
|
|
@@ -132,85 +153,111 @@ var VerbBuilder = class {
|
|
|
132
153
|
}
|
|
133
154
|
}
|
|
134
155
|
// --- Audio & Speech ---
|
|
156
|
+
/** Speak text using TTS. Supports SSML, multiple voices, and streaming. */
|
|
135
157
|
say(opts) {
|
|
136
158
|
return this.addVerb({ verb: "say", ...opts });
|
|
137
159
|
}
|
|
160
|
+
/** Play an audio file from a URL. */
|
|
138
161
|
play(opts) {
|
|
139
162
|
return this.addVerb({ verb: "play", ...opts });
|
|
140
163
|
}
|
|
164
|
+
/** Collect speech (STT) and/or DTMF input from the caller. */
|
|
141
165
|
gather(opts) {
|
|
142
166
|
return this.addVerb({ verb: "gather", ...opts });
|
|
143
167
|
}
|
|
144
168
|
// --- AI & Real-time ---
|
|
169
|
+
/** Connect the caller to an LLM for real-time voice conversation. */
|
|
145
170
|
llm(opts) {
|
|
146
171
|
return this.addVerb({ verb: "llm", ...opts });
|
|
147
172
|
}
|
|
173
|
+
/** Voice AI pipeline with integrated turn detection. */
|
|
148
174
|
pipeline(opts) {
|
|
149
175
|
return this.addVerb({ verb: "pipeline", ...opts });
|
|
150
176
|
}
|
|
177
|
+
/** Stream real-time call audio to a WebSocket endpoint. Supports bidirectional audio. */
|
|
151
178
|
listen(opts) {
|
|
152
179
|
return this.addVerb({ verb: "listen", ...opts });
|
|
153
180
|
}
|
|
181
|
+
/** Stream real-time call audio to a WebSocket endpoint. Synonym for {@link listen}. */
|
|
154
182
|
stream(opts) {
|
|
155
183
|
return this.addVerb({ verb: "stream", ...opts });
|
|
156
184
|
}
|
|
185
|
+
/** Real-time call transcription sent to a webhook. */
|
|
157
186
|
transcribe(opts) {
|
|
158
187
|
return this.addVerb({ verb: "transcribe", ...opts });
|
|
159
188
|
}
|
|
160
189
|
// --- Call Control ---
|
|
190
|
+
/** Place an outbound call and bridge it to the current caller. */
|
|
161
191
|
dial(opts) {
|
|
162
192
|
return this.addVerb({ verb: "dial", ...opts });
|
|
163
193
|
}
|
|
194
|
+
/** Join or create a multi-party conference room. */
|
|
164
195
|
conference(opts) {
|
|
165
196
|
return this.addVerb({ verb: "conference", ...opts });
|
|
166
197
|
}
|
|
198
|
+
/** Place the caller into a named queue. */
|
|
167
199
|
enqueue(opts) {
|
|
168
200
|
return this.addVerb({ verb: "enqueue", ...opts });
|
|
169
201
|
}
|
|
202
|
+
/** Remove a caller from a queue and bridge them. */
|
|
170
203
|
dequeue(opts) {
|
|
171
204
|
return this.addVerb({ verb: "dequeue", ...opts });
|
|
172
205
|
}
|
|
206
|
+
/** End the call. */
|
|
173
207
|
hangup(opts) {
|
|
174
208
|
return this.addVerb({ verb: "hangup", ...opts });
|
|
175
209
|
}
|
|
210
|
+
/** Transfer control to a different webhook URL. */
|
|
176
211
|
redirect(opts) {
|
|
177
212
|
return this.addVerb({ verb: "redirect", ...opts });
|
|
178
213
|
}
|
|
214
|
+
/** Wait for a specified duration before continuing. */
|
|
179
215
|
pause(opts) {
|
|
180
216
|
return this.addVerb({ verb: "pause", ...opts });
|
|
181
217
|
}
|
|
218
|
+
/** Leave a conference or queue. */
|
|
182
219
|
leave(opts) {
|
|
183
220
|
return this.addVerb({ verb: "leave", ...opts });
|
|
184
221
|
}
|
|
185
222
|
// --- SIP ---
|
|
223
|
+
/** Reject an incoming call with a SIP error response. */
|
|
186
224
|
sipDecline(opts) {
|
|
187
225
|
return this.addVerb({ verb: "sip:decline", ...opts });
|
|
188
226
|
}
|
|
227
|
+
/** Send a SIP INFO or other request within the dialog. */
|
|
189
228
|
sipRequest(opts) {
|
|
190
229
|
return this.addVerb({ verb: "sip:request", ...opts });
|
|
191
230
|
}
|
|
231
|
+
/** Transfer the call via SIP REFER. */
|
|
192
232
|
sipRefer(opts) {
|
|
193
233
|
return this.addVerb({ verb: "sip:refer", ...opts });
|
|
194
234
|
}
|
|
195
235
|
// --- Utility ---
|
|
236
|
+
/** Set session-level defaults (TTS vendor/voice, STT vendor, VAD, etc.). */
|
|
196
237
|
config(opts) {
|
|
197
238
|
return this.addVerb({ verb: "config", ...opts });
|
|
198
239
|
}
|
|
240
|
+
/** Explicitly answer the call (sends a 200 OK). */
|
|
199
241
|
answer(opts) {
|
|
200
242
|
return this.addVerb({ verb: "answer", ...opts });
|
|
201
243
|
}
|
|
244
|
+
/** Send a SIP 180 Ringing with optional Alert-Info header. */
|
|
202
245
|
alert(opts) {
|
|
203
246
|
return this.addVerb({ verb: "alert", ...opts });
|
|
204
247
|
}
|
|
248
|
+
/** Attach metadata to the call for tracking or routing. */
|
|
205
249
|
tag(opts) {
|
|
206
250
|
return this.addVerb({ verb: "tag", ...opts });
|
|
207
251
|
}
|
|
252
|
+
/** Send DTMF tones into the call. */
|
|
208
253
|
dtmf(opts) {
|
|
209
254
|
return this.addVerb({ verb: "dtmf", ...opts });
|
|
210
255
|
}
|
|
256
|
+
/** Mix an auxiliary audio track into the call. */
|
|
211
257
|
dub(opts) {
|
|
212
258
|
return this.addVerb({ verb: "dub", ...opts });
|
|
213
259
|
}
|
|
260
|
+
/** Send an SMS or MMS message. */
|
|
214
261
|
message(opts) {
|
|
215
262
|
return this.addVerb({ verb: "message", ...opts });
|
|
216
263
|
}
|
|
@@ -259,6 +306,7 @@ var VerbBuilder = class {
|
|
|
259
306
|
|
|
260
307
|
// src/webhook/response.ts
|
|
261
308
|
var WebhookResponse = class extends VerbBuilder {
|
|
309
|
+
/** @param opts - Options for validation and schema directory. */
|
|
262
310
|
constructor(opts) {
|
|
263
311
|
super(opts);
|
|
264
312
|
}
|
|
@@ -315,6 +363,18 @@ var WebhookResponse = class extends VerbBuilder {
|
|
|
315
363
|
}
|
|
316
364
|
};
|
|
317
365
|
|
|
366
|
+
// src/webhook/env-vars.ts
|
|
367
|
+
function envVarsMiddleware(schema) {
|
|
368
|
+
return (req, res, next) => {
|
|
369
|
+
if (req.method === "OPTIONS") {
|
|
370
|
+
res.json(schema);
|
|
371
|
+
return;
|
|
372
|
+
}
|
|
373
|
+
next();
|
|
374
|
+
};
|
|
375
|
+
}
|
|
376
|
+
|
|
318
377
|
exports.WebhookResponse = WebhookResponse;
|
|
378
|
+
exports.envVarsMiddleware = envVarsMiddleware;
|
|
319
379
|
//# sourceMappingURL=index.cjs.map
|
|
320
380
|
//# sourceMappingURL=index.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/validator.ts","../../src/verb-builder.ts","../../src/webhook/response.ts"],"names":["resolve","readFileSync","dirname","fileURLToPath","Ajv","createHmac","timingSafeEqual"],"mappings":";;;;;;;;;;;;;;AAqBA,IAAM,iBAAA,GAAoB;AAAA,EACxB,MAAA;AAAA,EACA,YAAA;AAAA,EACA,aAAA;AAAA,EACA,YAAA;AAAA,EACA,QAAA;AAAA,EACA,KAAA;AAAA,EACA,oBAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA;AAEA,IAAM,YAAA,GAAe;AAAA,EACnB,QAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EACA,KAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,KAAA;AAAA,EACA,UAAA;AAAA,EACA,YAAA;AAAA,EACA,YAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA,KAAA;AAAA,EACA,aAAA;AAAA,EACA,aAAA;AAAA,EACA;AACF,CAAA;AAEA,SAAS,UAAA,CAAW,WAAmB,YAAA,EAA+C;AACpF,EAAA,MAAM,QAAA,GAAWA,YAAA,CAAQ,SAAA,EAAW,YAAY,CAAA;AAChD,EAAA,OAAO,IAAA,CAAK,KAAA,CAAMC,eAAA,CAAa,QAAA,EAAU,OAAO,CAAC,CAAA;AACnD;AAEA,SAAS,aAAA,GAAwB;AAI/B,EAAA,MAAM,UAAA,GAAa,OAAO,SAAA,KAAc,WAAA,GACpC,YACAC,YAAA,CAAQC,iBAAA,CAAc,2PAAe,CAAC,CAAA;AAG1C,EAAA,MAAM,UAAA,GAAa;AAAA,IACjBH,YAAA,CAAQ,YAAY,cAAc,CAAA;AAAA;AAAA,IAClCA,YAAA,CAAQ,YAAY,iBAAiB;AAAA;AAAA,GACvC;AAEA,EAAA,KAAA,MAAW,aAAa,UAAA,EAAY;AAClC,IAAA,IAAI;AACF,MAAAC,eAAA,CAAaD,YAAA,CAAQ,SAAA,EAAW,yBAAyB,CAAA,EAAG,OAAO,CAAA;AACnE,MAAA,OAAO,SAAA;AAAA,IACT,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AAEA,EAAA,MAAM,IAAI,KAAA;AAAA,IACR;AAAA,GACF;AACF;AAEO,IAAM,mBAAN,MAAuB;AAAA,EACpB,WAAA;AAAA,EACA,GAAA;AAAA,EAER,YAAY,SAAA,EAAoB;AAC9B,IAAA,MAAM,GAAA,GAAM,aAAa,aAAA,EAAc;AACvC,IAAA,IAAA,CAAK,GAAA,GAAM,IAAII,oBAAA,CAAI;AAAA,MACjB,SAAA,EAAW,IAAA;AAAA,MACX,MAAA,EAAQ,KAAA;AAAA,MACR,cAAA,EAAgB,KAAA;AAAA,MAChB,MAAA,EAAQ;AAAA,KACT,CAAA;AAGD,IAAA,KAAA,MAAW,QAAQ,iBAAA,EAAmB;AACpC,MAAA,MAAM,MAAA,GAAS,UAAA,CAAW,GAAA,EAAK,CAAA,WAAA,EAAc,IAAI,CAAA,YAAA,CAAc,CAAA;AAC/D,MAAA,IAAA,CAAK,GAAA,CAAI,UAAU,MAAM,CAAA;AAAA,IAC3B;AAGA,IAAA,KAAA,MAAW,QAAQ,YAAA,EAAc;AAC/B,MAAA,MAAM,MAAA,GAAS,UAAA,CAAW,GAAA,EAAK,CAAA,MAAA,EAAS,IAAI,CAAA,YAAA,CAAc,CAAA;AAC1D,MAAA,IAAA,CAAK,GAAA,CAAI,UAAU,MAAM,CAAA;AAAA,IAC3B;AAGA,IAAA,MAAM,SAAA,GAAY,UAAA,CAAW,GAAA,EAAK,yBAAyB,CAAA;AAC3D,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA,CAAK,GAAA,CAAI,OAAA,CAAQ,SAAS,CAAA;AAAA,EAC/C;AAAA;AAAA,EAGA,SAAS,GAAA,EAAgC;AACvC,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,WAAA,CAAY,GAAG,CAAA;AAClC,IAAA,IAAI,KAAA,EAAO;AACT,MAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,MAAA,EAAQ,EAAC,EAAE;AAAA,IACnC;AACA,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,KAAA;AAAA,MACP,MAAA,EAAQ,YAAA,CAAa,IAAA,CAAK,WAAA,CAAY,MAAM;AAAA,KAC9C;AAAA,EACF;AAAA;AAAA,EAGA,aAAa,IAAA,EAAiC;AAE5C,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,CAAC,IAAI,CAAC,CAAA;AAAA,EAC7B;AACF,CAAA;AAEA,SAAS,aAAa,MAAA,EAA6D;AACjF,EAAA,IAAI,CAAC,MAAA,EAAQ,OAAO,EAAC;AACrB,EAAA,OAAO,MAAA,CAAO,GAAA,CAAI,CAAC,GAAA,MAAS;AAAA,IAC1B,IAAA,EAAM,IAAI,YAAA,IAAgB,GAAA;AAAA,IAC1B,OAAA,EAAS,IAAI,OAAA,IAAW;AAAA,GAC1B,CAAE,CAAA;AACJ;;;AC3GO,IAAM,cAAN,MAAkB;AAAA,EACb,QAAgB,EAAC;AAAA,EACjB,SAAA;AAAA,EAEV,YAAY,IAAA,EAA2B;AACrC,IAAA,IAAI,IAAA,EAAM,aAAa,KAAA,EAAO;AAC5B,MAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AAAA,IACnB,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,SAAA,GAAY,IAAI,gBAAA,CAAiB,IAAA,EAAM,SAAS,CAAA;AAAA,IACvD;AAAA,EACF;AAAA;AAAA,EAIA,IAAI,IAAA,EAAmC;AACrC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,KAAA,EAAO,GAAG,MAAM,CAAA;AAAA,EAC9C;AAAA,EAEA,KAAK,IAAA,EAAoC;AACvC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,MAAA,EAAQ,GAAG,MAAM,CAAA;AAAA,EAC/C;AAAA,EAEA,OAAO,IAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA;AAAA,EAIA,IAAI,IAAA,EAAmC;AACrC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,KAAA,EAAO,GAAG,MAAM,CAAA;AAAA,EAC9C;AAAA,EAEA,SAAS,IAAA,EAAwC;AAC/C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,UAAA,EAAY,GAAG,MAAM,CAAA;AAAA,EACnD;AAAA,EAEA,OAAO,IAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA,EAEA,OAAO,IAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA,EAEA,WAAW,IAAA,EAA0C;AACnD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,YAAA,EAAc,GAAG,MAAM,CAAA;AAAA,EACrD;AAAA;AAAA,EAIA,KAAK,IAAA,EAAoC;AACvC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,MAAA,EAAQ,GAAG,MAAM,CAAA;AAAA,EAC/C;AAAA,EAEA,WAAW,IAAA,EAA0C;AACnD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,YAAA,EAAc,GAAG,MAAM,CAAA;AAAA,EACrD;AAAA,EAEA,QAAQ,IAAA,EAAuC;AAC7C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,SAAA,EAAW,GAAG,MAAM,CAAA;AAAA,EAClD;AAAA,EAEA,QAAQ,IAAA,EAAuC;AAC7C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,SAAA,EAAW,GAAG,MAAM,CAAA;AAAA,EAClD;AAAA,EAEA,OAAO,IAAA,EAAuC;AAC5C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA,EAEA,SAAS,IAAA,EAAwC;AAC/C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,UAAA,EAAY,GAAG,MAAM,CAAA;AAAA,EACnD;AAAA,EAEA,MAAM,IAAA,EAAqC;AACzC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,OAAA,EAAS,GAAG,MAAM,CAAA;AAAA,EAChD;AAAA,EAEA,MAAM,IAAA,EAAsC;AAC1C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,OAAA,EAAS,GAAG,MAAM,CAAA;AAAA,EAChD;AAAA;AAAA,EAIA,WAAW,IAAA,EAA0C;AACnD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,aAAA,EAAe,GAAG,MAAM,CAAA;AAAA,EACtD;AAAA,EAEA,WAAW,IAAA,EAA0C;AACnD,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,aAAA,EAAe,GAAG,MAAM,CAAA;AAAA,EACtD;AAAA,EAEA,SAAS,IAAA,EAAwC;AAC/C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,WAAA,EAAa,GAAG,MAAM,CAAA;AAAA,EACpD;AAAA;AAAA,EAIA,OAAO,IAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA,EAEA,OAAO,IAAA,EAAuC;AAC5C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,QAAA,EAAU,GAAG,MAAM,CAAA;AAAA,EACjD;AAAA,EAEA,MAAM,IAAA,EAAqC;AACzC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,OAAA,EAAS,GAAG,MAAM,CAAA;AAAA,EAChD;AAAA,EAEA,IAAI,IAAA,EAAmC;AACrC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,KAAA,EAAO,GAAG,MAAM,CAAA;AAAA,EAC9C;AAAA,EAEA,KAAK,IAAA,EAAoC;AACvC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,MAAA,EAAQ,GAAG,MAAM,CAAA;AAAA,EAC/C;AAAA,EAEA,IAAI,IAAA,EAAmC;AACrC,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,KAAA,EAAO,GAAG,MAAM,CAAA;AAAA,EAC9C;AAAA,EAEA,QAAQ,IAAA,EAAuC;AAC7C,IAAA,OAAO,KAAK,OAAA,CAAQ,EAAE,MAAM,SAAA,EAAW,GAAG,MAAM,CAAA;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAS,KAAA,EAAqB;AAC5B,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,QAAA,CAAS,KAAK,CAAA;AAC5C,MAAA,IAAI,CAAC,OAAO,KAAA,EAAO;AACjB,QAAA,MAAM,QAAA,GAAW,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,IAAI,KAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAC9E,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,wBAAA,EAA2B,QAAQ,CAAA,CAAE,CAAA;AAAA,MACvD;AAAA,IACF;AACA,IAAA,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAG,KAAK,CAAA;AACxB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA,EAIU,QAAQ,IAAA,EAAkB;AAClC,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,SAAA,CAAU,YAAA,CAAa,IAAI,CAAA;AAC/C,MAAA,IAAI,CAAC,OAAO,KAAA,EAAO;AACjB,QAAA,MAAM,QAAA,GAAW,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,EAAG,CAAA,CAAE,IAAI,KAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAAE,KAAK,IAAI,CAAA;AAC9E,QAAA,MAAM,IAAI,KAAA,CAAM,CAAA,MAAA,EAAS,KAAK,IAAI,CAAA,qBAAA,EAAwB,QAAQ,CAAA,CAAE,CAAA;AAAA,MACtE;AAAA,IACF;AACA,IAAA,IAAA,CAAK,KAAA,CAAM,KAAK,IAAI,CAAA;AACpB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA,EAGA,IAAI,MAAA,GAAiB;AACnB,IAAA,OAAO,KAAK,KAAA,CAAM,MAAA;AAAA,EACpB;AAAA;AAAA,EAGA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,QAAQ,EAAC;AACd,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA,EAGA,MAAA,GAAiB;AACf,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,KAAK,CAAA;AAAA,EACvB;AACF,CAAA;;;AC9MO,IAAM,eAAA,GAAN,cAA8B,WAAA,CAAY;AAAA,EAC/C,YAAY,IAAA,EAA2B;AACrC,IAAA,KAAA,CAAM,IAAI,CAAA;AAAA,EACZ;AAAA;AAAA,EAGA,MAAA,GAAqB;AACnB,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,KAAK,CAAA;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,eAAA,CAAgB,MAAA,EAAgB,IAAA,EAA+B;AACpE,IAAA,MAAM,SAAA,GAAY,MAAM,SAAA,IAAa,GAAA;AAErC,IAAA,OAAO,CACL,GAAA,EACA,IAAA,EACA,IAAA,KACG;AACH,MAAA,IAAI;AACF,QAAA,MAAM,SAAA,GAAa,GAAA,CAAI,OAAA,CAA+C,mBAAmB,CAAA;AACzF,QAAA,IAAI,CAAC,SAAA,EAAW;AACd,UAAA,MAAM,IAAI,MAAM,kCAAkC,CAAA;AAAA,QACpD;AAEA,QAAA,MAAM,KAAA,GAAQ,SAAA,CAAU,KAAA,CAAM,GAAG,CAAA;AACjC,QAAA,IAAI,SAAA,GAAY,EAAA;AAChB,QAAA,MAAM,aAAuB,EAAC;AAE9B,QAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,UAAA,MAAM,CAAC,GAAA,EAAK,KAAK,CAAA,GAAI,IAAA,CAAK,MAAM,GAAG,CAAA;AACnC,UAAA,IAAI,GAAA,KAAQ,KAAK,SAAA,GAAY,KAAA;AAAA,eAAA,IACpB,GAAA,KAAQ,IAAA,EAAM,UAAA,CAAW,IAAA,CAAK,KAAK,CAAA;AAAA,QAC9C;AAEA,QAAA,IAAI,CAAC,SAAA,IAAa,UAAA,CAAW,MAAA,KAAW,CAAA,EAAG;AACzC,UAAA,MAAM,IAAI,MAAM,kCAAkC,CAAA;AAAA,QACpD;AAGA,QAAA,MAAM,EAAA,GAAK,QAAA,CAAS,SAAA,EAAW,EAAE,CAAA;AACjC,QAAA,MAAM,MAAM,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAA,KAAQ,GAAI,CAAA;AACxC,QAAA,IAAI,IAAA,CAAK,GAAA,CAAI,GAAA,GAAM,EAAE,IAAI,SAAA,EAAW;AAClC,UAAA,MAAM,IAAI,MAAM,+CAA+C,CAAA;AAAA,QACjE;AAGA,QAAA,MAAM,OAAA,GAAU,OAAO,GAAA,CAAI,IAAA,KAAS,QAAA,GAChC,IAAI,IAAA,GACJ,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA;AAC3B,QAAA,MAAM,aAAA,GAAgB,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,OAAO,CAAA,CAAA;AAC7C,QAAA,MAAM,QAAA,GAAWC,kBAAW,QAAA,EAAU,MAAM,EACzC,MAAA,CAAO,aAAa,CAAA,CACpB,MAAA,CAAO,KAAK,CAAA;AAGf,QAAA,MAAM,OAAA,GAAU,UAAA,CAAW,IAAA,CAAK,CAAC,GAAA,KAAQ;AACvC,UAAA,IAAI;AACF,YAAA,OAAOC,sBAAA,CAAgB,OAAO,IAAA,CAAK,GAAG,GAAG,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAC,CAAA;AAAA,UAChE,CAAA,CAAA,MAAQ;AACN,YAAA,OAAO,KAAA;AAAA,UACT;AAAA,QACF,CAAC,CAAA;AAED,QAAA,IAAI,CAAC,OAAA,EAAS;AACZ,UAAA,MAAM,IAAI,MAAM,uCAAuC,CAAA;AAAA,QACzD;AAEA,QAAA,IAAA,EAAK;AAAA,MACP,SAAS,GAAA,EAAK;AACZ,QAAA,IAAA,CAAK,GAAA,YAAe,QAAQ,GAAA,GAAM,IAAI,MAAM,MAAA,CAAO,GAAG,CAAC,CAAC,CAAA;AAAA,MAC1D;AAAA,IACF,CAAA;AAAA,EACF;AACF","file":"index.cjs","sourcesContent":["/**\n * Schema-based validation using AJV.\n * Loads all 36 JSON schemas from schema/ and validates verb arrays and individual verbs.\n */\n\nimport Ajv, { type ValidateFunction, type ErrorObject } from 'ajv';\nimport { readFileSync } from 'fs';\nimport { resolve, dirname } from 'path';\nimport { fileURLToPath } from 'url';\n\nexport interface ValidationResult {\n valid: boolean;\n errors: ValidationError[];\n}\n\nexport interface ValidationError {\n path: string;\n message: string;\n}\n\n// Schema $id to file path mapping\nconst COMPONENT_SCHEMAS = [\n 'auth',\n 'actionHook',\n 'synthesizer',\n 'recognizer',\n 'target',\n 'vad',\n 'bidirectionalAudio',\n 'fillerNoise',\n 'actionHookDelayAction',\n] as const;\n\nconst VERB_SCHEMAS = [\n 'answer',\n 'alert',\n 'config',\n 'say',\n 'play',\n 'gather',\n 'dial',\n 'listen',\n 'stream',\n 'llm',\n 'pipeline',\n 'conference',\n 'transcribe',\n 'enqueue',\n 'dequeue',\n 'dtmf',\n 'dub',\n 'hangup',\n 'leave',\n 'message',\n 'pause',\n 'redirect',\n 'tag',\n 'sip-decline',\n 'sip-request',\n 'sip-refer',\n] as const;\n\nfunction loadSchema(schemaDir: string, relativePath: string): Record<string, unknown> {\n const fullPath = resolve(schemaDir, relativePath);\n return JSON.parse(readFileSync(fullPath, 'utf-8')) as Record<string, unknown>;\n}\n\nfunction findSchemaDir(): string {\n // Walk up from this file to find the schema/ directory\n // In development: typescript/src/validator.ts -> ../../schema\n // In dist: typescript/dist/validator.js -> ../../schema\n const currentDir = typeof __dirname !== 'undefined'\n ? __dirname\n : dirname(fileURLToPath(import.meta.url));\n\n // Try relative paths from both src and dist locations\n const candidates = [\n resolve(currentDir, '../../schema'), // from src/\n resolve(currentDir, '../../../schema'), // from dist/\n ];\n\n for (const candidate of candidates) {\n try {\n readFileSync(resolve(candidate, 'jambonz-app.schema.json'), 'utf-8');\n return candidate;\n } catch {\n // try next\n }\n }\n\n throw new Error(\n 'Could not find jambonz schema directory. Ensure the schema/ directory is present alongside the typescript/ directory.'\n );\n}\n\nexport class JambonzValidator {\n private validateApp: ValidateFunction;\n private ajv: Ajv;\n\n constructor(schemaDir?: string) {\n const dir = schemaDir ?? findSchemaDir();\n this.ajv = new Ajv({\n allErrors: true,\n strict: false,\n validateSchema: false,\n logger: false,\n });\n\n // Register component schemas first (they are referenced by verb schemas)\n for (const name of COMPONENT_SCHEMAS) {\n const schema = loadSchema(dir, `components/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Register verb schemas\n for (const name of VERB_SCHEMAS) {\n const schema = loadSchema(dir, `verbs/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Compile the root app schema\n const appSchema = loadSchema(dir, 'jambonz-app.schema.json');\n this.validateApp = this.ajv.compile(appSchema);\n }\n\n /** Validate a complete verb array (a jambonz application). */\n validate(app: unknown): ValidationResult {\n const valid = this.validateApp(app);\n if (valid) {\n return { valid: true, errors: [] };\n }\n return {\n valid: false,\n errors: formatErrors(this.validateApp.errors),\n };\n }\n\n /** Validate a single verb object. */\n validateVerb(verb: unknown): ValidationResult {\n // Wrap in an array and validate as an app\n return this.validate([verb]);\n }\n}\n\nfunction formatErrors(errors: ErrorObject[] | null | undefined): ValidationError[] {\n if (!errors) return [];\n return errors.map((err) => ({\n path: err.instancePath || '/',\n message: err.message || 'Unknown validation error',\n }));\n}\n\nlet _defaultValidator: JambonzValidator | null = null;\n\n/** Get a shared validator instance. */\nexport function getValidator(schemaDir?: string): JambonzValidator {\n if (!_defaultValidator) {\n _defaultValidator = new JambonzValidator(schemaDir);\n }\n return _defaultValidator;\n}\n","/**\n * Shared VerbBuilder base class.\n * Provides typed verb methods and raw JSON input for both WebhookResponse and WS Session.\n */\n\nimport type {\n AlertVerb,\n AnswerVerb,\n ConferenceVerb,\n ConfigVerb,\n DequeueVerb,\n DialVerb,\n DtmfVerb,\n DubVerb,\n EnqueueVerb,\n GatherVerb,\n HangupVerb,\n LeaveVerb,\n ListenVerb,\n LlmVerb,\n MessageVerb,\n PauseVerb,\n PipelineVerb,\n PlayVerb,\n RedirectVerb,\n SayVerb,\n SipDeclineVerb,\n SipReferVerb,\n SipRequestVerb,\n StreamVerb,\n TagVerb,\n TranscribeVerb,\n Verb,\n} from './types/verbs.js';\nimport { JambonzValidator } from './validator.js';\n\nexport interface VerbBuilderOptions {\n /** Enable runtime schema validation. Default: true. */\n validate?: boolean;\n /** Path to schema directory. Auto-detected if omitted. */\n schemaDir?: string;\n}\n\nexport class VerbBuilder {\n protected verbs: Verb[] = [];\n protected validator: JambonzValidator | null;\n\n constructor(opts?: VerbBuilderOptions) {\n if (opts?.validate === false) {\n this.validator = null;\n } else {\n this.validator = new JambonzValidator(opts?.schemaDir);\n }\n }\n\n // --- Audio & Speech ---\n\n say(opts: Omit<SayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'say', ...opts });\n }\n\n play(opts: Omit<PlayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'play', ...opts });\n }\n\n gather(opts: Omit<GatherVerb, 'verb'>): this {\n return this.addVerb({ verb: 'gather', ...opts });\n }\n\n // --- AI & Real-time ---\n\n llm(opts: Omit<LlmVerb, 'verb'>): this {\n return this.addVerb({ verb: 'llm', ...opts });\n }\n\n pipeline(opts: Omit<PipelineVerb, 'verb'>): this {\n return this.addVerb({ verb: 'pipeline', ...opts });\n }\n\n listen(opts: Omit<ListenVerb, 'verb'>): this {\n return this.addVerb({ verb: 'listen', ...opts });\n }\n\n stream(opts: Omit<StreamVerb, 'verb'>): this {\n return this.addVerb({ verb: 'stream', ...opts });\n }\n\n transcribe(opts: Omit<TranscribeVerb, 'verb'>): this {\n return this.addVerb({ verb: 'transcribe', ...opts });\n }\n\n // --- Call Control ---\n\n dial(opts: Omit<DialVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dial', ...opts });\n }\n\n conference(opts: Omit<ConferenceVerb, 'verb'>): this {\n return this.addVerb({ verb: 'conference', ...opts });\n }\n\n enqueue(opts: Omit<EnqueueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'enqueue', ...opts });\n }\n\n dequeue(opts: Omit<DequeueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dequeue', ...opts });\n }\n\n hangup(opts?: Omit<HangupVerb, 'verb'>): this {\n return this.addVerb({ verb: 'hangup', ...opts });\n }\n\n redirect(opts: Omit<RedirectVerb, 'verb'>): this {\n return this.addVerb({ verb: 'redirect', ...opts });\n }\n\n pause(opts: Omit<PauseVerb, 'verb'>): this {\n return this.addVerb({ verb: 'pause', ...opts });\n }\n\n leave(opts?: Omit<LeaveVerb, 'verb'>): this {\n return this.addVerb({ verb: 'leave', ...opts });\n }\n\n // --- SIP ---\n\n sipDecline(opts: Omit<SipDeclineVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:decline', ...opts });\n }\n\n sipRequest(opts: Omit<SipRequestVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:request', ...opts });\n }\n\n sipRefer(opts: Omit<SipReferVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:refer', ...opts });\n }\n\n // --- Utility ---\n\n config(opts: Omit<ConfigVerb, 'verb'>): this {\n return this.addVerb({ verb: 'config', ...opts });\n }\n\n answer(opts?: Omit<AnswerVerb, 'verb'>): this {\n return this.addVerb({ verb: 'answer', ...opts });\n }\n\n alert(opts: Omit<AlertVerb, 'verb'>): this {\n return this.addVerb({ verb: 'alert', ...opts });\n }\n\n tag(opts: Omit<TagVerb, 'verb'>): this {\n return this.addVerb({ verb: 'tag', ...opts });\n }\n\n dtmf(opts: Omit<DtmfVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dtmf', ...opts });\n }\n\n dub(opts: Omit<DubVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dub', ...opts });\n }\n\n message(opts: Omit<MessageVerb, 'verb'>): this {\n return this.addVerb({ verb: 'message', ...opts });\n }\n\n // --- Raw JSON input (primary AI agent path) ---\n\n /**\n * Add one or more verbs from raw JSON.\n * Validates against the JSON schemas at runtime if validation is enabled.\n */\n addVerbs(verbs: Verb[]): this {\n if (this.validator) {\n const result = this.validator.validate(verbs);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb validation failed: ${messages}`);\n }\n }\n this.verbs.push(...verbs);\n return this;\n }\n\n // --- Internal ---\n\n protected addVerb(verb: Verb): this {\n if (this.validator) {\n const result = this.validator.validateVerb(verb);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb '${verb.verb}' validation failed: ${messages}`);\n }\n }\n this.verbs.push(verb);\n return this;\n }\n\n /** Get the current verb count. */\n get length(): number {\n return this.verbs.length;\n }\n\n /** Clear all queued verbs. */\n clear(): this {\n this.verbs = [];\n return this;\n }\n\n /** Returns a copy of the current verb array. */\n toJSON(): Verb[] {\n return [...this.verbs];\n }\n}\n","/**\n * WebhookResponse — verb builder for HTTP webhook applications.\n * Extends VerbBuilder with toJSON() and signature verification.\n */\n\nimport { createHmac, timingSafeEqual } from 'crypto';\nimport { VerbBuilder, type VerbBuilderOptions } from '../verb-builder.js';\nimport type { JambonzApp } from '../types/verbs.js';\nimport type { IncomingMessage, ServerResponse } from 'http';\n\nexport class WebhookResponse extends VerbBuilder {\n constructor(opts?: VerbBuilderOptions) {\n super(opts);\n }\n\n /** Returns the verb array for JSON serialization. */\n toJSON(): JambonzApp {\n return [...this.verbs];\n }\n\n /**\n * Express-compatible middleware for verifying jambonz webhook signatures.\n * Uses HMAC-SHA256 with timing-safe comparison.\n */\n static verifySignature(secret: string, opts?: { tolerance?: number }) {\n const tolerance = opts?.tolerance ?? 300; // 5 minutes default\n\n return (\n req: IncomingMessage & { body?: unknown; rawBody?: Buffer },\n _res: ServerResponse,\n next: (err?: Error) => void\n ) => {\n try {\n const signature = (req.headers as Record<string, string | undefined>)['jambonz-signature'];\n if (!signature) {\n throw new Error('Missing Jambonz-Signature header');\n }\n\n const parts = signature.split(',');\n let timestamp = '';\n const signatures: string[] = [];\n\n for (const part of parts) {\n const [key, value] = part.split('=');\n if (key === 't') timestamp = value;\n else if (key === 'v1') signatures.push(value);\n }\n\n if (!timestamp || signatures.length === 0) {\n throw new Error('Invalid Jambonz-Signature format');\n }\n\n // Check timestamp tolerance\n const ts = parseInt(timestamp, 10);\n const now = Math.floor(Date.now() / 1000);\n if (Math.abs(now - ts) > tolerance) {\n throw new Error('Webhook signature timestamp outside tolerance');\n }\n\n // Compute expected signature\n const payload = typeof req.body === 'string'\n ? req.body\n : JSON.stringify(req.body);\n const signedPayload = `${timestamp}.${payload}`;\n const expected = createHmac('sha256', secret)\n .update(signedPayload)\n .digest('hex');\n\n // Timing-safe comparison\n const matched = signatures.some((sig) => {\n try {\n return timingSafeEqual(Buffer.from(sig), Buffer.from(expected));\n } catch {\n return false;\n }\n });\n\n if (!matched) {\n throw new Error('Webhook signature verification failed');\n }\n\n next();\n } catch (err) {\n next(err instanceof Error ? err : new Error(String(err)));\n }\n };\n }\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../../src/validator.ts","../../src/verb-builder.ts","../../src/webhook/response.ts","../../src/webhook/env-vars.ts"],"names":["resolve","readFileSync","dirname","fileURLToPath","Ajv","createHmac","timingSafeEqual"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Schema-based validation using AJV.\n * Loads all JSON schemas from schema/ and validates verb arrays and individual verbs.\n */\n\nimport Ajv, { type ValidateFunction, type ErrorObject } from 'ajv';\nimport { readFileSync } from 'fs';\nimport { resolve, dirname } from 'path';\nimport { fileURLToPath } from 'url';\n\nexport interface ValidationResult {\n valid: boolean;\n errors: ValidationError[];\n}\n\nexport interface ValidationError {\n path: string;\n message: string;\n}\n\n// Schema $id to file path mapping\nconst COMPONENT_SCHEMAS = [\n 'auth',\n 'actionHook',\n 'actionHookDelayAction',\n 'amd',\n 'bidirectionalAudio',\n 'fillerNoise',\n 'recognizer',\n 'recognizer-assemblyAiOptions',\n 'recognizer-awsOptions',\n 'recognizer-azureOptions',\n 'recognizer-cobaltOptions',\n 'recognizer-customOptions',\n 'recognizer-deepgramOptions',\n 'recognizer-elevenlabsOptions',\n 'recognizer-gladiaOptions',\n 'recognizer-googleOptions',\n 'recognizer-houndifyOptions',\n 'recognizer-ibmOptions',\n 'recognizer-nuanceOptions',\n 'recognizer-nvidiaOptions',\n 'recognizer-openaiOptions',\n 'recognizer-sonioxOptions',\n 'recognizer-speechmaticsOptions',\n 'recognizer-verbioOptions',\n 'synthesizer',\n 'target',\n 'vad',\n] as const;\n\nconst VERB_SCHEMAS = [\n 'answer',\n 'alert',\n 'config',\n 'say',\n 'play',\n 'gather',\n 'dial',\n 'listen',\n 'stream',\n 'llm',\n 'pipeline',\n 'conference',\n 'transcribe',\n 'enqueue',\n 'dequeue',\n 'dtmf',\n 'dub',\n 'hangup',\n 'leave',\n 'message',\n 'pause',\n 'redirect',\n 'tag',\n 'sip-decline',\n 'sip-request',\n 'sip-refer',\n] as const;\n\nfunction loadSchema(schemaDir: string, relativePath: string): Record<string, unknown> {\n const fullPath = resolve(schemaDir, relativePath);\n return JSON.parse(readFileSync(fullPath, 'utf-8')) as Record<string, unknown>;\n}\n\nfunction findSchemaDir(): string {\n // Walk up from this file to find the schema/ directory\n // In development: typescript/src/validator.ts -> ../../schema\n // In dist: dist/index.js -> ../schema (tsup bundles to package-root/dist/)\n const currentDir = typeof __dirname !== 'undefined'\n ? __dirname\n : dirname(fileURLToPath(import.meta.url));\n\n // Try relative paths from both src and dist locations\n const candidates = [\n resolve(currentDir, '../../schema'), // from typescript/src/\n resolve(currentDir, '../schema'), // from dist/ (tsup bundles to package-root/dist/)\n ];\n\n for (const candidate of candidates) {\n try {\n readFileSync(resolve(candidate, 'jambonz-app.schema.json'), 'utf-8');\n return candidate;\n } catch {\n // try next\n }\n }\n\n throw new Error(\n 'Could not find jambonz schema directory. Ensure the schema/ directory is present alongside the typescript/ directory.'\n );\n}\n\nexport class JambonzValidator {\n private validateApp: ValidateFunction;\n private ajv: Ajv;\n\n constructor(schemaDir?: string) {\n const dir = schemaDir ?? findSchemaDir();\n this.ajv = new Ajv({\n allErrors: true,\n strict: false,\n validateSchema: false,\n logger: false,\n });\n\n // Register component schemas first (they are referenced by verb schemas)\n for (const name of COMPONENT_SCHEMAS) {\n const schema = loadSchema(dir, `components/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Register verb schemas\n for (const name of VERB_SCHEMAS) {\n const schema = loadSchema(dir, `verbs/${name}.schema.json`);\n this.ajv.addSchema(schema);\n }\n\n // Compile the root app schema\n const appSchema = loadSchema(dir, 'jambonz-app.schema.json');\n this.validateApp = this.ajv.compile(appSchema);\n }\n\n /** Validate a complete verb array (a jambonz application). */\n validate(app: unknown): ValidationResult {\n const valid = this.validateApp(app);\n if (valid) {\n return { valid: true, errors: [] };\n }\n return {\n valid: false,\n errors: formatErrors(this.validateApp.errors),\n };\n }\n\n /** Validate a single verb object. */\n validateVerb(verb: unknown): ValidationResult {\n // Wrap in an array and validate as an app\n return this.validate([verb]);\n }\n}\n\nfunction formatErrors(errors: ErrorObject[] | null | undefined): ValidationError[] {\n if (!errors) return [];\n return errors.map((err) => ({\n path: err.instancePath || '/',\n message: err.message || 'Unknown validation error',\n }));\n}\n\nlet _defaultValidator: JambonzValidator | null = null;\n\n/** Get a shared validator instance. */\nexport function getValidator(schemaDir?: string): JambonzValidator {\n if (!_defaultValidator) {\n _defaultValidator = new JambonzValidator(schemaDir);\n }\n return _defaultValidator;\n}\n","/**\n * Shared VerbBuilder base class.\n * Provides typed verb methods and raw JSON input for both WebhookResponse and WS Session.\n */\n\nimport type {\n AlertVerb,\n AnswerVerb,\n ConferenceVerb,\n ConfigVerb,\n DequeueVerb,\n DialVerb,\n DtmfVerb,\n DubVerb,\n EnqueueVerb,\n GatherVerb,\n HangupVerb,\n LeaveVerb,\n ListenVerb,\n LlmVerb,\n MessageVerb,\n PauseVerb,\n PipelineVerb,\n PlayVerb,\n RedirectVerb,\n SayVerb,\n SipDeclineVerb,\n SipReferVerb,\n SipRequestVerb,\n StreamVerb,\n TagVerb,\n TranscribeVerb,\n Verb,\n} from './types/verbs.js';\nimport { JambonzValidator } from './validator.js';\n\nexport interface VerbBuilderOptions {\n /** Enable runtime schema validation. Default: true. */\n validate?: boolean;\n /** Path to schema directory. Auto-detected if omitted. */\n schemaDir?: string;\n}\n\n/**\n * Base class for building jambonz verb arrays. Extended by {@link WebhookResponse}\n * and WsSession. Provides typed verb methods and optional runtime schema validation.\n */\nexport class VerbBuilder {\n protected verbs: Verb[] = [];\n protected validator: JambonzValidator | null;\n\n /**\n * @param opts - Options for validation and schema directory.\n */\n constructor(opts?: VerbBuilderOptions) {\n if (opts?.validate === false) {\n this.validator = null;\n } else {\n this.validator = new JambonzValidator(opts?.schemaDir);\n }\n }\n\n // --- Audio & Speech ---\n\n /** Speak text using TTS. Supports SSML, multiple voices, and streaming. */\n say(opts: Omit<SayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'say', ...opts });\n }\n\n /** Play an audio file from a URL. */\n play(opts: Omit<PlayVerb, 'verb'>): this {\n return this.addVerb({ verb: 'play', ...opts });\n }\n\n /** Collect speech (STT) and/or DTMF input from the caller. */\n gather(opts: Omit<GatherVerb, 'verb'>): this {\n return this.addVerb({ verb: 'gather', ...opts });\n }\n\n // --- AI & Real-time ---\n\n /** Connect the caller to an LLM for real-time voice conversation. */\n llm(opts: Omit<LlmVerb, 'verb'>): this {\n return this.addVerb({ verb: 'llm', ...opts });\n }\n\n /** Voice AI pipeline with integrated turn detection. */\n pipeline(opts: Omit<PipelineVerb, 'verb'>): this {\n return this.addVerb({ verb: 'pipeline', ...opts });\n }\n\n /** Stream real-time call audio to a WebSocket endpoint. Supports bidirectional audio. */\n listen(opts: Omit<ListenVerb, 'verb'>): this {\n return this.addVerb({ verb: 'listen', ...opts });\n }\n\n /** Stream real-time call audio to a WebSocket endpoint. Synonym for {@link listen}. */\n stream(opts: Omit<StreamVerb, 'verb'>): this {\n return this.addVerb({ verb: 'stream', ...opts });\n }\n\n /** Real-time call transcription sent to a webhook. */\n transcribe(opts: Omit<TranscribeVerb, 'verb'>): this {\n return this.addVerb({ verb: 'transcribe', ...opts });\n }\n\n // --- Call Control ---\n\n /** Place an outbound call and bridge it to the current caller. */\n dial(opts: Omit<DialVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dial', ...opts });\n }\n\n /** Join or create a multi-party conference room. */\n conference(opts: Omit<ConferenceVerb, 'verb'>): this {\n return this.addVerb({ verb: 'conference', ...opts });\n }\n\n /** Place the caller into a named queue. */\n enqueue(opts: Omit<EnqueueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'enqueue', ...opts });\n }\n\n /** Remove a caller from a queue and bridge them. */\n dequeue(opts: Omit<DequeueVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dequeue', ...opts });\n }\n\n /** End the call. */\n hangup(opts?: Omit<HangupVerb, 'verb'>): this {\n return this.addVerb({ verb: 'hangup', ...opts });\n }\n\n /** Transfer control to a different webhook URL. */\n redirect(opts: Omit<RedirectVerb, 'verb'>): this {\n return this.addVerb({ verb: 'redirect', ...opts });\n }\n\n /** Wait for a specified duration before continuing. */\n pause(opts: Omit<PauseVerb, 'verb'>): this {\n return this.addVerb({ verb: 'pause', ...opts });\n }\n\n /** Leave a conference or queue. */\n leave(opts?: Omit<LeaveVerb, 'verb'>): this {\n return this.addVerb({ verb: 'leave', ...opts });\n }\n\n // --- SIP ---\n\n /** Reject an incoming call with a SIP error response. */\n sipDecline(opts: Omit<SipDeclineVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:decline', ...opts });\n }\n\n /** Send a SIP INFO or other request within the dialog. */\n sipRequest(opts: Omit<SipRequestVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:request', ...opts });\n }\n\n /** Transfer the call via SIP REFER. */\n sipRefer(opts: Omit<SipReferVerb, 'verb'>): this {\n return this.addVerb({ verb: 'sip:refer', ...opts });\n }\n\n // --- Utility ---\n\n /** Set session-level defaults (TTS vendor/voice, STT vendor, VAD, etc.). */\n config(opts: Omit<ConfigVerb, 'verb'>): this {\n return this.addVerb({ verb: 'config', ...opts });\n }\n\n /** Explicitly answer the call (sends a 200 OK). */\n answer(opts?: Omit<AnswerVerb, 'verb'>): this {\n return this.addVerb({ verb: 'answer', ...opts });\n }\n\n /** Send a SIP 180 Ringing with optional Alert-Info header. */\n alert(opts: Omit<AlertVerb, 'verb'>): this {\n return this.addVerb({ verb: 'alert', ...opts });\n }\n\n /** Attach metadata to the call for tracking or routing. */\n tag(opts: Omit<TagVerb, 'verb'>): this {\n return this.addVerb({ verb: 'tag', ...opts });\n }\n\n /** Send DTMF tones into the call. */\n dtmf(opts: Omit<DtmfVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dtmf', ...opts });\n }\n\n /** Mix an auxiliary audio track into the call. */\n dub(opts: Omit<DubVerb, 'verb'>): this {\n return this.addVerb({ verb: 'dub', ...opts });\n }\n\n /** Send an SMS or MMS message. */\n message(opts: Omit<MessageVerb, 'verb'>): this {\n return this.addVerb({ verb: 'message', ...opts });\n }\n\n // --- Raw JSON input (primary AI agent path) ---\n\n /**\n * Add one or more verbs from raw JSON.\n * Validates against the JSON schemas at runtime if validation is enabled.\n */\n addVerbs(verbs: Verb[]): this {\n if (this.validator) {\n const result = this.validator.validate(verbs);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb validation failed: ${messages}`);\n }\n }\n this.verbs.push(...verbs);\n return this;\n }\n\n // --- Internal ---\n\n protected addVerb(verb: Verb): this {\n if (this.validator) {\n const result = this.validator.validateVerb(verb);\n if (!result.valid) {\n const messages = result.errors.map((e) => `${e.path}: ${e.message}`).join('; ');\n throw new Error(`Verb '${verb.verb}' validation failed: ${messages}`);\n }\n }\n this.verbs.push(verb);\n return this;\n }\n\n /** Get the current verb count. */\n get length(): number {\n return this.verbs.length;\n }\n\n /** Clear all queued verbs. */\n clear(): this {\n this.verbs = [];\n return this;\n }\n\n /** Returns a copy of the current verb array. */\n toJSON(): Verb[] {\n return [...this.verbs];\n }\n}\n","/**\n * WebhookResponse — verb builder for HTTP webhook applications.\n * Extends VerbBuilder with toJSON() and signature verification.\n */\n\nimport { createHmac, timingSafeEqual } from 'crypto';\nimport { VerbBuilder, type VerbBuilderOptions } from '../verb-builder.js';\nimport type { JambonzApp } from '../types/verbs.js';\nimport type { IncomingMessage, ServerResponse } from 'http';\n\n/**\n * Verb builder for HTTP webhook applications.\n * Construct one per request, chain verb methods, and pass to `res.json()`.\n *\n * @example\n * ```typescript\n * app.post('/incoming', (req, res) => {\n * const jambonz = new WebhookResponse();\n * jambonz.say({ text: 'Hello!' }).hangup();\n * res.json(jambonz);\n * });\n * ```\n */\nexport class WebhookResponse extends VerbBuilder {\n /** @param opts - Options for validation and schema directory. */\n constructor(opts?: VerbBuilderOptions) {\n super(opts);\n }\n\n /** Returns the verb array for JSON serialization. */\n toJSON(): JambonzApp {\n return [...this.verbs];\n }\n\n /**\n * Express-compatible middleware for verifying jambonz webhook signatures.\n * Uses HMAC-SHA256 with timing-safe comparison.\n */\n static verifySignature(secret: string, opts?: { tolerance?: number }) {\n const tolerance = opts?.tolerance ?? 300; // 5 minutes default\n\n return (\n req: IncomingMessage & { body?: unknown; rawBody?: Buffer },\n _res: ServerResponse,\n next: (err?: Error) => void\n ) => {\n try {\n const signature = (req.headers as Record<string, string | undefined>)['jambonz-signature'];\n if (!signature) {\n throw new Error('Missing Jambonz-Signature header');\n }\n\n const parts = signature.split(',');\n let timestamp = '';\n const signatures: string[] = [];\n\n for (const part of parts) {\n const [key, value] = part.split('=');\n if (key === 't') timestamp = value;\n else if (key === 'v1') signatures.push(value);\n }\n\n if (!timestamp || signatures.length === 0) {\n throw new Error('Invalid Jambonz-Signature format');\n }\n\n // Check timestamp tolerance\n const ts = parseInt(timestamp, 10);\n const now = Math.floor(Date.now() / 1000);\n if (Math.abs(now - ts) > tolerance) {\n throw new Error('Webhook signature timestamp outside tolerance');\n }\n\n // Compute expected signature\n const payload = typeof req.body === 'string'\n ? req.body\n : JSON.stringify(req.body);\n const signedPayload = `${timestamp}.${payload}`;\n const expected = createHmac('sha256', secret)\n .update(signedPayload)\n .digest('hex');\n\n // Timing-safe comparison\n const matched = signatures.some((sig) => {\n try {\n return timingSafeEqual(Buffer.from(sig), Buffer.from(expected));\n } catch {\n return false;\n }\n });\n\n if (!matched) {\n throw new Error('Webhook signature verification failed');\n }\n\n next();\n } catch (err) {\n next(err instanceof Error ? err : new Error(String(err)));\n }\n };\n }\n}\n","/**\n * Express middleware that auto-responds to HTTP OPTIONS requests with the\n * application environment variables schema for jambonz portal discovery.\n */\n\nimport type { EnvVarSchema } from '../types/common.js';\n\n/**\n * Express middleware that auto-responds to HTTP OPTIONS requests with the\n * application's environment variable schema, enabling jambonz portal discovery.\n *\n * @param schema - The environment variable schema to expose.\n *\n * @example\n * ```typescript\n * import { envVarsMiddleware } from '@jambonz/sdk/webhook';\n *\n * const envVars = {\n * API_KEY: { type: 'string', description: 'Your API key', required: true },\n * };\n * app.use(envVarsMiddleware(envVars));\n * ```\n */\nexport function envVarsMiddleware(schema: EnvVarSchema) {\n return (req: { method: string }, res: { json: (body: unknown) => void }, next: () => void) => {\n if (req.method === 'OPTIONS') {\n res.json(schema);\n return;\n }\n next();\n };\n}\n"]}
|
package/dist/webhook/index.d.cts
CHANGED
|
@@ -1,13 +1,28 @@
|
|
|
1
|
-
import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-
|
|
2
|
-
import { J as JambonzApp } from '../verbs-
|
|
1
|
+
import { b as VerbBuilder, c as VerbBuilderOptions } from '../verb-builder-DkHAJrk4.cjs';
|
|
2
|
+
import { J as JambonzApp } from '../verbs-fjJjfGEt.cjs';
|
|
3
3
|
import { IncomingMessage, ServerResponse } from 'http';
|
|
4
|
+
import { a as EnvVarSchema } from '../common-BWUBZtju.cjs';
|
|
4
5
|
|
|
5
6
|
/**
|
|
6
7
|
* WebhookResponse — verb builder for HTTP webhook applications.
|
|
7
8
|
* Extends VerbBuilder with toJSON() and signature verification.
|
|
8
9
|
*/
|
|
9
10
|
|
|
11
|
+
/**
|
|
12
|
+
* Verb builder for HTTP webhook applications.
|
|
13
|
+
* Construct one per request, chain verb methods, and pass to `res.json()`.
|
|
14
|
+
*
|
|
15
|
+
* @example
|
|
16
|
+
* ```typescript
|
|
17
|
+
* app.post('/incoming', (req, res) => {
|
|
18
|
+
* const jambonz = new WebhookResponse();
|
|
19
|
+
* jambonz.say({ text: 'Hello!' }).hangup();
|
|
20
|
+
* res.json(jambonz);
|
|
21
|
+
* });
|
|
22
|
+
* ```
|
|
23
|
+
*/
|
|
10
24
|
declare class WebhookResponse extends VerbBuilder {
|
|
25
|
+
/** @param opts - Options for validation and schema directory. */
|
|
11
26
|
constructor(opts?: VerbBuilderOptions);
|
|
12
27
|
/** Returns the verb array for JSON serialization. */
|
|
13
28
|
toJSON(): JambonzApp;
|
|
@@ -23,4 +38,31 @@ declare class WebhookResponse extends VerbBuilder {
|
|
|
23
38
|
}, _res: ServerResponse, next: (err?: Error) => void) => void;
|
|
24
39
|
}
|
|
25
40
|
|
|
26
|
-
|
|
41
|
+
/**
|
|
42
|
+
* Express middleware that auto-responds to HTTP OPTIONS requests with the
|
|
43
|
+
* application environment variables schema for jambonz portal discovery.
|
|
44
|
+
*/
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Express middleware that auto-responds to HTTP OPTIONS requests with the
|
|
48
|
+
* application's environment variable schema, enabling jambonz portal discovery.
|
|
49
|
+
*
|
|
50
|
+
* @param schema - The environment variable schema to expose.
|
|
51
|
+
*
|
|
52
|
+
* @example
|
|
53
|
+
* ```typescript
|
|
54
|
+
* import { envVarsMiddleware } from '@jambonz/sdk/webhook';
|
|
55
|
+
*
|
|
56
|
+
* const envVars = {
|
|
57
|
+
* API_KEY: { type: 'string', description: 'Your API key', required: true },
|
|
58
|
+
* };
|
|
59
|
+
* app.use(envVarsMiddleware(envVars));
|
|
60
|
+
* ```
|
|
61
|
+
*/
|
|
62
|
+
declare function envVarsMiddleware(schema: EnvVarSchema): (req: {
|
|
63
|
+
method: string;
|
|
64
|
+
}, res: {
|
|
65
|
+
json: (body: unknown) => void;
|
|
66
|
+
}, next: () => void) => void;
|
|
67
|
+
|
|
68
|
+
export { WebhookResponse, envVarsMiddleware };
|