@sendoracloud/sdk-react-native 1.12.0 → 1.14.0

package/dist/index.cjs

@@ -136,7 +136,84 @@ var Storage = class {
   }
 };
 
+// package.json
+var package_default = {
+  name: "@sendoracloud/sdk-react-native",
+  version: "1.14.0",
+  description: "Sendora Cloud React Native + Expo SDK \u2014 analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push token registration requires a Dev Client (EAS Build or `npx expo prebuild`).",
+  type: "module",
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    },
+    "./contact-widget": {
+      types: "./dist/contact-widget.d.ts",
+      import: "./dist/contact-widget.js",
+      require: "./dist/contact-widget.cjs"
+    }
+  },
+  files: [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  keywords: [
+    "sendora",
+    "react-native",
+    "expo",
+    "analytics",
+    "tracking",
+    "customer-engagement"
+  ],
+  dependencies: {
+    "react-native-get-random-values": "^1.11.0"
+  },
+  peerDependencies: {
+    "@react-native-async-storage/async-storage": ">=1.17.0",
+    "react-native": ">=0.70.0",
+    "react-native-webview": ">=13.0.0"
+  },
+  peerDependenciesMeta: {
+    "@react-native-async-storage/async-storage": {
+      optional: false
+    },
+    "react-native": {
+      optional: false
+    },
+    "react-native-webview": {
+      optional: true
+    }
+  },
+  scripts: {
+    build: "tsup src/index.ts src/contact-widget.tsx --format esm,cjs --dts --clean --external react --external react-native --external react-native-webview",
+    typecheck: "tsc --noEmit"
+  },
+  devDependencies: {
+    "@types/react": "^19.2.16",
+    "react-native": "^0.85.3",
+    "react-native-webview": "^13.16.1",
+    tsup: "^8.0.0",
+    typescript: "^5.0.0"
+  },
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "https://github.com/sendoracloud/sdk-react-native"
+  },
+  homepage: "https://sendoracloud.com/sdks"
+};
+
+// src/version.ts
+var SDK_VERSION = package_default.version;
+
 // src/http.ts
