phonic 0.16.2 → 0.17.0

package/README.md

@@ -10,8 +10,10 @@ Node.js library for the Phonic API.
   - [Get conversation by id](#get-conversation-by-id)
   - [Get conversation by external id](#get-conversation-by-external-id)
   - [List conversations](#list-conversations)
-  - [Speech-to-speech via WebSocket](#speech-to-speech-via-websocket)
+  - [STS outbound call](#sts-outbound-call)
+  - [STS via WebSocket](#sts-via-websocket)
     - [Messages that Phonic sends back to you](#messages-that-phonic-sends-back-to-you)
+  
 
 ## Installation
 
@@ -45,7 +47,7 @@ if (error === null) {
 ### Get voice by id
 
 ```ts
-const { data, error } = await phonic.voices.get("meredith");
+const { data, error } = await phonic.voices.get("greta");
 
 if (error === null) {
   console.log(data.voice);
@@ -91,7 +93,25 @@ if (error === null) {
 }
 ```
 
-### Speech-to-speech via WebSocket
+### STS outbound call
+
+```ts
+const { data, error } = await phonic.sts.outboundCall("+19189396241", {
+  welcome_message: "Hello, how can I help you?",
+
+  // Optional fields
+  project: "main",
+  system_prompt: "You are a helpful assistant.",
+  voice_id: "greta",
+  enable_silent_audio_fallback: true,
+  vad_prebuffer_duration_ms: 1800,
+  vad_min_speech_duration_ms: 40,
+  vad_min_silence_duration_ms: 550,
+  vad_threshold: 0.6,
+})
+```
+
+### STS via WebSocket
 
 To start a conversation, open a WebSocket connection:
 
@@ -103,8 +123,13 @@ const phonicWebSocket = phonic.sts.websocket({
   project: "main",
   system_prompt: "You are a helpful assistant.",
   welcome_message: "Hello, how can I help you?",
-  voice_id: "meredith",
-  output_format: "mulaw_8000"
+  voice_id: "greta",
+  output_format: "mulaw_8000",
+  enable_silent_audio_fallback: true,
+  vad_prebuffer_duration_ms: 1800,
+  vad_min_speech_duration_ms: 40,
+  vad_min_silence_duration_ms: 550,
+  vad_threshold: 0.6,
 });
 ```
 

package/dist/index.d.mts

@@ -7,6 +7,9 @@ type PhonicConfig = {
 };
 type FetchOptions = {
     method: "GET";
+} | {
+    method: "POST";
+    body: string;
 };
 type ErrorResponse = {
     message: string;
@@ -84,6 +87,10 @@ type PhonicSTSConfig = {
     voice_id?: string;
     output_format?: "pcm_44100" | "mulaw_8000";
     enable_silent_audio_fallback?: boolean;
+    vad_prebuffer_duration_ms?: number;
+    vad_min_speech_duration_ms?: number;
+    vad_min_silence_duration_ms?: number;
+    vad_threshold?: number;
 };
 type PhonicSTSWebSocketResponseMessage = {
     type: "ready_to_start_conversation";
@@ -117,6 +124,12 @@ type PhonicSTSWebSocketResponseMessage = {
 type OnMessageCallback = (message: PhonicSTSWebSocketResponseMessage) => void;
 type OnCloseCallback = (event: WebSocket.CloseEvent) => void;
 type OnErrorCallback = (event: WebSocket.ErrorEvent) => void;
+type PhonicSTSOutboundCallConfig = Omit<PhonicSTSConfig, "input_format" | "output_format"> & {
+    welcome_message: string;
+};
+type OutboundCallSuccessResponse = {
+    success: true;
+};
 
 declare class PhonicSTSWebSocket {
     private readonly ws;
@@ -146,6 +159,7 @@ declare class SpeechToSpeech {
     private readonly phonic;
     constructor(phonic: Phonic);
     websocket(config: PhonicSTSConfig): PhonicSTSWebSocket;
+    outboundCall(toPhoneNumber: string, config: PhonicSTSOutboundCallConfig): DataOrError<OutboundCallSuccessResponse>;
 }
 
 type Voice = {
@@ -185,6 +199,13 @@ declare class Phonic {
         data: T;
         error: null;
     }>;
+    post<T>(path: string, body: Record<string, unknown>): Promise<{
+        data: null;
+        error: ErrorResponse;
+    } | {
+        data: T;
+        error: null;
+    }>;
 }
 
 export { Phonic, type PhonicSTSConfig, PhonicSTSWebSocket };

package/dist/index.d.ts

@@ -7,6 +7,9 @@ type PhonicConfig = {
 };
 type FetchOptions = {
     method: "GET";
+} | {
+    method: "POST";
+    body: string;
 };
 type ErrorResponse = {
     message: string;
@@ -84,6 +87,10 @@ type PhonicSTSConfig = {
     voice_id?: string;
     output_format?: "pcm_44100" | "mulaw_8000";
     enable_silent_audio_fallback?: boolean;
+    vad_prebuffer_duration_ms?: number;
+    vad_min_speech_duration_ms?: number;
+    vad_min_silence_duration_ms?: number;
+    vad_threshold?: number;
 };
 type PhonicSTSWebSocketResponseMessage = {
     type: "ready_to_start_conversation";
@@ -117,6 +124,12 @@ type PhonicSTSWebSocketResponseMessage = {
 type OnMessageCallback = (message: PhonicSTSWebSocketResponseMessage) => void;
 type OnCloseCallback = (event: WebSocket.CloseEvent) => void;
 type OnErrorCallback = (event: WebSocket.ErrorEvent) => void;
+type PhonicSTSOutboundCallConfig = Omit<PhonicSTSConfig, "input_format" | "output_format"> & {
+    welcome_message: string;
+};
+type OutboundCallSuccessResponse = {
+    success: true;
+};
 
 declare class PhonicSTSWebSocket {
     private readonly ws;
@@ -146,6 +159,7 @@ declare class SpeechToSpeech {
     private readonly phonic;
     constructor(phonic: Phonic);
     websocket(config: PhonicSTSConfig): PhonicSTSWebSocket;
+    outboundCall(toPhoneNumber: string, config: PhonicSTSOutboundCallConfig): DataOrError<OutboundCallSuccessResponse>;
 }
 
 type Voice = {
@@ -185,6 +199,13 @@ declare class Phonic {
         data: T;
         error: null;
     }>;
+    post<T>(path: string, body: Record<string, unknown>): Promise<{
+        data: null;
+        error: ErrorResponse;
+    } | {
+        data: T;
+        error: null;
+    }>;
 }
 
 export { Phonic, type PhonicSTSConfig, PhonicSTSWebSocket };

package/dist/index.js

@@ -35,7 +35,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // package.json
-var version = "0.16.2";
+var version = "0.17.0";
 
 // src/conversations/index.ts
 var Conversations = class {
@@ -202,6 +202,16 @@ var SpeechToSpeech = class {
     });
     return new PhonicSTSWebSocket(ws, config);
   }
+  async outboundCall(toPhoneNumber, config) {
+    const response = await this.phonic.post(
+      "/sts/outbound_call",
+      {
+        to_phone_number: toPhoneNumber,
+        config
+      }
+    );
+    return response;
+  }
 };
 
 // src/voices/index.ts
@@ -294,6 +304,12 @@ var Phonic = class {
   async get(path) {
     return this.fetchRequest(path, { method: "GET" });
   }
+  async post(path, body) {
+    return this.fetchRequest(path, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.16.2";
+var version = "0.17.0";
 
 // src/conversations/index.ts
 var Conversations = class {
@@ -166,6 +166,16 @@ var SpeechToSpeech = class {
     });
     return new PhonicSTSWebSocket(ws, config);
   }
+  async outboundCall(toPhoneNumber, config) {
+    const response = await this.phonic.post(
+      "/sts/outbound_call",
+      {
+        to_phone_number: toPhoneNumber,
+        config
+      }
+    );
+    return response;
+  }
 };
 
 // src/voices/index.ts
@@ -258,6 +268,12 @@ var Phonic = class {
   async get(path) {
     return this.fetchRequest(path, { method: "GET" });
   }
+  async post(path, body) {
+    return this.fetchRequest(path, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
 };
 export {
   Phonic

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phonic",
-  "version": "0.16.2",
+  "version": "0.17.0",
   "description": "Phonic Node.js SDK",
   "scripts": {
     "build": "tsup",
@@ -38,11 +38,12 @@
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
     "@changesets/changelog-github": "0.5.1",
-    "@changesets/cli": "2.28.1",
-    "@types/bun": "1.2.8",
+    "@changesets/cli": "2.29.2",
+    "@types/bun": "1.2.10",
+    "@types/ws": "8.18.1",
     "tsup": "8.4.0",
     "typescript": "5.8.3",
-    "zod": "3.24.2"
+    "zod": "3.24.3"
   },
   "files": ["dist/**"],
   "author": {