@wxn0brp/db 0.9.1 → 0.20.1

package/dist/helpers/relation.js

@@ -1,155 +0,0 @@
-function pickByPath(obj, paths) {
-    const result = {};
-    for (const path of paths) {
-        let src = obj;
-        let dst = result;
-        for (let i = 0; i < path.length; i++) {
-            const k = path[i];
-            if (src == null)
-                break;
-            if (i === path.length - 1) {
-                dst[k] = src[k];
-            }
-            else {
-                dst[k] ||= {};
-                dst = dst[k];
-                src = src[k];
-            }
-        }
-    }
-    return result;
-}
-function autoSelect(rel, key) {
-    const select = Array.isArray(rel.select) ? [...rel.select] : undefined;
-    const shouldDelete = select && !select.includes(key);
-    if (shouldDelete)
-        select.push(key);
-    return [select, shouldDelete];
-}
-function convertSearchObjToSearchArray(obj, parentKeys = []) {
-    return Object.entries(obj).reduce((acc, [key, value]) => {
-        const currentPath = [...parentKeys, key];
-        if (!value) {
-            return acc;
-        }
-        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
-            return [...acc, ...convertSearchObjToSearchArray(value, currentPath)];
-        }
-        else {
-            return [...acc, currentPath];
-        }
-    }, []);
-}
-async function processRelations(dbs, cfg, data, parentList = null) {
-    if (!data && !parentList)
-        return;
-    const batchMode = Array.isArray(parentList);
-    const targets = batchMode ? parentList : [data];
-    for (const key in cfg) {
-        if (!cfg.hasOwnProperty(key))
-            continue;
-        const rel = cfg[key];
-        const { pk = "_id", fk = "_id", type = "1", path, as = key, select, findOpts = {}, through } = rel;
-        const [dbKey, coll] = path;
-        const db = dbs[dbKey];
-        if (type === "1") {
-            const keys = [...new Set(targets.map(i => i[pk]))];
-            const [selectSafe, deleteSelect] = autoSelect(rel, fk);
-            const results = await db.find(coll, { $in: { [fk]: keys } }, {}, {}, { select: selectSafe });
-            const map = new Map(results.map(row => [row[fk], row]));
-            for (const item of targets) {
-                const result = map.get(item[pk]) || null;
-                if (result && rel.relations) {
-                    await processRelations(dbs, rel.relations, result);
-                }
-                if (deleteSelect && result)
-                    delete result[fk];
-                item[as] = result;
-            }
-        }
-        else if (type === "11") {
-            const cache = new Map();
-            const [selectSafe, deleteSelect] = autoSelect(rel, fk);
-            for (const item of targets) {
-                const id = item[pk];
-                if (!cache.has(id)) {
-                    cache.set(id, await db.findOne(coll, { [fk]: id }, {}, { select: selectSafe }));
-                }
-                const result = cache.get(id) || null;
-                if (result && rel.relations) {
-                    await processRelations(dbs, rel.relations, result);
-                }
-                if (deleteSelect && result)
-                    delete result[fk];
-                item[as] = result;
-            }
-        }
-        else if (type === "1n") {
-            const ids = targets.map(i => i[pk]);
-            const [selectSafe, deleteSelect] = autoSelect(rel, fk);
-            const results = await db.find(coll, { $in: { [fk]: ids } }, {}, findOpts || {}, { select: selectSafe });
-            const grouped = results.reduce((acc, row) => {
-                const id = row[fk];
-                (acc[id] ||= []).push(row);
-                return acc;
-            }, {});
-            for (const item of targets) {
-                item[as] = grouped[item[pk]] || [];
-            }
-            if (rel.relations) {
-                await Promise.all(results.map(row => processRelations(dbs, rel.relations, row)));
-            }
-            if (deleteSelect)
-                for (const r of results)
-                    delete r[fk];
-        }
-        else if (type === "nm") {
-            if (!through || !through.table || !through.pk || !through.fk) {
-                throw new Error(`Relation type "nm" requires a defined 'through' in '${key}'`);
-            }
-            for (const item of targets) {
-                const pivotDb = dbs[through.db || dbKey];
-                const pivots = await pivotDb.find(through.table, { [through.pk]: item[pk] });
-                const ids = pivots.map(p => p[through.fk]);
-                const related = await db.find(coll, { $in: { [fk]: ids } }, {}, {}, { select });
-                item[as] = related;
-                if (rel.relations) {
-                    await Promise.all(related.map(row => processRelations(dbs, rel.relations, row)));
-                }
-            }
-        }
-        else {
-            throw new Error(`Unknown relation type: ${type}`);
-        }
-    }
-}
-class Relation {
-    dbs;
-    constructor(dbs) {
-        this.dbs = dbs;
-    }
-    async findOne(path, search, relations, select) {
-        const [dbKey, coll] = path;
-        const db = this.dbs[dbKey];
-        const data = await db.findOne(coll, search);
-        if (!data)
-            return null;
-        if (typeof select === "object" && !Array.isArray(select)) {
-            select = convertSearchObjToSearchArray(select);
-        }
-        await processRelations(this.dbs, relations, data);
-        return select ? pickByPath(data, select) : data;
-    }
-    async find(path, search, relations, select, findOpts = {}) {
-        const [dbKey, coll] = path;
-        const db = this.dbs[dbKey];
-        const data = await db.find(coll, search, {}, findOpts);
-        if (relations)
-            await processRelations(this.dbs, relations, null, data);
-        if (typeof select === "object" && !Array.isArray(select)) {
-            select = convertSearchObjToSearchArray(select);
-        }
-        return select ? data.map(d => pickByPath(d, select)) : data;
-    }
-}
-export default Relation;

