@nicia-ai/typegraph 0.46.2 → 0.48.0

package/dist/{temporal-DPtn0HOu.d.ts → temporal-5GqpYCk2.d.cts}

@@ -1,4 +1,4 @@
-import { T as TemporalMode } from './types-Du78EvpN.js';
+import { ce as TemporalMode } from './types-BqFZTQmV.cjs';
 
 declare const RECORDED_INSTANT_BRAND: unique symbol;
 /**

package/dist/{temporal-CXewwLTB.d.cts → temporal-CbnLzTmM.d.ts}

@@ -1,4 +1,4 @@
-import { T as TemporalMode } from './types-Du78EvpN.cjs';
+import { ce as TemporalMode } from './types-BqFZTQmV.js';
 
 declare const RECORDED_INSTANT_BRAND: unique symbol;
 /**

package/dist/{types-Du78EvpN.d.ts → types-BqFZTQmV.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,
@@ -2615,7 +2622,13 @@ type InsertNodeParams = Readonly<{
     id: string;
     props: Readonly<Record<string, unknown>>;
     /**
-     * Omitted (`undefined`): defaults to the insert's creation timestamp.
+     * Omitted (`undefined`): the insert stamps its own creation timestamp —
+     * UNLESS a stated `validTo` at or before that instant would make the stored
+     * window readable at no coordinate, in which case the row is stored with no
+     * lower bound ("ended at T, start unknown"). See
+     * `resolveStampedValidityLowerBound`, which every insert builder decides
+     * through. Custom backend implementations can import that owner from
+     * `@nicia-ai/typegraph/backend` rather than reimplementing the rule.
      * `null`: preserves an explicit open-left validity window (no lower
      * bound) — used by interchange import to round-trip a row that was
      * already NULL, instead of re-stamping it to the import's own timestamp.
@@ -2624,16 +2637,38 @@ 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;
     id: string;
     props: Readonly<Record<string, unknown>>;
-    /** Applied when resurrecting a tombstone; omitted means the resurrection instant. */
+    /**
+     * Applied when resurrecting a tombstone, which RESETS the window. Omitted
+     * means the resurrection instant — unless a stated `validTo` at or before it
+     * would leave the row readable at no coordinate, in which case the
+     * resurrection stores no lower bound. Same rule, same owner, as an insert:
+     * `resolveStampedValidityLowerBound`.
+     *
+     * The store's own resurrection paths never omit it. Their window guard has to
+     * judge the bound the write will STORE, so they resolve it through that owner
+     * against the instant they sampled and pass the result — `null` included,
+     * which is how "store no lower bound" is spelled here. Omission is for callers
+     * with no such verdict to honor; it lets this builder decide against its own,
+     * strictly later sample.
+     */
     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 +2696,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.
