@scalemule/chat 0.0.3 → 0.0.5

package/dist/index.d.cts

@@ -1,6 +1,77 @@
-export { C as ChatClient } from './ChatClient-lwyQYmNf.cjs';
-export { A as ApiError, a as ApiResponse, b as Attachment, C as ChannelSettings, c as ChannelWithSettings, d as ChatConfig, e as ChatEventMap, f as ChatMessage, g as ChatReaction, h as ConnectionStatus, i as Conversation, j as CreateConversationOptions, k as CreateEphemeralChannelOptions, l as CreateLargeRoomOptions, G as GetMessagesOptions, L as ListConversationsOptions, M as MessagesResponse, P as Participant, m as PresenceMember, R as ReactionSummary, n as ReadStatus, S as SendMessageOptions, U as UnreadTotalResponse } from './types-FQcFhbJx.cjs';
+import { C as ChatClient } from './ChatClient-BoZaTtyM.cjs';
+export { d as ApiError, A as ApiResponse, e as Attachment, f as ChannelSettings, g as ChannelWithSettings, C as ChatConfig, h as ChatEventMap, a as ChatMessage, i as ChatReaction, b as ConnectionStatus, c as Conversation, j as CreateConversationOptions, k as CreateEphemeralChannelOptions, l as CreateLargeRoomOptions, G as GetMessagesOptions, L as ListConversationsOptions, M as MessagesResponse, P as Participant, m as PresenceMember, R as ReactionSummary, n as ReadStatus, S as SendMessageOptions, U as UnreadTotalResponse } from './types-BmD7f1gV.cjs';
+
+/**
+ * SupportClient — High-level client for the support chat widget.
+ *
+ * Handles visitor session lifecycle (create/restore/refresh) and exposes
+ * the underlying ChatClient for real-time messaging.
+ *
+ * Usage:
+ * ```ts
+ * const support = new SupportClient({ apiKey: 'pb_...', apiBaseUrl: 'https://api.scalemule.com' });
+ * await support.initVisitorSession({ name: 'Jane' });
+ * const conversation = await support.startConversation('Hi, I need help!', { page_url: location.href });
+ * support.chat.on('message', (msg) => console.log(msg));
+ * ```
+ */
+
+interface SupportConversation {
+    id: string;
+    conversation_id: string;
+    status: string;
+    visitor_name?: string;
+    visitor_email?: string;
+    visitor_page_url?: string;
+    assigned_rep_id?: string;
+    assigned_rep_name?: string;
+    last_message_preview?: string;
+    last_message_at?: string;
+    created_at: string;
+    existing?: boolean;
+}
+interface SupportClientConfig {
+    apiKey: string;
+    apiBaseUrl?: string;
+}
+declare class SupportClient {
+    private chatClient;
+    private apiKey;
+    private apiBaseUrl;
+    private storageKey;
+    private anonymousId;
+    private refreshToken;
+    private accessToken;
+    private tokenExpiresAt;
+    private userId;
+    private visitorName;
+    private visitorEmail;
+    constructor(config: SupportClientConfig);
+    /** Create or restore a visitor session. Call before startConversation(). */
+    initVisitorSession(info?: {
+        name?: string;
+        email?: string;
+    }): Promise<void>;
+    /** Start a new support conversation with the first message. */
+    startConversation(message: string, meta?: {
+        page_url?: string;
+    }): Promise<SupportConversation>;
+    /** Get the visitor's active/waiting support conversation, if any. */
+    getActiveConversation(): Promise<SupportConversation | null>;
+    /** Get the underlying ChatClient for messaging, events, typing indicators, etc. */
+    get chat(): ChatClient;
+    /** Whether a visitor session has been initialized. */
+    get isInitialized(): boolean;
+    /** The visitor's user ID (available after initVisitorSession). */
+    get visitorUserId(): string | null;
+    /** Clean up all resources. */
+    destroy(): void;
+    private initChatClient;
+    private refreshAccessToken;
+    private loadState;
+    private saveState;
+}
 
 declare const CHAT_VERSION = "0.0.1";
 
-export { CHAT_VERSION };
+export { CHAT_VERSION, ChatClient, SupportClient, type SupportClientConfig, type SupportConversation };

package/dist/index.d.ts

