inibase 1.0.0-rc.26 → 1.0.0-rc.28

package/README.md

@@ -4,17 +4,20 @@
 
 [![npmjs](https://img.shields.io/npm/dm/inibase.svg?style=flat)](https://www.npmjs.org/package/inibase) [![License](https://img.shields.io/github/license/inicontent/inibase.svg?style=flat&colorA=18181B&colorB=28CF8D)](./LICENSE) [![Activity](https://img.shields.io/github/commit-activity/m/inicontent/inibase)](https://github.com/inicontent/inibase/pulse) [![GitHub stars](https://img.shields.io/github/stars/inicontent/inibase?style=social)](https://github.com/inicontent/inibase)
 
-> File-based relational database, simple to use and can handle large data :fire:
+> A file-based & memory-efficient, serverless relational database management system :fire:
 
 ## Features
 
 - **Lightweight** 🪶
-- **Minimalist** :white_circle:
+- **Minimalist** :white_circle: (but powerful)
 - **TypeScript** :large_blue_diamond:
-- **Super-Fast** :zap:
-- **Form-validation** included :sunglasses:
-- **Suitable for large data** :page_with_curl:
-- **Safe** :lock:
+- **Super-Fast** :zap: (built-in caching system)
+- **Built-in form-validation** included :sunglasses:
+- **Suitable for large data** :page_with_curl: (tested with 200K row)
+- **Support Compression** :eight_spoked_asterisk: (using built-in nodejs zlib)
+- **Support Table Joins** :link:
+- **Low memory-usage** :chart_with_downwards_trend: (3-5mb)
+- **Safe** :lock: (no sql or javascript injections)
 - **Easy to use** :bread:
 - **...** and much more :rocket:
 
@@ -35,8 +38,8 @@ const users = await db.get("user", undefined, {
   columns: ["username", "address.street", "hobbies.name"],
 });
 
-// Get items from "user" table where "favoriteFoods" does not includes "Pizza"
-const users = await db.get("user", { favoriteFoods: "![]Pizza" });
+// Get items from "user" table where "favoriteFoods" does not includes "Pizza" or "Burger"
+const users = await db.get("user", { favoriteFoods: "![]Pizza,Burger" });
 ```
 
 If you like Inibase, please sponsor: [GitHub Sponsors](https://github.com/sponsors/inicontent) || [Paypal](https://paypal.me/KarimAmahtil).
@@ -49,7 +52,7 @@ If you like Inibase, please sponsor: [GitHub Sponsors](https://github.com/sponso
 
 ## How it works?
 
-To simplify the idea, each database has tables, each table has columns, each column will be stored in a seperated file. When POSTing new data, it will be appended to the end of each file as new line. When GETing data, the file will be readed line-by-line so it can handle large data (without consuming a lot of resources), when PUTing(updating) in a specific column, only one file will be opened and updated
+To simplify the idea, each database has tables, each table has columns, each column will be stored in a seperated file. When **POST**ing new data, it will be appended to the _head_ of each file as new line. When **GET**ing data, the file will be readed line-by-line so it can handle large data (without consuming a lot of resources), when **PUT**ing(updating) in a specific column, only one file will be opened and updated
 
 ## Benchmark
 
@@ -71,6 +74,45 @@ To simplify the idea, each database has tables, each table has columns, each col
 | PUT    | 33 ms (10.29 mb)  | 312 ms (11.06 mb)  | 3539 ms (14.87 mb) |
 | DELETE | 134 ms (13.50 mb) | 1224 ms (16.57 mb) | 7339 ms (11.46 mb) |
 
+
+## Roadmap
+
+- [x] Actions:
+  - [x] GET:
+    - [x] Pagination
+    - [x] Criteria
+    - [x] Columns
+    - [ ] Order By
+  - [x] POST
+  - [x] PUT
+  - [x] DELETE
+  - [x] SUM
+  - [x] MAX
+  - [x] MIN
+- [ ] Schema supported types:
+  - [x] String
+  - [x] Number
+  - [x] Boolean
+  - [x] Date
+  - [x] Email
+  - [x] Url
+  - [x] Table
+  - [x] Object
+  - [x] Array
+  - [x] Password
+  - [x] IP
+  - [x] HTML
+  - [x] Id
+- [ ] TO-DO:
+  - [x] Improve caching
+  - [x] Commenting the code
+- [ ] Features:
+  - [ ] Encryption
+  - [x] Data Compression
+  - [x] Caching System
+  - [ ] Suggest [new feature +](https://github.com/inicontent/inibase/discussions/new?category=ideas)
+
+
 ## Examples
 
 <details>
@@ -447,40 +489,17 @@ await db.min("user", ["age", ...], { isActive: false });
 
 </details>
 
+## Config
 
+The `.env` file supports the following parameters (make sure to run command with flag --env-file=.env)
 
-## Roadmap
+```ini
+# Auto generated secret key, will be using for encrypting the IDs
+INIBASE_SECRET=
 
-- [x] Actions:
-  - [x] GET:
-    - [x] Pagination
-    - [x] Criteria
-    - [x] Columns
-    - [ ] Order By
-  - [x] POST
-  - [x] PUT
-  - [x] DELETE
-- [ ] Schema supported types:
-  - [x] String
-  - [x] Number
-  - [x] Boolean
-  - [x] Date
-  - [x] Email
-  - [x] Url
-  - [x] Table
-  - [x] Object
-  - [x] Array
-  - [x] Password
-  - [x] IP
-  - [x] HTML
-  - [x] Id
-- [ ] TO-DO:
-  - [ ] Improve caching
-  - [ ] Commenting the code
-- [ ] Features:
-  - [ ] Encryption
-  - [ ] Compress data
-  - [ ] Suggest [new feature +](https://github.com/inicontent/inibase/discussions/new?category=ideas)
+INIBASE_COMPRESSION=true
+INIBASE_CACHE=true
+```
 
 ## License
 

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+export default class Config {
+    static isCompressionEnabled: boolean;
+    static isCacheEnabled: boolean;
+}

package/dist/config.js

@@ -0,0 +1,4 @@
+export default class Config {
+    static isCompressionEnabled = process.env.INIBASE_COMPRESSION === "true";
+    static isCacheEnabled = process.env.INIBASE_CACHE === "true";
+}

package/dist/file.d.ts

@@ -1,5 +1,7 @@
 /// <reference types="node" resolution-mode="require"/>
 import { ComparisonOperator, FieldType } from "./index.js";
+export declare const write: (filePath: string, data: any, disableCompression?: boolean) => Promise<void>;
+export declare const read: (filePath: string, disableCompression?: boolean) => Promise<string>;
 /**
  * Checks if a file or directory exists at the specified path.
  *
@@ -41,7 +43,8 @@ export declare const decode: (input: string | null | number, fieldType?: FieldTy
  *   1. Record of line numbers and their decoded content or null if no lines are read.
  *   2. Total count of lines processed.
  */
-export declare const get: (filePath: string, lineNumbers?: number | number[], fieldType?: FieldType | FieldType[], fieldChildrenType?: FieldType | FieldType[], secretKey?: string | Buffer) => Promise<[
+export declare function get(filePath: string, lineNumbers?: number | number[], fieldType?: FieldType | FieldType[], fieldChildrenType?: FieldType | FieldType[], secretKey?: string | Buffer, readWholeFile?: false): Promise<Record<number, string | number | boolean | null | (string | number | boolean | (string | number | boolean)[] | null)[]> | null>;
+export declare function get(filePath: string, lineNumbers: undefined | number | number[], fieldType: undefined | FieldType | FieldType[], fieldChildrenType: undefined | FieldType | FieldType[], secretKey: undefined | string | Buffer, readWholeFile: true): Promise<[
     Record<number, string | number | boolean | null | (string | number | boolean | (string | number | boolean)[] | null)[]> | null,
     number
 ]>;
@@ -57,7 +60,7 @@ export declare const get: (filePath: string, lineNumbers?: number | number[], fi
  */
 export declare const replace: (filePath: string, replacements: string | number | boolean | null | (string | number | boolean | null)[] | Record<number, string | boolean | number | null | (string | boolean | number | null)[]>) => Promise<string[]>;
 /**
- * Asynchronously appends data to a file.
+ * Asynchronously appends data to the beginning of a file.
  *
  * @param filePath - Path of the file to append to.
  * @param data - Data to append. Can be a string, number, or an array of strings/numbers.
@@ -75,15 +78,6 @@ export declare const append: (filePath: string, data: string | number | (string
  * Note: Creates a temporary file during the process and replaces the original file with it after removing lines.
  */
 export declare const remove: (filePath: string, linesToDelete: number | number[]) => Promise<string[]>;
-/**
- * Asynchronously counts the number of lines in a file.
- *
- * @param filePath - Path of the file to count lines in.
- * @returns Promise<number>. The number of lines in the file.
- *
- * Note: Reads through the file line by line to count the total number of lines.
- */
-export declare const count: (filePath: string) => Promise<number>;
 /**
  * Asynchronously searches a file for lines matching specified criteria, using comparison and logical operators.
  *
@@ -104,9 +98,19 @@ export declare const count: (filePath: string) => Promise<number>;
  * Note: Decodes each line for comparison and can handle complex queries with multiple conditions.
  */
 export declare const search: (filePath: string, operator: ComparisonOperator | ComparisonOperator[], comparedAtValue: string | number | boolean | null | (string | number | boolean | null)[], logicalOperator?: "and" | "or", fieldType?: FieldType | FieldType[], fieldChildrenType?: FieldType | FieldType[], limit?: number, offset?: number, readWholeFile?: boolean, secretKey?: string | Buffer) => Promise<[
-    Record<number, string | number | boolean | (string | number | boolean | null)[] | null> | null,
-    number
+    Record<number, string | number | boolean | null | (string | number | boolean | null)[]> | null,
+    number,
+    Set<number> | null
 ]>;
+/**
+ * Asynchronously counts the number of lines in a file.
+ *
+ * @param filePath - Path of the file to count lines in.
+ * @returns Promise<number>. The number of lines in the file.
+ *
+ * Note: Reads through the file line by line to count the total number of lines.
+ */
+export declare const count: (filePath: string) => Promise<number>;
 /**
  * Asynchronously calculates the sum of numerical values from specified lines in a file.
  *
@@ -150,11 +154,10 @@ export declare const min: (filePath: string, lineNumbers?: number | number[]) =>
  */
 export declare const sort: (filePath: string, sortDirection: 1 | -1 | "asc" | "desc", lineNumbers?: number | number[], _lineNumbersPerChunk?: number) => Promise<void>;
 export default class File {
-    static get: (filePath: string, lineNumbers?: number | number[] | undefined, fieldType?: FieldType | FieldType[] | undefined, fieldChildrenType?: FieldType | FieldType[] | undefined, secretKey?: string | Buffer | undefined) => Promise<[Record<number, string | number | boolean | (string | number | boolean | (string | number | boolean)[] | null)[] | null> | null, number]>;
+    static get: typeof get;
     static remove: (filePath: string, linesToDelete: number | number[]) => Promise<string[]>;
-    static search: (filePath: string, operator: ComparisonOperator | ComparisonOperator[], comparedAtValue: string | number | boolean | (string | number | boolean | null)[] | null, logicalOperator?: "and" | "or" | undefined, fieldType?: FieldType | FieldType[] | undefined, fieldChildrenType?: FieldType | FieldType[] | undefined, limit?: number | undefined, offset?: number | undefined, readWholeFile?: boolean | undefined, secretKey?: string | Buffer | undefined) => Promise<[Record<number, string | number | boolean | (string | number | boolean | null)[] | null> | null, number]>;
+    static search: (filePath: string, operator: ComparisonOperator | ComparisonOperator[], comparedAtValue: string | number | boolean | (string | number | boolean | null)[] | null, logicalOperator?: "and" | "or" | undefined, fieldType?: FieldType | FieldType[] | undefined, fieldChildrenType?: FieldType | FieldType[] | undefined, limit?: number | undefined, offset?: number | undefined, readWholeFile?: boolean | undefined, secretKey?: string | Buffer | undefined) => Promise<[Record<number, string | number | boolean | (string | number | boolean | null)[] | null> | null, number, Set<number> | null]>;
     static replace: (filePath: string, replacements: string | number | boolean | (string | number | boolean | null)[] | Record<number, string | number | boolean | (string | number | boolean | null)[] | null> | null) => Promise<string[]>;
-    static count: (filePath: string) => Promise<number>;
     static encode: (input: string | number | boolean | (string | number | boolean | null)[] | null, secretKey?: string | Buffer | undefined) => string | number | boolean | null;
     static decode: (input: string | number | null, fieldType?: FieldType | FieldType[] | undefined, fieldChildrenType?: FieldType | FieldType[] | undefined, secretKey?: string | Buffer | undefined) => string | number | boolean | (string | number | boolean | null)[] | null;
     static isExists: (path: string) => Promise<boolean>;
@@ -162,4 +165,7 @@ export default class File {
     static min: (filePath: string, lineNumbers?: number | number[] | undefined) => Promise<number>;
     static max: (filePath: string, lineNumbers?: number | number[] | undefined) => Promise<number>;
     static append: (filePath: string, data: string | number | (string | number)[]) => Promise<string[]>;
+    static count: (filePath: string) => Promise<number>;
+    static write: (filePath: string, data: any, disableCompression?: boolean) => Promise<void>;
+    static read: (filePath: string, disableCompression?: boolean) => Promise<string>;
 }