@wxn0brp/db 0.0.5 → 0.0.6

package/gen.js

@@ -1,97 +0,0 @@
-const usedIdsMap = new Map();
-
-/**
- * Generates a unique identifier based on specified parts.
- * @function
- * @param {number|number[]} parts - The number of parts or an array of parts.
- * @param {number} [fill=1] - The fill value for each part (default: 1).
- * @returns {string} The generated unique identifier.
- */
-export default function genId(parts, fill=1){
-    parts = changeInputToPartsArray(parts, fill);
-    const time = getTime();
-    const id = getUniqueRandom(time, parts);
-    return id;
-}
-
-/**
- * Generates a unique random identifier based on time and parts.
- * @private
- * @param {string} time - The current time in a base36 string format.
- * @param {number[]} parts - An array of parts to be used for generating the identifier.
- * @param {number} [s=0] - Recursion counter for handling collision (default: 0).
- * @returns {string} The unique random identifier.
- */
-function getUniqueRandom(time, partsA, s=0){
-    const parts = partsA.map(l => getRandom(l));
-    const id = [time, ...parts].join("-");
-    if(usedIdsMap.has(id)){
-        s++;
-        if(s < 25) return getUniqueRandom(time, partsA, s);
-        partsA = addOneToPods(partsA);
-        time = getTime();
-        return getUniqueRandom(time, partsA);
-    }
-    usedIdsMap.set(id, Date.now() + 2000);
-
-    usedIdsMap.forEach((value, key) => {
-        if(value < Date.now()) usedIdsMap.delete(key);
-    });
-
-    return id;
-}
-
-/**
- * Generates a random string of base36 characters.
- * @private
- * @param {string} unix - The Unix timestamp used for generating the random string.
- * @returns {string} The random string.
- */
-function getRandom(unix){
-    return (Math.floor(Math.random() * Math.pow(36, unix))).toString(36);
-}
-
-/**
- * Gets the current time in a base36 string format.
- * @private
- * @returns {string} The current time in base36.
- */
-function getTime(){
-    return Math.floor(new Date().getTime() / 1000).toString(36);
-}
-
-/**
- * Adds one to each part of the input array.
- * @private
- * @param {number[]} array - The input array.
- * @returns {number[]} An array with one added to each element.
- */
-function addOneToPods(array){
-    const sum = array.reduce((acc, current) => acc + current, 0);
-    const num = sum + 1;
-    const len = array.length;
-
-    const result = [];
-    const quotient = Math.floor(num / len);
-    const remainder = num % len;
-  
-    for(let i=0; i<len; i++){
-        if(i < remainder) result.push(quotient + 1);
-        else result.push(quotient);
-    }
-  
-    return result;
-}
-
-/**
- * Converts input to an array of parts.
- * @private
- * @param {number|number[]} parts - The number of parts or an array of parts.
- * @param {number} [fill=1] - The fill value for each part (default: 1).
- * @returns {number[]} An array of parts.
- */
-function changeInputToPartsArray(parts, fill=1){
-    if(Array.isArray(parts)) return parts;
-    if(typeof parts == "number") return Array(parts).fill(fill);
-    return [1, 1];
-}

package/graph.d.ts

@@ -1,27 +0,0 @@
-import DataBase from "./database.js";
-
-declare class Graph {
-    db: DataBase;
-
-    constructor(databaseFolder: string);
-
-    add(collection: string, nodeA: string, nodeB: string): Promise<object>;
-
-    remove(collection: string, nodeA: string, nodeB: string): Promise<boolean>;
-
-    find(collection: string, node: string): Promise<object[]>;
-
-    findOne(collection: string, nodeA: string, nodeB: string): Promise<object | null>;
-
-    getAll(collection: string): Promise<object[]>;
-
-    getCollections(): Promise<string[]>;
-
-    checkCollection(collection: string): Promise<void>;
-
-    issetCollection(collection: string): Promise<boolean>;
-
-    removeCollection(collection: string): void;
-}
-
-export default Graph;

package/graph.js

