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

package/.nvmrc

@@ -0,0 +1 @@
+18.0.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.0-rc.3] - 2025-03-11
+
+### Changed
+
+- Added support to older version while using the `getCurrentDocId()` method.
+
 ## [1.0.0-rc.2] - 2025-03-05
 
 ### Added

package/dist/cjs/features/chain-db.d.ts

@@ -1,5 +1,5 @@
 import Table from './table';
-import { Connection, EventCallback } from './types';
+import { Connection, ConnectionWithToken, EventCallback } from './types';
 export declare class ChainDB {
     server: string;
     database: string;
@@ -13,10 +13,15 @@ export declare class ChainDB {
      * @param password  Password to access the data base
      */
     connect(connection: Connection): Promise<void>;
+    /**
+     * Connect to Chain DB with a token (Synchronously). This is useful if you don't want to use a promise to connect to Chain DB.
+     * @param connection Connection information with token
+     */
+    connectWithToken(connection: ConnectionWithToken): void;
     /**
      * Initialize a table, fetching its more updated data
      */
-    getTable<Model>(table_name: string): Promise<Table<Model>>;
+    getTable<Model>(table_name: string): Table<Model>;
     events(): {
         /**
          * Subscribe to an event
@@ -37,3 +42,4 @@ export declare class ChainDB {
     };
 }
 export declare const connect: (connection: Connection) => Promise<ChainDB>;
+export declare const connectWithToken: (connection: ConnectionWithToken) => ChainDB;

package/dist/cjs/features/chain-db.js

@@ -39,7 +39,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 exports.__esModule = true;
-exports.connect = exports.ChainDB = void 0;
+exports.connectWithToken = exports.connect = exports.ChainDB = void 0;
 var constants_1 = require("./constants");
 var utils_1 = require("./utils");
 var table_1 = __importDefault(require("./table"));
@@ -90,44 +90,43 @@ var ChainDB = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Connect to Chain DB with a token (Synchronously). This is useful if you don't want to use a promise to connect to Chain DB.
+     * @param connection Connection information with token
+     */
+    ChainDB.prototype.connectWithToken = function (connection) {
+        var server = connection.server, database = connection.database, token = connection.token;
+        this.server = server || constants_1.DEFAULT_API_SERVER;
+        this.database = database;
+        this.auth = token;
+    };
     /**
      * Initialize a table, fetching its more updated data
      */
     ChainDB.prototype.getTable = function (table_name) {
-        return __awaiter(this, void 0, void 0, function () {
-            var tableData;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        tableData = new table_1["default"](table_name, this);
-                        return [4 /*yield*/, tableData.refetch()];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/, tableData
-                            // const table_data = await table.get<Model>(this, table_name, model)
-                            // NOTE: Although only the "table" and "persist" properties are displayed by
-                            // the lint, all Table properties are being exposed.
-                            // This is due to a javascript limitation on classes.
-                            //
-                            // There was an attempt to return a new object with only the required
-                            // data, but this generates an error in the "this" instance of the Table.
-                            // return table_data as {
-                            //   table: Model
-                            //   /**
-                            //    * Persist table data on chain
-                            //    */
-                            //   persist: () => Promise<void>
-                            //   /**
-                            //    * Get the history of changes. A list of transactions from the most recent to the most old
-                            //    * in a range of depth
-                            //    * @param depth
-                            //    */
-                            //   getHistory: (depth: number) => Promise<Model[]>
-                            // }
-                        ];
-                }
-            });
-        });
+        var tableData = new table_1["default"](table_name, this);
+        // await tableData.refetch()
+        return tableData;
+        // const table_data = await table.get<Model>(this, table_name, model)
+        // NOTE: Although only the "table" and "persist" properties are displayed by
+        // the lint, all Table properties are being exposed.
+        // This is due to a javascript limitation on classes.
+        //
+        // There was an attempt to return a new object with only the required
+        // data, but this generates an error in the "this" instance of the Table.
+        // return table_data as {
+        //   table: Model
+        //   /**
+        //    * Persist table data on chain
+        //    */
+        //   persist: () => Promise<void>
+        //   /**
+        //    * Get the history of changes. A list of transactions from the most recent to the most old
+        //    * in a range of depth
+        //    * @param depth
+        //    */
+        //   getHistory: (depth: number) => Promise<Model[]>
+        // }
     };
     ChainDB.prototype.events = function () {
         var _this = this;
@@ -182,3 +181,9 @@ var connect = function (connection) { return __awaiter(void 0, void 0, void 0, f
     });
 }); };
 exports.connect = connect;
+var connectWithToken = function (connection) {
+    var chainDb = new ChainDB();
+    chainDb.connectWithToken(connection);
+    return chainDb;
+};
+exports.connectWithToken = connectWithToken;

package/dist/cjs/features/table-doc.js

@@ -35,12 +35,8 @@ 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 };
     }
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 exports.__esModule = true;
 exports.TableDocImpl = void 0;
-var axios_1 = __importDefault(require("axios"));
 var constants_1 = require("./constants");
 var utils_1 = require("./utils");
 /**
@@ -81,7 +77,8 @@ var TableDocImpl = /** @class */ (function () {
                         return [3 /*break*/, 4];
                     case 3:
                         e_1 = _a.sent();
-                        throw new Error("Something went wrong updating document ".concat(this.doc_id, ": ").concat(e_1.message || String(e_1)));
+                        // throw new Error(`Something went wrong updating document ${this.doc_id}: ${e.message || String(e)}`)
+                        throw new Error(e_1);
                     case 4: return [2 /*return*/];
                 }
             });
