@manonero/chat-client-sdk 0.0.1-beta.1

package/dist/realtime/NotificationHubClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationHubClient.js","sourceRoot":"","sources":["../../src/realtime/NotificationHubClient.ts"],"names":[],"mappings":"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"}

package/dist/realtime/ReconnectionManager.d.ts

@@ -0,0 +1,65 @@
+import type { ChatHubClient } from './ChatHubClient.js';
+import type { NotificationHubClient } from './NotificationHubClient.js';
+export interface ReconnectionManagerOptions {
+    /** ChatHub client to manage */
+    chatHub: ChatHubClient;
+    /** NotificationHub client to manage */
+    notificationHub: NotificationHubClient;
+    /**
+     * Called when reconnect is rejected with 401 (token likely expired).
+     * Should return a fresh token, or null to cancel reconnect attempts.
+     *
+     * The returned token should be committed to the application's token store
+     * so that the shared tokenProvider reflects the new value immediately —
+     * the SDK will then pick it up on the next connect() call.
+     */
+    onTokenExpired?: () => Promise<string | null>;
+}
+/**
+ * ReconnectionManager coordinates reconnection for both ChatHub and NotificationHub.
+ *
+ * Responsibilities:
+ * 1. Listens for `disconnected` events from both hubs and attempts to reconnect.
+ * 2. After ChatHub reconnects, re-joins all previously joined conversations.
+ * 3. On 401-style reconnect failures, calls `onTokenExpired` to obtain a fresh token,
+ *    then retries the connection once.
+ *
+ * Note on token propagation:
+ *   - SignalR tokens are provided at connect-time via accessTokenFactory.
+ *   - Both hub clients call tokenProvider() on every new connect(), so updating
+ *     the token in the provider is sufficient before calling connect() again.
+ *   - Existing active connections cannot receive a new token mid-session.
+ */
+export declare class ReconnectionManager {
+    private readonly chatHub;
+    private readonly notificationHub;
+    private readonly onTokenExpired?;
+    private unsubscribeChatDisconnected?;
+    private unsubscribeNotificationDisconnected?;
+    /** Whether the manager is actively managing reconnections */
+    private active;
+    constructor(options: ReconnectionManagerOptions);
+    /**
+     * Start managing reconnections. Attaches `disconnected` listeners to both hubs.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    start(): void;
+    /**
+     * Stop managing reconnections and detach all listeners.
+     */
+    stop(): void;
+    private handleChatDisconnected;
+    private handleNotificationDisconnected;
+    /**
+     * Determine if the disconnect error is likely due to token expiry (HTTP 401).
+     * SignalR surfaces these conditions only as text in the error message, so this
+     * is a best-effort heuristic that matches the most common phrasings.
+     */
+    private isTokenExpiredError;
+    /**
+     * Attempt to reconnect a hub with exponential backoff (max 3 retries).
+     * After a successful connect, calls `afterConnect` to restore subscriptions.
+     */
+    private reconnectHub;
+}
+//# sourceMappingURL=ReconnectionManager.d.ts.map

package/dist/realtime/ReconnectionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReconnectionManager.d.ts","sourceRoot":"","sources":["../../src/realtime/ReconnectionManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,WAAW,0BAA0B;IACzC,+BAA+B;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,uCAAuC;IACvC,eAAe,EAAE,qBAAqB,CAAC;IACvC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA+B;IAE/D,OAAO,CAAC,2BAA2B,CAAC,CAAa;IACjD,OAAO,CAAC,mCAAmC,CAAC,CAAa;IAEzD,6DAA6D;IAC7D,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,0BAA0B;IAM/C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAeb;;OAEG;IACH,IAAI,IAAI,IAAI;YAYE,sBAAsB;YAmBtB,8BAA8B;IAqB5C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;OAGG;YACW,YAAY;CA2B3B"}

package/dist/realtime/ReconnectionManager.js