@@ -1,140 +0,0 @@
-import DataBase from "./database.js";
-
-/**
- * A class representing a graph database.
- * @class
- */
-class Graph{
-    /**
-     * Initializes the graph database.
-     * @constructor
-     * @param {string} databaseFolder - The folder where the database is stored.
-     */
-    constructor(databaseFolder){
-        this.db = new DataBase(databaseFolder);
-    }
-
-    /**
-     * Adds an edge between two nodes.
-     * @async
-     * @function
-     * @param {string} collection - The name of the collection.
-     * @param {string} nodeA - The first node.
-     * @param {string} nodeB - The second node.
-     * @returns {Promise<Object>} A promise that resolves with the added edge.
-     */
-    async add(collection, nodeA, nodeB){
-        const sortedNodes = [nodeA, nodeB].sort();
-        return await this.db.add(collection, {
-            a: sortedNodes[0],
-            b: sortedNodes[1]
-        }, false);
-    }
-
-    /**
-     * Removes an edge between two nodes.
-     * @async
-     * @function
-     * @param {string} collection - The name of the collection.
-     * @param {string} nodeA - The first node.
-     * @param {string} nodeB - The second node.
-     * @returns {Promise<boolean>} A promise that resolves when the edge is removed.
-     */
-    async remove(collection, nodeA, nodeB){
-        const sortedNodes = [nodeA, nodeB].sort();
-        const query = { a: sortedNodes[0], b: sortedNodes[1] };
-        return await this.db.removeOne(collection, query);
-    }
-    
-    /**
-     * Finds all edges with either node equal to `node`.
-     * @async
-     * @function
-     * @param {string} collection - The name of the collection.
-     * @param {string} node - The node to search for.
-     * @returns {Promise<Object[]>} A promise that resolves with the found edges.
-     */
-    async find(collection, node){
-        const edges = [];
-        const edgesByANode = await this.db.find(collection, { a: node });
-        const edgesByBNode = await this.db.find(collection, { b: node });
-
-        if(edgesByANode) edges.push(...edgesByANode);
-        if(edgesByBNode) edges.push(...edgesByBNode);
-
-        return edges;
-    }
-
-    /**
-     * Finds one edge with either node equal to `nodeA` and the other equal to `nodeB`.
-     * @async
-     * @function
-     * @param {string} collection - The name of the collection.
-     * @param {string} nodeA - The first node.
-     * @param {string} nodeB - The second node.
-     * @returns {Promise<Object|null>} A promise that resolves with the found edge or null if not found.
-     */
-    async findOne(collection, nodeA, nodeB){
-        const edgeAB = await this.db.findOne(collection, { a: nodeA, b: nodeB });
-        if(edgeAB) return edgeAB;
-
-        const edgeBA = await this.db.findOne(collection, { a: nodeB, b: nodeA });
-        if(edgeBA) return edgeBA;
-
-        return null;
-    }
-
-    /**
-     * Gets all edges in the database.
-     * @async
-     * @function
-     * @param {string} collection - The name of the collection.
-     * @returns {Promise<Object[]>} A promise that resolves with all edges in the database.
-     */
-    async getAll(collection){
-        return await this.db.find(collection, {});
-    }
-
-    /**
-     * Get the names of all available databases.
-     *
-     * @function
-     * @returns {string[]} An array of database names.
-     */
-    async getCollections(){
-        return await this.db.getCollections();
-    }
-
-    /**
-     * Check and create the specified collection if it doesn't exist.
-     *
-     * @function
-     * @param {string} collection - The collection to check.
-     */
-    async checkCollection(collection){
-        await this.db.checkCollection(collection);
-    }
-
-    /**
-     * Check if a collection exists.
-     *
-     * @function
-     * @param {string} collection - The name of the collection.
-     * @returns {boolean} True if the collection exists, false otherwise.
-     */
-    async issetCollection(collection){
-        return await this.db.issetCollection(collection);
-    }
-
-    /**
-     * Removes a database collection from the file system.
-     *
-     * @param {string} collection - The name of the collection to remove.
-     * @return {void}
-     */
-    removeCollection(collection){
-         this.db.removeCollection(collection);
-    }
-}
-
-export default Graph;

package/relation.d.ts

@@ -1,23 +0,0 @@
-import DataBase from "./database.js";
-
-interface RelationConfig {
-    from: string;
-    localField: string;
-    foreignField: string;
-    as?: string;
-    multiple?: boolean;
-}
-
-declare class Relation {
-    constructor(databases: Record<string, DataBase>);
-
-    private _resolvePath(path: string): { db: DataBase; collection: string };
-
-    private _processItemRelations(item: object, relations: Record<string, any>): Promise<object>;
-
-    find(path: string, search: object, relations?: Record<string, RelationConfig>, options?: object): Promise<Array<object>>;
-
-    findOne(path: string, search: object, relations?: Record<string, RelationConfig>): Promise<object | null>;
-}
-
-export default Relation;

package/remote/client/database.d.ts

