refactor: le paquet s'appelle polyfill, « SDK » désigne celui de NextGraph

Le nom @ng-eventually/sdk entrait en collision avec le SDK de NextGraph, dont ce paquet est justement un polyfill. Impossible d'écrire « le SDK » sans lever l'ambiguïté à chaque phrase — et le contrat publié, lu par une application, était le pire endroit pour laisser traîner ça. packages/sdk → packages/polyfill, @ng-eventually/sdk → @ng-eventually/polyfill, contract_sdk-surface → contract_polyfill-surface, e2e/sdk-entry.ts → e2e/polyfill-entry.ts, docs/sdk-reference.md → docs/polyfill-reference.md. Les occurrences de « SDK » qui désignent celui de NextGraph restent intactes, y compris les chemins dans nextgraph-rs (sdk/js/orm, sdk/js/web). Le tri s'est fait occurrence par occurrence, pas par substitution. Le contrat énonce désormais son identité en une phrase : « This package is a polyfill of NextGraph's SDK. »
2026-08-10 17:14:25 +02:00
parent 49b046268e
commit 737729c9ce
88 changed files with 122 additions and 106 deletions
@@ -0,0 +1,75 @@
+import { test, expect } from "bun:test";
+import {
+  IdentityStore,
+  browserIdentityStore,
+  ACCOUNT_STORAGE_KEY,
+  type VirtualUserStorage,
+} from "../src/shared-wallet/virtual-users";
+
+// In-memory fake of the Storage subset — keeps this framework/DOM-agnostic.
+function fakeStorage(): VirtualUserStorage & { map: Map<string, string> } {
+  const map = new Map<string, string>();
+  return {
+    map,
+    getItem: (k) => (map.has(k) ? (map.get(k) as string) : null),
+    setItem: (k, v) => void map.set(k, v),
+    removeItem: (k) => void map.delete(k),
+  };
+}
+
+test("IdentityStore: set persists a trimmed id, get reads it back", () => {
+  const s = fakeStorage();
+  const store = new IdentityStore(s);
+  expect(store.get()).toBeNull();
+
+  expect(store.set("  marie ")).toBe("marie"); // trimmed
+  expect(store.get()).toBe("marie");
+  expect(s.map.get(ACCOUNT_STORAGE_KEY)).toBe("marie");
+});
+
+test("IdentityStore: a blank id is ignored, keeps the previous value", () => {
+  const store = new IdentityStore(fakeStorage());
+  store.set("bob");
+  expect(store.set("   ")).toBe("bob");
+  expect(store.get()).toBe("bob");
+});
+
+test("IdentityStore: clear removes the id (no throw)", () => {
+  const store = new IdentityStore(fakeStorage());
+  store.set("bob");
+  store.clear();
+  expect(store.get()).toBeNull();
+});
+
+test("IdentityStore: null storage degrades to non-persisting (SSR-safe)", () => {
+  const store = new IdentityStore(null);
+  expect(store.get()).toBeNull();
+  expect(store.set("bob")).toBe("bob"); // returns the value, just doesn't persist
+  expect(store.get()).toBeNull();
+  store.clear(); // no throw
+});
+
+test("IdentityStore: swallows storage errors on read and write", () => {
+  const throwing: VirtualUserStorage = {
+    getItem: () => {
+      throw new Error("boom");
+    },
+    setItem: () => {
+      throw new Error("boom");
+    },
+    removeItem: () => {
+      throw new Error("boom");
+    },
+  };
+  const store = new IdentityStore(throwing);
+  expect(store.get()).toBeNull(); // read error swallowed → null
+  expect(() => store.set("bob")).not.toThrow();
+  expect(() => store.clear()).not.toThrow();
+});
+
+test("browserIdentityStore returns a working store (uses global localStorage if present)", () => {
+  const store = browserIdentityStore("ng-eventually.test.account");
+  expect(store).toBeInstanceOf(IdentityStore);
+  // Behaves regardless of environment: set returns the value.
+  expect(store.set("zoe")).toBe("zoe");
+});