@couch-kit/core 0.8.0 → 0.8.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @couch-kit/core
 
+## 0.8.2
+
+### Patch Changes
+
+- [#31](https://github.com/faluciano/react-native-couch-kit/pull/31) [`e5178dc`](https://github.com/faluciano/react-native-couch-kit/commit/e5178dc666f95c2893e803f1f290abcfd7db6306) Thanks [@faluciano](https://github.com/faluciano)! - Fall back to legacy player ID derivation when `crypto.subtle` is unavailable (React Native / Hermes). Previously, `derivePlayerId` unconditionally called `crypto.subtle.digest("SHA-256", ...)` which threw in Hermes, silently preventing the JOIN handshake from completing and leaving clients stuck on a loading spinner.
+
+## 0.8.1
+
+### Patch Changes
+
+- [#27](https://github.com/faluciano/react-native-couch-kit/pull/27) [`4976357`](https://github.com/faluciano/react-native-couch-kit/commit/49763573df502e394d5591b73000f48ee711d7a8) Thanks [@faluciano](https://github.com/faluciano)! - Fix WebSocket connection failure caused by path mismatch: the client connected to `ws://host:8082` (root path `/`) while the server only accepted upgrades on `/ws`. Added shared `DEFAULT_WS_PATH` constant to `@couch-kit/core` and use it in both client URL construction and server handler registration.
+
 ## 0.8.0
 
 ### Minor Changes

package/dist/index.js

@@ -161,6 +161,7 @@ var MessageTypes = {
 // src/constants.ts
 var DEFAULT_HTTP_PORT = 8080;
 var DEFAULT_WS_PORT_OFFSET = 2;
+var DEFAULT_WS_PATH = "/ws";
 var MAX_FRAME_SIZE = 1024 * 1024;
 var DEFAULT_MAX_RETRIES = 5;
 var DEFAULT_BASE_DELAY = 1000;
@@ -188,9 +189,12 @@ function isValidSecret(secret) {
   return hex.length >= 32 && /^[0-9a-f]+$/i.test(hex);
 }
 async function derivePlayerId(secret) {
-  const data = new TextEncoder().encode(secret);
-  const hash = await crypto.subtle.digest("SHA-256", data);
-  return Array.from(new Uint8Array(hash)).map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, 16);
+  if (typeof crypto !== "undefined" && typeof crypto.subtle?.digest === "function") {
+    const data = new TextEncoder().encode(secret);
+    const hash = await crypto.subtle.digest("SHA-256", data);
+    return Array.from(new Uint8Array(hash)).map((b) => b.toString(16).padStart(2, "0")).join("").slice(0, 16);
+  }
+  return derivePlayerIdLegacy(secret);
 }
 function derivePlayerIdLegacy(secret) {
   return secret.replace(/-/g, "").slice(0, 16);
@@ -240,6 +244,7 @@ export {
   KEEPALIVE_INTERVAL,
   InternalActionTypes,
   DEFAULT_WS_PORT_OFFSET,
+  DEFAULT_WS_PATH,
   DEFAULT_SYNC_INTERVAL,
   DEFAULT_MAX_RETRIES,
   DEFAULT_MAX_DELAY,

package/lib/constants.d.ts

@@ -3,6 +3,8 @@
 export declare const DEFAULT_HTTP_PORT = 8080;
 /** Default WebSocket port offset from the HTTP port (skips Metro on +1). */
 export declare const DEFAULT_WS_PORT_OFFSET = 2;
+/** Default WebSocket endpoint path on the host server. */
+export declare const DEFAULT_WS_PATH = "/ws";
 /** @deprecated Not used by Couch Kit internals. Will be removed in the next major version. */
 export declare const MAX_FRAME_SIZE: number;
 /** Default maximum reconnection attempts for the client. */
@@ -37,6 +39,9 @@ export declare function isValidSecret(secret: string): boolean;
  *
  * Takes the first 16 hex characters of the SHA-256 hash, producing
  * a deterministic ID that cannot be reversed to recover the secret.
+ *
+ * Falls back to {@link derivePlayerIdLegacy} when the Web Crypto API
+ * (`crypto.subtle`) is unavailable (e.g. React Native / Hermes).
  */
 export declare function derivePlayerId(secret: string): Promise<string>;
 /**

package/lib/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,8FAA8F;AAC9F,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,QAAgB,CAAC;AAExD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAwBnC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOpE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGrD"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,oDAAoD;AACpD,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAEtC,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,0DAA0D;AAC1D,eAAO,MAAM,eAAe,QAAQ,CAAC;AAErC,8FAA8F;AAC9F,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,4CAA4C;AAC5C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,+EAA+E;AAC/E,eAAO,MAAM,0BAA0B,QAAgB,CAAC;AAExD,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAwBnC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAepE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGrD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@couch-kit/core",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "publishConfig": {
     "access": "public",
     "provenance": true

package/src/constants.ts

@@ -6,6 +6,9 @@ export const DEFAULT_HTTP_PORT = 8080;
 /** Default WebSocket port offset from the HTTP port (skips Metro on +1). */
 export const DEFAULT_WS_PORT_OFFSET = 2;
 
+/** Default WebSocket endpoint path on the host server. */
+export const DEFAULT_WS_PATH = "/ws";
+
 /** @deprecated Not used by Couch Kit internals. Will be removed in the next major version. */
 export const MAX_FRAME_SIZE = 1024 * 1024;
 
@@ -78,14 +81,25 @@ export function isValidSecret(secret: string): boolean {
  *
  * Takes the first 16 hex characters of the SHA-256 hash, producing
  * a deterministic ID that cannot be reversed to recover the secret.
+ *
+ * Falls back to {@link derivePlayerIdLegacy} when the Web Crypto API
+ * (`crypto.subtle`) is unavailable (e.g. React Native / Hermes).
  */
 export async function derivePlayerId(secret: string): Promise<string> {
-  const data = new TextEncoder().encode(secret);
-  const hash = await crypto.subtle.digest("SHA-256", data);
-  return Array.from(new Uint8Array(hash))
-    .map((b) => b.toString(16).padStart(2, "0"))
-    .join("")
-    .slice(0, 16);
+  if (
+    typeof crypto !== "undefined" &&
+    typeof crypto.subtle?.digest === "function"
+  ) {
+    const data = new TextEncoder().encode(secret);
+    const hash = await crypto.subtle.digest("SHA-256", data);
+    return Array.from(new Uint8Array(hash))
+      .map((b) => b.toString(16).padStart(2, "0"))
+      .join("")
+      .slice(0, 16);
+  }
+
+  // Web Crypto unavailable (React Native / Hermes) — fall back to legacy derivation
+  return derivePlayerIdLegacy(secret);
 }
 
 /**