phonic 0.12.0 → 0.13.1

package/README.md

@@ -9,6 +9,7 @@ Node.js library for the Phonic API.
   - [Get voice by id](#get-voice-by-id)
   - [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)
 
 ## Installation
@@ -70,6 +71,21 @@ if (error === null) {
 }
 ```
 
+### List conversations
+
+```ts
+const { data, error } = await phonic.conversations.list({
+  durationMin: 10, // sec
+  durationMax: 20, // sec
+  startedAtMin: "2025-04-17", // 00:00:00 UTC time is assumed
+  startedAtMax: "2025-09-05T10:30:00.000Z",
+});
+
+if (error === null) {
+  console.log(data.conversations);
+}
+```
+
 ### Speech-to-speech via WebSocket
 
 To start a conversation, open a WebSocket connection:

package/dist/index.d.mts

@@ -19,6 +19,8 @@ type DataOrError<T> = Promise<{
     data: null;
     error: ErrorResponse;
 }>;
+type ISODate = `${string}-${string}-${string}`;
+type ISODateTime$1 = `${string}Z`;
 
 type ISODateTime = `${string}Z`;
 type ConversationItem = {
@@ -53,12 +55,21 @@ type Conversation = {
 type ConversationSuccessResponse = {
     conversation: Conversation;
 };
+type ConversationsSuccessResponse = {
+    conversations: Array<Conversation>;
+};
 
 declare class Conversations {
     private readonly phonic;
     constructor(phonic: Phonic);
     get(id: string): DataOrError<ConversationSuccessResponse>;
     getByExternalId(externalId: string): DataOrError<ConversationSuccessResponse>;
+    list({ durationMin, durationMax, startedAtMin, startedAtMax, }: {
+        durationMin?: number;
+        durationMax?: number;
+        startedAtMin?: ISODate | ISODateTime$1;
+        startedAtMax?: ISODate | ISODateTime$1;
+    }): DataOrError<ConversationsSuccessResponse>;
 }
 
 type PhonicSTSConfig = {

package/dist/index.d.ts

@@ -19,6 +19,8 @@ type DataOrError<T> = Promise<{
     data: null;
     error: ErrorResponse;
 }>;
+type ISODate = `${string}-${string}-${string}`;
+type ISODateTime$1 = `${string}Z`;
 
 type ISODateTime = `${string}Z`;
 type ConversationItem = {
@@ -53,12 +55,21 @@ type Conversation = {
 type ConversationSuccessResponse = {
     conversation: Conversation;
 };
+type ConversationsSuccessResponse = {
+    conversations: Array<Conversation>;
+};
 
 declare class Conversations {
     private readonly phonic;
     constructor(phonic: Phonic);
     get(id: string): DataOrError<ConversationSuccessResponse>;
     getByExternalId(externalId: string): DataOrError<ConversationSuccessResponse>;
+    list({ durationMin, durationMax, startedAtMin, startedAtMax, }: {
+        durationMin?: number;
+        durationMax?: number;
+        startedAtMin?: ISODate | ISODateTime$1;
+        startedAtMax?: ISODate | ISODateTime$1;
+    }): DataOrError<ConversationsSuccessResponse>;
 }
 
 type PhonicSTSConfig = {

package/dist/index.js

@@ -35,7 +35,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // package.json
-var version = "0.12.0";
+var version = "0.13.1";
 
 // src/conversations/index.ts
 var Conversations = class {
@@ -49,8 +49,28 @@ var Conversations = class {
     return response;
   }
   async getByExternalId(externalId) {
+    const queryString = new URLSearchParams({
+      external_id: externalId
+    }).toString();
+    const response = await this.phonic.get(
+      `/conversations?${queryString}`
+    );
+    return response;
+  }
+  async list({
+    durationMin,
+    durationMax,
+    startedAtMin,
+    startedAtMax
+  }) {
+    const queryString = new URLSearchParams({
+      ...durationMin !== void 0 && { duration_min: String(durationMin) },
+      ...durationMax !== void 0 && { duration_max: String(durationMax) },
+      ...startedAtMin !== void 0 && { started_at_min: startedAtMin },
+      ...startedAtMax !== void 0 && { started_at_max: startedAtMax }
+    }).toString();
     const response = await this.phonic.get(
-      `/conversations?external_id=${externalId}`
+      `/conversations?${queryString}`
     );
     return response;
   }

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.12.0";
+var version = "0.13.1";
 
 // src/conversations/index.ts
 var Conversations = class {
@@ -13,8 +13,28 @@ var Conversations = class {
     return response;
   }
   async getByExternalId(externalId) {
+    const queryString = new URLSearchParams({
+      external_id: externalId
+    }).toString();
+    const response = await this.phonic.get(
+      `/conversations?${queryString}`
+    );
+    return response;
+  }
+  async list({
+    durationMin,
+    durationMax,
+    startedAtMin,
+    startedAtMax
+  }) {
+    const queryString = new URLSearchParams({
+      ...durationMin !== void 0 && { duration_min: String(durationMin) },
+      ...durationMax !== void 0 && { duration_max: String(durationMax) },
+      ...startedAtMin !== void 0 && { started_at_min: startedAtMin },
+      ...startedAtMax !== void 0 && { started_at_max: startedAtMax }
+    }).toString();
     const response = await this.phonic.get(
-      `/conversations?external_id=${externalId}`
+      `/conversations?${queryString}`
     );
     return response;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phonic",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "Phonic Node.js SDK",
   "scripts": {
     "build": "tsup",