@@ -1,41 +0,0 @@
-import CollectionManager from "../../CollectionManager.js";
-
-declare class DataBaseRemote {
-    remote: {
-        name: string;
-        auth: string;
-        url: string;
-    };
-
-    constructor(remote: { name: string; auth: string; url: string });
-
-    private _request(type: string, data: object): Promise<any>;
-
-    c(collection: string): CollectionManager;
-
-    getCollections(): Promise<string[]>;
-
-    checkCollection(collection: string): Promise<void>;
-
-    issetCollection(collection: string): Promise<boolean>;
-
-    add(collection: string, data: object, id_gen?: boolean): Promise<object>;
-
-    find(collection: string, search: object | string, context?: object, options?: object, findOpts?: object): Promise<object[]>;
-
-    findOne(collection: string, search: object | string, context?: object, findOpts?: object): Promise<object | null>;
-
-    update(collection: string, search: object | string, arg: object | string, context?: object): Promise<boolean>;
-
-    updateOne(collection: string, search: object | string, arg: object | string, context?: object): Promise<boolean>;
-
-    remove(collection: string, search: object | string, context?: object): Promise<boolean>;
-
-    removeOne(collection: string, search: object | string, context?: object): Promise<boolean>;
-
-    updateOneOrAdd(collection: string, search: object | string, arg: object | string, add_arg?: object | string, context?: object, id_gen?: boolean): Promise<boolean>;
-
-    removeCollection(name: string): Promise<void>;
-}
-
-export default DataBaseRemote;

package/remote/client/database.js

