@onlive.ai/common-121 0.2.66 → 0.2.163

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

@@ -0,0 +1,16 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 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.163 | © 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.163 | © 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.163 | © 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.163 | © 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.163 | © 2026 Onlive.ai */

package/services/faqs/index.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 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.163 | © 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.163 | © 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.163 | © 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.163 | © 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});

package/services/file/file.service.d.cts

@@ -0,0 +1,66 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+import { FileServiceConfig, FileUploadOptions, FileUploadResult, FileResponse } from './file.types.cjs';
+
+declare class FileService {
+    private static instance;
+    private config;
+    enableUpload: boolean;
+    private constructor();
+    static getInstance(config?: FileServiceConfig): FileService;
+    static initialize(config: FileServiceConfig): FileService;
+    /**
+     * Upload a file using the signed URL approach
+     * @param file - File to upload
+     * @param options - Upload options
+     * @returns Upload result with file information
+     */
+    uploadFile(file: File, options?: FileUploadOptions): Promise<FileUploadResult>;
+    /**
+     * Step 1: Request signed URL from backend
+     * @param payload - Upload URL request payload
+     * @returns Upload URL response with signed URL and file info
+     */
+    private requestSignedUrl;
+    /**
+     * Step 2: Upload file to signed URL
+     * @param signedUrl - Signed URL from backend
+     * @param file - File to upload
+     * @param onProgress - Progress callback (optional, uses XHR if provided)
+     */
+    private uploadToSignedUrl;
+    /**
+     * Upload file with retry logic
+     * @param file - File to upload
+     * @param options - Upload options with max retries
+     * @returns Upload result
+     */
+    uploadFileWithRetry(file: File, options?: FileUploadOptions & {
+        maxRetries?: number;
+    }): Promise<FileUploadResult>;
+    /**
+     * Get file by ID (if backend provides this endpoint)
+     * @param fileId - File ID
+     * @returns File information
+     */
+    getFileById(fileId: string): Promise<FileResponse>;
+    /**
+     * Make HTTP request with proper headers
+     * @param url - Request URL
+     * @param init - Request init options
+     * @returns Promise with response data
+     */
+    private makeRequest;
+    /**
+     * Update configuration
+     * @param config - Partial configuration to update
+     */
+    updateConfig(config: Partial<FileServiceConfig>): void;
+    /**
+     * Get current configuration
+     * @returns Current configuration
+     */
+    getConfig(): FileServiceConfig;
+}
+declare const getFileService: () => FileService;
+
+export { FileService, getFileService };

package/services/file/file.service.d.ts

@@ -0,0 +1,66 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+import { FileServiceConfig, FileUploadOptions, FileUploadResult, FileResponse } from './file.types.js';
+
+declare class FileService {
+    private static instance;
+    private config;
+    enableUpload: boolean;
+    private constructor();
+    static getInstance(config?: FileServiceConfig): FileService;
+    static initialize(config: FileServiceConfig): FileService;
+    /**
+     * Upload a file using the signed URL approach
+     * @param file - File to upload
+     * @param options - Upload options
+     * @returns Upload result with file information
+     */
+    uploadFile(file: File, options?: FileUploadOptions): Promise<FileUploadResult>;
+    /**
+     * Step 1: Request signed URL from backend
+     * @param payload - Upload URL request payload
+     * @returns Upload URL response with signed URL and file info
+     */
+    private requestSignedUrl;
+    /**
+     * Step 2: Upload file to signed URL
+     * @param signedUrl - Signed URL from backend
+     * @param file - File to upload
+     * @param onProgress - Progress callback (optional, uses XHR if provided)
+     */
+    private uploadToSignedUrl;
+    /**
+     * Upload file with retry logic
+     * @param file - File to upload
+     * @param options - Upload options with max retries
+     * @returns Upload result
+     */
+    uploadFileWithRetry(file: File, options?: FileUploadOptions & {
+        maxRetries?: number;
+    }): Promise<FileUploadResult>;
+    /**
+     * Get file by ID (if backend provides this endpoint)
+     * @param fileId - File ID
+     * @returns File information
+     */
+    getFileById(fileId: string): Promise<FileResponse>;
+    /**
+     * Make HTTP request with proper headers
+     * @param url - Request URL
+     * @param init - Request init options
+     * @returns Promise with response data
+     */
+    private makeRequest;
+    /**
+     * Update configuration
+     * @param config - Partial configuration to update
+     */
+    updateConfig(config: Partial<FileServiceConfig>): void;
+    /**
+     * Get current configuration
+     * @returns Current configuration
+     */
+    getConfig(): FileServiceConfig;
+}
+declare const getFileService: () => FileService;
+
+export { FileService, getFileService };

