wenay-react2 1.0.51 → 1.0.52

package/doc/changes/v1.0.52.md

@@ -0,0 +1,9 @@
+# v1.0.52
+
+Date: 2026-07-14
+
+- Changed: upgraded `wenay-common2` from `^1.0.75` to `^1.0.76`.
+- Upstream WebRTC maintenance: direct replay now preserves binary `Uint8Array` Media frames across relay/direct hand-offs, and dynamic per-account replay mirrors acquire and release independently.
+- React impact: none. The fixes stay below the React surface; existing `useReplaySubscribe`, route and media consumers require no migration.
+
+Verification: installed dependency documentation inspected; `npx tsc -p tsconfig.qa-check.json --noEmit`; full Jest; library build; `git diff --check`.

package/doc/wenay-react2-rare.md

@@ -555,7 +555,8 @@ useReplayHistory(history, apply, {head?, reset?, tickMs?=300, autoPlay?=true})
   -> {live, seq, head, pause(), play(), seek({seq?|ts?})}
 ```
 Semantics that are easy to get wrong:
-- **Identity and reconnect boundary (common2 1.0.75).** `remote` identifies one logical Replay line. A temporary Socket.IO disconnect/reconnect keeps that object identity, so the React effect stays mounted while common2 rebinds the physical Listen subscription, restores live delivery first, catches up from its private `lastDelivered seq`, drains the racing queue, and deduplicates. Do not call `restart()`, remount with a new key, replace `remote`, poll, or attach transport listeners in React. The retained journal must cover the cursor; a sacred-line eviction with no keyframe is terminal `error`/`onError`, never a silent reset to `since: 0` or latest. `policy: 'queue'` is lossless and must deliver every retained event exactly once; `policy: 'frame'` is explicitly lossy/conflated and is not a journal-integrity check.
+- **common2 1.0.76 WebRTC maintenance.** Direct replay now uses a portable binary codec, preserving `Uint8Array` Media frames byte-for-byte across relay → WebRTC direct → relay hand-offs. Per-account replay mirrors also start and stop independently as accounts appear or disappear. These are core transport/lifecycle fixes: no React API or application wiring changes are required.
+- **Identity and reconnect boundary (common2 1.0.75).** `remote` identifies one logical Replay line. A temporary Socket.IO disconnect/reconnect keeps that object identity, so the React effect stays mounted while common2 rebinds the physical Listen subscription, restores live delivery first, catches up from its private `lastDelivered seq`, drains the racing queue, and deduplicates. Do not call `restart()`, remount with a new key, replace `remote`, poll, or attach transport listeners in React. The retained journal must cover the cursor; a sacred-line eviction with no keyframe is terminal `error`/`onError`, never a silent reset to `since: 0` or latest. `policy: 'queue'` is lossless and must deliver every retained event exactly once; `policy: 'frame'` is explicitly lossy/conflated and is not a journal-integrity check.
 **Identity matrix**
 - **Hard teardown is intentional.** `client.close()`/`dispose()` and hub `connect()`/`setToken()` end the old logical generation. React must clean up normally and must not resurrect that subscription automatically; after an intentional new client or credentials generation, provide its new `remote` as a normal new subscription. Ordinary RPC/pipe calls are not replayed by this contract.
 - `cb`/`apply` go through refs: new function identity does NOT resubscribe. Resubscribe identity is `[remote, enabled, epoch, staleMs, policy]` — changing `staleMs` resubscribes (it is subscribe-time config in common2; under keepSeq the reconnect is a journal tail, so it is cheap); `policy` picks the wire surface (line vs frameLine), so it resubscribes too. `onStale` goes through a ref like `cb`.

package/package.json

@@ -1,54 +1,54 @@
-{
-  "name": "wenay-react2",
-  "version": "1.0.51",
-  "description": "Common react",
-  "strict": true,
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "lib/**/*",
-    "doc/**/*",
-    "!**/*.tsbuildinfo"
-  ],
-  "author": "wenay",
-  "license": "ISC",
-  "peerDependenciesMeta": {
-    "react-dom": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "ag-grid-community": "^35.1.0",
-    "ag-grid-react": "^35.1.0",
-    "re-resizable": "^6.11.2",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "react-rnd": "^10.5.3",
-    "wenay-common2": "^1.0.75"
-  },
-  "peerDependencies": {
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0"
-  },
-  "engines": {
-    "node": ">=18",
-    "vscode": "^1.22.0"
-  },
-  "browserslist": {
-    "production": [
-      ">0.2%",
-      "not dead"
-    ],
-    "development": [
-      ">1%"
-    ]
-  },
-  "exports": {
-    ".": "./lib/index.js",
-    "./native": "./lib/native/index.js",
-    "./package.json": "./package.json",
-    "./demo/peer-media": "./lib/common/demo/peerMedia.js",
-    "./demo/peer-conference": "./lib/common/demo/peerConference.js",
-    "./demo/stand": "./lib/common/testUseReact/qa.js"
-  }
-}
+{
+  "name": "wenay-react2",
+  "version": "1.0.52",
+  "description": "Common react",
+  "strict": true,
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "lib/**/*",
+    "doc/**/*",
+    "!**/*.tsbuildinfo"
+  ],
+  "author": "wenay",
+  "license": "ISC",
+  "peerDependenciesMeta": {
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "ag-grid-community": "^35.1.0",
+    "ag-grid-react": "^35.1.0",
+    "re-resizable": "^6.11.2",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-rnd": "^10.5.3",
+    "wenay-common2": "^1.0.76"
+  },
+  "peerDependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "engines": {
+    "node": ">=18",
+    "vscode": "^1.22.0"
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead"
+    ],
+    "development": [
+      ">1%"
+    ]
+  },
+  "exports": {
+    ".": "./lib/index.js",
+    "./native": "./lib/native/index.js",
+    "./package.json": "./package.json",
+    "./demo/peer-media": "./lib/common/demo/peerMedia.js",
+    "./demo/peer-conference": "./lib/common/demo/peerConference.js",
+    "./demo/stand": "./lib/common/testUseReact/qa.js"
+  }
+}