+var SDK_NAME = "@sendoracloud/sdk-react-native";
 var NetworkTimeoutError = class extends Error {
   constructor(method, path, timeoutMs) {
     super(`Request timed out: ${method} ${path} (${timeoutMs}ms)`);
@@ -179,6 +256,13 @@ async function request(opts, method, path, body, extraHeaders, reqOpts) {
         // silently 401'd. Do not change this header without updating
         // apps/backend/src/middleware/auth.ts in lockstep.
         "x-api-key": opts.publicKey,
+        // ADR-023: identify the SDK + version on every request so the
+        // backend can attribute traffic + drive version-adoption /
+        // compatibility telemetry. Additive — the server ignores these
+        // today. Placed before extraHeaders so a caller could override
+        // if ever needed (none do).
+        "X-Sendora-SDK-Name": SDK_NAME,
+        "X-Sendora-SDK-Version": SDK_VERSION,
         ...extraHeaders ?? {}
       },
       body: body !== void 0 ? JSON.stringify(body) : void 0,
@@ -220,82 +304,6 @@ async function request(opts, method, path, body, extraHeaders, reqOpts) {
   return res;
 }
 
-// package.json
-var package_default = {
-  name: "@sendoracloud/sdk-react-native",
-  version: "1.12.0",
-  description: "Sendora Cloud React Native + Expo SDK \u2014 analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push token registration requires a Dev Client (EAS Build or `npx expo prebuild`).",
-  type: "module",
-  main: "./dist/index.cjs",
-  module: "./dist/index.js",
-  types: "./dist/index.d.ts",
-  exports: {
-    ".": {
-      types: "./dist/index.d.ts",
-      import: "./dist/index.js",
-      require: "./dist/index.cjs"
-    },
-    "./contact-widget": {
-      types: "./dist/contact-widget.d.ts",
-      import: "./dist/contact-widget.js",
-      require: "./dist/contact-widget.cjs"
-    }
-  },
-  files: [
-    "dist",
-    "examples",
-    "README.md",
-    "LICENSE"
-  ],
-  keywords: [
-    "sendora",
-    "react-native",
-    "expo",
-    "analytics",
-    "tracking",
-    "customer-engagement"
-  ],
-  dependencies: {
-    "react-native-get-random-values": "^1.11.0"
-  },
-  peerDependencies: {
-    "@react-native-async-storage/async-storage": ">=1.17.0",
-    "react-native": ">=0.70.0",
-    "react-native-webview": ">=13.0.0"
-  },
-  peerDependenciesMeta: {
-    "@react-native-async-storage/async-storage": {
-      optional: false
-    },
-    "react-native": {
-      optional: false
-    },
-    "react-native-webview": {
-      optional: true
-    }
-  },
-  scripts: {
-    build: "tsup src/index.ts src/contact-widget.tsx --format esm,cjs --dts --clean --external react --external react-native --external react-native-webview",
-    typecheck: "tsc --noEmit"
-  },
-  devDependencies: {
-    "@types/react": "^19.2.16",
-    "react-native": "^0.85.3",
-    "react-native-webview": "^13.16.1",
-    tsup: "^8.0.0",
-    typescript: "^5.0.0"
-  },
-  license: "MIT",
-  repository: {
-    type: "git",
-    url: "https://github.com/sendoracloud/sdk-react-native"
-  },
-  homepage: "https://sendoracloud.com/sdks"
-};
-
-// src/version.ts
-var SDK_VERSION = package_default.version;
-
 // src/auth.ts
 var import_react_native = require("react-native");
 var TOKEN_KEY = "auth_access_token";
@@ -1983,6 +1991,8 @@ function installAutoTrack(args) {
 var DEFAULT_API_URL = "https://api.sendoracloud.com";
 var ANON_KEY = "anon_id";
 var USER_ID_KEY = "user_id";
+var SCHEMA_VERSION_KEY = "schema_version";
+var SCHEMA_VERSION = "1";
 var AUTH_HYDRATE_KEYS = [
   "auth_access_token",
   "auth_access_expires",
@@ -2045,27 +2055,46 @@ function buildDeviceContext(appVersion) {
       type: isPad ? "tablet" : "mobile",
       os: os === "ios" ? "iOS" : "Android",
       osVersion: String(import_react_native4.Platform.Version ?? ""),
-      model: "",
+      model: expoDeviceModel(),
       appVersion: resolveAppVersion(appVersion)
     };
   } catch {
     return void 0;
   }
 }
-function expoNativeAppVersion() {
+function expoModule(name) {
+  try {
+    const g = globalThis;
+    const m = g?.expo?.modules?.[name];
+    if (m && typeof m === "object") return m;
+  } catch {
+  }
   try {
     const nm = import_react_native4.NativeModules;
-    const c = nm?.ExponentConstants ?? nm?.ExpoConstants;
-    if (!c) return "";
-    if (typeof c.nativeAppVersion === "string" && c.nativeAppVersion) return c.nativeAppVersion;
+    const m = nm?.[name];
+    if (m && typeof m === "object") return m;
+  } catch {
+  }
+  return void 0;
+}
+function expoNativeAppVersion() {
+  const c = expoModule("ExponentConstants") ?? expoModule("ExpoConstants");
+  if (!c) return "";
+  if (typeof c.nativeAppVersion === "string" && c.nativeAppVersion) return c.nativeAppVersion;
+  try {
     const raw = c.expoConfig ?? c.manifest ?? c.manifest2;
     const m = typeof raw === "string" ? JSON.parse(raw) : raw;
-    const v = m?.version ?? m?.extra?.expoClient?.version;
+    const v = m?.version;
     return typeof v === "string" ? v : "";
   } catch {
     return "";
   }
 }
+function expoDeviceModel() {
+  const d = expoModule("ExpoDevice");
+  const v = d?.modelName;
+  return typeof v === "string" ? v : "";
+}
 function resolveAppVersion(configAppVersion) {
   if (configAppVersion) return configAppVersion;
   const native = expoNativeAppVersion();
@@ -2136,7 +2165,15 @@ var SendoraSDK = class {
         `[sendoracloud] apiUrl override active: ${apiUrl} \u2014 confirm this is intentional. Tokens + events will be sent here.`
       );
     }
-    await this.storage.hydrate([ANON_KEY, USER_ID_KEY, ...AUTH_HYDRATE_KEYS]);
+    await this.storage.hydrate([
+      ANON_KEY,
+      USER_ID_KEY,
+      SCHEMA_VERSION_KEY,
+      ...AUTH_HYDRATE_KEYS
+    ]);
+    if (!this.storage.get(SCHEMA_VERSION_KEY)) {
+      this.storage.set(SCHEMA_VERSION_KEY, SCHEMA_VERSION);
+    }
     let anon = this.storage.get(ANON_KEY);
     if (!anon) {
       anon = uuid();

package/dist/index.js

@@ -93,7 +93,84 @@ var Storage = class {
   }
 };
 
+// package.json
+var package_default = {
+  name: "@sendoracloud/sdk-react-native",
+  version: "1.14.0",
+  description: "Sendora Cloud React Native + Expo SDK \u2014 analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push token registration requires a Dev Client (EAS Build or `npx expo prebuild`).",
+  type: "module",
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    },
+    "./contact-widget": {
+      types: "./dist/contact-widget.d.ts",
+      import: "./dist/contact-widget.js",
+      require: "./dist/contact-widget.cjs"
+    }
+  },
+  files: [
+    "dist",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  keywords: [
+    "sendora",
+    "react-native",
+    "expo",
+    "analytics",
+    "tracking",
+    "customer-engagement"
+  ],
+  dependencies: {
+    "react-native-get-random-values": "^1.11.0"
+  },
+  peerDependencies: {
+    "@react-native-async-storage/async-storage": ">=1.17.0",
+    "react-native": ">=0.70.0",
+    "react-native-webview": ">=13.0.0"
+  },
+  peerDependenciesMeta: {
+    "@react-native-async-storage/async-storage": {
+      optional: false
+    },
+    "react-native": {
+      optional: false
+    },
+    "react-native-webview": {
+      optional: true
+    }
+  },
+  scripts: {
+    build: "tsup src/index.ts src/contact-widget.tsx --format esm,cjs --dts --clean --external react --external react-native --external react-native-webview",
+    typecheck: "tsc --noEmit"
+  },
+  devDependencies: {
+    "@types/react": "^19.2.16",
+    "react-native": "^0.85.3",
+    "react-native-webview": "^13.16.1",
+    tsup: "^8.0.0",
+    typescript: "^5.0.0"
+  },
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "https://github.com/sendoracloud/sdk-react-native"
+  },
+  homepage: "https://sendoracloud.com/sdks"
+};
+
+// src/version.ts
+var SDK_VERSION = package_default.version;
+
 // src/http.ts
+var SDK_NAME = "@sendoracloud/sdk-react-native";
 var NetworkTimeoutError = class extends Error {
   constructor(method, path, timeoutMs) {
     super(`Request timed out: ${method} ${path} (${timeoutMs}ms)`);
@@ -136,6 +213,13 @@ async function request(opts, method, path, body, extraHeaders, reqOpts) {
         // silently 401'd. Do not change this header without updating
         // apps/backend/src/middleware/auth.ts in lockstep.
         "x-api-key": opts.publicKey,
+        // ADR-023: identify the SDK + version on every request so the
+        // backend can attribute traffic + drive version-adoption /
+        // compatibility telemetry. Additive — the server ignores these
+        // today. Placed before extraHeaders so a caller could override
+        // if ever needed (none do).
+        "X-Sendora-SDK-Name": SDK_NAME,
+        "X-Sendora-SDK-Version": SDK_VERSION,
         ...extraHeaders ?? {}
       },
       body: body !== void 0 ? JSON.stringify(body) : void 0,
@@ -177,82 +261,6 @@ async function request(opts, method, path, body, extraHeaders, reqOpts) {
   return res;
 }
 
-// package.json
-var package_default = {
-  name: "@sendoracloud/sdk-react-native",
-  version: "1.12.0",
-  description: "Sendora Cloud React Native + Expo SDK \u2014 analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push token registration requires a Dev Client (EAS Build or `npx expo prebuild`).",
-  type: "module",
-  main: "./dist/index.cjs",
-  module: "./dist/index.js",
-  types: "./dist/index.d.ts",
-  exports: {
-    ".": {
-      types: "./dist/index.d.ts",
-      import: "./dist/index.js",
-      require: "./dist/index.cjs"
-    },
-    "./contact-widget": {
-      types: "./dist/contact-widget.d.ts",
-      import: "./dist/contact-widget.js",
-      require: "./dist/contact-widget.cjs"
-    }
-  },
-  files: [
-    "dist",
-    "examples",
-    "README.md",
-    "LICENSE"
-  ],
-  keywords: [
-    "sendora",
-    "react-native",
-    "expo",
-    "analytics",
-    "tracking",
-    "customer-engagement"
-  ],
-  dependencies: {
-    "react-native-get-random-values": "^1.11.0"
-  },
-  peerDependencies: {
-    "@react-native-async-storage/async-storage": ">=1.17.0",
-    "react-native": ">=0.70.0",
-    "react-native-webview": ">=13.0.0"
-  },
-  peerDependenciesMeta: {
-    "@react-native-async-storage/async-storage": {
-      optional: false
-    },
-    "react-native": {
-      optional: false
-    },
-    "react-native-webview": {
-      optional: true
-    }
-  },
-  scripts: {
-    build: "tsup src/index.ts src/contact-widget.tsx --format esm,cjs --dts --clean --external react --external react-native --external react-native-webview",
-    typecheck: "tsc --noEmit"
-  },
-  devDependencies: {
-    "@types/react": "^19.2.16",
-    "react-native": "^0.85.3",
-    "react-native-webview": "^13.16.1",
-    tsup: "^8.0.0",
-    typescript: "^5.0.0"
-  },
-  license: "MIT",
-  repository: {
-    type: "git",
-    url: "https://github.com/sendoracloud/sdk-react-native"
-  },
-  homepage: "https://sendoracloud.com/sdks"
-};
-
-// src/version.ts
-var SDK_VERSION = package_default.version;
-
 // src/auth.ts
 import { AppState as RnAppState } from "react-native";
 var TOKEN_KEY = "auth_access_token";
@@ -1945,6 +1953,8 @@ function installAutoTrack(args) {
 var DEFAULT_API_URL = "https://api.sendoracloud.com";
 var ANON_KEY = "anon_id";
 var USER_ID_KEY = "user_id";
+var SCHEMA_VERSION_KEY = "schema_version";
+var SCHEMA_VERSION = "1";
 var AUTH_HYDRATE_KEYS = [
   "auth_access_token",
   "auth_access_expires",
@@ -2007,27 +2017,46 @@ function buildDeviceContext(appVersion) {
       type: isPad ? "tablet" : "mobile",
       os: os === "ios" ? "iOS" : "Android",
       osVersion: String(Platform.Version ?? ""),
-      model: "",
+      model: expoDeviceModel(),
       appVersion: resolveAppVersion(appVersion)
     };
   } catch {
     return void 0;
   }
 }
-function expoNativeAppVersion() {
+function expoModule(name) {
+  try {
+    const g = globalThis;
+    const m = g?.expo?.modules?.[name];
+    if (m && typeof m === "object") return m;
+  } catch {
+  }
   try {
     const nm = NativeModules;
-    const c = nm?.ExponentConstants ?? nm?.ExpoConstants;
-    if (!c) return "";
-    if (typeof c.nativeAppVersion === "string" && c.nativeAppVersion) return c.nativeAppVersion;
+    const m = nm?.[name];
+    if (m && typeof m === "object") return m;
+  } catch {
+  }
+  return void 0;
+}
+function expoNativeAppVersion() {
+  const c = expoModule("ExponentConstants") ?? expoModule("ExpoConstants");
+  if (!c) return "";
+  if (typeof c.nativeAppVersion === "string" && c.nativeAppVersion) return c.nativeAppVersion;
+  try {
     const raw = c.expoConfig ?? c.manifest ?? c.manifest2;
     const m = typeof raw === "string" ? JSON.parse(raw) : raw;
-    const v = m?.version ?? m?.extra?.expoClient?.version;
+    const v = m?.version;
     return typeof v === "string" ? v : "";
   } catch {
     return "";
   }
 }
+function expoDeviceModel() {
+  const d = expoModule("ExpoDevice");
+  const v = d?.modelName;
+  return typeof v === "string" ? v : "";
+}
 function resolveAppVersion(configAppVersion) {
   if (configAppVersion) return configAppVersion;
   const native = expoNativeAppVersion();
@@ -2098,7 +2127,15 @@ var SendoraSDK = class {
         `[sendoracloud] apiUrl override active: ${apiUrl} \u2014 confirm this is intentional. Tokens + events will be sent here.`
       );
     }
-    await this.storage.hydrate([ANON_KEY, USER_ID_KEY, ...AUTH_HYDRATE_KEYS]);
+    await this.storage.hydrate([
+      ANON_KEY,
+      USER_ID_KEY,
+      SCHEMA_VERSION_KEY,
+      ...AUTH_HYDRATE_KEYS
+    ]);
+    if (!this.storage.get(SCHEMA_VERSION_KEY)) {
+      this.storage.set(SCHEMA_VERSION_KEY, SCHEMA_VERSION);
+    }
     let anon = this.storage.get(ANON_KEY);
     if (!anon) {
       anon = uuid();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "Sendora Cloud React Native + Expo SDK — analytics, identity, push-token registration, auth, deep links (Branch / Firebase Dynamic Links parity). Auth + analytics + deep links work in Expo Go; push token registration requires a Dev Client (EAS Build or `npx expo prebuild`).",
   "type": "module",
   "main": "./dist/index.cjs",