@nicia-ai/typegraph 0.35.0 → 0.36.0

package/dist/{chunk-WJT7OU7E.cjs → chunk-4CAXEB2F.cjs}

@@ -1,13 +1,14 @@
 'use strict';
 
-var chunkVPYHY3LJ_cjs = require('./chunk-VPYHY3LJ.cjs');
+var chunk2THZ3TQI_cjs = require('./chunk-2THZ3TQI.cjs');
+var chunkACSVZPK7_cjs = require('./chunk-ACSVZPK7.cjs');
 var chunkD7ZEOS56_cjs = require('./chunk-D7ZEOS56.cjs');
-var chunkGSQ6NPH6_cjs = require('./chunk-GSQ6NPH6.cjs');
-var chunkXOX22WHL_cjs = require('./chunk-XOX22WHL.cjs');
+var chunk4BCU6VFZ_cjs = require('./chunk-4BCU6VFZ.cjs');
+var chunkZUNQ5BEP_cjs = require('./chunk-ZUNQ5BEP.cjs');
 var chunkEOLERH7Y_cjs = require('./chunk-EOLERH7Y.cjs');
-var chunk4TOD4LBZ_cjs = require('./chunk-4TOD4LBZ.cjs');
-var chunkBLZDPRXT_cjs = require('./chunk-BLZDPRXT.cjs');
-var chunkLGEALRC6_cjs = require('./chunk-LGEALRC6.cjs');
+var chunkX4JBT642_cjs = require('./chunk-X4JBT642.cjs');
+var chunkRSSQKPSZ_cjs = require('./chunk-RSSQKPSZ.cjs');
+var chunkDIK74MXX_cjs = require('./chunk-DIK74MXX.cjs');
 var chunkTDXIBCGY_cjs = require('./chunk-TDXIBCGY.cjs');
 var drizzleOrm = require('drizzle-orm');
 
