@cemscale-voip/voip-sdk 1.0.0

package/dist/client.js

@@ -0,0 +1,651 @@
+// ============================================================
+// @cemscale/voip-sdk — API Client (HTTP + WebSocket)
+// ============================================================
+// --- HTTP Transport ---
+class HttpError extends Error {
+    status;
+    statusText;
+    body;
+    constructor(status, statusText, body) {
+        super(`HTTP ${status}: ${typeof body === 'object' && body && 'error' in body ? body.error : statusText}`);
+        this.status = status;
+        this.statusText = statusText;
+        this.body = body;
+        this.name = 'HttpError';
+    }
+}
+export { HttpError };
+// --- VoIPClient ---
+export class VoIPClient {
+    apiUrl;
+    token;
+    tenantId;
+    timeout;
+    // WebSocket
+    ws = null;
+    wsReconnectTimer = null;
+    wsListeners = new Map();
+    wsPingInterval = null;
+    wsConnected = false;
+    constructor(config) {
+        this.apiUrl = config.apiUrl.replace(/\/+$/, '');
+        this.token = config.token ?? null;
+        this.tenantId = config.tenantId ?? null;
+        this.timeout = config.timeout ?? 15000;
+    }
+    // -------------------------------------------------------------------
+    // Token management
+    // -------------------------------------------------------------------
+    setToken(token) { this.token = token; }
+    getToken() { return this.token; }
+    setTenantId(tenantId) { this.tenantId = tenantId; }
+    getTenantId() { return this.tenantId; }
+    // -------------------------------------------------------------------
+    // HTTP helpers
+    // -------------------------------------------------------------------
+    async request(method, path, body, query) {
+        let url = `${this.apiUrl}${path}`;
+        if (query) {
+            const params = new URLSearchParams();
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined)
+                    params.set(key, String(value));
+            }
+            const qs = params.toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const headers = {};
+        if (this.token)
+            headers['Authorization'] = `Bearer ${this.token}`;
+        if (this.tenantId && this.tenantId !== 'all')
+            headers['X-Tenant-ID'] = this.tenantId;
+        // Only set Content-Type when there's a body
+        if (body != null)
+            headers['Content-Type'] = 'application/json';
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body != null ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            if (response.status === 204)
+                return {};
+            const contentType = response.headers.get('content-type') || '';
+            const data = contentType.includes('application/json')
+                ? await response.json()
+                : await response.text();
+            if (!response.ok)
+                throw new HttpError(response.status, response.statusText, data);
+            return data;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    // -------------------------------------------------------------------
+    // Auth
+    // -------------------------------------------------------------------
+    /** Login as an extension user */
+    async login(params) {
+        const result = await this.request('POST', '/api/auth/login', params);
+        this.token = result.token;
+        this.tenantId = params.tenantId;
+        return result;
+    }
+    /** Login as a tenant admin */
+    async adminLogin(params) {
+        const result = await this.request('POST', '/api/auth/admin-login', params);
+        this.token = result.token;
+        if (result.tenant)
+            this.tenantId = result.tenant.id;
+        return result;
+    }
+    /** Login as platform superadmin */
+    async superadminLogin(params) {
+        const result = await this.request('POST', '/api/auth/superadmin-login', params);
+        this.token = result.token;
+        return result;
+    }
+    /** Get current user info */
+    async me() {
+        return this.request('GET', '/api/auth/me');
+    }
+    /** Get TURN credentials for WebRTC */
+    async getTurnCredentials() {
+        return this.request('GET', '/api/auth/turn-credentials');
+    }
+    // -------------------------------------------------------------------
+    // Calls (CDR)
+    // -------------------------------------------------------------------
+    /** List call records with pagination and filters */
+    async listCalls(params) {
+        return this.request('GET', '/api/calls', undefined, params);
+    }
+    /** Get a single call record */
+    async getCall(id) {
+        return this.request('GET', `/api/calls/${id}`);
+    }
+    /** Originate a call via FreeSWITCH */
+    async originate(params) {
+        return this.request('POST', '/api/calls/originate', params);
+    }
+    /** Hang up an active call */
+    async hangup(uuid) {
+        return this.request('POST', `/api/calls/${uuid}/hangup`);
+    }
+    /** Transfer an active call (blind or attended) */
+    async transfer(uuid, params) {
+        return this.request('POST', `/api/calls/${uuid}/transfer`, params);
+    }
+    /** List active calls from FreeSWITCH */
+    async getActiveCalls() {
+        return this.request('GET', '/api/calls/active');
+    }
+    /** Get call statistics for a period */
+    async getCallStats(period) {
+        return this.request('GET', '/api/calls/stats', undefined, period ? { period } : undefined);
+    }
+    /** Place a call on hold or resume */
+    async holdCall(uuid, hold = true) {
+        return this.request('POST', `/api/calls/${uuid}/hold`, { hold });
+    }
+    /** Park an active call */
+    async parkCall(uuid, slot) {
+        return this.request('POST', `/api/calls/${uuid}/park`, slot ? { slot } : undefined);
+    }
+    /** List parked calls */
+    async getParkedCalls() {
+        return this.request('GET', '/api/calls/parked');
+    }
+    /** Export CDR as CSV. Returns raw CSV text. */
+    async exportCalls(params) {
+        return this.request('GET', '/api/calls/export', undefined, params);
+    }
+    // -------------------------------------------------------------------
+    // Extensions
+    // -------------------------------------------------------------------
+    /** List extensions for the current tenant */
+    async listExtensions() {
+        return this.request('GET', '/api/extensions');
+    }
+    /** Get a single extension */
+    async getExtension(id) {
+        return this.request('GET', `/api/extensions/${id}`);
+    }
+    /** Create an extension (also creates Kamailio subscriber) */
+    async createExtension(params) {
+        return this.request('POST', '/api/extensions', params);
+    }
+    /** Update an extension */
+    async updateExtension(id, params) {
+        return this.request('PUT', `/api/extensions/${id}`, params);
+    }
+    /** Delete an extension */
+    async deleteExtension(id) {
+        return this.request('DELETE', `/api/extensions/${id}`);
+    }
+    /** Get call forward settings for an extension */
+    async getCallForward(extensionId) {
+        return this.request('GET', `/api/extensions/${extensionId}/forward`);
+    }
+    /** Set call forward for an extension */
+    async setCallForward(extensionId, params) {
+        return this.request('PUT', `/api/extensions/${extensionId}/forward`, params);
+    }
+    /** Lookup extension by CRM user ID */
+    async getExtensionByCrmUser(crmUserId) {
+        return this.request('GET', `/api/extensions/by-crm-user/${crmUserId}`);
+    }
+    /** Update CRM mapping for an extension */
+    async updateCrmMapping(extensionId, params) {
+        return this.request('PUT', `/api/extensions/${extensionId}/crm-mapping`, params);
+    }
+    // -------------------------------------------------------------------
+    // Tenants (superadmin)
+    // -------------------------------------------------------------------
+    /** List all tenants (superadmin only) */
+    async listTenants() {
+        return this.request('GET', '/api/tenants');
+    }
+    /** Get a single tenant */
+    async getTenant(id) {
+        return this.request('GET', `/api/tenants/${id}`);
+    }
+    /** Create a tenant (superadmin only) */
+    async createTenant(params) {
+        return this.request('POST', '/api/tenants', params);
+    }
+    /** Update a tenant (superadmin only) */
+    async updateTenant(id, params) {
+        return this.request('PUT', `/api/tenants/${id}`, params);
+    }
+    /** Delete a tenant and all data (superadmin only) */
+    async deleteTenant(id) {
+        return this.request('DELETE', `/api/tenants/${id}`);
+    }
+    /** Get tenant statistics */
+    async getTenantStats(id) {
+        return this.request('GET', `/api/tenants/${id}/stats`);
+    }
+    // -------------------------------------------------------------------
+    // DIDs
+    // -------------------------------------------------------------------
+    /** List DID numbers */
+    async listDids() {
+        return this.request('GET', '/api/dids');
+    }
+    /** Create a DID */
+    async createDid(params) {
+        return this.request('POST', '/api/dids', params);
+    }
+    /** Update a DID */
+    async updateDid(id, params) {
+        return this.request('PUT', `/api/dids/${id}`, params);
+    }
+    /** Delete a DID */
+    async deleteDid(id) {
+        return this.request('DELETE', `/api/dids/${id}`);
+    }
+    // -------------------------------------------------------------------
+    // IVR
+    // -------------------------------------------------------------------
+    /** List IVR menus */
+    async listIvrMenus() {
+        return this.request('GET', '/api/ivr');
+    }
+    /** Get a single IVR menu */
+    async getIvrMenu(id) {
+        return this.request('GET', `/api/ivr/${id}`);
+    }
+    /** Create an IVR menu */
+    async createIvrMenu(params) {
+        return this.request('POST', '/api/ivr', params);
+    }
+    /** Update an IVR menu */
+    async updateIvrMenu(id, params) {
+        return this.request('PUT', `/api/ivr/${id}`, params);
+    }
+    /** Delete an IVR menu */
+    async deleteIvrMenu(id) {
+        return this.request('DELETE', `/api/ivr/${id}`);
+    }
+    // -------------------------------------------------------------------
+    // Recordings
+    // -------------------------------------------------------------------
+    /** List recordings with pagination */
+    async listRecordings(params) {
+        return this.request('GET', '/api/recordings', undefined, params);
+    }
+    /** Get a presigned download URL for a recording */
+    async getRecordingUrl(id) {
+        return this.request('GET', `/api/recordings/${id}/url`);
+    }
+    /** Delete a recording */
+    async deleteRecording(id) {
+        return this.request('DELETE', `/api/recordings/${id}`);
+    }
+    // -------------------------------------------------------------------
+    // Conferences
+    // -------------------------------------------------------------------
+    /** List active conferences */
+    async listConferences() {
+        return this.request('GET', '/api/conferences');
+    }
+    /** Get conference details */
+    async getConference(name) {
+        return this.request('GET', `/api/conferences/${name}`);
+    }
+    /** Join a call to a conference */
+    async joinConference(conferenceName, callUuid) {
+        return this.request('POST', `/api/conferences/${conferenceName}/join`, { callUuid });
+    }
+    /** Transfer a call to conference */
+    async transferToConference(uuid, conferenceName) {
+        return this.request('POST', `/api/calls/${uuid}/conference`, conferenceName ? { conferenceName } : undefined);
+    }
+    /** Kick a member from conference */
+    async kickFromConference(conferenceName, memberId) {
+        return this.request('POST', `/api/conferences/${conferenceName}/kick`, { memberId });
+    }
+    /** Mute/unmute a conference member */
+    async muteConferenceMember(conferenceName, memberId, mute = true) {
+        return this.request('POST', `/api/conferences/${conferenceName}/mute`, { memberId, mute });
+    }
+    /** Deaf/undeaf a conference member */
+    async deafConferenceMember(conferenceName, memberId, deaf = true) {
+        return this.request('POST', `/api/conferences/${conferenceName}/deaf`, { memberId, deaf });
+    }
+    /** Lock/unlock a conference */
+    async lockConference(conferenceName, lock = true) {
+        return this.request('POST', `/api/conferences/${conferenceName}/lock`, { lock });
+    }
+    /** Start/stop conference recording */
+    async recordConference(conferenceName, action) {
+        return this.request('POST', `/api/conferences/${conferenceName}/record`, { action });
+    }
+    // -------------------------------------------------------------------
+    // Ring Groups
+    // -------------------------------------------------------------------
+    /** List ring groups */
+    async listRingGroups() {
+        return this.request('GET', '/api/ring-groups');
+    }
+    /** Get a ring group */
+    async getRingGroup(id) {
+        return this.request('GET', `/api/ring-groups/${id}`);
+    }
+    /** Create a ring group */
+    async createRingGroup(params) {
+        return this.request('POST', '/api/ring-groups', params);
+    }
+    /** Update a ring group */
+    async updateRingGroup(id, params) {
+        return this.request('PUT', `/api/ring-groups/${id}`, params);
+    }
+    /** Delete a ring group */
+    async deleteRingGroup(id) {
+        return this.request('DELETE', `/api/ring-groups/${id}`);
+    }
+    // -------------------------------------------------------------------
+    // Call Queues
+    // -------------------------------------------------------------------
+    /** List call queues */
+    async listQueues() {
+        return this.request('GET', '/api/queues');
+    }
+    /** Get a call queue */
+    async getQueue(id) {
+        return this.request('GET', `/api/queues/${id}`);
+    }
+    /** Create a call queue */
+    async createQueue(params) {
+        return this.request('POST', '/api/queues', params);
+    }
+    /** Update a call queue */
+    async updateQueue(id, params) {
+        return this.request('PUT', `/api/queues/${id}`, params);
+    }
+    /** Delete a call queue */
+    async deleteQueue(id) {
+        return this.request('DELETE', `/api/queues/${id}`);
+    }
+    /** Pause/unpause a queue agent */
+    async pauseQueueAgent(queueId, agentId, paused = true) {
+        return this.request('POST', `/api/queues/${queueId}/agents/${agentId}/pause`, { paused });
+    }
+    /** Login/logout a queue agent */
+    async loginQueueAgent(queueId, agentId, loggedIn = true) {
+        return this.request('POST', `/api/queues/${queueId}/agents/${agentId}/login`, { loggedIn });
+    }
+    /** Get real-time queue statistics (agent counts, today's call metrics) */
+    async getQueueStats(queueId) {
+        return this.request('GET', `/api/queues/${queueId}/stats`);
+    }
+    // -------------------------------------------------------------------
+    // Webhooks
+    // -------------------------------------------------------------------
+    /** List webhooks */
+    async listWebhooks() {
+        return this.request('GET', '/api/webhooks');
+    }
+    /** Get webhook details with recent deliveries */
+    async getWebhook(id) {
+        return this.request('GET', `/api/webhooks/${id}`);
+    }
+    /** Create a webhook */
+    async createWebhook(params) {
+        return this.request('POST', '/api/webhooks', params);
+    }
+    /** Update a webhook */
+    async updateWebhook(id, params) {
+        return this.request('PUT', `/api/webhooks/${id}`, params);
+    }
+    /** Delete a webhook */
+    async deleteWebhook(id) {
+        return this.request('DELETE', `/api/webhooks/${id}`);
+    }
+    /** Send a test webhook event */
+    async testWebhook(id) {
+        return this.request('POST', `/api/webhooks/${id}/test`);
+    }
+    /** List webhook delivery history */
+    async listWebhookDeliveries(id, page, limit) {
+        return this.request('GET', `/api/webhooks/${id}/deliveries`, undefined, { page, limit });
+    }
+    // -------------------------------------------------------------------
+    // Voicemail
+    // -------------------------------------------------------------------
+    /** List voicemail messages with pagination */
+    async listVoicemails(params) {
+        return this.request('GET', '/api/voicemail', undefined, params);
+    }
+    /** Get voicemail count (total and unread) */
+    async getVoicemailCount(extension) {
+        return this.request('GET', '/api/voicemail/count', undefined, extension ? { extension } : undefined);
+    }
+    /** Get a single voicemail */
+    async getVoicemail(id) {
+        return this.request('GET', `/api/voicemail/${id}`);
+    }
+    /** Get voicemail audio URL (presigned S3 or direct) */
+    async getVoicemailAudioUrl(id) {
+        return this.request('GET', `/api/voicemail/${id}/audio`);
+    }
+    /** Mark voicemail as read */
+    async markVoicemailRead(id) {
+        return this.request('PUT', `/api/voicemail/${id}/read`);
+    }
+    /** Delete a voicemail */
+    async deleteVoicemail(id) {
+        return this.request('DELETE', `/api/voicemail/${id}`);
+    }
+    /** Bulk delete voicemails */
+    async bulkDeleteVoicemails(params) {
+        return this.request('DELETE', '/api/voicemail', params);
+    }
+    // -------------------------------------------------------------------
+    // Presence (REST)
+    // -------------------------------------------------------------------
+    /** Get simple presence (extension -> status) */
+    async getPresence() {
+        return this.request('GET', '/api/presence');
+    }
+    /** Get detailed presence with call info */
+    async getPresenceDetailed() {
+        return this.request('GET', '/api/presence/detailed');
+    }
+    // -------------------------------------------------------------------
+    // Reports
+    // -------------------------------------------------------------------
+    /** Get dashboard summary stats */
+    async getDashboardStats() {
+        return this.request('GET', '/api/reports/dashboard');
+    }
+    /** Get calls grouped by day */
+    async getCallsByDay(days) {
+        return this.request('GET', '/api/reports/calls-by-day', undefined, days ? { days } : undefined);
+    }
+    /** Get top extensions by call volume */
+    async getTopExtensions(days, limit) {
+        return this.request('GET', '/api/reports/top-extensions', undefined, { days, limit });
+    }
+    // -------------------------------------------------------------------
+    // Blocklist (Call Blocking)
+    // -------------------------------------------------------------------
+    /** List all blocked numbers for the tenant */
+    async listBlockedNumbers() {
+        return this.request('GET', '/api/blocklist');
+    }
+    /** Block a phone number */
+    async blockNumber(params) {
+        return this.request('POST', '/api/blocklist', params);
+    }
+    /** Unblock a phone number by ID */
+    async unblockNumber(id) {
+        return this.request('DELETE', `/api/blocklist/${id}`);
+    }
+    /** Check if a specific number is blocked */
+    async checkBlocked(number) {
+        return this.request('GET', `/api/blocklist/check/${encodeURIComponent(number)}`);
+    }
+    // -------------------------------------------------------------------
+    // Business Hours / Schedules
+    // -------------------------------------------------------------------
+    /** List business hour schedules */
+    async listSchedules() {
+        return this.request('GET', '/api/schedules');
+    }
+    /** Get a single schedule */
+    async getSchedule(id) {
+        return this.request('GET', `/api/schedules/${id}`);
+    }
+    /** Create a business hours schedule */
+    async createSchedule(params) {
+        return this.request('POST', '/api/schedules', params);
+    }
+    /** Update a business hours schedule */
+    async updateSchedule(id, params) {
+        return this.request('PUT', `/api/schedules/${id}`, params);
+    }
+    /** Delete a business hours schedule */
+    async deleteSchedule(id) {
+        return this.request('DELETE', `/api/schedules/${id}`);
+    }
+    /** Check if a schedule is currently open or closed */
+    async getScheduleStatus(id) {
+        return this.request('GET', `/api/schedules/${id}/status`);
+    }
+    // -------------------------------------------------------------------
+    // SIP Trunks
+    // -------------------------------------------------------------------
+    /** List SIP trunks (passwords masked) */
+    async listTrunks() {
+        return this.request('GET', '/api/trunks');
+    }
+    /** Get a single SIP trunk (password masked) */
+    async getTrunk(id) {
+        return this.request('GET', `/api/trunks/${id}`);
+    }
+    /** Create a SIP trunk */
+    async createTrunk(params) {
+        return this.request('POST', '/api/trunks', params);
+    }
+    /** Update a SIP trunk */
+    async updateTrunk(id, params) {
+        return this.request('PUT', `/api/trunks/${id}`, params);
+    }
+    /** Delete a SIP trunk */
+    async deleteTrunk(id) {
+        return this.request('DELETE', `/api/trunks/${id}`);
+    }
+    // -------------------------------------------------------------------
+    // WebSocket — real-time events
+    // -------------------------------------------------------------------
+    /** Connect to the real-time WebSocket */
+    connectWebSocket() {
+        if (this.ws && (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING)) {
+            return;
+        }
+        const wsUrl = this.apiUrl.replace(/^http/, 'ws') + '/api/ws';
+        this.ws = new WebSocket(wsUrl);
+        this.ws.onopen = () => {
+            if (this.token) {
+                this.ws.send(JSON.stringify({ type: 'auth', token: this.token }));
+            }
+            this.wsPingInterval = setInterval(() => {
+                if (this.ws?.readyState === WebSocket.OPEN) {
+                    this.ws.send(JSON.stringify({ type: 'ping' }));
+                }
+            }, 30000);
+        };
+        this.ws.onmessage = (event) => {
+            try {
+                const message = JSON.parse(event.data);
+                if (message.type === 'auth_success')
+                    this.wsConnected = true;
+                this.emitWs(message.type, message);
+                this.emitWs('*', message);
+            }
+            catch {
+                // Ignore malformed messages
+            }
+        };
+        this.ws.onclose = () => {
+            this.wsConnected = false;
+            this.clearWsPing();
+            this.emitWs('disconnected', undefined);
+            this.scheduleWsReconnect();
+        };
+        this.ws.onerror = () => {
+            // onclose will fire after onerror
+        };
+    }
+    /** Disconnect the WebSocket */
+    disconnectWebSocket() {
+        this.clearWsReconnect();
+        this.clearWsPing();
+        if (this.ws) {
+            this.ws.onclose = null;
+            this.ws.close();
+            this.ws = null;
+        }
+        this.wsConnected = false;
+    }
+    /** Check if WebSocket is connected and authenticated */
+    isWebSocketConnected() {
+        return this.wsConnected;
+    }
+    /** Subscribe to a WebSocket event type. Returns unsubscribe function. */
+    onWsEvent(eventType, callback) {
+        if (!this.wsListeners.has(eventType)) {
+            this.wsListeners.set(eventType, new Set());
+        }
+        this.wsListeners.get(eventType).add(callback);
+        return () => { this.wsListeners.get(eventType)?.delete(callback); };
+    }
+    emitWs(eventType, data) {
+        const listeners = this.wsListeners.get(eventType);
+        if (listeners) {
+            for (const listener of listeners) {
+                try {
+                    listener(data);
+                }
+                catch { /* Don't let one bad listener break others */ }
+            }
+        }
+    }
+    scheduleWsReconnect() {
+        if (this.wsReconnectTimer)
+            return;
+        this.wsReconnectTimer = setTimeout(() => {
+            this.wsReconnectTimer = null;
+            this.connectWebSocket();
+        }, 3000);
+    }
+    clearWsReconnect() {
+        if (this.wsReconnectTimer) {
+            clearTimeout(this.wsReconnectTimer);
+            this.wsReconnectTimer = null;
+        }
+    }
+    clearWsPing() {
+        if (this.wsPingInterval) {
+            clearInterval(this.wsPingInterval);
+            this.wsPingInterval = null;
+        }
+    }
+    // -------------------------------------------------------------------
+    // Cleanup
+    // -------------------------------------------------------------------
+    /** Disconnect all connections and clean up */
+    destroy() {
+        this.disconnectWebSocket();
+        this.token = null;
+        this.tenantId = null;
+    }
+}
+//# sourceMappingURL=client.js.map