@enfin/chat 1.2.0

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './testUtils';
+export * from './ringtone';

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export * from './testUtils';
+export * from './ringtone';

package/dist/utils/ringtone.d.ts

@@ -0,0 +1,2 @@
+export declare function startRingtone(url?: string): void;
+export declare function stopRingtone(): void;

package/dist/utils/ringtone.js

@@ -0,0 +1,39 @@
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+import defaultRingtoneUrl from '../assets/music/i_phone_message.mp3';
+let audioEl = null;
+let currentUrl = null;
+function getAudio(url) {
+    const target = url || defaultRingtoneUrl;
+    if (!audioEl || currentUrl !== target) {
+        if (audioEl) {
+            audioEl.pause();
+            audioEl.src = '';
+        }
+        audioEl = new Audio(target);
+        audioEl.loop = true;
+        audioEl.preload = 'auto';
+        currentUrl = target;
+    }
+    return audioEl;
+}
+export function startRingtone(url) {
+    try {
+        const audio = getAudio(url);
+        audio.currentTime = 0;
+        const playPromise = audio.play();
+        if (playPromise && typeof playPromise.catch === 'function') {
+            playPromise.catch((err) => {
+                console.log('[RINGTONE] play() rejected:', err?.message || err);
+            });
+        }
+    }
+    catch (err) {
+        console.log('[RINGTONE] start failed:', err?.message || err);
+    }
+}
+export function stopRingtone() {
+    if (!audioEl)
+        return;
+    audioEl.pause();
+    audioEl.currentTime = 0;
+}

package/dist/utils/testUtils.d.ts

@@ -0,0 +1,102 @@
+import { Socket } from 'socket.io-client';
+/**
+ * Test utilities for developers to create test users and simulate interactions
+ *
+ * This utility allows developers to:
+ * 1. Create multiple test users that can chat with each other
+ * 2. Send messages between test users
+ * 3. Make audio calls between test users
+ * 4. Test custom socket events
+ */
+export interface TestUser {
+    id: string;
+    name: string;
+    socket: Socket;
+    rooms: string[];
+}
+/**
+ * Create a test user with automatic socket connection
+ *
+ * @param serverUrl - Chat server URL
+ * @param userId - User ID (optional, generated if not provided)
+ * @param userName - User name
+ * @returns Test user object with socket connection
+ */
+export declare function createTestUser(serverUrl: string, userName: string, userId?: string): TestUser;
+/**
+ * Create multiple test users for testing
+ *
+ * @param serverUrl - Chat server URL
+ * @param userNames - Array of user names
+ * @returns Array of test users
+ */
+export declare function createTestUsers(serverUrl: string, userNames: string[]): TestUser[];
+/**
+ * Create a test room between users
+ *
+ * @param users - Users to add to the room
+ * @param roomName - Room name
+ * @param isDirect - Whether this is a direct chat
+ * @returns Promise resolving to the created room
+ */
+export declare function createTestRoom(users: TestUser[], roomName: string, isDirect?: boolean): Promise<any>;
+/**
+ * Send a message from one user to another
+ *
+ * @param from - Sending user
+ * @param roomId - Room ID
+ * @param content - Message content
+ * @returns Promise resolving when message is sent
+ */
+export declare function sendMessage(from: TestUser, roomId: string, content: string): Promise<any>;
+/**
+ * Start an audio call
+ *
+ * @param from - Initiating user
+ * @param to - Target user
+ * @param roomId - Room ID
+ * @returns Promise resolving when call is initiated
+ */
+export declare function startCall(from: TestUser, to: TestUser, roomId: string): Promise<any>;
+/**
+ * Accept an incoming call
+ *
+ * @param to - User accepting call
+ * @param callId - Call ID
+ * @returns Promise resolving when call is accepted
+ */
+export declare function acceptCall(to: TestUser, callId: string): Promise<any>;
+/**
+ * End a call
+ *
+ * @param by - User ending call
+ * @param callId - Call ID
+ * @returns Promise resolving when call is ended
+ */
+export declare function endCall(by: TestUser, callId: string): Promise<any>;
+/**
+ * Listen for socket events (useful for testing)
+ *
+ * @param socket - Socket to listen on
+ * @param event - Event name
+ * @param callback - Callback function
+ * @returns Cleanup function to remove listener
+ */
+export declare function onSocketEvent(socket: Socket, event: string, callback: (data: any) => void): () => void;
+/**
+ * Listen to custom socket events (exposed by ChatProvider)
+ *
+ * @param eventName - Event name to listen to
+ * @param callback - Callback function
+ * @returns Cleanup function
+ */
+export declare function onCustomSocketEvent(eventName: string, callback: (data: any) => void): () => void;
+/**
+ * Emit custom event through the socket
+ *
+ * @param user - User to emit from
+ * @param event - Event name
+ * @param data - Event data
+ * @returns Promise resolving when event is sent
+ */
+export declare function emitCustomEvent(user: TestUser, event: string, data?: any): Promise<any>;

package/dist/utils/testUtils.js