@@ -2715,7 +2750,13 @@ type InsertEdgeParams = Readonly<{
     toId: string;
     props: Readonly<Record<string, unknown>>;
     /**
-     * Omitted (`undefined`): defaults to the insert's creation timestamp.
+     * Omitted (`undefined`): the insert stamps its own creation timestamp —
+     * UNLESS a stated `validTo` at or before that instant would make the stored
+     * window readable at no coordinate, in which case the row is stored with no
+     * lower bound ("ended at T, start unknown"). See
+     * `resolveStampedValidityLowerBound`, which every insert builder decides
+     * through. Custom backend implementations can import that owner from
+     * `@nicia-ai/typegraph/backend` rather than reimplementing the rule.
      * `null`: preserves an explicit open-left validity window (no lower
      * bound) — used by interchange import to round-trip a row that was
      * already NULL, instead of re-stamping it to the import's own timestamp.
@@ -2793,7 +2834,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 +2846,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).
  */
@@ -3902,6 +3947,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.
      *
@@ -5602,4 +5653,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 DialectCapabilities as $, ALL_FULLTEXT_MODES as A, BASE_CONTRIBUTION_OWNER as B, type Cardinality as C, type ContributionProbeEntry as D, type ContributionProbeResult as E, type ContributionProbeState as F, type ContributionRebuildResult as G, type ContributionRebuildScope as H, type IndexDeclaration as I, type ContributionRepairEntry as J, type ContributionRepairResult as K, type ContributionRepopulationStats as L, type CountEdgesByKindParams as M, type CountEdgesFromParams as N, type CountNodesByKindParams as O, type CreateVectorIndexParams as P, D1_MAX_BIND_PARAMETERS as Q, DURABLE_OBJECT_MAX_BIND_PARAMETERS as R, type DeleteBehavior as S, type DeleteEdgeParams as T, type DeleteEdgesBatchParams as U, type DeleteEmbeddingParams as V, type DeleteFulltextBatchParams as W, type DeleteFulltextParams as X, type DeleteNodeParams as Y, type DeleteUniqueParams as Z, type DialectAdapter as _, ALL_META_EDGE_NAMES as a, type IndexDeclarationBase as a$, type DialectRecursiveQueryStrategy as a0, type DialectStandardQueryStrategy as a1, type DialectVectorPredicateStrategy as a2, type DropVectorIndexParams as a3, type EdgeEntityReadBackend as a4, type EdgeEntityWriteBackend as a5, type EdgeExistsBetweenParams as a6, type EdgeIndexDeclaration as a7, type EdgeIndexDirection as a8, type EdgeRow as a9, type FindEdgesByHeterogeneousEndpointSetParams as aA, type FindEdgesByKindParams as aB, type FindEdgesConnectedToParams as aC, type FindNodesByKindParams as aD, type FulltextBatchRow as aE, type FulltextCapabilities as aF, type FulltextOperationBackend as aG, type FulltextQueryMode as aH, type FulltextSearchParams as aI, type FulltextSearchResult as aJ, type FulltextStrategy as aK, type GraphAnalyticsCapabilities as aL, type GraphBackend as aM, type GraphEntityReadBackend as aN, type GraphEntityWriteBackend as aO, type GraphExtension as aP, type GraphExtensionVersion as aQ, type GraphIdentityConfig as aR, type GraphLifecycleBackend as aS, type GraphReadBackend as aT, type HardDeleteEdgeParams as aU, type HardDeleteNodeParams as aV, type HardDeleteUniquesByNodeIdsParams as aW, type HybridSearchParams as aX, type HybridSearchRow as aY, type IdentityTableNames as aZ, type InListParameterOptions as a_, type EndpointExistence as aa, type ExtensionArrayItemType as ab, type ExtensionArrayProperty as ac, type ExtensionBooleanProperty as ad, type ExtensionEdgeDef as ae, type ExtensionEdgeIndex as af, type ExtensionEmbeddingModifier as ag, type ExtensionEnumProperty as ah, type ExtensionIndex as ai, type ExtensionIndexWhere as aj, type ExtensionNodeDef as ak, type ExtensionNodeIndex as al, type ExtensionNumberProperty as am, type ExtensionObjectFieldProperty as an, type ExtensionObjectProperty as ao, type ExtensionOntologyRelation as ap, type ExtensionPropertyModifiers as aq, type ExtensionPropertyType as ar, type ExtensionSearchableModifier as as, type ExtensionStringProperty as at, type ExtensionUniqueConstraint as au, type ExtensionUniqueWhere as av, FULLTEXT_CONTRIBUTION_NAME as aw, type FilteredApproximateSearch as ax, type FilteredApproximateSearchMode as ay, type FindEdgesByEndpointSetParams as az, type AdapterBackend as b, type SetActiveVersionParams as b$, type IndexEntity as b0, type IndexMaterializationBackend as b1, type IndexMaterializationRow as b2, type IndexOrigin as b3, type IndexScope as b4, type IndexWhereExpression as b5, type IndexWhereLiteral as b6, type IndexWhereOp as b7, type IndexWhereOperand as b8, type InferenceType as b9, type RawStatementExecutionBackend as bA, type RecordContributionMaterializationParams as bB, type RecordIndexMaterializationParams as bC, type RecordKindRemovalParams as bD, type RelationalIndexDeclaration as bE, type RelationalIndexMethod as bF, type ReleaseIndexMaterializationClaimParams as bG, type RemovalMaterializationBackend as bH, type RenderedSql as bI, type ResolvedSqlTableNames as bJ, type RowProps as bK, SQLITE_CAPABILITIES as bL, SQLITE_MAX_BIND_PARAMETERS as bM, type SchemaCommitBackend as bN, type SchemaCommitPreflightBackend as bO, type SchemaKindEmptinessProbe as bP, type SchemaReadBackend as bQ, type SchemaVersionRow as bR, type SchemaWriteFenceBackend as bS, type SerializedClosures as bT, type SerializedEdgeDef as bU, type SerializedMetaEdge as bV, type SerializedNodeDef as bW, type SerializedOntology as bX, type SerializedOntologyRelation as bY, type SerializedSchema as bZ, type SerializedUniqueConstraint as b_, type InsertEdgeParams as ba, type InsertNodeParams as bb, type InsertSchemaParams as bc, type InsertUniqueParams as bd, type IntentSql as be, type JsonPointer as bf, type JsonSchema as bg, type JsonValue as bh, type KindAnnotations as bi, type KindEntity as bj, type KindRemovalRow as bk, type LiveNodeRow as bl, type LockSchemaVersionForWriteParams as bm, MODERN_SQLITE_MAX_BIND_PARAMETERS as bn, type MetaEdgeName as bo, type NodeEntityReadBackend as bp, type NodeEntityWriteBackend as bq, type NodeIndexDeclaration as br, type NodeRow as bs, type NullCheckOp as bt, POSTGRES_CAPABILITIES as bu, POSTGRES_MAX_BIND_PARAMETERS as bv, Placeholder as bw, type PopulatedSchemaKind as bx, type QueryExecutionBackend as by, type RawQueryExecutionBackend as bz, type AdapterBackendTransactions as c, renderSqlite as c$, type SqlChunk as c0, type SqlCompilationBackend as c1, type SqlDialect as c2, type SqlFragment as c3, type SqlIdentifierChunk as c4, type SqlIntent as c5, type SqlParameterChunk as c6, type SqlPlaceholderChunk as c7, type SqlTableNames as c8, type SqlTag as c9, type VectorIndexDeclaration as cA, type VectorIndexImplementation as cB, type VectorIndexMetric as cC, type VectorIndexParams as cD, type VectorIndexType as cE, type VectorMetric as cF, type VectorOperationBackend as cG, type VectorSearchFrontierTuning as cH, type VectorSearchParams as cI, type VectorSearchResult as cJ, type VectorSlot as cK, type VectorStrategy as cL, assertFiniteEmbedding as cM, assertVectorMinScore as cN, assertVectorSearchLimit as cO, buildFulltextCapabilities as cP, buildVectorCapabilities as cQ, fts5Strategy as cR, isLiveNodeRow as cS, isSqlFragment as cT, isSqlPlaceholder as cU, isTombstonedNodeRow as cV, normalizeGraphAnalyticsCapabilities as cW, quoteIdentifier as cX, renderPostgres as cY, renderSql as cZ, renderSqlInline as c_, type SqlTextChunk as ca, type StrategyTableContribution as cb, type SystemColumnName as cc, type TableContribution as cd, type TemporalMode as ce, type TombstonedNodeRow as cf, type TransactionBackend as cg, type TransactionOptions as ch, type TransactionReadBackend as ci, type TrustedImportOptions as cj, type TrustedImportSession as ck, type UniqueConstraintBackend as cl, type UniqueRow as cm, type UniquenessScope as cn, type UpdateEdgeParams as co, type UpdateNodeParams as cp, type UpdateNodeSetParams as cq, type UpdateNodeSetResult as cr, type UpsertEmbeddingBatchParams as cs, type UpsertEmbeddingBatchRow as ct, type UpsertEmbeddingParams as cu, type UpsertFulltextBatchParams as cv, type UpsertFulltextParams as cw, VECTOR_CONTRIBUTION_PREFIX as cx, type ValueType as cy, type VectorCapabilities as cz, type BackendCapabilities as d, asEdgeId as d$, rowPropsToJsonText as d0, rowPropsToObject as d1, shortHash as d2, sql as d3, tsvectorStrategy as d4, vectorMinScoreCondition as d5, vectorPhysicalName as d6, vectorScoreExpression as d7, type GraphDef as d8, type QueryAst as d9, type EdgeTypeWithEndpoints as dA, type ExternalRecordedReadSource as dB, type GetEdgeType as dC, type GetNodeType as dD, type GraphDefaults as dE, type HybridFusionOptions as dF, type JsonPointerFor as dG, type JsonPointerInput as dH, type JsonPointerSegment as dI, type JsonPointerSegments as dJ, type JsonPointerSegmentsFor as dK, LEGACY_GRAPH_EXTENSION_VERSION as dL, MAX_JSON_POINTER_DEPTH as dM, type MetaEdge as dN, type MetaEdgeProperties as dO, type NodeId as dP, type NodeKinds as dQ, type NodeProps as dR, type NodeRegistration as dS, type OrderSpec as dT, type ParameterRef as dU, type RecordedRelationOptions as dV, type ResolveJsonPointer as dW, type ResolveJsonPointerSegments as dX, type SortDirection as dY, type TraversalExpansion as dZ, type UniqueConstraint as d_, type EdgeIndexConfig as da, type EdgeIndexWhereBuilder as db, type IndexWhereFieldBuilder as dc, type IndexWhereInput as dd, type NodeIndexConfig as de, type NodeIndexWhereBuilder as df, type NodeType as dg, type AnyEdgeType as dh, SqlSchema as di, type SchemaHash as dj, type AggregateExpr as dk, type FieldRef as dl, type ComparisonOp as dm, type AggregateComparisonPredicate as dn, type TraversalDirection as dp, type OntologyRelation as dq, type EdgeType as dr, type AllEdgeTypes as ds, type AllNodeTypes as dt, CURRENT_GRAPH_EXTENSION_VERSION as du, DEFAULT_SQL_SCHEMA as dv, type EdgeId as dw, type EdgeKinds as dx, type EdgeProps as dy, type EdgeRegistration as dz, type BackendIdentity as e, asNodeId as e0, createSqlSchema as e1, defineGraph as e2, getEdgeKinds as e3, getNodeKinds as e4, isEdgeType as e5, isEdgeTypeWithEndpoints as e6, isGraphDef as e7, isMetaEdge as e8, isNodeType as e9, joinJsonPointers as ea, jsonPointer as eb, normalizeJsonPointer as ec, parseJsonPointer as ed, recordedRelation as ee, type PredicateExpression as ef, type VectorMetricType as eg, type Traversal as eh, type NodePredicate as ei, type ProjectedField as ej, type AggregateOrderSpec as ek, type GroupBySpec as el, type RecursiveCyclePolicy as em, type VectorSlotMap as en, type RecordedReadBinding as eo, type SelectiveField as ep, type ComposableQuery as eq, type SetOperationType as er, type SetOperation as es, type BackendValidityEndMutation as et, GRAPH_EXTENSION_TOP_LEVEL_KEYS as eu, type GraphExtensionTopLevelKey as ev, type BackendLifecycle as f, type BackendMaintenance as g, type BackendTransactions as h, type CheckUniqueBatchParams as i, type CheckUniqueParams as j, type ClaimIndexMaterializationParams as k, type Collation as l, type CommitSchemaVersionExpected as m, type CommitSchemaVersionIfKindsEmptyResult as n, type CommitSchemaVersionParams as o, type CompiledRowsSql as p, type CompiledSelectSql as q, type CompiledStatementSql as r, type CompiledTemporaryStatementSql as s, type ContributionCapabilities as t, type ContributionDiagnostic as u, type ContributionDiagnosticState as v, type ContributionMaterializationBackend as w, type ContributionMaterializationIdentity as x, type ContributionMaterializationRow as y, type ContributionProbeContribution as z };

