@nicia-ai/typegraph 0.15.0 → 0.16.1

package/dist/interchange/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { G as GraphDef } from '../manager-Bj1UEnhE.cjs';
-import { W as Store } from '../store-BNercm8P.cjs';
+import { Y as Store } from '../store-BZ7BexR1.cjs';
 import '../types-DMzKq0d5.cjs';
 import '../types-B3mmOMJV.cjs';
 import 'drizzle-orm';

package/dist/interchange/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { G as GraphDef } from '../manager-Chhrq1vl.js';
-import { W as Store } from '../store-CD_0yf2s.js';
+import { Y as Store } from '../store--7Nft1Ii.js';
 import '../types-DMzKq0d5.js';
 import '../types-ThB4cFLp.js';
 import 'drizzle-orm';

package/dist/profiler/index.d.cts

@@ -1,6 +1,6 @@
 import { G as GraphDef } from '../manager-Bj1UEnhE.cjs';
 import { Q as QueryAst } from '../ast-Bh2NDeaK.cjs';
-import { W as Store } from '../store-BNercm8P.cjs';
+import { Y as Store } from '../store-BZ7BexR1.cjs';
 import { P as ProfilerOptions, a as ProfileReport } from '../types-CVtGFpB9.cjs';
 export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-CVtGFpB9.cjs';
 import '../types-DMzKq0d5.cjs';

package/dist/profiler/index.d.ts

@@ -1,6 +1,6 @@
 import { G as GraphDef } from '../manager-Chhrq1vl.js';
 import { Q as QueryAst } from '../ast-COMyNeMn.js';
-import { W as Store } from '../store-CD_0yf2s.js';
+import { Y as Store } from '../store--7Nft1Ii.js';
 import { P as ProfilerOptions, a as ProfileReport } from '../types-COPePE8_.js';
 export { D as DeclaredIndex, I as IndexRecommendation, b as ProfileSummary, c as PropertyAccessStats, d as PropertyPath, R as RecommendationPriority, U as UsageContext } from '../types-COPePE8_.js';
 import '../types-DMzKq0d5.js';

package/dist/{store-CD_0yf2s.d.ts → store--7Nft1Ii.d.ts}

@@ -1293,6 +1293,51 @@ type TransactionContext<G extends GraphDef> = Readonly<{
     nodes: GraphNodeCollections<G>;
     edges: GraphEdgeCollections<G>;
 }>;
+/**
+ * Replace branded `NodeId` / `EdgeId` with plain `string` in each
+ * method's parameter list. Return types are preserved unchanged.
+ *
+ * Handles three shapes:
+ * 1. Direct branded ID parameter → `string`
+ * 2. `readonly NodeId[]` / `readonly EdgeId[]` → `readonly string[]`
+ * 3. Branded IDs nested one level inside bulk-item object arrays
+ */
+type WidenBrandedIds<T> = {
+    readonly [K in keyof T]: T[K] extends (...args: infer A) => infer R ? (...args: {
+        [P in keyof A]: UnbrandParam<A[P]>;
+    }) => R : T[K];
+};
+/** Replace a branded ID with `string`, recursing one level into arrays. */
+type UnbrandParam<T> = T extends NodeId<NodeType> ? string : T extends EdgeId<AnyEdgeType> ? string : T extends readonly NodeId<NodeType>[] ? readonly string[] : T extends readonly EdgeId<AnyEdgeType>[] ? readonly string[] : T extends readonly (infer Item extends Record<string, unknown>)[] ? readonly UnbrandRecord<Item>[] : T;
+/** Replace branded ID values in object properties (does not recurse into nested structures). */
+type UnbrandRecord<T extends Record<string, unknown>> = {
+    readonly [K in keyof T]: T[K] extends NodeId<NodeType> ? string : T[K] extends EdgeId<AnyEdgeType> ? string : T[K];
+};
+/**
+ * A node collection with widened generics for runtime string-keyed access.
+ *
+ * This is the return type of `store.getNodeCollection(kind)`. It exposes
+ * the full `NodeCollection` API but with `NodeType` and `string` constraint
+ * names instead of the specific generic parameters, since the concrete type
+ * is not known at compile time.
+ *
+ * ID parameters accept plain `string` instead of branded `NodeId<N>`, since
+ * the dynamic path typically receives IDs from edge metadata, snapshots,
+ * or external input where the brand is not available.
+ */
+type DynamicNodeCollection = WidenBrandedIds<NodeCollection<NodeType, string>>;
+/**
+ * An edge collection with widened generics for runtime string-keyed access.
+ *
+ * This is the return type of `store.getEdgeCollection(kind)`. It exposes
+ * the full `EdgeCollection` API but with `NodeType` endpoint types, since
+ * the concrete from/to types are not known at compile time.
+ *
+ * ID parameters accept plain `string` instead of branded `EdgeId<E>`, since
+ * the dynamic path typically receives IDs from edge metadata, snapshots,
+ * or external input where the brand is not available.
+ */
+type DynamicEdgeCollection = WidenBrandedIds<EdgeCollection<AnyEdgeType, NodeType, NodeType>>;
 /**
  * A type-level projection of a store's surface onto a subset of its
  * node and edge collections.
@@ -2103,6 +2148,23 @@ declare class Store<G extends GraphDef> {
      * ```
      */
     get edges(): GraphEdgeCollections<G>;
