@peers-app/peers-sdk 0.16.4 → 0.16.6

package/dist/utils.js

@@ -9,6 +9,8 @@ exports.idDate = idDate;
 exports.idRandNums = idRandNums;
 exports.simpleHash = simpleHash;
 exports.simpleObjectHash = simpleObjectHash;
+exports.deterministicPvarId = deterministicPvarId;
+exports.isDeterministicPvarId = isDeterministicPvarId;
 exports.sleep = sleep;
 exports.camelCaseToSpaces = camelCaseToSpaces;
 exports.camelCaseToHyphens = camelCaseToHyphens;
@@ -119,6 +121,43 @@ function simpleHash(str) {
 function simpleObjectHash(obj) {
     return simpleHash(stableStringify(obj));
 }
+/** Well-known prefix for deterministic persistent variable IDs. */
+const DETERMINISTIC_PVAR_PREFIX = "000pvar0";
+/**
+ * Converts a byte array to a base-36 string of the requested length, using unbiased modular reduction.
+ * Bytes >= 252 are skipped to avoid bias (same technique as {@link cryptoRandomString}).
+ */
+function bytesToBase36(bytes, length) {
+    let s = "";
+    for (let i = 0; i < bytes.length && s.length < length; i++) {
+        const n = bytes[i];
+        if (n >= 252)
+            continue;
+        s += (n % 36).toString(36);
+    }
+    return s.substring(0, length);
+}
+/**
+ * Generates a deterministic 25-character peer ID for a persistent variable.
+ * The ID has the fixed prefix `000pvar0` (8 chars) followed by 17 base-36 characters
+ * derived from a SHA-512 hash of the input name. Two calls with the same name always
+ * return the same ID.
+ *
+ * @param name The persistent variable name as stored in the database
+ *   (already includes group suffixes for groupDevice/groupUser scopes)
+ */
+function deterministicPvarId(name) {
+    const hashSuffixLength = 25 - DETERMINISTIC_PVAR_PREFIX.length; // 17
+    const hash = nacl.hash(new TextEncoder().encode(name)); // 64-byte SHA-512
+    return DETERMINISTIC_PVAR_PREFIX + bytesToBase36(hash, hashSuffixLength);
+}
+/**
+ * Returns whether a peer ID was generated by {@link deterministicPvarId}
+ * (starts with the `000pvar0` prefix).
+ */
+function isDeterministicPvarId(id) {
+    return id.startsWith(DETERMINISTIC_PVAR_PREFIX);
+}
 /** Resolves after `ms` milliseconds (0 yields a microtask-yield on most runtimes). */
 function sleep(ms = 0) {
     return new Promise((resolve) => setTimeout(resolve, ms));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peers-app/peers-sdk",
-  "version": "0.16.4",
+  "version": "0.16.6",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/peers-app/peers-sdk.git"