@ctchealth/plato-sdk 0.0.20 → 0.0.22

package/README.md

@@ -17,7 +17,7 @@ All API requests require authentication via a client token. Pass a pre-signed JW
 - Comprehensive event system for call management
 - Type-safe API with full TypeScript support
 - Medical training simulation configuration
-- Simulation persistence and recovery across page reloads
+- Simulation persistence across page reloads
 
 ## Installation
 
@@ -294,22 +294,32 @@ Uploads a PDF file for slide analysis. The file will be uploaded to S3 and analy
 
 - **Latin-only file names:** The PDF file name must contain only Latin characters. Non-latin characters in the file name are not supported.
 - **Maximum 100 pages:** PDF files cannot exceed 100 pages.
-- **No duplicate content:** Uploading a PDF with identical content to an already uploaded file is not allowed. Duplicates are detected based on file content, not file name.
+- **No duplicate content:** Uploading a PDF with identical content that was already uploaded by your organization throws an error. Duplicates are detected based on file content, not file name, and are scoped per organization.
 
 **Example:**
 
 ```typescript
-// Upload a PDF file from an input element
+import { PdfAlreadyExistsError } from 'plato-sdk';
+
 const fileInput = document.querySelector('input[type="file"]') as HTMLInputElement;
 const file = fileInput.files?.[0];
 
 if (file) {
-  const pdfId = await client.uploadPdfSlides(file);
-  console.log('PDF upload initiated, ID:', pdfId);
-
-  // Now you can immediately check the status using the returned ID
-  const status = await client.checkPdfStatus(pdfId);
-  console.log('Initial status:', status);
+  try {
+    const pdfId = await client.uploadPdfSlides(file);
+    console.log('PDF uploaded, ID:', pdfId);
+    // Poll status until analysis completes
+  } catch (error) {
+    if (error instanceof PdfAlreadyExistsError) {
+      // Inform the user this PDF already exists in their organization
+      console.error(
+        'This PDF has already been uploaded by your organization. PDF ID:',
+        error.pdfId
+      );
+    } else {
+      console.error('Upload failed:', error.message);
+    }
+  }
 }
 ```
 
@@ -599,6 +609,7 @@ const inProgress = simulations.find(
 );
 ```
 
+<!--
 ## Call Recovery
 
 The SDK automatically handles call recovery in case of page refreshes or browser closures during active calls. This ensures that call data is never lost and all calls get properly processed by the backend, even if the page is refreshed while a call is in progress.
@@ -900,6 +911,7 @@ A: The `recoverAbandonedCall()` method returns `true` when a call is recovered.
 **Q: What if the backend is down during recovery?**
 
 A: The recovery attempt is logged and the stored state is cleared to prevent infinite retries. The SDK continues working normally. Recovery failures are graceful and don't break the app.
+-->
 
 ## Event System
 
@@ -914,6 +926,7 @@ The SDK provides a comprehensive event system for managing voice calls:
 - `message`: Triggered when a message is received (contains transcript and metadata)
 - `volume-level`: Triggered with volume level updates (number)
 - `error`: Triggered when an error occurs
+- `call-ended-reason`: Triggered just before `call-end` with the reason the call was terminated (e.g. silence timeout). Use this to show the user a contextual message immediately
 - `call-details-ready`: Triggered when post-call processing completes and call details are available (includes full `CallDTO` with transcript, summary, ratings, and evaluation)
 
 ### Event Usage
@@ -939,6 +952,29 @@ call.on('call-details-ready', callDetails => {
 });
 ```
 
+## Detecting Why a Call Ended
+
+The `call-ended-reason` event fires **just before** `call-end`, giving you the reason the call was terminated in time to update the UI before any post-call processing begins.
+
+### Usage
+
+```typescript
+call.on('call-ended-reason', ({ reason, isInactivity }) => {
+  // reason      — raw string from the platform, e.g. "silence-timed-out"
+  // isInactivity — true when reason contains "silence" or "inactivity"
+});
+```
+
+### Known Reason Values
+
+| `reason`              | `isInactivity` | When it occurs                                          |
+| --------------------- | -------------- | ------------------------------------------------------- |
+| `silence-timed-out`   | `true`         | No speech detected within the configured silence window |
+| `customer-ended-call` | `false`        | The user clicked "End Call"                             |
+| `pipeline-error`      | `false`        | An internal platform error terminated the call          |
+
+> **Note:** The `reason` field reflects the raw value from the underlying voice platform. New values may be introduced over time. Always handle unknown reasons gracefully by falling back to a generic message.
+
 ## Automatic Post-Call Feedback
 
 The SDK automatically fetches detailed call information after each call ends and completes post-call processing. This includes comprehensive feedback such as transcript, summary, evaluation metrics, strengths, weaknesses, and ratings.
