@scalemule/chat 0.0.1

package/dist/react.d.ts

@@ -0,0 +1,37 @@
+import React, { ReactNode } from 'react';
+import { c as ChatConfig, e as ChatMessage, S as SendMessageOptions, a as ApiResponse, g as ConnectionStatus } from './types-BwgD_Etd.js';
+export { h as Conversation, G as GetMessagesOptions, M as MessagesResponse } from './types-BwgD_Etd.js';
+export { C as ChatClient } from './ChatClient-DCid_mmU.js';
+
+interface ChatProviderProps {
+    config: ChatConfig;
+    children: ReactNode;
+}
+declare function ChatProvider({ config, children }: ChatProviderProps): React.JSX.Element;
+declare function useConnection(): {
+    status: ConnectionStatus;
+    connect: () => void;
+    disconnect: () => void;
+};
+declare function useChat(conversationId?: string): {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    error: string | null;
+    hasMore: boolean;
+    sendMessage: (content: string, options?: Partial<SendMessageOptions>) => Promise<ApiResponse<ChatMessage> | undefined>;
+    loadMore: () => Promise<void>;
+    markRead: () => Promise<void>;
+};
+declare function usePresence(conversationId?: string): {
+    members: {
+        userId: string;
+        status: string;
+        userData?: unknown;
+    }[];
+};
+declare function useTyping(conversationId?: string): {
+    typingUsers: string[];
+    sendTyping: (isTyping?: boolean) => void;
+};
+
+export { ApiResponse, ChatConfig, ChatMessage, ChatProvider, ConnectionStatus, SendMessageOptions, useChat, useConnection, usePresence, useTyping };

package/dist/react.js

