@nicia-ai/typegraph 0.44.0 → 0.45.0

package/dist/{chunk-NCX65HBY.cjs → chunk-UCQ3BFSY.cjs}

@@ -1,15 +1,16 @@
 'use strict';
 
-var chunk7V2FGGI2_cjs = require('./chunk-7V2FGGI2.cjs');
+var chunkJ7LXTUTP_cjs = require('./chunk-J7LXTUTP.cjs');
 var chunkCPEL3YIR_cjs = require('./chunk-CPEL3YIR.cjs');
-var chunk3PRKZW6D_cjs = require('./chunk-3PRKZW6D.cjs');
+var chunkEKFUG4G7_cjs = require('./chunk-EKFUG4G7.cjs');
 var chunkKKYELPZ2_cjs = require('./chunk-KKYELPZ2.cjs');
 var chunkACSVZPK7_cjs = require('./chunk-ACSVZPK7.cjs');
 var chunkZTAJL4DT_cjs = require('./chunk-ZTAJL4DT.cjs');
-var chunkOVUUTCPJ_cjs = require('./chunk-OVUUTCPJ.cjs');
+var chunkJXUTCSXX_cjs = require('./chunk-JXUTCSXX.cjs');
 var chunkU5W4LKZV_cjs = require('./chunk-U5W4LKZV.cjs');
 var chunk764JHTLT_cjs = require('./chunk-764JHTLT.cjs');
-var chunkA4PBRX4C_cjs = require('./chunk-A4PBRX4C.cjs');
+var chunkHAHNRASW_cjs = require('./chunk-HAHNRASW.cjs');
+var chunkD54WH24V_cjs = require('./chunk-D54WH24V.cjs');
 var chunkC4F7VJ5D_cjs = require('./chunk-C4F7VJ5D.cjs');
 var chunkTDXIBCGY_cjs = require('./chunk-TDXIBCGY.cjs');
 
