@naturalcycles/db-lib 10.0.1 → 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,8 @@ const _TIMESERIES_RAW = '_TIMESERIES_RAW';
  *
  * @experimental
  */
-class CommonTimeSeriesDao {
+export class CommonTimeSeriesDao {
+    cfg;
     constructor(cfg) {
         this.cfg = cfg;
     }
@@ -20,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) {
@@ -61,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)
@@ -76,4 +74,3 @@ class CommonTimeSeriesDao {
         // todo
     }
 }
-exports.CommonTimeSeriesDao = CommonTimeSeriesDao;

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

@@ -1,4 +1,4 @@
-import { 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 { ObjectWithId } from '@naturalcycles/js-lib';
-import type { CommonDB } from '../common.db';
-import { CommonDBOptions, CommonDBSaveOptions, DBTransaction } from '../db.model';
+import type { ObjectWithId } from '@naturalcycles/js-lib';
+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 { CommonDBOptions, CommonDBSaveOptions, DBTransaction } from '../db.model
 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,11 +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);
@@ -112,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 { CommonDBOptions, CommonDBSaveOptions } from '../db.model';
-import { 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,10 +14,11 @@
     "@naturalcycles/nodejs-lib": "^13"
   },
   "devDependencies": {
-    "@naturalcycles/bench-lib": "^3",
-    "@naturalcycles/dev-lib": "^16",
+    "@naturalcycles/bench-lib": "^4",
+    "@naturalcycles/dev-lib": "^17",
     "@types/node": "^22",
     "@vitest/coverage-v8": "^3",
+    "tsx": "^4",
     "vitest": "^3"
   },
   "files": [
@@ -46,7 +48,7 @@
   "engines": {
     "node": ">=22.12.0"
   },
-  "version": "10.0.1",
+  "version": "10.1.0",
   "description": "Lowest Common Denominator API to supported Databases",
   "keywords": [
     "db",
@@ -60,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 { CommonLogger, ObjectWithId } from '@naturalcycles/js-lib'
-import { CommonDB } from '../../common.db'
-import {
+import type { CommonLogger, ObjectWithId } from '@naturalcycles/js-lib'
+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

@@ -1,23 +1,24 @@
 import { Readable } from 'node:stream'
-import {
-  _isTruthy,
+import type {
   JsonSchemaObject,
   JsonSchemaRootObject,
   ObjectWithId,
   StringMap,
 } from '@naturalcycles/js-lib'
-import { ReadableTyped } from '@naturalcycles/nodejs-lib'
-import { BaseCommonDB } from '../../base.common.db'
-import { CommonDB, commonDBFullSupport, CommonDBSupport } from '../../common.db'
-import { RunQueryResult } from '../../db.model'
-import { DBQuery } from '../../query/dbQuery'
-import {
+import { _isTruthy } from '@naturalcycles/js-lib'
+import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
+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 {
+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 { CommonLogger, ObjectWithId } from '@naturalcycles/js-lib'
-import { DBSaveBatchOperation } from '../../db.model'
-import type { DBQueryOrder } from '../../query/dbQuery'
+import type { CommonLogger, ObjectWithId } from '@naturalcycles/js-lib'
+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

@@ -1,3 +1,4 @@
+import type { JsonSchemaRootObject, ObjectWithId, UnixTimestampMillis } from '@naturalcycles/js-lib'
 import {
   _assert,
   _by,
@@ -8,28 +9,23 @@ import {
   _sortObjectDeep,
   _stringMapValues,
   generateJsonSchemaFromData,
-  JsonSchemaRootObject,
   localTime,
-  ObjectWithId,
-  UnixTimestampMillis,
 } from '@naturalcycles/js-lib'
-import { dimGrey, readableCreate, ReadableTyped } from '@naturalcycles/nodejs-lib'
-import {
-  BaseCommonDB,
-  commonDBFullSupport,
-  CommonDBSupport,
-  DBSaveBatchOperation,
-  queryInMemory,
-} from '../..'
-import { CommonDB } from '../../common.db'
-import {
+import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
+import { dimGrey, readableCreate } from '@naturalcycles/nodejs-lib'
+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 { DBQuery } from '../../query/dbQuery'
-import { 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,6 +1,7 @@
-import { _by, ObjectWithId, StringMap } from '@naturalcycles/js-lib'
-import { DBSaveBatchOperation } from '../../db.model'
-import { FileDBPersistencePlugin } from './file.db.model'
+import type { ObjectWithId, StringMap } from '@naturalcycles/js-lib'
+import { _by } from '@naturalcycles/js-lib'
+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 { 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

@@ -1,8 +1,9 @@
 import { Readable } from 'node:stream'
-import { ObjectWithId, pMap } from '@naturalcycles/js-lib'
+import type { ObjectWithId } from '@naturalcycles/js-lib'
+import { pMap } from '@naturalcycles/js-lib'
 import { _pipeline, fs2 } from '@naturalcycles/nodejs-lib'
-import { DBSaveBatchOperation } from '../../db.model'
-import { 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 { ObjectWithId } from '@naturalcycles/js-lib'
-import { DBSaveBatchOperation } from '../../db.model'
-import { FileDBPersistencePlugin } from './file.db.model'
+import type { ObjectWithId } from '@naturalcycles/js-lib'
+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

@@ -1,4 +1,12 @@
 import { Readable } from 'node:stream'
+import type {
+  AnyObjectWithId,
+  CommonLogger,
+  JsonSchemaObject,
+  JsonSchemaRootObject,
+  ObjectWithId,
+  StringMap,
+} from '@naturalcycles/js-lib'
 import {
   _assert,
   _by,
@@ -8,42 +16,26 @@ import {
   _sortObjectDeep,
   _stringMapEntries,
   _stringMapValues,
-  AnyObjectWithId,
-  CommonLogger,
   generateJsonSchemaFromData,
-  JsonSchemaObject,
-  JsonSchemaRootObject,
   localTime,
-  ObjectWithId,
   pMap,
-  StringMap,
 } from '@naturalcycles/js-lib'
-import {
-  _pipeline,
-  bufferReviver,
-  dimGrey,
-  fs2,
-  ReadableTyped,
-  yellow,
-} from '@naturalcycles/nodejs-lib'
-import {
-  CommonDB,
-  commonDBFullSupport,
-  CommonDBSupport,
-  CommonDBTransactionOptions,
-  CommonDBType,
-  DBOperation,
-  DBTransactionFn,
-  queryInMemory,
-} from '../..'
-import {
+import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
+import { _pipeline, bufferReviver, dimGrey, fs2, yellow } from '@naturalcycles/nodejs-lib'
+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 { DBQuery } from '../../query/dbQuery'
+} from '../../db.model.js'
+import type { DBQuery } from '../../query/dbQuery.js'
+import { queryInMemory } from './queryInMemory.js'
 
 export interface InMemoryDBCfg {
   /**
@@ -287,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,13 +1,13 @@
 import { Readable } from 'node:stream'
-import { StringMap } from '@naturalcycles/js-lib'
-import { ReadableTyped } from '@naturalcycles/nodejs-lib'
-import { CommonDBCreateOptions } from '../../db.model'
-import {
+import type { StringMap } from '@naturalcycles/js-lib'
+import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
+import type { CommonDBCreateOptions } from '../../db.model.js'
+import type {
   CommonKeyValueDB,
-  commonKeyValueDBFullSupport,
   IncrementTuple,
   KeyValueDBTuple,
-} from '../../kv/commonKeyValueDB'
+} from '../../kv/commonKeyValueDB.js'
+import { commonKeyValueDBFullSupport } from '../../kv/commonKeyValueDB.js'
 
 export interface InMemoryKeyValueDBCfg {}
 

package/src/adapter/inmemory/queryInMemory.ts

@@ -1,5 +1,6 @@
-import { _get, _pick, ObjectWithId } from '@naturalcycles/js-lib'
-import { DBQuery, DBQueryFilterOperator } from '../../query/dbQuery'
+import type { ObjectWithId } from '@naturalcycles/js-lib'
+import { _get, _pick } from '@naturalcycles/js-lib'
+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

@@ -1,20 +1,21 @@
-import {
+import type {
   JsonSchemaObject,
   JsonSchemaRootObject,
   ObjectWithId,
   StringMap,
 } from '@naturalcycles/js-lib'
-import { ReadableTyped } from '@naturalcycles/nodejs-lib'
-import { CommonDB, CommonDBSupport, CommonDBType } from './common.db'
-import {
+import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
+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 { 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.
@@ -92,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

@@ -1,21 +1,22 @@
-import {
+import type {
   JsonSchemaObject,
   JsonSchemaRootObject,
   ObjectWithId,
   StringMap,
 } from '@naturalcycles/js-lib'
 import type { ReadableTyped } from '@naturalcycles/nodejs-lib'
-import {
+import type {
   CommonDBCreateOptions,
   CommonDBOptions,
   CommonDBReadOptions,
   CommonDBSaveOptions,
   CommonDBStreamOptions,
   CommonDBTransactionOptions,
+  DBTransaction,
   DBTransactionFn,
   RunQueryResult,
-} from './db.model'
-import { 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

@@ -1,14 +1,13 @@
-import {
+import type {
   BaseDBEntity,
   CommonLogger,
   ErrorMode,
   NumberOfMilliseconds,
   Promisable,
   UnixTimestamp,
-  ZodError,
-  ZodSchema,
 } from '@naturalcycles/js-lib'
-import {
+import type { ZodError, ZodSchema } from '@naturalcycles/js-lib/dist/zod/index.js'
+import type {
   AjvSchema,
   AjvValidationError,
   JoiValidationError,
@@ -16,8 +15,8 @@ import {
   TransformLogProgressOptions,
   TransformMapOptions,
 } from '@naturalcycles/nodejs-lib'
-import { CommonDB } from '../common.db'
-import { 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']> {
   /**