@onlive.ai/common-121 0.2.70 → 0.2.179

package/services/conversation/mock/types.d.ts

@@ -0,0 +1,442 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+/**
+ * @summary Type definitions for the mock LiveKit/Conversation service.
+ *
+ * @description Contains all type definitions needed for the mock implementation
+ * including room state, participant state, track state, agent state, and configuration options.
+ */
+/**
+ * Represents the state of a mock room.
+ *
+ * @property {string} id - Unique room identifier.
+ * @property {string} name - Display name of the room.
+ * @property {string} groupId - Group identifier for room categorization.
+ * @property {string} createdAt - ISO timestamp of room creation.
+ * @property {string} [endedAt] - ISO timestamp when room ended, undefined if active.
+ * @property {Record<string, unknown>} [metadata] - Additional room metadata.
+ * @property {boolean} isActive - Whether the room is currently active.
+ * @property {string[]} participantIds - Array of participant identities in the room.
+ * @property {MockConnectionState} connectionState - Current connection state of the room.
+ */
+interface MockRoomState {
+    id: string;
+    name: string;
+    groupId: string;
+    createdAt: string;
+    endedAt?: string;
+    metadata?: Record<string, unknown>;
+    isActive: boolean;
+    participantIds: string[];
+    connectionState: MockConnectionState;
+    wsURL: string;
+    token: string;
+}
+/**
+ * Connection states that mirror LiveKit's ConnectionState enum.
+ */
+type MockConnectionState = "disconnected" | "connecting" | "connected" | "reconnecting";
+/**
+ * Represents the state of a mock participant.
+ *
+ * @property {string} identity - Unique participant identity.
+ * @property {string} [name] - Display name of the participant.
+ * @property {string} roomId - ID of the room the participant is in.
+ * @property {string} joinedAt - ISO timestamp when participant joined.
+ * @property {boolean} isConnected - Whether the participant is currently connected.
+ * @property {string[]} trackIds - Array of track IDs published by this participant.
+ * @property {MockParticipantRole} role - Role of the participant.
+ * @property {Record<string, string>} attributes - Participant attributes.
+ * @property {MockParticipantKind} kind - Kind of participant (standard, ingress, egress, sip, agent).
+ */
+interface MockParticipantState {
+    identity: string;
+    name?: string;
+    roomId: string;
+    joinedAt: string;
+    isConnected: boolean;
+    trackIds: string[];
+    role: MockParticipantRole;
+    attributes: Record<string, string>;
+    kind: MockParticipantKind;
+    isLocal: boolean;
+}
+/**
+ * Participant roles in the conversation.
+ */
+type MockParticipantRole = "user" | "agent" | "assistant";
+/**
+ * Participant kinds matching LiveKit's participant types.
+ */
+type MockParticipantKind = "standard" | "ingress" | "egress" | "sip" | "agent";
+/**
+ * Represents the state of a mock track.
+ *
+ * @property {string} id - Unique track identifier.
+ * @property {MockTrackKind} kind - Type of track (audio, video, data).
+ * @property {MockTrackSource} source - Source of the track.
+ * @property {string} participantIdentity - Identity of the participant who published this track.
+ * @property {string} roomId - ID of the room this track belongs to.
+ * @property {string} publishedAt - ISO timestamp when track was published.
+ * @property {boolean} muted - Whether the track is currently muted.
+ * @property {Record<string, unknown>} [metadata] - Additional track metadata.
+ */
+interface MockTrackState {
+    id: string;
+    kind: MockTrackKind;
+    source: MockTrackSource;
+    participantIdentity: string;
+    roomId: string;
+    publishedAt: string;
+    muted: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Types of tracks that can be published.
+ */
+type MockTrackKind = "audio" | "video" | "data";
+/**
+ * Track source types matching LiveKit's track sources.
+ */
+type MockTrackSource = "camera" | "microphone" | "screen_share" | "screen_share_audio" | "unknown";
+/**
+ * Represents the state of a mock agent.
+ *
+ * @property {string} id - Unique agent identifier.
+ * @property {string} roomId - ID of the room the agent is in.
+ * @property {string} name - Display name of the agent.
+ * @property {MockAgentStatus} status - Current status of the agent.
+ * @property {string} startedAt - ISO timestamp when agent started.
+ * @property {string} [stoppedAt] - ISO timestamp when agent stopped.
+ * @property {MockAgentConfig} config - Agent configuration.
+ * @property {MockAgentMessage[]} messageHistory - History of messages exchanged with agent.
+ */
+interface MockAgentState {
+    id: string;
+    roomId: string;
+    name: string;
+    status: MockAgentStatus;
+    startedAt: string;
+    stoppedAt?: string;
+    config: MockAgentConfig;
+    messageHistory: MockAgentMessage[];
+}
+/**
+ * Agent status values.
+ */
+type MockAgentStatus = "idle" | "starting" | "running" | "stopping" | "stopped" | "error";
+/**
+ * Configuration for a mock agent.
+ *
+ * @property {string} [type] - Type of agent (e.g., 'chat', 'voice').
+ * @property {string} [nature] - Nature of agent ('ai' or 'real').
+ * @property {MockAgentResponseStrategy} responseStrategy - How the agent should respond.
+ * @property {number} [responseDelayMs] - Delay before responding in milliseconds.
+ * @property {string[]} [cannedResponses] - Predefined responses for deterministic testing.
+ * @property {number} [maxMessages] - Maximum messages before stopping.
+ * @property {boolean} [simulateTyping] - Whether to simulate typing indicator.
+ * @property {number} [typingDelayPerChar] - Typing delay per character (ms).
+ * @property {string} [name] - Agent display name.
+ */
+interface MockAgentConfig {
+    type?: string | string[];
+    nature?: "ai" | "real";
+    name?: string;
+    responseStrategy: MockAgentResponseStrategy;
+    responseDelayMs?: number;
+    cannedResponses?: string[];
+    maxMessages?: number;
+    simulateTyping?: boolean;
+    typingDelayPerChar?: number;
+}
+/**
+ * Strategies for how mock agents should respond.
+ */
+type MockAgentResponseStrategy = "echo" | "canned" | "random" | "sequential" | "silent" | "error" | "custom";
+/**
+ * Message exchanged with a mock agent.
+ */
+interface MockAgentMessage {
+    id: string;
+    content: string;
+    role: "user" | "agent";
+    /** Timestamp - ISO string or number */
+    timestamp: string | number;
+}
+/**
+ * Represents a mock message in a room.
+ *
+ * @property {string} id - Unique message identifier.
+ * @property {string} roomId - ID of the room this message belongs to.
+ * @property {string} content - Text content of the message.
+ * @property {string} participantIdentity - Identity of the sender.
+ * @property {string} createdAt - ISO timestamp of message creation.
+ * @property {"standard" | "system"} [type] - Message type classification.
+ * @property {Record<string, unknown>} [attributes] - Message attributes.
+ */
+interface MockMessageState {
+    id: string;
+    roomId: string;
+    content: string;
+    participantIdentity: string;
+    createdAt: string;
+    type?: "standard" | "system";
+    attributes?: Record<string, unknown>;
+}
+/**
+ * All possible mock event types.
+ */
+type MockEventType = "roomCreated" | "roomEnded" | "roomConnectionStateChanged" | "participantJoined" | "participantLeft" | "participantAttributesChanged" | "trackPublished" | "trackUnpublished" | "trackMuted" | "trackUnmuted" | "messageReceived" | "messageSent" | "typingIndicator" | "agentStarted" | "agentStopped" | "agentMessage" | "dataReceived" | "error";
+/**
+ * Base event structure for all mock events.
+ */
+interface MockEventBase {
+    type: MockEventType;
+    timestamp: string;
+    roomId?: string;
+}
+/**
+ * Room created event.
+ */
+interface MockRoomCreatedEvent extends MockEventBase {
+    type: "roomCreated";
+    roomId: string;
+    room: MockRoomState;
+}
+/**
+ * Room ended event.
+ */
+interface MockRoomEndedEvent extends MockEventBase {
+    type: "roomEnded";
+    roomId: string;
+}
+/**
+ * Room connection state changed event.
+ */
+interface MockRoomConnectionStateChangedEvent extends MockEventBase {
+    type: "roomConnectionStateChanged";
+    roomId: string;
+    state: MockConnectionState;
+    previousState: MockConnectionState;
+}
+/**
+ * Participant joined event.
+ */
+interface MockParticipantJoinedEvent extends MockEventBase {
+    type: "participantJoined";
+    roomId: string;
+    participant: MockParticipantState;
+}
+/**
+ * Participant left event.
+ */
+interface MockParticipantLeftEvent extends MockEventBase {
+    type: "participantLeft";
+    roomId: string;
+    participantIdentity: string;
+}
+/**
+ * Participant attributes changed event.
+ */
+interface MockParticipantAttributesChangedEvent extends MockEventBase {
+    type: "participantAttributesChanged";
+    roomId: string;
+    participantIdentity: string;
+    attributes: Record<string, string>;
+    previousAttributes: Record<string, string>;
+}
+/**
+ * Track published event.
+ */
+interface MockTrackPublishedEvent extends MockEventBase {
+    type: "trackPublished";
+    roomId: string;
+    participantIdentity: string;
+    track: MockTrackState;
+}
+/**
+ * Track unpublished event.
+ */
+interface MockTrackUnpublishedEvent extends MockEventBase {
+    type: "trackUnpublished";
+    roomId: string;
+    participantIdentity: string;
+    trackId: string;
+}
+/**
+ * Track muted event.
+ */
+interface MockTrackMutedEvent extends MockEventBase {
+    type: "trackMuted";
+    roomId: string;
+    trackId: string;
+}
+/**
+ * Track unmuted event.
+ */
+interface MockTrackUnmutedEvent extends MockEventBase {
+    type: "trackUnmuted";
+    roomId: string;
+    trackId: string;
+}
+/**
+ * Message received event.
+ */
+interface MockMessageReceivedEvent extends MockEventBase {
+    type: "messageReceived";
+    roomId: string;
+    message: MockMessageState;
+}
+/**
+ * Message sent event.
+ */
+interface MockMessageSentEvent extends MockEventBase {
+    type: "messageSent";
+    roomId: string;
+    message: MockMessageState;
+}
+/**
+ * Typing indicator event.
+ */
+interface MockTypingIndicatorEvent extends MockEventBase {
+    type: "typingIndicator";
+    roomId: string;
+    participantIdentity: string;
+    isTyping: boolean;
+}
+/**
+ * Agent started event.
+ */
+interface MockAgentStartedEvent extends MockEventBase {
+    type: "agentStarted";
+    roomId: string;
+    agent: MockAgentState;
+}
+/**
+ * Agent stopped event.
+ */
+interface MockAgentStoppedEvent extends MockEventBase {
+    type: "agentStopped";
+    roomId: string;
+    agentId: string;
+}
+/**
+ * Agent message event.
+ */
+interface MockAgentMessageEvent extends MockEventBase {
+    type: "agentMessage";
+    roomId: string;
+    agentId: string;
+    message: MockAgentMessage;
+}
+/**
+ * Data received event.
+ */
+interface MockDataReceivedEvent extends MockEventBase {
+    type: "dataReceived";
+    roomId: string;
+    participantIdentity: string;
+    data: Uint8Array;
+    topic?: string;
+}
+/**
+ * Error event.
+ */
+interface MockErrorEvent extends MockEventBase {
+    type: "error";
+    error: MockError;
+}
+/**
+ * Union type for all mock events.
+ */
+type MockEvent = MockRoomCreatedEvent | MockRoomEndedEvent | MockRoomConnectionStateChangedEvent | MockParticipantJoinedEvent | MockParticipantLeftEvent | MockParticipantAttributesChangedEvent | MockTrackPublishedEvent | MockTrackUnpublishedEvent | MockTrackMutedEvent | MockTrackUnmutedEvent | MockMessageReceivedEvent | MockMessageSentEvent | MockTypingIndicatorEvent | MockAgentStartedEvent | MockAgentStoppedEvent | MockAgentMessageEvent | MockDataReceivedEvent | MockErrorEvent;
+/**
+ * Configuration options for the mock service.
+ *
+ * @property {number} [latencyMs] - Artificial latency in milliseconds.
+ * @property {boolean} [strictMode] - Throw errors for invalid operations.
+ * @property {number} [seed] - Random seed for deterministic behavior.
+ * @property {MockScenario} [scenario] - Predefined scenario to simulate.
+ * @property {MockErrorConfig} [errorConfig] - Configuration for forced errors.
+ * @property {boolean} [autoEmitEvents] - Automatically emit events on state changes.
+ */
+interface MockServiceConfig {
+    latencyMs?: number;
+    strictMode?: boolean;
+    seed?: number;
+    scenario?: MockScenario;
+    errorConfig?: MockErrorConfig;
+    autoEmitEvents?: boolean;
+    organizationId?: string;
+    apiUrl?: string;
+}
+/**
+ * Predefined test scenarios.
+ */
+type MockScenario = "happy_path" | "room_disconnect" | "agent_timeout" | "participant_leave" | "track_failure" | "network_unstable" | "slow_network" | "unreliable";
+/**
+ * Configuration for forced errors.
+ *
+ * @property {boolean} [roomNotFound] - Force "room not found" errors.
+ * @property {boolean} [participantAlreadyJoined] - Force "already joined" errors.
+ * @property {boolean} [trackNotFound] - Force "track not found" errors.
+ * @property {boolean} [unauthorized] - Force authentication errors.
+ * @property {boolean} [networkError] - Force network errors.
+ * @property {number} [errorRate] - Percentage of operations that should fail (0-100).
+ */
+interface MockErrorConfig {
+    roomNotFound?: boolean;
+    participantAlreadyJoined?: boolean;
+    trackNotFound?: boolean;
+    unauthorized?: boolean;
+    networkError?: boolean;
+    errorRate?: number;
+}
+/**
+ * Mock error codes.
+ */
+type MockErrorCode = "ROOM_NOT_FOUND" | "ROOM_ENDED" | "PARTICIPANT_ALREADY_JOINED" | "PARTICIPANT_NOT_FOUND" | "TRACK_NOT_FOUND" | "AGENT_NOT_FOUND" | "UNAUTHORIZED" | "NETWORK_ERROR" | "INVALID_OPERATION" | "TIMEOUT";
+/**
+ * Mock error structure.
+ */
+interface MockError {
+    code: MockErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Event listener callback type.
+ */
+type MockEventListener<T extends MockEvent = MockEvent> = (event: T) => void;
+/**
+ * Event listener for specific event types.
+ */
+type MockEventListenerMap = {
+    [K in MockEventType]?: Set<MockEventListener>;
+};
+/**
+ * Complete snapshot of the mock service state.
+ */
+interface MockStateSnapshot {
+    rooms: Map<string, MockRoomState>;
+    participants: Map<string, MockParticipantState>;
+    tracks: Map<string, MockTrackState>;
+    agents: Map<string, MockAgentState>;
+    messages: Map<string, MockMessageState[]>;
+    config: MockServiceConfig;
+    eventHistory: MockEvent[];
+}
+/**
+ * Serializable version of the snapshot for JSON export.
+ */
+interface MockStateSnapshotJSON {
+    rooms: Record<string, MockRoomState>;
+    participants: Record<string, MockParticipantState>;
+    tracks: Record<string, MockTrackState>;
+    agents: Record<string, MockAgentState>;
+    messages: Record<string, MockMessageState[]>;
+    config: MockServiceConfig;
+    eventHistory: MockEvent[];
+    exportedAt: string;
+}
+
+export type { MockAgentConfig, MockAgentMessage, MockAgentMessageEvent, MockAgentResponseStrategy, MockAgentStartedEvent, MockAgentState, MockAgentStatus, MockAgentStoppedEvent, MockConnectionState, MockDataReceivedEvent, MockError, MockErrorCode, MockErrorConfig, MockErrorEvent, MockEvent, MockEventBase, MockEventListener, MockEventListenerMap, MockEventType, MockMessageReceivedEvent, MockMessageSentEvent, MockMessageState, MockParticipantAttributesChangedEvent, MockParticipantJoinedEvent, MockParticipantKind, MockParticipantLeftEvent, MockParticipantRole, MockParticipantState, MockRoomConnectionStateChangedEvent, MockRoomCreatedEvent, MockRoomEndedEvent, MockRoomState, MockScenario, MockServiceConfig, MockStateSnapshot, MockStateSnapshotJSON, MockTrackKind, MockTrackMutedEvent, MockTrackPublishedEvent, MockTrackSource, MockTrackState, MockTrackUnmutedEvent, MockTrackUnpublishedEvent, MockTypingIndicatorEvent };

package/services/conversation/mock/types.js

@@ -0,0 +1 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */

package/services/faqs/faqs.service.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+"use strict";var a=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var u=(n,e)=>{for(var t in e)a(n,t,{get:e[t],enumerable:!0})},h=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of f(e))!p.call(n,r)&&r!==t&&a(n,r,{get:()=>e[r],enumerable:!(i=d(e,r))||i.enumerable});return n};var l=n=>h(a({},"__esModule",{value:!0}),n);var q={};u(q,{FaqsService:()=>g});module.exports=l(q);var g=class n{constructor(e){this.config=e}static initialize(e){return new n(e)}getBaseUrl(){return`${this.config.baseUrl}`}getHeaders(){return{"Content-Type":"application/json"}}async makeRequest(e,t={}){let i=`${this.getBaseUrl()}${e}`,r=await fetch(i,{...t,headers:{...this.getHeaders(),...t.headers}});if(!r.ok)throw new Error(`FAQs API error: ${r.status} ${r.statusText}`);return r.json()}async getSettingsByOrganization(e,t){try{let i=new URLSearchParams;t&&i.append("userGroupId",t);let r=i.toString(),o=`${this.getBaseUrl()}/settings/organization/${e}${r?`?${r}`:""}`,s=await fetch(o,{method:"GET",headers:this.getHeaders(),credentials:"include"});if(s.status===404)return null;if(!s.ok)throw new Error(`Failed to fetch settings: ${s.statusText}`);return await s.json()}catch(i){return console.error("Error fetching settings:",i),null}}async getFaqs(e={}){let t=new URLSearchParams;if(e.search&&t.append("search",e.search),e.organizationId&&t.append("organizationId",e.organizationId),e.groupId&&t.append("groupId",e.groupId),e.isActive!==void 0&&t.append("isActive",e.isActive.toString()),e.page&&t.append("page",e.page.toString()),e.limit&&t.append("limit",e.limit.toString()),e.sortBy&&t.append("sortBy",e.sortBy),e.sortOrder&&t.append("sortOrder",e.sortOrder),e.extraFilters){for(let[o,s]of Object.entries(e.extraFilters))if(s&&(Array.isArray(s)?s.length>0:s.toString().trim()!=="")){let c=Array.isArray(s)?s.join(","):s.toString();t.append(`extra_${o}`,c)}}let i=t.toString(),r=`/faqs${i?`?${i}`:""}`;return this.makeRequest(r)}async getFaqById(e){return this.makeRequest(`/faqs/${e}`,{})}};0&&(module.exports={FaqsService});