@@ -1,228 +0,0 @@
-import got from "got";
-import CollectionManager from "../../CollectionManager.js";
-
-/**
- * Represents a database management class for performing CRUD operations.
- * Uses a remote database.
- * @class
- */
-class DataBaseRemote{
-    /**
-     * Create a new database instance.
-     * @constructor
-     * @param {object} remote - The remote database object.
-     * @param {string} remote.name - The name of the database.
-     * @param {string} remote.auth - The authentication token.
-     * @param {string} remote.url - The URL of the remote database.
-     */
-    constructor(remote){
-        this.remote = remote;
-    }
-
-    /**
-     * Make a request to the remote database.
-     * @async
-     * @function
-     * @param {string} type - The type of the request.
-     * @param {object} data - The data to send with the request.
-     * @returns {Promise<*>} A Promise that resolves with the result of the request.
-     * @throws {Error} If the request failed.
-     */
-    async _request(type, data){
-        data.db = this.remote.name;
-        const res = await got.post(this.remote.url + "/db/database/" + type, {
-            json: data,
-            headers: {
-                "Authorization": this.remote.auth
-            },
-            responseType: "json"
-        });
-
-        if(res.body.err) throw new Error(res.body.msg);
-        return res.body.result;
-    }
-
-    /**
-     * Create a new instance of a CollectionManager class.
-     * @function
-     * @param {string} collection - The name of the collection.
-     * @returns {CollectionManager} A new instance of CollectionManager.
-     */
-    c(collection){
-        return new CollectionManager(this, collection);
-    }
-
-    /**
-     * Get the names of all available databases.
-     *
-     * @function
-     * @returns {string[]} An array of database names.
-     */
-    async getCollections(){
-        return await this._request("getCollections", {});
-    }
-
-    /**
-     * Check and create the specified collection if it doesn't exist.
-     *
-     * @function
-     * @param {string} collection - The collection to check.
-     */
-    async checkCollection(collection){
-        return await this._request("checkCollection", { collection });
-    }
-
-    /**
-     * Check if a collection exists.
-     *
-     * @function
-     * @param {string} collection - The name of the collection.
-     * @returns {boolean} True if the collection exists, false otherwise.
-     */
-    async issetCollection(collection){
-        return await this._request("issetCollection", { collection });
-    }
-
-    /**
-     * Add data to a database.
-     *
-     * @async
-     * @function
-     * @param {string} collection - The name of the collection.
-     * @param {Object} data - The data to add.
-     * @param {boolean} id_gen - Whether to generate an ID for the entry. Default is true.
-     * @returns {Promise<Object>} A Promise that resolves with the added data.
-     */
-    async add(collection, data, id_gen=true){
-        return await this._request("add", { collection, data, id_gen });
-    }
-
-    /**
-     * Find data in a database.
-     *
-     * @async
-     * @function
-     * @param {string} collection - Name of the database collection.
-     * @param {function|Object} search - The query. It can be an object or a function.
-     * @param {Object} context - The context object (for functions).
-     * @param {Object} options - The options for the search.
-     * @param {number} options.max - The maximum number of entries to return. Default is -1, meaning no limit.
-     * @param {boolean} options.reverse - Whether to reverse the order of returned entries. Default is false.
-     * @param {Object} findOpts - Update result object with findOpts options.
-     * @returns {Promise<Array<Object>>} A Promise that resolves with the matching data.
-     */
-    async find(collection, search, context={}, options={}, findOpts={}){
-        if(typeof search === "function") search = search.toString();
-        return await this._request("find", { collection, search, options, context, findOpts });
-    }
-
-    /**
-     * Find one data entry in a database.
-     *
-     * @async
-     * @function
-     * @param {string} collection - Name of the database collection.
-     * @param {function|Object} search - The query. It can be an object or a function.
-     * @param {Object} context - The context object (for functions).
-     * @param {Object} findOpts - Update result object with findOpts options.
-     * @returns {Promise<Object|null>} A Promise that resolves with the first matching data entry.
-     */
-    async findOne(collection, search, context={}, findOpts={}){
-        if(typeof search === "function") search = search.toString();
-        return await this._request("findOne", { collection, search, context, findOpts });
-    }
-
-    /**
-     * Update data in a database.
-     *
-     * @async
-     * @function
-     * @param {string} collection - Name of the database collection.
-     * @param {function|Object} search - The query. It can be an object or a function.
-     * @param {function|Object} arg - Update arguments.
-     * @param {Object} context - The context object (for functions).
-     * @returns {Promise<boolean>} A Promise that resolves when the data is updated.
-     */
-    async update(collection, search, arg, context={}){
-        if(typeof search === "function") search = search.toString();
-        if(typeof arg === "function") arg = arg.toString();
-        return await this._request("update", { collection, search, arg, context });
-    }
-
-    /**
-     * Update one data entry in a database.
-     *
-     * @async
-     * @function
-     * @param {string} collection - Name of the database collection.
-     * @param {function|Object} search - The query. It can be an object or a function.
-     * @param {function|Object} arg - The query.
-     * @param {Object} context - The context object (for functions).
-     * @returns {Promise<boolean>} A Promise that resolves when the data entry is updated.
-     */
-    async updateOne(collection, search, arg, context={}){
-        if(typeof search === "function") search = search.toString();
-        if(typeof arg === "function") arg = arg.toString();
-        return await this._request("updateOne", { collection, search, arg, context });
-    }
-
-    /**
-     * Remove data from a database.
-     *
-     * @async
-     * @function
-     * @param {string} collection - Name of the database collection.
-     * @param {function|Object} search - The query. It can be an object or a function.
-     * @param {Object} context - The context object (for functions).
-     * @returns {Promise<boolean>} A Promise that resolves when the data is removed.
-     */
-    async remove(collection, search, context={}){
-        if(typeof search === "function") search = search.toString();
-        return await this._request("remove", { collection, search, context });
-    }
-
-    /**
-     * Remove one data entry from a database.
-     *
-     * @async
-     * @function
-     * @param {string} collection - Name of the database collection.
-     * @param {function|Object} search - The query. It can be an object or a function.
-     * @param {Object} context - The context object (for functions).
-     * @returns {Promise<boolean>} A Promise that resolves when the data entry is removed.
-     */
-    async removeOne(collection, search, context={}){
-        if(typeof search === "function") search = search.toString();
-        return await this._request("removeOne", { collection, search, context });
-    }
-
-    /**
-     * Asynchronously updates one entry in a database or adds a new one if it doesn't exist.
-     *
-     * @param {string} collection - Name of the database collection.
-     * @param {function|Object} search - The query. It can be an object or a function.
-     * @param {function|Object} arg - The search criteria for the update.
-     * @param {function|Object} add_arg - The arguments to be added to the new entry.
-     * @param {Object} context - The context object (for functions).
-     * @param {boolean} id_gen - Whether to generate an ID for the entry. Default is true.
-     * @return {Promise<boolean>} A Promise that resolves to `true` if the entry was updated, or `false` if it was added.
-     */
-    async updateOneOrAdd(collection, search, arg, add_arg={}, context={}, id_gen=true){
-        if(typeof search === "function") search = search.toString();
-        if(typeof arg === "function") arg = arg.toString();
-        if(typeof add_arg === "function") add_arg = add_arg.toString();
-        return await this._request("updateOneOrAdd", { collection, search, arg, add_arg, id_gen, context });
-    }
-
-    /**
-     * Removes a database collection from the file system.
-     *
-     * @param {string} collection - The name of the collection to remove.
-     * @return {void}
-     */
-    removeCollection(name){
-        return this._request("removeCollection", { name });
-    }
-}
-
-export default DataBaseRemote;

package/remote/client/graph.d.ts

@@ -1,31 +0,0 @@
-declare class GraphRemote {
-    remote: {
-        name: string;
-        auth: string;
-        url: string;
-    };
-
-    constructor(remote: { name: string; auth: string; url: string });
-
-    private _request(type: string, data: object): Promise<any>;
-
-    add(collection: string, nodeA: string, nodeB: string): Promise<object>;
-
-    remove(collection: string, nodeA: string, nodeB: string): Promise<boolean>;
-
-    find(collection: string, node: string): Promise<object[]>;
-
-    findOne(collection: string, nodeA: string, nodeB: string): Promise<object | null>;
-
-    getAll(collection: string): Promise<object[]>;
-
-    getCollections(): Promise<string[]>;
-
-    checkCollection(collection: string): Promise<void>;
-
-    issetCollection(collection: string): Promise<boolean>;
-
-    removeCollection(collection: string): void;
-}
-
-export default GraphRemote;