@nicia-ai/typegraph 0.3.0 → 0.4.0

package/dist/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunkDD6ONEBN_cjs = require('./chunk-DD6ONEBN.cjs');
-var chunkZJHQZZT2_cjs = require('./chunk-ZJHQZZT2.cjs');
-var chunkOYL2SGBD_cjs = require('./chunk-OYL2SGBD.cjs');
+var chunkLDM2AFKZ_cjs = require('./chunk-LDM2AFKZ.cjs');
+var chunkK2ROKOK3_cjs = require('./chunk-K2ROKOK3.cjs');
+var chunk44SXEVF4_cjs = require('./chunk-44SXEVF4.cjs');
 var chunk2WVFEIHR_cjs = require('./chunk-2WVFEIHR.cjs');
 var chunkP5CNM325_cjs = require('./chunk-P5CNM325.cjs');
 var zod = require('zod');
@@ -17,7 +17,7 @@ function validateSchemaKeys(schema, name) {
     (key) => RESERVED_NODE_KEYS.has(key)
   );
   if (conflicts.length > 0) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(
+    throw new chunk44SXEVF4_cjs.ConfigurationError(
       `Node "${name}" schema contains reserved property names: ${conflicts.join(", ")}`,
       { nodeType: name, conflicts, reservedKeys: [...RESERVED_NODE_KEYS] },
       {
@@ -29,7 +29,7 @@ function validateSchemaKeys(schema, name) {
 function defineNode(name, options) {
   validateSchemaKeys(options.schema, name);
   return Object.freeze({
-    [chunkZJHQZZT2_cjs.NODE_TYPE_BRAND]: true,
+    [chunkK2ROKOK3_cjs.NODE_TYPE_BRAND]: true,
     kind: name,
     schema: options.schema,
     description: options.description
@@ -51,7 +51,7 @@ function validateSchemaKeys2(schema, name) {
     (key) => RESERVED_EDGE_KEYS.has(key)
   );
   if (conflicts.length > 0) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(
+    throw new chunk44SXEVF4_cjs.ConfigurationError(
       `Edge "${name}" schema contains reserved property names: ${conflicts.join(", ")}`,
       { edgeType: name, conflicts, reservedKeys: [...RESERVED_EDGE_KEYS] },
       {
@@ -64,7 +64,7 @@ function defineEdge(name, options) {
   const schema = options?.schema ?? EMPTY_SCHEMA;
   validateSchemaKeys2(schema, name);
   return Object.freeze({
-    [chunkZJHQZZT2_cjs.EDGE_TYPE_BRAND]: true,
+    [chunkK2ROKOK3_cjs.EDGE_TYPE_BRAND]: true,
     kind: name,
     schema,
     description: options?.description,
@@ -84,7 +84,7 @@ function metaEdge(name, options = {}) {
     description: options.description
   };
   return Object.freeze({
-    [chunkDD6ONEBN_cjs.META_EDGE_BRAND]: true,
+    [chunkLDM2AFKZ_cjs.META_EDGE_BRAND]: true,
     name,
     properties
   });
@@ -120,7 +120,7 @@ function createExternalRef(table) {
 // src/ontology/core-meta-edges.ts
 function createMetaEdge(name, properties) {
   return Object.freeze({
-    [chunkDD6ONEBN_cjs.META_EDGE_BRAND]: true,
+    [chunkLDM2AFKZ_cjs.META_EDGE_BRAND]: true,
     name,
     properties: {
       transitive: properties.transitive ?? false,
@@ -132,7 +132,7 @@ function createMetaEdge(name, properties) {
     }
   });
 }
-var subClassOfMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_SUB_CLASS_OF, {
+var subClassOfMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_SUB_CLASS_OF, {
   transitive: true,
   inference: "subsumption",
   description: "Type inheritance (Podcast subClassOf Media)"
@@ -144,9 +144,9 @@ function subClassOf(child, parent) {
     to: parent
   };
 }
-var broaderMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_BROADER, {
+var broaderMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_BROADER, {
   transitive: true,
-  inverse: chunkDD6ONEBN_cjs.META_EDGE_NARROWER,
+  inverse: chunkLDM2AFKZ_cjs.META_EDGE_NARROWER,
   inference: "hierarchy",
   description: "Broader concept (ML broader AI)"
 });
@@ -157,9 +157,9 @@ function broader(narrowerConcept, broaderConcept) {
     to: broaderConcept
   };
 }
-var narrowerMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_NARROWER, {
+var narrowerMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_NARROWER, {
   transitive: true,
-  inverse: chunkDD6ONEBN_cjs.META_EDGE_BROADER,
+  inverse: chunkLDM2AFKZ_cjs.META_EDGE_BROADER,
   inference: "hierarchy",
   description: "Narrower concept (AI narrower ML)"
 });
@@ -170,7 +170,7 @@ function narrower(broaderConcept, narrowerConcept) {
     to: narrowerConcept
   };
 }
-var relatedToMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_RELATED_TO, {
+var relatedToMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_RELATED_TO, {
   symmetric: true,
   inference: "association",
   description: "Non-hierarchical association"
@@ -182,7 +182,7 @@ function relatedTo(conceptA, conceptB) {
     to: conceptB
   };
 }
-var equivalentToMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_EQUIVALENT_TO, {
+var equivalentToMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_EQUIVALENT_TO, {
   symmetric: true,
   transitive: true,
   inference: "substitution",
@@ -195,7 +195,7 @@ function equivalentTo(kindA, kindBOrIri) {
     to: kindBOrIri
   };
 }
-var sameAsMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_SAME_AS, {
+var sameAsMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_SAME_AS, {
   symmetric: true,
   transitive: true,
   inference: "substitution",
@@ -208,7 +208,7 @@ function sameAs(kindA, kindBOrIri) {
     to: kindBOrIri
   };
 }
-var differentFromMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_DIFFERENT_FROM, {
+var differentFromMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_DIFFERENT_FROM, {
   symmetric: true,
   inference: "constraint",
   description: "Explicitly different individuals"
@@ -220,7 +220,7 @@ function differentFrom(kindA, kindB) {
     to: kindB
   };
 }
-var disjointWithMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_DISJOINT_WITH, {
+var disjointWithMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_DISJOINT_WITH, {
   symmetric: true,
   inference: "constraint",
   description: "Mutually exclusive types"
@@ -232,9 +232,9 @@ function disjointWith(kindA, kindB) {
     to: kindB
   };
 }
-var partOfMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_PART_OF, {
+var partOfMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_PART_OF, {
   transitive: true,
-  inverse: chunkDD6ONEBN_cjs.META_EDGE_HAS_PART,
+  inverse: chunkLDM2AFKZ_cjs.META_EDGE_HAS_PART,
   inference: "composition",
   description: "X is part of Y"
 });
@@ -245,9 +245,9 @@ function partOf(part, whole) {
     to: whole
   };
 }
-var hasPartMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_HAS_PART, {
+var hasPartMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_HAS_PART, {
   transitive: true,
-  inverse: chunkDD6ONEBN_cjs.META_EDGE_PART_OF,
+  inverse: chunkLDM2AFKZ_cjs.META_EDGE_PART_OF,
   inference: "composition",
   description: "Y has part X"
 });
@@ -258,12 +258,12 @@ function hasPart(whole, part) {
     to: part
   };
 }
-var inverseOfMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_INVERSE_OF, {
+var inverseOfMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_INVERSE_OF, {
   symmetric: true,
   inference: "none",
   description: "Edge A is inverse of edge B"
 });
-var impliesMetaEdge = createMetaEdge(chunkDD6ONEBN_cjs.META_EDGE_IMPLIES, {
+var impliesMetaEdge = createMetaEdge(chunkLDM2AFKZ_cjs.META_EDGE_IMPLIES, {
   transitive: true,
   inference: "none",
   description: "Edge A implies edge B exists"
@@ -317,10 +317,10 @@ function runRecursiveTraversalSelectionPass(ast) {
     (traversal) => traversal.variableLength !== void 0
   );
   if (variableLengthTraversal === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError("No variable-length traversal found");
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError("No variable-length traversal found");
   }
   if (ast.traversals.length > 1) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       "Variable-length traversals with multiple traversals are not yet supported. Please use a single variable-length traversal."
     );
   }
@@ -838,7 +838,7 @@ function notInSubquery(field2, subquery) {
 function assertSingleColumnSubquery(subquery) {
   const columnCount = getSubqueryColumnCount(subquery);
   if (columnCount === 1) return;
-  throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+  throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
     `IN/NOT IN subquery must project exactly 1 column, but got ${columnCount}`,
     { subqueryColumnCount: columnCount },
     {
@@ -851,7 +851,7 @@ function assertCompatibleSubqueryValueTypes(field2, subquery) {
   const subqueryValueType = getSingleSubqueryColumnValueType(subquery);
   const resolvedValueType = fieldValueType ?? subqueryValueType;
   if (isUnsupportedInSubqueryValueType(resolvedValueType)) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `IN/NOT IN subquery does not support ${String(resolvedValueType)} values`,
       { valueType: resolvedValueType },
       {
@@ -862,7 +862,7 @@ function assertCompatibleSubqueryValueTypes(field2, subquery) {
   if (isInSubqueryTypeCompatible(fieldValueType, subqueryValueType)) {
     return;
   }
-  throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+  throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
     `IN/NOT IN type mismatch: field type "${String(fieldValueType)}" does not match subquery column type "${String(subqueryValueType)}"`,
     {
       fieldValueType,
@@ -988,7 +988,7 @@ function resolveLiteralValueTypes(literals) {
     }
   }
   if (resolved.size > 1) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       "Mixed literal value types are not supported in predicates",
       { valueTypes: [...resolved] }
     );
@@ -1114,7 +1114,7 @@ function compilePredicateExpression(expr, ctx) {
       if (!upperIsParam) boundsForType.push(expr.upper);
       const valueType = boundsForType.length > 0 ? resolveComparisonValueType(expr.field, boundsForType) : normalizeValueType2(expr.field.valueType);
       if (valueType === "array" || valueType === "object") {
-        throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+        throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
           "Between comparisons are not supported for JSON arrays or objects"
         );
       }
@@ -1179,7 +1179,7 @@ function compileComparisonPredicate(expr, dialect, cteColumnPrefix) {
     );
     const opSql2 = COMPARISON_OP_SQL[expr.op];
     if (!opSql2) {
-      throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+      throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
         `Comparison operation "${expr.op}" is not supported for parameterized predicates`
       );
     }
@@ -1187,7 +1187,7 @@ function compileComparisonPredicate(expr, dialect, cteColumnPrefix) {
   }
   const valueType = resolveComparisonValueType(expr.left, expr.right);
   if (valueType === "array" || valueType === "object") {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `Comparison operation "${expr.op}" is not supported for ${valueType} values`
     );
   }
@@ -1215,7 +1215,7 @@ function compileComparisonPredicate(expr, dialect, cteColumnPrefix) {
   const convertedRight = convertValueForSql(rightValue.value, dialect);
   const opSql = COMPARISON_OP_SQL[expr.op];
   if (!opSql) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `Comparison operation "${expr.op}" is not supported`
     );
   }
@@ -1278,13 +1278,13 @@ function compileObjectPredicate(expr, dialect, cteColumnPrefix) {
     }
     case "pathEquals": {
       if (!expr.value) {
-        throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+        throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
           "pathEquals requires a comparison value"
         );
       }
       const valueType = resolvePredicateValueType(expr.valueType, expr.value);
       if (valueType === "array" || valueType === "object") {
-        throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+        throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
           "pathEquals is not supported for JSON arrays or objects"
         );
       }
@@ -1300,7 +1300,7 @@ function compileObjectPredicate(expr, dialect, cteColumnPrefix) {
     }
     case "pathContains": {
       if (!expr.value) {
-        throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+        throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
           "pathContains requires a comparison value"
         );
       }
@@ -1328,7 +1328,7 @@ function compileAggregatePredicate(expr, dialect) {
   const aggregate = compileAggregateExpr(expr.aggregate, dialect);
   const op = COMPARISON_OP_SQL[expr.op];
   if (!op) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `Comparison operation "${expr.op}" is not supported for aggregate predicates`
     );
   }
@@ -1363,7 +1363,7 @@ function compileAggregateExpr(expr, dialect) {
       return drizzleOrm.sql`MAX(${field2})`;
     }
     default: {
-      throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+      throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
         `Unknown aggregate function: ${expr.function}`
       );
     }
@@ -1371,7 +1371,7 @@ function compileAggregateExpr(expr, dialect) {
 }
 function compileExistsSubquery(expr, ctx) {
   if (expr.subquery.graphId === void 0) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError("EXISTS subquery must have a graphId");
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError("EXISTS subquery must have a graphId");
   }
   const subSql = ctx.compileQuery(expr.subquery, expr.subquery.graphId);
   return expr.negated ? drizzleOrm.sql`NOT EXISTS (${subSql})` : drizzleOrm.sql`EXISTS (${subSql})`;
@@ -1379,7 +1379,7 @@ function compileExistsSubquery(expr, ctx) {
 function compileInSubquery(expr, ctx) {
   const subqueryColumnCount = getSubqueryColumnCount(expr.subquery);
   if (subqueryColumnCount !== 1) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `IN/NOT IN subquery must project exactly 1 column, but got ${subqueryColumnCount}`,
       { subqueryColumnCount }
     );
@@ -1388,13 +1388,13 @@ function compileInSubquery(expr, ctx) {
   const subqueryValueType = getSingleSubqueryColumnValueType(expr.subquery);
   const resolvedValueType = fieldValueType ?? subqueryValueType;
   if (isUnsupportedInSubqueryValueType(resolvedValueType)) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `IN/NOT IN subquery does not support ${String(resolvedValueType)} values`,
       { valueType: resolvedValueType }
     );
   }
   if (!isInSubqueryTypeCompatible(fieldValueType, subqueryValueType)) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `IN/NOT IN type mismatch: field type "${String(fieldValueType)}" does not match subquery column type "${String(subqueryValueType)}"`,
       {
         fieldValueType,
@@ -1404,7 +1404,7 @@ function compileInSubquery(expr, ctx) {
   }
   const valueType = fieldValueType ?? subqueryValueType;
   if (expr.subquery.graphId === void 0) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       "IN/NOT IN subquery must have a graphId"
     );
   }
@@ -1428,7 +1428,7 @@ function extractVectorSimilarityPredicates(predicates) {
     switch (expr.__type) {
       case "vector_similarity": {
         if (inDisallowedBranch) {
-          throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+          throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
             "Vector similarity predicates cannot be nested under OR or NOT. Use top-level AND combinations instead."
           );
         }
@@ -1463,7 +1463,7 @@ function extractVectorSimilarityPredicates(predicates) {
 function runVectorPredicatePass(ast, dialect) {
   const vectorPredicates = extractVectorSimilarityPredicates(ast.predicates);
   if (vectorPredicates.length > 1) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       "Multiple vector similarity predicates in a single query are not supported"
     );
   }
@@ -1473,29 +1473,29 @@ function runVectorPredicatePass(ast, dialect) {
   }
   const vectorStrategy = dialect.capabilities.vectorPredicateStrategy;
   if (vectorStrategy === "unsupported" || !dialect.supportsVectors) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `Vector similarity predicates are not supported for dialect "${dialect.name}"`
     );
   }
   if (!dialect.capabilities.vectorMetrics.includes(vectorPredicate.metric)) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `Vector metric "${vectorPredicate.metric}" is not supported for dialect "${dialect.name}"`
     );
   }
   if (!Number.isFinite(vectorPredicate.limit) || vectorPredicate.limit <= 0) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `Vector predicate limit must be a positive finite number, got ${String(vectorPredicate.limit)}`
     );
   }
   const { minScore } = vectorPredicate;
   if (minScore !== void 0) {
     if (!Number.isFinite(minScore)) {
-      throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+      throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
         `Vector minScore must be a finite number, got ${String(minScore)}`
       );
     }
     if (vectorPredicate.metric === "cosine" && (minScore < -1 || minScore > 1)) {
-      throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+      throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
         `Cosine minScore must be between -1 and 1, got ${String(minScore)}`
       );
     }
@@ -1589,7 +1589,7 @@ function appendAggregateSortLimitAndProjectNodes(currentNode, ast, nextPlanNodeI
     } else if (hasOffset) {
       node = { ...limitOffsetNodeBase, offset: ast.offset };
     } else {
-      throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+      throw new chunk44SXEVF4_cjs.CompilerInvariantError(
         "limit_offset node requires limit or offset to be present"
       );
     }
@@ -1886,7 +1886,7 @@ function findUnaryNodeInProjectChain(rootNode, op) {
 }
 function inspectProjectPlan(logicalPlan) {
   if (logicalPlan.root.op !== "project") {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       `SQL emitter expected logical plan root to be "project", got "${logicalPlan.root.op}"`,
       { component: "plan-inspector" }
     );
@@ -1916,13 +1916,13 @@ function inspectProjectPlan(logicalPlan) {
 function inspectStandardProjectPlan(logicalPlan) {
   const shape = inspectProjectPlan(logicalPlan);
   if (shape.hasSetOperation) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       'Standard SQL emitter does not support plans containing "set_op" nodes',
       { component: "plan-inspector" }
     );
   }
   if (shape.hasRecursiveExpand) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       'Standard SQL emitter does not support plans containing "recursive_expand" nodes',
       { component: "plan-inspector" }
     );
@@ -1932,13 +1932,13 @@ function inspectStandardProjectPlan(logicalPlan) {
 function inspectRecursiveProjectPlan(logicalPlan) {
   const shape = inspectProjectPlan(logicalPlan);
   if (!shape.hasRecursiveExpand) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       'Recursive SQL emitter expected logical plan to contain a "recursive_expand" node',
       { component: "plan-inspector" }
     );
   }
   if (shape.hasSetOperation) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       'Recursive SQL emitter does not support plans containing "set_op" nodes',
       { component: "plan-inspector" }
     );
@@ -1997,7 +1997,7 @@ function inspectSetOperationPlan(logicalPlan) {
   const operations = /* @__PURE__ */ new Set();
   collectPlanOperations(logicalPlan.root, operations);
   if (!operations.has("set_op")) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       'Set-operation SQL emitter expected logical plan to contain a "set_op" node',
       { component: "plan-inspector" }
     );
@@ -2015,25 +2015,25 @@ function inspectSetOperationPlan(logicalPlan) {
 function assertRecursiveEmitterClauseAlignment(logicalPlan, input) {
   const planShape = inspectRecursiveProjectPlan(logicalPlan);
   if (planShape.hasSort && input.orderBy === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Recursive SQL emitter expected ORDER BY clause for plan containing a sort node",
       { component: "recursive-emitter" }
     );
   }
   if (!planShape.hasSort && input.orderBy !== void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Recursive SQL emitter received ORDER BY clause for a plan without sort nodes",
       { component: "recursive-emitter" }
     );
   }
   if (planShape.hasLimitOffset && input.limitOffset === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Recursive SQL emitter expected LIMIT/OFFSET clause for plan containing a limit_offset node",
       { component: "recursive-emitter" }
     );
   }
   if (!planShape.hasLimitOffset && input.limitOffset !== void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Recursive SQL emitter received LIMIT/OFFSET clause for a plan without limit_offset nodes",
       { component: "recursive-emitter" }
     );
@@ -2060,14 +2060,14 @@ function assertSetOperationEmitterClauseAlignment(logicalPlan, suffixClauses) {
   const shape = inspectSetOperationPlan(logicalPlan);
   const hasSuffixClauses = suffixClauses !== void 0 && suffixClauses.length > 0;
   if (!shape.hasSort && !shape.hasLimitOffset && hasSuffixClauses) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Set-operation SQL emitter received suffix clauses for a plan without top-level sort or limit_offset nodes",
       { component: "set-operation-emitter" }
     );
   }
   if (!hasSuffixClauses) {
     if (shape.hasSort || shape.hasLimitOffset) {
-      throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+      throw new chunk44SXEVF4_cjs.CompilerInvariantError(
         "Set-operation SQL emitter expected suffix clauses for plan containing top-level sort or limit_offset nodes",
         { component: "set-operation-emitter" }
       );
@@ -2077,7 +2077,7 @@ function assertSetOperationEmitterClauseAlignment(logicalPlan, suffixClauses) {
   const limitOffsetClauseCount = shape.limitOffsetNode === void 0 ? 0 : (shape.limitOffsetNode.limit === void 0 ? 0 : 1) + (shape.limitOffsetNode.offset === void 0 ? 0 : 1);
   const expectedClauseCount = (shape.sortNode === void 0 ? 0 : 1) + limitOffsetClauseCount;
   if (suffixClauses.length !== expectedClauseCount) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       `Set-operation SQL emitter expected ${String(expectedClauseCount)} top-level suffix clause(s) from logical plan, got ${String(suffixClauses.length)}`,
       { component: "set-operation-emitter" }
     );
@@ -2101,38 +2101,38 @@ function emitSetOperationQuerySql(input) {
 function assertStandardEmitterClauseAlignment(logicalPlan, input) {
   const planShape = inspectStandardProjectPlan(logicalPlan);
   if (input.groupBy !== void 0 && !planShape.hasAggregate) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Standard SQL emitter received GROUP BY clause for a plan without aggregate nodes",
       { component: "standard-emitter" }
     );
   }
   if (input.having !== void 0 && !planShape.hasAggregate) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Standard SQL emitter received HAVING clause for a plan without aggregate nodes",
       { component: "standard-emitter" }
     );
   }
   const expectsOrderBy = planShape.hasSort || planShape.hasVectorKnn;
   if (expectsOrderBy && input.orderBy === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Standard SQL emitter expected ORDER BY clause for plan containing a sort or vector_knn node",
       { component: "standard-emitter" }
     );
   }
   if (!expectsOrderBy && input.orderBy !== void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Standard SQL emitter received ORDER BY clause for a plan without sort or vector_knn nodes",
       { component: "standard-emitter" }
     );
   }
   if (planShape.hasLimitOffset && input.limitOffset === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Standard SQL emitter expected LIMIT/OFFSET clause for plan containing a limit_offset node",
       { component: "standard-emitter" }
     );
   }
   if (!planShape.hasLimitOffset && input.limitOffset !== void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Standard SQL emitter received LIMIT/OFFSET clause for a plan without limit_offset nodes",
       { component: "standard-emitter" }
     );
@@ -2213,7 +2213,7 @@ function getNodeKindsForAlias(ast, alias) {
       return traversal.nodeKinds;
     }
   }
-  throw new chunkOYL2SGBD_cjs.CompilerInvariantError(`Unknown traversal source alias: ${alias}`);
+  throw new chunk44SXEVF4_cjs.CompilerInvariantError(`Unknown traversal source alias: ${alias}`);
 }
 
 // src/query/compiler/typed-json-extract.ts
@@ -2544,7 +2544,7 @@ function compileAggregateExprFromSource(expr, dialect) {
       return drizzleOrm.sql`${drizzleOrm.sql.raw(fn.toUpperCase())}(${column})`;
     }
     default: {
-      throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+      throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
         `Unknown aggregate function: ${String(fn)}`
       );
     }
@@ -2642,7 +2642,7 @@ function buildStandardOrderBy(input) {
   for (const orderSpec of ast.orderBy) {
     const valueType = orderSpec.field.valueType;
     if (valueType === "array" || valueType === "object") {
-      throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+      throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
         "Ordering by JSON arrays or objects is not supported"
       );
     }
@@ -2772,7 +2772,7 @@ function buildStandardVectorOrderBy(input) {
     for (const orderSpec of ast.orderBy) {
       const valueType = orderSpec.field.valueType;
       if (valueType === "array" || valueType === "object") {
-        throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+        throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
           "Ordering by JSON arrays or objects is not supported"
         );
       }
@@ -2855,7 +2855,7 @@ function runRecursiveQueryPassPipeline(ast, graphId, ctx) {
     execute(currentState) {
       const traversal = currentState.traversal;
       if (traversal === void 0) {
-        throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+        throw new chunk44SXEVF4_cjs.CompilerInvariantError(
           "Recursive traversal pass did not select traversal"
         );
       }
@@ -2908,17 +2908,17 @@ function compileVariableLengthQueryWithRecursiveCteStrategy(ast, graphId, ctx) {
     traversal: vlTraversal
   } = passState;
   if (temporalFilterPass === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Temporal filter pass did not initialize temporal state"
     );
   }
   if (logicalPlan === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Logical plan pass did not initialize plan state"
     );
   }
   if (vlTraversal === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Recursive traversal pass did not select traversal"
     );
   }
@@ -3010,7 +3010,7 @@ function compileRecursiveCte(ast, traversal, graphId, ctx, requiredColumnsByAlia
     targetContext
   );
   if (vl.maxDepth > MAX_EXPLICIT_RECURSIVE_DEPTH) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `Recursive traversal maxHops(${vl.maxDepth}) exceeds maximum explicit depth of ${MAX_EXPLICIT_RECURSIVE_DEPTH}`
     );
   }
@@ -3237,7 +3237,7 @@ function compileRecursiveSelectiveProjection(fields, ast, traversal, dialect) {
   const allowedAliases = /* @__PURE__ */ new Set([ast.start.alias, traversal.nodeAlias]);
   const columns = fields.map((field2) => {
     if (!allowedAliases.has(field2.alias)) {
-      throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+      throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
         `Selective projection for recursive traversals does not support alias "${field2.alias}"`
       );
     }
@@ -3271,7 +3271,7 @@ function compileRecursiveOrderBy(ast, dialect) {
   for (const orderSpec of ast.orderBy) {
     const valueType = orderSpec.field.valueType;
     if (valueType === "array" || valueType === "object") {
-      throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+      throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
         "Ordering by JSON arrays or objects is not supported"
       );
     }
@@ -3305,15 +3305,15 @@ var MAX_IDENTIFIER_LENGTH = 63;
 var VALID_IDENTIFIER_PATTERN = /^[a-z_][a-z0-9_$]*$/i;
 function validateTableName(name, label) {
   if (!name || name.length === 0) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(`${label} table name cannot be empty`);
+    throw new chunk44SXEVF4_cjs.ConfigurationError(`${label} table name cannot be empty`);
   }
   if (name.length > MAX_IDENTIFIER_LENGTH) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(
+    throw new chunk44SXEVF4_cjs.ConfigurationError(
       `${label} table name exceeds maximum length of ${MAX_IDENTIFIER_LENGTH} characters`
     );
   }
   if (!VALID_IDENTIFIER_PATTERN.test(name)) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(
+    throw new chunk44SXEVF4_cjs.ConfigurationError(
       `${label} table name "${name}" is not a valid SQL identifier. Table names must start with a letter or underscore and contain only letters, digits, underscores, or dollar signs.`
     );
   }
@@ -3392,7 +3392,7 @@ function compileSetOperation(op, graphId, dialect, schema, compileQuery2) {
   const passState = runSetOperationPassPipeline(op, graphId, dialect);
   const { logicalPlan } = passState;
   if (logicalPlan === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Logical plan pass did not initialize plan state"
     );
   }
@@ -3456,7 +3456,7 @@ function compileSetOperationForSqlite(op, graphId, dialect, logicalPlan, schema)
     dialect,
     schema,
     compileQuery: () => {
-      throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+      throw new chunk44SXEVF4_cjs.CompilerInvariantError(
         "compileQuery is not available in set-operation CTE compilation"
       );
     }
@@ -3508,7 +3508,7 @@ function validateSqliteSetOpLeaf(ast) {
     unsupported.push("per-query OFFSET (use set operation's offset instead)");
   }
   if (unsupported.length > 0) {
-    throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+    throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
       `SQLite set operations (UNION/INTERSECT/EXCEPT) do not support: ${unsupported.join(", ")}. Use PostgreSQL for complex set operations, or refactor to separate queries.`
     );
   }
@@ -3666,7 +3666,7 @@ function compileFieldValueForSetOp(source, prefix, alias, dialect) {
         return drizzleOrm.sql`${drizzleOrm.sql.raw(fn.toUpperCase())}(${column})`;
       }
       default: {
-        throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+        throw new chunk44SXEVF4_cjs.CompilerInvariantError(
           `Unknown aggregate function: ${String(fn)}`
         );
       }
@@ -3719,7 +3719,7 @@ function buildCompoundSelectRecursive(query, leaves, prefixToSelect) {
   if (!("__type" in query)) {
     const leaf = leaves.find((l) => l.ast === query);
     if (!leaf) {
-      throw new chunkOYL2SGBD_cjs.CompilerInvariantError("Leaf query not found in leaves array");
+      throw new chunk44SXEVF4_cjs.CompilerInvariantError("Leaf query not found in leaves array");
     }
     return prefixToSelect.get(leaf.prefix);
   }
@@ -3763,7 +3763,7 @@ function buildSetOperationSuffixClauses(op, dialect) {
   if (op.orderBy && op.orderBy.length > 0) {
     const projection = getLeftmostProjection(op);
     if (projection.fields.length === 0) {
-      throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+      throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
         "Set operation ORDER BY requires explicit field projection. SELECT * does not provide stable output column names for ordering. Use .select() to specify which fields to project."
       );
     }
@@ -3773,7 +3773,7 @@ function buildSetOperationSuffixClauses(op, dialect) {
       if (!projected) {
         const fieldDesc = o.field.jsonPointer ? `${o.field.alias}.props${o.field.jsonPointer}` : `${o.field.alias}.${o.field.path.join(".")}`;
         const availableFields = projection.fields.map((f) => f.outputName).join(", ");
-        throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+        throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
           `Set operation ORDER BY field "${fieldDesc}" is not in the projection. ORDER BY for UNION/INTERSECT/EXCEPT must reference projected columns. Available columns: ${availableFields}`
         );
       }
@@ -4382,13 +4382,13 @@ function compileStandardQueryWithCteStrategy(ast, graphId, ctx) {
     vectorPredicate
   } = runStandardQueryPassPipeline(ast, graphId, ctx);
   if (temporalFilterPass === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Temporal filter pass did not initialize temporal state",
       { phase: "standard-pass-pipeline" }
     );
   }
   if (logicalPlan === void 0) {
-    throw new chunkOYL2SGBD_cjs.CompilerInvariantError(
+    throw new chunk44SXEVF4_cjs.CompilerInvariantError(
       "Logical plan pass did not initialize plan state",
       { phase: "standard-pass-pipeline" }
     );
@@ -4489,7 +4489,7 @@ function decodeCursor(cursor) {
     const json = atob(base64);
     const raw = JSON.parse(json);
     if (typeof raw.v !== "number" || raw.v > CURSOR_VERSION) {
-      throw new chunkOYL2SGBD_cjs.ValidationError(
+      throw new chunk44SXEVF4_cjs.ValidationError(
         `Unsupported cursor version: ${String(raw.v)}. Maximum supported: ${CURSOR_VERSION}`,
         {
           issues: [
@@ -4505,7 +4505,7 @@ function decodeCursor(cursor) {
       );
     }
     if (raw.d !== "f" && raw.d !== "b") {
-      throw new chunkOYL2SGBD_cjs.ValidationError(`Invalid cursor direction: ${String(raw.d)}`, {
+      throw new chunk44SXEVF4_cjs.ValidationError(`Invalid cursor direction: ${String(raw.d)}`, {
         issues: [
           {
             path: "cursor",
@@ -4515,7 +4515,7 @@ function decodeCursor(cursor) {
       });
     }
     if (!Array.isArray(raw.vals) || !Array.isArray(raw.cols)) {
-      throw new chunkOYL2SGBD_cjs.ValidationError("Invalid cursor structure", {
+      throw new chunk44SXEVF4_cjs.ValidationError("Invalid cursor structure", {
         issues: [
           {
             path: "cursor",
@@ -4525,7 +4525,7 @@ function decodeCursor(cursor) {
       });
     }
     if (raw.vals.length !== raw.cols.length) {
-      throw new chunkOYL2SGBD_cjs.ValidationError("Cursor column count mismatch", {
+      throw new chunk44SXEVF4_cjs.ValidationError("Cursor column count mismatch", {
         issues: [
           {
             path: "cursor",
@@ -4541,10 +4541,10 @@ function decodeCursor(cursor) {
       cols: raw.cols
     };
   } catch (error) {
-    if (error instanceof chunkOYL2SGBD_cjs.ValidationError) {
+    if (error instanceof chunk44SXEVF4_cjs.ValidationError) {
       throw error;
     }
-    throw new chunkOYL2SGBD_cjs.ValidationError(
+    throw new chunk44SXEVF4_cjs.ValidationError(
       "Invalid cursor format",
       {
         issues: [{ path: "cursor", message: "Failed to decode cursor" }]
@@ -4608,7 +4608,7 @@ function buildCursorFromRow(row, orderSpecs, direction) {
 function validateCursorColumns(cursorData, orderSpecs) {
   const expectedCols = orderSpecs.map((spec) => buildColumnId(spec));
   if (cursorData.cols.length !== expectedCols.length) {
-    throw new chunkOYL2SGBD_cjs.ValidationError(
+    throw new chunk44SXEVF4_cjs.ValidationError(
       `Cursor has ${cursorData.cols.length} columns but query has ${expectedCols.length} ORDER BY columns`,
       {
         issues: [
@@ -4625,7 +4625,7 @@ function validateCursorColumns(cursorData, orderSpecs) {
   }
   for (const [index, expectedCol] of expectedCols.entries()) {
     if (cursorData.cols[index] !== expectedCol) {
-      throw new chunkOYL2SGBD_cjs.ValidationError(
+      throw new chunk44SXEVF4_cjs.ValidationError(
         `Cursor column mismatch at position ${index}: expected "${expectedCol}", got "${cursorData.cols[index]}"`,
         {
           issues: [
@@ -5488,7 +5488,7 @@ var SQL_RESERVED_KEYWORDS = /* @__PURE__ */ new Set([
 ]);
 function validateSqlIdentifier(alias) {
   if (!SQL_IDENTIFIER_PATTERN.test(alias)) {
-    throw new chunkOYL2SGBD_cjs.ValidationError(
+    throw new chunk44SXEVF4_cjs.ValidationError(
       `Invalid alias "${alias}": must start with a letter or underscore, contain only letters, digits, and underscores, and be at most 63 characters`,
       {
         issues: [
@@ -5504,7 +5504,7 @@ function validateSqlIdentifier(alias) {
     );
   }
   if (alias.toLowerCase().startsWith("cte_")) {
-    throw new chunkOYL2SGBD_cjs.ValidationError(
+    throw new chunk44SXEVF4_cjs.ValidationError(
       `Invalid alias "${alias}": aliases starting with "cte_" are reserved for internal use`,
       {
         issues: [
@@ -5520,7 +5520,7 @@ function validateSqlIdentifier(alias) {
     );
   }
   if (SQL_RESERVED_KEYWORDS.has(alias.toLowerCase())) {
-    throw new chunkOYL2SGBD_cjs.ValidationError(
+    throw new chunk44SXEVF4_cjs.ValidationError(
       `Invalid alias "${alias}": "${alias}" is a reserved SQL keyword`,
       {
         issues: [
@@ -5534,7 +5534,7 @@ function validateSqlIdentifier(alias) {
   }
 }
 function throwInvalidVectorPredicatePlacement(path) {
-  throw new chunkOYL2SGBD_cjs.ValidationError(
+  throw new chunk44SXEVF4_cjs.ValidationError(
     "Vector similarity predicates cannot be nested under OR or NOT. Use top-level AND combinations instead.",
     {
       issues: [
@@ -5645,7 +5645,7 @@ function buildQueryAst(config, state) {
 }
 function toLiteral(value) {
   if (value === null) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(
+    throw new chunk44SXEVF4_cjs.ConfigurationError(
       "Parameter value must not be null (use undefined-based patterns instead)",
       { parameterName: "value", valueType: "null" }
     );
@@ -5662,7 +5662,7 @@ function toLiteral(value) {
   if (typeof value === "boolean") {
     return { __type: "literal", value, valueType: "boolean" };
   }
-  throw new chunkOYL2SGBD_cjs.ConfigurationError(
+  throw new chunk44SXEVF4_cjs.ConfigurationError(
     `Unsupported parameter value type: ${typeof value}`,
     { parameterName: "value", actualType: typeof value }
   );
@@ -5673,7 +5673,7 @@ function substitutePredicateExpression(expr, bindings) {
       if (isParameterRef(expr.right)) {
         const value = bindings[expr.right.name];
         if (value === void 0) {
-          throw new chunkOYL2SGBD_cjs.ConfigurationError(
+          throw new chunk44SXEVF4_cjs.ConfigurationError(
             `Missing binding for parameter "${expr.right.name}"`,
             { parameterName: expr.right.name }
           );
@@ -5689,13 +5689,13 @@ function substitutePredicateExpression(expr, bindings) {
       if (isParameterRef(expr.pattern)) {
         const value = bindings[expr.pattern.name];
         if (value === void 0) {
-          throw new chunkOYL2SGBD_cjs.ConfigurationError(
+          throw new chunk44SXEVF4_cjs.ConfigurationError(
             `Missing binding for parameter "${expr.pattern.name}"`,
             { parameterName: expr.pattern.name }
           );
         }
         if (typeof value !== "string") {
-          throw new chunkOYL2SGBD_cjs.ConfigurationError(
+          throw new chunk44SXEVF4_cjs.ConfigurationError(
             `Parameter "${expr.pattern.name}" must be a string for string operations`,
             { parameterName: expr.pattern.name, actualType: typeof value }
           );
@@ -5762,7 +5762,7 @@ function substitutePredicateExpression(expr, bindings) {
 function resolveBinding(bindings, name) {
   const value = bindings[name];
   if (value === void 0) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(`Missing binding for parameter "${name}"`, {
+    throw new chunk44SXEVF4_cjs.ConfigurationError(`Missing binding for parameter "${name}"`, {
       parameterName: name
     });
   }
@@ -5787,7 +5787,7 @@ function fillPlaceholders(params, bindings, dialect) {
       const name = parameter.name;
       const value = bindings[name];
       if (value === void 0) {
-        throw new chunkOYL2SGBD_cjs.ConfigurationError(
+        throw new chunk44SXEVF4_cjs.ConfigurationError(
           `Missing binding for parameter "${name}"`,
           { parameterName: name }
         );
@@ -5854,7 +5854,7 @@ var PreparedQuery = class {
           this.#selectFn
         );
       } catch (error) {
-        if (error instanceof MissingSelectiveFieldError || error instanceof chunkOYL2SGBD_cjs.UnsupportedPredicateError) {
+        if (error instanceof MissingSelectiveFieldError || error instanceof chunk44SXEVF4_cjs.UnsupportedPredicateError) {
           return this.#executeUnoptimized(bindings);
         }
         throw error;
@@ -6024,7 +6024,7 @@ function validateBindings(bindings, metadata) {
     }
   }
   if (missing.length > 0) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(
+    throw new chunk44SXEVF4_cjs.ConfigurationError(
       `Missing bindings for parameter${missing.length === 1 ? "" : "s"}: ${missing.map((name) => `"${name}"`).join(", ")}`,
       { missingParameters: missing }
     );
@@ -6033,7 +6033,7 @@ function validateBindings(bindings, metadata) {
     (name) => !expectedNames.has(name)
   );
   if (unexpected.length > 0) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(
+    throw new chunk44SXEVF4_cjs.ConfigurationError(
       `Unexpected bindings provided: ${unexpected.map((name) => `"${name}"`).join(", ")}`,
       { unexpectedParameters: unexpected }
     );
@@ -6045,14 +6045,14 @@ function validateBindings(bindings, metadata) {
 }
 function validateBindingValue(name, value, isStringOp) {
   if (value === null) {
-    throw new chunkOYL2SGBD_cjs.ConfigurationError(
+    throw new chunk44SXEVF4_cjs.ConfigurationError(
       "Parameter value must not be null (use undefined-based patterns instead)",
       { parameterName: name, valueType: "null" }
     );
   }
   if (isStringOp) {
     if (typeof value !== "string") {
-      throw new chunkOYL2SGBD_cjs.ConfigurationError(
+      throw new chunk44SXEVF4_cjs.ConfigurationError(
         `Parameter "${name}" must be a string for string operations`,
         { parameterName: name, actualType: typeof value }
       );
@@ -6062,7 +6062,7 @@ function validateBindingValue(name, value, isStringOp) {
   if (value instanceof Date || typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
     return;
   }
-  throw new chunkOYL2SGBD_cjs.ConfigurationError(
+  throw new chunk44SXEVF4_cjs.ConfigurationError(
     `Unsupported parameter value type: ${typeof value}`,
     { parameterName: name, actualType: typeof value }
   );
@@ -6421,7 +6421,7 @@ var ExecutableQuery = class _ExecutableQuery {
         this.#cachedOptimizedCompiled = NOT_COMPUTED;
         return void 0;
       }
-      if (error instanceof chunkOYL2SGBD_cjs.UnsupportedPredicateError) {
+      if (error instanceof chunk44SXEVF4_cjs.UnsupportedPredicateError) {
         this.#cachedSelectiveFieldsForExecute = void 0;
         this.#cachedOptimizedCompiled = NOT_COMPUTED;
         return void 0;
@@ -6555,7 +6555,7 @@ var ExecutableQuery = class _ExecutableQuery {
         selectiveFields
       });
     } catch (error) {
-      if (error instanceof chunkOYL2SGBD_cjs.UnsupportedPredicateError) {
+      if (error instanceof chunk44SXEVF4_cjs.UnsupportedPredicateError) {
         this.#cachedSelectiveFieldsForPagination = void 0;
         return void 0;
       }
@@ -6581,7 +6581,7 @@ var ExecutableQuery = class _ExecutableQuery {
         this.#cachedSelectiveFieldsForPagination = void 0;
         return void 0;
       }
-      if (error instanceof chunkOYL2SGBD_cjs.UnsupportedPredicateError) {
+      if (error instanceof chunk44SXEVF4_cjs.UnsupportedPredicateError) {
         this.#cachedSelectiveFieldsForPagination = void 0;
         return void 0;
       }
@@ -6606,7 +6606,7 @@ var ExecutableQuery = class _ExecutableQuery {
           this.#cachedSelectiveFieldsForPagination = void 0;
           return void 0;
         }
-        if (error instanceof chunkOYL2SGBD_cjs.UnsupportedPredicateError) {
+        if (error instanceof chunk44SXEVF4_cjs.UnsupportedPredicateError) {
           this.#cachedSelectiveFieldsForPagination = void 0;
           return void 0;
         }
@@ -6744,7 +6744,7 @@ var ExecutableQuery = class _ExecutableQuery {
       );
     }
     if (this.#state.orderBy.length === 0) {
-      throw new chunkOYL2SGBD_cjs.ValidationError(
+      throw new chunk44SXEVF4_cjs.ValidationError(
         "Cursor pagination requires ORDER BY. Add .orderBy() before .paginate()",
         {
           issues: [
@@ -6820,7 +6820,7 @@ var ExecutableQuery = class _ExecutableQuery {
    */
   stream(options) {
     if (this.#state.orderBy.length === 0) {
-      throw new chunkOYL2SGBD_cjs.ValidationError(
+      throw new chunk44SXEVF4_cjs.ValidationError(
         "Streaming requires ORDER BY. Add .orderBy() before .stream()",
         {
           issues: [
@@ -7591,7 +7591,7 @@ var QueryBuilder = class _QueryBuilder {
    */
   temporal(mode, asOf) {
     if (mode === "asOf" && asOf === void 0) {
-      throw new chunkOYL2SGBD_cjs.ValidationError(
+      throw new chunk44SXEVF4_cjs.ValidationError(
         'Temporal mode "asOf" requires a timestamp',
         {
           issues: [
@@ -8247,12 +8247,12 @@ function createQueryBuilder(graphId, registry, options) {
 function buildKindRegistry(graph) {
   const nodeTypes = extractNodeTypes(graph);
   const edgeTypes = extractEdgeTypes(graph);
-  const closures = graph.ontology.length > 0 ? chunkDD6ONEBN_cjs.computeClosuresFromOntology(graph.ontology) : chunkDD6ONEBN_cjs.createEmptyClosures();
-  return new chunkDD6ONEBN_cjs.KindRegistry(nodeTypes, edgeTypes, closures);
+  const closures = graph.ontology.length > 0 ? chunkLDM2AFKZ_cjs.computeClosuresFromOntology(graph.ontology) : chunkLDM2AFKZ_cjs.createEmptyClosures();
+  return new chunkLDM2AFKZ_cjs.KindRegistry(nodeTypes, edgeTypes, closures);
 }
 function extractNodeTypes(graph) {
   const result = /* @__PURE__ */ new Map();
-  for (const typeName of chunkZJHQZZT2_cjs.getNodeKinds(graph)) {
+  for (const typeName of chunkK2ROKOK3_cjs.getNodeKinds(graph)) {
     const registration = graph.nodes[typeName];
     result.set(typeName, registration.type);
   }
@@ -8260,7 +8260,7 @@ function extractNodeTypes(graph) {
 }
 function extractEdgeTypes(graph) {
   const result = /* @__PURE__ */ new Map();
-  for (const typeName of chunkZJHQZZT2_cjs.getEdgeKinds(graph)) {
+  for (const typeName of chunkK2ROKOK3_cjs.getEdgeKinds(graph)) {
     const registration = graph.edges[typeName];
     result.set(typeName, registration.type);
   }
@@ -8393,7 +8393,7 @@ function createEdgeCollection(config) {
     async find(options) {
       const untypedOptions = options;
       if (untypedOptions?.where !== void 0) {
-        throw new chunkOYL2SGBD_cjs.UnsupportedPredicateError(
+        throw new chunk44SXEVF4_cjs.UnsupportedPredicateError(
           `store.edges.${kind}.find({ where }) is not supported. Use store.query().traverse(...).whereEdge(...) for edge property filters.`,
           { kind, operation: "find" }
         );
@@ -8406,7 +8406,7 @@ function createEdgeCollection(config) {
         temporalMode: mode
       };
       if (mode === "current" || mode === "asOf") {
-        params.asOf = options?.asOf ?? chunkZJHQZZT2_cjs.nowIso();
+        params.asOf = options?.asOf ?? chunkK2ROKOK3_cjs.nowIso();
       }
       if (options?.from?.kind !== void 0)
         params.fromKind = options.from.kind;
@@ -8427,7 +8427,7 @@ function createEdgeCollection(config) {
         temporalMode: mode
       };
       if (mode === "current" || mode === "asOf") {
-        params.asOf = options?.asOf ?? chunkZJHQZZT2_cjs.nowIso();
+        params.asOf = options?.asOf ?? chunkK2ROKOK3_cjs.nowIso();
       }
       if (options?.from?.kind !== void 0)
         params.fromKind = options.from.kind;
@@ -8450,7 +8450,7 @@ function createEdgeCollection(config) {
       const results = await executeEdgeCreateBatch2(batchInputs, backend);
       return narrowEdges(results);
     },
-    async bulkUpsert(items) {
+    async bulkUpsertById(items) {
       if (items.length === 0) return [];
       const upsertAll = async (target) => {
         const ids = items.map((item) => item.id);
@@ -8476,7 +8476,7 @@ function createEdgeCollection(config) {
           if (existing) {
             const input = {
               id: item.id,
-              props: item.props ?? {}
+              props: item.props
             };
             if (item.validTo !== void 0) input.validTo = item.validTo;
             toUpdate.push({
@@ -8492,7 +8492,7 @@ function createEdgeCollection(config) {
               fromId: item.from.id,
               toKind: item.to.kind,
               toId: item.to.id,
-              props: item.props ?? {}
+              props: item.props
             };
             if (item.validFrom !== void 0) input.validFrom = item.validFrom;
             if (item.validTo !== void 0) input.validTo = item.validTo;
@@ -8546,6 +8546,57 @@ function createEdgeCollection(config) {
         return;
       }
       await deleteAll(backend);
+    },
+    async getOrCreateByEndpoints(from, to, props, options) {
+      const getOrCreateOptions = {};
+      if (options?.matchOn !== void 0)
+        getOrCreateOptions.matchOn = options.matchOn;
+      if (options?.ifExists !== void 0)
+        getOrCreateOptions.ifExists = options.ifExists;
+      const result = await config.executeGetOrCreateByEndpoints(
+        kind,
+        from.kind,
+        from.id,
+        to.kind,
+        to.id,
+        props,
+        backend,
+        getOrCreateOptions
+      );
+      return { edge: narrowEdge(result.edge), action: result.action };
+    },
+    async bulkGetOrCreateByEndpoints(items, options) {
+      if (items.length === 0) return [];
+      const mappedItems = items.map((item) => ({
+        fromKind: item.from.kind,
+        fromId: item.from.id,
+        toKind: item.to.kind,
+        toId: item.to.id,
+        props: item.props
+      }));
+      const getOrCreateOptions = {};
+      if (options?.matchOn !== void 0)
+        getOrCreateOptions.matchOn = options.matchOn;
+      if (options?.ifExists !== void 0)
+        getOrCreateOptions.ifExists = options.ifExists;
+      const getOrCreateAll = async (target) => {
+        const results = await config.executeBulkGetOrCreateByEndpoints(
+          kind,
+          mappedItems,
+          target,
+          getOrCreateOptions
+        );
+        return results.map((result) => ({
+          edge: narrowEdge(result.edge),
+          action: result.action
+        }));
+      };
+      if (backend.capabilities.transactions && "transaction" in backend) {
+        return backend.transaction(
+          async (txBackend) => getOrCreateAll(txBackend)
+        );
+      }
+      return getOrCreateAll(backend);
     }
   };
 }
@@ -8584,7 +8635,9 @@ function createNodeCollection(config) {
     executeDelete: executeNodeDelete2,
     executeHardDelete: executeNodeHardDelete2,
     matchesTemporalMode,
-    createQuery
+    createQuery,
+    executeGetOrCreateByConstraint,
+    executeBulkGetOrCreateByConstraint
   } = config;
   return {
     async create(props, options) {
@@ -8650,7 +8703,7 @@ function createNodeCollection(config) {
     },
     async find(options) {
       if (options?.where !== void 0 && createQuery === void 0) {
-        throw new chunkOYL2SGBD_cjs.ConfigurationError(
+        throw new chunk44SXEVF4_cjs.ConfigurationError(
           `store.nodes.${kind}.find({ where }) requires a query-capable store`,
           { kind, operation: "find" }
         );
@@ -8659,7 +8712,7 @@ function createNodeCollection(config) {
         const mode2 = options.temporalMode ?? defaultTemporalMode;
         let query = createQuery().from(kind, "_n").temporal(
           mode2,
-          mode2 === "asOf" ? options.asOf ?? chunkZJHQZZT2_cjs.nowIso() : void 0
+          mode2 === "asOf" ? options.asOf ?? chunkK2ROKOK3_cjs.nowIso() : void 0
         ).whereNode("_n", options.where).select((ctx) => ctx._n);
         if (options.limit !== void 0) query = query.limit(options.limit);
         if (options.offset !== void 0) query = query.offset(options.offset);
@@ -8674,7 +8727,7 @@ function createNodeCollection(config) {
         temporalMode: mode
       };
       if (mode === "current" || mode === "asOf") {
-        params.asOf = options?.asOf ?? chunkZJHQZZT2_cjs.nowIso();
+        params.asOf = options?.asOf ?? chunkK2ROKOK3_cjs.nowIso();
       }
       if (options?.limit !== void 0) params.limit = options.limit;
       if (options?.offset !== void 0) params.offset = options.offset;
@@ -8690,11 +8743,11 @@ function createNodeCollection(config) {
         temporalMode: mode
       };
       if (mode === "current" || mode === "asOf") {
-        params.asOf = options?.asOf ?? chunkZJHQZZT2_cjs.nowIso();
+        params.asOf = options?.asOf ?? chunkK2ROKOK3_cjs.nowIso();
       }
       return backend.countNodesByKind(params);
     },
-    async upsert(id, props, options) {
+    async upsertById(id, props, options) {
       const existing = await backend.getNode(graphId, kind, id);
       if (existing) {
         const input = {
@@ -8735,7 +8788,7 @@ function createNodeCollection(config) {
       const results = await executeNodeCreateBatch2(batchInputs, backend);
       return narrowNodes(results);
     },
-    async bulkUpsert(items) {
+    async bulkUpsertById(items) {
       if (items.length === 0) return [];
       const upsertAll = async (target) => {
         const ids = items.map((item) => item.id);
@@ -8832,6 +8885,44 @@ function createNodeCollection(config) {
         return;
       }
       await deleteAll(backend);
+    },
+    async getOrCreateByConstraint(constraintName, props, options) {
+      const execute = async (target) => {
+        const result = await executeGetOrCreateByConstraint(
+          kind,
+          constraintName,
+          props,
+          target,
+          options
+        );
+        return result;
+      };
+      if (backend.capabilities.transactions && "transaction" in backend) {
+        return backend.transaction(async (txBackend) => execute(txBackend));
+      }
+      return execute(backend);
+    },
+    async bulkGetOrCreateByConstraint(constraintName, items, options) {
+      if (items.length === 0) return [];
+      const mappedItems = items.map((item) => ({
+        props: item.props
+      }));
+      const getOrCreateAll = async (target) => {
+        const results = await executeBulkGetOrCreateByConstraint(
+          kind,
+          constraintName,
+          mappedItems,
+          target,
+          options
+        );
+        return results;
+      };
+      if (backend.capabilities.transactions && "transaction" in backend) {
+        return backend.transaction(
+          async (txBackend) => getOrCreateAll(txBackend)
+        );
+      }
+      return getOrCreateAll(backend);
     }
   };
 }
@@ -8844,7 +8935,7 @@ function createNodeCollectionsProxy(graph, graphId, registry, backend, operation
     {
       get: (_, kind) => {
         if (!(kind in graph.nodes)) {
-          throw new chunkOYL2SGBD_cjs.KindNotFoundError(kind, "node");
+          throw new chunk44SXEVF4_cjs.KindNotFoundError(kind, "node");
         }
         const cached = collectionCache.get(kind);
         if (cached !== void 0) {
@@ -8869,7 +8960,7 @@ function createEdgeCollectionsProxy(graph, graphId, registry, backend, operation
     {
       get: (_, kind) => {
         if (!(kind in graph.edges)) {
-          throw new chunkOYL2SGBD_cjs.KindNotFoundError(kind, "edge");
+          throw new chunk44SXEVF4_cjs.KindNotFoundError(kind, "edge");
         }
         const cached = collectionCache.get(kind);
         if (cached !== void 0) {
@@ -8889,16 +8980,18 @@ function createEdgeCollectionsProxy(graph, graphId, registry, backend, operation
 }
 
 // src/constraints/index.ts
+var UNIQUE_KEY_SEPARATOR = "";
+var UNIQUE_KEY_NULL_MARKER = "";
 function computeUniqueKey(props, fields, collation) {
   const values = fields.map((field2) => {
     const value = props[field2];
     if (value === void 0 || value === null) {
-      return "\0";
+      return UNIQUE_KEY_NULL_MARKER;
     }
     const stringValue = typeof value === "string" ? value : typeof value === "number" || typeof value === "boolean" ? value.toString() : JSON.stringify(value);
     return collation === "caseInsensitive" ? stringValue.toLowerCase() : stringValue;
   });
-  return values.join("\0");
+  return values.join(UNIQUE_KEY_SEPARATOR);
 }
 function checkWherePredicate(constraint, props) {
   if (!constraint.where) {
@@ -8967,7 +9060,7 @@ function checkCardinality(edgeKind, fromKind, fromId, cardinality, existingEdgeC
     }
     case "one": {
       if (existingEdgeCount > 0) {
-        return new chunkOYL2SGBD_cjs.CardinalityError({
+        return new chunk44SXEVF4_cjs.CardinalityError({
           edgeKind,
           fromKind,
           fromId,
@@ -8982,7 +9075,7 @@ function checkCardinality(edgeKind, fromKind, fromId, cardinality, existingEdgeC
     }
     case "oneActive": {
       if (hasActiveEdge) {
-        return new chunkOYL2SGBD_cjs.CardinalityError({
+        return new chunk44SXEVF4_cjs.CardinalityError({
           edgeKind,
           fromKind,
           fromId,
@@ -8996,7 +9089,7 @@ function checkCardinality(edgeKind, fromKind, fromId, cardinality, existingEdgeC
 }
 function checkUniqueEdge(edgeKind, fromKind, fromId, _toKind, _toId, existingCount) {
   if (existingCount > 0) {
-    return new chunkOYL2SGBD_cjs.CardinalityError({
+    return new chunk44SXEVF4_cjs.CardinalityError({
       edgeKind,
       fromKind,
       fromId,
@@ -9012,7 +9105,7 @@ function validateEdgeEndpoints(edgeKind, fromKind, toKind, registration, registr
     (validKind) => registry.isAssignableTo(fromKind, validKind)
   );
   if (!fromValid) {
-    return new chunkOYL2SGBD_cjs.EndpointError({
+    return new chunk44SXEVF4_cjs.EndpointError({
       edgeKind,
       endpoint: "from",
       actualKind: fromKind,
@@ -9024,7 +9117,7 @@ function validateEdgeEndpoints(edgeKind, fromKind, toKind, registration, registr
     (validKind) => registry.isAssignableTo(toKind, validKind)
   );
   if (!toValid) {
-    return new chunkOYL2SGBD_cjs.EndpointError({
+    return new chunk44SXEVF4_cjs.EndpointError({
       edgeKind,
       endpoint: "to",
       actualKind: toKind,
@@ -9036,7 +9129,7 @@ function validateEdgeEndpoints(edgeKind, fromKind, toKind, registration, registr
 function checkDisjointness(nodeId, nodeKind, existingKinds, registry) {
   for (const existingKind of existingKinds) {
     if (registry.areDisjoint(nodeKind, existingKind)) {
-      return new chunkOYL2SGBD_cjs.DisjointError({
+      return new chunk44SXEVF4_cjs.DisjointError({
         nodeId,
         attemptedKind: nodeKind,
         conflictingKind: existingKind
@@ -9189,7 +9282,7 @@ function rowToEdge(row) {
 // src/store/operations/edge-operations.ts
 function getEdgeRegistration(graph, kind) {
   const registration = graph.edges[kind];
-  if (registration === void 0) throw new chunkOYL2SGBD_cjs.KindNotFoundError(kind, "edge");
+  if (registration === void 0) throw new chunk44SXEVF4_cjs.KindNotFoundError(kind, "edge");
   return registration;
 }
 function buildEdgeEndpointCacheKey(graphId, kind, id) {
@@ -9331,7 +9424,7 @@ async function validateAndPrepareEdgeCreate(ctx, input, id, backend) {
   if (endpointError) throw endpointError;
   const fromNode = await backend.getNode(ctx.graphId, fromKind, input.fromId);
   if (!fromNode || fromNode.deleted_at) {
-    throw new chunkOYL2SGBD_cjs.EndpointNotFoundError({
+    throw new chunk44SXEVF4_cjs.EndpointNotFoundError({
       edgeKind: kind,
       endpoint: "from",
       nodeKind: fromKind,
@@ -9340,19 +9433,19 @@ async function validateAndPrepareEdgeCreate(ctx, input, id, backend) {
   }
   const toNode = await backend.getNode(ctx.graphId, toKind, input.toId);
   if (!toNode || toNode.deleted_at) {
-    throw new chunkOYL2SGBD_cjs.EndpointNotFoundError({
+    throw new chunk44SXEVF4_cjs.EndpointNotFoundError({
       edgeKind: kind,
       endpoint: "to",
       nodeKind: toKind,
       nodeId: input.toId
     });
   }
-  const validatedProps = chunkDD6ONEBN_cjs.validateEdgeProps(edgeKind.schema, input.props, {
+  const validatedProps = chunkLDM2AFKZ_cjs.validateEdgeProps(edgeKind.schema, input.props, {
     kind,
     operation: "create"
   });
-  const validFrom = chunkZJHQZZT2_cjs.validateOptionalIsoDate(input.validFrom, "validFrom");
-  const validTo = chunkZJHQZZT2_cjs.validateOptionalIsoDate(input.validTo, "validTo");
+  const validFrom = chunkK2ROKOK3_cjs.validateOptionalIsoDate(input.validFrom, "validFrom");
+  const validTo = chunkK2ROKOK3_cjs.validateOptionalIsoDate(input.validTo, "validTo");
   const cardinality = registration.cardinality ?? "many";
   const constraintContext = {
     graphId: ctx.graphId,
@@ -9407,7 +9500,7 @@ async function executeEdgeCreateInternal(ctx, input, backend, options) {
 async function executeEdgeCreate(ctx, input, backend) {
   const result = await executeEdgeCreateInternal(ctx, input, backend);
   if (!result) {
-    throw new chunkOYL2SGBD_cjs.DatabaseOperationError(
+    throw new chunk44SXEVF4_cjs.DatabaseOperationError(
       "Edge create failed: expected created edge row",
       { operation: "insert", entity: "edge" }
     );
@@ -9484,7 +9577,7 @@ async function executeEdgeUpdate(ctx, input, backend) {
   const id = input.id;
   const existing = await backend.getEdge(ctx.graphId, id);
   if (!existing || existing.deleted_at) {
-    throw new chunkOYL2SGBD_cjs.EdgeNotFoundError("unknown", id);
+    throw new chunk44SXEVF4_cjs.EdgeNotFoundError("unknown", id);
   }
   const opContext = ctx.createOperationContext(
     "update",
@@ -9497,12 +9590,12 @@ async function executeEdgeUpdate(ctx, input, backend) {
     const edgeKind = registration.type;
     const existingProps = JSON.parse(existing.props);
     const mergedProps = { ...existingProps, ...input.props };
-    const validatedProps = chunkDD6ONEBN_cjs.validateEdgeProps(edgeKind.schema, mergedProps, {
+    const validatedProps = chunkLDM2AFKZ_cjs.validateEdgeProps(edgeKind.schema, mergedProps, {
       kind: existing.kind,
       operation: "update",
       id
     });
-    const validTo = chunkZJHQZZT2_cjs.validateOptionalIsoDate(input.validTo, "validTo");
+    const validTo = chunkK2ROKOK3_cjs.validateOptionalIsoDate(input.validTo, "validTo");
     const updateParams = {
       graphId: ctx.graphId,
       id,
@@ -9517,18 +9610,18 @@ async function executeEdgeUpsertUpdate(ctx, input, backend, options) {
   const id = input.id;
   const existing = await backend.getEdge(ctx.graphId, id);
   if (!existing) {
-    throw new chunkOYL2SGBD_cjs.EdgeNotFoundError("unknown", id);
+    throw new chunk44SXEVF4_cjs.EdgeNotFoundError("unknown", id);
   }
   const registration = getEdgeRegistration(ctx.graph, existing.kind);
   const edgeKind = registration.type;
   const existingProps = JSON.parse(existing.props);
   const mergedProps = { ...existingProps, ...input.props };
-  const validatedProps = chunkDD6ONEBN_cjs.validateEdgeProps(edgeKind.schema, mergedProps, {
+  const validatedProps = chunkLDM2AFKZ_cjs.validateEdgeProps(edgeKind.schema, mergedProps, {
     kind: existing.kind,
     operation: "update",
     id
   });
-  const validTo = chunkZJHQZZT2_cjs.validateOptionalIsoDate(input.validTo, "validTo");
+  const validTo = chunkK2ROKOK3_cjs.validateOptionalIsoDate(input.validTo, "validTo");
   const updateParams = {
     graphId: ctx.graphId,
     id,
@@ -9575,6 +9668,321 @@ async function executeEdgeHardDelete(ctx, id, backend) {
     });
   });
 }
+var RECORD_SEP = "";
+var UNIT_SEP = "";
+var UNDEFINED_SENTINEL = "";
+function validateMatchOnFields(schema, matchOn, edgeKind) {
+  if (matchOn.length === 0) return;
+  const shape = schema.shape;
+  if (shape === void 0) {
+    throw new chunk44SXEVF4_cjs.ValidationError(
+      `Edge kind "${edgeKind}" has no schema shape to validate matchOn fields against`,
+      {
+        kind: edgeKind,
+        operation: "create",
+        issues: matchOn.map((field2) => ({
+          path: field2,
+          message: `Field "${field2}" does not exist in edge schema`
+        }))
+      }
+    );
+  }
+  const invalidFields = matchOn.filter((field2) => !(field2 in shape));
+  if (invalidFields.length > 0) {
+    throw new chunk44SXEVF4_cjs.ValidationError(
+      `Invalid matchOn fields for edge kind "${edgeKind}": ${invalidFields.join(", ")}`,
+      {
+        kind: edgeKind,
+        operation: "create",
+        issues: invalidFields.map((field2) => ({
+          path: field2,
+          message: `Field "${field2}" does not exist in edge schema`
+        }))
+      }
+    );
+  }
+}
+function stableStringify(value) {
+  if (value === void 0) return UNDEFINED_SENTINEL;
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+  }
+  const sorted = Object.keys(value).toSorted();
+  const entries = sorted.map(
+    (key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`
+  );
+  return `{${entries.join(",")}}`;
+}
+function buildEdgeCompositeKey(fromKind, fromId, toKind, toId, props, matchOn) {
+  const endpointPart = `${fromKind}${RECORD_SEP}${fromId}${RECORD_SEP}${toKind}${RECORD_SEP}${toId}`;
+  if (matchOn.length === 0) return endpointPart;
+  const sortedFields = [...matchOn].toSorted();
+  const propertyParts = sortedFields.map(
+    (field2) => `${RECORD_SEP}${field2}${UNIT_SEP}${stableStringify(props[field2])}`
+  );
+  return endpointPart + propertyParts.join("");
+}
+function buildEndpointPairKey(fromKind, fromId, toKind, toId) {
+  return `${fromKind}${RECORD_SEP}${fromId}${RECORD_SEP}${toKind}${RECORD_SEP}${toId}`;
+}
+function findMatchingEdge(rows, matchOn, inputProps) {
+  let liveRow;
+  let deletedRow;
+  for (const row of rows) {
+    if (matchOn.length > 0) {
+      const rowProps = JSON.parse(row.props);
+      const matches = matchOn.every(
+        (field2) => stableStringify(rowProps[field2]) === stableStringify(inputProps[field2])
+      );
+      if (!matches) continue;
+    }
+    if (row.deleted_at === void 0) {
+      liveRow ??= row;
+    } else {
+      deletedRow ??= row;
+    }
+    if (liveRow !== void 0) break;
+  }
+  return { liveRow, deletedRow };
+}
+async function executeEdgeGetOrCreateByEndpoints(ctx, kind, fromKind, fromId, toKind, toId, props, backend, options) {
+  const ifExists = options?.ifExists ?? "return";
+  const matchOn = options?.matchOn ?? [];
+  const registration = getEdgeRegistration(ctx.graph, kind);
+  const edgeKind = registration.type;
+  const validatedProps = chunkLDM2AFKZ_cjs.validateEdgeProps(edgeKind.schema, props, {
+    kind,
+    operation: "create"
+  });
+  validateMatchOnFields(edgeKind.schema, matchOn, kind);
+  const candidateRows = await backend.findEdgesByKind({
+    graphId: ctx.graphId,
+    kind,
+    fromKind,
+    fromId,
+    toKind,
+    toId,
+    excludeDeleted: false,
+    temporalMode: "includeTombstones"
+  });
+  const { liveRow, deletedRow } = findMatchingEdge(
+    candidateRows,
+    matchOn,
+    validatedProps
+  );
+  if (liveRow === void 0 && deletedRow === void 0) {
+    const input = {
+      kind,
+      fromKind,
+      fromId,
+      toKind,
+      toId,
+      props: validatedProps
+    };
+    const edge2 = await executeEdgeCreate(ctx, input, backend);
+    return { edge: edge2, action: "created" };
+  }
+  if (liveRow !== void 0) {
+    if (ifExists === "return") {
+      return { edge: rowToEdge(liveRow), action: "found" };
+    }
+    const edge2 = await executeEdgeUpsertUpdate(
+      ctx,
+      { id: liveRow.id, props: validatedProps },
+      backend
+    );
+    return { edge: edge2, action: "updated" };
+  }
+  const cardinality = registration.cardinality ?? "many";
+  const matchedDeletedRow = deletedRow;
+  const effectiveValidTo = matchedDeletedRow.valid_to;
+  const constraintContext = {
+    graphId: ctx.graphId,
+    registry: ctx.registry,
+    backend
+  };
+  await checkCardinalityConstraint(
+    constraintContext,
+    kind,
+    cardinality,
+    fromKind,
+    fromId,
+    toKind,
+    toId,
+    effectiveValidTo
+  );
+  const edge = await executeEdgeUpsertUpdate(
+    ctx,
+    { id: matchedDeletedRow.id, props: validatedProps },
+    backend,
+    { clearDeleted: true }
+  );
+  return { edge, action: "resurrected" };
+}
+async function executeEdgeBulkGetOrCreateByEndpoints(ctx, kind, items, backend, options) {
+  if (items.length === 0) return [];
+  const ifExists = options?.ifExists ?? "return";
+  const matchOn = options?.matchOn ?? [];
+  const registration = getEdgeRegistration(ctx.graph, kind);
+  const edgeKind = registration.type;
+  const cardinality = registration.cardinality ?? "many";
+  validateMatchOnFields(edgeKind.schema, matchOn, kind);
+  const validated = [];
+  for (const item of items) {
+    const validatedProps = chunkLDM2AFKZ_cjs.validateEdgeProps(edgeKind.schema, item.props, {
+      kind,
+      operation: "create"
+    });
+    const compositeKey = buildEdgeCompositeKey(
+      item.fromKind,
+      item.fromId,
+      item.toKind,
+      item.toId,
+      validatedProps,
+      matchOn
+    );
+    const endpointKey = buildEndpointPairKey(
+      item.fromKind,
+      item.fromId,
+      item.toKind,
+      item.toId
+    );
+    validated.push({
+      fromKind: item.fromKind,
+      fromId: item.fromId,
+      toKind: item.toKind,
+      toId: item.toId,
+      validatedProps,
+      compositeKey,
+      endpointKey
+    });
+  }
+  const uniqueEndpoints = /* @__PURE__ */ new Map();
+  for (const entry of validated) {
+    if (!uniqueEndpoints.has(entry.endpointKey)) {
+      uniqueEndpoints.set(entry.endpointKey, {
+        fromKind: entry.fromKind,
+        fromId: entry.fromId,
+        toKind: entry.toKind,
+        toId: entry.toId
+      });
+    }
+  }
+  const rowsByEndpoint = /* @__PURE__ */ new Map();
+  for (const [endpointKey, endpoint] of uniqueEndpoints) {
+    const rows = await backend.findEdgesByKind({
+      graphId: ctx.graphId,
+      kind,
+      fromKind: endpoint.fromKind,
+      fromId: endpoint.fromId,
+      toKind: endpoint.toKind,
+      toId: endpoint.toId,
+      excludeDeleted: false,
+      temporalMode: "includeTombstones"
+    });
+    rowsByEndpoint.set(endpointKey, rows);
+  }
+  const toCreate = [];
+  const toFetch = [];
+  const duplicateOf = [];
+  const seenKeys = /* @__PURE__ */ new Map();
+  for (const [index, entry] of validated.entries()) {
+    const previousIndex = seenKeys.get(entry.compositeKey);
+    if (previousIndex !== void 0) {
+      duplicateOf.push({ index, sourceIndex: previousIndex });
+      continue;
+    }
+    seenKeys.set(entry.compositeKey, index);
+    const candidateRows = rowsByEndpoint.get(entry.endpointKey) ?? [];
+    const { liveRow, deletedRow } = findMatchingEdge(
+      candidateRows,
+      matchOn,
+      entry.validatedProps
+    );
+    if (liveRow === void 0 && deletedRow === void 0) {
+      toCreate.push({
+        index,
+        input: {
+          kind,
+          fromKind: entry.fromKind,
+          fromId: entry.fromId,
+          toKind: entry.toKind,
+          toId: entry.toId,
+          props: entry.validatedProps
+        }
+      });
+    } else {
+      const bestRow = liveRow ?? deletedRow;
+      toFetch.push({
+        index,
+        row: bestRow,
+        isDeleted: liveRow === void 0,
+        validatedProps: entry.validatedProps,
+        fromKind: entry.fromKind,
+        fromId: entry.fromId,
+        toKind: entry.toKind,
+        toId: entry.toId
+      });
+    }
+  }
+  const results = Array.from({ length: items.length });
+  if (toCreate.length > 0) {
+    const createInputs = toCreate.map((entry) => entry.input);
+    const createdEdges = await executeEdgeCreateBatch(
+      ctx,
+      createInputs,
+      backend
+    );
+    for (const [batchIndex, entry] of toCreate.entries()) {
+      results[entry.index] = {
+        edge: createdEdges[batchIndex],
+        action: "created"
+      };
+    }
+  }
+  for (const entry of toFetch) {
+    if (entry.isDeleted) {
+      const effectiveValidTo = entry.row.valid_to;
+      const constraintContext = {
+        graphId: ctx.graphId,
+        registry: ctx.registry,
+        backend
+      };
+      await checkCardinalityConstraint(
+        constraintContext,
+        kind,
+        cardinality,
+        entry.fromKind,
+        entry.fromId,
+        entry.toKind,
+        entry.toId,
+        effectiveValidTo
+      );
+      const edge = await executeEdgeUpsertUpdate(
+        ctx,
+        { id: entry.row.id, props: entry.validatedProps },
+        backend,
+        { clearDeleted: true }
+      );
+      results[entry.index] = { edge, action: "resurrected" };
+    } else if (ifExists === "update") {
+      const edge = await executeEdgeUpsertUpdate(
+        ctx,
+        { id: entry.row.id, props: entry.validatedProps },
+        backend
+      );
+      results[entry.index] = { edge, action: "updated" };
+    } else {
+      results[entry.index] = { edge: rowToEdge(entry.row), action: "found" };
+    }
+  }
+  for (const { index, sourceIndex } of duplicateOf) {
+    const sourceResult = results[sourceIndex];
+    results[index] = { edge: sourceResult.edge, action: "found" };
+  }
+  return results;
+}
 
 // src/store/embedding-sync.ts
 function getEmbeddingFields(schema) {
@@ -9696,7 +10104,7 @@ async function checkUniquenessConstraints(ctx, kind, id, props, constraints) {
         key
       });
       if (existing && existing.node_id !== id) {
-        throw new chunkOYL2SGBD_cjs.UniquenessError({
+        throw new chunk44SXEVF4_cjs.UniquenessError({
           constraintName: constraint.name,
           kind: kindToCheck,
           existingId: existing.node_id,
@@ -9779,7 +10187,7 @@ async function updateUniquenessEntries(ctx, kind, id, oldProps, newProps, constr
           key: newKey
         });
         if (existing && existing.node_id !== id) {
-          throw new chunkOYL2SGBD_cjs.UniquenessError({
+          throw new chunk44SXEVF4_cjs.UniquenessError({
             constraintName: constraint.name,
             kind: kindToCheck,
             existingId: existing.node_id,
@@ -9803,7 +10211,7 @@ async function updateUniquenessEntries(ctx, kind, id, oldProps, newProps, constr
 // src/store/operations/node-operations.ts
 function getNodeRegistration(graph, kind) {
   const registration = graph.nodes[kind];
-  if (registration === void 0) throw new chunkOYL2SGBD_cjs.KindNotFoundError(kind, "node");
+  if (registration === void 0) throw new chunk44SXEVF4_cjs.KindNotFoundError(kind, "node");
   return registration;
 }
 function buildNodeCacheKey(graphId, kind, id) {
@@ -9813,7 +10221,7 @@ function buildUniqueCacheKey(graphId, nodeKind, constraintName, key) {
   return `${graphId}\0${nodeKind}\0${constraintName}\0${key}`;
 }
 function createNodeAlreadyExistsError(kind, id) {
-  return new chunkOYL2SGBD_cjs.ValidationError(
+  return new chunk44SXEVF4_cjs.ValidationError(
     `Node already exists: ${kind}/${id}`,
     {
       entityType: "node",
@@ -9955,12 +10363,12 @@ async function validateAndPrepareNodeCreate(ctx, input, id, backend) {
   const kind = input.kind;
   const registration = getNodeRegistration(ctx.graph, kind);
   const nodeKind = registration.type;
-  const validatedProps = chunkDD6ONEBN_cjs.validateNodeProps(nodeKind.schema, input.props, {
+  const validatedProps = chunkLDM2AFKZ_cjs.validateNodeProps(nodeKind.schema, input.props, {
     kind,
     operation: "create"
   });
-  const validFrom = chunkZJHQZZT2_cjs.validateOptionalIsoDate(input.validFrom, "validFrom");
-  const validTo = chunkZJHQZZT2_cjs.validateOptionalIsoDate(input.validTo, "validTo");
+  const validFrom = chunkK2ROKOK3_cjs.validateOptionalIsoDate(input.validFrom, "validFrom");
+  const validTo = chunkK2ROKOK3_cjs.validateOptionalIsoDate(input.validTo, "validTo");
   const existingNode = await backend.getNode(ctx.graphId, kind, id);
   if (existingNode && !existingNode.deleted_at) {
     throw createNodeAlreadyExistsError(kind, id);
@@ -10048,7 +10456,7 @@ async function executeNodeCreateInternal(ctx, input, backend, options) {
 async function executeNodeCreate(ctx, input, backend) {
   const result = await executeNodeCreateInternal(ctx, input, backend);
   if (!result) {
-    throw new chunkOYL2SGBD_cjs.DatabaseOperationError(
+    throw new chunk44SXEVF4_cjs.DatabaseOperationError(
       "Node create failed: expected created node row",
       { operation: "insert", entity: "node" }
     );
@@ -10149,17 +10557,17 @@ async function executeNodeUpdate(ctx, input, backend, options) {
     const registration = getNodeRegistration(ctx.graph, kind);
     const existing = await backend.getNode(ctx.graphId, kind, id);
     if (!existing || existing.deleted_at && !options?.clearDeleted) {
-      throw new chunkOYL2SGBD_cjs.NodeNotFoundError(kind, id);
+      throw new chunk44SXEVF4_cjs.NodeNotFoundError(kind, id);
     }
     const existingProps = JSON.parse(existing.props);
     const mergedProps = { ...existingProps, ...input.props };
     const nodeKind = registration.type;
-    const validatedProps = chunkDD6ONEBN_cjs.validateNodeProps(nodeKind.schema, mergedProps, {
+    const validatedProps = chunkLDM2AFKZ_cjs.validateNodeProps(nodeKind.schema, mergedProps, {
       kind,
       operation: "update",
       id
     });
-    const validTo = chunkZJHQZZT2_cjs.validateOptionalIsoDate(input.validTo, "validTo");
+    const validTo = chunkK2ROKOK3_cjs.validateOptionalIsoDate(input.validTo, "validTo");
     const uniquenessContext = {
       graphId: ctx.graphId,
       registry: ctx.registry,
@@ -10199,17 +10607,17 @@ async function executeNodeUpsertUpdate(ctx, input, backend, options) {
   const registration = getNodeRegistration(ctx.graph, kind);
   const existing = await backend.getNode(ctx.graphId, kind, id);
   if (!existing || existing.deleted_at && !options?.clearDeleted) {
-    throw new chunkOYL2SGBD_cjs.NodeNotFoundError(kind, id);
+    throw new chunk44SXEVF4_cjs.NodeNotFoundError(kind, id);
   }
   const existingProps = JSON.parse(existing.props);
   const mergedProps = { ...existingProps, ...input.props };
   const nodeKind = registration.type;
-  const validatedProps = chunkDD6ONEBN_cjs.validateNodeProps(nodeKind.schema, mergedProps, {
+  const validatedProps = chunkLDM2AFKZ_cjs.validateNodeProps(nodeKind.schema, mergedProps, {
     kind,
     operation: "update",
     id
   });
-  const validTo = chunkZJHQZZT2_cjs.validateOptionalIsoDate(input.validTo, "validTo");
+  const validTo = chunkK2ROKOK3_cjs.validateOptionalIsoDate(input.validTo, "validTo");
   const uniquenessContext = {
     graphId: ctx.graphId,
     registry: ctx.registry,
@@ -10263,7 +10671,7 @@ async function executeNodeDelete(ctx, kind, id, backend) {
           const edgeKinds = [
             ...new Set(connectedEdges.map((edge) => edge.kind))
           ];
-          throw new chunkOYL2SGBD_cjs.RestrictedDeleteError({
+          throw new chunk44SXEVF4_cjs.RestrictedDeleteError({
             nodeKind: kind,
             nodeId: id,
             edgeCount: connectedEdges.length,
@@ -10328,7 +10736,7 @@ async function executeNodeHardDelete(ctx, kind, id, backend) {
           const edgeKinds = [
             ...new Set(connectedEdges.map((edge) => edge.kind))
           ];
-          throw new chunkOYL2SGBD_cjs.RestrictedDeleteError({
+          throw new chunk44SXEVF4_cjs.RestrictedDeleteError({
             nodeKind: kind,
             nodeId: id,
             edgeCount: connectedEdges.length,
@@ -10357,6 +10765,235 @@ async function executeNodeHardDelete(ctx, kind, id, backend) {
     await ("transaction" in backend && backend.capabilities.transactions ? backend.transaction(async (tx) => hardDelete(tx)) : hardDelete(backend));
   });
 }
+function resolveConstraint(graph, kind, constraintName) {
+  const registration = getNodeRegistration(graph, kind);
+  const constraints = registration.unique ?? [];
+  const constraint = constraints.find((c) => c.name === constraintName);
+  if (constraint === void 0) {
+    throw new chunk44SXEVF4_cjs.NodeConstraintNotFoundError(constraintName, kind);
+  }
+  return constraint;
+}
+async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, props, backend, options) {
+  const ifExists = options?.ifExists ?? "return";
+  const registration = getNodeRegistration(ctx.graph, kind);
+  const nodeKind = registration.type;
+  const validatedProps = chunkLDM2AFKZ_cjs.validateNodeProps(nodeKind.schema, props, {
+    kind,
+    operation: "create"
+  });
+  const constraint = resolveConstraint(ctx.graph, kind, constraintName);
+  if (!checkWherePredicate(constraint, validatedProps)) {
+    const input = { kind, props: validatedProps };
+    const node = await executeNodeCreate(ctx, input, backend);
+    return { node, action: "created" };
+  }
+  const key = computeUniqueKey(
+    validatedProps,
+    constraint.fields,
+    constraint.collation
+  );
+  const kindsToCheck = getKindsForUniquenessCheck(
+    kind,
+    constraint.scope,
+    ctx.registry
+  );
+  let existingUniqueRow;
+  for (const kindToCheck of kindsToCheck) {
+    const row = await backend.checkUnique({
+      graphId: ctx.graphId,
+      nodeKind: kindToCheck,
+      constraintName: constraint.name,
+      key,
+      includeDeleted: true
+    });
+    if (row !== void 0) {
+      existingUniqueRow = row;
+      break;
+    }
+  }
+  if (existingUniqueRow === void 0) {
+    const input = { kind, props: validatedProps };
+    const node = await executeNodeCreate(ctx, input, backend);
+    return { node, action: "created" };
+  }
+  const existingRow = await backend.getNode(
+    ctx.graphId,
+    existingUniqueRow.concrete_kind,
+    existingUniqueRow.node_id
+  );
+  if (existingRow === void 0) {
+    const input = { kind, props: validatedProps };
+    const node = await executeNodeCreate(ctx, input, backend);
+    return { node, action: "created" };
+  }
+  const isSoftDeleted = existingRow.deleted_at !== void 0;
+  if (isSoftDeleted || ifExists === "update") {
+    const concreteKind = existingUniqueRow.concrete_kind;
+    const node = await executeNodeUpsertUpdate(
+      ctx,
+      {
+        kind: concreteKind,
+        id: existingRow.id,
+        props: validatedProps
+      },
+      backend,
+      { clearDeleted: isSoftDeleted }
+    );
+    return { node, action: isSoftDeleted ? "resurrected" : "updated" };
+  }
+  return { node: rowToNode(existingRow), action: "found" };
+}
+async function executeNodeBulkGetOrCreateByConstraint(ctx, kind, constraintName, items, backend, options) {
+  if (items.length === 0) return [];
+  const ifExists = options?.ifExists ?? "return";
+  const registration = getNodeRegistration(ctx.graph, kind);
+  const nodeKind = registration.type;
+  const constraint = resolveConstraint(ctx.graph, kind, constraintName);
+  const validated = [];
+  for (const item of items) {
+    const validatedProps = chunkLDM2AFKZ_cjs.validateNodeProps(nodeKind.schema, item.props, {
+      kind,
+      operation: "create"
+    });
+    const applies = checkWherePredicate(constraint, validatedProps);
+    const key = applies ? computeUniqueKey(
+      validatedProps,
+      constraint.fields,
+      constraint.collation
+    ) : void 0;
+    validated.push({ validatedProps, key });
+  }
+  const uniqueKeys = [
+    ...new Set(
+      validated.map((v) => v.key).filter((k) => k !== void 0)
+    )
+  ];
+  const kindsToCheck = getKindsForUniquenessCheck(
+    kind,
+    constraint.scope,
+    ctx.registry
+  );
+  const existingByKey = /* @__PURE__ */ new Map();
+  if (uniqueKeys.length > 0) {
+    for (const kindToCheck of kindsToCheck) {
+      if (backend.checkUniqueBatch === void 0) {
+        for (const key of uniqueKeys) {
+          if (existingByKey.has(key)) continue;
+          const row = await backend.checkUnique({
+            graphId: ctx.graphId,
+            nodeKind: kindToCheck,
+            constraintName: constraint.name,
+            key,
+            includeDeleted: true
+          });
+          if (row !== void 0) {
+            existingByKey.set(row.key, row);
+          }
+        }
+      } else {
+        const rows = await backend.checkUniqueBatch({
+          graphId: ctx.graphId,
+          nodeKind: kindToCheck,
+          constraintName: constraint.name,
+          keys: uniqueKeys,
+          includeDeleted: true
+        });
+        for (const row of rows) {
+          if (!existingByKey.has(row.key)) {
+            existingByKey.set(row.key, row);
+          }
+        }
+      }
+    }
+  }
+  const toCreate = [];
+  const toFetch = [];
+  const duplicateOf = [];
+  const seenKeys = /* @__PURE__ */ new Map();
+  for (const [index, { validatedProps, key }] of validated.entries()) {
+    if (key === void 0) {
+      toCreate.push({
+        index,
+        input: { kind, props: validatedProps }
+      });
+      continue;
+    }
+    const previousIndex = seenKeys.get(key);
+    if (previousIndex !== void 0) {
+      duplicateOf.push({ index, sourceIndex: previousIndex });
+      continue;
+    }
+    seenKeys.set(key, index);
+    const existing = existingByKey.get(key);
+    if (existing === void 0) {
+      toCreate.push({
+        index,
+        input: { kind, props: validatedProps }
+      });
+    } else {
+      toFetch.push({
+        index,
+        nodeId: existing.node_id,
+        concreteKind: existing.concrete_kind,
+        validatedProps,
+        isSoftDeleted: existing.deleted_at !== void 0
+      });
+    }
+  }
+  const results = Array.from({ length: items.length });
+  if (toCreate.length > 0) {
+    const createInputs = toCreate.map((entry) => entry.input);
+    const createdNodes = await executeNodeCreateBatch(
+      ctx,
+      createInputs,
+      backend
+    );
+    for (const [batchIndex, entry] of toCreate.entries()) {
+      results[entry.index] = {
+        node: createdNodes[batchIndex],
+        action: "created"
+      };
+    }
+  }
+  for (const entry of toFetch) {
+    const { index, concreteKind, validatedProps, isSoftDeleted, nodeId } = entry;
+    const existingRow = await backend.getNode(
+      ctx.graphId,
+      concreteKind,
+      nodeId
+    );
+    if (existingRow === void 0) {
+      const input = { kind, props: validatedProps };
+      const node = await executeNodeCreate(ctx, input, backend);
+      results[index] = { node, action: "created" };
+      continue;
+    }
+    if (isSoftDeleted || ifExists === "update") {
+      const node = await executeNodeUpsertUpdate(
+        ctx,
+        {
+          kind: concreteKind,
+          id: existingRow.id,
+          props: validatedProps
+        },
+        backend,
+        { clearDeleted: isSoftDeleted }
+      );
+      results[index] = {
+        node,
+        action: isSoftDeleted ? "resurrected" : "updated"
+      };
+    } else {
+      results[index] = { node: rowToNode(existingRow), action: "found" };
+    }
+  }
+  for (const { index, sourceIndex } of duplicateOf) {
+    const sourceResult = results[sourceIndex];
+    results[index] = { node: sourceResult.node, action: "found" };
+  }
+  return results;
+}
 
 // src/store/store.ts
 var Store = class {
@@ -10470,7 +11107,23 @@ var Store = class {
       executeDelete: (kind, id, backend) => executeNodeDelete(ctx, kind, id, backend),
       executeHardDelete: (kind, id, backend) => executeNodeHardDelete(ctx, kind, id, backend),
       matchesTemporalMode: (row, options) => this.#matchesTemporalMode(row, options),
-      createQuery: () => this.query()
+      createQuery: () => this.query(),
+      executeGetOrCreateByConstraint: (kind, constraintName, props, backend, options) => executeNodeGetOrCreateByConstraint(
+        ctx,
+        kind,
+        constraintName,
+        props,
+        backend,
+        options
+      ),
+      executeBulkGetOrCreateByConstraint: (kind, constraintName, items, backend, options) => executeNodeBulkGetOrCreateByConstraint(
+        ctx,
+        kind,
+        constraintName,
+        items,
+        backend,
+        options
+      )
     };
   }
   /**
@@ -10489,7 +11142,25 @@ var Store = class {
       executeDelete: (id, backend) => executeEdgeDelete(ctx, id, backend),
       executeHardDelete: (id, backend) => executeEdgeHardDelete(ctx, id, backend),
       matchesTemporalMode: (row, options) => this.#matchesTemporalMode(row, options),
-      createQuery: () => this.query()
+      createQuery: () => this.query(),
+      executeGetOrCreateByEndpoints: (kind, fromKind, fromId, toKind, toId, props, backend, options) => executeEdgeGetOrCreateByEndpoints(
+        ctx,
+        kind,
+        fromKind,
+        fromId,
+        toKind,
+        toId,
+        props,
+        backend,
+        options
+      ),
+      executeBulkGetOrCreateByEndpoints: (kind, items, backend, options) => executeEdgeBulkGetOrCreateByEndpoints(
+        ctx,
+        kind,
+        items,
+        backend,
+        options
+      )
     };
   }
   // === Query Builder ===
@@ -10624,7 +11295,7 @@ var Store = class {
   // === Internal: Temporal Filtering ===
   #matchesTemporalMode(row, options) {
     const mode = options?.temporalMode ?? this.#graph.defaults.temporalMode;
-    const asOf = options?.asOf ?? chunkZJHQZZT2_cjs.nowIso();
+    const asOf = options?.asOf ?? chunkK2ROKOK3_cjs.nowIso();
     switch (mode) {
       case "current":
       case "asOf": {
@@ -10657,133 +11328,137 @@ function createStore(graph, backend, options) {
 }
 async function createStoreWithSchema(graph, backend, options) {
   const store = createStore(graph, backend, options);
-  const result = await chunkDD6ONEBN_cjs.ensureSchema(backend, graph, options);
+  const result = await chunkLDM2AFKZ_cjs.ensureSchema(backend, graph, options);
   return [store, result];
 }
 
 Object.defineProperty(exports, "isMetaEdge", {
   enumerable: true,
-  get: function () { return chunkDD6ONEBN_cjs.isMetaEdge; }
+  get: function () { return chunkLDM2AFKZ_cjs.isMetaEdge; }
 });
 Object.defineProperty(exports, "defineGraph", {
   enumerable: true,
-  get: function () { return chunkZJHQZZT2_cjs.defineGraph; }
+  get: function () { return chunkK2ROKOK3_cjs.defineGraph; }
 });
 Object.defineProperty(exports, "getEdgeKinds", {
   enumerable: true,
-  get: function () { return chunkZJHQZZT2_cjs.getEdgeKinds; }
+  get: function () { return chunkK2ROKOK3_cjs.getEdgeKinds; }
 });
 Object.defineProperty(exports, "getNodeKinds", {
   enumerable: true,
-  get: function () { return chunkZJHQZZT2_cjs.getNodeKinds; }
+  get: function () { return chunkK2ROKOK3_cjs.getNodeKinds; }
 });
 Object.defineProperty(exports, "isEdgeType", {
   enumerable: true,
-  get: function () { return chunkZJHQZZT2_cjs.isEdgeType; }
+  get: function () { return chunkK2ROKOK3_cjs.isEdgeType; }
 });
 Object.defineProperty(exports, "isEdgeTypeWithEndpoints", {
   enumerable: true,
-  get: function () { return chunkZJHQZZT2_cjs.isEdgeTypeWithEndpoints; }
+  get: function () { return chunkK2ROKOK3_cjs.isEdgeTypeWithEndpoints; }
 });
 Object.defineProperty(exports, "isGraphDef", {
   enumerable: true,
-  get: function () { return chunkZJHQZZT2_cjs.isGraphDef; }
+  get: function () { return chunkK2ROKOK3_cjs.isGraphDef; }
 });
 Object.defineProperty(exports, "isNodeType", {
   enumerable: true,
-  get: function () { return chunkZJHQZZT2_cjs.isNodeType; }
+  get: function () { return chunkK2ROKOK3_cjs.isNodeType; }
 });
 Object.defineProperty(exports, "CardinalityError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.CardinalityError; }
+  get: function () { return chunk44SXEVF4_cjs.CardinalityError; }
 });
 Object.defineProperty(exports, "CompilerInvariantError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.CompilerInvariantError; }
+  get: function () { return chunk44SXEVF4_cjs.CompilerInvariantError; }
 });
 Object.defineProperty(exports, "ConfigurationError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.ConfigurationError; }
+  get: function () { return chunk44SXEVF4_cjs.ConfigurationError; }
 });
 Object.defineProperty(exports, "DatabaseOperationError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.DatabaseOperationError; }
+  get: function () { return chunk44SXEVF4_cjs.DatabaseOperationError; }
 });
 Object.defineProperty(exports, "DisjointError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.DisjointError; }
+  get: function () { return chunk44SXEVF4_cjs.DisjointError; }
 });
 Object.defineProperty(exports, "EdgeNotFoundError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.EdgeNotFoundError; }
+  get: function () { return chunk44SXEVF4_cjs.EdgeNotFoundError; }
 });
 Object.defineProperty(exports, "EndpointError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.EndpointError; }
+  get: function () { return chunk44SXEVF4_cjs.EndpointError; }
 });
 Object.defineProperty(exports, "EndpointNotFoundError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.EndpointNotFoundError; }
+  get: function () { return chunk44SXEVF4_cjs.EndpointNotFoundError; }
 });
 Object.defineProperty(exports, "KindNotFoundError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.KindNotFoundError; }
+  get: function () { return chunk44SXEVF4_cjs.KindNotFoundError; }
 });
 Object.defineProperty(exports, "MigrationError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.MigrationError; }
+  get: function () { return chunk44SXEVF4_cjs.MigrationError; }
+});
+Object.defineProperty(exports, "NodeConstraintNotFoundError", {
+  enumerable: true,
+  get: function () { return chunk44SXEVF4_cjs.NodeConstraintNotFoundError; }
 });
 Object.defineProperty(exports, "NodeNotFoundError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.NodeNotFoundError; }
+  get: function () { return chunk44SXEVF4_cjs.NodeNotFoundError; }
 });
 Object.defineProperty(exports, "RestrictedDeleteError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.RestrictedDeleteError; }
+  get: function () { return chunk44SXEVF4_cjs.RestrictedDeleteError; }
 });
 Object.defineProperty(exports, "SchemaMismatchError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.SchemaMismatchError; }
+  get: function () { return chunk44SXEVF4_cjs.SchemaMismatchError; }
 });
 Object.defineProperty(exports, "TypeGraphError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.TypeGraphError; }
+  get: function () { return chunk44SXEVF4_cjs.TypeGraphError; }
 });
 Object.defineProperty(exports, "UniquenessError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.UniquenessError; }
+  get: function () { return chunk44SXEVF4_cjs.UniquenessError; }
 });
 Object.defineProperty(exports, "UnsupportedPredicateError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.UnsupportedPredicateError; }
+  get: function () { return chunk44SXEVF4_cjs.UnsupportedPredicateError; }
 });
 Object.defineProperty(exports, "ValidationError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.ValidationError; }
+  get: function () { return chunk44SXEVF4_cjs.ValidationError; }
 });
 Object.defineProperty(exports, "VersionConflictError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.VersionConflictError; }
+  get: function () { return chunk44SXEVF4_cjs.VersionConflictError; }
 });
 Object.defineProperty(exports, "getErrorSuggestion", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.getErrorSuggestion; }
+  get: function () { return chunk44SXEVF4_cjs.getErrorSuggestion; }
 });
 Object.defineProperty(exports, "isConstraintError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.isConstraintError; }
+  get: function () { return chunk44SXEVF4_cjs.isConstraintError; }
 });
 Object.defineProperty(exports, "isSystemError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.isSystemError; }
+  get: function () { return chunk44SXEVF4_cjs.isSystemError; }
 });
 Object.defineProperty(exports, "isTypeGraphError", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.isTypeGraphError; }
+  get: function () { return chunk44SXEVF4_cjs.isTypeGraphError; }
 });
 Object.defineProperty(exports, "isUserRecoverable", {
   enumerable: true,
-  get: function () { return chunkOYL2SGBD_cjs.isUserRecoverable; }
+  get: function () { return chunk44SXEVF4_cjs.isUserRecoverable; }
 });
 Object.defineProperty(exports, "MAX_JSON_POINTER_DEPTH", {
   enumerable: true,