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

package/dist/cjs/features/table.js

@@ -39,45 +39,43 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 exports.__esModule = true;
-exports.get = void 0;
 var axios_1 = __importDefault(require("axios"));
 var constants_1 = require("./constants");
-var types_1 = require("./types");
 var utils_1 = require("./utils");
+var table_doc_1 = require("./table-doc");
 var Table = /** @class */ (function () {
-    function Table(table, contract_id, db) {
-        this.contract_id = '';
-        this.table = table;
-        this.contract_id = contract_id;
+    function Table(name, db) {
+        this.name = '';
+        this.currentDoc = {};
+        this.name = name;
         this.db = db;
     }
     /**
-     * Persist table data on chain
+     * Persist table's document data changes
      */
     Table.prototype.persist = function () {
         return __awaiter(this, void 0, void 0, function () {
-            var url, contract_data, body, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            var url, body, response, e_1;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
                     case 0:
-                        url = "".concat(this.db.api).concat(constants_1.CONTRACT_TRANSACTION);
-                        contract_data = JSON.stringify(this.table);
+                        url = "".concat(this.db.server).concat((0, constants_1.PERSIST_NEW_DATA)(this.name));
                         body = {
-                            tx_type: types_1.TransactionType.CONTRACT,
-                            contract_id: this.contract_id,
-                            db_access_key: this.db.access_key,
-                            data: contract_data
+                            data: this.currentDoc
                         };
-                        _b.label = 1;
+                        _a.label = 1;
                     case 1:
-                        _b.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, (0, utils_1.post)(url, body)];
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, (0, utils_1.post)(url, body, this.db.auth)];
                     case 2:
-                        _b.sent();
-                        return [3 /*break*/, 4];
+                        response = _a.sent();
+                        if (!response.data.success) {
+                            throw new Error(response.data.message);
+                        }
+                        return [2 /*return*/, response.data.data];
                     case 3:
-                        _a = _b.sent();
-                        throw new Error('Something went wrong!');
+                        e_1 = _a.sent();
+                        throw new Error("Something went wrong with persist operation: ".concat(e_1.message || String(e_1)));
                     case 4: return [2 /*return*/];
                 }
             });
@@ -86,32 +84,218 @@ 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 depth
+     * @param limit
      */
-    Table.prototype.getHistory = function (depth) {
+    Table.prototype.getHistory = function (limit) {
         return __awaiter(this, void 0, void 0, function () {
-            var url, contract_response, contract_data_json_list, transaction_data, _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
+            var url, response, e_2;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
                     case 0:
-                        url = "".concat(this.db.api).concat(constants_1.CONTRACT_TRANSACTIONS_PAYLOAD, "/").concat(this.contract_id, "/").concat(this.db.access_key, "/").concat(depth);
-                        _b.label = 1;
+                        url = "".concat(this.db.server).concat((0, constants_1.GET_HISTORY)(this.name, limit));
+                        _a.label = 1;
                     case 1:
-                        _b.trys.push([1, 3, , 4]);
-                        return [4 /*yield*/, axios_1["default"].get(url)];
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, axios_1["default"].get(url, { headers: { Authorization: "Basic ".concat(this.db.auth) } })];
                     case 2:
-                        contract_response = _b.sent();
-                        contract_data_json_list = contract_response.data;
-                        transaction_data = contract_data_json_list.map(function (transaction) { return transaction.data; });
-                        // Return empty if theres no data
-                        if (contract_data_json_list.length === 1 && contract_data_json_list[0].tx_type === types_1.TransactionType.NONE) {
-                            return [2 /*return*/, []];
+                        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*/, transaction_data];
+                        return [2 /*return*/, response.data.data];
+                    case 3:
+                        e_2 = _a.sent();
+                        throw new Error("Something went wrong with getHistory operation: ".concat(e_2.message || String(e_2)));
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Refetch the table data
+     */
+    Table.prototype.refetch = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var url, response, e_3;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        url = "".concat(this.db.server).concat((0, constants_1.GET_TABLE)(this.name));
+                        _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) } })];
+                    case 2:
+                        response = _a.sent();
+                        this.currentDoc = response.data.data ? response.data.data : {};
+                        return [3 /*break*/, 4];
                     case 3:
