@nicia-ai/typegraph 0.46.1 → 0.47.0

package/dist/{types-HkveCCx0.d.ts → types-DKkMJZjR.d.cts}

@@ -2470,6 +2470,13 @@ type BackendCapabilities = Readonly<{
     transactions: boolean;
     /** Whether the backend supports SQL window functions such as ROW_NUMBER() */
     windowFunctions: boolean;
+    /**
+     * Whether `updateNode` / `updateEdge` honor `clearValidTo: true` by storing
+     * SQL NULL in `valid_to`. Absent is `false`: custom backends must opt in so
+     * the store refuses every explicit clear-bearing call before lookup,
+     * coalescing, or write instead of making support depend on row state.
+     */
+    clearValidTo?: boolean;
     /**
      * Whether the backend's `execute()` supports `UPDATE … RETURNING`. Absent or
      * `true` means supported (every engine TypeGraph ships — SQLite ≥ 3.35,
@@ -2624,8 +2631,18 @@ type InsertNodeParams = Readonly<{
     validTo?: string;
 }>;
 /**
- * Parameters for updating a node.
+ * A backend validity-end mutation. Omission preserves the stored end,
+ * `validTo` sets it, and `clearValidTo` reopens the window. The union keeps the
+ * two write actions mutually exclusive without exposing SQL `NULL`.
  */
+type BackendValidityEndMutation = Readonly<{
+    validTo?: string;
+    clearValidTo?: never;
+}> | Readonly<{
+    validTo?: never;
+    clearValidTo: true;
+}>;
+/** Parameters for updating a node. */
 type UpdateNodeParams = Readonly<{
     graphId: string;
     kind: string;
@@ -2633,7 +2650,6 @@ type UpdateNodeParams = Readonly<{
     props: Readonly<Record<string, unknown>>;
     /** Applied when resurrecting a tombstone; omitted means the resurrection instant. */
     validFrom?: string | null;
-    validTo?: string;
     /**
      * The effective `valid_from` this write ASSERTS the target row already
      * carries, stated only by a caller whose decision DEPENDED on it.
@@ -2661,7 +2677,7 @@ type UpdateNodeParams = Readonly<{
     incrementVersion?: boolean;
     /** If true, clears deleted_at (un-deletes the node). Used by upsert. */
     clearDeleted?: boolean;
-}>;
+}> & BackendValidityEndMutation;
 /**
  * Parameters for updating a set of live nodes selected by a compiled
  * TypeGraph query.
@@ -2793,7 +2809,6 @@ type UpdateEdgeParams = Readonly<{
      * Omitting `validFrom` on a resurrection leaves the stored window in place.
      */
     validFrom?: string | null;
-    validTo?: string;
     /**
      * The effective `valid_from` this write asserts the target row already
      * carries. Same three states, same NULL-safety, and the same MUST-apply
@@ -2806,8 +2821,13 @@ type UpdateEdgeParams = Readonly<{
      * it must be fenced against it having changed.
      */
     expectedValidFrom?: string | null;
+    /**
+     * The `valid_to` state a constraint decision read. NULL-safe and MUST apply
+     * when present, like `expectedValidFrom`; used to fence ended-to-open edges.
+     */
+    expectedValidTo?: string | null;
     clearDeleted?: boolean;
-}>;
+}> & BackendValidityEndMutation;
 /**
  * Parameters for deleting an edge (soft delete).
  */
@@ -3330,7 +3350,7 @@ type RecordContributionMaterializationParams = Readonly<{
  *   `DROP`, a schema-scoped restore that missed the contribution
  *   tables). The state {@link GraphBackend.verifyContributions} exists
  *   to surface: nothing on the open path probes the catalog, so this
- *   database opens clean and fails at the first read of the slot.
+ *   database opens clean and fails at the first dependent read or write.
  * - `missing-marker` — the physical table exists but no marker attests
  *   it as initialized (no row, no recorded success, or a recorded
  *   failure). Reads and writes are refused with
@@ -3453,9 +3473,10 @@ type ContributionProbeContribution = "fulltext" | "vector";
  *   its durable marker and present in the catalog. Not a promise about
  *   future coherence: a write that lands after the probe returns is
  *   outside what any assessment can cover.
- * - `degraded` — at least one contribution is unusable. Queries against
- *   this projection will be refused (`StoreNotInitializedError`) or will
- *   read incomplete storage.
+ * - `degraded` — at least one contribution is unusable. Dependent operations
+ *   may be refused with a typed contribution error, fail at the engine boundary
+ *   when compiled SQL directly references missing storage, or observe
+ *   incomplete storage.
  *   {@link ContributionProbeEntry.detail} says which and why.
  * - `building` — **reserved.** No shipped path publishes it. Recording
  *   an in-flight marker would need a fifth