@@ -1,6 +1,77 @@
-export { C as ChatClient } from './ChatClient-BD0sMudg.js';
-export { A as ApiError, a as ApiResponse, b as Attachment, C as ChannelSettings, c as ChannelWithSettings, d as ChatConfig, e as ChatEventMap, f as ChatMessage, g as ChatReaction, h as ConnectionStatus, i as Conversation, j as CreateConversationOptions, k as CreateEphemeralChannelOptions, l as CreateLargeRoomOptions, G as GetMessagesOptions, L as ListConversationsOptions, M as MessagesResponse, P as Participant, m as PresenceMember, R as ReactionSummary, n as ReadStatus, S as SendMessageOptions, U as UnreadTotalResponse } from './types-FQcFhbJx.js';
+import { C as ChatClient } from './ChatClient-COmdEJ11.js';
+export { d as ApiError, A as ApiResponse, e as Attachment, f as ChannelSettings, g as ChannelWithSettings, C as ChatConfig, h as ChatEventMap, a as ChatMessage, i as ChatReaction, b as ConnectionStatus, c as Conversation, j as CreateConversationOptions, k as CreateEphemeralChannelOptions, l as CreateLargeRoomOptions, G as GetMessagesOptions, L as ListConversationsOptions, M as MessagesResponse, P as Participant, m as PresenceMember, R as ReactionSummary, n as ReadStatus, S as SendMessageOptions, U as UnreadTotalResponse } from './types-BmD7f1gV.js';
+
+/**
+ * SupportClient — High-level client for the support chat widget.
+ *
+ * Handles visitor session lifecycle (create/restore/refresh) and exposes
+ * the underlying ChatClient for real-time messaging.
+ *
+ * Usage:
+ * ```ts
+ * const support = new SupportClient({ apiKey: 'pb_...', apiBaseUrl: 'https://api.scalemule.com' });
+ * await support.initVisitorSession({ name: 'Jane' });
+ * const conversation = await support.startConversation('Hi, I need help!', { page_url: location.href });
+ * support.chat.on('message', (msg) => console.log(msg));
+ * ```
+ */
+
+interface SupportConversation {
+    id: string;
+    conversation_id: string;
+    status: string;
+    visitor_name?: string;
+    visitor_email?: string;
+    visitor_page_url?: string;
+    assigned_rep_id?: string;
+    assigned_rep_name?: string;
+    last_message_preview?: string;
+    last_message_at?: string;
+    created_at: string;
+    existing?: boolean;
+}
+interface SupportClientConfig {
+    apiKey: string;
+    apiBaseUrl?: string;
+}
+declare class SupportClient {
+    private chatClient;
+    private apiKey;
+    private apiBaseUrl;
+    private storageKey;
+    private anonymousId;
+    private refreshToken;
+    private accessToken;
+    private tokenExpiresAt;
+    private userId;
+    private visitorName;
+    private visitorEmail;
+    constructor(config: SupportClientConfig);
+    /** Create or restore a visitor session. Call before startConversation(). */
+    initVisitorSession(info?: {
+        name?: string;
+        email?: string;
+    }): Promise<void>;
+    /** Start a new support conversation with the first message. */
+    startConversation(message: string, meta?: {
+        page_url?: string;
+    }): Promise<SupportConversation>;
+    /** Get the visitor's active/waiting support conversation, if any. */
+    getActiveConversation(): Promise<SupportConversation | null>;
+    /** Get the underlying ChatClient for messaging, events, typing indicators, etc. */
+    get chat(): ChatClient;
+    /** Whether a visitor session has been initialized. */
+    get isInitialized(): boolean;
+    /** The visitor's user ID (available after initVisitorSession). */
+    get visitorUserId(): string | null;
+    /** Clean up all resources. */
+    destroy(): void;
+    private initChatClient;
+    private refreshAccessToken;
+    private loadState;
+    private saveState;
+}
 
 declare const CHAT_VERSION = "0.0.1";
 
-export { CHAT_VERSION };
+export { CHAT_VERSION, ChatClient, SupportClient, type SupportClientConfig, type SupportConversation };

package/dist/index.js

