@origonai/web-sdk 0.1.3 → 0.1.4

package/README.md

@@ -66,6 +66,15 @@ await client.endSession(sessionId)
 - `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

@@ -174,6 +174,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 +261,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 +386,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.
@@ -418,6 +488,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;
     }>;
@@ -493,6 +565,8 @@ export declare class SessionManager {
     private requireHttp;
 }
 
+export declare function sessionMatchesSearch(summary: SessionSummary, normalizedSearch: string): boolean;
+
 export declare interface SessionSummary {
     sessionId: string;
     subject: string;