package/services/file/file.service.js

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+var l=async(i,e)=>{let r=await fetch(i,e);if(!r.ok){let t=await r.json().catch(()=>({}));throw new Error(JSON.stringify({status:r.status,statusText:r.statusText,...t}))}return r&&r.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,r={}){try{let t=await this.requestSignedUrl({filename:e.name,description:r.description,loadDirection:"up",bucketType:r.bucketType||"conversations",path:r.path||".temp",mimeType:e.type});return await this.uploadToSignedUrl(t.data.signedUrlData.signedUrl,e),{success:!0,id:t.data.file.id,name:t.data.file.name,url:t.data.file.url,type:t.data.file.type}}catch(t){return console.error("Error uploading file:",t),{success:!1,error:t instanceof Error?t.message:"Unknown error"}}}async requestSignedUrl(e){let r=`${this.config.baseUrl}/files/upload-url`;return this.makeRequest(r,{method:"POST",body:JSON.stringify(e)})}async uploadToSignedUrl(e,r){let t=await fetch(e,{method:"PUT",body:r,headers:{"Content-Type":r.type}});if(!t.ok){let n=await t.text().catch(()=>"No response");throw new Error(`Upload failed with status: ${t.status}. Response: ${n}`)}}async uploadFileWithRetry(e,r={}){let t=r.maxRetries||3,n=null;for(let o=1;o<=t;o++)try{let s=await this.uploadFile(e,r);if(s.success)return s;throw new Error(s.error||"Upload failed")}catch(s){if(n=s instanceof Error?s:new Error("Unknown error"),o===t)break;let c=2**o*1e3;await new Promise(p=>setTimeout(p,c))}return{success:!1,error:n?.message||"Upload failed after retries"}}async getFileById(e){let r=`${this.config.baseUrl}/files/${e}`,t=await this.makeRequest(r);if(!t.success)throw new Error("Failed to get file");return t.data}async makeRequest(e,r){let t={"Content-Type":"application/json"};return this.config.organizationId&&(t["X-Onlive-Organization-Id"]=this.config.organizationId),r?.headers&&Object.assign(t,r.headers),l(e,{...r,headers:t})}updateConfig(e){this.config={...this.config,...e}}getConfig(){return{...this.config}}},f=()=>a.getInstance();export{a as FileService,f as getFileService};

package/services/file/file.types.cjs

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

package/services/file/file.types.d.cts