@@ -3901,6 +3922,12 @@ type GraphBackend = Readonly<{
      * is well-behaved on Postgres.
      */
     ensureIndexMaterializationsTable?: (this: void) => Promise<void>;
+    /**
+     * Install the PostgreSQL `pg_trgm` extension under a database-global
+     * concurrency fence. Relational trigram index materialization calls this
+     * before emitting its index DDL; non-PostgreSQL backends omit it.
+     */
+    ensureTrigramExtension?: (this: void) => Promise<void>;
     /**
      * Idempotently ensure ONLY the `typegraph_revision_origins` table exists.
      *
@@ -4152,8 +4179,8 @@ type GraphBackend = Readonly<{
      * per-instance signature cache and then on the marker row alone, which
      * is the right default for a hot path but leaves a database whose
      * contribution tables were dropped out of band opening clean and
-     * failing at the first read. This method is the explicit, operator-
-     * invoked catalog probe that fills that gap: it issues one uncached
+     * failing at the first dependent read or write. This method is the explicit,
+     * operator-invoked catalog probe that fills that gap: it issues one uncached
      * existence query per distinct physical table and performs ZERO DDL
      * and ZERO writes, so it is safe under a least-privilege runtime role.
      *
@@ -5601,4 +5628,4 @@ type RelationalIndexDeclaration = NodeIndexDeclaration | EdgeIndexDeclaration;
 type IndexDeclaration = RelationalIndexDeclaration | VectorIndexDeclaration;
 type SystemColumnName = "graph_id" | "kind" | "id" | "from_kind" | "from_id" | "to_kind" | "to_id" | "deleted_at" | "valid_from" | "valid_to" | "created_at" | "updated_at" | "version";
 
-export { type EdgeId as $, type AdapterBackend as A, type BackendCapabilities as B, type ContributionDiagnostic as C, type SerializedNodeDef as D, type EdgeIndexDeclaration as E, type FulltextStrategy as F, type GraphIdentityConfig as G, type SerializedEdgeDef as H, type IndexDeclaration as I, type JsonPointer as J, type KindEntity as K, type IndexEntity as L, type SerializedMetaEdge as M, type NodeIndexDeclaration as N, type SerializedOntologyRelation as O, type SerializedClosures as P, type QueryAst as Q, type RelationalIndexDeclaration as R, type SqlDialect as S, type TemporalMode as T, type SchemaHash as U, type VectorStrategy as V, type NullCheckOp as W, type JsonSchema as X, type SerializedOntology as Y, type SerializedUniqueConstraint as Z, type NodeId as _, type ContributionDiagnosticState as a, type GetEdgeType as a$, type JsonValue as a0, type NodeKinds as a1, type GetNodeType as a2, type KindAnnotations as a3, type MetaEdge as a4, type EdgeType as a5, type DeleteBehavior as a6, type GraphExtensionVersion as a7, type ExtensionNodeDef as a8, type ExtensionEdgeDef as a9, type ContributionMaterializationBackend as aA, type ContributionProbeContribution as aB, type ContributionProbeEntry as aC, type ContributionProbeResult as aD, type ContributionProbeState as aE, type ContributionRebuildResult as aF, type ContributionRebuildScope as aG, type ContributionRepopulationStats as aH, DEFAULT_SQL_SCHEMA as aI, type DeleteFulltextBatchParams as aJ, type EdgeEntityReadBackend as aK, type EdgeEntityWriteBackend as aL, type EdgeKinds as aM, type EdgeProps as aN, type EdgeRegistration as aO, type EdgeTypeWithEndpoints as aP, type EndpointExistence as aQ, type ExternalRecordedReadSource as aR, type FilteredApproximateSearch as aS, type FilteredApproximateSearchMode as aT, type FindEdgesByHeterogeneousEndpointSetParams as aU, type FulltextBatchRow as aV, type FulltextCapabilities as aW, type FulltextOperationBackend as aX, type FulltextQueryMode as aY, type FulltextSearchParams as aZ, type FulltextSearchResult as a_, type ExtensionOntologyRelation as aa, type ExtensionIndex as ab, type AggregateExpr as ac, type FieldRef as ad, type ComparisonOp as ae, type AggregateComparisonPredicate as af, type TraversalDirection as ag, type OntologyRelation as ah, type InferenceType as ai, type AdapterBackendTransactions as aj, type AllEdgeTypes as ak, type AllNodeTypes as al, type BackendIdentity as am, type BackendLifecycle as an, type BackendMaintenance as ao, type BackendTransactions as ap, CURRENT_GRAPH_EXTENSION_VERSION as aq, type Cardinality as ar, type Collation as as, type CommitSchemaVersionExpected as at, type CommitSchemaVersionIfKindsEmptyResult as au, type CommitSchemaVersionParams as av, type CompiledRowsSql as aw, type CompiledSelectSql as ax, type CompiledStatementSql as ay, type ContributionCapabilities as az, type ContributionRepairEntry as b, type UpdateNodeSetParams as b$, type GraphAnalyticsCapabilities as b0, type GraphDefaults as b1, type GraphEntityReadBackend as b2, type GraphEntityWriteBackend as b3, type GraphExtension as b4, type GraphLifecycleBackend as b5, type HardDeleteUniquesByNodeIdsParams as b6, type HybridFusionOptions as b7, type IndexMaterializationBackend as b8, type IntentSql as b9, type RowProps as bA, type SchemaCommitBackend as bB, type SchemaKindEmptinessProbe as bC, type SchemaReadBackend as bD, type SchemaWriteFenceBackend as bE, type SetActiveVersionParams as bF, type SortDirection as bG, type SqlChunk as bH, type SqlFragment as bI, type SqlIdentifierChunk as bJ, type SqlIntent as bK, type SqlParameterChunk as bL, type SqlPlaceholderChunk as bM, type SqlTableNames as bN, type SqlTag as bO, type SqlTextChunk as bP, type StrategyTableContribution as bQ, type TableContribution as bR, type TransactionBackend as bS, type TransactionOptions as bT, type TransactionReadBackend as bU, type TraversalExpansion as bV, type TrustedImportOptions as bW, type TrustedImportSession as bX, type UniqueConstraint as bY, type UniqueConstraintBackend as bZ, type UniquenessScope as b_, type JsonPointerFor as ba, type JsonPointerInput as bb, type JsonPointerSegment as bc, type JsonPointerSegments as bd, type JsonPointerSegmentsFor as be, LEGACY_GRAPH_EXTENSION_VERSION as bf, type LockSchemaVersionForWriteParams as bg, MAX_JSON_POINTER_DEPTH as bh, type MetaEdgeProperties as bi, type NodeEntityReadBackend as bj, type NodeEntityWriteBackend as bk, type NodeProps as bl, type NodeRegistration as bm, type OrderSpec as bn, type ParameterRef as bo, Placeholder as bp, type PopulatedSchemaKind as bq, type QueryExecutionBackend as br, type RawQueryExecutionBackend as bs, type RawStatementExecutionBackend as bt, type RecordedRelationOptions as bu, type RemovalMaterializationBackend as bv, type RenderedSql as bw, type ResolveJsonPointer as bx, type ResolveJsonPointerSegments as by, type ResolvedSqlTableNames as bz, type ContributionRepairResult as c, D1_MAX_BIND_PARAMETERS as c$, type UpdateNodeSetResult as c0, type UpsertFulltextBatchParams as c1, type VectorCapabilities as c2, type VectorOperationBackend as c3, type VectorSearchFrontierTuning as c4, asEdgeId as c5, asNodeId as c6, buildVectorCapabilities as c7, createSqlSchema as c8, defineGraph as c9, type NodePredicate as cA, type ProjectedField as cB, type AggregateOrderSpec as cC, type GroupBySpec as cD, type RecursiveCyclePolicy as cE, type VectorSlotMap as cF, type RecordedReadBinding as cG, type SelectiveField as cH, type ComposableQuery as cI, type SetOperationType as cJ, type SetOperation as cK, type NodeRow as cL, type EdgeRow as cM, type VectorMetric as cN, ALL_FULLTEXT_MODES as cO, ALL_META_EDGE_NAMES as cP, BASE_CONTRIBUTION_OWNER as cQ, type CheckUniqueBatchParams as cR, type CheckUniqueParams as cS, type ClaimIndexMaterializationParams as cT, type CompiledTemporaryStatementSql as cU, type ContributionMaterializationIdentity as cV, type ContributionMaterializationRow as cW, type CountEdgesByKindParams as cX, type CountEdgesFromParams as cY, type CountNodesByKindParams as cZ, type CreateVectorIndexParams as c_, fts5Strategy as ca, getEdgeKinds as cb, getNodeKinds as cc, isEdgeType as cd, isEdgeTypeWithEndpoints as ce, isGraphDef as cf, isMetaEdge as cg, isNodeType as ch, isSqlFragment as ci, joinJsonPointers as cj, jsonPointer as ck, normalizeJsonPointer as cl, parseJsonPointer as cm, recordedRelation as cn, renderPostgres as co, renderSql as cp, renderSqlInline as cq, renderSqlite as cr, rowPropsToJsonText as cs, rowPropsToObject as ct, sql as cu, tsvectorStrategy as cv, type ValueType as cw, type PredicateExpression as cx, type VectorMetricType as cy, type Traversal as cz, type GraphDef as d, type ReleaseIndexMaterializationClaimParams as d$, DURABLE_OBJECT_MAX_BIND_PARAMETERS as d0, type DeleteEdgeParams as d1, type DeleteEdgesBatchParams as d2, type DeleteEmbeddingParams as d3, type DeleteFulltextParams as d4, type DeleteNodeParams as d5, type DeleteUniqueParams as d6, type DialectAdapter as d7, type DialectCapabilities as d8, type DialectRecursiveQueryStrategy as d9, type FindNodesByKindParams as dA, type GraphReadBackend as dB, type HardDeleteEdgeParams as dC, type HardDeleteNodeParams as dD, type HybridSearchParams as dE, type HybridSearchRow as dF, type IdentityTableNames as dG, type InListParameterOptions as dH, type IndexDeclarationBase as dI, type IndexMaterializationRow as dJ, type IndexWhereLiteral as dK, type IndexWhereOp as dL, type IndexWhereOperand as dM, type InsertEdgeParams as dN, type InsertNodeParams as dO, type InsertSchemaParams as dP, type InsertUniqueParams as dQ, type KindRemovalRow as dR, type LiveNodeRow as dS, MODERN_SQLITE_MAX_BIND_PARAMETERS as dT, type MetaEdgeName as dU, POSTGRES_CAPABILITIES as dV, POSTGRES_MAX_BIND_PARAMETERS as dW, type RecordContributionMaterializationParams as dX, type RecordIndexMaterializationParams as dY, type RecordKindRemovalParams as dZ, type RelationalIndexMethod as d_, type DialectStandardQueryStrategy as da, type DialectVectorPredicateStrategy as db, type DropVectorIndexParams as dc, type EdgeExistsBetweenParams as dd, type ExtensionArrayItemType as de, type ExtensionArrayProperty as df, type ExtensionBooleanProperty as dg, type ExtensionEdgeIndex as dh, type ExtensionEmbeddingModifier as di, type ExtensionEnumProperty as dj, type ExtensionIndexWhere as dk, type ExtensionNodeIndex as dl, type ExtensionNumberProperty as dm, type ExtensionObjectFieldProperty as dn, type ExtensionObjectProperty as dp, type ExtensionPropertyModifiers as dq, type ExtensionPropertyType as dr, type ExtensionSearchableModifier as ds, type ExtensionStringProperty as dt, type ExtensionUniqueConstraint as du, type ExtensionUniqueWhere as dv, FULLTEXT_CONTRIBUTION_NAME as dw, type FindEdgesByEndpointSetParams as dx, type FindEdgesByKindParams as dy, type FindEdgesConnectedToParams as dz, type EdgeIndexConfig as e, SQLITE_CAPABILITIES as e0, SQLITE_MAX_BIND_PARAMETERS as e1, type SchemaCommitPreflightBackend as e2, type SqlCompilationBackend as e3, type TombstonedNodeRow as e4, type UniqueRow as e5, type UpdateEdgeParams as e6, type UpdateNodeParams as e7, type UpsertEmbeddingBatchParams as e8, type UpsertEmbeddingBatchRow as e9, type UpsertEmbeddingParams as ea, type UpsertFulltextParams as eb, VECTOR_CONTRIBUTION_PREFIX as ec, type VectorIndexType as ed, type VectorSearchParams as ee, type VectorSearchResult as ef, assertFiniteEmbedding as eg, assertVectorMinScore as eh, assertVectorSearchLimit as ei, buildFulltextCapabilities as ej, isLiveNodeRow as ek, isSqlPlaceholder as el, isTombstonedNodeRow as em, normalizeGraphAnalyticsCapabilities as en, quoteIdentifier as eo, shortHash as ep, vectorMinScoreCondition as eq, vectorPhysicalName as er, vectorScoreExpression as es, GRAPH_EXTENSION_TOP_LEVEL_KEYS as et, type GraphExtensionTopLevelKey as eu, type EdgeIndexDirection as f, type EdgeIndexWhereBuilder as g, type IndexOrigin as h, type IndexScope as i, type IndexWhereExpression as j, type IndexWhereFieldBuilder as k, type IndexWhereInput as l, type NodeIndexConfig as m, type NodeIndexWhereBuilder as n, type SystemColumnName as o, type VectorIndexDeclaration as p, type VectorIndexImplementation as q, type VectorIndexMetric as r, type VectorIndexParams as s, type VectorSlot as t, type NodeType as u, type AnyEdgeType as v, SqlSchema as w, type SchemaVersionRow as x, type GraphBackend as y, type SerializedSchema as z };
+export { type FieldRef as $, type AdapterBackend as A, type BackendCapabilities as B, type ContributionDiagnostic as C, type SerializedNodeDef as D, type EdgeIndexDeclaration as E, type FulltextStrategy as F, type GraphIdentityConfig as G, type SerializedEdgeDef as H, type IndexDeclaration as I, type JsonPointer as J, type KindEntity as K, type IndexEntity as L, type SerializedMetaEdge as M, type NodeIndexDeclaration as N, type SerializedOntologyRelation as O, type SerializedClosures as P, type QueryAst as Q, type RelationalIndexDeclaration as R, type SqlDialect as S, type TemporalMode as T, type SchemaHash as U, type VectorStrategy as V, type NullCheckOp as W, type JsonSchema as X, type SerializedOntology as Y, type SerializedUniqueConstraint as Z, type AggregateExpr as _, type ContributionDiagnosticState as a, type IndexMaterializationBackend as a$, type ComparisonOp as a0, type AggregateComparisonPredicate as a1, type TraversalDirection as a2, type OntologyRelation as a3, type InferenceType as a4, type EdgeType as a5, type AdapterBackendTransactions as a6, type AllEdgeTypes as a7, type AllNodeTypes as a8, type BackendIdentity as a9, type EdgeId as aA, type EdgeKinds as aB, type EdgeProps as aC, type EdgeRegistration as aD, type EdgeTypeWithEndpoints as aE, type EndpointExistence as aF, type ExternalRecordedReadSource as aG, type FilteredApproximateSearch as aH, type FilteredApproximateSearchMode as aI, type FindEdgesByHeterogeneousEndpointSetParams as aJ, type FulltextBatchRow as aK, type FulltextCapabilities as aL, type FulltextOperationBackend as aM, type FulltextQueryMode as aN, type FulltextSearchParams as aO, type FulltextSearchResult as aP, type GetEdgeType as aQ, type GetNodeType as aR, type GraphAnalyticsCapabilities as aS, type GraphDefaults as aT, type GraphEntityReadBackend as aU, type GraphEntityWriteBackend as aV, type GraphExtension as aW, type GraphExtensionVersion as aX, type GraphLifecycleBackend as aY, type HardDeleteUniquesByNodeIdsParams as aZ, type HybridFusionOptions as a_, type BackendLifecycle as aa, type BackendMaintenance as ab, type BackendTransactions as ac, CURRENT_GRAPH_EXTENSION_VERSION as ad, type Cardinality as ae, type Collation as af, type CommitSchemaVersionExpected as ag, type CommitSchemaVersionIfKindsEmptyResult as ah, type CommitSchemaVersionParams as ai, type CompiledRowsSql as aj, type CompiledSelectSql as ak, type CompiledStatementSql as al, type ContributionCapabilities as am, type ContributionMaterializationBackend as an, type ContributionProbeContribution as ao, type ContributionProbeEntry as ap, type ContributionProbeResult as aq, type ContributionProbeState as ar, type ContributionRebuildResult as as, type ContributionRebuildScope as at, type ContributionRepopulationStats as au, DEFAULT_SQL_SCHEMA as av, type DeleteBehavior as aw, type DeleteFulltextBatchParams as ax, type EdgeEntityReadBackend as ay, type EdgeEntityWriteBackend as az, type ContributionRepairEntry as b, type VectorOperationBackend as b$, type IntentSql as b0, type JsonPointerFor as b1, type JsonPointerInput as b2, type JsonPointerSegment as b3, type JsonPointerSegments as b4, type JsonPointerSegmentsFor as b5, type JsonValue as b6, type KindAnnotations as b7, LEGACY_GRAPH_EXTENSION_VERSION as b8, type LockSchemaVersionForWriteParams as b9, type SchemaWriteFenceBackend as bA, type SetActiveVersionParams as bB, type SortDirection as bC, type SqlChunk as bD, type SqlFragment as bE, type SqlIdentifierChunk as bF, type SqlIntent as bG, type SqlParameterChunk as bH, type SqlPlaceholderChunk as bI, type SqlTableNames as bJ, type SqlTag as bK, type SqlTextChunk as bL, type StrategyTableContribution as bM, type TableContribution as bN, type TransactionBackend as bO, type TransactionOptions as bP, type TransactionReadBackend as bQ, type TraversalExpansion as bR, type TrustedImportOptions as bS, type TrustedImportSession as bT, type UniqueConstraint as bU, type UniqueConstraintBackend as bV, type UniquenessScope as bW, type UpdateNodeSetParams as bX, type UpdateNodeSetResult as bY, type UpsertFulltextBatchParams as bZ, type VectorCapabilities as b_, MAX_JSON_POINTER_DEPTH as ba, type MetaEdge as bb, type MetaEdgeProperties as bc, type NodeEntityReadBackend as bd, type NodeEntityWriteBackend as be, type NodeId as bf, type NodeKinds as bg, type NodeProps as bh, type NodeRegistration as bi, type OrderSpec as bj, type ParameterRef as bk, Placeholder as bl, type PopulatedSchemaKind as bm, type QueryExecutionBackend as bn, type RawQueryExecutionBackend as bo, type RawStatementExecutionBackend as bp, type RecordedRelationOptions as bq, type RemovalMaterializationBackend as br, type RenderedSql as bs, type ResolveJsonPointer as bt, type ResolveJsonPointerSegments as bu, type ResolvedSqlTableNames as bv, type RowProps as bw, type SchemaCommitBackend as bx, type SchemaKindEmptinessProbe as by, type SchemaReadBackend as bz, type ContributionRepairResult as c, type CreateVectorIndexParams as c$, type VectorSearchFrontierTuning as c0, asEdgeId as c1, asNodeId as c2, buildVectorCapabilities as c3, createSqlSchema as c4, defineGraph as c5, fts5Strategy as c6, getEdgeKinds as c7, getNodeKinds as c8, isEdgeType as c9, type NodePredicate as cA, type ProjectedField as cB, type AggregateOrderSpec as cC, type GroupBySpec as cD, type RecursiveCyclePolicy as cE, type VectorSlotMap as cF, type RecordedReadBinding as cG, type SelectiveField as cH, type ComposableQuery as cI, type SetOperationType as cJ, type SetOperation as cK, type NodeRow as cL, type EdgeRow as cM, type BackendValidityEndMutation as cN, type VectorMetric as cO, ALL_FULLTEXT_MODES as cP, ALL_META_EDGE_NAMES as cQ, BASE_CONTRIBUTION_OWNER as cR, type CheckUniqueBatchParams as cS, type CheckUniqueParams as cT, type ClaimIndexMaterializationParams as cU, type CompiledTemporaryStatementSql as cV, type ContributionMaterializationIdentity as cW, type ContributionMaterializationRow as cX, type CountEdgesByKindParams as cY, type CountEdgesFromParams as cZ, type CountNodesByKindParams as c_, isEdgeTypeWithEndpoints as ca, isGraphDef as cb, isMetaEdge as cc, isNodeType as cd, isSqlFragment as ce, joinJsonPointers as cf, jsonPointer as cg, normalizeJsonPointer as ch, parseJsonPointer as ci, recordedRelation as cj, renderPostgres as ck, renderSql as cl, renderSqlInline as cm, renderSqlite as cn, rowPropsToJsonText as co, rowPropsToObject as cp, sql as cq, tsvectorStrategy as cr, type ExtensionNodeDef as cs, type ExtensionEdgeDef as ct, type ExtensionOntologyRelation as cu, type ExtensionIndex as cv, type ValueType as cw, type PredicateExpression as cx, type VectorMetricType as cy, type Traversal as cz, type GraphDef as d, type RelationalIndexMethod as d$, D1_MAX_BIND_PARAMETERS as d0, DURABLE_OBJECT_MAX_BIND_PARAMETERS as d1, type DeleteEdgeParams as d2, type DeleteEdgesBatchParams as d3, type DeleteEmbeddingParams as d4, type DeleteFulltextParams as d5, type DeleteNodeParams as d6, type DeleteUniqueParams as d7, type DialectAdapter as d8, type DialectCapabilities as d9, type FindEdgesConnectedToParams as dA, type FindNodesByKindParams as dB, type GraphReadBackend as dC, type HardDeleteEdgeParams as dD, type HardDeleteNodeParams as dE, type HybridSearchParams as dF, type HybridSearchRow as dG, type IdentityTableNames as dH, type InListParameterOptions as dI, type IndexDeclarationBase as dJ, type IndexMaterializationRow as dK, type IndexWhereLiteral as dL, type IndexWhereOp as dM, type IndexWhereOperand as dN, type InsertEdgeParams as dO, type InsertNodeParams as dP, type InsertSchemaParams as dQ, type InsertUniqueParams as dR, type KindRemovalRow as dS, type LiveNodeRow as dT, MODERN_SQLITE_MAX_BIND_PARAMETERS as dU, type MetaEdgeName as dV, POSTGRES_CAPABILITIES as dW, POSTGRES_MAX_BIND_PARAMETERS as dX, type RecordContributionMaterializationParams as dY, type RecordIndexMaterializationParams as dZ, type RecordKindRemovalParams as d_, type DialectRecursiveQueryStrategy as da, type DialectStandardQueryStrategy as db, type DialectVectorPredicateStrategy as dc, type DropVectorIndexParams as dd, type EdgeExistsBetweenParams as de, type ExtensionArrayItemType as df, type ExtensionArrayProperty as dg, type ExtensionBooleanProperty as dh, type ExtensionEdgeIndex as di, type ExtensionEmbeddingModifier as dj, type ExtensionEnumProperty as dk, type ExtensionIndexWhere as dl, type ExtensionNodeIndex as dm, type ExtensionNumberProperty as dn, type ExtensionObjectFieldProperty as dp, type ExtensionObjectProperty as dq, type ExtensionPropertyModifiers as dr, type ExtensionPropertyType as ds, type ExtensionSearchableModifier as dt, type ExtensionStringProperty as du, type ExtensionUniqueConstraint as dv, type ExtensionUniqueWhere as dw, FULLTEXT_CONTRIBUTION_NAME as dx, type FindEdgesByEndpointSetParams as dy, type FindEdgesByKindParams as dz, type EdgeIndexConfig as e, type ReleaseIndexMaterializationClaimParams as e0, SQLITE_CAPABILITIES as e1, SQLITE_MAX_BIND_PARAMETERS as e2, type SchemaCommitPreflightBackend as e3, type SqlCompilationBackend as e4, type TombstonedNodeRow as e5, type UniqueRow as e6, type UpdateEdgeParams as e7, type UpdateNodeParams as e8, type UpsertEmbeddingBatchParams as e9, type UpsertEmbeddingBatchRow as ea, type UpsertEmbeddingParams as eb, type UpsertFulltextParams as ec, VECTOR_CONTRIBUTION_PREFIX as ed, type VectorIndexType as ee, type VectorSearchParams as ef, type VectorSearchResult as eg, assertFiniteEmbedding as eh, assertVectorMinScore as ei, assertVectorSearchLimit as ej, buildFulltextCapabilities as ek, isLiveNodeRow as el, isSqlPlaceholder as em, isTombstonedNodeRow as en, normalizeGraphAnalyticsCapabilities as eo, quoteIdentifier as ep, shortHash as eq, vectorMinScoreCondition as er, vectorPhysicalName as es, vectorScoreExpression as et, GRAPH_EXTENSION_TOP_LEVEL_KEYS as eu, type GraphExtensionTopLevelKey as ev, type EdgeIndexDirection as f, type EdgeIndexWhereBuilder as g, type IndexOrigin as h, type IndexScope as i, type IndexWhereExpression as j, type IndexWhereFieldBuilder as k, type IndexWhereInput as l, type NodeIndexConfig as m, type NodeIndexWhereBuilder as n, type SystemColumnName as o, type VectorIndexDeclaration as p, type VectorIndexImplementation as q, type VectorIndexMetric as r, type VectorIndexParams as s, type VectorSlot as t, type NodeType as u, type AnyEdgeType as v, SqlSchema as w, type SchemaVersionRow as x, type GraphBackend as y, type SerializedSchema as z };

package/dist/{types-HkveCCx0.d.cts → types-DKkMJZjR.d.ts}

@@ -2470,6 +2470,13 @@ type BackendCapabilities = Readonly<{
     transactions: boolean;
     /** Whether the backend supports SQL window functions such as ROW_NUMBER() */
     windowFunctions: boolean;
+    /**
+     * Whether `updateNode` / `updateEdge` honor `clearValidTo: true` by storing
+     * SQL NULL in `valid_to`. Absent is `false`: custom backends must opt in so
+     * the store refuses every explicit clear-bearing call before lookup,
+     * coalescing, or write instead of making support depend on row state.
+     */
+    clearValidTo?: boolean;
     /**
      * Whether the backend's `execute()` supports `UPDATE … RETURNING`. Absent or
      * `true` means supported (every engine TypeGraph ships — SQLite ≥ 3.35,
@@ -2624,8 +2631,18 @@ type InsertNodeParams = Readonly<{
     validTo?: string;
 }>;
 /**
- * Parameters for updating a node.
+ * A backend validity-end mutation. Omission preserves the stored end,
+ * `validTo` sets it, and `clearValidTo` reopens the window. The union keeps the
+ * two write actions mutually exclusive without exposing SQL `NULL`.
  */
+type BackendValidityEndMutation = Readonly<{
+    validTo?: string;
+    clearValidTo?: never;
+}> | Readonly<{
+    validTo?: never;
+    clearValidTo: true;
+}>;
+/** Parameters for updating a node. */
 type UpdateNodeParams = Readonly<{
     graphId: string;
     kind: string;
@@ -2633,7 +2650,6 @@ type UpdateNodeParams = Readonly<{
     props: Readonly<Record<string, unknown>>;
     /** Applied when resurrecting a tombstone; omitted means the resurrection instant. */
     validFrom?: string | null;
-    validTo?: string;
     /**
      * The effective `valid_from` this write ASSERTS the target row already
      * carries, stated only by a caller whose decision DEPENDED on it.
@@ -2661,7 +2677,7 @@ type UpdateNodeParams = Readonly<{
     incrementVersion?: boolean;
     /** If true, clears deleted_at (un-deletes the node). Used by upsert. */
     clearDeleted?: boolean;
-}>;
+}> & BackendValidityEndMutation;
 /**
  * Parameters for updating a set of live nodes selected by a compiled
  * TypeGraph query.
@@ -2793,7 +2809,6 @@ type UpdateEdgeParams = Readonly<{
      * Omitting `validFrom` on a resurrection leaves the stored window in place.
      */
     validFrom?: string | null;
-    validTo?: string;
     /**
      * The effective `valid_from` this write asserts the target row already
      * carries. Same three states, same NULL-safety, and the same MUST-apply
@@ -2806,8 +2821,13 @@ type UpdateEdgeParams = Readonly<{
      * it must be fenced against it having changed.
      */
     expectedValidFrom?: string | null;
+    /**
+     * The `valid_to` state a constraint decision read. NULL-safe and MUST apply
+     * when present, like `expectedValidFrom`; used to fence ended-to-open edges.
+     */
+    expectedValidTo?: string | null;
     clearDeleted?: boolean;
-}>;
+}> & BackendValidityEndMutation;
 /**
  * Parameters for deleting an edge (soft delete).
  */