@@ -16,8 +17,8 @@ function nullToUndefined(value) {
   return value === null ? void 0 : value;
 }
 function rowToNode(row) {
-  const rawProps = chunk4TOD4LBZ_cjs.rowPropsToObject(row.props);
-  const props = chunkGSQ6NPH6_cjs.filterReservedKeys(rawProps, chunkGSQ6NPH6_cjs.RESERVED_NODE_KEYS);
+  const rawProps = chunkX4JBT642_cjs.rowPropsToObject(row.props);
+  const props = chunk4BCU6VFZ_cjs.filterReservedKeys(rawProps, chunk4BCU6VFZ_cjs.RESERVED_NODE_KEYS);
   return {
     kind: row.kind,
     id: row.id,
@@ -36,8 +37,8 @@ function rowToNodeMeta(row) {
   };
 }
 function rowToEdge(row) {
-  const rawProps = chunk4TOD4LBZ_cjs.rowPropsToObject(row.props);
-  const props = chunkGSQ6NPH6_cjs.filterReservedKeys(rawProps, chunkGSQ6NPH6_cjs.RESERVED_EDGE_KEYS);
+  const rawProps = chunkX4JBT642_cjs.rowPropsToObject(row.props);
+  const props = chunk4BCU6VFZ_cjs.filterReservedKeys(rawProps, chunk4BCU6VFZ_cjs.RESERVED_EDGE_KEYS);
   return {
     id: row.id,
     kind: row.kind,
@@ -62,11 +63,11 @@ function rowToEdgeMeta(row) {
 // src/store/operations/write-transaction.ts
 function runInWriteTransaction(ctx, backend, fn) {
   const ownsWriteLock = "transaction" in backend && backend.capabilities.transactions;
-  return chunk4TOD4LBZ_cjs.runOptionallyInTransaction(backend, async (target) => {
-    const lock = ctx.historyEnabled || ctx.revisionTrackingEnabled ? await chunkXOX22WHL_cjs.lockRecordedGraphWrite(target, ctx.graphId) : chunkXOX22WHL_cjs.uncapturedGraphWriteLock();
+  return chunkX4JBT642_cjs.runOptionallyInTransaction(backend, async (target) => {
+    const lock = ctx.historyEnabled || ctx.revisionTrackingEnabled ? await chunkZUNQ5BEP_cjs.lockRecordedGraphWrite(target, ctx.graphId) : chunkZUNQ5BEP_cjs.uncapturedGraphWriteLock();
     const result = await fn(target, lock);
     if (ctx.revisionTrackingEnabled && !ctx.historyEnabled) {
-      await chunkXOX22WHL_cjs.advanceRevisionClock(
+      await chunkZUNQ5BEP_cjs.advanceRevisionClock(
         target,
         ctx.revisionSchema,
         ctx.graphId,
@@ -89,7 +90,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 = chunkXOX22WHL_cjs.checkDisjointness(id, kind, [disjointKind], ctx.registry);
+      const error = chunkZUNQ5BEP_cjs.checkDisjointness(id, kind, [disjointKind], ctx.registry);
       if (error) throw error;
     }
   }
@@ -106,7 +107,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         fromKind,
         fromId
       });
-      const error = chunkXOX22WHL_cjs.checkCardinality(
+      const error = chunkZUNQ5BEP_cjs.checkCardinality(
         edgeKind,
         fromKind,
         fromId,
@@ -126,7 +127,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         toKind,
         toId
       });
-      const error = chunkXOX22WHL_cjs.checkUniqueEdge(
+      const error = chunkZUNQ5BEP_cjs.checkUniqueEdge(
         edgeKind,
         fromKind,
         fromId,
@@ -148,7 +149,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         fromId,
         activeOnly: true
       });
-      const error = chunkXOX22WHL_cjs.checkCardinality(
+      const error = chunkZUNQ5BEP_cjs.checkCardinality(
         edgeKind,
         fromKind,
         fromId,
@@ -165,7 +166,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
 // src/store/operations/node-operations.ts
 function getNodeRegistration(graph, kind) {
   const registration = graph.nodes[kind];
-  if (registration === void 0) throw new chunkLGEALRC6_cjs.KindNotFoundError(kind, "node");
+  if (registration === void 0) throw new chunkDIK74MXX_cjs.KindNotFoundError(kind, "node");
   return registration;
 }
 var CACHE_KEY_SEPARATOR = "\0";
@@ -176,7 +177,7 @@ function buildUniqueCacheKey(graphId, nodeKind, constraintName, key) {
   return `${graphId}${CACHE_KEY_SEPARATOR}${nodeKind}${CACHE_KEY_SEPARATOR}${constraintName}${CACHE_KEY_SEPARATOR}${key}`;
 }
 function createNodeAlreadyExistsError(kind, id) {
-  return new chunkLGEALRC6_cjs.ValidationError(
+  return new chunkDIK74MXX_cjs.ValidationError(
     `Node already exists: ${kind}/${id}`,
     {
       entityType: "node",
@@ -217,7 +218,7 @@ function resolveConstraint(graph, kind, constraintName) {
     (candidate) => candidate.name === constraintName
   );
   if (constraint === void 0) {
-    throw new chunkLGEALRC6_cjs.NodeConstraintNotFoundError(constraintName, kind);
+    throw new chunkDIK74MXX_cjs.NodeConstraintNotFoundError(constraintName, kind);
   }
   return constraint;
 }
@@ -278,8 +279,8 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
   }
   function registerPendingUniqueEntries(kind, id, props, constraints) {
     for (const constraint of constraints) {
-      if (!chunkXOX22WHL_cjs.checkWherePredicate(constraint, props)) continue;
-      const key = chunkXOX22WHL_cjs.computeUniqueKey(
+      if (!chunkZUNQ5BEP_cjs.checkWherePredicate(constraint, props)) continue;
+      const key = chunkZUNQ5BEP_cjs.computeUniqueKey(
         props,
         constraint.fields,
         constraint.collation
@@ -292,7 +293,7 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
       );
       pendingUniqueOwners.set(concreteEntryKey, id);
       if (constraint.scope !== "kind") {
-        const kindsToCheck = chunkXOX22WHL_cjs.getKindsForUniquenessCheck(
+        const kindsToCheck = chunkZUNQ5BEP_cjs.getKindsForUniquenessCheck(
           kind,
           constraint.scope,
           registry
@@ -311,12 +312,12 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
   }
   function registerAppliedNodeUpdate(kind, id, oldProps, newProps, constraints) {
     for (const constraint of constraints) {
-      const oldApplies = chunkXOX22WHL_cjs.checkWherePredicate(constraint, oldProps);
-      const newApplies = chunkXOX22WHL_cjs.checkWherePredicate(constraint, newProps);
-      const oldKey = oldApplies ? chunkXOX22WHL_cjs.computeUniqueKey(oldProps, constraint.fields, constraint.collation) : void 0;
-      const newKey = newApplies ? chunkXOX22WHL_cjs.computeUniqueKey(newProps, constraint.fields, constraint.collation) : void 0;
+      const oldApplies = chunkZUNQ5BEP_cjs.checkWherePredicate(constraint, oldProps);
+      const newApplies = chunkZUNQ5BEP_cjs.checkWherePredicate(constraint, newProps);
+      const oldKey = oldApplies ? chunkZUNQ5BEP_cjs.computeUniqueKey(oldProps, constraint.fields, constraint.collation) : void 0;
+      const newKey = newApplies ? chunkZUNQ5BEP_cjs.computeUniqueKey(newProps, constraint.fields, constraint.collation) : void 0;
       if (oldKey === newKey) continue;
-      const kindsToCheck = chunkXOX22WHL_cjs.getKindsForUniquenessCheck(
+      const kindsToCheck = chunkZUNQ5BEP_cjs.getKindsForUniquenessCheck(
         kind,
         constraint.scope,
         registry
@@ -356,7 +357,7 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
     if (uniqueCache.has(cacheKey)) return;
     uniqueCache.set(cacheKey, row);
   }
-  const validationBackend = chunk4TOD4LBZ_cjs.createBackendOverlay(backend, {
+  const validationBackend = chunkX4JBT642_cjs.createBackendOverlay(backend, {
     getNode: getNodeCached,
     checkUnique: checkUniqueCached
   });
@@ -373,7 +374,7 @@ 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 : chunkVPYHY3LJ_cjs.validateNodeProps(nodeKind.schema, input.props, {
+  const validatedProps = options?.propsPreValidated === true ? input.props : chunk2THZ3TQI_cjs.validateNodeProps(nodeKind.schema, input.props, {
     kind,
     operation: "create"
   });
@@ -383,8 +384,8 @@ function draftNodeCreate(ctx, input, id, options) {
     nodeKind,
     uniqueConstraints: registration.unique ?? [],
     validatedProps,
-    validFrom: chunkBLZDPRXT_cjs.validateOptionalCanonicalIsoDate(input.validFrom, "validFrom"),
-    validTo: chunkBLZDPRXT_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo")
+    validFrom: chunkRSSQKPSZ_cjs.validateOptionalCanonicalIsoDate(input.validFrom, "validFrom"),
+    validTo: chunkRSSQKPSZ_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo")
   };
 }
 async function finishNodeCreatePreparation(ctx, draft, backend) {
@@ -399,8 +400,8 @@ async function finishNodeCreatePreparation(ctx, draft, backend) {
     backend
   };
   await checkDisjointnessConstraint(constraintContext, kind, id);
-  await chunkXOX22WHL_cjs.checkUniquenessConstraints(
-    chunkXOX22WHL_cjs.createUniquenessContext(ctx.graphId, ctx.registry, backend),
+  await chunkZUNQ5BEP_cjs.checkUniquenessConstraints(
+    chunkZUNQ5BEP_cjs.createUniquenessContext(ctx.graphId, ctx.registry, backend),
     kind,
     id,
     validatedProps,
@@ -430,8 +431,8 @@ async function validateAndPrepareNodeCreate(ctx, input, id, backend, options) {
   );
 }
 async function finalizeNodeCreateBatch(ctx, preparedCreates, backend, lock) {
-  await chunkXOX22WHL_cjs.applyNodeInsertSideEffectsBatch(
-    chunkXOX22WHL_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+  await chunkZUNQ5BEP_cjs.applyNodeInsertSideEffectsBatch(
+    chunkZUNQ5BEP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
     preparedCreates.map((prepared) => ({
       kind: prepared.kind,
       id: prepared.id,
@@ -443,8 +444,8 @@ async function finalizeNodeCreateBatch(ctx, preparedCreates, backend, lock) {
   );
 }
 async function finalizeNodeCreate(ctx, prepared, backend, lock) {
-  await chunkXOX22WHL_cjs.applyNodeInsertSideEffects(
-    chunkXOX22WHL_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+  await chunkZUNQ5BEP_cjs.applyNodeInsertSideEffects(
+    chunkZUNQ5BEP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
     {
       kind: prepared.kind,
       id: prepared.id,
@@ -455,21 +456,51 @@ async function finalizeNodeCreate(ctx, prepared, backend, lock) {
     backend
   );
 }
+function computeNodeUpdate(ctx, kind, id, existingProps, inputProps) {
+  const registration = getNodeRegistration(ctx.graph, kind);
+  const validatedProps = chunk2THZ3TQI_cjs.validateNodeProps(
+    registration.type.schema,
+    { ...existingProps, ...inputProps },
+    { kind, operation: "update", id }
+  );
+  return { registration, validatedProps };
+}
+function resolveNodeUpdateProps(ctx, existing, inputProps) {
+  const existingProps = chunkX4JBT642_cjs.rowPropsToObject(existing.props);
+  const { registration, validatedProps } = computeNodeUpdate(
+    ctx,
+    existing.kind,
+    existing.id,
+    existingProps,
+    inputProps
+  );
+  return { registration, existingProps, validatedProps };
+}
+function nodeUpsertDirtyCheck(ctx, kind, id, existingProps, inputProps) {
+  const { validatedProps } = computeNodeUpdate(
+    ctx,
+    kind,
+    id,
+    existingProps,
+    inputProps
+  );
+  return {
+    validatedProps,
+    unchanged: chunkACSVZPK7_cjs.canonicalEqual(validatedProps, existingProps)
+  };
+}
 async function performNodeUpdate(ctx, input, backend, lock, options) {
   const { kind, id } = input;
-  const registration = getNodeRegistration(ctx.graph, kind);
   const existing = await backend.getNode(ctx.graphId, kind, id);
-  if (!existing) throw new chunkLGEALRC6_cjs.NodeNotFoundError(kind, id);
-  const existingProps = chunk4TOD4LBZ_cjs.rowPropsToObject(existing.props);
-  const mergedProps = { ...existingProps, ...input.props };
+  if (!existing) throw new chunkDIK74MXX_cjs.NodeNotFoundError(kind, id);
+  const { registration, validatedProps } = resolveNodeUpdateProps(
+    ctx,
+    existing,
+    input.props
+  );
   const nodeKind = registration.type;
-  const validatedProps = chunkVPYHY3LJ_cjs.validateNodeProps(nodeKind.schema, mergedProps, {
-    kind,
-    operation: "update",
-    id
-  });
-  const validTo = chunkBLZDPRXT_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo");
-  const writeContext = chunkXOX22WHL_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock);
+  const validTo = chunkRSSQKPSZ_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo");
+  const writeContext = chunkZUNQ5BEP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock);
   const shared = {
     schema: nodeKind.schema,
     validatedProps,
@@ -477,15 +508,15 @@ async function performNodeUpdate(ctx, input, backend, lock, options) {
     ...validTo !== void 0 && { validTo }
   };
   if (options?.clearDeleted) {
-    const row2 = await chunkXOX22WHL_cjs.applyNodeUpdate(
+    const row2 = await chunkZUNQ5BEP_cjs.applyNodeUpdate(
       writeContext,
       { ...shared, existing, clearDeleted: true },
       backend
     );
     return rowToNode(row2);
   }
-  if (!chunk4TOD4LBZ_cjs.isLiveNodeRow(existing)) throw new chunkLGEALRC6_cjs.NodeNotFoundError(kind, id);
-  const row = await chunkXOX22WHL_cjs.applyNodeUpdate(
+  if (!chunkX4JBT642_cjs.isLiveNodeRow(existing)) throw new chunkDIK74MXX_cjs.NodeNotFoundError(kind, id);
+  const row = await chunkZUNQ5BEP_cjs.applyNodeUpdate(
     writeContext,
     { ...shared, existing },
     backend
@@ -513,13 +544,13 @@ async function primeBatchValidationCaches(ctx, drafts, backend, seams) {
     const groups = /* @__PURE__ */ new Map();
     for (const draft of drafts) {
       for (const constraint of draft.uniqueConstraints) {
-        if (!chunkXOX22WHL_cjs.checkWherePredicate(constraint, draft.validatedProps)) continue;
-        const key = chunkXOX22WHL_cjs.computeUniqueKey(
+        if (!chunkZUNQ5BEP_cjs.checkWherePredicate(constraint, draft.validatedProps)) continue;
+        const key = chunkZUNQ5BEP_cjs.computeUniqueKey(
           draft.validatedProps,
           constraint.fields,
           constraint.collation
         );
-        const kindsToCheck = chunkXOX22WHL_cjs.getKindsForUniquenessCheck(
+        const kindsToCheck = chunkZUNQ5BEP_cjs.getKindsForUniquenessCheck(
           draft.kind,
           constraint.scope,
           ctx.registry
@@ -565,7 +596,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 ?? chunkXOX22WHL_cjs.generateId(), options)
+    (input) => draftNodeCreate(ctx, input, input.id ?? chunkZUNQ5BEP_cjs.generateId(), options)
   );
   await primeBatchValidationCaches(ctx, drafts, backend, {
     seedNodeRow,
@@ -641,7 +672,7 @@ async function batchCheckUniqueAcrossKinds(backend, graphId, constraintName, uni
 }
 async function executeNodeCreateInternal(ctx, input, backend, options) {
   const kind = input.kind;
-  const id = input.id ?? chunkXOX22WHL_cjs.generateId();
+  const id = input.id ?? chunkZUNQ5BEP_cjs.generateId();
   const opContext = ctx.createOperationContext("create", "node", kind, id);
   const shouldReturnRow = options?.returnRow ?? true;
   return runHookedWriteOperation(
@@ -660,8 +691,8 @@ async function executeNodeCreateInternal(ctx, input, backend, options) {
       if (shouldReturnRow) {
         row = await target.insertNode(prepared.insertParams);
       } else {
-        await chunkXOX22WHL_cjs.runInsertNoReturn(
-          chunkXOX22WHL_cjs.nodeInsertDispatch(target),
+        await chunkZUNQ5BEP_cjs.runInsertNoReturn(
+          chunkZUNQ5BEP_cjs.nodeInsertDispatch(target),
           prepared.insertParams
         );
       }
@@ -677,7 +708,7 @@ async function executeNodeCreate(ctx, input, backend, options) {
     ...options
   });
   if (!result) {
-    throw new chunkLGEALRC6_cjs.DatabaseOperationError(
+    throw new chunkDIK74MXX_cjs.DatabaseOperationError(
       "Node create failed: expected created node row",
       { operation: "insert", entity: "node" }
     );
@@ -692,7 +723,7 @@ async function executeNodeCreateNoReturnBatch(ctx, inputs, backend) {
       inputs,
       target
     );
-    await chunkXOX22WHL_cjs.runInsertBatch(chunkXOX22WHL_cjs.nodeInsertDispatch(target), batchInsertParams);
+    await chunkZUNQ5BEP_cjs.runInsertBatch(chunkZUNQ5BEP_cjs.nodeInsertDispatch(target), batchInsertParams);
     await finalizeNodeCreateBatch(ctx, preparedCreates, target, lock);
   });
 }
@@ -705,8 +736,8 @@ async function executeNodeCreateBatch(ctx, inputs, backend, options) {
       target,
       options
     );
-    const rows = await chunkXOX22WHL_cjs.runInsertBatchReturning(
-      chunkXOX22WHL_cjs.nodeInsertDispatch(target),
+    const rows = await chunkZUNQ5BEP_cjs.runInsertBatchReturning(
+      chunkZUNQ5BEP_cjs.nodeInsertDispatch(target),
       batchInsertParams
     );
     await finalizeNodeCreateBatch(ctx, preparedCreates, target, lock);
@@ -745,9 +776,9 @@ async function executeNodeDelete(ctx, kind, id, backend) {
     async (target, lock) => {
       const registration = getNodeRegistration(ctx.graph, kind);
       const preflight = await target.getNode(ctx.graphId, kind, id);
-      if (!preflight || !chunk4TOD4LBZ_cjs.isLiveNodeRow(preflight)) return;
-      await chunkXOX22WHL_cjs.applyNodeSoftDelete(
-        chunkXOX22WHL_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+      if (!preflight || !chunkX4JBT642_cjs.isLiveNodeRow(preflight)) return;
+      await chunkZUNQ5BEP_cjs.applyNodeSoftDelete(
+        chunkZUNQ5BEP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
         {
           existing: preflight,
           schema: registration.type.schema,
@@ -769,8 +800,8 @@ async function executeNodeHardDelete(ctx, kind, id, backend) {
     backend,
     async (target, lock) => {
       const registration = getNodeRegistration(ctx.graph, kind);
-      await chunkXOX22WHL_cjs.applyNodeHardDelete(
-        chunkXOX22WHL_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+      await chunkZUNQ5BEP_cjs.applyNodeHardDelete(
+        chunkZUNQ5BEP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
         {
           kind,
           id,
@@ -786,12 +817,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 = chunkVPYHY3LJ_cjs.validateNodeProps(nodeKind.schema, props, {
+  const validatedProps = chunk2THZ3TQI_cjs.validateNodeProps(nodeKind.schema, props, {
     kind,
     operation: "create"
   });
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
-  if (!chunkXOX22WHL_cjs.checkWherePredicate(constraint, validatedProps)) {
+  if (!chunkZUNQ5BEP_cjs.checkWherePredicate(constraint, validatedProps)) {
     const node = await executeNodeCreate(
       ctx,
       { kind, props: validatedProps },
@@ -800,12 +831,12 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
     );
     return { node, action: "created" };
   }
-  const key = chunkXOX22WHL_cjs.computeUniqueKey(
+  const key = chunkZUNQ5BEP_cjs.computeUniqueKey(
     validatedProps,
     constraint.fields,
     constraint.collation
   );
-  const kindsToCheck = chunkXOX22WHL_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkZUNQ5BEP_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -862,25 +893,25 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
   try {
     return await attempt();
   } catch (error) {
-    if (!(error instanceof chunkLGEALRC6_cjs.UniquenessError)) throw error;
+    if (!(error instanceof chunkDIK74MXX_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 = chunkVPYHY3LJ_cjs.validateNodeProps(nodeKind.schema, props, {
+  const validatedProps = chunk2THZ3TQI_cjs.validateNodeProps(nodeKind.schema, props, {
     kind,
     operation: "create"
   });
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
-  if (!chunkXOX22WHL_cjs.checkWherePredicate(constraint, validatedProps)) return void 0;
-  const key = chunkXOX22WHL_cjs.computeUniqueKey(
+  if (!chunkZUNQ5BEP_cjs.checkWherePredicate(constraint, validatedProps)) return void 0;
+  const key = chunkZUNQ5BEP_cjs.computeUniqueKey(
     validatedProps,
     constraint.fields,
     constraint.collation
   );
-  const kindsToCheck = chunkXOX22WHL_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkZUNQ5BEP_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -906,12 +937,12 @@ async function executeNodeFindByConstraint(ctx, kind, constraintName, props, bac
 function validateAndComputeKeys(nodeKind, kind, constraint, items) {
   const validated = [];
   for (const item of items) {
-    const validatedProps = chunkVPYHY3LJ_cjs.validateNodeProps(nodeKind.schema, item.props, {
+    const validatedProps = chunk2THZ3TQI_cjs.validateNodeProps(nodeKind.schema, item.props, {
       kind,
       operation: "create"
     });
-    const applies = chunkXOX22WHL_cjs.checkWherePredicate(constraint, validatedProps);
-    const key = applies ? chunkXOX22WHL_cjs.computeUniqueKey(
+    const applies = chunkZUNQ5BEP_cjs.checkWherePredicate(constraint, validatedProps);
+    const key = applies ? chunkZUNQ5BEP_cjs.computeUniqueKey(
       validatedProps,
       constraint.fields,
       constraint.collation
@@ -934,7 +965,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 = chunkXOX22WHL_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkZUNQ5BEP_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -984,10 +1015,10 @@ function resolveNodeIndex(graph, kind, indexName) {
     (candidate) => candidate.entity === "node" && candidate.kind === kind && candidate.name === indexName
   );
   if (declaration?.entity !== "node") {
-    throw new chunkLGEALRC6_cjs.NodeIndexNotFoundError(indexName, kind);
+    throw new chunkDIK74MXX_cjs.NodeIndexNotFoundError(indexName, kind);
   }
   if (declaration.method !== void 0) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkDIK74MXX_cjs.ConfigurationError(
       `bulkFindByIndex cannot probe index "${indexName}" (method "${declaration.method}"): only btree indexes serve equality probes.`,
       { indexName, kind, method: declaration.method }
     );
@@ -1025,7 +1056,7 @@ function validateIndexProbeValue(value, valueType, pointer, kind) {
   }
 }
 function indexProbeTypeError(pointer, kind, expected, value) {
-  return new chunkLGEALRC6_cjs.ValidationError(
+  return new chunkDIK74MXX_cjs.ValidationError(
     `Index probe value for "${pointer}" on node kind "${kind}" has an incompatible type`,
     {
       entityType: "node",
@@ -1059,7 +1090,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 chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkDIK74MXX_cjs.ConfigurationError(
       `bulkFindByIndex requires an index with at least one prop-based field on index "${indexName}" (node kind "${kind}")`,
       { indexName, kind },
       {
@@ -1068,7 +1099,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
     );
   }
   if (index.fieldValueTypes.includes("date")) {
-    throw new chunkLGEALRC6_cjs.ConfigurationError(
+    throw new chunkDIK74MXX_cjs.ConfigurationError(
       `bulkFindByIndex does not support date-typed key fields on index "${indexName}" (node kind "${kind}")`,
       { indexName, kind },
       {
@@ -1078,7 +1109,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
   }
   const limitPerInput = options?.limitPerInput;
   if (limitPerInput !== void 0 && (!Number.isInteger(limitPerInput) || limitPerInput <= 0)) {
-    throw new chunkLGEALRC6_cjs.ValidationError(
+    throw new chunkDIK74MXX_cjs.ValidationError(
       "bulkFindByIndex limitPerInput must be a positive integer",
       {
         entityType: "node",
@@ -1120,7 +1151,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
     }
     groupToInputs[existing]?.push(inputIndex);
   }
-  const schema = backend.tableNames ? chunkXOX22WHL_cjs.createSqlSchema(backend.tableNames) : chunkXOX22WHL_cjs.DEFAULT_SQL_SCHEMA;
+  const schema = backend.tableNames ? chunkZUNQ5BEP_cjs.createSqlSchema(backend.tableNames) : chunkZUNQ5BEP_cjs.DEFAULT_SQL_SCHEMA;
   const compileContext = {
     dialect: backend.dialect,
     propsColumn: drizzleOrm.sql.raw(`"props"`),
@@ -1193,7 +1224,7 @@ function capMatchesPerGroup(matches, limitPerInput) {
   return capped;
 }
 async function hydrateNodesById(backend, graphId, kind, ids) {
-  const rowsById = await chunkXOX22WHL_cjs.getNodeRowsByIds(backend, graphId, kind, ids);
+  const rowsById = await chunkZUNQ5BEP_cjs.getNodeRowsByIds(backend, graphId, kind, ids);
   const nodesById = /* @__PURE__ */ new Map();
   for (const [id, row] of rowsById) {
     if (row.deleted_at !== void 0) continue;
@@ -1209,7 +1240,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 = chunkXOX22WHL_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkZUNQ5BEP_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -1323,6 +1354,7 @@ exports.executeNodeGetOrCreateByConstraint = executeNodeGetOrCreateByConstraint;
 exports.executeNodeHardDelete = executeNodeHardDelete;
 exports.executeNodeUpdate = executeNodeUpdate;
 exports.executeNodeUpsertUpdate = executeNodeUpsertUpdate;
+exports.nodeUpsertDirtyCheck = nodeUpsertDirtyCheck;
 exports.primeBatchValidationCaches = primeBatchValidationCaches;
 exports.rowToEdge = rowToEdge;
 exports.rowToEdgeMeta = rowToEdgeMeta;
@@ -1330,5 +1362,5 @@ exports.rowToNode = rowToNode;
 exports.rowToNodeMeta = rowToNodeMeta;
 exports.runHookedWriteOperation = runHookedWriteOperation;
 exports.runInWriteTransaction = runInWriteTransaction;
-//# sourceMappingURL=chunk-WJT7OU7E.cjs.map
-//# sourceMappingURL=chunk-WJT7OU7E.cjs.map
+//# sourceMappingURL=chunk-4CAXEB2F.cjs.map
+//# sourceMappingURL=chunk-4CAXEB2F.cjs.map