@funnelfox/billing 0.7.1 → 0.8.0-add-release-docs.8

package/dist/funnelfox-billing.js

@@ -374,6 +374,9 @@
             return v.toString(16);
         });
     }
+    function isBrowser() {
+        return typeof window !== 'undefined' && typeof document !== 'undefined';
+    }
     function sleep(ms) {
         return new Promise(resolve => setTimeout(resolve, ms));
     }
@@ -492,7 +495,7 @@
     /**
      * @fileoverview Constants for Funnefox SDK
      */
-    const SDK_VERSION = '0.7.1';
+    const SDK_VERSION = '0.8.0-add-release-docs.8';
     const DEFAULTS = {
         BASE_URL: 'https://billing.funnelfox.com',
         REGION: 'default',
@@ -726,7 +729,7 @@
             }
             catch (error) {
                 onMethodRenderError(allowedPaymentMethod);
-                throw new PrimerError('Failed to initialize Primer checkout', error);
+                throw new PrimerError(`Failed to initialize Primer checkout method ${allowedPaymentMethod}`, error);
             }
         }
         async initMethod(method, htmlNode, options) {
@@ -760,7 +763,7 @@
                 }
             }
             catch (error) {
-                throw new PrimerError('Failed to initialize Primer checkout', error);
+                throw new PrimerError(`Failed to initialize Primer checkout method ${method}`, error);
             }
         }
         async renderCardCheckoutWithElements(elements, { onSubmit, onInputChange, onCardInputValueChange, isCardholderNameRequired, isPostalCodeRequired, onMethodRenderError, onMethodRender, }) {
@@ -920,7 +923,7 @@
             }
             catch (error) {
                 onMethodRenderError(exports.PaymentMethod.PAYMENT_CARD);
-                throw new PrimerError('Failed to initialize Primer checkout', error);
+                throw new PrimerError('Failed to initialize Primer checkout method PAYMENT_CARD', error);
             }
         }
         async initializeHeadlessCheckout(clientToken, primerOptions, method) {
@@ -1060,6 +1063,9 @@
             }
             return element;
         }
+        refreshClientSession() {
+            return this.currentHeadless?.then(headless => headless.refreshClientSession());
+        }
     }
     PrimerWrapper.headlessManager = new HeadlessManager();
 
@@ -1499,6 +1505,216 @@
         });
     }
 
