@origonai/web-sdk 0.1.2 → 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
@@ -175,6 +184,7 @@ client.initialize({
 
 const { sessionId } = await client.startSession({ channel: 'voice' })
 await client.setMute(sessionId, 'uplink')   // 'uplink' | 'downlink' | 'both' | 'none'
+await client.sendDtmf(sessionId, '5')       // one of 0-9, *, #, A-D
 
 const off = client.subscribeAudioStats(sessionId, ({ outboundLevel, inboundLevel }) => {
   // VU meters at ~5 Hz
@@ -192,6 +202,11 @@ Voice requires:
 
 The browser opens a single WebTransport to `<media-server>/web`, sends a B2BUA `Connect` over the control sub-stream, and pumps 20 ms Opus frames as `ObjectDatagram`s with `group_id = floor(Date.now()/1000) - serverEpochUnix`. Reconnect is Tier-3 only (`Resume` verb) with `[100, 250, 500, 1000]` ms backoff.
 
+`sendDtmf` resolves when Media acknowledges publication to the active CX flow.
+It rejects while the voice transport is reconnecting and is never queued or
+replayed after `Resume`. The SDK does not play a local tone or expose a peer
+DTMF callback.
+
 ## Joining a provisioned session
 
 `startSession` originates a session by calling `POST /session/start` itself.

package/dist/index.d.ts

@@ -150,6 +150,9 @@ export declare type DisconnectReason = {
     detail: string;
 };
 
+/** Complete programmatic DTMF alphabet; lowercase is intentionally invalid. */
+export declare type DtmfDigit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '*' | '#' | 'A' | 'B' | 'C' | 'D';
+
 export declare function getSessionManager(): SessionManager;
 
 /**
@@ -171,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;
@@ -256,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.
@@ -379,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.
@@ -415,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;
     }>;
@@ -457,6 +532,8 @@ export declare class SessionManager {
     notifyTyping(sessionId: string, metadata?: TypingMetadata): void;
     stopTyping(sessionId: string): void;
     setMute(sessionId: string, scope: MuteScope): Promise<void>;
+    /** Send one DTMF symbol to the active CX flow for a voice session. */
+    sendDtmf(sessionId: string, digit: DtmfDigit): Promise<void>;
     /** Enable microphone coaching on a receive-only voice join. */
     enableCapture(sessionId: string): Promise<void>;
     /** Return a coaching voice join to Listen and release its microphone. */
@@ -488,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;