@onlive.ai/common-121 0.2.179 → 0.2.184

package/index.d.cts

@@ -1,4 +1,4 @@
-/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+/*! @onlive.ai/common-121 v0.2.184 | © 2026 Onlive.ai */
 import * as lit from 'lit';
 import { LitElement, TemplateResult } from 'lit';
 import * as _lit_react from '@lit/react';
@@ -6,7 +6,7 @@ import { EventName } from '@lit/react';
 import { Room as Room$1, Participant } from 'livekit-client';
 import { ReceivedChatMessage } from '@livekit/components-core';
 
-/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+/*! @onlive.ai/common-121 v0.2.184 | © 2026 Onlive.ai */
 
 
 type AssetType = "product" | "multimedia" | "faq" | "file";
@@ -1464,6 +1464,60 @@ type CreateRoomOptions = {
     userGroupId?: string;
     initialMessage?: string;
 };
+/**
+ * Options for the unified quick-start endpoint that combines user registration
+ * and room creation in a single HTTP call.
+ *
+ * @property {Object} user - User registration data.
+ * @property {string} user.externalId - External user identifier.
+ * @property {string} user.secret - User authentication secret.
+ * @property {string} [user.name] - User display name.
+ * @property {string} [user.email] - User email address.
+ * @property {string} [user.phone] - User phone number.
+ * @property {string} [user.avatar] - URL of the user's avatar.
+ * @property {Record<string, unknown>} [user.metadata] - Additional user metadata.
+ * @property {string | null} [user.userGroupId] - User group identifier.
+ * @property {string} [user.sessionId] - External session identifier.
+ * @property {Object} room - Room creation data.
+ * @property {string} room.language - Preferred language code (e.g., "en", "es").
+ * @property {string} room.timezone - IANA timezone identifier.
+ * @property {Record<string, unknown>} [room.affinity] - Agent affinity preferences.
+ * @property {string} [room.name] - Room display name.
+ * @property {string} [room.platformType] - Platform type (default: "web").
+ * @property {Record<string, unknown>} [room.metadata] - Additional room metadata.
+ * @property {string | null} [room.userGroupId] - Room user group identifier.
+ * @property {boolean} [room.disablePersistence] - Disable message persistence.
+ * @property {ContextualEvent[]} [room.contextualEvents] - Initial contextual events.
+ * @property {{ content: string; assets?: unknown[] }} [room.initialMessage] - Initial message to include in the room.
+ */
+type QuickStartOptions = {
+    user: {
+        externalId: string;
+        secret: string;
+        name?: string;
+        email?: string;
+        phone?: string;
+        avatar?: string;
+        metadata?: Record<string, unknown>;
+        userGroupId?: string | null;
+        sessionId?: string;
+    };
+    room: {
+        language: string;
+        timezone: string;
+        affinity?: Record<string, unknown>;
+        name?: string;
+        platformType?: string;
+        metadata?: Record<string, unknown>;
+        userGroupId?: string | null;
+        disablePersistence?: boolean;
+        contextualEvents?: ContextualEvent[];
+        initialMessage?: {
+            content: string;
+            assets?: unknown[];
+        };
+    };
+};
 /**
  * Options for fetching messages.
  *
@@ -1776,6 +1830,19 @@ declare class ConversationService {
      * @returns {{ username?: string; sub?: string; iat?: number; exp?: number } | null} Decoded payload or null if invalid.
      */
     private decodeJwtPayload;
+    /**
+     * Performs a unified user registration and room creation in a single HTTP call.
+     *
+     * This method combines the `registerUser` and `createRoom` steps into one request,
+     * reducing latency by eliminating the intermediate round-trip and JWT authentication overhead.
+     * It does not require a prior authentication token — only the organization header.
+     *
+     * @async
+     * @param {QuickStartOptions} options - Combined user and room options.
+     * @returns {Promise<Room>} Connected room instance ready for messaging.
+     * @throws {Error} If the quick-start request fails or returns invalid data.
+     */
+    quickStart(options: QuickStartOptions): Promise<Room>;
     /**
      * Creates a new conversation room.
      *
@@ -3436,6 +3503,11 @@ declare class MockConversationService {
      * Registers an agent for handling conversations.
      */
     registerAgent(externalId: string, agentData: AgentData): Promise<string>;
+    /**
+     * Mock implementation of the unified quick-start endpoint.
+     * Combines registerUser and createRoom into a single call.
+     */
+    quickStart(options: QuickStartOptions): Promise<MockRoom>;
     /**
      * Creates a new conversation room.
      */

