@pollar/core 0.7.1 → 0.8.1

package/dist/types-84G_htcn.d.mts

@@ -0,0 +1,38 @@
+/**
+ * Pluggable "is the user looking at this app right now?" signal.
+ *
+ * Used by the silent-refresh scheduler so token renewals are skipped while
+ * the tab is hidden / the app is backgrounded — both saves network and
+ * works around aggressive `setTimeout` throttling that web browsers and RN
+ * apply to non-foreground contexts.
+ *
+ * Default web implementation listens to `visibilitychange` plus
+ * `pageshow`/`pagehide` (covers BFCache on iOS) and `focus`/`blur` (covers
+ * the cases where `visibilitychange` lags). Default for non-browser
+ * environments is a noop that always reports "visible".
+ *
+ * TODO(@pollar/react-native): when the dedicated RN package ships, it will
+ * export an `AppState`-backed provider. Until then, RN consumers can wire
+ * one inline:
+ *
+ *   import { AppState } from 'react-native';
+ *   const rnVisibility = {
+ *     isVisible: () => AppState.currentState === 'active',
+ *     onChange: (cb) => {
+ *       const sub = AppState.addEventListener('change', (s) => cb(s === 'active'));
+ *       return () => sub.remove();
+ *     },
+ *   };
+ *   new PollarClient({ apiKey, visibilityProvider: rnVisibility });
+ */
+interface VisibilityProvider {
+    isVisible(): boolean;
+    /**
+     * Subscribe to visibility transitions. The callback receives the new
+     * visibility state (`true` = visible). Returns an unsubscribe function
+     * that must detach every listener registered by this call.
+     */
+    onChange(cb: (visible: boolean) => void): () => void;
+}
+
+export type { VisibilityProvider as V };

package/dist/types-84G_htcn.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Pluggable "is the user looking at this app right now?" signal.
+ *
+ * Used by the silent-refresh scheduler so token renewals are skipped while
+ * the tab is hidden / the app is backgrounded — both saves network and
+ * works around aggressive `setTimeout` throttling that web browsers and RN
+ * apply to non-foreground contexts.
+ *
+ * Default web implementation listens to `visibilitychange` plus
+ * `pageshow`/`pagehide` (covers BFCache on iOS) and `focus`/`blur` (covers
+ * the cases where `visibilitychange` lags). Default for non-browser
+ * environments is a noop that always reports "visible".
+ *
+ * TODO(@pollar/react-native): when the dedicated RN package ships, it will
+ * export an `AppState`-backed provider. Until then, RN consumers can wire
+ * one inline:
+ *
+ *   import { AppState } from 'react-native';
+ *   const rnVisibility = {
+ *     isVisible: () => AppState.currentState === 'active',
+ *     onChange: (cb) => {
+ *       const sub = AppState.addEventListener('change', (s) => cb(s === 'active'));
+ *       return () => sub.remove();
+ *     },
+ *   };
+ *   new PollarClient({ apiKey, visibilityProvider: rnVisibility });
+ */
+interface VisibilityProvider {
+    isVisible(): boolean;
+    /**
+     * Subscribe to visibility transitions. The callback receives the new
+     * visibility state (`true` = visible). Returns an unsubscribe function
+     * that must detach every listener registered by this call.
+     */
+    onChange(cb: (visible: boolean) => void): () => void;
+}
+
+export type { VisibilityProvider as V };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pollar/core",
-  "version": "0.7.1",
+  "version": "0.8.1",
   "description": "Core authentication functions for Pollar services",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -46,6 +46,16 @@
         "types": "./dist/adapters/react-native-keychain.d.ts",
         "default": "./dist/adapters/react-native-keychain.js"
       }
+    },
+    "./adapters/react-native-appstate": {
+      "import": {
+        "types": "./dist/adapters/react-native-appstate.d.mts",
+        "default": "./dist/adapters/react-native-appstate.mjs"
+      },
+      "require": {
+        "types": "./dist/adapters/react-native-appstate.d.ts",
+        "default": "./dist/adapters/react-native-appstate.js"
+      }
     }
   },
   "files": [
@@ -60,15 +70,18 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "lint": "tsc --noEmit",
+    "lint": "tsc --noEmit && eslint src",
     "clean": "rm -rf dist"
   },
   "engines": {
     "node": ">=20"
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "eslint": "^9.39.4",
     "tsup": "^8.3.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.58.1"
   },
   "dependencies": {
     "@noble/curves": "~1.9.7",