@kidus.dev/flowdb 1.0.0

package/dist/core/collection/collection.d.ts

@@ -0,0 +1,99 @@
+import Document from "./document";
+import QueryBuilder from "./query/query_builder";
+import Relation from "./query/relation";
+type BetweenArg = [any, any];
+interface WhereOptions {
+    eq?: any;
+    neq?: any;
+    gt?: any;
+    gte?: any;
+    lt?: any;
+    lte?: any;
+    contains?: any;
+    doesNotContain?: any;
+    startsWith?: string;
+    endsWith?: string;
+    regexMatch?: string;
+    between?: BetweenArg;
+    betweenStartInclusive?: BetweenArg;
+    betweenEndInclusive?: BetweenArg;
+    betweenBothInclusive?: BetweenArg;
+    isNull?: boolean;
+    isNotNull?: boolean;
+    isEmpty?: boolean;
+    isNotEmpty?: boolean;
+    filter?: (value: any) => boolean;
+}
+interface RelationOptions {
+    localKey?: string;
+    name?: string;
+}
+export default class Collection {
+    private readonly _name;
+    private readonly _collectionOperations;
+    private readonly _database?;
+    private readonly _relations;
+    constructor({ name, path: collectionPath, encrypted, database, }: {
+        name: string;
+        path: string;
+        encrypted: boolean;
+        database?: any;
+    });
+    get name(): string;
+    get database(): any;
+    static fromName(name: string, database: any): Collection;
+    private get _builder();
+    get builder(): QueryBuilder;
+    hasMany(foreignCollection: Collection, foreignKey: string, { localKey, name }?: RelationOptions): void;
+    manyToMany(foreignCollection: Collection, foreignKey: string, { localKey, name }?: RelationOptions): void;
+    hasOne(foreignCollection: Collection, foreignKey: string, { localKey, name }?: RelationOptions): void;
+    get relations(): Record<string, Relation>;
+    add(data: Record<string, any>): Promise<Document>;
+    addSync(data: Record<string, any>): Document;
+    addMany(data: Array<Record<string, any>>): Promise<Document[]>;
+    addManySync(data: Array<Record<string, any>>): Document[];
+    insert(data: Record<string, any>): Promise<Document>;
+    insertSync(data: Record<string, any>): Document;
+    insertMany(data: Array<Record<string, any>>): Promise<Document[]>;
+    insertManySync(data: Array<Record<string, any>>): Document[];
+    where(field: string, options?: WhereOptions): QueryBuilder;
+    getById(id: string): Promise<Document | null>;
+    getByIdSync(id: string): Document | null;
+    getAt(index: number): Promise<Document | undefined>;
+    getAtSync(index: number): Document | undefined;
+    getRandom(): Promise<Document | null>;
+    getRandomSync(): Document | null;
+    getRandomMany(count?: number): Promise<Document[]>;
+    getRandomManySync(count?: number): Document[];
+    getAll(): Promise<Document[]>;
+    getAllSync(): Document[];
+    getFirst(): Promise<Document | undefined>;
+    getFirstSync(): Document | undefined;
+    getLast(): Promise<Document | undefined>;
+    getLastSync(): Document | undefined;
+    count(): Promise<number>;
+    countSync(): number;
+    isEmpty(): Promise<boolean>;
+    isEmptySync(): boolean;
+    isNotEmpty(): Promise<boolean>;
+    isNotEmptySync(): boolean;
+    updateById(id: string, data: Record<string, any>): Promise<Document | null>;
+    updateByIdSync(id: string, data: Record<string, any>): Document | null;
+    deleteById(id: string): Promise<Document | null>;
+    deleteByIdSync(id: string): Document | null;
+    clear(): Promise<void>;
+    clearSync(): void;
+    reset(): Promise<void>;
+    resetSync(): void;
+    drop(): Promise<void>;
+    dropSync(): void;
+    size(): Promise<number>;
+    sizeSync(): number;
+    sizeAsHumanReadable(): Promise<string>;
+    sizeAsHumanReadableSync(): string;
+    exportAsCSV(): Promise<string>;
+    exportAsCSVSync(): string;
+    toString(): string;
+}
+export {};
+//# sourceMappingURL=collection.d.ts.map

package/dist/core/collection/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../../src/core/collection/collection.ts"],"names":[],"mappings":"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"}

package/dist/core/collection/collection.js

