chain-db-ts 1.0.0-rc.3 → 1.0.0-rc.4

package/features/table.js

@@ -34,43 +34,49 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
-import axios from 'axios';
 import { FIND_WHERE_ADVANCED, FIND_WHERE_BASIC, GET_HISTORY, GET_TABLE, PERSIST_NEW_DATA, GET_DOC } from './constants';
-import { post } from './utils';
+import { get, post } from './utils';
 import { TableDocImpl } from './table-doc';
 var Table = /** @class */ (function () {
     function Table(name, db) {
+        /**
+         * The current document data
+         */
+        // private currentDoc: Model
         this.name = '';
-        this.currentDoc = {};
+        // this.currentDoc = {} as Model
         this.name = name;
         this.db = db;
     }
     /**
-     * Persist table's document data changes
+     * Create a new document in the table
      */
-    Table.prototype.persist = function () {
+    Table.prototype["new"] = function (data) {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
             var url, body, response, e_1;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
                         url = "".concat(this.db.server).concat(PERSIST_NEW_DATA(this.name));
                         body = {
-                            data: this.currentDoc
+                            data: data
                         };
-                        _a.label = 1;
+                        _b.label = 1;
                     case 1:
-                        _a.trys.push([1, 3, , 4]);
+                        _b.trys.push([1, 3, , 4]);
                         return [4 /*yield*/, post(url, body, this.db.auth)];
                     case 2:
-                        response = _a.sent();
+                        response = _b.sent();
                         if (!response.data.success) {
                             throw new Error(response.data.message);
                         }
-                        return [2 /*return*/, response.data.data];
+                        // Create a TableDoc instance with the document data
+                        return [2 /*return*/, new TableDocImpl(this.name, (_a = response.data.data) === null || _a === void 0 ? void 0 : _a.doc_id, response.data.data, this.db)];
                     case 3:
-                        e_1 = _a.sent();
-                        throw new Error("Something went wrong with persist operation: ".concat(e_1.message || String(e_1)));
+                        e_1 = _b.sent();
+                        // throw new Error(`Something went wrong with persist operation: ${e.message || String(e)}`)
+                        throw new Error(e_1);
                     case 4: return [2 /*return*/];
                 }
             });
@@ -79,11 +85,13 @@ var Table = /** @class */ (function () {
     /**
      * Get the history of changes. A list of transactions from the most recent to the most old
      * in a range of depth
-     * @param limit
+     * @param limit Maximum number of items to return (default: 100)
      */
     Table.prototype.getHistory = function (limit) {
+        if (limit === void 0) { limit = 100; }
         return __awaiter(this, void 0, void 0, function () {
-            var url, response, e_2;
+            var url, response, history, e_2;
+            var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -91,54 +99,47 @@ var Table = /** @class */ (function () {
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, axios.get(url, { headers: { Authorization: "Basic ".concat(this.db.auth) } })];
+                        return [4 /*yield*/, get(url, this.db.auth)];
                     case 2:
                         response = _a.sent();
                         if (!response.data.success) {
                             throw new Error(response.data.message);
                         }
-                        // Return data. Only table fields, e.g.: [{fieldA: 'Hi', filedB: 22}]
-                        return [2 /*return*/, response.data.data];
+                        history = response.data.data;
+                        return [2 /*return*/, history.map(function (item) { return new TableDocImpl(_this.name, item.doc_id, item, _this.db); })];
                     case 3:
                         e_2 = _a.sent();
-                        throw new Error("Something went wrong with getHistory operation: ".concat(e_2.message || String(e_2)));
+                        // throw new Error(`Something went wrong with getHistory operation: ${e.message || String(e)}`)
+                        throw new Error(e_2);
                     case 4: return [2 /*return*/];
                 }
             });
         });
     };
     /**
-     * Refetch the table data
+     * Get the last record stored in the table
      */
-    Table.prototype.refetch = function () {
+    Table.prototype.last = function () {
+        var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var url, response, e_3;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
+            var url, response, data;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
                     case 0:
                         url = "".concat(this.db.server).concat(GET_TABLE(this.name));
-                        _a.label = 1;
+                        return [4 /*yield*/, get(url, this.db.auth)
+                            // this.currentDoc = response.data.data ? (response.data.data as DocId<Model>) : ({} as DocId<Model>)
+                            // return this.currentDoc
+                            // Create a TableDoc instance with the document data
+                        ];
                     case 1:
-                        _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, axios.get(url, { headers: { Authorization: "Basic ".concat(this.db.auth) } })];
-                    case 2:
-                        response = _a.sent();
-                        this.currentDoc = response.data.data ? response.data.data : {};
-                        return [3 /*break*/, 4];
-                    case 3:
-                        e_3 = _a.sent();
-                        throw new Error("Something went wrong with refetch operation: ".concat(e_3.message || String(e_3)));
-                    case 4: return [2 /*return*/];
+                        response = _b.sent();
+                        data = response.data.data ? response.data.data : {};
+                        return [2 /*return*/, new TableDocImpl(this.name, (_a = response.data.data) === null || _a === void 0 ? void 0 : _a.doc_id, data, this.db)];
                 }
             });
         });
     };
