@naturalcycles/firestore-lib 1.1.4

package/CHANGELOG.md

@@ -0,0 +1,105 @@
+## [1.1.4](https://github.com/NaturalCycles/firestore-lib/compare/v1.1.3...v1.1.4) (2021-10-01)
+
+
+### Bug Fixes
+
+* adapt to db-lib ([05cbc49](https://github.com/NaturalCycles/firestore-lib/commit/05cbc4996efe5a3f1091835b016e2534b59befde))
+
+## [1.1.3](https://github.com/NaturalCycles/firestore-lib/compare/v1.1.2...v1.1.3) (2021-08-25)
+
+
+### Bug Fixes
+
+* deps ([541438a](https://github.com/NaturalCycles/firestore-lib/commit/541438aab99613d5b0c69b48b68008d6e0fbe06f))
+
+## [1.1.2](https://github.com/NaturalCycles/firestore-lib/compare/v1.1.1...v1.1.2) (2021-02-27)
+
+
+### Bug Fixes
+
+* deps ([741c1cb](https://github.com/NaturalCycles/firestore-lib/commit/741c1cbd2fbc913a32bdd26d394a14ea9e548f76))
+
+## [1.1.1](https://github.com/NaturalCycles/firestore-lib/compare/v1.1.0...v1.1.1) (2020-11-05)
+
+
+### Bug Fixes
+
+* adapt to db-lib ([032f821](https://github.com/NaturalCycles/firestore-lib/commit/032f82164f200d75fb5ed6c72ba12209fce45e9c))
+
+# [1.1.0](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.9...v1.1.0) (2020-10-25)
+
+
+### Features
+
+* adapt to current db-lib ([4c2f228](https://github.com/NaturalCycles/firestore-lib/commit/4c2f228c4f80711735a53b20fc75a9a74878ffb9))
+
+## [1.0.9](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.8...v1.0.9) (2020-03-22)
+
+
+### Bug Fixes
+
+* deps ([53f70bb](https://github.com/NaturalCycles/firestore-lib/commit/53f70bbe9b746c500bb394d506bc0a707f09b4f2))
+
+## [1.0.8](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.7...v1.0.8) (2019-09-21)
+
+
+### Bug Fixes
+
+* adapt to db-lib ([d046dd6](https://github.com/NaturalCycles/firestore-lib/commit/d046dd6))
+
+## [1.0.7](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.6...v1.0.7) (2019-09-20)
+
+
+### Bug Fixes
+
+* adapt to new db-lib ([414b97c](https://github.com/NaturalCycles/firestore-lib/commit/414b97c))
+
+## [1.0.6](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.5...v1.0.6) (2019-08-24)
+
+
+### Bug Fixes
+
+* missing index.ts ([b2b75cd](https://github.com/NaturalCycles/firestore-lib/commit/b2b75cd))
+
+## [1.0.5](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.4...v1.0.5) (2019-08-23)
+
+
+### Bug Fixes
+
+* adopt to db-lib ([60800db](https://github.com/NaturalCycles/firestore-lib/commit/60800db))
+
+## [1.0.4](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.3...v1.0.4) (2019-08-20)
+
+
+### Bug Fixes
+
+* return await ([6c6267d](https://github.com/NaturalCycles/firestore-lib/commit/6c6267d))
+
+## [1.0.3](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.2...v1.0.3) (2019-08-20)
+
+
+### Bug Fixes
+
+* update to recent commondb interface ([d506916](https://github.com/NaturalCycles/firestore-lib/commit/d506916))
+
+## [1.0.2](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.1...v1.0.2) (2019-08-18)
+
+
+### Bug Fixes
+
+* filterUndefinedValues ([57e0b24](https://github.com/NaturalCycles/firestore-lib/commit/57e0b24))
+
+## [1.0.1](https://github.com/NaturalCycles/firestore-lib/compare/v1.0.0...v1.0.1) (2019-08-18)
+
+
+### Bug Fixes
+
+* update to recent db-lib ([dbbb093](https://github.com/NaturalCycles/firestore-lib/commit/dbbb093))
+
+# 1.0.0 (2019-07-28)
+
+
+### Features
+
+* first version ([6d129a9](https://github.com/NaturalCycles/firestore-lib/commit/6d129a9))
+* init project by create-module ([205703f](https://github.com/NaturalCycles/firestore-lib/commit/205703f))

package/dist/firestore.db.d.ts

@@ -0,0 +1,27 @@
+import { Query } from '@google-cloud/firestore';
+import { BaseCommonDB, CommonDB, CommonDBOptions, CommonDBSaveOptions, CommonDBStreamOptions, DBQuery, DBTransaction, ObjectWithId, RunQueryResult } from '@naturalcycles/db-lib';
+import { ReadableTyped } from '@naturalcycles/nodejs-lib';
+import * as firebaseAdmin from 'firebase-admin';
+export interface FirestoreDBCfg {
+    firestore: firebaseAdmin.firestore.Firestore;
+}
+export interface FirestoreDBOptions extends CommonDBOptions {
+}
+export interface FirestoreDBSaveOptions extends CommonDBSaveOptions {
+}
+export declare class FirestoreDB extends BaseCommonDB implements CommonDB {
+    cfg: FirestoreDBCfg;
+    constructor(cfg: FirestoreDBCfg);
+    getByIds<ROW extends ObjectWithId>(table: string, ids: string[], opt?: FirestoreDBOptions): Promise<ROW[]>;
+    getById<ROW extends ObjectWithId>(table: string, id: string, _opt?: FirestoreDBOptions): Promise<ROW | undefined>;
+    runQuery<ROW extends ObjectWithId>(q: DBQuery<ROW>, opt?: FirestoreDBOptions): Promise<RunQueryResult<ROW>>;
+    runFirestoreQuery<ROW extends ObjectWithId>(q: Query, _opt?: FirestoreDBOptions): Promise<ROW[]>;
+    runQueryCount<ROW extends ObjectWithId>(q: DBQuery<ROW>, opt?: FirestoreDBOptions): Promise<number>;
+    streamQuery<ROW extends ObjectWithId>(q: DBQuery<ROW>, _opt?: CommonDBStreamOptions): ReadableTyped<ROW>;
+    saveBatch<ROW extends ObjectWithId>(table: string, rows: ROW[], _opt?: FirestoreDBSaveOptions): Promise<void>;
+    deleteByQuery<ROW extends ObjectWithId>(q: DBQuery<ROW>, opt?: FirestoreDBOptions): Promise<number>;
+    deleteByIds(table: string, ids: string[], _opt?: FirestoreDBOptions): Promise<number>;
+    private querySnapshotToArray;
+    commitTransaction(_tx: DBTransaction, _opt?: CommonDBSaveOptions): Promise<void>;
+    ping(): Promise<void>;
+}

package/dist/firestore.db.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FirestoreDB = void 0;
+const db_lib_1 = require("@naturalcycles/db-lib");
+const js_lib_1 = require("@naturalcycles/js-lib");
+const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
+const firestore_util_1 = require("./firestore.util");
+const query_util_1 = require("./query.util");
+class FirestoreDB extends db_lib_1.BaseCommonDB {
+    constructor(cfg) {
+        super();
+        this.cfg = cfg;
+    }
+    // GET
+    async getByIds(table, ids, opt) {
+        // Oj, doesn't look like a very optimal implementation!
+        // TODO: check if we can query by keys or smth
+        return (await Promise.all(ids.map(id => this.getById(table, id, opt)))).filter(Boolean);
+    }
+    async getById(table, id, _opt) {
+        const doc = await this.cfg.firestore.collection(table).doc((0, firestore_util_1.escapeDocId)(id)).get();
+        const data = doc.data();
+        if (data === undefined)
+            return;
+        return {
+            id,
+            ...data,
+        };
+    }
+    // QUERY
+    async runQuery(q, opt) {
+        const firestoreQuery = (0, query_util_1.dbQueryToFirestoreQuery)(q, this.cfg.firestore.collection(q.table));
+        let rows = await this.runFirestoreQuery(firestoreQuery, opt);
+        // Special case when projection query didn't specify 'id'
+        if (q._selectedFieldNames && !q._selectedFieldNames.includes('id')) {
+            rows = rows.map(r => (0, js_lib_1._omit)(r, ['id']));
+        }
+        return { rows };
+    }
+    async runFirestoreQuery(q, _opt) {
+        return this.querySnapshotToArray(await q.get());
+    }
+    async runQueryCount(q, opt) {
+        const { rows } = await this.runQuery(q.select([]), opt);
+        return rows.length;
+    }
+    streamQuery(q, _opt) {
+        const firestoreQuery = (0, query_util_1.dbQueryToFirestoreQuery)(q, this.cfg.firestore.collection(q.table));
+        return firestoreQuery.stream().pipe((0, nodejs_lib_1.transformMapSimple)(doc => ({
+            id: (0, firestore_util_1.unescapeDocId)(doc.id),
+            ...doc.data(),
+        }), {
+            errorMode: js_lib_1.ErrorMode.SUPPRESS, // because .pipe cannot propagate errors
+        }));
+    }
+    // SAVE
+    async saveBatch(table, rows, _opt) {
+        // Firestore allows max 500 items in one batch
+        await (0, js_lib_1.pMap)((0, js_lib_1._chunk)(rows, 500), async (chunk) => {
+            const batch = this.cfg.firestore.batch();
+            chunk.forEach(row => {
+                batch.set(this.cfg.firestore.collection(table).doc((0, firestore_util_1.escapeDocId)(row.id)), (0, js_lib_1._filterNullishValues)(row));
+            });
+            await batch.commit();
+        }, { concurrency: 1 });
+    }
+    // DELETE
+    async deleteByQuery(q, opt) {
+        const firestoreQuery = (0, query_util_1.dbQueryToFirestoreQuery)(q.select([]), this.cfg.firestore.collection(q.table));
+        const ids = (await this.runFirestoreQuery(firestoreQuery)).map(obj => obj.id);
+        await this.deleteByIds(q.table, ids, opt);
+        return ids.length;
+    }
+    async deleteByIds(table, ids, _opt) {
+        await (0, js_lib_1.pMap)((0, js_lib_1._chunk)(ids, 500), async (chunk) => {
+            const batch = this.cfg.firestore.batch();
+            chunk.forEach(id => {
+                batch.delete(this.cfg.firestore.collection(table).doc((0, firestore_util_1.escapeDocId)(id)));
+            });
+            await batch.commit();
+        });
+        return ids.length;
+    }
+    querySnapshotToArray(qs) {
+        const rows = [];
+        qs.forEach(doc => {
+            rows.push({
+                id: (0, firestore_util_1.unescapeDocId)(doc.id),
+                ...doc.data(),
+            });
+        });
+        return rows;
+    }
+    async commitTransaction(_tx, _opt) {
+        throw new Error('commitTransaction is not supported yet');
+    }
+    async ping() {
+        // no-op now
+    }
+}
+exports.FirestoreDB = FirestoreDB;

package/dist/firestore.util.d.ts

@@ -0,0 +1,2 @@
+export declare function escapeDocId(docId: string): string;
+export declare function unescapeDocId(docId: string): string;

package/dist/firestore.util.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unescapeDocId = exports.escapeDocId = void 0;
+const string_util_1 = require("./string.util");
+const SLASH = '_SLASH_';
+function escapeDocId(docId) {
+    return (0, string_util_1.replaceAll)(docId, '/', SLASH);
+}
+exports.escapeDocId = escapeDocId;
+function unescapeDocId(docId) {
+    return (0, string_util_1.replaceAll)(docId, SLASH, '/');
+}
+exports.unescapeDocId = unescapeDocId;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { FirestoreDB, FirestoreDBCfg, FirestoreDBOptions, FirestoreDBSaveOptions } from './firestore.db';
+import { dbQueryToFirestoreQuery } from './query.util';
+export type { FirestoreDBCfg, FirestoreDBOptions, FirestoreDBSaveOptions };
+export { FirestoreDB, dbQueryToFirestoreQuery };

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dbQueryToFirestoreQuery = exports.FirestoreDB = void 0;
+const firestore_db_1 = require("./firestore.db");
+Object.defineProperty(exports, "FirestoreDB", { enumerable: true, get: function () { return firestore_db_1.FirestoreDB; } });
+const query_util_1 = require("./query.util");
+Object.defineProperty(exports, "dbQueryToFirestoreQuery", { enumerable: true, get: function () { return query_util_1.dbQueryToFirestoreQuery; } });

package/dist/query.util.d.ts

@@ -0,0 +1,3 @@
+import { Query } from '@google-cloud/firestore';
+import { DBQuery, ObjectWithId } from '@naturalcycles/db-lib';
+export declare function dbQueryToFirestoreQuery<ROW extends ObjectWithId>(dbQuery: DBQuery<ROW>, emptyQuery: Query): Query;

package/dist/query.util.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dbQueryToFirestoreQuery = void 0;
+// Map DBQueryFilterOp to WhereFilterOp
+// Currently it's fully aligned!
+const OP_MAP = {
+// '=': '==',
+// in: 'array-contains',
+};
+function dbQueryToFirestoreQuery(dbQuery, emptyQuery) {
+    // filter
+    // eslint-disable-next-line unicorn/no-array-reduce, unicorn/prefer-object-from-entries
+    let q = dbQuery._filters.reduce((q, f) => {
+        return q.where(f.name, OP_MAP[f.op] || f.op, f.val);
+    }, emptyQuery);
+    // order
+    // eslint-disable-next-line unicorn/no-array-reduce, unicorn/prefer-object-from-entries
+    q = dbQuery._orders.reduce((q, ord) => {
+        return q.orderBy(ord.name, ord.descending ? 'desc' : 'asc');
+    }, q);
+    // limit
+    q = q.limit(dbQuery._limitValue);
+    // selectedFields
+    if (dbQuery._selectedFieldNames) {
+        // todo: check if at least id / __key__ is required to be set
+        q = q.select(...dbQuery._selectedFieldNames);
+    }
+    return q;
+}
+exports.dbQueryToFirestoreQuery = dbQueryToFirestoreQuery;

package/dist/string.util.d.ts

@@ -0,0 +1 @@
+export declare function replaceAll(str: string, find: string, replace: string): string;

package/dist/string.util.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceAll = void 0;
+// todo: move to... js-lib? lodash-lib?
+function replaceAll(str, find, replace) {
+    return str.replace(new RegExp(find, 'g'), replace);
+}
+exports.replaceAll = replaceAll;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@naturalcycles/firestore-lib",
+  "scripts": {
+    "prepare": "husky install"
+  },
+  "dependencies": {
+    "@naturalcycles/db-lib": "^8.2.0",
+    "@naturalcycles/js-lib": "^14.6.0",
+    "@naturalcycles/nodejs-lib": "^12.4.0"
+  },
+  "peerDependencies": {
+    "firebase-admin": ">=9.3.0"
+  },
+  "devDependencies": {
+    "@naturalcycles/dev-lib": "^12.1.2",
+    "@naturalcycles/test-lib": "^1.0.3",
+    "@types/node": "^16.7.1",
+    "dotenv": "^10.0.0",
+    "firebase-admin": "^9.3.0",
+    "jest": "^27.0.6"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/test",
+    "!src/**/*.test.ts",
+    "!src/**/__snapshots__",
+    "!src/**/__exclude"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NaturalCycles/firestore-lib"
+  },
+  "engines": {
+    "node": ">=12.13"
+  },
+  "version": "1.1.4",
+  "description": "Firestore implementation of CommonDB interface",
+  "author": "Natural Cycles Team",
+  "license": "MIT"
+}

package/readme.md

@@ -0,0 +1,17 @@
+## @naturalcycles/firestore-lib
+
+> Firestore implementation of CommonDB interface
+
+[![npm](https://img.shields.io/npm/v/@naturalcycles/firestore-lib/latest.svg)](https://www.npmjs.com/package/@naturalcycles/firestore-lib)
+[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
+
+# Features
+
+- ...
+
+# Packaging
+
+- `engines.node >= 10.13`: Latest Node.js LTS
+- `main: dist/index.js`: commonjs, es2018
+- `types: dist/index.d.ts`: typescript types
+- `/src` folder with source `*.ts` files included

package/src/firestore.db.ts

@@ -0,0 +1,190 @@
+import { Query, QueryDocumentSnapshot, QuerySnapshot } from '@google-cloud/firestore'
+import {
+  BaseCommonDB,
+  CommonDB,
+  CommonDBOptions,
+  CommonDBSaveOptions,
+  CommonDBStreamOptions,
+  DBQuery,
+  DBTransaction,
+  ObjectWithId,
+  RunQueryResult,
+} from '@naturalcycles/db-lib'
+import { ErrorMode, pMap, _chunk, _filterNullishValues, _omit } from '@naturalcycles/js-lib'
+import { ReadableTyped, transformMapSimple } from '@naturalcycles/nodejs-lib'
+import * as firebaseAdmin from 'firebase-admin'
+import { escapeDocId, unescapeDocId } from './firestore.util'
+import { dbQueryToFirestoreQuery } from './query.util'
+
+export interface FirestoreDBCfg {
+  firestore: firebaseAdmin.firestore.Firestore
+}
+
+export interface FirestoreDBOptions extends CommonDBOptions {}
+export interface FirestoreDBSaveOptions extends CommonDBSaveOptions {}
+
+export class FirestoreDB extends BaseCommonDB implements CommonDB {
+  constructor(public cfg: FirestoreDBCfg) {
+    super()
+  }
+
+  // GET
+  override async getByIds<ROW extends ObjectWithId>(
+    table: string,
+    ids: string[],
+    opt?: FirestoreDBOptions,
+  ): Promise<ROW[]> {
+    // Oj, doesn't look like a very optimal implementation!
+    // TODO: check if we can query by keys or smth
+    return (await Promise.all(ids.map(id => this.getById<ROW>(table, id, opt)))).filter(
+      Boolean,
+    ) as ROW[]
+  }
+
+  async getById<ROW extends ObjectWithId>(
+    table: string,
+    id: string,
+    _opt?: FirestoreDBOptions,
+  ): Promise<ROW | undefined> {
+    const doc = await this.cfg.firestore.collection(table).doc(escapeDocId(id)).get()
+
+    const data = doc.data()
+    if (data === undefined) return
+
+    return {
+      id,
+      ...(data as any),
+    }
+  }
+
+  // QUERY
+  override async runQuery<ROW extends ObjectWithId>(
+    q: DBQuery<ROW>,
+    opt?: FirestoreDBOptions,
+  ): Promise<RunQueryResult<ROW>> {
+    const firestoreQuery = dbQueryToFirestoreQuery(q, this.cfg.firestore.collection(q.table))
+
+    let rows = await this.runFirestoreQuery<ROW>(firestoreQuery, opt)
+
+    // Special case when projection query didn't specify 'id'
+    if (q._selectedFieldNames && !q._selectedFieldNames.includes('id')) {
+      rows = rows.map(r => _omit(r as any, ['id']))
+    }
+
+    return { rows }
+  }
+
+  async runFirestoreQuery<ROW extends ObjectWithId>(
+    q: Query,
+    _opt?: FirestoreDBOptions,
+  ): Promise<ROW[]> {
+    return this.querySnapshotToArray(await q.get())
+  }
+
+  override async runQueryCount<ROW extends ObjectWithId>(
+    q: DBQuery<ROW>,
+    opt?: FirestoreDBOptions,
+  ): Promise<number> {
+    const { rows } = await this.runQuery(q.select([]), opt)
+    return rows.length
+  }
+
+  override streamQuery<ROW extends ObjectWithId>(
+    q: DBQuery<ROW>,
+    _opt?: CommonDBStreamOptions,
+  ): ReadableTyped<ROW> {
+    const firestoreQuery = dbQueryToFirestoreQuery(q, this.cfg.firestore.collection(q.table))
+
+    return firestoreQuery.stream().pipe(
+      transformMapSimple<QueryDocumentSnapshot<any>, ROW>(
+        doc => ({
+          id: unescapeDocId(doc.id),
+          ...doc.data(),
+        }),
+        {
+          errorMode: ErrorMode.SUPPRESS, // because .pipe cannot propagate errors
+        },
+      ),
+    )
+  }
+
+  // SAVE
+  override async saveBatch<ROW extends ObjectWithId>(
+    table: string,
+    rows: ROW[],
+    _opt?: FirestoreDBSaveOptions,
+  ): Promise<void> {
+    // Firestore allows max 500 items in one batch
+    await pMap(
+      _chunk(rows, 500),
+      async chunk => {
+        const batch = this.cfg.firestore.batch()
+
+        chunk.forEach(row => {
+          batch.set(
+            this.cfg.firestore.collection(table).doc(escapeDocId(row.id)),
+            _filterNullishValues(row), // todo: check if we really need to filter them (thinking of null values)
+          )
+        })
+
+        await batch.commit()
+      },
+      { concurrency: 1 },
+    )
+  }
+
+  // DELETE
+  override async deleteByQuery<ROW extends ObjectWithId>(
+    q: DBQuery<ROW>,
+    opt?: FirestoreDBOptions,
+  ): Promise<number> {
+    const firestoreQuery = dbQueryToFirestoreQuery(
+      q.select([]),
+      this.cfg.firestore.collection(q.table),
+    )
+    const ids = (await this.runFirestoreQuery<ROW>(firestoreQuery)).map(obj => obj.id)
+
+    await this.deleteByIds(q.table, ids, opt)
+
+    return ids.length
+  }
+
+  override async deleteByIds(
+    table: string,
+    ids: string[],
+    _opt?: FirestoreDBOptions,
+  ): Promise<number> {
+    await pMap(_chunk(ids, 500), async chunk => {
+      const batch = this.cfg.firestore.batch()
+
+      chunk.forEach(id => {
+        batch.delete(this.cfg.firestore.collection(table).doc(escapeDocId(id)))
+      })
+
+      await batch.commit()
+    })
+
+    return ids.length
+  }
+
+  private querySnapshotToArray<T = any>(qs: QuerySnapshot): T[] {
+    const rows: any[] = []
+
+    qs.forEach(doc => {
+      rows.push({
+        id: unescapeDocId(doc.id),
+        ...doc.data(),
+      })
+    })
+
+    return rows
+  }
+
+  override async commitTransaction(_tx: DBTransaction, _opt?: CommonDBSaveOptions): Promise<void> {
+    throw new Error('commitTransaction is not supported yet')
+  }
+
+  override async ping(): Promise<void> {
+    // no-op now
+  }
+}

package/src/firestore.util.ts

@@ -0,0 +1,11 @@
+import { replaceAll } from './string.util'
+
+const SLASH = '_SLASH_'
+
+export function escapeDocId(docId: string): string {
+  return replaceAll(docId, '/', SLASH)
+}
+
+export function unescapeDocId(docId: string): string {
+  return replaceAll(docId, SLASH, '/')
+}

package/src/index.ts

@@ -0,0 +1,11 @@
+import {
+  FirestoreDB,
+  FirestoreDBCfg,
+  FirestoreDBOptions,
+  FirestoreDBSaveOptions,
+} from './firestore.db'
+import { dbQueryToFirestoreQuery } from './query.util'
+
+export type { FirestoreDBCfg, FirestoreDBOptions, FirestoreDBSaveOptions }
+
+export { FirestoreDB, dbQueryToFirestoreQuery }

package/src/query.util.ts

@@ -0,0 +1,37 @@
+import { Query, WhereFilterOp } from '@google-cloud/firestore'
+import { DBQuery, DBQueryFilterOperator, ObjectWithId } from '@naturalcycles/db-lib'
+
+// Map DBQueryFilterOp to WhereFilterOp
+// Currently it's fully aligned!
+const OP_MAP: Partial<Record<DBQueryFilterOperator, WhereFilterOp>> = {
+  // '=': '==',
+  // in: 'array-contains',
+}
+
+export function dbQueryToFirestoreQuery<ROW extends ObjectWithId>(
+  dbQuery: DBQuery<ROW>,
+  emptyQuery: Query,
+): Query {
+  // filter
+  // eslint-disable-next-line unicorn/no-array-reduce, unicorn/prefer-object-from-entries
+  let q = dbQuery._filters.reduce((q, f) => {
+    return q.where(f.name, OP_MAP[f.op] || (f.op as WhereFilterOp), f.val)
+  }, emptyQuery)
+
+  // order
+  // eslint-disable-next-line unicorn/no-array-reduce, unicorn/prefer-object-from-entries
+  q = dbQuery._orders.reduce((q, ord) => {
+    return q.orderBy(ord.name, ord.descending ? 'desc' : 'asc')
+  }, q)
+
+  // limit
+  q = q.limit(dbQuery._limitValue)
+
+  // selectedFields
+  if (dbQuery._selectedFieldNames) {
+    // todo: check if at least id / __key__ is required to be set
+    q = q.select(...dbQuery._selectedFieldNames)
+  }
+
+  return q
+}

package/src/string.util.ts

@@ -0,0 +1,4 @@
+// todo: move to... js-lib? lodash-lib?
+export function replaceAll(str: string, find: string, replace: string): string {
+  return str.replace(new RegExp(find, 'g'), replace)
+}