@@ -0,0 +1,226 @@
+import * as path from "path";
+import { Json, Format } from "../../tools";
+import Document from "./document";
+import CollectionOperations from "./driver/collection_operations";
+import QueryBuilder from "./query/query_builder";
+import Relation from "./query/relation";
+export default class Collection {
+    _name;
+    _collectionOperations;
+    _database;
+    _relations = {};
+    constructor({ name, path: collectionPath, encrypted, database, }) {
+        this._name = name;
+        this._collectionOperations = new CollectionOperations({
+            path: collectionPath,
+            encrypted,
+        });
+        this._collectionOperations.createSync();
+        this._database = database;
+    }
+    get name() {
+        return this._name;
+    }
+    get database() {
+        return this._database;
+    }
+    static fromName(name, database) {
+        return new Collection({
+            name,
+            path: path.join(database.path, "collections", name),
+            encrypted: database.encrypted,
+            database,
+        });
+    }
+    get _builder() {
+        return new QueryBuilder({
+            collection: this,
+            collectionOperations: this._collectionOperations,
+        });
+    }
+    get builder() {
+        return this._builder;
+    }
+    // Relations
+    hasMany(foreignCollection, foreignKey, { localKey = "id", name } = {}) {
+        const relation = new Relation({
+            name: name ?? foreignCollection.name,
+            localCollection: this,
+            localKey,
+            foreignCollection,
+            foreignKey,
+            type: "oneToMany",
+        });
+        this._relations[relation.name] = relation;
+    }
+    manyToMany(foreignCollection, foreignKey, { localKey = "id", name } = {}) {
+        const relation = new Relation({
+            name: name ?? foreignCollection.name,
+            localCollection: this,
+            localKey,
+            foreignCollection,
+            foreignKey,
+            type: "manyToMany",
+        });
+        this._relations[relation.name] = relation;
+    }
+    hasOne(foreignCollection, foreignKey, { localKey = "id", name } = {}) {
+        const relation = new Relation({
+            name: name ?? foreignCollection.name,
+            localCollection: this,
+            localKey,
+            foreignCollection,
+            foreignKey,
+            type: "oneToOne",
+        });
+        this._relations[relation.name] = relation;
+    }
+    get relations() {
+        return this._relations;
+    }
+    // CREATE
+    async add(data) {
+        return await this._builder.executor.add(data);
+    }
+    addSync(data) {
+        return this._builder.executor.addSync(data);
+    }
+    async addMany(data) {
+        return await this._builder.executor.addMany(data);
+    }
+    addManySync(data) {
+        return this._builder.executor.addManySync(data);
+    }
+    async insert(data) {
+        return await this.add(data);
+    }
+    insertSync(data) {
+        return this.addSync(data);
+    }
+    async insertMany(data) {
+        return await this.addMany(data);
+    }
+    insertManySync(data) {
+        return this.addManySync(data);
+    }
+    // READ
+    where(field, options = {}) {
+        return this._builder.where(field, options);
+    }
+    async getById(id) {
+        return await this._collectionOperations.getById(id);
+    }
+    getByIdSync(id) {
+        return this._collectionOperations.getByIdSync(id);
+    }
+    async getAt(index) {
+        return await this._builder.getAt(index);
+    }
+    getAtSync(index) {
+        return this._builder.getAtSync(index);
+    }
+    async getRandom() {
+        return await this._collectionOperations.getRandom();
+    }
+    getRandomSync() {
+        return this._collectionOperations.getRandomSync();
+    }
+    async getRandomMany(count = 1) {
+        return await this._collectionOperations.getRandomMany(count);
+    }
+    getRandomManySync(count = 1) {
+        return this._collectionOperations.getRandomManySync(count);
+    }
+    async getAll() {
+        return await this._builder.get();
+    }
+    getAllSync() {
+        return this._builder.getSync();
+    }
+    async getFirst() {
+        return await this._builder.getFirst();
+    }
+    getFirstSync() {
+        return this._builder.getFirstSync();
+    }
+    async getLast() {
+        return await this._builder.getLast();
+    }
+    getLastSync() {
+        return this._builder.getLastSync();
+    }
+    async count() {
+        return await this._builder.count();
+    }
+    countSync() {
+        return this._builder.countSync();
+    }
+    async isEmpty() {
+        return (await this.getAll()).length === 0;
+    }
+    isEmptySync() {
+        return this.getAllSync().length === 0;
+    }
+    async isNotEmpty() {
+        return (await this.getAll()).length !== 0;
+    }
+    isNotEmptySync() {
+        return this.getAllSync().length !== 0;
+    }
+    // UPDATE
+    async updateById(id, data) {
+        return await this._collectionOperations.updateOneRecordById(id, data);
+    }
+    updateByIdSync(id, data) {
+        return this._collectionOperations.updateOneRecordByIdSync(id, data);
+    }
+    // DELETE
+    async deleteById(id) {
+        return await this._collectionOperations.deleteById(id);
+    }
+    deleteByIdSync(id) {
+        return this._collectionOperations.deleteByIdSync(id);
+    }
+    async clear() {
+        await this._collectionOperations.clear();
+    }
+    clearSync() {
+        this._collectionOperations.clearSync();
+    }
+    async reset() {
+        await this.clear();
+    }
+    resetSync() {
+        this.clearSync();
+    }
+    async drop() {
+        await this._collectionOperations.delete();
+    }
+    dropSync() {
+        this._collectionOperations.deleteSync();
+    }
+    // INFO
+    async size() {
+        return await this._collectionOperations.size();
+    }
+    sizeSync() {
+        return this._collectionOperations.sizeSync();
+    }
+    async sizeAsHumanReadable() {
+        return Format.sizeToHumanReadable(await this.size());
+    }
+    sizeAsHumanReadableSync() {
+        return Format.sizeToHumanReadable(this.sizeSync());
+    }
+    // EXPORT
+    async exportAsCSV() {
+        const records = await this.getAll();
+        return Json.mapToCSV(records.map((e) => e.data));
+    }
+    exportAsCSVSync() {
+        return Json.mapToCSV(this.getAllSync().map((e) => e.data));
+    }
+    toString() {
+        return `Collection [ ${this._name} • ${this.sizeAsHumanReadableSync()} • ${this._builder.countSync()} records ]`;
+    }
+}