package/dist/helpers/updateOneOrAdd.d.ts

@@ -1,2 +0,0 @@
-import { VQuery } from "../types/query.js";
-export declare function setDataUsingUpdateOneOrAdd(query: VQuery): void;

package/dist/helpers/updateOneOrAdd.js

@@ -1,18 +0,0 @@
-function assignDataPush(data) {
-    if (typeof data !== "object" || Array.isArray(data))
-        return;
-    const obj = {};
-    for (const key of Object.keys(data)) {
-        if (key.startsWith("$")) {
-            Object.keys(data[key]).forEach((k) => {
-                obj[k] = data[key][k];
-            });
-        }
-        else
-            obj[key] = data[key];
-    }
-    return obj;
-}
-export function setDataUsingUpdateOneOrAdd(query) {
-    query.data = Object.assign({}, assignDataPush(query.search), assignDataPush(query.updater), assignDataPush(query.add_arg));
-}

package/dist/types/Id.d.ts

@@ -1,3 +0,0 @@
-type Id = string;
-export default Id;
-export { Id };

package/dist/types/Id.js

@@ -1 +0,0 @@
-export {};

package/dist/types/arg.d.ts

@@ -1,12 +0,0 @@
-import Id from "./Id.js";
-import { SearchOptions } from "./searchOpts.js";
-import { Context } from "./types.js";
-import { UpdaterArg } from "./updater.js";
-export interface Arg {
-    _id?: Id;
-    [key: string]: any;
-}
-export type SearchFunc<T = any> = (data: T, context: Context) => boolean;
-export type UpdaterFunc<T = any> = (data: T, context: Context) => boolean;
-export type Search<T = any> = SearchOptions | SearchFunc<T>;
-export type Updater<T = any> = UpdaterArg | UpdaterArg[] | UpdaterFunc<T>;

package/dist/types/arg.js

@@ -1 +0,0 @@
-export {};

package/dist/types/data.d.ts

@@ -1,4 +0,0 @@
-export interface Data {
-    [key: string]: any;
-}
-export default Data;

package/dist/types/data.js

@@ -1 +0,0 @@
-export {};

package/dist/types/export.d.ts

@@ -1,11 +0,0 @@
-export declare namespace ValtheraTypes {
-    type Arg = import("./arg.js").Arg;
-    type Search = import("./arg.js").Search;
-    type Updater = import("./arg.js").Updater;
-    type DbFindOpts = import("./options.js").DbFindOpts;
-    type FindOpts = import("./options.js").FindOpts;
-    type DbOpts = import("./options.js").DbOpts;
-    type Data = import("./data.js").Data;
-    type SearchOptions = import("./searchOpts.js").SearchOptions;
-    type Id = import("./Id.js").Id;
-}

package/dist/types/export.js

@@ -1 +0,0 @@
-export {};

package/dist/types/fileCpu.d.ts