@@ -0,0 +1,72 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+interface FileServiceConfig {
+    baseUrl: string;
+    organizationId?: string;
+    enableUpload?: boolean;
+}
+interface UploadUrlRequest {
+    filename: string;
+    description?: string;
+    loadDirection: "up" | "down";
+    bucketType: "immersive" | "resources" | "conversations";
+    path?: string;
+    mimeType: string;
+}
+interface FileResponse {
+    id: string;
+    name: string;
+    description?: string;
+    url: string;
+    type: string;
+    metadata?: {
+        bucketType?: string;
+        path?: string;
+        loadDirection?: string;
+        size?: number;
+        bucketInfo?: {
+            bucket: string;
+            key: string;
+            region?: string;
+        };
+        uploadInfo?: {
+            signedUrl?: string;
+            expiresAt?: string;
+        };
+        originalName?: string;
+        checksum?: string;
+    };
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface SignedUrlData {
+    signedUrl: string;
+    key: string;
+    url: string;
+}
+interface UploadUrlResponse {
+    success: boolean;
+    data: {
+        file: FileResponse;
+        signedUrlData: SignedUrlData;
+    };
+}
+interface GetFileByIdResponse {
+    success: boolean;
+    data: FileResponse;
+}
+interface FileUploadOptions {
+    bucketType?: "immersive" | "resources" | "conversations";
+    path?: string;
+    description?: string;
+    onProgress?: (progress: number) => void;
+}
+interface FileUploadResult {
+    success: boolean;
+    id?: string;
+    name?: string;
+    url?: string;
+    type?: string;
+    error?: string;
+}
+
+export type { FileResponse, FileServiceConfig, FileUploadOptions, FileUploadResult, GetFileByIdResponse, SignedUrlData, UploadUrlRequest, UploadUrlResponse };

package/services/file/file.types.d.ts

@@ -0,0 +1,72 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+interface FileServiceConfig {
+    baseUrl: string;
+    organizationId?: string;
+    enableUpload?: boolean;
+}
+interface UploadUrlRequest {
+    filename: string;
+    description?: string;
+    loadDirection: "up" | "down";
+    bucketType: "immersive" | "resources" | "conversations";
+    path?: string;
+    mimeType: string;
+}
+interface FileResponse {
+    id: string;
+    name: string;
+    description?: string;
+    url: string;
+    type: string;
+    metadata?: {
+        bucketType?: string;
+        path?: string;
+        loadDirection?: string;
+        size?: number;
+        bucketInfo?: {
+            bucket: string;
+            key: string;
+            region?: string;
+        };
+        uploadInfo?: {
+            signedUrl?: string;
+            expiresAt?: string;
+        };
+        originalName?: string;
+        checksum?: string;
+    };
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface SignedUrlData {
+    signedUrl: string;
+    key: string;
+    url: string;
+}
+interface UploadUrlResponse {
+    success: boolean;
+    data: {
+        file: FileResponse;
+        signedUrlData: SignedUrlData;
+    };
+}
+interface GetFileByIdResponse {
+    success: boolean;
+    data: FileResponse;
+}
+interface FileUploadOptions {
+    bucketType?: "immersive" | "resources" | "conversations";
+    path?: string;
+    description?: string;
+    onProgress?: (progress: number) => void;
+}
+interface FileUploadResult {
+    success: boolean;
+    id?: string;
+    name?: string;
+    url?: string;
+    type?: string;
+    error?: string;
+}
+
+export type { FileResponse, FileServiceConfig, FileUploadOptions, FileUploadResult, GetFileByIdResponse, SignedUrlData, UploadUrlRequest, UploadUrlResponse };

package/services/file/file.types.js

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

package/services/file/index.cjs

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+"use strict";var l=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var U=Object.prototype.hasOwnProperty;var h=(i,e)=>{for(var t in e)l(i,t,{get:e[t],enumerable:!0})},m=(i,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of g(e))!U.call(i,s)&&s!==t&&l(i,s,{get:()=>e[s],enumerable:!(r=f(e,s))||r.enumerable});return i};var F=i=>m(l({},"__esModule",{value:!0}),i);var R={};h(R,{FileService:()=>n,getFileService:()=>p});module.exports=F(R);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 n=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 a=1;a<=r;a++)try{let o=await this.uploadFile(e,t);if(o.success)return o;throw new Error(o.error||"Upload failed")}catch(o){if(s=o instanceof Error?o:new Error("Unknown error"),a===r)break;let u=2**a*1e3;await new Promise(d=>setTimeout(d,u))}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}}},p=()=>n.getInstance();0&&(module.exports={FileService,getFileService});

package/services/file/index.d.cts

@@ -0,0 +1,3 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+export { FileService, getFileService } from './file.service.cjs';
+export { FileResponse, FileServiceConfig, FileUploadOptions, FileUploadResult, SignedUrlData, UploadUrlRequest, UploadUrlResponse } from './file.types.cjs';

package/services/file/index.d.ts

@@ -0,0 +1,3 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+export { FileService, getFileService } from './file.service.js';
+export { FileResponse, FileServiceConfig, FileUploadOptions, FileUploadResult, SignedUrlData, UploadUrlRequest, UploadUrlResponse } from './file.types.js';

package/services/file/index.js