@@ -0,0 +1,233 @@
+import { ChatClient } from './chunk-6QRI4CJZ.js';
+export { ChatClient } from './chunk-6QRI4CJZ.js';
+import { createContext, useState, useEffect, useCallback, useRef, useContext } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+var ChatContext = createContext(null);
+function useChatContext() {
+  const ctx = useContext(ChatContext);
+  if (!ctx) throw new Error("useChatContext must be used within a ChatProvider");
+  return ctx;
+}
+function ChatProvider({ config, children }) {
+  const [client] = useState(() => new ChatClient(config));
+  useEffect(() => {
+    return () => {
+      client.destroy();
+    };
+  }, [client]);
+  return /* @__PURE__ */ jsx(ChatContext.Provider, { value: { client }, children });
+}
+function useConnection() {
+  const { client } = useChatContext();
+  const [status, setStatus] = useState(client.status);
+  useEffect(() => {
+    return client.on("connected", () => setStatus("connected"));
+  }, [client]);
+  useEffect(() => {
+    return client.on("disconnected", () => setStatus("disconnected"));
+  }, [client]);
+  useEffect(() => {
+    return client.on("reconnecting", () => setStatus("reconnecting"));
+  }, [client]);
+  return {
+    status,
+    connect: () => client.connect(),
+    disconnect: () => client.disconnect()
+  };
+}
+function useChat(conversationId) {
+  const { client } = useChatContext();
+  const [messages, setMessages] = useState([]);
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [hasMore, setHasMore] = useState(false);
+  useEffect(() => {
+    if (!conversationId) return;
+    setIsLoading(true);
+    setError(null);
+    let cancelled = false;
+    let unsub;
+    (async () => {
+      await client.getConversation(conversationId);
+      if (cancelled) return;
+      const result = await client.getMessages(conversationId);
+      if (cancelled) return;
+      if (result.data?.messages) {
+        setMessages(result.data.messages);
+        setHasMore(result.data.has_more ?? false);
+      } else if (result.error) {
+        setError(result.error.message);
+      }
+      setIsLoading(false);
+      unsub = client.subscribeToConversation(conversationId);
+      client.connect();
+    })();
+    return () => {
+      cancelled = true;
+      unsub?.();
+    };
+  }, [client, conversationId]);
+  useEffect(() => {
+    if (!conversationId) return;
+    return client.on("message", ({ message, conversationId: convId }) => {
+      if (convId === conversationId) {
+        setMessages((prev) => {
+          if (prev.some((m) => m.id === message.id)) return prev;
+          return [...prev, message];
+        });
+      }
+    });
+  }, [client, conversationId]);
+  useEffect(() => {
+    if (!conversationId) return;
+    return client.on("message:updated", ({ message, conversationId: convId }) => {
+      if (convId === conversationId) {
+        setMessages((prev) => prev.map((m) => m.id === message.id ? message : m));
+      }
+    });
+  }, [client, conversationId]);
+  useEffect(() => {
+    if (!conversationId) return;
+    return client.on("message:deleted", ({ messageId, conversationId: convId }) => {
+      if (convId === conversationId) {
+        setMessages((prev) => prev.filter((m) => m.id !== messageId));
+      }
+    });
+  }, [client, conversationId]);
+  const sendMessage = useCallback(
+    async (content, options) => {
+      if (!conversationId) return;
+      return client.sendMessage(conversationId, { content, ...options });
+    },
+    [client, conversationId]
+  );
+  const loadMore = useCallback(async () => {
+    if (!conversationId || !messages.length) return;
+    const oldestId = messages[0]?.id;
+    const result = await client.getMessages(conversationId, { before: oldestId });
+    if (result.data?.messages) {
+      setMessages((prev) => [...result.data.messages, ...prev]);
+      setHasMore(result.data.has_more ?? false);
+    }
+  }, [client, conversationId, messages]);
+  const markRead = useCallback(async () => {
+    if (!conversationId) return;
+    await client.markRead(conversationId);
+  }, [client, conversationId]);
+  return {
+    messages,
+    isLoading,
+    error,
+    hasMore,
+    sendMessage,
+    loadMore,
+    markRead
+  };
+}
+function usePresence(conversationId) {
+  const { client } = useChatContext();
+  const [members, setMembers] = useState([]);
+  useEffect(() => {
+    if (!conversationId) return;
+    let cancelled = false;
+    (async () => {
+      await client.getConversation(conversationId);
+      if (cancelled) return;
+      client.joinPresence(conversationId);
+    })();
+    const unsubState = client.on("presence:state", ({ conversationId: convId, members: m }) => {
+      if (convId === conversationId) {
+        setMembers(
+          m.map((p) => ({
+            userId: p.user_id,
+            status: p.status ?? "online",
+            userData: p.user_data
+          }))
+        );
+      }
+    });
+    const unsubJoin = client.on("presence:join", ({ conversationId: convId, userId, userData }) => {
+      if (convId === conversationId) {
+        setMembers((prev) => {
+          if (prev.some((m) => m.userId === userId)) return prev;
+          return [...prev, { userId, status: "online", userData }];
+        });
+      }
+    });
+    const unsubLeave = client.on("presence:leave", ({ conversationId: convId, userId }) => {
+      if (convId === conversationId) {
+        setMembers((prev) => prev.filter((m) => m.userId !== userId));
+      }
+    });
+    const unsubUpdate = client.on(
+      "presence:update",
+      ({ conversationId: convId, userId, status, userData }) => {
+        if (convId === conversationId) {
+          setMembers(
+            (prev) => prev.map(
+              (m) => m.userId === userId ? { ...m, status, userData: userData ?? m.userData } : m
+            )
+          );
+        }
+      }
+    );
+    return () => {
+      cancelled = true;
+      client.leavePresence(conversationId);
+      unsubState();
+      unsubJoin();
+      unsubLeave();
+      unsubUpdate();
+    };
+  }, [client, conversationId]);
+  return { members };
+}
+function useTyping(conversationId) {
+  const { client } = useChatContext();
+  const [typingUsers, setTypingUsers] = useState([]);
+  const typingTimers = useRef(/* @__PURE__ */ new Map());
+  useEffect(() => {
+    if (!conversationId) return;
+    const unsubTyping = client.on("typing", ({ conversationId: convId, userId }) => {
+      if (convId !== conversationId) return;
+      setTypingUsers((prev) => prev.includes(userId) ? prev : [...prev, userId]);
+      const existing = typingTimers.current.get(userId);
+      if (existing) clearTimeout(existing);
+      typingTimers.current.set(
+        userId,
+        setTimeout(() => {
+          setTypingUsers((prev) => prev.filter((id) => id !== userId));
+          typingTimers.current.delete(userId);
+        }, 3e3)
+      );
+    });
+    const unsubStop = client.on("typing:stop", ({ conversationId: convId, userId }) => {
+      if (convId !== conversationId) return;
+      setTypingUsers((prev) => prev.filter((id) => id !== userId));
+      const timer = typingTimers.current.get(userId);
+      if (timer) {
+        clearTimeout(timer);
+        typingTimers.current.delete(userId);
+      }
+    });
+    return () => {
+      unsubTyping();
+      unsubStop();
+      for (const timer of typingTimers.current.values()) {
+        clearTimeout(timer);
+      }
+      typingTimers.current.clear();
+    };
+  }, [client, conversationId]);
+  const sendTyping = useCallback(
+    (isTyping = true) => {
+      if (!conversationId) return;
+      client.sendTyping(conversationId, isTyping);
+    },
+    [client, conversationId]
+  );
+  return { typingUsers, sendTyping };
+}
+
+export { ChatProvider, useChat, useConnection, usePresence, useTyping };

