@wiscale/tauri-plugin-velesdb 1.5.1 → 1.7.0

package/dist/index.d.mts

@@ -508,5 +508,112 @@ declare function isEmpty(name: string): Promise<boolean>;
  * ```
  */
 declare function flush(name: string): Promise<void>;
+/** Request to add an edge to a graph collection. */
+interface AddEdgeRequest {
+    collection: string;
+    id: number;
+    source: number;
+    target: number;
+    label: string;
+    properties?: Record<string, unknown>;
+}
+/** Request to retrieve edges from a graph collection. */
+interface GetEdgesRequest {
+    collection: string;
+    label?: string;
+    source?: number;
+    target?: number;
+}
+/** Request to traverse the knowledge graph. */
+interface TraverseGraphRequest {
+    collection: string;
+    source: number;
+    maxDepth: number;
+    relTypes?: string[];
+    limit: number;
+    algorithm: 'bfs' | 'dfs';
+}
+/** Request to get the degree of a node. */
+interface GetNodeDegreeRequest {
+    collection: string;
+    nodeId: number;
+}
+/** A single edge in the knowledge graph. */
+interface EdgeOutput {
+    id: number;
+    source: number;
+    target: number;
+    label: string;
+    properties: Record<string, unknown>;
+}
+/** A single traversal result node. */
+interface TraversalOutput {
+    targetId: number;
+    depth: number;
+    path: number[];
+}
+/** In/out degree of a graph node. */
+interface NodeDegreeOutput {
+    nodeId: number;
+    inDegree: number;
+    outDegree: number;
+}
+/**
+ * Adds an edge to a knowledge graph collection.
+ *
+ * @param request - Edge to add (collection, id, source, target, label, optional properties)
+ * @throws {CommandError} If the collection doesn't exist
+ *
+ * @example
+ * ```typescript
+ * await addEdge({
+ *   collection: 'social', id: 1, source: 100, target: 200,
+ *   label: 'FOLLOWS', properties: { since: '2024-01-01' }
+ * });
+ * ```
+ */
+declare function addEdge(request: AddEdgeRequest): Promise<void>;
+/**
+ * Retrieves edges from a knowledge graph collection.
+ *
+ * @param request - Filter (by label, source, or target node)
+ * @returns Array of matching edges
+ * @throws {CommandError} If the collection doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const edges = await getEdges({ collection: 'social', label: 'FOLLOWS' });
+ * ```
+ */
+declare function getEdges(request: GetEdgesRequest): Promise<EdgeOutput[]>;
+/**
+ * Traverses the knowledge graph from a source node.
+ *
+ * @param request - Traversal parameters (source, maxDepth, algorithm, optional relTypes filter)
+ * @returns Array of reachable nodes with their depth and path
+ * @throws {CommandError} If the collection doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const result = await traverseGraph({
+ *   collection: 'social', source: 100, algorithm: 'bfs', maxDepth: 3, limit: 50
+ * });
+ * ```
+ */
+declare function traverseGraph(request: TraverseGraphRequest): Promise<TraversalOutput[]>;
+/**
+ * Gets the in-degree and out-degree of a graph node.
+ *
+ * @param request - Collection name and node ID
+ * @returns Node degree information (inDegree, outDegree)
+ * @throws {CommandError} If the collection doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const degree = await getNodeDegree({ collection: 'social', nodeId: 100 });
+ * console.log(`In: ${degree.inDegree}, Out: ${degree.outDegree}`);
+ * ```
+ */
+declare function getNodeDegree(request: GetNodeDegreeRequest): Promise<NodeDegreeOutput>;
 
-export { type BatchSearchRequest, type CollectionInfo, type CommandError, type CreateCollectionRequest, type CreateMetadataCollectionRequest, type DeletePointsRequest, type DistanceMetric, type FusionParams, type FusionStrategy, type GetPointsRequest, type HybridSearchRequest, type IndividualSearchRequest, type MetadataPointInput, type MultiQuerySearchRequest, type PointInput, type PointOutput, type QueryRequest, type SearchRequest, type SearchResponse, type SearchResult, type TextSearchRequest, type UpsertMetadataRequest, type UpsertRequest, batchSearch, createCollection, createMetadataCollection, deleteCollection, deletePoints, flush, getCollection, getPoints, hybridSearch, isEmpty, listCollections, multiQuerySearch, query, search, textSearch, upsert, upsertMetadata };
+export { type AddEdgeRequest, type BatchSearchRequest, type CollectionInfo, type CommandError, type CreateCollectionRequest, type CreateMetadataCollectionRequest, type DeletePointsRequest, type DistanceMetric, type EdgeOutput, type FusionParams, type FusionStrategy, type GetEdgesRequest, type GetNodeDegreeRequest, type GetPointsRequest, type HybridSearchRequest, type IndividualSearchRequest, type MetadataPointInput, type MultiQuerySearchRequest, type NodeDegreeOutput, type PointInput, type PointOutput, type QueryRequest, type SearchRequest, type SearchResponse, type SearchResult, type TextSearchRequest, type TraversalOutput, type TraverseGraphRequest, type UpsertMetadataRequest, type UpsertRequest, addEdge, batchSearch, createCollection, createMetadataCollection, deleteCollection, deletePoints, flush, getCollection, getEdges, getNodeDegree, getPoints, hybridSearch, isEmpty, listCollections, multiQuerySearch, query, search, textSearch, traverseGraph, upsert, upsertMetadata };

