@nicia-ai/typegraph 0.40.0 → 0.42.0

package/dist/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/schema/deserializer.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Schema deserializer for loading stored schemas.\n *\n * Reconstructs runtime objects from SerializedSchema.\n * Note: Zod schemas cannot be fully reconstructed from JSON Schema,\n * so this provides access to the serialized data for introspection.\n */\nimport { KindRegistry } from \"../registry/kind-registry\";\nimport {\n  type EdgeEndpointKinds,\n  validateImpliesEndpointCompatibility,\n} from \"../registry/validate-implies\";\nimport {\n  type SerializedClosures,\n  type SerializedEdgeDef,\n  type SerializedMetaEdge,\n  type SerializedNodeDef,\n  type SerializedOntologyRelation,\n  type SerializedSchema,\n} from \"./types\";\n\n// ============================================================\n// Deserialized Schema\n// ============================================================\n\n/**\n * A deserialized schema provides read-only access to schema metadata.\n *\n * Note: Unlike the original GraphDef, this does not include Zod schemas\n * since those cannot be reconstructed from JSON Schema. Use this for\n * introspection and metadata access only.\n */\nexport type DeserializedSchema = Readonly<{\n  graphId: string;\n  version: number;\n  generatedAt: string;\n\n  /** Get node definition by name */\n  getNode: (name: string) => SerializedNodeDef | undefined;\n\n  /** Get all node names */\n  getNodeNames: () => readonly string[];\n\n  /** Get edge definition by name */\n  getEdge: (name: string) => SerializedEdgeDef | undefined;\n\n  /** Get all edge names */\n  getEdgeNames: () => readonly string[];\n\n  /** Get meta-edge definition by name */\n  getMetaEdge: (name: string) => SerializedMetaEdge | undefined;\n\n  /** Get all meta-edge names */\n  getMetaEdgeNames: () => readonly string[];\n\n  /** Get all ontology relations */\n  getRelations: () => readonly SerializedOntologyRelation[];\n\n  /** Get precomputed closures */\n  getClosures: () => SerializedClosures;\n\n  /** Get graph defaults */\n  getDefaults: () => SerializedSchema[\"defaults\"];\n\n  /** Get the raw serialized schema */\n  getRaw: () => SerializedSchema;\n\n  /** Build a KindRegistry from the closures */\n  buildRegistry: () => KindRegistry;\n}>;\n\n// ============================================================\n// Deserialization\n// ============================================================\n\n/**\n * Deserializes a SerializedSchema into a DeserializedSchema.\n *\n * @param schema - The serialized schema to deserialize\n * @returns A deserialized schema with accessor methods\n */\nexport function deserializeSchema(\n  schema: SerializedSchema,\n): DeserializedSchema {\n  const nodeNames = Object.keys(schema.nodes);\n  const edgeNames = Object.keys(schema.edges);\n  const metaEdgeNames = Object.keys(schema.ontology.metaEdges);\n\n  return {\n    graphId: schema.graphId,\n    version: schema.version,\n    generatedAt: schema.generatedAt,\n\n    getNode: (name) => schema.nodes[name],\n    getNodeNames: () => nodeNames,\n\n    getEdge: (name) => schema.edges[name],\n    getEdgeNames: () => edgeNames,\n\n    getMetaEdge: (name) => schema.ontology.metaEdges[name],\n    getMetaEdgeNames: () => metaEdgeNames,\n\n    getRelations: () => schema.ontology.relations,\n    getClosures: () => schema.ontology.closures,\n\n    getDefaults: () => schema.defaults,\n    getRaw: () => schema,\n\n    buildRegistry: () => buildRegistryFromClosures(schema),\n  };\n}\n\n// ============================================================\n// Registry Building\n// ============================================================\n\n/**\n * Builds a KindRegistry from serialized closures.\n *\n * This allows query execution without recomputing closures.\n */\nfunction buildRegistryFromClosures(schema: SerializedSchema): KindRegistry {\n  const { closures } = schema.ontology;\n\n  // Convert Record<string, string[]> back to Map<string, Set<string>>\n  const subClassAncestors = recordToMap(closures.subClassAncestors);\n  const subClassDescendants = recordToMap(closures.subClassDescendants);\n  const broaderClosure = recordToMap(closures.broaderClosure);\n  const narrowerClosure = recordToMap(closures.narrowerClosure);\n  const equivalenceSets = recordToMap(closures.equivalenceSets);\n  const partOfClosure = recordToMap(closures.partOfClosure);\n  const hasPartClosure = recordToMap(closures.hasPartClosure);\n  const iriToKind = simpleRecordToMap(closures.iriToKind);\n  const disjointPairs = new Set(closures.disjointPairs);\n  const edgeInverses = simpleRecordToMap(closures.edgeInverses);\n  const edgeImplicationsClosure = recordToMap(closures.edgeImplicationsClosure);\n  const edgeImplyingClosure = recordToMap(closures.edgeImplyingClosure);\n\n  // Build empty node/edge kind maps (we don't have the actual Zod schemas)\n  const nodeKinds = new Map();\n  const edgeKinds = new Map();\n\n  const registry = new KindRegistry(nodeKinds, edgeKinds, {\n    subClassAncestors,\n    subClassDescendants,\n    broaderClosure,\n    narrowerClosure,\n    equivalenceSets,\n    iriToKind,\n    disjointPairs,\n    partOfClosure,\n    hasPartClosure,\n    edgeInverses,\n    edgeImplicationsClosure,\n    edgeImplyingClosure,\n  });\n\n  validateImpliesEndpointCompatibility(\n    buildEdgeEndpointKinds(schema.edges),\n    registry,\n  );\n\n  return registry;\n}\n\n/**\n * Maps each edge kind's serialized definition to its domain/range kind\n * names, for `validateImpliesEndpointCompatibility`. A `Map` (rather than\n * the plain `schema.edges` object) so a lookup for an edge kind literally\n * named \"toString\" or another `Object.prototype` member can't resolve to\n * an inherited member instead of `undefined`.\n */\nfunction buildEdgeEndpointKinds(\n  edges: Record<string, SerializedEdgeDef>,\n): ReadonlyMap<string, EdgeEndpointKinds> {\n  const result = new Map<string, EdgeEndpointKinds>();\n  for (const [kind, def] of Object.entries(edges)) {\n    result.set(kind, { from: def.fromKinds, to: def.toKinds });\n  }\n  return result;\n}\n\n/**\n * Converts Record<string, string[]> to Map<string, Set<string>>.\n */\nfunction recordToMap(\n  record: Record<string, readonly string[]>,\n): ReadonlyMap<string, ReadonlySet<string>> {\n  const result = new Map<string, Set<string>>();\n  for (const [key, values] of Object.entries(record)) {\n    result.set(key, new Set(values));\n  }\n  return result;\n}\n\n/**\n * Converts Record<string, string> to Map<string, string>.\n */\nfunction simpleRecordToMap(\n  record: Record<string, string>,\n): ReadonlyMap<string, string> {\n  return new Map(Object.entries(record));\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/{searchable-BxlJQVFw.d.cts → searchable-B4mUXZT6.d.cts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { p as VectorSlot } from './types-C5pZeKTl.cjs';
-import { G as GraphDef } from './define-graph-Cv3CFwKm.cjs';
+import { u as VectorSlot } from './types-Dh-EgT-w.cjs';
+import { G as GraphDef } from './define-graph-Byslw2OO.cjs';
 
 /**
  * Embedding type for vector search.

package/dist/{searchable-ChJ29MCd.d.ts → searchable-C7jmPNLT.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { p as VectorSlot } from './types-D8szWDUo.js';
-import { G as GraphDef } from './define-graph-DQnj3fNH.js';
+import { u as VectorSlot } from './types-Dh-EgT-w.js';
+import { G as GraphDef } from './define-graph-DBFnc7u_.js';
 
 /**
  * Embedding type for vector search.

package/dist/{sqlite-m9Izphk_.d.ts → sqlite-Ch5tSYQY.d.ts}

@@ -1,5 +1,5 @@
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
-import { I as IndexDeclaration } from './types-D8szWDUo.js';
+import { I as IndexDeclaration } from './types-Dh-EgT-w.js';
 
 /**
  * Table name configuration.

package/dist/{sqlite-DT6tTHOG.d.cts → sqlite-Da7jiYu9.d.cts}

@@ -1,5 +1,5 @@
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
-import { I as IndexDeclaration } from './types-C5pZeKTl.cjs';
+import { I as IndexDeclaration } from './types-Dh-EgT-w.cjs';
 
 /**
  * Table name configuration.

package/dist/{store-view-CagdeyNn.d.ts → store-view-6C2vTWqf.d.ts}

@@ -1,11 +1,10 @@
-import { G as GraphDef, E as EdgeKinds, N as NodeKinds, a as AllNodeTypes } from './define-graph-DQnj3fNH.js';
-import { R as RecordedInstant, d as ReadCoordinate } from './temporal-CyFsSPe8.js';
-import { a as NodeType, A as AnyEdgeType, d as EdgeType, T as TemporalMode, E as EdgeRegistration, m as NodeId, K as KindEntity, g as EdgeId, N as NodeRegistration, l as KindAnnotations, o as UniquenessScope, f as Collation, e as Cardinality, j as EndpointExistence, G as GraphExtension } from './extension-types-BLEVH4SG.js';
-import { K as KindRegistry, S as SchemaManagerOptions, d as SchemaValidationResult } from './manager-DjE6Mhag.js';
+import { G as GraphDef, E as EdgeKinds, N as NodeKinds, a as AllNodeTypes } from './define-graph-DBFnc7u_.js';
+import { R as RecordedInstant, d as ReadCoordinate } from './temporal-BtrTYTiB.js';
+import { bZ as ValueType, b_ as PredicateExpression, aw as FulltextQueryMode, b$ as VectorMetricType, Q as QueryAst, J as JsonPointer, a0 as FieldRef, aX as ParameterRef, a as NodeType, b as AnyEdgeType, _ as EdgeType, bq as TraversalExpansion, w as GraphBackend, S as SqlDialect, bh as SqlSchema, c0 as Traversal, c1 as NodePredicate, c2 as ProjectedField, aW as OrderSpec, c3 as AggregateOrderSpec, T as TemporalMode, c4 as GroupBySpec, aE as HybridFusionOptions, aI as JsonPointerInput, c5 as RecursiveCyclePolicy, a3 as TraversalDirection$1, E as EdgeRegistration, aU as NodeId, bn as TransactionBackend, K as KindEntity, aq as ExternalRecordedReadSource, c6 as NodeRow, am as EdgeId, c7 as EdgeRow, N as NodeRegistration, bp as TransactionReadBackend, $ as AggregateExpr, ba as SortDirection, af as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, c8 as VectorSlotMap, c9 as RecordedReadBinding, ca as SelectiveField, cb as ComposableQuery, cc as SetOperationType, cd as SetOperation, ce as VectorMetric, aN as KindAnnotations, W as JsonSchema, bu as UniquenessScope, ab as Collation, aa as Cardinality, ap as EndpointExistence, G as GraphExtension, B as BackendCapabilities, bo as TransactionOptions, A as AdapterBackend } from './types-Dh-EgT-w.js';
+import { K as KindRegistry, S as SchemaManagerOptions, a as SchemaValidationResult } from './manager-Dl0-er1G.js';
 import { z } from 'zod';
-import { bp as ValueType, bq as PredicateExpression, ad as FulltextQueryMode, br as VectorMetricType, Q as QueryAst, J as JsonPointer, K as FieldRef, ay as ParameterRef, b1 as TraversalExpansion, G as GraphBackend, S as SqlDialect, aU as SqlSchema, bs as Traversal, bt as NodePredicate, bu as ProjectedField, ax as OrderSpec, bv as AggregateOrderSpec, bw as GroupBySpec, ak as HybridFusionOptions, ao as JsonPointerInput, bx as RecursiveCyclePolicy, T as TraversalDirection$1, a_ as TransactionBackend, a7 as ExternalRecordedReadSource, by as NodeRow, bz as EdgeRow, b0 as TransactionReadBackend, H as AggregateExpr, aN as SortDirection, a0 as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, bA as VectorSlotMap, bB as RecordedReadBinding, bC as SelectiveField, bD as ComposableQuery, bE as SetOperationType, bF as SetOperation, bG as VectorMetric, x as JsonSchema, B as BackendCapabilities, a$ as TransactionOptions, A as AdapterBackend } from './types-D8szWDUo.js';
-import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-ChJ29MCd.js';
-import { b as MaterializeIndexesOptions, M as MaterializeIndexesResult, c as MaterializeSystemIndexesOptions } from './materialize-indexes-D4iei4Kp.js';
+import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-C7jmPNLT.js';
+import { S as SchemaDiff, h as MaterializeIndexesOptions, M as MaterializeIndexesResult, j as MaterializeSystemIndexesOptions } from './materialize-indexes-BM3u0aXE.js';
 
 type FieldTypeInfo = Readonly<{
     valueType: ValueType;
@@ -3970,6 +3969,8 @@ type StoreCore<G extends GraphDef> = Readonly<{
     getEdgePropsSchema: (kind: string) => z.ZodObject<z.ZodRawShape> | undefined;
     getEdgePropsSchemaOrThrow: (kind: string) => z.ZodObject<z.ZodRawShape>;
     introspect: () => SchemaIntrospection;
+    schemaChanges: () => Promise<SchemaDiff | undefined>;
+    requiresMigration: () => Promise<boolean>;
     query: () => InitialQueryBuilder<G, "open">;
     asOf: (asOf: string) => StoreView<G>;
     asOfRecorded: (recordedAsOf: RecordedInstant) => RecordedStoreView<G>;
@@ -4018,12 +4019,63 @@ interface StoreEvolution<G extends GraphDef, TStore extends StoreCore<G>> {
  * internals, and caller-owned transaction adoption out of the public surface.
  */
 type Store<G extends GraphDef> = StoreCore<G> & StoreTransactions<G> & StoreEvolution<G, Store<G>>;
