@prometheus-ags/prometheus-entity-management 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -5,6 +5,27 @@ Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ---
 
+## [1.1.0] — 2026-04-05
+
+Graph-runtime expansion release focused on TanStack DB comparison gaps without changing the library’s core React entity-graph architecture.
+
+### Added
+
+- Graph runtime snapshot helpers: `queryOnce(...)` and `selectGraph(...)`.
+- Nested graph projection support via graph-native `include` definitions.
+- Explicit optimistic write primitives: `createGraphTransaction(...)` and `createGraphAction(...)`.
+- Graph workflow/effect helper: `createGraphEffect(...)`.
+- Per-entity sync/provenance metadata exposed through snapshot reads: `$synced`, `$origin`, `$updatedAt`.
+- AI interoperability helpers: `createGraphTool(...)` and `exportGraphSnapshot(...)`.
+- Vitest coverage for graph runtime querying, actions, rollback, effects, and AI helpers.
+- New comparison documentation: `docs/tanstack-comparison.md`.
+
+### Changed
+
+- Core read paths now resolve sync-aware snapshots rather than base-entity-plus-patch merges alone.
+- Optimistic mutation and CRUD flows now track sync metadata and restore it correctly on rollback.
+- Top-level docs now describe the graph runtime surface and the library’s positioning relative to TanStack DB, Query, Table, AI, and Intent.
+
 ## [1.0.0] — 2026-04-04
 
 Production-ready semantic version with CI, tests, documentation, and skills export verification.

package/README.md

@@ -9,6 +9,7 @@ Update a post in one screen and every list row, detail panel, and badge that rea
 | Doc | Purpose |
 |-----|---------|
 | [docs/tanstack-query-and-table.md](docs/tanstack-query-and-table.md) | How this library fits with TanStack Query and TanStack Table |
+| [docs/tanstack-comparison.md](docs/tanstack-comparison.md) | Detailed comparison against TanStack DB, Query, Table, AI, and Intent |
 | [docs/advanced.md](docs/advanced.md) | Engine, GC, Suspense, DevTools, SSR, testing |
 | [RELEASING.md](RELEASING.md) | Versioning, `prepublishOnly`, npm publish |
 | [CHANGELOG.md](CHANGELOG.md) | Release history |
@@ -20,10 +21,10 @@ Update a post in one screen and every list row, detail panel, and badge that rea
 ### 1. Install
 
 ```bash
-npm install @prometheus-ags/prometheus-entity-management zustand immer
+pnpm add @prometheus-ags/prometheus-entity-management zustand immer
 ```
 
-(`pnpm` and `yarn` work the same way for app dependencies.)
+(`npm install` works for consumers too; this repository itself is `pnpm`-only.)
 
 ### 2. Define an entity type
 
