@naturalcycles/db-lib 9.14.2 → 9.15.0

package/dist/adapter/cachedb/index.d.ts

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

package/dist/adapter/file/inMemory.persistence.plugin.d.ts

@@ -1,4 +1,4 @@
-import { StringMap, ObjectWithId } from '@naturalcycles/js-lib';
+import { ObjectWithId, StringMap } from '@naturalcycles/js-lib';
 import { DBSaveBatchOperation } from '../../db.model';
 import { FileDBPersistencePlugin } from './file.db.model';
 /**

package/dist/adapter/inmemory/inMemory.db.d.ts

@@ -1,4 +1,4 @@
-import { JsonSchemaObject, StringMap, JsonSchemaRootObject, ObjectWithId, CommonLogger } from '@naturalcycles/js-lib';
+import { CommonLogger, JsonSchemaObject, JsonSchemaRootObject, ObjectWithId, StringMap } from '@naturalcycles/js-lib';
 import { ReadableTyped } from '@naturalcycles/nodejs-lib';
 import { CommonDB, CommonDBTransactionOptions, CommonDBType, DBOperation, DBPatch, DBTransactionFn } from '../..';
 import { CommonDBCreateOptions, CommonDBOptions, CommonDBSaveOptions, DBTransaction, RunQueryResult } from '../../db.model';

package/dist/commondao/common.dao.d.ts

@@ -3,7 +3,7 @@ import { AsyncMapper, BaseDBEntity, CommonLogger, JsonSchemaObject, JsonSchemaRo
 import { AjvSchema, ObjectSchema, ReadableTyped } from '@naturalcycles/nodejs-lib';
 import { CommonDBTransactionOptions, DBPatch, DBTransaction, RunQueryResult } from '../db.model';
 import { DBQuery, RunnableDBQuery } from '../query/dbQuery';
-import { CommonDaoCfg, CommonDaoCreateOptions, CommonDaoOptions, CommonDaoPatchOptions, CommonDaoSaveBatchOptions, CommonDaoSaveOptions, CommonDaoStreamDeleteOptions, CommonDaoStreamForEachOptions, CommonDaoStreamOptions, CommonDaoStreamSaveOptions } from './common.dao.model';
+import { CommonDaoCfg, CommonDaoCreateOptions, CommonDaoOptions, CommonDaoPatchByIdOptions, CommonDaoPatchOptions, CommonDaoSaveBatchOptions, CommonDaoSaveOptions, CommonDaoStreamDeleteOptions, CommonDaoStreamForEachOptions, CommonDaoStreamOptions, CommonDaoStreamSaveOptions } from './common.dao.model';
 /**
  * Lowest common denominator API between supported Databases.
  *
@@ -86,11 +86,11 @@ export declare class CommonDao<BM extends BaseDBEntity, DBM extends BaseDBEntity
      * 2. Applies the patch on top of loaded data.
      * 3. Saves (as fast as possible since the read) with the Patch applied, but only if the data has changed.
      */
-    patchById(id: string, patch: Partial<BM>, opt?: CommonDaoSaveBatchOptions<DBM>): Promise<BM>;
+    patchById(id: string, patch: Partial<BM>, opt?: CommonDaoPatchByIdOptions<DBM>): Promise<BM>;
     /**
      * Like patchById, but runs all operations within a Transaction.
      */
-    patchByIdInTransaction(id: string, patch: Partial<BM>, opt?: CommonDaoSaveBatchOptions<DBM>): Promise<BM>;
+    patchByIdInTransaction(id: string, patch: Partial<BM>, opt?: CommonDaoPatchByIdOptions<DBM>): Promise<BM>;
     /**
      * Same as patchById, but takes the whole object as input.
      * This "whole object" is mutated with the patch and returned.

package/dist/commondao/common.dao.js

@@ -447,7 +447,7 @@ class CommonDao {
      * "Returns", just to have a type of "Saved"
      */
     assignIdCreatedUpdated(obj, opt = {}) {
-        const now = (0, js_lib_1.nowUnix)();
+        const now = js_lib_1.localTime.nowUnix();
         if (this.cfg.useCreatedProperty) {
             obj.created ||= obj.updated || now;
         }
@@ -486,6 +486,7 @@ class CommonDao {
             }
         }
         else {
+            (0, js_lib_1._assert)(!opt.requireToExist, `${this.cfg.table}.patchById(${id}) is required, but missing`);
             patched = this.create({ ...patch, id }, opt);
         }
         return await this.save(patched, opt);