@@ -0,0 +1,2 @@
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+var l=async(i,e)=>{let r=await fetch(i,e);if(!r.ok){let t=await r.json().catch(()=>({}));throw new Error(JSON.stringify({status:r.status,statusText:r.statusText,...t}))}return r&&r.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,r={}){try{let t=await this.requestSignedUrl({filename:e.name,description:r.description,loadDirection:"up",bucketType:r.bucketType||"conversations",path:r.path||".temp",mimeType:e.type});return await this.uploadToSignedUrl(t.data.signedUrlData.signedUrl,e),{success:!0,id:t.data.file.id,name:t.data.file.name,url:t.data.file.url,type:t.data.file.type}}catch(t){return console.error("Error uploading file:",t),{success:!1,error:t instanceof Error?t.message:"Unknown error"}}}async requestSignedUrl(e){let r=`${this.config.baseUrl}/files/upload-url`;return this.makeRequest(r,{method:"POST",body:JSON.stringify(e)})}async uploadToSignedUrl(e,r){let t=await fetch(e,{method:"PUT",body:r,headers:{"Content-Type":r.type}});if(!t.ok){let o=await t.text().catch(()=>"No response");throw new Error(`Upload failed with status: ${t.status}. Response: ${o}`)}}async uploadFileWithRetry(e,r={}){let t=r.maxRetries||3,o=null;for(let n=1;n<=t;n++)try{let s=await this.uploadFile(e,r);if(s.success)return s;throw new Error(s.error||"Upload failed")}catch(s){if(o=s instanceof Error?s:new Error("Unknown error"),n===t)break;let c=2**n*1e3;await new Promise(p=>setTimeout(p,c))}return{success:!1,error:o?.message||"Upload failed after retries"}}async getFileById(e){let r=`${this.config.baseUrl}/files/${e}`,t=await this.makeRequest(r);if(!t.success)throw new Error("Failed to get file");return t.data}async makeRequest(e,r){let t={"Content-Type":"application/json"};return this.config.organizationId&&(t["X-Onlive-Organization-Id"]=this.config.organizationId),r?.headers&&Object.assign(t,r.headers),l(e,{...r,headers:t})}updateConfig(e){this.config={...this.config,...e}}getConfig(){return{...this.config}}},u=()=>a.getInstance();export{a as FileService,u as getFileService};

package/services/firebase/firebase-api.cjs

