oblien 1.1.7 → 1.1.8

package/index.d.ts

@@ -66,15 +66,28 @@ export interface GuestManagerOptions {
     onGuestCreated?: (guest: Guest) => void;
 }
 
-export interface Guest {
+export interface GuestSession {
     id: string;
+    agentId: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    lastMessageAt?: string;
+    userAgent?: string;
+    country?: string;
+}
+
+export interface Guest {
+    id?: string;
     namespace: string;
     ip: string;
+    fingerprint?: string;
     isGuest: boolean;
     createdAt: string;
-    lastSeen: string;
-    metadata: Record<string, any>;
-    sessions: string[];
+    lastSeen?: string;
+    sessionCount: number;
+    metadata?: Record<string, any>;
+    sessions: GuestSession[];
 }
 
 export class GuestManager {
@@ -275,13 +288,19 @@ export interface ListSessionsOptions {
     includeStats?: boolean;
 }
 
+export interface GetGuestOptions {
+    ip?: string;
+    fingerprint?: string;
+    namespace?: string;
+}
+
 export class OblienChat {
     constructor(client: OblienClient, options?: ChatOptions);
     
     // Session Creation
     createSession(options: CreateSessionOptions): Promise<SessionData>;
     createGuestSession(options: CreateGuestSessionOptions): Promise<GuestSessionData>;
-    getGuest(ip: string, fingerprint?: string): Promise<Guest | null>; // From Oblien API
+    getGuest(options: GetGuestOptions | string): Promise<Guest | null>; // From Oblien API (string = namespace)
     getGuestFromCache(ip: string, fingerprint?: string): Promise<Guest | null>; // From local cache
     
     // Session Token Management (Server-side)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oblien",
-  "version": "1.1.7",
+  "version": "1.1.8",
   "description": "Server-side SDK for Oblien AI Platform - Build AI-powered applications with chat, agents, and workflows",
   "main": "index.js",
   "type": "module",

package/src/chat/index.js

@@ -148,17 +148,39 @@ export class OblienChat {
     }
 
     /**
-     * Get guest by IP and/or fingerprint from Oblien API (server-side)
-     * @param {string} ip - IP address
-     * @param {string} [fingerprint] - Client fingerprint (optional)
-     * @returns {Promise<Object|null>} Guest object or null
+     * Get guest sessions by namespace, IP, or fingerprint from Oblien API (server-side)
+     * @param {string|Object} options - Namespace string or query options object
+     * @param {string} [options.ip] - IP address
+     * @param {string} [options.fingerprint] - Client fingerprint
+     * @param {string} [options.namespace] - Guest namespace
+     * @returns {Promise<Object|null>} Guest object with sessions array or null
+     * 
+     * @example
+     * // Get by namespace (string)
+     * const guest = await chat.getGuest('guest-1-2-3-4');
+     * 
+     * @example
+     * // Get by IP and fingerprint (object)
+     * const guest = await chat.getGuest({ ip: '1.2.3.4', fingerprint: 'abc123' });
+     * 
+     * @example
+     * // Get by namespace (object)
+     * const guest = await chat.getGuest({ namespace: 'guest-1-2-3-4' });
      */
-    async getGuest(ip, fingerprint = null) {
-        if (!ip && !fingerprint) {
-            throw new Error('Either IP or fingerprint is required');
+    async getGuest(options) {
+        // Handle string usage: getGuest('namespace')
+        if (typeof options === 'string') {
+            options = { namespace: options };
+        }
+
+        const { ip, fingerprint, namespace } = options;
+
+        if (!ip && !fingerprint && !namespace) {
+            throw new Error('Either IP, fingerprint, or namespace is required');
         }
 
         const params = new URLSearchParams();
+        if (namespace) params.append('namespace', namespace);
         if (ip) params.append('ip', ip);
         if (fingerprint) params.append('fingerprint', fingerprint);