@nicia-ai/typegraph 0.14.0 → 0.16.0

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 import { z } from 'zod';
 import { N as NodeType, E as EdgeType } from './types-DMzKq0d5.cjs';
 export { A as AnyEdgeType, C as Cardinality, a as Collation, D as DeleteBehavior, b as EdgeId, c as EdgeProps, d as EdgeRegistration, e as EdgeTypeWithEndpoints, f as EndpointExistence, G as GraphDefaults, g as NodeId, h as NodeProps, i as NodeRegistration, S as SqlDialect, T as TemporalMode, U as UniqueConstraint, j as UniquenessScope, k as isEdgeType, l as isEdgeTypeWithEndpoints, m as isNodeType } from './types-DMzKq0d5.cjs';
-import { I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-Ckfwgv9l.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-Ckfwgv9l.cjs';
-import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-BJPIoe8u.cjs';
-export { a as AggregateResult, b as AnyEdge, c as AnyNode, B as BatchResults, d as BatchableQuery, e as ConstraintNames, f as CreateEdgeInput, g as CreateNodeInput, h as Edge, i as EdgeAccessor, j as EdgeCollection, k as EdgeFindByEndpointsOptions, l as EdgeGetOrCreateByEndpointsOptions, m as EdgeGetOrCreateByEndpointsResult, n as EmbeddingSchema, o as EmbeddingValue, p as ExecutableAggregateQuery, q as ExecutableQuery, F as FieldAccessor, G as GetOrCreateAction, H as HookContext, I as IfExistsMode, N as Node, r as NodeAccessor, s as NodeAlias, t as NodeCollection, u as NodeGetOrCreateByConstraintOptions, v as NodeGetOrCreateByConstraintResult, w as NodeRef, O as OperationHookContext, P as PaginateOptions, x as PaginatedResult, y as Predicate, z as PreparedQuery, D as PropsAccessor, J as QueryHookContext, K as QueryOptions, R as RecursiveTraversalOptions, S as SelectContext, L as SelectableEdge, M as SelectableNode, U as Store, V as StoreHooks, W as StoreOptions, X as StreamOptions, Y as SubgraphOptions, Z as SubgraphResult, _ as SubsetEdge, $ as SubsetNode, a0 as TransactionContext, a1 as TypedEdgeCollection, a2 as UnionableQuery, a3 as UpdateEdgeInput, a4 as UpdateNodeInput, a5 as createStore, a6 as createStoreWithSchema, a7 as defineSubgraphProject, a8 as embedding, a9 as exists, aa as fieldRef, ab as getEmbeddingDimensions, ac as inSubquery, ad as isEmbeddingSchema, ae as isParameterRef, af as notExists, ag as notInSubquery, ah as param } from './store-BJPIoe8u.cjs';
-import { G as GraphDef, K as KindRegistry } from './manager-oh2mTMvy.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-oh2mTMvy.cjs';
+import { I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-B3mmOMJV.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-B3mmOMJV.cjs';
+import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-gTd_qa6u.cjs';
+export { a as AggregateResult, b as AnyEdge, c as AnyNode, B as BatchResults, d as BatchableQuery, e as ConstraintNames, f as CreateEdgeInput, g as CreateNodeInput, D as DynamicEdgeCollection, h as DynamicNodeCollection, i as Edge, j as EdgeAccessor, k as EdgeCollection, l as EdgeFindByEndpointsOptions, m as EdgeGetOrCreateByEndpointsOptions, n as EdgeGetOrCreateByEndpointsResult, o as EmbeddingSchema, p as EmbeddingValue, q as ExecutableAggregateQuery, r as ExecutableQuery, F as FieldAccessor, G as GetOrCreateAction, s as GraphEdgeCollections, t as GraphNodeCollections, H as HookContext, I as IfExistsMode, N as Node, u as NodeAccessor, v as NodeAlias, w as NodeCollection, x as NodeGetOrCreateByConstraintOptions, y as NodeGetOrCreateByConstraintResult, z as NodeRef, O as OperationHookContext, P as PaginateOptions, J as PaginatedResult, K as Predicate, L as PreparedQuery, M as PropsAccessor, R as QueryHookContext, S as QueryOptions, U as RecursiveTraversalOptions, V as SelectContext, W as SelectableEdge, X as SelectableNode, Y as Store, Z as StoreHooks, _ as StoreOptions, $ as StoreProjection, a0 as StreamOptions, a1 as SubgraphOptions, a2 as SubgraphResult, a3 as SubsetEdge, a4 as SubsetNode, a5 as TransactionContext, a6 as TypedEdgeCollection, a7 as UnionableQuery, a8 as UpdateEdgeInput, a9 as UpdateNodeInput, aa as createStore, ab as createStoreWithSchema, ac as defineSubgraphProject, ad as embedding, ae as exists, af as fieldRef, ag as getEmbeddingDimensions, ah as inSubquery, ai as isEmbeddingSchema, aj as isParameterRef, ak as notExists, al as notInSubquery, am as param } from './store-gTd_qa6u.cjs';
+import { G as GraphDef, K as KindRegistry } from './manager-Bj1UEnhE.cjs';
+export { A as AllEdgeTypes, a as AllNodeTypes, E as EdgeKinds, b as GetEdgeType, c as GetNodeType, N as NodeKinds, S as SchemaManagerOptions, d as SchemaValidationResult, e as defineGraph, g as getEdgeKinds, f as getNodeKinds, i as isGraphDef } from './manager-Bj1UEnhE.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-Bh2NDeaK.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-Bh2NDeaK.cjs';

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 import { z } from 'zod';
 import { N as NodeType, E as EdgeType } from './types-DMzKq0d5.js';
 export { A as AnyEdgeType, C as Cardinality, a as Collation, D as DeleteBehavior, b as EdgeId, c as EdgeProps, d as EdgeRegistration, e as EdgeTypeWithEndpoints, f as EndpointExistence, G as GraphDefaults, g as NodeId, h as NodeProps, i as NodeRegistration, S as SqlDialect, T as TemporalMode, U as UniqueConstraint, j as UniquenessScope, k as isEdgeType, l as isEdgeTypeWithEndpoints, m as isNodeType } from './types-DMzKq0d5.js';
-import { I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-5t_MIcvv.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-5t_MIcvv.js';
-import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-B9ItxA-Q.js';
-export { a as AggregateResult, b as AnyEdge, c as AnyNode, B as BatchResults, d as BatchableQuery, e as ConstraintNames, f as CreateEdgeInput, g as CreateNodeInput, h as Edge, i as EdgeAccessor, j as EdgeCollection, k as EdgeFindByEndpointsOptions, l as EdgeGetOrCreateByEndpointsOptions, m as EdgeGetOrCreateByEndpointsResult, n as EmbeddingSchema, o as EmbeddingValue, p as ExecutableAggregateQuery, q as ExecutableQuery, F as FieldAccessor, G as GetOrCreateAction, H as HookContext, I as IfExistsMode, N as Node, r as NodeAccessor, s as NodeAlias, t as NodeCollection, u as NodeGetOrCreateByConstraintOptions, v as NodeGetOrCreateByConstraintResult, w as NodeRef, O as OperationHookContext, P as PaginateOptions, x as PaginatedResult, y as Predicate, z as PreparedQuery, D as PropsAccessor, J as QueryHookContext, K as QueryOptions, R as RecursiveTraversalOptions, S as SelectContext, L as SelectableEdge, M as SelectableNode, U as Store, V as StoreHooks, W as StoreOptions, X as StreamOptions, Y as SubgraphOptions, Z as SubgraphResult, _ as SubsetEdge, $ as SubsetNode, a0 as TransactionContext, a1 as TypedEdgeCollection, a2 as UnionableQuery, a3 as UpdateEdgeInput, a4 as UpdateNodeInput, a5 as createStore, a6 as createStoreWithSchema, a7 as defineSubgraphProject, a8 as embedding, a9 as exists, aa as fieldRef, ab as getEmbeddingDimensions, ac as inSubquery, ad as isEmbeddingSchema, ae as isParameterRef, af as notExists, ag as notInSubquery, ah as param } from './store-B9ItxA-Q.js';
-import { G as GraphDef, K as KindRegistry } from './manager-qRSdnKEO.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-qRSdnKEO.js';
+import { I as InferenceType, M as MetaEdge, O as OntologyRelation } from './types-ThB4cFLp.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-ThB4cFLp.js';
+import { A as AliasMap, E as EdgeAliasMap, Q as QueryBuilder, T as TraversalBuilder, C as CreateQueryBuilderOptions } from './store-Bitii3qj.js';
+export { a as AggregateResult, b as AnyEdge, c as AnyNode, B as BatchResults, d as BatchableQuery, e as ConstraintNames, f as CreateEdgeInput, g as CreateNodeInput, D as DynamicEdgeCollection, h as DynamicNodeCollection, i as Edge, j as EdgeAccessor, k as EdgeCollection, l as EdgeFindByEndpointsOptions, m as EdgeGetOrCreateByEndpointsOptions, n as EdgeGetOrCreateByEndpointsResult, o as EmbeddingSchema, p as EmbeddingValue, q as ExecutableAggregateQuery, r as ExecutableQuery, F as FieldAccessor, G as GetOrCreateAction, s as GraphEdgeCollections, t as GraphNodeCollections, H as HookContext, I as IfExistsMode, N as Node, u as NodeAccessor, v as NodeAlias, w as NodeCollection, x as NodeGetOrCreateByConstraintOptions, y as NodeGetOrCreateByConstraintResult, z as NodeRef, O as OperationHookContext, P as PaginateOptions, J as PaginatedResult, K as Predicate, L as PreparedQuery, M as PropsAccessor, R as QueryHookContext, S as QueryOptions, U as RecursiveTraversalOptions, V as SelectContext, W as SelectableEdge, X as SelectableNode, Y as Store, Z as StoreHooks, _ as StoreOptions, $ as StoreProjection, a0 as StreamOptions, a1 as SubgraphOptions, a2 as SubgraphResult, a3 as SubsetEdge, a4 as SubsetNode, a5 as TransactionContext, a6 as TypedEdgeCollection, a7 as UnionableQuery, a8 as UpdateEdgeInput, a9 as UpdateNodeInput, aa as createStore, ab as createStoreWithSchema, ac as defineSubgraphProject, ad as embedding, ae as exists, af as fieldRef, ag as getEmbeddingDimensions, ah as inSubquery, ai as isEmbeddingSchema, aj as isParameterRef, ak as notExists, al as notInSubquery, am as param } from './store-Bitii3qj.js';
+import { G as GraphDef, K as KindRegistry } from './manager-Chhrq1vl.js';
+export { A as AllEdgeTypes, a as AllNodeTypes, E as EdgeKinds, b as GetEdgeType, c as GetNodeType, N as NodeKinds, S as SchemaManagerOptions, d as SchemaValidationResult, e as defineGraph, g as getEdgeKinds, f as getNodeKinds, i as isGraphDef } from './manager-Chhrq1vl.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-COMyNeMn.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-COMyNeMn.js';

package/dist/index.js

@@ -1,5 +1,5 @@
-import { META_EDGE_BRAND, META_EDGE_SUB_CLASS_OF, META_EDGE_NARROWER, META_EDGE_BROADER, META_EDGE_RELATED_TO, META_EDGE_EQUIVALENT_TO, META_EDGE_SAME_AS, META_EDGE_DIFFERENT_FROM, META_EDGE_DISJOINT_WITH, META_EDGE_HAS_PART, META_EDGE_PART_OF, META_EDGE_INVERSE_OF, META_EDGE_IMPLIES, ensureSchema, computeClosuresFromOntology, createEmptyClosures, KindRegistry, validateNodeProps, validateEdgeProps } from './chunk-KLOSTZDQ.js';
-export { isMetaEdge } from './chunk-KLOSTZDQ.js';
+import { META_EDGE_BRAND, META_EDGE_SUB_CLASS_OF, META_EDGE_NARROWER, META_EDGE_BROADER, META_EDGE_RELATED_TO, META_EDGE_EQUIVALENT_TO, META_EDGE_SAME_AS, META_EDGE_DIFFERENT_FROM, META_EDGE_DISJOINT_WITH, META_EDGE_HAS_PART, META_EDGE_PART_OF, META_EDGE_INVERSE_OF, META_EDGE_IMPLIES, ensureSchema, computeClosuresFromOntology, createEmptyClosures, KindRegistry, validateNodeProps, validateEdgeProps } from './chunk-L4ON6RJF.js';
+export { isMetaEdge } from './chunk-L4ON6RJF.js';
 import { NODE_TYPE_BRAND, EDGE_TYPE_BRAND, nowIso, validateOptionalIsoDate, getNodeKinds, getEdgeKinds } from './chunk-IRFD3MEU.js';
 export { defineGraph, getEdgeKinds, getNodeKinds, isEdgeType, isEdgeTypeWithEndpoints, isGraphDef, isNodeType } from './chunk-IRFD3MEU.js';
 import { ConfigurationError, UnsupportedPredicateError, ValidationError, CompilerInvariantError, KindNotFoundError, DatabaseOperationError, EdgeNotFoundError, NodeConstraintNotFoundError, RestrictedDeleteError, NodeNotFoundError, EndpointNotFoundError, UniquenessError, CardinalityError, EndpointError, DisjointError } from './chunk-SJ2QMDXY.js';
@@ -2315,7 +2315,7 @@ function buildStandardEmbeddingsCte(input) {
   const { ctx, graphId, vectorPredicate } = input;
   const { dialect } = ctx;
   const { field: field2, metric, minScore, queryEmbedding } = vectorPredicate;
-  const fieldPath = field2.jsonPointer ? field2.jsonPointer : field2.path.length > 1 && field2.path[0] === "props" ? `/${field2.path.slice(1).join("/")}` : `/${field2.path.join("/")}`;
+  const fieldPath = field2.jsonPointer ?? (field2.path.length > 1 && field2.path[0] === "props" ? `/${field2.path.slice(1).join("/")}` : `/${field2.path.join("/")}`);
   const distanceExpr = dialect.vectorDistance(
     sql.raw("embedding"),
     queryEmbedding,
@@ -9593,53 +9593,47 @@ function createNodeCollection(config) {
 // src/store/collection-factory.ts
 function createNodeCollectionsProxy(graph, graphId, registry, backend, operations) {
   const collectionCache = /* @__PURE__ */ new Map();
-  return new Proxy(
-    {},
-    {
-      get: (_, kind) => {
-        if (!(kind in graph.nodes)) {
-          throw new KindNotFoundError(kind, "node");
-        }
-        const cached = collectionCache.get(kind);
-        if (cached !== void 0) {
-          return cached;
-        }
-        const collection = createNodeCollection({
-          graphId,
-          kind,
-          backend,
-          ...operations
-        });
-        collectionCache.set(kind, collection);
-        return collection;
+  return new Proxy({}, {
+    get: (_, kind) => {
+      if (!Object.hasOwn(graph.nodes, kind)) {
+        throw new KindNotFoundError(kind, "node");
+      }
+      const cached = collectionCache.get(kind);
+      if (cached !== void 0) {
+        return cached;
       }
+      const collection = createNodeCollection({
+        graphId,
+        kind,
+        backend,
+        ...operations
+      });
+      collectionCache.set(kind, collection);
+      return collection;
     }
-  );
+  });
 }
 function createEdgeCollectionsProxy(graph, graphId, registry, backend, operations) {
   const collectionCache = /* @__PURE__ */ new Map();
-  return new Proxy(
-    {},
-    {
-      get: (_, kind) => {
-        if (!(kind in graph.edges)) {
-          throw new KindNotFoundError(kind, "edge");
-        }
-        const cached = collectionCache.get(kind);
-        if (cached !== void 0) {
-          return cached;
-        }
-        const collection = createEdgeCollection({
-          graphId,
-          kind,
-          backend,
-          ...operations
-        });
-        collectionCache.set(kind, collection);
-        return collection;
+  return new Proxy({}, {
+    get: (_, kind) => {
+      if (!Object.hasOwn(graph.edges, kind)) {
+        throw new KindNotFoundError(kind, "edge");
       }
+      const cached = collectionCache.get(kind);
+      if (cached !== void 0) {
+        return cached;
+      }
+      const collection = createEdgeCollection({
+        graphId,
+        kind,
+        backend,
+        ...operations
+      });
+      collectionCache.set(kind, collection);
+      return collection;
     }
-  );
+  });
 }
 
 // src/constraints/index.ts
@@ -11713,6 +11707,30 @@ var Store = class {
     }
     return this.#edgeCollections;
   }
+  // === Dynamic Collection Access ===
+  /**
+   * Returns the node collection for the given kind, or undefined if the kind
+   * is not registered in this graph.
+   *
+   * Use this for runtime string-keyed access when the kind is not known at
+   * compile time (e.g., iterating all kinds, resolving from edge metadata,
+   * dynamic admin UIs).
+   */
+  getNodeCollection(kind) {
+    if (!Object.hasOwn(this.#graph.nodes, kind)) return void 0;
+    return this.nodes[kind];
+  }
+  /**
+   * Returns the edge collection for the given kind, or undefined if the kind
+   * is not registered in this graph.
+   *
+   * Use this for runtime string-keyed access when the kind is not known at
+   * compile time.
+   */
+  getEdgeCollection(kind) {
+    if (!Object.hasOwn(this.#graph.edges, kind)) return void 0;
+    return this.edges[kind];
+  }
   /**
    * Node operations bound to this store instance.
    */