@@ -18,8 +19,8 @@ function nullToUndefined(value) {
   return value === null ? void 0 : value;
 }
 function rowToNode(row) {
-  const rawProps = chunk3PRKZW6D_cjs.rowPropsToObject(row.props);
-  const props = chunkA4PBRX4C_cjs.filterReservedKeys(rawProps, chunkA4PBRX4C_cjs.RESERVED_NODE_KEYS);
+  const rawProps = chunkEKFUG4G7_cjs.rowPropsToObject(row.props);
+  const props = chunkD54WH24V_cjs.filterReservedKeys(rawProps, chunkD54WH24V_cjs.RESERVED_NODE_KEYS);
   return {
     kind: row.kind,
     id: row.id,
@@ -38,8 +39,8 @@ function rowToNodeMeta(row) {
   };
 }
 function rowToEdge(row) {
-  const rawProps = chunk3PRKZW6D_cjs.rowPropsToObject(row.props);
-  const props = chunkA4PBRX4C_cjs.filterReservedKeys(rawProps, chunkA4PBRX4C_cjs.RESERVED_EDGE_KEYS);
+  const rawProps = chunkEKFUG4G7_cjs.rowPropsToObject(row.props);
+  const props = chunkD54WH24V_cjs.filterReservedKeys(rawProps, chunkD54WH24V_cjs.RESERVED_EDGE_KEYS);
   return {
     id: row.id,
     kind: row.kind,
@@ -89,14 +90,14 @@ async function lockSchemaVersionForStoreWrite(ctx, backend) {
     expectedVersion
   });
 }
-function runInWriteTransaction(ctx, backend, fn) {
+function runInWriteTransaction(ctx, backend, fn, options) {
   const ownsWriteLock = "transaction" in backend && backend.capabilities.transactions;
-  return chunk3PRKZW6D_cjs.runOptionallyInTransaction(backend, async (target) => {
+  return chunkEKFUG4G7_cjs.runOptionallyInTransaction(backend, async (target) => {
     await lockSchemaVersionForStoreWrite(ctx, target);
-    const lock = ctx.historyEnabled || ctx.revisionTrackingEnabled ? await chunk7V2FGGI2_cjs.lockRecordedGraphWrite(target, ctx.graphId) : chunk7V2FGGI2_cjs.uncapturedGraphWriteLock();
+    const lock = ctx.historyEnabled || ctx.revisionTrackingEnabled ? await chunkJ7LXTUTP_cjs.lockRecordedGraphWrite(target, ctx.graphId) : chunkJ7LXTUTP_cjs.uncapturedGraphWriteLock();
     const result = await fn(target, lock);
-    if (ctx.revisionTrackingEnabled && !ctx.historyEnabled) {
-      await chunk7V2FGGI2_cjs.advanceRevisionClock(
+    if (ctx.revisionTrackingEnabled && !ctx.historyEnabled && (options?.didWrite?.(result) ?? true)) {
+      await chunkJ7LXTUTP_cjs.advanceRevisionClock(
         target,
         ctx.revisionSchema,
         ctx.graphId,
@@ -119,7 +120,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 = chunk7V2FGGI2_cjs.checkDisjointness(id, kind, [disjointKind], ctx.registry);
+      const error = chunkJ7LXTUTP_cjs.checkDisjointness(id, kind, [disjointKind], ctx.registry);
       if (error) throw error;
     }
   }
@@ -136,7 +137,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         fromKind,
         fromId
       });
-      const error = chunk7V2FGGI2_cjs.checkCardinality(
+      const error = chunkJ7LXTUTP_cjs.checkCardinality(
         edgeKind,
         fromKind,
         fromId,
@@ -156,7 +157,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         toKind,
         toId
       });
-      const error = chunk7V2FGGI2_cjs.checkUniqueEdge(
+      const error = chunkJ7LXTUTP_cjs.checkUniqueEdge(
         edgeKind,
         fromKind,
         fromId,
@@ -178,7 +179,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         fromId,
         activeOnly: true
       });
-      const error = chunk7V2FGGI2_cjs.checkCardinality(
+      const error = chunkJ7LXTUTP_cjs.checkCardinality(
         edgeKind,
         fromKind,
         fromId,
@@ -308,8 +309,8 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
   }
   function registerPendingUniqueEntries(kind, id, props, constraints) {
     for (const constraint of constraints) {
-      if (!chunk7V2FGGI2_cjs.checkWherePredicate(constraint, props)) continue;
-      const key = chunk7V2FGGI2_cjs.computeUniqueKey(
+      if (!chunkJ7LXTUTP_cjs.checkWherePredicate(constraint, props)) continue;
+      const key = chunkJ7LXTUTP_cjs.computeUniqueKey(
         props,
         constraint.fields,
         constraint.collation
@@ -322,7 +323,7 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
       );
       pendingUniqueOwners.set(concreteEntryKey, id);
       if (constraint.scope !== "kind") {
-        const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
+        const kindsToCheck = chunkJ7LXTUTP_cjs.getKindsForUniquenessCheck(
           kind,
           constraint.scope,
           registry
@@ -341,12 +342,12 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
   }
   function registerAppliedNodeUpdate(kind, id, oldProps, newProps, constraints) {
     for (const constraint of constraints) {
-      const oldApplies = chunk7V2FGGI2_cjs.checkWherePredicate(constraint, oldProps);
-      const newApplies = chunk7V2FGGI2_cjs.checkWherePredicate(constraint, newProps);
-      const oldKey = oldApplies ? chunk7V2FGGI2_cjs.computeUniqueKey(oldProps, constraint.fields, constraint.collation) : void 0;
-      const newKey = newApplies ? chunk7V2FGGI2_cjs.computeUniqueKey(newProps, constraint.fields, constraint.collation) : void 0;
+      const oldApplies = chunkJ7LXTUTP_cjs.checkWherePredicate(constraint, oldProps);
+      const newApplies = chunkJ7LXTUTP_cjs.checkWherePredicate(constraint, newProps);
+      const oldKey = oldApplies ? chunkJ7LXTUTP_cjs.computeUniqueKey(oldProps, constraint.fields, constraint.collation) : void 0;
+      const newKey = newApplies ? chunkJ7LXTUTP_cjs.computeUniqueKey(newProps, constraint.fields, constraint.collation) : void 0;
       if (oldKey === newKey) continue;
-      const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
+      const kindsToCheck = chunkJ7LXTUTP_cjs.getKindsForUniquenessCheck(
         kind,
         constraint.scope,
         registry
@@ -386,7 +387,7 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
     if (uniqueCache.has(cacheKey)) return;
     uniqueCache.set(cacheKey, row);
   }
-  const validationBackend = chunk3PRKZW6D_cjs.createBackendOverlay(backend, {
+  const validationBackend = chunkEKFUG4G7_cjs.createBackendOverlay(backend, {
     getNode: getNodeCached,
     checkUnique: checkUniqueCached
   });
@@ -429,8 +430,8 @@ async function finishNodeCreatePreparation(ctx, draft, backend) {
     backend
   };
   await checkDisjointnessConstraint(constraintContext, kind, id);
-  await chunk7V2FGGI2_cjs.checkUniquenessConstraints(
-    chunk7V2FGGI2_cjs.createUniquenessContext(ctx.graphId, ctx.registry, backend),
+  await chunkJ7LXTUTP_cjs.checkUniquenessConstraints(
+    chunkJ7LXTUTP_cjs.createUniquenessContext(ctx.graphId, ctx.registry, backend),
     kind,
     id,
     validatedProps,
@@ -460,8 +461,8 @@ async function validateAndPrepareNodeCreate(ctx, input, id, backend, options) {
   );
 }
 async function finalizeNodeCreateBatch(ctx, preparedCreates, backend, lock) {
-  await chunk7V2FGGI2_cjs.applyNodeInsertSideEffectsBatch(
-    chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+  await chunkJ7LXTUTP_cjs.applyNodeInsertSideEffectsBatch(
+    chunkJ7LXTUTP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
     preparedCreates.map((prepared) => ({
       kind: prepared.kind,
       id: prepared.id,
@@ -473,8 +474,8 @@ async function finalizeNodeCreateBatch(ctx, preparedCreates, backend, lock) {
   );
 }
 async function finalizeNodeCreate(ctx, prepared, backend, lock) {
-  await chunk7V2FGGI2_cjs.applyNodeInsertSideEffects(
-    chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+  await chunkJ7LXTUTP_cjs.applyNodeInsertSideEffects(
+    chunkJ7LXTUTP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
     {
       kind: prepared.kind,
       id: prepared.id,
@@ -495,7 +496,7 @@ function computeNodeUpdate(ctx, kind, id, existingProps, inputProps) {
   return { registration, validatedProps };
 }
 function resolveNodeUpdateProps(ctx, existing, inputProps) {
-  const existingProps = chunk3PRKZW6D_cjs.rowPropsToObject(existing.props);
+  const existingProps = chunkEKFUG4G7_cjs.rowPropsToObject(existing.props);
   const { registration, validatedProps } = computeNodeUpdate(
     ctx,
     existing.kind,
@@ -529,7 +530,7 @@ async function performNodeUpdate(ctx, input, backend, lock, options) {
   );
   const nodeKind = registration.type;
   const validTo = chunkZTAJL4DT_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo");
-  const writeContext = chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock);
+  const writeContext = chunkJ7LXTUTP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock);
   const shared = {
     schema: nodeKind.schema,
     validatedProps,
@@ -537,15 +538,15 @@ async function performNodeUpdate(ctx, input, backend, lock, options) {
     ...validTo !== void 0 && { validTo }
   };
   if (options?.clearDeleted) {
-    const row2 = await chunk7V2FGGI2_cjs.applyNodeUpdate(
+    const row2 = await chunkJ7LXTUTP_cjs.applyNodeUpdate(
       writeContext,
       { ...shared, existing, clearDeleted: true },
       backend
     );
     return rowToNode(row2);
   }
-  if (!chunk3PRKZW6D_cjs.isLiveNodeRow(existing)) throw new chunkC4F7VJ5D_cjs.NodeNotFoundError(kind, id);
-  const row = await chunk7V2FGGI2_cjs.applyNodeUpdate(
+  if (!chunkEKFUG4G7_cjs.isLiveNodeRow(existing)) throw new chunkC4F7VJ5D_cjs.NodeNotFoundError(kind, id);
+  const row = await chunkJ7LXTUTP_cjs.applyNodeUpdate(
     writeContext,
     { ...shared, existing },
     backend
@@ -573,13 +574,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 (!chunk7V2FGGI2_cjs.checkWherePredicate(constraint, draft.validatedProps)) continue;
-        const key = chunk7V2FGGI2_cjs.computeUniqueKey(
+        if (!chunkJ7LXTUTP_cjs.checkWherePredicate(constraint, draft.validatedProps)) continue;
+        const key = chunkJ7LXTUTP_cjs.computeUniqueKey(
           draft.validatedProps,
           constraint.fields,
           constraint.collation
         );
-        const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
+        const kindsToCheck = chunkJ7LXTUTP_cjs.getKindsForUniquenessCheck(
           draft.kind,
           constraint.scope,
           ctx.registry
@@ -625,7 +626,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 ?? chunk7V2FGGI2_cjs.generateId(), options)
+    (input) => draftNodeCreate(ctx, input, input.id ?? chunkJ7LXTUTP_cjs.generateId(), options)
   );
   await primeBatchValidationCaches(ctx, drafts, backend, {
     seedNodeRow,
@@ -701,7 +702,7 @@ async function batchCheckUniqueAcrossKinds(backend, graphId, constraintName, uni
 }
 async function executeNodeCreateInternal(ctx, input, backend, options) {
   const kind = input.kind;
-  const id = input.id ?? chunk7V2FGGI2_cjs.generateId();
+  const id = input.id ?? chunkJ7LXTUTP_cjs.generateId();
   const opContext = ctx.createOperationContext("create", "node", kind, id);
   const shouldReturnRow = options?.returnRow ?? true;
   return runHookedWriteOperation(
@@ -720,8 +721,8 @@ async function executeNodeCreateInternal(ctx, input, backend, options) {
       if (shouldReturnRow) {
         row = await target.insertNode(prepared.insertParams);
       } else {
-        await chunk7V2FGGI2_cjs.runInsertNoReturn(
-          chunk7V2FGGI2_cjs.nodeInsertDispatch(target),
+        await chunkJ7LXTUTP_cjs.runInsertNoReturn(
+          chunkJ7LXTUTP_cjs.nodeInsertDispatch(target),
           prepared.insertParams
         );
       }
@@ -752,7 +753,7 @@ async function executeNodeCreateNoReturnBatch(ctx, inputs, backend) {
       inputs,
       target
     );
-    await chunk7V2FGGI2_cjs.runInsertBatch(chunk7V2FGGI2_cjs.nodeInsertDispatch(target), batchInsertParams);
+    await chunkJ7LXTUTP_cjs.runInsertBatch(chunkJ7LXTUTP_cjs.nodeInsertDispatch(target), batchInsertParams);
     await finalizeNodeCreateBatch(ctx, preparedCreates, target, lock);
   });
 }
@@ -765,8 +766,8 @@ async function executeNodeCreateBatch(ctx, inputs, backend, options) {
       target,
       options
     );
-    const rows = await chunk7V2FGGI2_cjs.runInsertBatchReturning(
-      chunk7V2FGGI2_cjs.nodeInsertDispatch(target),
+    const rows = await chunkJ7LXTUTP_cjs.runInsertBatchReturning(
+      chunkJ7LXTUTP_cjs.nodeInsertDispatch(target),
       batchInsertParams
     );
     await finalizeNodeCreateBatch(ctx, preparedCreates, target, lock);
@@ -787,6 +788,237 @@ async function executeNodeUpdate(ctx, input, backend, options) {
     (target, lock) => performNodeUpdate(ctx, input, target, lock, options)
   );
 }
+async function executeNodeUpdateWhere(ctx, kind, inputPatch, candidateIds, candidateIdColumn, backend) {
+  const registration = getNodeRegistration(ctx.graph, kind);
+  const schema = registration.type.schema;
+  const uniqueConstraints = registration.unique ?? [];
+  if (!backend.capabilities.transactions) {
+    throw new chunkC4F7VJ5D_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 chunkC4F7VJ5D_cjs.ConfigurationError(
+      "This backend does not support set-based node updates",
+      { code: "SET_UPDATE_UNSUPPORTED", kind }
+    );
+  }
+  if (Object.keys(inputPatch).length === 0) {
+    throw new chunkC4F7VJ5D_cjs.ValidationError("updateWhere() patch must not be empty", {
+      entityType: "node",
+      kind,
+      operation: "update",
+      issues: [{ path: "patch", message: "Provide at least one property" }]
+    });
+  }
+  const unknownProperty = Object.keys(inputPatch).find(
+    (property) => !Object.hasOwn(schema.shape, property)
+  );
+  if (unknownProperty !== void 0) {
+    throw new chunkC4F7VJ5D_cjs.ValidationError(
+      `Unknown ${kind} property in updateWhere() patch: ${unknownProperty}`,
+      {
+        entityType: "node",
+        kind,
+        operation: "update",
+        issues: [
+          {
+            path: unknownProperty,
+            message: "Property is not declared by the node schema"
+          }
+        ]
+      }
+    );
+  }
+  const parsedPatch = chunkKKYELPZ2_cjs.validateNodeProps(schema.partial(), inputPatch, {
+    kind,
+    operation: "update"
+  });
+  const patch = {};
+  const unsetProperties = [];
+  for (const [property, value] of Object.entries(parsedPatch)) {
+    if (value === void 0) {
+      unsetProperties.push(property);
+      continue;
+    }
+    chunkD54WH24V_cjs.assertJsonValue(value, property, `Node "${kind}" updateWhere patch`);
+    patch[property] = value;
+  }
+  if (Object.keys(patch).length === 0 && unsetProperties.length === 0) {
+    throw new chunkC4F7VJ5D_cjs.ValidationError(
+      "updateWhere() patch has no recognized properties",
+      {
+        entityType: "node",
+        kind,
+        operation: "update",
+        issues: [
+          { path: "patch", message: "Provide a declared node property" }
+        ]
+      }
+    );
+  }
+  if (uniqueConstraints.length > 0 && (backend.hardDeleteUniquesByNodeIds === void 0 || backend.insertUniqueBatch === void 0 || backend.checkUniqueBatch === void 0)) {
+    throw new chunkC4F7VJ5D_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 chunkC4F7VJ5D_cjs.ConfigurationError(
+      "updateWhere() requires batched fulltext sidecar operations for searchable nodes",
+      { code: "SET_UPDATE_FULLTEXT_UNSUPPORTED", kind }
+    );
+  }
+  if (chunkJ7LXTUTP_cjs.getEmbeddingFields(schema).length > 0 && (backend.upsertEmbedding === void 0 || backend.deleteEmbedding === void 0 || backend.upsertEmbeddingBatch === void 0 || backend.deleteEmbeddingBatch === void 0)) {
+    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+      "updateWhere() requires batched vector sidecar operations for embedded nodes",
+      { code: "SET_UPDATE_VECTOR_UNSUPPORTED", kind }
+    );
+  }
+  const hookContext = ctx.createBulkOperationContext("updateWhere", kind);
+  return ctx.withBulkOperationHooks(
+    hookContext,
+    () => runInWriteTransaction(
+      ctx,
+      backend,
+      async (target, lock) => {
+        const updateNodeSet = target.updateNodeSet;
+        if (updateNodeSet === void 0) {
+          throw new chunkC4F7VJ5D_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 chunkC4F7VJ5D_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 chunkC4F7VJ5D_cjs.ConfigurationError(
+            "The transaction backend lacks batched fulltext operations",
+            { code: "SET_UPDATE_FULLTEXT_UNSUPPORTED", kind }
+          );
+        }
+        if (chunkJ7LXTUTP_cjs.getEmbeddingFields(schema).length > 0 && (target.upsertEmbedding === void 0 || target.deleteEmbedding === void 0 || target.upsertEmbeddingBatch === void 0 || target.deleteEmbeddingBatch === void 0)) {
+          throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+            "The transaction backend lacks batched vector operations",
+            { code: "SET_UPDATE_VECTOR_UNSUPPORTED", kind }
+          );
+        }
+        const result = await updateNodeSet({
+          graphId: ctx.graphId,
+          kind,
+          patch,
+          unsetProperties,
+          candidateIds,
+          candidateIdColumn
+        });
+        if (result.affectedCount === 0) return { affectedCount: 0 };
+        const sidecarItems = result.rows.map((row) => {
+          const props = chunkEKFUG4G7_cjs.rowPropsToObject(row.props);
+          const validatedProps = chunkKKYELPZ2_cjs.validateNodeProps(schema, props, {
+            kind,
+            operation: "update",
+            id: row.id
+          });
+          if (!chunkACSVZPK7_cjs.canonicalEqual(validatedProps, props)) {
+            throw new chunkC4F7VJ5D_cjs.ValidationError(
+              `Set update would persist a non-canonical ${kind} row`,
+              {
+                entityType: "node",
+                kind,
+                operation: "update",
+                id: row.id,
+                issues: [
+                  {
+                    path: "props",
+                    message: "The complete row requires schema normalization"
+                  }
+                ]
+              }
+            );
+          }
+          return {
+            kind,
+            id: row.id,
+            schema,
+            props: validatedProps,
+            uniqueConstraints
+          };
+        });
+        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 (!chunkJ7LXTUTP_cjs.checkWherePredicate(constraint, item.props)) continue;
+              const key = chunkJ7LXTUTP_cjs.computeUniqueKey(
+                item.props,
+                constraint.fields,
+                constraint.collation
+              );
+              const priorId = keyToId.get(key);
+              if (priorId !== void 0 && priorId !== item.id) {
+                throw new chunkC4F7VJ5D_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 chunkJ7LXTUTP_cjs.getKindsForUniquenessCheck(
+              kind,
+              constraint.scope,
+              ctx.registry
+            )) {
+              const existingRows = await chunk764JHTLT_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 chunkC4F7VJ5D_cjs.UniquenessError({
+                  constraintName: constraint.name,
+                  kind: kindToCheck,
+                  existingId: existing.node_id,
+                  newId: chunk764JHTLT_cjs.requireDefined(keyToId.get(existing.key)),
+                  fields: constraint.fields
+                });
+              }
+            }
+          }
+          await chunk764JHTLT_cjs.requireDefined(hardDeleteUniquesByNodeIds)({
+            graphId: ctx.graphId,
+            concreteKind: kind,
+            nodeIds: result.rows.map((row) => row.id)
+          });
+        }
+        await chunkJ7LXTUTP_cjs.applyNodeInsertSideEffectsBatch(
+          chunkJ7LXTUTP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+          sidecarItems,
+          target
+        );
+        return { affectedCount: result.affectedCount };
+      },
+      { didWrite: (result) => result.affectedCount > 0 }
+    )
+  );
+}
 async function executeNodeUpsertUpdate(ctx, input, backend, options) {
   return runInWriteTransaction(
     ctx,
@@ -805,9 +1037,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 || !chunk3PRKZW6D_cjs.isLiveNodeRow(preflight)) return;
-      await chunk7V2FGGI2_cjs.applyNodeSoftDelete(
-        chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+      if (!preflight || !chunkEKFUG4G7_cjs.isLiveNodeRow(preflight)) return;
+      await chunkJ7LXTUTP_cjs.applyNodeSoftDelete(
+        chunkJ7LXTUTP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
         {
           existing: preflight,
           schema: registration.type.schema,
@@ -829,8 +1061,8 @@ async function executeNodeHardDelete(ctx, kind, id, backend) {
     backend,
     async (target, lock) => {
       const registration = getNodeRegistration(ctx.graph, kind);
-      await chunk7V2FGGI2_cjs.applyNodeHardDelete(
-        chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+      await chunkJ7LXTUTP_cjs.applyNodeHardDelete(
+        chunkJ7LXTUTP_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
         {
           kind,
           id,
@@ -851,7 +1083,7 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
     operation: "create"
   });
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
-  if (!chunk7V2FGGI2_cjs.checkWherePredicate(constraint, validatedProps)) {
+  if (!chunkJ7LXTUTP_cjs.checkWherePredicate(constraint, validatedProps)) {
     const node = await executeNodeCreate(
       ctx,
       { kind, props: validatedProps },
@@ -860,12 +1092,12 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
     );
     return { node, action: "created" };
   }
-  const key = chunk7V2FGGI2_cjs.computeUniqueKey(
+  const key = chunkJ7LXTUTP_cjs.computeUniqueKey(
     validatedProps,
     constraint.fields,
     constraint.collation
   );
-  const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkJ7LXTUTP_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -934,13 +1166,13 @@ async function executeNodeFindByConstraint(ctx, kind, constraintName, props, bac
     operation: "create"
   });
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
-  if (!chunk7V2FGGI2_cjs.checkWherePredicate(constraint, validatedProps)) return void 0;
-  const key = chunk7V2FGGI2_cjs.computeUniqueKey(
+  if (!chunkJ7LXTUTP_cjs.checkWherePredicate(constraint, validatedProps)) return void 0;
+  const key = chunkJ7LXTUTP_cjs.computeUniqueKey(
     validatedProps,
     constraint.fields,
     constraint.collation
   );
-  const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkJ7LXTUTP_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -970,8 +1202,8 @@ function validateAndComputeKeys(nodeKind, kind, constraint, items) {
       kind,
       operation: "create"
     });
-    const applies = chunk7V2FGGI2_cjs.checkWherePredicate(constraint, validatedProps);
-    const key = applies ? chunk7V2FGGI2_cjs.computeUniqueKey(
+    const applies = chunkJ7LXTUTP_cjs.checkWherePredicate(constraint, validatedProps);
+    const key = applies ? chunkJ7LXTUTP_cjs.computeUniqueKey(
       validatedProps,
       constraint.fields,
       constraint.collation
@@ -994,7 +1226,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 = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkJ7LXTUTP_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -1153,7 +1385,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
       }
     );
   }
-  const adapter = chunkOVUUTCPJ_cjs.getDialect(backend.dialect);
+  const adapter = chunkJXUTCSXX_cjs.getDialect(backend.dialect);
   const probes = items.map(
     (item) => index.fields.map((pointer, position) => {
       const value = chunkTDXIBCGY_cjs.resolveJsonPointer(item.props, pointer);
@@ -1186,7 +1418,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
     propsColumn: chunkU5W4LKZV_cjs.sql.raw(`"props"`),
     systemColumn: (column) => chunkU5W4LKZV_cjs.sql.raw(`"${column}"`)
   };
-  const fieldKeys = chunkOVUUTCPJ_cjs.compileNodeIndexFieldKeys(index, compileContext);
+  const fieldKeys = chunkJXUTCSXX_cjs.compileNodeIndexFieldKeys(index, compileContext);
   const groupPredicates = groupProbes.map(
     (probe) => chunkU5W4LKZV_cjs.sql`(${chunkU5W4LKZV_cjs.sql.join(
       fieldKeys.map((fieldKey, position) => {
@@ -1212,7 +1444,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
     chunkU5W4LKZV_cjs.sql`"deleted_at" IS NULL`
   ];
   if (index.where !== void 0) {
-    conditions.push(chunkOVUUTCPJ_cjs.compileIndexWhere(compileContext, index.where));
+    conditions.push(chunkJXUTCSXX_cjs.compileIndexWhere(compileContext, index.where));
   }
   conditions.push(chunkU5W4LKZV_cjs.sql`(${chunkU5W4LKZV_cjs.sql.join(groupPredicates, chunkU5W4LKZV_cjs.sql` OR `)})`);
   const whereClause = chunkU5W4LKZV_cjs.sql.join(conditions, chunkU5W4LKZV_cjs.sql` AND `);
@@ -1253,7 +1485,7 @@ function capMatchesPerGroup(matches, limitPerInput) {
   return capped;
 }
 async function hydrateNodesById(backend, graphId, kind, ids) {
-  const rowsById = await chunk7V2FGGI2_cjs.getNodeRowsByIds(backend, graphId, kind, ids);
+  const rowsById = await chunkJ7LXTUTP_cjs.getNodeRowsByIds(backend, graphId, kind, ids);
   const nodesById = /* @__PURE__ */ new Map();
   for (const [id, row] of rowsById) {
     if (row.deleted_at !== void 0) continue;
@@ -1269,7 +1501,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 = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunkJ7LXTUTP_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -1382,6 +1614,7 @@ exports.executeNodeFindByConstraint = executeNodeFindByConstraint;
 exports.executeNodeGetOrCreateByConstraint = executeNodeGetOrCreateByConstraint;
 exports.executeNodeHardDelete = executeNodeHardDelete;
 exports.executeNodeUpdate = executeNodeUpdate;
+exports.executeNodeUpdateWhere = executeNodeUpdateWhere;
 exports.executeNodeUpsertUpdate = executeNodeUpsertUpdate;
 exports.lockSchemaVersionForStoreWrite = lockSchemaVersionForStoreWrite;
 exports.nodeUpsertDirtyCheck = nodeUpsertDirtyCheck;
@@ -1392,5 +1625,5 @@ exports.rowToNode = rowToNode;
 exports.rowToNodeMeta = rowToNodeMeta;
 exports.runHookedWriteOperation = runHookedWriteOperation;
 exports.runInWriteTransaction = runInWriteTransaction;
-//# sourceMappingURL=chunk-NCX65HBY.cjs.map
-//# sourceMappingURL=chunk-NCX65HBY.cjs.map
+//# sourceMappingURL=chunk-UCQ3BFSY.cjs.map
+//# sourceMappingURL=chunk-UCQ3BFSY.cjs.map