@@ -1,6 +1,202 @@
-export { ChatClient } from './chunk-FXO4ZYQB.js';
+import { ChatClient } from './chunk-ZLMMNFZL.js';
+export { ChatClient } from './chunk-ZLMMNFZL.js';
+
+// src/support.ts
+var STORAGE_PREFIX = "sm_support_";
+var SupportClient = class {
+  constructor(config) {
+    this.chatClient = null;
+    this.refreshToken = null;
+    this.accessToken = null;
+    this.tokenExpiresAt = 0;
+    this.userId = null;
+    this.apiKey = config.apiKey;
+    this.apiBaseUrl = config.apiBaseUrl ?? "https://api.scalemule.com";
+    this.storageKey = STORAGE_PREFIX + config.apiKey.substring(0, 8);
+    const stored = this.loadState();
+    if (stored) {
+      this.anonymousId = stored.anonymous_id;
+      this.refreshToken = stored.refresh_token;
+      this.userId = stored.user_id;
+    } else {
+      this.anonymousId = crypto.randomUUID();
+    }
+  }
+  /** Create or restore a visitor session. Call before startConversation(). */
+  async initVisitorSession(info) {
+    this.visitorName = info?.name;
+    this.visitorEmail = info?.email;
+    if (this.refreshToken) {
+      try {
+        await this.refreshAccessToken();
+        this.initChatClient();
+        return;
+      } catch {
+        this.refreshToken = null;
+      }
+    }
+    const resp = await fetch(`${this.apiBaseUrl}/v1/auth/visitor-session`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.apiKey
+      },
+      body: JSON.stringify({
+        anonymous_id: this.anonymousId,
+        name: info?.name,
+        email: info?.email,
+        page_url: typeof location !== "undefined" ? location.href : void 0
+      })
+    });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new Error(`Visitor session failed: ${resp.status} ${body}`);
+    }
+    const result = await resp.json();
+    const data = result.data;
+    this.accessToken = data.access_token;
+    this.refreshToken = data.refresh_token;
+    this.userId = data.user_id;
+    this.tokenExpiresAt = Date.now() + data.expires_in * 1e3;
+    this.saveState();
+    this.initChatClient();
+  }
+  /** Start a new support conversation with the first message. */
+  async startConversation(message, meta) {
+    if (!this.accessToken) {
+      throw new Error("Call initVisitorSession() first");
+    }
+    const resp = await fetch(`${this.apiBaseUrl}/v1/chat/support/conversations`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.apiKey,
+        Authorization: `Bearer ${this.accessToken}`
+      },
+      body: JSON.stringify({
+        message,
+        name: this.visitorName,
+        email: this.visitorEmail,
+        page_url: meta?.page_url ?? (typeof location !== "undefined" ? location.href : void 0),
+        user_agent: typeof navigator !== "undefined" ? navigator.userAgent : void 0
+      })
+    });
+    if (!resp.ok) {
+      const body = await resp.text();
+      throw new Error(`Create support conversation failed: ${resp.status} ${body}`);
+    }
+    const result = await resp.json();
+    const conversation = result.data;
+    if (this.chatClient) {
+      this.chatClient.conversationTypes?.set(conversation.conversation_id, "support");
+    }
+    return conversation;
+  }
+  /** Get the visitor's active/waiting support conversation, if any. */
+  async getActiveConversation() {
+    if (!this.accessToken) return null;
+    const resp = await fetch(`${this.apiBaseUrl}/v1/chat/support/conversations/mine`, {
+      headers: {
+        "x-api-key": this.apiKey,
+        Authorization: `Bearer ${this.accessToken}`
+      }
+    });
+    if (!resp.ok) return null;
+    const result = await resp.json();
+    const conversations = result.data;
+    const active = conversations.find((c) => c.status === "active" || c.status === "waiting");
+    if (active && this.chatClient) {
+      this.chatClient.conversationTypes?.set(active.conversation_id, "support");
+    }
+    return active ?? null;
+  }
+  /** Get the underlying ChatClient for messaging, events, typing indicators, etc. */
+  get chat() {
+    if (!this.chatClient) {
+      throw new Error("Call initVisitorSession() first");
+    }
+    return this.chatClient;
+  }
+  /** Whether a visitor session has been initialized. */
+  get isInitialized() {
+    return this.chatClient !== null;
+  }
+  /** The visitor's user ID (available after initVisitorSession). */
+  get visitorUserId() {
+    return this.userId;
+  }
+  /** Clean up all resources. */
+  destroy() {
+    this.chatClient?.destroy();
+    this.chatClient = null;
+  }
+  // ============ Private ============
+  initChatClient() {
+    if (this.chatClient) {
+      this.chatClient.destroy();
+    }
+    const config = {
+      apiKey: this.apiKey,
+      apiBaseUrl: this.apiBaseUrl,
+      // Proactive token refresh: check expiry before each request.
+      // HttpTransport and WebSocketTransport call getToken() once per request
+      // and do NOT retry on 401/null, so the token must be valid when returned.
+      getToken: async () => {
+        if (!this.accessToken) return null;
+        if (Date.now() > this.tokenExpiresAt - 6e4) {
+          try {
+            await this.refreshAccessToken();
+          } catch {
+          }
+        }
+        return this.accessToken;
+      }
+    };
+    this.chatClient = new ChatClient(config);
+  }
+  async refreshAccessToken() {
+    if (!this.refreshToken) throw new Error("No refresh token");
+    const resp = await fetch(`${this.apiBaseUrl}/v1/auth/token/refresh`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.apiKey
+      },
+      body: JSON.stringify({ refresh_token: this.refreshToken })
+    });
+    if (!resp.ok) {
+      throw new Error(`Token refresh failed: ${resp.status}`);
+    }
+    const result = await resp.json();
+    const data = result.data;
+    this.accessToken = data.access_token;
+    this.tokenExpiresAt = Date.now() + data.expires_in * 1e3;
+  }
+  loadState() {
+    try {
+      const raw = localStorage.getItem(this.storageKey);
+      if (!raw) return null;
+      return JSON.parse(raw);
+    } catch {
+      return null;
+    }
+  }
+  saveState() {
+    try {
+      localStorage.setItem(
+        this.storageKey,
+        JSON.stringify({
+          anonymous_id: this.anonymousId,
+          refresh_token: this.refreshToken,
+          user_id: this.userId
+        })
+      );
+    } catch {
+    }
+  }
+};
 
 // src/version.ts
 var CHAT_VERSION = "0.0.1";
 