package/dist/index.d.ts

@@ -508,5 +508,112 @@ declare function isEmpty(name: string): Promise<boolean>;
  * ```
  */
 declare function flush(name: string): Promise<void>;
+/** Request to add an edge to a graph collection. */
+interface AddEdgeRequest {
+    collection: string;
+    id: number;
+    source: number;
+    target: number;
+    label: string;
+    properties?: Record<string, unknown>;
+}
+/** Request to retrieve edges from a graph collection. */
+interface GetEdgesRequest {
+    collection: string;
+    label?: string;
+    source?: number;
+    target?: number;
+}
+/** Request to traverse the knowledge graph. */
+interface TraverseGraphRequest {
+    collection: string;
+    source: number;
+    maxDepth: number;
+    relTypes?: string[];
+    limit: number;
+    algorithm: 'bfs' | 'dfs';
+}
+/** Request to get the degree of a node. */
+interface GetNodeDegreeRequest {
+    collection: string;
+    nodeId: number;
+}
+/** A single edge in the knowledge graph. */
+interface EdgeOutput {
+    id: number;
+    source: number;
+    target: number;
+    label: string;
+    properties: Record<string, unknown>;
+}
+/** A single traversal result node. */
+interface TraversalOutput {
+    targetId: number;
+    depth: number;
+    path: number[];
+}
+/** In/out degree of a graph node. */
+interface NodeDegreeOutput {
+    nodeId: number;
+    inDegree: number;
+    outDegree: number;
+}
+/**
+ * Adds an edge to a knowledge graph collection.
+ *
+ * @param request - Edge to add (collection, id, source, target, label, optional properties)
+ * @throws {CommandError} If the collection doesn't exist
+ *
+ * @example
+ * ```typescript
+ * await addEdge({
+ *   collection: 'social', id: 1, source: 100, target: 200,
+ *   label: 'FOLLOWS', properties: { since: '2024-01-01' }
+ * });
+ * ```
+ */
+declare function addEdge(request: AddEdgeRequest): Promise<void>;
+/**
+ * Retrieves edges from a knowledge graph collection.
+ *
+ * @param request - Filter (by label, source, or target node)
+ * @returns Array of matching edges
+ * @throws {CommandError} If the collection doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const edges = await getEdges({ collection: 'social', label: 'FOLLOWS' });
+ * ```
+ */
+declare function getEdges(request: GetEdgesRequest): Promise<EdgeOutput[]>;
+/**
+ * Traverses the knowledge graph from a source node.
+ *
+ * @param request - Traversal parameters (source, maxDepth, algorithm, optional relTypes filter)
+ * @returns Array of reachable nodes with their depth and path
+ * @throws {CommandError} If the collection doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const result = await traverseGraph({
+ *   collection: 'social', source: 100, algorithm: 'bfs', maxDepth: 3, limit: 50
+ * });
+ * ```
+ */
+declare function traverseGraph(request: TraverseGraphRequest): Promise<TraversalOutput[]>;
+/**
+ * Gets the in-degree and out-degree of a graph node.
+ *
+ * @param request - Collection name and node ID
+ * @returns Node degree information (inDegree, outDegree)
+ * @throws {CommandError} If the collection doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const degree = await getNodeDegree({ collection: 'social', nodeId: 100 });
+ * console.log(`In: ${degree.inDegree}, Out: ${degree.outDegree}`);
+ * ```
+ */
+declare function getNodeDegree(request: GetNodeDegreeRequest): Promise<NodeDegreeOutput>;
 
