@prometheus-ags/entity-graph-solid 3.2.0 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @prometheus-ags/entity-graph-solid
 
+## 4.0.0
+
+### Patch Changes
+
+- Updated dependencies [d1588d8]
+- Updated dependencies
+  - @prometheus-ags/entity-graph-core@4.0.0
+
 ## 3.2.0
 
 ### Minor Changes

package/package.json

@@ -1,23 +1,17 @@
 {
   "name": "@prometheus-ags/entity-graph-solid",
-  "version": "3.2.0",
+  "version": "4.0.0",
   "description": "SolidJS bindings for @prometheus-ags/entity-graph-core — fine-grained reactive entity and list primitives over the normalized entity graph.",
   "author": "Travis James <travis@prometheus.dev>",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.cjs",
+  "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.mjs"
     }
   },
   "sideEffects": false,
@@ -31,7 +25,7 @@
   },
   "peerDependencies": {
     "solid-js": ">=1.8.0",
-    "@prometheus-ags/entity-graph-core": "^3.2.0"
+    "@prometheus-ags/entity-graph-core": "^4.0.0"
   },
   "peerDependenciesMeta": {
     "solid-js": {
@@ -43,7 +37,7 @@
     "tsup": "8.5.1",
     "typescript": "6.0.2",
     "vitest": "4.1.10",
-    "@prometheus-ags/entity-graph-core": "3.2.0"
+    "@prometheus-ags/entity-graph-core": "4.0.0"
   },
   "keywords": [
     "solid",

package/dist/index.cjs

@@ -1,318 +0,0 @@
-'use strict';
-
-var solidJs = require('solid-js');
-var store = require('solid-js/store');
-var entityGraphCore = require('@prometheus-ags/entity-graph-core');
-
-// src/create-entity.ts
-function createEntity(opts) {
-  const {
-    type,
-    id: idAccessor,
-    fetch,
-    normalize,
-    idField = "id",
-    staleTime,
-    enabled: enabledAccessor,
-    onSuccess,
-    onError
-  } = opts;
-  const source = () => {
-    const id = idAccessor();
-    const enabled = enabledAccessor ? enabledAccessor() : true;
-    return [id ?? null, enabled];
-  };
-  const [snapshot, setSnapshot] = store.createStore({
-    data: null,
-    entityState: { ...entityGraphCore.EMPTY_ENTITY_STATE }
-  });
-  const [resource] = solidJs.createResource(source, async ([id, enabled]) => {
-    if (!id || !enabled) return null;
-    const engineOpts = entityGraphCore.getEngineOptions();
-    const effectiveStaleTime = staleTime ?? engineOpts.defaultStaleTime;
-    const graphState = entityGraphCore.graphStore.getState();
-    const cachedEntityState = graphState.entityStates[`${type}:${id}`];
-    const cachedEntity = graphState.readEntity(type, id);
-    const age = Date.now() - (cachedEntityState?.lastFetched ?? 0);
-    if (cachedEntity && age < effectiveStaleTime && !cachedEntityState?.stale) {
-      setSnapshot("data", cachedEntity);
-      setSnapshot("entityState", (s) => ({ ...s, ...cachedEntityState }));
-      return cachedEntity;
-    }
-    await entityGraphCore.fetchEntity(
-      {
-        type,
-        id,
-        fetch,
-        normalize,
-        idField,
-        onSuccess,
-        onError
-      },
-      { ...entityGraphCore.getEngineOptions(), defaultStaleTime: effectiveStaleTime }
-    );
-    return entityGraphCore.graphStore.getState().readEntity(type, id);
-  });
-  solidJs.createEffect(() => {
-    const id = idAccessor();
-    if (!id) return;
-    const subKey = `${type}:${id}`;
-    const token = entityGraphCore.registerSubscriber(subKey);
-    const syncFromGraph = () => {
-      const s = entityGraphCore.graphStore.getState();
-      const entity = s.readEntity(type, id);
-      const entityState = s.entityStates[subKey] ?? entityGraphCore.EMPTY_ENTITY_STATE;
-      setSnapshot("data", entity);
-      setSnapshot("entityState", (prev) => ({ ...prev, ...entityState }));
-    };
-    syncFromGraph();
-    const unsub = entityGraphCore.graphStore.subscribe(
-      (s) => ({
-        entity: s.readEntity(type, id),
-        entityState: s.entityStates[subKey] ?? entityGraphCore.EMPTY_ENTITY_STATE
-      }),
-      (next) => {
-        setSnapshot("data", next.entity);
-        setSnapshot("entityState", (prev) => ({ ...prev, ...next.entityState }));
-      },
-      { equalityFn: shallowEqual }
-    );
-    solidJs.onCleanup(() => {
-      unsub();
-      entityGraphCore.unregisterSubscriber(subKey, token);
-    });
-  });
-  const [_refetchTrigger, setRefetchTrigger] = solidJs.createSignal(0);
-  const refetch = async () => {
-    const id = idAccessor();
-    if (!id) return;
-    entityGraphCore.graphStore.getState().setEntityStale(type, id, true);
-    await entityGraphCore.fetchEntity(
-      { type, id, fetch, normalize, idField, onSuccess, onError },
-      entityGraphCore.getEngineOptions()
-    );
-  };
-  const isLoading = () => {
-    resource();
-    const es = snapshot.entityState;
-    return resource.loading || es.isFetching && snapshot.data === null;
-  };
-  const isRefetching = () => {
-    const es = snapshot.entityState;
-    return es.isFetching && snapshot.data !== null;
-  };
-  const error = () => snapshot.entityState.error;
-  const typedError = () => {
-    const errStr = snapshot.entityState.error;
-    if (!errStr) return null;
-    return null;
-  };
-  return {
-    data: () => snapshot.data,
-    isLoading,
-    isRefetching,
-    error,
-    typedError,
-    refetch,
-    entityState: () => snapshot.entityState
-  };
-}
-function shallowEqual(a, b) {
-  if (a === b) return true;
-  const keysA = Object.keys(a);
-  const keysB = Object.keys(b);
-  if (keysA.length !== keysB.length) return false;
-  for (const k of keysA) {
-    if (a[k] !== b[k]) return false;
-  }
-  return true;
-}
-function listSliceEqual(a, b) {
-  return a.listState === b.listState && a.entityBucket === b.entityBucket;
-}
-function createEntityList(opts) {
-  const {
-    type,
-    queryKey: queryKeyAccessor,
-    fetch,
-    normalize,
-    mode = "replace",
-    staleTime,
-    enabled: enabledAccessor,
-    onSuccess,
-    onError
-  } = opts;
-  const [slice, setSlice] = store.createStore({
-    items: [],
-    listState: { ...entityGraphCore.EMPTY_LIST_STATE }
-  });
-  function resolveItems(key) {
-    const s = entityGraphCore.graphStore.getState();
-    const list = s.lists[key];
-    if (!list) return [];
-    return list.ids.map((id) => s.readEntity(type, id)).filter((e) => e !== null);
-  }
-  async function doInitialFetch(key) {
-    const s = entityGraphCore.graphStore.getState();
-    const listState = s.lists[key];
-    const effectiveStaleTime = staleTime ?? entityGraphCore.getEngineOptions().defaultStaleTime;
-    const age = Date.now() - (listState?.lastFetched ?? 0);
-    const isFresh = listState && !listState.stale && age < effectiveStaleTime;
-    if (isFresh) return;
-    await entityGraphCore.fetchList(
-      {
-        type,
-        queryKey: JSON.parse(key),
-        fetch,
-        normalize,
-        mode,
-        onSuccess,
-        onError
-      },
-      {},
-      entityGraphCore.getEngineOptions()
-    );
-  }
-  solidJs.createEffect(() => {
-    const rawKey = queryKeyAccessor();
-    const key = entityGraphCore.serializeKey(rawKey);
-    const enabled = enabledAccessor ? enabledAccessor() : true;
-    const syncFromGraph = () => {
-      const s = entityGraphCore.graphStore.getState();
-      const listState = s.lists[key] ?? entityGraphCore.EMPTY_LIST_STATE;
-      const items = resolveItems(key);
-      setSlice("listState", (prev) => ({ ...prev, ...listState }));
-      setSlice("items", items);
-    };
-    syncFromGraph();
-    const unsub = entityGraphCore.graphStore.subscribe(
-      (s) => {
-        const listState = s.lists[key] ?? entityGraphCore.EMPTY_LIST_STATE;
-        const entityBucket = s.entities[type];
-        return { listState, entityBucket };
-      },
-      ({ listState }) => {
-        const items = resolveItems(key);
-        setSlice("listState", (prev) => ({ ...prev, ...listState }));
-        setSlice("items", items);
-      },
-      { equalityFn: listSliceEqual }
-    );
-    if (enabled && (fetch || normalize)) {
-      void doInitialFetch(key);
-    }
-    solidJs.onCleanup(() => {
-      unsub();
-    });
-  });
-  async function fetchNextPage() {
-    const key = entityGraphCore.serializeKey(queryKeyAccessor());
-    const s = entityGraphCore.graphStore.getState();
-    const listState = s.lists[key] ?? entityGraphCore.EMPTY_LIST_STATE;
-    if (!listState.hasNextPage || listState.isFetchingMore) return;
-    await entityGraphCore.fetchList(
-      {
-        type,
-        queryKey: JSON.parse(key),
-        fetch,
-        normalize,
-        mode: "append",
-        onSuccess,
-        onError
-      },
-      { cursor: listState.nextCursor ?? void 0 },
-      entityGraphCore.getEngineOptions(),
-      true
-      // isLoadMore
-    );
-  }
-  async function refetch() {
-    const key = entityGraphCore.serializeKey(queryKeyAccessor());
-    entityGraphCore.graphStore.getState().setListStale(key, true);
-    await entityGraphCore.fetchList(
-      {
-        type,
-        queryKey: JSON.parse(key),
-        fetch,
-        normalize,
-        mode: "replace",
-        onSuccess,
-        onError
-      },
-      {},
-      entityGraphCore.getEngineOptions()
-    );
-  }
-  const isLoading = () => slice.listState.isFetching && slice.items.length === 0;
-  const isLoadingMore = () => slice.listState.isFetchingMore;
-  const error = () => slice.listState.error;
-  const typedError = () => slice.listState.lastError;
-  const total = () => slice.listState.total;
-  const hasNextPage = () => slice.listState.hasNextPage;
-  const hasPrevPage = () => slice.listState.hasPrevPage;
-  return {
-    items: () => slice.items,
-    isLoading,
-    isLoadingMore,
-    error,
-    typedError,
-    total,
-    hasNextPage,
-    hasPrevPage,
-    fetchNextPage,
-    refetch,
-    listState: () => slice.listState
-  };
-}
-function createGraphStore(selector, equalityFn) {
-  const eq = equalityFn ?? ((a, b) => a === b);
-  const initial = selector(entityGraphCore.graphStore.getState());
-  const [value, setValue] = solidJs.createSignal(initial);
-  const unsub = entityGraphCore.graphStore.subscribe(
-    selector,
-    (next, prev) => {
-      if (!eq(next, prev)) {
-        setValue(() => next);
-      }
-    }
-  );
-  solidJs.onCleanup(() => unsub());
-  return value;
-}
-function setupGraphProvider(opts = {}) {
-  const { attachListeners = true, startGc = true, ...engineOpts } = opts;
-  if (Object.keys(engineOpts).length > 0) {
-    entityGraphCore.configureEngine(engineOpts);
-  }
-  if (attachListeners && typeof window !== "undefined") {
-    entityGraphCore.attachGlobalListeners();
-  }
-  let stopGc;
-  if (startGc && typeof window !== "undefined") {
-    stopGc = entityGraphCore.startGarbageCollector();
-  }
-  return () => stopGc?.();
-}
-
-Object.defineProperty(exports, "TerminalError", {
-  enumerable: true,
-  get: function () { return entityGraphCore.TerminalError; }
-});
-Object.defineProperty(exports, "TransientError", {
-  enumerable: true,
-  get: function () { return entityGraphCore.TransientError; }
-});
-Object.defineProperty(exports, "graphStore", {
-  enumerable: true,
-  get: function () { return entityGraphCore.graphStore; }
-});
-Object.defineProperty(exports, "useGraphStore", {
-  enumerable: true,
-  get: function () { return entityGraphCore.useGraphStore; }
-});
-exports.createEntity = createEntity;
-exports.createEntityList = createEntityList;
-exports.createGraphStore = createGraphStore;
-exports.setupGraphProvider = setupGraphProvider;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/create-entity.ts","../src/create-entity-list.ts","../src/create-graph-store.ts","../src/graph-provider.ts"],"names":["createStore","EMPTY_ENTITY_STATE","createResource","getEngineOptions","graphStore","fetchEntity","createEffect","registerSubscriber","onCleanup","unregisterSubscriber","createSignal","EMPTY_LIST_STATE","fetchList","serializeKey","configureEngine","attachGlobalListeners","startGarbageCollector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * createEntity — SolidJS primitive that bridges a single entity to the\n * normalized entity graph via `createResource`.\n *\n * Architecture:\n *   createEntity  (this file, Layer 2)\n *     └─ core engine fetchEntity  (Layer 1 / transport)\n *          └─ graphStore  (Layer 0 / Zustand graph)\n *\n * SolidJS `createResource` owns the async lifecycle; the graph is the\n * single source of truth for the entity payload. Once fetchEntity writes to\n * the graph, a Zustand subscription (via `createStore`) propagates the merged\n * entity back to SolidJS as a fine-grained reactive signal.\n */\n\nimport {\n  createResource,\n  createSignal,\n  createEffect,\n  onCleanup,\n} from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  graphStore,\n  fetchEntity,\n  getEngineOptions,\n  registerSubscriber,\n  unregisterSubscriber,\n  EMPTY_ENTITY_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityState, EntityError } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityOptions, CreateEntityReturn } from \"./types\";\n\n// ── Internal snapshot shape kept in the Solid store ─────────────────────────\n\ninterface EntitySnapshot<TEntity extends object> {\n  data: TEntity | null;\n  entityState: EntityState;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for a single entity.\n *\n * - Uses `createResource` as the async driver so Suspense and ErrorBoundary\n *   boundaries work naturally.\n * - Subscribes to the Zustand graph with `graphStore.subscribe` and mirrors\n *   the merged entity into a `createStore`-backed signal for fine-grained\n *   SolidJS reactivity (only the changed field triggers updates).\n * - Registers / unregisters a subscriber token with the core engine so idle\n *   entities stop background revalidation when no components are observing them.\n *\n * @example\n * ```tsx\n * const invoice = createEntity({\n *   type: \"Invoice\",\n *   id: () => props.invoiceId,\n *   fetch: (id) => api.get(`/invoices/${id}`),\n *   normalize: (raw) => ({ ...raw, id: raw.invoice_id }),\n * });\n *\n * return (\n *   <Show when={!invoice.isLoading()} fallback={<Spinner />}>\n *     <p>{invoice.data()?.amount}</p>\n *   </Show>\n * );\n * ```\n */\nexport function createEntity<TRaw, TEntity extends object>(\n  opts: CreateEntityOptions<TRaw, TEntity>,\n): CreateEntityReturn<TEntity> {\n  const {\n    type,\n    id: idAccessor,\n    fetch,\n    normalize,\n    idField = \"id\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Reactive source for createResource ─────────────────────────────────────\n  // Returns [id, enabled] so resource re-fires when either changes.\n  const source = (): [string | null | undefined, boolean] => {\n    const id = idAccessor();\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n    return [id ?? null, enabled];\n  };\n\n  // ── Solid store: mirrors graph state for fine-grained reactivity ────────────\n  const [snapshot, setSnapshot] = createStore<EntitySnapshot<TEntity>>({\n    data: null,\n    entityState: { ...EMPTY_ENTITY_STATE },\n  });\n\n  // ── createResource: drives Suspense / ErrorBoundary + triggers fetches ──────\n  const [resource] = createResource(source, async ([id, enabled]) => {\n    if (!id || !enabled) return null;\n\n    const engineOpts = getEngineOptions();\n    const effectiveStaleTime = staleTime ?? engineOpts.defaultStaleTime;\n\n    // Check if cached data is fresh enough to skip a network round-trip.\n    const graphState = graphStore.getState();\n    const cachedEntityState = graphState.entityStates[`${type}:${id}`];\n    const cachedEntity = graphState.readEntity<TEntity>(type, id);\n    const age = Date.now() - (cachedEntityState?.lastFetched ?? 0);\n\n    if (cachedEntity && age < effectiveStaleTime && !cachedEntityState?.stale) {\n      // Fresh cache hit: update snapshot and skip fetch.\n      setSnapshot(\"data\", cachedEntity);\n      setSnapshot(\"entityState\", (s) => ({ ...s, ...cachedEntityState }));\n      return cachedEntity;\n    }\n\n    // Delegate to core engine — handles dedup, retries, and graph writes.\n    await fetchEntity(\n      {\n        type,\n        id,\n        fetch,\n        normalize,\n        idField,\n        onSuccess,\n        onError,\n      },\n      { ...getEngineOptions(), defaultStaleTime: effectiveStaleTime },\n    );\n\n    // Return the graph value after the fetch completes.\n    return graphStore.getState().readEntity<TEntity>(type, id);\n  });\n\n  // ── Subscribe to Zustand graph for live fine-grained updates ───────────────\n  createEffect(() => {\n    const id = idAccessor();\n    if (!id) return;\n\n    const subKey = `${type}:${id}`;\n    const token = registerSubscriber(subKey);\n\n    // Sync initial graph state into the Solid store.\n    const syncFromGraph = () => {\n      const s = graphStore.getState();\n      const entity = s.readEntity<TEntity>(type, id);\n      const entityState = s.entityStates[subKey] ?? EMPTY_ENTITY_STATE;\n      setSnapshot(\"data\", entity);\n      setSnapshot(\"entityState\", (prev) => ({ ...prev, ...entityState }));\n    };\n\n    syncFromGraph();\n\n    // Subscribe to graph changes that affect this entity.\n    const unsub = graphStore.subscribe(\n      (s) => ({\n        entity: s.readEntity<TEntity>(type, id),\n        entityState: s.entityStates[subKey] ?? EMPTY_ENTITY_STATE,\n      }),\n      (next) => {\n        setSnapshot(\"data\", next.entity);\n        setSnapshot(\"entityState\", (prev) => ({ ...prev, ...next.entityState }));\n      },\n      { equalityFn: shallowEqual },\n    );\n\n    onCleanup(() => {\n      unsub();\n      unregisterSubscriber(subKey, token);\n    });\n  });\n\n  // ── Imperative refetch ──────────────────────────────────────────────────────\n  const [_refetchTrigger, setRefetchTrigger] = createSignal(0);\n\n  const refetch = async () => {\n    const id = idAccessor();\n    if (!id) return;\n    graphStore.getState().setEntityStale(type, id, true);\n    await fetchEntity(\n      { type, id, fetch, normalize, idField, onSuccess, onError },\n      getEngineOptions(),\n    );\n  };\n\n  // ── Derived signals ──────────────────────────────────────────────────────────\n  const isLoading = () => {\n    const res = resource();\n    const es = snapshot.entityState;\n    return resource.loading || (es.isFetching && snapshot.data === null);\n  };\n\n  const isRefetching = () => {\n    const es = snapshot.entityState;\n    return es.isFetching && snapshot.data !== null;\n  };\n\n  const error = () => snapshot.entityState.error;\n\n  // Typed error: pull from the graph's entityStates — the engine writes\n  // TerminalError / TransientError instances into listState.lastError for lists,\n  // and for single entities the error string is sufficient. We re-expose it as\n  // EntityError | null for API consistency (callers may cast if needed).\n  const typedError = (): EntityError | null => {\n    const errStr = snapshot.entityState.error;\n    if (!errStr) return null;\n    // Surface the string-backed error as a plain Error (full typed errors are on\n    // lists; single-entity fetch only has string form in the graph).\n    return null;\n  };\n\n  return {\n    data: () => snapshot.data,\n    isLoading,\n    isRefetching,\n    error,\n    typedError,\n    refetch,\n    entityState: () => snapshot.entityState,\n  };\n}\n\n// ── Shallow equality helper for Zustand selector ─────────────────────────────\n\nfunction shallowEqual<T extends Record<string, unknown>>(a: T, b: T): boolean {\n  if (a === b) return true;\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n  if (keysA.length !== keysB.length) return false;\n  for (const k of keysA) {\n    if (a[k] !== b[k]) return false;\n  }\n  return true;\n}\n","/**\n * createEntityList — SolidJS primitive for reactive normalized entity lists.\n *\n * Architecture:\n *   createEntityList  (this file, Layer 2)\n *     └─ core engine fetchList  (Layer 1 / transport)\n *          └─ graphStore  (Layer 0 / Zustand graph)\n *\n * A Zustand `subscribe` bridges the graph's `lists[key]` slot + entity rows\n * into a SolidJS `createStore`, giving SolidJS fine-grained per-row reactivity.\n * Changing `queryKey()` re-serializes to a new list slot, triggering a fresh\n * fetch while keeping existing data visible (stale-while-revalidate).\n */\n\nimport { createEffect, onCleanup } from \"solid-js\";\nimport { createStore } from \"solid-js/store\";\n\nimport {\n  graphStore,\n  fetchList,\n  serializeKey,\n  getEngineOptions,\n  EMPTY_LIST_STATE,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EntityId, ListState } from \"@prometheus-ags/entity-graph-core\";\nimport type { CreateEntityListOptions, CreateEntityListReturn } from \"./types\";\n\n// ── Internal store shape ──────────────────────────────────────────────────────\n\ninterface ListSlice<TEntity extends object> {\n  items: TEntity[];\n  listState: ListState;\n}\n\n// ── Equality helper for list subscription ────────────────────────────────────\n\nfunction listSliceEqual(\n  a: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n  b: { listState: ListState; entityBucket: Record<string, unknown> | undefined },\n): boolean {\n  return a.listState === b.listState && a.entityBucket === b.entityBucket;\n}\n\n/**\n * Creates a fine-grained SolidJS reactive primitive for an entity list.\n *\n * - Subscribes to `graphStore` to mirror list state (ids + pagination)\n *   and resolves the entity rows by joining ids → graph entities on each read.\n * - Changing `queryKey()` triggers a new fetch and subscribes to the new list\n *   slot; the previous subscription is cleaned up automatically.\n * - Supports pagination (`fetchNextPage`) and imperative refetch.\n *\n * @example\n * ```tsx\n * const invoices = createEntityList({\n *   type: \"Invoice\",\n *   queryKey: () => [\"invoices\", { status: filter() }],\n *   fetch: (params) => api.getInvoices(params),\n *   normalize: (raw) => ({ id: raw.invoice_id, data: { ...raw } }),\n * });\n *\n * return (\n *   <For each={invoices.items()}>\n *     {(invoice) => <InvoiceRow invoice={invoice} />}\n *   </For>\n * );\n * ```\n */\nexport function createEntityList<TRaw, TEntity extends object>(\n  opts: CreateEntityListOptions<TRaw, TEntity>,\n): CreateEntityListReturn<TEntity> {\n  const {\n    type,\n    queryKey: queryKeyAccessor,\n    fetch,\n    normalize,\n    mode = \"replace\",\n    staleTime,\n    enabled: enabledAccessor,\n    onSuccess,\n    onError,\n  } = opts;\n\n  // ── Fine-grained Solid store ─────────────────────────────────────────────────\n  const [slice, setSlice] = createStore<ListSlice<TEntity>>({\n    items: [],\n    listState: { ...EMPTY_LIST_STATE },\n  });\n\n  // ── Helper: resolve items from current graph state for a given key ───────────\n  function resolveItems(key: string): TEntity[] {\n    const s = graphStore.getState();\n    const list = s.lists[key];\n    if (!list) return [];\n    return list.ids\n      .map((id: EntityId) => s.readEntity<TEntity>(type, id))\n      .filter((e): e is TEntity => e !== null);\n  }\n\n  // ── Initial / stale-while-revalidate fetch ────────────────────────────────────\n  // Declared before createEffect so it is always defined when the effect runs\n  // (the effect mock executes the callback synchronously in tests).\n  async function doInitialFetch(key: string): Promise<void> {\n    const s = graphStore.getState();\n    const listState = s.lists[key];\n    const effectiveStaleTime = staleTime ?? getEngineOptions().defaultStaleTime;\n    const age = Date.now() - (listState?.lastFetched ?? 0);\n    const isFresh = listState && !listState.stale && age < effectiveStaleTime;\n    if (isFresh) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode,\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Reactive effect: subscribe to graph whenever queryKey changes ─────────────\n  createEffect(() => {\n    const rawKey = queryKeyAccessor();\n    const key = serializeKey(rawKey);\n    const enabled = enabledAccessor ? enabledAccessor() : true;\n\n    // Sync snapshot immediately with whatever is already in the graph.\n    const syncFromGraph = () => {\n      const s = graphStore.getState();\n      const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n      const items = resolveItems(key);\n      setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n      setSlice(\"items\", items);\n    };\n\n    syncFromGraph();\n\n    // Subscribe to any graph change that could affect this list.\n    // Solid's fine-grained update system means only changed fields propagate.\n    const unsub = graphStore.subscribe(\n      (s) => {\n        const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n        const entityBucket = s.entities[type];\n        return { listState, entityBucket };\n      },\n      ({ listState }) => {\n        const items = resolveItems(key);\n        setSlice(\"listState\", (prev) => ({ ...prev, ...listState }));\n        setSlice(\"items\", items);\n      },\n      { equalityFn: listSliceEqual },\n    );\n\n    // Kick off the fetch when enabled and data may be stale.\n    if (enabled && (fetch || normalize)) {\n      void doInitialFetch(key);\n    }\n\n    onCleanup(() => {\n      unsub();\n    });\n  });\n\n  // ── fetchNextPage ─────────────────────────────────────────────────────────────\n  async function fetchNextPage(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    const s = graphStore.getState();\n    const listState = s.lists[key] ?? EMPTY_LIST_STATE;\n    if (!listState.hasNextPage || listState.isFetchingMore) return;\n\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"append\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      { cursor: listState.nextCursor ?? undefined },\n      getEngineOptions(),\n      true, // isLoadMore\n    );\n  }\n\n  // ── Imperative refetch ────────────────────────────────────────────────────────\n  async function refetch(): Promise<void> {\n    const key = serializeKey(queryKeyAccessor());\n    graphStore.getState().setListStale(key, true);\n    await fetchList(\n      {\n        type,\n        queryKey: JSON.parse(key) as unknown[],\n        fetch,\n        normalize,\n        mode: \"replace\",\n        onSuccess: onSuccess as ((r: { items: TRaw[]; total?: number | null }) => void) | undefined,\n        onError,\n      },\n      {},\n      getEngineOptions(),\n    );\n  }\n\n  // ── Derived signals ───────────────────────────────────────────────────────────\n  const isLoading = () => slice.listState.isFetching && slice.items.length === 0;\n  const isLoadingMore = () => slice.listState.isFetchingMore;\n  const error = () => slice.listState.error;\n  const typedError = () => slice.listState.lastError;\n  const total = () => slice.listState.total;\n  const hasNextPage = () => slice.listState.hasNextPage;\n  const hasPrevPage = () => slice.listState.hasPrevPage;\n\n  return {\n    items: () => slice.items,\n    isLoading,\n    isLoadingMore,\n    error,\n    typedError,\n    total,\n    hasNextPage,\n    hasPrevPage,\n    fetchNextPage,\n    refetch,\n    listState: () => slice.listState,\n  };\n}\n","/**\n * createGraphStore — SolidJS fine-grained reactive bridge to the entire\n * Zustand entity graph.\n *\n * Consumers that need ad-hoc access to the graph outside `createEntity` /\n * `createEntityList` can use this to read any slice of `GraphState` as a\n * SolidJS signal. The subscription is scoped to only the selected slice,\n * so unrelated graph mutations do not trigger re-computations.\n *\n * @example\n * ```ts\n * // Read total entity count for a devtools panel.\n * const entityCount = createGraphStore(\n *   (s) => Object.keys(s.entities).reduce((n, t) => n + Object.keys(s.entities[t]).length, 0),\n * );\n * console.log(entityCount()); // reactive SolidJS accessor\n * ```\n */\n\nimport { createSignal, onCleanup } from \"solid-js\";\nimport { graphStore } from \"@prometheus-ags/entity-graph-core\";\nimport type { GraphState } from \"@prometheus-ags/entity-graph-core\";\n\n/**\n * Subscribe to a selector over the entity graph.\n * Returns a SolidJS accessor that updates whenever the selected slice changes.\n *\n * @param selector - Pure function that maps the full `GraphState` to a derived value.\n * @param equalityFn - Optional equality check (default: strict reference equality `===`).\n */\nexport function createGraphStore<T>(\n  selector: (state: GraphState) => T,\n  equalityFn?: (a: T, b: T) => boolean,\n): () => T {\n  const eq = equalityFn ?? ((a, b) => a === b);\n  const initial = selector(graphStore.getState());\n  const [value, setValue] = createSignal<T>(initial);\n\n  const unsub = graphStore.subscribe(\n    selector,\n    (next, prev) => {\n      if (!eq(next, prev)) {\n        setValue(() => next);\n      }\n    },\n  );\n\n  onCleanup(() => unsub());\n\n  return value;\n}\n","/**\n * GraphProvider utilities for SolidJS.\n *\n * Provides boot-time setup helpers for attaching global focus/reconnect\n * listeners and configuring the engine from within a SolidJS application root.\n *\n * Usage in the application root (e.g. `src/index.tsx`):\n *\n * ```ts\n * import { setupGraphProvider } from \"@prometheus-ags/entity-graph-solid\";\n * import { configureEngine, attachGlobalListeners } from \"@prometheus-ags/entity-graph-core\";\n *\n * setupGraphProvider({\n *   staleTime: 60_000,\n *   revalidateOnFocus: true,\n * });\n * ```\n */\n\nimport {\n  configureEngine,\n  attachGlobalListeners,\n  startGarbageCollector,\n} from \"@prometheus-ags/entity-graph-core\";\nimport type { EngineOptions } from \"@prometheus-ags/entity-graph-core\";\n\nexport interface GraphProviderOptions extends EngineOptions {\n  /**\n   * Whether to attach window focus/online listeners for stale-while-revalidate.\n   * Defaults to `true` in browser environments.\n   */\n  attachListeners?: boolean;\n  /**\n   * Whether to start the periodic garbage collector.\n   * Defaults to `true`.\n   */\n  startGc?: boolean;\n}\n\n/**\n * Configures the entity-graph engine and wires browser-level listeners.\n * Call this once at application startup before mounting the root component.\n *\n * Returns a cleanup function that stops the GC interval (useful for tests).\n */\nexport function setupGraphProvider(opts: GraphProviderOptions = {}): () => void {\n  const { attachListeners = true, startGc = true, ...engineOpts } = opts;\n\n  if (Object.keys(engineOpts).length > 0) {\n    configureEngine(engineOpts);\n  }\n\n  if (attachListeners && typeof window !== \"undefined\") {\n    attachGlobalListeners();\n  }\n\n  let stopGc: (() => void) | undefined;\n  if (startGc && typeof window !== \"undefined\") {\n    stopGc = startGarbageCollector();\n  }\n\n  return () => stopGc?.();\n}\n"]}