+    /**
+     * 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: string): DynamicNodeCollection | undefined;
+    /**
+     * 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: string): DynamicEdgeCollection | undefined;
     /**
      * Creates a query builder for this store.
      *
@@ -2275,4 +2337,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 { type SubgraphOptions as $, type AliasMap as A, type BatchResults as B, type CreateQueryBuilderOptions as C, type Predicate as D, type EdgeAliasMap as E, type FieldAccessor as F, type GetOrCreateAction as G, type HookContext as H, type IfExistsMode as I, PreparedQuery as J, type PropsAccessor as K, type QueryHookContext as L, type QueryOptions 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 SelectableEdge as U, type SelectableNode as V, Store as W, type StoreHooks as X, type StoreOptions as Y, type StoreProjection as Z, type StreamOptions as _, type AggregateResult as a, type SubgraphResult as a0, type SubsetEdge as a1, type SubsetNode as a2, type TransactionContext as a3, type TypedEdgeCollection as a4, UnionableQuery as a5, type UpdateEdgeInput as a6, type UpdateNodeInput as a7, createStore as a8, createStoreWithSchema as a9, defineSubgraphProject as aa, embedding as ab, exists as ac, fieldRef as ad, getEmbeddingDimensions as ae, inSubquery as af, isEmbeddingSchema as ag, isParameterRef as ah, notExists as ai, notInSubquery as aj, param as ak, type AnyEdge as b, type AnyNode as c, type BatchableQuery as d, type ConstraintNames as e, type CreateEdgeInput as f, type CreateNodeInput as g, type Edge as h, type EdgeAccessor as i, type EdgeCollection as j, type EdgeFindByEndpointsOptions as k, type EdgeGetOrCreateByEndpointsOptions as l, type EdgeGetOrCreateByEndpointsResult as m, type EmbeddingSchema as n, type EmbeddingValue as o, ExecutableAggregateQuery as p, ExecutableQuery as q, type GraphEdgeCollections as r, type GraphNodeCollections as s, type NodeAccessor as t, type NodeAlias as u, type NodeCollection as v, type NodeGetOrCreateByConstraintOptions as w, type NodeGetOrCreateByConstraintResult as x, type NodeRef as y, type PaginatedResult as z };
+export { type StoreProjection as $, type AliasMap as A, type BatchResults as B, type CreateQueryBuilderOptions as C, type DynamicEdgeCollection as D, type EdgeAliasMap as E, type FieldAccessor as F, type GetOrCreateAction as G, type HookContext as H, type IfExistsMode as I, type PaginatedResult as J, type Predicate as K, PreparedQuery as L, type PropsAccessor as M, type Node as N, type OperationHookContext as O, type PaginateOptions as P, QueryBuilder as Q, type QueryHookContext as R, type QueryOptions as S, TraversalBuilder as T, type RecursiveTraversalOptions as U, type SelectContext as V, type SelectableEdge as W, type SelectableNode as X, Store as Y, type StoreHooks as Z, type StoreOptions as _, type AggregateResult as a, type StreamOptions as a0, type SubgraphOptions as a1, type SubgraphResult as a2, type SubsetEdge as a3, type SubsetNode as a4, type TransactionContext as a5, type TypedEdgeCollection as a6, UnionableQuery as a7, type UpdateEdgeInput as a8, type UpdateNodeInput as a9, createStore as aa, createStoreWithSchema as ab, defineSubgraphProject as ac, embedding as ad, exists as ae, fieldRef as af, getEmbeddingDimensions as ag, inSubquery as ah, isEmbeddingSchema as ai, isParameterRef as aj, notExists as ak, notInSubquery as al, param as am, type AnyEdge as b, type AnyNode as c, type BatchableQuery as d, type ConstraintNames as e, type CreateEdgeInput as f, type CreateNodeInput as g, type DynamicNodeCollection as h, type Edge as i, type EdgeAccessor as j, type EdgeCollection as k, type EdgeFindByEndpointsOptions as l, type EdgeGetOrCreateByEndpointsOptions as m, type EdgeGetOrCreateByEndpointsResult as n, type EmbeddingSchema as o, type EmbeddingValue as p, ExecutableAggregateQuery as q, ExecutableQuery as r, type GraphEdgeCollections as s, type GraphNodeCollections as t, type NodeAccessor as u, type NodeAlias as v, type NodeCollection as w, type NodeGetOrCreateByConstraintOptions as x, type NodeGetOrCreateByConstraintResult as y, type NodeRef as z };

package/dist/{store-BNercm8P.d.cts → store-BZ7BexR1.d.cts}

@@ -1293,6 +1293,51 @@ type TransactionContext<G extends GraphDef> = Readonly<{
     nodes: GraphNodeCollections<G>;
     edges: GraphEdgeCollections<G>;
 }>;
+/**
+ * Replace branded `NodeId` / `EdgeId` with plain `string` in each
+ * method's parameter list. Return types are preserved unchanged.
+ *
+ * Handles three shapes:
+ * 1. Direct branded ID parameter → `string`
+ * 2. `readonly NodeId[]` / `readonly EdgeId[]` → `readonly string[]`
+ * 3. Branded IDs nested one level inside bulk-item object arrays
+ */
+type WidenBrandedIds<T> = {
+    readonly [K in keyof T]: T[K] extends (...args: infer A) => infer R ? (...args: {
+        [P in keyof A]: UnbrandParam<A[P]>;
+    }) => R : T[K];
+};
+/** Replace a branded ID with `string`, recursing one level into arrays. */
+type UnbrandParam<T> = T extends NodeId<NodeType> ? string : T extends EdgeId<AnyEdgeType> ? string : T extends readonly NodeId<NodeType>[] ? readonly string[] : T extends readonly EdgeId<AnyEdgeType>[] ? readonly string[] : T extends readonly (infer Item extends Record<string, unknown>)[] ? readonly UnbrandRecord<Item>[] : T;
+/** Replace branded ID values in object properties (does not recurse into nested structures). */
+type UnbrandRecord<T extends Record<string, unknown>> = {
+    readonly [K in keyof T]: T[K] extends NodeId<NodeType> ? string : T[K] extends EdgeId<AnyEdgeType> ? string : T[K];
+};
+/**
+ * A node collection with widened generics for runtime string-keyed access.
+ *
+ * This is the return type of `store.getNodeCollection(kind)`. It exposes
+ * the full `NodeCollection` API but with `NodeType` and `string` constraint
+ * names instead of the specific generic parameters, since the concrete type
+ * is not known at compile time.
+ *
+ * ID parameters accept plain `string` instead of branded `NodeId<N>`, since
+ * the dynamic path typically receives IDs from edge metadata, snapshots,
+ * or external input where the brand is not available.
+ */
+type DynamicNodeCollection = WidenBrandedIds<NodeCollection<NodeType, string>>;
+/**
+ * An edge collection with widened generics for runtime string-keyed access.
+ *
+ * This is the return type of `store.getEdgeCollection(kind)`. It exposes
+ * the full `EdgeCollection` API but with `NodeType` endpoint types, since
+ * the concrete from/to types are not known at compile time.
+ *
+ * ID parameters accept plain `string` instead of branded `EdgeId<E>`, since
+ * the dynamic path typically receives IDs from edge metadata, snapshots,
+ * or external input where the brand is not available.
+ */
+type DynamicEdgeCollection = WidenBrandedIds<EdgeCollection<AnyEdgeType, NodeType, NodeType>>;
 /**
  * A type-level projection of a store's surface onto a subset of its
  * node and edge collections.
@@ -2103,6 +2148,23 @@ declare class Store<G extends GraphDef> {
      * ```
      */
     get edges(): GraphEdgeCollections<G>;
