wakz-sdk 1.0.0

package/dist/esm/client.mjs

@@ -0,0 +1,319 @@
+// ═══════════════════════════════════════════════════════════════
+// WAKZ SDK — Main Client
+// ═══════════════════════════════════════════════════════════════
+import { WAKZEventEmitter } from './events';
+import { WebSocketTransport } from './websocket';
+import { HttpTransport } from './http';
+import { SessionManager } from './session';
+import { httpToWsUrl, normalizeUrl, resolveTransportMode, Logger } from './utils';
+/**
+ * WAKZ SDK Client — The main entry point for integrating WAKZ AI.
+ *
+ * Features:
+ * - Dual transport: WebSocket (primary) with HTTP/REST fallback
+ * - Automatic reconnection with exponential backoff
+ * - API key authentication with HMAC-SHA256 request signing
+ * - Typed event emitter for real-time updates
+ * - Session management with visitor fingerprinting
+ * - Works in both browser and Node.js environments
+ *
+ * @example
+ * ```typescript
+ * const client = new WAKZClient({
+ *   apiKey: 'wakz_live_xxxxx',
+ * });
+ *
+ * await client.connect();
+ * client.on('message', (msg) => console.log(msg));
+ * const response = await client.sendMessage('Hello!');
+ * ```
+ */
+export class WAKZClient extends WAKZEventEmitter {
+    /**
+     * Create a new WAKZ SDK client instance.
+     *
+     * @param options - Client configuration options
+     */
+    constructor(options) {
+        super();
+        this.wsTransport = null;
+        this._status = 'disconnected';
+        this._currentTransport = 'http';
+        if (!options.apiKey || typeof options.apiKey !== 'string') {
+            throw new Error('[WAKZ SDK] A valid API key is required. API keys start with "wakz_live_".');
+        }
+        if (!options.apiKey.startsWith('wakz_live_')) {
+            this.warn('[WAKZ SDK] API key does not start with "wakz_live_". Please verify your key.');
+        }
+        this.options = {
+            apiKey: options.apiKey,
+            baseUrl: normalizeUrl(options.baseUrl || 'https://api.wakz.dev'),
+            websocketUrl: options.websocketUrl || httpToWsUrl(options.baseUrl || 'https://api.wakz.dev'),
+            autoReconnect: options.autoReconnect ?? true,
+            maxRetries: options.maxRetries ?? 5,
+            initialRetryDelay: options.initialRetryDelay ?? 1000,
+            maxRetryDelay: options.maxRetryDelay ?? 30000,
+            visitorId: options.visitorId,
+            metadata: options.metadata,
+            timeout: options.timeout ?? 30000,
+            debug: options.debug ?? false,
+        };
+        this.logger = new Logger(this.options.debug);
+        // Initialize HTTP transport (always available as fallback)
+        this.httpTransport = new HttpTransport(this.options.apiKey, this.options.baseUrl, this.options.timeout, this.options.debug);
+        // Initialize session manager
+        this.sessionManager = new SessionManager(this.options.visitorId, this.options.metadata);
+    }
+    /**
+     * Connect to the WAKZ API.
+     *
+     * Attempts WebSocket connection first. Falls back to HTTP if:
+     * - WebSocket is not available in the environment
+     * - WebSocket connection fails after max retries
+     *
+     * @returns Promise that resolves when connected
+     */
+    async connect() {
+        this._status = 'connecting';
+        this.logger.info('Connecting to WAKZ API...');
+        // Resolve the best available transport
+        const preferredTransport = resolveTransportMode();
+        if (preferredTransport === 'websocket') {
+            try {
+                await this.connectWebSocket();
+                return;
+            }
+            catch (err) {
+                this.logger.warn('WebSocket connection failed, falling back to HTTP:', err);
+            }
+        }
+        // Fallback to HTTP transport
+        this._currentTransport = 'http';
+        this._status = 'connected';
+        this.logger.info('Connected via HTTP transport');
+        this.emit('connected', undefined);
+        // Initialize session
+        const session = await this.sessionManager.getSession();
+        this.emit('session_start', session);
+    }
+    /**
+     * Send a chat message.
+     *
+     * Uses the current active transport (WebSocket or HTTP).
+     *
+     * @param content - The message text to send
+     * @returns Promise resolving to the assistant's reply
+     */
+    async sendMessage(content) {
+        if (!content || typeof content !== 'string') {
+            return { success: false, error: 'Message content is required' };
+        }
+        const session = await this.sessionManager.getSession();
+        // Try WebSocket first
+        if (this._currentTransport === 'websocket' && this.wsTransport?.isConnected) {
+            try {
+                const message = await this.wsTransport.sendMessage(content, session.id, session.visitorId);
+                this.sessionManager.incrementMessageCount();
+                return { success: true, message };
+            }
+            catch (err) {
+                this.logger.warn('WebSocket send failed, falling back to HTTP:', err);
+                // Fall through to HTTP
+            }
+        }
+        // HTTP fallback
+        try {
+            const result = await this.httpTransport.sendMessage(content, session.id, session.visitorId);
+            if (result.success) {
+                this.sessionManager.incrementMessageCount();
+                if (result.message) {
+                    this.emit('message', result.message);
+                }
+            }
+            return result;
+        }
+        catch (err) {
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : 'Failed to send message',
+            };
+        }
+    }
+    /**
+     * Disconnect from the WAKZ API.
+     */
+    disconnect() {
+        this._status = 'disconnected';
+        this.wsTransport?.disconnect();
+        this.sessionManager.endSession();
+        this.logger.info('Disconnected');
+    }
+    /**
+     * Register an event listener.
+     */
+    on(event, callback) {
+        super.on(event, callback);
+        return this;
+    }
+    /**
+     * Register a one-time event listener.
+     */
+    once(event, callback) {
+        super.once(event, callback);
+        return this;
+    }
+    /**
+     * Remove an event listener.
+     */
+    off(event, callback) {
+        super.off(event, callback);
+        return this;
+    }
+    /**
+     * Get the current session information.
+     */
+    async getSession() {
+        return this.sessionManager.getSession();
+    }
+    /**
+     * Get the current visitor ID.
+     */
+    getVisitorId() {
+        return this.sessionManager.getVisitorId();
+    }
+    /**
+     * Get the current connection status.
+     */
+    getStatus() {
+        return this._status;
+    }
+    /**
+     * Get the current transport mode.
+     */
+    getTransport() {
+        return this._currentTransport;
+    }
+    /**
+     * Fetch the widget configuration from the API.
+     */
+    async getWidgetConfig() {
+        return this.httpTransport.fetchWidgetConfig();
+    }
+    /**
+     * Perform a health check against the WAKZ API.
+     */
+    async healthCheck() {
+        // Use the active transport for health check
+        if (this._currentTransport === 'websocket' && this.wsTransport?.isConnected) {
+            return this.wsTransport.healthCheck();
+        }
+        return this.httpTransport.healthCheck();
+    }
+    /**
+     * Update visitor metadata.
+     */
+    updateMetadata(metadata) {
+        this.sessionManager.updateMetadata(metadata);
+    }
+    /**
+     * Destroy the client — disconnect and clean up all resources.
+     */
+    destroy() {
+        this.disconnect();
+        this.wsTransport = null;
+        this.sessionManager.destroy();
+        this.removeAllListeners();
+        this.logger.info('Client destroyed');
+    }
+    /**
+     * ─── Static Methods ──────────────────────────────────────
+     */
+    /**
+     * Perform a quick health check against a WAKZ API endpoint.
+     * Useful for checking connectivity before creating a client instance.
+     *
+     * @param baseUrl - The API base URL to check
+     * @param timeout - Request timeout in ms (default: 10000)
+     * @returns Health check result
+     */
+    static async healthCheck(baseUrl = 'https://api.wakz.dev', timeout = 10000) {
+        const startTime = Date.now();
+        try {
+            const url = `${normalizeUrl(baseUrl)}/api/v1/embed/health`;
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeout);
+            const response = await fetch(url, {
+                method: 'GET',
+                signal: controller.signal,
+            }).finally(() => clearTimeout(timer));
+            const data = await response.json().catch(() => ({}));
+            return {
+                healthy: response.ok,
+                latency: Date.now() - startTime,
+                version: data.version,
+            };
+        }
+        catch {
+            return {
+                healthy: false,
+                latency: Date.now() - startTime,
+            };
+        }
+    }
+    // ─── Private Methods ──────────────────────────────────────
+    /**
+     * Connect via WebSocket transport.
+     */
+    async connectWebSocket() {
+        this._currentTransport = 'websocket';
+        // Create WebSocket transport and forward events
+        this.wsTransport = new WebSocketTransport(this.options.apiKey, this.options.websocketUrl, {
+            autoReconnect: this.options.autoReconnect,
+            maxRetries: this.options.maxRetries,
+            initialRetryDelay: this.options.initialRetryDelay,
+            maxRetryDelay: this.options.maxRetryDelay,
+            debug: this.options.debug,
+        });
+        // Forward WebSocket events to client
+        this.wsTransport.on('connected', () => {
+            this._status = 'connected';
+            this.emit('connected', undefined);
+            // Start session
+            this.sessionManager.getSession().then((session) => {
+                this.emit('session_start', session);
+            });
+        });
+        this.wsTransport.on('disconnected', (data) => {
+            if (this._status === 'connected') {
+                this._status = 'disconnected';
+            }
+            this.emit('disconnected', data);
+        });
+        this.wsTransport.on('reconnecting', (data) => {
+            this._status = 'reconnecting';
+            this.emit('reconnecting', data);
+        });
+        this.wsTransport.on('reconnect_failed', (data) => {
+            this.logger.warn('WebSocket reconnect failed, switching to HTTP');
+            this.emit('reconnect_failed', data);
+            // Auto-switch to HTTP transport
+            this._currentTransport = 'http';
+            this._status = 'connected';
+            this.emit('transport_change', { from: 'websocket', to: 'http' });
+            this.emit('connected', undefined);
+        });
+        this.wsTransport.on('message', (msg) => {
+            this.sessionManager.incrementMessageCount();
+            this.emit('message', msg);
+        });
+        this.wsTransport.on('error', (err) => {
+            this.emit('error', err);
+        });
+        // Connect
+        await this.wsTransport.connect();
+    }
+    warn(msg) {
+        console.warn(msg);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/crypto.ts"],"names":[],"mappings":"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"}

package/dist/esm/crypto.mjs

@@ -0,0 +1,123 @@
+// ═══════════════════════════════════════════════════════════════
+// WAKZ SDK — Cryptographic Utilities
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Cryptographic utilities for API request signing and verification.
+ * Uses the Web Crypto API (browser) or Node.js crypto (server).
+ */
+// ── Platform Detection ──────────────────────────────────────────
+const isNode = typeof process !== 'undefined' &&
+    typeof process.versions !== 'undefined' &&
+    typeof process.versions.node !== 'undefined';
+const isBrowser = typeof window !== 'undefined' && typeof window.crypto !== 'undefined';
+// ── HMAC-SHA256 Implementation ──────────────────────────────────
+/**
+ * Create HMAC-SHA256 signature using the best available crypto API.
+ * Works in both browser (Web Crypto) and Node.js environments.
+ */
+async function hmacSha256(key, message) {
+    if (isNode) {
+        // Node.js crypto
+        const nodeCrypto = await import('crypto');
+        return nodeCrypto
+            .createHmac('sha256', key)
+            .update(message)
+            .digest('hex');
+    }
+    if (isBrowser && typeof window.crypto.subtle !== 'undefined') {
+        // Web Crypto API (async)
+        const encoder = new TextEncoder();
+        const keyData = encoder.encode(key);
+        const msgData = encoder.encode(message);
+        const cryptoKey = await window.crypto.subtle.importKey('raw', keyData, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+        const signature = await window.crypto.subtle.sign('HMAC', cryptoKey, msgData);
+        return Array.from(new Uint8Array(signature))
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+    }
+    throw new Error('[WAKZ SDK] No cryptographic implementation available. ' +
+        'Requires Node.js >= 16 or a modern browser with Web Crypto API support.');
+}
+/**
+ * Sign an API request payload for authentication.
+ *
+ * The signing process:
+ * 1. Create a timestamp string (ISO 8601)
+ * 2. Build the signing payload: `${timestamp}.${JSON.stringify(body)}`
+ * 3. HMAC-SHA256 sign with the API key
+ *
+ * Headers produced:
+ * - `X-API-Key`: The raw API key
+ * - `X-Timestamp`: ISO timestamp
+ * - `X-Signature`: HMAC hex digest
+ * - `Content-Type`: application/json
+ */
+export async function signRequest(apiKey, body) {
+    const timestamp = new Date().toISOString();
+    const signingPayload = `${timestamp}.${JSON.stringify(body)}`;
+    const signature = await hmacSha256(apiKey, signingPayload);
+    return {
+        'X-API-Key': apiKey,
+        'X-Timestamp': timestamp,
+        'X-Signature': signature,
+        'Content-Type': 'application/json',
+    };
+}
+/**
+ * Simple hash function for visitor fingerprinting.
+ * NOT cryptographically secure — used only for session identification.
+ */
+export async function simpleHash(input) {
+    if (isNode) {
+        const nodeCrypto = await import('crypto');
+        return nodeCrypto.createHash('sha256').update(input).digest('hex').slice(0, 16);
+    }
+    if (isBrowser && typeof window.crypto.subtle !== 'undefined') {
+        const encoder = new TextEncoder();
+        const data = encoder.encode(input);
+        const hash = await window.crypto.subtle.digest('SHA-256', data);
+        return Array.from(new Uint8Array(hash))
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('')
+            .slice(0, 16);
+    }
+    // Fallback: simple string hash (non-crypto)
+    let hash = 0;
+    for (let i = 0; i < input.length; i++) {
+        const char = input.charCodeAt(i);
+        hash = ((hash << 5) - hash + char) | 0;
+    }
+    return Math.abs(hash).toString(16).padStart(16, '0');
+}
+/**
+ * Generate a random hex string of specified byte length.
+ */
+export function randomHex(bytes) {
+    const isNodeEnv = typeof process !== 'undefined' &&
+        typeof process.versions !== 'undefined' &&
+        typeof process.versions.node !== 'undefined';
+    if (isNodeEnv) {
+        try {
+            const nodeCrypto = require('crypto');
+            return nodeCrypto.randomBytes(bytes).toString('hex');
+        }
+        catch {
+            // Fallback below
+        }
+    }
+    if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues !== 'undefined') {
+        const array = new Uint8Array(bytes);
+        crypto.getRandomValues(array);
+        return Array.from(array)
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+    }
+    // Math.random fallback (not cryptographically secure)
+    const chars = '0123456789abcdef';
+    let result = '';
+    for (let i = 0; i < bytes * 2; i++) {
+        result += chars[Math.floor(Math.random() * chars.length)];
+    }
+    return result;
+}
+//# sourceMappingURL=crypto.js.map

package/dist/esm/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":"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"}

package/dist/esm/events.mjs

@@ -0,0 +1,100 @@
+// ═══════════════════════════════════════════════════════════════
+// WAKZ SDK — Event Emitter System
+// ═══════════════════════════════════════════════════════════════
+/**
+ * Lightweight typed event emitter for the WAKZ SDK.
+ * Zero external dependencies.
+ */
+export class WAKZEventEmitter {
+    constructor() {
+        this.listeners = new Map();
+        this.onceListeners = new Map();
+    }
+    /**
+     * Register an event listener.
+     */
+    on(event, callback) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(callback);
+        return this;
+    }
+    /**
+     * Register a one-time event listener (auto-removes after first call).
+     */
+    once(event, callback) {
+        if (!this.onceListeners.has(event)) {
+            this.onceListeners.set(event, new Set());
+        }
+        this.onceListeners.get(event).add(callback);
+        return this;
+    }
+    /**
+     * Remove a specific event listener.
+     */
+    off(event, callback) {
+        this.listeners.get(event)?.delete(callback);
+        this.onceListeners.get(event)?.delete(callback);
+        return this;
+    }
+    /**
+     * Remove all listeners for a specific event, or all events if no event specified.
+     */
+    removeAllListeners(event) {
+        if (event) {
+            this.listeners.delete(event);
+            this.onceListeners.delete(event);
+        }
+        else {
+            this.listeners.clear();
+            this.onceListeners.clear();
+        }
+        return this;
+    }
+    /**
+     * Emit an event to all registered listeners.
+     */
+    emit(event, data) {
+        // Fire persistent listeners
+        const persistent = this.listeners.get(event);
+        if (persistent) {
+            for (const cb of persistent) {
+                try {
+                    cb(data);
+                }
+                catch (err) {
+                    // Prevent listener errors from breaking the emitter
+                    console.error(`[WAKZ SDK] Error in "${event}" listener:`, err);
+                }
+            }
+        }
+        // Fire and consume once-listeners
+        const once = this.onceListeners.get(event);
+        if (once) {
+            for (const cb of once) {
+                try {
+                    cb(data);
+                }
+                catch (err) {
+                    console.error(`[WAKZ SDK] Error in "${event}" once-listener:`, err);
+                }
+            }
+            this.onceListeners.delete(event);
+        }
+    }
+    /**
+     * Get the count of listeners for a specific event.
+     */
+    listenerCount(event) {
+        return (this.listeners.get(event)?.size ?? 0) + (this.onceListeners.get(event)?.size ?? 0);
+    }
+    /**
+     * Destroy the emitter — remove all listeners.
+     */
+    destroy() {
+        this.listeners.clear();
+        this.onceListeners.clear();
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/esm/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"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"}