@prometheus-ags/entity-graph-core 3.0.3 → 3.0.5

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # @prometheus-ags/entity-graph-core
 
+## 3.0.5
+
+### Patch Changes
+
+- Resolve imperative graph access against the active graph instead of the package
+  singleton, so `GraphStoreProvider` scopes `useGraphStore.getState()`,
+  `.setState()`, `.subscribe()` and `.getInitialState()` (issue #42).
+
+  3.0.4 replaced the copied StoreApi with delegates that warned but still targeted
+  the singleton, which left consumers using the documented imperative API with no
+  isolation. The React binding now proxies those methods, resolving per call.
+
+  New in `entity-graph-core`:
+  - `runWithGraphStore(store, fn)` — an `AsyncLocalStorage` request scope, so
+    concurrent server renders never share entity state.
+  - `prepareGraphStoreScope()` — awaited once during startup on **pure-ESM**
+    servers, where there is no synchronous `require` to load `node:async_hooks`.
+    Without it request scoping degrades to a module-level store and warns.
+  - `setActiveGraphStore(store)` — the module-level active store, set by
+    `GraphStoreProvider` on mount and restored on unmount.
+  - `resolveActiveGraphStore(fallback)` — request scope → module-level store →
+    fallback.
+
+  `node:async_hooks` is loaded lazily and never statically imported, so browser
+  bundles are unaffected. With no provider and no request scope, behaviour is
+  unchanged from 3.0.4, and the deprecation warning is gone because the methods
+  now do what callers expected.
+
+## 3.0.4
+
 ## 3.0.3
 
 ### Patch Changes

package/dist/index.cjs

@@ -4,6 +4,13 @@ var vanilla = require('zustand/vanilla');
 var middleware = require('zustand/middleware');
 var immer = require('zustand/middleware/immer');
 
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
 // src/errors.ts
 var TerminalError = class _TerminalError extends Error {
   kind = "terminal";
@@ -70,6 +77,88 @@ function getRegisteredEntityTypes() {
   return Array.from(transports.keys());
 }
 
+// src/active-store.ts
+var moduleActiveStore = null;
+var asyncScope = null;
+var asyncScopeAttempted = false;
+function isNodeLike() {
+  return typeof process !== "undefined" && typeof process.versions?.node === "string";
+}
+function resolveAsyncScope() {
+  if (asyncScopeAttempted) return asyncScope;
+  asyncScopeAttempted = true;
+  if (!isNodeLike()) return null;
+  try {
+    const req = typeof module !== "undefined" && typeof module.require === "function" ? module.require : typeof __require === "function" ? __require : null;
+    if (!req) return null;
+    const { AsyncLocalStorage } = req("node:async_hooks");
+    asyncScope = new AsyncLocalStorage();
+  } catch {
+    asyncScope = null;
+  }
+  return asyncScope;
+}
+async function prepareGraphStoreScope() {
+  if (asyncScope) return true;
+  if (!isNodeLike()) {
+    asyncScopeAttempted = true;
+    return false;
+  }
+  if (resolveAsyncScope()) return true;
+  try {
+    const specifier = "node:async_hooks";
+    const mod = await import(
+      /* @vite-ignore */
+      specifier
+    );
+    asyncScope = new mod.AsyncLocalStorage();
+    asyncScopeAttempted = true;
+    return true;
+  } catch {
+    asyncScopeAttempted = true;
+    return false;
+  }
+}
+function setActiveGraphStore(store) {
+  const previous = moduleActiveStore;
+  moduleActiveStore = store;
+  return () => {
+    moduleActiveStore = previous;
+  };
+}
+var warnedUnscopedFallback = false;
+function warnUnscopedRequestFallback() {
+  if (warnedUnscopedFallback || !isNodeLike()) return;
+  warnedUnscopedFallback = true;
+  console.warn(
+    "[entity-graph-core] runWithGraphStore() could not load node:async_hooks, so it fell back to a module-level store. Concurrent requests will NOT be isolated. Await prepareGraphStoreScope() once during server startup."
+  );
+}
+function runWithGraphStore(store, fn) {
+  const scope = resolveAsyncScope();
+  if (!scope) {
+    warnUnscopedRequestFallback();
+    const restore = setActiveGraphStore(store);
+    try {
+      return fn();
+    } finally {
+      restore();
+    }
+  }
+  return scope.run(store, fn);
+}
+function resolveActiveGraphStore(fallback) {
+  const scoped = resolveAsyncScope()?.getStore();
+  if (scoped) return scoped;
+  return moduleActiveStore ?? fallback;
+}
+function __resetActiveGraphStore() {
+  moduleActiveStore = null;
+  asyncScope = null;
+  asyncScopeAttempted = false;
+  warnedUnscopedFallback = false;
+}
+
 // src/view/prisma-compile.ts
 function nestWhereField(parts, leaf) {
   if (parts.length === 0) return {};
@@ -3956,6 +4045,7 @@ exports.IncrementalView = IncrementalView;
 exports.RealtimeManager = RealtimeManager;
 exports.TerminalError = TerminalError;
 exports.TransientError = TransientError;
+exports.__resetActiveGraphStore = __resetActiveGraphStore;
 exports.__resetEntityTransports = __resetEntityTransports;
 exports.__resetStoreRegistry = __resetStoreRegistry;
 exports.applyAgUiDelta = applyAgUiDelta;
@@ -4033,6 +4123,7 @@ exports.matchesFilter = matchesFilter;
 exports.matchesSearch = matchesSearch;
 exports.parseCreateTable = parseCreateTable;
 exports.persistGraphToStorage = persistGraphToStorage;
+exports.prepareGraphStoreScope = prepareGraphStoreScope;
 exports.publishFlintMutation = publishFlintMutation;
 exports.queryOnce = queryOnce;
 exports.readRelations = readRelations;
@@ -4049,10 +4140,13 @@ exports.registryKey = registryKey;
 exports.renderMarkdownToHtml = renderMarkdownToHtml;
 exports.replayActionWithRetry = replayActionWithRetry;
 exports.resetRealtimeManager = resetRealtimeManager;
+exports.resolveActiveGraphStore = resolveActiveGraphStore;
 exports.restoreGraphSnapshot = restoreGraphSnapshot;
 exports.restoreGraphSnapshotBySeq = restoreGraphSnapshotBySeq;
+exports.runWithGraphStore = runWithGraphStore;
 exports.selectGraph = selectGraph;
 exports.serializeKey = serializeKey;
+exports.setActiveGraphStore = setActiveGraphStore;
 exports.setDefaultMergeStrategy = setDefaultMergeStrategy;
 exports.setValueAtPath = setValueAtPath;
 exports.sqlTypeToJsonSchema = sqlTypeToJsonSchema;