feat: modernize, convert to ESM

BREAKING CHANGE: ^^^

Author: kirillgroshkov

eslint.config.js

@@ -1,4 +1,10 @@
-// prettier-ignore
-module.exports = [
-  ...require('@naturalcycles/dev-lib/cfg/eslint.config'),
+import sharedConfig from '@naturalcycles/dev-lib/cfg/eslint.config.js'
+
+export default [
+  ...sharedConfig,
+  {
+    rules: {
+      '@typescript-eslint/consistent-type-imports': 2,
+    },
+  },
 ]

jest.config.js

@@ -1,5 +1,6 @@
 {
   "name": "@naturalcycles/firestore-lib",
+  "type": "module",
   "scripts": {
     "prepare": "husky",
     "build": "dev-lib build",
@@ -10,17 +11,18 @@
   },
   "dependencies": {
     "@google-cloud/firestore": "^7.0.0",
-    "@naturalcycles/db-lib": "^9.0.0",
+    "@naturalcycles/db-lib": "^10.0.2",
     "@naturalcycles/js-lib": "^14.6.0",
     "@naturalcycles/nodejs-lib": "^13.1.0"
   },
   "devDependencies": {
-    "@naturalcycles/dev-lib": "^15.22.0",
-    "@naturalcycles/test-lib": "^1.0.3",
+    "@naturalcycles/dev-lib": "^17.3.0",
     "@types/node": "^22.7.5",
+    "@vitest/coverage-v8": "^3.1.1",
     "dotenv": "^16.0.0",
-    "firebase-admin": "^12.0.0",
-    "jest": "^29.1.2"
+    "firebase-admin": "^13.2.0",
+    "tsx": "^4.19.3",
+    "vitest": "^3.1.1"
   },
   "files": [
     "dist",
@@ -40,7 +42,7 @@
     "url": "https://github.com/NaturalCycles/firestore-lib"
   },
   "engines": {
-    "node": ">=18.12.0"
+    "node": ">=22.12.0"
   },
   "version": "1.1.9",
   "description": "Firestore implementation of CommonDB interface",

package.json

@@ -1 +1,3 @@
-module.exports = require('@naturalcycles/dev-lib/cfg/prettier.config')
+import sharedConfig from '@naturalcycles/dev-lib/cfg/prettier.config.js'
+
+export default sharedConfig

prettier.config.js

@@ -1 +1,3 @@
+import { test } from 'vitest'
+
 test('empty', () => {})

src/firestore.db.test.ts

@@ -1,15 +1,13 @@
-import {
-  FieldValue,
+import type {
   Firestore,
   Query,
   QueryDocumentSnapshot,
   QuerySnapshot,
   Transaction,
 } from '@google-cloud/firestore'
-import {
-  BaseCommonDB,
+import { FieldValue } from '@google-cloud/firestore'
+import type {
   CommonDB,
-  commonDBFullSupport,
   CommonDBOptions,
   CommonDBSaveMethod,
   CommonDBSaveOptions,
@@ -21,20 +19,20 @@ import {
   DBTransactionFn,
   RunQueryResult,
 } from '@naturalcycles/db-lib'
+import { BaseCommonDB, commonDBFullSupport } from '@naturalcycles/db-lib'
+import type { ObjectWithId, StringMap } from '@naturalcycles/js-lib'
 import {
   _assert,
   _chunk,
   _filterUndefinedValues,
   _isTruthy,
   _omit,
   _stringMapEntries,
-  ObjectWithId,
   pMap,
-  StringMap,
 } from '@naturalcycles/js-lib'
-import { ReadableTyped } from '@naturalcycles/nodejs-lib'
-import { escapeDocId, unescapeDocId } from './firestore.util'
-import { dbQueryToFirestoreQuery } from './query.util'
+import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
+import { escapeDocId, unescapeDocId } from './firestore.util.js'
+import { dbQueryToFirestoreQuery } from './query.util.js'
 
 export interface FirestoreDBCfg {
   firestore: Firestore
@@ -306,6 +304,7 @@ export class FirestoreDB extends BaseCommonDB implements CommonDB {
       batch.set(
         col.doc(escapeDocId(id)),
         {
+          // todo: lazy-load FieldValue
           [prop]: FieldValue.increment(increment),
         },
         { merge: true },

src/firestore.db.ts

@@ -1,4 +1,4 @@
 import { Firestore } from '@google-cloud/firestore'
-export * from './firestore.db'
-export * from './query.util'
+export * from './firestore.db.js'
+export * from './query.util.js'
 export { Firestore }

src/index.ts

@@ -1,6 +1,6 @@
-import { Query, WhereFilterOp } from '@google-cloud/firestore'
-import { DBQuery, DBQueryFilterOperator } from '@naturalcycles/db-lib'
-import { ObjectWithId } from '@naturalcycles/js-lib'
+import type { Query, WhereFilterOp } from '@google-cloud/firestore'
+import type { DBQuery, DBQueryFilterOperator } from '@naturalcycles/db-lib'
+import type { ObjectWithId } from '@naturalcycles/js-lib'
 
 // Map DBQueryFilterOp to WhereFilterOp
 // Currently it's fully aligned!

src/query.util.ts

@@ -1,13 +1,12 @@
 import { createdUpdatedFields } from '@naturalcycles/db-lib'
+import type { TestItemDBM } from '@naturalcycles/db-lib/dist/testing/index.js'
 import {
   runCommonDaoTest,
   runCommonDBTest,
   TEST_TABLE,
-  TestItemDBM,
-} from '@naturalcycles/db-lib/dist/testing'
-import { firestoreDB } from './firestore.mock'
-
-jest.setTimeout(60000)
+} from '@naturalcycles/db-lib/dist/testing/index.js'
+import { describe, test } from 'vitest'
+import { firestoreDB } from './firestore.mock.js'
 
 describe('runCommonDBTest', () => runCommonDBTest(firestoreDB))
 

src/test/firestore.manual.test.ts

@@ -1,7 +1,7 @@
+import 'dotenv/config'
 import { base64ToString, requireEnvKeys } from '@naturalcycles/nodejs-lib'
 import * as firebaseAdmin from 'firebase-admin'
-import { FirestoreDB } from '../index'
-require('dotenv').config()
+import { FirestoreDB } from '../index.js'
 
 const { FIREBASE_DB_URL, SECRET_FIREBASE } = requireEnvKeys('FIREBASE_DB_URL', 'SECRET_FIREBASE')
 const credential = firebaseAdmin.credential.cert(JSON.parse(base64ToString(SECRET_FIREBASE)))