@chordcommerce/analytics 1.24.1 → 1.24.3

package/README.md

@@ -127,7 +127,7 @@ event in that order.
 
 A middleware may be synchronous or asynchronous. Synchronous middleware is never
 awaited, so it adds no delay to event delivery. Asynchronous middleware is
-awaited before the event is sent, capped at one second — a middleware that has
+awaited before the event is sent, capped at three seconds — a middleware that has
 not resolved by then is abandoned, a warning is logged, and the event is sent
 without its properties. A middleware that throws or rejects is logged and
 skipped. A middleware never prevents an event from being sent.
@@ -174,7 +174,7 @@ Useage Example
     };
   });
 
-  // Asynchronous middleware: the event waits for the lookup, up to one second.
+  // Asynchronous middleware: the event waits for the lookup, up to three seconds.
   analytics.addSourceMiddleware(async ({ payload }) => {
     if (payload.obj.event !== 'Order Completed') return;
 

package/dist/cjs/client/consent/index.js

@@ -171,7 +171,7 @@ var addCdpConsent = function (options) {
      * or null if consent setup failed or was blocked.
      */
     var init = function () { return __awaiter(void 0, void 0, void 0, function () {
-        var canBeTracked, error_2;
+        var canBeTracked, error_2, error_3;
         return __generator(this, function (_a) {
             switch (_a.label) {
                 case 0:
@@ -182,29 +182,38 @@ var addCdpConsent = function (options) {
                         console.error("Consent management adapter \"".concat(options.consent, "\" is not supported."));
                         return [2 /*return*/, null];
                     }
-                    if (!options.awaitConsent) return [3 /*break*/, 2];
+                    if (!options.awaitConsent) return [3 /*break*/, 6];
                     if (options.debug && options.enableLogging) {
                         console.log('[Chord Analytics DEBUG]: awaitConsent is true, checking if user can be tracked');
                     }
                     return [4 /*yield*/, checkUserCanBeTracked()];
                 case 1:
                     canBeTracked = _a.sent();
-                    if (!canBeTracked) {
-                        if (options.debug && options.enableLogging) {
-                            console.log('[Chord Analytics DEBUG]: User cannot be tracked, returning null');
-                        }
-                        return [2 /*return*/, null];
+                    if (!!canBeTracked) return [3 /*break*/, 6];
+                    if (options.debug && options.enableLogging) {
+                        console.log('[Chord Analytics DEBUG]: User cannot be tracked, returning null');
                     }
                     _a.label = 2;
                 case 2:
                     _a.trys.push([2, 4, , 5]);
                     return [4 /*yield*/, setupConsentManagement()];
-                case 3: return [2 /*return*/, _a.sent()];
+                case 3:
+                    _a.sent();
+                    return [3 /*break*/, 5];
                 case 4:
                     error_2 = _a.sent();
                     console.error('Error setting up consent management:', error_2);
+                    return [3 /*break*/, 5];
+                case 5: return [2 /*return*/, null];
+                case 6:
+                    _a.trys.push([6, 8, , 9]);
+                    return [4 /*yield*/, setupConsentManagement()];
+                case 7: return [2 /*return*/, _a.sent()];
+                case 8:
+                    error_3 = _a.sent();
+                    console.error('Error setting up consent management:', error_3);
                     return [2 /*return*/, null];
-                case 5: return [2 /*return*/];
+                case 9: return [2 /*return*/];
             }
         });
     }); };

package/dist/cjs/client/consent/shopify.js

@@ -7,14 +7,17 @@ exports.shopifyConsentAdapter = void 0;
 var getApi = function () { var _a; return (_a = window.Shopify) === null || _a === void 0 ? void 0 : _a.customerPrivacy; };
 /**
  * Returns whether the user can currently be tracked.
+ *
+ * Region is deliberately not checked: Shopify returns an empty region for
+ * visitors it hasn't geolocated (e.g. US visitors who never see a banner),
+ * even when analytics and marketing are both allowed. Opt-in regions already
+ * report both as not allowed until the visitor accepts.
  */
 var userCanBeTracked = function () {
     var api = getApi();
     if (!api)
         return false;
-    return !!(api.getRegion() &&
-        api.analyticsProcessingAllowed() &&
-        api.marketingAllowed());
+    return !!(api.analyticsProcessingAllowed() && api.marketingAllowed());
 };
 /**
  * Returns the user's current consent configuration.

package/dist/cjs/utils.d.ts

@@ -7,8 +7,17 @@ export declare const pruneNullValues: (props: EventProperties) => EventPropertie
  * Middleware runs on the path to the CDP, so an unbounded wait would let one
  * slow lookup hold up delivery indefinitely. `Order Completed` in particular
  * fires on a confirmation page shoppers close, so a late event is a lost one.
+ *
+ * The cap has to clear the work real middleware does. The case this was built
+ * for looks up an order count to decide whether a shopper is new, which costs
+ * an auth token and then the lookup itself -- two sequential round trips. That
+ * measured 811ms from a warm browser console, and an order confirmation page,
+ * still mounting and with other events in flight, is slower than a console. At
+ * one second it was dropping its properties in the field; three gives the
+ * round trips room without holding an event long enough for a shopper to
+ * navigate away from it.
  */
-export declare const MIDDLEWARE_TIMEOUT_MS = 1000;
+export declare const MIDDLEWARE_TIMEOUT_MS = 3000;
 /** Returned by {@link withTimeout} when the promise did not settle in time. */
 export declare const TIMED_OUT: unique symbol;
 export declare const isPromise: (value: unknown) => value is Promise<unknown>;

package/dist/cjs/utils.js

@@ -66,8 +66,17 @@ exports.pruneNullValues = pruneNullValues;
  * Middleware runs on the path to the CDP, so an unbounded wait would let one
  * slow lookup hold up delivery indefinitely. `Order Completed` in particular
  * fires on a confirmation page shoppers close, so a late event is a lost one.
+ *
+ * The cap has to clear the work real middleware does. The case this was built
+ * for looks up an order count to decide whether a shopper is new, which costs
+ * an auth token and then the lookup itself -- two sequential round trips. That
+ * measured 811ms from a warm browser console, and an order confirmation page,
+ * still mounting and with other events in flight, is slower than a console. At
+ * one second it was dropping its properties in the field; three gives the
+ * round trips room without holding an event long enough for a shopper to
+ * navigate away from it.
  */
-exports.MIDDLEWARE_TIMEOUT_MS = 1000;
+exports.MIDDLEWARE_TIMEOUT_MS = 3000;
 /** Returned by {@link withTimeout} when the promise did not settle in time. */
 exports.TIMED_OUT = Symbol('timed-out');
 var isPromise = function (value) {

package/dist/client/consent/index.js

@@ -136,6 +136,14 @@ export const addCdpConsent = (options) => {
                 if (options.debug && options.enableLogging) {
                     console.log('[Chord Analytics DEBUG]: User cannot be tracked, returning null');
                 }
+                // Still listen for consent changes, so a visitor who accepts after
+                // the timeout is picked up instead of being lost for the whole visit.
+                try {
+                    yield setupConsentManagement();
+                }
+                catch (error) {
+                    console.error('Error setting up consent management:', error);
+                }
                 return null;
             }
         }

package/dist/client/consent/shopify.js

@@ -4,14 +4,17 @@
 const getApi = () => { var _a; return (_a = window.Shopify) === null || _a === void 0 ? void 0 : _a.customerPrivacy; };
 /**
  * Returns whether the user can currently be tracked.
+ *
+ * Region is deliberately not checked: Shopify returns an empty region for
+ * visitors it hasn't geolocated (e.g. US visitors who never see a banner),
+ * even when analytics and marketing are both allowed. Opt-in regions already
+ * report both as not allowed until the visitor accepts.
  */
 const userCanBeTracked = () => {
     const api = getApi();
     if (!api)
         return false;
-    return !!(api.getRegion() &&
-        api.analyticsProcessingAllowed() &&
-        api.marketingAllowed());
+    return !!(api.analyticsProcessingAllowed() && api.marketingAllowed());
 };
 /**
  * Returns the user's current consent configuration.

package/dist/utils.d.ts

@@ -7,8 +7,17 @@ export declare const pruneNullValues: (props: EventProperties) => EventPropertie
  * Middleware runs on the path to the CDP, so an unbounded wait would let one
  * slow lookup hold up delivery indefinitely. `Order Completed` in particular
  * fires on a confirmation page shoppers close, so a late event is a lost one.
+ *
+ * The cap has to clear the work real middleware does. The case this was built
+ * for looks up an order count to decide whether a shopper is new, which costs
+ * an auth token and then the lookup itself -- two sequential round trips. That
+ * measured 811ms from a warm browser console, and an order confirmation page,
+ * still mounting and with other events in flight, is slower than a console. At
+ * one second it was dropping its properties in the field; three gives the
+ * round trips room without holding an event long enough for a shopper to
+ * navigate away from it.
  */
-export declare const MIDDLEWARE_TIMEOUT_MS = 1000;
+export declare const MIDDLEWARE_TIMEOUT_MS = 3000;
 /** Returned by {@link withTimeout} when the promise did not settle in time. */
 export declare const TIMED_OUT: unique symbol;
 export declare const isPromise: (value: unknown) => value is Promise<unknown>;

package/dist/utils.js

@@ -35,8 +35,17 @@ export const pruneNullValues = (props) => {
  * Middleware runs on the path to the CDP, so an unbounded wait would let one
  * slow lookup hold up delivery indefinitely. `Order Completed` in particular
  * fires on a confirmation page shoppers close, so a late event is a lost one.
+ *
+ * The cap has to clear the work real middleware does. The case this was built
+ * for looks up an order count to decide whether a shopper is new, which costs
+ * an auth token and then the lookup itself -- two sequential round trips. That
+ * measured 811ms from a warm browser console, and an order confirmation page,
+ * still mounting and with other events in flight, is slower than a console. At
+ * one second it was dropping its properties in the field; three gives the
+ * round trips room without holding an event long enough for a shopper to
+ * navigate away from it.
  */
-export const MIDDLEWARE_TIMEOUT_MS = 1000;
+export const MIDDLEWARE_TIMEOUT_MS = 3000;
 /** Returned by {@link withTimeout} when the promise did not settle in time. */
 export const TIMED_OUT = Symbol('timed-out');
 export const isPromise = (value) => typeof (value === null || value === void 0 ? void 0 : value.then) === 'function';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chordcommerce/analytics",
   "description": "Chord Commerce event tracking",
-  "version": "1.24.1",
+  "version": "1.24.3",
   "author": "Chord Commerce <help@chord.co> (https://www.chord.co)",
   "repository": {
     "type": "git",