phonic 0.17.0 → 0.18.1

package/README.md

@@ -11,6 +11,7 @@ Node.js library for the Phonic API.
   - [Get conversation by external id](#get-conversation-by-external-id)
   - [List conversations](#list-conversations)
   - [STS outbound call](#sts-outbound-call)
+  - [STS outbound call using own Twilio account](#sts-outbound-call-using-own-twilio-account)
   - [STS via WebSocket](#sts-via-websocket)
     - [Messages that Phonic sends back to you](#messages-that-phonic-sends-back-to-you)
   
@@ -108,7 +109,36 @@ const { data, error } = await phonic.sts.outboundCall("+19189396241", {
   vad_min_speech_duration_ms: 40,
   vad_min_silence_duration_ms: 550,
   vad_threshold: 0.6,
-})
+});
+```
+
+### STS outbound call using own Twilio account
+
+In Twilio, create a restricted API key with the following permission: voice -> calls -> create
+
+```ts
+const { data, error } = await phonic.sts.twilio.outboundCall(
+  {
+    account_sid: "AC...",
+    api_key_sid: "SK...",
+    api_key_secret: "...",
+    from_phone_number: "+19189372905",
+    to_phone_number: "+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

package/dist/index.d.mts

@@ -7,20 +7,21 @@ type PhonicConfig = {
 };
 type FetchOptions = {
     method: "GET";
+    headers?: Record<string, string>;
 } | {
     method: "POST";
+    headers?: Record<string, string>;
     body: string;
 };
-type ErrorResponse = {
-    message: string;
-    code?: string;
-};
 type DataOrError<T> = Promise<{
     data: T;
     error: null;
 } | {
     data: null;
-    error: ErrorResponse;
+    error: {
+        message: string;
+        code?: string;
+    };
 }>;
 type ISODate = `${string}-${string}-${string}`;
 type ISODateTime$1 = `${string}Z`;
@@ -131,6 +132,25 @@ type OutboundCallSuccessResponse = {
     success: true;
 };
 
+type PhonicSTSTwilioOutboundCallParams = {
+    account_sid: string;
+    api_key_sid: string;
+    api_key_secret: string;
+    from_phone_number: string;
+    to_phone_number: string;
+};
+type PhonicSTSTwilioOutboundCallConfig = PhonicSTSOutboundCallConfig;
+type TwilioOutboundCallSuccessResponse = {
+    success: true;
+    callSid: string;
+};
+
+declare class Twilio {
+    private readonly phonic;
+    constructor(phonic: Phonic);
+    outboundCall(params: PhonicSTSTwilioOutboundCallParams, config: PhonicSTSTwilioOutboundCallConfig): DataOrError<TwilioOutboundCallSuccessResponse>;
+}
+
 declare class PhonicSTSWebSocket {
     private readonly ws;
     private readonly config;
@@ -157,6 +177,7 @@ declare class PhonicSTSWebSocket {
 
 declare class SpeechToSpeech {
     private readonly phonic;
+    readonly twilio: Twilio;
     constructor(phonic: Phonic);
     websocket(config: PhonicSTSConfig): PhonicSTSWebSocket;
     outboundCall(toPhoneNumber: string, config: PhonicSTSOutboundCallConfig): DataOrError<OutboundCallSuccessResponse>;
@@ -194,14 +215,20 @@ declare class Phonic {
     fetchRequest<T>(path: string, options: FetchOptions): DataOrError<T>;
     get<T>(path: string): Promise<{
         data: null;
-        error: ErrorResponse;
+        error: {
+            message: string;
+            code?: string;
+        };
     } | {
         data: T;
         error: null;
     }>;
-    post<T>(path: string, body: Record<string, unknown>): Promise<{
+    post<T>(path: string, body: Record<string, unknown>, headers?: Record<string, string>): Promise<{
         data: null;
-        error: ErrorResponse;
+        error: {
+            message: string;
+            code?: string;
+        };
     } | {
         data: T;
         error: null;

package/dist/index.d.ts

@@ -7,20 +7,21 @@ type PhonicConfig = {
 };
 type FetchOptions = {
     method: "GET";
+    headers?: Record<string, string>;
 } | {
     method: "POST";
+    headers?: Record<string, string>;
     body: string;
 };
-type ErrorResponse = {
-    message: string;
-    code?: string;
-};
 type DataOrError<T> = Promise<{
     data: T;
     error: null;
 } | {
     data: null;
-    error: ErrorResponse;
+    error: {
+        message: string;
+        code?: string;
+    };
 }>;
 type ISODate = `${string}-${string}-${string}`;
 type ISODateTime$1 = `${string}Z`;
@@ -131,6 +132,25 @@ type OutboundCallSuccessResponse = {
     success: true;
 };
 
+type PhonicSTSTwilioOutboundCallParams = {
+    account_sid: string;
+    api_key_sid: string;
+    api_key_secret: string;
+    from_phone_number: string;
+    to_phone_number: string;
+};
+type PhonicSTSTwilioOutboundCallConfig = PhonicSTSOutboundCallConfig;
+type TwilioOutboundCallSuccessResponse = {
+    success: true;
+    callSid: string;
+};
+
+declare class Twilio {
+    private readonly phonic;
+    constructor(phonic: Phonic);
+    outboundCall(params: PhonicSTSTwilioOutboundCallParams, config: PhonicSTSTwilioOutboundCallConfig): DataOrError<TwilioOutboundCallSuccessResponse>;
+}
+
 declare class PhonicSTSWebSocket {
     private readonly ws;
     private readonly config;
@@ -157,6 +177,7 @@ declare class PhonicSTSWebSocket {
 
 declare class SpeechToSpeech {
     private readonly phonic;
+    readonly twilio: Twilio;
     constructor(phonic: Phonic);
     websocket(config: PhonicSTSConfig): PhonicSTSWebSocket;
     outboundCall(toPhoneNumber: string, config: PhonicSTSOutboundCallConfig): DataOrError<OutboundCallSuccessResponse>;
@@ -194,14 +215,20 @@ declare class Phonic {
     fetchRequest<T>(path: string, options: FetchOptions): DataOrError<T>;
     get<T>(path: string): Promise<{
         data: null;
-        error: ErrorResponse;
+        error: {
+            message: string;
+            code?: string;
+        };
     } | {
         data: T;
         error: null;
     }>;
-    post<T>(path: string, body: Record<string, unknown>): Promise<{
+    post<T>(path: string, body: Record<string, unknown>, headers?: Record<string, string>): Promise<{
         data: null;
-        error: ErrorResponse;
+        error: {
+            message: string;
+            code?: string;
+        };
     } | {
         data: T;
         error: null;

package/dist/index.js

@@ -35,7 +35,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // package.json
-var version = "0.17.0";
+var version = "0.18.1";
 
 // src/conversations/index.ts
 var Conversations = class {
@@ -85,6 +85,29 @@ var Conversations = class {
 // src/sts/index.ts
 var import_ws = __toESM(require("ws"));
 
+// src/sts/twilio/index.ts
+var Twilio = class {
+  constructor(phonic) {
+    this.phonic = phonic;
+  }
+  async outboundCall(params, config) {
+    const response = await this.phonic.post(
+      "/sts/twilio/outbound_call",
+      {
+        from_phone_number: params.from_phone_number,
+        to_phone_number: params.to_phone_number,
+        config
+      },
+      {
+        "X-Twilio-Account-Sid": params.account_sid,
+        "X-Twilio-Api-Key-Sid": params.api_key_sid,
+        "X-Twilio-Api-Key-Secret": params.api_key_secret
+      }
+    );
+    return response;
+  }
+};
+
 // src/sts/websocket.ts
 var PhonicSTSWebSocket = class {
   constructor(ws, config) {
@@ -188,7 +211,9 @@ var PhonicSTSWebSocket = class {
 var SpeechToSpeech = class {
   constructor(phonic) {
     this.phonic = phonic;
+    this.twilio = new Twilio(phonic);
   }
+  twilio;
   websocket(config) {
     const wsBaseUrl = this.phonic.baseUrl.replace(/^http/, "ws");
     const queryString = new URLSearchParams({
@@ -266,9 +291,13 @@ var Phonic = class {
   sts = new SpeechToSpeech(this);
   async fetchRequest(path, options) {
     try {
+      const { headers, ...restOptions } = options;
       const response = await fetch(`${this.baseUrl}/v1${path}`, {
-        headers: this.headers,
-        ...options
+        headers: {
+          ...this.headers,
+          ...headers
+        },
+        ...restOptions
       });
       if (response.ok) {
         const data = await response.json();
@@ -304,10 +333,11 @@ var Phonic = class {
   async get(path) {
     return this.fetchRequest(path, { method: "GET" });
   }
-  async post(path, body) {
+  async post(path, body, headers) {
     return this.fetchRequest(path, {
       method: "POST",
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      headers
     });
   }
 };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.17.0";
+var version = "0.18.1";
 
 // src/conversations/index.ts
 var Conversations = class {
@@ -49,6 +49,29 @@ var Conversations = class {
 // src/sts/index.ts
 import WebSocket from "ws";
 
+// src/sts/twilio/index.ts
+var Twilio = class {
+  constructor(phonic) {
+    this.phonic = phonic;
+  }
+  async outboundCall(params, config) {
+    const response = await this.phonic.post(
+      "/sts/twilio/outbound_call",
+      {
+        from_phone_number: params.from_phone_number,
+        to_phone_number: params.to_phone_number,
+        config
+      },
+      {
+        "X-Twilio-Account-Sid": params.account_sid,
+        "X-Twilio-Api-Key-Sid": params.api_key_sid,
+        "X-Twilio-Api-Key-Secret": params.api_key_secret
+      }
+    );
+    return response;
+  }
+};
+
 // src/sts/websocket.ts
 var PhonicSTSWebSocket = class {
   constructor(ws, config) {
@@ -152,7 +175,9 @@ var PhonicSTSWebSocket = class {
 var SpeechToSpeech = class {
   constructor(phonic) {
     this.phonic = phonic;
+    this.twilio = new Twilio(phonic);
   }
+  twilio;
   websocket(config) {
     const wsBaseUrl = this.phonic.baseUrl.replace(/^http/, "ws");
     const queryString = new URLSearchParams({
@@ -230,9 +255,13 @@ var Phonic = class {
   sts = new SpeechToSpeech(this);
   async fetchRequest(path, options) {
     try {
+      const { headers, ...restOptions } = options;
       const response = await fetch(`${this.baseUrl}/v1${path}`, {
-        headers: this.headers,
-        ...options
+        headers: {
+          ...this.headers,
+          ...headers
+        },
+        ...restOptions
       });
       if (response.ok) {
         const data = await response.json();
@@ -268,10 +297,11 @@ var Phonic = class {
   async get(path) {
     return this.fetchRequest(path, { method: "GET" });
   }
-  async post(path, body) {
+  async post(path, body, headers) {
     return this.fetchRequest(path, {
       method: "POST",
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      headers
     });
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phonic",
-  "version": "0.17.0",
+  "version": "0.18.1",
   "description": "Phonic Node.js SDK",
   "scripts": {
     "build": "tsup",
@@ -33,17 +33,17 @@
     "url": "https://github.com/Phonic-Co/phonic-node/issues"
   },
   "dependencies": {
-    "ws": "8.18.1"
+    "ws": "8.18.2"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
     "@changesets/changelog-github": "0.5.1",
     "@changesets/cli": "2.29.2",
-    "@types/bun": "1.2.10",
+    "@types/bun": "1.2.12",
     "@types/ws": "8.18.1",
     "tsup": "8.4.0",
     "typescript": "5.8.3",
-    "zod": "3.24.3"
+    "zod": "3.24.4"
   },
   "files": ["dist/**"],
   "author": {