-export { type BatchSearchRequest, type CollectionInfo, type CommandError, type CreateCollectionRequest, type CreateMetadataCollectionRequest, type DeletePointsRequest, type DistanceMetric, type FusionParams, type FusionStrategy, type GetPointsRequest, type HybridSearchRequest, type IndividualSearchRequest, type MetadataPointInput, type MultiQuerySearchRequest, type PointInput, type PointOutput, type QueryRequest, type SearchRequest, type SearchResponse, type SearchResult, type TextSearchRequest, type UpsertMetadataRequest, type UpsertRequest, batchSearch, createCollection, createMetadataCollection, deleteCollection, deletePoints, flush, getCollection, getPoints, hybridSearch, isEmpty, listCollections, multiQuerySearch, query, search, textSearch, upsert, upsertMetadata };
+export { type AddEdgeRequest, type BatchSearchRequest, type CollectionInfo, type CommandError, type CreateCollectionRequest, type CreateMetadataCollectionRequest, type DeletePointsRequest, type DistanceMetric, type EdgeOutput, type FusionParams, type FusionStrategy, type GetEdgesRequest, type GetNodeDegreeRequest, type GetPointsRequest, type HybridSearchRequest, type IndividualSearchRequest, type MetadataPointInput, type MultiQuerySearchRequest, type NodeDegreeOutput, type PointInput, type PointOutput, type QueryRequest, type SearchRequest, type SearchResponse, type SearchResult, type TextSearchRequest, type TraversalOutput, type TraverseGraphRequest, type UpsertMetadataRequest, type UpsertRequest, addEdge, batchSearch, createCollection, createMetadataCollection, deleteCollection, deletePoints, flush, getCollection, getEdges, getNodeDegree, getPoints, hybridSearch, isEmpty, listCollections, multiQuerySearch, query, search, textSearch, traverseGraph, upsert, upsertMetadata };

package/dist/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // index.ts
 var index_exports = {};
 __export(index_exports, {
+  addEdge: () => addEdge,
   batchSearch: () => batchSearch,
   createCollection: () => createCollection,
   createMetadataCollection: () => createMetadataCollection,
@@ -27,6 +28,8 @@ __export(index_exports, {
   deletePoints: () => deletePoints,
   flush: () => flush,
   getCollection: () => getCollection,
+  getEdges: () => getEdges,
+  getNodeDegree: () => getNodeDegree,
   getPoints: () => getPoints,
   hybridSearch: () => hybridSearch,
   isEmpty: () => isEmpty,
@@ -35,6 +38,7 @@ __export(index_exports, {
   query: () => query,
   search: () => search,
   textSearch: () => textSearch,
+  traverseGraph: () => traverseGraph,
   upsert: () => upsert,
   upsertMetadata: () => upsertMetadata
 });
@@ -91,8 +95,21 @@ async function isEmpty(name) {
 async function flush(name) {
   return (0, import_core.invoke)("plugin:velesdb|flush", { name });
 }
+async function addEdge(request) {
+  return (0, import_core.invoke)("plugin:velesdb|add_edge", { request });
+}
+async function getEdges(request) {
+  return (0, import_core.invoke)("plugin:velesdb|get_edges", { request });
+}
+async function traverseGraph(request) {
+  return (0, import_core.invoke)("plugin:velesdb|traverse_graph", { request });
+}
+async function getNodeDegree(request) {
+  return (0, import_core.invoke)("plugin:velesdb|get_node_degree", { request });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  addEdge,
   batchSearch,
   createCollection,
   createMetadataCollection,
@@ -100,6 +117,8 @@ async function flush(name) {
   deletePoints,
   flush,
   getCollection,
+  getEdges,
+  getNodeDegree,
   getPoints,
   hybridSearch,
   isEmpty,
@@ -108,6 +127,7 @@ async function flush(name) {
   query,
   search,
   textSearch,
+  traverseGraph,
   upsert,
   upsertMetadata
 });

package/dist/index.mjs

@@ -51,7 +51,20 @@ async function isEmpty(name) {
 async function flush(name) {
   return invoke("plugin:velesdb|flush", { name });
 }
+async function addEdge(request) {
+  return invoke("plugin:velesdb|add_edge", { request });
+}
+async function getEdges(request) {
+  return invoke("plugin:velesdb|get_edges", { request });
+}
+async function traverseGraph(request) {
+  return invoke("plugin:velesdb|traverse_graph", { request });
+}
+async function getNodeDegree(request) {
+  return invoke("plugin:velesdb|get_node_degree", { request });
+}
 export {
+  addEdge,
   batchSearch,
   createCollection,
   createMetadataCollection,
@@ -59,6 +72,8 @@ export {
   deletePoints,
   flush,
   getCollection,
+  getEdges,
+  getNodeDegree,
   getPoints,
   hybridSearch,
   isEmpty,
@@ -67,6 +82,7 @@ export {
   query,
   search,
   textSearch,
+  traverseGraph,
   upsert,
   upsertMetadata
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wiscale/tauri-plugin-velesdb",
-  "version": "1.5.1",
+  "version": "1.7.0",
   "description": "TypeScript bindings for the VelesDB Tauri plugin - Vector search in desktop apps",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -33,7 +33,7 @@
     "desktop"
   ],
   "author": "Cyberlife Coder",
-  "license": "Elastic-2.0",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/cyberlife-coder/VelesDB.git",