@jivaai/agent-chat-typescript 0.1.0

package/dist/api.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Jiva.ai Agent Chat API Client
+ *
+ * A simple REST API client for interacting with Jiva.ai workflows.
+ */
+import { ApiConfig, ApiResponse, SuccessCallback, ErrorCallback, InitiateConversationRequest, InitiateConversationWithContext, ConversationResponse, PollRequest, PollResponse, PollingOptions, UploadResponse, SocketOptions, SocketCallbacks } from './types';
+/**
+ * Clears the cached EventSource class (useful for testing)
+ * @internal
+ */
+export declare function clearEventSourceCache(): void;
+/**
+ * Jiva.ai API Client
+ */
+export declare class JivaApiClient {
+    private config;
+    private reconnectAttemptsMap;
+    private reconnectScheduledMap;
+    private logger;
+    constructor(config: ApiConfig);
+    /**
+     * Makes a GET request to the API
+     *
+     * @param endpoint - Optional endpoint path (appended to base URL)
+     * @param onSuccess - Optional success callback
+     * @param onError - Optional error callback
+     * @returns Promise with the API response
+     */
+    get<T = unknown>(endpoint?: string, onSuccess?: SuccessCallback<T>, onError?: ErrorCallback): Promise<ApiResponse<T>>;
+    /**
+     * Makes a POST request to the API
+     *
+     * @param payload - JSON payload to send
+     * @param endpoint - Optional endpoint path (appended to base URL)
+     * @param onSuccess - Optional success callback
+     * @param onError - Optional error callback
+     * @returns Promise with the API response
+     */
+    post<T = unknown>(payload?: Record<string, unknown>, endpoint?: string, onSuccess?: SuccessCallback<T>, onError?: ErrorCallback): Promise<ApiResponse<T>>;
+    /**
+     * Polls for the status of a running conversation
+     *
+     * @param sessionId - The session ID from the original request
+     * @param executionId - The ID from the RUNNING response
+     * @param options - Polling options
+     * @returns Promise with the poll response
+     */
+    private pollConversationStatus;
+    /**
+     * Polls for the status of a running conversation (public method)
+     *
+     * @param request - Poll request with sessionId, id, and mode
+     * @param onSuccess - Optional success callback
+     * @param onError - Optional error callback
+     * @returns Promise with the poll response
+     */
+    poll(request: PollRequest, onSuccess?: SuccessCallback<PollResponse>, onError?: ErrorCallback): Promise<ApiResponse<PollResponse>>;
+    /**
+     * Validates and normalizes conversation messages
+     */
+    private validateAndNormalizeMessages;
+    /**
+     * Initiates a conversation with the Jiva.ai agent
+     *
+     * @param request - Conversation request (single message or array of messages for context)
+     * @param options - Optional polling options for RUNNING state
+     * @param onSuccess - Optional success callback
+     * @param onError - Optional error callback
+     * @returns Promise with the conversation response
+     */
+    initiateConversation(request: InitiateConversationRequest | InitiateConversationWithContext, options?: PollingOptions, onSuccess?: SuccessCallback<ConversationResponse>, onError?: ErrorCallback): Promise<ApiResponse<ConversationResponse>>;
+    /**
+     * Uploads a file to the File Upload Cache
+     *
+     * @param file - The file to upload (File, Blob, or base64 string)
+     * @param onSuccess - Optional success callback
+     * @param onError - Optional error callback
+     * @returns Promise with the upload response containing the assetId
+     */
+    uploadFile(file: File | Blob | string, onSuccess?: SuccessCallback<UploadResponse>, onError?: ErrorCallback): Promise<ApiResponse<UploadResponse>>;
+    /**
+     * Uploads text to the Text Upload Cache
+     *
+     * @param text - The text content to upload
+     * @param onSuccess - Optional success callback
+     * @param onError - Optional error callback
+     * @returns Promise with the upload response containing the assetId
+     */
+    uploadText(text: string, onSuccess?: SuccessCallback<UploadResponse>, onError?: ErrorCallback): Promise<ApiResponse<UploadResponse>>;
+    /**
+     * Uploads table data to the Table Upload Cache
+     *
+     * @param tableData - The table data to upload (array of objects with consistent structure)
+     * @param onSuccess - Optional success callback
+     * @param onError - Optional error callback
+     * @returns Promise with the upload response containing the assetId
+     */
+    uploadTable(tableData: Record<string, unknown>[], onSuccess?: SuccessCallback<UploadResponse>, onError?: ErrorCallback): Promise<ApiResponse<UploadResponse>>;
+    /**
+     * Helper method to convert File/Blob to base64 string
+     */
+    private fileToBase64;
+    /**
+     * Creates a Server-Sent Events (SSE) connection to subscribe to real-time agent updates
+     * Uses POST request to initiate the connection, then streams SSE events.
+     *
+     * The backend Spring implementation sends an initial "connected" event when the connection is established,
+     * followed by streaming agent update messages.
+     *
+     * @param sessionId - The session ID to subscribe to
+     * @param callbacks - Event callbacks for socket events
+     * @param options - Socket connection options
+     * @returns An object that mimics EventSource interface for compatibility
+     */
+    subscribeToSocket(sessionId: string, callbacks?: SocketCallbacks, options?: SocketOptions): {
+        url: string;
+        close: () => void;
+        readyState: number;
+    };
+}
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,WAAW,EACX,eAAe,EACf,aAAa,EACb,2BAA2B,EAC3B,+BAA+B,EAE/B,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,EAEd,aAAa,EACb,eAAe,EAEhB,MAAM,SAAS,CAAC;AAUjB;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AA0LD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAY;IAE1B,OAAO,CAAC,oBAAoB,CAA6B;IAEzD,OAAO,CAAC,qBAAqB,CAA8B;IAC3D,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,SAAS;IAwB7B;;;;;;;OAOG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAa1B;;;;;;;;OAQG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAC9B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAa1B;;;;;;;OAOG;YACW,sBAAsB;IAuEpC;;;;;;;OAOG;IACG,IAAI,CACR,OAAO,EAAE,WAAW,EACpB,SAAS,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC,EACzC,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IA6DrC;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA0FpC;;;;;;;;OAQG;IACG,oBAAoB,CACxB,OAAO,EAAE,2BAA2B,GAAG,+BAA+B,EACtE,OAAO,GAAE,cAAmB,EAC5B,SAAS,CAAC,EAAE,eAAe,CAAC,oBAAoB,CAAC,EACjD,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAmJ7C;;;;;;;OAOG;IACG,UAAU,CACd,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,EAC1B,SAAS,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,EAC3C,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAgEvC;;;;;;;OAOG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,EAC3C,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAsDvC;;;;;;;OAOG;IACG,WAAW,CACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACpC,SAAS,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC,EAC3C,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAyCvC;;OAEG;YACW,YAAY;IAoB1B;;;;;;;;;;;OAWG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,eAAoB,EAC/B,OAAO,GAAE,aAAkB,GAC1B;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CA8S1D"}