-                        _a = _b.sent();
-                        throw new Error('Something went wrong!');
+                        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*/];
+                }
+            });
+        });
+    };
+    /**
+     * Check if the table is empty
+     */
+    Table.prototype.isEmpty = function () {
+        return Object.keys(this.currentDoc).length === 0;
+    };
+    /**
+     * Get the table's name
+     */
+    Table.prototype.getName = function () {
+        return this.name;
+    };
+    /**
+     * 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)
+     * @returns Array of found items matching the criteria
+     * @example
+     * // Find items where age is 44
+     * table.findWhere({
+     *   age: 44,
+     * })
+     *
+     * // Find items with multiple criteria
+     * table.findWhere({
+     *   age: 44,
+     *   name: "john",
+     *   active: true,
+     *   score: 100
+     * })
+     */
+    Table.prototype.findWhere = function (criteria, limit, reverse) {
+        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;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        url = "".concat(this.db.server).concat((0, constants_1.FIND_WHERE_BASIC)(this.name));
+                        body = {
+                            criteria: criteria,
+                            limit: limit,
+                            reverse: reverse
+                        };
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, (0, utils_1.post)(url, body, this.db.auth)];
+                    case 2:
+                        response = _a.sent();
+                        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];
+                    case 3:
+                        e_4 = _a.sent();
+                        throw new Error("Something went wrong with findWhere operation: ".concat(e_4.message || String(e_4)));
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Find items 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 limit Maximum number of items to return (default: 1000)
+     * @param reverse If true, returns items in reverse order (default: true)
+     * @returns Array of found items matching the criteria
+     * @example
+     * // Find items where greeting contains "arg"
+     * table.findWhereAdvanced([
+     *   {
+     *     field: "greeting",
+     *     operator: Operators.Contains,
+     *     value: "hello"
+     *   }
+     * ])
+     */
+    Table.prototype.findWhereAdvanced = function (criteria, limit, reverse) {
+        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;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        url = "".concat(this.db.server).concat((0, constants_1.FIND_WHERE_ADVANCED)(this.name));
+                        body = {
+                            criteria: criteria,
+                            limit: limit,
+                            reverse: reverse
+                        };
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, (0, utils_1.post)(url, body, this.db.auth)];
+                    case 2:
+                        response = _a.sent();
+                        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];
+                    case 3:
+                        e_5 = _a.sent();
+                        throw new Error("Something went wrong with findWhereAdvanced operation: ".concat(e_5.message || String(e_5)));
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /**
+     * Get the current document ID
+     */
+    Table.prototype.getCurrentDocId = function () {
+        return this.currentDoc.doc_id;
+    };
+    /**
+     * 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) {
+        return __awaiter(this, void 0, void 0, function () {
+            var url, response, e_6;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        url = "".concat(this.db.server).concat((0, constants_1.GET_DOC)(this.name, doc_id));
+                        _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) } })];
+                    case 2:
+                        response = _a.sent();
+                        if (!response.data.success) {
+                            throw new Error(response.data.message);
+                        }
+                        // 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)));
                     case 4: return [2 /*return*/];
                 }
             });
@@ -119,32 +303,4 @@ var Table = /** @class */ (function () {
     };
     return Table;
 }());
-var get = function (db, table_name, model) { return __awaiter(void 0, void 0, void 0, function () {
-    var contract_id, url, contract_response, contract_data_json, table_1, table, _a;
-    return __generator(this, function (_b) {
-        switch (_b.label) {
-            case 0:
-                contract_id = db.access.parse(db.name, table_name);
-                url = "".concat(db.api).concat(constants_1.CONTRACT_PAYLOAD, "/").concat(contract_id, "/").concat(db.access_key);
-                _b.label = 1;
-            case 1:
-                _b.trys.push([1, 3, , 4]);
-                return [4 /*yield*/, axios_1["default"].get(url)];
-            case 2:
-                contract_response = _b.sent();
-                contract_data_json = contract_response.data;
-                // If there's already a table (contract) with data, then, fetch its data
-                if (contract_data_json.tx_type === types_1.TransactionType.CONTRACT) {
-                    table_1 = new Table(contract_data_json.data, contract_id, db);
-                    return [2 /*return*/, table_1];
-                }
-                table = new Table(model, contract_id, db);
-                return [2 /*return*/, table];
-            case 3:
-                _a = _b.sent();
-                throw new Error('Something went wrong!');
-            case 4: return [2 /*return*/];
-        }
-    });
-}); };
-exports.get = get;
+exports["default"] = Table;

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

@@ -1,29 +1,87 @@
 export type BasicResponse<D> = {
     success: boolean;
-    error_msg: string;
+    message: string;
     data?: D;
 };