@@ -101,7 +98,7 @@ var TableDocImpl = /** @class */ (function () {
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, axios_1["default"].get(url, { headers: { Authorization: "Basic ".concat(this.db.auth) } })];
+                        return [4 /*yield*/, (0, utils_1.get)(url, this.db.auth)];
                     case 2:
                         response = _a.sent();
                         if (!response.data.success) {
@@ -112,7 +109,8 @@ var TableDocImpl = /** @class */ (function () {
                         return [3 /*break*/, 4];
                     case 3:
                         e_2 = _a.sent();
-                        throw new Error("Something went wrong refetching document ".concat(this.doc_id, ": ").concat(e_2.message || String(e_2)));
+                        // throw new Error(`Something went wrong refetching document ${this.doc_id}: ${e.message || String(e)}`)
+                        throw new Error(e_2);
                     case 4: return [2 /*return*/];
                 }
             });

package/dist/cjs/features/table.d.ts

@@ -1,28 +1,27 @@
 import { ChainDB } from './chain-db';
 import { Criteria, CriteriaAdvanced, DocId, TableDoc } from './types';
+import { TableDocImpl } from './table-doc';
 declare class Table<Model> {
-    currentDoc: Model;
+    /**
+     * The current document data
+     */
     private name;
     private db;
     constructor(name: string, db: ChainDB);
     /**
-     * Persist table's document data changes
+     * Create a new document in the table
      */
-    persist(): Promise<DocId<Model>>;
+    new(data: Model): Promise<TableDoc<Model>>;
     /**
      * Get the history of changes. A list of transactions from the most recent to the most old
      * in a range of depth
-     * @param limit
-     */
-    getHistory(limit: number): Promise<DocId<Model>[]>;
-    /**
-     * Refetch the table data
+     * @param limit Maximum number of items to return (default: 100)
      */
-    refetch(): Promise<void>;
+    getHistory(limit?: number): Promise<TableDocImpl<DocId<Model>>[]>;
     /**
-     * Check if the table is empty
+     * Get the last record stored in the table
      */
-    isEmpty(): boolean;
+    last(): Promise<TableDocImpl<DocId<Model>>>;
     /**
      * Get the table's name
      */
@@ -31,7 +30,7 @@ declare class Table<Model> {
      * 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
@@ -47,9 +46,16 @@ declare class Table<Model> {
      *   score: 100
      * })
      */
-    findWhere(criteria: Criteria<Model>, limit?: number, reverse?: boolean): Promise<DocId<Model>[]>;
+    findWhere(criteria: Criteria<Model>, limit?: number, reverse?: boolean): Promise<TableDocImpl<DocId<Model>>[]>;
+    /**
+     * 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
+     */
+    find(criteria: Criteria<Model>, reverse?: boolean): Promise<TableDocImpl<DocId<Model>>>;
     /**
-     * Find items in the table using advanced criteria with operators
+     * 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:
@@ -64,7 +70,7 @@ declare class Table<Model> {
      *   - 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"
@@ -76,16 +82,40 @@ declare class Table<Model> {
      *   }
      * ])
      */
-    findWhereAdvanced(criteria: CriteriaAdvanced<Model>[], limit?: number, reverse?: boolean): Promise<DocId<Model>[]>;
+    findWhereAdvanced(criteria: CriteriaAdvanced<Model>[], limit?: number, reverse?: boolean): Promise<TableDocImpl<DocId<Model>>[]>;
     /**
-     * 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"
+     *   }
+     * ])
      */
-    getCurrentDocId(): string;
+    findAdvanced(criteria: CriteriaAdvanced<Model>[], reverse?: boolean): Promise<TableDocImpl<DocId<Model>>>;
     /**
      * Get a specific document by its ID
      * @param doc_id The document ID to retrieve
      * @returns A TableDoc instance with the specific document data
      */
-    getDoc(doc_id: string): Promise<TableDoc<Model>>;
+    getByDocId(doc_id: string): Promise<TableDoc<Model>>;
 }
 export default Table;

package/dist/cjs/features/table.js

@@ -35,47 +35,50 @@ 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 };
     }
 };
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 exports.__esModule = true;
-var axios_1 = __importDefault(require("axios"));
 var constants_1 = require("./constants");
 var utils_1 = require("./utils");
 var table_doc_1 = require("./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((0, constants_1.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*/, (0, utils_1.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 table_doc_1.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*/];
                 }
             });
@@ -84,11 +87,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:
@@ -96,54 +101,47 @@ var Table = /** @class */ (function () {
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, axios_1["default"].get(url, { headers: { Authorization: "Basic ".concat(this.db.auth) } })];
+                        return [4 /*yield*/, (0, utils_1.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 table_doc_1.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((0, constants_1.GET_TABLE)(this.name));
-                        _a.label = 1;
+                        return [4 /*yield*/, (0, utils_1.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_1["default"].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 table_doc_1.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
      */
@@ -154,7 +152,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
@@ -174,7 +172,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:
@@ -193,18 +192,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 table_doc_1.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 table_doc_1.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:
@@ -219,7 +243,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"
@@ -235,7 +259,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:
@@ -254,30 +279,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 table_doc_1.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 () {
-        return this.currentDoc.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 table_doc_1.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:
@@ -285,7 +350,7 @@ var Table = /** @class */ (function () {
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, axios_1["default"].get(url, { headers: { Authorization: "Basic ".concat(this.db.auth) } })];
+                        return [4 /*yield*/, (0, utils_1.get)(url, this.db.auth)];
                     case 2:
                         response = _a.sent();
                         if (!response.data.success) {
@@ -294,8 +359,9 @@ var Table = /** @class */ (function () {
                         // Create a TableDoc instance with the document data
                         return [2 /*return*/, new table_doc_1.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*/];
                 }
             });