@jambonz/sdk 0.7.0 → 0.8.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/AGENTS.md +21 -14
- package/dist/client/index.cjs +4 -0
- package/dist/client/index.cjs.map +1 -1
- package/dist/client/index.d.cts +4 -2
- package/dist/client/index.d.ts +4 -2
- package/dist/client/index.js +4 -0
- package/dist/client/index.js.map +1 -1
- package/dist/index.cjs +18 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +3 -3
- package/dist/index.d.ts +3 -3
- package/dist/index.js +18 -1
- package/dist/index.js.map +1 -1
- package/dist/{rest-CoEMXJy6.d.ts → rest-C4J_YJN5.d.cts} +3 -1
- package/dist/{rest-B1Gb3E0R.d.cts → rest-DVExRUxz.d.ts} +3 -1
- package/dist/types/index.cjs.map +1 -1
- package/dist/types/index.d.cts +2 -2
- package/dist/types/index.d.ts +2 -2
- package/dist/types/index.js.map +1 -1
- package/dist/{verb-builder-D3TNKZcU.d.cts → verb-builder-BjrRSray.d.cts} +3 -1
- package/dist/{verb-builder-CwXZO4NY.d.ts → verb-builder-C5tteeud.d.ts} +3 -1
- package/dist/{verbs-O_ofvl8T.d.cts → verbs-DXbSDMKR.d.cts} +91 -3
- package/dist/{verbs-O_ofvl8T.d.ts → verbs-DXbSDMKR.d.ts} +91 -3
- package/dist/webhook/index.cjs +4 -0
- package/dist/webhook/index.cjs.map +1 -1
- package/dist/webhook/index.d.cts +2 -2
- package/dist/webhook/index.d.ts +2 -2
- package/dist/webhook/index.js +4 -0
- package/dist/webhook/index.js.map +1 -1
- package/dist/websocket/index.cjs +14 -1
- package/dist/websocket/index.cjs.map +1 -1
- package/dist/websocket/index.d.cts +4 -2
- package/dist/websocket/index.d.ts +4 -2
- package/dist/websocket/index.js +14 -1
- package/dist/websocket/index.js.map +1 -1
- package/examples/bedrock-agent.ts +6 -1
- package/examples/room-play-tone/ws-app.ts +63 -0
- package/examples/room-say/ws-app.ts +67 -0
- package/examples/room-with-stream/ws-app.ts +64 -0
- package/examples/s2s-move-to-room/ws-app.ts +82 -0
- package/examples/{listen-record → stream-record}/app.ts +2 -2
- package/examples/stream-then-room/ws-app.ts +74 -0
- package/package.json +2 -2
package/AGENTS.md
CHANGED
|
@@ -188,7 +188,9 @@ console.log('Speech echo WebSocket app listening on port 3000');
|
|
|
188
188
|
|
|
189
189
|
Both `WebhookResponse` and `Session` support the same chainable verb methods:
|
|
190
190
|
|
|
191
|
-
`.say(opts)` `.play(opts)` `.gather(opts)` `.dial(opts)` `.llm(opts)` `.s2s(opts)` `.openai_s2s(opts)` `.google_s2s(opts)` `.elevenlabs_s2s(opts)` `.deepgram_s2s(opts)` `.ultravox_s2s(opts)` `.dialogflow(opts)` `.
|
|
191
|
+
`.say(opts)` `.play(opts)` `.gather(opts)` `.dial(opts)` `.llm(opts)` `.s2s(opts)` `.openai_s2s(opts)` `.google_s2s(opts)` `.elevenlabs_s2s(opts)` `.deepgram_s2s(opts)` `.ultravox_s2s(opts)` `.dialogflow(opts)` `.room(opts)` `.enqueue(opts)` `.dequeue(opts)` `.hangup()` `.pause(opts)` `.redirect(opts)` `.config(opts)` `.tag(opts)` `.dtmf(opts)` `.stream(opts)` `.transcribe(opts)` `.message(opts)` `.agent(opts)` `.dub(opts)` `.alert(opts)` `.answer(opts)` `.leave()` `.sipDecline(opts)` `.sipRefer(opts)` `.sipRequest(opts)` `.transfer(opts)`
|
|
192
|
+
|
|
193
|
+
Prefer `.room(opts)` and `.stream(opts)`. `.conference(opts)` and `.listen(opts)` remain as backward-compatible synonyms (same options), but new apps should use `room`/`stream`.
|
|
192
194
|
|
|
193
195
|
All methods accept the same options as the corresponding verb JSON Schema. Methods are chainable — they return `this`.
|
|
194
196
|
|
|
@@ -415,9 +417,9 @@ session.on('close', (code, reason) => { /* connection closed */ });
|
|
|
415
417
|
session.on('error', (err) => { /* error */ });
|
|
416
418
|
```
|
|
417
419
|
|
|
418
|
-
## Audio WebSocket (Listen
|
|
420
|
+
## Audio WebSocket (Stream/Listen)
|
|
419
421
|
|
|
420
|
-
The `
|
|
422
|
+
The `stream` verb (and its backward-compatible synonym `listen`) opens a separate WebSocket connection from jambonz to your application, carrying raw audio. This is independent of the control WebSocket (`ws.jambonz.org`) — it uses the `audio.drachtio.org` subprotocol.
|
|
421
423
|
|
|
422
424
|
### Receiving Audio in the Same Application
|
|
423
425
|
|
|
@@ -433,14 +435,14 @@ const makeService = createEndpoint({ server, port: 3000 });
|
|
|
433
435
|
// Control pipe — handles call sessions
|
|
434
436
|
const svc = makeService({ path: '/' });
|
|
435
437
|
|
|
436
|
-
// Audio pipe — receives
|
|
438
|
+
// Audio pipe — receives stream audio
|
|
437
439
|
const audioSvc = makeService.audio({ path: '/audio-stream' });
|
|
438
440
|
|
|
439
441
|
svc.on('session:new', (session) => {
|
|
440
442
|
session
|
|
441
443
|
.answer()
|
|
442
444
|
.say({ text: 'Recording your audio.' })
|
|
443
|
-
.
|
|
445
|
+
.stream({
|
|
444
446
|
url: '/audio-stream', // relative path — jambonz connects back to same server
|
|
445
447
|
sampleRate: 16000,
|
|
446
448
|
mixType: 'mono',
|
|
@@ -472,7 +474,7 @@ The `stream` object in the `connection` event is an `AudioStream` instance:
|
|
|
472
474
|
|
|
473
475
|
**Events**:
|
|
474
476
|
- `audio` — L16 PCM binary frame (`Buffer`)
|
|
475
|
-
- `dtmf` — `{digit, duration}` (only if `passDtmf: true` on
|
|
477
|
+
- `dtmf` — `{digit, duration}` (only if `passDtmf: true` on stream verb)
|
|
476
478
|
- `playDone` — `{id}` (after non-streaming playAudio completes)
|
|
477
479
|
- `mark` — `{name, event}` where event is `'playout'` or `'cleared'`
|
|
478
480
|
- `close` — `(code, reason)`
|
|
@@ -480,7 +482,7 @@ The `stream` object in the `connection` event is an `AudioStream` instance:
|
|
|
480
482
|
|
|
481
483
|
### Sending Audio Back (Bidirectional)
|
|
482
484
|
|
|
483
|
-
The
|
|
485
|
+
The stream verb supports bidirectional audio. There are two modes, controlled by the `bidirectionalAudio.streaming` option on the stream verb.
|
|
484
486
|
|
|
485
487
|
**Non-streaming mode** (`streaming: false`, the default) — send complete audio clips as base64:
|
|
486
488
|
|
|
@@ -502,7 +504,7 @@ Up to 10 playAudio commands can be queued simultaneously.
|
|
|
502
504
|
**Streaming mode** (`streaming: true`) — send raw binary PCM frames directly:
|
|
503
505
|
|
|
504
506
|
```typescript
|
|
505
|
-
// In the
|
|
507
|
+
// In the stream verb config:
|
|
506
508
|
// bidirectionalAudio: { enabled: true, streaming: true, sampleRate: 16000 }
|
|
507
509
|
|
|
508
510
|
stream.on('audio', (pcm) => {
|
|
@@ -513,16 +515,16 @@ stream.on('audio', (pcm) => {
|
|
|
513
515
|
|
|
514
516
|
### Marks (Synchronization Markers)
|
|
515
517
|
|
|
516
|
-
Marks let you track when streamed audio has been played out to the caller. They work **only with bidirectional streaming mode** — you must enable `bidirectionalAudio: { enabled: true, streaming: true }` on the
|
|
518
|
+
Marks let you track when streamed audio has been played out to the caller. They work **only with bidirectional streaming mode** — you must enable `bidirectionalAudio: { enabled: true, streaming: true }` on the stream verb.
|
|
517
519
|
|
|
518
520
|
The pattern is: stream audio via `sendAudio()`, then send a mark. When all the audio sent before the mark finishes playing out, jambonz sends back a mark event with `event: 'playout'`. This is how you know the caller has heard a specific chunk of audio.
|
|
519
521
|
|
|
520
522
|
```typescript
|
|
521
|
-
//
|
|
523
|
+
// Stream verb must enable bidirectional streaming for marks to work
|
|
522
524
|
session
|
|
523
|
-
.
|
|
525
|
+
.stream({
|
|
524
526
|
url: '/audio',
|
|
525
|
-
actionHook: '/
|
|
527
|
+
actionHook: '/stream-done',
|
|
526
528
|
bidirectionalAudio: {
|
|
527
529
|
enabled: true,
|
|
528
530
|
streaming: true,
|
|
@@ -557,7 +559,7 @@ audioSvc.on('connection', (stream) => {
|
|
|
557
559
|
|
|
558
560
|
```typescript
|
|
559
561
|
stream.killAudio(); // Stop playback, flush buffer
|
|
560
|
-
stream.disconnect(); // Close connection, end
|
|
562
|
+
stream.disconnect(); // Close connection, end stream verb
|
|
561
563
|
stream.sendMark('sync-pt'); // Insert synchronization marker
|
|
562
564
|
stream.clearMarks(); // Clear all pending markers
|
|
563
565
|
stream.close(); // Close the WebSocket
|
|
@@ -710,7 +712,7 @@ Complete working examples are in the `examples/` directory:
|
|
|
710
712
|
- **echo** — Speech echo using gather with actionHook pattern (webhook + WebSocket). The canonical example for understanding actionHook event handling.
|
|
711
713
|
- **ivr-menu** — Interactive menu with speech and DTMF input (webhook)
|
|
712
714
|
- **dial** — Simple outbound dial to a phone number (webhook)
|
|
713
|
-
- **
|
|
715
|
+
- **stream-record** — Record audio using the stream verb to stream to a WebSocket (webhook)
|
|
714
716
|
- **voice-agent** — LLM-powered conversational AI with tool calls (webhook + WebSocket)
|
|
715
717
|
- **openai-realtime** — OpenAI Realtime API voice agent with function calling (WebSocket)
|
|
716
718
|
- **deepgram-voice-agent** — Deepgram Voice Agent API with function calling (WebSocket)
|
|
@@ -719,3 +721,8 @@ Complete working examples are in the `examples/` directory:
|
|
|
719
721
|
- **queue-with-hold** — Call queue with hold music and agent dequeue (webhook + WebSocket)
|
|
720
722
|
- **call-recording** — Mid-call recording control via REST API and inject commands (webhook + WebSocket)
|
|
721
723
|
- **realtime-translator** — Bridges two parties with real-time speech translation using STT, Google Translate, and TTS dub tracks. Multi-file example with `src/routes/` structure (WebSocket)
|
|
724
|
+
- **room-with-stream** — A Room with a nested bidirectional audio stream forked to a WebSocket (WebSocket)
|
|
725
|
+
- **stream-then-room** — 1:1 stream, then move the caller + stream into a Room mid-call (WebSocket)
|
|
726
|
+
- **s2s-move-to-room** — Ultravox s2s, then move the caller + agent into a Room mid-call (WebSocket)
|
|
727
|
+
- **room-say** — injectSay a one-shot TTS announcement heard by the whole Room (WebSocket)
|
|
728
|
+
- **room-play-tone** — injectPlay a tone heard by the whole Room (WebSocket)
|
package/dist/client/index.cjs
CHANGED
|
@@ -120,6 +120,10 @@ var CallsResource = class {
|
|
|
120
120
|
async updateAgent(callSid, data) {
|
|
121
121
|
return this.update(callSid, { agent_update: data });
|
|
122
122
|
}
|
|
123
|
+
/** Redirect the in-progress call to a packaged transfer (blind or warm). */
|
|
124
|
+
async transfer(callSid, opts) {
|
|
125
|
+
return this.update(callSid, { transfer: opts });
|
|
126
|
+
}
|
|
123
127
|
/** Enable or disable server-side noise isolation. */
|
|
124
128
|
async noiseIsolation(callSid, status, opts) {
|
|
125
129
|
return this.update(callSid, {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/client/api.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * JambonzClient — REST API client for the jambonz platform.\n * Uses native fetch (Node 18+).\n */\n\nimport type {\n CallInfo,\n CallCount,\n CreateCallRequest,\n UpdateCallRequest,\n ListCallsFilter,\n QueueInfo,\n} from '../types/rest.js';\nimport type { ActionHook } from '../types/components.js';\nimport type { Verb } from '../types/verbs.js';\n\nexport interface ClientOptions {\n /** Base URL of the jambonz API (e.g. 'https://api.jambonz.us'). */\n baseUrl: string;\n /** Account SID. */\n accountSid: string;\n /** API key (Bearer token). */\n apiKey: string;\n}\n\nclass HttpClient {\n private baseUrl: string;\n private headers: Record<string, string>;\n\n constructor(opts: ClientOptions) {\n this.baseUrl = opts.baseUrl.replace(/\\/+$/, '') + '/v1';\n this.headers = {\n 'Authorization': `Bearer ${opts.apiKey}`,\n 'Content-Type': 'application/json',\n };\n }\n\n private async throwError(method: string, path: string, res: Response): Promise<never> {\n let detail = '';\n try { detail = `: ${await res.text()}`; } catch { /* ignore */ }\n throw new Error(`${method} ${path} failed: ${res.status} ${res.statusText}${detail}`);\n }\n\n async get<T>(path: string): Promise<T> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'GET',\n headers: this.headers,\n });\n if (!res.ok) await this.throwError('GET', path, res);\n return res.json() as Promise<T>;\n }\n\n async post<T>(path: string, body: unknown): Promise<T> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify(body),\n });\n if (!res.ok) await this.throwError('POST', path, res);\n return res.json() as Promise<T>;\n }\n\n async put(path: string, body: unknown): Promise<void> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'PUT',\n headers: this.headers,\n body: JSON.stringify(body),\n });\n if (!res.ok) await this.throwError('PUT', path, res);\n }\n\n async del(path: string): Promise<void> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'DELETE',\n headers: this.headers,\n });\n if (!res.ok) await this.throwError('DELETE', path, res);\n }\n}\n\nexport class CallsResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** Create a new outbound call. */\n async create(opts: CreateCallRequest): Promise<string> {\n const result = await this.http.post<{ sid: string }>(\n `/Accounts/${this.accountSid}/Calls`,\n opts\n );\n return result.sid;\n }\n\n /** List active calls, optionally filtered. */\n async list(filter?: ListCallsFilter): Promise<CallInfo[]> {\n const params = new URLSearchParams();\n if (filter?.direction) params.set('direction', filter.direction);\n if (filter?.from) params.set('from', filter.from);\n if (filter?.to) params.set('to', filter.to);\n if (filter?.callStatus) params.set('callStatus', filter.callStatus);\n const qs = params.toString();\n return this.http.get<CallInfo[]>(\n `/Accounts/${this.accountSid}/Calls${qs ? `?${qs}` : ''}`\n );\n }\n\n /** Get info about an active call. */\n async get(callSid: string): Promise<CallInfo> {\n return this.http.get<CallInfo>(\n `/Accounts/${this.accountSid}/Calls/${callSid}`\n );\n }\n\n /** Get count of active inbound and outbound calls. */\n async count(): Promise<CallCount> {\n return this.http.get<CallCount>(\n `/Accounts/${this.accountSid}/CallCount`\n );\n }\n\n /** Update an active call (redirect, mute, hangup, etc). */\n async update(callSid: string, opts: UpdateCallRequest): Promise<void> {\n return this.http.put(\n `/Accounts/${this.accountSid}/Calls/${callSid}`,\n opts\n );\n }\n\n /** Terminate a call. */\n async delete(callSid: string): Promise<void> {\n return this.http.del(\n `/Accounts/${this.accountSid}/Calls/${callSid}`\n );\n }\n\n /** Redirect call execution to a new webhook URL. */\n async redirect(callSid: string, hook: ActionHook): Promise<void> {\n return this.update(callSid, { call_hook: hook });\n }\n\n /** Inject a whisper verb (say/play) to one party on the call. */\n async whisper(callSid: string, verb: Verb): Promise<void> {\n return this.update(callSid, { whisper: verb });\n }\n\n /** Mute or unmute a call. */\n async mute(callSid: string, status: 'mute' | 'unmute'): Promise<void> {\n return this.update(callSid, { mute_status: status });\n }\n\n /** Send a mid-conversation update to an active agent verb. */\n async updateAgent(callSid: string, data: NonNullable<UpdateCallRequest['agent_update']>): Promise<void> {\n return this.update(callSid, { agent_update: data });\n }\n\n /** Enable or disable server-side noise isolation. */\n async noiseIsolation(\n callSid: string,\n status: 'enable' | 'disable',\n opts?: { vendor?: string; level?: number; model?: string }\n ): Promise<void> {\n return this.update(callSid, {\n noise_isolation_status: status,\n ...(opts?.vendor ? { noise_isolation_vendor: opts.vendor } : {}),\n ...(opts?.level !== undefined ? { noise_isolation_level: opts.level } : {}),\n ...(opts?.model ? { noise_isolation_model: opts.model } : {}),\n });\n }\n}\n\nexport class ConferencesResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** List active conferences. */\n async list(): Promise<string[]> {\n return this.http.get<string[]>(\n `/Accounts/${this.accountSid}/Conferences`\n );\n }\n}\n\nexport class QueuesResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** List active queues. */\n async list(search?: string): Promise<QueueInfo[]> {\n const qs = search ? `?search=${encodeURIComponent(search)}` : '';\n return this.http.get<QueueInfo[]>(\n `/Accounts/${this.accountSid}/Queues${qs}`\n );\n }\n}\n\n/**\n * REST API client for the jambonz platform.\n * Provides typed methods for creating and managing calls, conferences, and queues.\n *\n * @example\n * ```typescript\n * const client = new JambonzClient({ baseUrl: 'https://api.jambonz.us', accountSid, apiKey });\n * const callSid = await client.calls.create({ from: '+15085551212', to: { type: 'phone', number: '+15085551213' } });\n * ```\n */\nexport class JambonzClient {\n /** Active call management (create, list, update, redirect, mute, whisper, hangup). */\n readonly calls: CallsResource;\n /** Active conference listing. */\n readonly conferences: ConferencesResource;\n /** Active queue listing. */\n readonly queues: QueuesResource;\n\n /**\n * @param opts - API connection options (baseUrl, accountSid, apiKey).\n */\n constructor(opts: ClientOptions) {\n const http = new HttpClient(opts);\n this.calls = new CallsResource(http, opts.accountSid);\n this.conferences = new ConferencesResource(http, opts.accountSid);\n this.queues = new QueuesResource(http, opts.accountSid);\n }\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../../src/client/api.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * JambonzClient — REST API client for the jambonz platform.\n * Uses native fetch (Node 18+).\n */\n\nimport type {\n CallInfo,\n CallCount,\n CreateCallRequest,\n UpdateCallRequest,\n ListCallsFilter,\n QueueInfo,\n} from '../types/rest.js';\nimport type { ActionHook } from '../types/components.js';\nimport type { Verb } from '../types/verbs.js';\n\nexport interface ClientOptions {\n /** Base URL of the jambonz API (e.g. 'https://api.jambonz.us'). */\n baseUrl: string;\n /** Account SID. */\n accountSid: string;\n /** API key (Bearer token). */\n apiKey: string;\n}\n\nclass HttpClient {\n private baseUrl: string;\n private headers: Record<string, string>;\n\n constructor(opts: ClientOptions) {\n this.baseUrl = opts.baseUrl.replace(/\\/+$/, '') + '/v1';\n this.headers = {\n 'Authorization': `Bearer ${opts.apiKey}`,\n 'Content-Type': 'application/json',\n };\n }\n\n private async throwError(method: string, path: string, res: Response): Promise<never> {\n let detail = '';\n try { detail = `: ${await res.text()}`; } catch { /* ignore */ }\n throw new Error(`${method} ${path} failed: ${res.status} ${res.statusText}${detail}`);\n }\n\n async get<T>(path: string): Promise<T> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'GET',\n headers: this.headers,\n });\n if (!res.ok) await this.throwError('GET', path, res);\n return res.json() as Promise<T>;\n }\n\n async post<T>(path: string, body: unknown): Promise<T> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify(body),\n });\n if (!res.ok) await this.throwError('POST', path, res);\n return res.json() as Promise<T>;\n }\n\n async put(path: string, body: unknown): Promise<void> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'PUT',\n headers: this.headers,\n body: JSON.stringify(body),\n });\n if (!res.ok) await this.throwError('PUT', path, res);\n }\n\n async del(path: string): Promise<void> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'DELETE',\n headers: this.headers,\n });\n if (!res.ok) await this.throwError('DELETE', path, res);\n }\n}\n\nexport class CallsResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** Create a new outbound call. */\n async create(opts: CreateCallRequest): Promise<string> {\n const result = await this.http.post<{ sid: string }>(\n `/Accounts/${this.accountSid}/Calls`,\n opts\n );\n return result.sid;\n }\n\n /** List active calls, optionally filtered. */\n async list(filter?: ListCallsFilter): Promise<CallInfo[]> {\n const params = new URLSearchParams();\n if (filter?.direction) params.set('direction', filter.direction);\n if (filter?.from) params.set('from', filter.from);\n if (filter?.to) params.set('to', filter.to);\n if (filter?.callStatus) params.set('callStatus', filter.callStatus);\n const qs = params.toString();\n return this.http.get<CallInfo[]>(\n `/Accounts/${this.accountSid}/Calls${qs ? `?${qs}` : ''}`\n );\n }\n\n /** Get info about an active call. */\n async get(callSid: string): Promise<CallInfo> {\n return this.http.get<CallInfo>(\n `/Accounts/${this.accountSid}/Calls/${callSid}`\n );\n }\n\n /** Get count of active inbound and outbound calls. */\n async count(): Promise<CallCount> {\n return this.http.get<CallCount>(\n `/Accounts/${this.accountSid}/CallCount`\n );\n }\n\n /** Update an active call (redirect, mute, hangup, etc). */\n async update(callSid: string, opts: UpdateCallRequest): Promise<void> {\n return this.http.put(\n `/Accounts/${this.accountSid}/Calls/${callSid}`,\n opts\n );\n }\n\n /** Terminate a call. */\n async delete(callSid: string): Promise<void> {\n return this.http.del(\n `/Accounts/${this.accountSid}/Calls/${callSid}`\n );\n }\n\n /** Redirect call execution to a new webhook URL. */\n async redirect(callSid: string, hook: ActionHook): Promise<void> {\n return this.update(callSid, { call_hook: hook });\n }\n\n /** Inject a whisper verb (say/play) to one party on the call. */\n async whisper(callSid: string, verb: Verb): Promise<void> {\n return this.update(callSid, { whisper: verb });\n }\n\n /** Mute or unmute a call. */\n async mute(callSid: string, status: 'mute' | 'unmute'): Promise<void> {\n return this.update(callSid, { mute_status: status });\n }\n\n /** Send a mid-conversation update to an active agent verb. */\n async updateAgent(callSid: string, data: NonNullable<UpdateCallRequest['agent_update']>): Promise<void> {\n return this.update(callSid, { agent_update: data });\n }\n\n /** Redirect the in-progress call to a packaged transfer (blind or warm). */\n async transfer(callSid: string, opts: NonNullable<UpdateCallRequest['transfer']>): Promise<void> {\n return this.update(callSid, { transfer: opts });\n }\n\n /** Enable or disable server-side noise isolation. */\n async noiseIsolation(\n callSid: string,\n status: 'enable' | 'disable',\n opts?: { vendor?: string; level?: number; model?: string }\n ): Promise<void> {\n return this.update(callSid, {\n noise_isolation_status: status,\n ...(opts?.vendor ? { noise_isolation_vendor: opts.vendor } : {}),\n ...(opts?.level !== undefined ? { noise_isolation_level: opts.level } : {}),\n ...(opts?.model ? { noise_isolation_model: opts.model } : {}),\n });\n }\n}\n\nexport class ConferencesResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** List active conferences. */\n async list(): Promise<string[]> {\n return this.http.get<string[]>(\n `/Accounts/${this.accountSid}/Conferences`\n );\n }\n}\n\nexport class QueuesResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** List active queues. */\n async list(search?: string): Promise<QueueInfo[]> {\n const qs = search ? `?search=${encodeURIComponent(search)}` : '';\n return this.http.get<QueueInfo[]>(\n `/Accounts/${this.accountSid}/Queues${qs}`\n );\n }\n}\n\n/**\n * REST API client for the jambonz platform.\n * Provides typed methods for creating and managing calls, conferences, and queues.\n *\n * @example\n * ```typescript\n * const client = new JambonzClient({ baseUrl: 'https://api.jambonz.us', accountSid, apiKey });\n * const callSid = await client.calls.create({ from: '+15085551212', to: { type: 'phone', number: '+15085551213' } });\n * ```\n */\nexport class JambonzClient {\n /** Active call management (create, list, update, redirect, mute, whisper, hangup). */\n readonly calls: CallsResource;\n /** Active conference listing. */\n readonly conferences: ConferencesResource;\n /** Active queue listing. */\n readonly queues: QueuesResource;\n\n /**\n * @param opts - API connection options (baseUrl, accountSid, apiKey).\n */\n constructor(opts: ClientOptions) {\n const http = new HttpClient(opts);\n this.calls = new CallsResource(http, opts.accountSid);\n this.conferences = new ConferencesResource(http, opts.accountSid);\n this.queues = new QueuesResource(http, opts.accountSid);\n }\n}\n"]}
|
package/dist/client/index.d.cts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { b as CreateCallRequest, L as ListCallsFilter, a as CallInfo, C as CallCount, U as UpdateCallRequest, Q as QueueInfo } from '../rest-
|
|
2
|
-
import { A as ActionHook,
|
|
1
|
+
import { b as CreateCallRequest, L as ListCallsFilter, a as CallInfo, C as CallCount, U as UpdateCallRequest, Q as QueueInfo } from '../rest-C4J_YJN5.cjs';
|
|
2
|
+
import { A as ActionHook, $ as Verb } from '../verbs-DXbSDMKR.cjs';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
5
|
* JambonzClient — REST API client for the jambonz platform.
|
|
@@ -48,6 +48,8 @@ declare class CallsResource {
|
|
|
48
48
|
mute(callSid: string, status: 'mute' | 'unmute'): Promise<void>;
|
|
49
49
|
/** Send a mid-conversation update to an active agent verb. */
|
|
50
50
|
updateAgent(callSid: string, data: NonNullable<UpdateCallRequest['agent_update']>): Promise<void>;
|
|
51
|
+
/** Redirect the in-progress call to a packaged transfer (blind or warm). */
|
|
52
|
+
transfer(callSid: string, opts: NonNullable<UpdateCallRequest['transfer']>): Promise<void>;
|
|
51
53
|
/** Enable or disable server-side noise isolation. */
|
|
52
54
|
noiseIsolation(callSid: string, status: 'enable' | 'disable', opts?: {
|
|
53
55
|
vendor?: string;
|
package/dist/client/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { b as CreateCallRequest, L as ListCallsFilter, a as CallInfo, C as CallCount, U as UpdateCallRequest, Q as QueueInfo } from '../rest-
|
|
2
|
-
import { A as ActionHook,
|
|
1
|
+
import { b as CreateCallRequest, L as ListCallsFilter, a as CallInfo, C as CallCount, U as UpdateCallRequest, Q as QueueInfo } from '../rest-DVExRUxz.js';
|
|
2
|
+
import { A as ActionHook, $ as Verb } from '../verbs-DXbSDMKR.js';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
5
|
* JambonzClient — REST API client for the jambonz platform.
|
|
@@ -48,6 +48,8 @@ declare class CallsResource {
|
|
|
48
48
|
mute(callSid: string, status: 'mute' | 'unmute'): Promise<void>;
|
|
49
49
|
/** Send a mid-conversation update to an active agent verb. */
|
|
50
50
|
updateAgent(callSid: string, data: NonNullable<UpdateCallRequest['agent_update']>): Promise<void>;
|
|
51
|
+
/** Redirect the in-progress call to a packaged transfer (blind or warm). */
|
|
52
|
+
transfer(callSid: string, opts: NonNullable<UpdateCallRequest['transfer']>): Promise<void>;
|
|
51
53
|
/** Enable or disable server-side noise isolation. */
|
|
52
54
|
noiseIsolation(callSid: string, status: 'enable' | 'disable', opts?: {
|
|
53
55
|
vendor?: string;
|
package/dist/client/index.js
CHANGED
|
@@ -118,6 +118,10 @@ var CallsResource = class {
|
|
|
118
118
|
async updateAgent(callSid, data) {
|
|
119
119
|
return this.update(callSid, { agent_update: data });
|
|
120
120
|
}
|
|
121
|
+
/** Redirect the in-progress call to a packaged transfer (blind or warm). */
|
|
122
|
+
async transfer(callSid, opts) {
|
|
123
|
+
return this.update(callSid, { transfer: opts });
|
|
124
|
+
}
|
|
121
125
|
/** Enable or disable server-side noise isolation. */
|
|
122
126
|
async noiseIsolation(callSid, status, opts) {
|
|
123
127
|
return this.update(callSid, {
|
package/dist/client/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/client/api.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * JambonzClient — REST API client for the jambonz platform.\n * Uses native fetch (Node 18+).\n */\n\nimport type {\n CallInfo,\n CallCount,\n CreateCallRequest,\n UpdateCallRequest,\n ListCallsFilter,\n QueueInfo,\n} from '../types/rest.js';\nimport type { ActionHook } from '../types/components.js';\nimport type { Verb } from '../types/verbs.js';\n\nexport interface ClientOptions {\n /** Base URL of the jambonz API (e.g. 'https://api.jambonz.us'). */\n baseUrl: string;\n /** Account SID. */\n accountSid: string;\n /** API key (Bearer token). */\n apiKey: string;\n}\n\nclass HttpClient {\n private baseUrl: string;\n private headers: Record<string, string>;\n\n constructor(opts: ClientOptions) {\n this.baseUrl = opts.baseUrl.replace(/\\/+$/, '') + '/v1';\n this.headers = {\n 'Authorization': `Bearer ${opts.apiKey}`,\n 'Content-Type': 'application/json',\n };\n }\n\n private async throwError(method: string, path: string, res: Response): Promise<never> {\n let detail = '';\n try { detail = `: ${await res.text()}`; } catch { /* ignore */ }\n throw new Error(`${method} ${path} failed: ${res.status} ${res.statusText}${detail}`);\n }\n\n async get<T>(path: string): Promise<T> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'GET',\n headers: this.headers,\n });\n if (!res.ok) await this.throwError('GET', path, res);\n return res.json() as Promise<T>;\n }\n\n async post<T>(path: string, body: unknown): Promise<T> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify(body),\n });\n if (!res.ok) await this.throwError('POST', path, res);\n return res.json() as Promise<T>;\n }\n\n async put(path: string, body: unknown): Promise<void> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'PUT',\n headers: this.headers,\n body: JSON.stringify(body),\n });\n if (!res.ok) await this.throwError('PUT', path, res);\n }\n\n async del(path: string): Promise<void> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'DELETE',\n headers: this.headers,\n });\n if (!res.ok) await this.throwError('DELETE', path, res);\n }\n}\n\nexport class CallsResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** Create a new outbound call. */\n async create(opts: CreateCallRequest): Promise<string> {\n const result = await this.http.post<{ sid: string }>(\n `/Accounts/${this.accountSid}/Calls`,\n opts\n );\n return result.sid;\n }\n\n /** List active calls, optionally filtered. */\n async list(filter?: ListCallsFilter): Promise<CallInfo[]> {\n const params = new URLSearchParams();\n if (filter?.direction) params.set('direction', filter.direction);\n if (filter?.from) params.set('from', filter.from);\n if (filter?.to) params.set('to', filter.to);\n if (filter?.callStatus) params.set('callStatus', filter.callStatus);\n const qs = params.toString();\n return this.http.get<CallInfo[]>(\n `/Accounts/${this.accountSid}/Calls${qs ? `?${qs}` : ''}`\n );\n }\n\n /** Get info about an active call. */\n async get(callSid: string): Promise<CallInfo> {\n return this.http.get<CallInfo>(\n `/Accounts/${this.accountSid}/Calls/${callSid}`\n );\n }\n\n /** Get count of active inbound and outbound calls. */\n async count(): Promise<CallCount> {\n return this.http.get<CallCount>(\n `/Accounts/${this.accountSid}/CallCount`\n );\n }\n\n /** Update an active call (redirect, mute, hangup, etc). */\n async update(callSid: string, opts: UpdateCallRequest): Promise<void> {\n return this.http.put(\n `/Accounts/${this.accountSid}/Calls/${callSid}`,\n opts\n );\n }\n\n /** Terminate a call. */\n async delete(callSid: string): Promise<void> {\n return this.http.del(\n `/Accounts/${this.accountSid}/Calls/${callSid}`\n );\n }\n\n /** Redirect call execution to a new webhook URL. */\n async redirect(callSid: string, hook: ActionHook): Promise<void> {\n return this.update(callSid, { call_hook: hook });\n }\n\n /** Inject a whisper verb (say/play) to one party on the call. */\n async whisper(callSid: string, verb: Verb): Promise<void> {\n return this.update(callSid, { whisper: verb });\n }\n\n /** Mute or unmute a call. */\n async mute(callSid: string, status: 'mute' | 'unmute'): Promise<void> {\n return this.update(callSid, { mute_status: status });\n }\n\n /** Send a mid-conversation update to an active agent verb. */\n async updateAgent(callSid: string, data: NonNullable<UpdateCallRequest['agent_update']>): Promise<void> {\n return this.update(callSid, { agent_update: data });\n }\n\n /** Enable or disable server-side noise isolation. */\n async noiseIsolation(\n callSid: string,\n status: 'enable' | 'disable',\n opts?: { vendor?: string; level?: number; model?: string }\n ): Promise<void> {\n return this.update(callSid, {\n noise_isolation_status: status,\n ...(opts?.vendor ? { noise_isolation_vendor: opts.vendor } : {}),\n ...(opts?.level !== undefined ? { noise_isolation_level: opts.level } : {}),\n ...(opts?.model ? { noise_isolation_model: opts.model } : {}),\n });\n }\n}\n\nexport class ConferencesResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** List active conferences. */\n async list(): Promise<string[]> {\n return this.http.get<string[]>(\n `/Accounts/${this.accountSid}/Conferences`\n );\n }\n}\n\nexport class QueuesResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** List active queues. */\n async list(search?: string): Promise<QueueInfo[]> {\n const qs = search ? `?search=${encodeURIComponent(search)}` : '';\n return this.http.get<QueueInfo[]>(\n `/Accounts/${this.accountSid}/Queues${qs}`\n );\n }\n}\n\n/**\n * REST API client for the jambonz platform.\n * Provides typed methods for creating and managing calls, conferences, and queues.\n *\n * @example\n * ```typescript\n * const client = new JambonzClient({ baseUrl: 'https://api.jambonz.us', accountSid, apiKey });\n * const callSid = await client.calls.create({ from: '+15085551212', to: { type: 'phone', number: '+15085551213' } });\n * ```\n */\nexport class JambonzClient {\n /** Active call management (create, list, update, redirect, mute, whisper, hangup). */\n readonly calls: CallsResource;\n /** Active conference listing. */\n readonly conferences: ConferencesResource;\n /** Active queue listing. */\n readonly queues: QueuesResource;\n\n /**\n * @param opts - API connection options (baseUrl, accountSid, apiKey).\n */\n constructor(opts: ClientOptions) {\n const http = new HttpClient(opts);\n this.calls = new CallsResource(http, opts.accountSid);\n this.conferences = new ConferencesResource(http, opts.accountSid);\n this.queues = new QueuesResource(http, opts.accountSid);\n }\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../../src/client/api.ts"],"names":[],"mappings":";AAyBA,IAAM,aAAN,MAAiB;AAAA,EACP,OAAA;AAAA,EACA,OAAA;AAAA,EAER,YAAY,IAAA,EAAqB;AAC/B,IAAA,IAAA,CAAK,UAAU,IAAA,CAAK,OAAA,CAAQ,OAAA,CAAQ,MAAA,EAAQ,EAAE,CAAA,GAAI,KAAA;AAClD,IAAA,IAAA,CAAK,OAAA,GAAU;AAAA,MACb,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,MAAM,CAAA,CAAA;AAAA,MACtC,cAAA,EAAgB;AAAA,KAClB;AAAA,EACF;AAAA,EAEA,MAAc,UAAA,CAAW,MAAA,EAAgB,IAAA,EAAc,GAAA,EAA+B;AACpF,IAAA,IAAI,MAAA,GAAS,EAAA;AACb,IAAA,IAAI;AAAE,MAAA,MAAA,GAAS,CAAA,EAAA,EAAK,MAAM,GAAA,CAAI,IAAA,EAAM,CAAA,CAAA;AAAA,IAAI,CAAA,CAAA,MAAQ;AAAA,IAAe;AAC/D,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,EAAG,MAAM,IAAI,IAAI,CAAA,SAAA,EAAY,GAAA,CAAI,MAAM,CAAA,CAAA,EAAI,GAAA,CAAI,UAAU,CAAA,EAAG,MAAM,CAAA,CAAE,CAAA;AAAA,EACtF;AAAA,EAEA,MAAM,IAAO,IAAA,EAA0B;AACrC,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,EAAG,KAAK,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,MAChD,MAAA,EAAQ,KAAA;AAAA,MACR,SAAS,IAAA,CAAK;AAAA,KACf,CAAA;AACD,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI,MAAM,KAAK,UAAA,CAAW,KAAA,EAAO,MAAM,GAAG,CAAA;AACnD,IAAA,OAAO,IAAI,IAAA,EAAK;AAAA,EAClB;AAAA,EAEA,MAAM,IAAA,CAAQ,IAAA,EAAc,IAAA,EAA2B;AACrD,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,EAAG,KAAK,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,MAChD,MAAA,EAAQ,MAAA;AAAA,MACR,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,KAC1B,CAAA;AACD,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI,MAAM,KAAK,UAAA,CAAW,MAAA,EAAQ,MAAM,GAAG,CAAA;AACpD,IAAA,OAAO,IAAI,IAAA,EAAK;AAAA,EAClB;AAAA,EAEA,MAAM,GAAA,CAAI,IAAA,EAAc,IAAA,EAA8B;AACpD,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,EAAG,KAAK,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,MAChD,MAAA,EAAQ,KAAA;AAAA,MACR,SAAS,IAAA,CAAK,OAAA;AAAA,MACd,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,KAC1B,CAAA;AACD,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI,MAAM,KAAK,UAAA,CAAW,KAAA,EAAO,MAAM,GAAG,CAAA;AAAA,EACrD;AAAA,EAEA,MAAM,IAAI,IAAA,EAA6B;AACrC,IAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,CAAA,EAAG,KAAK,OAAO,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI;AAAA,MAChD,MAAA,EAAQ,QAAA;AAAA,MACR,SAAS,IAAA,CAAK;AAAA,KACf,CAAA;AACD,IAAA,IAAI,CAAC,IAAI,EAAA,EAAI,MAAM,KAAK,UAAA,CAAW,QAAA,EAAU,MAAM,GAAG,CAAA;AAAA,EACxD;AACF,CAAA;AAEO,IAAM,gBAAN,MAAoB;AAAA,EACzB,WAAA,CAAoB,MAA0B,UAAA,EAAoB;AAA9C,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAA0B,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAAA,EAAqB;AAAA,EAA/C,IAAA;AAAA,EAA0B,UAAA;AAAA;AAAA,EAG9C,MAAM,OAAO,IAAA,EAA0C;AACrD,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,IAAA,CAAK,IAAA;AAAA,MAC7B,CAAA,UAAA,EAAa,KAAK,UAAU,CAAA,MAAA,CAAA;AAAA,MAC5B;AAAA,KACF;AACA,IAAA,OAAO,MAAA,CAAO,GAAA;AAAA,EAChB;AAAA;AAAA,EAGA,MAAM,KAAK,MAAA,EAA+C;AACxD,IAAA,MAAM,MAAA,GAAS,IAAI,eAAA,EAAgB;AACnC,IAAA,IAAI,QAAQ,SAAA,EAAW,MAAA,CAAO,GAAA,CAAI,WAAA,EAAa,OAAO,SAAS,CAAA;AAC/D,IAAA,IAAI,QAAQ,IAAA,EAAM,MAAA,CAAO,GAAA,CAAI,MAAA,EAAQ,OAAO,IAAI,CAAA;AAChD,IAAA,IAAI,QAAQ,EAAA,EAAI,MAAA,CAAO,GAAA,CAAI,IAAA,EAAM,OAAO,EAAE,CAAA;AAC1C,IAAA,IAAI,QAAQ,UAAA,EAAY,MAAA,CAAO,GAAA,CAAI,YAAA,EAAc,OAAO,UAAU,CAAA;AAClE,IAAA,MAAM,EAAA,GAAK,OAAO,QAAA,EAAS;AAC3B,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA;AAAA,MACf,CAAA,UAAA,EAAa,KAAK,UAAU,CAAA,MAAA,EAAS,KAAK,CAAA,CAAA,EAAI,EAAE,KAAK,EAAE,CAAA;AAAA,KACzD;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,IAAI,OAAA,EAAoC;AAC5C,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA;AAAA,MACf,CAAA,UAAA,EAAa,IAAA,CAAK,UAAU,CAAA,OAAA,EAAU,OAAO,CAAA;AAAA,KAC/C;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,KAAA,GAA4B;AAChC,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA;AAAA,MACf,CAAA,UAAA,EAAa,KAAK,UAAU,CAAA,UAAA;AAAA,KAC9B;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,OAAA,EAAiB,IAAA,EAAwC;AACpE,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA;AAAA,MACf,CAAA,UAAA,EAAa,IAAA,CAAK,UAAU,CAAA,OAAA,EAAU,OAAO,CAAA,CAAA;AAAA,MAC7C;AAAA,KACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,OAAO,OAAA,EAAgC;AAC3C,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA;AAAA,MACf,CAAA,UAAA,EAAa,IAAA,CAAK,UAAU,CAAA,OAAA,EAAU,OAAO,CAAA;AAAA,KAC/C;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,QAAA,CAAS,OAAA,EAAiB,IAAA,EAAiC;AAC/D,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA,EAAS,EAAE,SAAA,EAAW,MAAM,CAAA;AAAA,EACjD;AAAA;AAAA,EAGA,MAAM,OAAA,CAAQ,OAAA,EAAiB,IAAA,EAA2B;AACxD,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA,EAAS,EAAE,OAAA,EAAS,MAAM,CAAA;AAAA,EAC/C;AAAA;AAAA,EAGA,MAAM,IAAA,CAAK,OAAA,EAAiB,MAAA,EAA0C;AACpE,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA,EAAS,EAAE,WAAA,EAAa,QAAQ,CAAA;AAAA,EACrD;AAAA;AAAA,EAGA,MAAM,WAAA,CAAY,OAAA,EAAiB,IAAA,EAAqE;AACtG,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA,EAAS,EAAE,YAAA,EAAc,MAAM,CAAA;AAAA,EACpD;AAAA;AAAA,EAGA,MAAM,QAAA,CAAS,OAAA,EAAiB,IAAA,EAAiE;AAC/F,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA,EAAS,EAAE,QAAA,EAAU,MAAM,CAAA;AAAA,EAChD;AAAA;AAAA,EAGA,MAAM,cAAA,CACJ,OAAA,EACA,MAAA,EACA,IAAA,EACe;AACf,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,EAAS;AAAA,MAC1B,sBAAA,EAAwB,MAAA;AAAA,MACxB,GAAI,MAAM,MAAA,GAAS,EAAE,wBAAwB,IAAA,CAAK,MAAA,KAAW,EAAC;AAAA,MAC9D,GAAI,MAAM,KAAA,KAAU,MAAA,GAAY,EAAE,qBAAA,EAAuB,IAAA,CAAK,KAAA,EAAM,GAAI,EAAC;AAAA,MACzE,GAAI,MAAM,KAAA,GAAQ,EAAE,uBAAuB,IAAA,CAAK,KAAA,KAAU;AAAC,KAC5D,CAAA;AAAA,EACH;AACF;AAEO,IAAM,sBAAN,MAA0B;AAAA,EAC/B,WAAA,CAAoB,MAA0B,UAAA,EAAoB;AAA9C,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAA0B,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAAA,EAAqB;AAAA,EAA/C,IAAA;AAAA,EAA0B,UAAA;AAAA;AAAA,EAG9C,MAAM,IAAA,GAA0B;AAC9B,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA;AAAA,MACf,CAAA,UAAA,EAAa,KAAK,UAAU,CAAA,YAAA;AAAA,KAC9B;AAAA,EACF;AACF;AAEO,IAAM,iBAAN,MAAqB;AAAA,EAC1B,WAAA,CAAoB,MAA0B,UAAA,EAAoB;AAA9C,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAA0B,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AAAA,EAAqB;AAAA,EAA/C,IAAA;AAAA,EAA0B,UAAA;AAAA;AAAA,EAG9C,MAAM,KAAK,MAAA,EAAuC;AAChD,IAAA,MAAM,KAAK,MAAA,GAAS,CAAA,QAAA,EAAW,kBAAA,CAAmB,MAAM,CAAC,CAAA,CAAA,GAAK,EAAA;AAC9D,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA;AAAA,MACf,CAAA,UAAA,EAAa,IAAA,CAAK,UAAU,CAAA,OAAA,EAAU,EAAE,CAAA;AAAA,KAC1C;AAAA,EACF;AACF;AAYO,IAAM,gBAAN,MAAoB;AAAA;AAAA,EAEhB,KAAA;AAAA;AAAA,EAEA,WAAA;AAAA;AAAA,EAEA,MAAA;AAAA;AAAA;AAAA;AAAA,EAKT,YAAY,IAAA,EAAqB;AAC/B,IAAA,MAAM,IAAA,GAAO,IAAI,UAAA,CAAW,IAAI,CAAA;AAChC,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAI,aAAA,CAAc,IAAA,EAAM,KAAK,UAAU,CAAA;AACpD,IAAA,IAAA,CAAK,WAAA,GAAc,IAAI,mBAAA,CAAoB,IAAA,EAAM,KAAK,UAAU,CAAA;AAChE,IAAA,IAAA,CAAK,MAAA,GAAS,IAAI,cAAA,CAAe,IAAA,EAAM,KAAK,UAAU,CAAA;AAAA,EACxD;AACF","file":"index.js","sourcesContent":["/**\n * JambonzClient — REST API client for the jambonz platform.\n * Uses native fetch (Node 18+).\n */\n\nimport type {\n CallInfo,\n CallCount,\n CreateCallRequest,\n UpdateCallRequest,\n ListCallsFilter,\n QueueInfo,\n} from '../types/rest.js';\nimport type { ActionHook } from '../types/components.js';\nimport type { Verb } from '../types/verbs.js';\n\nexport interface ClientOptions {\n /** Base URL of the jambonz API (e.g. 'https://api.jambonz.us'). */\n baseUrl: string;\n /** Account SID. */\n accountSid: string;\n /** API key (Bearer token). */\n apiKey: string;\n}\n\nclass HttpClient {\n private baseUrl: string;\n private headers: Record<string, string>;\n\n constructor(opts: ClientOptions) {\n this.baseUrl = opts.baseUrl.replace(/\\/+$/, '') + '/v1';\n this.headers = {\n 'Authorization': `Bearer ${opts.apiKey}`,\n 'Content-Type': 'application/json',\n };\n }\n\n private async throwError(method: string, path: string, res: Response): Promise<never> {\n let detail = '';\n try { detail = `: ${await res.text()}`; } catch { /* ignore */ }\n throw new Error(`${method} ${path} failed: ${res.status} ${res.statusText}${detail}`);\n }\n\n async get<T>(path: string): Promise<T> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'GET',\n headers: this.headers,\n });\n if (!res.ok) await this.throwError('GET', path, res);\n return res.json() as Promise<T>;\n }\n\n async post<T>(path: string, body: unknown): Promise<T> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'POST',\n headers: this.headers,\n body: JSON.stringify(body),\n });\n if (!res.ok) await this.throwError('POST', path, res);\n return res.json() as Promise<T>;\n }\n\n async put(path: string, body: unknown): Promise<void> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'PUT',\n headers: this.headers,\n body: JSON.stringify(body),\n });\n if (!res.ok) await this.throwError('PUT', path, res);\n }\n\n async del(path: string): Promise<void> {\n const res = await fetch(`${this.baseUrl}${path}`, {\n method: 'DELETE',\n headers: this.headers,\n });\n if (!res.ok) await this.throwError('DELETE', path, res);\n }\n}\n\nexport class CallsResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** Create a new outbound call. */\n async create(opts: CreateCallRequest): Promise<string> {\n const result = await this.http.post<{ sid: string }>(\n `/Accounts/${this.accountSid}/Calls`,\n opts\n );\n return result.sid;\n }\n\n /** List active calls, optionally filtered. */\n async list(filter?: ListCallsFilter): Promise<CallInfo[]> {\n const params = new URLSearchParams();\n if (filter?.direction) params.set('direction', filter.direction);\n if (filter?.from) params.set('from', filter.from);\n if (filter?.to) params.set('to', filter.to);\n if (filter?.callStatus) params.set('callStatus', filter.callStatus);\n const qs = params.toString();\n return this.http.get<CallInfo[]>(\n `/Accounts/${this.accountSid}/Calls${qs ? `?${qs}` : ''}`\n );\n }\n\n /** Get info about an active call. */\n async get(callSid: string): Promise<CallInfo> {\n return this.http.get<CallInfo>(\n `/Accounts/${this.accountSid}/Calls/${callSid}`\n );\n }\n\n /** Get count of active inbound and outbound calls. */\n async count(): Promise<CallCount> {\n return this.http.get<CallCount>(\n `/Accounts/${this.accountSid}/CallCount`\n );\n }\n\n /** Update an active call (redirect, mute, hangup, etc). */\n async update(callSid: string, opts: UpdateCallRequest): Promise<void> {\n return this.http.put(\n `/Accounts/${this.accountSid}/Calls/${callSid}`,\n opts\n );\n }\n\n /** Terminate a call. */\n async delete(callSid: string): Promise<void> {\n return this.http.del(\n `/Accounts/${this.accountSid}/Calls/${callSid}`\n );\n }\n\n /** Redirect call execution to a new webhook URL. */\n async redirect(callSid: string, hook: ActionHook): Promise<void> {\n return this.update(callSid, { call_hook: hook });\n }\n\n /** Inject a whisper verb (say/play) to one party on the call. */\n async whisper(callSid: string, verb: Verb): Promise<void> {\n return this.update(callSid, { whisper: verb });\n }\n\n /** Mute or unmute a call. */\n async mute(callSid: string, status: 'mute' | 'unmute'): Promise<void> {\n return this.update(callSid, { mute_status: status });\n }\n\n /** Send a mid-conversation update to an active agent verb. */\n async updateAgent(callSid: string, data: NonNullable<UpdateCallRequest['agent_update']>): Promise<void> {\n return this.update(callSid, { agent_update: data });\n }\n\n /** Redirect the in-progress call to a packaged transfer (blind or warm). */\n async transfer(callSid: string, opts: NonNullable<UpdateCallRequest['transfer']>): Promise<void> {\n return this.update(callSid, { transfer: opts });\n }\n\n /** Enable or disable server-side noise isolation. */\n async noiseIsolation(\n callSid: string,\n status: 'enable' | 'disable',\n opts?: { vendor?: string; level?: number; model?: string }\n ): Promise<void> {\n return this.update(callSid, {\n noise_isolation_status: status,\n ...(opts?.vendor ? { noise_isolation_vendor: opts.vendor } : {}),\n ...(opts?.level !== undefined ? { noise_isolation_level: opts.level } : {}),\n ...(opts?.model ? { noise_isolation_model: opts.model } : {}),\n });\n }\n}\n\nexport class ConferencesResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** List active conferences. */\n async list(): Promise<string[]> {\n return this.http.get<string[]>(\n `/Accounts/${this.accountSid}/Conferences`\n );\n }\n}\n\nexport class QueuesResource {\n constructor(private http: HttpClient, private accountSid: string) {}\n\n /** List active queues. */\n async list(search?: string): Promise<QueueInfo[]> {\n const qs = search ? `?search=${encodeURIComponent(search)}` : '';\n return this.http.get<QueueInfo[]>(\n `/Accounts/${this.accountSid}/Queues${qs}`\n );\n }\n}\n\n/**\n * REST API client for the jambonz platform.\n * Provides typed methods for creating and managing calls, conferences, and queues.\n *\n * @example\n * ```typescript\n * const client = new JambonzClient({ baseUrl: 'https://api.jambonz.us', accountSid, apiKey });\n * const callSid = await client.calls.create({ from: '+15085551212', to: { type: 'phone', number: '+15085551213' } });\n * ```\n */\nexport class JambonzClient {\n /** Active call management (create, list, update, redirect, mute, whisper, hangup). */\n readonly calls: CallsResource;\n /** Active conference listing. */\n readonly conferences: ConferencesResource;\n /** Active queue listing. */\n readonly queues: QueuesResource;\n\n /**\n * @param opts - API connection options (baseUrl, accountSid, apiKey).\n */\n constructor(opts: ClientOptions) {\n const http = new HttpClient(opts);\n this.calls = new CallsResource(http, opts.accountSid);\n this.conferences = new ConferencesResource(http, opts.accountSid);\n this.queues = new QueuesResource(http, opts.accountSid);\n }\n}\n"]}
|
package/dist/index.cjs
CHANGED
|
@@ -233,6 +233,10 @@ var VerbBuilder = class {
|
|
|
233
233
|
sipRefer(opts) {
|
|
234
234
|
return this.addVerb({ verb: "sip:refer", ...opts });
|
|
235
235
|
}
|
|
236
|
+
/** Transfer the caller to a destination (blind, or warm parked/three-way) with built-in failure handling. */
|
|
237
|
+
transfer(opts) {
|
|
238
|
+
return this.addVerb({ verb: "transfer", ...opts });
|
|
239
|
+
}
|
|
236
240
|
// --- Utility ---
|
|
237
241
|
/** Set session-level defaults (TTS vendor/voice, STT vendor, VAD, etc.). */
|
|
238
242
|
config(opts) {
|
|
@@ -563,6 +567,11 @@ var Session = class extends events.EventEmitter {
|
|
|
563
567
|
this.builder.sipRefer(opts);
|
|
564
568
|
return this;
|
|
565
569
|
}
|
|
570
|
+
/** Transfer the caller to a destination (blind, or warm parked/three-way) with built-in failure handling. */
|
|
571
|
+
transfer(opts) {
|
|
572
|
+
this.builder.transfer(opts);
|
|
573
|
+
return this;
|
|
574
|
+
}
|
|
566
575
|
/** Set session-level defaults (TTS vendor/voice, STT vendor, VAD, etc.). */
|
|
567
576
|
config(opts) {
|
|
568
577
|
this.builder.config(opts);
|
|
@@ -891,16 +900,20 @@ var Session = class extends events.EventEmitter {
|
|
|
891
900
|
switch (type) {
|
|
892
901
|
case "verb:hook":
|
|
893
902
|
case "session:redirect":
|
|
894
|
-
case "dial:confirm":
|
|
903
|
+
case "dial:confirm": {
|
|
895
904
|
this.msgid = msgid;
|
|
905
|
+
const isNotification = type === "verb:hook" && !!data && typeof data === "object" && typeof data.event === "string";
|
|
896
906
|
if (hook && this.listenerCount(hook) > 0) {
|
|
897
907
|
this.emit(hook, data);
|
|
908
|
+
if (isNotification) this.reply();
|
|
898
909
|
} else if (type === "verb:hook" && this.listenerCount("verb:hook") > 0) {
|
|
899
910
|
this.emit("verb:hook", hook, data);
|
|
911
|
+
if (isNotification) this.reply();
|
|
900
912
|
} else {
|
|
901
913
|
this.reply();
|
|
902
914
|
}
|
|
903
915
|
break;
|
|
916
|
+
}
|
|
904
917
|
case "llm:event":
|
|
905
918
|
case "llm:tool-call":
|
|
906
919
|
case "agent:event":
|
|
@@ -1372,6 +1385,10 @@ var CallsResource = class {
|
|
|
1372
1385
|
async updateAgent(callSid, data) {
|
|
1373
1386
|
return this.update(callSid, { agent_update: data });
|
|
1374
1387
|
}
|
|
1388
|
+
/** Redirect the in-progress call to a packaged transfer (blind or warm). */
|
|
1389
|
+
async transfer(callSid, opts) {
|
|
1390
|
+
return this.update(callSid, { transfer: opts });
|
|
1391
|
+
}
|
|
1375
1392
|
/** Enable or disable server-side noise isolation. */
|
|
1376
1393
|
async noiseIsolation(callSid, status, opts) {
|
|
1377
1394
|
return this.update(callSid, {
|