inibase 1.0.0-rc.7 → 1.0.0-rc.70

package/dist/index.d.ts

@@ -0,0 +1,203 @@
+/// <reference types="node" resolution-mode="require"/>
+import "dotenv/config";
+export interface Data {
+    id?: number | string;
+    [key: string]: any;
+    createdAt?: number;
+    updatedAt?: number;
+}
+export type FieldType = "string" | "number" | "boolean" | "date" | "email" | "url" | "table" | "object" | "array" | "password" | "html" | "ip" | "json" | "id";
+export type Field = {
+    id?: string | number;
+    key: string;
+    type: FieldType | FieldType[];
+    required?: boolean;
+    table?: string;
+    unique?: boolean;
+    children?: FieldType | FieldType[] | Schema;
+};
+export type Schema = Field[];
+export interface Options {
+    page?: number;
+    perPage?: number;
+    columns?: string[] | string;
+    order?: Record<string, "asc" | "desc">;
+}
+export interface Config {
+    compression?: boolean;
+    cache?: boolean;
+    prepend?: boolean;
+}
+export interface TableObject {
+    schema?: Schema;
+    config: Config;
+}
+export type ComparisonOperator = "=" | "!=" | ">" | "<" | ">=" | "<=" | "*" | "!*" | "[]" | "![]";
+export type pageInfo = {
+    total?: number;
+    totalPages?: number;
+} & Options;
+export type Criteria = ({
+    [logic in "and" | "or"]?: Criteria | (string | number | boolean | null)[];
+} & {
+    [key: string]: string | number | boolean | undefined | Criteria;
+}) | null;
+declare global {
+    type Entries<T> = {
+        [K in keyof T]: [K, T[K]];
+    }[keyof T][];
+    interface ObjectConstructor {
+        entries<T extends object>(o: T): Entries<T>;
+    }
+}
+export type ErrorCodes = "FIELD_UNIQUE" | "FIELD_REQUIRED" | "NO_SCHEMA" | "NO_ITEMS" | "NO_RESULTS" | "INVALID_ID" | "INVALID_TYPE" | "INVALID_PARAMETERS" | "NO_ENV" | "TABLE_EXISTS" | "TABLE_NOT_EXISTS";
+export type ErrorLang = "en";
+export default class Inibase {
+    pageInfo: Record<string, pageInfo>;
+    salt: Buffer;
+    private databasePath;
+    private tables;
+    private fileExtension;
+    private checkIFunique;
+    private totalItems;
+    constructor(database: string, mainFolder?: string);
+    private throwError;
+    private getFileExtension;
+    private _schemaToIdsPath;
+    /**
+     * Create a new table inside database, with predefined schema and config
+     *
+     * @param {string} tableName
+     * @param {Schema} [schema]
+     * @param {Config} [config]
+     */
+    createTable(tableName: string, schema?: Schema, config?: Config): Promise<void>;
+    /**
+     * Update table schema or config
+     *
+     * @param {string} tableName
+     * @param {Schema} [schema]
+     * @param {Config} [config]
+     */
+    updateTable(tableName: string, schema?: Schema, config?: Config): Promise<void>;
+    /**
+     * Get table schema and config
+     *
+     * @param {string} tableName
+     * @return {*}  {Promise<TableObject>}
+     */
+    getTable(tableName: string): Promise<TableObject>;
+    getTableSchema(tableName: string, encodeIDs?: boolean): Promise<Schema | undefined>;
+    private throwErrorIfTableEmpty;
+    private validateData;
+    private formatField;
+    private checkUnique;
+    private formatData;
+    private getDefaultValue;
+    private _combineObjectsToArray;
+    private _CombineData;
+    private joinPathesContents;
+    private _getItemsFromSchemaHelper;
+    private getItemsFromSchema;
+    private applyCriteria;
+    private _filterSchemaByColumns;
+    /**
+     * Clear table cache
+     *
+     * @param {string} tableName
+     */
+    clearCache(tableName: string): Promise<void>;
+    /**
+     * Retrieve item(s) from a table
+     *
+     * @param {string} tableName
+     * @param {(string | number | (string | number)[] | Criteria | undefined)} [where]
+     * @param {(Options | undefined)} [options]
+     * @param {true} [onlyOne]
+     * @param {undefined} [onlyLinesNumbers]
+     * @param {boolean} [_skipIdColumn]
+     * @return {*}  {(Promise<Data[] | Data | number[] | null>)}
+     */
+    get(tableName: string, where?: string | number | (string | number)[] | Criteria | undefined, options?: Options | undefined, onlyOne?: true, onlyLinesNumbers?: undefined, _skipIdColumn?: boolean): Promise<Data | null>;
+    get(tableName: string, where?: string | number | (string | number)[] | Criteria | undefined, options?: Options | undefined, onlyOne?: boolean | undefined, onlyLinesNumbers?: true, _skipIdColumn?: boolean): Promise<number[]>;
+    /**
+     * Create new item(s) in a table
+     *
+     * @param {string} tableName
+     * @param {(Data | Data[])} data Can be array of objects or a single object
+     * @param {Options} [options] Pagination options, useful when the returnPostedData param is true
+     * @param {boolean} [returnPostedData] By default function returns void, if you want to get the posted data, set this param to true
+     * @return {*}  {Promise<Data | Data[] | null | void>}
+     */
+    post(tableName: string, data: Data | Data[], options?: Options, returnPostedData?: boolean): Promise<void>;
+    post(tableName: string, data: Data, options: Options | undefined, returnPostedData: true): Promise<Data | null>;
+    post(tableName: string, data: Data[], options: Options | undefined, returnPostedData: true): Promise<Data[] | null>;
+    /**
+     * Update item(s) in a table
+     *
+     * @param {string} tableName
+     * @param {(Data | Data[])} data
+     * @param {(number | string | (number | string)[] | Criteria)} [where]
+     * @param {Options} [options]
+     * @param {false} [returnUpdatedData]
+     * @return {*}  {Promise<Data | Data[] | null | undefined | void>}
+     */
+    put(tableName: string, data: Data | Data[], where?: number | string | (number | string)[] | Criteria, options?: Options, returnUpdatedData?: false): Promise<void>;
+    put(tableName: string, data: Data, where: number | string | (number | string)[] | Criteria | undefined, options: Options | undefined, returnUpdatedData: true): Promise<Data | null>;
+    put(tableName: string, data: Data[], where: number | string | (number | string)[] | Criteria | undefined, options: Options | undefined, returnUpdatedData: true): Promise<Data[] | null>;
+    /**
+     * Delete item(s) in a table
+     *
+     * @param {string} tableName
+     * @param {(number | string | (number | string)[] | Criteria)} [where]
+     * @return {*}  {(Promise<string | number | (string | number)[] | null>)}
+     */
+    delete(tableName: string, where?: number | string, _id?: string | string[]): Promise<string | null>;
+    delete(tableName: string, where?: (number | string)[] | Criteria, _id?: string | string[]): Promise<string[] | null>;
+    delete(tableName: string, where?: number, _id?: string | string[]): Promise<number | null>;
+    delete(tableName: string, where?: number[], _id?: string | string[]): Promise<number[] | null>;
+    /**
+     * Generate sum of column(s) in a table
+     *
+     * @param {string} tableName
+     * @param {string} columns
+     * @param {(number | string | (number | string)[] | Criteria)} [where]
+     * @return {*}  {Promise<number | Record<string, number>>}
+     */
+    sum(tableName: string, columns: string, where?: number | string | (number | string)[] | Criteria): Promise<number>;
+    sum(tableName: string, columns: string[], where?: number | string | (number | string)[] | Criteria): Promise<Record<string, number>>;
+    /**
+     * Generate max of column(s) in a table
+     *
+     * @param {string} tableName
+     * @param {string} columns
+     * @param {(number | string | (number | string)[] | Criteria)} [where]
+     * @return {*}  {Promise<number>}
+     */
+    max(tableName: string, columns: string, where?: number | string | (number | string)[] | Criteria): Promise<number>;
+    max(tableName: string, columns: string[], where?: number | string | (number | string)[] | Criteria): Promise<Record<string, number>>;
+    /**
+     * Generate min of column(s) in a table
+     *
+     * @param {string} tableName
+     * @param {string} columns
+     * @param {(number | string | (number | string)[] | Criteria)} [where]
+     * @return {*}  {Promise<number>}
+     */
+    min(tableName: string, columns: string, where?: number | string | (number | string)[] | Criteria): Promise<number>;
+    min(tableName: string, columns: string[], where?: number | string | (number | string)[] | Criteria): Promise<Record<string, number>>;
+    /**
+     * Sort column(s) of a table
+     *
+     * @param {string} tableName
+     * @param {(string
+     * 			| string[]
+     * 			| Record<string, 1 | -1 | "asc" | "ASC" | "desc" | "DESC">)} columns
+     * @param {(string | number | (string | number)[] | Criteria)} [where]
+     * @param {Options} [options={
+     * 			page: 1,
+     * 			perPage: 15,
+     * 		}]
+     */
+    sort(tableName: string, columns: string | string[] | Record<string, 1 | -1 | "asc" | "ASC" | "desc" | "DESC">, where?: string | number | (string | number)[] | Criteria, options?: Options): Promise<any[]>;
+}