@ekodb/ekodb-client 0.1.0 → 0.1.7

package/README.md

@@ -312,7 +312,7 @@ const joinResults = await client.find("users", multiQuery);
 ## Examples
 
 See the
-[examples directory](https://github.com/ekoDB/ekodb/tree/main/examples/typescript)
+[examples directory](https://github.com/ekoDB/ekodb-client/tree/main/examples/typescript)
 for complete working examples:
 
 - `client_simple_crud.ts` - Basic CRUD operations
@@ -327,3 +327,9 @@ for complete working examples:
 ## License
 
 MIT
+
+## Links
+
+- [GitHub Repository](https://github.com/ekoDB/ekodb-client)
+- [Examples](https://github.com/ekoDB/ekodb-client/tree/main/examples/typescript)
+- [npm Package](https://www.npmjs.com/package/@ekodb/ekodb-client)

package/dist/client.d.ts

@@ -1,9 +1,9 @@
 /**
  * ekoDB TypeScript Client
  */
-import { QueryBuilder } from './query-builder';
-import { SearchQuery, SearchQueryBuilder, SearchResponse } from './search';
-import { Schema, SchemaBuilder, CollectionMetadata } from './schema';
+import { QueryBuilder } from "./query-builder";
+import { SearchQuery, SearchQueryBuilder, SearchResponse } from "./search";
+import { Schema, SchemaBuilder, CollectionMetadata } from "./schema";
 export interface Record {
     [key: string]: any;
 }

package/dist/client.js

@@ -47,7 +47,7 @@ class RateLimitError extends Error {
     constructor(retryAfterSecs, message) {
         super(message || `Rate limit exceeded. Retry after ${retryAfterSecs} seconds`);
         this.retryAfterSecs = retryAfterSecs;
-        this.name = 'RateLimitError';
+        this.name = "RateLimitError";
     }
 }
 exports.RateLimitError = RateLimitError;
@@ -62,7 +62,7 @@ class EkoDBClient {
         this.token = null;
         this.rateLimitInfo = null;
         // Support both old (baseURL, apiKey) and new (config object) signatures
-        if (typeof config === 'string') {
+        if (typeof config === "string") {
             this.baseURL = config;
             this.apiKey = apiKey;
             this.shouldRetry = true;
@@ -103,23 +103,23 @@ class EkoDBClient {
      */
     async refreshToken() {
         const response = await fetch(`${this.baseURL}/api/auth/token`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
             body: JSON.stringify({ api_key: this.apiKey }),
         });
         if (!response.ok) {
             throw new Error(`Auth failed with status: ${response.status}`);
         }
-        const result = await response.json();
+        const result = (await response.json());
         this.token = result.token;
     }
     /**
      * Extract rate limit information from response headers
      */
     extractRateLimitInfo(response) {
-        const limit = response.headers.get('x-ratelimit-limit');
-        const remaining = response.headers.get('x-ratelimit-remaining');
-        const reset = response.headers.get('x-ratelimit-reset');
+        const limit = response.headers.get("x-ratelimit-limit");
+        const remaining = response.headers.get("x-ratelimit-remaining");
+        const reset = response.headers.get("x-ratelimit-reset");
         if (limit && remaining && reset) {
             this.rateLimitInfo = {
                 limit: parseInt(limit, 10),
@@ -136,7 +136,7 @@ class EkoDBClient {
      * Sleep for a specified number of seconds
      */
     sleep(seconds) {
-        return new Promise(resolve => setTimeout(resolve, seconds * 1000));
+        return new Promise((resolve) => setTimeout(resolve, seconds * 1000));
     }
     /**
      * Make an HTTP request to the ekoDB API with retry logic
@@ -148,8 +148,8 @@ class EkoDBClient {
         const options = {
             method,
             headers: {
-                'Authorization': `Bearer ${this.token}`,
-                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.token}`,
+                "Content-Type": "application/json",
             },
         };
         if (data) {
@@ -164,7 +164,7 @@ class EkoDBClient {
             }
             // Handle rate limiting (429)
             if (response.status === 429) {
-                const retryAfter = parseInt(response.headers.get('retry-after') || '60', 10);
+                const retryAfter = parseInt(response.headers.get("retry-after") || "60", 10);
                 if (this.shouldRetry && attempt < this.maxRetries) {
                     console.log(`Rate limited. Retrying after ${retryAfter} seconds...`);
                     await this.sleep(retryAfter);
@@ -173,7 +173,9 @@ class EkoDBClient {
                 throw new RateLimitError(retryAfter);
             }
             // Handle service unavailable (503)
-            if (response.status === 503 && this.shouldRetry && attempt < this.maxRetries) {
+            if (response.status === 503 &&
+                this.shouldRetry &&
+                attempt < this.maxRetries) {
                 const retryDelay = 10;
                 console.log(`Service unavailable. Retrying after ${retryDelay} seconds...`);
                 await this.sleep(retryDelay);
@@ -185,7 +187,9 @@ class EkoDBClient {
         }
         catch (error) {
             // Handle network errors with retry
-            if (error instanceof TypeError && this.shouldRetry && attempt < this.maxRetries) {
+            if (error instanceof TypeError &&
+                this.shouldRetry &&
+                attempt < this.maxRetries) {
                 const retryDelay = 3;
                 console.log(`Network error. Retrying after ${retryDelay} seconds...`);
                 await this.sleep(retryDelay);
@@ -202,7 +206,7 @@ class EkoDBClient {
         if (ttl) {
             data.ttl_duration = ttl;
         }
-        return this.makeRequest('POST', `/api/insert/${collection}`, data);
+        return this.makeRequest("POST", `/api/insert/${collection}`, data);
     }
     /**
      * Find documents in a collection
@@ -228,80 +232,80 @@ class EkoDBClient {
      */
     async find(collection, query = {}) {
         const queryObj = query instanceof query_builder_1.QueryBuilder ? query.build() : query;
-        return this.makeRequest('POST', `/api/find/${collection}`, queryObj);
+        return this.makeRequest("POST", `/api/find/${collection}`, queryObj);
     }
     /**
      * Find a document by ID
      */
     async findByID(collection, id) {
-        return this.makeRequest('GET', `/api/find/${collection}/${id}`);
+        return this.makeRequest("GET", `/api/find/${collection}/${id}`);
     }
     /**
      * Update a document
      */
     async update(collection, id, record) {
-        return this.makeRequest('PUT', `/api/update/${collection}/${id}`, record);
+        return this.makeRequest("PUT", `/api/update/${collection}/${id}`, record);
     }
     /**
      * Delete a document
      */
     async delete(collection, id) {
-        await this.makeRequest('DELETE', `/api/delete/${collection}/${id}`);
+        await this.makeRequest("DELETE", `/api/delete/${collection}/${id}`);
     }
     /**
      * Batch insert multiple documents
      */
     async batchInsert(collection, records) {
-        const inserts = records.map(data => ({ data }));
-        const result = await this.makeRequest('POST', `/api/batch/insert/${collection}`, { inserts });
-        return result.successful.map(id => ({ id }));
+        const inserts = records.map((data) => ({ data }));
+        const result = await this.makeRequest("POST", `/api/batch/insert/${collection}`, { inserts });
+        return result.successful.map((id) => ({ id }));
     }
     /**
      * Batch update multiple documents
      */
     async batchUpdate(collection, updates) {
-        const result = await this.makeRequest('PUT', `/api/batch/update/${collection}`, { updates });
-        return result.successful.map(id => ({ id }));
+        const result = await this.makeRequest("PUT", `/api/batch/update/${collection}`, { updates });
+        return result.successful.map((id) => ({ id }));
     }
     /**
      * Batch delete multiple documents
      */
     async batchDelete(collection, ids) {
-        const deletes = ids.map(id => ({ id }));
-        const result = await this.makeRequest('DELETE', `/api/batch/delete/${collection}`, { deletes });
+        const deletes = ids.map((id) => ({ id }));
+        const result = await this.makeRequest("DELETE", `/api/batch/delete/${collection}`, { deletes });
         return result.successful.length;
     }
     /**
      * Set a key-value pair
      */
     async kvSet(key, value) {
-        await this.makeRequest('POST', `/api/kv/set/${encodeURIComponent(key)}`, { value });
+        await this.makeRequest("POST", `/api/kv/set/${encodeURIComponent(key)}`, { value });
     }
     /**
      * Get a value by key
      */
     async kvGet(key) {
-        const result = await this.makeRequest('GET', `/api/kv/get/${encodeURIComponent(key)}`);
+        const result = await this.makeRequest("GET", `/api/kv/get/${encodeURIComponent(key)}`);
         return result.value;
     }
     /**
      * Delete a key
      */
     async kvDelete(key) {
-        await this.makeRequest('DELETE', `/api/kv/delete/${encodeURIComponent(key)}`);
+        await this.makeRequest("DELETE", `/api/kv/delete/${encodeURIComponent(key)}`);
     }
     /**
      * List all collections
      */
     async listCollections() {
-        const result = await this.makeRequest('GET', '/api/collections');
+        const result = await this.makeRequest("GET", "/api/collections");
         return result.collections;
     }
     /**
      * Delete a collection
      */
     async deleteCollection(collection) {
-        await this.makeRequest('DELETE', `/api/collections/${collection}`);
+        await this.makeRequest("DELETE", `/api/collections/${collection}`);
     }
     /**
      * Create a collection with schema
@@ -321,7 +325,7 @@ class EkoDBClient {
      */
     async createCollection(collection, schema) {
         const schemaObj = schema instanceof schema_1.SchemaBuilder ? schema.build() : schema;
-        await this.makeRequest('POST', `/api/collections/${collection}`, schemaObj);
+        await this.makeRequest("POST", `/api/collections/${collection}`, schemaObj);
     }
     /**
      * Get collection metadata and schema
@@ -330,7 +334,7 @@ class EkoDBClient {
      * @returns Collection metadata including schema and analytics
      */
     async getCollection(collection) {
-        return this.makeRequest('GET', `/api/collections/${collection}`);
+        return this.makeRequest("GET", `/api/collections/${collection}`);
     }
     /**
      * Get collection schema
@@ -376,27 +380,29 @@ class EkoDBClient {
      * ```
      */
     async search(collection, searchQuery) {
-        const queryObj = searchQuery instanceof search_1.SearchQueryBuilder ? searchQuery.build() : searchQuery;
-        return this.makeRequest('POST', `/api/search/${collection}`, queryObj);
+        const queryObj = searchQuery instanceof search_1.SearchQueryBuilder
+            ? searchQuery.build()
+            : searchQuery;
+        return this.makeRequest("POST", `/api/search/${collection}`, queryObj);
     }
     // ========== Chat Methods ==========
     /**
      * Create a new chat session
      */
     async createChatSession(request) {
-        return this.makeRequest('POST', '/api/chat', request);
+        return this.makeRequest("POST", "/api/chat", request);
     }
     /**
      * Send a message in an existing chat session
      */
     async chatMessage(sessionId, request) {
-        return this.makeRequest('POST', `/api/chat/${sessionId}/messages`, request);
+        return this.makeRequest("POST", `/api/chat/${sessionId}/messages`, request);
     }
     /**
      * Get a chat session by ID
      */
     async getChatSession(sessionId) {
-        return this.makeRequest('GET', `/api/chat/${sessionId}`);
+        return this.makeRequest("GET", `/api/chat/${sessionId}`);
     }
     /**
      * List all chat sessions
@@ -404,14 +410,14 @@ class EkoDBClient {
     async listChatSessions(query) {
         const params = new URLSearchParams();
         if (query?.limit)
-            params.append('limit', query.limit.toString());
+            params.append("limit", query.limit.toString());
         if (query?.skip)
-            params.append('skip', query.skip.toString());
+            params.append("skip", query.skip.toString());
         if (query?.sort)
-            params.append('sort', query.sort);
+            params.append("sort", query.sort);
         const queryString = params.toString();
-        const path = queryString ? `/api/chat?${queryString}` : '/api/chat';
-        return this.makeRequest('GET', path);
+        const path = queryString ? `/api/chat?${queryString}` : "/api/chat";
+        return this.makeRequest("GET", path);
     }
     /**
      * Get messages from a chat session
@@ -419,62 +425,64 @@ class EkoDBClient {
     async getChatSessionMessages(sessionId, query) {
         const params = new URLSearchParams();
         if (query?.limit)
-            params.append('limit', query.limit.toString());
+            params.append("limit", query.limit.toString());
         if (query?.skip)
-            params.append('skip', query.skip.toString());
+            params.append("skip", query.skip.toString());
         if (query?.sort)
-            params.append('sort', query.sort);
+            params.append("sort", query.sort);
         const queryString = params.toString();
-        const path = queryString ? `/api/chat/${sessionId}/messages?${queryString}` : `/api/chat/${sessionId}/messages`;
-        return this.makeRequest('GET', path);
+        const path = queryString
+            ? `/api/chat/${sessionId}/messages?${queryString}`
+            : `/api/chat/${sessionId}/messages`;
+        return this.makeRequest("GET", path);
     }
     /**
      * Update a chat session
      */
     async updateChatSession(sessionId, request) {
-        return this.makeRequest('PUT', `/api/chat/${sessionId}`, request);
+        return this.makeRequest("PUT", `/api/chat/${sessionId}`, request);
     }
     /**
      * Branch a chat session
      */
     async branchChatSession(request) {
-        return this.makeRequest('POST', '/api/chat/branch', request);
+        return this.makeRequest("POST", "/api/chat/branch", request);
     }
     /**
      * Delete a chat session
      */
     async deleteChatSession(sessionId) {
-        await this.makeRequest('DELETE', `/api/chat/${sessionId}`);
+        await this.makeRequest("DELETE", `/api/chat/${sessionId}`);
     }
     /**
      * Regenerate an AI response message
      */
     async regenerateMessage(sessionId, messageId) {
-        return this.makeRequest('POST', `/api/chat/${sessionId}/messages/${messageId}/regenerate`);
+        return this.makeRequest("POST", `/api/chat/${sessionId}/messages/${messageId}/regenerate`);
     }
     /**
      * Update a specific message
      */
     async updateChatMessage(sessionId, messageId, content) {
-        await this.makeRequest('PUT', `/api/chat/${sessionId}/messages/${messageId}`, { content });
+        await this.makeRequest("PUT", `/api/chat/${sessionId}/messages/${messageId}`, { content });
     }
     /**
      * Delete a specific message
      */
     async deleteChatMessage(sessionId, messageId) {
-        await this.makeRequest('DELETE', `/api/chat/${sessionId}/messages/${messageId}`);
+        await this.makeRequest("DELETE", `/api/chat/${sessionId}/messages/${messageId}`);
     }
     /**
      * Toggle the "forgotten" status of a message
      */
     async toggleForgottenMessage(sessionId, messageId, forgotten) {
-        await this.makeRequest('PATCH', `/api/chat/${sessionId}/messages/${messageId}/forgotten`, { forgotten });
+        await this.makeRequest("PATCH", `/api/chat/${sessionId}/messages/${messageId}/forgotten`, { forgotten });
     }
     /**
      * Merge multiple chat sessions into one
      */
     async mergeChatSessions(request) {
-        return this.makeRequest('POST', '/api/chat/merge', request);
+        return this.makeRequest("POST", "/api/chat/merge", request);
     }
     /**
      * Create a WebSocket client
@@ -500,19 +508,19 @@ class WebSocketClient {
         if (this.ws)
             return;
         // Dynamic import for Node.js WebSocket
-        const WebSocket = (await Promise.resolve().then(() => __importStar(require('ws')))).default;
+        const WebSocket = (await Promise.resolve().then(() => __importStar(require("ws")))).default;
         let url = this.wsURL;
-        if (!url.endsWith('/api/ws')) {
-            url += '/api/ws';
+        if (!url.endsWith("/api/ws")) {
+            url += "/api/ws";
         }
         this.ws = new WebSocket(url, {
             headers: {
-                'Authorization': `Bearer ${this.token}`,
+                Authorization: `Bearer ${this.token}`,
             },
         });
         return new Promise((resolve, reject) => {
-            this.ws.on('open', () => resolve());
-            this.ws.on('error', (err) => reject(err));
+            this.ws.on("open", () => resolve());
+            this.ws.on("error", (err) => reject(err));
         });
     }
     /**
@@ -522,22 +530,22 @@ class WebSocketClient {
         await this.connect();
         const messageId = Date.now().toString();
         const request = {
-            type: 'FindAll',
+            type: "FindAll",
             messageId,
             payload: { collection },
         };
         return new Promise((resolve, reject) => {
             this.ws.send(JSON.stringify(request));
-            this.ws.once('message', (data) => {
+            this.ws.once("message", (data) => {
                 const response = JSON.parse(data.toString());
-                if (response.type === 'Error') {
+                if (response.type === "Error") {
                     reject(new Error(response.message));
                 }
                 else {
                     resolve(response.payload?.data || []);
                 }
             });
-            this.ws.once('error', reject);
+            this.ws.once("error", reject);
         });
     }
     /**

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { EkoDBClient, WebSocketClient, MergeStrategy, RateLimitError } from './client';
-export { QueryBuilder, SortOrder } from './query-builder';
-export { SearchQueryBuilder } from './search';
-export { SchemaBuilder, FieldTypeSchemaBuilder, VectorIndexAlgorithm, DistanceMetric } from './schema';
-export { JoinBuilder } from './join';
-export type { SearchQuery, SearchResult, SearchResponse } from './search';
-export type { Schema, FieldTypeSchema, IndexConfig, CollectionMetadata } from './schema';
-export type { JoinConfig } from './join';
-export type { Record, Query, BatchOperationResult, ClientConfig, RateLimitInfo, CollectionConfig, ChatRequest, CreateChatSessionRequest, ChatMessageRequest, TokenUsage, ChatResponse, ChatSession, ChatSessionResponse, ListSessionsQuery, ListSessionsResponse, GetMessagesQuery, GetMessagesResponse, UpdateSessionRequest, MergeSessionsRequest } from './client';
+export { EkoDBClient, WebSocketClient, MergeStrategy, RateLimitError, } from "./client";
+export { QueryBuilder, SortOrder } from "./query-builder";
+export { SearchQueryBuilder } from "./search";
+export { SchemaBuilder, FieldTypeSchemaBuilder, VectorIndexAlgorithm, DistanceMetric, } from "./schema";
+export { JoinBuilder } from "./join";
+export type { SearchQuery, SearchResult, SearchResponse } from "./search";
+export type { Schema, FieldTypeSchema, IndexConfig, CollectionMetadata, } from "./schema";
+export type { JoinConfig } from "./join";
+export type { Record, Query, BatchOperationResult, ClientConfig, RateLimitInfo, CollectionConfig, ChatRequest, CreateChatSessionRequest, ChatMessageRequest, TokenUsage, ChatResponse, ChatSession, ChatSessionResponse, ListSessionsQuery, ListSessionsResponse, GetMessagesQuery, GetMessagesResponse, UpdateSessionRequest, MergeSessionsRequest, } from "./client";

package/dist/schema.js

@@ -159,7 +159,8 @@ class SchemaBuilder {
      * Add a field to the schema
      */
     addField(name, field) {
-        this.schema.fields[name] = field instanceof FieldTypeSchemaBuilder ? field.build() : field;
+        this.schema.fields[name] =
+            field instanceof FieldTypeSchemaBuilder ? field.build() : field;
         return this;
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekodb/ekodb-client",
-  "version": "0.1.0",
+  "version": "0.1.7",
   "description": "Official TypeScript/JavaScript client for ekoDB",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",