+    const MAX_QUERY_LENGTH = 1800;
+    function getErrorImage(orgId, options) {
+        if (typeof document === 'undefined') {
+            return;
+        }
+        const params = new URLSearchParams({
+            message: truncate(options.message, 500),
+            code: options.code || 'SDK_ERROR',
+            timestamp: Date.now().toString(),
+            sdk_version: SDK_VERSION,
+        });
+        if (options.req_id) {
+            appendIfFits(params, 'req_id', options.req_id, MAX_QUERY_LENGTH);
+        }
+        if (options.context) {
+            Object.entries(options.context).forEach(([key, value]) => {
+                if (value !== undefined && value !== null) {
+                    appendIfFits(params, key, truncate(String(value), 1000), MAX_QUERY_LENGTH);
+                }
+            });
+        }
+        const origin = (options.baseUrl || DEFAULTS.BASE_URL).replace(/\/$/, '');
+        const url = `${origin}/sdk_report/${encodeURIComponent(orgId)}/crash?${params.toString()}`;
+        const img = new Image();
+        img.src = url;
+        img.style.display = 'none';
+        img.onload = () => {
+            img.remove();
+        };
+        img.onerror = () => {
+            img.remove();
+        };
+        (document.body || document.documentElement)?.appendChild(img);
+    }
+    function truncate(value, maxLength) {
+        return value.length > maxLength ? value.slice(0, maxLength) : value;
+    }
+    function appendIfFits(params, key, value, maxLength) {
+        const nextParams = new URLSearchParams(params);
+        nextParams.append(key, value);
+        if (nextParams.toString().length > maxLength) {
+            return false;
+        }
+        params.append(key, value);
+        return true;
+    }
+
+    let activeScope = null;
+    const recentSignatures = new Map();
+    const DEDUPE_WINDOW_MS = 3000;
+    let isListening = false;
+    function startUnhandledErrorTelemetry(scope) {
+        if (!scope.enabled || !isBrowser()) {
+            return () => { };
+        }
+        activeScope = scope;
+        attachListeners();
+        return () => {
+            stopUnhandledErrorTelemetry(scope.id);
+        };
+    }
+    function stopUnhandledErrorTelemetry(scopeId) {
+        if (activeScope?.id === scopeId) {
+            activeScope = null;
+            recentSignatures.clear();
+            detachListeners();
+        }
+    }
+    function attachListeners() {
+        if (isListening || typeof window === 'undefined') {
+            return;
+        }
+        window.addEventListener('error', handleWindowError);
+        window.addEventListener('unhandledrejection', handleUnhandledRejection);
+        isListening = true;
+    }
+    function detachListeners() {
+        if (!isListening || typeof window === 'undefined') {
+            return;
+        }
+        window.removeEventListener('error', handleWindowError);
+        window.removeEventListener('unhandledrejection', handleUnhandledRejection);
+        isListening = false;
+    }
+    function handleWindowError(event) {
+        const normalized = normalizeError(event.error || event.message || 'Unhandled browser error', 'UNHANDLED_ERROR');
+        reportToActiveScopes(normalized, {
+            event_type: 'error',
+            filename: event.filename,
+            lineno: event.lineno,
+            colno: event.colno,
+        });
+    }
+    function handleUnhandledRejection(event) {
+        const normalized = normalizeError(event.reason || 'Unhandled promise rejection', 'UNHANDLED_REJECTION');
+        reportToActiveScopes(normalized, {
+            event_type: 'unhandledrejection',
+        });
+    }
+    function reportToActiveScopes(error, eventContext) {
+        if (!activeScope) {
+            return;
+        }
+        if (!canReport(error, eventContext.event_type)) {
+            return;
+        }
+        try {
+            const context = activeScope.getContext();
+            getErrorImage(activeScope.orgId, {
+                baseUrl: activeScope.baseUrl,
+                message: `${error.name}: ${error.message}`,
+                code: error.code,
+                context: {
+                    ...eventContext,
+                    order_id: context.orderId,
+                    price_id: context.priceId,
+                    page_url: getPageUrl(),
+                },
+            });
+        }
+        catch {
+            // Telemetry must never affect checkout behavior.
+        }
+    }
+    function canReport(error, eventType) {
+        const now = Date.now();
+        pruneExpiredSignatures(now);
+        const signature = buildSignature(error, eventType);
+        const previousReportTime = recentSignatures.get(signature);
+        if (typeof previousReportTime === 'number' &&
+            now - previousReportTime < DEDUPE_WINDOW_MS) {
+            return false;
+        }
+        recentSignatures.set(signature, now);
+        return true;
+    }
+    function pruneExpiredSignatures(now) {
+        recentSignatures.forEach((timestamp, signature) => {
+            if (now - timestamp >= DEDUPE_WINDOW_MS) {
+                recentSignatures.delete(signature);
+            }
+        });
+    }
+    function buildSignature(error, eventType) {
+        const firstStackLine = error.stack?.split('\n')[0] || '';
+        return [
+            eventType || '',
+            error.code || '',
+            error.message || '',
+            firstStackLine,
+        ].join('|');
+    }
+    function normalizeError(reason, fallbackCode) {
+        if (reason instanceof Error) {
+            return {
+                name: reason.name || 'Error',
+                message: reason.message || 'Unknown error',
+                code: getErrorCode(reason, fallbackCode),
+                stack: reason.stack,
+            };
+        }
+        if (typeof reason === 'object' && reason !== null) {
+            const record = reason;
+            return {
+                name: toSafeString(record.name) || 'Error',
+                message: toSafeString(record.message) || safeStringify(reason),
+                code: toSafeString(record.code) || fallbackCode,
+                stack: toSafeString(record.stack),
+            };
+        }
+        return {
+            name: 'Error',
+            message: toSafeString(reason) || 'Unknown error',
+            code: fallbackCode,
+        };
+    }
+    function getErrorCode(error, fallbackCode) {
+        const record = error;
+        return typeof record.code === 'string' && record.code
+            ? record.code
+            : fallbackCode;
+    }
+    function toSafeString(value) {
+        if (typeof value === 'string') {
+            return value;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean') {
+            return String(value);
+        }
+        return '';
+    }
+    function safeStringify(value) {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return 'Unserializable error';
+        }
+    }
+    function getPageUrl() {
+        if (typeof window === 'undefined' || !window.location) {
+            return '';
+        }
+        const location = window.location;
+        if (location.origin && location.pathname) {
+            return `${location.origin}${location.pathname}`;
+        }
+        return (location.href || '').split(/[?#]/)[0];
+    }
+
     /**
      * @fileoverview Checkout instance manager for Funnefox SDK
      */
@@ -1508,6 +1724,8 @@
             this.counter = 0;
             this.cachedSessionResponse = null;
             this.cardSessionFieldConfig = {};
+            this.isTelemetryEnabled = false;
+            this.telemetryCleanup = null;
             this.handleInputChange = (inputName, error) => {
                 this.emit(EVENTS.INPUT_ERROR, { name: inputName, error });
             };
@@ -1670,6 +1888,7 @@
                 await this.createSession();
                 await this._initializePrimerCheckout();
                 this._setState('ready');
+                this.startUnhandledTelemetry();
                 this.checkoutConfig?.onInitialized?.();
                 return this;
             }
@@ -1744,6 +1963,7 @@
                 sessionResponse = await sessionRequest;
             }
             this.cachedSessionResponse = sessionResponse;