+/**
+ * An opaque, in-memory snapshot of a store's reconciled schema: the merged
+ * compile-time + runtime-committed graph plus the committed schema version and
+ * hash it reflects. Produced by {@link AdapterStore.reconciledSchema} after a
+ * verified open, cached once per isolate/process, and handed to
+ * {@link createAdapterStore} via `{ reconciled }` (or used implicitly by
+ * {@link AdapterStore.withBackend}) to build request-scoped stores against
+ * fresh connections with **zero** database round-trips. Reads and writes are
+ * validated against the reconciled graph, so runtime-committed kinds seen at
+ * the reconcile are honored without re-querying.
+ *
+ * Treat it as opaque and immutable — do not construct or mutate it. Its
+ * `version` is the value to compare against {@link getCommittedSchemaVersion}
+ * to detect a schema commit from another process and refresh the snapshot.
+ */
+type ReconciledSchema<G extends GraphDef> = Readonly<{
+    graph: G;
+    version: number | undefined;
+    hash: string | undefined;
+}>;
+/** Construction option carrying a cached {@link ReconciledSchema}. */
+type ReconciledOption<G extends GraphDef> = Readonly<{
+    reconciled?: ReconciledSchema<G>;
+}>;
+/**
+ * The reconciliation surface shared by every adapter store flavor: read the
+ * cached {@link ReconciledSchema} and rebind to a fresh connection with no
+ * verify round-trip. `Self` is the receiver's own surface so `withBackend`
+ * preserves the store flavor (live / history / recorded-read).
+ *
+ * Declared as an `interface` (not a `type`): the surface aliases intersect it
+ * with `Self` bound to themselves, which a `type` alias rejects as a circular
+ * self-reference (TS2456) but an interface resolves lazily — the same idiom as
+ * {@link StoreEvolution}.
+ */
+interface AdapterStoreReconciliation<G extends GraphDef, TNativeTransaction, Self> {
+    /**
+     * An opaque snapshot of this store's reconciled schema. Cache it after a
+     * verified open and pass it to {@link createAdapterStore} `{ reconciled }`
+     * to build per-request stores with zero database round-trips.
+     */
+    readonly reconciledSchema: ReconciledSchema<G>;
+    /**
+     * Build an equivalent store bound to a fresh backend/connection, reusing
+     * this store's already-reconciled schema — no verify round-trip. The
+     * per-request primitive for serverless deployments that open a new
+     * connection per request; the returned store validates writes against the
+     * same reconciled graph as the receiver.
+     */
+    readonly withBackend: (backend: AdapterBackend<TNativeTransaction>) => Self;
+}
 /**
  * A Store with explicit adapter interoperability. Adapter entrypoints return
  * this surface so native transaction handles remain precisely typed without
  * leaking into the default Store contract.
  */
