@origonai/web-sdk 0.1.3 → 0.1.5

package/README.md

@@ -59,13 +59,23 @@ await client.endSession(sessionId)
 ### Sessions
 - `startSession({ channel, sessionId?, data? })` — originate a chat or voice session (issues `POST /session/start`)
 - `joinSession({ channel, sessionId, url, token, chat?, voice? })` — attach to a session provisioned out of band, skipping `POST /session/start`; `chat.recovery` opts into caller-authorized server-replay recovery, while `voice.receiveOnly` starts playout with no microphone and awaits server uplink mute before connecting (see [Joining a provisioned session](#joining-a-provisioned-session))
-- `endSession(sessionId)` — close a session
+- `endChat(sessionId)` — end an owned customer chat, retaining its transcript; duplicate requests coalesce.
+- `endSession(sessionId)` — close the local session; customer chat cleanup detaches without ending the conversation
 - `endAllSessions()` — close every active session
 - `migrateSessionId(oldId, newId)` — re-key a live session whose id the control plane reassigned mid-call, without a media re-dial
 - `activeSessionIds()` — list active sessions
 - `getSessions()` — GET `/sessions` (prior sessions; every `SessionSummary`
   includes required live-owner `active: boolean`)
 - `getSession(sessionId)` — GET `/session/{id}` (transcript + control)
+- `getSessionsPage({ pageSize?, cursor?, search?, signal? })` — fetch a strict
+  directory page (50 by default, 100 maximum); `search` matches subject,
+  contact name, latest visible message text, and attachment names
+- `getSessionPage(sessionId, { pageSize?, cursor?, signal? })` — fetch a strict
+  chronological history page (100 by default, 250 maximum)
+- `SessionDirectoryPager` / `SessionHistoryPager` — generation-fenced page
+  reducers for dedupe, live-event reconciliation, prepend accumulation, and
+  bounded empty-page continuation; keep search state separate from the default
+  cached directory
 
 ### Chat
 - `sendMessage(sessionId, payload)` — post a message with optional `metadata: {audience}`; ordinary participant sends omit it and the server resolves the audience to `all`. The SDK fires `onMessageAdded` immediately with `status: 'sending'`, then `onMessageUpdated` with `'delivered'` or `'failed'` after the server acks

package/dist/index.d.ts

@@ -54,6 +54,8 @@ export declare class ClientError extends Error {
     static serverUnavailable(status: number): ClientError;
     static http(status: number, code: string, message: string): ClientError;
     static attachment(code: AttachmentErrorCode, message: string): ClientError;
+    static chatEndPending(): ClientError;
+    static chatEndUnconfirmed(): ClientError;
     static cancelled(): ClientError;
     static other(message: string): ClientError;
     static session(message: string): ClientError;
@@ -66,7 +68,7 @@ export declare interface ClientErrorJSON {
     message: string;
 }
 
-export declare type ClientErrorKind = 'notInitialized' | 'noSession' | 'session' | 'missingField' | 'serverUnavailable' | 'http' | 'attachment' | 'cancelled' | 'other';
+export declare type ClientErrorKind = 'notInitialized' | 'noSession' | 'session' | 'missingField' | 'serverUnavailable' | 'http' | 'attachment' | 'cancelled' | 'chatEndPending' | 'chatEndUnconfirmed' | 'other';
 
 /**
  * Cached response of `POST /config`. Shape matches the backend wire
@@ -174,6 +176,8 @@ export declare interface JoinSessionOptions {
     chat?: ProvisionedChatJoinOptions;
 }
 
+export declare const MAX_EMPTY_PAGE_CONTINUATIONS = 8;
+
 export declare interface Message {
     role: MessageRole;
     id: string;
@@ -259,6 +263,8 @@ export declare type MessageStatus = 'sending' | 'delivered' | 'failed';
 /** Mirrors `media-server::MuteScope`. */
 export declare type MuteScope = 'none' | 'uplink' | 'downlink' | 'both';
 
+export declare function normalizeSearchField(value: string): string;
+
 /**
  * A non-OK orpc reply (an ERROR frame). `code` is the wire status — a base code
  * (§5) or a `0x1000+` auth code; `reason` is the server's UTF-8 message.
@@ -382,11 +388,77 @@ export declare interface SendMessagePayload {
 
 export declare type SessionControl = 'ai' | 'user';
 
+export declare interface SessionDirectoryPage {
+    sessions: SessionSummary[];
+    nextCursor: string | null;
+}
+
+export declare interface SessionDirectoryPageOptions {
+    /** Defaults to 50; server maximum is 100. */
+    pageSize?: number;
+    cursor?: string;
+    search?: string;
+    signal?: AbortSignal;
+}
+
+export declare class SessionDirectoryPager {
+    private generationValue;
+    private query;
+    private live;
+    private value;
+    get generation(): number;
+    get search(): string | null;
+    get state(): Readonly<SessionDirectoryPageState>;
+    begin(search?: string, cached?: SessionSummary[]): number;
+    applyLive(summary: SessionSummary): void;
+    merge(generation: number, page: SessionDirectoryPage, firstPage: boolean): boolean;
+    canLoadMore(): boolean;
+}
+
+export declare interface SessionDirectoryPageState {
+    sessions: SessionSummary[];
+    nextCursor: string | null;
+    emptyContinuations: number;
+}
+
 export declare interface SessionHistory {
     history: Message[];
     control: SessionControl;
 }
 
+export declare interface SessionHistoryPage {
+    history: Message[];
+    control: SessionControl;
+    nextCursor: string | null;
+}
+
+export declare interface SessionHistoryPageOptions {
+    /** Defaults to 100; server maximum is 250. */
+    pageSize?: number;
+    cursor?: string;
+    signal?: AbortSignal;
+}
+
+export declare class SessionHistoryPager {
+    private generationValue;
+    private live;
+    private value;
+    get generation(): number;
+    get state(): Readonly<SessionHistoryPageState>;
+    begin(cached?: SessionHistory): number;
+    applyLive(message: Message): void;
+    removeLive(identity: Pick<Message, 'id' | 'localId'>): void;
+    merge(generation: number, page: SessionHistoryPage, firstPage: boolean): boolean;
+    canLoadMore(): boolean;
+}
+
+export declare interface SessionHistoryPageState {
+    history: Message[];
+    control: SessionControl;
+    nextCursor: string | null;
+    emptyContinuations: number;
+}
+
 /**
  * Top-level entry point. One instance per app — see `getSessionManager()`
  * for the singleton accessor.
@@ -405,6 +477,8 @@ export declare class SessionManager {
     private attachmentBearer;
     private readonly dispatcher;
     private readonly sessions;
+    private readonly chatOwners;
+    private readonly endingChats;
     private readonly pendingUploads;
     initialize(credentials: Credentials): void;
     authenticate(): Promise<ConfigData>;
@@ -418,6 +492,8 @@ export declare class SessionManager {
     }>;
     getSessions(): Promise<SessionSummary[]>;
     getSession(sessionId: string): Promise<SessionHistory>;
+    getSessionsPage(options?: SessionDirectoryPageOptions): Promise<SessionDirectoryPage>;
+    getSessionPage(sessionId: string, options?: SessionHistoryPageOptions): Promise<SessionHistoryPage>;
     startSession(opts: StartSessionOptions): Promise<{
         sessionId: string;
     }>;
@@ -443,6 +519,9 @@ export declare class SessionManager {
      * the MoQ `ConnectOk` lands — so this method must NOT fire it for voice.
      */
     private attachSession;
+    private prepareChatOpen;
+    /** End the customer conversation; endSession remains local cleanup/Leave. */
+    endChat(sessionId: string): Promise<void>;
     endSession(sessionId: string): Promise<void>;
     endAllSessions(): Promise<void>;
     /**
@@ -493,6 +572,8 @@ export declare class SessionManager {
     private requireHttp;
 }
 
+export declare function sessionMatchesSearch(summary: SessionSummary, normalizedSearch: string): boolean;
+
 export declare interface SessionSummary {
     sessionId: string;
     subject: string;