-    /**
-     * Check if the table is empty
-     */
-    Table.prototype.isEmpty = function () {
-        return Object.keys(this.currentDoc).length === 0;
-    };
     /**
      * Get the table's name
      */
@@ -149,7 +150,7 @@ var Table = /** @class */ (function () {
      * Find items in the table using basic criteria with exact matches
      * @param criteria Object with fields and values to match exactly, e.g.: {age: 44, name: "john"}
      * @param limit Maximum number of items to return (default: 1000)
-     * @param reverse If true, returns items in reverse order (default: true)
+     * @param reverse If true, returns items in reverse order, newer items first (default: true)
      * @returns Array of found items matching the criteria
      * @example
      * // Find items where age is 44
@@ -169,7 +170,8 @@ var Table = /** @class */ (function () {
         if (limit === void 0) { limit = 1000; }
         if (reverse === void 0) { reverse = true; }
         return __awaiter(this, void 0, void 0, function () {
-            var url, body, response, e_4;
+            var url, body, response, foundData, e_3;
+            var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -188,18 +190,43 @@ var Table = /** @class */ (function () {
                         if (!response.data.success) {
                             throw new Error(response.data.message);
                         }
-                        // Return found data. Only table fields, e.g.: [{fieldA: 'Hi', filedB: 22}]
-                        return [2 /*return*/, response.data.data];
+                        foundData = response.data.data;
+                        return [2 /*return*/, foundData.map(function (item) { return new TableDocImpl(_this.name, item.doc_id, item, _this.db); })];
                     case 3:
-                        e_4 = _a.sent();
-                        throw new Error("Something went wrong with findWhere operation: ".concat(e_4.message || String(e_4)));
+                        e_3 = _a.sent();
+                        // throw new Error(`Something went wrong with findWhere operation: ${e.message || String(e)}`)
+                        throw new Error(e_3);
                     case 4: return [2 /*return*/];
                 }
             });
         });
     };
     /**
-     * Find items in the table using advanced criteria with operators
+     * Find the first item in the table using basic criteria with exact matches
+     * @param criteria Object with fields and values to match exactly, e.g.: {age: 44, name: "john"}
+     * @param reverse If true, returns items in reverse order, newer items first (default: true)
+     * @returns The first found item matching the criteria or null if no item is found
+     */
+    Table.prototype.find = function (criteria, reverse) {
+        if (reverse === void 0) { reverse = true; }
+        return __awaiter(this, void 0, void 0, function () {
+            var found, data;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.findWhere(criteria, 1, reverse)];
+                    case 1:
+                        found = _a.sent();
+                        if (found.length === 0) {
+                            data = {};
+                            return [2 /*return*/, new TableDocImpl(this.name, '', data, this.db)];
+                        }
+                        return [2 /*return*/, found[0]];
+                }
+            });
+        });
+    };
+    /**
+     * Find the first item in the table using advanced criteria with operators
      * @param criteria Array of criteria to filter items. Each criteria contains:
      * - field: The field name to filter
      * - operator: The operator to use in comparison. Available operators:
@@ -214,7 +241,7 @@ var Table = /** @class */ (function () {
      *   - EndsWith: Check if field ends with value (for strings)
      * - value: The value to compare against
      * @param limit Maximum number of items to return (default: 1000)
-     * @param reverse If true, returns items in reverse order (default: true)
+     * @param reverse If true, returns items in reverse order, newer items first (default: true)
      * @returns Array of found items matching the criteria
      * @example
      * // Find items where greeting contains "arg"
@@ -230,7 +257,8 @@ var Table = /** @class */ (function () {
         if (limit === void 0) { limit = 1000; }
         if (reverse === void 0) { reverse = true; }
         return __awaiter(this, void 0, void 0, function () {
-            var url, body, response, e_5;
+            var url, body, response, foundData, e_4;
+            var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -249,32 +277,70 @@ var Table = /** @class */ (function () {
                         if (!response.data.success) {
                             throw new Error(response.data.message);
                         }
-                        // Return found data. Only table fields, e.g.: [{fieldA: 'Hi', filedB: 22}]
-                        return [2 /*return*/, response.data.data];
+                        foundData = response.data.data;
+                        return [2 /*return*/, foundData.map(function (item) { return new TableDocImpl(_this.name, item.doc_id, item, _this.db); })];
                     case 3:
-                        e_5 = _a.sent();
-                        throw new Error("Something went wrong with findWhereAdvanced operation: ".concat(e_5.message || String(e_5)));
+                        e_4 = _a.sent();
+                        // throw new Error(`Something went wrong with findWhereAdvanced operation: ${e.message || String(e)}`)
+                        throw new Error(e_4);
                     case 4: return [2 /*return*/];
                 }
             });
         });
     };
     /**
-     * Get the current document ID
+     * Find the first single item in the table using advanced criteria with operators
+     * @param criteria Array of criteria to filter items. Each criteria contains:
+     * - field: The field name to filter
+     * - operator: The operator to use in comparison. Available operators:
+     *   - Eq (==) Equal
+     *   - Ne (!=) Not Equal
+     *   - Gt (>) Greater Than
+     *   - Ge (>=) Greater Than or Equal
+     *   - Lt (<) Less Than
+     *   - Le (<=) Less Than or Equal
+     *   - Contains: Check if field contains value (for strings and arrays)
+     *   - StartsWith: Check if field starts with value (for strings)
+     *   - EndsWith: Check if field ends with value (for strings)
+     * - value: The value to compare against
+     * @param reverse If true, returns items in reverse order, newer items first (default: true)
+     * @returns The first found item matching the criteria or null if no item is found
+     * @example
+     * // Find items where greeting contains "arg"
+     * table.findAdvanced([
+     *   {
+     *     field: "greeting",
+     *     operator: Operators.Contains,
+     *     value: "hello"
+     *   }
+     * ])
      */
-    Table.prototype.getCurrentDocId = function () {
-        var _doc = this.currentDoc;
-        // Support to applications using older versions
-        return _doc.doc_id ? _doc.doc_id : '';
+    Table.prototype.findAdvanced = function (criteria, reverse) {
+        if (reverse === void 0) { reverse = true; }
+        return __awaiter(this, void 0, void 0, function () {
+            var found, data;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.findWhereAdvanced(criteria, 1, reverse)];
+                    case 1:
+                        found = _a.sent();
+                        if (found.length === 0) {
+                            data = {};
+                            return [2 /*return*/, new TableDocImpl(this.name, '', data, this.db)];
+                        }
+                        return [2 /*return*/, found[0]];
+                }
+            });
+        });
     };
     /**
      * Get a specific document by its ID
      * @param doc_id The document ID to retrieve
      * @returns A TableDoc instance with the specific document data
      */
