@mrrocket/sdk 0.2.0 → 0.4.0

package/dist/web-state.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The browser state both web runtimes share, the Next.js provider (client.tsx) and the script tag (script/index.ts):
+ * the visitor and session cookies, the in-memory id of this page load, the current page's URL, referrer and campaign,
+ * and the browser's privacy signal. Plain functions, no React; only called in the browser (effects, event handlers).
+ */
+import { type ConsentMode, type UtmKey } from "./core.js";
+export declare const YEAR_S: number;
+export declare const readCookie: (name: string) => string | undefined;
+export declare const writeCookie: (name: string, value: string, maxAge: number) => void;
+export declare const deleteCookie: (name: string) => void;
+/**
+ * What lives for one page load, outside React so it survives a provider that remounts on navigation: the in-memory
+ * visitor id, the session, the current page's URL and referrer, and the campaign (UTM) parameters.
+ */
+export declare const page: {
+    id?: string;
+    session?: {
+        id: string;
+        last: number;
+    };
+    url?: string;
+    referrer?: string;
+    utm: Partial<Record<UtmKey, string>>;
+};
+export declare const memoryId: () => string;
+/**
+ * The visitor id for experiments, surveys and feedback. Only "cookies" reads or writes `ck_id`; the other modes keep a
+ * random id in memory for this page load. The page id follows the cookie, so leaving "cookies" keeps the same variants.
+ */
+export declare const visitorId: (mode: ConsentMode, write: boolean) => string;
+/** The session id for an event. Every event renews it; after 30 minutes without one a new session starts. */
+export declare const touchSession: (persist: boolean) => string;
+/** On every route change: the previous in-app URL becomes the referrer, and a URL with UTM parameters replaces the old ones. */
+export declare const enterPage: () => void;
+/** Do Not Track or Global Privacy Control. */
+export declare const privacySignal: () => boolean;

package/dist/web-state.js

@@ -0,0 +1,64 @@
+// src/web-state.ts
+import { ID_COOKIE, SESSION_COOKIE, SESSION_TIMEOUT_MS, newDistinctId, readUtm } from "./core.js";
+var YEAR_S = 60 * 60 * 24 * 365;
+var readCookie = (name) => {
+  if (typeof document === "undefined") return void 0;
+  const raw = document.cookie.split("; ").find((c) => c.startsWith(`${name}=`))?.slice(name.length + 1);
+  if (!raw) return void 0;
+  try {
+    return decodeURIComponent(raw);
+  } catch {
+    return raw;
+  }
+};
+var writeCookie = (name, value, maxAge) => {
+  const secure = window.location.protocol === "https:" ? "; secure" : "";
+  document.cookie = `${name}=${encodeURIComponent(value)}; path=/; max-age=${maxAge}; samesite=lax${secure}`;
+};
+var deleteCookie = (name) => {
+  document.cookie = `${name}=; path=/; max-age=0; samesite=lax`;
+};
+var page = { utm: {} };
+var memoryId = () => page.id ??= newDistinctId();
+var visitorId = (mode, write) => {
+  if (mode !== "cookies") return memoryId();
+  const stored = readCookie(ID_COOKIE);
+  if (stored) return page.id = stored;
+  const id = memoryId();
+  if (write) writeCookie(ID_COOKIE, id, YEAR_S);
+  return id;
+};
+var touchSession = (persist) => {
+  const now = Date.now();
+  const s = page.session;
+  const id = (persist ? readCookie(SESSION_COOKIE) : void 0) ?? (s && now - s.last < SESSION_TIMEOUT_MS ? s.id : newDistinctId());
+  page.session = { id, last: now };
+  if (persist) writeCookie(SESSION_COOKIE, id, SESSION_TIMEOUT_MS / 1e3);
+  return id;
+};
+var enterPage = () => {
+  const href = window.location.href;
+  if (page.url === href) return;
+  page.referrer = page.url ?? (document.referrer || void 0);
+  page.url = href;
+  const utm = readUtm(window.location.search);
+  if (Object.keys(utm).length) page.utm = utm;
+};
+var privacySignal = () => {
+  const nav = navigator;
+  const win = window;
+  return nav.doNotTrack === "1" || win.doNotTrack === "1" || nav.globalPrivacyControl === true;
+};
+export {
+  YEAR_S,
+  deleteCookie,
+  enterPage,
+  memoryId,
+  page,
+  privacySignal,
+  readCookie,
+  touchSession,
+  visitorId,
+  writeCookie
+};
+//# sourceMappingURL=web-state.js.map

