@nicia-ai/typegraph 0.6.0 → 0.7.0

package/dist/{store-DNv1yd3n.d.cts → store-CL-QMus7.d.cts}

@@ -1,7 +1,7 @@
-import { S as SqlSchema, G as GraphBackend } from './types-SVDEKnU6.cjs';
-import { K as KindRegistry, G as GraphDef, S as SchemaManagerOptions, f as SchemaValidationResult } from './manager-BImRiYwz.cjs';
-import { S as SqlDialect, N as NodeType, A as AnyEdgeType, T as TemporalMode, E as EdgeType, c as EdgeRegistration, f as NodeId } from './types-DolHw9pJ.cjs';
-import { V as ValueType, i as PredicateExpression, k as VectorMetricType, Q as QueryAst, J as JsonPointer, F as FieldRef, P as ParameterRef, c as JsonPointerInput, T as TraversalExpansion, l as Traversal, N as NodePredicate, m as ProjectedField, O as OrderSpec, G as GroupBySpec, o as RecursiveCyclePolicy, q as TraversalDirection, A as AggregateExpr, r as SelectiveField, s as ComposableQuery, t as SetOperationType, u as SetOperation, S as SortDirection } from './ast-Cq9qrnNP.cjs';
+import { S as SqlSchema, G as GraphBackend } from './types-GLkwvQvS.cjs';
+import { K as KindRegistry, G as GraphDef, S as SchemaManagerOptions, f as SchemaValidationResult } from './manager-Cu3JQN0H.cjs';
+import { S as SqlDialect, N as NodeType, A as AnyEdgeType, T as TemporalMode, E as EdgeType, d as EdgeRegistration, i as NodeRegistration, b as EdgeId, g as NodeId } from './types-DMzKq0d5.cjs';
+import { V as ValueType, i as PredicateExpression, k as VectorMetricType, Q as QueryAst, J as JsonPointer, F as FieldRef, P as ParameterRef, c as JsonPointerInput, T as TraversalExpansion, l as Traversal, N as NodePredicate, m as ProjectedField, O as OrderSpec, G as GroupBySpec, o as RecursiveCyclePolicy, q as TraversalDirection, A as AggregateExpr, r as SelectiveField, s as ComposableQuery, t as SetOperationType, u as SetOperation, S as SortDirection } from './ast-Bh2NDeaK.cjs';
 import { SQL } from 'drizzle-orm';
 import { z } from 'zod';
 
