@nicia-ai/typegraph 0.46.2 → 0.48.0

package/dist/{chunk-BQM5P2NO.cjs → chunk-JB6T4GLL.cjs}

@@ -1,18 +1,19 @@
 'use strict';
 
-var chunk32UETY6S_cjs = require('./chunk-32UETY6S.cjs');
-var chunkQPOQX2DI_cjs = require('./chunk-QPOQX2DI.cjs');
-var chunkA4R3H7RU_cjs = require('./chunk-A4R3H7RU.cjs');
+var chunk3KOY4FH3_cjs = require('./chunk-3KOY4FH3.cjs');
+var chunkJFRT7S3B_cjs = require('./chunk-JFRT7S3B.cjs');
+var chunkEZEEWCFJ_cjs = require('./chunk-EZEEWCFJ.cjs');
 var chunkPWLJ77UV_cjs = require('./chunk-PWLJ77UV.cjs');
-var chunkQU7QLJA4_cjs = require('./chunk-QU7QLJA4.cjs');
-var chunkANKOXPCC_cjs = require('./chunk-ANKOXPCC.cjs');
-var chunkZBVZ7HXD_cjs = require('./chunk-ZBVZ7HXD.cjs');
-var chunk5PDSCELM_cjs = require('./chunk-5PDSCELM.cjs');
-var chunkZHOAZD7Q_cjs = require('./chunk-ZHOAZD7Q.cjs');
-var chunk2ZWM2RFH_cjs = require('./chunk-2ZWM2RFH.cjs');
+var chunkSIT26LAZ_cjs = require('./chunk-SIT26LAZ.cjs');
+var chunk3U5ABFDW_cjs = require('./chunk-3U5ABFDW.cjs');
+var chunk5PRKMB24_cjs = require('./chunk-5PRKMB24.cjs');
+var chunkFQPEMEWX_cjs = require('./chunk-FQPEMEWX.cjs');
+var chunkTQHGE7UC_cjs = require('./chunk-TQHGE7UC.cjs');
+var chunkL3LQNR34_cjs = require('./chunk-L3LQNR34.cjs');
+var chunkEDN4Y4ZG_cjs = require('./chunk-EDN4Y4ZG.cjs');
 var chunkHAHNRASW_cjs = require('./chunk-HAHNRASW.cjs');
-var chunkD6GCNNMK_cjs = require('./chunk-D6GCNNMK.cjs');
-var chunkKCH7WQA5_cjs = require('./chunk-KCH7WQA5.cjs');
+var chunk6NGW27EO_cjs = require('./chunk-6NGW27EO.cjs');
+var chunkMRDBBHIZ_cjs = require('./chunk-MRDBBHIZ.cjs');
 var chunkA7J2YDDI_cjs = require('./chunk-A7J2YDDI.cjs');
 var chunkN66HCGCY_cjs = require('./chunk-N66HCGCY.cjs');
 
