wakz-sdk 1.0.0

package/dist/http.js

@@ -0,0 +1,163 @@
+"use strict";
+// ═══════════════════════════════════════════════════════════════
+// WAKZ SDK — HTTP/REST Transport Client
+// ═══════════════════════════════════════════════════════════════
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpTransport = void 0;
+const crypto_1 = require("./crypto");
+const utils_1 = require("./utils");
+/**
+ * HTTP/REST fallback transport for environments where WebSocket is unavailable.
+ * All requests are signed with HMAC-SHA256 for secure authentication.
+ */
+class HttpTransport {
+    constructor(apiKey, baseUrl, timeout = 30000, debug = false) {
+        this.apiKey = apiKey;
+        this.baseUrl = (0, utils_1.normalizeUrl)(baseUrl);
+        this.timeout = timeout;
+        this.logger = new utils_1.Logger(debug);
+    }
+    /**
+     * Send a chat message via REST API.
+     */
+    async sendMessage(content, sessionId, visitorId) {
+        try {
+            const body = {
+                message: content,
+                role: 'user',
+                timestamp: (0, utils_1.nowISO)(),
+                id: (0, utils_1.generateId)('msg'),
+            };
+            if (sessionId)
+                body.session_id = sessionId;
+            if (visitorId)
+                body.visitor_id = visitorId;
+            const signed = await (0, crypto_1.signRequest)(this.apiKey, body);
+            this.logger.debug('[HTTP] Sending message:', content.slice(0, 50) + '...');
+            const response = await this.fetchWithTimeout('/api/v1/embed/chat', {
+                method: 'POST',
+                headers: signed,
+                body: JSON.stringify(body),
+            });
+            const data = await response.json();
+            if (!response.ok) {
+                return {
+                    success: false,
+                    error: data.error || `HTTP ${response.status}`,
+                };
+            }
+            return {
+                success: true,
+                message: data.message || data.reply || {
+                    id: (0, utils_1.generateId)('msg'),
+                    role: 'assistant',
+                    content: data.content || data.reply_text || data.text || '',
+                    timestamp: (0, utils_1.nowISO)(),
+                },
+            };
+        }
+        catch (err) {
+            this.logger.error('[HTTP] sendMessage error:', err);
+            return {
+                success: false,
+                error: err instanceof Error ? err.message : 'Network error',
+            };
+        }
+    }
+    /**
+     * Fetch widget configuration.
+     */
+    async fetchWidgetConfig() {
+        try {
+            const body = { action: 'get_config', timestamp: (0, utils_1.nowISO)() };
+            const signed = await (0, crypto_1.signRequest)(this.apiKey, body);
+            const response = await this.fetchWithTimeout('/api/v1/embed/widget', {
+                method: 'GET',
+                headers: {
+                    'X-API-Key': signed['X-API-Key'],
+                    'X-Timestamp': signed['X-Timestamp'],
+                    'X-Signature': signed['X-Signature'],
+                },
+            });
+            if (!response.ok)
+                return null;
+            const data = await response.json();
+            return data.success ? data : null;
+        }
+        catch (err) {
+            this.logger.error('[HTTP] fetchWidgetConfig error:', err);
+            return null;
+        }
+    }
+    /**
+     * Perform a health check against the API.
+     */
+    async healthCheck() {
+        const startTime = Date.now();
+        try {
+            const response = await this.fetchWithTimeout('/api/v1/embed/health', {
+                method: 'GET',
+                headers: {
+                    'X-API-Key': this.apiKey,
+                    'Content-Type': 'application/json',
+                },
+            });
+            const latency = Date.now() - startTime;
+            const data = await response.json().catch(() => ({}));
+            return {
+                healthy: response.ok,
+                latency,
+                version: data.version,
+            };
+        }
+        catch {
+            return {
+                healthy: false,
+                latency: Date.now() - startTime,
+            };
+        }
+    }
+    /**
+     * Get the current session from the server.
+     */
+    async getSession(visitorId) {
+        try {
+            const body = { visitor_id: visitorId, timestamp: (0, utils_1.nowISO)() };
+            const signed = await (0, crypto_1.signRequest)(this.apiKey, body);
+            const response = await this.fetchWithTimeout('/api/v1/embed/session', {
+                method: 'POST',
+                headers: signed,
+                body: JSON.stringify(body),
+            });
+            if (!response.ok)
+                return null;
+            return await response.json().catch(() => null);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Fetch with timeout support.
+     */
+    async fetchWithTimeout(path, options, timeout) {
+        const controller = new AbortController();
+        const timeoutMs = timeout ?? this.timeout;
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const url = path.startsWith('http')
+                ? path
+                : `${this.baseUrl}${path}`;
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+            });
+            return response;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+exports.HttpTransport = HttpTransport;
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @module @wakz/sdk
+ * @description Official WAKZ AI SDK — Embed intelligent chat assistants anywhere.
+ *
+ * @example
+ * ```typescript
+ * import { WAKZClient } from '@wakz/sdk';
+ *
+ * const client = new WAKZClient({
+ *   apiKey: 'wakz_live_xxxxx',
+ * });
+ *
+ * await client.connect();
+ * client.on('message', (msg) => console.log(msg.content));
+ * const response = await client.sendMessage('Hello!');
+ * console.log(response.message?.content);
+ * ```
+ */
+export { WAKZClient } from './client';
+export type { TransportMode, ConnectionStatus, MessageRole, ChatMessage, SendMessageResponse, SessionInfo, WidgetConfig, WebhookConfig, WAKZClientOptions, WAKZEventType, WAKZEventCallback, WAKZEventMap, HealthCheckResult, SignedHeaders, } from './types';
+export { WebSocketTransport } from './websocket';
+export { HttpTransport } from './http';
+export { SessionManager } from './session';
+export { WAKZEventEmitter } from './events';
+export { signRequest, simpleHash, randomHex, } from './crypto';
+export { generateId, generateVisitorFingerprint, calculateBackoff, normalizeUrl, httpToWsUrl, Logger, } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,GACV,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,UAAU,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,MAAM,GACP,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+"use strict";
+// ═══════════════════════════════════════════════════════════════
+// WAKZ SDK — Main Entry Point
+// ═══════════════════════════════════════════════════════════════
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.httpToWsUrl = exports.normalizeUrl = exports.calculateBackoff = exports.generateVisitorFingerprint = exports.generateId = exports.randomHex = exports.simpleHash = exports.signRequest = exports.WAKZEventEmitter = exports.SessionManager = exports.HttpTransport = exports.WebSocketTransport = exports.WAKZClient = void 0;
+/**
+ * @module @wakz/sdk
+ * @description Official WAKZ AI SDK — Embed intelligent chat assistants anywhere.
+ *
+ * @example
+ * ```typescript
+ * import { WAKZClient } from '@wakz/sdk';
+ *
+ * const client = new WAKZClient({
+ *   apiKey: 'wakz_live_xxxxx',
+ * });
+ *
+ * await client.connect();
+ * client.on('message', (msg) => console.log(msg.content));
+ * const response = await client.sendMessage('Hello!');
+ * console.log(response.message?.content);
+ * ```
+ */
+// Main client
+var client_1 = require("./client");
+Object.defineProperty(exports, "WAKZClient", { enumerable: true, get: function () { return client_1.WAKZClient; } });
+// Lower-level components (for advanced usage)
+var websocket_1 = require("./websocket");
+Object.defineProperty(exports, "WebSocketTransport", { enumerable: true, get: function () { return websocket_1.WebSocketTransport; } });
+var http_1 = require("./http");
+Object.defineProperty(exports, "HttpTransport", { enumerable: true, get: function () { return http_1.HttpTransport; } });
+var session_1 = require("./session");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return session_1.SessionManager; } });
+var events_1 = require("./events");
+Object.defineProperty(exports, "WAKZEventEmitter", { enumerable: true, get: function () { return events_1.WAKZEventEmitter; } });
+// Utilities
+var crypto_1 = require("./crypto");
+Object.defineProperty(exports, "signRequest", { enumerable: true, get: function () { return crypto_1.signRequest; } });
+Object.defineProperty(exports, "simpleHash", { enumerable: true, get: function () { return crypto_1.simpleHash; } });
+Object.defineProperty(exports, "randomHex", { enumerable: true, get: function () { return crypto_1.randomHex; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "generateId", { enumerable: true, get: function () { return utils_1.generateId; } });
+Object.defineProperty(exports, "generateVisitorFingerprint", { enumerable: true, get: function () { return utils_1.generateVisitorFingerprint; } });
+Object.defineProperty(exports, "calculateBackoff", { enumerable: true, get: function () { return utils_1.calculateBackoff; } });
+Object.defineProperty(exports, "normalizeUrl", { enumerable: true, get: function () { return utils_1.normalizeUrl; } });
+Object.defineProperty(exports, "httpToWsUrl", { enumerable: true, get: function () { return utils_1.httpToWsUrl; } });
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return utils_1.Logger; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,8BAA8B;AAC9B,kEAAkE;;;AAElE;;;;;;;;;;;;;;;;;GAiBG;AAEH,cAAc;AACd,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAoBnB,8CAA8C;AAC9C,yCAAiD;AAAxC,+GAAA,kBAAkB,OAAA;AAC3B,+BAAuC;AAA9B,qGAAA,aAAa,OAAA;AACtB,qCAA2C;AAAlC,yGAAA,cAAc,OAAA;AACvB,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA;AAEzB,YAAY;AACZ,mCAIkB;AAHhB,qGAAA,WAAW,OAAA;AACX,oGAAA,UAAU,OAAA;AACV,mGAAA,SAAS,OAAA;AAGX,iCAOiB;AANf,mGAAA,UAAU,OAAA;AACV,mHAAA,0BAA0B,OAAA;AAC1B,yGAAA,gBAAgB,OAAA;AAChB,qGAAA,YAAY,OAAA;AACZ,oGAAA,WAAW,OAAA;AACX,+FAAA,MAAM,OAAA"}

package/dist/session.d.ts

@@ -0,0 +1,75 @@
+import type { SessionInfo } from './types';
+/**
+ * Manages visitor sessions for the WAKZ embed chat.
+ * Each visitor gets a unique session that tracks their conversation.
+ */
+export declare class SessionManager {
+    private session;
+    private visitorId;
+    private metadata;
+    private sessionStoreKey;
+    constructor(visitorId?: string, metadata?: Record<string, string>);
+    /**
+     * Get or create a session.
+     */
+    getSession(): Promise<SessionInfo>;
+    /**
+     * Create a new session.
+     */
+    private createSession;
+    /**
+     * Increment message count for the current session.
+     */
+    incrementMessageCount(): void;
+    /**
+     * End the current session.
+     */
+    endSession(): {
+        sessionId: string;
+    } | null;
+    /**
+     * Get the visitor ID.
+     */
+    getVisitorId(): string;
+    /**
+     * Update visitor metadata.
+     */
+    updateMetadata(newMeta: Record<string, string>): void;
+    /**
+     * Generate a unique visitor ID based on fingerprint.
+     */
+    private generateVisitorId;
+    /**
+     * Generate a unique session ID.
+     */
+    private generateSessionId;
+    /**
+     * Save session to localStorage (browser) or skip (server).
+     */
+    private saveSession;
+    /**
+     * Load session from storage.
+     */
+    private loadSession;
+    /**
+     * Clear stored session.
+     */
+    private clearStoredSession;
+    /**
+     * Save a value to the best available storage.
+     */
+    private saveToStorage;
+    /**
+     * Load a value from storage.
+     */
+    private loadFromStorage;
+    /**
+     * Remove a value from storage.
+     */
+    private removeFromStorage;
+    /**
+     * Destroy the session manager and clean up.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,eAAe,CAAkB;gBAGvC,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMnC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAcxC;;OAEG;YACW,aAAa;IAiB3B;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAQ7B;;OAEG;IACH,UAAU,IAAI;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAY1C;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAQrD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;YACW,iBAAiB;IAM/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB"}

package/dist/session.js

@@ -0,0 +1,190 @@
+"use strict";
+// ═══════════════════════════════════════════════════════════════
+// WAKZ SDK — Session Management
+// ═══════════════════════════════════════════════════════════════
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+const utils_1 = require("./utils");
+const crypto_1 = require("./crypto");
+/**
+ * Manages visitor sessions for the WAKZ embed chat.
+ * Each visitor gets a unique session that tracks their conversation.
+ */
+class SessionManager {
+    constructor(visitorId, metadata) {
+        this.session = null;
+        this.sessionStoreKey = 'wakz_session';
+        this.metadata = metadata || {};
+        this.visitorId = visitorId || this.generateVisitorId();
+    }
+    /**
+     * Get or create a session.
+     */
+    async getSession() {
+        // Try to restore from storage
+        if (!this.session) {
+            this.session = this.loadSession();
+        }
+        // Create new if none found
+        if (!this.session || !this.session.isActive) {
+            this.session = await this.createSession();
+        }
+        return this.session;
+    }
+    /**
+     * Create a new session.
+     */
+    async createSession() {
+        const now = (0, utils_1.nowISO)();
+        const session = {
+            id: await this.generateSessionId(),
+            visitorId: this.visitorId,
+            messageCount: 0,
+            isActive: true,
+            startedAt: now,
+            lastActivityAt: now,
+            metadata: { ...this.metadata },
+        };
+        this.session = session;
+        this.saveSession(session);
+        return session;
+    }
+    /**
+     * Increment message count for the current session.
+     */
+    incrementMessageCount() {
+        if (this.session) {
+            this.session.messageCount++;
+            this.session.lastActivityAt = (0, utils_1.nowISO)();
+            this.saveSession(this.session);
+        }
+    }
+    /**
+     * End the current session.
+     */
+    endSession() {
+        if (this.session) {
+            this.session.isActive = false;
+            this.saveSession(this.session);
+            const sessionId = this.session.id;
+            this.session = null;
+            this.clearStoredSession();
+            return { sessionId };
+        }
+        return null;
+    }
+    /**
+     * Get the visitor ID.
+     */
+    getVisitorId() {
+        return this.visitorId;
+    }
+    /**
+     * Update visitor metadata.
+     */
+    updateMetadata(newMeta) {
+        this.metadata = { ...this.metadata, ...newMeta };
+        if (this.session) {
+            this.session.metadata = { ...this.session.metadata, ...newMeta };
+            this.saveSession(this.session);
+        }
+    }
+    /**
+     * Generate a unique visitor ID based on fingerprint.
+     */
+    generateVisitorId() {
+        const fingerprint = (0, utils_1.generateVisitorFingerprint)();
+        // Try to load existing visitor ID from storage
+        const stored = this.loadFromStorage('wakz_visitor_id');
+        if (stored)
+            return stored;
+        const newId = `v_${fingerprint.slice(0, 12)}`;
+        this.saveToStorage('wakz_visitor_id', newId);
+        return newId;
+    }
+    /**
+     * Generate a unique session ID.
+     */
+    async generateSessionId() {
+        const seed = `${this.visitorId}_${Date.now()}_${Math.random()}`;
+        const hash = await (0, crypto_1.simpleHash)(seed);
+        return `sess_${hash}`;
+    }
+    /**
+     * Save session to localStorage (browser) or skip (server).
+     */
+    saveSession(session) {
+        try {
+            this.saveToStorage(this.sessionStoreKey, JSON.stringify(session));
+        }
+        catch {
+            // Storage unavailable (SSR, sandbox)
+        }
+    }
+    /**
+     * Load session from storage.
+     */
+    loadSession() {
+        try {
+            const data = this.loadFromStorage(this.sessionStoreKey);
+            if (data) {
+                const parsed = JSON.parse(data);
+                // Validate it's a proper session object
+                if (parsed.id && parsed.visitorId) {
+                    return parsed;
+                }
+            }
+        }
+        catch {
+            // Invalid or unavailable
+        }
+        return null;
+    }
+    /**
+     * Clear stored session.
+     */
+    clearStoredSession() {
+        try {
+            this.removeFromStorage(this.sessionStoreKey);
+        }
+        catch {
+            // Storage unavailable
+        }
+    }
+    /**
+     * Save a value to the best available storage.
+     */
+    saveToStorage(key, value) {
+        // Try localStorage (browser)
+        if (typeof localStorage !== 'undefined') {
+            localStorage.setItem(key, value);
+            return;
+        }
+    }
+    /**
+     * Load a value from storage.
+     */
+    loadFromStorage(key) {
+        if (typeof localStorage !== 'undefined') {
+            return localStorage.getItem(key);
+        }
+        return null;
+    }
+    /**
+     * Remove a value from storage.
+     */
+    removeFromStorage(key) {
+        if (typeof localStorage !== 'undefined') {
+            localStorage.removeItem(key);
+        }
+    }
+    /**
+     * Destroy the session manager and clean up.
+     */
+    destroy() {
+        this.endSession();
+        this.session = null;
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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