@nicia-ai/typegraph 0.32.0 → 0.34.0

package/dist/{types-DGDiXAYc.d.ts → types-B1TbZJYS.d.ts}

@@ -1,5 +1,5 @@
-import { K as KindEntity } from './extension-types-D1k0inWU.js';
-import { J as JsonPointer } from './types-Dk8r09KY.js';
+import { K as KindEntity } from './extension-types-YGFJPrzK.js';
+import { J as JsonPointer } from './types-D1Sqeyxy.js';
 
 /**
  * QueryProfiler types.

package/dist/{types-Dk8r09KY.d.ts → types-D1Sqeyxy.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { N as NodeType, g as EdgeType, U as UniquenessScope, C as Collation, D as DeleteBehavior, f as KindAnnotations, m as Cardinality, n as EndpointExistence, T as TemporalMode, G as GraphExtension, I as IndexEntity, K as KindEntity, a as NullCheckOp, A as AnyEdgeType } from './extension-types-D1k0inWU.js';
+import { N as NodeType, g as EdgeType, s as UniquenessScope, n as Collation, D as DeleteBehavior, f as KindAnnotations, m as Cardinality, q as EndpointExistence, T as TemporalMode, G as GraphExtension, I as IndexEntity, K as KindEntity, a as NullCheckOp, A as AnyEdgeType } from './extension-types-YGFJPrzK.js';
 import { SQL } from 'drizzle-orm';
 import { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
 import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
@@ -120,25 +120,68 @@ type SqlTableNames = Readonly<{
     nodes: string;
     /** Edges table name (default: "typegraph_edges") */
     edges: string;
+    /** Recorded node relation table name (default: "typegraph_recorded_nodes") */
+    recordedNodes?: string | undefined;
+    /** Recorded edge relation table name (default: "typegraph_recorded_edges") */
+    recordedEdges?: string | undefined;
+    /** Recorded-time commit clock table name (default: "typegraph_recorded_clock") */
+    recordedClock?: string | undefined;
     /** Node fulltext table name (default: "typegraph_node_fulltext") */
     fulltext: string;
     /** Node uniques table name (default: "typegraph_node_uniques") */
     uniques: string;
 }>;