package/dist/commondao/common.dao.model.d.ts

@@ -162,7 +162,7 @@ export interface CommonDaoCfg<BM extends BaseDBEntity, DBM extends BaseDBEntity
     useUpdatedProperty?: boolean;
     /**
      * Defaults to false.
-     * If true - run patch operations (patch, patchById) in a Transaction.
+     * If true - run patch operations (patch, patchById, patchByIdOrCreate) in a Transaction.
      *
      * @experimental
      */
@@ -211,6 +211,16 @@ export interface CommonDaoSaveOptions<BM extends BaseDBEntity, DBM extends BaseD
      */
     skipIfEquals?: BM;
 }
+export interface CommonDaoPatchByIdOptions<DBM extends BaseDBEntity> extends CommonDaoSaveBatchOptions<DBM> {
+    /**
+     * Defaults to false.
+     * With false, if the row doesn't exist - it will be auto-created with `dao.create`.
+     * With true, if the row doesn't exist - it will throw an error.
+     *
+     * Use true when you expect the row to exist and it would be an error if it doesn't.
+     */
+    requireToExist?: boolean;
+}
 export interface CommonDaoPatchOptions<DBM extends BaseDBEntity> extends CommonDaoSaveBatchOptions<DBM> {
     /**
      * If true - patch will skip loading from DB, and will just optimistically patch passed object.

package/dist/index.d.ts

@@ -7,6 +7,7 @@ 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';
@@ -14,4 +15,3 @@ export * from './pipeline/dbPipelineCopy';
 export * from './pipeline/dbPipelineRestore';
 export * from './query/dbQuery';
 export * from './transaction/dbTransaction.util';
-export * from './kv/commonKeyValueDaoMemoCache';

package/dist/index.js

@@ -10,6 +10,7 @@ tslib_1.__exportStar(require("./commondao/common.dao"), exports);
 tslib_1.__exportStar(require("./commondao/common.dao.model"), exports);
 tslib_1.__exportStar(require("./db.model"), exports);
 tslib_1.__exportStar(require("./kv/commonKeyValueDao"), exports);
+tslib_1.__exportStar(require("./kv/commonKeyValueDaoMemoCache"), exports);
 tslib_1.__exportStar(require("./kv/commonKeyValueDB"), exports);
 tslib_1.__exportStar(require("./model.util"), exports);
 tslib_1.__exportStar(require("./pipeline/dbPipelineBackup"), exports);
@@ -17,4 +18,3 @@ tslib_1.__exportStar(require("./pipeline/dbPipelineCopy"), exports);
 tslib_1.__exportStar(require("./pipeline/dbPipelineRestore"), exports);
 tslib_1.__exportStar(require("./query/dbQuery"), exports);
 tslib_1.__exportStar(require("./transaction/dbTransaction.util"), exports);
-tslib_1.__exportStar(require("./kv/commonKeyValueDaoMemoCache"), exports);

package/dist/kv/commonKeyValueDaoMemoCache.js

@@ -18,7 +18,7 @@ class CommonKeyValueDaoMemoCache {
         return (await this.cfg.dao.getById(k)) || js_lib_1.MISS;
     }
     async set(k, v) {
-        const opt = this.cfg.ttl ? { expireAt: (0, js_lib_1.nowUnix)() + this.cfg.ttl } : undefined;
+        const opt = this.cfg.ttl ? { expireAt: js_lib_1.localTime.nowUnix() + this.cfg.ttl } : undefined;
         await this.cfg.dao.save(k, v, opt);
     }
     async clear() {

package/dist/model.util.js

@@ -7,14 +7,14 @@ exports.serializeJsonField = serializeJsonField;
 const js_lib_1 = require("@naturalcycles/js-lib");
 const nodejs_lib_1 = require("@naturalcycles/nodejs-lib");
 function createdUpdatedFields(existingObject) {
-    const now = (0, js_lib_1.nowUnix)();
+    const now = js_lib_1.localTime.nowUnix();
     return {
         created: existingObject?.created || now,
         updated: now,
     };
 }
 function createdUpdatedIdFields(existingObject) {
-    const now = (0, js_lib_1.nowUnix)();
+    const now = js_lib_1.localTime.nowUnix();
     return {
         created: existingObject?.created || now,
         id: existingObject?.id || (0, nodejs_lib_1.stringId)(),

package/dist/pipeline/dbPipelineBackup.d.ts

@@ -1,4 +1,4 @@
-import { AsyncMapper, ErrorMode, UnixTimestampNumber, StringMap } from '@naturalcycles/js-lib';
+import { AsyncMapper, ErrorMode, StringMap, UnixTimestampNumber } from '@naturalcycles/js-lib';
 import { NDJsonStats, TransformLogProgressOptions, TransformMapOptions } from '@naturalcycles/nodejs-lib';
 import { CommonDB } from '../common.db';
 import { DBQuery } from '../index';

package/dist/query/dbQuery.d.ts

@@ -69,6 +69,9 @@ export declare class DBQuery<ROW extends ObjectWithId> {
     filter(name: keyof ROW, op: DBQueryFilterOperator, val: any): this;
     filterEq(name: keyof ROW, val: any): this;
     filterIn(name: keyof ROW, val: any[]): this;
+    /**
+     * Passing 0 means "no limit".
+     */
     limit(limit: number): this;
     offset(offset: number): this;
     order(name: keyof ROW, descending?: boolean): this;

package/dist/query/dbQuery.js

@@ -54,6 +54,9 @@ class DBQuery {
         this._filters.push({ name, op: 'in', val });
         return this;
     }
+    /**
+     * Passing 0 means "no limit".
+     */
     limit(limit) {
         this._limitValue = limit;
         return this;

package/dist/testing/daoTest.js

@@ -8,6 +8,7 @@ const __1 = require("..");
 const common_dao_1 = require("../commondao/common.dao");
 const dbTest_1 = require("./dbTest");
 const test_model_1 = require("./test.model");
+// eslint-disable-next-line jest/no-export
 function runCommonDaoTest(db, quirks = {}) {
     const { support } = db;
     const dao = new common_dao_1.CommonDao({
@@ -186,7 +187,7 @@ function runCommonDaoTest(db, quirks = {}) {
             // cleanup
             await dao.query().deleteByQuery();
             // Test that id, created, updated are created
-            const now = (0, js_lib_1.nowUnix)();
+            const now = js_lib_1.localTime.nowUnix();
             await dao.runInTransaction(async (tx) => {
                 const row = (0, js_lib_1._omit)(item1, ['id', 'created', 'updated']);
                 await tx.save(dao, row);

package/dist/testing/index.d.ts

@@ -1,6 +1,6 @@
 import { runCommonDaoTest } from './daoTest';
 import { CommonDBImplementationQuirks, runCommonDBTest } from './dbTest';
 import { runCommonKeyValueDBTest } from './keyValueDBTest';
-import { createTestItemBM, createTestItemDBM, createTestItemsBM, createTestItemsDBM, TestItemBM, testItemBMJsonSchema, testItemBMSchema, TestItemDBM, TestItemTM, testItemTMSchema, TEST_TABLE } from './test.model';
-export type { TestItemDBM, TestItemBM, TestItemTM, CommonDBImplementationQuirks };
-export { TEST_TABLE, createTestItemDBM, createTestItemBM, createTestItemsDBM, createTestItemsBM, testItemBMSchema, testItemTMSchema, testItemBMJsonSchema, runCommonDBTest, runCommonDaoTest, runCommonKeyValueDBTest, };
+import { createTestItemBM, createTestItemDBM, createTestItemsBM, createTestItemsDBM, TEST_TABLE, TestItemBM, testItemBMJsonSchema, testItemBMSchema, TestItemDBM, TestItemTM, testItemTMSchema } from './test.model';
+export type { CommonDBImplementationQuirks, TestItemBM, TestItemDBM, TestItemTM };
+export { createTestItemBM, createTestItemDBM, createTestItemsBM, createTestItemsDBM, runCommonDaoTest, runCommonDBTest, runCommonKeyValueDBTest, TEST_TABLE, testItemBMJsonSchema, testItemBMSchema, testItemTMSchema, };

package/dist/testing/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runCommonKeyValueDBTest = exports.runCommonDaoTest = exports.runCommonDBTest = exports.testItemBMJsonSchema = exports.testItemTMSchema = exports.testItemBMSchema = exports.createTestItemsBM = exports.createTestItemsDBM = exports.createTestItemBM = exports.createTestItemDBM = exports.TEST_TABLE = void 0;
+exports.testItemTMSchema = exports.testItemBMSchema = exports.testItemBMJsonSchema = exports.TEST_TABLE = exports.runCommonKeyValueDBTest = exports.runCommonDBTest = exports.runCommonDaoTest = exports.createTestItemsDBM = exports.createTestItemsBM = exports.createTestItemDBM = exports.createTestItemBM = void 0;
 const daoTest_1 = require("./daoTest");
 Object.defineProperty(exports, "runCommonDaoTest", { enumerable: true, get: function () { return daoTest_1.runCommonDaoTest; } });
 const dbTest_1 = require("./dbTest");
@@ -12,7 +12,7 @@ Object.defineProperty(exports, "createTestItemBM", { enumerable: true, get: func
 Object.defineProperty(exports, "createTestItemDBM", { enumerable: true, get: function () { return test_model_1.createTestItemDBM; } });
 Object.defineProperty(exports, "createTestItemsBM", { enumerable: true, get: function () { return test_model_1.createTestItemsBM; } });
 Object.defineProperty(exports, "createTestItemsDBM", { enumerable: true, get: function () { return test_model_1.createTestItemsDBM; } });
+Object.defineProperty(exports, "TEST_TABLE", { enumerable: true, get: function () { return test_model_1.TEST_TABLE; } });
 Object.defineProperty(exports, "testItemBMJsonSchema", { enumerable: true, get: function () { return test_model_1.testItemBMJsonSchema; } });
 Object.defineProperty(exports, "testItemBMSchema", { enumerable: true, get: function () { return test_model_1.testItemBMSchema; } });
 Object.defineProperty(exports, "testItemTMSchema", { enumerable: true, get: function () { return test_model_1.testItemTMSchema; } });
-Object.defineProperty(exports, "TEST_TABLE", { enumerable: true, get: function () { return test_model_1.TEST_TABLE; } });

package/dist/testing/keyValueDBTest.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCommonKeyValueDBTest = runCommonKeyValueDBTest;
 const js_lib_1 = require("@naturalcycles/js-lib");
 const test_model_1 = require("./test.model");
+/* eslint-disable jest/no-export */
 const testIds = (0, js_lib_1._range)(1, 4).map(n => `id${n}`);
 const testEntries = testIds.map(id => [id, Buffer.from(`${id}value`)]);
 function runCommonKeyValueDBTest(db) {

package/dist/testing/keyValueDaoTest.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCommonKeyValueDaoTest = runCommonKeyValueDaoTest;
 const js_lib_1 = require("@naturalcycles/js-lib");
+/* eslint-disable jest/no-export */
 const testIds = (0, js_lib_1._range)(1, 4).map(n => `id${n}`);
 const testEntries = testIds.map(id => [id, Buffer.from(`${id}value`)]);
 function runCommonKeyValueDaoTest(dao) {

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "@naturalcycles/db-lib",
   "scripts": {
-    "prepare": "husky"
+    "prepare": "husky",
+    "build": "dev-lib build",
+    "test": "dev-lib test",
+    "lint": "dev-lib lint",
+    "bt": "dev-lib bt",
+    "lbt": "dev-lib lbt"
   },
   "dependencies": {
     "@naturalcycles/js-lib": "^14.116.0",
@@ -9,8 +14,8 @@
   },
   "devDependencies": {
     "@naturalcycles/bench-lib": "^3.0.0",
-    "@naturalcycles/dev-lib": "^13.0.0",
-    "@types/node": "^20.2.1",
+    "@naturalcycles/dev-lib": "^15.4.1",
+    "@types/node": "^22.1.0",
     "jest": "^29.0.0"
   },
   "files": [
@@ -38,9 +43,9 @@
     "url": "https://github.com/NaturalCycles/db-lib"
   },
   "engines": {
-    "node": ">=18.12"
+    "node": ">=20.13"
   },
-  "version": "9.14.2",
+  "version": "9.15.0",
   "description": "Lowest Common Denominator API to supported Databases",
   "keywords": [
     "db",

package/src/adapter/cachedb/index.ts

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

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

@@ -1,17 +1,17 @@
 import {
-  generateJsonSchemaFromData,
+  _assert,
   _by,
   _deepEquals,
+  _filterUndefinedValues,
   _since,
   _sortBy,
   _sortObjectDeep,
   _stringMapValues,
+  generateJsonSchemaFromData,
   JsonSchemaRootObject,
-  _filterUndefinedValues,
-  _assert,
   ObjectWithId,
 } from '@naturalcycles/js-lib'
-import { readableCreate, ReadableTyped, dimGrey } from '@naturalcycles/nodejs-lib'
+import { dimGrey, readableCreate, ReadableTyped } from '@naturalcycles/nodejs-lib'
 import {
   BaseCommonDB,
   commonDBFullSupport,

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

@@ -1,4 +1,4 @@
-import { StringMap, _by, ObjectWithId } from '@naturalcycles/js-lib'
+import { _by, ObjectWithId, StringMap } from '@naturalcycles/js-lib'
 import { DBSaveBatchOperation } from '../../db.model'
 import { FileDBPersistencePlugin } from './file.db.model'
 

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

@@ -1,26 +1,26 @@
 import { Readable } from 'node:stream'
 import {
-  generateJsonSchemaFromData,
-  JsonSchemaObject,
-  pMap,
-  StringMap,
+  _assert,
   _by,
+  _deepCopy,
   _since,
   _sortObjectDeep,
-  JsonSchemaRootObject,
-  ObjectWithId,
   _stringMapValues,
   CommonLogger,
-  _deepCopy,
-  _assert,
+  generateJsonSchemaFromData,
+  JsonSchemaObject,
+  JsonSchemaRootObject,
+  ObjectWithId,
+  pMap,
+  StringMap,
 } from '@naturalcycles/js-lib'
 import {
-  bufferReviver,
-  ReadableTyped,
   _pipeline,
+  bufferReviver,
   dimGrey,
-  yellow,
   fs2,
+  ReadableTyped,
+  yellow,
 } from '@naturalcycles/nodejs-lib'
 import {
   CommonDB,

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

@@ -203,7 +203,7 @@ export interface CommonDaoCfg<BM extends BaseDBEntity, DBM extends BaseDBEntity
 
   /**
    * Defaults to false.
-   * If true - run patch operations (patch, patchById) in a Transaction.
+   * If true - run patch operations (patch, patchById, patchByIdOrCreate) in a Transaction.
    *
    * @experimental
    */
@@ -260,6 +260,18 @@ export interface CommonDaoSaveOptions<BM extends BaseDBEntity, DBM extends BaseD
   skipIfEquals?: BM
 }
 
+export interface CommonDaoPatchByIdOptions<DBM extends BaseDBEntity>
+  extends CommonDaoSaveBatchOptions<DBM> {
+  /**
+   * Defaults to false.
+   * With false, if the row doesn't exist - it will be auto-created with `dao.create`.
+   * With true, if the row doesn't exist - it will throw an error.
+   *
+   * Use true when you expect the row to exist and it would be an error if it doesn't.
+   */
+  requireToExist?: boolean
+}
+
 export interface CommonDaoPatchOptions<DBM extends BaseDBEntity>
   extends CommonDaoSaveBatchOptions<DBM> {
   /**

package/src/commondao/common.dao.ts

@@ -18,7 +18,7 @@ import {
   ErrorMode,
   JsonSchemaObject,
   JsonSchemaRootObject,
-  nowUnix,
+  localTime,
   ObjectWithId,
   pMap,
   SKIP,
@@ -52,6 +52,7 @@ import {
   CommonDaoHooks,
   CommonDaoLogLevel,
   CommonDaoOptions,
+  CommonDaoPatchByIdOptions,
   CommonDaoPatchOptions,
   CommonDaoSaveBatchOptions,
   CommonDaoSaveOptions,
@@ -605,7 +606,7 @@ export class CommonDao<BM extends BaseDBEntity, DBM extends BaseDBEntity = BM> {
    * "Returns", just to have a type of "Saved"
    */
   assignIdCreatedUpdated<T extends BaseDBEntity>(obj: Partial<T>, opt: CommonDaoOptions = {}): T {
-    const now = nowUnix()
+    const now = localTime.nowUnix()
 
     if (this.cfg.useCreatedProperty) {
       obj.created ||= obj.updated || now
@@ -635,7 +636,7 @@ export class CommonDao<BM extends BaseDBEntity, DBM extends BaseDBEntity = BM> {
   async patchById(
     id: string,
     patch: Partial<BM>,
-    opt: CommonDaoSaveBatchOptions<DBM> = {},
+    opt: CommonDaoPatchByIdOptions<DBM> = {},
   ): Promise<BM> {
     if (this.cfg.patchInTransaction && !opt.tx) {
       // patchInTransaction means that we should run this op in Transaction
@@ -655,6 +656,7 @@ export class CommonDao<BM extends BaseDBEntity, DBM extends BaseDBEntity = BM> {
         return patched
       }
     } else {
+      _assert(!opt.requireToExist, `${this.cfg.table}.patchById(${id}) is required, but missing`)
       patched = this.create({ ...patch, id }, opt)
     }
 
@@ -667,7 +669,7 @@ export class CommonDao<BM extends BaseDBEntity, DBM extends BaseDBEntity = BM> {
   async patchByIdInTransaction(
     id: string,
     patch: Partial<BM>,
-    opt?: CommonDaoSaveBatchOptions<DBM>,
+    opt?: CommonDaoPatchByIdOptions<DBM>,
   ): Promise<BM> {
     return await this.runInTransaction(async daoTx => {
       return await this.patchById(id, patch, { ...opt, tx: daoTx.tx })

package/src/index.ts

@@ -7,6 +7,7 @@ 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'
@@ -14,4 +15,3 @@ export * from './pipeline/dbPipelineCopy'
 export * from './pipeline/dbPipelineRestore'
 export * from './query/dbQuery'
 export * from './transaction/dbTransaction.util'
-export * from './kv/commonKeyValueDaoMemoCache'

package/src/kv/commonKeyValueDaoMemoCache.ts

@@ -1,4 +1,4 @@
-import { AsyncMemoCache, MISS, nowUnix, NumberOfSeconds } from '@naturalcycles/js-lib'
+import { AsyncMemoCache, localTime, MISS, NumberOfSeconds } from '@naturalcycles/js-lib'
 import { CommonKeyValueDao } from './commonKeyValueDao'
 
 export interface CommonKeyValueDaoMemoCacheCfg<VALUE> {
@@ -26,7 +26,7 @@ export class CommonKeyValueDaoMemoCache<VALUE = any> implements AsyncMemoCache<s
   }
 
   async set(k: string, v: VALUE): Promise<void> {
-    const opt = this.cfg.ttl ? { expireAt: nowUnix() + this.cfg.ttl } : undefined
+    const opt = this.cfg.ttl ? { expireAt: localTime.nowUnix() + this.cfg.ttl } : undefined
 
     await this.cfg.dao.save(k, v, opt)
   }

package/src/model.util.ts

@@ -1,10 +1,10 @@
-import { CreatedUpdated, CreatedUpdatedId, nowUnix } from '@naturalcycles/js-lib'
+import { CreatedUpdated, CreatedUpdatedId, localTime } from '@naturalcycles/js-lib'
 import { stringId } from '@naturalcycles/nodejs-lib'
 
 export function createdUpdatedFields(
   existingObject?: Partial<CreatedUpdated> | null,
 ): CreatedUpdated {
-  const now = nowUnix()
+  const now = localTime.nowUnix()
   return {
     created: existingObject?.created || now,
     updated: now,
@@ -14,7 +14,7 @@ export function createdUpdatedFields(
 export function createdUpdatedIdFields(
   existingObject?: Partial<CreatedUpdatedId> | null,
 ): CreatedUpdatedId {
-  const now = nowUnix()
+  const now = localTime.nowUnix()
   return {
     created: existingObject?.created || now,
     id: existingObject?.id || stringId(),

package/src/pipeline/dbPipelineBackup.ts

@@ -1,26 +1,26 @@
 import {
+  _passthroughMapper,
   AppError,
   AsyncMapper,
   ErrorMode,
-  pMap,
-  _passthroughMapper,
   localTime,
-  UnixTimestampNumber,
+  pMap,
   StringMap,
+  UnixTimestampNumber,
 } from '@naturalcycles/js-lib'
 import {
+  _pipeline,
+  boldWhite,
+  dimWhite,
+  fs2,
+  grey,
   NDJsonStats,
   transformLogProgress,
   TransformLogProgressOptions,
   transformMap,
   TransformMapOptions,
   transformTap,
-  _pipeline,
-  boldWhite,
-  dimWhite,
-  grey,
   yellow,
-  fs2,
 } from '@naturalcycles/nodejs-lib'
 import { CommonDB } from '../common.db'
 import { DBQuery } from '../index'

package/src/pipeline/dbPipelineCopy.ts

@@ -1,12 +1,16 @@
 import {
+  _passthroughMapper,
   AsyncMapper,
+  BaseDBEntity,
   ErrorMode,
-  pMap,
-  _passthroughMapper,
   localTime,
-  BaseDBEntity,
+  pMap,
 } from '@naturalcycles/js-lib'
 import {
+  _pipeline,
+  boldWhite,
+  dimWhite,
+  grey,
   NDJsonStats,
   transformChunk,
   transformLogProgress,
@@ -15,10 +19,6 @@ import {
   TransformMapOptions,
   transformTap,
   writableForEach,
-  _pipeline,
-  boldWhite,
-  dimWhite,
-  grey,
   yellow,
 } from '@naturalcycles/nodejs-lib'
 import { CommonDB } from '../common.db'

package/src/pipeline/dbPipelineRestore.ts

@@ -1,15 +1,20 @@
 import {
-  AsyncMapper,
-  ErrorMode,
-  pMap,
   _hb,
   _mapValues,
   _passthroughMapper,
-  localTime,
-  JsonSchemaObject,
+  AsyncMapper,
   BaseDBEntity,
+  ErrorMode,
+  JsonSchemaObject,
+  localTime,
+  pMap,
 } from '@naturalcycles/js-lib'
 import {
+  _pipeline,
+  boldWhite,
+  dimWhite,
+  fs2,
+  grey,
   NDJsonStats,
   transformChunk,
   transformFilterSync,
@@ -19,12 +24,7 @@ import {
   TransformMapOptions,
   transformTap,
   writableForEach,
-  _pipeline,
-  boldWhite,
-  dimWhite,
-  grey,
   yellow,
-  fs2,
 } from '@naturalcycles/nodejs-lib'
 import { CommonDB } from '../common.db'
 import { CommonDBSaveOptions } from '../index'

package/src/query/dbQuery.ts

@@ -1,7 +1,7 @@
 import {
-  AsyncMapper,
-  _truncate,
   _objectAssign,
+  _truncate,
+  AsyncMapper,
   BaseDBEntity,
   ObjectWithId,
 } from '@naturalcycles/js-lib'
@@ -128,6 +128,9 @@ export class DBQuery<ROW extends ObjectWithId> {
     return this
   }
 
+  /**
+   * Passing 0 means "no limit".
+   */
   limit(limit: number): this {
     this._limitValue = limit
     return this

package/src/testing/daoTest.ts

@@ -1,19 +1,20 @@
 import { Readable } from 'node:stream'
-import { _deepCopy, _pick, _sortBy, _omit, nowUnix } from '@naturalcycles/js-lib'
+import { _deepCopy, _omit, _pick, _sortBy, localTime } from '@naturalcycles/js-lib'
 import { _pipeline } from '@naturalcycles/nodejs-lib'
 import { CommonDaoLogLevel, DBQuery } from '..'
 import { CommonDB } from '../common.db'
 import { CommonDao } from '../commondao/common.dao'
+import { TestItemBM } from '.'
 import { CommonDBImplementationQuirks, expectMatch } from './dbTest'
 import {
+  createTestItemBM,
   createTestItemsBM,
-  testItemBMSchema,
   TEST_TABLE,
-  createTestItemBM,
   testItemBMJsonSchema,
+  testItemBMSchema,
 } from './test.model'
-import { TestItemBM } from '.'
 
+// eslint-disable-next-line jest/no-export
 export function runCommonDaoTest(db: CommonDB, quirks: CommonDBImplementationQuirks = {}): void {
   const { support } = db
   const dao = new CommonDao({
@@ -255,7 +256,7 @@ export function runCommonDaoTest(db: CommonDB, quirks: CommonDBImplementationQui
       await dao.query().deleteByQuery()
 
       // Test that id, created, updated are created
-      const now = nowUnix()
+      const now = localTime.nowUnix()
 
       await dao.runInTransaction(async tx => {
         const row = _omit(item1, ['id', 'created', 'updated'])

package/src/testing/dbTest.ts

@@ -11,6 +11,8 @@ import {
 } from './test.model'
 import { deepFreeze } from './test.util'
 
+/* eslint-disable jest/no-export */
+
 /**
  * All options default to `false`.
  */

package/src/testing/index.ts

@@ -6,27 +6,27 @@ import {
   createTestItemDBM,
   createTestItemsBM,
   createTestItemsDBM,
+  TEST_TABLE,
   TestItemBM,
   testItemBMJsonSchema,
   testItemBMSchema,
   TestItemDBM,
   TestItemTM,
   testItemTMSchema,
-  TEST_TABLE,
 } from './test.model'
 
-export type { TestItemDBM, TestItemBM, TestItemTM, CommonDBImplementationQuirks }
+export type { CommonDBImplementationQuirks, TestItemBM, TestItemDBM, TestItemTM }
 
 export {
-  TEST_TABLE,
-  createTestItemDBM,
   createTestItemBM,
-  createTestItemsDBM,
+  createTestItemDBM,
   createTestItemsBM,
-  testItemBMSchema,
-  testItemTMSchema,
-  testItemBMJsonSchema,
-  runCommonDBTest,
+  createTestItemsDBM,
   runCommonDaoTest,
+  runCommonDBTest,
   runCommonKeyValueDBTest,
+  TEST_TABLE,
+  testItemBMJsonSchema,
+  testItemBMSchema,
+  testItemTMSchema,
 }

package/src/testing/keyValueDBTest.ts

@@ -2,6 +2,8 @@ import { _range, _sortBy } from '@naturalcycles/js-lib'
 import { CommonKeyValueDB, KeyValueDBTuple } from '../kv/commonKeyValueDB'
 import { TEST_TABLE } from './test.model'
 
+/* eslint-disable jest/no-export */
+
 const testIds = _range(1, 4).map(n => `id${n}`)
 
 const testEntries: KeyValueDBTuple[] = testIds.map(id => [id, Buffer.from(`${id}value`)])

package/src/testing/keyValueDaoTest.ts

@@ -1,6 +1,8 @@
 import { _range, _sortBy } from '@naturalcycles/js-lib'
-import { KeyValueDBTuple } from '../kv/commonKeyValueDB'
 import { CommonKeyValueDao } from '../kv/commonKeyValueDao'
+import { KeyValueDBTuple } from '../kv/commonKeyValueDB'
+
+/* eslint-disable jest/no-export */
 
 const testIds = _range(1, 4).map(n => `id${n}`)
 const testEntries: KeyValueDBTuple[] = testIds.map(id => [id, Buffer.from(`${id}value`)])

package/src/testing/test.model.ts

@@ -1,4 +1,4 @@
-import { jsonSchema, _range, BaseDBEntity, JsonSchemaObject } from '@naturalcycles/js-lib'
+import { _range, BaseDBEntity, jsonSchema, JsonSchemaObject } from '@naturalcycles/js-lib'
 import {
   baseDBEntitySchema,
   binarySchema,