@@ -98,6 +99,21 @@ Data flows **up** into the graph; UI reads **down** through hooks (see [Architec
 
 ---
 
+## New in v1.1
+
+The graph runtime now exposes a focused set of non-hook helpers for loaders, workflows, and orchestration:
+
+- `queryOnce(...)` / `selectGraph(...)` for one-shot graph snapshots without a live subscription
+- nested `include` projections over normalized graph data
+- `createGraphTransaction(...)` / `createGraphAction(...)` for explicit optimistic graph writes with rollback
+- sync-aware snapshot metadata: `$synced`, `$origin`, `$updatedAt`
+- `createGraphEffect(...)` for enter/update/exit reactions over graph query results
+- `createGraphTool(...)` / `exportGraphSnapshot(...)` for AI interoperability without bundling an AI runtime
+
+These additions are intentionally graph-native. They extend the entity graph for orchestration use cases without changing the core `Components → Hooks → Stores → APIs/Realtime` architecture.
+
+---
+
 ## Feature comparison
 
 | Feature | `@prometheus-ags/prometheus-entity-management` | TanStack Query | Apollo Client | SWR |
@@ -147,6 +163,17 @@ Compare against peers only when measurement methodology matches (minified vs unm
 | `dedupe` | Process-global in-flight promise deduplication helper. |
 | `startGarbageCollector` / `stopGarbageCollector` | Periodic eviction of unsubscribed, stale entities (also started via `configureEngine`). |
 
+### Graph runtime
+
+| Export | Description |
+|--------|-------------|
+| `queryOnce` / `selectGraph` | One-shot graph snapshot queries with local filtering, sorting, and nested includes. |
+| `createGraphTransaction` | Explicit graph write transaction with commit / rollback. |
+| `createGraphAction` | Higher-level optimistic action wrapper around graph transactions. |
+| `createGraphEffect` | Subscribe to graph query results with `onEnter`, `onUpdate`, and `onExit`. |
+| `createGraphTool` | Typed graph-backed helper for AI or workflow integrations. |
+| `exportGraphSnapshot` | Serialize graph data for prompts, exports, and non-React workflows. |
+
 ### Hooks (REST-oriented)
 
 | Export | Description |
@@ -232,7 +259,7 @@ Compare against peers only when measurement methodology matches (minified vs unm
 
 ### Types (high level)
 
-`GraphState`, `EntityState`, `ListState`, `EntityType`, `EntityId`, `EngineOptions`, `EntityQueryOptions`, `ListQueryOptions`, `ViewDescriptor`, `EntitySchema`, `RelationDescriptor`, realtime adapter types, GraphQL types, CRUD types, column meta types — all exported from the package entry.
+`GraphState`, `EntityState`, `ListState`, `EntityType`, `EntityId`, `EntitySyncMetadata`, `EntitySnapshot`, `EngineOptions`, `EntityQueryOptions`, `ListQueryOptions`, `ViewDescriptor`, `EntitySchema`, `RelationDescriptor`, realtime adapter types, GraphQL types, CRUD types, and column meta types are all exported from the package entry.
 
 ---
 
@@ -475,6 +502,7 @@ pnpm run dev:next   # http://localhost:3000
 1. **`entities`** — Canonical server-shaped records per `(type, id)`.
 2. **`patches`** — Local-only overlays (`_selected`, `_loading`, …) merged at read time.
 3. **`lists`** — Ordered `ids[]`, pagination, and fetch flags — **not** duplicated row payloads.
+4. **`syncMetadata`** — Per-entity sync/provenance state layered into snapshot reads as `$synced`, `$origin`, and `$updatedAt`.
 
 ### Engine (`src/engine.ts`)
 

package/dist/index.d.mts

@@ -11,6 +11,20 @@ type EntityType = string;
 type EntityId = string;
 /** Stable string key for a list query (often `JSON.stringify`-shaped). Lists store IDs only under this key. */
 type QueryKey = string;
+/** Provenance of the latest known entity state. */
+type SyncOrigin = "server" | "client" | "optimistic";
+/** Optional sync-facing metadata kept outside canonical entity payloads. */
+interface EntitySyncMetadata {
+    synced: boolean;
+    origin: SyncOrigin;
+    updatedAt: number | null;
+}
+/** Snapshot shape returned by sync-aware reads and graph-native query helpers. */
+type EntitySnapshot<T extends Record<string, unknown>> = T & {
+    $synced: boolean;
+    $origin: SyncOrigin;
+    $updatedAt: number | null;
+};
 /**
  * Fetch/cache metadata for a single entity instance (`type:id`).
  * Separates transport concerns from canonical `entities` data so hooks can show spinners and stale-while-revalidate without mutating server-shaped fields.
@@ -51,6 +65,8 @@ interface GraphState {
     patches: Record<EntityType, Record<EntityId, Record<string, unknown>>>;
     /** Per-entity fetch lifecycle keyed as `${type}:${id}`. */
     entityStates: Record<string, EntityState>;
+    /** Optional sync/provenance state layered beside the canonical entity payload. */
+    syncMetadata: Record<string, EntitySyncMetadata>;
     /** List slots keyed by serialized query keys. Values hold id arrays and pagination — not entity clones. */
     lists: Record<QueryKey, ListState>;
     /**
@@ -91,6 +107,10 @@ interface GraphState {
     setEntityFetched: (type: EntityType, id: EntityId) => void;
     /** Drive background revalidation: when true, hooks refetch while still showing cached `readEntity` data. */
     setEntityStale: (type: EntityType, id: EntityId, stale: boolean) => void;
+    /** Merge sync metadata for one entity without polluting canonical server fields. */
+    setEntitySyncMetadata: (type: EntityType, id: EntityId, metadata: Partial<EntitySyncMetadata>) => void;
+    /** Clear sync metadata for one entity. */
+    clearEntitySyncMetadata: (type: EntityType, id: EntityId) => void;
     /**
      * Replace list ids and merge pagination meta after a primary list fetch (not load-more).
      * Resets fetching flags and clears list error on success path (engine calls this after normalize).
@@ -131,6 +151,10 @@ interface GraphState {
      * @returns Merged view suitable for rendering; not a deep clone
      */
     readEntity: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => T | null;
+    /**
+     * Sync-aware read path: canonical entity + patches + virtual sync metadata (`$synced`, `$origin`, `$updatedAt`).
+     */
+    readEntitySnapshot: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => EntitySnapshot<T & Record<string, unknown>> | null;
 }
 /**
  * Global entity graph store (Zustand + Immer). **Components should not subscribe directly** — use hooks so layering stays `Component → hook → store`.
@@ -168,6 +192,13 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
                 stale: boolean;
             };
         };
+        syncMetadata: {
+            [x: string]: {
+                synced: boolean;
+                origin: SyncOrigin;
+                updatedAt: number | null;
+            };
+        };
         lists: {
             [x: string]: {
                 ids: string[];
@@ -199,6 +230,8 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
         setEntityError: (type: EntityType, id: EntityId, error: string | null) => void;
         setEntityFetched: (type: EntityType, id: EntityId) => void;
         setEntityStale: (type: EntityType, id: EntityId, stale: boolean) => void;
+        setEntitySyncMetadata: (type: EntityType, id: EntityId, metadata: Partial<EntitySyncMetadata>) => void;
+        clearEntitySyncMetadata: (type: EntityType, id: EntityId) => void;
         setListResult: (key: QueryKey, ids: EntityId[], meta: Partial<Omit<ListState, "ids" | "isFetching" | "isFetchingMore" | "error" | "stale">>) => void;
         appendListResult: (key: QueryKey, ids: EntityId[], meta: Partial<Omit<ListState, "ids" | "isFetching" | "isFetchingMore" | "error" | "stale">>) => void;
         prependListResult: (key: QueryKey, ids: EntityId[], meta?: Partial<ListState>) => void;
@@ -212,6 +245,7 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
         invalidateLists: (matcher: string | ((key: QueryKey) => boolean)) => void;
         invalidateType: (type: EntityType) => void;
         readEntity: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => T | null;
+        readEntitySnapshot: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => EntitySnapshot<T & Record<string, unknown>> | null;
     }) => void), shouldReplace?: false): void;
     setState(nextStateOrUpdater: GraphState | ((state: {
         entities: {
@@ -236,6 +270,13 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
                 stale: boolean;
             };
         };
+        syncMetadata: {
+            [x: string]: {
+                synced: boolean;
+                origin: SyncOrigin;
+                updatedAt: number | null;
+            };
+        };
         lists: {
             [x: string]: {
                 ids: string[];
@@ -267,6 +308,8 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
         setEntityError: (type: EntityType, id: EntityId, error: string | null) => void;
         setEntityFetched: (type: EntityType, id: EntityId) => void;
         setEntityStale: (type: EntityType, id: EntityId, stale: boolean) => void;
+        setEntitySyncMetadata: (type: EntityType, id: EntityId, metadata: Partial<EntitySyncMetadata>) => void;
+        clearEntitySyncMetadata: (type: EntityType, id: EntityId) => void;
         setListResult: (key: QueryKey, ids: EntityId[], meta: Partial<Omit<ListState, "ids" | "isFetching" | "isFetchingMore" | "error" | "stale">>) => void;
         appendListResult: (key: QueryKey, ids: EntityId[], meta: Partial<Omit<ListState, "ids" | "isFetching" | "isFetchingMore" | "error" | "stale">>) => void;
         prependListResult: (key: QueryKey, ids: EntityId[], meta?: Partial<ListState>) => void;
@@ -280,9 +323,127 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
         invalidateLists: (matcher: string | ((key: QueryKey) => boolean)) => void;
         invalidateType: (type: EntityType) => void;
         readEntity: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => T | null;
+        readEntitySnapshot: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => EntitySnapshot<T & Record<string, unknown>> | null;
     }) => void), shouldReplace: true): void;
 }>;
 
+type GraphStore = ReturnType<typeof useGraphStore.getState>;
+type GraphIncludeMap = Record<string, GraphIncludeRelation>;
+type GraphIncludeRelation = {
+    type: EntityType;
+    via: {
+        kind: "field";
+        field: string;
+    };
+    include?: GraphIncludeMap;
+} | {
+    type: EntityType;
+    via: {
+        kind: "array";
+        field: string;
+    };
+    include?: GraphIncludeMap;
+} | {
+    type: EntityType;
+    via: {
+        kind: "list";
+        key: QueryKey | ((entity: Record<string, unknown>) => QueryKey | null | undefined);
+    };
+    include?: GraphIncludeMap;
+} | {
+    type: EntityType;
+    via: {
+        kind: "resolver";
+        resolve: (entity: Record<string, unknown>, store: GraphStore) => EntityId | EntityId[] | null | undefined;
+    };
+    include?: GraphIncludeMap;
+};
+interface GraphQueryOptions<TEntity extends Record<string, unknown>> {
+    type: EntityType;
+    id?: EntityId;
+    ids?: EntityId[];
+    listKey?: QueryKey;
+    where?: (entity: EntitySnapshot<TEntity>) => boolean;
+    sort?: (a: EntitySnapshot<TEntity>, b: EntitySnapshot<TEntity>) => number;
+    include?: GraphIncludeMap;
+    select?: ((entity: Record<string, unknown>) => unknown) | string[];
+}
+type ProjectedRow = Record<string, unknown>;
+declare function queryOnce<TEntity extends Record<string, unknown>>(opts: GraphQueryOptions<TEntity> & {
+    id: EntityId;
+}): ProjectedRow | null;
+declare function queryOnce<TEntity extends Record<string, unknown>>(opts: GraphQueryOptions<TEntity>): ProjectedRow[];
+declare const selectGraph: typeof queryOnce;
+
+interface GraphDataSnapshot {
+    entities: ReturnType<typeof useGraphStore.getState>["entities"];
+    patches: ReturnType<typeof useGraphStore.getState>["patches"];
+    entityStates: ReturnType<typeof useGraphStore.getState>["entityStates"];
+    syncMetadata: ReturnType<typeof useGraphStore.getState>["syncMetadata"];
+    lists: ReturnType<typeof useGraphStore.getState>["lists"];
+}
+interface GraphTransaction {
+    upsertEntity: (type: EntityType, id: EntityId, data: Record<string, unknown>) => GraphTransaction;
+    replaceEntity: (type: EntityType, id: EntityId, data: Record<string, unknown>) => GraphTransaction;
+    removeEntity: (type: EntityType, id: EntityId) => GraphTransaction;
+    patchEntity: (type: EntityType, id: EntityId, patch: Record<string, unknown>) => GraphTransaction;
+    clearPatch: (type: EntityType, id: EntityId) => GraphTransaction;
+    insertIdInList: (key: QueryKey, id: EntityId, position: "start" | "end" | number) => GraphTransaction;
+    removeIdFromAllLists: (type: EntityType, id: EntityId) => GraphTransaction;
+    setEntitySyncMetadata: (type: EntityType, id: EntityId, metadata: Partial<EntitySyncMetadata>) => GraphTransaction;
+    markEntityPending: (type: EntityType, id: EntityId, origin?: SyncOrigin) => GraphTransaction;
+    markEntitySynced: (type: EntityType, id: EntityId, origin?: SyncOrigin) => GraphTransaction;
+    commit: () => void;
+    rollback: () => void;
+    snapshot: () => GraphDataSnapshot;
+}
+interface GraphActionOptions<TInput, TResult> {
+    optimistic?: (tx: GraphTransaction, input: TInput) => void;
+    run: (tx: GraphTransaction, input: TInput) => Promise<TResult> | TResult;
+    onSuccess?: (result: TResult, input: TInput, tx: GraphTransaction) => void;
+    onError?: (error: Error, input: TInput) => void;
+}
+declare function createGraphTransaction(): GraphTransaction;
+declare function createGraphAction<TInput, TResult>(opts: GraphActionOptions<TInput, TResult>): (input: TInput) => Promise<TResult>;
+
+interface GraphEffectEvent<T> {
+    key: string;
+    value: T;
+    previousValue: T;
+}
+interface GraphEffectOptions<T> {
+    query: () => T[] | T | null;
+    getKey?: (value: T, index: number) => string;
+    skipInitial?: boolean;
+    isEqual?: (previousValue: T, nextValue: T) => boolean;
+    onEnter?: (event: {
+        key: string;
+        value: T;
+    }) => void;
+    onUpdate?: (event: GraphEffectEvent<T>) => void;
+    onExit?: (event: {
+        key: string;
+        previousValue: T;
+    }) => void;
+}
+interface GraphEffectHandle {
+    dispose: () => void;
+}
+declare function createGraphEffect<T>(opts: GraphEffectOptions<T>): GraphEffectHandle;
+
+interface GraphSnapshotExportOptions {
+    scope: string;
+    data: unknown;
+    pretty?: boolean;
+}
+interface GraphToolContext {
+    store: ReturnType<typeof useGraphStore.getState>;
+    queryOnce: typeof queryOnce;
+    exportGraphSnapshot: typeof exportGraphSnapshot;
+}
+declare function exportGraphSnapshot(opts: GraphSnapshotExportOptions): string;
+declare function createGraphTool<TInput, TResult>(handler: (input: TInput, ctx: GraphToolContext) => Promise<TResult> | TResult): (input: TInput) => TResult | Promise<TResult>;
+
 /**
  * Process-wide defaults for stale times, retries, and background revalidation.
  * Keeps hook signatures small: `useEntity` / `useEntityList` merge these with per-query overrides.
@@ -2605,4 +2766,4 @@ declare const TableHead: React$1.ForwardRefExoticComponent<React$1.ThHTMLAttribu
 declare const TableCell: React$1.ForwardRefExoticComponent<React$1.TdHTMLAttributes<HTMLTableCellElement> & React$1.RefAttributes<HTMLTableCellElement>>;
 declare const TableCaption: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableCaptionElement> & React$1.RefAttributes<HTMLTableCaptionElement>>;
 
-export { type AccessorFn, ActionButtonRow, type ActionDef, ActionDropdown, type ActionItem, type ActivePresets, type AdapterStatus, type AggregationFn, type BatchActionDef, type BelongsToRelation, type CRUDMode, type CRUDOptions, type CRUDState, type CascadeContext, type Cell, type CellContext, type CellRenderer, type ChangeOperation, type ChangeSet, type ChannelConfig, type Column, type ColumnFilterType, type ColumnFiltersState, type ColumnOrderState, type ColumnPinningState, type ColumnPreset, ColumnPresetDialog, type ColumnPresetEntry, type ColumnSizingState, type ColumnVisibilityState, type CompletenessMode, DataTable, DataTableColumnHeader, DataTableFilter, DataTablePagination, DataTableToolbar, type DirtyFields, type ElectricAdapterOptions, ElectricSQLAdapter as ElectricSQLPresetAdapter, type ElectricSQLAdapterOptions as ElectricSQLPresetAdapterOptions, type ElectricTableConfig, EmptyState, type EmptyStateConfig, type EngineOptions, type EntityChange, type EntityColumnMeta, type EntityDescriptor, EntityDetailSheet, EntityFormSheet, type EntityId, EntityListView, type EntityListViewProps, type EntityQueryOptions, type EntitySchema, type EntityState, EntityTable, type EntityType, type ExpandedState, type FieldDescriptor, type FieldType, type FilterClause, type FilterFn, type FilterGroup, type FilterOperator, type FilterPreset, FilterPresetDialog, type FilterSpec, GQLClient, type GQLClientConfig, type GQLEntityOptions, type GQLError, type GQLListOptions, type GQLResponse, type GalleryColumns, GalleryView, type GraphState, type GroupingState, type HasManyRelation, type Header, type HeaderContext, type HeaderGroup, type HeaderRenderer, InlineCellEditor$1 as InlineCellEditor, InlineItemEditor, type ItemDescriptor, type ItemDescriptorBadge, type ItemDescriptorMeta, type ItemRenderContext, type ListFetchParams, type ListQueryOptions, type ListResponse, type ListState, ListView, type ManagerOptions, type ManyToManyRelation, MemoryAdapter, MultiSelectBar, type PaginationState, type PresetChangeEvent, type PresetChangeOperation, PresetPicker, type PresetStoreState, type UnsubscribeFn as PresetUnsubscribeFn, type PrismaEntityConfigOptions, type ColumnDef as PureColumnDef, type ColumnMeta as PureColumnMeta, InlineCellEditor as PureInlineCellEditor, type RealtimeAdapter, RealtimeManager, type RelationDescriptor, type RestAdapterOptions, RestApiAdapter, type Row, type RowModel, type RowSelectionState, SelectionContext, type SelectionStoreState, Sheet, type SortClause, type SortDirection, SortHeader, type SortSpec, type SortingFn, type SortingState, type SubscriptionConfig, type SupabaseAdapterOptions$1 as SupabaseAdapterOptions, SupabaseRealtimeAdapter as SupabasePresetAdapter, type SupabaseAdapterOptions as SupabasePresetAdapterOptions, type SyncAdapter, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableInstance, type TableOptions, type TablePresetSlice, TableRow, type TableState, type TableStorageAdapter, TableStorageProvider, type TableStorageProviderProps, type UnsubscribeFn$1 as UnsubscribeFn, type Updater, type UseEntityViewOptions, type UseEntityViewResult, type UseLocalFirstResult, type UseTablePresetsOptions, type UseTablePresetsResult, type ViewDescriptor, type ViewFetchParams, type ViewMode, ViewModeSwitcher, type WebSocketAdapterOptions, type ZustandAdapterOptions, ZustandPersistAdapter, actionsColumn$1 as actionsColumn, applyView, booleanColumn$1 as booleanColumn, cascadeInvalidation, checkCompleteness, compareEntities, configureEngine, createConvexAdapter, createElectricAdapter, createGQLClient, createGraphQLSubscriptionAdapter, createPresetStore, createPrismaEntityConfig, createRow, createSelectionStore, createSupabaseRealtimeAdapter, createWebSocketAdapter, dateColumn$1 as dateColumn, dedupe, deleteAction, editAction, enumColumn$1 as enumColumn, executeGQL, fetchEntity, fetchList, flattenClauses, getCoreRowModel, getExpandedRowModel, getFacetedMinMaxValues, getFacetedRowModel, getFacetedUniqueValues, getFilteredRowModel, getGroupedRowModel, getPaginatedRowModel, getRealtimeManager, getSchema, getSelectedRowModel, getSortedRowModel, hasCustomPredicates, matchesFilter, matchesSearch, normalizeGQLResponse, numberColumn$1 as numberColumn, prismaRelationsToSchema, actionsColumn as pureActionsColumn, booleanColumn as pureBooleanColumn, dateColumn as pureDateColumn, enumColumn as pureEnumColumn, numberColumn as pureNumberColumn, selectionColumn as pureSelectionColumn, textColumn as pureTextColumn, readRelations, registerSchema, resetRealtimeManager, selectionColumn$1 as selectionColumn, serializeKey, startGarbageCollector, stopGarbageCollector, textColumn$1 as textColumn, toGraphQLVariables, toPrismaInclude, toPrismaOrderBy, toPrismaWhere, toRestParams, toSQLClauses, useEntity, useEntityAugment, useEntityCRUD, useEntityList, useEntityMutation, useEntityView, useGQLEntity, useGQLList, useGQLMutation, useGQLSubscription, useGraphDevTools, useGraphStore, useLocalFirst, usePGliteQuery, useSelectionContext, useSelectionStore, useSuspenseEntity, useSuspenseEntityList, useTable, useTablePresets, useTableRealtimeMode, useTableStorageAdapter, viewAction };
+export { type AccessorFn, ActionButtonRow, type ActionDef, ActionDropdown, type ActionItem, type ActivePresets, type AdapterStatus, type AggregationFn, type BatchActionDef, type BelongsToRelation, type CRUDMode, type CRUDOptions, type CRUDState, type CascadeContext, type Cell, type CellContext, type CellRenderer, type ChangeOperation, type ChangeSet, type ChannelConfig, type Column, type ColumnFilterType, type ColumnFiltersState, type ColumnOrderState, type ColumnPinningState, type ColumnPreset, ColumnPresetDialog, type ColumnPresetEntry, type ColumnSizingState, type ColumnVisibilityState, type CompletenessMode, DataTable, DataTableColumnHeader, DataTableFilter, DataTablePagination, DataTableToolbar, type DirtyFields, type ElectricAdapterOptions, ElectricSQLAdapter as ElectricSQLPresetAdapter, type ElectricSQLAdapterOptions as ElectricSQLPresetAdapterOptions, type ElectricTableConfig, EmptyState, type EmptyStateConfig, type EngineOptions, type EntityChange, type EntityColumnMeta, type EntityDescriptor, EntityDetailSheet, EntityFormSheet, type EntityId, EntityListView, type EntityListViewProps, type EntityQueryOptions, type EntitySchema, type EntitySnapshot, type EntityState, type EntitySyncMetadata, EntityTable, type EntityType, type ExpandedState, type FieldDescriptor, type FieldType, type FilterClause, type FilterFn, type FilterGroup, type FilterOperator, type FilterPreset, FilterPresetDialog, type FilterSpec, GQLClient, type GQLClientConfig, type GQLEntityOptions, type GQLError, type GQLListOptions, type GQLResponse, type GalleryColumns, GalleryView, type GraphActionOptions, type GraphEffectEvent, type GraphEffectHandle, type GraphEffectOptions, type GraphIncludeMap, type GraphIncludeRelation, type GraphQueryOptions, type GraphSnapshotExportOptions, type GraphState, type GraphToolContext, type GraphTransaction, type GroupingState, type HasManyRelation, type Header, type HeaderContext, type HeaderGroup, type HeaderRenderer, InlineCellEditor$1 as InlineCellEditor, InlineItemEditor, type ItemDescriptor, type ItemDescriptorBadge, type ItemDescriptorMeta, type ItemRenderContext, type ListFetchParams, type ListQueryOptions, type ListResponse, type ListState, ListView, type ManagerOptions, type ManyToManyRelation, MemoryAdapter, MultiSelectBar, type PaginationState, type PresetChangeEvent, type PresetChangeOperation, PresetPicker, type PresetStoreState, type UnsubscribeFn as PresetUnsubscribeFn, type PrismaEntityConfigOptions, type ColumnDef as PureColumnDef, type ColumnMeta as PureColumnMeta, InlineCellEditor as PureInlineCellEditor, type QueryKey, type RealtimeAdapter, RealtimeManager, type RelationDescriptor, type RestAdapterOptions, RestApiAdapter, type Row, type RowModel, type RowSelectionState, SelectionContext, type SelectionStoreState, Sheet, type SortClause, type SortDirection, SortHeader, type SortSpec, type SortingFn, type SortingState, type SubscriptionConfig, type SupabaseAdapterOptions$1 as SupabaseAdapterOptions, SupabaseRealtimeAdapter as SupabasePresetAdapter, type SupabaseAdapterOptions as SupabasePresetAdapterOptions, type SyncAdapter, type SyncOrigin, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableInstance, type TableOptions, type TablePresetSlice, TableRow, type TableState, type TableStorageAdapter, TableStorageProvider, type TableStorageProviderProps, type UnsubscribeFn$1 as UnsubscribeFn, type Updater, type UseEntityViewOptions, type UseEntityViewResult, type UseLocalFirstResult, type UseTablePresetsOptions, type UseTablePresetsResult, type ViewDescriptor, type ViewFetchParams, type ViewMode, ViewModeSwitcher, type WebSocketAdapterOptions, type ZustandAdapterOptions, ZustandPersistAdapter, actionsColumn$1 as actionsColumn, applyView, booleanColumn$1 as booleanColumn, cascadeInvalidation, checkCompleteness, compareEntities, configureEngine, createConvexAdapter, createElectricAdapter, createGQLClient, createGraphAction, createGraphEffect, createGraphQLSubscriptionAdapter, createGraphTool, createGraphTransaction, createPresetStore, createPrismaEntityConfig, createRow, createSelectionStore, createSupabaseRealtimeAdapter, createWebSocketAdapter, dateColumn$1 as dateColumn, dedupe, deleteAction, editAction, enumColumn$1 as enumColumn, executeGQL, exportGraphSnapshot, fetchEntity, fetchList, flattenClauses, getCoreRowModel, getExpandedRowModel, getFacetedMinMaxValues, getFacetedRowModel, getFacetedUniqueValues, getFilteredRowModel, getGroupedRowModel, getPaginatedRowModel, getRealtimeManager, getSchema, getSelectedRowModel, getSortedRowModel, hasCustomPredicates, matchesFilter, matchesSearch, normalizeGQLResponse, numberColumn$1 as numberColumn, prismaRelationsToSchema, actionsColumn as pureActionsColumn, booleanColumn as pureBooleanColumn, dateColumn as pureDateColumn, enumColumn as pureEnumColumn, numberColumn as pureNumberColumn, selectionColumn as pureSelectionColumn, textColumn as pureTextColumn, queryOnce, readRelations, registerSchema, resetRealtimeManager, selectGraph, selectionColumn$1 as selectionColumn, serializeKey, startGarbageCollector, stopGarbageCollector, textColumn$1 as textColumn, toGraphQLVariables, toPrismaInclude, toPrismaOrderBy, toPrismaWhere, toRestParams, toSQLClauses, useEntity, useEntityAugment, useEntityCRUD, useEntityList, useEntityMutation, useEntityView, useGQLEntity, useGQLList, useGQLMutation, useGQLSubscription, useGraphDevTools, useGraphStore, useLocalFirst, usePGliteQuery, useSelectionContext, useSelectionStore, useSuspenseEntity, useSuspenseEntityList, useTable, useTablePresets, useTableRealtimeMode, useTableStorageAdapter, viewAction };

package/dist/index.d.ts

@@ -11,6 +11,20 @@ type EntityType = string;
 type EntityId = string;
 /** Stable string key for a list query (often `JSON.stringify`-shaped). Lists store IDs only under this key. */
 type QueryKey = string;
+/** Provenance of the latest known entity state. */
+type SyncOrigin = "server" | "client" | "optimistic";
+/** Optional sync-facing metadata kept outside canonical entity payloads. */
+interface EntitySyncMetadata {
+    synced: boolean;
+    origin: SyncOrigin;
+    updatedAt: number | null;
+}
+/** Snapshot shape returned by sync-aware reads and graph-native query helpers. */
+type EntitySnapshot<T extends Record<string, unknown>> = T & {
+    $synced: boolean;
+    $origin: SyncOrigin;
+    $updatedAt: number | null;
+};
 /**
  * Fetch/cache metadata for a single entity instance (`type:id`).
  * Separates transport concerns from canonical `entities` data so hooks can show spinners and stale-while-revalidate without mutating server-shaped fields.
@@ -51,6 +65,8 @@ interface GraphState {
     patches: Record<EntityType, Record<EntityId, Record<string, unknown>>>;
     /** Per-entity fetch lifecycle keyed as `${type}:${id}`. */
     entityStates: Record<string, EntityState>;
+    /** Optional sync/provenance state layered beside the canonical entity payload. */
+    syncMetadata: Record<string, EntitySyncMetadata>;
     /** List slots keyed by serialized query keys. Values hold id arrays and pagination — not entity clones. */
     lists: Record<QueryKey, ListState>;
     /**
@@ -91,6 +107,10 @@ interface GraphState {
     setEntityFetched: (type: EntityType, id: EntityId) => void;
     /** Drive background revalidation: when true, hooks refetch while still showing cached `readEntity` data. */
     setEntityStale: (type: EntityType, id: EntityId, stale: boolean) => void;
+    /** Merge sync metadata for one entity without polluting canonical server fields. */
+    setEntitySyncMetadata: (type: EntityType, id: EntityId, metadata: Partial<EntitySyncMetadata>) => void;
+    /** Clear sync metadata for one entity. */
+    clearEntitySyncMetadata: (type: EntityType, id: EntityId) => void;
     /**
      * Replace list ids and merge pagination meta after a primary list fetch (not load-more).
      * Resets fetching flags and clears list error on success path (engine calls this after normalize).
@@ -131,6 +151,10 @@ interface GraphState {
      * @returns Merged view suitable for rendering; not a deep clone
      */
     readEntity: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => T | null;
+    /**
+     * Sync-aware read path: canonical entity + patches + virtual sync metadata (`$synced`, `$origin`, `$updatedAt`).
+     */
+    readEntitySnapshot: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => EntitySnapshot<T & Record<string, unknown>> | null;
 }
 /**
  * Global entity graph store (Zustand + Immer). **Components should not subscribe directly** — use hooks so layering stays `Component → hook → store`.
@@ -168,6 +192,13 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
                 stale: boolean;
             };
         };
+        syncMetadata: {
+            [x: string]: {
+                synced: boolean;
+                origin: SyncOrigin;
+                updatedAt: number | null;
+            };
+        };
         lists: {
             [x: string]: {
                 ids: string[];
@@ -199,6 +230,8 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
         setEntityError: (type: EntityType, id: EntityId, error: string | null) => void;
         setEntityFetched: (type: EntityType, id: EntityId) => void;
         setEntityStale: (type: EntityType, id: EntityId, stale: boolean) => void;
+        setEntitySyncMetadata: (type: EntityType, id: EntityId, metadata: Partial<EntitySyncMetadata>) => void;
+        clearEntitySyncMetadata: (type: EntityType, id: EntityId) => void;
         setListResult: (key: QueryKey, ids: EntityId[], meta: Partial<Omit<ListState, "ids" | "isFetching" | "isFetchingMore" | "error" | "stale">>) => void;
         appendListResult: (key: QueryKey, ids: EntityId[], meta: Partial<Omit<ListState, "ids" | "isFetching" | "isFetchingMore" | "error" | "stale">>) => void;
         prependListResult: (key: QueryKey, ids: EntityId[], meta?: Partial<ListState>) => void;
@@ -212,6 +245,7 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
         invalidateLists: (matcher: string | ((key: QueryKey) => boolean)) => void;
         invalidateType: (type: EntityType) => void;
         readEntity: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => T | null;
+        readEntitySnapshot: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => EntitySnapshot<T & Record<string, unknown>> | null;
     }) => void), shouldReplace?: false): void;
     setState(nextStateOrUpdater: GraphState | ((state: {
         entities: {
@@ -236,6 +270,13 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
                 stale: boolean;
             };
         };
+        syncMetadata: {
+            [x: string]: {
+                synced: boolean;
+                origin: SyncOrigin;
+                updatedAt: number | null;
+            };
+        };
         lists: {
             [x: string]: {
                 ids: string[];
@@ -267,6 +308,8 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
         setEntityError: (type: EntityType, id: EntityId, error: string | null) => void;
         setEntityFetched: (type: EntityType, id: EntityId) => void;
         setEntityStale: (type: EntityType, id: EntityId, stale: boolean) => void;
+        setEntitySyncMetadata: (type: EntityType, id: EntityId, metadata: Partial<EntitySyncMetadata>) => void;
+        clearEntitySyncMetadata: (type: EntityType, id: EntityId) => void;
         setListResult: (key: QueryKey, ids: EntityId[], meta: Partial<Omit<ListState, "ids" | "isFetching" | "isFetchingMore" | "error" | "stale">>) => void;
         appendListResult: (key: QueryKey, ids: EntityId[], meta: Partial<Omit<ListState, "ids" | "isFetching" | "isFetchingMore" | "error" | "stale">>) => void;
         prependListResult: (key: QueryKey, ids: EntityId[], meta?: Partial<ListState>) => void;
@@ -280,9 +323,127 @@ declare const useGraphStore: zustand.UseBoundStore<Omit<Omit<zustand.StoreApi<Gr
         invalidateLists: (matcher: string | ((key: QueryKey) => boolean)) => void;
         invalidateType: (type: EntityType) => void;
         readEntity: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => T | null;
+        readEntitySnapshot: <T = Record<string, unknown>>(type: EntityType, id: EntityId) => EntitySnapshot<T & Record<string, unknown>> | null;
     }) => void), shouldReplace: true): void;
 }>;
 
+type GraphStore = ReturnType<typeof useGraphStore.getState>;
+type GraphIncludeMap = Record<string, GraphIncludeRelation>;
+type GraphIncludeRelation = {
+    type: EntityType;
+    via: {
+        kind: "field";
+        field: string;
+    };
+    include?: GraphIncludeMap;
+} | {
+    type: EntityType;
+    via: {
+        kind: "array";
+        field: string;
+    };
+    include?: GraphIncludeMap;
+} | {
+    type: EntityType;
+    via: {
+        kind: "list";
+        key: QueryKey | ((entity: Record<string, unknown>) => QueryKey | null | undefined);
+    };
+    include?: GraphIncludeMap;
+} | {
+    type: EntityType;
+    via: {
+        kind: "resolver";
+        resolve: (entity: Record<string, unknown>, store: GraphStore) => EntityId | EntityId[] | null | undefined;
+    };
+    include?: GraphIncludeMap;
+};
+interface GraphQueryOptions<TEntity extends Record<string, unknown>> {
+    type: EntityType;
+    id?: EntityId;
+    ids?: EntityId[];
+    listKey?: QueryKey;
+    where?: (entity: EntitySnapshot<TEntity>) => boolean;
+    sort?: (a: EntitySnapshot<TEntity>, b: EntitySnapshot<TEntity>) => number;
+    include?: GraphIncludeMap;
+    select?: ((entity: Record<string, unknown>) => unknown) | string[];
+}
+type ProjectedRow = Record<string, unknown>;
+declare function queryOnce<TEntity extends Record<string, unknown>>(opts: GraphQueryOptions<TEntity> & {
+    id: EntityId;
+}): ProjectedRow | null;
+declare function queryOnce<TEntity extends Record<string, unknown>>(opts: GraphQueryOptions<TEntity>): ProjectedRow[];
+declare const selectGraph: typeof queryOnce;
+
+interface GraphDataSnapshot {
+    entities: ReturnType<typeof useGraphStore.getState>["entities"];
+    patches: ReturnType<typeof useGraphStore.getState>["patches"];
+    entityStates: ReturnType<typeof useGraphStore.getState>["entityStates"];
+    syncMetadata: ReturnType<typeof useGraphStore.getState>["syncMetadata"];
+    lists: ReturnType<typeof useGraphStore.getState>["lists"];
+}
+interface GraphTransaction {
+    upsertEntity: (type: EntityType, id: EntityId, data: Record<string, unknown>) => GraphTransaction;
+    replaceEntity: (type: EntityType, id: EntityId, data: Record<string, unknown>) => GraphTransaction;
+    removeEntity: (type: EntityType, id: EntityId) => GraphTransaction;
+    patchEntity: (type: EntityType, id: EntityId, patch: Record<string, unknown>) => GraphTransaction;
+    clearPatch: (type: EntityType, id: EntityId) => GraphTransaction;
+    insertIdInList: (key: QueryKey, id: EntityId, position: "start" | "end" | number) => GraphTransaction;
+    removeIdFromAllLists: (type: EntityType, id: EntityId) => GraphTransaction;
+    setEntitySyncMetadata: (type: EntityType, id: EntityId, metadata: Partial<EntitySyncMetadata>) => GraphTransaction;
+    markEntityPending: (type: EntityType, id: EntityId, origin?: SyncOrigin) => GraphTransaction;
+    markEntitySynced: (type: EntityType, id: EntityId, origin?: SyncOrigin) => GraphTransaction;
+    commit: () => void;
+    rollback: () => void;
+    snapshot: () => GraphDataSnapshot;
+}
+interface GraphActionOptions<TInput, TResult> {
+    optimistic?: (tx: GraphTransaction, input: TInput) => void;
+    run: (tx: GraphTransaction, input: TInput) => Promise<TResult> | TResult;
+    onSuccess?: (result: TResult, input: TInput, tx: GraphTransaction) => void;
+    onError?: (error: Error, input: TInput) => void;
+}
+declare function createGraphTransaction(): GraphTransaction;
+declare function createGraphAction<TInput, TResult>(opts: GraphActionOptions<TInput, TResult>): (input: TInput) => Promise<TResult>;
+
+interface GraphEffectEvent<T> {
+    key: string;
+    value: T;
+    previousValue: T;
+}
+interface GraphEffectOptions<T> {
+    query: () => T[] | T | null;
+    getKey?: (value: T, index: number) => string;
+    skipInitial?: boolean;
+    isEqual?: (previousValue: T, nextValue: T) => boolean;
+    onEnter?: (event: {
+        key: string;
+        value: T;
+    }) => void;
+    onUpdate?: (event: GraphEffectEvent<T>) => void;
+    onExit?: (event: {
+        key: string;
+        previousValue: T;
+    }) => void;
+}
+interface GraphEffectHandle {
+    dispose: () => void;
+}
+declare function createGraphEffect<T>(opts: GraphEffectOptions<T>): GraphEffectHandle;
+
+interface GraphSnapshotExportOptions {
+    scope: string;
+    data: unknown;
+    pretty?: boolean;
+}
+interface GraphToolContext {
+    store: ReturnType<typeof useGraphStore.getState>;
+    queryOnce: typeof queryOnce;
+    exportGraphSnapshot: typeof exportGraphSnapshot;
+}
+declare function exportGraphSnapshot(opts: GraphSnapshotExportOptions): string;
+declare function createGraphTool<TInput, TResult>(handler: (input: TInput, ctx: GraphToolContext) => Promise<TResult> | TResult): (input: TInput) => TResult | Promise<TResult>;
+
 /**
  * Process-wide defaults for stale times, retries, and background revalidation.
  * Keeps hook signatures small: `useEntity` / `useEntityList` merge these with per-query overrides.
@@ -2605,4 +2766,4 @@ declare const TableHead: React$1.ForwardRefExoticComponent<React$1.ThHTMLAttribu
 declare const TableCell: React$1.ForwardRefExoticComponent<React$1.TdHTMLAttributes<HTMLTableCellElement> & React$1.RefAttributes<HTMLTableCellElement>>;
 declare const TableCaption: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableCaptionElement> & React$1.RefAttributes<HTMLTableCaptionElement>>;
 
-export { type AccessorFn, ActionButtonRow, type ActionDef, ActionDropdown, type ActionItem, type ActivePresets, type AdapterStatus, type AggregationFn, type BatchActionDef, type BelongsToRelation, type CRUDMode, type CRUDOptions, type CRUDState, type CascadeContext, type Cell, type CellContext, type CellRenderer, type ChangeOperation, type ChangeSet, type ChannelConfig, type Column, type ColumnFilterType, type ColumnFiltersState, type ColumnOrderState, type ColumnPinningState, type ColumnPreset, ColumnPresetDialog, type ColumnPresetEntry, type ColumnSizingState, type ColumnVisibilityState, type CompletenessMode, DataTable, DataTableColumnHeader, DataTableFilter, DataTablePagination, DataTableToolbar, type DirtyFields, type ElectricAdapterOptions, ElectricSQLAdapter as ElectricSQLPresetAdapter, type ElectricSQLAdapterOptions as ElectricSQLPresetAdapterOptions, type ElectricTableConfig, EmptyState, type EmptyStateConfig, type EngineOptions, type EntityChange, type EntityColumnMeta, type EntityDescriptor, EntityDetailSheet, EntityFormSheet, type EntityId, EntityListView, type EntityListViewProps, type EntityQueryOptions, type EntitySchema, type EntityState, EntityTable, type EntityType, type ExpandedState, type FieldDescriptor, type FieldType, type FilterClause, type FilterFn, type FilterGroup, type FilterOperator, type FilterPreset, FilterPresetDialog, type FilterSpec, GQLClient, type GQLClientConfig, type GQLEntityOptions, type GQLError, type GQLListOptions, type GQLResponse, type GalleryColumns, GalleryView, type GraphState, type GroupingState, type HasManyRelation, type Header, type HeaderContext, type HeaderGroup, type HeaderRenderer, InlineCellEditor$1 as InlineCellEditor, InlineItemEditor, type ItemDescriptor, type ItemDescriptorBadge, type ItemDescriptorMeta, type ItemRenderContext, type ListFetchParams, type ListQueryOptions, type ListResponse, type ListState, ListView, type ManagerOptions, type ManyToManyRelation, MemoryAdapter, MultiSelectBar, type PaginationState, type PresetChangeEvent, type PresetChangeOperation, PresetPicker, type PresetStoreState, type UnsubscribeFn as PresetUnsubscribeFn, type PrismaEntityConfigOptions, type ColumnDef as PureColumnDef, type ColumnMeta as PureColumnMeta, InlineCellEditor as PureInlineCellEditor, type RealtimeAdapter, RealtimeManager, type RelationDescriptor, type RestAdapterOptions, RestApiAdapter, type Row, type RowModel, type RowSelectionState, SelectionContext, type SelectionStoreState, Sheet, type SortClause, type SortDirection, SortHeader, type SortSpec, type SortingFn, type SortingState, type SubscriptionConfig, type SupabaseAdapterOptions$1 as SupabaseAdapterOptions, SupabaseRealtimeAdapter as SupabasePresetAdapter, type SupabaseAdapterOptions as SupabasePresetAdapterOptions, type SyncAdapter, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableInstance, type TableOptions, type TablePresetSlice, TableRow, type TableState, type TableStorageAdapter, TableStorageProvider, type TableStorageProviderProps, type UnsubscribeFn$1 as UnsubscribeFn, type Updater, type UseEntityViewOptions, type UseEntityViewResult, type UseLocalFirstResult, type UseTablePresetsOptions, type UseTablePresetsResult, type ViewDescriptor, type ViewFetchParams, type ViewMode, ViewModeSwitcher, type WebSocketAdapterOptions, type ZustandAdapterOptions, ZustandPersistAdapter, actionsColumn$1 as actionsColumn, applyView, booleanColumn$1 as booleanColumn, cascadeInvalidation, checkCompleteness, compareEntities, configureEngine, createConvexAdapter, createElectricAdapter, createGQLClient, createGraphQLSubscriptionAdapter, createPresetStore, createPrismaEntityConfig, createRow, createSelectionStore, createSupabaseRealtimeAdapter, createWebSocketAdapter, dateColumn$1 as dateColumn, dedupe, deleteAction, editAction, enumColumn$1 as enumColumn, executeGQL, fetchEntity, fetchList, flattenClauses, getCoreRowModel, getExpandedRowModel, getFacetedMinMaxValues, getFacetedRowModel, getFacetedUniqueValues, getFilteredRowModel, getGroupedRowModel, getPaginatedRowModel, getRealtimeManager, getSchema, getSelectedRowModel, getSortedRowModel, hasCustomPredicates, matchesFilter, matchesSearch, normalizeGQLResponse, numberColumn$1 as numberColumn, prismaRelationsToSchema, actionsColumn as pureActionsColumn, booleanColumn as pureBooleanColumn, dateColumn as pureDateColumn, enumColumn as pureEnumColumn, numberColumn as pureNumberColumn, selectionColumn as pureSelectionColumn, textColumn as pureTextColumn, readRelations, registerSchema, resetRealtimeManager, selectionColumn$1 as selectionColumn, serializeKey, startGarbageCollector, stopGarbageCollector, textColumn$1 as textColumn, toGraphQLVariables, toPrismaInclude, toPrismaOrderBy, toPrismaWhere, toRestParams, toSQLClauses, useEntity, useEntityAugment, useEntityCRUD, useEntityList, useEntityMutation, useEntityView, useGQLEntity, useGQLList, useGQLMutation, useGQLSubscription, useGraphDevTools, useGraphStore, useLocalFirst, usePGliteQuery, useSelectionContext, useSelectionStore, useSuspenseEntity, useSuspenseEntityList, useTable, useTablePresets, useTableRealtimeMode, useTableStorageAdapter, viewAction };
+export { type AccessorFn, ActionButtonRow, type ActionDef, ActionDropdown, type ActionItem, type ActivePresets, type AdapterStatus, type AggregationFn, type BatchActionDef, type BelongsToRelation, type CRUDMode, type CRUDOptions, type CRUDState, type CascadeContext, type Cell, type CellContext, type CellRenderer, type ChangeOperation, type ChangeSet, type ChannelConfig, type Column, type ColumnFilterType, type ColumnFiltersState, type ColumnOrderState, type ColumnPinningState, type ColumnPreset, ColumnPresetDialog, type ColumnPresetEntry, type ColumnSizingState, type ColumnVisibilityState, type CompletenessMode, DataTable, DataTableColumnHeader, DataTableFilter, DataTablePagination, DataTableToolbar, type DirtyFields, type ElectricAdapterOptions, ElectricSQLAdapter as ElectricSQLPresetAdapter, type ElectricSQLAdapterOptions as ElectricSQLPresetAdapterOptions, type ElectricTableConfig, EmptyState, type EmptyStateConfig, type EngineOptions, type EntityChange, type EntityColumnMeta, type EntityDescriptor, EntityDetailSheet, EntityFormSheet, type EntityId, EntityListView, type EntityListViewProps, type EntityQueryOptions, type EntitySchema, type EntitySnapshot, type EntityState, type EntitySyncMetadata, EntityTable, type EntityType, type ExpandedState, type FieldDescriptor, type FieldType, type FilterClause, type FilterFn, type FilterGroup, type FilterOperator, type FilterPreset, FilterPresetDialog, type FilterSpec, GQLClient, type GQLClientConfig, type GQLEntityOptions, type GQLError, type GQLListOptions, type GQLResponse, type GalleryColumns, GalleryView, type GraphActionOptions, type GraphEffectEvent, type GraphEffectHandle, type GraphEffectOptions, type GraphIncludeMap, type GraphIncludeRelation, type GraphQueryOptions, type GraphSnapshotExportOptions, type GraphState, type GraphToolContext, type GraphTransaction, type GroupingState, type HasManyRelation, type Header, type HeaderContext, type HeaderGroup, type HeaderRenderer, InlineCellEditor$1 as InlineCellEditor, InlineItemEditor, type ItemDescriptor, type ItemDescriptorBadge, type ItemDescriptorMeta, type ItemRenderContext, type ListFetchParams, type ListQueryOptions, type ListResponse, type ListState, ListView, type ManagerOptions, type ManyToManyRelation, MemoryAdapter, MultiSelectBar, type PaginationState, type PresetChangeEvent, type PresetChangeOperation, PresetPicker, type PresetStoreState, type UnsubscribeFn as PresetUnsubscribeFn, type PrismaEntityConfigOptions, type ColumnDef as PureColumnDef, type ColumnMeta as PureColumnMeta, InlineCellEditor as PureInlineCellEditor, type QueryKey, type RealtimeAdapter, RealtimeManager, type RelationDescriptor, type RestAdapterOptions, RestApiAdapter, type Row, type RowModel, type RowSelectionState, SelectionContext, type SelectionStoreState, Sheet, type SortClause, type SortDirection, SortHeader, type SortSpec, type SortingFn, type SortingState, type SubscriptionConfig, type SupabaseAdapterOptions$1 as SupabaseAdapterOptions, SupabaseRealtimeAdapter as SupabasePresetAdapter, type SupabaseAdapterOptions as SupabasePresetAdapterOptions, type SyncAdapter, type SyncOrigin, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, type TableInstance, type TableOptions, type TablePresetSlice, TableRow, type TableState, type TableStorageAdapter, TableStorageProvider, type TableStorageProviderProps, type UnsubscribeFn$1 as UnsubscribeFn, type Updater, type UseEntityViewOptions, type UseEntityViewResult, type UseLocalFirstResult, type UseTablePresetsOptions, type UseTablePresetsResult, type ViewDescriptor, type ViewFetchParams, type ViewMode, ViewModeSwitcher, type WebSocketAdapterOptions, type ZustandAdapterOptions, ZustandPersistAdapter, actionsColumn$1 as actionsColumn, applyView, booleanColumn$1 as booleanColumn, cascadeInvalidation, checkCompleteness, compareEntities, configureEngine, createConvexAdapter, createElectricAdapter, createGQLClient, createGraphAction, createGraphEffect, createGraphQLSubscriptionAdapter, createGraphTool, createGraphTransaction, createPresetStore, createPrismaEntityConfig, createRow, createSelectionStore, createSupabaseRealtimeAdapter, createWebSocketAdapter, dateColumn$1 as dateColumn, dedupe, deleteAction, editAction, enumColumn$1 as enumColumn, executeGQL, exportGraphSnapshot, fetchEntity, fetchList, flattenClauses, getCoreRowModel, getExpandedRowModel, getFacetedMinMaxValues, getFacetedRowModel, getFacetedUniqueValues, getFilteredRowModel, getGroupedRowModel, getPaginatedRowModel, getRealtimeManager, getSchema, getSelectedRowModel, getSortedRowModel, hasCustomPredicates, matchesFilter, matchesSearch, normalizeGQLResponse, numberColumn$1 as numberColumn, prismaRelationsToSchema, actionsColumn as pureActionsColumn, booleanColumn as pureBooleanColumn, dateColumn as pureDateColumn, enumColumn as pureEnumColumn, numberColumn as pureNumberColumn, selectionColumn as pureSelectionColumn, textColumn as pureTextColumn, queryOnce, readRelations, registerSchema, resetRealtimeManager, selectGraph, selectionColumn$1 as selectionColumn, serializeKey, startGarbageCollector, stopGarbageCollector, textColumn$1 as textColumn, toGraphQLVariables, toPrismaInclude, toPrismaOrderBy, toPrismaWhere, toRestParams, toSQLClauses, useEntity, useEntityAugment, useEntityCRUD, useEntityList, useEntityMutation, useEntityView, useGQLEntity, useGQLList, useGQLMutation, useGQLSubscription, useGraphDevTools, useGraphStore, useLocalFirst, usePGliteQuery, useSelectionContext, useSelectionStore, useSuspenseEntity, useSuspenseEntityList, useTable, useTablePresets, useTableRealtimeMode, useTableStorageAdapter, viewAction };