-type AdapterStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterStore<G, TNativeTransaction>> & AdapterStoreTransactions<G, TNativeTransaction> & Readonly<{
+type AdapterStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterStore<G, TNativeTransaction>> & AdapterStoreTransactions<G, TNativeTransaction> & AdapterStoreReconciliation<G, TNativeTransaction, AdapterStore<G, TNativeTransaction>> & Readonly<{
     backend: GraphBackend;
 }>;
 type AdapterStoreTransactions<G extends GraphDef, TNativeTransaction> = Readonly<{
@@ -4046,7 +4098,7 @@ type AdapterHistoryTransactionContext<G extends GraphDef, TNativeTransaction> =
 type MeasurableAdapterHistoryTransactionContext<G extends GraphDef, TNativeTransaction> = AdapterHistoryTransactionContext<G, TNativeTransaction> & Readonly<{
     measure: ScopedMeasure<MeasurableAdapterHistoryTransactionContext<G, TNativeTransaction>>;
 }>;
-type AdapterRecordedReadStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterRecordedReadStore<G, TNativeTransaction>> & AdapterStoreTransactions<G, TNativeTransaction> & Readonly<{
+type AdapterRecordedReadStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterRecordedReadStore<G, TNativeTransaction>> & AdapterStoreTransactions<G, TNativeTransaction> & AdapterStoreReconciliation<G, TNativeTransaction, AdapterRecordedReadStore<G, TNativeTransaction>> & Readonly<{
     backend: GraphBackend;
     recordedReadBound: true;
 }>;
@@ -4057,7 +4109,7 @@ type HistoryStore<G extends GraphDef> = StoreCore<G> & StoreTransactions<G> & St
     historyEnabled: true;
     recordedReadBound: true;
 }>;
-type AdapterHistoryStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterHistoryStore<G, TNativeTransaction>> & AdapterHistoryStoreTransactions<G, TNativeTransaction> & Readonly<{
+type AdapterHistoryStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterHistoryStore<G, TNativeTransaction>> & AdapterHistoryStoreTransactions<G, TNativeTransaction> & AdapterStoreReconciliation<G, TNativeTransaction, AdapterHistoryStore<G, TNativeTransaction>> & Readonly<{
     backend: HistoryStoreBackend;
     historyEnabled: true;
     recordedReadBound: true;
@@ -4101,11 +4153,11 @@ declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend
 declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend, options?: UnboundLiveStoreOptions): Store<G>;
 declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend, options: LiveStoreOptions | undefined): Store<G> | RecordedReadStore<G>;
 declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend, options: StoreOptions | undefined): Store<G> | HistoryStore<G> | RecordedReadStore<G>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: HistoryStoreOptions): AdapterHistoryStore<G, TNativeTransaction>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: RecordedReadStoreOptions): AdapterRecordedReadStore<G, TNativeTransaction>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options?: UnboundLiveStoreOptions): AdapterStore<G, TNativeTransaction>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: LiveStoreOptions | undefined): AdapterStore<G, TNativeTransaction> | AdapterRecordedReadStore<G, TNativeTransaction>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: StoreOptions | undefined): AdapterStore<G, TNativeTransaction> | AdapterHistoryStore<G, TNativeTransaction> | AdapterRecordedReadStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: HistoryStoreOptions & ReconciledOption<G>): AdapterHistoryStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: RecordedReadStoreOptions & ReconciledOption<G>): AdapterRecordedReadStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options?: UnboundLiveStoreOptions & ReconciledOption<G>): AdapterStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: (LiveStoreOptions & ReconciledOption<G>) | undefined): AdapterStore<G, TNativeTransaction> | AdapterRecordedReadStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: (StoreOptions & ReconciledOption<G>) | undefined): AdapterStore<G, TNativeTransaction> | AdapterHistoryStore<G, TNativeTransaction> | AdapterRecordedReadStore<G, TNativeTransaction>;
 
 /**
  * Creates a store and ensures the schema is initialized/migrated.
@@ -4403,4 +4455,4 @@ declare class RecordedStoreView<G extends GraphDef> extends CoordinatePinnedView
     get edges(): RecordedStoreViewEdgeCollections<G>;
 }
 
-export { ExecutableAggregateQuery as $, type AliasMap as A, type BaseStoreOptions as B, type ConstraintNames as C, type DegreeOptions as D, type EdgeAliasMap as E, type DynamicNodeType as F, type DynamicSelectableEdge as G, type HistoryStoreOptions as H, type DynamicSelectableNode as I, type Edge as J, type EdgeAccessor as K, type LiveStoreOptions as L, type EdgeBatchReads as M, type EdgeCollection as N, type EdgeFindByEndpointsOptions as O, type EdgeGetOrCreateByEndpointsOptions as P, type QueryCoordinateState as Q, type RecordedReadStoreOptions as R, type StoreOptions as S, TraversalBuilder as T, type UnboundLiveStoreOptions as U, type EdgeGetOrCreateByEndpointsResult as V, type EdgeIntrospection as W, type EdgeTemporalReads as X, type EdgeWrites as Y, type EmptyAliasMap as Z, type EmptyEdgeAliasMap as _, type Store as a, type RecordedStoreViewNodeCollection as a$, ExecutableQuery as a0, type FieldAccessor as a1, type FulltextSearchHit as a2, type FulltextSearchOptions as a3, type GetOrCreateAction as a4, type GraphAlgorithms as a5, type GraphEdgeCollections as a6, type GraphNodeCollections as a7, type HistoryStoreBackend as a8, type HookContext as a9, type NodeRef as aA, type NodeTemporalReads as aB, type NodeWrites as aC, type OntologyIntrospection as aD, type OperationHookContext as aE, type PageRankOptions as aF, type PageRankScore as aG, type PaginateOptions as aH, type PaginatedResult as aI, type PathNode as aJ, type PersonalizedPageRankOptions as aK, type PersonalizedPageRankSeed as aL, type Predicate as aM, PreparedQuery as aN, type PropsAccessor as aO, type QueryHookContext as aP, type QueryOptions as aQ, type ReachableNode as aR, type ReachableOptions as aS, type RebuildFulltextOptions as aT, type RebuildFulltextResult as aU, type ReclaimedVectorFieldEntry as aV, type RecordedScanOptions as aW, type RecordedScanPage as aX, RecordedStoreView as aY, type RecordedStoreViewEdgeCollection as aZ, type RecordedStoreViewEdgeCollections as a_, type HybridFulltextOptions as aa, type HybridSearchHit as ab, type HybridSearchOptions as ac, type HybridVectorOptions as ad, type IfExistsMode as ae, type InitialQueryBuilder as af, type KindIntrospection as ag, type LabelPropagationMembership as ah, type LabelPropagationOptions as ai, type MaterializeRemovalsEntry as aj, type MaterializeRemovalsOptions as ak, type MaterializeRemovalsResult as al, type MeasurableAdapterHistoryTransactionContext as am, type MeasurableAdapterTransactionContext as an, type MeasurableTransactionContext as ao, type NeighborsOptions as ap, type NoRecordedCoordinate as aq, type Node as ar, type NodeAccessor as as, type NodeAlias as at, type NodeBulkFindByIndexOptions as au, type NodeCollection as av, type NodeCurrentReads as aw, type NodeGetOrCreateByConstraintOptions as ax, type NodeGetOrCreateByConstraintResult as ay, type NodeIdentifier as az, type HistoryStore as b, createQueryBuilder as b$, type RecordedStoreViewNodeCollections as b0, type RecursiveTraversalOptions as b1, type ReembedFunction as b2, type ReembedVectorFieldOptions as b3, type ReembedVectorFieldResult as b4, type SchemaIntrospection as b5, type ScopedMeasure as b6, type SearchScopeOptions as b7, type SelectContext as b8, type SelectableEdge as b9, type StreamOptions as bA, type SubgraphEdgeResult as bB, type SubgraphNodeResult as bC, type SubgraphOptions as bD, type SubgraphResult as bE, type SubsetEdge as bF, type SubsetNode as bG, type TemporalAlgorithmOptions as bH, type TransactionContext as bI, type TransactionOutcome as bJ, type TransactionReceipt as bK, type TraversalDirection as bL, type TypedEdgeCollection as bM, type TypedRecordedStoreViewEdgeCollection as bN, type TypedStoreViewEdgeCollection as bO, UnionableQuery as bP, type UniqueIntrospection as bQ, type UpdateEdgeInput as bR, type UpdateNodeInput as bS, type VectorSearchHit as bT, type VectorSearchOptions as bU, type WeaklyConnectedComponentMembership as bV, type WeaklyConnectedComponentsOptions as bW, type WeightedShortestPathOptions as bX, type WeightedShortestPathResult as bY, createAdapterStore as bZ, createAdapterStoreWithSchema as b_, type SelectableNode as ba, type ShortestPathOptions as bb, type ShortestPathResult as bc, type SqlAvailability as bd, type StoreHooks as be, type StoreProjection as bf, type StoreRef as bg, StoreSearch as bh, StoreView as bi, type StoreViewCanReachOptions as bj, type StoreViewCoordinate as bk, type StoreViewDegreeOptions as bl, type StoreViewEdgeCollection as bm, type StoreViewEdgeCollections as bn, type StoreViewGraphAlgorithms as bo, type StoreViewLabelPropagationOptions as bp, type StoreViewNeighborsOptions as bq, type StoreViewNodeCollection as br, type StoreViewNodeCollections as bs, type StoreViewPageRankOptions as bt, type StoreViewPersonalizedPageRankOptions as bu, type StoreViewReachableOptions as bv, type StoreViewShortestPathOptions as bw, type StoreViewSubgraphOptions as bx, type StoreViewWeaklyConnectedComponentsOptions as by, type StoreViewWeightedShortestPathOptions as bz, type RecordedReadStore as c, createStore as c0, createStoreWithSchema as c1, createVerifiedAdapterStore as c2, createVerifiedStore as c3, defineSubgraphProject as c4, exists as c5, fieldRef as c6, inSubquery as c7, isParameterRef as c8, notExists as c9, notInSubquery as ca, param as cb, type RecursiveAliasMap as d, QueryBuilder as e, type EmptyRecursiveAliasMap as f, type AdapterHistoryStore as g, type AdapterHistoryTransactionContext as h, type AdapterRecordedReadStore as i, type AdapterStore as j, type AdapterTransactionContext as k, type AggregateResult as l, type AlgorithmCyclePolicy as m, type AnyEdge as n, type AnyNode as o, type BaseTraversalOptions as p, type BatchResults as q, type BatchableQuery as r, type CreateEdgeInput as s, type CreateNodeInput as t, type DynamicEdgeAccessor as u, type DynamicEdgeCollection as v, type DynamicEdgeType as w, type DynamicFieldBuilder as x, type DynamicNodeAccessor as y, type DynamicNodeCollection as z };
+export { ExecutableAggregateQuery as $, type AliasMap as A, type BaseStoreOptions as B, type ConstraintNames as C, type DegreeOptions as D, type EdgeAliasMap as E, type DynamicNodeType as F, type DynamicSelectableEdge as G, type HistoryStoreOptions as H, type DynamicSelectableNode as I, type Edge as J, type EdgeAccessor as K, type LiveStoreOptions as L, type EdgeBatchReads as M, type EdgeCollection as N, type EdgeFindByEndpointsOptions as O, type EdgeGetOrCreateByEndpointsOptions as P, type QueryCoordinateState as Q, type RecordedReadStoreOptions as R, type StoreOptions as S, TraversalBuilder as T, type UnboundLiveStoreOptions as U, type EdgeGetOrCreateByEndpointsResult as V, type EdgeIntrospection as W, type EdgeTemporalReads as X, type EdgeWrites as Y, type EmptyAliasMap as Z, type EmptyEdgeAliasMap as _, type Store as a, type RecordedStoreViewEdgeCollections as a$, ExecutableQuery as a0, type FieldAccessor as a1, type FulltextSearchHit as a2, type FulltextSearchOptions as a3, type GetOrCreateAction as a4, type GraphAlgorithms as a5, type GraphEdgeCollections as a6, type GraphNodeCollections as a7, type HistoryStoreBackend as a8, type HookContext as a9, type NodeRef as aA, type NodeTemporalReads as aB, type NodeWrites as aC, type OntologyIntrospection as aD, type OperationHookContext as aE, type PageRankOptions as aF, type PageRankScore as aG, type PaginateOptions as aH, type PaginatedResult as aI, type PathNode as aJ, type PersonalizedPageRankOptions as aK, type PersonalizedPageRankSeed as aL, type Predicate as aM, PreparedQuery as aN, type PropsAccessor as aO, type QueryHookContext as aP, type QueryOptions as aQ, type ReachableNode as aR, type ReachableOptions as aS, type RebuildFulltextOptions as aT, type RebuildFulltextResult as aU, type ReclaimedVectorFieldEntry as aV, type ReconciledSchema as aW, type RecordedScanOptions as aX, type RecordedScanPage as aY, RecordedStoreView as aZ, type RecordedStoreViewEdgeCollection as a_, type HybridFulltextOptions as aa, type HybridSearchHit as ab, type HybridSearchOptions as ac, type HybridVectorOptions as ad, type IfExistsMode as ae, type InitialQueryBuilder as af, type KindIntrospection as ag, type LabelPropagationMembership as ah, type LabelPropagationOptions as ai, type MaterializeRemovalsEntry as aj, type MaterializeRemovalsOptions as ak, type MaterializeRemovalsResult as al, type MeasurableAdapterHistoryTransactionContext as am, type MeasurableAdapterTransactionContext as an, type MeasurableTransactionContext as ao, type NeighborsOptions as ap, type NoRecordedCoordinate as aq, type Node as ar, type NodeAccessor as as, type NodeAlias as at, type NodeBulkFindByIndexOptions as au, type NodeCollection as av, type NodeCurrentReads as aw, type NodeGetOrCreateByConstraintOptions as ax, type NodeGetOrCreateByConstraintResult as ay, type NodeIdentifier as az, type HistoryStore as b, createAdapterStoreWithSchema as b$, type RecordedStoreViewNodeCollection as b0, type RecordedStoreViewNodeCollections as b1, type RecursiveTraversalOptions as b2, type ReembedFunction as b3, type ReembedVectorFieldOptions as b4, type ReembedVectorFieldResult as b5, type SchemaIntrospection as b6, type ScopedMeasure as b7, type SearchScopeOptions as b8, type SelectContext as b9, type StoreViewWeightedShortestPathOptions as bA, type StreamOptions as bB, type SubgraphEdgeResult as bC, type SubgraphNodeResult as bD, type SubgraphOptions as bE, type SubgraphResult as bF, type SubsetEdge as bG, type SubsetNode as bH, type TemporalAlgorithmOptions as bI, type TransactionContext as bJ, type TransactionOutcome as bK, type TransactionReceipt as bL, type TraversalDirection as bM, type TypedEdgeCollection as bN, type TypedRecordedStoreViewEdgeCollection as bO, type TypedStoreViewEdgeCollection as bP, UnionableQuery as bQ, type UniqueIntrospection as bR, type UpdateEdgeInput as bS, type UpdateNodeInput as bT, type VectorSearchHit as bU, type VectorSearchOptions as bV, type WeaklyConnectedComponentMembership as bW, type WeaklyConnectedComponentsOptions as bX, type WeightedShortestPathOptions as bY, type WeightedShortestPathResult as bZ, createAdapterStore as b_, type SelectableEdge as ba, type SelectableNode as bb, type ShortestPathOptions as bc, type ShortestPathResult as bd, type SqlAvailability as be, type StoreHooks as bf, type StoreProjection as bg, type StoreRef as bh, StoreSearch as bi, StoreView as bj, type StoreViewCanReachOptions as bk, type StoreViewCoordinate as bl, type StoreViewDegreeOptions as bm, type StoreViewEdgeCollection as bn, type StoreViewEdgeCollections as bo, type StoreViewGraphAlgorithms as bp, type StoreViewLabelPropagationOptions as bq, type StoreViewNeighborsOptions as br, type StoreViewNodeCollection as bs, type StoreViewNodeCollections as bt, type StoreViewPageRankOptions as bu, type StoreViewPersonalizedPageRankOptions as bv, type StoreViewReachableOptions as bw, type StoreViewShortestPathOptions as bx, type StoreViewSubgraphOptions as by, type StoreViewWeaklyConnectedComponentsOptions as bz, type RecordedReadStore as c, createQueryBuilder as c0, createStore as c1, createStoreWithSchema as c2, createVerifiedAdapterStore as c3, createVerifiedStore as c4, defineSubgraphProject as c5, exists as c6, fieldRef as c7, inSubquery as c8, isParameterRef as c9, notExists as ca, notInSubquery as cb, param as cc, type RecursiveAliasMap as d, QueryBuilder as e, type EmptyRecursiveAliasMap as f, type AdapterHistoryStore as g, type AdapterHistoryTransactionContext as h, type AdapterRecordedReadStore as i, type AdapterStore as j, type AdapterTransactionContext as k, type AggregateResult as l, type AlgorithmCyclePolicy as m, type AnyEdge as n, type AnyNode as o, type BaseTraversalOptions as p, type BatchResults as q, type BatchableQuery as r, type CreateEdgeInput as s, type CreateNodeInput as t, type DynamicEdgeAccessor as u, type DynamicEdgeCollection as v, type DynamicEdgeType as w, type DynamicFieldBuilder as x, type DynamicNodeAccessor as y, type DynamicNodeCollection as z };

package/dist/{store-view-C-buB8Q8.d.cts → store-view-CNcOG8bQ.d.cts}

@@ -1,11 +1,10 @@
-import { G as GraphDef, E as EdgeKinds, N as NodeKinds, a as AllNodeTypes } from './define-graph-Cv3CFwKm.cjs';
-import { R as RecordedInstant, d as ReadCoordinate } from './temporal-Dn_JADWY.cjs';
-import { a as NodeType, A as AnyEdgeType, d as EdgeType, T as TemporalMode, E as EdgeRegistration, m as NodeId, K as KindEntity, g as EdgeId, N as NodeRegistration, l as KindAnnotations, o as UniquenessScope, f as Collation, e as Cardinality, j as EndpointExistence, G as GraphExtension } from './extension-types-BLEVH4SG.cjs';
-import { K as KindRegistry, S as SchemaManagerOptions, d as SchemaValidationResult } from './manager-mqee5MVB.cjs';
+import { G as GraphDef, E as EdgeKinds, N as NodeKinds, a as AllNodeTypes } from './define-graph-Byslw2OO.cjs';
+import { R as RecordedInstant, d as ReadCoordinate } from './temporal-CMpigMCW.cjs';
+import { bZ as ValueType, b_ as PredicateExpression, aw as FulltextQueryMode, b$ as VectorMetricType, Q as QueryAst, J as JsonPointer, a0 as FieldRef, aX as ParameterRef, a as NodeType, b as AnyEdgeType, _ as EdgeType, bq as TraversalExpansion, w as GraphBackend, S as SqlDialect, bh as SqlSchema, c0 as Traversal, c1 as NodePredicate, c2 as ProjectedField, aW as OrderSpec, c3 as AggregateOrderSpec, T as TemporalMode, c4 as GroupBySpec, aE as HybridFusionOptions, aI as JsonPointerInput, c5 as RecursiveCyclePolicy, a3 as TraversalDirection$1, E as EdgeRegistration, aU as NodeId, bn as TransactionBackend, K as KindEntity, aq as ExternalRecordedReadSource, c6 as NodeRow, am as EdgeId, c7 as EdgeRow, N as NodeRegistration, bp as TransactionReadBackend, $ as AggregateExpr, ba as SortDirection, af as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, c8 as VectorSlotMap, c9 as RecordedReadBinding, ca as SelectiveField, cb as ComposableQuery, cc as SetOperationType, cd as SetOperation, ce as VectorMetric, aN as KindAnnotations, W as JsonSchema, bu as UniquenessScope, ab as Collation, aa as Cardinality, ap as EndpointExistence, G as GraphExtension, B as BackendCapabilities, bo as TransactionOptions, A as AdapterBackend } from './types-Dh-EgT-w.cjs';
+import { K as KindRegistry, S as SchemaManagerOptions, a as SchemaValidationResult } from './manager-U9_zopqr.cjs';
 import { z } from 'zod';
-import { bp as ValueType, bq as PredicateExpression, ad as FulltextQueryMode, br as VectorMetricType, Q as QueryAst, J as JsonPointer, K as FieldRef, ay as ParameterRef, b1 as TraversalExpansion, G as GraphBackend, S as SqlDialect, aU as SqlSchema, bs as Traversal, bt as NodePredicate, bu as ProjectedField, ax as OrderSpec, bv as AggregateOrderSpec, bw as GroupBySpec, ak as HybridFusionOptions, ao as JsonPointerInput, bx as RecursiveCyclePolicy, T as TraversalDirection$1, a_ as TransactionBackend, a7 as ExternalRecordedReadSource, by as NodeRow, bz as EdgeRow, b0 as TransactionReadBackend, H as AggregateExpr, aN as SortDirection, a0 as CompiledSelectSql, F as FulltextStrategy, V as VectorStrategy, bA as VectorSlotMap, bB as RecordedReadBinding, bC as SelectiveField, bD as ComposableQuery, bE as SetOperationType, bF as SetOperation, bG as VectorMetric, x as JsonSchema, B as BackendCapabilities, a$ as TransactionOptions, A as AdapterBackend } from './types-C5pZeKTl.cjs';
-import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-BxlJQVFw.cjs';
-import { b as MaterializeIndexesOptions, M as MaterializeIndexesResult, c as MaterializeSystemIndexesOptions } from './materialize-indexes-ExQ6OrAh.cjs';
+import { S as SearchableMetadata, c as EmbeddingValue } from './searchable-B4mUXZT6.cjs';
+import { S as SchemaDiff, h as MaterializeIndexesOptions, M as MaterializeIndexesResult, j as MaterializeSystemIndexesOptions } from './materialize-indexes-DzMCetZe.cjs';
 
 type FieldTypeInfo = Readonly<{
     valueType: ValueType;
@@ -3970,6 +3969,8 @@ type StoreCore<G extends GraphDef> = Readonly<{
     getEdgePropsSchema: (kind: string) => z.ZodObject<z.ZodRawShape> | undefined;
     getEdgePropsSchemaOrThrow: (kind: string) => z.ZodObject<z.ZodRawShape>;
     introspect: () => SchemaIntrospection;
+    schemaChanges: () => Promise<SchemaDiff | undefined>;
+    requiresMigration: () => Promise<boolean>;
     query: () => InitialQueryBuilder<G, "open">;
     asOf: (asOf: string) => StoreView<G>;
     asOfRecorded: (recordedAsOf: RecordedInstant) => RecordedStoreView<G>;
@@ -4018,12 +4019,63 @@ interface StoreEvolution<G extends GraphDef, TStore extends StoreCore<G>> {
  * internals, and caller-owned transaction adoption out of the public surface.
  */
 type Store<G extends GraphDef> = StoreCore<G> & StoreTransactions<G> & StoreEvolution<G, Store<G>>;
