@nicia-ai/typegraph 0.4.0 → 0.6.0

package/dist/index.d.cts

@@ -1,16 +1,15 @@
 import { z } from 'zod';
-import { N as NodeType, E as EdgeType } from './types-DTJEu_-h.cjs';
-export { A as AnyEdgeType, d as Cardinality, C as Collation, D as DeleteBehavior, f as EdgeProps, b as EdgeRegistration, c as EdgeTypeWithEndpoints, e as EndpointExistence, G as GraphDefaults, g as NodeId, h as NodeProps, a as NodeRegistration, T as TemporalMode, i as UniqueConstraint, U as UniquenessScope, j as isEdgeType, k as isEdgeTypeWithEndpoints, l as isNodeType } from './types-DTJEu_-h.cjs';
-import { I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-BUy-pHKH.cjs';
-export { D as DEFAULT_SQL_SCHEMA, G as GraphBackend, j as MetaEdgeProperties, k as SqlSchema, l as SqlTableNames, T as TransactionBackend, m as createSqlSchema, n as isMetaEdge } from './types-BUy-pHKH.cjs';
-import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-DhoA5uRc.cjs';
-export { a as AggregateResult, b as CreateEdgeInput, c as CreateNodeInput, d as Edge, e as EdgeAccessor, f as EdgeCollection, g as EdgeGetOrCreateByEndpointsOptions, h as EdgeGetOrCreateByEndpointsResult, i as EmbeddingSchema, j as EmbeddingValue, k as ExecutableAggregateQuery, l as ExecutableQuery, F as FieldAccessor, G as GetOrCreateAction, H as HookContext, I as IfExistsMode, N as Node, m as NodeAccessor, n as NodeAlias, o as NodeCollection, p as NodeGetOrCreateByConstraintOptions, q as NodeGetOrCreateByConstraintResult, r as NodeRef, O as OperationHookContext, P as PaginateOptions, s as PaginatedResult, t as Predicate, u as PreparedQuery, v as PropsAccessor, w as QueryHookContext, x as QueryOptions, R as RecursiveTraversalOptions, y as SelectContext, z as SelectableEdge, B as SelectableNode, S as Store, D as StoreHooks, J as StoreOptions, K as StreamOptions, L as TransactionContext, M as TypedEdgeCollection, U as TypedNodeRef, V as UnionableQuery, W as UpdateEdgeInput, X as UpdateNodeInput, Y as createStore, Z as createStoreWithSchema, _ as embedding, $ as exists, a0 as fieldRef, a1 as getEmbeddingDimensions, a2 as inSubquery, a3 as isEmbeddingSchema, a4 as isParameterRef, a5 as notExists, a6 as notInSubquery, a7 as param } from './store-DhoA5uRc.cjs';
-import { G as GraphDef, K as KindRegistry } from './manager-0NysX4s6.cjs';
-export { A as AllEdgeTypes, l as AllNodeTypes, n as EdgeKinds, o as GetEdgeType, p as GetNodeType, q as NodeKinds, s as defineGraph, t as getEdgeKinds, u as getNodeKinds, v as isGraphDef } from './manager-0NysX4s6.cjs';
-export { C as CardinalityError, b as CompilerInvariantError, c as ConfigurationError, D as DatabaseOperationError, d as DisjointError, E as EdgeNotFoundError, e as EndpointError, f as EndpointNotFoundError, g as ErrorCategory, K as KindNotFoundError, M as MigrationError, N as NodeConstraintNotFoundError, h as NodeNotFoundError, R as RestrictedDeleteError, S as SchemaMismatchError, T as TypeGraphError, i as TypeGraphErrorOptions, U as UniquenessError, j as UnsupportedPredicateError, a as ValidationError, k as ValidationErrorDetails, V as ValidationIssue, l as VersionConflictError, m as getErrorSuggestion, n as isConstraintError, o as isSystemError, p as isTypeGraphError, q as isUserRecoverable } from './index-DyrR_d-H.cjs';
-import { A as AggregateExpr, F as FieldRef, C as ComparisonOp, c as AggregateComparisonPredicate } from './ast-D-3bOanX.cjs';
-export { J as JsonPointer, a as JsonPointerFor, d as JsonPointerInput, e as JsonPointerSegment, f as JsonPointerSegments, b as JsonPointerSegmentsFor, M as MAX_JSON_POINTER_DEPTH, O as OrderSpec, P as ParameterRef, R as ResolveJsonPointer, g as ResolveJsonPointerSegments, S as SortDirection, T as TraversalExpansion, j as joinJsonPointers, h as jsonPointer, n as normalizeJsonPointer, p as parseJsonPointer } from './ast-D-3bOanX.cjs';
-export { S as SqlDialect } from './types-BRzHlhKC.cjs';
+import { N as NodeType, E as EdgeType } from './types-DolHw9pJ.cjs';
+export { A as AnyEdgeType, C as Cardinality, a as Collation, D as DeleteBehavior, b as EdgeProps, c as EdgeRegistration, d as EdgeTypeWithEndpoints, e as EndpointExistence, G as GraphDefaults, f as NodeId, g as NodeProps, h as NodeRegistration, S as SqlDialect, T as TemporalMode, U as UniqueConstraint, i as UniquenessScope, j as isEdgeType, k as isEdgeTypeWithEndpoints, l as isNodeType } from './types-DolHw9pJ.cjs';
+import { I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-SVDEKnU6.cjs';
+export { D as DEFAULT_SQL_SCHEMA, G as GraphBackend, a as MetaEdgeProperties, S as SqlSchema, b as SqlTableNames, T as TransactionBackend, c as createSqlSchema, i as isMetaEdge } from './types-SVDEKnU6.cjs';
+import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-DNv1yd3n.cjs';
+export { a as AggregateResult, b as CreateEdgeInput, c as CreateNodeInput, d as Edge, e as EdgeAccessor, f as EdgeCollection, g as EdgeFindByEndpointsOptions, h as EdgeGetOrCreateByEndpointsOptions, i as EdgeGetOrCreateByEndpointsResult, j as EmbeddingSchema, k as EmbeddingValue, l as ExecutableAggregateQuery, m as ExecutableQuery, F as FieldAccessor, G as GetOrCreateAction, H as HookContext, I as IfExistsMode, N as Node, n as NodeAccessor, o as NodeAlias, p as NodeCollection, q as NodeGetOrCreateByConstraintOptions, r as NodeGetOrCreateByConstraintResult, s as NodeRef, O as OperationHookContext, P as PaginateOptions, t as PaginatedResult, u as Predicate, v as PreparedQuery, w as PropsAccessor, x as QueryHookContext, y as QueryOptions, R as RecursiveTraversalOptions, S as SelectContext, z as SelectableEdge, B as SelectableNode, D as Store, J as StoreHooks, K as StoreOptions, L as StreamOptions, M as TransactionContext, U as TypedEdgeCollection, V as TypedNodeRef, W as UnionableQuery, X as UpdateEdgeInput, Y as UpdateNodeInput, Z as createStore, _ as createStoreWithSchema, $ as embedding, a0 as exists, a1 as fieldRef, a2 as getEmbeddingDimensions, a3 as inSubquery, a4 as isEmbeddingSchema, a5 as isParameterRef, a6 as notExists, a7 as notInSubquery, a8 as param } from './store-DNv1yd3n.cjs';
+import { G as GraphDef, K as KindRegistry } from './manager-BImRiYwz.cjs';
+export { A as AllEdgeTypes, a as AllNodeTypes, E as EdgeKinds, b as GetEdgeType, c as GetNodeType, N as NodeKinds, d as defineGraph, g as getEdgeKinds, e as getNodeKinds, i as isGraphDef } from './manager-BImRiYwz.cjs';
+export { C as CardinalityError, a as CompilerInvariantError, b as ConfigurationError, D as DatabaseOperationError, c as DisjointError, E as EdgeNotFoundError, d as EndpointError, e as EndpointNotFoundError, f as ErrorCategory, K as KindNotFoundError, M as MigrationError, N as NodeConstraintNotFoundError, g as NodeNotFoundError, R as RestrictedDeleteError, S as SchemaMismatchError, T as TypeGraphError, h as TypeGraphErrorOptions, U as UniquenessError, i as UnsupportedPredicateError, V as ValidationError, j as ValidationErrorDetails, k as ValidationIssue, l as VersionConflictError, m as getErrorSuggestion, n as isConstraintError, o as isSystemError, p as isTypeGraphError, q as isUserRecoverable } from './index-QTnQwakS.cjs';
+import { A as AggregateExpr, F as FieldRef, C as ComparisonOp, a as AggregateComparisonPredicate } from './ast-Cq9qrnNP.cjs';
+export { J as JsonPointer, b as JsonPointerFor, c as JsonPointerInput, d as JsonPointerSegment, e as JsonPointerSegments, f as JsonPointerSegmentsFor, M as MAX_JSON_POINTER_DEPTH, O as OrderSpec, P as ParameterRef, R as ResolveJsonPointer, g as ResolveJsonPointerSegments, S as SortDirection, T as TraversalExpansion, j as joinJsonPointers, h as jsonPointer, n as normalizeJsonPointer, p as parseJsonPointer } from './ast-Cq9qrnNP.cjs';
 import 'drizzle-orm';
 
 /**

package/dist/index.d.ts

@@ -1,16 +1,15 @@
 import { z } from 'zod';
-import { N as NodeType, E as EdgeType } from './types-DTJEu_-h.js';
-export { A as AnyEdgeType, d as Cardinality, C as Collation, D as DeleteBehavior, f as EdgeProps, b as EdgeRegistration, c as EdgeTypeWithEndpoints, e as EndpointExistence, G as GraphDefaults, g as NodeId, h as NodeProps, a as NodeRegistration, T as TemporalMode, i as UniqueConstraint, U as UniquenessScope, j as isEdgeType, k as isEdgeTypeWithEndpoints, l as isNodeType } from './types-DTJEu_-h.js';
-import { I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-6EKrWTs9.js';
-export { D as DEFAULT_SQL_SCHEMA, G as GraphBackend, j as MetaEdgeProperties, k as SqlSchema, l as SqlTableNames, T as TransactionBackend, m as createSqlSchema, n as isMetaEdge } from './types-6EKrWTs9.js';
-import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-SiovWEYA.js';
-export { a as AggregateResult, b as CreateEdgeInput, c as CreateNodeInput, d as Edge, e as EdgeAccessor, f as EdgeCollection, g as EdgeGetOrCreateByEndpointsOptions, h as EdgeGetOrCreateByEndpointsResult, i as EmbeddingSchema, j as EmbeddingValue, k as ExecutableAggregateQuery, l as ExecutableQuery, F as FieldAccessor, G as GetOrCreateAction, H as HookContext, I as IfExistsMode, N as Node, m as NodeAccessor, n as NodeAlias, o as NodeCollection, p as NodeGetOrCreateByConstraintOptions, q as NodeGetOrCreateByConstraintResult, r as NodeRef, O as OperationHookContext, P as PaginateOptions, s as PaginatedResult, t as Predicate, u as PreparedQuery, v as PropsAccessor, w as QueryHookContext, x as QueryOptions, R as RecursiveTraversalOptions, y as SelectContext, z as SelectableEdge, B as SelectableNode, S as Store, D as StoreHooks, J as StoreOptions, K as StreamOptions, L as TransactionContext, M as TypedEdgeCollection, U as TypedNodeRef, V as UnionableQuery, W as UpdateEdgeInput, X as UpdateNodeInput, Y as createStore, Z as createStoreWithSchema, _ as embedding, $ as exists, a0 as fieldRef, a1 as getEmbeddingDimensions, a2 as inSubquery, a3 as isEmbeddingSchema, a4 as isParameterRef, a5 as notExists, a6 as notInSubquery, a7 as param } from './store-SiovWEYA.js';
-import { G as GraphDef, K as KindRegistry } from './manager-DFKe7ql3.js';
-export { A as AllEdgeTypes, l as AllNodeTypes, n as EdgeKinds, o as GetEdgeType, p as GetNodeType, q as NodeKinds, s as defineGraph, t as getEdgeKinds, u as getNodeKinds, v as isGraphDef } from './manager-DFKe7ql3.js';
-export { C as CardinalityError, b as CompilerInvariantError, c as ConfigurationError, D as DatabaseOperationError, d as DisjointError, E as EdgeNotFoundError, e as EndpointError, f as EndpointNotFoundError, g as ErrorCategory, K as KindNotFoundError, M as MigrationError, N as NodeConstraintNotFoundError, h as NodeNotFoundError, R as RestrictedDeleteError, S as SchemaMismatchError, T as TypeGraphError, i as TypeGraphErrorOptions, U as UniquenessError, j as UnsupportedPredicateError, a as ValidationError, k as ValidationErrorDetails, V as ValidationIssue, l as VersionConflictError, m as getErrorSuggestion, n as isConstraintError, o as isSystemError, p as isTypeGraphError, q as isUserRecoverable } from './index-DyrR_d-H.js';
-import { A as AggregateExpr, F as FieldRef, C as ComparisonOp, c as AggregateComparisonPredicate } from './ast-CXFx6bF6.js';
-export { J as JsonPointer, a as JsonPointerFor, d as JsonPointerInput, e as JsonPointerSegment, f as JsonPointerSegments, b as JsonPointerSegmentsFor, M as MAX_JSON_POINTER_DEPTH, O as OrderSpec, P as ParameterRef, R as ResolveJsonPointer, g as ResolveJsonPointerSegments, S as SortDirection, T as TraversalExpansion, j as joinJsonPointers, h as jsonPointer, n as normalizeJsonPointer, p as parseJsonPointer } from './ast-CXFx6bF6.js';
-export { S as SqlDialect } from './types-BRzHlhKC.js';
+import { N as NodeType, E as EdgeType } from './types-DolHw9pJ.js';
+export { A as AnyEdgeType, C as Cardinality, a as Collation, D as DeleteBehavior, b as EdgeProps, c as EdgeRegistration, d as EdgeTypeWithEndpoints, e as EndpointExistence, G as GraphDefaults, f as NodeId, g as NodeProps, h as NodeRegistration, S as SqlDialect, T as TemporalMode, U as UniqueConstraint, i as UniquenessScope, j as isEdgeType, k as isEdgeTypeWithEndpoints, l as isNodeType } from './types-DolHw9pJ.js';
+import { I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-D5ggX07j.js';
+export { D as DEFAULT_SQL_SCHEMA, G as GraphBackend, a as MetaEdgeProperties, S as SqlSchema, b as SqlTableNames, T as TransactionBackend, c as createSqlSchema, i as isMetaEdge } from './types-D5ggX07j.js';
+import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-CscQUG-S.js';
+export { a as AggregateResult, b as CreateEdgeInput, c as CreateNodeInput, d as Edge, e as EdgeAccessor, f as EdgeCollection, g as EdgeFindByEndpointsOptions, h as EdgeGetOrCreateByEndpointsOptions, i as EdgeGetOrCreateByEndpointsResult, j as EmbeddingSchema, k as EmbeddingValue, l as ExecutableAggregateQuery, m as ExecutableQuery, F as FieldAccessor, G as GetOrCreateAction, H as HookContext, I as IfExistsMode, N as Node, n as NodeAccessor, o as NodeAlias, p as NodeCollection, q as NodeGetOrCreateByConstraintOptions, r as NodeGetOrCreateByConstraintResult, s as NodeRef, O as OperationHookContext, P as PaginateOptions, t as PaginatedResult, u as Predicate, v as PreparedQuery, w as PropsAccessor, x as QueryHookContext, y as QueryOptions, R as RecursiveTraversalOptions, S as SelectContext, z as SelectableEdge, B as SelectableNode, D as Store, J as StoreHooks, K as StoreOptions, L as StreamOptions, M as TransactionContext, U as TypedEdgeCollection, V as TypedNodeRef, W as UnionableQuery, X as UpdateEdgeInput, Y as UpdateNodeInput, Z as createStore, _ as createStoreWithSchema, $ as embedding, a0 as exists, a1 as fieldRef, a2 as getEmbeddingDimensions, a3 as inSubquery, a4 as isEmbeddingSchema, a5 as isParameterRef, a6 as notExists, a7 as notInSubquery, a8 as param } from './store-CscQUG-S.js';
+import { G as GraphDef, K as KindRegistry } from './manager-DGQ9UF18.js';
+export { A as AllEdgeTypes, a as AllNodeTypes, E as EdgeKinds, b as GetEdgeType, c as GetNodeType, N as NodeKinds, d as defineGraph, g as getEdgeKinds, e as getNodeKinds, i as isGraphDef } from './manager-DGQ9UF18.js';
+export { C as CardinalityError, a as CompilerInvariantError, b as ConfigurationError, D as DatabaseOperationError, c as DisjointError, E as EdgeNotFoundError, d as EndpointError, e as EndpointNotFoundError, f as ErrorCategory, K as KindNotFoundError, M as MigrationError, N as NodeConstraintNotFoundError, g as NodeNotFoundError, R as RestrictedDeleteError, S as SchemaMismatchError, T as TypeGraphError, h as TypeGraphErrorOptions, U as UniquenessError, i as UnsupportedPredicateError, V as ValidationError, j as ValidationErrorDetails, k as ValidationIssue, l as VersionConflictError, m as getErrorSuggestion, n as isConstraintError, o as isSystemError, p as isTypeGraphError, q as isUserRecoverable } from './index-QTnQwakS.js';
+import { A as AggregateExpr, F as FieldRef, C as ComparisonOp, a as AggregateComparisonPredicate } from './ast-CG87Zr6p.js';
+export { J as JsonPointer, b as JsonPointerFor, c as JsonPointerInput, d as JsonPointerSegment, e as JsonPointerSegments, f as JsonPointerSegmentsFor, M as MAX_JSON_POINTER_DEPTH, O as OrderSpec, P as ParameterRef, R as ResolveJsonPointer, g as ResolveJsonPointerSegments, S as SortDirection, T as TraversalExpansion, j as joinJsonPointers, h as jsonPointer, n as normalizeJsonPointer, p as parseJsonPointer } from './ast-CG87Zr6p.js';
 import 'drizzle-orm';
 
 /**

package/dist/index.js

@@ -8549,6 +8549,23 @@ function createEdgeCollection(config) {
       }
       await deleteAll(backend);
     },
+    async findByEndpoints(from, to, options) {
+      const findOptions = {};
+      if (options?.matchOn !== void 0)
+        findOptions.matchOn = options.matchOn;
+      if (options?.props !== void 0)
+        findOptions.props = options.props;
+      const result = await config.executeFindByEndpoints(
+        kind,
+        from.kind,
+        from.id,
+        to.kind,
+        to.id,
+        backend,
+        findOptions
+      );
+      return result === void 0 ? void 0 : narrowEdge(result);
+    },
     async getOrCreateByEndpoints(from, to, props, options) {
       const getOrCreateOptions = {};
       if (options?.matchOn !== void 0)
@@ -8639,7 +8656,9 @@ function createNodeCollection(config) {
     matchesTemporalMode,
     createQuery,
     executeGetOrCreateByConstraint,
-    executeBulkGetOrCreateByConstraint
+    executeBulkGetOrCreateByConstraint,
+    executeFindByConstraint,
+    executeBulkFindByConstraint
   } = config;
   return {
     async create(props, options) {
@@ -8888,6 +8907,30 @@ function createNodeCollection(config) {
       }
       await deleteAll(backend);
     },
+    async findByConstraint(constraintName, props) {
+      const result = await executeFindByConstraint(
+        kind,
+        constraintName,
+        props,
+        backend
+      );
+      return result === void 0 ? void 0 : narrowNode(result);
+    },
+    async bulkFindByConstraint(constraintName, items) {
+      if (items.length === 0) return [];
+      const mappedItems = items.map((item) => ({
+        props: item.props
+      }));
+      const results = await executeBulkFindByConstraint(
+        kind,
+        constraintName,
+        mappedItems,
+        backend
+      );
+      return results.map(
+        (result) => result === void 0 ? void 0 : narrowNode(result)
+      );
+    },
     async getOrCreateByConstraint(constraintName, props, options) {
       const execute = async (target) => {
         const result = await executeGetOrCreateByConstraint(
@@ -9748,6 +9791,28 @@ function findMatchingEdge(rows, matchOn, inputProps) {
   }
   return { liveRow, deletedRow };
 }
+async function executeEdgeFindByEndpoints(ctx, kind, fromKind, fromId, toKind, toId, backend, options) {
+  const matchOn = options?.matchOn ?? [];
+  const props = options?.props ?? {};
+  const registration = getEdgeRegistration(ctx.graph, kind);
+  const edgeKind = registration.type;
+  if (matchOn.length > 0) {
+    validateMatchOnFields(edgeKind.schema, matchOn, kind);
+  }
+  const candidateRows = await backend.findEdgesByKind({
+    graphId: ctx.graphId,
+    kind,
+    fromKind,
+    fromId,
+    toKind,
+    toId,
+    excludeDeleted: true
+  });
+  if (candidateRows.length === 0) return void 0;
+  if (matchOn.length === 0) return rowToEdge(candidateRows[0]);
+  const { liveRow } = findMatchingEdge(candidateRows, matchOn, props);
+  return liveRow === void 0 ? void 0 : rowToEdge(liveRow);
+}
 async function executeEdgeGetOrCreateByEndpoints(ctx, kind, fromKind, fromId, toKind, toId, props, backend, options) {
   const ifExists = options?.ifExists ?? "return";
   const matchOn = options?.matchOn ?? [];
@@ -10846,6 +10911,142 @@ async function executeNodeGetOrCreateByConstraint(ctx, kind, constraintName, pro
   }
   return { node: rowToNode(existingRow), action: "found" };
 }
+async function executeNodeFindByConstraint(ctx, kind, constraintName, props, backend) {
+  const registration = getNodeRegistration(ctx.graph, kind);
+  const nodeKind = registration.type;
+  const validatedProps = validateNodeProps(nodeKind.schema, props, {
+    kind,
+    operation: "create"
+  });
+  const constraint = resolveConstraint(ctx.graph, kind, constraintName);
+  if (!checkWherePredicate(constraint, validatedProps)) return void 0;
+  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: false
+    });
+    if (row !== void 0) {
+      existingUniqueRow = row;
+      break;
+    }
+  }
+  if (existingUniqueRow === void 0) return void 0;
+  const existingRow = await backend.getNode(
+    ctx.graphId,
+    existingUniqueRow.concrete_kind,
+    existingUniqueRow.node_id
+  );
+  if (existingRow === void 0 || existingRow.deleted_at !== void 0)
+    return void 0;
+  return rowToNode(existingRow);
+}
+async function executeNodeBulkFindByConstraint(ctx, kind, constraintName, items, backend) {
+  if (items.length === 0) 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 = 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: false
+          });
+          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: false
+        });
+        for (const row of rows) {
+          if (!existingByKey.has(row.key)) {
+            existingByKey.set(row.key, row);
+          }
+        }
+      }
+    }
+  }
+  const results = Array.from({ length: items.length });
+  const seenKeys = /* @__PURE__ */ new Map();
+  for (const [index, { key }] of validated.entries()) {
+    if (key === void 0) {
+      results[index] = void 0;
+      continue;
+    }
+    const previousIndex = seenKeys.get(key);
+    if (previousIndex !== void 0) {
+      results[index] = results[previousIndex];
+      continue;
+    }
+    seenKeys.set(key, index);
+    const existing = existingByKey.get(key);
+    if (existing === void 0) {
+      results[index] = void 0;
+      continue;
+    }
+    const existingRow = await backend.getNode(
+      ctx.graphId,
+      existing.concrete_kind,
+      existing.node_id
+    );
+    if (existingRow === void 0 || existingRow.deleted_at !== void 0) {
+      results[index] = void 0;
+      continue;
+    }
+    results[index] = rowToNode(existingRow);
+  }
+  return results;
+}
 async function executeNodeBulkGetOrCreateByConstraint(ctx, kind, constraintName, items, backend, options) {
   if (items.length === 0) return [];
   const ifExists = options?.ifExists ?? "return";
@@ -11125,6 +11326,14 @@ var Store = class {
         items,
         backend,
         options
+      ),
+      executeFindByConstraint: (kind, constraintName, props, backend) => executeNodeFindByConstraint(ctx, kind, constraintName, props, backend),
+      executeBulkFindByConstraint: (kind, constraintName, items, backend) => executeNodeBulkFindByConstraint(
+        ctx,
+        kind,
+        constraintName,
+        items,
+        backend
       )
     };
   }
