@nicia-ai/typegraph 0.40.0 → 0.42.0

package/dist/materialize-indexes-DzMCetZe.d.cts

@@ -0,0 +1,258 @@
+import { y as SerializedNodeDef, z as SerializedEdgeDef, C as IndexEntity, I as IndexDeclaration, x as SerializedSchema } from './types-Dh-EgT-w.cjs';
+
+/**
+ * Schema migration utilities.
+ *
+ * Provides diff detection between schema versions to identify
+ * what has changed and what migrations might be needed.
+ */
+
+/**
+ * Types of changes that can occur in a schema.
+ */
+type ChangeType = "added" | "removed" | "modified" | "renamed";
+/**
+ * Severity of a change for migration purposes.
+ */
+type ChangeSeverity = "safe" | "warning" | "breaking";
+/**
+ * A change to a node definition.
+ */
+type NodeChange = Readonly<{
+    type: ChangeType;
+    kind: string;
+    severity: ChangeSeverity;
+    details: string;
+    before?: SerializedNodeDef | undefined;
+    after?: SerializedNodeDef | undefined;
+}>;
+/**
+ * A change to an edge definition.
+ */
+type EdgeChange = Readonly<{
+    type: ChangeType;
+    kind: string;
+    severity: ChangeSeverity;
+    details: string;
+    before?: SerializedEdgeDef | undefined;
+    after?: SerializedEdgeDef | undefined;
+}>;
+/**
+ * A change to the ontology.
+ */
+type OntologyChange = Readonly<{
+    type: ChangeType;
+    entity: "metaEdge" | "relation";
+    name: string;
+    severity: ChangeSeverity;
+    details: string;
+}>;
+/**
+ * A change to an index declaration.
+ *
+ * Index changes are always `safe`-severity: index DDL is materialized
+ * separately and never blocks schema-version commits or migrations.
+ * Adding, removing, or modifying an index never invalidates existing
+ * data — it only changes which physical indexes the deployment will
+ * materialize on its next pass.
+ */
+type IndexChange = Readonly<{
+    type: ChangeType;
+    /** Index name (the diffing identity key). */
+    name: string;
+    /**
+     * Whether this index is on a node, edge, or vector field. Vector
+     * index changes flow through the same diff classification as
+     * relational ones.
+     */
+    entity: IndexEntity;
+    severity: ChangeSeverity;
+    details: string;
+    before?: IndexDeclaration | undefined;
+    after?: IndexDeclaration | undefined;
+}>;
+/**
+ * A change to the persisted graph-extension document.
+ *
+ * Graph-extension document changes are committed only through the
+ * graph-extension lifecycle verbs (`evolve` and `removeKinds`), so the
+ * extension-slice change itself is `safe`-severity. The detailed
+ * per-kind effect is captured in the corresponding node/edge/ontology
+ * changes the merged document produced.
+ */
+type ExtensionChange = Readonly<{
+    type: ChangeType;
+    severity: ChangeSeverity;
+    details: string;
+}>;
+/**
+ * Change to the soft-deprecated kind set. `safe`-severity by
+ * construction — deprecation is a metadata signal that doesn't gate
+ * reads, writes, or queries. The `added` and `removed` arrays carry
+ * the per-name deltas so consumers can render granular diffs.
+ */
+type DeprecatedKindsChange = Readonly<{
+    added: readonly string[];
+    removed: readonly string[];
+    severity: ChangeSeverity;
+    details: string;
+}>;
+/**
+ * A complete diff between two schema versions.
+ */
+type SchemaDiff = Readonly<{
+    fromVersion: number;
+    toVersion: number;
+    /** Changes to node definitions */
+    nodes: readonly NodeChange[];
+    /** Changes to edge definitions */
+    edges: readonly EdgeChange[];
+    /** Changes to ontology */
+    ontology: readonly OntologyChange[];
+    /** Changes to index declarations */
+    indexes: readonly IndexChange[];
+    /**
+     * Change to the graph-extension document, if any. `undefined` when
+     * the slice is unchanged on both sides (the common case).
+     */
+    extension?: ExtensionChange;
+    /**
+     * Change to the soft-deprecated kind set, if any. `undefined` when
+     * the set is unchanged on both sides.
+     */
+    deprecatedKinds?: DeprecatedKindsChange;
+    /** Whether any breaking changes exist */
+    hasBreakingChanges: boolean;
+    /** Whether the change is backwards compatible (no breaking changes) */
+    isBackwardsCompatible: boolean;
+    /** Whether any changes exist at all */
+    hasChanges: boolean;
+    /** Summary of changes */
+    summary: string;
+}>;
+/**
+ * Computes the diff between two schema versions.
+ *
+ * @param before - The previous schema version
+ * @param after - The new schema version
+ * @returns A diff describing all changes
+ */
+declare function computeSchemaDiff(before: SerializedSchema, after: SerializedSchema): SchemaDiff;
+/**
+ * Checks if a schema change is backwards compatible.
+ *
+ * A change is backwards compatible if:
+ * - No nodes or edges were removed
+ * - No required properties were added
+ * - No existing properties were removed
+ */
+declare function isBackwardsCompatible(diff: SchemaDiff): boolean;
+/**
+ * How a proposed graph relates to the committed schema.
+ *
+ * - `identical` — a semantic no-op; committing it changes nothing.
+ * - `additive` — changes exist and are all backwards compatible.
+ * - `incompatible` — at least one breaking change; needs a deliberate
+ *   migration decision.
+ */
+type SchemaChangeClassification = "identical" | "additive" | "incompatible";
+/**
+ * Classifies a schema diff into the three outcomes a caller actually branches
+ * on. Pure — no I/O, no DDL. Pair with `getSchemaChanges(backend, graph)` (or
+ * `store.schemaChanges()`) to pre-flight a proposal *before* touching a
+ * privileged, migration-gated path.
+ */
+declare function classifySchemaChanges(diff: SchemaDiff): SchemaChangeClassification;
+/**
+ * Gets a list of actions needed for migration.
+ */
+declare function getMigrationActions(diff: SchemaDiff): readonly string[];
+
+/**
+ * Index materialization — runs declared index DDL against the live
+ * database and tracks per-deployment status in
+ * `typegraph_index_materializations`.
+ *
+ * Reads `IndexDeclaration[]` from `GraphDef.indexes`, generates DDL via
+ * `generateIndexDDL`, executes via `backend.executeDdl` (Postgres path
+ * uses `CREATE INDEX CONCURRENTLY`, which cannot run inside a
+ * transaction — `executeDdl` runs at the top-level backend, never inside
+ * `transaction(...)`), and upserts a status row per index.
+ *
+ * Caveats baked in to the algorithm:
+ *
+ * - SQL index names are physical, database-global identifiers.
+ *   Cross-graph collisions (two graphs declaring the same name with
+ *   different shapes) surface as a `failed` result with reason
+ *   "signature drift", because the existing recorded signature won't
+ *   match the new one.
+ * - On Postgres, `CREATE INDEX CONCURRENTLY IF NOT EXISTS` does NOT
+ *   prove the existing physical index has the same shape as ours —
+ *   only that something with that name exists. Drift detection here
+ *   relies on TypeGraph's recorded signature, not on PG metadata.
+ * - Failed `CONCURRENTLY` builds leave invalid indexes behind
+ *   (`pg_index.indisvalid = false`). Relational rebuilds self-heal: the
+ *   claim-holding materializer drops an invalid leftover with the
+ *   declaration's name before rebuilding (see dropInvalidIndexLeftover).
+ *   Vector per-field index leftovers remain operator-repair.
+ * - Two materializers racing the SAME index name serialize through a
+ *   durable claim in the status table (see materializeWithClaim) —
+ *   concurrent same-name expression-index CIC builds deadlock on
+ *   Postgres (no safe-snapshot exemption).
+ */
+
+type MaterializeIndexesOptions = Readonly<{
+    /** Restrict to indexes whose `kind` is in this set. */
+    kinds?: readonly string[];
+    /** Stop on the first failure. Default: false (best-effort). */
+    stopOnError?: boolean;
+    /**
+     * Refresh planner statistics (ANALYZE) after at least one index was
+     * created. A fresh index can be ignored by the planner until statistics
+     * exist. Default: true. Applied on non-concurrent builders (SQLite) and
+     * on concurrent builders that serialize same-index builds via the
+     * cross-caller claim primitive (the bundled Postgres backend); a custom
+     * concurrent backend without the primitive skips the refresh — see
+     * refreshStatisticsAfterCreation — and should call
+     * `store.refreshStatistics()` after materializing.
+     */
+    refreshStatistics?: boolean;
+}>;
+/**
+ * Per-index outcome from `materializeIndexes()`.
+ *
+ * Status values:
+ * - `created`: DDL ran successfully and a new physical index now exists.
+ * - `alreadyMaterialized`: status table shows a prior successful
+ *   materialization with the same signature; no DDL ran.
+ * - `failed`: the DDL or status write failed; `error` carries the
+ *   captured exception. Best-effort mode continues to the next index;
+ *   `stopOnError: true` halts.
+ * - `skipped`: the backend can't materialize this index variant in its
+ *   current configuration (e.g. vector indexes against SQLite without
+ *   sqlite-vec, or `indexType: "none"` declared on an embedding). The
+ *   declaration is recognized but intentionally not acted on. Status
+ *   table is NOT updated for skipped entries.
+ */
+type MaterializeIndexesEntry = Readonly<{
+    indexName: string;
+    entity: IndexEntity;
+    kind: string;
+    status: "created" | "alreadyMaterialized" | "failed" | "skipped";
+    error?: Error;
+    /**
+     * Human-readable reason. Required for `skipped`; optional otherwise.
+     */
+    reason?: string;
+}>;
+type MaterializeIndexesResult = Readonly<{
+    results: readonly MaterializeIndexesEntry[];
+}>;
+type MaterializeSystemIndexesOptions = Readonly<{
+    /** Stop on the first failure. Default: false (best-effort). */
+    stopOnError?: boolean;
+    /** Refresh planner statistics after a creation. Default: true. */
+    refreshStatistics?: boolean;
+}>;
+
+export { type ChangeSeverity as C, type DeprecatedKindsChange as D, type EdgeChange as E, type IndexChange as I, type MaterializeIndexesResult as M, type NodeChange as N, type OntologyChange as O, type SchemaDiff as S, type ChangeType as a, type ExtensionChange as b, type SchemaChangeClassification as c, classifySchemaChanges as d, computeSchemaDiff as e, type MaterializeIndexesEntry as f, getMigrationActions as g, type MaterializeIndexesOptions as h, isBackwardsCompatible as i, type MaterializeSystemIndexesOptions as j };