+            this.isTelemetryEnabled = !!sessionResponse.data?.sdk_telemetry_enabled;
             this.isCollectingApplePayEmail =
                 !!sessionResponse.data?.collect_apple_pay_email;
             this.applySessionCardFieldConfig(sessionResponse);
@@ -1997,6 +2217,7 @@
                 throw new CheckoutError('Cannot update price while payment is processing');
             }
             try {
+                this.onLoaderChangeWithRace(true);
                 this._setState('updating');
                 // Invalidate session cache
                 CheckoutInstance.sessionCache.clear();
@@ -2007,9 +2228,12 @@
                     clientMetadata,
                 });
                 this.checkoutConfig.priceId = newPriceId;
+                await this.primerWrapper.refreshClientSession();
+                this.onLoaderChangeWithRace(false);
                 this._setState('ready');
             }
             catch (error) {
+                this.onLoaderChangeWithRace(false);
                 this._setState('error');
                 this.emit(EVENTS.ERROR, error);
                 throw error;
@@ -2028,6 +2252,7 @@
             if (this.isDestroyed)
                 return;
             try {
+                this.stopUnhandledTelemetry();
                 CheckoutInstance.sessionCache.clear();
                 await this.primerWrapper.destroy();
                 this._setState('destroyed');
@@ -2202,6 +2427,7 @@
             }
             await this.primerWrapper.initializeHeadlessCheckout(this.clientToken, checkoutOptions, method);
             const methodInterface = await this.primerWrapper.initMethod(method, element, methodOptions);
+            this.startUnhandledTelemetry(method);
             return {
                 ...methodInterface,
                 destroy: async () => {
@@ -2210,25 +2436,35 @@
                 },
             };
         }