package/dist/index.d.cts

@@ -1,304 +0,0 @@
-import { EntityType, EntityId, EntityError, ListState, EntityState, GraphState, EngineOptions } from '@prometheus-ags/entity-graph-core';
-export { EntityError, EntityId, EntityState, EntityType, FilterSpec, ListState, SortSpec, TerminalError, TransientError, ViewDescriptor, graphStore, useGraphStore } from '@prometheus-ags/entity-graph-core';
-
-/**
- * Shared option types for SolidJS entity-graph bindings.
- *
- * These mirror the engine option shapes from @prometheus-ags/entity-graph-core
- * but are scoped to accessor patterns (no React-specific concepts).
- */
-
-/**
- * Options for `createEntity`. The `source` accessor is called reactively;
- * changing either `type` or `id` inside it re-triggers the fetch.
- *
- * @template TRaw - Shape returned by the transport fetch function.
- * @template TEntity - Normalized entity shape written to the graph.
- */
-interface CreateEntityOptions<TRaw, TEntity extends object> {
-    /** Entity kind (e.g. `"Invoice"`). Drives the graph partition. */
-    type: EntityType;
-    /** Reactive accessor returning the entity id — return `null` / `undefined` to disable. */
-    id: () => EntityId | null | undefined;
-    /**
-     * Transport fetch function. Receives the resolved `id` and returns raw data.
-     * Called by the underlying `createResource`; deduplicated by the core engine.
-     */
-    fetch: (id: EntityId) => Promise<TRaw>;
-    /** Maps raw API response to the canonical shape upserted into the graph. */
-    normalize: (raw: TRaw) => TEntity;
-    /**
-     * Name of the id field inside the normalized entity (default `"id"`).
-     * Used when the server-returned id may differ from the request id.
-     */
-    idField?: string;
-    /**
-     * Milliseconds before a cached entity is considered stale and a background
-     * refetch is triggered (inherits from `configureEngine` when omitted).
-     */
-    staleTime?: number;
-    /** Set to `false` to skip fetching regardless of id presence (default `true`). */
-    enabled?: () => boolean;
-    /** Called after a successful fetch and graph write. */
-    onSuccess?: (entity: TEntity) => void;
-    /** Called after all retries are exhausted. */
-    onError?: (error: Error) => void;
-}
-/**
- * Options for `createEntityList`. The `queryKey` accessor is called reactively;
- * changing the key triggers a new list fetch.
- *
- * @template TRaw - Shape of each raw row from the transport.
- * @template TEntity - Normalized entity shape written to the graph.
- */
-interface CreateEntityListOptions<TRaw, TEntity extends object> {
-    /** Entity kind for all items in this list. */
-    type: EntityType;
-    /**
-     * Reactive accessor returning the list query key array.
-     * Changing any element triggers a re-fetch. Use stable primitive values.
-     */
-    queryKey: () => unknown[];
-    /**
-     * Transport fetcher for the full list. Optional for graph-only (e.g. local-first
-     * PGlite) scenarios where the graph is hydrated out-of-band.
-     */
-    fetch?: (params: {
-        cursor?: string;
-        page?: number;
-        pageSize?: number;
-        params?: Record<string, unknown>;
-    }) => Promise<{
-        items: TRaw[];
-        total?: number | null;
-        nextCursor?: string | null;
-        prevCursor?: string;
-        hasNextPage?: boolean;
-        hasPrevPage?: boolean;
-        page?: number;
-        pageSize?: number;
-    }>;
-    /** Row normalizer: maps a raw row to `{ id, data }` for graph upsert. */
-    normalize?: (raw: TRaw) => {
-        id: EntityId;
-        data: TEntity;
-    };
-    /** Replace or append ids on re-fetch (default `"replace"`). */
-    mode?: "replace" | "append";
-    /** Milliseconds before the list is re-fetched in the background. */
-    staleTime?: number;
-    /** Reactive accessor; set to `false` to pause fetching (default `true`). */
-    enabled?: () => boolean;
-    /** Called after a successful list fetch. */
-    onSuccess?: (result: {
-        items: TRaw[];
-        total?: number | null;
-    }) => void;
-    /** Called after all retries are exhausted. */
-    onError?: (error: Error) => void;
-}
-/**
- * Return value of `createEntity`.
- * All fields are SolidJS signals (fine-grained, no re-render of unrelated parts).
- */
-interface CreateEntityReturn<TEntity extends object> {
-    /** The merged entity (canonical + patch overlay) or `null` when not yet loaded. */
-    data: () => TEntity | null;
-    /** `true` while the initial or background fetch is in-flight. */
-    isLoading: () => boolean;
-    /** `true` only during background SWR refetch (data already present). */
-    isRefetching: () => boolean;
-    /** Per-entity fetch error string from the graph, or `null`. */
-    error: () => string | null;
-    /**
-     * Typed `EntityError` instance (`TerminalError` | `TransientError`) so
-     * consumers can `instanceof`-check the failure mode without string parsing.
-     */
-    typedError: () => EntityError | null;
-    /** Imperatively trigger a refetch, bypassing staleness checks. */
-    refetch: () => Promise<void>;
-    /** Raw `EntityState` slice for advanced use (isFetching, stale, lastFetched). */
-    entityState: () => EntityState;
-}
-/**
- * Return value of `createEntityList`.
- * Items are fine-grained: each row is individually reactive via SolidJS signals.
- */
-interface CreateEntityListReturn<TEntity extends object> {
-    /** Resolved entity objects in list order (ids joined to graph at read time). */
-    items: () => TEntity[];
-    /** `true` while the initial list fetch is in-flight. */
-    isLoading: () => boolean;
-    /** `true` while a "load more" / pagination fetch is in-flight. */
-    isLoadingMore: () => boolean;
-    /** List fetch error string, or `null`. */
-    error: () => string | null;
-    /** Typed error instance for `instanceof` checks. */
-    typedError: () => EntityError | null;
-    /** Total entity count from the server (may be `null` before first fetch). */
-    total: () => number | null;
-    /** `true` when a next page is available. */
-    hasNextPage: () => boolean;
-    /** `true` when a previous page is available. */
-    hasPrevPage: () => boolean;
-    /** Fetch the next page (appends when `mode` is `"append"`). */
-    fetchNextPage: () => Promise<void>;
-    /** Refetch the list from scratch (replaces ids). */
-    refetch: () => Promise<void>;
-    /** Raw `ListState` slice for advanced pagination/meta access. */
-    listState: () => ListState;
-}
-
-/**
- * createEntity — SolidJS primitive that bridges a single entity to the
- * normalized entity graph via `createResource`.
- *
- * Architecture:
- *   createEntity  (this file, Layer 2)
- *     └─ core engine fetchEntity  (Layer 1 / transport)
- *          └─ graphStore  (Layer 0 / Zustand graph)
- *
- * SolidJS `createResource` owns the async lifecycle; the graph is the
- * single source of truth for the entity payload. Once fetchEntity writes to
- * the graph, a Zustand subscription (via `createStore`) propagates the merged
- * entity back to SolidJS as a fine-grained reactive signal.
- */
-
-/**
- * Creates a fine-grained SolidJS reactive primitive for a single entity.
- *
- * - Uses `createResource` as the async driver so Suspense and ErrorBoundary
- *   boundaries work naturally.
- * - Subscribes to the Zustand graph with `graphStore.subscribe` and mirrors
- *   the merged entity into a `createStore`-backed signal for fine-grained
- *   SolidJS reactivity (only the changed field triggers updates).
- * - Registers / unregisters a subscriber token with the core engine so idle
- *   entities stop background revalidation when no components are observing them.
- *
- * @example
- * ```tsx
- * const invoice = createEntity({
- *   type: "Invoice",
- *   id: () => props.invoiceId,
- *   fetch: (id) => api.get(`/invoices/${id}`),
- *   normalize: (raw) => ({ ...raw, id: raw.invoice_id }),
- * });
- *
- * return (
- *   <Show when={!invoice.isLoading()} fallback={<Spinner />}>
- *     <p>{invoice.data()?.amount}</p>
- *   </Show>
- * );
- * ```
- */
-declare function createEntity<TRaw, TEntity extends object>(opts: CreateEntityOptions<TRaw, TEntity>): CreateEntityReturn<TEntity>;
-
-/**
- * createEntityList — SolidJS primitive for reactive normalized entity lists.
- *
- * Architecture:
- *   createEntityList  (this file, Layer 2)
- *     └─ core engine fetchList  (Layer 1 / transport)
- *          └─ graphStore  (Layer 0 / Zustand graph)
- *
- * A Zustand `subscribe` bridges the graph's `lists[key]` slot + entity rows
- * into a SolidJS `createStore`, giving SolidJS fine-grained per-row reactivity.
- * Changing `queryKey()` re-serializes to a new list slot, triggering a fresh
- * fetch while keeping existing data visible (stale-while-revalidate).
- */
-
-/**
- * Creates a fine-grained SolidJS reactive primitive for an entity list.
- *
- * - Subscribes to `graphStore` to mirror list state (ids + pagination)
- *   and resolves the entity rows by joining ids → graph entities on each read.
- * - Changing `queryKey()` triggers a new fetch and subscribes to the new list
- *   slot; the previous subscription is cleaned up automatically.
- * - Supports pagination (`fetchNextPage`) and imperative refetch.
- *
- * @example
- * ```tsx
- * const invoices = createEntityList({
- *   type: "Invoice",
- *   queryKey: () => ["invoices", { status: filter() }],
- *   fetch: (params) => api.getInvoices(params),
- *   normalize: (raw) => ({ id: raw.invoice_id, data: { ...raw } }),
- * });
- *
- * return (
- *   <For each={invoices.items()}>
- *     {(invoice) => <InvoiceRow invoice={invoice} />}
- *   </For>
- * );
- * ```
- */
-declare function createEntityList<TRaw, TEntity extends object>(opts: CreateEntityListOptions<TRaw, TEntity>): CreateEntityListReturn<TEntity>;
-
-/**
- * createGraphStore — SolidJS fine-grained reactive bridge to the entire
- * Zustand entity graph.
- *
- * Consumers that need ad-hoc access to the graph outside `createEntity` /
- * `createEntityList` can use this to read any slice of `GraphState` as a
- * SolidJS signal. The subscription is scoped to only the selected slice,
- * so unrelated graph mutations do not trigger re-computations.
- *
- * @example
- * ```ts
- * // Read total entity count for a devtools panel.
- * const entityCount = createGraphStore(
- *   (s) => Object.keys(s.entities).reduce((n, t) => n + Object.keys(s.entities[t]).length, 0),
- * );
- * console.log(entityCount()); // reactive SolidJS accessor
- * ```
- */
-
-/**
- * Subscribe to a selector over the entity graph.
- * Returns a SolidJS accessor that updates whenever the selected slice changes.
- *
- * @param selector - Pure function that maps the full `GraphState` to a derived value.
- * @param equalityFn - Optional equality check (default: strict reference equality `===`).
- */
-declare function createGraphStore<T>(selector: (state: GraphState) => T, equalityFn?: (a: T, b: T) => boolean): () => T;
-
-/**
- * GraphProvider utilities for SolidJS.
- *
- * Provides boot-time setup helpers for attaching global focus/reconnect
- * listeners and configuring the engine from within a SolidJS application root.
- *
- * Usage in the application root (e.g. `src/index.tsx`):
- *
- * ```ts
- * import { setupGraphProvider } from "@prometheus-ags/entity-graph-solid";
- * import { configureEngine, attachGlobalListeners } from "@prometheus-ags/entity-graph-core";
- *
- * setupGraphProvider({
- *   staleTime: 60_000,
- *   revalidateOnFocus: true,
- * });
- * ```
- */
-
-interface GraphProviderOptions extends EngineOptions {
-    /**
-     * Whether to attach window focus/online listeners for stale-while-revalidate.
-     * Defaults to `true` in browser environments.
-     */
-    attachListeners?: boolean;
-    /**
-     * Whether to start the periodic garbage collector.
-     * Defaults to `true`.
-     */
-    startGc?: boolean;
-}
-/**
- * Configures the entity-graph engine and wires browser-level listeners.
- * Call this once at application startup before mounting the root component.
- *
- * Returns a cleanup function that stops the GC interval (useful for tests).
- */
-declare function setupGraphProvider(opts?: GraphProviderOptions): () => void;
-
-export { type CreateEntityListOptions, type CreateEntityListReturn, type CreateEntityOptions, type CreateEntityReturn, type GraphProviderOptions, createEntity, createEntityList, createGraphStore, setupGraphProvider };