@nicia-ai/typegraph 0.42.1 → 0.44.0

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

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunk2SO5I5AI_cjs = require('./chunk-2SO5I5AI.cjs');
-var chunkCVK4T34X_cjs = require('./chunk-CVK4T34X.cjs');
-var chunkECU53PMN_cjs = require('./chunk-ECU53PMN.cjs');
-var chunkARN3ZODS_cjs = require('./chunk-ARN3ZODS.cjs');
+var chunk7V2FGGI2_cjs = require('./chunk-7V2FGGI2.cjs');
+var chunkCPEL3YIR_cjs = require('./chunk-CPEL3YIR.cjs');
+var chunk3PRKZW6D_cjs = require('./chunk-3PRKZW6D.cjs');
+var chunkKKYELPZ2_cjs = require('./chunk-KKYELPZ2.cjs');
 var chunkACSVZPK7_cjs = require('./chunk-ACSVZPK7.cjs');
-var chunkZBV4LQD2_cjs = require('./chunk-ZBV4LQD2.cjs');
-var chunkUTTW2Q3M_cjs = require('./chunk-UTTW2Q3M.cjs');
-var chunkX2XOQZT3_cjs = require('./chunk-X2XOQZT3.cjs');
+var chunkZTAJL4DT_cjs = require('./chunk-ZTAJL4DT.cjs');
+var chunkOVUUTCPJ_cjs = require('./chunk-OVUUTCPJ.cjs');
+var chunkU5W4LKZV_cjs = require('./chunk-U5W4LKZV.cjs');
 var chunk764JHTLT_cjs = require('./chunk-764JHTLT.cjs');
-var chunkO2GZM7UK_cjs = require('./chunk-O2GZM7UK.cjs');
-var chunkKTBTSHU6_cjs = require('./chunk-KTBTSHU6.cjs');
+var chunkA4PBRX4C_cjs = require('./chunk-A4PBRX4C.cjs');
+var chunkC4F7VJ5D_cjs = require('./chunk-C4F7VJ5D.cjs');
 var chunkTDXIBCGY_cjs = require('./chunk-TDXIBCGY.cjs');
 
 // src/store/row-mappers.ts
