@astrale-os/shell-react 0.3.2-beta.1 → 0.3.2-beta.2

package/dist/graph/resource.d.ts

@@ -1,4 +1,4 @@
-import type { GraphStore, StoreQueryResponse } from '@astrale-os/sdk/client/store';
+import type { GraphStore, StoreQueryResponse, StoreReadOptions } from '@astrale-os/sdk/client/store';
 import type { QueryAST } from '@astrale-os/sdk/query';
 export type GraphResourceState = 'idle' | 'loading' | 'ready' | 'stale' | 'refreshing' | 'optimistic' | 'failed';
 export interface GraphResource<T> {
@@ -21,6 +21,8 @@ export interface GraphResource<T> {
     };
 }
 export interface StoreResourceOptions<Output> {
+    /** Exact closure evidence required by typed Domain projections. */
+    readonly expected?: StoreReadOptions['expected'];
     readonly identity?: string;
     readonly keepPrevious?: boolean;
     readonly window?: 'page' | 'append';

package/dist/graph/resource.js

@@ -4,16 +4,18 @@ class StoreObserver {
     store;
     query;
     size;
+    expected;
     listeners = new Set();
     pages = Object.freeze([Object.freeze({})]);
     unsubs = Object.freeze([]);
     current;
     morePromise = null;
     started = false;
-    constructor(store, query, size) {
+    constructor(store, query, size, expected) {
         this.store = store;
         this.query = query;
         this.size = size;
+        this.expected = expected;
     }
     subscribe = (listener) => {
         this.listeners.add(listener);
@@ -82,6 +84,7 @@ class StoreObserver {
                 size: this.size,
                 ...(page.after === undefined ? {} : { after: page.after }),
             }),
+            ...(this.expected === undefined ? {} : { expected: this.expected }),
         });
     }
     bindPages() {
@@ -98,7 +101,9 @@ const pollers = new WeakMap();
 /** Adapt exact Store pages into a tear-free React resource without a parallel entity cache. */
 export function useStoreResource(query, pageSize, project, options = {}) {
     const store = useGraphStore();
-    const observer = useMemo(() => (query === null ? null : new StoreObserver(store, query, positivePage(pageSize))), [store, query, pageSize]);
+    const observer = useMemo(() => query === null
+        ? null
+        : new StoreObserver(store, query, positivePage(pageSize), options.expected), [store, query, pageSize, options.expected]);
     const subscribe = useCallback((listener) => (observer === null ? () => { } : observer.subscribe(listener)), [observer]);
     const idle = useMemo(() => Object.freeze({ snapshots: Object.freeze([]), pendingMore: false }), []);
     const getSnapshot = useCallback(() => observer?.getSnapshot() ?? idle, [observer, idle]);

package/dist/schema/object.hook.js

@@ -22,7 +22,9 @@ export function useObject(definition, target, options = {}) {
             : result.graph.nodes.find((candidate) => candidate.id === id);
         return node === undefined ? null : binding.wrapNode(definition, node);
     }, [binding, definition]);
-    return useStoreResource(query, options.pageSize ?? 1, project);
+    return useStoreResource(query, options.pageSize ?? 1, project, {
+        expected: binding.domain.closure,
+    });
 }
 /** Explicitly untyped point read for inspectors; it never impersonates `useObject`. */
 export function useDynamicObject(target, options = {}) {

package/dist/schema/relation.hook.js

@@ -52,7 +52,9 @@ export function useRelation(relation, source, options) {
             return undefined;
         return Object.freeze(values);
     }, [binding, cardinality, options.to]);
-    const resource = useStoreResource(query, options.page?.size ?? 50, project);
+    const resource = useStoreResource(query, options.page?.size ?? 50, project, {
+        expected: binding.domain.closure,
+    });
     const unavailable = (cardinality === '1' || cardinality === '1..*') &&
         resource.data === undefined &&
         resource.state !== 'idle' &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/shell-react",
-  "version": "0.3.2-beta.1",
+  "version": "0.3.2-beta.2",
   "description": "Astrale shell-react — the React face of the shell (provider, hooks, view components)",
   "license": "Apache-2.0",
   "repository": {
@@ -31,7 +31,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@astrale-os/sdk": "0.5.0-beta.32",
+    "@astrale-os/sdk": "0.5.0-beta.34",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^26.2.0",

package/src/graph/resource.ts

@@ -1,4 +1,9 @@
-import type { GraphStore, StoreQueryResponse, StoreSnapshot } from '@astrale-os/sdk/client/store'
+import type {
+  GraphStore,
+  StoreQueryResponse,
+  StoreReadOptions,
+  StoreSnapshot,
+} from '@astrale-os/sdk/client/store'
 import type { QueryAST } from '@astrale-os/sdk/query'
 
 import { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from 'react'
@@ -32,6 +37,8 @@ export interface GraphResource<T> {
 }
 
 export interface StoreResourceOptions<Output> {
+  /** Exact closure evidence required by typed Domain projections. */
+  readonly expected?: StoreReadOptions['expected']
   readonly identity?: string
   readonly keepPrevious?: boolean
   readonly window?: 'page' | 'append'
@@ -61,6 +68,7 @@ class StoreObserver<Query extends QueryAST> {
     private readonly store: GraphStore,
     private readonly query: Query,
     private readonly size: number,
+    private readonly expected: StoreReadOptions['expected'],
   ) {}
 
   subscribe = (listener: () => void): (() => void) => {
@@ -139,6 +147,7 @@ class StoreObserver<Query extends QueryAST> {
         size: this.size,
         ...(page.after === undefined ? {} : { after: page.after }),
       }),
+      ...(this.expected === undefined ? {} : { expected: this.expected }),
     })
   }
 
@@ -181,8 +190,11 @@ export function useStoreResource<Query extends QueryAST, Output>(
 ): GraphResource<Output> {
   const store = useGraphStore()
   const observer = useMemo(
-    () => (query === null ? null : new StoreObserver(store, query, positivePage(pageSize))),
-    [store, query, pageSize],
+    () =>
+      query === null
+        ? null
+        : new StoreObserver(store, query, positivePage(pageSize), options.expected),
+    [store, query, pageSize, options.expected],
   )
   const subscribe = useCallback(
     (listener: () => void) => (observer === null ? () => {} : observer.subscribe(listener)),

package/src/schema/object.hook.ts

@@ -47,7 +47,9 @@ export function useObject<Class extends ResolvedClass<'node'>>(
     },
     [binding, definition],
   )
-  return useStoreResource(query, options.pageSize ?? 1, project)
+  return useStoreResource(query, options.pageSize ?? 1, project, {
+    expected: binding.domain.closure,
+  })
 }
 
 /** Explicitly untyped point read for inspectors; it never impersonates `useObject`. */

package/src/schema/relation.hook.ts

@@ -150,7 +150,9 @@ export function useRelation<
     },
     [binding, cardinality, options.to],
   )
-  const resource = useStoreResource(query, options.page?.size ?? 50, project)
+  const resource = useStoreResource(query, options.page?.size ?? 50, project, {
+    expected: binding.domain.closure,
+  })
   const unavailable =
     (cardinality === '1' || cardinality === '1..*') &&
     resource.data === undefined &&