@pack/hydrogen 3.3.0 → 3.3.1

package/dist/index.js

@@ -5108,6 +5108,21 @@ function buildIdentityBundle(request, options = {}) {
     hasConsent,
     userAgent,
     deviceType: userAgent ? detectDeviceType(userAgent) : "desktop",
+    // Host-provided geo-IP, first header present wins. Every name here is one
+    // the host defines, and they must carry the same FORMAT across hosts:
+    // country as ISO 3166-1 alpha-2, region as an ISO 3166-2 subdivision code.
+    //
+    // Defined is not the same as delivered. Only `oxygen-buyer-*` and
+    // `cf-ipcountry` arrive unconditionally; `cf-region-code` needs
+    // Cloudflare's "Add visitor location headers" managed transform, which is
+    // off by default, so a Workers deployment behind plain Cloudflare has no
+    // region and its region audiences match nobody. That is fine while
+    // storefronts are on Oxygen (which sets it from request.cf) — revisit if a
+    // storefront ever fronts an origin with Cloudflare directly.
+    // Oxygen also exposes `oxygen-buyer-region`, but that is the full name
+    // ("California") — mixing it in would make an audience configured as "CA"
+    // match on Cloudflare/Vercel and never on Oxygen, since matchGeo compares
+    // the whole string.
     geo: {
       country: firstHeader(
         request,
@@ -5117,7 +5132,7 @@ function buildIdentityBundle(request, options = {}) {
       ),
       region: firstHeader(
         request,
-        "oxygen-buyer-province",
+        "oxygen-buyer-region-code",
         "cf-region-code",
         "x-vercel-ip-country-region"
       )