package/dist/core/collection/document.d.ts

@@ -0,0 +1,24 @@
+export default class Document {
+    private _id;
+    private _data;
+    constructor({ id, data }: {
+        id: string;
+        data: Record<string, any>;
+    });
+    get id(): string;
+    get data(): Record<string, any>;
+    get(key: string): any;
+    set(key: string, value: any): void;
+    containsKey(key: string): boolean;
+    containsValue(value: any): boolean;
+    get keys(): string[];
+    get values(): any[];
+    static fromJson({ id, data, }: {
+        id?: string;
+        data: Record<string, any>;
+    }): Document;
+    format(indent?: number): string;
+    private _getNested;
+    private _update;
+}
+//# sourceMappingURL=document.d.ts.map

package/dist/core/collection/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../src/core/collection/document.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,OAAO,QAAQ;IAC3B,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,KAAK,CAAsB;gBAEvB,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE;IAKnE,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAE9B;IAED,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAIrB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAIlC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIjC,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAIlC,IAAI,IAAI,IAAI,MAAM,EAAE,CAEnB;IAED,IAAI,MAAM,IAAI,GAAG,EAAE,CAElB;IAED,MAAM,CAAC,QAAQ,CAAC,EACd,EAAE,EACF,IAAI,GACL,EAAE;QACD,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC3B,GAAG,QAAQ;IAMZ,MAAM,CAAC,MAAM,GAAE,MAAU,GAAG,MAAM;IAoClC,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,OAAO;CAkBhB"}

package/dist/core/collection/document.js