package/services/faqs/faqs.service.d.cts

@@ -0,0 +1,16 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+import { FaqsServiceConfig, SettingsResponse, FaqsSearchParams, FaqsApiResponse, FaqItem } from './faqs.types.cjs';
+
+declare class FaqsService {
+    private config;
+    constructor(config: FaqsServiceConfig);
+    static initialize(config: FaqsServiceConfig): FaqsService;
+    private getBaseUrl;
+    private getHeaders;
+    private makeRequest;
+    getSettingsByOrganization(organizationId: string, userGroupId?: string): Promise<SettingsResponse | null>;
+    getFaqs(params?: FaqsSearchParams): Promise<FaqsApiResponse>;
+    getFaqById(id: string): Promise<FaqItem>;
+}
+
+export { FaqsService };

package/services/faqs/faqs.service.d.ts

@@ -0,0 +1,16 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+import { FaqsServiceConfig, SettingsResponse, FaqsSearchParams, FaqsApiResponse, FaqItem } from './faqs.types.js';
+
+declare class FaqsService {
+    private config;
+    constructor(config: FaqsServiceConfig);
+    static initialize(config: FaqsServiceConfig): FaqsService;
+    private getBaseUrl;
+    private getHeaders;
+    private makeRequest;
+    getSettingsByOrganization(organizationId: string, userGroupId?: string): Promise<SettingsResponse | null>;
+    getFaqs(params?: FaqsSearchParams): Promise<FaqsApiResponse>;
+    getFaqById(id: string): Promise<FaqItem>;
+}
+
+export { FaqsService };

