Initial scaffold: @ng-eventually/client — SDK-shaped polyfill over NextGraph

Generic polyfill layer that makes a single NextGraph broker behave like the not-yet-shipped multi-user NextGraph (emulated capabilities + inbox). Zero app domain. @ng-eventually/client exposes an SDK-identical surface (ng, useShape, inbox); the polyfill bootstrap (configure + capability helpers) is isolated under /polyfill, so the main entry stays a drop-in for @ng-org/web|orm. The real SDK is injected at configure() (no hard import → build-alias safe + testable). Scaffold: NextGraph wiring stubbed with TODO; capability helpers implemented and unit-tested (4 tests, typecheck clean). The global-index curator is deferred — in NextGraph apps/services are mono-user with no global data. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-22 16:35:40 +02:00
commit bb2d9c3e59
16 changed files with 448 additions and 0 deletions
@@ -0,0 +1,40 @@
+/**
+ * The wrapped `ng`: a Proxy that forwards every method to the real SDK and
+ * overrides only what the broker/verifier will do natively at migration. The
+ * surface stays identical to `@ng-org/web`'s `ng`.
+ */
+
+import { getConfig } from "./polyfill";
+
+export function makeNg(): Record<string, any> {
+  return new Proxy({} as Record<string, any>, {
+    get(_target, prop: string) {
+      const { ng } = getConfig();
+
+      // login / session_start → open the SHARED wallet invisibly.
+      if (prop === "login" || prop === "session_start") {
+        return (...args: any[]) => {
+          // TODO(polyfill): supply shared-wallet credentials so no wallet UI
+          // is shown. For now, passthrough.
+          return ng[prop]!(...args);
+        };
+      }
+
+      // sparql_update → write guard (emulated write-cap check).
+      if (prop === "sparql_update") {
+        return (...args: any[]) => {
+          // TODO(polyfill): reject when getCurrentUser() lacks the write grant
+          // on the target document (see access.canWrite). For now, passthrough.
+          return ng.sparql_update!(...args);
+        };
+      }
+
+      // TODO(anticipated API): inbox_post_link + capability operations — expose
+      // here with their anticipated signatures, emulated for now.
+
+      // Everything else: passthrough to the real SDK, unchanged.
+      const real = ng[prop];
+      return typeof real === "function" ? real.bind(ng) : real;
+    },
+  });
+}