@@ -1118,10 +1154,22 @@ call.on('call-details-ready', callDetails => {
 
 ### Timing Considerations
 
+- `call-ended-reason`: Fires immediately before `call-end`, with the reason the call stopped
 - `call-end`: Fires immediately when the call stops
 - `call-details-ready`: Fires after backend processing completes (typically 2-5 seconds after call ends)
 
-Plan your UX accordingly—show a loading/processing state between these two events.
+Plan your UX accordingly—show a contextual end message on `call-ended-reason`, then a loading/processing state until `call-details-ready` arrives.
+
+### Call Duration and Data Availability
+
+The quality of data returned in `call-details-ready` depends on the duration of the call:
+
+| Call duration     | Behaviour                                                                                                                                                                                                                                                                   |
+| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **< ~15 seconds** | `call-details-ready` fires immediately after `call-end` with whatever the database currently holds. Fields like `transcript`, `summary`, `score`, `strengths`, and `weaknesses` will typically be empty or zero — the call was too short to generate a meaningful analysis. |
+| **≥ ~15 seconds** | The SDK polls the backend until Vapi's post-call analysis is ready (transcript present), then emits `call-details-ready` with the fully populated `CallDTO`.                                                                                                                |
+
+> **Note:** The ~15 second threshold accounts for the Vapi connection handshake (typically 1–5 seconds) plus a minimum amount of conversation time required for analysis to be generated. Always handle empty fields gracefully regardless of call length.
 
 ## Data Types
 
@@ -1429,6 +1477,49 @@ try {
 }
 ```
 
+### PDF Already Exists Error
+
+When a PDF with identical content has already been uploaded by your organization, `uploadPdfSlides()` throws a `PdfAlreadyExistsError`. The error exposes the `pdfId` of the existing record so you can use it directly without re-uploading.
+
+```typescript
+import { PdfAlreadyExistsError } from 'plato-sdk';
+
+try {
+  const pdfId = await client.uploadPdfSlides(file);
+} catch (error) {
+  if (error instanceof PdfAlreadyExistsError) {
+    console.log('PDF already exists, using existing ID:', error.pdfId);
+  } else {
+    console.error('Upload failed:', error.message);
+  }
+}
+```
+
+### Concurrency Limit Error
+
+When the platform has reached its maximum number of simultaneous active calls, `startCall()` throws a `CallConcurrencyLimitError`. This is a platform-wide limit, not user-specific. You should catch this specifically and show the user a clear message rather than a generic error.
+
+```typescript
+import { CallConcurrencyLimitError } from 'plato-sdk';
+
+const handleStartCall = async (simulationId: string) => {
+  try {
+    const call = await platoClient.startCall(simulationId);
+
+    call.on('call-start', () => setCallActive(true));
+    call.on('call-end', () => setCallActive(false));
+  } catch (error) {
+    if (error instanceof CallConcurrencyLimitError) {
+      setErrorMessage(
+        'The platform has reached its maximum number of simultaneous calls. Please try again in a moment.'
+      );
+    } else {
+      setErrorMessage('Failed to start call. Please try again.');
+    }
+  }
+};
+```
+
 ## Support
 
 For support and questions, please contact the development team.

package/package.json

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

package/src/index.d.ts

@@ -12,3 +12,4 @@
  * For internal use only.
  */
 export * from './lib/plato-sdk';
+export { CallConcurrencyLimitError, PdfAlreadyExistsError } from './lib/utils';

package/src/index.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.PdfAlreadyExistsError = exports.CallConcurrencyLimitError = void 0;
 const tslib_1 = require("tslib");
 /**
  * Copyright (c) 2025 ctcHealth. All rights reserved.
@@ -15,4 +16,7 @@ const tslib_1 = require("tslib");
  * For internal use only.
  */
 tslib_1.__exportStar(require("./lib/plato-sdk"), exports);
+var utils_1 = require("./lib/utils");
+Object.defineProperty(exports, "CallConcurrencyLimitError", { enumerable: true, get: function () { return utils_1.CallConcurrencyLimitError; } });
+Object.defineProperty(exports, "PdfAlreadyExistsError", { enumerable: true, get: function () { return utils_1.PdfAlreadyExistsError; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/plato-sdk/src/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;GAYG;AACH,0DAAgC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/plato-sdk/src/index.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;;;GAYG;AACH,0DAAgC;AAChC,qCAA+E;AAAtE,kHAAA,yBAAyB,OAAA;AAAE,8GAAA,qBAAqB,OAAA"}

package/src/lib/plato-intefaces.d.ts

@@ -125,10 +125,6 @@ export interface CallDTO {
      *  call ID obtained
      */
     callId: string;
-    /**
-     *  call User ID
-     */
-    platoUserId: string;
     /**
      *  call Assistant ID
      */
@@ -245,9 +241,10 @@ export interface PresignedPost {
  * Response for requesting a PDF upload.
  */
 export interface RequestPdfUploadResponse {
-    presignedPost: PresignedPost;
+    presignedPost?: PresignedPost;
     objectKey: string;
     pdfId: string;
+    alreadyExists?: boolean;
 }
 /**
  * Persona description within simulation briefing
@@ -327,17 +324,6 @@ export interface CheckPdfStatusResponse {
     processedBatches: number[];
     totalBatches?: number;
 }
-export declare enum PdfSlidesSortField {
-    CREATED_AT = "createdAt",
-    FILENAME = "originalFilename",
-    TOTAL_SLIDES = "totalSlides"
-}
-export declare class PdfSlidesAnalysisQueryDto {
-    limit?: RecordingsLimit;
-    page?: number;
-    sort?: SortOrder;
-    sortBy?: PdfSlidesSortField;
-}
 export interface SlideAnalysis {
     slideNumber: number;
     title?: string;

package/src/lib/plato-intefaces.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PdfSlidesAnalysisQueryDto = exports.PdfSlidesSortField = exports.PdfSlidesStatus = exports.RecommendationPriority = exports.CreationPhase = exports.SimulationRecordingsDto = exports.RecordingStatus = exports.SortOrder = exports.SimulationRecordingsQueryDto = exports.CreateSimulationDto = exports.ProductConfig = exports.CharacterCreateDto = exports.ContextDto = exports.ProfessionalProfileDto = exports.PersonalityAndBehaviourDto = exports.AvatarLanguage = exports.AssistantVoiceGender = exports.SegmentType = exports.PracticeType = exports.YearOfExperience = void 0;
+exports.PdfSlidesStatus = exports.RecommendationPriority = exports.CreationPhase = exports.SimulationRecordingsDto = exports.RecordingStatus = exports.SortOrder = exports.SimulationRecordingsQueryDto = exports.CreateSimulationDto = exports.ProductConfig = exports.CharacterCreateDto = exports.ContextDto = exports.ProfessionalProfileDto = exports.PersonalityAndBehaviourDto = exports.AvatarLanguage = exports.AssistantVoiceGender = exports.SegmentType = exports.PracticeType = exports.YearOfExperience = void 0;
 /**
  * Copyright (c) 2025 ctcHealth. All rights reserved.
  *
@@ -159,17 +159,4 @@ var PdfSlidesStatus;
     PdfSlidesStatus["COMPLETED"] = "completed";
     PdfSlidesStatus["FAILED"] = "failed";
 })(PdfSlidesStatus || (exports.PdfSlidesStatus = PdfSlidesStatus = {}));
-var PdfSlidesSortField;
-(function (PdfSlidesSortField) {
-    PdfSlidesSortField["CREATED_AT"] = "createdAt";
-    PdfSlidesSortField["FILENAME"] = "originalFilename";
-    PdfSlidesSortField["TOTAL_SLIDES"] = "totalSlides";
-})(PdfSlidesSortField || (exports.PdfSlidesSortField = PdfSlidesSortField = {}));
-class PdfSlidesAnalysisQueryDto {
-    limit;
-    page;
-    sort;
-    sortBy;
-}
-exports.PdfSlidesAnalysisQueryDto = PdfSlidesAnalysisQueryDto;
 //# sourceMappingURL=plato-intefaces.js.map

package/src/lib/plato-intefaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"plato-intefaces.js","sourceRoot":"","sources":["../../../../../libs/plato-sdk/src/lib/plato-intefaces.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plato-intefaces.js","sourceRoot":"","sources":["../../../../../libs/plato-sdk/src/lib/plato-intefaces.ts"],"names":[],"mappings":"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"}

package/src/lib/plato-sdk.d.ts

@@ -1,4 +1,4 @@
-import { CallDTO, CreateSimulationDto, CreationPhase, SimulationRecordingsDto, SimulationRecordingsQueryDto, SimulationDetailsDto, RecommendationsResponseDto, PdfSlidesDto, PdfSlideDto, PdfSlidesAnalysisQueryDto, CheckPdfStatusResponse, AssistantImageDto } from './plato-intefaces';
+import { CallDTO, CreateSimulationDto, CreationPhase, SimulationRecordingsDto, SimulationRecordingsQueryDto, SimulationDetailsDto, RecommendationsResponseDto, PdfSlideDto, CheckPdfStatusResponse, AssistantImageDto } from './plato-intefaces';
 export interface ApiClientConfig {
     baseUrl: string;
     jwtToken: string;
@@ -36,17 +36,19 @@ export interface CallEventMap {
     };
     'volume-level': number;
     'call-details-ready': CallDTO;
+    'call-ended-reason': {
+        reason: string;
+        isInactivity: boolean;
+    };
 }
 export type CallEventNames = keyof CallEventMap;
 export type CallEventListener<K extends CallEventNames> = (payload: CallEventMap[K]) => void;
 export declare class PlatoApiClient {
     private config;
-    private static readonly ACTIVE_CALL_STORAGE_KEY;
     private http;
     private eventListeners;
     private callControllerInstance?;
     private eventsAttached;
-    private currentCallId?;
     private vapiEventNames;
     eventNames: CallEventNames[];
     constructor(config: ApiClientConfig);
@@ -79,66 +81,6 @@ export declare class PlatoApiClient {
      * Internal: Emit SDK-specific events that are not part of Vapi.
      */
     private emit;
-    /**
-     * Store active call state in localStorage for recovery purposes.
-     * @private
-     */
-    private storeCallState;
-    /**
-     * Retrieve active call state from localStorage.
-     * Validates the stored data and clears it if invalid.
-     * @private
-     * @returns The stored call state or null if not found or invalid
-     */
-    private getStoredCallState;
-    /**
-     * Clear active call state from localStorage.
-     * @private
-     */
-    private clearCallState;
-    /**
-     * Check if a stored call is considered abandoned based on age.
-     * Calls older than 5 minutes are considered abandoned.
-     * @private
-     * @param state The call state to check
-     * @returns true if the call is abandoned, false otherwise
-     */
-    private isCallAbandoned;
-    /**
-     * Recover and clean up any abandoned calls from previous sessions.
-     *
-     * This method should be called during application initialization,
-     * typically in ngOnInit() or useEffect(). It detects calls that were
-     * active when the page was last refreshed and notifies the backend
-     * to process them if they're older than 5 minutes.
-     *
-     * The backend endpoint is idempotent, so calling this method multiple
-     * times for the same call is safe.
-     *
-     * @returns Promise<boolean> - true if an abandoned call was recovered and processed
-     *
-     * @example
-     * // In Angular component
-     * async ngOnInit(): Promise<void> {
-     *   const recovered = await this.platoClient.recoverAbandonedCall();
-     *   if (recovered) {
-     *     console.log('Recovered abandoned call from previous session');
-     *   }
-     * }
-     *
-     * @example
-     * // In React component
-     * useEffect(() => {
-     *   platoClient.recoverAbandonedCall()
-     *     .then(recovered => {
-     *       if (recovered) {
-     *         console.log('Recovered abandoned call');
-     *       }
-     *     })
-     *     .catch(console.error);
-     * }, []);
-     */
-    recoverAbandonedCall(): Promise<boolean>;
     createSimulation(createSimulationParams: CreateSimulationDto): Promise<{
         simulationId: string;
         phase: CreationPhase;
@@ -164,27 +106,19 @@ export declare class PlatoApiClient {
      * Remove all listeners for all call events.
      */
     private removeAllEventListeners;
+    /**
+     * Starts a call for the given simulation.
+     * Polls the backend after call-end until the call is finalized, then emits 'call-details-ready'.
+     */
     startCall(simulationId: string): Promise<{
         stopCall: () => void;
         callId: string;
-        /**
-         * Subscribe to call events for this call with strict typing.
-         * @param event Event name
-         * @param listener Listener function
-         */
         on: <K extends CallEventNames>(event: K, listener: CallEventListener<K>) => void;
-        /**
-         * Unsubscribe from call events for this call with strict typing.
-         * @param event Event name
-         * @param listener Listener function
-         */
         off: <K extends CallEventNames>(event: K, listener: CallEventListener<K>) => void;
     }>;
-    private onCallEnded;
     private createCall;
     uploadPdfSlides(file: File | Blob): Promise<string>;
     getRecommendations(): Promise<RecommendationsResponseDto>;
-    getSlidesAnalysis(queryParams: PdfSlidesAnalysisQueryDto): Promise<PdfSlidesDto[]>;
     getSlideAnalysis(id: string): Promise<PdfSlideDto>;
     deleteSlideAnalysis(id: string): Promise<void>;
     checkPdfStatus(id: string): Promise<CheckPdfStatusResponse>;