@cemscale-voip/voip-sdk 1.25.1 → 1.25.2

package/dist/client.js

@@ -0,0 +1,1015 @@
+// ============================================================
+// @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;
+    apiKey;
+    tenantId;
+    timeout;
+    // WebSocket
+    ws = null;
+    wsReconnectTimer = null;
+    wsReconnectAttempts = 0;
+    WS_MAX_RECONNECT = 10;
+    wsListeners = new Map();
+    wsPingInterval = null;
+    wsConnected = false;
+    constructor(config) {
+        this.apiUrl = config.apiUrl.replace(/\/+$/, '');
+        this.token = config.token ?? null;
+        this.apiKey = config.apiKey ?? null;
+        this.tenantId = config.tenantId ?? null;
+        this.timeout = config.timeout ?? 15000;
+    }
+    // -------------------------------------------------------------------
+    // Credential management
+    // -------------------------------------------------------------------
+    /** Set or change the API key at runtime */
+    setApiKey(apiKey) { this.apiKey = apiKey; }
+    /** Get the current API key */
+    getApiKey() { return this.apiKey; }
+    /** Set JWT token (only for browser login flows — most apps should use apiKey) */
+    setToken(token) { this.token = token; }
+    /** Get current JWT token */
+    getToken() { return this.token; }
+    /** Set tenant ID (only used by superadmin) */
+    setTenantId(tenantId) { this.tenantId = tenantId; }
+    getTenantId() { return this.tenantId; }
+    // -------------------------------------------------------------------
+    // HTTP helpers
+    // -------------------------------------------------------------------
+    async request(method, path, body, query, options) {
+        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.apiKey) {
+            headers['X-API-Key'] = this.apiKey;
+        }
+        else if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        // Per-request tenantId takes priority over client-level tenantId
+        const effectiveTenantId = options?.tenantId ?? this.tenantId;
+        if (effectiveTenantId && effectiveTenantId !== 'all')
+            headers['X-Tenant-ID'] = effectiveTenantId;
+        // 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. Pass `options.tenantId` when using a global superadmin key. */
+    async originate(params, options) {
+        return this.request('POST', '/api/calls/originate', params, undefined, options);
+    }
+    /** 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). Pass `options.tenantId` when using a global superadmin key. */
+    async createExtension(params, options) {
+        return this.request('POST', '/api/extensions', params, undefined, options);
+    }
+    /** 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);
+    }
+    /**
+     * Get SIP credentials for connecting a WebRTC softphone.
+     * Returns everything needed to register: extension, password, SIP domain, WebSocket URI.
+     * Use this so your app never needs to store SIP passwords.
+     *
+     * @example
+     * const { sipCredentials } = await voip.getSipCredentials('extension-uuid');
+     * // Use with WebRTCPhone or useVoIP hook
+     */
+    async getSipCredentials(extensionId) {
+        return this.request('GET', `/api/extensions/${extensionId}/sip-credentials`);
+    }
+    /**
+     * Get SIP credentials by extension number (e.g. "1001") instead of UUID.
+     * Same as getSipCredentials() but looks up by number.
+     *
+     * @example
+     * const { sipCredentials } = await voip.getSipCredentialsByNumber('1001');
+     */
+    async getSipCredentialsByNumber(extensionNumber) {
+        return this.request('GET', `/api/extensions/by-number/${extensionNumber}/sip-credentials`);
+    }
+    // -------------------------------------------------------------------
+    // 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 associated data (superadmin only).
+     *
+     * Performs a complete, immediate cleanup:
+     * - Database: tenant, extensions, DIDs, subscribers, locations, call records,
+     *   voicemails, IVR menus, ring groups, queues, webhooks, schedules, API keys
+     * - FreeSWITCH: removes all tenant-owned SIP trunk gateways
+     * - Active calls: hangs up any in-progress calls belonging to this tenant
+     * - Kamailio: flushes in-memory SIP registrations so softphones are
+     *   immediately disconnected (cannot place calls after deletion)
+     * - Audio files: recordings, voicemail messages, IVR greetings, voicemail greetings
+     * - Redis: presence keys
+     *
+     * This is irreversible. Call with care.
+     *
+     * @param id - Tenant UUID
+     */
+    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. Pass `options.tenantId` when using a global superadmin key. */
+    async createDid(params, options) {
+        return this.request('POST', '/api/dids', params, undefined, options);
+    }
+    /** Get a single DID by ID */
+    async getDid(id) {
+        return this.request('GET', `/api/dids/${id}`);
+    }
+    /** 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. Pass `options.tenantId` when using a global superadmin key. */
+    async createIvrMenu(params, options) {
+        return this.request('POST', '/api/ivr', params, undefined, options);
+    }
+    /** Update an IVR menu */
+    async updateIvrMenu(id, params) {
+        return this.request('PUT', `/api/ivr/${id}`, params);
+    }
+    /** Delete an IVR menu and its audio files */
+    async deleteIvrMenu(id) {
+        return this.request('DELETE', `/api/ivr/${id}`);
+    }
+    /**
+     * Upload a greeting audio file for an IVR menu.
+     * The file is automatically converted to WAV 8kHz mono (FreeSWITCH format).
+     * Accepts WAV, MP3, OGG, M4A.
+     *
+     * @param id - IVR menu ID
+     * @param file - File blob or Buffer
+     * @param filename - Original filename (e.g. "greeting.mp3")
+     */
+    async uploadIvrAudio(id, file, filename) {
+        const formData = new FormData();
+        const blob = file instanceof Blob ? file : new Blob([new Uint8Array(file)]);
+        formData.append('file', blob, filename);
+        const headers = {};
+        if (this.apiKey) {
+            headers['X-API-Key'] = this.apiKey;
+        }
+        else if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        if (this.tenantId && this.tenantId !== 'all')
+            headers['X-Tenant-ID'] = this.tenantId;
+        const response = await fetch(`${this.apiUrl}/api/ivr/${id}/audio`, {
+            method: 'POST',
+            headers,
+            body: formData,
+        });
+        if (!response.ok) {
+            const err = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(err.error || `Upload failed: ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Upload a custom "invalid input" audio file for an IVR menu.
+     * Played when the caller presses an invalid digit.
+     */
+    async uploadIvrInvalidAudio(id, file, filename) {
+        const formData = new FormData();
+        const blob = file instanceof Blob ? file : new Blob([new Uint8Array(file)]);
+        formData.append('file', blob, filename);
+        const headers = {};
+        if (this.apiKey) {
+            headers['X-API-Key'] = this.apiKey;
+        }
+        else if (this.token) {
+            headers['Authorization'] = `Bearer ${this.token}`;
+        }
+        if (this.tenantId && this.tenantId !== 'all')
+            headers['X-Tenant-ID'] = this.tenantId;
+        const response = await fetch(`${this.apiUrl}/api/ivr/${id}/invalid-audio`, {
+            method: 'POST',
+            headers,
+            body: formData,
+        });
+        if (!response.ok) {
+            const err = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(err.error || `Upload failed: ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Get the greeting audio file URL for streaming/download.
+     * The URL includes the API key as a query parameter so it can be used
+     * directly in HTML <audio src="..."> elements without custom headers.
+     */
+    getIvrAudioUrl(id) {
+        const base = `${this.apiUrl}/api/ivr/${id}/audio`;
+        return this.apiKey ? `${base}?apiKey=${encodeURIComponent(this.apiKey)}` : base;
+    }
+    /**
+     * Get the invalid input audio file URL for streaming/download.
+     * The URL includes the API key as a query parameter.
+     */
+    getIvrInvalidAudioUrl(id) {
+        const base = `${this.apiUrl}/api/ivr/${id}/invalid-audio`;
+        return this.apiKey ? `${base}?apiKey=${encodeURIComponent(this.apiKey)}` : base;
+    }
+    /**
+     * Download the greeting audio as a Blob (for programmatic use).
+     * Use getIvrAudioUrl() for direct browser playback via <audio> tags.
+     */
+    async downloadIvrAudio(id) {
+        const headers = {};
+        if (this.apiKey)
+            headers['X-API-Key'] = this.apiKey;
+        else if (this.token)
+            headers['Authorization'] = `Bearer ${this.token}`;
+        const response = await fetch(`${this.apiUrl}/api/ivr/${id}/audio`, { headers });
+        if (!response.ok) {
+            const err = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(err.error || `Download failed: ${response.status}`);
+        }
+        return response.blob();
+    }
+    /**
+     * Download the invalid input audio as a Blob (for programmatic use).
+     */
+    async downloadIvrInvalidAudio(id) {
+        const headers = {};
+        if (this.apiKey)
+            headers['X-API-Key'] = this.apiKey;
+        else if (this.token)
+            headers['Authorization'] = `Bearer ${this.token}`;
+        const response = await fetch(`${this.apiUrl}/api/ivr/${id}/invalid-audio`, { headers });
+        if (!response.ok) {
+            const err = await response.json().catch(() => ({ error: response.statusText }));
+            throw new Error(err.error || `Download failed: ${response.status}`);
+        }
+        return response.blob();
+    }
+    /** Delete the greeting audio file (reverts to generic prompts) */
+    async deleteIvrAudio(id) {
+        return this.request('DELETE', `/api/ivr/${id}/audio`);
+    }
+    /** Delete the invalid input audio file (reverts to default) */
+    async deleteIvrInvalidAudio(id) {
+        return this.request('DELETE', `/api/ivr/${id}/invalid-audio`);
+    }
+    /**
+     * Generate greeting audio via ElevenLabs TTS.
+     * The generated audio is automatically saved as the IVR greeting.
+     */
+    async generateIvrTts(id, params) {
+        return this.request('POST', `/api/ivr/${id}/tts`, params);
+    }
+    /** List available TTS voices for IVR greetings */
+    async listIvrVoices() {
+        return this.request('GET', '/api/ivr/voices');
+    }
+    // -------------------------------------------------------------------
+    // Recordings
+    // -------------------------------------------------------------------
+    /** List recordings with pagination. Each recording includes an audio_url for direct streaming. */
+    async listRecordings(params) {
+        return this.request('GET', '/api/recordings', undefined, params);
+    }
+    /**
+     * Get a direct URL to stream/download a recording.
+     * The URL supports auth via ?apiKey= query param for browser <audio> elements.
+     */
+    async getRecordingUrl(id) {
+        return this.request('GET', `/api/recordings/${id}/url`);
+    }
+    /**
+     * Get the audio streaming URL for a recording, ready for browser playback.
+     * Appends the API key as a query parameter so it works with <audio src="...">.
+     */
+    getRecordingAudioUrl(id) {
+        const base = `${this.apiUrl}/api/recordings/${id}/audio`;
+        return this.apiKey ? `${base}?apiKey=${encodeURIComponent(this.apiKey)}` : base;
+    }
+    /**
+     * Get the download URL for a recording (Content-Disposition: attachment).
+     * Appends the API key as a query parameter.
+     */
+    getRecordingDownloadUrl(id) {
+        const base = `${this.apiUrl}/api/recordings/${id}/download`;
+        return this.apiKey ? `${base}?apiKey=${encodeURIComponent(this.apiKey)}` : base;
+    }
+    /** Delete a recording and its file from the server */
+    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. Pass `options.tenantId` when using a global superadmin key. */
+    async createRingGroup(params, options) {
+        return this.request('POST', '/api/ring-groups', params, undefined, options);
+    }
+    /** 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. Pass `options.tenantId` when using a global superadmin key. */
+    async createQueue(params, options) {
+        return this.request('POST', '/api/queues', params, undefined, options);
+    }
+    /** 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. Pass `options.tenantId` when using a global superadmin key. */
+    async createWebhook(params, options) {
+        return this.request('POST', '/api/webhooks', params, undefined, options);
+    }
+    /** 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}`);
+    }
+    /** Mark voicemail as read */
+    async markVoicemailRead(id) {
+        return this.request('PUT', `/api/voicemail/${id}/read`);
+    }
+    /** Delete a voicemail (hard delete — removes audio file from disk) */
+    async deleteVoicemail(id) {
+        return this.request('DELETE', `/api/voicemail/${id}`);
+    }
+    /** Bulk delete voicemails */
+    async bulkDeleteVoicemails(params) {
+        return this.request('DELETE', '/api/voicemail', params);
+    }
+    /**
+     * Get a direct URL to stream a voicemail's audio in a browser `<audio>` element.
+     * Appends the API key as a query parameter so no custom headers are needed.
+     *
+     * @example
+     * ```html
+     * <audio src={client.getVoicemailAudioUrl(id)} controls />
+     * ```
+     */
+    getVoicemailAudioUrl(id) {
+        const base = `${this.apiUrl}/api/voicemail/${id}/audio`;
+        return this.apiKey ? `${base}?apiKey=${encodeURIComponent(this.apiKey)}` : base;
+    }
+    /**
+     * Get a direct URL to download a voicemail as an attachment.
+     * Appends the API key as a query parameter.
+     */
+    getVoicemailDownloadUrl(id) {
+        const base = `${this.apiUrl}/api/voicemail/${id}/download`;
+        return this.apiKey ? `${base}?apiKey=${encodeURIComponent(this.apiKey)}` : base;
+    }
+    // -------------------------------------------------------------------
+    // Voicemail Greeting
+    // -------------------------------------------------------------------
+    /** Get the current greeting configuration for an extension */
+    async getVoicemailGreeting(extension) {
+        return this.request('GET', '/api/voicemail/greeting', undefined, extension ? { extension } : undefined);
+    }
+    /**
+     * Update the voicemail greeting type and text.
+     *
+     * @example
+     * ```ts
+     * // Use a custom TTS greeting
+     * await client.updateVoicemailGreeting({
+     *   extension: '1001',
+     *   greetingType: 'custom_tts',
+     *   greetingText: 'Hi, you have reached John. I am not available right now. Please leave a message.',
+     * });
+     *
+     * // Use the name-based greeting (uses extension's display_name)
+     * await client.updateVoicemailGreeting({ extension: '1001', greetingType: 'name' });
+     *
+     * // Revert to default
+     * await client.updateVoicemailGreeting({ extension: '1001', greetingType: 'default' });
+     * ```
+     */
+    async updateVoicemailGreeting(params) {
+        return this.request('PUT', '/api/voicemail/greeting', params);
+    }
+    /**
+     * Upload a custom greeting audio file for an extension's voicemail.
+     * The file is automatically converted to WAV 8kHz mono for FreeSWITCH.
+     * Supported formats: WAV, MP3, OGG, M4A.
+     * Automatically sets greetingType to 'custom_audio'.
+     *
+     * @param audioFile - The audio file (Buffer, Blob, or File)
+     * @param extension - The extension number (defaults to authenticated user's extension)
+     * @param filename - Optional filename hint
+     */
+    async uploadVoicemailGreetingAudio(audioFile, extension, filename) {
+        const formData = new FormData();
+        formData.append('file', audioFile, filename || 'greeting.wav');
+        if (extension) {
+            formData.append('extension', extension);
+        }
+        const headers = {};
+        if (this.apiKey)
+            headers['X-API-Key'] = this.apiKey;
+        else if (this.token)
+            headers['Authorization'] = `Bearer ${this.token}`;
+        if (this.tenantId && this.tenantId !== 'all')
+            headers['X-Tenant-ID'] = this.tenantId;
+        const response = await fetch(`${this.apiUrl}/api/voicemail/greeting/audio`, {
+            method: 'POST',
+            headers,
+            body: formData,
+        });
+        if (!response.ok) {
+            const error = await response.json().catch(() => ({ error: response.statusText }));
+            throw new HttpError(response.status, error.error || response.statusText, error);
+        }
+        return response.json();
+    }
+    /**
+     * Get a direct URL to stream the custom greeting audio in a browser `<audio>` element.
+     * Returns null if the extension has no custom greeting audio.
+     */
+    getVoicemailGreetingAudioUrl(extension) {
+        const base = `${this.apiUrl}/api/voicemail/greeting/audio?extension=${encodeURIComponent(extension)}`;
+        return this.apiKey ? `${base}&apiKey=${encodeURIComponent(this.apiKey)}` : base;
+    }
+    /** Delete custom greeting audio, reverting to default greeting */
+    async deleteVoicemailGreetingAudio(extension) {
+        return this.request('DELETE', '/api/voicemail/greeting/audio', extension ? { extension } : undefined);
+    }
+    // -------------------------------------------------------------------
+    // 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. Pass `options.tenantId` when using a global superadmin key. */
+    async blockNumber(params, options) {
+        return this.request('POST', '/api/blocklist', params, undefined, options);
+    }
+    /** 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. Pass `options.tenantId` when using a global superadmin key. */
+    async createSchedule(params, options) {
+        return this.request('POST', '/api/schedules', params, undefined, options);
+    }
+    /** 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.
+     * @superadmin ONLY — tenant admins cannot create trunks.
+     * Tenants automatically route outbound calls through the shared global trunk.
+     * Pass `options.tenantId` to assign a trunk to a specific tenant (or omit + set `isGlobal: true` for a shared trunk).
+     * Response includes `gatewaySync` indicating whether the FreeSWITCH gateway was loaded.
+     */
+    async createTrunk(params, options) {
+        return this.request('POST', '/api/trunks', params, undefined, options);
+    }
+    /**
+     * Update a SIP trunk.
+     * @superadmin ONLY — tenant admins cannot modify trunks.
+     */
+    async updateTrunk(id, params) {
+        return this.request('PUT', `/api/trunks/${id}`, params);
+    }
+    /**
+     * Delete a SIP trunk.
+     * @superadmin ONLY — tenant admins cannot delete trunks.
+     */
+    async deleteTrunk(id) {
+        return this.request('DELETE', `/api/trunks/${id}`);
+    }
+    /** Get live gateway status for a trunk from FreeSWITCH */
+    async getTrunkStatus(id) {
+        return this.request('GET', `/api/trunks/${id}/status`);
+    }
+    /** Force re-sync a trunk's gateway to FreeSWITCH */
+    async syncTrunk(id) {
+        return this.request('POST', `/api/trunks/${id}/sync`);
+    }
+    /** List all active gateways in FreeSWITCH */
+    async listActiveGateways() {
+        return this.request('GET', '/api/trunks/gateways/active');
+    }
+    // -------------------------------------------------------------------
+    // API Keys
+    // -------------------------------------------------------------------
+    /** List API keys for the current tenant (admin only) */
+    async listApiKeys() {
+        return this.request('GET', '/api/api-keys');
+    }
+    /** Get a single API key detail */
+    async getApiKeyDetail(id) {
+        return this.request('GET', `/api/api-keys/${id}`);
+    }
+    /** Create a new API key. The full key is only returned once in the response. Pass `options.tenantId` when using a global superadmin key. */
+    async createApiKey(params, options) {
+        return this.request('POST', '/api/api-keys', params, undefined, options);
+    }
+    /** Update an API key (name, role, scopes, expiration) */
+    async updateApiKey(id, params) {
+        return this.request('PUT', `/api/api-keys/${id}`, params);
+    }
+    /** Revoke an API key (soft delete — key becomes immediately unusable) */
+    async revokeApiKey(id) {
+        return this.request('DELETE', `/api/api-keys/${id}`);
+    }
+    /** Regenerate an API key (new key value, same ID). Full key returned once. */
+    async regenerateApiKey(id) {
+        return this.request('POST', `/api/api-keys/${id}/regenerate`);
+    }
+    // -------------------------------------------------------------------
+    // 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.apiKey) {
+                this.ws.send(JSON.stringify({ type: 'auth', apiKey: this.apiKey }));
+            }
+            else 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.wsReconnectAttempts = 0; // Reset on successful auth
+                }
+                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();
+        this.wsReconnectAttempts = 0;
+        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;
+        if (this.wsReconnectAttempts >= this.WS_MAX_RECONNECT) {
+            this.emitWs('error', { type: 'error', message: 'Max WebSocket reconnection attempts reached' });
+            return;
+        }
+        const delay = Math.min(3000 * Math.pow(2, this.wsReconnectAttempts), 60000);
+        this.wsReconnectAttempts++;
+        this.wsReconnectTimer = setTimeout(() => {
+            this.wsReconnectTimer = null;
+            this.connectWebSocket();
+        }, delay);
+    }
+    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.apiKey = null;
+        this.tenantId = null;
+    }
+}
+//# sourceMappingURL=client.js.map