-/**
- * SQL schema configuration for query compilation.
- * Contains table identifiers and utility methods for generating SQL references.
- */
-type SqlSchema = Readonly<{
+type ResolvedSqlTableNames = Readonly<{
+    /** Nodes table name */
+    nodes: string;
+    /** Edges table name */
+    edges: string;
+    /** Recorded node relation table name */
+    recordedNodes: string;
+    /** Recorded edge relation table name */
+    recordedEdges: string;
+    /** Recorded-time commit clock table name */
+    recordedClock: string;
+    /** Node fulltext table name */
+    fulltext: string;
+    /** Node uniques table name */
+    uniques: string;
+}>;
+type SqlSchemaFields = Readonly<{
     /** Table names */
-    tables: SqlTableNames;
+    tables: ResolvedSqlTableNames;
     /** Get a SQL reference to the nodes table */
     nodesTable: SQL;
     /** Get a SQL reference to the edges table */
     edgesTable: SQL;
+    /** Get a SQL reference to the recorded node relation */
+    recordedNodesTable: SQL;
+    /** Get a SQL reference to the recorded edge relation */
+    recordedEdgesTable: SQL;
+    /** Get a SQL reference to the recorded-time commit clock */
+    recordedClockTable: SQL;
     /** Get a SQL reference to the fulltext table */
     fulltextTable: SQL;
 }>;
+/**
+ * SQL schema configuration for query compilation.
+ * Contains table identifiers and utility methods for generating SQL references.
+ *
+ * Branded and frozen by {@link createSqlSchema}; callers should not construct
+ * schema-shaped objects by hand.
+ */
+type SqlSchema = SqlSchemaDescriptor;
+declare class SqlSchemaDescriptor implements SqlSchemaFields {
+    #private;
+    readonly tables: ResolvedSqlTableNames;
+    readonly nodesTable: SQL;
+    readonly edgesTable: SQL;
+    readonly recordedNodesTable: SQL;
+    readonly recordedEdgesTable: SQL;
+    readonly recordedClockTable: SQL;
+    readonly fulltextTable: SQL;
+    constructor(fields: SqlSchemaFields);
+}
 /**
  * Creates a SqlSchema configuration from table names.
  *
@@ -163,6 +206,34 @@ type SqlSchema = Readonly<{
  * ```
  */
 declare function createSqlSchema(names?: Partial<SqlTableNames>): SqlSchema;
+/**
+ * The recorded/system-time relation a read coordinate may reconstruct from.
+ *
+ * TypeGraph's built-in capture relation is bound by `createStore(..., {
+ * history: true })`. Hosts can also bind externally populated row-compatible
+ * recorded relations through `recordedRelation({ schema })`. Keeping both as
+ * explicit values separates the read contract from the write-capture mechanism
+ * so future external/TMS-owned recorded relations can feed the same query
+ * machinery without changing StoreView or ReadCoordinate.
+ */
+declare const EXTERNAL_RECORDED_READ_SOURCE: unique symbol;
+type ExternalRecordedReadSource = Readonly<{
+    source: "external";
+    schema: SqlSchema;
+    [EXTERNAL_RECORDED_READ_SOURCE]: true;
+}>;
+declare const TYPEGRAPH_RECORDED_READ_SOURCE: unique symbol;
+type TypeGraphRecordedReadSource = Readonly<{
+    source: "typegraph-capture";
+    schema: SqlSchema;
+    [TYPEGRAPH_RECORDED_READ_SOURCE]: true;
+}>;
+type RecordedReadSource = ExternalRecordedReadSource | TypeGraphRecordedReadSource;
+type RecordedReadBinding = RecordedReadSource;
+type RecordedRelationOptions = Readonly<{
+    schema: SqlSchema;
+}>;
+declare function recordedRelation(options: RecordedRelationOptions): ExternalRecordedReadSource;
 /**
  * Default SqlSchema using standard TypeGraph table names.
  */
@@ -527,6 +598,18 @@ interface VectorStrategy {
     buildDropIndex?(slot: VectorSlot): SQL | undefined;
 }
 
+declare const SqlIntentBrand: unique symbol;
+type SqlIntent = "rows" | "statement";
+type IntentSql<I extends SqlIntent> = SQL & Readonly<{
+    [SqlIntentBrand]: I;
+}>;
+type CompiledRowsSql = IntentSql<"rows">;
+type CompiledSelectSql = CompiledRowsSql;
+type CompiledStatementSql = IntentSql<"statement">;
+declare function asCompiledRowsSql(query: SQL): CompiledRowsSql;
+declare function asCompiledSelectSql(query: SQL): CompiledSelectSql;
+declare function asCompiledStatementSql(query: SQL): CompiledStatementSql;
+
 /**
  * SQL Dialect Abstraction Layer
  *
@@ -711,10 +794,14 @@ type AnyPgDatabase = PgDatabase<PgQueryResultHKT, Record<string, unknown>>;
 /**
  * Controls how the backend manages SQLite transactions.
  *
- * - `"sql"`:     TypeGraph issues BEGIN / COMMIT / ROLLBACK SQL directly.
- *                Default for sync drivers (better-sqlite3, bun:sqlite).
+ * - `"sql"`:     TypeGraph issues BEGIN / COMMIT / ROLLBACK SQL directly on
+ *                the connection. Default for sync drivers (better-sqlite3,
+ *                bun:sqlite); also selected by `createLibsqlBackend` for
+ *                local `@libsql/client` connections (`file:` / `:memory:`),
+ *                whose `client.transaction()` permanently abandons the
+ *                current connection — fatal for an in-memory database.
  * - `"drizzle"`: Delegates to Drizzle's `db.transaction()` method.
- *                Default for async drivers (libsql, sql.js).
+ *                Default for async drivers (remote libsql/Turso, sql.js).
  * - `"do-sqlite"`: Delegates to the Cloudflare Durable Objects async
  *                storage transaction runner (`db.$client.transaction`,
  *                i.e. `ctx.storage.transaction(async ...)`). Drizzle's
@@ -801,6 +888,26 @@ type BackendCapabilities = Readonly<{
     transactions: boolean;
     /** Whether the backend supports SQL window functions such as ROW_NUMBER() */
     windowFunctions: boolean;
+    /**
+     * Whether the backend's `execute()` supports `UPDATE … RETURNING`. Absent or
+     * `true` means supported (every engine TypeGraph ships — SQLite ≥ 3.35,
+     * PostgreSQL ≥ 8.2 — supports it). A custom backend whose engine cannot run
+     * `RETURNING` must set this to `false` so recorded-time history capture
+     * (`history: true`), which relies on `UPDATE … RETURNING` on its hot path,
+     * is refused up front instead of failing mid-flush.
+     */
+    returning?: boolean;
+    /**
+     * Maximum number of bound parameters the engine accepts in one statement.
+     * SQLite defaults to 999 (raisable at compile time via
+     * `SQLITE_MAX_VARIABLE_NUMBER`); PostgreSQL's wire protocol caps it at 65535.
+     * Recorded-time capture and recorded point reads size their multi-row
+     * statements to this ceiling — the same budget the backend's own batched
+     * inserts use — instead of a conservative dialect-blind constant. A custom
+     * build that raises the SQLite limit can override this here. Absent means the
+     * recorded-time fallback budget applies.
+     */
+    maxBindParameters?: number;
     /** Vector search capabilities (undefined if not configured) */
     vector?: VectorCapabilities | undefined;
     /** Fulltext search capabilities (undefined if not configured) */
@@ -1327,20 +1434,6 @@ type TransactionOptions = Readonly<{
  * relational writes share one Postgres/SQLite transaction (#134).
  */
 type AdoptedTransaction = AnyPgDatabase | AnySqliteDatabase;
-/**
- * Transaction backend — a backend scoped to a transaction.
- *
- * `commitSchemaVersion` and `setActiveVersion` are intentionally omitted:
- * the atomicity / CAS guarantees of those primitives depend on
- * dialect-specific write-locking (BEGIN IMMEDIATE on SQLite,
- * `pg_advisory_xact_lock` on Postgres) acquired by the top-level
- * backend wrappers, not the transaction itself. Calling them from a
- * user-supplied `backend.transaction(...)` callback would bypass that
- * locking and silently weaken the orphan-row crash window the primitive
- * exists to eliminate. Schema commits go through the top-level backend
- * methods only.
- */
-type TransactionBackend = Omit<GraphBackend, "transaction" | "adoptTransaction" | "close" | "refreshStatistics" | "commitSchemaVersion" | "setActiveVersion">;
 /**
  * The GraphBackend interface abstracts database operations.
  *
@@ -1637,7 +1730,14 @@ type GraphBackend = Readonly<{
      * sizes this library is designed for.
      */
     refreshStatistics: () => Promise<void>;
-    execute: <T>(query: SQL) => Promise<readonly T[]>;
+    execute: <T>(query: CompiledRowsSql) => Promise<readonly T[]>;
+    /**
+     * Execute a non-row-returning SQL statement bound to this backend or
+     * transaction. Optional because custom backends may only expose the public
+     * row-returning query path; features that need statement execution must
+     * capability-check and fail loudly.
+     */
+    executeStatement?: (query: CompiledStatementSql) => Promise<void>;
     /** Execute pre-compiled SQL text with bound parameters. Available on sync SQLite and pg backends. */
     executeRaw?: <T>(sqlText: string, params: readonly unknown[]) => Promise<readonly T[]>;
     /** Compile a Drizzle SQL object to { sql, params } without executing. */
@@ -1699,6 +1799,39 @@ type GraphBackend = Readonly<{
     adoptTransaction?: (externalTx: AdoptedTransaction) => TransactionBackend;
     close: () => Promise<void>;
 }>;
+type BackendIdentity = Pick<GraphBackend, "dialect" | "capabilities" | "tableNames" | "fulltextStrategy" | "vectorStrategy">;
+type NodeEntityReadBackend = Pick<GraphBackend, "getNode" | "getNodes" | "findNodesByKind" | "countNodesByKind">;
+type NodeEntityWriteBackend = Pick<GraphBackend, "insertNode" | "insertNodeNoReturn" | "insertNodesBatch" | "insertNodesBatchReturning" | "updateNode" | "deleteNode" | "hardDeleteNode">;
+type EdgeEntityReadBackend = Pick<GraphBackend, "getEdge" | "getEdges" | "countEdgesFrom" | "edgeExistsBetween" | "findEdgesConnectedTo" | "findEdgesByKind" | "countEdgesByKind">;
+type EdgeEntityWriteBackend = Pick<GraphBackend, "insertEdge" | "insertEdgeNoReturn" | "insertEdgesBatch" | "insertEdgesBatchReturning" | "updateEdge" | "deleteEdge" | "hardDeleteEdge">;
+type GraphEntityReadBackend = NodeEntityReadBackend & EdgeEntityReadBackend;
+type GraphEntityWriteBackend = NodeEntityWriteBackend & EdgeEntityWriteBackend;
+type UniqueConstraintBackend = Pick<GraphBackend, "insertUnique" | "deleteUnique" | "checkUnique" | "checkUniqueBatch">;
+type SchemaReadBackend = Pick<GraphBackend, "getActiveSchema" | "getSchemaVersion">;
+type SchemaCommitBackend = Pick<GraphBackend, "commitSchemaVersion" | "setActiveVersion">;
+type VectorOperationBackend = Pick<GraphBackend, "upsertEmbedding" | "deleteEmbedding" | "vectorSearch" | "createVectorIndex" | "dropVectorIndex">;
+type FulltextOperationBackend = Pick<GraphBackend, "upsertFulltext" | "deleteFulltext" | "upsertFulltextBatch" | "deleteFulltextBatch" | "fulltextSearch">;
+type IndexMaterializationBackend = Pick<GraphBackend, "ensureIndexMaterializationsTable" | "getIndexMaterialization" | "getIndexMaterializations" | "recordIndexMaterialization">;
+type ContributionMaterializationBackend = Pick<GraphBackend, "ensureContributionMaterializationsTable" | "getContributionMaterialization" | "recordContributionMaterialization" | "assertRuntimeContributionsInitialized" | "ensureRuntimeContributions" | "ensureFulltextTable">;
+type RemovalMaterializationBackend = Pick<GraphBackend, "ensureKindRemovalsTable" | "getPendingKindRemovals" | "getAllKindRemovals" | "recordKindRemoval" | "ensureReconciliationMarkersTable" | "getReconciliationMarker" | "setReconciliationMarker">;
+type GraphLifecycleBackend = Pick<GraphBackend, "clearGraph" | "bootstrapTables">;
+type QueryExecutionBackend = Pick<GraphBackend, "execute">;
+type RawQueryExecutionBackend = Pick<GraphBackend, "executeRaw" | "compileSql">;
+type RawStatementExecutionBackend = Pick<GraphBackend, "executeStatement" | "executeDdl">;
+type BackendMaintenance = Pick<GraphBackend, "refreshStatistics">;
+type BackendTransactions = Pick<GraphBackend, "transaction" | "adoptTransaction">;
+type BackendLifecycle = Pick<GraphBackend, "close">;
+/**
+ * Transaction backend — a backend scoped to a transaction.
+ *
+ * This is an explicit facet composition, not `Omit<GraphBackend, ...>`.
+ * New top-level-only backend methods therefore do not silently appear on
+ * transaction-scoped backends. `commitSchemaVersion`, `setActiveVersion`,
+ * `refreshStatistics`, `transaction`, `adoptTransaction`, and `close` stay
+ * deliberately absent: their guarantees depend on the top-level backend or
+ * lifecycle owner rather than an already-open transaction.
+ */
+type TransactionBackend = Readonly<BackendIdentity & GraphEntityReadBackend & GraphEntityWriteBackend & UniqueConstraintBackend & SchemaReadBackend & VectorOperationBackend & FulltextOperationBackend & IndexMaterializationBackend & ContributionMaterializationBackend & RemovalMaterializationBackend & GraphLifecycleBackend & QueryExecutionBackend & RawQueryExecutionBackend & RawStatementExecutionBackend>;
 /**
  * Parameters for inserting a unique constraint entry.
  */
@@ -2330,6 +2463,8 @@ type QueryAst = Readonly<{
     predicates: readonly NodePredicate[];
     projection: Projection;
     temporalMode: TemporalOptions;
+    /** Recorded/system-time timestamp for recorded-pinned reads. */
+    recordedAsOf?: string;
     orderBy?: readonly OrderSpec[];
     limit?: number;
     offset?: number;
@@ -2618,4 +2753,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 FulltextBatchRow as $, type AnySqliteDatabase as A, type BackendCapabilities as B, type VectorIndexMetric as C, type VectorIndexParams as D, type EdgeIndexConfig as E, type FulltextStrategy as F, type GraphBackend as G, type SchemaVersionRow as H, type IndexDeclaration as I, type JsonPointer as J, type InferenceType as K, type AggregateExpr as L, type MetaEdge as M, type NodeIndexConfig as N, type OntologyRelation as O, type FieldRef as P, type QueryAst as Q, type RelationalIndexDeclaration as R, type SqliteExecutionProfileHints as S, type ComparisonOp as T, type AggregateComparisonPredicate as U, type VectorStrategy as V, type AdoptedTransaction as W, type CommitSchemaVersionExpected as X, type CommitSchemaVersionParams as Y, DEFAULT_SQL_SCHEMA as Z, type DeleteFulltextBatchParams as _, type SqliteTransactionMode as a, type FulltextCapabilities as a0, type FulltextQueryMode as a1, type FulltextSearchParams as a2, type FulltextSearchResult as a3, type HybridFusionOptions as a4, type JsonPointerFor as a5, type JsonPointerInput as a6, type JsonPointerSegment as a7, type JsonPointerSegments as a8, type JsonPointerSegmentsFor as a9, type ValueType as aA, type PredicateExpression as aB, type VectorMetricType as aC, type Traversal as aD, type NodePredicate as aE, type ProjectedField as aF, type GroupBySpec as aG, type RecursiveCyclePolicy as aH, type TraversalDirection as aI, type EdgeRow as aJ, type NodeRow as aK, type VectorSlotMap as aL, type SelectiveField as aM, type ComposableQuery as aN, type SetOperationType as aO, type SetOperation as aP, type VectorMetric as aQ, type TransactionOptions as aR, MAX_JSON_POINTER_DEPTH as aa, type MetaEdgeProperties as ab, type OrderSpec as ac, type ParameterRef as ad, type ResolveJsonPointer as ae, type ResolveJsonPointerSegments as af, type SetActiveVersionParams as ag, type SortDirection as ah, type SqlSchema as ai, type SqlTableNames as aj, type StrategyTableContribution as ak, type TableContribution as al, type TransactionBackend as am, type TraversalExpansion as an, type UpsertFulltextBatchParams as ao, type VectorCapabilities as ap, type VectorSlot as aq, buildVectorCapabilities as ar, createSqlSchema as as, fts5Strategy as at, isMetaEdge as au, joinJsonPointers as av, jsonPointer as aw, normalizeJsonPointer as ax, parseJsonPointer as ay, tsvectorStrategy as az, type AnyPgDatabase as b, type EdgeIndexDeclaration as c, type NodeIndexDeclaration as d, type IndexWhereExpression as e, type SerializedNodeDef as f, type SerializedEdgeDef as g, type SerializedMetaEdge as h, type SerializedOntologyRelation as i, type SerializedClosures as j, type SerializedSchema as k, type SchemaHash as l, type JsonSchema as m, type SerializedOntology as n, type SerializedUniqueConstraint as o, type SqlDialect as p, type EdgeIndexDirection as q, type EdgeIndexWhereBuilder as r, type IndexOrigin as s, type IndexScope as t, type IndexWhereFieldBuilder as u, type IndexWhereInput as v, type NodeIndexWhereBuilder as w, type SystemColumnName as x, type VectorIndexDeclaration as y, type VectorIndexImplementation as z };
+export { type BackendTransactions as $, type AnySqliteDatabase as A, type BackendCapabilities as B, type VectorIndexMetric as C, type VectorIndexParams as D, type EdgeIndexConfig as E, type FulltextStrategy as F, type GraphBackend as G, type SchemaVersionRow as H, type IndexDeclaration as I, type JsonPointer as J, type InferenceType as K, type AggregateExpr as L, type MetaEdge as M, type NodeIndexConfig as N, type OntologyRelation as O, type FieldRef as P, type QueryAst as Q, type RelationalIndexDeclaration as R, type SqliteExecutionProfileHints as S, type ComparisonOp as T, type AggregateComparisonPredicate as U, type VectorStrategy as V, type TraversalDirection as W, type AdoptedTransaction as X, type BackendIdentity as Y, type BackendLifecycle as Z, type BackendMaintenance as _, type SqliteTransactionMode as a, fts5Strategy as a$, type CommitSchemaVersionExpected as a0, type CommitSchemaVersionParams as a1, type CompiledRowsSql as a2, type CompiledSelectSql as a3, type CompiledStatementSql as a4, type ContributionMaterializationBackend as a5, DEFAULT_SQL_SCHEMA as a6, type DeleteFulltextBatchParams as a7, type EdgeEntityReadBackend as a8, type EdgeEntityWriteBackend as a9, type RawStatementExecutionBackend as aA, type RecordedRelationOptions as aB, type RemovalMaterializationBackend as aC, type ResolveJsonPointer as aD, type ResolveJsonPointerSegments as aE, type ResolvedSqlTableNames as aF, type SchemaCommitBackend as aG, type SchemaReadBackend as aH, type SetActiveVersionParams as aI, type SortDirection as aJ, type SqlIntent as aK, type SqlSchema as aL, type SqlTableNames as aM, type StrategyTableContribution as aN, type TableContribution as aO, type TransactionBackend as aP, type TraversalExpansion as aQ, type UniqueConstraintBackend as aR, type UpsertFulltextBatchParams as aS, type VectorCapabilities as aT, type VectorOperationBackend as aU, type VectorSlot as aV, asCompiledRowsSql as aW, asCompiledSelectSql as aX, asCompiledStatementSql as aY, buildVectorCapabilities as aZ, createSqlSchema as a_, type ExternalRecordedReadSource as aa, type FulltextBatchRow as ab, type FulltextCapabilities as ac, type FulltextOperationBackend as ad, type FulltextQueryMode as ae, type FulltextSearchParams as af, type FulltextSearchResult as ag, type GraphEntityReadBackend as ah, type GraphEntityWriteBackend as ai, type GraphLifecycleBackend as aj, type HybridFusionOptions as ak, type IndexMaterializationBackend as al, type IntentSql as am, type JsonPointerFor as an, type JsonPointerInput as ao, type JsonPointerSegment as ap, type JsonPointerSegments as aq, type JsonPointerSegmentsFor as ar, MAX_JSON_POINTER_DEPTH as as, type MetaEdgeProperties as at, type NodeEntityReadBackend as au, type NodeEntityWriteBackend as av, type OrderSpec as aw, type ParameterRef as ax, type QueryExecutionBackend as ay, type RawQueryExecutionBackend as az, type AnyPgDatabase as b, isMetaEdge as b0, joinJsonPointers as b1, jsonPointer as b2, normalizeJsonPointer as b3, parseJsonPointer as b4, recordedRelation as b5, tsvectorStrategy as b6, type ValueType as b7, type PredicateExpression as b8, type VectorMetricType as b9, type Traversal as ba, type NodePredicate as bb, type ProjectedField as bc, type GroupBySpec as bd, type RecursiveCyclePolicy as be, type EdgeRow as bf, type NodeRow as bg, type VectorSlotMap as bh, type RecordedReadBinding as bi, type SelectiveField as bj, type ComposableQuery as bk, type SetOperationType as bl, type SetOperation as bm, type VectorMetric as bn, type TransactionOptions as bo, type EdgeIndexDeclaration as c, type NodeIndexDeclaration as d, type IndexWhereExpression as e, type SerializedNodeDef as f, type SerializedEdgeDef as g, type SerializedMetaEdge as h, type SerializedOntologyRelation as i, type SerializedClosures as j, type SerializedSchema as k, type SchemaHash as l, type JsonSchema as m, type SerializedOntology as n, type SerializedUniqueConstraint as o, type SqlDialect as p, type EdgeIndexDirection as q, type EdgeIndexWhereBuilder as r, type IndexOrigin as s, type IndexScope as t, type IndexWhereFieldBuilder as u, type IndexWhereInput as v, type NodeIndexWhereBuilder as w, type SystemColumnName as x, type VectorIndexDeclaration as y, type VectorIndexImplementation as z };

package/dist/{types-5RQwzWXx.d.cts → types-DiE1AO7p.d.cts}

@@ -1,5 +1,5 @@
-import { K as KindEntity } from './extension-types-D1k0inWU.cjs';
-import { J as JsonPointer } from './types-Dvmn-eal.cjs';
+import { K as KindEntity } from './extension-types-YGFJPrzK.cjs';
+import { J as JsonPointer } from './types-DkNnF-7K.cjs';
 
 /**
  * QueryProfiler types.

package/dist/{types-Dvmn-eal.d.cts → types-DkNnF-7K.d.cts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { N as NodeType, g as EdgeType, U as UniquenessScope, C as Collation, D as DeleteBehavior, f as KindAnnotations, m as Cardinality, n as EndpointExistence, T as TemporalMode, G as GraphExtension, I as IndexEntity, K as KindEntity, a as NullCheckOp, A as AnyEdgeType } from './extension-types-D1k0inWU.cjs';
+import { N as NodeType, g as EdgeType, s as UniquenessScope, n as Collation, D as DeleteBehavior, f as KindAnnotations, m as Cardinality, q as EndpointExistence, T as TemporalMode, G as GraphExtension, I as IndexEntity, K as KindEntity, a as NullCheckOp, A as AnyEdgeType } from './extension-types-YGFJPrzK.cjs';
 import { SQL } from 'drizzle-orm';
 import { PgDatabase, PgQueryResultHKT } from 'drizzle-orm/pg-core';
 import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
@@ -120,25 +120,68 @@ type SqlTableNames = Readonly<{
     nodes: string;
     /** Edges table name (default: "typegraph_edges") */
     edges: string;
+    /** Recorded node relation table name (default: "typegraph_recorded_nodes") */
+    recordedNodes?: string | undefined;
+    /** Recorded edge relation table name (default: "typegraph_recorded_edges") */
+    recordedEdges?: string | undefined;
+    /** Recorded-time commit clock table name (default: "typegraph_recorded_clock") */
+    recordedClock?: string | undefined;
     /** Node fulltext table name (default: "typegraph_node_fulltext") */
     fulltext: string;
     /** Node uniques table name (default: "typegraph_node_uniques") */
     uniques: string;
 }>;
-/**
- * SQL schema configuration for query compilation.
- * Contains table identifiers and utility methods for generating SQL references.
- */
-type SqlSchema = Readonly<{
+type ResolvedSqlTableNames = Readonly<{
+    /** Nodes table name */
+    nodes: string;
+    /** Edges table name */
+    edges: string;
+    /** Recorded node relation table name */
+    recordedNodes: string;
+    /** Recorded edge relation table name */
+    recordedEdges: string;
+    /** Recorded-time commit clock table name */
+    recordedClock: string;
+    /** Node fulltext table name */
+    fulltext: string;
+    /** Node uniques table name */
+    uniques: string;
+}>;
+type SqlSchemaFields = Readonly<{
     /** Table names */
-    tables: SqlTableNames;
+    tables: ResolvedSqlTableNames;
     /** Get a SQL reference to the nodes table */
     nodesTable: SQL;
     /** Get a SQL reference to the edges table */
     edgesTable: SQL;
+    /** Get a SQL reference to the recorded node relation */
+    recordedNodesTable: SQL;
+    /** Get a SQL reference to the recorded edge relation */
+    recordedEdgesTable: SQL;
+    /** Get a SQL reference to the recorded-time commit clock */
+    recordedClockTable: SQL;
     /** Get a SQL reference to the fulltext table */
     fulltextTable: SQL;
 }>;
+/**
+ * SQL schema configuration for query compilation.
+ * Contains table identifiers and utility methods for generating SQL references.
+ *
+ * Branded and frozen by {@link createSqlSchema}; callers should not construct
+ * schema-shaped objects by hand.
+ */
+type SqlSchema = SqlSchemaDescriptor;
+declare class SqlSchemaDescriptor implements SqlSchemaFields {
+    #private;
+    readonly tables: ResolvedSqlTableNames;
+    readonly nodesTable: SQL;
+    readonly edgesTable: SQL;
+    readonly recordedNodesTable: SQL;
+    readonly recordedEdgesTable: SQL;
+    readonly recordedClockTable: SQL;
+    readonly fulltextTable: SQL;
+    constructor(fields: SqlSchemaFields);
+}
 /**
  * Creates a SqlSchema configuration from table names.
  *
@@ -163,6 +206,34 @@ type SqlSchema = Readonly<{
  * ```
  */
 declare function createSqlSchema(names?: Partial<SqlTableNames>): SqlSchema;
+/**
+ * The recorded/system-time relation a read coordinate may reconstruct from.
+ *
+ * TypeGraph's built-in capture relation is bound by `createStore(..., {
+ * history: true })`. Hosts can also bind externally populated row-compatible
+ * recorded relations through `recordedRelation({ schema })`. Keeping both as
+ * explicit values separates the read contract from the write-capture mechanism
+ * so future external/TMS-owned recorded relations can feed the same query
+ * machinery without changing StoreView or ReadCoordinate.
+ */
+declare const EXTERNAL_RECORDED_READ_SOURCE: unique symbol;
+type ExternalRecordedReadSource = Readonly<{
+    source: "external";
+    schema: SqlSchema;
+    [EXTERNAL_RECORDED_READ_SOURCE]: true;
+}>;
+declare const TYPEGRAPH_RECORDED_READ_SOURCE: unique symbol;
+type TypeGraphRecordedReadSource = Readonly<{
+    source: "typegraph-capture";
+    schema: SqlSchema;
+    [TYPEGRAPH_RECORDED_READ_SOURCE]: true;
+}>;
+type RecordedReadSource = ExternalRecordedReadSource | TypeGraphRecordedReadSource;
+type RecordedReadBinding = RecordedReadSource;
+type RecordedRelationOptions = Readonly<{
+    schema: SqlSchema;
+}>;
+declare function recordedRelation(options: RecordedRelationOptions): ExternalRecordedReadSource;
 /**
  * Default SqlSchema using standard TypeGraph table names.
  */
@@ -527,6 +598,18 @@ interface VectorStrategy {
     buildDropIndex?(slot: VectorSlot): SQL | undefined;
 }
 
+declare const SqlIntentBrand: unique symbol;
+type SqlIntent = "rows" | "statement";
+type IntentSql<I extends SqlIntent> = SQL & Readonly<{
+    [SqlIntentBrand]: I;
+}>;
+type CompiledRowsSql = IntentSql<"rows">;
+type CompiledSelectSql = CompiledRowsSql;
+type CompiledStatementSql = IntentSql<"statement">;
+declare function asCompiledRowsSql(query: SQL): CompiledRowsSql;
+declare function asCompiledSelectSql(query: SQL): CompiledSelectSql;
+declare function asCompiledStatementSql(query: SQL): CompiledStatementSql;
+
 /**
  * SQL Dialect Abstraction Layer
  *
@@ -711,10 +794,14 @@ type AnyPgDatabase = PgDatabase<PgQueryResultHKT, Record<string, unknown>>;
 /**
  * Controls how the backend manages SQLite transactions.
  *
- * - `"sql"`:     TypeGraph issues BEGIN / COMMIT / ROLLBACK SQL directly.
- *                Default for sync drivers (better-sqlite3, bun:sqlite).
+ * - `"sql"`:     TypeGraph issues BEGIN / COMMIT / ROLLBACK SQL directly on
+ *                the connection. Default for sync drivers (better-sqlite3,
+ *                bun:sqlite); also selected by `createLibsqlBackend` for
+ *                local `@libsql/client` connections (`file:` / `:memory:`),
+ *                whose `client.transaction()` permanently abandons the
+ *                current connection — fatal for an in-memory database.
  * - `"drizzle"`: Delegates to Drizzle's `db.transaction()` method.
- *                Default for async drivers (libsql, sql.js).
+ *                Default for async drivers (remote libsql/Turso, sql.js).
  * - `"do-sqlite"`: Delegates to the Cloudflare Durable Objects async
  *                storage transaction runner (`db.$client.transaction`,
  *                i.e. `ctx.storage.transaction(async ...)`). Drizzle's
@@ -801,6 +888,26 @@ type BackendCapabilities = Readonly<{
     transactions: boolean;
     /** Whether the backend supports SQL window functions such as ROW_NUMBER() */
     windowFunctions: boolean;
+    /**
+     * Whether the backend's `execute()` supports `UPDATE … RETURNING`. Absent or
+     * `true` means supported (every engine TypeGraph ships — SQLite ≥ 3.35,
+     * PostgreSQL ≥ 8.2 — supports it). A custom backend whose engine cannot run
+     * `RETURNING` must set this to `false` so recorded-time history capture
+     * (`history: true`), which relies on `UPDATE … RETURNING` on its hot path,
+     * is refused up front instead of failing mid-flush.
+     */
+    returning?: boolean;
+    /**
+     * Maximum number of bound parameters the engine accepts in one statement.
+     * SQLite defaults to 999 (raisable at compile time via
+     * `SQLITE_MAX_VARIABLE_NUMBER`); PostgreSQL's wire protocol caps it at 65535.
+     * Recorded-time capture and recorded point reads size their multi-row
+     * statements to this ceiling — the same budget the backend's own batched
+     * inserts use — instead of a conservative dialect-blind constant. A custom
+     * build that raises the SQLite limit can override this here. Absent means the
+     * recorded-time fallback budget applies.
+     */
+    maxBindParameters?: number;
     /** Vector search capabilities (undefined if not configured) */
     vector?: VectorCapabilities | undefined;
     /** Fulltext search capabilities (undefined if not configured) */
@@ -1327,20 +1434,6 @@ type TransactionOptions = Readonly<{
  * relational writes share one Postgres/SQLite transaction (#134).
  */
 type AdoptedTransaction = AnyPgDatabase | AnySqliteDatabase;
-/**
- * Transaction backend — a backend scoped to a transaction.
- *
- * `commitSchemaVersion` and `setActiveVersion` are intentionally omitted:
- * the atomicity / CAS guarantees of those primitives depend on
- * dialect-specific write-locking (BEGIN IMMEDIATE on SQLite,
- * `pg_advisory_xact_lock` on Postgres) acquired by the top-level
- * backend wrappers, not the transaction itself. Calling them from a
- * user-supplied `backend.transaction(...)` callback would bypass that
- * locking and silently weaken the orphan-row crash window the primitive
- * exists to eliminate. Schema commits go through the top-level backend
- * methods only.
- */
-type TransactionBackend = Omit<GraphBackend, "transaction" | "adoptTransaction" | "close" | "refreshStatistics" | "commitSchemaVersion" | "setActiveVersion">;
 /**
  * The GraphBackend interface abstracts database operations.
  *
@@ -1637,7 +1730,14 @@ type GraphBackend = Readonly<{
      * sizes this library is designed for.
      */
     refreshStatistics: () => Promise<void>;
-    execute: <T>(query: SQL) => Promise<readonly T[]>;
+    execute: <T>(query: CompiledRowsSql) => Promise<readonly T[]>;
+    /**
+     * Execute a non-row-returning SQL statement bound to this backend or
+     * transaction. Optional because custom backends may only expose the public
+     * row-returning query path; features that need statement execution must
+     * capability-check and fail loudly.
+     */
+    executeStatement?: (query: CompiledStatementSql) => Promise<void>;
     /** Execute pre-compiled SQL text with bound parameters. Available on sync SQLite and pg backends. */
     executeRaw?: <T>(sqlText: string, params: readonly unknown[]) => Promise<readonly T[]>;
     /** Compile a Drizzle SQL object to { sql, params } without executing. */
@@ -1699,6 +1799,39 @@ type GraphBackend = Readonly<{
     adoptTransaction?: (externalTx: AdoptedTransaction) => TransactionBackend;
     close: () => Promise<void>;
 }>;
+type BackendIdentity = Pick<GraphBackend, "dialect" | "capabilities" | "tableNames" | "fulltextStrategy" | "vectorStrategy">;
+type NodeEntityReadBackend = Pick<GraphBackend, "getNode" | "getNodes" | "findNodesByKind" | "countNodesByKind">;
+type NodeEntityWriteBackend = Pick<GraphBackend, "insertNode" | "insertNodeNoReturn" | "insertNodesBatch" | "insertNodesBatchReturning" | "updateNode" | "deleteNode" | "hardDeleteNode">;
+type EdgeEntityReadBackend = Pick<GraphBackend, "getEdge" | "getEdges" | "countEdgesFrom" | "edgeExistsBetween" | "findEdgesConnectedTo" | "findEdgesByKind" | "countEdgesByKind">;
+type EdgeEntityWriteBackend = Pick<GraphBackend, "insertEdge" | "insertEdgeNoReturn" | "insertEdgesBatch" | "insertEdgesBatchReturning" | "updateEdge" | "deleteEdge" | "hardDeleteEdge">;
+type GraphEntityReadBackend = NodeEntityReadBackend & EdgeEntityReadBackend;
+type GraphEntityWriteBackend = NodeEntityWriteBackend & EdgeEntityWriteBackend;
+type UniqueConstraintBackend = Pick<GraphBackend, "insertUnique" | "deleteUnique" | "checkUnique" | "checkUniqueBatch">;
+type SchemaReadBackend = Pick<GraphBackend, "getActiveSchema" | "getSchemaVersion">;
+type SchemaCommitBackend = Pick<GraphBackend, "commitSchemaVersion" | "setActiveVersion">;
+type VectorOperationBackend = Pick<GraphBackend, "upsertEmbedding" | "deleteEmbedding" | "vectorSearch" | "createVectorIndex" | "dropVectorIndex">;
+type FulltextOperationBackend = Pick<GraphBackend, "upsertFulltext" | "deleteFulltext" | "upsertFulltextBatch" | "deleteFulltextBatch" | "fulltextSearch">;
+type IndexMaterializationBackend = Pick<GraphBackend, "ensureIndexMaterializationsTable" | "getIndexMaterialization" | "getIndexMaterializations" | "recordIndexMaterialization">;
+type ContributionMaterializationBackend = Pick<GraphBackend, "ensureContributionMaterializationsTable" | "getContributionMaterialization" | "recordContributionMaterialization" | "assertRuntimeContributionsInitialized" | "ensureRuntimeContributions" | "ensureFulltextTable">;
+type RemovalMaterializationBackend = Pick<GraphBackend, "ensureKindRemovalsTable" | "getPendingKindRemovals" | "getAllKindRemovals" | "recordKindRemoval" | "ensureReconciliationMarkersTable" | "getReconciliationMarker" | "setReconciliationMarker">;
+type GraphLifecycleBackend = Pick<GraphBackend, "clearGraph" | "bootstrapTables">;
+type QueryExecutionBackend = Pick<GraphBackend, "execute">;
+type RawQueryExecutionBackend = Pick<GraphBackend, "executeRaw" | "compileSql">;
+type RawStatementExecutionBackend = Pick<GraphBackend, "executeStatement" | "executeDdl">;
+type BackendMaintenance = Pick<GraphBackend, "refreshStatistics">;
+type BackendTransactions = Pick<GraphBackend, "transaction" | "adoptTransaction">;
+type BackendLifecycle = Pick<GraphBackend, "close">;
+/**
+ * Transaction backend — a backend scoped to a transaction.
+ *
+ * This is an explicit facet composition, not `Omit<GraphBackend, ...>`.
+ * New top-level-only backend methods therefore do not silently appear on
+ * transaction-scoped backends. `commitSchemaVersion`, `setActiveVersion`,
+ * `refreshStatistics`, `transaction`, `adoptTransaction`, and `close` stay
+ * deliberately absent: their guarantees depend on the top-level backend or
+ * lifecycle owner rather than an already-open transaction.
+ */
+type TransactionBackend = Readonly<BackendIdentity & GraphEntityReadBackend & GraphEntityWriteBackend & UniqueConstraintBackend & SchemaReadBackend & VectorOperationBackend & FulltextOperationBackend & IndexMaterializationBackend & ContributionMaterializationBackend & RemovalMaterializationBackend & GraphLifecycleBackend & QueryExecutionBackend & RawQueryExecutionBackend & RawStatementExecutionBackend>;
 /**
  * Parameters for inserting a unique constraint entry.
  */
@@ -2330,6 +2463,8 @@ type QueryAst = Readonly<{
     predicates: readonly NodePredicate[];
     projection: Projection;
     temporalMode: TemporalOptions;
+    /** Recorded/system-time timestamp for recorded-pinned reads. */
+    recordedAsOf?: string;
     orderBy?: readonly OrderSpec[];
     limit?: number;
     offset?: number;
@@ -2618,4 +2753,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 FulltextBatchRow as $, type AnySqliteDatabase as A, type BackendCapabilities as B, type VectorIndexMetric as C, type VectorIndexParams as D, type EdgeIndexConfig as E, type FulltextStrategy as F, type GraphBackend as G, type SchemaVersionRow as H, type IndexDeclaration as I, type JsonPointer as J, type InferenceType as K, type AggregateExpr as L, type MetaEdge as M, type NodeIndexConfig as N, type OntologyRelation as O, type FieldRef as P, type QueryAst as Q, type RelationalIndexDeclaration as R, type SqliteExecutionProfileHints as S, type ComparisonOp as T, type AggregateComparisonPredicate as U, type VectorStrategy as V, type AdoptedTransaction as W, type CommitSchemaVersionExpected as X, type CommitSchemaVersionParams as Y, DEFAULT_SQL_SCHEMA as Z, type DeleteFulltextBatchParams as _, type SqliteTransactionMode as a, type FulltextCapabilities as a0, type FulltextQueryMode as a1, type FulltextSearchParams as a2, type FulltextSearchResult as a3, type HybridFusionOptions as a4, type JsonPointerFor as a5, type JsonPointerInput as a6, type JsonPointerSegment as a7, type JsonPointerSegments as a8, type JsonPointerSegmentsFor as a9, type ValueType as aA, type PredicateExpression as aB, type VectorMetricType as aC, type Traversal as aD, type NodePredicate as aE, type ProjectedField as aF, type GroupBySpec as aG, type RecursiveCyclePolicy as aH, type TraversalDirection as aI, type EdgeRow as aJ, type NodeRow as aK, type VectorSlotMap as aL, type SelectiveField as aM, type ComposableQuery as aN, type SetOperationType as aO, type SetOperation as aP, type VectorMetric as aQ, type TransactionOptions as aR, MAX_JSON_POINTER_DEPTH as aa, type MetaEdgeProperties as ab, type OrderSpec as ac, type ParameterRef as ad, type ResolveJsonPointer as ae, type ResolveJsonPointerSegments as af, type SetActiveVersionParams as ag, type SortDirection as ah, type SqlSchema as ai, type SqlTableNames as aj, type StrategyTableContribution as ak, type TableContribution as al, type TransactionBackend as am, type TraversalExpansion as an, type UpsertFulltextBatchParams as ao, type VectorCapabilities as ap, type VectorSlot as aq, buildVectorCapabilities as ar, createSqlSchema as as, fts5Strategy as at, isMetaEdge as au, joinJsonPointers as av, jsonPointer as aw, normalizeJsonPointer as ax, parseJsonPointer as ay, tsvectorStrategy as az, type AnyPgDatabase as b, type EdgeIndexDeclaration as c, type NodeIndexDeclaration as d, type IndexWhereExpression as e, type SerializedNodeDef as f, type SerializedEdgeDef as g, type SerializedMetaEdge as h, type SerializedOntologyRelation as i, type SerializedClosures as j, type SerializedSchema as k, type SchemaHash as l, type JsonSchema as m, type SerializedOntology as n, type SerializedUniqueConstraint as o, type SqlDialect as p, type EdgeIndexDirection as q, type EdgeIndexWhereBuilder as r, type IndexOrigin as s, type IndexScope as t, type IndexWhereFieldBuilder as u, type IndexWhereInput as v, type NodeIndexWhereBuilder as w, type SystemColumnName as x, type VectorIndexDeclaration as y, type VectorIndexImplementation as z };
+export { type BackendTransactions as $, type AnySqliteDatabase as A, type BackendCapabilities as B, type VectorIndexMetric as C, type VectorIndexParams as D, type EdgeIndexConfig as E, type FulltextStrategy as F, type GraphBackend as G, type SchemaVersionRow as H, type IndexDeclaration as I, type JsonPointer as J, type InferenceType as K, type AggregateExpr as L, type MetaEdge as M, type NodeIndexConfig as N, type OntologyRelation as O, type FieldRef as P, type QueryAst as Q, type RelationalIndexDeclaration as R, type SqliteExecutionProfileHints as S, type ComparisonOp as T, type AggregateComparisonPredicate as U, type VectorStrategy as V, type TraversalDirection as W, type AdoptedTransaction as X, type BackendIdentity as Y, type BackendLifecycle as Z, type BackendMaintenance as _, type SqliteTransactionMode as a, fts5Strategy as a$, type CommitSchemaVersionExpected as a0, type CommitSchemaVersionParams as a1, type CompiledRowsSql as a2, type CompiledSelectSql as a3, type CompiledStatementSql as a4, type ContributionMaterializationBackend as a5, DEFAULT_SQL_SCHEMA as a6, type DeleteFulltextBatchParams as a7, type EdgeEntityReadBackend as a8, type EdgeEntityWriteBackend as a9, type RawStatementExecutionBackend as aA, type RecordedRelationOptions as aB, type RemovalMaterializationBackend as aC, type ResolveJsonPointer as aD, type ResolveJsonPointerSegments as aE, type ResolvedSqlTableNames as aF, type SchemaCommitBackend as aG, type SchemaReadBackend as aH, type SetActiveVersionParams as aI, type SortDirection as aJ, type SqlIntent as aK, type SqlSchema as aL, type SqlTableNames as aM, type StrategyTableContribution as aN, type TableContribution as aO, type TransactionBackend as aP, type TraversalExpansion as aQ, type UniqueConstraintBackend as aR, type UpsertFulltextBatchParams as aS, type VectorCapabilities as aT, type VectorOperationBackend as aU, type VectorSlot as aV, asCompiledRowsSql as aW, asCompiledSelectSql as aX, asCompiledStatementSql as aY, buildVectorCapabilities as aZ, createSqlSchema as a_, type ExternalRecordedReadSource as aa, type FulltextBatchRow as ab, type FulltextCapabilities as ac, type FulltextOperationBackend as ad, type FulltextQueryMode as ae, type FulltextSearchParams as af, type FulltextSearchResult as ag, type GraphEntityReadBackend as ah, type GraphEntityWriteBackend as ai, type GraphLifecycleBackend as aj, type HybridFusionOptions as ak, type IndexMaterializationBackend as al, type IntentSql as am, type JsonPointerFor as an, type JsonPointerInput as ao, type JsonPointerSegment as ap, type JsonPointerSegments as aq, type JsonPointerSegmentsFor as ar, MAX_JSON_POINTER_DEPTH as as, type MetaEdgeProperties as at, type NodeEntityReadBackend as au, type NodeEntityWriteBackend as av, type OrderSpec as aw, type ParameterRef as ax, type QueryExecutionBackend as ay, type RawQueryExecutionBackend as az, type AnyPgDatabase as b, isMetaEdge as b0, joinJsonPointers as b1, jsonPointer as b2, normalizeJsonPointer as b3, parseJsonPointer as b4, recordedRelation as b5, tsvectorStrategy as b6, type ValueType as b7, type PredicateExpression as b8, type VectorMetricType as b9, type Traversal as ba, type NodePredicate as bb, type ProjectedField as bc, type GroupBySpec as bd, type RecursiveCyclePolicy as be, type EdgeRow as bf, type NodeRow as bg, type VectorSlotMap as bh, type RecordedReadBinding as bi, type SelectiveField as bj, type ComposableQuery as bk, type SetOperationType as bl, type SetOperation as bm, type VectorMetric as bn, type TransactionOptions as bo, type EdgeIndexDeclaration as c, type NodeIndexDeclaration as d, type IndexWhereExpression as e, type SerializedNodeDef as f, type SerializedEdgeDef as g, type SerializedMetaEdge as h, type SerializedOntologyRelation as i, type SerializedClosures as j, type SerializedSchema as k, type SchemaHash as l, type JsonSchema as m, type SerializedOntology as n, type SerializedUniqueConstraint as o, type SqlDialect as p, type EdgeIndexDirection as q, type EdgeIndexWhereBuilder as r, type IndexOrigin as s, type IndexScope as t, type IndexWhereFieldBuilder as u, type IndexWhereInput as v, type NodeIndexWhereBuilder as w, type SystemColumnName as x, type VectorIndexDeclaration as y, type VectorIndexImplementation as z };

package/dist/{where-Cx_glEEB.d.cts → where-DKjuofPr.d.cts}

@@ -1,5 +1,5 @@
-import { A as AnyEdgeType, N as NodeType } from './extension-types-D1k0inWU.cjs';
-import { E as EdgeIndexConfig, c as EdgeIndexDeclaration, N as NodeIndexConfig, d as NodeIndexDeclaration, e as IndexWhereExpression } from './types-Dvmn-eal.cjs';
+import { A as AnyEdgeType, N as NodeType } from './extension-types-YGFJPrzK.cjs';
+import { E as EdgeIndexConfig, c as EdgeIndexDeclaration, N as NodeIndexConfig, d as NodeIndexDeclaration, e as IndexWhereExpression } from './types-DkNnF-7K.cjs';
 
 declare function defineNodeIndex<N extends NodeType>(node: N, config: NodeIndexConfig<N>): NodeIndexDeclaration;
 declare function defineEdgeIndex<E extends AnyEdgeType>(edge: E, config: EdgeIndexConfig<E>): EdgeIndexDeclaration;

package/dist/{where-CHZFELX0.d.ts → where-DrUIIWHb.d.ts}

@@ -1,5 +1,5 @@
-import { A as AnyEdgeType, N as NodeType } from './extension-types-D1k0inWU.js';
-import { E as EdgeIndexConfig, c as EdgeIndexDeclaration, N as NodeIndexConfig, d as NodeIndexDeclaration, e as IndexWhereExpression } from './types-Dk8r09KY.js';
+import { A as AnyEdgeType, N as NodeType } from './extension-types-YGFJPrzK.js';
+import { E as EdgeIndexConfig, c as EdgeIndexDeclaration, N as NodeIndexConfig, d as NodeIndexDeclaration, e as IndexWhereExpression } from './types-D1Sqeyxy.js';
 
 declare function defineNodeIndex<N extends NodeType>(node: N, config: NodeIndexConfig<N>): NodeIndexDeclaration;
 declare function defineEdgeIndex<E extends AnyEdgeType>(edge: E, config: EdgeIndexConfig<E>): EdgeIndexDeclaration;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicia-ai/typegraph",
-  "version": "0.32.0",
+  "version": "0.34.0",
   "description": "TypeScript-first embedded knowledge graph library with ontological reasoning",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -42,6 +42,11 @@
       "import": "./dist/graph-merge/index.js",
       "require": "./dist/graph-merge/index.cjs"
     },
+    "./provenance": {
+      "types": "./dist/provenance/index.d.ts",
+      "import": "./dist/provenance/index.js",
+      "require": "./dist/provenance/index.cjs"
+    },
     "./sqlite": {
       "types": "./dist/backend/sqlite/index.d.ts",
       "import": "./dist/backend/sqlite/index.js",
@@ -187,6 +192,7 @@
     "test:postgres": "./scripts/test-postgres.sh",
     "test:do": "vitest run --config vitest.workers.config.ts",
     "test:coverage": "vitest run --coverage",
-    "test:mutation": "stryker run"
+    "test:mutation": "stryker run",
+    "test:mutation:critical": "stryker run stryker.critical.config.json"
   }
 }