@@ -3330,7 +3350,7 @@ type RecordContributionMaterializationParams = Readonly<{
  *   `DROP`, a schema-scoped restore that missed the contribution
  *   tables). The state {@link GraphBackend.verifyContributions} exists
  *   to surface: nothing on the open path probes the catalog, so this
- *   database opens clean and fails at the first read of the slot.
+ *   database opens clean and fails at the first dependent read or write.
  * - `missing-marker` — the physical table exists but no marker attests
  *   it as initialized (no row, no recorded success, or a recorded
  *   failure). Reads and writes are refused with
@@ -3453,9 +3473,10 @@ type ContributionProbeContribution = "fulltext" | "vector";
  *   its durable marker and present in the catalog. Not a promise about
  *   future coherence: a write that lands after the probe returns is
  *   outside what any assessment can cover.
- * - `degraded` — at least one contribution is unusable. Queries against
- *   this projection will be refused (`StoreNotInitializedError`) or will
- *   read incomplete storage.
+ * - `degraded` — at least one contribution is unusable. Dependent operations
+ *   may be refused with a typed contribution error, fail at the engine boundary
+ *   when compiled SQL directly references missing storage, or observe
+ *   incomplete storage.
  *   {@link ContributionProbeEntry.detail} says which and why.
  * - `building` — **reserved.** No shipped path publishes it. Recording
  *   an in-flight marker would need a fifth