package/dist/{types-Du78EvpN.d.cts → types-BqFZTQmV.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,
@@ -2615,7 +2622,13 @@ type InsertNodeParams = Readonly<{
     id: string;
     props: Readonly<Record<string, unknown>>;
     /**
-     * Omitted (`undefined`): defaults to the insert's creation timestamp.
+     * Omitted (`undefined`): the insert stamps its own creation timestamp —
+     * UNLESS a stated `validTo` at or before that instant would make the stored
+     * window readable at no coordinate, in which case the row is stored with no
+     * lower bound ("ended at T, start unknown"). See
+     * `resolveStampedValidityLowerBound`, which every insert builder decides
+     * through. Custom backend implementations can import that owner from
+     * `@nicia-ai/typegraph/backend` rather than reimplementing the rule.
      * `null`: preserves an explicit open-left validity window (no lower
      * bound) — used by interchange import to round-trip a row that was
      * already NULL, instead of re-stamping it to the import's own timestamp.
@@ -2624,16 +2637,38 @@ 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;
     id: string;
     props: Readonly<Record<string, unknown>>;
-    /** Applied when resurrecting a tombstone; omitted means the resurrection instant. */
+    /**
+     * Applied when resurrecting a tombstone, which RESETS the window. Omitted
+     * means the resurrection instant — unless a stated `validTo` at or before it
+     * would leave the row readable at no coordinate, in which case the
+     * resurrection stores no lower bound. Same rule, same owner, as an insert:
+     * `resolveStampedValidityLowerBound`.
+     *
+     * The store's own resurrection paths never omit it. Their window guard has to
+     * judge the bound the write will STORE, so they resolve it through that owner
+     * against the instant they sampled and pass the result — `null` included,
+     * which is how "store no lower bound" is spelled here. Omission is for callers
+     * with no such verdict to honor; it lets this builder decide against its own,
+     * strictly later sample.
+     */
     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 +2696,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.
@@ -2715,7 +2750,13 @@ type InsertEdgeParams = Readonly<{
     toId: string;
     props: Readonly<Record<string, unknown>>;
     /**
-     * Omitted (`undefined`): defaults to the insert's creation timestamp.
+     * Omitted (`undefined`): the insert stamps its own creation timestamp —
+     * UNLESS a stated `validTo` at or before that instant would make the stored
+     * window readable at no coordinate, in which case the row is stored with no
+     * lower bound ("ended at T, start unknown"). See
+     * `resolveStampedValidityLowerBound`, which every insert builder decides
+     * through. Custom backend implementations can import that owner from
+     * `@nicia-ai/typegraph/backend` rather than reimplementing the rule.
      * `null`: preserves an explicit open-left validity window (no lower
      * bound) — used by interchange import to round-trip a row that was
      * already NULL, instead of re-stamping it to the import's own timestamp.
@@ -2793,7 +2834,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 +2846,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).
  */
@@ -3902,6 +3947,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.
      *
@@ -5602,4 +5653,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 DialectCapabilities as $, ALL_FULLTEXT_MODES as A, BASE_CONTRIBUTION_OWNER as B, type Cardinality as C, type ContributionProbeEntry as D, type ContributionProbeResult as E, type ContributionProbeState as F, type ContributionRebuildResult as G, type ContributionRebuildScope as H, type IndexDeclaration as I, type ContributionRepairEntry as J, type ContributionRepairResult as K, type ContributionRepopulationStats as L, type CountEdgesByKindParams as M, type CountEdgesFromParams as N, type CountNodesByKindParams as O, type CreateVectorIndexParams as P, D1_MAX_BIND_PARAMETERS as Q, DURABLE_OBJECT_MAX_BIND_PARAMETERS as R, type DeleteBehavior as S, type DeleteEdgeParams as T, type DeleteEdgesBatchParams as U, type DeleteEmbeddingParams as V, type DeleteFulltextBatchParams as W, type DeleteFulltextParams as X, type DeleteNodeParams as Y, type DeleteUniqueParams as Z, type DialectAdapter as _, ALL_META_EDGE_NAMES as a, type IndexDeclarationBase as a$, type DialectRecursiveQueryStrategy as a0, type DialectStandardQueryStrategy as a1, type DialectVectorPredicateStrategy as a2, type DropVectorIndexParams as a3, type EdgeEntityReadBackend as a4, type EdgeEntityWriteBackend as a5, type EdgeExistsBetweenParams as a6, type EdgeIndexDeclaration as a7, type EdgeIndexDirection as a8, type EdgeRow as a9, type FindEdgesByHeterogeneousEndpointSetParams as aA, type FindEdgesByKindParams as aB, type FindEdgesConnectedToParams as aC, type FindNodesByKindParams as aD, type FulltextBatchRow as aE, type FulltextCapabilities as aF, type FulltextOperationBackend as aG, type FulltextQueryMode as aH, type FulltextSearchParams as aI, type FulltextSearchResult as aJ, type FulltextStrategy as aK, type GraphAnalyticsCapabilities as aL, type GraphBackend as aM, type GraphEntityReadBackend as aN, type GraphEntityWriteBackend as aO, type GraphExtension as aP, type GraphExtensionVersion as aQ, type GraphIdentityConfig as aR, type GraphLifecycleBackend as aS, type GraphReadBackend as aT, type HardDeleteEdgeParams as aU, type HardDeleteNodeParams as aV, type HardDeleteUniquesByNodeIdsParams as aW, type HybridSearchParams as aX, type HybridSearchRow as aY, type IdentityTableNames as aZ, type InListParameterOptions as a_, type EndpointExistence as aa, type ExtensionArrayItemType as ab, type ExtensionArrayProperty as ac, type ExtensionBooleanProperty as ad, type ExtensionEdgeDef as ae, type ExtensionEdgeIndex as af, type ExtensionEmbeddingModifier as ag, type ExtensionEnumProperty as ah, type ExtensionIndex as ai, type ExtensionIndexWhere as aj, type ExtensionNodeDef as ak, type ExtensionNodeIndex as al, type ExtensionNumberProperty as am, type ExtensionObjectFieldProperty as an, type ExtensionObjectProperty as ao, type ExtensionOntologyRelation as ap, type ExtensionPropertyModifiers as aq, type ExtensionPropertyType as ar, type ExtensionSearchableModifier as as, type ExtensionStringProperty as at, type ExtensionUniqueConstraint as au, type ExtensionUniqueWhere as av, FULLTEXT_CONTRIBUTION_NAME as aw, type FilteredApproximateSearch as ax, type FilteredApproximateSearchMode as ay, type FindEdgesByEndpointSetParams as az, type AdapterBackend as b, type SetActiveVersionParams as b$, type IndexEntity as b0, type IndexMaterializationBackend as b1, type IndexMaterializationRow as b2, type IndexOrigin as b3, type IndexScope as b4, type IndexWhereExpression as b5, type IndexWhereLiteral as b6, type IndexWhereOp as b7, type IndexWhereOperand as b8, type InferenceType as b9, type RawStatementExecutionBackend as bA, type RecordContributionMaterializationParams as bB, type RecordIndexMaterializationParams as bC, type RecordKindRemovalParams as bD, type RelationalIndexDeclaration as bE, type RelationalIndexMethod as bF, type ReleaseIndexMaterializationClaimParams as bG, type RemovalMaterializationBackend as bH, type RenderedSql as bI, type ResolvedSqlTableNames as bJ, type RowProps as bK, SQLITE_CAPABILITIES as bL, SQLITE_MAX_BIND_PARAMETERS as bM, type SchemaCommitBackend as bN, type SchemaCommitPreflightBackend as bO, type SchemaKindEmptinessProbe as bP, type SchemaReadBackend as bQ, type SchemaVersionRow as bR, type SchemaWriteFenceBackend as bS, type SerializedClosures as bT, type SerializedEdgeDef as bU, type SerializedMetaEdge as bV, type SerializedNodeDef as bW, type SerializedOntology as bX, type SerializedOntologyRelation as bY, type SerializedSchema as bZ, type SerializedUniqueConstraint as b_, type InsertEdgeParams as ba, type InsertNodeParams as bb, type InsertSchemaParams as bc, type InsertUniqueParams as bd, type IntentSql as be, type JsonPointer as bf, type JsonSchema as bg, type JsonValue as bh, type KindAnnotations as bi, type KindEntity as bj, type KindRemovalRow as bk, type LiveNodeRow as bl, type LockSchemaVersionForWriteParams as bm, MODERN_SQLITE_MAX_BIND_PARAMETERS as bn, type MetaEdgeName as bo, type NodeEntityReadBackend as bp, type NodeEntityWriteBackend as bq, type NodeIndexDeclaration as br, type NodeRow as bs, type NullCheckOp as bt, POSTGRES_CAPABILITIES as bu, POSTGRES_MAX_BIND_PARAMETERS as bv, Placeholder as bw, type PopulatedSchemaKind as bx, type QueryExecutionBackend as by, type RawQueryExecutionBackend as bz, type AdapterBackendTransactions as c, renderSqlite as c$, type SqlChunk as c0, type SqlCompilationBackend as c1, type SqlDialect as c2, type SqlFragment as c3, type SqlIdentifierChunk as c4, type SqlIntent as c5, type SqlParameterChunk as c6, type SqlPlaceholderChunk as c7, type SqlTableNames as c8, type SqlTag as c9, type VectorIndexDeclaration as cA, type VectorIndexImplementation as cB, type VectorIndexMetric as cC, type VectorIndexParams as cD, type VectorIndexType as cE, type VectorMetric as cF, type VectorOperationBackend as cG, type VectorSearchFrontierTuning as cH, type VectorSearchParams as cI, type VectorSearchResult as cJ, type VectorSlot as cK, type VectorStrategy as cL, assertFiniteEmbedding as cM, assertVectorMinScore as cN, assertVectorSearchLimit as cO, buildFulltextCapabilities as cP, buildVectorCapabilities as cQ, fts5Strategy as cR, isLiveNodeRow as cS, isSqlFragment as cT, isSqlPlaceholder as cU, isTombstonedNodeRow as cV, normalizeGraphAnalyticsCapabilities as cW, quoteIdentifier as cX, renderPostgres as cY, renderSql as cZ, renderSqlInline as c_, type SqlTextChunk as ca, type StrategyTableContribution as cb, type SystemColumnName as cc, type TableContribution as cd, type TemporalMode as ce, type TombstonedNodeRow as cf, type TransactionBackend as cg, type TransactionOptions as ch, type TransactionReadBackend as ci, type TrustedImportOptions as cj, type TrustedImportSession as ck, type UniqueConstraintBackend as cl, type UniqueRow as cm, type UniquenessScope as cn, type UpdateEdgeParams as co, type UpdateNodeParams as cp, type UpdateNodeSetParams as cq, type UpdateNodeSetResult as cr, type UpsertEmbeddingBatchParams as cs, type UpsertEmbeddingBatchRow as ct, type UpsertEmbeddingParams as cu, type UpsertFulltextBatchParams as cv, type UpsertFulltextParams as cw, VECTOR_CONTRIBUTION_PREFIX as cx, type ValueType as cy, type VectorCapabilities as cz, type BackendCapabilities as d, asEdgeId as d$, rowPropsToJsonText as d0, rowPropsToObject as d1, shortHash as d2, sql as d3, tsvectorStrategy as d4, vectorMinScoreCondition as d5, vectorPhysicalName as d6, vectorScoreExpression as d7, type GraphDef as d8, type QueryAst as d9, type EdgeTypeWithEndpoints as dA, type ExternalRecordedReadSource as dB, type GetEdgeType as dC, type GetNodeType as dD, type GraphDefaults as dE, type HybridFusionOptions as dF, type JsonPointerFor as dG, type JsonPointerInput as dH, type JsonPointerSegment as dI, type JsonPointerSegments as dJ, type JsonPointerSegmentsFor as dK, LEGACY_GRAPH_EXTENSION_VERSION as dL, MAX_JSON_POINTER_DEPTH as dM, type MetaEdge as dN, type MetaEdgeProperties as dO, type NodeId as dP, type NodeKinds as dQ, type NodeProps as dR, type NodeRegistration as dS, type OrderSpec as dT, type ParameterRef as dU, type RecordedRelationOptions as dV, type ResolveJsonPointer as dW, type ResolveJsonPointerSegments as dX, type SortDirection as dY, type TraversalExpansion as dZ, type UniqueConstraint as d_, type EdgeIndexConfig as da, type EdgeIndexWhereBuilder as db, type IndexWhereFieldBuilder as dc, type IndexWhereInput as dd, type NodeIndexConfig as de, type NodeIndexWhereBuilder as df, type NodeType as dg, type AnyEdgeType as dh, SqlSchema as di, type SchemaHash as dj, type AggregateExpr as dk, type FieldRef as dl, type ComparisonOp as dm, type AggregateComparisonPredicate as dn, type TraversalDirection as dp, type OntologyRelation as dq, type EdgeType as dr, type AllEdgeTypes as ds, type AllNodeTypes as dt, CURRENT_GRAPH_EXTENSION_VERSION as du, DEFAULT_SQL_SCHEMA as dv, type EdgeId as dw, type EdgeKinds as dx, type EdgeProps as dy, type EdgeRegistration as dz, type BackendIdentity as e, asNodeId as e0, createSqlSchema as e1, defineGraph as e2, getEdgeKinds as e3, getNodeKinds as e4, isEdgeType as e5, isEdgeTypeWithEndpoints as e6, isGraphDef as e7, isMetaEdge as e8, isNodeType as e9, joinJsonPointers as ea, jsonPointer as eb, normalizeJsonPointer as ec, parseJsonPointer as ed, recordedRelation as ee, type PredicateExpression as ef, type VectorMetricType as eg, type Traversal as eh, type NodePredicate as ei, type ProjectedField as ej, type AggregateOrderSpec as ek, type GroupBySpec as el, type RecursiveCyclePolicy as em, type VectorSlotMap as en, type RecordedReadBinding as eo, type SelectiveField as ep, type ComposableQuery as eq, type SetOperationType as er, type SetOperation as es, type BackendValidityEndMutation as et, GRAPH_EXTENSION_TOP_LEVEL_KEYS as eu, type GraphExtensionTopLevelKey as ev, type BackendLifecycle as f, type BackendMaintenance as g, type BackendTransactions as h, type CheckUniqueBatchParams as i, type CheckUniqueParams as j, type ClaimIndexMaterializationParams as k, type Collation as l, type CommitSchemaVersionExpected as m, type CommitSchemaVersionIfKindsEmptyResult as n, type CommitSchemaVersionParams as o, type CompiledRowsSql as p, type CompiledSelectSql as q, type CompiledStatementSql as r, type CompiledTemporaryStatementSql as s, type ContributionCapabilities as t, type ContributionDiagnostic as u, type ContributionDiagnosticState as v, type ContributionMaterializationBackend as w, type ContributionMaterializationIdentity as x, type ContributionMaterializationRow as y, type ContributionProbeContribution as z };

package/dist/{types-CeT7xM4M.d.ts → types-Bx74kaTt.d.ts}

@@ -1,4 +1,4 @@
-import { K as KindEntity, J as JsonPointer } from './types-Du78EvpN.js';
+import { bj as KindEntity, bf as JsonPointer } from './types-BqFZTQmV.js';
 
 /**
  * QueryProfiler types.

package/dist/{types-XR1nHERK.d.cts → types-CXAhpW-c.d.cts}

@@ -1,4 +1,4 @@
-import { K as KindEntity, J as JsonPointer } from './types-Du78EvpN.cjs';
+import { bj as KindEntity, bf as JsonPointer } from './types-BqFZTQmV.cjs';
 
 /**
  * QueryProfiler types.

package/dist/{where-CJsp-YUf.d.cts → where-DI_Fqz-X.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-Du78EvpN.cjs';
+import { dh as AnyEdgeType, da as EdgeIndexConfig, a7 as EdgeIndexDeclaration, dg as NodeType, de as NodeIndexConfig, br as NodeIndexDeclaration, b5 as IndexWhereExpression } from './types-BqFZTQmV.cjs';
 
 /** The TypeGraph relations that carry system indexes. */
 type SystemIndexTable = "nodes" | "edges" | "recordedNodes" | "recordedEdges";

package/dist/{where-CMbFiWwp.d.ts → where-O-k2wgYm.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-Du78EvpN.js';
+import { dh as AnyEdgeType, da as EdgeIndexConfig, a7 as EdgeIndexDeclaration, dg as NodeType, de as NodeIndexConfig, br as NodeIndexDeclaration, b5 as IndexWhereExpression } from './types-BqFZTQmV.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.46.2",
+  "version": "0.48.0",
   "description": "TypeScript-first embedded knowledge graph library with ontological reasoning",
   "type": "module",
   "main": "./dist/index.cjs",