@@ -21,8 +22,8 @@ function nullToUndefined(value) {
   return value === null ? void 0 : value;
 }
 function rowToNode(row) {
-  const rawProps = chunkANKOXPCC_cjs.rowPropsToObject(row.props);
-  const props = chunkD6GCNNMK_cjs.filterReservedKeys(rawProps, chunkD6GCNNMK_cjs.RESERVED_NODE_KEYS);
+  const rawProps = chunk5PRKMB24_cjs.rowPropsToObject(row.props);
+  const props = chunk6NGW27EO_cjs.filterReservedKeys(rawProps, chunk6NGW27EO_cjs.RESERVED_NODE_KEYS);
   return {
     kind: row.kind,
     id: row.id,
@@ -41,8 +42,8 @@ function rowToNodeMeta(row) {
   };
 }
 function rowToEdge(row) {
-  const rawProps = chunkANKOXPCC_cjs.rowPropsToObject(row.props);
-  const props = chunkD6GCNNMK_cjs.filterReservedKeys(rawProps, chunkD6GCNNMK_cjs.RESERVED_EDGE_KEYS);
+  const rawProps = chunk5PRKMB24_cjs.rowPropsToObject(row.props);
+  const props = chunk6NGW27EO_cjs.filterReservedKeys(rawProps, chunk6NGW27EO_cjs.RESERVED_EDGE_KEYS);
   return {
     id: row.id,
     kind: row.kind,
@@ -73,7 +74,7 @@ function nodeWriteNeedsConstraintFence(registry, kind, uniqueConstraints, operat
     return "nodeDisjointness";
   }
   const sharedScope = uniqueConstraints.some(
-    (constraint) => chunkZBVZ7HXD_cjs.getKindsForUniquenessCheck(kind, constraint.scope, registry).length > 1
+    (constraint) => chunkFQPEMEWX_cjs.getKindsForUniquenessCheck(kind, constraint.scope, registry).length > 1
   );
   return sharedScope ? "nodeUniquenessScope" : void 0;
 }
@@ -82,7 +83,7 @@ async function checkDisjointnessConstraint(ctx, kind, id) {
   for (const disjointKind of disjointKinds) {
     const existing = await ctx.backend.getNode(ctx.graphId, disjointKind, id);
     if (existing && !existing.deleted_at) {
-      const error = chunkZBVZ7HXD_cjs.checkDisjointness(id, kind, [disjointKind], ctx.registry);
+      const error = chunkFQPEMEWX_cjs.checkDisjointness(id, kind, [disjointKind], ctx.registry);
       if (error) throw error;
     }
   }
@@ -99,7 +100,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         fromKind,
         fromId
       });
-      const error = chunkZBVZ7HXD_cjs.checkCardinality(
+      const error = chunkFQPEMEWX_cjs.checkCardinality(
         edgeKind,
         fromKind,
         fromId,
@@ -119,7 +120,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         toKind,
         toId
       });
-      const error = chunkZBVZ7HXD_cjs.checkUniqueEdge(
+      const error = chunkFQPEMEWX_cjs.checkUniqueEdge(
         edgeKind,
         fromKind,
         fromId,
@@ -141,7 +142,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         fromId,
         activeOnly: true
       });
-      const error = chunkZBVZ7HXD_cjs.checkCardinality(
+      const error = chunkFQPEMEWX_cjs.checkCardinality(
         edgeKind,
         fromKind,
         fromId,
@@ -155,6 +156,38 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
   }
 }
 
+// src/store/validity-end.ts
+function assertValidityEndMutation(input, context) {
+  if (input.validTo === void 0 || input.clearValidTo !== true) return;
+  throw new chunkMRDBBHIZ_cjs.ValidationError(
+    '"validTo" and "clearValidTo" are mutually exclusive',
+    {
+      ...context,
+      operation: "update",
+      issues: [
+        {
+          path: "clearValidTo",
+          message: 'Pass either "validTo" or "clearValidTo", not both'
+        }
+      ]
+    }
+  );
+}
+function validityEndAfterMutation(input, current) {
+  if (input.clearValidTo === true) return void 0;
+  return input.validTo ?? current;
+}
+function assertClearValidToSupported(backend, entityType) {
+  if (backend.capabilities.clearValidTo === true) return;
+  throw new chunkMRDBBHIZ_cjs.ConfigurationError(
+    `This backend does not support clearing ${entityType} validTo`,
+    {
+      code: "CLEAR_VALID_TO_UNSUPPORTED",
+      entityType
+    }
+  );
+}
+
 // src/store/operations/already-exists.ts
 var ENTITY_LABELS = {
   node: { title: "Node", article: "A node" },
@@ -162,7 +195,7 @@ var ENTITY_LABELS = {
 };
 function alreadyExistsError(entity, kind, id, detail, cause) {
   const label = ENTITY_LABELS[entity];
-  return new chunkKCH7WQA5_cjs.ValidationError(
+  return new chunkMRDBBHIZ_cjs.ValidationError(
     `${label.title} already exists: ${detail}`,
     {
       entityType: entity,
@@ -172,7 +205,7 @@ function alreadyExistsError(entity, kind, id, detail, cause) {
       issues: [
         {
           path: "id",
-          code: chunkKCH7WQA5_cjs.ENTITY_ALREADY_EXISTS_CODE,
+          code: chunkMRDBBHIZ_cjs.ENTITY_ALREADY_EXISTS_CODE,
           message: `${label.article} with this ID already exists`
         }
       ]
@@ -187,7 +220,7 @@ function createAlreadyExistsError(entity, kind, id) {
   return alreadyExistsError(entity, kind, id, `${kind}/${id}`, void 0);
 }
 function isDuplicateKeyInsertError(error, entity) {
-  return error instanceof chunkKCH7WQA5_cjs.DatabaseOperationError && error.details.operation === "insert" && error.details.entity === entity && error.details.reason === "duplicate_key";
+  return error instanceof chunkMRDBBHIZ_cjs.DatabaseOperationError && error.details.operation === "insert" && error.details.entity === entity && error.details.reason === "duplicate_key";
 }
 function rethrowAsAlreadyExists(error, entity) {
   if (!isDuplicateKeyInsertError(error, entity)) throw error;
@@ -221,9 +254,9 @@ async function withAlreadyExistsTranslation(entity, run) {
 
 // src/store/operations/node-operations.ts
 function getNodeRegistration(graph, kind) {
-  if (!chunkN66HCGCY_cjs.hasOwnKey(graph.nodes, kind)) throw new chunkKCH7WQA5_cjs.KindNotFoundError(kind, "node");
+  if (!chunkN66HCGCY_cjs.hasOwnKey(graph.nodes, kind)) throw new chunkMRDBBHIZ_cjs.KindNotFoundError(kind, "node");
   const registration = graph.nodes[kind];
-  if (registration === void 0) throw new chunkKCH7WQA5_cjs.KindNotFoundError(kind, "node");
+  if (registration === void 0) throw new chunkMRDBBHIZ_cjs.KindNotFoundError(kind, "node");
   return registration;
 }
 function nodeFencesConstraintProbe(ctx, kind, operation) {
@@ -243,10 +276,10 @@ function nodeBatchFencesConstraintProbe(ctx, inputs, operation) {
   return void 0;
 }
 function buildNodeCacheKey(graphId, kind, id) {
-  return chunkQPOQX2DI_cjs.encodeTupleKey([graphId, kind, id]);
+  return chunkEZEEWCFJ_cjs.encodeTupleKey([graphId, kind, id]);
 }
 function buildUniqueCacheKey(graphId, nodeKind, constraintName, key) {
-  return chunkQPOQX2DI_cjs.encodeTupleKey([graphId, nodeKind, constraintName, key]);
+  return chunkEZEEWCFJ_cjs.encodeTupleKey([graphId, nodeKind, constraintName, key]);
 }
 function buildInsertNodeParams(graphId, kind, id, props, validFrom, validTo) {
   const insertParams = {
@@ -277,7 +310,7 @@ function resolveConstraint(graph, kind, constraintName) {
     (candidate) => candidate.name === constraintName
   );
   if (constraint === void 0) {
-    throw new chunkKCH7WQA5_cjs.NodeConstraintNotFoundError(constraintName, kind);
+    throw new chunkMRDBBHIZ_cjs.NodeConstraintNotFoundError(constraintName, kind);
   }
   return constraint;
 }
@@ -338,8 +371,8 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
   }
   function registerPendingUniqueEntries(kind, id, props, constraints) {
     for (const constraint of constraints) {
-      if (!chunkZBVZ7HXD_cjs.checkWherePredicate(constraint, props)) continue;
-      const key = chunkZBVZ7HXD_cjs.computeUniqueKey(
+      if (!chunkFQPEMEWX_cjs.checkWherePredicate(constraint, props)) continue;
+      const key = chunkFQPEMEWX_cjs.computeUniqueKey(
         props,
         constraint.fields,
         constraint.collation
@@ -352,7 +385,7 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
       );
       pendingUniqueOwners.set(concreteEntryKey, id);
       if (constraint.scope !== "kind") {
-        const kindsToCheck = chunkZBVZ7HXD_cjs.getKindsForUniquenessCheck(
+        const kindsToCheck = chunkFQPEMEWX_cjs.getKindsForUniquenessCheck(
           kind,
           constraint.scope,
           registry
@@ -371,12 +404,12 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
   }
   function registerAppliedNodeUpdate(kind, id, oldProps, newProps, constraints) {
     for (const constraint of constraints) {
-      const oldApplies = chunkZBVZ7HXD_cjs.checkWherePredicate(constraint, oldProps);
-      const newApplies = chunkZBVZ7HXD_cjs.checkWherePredicate(constraint, newProps);
-      const oldKey = oldApplies ? chunkZBVZ7HXD_cjs.computeUniqueKey(oldProps, constraint.fields, constraint.collation) : void 0;
-      const newKey = newApplies ? chunkZBVZ7HXD_cjs.computeUniqueKey(newProps, constraint.fields, constraint.collation) : void 0;
+      const oldApplies = chunkFQPEMEWX_cjs.checkWherePredicate(constraint, oldProps);
+      const newApplies = chunkFQPEMEWX_cjs.checkWherePredicate(constraint, newProps);
+      const oldKey = oldApplies ? chunkFQPEMEWX_cjs.computeUniqueKey(oldProps, constraint.fields, constraint.collation) : void 0;
+      const newKey = newApplies ? chunkFQPEMEWX_cjs.computeUniqueKey(newProps, constraint.fields, constraint.collation) : void 0;
       if (oldKey === newKey) continue;
-      const kindsToCheck = chunkZBVZ7HXD_cjs.getKindsForUniquenessCheck(
+      const kindsToCheck = chunkFQPEMEWX_cjs.getKindsForUniquenessCheck(
         kind,
         constraint.scope,
         registry
@@ -416,7 +449,7 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
     if (uniqueCache.has(cacheKey)) return;
     uniqueCache.set(cacheKey, row);
   }
-  const validationBackend = chunkANKOXPCC_cjs.createBackendOverlay(backend, {
+  const validationBackend = chunkSIT26LAZ_cjs.deriveBackend(backend, {
     getNode: getNodeCached,
     checkUnique: checkUniqueCached
   });
@@ -433,16 +466,16 @@ function draftNodeCreate(ctx, input, id, options) {
   const kind = input.kind;
   const registration = getNodeRegistration(ctx.graph, kind);
   const nodeKind = registration.type;
-  const validatedProps = options?.propsPreValidated === true ? input.props : chunkQPOQX2DI_cjs.validateNodeProps(nodeKind.schema, input.props, {
+  const validatedProps = options?.propsPreValidated === true ? input.props : chunkJFRT7S3B_cjs.validateNodeProps(nodeKind.schema, input.props, {
     kind,
     operation: "create"
   });
-  const validFrom = chunk5PDSCELM_cjs.validateOptionalCanonicalIsoDate(
+  const validFrom = chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(
     input.validFrom,
     "validFrom"
   );
-  const validTo = chunk5PDSCELM_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo");
-  chunk5PDSCELM_cjs.assertOrderedValidityWindow(`${kind} "${id}"`, validFrom, validTo);
+  const validTo = chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo");
+  chunkTQHGE7UC_cjs.assertOrderedValidityWindow(`${kind} "${id}"`, validFrom, validTo);
   return {
     kind,
     id,
@@ -466,8 +499,8 @@ async function finishNodeCreatePreparation(ctx, draft, backend) {
     backend
   };
   await checkDisjointnessConstraint(constraintContext, kind, id);
-  await chunk32UETY6S_cjs.checkUniquenessConstraints(
-    chunk32UETY6S_cjs.createUniquenessContext(ctx.graphId, ctx.registry, backend),
+  await chunk3KOY4FH3_cjs.checkUniquenessConstraints(
+    chunk3KOY4FH3_cjs.createUniquenessContext(ctx.graphId, ctx.registry, backend),
     kind,
     id,
     validatedProps,
@@ -499,8 +532,8 @@ async function validateAndPrepareNodeCreate(ctx, input, id, backend, options) {
   );
 }
 async function finalizeNodeCreateBatch(ctx, preparedCreates, backend, lock) {
-  await chunk32UETY6S_cjs.applyNodeInsertSideEffectsBatch(
-    chunk32UETY6S_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+  await chunk3KOY4FH3_cjs.applyNodeInsertSideEffectsBatch(
+    chunk3KOY4FH3_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
     preparedCreates.map((prepared) => ({
       kind: prepared.kind,
       id: prepared.id,
@@ -515,8 +548,8 @@ function foldReferences(preparedCreates) {
   return preparedCreates.filter((prepared) => prepared.idProvided).map((prepared) => ({ kind: prepared.kind, id: prepared.id }));
 }
 async function finalizeNodeCreate(ctx, prepared, backend, lock) {
-  await chunk32UETY6S_cjs.applyNodeInsertSideEffects(
-    chunk32UETY6S_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+  await chunk3KOY4FH3_cjs.applyNodeInsertSideEffects(
+    chunk3KOY4FH3_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
     {
       kind: prepared.kind,
       id: prepared.id,
@@ -529,7 +562,7 @@ async function finalizeNodeCreate(ctx, prepared, backend, lock) {
 }
 function computeNodeUpdate(ctx, kind, id, existingProps, inputProps) {
   const registration = getNodeRegistration(ctx.graph, kind);
-  const validatedProps = chunkQPOQX2DI_cjs.validateNodeProps(
+  const validatedProps = chunkJFRT7S3B_cjs.validateNodeProps(
     registration.type.schema,
     { ...existingProps, ...inputProps },
     { kind, operation: "update", id }
@@ -537,7 +570,7 @@ function computeNodeUpdate(ctx, kind, id, existingProps, inputProps) {
   return { registration, validatedProps };
 }
 function resolveNodeUpdateProps(ctx, existing, inputProps) {
-  const existingProps = chunkANKOXPCC_cjs.rowPropsToObject(existing.props);
+  const existingProps = chunk5PRKMB24_cjs.rowPropsToObject(existing.props);
   const { registration, validatedProps } = computeNodeUpdate(
     ctx,
     existing.kind,
@@ -562,23 +595,25 @@ function nodeUpsertDirtyCheck(ctx, kind, id, existingProps, inputProps) {
 }
 async function performNodeUpdate(ctx, input, backend, lock, options) {
   const { kind, id } = input;
+  assertValidityEndMutation(input, { entityType: "node", kind, id });
   const existing = await backend.getNode(ctx.graphId, kind, id);
-  if (!existing) throw new chunkKCH7WQA5_cjs.NodeNotFoundError(kind, id);
+  if (!existing) throw new chunkMRDBBHIZ_cjs.NodeNotFoundError(kind, id);
   const { registration, validatedProps } = resolveNodeUpdateProps(
     ctx,
     existing,
     input.props
   );
   const nodeKind = registration.type;
-  const validTo = chunk5PDSCELM_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo");
-  const resurrectionInstant = options?.clearDeleted === true && existing.deleted_at !== void 0 ? chunk5PDSCELM_cjs.nowIso() : void 0;
-  const preservesLiveLowerBound = resurrectionInstant === void 0 && chunk5PDSCELM_cjs.preservesImmutableLowerBound(input.onImmutableLowerBound);
-  const statedValidFrom = chunk5PDSCELM_cjs.validateOptionalCanonicalIsoDate(
+  const validTo = chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo");
+  const resurrectionInstant = options?.clearDeleted === true && existing.deleted_at !== void 0 ? chunkTQHGE7UC_cjs.nowIso() : void 0;
+  const preservesLiveLowerBound = resurrectionInstant === void 0 && chunkTQHGE7UC_cjs.preservesImmutableLowerBound(input.onImmutableLowerBound);
+  const statedValidFrom = chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(
     input.validFrom,
     "validFrom"
   );
   const validFrom = preservesLiveLowerBound ? void 0 : statedValidFrom;
-  const windowVerdict = chunk5PDSCELM_cjs.assertWritableValidityWindow(
+  const resurrectionBound = resurrectionInstant === void 0 ? void 0 : chunkTQHGE7UC_cjs.resolveStampedValidityLowerBound(validFrom, validTo, resurrectionInstant);
+  const windowVerdict = chunkTQHGE7UC_cjs.assertWritableValidityWindow(
     `${kind} "${id}"`,
     validFrom,
     resurrectionInstant === void 0 ? {
@@ -586,21 +621,20 @@ async function performNodeUpdate(ctx, input, backend, lock, options) {
       appliesStatedValidFrom: false,
       effectiveBoundIsStored: true
     } : {
-      effectiveValidFrom: resurrectionInstant,
+      effectiveValidFrom: resurrectionBound,
       appliesStatedValidFrom: true,
-      // The instant this write is about to stamp, not a bound the row holds.
+      // The bound this write is about to stamp, not one the row holds.
       effectiveBoundIsStored: false
     },
     validTo
   );
-  const writeContext = chunk32UETY6S_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock);
-  const effectiveValidFrom = validFrom ?? resurrectionInstant;
+  const writeContext = chunk3KOY4FH3_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock);
   const shared = {
     schema: nodeKind.schema,
     validatedProps,
     uniqueConstraints: registration.unique ?? [],
-    ...effectiveValidFrom !== void 0 && { validFrom: effectiveValidFrom },
     ...validTo !== void 0 && { validTo },
+    ...input.clearValidTo === true && { clearValidTo: true },
     // The bound the verdict above READ, carried into the UPDATE's own `WHERE`
     // so the row this writes is the row that was judged. The verdict hands over
     // the predicate rather than a flag, so both conditions that decide it — did
@@ -614,17 +648,22 @@ async function performNodeUpdate(ctx, input, backend, lock, options) {
     ...windowVerdict.storedLowerBoundFence
   };
   if (options?.clearDeleted) {
-    const row2 = await chunk32UETY6S_cjs.applyNodeUpdate(
+    const resurrectionLowerBound = resurrectionInstant === void 0 ? validFrom !== void 0 && { validFrom } : { validFrom: resurrectionBound ?? null };
+    const row2 = await chunk3KOY4FH3_cjs.applyNodeUpdate(
       writeContext,
-      { ...shared, existing, clearDeleted: true },
+      { ...shared, existing, clearDeleted: true, ...resurrectionLowerBound },
       backend
     );
     return rowToNode(row2);
   }
-  if (!chunkANKOXPCC_cjs.isLiveNodeRow(existing)) throw new chunkKCH7WQA5_cjs.NodeNotFoundError(kind, id);
-  const row = await chunk32UETY6S_cjs.applyNodeUpdate(
+  if (!chunk5PRKMB24_cjs.isLiveNodeRow(existing)) throw new chunkMRDBBHIZ_cjs.NodeNotFoundError(kind, id);
+  const row = await chunk3KOY4FH3_cjs.applyNodeUpdate(
     writeContext,
-    { ...shared, existing },
+    // An in-place update must not rewrite the stored bound, so it keeps the
+    // conditional spread: `buildUpdateNode` ignores `validFrom` off the
+    // resurrection leg, and stating one here would claim a rewrite that no
+    // statement performs.
+    { ...shared, existing, ...validFrom !== void 0 && { validFrom } },
     backend
   );
   return rowToNode(row);
@@ -646,15 +685,15 @@ async function performNodeUpdateWithResurrectionRecovery(ctx, input, target, loc
       }
       const current = await target.getNode(ctx.graphId, input.kind, input.id);
       if (current === void 0 || current.deleted_at !== void 0) {
-        throw new chunkKCH7WQA5_cjs.NodeNotFoundError(input.kind, input.id);
+        throw new chunkMRDBBHIZ_cjs.NodeNotFoundError(input.kind, input.id);
       }
     }
   }
-  throw new chunkKCH7WQA5_cjs.NodeNotFoundError(input.kind, input.id);
+  throw new chunkMRDBBHIZ_cjs.NodeNotFoundError(input.kind, input.id);
 }
 function nodeUpdateRaceError(input, error) {
   if (!isNodeUpdateNoRowError(error)) return error;
-  return new chunkKCH7WQA5_cjs.DatabaseOperationError(
+  return new chunkMRDBBHIZ_cjs.DatabaseOperationError(
     `Node update for ${input.kind} "${input.id}" could not be applied to a stable row after ${NODE_UPDATE_ATTEMPTS} attempts: the row was removed and recreated between each read and its write. A concurrent writer is replacing this node faster than it can be read; serialize the writers, or retry.`,
     {
       operation: "update",
@@ -685,19 +724,19 @@ async function primeBatchValidationCaches(ctx, drafts, backend, seams) {
     const groups = /* @__PURE__ */ new Map();
     for (const draft of drafts) {
       for (const constraint of draft.uniqueConstraints) {
-        if (!chunkZBVZ7HXD_cjs.checkWherePredicate(constraint, draft.validatedProps)) continue;
-        const key = chunkZBVZ7HXD_cjs.computeUniqueKey(
+        if (!chunkFQPEMEWX_cjs.checkWherePredicate(constraint, draft.validatedProps)) continue;
+        const key = chunkFQPEMEWX_cjs.computeUniqueKey(
           draft.validatedProps,
           constraint.fields,
           constraint.collation
         );
-        const kindsToCheck = chunkZBVZ7HXD_cjs.getKindsForUniquenessCheck(
+        const kindsToCheck = chunkFQPEMEWX_cjs.getKindsForUniquenessCheck(
           draft.kind,
           constraint.scope,
           ctx.registry
         );
         for (const kindToCheck of kindsToCheck) {
-          const groupKey = chunkQPOQX2DI_cjs.encodeTupleKey([kindToCheck, constraint.name]);
+          const groupKey = chunkEZEEWCFJ_cjs.encodeTupleKey([kindToCheck, constraint.name]);
           const group = groups.get(groupKey) ?? {
             nodeKind: kindToCheck,
             constraintName: constraint.name,
@@ -737,7 +776,7 @@ async function prepareBatchCreates(ctx, inputs, backend, options) {
     seedUniqueRow
   } = createNodeBatchValidationBackend(ctx.graphId, ctx.registry, backend);
   const drafts = inputs.map(
-    (input) => draftNodeCreate(ctx, input, input.id ?? chunkA4R3H7RU_cjs.generateId(), options)
+    (input) => draftNodeCreate(ctx, input, input.id ?? chunkEZEEWCFJ_cjs.generateId(), options)
   );
   await primeBatchValidationCaches(ctx, drafts, backend, {
     seedNodeRow,
@@ -774,12 +813,12 @@ function partitionCreates(preparedCreates) {
   return { inserts, resurrections };
 }
 function isNodeUpdateNoRowError(error) {
-  return error instanceof chunkKCH7WQA5_cjs.DatabaseOperationError && error.details.operation === "update" && error.details.entity === "node" && error.details.reason === "no_row_returned";
+  return error instanceof chunkMRDBBHIZ_cjs.DatabaseOperationError && error.details.operation === "update" && error.details.entity === "node" && error.details.reason === "no_row_returned";
 }
 async function resurrectPreparedNode(ctx, target, lock, prepared) {
   const current = await target.getNode(ctx.graphId, prepared.kind, prepared.id);
   if (current === void 0) {
-    throw new chunkKCH7WQA5_cjs.DatabaseOperationError(
+    throw new chunkMRDBBHIZ_cjs.DatabaseOperationError(
       `Node tombstone disappeared before resurrection: ${prepared.kind} ${prepared.id}`,
       { operation: "update", entity: "node" }
     );
@@ -787,16 +826,25 @@ async function resurrectPreparedNode(ctx, target, lock, prepared) {
   if (current.deleted_at === void 0) {
     throw createAlreadyExistsError("node", prepared.kind, prepared.id);
   }
+  const resurrectionInstant = chunkTQHGE7UC_cjs.nowIso();
+  const resurrectionBound = chunkTQHGE7UC_cjs.resolveStampedValidityLowerBound(
+    prepared.insertParams.validFrom,
+    prepared.insertParams.validTo,
+    resurrectionInstant
+  );
   try {
-    return await chunk32UETY6S_cjs.applyNodeUpdate(
-      chunk32UETY6S_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+    return await chunk3KOY4FH3_cjs.applyNodeUpdate(
+      chunk3KOY4FH3_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
       {
         existing: current,
         clearDeleted: true,
         schema: prepared.nodeKind.schema,
         validatedProps: prepared.validatedProps,
         uniqueConstraints: prepared.uniqueConstraints,
-        ...prepared.insertParams.validFrom === void 0 ? {} : { validFrom: prepared.insertParams.validFrom },
+        // The decision itself, never an absence — see the same spelling on
+        // `performNodeUpdate`'s resurrection leg.
+        // eslint-disable-next-line unicorn/no-null -- `validFrom: null` means "store NULL"; omitting the key means "decide for me", and this path has already decided. See UpdateNodeParams.validFrom.
+        validFrom: resurrectionBound ?? null,
         ...prepared.insertParams.validTo === void 0 ? {} : { validTo: prepared.insertParams.validTo }
       },
       target
@@ -863,10 +911,10 @@ async function batchCheckUniqueAcrossKinds(backend, graphId, constraintName, uni
 }
 async function executeNodeCreateInternal(ctx, input, backend, options) {
   const kind = input.kind;
-  const id = input.id ?? chunkA4R3H7RU_cjs.generateId();
+  const id = input.id ?? chunkEZEEWCFJ_cjs.generateId();
   const opContext = ctx.createOperationContext("create", "node", kind, id);
   const shouldReturnRow = options?.returnRow ?? true;
-  return chunkQPOQX2DI_cjs.runHookedWriteOperation(
+  return chunkJFRT7S3B_cjs.runHookedWriteOperation(
     ctx,
     opContext,
     backend,
@@ -895,8 +943,8 @@ async function executeNodeCreateInternal(ctx, input, backend, options) {
       }
       const row = await withAlreadyExistsTranslation("node", async () => {
         if (shouldReturnRow) return target.insertNode(prepared.insertParams);
-        await chunkA4R3H7RU_cjs.runInsertNoReturn(
-          chunkA4R3H7RU_cjs.nodeInsertDispatch(target),
+        await chunkEZEEWCFJ_cjs.runInsertNoReturn(
+          chunkEZEEWCFJ_cjs.nodeInsertDispatch(target),
           prepared.insertParams
         );
         return;
@@ -919,7 +967,7 @@ async function executeNodeCreate(ctx, input, backend, options) {
     ...options
   });
   if (!result) {
-    throw new chunkKCH7WQA5_cjs.DatabaseOperationError(
+    throw new chunkMRDBBHIZ_cjs.DatabaseOperationError(
       "Node create failed: expected created node row",
       { operation: "insert", entity: "node" }
     );
@@ -928,7 +976,7 @@ async function executeNodeCreate(ctx, input, backend, options) {
 }
 async function executeNodeCreateNoReturnBatch(ctx, inputs, backend) {
   if (inputs.length === 0) return;
-  await chunkQPOQX2DI_cjs.runInWriteTransaction(
+  await chunkJFRT7S3B_cjs.runInWriteTransaction(
     ctx,
     backend,
     async (target, lock) => {
@@ -938,8 +986,8 @@ async function executeNodeCreateNoReturnBatch(ctx, inputs, backend) {
       const partition = partitionCreates(preparedCreates);
       await withAlreadyExistsTranslation(
         "node",
-        () => chunkA4R3H7RU_cjs.runInsertBatch(
-          chunkA4R3H7RU_cjs.nodeInsertDispatch(target),
+        () => chunkEZEEWCFJ_cjs.runInsertBatch(
+          chunkEZEEWCFJ_cjs.nodeInsertDispatch(target),
           partition.inserts.map((prepared) => prepared.insertParams)
         )
       );
@@ -962,7 +1010,7 @@ async function executeNodeCreateNoReturnBatch(ctx, inputs, backend) {
 }
 async function executeNodeCreateBatch(ctx, inputs, backend, options) {
   if (inputs.length === 0) return [];
-  return chunkQPOQX2DI_cjs.runInWriteTransaction(
+  return chunkJFRT7S3B_cjs.runInWriteTransaction(
     ctx,
     backend,
     async (target, lock) => {
@@ -977,8 +1025,8 @@ async function executeNodeCreateBatch(ctx, inputs, backend, options) {
       const partition = partitionCreates(preparedCreates);
       const inserted = await withAlreadyExistsTranslation(
         "node",
-        () => chunkA4R3H7RU_cjs.runInsertBatchReturning(
-          chunkA4R3H7RU_cjs.nodeInsertDispatch(target),
+        () => chunkEZEEWCFJ_cjs.runInsertBatchReturning(
+          chunkEZEEWCFJ_cjs.nodeInsertDispatch(target),
           partition.inserts.map((prepared) => prepared.insertParams)
         )
       );
@@ -991,13 +1039,13 @@ async function executeNodeCreateBatch(ctx, inputs, backend, options) {
       await finalizeNodeCreateBatch(ctx, partition.inserts, target, lock);
       const byReference = new Map(
         [...inserted, ...resurrected].map((row) => [
-          chunkQPOQX2DI_cjs.refKey({ kind: row.kind, id: row.id }),
+          chunkJFRT7S3B_cjs.refKey({ kind: row.kind, id: row.id }),
           row
         ])
       );
       const rows = preparedCreates.map(
         (prepared) => chunkN66HCGCY_cjs.requireDefined(
-          byReference.get(chunkQPOQX2DI_cjs.refKey({ kind: prepared.kind, id: prepared.id })),
+          byReference.get(chunkJFRT7S3B_cjs.refKey({ kind: prepared.kind, id: prepared.id })),
           `Missing written row for ${prepared.kind} ${prepared.id}`
         )
       );
@@ -1022,15 +1070,29 @@ async function executeNodeUpdate(ctx, input, backend, options) {
     input.kind,
     input.id
   );
-  return chunkQPOQX2DI_cjs.runHookedWriteOperation(
+  return chunkJFRT7S3B_cjs.runHookedWriteOperation(
     ctx,
     opContext,
     backend,
     async (target, lock) => {
+      if (input.clearValidTo === true) {
+        assertClearValidToSupported(backend, "node");
+      }
+      const validTo = chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(
+        input.validTo,
+        "validTo"
+      );
       const identity = ctx.identity;
-      if (options?.clearDeleted && identity !== void 0) {
+      if (identity !== void 0 && (options?.clearDeleted === true || input.validTo !== void 0)) {
         await identity.lock(target);
       }
+      if (identity !== void 0 && validTo !== void 0) {
+        await identity.requireValidityEndCompatible(
+          target,
+          { kind: input.kind, id: input.id },
+          validTo
+        );
+      }
       const node = await performNodeUpdateWithResurrectionRecovery(
         ctx,
         input,
@@ -1059,19 +1121,19 @@ async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candi
   const schema = registration.type.schema;
   const uniqueConstraints = registration.unique ?? [];
   if (!backend.capabilities.transactions) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "updateWhere() requires a transactional backend so validation and sidecars are atomic",
       { code: "SET_UPDATE_TRANSACTIONS_REQUIRED", kind }
     );
   }
   if (backend.updateNodeSet === void 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "This backend does not support set-based node updates",
       { code: "SET_UPDATE_UNSUPPORTED", kind }
     );
   }
   if (Object.keys(inputPatch).length === 0) {
-    throw new chunkKCH7WQA5_cjs.ValidationError("updateWhere() patch must not be empty", {
+    throw new chunkMRDBBHIZ_cjs.ValidationError("updateWhere() patch must not be empty", {
       entityType: "node",
       kind,
       operation: "update",
@@ -1082,7 +1144,7 @@ async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candi
     (property) => !Object.hasOwn(schema.shape, property)
   );
   if (unknownProperty !== void 0) {
-    throw new chunkKCH7WQA5_cjs.ValidationError(
+    throw new chunkMRDBBHIZ_cjs.ValidationError(
       `Unknown ${kind} property in updateWhere() patch: ${unknownProperty}`,
       {
         entityType: "node",
@@ -1097,7 +1159,7 @@ async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candi
       }
     );
   }
-  const parsedPatch = chunkQPOQX2DI_cjs.validateNodeProps(schema.partial(), inputPatch, {
+  const parsedPatch = chunkJFRT7S3B_cjs.validateNodeProps(schema.partial(), inputPatch, {
     kind,
     operation: "update"
   });
@@ -1108,11 +1170,11 @@ async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candi
       unsetProperties.push(property);
       continue;
     }
-    chunkD6GCNNMK_cjs.assertJsonValue(value, property, `Node "${kind}" updateWhere patch`);
+    chunk6NGW27EO_cjs.assertJsonValue(value, property, `Node "${kind}" updateWhere patch`);
     patch[property] = value;
   }
   if (Object.keys(patch).length === 0 && unsetProperties.length === 0) {
-    throw new chunkKCH7WQA5_cjs.ValidationError(
+    throw new chunkMRDBBHIZ_cjs.ValidationError(
       "updateWhere() patch has no recognized properties",
       {
         entityType: "node",
@@ -1125,19 +1187,19 @@ async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candi
     );
   }
   if (uniqueConstraints.length > 0 && (backend.hardDeleteUniquesByNodeIds === void 0 || backend.insertUniqueBatch === void 0 || backend.checkUniqueBatch === void 0)) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "updateWhere() requires batched uniqueness sidecar operations for constrained nodes",
       { code: "SET_UPDATE_UNIQUENESS_UNSUPPORTED", kind }
     );
   }
   if (chunkHAHNRASW_cjs.getSearchableFields(schema).length > 0 && (backend.upsertFulltext === void 0 || backend.deleteFulltext === void 0 || backend.upsertFulltextBatch === void 0 || backend.deleteFulltextBatch === void 0)) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "updateWhere() requires batched fulltext sidecar operations for searchable nodes",
       { code: "SET_UPDATE_FULLTEXT_UNSUPPORTED", kind }
     );
   }
-  if (chunk32UETY6S_cjs.getEmbeddingFields(schema).length > 0 && (backend.upsertEmbedding === void 0 || backend.deleteEmbedding === void 0 || backend.upsertEmbeddingBatch === void 0 || backend.deleteEmbeddingBatch === void 0)) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+  if (chunk3KOY4FH3_cjs.getEmbeddingFields(schema).length > 0 && (backend.upsertEmbedding === void 0 || backend.deleteEmbedding === void 0 || backend.upsertEmbeddingBatch === void 0 || backend.deleteEmbeddingBatch === void 0)) {
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       "updateWhere() requires batched vector sidecar operations for embedded nodes",
       { code: "SET_UPDATE_VECTOR_UNSUPPORTED", kind }
     );
@@ -1145,32 +1207,32 @@ async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candi
   const hookContext = ctx.createBulkOperationContext("updateWhere", kind);
   return ctx.withBulkOperationHooks(
     hookContext,
-    () => chunkQPOQX2DI_cjs.runInWriteTransaction(
+    () => chunkJFRT7S3B_cjs.runInWriteTransaction(
       ctx,
       backend,
       async (target, lock) => {
         const updateNodeSet = target.updateNodeSet;
         if (updateNodeSet === void 0) {
-          throw new chunkKCH7WQA5_cjs.ConfigurationError(
+          throw new chunkMRDBBHIZ_cjs.ConfigurationError(
             "The transaction backend does not support set-based node updates",
             { code: "SET_UPDATE_UNSUPPORTED", kind }
           );
         }
         const hardDeleteUniquesByNodeIds = target.hardDeleteUniquesByNodeIds;
         if (uniqueConstraints.length > 0 && (hardDeleteUniquesByNodeIds === void 0 || target.insertUniqueBatch === void 0 || target.checkUniqueBatch === void 0)) {
-          throw new chunkKCH7WQA5_cjs.ConfigurationError(
+          throw new chunkMRDBBHIZ_cjs.ConfigurationError(
             "The transaction backend lacks batched uniqueness operations",
             { code: "SET_UPDATE_UNIQUENESS_UNSUPPORTED", kind }
           );
         }
         if (chunkHAHNRASW_cjs.getSearchableFields(schema).length > 0 && (target.upsertFulltext === void 0 || target.deleteFulltext === void 0 || target.upsertFulltextBatch === void 0 || target.deleteFulltextBatch === void 0)) {
-          throw new chunkKCH7WQA5_cjs.ConfigurationError(
+          throw new chunkMRDBBHIZ_cjs.ConfigurationError(
             "The transaction backend lacks batched fulltext operations",
             { code: "SET_UPDATE_FULLTEXT_UNSUPPORTED", kind }
           );
         }
-        if (chunk32UETY6S_cjs.getEmbeddingFields(schema).length > 0 && (target.upsertEmbedding === void 0 || target.deleteEmbedding === void 0 || target.upsertEmbeddingBatch === void 0 || target.deleteEmbeddingBatch === void 0)) {
-          throw new chunkKCH7WQA5_cjs.ConfigurationError(
+        if (chunk3KOY4FH3_cjs.getEmbeddingFields(schema).length > 0 && (target.upsertEmbedding === void 0 || target.deleteEmbedding === void 0 || target.upsertEmbeddingBatch === void 0 || target.deleteEmbeddingBatch === void 0)) {
+          throw new chunkMRDBBHIZ_cjs.ConfigurationError(
             "The transaction backend lacks batched vector operations",
             { code: "SET_UPDATE_VECTOR_UNSUPPORTED", kind }
           );
@@ -1185,14 +1247,14 @@ async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candi
         });
         if (result.affectedCount === 0) return { affectedCount: 0 };
         const sidecarItems = result.rows.map((row) => {
-          const props = chunkANKOXPCC_cjs.rowPropsToObject(row.props);
-          const validatedProps = chunkQPOQX2DI_cjs.validateNodeProps(schema, props, {
+          const props = chunk5PRKMB24_cjs.rowPropsToObject(row.props);
+          const validatedProps = chunkJFRT7S3B_cjs.validateNodeProps(schema, props, {
             kind,
             operation: "update",
             id: row.id
           });
           if (!chunkPWLJ77UV_cjs.canonicalEqual(validatedProps, props)) {
-            throw new chunkKCH7WQA5_cjs.ValidationError(
+            throw new chunkMRDBBHIZ_cjs.ValidationError(
               `Set update would persist a non-canonical ${kind} row`,
               {
                 entityType: "node",
@@ -1217,65 +1279,23 @@ async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candi
           };
         });
         if (uniqueConstraints.length > 0) {
-          const affectedIds = new Set(result.rows.map((row) => row.id));
-          for (const constraint of uniqueConstraints) {
-            const keyToId = /* @__PURE__ */ new Map();
-            for (const item of sidecarItems) {
-              if (!chunkZBVZ7HXD_cjs.checkWherePredicate(constraint, item.props)) continue;
-              const key = chunkZBVZ7HXD_cjs.computeUniqueKey(
-                item.props,
-                constraint.fields,
-                constraint.collation
-              );
-              const priorId = keyToId.get(key);
-              if (priorId !== void 0 && priorId !== item.id) {
-                throw new chunkKCH7WQA5_cjs.UniquenessError({
-                  constraintName: constraint.name,
-                  kind,
-                  existingId: priorId,
-                  newId: item.id,
-                  fields: constraint.fields
-                });
-              }
-              keyToId.set(key, item.id);
-            }
-            const keys = [...keyToId.keys()];
-            if (keys.length === 0) continue;
-            for (const kindToCheck of chunkZBVZ7HXD_cjs.getKindsForUniquenessCheck(
-              kind,
-              constraint.scope,
-              ctx.registry
-            )) {
-              const existingRows = await chunkN66HCGCY_cjs.requireDefined(
-                target.checkUniqueBatch
-              )({
-                graphId: ctx.graphId,
-                nodeKind: kindToCheck,
-                constraintName: constraint.name,
-                keys
-              });
-              for (const existing of existingRows) {
-                if (existing.concrete_kind === kind && affectedIds.has(existing.node_id)) {
-                  continue;
-                }
-                throw new chunkKCH7WQA5_cjs.UniquenessError({
-                  constraintName: constraint.name,
-                  kind: kindToCheck,
-                  existingId: existing.node_id,
-                  newId: chunkN66HCGCY_cjs.requireDefined(keyToId.get(existing.key)),
-                  fields: constraint.fields
-                });
-              }
-            }
-          }
+          await chunk3KOY4FH3_cjs.validateResolvedNodeUniqueness(
+            chunk3KOY4FH3_cjs.createUniquenessContext(ctx.graphId, ctx.registry, target),
+            sidecarItems.map((item) => ({
+              kind: item.kind,
+              id: item.id,
+              props: item.props,
+              constraints: item.uniqueConstraints
+            }))
+          );
           await chunkN66HCGCY_cjs.requireDefined(hardDeleteUniquesByNodeIds)({
             graphId: ctx.graphId,
             concreteKind: kind,
             nodeIds: result.rows.map((row) => row.id)
           });
         }
-        await chunk32UETY6S_cjs.applyNodeInsertSideEffectsBatch(
-          chunk32UETY6S_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+        await chunk3KOY4FH3_cjs.applyNodeInsertSideEffectsBatch(
+          chunk3KOY4FH3_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
           sidecarItems,
           target
         );
@@ -1292,14 +1312,28 @@ async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candi
   );
 }
 async function executeNodeUpsertUpdate(ctx, input, backend, options) {
-  return chunkQPOQX2DI_cjs.runInWriteTransaction(
+  if (input.clearValidTo === true) {
+    assertClearValidToSupported(backend, "node");
+  }
+  return chunkJFRT7S3B_cjs.runInWriteTransaction(
     ctx,
     backend,
     async (target, lock) => {
+      const validTo = chunkTQHGE7UC_cjs.validateOptionalCanonicalIsoDate(
+        input.validTo,
+        "validTo"
+      );
       const identity = ctx.identity;
-      if (options?.clearDeleted && identity !== void 0) {
+      if (identity !== void 0 && (options?.clearDeleted === true || input.validTo !== void 0)) {
         await identity.lock(target);
       }
+      if (identity !== void 0 && validTo !== void 0) {
+        await identity.requireValidityEndCompatible(
+          target,
+          { kind: input.kind, id: input.id },
+          validTo
+        );
+      }
       const node = await performNodeUpdateWithResurrectionRecovery(
         ctx,
         input,
@@ -1327,7 +1361,7 @@ async function executeNodeDelete(ctx, kind, id, backend) {
   const gate = await backend.getNode(ctx.graphId, kind, id);
   if (!gate || gate.deleted_at) return;
   const opContext = ctx.createOperationContext("delete", "node", kind, id);
-  return chunkQPOQX2DI_cjs.runHookedWriteOperation(
+  return chunkJFRT7S3B_cjs.runHookedWriteOperation(
     ctx,
     opContext,
     backend,
@@ -1336,9 +1370,9 @@ async function executeNodeDelete(ctx, kind, id, backend) {
       if (identity !== void 0) await identity.lock(target);
       const registration = getNodeRegistration(ctx.graph, kind);
       const preflight = await target.getNode(ctx.graphId, kind, id);
-      if (!preflight || !chunkANKOXPCC_cjs.isLiveNodeRow(preflight)) return;
-      await chunk32UETY6S_cjs.applyNodeSoftDelete(
-        chunk32UETY6S_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+      if (!preflight || !chunk5PRKMB24_cjs.isLiveNodeRow(preflight)) return;
+      await chunk3KOY4FH3_cjs.applyNodeSoftDelete(
+        chunk3KOY4FH3_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
         {
           existing: preflight,
           schema: registration.type.schema,
@@ -1354,14 +1388,14 @@ async function executeNodeDelete(ctx, kind, id, backend) {
   );
 }
 async function executeNodeDeleteBatch(ctx, kind, ids, backend) {
-  await chunkQPOQX2DI_cjs.runInWriteTransaction(
+  await chunkJFRT7S3B_cjs.runInWriteTransaction(
     ctx,
     backend,
     async (target, lock) => {
       const identity = ctx.identity;
       if (identity !== void 0) await identity.lock(target);
       const registration = getNodeRegistration(ctx.graph, kind);
-      const writeContext = chunk32UETY6S_cjs.createNodeWriteContext(
+      const writeContext = chunk3KOY4FH3_cjs.createNodeWriteContext(
         ctx.graphId,
         ctx.registry,
         lock
@@ -1369,8 +1403,8 @@ async function executeNodeDeleteBatch(ctx, kind, ids, backend) {
       let affectedCount = 0;
       for (const id of ids) {
         const preflight = await target.getNode(ctx.graphId, kind, id);
-        if (!preflight || !chunkANKOXPCC_cjs.isLiveNodeRow(preflight)) continue;
-        await chunk32UETY6S_cjs.applyNodeSoftDelete(
+        if (!preflight || !chunk5PRKMB24_cjs.isLiveNodeRow(preflight)) continue;
+        await chunk3KOY4FH3_cjs.applyNodeSoftDelete(
           writeContext,
           {
             existing: preflight,
@@ -1394,7 +1428,7 @@ async function executeNodeHardDelete(ctx, kind, id, backend) {
   const gate = await backend.getNode(ctx.graphId, kind, id);
   if (!gate) return;
   const opContext = ctx.createOperationContext("delete", "node", kind, id);
-  return chunkQPOQX2DI_cjs.runHookedWriteOperation(
+  return chunkJFRT7S3B_cjs.runHookedWriteOperation(
     ctx,
     opContext,
     backend,
@@ -1402,8 +1436,8 @@ async function executeNodeHardDelete(ctx, kind, id, backend) {
       const identity = ctx.identity;
       if (identity !== void 0) await identity.lock(target);
       const registration = getNodeRegistration(ctx.graph, kind);
-      await chunk32UETY6S_cjs.applyNodeHardDelete(
-        chunk32UETY6S_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+      await chunk3KOY4FH3_cjs.applyNodeHardDelete(
+        chunk3KOY4FH3_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
         {
           kind,
           id,
@@ -1422,12 +1456,12 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
   const ifExists = options?.ifExists ?? "return";
   const registration = getNodeRegistration(ctx.graph, kind);
   const nodeKind = registration.type;
-  const validatedProps = chunkQPOQX2DI_cjs.validateNodeProps(nodeKind.schema, props, {
+  const validatedProps = chunkJFRT7S3B_cjs.validateNodeProps(nodeKind.schema, props, {
     kind,
     operation: "create"
   });
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
-  if (!chunkZBVZ7HXD_cjs.checkWherePredicate(constraint, validatedProps)) {
+  if (!chunkFQPEMEWX_cjs.checkWherePredicate(constraint, validatedProps)) {
     const node = await executeNodeCreate(
       ctx,
       { kind, props: validatedProps },
@@ -1436,12 +1470,12 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
     );
     return { node, action: "created" };
   }
-  const key = chunkZBVZ7HXD_cjs.computeUniqueKey(
+  const key = chunkFQPEMEWX_cjs.computeUniqueKey(
     validatedProps,
     constraint.fields,
     constraint.collation
   );
-  const kindsToCheck = chunkZBVZ7HXD_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkFQPEMEWX_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -1498,25 +1532,25 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
   try {
     return await attempt();
   } catch (error) {
-    if (!(error instanceof chunkKCH7WQA5_cjs.UniquenessError)) throw error;
+    if (!(error instanceof chunkMRDBBHIZ_cjs.UniquenessError)) throw error;
     return attempt();
   }
 }
 async function executeNodeFindByConstraint(ctx, kind, constraintName, props, backend) {
   const registration = getNodeRegistration(ctx.graph, kind);
   const nodeKind = registration.type;
-  const validatedProps = chunkQPOQX2DI_cjs.validateNodeProps(nodeKind.schema, props, {
+  const validatedProps = chunkJFRT7S3B_cjs.validateNodeProps(nodeKind.schema, props, {
     kind,
     operation: "create"
   });
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
-  if (!chunkZBVZ7HXD_cjs.checkWherePredicate(constraint, validatedProps)) return void 0;
-  const key = chunkZBVZ7HXD_cjs.computeUniqueKey(
+  if (!chunkFQPEMEWX_cjs.checkWherePredicate(constraint, validatedProps)) return void 0;
+  const key = chunkFQPEMEWX_cjs.computeUniqueKey(
     validatedProps,
     constraint.fields,
     constraint.collation
   );
-  const kindsToCheck = chunkZBVZ7HXD_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkFQPEMEWX_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -1542,12 +1576,12 @@ async function executeNodeFindByConstraint(ctx, kind, constraintName, props, bac
 function validateAndComputeKeys(nodeKind, kind, constraint, items) {
   const validated = [];
   for (const item of items) {
-    const validatedProps = chunkQPOQX2DI_cjs.validateNodeProps(nodeKind.schema, item.props, {
+    const validatedProps = chunkJFRT7S3B_cjs.validateNodeProps(nodeKind.schema, item.props, {
       kind,
       operation: "create"
     });
-    const applies = chunkZBVZ7HXD_cjs.checkWherePredicate(constraint, validatedProps);
-    const key = applies ? chunkZBVZ7HXD_cjs.computeUniqueKey(
+    const applies = chunkFQPEMEWX_cjs.checkWherePredicate(constraint, validatedProps);
+    const key = applies ? chunkFQPEMEWX_cjs.computeUniqueKey(
       validatedProps,
       constraint.fields,
       constraint.collation
@@ -1570,7 +1604,7 @@ async function executeNodeBulkFindByConstraint(ctx, kind, constraintName, items,
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
   const validated = validateAndComputeKeys(nodeKind, kind, constraint, items);
   const uniqueKeys = collectUniqueKeys(validated);
-  const kindsToCheck = chunkZBVZ7HXD_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkFQPEMEWX_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -1620,10 +1654,10 @@ function resolveNodeIndex(graph, kind, indexName) {
     (candidate) => candidate.entity === "node" && candidate.kind === kind && candidate.name === indexName
   );
   if (declaration?.entity !== "node") {
-    throw new chunkKCH7WQA5_cjs.NodeIndexNotFoundError(indexName, kind);
+    throw new chunkMRDBBHIZ_cjs.NodeIndexNotFoundError(indexName, kind);
   }
   if (declaration.method !== void 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       `bulkFindByIndex cannot probe index "${indexName}" (method "${declaration.method}"): only btree indexes serve equality probes.`,
       { indexName, kind, method: declaration.method }
     );
@@ -1661,7 +1695,7 @@ function validateIndexProbeValue(value, valueType, pointer, kind) {
   }
 }
 function indexProbeTypeError(pointer, kind, expected, value) {
-  return new chunkKCH7WQA5_cjs.ValidationError(
+  return new chunkMRDBBHIZ_cjs.ValidationError(
     `Index probe value for "${pointer}" on node kind "${kind}" has an incompatible type`,
     {
       entityType: "node",
@@ -1695,7 +1729,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
   if (items.length === 0) return [];
   const index = resolveNodeIndex(ctx.graph, kind, indexName);
   if (index.fields.length === 0) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       `bulkFindByIndex requires an index with at least one prop-based field on index "${indexName}" (node kind "${kind}")`,
       { indexName, kind },
       {
@@ -1704,7 +1738,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
     );
   }
   if (index.fieldValueTypes.includes("date")) {
-    throw new chunkKCH7WQA5_cjs.ConfigurationError(
+    throw new chunkMRDBBHIZ_cjs.ConfigurationError(
       `bulkFindByIndex does not support date-typed key fields on index "${indexName}" (node kind "${kind}")`,
       { indexName, kind },
       {
@@ -1714,7 +1748,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
   }
   const limitPerInput = options?.limitPerInput;
   if (limitPerInput !== void 0 && (!Number.isInteger(limitPerInput) || limitPerInput <= 0)) {
-    throw new chunkKCH7WQA5_cjs.ValidationError(
+    throw new chunkMRDBBHIZ_cjs.ValidationError(
       "bulkFindByIndex limitPerInput must be a positive integer",
       {
         entityType: "node",
@@ -1729,7 +1763,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
       }
     );
   }
-  const adapter = chunkZHOAZD7Q_cjs.getDialect(backend.dialect);
+  const adapter = chunkL3LQNR34_cjs.getDialect(backend.dialect);
   const probes = items.map(
     (item) => index.fields.map((pointer, position) => {
       const value = chunkA7J2YDDI_cjs.resolveJsonPointer(item.props, pointer);
@@ -1756,47 +1790,47 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
     }
     groupToInputs[existing]?.push(inputIndex);
   }
-  const schema = backend.tableNames ? chunkQU7QLJA4_cjs.createSqlSchema(backend.tableNames) : chunkQU7QLJA4_cjs.DEFAULT_SQL_SCHEMA;
+  const schema = backend.tableNames ? chunk3U5ABFDW_cjs.createSqlSchema(backend.tableNames) : chunk3U5ABFDW_cjs.DEFAULT_SQL_SCHEMA;
   const compileContext = {
     dialect: backend.dialect,
-    propsColumn: chunk2ZWM2RFH_cjs.sql.raw(`"props"`),
-    systemColumn: (column) => chunk2ZWM2RFH_cjs.sql.raw(`"${column}"`)
+    propsColumn: chunkEDN4Y4ZG_cjs.sql.raw(`"props"`),
+    systemColumn: (column) => chunkEDN4Y4ZG_cjs.sql.raw(`"${column}"`)
   };
-  const fieldKeys = chunkZHOAZD7Q_cjs.compileNodeIndexFieldKeys(index, compileContext);
+  const fieldKeys = chunkL3LQNR34_cjs.compileNodeIndexFieldKeys(index, compileContext);
   const groupPredicates = groupProbes.map(
-    (probe) => chunk2ZWM2RFH_cjs.sql`(${chunk2ZWM2RFH_cjs.sql.join(
+    (probe) => chunkEDN4Y4ZG_cjs.sql`(${chunkEDN4Y4ZG_cjs.sql.join(
       fieldKeys.map((fieldKey, position) => {
         const value = probe[position];
         if (value === void 0 || value === null) {
-          return chunk2ZWM2RFH_cjs.sql`${fieldKey} IS NULL`;
+          return chunkEDN4Y4ZG_cjs.sql`${fieldKey} IS NULL`;
         }
         return adapter.nullSafeEquals(
           fieldKey,
-          chunk2ZWM2RFH_cjs.sql`${coerceIndexProbeBind(value, adapter)}`
+          chunkEDN4Y4ZG_cjs.sql`${coerceIndexProbeBind(value, adapter)}`
         );
       }),
-      chunk2ZWM2RFH_cjs.sql` AND `
+      chunkEDN4Y4ZG_cjs.sql` AND `
     )})`
   );
   const caseBranches = groupPredicates.map(
-    (predicate, group) => chunk2ZWM2RFH_cjs.sql`WHEN ${predicate} THEN ${chunk2ZWM2RFH_cjs.sql.raw(String(group))}`
+    (predicate, group) => chunkEDN4Y4ZG_cjs.sql`WHEN ${predicate} THEN ${chunkEDN4Y4ZG_cjs.sql.raw(String(group))}`
   );
-  const probeIndexExpr = chunk2ZWM2RFH_cjs.sql`CASE ${chunk2ZWM2RFH_cjs.sql.join(caseBranches, chunk2ZWM2RFH_cjs.sql` `)} ELSE NULL END`;
+  const probeIndexExpr = chunkEDN4Y4ZG_cjs.sql`CASE ${chunkEDN4Y4ZG_cjs.sql.join(caseBranches, chunkEDN4Y4ZG_cjs.sql` `)} ELSE NULL END`;
   const conditions = [
-    chunk2ZWM2RFH_cjs.sql`"graph_id" = ${ctx.graphId}`,
-    chunk2ZWM2RFH_cjs.sql`"kind" = ${kind}`,
-    chunk2ZWM2RFH_cjs.sql`"deleted_at" IS NULL`
+    chunkEDN4Y4ZG_cjs.sql`"graph_id" = ${ctx.graphId}`,
+    chunkEDN4Y4ZG_cjs.sql`"kind" = ${kind}`,
+    chunkEDN4Y4ZG_cjs.sql`"deleted_at" IS NULL`
   ];
   if (index.where !== void 0) {
-    conditions.push(chunkZHOAZD7Q_cjs.compileIndexWhere(compileContext, index.where));
+    conditions.push(chunkL3LQNR34_cjs.compileIndexWhere(compileContext, index.where));
   }
-  conditions.push(chunk2ZWM2RFH_cjs.sql`(${chunk2ZWM2RFH_cjs.sql.join(groupPredicates, chunk2ZWM2RFH_cjs.sql` OR `)})`);
-  const whereClause = chunk2ZWM2RFH_cjs.sql.join(conditions, chunk2ZWM2RFH_cjs.sql` AND `);
-  const probedSelect = chunk2ZWM2RFH_cjs.sql`SELECT "id", ${probeIndexExpr} AS probe_idx FROM ${schema.nodesTable} WHERE ${whereClause}`;
+  conditions.push(chunkEDN4Y4ZG_cjs.sql`(${chunkEDN4Y4ZG_cjs.sql.join(groupPredicates, chunkEDN4Y4ZG_cjs.sql` OR `)})`);
+  const whereClause = chunkEDN4Y4ZG_cjs.sql.join(conditions, chunkEDN4Y4ZG_cjs.sql` AND `);
+  const probedSelect = chunkEDN4Y4ZG_cjs.sql`SELECT "id", ${probeIndexExpr} AS probe_idx FROM ${schema.nodesTable} WHERE ${whereClause}`;
   const capInSql = limitPerInput !== void 0 && backend.capabilities.windowFunctions;
-  const query = capInSql ? chunk2ZWM2RFH_cjs.sql`SELECT "id", probe_idx FROM (SELECT "id", probe_idx, ROW_NUMBER() OVER (PARTITION BY probe_idx ORDER BY "id") AS probe_rank FROM (${probedSelect}) AS probed) AS ranked WHERE probe_rank <= ${limitPerInput} ORDER BY probe_idx, "id"` : chunk2ZWM2RFH_cjs.sql`${probedSelect} ORDER BY probe_idx, "id"`;
+  const query = capInSql ? chunkEDN4Y4ZG_cjs.sql`SELECT "id", probe_idx FROM (SELECT "id", probe_idx, ROW_NUMBER() OVER (PARTITION BY probe_idx ORDER BY "id") AS probe_rank FROM (${probedSelect}) AS probed) AS ranked WHERE probe_rank <= ${limitPerInput} ORDER BY probe_idx, "id"` : chunkEDN4Y4ZG_cjs.sql`${probedSelect} ORDER BY probe_idx, "id"`;
   const rawMatches = await backend.execute(
-    chunk2ZWM2RFH_cjs.asCompiledRowsSql(query)
+    chunkEDN4Y4ZG_cjs.asCompiledRowsSql(query)
   );
   const matches = limitPerInput !== void 0 && !capInSql ? capMatchesPerGroup(rawMatches, limitPerInput) : rawMatches;
   const nodesById = await hydrateNodesById(
@@ -1829,7 +1863,7 @@ function capMatchesPerGroup(matches, limitPerInput) {
   return capped;
 }
 async function hydrateNodesById(backend, graphId, kind, ids) {
-  const rowsById = await chunkA4R3H7RU_cjs.getNodeRowsByIds(backend, graphId, kind, ids);
+  const rowsById = await chunkEZEEWCFJ_cjs.getNodeRowsByIds(backend, graphId, kind, ids);
   const nodesById = /* @__PURE__ */ new Map();
   for (const [id, row] of rowsById) {
     if (row.deleted_at !== void 0) continue;
@@ -1845,7 +1879,7 @@ async function executeNodeBulkGetOrCreateByConstraint(ctx, kind, constraintName,
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
   const validated = validateAndComputeKeys(nodeKind, kind, constraint, items);
   const uniqueKeys = collectUniqueKeys(validated);
-  const kindsToCheck = chunkZBVZ7HXD_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkFQPEMEWX_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -1948,11 +1982,13 @@ async function executeNodeBulkGetOrCreateByConstraint(ctx, kind, constraintName,
   try {
     return await attempt();
   } catch (error) {
-    if (!(error instanceof chunkKCH7WQA5_cjs.UniquenessError)) throw error;
+    if (!(error instanceof chunkMRDBBHIZ_cjs.UniquenessError)) throw error;
     return attempt();
   }
 }
 
+exports.assertClearValidToSupported = assertClearValidToSupported;
+exports.assertValidityEndMutation = assertValidityEndMutation;
 exports.checkCardinalityConstraint = checkCardinalityConstraint;
 exports.createNodeBatchValidationBackend = createNodeBatchValidationBackend;
 exports.edgeWriteNeedsConstraintFence = edgeWriteNeedsConstraintFence;
@@ -1976,6 +2012,7 @@ exports.rowToEdge = rowToEdge;
 exports.rowToEdgeMeta = rowToEdgeMeta;
 exports.rowToNode = rowToNode;
 exports.rowToNodeMeta = rowToNodeMeta;
+exports.validityEndAfterMutation = validityEndAfterMutation;
 exports.withAlreadyExistsTranslation = withAlreadyExistsTranslation;
-//# sourceMappingURL=chunk-BQM5P2NO.cjs.map
-//# sourceMappingURL=chunk-BQM5P2NO.cjs.map
+//# sourceMappingURL=chunk-JB6T4GLL.cjs.map
+//# sourceMappingURL=chunk-JB6T4GLL.cjs.map