package/services/faqs/faqs.service.js

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+var o=class a{constructor(e){this.config=e}static initialize(e){return new a(e)}getBaseUrl(){return`${this.config.baseUrl}`}getHeaders(){return{"Content-Type":"application/json"}}async makeRequest(e,t={}){let i=`${this.getBaseUrl()}${e}`,s=await fetch(i,{...t,headers:{...this.getHeaders(),...t.headers}});if(!s.ok)throw new Error(`FAQs API error: ${s.status} ${s.statusText}`);return s.json()}async getSettingsByOrganization(e,t){try{let i=new URLSearchParams;t&&i.append("userGroupId",t);let s=i.toString(),n=`${this.getBaseUrl()}/settings/organization/${e}${s?`?${s}`:""}`,r=await fetch(n,{method:"GET",headers:this.getHeaders(),credentials:"include"});if(r.status===404)return null;if(!r.ok)throw new Error(`Failed to fetch settings: ${r.statusText}`);return await r.json()}catch(i){return console.error("Error fetching settings:",i),null}}async getFaqs(e={}){let t=new URLSearchParams;if(e.search&&t.append("search",e.search),e.organizationId&&t.append("organizationId",e.organizationId),e.groupId&&t.append("groupId",e.groupId),e.isActive!==void 0&&t.append("isActive",e.isActive.toString()),e.page&&t.append("page",e.page.toString()),e.limit&&t.append("limit",e.limit.toString()),e.sortBy&&t.append("sortBy",e.sortBy),e.sortOrder&&t.append("sortOrder",e.sortOrder),e.extraFilters){for(let[n,r]of Object.entries(e.extraFilters))if(r&&(Array.isArray(r)?r.length>0:r.toString().trim()!=="")){let g=Array.isArray(r)?r.join(","):r.toString();t.append(`extra_${n}`,g)}}let i=t.toString(),s=`/faqs${i?`?${i}`:""}`;return this.makeRequest(s)}async getFaqById(e){return this.makeRequest(`/faqs/${e}`,{})}};export{o as FaqsService};