package/index.d.ts

@@ -1,4 +1,4 @@
-/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+/*! @onlive.ai/common-121 v0.2.184 | © 2026 Onlive.ai */
 import * as lit from 'lit';
 import { LitElement, TemplateResult } from 'lit';
 import * as _lit_react from '@lit/react';
@@ -6,7 +6,7 @@ import { EventName } from '@lit/react';
 import { Room as Room$1, Participant } from 'livekit-client';
 import { ReceivedChatMessage } from '@livekit/components-core';
 
-/*! @onlive.ai/common-121 v0.2.179 | © 2026 Onlive.ai */
+/*! @onlive.ai/common-121 v0.2.184 | © 2026 Onlive.ai */
 
 
 type AssetType = "product" | "multimedia" | "faq" | "file";
@@ -1464,6 +1464,60 @@ type CreateRoomOptions = {
     userGroupId?: string;
     initialMessage?: string;
 };
+/**
+ * Options for the unified quick-start endpoint that combines user registration
+ * and room creation in a single HTTP call.
+ *
+ * @property {Object} user - User registration data.
+ * @property {string} user.externalId - External user identifier.
+ * @property {string} user.secret - User authentication secret.
+ * @property {string} [user.name] - User display name.
+ * @property {string} [user.email] - User email address.
+ * @property {string} [user.phone] - User phone number.
+ * @property {string} [user.avatar] - URL of the user's avatar.
+ * @property {Record<string, unknown>} [user.metadata] - Additional user metadata.
+ * @property {string | null} [user.userGroupId] - User group identifier.
+ * @property {string} [user.sessionId] - External session identifier.
+ * @property {Object} room - Room creation data.
+ * @property {string} room.language - Preferred language code (e.g., "en", "es").
+ * @property {string} room.timezone - IANA timezone identifier.
+ * @property {Record<string, unknown>} [room.affinity] - Agent affinity preferences.
+ * @property {string} [room.name] - Room display name.
+ * @property {string} [room.platformType] - Platform type (default: "web").
+ * @property {Record<string, unknown>} [room.metadata] - Additional room metadata.
+ * @property {string | null} [room.userGroupId] - Room user group identifier.
+ * @property {boolean} [room.disablePersistence] - Disable message persistence.
+ * @property {ContextualEvent[]} [room.contextualEvents] - Initial contextual events.
+ * @property {{ content: string; assets?: unknown[] }} [room.initialMessage] - Initial message to include in the room.
+ */
+type QuickStartOptions = {
+    user: {
+        externalId: string;
+        secret: string;
+        name?: string;
+        email?: string;
+        phone?: string;
+        avatar?: string;
+        metadata?: Record<string, unknown>;
+        userGroupId?: string | null;
+        sessionId?: string;
+    };
+    room: {
+        language: string;
+        timezone: string;
+        affinity?: Record<string, unknown>;
+        name?: string;
+        platformType?: string;
+        metadata?: Record<string, unknown>;
+        userGroupId?: string | null;
+        disablePersistence?: boolean;
+        contextualEvents?: ContextualEvent[];
+        initialMessage?: {
+            content: string;
+            assets?: unknown[];
+        };
+    };
+};
 /**
  * Options for fetching messages.
  *
@@ -1776,6 +1830,19 @@ declare class ConversationService {
      * @returns {{ username?: string; sub?: string; iat?: number; exp?: number } | null} Decoded payload or null if invalid.
      */
     private decodeJwtPayload;
+    /**
+     * Performs a unified user registration and room creation in a single HTTP call.
+     *
+     * This method combines the `registerUser` and `createRoom` steps into one request,
+     * reducing latency by eliminating the intermediate round-trip and JWT authentication overhead.
+     * It does not require a prior authentication token — only the organization header.
+     *
+     * @async
+     * @param {QuickStartOptions} options - Combined user and room options.
+     * @returns {Promise<Room>} Connected room instance ready for messaging.
+     * @throws {Error} If the quick-start request fails or returns invalid data.
+     */
+    quickStart(options: QuickStartOptions): Promise<Room>;
     /**
      * Creates a new conversation room.
      *
@@ -3436,6 +3503,11 @@ declare class MockConversationService {
      * Registers an agent for handling conversations.
      */
     registerAgent(externalId: string, agentData: AgentData): Promise<string>;
+    /**
+     * Mock implementation of the unified quick-start endpoint.
+     * Combines registerUser and createRoom into a single call.
+     */
+    quickStart(options: QuickStartOptions): Promise<MockRoom>;
     /**
      * Creates a new conversation room.
      */