-export type SignedUserAccount = {
-    id: string;
-    user_name: string;
-    units: number;
+export type Connection = {
+    server: string | null;
+    database: string;
+    user: string;
+    password: string;
 };
-export type TransferUnitsRegistry = {
-    from: string;
-    to: string;
-    units: number;
+export type Criteria<Model> = Partial<Record<keyof Model, string | number | boolean>>;
+export type CriteriaAdvanced<Model> = {
+    field: Partial<keyof Model>;
+    /**
+     * @see Operators
+     */
+    operator: string;
+    value: string | number | boolean;
 };
-export declare enum TransactionType {
-    NONE = "NONE",
-    ACCOUNT = "ACCOUNT",
-    CONTRACT = "CONTRACT",
-    TRANSFER = "TRANSFER"
+/**
+ * Operators for the advanced criteria
+ * @see https://docs.chaindb.com/docs/query-language/ (TODO)
+ */
+export declare const Operators: {
+    EQUAL: string;
+    NOT_EQUAL: string;
+    GREATER_THAN: string;
+    GREATER_THAN_OR_EQUAL: string;
+    LESS_THAN: string;
+    LESS_THAN_OR_EQUAL: string;
+    CONTAINS: string;
+    STARTS_WITH: string;
+    ENDS_WITH: string;
+};
+export declare const EventTypes: {
+    TABLE_PERSIST: string;
+    TABLE_UPDATE: string;
+};
+export type EventData = {
+    event_type: string;
+    database: string;
+    table: string;
+    /**
+     * Data of the event (also to/from the table)
+     */
+    data: Record<string, any>;
+    /**
+     * Timestamp of the event
+     */
+    timestamp: number;
+};
+export type EventCallback = (data: EventData) => void;
+/**
+ * Represents a specific document from a table
+ * Contains only the necessary methods to work with a specific document
+ */
+export interface TableDoc<Model> {
+    /**
+     * The document data
+     */
+    doc: DocId<Model>;
+    /**
+     * Update the document data
+     * This will update the specific document without creating a new one
+     */
+    update(): Promise<void>;
+    /**
+     * Get the table name this document belongs to
+     */
+    getTableName(): string;
+    /**
+     * Refetch the document data from the database
+     * Useful when the document might have been updated by another application
+     */
+    refetch(): Promise<void>;
+    /**
+     * Check if the document is empty
+     */
+    isEmpty(): boolean;
 }
-export type ContractTransactionData<Model> = {
-    tx_type: TransactionType;
-    contract_id: string;
-    timestamp?: number;
-    data: Model;
-    block_hash: string;
-    block_height: number;
+export type DocId<Model> = Model & {
+    /**
+     * The document ID (unique identifier). Immutable.
+     */
+    readonly doc_id: string;
 };

package/dist/cjs/features/types.js

@@ -1,10 +1,32 @@
 "use strict";
 exports.__esModule = true;
-exports.TransactionType = void 0;
-var TransactionType;
-(function (TransactionType) {
-    TransactionType["NONE"] = "NONE";
-    TransactionType["ACCOUNT"] = "ACCOUNT";
-    TransactionType["CONTRACT"] = "CONTRACT";
-    TransactionType["TRANSFER"] = "TRANSFER";
-})(TransactionType = exports.TransactionType || (exports.TransactionType = {}));
+exports.EventTypes = exports.Operators = void 0;
+/**
+ * Operators for the advanced criteria
+ * @see https://docs.chaindb.com/docs/query-language/ (TODO)
+ */
+exports.Operators = {
+    // (==)
+    EQUAL: 'Eq',
+    // (!=)
+    NOT_EQUAL: 'Ne',
+    // (>)
+    GREATER_THAN: 'Gt',
+    // (>=)
+    GREATER_THAN_OR_EQUAL: 'Ge',
+    // (<)
+    LESS_THAN: 'Lt',
+    // (<=)
+    LESS_THAN_OR_EQUAL: 'Le',
+    // (for strings and arrays)
+    CONTAINS: 'Contains',
+    // (for strings)
+    STARTS_WITH: 'StartsWith',
+    // (for strings)
+    ENDS_WITH: 'EndsWith'
+};
+// Events
+exports.EventTypes = {
+    TABLE_PERSIST: 'TablePersist',
+    TABLE_UPDATE: 'TableUpdate'
+};

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

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

package/dist/cjs/features/utils.js

@@ -5,7 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 exports.__esModule = true;
 exports.post = void 0;
 var axios_1 = __importDefault(require("axios"));
-var post = function (url, body) {
-    return axios_1["default"].post(url, body, { headers: { 'content-type': 'application/json' } });
+var post = function (url, body, auth) {
+    if (auth === void 0) { auth = ''; }
+    return axios_1["default"].post(url, body, {
+        headers: { 'content-type': 'application/json', Authorization: "Basic ".concat(auth) }
+    });
 };
 exports.post = post;

package/dist/cjs/index.d.ts

@@ -1,3 +1,4 @@
 export { ChainDB, connect } from './features/chain-db';
-export { Access } from './features/access';
-export { BasicResponse, SignedUserAccount } from './features/types';
+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';

package/dist/cjs/index.js

@@ -11,9 +11,14 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
     o[k2] = m[k];
 }));
 exports.__esModule = true;
-exports.Access = exports.connect = exports.ChainDB = void 0;
+exports.TableDocImpl = exports.Events = exports.EventTypes = exports.Operators = exports.connect = exports.ChainDB = void 0;
 var chain_db_1 = require("./features/chain-db");
 __createBinding(exports, chain_db_1, "ChainDB");
 __createBinding(exports, chain_db_1, "connect");
-var access_1 = require("./features/access");
-__createBinding(exports, access_1, "Access");
+var types_1 = require("./features/types");
+__createBinding(exports, types_1, "Operators");
+__createBinding(exports, types_1, "EventTypes");
+var events_1 = require("./features/events");
+__createBinding(exports, events_1, "default", "Events");
+var table_doc_1 = require("./features/table-doc");
+__createBinding(exports, table_doc_1, "TableDocImpl");

package/features/chain-db.d.ts

@@ -1,10 +1,10 @@
-import { Access } from './access';
-import { BasicResponse, SignedUserAccount, TransferUnitsRegistry } from './types';
+import Table from './table';
+import { Connection, EventCallback } from './types';
 export declare class ChainDB {
-    api: string;
-    name: string;
-    access: Access | null;
-    access_key: string;
+    server: string;
+    database: string;
+    auth: string;
+    private _events;
     /**
      * Connection information.
      * @param server Server location. If the `server` parameter is empty, then "http://localhost" will be used.
@@ -12,69 +12,28 @@ export declare class ChainDB {
      * @param user  User to access the data base
      * @param password  Password to access the data base
      */
-    connect(server: string | null, data_base: string, user: string, password: string): void;
-    /**
-     * Create a new user account inside the connected table
-     * @param user_name
-     * @param password
-     * @param units
-     * @param password_hint
-     * @returns
-     */
-    create_user_account(user_name: string, password: string, units?: number, password_hint?: string): Promise<BasicResponse<SignedUserAccount>>;
-    /**
-     * Get user account info (login method)
-     * @param user_name
-     * @param password
-     * @returns
-     */
-    get_user_account(user_name: string, password: string): Promise<BasicResponse<SignedUserAccount>>;
-    /**
-     * Get user account info by its id
-     * @param user_id
-     * @returns
-     */
-    get_user_account_by_id(user_id: string): Promise<BasicResponse<SignedUserAccount>>;
-    /**
-     * Check if user_name is already taken
-     * @param user_name
-     */
-    check_user_name(user_name: string): Promise<BasicResponse<string>>;
-    /**
-     * Transfer units between users
-     * @param from user_id
-     * @param to user_id
-     * @param units
-     * @returns
-     */
-    transfer_units(from: string, to: string, units: number): Promise<BasicResponse<null>>;
-    /**
-     * Fetch the last Transference of units Records by User
-     * @param user_id
-     * @returns
-     */
-    get_transfer_by_user_id(user_id: string): Promise<BasicResponse<TransferUnitsRegistry>>;
-    /**
-     * Fetch all Transference of units Records by User
-     * @param user_id
-     * @returns
-     */
-    get_all_transfers_by_user_id(user_id: string): Promise<BasicResponse<TransferUnitsRegistry[]>>;
+    connect(connection: Connection): Promise<void>;
     /**
      * Initialize a table, fetching its more updated data
      */
-    get_table<Model>(table_name: string, model: Model): Promise<{
-        table: Model;
+    getTable<Model>(table_name: string): Promise<Table<Model>>;
+    events(): {
+        /**
+         * Subscribe to an event
+         * @param event Event name to subscribe to @see {EventTypes}
+         * @param callback Function to call when the event is received
+         */
+        subscribe: (event: string, callback: EventCallback) => void;
         /**
-         * Persist table data on chain
+         * Unsubscribe from an event
+         * @param event Event name to unsubscribe from @see {EventTypes}
+         * @param callback Optional callback to remove. If not provided, all callbacks for the event will be removed.
          */
-        persist: () => Promise<void>;
+        unsubscribe: (event: string, callback?: EventCallback) => 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
+         * Close the events transmission
          */
-        getHistory: (depth: number) => Promise<Model[]>;
-    }>;
+        closeEvents: () => void;
+    };
 }
-export declare const connect: (server: string | null, data_base: string, user: string, password: string) => ChainDB;
+export declare const connect: (connection: Connection) => Promise<ChainDB>;