@qafka/react-native 2.0.0

package/dist/services/BackendService.d.ts

@@ -0,0 +1,156 @@
+import { ChatResponse } from '../types';
+/**
+ * Backend API Service using native fetch
+ */
+export declare class BackendService {
+    private baseURL;
+    private apiKey;
+    private subProjectId;
+    private endUserId;
+    private endUserData;
+    private timeout;
+    private bundleId;
+    private appVersion;
+    private deviceModel;
+    private sessionTokenGetter;
+    private attestationManager;
+    private refreshing;
+    private locale;
+    private onToolDataRequested;
+    private readonly toolDataResolvedFor;
+    private static readonly RESOLVER_TIMEOUT_MS;
+    constructor(apiKey: string | null, apiUrl?: string, subProjectId?: string);
+    setSessionTokenGetter(getter: () => Promise<string | null>): void;
+    /**
+     * Store the validated end-user identity for subsequent chat requests.
+     * Called by the React component on mount and whenever the `endUserId` /
+     * `endUserData` props change. Validation happens upstream
+     * (`validate-end-user.ts`) so this method only persists the result.
+     */
+    setEndUser(endUserId: string, endUserData?: Record<string, unknown>): void;
+    setAttestationManager(am: {
+        refresh(): Promise<string | null>;
+    }): void;
+    /**
+     * Single-flight refresh: concurrent callers share the same in-flight promise.
+     * Prevents multiple parallel re-attests when several requests fail simultaneously.
+     */
+    private refreshSession;
+    /**
+     * fetch() with automatic session refresh when the backend signals it —
+     * reactively on a 429 refresh hint, proactively when the budget header is
+     * low. Caller passes an init that already has Authorization/x-api-key set;
+     * on retry, only the Bearer header is swapped.
+     */
+    private fetchWithRefresh;
+    /**
+     * Tool Data Channel: register the partner-provided resolver that
+     * supplies transient PII (`{{tooldata.X}}` substitution) bags. Called from
+     * QafkaSDK with the `onToolDataRequested` prop. Pass `null` to clear.
+     */
+    setOnToolDataRequested(resolver: ((tool: {
+        key: string;
+        name: string;
+    }) => Record<string, unknown> | Promise<Record<string, unknown>>) | null): void;
+    /**
+    * explicit-intent locale. Only included in sdkContext when set —
+    * Qafka.tsx wires this from the `locale` prop. Developer can also call
+    * directly via QafkaSDK.setLocale().
+    */
+    setLocale(locale: string | null): void;
+    /**
+    * Build the SDK context attached to every request: universal temporal
+    * fields plus locale when the developer has set it.
+    */
+    private buildSdkContext;
+    /**
+    * Get security headers for API requests
+    */
+    private getSecurityHeaders;
+    /**
+     * Tool Data Channel: invokes the partner resolver, POSTs the
+     * opaque bag to /chat/tool-data. Per-execId dedupe, soft timeout, fail-soft.
+     * Called by the tool_suggestions SSE handler when `needData=true`.
+     */
+    private resolveAndPostToolData;
+    /**
+     * POST tooldata bag to backend. Uses the standard SDK auth headers (API key
+     * + device attestation session token) — same chain as sendMessageStream.
+     * No retry, no body persistence; 64KB cap enforced server-side.
+     */
+    private postToolData;
+    /**
+    * Make HTTP request with timeout
+    */
+    private fetchWithTimeout;
+    /**
+    * Handle response errors with detailed messages
+    */
+    private handleResponse;
+    /**
+    * Send chat message to backend
+    */
+    sendMessage(message: string, sessionId: string, context?: Record<string, any>, contextDescription?: string, isInitialMessage?: boolean): Promise<ChatResponse>;
+    /**
+    * Get conversation history
+    */
+    getHistory(sessionId: string, limit?: number): Promise<any>;
+    /**
+    * Delete conversation
+    */
+    deleteConversation(sessionId: string): Promise<void>;
+    /**
+    * Get project theme
+    */
+    getTheme(): Promise<any>;
+    /**
+    * Send message with streaming response
+    * React Native compatible version using XMLHttpRequest
+    */
+    sendMessageStream(message: string, sessionId: string, onChunk: (chunk: string) => void, onComplete: (response: ChatResponse) => void, onError: (error: Error) => void, context?: Record<string, any>, contextDescription?: string, onToolSuggestions?: (tools: any[], conversationId?: string, messageId?: string) => void, // Tool suggestions callback
+    isInitialMessage?: boolean, onActionResult?: (results: Array<{
+        actionType: string;
+        success: boolean;
+        message: string;
+    }>) => void, // Action result callback
+    onStepCompleted?: (result: {
+        tool: string;
+        step: string;
+        data: Record<string, any>;
+        actionResults?: Array<{
+            actionType: string;
+            success: boolean;
+            message: string;
+        }>;
+    }) => void, // Step completed callback
+    onFileUploadRequest?: (request: any) => void, onExtractionResult?: (result: any) => void, onToolStatus?: (event: {
+        toolKey: string;
+        message: string;
+        stage: string;
+    }) => void, onToolResultPayload?: (event: {
+        toolKey: string;
+        data: unknown;
+        uiConfig?: any;
+    }) => void, onFinalChunk?: (content: string) => void): Promise<void>;
+    /**
+    * Post a tool result back to the backend so the AI can continue its turn.
+    * Streams back `final_chunk` and `done` events.
+    */
+    postToolResult(payload: {
+        conversationId: string;
+        messageId: string;
+        toolKey: string;
+        data: unknown;
+        sdkContext?: Record<string, unknown>;
+    }, onFinalChunk: (content: string) => void, onDone: () => void, onError: (err: Error) => void, onCard?: (card: {
+        templateId: string;
+        templateSlug: string;
+        definition: any;
+        data: any;
+    }) => void): Promise<void>;
+    uploadFile(toolId: string, file: {
+        uri: string;
+        name: string;
+        type: string;
+    }, conversationId?: string): Promise<any>;
+}