@@ -1,2 +1,2 @@
-/*! @onlive.ai/common-121 v0.2.66 | © 2025 Onlive.ai */
-"use strict";var a=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var g=(n,e,i)=>e in n?a(n,e,{enumerable:!0,configurable:!0,writable:!0,value:i}):n[e]=i;var h=(n,e)=>{for(var i in e)a(n,i,{get:e[i],enumerable:!0})},m=(n,e,i,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of c(e))!y.call(n,s)&&s!==i&&a(n,s,{get:()=>e[s],enumerable:!(t=u(e,s))||t.enumerable});return n};var f=n=>m(a({},"__esModule",{value:!0}),n);var o=(n,e,i)=>g(n,typeof e!="symbol"?e+"":e,i);var T={};h(T,{FirebaseApi:()=>l});module.exports=f(T);var d=require("firebase/app"),r=require("firebase/database");var l=class{constructor(e){o(this,"db");o(this,"onChildChanged",(e,i)=>(0,r.onChildChanged)(this.ref(e),t=>i(t.key,t.val(),t)));o(this,"onChildRemoved",(e,i)=>(0,r.onChildRemoved)(this.ref(e),t=>i(t.key,t.val(),t)));let i=(0,d.initializeApp)(e.config);this.db=(0,r.getDatabase)(i)}ref(e){return(0,r.ref)(this.db,e)}async getOnce(e){let i=await(0,r.get)(this.ref(e));return i.exists()?i.val():null}onValue(e,i){return(0,r.onValue)(this.ref(e),t=>i(t.key??"",t.val(),t),t=>console.error("onValue error",t))}onChildAdded(e,i){return(0,r.onChildAdded)(this.ref(e),t=>i(t.key,t.val(),t),t=>console.error("onChildAdded error",t))}write(e,i){return(0,r.set)(this.ref(e),i)}update(e,i){return(0,r.update)(this.ref(e),i)}remove(e){return(0,r.remove)(this.ref(e))}async push(e,i){let t=(0,r.push)(this.ref(e));return await(0,r.set)(t,i),t.key}onDisconnectUpdate(e,i){return(0,r.onDisconnect)(this.ref(e)).update(i)}cancelOnDisconnect(e){return(0,r.onDisconnect)(this.ref(e)).cancel()}transaction(e,i){return(0,r.runTransaction)(this.ref(e),t=>i(t))}query(e,i={}){let t=this.ref(e);return i.orderBy==="child"&&i.childKey&&(t=(0,r.query)(t,(0,r.orderByChild)(i.childKey))),i.orderBy==="key"&&(t=(0,r.query)(t,(0,r.orderByKey)())),i.orderBy==="value"&&(t=(0,r.query)(t,(0,r.orderByValue)())),i.limitFirst!=null&&(t=(0,r.query)(t,(0,r.limitToFirst)(i.limitFirst))),i.limitLast!=null&&(t=(0,r.query)(t,(0,r.limitToLast)(i.limitLast))),t}};0&&(module.exports={FirebaseApi});
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+"use strict";var s=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var y=(n,i)=>{for(var t in i)s(n,t,{get:i[t],enumerable:!0})},b=(n,i,t,e)=>{if(i&&typeof i=="object"||typeof i=="function")for(let a of d(i))!c.call(n,a)&&a!==t&&s(n,a,{get:()=>i[a],enumerable:!(e=u(i,a))||e.enumerable});return n};var T=n=>b(s({},"__esModule",{value:!0}),n);var g={};y(g,{FirebaseApi:()=>o});module.exports=T(g);var l=require("firebase/app"),r=require("firebase/database"),o=class{constructor(i){this.onChildChanged=(i,t)=>(0,r.onChildChanged)(this.ref(i),e=>t(e.key||"",e.val(),e));this.onChildRemoved=(i,t)=>(0,r.onChildRemoved)(this.ref(i),e=>t(e.key||"",e.val(),e));this.onChildChangedQuery=(i,t)=>(0,r.onChildChanged)(i,e=>t(e.key||"",e.val(),e));this.onChildRemovedQuery=(i,t)=>(0,r.onChildRemoved)(i,e=>t(e.key||"",e.val(),e));let t=(0,l.initializeApp)(i.config);this.db=(0,r.getDatabase)(t)}ref(i){return(0,r.ref)(this.db,i)}async getOnce(i){let t=await(0,r.get)(this.ref(i));return t.exists()?t.val():null}async getOnceQuery(i){let t=await(0,r.get)(i),e=[];return t.exists()&&t.forEach(a=>{e.push({key:a.key||"",value:a.val()})}),e}onValue(i,t){return(0,r.onValue)(this.ref(i),e=>t(e.key??"",e.val(),e),e=>console.error("onValue error",e))}onValueQuery(i,t){return(0,r.onValue)(i,e=>t(e.key??"",e.val(),e),e=>console.error("onValueQuery error",e))}onChildAdded(i,t){return(0,r.onChildAdded)(this.ref(i),e=>t(e.key||"",e.val(),e),e=>console.error("onChildAdded error",e))}onChildAddedQuery(i,t){return(0,r.onChildAdded)(i,e=>t(e.key||"",e.val(),e),e=>console.error("onChildAddedQuery error",e))}write(i,t){return(0,r.set)(this.ref(i),t)}update(i,t){return(0,r.update)(this.ref(i),t)}remove(i){return(0,r.remove)(this.ref(i))}async push(i,t){let e=(0,r.push)(this.ref(i));return await(0,r.set)(e,t),e.key}onDisconnectUpdate(i,t){return(0,r.onDisconnect)(this.ref(i)).update(t)}cancelOnDisconnect(i){return(0,r.onDisconnect)(this.ref(i)).cancel()}transaction(i,t){return(0,r.runTransaction)(this.ref(i),e=>t(e))}query(i,t={}){let e=this.ref(i);return t.orderBy==="child"&&t.childKey&&(e=(0,r.query)(e,(0,r.orderByChild)(t.childKey))),t.orderBy==="key"&&(e=(0,r.query)(e,(0,r.orderByKey)())),t.orderBy==="value"&&(e=(0,r.query)(e,(0,r.orderByValue)())),t.startAt!=null&&(e=(0,r.query)(e,(0,r.startAt)(t.startAt))),t.endAt!=null&&(e=(0,r.query)(e,(0,r.endAt)(t.endAt))),t.equalTo!=null&&(e=(0,r.query)(e,(0,r.equalTo)(t.equalTo))),t.limitFirst!=null&&(e=(0,r.query)(e,(0,r.limitToFirst)(t.limitFirst))),t.limitLast!=null&&(e=(0,r.query)(e,(0,r.limitToLast)(t.limitLast))),e}};0&&(module.exports={FirebaseApi});

