@ctchealth/plato-sdk 0.0.17 → 0.0.19

package/README.md

@@ -8,13 +8,7 @@ The Plato SDK provides a simple and type-safe way to integrate with the Plato pl
 
 ## Authentication
 
-All API requests require authentication using a Bearer token. Include your JWT token in the `API-AUTH` header:
-
-```
-API-AUTH: Bearer <your-jwt-token>
-```
-
-Requests without a valid JWT token will be rejected with a `401 Unauthorized` response.
+All API requests require authentication via a client token. Pass a pre-signed JWT token as `jwtToken` when initializing the client. This is sent as the `x-client-token` header on every request.
 
 ## Features
 
@@ -39,8 +33,8 @@ import { PlatoApiClient, AvatarLanguage } from 'plato-sdk';
 // Initialize the client
 const client = new PlatoApiClient({
   baseUrl: 'https://your-plato-api.com',
-  token: 'your-api-token',
-  user: 'test@test.test',
+  jwtToken: 'your-jwt-token',
+  publicKey: 'your-public-key',
 });
 
 // Get available assistant images
@@ -76,7 +70,7 @@ const simulation = await client.createSimulation({
     description:
       'A nonsteroidal anti-inflammatory drug used to reduce pain, inflammation, and fever',
   },
-  presentation: 'Oral tablets, 10 tablets per pack',
+  pdfSlideId: 'pdf-slide-id', // optional, ID from uploadPdfSlides()
   scenario: 'Discussing treatment options for an elderly patient with chronic arthritis',
   objectives:
     'Demonstrate efficacy of Ibuprofen in pain management Highlight safety profile and contraindications Encourage patient adherence',
@@ -133,19 +127,17 @@ new PlatoApiClient(config: ApiClientConfig)
 
 **Parameters:**
 
-- `config.baseUrl` (string): The base URL of the Plato API
-- `config.token` (string): Your API authentication token
-- `config.user` (string): Your user identifier
-- `config.jwtToken` (string, optional): A per-user JWT token sent as the `x-client-token` header on every request
+- `config.baseUrl` (string, required): The base URL of the Plato API
+- `config.jwtToken` (string, required): A pre-signed JWT token sent as the `x-client-token` header on every request
+- `config.publicKey` (string, required): Your public key for voice call functionality
 
-**Example with JWT token:**
+**Example:**
 
 ```typescript
 const client = new PlatoApiClient({
   baseUrl: 'https://your-plato-api.com',
-  token: 'your-api-key',
-  user: 'user@example.com',
-  jwtToken: 'eyJhbGciOiJSUzI1NiIs...', // optional, per-user token
+  jwtToken: 'eyJhbGciOiJSUzI1NiIs...',
+  publicKey: 'your-public-key',
 });
 ```
 
@@ -218,6 +210,24 @@ const callDetails = await client.getCallDetails(call._id);
 console.log('Call Summary:', callDetails.summary);
 ```
 
+##### deleteCall(callId: string)
+
+Deletes a single call and all associated data including messages, recommendations, and the S3 recording. Only the owner of the call (the rep who made it) can delete it.
+
+**Parameters:**
+
+- `callId` (string): The MongoDB `_id` of the call to delete
+
+**Returns:** `Promise<void>`
+
+**Example:**
+
+```typescript
+await client.deleteCall('507f1f77bcf86cd799439011');
+```
+
+**Note:** This action is irreversible. The call, its transcript, messages, recording, and any recommendations generated from it will be permanently removed.
+
 ##### getCallRecordings(queryParams: SimulationRecordingsQueryDto)
 
 Retrieves a paginated list of call recordings for the authenticated user.
@@ -655,8 +665,8 @@ import { PlatoApiClient } from 'plato-sdk';
 function TrainingApp() {
   const [platoClient] = useState(() => new PlatoApiClient({
     baseUrl: 'https://your-api.com',
-    token: 'your-token',
-    user: 'your-user',
+    jwtToken: 'your-jwt-token',
+    publicKey: 'your-public-key',
   }));
 
   useEffect(() => {
@@ -1151,13 +1161,12 @@ Configuration for creating a simulation:
 interface CreateSimulationDto {
   persona: CharacterCreateDto;
   product: ProductConfig;
-  presentation?: string;
   scenario: string;
   objectives?: string;
   anticipatedObjections?: string;
-  trainingConfiguration: TrainingConfigurationDto;
   imageId: string;
   avatarLanguage: AvatarLanguage;
+  pdfSlideId?: string;
 }
 ```
 
@@ -1393,6 +1402,8 @@ enum AvatarLanguage {
   Spanish = 'es',
   Italian = 'it',
   French = 'fr',
+  Arabic = 'ar',
+  Russian = 'ru',
 }
 ```
 
@@ -1404,8 +1415,8 @@ The SDK throws errors for invalid configurations and API failures:
 try {
   const client = new PlatoApiClient({
     baseUrl: 'https://api.plato.com',
-    token: 'your-token',
-    user: 'your-user',
+    jwtToken: 'your-jwt-token',
+    publicKey: 'your-public-key',
   });
 
   const simulation = await client.createSimulation(simulationConfig);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ctchealth/plato-sdk",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "dependencies": {
     "tslib": "^2.3.0",
     "@vapi-ai/web": "2.1.8",

package/src/lib/plato-intefaces.ts

@@ -44,6 +44,8 @@ export enum AvatarLanguage {
   Spanish = 'es',
   Italian = 'it',
   French = 'fr',
+  Arabic = 'ar',
+  Russian = 'ru',
 }
 
 export class PersonalityAndBehaviourDto {
@@ -84,12 +86,12 @@ export class ProductConfig {
 export class CreateSimulationDto {
   persona!: CharacterCreateDto;
   product!: ProductConfig;
-  presentation?: string;
   scenario!: string;
   objectives?: string;
   anticipatedObjections?: string;
   imageId!: string;
   avatarLanguage!: AvatarLanguage;
+  pdfSlideId?: string;
 }
 
 export type RecordingsLimit = 5 | 10 | 25;

package/src/lib/plato-sdk.ts

@@ -34,34 +34,10 @@ import { Call } from '@vapi-ai/web/dist/api';
 import { checkFile, calculateHash, getPdfPageCount } from './utils';
 import { MAX_PDF_FILE_SIZE, ALLOWED_PDF_MIME_TYPES, MAX_PDF_PAGES } from './constants';
 
-/**
- * Encodes API key and user into a ClientToken (base64 JSON) for x-client-token header.
- * The API decodes this to extract Token and User for validation.
- */
-function encodeApiKeyClientToken(token: string, user: string): string {
-  const payload = {
-    Token: token,
-    User: user,
-    UserId: user,
-    Exp: Math.floor(Date.now() / 1000) + 86400, // 24h
-  };
-  const json = JSON.stringify(payload);
-  if (typeof Buffer !== 'undefined') {
-    return Buffer.from(json, 'utf8').toString('base64');
-  }
-  const bytes = new TextEncoder().encode(json);
-  let binary = '';
-  for (let i = 0; i < bytes.length; i++) {
-    binary += String.fromCharCode(bytes[i]);
-  }
-  return btoa(binary);
-}
-
 export interface ApiClientConfig {
   baseUrl: string;
-  token?: string;
-  user?: string;
-  jwtToken?: string;
+  jwtToken: string;
+  publicKey: string;
 }
 
 export interface ToolCall {
@@ -139,22 +115,15 @@ export class PlatoApiClient {
     if (!config.baseUrl) {
       throw new Error('baseUrl is required');
     }
-    const token = config.token;
-    const user = config.user;
-    if (!token || !user) {
-      throw new Error('token and user are required');
-    }
 
     if (config.baseUrl.endsWith('/')) {
       config.baseUrl = config.baseUrl.slice(0, -1);
     }
 
-    const clientToken = config.jwtToken ? config.jwtToken : encodeApiKeyClientToken(token, user);
-
     this.http = axios.create({
       baseURL: config.baseUrl,
       headers: {
-        'x-client-token': clientToken,
+        'x-client-token': config.jwtToken,
       },
     });
   }
@@ -515,7 +484,7 @@ export class PlatoApiClient {
     this.clearCallState();
 
     this.callControllerInstance = new Vapi(
-      'f07d17ec-d4e6-487d-a0b9-0539c01aecbb',
+      this.config.publicKey,
       'https://db41aykk1gw9e.cloudfront.net' // base url
     );
     if (!this.eventsAttached) {
@@ -786,4 +755,22 @@ export class PlatoApiClient {
       throw e;
     }
   }
+
+  /**
+   * Deletes a call and all associated data (messages, recommendations, recording).
+   * Only the owner of the call can delete it.
+   * @param callId - MongoDB ObjectId of the call
+   * @throws 404 if call not found
+   * @throws 403 if the caller is not the call owner
+   */
+  async deleteCall(callId: string): Promise<void> {
+    try {
+      await this.http.delete(`/api/v1/simulation/call/${callId}`);
+    } catch (e) {
+      if (axios.isAxiosError(e)) {
+        console.error('Error deleting call:', e.response?.data.message);
+      }
+      throw e;
+    }
+  }
 }