package/dist/types-BwgD_Etd.d.cts

@@ -0,0 +1,178 @@
+interface ChatConfig {
+    apiKey?: string;
+    embedToken?: string;
+    apiBaseUrl?: string;
+    applicationId?: string;
+    userId?: string;
+    sessionToken?: string;
+    getToken?: () => Promise<string | null>;
+    debug?: boolean;
+    reconnect?: {
+        maxRetries?: number;
+        baseDelay?: number;
+        maxDelay?: number;
+    };
+    messageCache?: {
+        maxMessages?: number;
+        maxConversations?: number;
+    };
+    offlineQueue?: boolean;
+}
+interface ApiResponse<T> {
+    data: T | null;
+    error: ApiError | null;
+}
+interface ApiError {
+    code: string;
+    message: string;
+    status: number;
+    details?: Record<string, unknown>;
+}
+interface Conversation {
+    id: string;
+    conversation_type: 'direct' | 'group' | 'broadcast' | 'ephemeral' | 'large_room';
+    name?: string;
+    created_by?: string;
+    participant_count?: number;
+    last_message_at?: string;
+    unread_count?: number;
+    created_at: string;
+    participants?: Participant[];
+}
+interface Participant {
+    user_id: string;
+    role: string;
+    joined_at: string;
+}
+interface ChatMessage {
+    id: string;
+    content: string;
+    message_type: 'text' | 'image' | 'file' | 'system';
+    sender_id: string;
+    sender_type?: string;
+    sender_agent_model?: string;
+    attachments?: Attachment[];
+    is_edited: boolean;
+    created_at: string;
+}
+interface Attachment {
+    file_id: string;
+    file_name: string;
+    file_size: number;
+    mime_type: string;
+    presigned_url?: string;
+    thumbnail_url?: string;
+}
+interface ReadStatus {
+    user_id: string;
+    last_read_at?: string;
+}
+interface ChatReaction {
+    id: string;
+    message_id: string;
+    user_id: string;
+    emoji: string;
+}
+interface PresenceMember {
+    user_id: string;
+    user_data?: unknown;
+    joined_at: string;
+}
+interface ChannelSettings {
+    publisher_user_ids?: string[];
+    linked_session_id?: string;
+    expires_at?: string;
+    max_participants?: number;
+    slow_mode_seconds?: number;
+}
+interface ChatEventMap {
+    connected: void;
+    disconnected: void;
+    reconnecting: {
+        attempt: number;
+    };
+    'message': {
+        message: ChatMessage;
+        conversationId: string;
+    };
+    'message:updated': {
+        message: ChatMessage;
+        conversationId: string;
+    };
+    'message:deleted': {
+        messageId: string;
+        conversationId: string;
+    };
+    'typing': {
+        userId: string;
+        conversationId: string;
+    };
+    'typing:stop': {
+        userId: string;
+        conversationId: string;
+    };
+    'presence:join': {
+        userId: string;
+        conversationId: string;
+        userData?: unknown;
+    };
+    'presence:leave': {
+        userId: string;
+        conversationId: string;
+    };
+    'presence:update': {
+        userId: string;
+        conversationId: string;
+        status: string;
+        userData?: unknown;
+    };
+    'presence:state': {
+        conversationId: string;
+        members: PresenceMember[];
+    };
+    'read': {
+        userId: string;
+        conversationId: string;
+        lastReadAt: string;
+    };
+    'reaction': {
+        reaction: ChatReaction;
+        conversationId: string;
+    };
+    'delivery': {
+        messageId: string;
+        status: 'sent' | 'delivered' | 'read';
+    };
+    'error': {
+        code: string;
+        message: string;
+    };
+}
+type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+interface SendMessageOptions {
+    content: string;
+    message_type?: 'text' | 'image' | 'file';
+    attachments?: Attachment[];
+}
+interface ListConversationsOptions {
+    page?: number;
+    per_page?: number;
+}
+interface GetMessagesOptions {
+    limit?: number;
+    before?: string;
+    after?: string;
+}
+interface CreateConversationOptions {
+    conversation_type?: 'direct' | 'group';
+    name?: string;
+    participant_ids: string[];
+}
+interface MessagesResponse {
+    messages: ChatMessage[];
+    has_more?: boolean;
+    oldest_id?: string;
+    newest_id?: string;
+}
+
+export type { ApiError as A, ChannelSettings as C, GetMessagesOptions as G, ListConversationsOptions as L, MessagesResponse as M, Participant as P, ReadStatus as R, SendMessageOptions as S, ApiResponse as a, Attachment as b, ChatConfig as c, ChatEventMap as d, ChatMessage as e, ChatReaction as f, ConnectionStatus as g, Conversation as h, CreateConversationOptions as i, PresenceMember as j };