@@ -647,13 +647,13 @@ type EdgeMeta = Readonly<{
  * - `edge.role` instead of `edge.props.role`
  * - System metadata is under `edge.meta.*`
  */
-type Edge<E extends AnyEdgeType = EdgeType> = Readonly<{
-    id: string;
+type Edge<E extends AnyEdgeType = EdgeType, From extends NodeType = NodeType, To extends NodeType = NodeType> = Readonly<{
+    id: EdgeId<E>;
     kind: E["kind"];
-    fromKind: string;
-    fromId: string;
-    toKind: string;
-    toId: string;
+    fromKind: From["kind"];
+    fromId: NodeId<From>;
+    toKind: To["kind"];
+    toId: NodeId<To>;
     meta: EdgeMeta;
 }> & Readonly<z.infer<E["schema"]>>;
 /**
@@ -674,7 +674,7 @@ type CreateEdgeInput<E extends AnyEdgeType = EdgeType> = Readonly<{
  * Input for updating an edge.
  */
 type UpdateEdgeInput<E extends AnyEdgeType = EdgeType> = Readonly<{
-    id: string;
+    id: EdgeId<E>;
     props: Partial<z.infer<E["schema"]>>;
     validTo?: string;
 }>;
@@ -800,8 +800,8 @@ type NodeGetOrCreateByConstraintOptions = Readonly<{
 /**
  * Result of an edge getOrCreateByEndpoints operation.
  */
-type EdgeGetOrCreateByEndpointsResult<E extends AnyEdgeType> = Readonly<{
-    edge: Edge<E>;
+type EdgeGetOrCreateByEndpointsResult<E extends AnyEdgeType, From extends NodeType = NodeType, To extends NodeType = NodeType> = Readonly<{
+    edge: Edge<E, From, To>;
     action: GetOrCreateAction;
 }>;
 /**
@@ -833,7 +833,7 @@ type EdgeGetOrCreateByEndpointsOptions<E extends AnyEdgeType> = Readonly<{
  *
  * Provides ergonomic CRUD operations for a single node type.
  */
-type NodeCollection<N extends NodeType> = Readonly<{
+type NodeCollection<N extends NodeType, CN extends string = string> = Readonly<{
     /** Create a new node */
     create: (props: z.input<N["schema"]>, options?: Readonly<{
         id?: string;
@@ -940,14 +940,14 @@ type NodeCollection<N extends NodeType> = Readonly<{
      * @param constraintName - Name of the uniqueness constraint to match on
      * @param props - Properties to compute the constraint key from
      */
-    findByConstraint: (constraintName: string, props: z.input<N["schema"]>) => Promise<Node<N> | undefined>;
+    findByConstraint: (constraintName: CN, props: z.input<N["schema"]>) => Promise<Node<N> | undefined>;
     /**
      * Batch version of findByConstraint.
      *
      * Results are returned in the same order as the input items.
      * Returns undefined for entries that don't match.
      */
-    bulkFindByConstraint: (constraintName: string, items: readonly Readonly<{
+    bulkFindByConstraint: (constraintName: CN, items: readonly Readonly<{
         props: z.input<N["schema"]>;
     }>[]) => Promise<(Node<N> | undefined)[]>;
     /**
@@ -961,28 +961,19 @@ type NodeCollection<N extends NodeType> = Readonly<{
      * @param props - Full properties for create, or merge source for update
      * @param options - Existing record behavior (default: "return")
      */
-    getOrCreateByConstraint: (constraintName: string, props: z.input<N["schema"]>, options?: NodeGetOrCreateByConstraintOptions) => Promise<NodeGetOrCreateByConstraintResult<N>>;
+    getOrCreateByConstraint: (constraintName: CN, props: z.input<N["schema"]>, options?: NodeGetOrCreateByConstraintOptions) => Promise<NodeGetOrCreateByConstraintResult<N>>;
     /**
      * Batch version of getOrCreateByConstraint.
      *
      * Results are returned in the same order as the input items.
      * Atomic when the backend supports transactions.
      */
-    bulkGetOrCreateByConstraint: (constraintName: string, items: readonly Readonly<{
+    bulkGetOrCreateByConstraint: (constraintName: CN, items: readonly Readonly<{
         props: z.input<N["schema"]>;
     }>[], options?: NodeGetOrCreateByConstraintOptions) => Promise<NodeGetOrCreateByConstraintResult<N>[]>;
 }>;
 /**
- * Reference to a node endpoint (kind and id).
- *
- * Can be either an explicit `{ kind, id }` object or a Node instance.
- */
-type NodeRef = Readonly<{
-    kind: string;
-    id: string;
-}>;
-/**
- * Type-safe reference to a node of a specific kind.
+ * Reference to a node of a specific kind.
  *
  * Accepts either:
  * - A Node instance of the correct kind
@@ -991,7 +982,7 @@ type NodeRef = Readonly<{
  * This provides compile-time checking that edge endpoints match the
  * allowed node kinds defined in the edge registration.
  */
-type TypedNodeRef<N extends NodeType> = Node<N> | Readonly<{
+type NodeRef<N extends NodeType = NodeType> = Node<N> | Readonly<{
     kind: N["kind"];
     id: string;
 }>;
@@ -1042,21 +1033,21 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * @param to - Target node (must be one of the allowed 'to' types)
      * @param args - Edge properties (optional if schema is empty) and creation options
      */
-    create: (from: TypedNodeRef<From>, to: TypedNodeRef<To>, ...args: EdgeCreateArguments<E>) => Promise<Edge<E>>;
+    create: (from: NodeRef<From>, to: NodeRef<To>, ...args: EdgeCreateArguments<E>) => Promise<Edge<E, From, To>>;
     /** Get an edge by ID */
-    getById: (id: string, options?: QueryOptions) => Promise<Edge<E> | undefined>;
+    getById: (id: EdgeId<E>, options?: QueryOptions) => Promise<Edge<E, From, To> | undefined>;
     /** Get multiple edges by ID, preserving input order (undefined for missing) */
-    getByIds: (ids: readonly string[], options?: QueryOptions) => Promise<readonly (Edge<E> | undefined)[]>;
+    getByIds: (ids: readonly EdgeId<E>[], options?: QueryOptions) => Promise<readonly (Edge<E, From, To> | undefined)[]>;
     /** Update an edge's properties */
-    update: (id: string, props: Partial<z.input<E["schema"]>>, options?: Readonly<{
+    update: (id: EdgeId<E>, props: Partial<z.input<E["schema"]>>, options?: Readonly<{
         validTo?: string;
-    }>) => Promise<Edge<E>>;
+    }>) => Promise<Edge<E, From, To>>;
     /** Find edges from a specific node */
-    findFrom: (from: TypedNodeRef<From>) => Promise<Edge<E>[]>;
+    findFrom: (from: NodeRef<From>) => Promise<Edge<E, From, To>[]>;
     /** Find edges to a specific node */
-    findTo: (to: TypedNodeRef<To>) => Promise<Edge<E>[]>;
+    findTo: (to: NodeRef<To>) => Promise<Edge<E, From, To>[]>;
     /** Delete an edge (soft delete - sets deletedAt timestamp) */
-    delete: (id: string) => Promise<void>;
+    delete: (id: EdgeId<E>) => Promise<void>;
     /**
      * Permanently delete an edge from the database.
      *
@@ -1066,20 +1057,20 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * **Warning:** This operation is irreversible and should be used carefully.
      * Consider using soft delete (`delete()`) for most use cases.
      */
-    hardDelete: (id: string) => Promise<void>;
+    hardDelete: (id: EdgeId<E>) => Promise<void>;
     /** Find edges matching endpoint and pagination criteria */
     find: (options?: Readonly<{
-        from?: TypedNodeRef<From>;
-        to?: TypedNodeRef<To>;
+        from?: NodeRef<From>;
+        to?: NodeRef<To>;
         limit?: number;
         offset?: number;
         temporalMode?: TemporalMode;
         asOf?: string;
-    }>) => Promise<Edge<E>[]>;
+    }>) => Promise<Edge<E, From, To>[]>;
     /** Count edges matching criteria */
     count: (options?: Readonly<{
-        from?: TypedNodeRef<From>;
-        to?: TypedNodeRef<To>;
+        from?: NodeRef<From>;
+        to?: NodeRef<To>;
         temporalMode?: TemporalMode;
         asOf?: string;
     }>) => Promise<number>;
@@ -1090,13 +1081,13 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * Use `bulkInsert` for the dedicated fast path that skips returning results.
      */
     bulkCreate: (items: readonly Readonly<{
-        from: TypedNodeRef<From>;
-        to: TypedNodeRef<To>;
+        from: NodeRef<From>;
+        to: NodeRef<To>;
         props?: z.input<E["schema"]>;
         id?: string;
         validFrom?: string;
         validTo?: string;
-    }>[]) => Promise<Edge<E>[]>;
+    }>[]) => Promise<Edge<E, From, To>[]>;
     /**
      * Create or update multiple edges in a batch.
      *
@@ -1104,13 +1095,13 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * Otherwise, creates a new edge with that ID.
      */
     bulkUpsertById: (items: readonly Readonly<{
-        id: string;
-        from: TypedNodeRef<From>;
-        to: TypedNodeRef<To>;
+        id: EdgeId<E>;
+        from: NodeRef<From>;
+        to: NodeRef<To>;
         props?: z.input<E["schema"]>;
         validFrom?: string;
         validTo?: string;
-    }>[]) => Promise<Edge<E>[]>;
+    }>[]) => Promise<Edge<E, From, To>[]>;
     /**
      * Insert multiple edges without returning results.
      *
@@ -1119,8 +1110,8 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * are returned and the operation is wrapped in a transaction.
      */
     bulkInsert: (items: readonly Readonly<{
-        from: TypedNodeRef<From>;
-        to: TypedNodeRef<To>;
+        from: NodeRef<From>;
+        to: NodeRef<To>;
         props?: z.input<E["schema"]>;
         id?: string;
         validFrom?: string;
@@ -1132,7 +1123,7 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * Atomic when the backend supports transactions. Silently ignores IDs
      * that don't exist.
      */
-    bulkDelete: (ids: readonly string[]) => Promise<void>;
+    bulkDelete: (ids: readonly EdgeId<E>[]) => Promise<void>;
     /**
      * Find a live edge by endpoints and optional property fields.
      *
@@ -1143,7 +1134,7 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * @param to - Target node
      * @param options - Match criteria (matchOn fields and property values)
      */
-    findByEndpoints: (from: TypedNodeRef<From>, to: TypedNodeRef<To>, options?: EdgeFindByEndpointsOptions<E>) => Promise<Edge<E> | undefined>;
+    findByEndpoints: (from: NodeRef<From>, to: NodeRef<To>, options?: EdgeFindByEndpointsOptions<E>) => Promise<Edge<E, From, To> | undefined>;
     /**
      * Get an existing edge by endpoints and optional property fields, or create a new one.
      *
@@ -1156,7 +1147,7 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * @param props - Full properties for create, or merge source for update
      * @param options - Match criteria and conflict resolution
      */
-    getOrCreateByEndpoints: (from: TypedNodeRef<From>, to: TypedNodeRef<To>, props: z.input<E["schema"]>, options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E>>;
+    getOrCreateByEndpoints: (from: NodeRef<From>, to: NodeRef<To>, props: z.input<E["schema"]>, options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>>;
     /**
      * Batch version of getOrCreateByEndpoints.
      *
@@ -1164,11 +1155,21 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * Atomic when the backend supports transactions.
      */
     bulkGetOrCreateByEndpoints: (items: readonly Readonly<{
-        from: TypedNodeRef<From>;
-        to: TypedNodeRef<To>;
+        from: NodeRef<From>;
+        to: NodeRef<To>;
         props: z.input<E["schema"]>;
-    }>[], options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E>[]>;
+    }>[], options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>[]>;
 }>;
+/**
+ * Extract uniqueness constraint names from a NodeRegistration.
+ *
+ * - Returns `never` when no uniqueness constraints are configured.
+ * - Returns a literal union when names are inferred via `defineGraph` const params.
+ * - Falls back to `string` when names are widened/dynamic.
+ */
+type ConstraintNames<R extends NodeRegistration> = "unique" extends keyof R ? R["unique"] extends readonly {
+    readonly name: infer N;
+}[] ? N & string : string : never;
 /**
  * Extract the union of 'from' node types from an EdgeRegistration.
  */
@@ -1201,7 +1202,7 @@ type TypedEdgeCollection<R extends EdgeRegistration> = EdgeCollection<R["type"],
 type TransactionContext<G extends GraphDef> = Readonly<{
     /** Node collections for the transaction */
     nodes: {
-        [K in keyof G["nodes"] & string]-?: NodeCollection<G["nodes"][K]["type"]>;
+        [K in keyof G["nodes"] & string]-?: NodeCollection<G["nodes"][K]["type"], ConstraintNames<G["nodes"][K]>>;
     };
     /** Edge collections for the transaction */
     edges: {
@@ -1819,7 +1820,7 @@ declare class Store<G extends GraphDef> {
      * ```
      */
     get nodes(): {
-        [K in keyof G["nodes"] & string]-?: NodeCollection<G["nodes"][K]["type"]>;
+        [K in keyof G["nodes"] & string]-?: NodeCollection<G["nodes"][K]["type"], ConstraintNames<G["nodes"][K]>>;
     };
     /**
      * Edge collections for ergonomic CRUD operations.
@@ -1954,4 +1955,4 @@ declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend
  */
 declare function createStoreWithSchema<G extends GraphDef>(graph: G, backend: GraphBackend, options?: StoreOptions & SchemaManagerOptions): Promise<[Store<G>, SchemaValidationResult]>;
 
-export { embedding as $, type AliasMap as A, type SelectableNode as B, type CreateQueryBuilderOptions as C, Store as D, type EdgeAliasMap as E, type FieldAccessor as F, type GetOrCreateAction as G, type HookContext as H, type IfExistsMode as I, type StoreHooks as J, type StoreOptions as K, type StreamOptions as L, type TransactionContext as M, type Node as N, type OperationHookContext as O, type PaginateOptions as P, QueryBuilder as Q, type RecursiveTraversalOptions as R, type SelectContext as S, TraversalBuilder as T, type TypedEdgeCollection as U, type TypedNodeRef as V, UnionableQuery as W, type UpdateEdgeInput as X, type UpdateNodeInput as Y, createStore as Z, createStoreWithSchema as _, type AggregateResult as a, exists as a0, fieldRef as a1, getEmbeddingDimensions as a2, inSubquery as a3, isEmbeddingSchema as a4, isParameterRef as a5, notExists as a6, notInSubquery as a7, param as a8, type CreateEdgeInput as b, type CreateNodeInput as c, type Edge as d, type EdgeAccessor as e, type EdgeCollection as f, type EdgeFindByEndpointsOptions as g, type EdgeGetOrCreateByEndpointsOptions as h, type EdgeGetOrCreateByEndpointsResult as i, type EmbeddingSchema as j, type EmbeddingValue as k, ExecutableAggregateQuery as l, ExecutableQuery as m, type NodeAccessor as n, type NodeAlias as o, type NodeCollection as p, type NodeGetOrCreateByConstraintOptions as q, type NodeGetOrCreateByConstraintResult as r, type NodeRef as s, type PaginatedResult as t, type Predicate as u, PreparedQuery as v, type PropsAccessor as w, type QueryHookContext as x, type QueryOptions as y, type SelectableEdge as z };
+export { embedding as $, type AliasMap as A, type SelectableEdge as B, type CreateQueryBuilderOptions as C, type SelectableNode as D, type EdgeAliasMap as E, type FieldAccessor as F, type GetOrCreateAction as G, type HookContext as H, type IfExistsMode as I, Store as J, type StoreHooks as K, type StoreOptions as L, type StreamOptions as M, type Node as N, type OperationHookContext as O, type PaginateOptions as P, QueryBuilder as Q, type RecursiveTraversalOptions as R, type SelectContext as S, TraversalBuilder as T, type TransactionContext as U, type TypedEdgeCollection as V, UnionableQuery as W, type UpdateEdgeInput as X, type UpdateNodeInput as Y, createStore as Z, createStoreWithSchema as _, type AggregateResult as a, exists as a0, fieldRef as a1, getEmbeddingDimensions as a2, inSubquery as a3, isEmbeddingSchema as a4, isParameterRef as a5, notExists as a6, notInSubquery as a7, param as a8, type ConstraintNames as b, type CreateEdgeInput as c, type CreateNodeInput as d, type Edge as e, type EdgeAccessor as f, type EdgeCollection as g, type EdgeFindByEndpointsOptions as h, type EdgeGetOrCreateByEndpointsOptions as i, type EdgeGetOrCreateByEndpointsResult as j, type EmbeddingSchema as k, type EmbeddingValue as l, ExecutableAggregateQuery as m, ExecutableQuery as n, type NodeAccessor as o, type NodeAlias as p, type NodeCollection as q, type NodeGetOrCreateByConstraintOptions as r, type NodeGetOrCreateByConstraintResult as s, type NodeRef as t, type PaginatedResult as u, type Predicate as v, PreparedQuery as w, type PropsAccessor as x, type QueryHookContext as y, type QueryOptions as z };

package/dist/{store-CscQUG-S.d.ts → store-DJpuUOSL.d.ts}

@@ -1,7 +1,7 @@
-import { S as SqlSchema, G as GraphBackend } from './types-D5ggX07j.js';
-import { K as KindRegistry, G as GraphDef, S as SchemaManagerOptions, f as SchemaValidationResult } from './manager-DGQ9UF18.js';
-import { S as SqlDialect, N as NodeType, A as AnyEdgeType, T as TemporalMode, E as EdgeType, c as EdgeRegistration, f as NodeId } from './types-DolHw9pJ.js';
-import { V as ValueType, i as PredicateExpression, k as VectorMetricType, Q as QueryAst, J as JsonPointer, F as FieldRef, P as ParameterRef, c as JsonPointerInput, T as TraversalExpansion, l as Traversal, N as NodePredicate, m as ProjectedField, O as OrderSpec, G as GroupBySpec, o as RecursiveCyclePolicy, q as TraversalDirection, A as AggregateExpr, r as SelectiveField, s as ComposableQuery, t as SetOperationType, u as SetOperation, S as SortDirection } from './ast-CG87Zr6p.js';
+import { S as SqlSchema, G as GraphBackend } from './types-1YJKodRv.js';
+import { K as KindRegistry, G as GraphDef, S as SchemaManagerOptions, f as SchemaValidationResult } from './manager-Ba2CXGMG.js';
+import { S as SqlDialect, N as NodeType, A as AnyEdgeType, T as TemporalMode, E as EdgeType, d as EdgeRegistration, i as NodeRegistration, b as EdgeId, g as NodeId } from './types-DMzKq0d5.js';
+import { V as ValueType, i as PredicateExpression, k as VectorMetricType, Q as QueryAst, J as JsonPointer, F as FieldRef, P as ParameterRef, c as JsonPointerInput, T as TraversalExpansion, l as Traversal, N as NodePredicate, m as ProjectedField, O as OrderSpec, G as GroupBySpec, o as RecursiveCyclePolicy, q as TraversalDirection, A as AggregateExpr, r as SelectiveField, s as ComposableQuery, t as SetOperationType, u as SetOperation, S as SortDirection } from './ast-COMyNeMn.js';
 import { SQL } from 'drizzle-orm';
 import { z } from 'zod';
 
@@ -647,13 +647,13 @@ type EdgeMeta = Readonly<{
  * - `edge.role` instead of `edge.props.role`
  * - System metadata is under `edge.meta.*`
  */
-type Edge<E extends AnyEdgeType = EdgeType> = Readonly<{
-    id: string;
+type Edge<E extends AnyEdgeType = EdgeType, From extends NodeType = NodeType, To extends NodeType = NodeType> = Readonly<{
+    id: EdgeId<E>;
     kind: E["kind"];
-    fromKind: string;
-    fromId: string;
-    toKind: string;
-    toId: string;
+    fromKind: From["kind"];
+    fromId: NodeId<From>;
+    toKind: To["kind"];
+    toId: NodeId<To>;
     meta: EdgeMeta;
 }> & Readonly<z.infer<E["schema"]>>;
 /**
@@ -674,7 +674,7 @@ type CreateEdgeInput<E extends AnyEdgeType = EdgeType> = Readonly<{
  * Input for updating an edge.
  */
 type UpdateEdgeInput<E extends AnyEdgeType = EdgeType> = Readonly<{
-    id: string;
+    id: EdgeId<E>;
     props: Partial<z.infer<E["schema"]>>;
     validTo?: string;
 }>;
@@ -800,8 +800,8 @@ type NodeGetOrCreateByConstraintOptions = Readonly<{
 /**
  * Result of an edge getOrCreateByEndpoints operation.
  */
-type EdgeGetOrCreateByEndpointsResult<E extends AnyEdgeType> = Readonly<{
-    edge: Edge<E>;
+type EdgeGetOrCreateByEndpointsResult<E extends AnyEdgeType, From extends NodeType = NodeType, To extends NodeType = NodeType> = Readonly<{
+    edge: Edge<E, From, To>;
     action: GetOrCreateAction;
 }>;
 /**
@@ -833,7 +833,7 @@ type EdgeGetOrCreateByEndpointsOptions<E extends AnyEdgeType> = Readonly<{
  *
  * Provides ergonomic CRUD operations for a single node type.
  */
-type NodeCollection<N extends NodeType> = Readonly<{
+type NodeCollection<N extends NodeType, CN extends string = string> = Readonly<{
     /** Create a new node */
     create: (props: z.input<N["schema"]>, options?: Readonly<{
         id?: string;
@@ -940,14 +940,14 @@ type NodeCollection<N extends NodeType> = Readonly<{
      * @param constraintName - Name of the uniqueness constraint to match on
      * @param props - Properties to compute the constraint key from
      */
-    findByConstraint: (constraintName: string, props: z.input<N["schema"]>) => Promise<Node<N> | undefined>;
+    findByConstraint: (constraintName: CN, props: z.input<N["schema"]>) => Promise<Node<N> | undefined>;
     /**
      * Batch version of findByConstraint.
      *
      * Results are returned in the same order as the input items.
      * Returns undefined for entries that don't match.
      */
-    bulkFindByConstraint: (constraintName: string, items: readonly Readonly<{
+    bulkFindByConstraint: (constraintName: CN, items: readonly Readonly<{
         props: z.input<N["schema"]>;
     }>[]) => Promise<(Node<N> | undefined)[]>;
     /**
@@ -961,28 +961,19 @@ type NodeCollection<N extends NodeType> = Readonly<{
      * @param props - Full properties for create, or merge source for update
      * @param options - Existing record behavior (default: "return")
      */
-    getOrCreateByConstraint: (constraintName: string, props: z.input<N["schema"]>, options?: NodeGetOrCreateByConstraintOptions) => Promise<NodeGetOrCreateByConstraintResult<N>>;
+    getOrCreateByConstraint: (constraintName: CN, props: z.input<N["schema"]>, options?: NodeGetOrCreateByConstraintOptions) => Promise<NodeGetOrCreateByConstraintResult<N>>;
     /**
      * Batch version of getOrCreateByConstraint.
      *
      * Results are returned in the same order as the input items.
      * Atomic when the backend supports transactions.
      */
-    bulkGetOrCreateByConstraint: (constraintName: string, items: readonly Readonly<{
+    bulkGetOrCreateByConstraint: (constraintName: CN, items: readonly Readonly<{
         props: z.input<N["schema"]>;
     }>[], options?: NodeGetOrCreateByConstraintOptions) => Promise<NodeGetOrCreateByConstraintResult<N>[]>;
 }>;
 /**
- * Reference to a node endpoint (kind and id).
- *
- * Can be either an explicit `{ kind, id }` object or a Node instance.
- */
-type NodeRef = Readonly<{
-    kind: string;
-    id: string;
-}>;
-/**
- * Type-safe reference to a node of a specific kind.
+ * Reference to a node of a specific kind.
  *
  * Accepts either:
  * - A Node instance of the correct kind
@@ -991,7 +982,7 @@ type NodeRef = Readonly<{
  * This provides compile-time checking that edge endpoints match the
  * allowed node kinds defined in the edge registration.
  */
-type TypedNodeRef<N extends NodeType> = Node<N> | Readonly<{
+type NodeRef<N extends NodeType = NodeType> = Node<N> | Readonly<{
     kind: N["kind"];
     id: string;
 }>;
@@ -1042,21 +1033,21 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * @param to - Target node (must be one of the allowed 'to' types)
      * @param args - Edge properties (optional if schema is empty) and creation options
      */
-    create: (from: TypedNodeRef<From>, to: TypedNodeRef<To>, ...args: EdgeCreateArguments<E>) => Promise<Edge<E>>;
+    create: (from: NodeRef<From>, to: NodeRef<To>, ...args: EdgeCreateArguments<E>) => Promise<Edge<E, From, To>>;
     /** Get an edge by ID */
-    getById: (id: string, options?: QueryOptions) => Promise<Edge<E> | undefined>;
+    getById: (id: EdgeId<E>, options?: QueryOptions) => Promise<Edge<E, From, To> | undefined>;
     /** Get multiple edges by ID, preserving input order (undefined for missing) */
-    getByIds: (ids: readonly string[], options?: QueryOptions) => Promise<readonly (Edge<E> | undefined)[]>;
+    getByIds: (ids: readonly EdgeId<E>[], options?: QueryOptions) => Promise<readonly (Edge<E, From, To> | undefined)[]>;
     /** Update an edge's properties */
-    update: (id: string, props: Partial<z.input<E["schema"]>>, options?: Readonly<{
+    update: (id: EdgeId<E>, props: Partial<z.input<E["schema"]>>, options?: Readonly<{
         validTo?: string;
-    }>) => Promise<Edge<E>>;
+    }>) => Promise<Edge<E, From, To>>;
     /** Find edges from a specific node */
-    findFrom: (from: TypedNodeRef<From>) => Promise<Edge<E>[]>;
+    findFrom: (from: NodeRef<From>) => Promise<Edge<E, From, To>[]>;
     /** Find edges to a specific node */
-    findTo: (to: TypedNodeRef<To>) => Promise<Edge<E>[]>;
+    findTo: (to: NodeRef<To>) => Promise<Edge<E, From, To>[]>;
     /** Delete an edge (soft delete - sets deletedAt timestamp) */
-    delete: (id: string) => Promise<void>;
+    delete: (id: EdgeId<E>) => Promise<void>;
     /**
      * Permanently delete an edge from the database.
      *
@@ -1066,20 +1057,20 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * **Warning:** This operation is irreversible and should be used carefully.
      * Consider using soft delete (`delete()`) for most use cases.
      */
-    hardDelete: (id: string) => Promise<void>;
+    hardDelete: (id: EdgeId<E>) => Promise<void>;
     /** Find edges matching endpoint and pagination criteria */
     find: (options?: Readonly<{
-        from?: TypedNodeRef<From>;
-        to?: TypedNodeRef<To>;
+        from?: NodeRef<From>;
+        to?: NodeRef<To>;
         limit?: number;
         offset?: number;
         temporalMode?: TemporalMode;
         asOf?: string;
-    }>) => Promise<Edge<E>[]>;
+    }>) => Promise<Edge<E, From, To>[]>;
     /** Count edges matching criteria */
     count: (options?: Readonly<{
-        from?: TypedNodeRef<From>;
-        to?: TypedNodeRef<To>;
+        from?: NodeRef<From>;
+        to?: NodeRef<To>;
         temporalMode?: TemporalMode;
         asOf?: string;
     }>) => Promise<number>;
@@ -1090,13 +1081,13 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * Use `bulkInsert` for the dedicated fast path that skips returning results.
      */
     bulkCreate: (items: readonly Readonly<{
-        from: TypedNodeRef<From>;
-        to: TypedNodeRef<To>;
+        from: NodeRef<From>;
+        to: NodeRef<To>;
         props?: z.input<E["schema"]>;
         id?: string;
         validFrom?: string;
         validTo?: string;
-    }>[]) => Promise<Edge<E>[]>;
+    }>[]) => Promise<Edge<E, From, To>[]>;
     /**
      * Create or update multiple edges in a batch.
      *
@@ -1104,13 +1095,13 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * Otherwise, creates a new edge with that ID.
      */
     bulkUpsertById: (items: readonly Readonly<{
-        id: string;
-        from: TypedNodeRef<From>;
-        to: TypedNodeRef<To>;
+        id: EdgeId<E>;
+        from: NodeRef<From>;
+        to: NodeRef<To>;
         props?: z.input<E["schema"]>;
         validFrom?: string;
         validTo?: string;
-    }>[]) => Promise<Edge<E>[]>;
+    }>[]) => Promise<Edge<E, From, To>[]>;
     /**
      * Insert multiple edges without returning results.
      *
@@ -1119,8 +1110,8 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * are returned and the operation is wrapped in a transaction.
      */
     bulkInsert: (items: readonly Readonly<{
-        from: TypedNodeRef<From>;
-        to: TypedNodeRef<To>;
+        from: NodeRef<From>;
+        to: NodeRef<To>;
         props?: z.input<E["schema"]>;
         id?: string;
         validFrom?: string;
@@ -1132,7 +1123,7 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * Atomic when the backend supports transactions. Silently ignores IDs
      * that don't exist.
      */
-    bulkDelete: (ids: readonly string[]) => Promise<void>;
+    bulkDelete: (ids: readonly EdgeId<E>[]) => Promise<void>;
     /**
      * Find a live edge by endpoints and optional property fields.
      *
@@ -1143,7 +1134,7 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * @param to - Target node
      * @param options - Match criteria (matchOn fields and property values)
      */
-    findByEndpoints: (from: TypedNodeRef<From>, to: TypedNodeRef<To>, options?: EdgeFindByEndpointsOptions<E>) => Promise<Edge<E> | undefined>;
+    findByEndpoints: (from: NodeRef<From>, to: NodeRef<To>, options?: EdgeFindByEndpointsOptions<E>) => Promise<Edge<E, From, To> | undefined>;
     /**
      * Get an existing edge by endpoints and optional property fields, or create a new one.
      *
@@ -1156,7 +1147,7 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * @param props - Full properties for create, or merge source for update
      * @param options - Match criteria and conflict resolution
      */
-    getOrCreateByEndpoints: (from: TypedNodeRef<From>, to: TypedNodeRef<To>, props: z.input<E["schema"]>, options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E>>;
+    getOrCreateByEndpoints: (from: NodeRef<From>, to: NodeRef<To>, props: z.input<E["schema"]>, options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>>;
     /**
      * Batch version of getOrCreateByEndpoints.
      *
@@ -1164,11 +1155,21 @@ type EdgeCollection<E extends AnyEdgeType, From extends NodeType = NodeType, To
      * Atomic when the backend supports transactions.
      */
     bulkGetOrCreateByEndpoints: (items: readonly Readonly<{
-        from: TypedNodeRef<From>;
-        to: TypedNodeRef<To>;
+        from: NodeRef<From>;
+        to: NodeRef<To>;
         props: z.input<E["schema"]>;
-    }>[], options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E>[]>;
+    }>[], options?: EdgeGetOrCreateByEndpointsOptions<E>) => Promise<EdgeGetOrCreateByEndpointsResult<E, From, To>[]>;
 }>;
+/**
+ * Extract uniqueness constraint names from a NodeRegistration.
+ *
+ * - Returns `never` when no uniqueness constraints are configured.
+ * - Returns a literal union when names are inferred via `defineGraph` const params.
+ * - Falls back to `string` when names are widened/dynamic.
+ */
+type ConstraintNames<R extends NodeRegistration> = "unique" extends keyof R ? R["unique"] extends readonly {
+    readonly name: infer N;
+}[] ? N & string : string : never;
 /**
  * Extract the union of 'from' node types from an EdgeRegistration.
  */
@@ -1201,7 +1202,7 @@ type TypedEdgeCollection<R extends EdgeRegistration> = EdgeCollection<R["type"],
 type TransactionContext<G extends GraphDef> = Readonly<{
     /** Node collections for the transaction */
     nodes: {
-        [K in keyof G["nodes"] & string]-?: NodeCollection<G["nodes"][K]["type"]>;
+        [K in keyof G["nodes"] & string]-?: NodeCollection<G["nodes"][K]["type"], ConstraintNames<G["nodes"][K]>>;
     };
     /** Edge collections for the transaction */
     edges: {
@@ -1819,7 +1820,7 @@ declare class Store<G extends GraphDef> {
      * ```
      */
     get nodes(): {
-        [K in keyof G["nodes"] & string]-?: NodeCollection<G["nodes"][K]["type"]>;
+        [K in keyof G["nodes"] & string]-?: NodeCollection<G["nodes"][K]["type"], ConstraintNames<G["nodes"][K]>>;
     };
     /**
      * Edge collections for ergonomic CRUD operations.
@@ -1954,4 +1955,4 @@ declare function createStore<G extends GraphDef>(graph: G, backend: GraphBackend
  */
 declare function createStoreWithSchema<G extends GraphDef>(graph: G, backend: GraphBackend, options?: StoreOptions & SchemaManagerOptions): Promise<[Store<G>, SchemaValidationResult]>;
 
-export { embedding as $, type AliasMap as A, type SelectableNode as B, type CreateQueryBuilderOptions as C, Store as D, type EdgeAliasMap as E, type FieldAccessor as F, type GetOrCreateAction as G, type HookContext as H, type IfExistsMode as I, type StoreHooks as J, type StoreOptions as K, type StreamOptions as L, type TransactionContext as M, type Node as N, type OperationHookContext as O, type PaginateOptions as P, QueryBuilder as Q, type RecursiveTraversalOptions as R, type SelectContext as S, TraversalBuilder as T, type TypedEdgeCollection as U, type TypedNodeRef as V, UnionableQuery as W, type UpdateEdgeInput as X, type UpdateNodeInput as Y, createStore as Z, createStoreWithSchema as _, type AggregateResult as a, exists as a0, fieldRef as a1, getEmbeddingDimensions as a2, inSubquery as a3, isEmbeddingSchema as a4, isParameterRef as a5, notExists as a6, notInSubquery as a7, param as a8, type CreateEdgeInput as b, type CreateNodeInput as c, type Edge as d, type EdgeAccessor as e, type EdgeCollection as f, type EdgeFindByEndpointsOptions as g, type EdgeGetOrCreateByEndpointsOptions as h, type EdgeGetOrCreateByEndpointsResult as i, type EmbeddingSchema as j, type EmbeddingValue as k, ExecutableAggregateQuery as l, ExecutableQuery as m, type NodeAccessor as n, type NodeAlias as o, type NodeCollection as p, type NodeGetOrCreateByConstraintOptions as q, type NodeGetOrCreateByConstraintResult as r, type NodeRef as s, type PaginatedResult as t, type Predicate as u, PreparedQuery as v, type PropsAccessor as w, type QueryHookContext as x, type QueryOptions as y, type SelectableEdge as z };
+export { embedding as $, type AliasMap as A, type SelectableEdge as B, type CreateQueryBuilderOptions as C, type SelectableNode as D, type EdgeAliasMap as E, type FieldAccessor as F, type GetOrCreateAction as G, type HookContext as H, type IfExistsMode as I, Store as J, type StoreHooks as K, type StoreOptions as L, type StreamOptions as M, type Node as N, type OperationHookContext as O, type PaginateOptions as P, QueryBuilder as Q, type RecursiveTraversalOptions as R, type SelectContext as S, TraversalBuilder as T, type TransactionContext as U, type TypedEdgeCollection as V, UnionableQuery as W, type UpdateEdgeInput as X, type UpdateNodeInput as Y, createStore as Z, createStoreWithSchema as _, type AggregateResult as a, exists as a0, fieldRef as a1, getEmbeddingDimensions as a2, inSubquery as a3, isEmbeddingSchema as a4, isParameterRef as a5, notExists as a6, notInSubquery as a7, param as a8, type ConstraintNames as b, type CreateEdgeInput as c, type CreateNodeInput as d, type Edge as e, type EdgeAccessor as f, type EdgeCollection as g, type EdgeFindByEndpointsOptions as h, type EdgeGetOrCreateByEndpointsOptions as i, type EdgeGetOrCreateByEndpointsResult as j, type EmbeddingSchema as k, type EmbeddingValue as l, ExecutableAggregateQuery as m, ExecutableQuery as n, type NodeAccessor as o, type NodeAlias as p, type NodeCollection as q, type NodeGetOrCreateByConstraintOptions as r, type NodeGetOrCreateByConstraintResult as s, type NodeRef as t, type PaginatedResult as u, type Predicate as v, PreparedQuery as w, type PropsAccessor as x, type QueryHookContext as y, type QueryOptions as z };

package/dist/{types-D5ggX07j.d.ts → types-1YJKodRv.d.ts}

@@ -1,5 +1,5 @@
 import { SQL } from 'drizzle-orm';
-import { N as NodeType, E as EdgeType, i as UniquenessScope, a as Collation, D as DeleteBehavior, C as Cardinality, e as EndpointExistence, T as TemporalMode, S as SqlDialect } from './types-DolHw9pJ.js';
+import { N as NodeType, E as EdgeType, j as UniquenessScope, a as Collation, D as DeleteBehavior, C as Cardinality, f as EndpointExistence, T as TemporalMode, S as SqlDialect } from './types-DMzKq0d5.js';
 
 /** Brand key for MetaEdge */
 declare const META_EDGE_BRAND: "__metaEdge";

package/dist/{types-BbMn2Ycv.d.cts → types-C8Ra3ROE.d.cts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { A as AnyEdgeType, E as EdgeType, N as NodeType } from './types-DolHw9pJ.cjs';
-import { J as JsonPointer, V as ValueType, b as JsonPointerFor, f as JsonPointerSegmentsFor } from './ast-Cq9qrnNP.cjs';
+import { A as AnyEdgeType, E as EdgeType, N as NodeType } from './types-DMzKq0d5.cjs';
+import { J as JsonPointer, V as ValueType, b as JsonPointerFor, f as JsonPointerSegmentsFor } from './ast-Bh2NDeaK.cjs';
 
 type IndexScope = 
 /**

package/dist/{types-C2rhqkg7.d.ts → types-CC8eB0PB.d.ts}

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { A as AnyEdgeType, E as EdgeType, N as NodeType } from './types-DolHw9pJ.js';
-import { J as JsonPointer, V as ValueType, b as JsonPointerFor, f as JsonPointerSegmentsFor } from './ast-CG87Zr6p.js';
+import { A as AnyEdgeType, E as EdgeType, N as NodeType } from './types-DMzKq0d5.js';
+import { J as JsonPointer, V as ValueType, b as JsonPointerFor, f as JsonPointerSegmentsFor } from './ast-COMyNeMn.js';
 
 type IndexScope = 
 /**

package/dist/{types-DJZoHy5R.d.ts → types-COPePE8_.d.ts}

@@ -1,4 +1,4 @@
-import { J as JsonPointer } from './ast-CG87Zr6p.js';
+import { J as JsonPointer } from './ast-COMyNeMn.js';
 
 /**
  * QueryProfiler types.

package/dist/{types-DEMAqkA1.d.cts → types-CVtGFpB9.d.cts}

@@ -1,4 +1,4 @@
-import { J as JsonPointer } from './ast-Cq9qrnNP.cjs';
+import { J as JsonPointer } from './ast-Bh2NDeaK.cjs';
 
 /**
  * QueryProfiler types.