@@ -3901,6 +3922,12 @@ type GraphBackend = Readonly<{
      * is well-behaved on Postgres.
      */
     ensureIndexMaterializationsTable?: (this: void) => Promise<void>;
+    /**
+     * Install the PostgreSQL `pg_trgm` extension under a database-global
+     * concurrency fence. Relational trigram index materialization calls this
+     * before emitting its index DDL; non-PostgreSQL backends omit it.
+     */
+    ensureTrigramExtension?: (this: void) => Promise<void>;
     /**
      * Idempotently ensure ONLY the `typegraph_revision_origins` table exists.
      *
@@ -4152,8 +4179,8 @@ type GraphBackend = Readonly<{
      * per-instance signature cache and then on the marker row alone, which
      * is the right default for a hot path but leaves a database whose
      * contribution tables were dropped out of band opening clean and
-     * failing at the first read. This method is the explicit, operator-
-     * invoked catalog probe that fills that gap: it issues one uncached
+     * failing at the first dependent read or write. This method is the explicit,
+     * operator-invoked catalog probe that fills that gap: it issues one uncached
      * existence query per distinct physical table and performs ZERO DDL
      * and ZERO writes, so it is safe under a least-privilege runtime role.
      *
@@ -5601,4 +5628,4 @@ type RelationalIndexDeclaration = NodeIndexDeclaration | EdgeIndexDeclaration;
 type IndexDeclaration = RelationalIndexDeclaration | VectorIndexDeclaration;
 type SystemColumnName = "graph_id" | "kind" | "id" | "from_kind" | "from_id" | "to_kind" | "to_id" | "deleted_at" | "valid_from" | "valid_to" | "created_at" | "updated_at" | "version";
 
-export { type EdgeId as $, type AdapterBackend as A, type BackendCapabilities as B, type ContributionDiagnostic as C, type SerializedNodeDef as D, type EdgeIndexDeclaration as E, type FulltextStrategy as F, type GraphIdentityConfig as G, type SerializedEdgeDef as H, type IndexDeclaration as I, type JsonPointer as J, type KindEntity as K, type IndexEntity as L, type SerializedMetaEdge as M, type NodeIndexDeclaration as N, type SerializedOntologyRelation as O, type SerializedClosures as P, type QueryAst as Q, type RelationalIndexDeclaration as R, type SqlDialect as S, type TemporalMode as T, type SchemaHash as U, type VectorStrategy as V, type NullCheckOp as W, type JsonSchema as X, type SerializedOntology as Y, type SerializedUniqueConstraint as Z, type NodeId as _, type ContributionDiagnosticState as a, type GetEdgeType as a$, type JsonValue as a0, type NodeKinds as a1, type GetNodeType as a2, type KindAnnotations as a3, type MetaEdge as a4, type EdgeType as a5, type DeleteBehavior as a6, type GraphExtensionVersion as a7, type ExtensionNodeDef as a8, type ExtensionEdgeDef as a9, type ContributionMaterializationBackend as aA, type ContributionProbeContribution as aB, type ContributionProbeEntry as aC, type ContributionProbeResult as aD, type ContributionProbeState as aE, type ContributionRebuildResult as aF, type ContributionRebuildScope as aG, type ContributionRepopulationStats as aH, DEFAULT_SQL_SCHEMA as aI, type DeleteFulltextBatchParams as aJ, type EdgeEntityReadBackend as aK, type EdgeEntityWriteBackend as aL, type EdgeKinds as aM, type EdgeProps as aN, type EdgeRegistration as aO, type EdgeTypeWithEndpoints as aP, type EndpointExistence as aQ, type ExternalRecordedReadSource as aR, type FilteredApproximateSearch as aS, type FilteredApproximateSearchMode as aT, type FindEdgesByHeterogeneousEndpointSetParams as aU, type FulltextBatchRow as aV, type FulltextCapabilities as aW, type FulltextOperationBackend as aX, type FulltextQueryMode as aY, type FulltextSearchParams as aZ, type FulltextSearchResult as a_, type ExtensionOntologyRelation as aa, type ExtensionIndex as ab, type AggregateExpr as ac, type FieldRef as ad, type ComparisonOp as ae, type AggregateComparisonPredicate as af, type TraversalDirection as ag, type OntologyRelation as ah, type InferenceType as ai, type AdapterBackendTransactions as aj, type AllEdgeTypes as ak, type AllNodeTypes as al, type BackendIdentity as am, type BackendLifecycle as an, type BackendMaintenance as ao, type BackendTransactions as ap, CURRENT_GRAPH_EXTENSION_VERSION as aq, type Cardinality as ar, type Collation as as, type CommitSchemaVersionExpected as at, type CommitSchemaVersionIfKindsEmptyResult as au, type CommitSchemaVersionParams as av, type CompiledRowsSql as aw, type CompiledSelectSql as ax, type CompiledStatementSql as ay, type ContributionCapabilities as az, type ContributionRepairEntry as b, type UpdateNodeSetParams as b$, type GraphAnalyticsCapabilities as b0, type GraphDefaults as b1, type GraphEntityReadBackend as b2, type GraphEntityWriteBackend as b3, type GraphExtension as b4, type GraphLifecycleBackend as b5, type HardDeleteUniquesByNodeIdsParams as b6, type HybridFusionOptions as b7, type IndexMaterializationBackend as b8, type IntentSql as b9, type RowProps as bA, type SchemaCommitBackend as bB, type SchemaKindEmptinessProbe as bC, type SchemaReadBackend as bD, type SchemaWriteFenceBackend as bE, type SetActiveVersionParams as bF, type SortDirection as bG, type SqlChunk as bH, type SqlFragment as bI, type SqlIdentifierChunk as bJ, type SqlIntent as bK, type SqlParameterChunk as bL, type SqlPlaceholderChunk as bM, type SqlTableNames as bN, type SqlTag as bO, type SqlTextChunk as bP, type StrategyTableContribution as bQ, type TableContribution as bR, type TransactionBackend as bS, type TransactionOptions as bT, type TransactionReadBackend as bU, type TraversalExpansion as bV, type TrustedImportOptions as bW, type TrustedImportSession as bX, type UniqueConstraint as bY, type UniqueConstraintBackend as bZ, type UniquenessScope as b_, type JsonPointerFor as ba, type JsonPointerInput as bb, type JsonPointerSegment as bc, type JsonPointerSegments as bd, type JsonPointerSegmentsFor as be, LEGACY_GRAPH_EXTENSION_VERSION as bf, type LockSchemaVersionForWriteParams as bg, MAX_JSON_POINTER_DEPTH as bh, type MetaEdgeProperties as bi, type NodeEntityReadBackend as bj, type NodeEntityWriteBackend as bk, type NodeProps as bl, type NodeRegistration as bm, type OrderSpec as bn, type ParameterRef as bo, Placeholder as bp, type PopulatedSchemaKind as bq, type QueryExecutionBackend as br, type RawQueryExecutionBackend as bs, type RawStatementExecutionBackend as bt, type RecordedRelationOptions as bu, type RemovalMaterializationBackend as bv, type RenderedSql as bw, type ResolveJsonPointer as bx, type ResolveJsonPointerSegments as by, type ResolvedSqlTableNames as bz, type ContributionRepairResult as c, D1_MAX_BIND_PARAMETERS as c$, type UpdateNodeSetResult as c0, type UpsertFulltextBatchParams as c1, type VectorCapabilities as c2, type VectorOperationBackend as c3, type VectorSearchFrontierTuning as c4, asEdgeId as c5, asNodeId as c6, buildVectorCapabilities as c7, createSqlSchema as c8, defineGraph as c9, type NodePredicate as cA, type ProjectedField as cB, type AggregateOrderSpec as cC, type GroupBySpec as cD, type RecursiveCyclePolicy as cE, type VectorSlotMap as cF, type RecordedReadBinding as cG, type SelectiveField as cH, type ComposableQuery as cI, type SetOperationType as cJ, type SetOperation as cK, type NodeRow as cL, type EdgeRow as cM, type VectorMetric as cN, ALL_FULLTEXT_MODES as cO, ALL_META_EDGE_NAMES as cP, BASE_CONTRIBUTION_OWNER as cQ, type CheckUniqueBatchParams as cR, type CheckUniqueParams as cS, type ClaimIndexMaterializationParams as cT, type CompiledTemporaryStatementSql as cU, type ContributionMaterializationIdentity as cV, type ContributionMaterializationRow as cW, type CountEdgesByKindParams as cX, type CountEdgesFromParams as cY, type CountNodesByKindParams as cZ, type CreateVectorIndexParams as c_, fts5Strategy as ca, getEdgeKinds as cb, getNodeKinds as cc, isEdgeType as cd, isEdgeTypeWithEndpoints as ce, isGraphDef as cf, isMetaEdge as cg, isNodeType as ch, isSqlFragment as ci, joinJsonPointers as cj, jsonPointer as ck, normalizeJsonPointer as cl, parseJsonPointer as cm, recordedRelation as cn, renderPostgres as co, renderSql as cp, renderSqlInline as cq, renderSqlite as cr, rowPropsToJsonText as cs, rowPropsToObject as ct, sql as cu, tsvectorStrategy as cv, type ValueType as cw, type PredicateExpression as cx, type VectorMetricType as cy, type Traversal as cz, type GraphDef as d, type ReleaseIndexMaterializationClaimParams as d$, DURABLE_OBJECT_MAX_BIND_PARAMETERS as d0, type DeleteEdgeParams as d1, type DeleteEdgesBatchParams as d2, type DeleteEmbeddingParams as d3, type DeleteFulltextParams as d4, type DeleteNodeParams as d5, type DeleteUniqueParams as d6, type DialectAdapter as d7, type DialectCapabilities as d8, type DialectRecursiveQueryStrategy as d9, type FindNodesByKindParams as dA, type GraphReadBackend as dB, type HardDeleteEdgeParams as dC, type HardDeleteNodeParams as dD, type HybridSearchParams as dE, type HybridSearchRow as dF, type IdentityTableNames as dG, type InListParameterOptions as dH, type IndexDeclarationBase as dI, type IndexMaterializationRow as dJ, type IndexWhereLiteral as dK, type IndexWhereOp as dL, type IndexWhereOperand as dM, type InsertEdgeParams as dN, type InsertNodeParams as dO, type InsertSchemaParams as dP, type InsertUniqueParams as dQ, type KindRemovalRow as dR, type LiveNodeRow as dS, MODERN_SQLITE_MAX_BIND_PARAMETERS as dT, type MetaEdgeName as dU, POSTGRES_CAPABILITIES as dV, POSTGRES_MAX_BIND_PARAMETERS as dW, type RecordContributionMaterializationParams as dX, type RecordIndexMaterializationParams as dY, type RecordKindRemovalParams as dZ, type RelationalIndexMethod as d_, type DialectStandardQueryStrategy as da, type DialectVectorPredicateStrategy as db, type DropVectorIndexParams as dc, type EdgeExistsBetweenParams as dd, type ExtensionArrayItemType as de, type ExtensionArrayProperty as df, type ExtensionBooleanProperty as dg, type ExtensionEdgeIndex as dh, type ExtensionEmbeddingModifier as di, type ExtensionEnumProperty as dj, type ExtensionIndexWhere as dk, type ExtensionNodeIndex as dl, type ExtensionNumberProperty as dm, type ExtensionObjectFieldProperty as dn, type ExtensionObjectProperty as dp, type ExtensionPropertyModifiers as dq, type ExtensionPropertyType as dr, type ExtensionSearchableModifier as ds, type ExtensionStringProperty as dt, type ExtensionUniqueConstraint as du, type ExtensionUniqueWhere as dv, FULLTEXT_CONTRIBUTION_NAME as dw, type FindEdgesByEndpointSetParams as dx, type FindEdgesByKindParams as dy, type FindEdgesConnectedToParams as dz, type EdgeIndexConfig as e, SQLITE_CAPABILITIES as e0, SQLITE_MAX_BIND_PARAMETERS as e1, type SchemaCommitPreflightBackend as e2, type SqlCompilationBackend as e3, type TombstonedNodeRow as e4, type UniqueRow as e5, type UpdateEdgeParams as e6, type UpdateNodeParams as e7, type UpsertEmbeddingBatchParams as e8, type UpsertEmbeddingBatchRow as e9, type UpsertEmbeddingParams as ea, type UpsertFulltextParams as eb, VECTOR_CONTRIBUTION_PREFIX as ec, type VectorIndexType as ed, type VectorSearchParams as ee, type VectorSearchResult as ef, assertFiniteEmbedding as eg, assertVectorMinScore as eh, assertVectorSearchLimit as ei, buildFulltextCapabilities as ej, isLiveNodeRow as ek, isSqlPlaceholder as el, isTombstonedNodeRow as em, normalizeGraphAnalyticsCapabilities as en, quoteIdentifier as eo, shortHash as ep, vectorMinScoreCondition as eq, vectorPhysicalName as er, vectorScoreExpression as es, GRAPH_EXTENSION_TOP_LEVEL_KEYS as et, type GraphExtensionTopLevelKey as eu, type EdgeIndexDirection as f, type EdgeIndexWhereBuilder as g, type IndexOrigin as h, type IndexScope as i, type IndexWhereExpression as j, type IndexWhereFieldBuilder as k, type IndexWhereInput as l, type NodeIndexConfig as m, type NodeIndexWhereBuilder as n, type SystemColumnName as o, type VectorIndexDeclaration as p, type VectorIndexImplementation as q, type VectorIndexMetric as r, type VectorIndexParams as s, type VectorSlot as t, type NodeType as u, type AnyEdgeType as v, SqlSchema as w, type SchemaVersionRow as x, type GraphBackend as y, type SerializedSchema as z };
+export { type FieldRef as $, type AdapterBackend as A, type BackendCapabilities as B, type ContributionDiagnostic as C, type SerializedNodeDef as D, type EdgeIndexDeclaration as E, type FulltextStrategy as F, type GraphIdentityConfig as G, type SerializedEdgeDef as H, type IndexDeclaration as I, type JsonPointer as J, type KindEntity as K, type IndexEntity as L, type SerializedMetaEdge as M, type NodeIndexDeclaration as N, type SerializedOntologyRelation as O, type SerializedClosures as P, type QueryAst as Q, type RelationalIndexDeclaration as R, type SqlDialect as S, type TemporalMode as T, type SchemaHash as U, type VectorStrategy as V, type NullCheckOp as W, type JsonSchema as X, type SerializedOntology as Y, type SerializedUniqueConstraint as Z, type AggregateExpr as _, type ContributionDiagnosticState as a, type IndexMaterializationBackend as a$, type ComparisonOp as a0, type AggregateComparisonPredicate as a1, type TraversalDirection as a2, type OntologyRelation as a3, type InferenceType as a4, type EdgeType as a5, type AdapterBackendTransactions as a6, type AllEdgeTypes as a7, type AllNodeTypes as a8, type BackendIdentity as a9, type EdgeId as aA, type EdgeKinds as aB, type EdgeProps as aC, type EdgeRegistration as aD, type EdgeTypeWithEndpoints as aE, type EndpointExistence as aF, type ExternalRecordedReadSource as aG, type FilteredApproximateSearch as aH, type FilteredApproximateSearchMode as aI, type FindEdgesByHeterogeneousEndpointSetParams as aJ, type FulltextBatchRow as aK, type FulltextCapabilities as aL, type FulltextOperationBackend as aM, type FulltextQueryMode as aN, type FulltextSearchParams as aO, type FulltextSearchResult as aP, type GetEdgeType as aQ, type GetNodeType as aR, type GraphAnalyticsCapabilities as aS, type GraphDefaults as aT, type GraphEntityReadBackend as aU, type GraphEntityWriteBackend as aV, type GraphExtension as aW, type GraphExtensionVersion as aX, type GraphLifecycleBackend as aY, type HardDeleteUniquesByNodeIdsParams as aZ, type HybridFusionOptions as a_, type BackendLifecycle as aa, type BackendMaintenance as ab, type BackendTransactions as ac, CURRENT_GRAPH_EXTENSION_VERSION as ad, type Cardinality as ae, type Collation as af, type CommitSchemaVersionExpected as ag, type CommitSchemaVersionIfKindsEmptyResult as ah, type CommitSchemaVersionParams as ai, type CompiledRowsSql as aj, type CompiledSelectSql as ak, type CompiledStatementSql as al, type ContributionCapabilities as am, type ContributionMaterializationBackend as an, type ContributionProbeContribution as ao, type ContributionProbeEntry as ap, type ContributionProbeResult as aq, type ContributionProbeState as ar, type ContributionRebuildResult as as, type ContributionRebuildScope as at, type ContributionRepopulationStats as au, DEFAULT_SQL_SCHEMA as av, type DeleteBehavior as aw, type DeleteFulltextBatchParams as ax, type EdgeEntityReadBackend as ay, type EdgeEntityWriteBackend as az, type ContributionRepairEntry as b, type VectorOperationBackend as b$, type IntentSql as b0, type JsonPointerFor as b1, type JsonPointerInput as b2, type JsonPointerSegment as b3, type JsonPointerSegments as b4, type JsonPointerSegmentsFor as b5, type JsonValue as b6, type KindAnnotations as b7, LEGACY_GRAPH_EXTENSION_VERSION as b8, type LockSchemaVersionForWriteParams as b9, type SchemaWriteFenceBackend as bA, type SetActiveVersionParams as bB, type SortDirection as bC, type SqlChunk as bD, type SqlFragment as bE, type SqlIdentifierChunk as bF, type SqlIntent as bG, type SqlParameterChunk as bH, type SqlPlaceholderChunk as bI, type SqlTableNames as bJ, type SqlTag as bK, type SqlTextChunk as bL, type StrategyTableContribution as bM, type TableContribution as bN, type TransactionBackend as bO, type TransactionOptions as bP, type TransactionReadBackend as bQ, type TraversalExpansion as bR, type TrustedImportOptions as bS, type TrustedImportSession as bT, type UniqueConstraint as bU, type UniqueConstraintBackend as bV, type UniquenessScope as bW, type UpdateNodeSetParams as bX, type UpdateNodeSetResult as bY, type UpsertFulltextBatchParams as bZ, type VectorCapabilities as b_, MAX_JSON_POINTER_DEPTH as ba, type MetaEdge as bb, type MetaEdgeProperties as bc, type NodeEntityReadBackend as bd, type NodeEntityWriteBackend as be, type NodeId as bf, type NodeKinds as bg, type NodeProps as bh, type NodeRegistration as bi, type OrderSpec as bj, type ParameterRef as bk, Placeholder as bl, type PopulatedSchemaKind as bm, type QueryExecutionBackend as bn, type RawQueryExecutionBackend as bo, type RawStatementExecutionBackend as bp, type RecordedRelationOptions as bq, type RemovalMaterializationBackend as br, type RenderedSql as bs, type ResolveJsonPointer as bt, type ResolveJsonPointerSegments as bu, type ResolvedSqlTableNames as bv, type RowProps as bw, type SchemaCommitBackend as bx, type SchemaKindEmptinessProbe as by, type SchemaReadBackend as bz, type ContributionRepairResult as c, type CreateVectorIndexParams as c$, type VectorSearchFrontierTuning as c0, asEdgeId as c1, asNodeId as c2, buildVectorCapabilities as c3, createSqlSchema as c4, defineGraph as c5, fts5Strategy as c6, getEdgeKinds as c7, getNodeKinds as c8, isEdgeType as c9, type NodePredicate as cA, type ProjectedField as cB, type AggregateOrderSpec as cC, type GroupBySpec as cD, type RecursiveCyclePolicy as cE, type VectorSlotMap as cF, type RecordedReadBinding as cG, type SelectiveField as cH, type ComposableQuery as cI, type SetOperationType as cJ, type SetOperation as cK, type NodeRow as cL, type EdgeRow as cM, type BackendValidityEndMutation as cN, type VectorMetric as cO, ALL_FULLTEXT_MODES as cP, ALL_META_EDGE_NAMES as cQ, BASE_CONTRIBUTION_OWNER as cR, type CheckUniqueBatchParams as cS, type CheckUniqueParams as cT, type ClaimIndexMaterializationParams as cU, type CompiledTemporaryStatementSql as cV, type ContributionMaterializationIdentity as cW, type ContributionMaterializationRow as cX, type CountEdgesByKindParams as cY, type CountEdgesFromParams as cZ, type CountNodesByKindParams as c_, isEdgeTypeWithEndpoints as ca, isGraphDef as cb, isMetaEdge as cc, isNodeType as cd, isSqlFragment as ce, joinJsonPointers as cf, jsonPointer as cg, normalizeJsonPointer as ch, parseJsonPointer as ci, recordedRelation as cj, renderPostgres as ck, renderSql as cl, renderSqlInline as cm, renderSqlite as cn, rowPropsToJsonText as co, rowPropsToObject as cp, sql as cq, tsvectorStrategy as cr, type ExtensionNodeDef as cs, type ExtensionEdgeDef as ct, type ExtensionOntologyRelation as cu, type ExtensionIndex as cv, type ValueType as cw, type PredicateExpression as cx, type VectorMetricType as cy, type Traversal as cz, type GraphDef as d, type RelationalIndexMethod as d$, D1_MAX_BIND_PARAMETERS as d0, DURABLE_OBJECT_MAX_BIND_PARAMETERS as d1, type DeleteEdgeParams as d2, type DeleteEdgesBatchParams as d3, type DeleteEmbeddingParams as d4, type DeleteFulltextParams as d5, type DeleteNodeParams as d6, type DeleteUniqueParams as d7, type DialectAdapter as d8, type DialectCapabilities as d9, type FindEdgesConnectedToParams as dA, type FindNodesByKindParams as dB, type GraphReadBackend as dC, type HardDeleteEdgeParams as dD, type HardDeleteNodeParams as dE, type HybridSearchParams as dF, type HybridSearchRow as dG, type IdentityTableNames as dH, type InListParameterOptions as dI, type IndexDeclarationBase as dJ, type IndexMaterializationRow as dK, type IndexWhereLiteral as dL, type IndexWhereOp as dM, type IndexWhereOperand as dN, type InsertEdgeParams as dO, type InsertNodeParams as dP, type InsertSchemaParams as dQ, type InsertUniqueParams as dR, type KindRemovalRow as dS, type LiveNodeRow as dT, MODERN_SQLITE_MAX_BIND_PARAMETERS as dU, type MetaEdgeName as dV, POSTGRES_CAPABILITIES as dW, POSTGRES_MAX_BIND_PARAMETERS as dX, type RecordContributionMaterializationParams as dY, type RecordIndexMaterializationParams as dZ, type RecordKindRemovalParams as d_, type DialectRecursiveQueryStrategy as da, type DialectStandardQueryStrategy as db, type DialectVectorPredicateStrategy as dc, type DropVectorIndexParams as dd, type EdgeExistsBetweenParams as de, type ExtensionArrayItemType as df, type ExtensionArrayProperty as dg, type ExtensionBooleanProperty as dh, type ExtensionEdgeIndex as di, type ExtensionEmbeddingModifier as dj, type ExtensionEnumProperty as dk, type ExtensionIndexWhere as dl, type ExtensionNodeIndex as dm, type ExtensionNumberProperty as dn, type ExtensionObjectFieldProperty as dp, type ExtensionObjectProperty as dq, type ExtensionPropertyModifiers as dr, type ExtensionPropertyType as ds, type ExtensionSearchableModifier as dt, type ExtensionStringProperty as du, type ExtensionUniqueConstraint as dv, type ExtensionUniqueWhere as dw, FULLTEXT_CONTRIBUTION_NAME as dx, type FindEdgesByEndpointSetParams as dy, type FindEdgesByKindParams as dz, type EdgeIndexConfig as e, type ReleaseIndexMaterializationClaimParams as e0, SQLITE_CAPABILITIES as e1, SQLITE_MAX_BIND_PARAMETERS as e2, type SchemaCommitPreflightBackend as e3, type SqlCompilationBackend as e4, type TombstonedNodeRow as e5, type UniqueRow as e6, type UpdateEdgeParams as e7, type UpdateNodeParams as e8, type UpsertEmbeddingBatchParams as e9, type UpsertEmbeddingBatchRow as ea, type UpsertEmbeddingParams as eb, type UpsertFulltextParams as ec, VECTOR_CONTRIBUTION_PREFIX as ed, type VectorIndexType as ee, type VectorSearchParams as ef, type VectorSearchResult as eg, assertFiniteEmbedding as eh, assertVectorMinScore as ei, assertVectorSearchLimit as ej, buildFulltextCapabilities as ek, isLiveNodeRow as el, isSqlPlaceholder as em, isTombstonedNodeRow as en, normalizeGraphAnalyticsCapabilities as eo, quoteIdentifier as ep, shortHash as eq, vectorMinScoreCondition as er, vectorPhysicalName as es, vectorScoreExpression as et, GRAPH_EXTENSION_TOP_LEVEL_KEYS as eu, type GraphExtensionTopLevelKey as ev, type EdgeIndexDirection as f, type EdgeIndexWhereBuilder as g, type IndexOrigin as h, type IndexScope as i, type IndexWhereExpression as j, type IndexWhereFieldBuilder as k, type IndexWhereInput as l, type NodeIndexConfig as m, type NodeIndexWhereBuilder as n, type SystemColumnName as o, type VectorIndexDeclaration as p, type VectorIndexImplementation as q, type VectorIndexMetric as r, type VectorIndexParams as s, type VectorSlot as t, type NodeType as u, type AnyEdgeType as v, SqlSchema as w, type SchemaVersionRow as x, type GraphBackend as y, type SerializedSchema as z };

package/dist/{types-CoIx8HX5.d.cts → types-oj_OGAaZ.d.cts}

@@ -1,4 +1,4 @@
-import { K as KindEntity, J as JsonPointer } from './types-HkveCCx0.cjs';
+import { K as KindEntity, J as JsonPointer } from './types-DKkMJZjR.cjs';
 
 /**
  * QueryProfiler types.

package/dist/{where-ws5hf-Ov.d.ts → where-C8w2627G.d.ts}

@@ -1,4 +1,4 @@
-import { v as AnyEdgeType, e as EdgeIndexConfig, E as EdgeIndexDeclaration, u as NodeType, m as NodeIndexConfig, N as NodeIndexDeclaration, j as IndexWhereExpression } from './types-HkveCCx0.js';
+import { v as AnyEdgeType, e as EdgeIndexConfig, E as EdgeIndexDeclaration, u as NodeType, m as NodeIndexConfig, N as NodeIndexDeclaration, j as IndexWhereExpression } from './types-DKkMJZjR.js';
 
 /** The TypeGraph relations that carry system indexes. */
 type SystemIndexTable = "nodes" | "edges" | "recordedNodes" | "recordedEdges";

package/dist/{where--fk7_0kv.d.cts → where-D1wKCJ4Q.d.cts}

@@ -1,4 +1,4 @@
-import { v as AnyEdgeType, e as EdgeIndexConfig, E as EdgeIndexDeclaration, u as NodeType, m as NodeIndexConfig, N as NodeIndexDeclaration, j as IndexWhereExpression } from './types-HkveCCx0.cjs';
+import { v as AnyEdgeType, e as EdgeIndexConfig, E as EdgeIndexDeclaration, u as NodeType, m as NodeIndexConfig, N as NodeIndexDeclaration, j as IndexWhereExpression } from './types-DKkMJZjR.cjs';
 
 /** 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.46.1",
+  "version": "0.47.0",
   "description": "TypeScript-first embedded knowledge graph library with ontological reasoning",
   "type": "module",
   "main": "./dist/index.cjs",