@@ -0,0 +1,86 @@
+import { Json, Random } from "../../tools";
+export default class Document {
+    _id;
+    _data;
+    constructor({ id, data }) {
+        this._id = id;
+        this._data = data;
+    }
+    get id() {
+        return this._id;
+    }
+    get data() {
+        return this._data;
+    }
+    get(key) {
+        return this._getNested(this._data, key);
+    }
+    set(key, value) {
+        this._update(this._data, key, value);
+    }
+    containsKey(key) {
+        return Object.prototype.hasOwnProperty.call(this._data, key);
+    }
+    containsValue(value) {
+        return Object.values(this._data).includes(value);
+    }
+    get keys() {
+        return Object.keys(this._data);
+    }
+    get values() {
+        return Object.values(this._data);
+    }
+    static fromJson({ id, data, }) {
+        const document_id = id ?? data["__id"] ?? Random.uuid();
+        return new Document({ id: document_id, data });
+    }
+    // FORMAT
+    format(indent = 0) {
+        const formatValue = (value, indent) => {
+            if (value instanceof Document) {
+                const docStr = value
+                    .format(indent + 1)
+                    .split("\n")
+                    .map((line) => "  " + line)
+                    .join("\n");
+                return docStr;
+            }
+            if (Array.isArray(value) && value.every((v) => v instanceof Document)) {
+                const listStr = value
+                    .map((item) => item
+                    .format(indent + 1)
+                    .split("\n")
+                    .map((line) => "  " + line)
+                    .join("\n"))
+                    .join(",\n  ");
+                return `(${value.length}) [\n${listStr}\n  ]`;
+            }
+            return JSON.stringify(value);
+        };
+        const entries = Object.entries(this._data)
+            .map(([k, v]) => {
+            return `${"  ".repeat(indent)}${k} => ${formatValue(v, indent)}`;
+        })
+            .join(",\n  ");
+        return `{\n  ${entries}\n${"  ".repeat(indent)}}`;
+    }
+    // Utility for get/set with dot-notation
+    _getNested(obj, key) {
+        if (!key)
+            return obj;
+        return key
+            .split(".")
+            .reduce((o, x) => (o == undefined ? undefined : o[x]), obj);
+    }
+    _update(obj, key, value) {
+        const parts = key.split(".");
+        let curr = obj;
+        for (let i = 0; i < parts.length - 1; i++) {
+            if (!(parts[i] in curr))
+                curr[parts[i]] = {};
+            curr = curr[parts[i]];
+        }
+        curr[parts[parts.length - 1]] = value;
+        return curr;
+    }
+}

package/dist/core/collection/driver/collection_file_driver.d.ts

@@ -0,0 +1,20 @@
+import { Encryptor } from "../../../tools";
+export default class CollectionFileDriver {
+    private filePath;
+    private encryptor;
+    private encrypted;
+    constructor(filePath: string, encryptor: Encryptor, encrypted: boolean);
+    create(): Promise<void>;
+    createSync(): void;
+    delete(): Promise<void>;
+    deleteSync(): void;
+    size(): Promise<number>;
+    sizeSync(): number;
+    appendRecords(lines: Array<Record<string, any>>): Promise<void>;
+    appendRecordsSync(lines: Array<Record<string, any>>): void;
+    readRecords(): Promise<Array<Record<string, any>>>;
+    readRecordsSync(): Array<Record<string, any>>;
+    writeRecords(lines: Array<Record<string, any>>): Promise<void>;
+    writeRecordsSync(lines: Array<Record<string, any>>): void;
+}
+//# sourceMappingURL=collection_file_driver.d.ts.map

package/dist/core/collection/driver/collection_file_driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection_file_driver.d.ts","sourceRoot":"","sources":["../../../../src/core/collection/driver/collection_file_driver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAQ,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,oBAAoB;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAU;gBAEf,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO;IAMhE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,UAAU,IAAI,IAAI;IAKZ,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,UAAU,IAAI,IAAI;IAIZ,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B,QAAQ,IAAI,MAAM;IAKZ,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAarE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI;IAapD,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAcxD,eAAe,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAYvC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI;CAU1D"}

package/dist/core/collection/driver/collection_file_driver.js

