flowgrid-sdk 1.2.1 → 1.3.0

package/dist/lib/client/transport.d.ts

@@ -31,7 +31,7 @@ export type FeatureType = "engagement" | "cohorts" | "churn" | "monetization" |
  *
  * @example
  * ```ts
- * const client = new FlowGridTransport("web_123", "api.flowgrid.com", "sk_live_xxx");
+ * const client = new FlowGridTransport("web_123", "https://core.flow-grid.xyz", "sk_live_xxx");
  * ```
  */
 export declare class FlowGridTransport {
@@ -43,8 +43,8 @@ export declare class FlowGridTransport {
     /**
      * Base API endpoint.
      * Example values:
-     * - "api.flowgrid.com"
-     * - "https://api.flowgrid.com"
+     * - "core.flow-grid.xyz"
+     * - "https://core.flow-grid.xyz"
      *
      * Protocol is normalized automatically.
      */
@@ -53,7 +53,7 @@ export declare class FlowGridTransport {
      * Private API key used for authenticating requests.
      * Sent as a Bearer token in the Authorization header.
      */
-    private apiKey;
+    protected apiKey: string;
     /**
      * Visitor ID for cross-session visitor tracking.
      * Persisted per-visitor (cookie/localStorage) and sent with every event.
@@ -107,6 +107,16 @@ export declare class FlowGridTransport {
      * Fire-and-forget event via sendBeacon. Used for page unload events.
      */
     sendViaBeacon(eventName: string, properties?: Record<string, any>): boolean;
+    /**
+     * POST a large opaque payload to a dedicated SDK endpoint, bypassing the
+     * 10KB validator. Used by session replay (`call=replay_chunk`) where each
+     * batch of rrweb events can be hundreds of kilobytes.
+     *
+     * Falls back to `navigator.sendBeacon` on `pagehide` / final flush.
+     */
+    protected postRaw(callType: string, body: Record<string, unknown>, options?: {
+        useBeacon?: boolean;
+    }): Promise<void>;
     private bufferEvent;
     private drainEventBuffer;
     /**

package/dist/lib/client/transport.js

@@ -0,0 +1,432 @@
+/**
+ * FlowGridTransport — Unified transport layer for Flowgrid SDK.
+ *
+ * @description
+ * Provides a secure, validated RPC-style transport layer used by all SDK modules.
+ * Handles:
+ * - Input validation
+ * - Payload size enforcement
+ * - Timeout handling
+ * - Retry logic (network failures only)
+ * - Authorization headers
+ * - Feature-scoped endpoint routing
+ *
+ * This class is designed to be extended by higher-level modules
+ * (e.g., Analytics, Experiments, Engagement, Cohorts).
+ *
+ * @example
+ * ```ts
+ * const client = new FlowGridTransport("web_123", "https://core.flow-grid.xyz", "sk_live_xxx");
+ * ```
+ */
+export class FlowGridTransport {
+    /**
+     * Creates a new FlowGridTransport instance.
+     *
+     * @param webId - Unique identifier for the web property.
+     * @param endpoint - API base endpoint.
+     * @param apiKey - Private API key for authentication.
+     * @param visitorId - Optional visitor ID for cross-session tracking.
+     *
+     * @throws {Error} If required parameters are missing.
+     */
+    constructor(webId, endpoint, apiKey, visitorId, identityManager, config) {
+        if (!webId?.trim() || !endpoint?.trim()) {
+            throw new Error("SDK init failed: webId and endpoint are required.");
+        }
+        this.webId = webId.trim();
+        this.endpoint = this.normalizeEndpoint(endpoint);
+        this.apiKey = apiKey;
+        this.identityManager = identityManager;
+        this.visitorId = visitorId ?? '';
+        this.transportConfig = {
+            botDetection: config?.botDetection ?? 'block',
+            respectDNT: config?.respectDNT ?? true,
+            sampleRate: config?.sampleRate ?? 1.0,
+        };
+        // Drain buffered events from previous failed attempts
+        this.drainEventBuffer();
+    }
+    // ---------------------------------------------------------------------------
+    // CONSENT API
+    // ---------------------------------------------------------------------------
+    static setConsent(consent) {
+        Object.assign(FlowGridTransport.consent, consent);
+    }
+    static hasConsent(category) {
+        return FlowGridTransport.consent[category] ?? false;
+    }
+    // ---------------------------------------------------------------------------
+    // BOT DETECTION
+    // ---------------------------------------------------------------------------
+    static isLikelyBot() {
+        if (typeof navigator === 'undefined')
+            return false;
+        if (navigator.webdriver)
+            return true;
+        if (/bot|crawl|spider|headless|phantom|puppeteer/i.test(navigator.userAgent))
+            return true;
+        return false;
+    }
+    // ---------------------------------------------------------------------------
+    // DNT / GPC CHECK
+    // ---------------------------------------------------------------------------
+    isDNTEnabled() {
+        if (typeof navigator === 'undefined')
+            return false;
+        if (navigator.globalPrivacyControl)
+            return true;
+        if (navigator.doNotTrack === '1')
+            return true;
+        return false;
+    }
+    // ---------------------------------------------------------------------------
+    // DEVICE ENRICHMENT
+    // ---------------------------------------------------------------------------
+    static getDeviceContext() {
+        if (typeof window === 'undefined' || typeof navigator === 'undefined')
+            return {};
+        return {
+            _screen_width: window.screen?.width,
+            _screen_height: window.screen?.height,
+            _device_type: /Mobi|Android/i.test(navigator.userAgent) ? 'mobile' : 'desktop',
+            _language: navigator.language,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // SENDBACON FALLBACK
+    // ---------------------------------------------------------------------------
+    /**
+     * Fire-and-forget event via sendBeacon. Used for page unload events.
+     */
+    sendViaBeacon(eventName, properties = {}) {
+        if (typeof navigator === 'undefined' || typeof navigator.sendBeacon !== 'function')
+            return false;
+        const resolvedVisitorId = this.identityManager
+            ? this.identityManager.getVisitorId()
+            : (this.visitorId ?? '');
+        const callType = properties.type || 'event';
+        const url = `${this.endpoint}/api/v1/sdk/functions?call=${encodeURIComponent(callType)}`;
+        const payload = JSON.stringify({
+            web_id: this.webId,
+            visitor_id: resolvedVisitorId,
+            event_name: eventName,
+            properties: { ...properties, ...FlowGridTransport.getDeviceContext() },
+        });
+        return navigator.sendBeacon(url, new Blob([payload], { type: 'application/json' }));
+    }
+    // ---------------------------------------------------------------------------
+    // RAW LARGE-PAYLOAD POST (session replay chunks, etc.)
+    // ---------------------------------------------------------------------------
+    /**
+     * POST a large opaque payload to a dedicated SDK endpoint, bypassing the
+     * 10KB validator. Used by session replay (`call=replay_chunk`) where each
+     * batch of rrweb events can be hundreds of kilobytes.
+     *
+     * Falls back to `navigator.sendBeacon` on `pagehide` / final flush.
+     */
+    async postRaw(callType, body, options = {}) {
+        if (FlowGridTransport.consent.analytics === false)
+            return;
+        if (this.transportConfig.respectDNT !== false && this.isDNTEnabled())
+            return;
+        const url = `${this.endpoint}/api/v1/sdk/functions?call=${encodeURIComponent(callType)}`;
+        const resolvedVisitorId = this.identityManager
+            ? this.identityManager.getVisitorId()
+            : (this.visitorId ?? '');
+        const payload = JSON.stringify({
+            web_id: this.webId,
+            visitor_id: resolvedVisitorId,
+            ...body,
+        });
+        if (options.useBeacon && typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function') {
+            navigator.sendBeacon(url, new Blob([payload], { type: 'application/json' }));
+            return;
+        }
+        try {
+            await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.apiKey}`,
+                },
+                body: payload,
+                keepalive: true,
+            });
+        }
+        catch {
+            // swallow — replay is best-effort
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // EVENT BUFFER (localStorage persistence)
+    // ---------------------------------------------------------------------------
+    bufferEvent(url, method, body) {
+        if (typeof localStorage === 'undefined')
+            return;
+        try {
+            const raw = localStorage.getItem(FlowGridTransport.EVENT_BUFFER_KEY);
+            const buffer = raw ? JSON.parse(raw) : [];
+            if (buffer.length >= FlowGridTransport.MAX_BUFFER_EVENTS)
+                return;
+            const serialized = JSON.stringify([...buffer, { url, method, body }]);
+            if (new TextEncoder().encode(serialized).length > FlowGridTransport.MAX_BUFFER_SIZE)
+                return;
+            buffer.push({ url, method, body });
+            localStorage.setItem(FlowGridTransport.EVENT_BUFFER_KEY, JSON.stringify(buffer));
+        }
+        catch { /* storage unavailable */ }
+    }
+    drainEventBuffer() {
+        if (typeof localStorage === 'undefined')
+            return;
+        try {
+            const raw = localStorage.getItem(FlowGridTransport.EVENT_BUFFER_KEY);
+            if (!raw)
+                return;
+            const buffer = JSON.parse(raw);
+            localStorage.removeItem(FlowGridTransport.EVENT_BUFFER_KEY);
+            for (const evt of buffer) {
+                // Best-effort replay; don't await
+                fetch(evt.url, {
+                    method: evt.method,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Authorization': `Bearer ${this.apiKey}`,
+                    },
+                    body: evt.body,
+                }).catch(() => { });
+            }
+        }
+        catch { /* storage unavailable */ }
+    }
+    /**
+     * Core RPC transport method for standard SDK calls.
+     *
+     * @template T Expected JSON response type.
+     *
+     * @param eventName - Logical event or function name.
+     * @param properties - Arbitrary event payload properties.
+     * @param method - HTTP method ("GET", "POST", "PATCH").
+     *
+     * @returns Promise resolving to typed response.
+     */
+    async init(eventName, properties = {}, method = "POST") {
+        // Consent gate
+        if (!FlowGridTransport.hasConsent('analytics')) {
+            return {};
+        }
+        // DNT / GPC gate
+        if (this.transportConfig.respectDNT && this.isDNTEnabled()) {
+            return {};
+        }
+        // Bot detection
+        if (this.transportConfig.botDetection === 'block' && FlowGridTransport.isLikelyBot()) {
+            return {};
+        }
+        this.validateInput(eventName, properties);
+        // Bot tagging
+        if (this.transportConfig.botDetection === 'tag' && FlowGridTransport.isLikelyBot()) {
+            properties = { ...properties, _bot: true };
+        }
+        // Auto device enrichment
+        const enriched = { ...FlowGridTransport.getDeviceContext(), ...properties };
+        const callType = enriched.type || "event";
+        const url = `${this.endpoint}/api/v1/sdk/functions?call=${encodeURIComponent(callType)}`;
+        const resolvedVisitorId = this.identityManager
+            ? this.identityManager.getVisitorId()
+            : (this.visitorId ?? '');
+        const body = JSON.stringify({
+            web_id: this.webId,
+            visitor_id: resolvedVisitorId,
+            event_name: eventName,
+            properties: enriched,
+        });
+        return this.executeRequest(url, method, method === "GET" ? undefined : body);
+    }
+    /**
+     * Feature-scoped RPC transport method.
+     * Routes to the SDK API endpoint with a feature type qualifier.
+     *
+     * @param eventName - Name of the event to track.
+     * @param properties - Additional properties to send (must include type).
+     */
+    async initFeature(eventName, properties) {
+        this.validateInput(eventName, properties);
+        if (!properties.type) {
+            throw new Error('Feature events must include a type property');
+        }
+        const url = `${this.endpoint}/api/v1/sdk/functions?call=${encodeURIComponent(properties.type)}`;
+        const resolvedVisitorId = this.identityManager
+            ? this.identityManager.getVisitorId()
+            : (this.visitorId ?? '');
+        const body = JSON.stringify({
+            web_id: this.webId,
+            visitor_id: resolvedVisitorId,
+            event_name: eventName,
+            properties,
+        });
+        return this.executeRequest(url, "POST", body);
+    }
+    /**
+     * Executes HTTP request with timeout and retry handling.
+     *
+     * @template T Expected response type.
+     *
+     * @param url - Fully constructed request URL.
+     * @param method - HTTP method.
+     * @param body - Optional JSON body (POST/PATCH only).
+     * @param extraHeaders - Additional headers to include.
+     *
+     * @throws {Error} On timeout, network failure, or non-OK HTTP status.
+     */
+    async executeRequest(url, method, body, extraHeaders) {
+        let attempt = 0;
+        while (true) {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), FlowGridTransport.TIMEOUT_MS);
+            try {
+                const res = await fetch(url, {
+                    method,
+                    headers: {
+                        "Content-Type": "application/json",
+                        "Authorization": `Bearer ${this.apiKey}`,
+                        ...extraHeaders,
+                    },
+                    body,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                // Retry on 5xx (server transient errors)
+                if (res.status >= 500 && attempt < FlowGridTransport.MAX_RETRIES) {
+                    attempt++;
+                    await this.backoff(attempt);
+                    continue;
+                }
+                if (!res.ok) {
+                    const text = await this.safeRead(res);
+                    throw new Error(`SDK request failed (${res.status} ${res.statusText}) ${text}`);
+                }
+                return await res.json();
+            }
+            catch (error) {
+                clearTimeout(timeoutId);
+                const isNetworkError = error instanceof Error &&
+                    (error.name === "AbortError" || error.message.includes("fetch"));
+                if (isNetworkError && attempt < FlowGridTransport.MAX_RETRIES) {
+                    attempt++;
+                    await this.backoff(attempt);
+                    continue;
+                }
+                // Final failure — try sendBeacon, then buffer to localStorage
+                if (attempt >= FlowGridTransport.MAX_RETRIES) {
+                    const beaconSent = body && typeof navigator !== 'undefined' && typeof navigator.sendBeacon === 'function'
+                        ? navigator.sendBeacon(url, new Blob([body], { type: 'application/json' }))
+                        : false;
+                    if (!beaconSent) {
+                        this.bufferEvent(url, method, body);
+                    }
+                }
+                if (error instanceof Error && error.name === "AbortError") {
+                    throw new Error("SDK request timed out");
+                }
+                throw error;
+            }
+        }
+    }
+    /**
+     * Exponential backoff: 1s, 2s, 4s ...
+     */
+    backoff(attempt) {
+        const ms = Math.pow(2, attempt - 1) * 1000;
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Validates event name and payload.
+     *
+     * @param eventName - Event identifier.
+     * @param properties - Associated event properties.
+     *
+     * @throws {Error} If validation fails.
+     */
+    validateInput(eventName, properties) {
+        if (!eventName || typeof eventName !== "string" || !eventName.trim()) {
+            throw new Error("Event name must be a non-empty string");
+        }
+        if (eventName.length > 100) {
+            throw new Error("Event name must be less than 100 characters");
+        }
+        let serialized;
+        try {
+            serialized = JSON.stringify({
+                web_id: this.webId,
+                visitor_id: this.visitorId ?? '',
+                event_name: eventName,
+                properties,
+            });
+        }
+        catch {
+            throw new Error("Properties must be JSON serializable");
+        }
+        if (new TextEncoder().encode(serialized).length > FlowGridTransport.MAX_PAYLOAD_SIZE) {
+            throw new Error("Event payload too large (max 10KB)");
+        }
+        const sensitiveKeys = ["password", "token", "secret", "apikey", "authorization"];
+        const lower = serialized.toLowerCase();
+        for (const key of sensitiveKeys) {
+            if (lower.includes(key)) {
+                console.warn(`SDK Warning: Properties may contain sensitive data (${key}).`);
+            }
+        }
+    }
+    /**
+     * Normalizes endpoint input.
+     * Ensures protocol is present and removes trailing slashes.
+     *
+     * @param endpoint - Raw endpoint string.
+     * @returns Normalized endpoint URL.
+     */
+    normalizeEndpoint(endpoint) {
+        let clean = endpoint.trim();
+        if (!clean.startsWith("http://") && !clean.startsWith("https://")) {
+            clean = `https://${clean}`;
+        }
+        return clean.replace(/\/+$/, "");
+    }
+    /**
+     * Safely reads response text without throwing.
+     *
+     * @param res - Fetch Response object.
+     * @returns Response text or empty string.
+     */
+    async safeRead(res) {
+        try {
+            return await res.text();
+        }
+        catch {
+            return "";
+        }
+    }
+}
+/**
+ * Maximum allowed payload size (in bytes).
+ * Prevents oversized event submissions.
+ */
+FlowGridTransport.MAX_PAYLOAD_SIZE = 10000; // 10KB
+/**
+ * Maximum time (ms) before request is aborted.
+ */
+FlowGridTransport.TIMEOUT_MS = 10000;
+/**
+ * Maximum retry attempts for network-level failures and 5xx server errors.
+ */
+FlowGridTransport.MAX_RETRIES = 3;
+/** Max events to persist in localStorage buffer */
+FlowGridTransport.MAX_BUFFER_EVENTS = 100;
+/** Max buffer size in bytes */
+FlowGridTransport.MAX_BUFFER_SIZE = 50000; // 50KB
+/** localStorage key for failed event buffer */
+FlowGridTransport.EVENT_BUFFER_KEY = 'fg_event_buffer';
+/** Consent state */
+FlowGridTransport.consent = { analytics: true, marketing: true };
+//# sourceMappingURL=transport.js.map

package/dist/lib/client/transport.js.map

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

package/dist/lib/consent/index.d.ts

@@ -26,11 +26,6 @@
  * }
  * ```
  *
- * ## Framework Components
- *
- * - **React / Next.js**: `import { CookieBanner } from 'flowgrid-sdk/react'`
- * - **Vue / Nuxt**: `import { CookieBanner } from 'flowgrid-sdk/vue'`
- *
  * @see {@link ConsentManager} for the core API.
  */
 export { ConsentManager } from './manager';

package/dist/lib/consent/index.js

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview FlowGrid Consent Management Module
+ * @module consent
+ *
+ * @description
+ * Cookie consent management for GDPR, CCPA, and ePrivacy compliance.
+ * Provides a framework-agnostic {@link ConsentManager} and types for
+ * building customisable cookie banner components.
+ *
+ * ## Quick Start
+ *
+ * ```ts
+ * import { ConsentManager, FlowGridTransport } from 'flowgrid-sdk';
+ *
+ * const consent = new ConsentManager({
+ *   onChange: (prefs) => {
+ *     FlowGridTransport.setConsent({
+ *       analytics: prefs.analytics,
+ *       marketing: prefs.marketing,
+ *     });
+ *   },
+ * });
+ *
+ * if (!consent.hasConsented()) {
+ *   // Show your cookie banner
+ * }
+ * ```
+ *
+ * @see {@link ConsentManager} for the core API.
+ */
+export { ConsentManager } from './manager';
+//# sourceMappingURL=index.js.map

package/dist/lib/consent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/consent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}