@eloquentai/chat-sdk 0.28.29-dev → 0.29.0-dev.1

package/dist/lib/appsync-events-client.d.ts

@@ -0,0 +1,71 @@
+/** Lambda-authorizer token (the chat token) or the API key fallback. */
+export type AppSyncEventsAuth = {
+    authorizationToken: string;
+} | {
+    apiKey: string;
+};
+export type AppSyncEventsConnection = {
+    /** Sends unsubscribe, closes the socket, and suppresses onDisconnect. */
+    close: () => void;
+};
+export type WebSocketLike = {
+    readyState: number;
+    send: (data: string) => void;
+    close: () => void;
+    addEventListener: (type: "open" | "message" | "close" | "error", listener: (event: {
+        data?: unknown;
+    }) => void) => void;
+};
+export type ConnectAppSyncEventsOptions = {
+    /** The HTTP Events endpoint from boot settings (chat_settings.app_sync_url). */
+    httpEndpoint: string;
+    auth: AppSyncEventsAuth;
+    /** Channel path, e.g. "/default/chat/<chatId>". */
+    channel: string;
+    /** Called once per published event, with the payload already JSON-parsed. */
+    onEvent: (event: unknown) => void;
+    /**
+     * Called exactly once when an established connection dies (server close,
+     * network drop, keep-alive timeout). NOT called after close(), and not
+     * called for connections that never established (connect() rejects there).
+     */
+    onDisconnect: (reason: string) => void;
+    /** Injectable for tests; defaults to the global WebSocket constructor. */
+    createWebSocket?: (url: string, protocols: string[]) => WebSocketLike;
+};
+export declare const APPSYNC_EVENTS_SUBPROTOCOL = "aws-appsync-event-ws";
+/** connection_init → connection_ack and subscribe → subscribe_success wait. */
+export declare const HANDSHAKE_TIMEOUT_MILLISECONDS = 15000;
+/** Fallback keep-alive death window when the ack doesn't carry one. */
+export declare const DEFAULT_CONNECTION_TIMEOUT_MILLISECONDS = 300000;
+/** How often the keep-alive clock is checked. */
+export declare const KEEP_ALIVE_CHECK_INTERVAL_MILLISECONDS = 5000;
+/**
+ * Derives the realtime WebSocket URL from the HTTP Events endpoint.
+ * Standard AWS domains swap the service subdomain; custom domains keep the
+ * host and only append the path.
+ *   https://xxx.appsync-api.us-east-1.amazonaws.com/event
+ *     → wss://xxx.appsync-realtime-api.us-east-1.amazonaws.com/event/realtime
+ *   https://events.example.com/event
+ *     → wss://events.example.com/event/realtime
+ */
+export declare function deriveRealtimeUrl(httpEndpoint: string): string;
+/**
+ * The authorization object embedded both in the connect subprotocol header
+ * and in every subscribe message. `host` is always the HTTP endpoint's host
+ * (not the realtime host), per the protocol.
+ */
+export declare function buildAuthorization(httpEndpoint: string, auth: AppSyncEventsAuth): Record<string, string>;
+/**
+ * Encodes the authorization object into the `header-…` subprotocol value:
+ * base64url (`+`→`-`, `/`→`_`) with padding stripped — `=` is not a legal
+ * character in a Sec-WebSocket-Protocol token and fails the handshake.
+ */
+export declare function encodeAuthProtocol(authorization: Record<string, string>): string;
+/**
+ * Opens a connection and subscribes to one channel. Resolves once the
+ * subscription is confirmed; rejects if any handshake step fails or times
+ * out (the socket is closed in that case). After resolution, connection
+ * death is reported via onDisconnect exactly once.
+ */
+export declare function connectAppSyncEvents(options: ConnectAppSyncEventsOptions): Promise<AppSyncEventsConnection>;

package/dist/lib/color-aura.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Derives the two gradient stops for the suggested-message "aura" ring from a
+ * base color: one more saturated, one softer (less saturated, slightly
+ * lighter). The rotating conic gradient between them reads as an animated
+ * frame in the same hue family as the bubble background.
+ */
+export interface AuraColors {
+    /** More saturated variant of the base color. */
+    strong: string;
+    /** Softer (desaturated, lighter) variant of the base color. */
+    soft: string;
+}
+/**
+ * Returns the aura gradient stops for a base color. Both stops keep the base
+ * hue but are LIGHTER than the base — a saturation shift alone is invisible
+ * on already-saturated colors, where the ring would match the pill exactly,
+ * and a darkening ring reads as a shadow, which looks off in the chat UI.
+ * The lightness shift is capped near white so very light pills still get a
+ * (subtle) ring. Near-gray bases (e.g. the default muted pill background)
+ * also get a saturation nudge so the ring reads as a colour, not a shadow.
+ * Falls back to a neutral gray pair when the color cannot be parsed.
+ */
+export declare function getAuraColors(baseColor: string | undefined | null): AuraColors;

package/dist/lib/color-contrast.d.ts

@@ -0,0 +1,13 @@
+/**
+ * WCAG-based text color selection: given a background color, returns black or
+ * white, whichever has the higher contrast ratio (WCAG 2.x relative
+ * luminance, https://www.w3.org/TR/WCAG21/#dfn-relative-luminance).
+ */
+/**
+ * Returns "#000000" or "#ffffff", whichever contrasts more with the given
+ * background color (WCAG 2.x relative luminance, biased toward white for
+ * saturated mid-tones — see BLACK_PREFERENCE_THRESHOLD). Supports #rgb,
+ * #rrggbb and rgb()/rgba() strings; falls back to black (the safer choice on
+ * light UI defaults) when unparseable.
+ */
+export declare function getContrastingTextColor(backgroundColor: string | undefined | null): "#000000" | "#ffffff";