package/dist/web-state.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/web-state.ts"],"sourcesContent":["/**\n * The browser state both web runtimes share, the Next.js provider (client.tsx) and the script tag (script/index.ts):\n * the visitor and session cookies, the in-memory id of this page load, the current page's URL, referrer and campaign,\n * and the browser's privacy signal. Plain functions, no React; only called in the browser (effects, event handlers).\n */\nimport { type ConsentMode, ID_COOKIE, SESSION_COOKIE, SESSION_TIMEOUT_MS, type UtmKey, newDistinctId, readUtm } from \"./core\";\n\nexport const YEAR_S = 60 * 60 * 24 * 365;\n\nexport const readCookie = (name: string) => {\n    if (typeof document === \"undefined\") return undefined;\n    const raw = document.cookie\n        .split(\"; \")\n        .find((c) => c.startsWith(`${name}=`))\n        ?.slice(name.length + 1);\n    if (!raw) return undefined;\n    try {\n        return decodeURIComponent(raw);\n    } catch {\n        return raw;\n    }\n};\n\nexport const writeCookie = (name: string, value: string, maxAge: number) => {\n    const secure = window.location.protocol === \"https:\" ? \"; secure\" : \"\";\n    document.cookie = `${name}=${encodeURIComponent(value)}; path=/; max-age=${maxAge}; samesite=lax${secure}`;\n};\n\nexport const deleteCookie = (name: string) => {\n    document.cookie = `${name}=; path=/; max-age=0; samesite=lax`;\n};\n\n/**\n * What lives for one page load, outside React so it survives a provider that remounts on navigation: the in-memory\n * visitor id, the session, the current page's URL and referrer, and the campaign (UTM) parameters.\n */\nexport const page: {\n    id?: string;\n    session?: { id: string; last: number };\n    url?: string;\n    referrer?: string;\n    utm: Partial<Record<UtmKey, string>>;\n} = { utm: {} };\n\nexport const memoryId = () => (page.id ??= newDistinctId());\n\n/**\n * The visitor id for experiments, surveys and feedback. Only \"cookies\" reads or writes `ck_id`; the other modes keep a\n * random id in memory for this page load. The page id follows the cookie, so leaving \"cookies\" keeps the same variants.\n */\nexport const visitorId = (mode: ConsentMode, write: boolean) => {\n    if (mode !== \"cookies\") return memoryId();\n    const stored = readCookie(ID_COOKIE);\n    if (stored) return (page.id = stored);\n    const id = memoryId();\n    if (write) writeCookie(ID_COOKIE, id, YEAR_S);\n    return id;\n};\n\n/** The session id for an event. Every event renews it; after 30 minutes without one a new session starts. */\nexport const touchSession = (persist: boolean) => {\n    const now = Date.now();\n    const s = page.session;\n    // In \"cookies\" mode the cookie wins, so tabs share a session.\n    const id = (persist ? readCookie(SESSION_COOKIE) : undefined) ?? (s && now - s.last < SESSION_TIMEOUT_MS ? s.id : newDistinctId());\n    page.session = { id, last: now };\n    if (persist) writeCookie(SESSION_COOKIE, id, SESSION_TIMEOUT_MS / 1000);\n    return id;\n};\n\n/** On every route change: the previous in-app URL becomes the referrer, and a URL with UTM parameters replaces the old ones. */\nexport const enterPage = () => {\n    const href = window.location.href;\n    if (page.url === href) return;\n    page.referrer = page.url ?? (document.referrer || undefined);\n    page.url = href;\n    const utm = readUtm(window.location.search);\n    if (Object.keys(utm).length) page.utm = utm;\n};\n\n/** Do Not Track or Global Privacy Control. */\nexport const privacySignal = () => {\n    const nav = navigator as Navigator & { doNotTrack?: string | null; globalPrivacyControl?: boolean };\n    const win = window as unknown as { doNotTrack?: string | null };\n    return nav.doNotTrack === \"1\" || win.doNotTrack === \"1\" || nav.globalPrivacyControl === true;\n};\n"],"mappings":";AAKA,SAA2B,WAAW,gBAAgB,oBAAiC,eAAe,eAAe;AAE9G,IAAM,SAAS,KAAK,KAAK,KAAK;AAE9B,IAAM,aAAa,CAAC,SAAiB;AACxC,MAAI,OAAO,aAAa,YAAa,QAAO;AAC5C,QAAM,MAAM,SAAS,OAChB,MAAM,IAAI,EACV,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,CAAC,GACnC,MAAM,KAAK,SAAS,CAAC;AAC3B,MAAI,CAAC,IAAK,QAAO;AACjB,MAAI;AACA,WAAO,mBAAmB,GAAG;AAAA,EACjC,QAAQ;AACJ,WAAO;AAAA,EACX;AACJ;AAEO,IAAM,cAAc,CAAC,MAAc,OAAe,WAAmB;AACxE,QAAM,SAAS,OAAO,SAAS,aAAa,WAAW,aAAa;AACpE,WAAS,SAAS,GAAG,IAAI,IAAI,mBAAmB,KAAK,CAAC,qBAAqB,MAAM,iBAAiB,MAAM;AAC5G;AAEO,IAAM,eAAe,CAAC,SAAiB;AAC1C,WAAS,SAAS,GAAG,IAAI;AAC7B;AAMO,IAAM,OAMT,EAAE,KAAK,CAAC,EAAE;AAEP,IAAM,WAAW,MAAO,KAAK,OAAO,cAAc;AAMlD,IAAM,YAAY,CAAC,MAAmB,UAAmB;AAC5D,MAAI,SAAS,UAAW,QAAO,SAAS;AACxC,QAAM,SAAS,WAAW,SAAS;AACnC,MAAI,OAAQ,QAAQ,KAAK,KAAK;AAC9B,QAAM,KAAK,SAAS;AACpB,MAAI,MAAO,aAAY,WAAW,IAAI,MAAM;AAC5C,SAAO;AACX;AAGO,IAAM,eAAe,CAAC,YAAqB;AAC9C,QAAM,MAAM,KAAK,IAAI;AACrB,QAAM,IAAI,KAAK;AAEf,QAAM,MAAM,UAAU,WAAW,cAAc,IAAI,YAAe,KAAK,MAAM,EAAE,OAAO,qBAAqB,EAAE,KAAK,cAAc;AAChI,OAAK,UAAU,EAAE,IAAI,MAAM,IAAI;AAC/B,MAAI,QAAS,aAAY,gBAAgB,IAAI,qBAAqB,GAAI;AACtE,SAAO;AACX;AAGO,IAAM,YAAY,MAAM;AAC3B,QAAM,OAAO,OAAO,SAAS;AAC7B,MAAI,KAAK,QAAQ,KAAM;AACvB,OAAK,WAAW,KAAK,QAAQ,SAAS,YAAY;AAClD,OAAK,MAAM;AACX,QAAM,MAAM,QAAQ,OAAO,SAAS,MAAM;AAC1C,MAAI,OAAO,KAAK,GAAG,EAAE,OAAQ,MAAK,MAAM;AAC5C;AAGO,IAAM,gBAAgB,MAAM;AAC/B,QAAM,MAAM;AACZ,QAAM,MAAM;AACZ,SAAO,IAAI,eAAe,OAAO,IAAI,eAAe,OAAO,IAAI,yBAAyB;AAC5F;","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@mrrocket/sdk",
-    "version": "0.2.0",
-    "description": "MRRocket SDK: page views, events, heatmap clicks, session recordings, A/B tests, feedback board and surveys that your MRRocket agents can run and read. Next.js today (@mrrocket/sdk/next), more frameworks next.",
+    "version": "0.4.0",
+    "description": "MRRocket SDK: page views, events, heatmap clicks, session recordings, A/B tests, feature flags, error tracking, feedback board and surveys that your MRRocket agents can run and read. Next.js (@mrrocket/sdk/next), React Native and Expo (@mrrocket/sdk/react-native), and a script tag for any website.",
     "keywords": [
         "nextjs",
         "analytics",
@@ -14,7 +14,10 @@
         "mrrocket",
         "cloudflare-workers",
         "react",
-        "sdk"
+        "sdk",
+        "react-native",
+        "expo",
+        "script-tag"
     ],
     "license": "MIT",
     "type": "module",