package/services/firebase/firebase-api.d.cts

@@ -1,4 +1,5 @@
-import { DatabaseReference, DataSnapshot, Unsubscribe, TransactionResult, Query } from 'firebase/database';
+/*! @onlive.ai/common-121 v0.2.163 | © 2026 Onlive.ai */
+import { DatabaseReference, Query, DataSnapshot, Unsubscribe, TransactionResult } from 'firebase/database';
 
 type FirebaseConfig = {
     apiKey: string;
@@ -20,32 +21,47 @@ declare class FirebaseApi {
     /** Get a DatabaseReference */
     ref(path: string): DatabaseReference;
     /** Read once */
-    getOnce<T = any>(path: string): Promise<T | null>;
+    getOnce<T = object>(path: string): Promise<T | null>;
+    /** Read once from a query */
+    getOnceQuery<T = object>(q: Query): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
     /** Listen to value changes */
-    onValue<T = any>(path: string, cb: Callback<T>): Unsubscribe;
+    onValue<T = object>(path: string, cb: Callback<T>): Unsubscribe;
+    /** Listen to value changes for a query */
+    onValueQuery<T = object>(q: Query, cb: Callback<T>): Unsubscribe;
     /** Listen to child-added */
-    onChildAdded<T = any>(path: string, cb: Callback<T>): Unsubscribe;
+    onChildAdded<T = object>(path: string, cb: Callback<T>): Unsubscribe;
+    /** Listen to child-added for a query */
+    onChildAddedQuery<T = object>(q: Query, cb: Callback<T>): Unsubscribe;
     /** Other listeners... */
     onChildChanged: <T>(path: string, cb: Callback<T>) => Unsubscribe;
     onChildRemoved: <T>(path: string, cb: Callback<T>) => Unsubscribe;
+    /** Query variants for changed/removed */
+    onChildChangedQuery: <T>(q: Query, cb: Callback<T>) => Unsubscribe;
+    onChildRemovedQuery: <T>(q: Query, cb: Callback<T>) => Unsubscribe;
     /** Write/overwrite a node */
-    write(path: string, data: any): Promise<void>;
+    write(path: string, data: object): Promise<void>;
     /** Update (merge) a node */
-    update(path: string, data: Partial<any>): Promise<void>;
+    update(path: string, data: Partial<object>): Promise<void>;
     /** Remove a node */
     remove(path: string): Promise<void>;
     /** Push a child with generated key */
-    push<T = any>(path: string, data: T): Promise<string>;
+    push<T = object>(path: string, data: T): Promise<string>;
     /** onDisconnect write */
-    onDisconnectUpdate(path: string, data: any): Promise<void>;
+    onDisconnectUpdate(path: string, data: object): Promise<void>;
     /** Cancel onDisconnect operations */
     cancelOnDisconnect(path: string): Promise<void>;
     /** Run a transaction */
-    transaction<T = any>(path: string, updateFn: (cur: T | null) => T): Promise<TransactionResult>;
+    transaction<T = object>(path: string, updateFn: (cur: T | null) => T): Promise<TransactionResult>;
     /** Build a query */
     query(path: string, opts?: {
         orderBy?: "child" | "key" | "value";
         childKey?: string;
+        startAt?: string | number | boolean;
+        endAt?: string | number | boolean;
+        equalTo?: string | number | boolean;
         limitFirst?: number;
         limitLast?: number;
     }): Query;