@@ -18,8 +18,8 @@ function nullToUndefined(value) {
   return value === null ? void 0 : value;
 }
 function rowToNode(row) {
-  const rawProps = chunkECU53PMN_cjs.rowPropsToObject(row.props);
-  const props = chunkO2GZM7UK_cjs.filterReservedKeys(rawProps, chunkO2GZM7UK_cjs.RESERVED_NODE_KEYS);
+  const rawProps = chunk3PRKZW6D_cjs.rowPropsToObject(row.props);
+  const props = chunkA4PBRX4C_cjs.filterReservedKeys(rawProps, chunkA4PBRX4C_cjs.RESERVED_NODE_KEYS);
   return {
     kind: row.kind,
     id: row.id,
@@ -38,8 +38,8 @@ function rowToNodeMeta(row) {
   };
 }
 function rowToEdge(row) {
-  const rawProps = chunkECU53PMN_cjs.rowPropsToObject(row.props);
-  const props = chunkO2GZM7UK_cjs.filterReservedKeys(rawProps, chunkO2GZM7UK_cjs.RESERVED_EDGE_KEYS);
+  const rawProps = chunk3PRKZW6D_cjs.rowPropsToObject(row.props);
+  const props = chunkA4PBRX4C_cjs.filterReservedKeys(rawProps, chunkA4PBRX4C_cjs.RESERVED_EDGE_KEYS);
   return {
     id: row.id,
     kind: row.kind,
@@ -62,13 +62,41 @@ function rowToEdgeMeta(row) {
 }
 
 // src/store/operations/write-transaction.ts
+async function lockSchemaVersionForStoreWrite(ctx, backend) {
+  const expectedVersion = ctx.schemaVersion;
+  if (expectedVersion === void 0) return;
+  if ("transaction" in backend && !backend.capabilities.transactions) {
+    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+      "Schema-managed Store writes require a transactional backend so schema changes and entity writes can share one fence.",
+      {
+        code: "SCHEMA_WRITE_FENCE_UNSUPPORTED",
+        graphId: ctx.graphId
+      }
+    );
+  }
+  const lockSchemaVersionForWrite = backend.lockSchemaVersionForWrite;
+  if (lockSchemaVersionForWrite === void 0) {
+    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
+      "This backend cannot fence schema-managed Store writes against a concurrent schema change.",
+      {
+        code: "SCHEMA_WRITE_FENCE_UNSUPPORTED",
+        graphId: ctx.graphId
+      }
+    );
+  }
+  await lockSchemaVersionForWrite({
+    graphId: ctx.graphId,
+    expectedVersion
+  });
+}
 function runInWriteTransaction(ctx, backend, fn) {
   const ownsWriteLock = "transaction" in backend && backend.capabilities.transactions;
-  return chunkECU53PMN_cjs.runOptionallyInTransaction(backend, async (target) => {
-    const lock = ctx.historyEnabled || ctx.revisionTrackingEnabled ? await chunk2SO5I5AI_cjs.lockRecordedGraphWrite(target, ctx.graphId) : chunk2SO5I5AI_cjs.uncapturedGraphWriteLock();
+  return chunk3PRKZW6D_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 result = await fn(target, lock);
     if (ctx.revisionTrackingEnabled && !ctx.historyEnabled) {
-      await chunk2SO5I5AI_cjs.advanceRevisionClock(
+      await chunk7V2FGGI2_cjs.advanceRevisionClock(
         target,
         ctx.revisionSchema,
         ctx.graphId,
@@ -91,7 +119,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 = chunk2SO5I5AI_cjs.checkDisjointness(id, kind, [disjointKind], ctx.registry);
+      const error = chunk7V2FGGI2_cjs.checkDisjointness(id, kind, [disjointKind], ctx.registry);
       if (error) throw error;
     }
   }
@@ -108,7 +136,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         fromKind,
         fromId
       });
-      const error = chunk2SO5I5AI_cjs.checkCardinality(
+      const error = chunk7V2FGGI2_cjs.checkCardinality(
         edgeKind,
         fromKind,
         fromId,
@@ -128,7 +156,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         toKind,
         toId
       });
-      const error = chunk2SO5I5AI_cjs.checkUniqueEdge(
+      const error = chunk7V2FGGI2_cjs.checkUniqueEdge(
         edgeKind,
         fromKind,
         fromId,
@@ -150,7 +178,7 @@ async function checkCardinalityConstraint(ctx, edgeKind, cardinality, fromKind,
         fromId,
         activeOnly: true
       });
-      const error = chunk2SO5I5AI_cjs.checkCardinality(
+      const error = chunk7V2FGGI2_cjs.checkCardinality(
         edgeKind,
         fromKind,
         fromId,
@@ -167,7 +195,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 chunkKTBTSHU6_cjs.KindNotFoundError(kind, "node");
+  if (registration === void 0) throw new chunkC4F7VJ5D_cjs.KindNotFoundError(kind, "node");
   return registration;
 }
 var CACHE_KEY_SEPARATOR = "\0";
@@ -178,7 +206,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 chunkKTBTSHU6_cjs.ValidationError(
+  return new chunkC4F7VJ5D_cjs.ValidationError(
     `Node already exists: ${kind}/${id}`,
     {
       entityType: "node",
@@ -219,7 +247,7 @@ function resolveConstraint(graph, kind, constraintName) {
     (candidate) => candidate.name === constraintName
   );
   if (constraint === void 0) {
-    throw new chunkKTBTSHU6_cjs.NodeConstraintNotFoundError(constraintName, kind);
+    throw new chunkC4F7VJ5D_cjs.NodeConstraintNotFoundError(constraintName, kind);
   }
   return constraint;
 }
@@ -280,8 +308,8 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
   }
   function registerPendingUniqueEntries(kind, id, props, constraints) {
     for (const constraint of constraints) {
-      if (!chunk2SO5I5AI_cjs.checkWherePredicate(constraint, props)) continue;
-      const key = chunk2SO5I5AI_cjs.computeUniqueKey(
+      if (!chunk7V2FGGI2_cjs.checkWherePredicate(constraint, props)) continue;
+      const key = chunk7V2FGGI2_cjs.computeUniqueKey(
         props,
         constraint.fields,
         constraint.collation
@@ -294,7 +322,7 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
       );
       pendingUniqueOwners.set(concreteEntryKey, id);
       if (constraint.scope !== "kind") {
-        const kindsToCheck = chunk2SO5I5AI_cjs.getKindsForUniquenessCheck(
+        const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
           kind,
           constraint.scope,
           registry
@@ -313,12 +341,12 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
   }
   function registerAppliedNodeUpdate(kind, id, oldProps, newProps, constraints) {
     for (const constraint of constraints) {
-      const oldApplies = chunk2SO5I5AI_cjs.checkWherePredicate(constraint, oldProps);
-      const newApplies = chunk2SO5I5AI_cjs.checkWherePredicate(constraint, newProps);
-      const oldKey = oldApplies ? chunk2SO5I5AI_cjs.computeUniqueKey(oldProps, constraint.fields, constraint.collation) : void 0;
-      const newKey = newApplies ? chunk2SO5I5AI_cjs.computeUniqueKey(newProps, constraint.fields, constraint.collation) : void 0;
+      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;
       if (oldKey === newKey) continue;
-      const kindsToCheck = chunk2SO5I5AI_cjs.getKindsForUniquenessCheck(
+      const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
         kind,
         constraint.scope,
         registry
@@ -358,7 +386,7 @@ function createNodeBatchValidationBackend(graphId, registry, backend) {
     if (uniqueCache.has(cacheKey)) return;
     uniqueCache.set(cacheKey, row);
   }
-  const validationBackend = chunkECU53PMN_cjs.createBackendOverlay(backend, {
+  const validationBackend = chunk3PRKZW6D_cjs.createBackendOverlay(backend, {
     getNode: getNodeCached,
     checkUnique: checkUniqueCached
   });
@@ -375,7 +403,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 : chunkARN3ZODS_cjs.validateNodeProps(nodeKind.schema, input.props, {
+  const validatedProps = options?.propsPreValidated === true ? input.props : chunkKKYELPZ2_cjs.validateNodeProps(nodeKind.schema, input.props, {
     kind,
     operation: "create"
   });
@@ -385,8 +413,8 @@ function draftNodeCreate(ctx, input, id, options) {
     nodeKind,
     uniqueConstraints: registration.unique ?? [],
     validatedProps,
-    validFrom: chunkZBV4LQD2_cjs.validateOptionalCanonicalIsoDate(input.validFrom, "validFrom"),
-    validTo: chunkZBV4LQD2_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo")
+    validFrom: chunkZTAJL4DT_cjs.validateOptionalCanonicalIsoDate(input.validFrom, "validFrom"),
+    validTo: chunkZTAJL4DT_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo")
   };
 }
 async function finishNodeCreatePreparation(ctx, draft, backend) {
@@ -401,8 +429,8 @@ async function finishNodeCreatePreparation(ctx, draft, backend) {
     backend
   };
   await checkDisjointnessConstraint(constraintContext, kind, id);
-  await chunk2SO5I5AI_cjs.checkUniquenessConstraints(
-    chunk2SO5I5AI_cjs.createUniquenessContext(ctx.graphId, ctx.registry, backend),
+  await chunk7V2FGGI2_cjs.checkUniquenessConstraints(
+    chunk7V2FGGI2_cjs.createUniquenessContext(ctx.graphId, ctx.registry, backend),
     kind,
     id,
     validatedProps,
@@ -432,8 +460,8 @@ async function validateAndPrepareNodeCreate(ctx, input, id, backend, options) {
   );
 }
 async function finalizeNodeCreateBatch(ctx, preparedCreates, backend, lock) {
-  await chunk2SO5I5AI_cjs.applyNodeInsertSideEffectsBatch(
-    chunk2SO5I5AI_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+  await chunk7V2FGGI2_cjs.applyNodeInsertSideEffectsBatch(
+    chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
     preparedCreates.map((prepared) => ({
       kind: prepared.kind,
       id: prepared.id,
@@ -445,8 +473,8 @@ async function finalizeNodeCreateBatch(ctx, preparedCreates, backend, lock) {
   );
 }
 async function finalizeNodeCreate(ctx, prepared, backend, lock) {
-  await chunk2SO5I5AI_cjs.applyNodeInsertSideEffects(
-    chunk2SO5I5AI_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+  await chunk7V2FGGI2_cjs.applyNodeInsertSideEffects(
+    chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
     {
       kind: prepared.kind,
       id: prepared.id,
@@ -459,7 +487,7 @@ async function finalizeNodeCreate(ctx, prepared, backend, lock) {
 }
 function computeNodeUpdate(ctx, kind, id, existingProps, inputProps) {
   const registration = getNodeRegistration(ctx.graph, kind);
-  const validatedProps = chunkARN3ZODS_cjs.validateNodeProps(
+  const validatedProps = chunkKKYELPZ2_cjs.validateNodeProps(
     registration.type.schema,
     { ...existingProps, ...inputProps },
     { kind, operation: "update", id }
@@ -467,7 +495,7 @@ function computeNodeUpdate(ctx, kind, id, existingProps, inputProps) {
   return { registration, validatedProps };
 }
 function resolveNodeUpdateProps(ctx, existing, inputProps) {
-  const existingProps = chunkECU53PMN_cjs.rowPropsToObject(existing.props);
+  const existingProps = chunk3PRKZW6D_cjs.rowPropsToObject(existing.props);
   const { registration, validatedProps } = computeNodeUpdate(
     ctx,
     existing.kind,
@@ -493,15 +521,15 @@ function nodeUpsertDirtyCheck(ctx, kind, id, existingProps, inputProps) {
 async function performNodeUpdate(ctx, input, backend, lock, options) {
   const { kind, id } = input;
   const existing = await backend.getNode(ctx.graphId, kind, id);
-  if (!existing) throw new chunkKTBTSHU6_cjs.NodeNotFoundError(kind, id);
+  if (!existing) throw new chunkC4F7VJ5D_cjs.NodeNotFoundError(kind, id);
   const { registration, validatedProps } = resolveNodeUpdateProps(
     ctx,
     existing,
     input.props
   );
   const nodeKind = registration.type;
-  const validTo = chunkZBV4LQD2_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo");
-  const writeContext = chunk2SO5I5AI_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock);
+  const validTo = chunkZTAJL4DT_cjs.validateOptionalCanonicalIsoDate(input.validTo, "validTo");
+  const writeContext = chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock);
   const shared = {
     schema: nodeKind.schema,
     validatedProps,
@@ -509,15 +537,15 @@ async function performNodeUpdate(ctx, input, backend, lock, options) {
     ...validTo !== void 0 && { validTo }
   };
   if (options?.clearDeleted) {
-    const row2 = await chunk2SO5I5AI_cjs.applyNodeUpdate(
+    const row2 = await chunk7V2FGGI2_cjs.applyNodeUpdate(
       writeContext,
       { ...shared, existing, clearDeleted: true },
       backend
     );
     return rowToNode(row2);
   }
-  if (!chunkECU53PMN_cjs.isLiveNodeRow(existing)) throw new chunkKTBTSHU6_cjs.NodeNotFoundError(kind, id);
-  const row = await chunk2SO5I5AI_cjs.applyNodeUpdate(
+  if (!chunk3PRKZW6D_cjs.isLiveNodeRow(existing)) throw new chunkC4F7VJ5D_cjs.NodeNotFoundError(kind, id);
+  const row = await chunk7V2FGGI2_cjs.applyNodeUpdate(
     writeContext,
     { ...shared, existing },
     backend
@@ -545,13 +573,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 (!chunk2SO5I5AI_cjs.checkWherePredicate(constraint, draft.validatedProps)) continue;
-        const key = chunk2SO5I5AI_cjs.computeUniqueKey(
+        if (!chunk7V2FGGI2_cjs.checkWherePredicate(constraint, draft.validatedProps)) continue;
+        const key = chunk7V2FGGI2_cjs.computeUniqueKey(
           draft.validatedProps,
           constraint.fields,
           constraint.collation
         );
-        const kindsToCheck = chunk2SO5I5AI_cjs.getKindsForUniquenessCheck(
+        const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
           draft.kind,
           constraint.scope,
           ctx.registry
@@ -597,7 +625,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 ?? chunk2SO5I5AI_cjs.generateId(), options)
+    (input) => draftNodeCreate(ctx, input, input.id ?? chunk7V2FGGI2_cjs.generateId(), options)
   );
   await primeBatchValidationCaches(ctx, drafts, backend, {
     seedNodeRow,
@@ -673,7 +701,7 @@ async function batchCheckUniqueAcrossKinds(backend, graphId, constraintName, uni
 }
 async function executeNodeCreateInternal(ctx, input, backend, options) {
   const kind = input.kind;
-  const id = input.id ?? chunk2SO5I5AI_cjs.generateId();
+  const id = input.id ?? chunk7V2FGGI2_cjs.generateId();
   const opContext = ctx.createOperationContext("create", "node", kind, id);
   const shouldReturnRow = options?.returnRow ?? true;
   return runHookedWriteOperation(
@@ -692,8 +720,8 @@ async function executeNodeCreateInternal(ctx, input, backend, options) {
       if (shouldReturnRow) {
         row = await target.insertNode(prepared.insertParams);
       } else {
-        await chunk2SO5I5AI_cjs.runInsertNoReturn(
-          chunk2SO5I5AI_cjs.nodeInsertDispatch(target),
+        await chunk7V2FGGI2_cjs.runInsertNoReturn(
+          chunk7V2FGGI2_cjs.nodeInsertDispatch(target),
           prepared.insertParams
         );
       }
@@ -709,7 +737,7 @@ async function executeNodeCreate(ctx, input, backend, options) {
     ...options
   });
   if (!result) {
-    throw new chunkKTBTSHU6_cjs.DatabaseOperationError(
+    throw new chunkC4F7VJ5D_cjs.DatabaseOperationError(
       "Node create failed: expected created node row",
       { operation: "insert", entity: "node" }
     );
@@ -724,7 +752,7 @@ async function executeNodeCreateNoReturnBatch(ctx, inputs, backend) {
       inputs,
       target
     );
-    await chunk2SO5I5AI_cjs.runInsertBatch(chunk2SO5I5AI_cjs.nodeInsertDispatch(target), batchInsertParams);
+    await chunk7V2FGGI2_cjs.runInsertBatch(chunk7V2FGGI2_cjs.nodeInsertDispatch(target), batchInsertParams);
     await finalizeNodeCreateBatch(ctx, preparedCreates, target, lock);
   });
 }
@@ -737,8 +765,8 @@ async function executeNodeCreateBatch(ctx, inputs, backend, options) {
       target,
       options
     );
-    const rows = await chunk2SO5I5AI_cjs.runInsertBatchReturning(
-      chunk2SO5I5AI_cjs.nodeInsertDispatch(target),
+    const rows = await chunk7V2FGGI2_cjs.runInsertBatchReturning(
+      chunk7V2FGGI2_cjs.nodeInsertDispatch(target),
       batchInsertParams
     );
     await finalizeNodeCreateBatch(ctx, preparedCreates, target, lock);
@@ -777,9 +805,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 || !chunkECU53PMN_cjs.isLiveNodeRow(preflight)) return;
-      await chunk2SO5I5AI_cjs.applyNodeSoftDelete(
-        chunk2SO5I5AI_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+      if (!preflight || !chunk3PRKZW6D_cjs.isLiveNodeRow(preflight)) return;
+      await chunk7V2FGGI2_cjs.applyNodeSoftDelete(
+        chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
         {
           existing: preflight,
           schema: registration.type.schema,
@@ -801,8 +829,8 @@ async function executeNodeHardDelete(ctx, kind, id, backend) {
     backend,
     async (target, lock) => {
       const registration = getNodeRegistration(ctx.graph, kind);
-      await chunk2SO5I5AI_cjs.applyNodeHardDelete(
-        chunk2SO5I5AI_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
+      await chunk7V2FGGI2_cjs.applyNodeHardDelete(
+        chunk7V2FGGI2_cjs.createNodeWriteContext(ctx.graphId, ctx.registry, lock),
         {
           kind,
           id,
@@ -818,12 +846,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 = chunkARN3ZODS_cjs.validateNodeProps(nodeKind.schema, props, {
+  const validatedProps = chunkKKYELPZ2_cjs.validateNodeProps(nodeKind.schema, props, {
     kind,
     operation: "create"
   });
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
-  if (!chunk2SO5I5AI_cjs.checkWherePredicate(constraint, validatedProps)) {
+  if (!chunk7V2FGGI2_cjs.checkWherePredicate(constraint, validatedProps)) {
     const node = await executeNodeCreate(
       ctx,
       { kind, props: validatedProps },
@@ -832,12 +860,12 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
     );
     return { node, action: "created" };
   }
-  const key = chunk2SO5I5AI_cjs.computeUniqueKey(
+  const key = chunk7V2FGGI2_cjs.computeUniqueKey(
     validatedProps,
     constraint.fields,
     constraint.collation
   );
-  const kindsToCheck = chunk2SO5I5AI_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -894,25 +922,25 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
   try {
     return await attempt();
   } catch (error) {
-    if (!(error instanceof chunkKTBTSHU6_cjs.UniquenessError)) throw error;
+    if (!(error instanceof chunkC4F7VJ5D_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 = chunkARN3ZODS_cjs.validateNodeProps(nodeKind.schema, props, {
+  const validatedProps = chunkKKYELPZ2_cjs.validateNodeProps(nodeKind.schema, props, {
     kind,
     operation: "create"
   });
   const constraint = resolveConstraint(ctx.graph, kind, constraintName);
-  if (!chunk2SO5I5AI_cjs.checkWherePredicate(constraint, validatedProps)) return void 0;
-  const key = chunk2SO5I5AI_cjs.computeUniqueKey(
+  if (!chunk7V2FGGI2_cjs.checkWherePredicate(constraint, validatedProps)) return void 0;
+  const key = chunk7V2FGGI2_cjs.computeUniqueKey(
     validatedProps,
     constraint.fields,
     constraint.collation
   );
-  const kindsToCheck = chunk2SO5I5AI_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -938,12 +966,12 @@ async function executeNodeFindByConstraint(ctx, kind, constraintName, props, bac
 function validateAndComputeKeys(nodeKind, kind, constraint, items) {
   const validated = [];
   for (const item of items) {
-    const validatedProps = chunkARN3ZODS_cjs.validateNodeProps(nodeKind.schema, item.props, {
+    const validatedProps = chunkKKYELPZ2_cjs.validateNodeProps(nodeKind.schema, item.props, {
       kind,
       operation: "create"
     });
-    const applies = chunk2SO5I5AI_cjs.checkWherePredicate(constraint, validatedProps);
-    const key = applies ? chunk2SO5I5AI_cjs.computeUniqueKey(
+    const applies = chunk7V2FGGI2_cjs.checkWherePredicate(constraint, validatedProps);
+    const key = applies ? chunk7V2FGGI2_cjs.computeUniqueKey(
       validatedProps,
       constraint.fields,
       constraint.collation
@@ -966,7 +994,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 = chunk2SO5I5AI_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -1016,10 +1044,10 @@ function resolveNodeIndex(graph, kind, indexName) {
     (candidate) => candidate.entity === "node" && candidate.kind === kind && candidate.name === indexName
   );
   if (declaration?.entity !== "node") {
-    throw new chunkKTBTSHU6_cjs.NodeIndexNotFoundError(indexName, kind);
+    throw new chunkC4F7VJ5D_cjs.NodeIndexNotFoundError(indexName, kind);
   }
   if (declaration.method !== void 0) {
-    throw new chunkKTBTSHU6_cjs.ConfigurationError(
+    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
       `bulkFindByIndex cannot probe index "${indexName}" (method "${declaration.method}"): only btree indexes serve equality probes.`,
       { indexName, kind, method: declaration.method }
     );
@@ -1057,7 +1085,7 @@ function validateIndexProbeValue(value, valueType, pointer, kind) {
   }
 }
 function indexProbeTypeError(pointer, kind, expected, value) {
-  return new chunkKTBTSHU6_cjs.ValidationError(
+  return new chunkC4F7VJ5D_cjs.ValidationError(
     `Index probe value for "${pointer}" on node kind "${kind}" has an incompatible type`,
     {
       entityType: "node",
@@ -1091,7 +1119,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 chunkKTBTSHU6_cjs.ConfigurationError(
+    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
       `bulkFindByIndex requires an index with at least one prop-based field on index "${indexName}" (node kind "${kind}")`,
       { indexName, kind },
       {
@@ -1100,7 +1128,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
     );
   }
   if (index.fieldValueTypes.includes("date")) {
-    throw new chunkKTBTSHU6_cjs.ConfigurationError(
+    throw new chunkC4F7VJ5D_cjs.ConfigurationError(
       `bulkFindByIndex does not support date-typed key fields on index "${indexName}" (node kind "${kind}")`,
       { indexName, kind },
       {
@@ -1110,7 +1138,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
   }
   const limitPerInput = options?.limitPerInput;
   if (limitPerInput !== void 0 && (!Number.isInteger(limitPerInput) || limitPerInput <= 0)) {
-    throw new chunkKTBTSHU6_cjs.ValidationError(
+    throw new chunkC4F7VJ5D_cjs.ValidationError(
       "bulkFindByIndex limitPerInput must be a positive integer",
       {
         entityType: "node",
@@ -1125,7 +1153,7 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
       }
     );
   }
-  const adapter = chunkUTTW2Q3M_cjs.getDialect(backend.dialect);
+  const adapter = chunkOVUUTCPJ_cjs.getDialect(backend.dialect);
   const probes = items.map(
     (item) => index.fields.map((pointer, position) => {
       const value = chunkTDXIBCGY_cjs.resolveJsonPointer(item.props, pointer);
@@ -1152,47 +1180,47 @@ async function executeNodeBulkFindByIndex(ctx, kind, indexName, items, backend,
     }
     groupToInputs[existing]?.push(inputIndex);
   }
-  const schema = backend.tableNames ? chunkCVK4T34X_cjs.createSqlSchema(backend.tableNames) : chunkCVK4T34X_cjs.DEFAULT_SQL_SCHEMA;
+  const schema = backend.tableNames ? chunkCPEL3YIR_cjs.createSqlSchema(backend.tableNames) : chunkCPEL3YIR_cjs.DEFAULT_SQL_SCHEMA;
   const compileContext = {
     dialect: backend.dialect,
-    propsColumn: chunkX2XOQZT3_cjs.sql.raw(`"props"`),
-    systemColumn: (column) => chunkX2XOQZT3_cjs.sql.raw(`"${column}"`)
+    propsColumn: chunkU5W4LKZV_cjs.sql.raw(`"props"`),
+    systemColumn: (column) => chunkU5W4LKZV_cjs.sql.raw(`"${column}"`)
   };
-  const fieldKeys = chunkUTTW2Q3M_cjs.compileNodeIndexFieldKeys(index, compileContext);
+  const fieldKeys = chunkOVUUTCPJ_cjs.compileNodeIndexFieldKeys(index, compileContext);
   const groupPredicates = groupProbes.map(
-    (probe) => chunkX2XOQZT3_cjs.sql`(${chunkX2XOQZT3_cjs.sql.join(
+    (probe) => chunkU5W4LKZV_cjs.sql`(${chunkU5W4LKZV_cjs.sql.join(
       fieldKeys.map((fieldKey, position) => {
         const value = probe[position];
         if (value === void 0 || value === null) {
-          return chunkX2XOQZT3_cjs.sql`${fieldKey} IS NULL`;
+          return chunkU5W4LKZV_cjs.sql`${fieldKey} IS NULL`;
         }
         return adapter.nullSafeEquals(
           fieldKey,
-          chunkX2XOQZT3_cjs.sql`${coerceIndexProbeBind(value, adapter)}`
+          chunkU5W4LKZV_cjs.sql`${coerceIndexProbeBind(value, adapter)}`
         );
       }),
-      chunkX2XOQZT3_cjs.sql` AND `
+      chunkU5W4LKZV_cjs.sql` AND `
     )})`
   );
   const caseBranches = groupPredicates.map(
-    (predicate, group) => chunkX2XOQZT3_cjs.sql`WHEN ${predicate} THEN ${chunkX2XOQZT3_cjs.sql.raw(String(group))}`
+    (predicate, group) => chunkU5W4LKZV_cjs.sql`WHEN ${predicate} THEN ${chunkU5W4LKZV_cjs.sql.raw(String(group))}`
   );
-  const probeIndexExpr = chunkX2XOQZT3_cjs.sql`CASE ${chunkX2XOQZT3_cjs.sql.join(caseBranches, chunkX2XOQZT3_cjs.sql` `)} ELSE NULL END`;
+  const probeIndexExpr = chunkU5W4LKZV_cjs.sql`CASE ${chunkU5W4LKZV_cjs.sql.join(caseBranches, chunkU5W4LKZV_cjs.sql` `)} ELSE NULL END`;
   const conditions = [
-    chunkX2XOQZT3_cjs.sql`"graph_id" = ${ctx.graphId}`,
-    chunkX2XOQZT3_cjs.sql`"kind" = ${kind}`,
-    chunkX2XOQZT3_cjs.sql`"deleted_at" IS NULL`
+    chunkU5W4LKZV_cjs.sql`"graph_id" = ${ctx.graphId}`,
+    chunkU5W4LKZV_cjs.sql`"kind" = ${kind}`,
+    chunkU5W4LKZV_cjs.sql`"deleted_at" IS NULL`
   ];
   if (index.where !== void 0) {
-    conditions.push(chunkUTTW2Q3M_cjs.compileIndexWhere(compileContext, index.where));
+    conditions.push(chunkOVUUTCPJ_cjs.compileIndexWhere(compileContext, index.where));
   }
-  conditions.push(chunkX2XOQZT3_cjs.sql`(${chunkX2XOQZT3_cjs.sql.join(groupPredicates, chunkX2XOQZT3_cjs.sql` OR `)})`);
-  const whereClause = chunkX2XOQZT3_cjs.sql.join(conditions, chunkX2XOQZT3_cjs.sql` AND `);
-  const probedSelect = chunkX2XOQZT3_cjs.sql`SELECT "id", ${probeIndexExpr} AS probe_idx FROM ${schema.nodesTable} WHERE ${whereClause}`;
+  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 `);
+  const probedSelect = chunkU5W4LKZV_cjs.sql`SELECT "id", ${probeIndexExpr} AS probe_idx FROM ${schema.nodesTable} WHERE ${whereClause}`;
   const capInSql = limitPerInput !== void 0 && backend.capabilities.windowFunctions;
-  const query = capInSql ? chunkX2XOQZT3_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"` : chunkX2XOQZT3_cjs.sql`${probedSelect} ORDER BY probe_idx, "id"`;
+  const query = capInSql ? chunkU5W4LKZV_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"` : chunkU5W4LKZV_cjs.sql`${probedSelect} ORDER BY probe_idx, "id"`;
   const rawMatches = await backend.execute(
-    chunkX2XOQZT3_cjs.asCompiledRowsSql(query)
+    chunkU5W4LKZV_cjs.asCompiledRowsSql(query)
   );
   const matches = limitPerInput !== void 0 && !capInSql ? capMatchesPerGroup(rawMatches, limitPerInput) : rawMatches;
   const nodesById = await hydrateNodesById(
@@ -1225,7 +1253,7 @@ function capMatchesPerGroup(matches, limitPerInput) {
   return capped;
 }
 async function hydrateNodesById(backend, graphId, kind, ids) {
-  const rowsById = await chunk2SO5I5AI_cjs.getNodeRowsByIds(backend, graphId, kind, ids);
+  const rowsById = await chunk7V2FGGI2_cjs.getNodeRowsByIds(backend, graphId, kind, ids);
   const nodesById = /* @__PURE__ */ new Map();
   for (const [id, row] of rowsById) {
     if (row.deleted_at !== void 0) continue;
@@ -1241,7 +1269,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 = chunk2SO5I5AI_cjs.getKindsForUniquenessCheck(
+  const kindsToCheck = chunk7V2FGGI2_cjs.getKindsForUniquenessCheck(
     kind,
     constraint.scope,
     ctx.registry
@@ -1355,6 +1383,7 @@ exports.executeNodeGetOrCreateByConstraint = executeNodeGetOrCreateByConstraint;
 exports.executeNodeHardDelete = executeNodeHardDelete;
 exports.executeNodeUpdate = executeNodeUpdate;
 exports.executeNodeUpsertUpdate = executeNodeUpsertUpdate;
+exports.lockSchemaVersionForStoreWrite = lockSchemaVersionForStoreWrite;
 exports.nodeUpsertDirtyCheck = nodeUpsertDirtyCheck;
 exports.primeBatchValidationCaches = primeBatchValidationCaches;
 exports.rowToEdge = rowToEdge;
@@ -1363,5 +1392,5 @@ exports.rowToNode = rowToNode;
 exports.rowToNodeMeta = rowToNodeMeta;
 exports.runHookedWriteOperation = runHookedWriteOperation;
 exports.runInWriteTransaction = runInWriteTransaction;
-//# sourceMappingURL=chunk-K2HHCWZO.cjs.map
-//# sourceMappingURL=chunk-K2HHCWZO.cjs.map
+//# sourceMappingURL=chunk-NCX65HBY.cjs.map
+//# sourceMappingURL=chunk-NCX65HBY.cjs.map