@eloquentai/chat-sdk 0.33.9-dev → 0.33.11-dev

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/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;
-        };
-    };
-};