@recapi/client 0.6.1 → 0.6.2

package/README.md

@@ -35,7 +35,7 @@ are, gzipped, and browsers cache them for a year:
 
 ```html
 <script type="module">
-  import { createClient } from 'https://api.example.com/sdk/0.6.1/index.js';
+  import { createClient } from 'https://api.example.com/sdk/0.6.2/index.js';
 
   const recapi = createClient({ apiKey: 'rk_pub_…', baseUrl: 'https://api.example.com' });
   recapi.track('item-42', 'view');    // and the calls of the quick start below
@@ -778,9 +778,16 @@ const storage = {
   setItem: (k, v) => { cache.set(k, v); AsyncStorage.setItem(k, v); },
   removeItem: (k) => { cache.delete(k); AsyncStorage.removeItem(k); }
 };
-createClient({ apiKey, baseUrl, project: 'myproject', storage });
+const client = createClient({ apiKey, baseUrl, project: 'myproject', storage });
 ```
 
+React Native has no page-hide event, so send the queue when the app leaves
+the screen: call `client.flush()` when `AppState` changes to `background`.
+`popular()` and the fallback list work on React Native below 0.80 as well,
+whose `URLSearchParams` has no working `set`. We read that class in React
+Native's 0.79 and 0.80 sources and test against a copy of its behaviour; the
+library has not been run on a device.
+
 Corrupt or unrecognised stored data is discarded. Bumping the `v1` in the
 key on a format change makes old data invisible.
 
@@ -795,6 +802,10 @@ minifier, to keep zero dev dependencies.
 
 ## Changes
 
+- 2026-11-03: version 0.6.2. `popular()` and the fallback list of
+  `recommend()` no longer throw on React Native below 0.80, whose
+  `URLSearchParams.set` is not implemented. Query strings are unchanged
+  everywhere else.
 - 2026-11-02: version 0.6.1. The client draws its anonymous id at the
   first call instead of in `createClient`, so a back end on Cloudflare
   Workers may create it at module scope (it threw "Disallowed operation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recapi/client",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Browser and Node client for the recapi recommendation API: local decayed history, event batching, attribution.",
   "type": "module",
   "main": "./src/index.js",

package/src/transport.js

@@ -78,11 +78,12 @@ export function createTransport({ baseUrl, apiKey, fetch, timeoutMs: defaultTime
 
   /** @param {RequestOptions} options */
   async function request({ method, path, query, body, auth = 'header', keepalive = false, cache, timeoutMs }) {
+    // append, not set: React Native below 0.80 throws on set, and these names are unique.
     const params = new URLSearchParams();
     for (const [name, value] of Object.entries(query ?? {})) {
-      if (value !== undefined) params.set(name, String(value));
+      if (value !== undefined) params.append(name, String(value));
     }
-    if (auth === 'query') params.set('key', apiKey);
+    if (auth === 'query') params.append('key', apiKey);
     const qs = params.toString();
     const url = `${root}${path}${qs ? `?${qs}` : ''}`;