@sendoracloud/sdk-react-native 1.13.0 → 1.15.0

package/dist/index.cjs

@@ -136,7 +136,84 @@ var Storage = class {
   }
 };
 
+// package.json
+var package_default = {
+  name: "@sendoracloud/sdk-react-native",
+  version: "1.15.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.13.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",
@@ -2059,6 +2069,14 @@ function expoModule(name) {
     if (m && typeof m === "object") return m;
   } catch {
   }
+  try {
+    const g = globalThis;
+    const nm = import_react_native4.NativeModules;
+    const proxy = g?.expo?.modules?.NativeModulesProxy ?? nm?.NativeUnimoduleProxy;
+    const consts = proxy?.modulesConstants?.[name];
+    if (consts && typeof consts === "object") return consts;
+  } catch {
+  }
   try {
     const nm = import_react_native4.NativeModules;
     const m = nm?.[name];
@@ -2067,12 +2085,17 @@ function expoModule(name) {
   }
   return void 0;
 }
-function expoNativeAppVersion() {
+function expoApplicationVersion() {
+  const a = expoModule("ExpoApplication");
+  const v = a?.nativeApplicationVersion;
+  return typeof v === "string" && v ? v : "";
+}
+function expoConstantsVersion() {
   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 raw = c.manifest ?? c.expoConfig ?? c.manifest2;
     const m = typeof raw === "string" ? JSON.parse(raw) : raw;
     const v = m?.version;
     return typeof v === "string" ? v : "";
@@ -2087,8 +2110,10 @@ function expoDeviceModel() {
 }
 function resolveAppVersion(configAppVersion) {
   if (configAppVersion) return configAppVersion;
-  const native = expoNativeAppVersion();
-  if (native) return native;
+  const appMod = expoApplicationVersion();
+  if (appMod) return appMod;
+  const constMod = expoConstantsVersion();
+  if (constMod) return constMod;
   try {
     const env = process.env.EXPO_PUBLIC_APP_VERSION;
     if (env) return env;
@@ -2155,7 +2180,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.15.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.13.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",
@@ -2021,6 +2031,14 @@ function expoModule(name) {
     if (m && typeof m === "object") return m;
   } catch {
   }
+  try {
+    const g = globalThis;
+    const nm = NativeModules;
+    const proxy = g?.expo?.modules?.NativeModulesProxy ?? nm?.NativeUnimoduleProxy;
+    const consts = proxy?.modulesConstants?.[name];
+    if (consts && typeof consts === "object") return consts;
+  } catch {
+  }
   try {
     const nm = NativeModules;
     const m = nm?.[name];
@@ -2029,12 +2047,17 @@ function expoModule(name) {
   }
   return void 0;
 }
-function expoNativeAppVersion() {
+function expoApplicationVersion() {
+  const a = expoModule("ExpoApplication");
+  const v = a?.nativeApplicationVersion;
+  return typeof v === "string" && v ? v : "";
+}
+function expoConstantsVersion() {
   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 raw = c.manifest ?? c.expoConfig ?? c.manifest2;
     const m = typeof raw === "string" ? JSON.parse(raw) : raw;
     const v = m?.version;
     return typeof v === "string" ? v : "";
@@ -2049,8 +2072,10 @@ function expoDeviceModel() {
 }
 function resolveAppVersion(configAppVersion) {
   if (configAppVersion) return configAppVersion;
-  const native = expoNativeAppVersion();
-  if (native) return native;
+  const appMod = expoApplicationVersion();
+  if (appMod) return appMod;
+  const constMod = expoConstantsVersion();
+  if (constMod) return constMod;
   try {
     const env = process.env.EXPO_PUBLIC_APP_VERSION;
     if (env) return env;
@@ -2117,7 +2142,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.13.0",
+  "version": "1.15.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",