@naturalcycles/db-lib 10.0.2 → 10.1.0

package/dist/timeseries/commonTimeSeriesDao.js

@@ -1,8 +1,5 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommonTimeSeriesDao = void 0;
-const js_lib_1 = require("@naturalcycles/js-lib");
-const dbQuery_1 = require("../query/dbQuery");
+import { _isTruthy } from '@naturalcycles/js-lib';
+import { DBQuery } from '../query/dbQuery.js';
 const _TIMESERIES_RAW = '_TIMESERIES_RAW';
 /**
  * TimeSeries DB implementation based on provided CommonDB database.
@@ -10,7 +7,7 @@ const _TIMESERIES_RAW = '_TIMESERIES_RAW';
  *
  * @experimental
  */
-class CommonTimeSeriesDao {
+export class CommonTimeSeriesDao {
     cfg;
     constructor(cfg) {
         this.cfg = cfg;
@@ -21,7 +18,7 @@ class CommonTimeSeriesDao {
     async getSeries() {
         return (await this.cfg.db.getTables())
             .map(t => /^(.*)_TIMESERIES_RAW$/.exec(t)?.[1])
-            .filter(js_lib_1._isTruthy);
+            .filter(_isTruthy);
     }
     // convenience method
     async save(series, tsMillis, value) {
@@ -62,7 +59,7 @@ class CommonTimeSeriesDao {
         await this.saveBatch(series, ids.map(id => [id, null]));
     }
     async query(q) {
-        const dbq = dbQuery_1.DBQuery.create(`${q.series}${_TIMESERIES_RAW}`).order('ts');
+        const dbq = DBQuery.create(`${q.series}${_TIMESERIES_RAW}`).order('ts');
         if (q.fromIncl)
             dbq.filter('ts', '>=', q.fromIncl);
         if (q.toExcl)
@@ -77,4 +74,3 @@ class CommonTimeSeriesDao {
         // todo
     }
 }
-exports.CommonTimeSeriesDao = CommonTimeSeriesDao;

package/dist/timeseries/timeSeries.model.d.ts

@@ -1,4 +1,4 @@
-import type { CommonDB } from '../common.db';
+import type { CommonDB } from '../common.db.js';
 export interface CommonTimeSeriesDaoCfg {
     db: CommonDB;
 }

package/dist/timeseries/timeSeries.model.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/dist/transaction/dbTransaction.util.d.ts

@@ -1,6 +1,6 @@
 import type { ObjectWithId } from '@naturalcycles/js-lib';
-import type { CommonDB } from '../common.db';
-import type { CommonDBOptions, CommonDBSaveOptions, DBTransaction } from '../db.model';
+import type { CommonDB } from '../common.db.js';
+import type { CommonDBOptions, CommonDBSaveOptions, DBTransaction } from '../db.model.js';
 /**
  * Optimizes the Transaction (list of DBOperations) to do less operations.
  * E.g if you save id1 first and then delete it - this function will turn it into a no-op (self-eliminate).
@@ -21,6 +21,7 @@ import type { CommonDBOptions, CommonDBSaveOptions, DBTransaction } from '../db.
 export declare class FakeDBTransaction implements DBTransaction {
     protected db: CommonDB;
     constructor(db: CommonDB);
+    commit(): Promise<void>;
     rollback(): Promise<void>;
     getByIds<ROW extends ObjectWithId>(table: string, ids: string[], opt?: CommonDBOptions): Promise<ROW[]>;
     saveBatch<ROW extends ObjectWithId>(table: string, rows: ROW[], opt?: CommonDBSaveOptions<ROW>): Promise<void>;

package/dist/transaction/dbTransaction.util.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FakeDBTransaction = void 0;
 /**
  * Optimizes the Transaction (list of DBOperations) to do less operations.
  * E.g if you save id1 first and then delete it - this function will turn it into a no-op (self-eliminate).
@@ -90,12 +87,13 @@ export function mergeDBOperations(ops: DBOperation[]): DBOperation[] {
  * Fake implementation of DBTransactionContext,
  * which executes all operations instantly, without any Transaction involved.
  */
-class FakeDBTransaction {
+export class FakeDBTransaction {
     db;
     constructor(db) {
         this.db = db;
     }
     // no-op
+    async commit() { }
     async rollback() { }
     async getByIds(table, ids, opt) {
         return await this.db.getByIds(table, ids, opt);
@@ -113,4 +111,3 @@ class FakeDBTransaction {
         return await this.db.deleteByIds(table, ids, opt);
     }
 }
-exports.FakeDBTransaction = FakeDBTransaction;

package/dist/validation/index.d.ts

@@ -1,5 +1,5 @@
-import type { CommonDBOptions, CommonDBSaveOptions } from '../db.model';
-import type { DBQuery, DBQueryFilter, DBQueryFilterOperator, DBQueryOrder } from '../query/dbQuery';
+import type { CommonDBOptions, CommonDBSaveOptions } from '../db.model.js';
+import type { DBQuery, DBQueryFilter, DBQueryFilterOperator, DBQueryOrder } from '../query/dbQuery.js';
 export declare const commonDBOptionsSchema: import("joi").ObjectSchema<CommonDBOptions>;
 export declare const commonDBSaveOptionsSchema: import("joi").ObjectSchema<CommonDBSaveOptions<any>>;
 export declare const dbQueryFilterOperatorSchema: import("@naturalcycles/nodejs-lib").StringSchema<DBQueryFilterOperator>;

package/dist/validation/index.js

@@ -1,32 +1,29 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.dbQuerySchema = exports.dbQueryOrderSchema = exports.dbQueryFilterSchema = exports.dbQueryFilterOperatorSchema = exports.commonDBSaveOptionsSchema = exports.commonDBOptionsSchema = void 0;
-const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
-const dbQuery_1 = require("../query/dbQuery");
-exports.commonDBOptionsSchema = (0, nodejs_lib_1.objectSchema)({
-    ['onlyCache']: nodejs_lib_1.booleanSchema.optional(),
-    ['skipCache']: nodejs_lib_1.booleanSchema.optional(),
+import { anySchema, arraySchema, booleanSchema, integerSchema, Joi, objectSchema, stringSchema, } from '@naturalcycles/nodejs-lib';
+import { dbQueryFilterOperatorValues } from '../query/dbQuery.js';
+export const commonDBOptionsSchema = objectSchema({
+    ['onlyCache']: booleanSchema.optional(),
+    ['skipCache']: booleanSchema.optional(),
 });
-exports.commonDBSaveOptionsSchema = (0, nodejs_lib_1.objectSchema)({
-    excludeFromIndexes: (0, nodejs_lib_1.arraySchema)(nodejs_lib_1.stringSchema).optional(),
-}).concat(exports.commonDBOptionsSchema);
-exports.dbQueryFilterOperatorSchema = nodejs_lib_1.Joi.string().valid(...dbQuery_1.dbQueryFilterOperatorValues);
-exports.dbQueryFilterSchema = (0, nodejs_lib_1.objectSchema)({
-    name: nodejs_lib_1.stringSchema,
-    op: exports.dbQueryFilterOperatorSchema,
-    val: nodejs_lib_1.anySchema,
+export const commonDBSaveOptionsSchema = objectSchema({
+    excludeFromIndexes: arraySchema(stringSchema).optional(),
+}).concat(commonDBOptionsSchema);
+export const dbQueryFilterOperatorSchema = Joi.string().valid(...dbQueryFilterOperatorValues);
+export const dbQueryFilterSchema = objectSchema({
+    name: stringSchema,
+    op: dbQueryFilterOperatorSchema,
+    val: anySchema,
 });
-exports.dbQueryOrderSchema = (0, nodejs_lib_1.objectSchema)({
-    name: nodejs_lib_1.stringSchema,
-    descending: nodejs_lib_1.booleanSchema.optional(),
+export const dbQueryOrderSchema = objectSchema({
+    name: stringSchema,
+    descending: booleanSchema.optional(),
 });
-exports.dbQuerySchema = (0, nodejs_lib_1.objectSchema)({
-    table: nodejs_lib_1.stringSchema,
-    _filters: (0, nodejs_lib_1.arraySchema)(exports.dbQueryFilterSchema).optional(),
-    _limitValue: nodejs_lib_1.integerSchema.min(0).optional(),
-    _offsetValue: nodejs_lib_1.integerSchema.min(0).optional(),
-    _orders: (0, nodejs_lib_1.arraySchema)(exports.dbQueryOrderSchema).optional(),
-    _startCursor: nodejs_lib_1.stringSchema.optional(),
-    _endCursor: nodejs_lib_1.stringSchema.optional(),
-    _selectedFieldNames: (0, nodejs_lib_1.arraySchema)(nodejs_lib_1.stringSchema).optional(),
+export const dbQuerySchema = objectSchema({
+    table: stringSchema,
+    _filters: arraySchema(dbQueryFilterSchema).optional(),
+    _limitValue: integerSchema.min(0).optional(),
+    _offsetValue: integerSchema.min(0).optional(),
+    _orders: arraySchema(dbQueryOrderSchema).optional(),
+    _startCursor: stringSchema.optional(),
+    _endCursor: stringSchema.optional(),
+    _selectedFieldNames: arraySchema(stringSchema).optional(),
 });

package/package.json

@@ -1,5 +1,6 @@
 {
   "name": "@naturalcycles/db-lib",
+  "type": "module",
   "scripts": {
     "prepare": "husky",
     "build": "dev-lib build",
@@ -13,7 +14,7 @@
     "@naturalcycles/nodejs-lib": "^13"
   },
   "devDependencies": {
-    "@naturalcycles/bench-lib": "^3",
+    "@naturalcycles/bench-lib": "^4",
     "@naturalcycles/dev-lib": "^17",
     "@types/node": "^22",
     "@vitest/coverage-v8": "^3",
@@ -47,7 +48,7 @@
   "engines": {
     "node": ">=22.12.0"
   },
-  "version": "10.0.2",
+  "version": "10.1.0",
   "description": "Lowest Common Denominator API to supported Databases",
   "keywords": [
     "db",
@@ -61,7 +62,6 @@
     "firestore",
     "mysql"
   ],
-  "type": "commonjs",
   "author": "Natural Cycles Team",
   "license": "MIT"
 }

package/src/adapter/cachedb/cache.db.model.ts

@@ -1,11 +1,11 @@
 import type { CommonLogger, ObjectWithId } from '@naturalcycles/js-lib'
-import type { CommonDB } from '../../common.db'
+import type { CommonDB } from '../../common.db.js'
 import type {
   CommonDBCreateOptions,
   CommonDBOptions,
   CommonDBSaveOptions,
   CommonDBStreamOptions,
-} from '../../db.model'
+} from '../../db.model.js'
 
 export interface CacheDBCfg {
   name: string

package/src/adapter/cachedb/cache.db.ts

@@ -7,18 +7,18 @@ import type {
 } from '@naturalcycles/js-lib'
 import { _isTruthy } from '@naturalcycles/js-lib'
 import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
-import { BaseCommonDB } from '../../base.common.db'
-import type { CommonDB, CommonDBSupport } from '../../common.db'
-import { commonDBFullSupport } from '../../common.db'
-import type { RunQueryResult } from '../../db.model'
-import type { DBQuery } from '../../query/dbQuery'
+import { BaseCommonDB } from '../../base.common.db.js'
+import type { CommonDB, CommonDBSupport } from '../../common.db.js'
+import { commonDBFullSupport } from '../../common.db.js'
+import type { RunQueryResult } from '../../db.model.js'
+import type { DBQuery } from '../../query/dbQuery.js'
 import type {
   CacheDBCfg,
   CacheDBCreateOptions,
   CacheDBOptions,
   CacheDBSaveOptions,
   CacheDBStreamOptions,
-} from './cache.db.model'
+} from './cache.db.model.js'
 
 /**
  * CommonDB implementation that proxies requests to downstream CommonDB

package/src/adapter/cachedb/index.ts

@@ -1,10 +1,10 @@
-import { CacheDB } from './cache.db'
+import { CacheDB } from './cache.db.js'
 import type {
   CacheDBCfg,
   CacheDBCreateOptions,
   CacheDBOptions,
   CacheDBStreamOptions,
-} from './cache.db.model'
+} from './cache.db.model.js'
 
 export type { CacheDBCfg, CacheDBCreateOptions, CacheDBOptions, CacheDBStreamOptions }
 

package/src/adapter/file/file.db.model.ts

@@ -1,6 +1,6 @@
 import type { CommonLogger, ObjectWithId } from '@naturalcycles/js-lib'
-import type { DBSaveBatchOperation } from '../../db.model'
-import type { DBQueryOrder } from '../../query/dbQuery'
+import type { DBSaveBatchOperation } from '../../db.model.js'
+import type { DBQueryOrder } from '../../query/dbQuery.js'
 
 export interface FileDBPersistencePlugin {
   ping: () => Promise<void>

package/src/adapter/file/file.db.ts

@@ -13,17 +13,19 @@ import {
 } from '@naturalcycles/js-lib'
 import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
 import { dimGrey, readableCreate } from '@naturalcycles/nodejs-lib'
-import type { CommonDBSupport, DBSaveBatchOperation } from '../..'
-import { BaseCommonDB, commonDBFullSupport, queryInMemory } from '../..'
-import type { CommonDB } from '../../common.db'
+import { BaseCommonDB } from '../../base.common.db.js'
+import type { CommonDB, CommonDBSupport } from '../../common.db.js'
+import { commonDBFullSupport } from '../../common.db.js'
 import type {
   CommonDBOptions,
   CommonDBSaveOptions,
   CommonDBStreamOptions,
+  DBSaveBatchOperation,
   RunQueryResult,
-} from '../../db.model'
-import type { DBQuery } from '../../query/dbQuery'
-import type { FileDBCfg } from './file.db.model'
+} from '../../db.model.js'
+import type { DBQuery } from '../../query/dbQuery.js'
+import { queryInMemory } from '../inmemory/queryInMemory.js'
+import type { FileDBCfg } from './file.db.model.js'
 
 /**
  * Provides barebone implementation for "whole file" based CommonDB.

package/src/adapter/file/inMemory.persistence.plugin.ts

@@ -1,7 +1,7 @@
 import type { ObjectWithId, StringMap } from '@naturalcycles/js-lib'
 import { _by } from '@naturalcycles/js-lib'
-import type { DBSaveBatchOperation } from '../../db.model'
-import type { FileDBPersistencePlugin } from './file.db.model'
+import type { DBSaveBatchOperation } from '../../db.model.js'
+import type { FileDBPersistencePlugin } from './file.db.model.js'
 
 /**
  * Mostly useful for testing.

package/src/adapter/file/index.ts

@@ -1,6 +1,6 @@
-import { FileDB } from './file.db'
-import type { FileDBCfg, FileDBPersistencePlugin } from './file.db.model'
-import { LocalFilePersistencePlugin } from './localFile.persistence.plugin'
+import { FileDB } from './file.db.js'
+import type { FileDBCfg, FileDBPersistencePlugin } from './file.db.model.js'
+import { LocalFilePersistencePlugin } from './localFile.persistence.plugin.js'
 
 export type { FileDBCfg, FileDBPersistencePlugin }
 export { FileDB, LocalFilePersistencePlugin }

package/src/adapter/file/localFile.persistence.plugin.ts

@@ -2,8 +2,8 @@ import { Readable } from 'node:stream'
 import type { ObjectWithId } from '@naturalcycles/js-lib'
 import { pMap } from '@naturalcycles/js-lib'
 import { _pipeline, fs2 } from '@naturalcycles/nodejs-lib'
-import type { DBSaveBatchOperation } from '../../db.model'
-import type { FileDBPersistencePlugin } from './file.db.model'
+import type { DBSaveBatchOperation } from '../../db.model.js'
+import type { FileDBPersistencePlugin } from './file.db.model.js'
 
 export interface LocalFilePersistencePluginCfg {
   /**

package/src/adapter/file/noop.persistence.plugin.ts

@@ -1,6 +1,6 @@
 import type { ObjectWithId } from '@naturalcycles/js-lib'
-import type { DBSaveBatchOperation } from '../../db.model'
-import type { FileDBPersistencePlugin } from './file.db.model'
+import type { DBSaveBatchOperation } from '../../db.model.js'
+import type { FileDBPersistencePlugin } from './file.db.model.js'
 
 export class NoopPersistencePlugin implements FileDBPersistencePlugin {
   async ping(): Promise<void> {}

package/src/adapter/inmemory/inMemory.db.ts

@@ -22,22 +22,20 @@ import {
 } from '@naturalcycles/js-lib'
 import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
 import { _pipeline, bufferReviver, dimGrey, fs2, yellow } from '@naturalcycles/nodejs-lib'
-import type {
-  CommonDB,
-  CommonDBSupport,
-  CommonDBTransactionOptions,
-  DBOperation,
-  DBTransactionFn,
-} from '../..'
-import { commonDBFullSupport, CommonDBType, queryInMemory } from '../..'
+import type { CommonDB, CommonDBSupport } from '../../common.db.js'
+import { commonDBFullSupport, CommonDBType } from '../../common.db.js'
 import type {
   CommonDBCreateOptions,
   CommonDBOptions,
   CommonDBSaveOptions,
+  CommonDBTransactionOptions,
+  DBOperation,
   DBTransaction,
+  DBTransactionFn,
   RunQueryResult,
-} from '../../db.model'
-import type { DBQuery } from '../../query/dbQuery'
+} from '../../db.model.js'
+import type { DBQuery } from '../../query/dbQuery.js'
+import { queryInMemory } from './queryInMemory.js'
 
 export interface InMemoryDBCfg {
   /**
@@ -281,6 +279,13 @@ export class InMemoryDB implements CommonDB {
     }
   }
 
+  async createTransaction(opt: CommonDBTransactionOptions = {}): Promise<DBTransaction> {
+    return new InMemoryDBTransaction(this, {
+      readOnly: false,
+      ...opt,
+    })
+  }
+
   async incrementBatch(
     table: string,
     prop: string,

package/src/adapter/inmemory/inMemoryKeyValueDB.ts

@@ -1,9 +1,13 @@
 import { Readable } from 'node:stream'
 import type { StringMap } from '@naturalcycles/js-lib'
 import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
-import type { CommonDBCreateOptions } from '../../db.model'
-import type { CommonKeyValueDB, IncrementTuple, KeyValueDBTuple } from '../../kv/commonKeyValueDB'
-import { commonKeyValueDBFullSupport } from '../../kv/commonKeyValueDB'
+import type { CommonDBCreateOptions } from '../../db.model.js'
+import type {
+  CommonKeyValueDB,
+  IncrementTuple,
+  KeyValueDBTuple,
+} from '../../kv/commonKeyValueDB.js'
+import { commonKeyValueDBFullSupport } from '../../kv/commonKeyValueDB.js'
 
 export interface InMemoryKeyValueDBCfg {}
 

package/src/adapter/inmemory/queryInMemory.ts

@@ -1,6 +1,6 @@
 import type { ObjectWithId } from '@naturalcycles/js-lib'
 import { _get, _pick } from '@naturalcycles/js-lib'
-import type { DBQuery, DBQueryFilterOperator } from '../../query/dbQuery'
+import type { DBQuery, DBQueryFilterOperator } from '../../query/dbQuery.js'
 
 type FilterFn = (v: any, val: any) => boolean
 const FILTER_FNS: Record<DBQueryFilterOperator, FilterFn> = {

package/src/base.common.db.ts

@@ -5,17 +5,17 @@ import type {
   StringMap,
 } from '@naturalcycles/js-lib'
 import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
-import type { CommonDB, CommonDBSupport } from './common.db'
-import { CommonDBType } from './common.db'
+import type { CommonDB, CommonDBSupport } from './common.db.js'
+import { CommonDBType } from './common.db.js'
 import type {
   CommonDBOptions,
   CommonDBSaveOptions,
   CommonDBTransactionOptions,
   DBTransactionFn,
   RunQueryResult,
-} from './db.model'
-import type { DBQuery } from './query/dbQuery'
-import { FakeDBTransaction } from './transaction/dbTransaction.util'
+} from './db.model.js'
+import type { DBQuery } from './query/dbQuery.js'
+import { FakeDBTransaction } from './transaction/dbTransaction.util.js'
 
 /**
  * No-op implementation of CommonDB interface.
@@ -93,6 +93,10 @@ export class BaseCommonDB implements CommonDB {
     // there's no try/catch and rollback, as there's nothing to rollback
   }
 
+  async createTransaction(_opt?: CommonDBTransactionOptions): Promise<FakeDBTransaction> {
+    return new FakeDBTransaction(this)
+  }
+
   async incrementBatch(
     _table: string,
     _prop: string,

package/src/common.db.ts

@@ -12,10 +12,11 @@ import type {
   CommonDBSaveOptions,
   CommonDBStreamOptions,
   CommonDBTransactionOptions,
+  DBTransaction,
   DBTransactionFn,
   RunQueryResult,
-} from './db.model'
-import type { DBQuery } from './query/dbQuery'
+} from './db.model.js'
+import type { DBQuery } from './query/dbQuery.js'
 
 export enum CommonDBType {
   'document' = 'document',
@@ -151,6 +152,13 @@ export interface CommonDB {
    */
   runInTransaction: (fn: DBTransactionFn, opt?: CommonDBTransactionOptions) => Promise<void>
 
+  /**
+   * Experimental API to support more manual transaction control.
+   *
+   * @experimental
+   */
+  createTransaction: (opt?: CommonDBTransactionOptions) => Promise<DBTransaction>
+
   /**
    * Increments a value of a property by a given amount.
    * This is a batch operation, so it allows to increment multiple rows at once.

package/src/commondao/common.dao.model.ts

@@ -15,8 +15,8 @@ import type {
   TransformLogProgressOptions,
   TransformMapOptions,
 } from '@naturalcycles/nodejs-lib'
-import type { CommonDB } from '../common.db'
-import type { CommonDBCreateOptions, CommonDBOptions, CommonDBSaveOptions } from '../db.model'
+import type { CommonDB } from '../common.db.js'
+import type { CommonDBCreateOptions, CommonDBOptions, CommonDBSaveOptions } from '../db.model.js'
 
 export interface CommonDaoHooks<BM extends BaseDBEntity, DBM extends BaseDBEntity, ID = BM['id']> {
   /**

package/src/commondao/common.dao.ts

@@ -47,10 +47,10 @@ import {
   transformNoOp,
   writableVoid,
 } from '@naturalcycles/nodejs-lib'
-import { DBLibError } from '../cnst'
-import type { CommonDBTransactionOptions, DBTransaction, RunQueryResult } from '../db.model'
-import type { DBQuery } from '../query/dbQuery'
-import { RunnableDBQuery } from '../query/dbQuery'
+import { DBLibError } from '../cnst.js'
+import type { CommonDBTransactionOptions, DBTransaction, RunQueryResult } from '../db.model.js'
+import type { DBQuery } from '../query/dbQuery.js'
+import { RunnableDBQuery } from '../query/dbQuery.js'
 import type {
   CommonDaoCfg,
   CommonDaoCreateOptions,
@@ -65,8 +65,8 @@ import type {
   CommonDaoStreamForEachOptions,
   CommonDaoStreamOptions,
   CommonDaoStreamSaveOptions,
-} from './common.dao.model'
-import { CommonDaoLogLevel } from './common.dao.model'
+} from './common.dao.model.js'
+import { CommonDaoLogLevel } from './common.dao.model.js'
 
 const isGAE = !!process.env['GAE_INSTANCE']
 const isCI = !!process.env['CI']
@@ -1307,6 +1307,11 @@ export class CommonDao<BM extends BaseDBEntity, DBM extends BaseDBEntity = BM, I
     await this.cfg.db.ping()
   }
 
+  async createTransaction(opt?: CommonDBTransactionOptions): Promise<CommonDaoTransaction> {
+    const tx = await this.cfg.db.createTransaction(opt)
+    return new CommonDaoTransaction(tx, this.cfg.logger!)
+  }
+
   async runInTransaction<T = void>(
     fn: CommonDaoTransactionFn<T>,
     opt?: CommonDBTransactionOptions,
@@ -1419,8 +1424,17 @@ export class CommonDaoTransaction {
     private logger: CommonLogger,
   ) {}
 
+  /**
+   * Commits the underlying DBTransaction.
+   * May throw.
+   */
+  async commit(): Promise<void> {
+    await this.tx.commit()
+  }
+
   /**
    * Perform a graceful rollback without throwing/re-throwing any error.
+   * Never throws.
    */
   async rollback(): Promise<void> {
     try {

package/src/db.model.ts

@@ -1,5 +1,5 @@
 import type { ObjectWithId, UnixTimestamp } from '@naturalcycles/js-lib'
-import type { CommonDB } from './common.db'
+import type { CommonDB } from './common.db.js'
 
 /**
  * Similar to SQL INSERT, UPDATE.
@@ -27,6 +27,12 @@ export interface DBTransaction {
   saveBatch: CommonDB['saveBatch']
   deleteByIds: CommonDB['deleteByIds']
 
+  /**
+   * Commit the transaction.
+   * May throw.
+   */
+  commit: () => Promise<void>
+
   /**
    * Perform a graceful rollback.
    * It'll rollback the transaction and won't throw/re-throw any errors.

package/src/index.ts

@@ -1,17 +1,17 @@
-export * from './adapter/inmemory/inMemory.db'
-export * from './adapter/inmemory/inMemoryKeyValueDB'
-export * from './adapter/inmemory/queryInMemory'
-export * from './base.common.db'
-export * from './common.db'
-export * from './commondao/common.dao'
-export * from './commondao/common.dao.model'
-export * from './db.model'
-export * from './kv/commonKeyValueDao'
-export * from './kv/commonKeyValueDaoMemoCache'
-export * from './kv/commonKeyValueDB'
-export * from './model.util'
-export * from './pipeline/dbPipelineBackup'
-export * from './pipeline/dbPipelineCopy'
-export * from './pipeline/dbPipelineRestore'
-export * from './query/dbQuery'
-export * from './transaction/dbTransaction.util'
+export * from './adapter/inmemory/inMemory.db.js'
+export * from './adapter/inmemory/inMemoryKeyValueDB.js'
+export * from './adapter/inmemory/queryInMemory.js'
+export * from './base.common.db.js'
+export * from './common.db.js'
+export * from './commondao/common.dao.js'
+export * from './commondao/common.dao.model.js'
+export * from './db.model.js'
+export * from './kv/commonKeyValueDao.js'
+export * from './kv/commonKeyValueDaoMemoCache.js'
+export * from './kv/commonKeyValueDB.js'
+export * from './model.util.js'
+export * from './pipeline/dbPipelineBackup.js'
+export * from './pipeline/dbPipelineCopy.js'
+export * from './pipeline/dbPipelineRestore.js'
+export * from './query/dbQuery.js'
+export * from './transaction/dbTransaction.util.js'

package/src/kv/commonKeyValueDB.ts

@@ -1,6 +1,6 @@
 import type { Integer, UnixTimestamp } from '@naturalcycles/js-lib'
 import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
-import type { CommonDBCreateOptions } from '../db.model'
+import type { CommonDBCreateOptions } from '../db.model.js'
 
 /**
  * Common interface for Key-Value database implementations.

package/src/kv/commonKeyValueDao.ts

@@ -2,14 +2,14 @@ import type { CommonLogger, KeyValueTuple } from '@naturalcycles/js-lib'
 import { AppError, pMap } from '@naturalcycles/js-lib'
 import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
 import { deflateString, inflateToString } from '@naturalcycles/nodejs-lib'
-import type { CommonDaoLogLevel } from '../commondao/common.dao.model'
-import type { CommonDBCreateOptions } from '../db.model'
+import type { CommonDaoLogLevel } from '../commondao/common.dao.model.js'
+import type { CommonDBCreateOptions } from '../db.model.js'
 import type {
   CommonKeyValueDB,
   CommonKeyValueDBSaveBatchOptions,
   IncrementTuple,
   KeyValueDBTuple,
-} from './commonKeyValueDB'
+} from './commonKeyValueDB.js'
 
 export interface CommonKeyValueDaoCfg<V> {
   db: CommonKeyValueDB

package/src/kv/commonKeyValueDaoMemoCache.ts

@@ -1,6 +1,6 @@
 import type { AsyncMemoCache, NumberOfSeconds, UnixTimestamp } from '@naturalcycles/js-lib'
 import { localTime, MISS } from '@naturalcycles/js-lib'
-import type { CommonKeyValueDao } from './commonKeyValueDao'
+import type { CommonKeyValueDao } from './commonKeyValueDao.js'
 
 export interface CommonKeyValueDaoMemoCacheCfg<VALUE> {
   dao: CommonKeyValueDao<string, VALUE>