package/services/faqs/faqs.types.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+"use strict";var n=Object.defineProperty;var s=Object.getOwnPropertyDescriptor;var o=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var l=(e,t,a,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of o(t))!g.call(e,r)&&r!==a&&n(e,r,{get:()=>t[r],enumerable:!(i=s(t,r))||i.enumerable});return e};var p=e=>l(n({},"__esModule",{value:!0}),e);var d={};module.exports=p(d);

package/services/faqs/faqs.types.d.cts

@@ -0,0 +1,60 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+interface FaqsServiceConfig {
+    baseUrl: string;
+    organizationId: string;
+}
+interface FaqItem {
+    id: string;
+    question: string;
+    answer: string;
+    organizationId: string;
+    groupId?: string | null;
+    priority: number;
+    isActive: boolean;
+    metadata?: any | null;
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: string | null;
+}
+interface FaqsApiResponse {
+    data: FaqItem[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+interface FaqsSearchParams {
+    search?: string;
+    organizationId?: string;
+    groupId?: string;
+    isActive?: boolean;
+    page?: number;
+    limit?: number;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+    extraFilters?: Record<string, string | string[]>;
+}
+type ExtraFilterType = "select" | "multiselect" | "text";
+type ExtraFilterEntity = "all" | "assets" | "faqs" | "products" | "videos" | "images" | "presentations";
+interface ExtraFilterConfig {
+    name: string;
+    type: ExtraFilterType;
+    label: string;
+    order: number;
+    entity: ExtraFilterEntity;
+    values?: string[];
+    enabled: boolean;
+    placeholder?: string;
+}
+interface SettingsResponse {
+    id: string;
+    organizationId: string;
+    userGroupId?: string | null;
+    extraFilters: ExtraFilterConfig[];
+    createdAt: string;
+    updatedAt: string;
+}
+
+export type { ExtraFilterConfig, ExtraFilterEntity, ExtraFilterType, FaqItem, FaqsApiResponse, FaqsSearchParams, FaqsServiceConfig, SettingsResponse };

package/services/faqs/faqs.types.d.ts

@@ -0,0 +1,60 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+interface FaqsServiceConfig {
+    baseUrl: string;
+    organizationId: string;
+}
+interface FaqItem {
+    id: string;
+    question: string;
+    answer: string;
+    organizationId: string;
+    groupId?: string | null;
+    priority: number;
+    isActive: boolean;
+    metadata?: any | null;
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: string | null;
+}
+interface FaqsApiResponse {
+    data: FaqItem[];
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+interface FaqsSearchParams {
+    search?: string;
+    organizationId?: string;
+    groupId?: string;
+    isActive?: boolean;
+    page?: number;
+    limit?: number;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+    extraFilters?: Record<string, string | string[]>;
+}
+type ExtraFilterType = "select" | "multiselect" | "text";
+type ExtraFilterEntity = "all" | "assets" | "faqs" | "products" | "videos" | "images" | "presentations";
+interface ExtraFilterConfig {
+    name: string;
+    type: ExtraFilterType;
+    label: string;
+    order: number;
+    entity: ExtraFilterEntity;
+    values?: string[];
+    enabled: boolean;
+    placeholder?: string;
+}
+interface SettingsResponse {
+    id: string;
+    organizationId: string;
+    userGroupId?: string | null;
+    extraFilters: ExtraFilterConfig[];
+    createdAt: string;
+    updatedAt: string;
+}
+
+export type { ExtraFilterConfig, ExtraFilterEntity, ExtraFilterType, FaqItem, FaqsApiResponse, FaqsSearchParams, FaqsServiceConfig, SettingsResponse };

package/services/faqs/faqs.types.js

@@ -0,0 +1 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */

package/services/faqs/index.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+"use strict";var c=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var u=(n,e)=>{for(var t in e)c(n,t,{get:e[t],enumerable:!0})},h=(n,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of f(e))!d.call(n,r)&&r!==t&&c(n,r,{get:()=>e[r],enumerable:!(s=p(e,r))||s.enumerable});return n};var q=n=>h(c({},"__esModule",{value:!0}),n);var l={};u(l,{FaqsService:()=>o});module.exports=q(l);var o=class n{constructor(e){this.config=e}static initialize(e){return new n(e)}getBaseUrl(){return`${this.config.baseUrl}`}getHeaders(){return{"Content-Type":"application/json"}}async makeRequest(e,t={}){let s=`${this.getBaseUrl()}${e}`,r=await fetch(s,{...t,headers:{...this.getHeaders(),...t.headers}});if(!r.ok)throw new Error(`FAQs API error: ${r.status} ${r.statusText}`);return r.json()}async getSettingsByOrganization(e,t){try{let s=new URLSearchParams;t&&s.append("userGroupId",t);let r=s.toString(),a=`${this.getBaseUrl()}/settings/organization/${e}${r?`?${r}`:""}`,i=await fetch(a,{method:"GET",headers:this.getHeaders(),credentials:"include"});if(i.status===404)return null;if(!i.ok)throw new Error(`Failed to fetch settings: ${i.statusText}`);return await i.json()}catch(s){return console.error("Error fetching settings:",s),null}}async getFaqs(e={}){let t=new URLSearchParams;if(e.search&&t.append("search",e.search),e.organizationId&&t.append("organizationId",e.organizationId),e.groupId&&t.append("groupId",e.groupId),e.isActive!==void 0&&t.append("isActive",e.isActive.toString()),e.page&&t.append("page",e.page.toString()),e.limit&&t.append("limit",e.limit.toString()),e.sortBy&&t.append("sortBy",e.sortBy),e.sortOrder&&t.append("sortOrder",e.sortOrder),e.extraFilters){for(let[a,i]of Object.entries(e.extraFilters))if(i&&(Array.isArray(i)?i.length>0:i.toString().trim()!=="")){let g=Array.isArray(i)?i.join(","):i.toString();t.append(`extra_${a}`,g)}}let s=t.toString(),r=`/faqs${s?`?${s}`:""}`;return this.makeRequest(r)}async getFaqById(e){return this.makeRequest(`/faqs/${e}`,{})}};0&&(module.exports={FaqsService});

package/services/faqs/index.d.cts

@@ -0,0 +1,3 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+export { FaqsService } from './faqs.service.cjs';
+export { FaqItem, FaqsApiResponse, FaqsSearchParams, FaqsServiceConfig } from './faqs.types.cjs';

package/services/faqs/index.d.ts

@@ -0,0 +1,3 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+export { FaqsService } from './faqs.service.js';
+export { FaqItem, FaqsApiResponse, FaqsSearchParams, FaqsServiceConfig } from './faqs.types.js';

package/services/faqs/index.js

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+var o=class a{constructor(e){this.config=e}static initialize(e){return new a(e)}getBaseUrl(){return`${this.config.baseUrl}`}getHeaders(){return{"Content-Type":"application/json"}}async makeRequest(e,t={}){let s=`${this.getBaseUrl()}${e}`,i=await fetch(s,{...t,headers:{...this.getHeaders(),...t.headers}});if(!i.ok)throw new Error(`FAQs API error: ${i.status} ${i.statusText}`);return i.json()}async getSettingsByOrganization(e,t){try{let s=new URLSearchParams;t&&s.append("userGroupId",t);let i=s.toString(),n=`${this.getBaseUrl()}/settings/organization/${e}${i?`?${i}`:""}`,r=await fetch(n,{method:"GET",headers:this.getHeaders(),credentials:"include"});if(r.status===404)return null;if(!r.ok)throw new Error(`Failed to fetch settings: ${r.statusText}`);return await r.json()}catch(s){return console.error("Error fetching settings:",s),null}}async getFaqs(e={}){let t=new URLSearchParams;if(e.search&&t.append("search",e.search),e.organizationId&&t.append("organizationId",e.organizationId),e.groupId&&t.append("groupId",e.groupId),e.isActive!==void 0&&t.append("isActive",e.isActive.toString()),e.page&&t.append("page",e.page.toString()),e.limit&&t.append("limit",e.limit.toString()),e.sortBy&&t.append("sortBy",e.sortBy),e.sortOrder&&t.append("sortOrder",e.sortOrder),e.extraFilters){for(let[n,r]of Object.entries(e.extraFilters))if(r&&(Array.isArray(r)?r.length>0:r.toString().trim()!=="")){let c=Array.isArray(r)?r.join(","):r.toString();t.append(`extra_${n}`,c)}}let s=t.toString(),i=`/faqs${s?`?${s}`:""}`;return this.makeRequest(i)}async getFaqById(e){return this.makeRequest(`/faqs/${e}`,{})}};export{o as FaqsService};

package/services/file/file.service.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+"use strict";var l=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var h=(i,e)=>{for(var t in e)l(i,t,{get:e[t],enumerable:!0})},U=(i,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of f(e))!g.call(i,s)&&s!==t&&l(i,s,{get:()=>e[s],enumerable:!(r=d(e,s))||r.enumerable});return i};var m=i=>U(l({},"__esModule",{value:!0}),i);var y={};h(y,{FileService:()=>a,getFileService:()=>F});module.exports=m(y);var c=async(i,e)=>{let t=await fetch(i,e);if(!t.ok){let r=await t.json().catch(()=>({}));throw new Error(JSON.stringify({status:t.status,statusText:t.statusText,...r}))}return t&&t.json()};var a=class i{constructor(e){this.config=e,this.enableUpload=e.enableUpload||!1}static getInstance(e){if(!i.instance&&e&&(i.instance=new i(e)),!i.instance)throw new Error("FileService must be initialized with config first");return i.instance}static initialize(e){return i.instance=new i(e),i.instance}async uploadFile(e,t={}){try{let r=await this.requestSignedUrl({filename:e.name,description:t.description,loadDirection:"up",bucketType:t.bucketType||"conversations",path:t.path||".temp",mimeType:e.type});return await this.uploadToSignedUrl(r.data.signedUrlData.signedUrl,e),{success:!0,id:r.data.file.id,name:r.data.file.name,url:r.data.file.url,type:r.data.file.type}}catch(r){return console.error("Error uploading file:",r),{success:!1,error:r instanceof Error?r.message:"Unknown error"}}}async requestSignedUrl(e){let t=`${this.config.baseUrl}/files/upload-url`;return this.makeRequest(t,{method:"POST",body:JSON.stringify(e)})}async uploadToSignedUrl(e,t){let r=await fetch(e,{method:"PUT",body:t,headers:{"Content-Type":t.type}});if(!r.ok){let s=await r.text().catch(()=>"No response");throw new Error(`Upload failed with status: ${r.status}. Response: ${s}`)}}async uploadFileWithRetry(e,t={}){let r=t.maxRetries||3,s=null;for(let o=1;o<=r;o++)try{let n=await this.uploadFile(e,t);if(n.success)return n;throw new Error(n.error||"Upload failed")}catch(n){if(s=n instanceof Error?n:new Error("Unknown error"),o===r)break;let p=2**o*1e3;await new Promise(u=>setTimeout(u,p))}return{success:!1,error:s?.message||"Upload failed after retries"}}async getFileById(e){let t=`${this.config.baseUrl}/files/${e}`,r=await this.makeRequest(t);if(!r.success)throw new Error("Failed to get file");return r.data}async makeRequest(e,t){let r={"Content-Type":"application/json"};return this.config.organizationId&&(r["X-Onlive-Organization-Id"]=this.config.organizationId),t?.headers&&Object.assign(r,t.headers),c(e,{...t,headers:r})}updateConfig(e){this.config={...this.config,...e}}getConfig(){return{...this.config}}},F=()=>a.getInstance();0&&(module.exports={FileService,getFileService});