+    /**
+     * 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: string): DynamicNodeCollection | undefined;
+    /**
+     * 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: string): DynamicEdgeCollection | undefined;
     /**
      * Creates a query builder for this store.
      *
@@ -2275,4 +2337,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 { type SubgraphOptions as $, type AliasMap as A, type BatchResults as B, type CreateQueryBuilderOptions as C, type Predicate as D, type EdgeAliasMap as E, type FieldAccessor as F, type GetOrCreateAction as G, type HookContext as H, type IfExistsMode as I, PreparedQuery as J, type PropsAccessor as K, type QueryHookContext as L, type QueryOptions 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 SelectableEdge as U, type SelectableNode as V, Store as W, type StoreHooks as X, type StoreOptions as Y, type StoreProjection as Z, type StreamOptions as _, type AggregateResult as a, type SubgraphResult as a0, type SubsetEdge as a1, type SubsetNode as a2, type TransactionContext as a3, type TypedEdgeCollection as a4, UnionableQuery as a5, type UpdateEdgeInput as a6, type UpdateNodeInput as a7, createStore as a8, createStoreWithSchema as a9, defineSubgraphProject as aa, embedding as ab, exists as ac, fieldRef as ad, getEmbeddingDimensions as ae, inSubquery as af, isEmbeddingSchema as ag, isParameterRef as ah, notExists as ai, notInSubquery as aj, param as ak, type AnyEdge as b, type AnyNode as c, type BatchableQuery as d, type ConstraintNames as e, type CreateEdgeInput as f, type CreateNodeInput as g, type Edge as h, type EdgeAccessor as i, type EdgeCollection as j, type EdgeFindByEndpointsOptions as k, type EdgeGetOrCreateByEndpointsOptions as l, type EdgeGetOrCreateByEndpointsResult as m, type EmbeddingSchema as n, type EmbeddingValue as o, ExecutableAggregateQuery as p, ExecutableQuery as q, type GraphEdgeCollections as r, type GraphNodeCollections as s, type NodeAccessor as t, type NodeAlias as u, type NodeCollection as v, type NodeGetOrCreateByConstraintOptions as w, type NodeGetOrCreateByConstraintResult as x, type NodeRef as y, type PaginatedResult as z };
+export { type StoreProjection as $, type AliasMap as A, type BatchResults as B, type CreateQueryBuilderOptions as C, type DynamicEdgeCollection as D, type EdgeAliasMap as E, type FieldAccessor as F, type GetOrCreateAction as G, type HookContext as H, type IfExistsMode as I, type PaginatedResult as J, type Predicate as K, PreparedQuery as L, type PropsAccessor as M, type Node as N, type OperationHookContext as O, type PaginateOptions as P, QueryBuilder as Q, type QueryHookContext as R, type QueryOptions as S, TraversalBuilder as T, type RecursiveTraversalOptions as U, type SelectContext as V, type SelectableEdge as W, type SelectableNode as X, Store as Y, type StoreHooks as Z, type StoreOptions as _, type AggregateResult as a, type StreamOptions as a0, type SubgraphOptions as a1, type SubgraphResult as a2, type SubsetEdge as a3, type SubsetNode as a4, type TransactionContext as a5, type TypedEdgeCollection as a6, UnionableQuery as a7, type UpdateEdgeInput as a8, type UpdateNodeInput as a9, createStore as aa, createStoreWithSchema as ab, defineSubgraphProject as ac, embedding as ad, exists as ae, fieldRef as af, getEmbeddingDimensions as ag, inSubquery as ah, isEmbeddingSchema as ai, isParameterRef as aj, notExists as ak, notInSubquery as al, param as am, type AnyEdge as b, type AnyNode as c, type BatchableQuery as d, type ConstraintNames as e, type CreateEdgeInput as f, type CreateNodeInput as g, type DynamicNodeCollection as h, type Edge as i, type EdgeAccessor as j, type EdgeCollection as k, type EdgeFindByEndpointsOptions as l, type EdgeGetOrCreateByEndpointsOptions as m, type EdgeGetOrCreateByEndpointsResult as n, type EmbeddingSchema as o, type EmbeddingValue as p, ExecutableAggregateQuery as q, ExecutableQuery as r, type GraphEdgeCollections as s, type GraphNodeCollections as t, type NodeAccessor as u, type NodeAlias as v, type NodeCollection as w, type NodeGetOrCreateByConstraintOptions as x, type NodeGetOrCreateByConstraintResult as y, type NodeRef as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicia-ai/typegraph",
-  "version": "0.15.0",
+  "version": "0.16.1",
   "description": "TypeScript-first embedded knowledge graph library with ontological reasoning",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -142,11 +142,11 @@
     "@types/pg": "^8.20.0",
     "@vitest/coverage-v8": "^4.1.2",
     "better-sqlite3": "^12.8.0",
-    "drizzle-orm": "^0.45.1",
+    "drizzle-orm": "^0.45.2",
     "eslint": "^10.1.0",
     "fast-check": "^4.6.0",
     "pg": "^8.20.0",
-    "sqlite-vec": "^0.1.7",
+    "sqlite-vec": "^0.1.8",
     "tsd": "^0.33.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",