-export { CHAT_VERSION };
+export { CHAT_VERSION, SupportClient };

package/dist/react.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkWYFNZUAL_cjs = require('./chunk-WYFNZUAL.cjs');
+var chunkYDLRISR7_cjs = require('./chunk-YDLRISR7.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -11,7 +11,7 @@ function useChatContext() {
   return ctx;
 }
 function ChatProvider({ config, children }) {
-  const [client] = react.useState(() => new chunkWYFNZUAL_cjs.ChatClient(config));
+  const [client] = react.useState(() => new chunkYDLRISR7_cjs.ChatClient(config));
   react.useEffect(() => {
     return () => {
       client.destroy();
@@ -19,6 +19,9 @@ function ChatProvider({ config, children }) {
   }, [client]);
   return /* @__PURE__ */ jsxRuntime.jsx(ChatContext.Provider, { value: { client }, children });
 }
+function useChatClient() {
+  return useChatContext().client;
+}
 function useConnection() {
   const { client } = useChatContext();
   const [status, setStatus] = react.useState(client.status);
@@ -31,11 +34,9 @@ function useConnection() {
   react.useEffect(() => {
     return client.on("reconnecting", () => setStatus("reconnecting"));
   }, [client]);
-  return {
-    status,
-    connect: () => client.connect(),
-    disconnect: () => client.disconnect()
-  };
+  const connect = react.useCallback(() => client.connect(), [client]);
+  const disconnect = react.useCallback(() => client.disconnect(), [client]);
+  return { status, connect, disconnect };
 }
 function useChat(conversationId) {
   const { client } = useChatContext();
@@ -300,10 +301,11 @@ function useUnreadCount() {
 
 Object.defineProperty(exports, "ChatClient", {
   enumerable: true,
-  get: function () { return chunkWYFNZUAL_cjs.ChatClient; }
+  get: function () { return chunkYDLRISR7_cjs.ChatClient; }
 });
 exports.ChatProvider = ChatProvider;
 exports.useChat = useChat;
+exports.useChatClient = useChatClient;
 exports.useConnection = useConnection;
 exports.useConversations = useConversations;
 exports.usePresence = usePresence;

package/dist/react.d.cts

@@ -1,13 +1,15 @@
 import React, { ReactNode } from 'react';
-import { d as ChatConfig, f as ChatMessage, S as SendMessageOptions, a as ApiResponse, h as ConnectionStatus, i as Conversation } from './types-FQcFhbJx.cjs';
-export { G as GetMessagesOptions, L as ListConversationsOptions, M as MessagesResponse, R as ReactionSummary, U as UnreadTotalResponse } from './types-FQcFhbJx.cjs';
-export { C as ChatClient } from './ChatClient-lwyQYmNf.cjs';
+import { C as ChatClient } from './ChatClient-BoZaTtyM.cjs';
+import { C as ChatConfig, a as ChatMessage, S as SendMessageOptions, A as ApiResponse, b as ConnectionStatus, c as Conversation } from './types-BmD7f1gV.cjs';
+export { G as GetMessagesOptions, L as ListConversationsOptions, M as MessagesResponse, R as ReactionSummary, U as UnreadTotalResponse } from './types-BmD7f1gV.cjs';
 
 interface ChatProviderProps {
     config: ChatConfig;
     children: ReactNode;
 }
 declare function ChatProvider({ config, children }: ChatProviderProps): React.JSX.Element;
+/** Direct access to the ChatClient instance for custom event subscriptions (e.g., support:new). */
+declare function useChatClient(): ChatClient;
 declare function useConnection(): {
     status: ConnectionStatus;
     connect: () => void;
@@ -44,4 +46,4 @@ declare function useUnreadCount(): {
     totalUnread: number;
 };
 
-export { ApiResponse, ChatConfig, ChatMessage, ChatProvider, ConnectionStatus, Conversation, SendMessageOptions, useChat, useConnection, useConversations, usePresence, useTyping, useUnreadCount };
+export { ApiResponse, ChatClient, ChatConfig, ChatMessage, ChatProvider, ConnectionStatus, Conversation, SendMessageOptions, useChat, useChatClient, useConnection, useConversations, usePresence, useTyping, useUnreadCount };

package/dist/react.d.ts

@@ -1,13 +1,15 @@
 import React, { ReactNode } from 'react';
-import { d as ChatConfig, f as ChatMessage, S as SendMessageOptions, a as ApiResponse, h as ConnectionStatus, i as Conversation } from './types-FQcFhbJx.js';
-export { G as GetMessagesOptions, L as ListConversationsOptions, M as MessagesResponse, R as ReactionSummary, U as UnreadTotalResponse } from './types-FQcFhbJx.js';
-export { C as ChatClient } from './ChatClient-BD0sMudg.js';
+import { C as ChatClient } from './ChatClient-COmdEJ11.js';
+import { C as ChatConfig, a as ChatMessage, S as SendMessageOptions, A as ApiResponse, b as ConnectionStatus, c as Conversation } from './types-BmD7f1gV.js';
+export { G as GetMessagesOptions, L as ListConversationsOptions, M as MessagesResponse, R as ReactionSummary, U as UnreadTotalResponse } from './types-BmD7f1gV.js';
 
 interface ChatProviderProps {
     config: ChatConfig;
     children: ReactNode;
 }
 declare function ChatProvider({ config, children }: ChatProviderProps): React.JSX.Element;
+/** Direct access to the ChatClient instance for custom event subscriptions (e.g., support:new). */
+declare function useChatClient(): ChatClient;
 declare function useConnection(): {
     status: ConnectionStatus;
     connect: () => void;
@@ -44,4 +46,4 @@ declare function useUnreadCount(): {
     totalUnread: number;
 };
 
-export { ApiResponse, ChatConfig, ChatMessage, ChatProvider, ConnectionStatus, Conversation, SendMessageOptions, useChat, useConnection, useConversations, usePresence, useTyping, useUnreadCount };
+export { ApiResponse, ChatClient, ChatConfig, ChatMessage, ChatProvider, ConnectionStatus, Conversation, SendMessageOptions, useChat, useChatClient, useConnection, useConversations, usePresence, useTyping, useUnreadCount };

package/dist/react.js

@@ -1,5 +1,5 @@
-import { ChatClient } from './chunk-FXO4ZYQB.js';
-export { ChatClient } from './chunk-FXO4ZYQB.js';
+import { ChatClient } from './chunk-ZLMMNFZL.js';
+export { ChatClient } from './chunk-ZLMMNFZL.js';
 import { createContext, useState, useEffect, useCallback, useRef, useContext } from 'react';
 import { jsx } from 'react/jsx-runtime';
 
@@ -18,6 +18,9 @@ function ChatProvider({ config, children }) {
   }, [client]);
   return /* @__PURE__ */ jsx(ChatContext.Provider, { value: { client }, children });
 }
+function useChatClient() {
+  return useChatContext().client;
+}
 function useConnection() {
   const { client } = useChatContext();
   const [status, setStatus] = useState(client.status);
@@ -30,11 +33,9 @@ function useConnection() {
   useEffect(() => {
     return client.on("reconnecting", () => setStatus("reconnecting"));
   }, [client]);
-  return {
-    status,
-    connect: () => client.connect(),
-    disconnect: () => client.disconnect()
-  };
+  const connect = useCallback(() => client.connect(), [client]);
+  const disconnect = useCallback(() => client.disconnect(), [client]);
+  return { status, connect, disconnect };
 }
 function useChat(conversationId) {
   const { client } = useChatContext();
@@ -297,4 +298,4 @@ function useUnreadCount() {
   return { totalUnread };
 }
 
-export { ChatProvider, useChat, useConnection, useConversations, usePresence, useTyping, useUnreadCount };
+export { ChatProvider, useChat, useChatClient, useConnection, useConversations, usePresence, useTyping, useUnreadCount };