@@ -0,0 +1,90 @@
+import * as fs from "fs";
+import * as path from "path";
+import { Encryptor, Json } from "../../../tools";
+export default class CollectionFileDriver {
+    filePath;
+    encryptor;
+    encrypted;
+    constructor(filePath, encryptor, encrypted) {
+        this.filePath = filePath;
+        this.encryptor = encryptor;
+        this.encrypted = encrypted;
+    }
+    async create() {
+        await fs.promises.mkdir(path.dirname(this.filePath), { recursive: true });
+        await fs.promises.writeFile(this.filePath, "", { flag: "a" });
+    }
+    createSync() {
+        fs.mkdirSync(path.dirname(this.filePath), { recursive: true });
+        fs.writeFileSync(this.filePath, "", { flag: "a" });
+    }
+    async delete() {
+        await fs.promises.unlink(this.filePath);
+    }
+    deleteSync() {
+        fs.unlinkSync(this.filePath);
+    }
+    async size() {
+        const stats = await fs.promises.stat(this.filePath);
+        return stats.size;
+    }
+    sizeSync() {
+        const stats = fs.statSync(this.filePath);
+        return stats.size;
+    }
+    async appendRecords(lines) {
+        const content = lines
+            .map((line) => this.encrypted
+            ? this.encryptor.enc(JSON.stringify(line))
+            : JSON.stringify(line))
+            .join("\n");
+        if (content.length > 0) {
+            await fs.promises.appendFile(this.filePath, "\n" + content);
+        }
+    }
+    appendRecordsSync(lines) {
+        const content = lines
+            .map((line) => this.encrypted
+            ? this.encryptor.enc(JSON.stringify(line))
+            : JSON.stringify(line))
+            .join("\n");
+        if (content.length > 0) {
+            fs.appendFileSync(this.filePath, "\n" + content);
+        }
+    }
+    async readRecords() {
+        if (!fs.existsSync(this.filePath))
+            return [];
+        const lines = (await fs.promises.readFile(this.filePath, "utf8"))
+            .split("\n")
+            .filter((l) => l.trim() !== "");
+        const jsonLines = lines.map((l) => Json.parse(this.encrypted ? this.encryptor.dec(l) : l));
+        return jsonLines;
+    }
+    readRecordsSync() {
+        if (!fs.existsSync(this.filePath))
+            return [];
+        const lines = fs
+            .readFileSync(this.filePath, "utf8")
+            .split("\n")
+            .filter((l) => l.trim() !== "");
+        const jsonLines = lines.map((l) => Json.parse(this.encrypted ? this.encryptor.dec(l) : l));
+        return jsonLines;
+    }
+    async writeRecords(lines) {
+        const content = lines
+            .map((line) => this.encrypted
+            ? this.encryptor.enc(JSON.stringify(line))
+            : JSON.stringify(line))
+            .join("\n");
+        await fs.promises.writeFile(this.filePath, content);
+    }
+    writeRecordsSync(lines) {
+        const content = lines
+            .map((line) => this.encrypted
+            ? this.encryptor.enc(JSON.stringify(line))
+            : JSON.stringify(line))
+            .join("\n");
+        fs.writeFileSync(this.filePath, content);
+    }
+}

package/dist/core/collection/driver/collection_operations.d.ts

@@ -0,0 +1,43 @@
+import Document from "../document";
+import CollectionFileDriver from "./collection_file_driver";
+export default class CollectionOperations {
+    path: string;
+    encrypted: boolean;
+    fileDriver: CollectionFileDriver;
+    constructor(params: {
+        path: string;
+        encrypted: boolean;
+        key?: string;
+    });
+    create(): Promise<void>;
+    createSync(): void;
+    delete(): Promise<void>;
+    deleteSync(): void;
+    size(): Promise<number>;
+    sizeSync(): number;
+    add(data: Record<string, any>): Promise<Document>;
+    addSync(data: Record<string, any>): Document;
+    addMany(data: Record<string, any>[]): Promise<Document[]>;
+    addManySync(data: Record<string, any>[]): Document[];
+    getAll(): Promise<Document[]>;
+    getAllSync(): Document[];
+    getById(id: string): Promise<Document | null>;
+    getByIdSync(id: string): Document | null;
+    getRandom(): Promise<Document | null>;
+    getRandomSync(): Document | null;
+    getRandomMany(count: number): Promise<Document[]>;
+    getRandomManySync(count: number): Document[];
+    updateOneRecordById(id: string, data: Record<string, any>): Promise<Document | null>;
+    updateOneRecordByIdSync(id: string, data: Record<string, any>): Document | null;
+    updateManyRecordsByIdsWithSameValue(ids: string[], data: Record<string, any>): Promise<Document[]>;
+    updateManyRecordsByIdsWithSameValueSync(ids: string[], data: Record<string, any>): Document[];
+    updateManyRecordsByIdsWithDifferentValues(ids: string[], datas: Record<string, any>[]): Promise<Document[]>;
+    updateManyRecordsByIdsWithDifferentValuesSync(ids: string[], datas: Record<string, any>[]): Document[];
+    deleteById(id: string): Promise<Document | null>;
+    deleteByIdSync(id: string): Document | null;
+    deleteManyByIds(ids: string[]): Promise<Document[]>;
+    deleteManyByIdsSync(ids: string[]): Document[];
+    clear(): Promise<void>;
+    clearSync(): void;
+}
+//# sourceMappingURL=collection_operations.d.ts.map

package/dist/core/collection/driver/collection_operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection_operations.d.ts","sourceRoot":"","sources":["../../../../src/core/collection/driver/collection_operations.ts"],"names":[],"mappings":"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"}