agredadb 1.0.0

package/agreda.proto

@@ -0,0 +1,52 @@
+syntax = "proto3";
+package agreda;
+
+service Agreda {
+  rpc Insert (InsertRequest) returns (InsertResponse);
+  rpc InsertBatch (InsertBatchRequest) returns (InsertResponse);
+  rpc Query (QueryRequest) returns (QueryResponse);
+  
+  // NUEVO: Búsqueda Vectorial Real (Nearest Neighbor Search)
+  rpc Search (SearchRequest) returns (SearchResponse);
+}
+
+message InsertRequest {
+  string table = 1;
+  string json_data = 2; 
+}
+
+message InsertBatchRequest {
+  string table = 1;
+  repeated string json_data_list = 2;
+}
+
+message InsertResponse {
+  bool success = 1;
+  string message = 2;
+  uint32 records_processed = 3;
+}
+
+message QueryRequest {
+  string sql = 1; 
+}
+
+message QueryResponse {
+  bytes arrow_ipc_stream = 1; 
+}
+
+message SearchRequest {
+  string table = 1;
+  repeated float vector = 2; // El vector a buscar (embedding)
+  uint32 limit = 3;          // Top K (ej. 10)
+}
+
+message SearchResponse {
+  // Lista de JSONs con los resultados ordenados por similitud
+  repeated SearchResult results = 1;
+}
+
+message SearchResult {
+  string id = 1;
+  float score = 2; // Similitud Coseno (0.0 a 1.0)
+  string json_data = 3;
+}

package/index.js

@@ -0,0 +1,44 @@
+const grpc = require('@grpc/grpc-js');
+const protoLoader = require('@grpc/proto-loader');
+const path = require('path');
+
+const PROTO_PATH = path.join(__dirname, 'agreda.proto');
+
+const packageDefinition = protoLoader.loadSync(PROTO_PATH, {
+  keepCase: true,
+  longs: String,
+  enums: String,
+  defaults: True,
+  oneofs: True
+});
+
+const agredaProto = grpc.loadPackageDefinition(packageDefinition).agreda;
+
+class AgredaClient {
+  constructor(host = 'localhost:19999') {
+    this.client = new agredaProto.Agreda(host, grpc.credentials.createInsecure());
+  }
+
+  insert(table, data) {
+    const jsonData = typeof data === 'string' ? data : JSON.stringify(data);
+    return new Promise((resolve, reject) => {
+      this.client.Insert({ table, json_data: jsonData }, (err, resp) => {
+        if (err) reject(err);
+        else resolve(resp);
+      });
+    });
+  }
+
+  search(table, vector, limit = 10) {
+    return new Promise((resolve, reject) => {
+      this.client.Search({ table, vector, limit }, (err, resp) => {
+        if (err) reject(err);
+        else resolve(resp.results);
+      });
+    });
+  }
+}
+
+module.exports = {
+  connect: (host) => new AgredaClient(host)
+};

package/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "agredadb",
+  "version": "1.0.0",
+  "description": "Official Node.js SDK for AgredaDB",
+  "main": "index.js",
+  "dependencies": {
+    "@grpc/grpc-js": "^1.9.0",
+    "@grpc/proto-loader": "^0.7.0"
+  },
+  "author": "Luis Eduardo Agreda Gonzalez"
+}