+/**
+ * An opaque, in-memory snapshot of a store's reconciled schema: the merged
+ * compile-time + runtime-committed graph plus the committed schema version and
+ * hash it reflects. Produced by {@link AdapterStore.reconciledSchema} after a
+ * verified open, cached once per isolate/process, and handed to
+ * {@link createAdapterStore} via `{ reconciled }` (or used implicitly by
+ * {@link AdapterStore.withBackend}) to build request-scoped stores against
+ * fresh connections with **zero** database round-trips. Reads and writes are
+ * validated against the reconciled graph, so runtime-committed kinds seen at
+ * the reconcile are honored without re-querying.
+ *
+ * Treat it as opaque and immutable — do not construct or mutate it. Its
+ * `version` is the value to compare against {@link getCommittedSchemaVersion}
+ * to detect a schema commit from another process and refresh the snapshot.
+ */
+type ReconciledSchema<G extends GraphDef> = Readonly<{
+    graph: G;
+    version: number | undefined;
+    hash: string | undefined;
+}>;
+/** Construction option carrying a cached {@link ReconciledSchema}. */
+type ReconciledOption<G extends GraphDef> = Readonly<{
+    reconciled?: ReconciledSchema<G>;
+}>;
+/**
+ * The reconciliation surface shared by every adapter store flavor: read the
+ * cached {@link ReconciledSchema} and rebind to a fresh connection with no
+ * verify round-trip. `Self` is the receiver's own surface so `withBackend`
+ * preserves the store flavor (live / history / recorded-read).
+ *
+ * Declared as an `interface` (not a `type`): the surface aliases intersect it
+ * with `Self` bound to themselves, which a `type` alias rejects as a circular
+ * self-reference (TS2456) but an interface resolves lazily — the same idiom as
+ * {@link StoreEvolution}.
+ */
+interface AdapterStoreReconciliation<G extends GraphDef, TNativeTransaction, Self> {
+    /**
+     * An opaque snapshot of this store's reconciled schema. Cache it after a
+     * verified open and pass it to {@link createAdapterStore} `{ reconciled }`
+     * to build per-request stores with zero database round-trips.
+     */
+    readonly reconciledSchema: ReconciledSchema<G>;
+    /**
+     * Build an equivalent store bound to a fresh backend/connection, reusing
+     * this store's already-reconciled schema — no verify round-trip. The
+     * per-request primitive for serverless deployments that open a new
+     * connection per request; the returned store validates writes against the
+     * same reconciled graph as the receiver.
+     */
+    readonly withBackend: (backend: AdapterBackend<TNativeTransaction>) => Self;
+}
 /**
  * A Store with explicit adapter interoperability. Adapter entrypoints return
  * this surface so native transaction handles remain precisely typed without
  * leaking into the default Store contract.
  */