package/dist/types-BwgD_Etd.d.ts

@@ -0,0 +1,178 @@
+interface ChatConfig {
+    apiKey?: string;
+    embedToken?: string;
+    apiBaseUrl?: string;
+    applicationId?: string;
+    userId?: string;
+    sessionToken?: string;
+    getToken?: () => Promise<string | null>;
+    debug?: boolean;
+    reconnect?: {
+        maxRetries?: number;
+        baseDelay?: number;
+        maxDelay?: number;
+    };
+    messageCache?: {
+        maxMessages?: number;
+        maxConversations?: number;
+    };
+    offlineQueue?: boolean;
+}
+interface ApiResponse<T> {
+    data: T | null;
+    error: ApiError | null;
+}
+interface ApiError {
+    code: string;
+    message: string;
+    status: number;
+    details?: Record<string, unknown>;
+}
+interface Conversation {
+    id: string;
+    conversation_type: 'direct' | 'group' | 'broadcast' | 'ephemeral' | 'large_room';
+    name?: string;
+    created_by?: string;
+    participant_count?: number;
+    last_message_at?: string;
+    unread_count?: number;
+    created_at: string;
+    participants?: Participant[];
+}
+interface Participant {
+    user_id: string;
+    role: string;
+    joined_at: string;
+}
+interface ChatMessage {
+    id: string;
+    content: string;
+    message_type: 'text' | 'image' | 'file' | 'system';
+    sender_id: string;
+    sender_type?: string;
+    sender_agent_model?: string;
+    attachments?: Attachment[];
+    is_edited: boolean;
+    created_at: string;
+}
+interface Attachment {
+    file_id: string;
+    file_name: string;
+    file_size: number;
+    mime_type: string;
+    presigned_url?: string;
+    thumbnail_url?: string;
+}
+interface ReadStatus {
+    user_id: string;
+    last_read_at?: string;
+}
+interface ChatReaction {
+    id: string;
+    message_id: string;
+    user_id: string;
+    emoji: string;
+}
+interface PresenceMember {
+    user_id: string;
+    user_data?: unknown;
+    joined_at: string;
+}
+interface ChannelSettings {
+    publisher_user_ids?: string[];
+    linked_session_id?: string;
+    expires_at?: string;
+    max_participants?: number;
+    slow_mode_seconds?: number;
+}
+interface ChatEventMap {
+    connected: void;
+    disconnected: void;
+    reconnecting: {
+        attempt: number;
+    };
+    'message': {
+        message: ChatMessage;
+        conversationId: string;
+    };
+    'message:updated': {
+        message: ChatMessage;
+        conversationId: string;
+    };
+    'message:deleted': {
+        messageId: string;
+        conversationId: string;
+    };
+    'typing': {
+        userId: string;
+        conversationId: string;
+    };
+    'typing:stop': {
+        userId: string;
+        conversationId: string;
+    };
+    'presence:join': {
+        userId: string;
+        conversationId: string;
+        userData?: unknown;
+    };
+    'presence:leave': {
+        userId: string;
+        conversationId: string;
+    };
+    'presence:update': {
+        userId: string;
+        conversationId: string;
+        status: string;
+        userData?: unknown;
+    };
+    'presence:state': {
+        conversationId: string;
+        members: PresenceMember[];
+    };
+    'read': {
+        userId: string;
+        conversationId: string;
+        lastReadAt: string;
+    };
+    'reaction': {
+        reaction: ChatReaction;
+        conversationId: string;
+    };
+    'delivery': {
+        messageId: string;
+        status: 'sent' | 'delivered' | 'read';
+    };
+    'error': {
+        code: string;
+        message: string;
+    };
+}
+type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
+interface SendMessageOptions {
+    content: string;
+    message_type?: 'text' | 'image' | 'file';
+    attachments?: Attachment[];
+}
+interface ListConversationsOptions {
+    page?: number;
+    per_page?: number;
+}
+interface GetMessagesOptions {
+    limit?: number;
+    before?: string;
+    after?: string;
+}
+interface CreateConversationOptions {
+    conversation_type?: 'direct' | 'group';
+    name?: string;
+    participant_ids: string[];
+}
+interface MessagesResponse {
+    messages: ChatMessage[];
+    has_more?: boolean;
+    oldest_id?: string;
+    newest_id?: string;
+}
+
+export type { ApiError as A, ChannelSettings as C, GetMessagesOptions as G, ListConversationsOptions as L, MessagesResponse as M, Participant as P, ReadStatus as R, SendMessageOptions as S, ApiResponse as a, Attachment as b, ChatConfig as c, ChatEventMap as d, ChatMessage as e, ChatReaction as f, ConnectionStatus as g, Conversation as h, CreateConversationOptions as i, PresenceMember as j };

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@scalemule/chat",
+  "version": "0.0.1",
+  "description": "ScaleMule standalone chat SDK — real-time messaging, presence, typing indicators",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
+    "./element": {
+      "types": "./dist/element.d.ts",
+      "import": "./dist/element.js",
+      "require": "./dist/element.cjs"
+    },
+    "./iframe": {
+      "types": "./dist/iframe.d.ts",
+      "import": "./dist/iframe.js",
+      "require": "./dist/iframe.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true },
+    "react-dom": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  },
+  "author": "ScaleMule Inc. <support@scalemule.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}