-    Table.prototype.getDoc = function (doc_id) {
+    Table.prototype.getByDocId = function (doc_id) {
         return __awaiter(this, void 0, void 0, function () {
-            var url, response, e_6;
+            var url, response, e_5;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -282,7 +348,7 @@ var Table = /** @class */ (function () {
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, axios.get(url, { headers: { Authorization: "Basic ".concat(this.db.auth) } })];
+                        return [4 /*yield*/, get(url, this.db.auth)];
                     case 2:
                         response = _a.sent();
                         if (!response.data.success) {
@@ -291,8 +357,9 @@ var Table = /** @class */ (function () {
                         // Create a TableDoc instance with the document data
                         return [2 /*return*/, new TableDocImpl(this.name, doc_id, response.data.data, this.db)];
                     case 3:
-                        e_6 = _a.sent();
-                        throw new Error("Something went wrong with getDoc operation: ".concat(e_6.message || String(e_6)));
+                        e_5 = _a.sent();
+                        // throw new Error(`Something went wrong with getDoc operation: ${e.message || String(e)}`)
+                        throw new Error(e_5);
                     case 4: return [2 /*return*/];
                 }
             });

package/features/types.d.ts

@@ -9,6 +9,11 @@ export type Connection = {
     user: string;
     password: string;
 };
+export type ConnectionWithToken = {
+    server: string | null;
+    database: string;
+    token: string;
+};
 export type Criteria<Model> = Partial<Record<keyof Model, string | number | boolean>>;
 export type CriteriaAdvanced<Model> = {
     field: Partial<keyof Model>;

package/features/utils.d.ts

@@ -1,2 +1,3 @@
 import { BasicResponse } from './types';
-export declare const post: (url: string, body: any, auth?: string) => Promise<import("axios").AxiosResponse<BasicResponse<any>, any>>;
+export declare const post: (url: string, body: any, auth?: string) => Promise<import("axios").AxiosResponse<BasicResponse<any>, any, {}>>;
+export declare const get: (url: string, auth?: string) => Promise<import("axios").AxiosResponse<BasicResponse<any>, any, {}>>;

package/features/utils.js

@@ -1,7 +1,14 @@
 import axios from 'axios';
+// Using Axios
 export var post = function (url, body, auth) {
     if (auth === void 0) { auth = ''; }
     return axios.post(url, body, {
         headers: { 'content-type': 'application/json', Authorization: "Basic ".concat(auth) }
     });
 };
+export var get = function (url, auth) {
+    if (auth === void 0) { auth = ''; }
+    return axios.get(url, {
+        headers: { Authorization: "Basic ".concat(auth) }
+    });
+};

package/index.d.ts

@@ -1,4 +1,5 @@
-export { ChainDB, connect } from './features/chain-db';
+export { ChainDB, connect, connectWithToken } from './features/chain-db';
 export { BasicResponse, Operators, CriteriaAdvanced, Criteria, TableDoc, EventTypes, EventData, EventCallback, } from './features/types';
 export { default as Events } from './features/events';
 export { TableDocImpl } from './features/table-doc';
+export { default as Table } from './features/table';

package/index.js

@@ -1,4 +1,5 @@
-export { ChainDB, connect } from './features/chain-db';
+export { ChainDB, connect, connectWithToken } from './features/chain-db';
 export { Operators, EventTypes, } from './features/types';
 export { default as Events } from './features/events';
 export { TableDocImpl } from './features/table-doc';
+export { default as Table } from './features/table';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chain-db-ts",
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.4",
   "description": "Chain DB Client for Javascript/Typescript Node apps.",
   "main": "./dist/cjs/index.js",
   "module": "./index.js",