-type AdapterStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterStore<G, TNativeTransaction>> & AdapterStoreTransactions<G, TNativeTransaction> & Readonly<{
+type AdapterStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterStore<G, TNativeTransaction>> & AdapterStoreTransactions<G, TNativeTransaction> & AdapterStoreReconciliation<G, TNativeTransaction, AdapterStore<G, TNativeTransaction>> & Readonly<{
     backend: GraphBackend;
 }>;
 type AdapterStoreTransactions<G extends GraphDef, TNativeTransaction> = Readonly<{
@@ -4046,7 +4098,7 @@ type AdapterHistoryTransactionContext<G extends GraphDef, TNativeTransaction> =
 type MeasurableAdapterHistoryTransactionContext<G extends GraphDef, TNativeTransaction> = AdapterHistoryTransactionContext<G, TNativeTransaction> & Readonly<{
     measure: ScopedMeasure<MeasurableAdapterHistoryTransactionContext<G, TNativeTransaction>>;
 }>;
-type AdapterRecordedReadStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterRecordedReadStore<G, TNativeTransaction>> & AdapterStoreTransactions<G, TNativeTransaction> & Readonly<{
+type AdapterRecordedReadStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterRecordedReadStore<G, TNativeTransaction>> & AdapterStoreTransactions<G, TNativeTransaction> & AdapterStoreReconciliation<G, TNativeTransaction, AdapterRecordedReadStore<G, TNativeTransaction>> & Readonly<{
     backend: GraphBackend;
     recordedReadBound: true;
 }>;
@@ -4057,7 +4109,7 @@ type HistoryStore<G extends GraphDef> = StoreCore<G> & StoreTransactions<G> & St
     historyEnabled: true;
     recordedReadBound: true;
 }>;
-type AdapterHistoryStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterHistoryStore<G, TNativeTransaction>> & AdapterHistoryStoreTransactions<G, TNativeTransaction> & Readonly<{
+type AdapterHistoryStore<G extends GraphDef, TNativeTransaction> = StoreCore<G> & StoreEvolution<G, AdapterHistoryStore<G, TNativeTransaction>> & AdapterHistoryStoreTransactions<G, TNativeTransaction> & AdapterStoreReconciliation<G, TNativeTransaction, AdapterHistoryStore<G, TNativeTransaction>> & Readonly<{
     backend: HistoryStoreBackend;
     historyEnabled: true;
     recordedReadBound: true;
@@ -4101,11 +4153,11 @@ declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend
 declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend, options?: UnboundLiveStoreOptions): Store<G>;
 declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend, options: LiveStoreOptions | undefined): Store<G> | RecordedReadStore<G>;
 declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend, options: StoreOptions | undefined): Store<G> | HistoryStore<G> | RecordedReadStore<G>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: HistoryStoreOptions): AdapterHistoryStore<G, TNativeTransaction>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: RecordedReadStoreOptions): AdapterRecordedReadStore<G, TNativeTransaction>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options?: UnboundLiveStoreOptions): AdapterStore<G, TNativeTransaction>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: LiveStoreOptions | undefined): AdapterStore<G, TNativeTransaction> | AdapterRecordedReadStore<G, TNativeTransaction>;
-declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: StoreOptions | undefined): AdapterStore<G, TNativeTransaction> | AdapterHistoryStore<G, TNativeTransaction> | AdapterRecordedReadStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: HistoryStoreOptions & ReconciledOption<G>): AdapterHistoryStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: RecordedReadStoreOptions & ReconciledOption<G>): AdapterRecordedReadStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options?: UnboundLiveStoreOptions & ReconciledOption<G>): AdapterStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: (LiveStoreOptions & ReconciledOption<G>) | undefined): AdapterStore<G, TNativeTransaction> | AdapterRecordedReadStore<G, TNativeTransaction>;
+declare function createAdapterStore<G extends GraphDef, TNativeTransaction>(graph: G, backend: AdapterBackend<TNativeTransaction>, options: (StoreOptions & ReconciledOption<G>) | undefined): AdapterStore<G, TNativeTransaction> | AdapterHistoryStore<G, TNativeTransaction> | AdapterRecordedReadStore<G, TNativeTransaction>;
 
 /**
  * Creates a store and ensures the schema is initialized/migrated.
@@ -4403,4 +4455,4 @@ declare class RecordedStoreView<G extends GraphDef> extends CoordinatePinnedView
     get edges(): RecordedStoreViewEdgeCollections<G>;
 }
 
-export { ExecutableAggregateQuery as $, type AliasMap as A, type BaseStoreOptions as B, type ConstraintNames as C, type DegreeOptions as D, type EdgeAliasMap as E, type DynamicNodeType as F, type DynamicSelectableEdge as G, type HistoryStoreOptions as H, type DynamicSelectableNode as I, type Edge as J, type EdgeAccessor as K, type LiveStoreOptions as L, type EdgeBatchReads as M, type EdgeCollection as N, type EdgeFindByEndpointsOptions as O, type EdgeGetOrCreateByEndpointsOptions as P, type QueryCoordinateState as Q, type RecordedReadStoreOptions as R, type StoreOptions as S, TraversalBuilder as T, type UnboundLiveStoreOptions as U, type EdgeGetOrCreateByEndpointsResult as V, type EdgeIntrospection as W, type EdgeTemporalReads as X, type EdgeWrites as Y, type EmptyAliasMap as Z, type EmptyEdgeAliasMap as _, type Store as a, type RecordedStoreViewNodeCollection as a$, ExecutableQuery as a0, type FieldAccessor as a1, type FulltextSearchHit as a2, type FulltextSearchOptions as a3, type GetOrCreateAction as a4, type GraphAlgorithms as a5, type GraphEdgeCollections as a6, type GraphNodeCollections as a7, type HistoryStoreBackend as a8, type HookContext as a9, type NodeRef as aA, type NodeTemporalReads as aB, type NodeWrites as aC, type OntologyIntrospection as aD, type OperationHookContext as aE, type PageRankOptions as aF, type PageRankScore as aG, type PaginateOptions as aH, type PaginatedResult as aI, type PathNode as aJ, type PersonalizedPageRankOptions as aK, type PersonalizedPageRankSeed as aL, type Predicate as aM, PreparedQuery as aN, type PropsAccessor as aO, type QueryHookContext as aP, type QueryOptions as aQ, type ReachableNode as aR, type ReachableOptions as aS, type RebuildFulltextOptions as aT, type RebuildFulltextResult as aU, type ReclaimedVectorFieldEntry as aV, type RecordedScanOptions as aW, type RecordedScanPage as aX, RecordedStoreView as aY, type RecordedStoreViewEdgeCollection as aZ, type RecordedStoreViewEdgeCollections as a_, type HybridFulltextOptions as aa, type HybridSearchHit as ab, type HybridSearchOptions as ac, type HybridVectorOptions as ad, type IfExistsMode as ae, type InitialQueryBuilder as af, type KindIntrospection as ag, type LabelPropagationMembership as ah, type LabelPropagationOptions as ai, type MaterializeRemovalsEntry as aj, type MaterializeRemovalsOptions as ak, type MaterializeRemovalsResult as al, type MeasurableAdapterHistoryTransactionContext as am, type MeasurableAdapterTransactionContext as an, type MeasurableTransactionContext as ao, type NeighborsOptions as ap, type NoRecordedCoordinate as aq, type Node as ar, type NodeAccessor as as, type NodeAlias as at, type NodeBulkFindByIndexOptions as au, type NodeCollection as av, type NodeCurrentReads as aw, type NodeGetOrCreateByConstraintOptions as ax, type NodeGetOrCreateByConstraintResult as ay, type NodeIdentifier as az, type HistoryStore as b, createQueryBuilder as b$, type RecordedStoreViewNodeCollections as b0, type RecursiveTraversalOptions as b1, type ReembedFunction as b2, type ReembedVectorFieldOptions as b3, type ReembedVectorFieldResult as b4, type SchemaIntrospection as b5, type ScopedMeasure as b6, type SearchScopeOptions as b7, type SelectContext as b8, type SelectableEdge as b9, type StreamOptions as bA, type SubgraphEdgeResult as bB, type SubgraphNodeResult as bC, type SubgraphOptions as bD, type SubgraphResult as bE, type SubsetEdge as bF, type SubsetNode as bG, type TemporalAlgorithmOptions as bH, type TransactionContext as bI, type TransactionOutcome as bJ, type TransactionReceipt as bK, type TraversalDirection as bL, type TypedEdgeCollection as bM, type TypedRecordedStoreViewEdgeCollection as bN, type TypedStoreViewEdgeCollection as bO, UnionableQuery as bP, type UniqueIntrospection as bQ, type UpdateEdgeInput as bR, type UpdateNodeInput as bS, type VectorSearchHit as bT, type VectorSearchOptions as bU, type WeaklyConnectedComponentMembership as bV, type WeaklyConnectedComponentsOptions as bW, type WeightedShortestPathOptions as bX, type WeightedShortestPathResult as bY, createAdapterStore as bZ, createAdapterStoreWithSchema as b_, type SelectableNode as ba, type ShortestPathOptions as bb, type ShortestPathResult as bc, type SqlAvailability as bd, type StoreHooks as be, type StoreProjection as bf, type StoreRef as bg, StoreSearch as bh, StoreView as bi, type StoreViewCanReachOptions as bj, type StoreViewCoordinate as bk, type StoreViewDegreeOptions as bl, type StoreViewEdgeCollection as bm, type StoreViewEdgeCollections as bn, type StoreViewGraphAlgorithms as bo, type StoreViewLabelPropagationOptions as bp, type StoreViewNeighborsOptions as bq, type StoreViewNodeCollection as br, type StoreViewNodeCollections as bs, type StoreViewPageRankOptions as bt, type StoreViewPersonalizedPageRankOptions as bu, type StoreViewReachableOptions as bv, type StoreViewShortestPathOptions as bw, type StoreViewSubgraphOptions as bx, type StoreViewWeaklyConnectedComponentsOptions as by, type StoreViewWeightedShortestPathOptions as bz, type RecordedReadStore as c, createStore as c0, createStoreWithSchema as c1, createVerifiedAdapterStore as c2, createVerifiedStore as c3, defineSubgraphProject as c4, exists as c5, fieldRef as c6, inSubquery as c7, isParameterRef as c8, notExists as c9, notInSubquery as ca, param as cb, type RecursiveAliasMap as d, QueryBuilder as e, type EmptyRecursiveAliasMap as f, type AdapterHistoryStore as g, type AdapterHistoryTransactionContext as h, type AdapterRecordedReadStore as i, type AdapterStore as j, type AdapterTransactionContext as k, type AggregateResult as l, type AlgorithmCyclePolicy as m, type AnyEdge as n, type AnyNode as o, type BaseTraversalOptions as p, type BatchResults as q, type BatchableQuery as r, type CreateEdgeInput as s, type CreateNodeInput as t, type DynamicEdgeAccessor as u, type DynamicEdgeCollection as v, type DynamicEdgeType as w, type DynamicFieldBuilder as x, type DynamicNodeAccessor as y, type DynamicNodeCollection as z };
+export { ExecutableAggregateQuery as $, type AliasMap as A, type BaseStoreOptions as B, type ConstraintNames as C, type DegreeOptions as D, type EdgeAliasMap as E, type DynamicNodeType as F, type DynamicSelectableEdge as G, type HistoryStoreOptions as H, type DynamicSelectableNode as I, type Edge as J, type EdgeAccessor as K, type LiveStoreOptions as L, type EdgeBatchReads as M, type EdgeCollection as N, type EdgeFindByEndpointsOptions as O, type EdgeGetOrCreateByEndpointsOptions as P, type QueryCoordinateState as Q, type RecordedReadStoreOptions as R, type StoreOptions as S, TraversalBuilder as T, type UnboundLiveStoreOptions as U, type EdgeGetOrCreateByEndpointsResult as V, type EdgeIntrospection as W, type EdgeTemporalReads as X, type EdgeWrites as Y, type EmptyAliasMap as Z, type EmptyEdgeAliasMap as _, type Store as a, type RecordedStoreViewEdgeCollections as a$, ExecutableQuery as a0, type FieldAccessor as a1, type FulltextSearchHit as a2, type FulltextSearchOptions as a3, type GetOrCreateAction as a4, type GraphAlgorithms as a5, type GraphEdgeCollections as a6, type GraphNodeCollections as a7, type HistoryStoreBackend as a8, type HookContext as a9, type NodeRef as aA, type NodeTemporalReads as aB, type NodeWrites as aC, type OntologyIntrospection as aD, type OperationHookContext as aE, type PageRankOptions as aF, type PageRankScore as aG, type PaginateOptions as aH, type PaginatedResult as aI, type PathNode as aJ, type PersonalizedPageRankOptions as aK, type PersonalizedPageRankSeed as aL, type Predicate as aM, PreparedQuery as aN, type PropsAccessor as aO, type QueryHookContext as aP, type QueryOptions as aQ, type ReachableNode as aR, type ReachableOptions as aS, type RebuildFulltextOptions as aT, type RebuildFulltextResult as aU, type ReclaimedVectorFieldEntry as aV, type ReconciledSchema as aW, type RecordedScanOptions as aX, type RecordedScanPage as aY, RecordedStoreView as aZ, type RecordedStoreViewEdgeCollection as a_, type HybridFulltextOptions as aa, type HybridSearchHit as ab, type HybridSearchOptions as ac, type HybridVectorOptions as ad, type IfExistsMode as ae, type InitialQueryBuilder as af, type KindIntrospection as ag, type LabelPropagationMembership as ah, type LabelPropagationOptions as ai, type MaterializeRemovalsEntry as aj, type MaterializeRemovalsOptions as ak, type MaterializeRemovalsResult as al, type MeasurableAdapterHistoryTransactionContext as am, type MeasurableAdapterTransactionContext as an, type MeasurableTransactionContext as ao, type NeighborsOptions as ap, type NoRecordedCoordinate as aq, type Node as ar, type NodeAccessor as as, type NodeAlias as at, type NodeBulkFindByIndexOptions as au, type NodeCollection as av, type NodeCurrentReads as aw, type NodeGetOrCreateByConstraintOptions as ax, type NodeGetOrCreateByConstraintResult as ay, type NodeIdentifier as az, type HistoryStore as b, createAdapterStoreWithSchema as b$, type RecordedStoreViewNodeCollection as b0, type RecordedStoreViewNodeCollections as b1, type RecursiveTraversalOptions as b2, type ReembedFunction as b3, type ReembedVectorFieldOptions as b4, type ReembedVectorFieldResult as b5, type SchemaIntrospection as b6, type ScopedMeasure as b7, type SearchScopeOptions as b8, type SelectContext as b9, type StoreViewWeightedShortestPathOptions as bA, type StreamOptions as bB, type SubgraphEdgeResult as bC, type SubgraphNodeResult as bD, type SubgraphOptions as bE, type SubgraphResult as bF, type SubsetEdge as bG, type SubsetNode as bH, type TemporalAlgorithmOptions as bI, type TransactionContext as bJ, type TransactionOutcome as bK, type TransactionReceipt as bL, type TraversalDirection as bM, type TypedEdgeCollection as bN, type TypedRecordedStoreViewEdgeCollection as bO, type TypedStoreViewEdgeCollection as bP, UnionableQuery as bQ, type UniqueIntrospection as bR, type UpdateEdgeInput as bS, type UpdateNodeInput as bT, type VectorSearchHit as bU, type VectorSearchOptions as bV, type WeaklyConnectedComponentMembership as bW, type WeaklyConnectedComponentsOptions as bX, type WeightedShortestPathOptions as bY, type WeightedShortestPathResult as bZ, createAdapterStore as b_, type SelectableEdge as ba, type SelectableNode as bb, type ShortestPathOptions as bc, type ShortestPathResult as bd, type SqlAvailability as be, type StoreHooks as bf, type StoreProjection as bg, type StoreRef as bh, StoreSearch as bi, StoreView as bj, type StoreViewCanReachOptions as bk, type StoreViewCoordinate as bl, type StoreViewDegreeOptions as bm, type StoreViewEdgeCollection as bn, type StoreViewEdgeCollections as bo, type StoreViewGraphAlgorithms as bp, type StoreViewLabelPropagationOptions as bq, type StoreViewNeighborsOptions as br, type StoreViewNodeCollection as bs, type StoreViewNodeCollections as bt, type StoreViewPageRankOptions as bu, type StoreViewPersonalizedPageRankOptions as bv, type StoreViewReachableOptions as bw, type StoreViewShortestPathOptions as bx, type StoreViewSubgraphOptions as by, type StoreViewWeaklyConnectedComponentsOptions as bz, type RecordedReadStore as c, createQueryBuilder as c0, createStore as c1, createStoreWithSchema as c2, createVerifiedAdapterStore as c3, createVerifiedStore as c4, defineSubgraphProject as c5, exists as c6, fieldRef as c7, inSubquery as c8, isParameterRef as c9, notExists as ca, notInSubquery as cb, param as cc, type RecursiveAliasMap as d, QueryBuilder as e, type EmptyRecursiveAliasMap as f, type AdapterHistoryStore as g, type AdapterHistoryTransactionContext as h, type AdapterRecordedReadStore as i, type AdapterStore as j, type AdapterTransactionContext as k, type AggregateResult as l, type AlgorithmCyclePolicy as m, type AnyEdge as n, type AnyNode as o, type BaseTraversalOptions as p, type BatchResults as q, type BatchableQuery as r, type CreateEdgeInput as s, type CreateNodeInput as t, type DynamicEdgeAccessor as u, type DynamicEdgeCollection as v, type DynamicEdgeType as w, type DynamicFieldBuilder as x, type DynamicNodeAccessor as y, type DynamicNodeCollection as z };

package/dist/{temporal-CyFsSPe8.d.ts → temporal-BtrTYTiB.d.ts}

@@ -1,4 +1,4 @@
-import { T as TemporalMode } from './extension-types-BLEVH4SG.js';
+import { T as TemporalMode } from './types-Dh-EgT-w.js';
 
 declare const RECORDED_INSTANT_BRAND: unique symbol;
 /**

package/dist/{temporal-Dn_JADWY.d.cts → temporal-CMpigMCW.d.cts}

@@ -1,4 +1,4 @@
-import { T as TemporalMode } from './extension-types-BLEVH4SG.cjs';
+import { T as TemporalMode } from './types-Dh-EgT-w.cjs';
 
 declare const RECORDED_INSTANT_BRAND: unique symbol;
 /**

package/dist/{types-CYdXzZef.d.ts → types-D2rU5Taq.d.ts}

@@ -1,5 +1,4 @@
-import { K as KindEntity } from './extension-types-BLEVH4SG.js';
-import { J as JsonPointer } from './types-D8szWDUo.js';
+import { K as KindEntity, J as JsonPointer } from './types-Dh-EgT-w.js';
 
 /**
  * QueryProfiler types.