@@ -1,69 +0,0 @@
-import { Search, Updater } from "./arg.js";
-import Data from "./data.js";
-import { FindOpts } from "./options.js";
-import { Transaction } from "./transactions.js";
-import { Context } from "./types.js";
-interface FileCpu {
-    /**
-     * Asynchronously adds an entry to a file.
-     * @param file The path to the file.
-     * @param data The data to add.
-     * @returns A promise resolving to `void`.
-     */
-    add(file: string, data: Data): Promise<void>;
-    /**
-     * Asynchronously finds multiple entries in a file based on search criteria.
-     * @param file The path to the file.
-     * @param arg The search criteria.
-     * @param context Additional context for the search.
-     * @param findOpts Additional options for searching.
-     * @returns A promise resolving to an array of found entries, or `false` if the file does not exist.
-     */
-    find(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any[] | false>;
-    /**
-     * Asynchronously finds one entry in a file based on search criteria.
-     * @param file The path to the file.
-     * @param arg The search criteria.
-     * @param context Additional context for the search.
-     * @param findOpts Additional options for searching.
-     * @returns A promise resolving to the found entry or `false` if not found.
-     */
-    findOne(file: string, arg: Search, context?: Context, findOpts?: FindOpts): Promise<any | false>;
-    /**
-     * Asynchronously finds entries in a file based on search criteria and returns a stream of results.
-     * @param file The path to the file.
-     * @param arg The search criteria.
-     * @param context Additional context for the search.
-     * @param findOpts Additional options for searching.
-     * @param limit The maximum number of entries to return.
-     * @returns An async generator yielding found entries.
-     */
-    findStream(file: string, arg: Search, context?: Context, findOpts?: FindOpts, limit?: number): AsyncGenerator<any>;
-    /**
-   * Asynchronously removes entries from a file based on search criteria.
-   * @param file The path to the file.
-   * @param arg The search criteria.
-   * @param context Additional context for the operation.
-   * @param one If `true`, removes only the first matching entry.
-   * @returns A promise resolving to `true` if at least one entry was removed, otherwise `false`.
-   */
-    remove(file: string, one: boolean, arg: Search, context?: Context): Promise<boolean>;
-    /**
-     * Asynchronously updates entries in a file based on search criteria and an updater function or object.
-     * @param file The path to the file.
-     * @param arg The search criteria.
-     * @param updater The updater function or object.
-     * @param context Additional context for the operation.
-     * @param one If `true`, updates only the first matching entry.
-     * @returns A promise resolving to `true` if at least one entry was updated, otherwise `false`.
-     */
-    update(file: string, one: boolean, arg: Search, updater: Updater, context?: Context): Promise<boolean>;
-    /**
-     * Executes a list of transactions on the specified database collection.
-     * @param file The path to the file.
-     * @param transactions An array of transactions to execute.
-     * @returns A promise resolved when all transactions have been executed.
-     */
-    transactions(file: string, transactions: Transaction[]): Promise<void>;
-}
-export default FileCpu;

package/dist/types/fileCpu.js

@@ -1 +0,0 @@
-export {};

package/dist/types/options.d.ts

@@ -1,16 +0,0 @@
-import dbActionC from "../actions/action.js";
-import executorC from "../helpers/executor.js";
-export interface DbOpts {
-    maxFileSize?: number;
-    dbAction?: dbActionC;
-    executor?: executorC;
-}
-export interface DbFindOpts {
-    reverse?: boolean;
-    max?: number;
-}
-export interface FindOpts {
-    select?: string[];
-    exclude?: string[];
-    transform?: Function;
-}

package/dist/types/options.js

@@ -1 +0,0 @@
-export {};

package/dist/types/query.d.ts

@@ -1,17 +0,0 @@
-import { Context } from "./types.js";
-import { Arg, Search, Updater } from "./arg.js";
-import { DbFindOpts, FindOpts } from "./options.js";
-import { Transaction } from "./transactions.js";
-export interface VQuery {
-    collection?: string;
-    search?: Search;
-    context?: Context;
-    dbFindOpts?: DbFindOpts;
-    findOpts?: FindOpts;
-    data?: Arg;
-    id_gen?: boolean;
-    limit?: number;
-    add_arg?: Arg;
-    updater?: Updater;
-    transaction?: Transaction[];
-}

package/dist/types/query.js

@@ -1 +0,0 @@
-export {};

package/dist/types/relation.d.ts

@@ -1,28 +0,0 @@
-import { DbFindOpts } from "./options.js";
-import { ValtheraCompatible } from "./valthera.js";
-export declare namespace RelationTypes {
-    type Path = [string, string];
-    type FieldPath = string[];
-    interface DBS {
-        [key: string]: ValtheraCompatible;
-    }
-    interface Relation {
-        [key: string]: RelationConfig;
-    }
-    interface RelationConfig {
-        path: Path;
-        pk?: string;
-        fk?: string;
-        as?: string;
-        select?: string[];
-        findOpts?: DbFindOpts;
-        type?: "1" | "11" | "1n" | "nm";
-        relations?: Relation;
-        through?: {
-            table: string;
-            db?: string;
-            pk: string;
-            fk: string;
-        };
-    }
-}

package/dist/types/relation.js

@@ -1 +0,0 @@
-export {};

package/dist/types/searchOpts.d.ts

@@ -1,62 +0,0 @@
-/**
- * Predefined Search Options Quick Reference
- *
- * This module defines the types and structures for search operators used
- * to validate and query data objects.
- */
-import { Arg } from "./arg.js";
-/** Logical Operators */
-export type LogicalOperators = {
-    /**
-     * Recursively applies multiple conditions, all of which must evaluate to true.
-     * Can include other operators such as $gt, $exists, or nested $and/$or conditions.
-     */
-    $and?: Array<SearchOptions>;
-    /**
-     * Recursively applies multiple conditions, at least one of which must evaluate to true.
-     * Can include other operators such as $lt, $type, or nested $and/$or conditions.
-     */
-    $or?: Array<SearchOptions>;
-    /**
-     * Negates a single condition.
-     * Can include any other operator as its value.
-     */
-    $not?: SearchOptions;
-};
-/** Comparison Operators */
-export type ComparisonOperators = {
-    $gt?: Record<string, number>;
-    $lt?: Record<string, number>;
-    $gte?: Record<string, number>;
-    $lte?: Record<string, number>;
-    $in?: Record<string, any[]>;
-    $nin?: Record<string, any[]>;
-    $between?: Record<string, [number, number]>;
-};
-/** Type and Existence Operators */
-export type TypeAndExistenceOperators = {
-    $exists?: Record<string, boolean>;
-    $type?: Record<string, string>;
-};
-/** Array Operators */
-export type ArrayOperators = {
-    $arrinc?: Record<string, any[]>;
-    $arrincall?: Record<string, any[]>;
-    $size?: Record<string, number>;
-};
-/** String Operators */
-export type StringOperators = {
-    $regex?: Record<string, RegExp>;
-    $startsWith?: Record<string, string>;
-    $endsWith?: Record<string, string>;
-};
-/** Other Operators */
-export type OtherOperators = {
-    $subset?: Record<string, any>;
-};
-/** Predefined Search Operators */
-export type PredefinedSearchOperators = LogicalOperators & ComparisonOperators & TypeAndExistenceOperators & ArrayOperators & StringOperators & OtherOperators;
-/**
- * SearchOptions can be either a function or an object with predefined operators.
- */
-export type SearchOptions = PredefinedSearchOperators & Arg;

package/dist/types/searchOpts.js

@@ -1,7 +0,0 @@
-/**
- * Predefined Search Options Quick Reference
- *
- * This module defines the types and structures for search operators used
- * to validate and query data objects.
- */
-export {};

package/dist/types/transactions.d.ts

@@ -1,10 +0,0 @@
-import { Arg, Search, Updater } from "./arg.js";
-import { Context } from "./types.js";
-export interface Transaction {
-    type: 'update' | 'updateOne' | 'updateOneOrAdd' | 'remove' | 'removeOne';
-    search: Search;
-    updater?: Updater;
-    addArg?: Arg;
-    idGen?: boolean;
-    context?: Context;
-}

package/dist/types/transactions.js

@@ -1 +0,0 @@
-export {};

package/dist/types/types.d.ts

@@ -1,3 +0,0 @@
-export interface Context {
-    [key: string]: any;
-}

package/dist/types/types.js

@@ -1 +0,0 @@
-export {};

package/dist/types/updater.d.ts

@@ -1,26 +0,0 @@
-/**
- * Predefined type for updating data.
- */
-/** Arrays */
-export type ArrayUpdater = {
-    $push?: any;
-    /** Pushes items into an array and removes duplicates */
-    $pushset?: any;
-    $pull?: any;
-    $pullall?: any;
-};
-/** Objects */
-export type ObjectUpdater = {
-    $merge?: any;
-};
-/** Values */
-export type ValueUpdater = {
-    $set?: any;
-    $inc?: any;
-    $dec?: any;
-    $unset?: any;
-    $rename?: any;
-};
-export type UpdaterArg = ArrayUpdater & ObjectUpdater & ValueUpdater & {
-    [key: string]: any;
-};

package/dist/types/updater.js

@@ -1,4 +0,0 @@
-/**
- * Predefined type for updating data.
- */
-export {};

package/dist/types/valthera.d.ts

@@ -1,41 +0,0 @@
-import CollectionManager from "../helpers/CollectionManager.js";
-import { Arg, Search, Updater } from "./arg.js";
-import Data from "./data.js";
-import { DbFindOpts, FindOpts } from "./options.js";
-import { VQuery } from "./query.js";
-import { Transaction } from "./transactions.js";
-import { Context } from "./types.js";
-export interface ValtheraCompatible {
-    c(collection: string): CollectionManager;
-    getCollections(): Promise<string[]>;
-    checkCollection(collection: string): Promise<boolean>;
-    issetCollection(collection: string): Promise<boolean>;
-    add<T = Data>(collection: string, data: Arg, id_gen?: boolean): Promise<T>;
-    find<T = Data>(collection: string, search: Search, context?: Context, options?: DbFindOpts, findOpts?: FindOpts): Promise<T[]>;
-    findOne<T = Data>(collection: string, search: Search, context?: Context, findOpts?: FindOpts): Promise<T | null>;
-    findStream<T = Data>(collection: string, search: Search, context?: Context, findOpts?: FindOpts, limit?: number): Promise<AsyncGenerator<T>>;
-    update(collection: string, search: Search, updater: Updater, context?: Context): Promise<boolean>;
-    updateOne(collection: string, search: Search, updater: Updater, context?: Context): Promise<boolean>;
-    remove(collection: string, search: Search, context?: Context): Promise<boolean>;
-    removeOne(collection: string, search: Search, context?: Context): Promise<boolean>;
-    removeCollection(collection: string): Promise<boolean>;
-    transaction(collection: string, transaction: Transaction[]): Promise<boolean>;
-    updateOneOrAdd(collection: string, search: Search, updater: Updater, add_arg?: Arg, context?: Context, id_gen?: boolean): Promise<boolean>;
-}
-export interface ValtheraCompatibleInternal {
-    c(config: VQuery): CollectionManager;
-    getCollections(): Promise<string[]>;
-    checkCollection(config: VQuery): Promise<boolean>;
-    issetCollection(config: VQuery): Promise<boolean>;
-    add<T = Data>(config: VQuery): Promise<T>;
-    find<T = Data>(config: VQuery): Promise<T[]>;
-    findOne<T = Data>(config: VQuery): Promise<T | null>;
-    findStream<T = Data>(config: VQuery): Promise<AsyncGenerator<T>>;
-    update(config: VQuery): Promise<boolean>;
-    updateOne(config: VQuery): Promise<boolean>;
-    remove(config: VQuery): Promise<boolean>;
-    removeOne(config: VQuery): Promise<boolean>;
-    removeCollection(config: VQuery): Promise<boolean>;
-    transaction(config: VQuery): Promise<boolean>;
-    updateOneOrAdd(config: VQuery): Promise<boolean>;
-}

package/dist/types/valthera.js

@@ -1 +0,0 @@
-export {};

package/dist/utils/hasFields.d.ts

@@ -1,7 +0,0 @@
-/**
- * Checks if an object matches the standard field comparison.
- * @param obj - The object to check.
- * @param fields - Criteria to compare.
- * @returns Whether the object matches the criteria.
- */
-export default function hasFields(obj: Object, fields: Object): boolean;

package/dist/utils/hasFields.js

@@ -1,18 +0,0 @@
-/**
- * Checks if an object matches the standard field comparison.
- * @param obj - The object to check.
- * @param fields - Criteria to compare.
- * @returns Whether the object matches the criteria.
- */
-export default function hasFields(obj, fields) {
-    const keys = Object.keys(fields);
-    return keys.every(key => {
-        if (obj[key] !== undefined) {
-            if (typeof fields[key] === "object" && fields[key] !== null) {
-                return hasFields(obj[key], fields[key]);
-            }
-            return obj[key] === fields[key];
-        }
-        return false;
-    });
-}

package/dist/utils/hasFieldsAdvanced.d.ts

@@ -1,5 +0,0 @@
-import { Arg } from "../types/arg.js";
-/**
- * Checks if an object meets the criteria specified in the fields with operators.
- */
-export default function hasFieldsAdvanced(obj: Object, fields: Arg): any;