@sendoracloud/sdk-react-native 0.19.0 → 0.20.1

package/dist/index.cjs

@@ -195,6 +195,7 @@ async function request(opts, method, path, body, extraHeaders) {
 }
 
 // src/auth.ts
+var import_react_native = require("react-native");
 var TOKEN_KEY = "auth_access_token";
 var TOKEN_EXPIRES_KEY = "auth_access_expires";
 var REFRESH_KEY = "auth_refresh_token";
@@ -236,6 +237,15 @@ var Auth = class {
     this.accessExpiresAt = 0;
     this.inflight = Promise.resolve();
     this.refreshInflight = null;
+    /**
+     * Proactive refresh (s58.72). Fires when access-token age crosses
+     * ~80% of TTL. Pairs with the AppState foreground listener so a
+     * backgrounded app coming back to active state immediately runs
+     * a tick — much better UX than waiting 60s for the next interval.
+     * Stopped on signOut() / wipeLocalIdentity().
+     */
+    this.proactiveRefreshTimer = null;
+    this.proactiveRefreshAppStateUnsub = null;
     this.hooks = hooks;
     this.readyPromise = new Promise((res) => {
       this.resolveReady = res;
@@ -784,12 +794,25 @@ var Auth = class {
    */
   async refreshAccessToken() {
     if (this.refreshInflight) return this.refreshInflight;
-    const refresh = this.hooks.storage.get(REFRESH_KEY);
-    if (!refresh) return null;
+    const refreshSnapshot = this.hooks.storage.get(REFRESH_KEY);
+    if (!refreshSnapshot) return null;
     this.refreshInflight = (async () => {
       try {
+        const current = this.hooks.storage.get(REFRESH_KEY);
+        if (current && current !== refreshSnapshot) {
+          const freshAccess = this.hooks.storage.get(TOKEN_KEY);
+          const freshExpiresStr = this.hooks.storage.get(TOKEN_EXPIRES_KEY);
+          if (freshAccess && freshExpiresStr) {
+            const freshExpires = Number(freshExpiresStr);
+            if (Number.isFinite(freshExpires) && freshExpires > Date.now()) {
+              this.accessToken = freshAccess;
+              this.accessExpiresAt = freshExpires;
+              return freshAccess;
+            }
+          }
+        }
         const data = await this.callAuth("/api/v1/auth-service/token/refresh", {
-          refreshToken: refresh
+          refreshToken: current ?? refreshSnapshot
         });
         this.accessToken = data.tokens.accessToken;
         this.accessExpiresAt = Date.now() + data.tokens.expiresIn * 1e3;
@@ -808,6 +831,45 @@ var Auth = class {
     })();
     return this.refreshInflight;
   }
+  startProactiveRefreshCron() {
+    if (this.proactiveRefreshTimer) return;
+    const PROACTIVE_TARGET_PCT = 0.8;
+    const TICK_MS = 6e4;
+    const JITTER_MS = 3e4;
+    const tick = async () => {
+      if (!this.accessToken || !this.accessExpiresAt) return;
+      const now = Date.now();
+      const lifetimeMs = this.accessExpiresAt - now;
+      if (lifetimeMs <= 0) return;
+      const guessOriginalMs = Math.max(lifetimeMs, 5 * 6e4);
+      const fireWhenRemainingMs = guessOriginalMs * (1 - PROACTIVE_TARGET_PCT) + (Math.random() * JITTER_MS * 2 - JITTER_MS);
+      if (lifetimeMs <= fireWhenRemainingMs) {
+        await this.refreshAccessToken();
+      }
+    };
+    this.proactiveRefreshTimer = setInterval(() => {
+      void tick();
+    }, TICK_MS);
+    try {
+      const subscription = import_react_native.AppState?.addEventListener?.("change", (state) => {
+        if (state === "active") void tick();
+      });
+      if (subscription) {
+        this.proactiveRefreshAppStateUnsub = () => subscription.remove();
+      }
+    } catch {
+    }
+  }
+  stopProactiveRefreshCron() {
+    if (this.proactiveRefreshTimer) {
+      clearInterval(this.proactiveRefreshTimer);
+      this.proactiveRefreshTimer = null;
+    }
+    if (this.proactiveRefreshAppStateUnsub) {
+      this.proactiveRefreshAppStateUnsub();
+      this.proactiveRefreshAppStateUnsub = null;
+    }
+  }
   /**
    * Returns the currently-stored refresh token (or null when signed out).
    * Primary use: capture the anonymous refresh token BEFORE calling
@@ -909,6 +971,7 @@ var Auth = class {
     this.hooks.storage.set(TOKEN_EXPIRES_KEY, String(this.accessExpiresAt));
     this.hooks.storage.set(REFRESH_KEY, data.tokens.refreshToken);
     this.hooks.onIdentityChange(data.user.id);
+    this.startProactiveRefreshCron();
   }
   async wipeLocalIdentity() {
     this.user = null;
@@ -918,6 +981,7 @@ var Auth = class {
     this.hooks.storage.remove(TOKEN_KEY);
     this.hooks.storage.remove(TOKEN_EXPIRES_KEY);
     this.hooks.storage.remove(REFRESH_KEY);
+    this.stopProactiveRefreshCron();
     await this.hooks.onAnonymousWipe();
   }
 };
@@ -940,7 +1004,7 @@ function decodeJwtPayload(token) {
 }
 
 // src/links.ts
-var import_react_native = require("react-native");
+var import_react_native2 = require("react-native");
 var LinkError = class extends Error {
   constructor(code, message, statusCode = 0, details) {
     super(message);
@@ -1019,10 +1083,10 @@ function dynRequire(id) {
 }
 function loadRn() {
   return {
-    Platform: import_react_native.Platform,
-    Dimensions: import_react_native.Dimensions,
-    NativeModules: import_react_native.NativeModules,
-    Linking: import_react_native.Linking
+    Platform: import_react_native2.Platform,
+    Dimensions: import_react_native2.Dimensions,
+    NativeModules: import_react_native2.NativeModules,
+    Linking: import_react_native2.Linking
   };
 }
 function readTimezone() {
@@ -1504,7 +1568,7 @@ var Links = class {
 };
 
 // src/auto-track.ts
-var import_react_native2 = require("react-native");
+var import_react_native3 = require("react-native");
 var DEFAULT_IDLE_MS = 30 * 60 * 1e3;
 function resolveFlags(cfg) {
   if (cfg === false) {
@@ -1548,7 +1612,7 @@ function installAutoTrack(args) {
     args.fire("app.opened", { sessionId });
   }
   if (flags.appBackground) {
-    const AppState = import_react_native2.AppState;
+    const AppState = import_react_native3.AppState;
     if (AppState && typeof AppState.addEventListener === "function") {
       const handler = (state) => {
         ensureSession(true);

package/dist/index.d.cts

@@ -312,6 +312,17 @@ declare class Auth {
      * surface NOT_SIGNED_IN to the host app instead of looping.
      */
     private refreshAccessToken;
+    /**
+     * Proactive refresh (s58.72). Fires when access-token age crosses
+     * ~80% of TTL. Pairs with the AppState foreground listener so a
+     * backgrounded app coming back to active state immediately runs
+     * a tick — much better UX than waiting 60s for the next interval.
+     * Stopped on signOut() / wipeLocalIdentity().
+     */
+    private proactiveRefreshTimer;
+    private proactiveRefreshAppStateUnsub;
+    private startProactiveRefreshCron;
+    private stopProactiveRefreshCron;
     /**
      * Returns the currently-stored refresh token (or null when signed out).
      * Primary use: capture the anonymous refresh token BEFORE calling

package/dist/index.d.ts

@@ -312,6 +312,17 @@ declare class Auth {
      * surface NOT_SIGNED_IN to the host app instead of looping.
      */
     private refreshAccessToken;
+    /**
+     * Proactive refresh (s58.72). Fires when access-token age crosses
+     * ~80% of TTL. Pairs with the AppState foreground listener so a
+     * backgrounded app coming back to active state immediately runs
+     * a tick — much better UX than waiting 60s for the next interval.
+     * Stopped on signOut() / wipeLocalIdentity().
+     */
+    private proactiveRefreshTimer;
+    private proactiveRefreshAppStateUnsub;
+    private startProactiveRefreshCron;
+    private stopProactiveRefreshCron;
     /**
      * Returns the currently-stored refresh token (or null when signed out).
      * Primary use: capture the anonymous refresh token BEFORE calling

package/dist/index.js

@@ -152,6 +152,7 @@ async function request(opts, method, path, body, extraHeaders) {
 }
 
 // src/auth.ts
+import { AppState as RnAppState } from "react-native";
 var TOKEN_KEY = "auth_access_token";
 var TOKEN_EXPIRES_KEY = "auth_access_expires";
 var REFRESH_KEY = "auth_refresh_token";
@@ -193,6 +194,15 @@ var Auth = class {
     this.accessExpiresAt = 0;
     this.inflight = Promise.resolve();
     this.refreshInflight = null;
+    /**
+     * Proactive refresh (s58.72). Fires when access-token age crosses
+     * ~80% of TTL. Pairs with the AppState foreground listener so a
+     * backgrounded app coming back to active state immediately runs
+     * a tick — much better UX than waiting 60s for the next interval.
+     * Stopped on signOut() / wipeLocalIdentity().
+     */
+    this.proactiveRefreshTimer = null;
+    this.proactiveRefreshAppStateUnsub = null;
     this.hooks = hooks;
     this.readyPromise = new Promise((res) => {
       this.resolveReady = res;
@@ -741,12 +751,25 @@ var Auth = class {
    */
   async refreshAccessToken() {
     if (this.refreshInflight) return this.refreshInflight;
-    const refresh = this.hooks.storage.get(REFRESH_KEY);
-    if (!refresh) return null;
+    const refreshSnapshot = this.hooks.storage.get(REFRESH_KEY);
+    if (!refreshSnapshot) return null;
     this.refreshInflight = (async () => {
       try {
+        const current = this.hooks.storage.get(REFRESH_KEY);
+        if (current && current !== refreshSnapshot) {
+          const freshAccess = this.hooks.storage.get(TOKEN_KEY);
+          const freshExpiresStr = this.hooks.storage.get(TOKEN_EXPIRES_KEY);
+          if (freshAccess && freshExpiresStr) {
+            const freshExpires = Number(freshExpiresStr);
+            if (Number.isFinite(freshExpires) && freshExpires > Date.now()) {
+              this.accessToken = freshAccess;
+              this.accessExpiresAt = freshExpires;
+              return freshAccess;
+            }
+          }
+        }
         const data = await this.callAuth("/api/v1/auth-service/token/refresh", {
-          refreshToken: refresh
+          refreshToken: current ?? refreshSnapshot
         });
         this.accessToken = data.tokens.accessToken;
         this.accessExpiresAt = Date.now() + data.tokens.expiresIn * 1e3;
@@ -765,6 +788,45 @@ var Auth = class {
     })();
     return this.refreshInflight;
   }
+  startProactiveRefreshCron() {
+    if (this.proactiveRefreshTimer) return;
+    const PROACTIVE_TARGET_PCT = 0.8;
+    const TICK_MS = 6e4;
+    const JITTER_MS = 3e4;
+    const tick = async () => {
+      if (!this.accessToken || !this.accessExpiresAt) return;
+      const now = Date.now();
+      const lifetimeMs = this.accessExpiresAt - now;
+      if (lifetimeMs <= 0) return;
+      const guessOriginalMs = Math.max(lifetimeMs, 5 * 6e4);
+      const fireWhenRemainingMs = guessOriginalMs * (1 - PROACTIVE_TARGET_PCT) + (Math.random() * JITTER_MS * 2 - JITTER_MS);
+      if (lifetimeMs <= fireWhenRemainingMs) {
+        await this.refreshAccessToken();
+      }
+    };
+    this.proactiveRefreshTimer = setInterval(() => {
+      void tick();
+    }, TICK_MS);
+    try {
+      const subscription = RnAppState?.addEventListener?.("change", (state) => {
+        if (state === "active") void tick();
+      });
+      if (subscription) {
+        this.proactiveRefreshAppStateUnsub = () => subscription.remove();
+      }
+    } catch {
+    }
+  }
+  stopProactiveRefreshCron() {
+    if (this.proactiveRefreshTimer) {
+      clearInterval(this.proactiveRefreshTimer);
+      this.proactiveRefreshTimer = null;
+    }
+    if (this.proactiveRefreshAppStateUnsub) {
+      this.proactiveRefreshAppStateUnsub();
+      this.proactiveRefreshAppStateUnsub = null;
+    }
+  }
   /**
    * Returns the currently-stored refresh token (or null when signed out).
    * Primary use: capture the anonymous refresh token BEFORE calling
@@ -866,6 +928,7 @@ var Auth = class {
     this.hooks.storage.set(TOKEN_EXPIRES_KEY, String(this.accessExpiresAt));
     this.hooks.storage.set(REFRESH_KEY, data.tokens.refreshToken);
     this.hooks.onIdentityChange(data.user.id);
+    this.startProactiveRefreshCron();
   }
   async wipeLocalIdentity() {
     this.user = null;
@@ -875,6 +938,7 @@ var Auth = class {
     this.hooks.storage.remove(TOKEN_KEY);
     this.hooks.storage.remove(TOKEN_EXPIRES_KEY);
     this.hooks.storage.remove(REFRESH_KEY);
+    this.stopProactiveRefreshCron();
     await this.hooks.onAnonymousWipe();
   }
 };
@@ -1466,7 +1530,7 @@ var Links = class {
 };
 
 // src/auto-track.ts
-import { AppState as RnAppState } from "react-native";
+import { AppState as RnAppState2 } from "react-native";
 var DEFAULT_IDLE_MS = 30 * 60 * 1e3;
 function resolveFlags(cfg) {
   if (cfg === false) {
@@ -1510,7 +1574,7 @@ function installAutoTrack(args) {
     args.fire("app.opened", { sessionId });
   }
   if (flags.appBackground) {
-    const AppState = RnAppState;
+    const AppState = RnAppState2;
     if (AppState && typeof AppState.addEventListener === "function") {
       const handler = (state) => {
         ensureSession(true);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendoracloud/sdk-react-native",
-  "version": "0.19.0",
+  "version": "0.20.1",
   "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",