@@ -0,0 +1,129 @@
+// realtime/ReconnectionManager.ts — Coordinates auto-reconnect for both hubs
+import { HubConnectionState } from '@microsoft/signalr';
+/**
+ * ReconnectionManager coordinates reconnection for both ChatHub and NotificationHub.
+ *
+ * Responsibilities:
+ * 1. Listens for `disconnected` events from both hubs and attempts to reconnect.
+ * 2. After ChatHub reconnects, re-joins all previously joined conversations.
+ * 3. On 401-style reconnect failures, calls `onTokenExpired` to obtain a fresh token,
+ *    then retries the connection once.
+ *
+ * Note on token propagation:
+ *   - SignalR tokens are provided at connect-time via accessTokenFactory.
+ *   - Both hub clients call tokenProvider() on every new connect(), so updating
+ *     the token in the provider is sufficient before calling connect() again.
+ *   - Existing active connections cannot receive a new token mid-session.
+ */
+export class ReconnectionManager {
+    constructor(options) {
+        /** Whether the manager is actively managing reconnections */
+        this.active = false;
+        this.chatHub = options.chatHub;
+        this.notificationHub = options.notificationHub;
+        this.onTokenExpired = options.onTokenExpired;
+    }
+    /**
+     * Start managing reconnections. Attaches `disconnected` listeners to both hubs.
+     * Safe to call multiple times — subsequent calls are no-ops.
+     */
+    start() {
+        if (this.active)
+            return;
+        this.active = true;
+        this.unsubscribeChatDisconnected = this.chatHub.on('disconnected', (err) => void this.handleChatDisconnected(err));
+        this.unsubscribeNotificationDisconnected = this.notificationHub.on('disconnected', (err) => void this.handleNotificationDisconnected(err));
+    }
+    /**
+     * Stop managing reconnections and detach all listeners.
+     */
+    stop() {
+        this.active = false;
+        this.unsubscribeChatDisconnected?.();
+        this.unsubscribeNotificationDisconnected?.();
+        this.unsubscribeChatDisconnected = undefined;
+        this.unsubscribeNotificationDisconnected = undefined;
+    }
+    // ---------------------------------------------------------------------------
+    // Disconnect handlers
+    // ---------------------------------------------------------------------------
+    async handleChatDisconnected(err) {
+        if (!this.active)
+            return;
+        // Skip reconnect when the user (or ChatClient.disconnect/logout) closed it.
+        if (this.chatHub.intentionallyClosed)
+            return;
+        // withAutomaticReconnect already tried — this is a terminal disconnect.
+        // Attempt one more manual reconnect after optional token refresh.
+        if (this.isTokenExpiredError(err)) {
+            const newToken = await this.onTokenExpired?.();
+            if (!newToken)
+                return; // Client chose to abandon reconnect
+        }
+        await this.reconnectHub(() => this.chatHub.state, () => this.chatHub.connect(), () => this.chatHub.rejoinConversations());
+    }
+    async handleNotificationDisconnected(err) {
+        if (!this.active)
+            return;
+        if (this.notificationHub.intentionallyClosed)
+            return;
+        if (this.isTokenExpiredError(err)) {
+            const newToken = await this.onTokenExpired?.();
+            if (!newToken)
+                return;
+        }
+        await this.reconnectHub(() => this.notificationHub.state, () => this.notificationHub.connect(), 
+        // NotificationHub has no client-callable methods — nothing to restore.
+        () => Promise.resolve());
+    }
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Determine if the disconnect error is likely due to token expiry (HTTP 401).
+     * SignalR surfaces these conditions only as text in the error message, so this
+     * is a best-effort heuristic that matches the most common phrasings.
+     */
+    isTokenExpiredError(err) {
+        if (!err)
+            return false;
+        const msg = (err.message ?? '').toLowerCase();
+        return (msg.includes('401') ||
+            msg.includes('unauthorized') ||
+            msg.includes('expired') ||
+            msg.includes('invalid_token') ||
+            msg.includes('invalid token'));
+    }
+    /**
+     * Attempt to reconnect a hub with exponential backoff (max 3 retries).
+     * After a successful connect, calls `afterConnect` to restore subscriptions.
+     */
+    async reconnectHub(getState, connect, afterConnect) {
+        if (getState() === HubConnectionState.Connected)
+            return;
+        const delays = [2000, 5000, 10000]; // ms — 2s, 5s, 10s
+        for (const delay of delays) {
+            if (!this.active)
+                return;
+            await sleep(delay);
+            if (getState() === HubConnectionState.Connected)
+                return;
+            try {
+                await connect();
+                // Successful connect — restore state
+                await afterConnect().catch(() => {
+                    // Best-effort: don't fail reconnect if re-subscribe fails
+                });
+                return;
+            }
+            catch {
+                // Retry after next delay
+            }
+        }
+        // All retries exhausted — emit is handled by the hub's onclose handler
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=ReconnectionManager.js.map

package/dist/realtime/ReconnectionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReconnectionManager.js","sourceRoot":"","sources":["../../src/realtime/ReconnectionManager.ts"],"names":[],"mappings":"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"}

package/dist/types/auth.d.ts

@@ -0,0 +1,30 @@
+export interface GoogleLoginRequest {
+    idToken: string;
+}
+export interface DsAccountLoginRequest {
+    token: string;
+}
+export interface DevLoginRequest {
+    username: string;
+    password: string;
+}
+export type LoginRequest = GoogleLoginRequest | DsAccountLoginRequest | DevLoginRequest;
+export interface AuthResponse {
+    token: string;
+    expiresAt: string;
+    user: AuthUserInfo;
+}
+/**
+ * Authenticated user information returned from login.
+ * NOTE: avatar is a plain string URL (NOT a MediaReference).
+ */
+export interface AuthUserInfo {
+    id: string;
+    uniqueName: string;
+    fullName: string;
+    /** Plain URL string, not MediaReference. Server may return `null` explicitly when no avatar exists. */
+    avatar?: string | null;
+    /** Role of the user, e.g. 'dev'. null for Google/DsAccount users. */
+    role?: string | null;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/types/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,qBAAqB,GAAG,eAAe,CAAC;AAExF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB"}

package/dist/types/auth.js

@@ -0,0 +1,3 @@
+// auth.ts — Authentication request/response types
+export {};
+//# sourceMappingURL=auth.js.map

package/dist/types/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/types/auth.ts"],"names":[],"mappings":"AAAA,kDAAkD"}

package/dist/types/block.d.ts

@@ -0,0 +1,163 @@
+export type TextFormat = 'Plain' | 'Markdown' | 'Html' | 'ProseMirrorJson';
+export type ButtonAction = 'Postback' | 'Url' | 'Call' | 'Copy';
+export type ButtonStyle = 'Default' | 'Primary' | 'Danger';
+export type ChoiceMode = 'Single' | 'Multiple';
+export type QuickReplyAction = 'SendText' | 'Postback' | 'Url';
+export type MentionType = 'User' | 'All' | 'Here' | 'Role';
+import type { MediaReference } from './common.js';
+export interface TextBlock {
+    $type: 'text';
+    format: TextFormat;
+    content: string;
+    plainText: string | null;
+}
+export interface ImageBlock {
+    $type: 'image';
+    source: MediaReference;
+    thumbnail: MediaReference | null;
+    altText: string | null;
+    width: number | null;
+    height: number | null;
+    caption: string | null;
+    fileSizeBytes: number | null;
+}
+export interface VideoBlock {
+    $type: 'video';
+    source: MediaReference;
+    thumbnail: MediaReference | null;
+    caption: string | null;
+    durationSeconds: number | null;
+    mimeType: string | null;
+    fileSizeBytes: number | null;
+}
+export interface AudioBlock {
+    $type: 'audio';
+    source: MediaReference;
+    durationSeconds: number | null;
+    mimeType: string | null;
+    transcript: string | null;
+    fileSizeBytes: number | null;
+}
+export interface FileBlock {
+    $type: 'file';
+    source: MediaReference;
+    fileName: string;
+    mimeType: string | null;
+    fileSizeBytes: number | null;
+}
+export interface LinkPreviewBlock {
+    $type: 'linkPreview';
+    url: string;
+    title: string | null;
+    description: string | null;
+    image: MediaReference | null;
+    siteName: string | null;
+}
+export interface EmbedBlock {
+    $type: 'embed';
+    url: string;
+    html: string | null;
+    width: number | null;
+    height: number | null;
+}
+export interface LocationBlock {
+    $type: 'location';
+    latitude: number;
+    longitude: number;
+    name: string | null;
+    address: string | null;
+}
+export interface ContactBlock {
+    $type: 'contact';
+    displayName: string;
+    phone: string | null;
+    email: string | null;
+    organization: string | null;
+}
+export interface ChoiceOption {
+    label: string;
+    value: string;
+    selected: boolean;
+}
+export interface ChoiceBlock {
+    $type: 'choice';
+    prompt: string;
+    options: ChoiceOption[];
+    mode: ChoiceMode;
+    submitted: boolean;
+}
+export interface CardField {
+    label: string;
+    value: string;
+}
+export interface ActionButton {
+    label: string;
+    action: ButtonAction;
+    value?: string | null;
+    style: ButtonStyle;
+}
+export interface CardBlock {
+    $type: 'card';
+    title: string | null;
+    subtitle: string | null;
+    image: MediaReference | null;
+    fields: CardField[] | null;
+    buttons: ActionButton[] | null;
+}
+export interface CarouselBlock {
+    $type: 'carousel';
+    cards: CardBlock[];
+}
+export interface DividerBlock {
+    $type: 'divider';
+}
+export interface CustomBlock {
+    $type: 'custom';
+    type: string;
+    data: Record<string, unknown> | null;
+}
+/** Discriminated union of all message block types */
+export type Block = TextBlock | ImageBlock | VideoBlock | AudioBlock | FileBlock | LinkPreviewBlock | EmbedBlock | LocationBlock | ContactBlock | ChoiceBlock | CardBlock | CarouselBlock | DividerBlock | CustomBlock;
+export interface QuickReply {
+    label: string;
+    action: QuickReplyAction;
+    value: string | null;
+    icon: string | null;
+}
+export interface Mention {
+    type: MentionType;
+    targetId: string | null;
+    displayName: string;
+    offset: number | null;
+    length: number | null;
+}
+export declare function isTextBlock(b: Block): b is TextBlock;
+export declare function isImageBlock(b: Block): b is ImageBlock;
+export declare function isVideoBlock(b: Block): b is VideoBlock;
+export declare function isAudioBlock(b: Block): b is AudioBlock;
+export declare function isFileBlock(b: Block): b is FileBlock;
+export declare function isLinkPreviewBlock(b: Block): b is LinkPreviewBlock;
+export declare function isEmbedBlock(b: Block): b is EmbedBlock;
+export declare function isLocationBlock(b: Block): b is LocationBlock;
+export declare function isContactBlock(b: Block): b is ContactBlock;
+export declare function isChoiceBlock(b: Block): b is ChoiceBlock;
+export declare function isCardBlock(b: Block): b is CardBlock;
+export declare function isCarouselBlock(b: Block): b is CarouselBlock;
+export declare function isDividerBlock(b: Block): b is DividerBlock;
+export declare function isCustomBlock(b: Block): b is CustomBlock;
+/**
+ * Re-construct a block object with `$type` as the first property.
+ *
+ * The server's polymorphic deserializer requires `$type` to appear as the
+ * first property in every block JSON payload (gateway spec §13). JavaScript
+ * engines preserve insertion order for string keys (ES2015+), so reassembling
+ * via destructure-then-spread guarantees the correct serialization order.
+ *
+ * `CarouselBlock` is the only block type containing nested blocks (its `cards`
+ * array of `CardBlock`); each nested card is recursively normalized so the
+ * spec rule holds at every level.
+ */
+export declare function withTypeFirst<T extends Block>(block: T): T;
+/** Apply {@link withTypeFirst} to every block in an array. */
+export declare function normalizeBlocksForSend<T extends Block>(blocks: T[]): T[];
+//# sourceMappingURL=block.d.ts.map

package/dist/types/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/types/block.ts"],"names":[],"mappings":"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"}

package/dist/types/block.js

@@ -0,0 +1,77 @@
+// block.ts — Message block types (discriminated union)
+// ---------------------------------------------------------------------------
+// Type guards — narrow Block union based on $type discriminator
+// ---------------------------------------------------------------------------
+export function isTextBlock(b) {
+    return b.$type === 'text';
+}
+export function isImageBlock(b) {
+    return b.$type === 'image';
+}
+export function isVideoBlock(b) {
+    return b.$type === 'video';
+}
+export function isAudioBlock(b) {
+    return b.$type === 'audio';
+}
+export function isFileBlock(b) {
+    return b.$type === 'file';
+}
+export function isLinkPreviewBlock(b) {
+    return b.$type === 'linkPreview';
+}
+export function isEmbedBlock(b) {
+    return b.$type === 'embed';
+}
+export function isLocationBlock(b) {
+    return b.$type === 'location';
+}
+export function isContactBlock(b) {
+    return b.$type === 'contact';
+}
+export function isChoiceBlock(b) {
+    return b.$type === 'choice';
+}
+export function isCardBlock(b) {
+    return b.$type === 'card';
+}
+export function isCarouselBlock(b) {
+    return b.$type === 'carousel';
+}
+export function isDividerBlock(b) {
+    return b.$type === 'divider';
+}
+export function isCustomBlock(b) {
+    return b.$type === 'custom';
+}
+// ---------------------------------------------------------------------------
+// Block serialization helpers
+// ---------------------------------------------------------------------------
+/**
+ * Re-construct a block object with `$type` as the first property.
+ *
+ * The server's polymorphic deserializer requires `$type` to appear as the
+ * first property in every block JSON payload (gateway spec §13). JavaScript
+ * engines preserve insertion order for string keys (ES2015+), so reassembling
+ * via destructure-then-spread guarantees the correct serialization order.
+ *
+ * `CarouselBlock` is the only block type containing nested blocks (its `cards`
+ * array of `CardBlock`); each nested card is recursively normalized so the
+ * spec rule holds at every level.
+ */
+export function withTypeFirst(block) {
+    const { $type, ...rest } = block;
+    if (block.$type === 'carousel') {
+        return {
+            $type,
+            ...rest,
+            cards: block.cards.map((card) => withTypeFirst(card)),
+        };
+    }
+    return { $type, ...rest };
+}
+/** Apply {@link withTypeFirst} to every block in an array. */
+export function normalizeBlocksForSend(blocks) {
+    return blocks.map(withTypeFirst);
+}
+//# sourceMappingURL=block.js.map

package/dist/types/block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../../src/types/block.ts"],"names":[],"mappings":"AAAA,uDAAuD;AA2KvD,8EAA8E;AAC9E,gEAAgE;AAChE,8EAA8E;AAE9E,MAAM,UAAU,WAAW,CAAC,CAAQ;IAClC,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAQ;IACnC,OAAO,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAQ;IACnC,OAAO,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAQ;IACnC,OAAO,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAQ;IAClC,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAQ;IACzC,OAAO,CAAC,CAAC,KAAK,KAAK,aAAa,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAQ;IACnC,OAAO,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAQ;IACtC,OAAO,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAQ;IACrC,OAAO,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAQ;IACpC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,CAAQ;IAClC,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAQ;IACtC,OAAO,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAQ;IACrC,OAAO,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,CAAQ;IACpC,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC;AAC9B,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAkB,KAAQ;IACrD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IACjC,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO;YACL,KAAK;YACL,GAAG,IAAI;YACP,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;SACjD,CAAC;IACT,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,EAAO,CAAC;AACjC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,sBAAsB,CAAkB,MAAW;IACjE,OAAO,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC"}

package/dist/types/bot.d.ts

@@ -0,0 +1,42 @@
+import type { MediaReference } from './common.js';
+/**
+ * Bot DTO returned from server.
+ *
+ * NOTE: BotDto does NOT include uniqueName/fullName — those live on the
+ * corresponding ParticipantDto. Use ParticipantApi.getById(bot.participantId)
+ * to fetch bot display name / avatar from participant record.
+ * CreateBotRequest / UpdateBotRequest accept uniqueName/fullName to create/update
+ * the associated participant, but the response only returns participantId.
+ */
+export interface BotDto {
+    id: string;
+    participantId: string;
+    description?: string | null;
+    metadata?: Record<string, unknown> | null;
+    kafkaTopic: string;
+    isActive: boolean;
+    listenAllGroupMessages: boolean;
+    createdBy: string;
+    /** ISO 8601 */
+    createdAt: string;
+    /** ISO 8601 */
+    updatedAt: string;
+}
+export interface CreateBotRequest {
+    uniqueName: string;
+    fullName: string;
+    avatar?: MediaReference;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    kafkaTopic: string;
+    listenAllGroupMessages?: boolean;
+}
+export interface UpdateBotRequest {
+    uniqueName?: string;
+    fullName?: string;
+    avatar?: MediaReference;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    listenAllGroupMessages?: boolean;
+}
+//# sourceMappingURL=bot.d.ts.map

package/dist/types/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../src/types/bot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,sBAAsB,EAAE,OAAO,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAElC"}

package/dist/types/bot.js

@@ -0,0 +1,3 @@
+// bot.ts — Bot management types
+export {};
+//# sourceMappingURL=bot.js.map

package/dist/types/bot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.js","sourceRoot":"","sources":["../../src/types/bot.ts"],"names":[],"mappings":"AAAA,gCAAgC"}