-    }
-    CheckoutInstance.sessionCache = new Map();
-
-    function getErrorImage(orgId, options) {
-        const params = new URLSearchParams({
-            message: options.message,
-            code: options.code,
-            timestamp: Date.now().toString(),
-            sdk_version: SDK_VERSION,
-        });
-        if (options.req_id) {
-            params.append('req_id', options.req_id);
+        startUnhandledTelemetry(paymentMethod) {
+            if (paymentMethod) {
+                this.telemetryPaymentMethod = paymentMethod;
+            }
+            if (!this.isTelemetryEnabled || this.telemetryCleanup) {
+                return;
+            }
+            this.telemetryCleanup = startUnhandledErrorTelemetry({
+                id: this.id,
+                orgId: this.orgId,
+                baseUrl: this.baseUrl,
+                enabled: this.isTelemetryEnabled,
+                getContext: () => ({
+                    checkoutId: this.id,
+                    orderId: this.orderId,
+                    priceId: this.checkoutConfig.priceId,
+                    state: this.state,
+                    paymentMethod: this.telemetryPaymentMethod,
+                    reqId: this.cachedSessionResponse?.req_id,
+                }),
+            });
+        }
+        stopUnhandledTelemetry() {
+            this.telemetryCleanup?.();
+            this.telemetryCleanup = null;
+            this.telemetryPaymentMethod = undefined;
         }
-        const url = `https://billing.funnelfox.com/sdk_report/${encodeURIComponent(orgId)}/crash?${params.toString()}`;
-        const img = new Image();
-        img.src = url;
-        img.style.display = 'none';
-        document.body.appendChild(img);
     }
+    CheckoutInstance.sessionCache = new Map();
 
     /**
      * @fileoverview Public API with configuration and orchestration logic
@@ -2269,6 +2505,7 @@
         }
         catch (error) {
             getErrorImage(options.orgId, {
+                baseUrl: options.apiConfig?.baseUrl,
                 message: error.message,
                 code: error.code,
                 req_id: error?.response?.req_id,
@@ -2320,6 +2557,7 @@
         }
         catch (error) {
             getErrorImage(orgId, {
+                baseUrl,
                 message: error.message,
                 code: error.code,
                 req_id: error?.response?.req_id,
@@ -2370,6 +2608,7 @@
         }
         catch (error) {
             getErrorImage(options.orgId, {
+                baseUrl: options.baseUrl,
                 message: error.message,
                 code: error.code,
                 req_id: error?.response?.req_id,
@@ -2408,6 +2647,7 @@
         }
         catch (error) {
             getErrorImage(params.orgId, {
+                baseUrl: params.baseUrl,
                 message: error.message,
                 code: error.code,
                 req_id: error?.response?.req_id,
@@ -2430,6 +2670,7 @@
     if (typeof window !== 'undefined') {
         window.Billing = Billing;
     }
+    console.debug('Billing SDK inited');
 
     var template$1 = "<div class=\"ff-skin-default\" id=\"ff-payment-method-containers\">\n  <div id=\"success-screen\" style=\"display: none\">\n    <div class=\"success\">\n      <img alt=\"Loading\" src=\"data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTAiIGhlaWdodD0iNTAiIHZpZXdCb3g9IjAgMCA1MCA1MCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTI1IDAuMTExMzI4QzIwLjA3NzQgMC4xMTEzMjggMTUuMjY1NCAxLjU3MTA0IDExLjE3MjUgNC4zMDU4NkM3LjA3OTUyIDcuMDQwNjkgMy44ODk0NSAxMC45Mjc4IDIuMDA1NjYgMTUuNDc1N0MwLjEyMTg4MyAyMC4wMjM1IC0wLjM3MSAyNS4wMjc4IDAuNTg5MzQzIDI5Ljg1NThDMS41NDk2OSAzNC42ODM4IDMuOTIwMTIgMzkuMTE4NSA3LjQwMDkgNDIuNTk5M0MxMC44ODE3IDQ2LjA4MDEgMTUuMzE2NCA0OC40NTA1IDIwLjE0NDQgNDkuNDEwOUMyNC45NzI0IDUwLjM3MTIgMjkuOTc2NyA0OS44NzgzIDM0LjUyNDYgNDcuOTk0NkMzOS4wNzI0IDQ2LjExMDggNDIuOTU5NSA0Mi45MjA3IDQ1LjY5NDQgMzguODI3N0M0OC40MjkyIDM0LjczNDggNDkuODg4OSAyOS45MjI4IDQ5Ljg4ODkgMjUuMDAwMkM0OS44ODg5IDE4LjM5OTMgNDcuMjY2NyAxMi4wNjg3IDQyLjU5OTEgNy40MDExMkMzNy45MzE1IDIuNzMzNTQgMzEuNjAwOSAwLjExMTMyOCAyNSAwLjExMTMyOFpNNDEuMjU1NiAxNi42NDY5TDIwLjgxNTYgMzcuMDcxM0w4Ljc0NDQ0IDI1LjAwMDJDOC4zMzE4OCAyNC41ODc3IDguMTAwMTEgMjQuMDI4MSA4LjEwMDExIDIzLjQ0NDdDOC4xMDAxMSAyMi44NjEyIDguMzMxODggMjIuMzAxNyA4Ljc0NDQ0IDIxLjg4OTFDOS4xNTcgMjEuNDc2NSA5LjcxNjU1IDIxLjI0NDggMTAuMyAyMS4yNDQ4QzEwLjg4MzQgMjEuMjQ0OCAxMS40NDMgMjEuNDc2NSAxMS44NTU2IDIxLjg4OTFMMjAuODQ2NyAzMC44ODAyTDM4LjE3NTYgMTMuNTY2OUMzOC4zNzk4IDEzLjM2MjYgMzguNjIyMyAxMy4yMDA2IDM4Ljg4OTIgMTMuMDlDMzkuMTU2MiAxMi45Nzk1IDM5LjQ0MjIgMTIuOTIyNiAzOS43MzExIDEyLjkyMjZDNDAuMDIgMTIuOTIyNiA0MC4zMDYxIDEyLjk3OTUgNDAuNTczIDEzLjA5QzQwLjgzOTkgMTMuMjAwNiA0MS4wODI0IDEzLjM2MjYgNDEuMjg2NyAxMy41NjY5QzQxLjQ5MDkgMTMuNzcxMiA0MS42NTMgMTQuMDEzNyA0MS43NjM1IDE0LjI4MDZDNDEuODc0MSAxNC41NDc1IDQxLjkzMSAxNC44MzM1IDQxLjkzMSAxNS4xMjI0QzQxLjkzMSAxNS40MTEzIDQxLjg3NDEgMTUuNjk3NCA0MS43NjM1IDE1Ljk2NDNDNDEuNjUzIDE2LjIzMTIgNDEuNDkwOSAxNi40NzM3IDQxLjI4NjcgMTYuNjc4TDQxLjI1NTYgMTYuNjQ2OVoiIGZpbGw9IiM4RURGQzIiLz4KPC9zdmc+Cg==\">\n      <div>Payment completed successfully</div>\n    </div>\n  </div>\n</div>\n";