@@ -35,6 +38,14 @@
             "import": "./dist/proxy.js",
             "default": "./dist/proxy.js"
         },
+        "./react-native": {
+            "types": "./dist/react-native/index.d.ts",
+            "react-native": "./dist/react-native/index.js",
+            "require": "./dist/react-native/index.js",
+            "import": "./dist/react-native/index.js",
+            "default": "./dist/react-native/index.js"
+        },
+        "./browser": "./dist/browser/mrrocket.js",
         "./package.json": "./package.json"
     },
     "typesVersions": {
@@ -47,11 +58,15 @@
             ],
             "next/proxy": [
                 "./dist/proxy.d.ts"
+            ],
+            "react-native": [
+                "./dist/react-native/index.d.ts"
             ]
         }
     },
     "files": [
         "dist",
+        "react-native",
         "README.md",
         "LICENSE",
         "CHANGELOG.md"
@@ -63,20 +78,55 @@
         "access": "public"
     },
     "scripts": {
-        "build": "tsup && node scripts/build-types.mjs && node scripts/check-dist.mjs",
+        "build": "tsup && tsup --config tsup.native.config.mjs && tsup --config tsup.browser.config.mjs && node scripts/build-types.mjs && node scripts/check-dist.mjs",
         "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
         "typecheck": "tsc --noEmit",
         "test": "node --import tsx --test test/*.test.ts",
         "check:dist": "node scripts/check-dist.mjs",
         "check:publish": "node scripts/check-publish.mjs",
-        "prepublishOnly": "npm run check:publish && npm run typecheck && npm run build"
+        "prepublishOnly": "npm run check:publish && npm run typecheck && npm run build",
+        "build:script": "tsup --config tsup.browser.config.mjs",
+        "sync:app": "npm run build && node scripts/sync-app.mjs"
     },
     "dependencies": {
         "@rrweb/record": "2.1.6"
     },
     "peerDependencies": {
+        "@react-native-async-storage/async-storage": ">=1.17",
+        "expo-application": ">=5",
+        "expo-device": ">=5",
+        "expo-localization": ">=14",
+        "expo-router": ">=3",
         "next": ">=15",
-        "react": ">=19"
+        "react": ">=18",
+        "react-dom": ">=18",
+        "react-native": ">=0.72"
+    },
+    "peerDependenciesMeta": {
+        "@react-native-async-storage/async-storage": {
+            "optional": true
+        },
+        "expo-application": {
+            "optional": true
+        },
+        "expo-device": {
+            "optional": true
+        },
+        "expo-localization": {
+            "optional": true
+        },
+        "expo-router": {
+            "optional": true
+        },
+        "next": {
+            "optional": true
+        },
+        "react-dom": {
+            "optional": true
+        },
+        "react-native": {
+            "optional": true
+        }
     },
     "devDependencies": {
         "@types/node": "^22",

package/react-native/package.json

@@ -0,0 +1,7 @@
+{
+    "name": "@mrrocket/sdk/react-native",
+    "private": true,
+    "main": "../dist/react-native/index.js",
+    "react-native": "../dist/react-native/index.js",
+    "types": "../dist/react-native/index.d.ts"
+}