package/dist/{postgres-Bm4DyFQU.d.cts → postgres-C5-WMKFA.d.ts}

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

package/dist/{postgres-DtaVALOZ.d.ts → postgres-DpJqtbSX.d.cts}

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

package/dist/profiler/index.d.cts

@@ -1,14 +1,13 @@
-import { G as GraphDef } from '../define-graph-Cv3CFwKm.cjs';
-import { Q as QueryAst } from '../types-C5pZeKTl.cjs';
-import { a as Store } from '../store-view-C-buB8Q8.cjs';
-import { P as ProfilerOptions, a as ProfileReport } from '../types-CqSfMRW3.cjs';
-export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-CqSfMRW3.cjs';
-import '../extension-types-BLEVH4SG.cjs';
+import { G as GraphDef } from '../define-graph-Byslw2OO.cjs';
+import { Q as QueryAst } from '../types-Dh-EgT-w.cjs';
+import { a as Store } from '../store-view-CNcOG8bQ.cjs';
+import { P as ProfilerOptions, a as ProfileReport } from '../types-G4sVM-76.cjs';
+export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-G4sVM-76.cjs';
 import 'zod';
-import '../temporal-Dn_JADWY.cjs';
-import '../manager-mqee5MVB.cjs';
-import '../searchable-BxlJQVFw.cjs';
-import '../materialize-indexes-ExQ6OrAh.cjs';
+import '../temporal-CMpigMCW.cjs';
+import '../manager-U9_zopqr.cjs';
+import '../materialize-indexes-DzMCetZe.cjs';
+import '../searchable-B4mUXZT6.cjs';
 
 /**
  * A Store with profiling capabilities.

package/dist/profiler/index.d.ts

@@ -1,14 +1,13 @@
-import { G as GraphDef } from '../define-graph-DQnj3fNH.js';
-import { Q as QueryAst } from '../types-D8szWDUo.js';
-import { a as Store } from '../store-view-CagdeyNn.js';
-import { P as ProfilerOptions, a as ProfileReport } from '../types-CYdXzZef.js';
-export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-CYdXzZef.js';
-import '../extension-types-BLEVH4SG.js';
+import { G as GraphDef } from '../define-graph-DBFnc7u_.js';
+import { Q as QueryAst } from '../types-Dh-EgT-w.js';
+import { a as Store } from '../store-view-6C2vTWqf.js';
+import { P as ProfilerOptions, a as ProfileReport } from '../types-D2rU5Taq.js';
+export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-D2rU5Taq.js';
 import 'zod';
-import '../temporal-CyFsSPe8.js';
-import '../manager-DjE6Mhag.js';
-import '../searchable-ChJ29MCd.js';
-import '../materialize-indexes-D4iei4Kp.js';
+import '../temporal-BtrTYTiB.js';
+import '../manager-Dl0-er1G.js';
+import '../materialize-indexes-BM3u0aXE.js';
+import '../searchable-C7jmPNLT.js';
 
 /**
  * A Store with profiling capabilities.

package/dist/provenance/index.cjs

@@ -1,20 +1,20 @@
 'use strict';
 
-var chunkTRF4EBJT_cjs = require('../chunk-TRF4EBJT.cjs');
-var chunkUCHW2MGP_cjs = require('../chunk-UCHW2MGP.cjs');
+var chunk2SO5I5AI_cjs = require('../chunk-2SO5I5AI.cjs');
 require('../chunk-ZDH3DX3C.cjs');
-require('../chunk-JZYMOHHM.cjs');
-var chunkQYDUCWD2_cjs = require('../chunk-QYDUCWD2.cjs');
-require('../chunk-LL5D5T5W.cjs');
-require('../chunk-HP6LWBLB.cjs');
-var chunkMNURF4RF_cjs = require('../chunk-MNURF4RF.cjs');
+require('../chunk-CVK4T34X.cjs');
+var chunkECU53PMN_cjs = require('../chunk-ECU53PMN.cjs');
+require('../chunk-FSCJOTHF.cjs');
+var chunkTRF4EBJT_cjs = require('../chunk-TRF4EBJT.cjs');
+require('../chunk-AO2WPYFZ.cjs');
+var chunkZBV4LQD2_cjs = require('../chunk-ZBV4LQD2.cjs');
 require('../chunk-NAUA4PW5.cjs');
-require('../chunk-YX3H63VV.cjs');
+require('../chunk-X2XOQZT3.cjs');
 require('../chunk-SJDMVITW.cjs');
 require('../chunk-764JHTLT.cjs');
 require('../chunk-HAHNRASW.cjs');
 var chunkDI74SMXS_cjs = require('../chunk-DI74SMXS.cjs');
-var chunkSAFZ6JTI_cjs = require('../chunk-SAFZ6JTI.cjs');
+var chunkKTBTSHU6_cjs = require('../chunk-KTBTSHU6.cjs');
 require('../chunk-TDXIBCGY.cjs');
 
 // src/provenance/index.ts
@@ -35,7 +35,7 @@ function edgeToKey(edge) {
 function keyToRef(key) {
   const separatorIndex = key.indexOf(KEY_SEPARATOR);
   if (separatorIndex === -1) {
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       "Invalid provenance identity key.",
       { key },
       {
@@ -51,9 +51,9 @@ function sortedReferences(keys) {
   return [...keys].toSorted((left, right) => chunkTRF4EBJT_cjs.compareStrings(left, right)).map((key) => keyToRef(key));
 }
 function parseNodeProps(row) {
-  const parsed = chunkQYDUCWD2_cjs.rowPropsToObject(row.props);
+  const parsed = chunkECU53PMN_cjs.rowPropsToObject(row.props);
   if (!chunkDI74SMXS_cjs.isPlainObject(parsed)) {
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       `Node ${row.kind}/${row.id} props are not an object.`,
       { kind: row.kind, id: row.id }
     );
@@ -65,7 +65,7 @@ function sourceRetractedState(row, retractedField) {
   const value = props[retractedField];
   if (value === void 0) return "available";
   if (typeof value !== "boolean") {
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       `Provenance source field "${retractedField}" must contain a boolean value.`,
       { kind: row.kind, id: row.id, field: retractedField },
       {
@@ -83,26 +83,26 @@ function normalizeConfig(graph, config) {
   const derivesKind = config.derives.kind;
   const retractedField = config.source.retractedField ?? DEFAULT_RETRACTED_FIELD;
   if (sourceKinds.length === 0) {
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       "Provenance retraction requires at least one source kind.",
       { role: "source" }
     );
   }
   if (factKinds.length === 0) {
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       "Provenance retraction requires at least one fact kind.",
       { role: "fact" }
     );
   }
   const duplicateSourceKinds = duplicateValues(sourceKinds);
   if (duplicateSourceKinds.length > 0) {
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError("Provenance source kinds must be unique.", {
+    throw new chunkKTBTSHU6_cjs.ConfigurationError("Provenance source kinds must be unique.", {
       duplicateSourceKinds
     });
   }
   const duplicateFactKinds = duplicateValues(factKinds);
   if (duplicateFactKinds.length > 0) {
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError("Provenance fact kinds must be unique.", {
+    throw new chunkKTBTSHU6_cjs.ConfigurationError("Provenance fact kinds must be unique.", {
       duplicateFactKinds
     });
   }
@@ -120,7 +120,7 @@ function normalizeConfig(graph, config) {
   if (factKinds.some(
     (kind) => sourceKinds.includes(kind) || kind === justificationKind
   )) {
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       "Provenance fact kinds must be distinct from source and justification kinds.",
       { sourceKinds, justificationKind, factKinds }
     );
@@ -162,7 +162,7 @@ function duplicateValues(values) {
 }
 function assertKind(records, kind, role, noun, graphId) {
   if (Object.hasOwn(records, kind)) return;
-  throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+  throw new chunkKTBTSHU6_cjs.ConfigurationError(
     `Provenance ${role} kind "${kind}" is not a ${noun} kind in this graph.`,
     { role, kind, graphId }
   );
@@ -171,7 +171,7 @@ function assertSourceField(graph, sourceKind, retractedField) {
   const registration = graph.nodes[sourceKind];
   if (registration === void 0) return;
   if (Object.hasOwn(registration.type.schema.shape, retractedField)) return;
-  throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+  throw new chunkKTBTSHU6_cjs.ConfigurationError(
     `Provenance source kind "${sourceKind}" must include field "${retractedField}".`,
     { sourceKind, retractedField },
     {
@@ -186,14 +186,14 @@ function assertEdgeEndpoints(graph, edgeKind, expected) {
   const toKinds = new Set(registration.to.map((node) => node.kind));
   for (const kind of expected.fromKinds) {
     if (fromKinds.has(kind)) continue;
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       `Provenance ${expected.role} edge "${edgeKind}" cannot start at "${kind}".`,
       { edgeKind, role: expected.role, expectedFrom: kind }
     );
   }
   for (const kind of expected.toKinds) {
     if (toKinds.has(kind)) continue;
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       `Provenance ${expected.role} edge "${edgeKind}" cannot end at "${kind}".`,
       { edgeKind, role: expected.role, expectedTo: kind }
     );
@@ -299,7 +299,7 @@ function buildSupportEdges(config, rows) {
   };
 }
 async function loadSupportGraph(backend, graphId, config) {
-  const asOf = chunkMNURF4RF_cjs.nowIso();
+  const asOf = chunkZBV4LQD2_cjs.nowIso();
   const roles = await readRoles(backend, graphId, config, asOf);
   const supportEdges = buildSupportEdges(config, roles);
   const sourceRowsByKind = await Promise.all(
@@ -430,21 +430,21 @@ async function synchronizeFactCurrency(backend, store, runHooks, snapshot, affec
     snapshot,
     affected,
     (key) => !snapshot.supportedFactKeys.has(key),
-    chunkQYDUCWD2_cjs.isLiveNodeRow,
+    chunkECU53PMN_cjs.isLiveNodeRow,
     (row) => closeFactCurrency(backend, store, runHooks, row, lock)
   );
   await forEachAffectedFact(
     snapshot,
     affected,
     (key) => snapshot.supportedFactKeys.has(key),
-    chunkQYDUCWD2_cjs.isTombstonedNodeRow,
+    chunkECU53PMN_cjs.isTombstonedNodeRow,
     (row) => reopenFactCurrency(backend, store, runHooks, row, lock)
   );
 }
 function getFactRegistration(store, row) {
   const registration = store.graph.nodes[row.kind];
   if (registration !== void 0) return registration;
-  throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+  throw new chunkKTBTSHU6_cjs.ConfigurationError(
     `Provenance fact kind "${row.kind}" is not a node kind in this graph.`,
     { kind: row.kind, graphId: store.graphId }
   );
@@ -452,8 +452,8 @@ function getFactRegistration(store, row) {
 async function closeFactCurrency(backend, store, runHooks, row, lock) {
   await runHooks("delete", row.kind, row.id, async () => {
     const registration = getFactRegistration(store, row);
-    await chunkUCHW2MGP_cjs.applyNodeSoftDelete(
-      chunkUCHW2MGP_cjs.createNodeWriteContext(store.graphId, store.registry, lock),
+    await chunk2SO5I5AI_cjs.applyNodeSoftDelete(
+      chunk2SO5I5AI_cjs.createNodeWriteContext(store.graphId, store.registry, lock),
       {
         existing: row,
         schema: registration.type.schema,
@@ -468,8 +468,8 @@ async function closeFactCurrency(backend, store, runHooks, row, lock) {
 async function reopenFactCurrency(backend, store, runHooks, row, lock) {
   await runHooks("update", row.kind, row.id, async () => {
     const registration = getFactRegistration(store, row);
-    await chunkUCHW2MGP_cjs.applyNodeResurrect(
-      chunkUCHW2MGP_cjs.createNodeWriteContext(store.graphId, store.registry, lock),
+    await chunk2SO5I5AI_cjs.applyNodeResurrect(
+      chunk2SO5I5AI_cjs.createNodeWriteContext(store.graphId, store.registry, lock),
       {
         existing: row,
         schema: registration.type.schema,
@@ -482,7 +482,7 @@ async function reopenFactCurrency(backend, store, runHooks, row, lock) {
 function getTransactionNodeCollection(tx, kind) {
   const collection = tx.getNodeCollection(kind);
   if (collection !== void 0) return collection;
-  throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+  throw new chunkKTBTSHU6_cjs.ConfigurationError(
     `Provenance source kind "${kind}" is not available on this transaction.`,
     { kind }
   );
@@ -495,14 +495,14 @@ async function runTransition(store, config, sources, retracted) {
   const uniqueSources = uniqueNodeReferences(sources);
   for (const source of uniqueSources) {
     if (config.sourceKinds.includes(source.kind)) continue;
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       `Provenance retraction source must be one of: ${config.sourceKinds.join(", ")}.`,
       { expectedKinds: config.sourceKinds, actualKind: source.kind }
     );
   }
   return store.transaction(async (tx) => {
-    const backend = chunkUCHW2MGP_cjs.transactionBackend(tx);
-    const lock = await chunkUCHW2MGP_cjs.lockRecordedGraphWrite(backend, store.graphId);
+    const backend = chunk2SO5I5AI_cjs.transactionBackend(tx);
+    const lock = await chunk2SO5I5AI_cjs.lockRecordedGraphWrite(backend, store.graphId);
     const rows = await Promise.all(
       uniqueSources.map(
         (source) => backend.getNode(store.graphId, source.kind, source.id)
@@ -511,7 +511,7 @@ async function runTransition(store, config, sources, retracted) {
     const sourceRows = uniqueSources.map((source, index) => {
       const sourceRow = rows[index];
       if (sourceRow === void 0 || sourceRow.deleted_at !== void 0) {
-        throw new chunkSAFZ6JTI_cjs.NodeNotFoundError(source.kind, source.id);
+        throw new chunkKTBTSHU6_cjs.NodeNotFoundError(source.kind, source.id);
       }
       return { source, row: sourceRow };
     });
@@ -538,7 +538,7 @@ async function runTransition(store, config, sources, retracted) {
     await synchronizeFactCurrency(
       backend,
       store,
-      chunkUCHW2MGP_cjs.transactionNodeOperationHookRunner(tx),
+      chunk2SO5I5AI_cjs.transactionNodeOperationHookRunner(tx),
       after,
       affected,
       lock
@@ -564,8 +564,8 @@ function createRetractionCapability(store, config) {
     unRetractMany: (sources) => transition(sources, false),
     async holding() {
       return store.transaction(async (tx) => {
-        const backend = chunkUCHW2MGP_cjs.transactionBackend(tx);
-        await chunkUCHW2MGP_cjs.lockRecordedGraphWrite(backend, store.graphId);
+        const backend = chunk2SO5I5AI_cjs.transactionBackend(tx);
+        await chunk2SO5I5AI_cjs.lockRecordedGraphWrite(backend, store.graphId);
         const snapshot = await computeSupport(
           backend,
           store.graphId,
@@ -580,7 +580,7 @@ function createRetractionCapability(store, config) {
 }
 function assertRetractionHistoryEnabled(store) {
   if (!store.historyEnabled) {
-    throw new chunkSAFZ6JTI_cjs.ConfigurationError(
+    throw new chunkKTBTSHU6_cjs.ConfigurationError(
       "createRetractionCapability requires a store created with { history: true }.",
       { graphId: store.graphId },
       {

package/dist/provenance/index.d.cts

@@ -1,12 +1,11 @@
-import { G as GraphDef } from '../define-graph-Cv3CFwKm.cjs';
-import { b as HistoryStore } from '../store-view-C-buB8Q8.cjs';
-import '../extension-types-BLEVH4SG.cjs';
+import { G as GraphDef } from '../define-graph-Byslw2OO.cjs';
+import { b as HistoryStore } from '../store-view-CNcOG8bQ.cjs';
+import '../types-Dh-EgT-w.cjs';
 import 'zod';
-import '../types-C5pZeKTl.cjs';
-import '../temporal-Dn_JADWY.cjs';
-import '../manager-mqee5MVB.cjs';
-import '../searchable-BxlJQVFw.cjs';
-import '../materialize-indexes-ExQ6OrAh.cjs';
+import '../temporal-CMpigMCW.cjs';
+import '../manager-U9_zopqr.cjs';
+import '../materialize-indexes-DzMCetZe.cjs';
+import '../searchable-B4mUXZT6.cjs';
 
 type NodeKind<G extends GraphDef> = Extract<keyof G["nodes"], string>;
 type EdgeKind<G extends GraphDef> = Extract<keyof G["edges"], string>;

package/dist/provenance/index.d.ts

@@ -1,12 +1,11 @@
-import { G as GraphDef } from '../define-graph-DQnj3fNH.js';
-import { b as HistoryStore } from '../store-view-CagdeyNn.js';
-import '../extension-types-BLEVH4SG.js';
+import { G as GraphDef } from '../define-graph-DBFnc7u_.js';
+import { b as HistoryStore } from '../store-view-6C2vTWqf.js';
+import '../types-Dh-EgT-w.js';
 import 'zod';
-import '../types-D8szWDUo.js';
-import '../temporal-CyFsSPe8.js';
-import '../manager-DjE6Mhag.js';
-import '../searchable-ChJ29MCd.js';
-import '../materialize-indexes-D4iei4Kp.js';
+import '../temporal-BtrTYTiB.js';
+import '../manager-Dl0-er1G.js';
+import '../materialize-indexes-BM3u0aXE.js';
+import '../searchable-C7jmPNLT.js';
 
 type NodeKind<G extends GraphDef> = Extract<keyof G["nodes"], string>;
 type EdgeKind<G extends GraphDef> = Extract<keyof G["edges"], string>;

package/dist/provenance/index.js

@@ -1,18 +1,18 @@
-import { compareStrings } from '../chunk-DRACN6XG.js';
-import { transactionBackend, lockRecordedGraphWrite, transactionNodeOperationHookRunner, applyNodeSoftDelete, createNodeWriteContext, applyNodeResurrect } from '../chunk-JHK6NPFV.js';
+import { transactionBackend, lockRecordedGraphWrite, transactionNodeOperationHookRunner, applyNodeSoftDelete, createNodeWriteContext, applyNodeResurrect } from '../chunk-EVFL2ZY5.js';
 import '../chunk-35S6P5ZU.js';
-import '../chunk-YYLMXERH.js';
-import { rowPropsToObject, isLiveNodeRow, isTombstonedNodeRow } from '../chunk-L5ET7FYQ.js';
-import '../chunk-QOHTVDHU.js';
-import '../chunk-UUIBACKJ.js';
-import { nowIso } from '../chunk-3SHAUJRB.js';
+import '../chunk-CDYRPI5U.js';
+import { rowPropsToObject, isLiveNodeRow, isTombstonedNodeRow } from '../chunk-UZLEQFTV.js';
+import '../chunk-2OOY4OYT.js';
+import { compareStrings } from '../chunk-DRACN6XG.js';
+import '../chunk-CUPJL6TS.js';
+import { nowIso } from '../chunk-GT7NEXSU.js';
 import '../chunk-2EBMPJBO.js';
-import '../chunk-6N7QBIWN.js';
+import '../chunk-M4GYQF2H.js';
 import '../chunk-SNXVDZAJ.js';
 import '../chunk-QMQLUA66.js';
 import '../chunk-PC2UBAUB.js';
 import { isPlainObject } from '../chunk-ITE4IXAK.js';
-import { ConfigurationError, NodeNotFoundError } from '../chunk-DPNA466P.js';
+import { ConfigurationError, NodeNotFoundError } from '../chunk-OYJSYDIH.js';
 import '../chunk-G6Q5UM7U.js';
 
 // src/provenance/index.ts