@@ -11162,6 +11371,16 @@ var Store = class {
         items,
         backend,
         options
+      ),
+      executeFindByEndpoints: (kind, fromKind, fromId, toKind, toId, backend, options) => executeEdgeFindByEndpoints(
+        ctx,
+        kind,
+        fromKind,
+        fromId,
+        toKind,
+        toId,
+        backend,
+        options
       )
     };
   }
@@ -11229,6 +11448,24 @@ var Store = class {
       return fn({ nodes, edges });
     });
   }
+  // === Graph Lifecycle ===
+  /**
+   * Hard-deletes all data for this graph from the database.
+   *
+   * Removes all nodes, edges, uniqueness entries, embeddings, and schema versions
+   * for this graph's ID. No hooks, no per-row logic. Wrapped in a transaction
+   * when the backend supports it.
+   *
+   * The store is usable after clearing — new data can be created immediately.
+   */
+  async clear() {
+    const doClear = async (target) => {
+      await target.clearGraph(this.graphId);
+    };
+    await (this.#backend.capabilities.transactions ? this.#backend.transaction(async (tx) => doClear(tx)) : doClear(this.#backend));
+    this.#nodeCollections = void 0;
+    this.#edgeCollections = void 0;
+  }
   // === Lifecycle ===
   /**
    * Closes the store and releases underlying resources.