@nicia-ai/typegraph 0.38.0 → 0.40.0

package/dist/{store-view-Ctq-3OHy.d.ts → store-view-CagdeyNn.d.ts}

@@ -1,9 +1,10 @@
-import { G as GraphDef, E as EdgeKinds, N as NodeKinds, a as AllNodeTypes } from './define-graph-DRo9xpYN.js';
-import { S as SearchableMetadata, R as RecordedInstant, c as EmbeddingValue, l as ReadCoordinate } from './temporal-DqtOEo_B.js';
+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-CASfhmzV.js';
+import { K as KindRegistry, S as SchemaManagerOptions, d as SchemaValidationResult } from './manager-DjE6Mhag.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 './index-Bq7vSPHy.js';
+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';
 
 type FieldTypeInfo = Readonly<{
@@ -1819,17 +1820,39 @@ type StoreViewNodeCollections<G extends GraphDef> = {
 type StoreViewEdgeCollections<G extends GraphDef> = {
     [K in keyof G["edges"] & string]-?: TypedStoreViewEdgeCollection<G["edges"][K]>;
 };
-/** Recorded-time node point reads for one node kind. */
-type RecordedStoreViewNodeCollection<N extends NodeType> = Pick<StoreViewNodeCollection<N>, (typeof RECORDED_POINT_READ_NAMES)[number]>;
-/** Recorded-time edge point reads for one edge kind. */
-type RecordedStoreViewEdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To extends NodeType = NodeType> = Pick<StoreViewEdgeCollection<E, From, To>, (typeof RECORDED_POINT_READ_NAMES)[number]>;
+/** Options for one bounded, forward-only recorded-time collection scan. */
+type RecordedScanOptions = Readonly<{
+    /** Maximum entities to return. Defaults to 1,000 and cannot exceed 1,000. */
+    limit?: number;
+    /** Opaque cursor returned by the preceding page. */
+    after?: string;
+}>;
+/** One page from a deterministic recorded-time collection scan. */
+type RecordedScanPage<T> = Readonly<{
+    /** Entities ordered by canonical id ascending. */
+    data: readonly T[];
+    /** Cursor for the next page, or `undefined` when the scan is complete. */
+    nextCursor: string | undefined;
+    /** Whether another page exists after this one. */
+    hasNextPage: boolean;
+}>;
+/** Recorded-time reconstructing reads for one node kind. */
+type RecordedStoreViewNodeCollection<N extends NodeType> = Pick<StoreViewNodeCollection<N>, (typeof RECORDED_POINT_READ_NAMES)[number]> & Readonly<{
+    /** Scan one bounded page at the view's pinned coordinate. */
+    scan: (options?: RecordedScanOptions) => Promise<RecordedScanPage<Node<N>>>;
+}>;
+/** Recorded-time reconstructing reads for one edge kind. */
+type RecordedStoreViewEdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To extends NodeType = NodeType> = Pick<StoreViewEdgeCollection<E, From, To>, (typeof RECORDED_POINT_READ_NAMES)[number]> & Readonly<{
+    /** Scan one bounded page at the view's pinned coordinate. */
+    scan: (options?: RecordedScanOptions) => Promise<RecordedScanPage<Edge<E, From, To>>>;
+}>;
 /** Recorded-time edge collection derived from an `EdgeRegistration`. */
 type TypedRecordedStoreViewEdgeCollection<R extends EdgeRegistration> = RecordedStoreViewEdgeCollection<R["type"], EdgeFromTypes<R> extends NodeType ? EdgeFromTypes<R> : NodeType, EdgeToTypes<R> extends NodeType ? EdgeToTypes<R> : NodeType>;
-/** Mapped type of all recorded-time node point-read collections. */
+/** Mapped type of all recorded-time node reconstructing-read collections. */
 type RecordedStoreViewNodeCollections<G extends GraphDef> = {
     [K in keyof G["nodes"] & string]-?: RecordedStoreViewNodeCollection<G["nodes"][K]["type"]>;
 };
-/** Mapped type of all recorded-time edge point-read collections. */
+/** Mapped type of all recorded-time edge reconstructing-read collections. */
 type RecordedStoreViewEdgeCollections<G extends GraphDef> = {
     [K in keyof G["edges"] & string]-?: TypedRecordedStoreViewEdgeCollection<G["edges"][K]>;
 };
@@ -1837,9 +1860,10 @@ type RecordedStoreViewEdgeCollections<G extends GraphDef> = {
  * Whether — and why — `tx.sql` can be used on a transaction context. A single
  * required discriminant covering exactly the four states raw-SQL access can be
  * in, so an adapter caller branches on capability instead of truthiness-testing
- * `tx.sql`. Under history / revision tracking the public type makes `tx.sql`
- * unusable (`sql?: never`), while the runtime object keeps a fail-loud getter
- * for JavaScript and type-suppressed callers. See
+ * `tx.sql`. The non-available variants omit `sql` entirely, so even reading the
+ * handle requires first narrowing `sqlAvailability` to `"available"`. The
+ * runtime object keeps a fail-loud getter under history / revision tracking for
+ * JavaScript and type-suppressed callers. See
  * {@link AdapterTransactionContext} for the per-value semantics.
  */
 type SqlAvailability = "available" | "history" | "revisionTracking" | "unavailable";
@@ -1847,10 +1871,8 @@ type AdapterTransactionSqlAccess<TNativeTransaction> = Readonly<{
     sql: TNativeTransaction;
     sqlAvailability: "available";
 }> | Readonly<{
-    sql?: never;
     sqlAvailability: "history" | "revisionTracking";
 }> | Readonly<{
-    sql?: undefined;
     sqlAvailability: "unavailable";
 }>;
 declare const TRANSACTION_RUNTIME: unique symbol;
@@ -2102,14 +2124,6 @@ declare class ExecutableAggregateQuery<G extends GraphDef, Aliases extends Alias
     execute(): Promise<readonly AggregateResult<R>[]>;
 }
 
-/**
- * Temporal Filter Compilation
- *
- * Generates SQL clauses for temporal filtering based on valid_from/valid_to
- * and deleted_at timestamps. Consolidates the previously duplicated temporal
- * filter functions into a single, parameterized implementation.
- */
-
 /**
  * How a "current" valid-time read instant is emitted into compiled SQL:
  *
@@ -3855,8 +3869,10 @@ type StoreRuntime<G extends GraphDef> = Readonly<{
     sealedQuery: (coordinate: ReadCoordinate) => InitialQueryBuilder<G, "sealed">;
     recordedNodeGetById: <N extends NodeType>(kind: string, id: NodeId<N>, coordinate: ReadCoordinate) => Promise<Node<N> | undefined>;
     recordedNodeGetByIds: <N extends NodeType>(kind: string, ids: readonly NodeId<N>[], coordinate: ReadCoordinate) => Promise<readonly (Node<N> | undefined)[]>;
+    recordedNodeScan: <N extends NodeType>(kind: string, coordinate: ReadCoordinate, options?: RecordedScanOptions) => Promise<RecordedScanPage<Node<N>>>;
     recordedEdgeGetById: <E extends AnyEdgeType>(kind: string, id: EdgeId<E>, coordinate: ReadCoordinate) => Promise<Edge<E> | undefined>;
     recordedEdgeGetByIds: <E extends AnyEdgeType>(kind: string, ids: readonly EdgeId<E>[], coordinate: ReadCoordinate) => Promise<readonly (Edge<E> | undefined)[]>;
+    recordedEdgeScan: <E extends AnyEdgeType>(kind: string, coordinate: ReadCoordinate, options?: RecordedScanOptions) => Promise<RecordedScanPage<Edge<E>>>;
     subgraphAtCoordinate: <const EK extends EdgeKinds<G>, const NK extends NodeKinds<G> = NodeKinds<G>, const P extends SubgraphProject<G, NK, EK> | undefined = undefined>(rootId: NodeId<AllNodeTypes<G>>, options: InternalSubgraphOptions<G, EK, NK, P>) => Promise<SubgraphResult<G, NK, EK, P>>;
     algorithmsAtCoordinate: (coordinate: ReadCoordinate) => InternalGraphAlgorithms<G>;
 }>;
@@ -4017,14 +4033,13 @@ type AdapterStoreTransactions<G extends GraphDef, TNativeTransaction> = Readonly
     withRecordedTransaction: <T>(externalTransaction: TNativeTransaction, fn: (tx: MeasurableAdapterTransactionContext<G, TNativeTransaction>) => Promise<T>) => Promise<TransactionOutcome<T>>;
 }>;
 type AdapterHistoryTransactionContext<G extends GraphDef, TNativeTransaction> = Omit<AdapterTransactionContext<G, TNativeTransaction>, "sql" | "sqlAvailability"> & Readonly<{
-    sql?: never;
     sqlAvailability: "history";
 }>;
 /**
  * The {@link AdapterHistoryTransactionContext} handed to a `withRecordedTransaction`
  * callback, extended with {@link ScopedMeasure}. Its `measure` scopes to a child
  * {@link MeasurableAdapterHistoryTransactionContext} (so nested scopes keep the
- * history-safe `sql?: never` / backend typing). Assignable to
+ * history-safe absent-`sql` / backend typing). Assignable to
  * {@link MeasurableTransactionContext} (and hence to {@link TransactionContext}),
  * so a projector helper typed against either still accepts it.
  */
@@ -4373,19 +4388,19 @@ declare class StoreView<G extends GraphDef> extends CoordinatePinnedView<G> {
 /**
  * A narrow recorded-time read lens. It preserves the valid-time coordinate
  * carried by the source view and adds a recorded/system-time pin. Collection
- * reads are intentionally limited to point reconstruction; broad collection
+ * reads expose point reconstruction and bounded scans; broad collection
  * predicates, endpoint reads, search, and further coordinate changes are absent
  * from the typed surface and refused by the runtime proxies for JS callers.
  */
 declare class RecordedStoreView<G extends GraphDef> extends CoordinatePinnedView<G> {
     #private;
     constructor(store: Store<G>, coordinate: ReadCoordinate);
-    /** The recorded/system-time timestamp this view reconstructs. */
-    get asOfRecorded(): string;
-    /** Recorded-time node point-read collections. */
+    /** The recorded/system-time anchor this view reconstructs. */
+    get asOfRecorded(): RecordedInstant;
+    /** Recorded-time node reconstructing-read collections. */
     get nodes(): RecordedStoreViewNodeCollections<G>;
-    /** Recorded-time edge point-read collections. */
+    /** Recorded-time edge reconstructing-read collections. */
     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 RecursiveTraversalOptions 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, RecordedStoreView as aW, type RecordedStoreViewEdgeCollection as aX, type RecordedStoreViewEdgeCollections as aY, type RecordedStoreViewNodeCollection as aZ, type RecordedStoreViewNodeCollections 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, createStoreWithSchema as b$, type ReembedFunction as b0, type ReembedVectorFieldOptions as b1, type ReembedVectorFieldResult as b2, type SchemaIntrospection as b3, type ScopedMeasure as b4, type SearchScopeOptions as b5, type SelectContext as b6, type SelectableEdge as b7, type SelectableNode as b8, type ShortestPathOptions as b9, type SubgraphNodeResult as bA, type SubgraphOptions as bB, type SubgraphResult as bC, type SubsetEdge as bD, type SubsetNode as bE, type TemporalAlgorithmOptions as bF, type TransactionContext as bG, type TransactionOutcome as bH, type TransactionReceipt as bI, type TraversalDirection as bJ, type TypedEdgeCollection as bK, type TypedRecordedStoreViewEdgeCollection as bL, type TypedStoreViewEdgeCollection as bM, UnionableQuery as bN, type UniqueIntrospection as bO, type UpdateEdgeInput as bP, type UpdateNodeInput as bQ, type VectorSearchHit as bR, type VectorSearchOptions as bS, type WeaklyConnectedComponentMembership as bT, type WeaklyConnectedComponentsOptions as bU, type WeightedShortestPathOptions as bV, type WeightedShortestPathResult as bW, createAdapterStore as bX, createAdapterStoreWithSchema as bY, createQueryBuilder as bZ, createStore as b_, type ShortestPathResult as ba, type SqlAvailability as bb, type StoreHooks as bc, type StoreProjection as bd, type StoreRef as be, StoreSearch as bf, StoreView as bg, type StoreViewCanReachOptions as bh, type StoreViewCoordinate as bi, type StoreViewDegreeOptions as bj, type StoreViewEdgeCollection as bk, type StoreViewEdgeCollections as bl, type StoreViewGraphAlgorithms as bm, type StoreViewLabelPropagationOptions as bn, type StoreViewNeighborsOptions as bo, type StoreViewNodeCollection as bp, type StoreViewNodeCollections as bq, type StoreViewPageRankOptions as br, type StoreViewPersonalizedPageRankOptions as bs, type StoreViewReachableOptions as bt, type StoreViewShortestPathOptions as bu, type StoreViewSubgraphOptions as bv, type StoreViewWeaklyConnectedComponentsOptions as bw, type StoreViewWeightedShortestPathOptions as bx, type StreamOptions as by, type SubgraphEdgeResult as bz, type RecordedReadStore as c, createVerifiedAdapterStore as c0, createVerifiedStore as c1, defineSubgraphProject as c2, exists as c3, fieldRef as c4, inSubquery as c5, isParameterRef as c6, notExists as c7, notInSubquery as c8, param as c9, 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 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 };

package/dist/temporal-CyFsSPe8.d.ts

@@ -0,0 +1,73 @@
+import { T as TemporalMode } from './extension-types-BLEVH4SG.js';
+
+declare const RECORDED_INSTANT_BRAND: unique symbol;
+/**
+ * A versioned recorded-time anchor containing a fixed-width logical revision
+ * and a canonical UTC physical timestamp:
+ * `r1:0000000000000001:YYYY-MM-DDTHH:mm:ss.sssZ`.
+ *
+ * Logical revisions are strictly monotonic per graph and make every commit
+ * addressable even when many commits share one wall-clock millisecond. The
+ * timestamp is a non-decreasing physical wall-time high-water mark used by
+ * diagonal valid-time reads. Same-millisecond commits repeat it; backward clock
+ * corrections hold it at the previous value until wall time catches up. The
+ * string is canonical and lexicographically ordered by revision, so it can
+ * round-trip through plain string checkpoint columns without a custom
+ * serializer.
+ */
+type RecordedInstant = string & {
+    readonly [RECORDED_INSTANT_BRAND]: "RecordedInstant";
+};
+/**
+ * Returns the canonical UTC wall-time component of a recorded anchor.
+ *
+ * The value is non-decreasing per graph, but it is not the commit-order key;
+ * use the complete {@link RecordedInstant} when ordering or replaying commits.
+ */
+declare function recordedInstantWallTime(instant: RecordedInstant): string;
+/** Returns the strict per-graph logical revision carried by an anchor. */
+declare function recordedInstantRevision(instant: RecordedInstant): number;
+/**
+ * Compares two recorded anchors by logical revision.
+ *
+ * Revisions are local to a graph, so only compare anchors produced by the same
+ * graph. The physical wall-time component deliberately does not participate.
+ */
+declare function compareRecordedInstants(left: RecordedInstant, right: RecordedInstant): -1 | 0 | 1;
+/**
+ * Brands a canonical versioned anchor string as a {@link RecordedInstant}.
+ *
+ * The escape hatch for an instant that round-trips through untyped storage:
+ * captured from {@link Store.recordedNow}, persisted as a plain string, read
+ * back, and replayed into `asOfRecorded`. Validates the canonical form eagerly —
+ * the same check `asOfRecorded` applies — so a malformed value fails here, at the
+ * brand site, rather than deeper in a read. Does *not* assert the instant is a
+ * real captured commit; it only guarantees the value is well-formed enough to
+ * compare correctly against the recorded relations.
+ *
+ * @throws {ValidationError} when `value` is not a canonical versioned anchor.
+ */
+declare function asRecordedInstant(value: string): RecordedInstant;
+/**
+ * The single opaque temporal coordinate every pinned read is resolved
+ * against. It carries the valid-time axis plus an optional recorded/system-time
+ * axis, so every surface can inject one coordinate object instead of threading
+ * each temporal dimension separately.
+ */
+type ReadCoordinate = Readonly<{
+    /**
+     * The valid-time axis: a resolved temporal mode and (only for `"asOf"`) the
+     * instant it is pinned to.
+     */
+    valid: Readonly<{
+        mode: TemporalMode;
+        /** Defined only when `mode` is `"asOf"`. */
+        asOf?: string;
+    }>;
+    /** The recorded/system-time axis. Defined only for recorded-pinned views. */
+    recorded?: Readonly<{
+        asOf: RecordedInstant;
+    }>;
+}>;
+
+export { type RecordedInstant as R, asRecordedInstant as a, recordedInstantWallTime as b, compareRecordedInstants as c, type ReadCoordinate as d, recordedInstantRevision as r };

package/dist/temporal-Dn_JADWY.d.cts

@@ -0,0 +1,73 @@
+import { T as TemporalMode } from './extension-types-BLEVH4SG.cjs';
+
+declare const RECORDED_INSTANT_BRAND: unique symbol;
+/**
+ * A versioned recorded-time anchor containing a fixed-width logical revision
+ * and a canonical UTC physical timestamp:
+ * `r1:0000000000000001:YYYY-MM-DDTHH:mm:ss.sssZ`.
+ *
+ * Logical revisions are strictly monotonic per graph and make every commit
+ * addressable even when many commits share one wall-clock millisecond. The
+ * timestamp is a non-decreasing physical wall-time high-water mark used by
+ * diagonal valid-time reads. Same-millisecond commits repeat it; backward clock
+ * corrections hold it at the previous value until wall time catches up. The
+ * string is canonical and lexicographically ordered by revision, so it can
+ * round-trip through plain string checkpoint columns without a custom
+ * serializer.
+ */
+type RecordedInstant = string & {
+    readonly [RECORDED_INSTANT_BRAND]: "RecordedInstant";
+};
+/**
+ * Returns the canonical UTC wall-time component of a recorded anchor.
+ *
+ * The value is non-decreasing per graph, but it is not the commit-order key;
+ * use the complete {@link RecordedInstant} when ordering or replaying commits.
+ */
+declare function recordedInstantWallTime(instant: RecordedInstant): string;
+/** Returns the strict per-graph logical revision carried by an anchor. */
+declare function recordedInstantRevision(instant: RecordedInstant): number;
+/**
+ * Compares two recorded anchors by logical revision.
+ *
+ * Revisions are local to a graph, so only compare anchors produced by the same
+ * graph. The physical wall-time component deliberately does not participate.
+ */
+declare function compareRecordedInstants(left: RecordedInstant, right: RecordedInstant): -1 | 0 | 1;
+/**
+ * Brands a canonical versioned anchor string as a {@link RecordedInstant}.
+ *
+ * The escape hatch for an instant that round-trips through untyped storage:
+ * captured from {@link Store.recordedNow}, persisted as a plain string, read
+ * back, and replayed into `asOfRecorded`. Validates the canonical form eagerly —
+ * the same check `asOfRecorded` applies — so a malformed value fails here, at the
+ * brand site, rather than deeper in a read. Does *not* assert the instant is a
+ * real captured commit; it only guarantees the value is well-formed enough to
+ * compare correctly against the recorded relations.
+ *
+ * @throws {ValidationError} when `value` is not a canonical versioned anchor.
+ */
+declare function asRecordedInstant(value: string): RecordedInstant;
+/**
+ * The single opaque temporal coordinate every pinned read is resolved
+ * against. It carries the valid-time axis plus an optional recorded/system-time
+ * axis, so every surface can inject one coordinate object instead of threading
+ * each temporal dimension separately.
+ */
+type ReadCoordinate = Readonly<{
+    /**
+     * The valid-time axis: a resolved temporal mode and (only for `"asOf"`) the
+     * instant it is pinned to.
+     */
+    valid: Readonly<{
+        mode: TemporalMode;
+        /** Defined only when `mode` is `"asOf"`. */
+        asOf?: string;
+    }>;
+    /** The recorded/system-time axis. Defined only for recorded-pinned views. */
+    recorded?: Readonly<{
+        asOf: RecordedInstant;
+    }>;
+}>;
+
+export { type RecordedInstant as R, asRecordedInstant as a, recordedInstantWallTime as b, compareRecordedInstants as c, type ReadCoordinate as d, recordedInstantRevision as r };

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

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

package/dist/{types-COq3-vMC.d.cts → types-CqSfMRW3.d.cts}

@@ -1,5 +1,5 @@
 import { K as KindEntity } from './extension-types-BLEVH4SG.cjs';
-import { J as JsonPointer } from './index-CrFL_ENI.cjs';
+import { J as JsonPointer } from './types-C5pZeKTl.cjs';
 
 /**
  * QueryProfiler types.

package/dist/{where-C92TXCzT.d.cts → where-C3-HRgUq.d.cts}

@@ -1,5 +1,5 @@
 import { A as AnyEdgeType, a as NodeType } from './extension-types-BLEVH4SG.cjs';
-import { a as EdgeIndexConfig, E as EdgeIndexDeclaration, i as NodeIndexConfig, N as NodeIndexDeclaration, f as IndexWhereExpression } from './index-CrFL_ENI.cjs';
+import { a as EdgeIndexConfig, E as EdgeIndexDeclaration, i as NodeIndexConfig, N as NodeIndexDeclaration, f as IndexWhereExpression } from './types-C5pZeKTl.cjs';
 
 /** The TypeGraph relations that carry system indexes. */
 type SystemIndexTable = "nodes" | "edges" | "recordedNodes" | "recordedEdges";

package/dist/{where-BdE_cYtx.d.ts → where-sQL4u5h-.d.ts}

@@ -1,5 +1,5 @@
 import { A as AnyEdgeType, a as NodeType } from './extension-types-BLEVH4SG.js';
-import { a as EdgeIndexConfig, E as EdgeIndexDeclaration, i as NodeIndexConfig, N as NodeIndexDeclaration, f as IndexWhereExpression } from './index-Bq7vSPHy.js';
+import { a as EdgeIndexConfig, E as EdgeIndexDeclaration, i as NodeIndexConfig, N as NodeIndexDeclaration, f as IndexWhereExpression } from './types-D8szWDUo.js';
 
 /** The TypeGraph relations that carry system indexes. */
 type SystemIndexTable = "nodes" | "edges" | "recordedNodes" | "recordedEdges";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicia-ai/typegraph",
-  "version": "0.38.0",
+  "version": "0.40.0",
   "description": "TypeScript-first embedded knowledge graph library with ontological reasoning",
   "type": "module",
   "main": "./dist/index.cjs",