@wapitee/typhoonx-hydrogen 0.4.0 → 0.4.2

package/README.md

@@ -42,11 +42,11 @@ const {nonce, header, NonceProvider} = createContentSecurityPolicy({
 
 ### Props
 
-| Prop           | Type     | Required | Description                                                              |
-| -------------- | -------- | -------- | ------------------------------------------------------------------------ |
-| `merchantId`   | `string` | yes      | TyphoonX merchant ID (`TPX-…`)                                           |
-| `shopId`       | `string` | yes      | Shopify store ID                                                         |
-| `cookieDomain` | `string` | no       | Cookie `Domain` for a first-party client id. Omit for a host-only cookie |
+| Prop           | Type     | Required | Description                                                                                                       |
+| -------------- | -------- | -------- | ----------------------------------------------------------------------------------------------------------------- |
+| `merchantId`   | `string` | yes      | TyphoonX merchant ID (`TPX-…`)                                                                                    |
+| `shopId`       | `string` | yes      | Shopify store ID                                                                                                  |
+| `cookieDomain` | `string` | no       | Cookie `Domain` for a first-party client id. Defaults to the current hostname's apex domain (e.g. `.example.com`) |
 
 ## License
 

package/dist/client-id.d.ts

@@ -1,18 +1,3 @@
-/**
- * Returns the TyphoonX client id from the `__typhoon_client_id` cookie, or
- * creates a new UUID and writes it when the cookie is missing.
- *
- * The cookie is scoped to `Path=/`, uses `SameSite=Lax`, and expires after
- * one year. When `cookieDomain` is set, that value is used as the cookie
- * `Domain` so the id can be shared across subdomains. The `Secure` flag is
- * added automatically on HTTPS pages.
- *
- * @remarks
- * This helper must run in the browser. It reads and writes `document.cookie`.
- *
- * @param cookieDomain - Optional cookie `Domain` attribute, typically the
- * storefront apex domain.
- * @returns The existing or newly created client id.
- */
+/** Existing `__typhoon_client_id`, or a new UUID cookie on the apex domain. */
 export declare function getOrCreateClientId(cookieDomain?: string): string;
 //# sourceMappingURL=client-id.d.ts.map

package/dist/client-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client-id.d.ts","sourceRoot":"","sources":["../src/client-id.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CA8BjE"}
+{"version":3,"file":"client-id.d.ts","sourceRoot":"","sources":["../src/client-id.ts"],"names":[],"mappings":"AAwBA,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAWjE"}

package/dist/client-id.js

@@ -1,46 +1,37 @@
-/** Cookie name that stores the anonymous TyphoonX client identifier. */
+import CookieLib from 'universal-cookie';
 const COOKIE = '__typhoon_client_id';
-/** Cookie lifetime in seconds (365 days). */
-const MAX_AGE = 31_536_000;
-/**
- * Returns the TyphoonX client id from the `__typhoon_client_id` cookie, or
- * creates a new UUID and writes it when the cookie is missing.
- *
- * The cookie is scoped to `Path=/`, uses `SameSite=Lax`, and expires after
- * one year. When `cookieDomain` is set, that value is used as the cookie
- * `Domain` so the id can be shared across subdomains. The `Secure` flag is
- * added automatically on HTTPS pages.
- *
- * @remarks
- * This helper must run in the browser. It reads and writes `document.cookie`.
- *
- * @param cookieDomain - Optional cookie `Domain` attribute, typically the
- * storefront apex domain.
- * @returns The existing or newly created client id.
- */
+const MAX_AGE = 31_536_000; // 365 days
+// Runtime default export is the class.
+const Cookies = CookieLib;
+const cookies = new Cookies(null, {
+    path: '/',
+    sameSite: 'lax',
+    maxAge: MAX_AGE,
+});
+/** Existing `__typhoon_client_id`, or a new UUID cookie on the apex domain. */
 export function getOrCreateClientId(cookieDomain) {
-    const prefix = `${COOKIE}=`;
-    const existing = document.cookie
-        .split(';')
-        .map((part) => part.trim())
-        .find((part) => part.startsWith(prefix))
-        ?.slice(prefix.length);
+    const existing = cookies.get(COOKIE, { doNotParse: true });
     if (existing) {
-        return decodeURIComponent(existing);
+        return existing;
     }
     const id = crypto.randomUUID();
-    const segments = [
-        `${COOKIE}=${id}`,
-        'Path=/',
-        'SameSite=Lax',
-        `Max-Age=${String(MAX_AGE)}`,
-    ];
-    if (cookieDomain) {
-        segments.push(`Domain=${cookieDomain}`);
-    }
-    if (window.location.protocol === 'https:') {
-        segments.push('Secure');
-    }
-    document.cookie = segments.join('; ');
+    const domain = cookieDomain ?? apexCookieDomain(window.location.hostname);
+    const secure = window.location.protocol === 'https:';
+    cookies.set(COOKIE, id, domain ? { domain, secure } : { secure });
     return id;
 }
+function apexCookieDomain(hostname) {
+    const labels = hostname.split('.');
+    const secure = window.location.protocol === 'https:';
+    for (let n = 2; n <= labels.length; n += 1) {
+        const domain = `.${labels.slice(-n).join('.')}`;
+        const token = crypto.randomUUID();
+        cookies.set('__typhoon_d', token, { domain, maxAge: 60, secure });
+        const probe = cookies.get('__typhoon_d', { doNotParse: true });
+        cookies.remove('__typhoon_d', { domain, secure });
+        if (probe === token) {
+            return domain;
+        }
+    }
+    return undefined;
+}

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "@wapitee/typhoonx-hydrogen",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "TyphoonX Hydrogen Analytics subscriber",
+  "keywords": [
+    "typhoonx",
+    "shopify",
+    "hydrogen",
+    "analytics",
+    "react",
+    "storefront"
+  ],
   "homepage": "https://github.com/Wapitee-Interactive-Marketing-Limited/typhoonx-js/tree/main/packages/typhoonx-hydrogen",
   "bugs": {
     "url": "https://github.com/Wapitee-Interactive-Marketing-Limited/typhoonx-js/issues"
@@ -28,6 +36,9 @@
     "README.md",
     "dist"
   ],
+  "dependencies": {
+    "universal-cookie": "^8.1.2"
+  },
   "devDependencies": {
     "@shopify/hydrogen": "^2026.4.5",
     "@types/react": "^18.3.31",