package/dist/lib/config.d.ts

@@ -1,4 +1,3 @@
-export declare const LOGO_ANIMATED_URL: string;
 /**
  * Returns the API URL based on the provided custom URL or the default API URL.
  * @returns The API URL.
@@ -9,17 +8,3 @@ export declare function getApiUrl(): string;
  * @returns The Region API URL.
  */
 export declare function getRegionApiUrl(): string;
-/**
- * Returns the Amplify configuration for the API.
- * @returns The Amplify configuration.
- */
-export declare function amplifyConfig(appSyncUrl?: string | null, appSyncApiKey?: string | null, appSyncRegion?: string | null): {
-    readonly API: {
-        readonly Events: {
-            readonly endpoint: string;
-            readonly region: string;
-            readonly defaultAuthMode: "apiKey";
-            readonly apiKey: string;
-        };
-    };
-};

package/dist/lib/cookies.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Read a cookie value by name.
+ * @returns The decoded cookie value, or null if it doesn't exist or there's no document.
+ */
+export declare function getCookie(name: string): string | null;
+/**
+ * Set a cookie with a given name, value, and TTL in hours.
+ */
+export declare function setCookie(name: string, value: string, hours: number): void;
+/**
+ * Delete a cookie by name.
+ */
+export declare function deleteCookie(name: string): void;

package/dist/lib/eloquent-ai-api-client.d.ts

@@ -10,6 +10,7 @@ export interface ConversationApiResponse {
 }
 export interface CreateConversationApiResponse {
     chat_id: string;
+    chat_token: string;
 }
 export interface IdentifyUserApiResponse {
     result: string;
@@ -41,20 +42,35 @@ export interface BootResponse {
         welcome_message?: string | null;
         footer_html?: string | null;
         suggested_messages: boolean;
+        suggested_message_texts?: string[] | null;
+        suggested_message_aura?: boolean | null;
+        suggested_message_shine?: boolean | null;
         auto_display_welcome_message: boolean;
         collect_user_feedback: boolean;
         theme: "light" | "dark";
         avatar_url?: string | null;
         user_bubble_color?: string | null;
+        bot_bubble_color?: string | null;
+        suggested_message_bubble_color?: string | null;
+        user_bubble_text_color?: string | null;
+        bot_bubble_text_color?: string | null;
+        suggested_message_bubble_text_color?: string | null;
         app_sync_api_key: string;
-        app_sync_token?: string;
         app_sync_url: string;
         app_sync_region: string;
         title?: string;
         subtitle?: string;
+        is_active?: boolean;
+        /** Open the chat window on load (desktop only). Wins over the isInitiallyOpen prop, but a `true` here never overrides the user's closed-cookie. */
+        initial_open?: boolean | null;
+        /** Show the close (X) button in the chat header. Always wins over the hasCloseButton prop. */
+        close_button?: boolean | null;
+        /** Show the clear-conversation button in the chat header. Always wins over the hasCleanChatButton prop. */
+        clean_chat_button?: boolean | null;
+        /** Auto-hide delay for the proactive message, in milliseconds. Always wins over the proactiveMessageHideDelay prop. */
+        proactive_message_hide_delay?: number | null;
     };
 }
-export declare function isChatClosedMessage(msg: MessageResponse): boolean;
 export declare class EloquentAiApiClient {
     private httpClient;
     private userId;
@@ -69,6 +85,8 @@ export declare class EloquentAiApiClient {
      */
     reset(): void;
     setRegion(region: string): void;
+    getChatToken(): string | null;
+    setChatToken(token: string | null): void;
     /**
      * Get organization data by app ID
      */

package/dist/lib/http.d.ts

@@ -15,8 +15,11 @@ export declare class HttpClient {
     private baseURL;
     private headers;
     private region;
+    private chatToken;
     constructor(config: HttpClientConfig);
     setRegion(region: string): void;
+    setChatToken(token: string | null): void;
+    getChatToken(): string | null;
     private request;
     get<T>(url: string): Promise<T>;
     post<T, D>(url: string, data: D): Promise<T>;

package/dist/lib/retry.d.ts

@@ -0,0 +1,10 @@
+interface WithRetryOptions {
+    retries?: number;
+    minDelayMs?: number;
+    maxDelayMs?: number;
+    factor?: number;
+}
+/** Retries on network errors and 5xx/429 responses; other errors bail immediately. */
+export declare function isRetryableError(error: unknown): boolean;
+export declare function withRetry<T>(operation: () => Promise<T>, options?: WithRetryOptions): Promise<T>;
+export {};

package/dist/lib/utils.d.ts

@@ -1,9 +1,2 @@
 import { ClassValue } from 'clsx';
-import { ServerError } from './http';
 export declare function cn(...inputs: ClassValue[]): string;
-/**
- * Wraps a Promise and returns a tuple containing the result or error
- * @param promise Promise to wrap
- * @returns [result, error] - result is null if error occurred, error is null if no error occurred
- */
-export declare function wrapPromise<T, E = ServerError>(promise: Promise<T>): Promise<[T, null] | [null, E]>;

package/dist/lib/wrap-promise.d.ts

@@ -0,0 +1,7 @@
+import { ServerError } from './http';
+/**
+ * Wraps a Promise and returns a tuple containing the result or error
+ * @param promise Promise to wrap
+ * @returns [result, error] - result is null if error occurred, error is null if no error occurred
+ */
+export declare function wrapPromise<T, E = ServerError>(promise: Promise<T>): Promise<[T, null] | [null, E]>;