@@ -0,0 +1,153 @@
+import io from 'socket.io-client';
+/**
+ * Create a test user with automatic socket connection
+ *
+ * @param serverUrl - Chat server URL
+ * @param userId - User ID (optional, generated if not provided)
+ * @param userName - User name
+ * @returns Test user object with socket connection
+ */
+export function createTestUser(serverUrl, userName, userId) {
+    const id = userId || `user_${Math.random().toString(36).substr(2, 9)}`;
+    const socket = io(`${serverUrl}/chat`, {
+        auth: { userId: id, userName, tenantId: id },
+        transports: ['websocket'],
+    });
+    return {
+        id,
+        name: userName,
+        socket,
+        rooms: [],
+    };
+}
+/**
+ * Create multiple test users for testing
+ *
+ * @param serverUrl - Chat server URL
+ * @param userNames - Array of user names
+ * @returns Array of test users
+ */
+export function createTestUsers(serverUrl, userNames) {
+    return userNames.map((name, index) => {
+        const userId = `test_user_${String(index + 1).padStart(2, '0')}`;
+        return createTestUser(serverUrl, name, userId);
+    });
+}
+/**
+ * Create a test room between users
+ *
+ * @param users - Users to add to the room
+ * @param roomName - Room name
+ * @param isDirect - Whether this is a direct chat
+ * @returns Promise resolving to the created room
+ */
+export async function createTestRoom(users, roomName, isDirect = false) {
+    const roomId = `room_${Date.now()}`;
+    if (isDirect && users.length !== 2) {
+        throw new Error('Direct rooms require exactly 2 users');
+    }
+    // Create room (first user creates it)
+    await users[0].socket.emitWithAck('room:create', {
+        name: roomName,
+        type: isDirect ? 'direct' : 'group',
+        members: users.map(u => u.id),
+    });
+    // Wait a bit for room to propagate
+    await new Promise(resolve => setTimeout(resolve, 100));
+    // Join all users to the room
+    for (const user of users) {
+        await user.socket.emitWithAck('join', { roomId: roomId });
+        user.rooms.push(roomId);
+    }
+    return { id: roomId, name: roomName, type: isDirect ? 'direct' : 'group' };
+}
+/**
+ * Send a message from one user to another
+ *
+ * @param from - Sending user
+ * @param roomId - Room ID
+ * @param content - Message content
+ * @returns Promise resolving when message is sent
+ */
+export async function sendMessage(from, roomId, content) {
+    return from.socket.emitWithAck('message:send', {
+        roomId,
+        content,
+    });
+}
+/**
+ * Start an audio call
+ *
+ * @param from - Initiating user
+ * @param to - Target user
+ * @param roomId - Room ID
+ * @returns Promise resolving when call is initiated
+ */
+export async function startCall(from, to, roomId) {
+    return from.socket.emitWithAck('call:initiate', {
+        roomId,
+        participantId: to.id,
+    });
+}
+/**
+ * Accept an incoming call
+ *
+ * @param to - User accepting call
+ * @param callId - Call ID
+ * @returns Promise resolving when call is accepted
+ */
+export async function acceptCall(to, callId) {
+    return to.socket.emitWithAck('call:accept', { callId });
+}
+/**
+ * End a call
+ *
+ * @param by - User ending call
+ * @param callId - Call ID
+ * @returns Promise resolving when call is ended
+ */
+export async function endCall(by, callId) {
+    return by.socket.emitWithAck('call:end', { callId });
+}
+/**
+ * Listen for socket events (useful for testing)
+ *
+ * @param socket - Socket to listen on
+ * @param event - Event name
+ * @param callback - Callback function
+ * @returns Cleanup function to remove listener
+ */
+export function onSocketEvent(socket, event, callback) {
+    socket.on(event, callback);
+    return () => socket.off(event, callback);
+}
+/**
+ * Listen to custom socket events (exposed by ChatProvider)
+ *
+ * @param eventName - Event name to listen to
+ * @param callback - Callback function
+ * @returns Cleanup function
+ */
+export function onCustomSocketEvent(eventName, callback) {
+    const handler = (event) => {
+        if (event.detail.event === eventName) {
+            callback(event.detail.data);
+        }
+    };
+    window.addEventListener('chat:socket-event', handler);
+    return () => window.removeEventListener('chat:socket-event', handler);
+}
+/**
+ * Emit custom event through the socket
+ *
+ * @param user - User to emit from
+ * @param event - Event name
+ * @param data - Event data
+ * @returns Promise resolving when event is sent
+ */
+export function emitCustomEvent(user, event, data) {
+    if (user.socket.connected) {
+        return user.socket.emitWithAck(event, data);
+    }
+    return Promise.reject('Socket not connected');
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@enfin/chat",
+  "version": "1.2.0",
+  "description": "React frontend SDK for chat platform",
+  "main": "dist/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./styles.css": "./dist/style.css"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.json --module esnext --outDir dist/esm && node -e \"const fs=require('fs');fs.copyFileSync('src/styles.css','dist/style.css');fs.cpSync('public','dist/public',{recursive:true});fs.cpSync('src/assets','dist/assets',{recursive:true});\"",
+    "prepublishOnly": "npm run build",
+    "dev": "tsc --watch",
+    "test": "jest"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "socket.io-client": "^4.6.0"
+  },
+  "dependencies": {
+    "@enfin/chat-shared": "^1.0.0",
+    "socket.io-client": "^4.6.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "style": "src/styles.css"
+}