@chordcommerce/analytics 1.19.0 → 1.21.0

package/dist/cjs/client/index.d.ts

@@ -1,4 +1,4 @@
-import type { AnyAnalytics, EventProperties, Options, ValidateResult, ChordAnalyticsOptions, AnyOptions, CartViewedInput, IdentifyTraits, CheckoutStartedInput, CheckoutStepCompletedInput, CheckoutStepViewedInput, EmailCapturedInput, ProductListViewedInput, ProductListFilteredInput, ProductAddedInput, ProductClickedInput, VariantClickedInput, ProductRemovedInput, ProductViewedInput, ProductsSearchedInput, CouponAppliedInput, CouponDeniedInput, CouponEnteredInput, CouponRemovedInput, SignedInInput, SignedOutInput, SignedUpInput, LoginStartedInput, ObjectTypes, SubscriptionCancelledInput, NavigationClickedInput, PaymentInfoEnteredInput } from '../types/index.js';
+import type { AnyAnalytics, EventProperties, Options, ValidateResult, ChordAnalyticsOptions, AnyOptions, CartViewedInput, IdentifyTraits, CheckoutStartedInput, CheckoutStepCompletedInput, CheckoutStepViewedInput, EmailCapturedInput, ProductListViewedInput, ProductListFilteredInput, ProductAddedInput, ProductClickedInput, VariantClickedInput, ProductRemovedInput, ProductViewedInput, ProductsSearchedInput, CouponAppliedInput, CouponDeniedInput, CouponEnteredInput, CouponRemovedInput, SignedInInput, SignedOutInput, SignedUpInput, LoginStartedInput, ObjectTypes, OrderCompletedInput, SubscriptionCancelledInput, NavigationClickedInput, PaymentInfoEnteredInput } from '../types/index.js';
 import { AnalyticsMiddleware } from '../types/client.js';
 export interface ChordAnalyticsSnippet {
     _loadOptions: ChordAnalyticsOptions<ObjectTypes>;
@@ -45,6 +45,20 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
      */
     private consentReadyPromise;
     constructor(options: ChordAnalyticsOptions<T>);
+    /**
+     * Persist the consent event queue to sessionStorage for recovery on instance recreation.
+     * Validates queue size before storing to prevent QuotaExceededError.
+     */
+    private persistQueueToStorage;
+    /**
+     * Restore pending events from sessionStorage (keeps events less than 5 min old).
+     * Called on new instance initialization.
+     */
+    private restoreQueueFromStorage;
+    /**
+     * Clear the persisted queue from sessionStorage after successful flush.
+     */
+    private clearQueueFromStorage;
     /**
      * Initialize CDP snippet and wait for it to be ready.
      * Fires initial consent track event after CDP is fully initialized to avoid circular await.
@@ -66,6 +80,7 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
     private waitForConsent;
     /**
      * Queue an event to be sent when consent is ready.
+     * Persists to sessionStorage for recovery on instance recreation.
      * Starts a consent watcher if not already active.
      */
     private queueEventForConsent;
@@ -75,6 +90,7 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
     private watchForConsentAndFlush;
     /**
      * Flush all queued events now that consent is ready.
+     * Clears sessionStorage after successful flush.
      */
     private flushConsentQueue;
     /**
@@ -159,4 +175,5 @@ export declare class ChordAnalytics<T extends ObjectTypes = ObjectTypes> {
     trackSubscriptionCancelled: (props: SubscriptionCancelledInput, options?: AnyOptions) => Promise<void>;
     trackNavigationClicked: (props: NavigationClickedInput, options?: AnyOptions) => Promise<void>;
     trackPaymentInfoEntered: (props: PaymentInfoEnteredInput, options?: AnyOptions) => Promise<void>;
+    trackOrderCompleted: (props: OrderCompletedInput, options?: AnyOptions) => Promise<void>;
 }

package/dist/cjs/client/index.js

@@ -62,6 +62,10 @@ var index_js_1 = require("./consent/index.js");
 var index_js_2 = require("../validators/index.js");
 var utils_js_1 = require("../utils.js");
 var DEBUG_MODE_STORAGE_KEY = 'chordcommerce/analytics/debug';
+var CONSENT_QUEUE_STORAGE_KEY = 'chordcommerce/analytics/consent-queue';
+var CONSENT_QUEUE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+var CONSENT_QUEUE_MAX_SIZE_BYTES = 100 * 1024; // 100KB max queue size
+var CONSENT_QUEUE_MAX_EVENTS = 50; // Max number of events to queue
 var ChordAnalytics = /** @class */ (function () {
     function ChordAnalytics(options) {
         var _this = this;
@@ -96,6 +100,123 @@ var ChordAnalytics = /** @class */ (function () {
          * Promise that resolves when consent is ready (shared across all queued events)
          */
         this.consentReadyPromise = null;
+        /**
+         * Persist the consent event queue to sessionStorage for recovery on instance recreation.
+         * Validates queue size before storing to prevent QuotaExceededError.
+         */
+        this.persistQueueToStorage = function () {
+            if (typeof window === 'undefined' || !window.sessionStorage)
+                return;
+            try {
+                // Limit number of events to prevent unbounded queue growth
+                var eventsToStore = _this.consentEventQueue.slice(-CONSENT_QUEUE_MAX_EVENTS);
+                var persistedEvents = eventsToStore.map(function (item) { return ({
+                    type: item.type,
+                    args: item.args,
+                    timestamp: item.timestamp,
+                }); });
+                var serialized = JSON.stringify(persistedEvents);
+                // Check serialized size before attempting to store
+                var sizeInBytes = new Blob([serialized]).size;
+                if (sizeInBytes > CONSENT_QUEUE_MAX_SIZE_BYTES) {
+                    _this.logger("[Chord Analytics]: Consent queue too large (".concat(Math.round(sizeInBytes / 1024), "KB), skipping persistence"));
+                    return;
+                }
+                window.sessionStorage.setItem(CONSENT_QUEUE_STORAGE_KEY, serialized);
+            }
+            catch (error) {
+                _this.logger('[Chord Analytics]: Error persisting queue to storage:', error);
+            }
+        };
+        /**
+         * Restore pending events from sessionStorage (keeps events less than 5 min old).
+         * Called on new instance initialization.
+         */
+        this.restoreQueueFromStorage = function () {
+            if (typeof window === 'undefined' || !window.sessionStorage)
+                return;
+            try {
+                var stored = window.sessionStorage.getItem(CONSENT_QUEUE_STORAGE_KEY);
+                if (!stored)
+                    return;
+                var persistedEvents = void 0;
+                try {
+                    persistedEvents = JSON.parse(stored);
+                }
+                catch (parseError) {
+                    _this.logger('[Chord Analytics]: Invalid JSON in stored consent queue, clearing storage:', parseError);
+                    window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+                    return;
+                }
+                // Validate that parsed data is an array
+                if (!Array.isArray(persistedEvents)) {
+                    _this.logger('[Chord Analytics]: Stored consent queue is not an array, clearing storage');
+                    window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+                    return;
+                }
+                var now_1 = Date.now();
+                // Filter out expired events and events with invalid structure
+                var validEvents = persistedEvents.filter(function (event) {
+                    // Validate event structure
+                    if (typeof event !== 'object' || event === null)
+                        return false;
+                    if (!['track', 'page', 'identify'].includes(event.type))
+                        return false;
+                    if (!Array.isArray(event.args))
+                        return false;
+                    if (typeof event.timestamp !== 'number')
+                        return false;
+                    // Filter out expired events
+                    return now_1 - event.timestamp < CONSENT_QUEUE_TTL_MS;
+                });
+                if (validEvents.length === 0) {
+                    window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+                    return;
+                }
+                if (_this.options.enableLogging && _this.options.debug) {
+                    // eslint-disable-next-line no-console
+                    console.log("[Chord Analytics DEBUG]: Restoring ".concat(validEvents.length, " events from sessionStorage"));
+                }
+                // Add restored events to the queue
+                validEvents.forEach(function (event) {
+                    _this.consentEventQueue.push({
+                        type: event.type,
+                        args: event.args,
+                        timestamp: event.timestamp,
+                        // eslint-disable-next-line @typescript-eslint/no-empty-function
+                        resolve: function () { },
+                    });
+                });
+                // Start watching for consent if we restored events
+                if (validEvents.length > 0 && !_this.consentWatcherActive) {
+                    _this.consentWatcherActive = true;
+                    _this.watchForConsentAndFlush();
+                }
+            }
+            catch (error) {
+                _this.logger('[Chord Analytics]: Error restoring queue from storage:', error);
+                // Clear corrupted storage
+                try {
+                    window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+                }
+                catch (_a) {
+                    // Ignore cleanup errors
+                }
+            }
+        };
+        /**
+         * Clear the persisted queue from sessionStorage after successful flush.
+         */
+        this.clearQueueFromStorage = function () {
+            if (typeof window === 'undefined' || !window.sessionStorage)
+                return;
+            try {
+                window.sessionStorage.removeItem(CONSENT_QUEUE_STORAGE_KEY);
+            }
+            catch (error) {
+                _this.logger('[Chord Analytics]: Error clearing queue from storage:', error);
+            }
+        };
         /**
          * Set debug mode for Chord Analytics
          * @param enabled - Whether debug mode should be enabled
@@ -180,11 +301,19 @@ var ChordAnalytics = /** @class */ (function () {
         }); };
         /**
          * Queue an event to be sent when consent is ready.
+         * Persists to sessionStorage for recovery on instance recreation.
          * Starts a consent watcher if not already active.
          */
         this.queueEventForConsent = function (type, args) {
             return new Promise(function (resolve) {
-                _this.consentEventQueue.push({ type: type, args: args, resolve: resolve });
+                _this.consentEventQueue.push({
+                    type: type,
+                    args: args,
+                    timestamp: Date.now(),
+                    resolve: resolve,
+                });
+                // Persist queue to sessionStorage for recovery on instance recreation
+                _this.persistQueueToStorage();
                 // Start watching for consent if not already
                 if (!_this.consentWatcherActive) {
                     _this.consentWatcherActive = true;
@@ -211,6 +340,7 @@ var ChordAnalytics = /** @class */ (function () {
         }); };
         /**
          * Flush all queued events now that consent is ready.
+         * Clears sessionStorage after successful flush.
          */
         this.flushConsentQueue = function () { return __awaiter(_this, void 0, void 0, function () {
             var queue, sendPromises;
@@ -220,6 +350,12 @@ var ChordAnalytics = /** @class */ (function () {
                     case 0:
                         queue = __spreadArray([], this.consentEventQueue, true);
                         this.consentEventQueue = [];
+                        // Clear persisted queue from storage since we're processing them now
+                        this.clearQueueFromStorage();
+                        if (this.options.enableLogging && this.options.debug) {
+                            // eslint-disable-next-line no-console
+                            console.log("[Chord Analytics DEBUG]: Flushing ".concat(queue.length, " queued events"));
+                        }
                         sendPromises = queue.map(function (item) { return __awaiter(_this, void 0, void 0, function () {
                             var _a, error_1;
                             return __generator(this, function (_b) {
@@ -425,12 +561,7 @@ var ChordAnalytics = /** @class */ (function () {
                                         }));
                                     }
                                     if (cdpPromises.length > 0) {
-                                        Promise.allSettled(cdpPromises)
-                                            .then(function () { return resolve(); })
-                                            .catch(function (error) {
-                                            _this.logger(error);
-                                            resolve();
-                                        });
+                                        Promise.allSettled(cdpPromises).then(function () { return resolve(); });
                                     }
                                     else {
                                         resolve();
@@ -564,34 +695,50 @@ var ChordAnalytics = /** @class */ (function () {
         this.sendPageEvent = function (options, props) {
             if (props === void 0) { props = {}; }
             return __awaiter(_this, void 0, void 0, function () {
-                var pagePromises, a_3, b_3;
                 var _this = this;
                 return __generator(this, function (_a) {
-                    // Configure CDP with fresh consent before sending
-                    this.configureConsentOnCdp();
-                    try {
-                        pagePromises = [];
-                        a_3 = this.ccdp();
-                        if (a_3 && typeof a_3.page === 'function') {
-                            pagePromises.push(new Promise(function (resolve) {
-                                a_3.page(__assign(__assign({}, props), { meta: _this.meta() }), options, function () { return resolve(); });
-                            }));
-                        }
-                        b_3 = this.cdp();
-                        if (b_3 && typeof b_3.page === 'function') {
-                            pagePromises.push(new Promise(function (resolve) {
-                                b_3.page(__assign(__assign({}, props), { meta: _this.meta() }), options, function () { return resolve(); });
-                            }));
-                        }
-                        // We don't return the promise to maintain the void return type
-                        Promise.allSettled(pagePromises).then(function (results) {
-                            _this.logger('page event sent', results);
-                        });
-                    }
-                    catch (error) {
-                        this.logger(error);
+                    switch (_a.label) {
+                        case 0:
+                            // Configure CDP with fresh consent before sending
+                            this.configureConsentOnCdp();
+                            return [4 /*yield*/, new Promise(function (resolve) {
+                                    var pagePromises = [];
+                                    try {
+                                        var a_3 = _this.ccdp();
+                                        if (a_3 && typeof a_3.page === 'function') {
+                                            pagePromises.push(new Promise(function (cdpResolve) {
+                                                a_3.page(__assign(__assign({}, props), { meta: _this.meta() }), options, function () {
+                                                    return cdpResolve();
+                                                });
+                                            }));
+                                        }
+                                        var b_3 = _this.cdp();
+                                        if (b_3 && typeof b_3.page === 'function') {
+                                            pagePromises.push(new Promise(function (cdpResolve) {
+                                                b_3.page(__assign(__assign({}, props), { meta: _this.meta() }), options, function () {
+                                                    return cdpResolve();
+                                                });
+                                            }));
+                                        }
+                                        if (pagePromises.length > 0) {
+                                            Promise.allSettled(pagePromises).then(function (results) {
+                                                _this.logger('page event sent', results);
+                                                resolve();
+                                            });
+                                        }
+                                        else {
+                                            resolve();
+                                        }
+                                    }
+                                    catch (error) {
+                                        _this.logger(error);
+                                        resolve();
+                                    }
+                                })];
+                        case 1:
+                            _a.sent();
+                            return [2 /*return*/];
                     }
-                    return [2 /*return*/];
                 });
             });
         };
@@ -1101,6 +1248,85 @@ var ChordAnalytics = /** @class */ (function () {
                 return [2 /*return*/, this.track('Payment Info Entered', payload, options)];
             });
         }); };
+        this.trackOrderCompleted = function (props, options) { return __awaiter(_this, void 0, void 0, function () {
+            var formatter, payload, formattedPayload;
+            var _a, _b, _c, _d;
+            return __generator(this, function (_e) {
+                formatter = (_c = (_b = (_a = this.options) === null || _a === void 0 ? void 0 : _a.formatters) === null || _b === void 0 ? void 0 : _b.events) === null || _c === void 0 ? void 0 : _c.orderCompleted;
+                payload = {
+                    affiliation: props === null || props === void 0 ? void 0 : props.affiliation,
+                    campaign_id: props === null || props === void 0 ? void 0 : props.campaignId,
+                    category: props === null || props === void 0 ? void 0 : props.category,
+                    channel: props === null || props === void 0 ? void 0 : props.channel,
+                    checkout_id: props === null || props === void 0 ? void 0 : props.checkoutId,
+                    checkout_type: props === null || props === void 0 ? void 0 : props.checkoutType,
+                    coupon: props === null || props === void 0 ? void 0 : props.coupon,
+                    currency: props === null || props === void 0 ? void 0 : props.currency,
+                    discount: props === null || props === void 0 ? void 0 : props.discount,
+                    email: props === null || props === void 0 ? void 0 : props.email,
+                    first_name: props === null || props === void 0 ? void 0 : props.firstName,
+                    has_subscription: props === null || props === void 0 ? void 0 : props.hasSubscription,
+                    is_recurring: props === null || props === void 0 ? void 0 : props.isRecurring,
+                    last_name: props === null || props === void 0 ? void 0 : props.lastName,
+                    metadata: props === null || props === void 0 ? void 0 : props.metadata,
+                    order_date: props === null || props === void 0 ? void 0 : props.orderDate,
+                    order_id: props === null || props === void 0 ? void 0 : props.orderId,
+                    phone: props === null || props === void 0 ? void 0 : props.phone,
+                    products: (_d = props === null || props === void 0 ? void 0 : props.products) === null || _d === void 0 ? void 0 : _d.map(function (p, i) {
+                        var _a;
+                        return ({
+                            affiliation: p === null || p === void 0 ? void 0 : p.affiliation,
+                            brand: p === null || p === void 0 ? void 0 : p.brand,
+                            bundle: p === null || p === void 0 ? void 0 : p.bundle,
+                            bundle_size: p === null || p === void 0 ? void 0 : p.bundleSize,
+                            category: p === null || p === void 0 ? void 0 : p.category,
+                            coupon: p === null || p === void 0 ? void 0 : p.coupon,
+                            cross_sold_quantity: p === null || p === void 0 ? void 0 : p.crossSoldQuantity,
+                            description: p === null || p === void 0 ? void 0 : p.description,
+                            image_url: p === null || p === void 0 ? void 0 : p.imageUrl,
+                            line_item_id: p === null || p === void 0 ? void 0 : p.lineItemId,
+                            name: p === null || p === void 0 ? void 0 : p.name,
+                            option_values: p === null || p === void 0 ? void 0 : p.optionValues,
+                            position: (_a = p === null || p === void 0 ? void 0 : p.position) !== null && _a !== void 0 ? _a : i + 1,
+                            price: p === null || p === void 0 ? void 0 : p.price,
+                            product_id: p === null || p === void 0 ? void 0 : p.productId,
+                            quantity: p === null || p === void 0 ? void 0 : p.quantity,
+                            revenue: p === null || p === void 0 ? void 0 : p.revenue,
+                            sku: p === null || p === void 0 ? void 0 : p.sku,
+                            slug: p === null || p === void 0 ? void 0 : p.slug,
+                            url: p === null || p === void 0 ? void 0 : p.url,
+                            variant: p === null || p === void 0 ? void 0 : p.variant,
+                            variant_metadata: p === null || p === void 0 ? void 0 : p.variantMetadata,
+                        });
+                    }),
+                    purl_link: props === null || props === void 0 ? void 0 : props.purlLink,
+                    referral_identifier_id: props === null || props === void 0 ? void 0 : props.referralIdentifierId,
+                    repeat: props === null || props === void 0 ? void 0 : props.repeat,
+                    revenue: props === null || props === void 0 ? void 0 : props.revenue,
+                    shipping: props === null || props === void 0 ? void 0 : props.shipping,
+                    shipping_city: props === null || props === void 0 ? void 0 : props.shippingCity,
+                    shipping_country: props === null || props === void 0 ? void 0 : props.shippingCountry,
+                    shipping_method_details: (props === null || props === void 0 ? void 0 : props.shippingMethodDetails)
+                        ? {
+                            shipping_code: props.shippingMethodDetails.shippingCode,
+                            shipping_method: props.shippingMethodDetails.shippingMethod,
+                        }
+                        : undefined,
+                    shipping_state: props === null || props === void 0 ? void 0 : props.shippingState,
+                    shipping_zipcode: props === null || props === void 0 ? void 0 : props.shippingZipcode,
+                    subtotal: props === null || props === void 0 ? void 0 : props.subtotal,
+                    tax: props === null || props === void 0 ? void 0 : props.tax,
+                    template_id: props === null || props === void 0 ? void 0 : props.templateId,
+                    total: props === null || props === void 0 ? void 0 : props.total,
+                    tracking_ids: props === null || props === void 0 ? void 0 : props.trackingIds,
+                };
+                if (typeof formatter === 'function') {
+                    formattedPayload = formatter(props, payload);
+                    return [2 /*return*/, this.track('Order Completed', formattedPayload, options)];
+                }
+                return [2 /*return*/, this.track('Order Completed', payload, options)];
+            });
+        }); };
         var debug = ((_a = window === null || window === void 0 ? void 0 : window.localStorage) === null || _a === void 0 ? void 0 : _a.getItem(DEBUG_MODE_STORAGE_KEY)) === 'true';
         var defaults = {
             debug: debug,
@@ -1113,6 +1339,8 @@ var ChordAnalytics = /** @class */ (function () {
             var consentManager = (0, index_js_1.addCdpConsent)(this.options);
             this.consentConfig = consentManager.getConsentConfig() || null;
         }
+        // Restore any pending events from sessionStorage (survives instance recreation)
+        this.restoreQueueFromStorage();
         if (((_b = this.options) === null || _b === void 0 ? void 0 : _b.cdpDomain) && ((_c = this.options) === null || _c === void 0 ? void 0 : _c.cdpWriteKey) && window) {
             window[this.options.namespace] = (window === null || window === void 0 ? void 0 : window[this.options.namespace]) || this;
             this.initializeCdp();

package/dist/cjs/setupTests.js

@@ -4,3 +4,26 @@ Object.defineProperty(exports, "__esModule", { value: true });
 var globals_1 = require("@jest/globals");
 // Make jest available globally
 globalThis.jest = globals_1.jest;
+// Mock sessionStorage for tests
+var sessionStorageMock = (function () {
+    var store = {};
+    return {
+        getItem: function (key) { return store[key] || null; },
+        setItem: function (key, value) {
+            store[key] = value;
+        },
+        removeItem: function (key) {
+            delete store[key];
+        },
+        clear: function () {
+            store = {};
+        },
+    };
+})();
+Object.defineProperty(window, 'sessionStorage', {
+    value: sessionStorageMock,
+});
+// Clear sessionStorage before each test to ensure test isolation
+beforeEach(function () {
+    sessionStorageMock.clear();
+});

package/dist/cjs/types/formatters.d.ts

@@ -1,6 +1,6 @@
-import type { CartViewed, CheckoutStarted, CheckoutStepCompleted, CheckoutStepViewed, ProductAdded, ProductClicked, VariantClicked, ProductViewed, ProductListViewed, CouponApplied, CouponDenied, CouponEntered, CouponRemoved, EmailCaptured, ProductListFiltered, ProductRemoved, ProductsSearched, SignedIn, SignedOut, SignedUp, LoginStarted, SubscriptionCancelled, NavigationClicked, PaymentInfoEntered } from './typewriter.js';
+import type { CartViewed, CheckoutStarted, CheckoutStepCompleted, CheckoutStepViewed, ProductAdded, ProductClicked, VariantClicked, ProductViewed, ProductListViewed, CouponApplied, CouponDenied, CouponEntered, CouponRemoved, EmailCaptured, ProductListFiltered, ProductRemoved, ProductsSearched, SignedIn, SignedOut, SignedUp, LoginStarted, OrderCompleted, SubscriptionCancelled, NavigationClicked, PaymentInfoEntered } from './typewriter.js';
 import type { Cart, Checkout, LineItem, Product } from './objects.js';
-import type { CartInput, CheckoutInput, CheckoutStepCompletedInput, CheckoutStepViewedInput, LineItemInput, ProductInput, CartViewedInput, CheckoutStartedInput, ProductAddedInput, ProductClickedInput, VariantClickedInput, ProductViewedInput, ProductListViewedInput, ProductListFilteredInput, ProductRemovedInput, CouponAppliedInput, CouponDeniedInput, CouponEnteredInput, CouponRemovedInput, EmailCapturedInput, ProductsSearchedInput, SignedInInput, SignedOutInput, SignedUpInput, LoginStartedInput, SubscriptionCancelledInput, NavigationClickedInput, PaymentInfoEnteredInput } from './input.js';
+import type { CartInput, CheckoutInput, CheckoutStepCompletedInput, CheckoutStepViewedInput, LineItemInput, ProductInput, CartViewedInput, CheckoutStartedInput, ProductAddedInput, ProductClickedInput, VariantClickedInput, ProductViewedInput, ProductListViewedInput, ProductListFilteredInput, ProductRemovedInput, CouponAppliedInput, CouponDeniedInput, CouponEnteredInput, CouponRemovedInput, EmailCapturedInput, ProductsSearchedInput, SignedInInput, SignedOutInput, SignedUpInput, LoginStartedInput, OrderCompletedInput, SubscriptionCancelledInput, NavigationClickedInput, PaymentInfoEnteredInput } from './input.js';
 import type { ObjectTypes } from './client.js';
 export type CartFormatter<T = ObjectTypes['Cart']> = (props: CartInput<T>) => Cart;
 export type CheckoutFormatter<T = ObjectTypes['Checkout']> = (props: CheckoutInput<T>) => Checkout;
@@ -78,6 +78,9 @@ export interface NavigationClickedFormatter {
 export interface PaymentInfoEnteredFormatter {
     (props: PaymentInfoEnteredInput, event: PaymentInfoEntered): PaymentInfoEntered;
 }
+export interface OrderCompletedFormatter {
+    (props: OrderCompletedInput, event: OrderCompleted): OrderCompleted;
+}
 export interface ChordAnalyticsFormatters<T extends ObjectTypes = ObjectTypes> {
     events?: {
         cartViewed?: CartViewedFormatter<T>;
@@ -104,6 +107,7 @@ export interface ChordAnalyticsFormatters<T extends ObjectTypes = ObjectTypes> {
         subscriptionCancelled?: SubscriptionCancelledFormatter;
         navigationClicked?: NavigationClickedFormatter;
         paymentInfoEntered?: PaymentInfoEnteredFormatter;
+        orderCompleted?: OrderCompletedFormatter;
     };
     objects: {
         cart: CartFormatter<T['Cart']>;