@naturalcycles/nodejs-lib 15.2.0 → 15.4.0

package/src/script/runScript.ts

@@ -1,6 +1,10 @@
+import 'dotenv/config'
 import os from 'node:os'
-import type { AnyObject, CommonLogger } from '@naturalcycles/js-lib'
-import { pDelay, setGlobalStringifyFunction } from '@naturalcycles/js-lib'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
+import { pDelay } from '@naturalcycles/js-lib/promise'
+import { setGlobalStringifyFunction } from '@naturalcycles/js-lib/string'
+import type { AnyObject } from '@naturalcycles/js-lib/types'
+import { dimGrey } from '../colors/colors.js'
 import { inspectStringifyFn } from '../string/inspect.js'
 
 export interface RunScriptOptions {
@@ -44,6 +48,7 @@ const { DEBUG_RUN_SCRIPT } = process.env
  * Set env DEBUG_RUN_SCRIPT for extra debugging.
  */
 export function runScript(fn: (...args: any[]) => any, opt: RunScriptOptions = {}): void {
+  checkAndlogEnvironment()
   setGlobalStringifyFunction(inspectStringifyFn)
 
   const { logger = console, noExit, registerUncaughtExceptionHandlers = true } = opt
@@ -67,9 +72,6 @@ export function runScript(fn: (...args: any[]) => any, opt: RunScriptOptions = {
 
   void (async () => {
     try {
-      await import('dotenv/config')
-      await checkAndlogEnvironment()
-
       await fn()
 
       await pDelay() // to ensure all async operations are completed
@@ -91,9 +93,7 @@ export function runScript(fn: (...args: any[]) => any, opt: RunScriptOptions = {
   })()
 }
 
-async function checkAndlogEnvironment(): Promise<void> {
-  const { dimGrey } = await import('../colors/colors.js')
-
+function checkAndlogEnvironment(): void {
   const {
     platform,
     arch,

package/src/secret/secrets-decrypt.util.ts

@@ -1,6 +1,6 @@
 import fs from 'node:fs'
 import path from 'node:path'
-import { _assert } from '@naturalcycles/js-lib'
+import { _assert } from '@naturalcycles/js-lib/error'
 import { globSync } from 'tinyglobby'
 import { dimGrey, yellow } from '../colors/colors.js'
 import { fs2 } from '../fs/fs2.js'

package/src/secret/secrets-encrypt.util.ts

@@ -1,6 +1,6 @@
 import fs from 'node:fs'
 import path from 'node:path'
-import { _assert } from '@naturalcycles/js-lib'
+import { _assert } from '@naturalcycles/js-lib/error'
 import { globSync } from 'tinyglobby'
 import { dimGrey, yellow } from '../colors/colors.js'
 import { fs2 } from '../fs/fs2.js'

package/src/security/crypto.util.ts

@@ -1,6 +1,5 @@
 import crypto from 'node:crypto'
-import type { Base64String, StringMap } from '@naturalcycles/js-lib'
-import { _stringMapEntries } from '@naturalcycles/js-lib'
+import { _stringMapEntries, type Base64String, type StringMap } from '@naturalcycles/js-lib/types'
 import { md5AsBuffer, sha256AsBuffer } from './hash.util.js'
 
 const algorithm = 'aes-256-cbc'

package/src/security/hash.util.ts

@@ -1,6 +1,6 @@
 import type { BinaryToTextEncoding } from 'node:crypto'
 import { hash as cryptoHash } from 'node:crypto'
-import type { Base64String, Base64UrlString } from '@naturalcycles/js-lib'
+import type { Base64String, Base64UrlString } from '@naturalcycles/js-lib/types'
 
 export function md5(s: string | Buffer, outputEncoding: BinaryToTextEncoding = 'hex'): string {
   return hash(s, 'md5', outputEncoding)

package/src/security/secret.util.ts

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs'
-import type { Base64String, StringMap } from '@naturalcycles/js-lib'
-import { _assert, _jsonParseIfPossible } from '@naturalcycles/js-lib'
+import { _assert } from '@naturalcycles/js-lib/error'
+import { _jsonParseIfPossible } from '@naturalcycles/js-lib/string'
+import type { Base64String, StringMap } from '@naturalcycles/js-lib/types'
 import { decryptObject, decryptRandomIVBuffer } from './crypto.util.js'
 
 let loaded = false

package/src/slack/index.ts

@@ -0,0 +1,2 @@
+export * from './slack.service.js'
+export * from './slack.service.model.js'

package/src/slack/slack.service.model.ts

@@ -1,5 +1,6 @@
-import type { AnyObject, CommonLogger } from '@naturalcycles/js-lib'
-import type { InspectAnyOptions } from '../index.js'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
+import type { AnyObject } from '@naturalcycles/js-lib/types'
+import type { InspectAnyOptions } from '../string/inspect.js'
 
 /**
  * Properties that exists both in SlackApiBody (as per Slack API) and SlackMessage (our abstraction).

package/src/slack/slack.service.ts

@@ -1,7 +1,14 @@
-import type { AnyObject, CommonLogger, CommonLogLevel, Fetcher } from '@naturalcycles/js-lib'
-import { _omit, commonLoggerMinLevel, getFetcher, localTime, PQueue } from '@naturalcycles/js-lib'
-import type { InspectAnyOptions } from '../index.js'
-import { _inspect } from '../index.js'
+import { localTime } from '@naturalcycles/js-lib/datetime'
+import { type Fetcher, getFetcher } from '@naturalcycles/js-lib/http'
+import {
+  type CommonLogger,
+  commonLoggerMinLevel,
+  type CommonLogLevel,
+} from '@naturalcycles/js-lib/log'
+import { _omit } from '@naturalcycles/js-lib/object'
+import { PQueue } from '@naturalcycles/js-lib/promise'
+import type { AnyObject } from '@naturalcycles/js-lib/types'
+import { _inspect, type InspectAnyOptions } from '../index.js'
 import type {
   SlackApiBody,
   SlackAttachmentField,

package/src/stream/ndjson/ndjson.model.ts

@@ -1,4 +1,5 @@
-import { _hb, _ms } from '@naturalcycles/js-lib'
+import { _hb } from '@naturalcycles/js-lib'
+import { _ms } from '@naturalcycles/js-lib/datetime'
 import { boldWhite, dimWhite } from '../../colors/colors.js'
 
 export class NDJsonStats {

package/src/stream/ndjson/ndjsonMap.ts

@@ -1,5 +1,5 @@
-import type { AbortableAsyncMapper } from '@naturalcycles/js-lib'
-import { ErrorMode } from '@naturalcycles/js-lib'
+import { ErrorMode } from '@naturalcycles/js-lib/error'
+import type { AbortableAsyncMapper } from '@naturalcycles/js-lib/types'
 import {
   createReadStreamAsNDJSON,
   createWriteStreamAsNDJSON,

package/src/stream/ndjson/ndjsonStreamForEach.ts

@@ -1,11 +1,13 @@
-import type { AbortableAsyncMapper } from '@naturalcycles/js-lib'
-import { ErrorMode } from '@naturalcycles/js-lib'
+import { ErrorMode } from '@naturalcycles/js-lib/error'
+import type { AbortableAsyncMapper } from '@naturalcycles/js-lib/types'
+import { _pipeline } from '../pipeline/pipeline.js'
 import {
-  createReadStreamAsNDJSON,
+  transformLogProgress,
   type TransformLogProgressOptions,
-  type TransformMapOptions,
-} from '../index.js'
-import { _pipeline, transformLogProgress, transformMap, writableVoid } from '../index.js'
+} from '../transform/transformLogProgress.js'
+import { transformMap, type TransformMapOptions } from '../transform/transformMap.js'
+import { writableVoid } from '../writable/writableVoid.js'
+import { createReadStreamAsNDJSON } from './createReadStreamAsNDJSON.js'
 
 export interface NDJSONStreamForEachOptions<IN = any>
   extends TransformMapOptions<IN, void>,

package/src/stream/ndjson/transformJsonParse.ts

@@ -1,5 +1,5 @@
 import { Transform } from 'node:stream'
-import type { Reviver } from '@naturalcycles/js-lib'
+import type { Reviver } from '@naturalcycles/js-lib/types'
 import type { TransformTyped } from '../stream.model.js'
 
 export interface TransformJsonParseOptions {

package/src/stream/ndjson/transformToNDJson.ts

@@ -1,5 +1,5 @@
 import { Transform } from 'node:stream'
-import { _sortObjectDeep } from '@naturalcycles/js-lib'
+import { _sortObjectDeep } from '@naturalcycles/js-lib/object'
 import type { TransformTyped } from '../stream.model.js'
 
 export interface TransformToNDJsonOptions {

package/src/stream/pipeline/pipeline.ts

@@ -1,8 +1,10 @@
 import type { Readable, Writable } from 'node:stream'
 import { Transform } from 'node:stream'
 import { pipeline } from 'node:stream/promises'
-import type { AnyFunction, DeferredPromise } from '@naturalcycles/js-lib'
-import { _last, pDefer } from '@naturalcycles/js-lib'
+import { _last } from '@naturalcycles/js-lib'
+import type { DeferredPromise } from '@naturalcycles/js-lib/promise'
+import { pDefer } from '@naturalcycles/js-lib/promise'
+import type { AnyFunction } from '@naturalcycles/js-lib/types'
 import { writablePushToArray } from '../writable/writablePushToArray.js'
 
 type AnyStream = NodeJS.ReadableStream | NodeJS.WritableStream | NodeJS.ReadWriteStream

package/src/stream/progressLogger.ts

@@ -1,7 +1,10 @@
 import type { InspectOptions } from 'node:util'
 import { inspect } from 'node:util'
-import type { AnyObject, CommonLogger, UnixTimestampMillis } from '@naturalcycles/js-lib'
-import { _mb, _since, localTime, SimpleMovingAverage } from '@naturalcycles/js-lib'
+import { _mb } from '@naturalcycles/js-lib'
+import { _since, localTime } from '@naturalcycles/js-lib/datetime'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
+import { SimpleMovingAverage } from '@naturalcycles/js-lib/math'
+import type { AnyObject, UnixTimestampMillis } from '@naturalcycles/js-lib/types'
 import { boldWhite, dimGrey, hasColors, white, yellow } from '../colors/colors.js'
 import { SizeStack } from './sizeStack.js'
 import type { ReadableMapper } from './stream.model.js'

package/src/stream/readable/readableForEach.ts

@@ -1,7 +1,7 @@
-import type { AbortableAsyncMapper, IndexedMapper } from '@naturalcycles/js-lib'
-import { _passNothingPredicate } from '@naturalcycles/js-lib'
-import type { ReadableTyped } from '../index.js'
-import { _pipeline } from '../index.js'
+import type { AbortableAsyncMapper, IndexedMapper } from '@naturalcycles/js-lib/types'
+import { _passNothingPredicate } from '@naturalcycles/js-lib/types'
+import { _pipeline } from '../pipeline/pipeline.js'
+import type { ReadableTyped } from '../stream.model.js'
 import type { TransformMapOptions } from '../transform/transformMap.js'
 import { transformMap } from '../transform/transformMap.js'
 

package/src/stream/readable/readableFromArray.ts

@@ -1,7 +1,7 @@
 import type { ReadableOptions } from 'node:stream'
 import { Readable } from 'node:stream'
-import type { AbortableAsyncMapper } from '@naturalcycles/js-lib'
-import { _passthroughMapper } from '@naturalcycles/js-lib'
+import type { AbortableAsyncMapper } from '@naturalcycles/js-lib/types'
+import { _passthroughMapper } from '@naturalcycles/js-lib/types'
 import type { ReadableTyped } from '../stream.model.js'
 
 /**

package/src/stream/sizeStack.ts

@@ -1,5 +1,6 @@
-import type { CommonLogger } from '@naturalcycles/js-lib'
-import { _hb, NumberStack } from '@naturalcycles/js-lib'
+import { _hb } from '@naturalcycles/js-lib'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
+import { NumberStack } from '@naturalcycles/js-lib/math'
 import { yellow } from '../colors/colors.js'
 import { gzipBuffer } from '../zip/zip.util.js'
 

package/src/stream/stream.model.ts

@@ -1,5 +1,5 @@
 import type { Readable, Transform, Writable } from 'node:stream'
-import type { Promisable } from '@naturalcycles/js-lib'
+import type { Promisable } from '@naturalcycles/js-lib/types'
 
 export interface ReadableSignalOptions {
   /** allows destroying the stream if the signal is aborted. */

package/src/stream/stream.util.ts

@@ -1,5 +1,5 @@
 import type { Readable } from 'node:stream'
-import type { CommonLogger } from '@naturalcycles/js-lib'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
 
 export function pipelineClose(
   name: string,

package/src/stream/transform/transformFilter.ts

@@ -1,5 +1,5 @@
 import { Transform } from 'node:stream'
-import type { AsyncPredicate, Predicate } from '@naturalcycles/js-lib'
+import type { AsyncPredicate, Predicate } from '@naturalcycles/js-lib/types'
 import type { TransformOptions, TransformTyped } from '../stream.model.js'
 import type { TransformMapOptions } from './transformMap.js'
 import { transformMap } from './transformMap.js'

package/src/stream/transform/transformLimit.ts

@@ -1,8 +1,9 @@
 import type { Readable } from 'node:stream'
-import type { CommonLogger } from '@naturalcycles/js-lib'
-import { AbortableTransform, transformNoOp } from '../index.js'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
+import { AbortableTransform } from '../pipeline/pipeline.js'
 import type { TransformOptions, TransformTyped } from '../stream.model.js'
 import { pipelineClose } from '../stream.util.js'
+import { transformNoOp } from './transformNoOp.js'
 
 export interface TransformLimitOptions extends TransformOptions {
   /**

package/src/stream/transform/transformMap.ts

@@ -1,21 +1,18 @@
-import type {
-  AbortableAsyncMapper,
-  AsyncPredicate,
-  CommonLogger,
-  Promisable,
-  StringMap,
-  UnixTimestampMillis,
-} from '@naturalcycles/js-lib'
+import { _hc } from '@naturalcycles/js-lib'
+import { _since } from '@naturalcycles/js-lib/datetime'
+import { _anyToError, ErrorMode } from '@naturalcycles/js-lib/error'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
+import { pFilter } from '@naturalcycles/js-lib/promise'
+import { _stringify } from '@naturalcycles/js-lib/string'
 import {
-  _anyToError,
-  _hc,
-  _since,
-  _stringify,
+  type AbortableAsyncMapper,
+  type AsyncPredicate,
   END,
-  ErrorMode,
-  pFilter,
+  type Promisable,
   SKIP,
-} from '@naturalcycles/js-lib'
+  type StringMap,
+  type UnixTimestampMillis,
+} from '@naturalcycles/js-lib/types'
 import through2Concurrent from 'through2-concurrent'
 import { yellow } from '../../colors/colors.js'
 import type { AbortableTransform } from '../pipeline/pipeline.js'

package/src/stream/transform/transformMapSimple.ts

@@ -1,6 +1,7 @@
 import { Transform } from 'node:stream'
-import type { CommonLogger, IndexedMapper } from '@naturalcycles/js-lib'
-import { ErrorMode } from '@naturalcycles/js-lib'
+import { ErrorMode } from '@naturalcycles/js-lib/error'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
+import type { IndexedMapper } from '@naturalcycles/js-lib/types'
 import type { TransformTyped } from '../stream.model.js'
 
 export interface TransformMapSimpleOptions {

package/src/stream/transform/transformMapSync.ts

@@ -1,10 +1,7 @@
-import type {
-  CommonLogger,
-  IndexedMapper,
-  Predicate,
-  UnixTimestampMillis,
-} from '@naturalcycles/js-lib'
-import { _anyToError, END, ErrorMode, SKIP } from '@naturalcycles/js-lib'
+import { _anyToError, ErrorMode } from '@naturalcycles/js-lib/error'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
+import type { IndexedMapper, Predicate, UnixTimestampMillis } from '@naturalcycles/js-lib/types'
+import { END, SKIP } from '@naturalcycles/js-lib/types'
 import { yellow } from '../../colors/colors.js'
 import { AbortableTransform } from '../pipeline/pipeline.js'
 import type { TransformTyped } from '../stream.model.js'

package/src/stream/transform/transformOffset.ts

@@ -1,6 +1,6 @@
 import { Transform } from 'node:stream'
-import { transformNoOp } from '../index.js'
 import type { TransformOptions, TransformTyped } from '../stream.model.js'
+import { transformNoOp } from './transformNoOp.js'
 
 export interface TransformOffsetOptions extends TransformOptions {
   /**

package/src/stream/transform/transformTap.ts

@@ -1,5 +1,6 @@
 import { Transform } from 'node:stream'
-import type { AsyncIndexedMapper, CommonLogger } from '@naturalcycles/js-lib'
+import type { CommonLogger } from '@naturalcycles/js-lib/log'
+import type { AsyncIndexedMapper } from '@naturalcycles/js-lib/types'
 import type { TransformOptions, TransformTyped } from '../stream.model.js'
 
 export interface TransformTapOptions extends TransformOptions {

package/src/stream/transform/transformThrottle.ts

@@ -1,11 +1,12 @@
 import { Transform } from 'node:stream'
+import { _ms, _since, localTime } from '@naturalcycles/js-lib/datetime'
+import type { DeferredPromise } from '@naturalcycles/js-lib/promise'
+import { pDefer } from '@naturalcycles/js-lib/promise'
 import type {
-  DeferredPromise,
   NumberOfSeconds,
   PositiveInteger,
   UnixTimestampMillis,
-} from '@naturalcycles/js-lib'
-import { _ms, _since, localTime, pDefer } from '@naturalcycles/js-lib'
+} from '@naturalcycles/js-lib/types'
 import type { TransformTyped } from '../stream.model.js'
 
 export interface TransformThrottleOptions {

package/src/stream/transform/worker/transformMultiThreaded.ts

@@ -1,6 +1,8 @@
 import { Worker } from 'node:worker_threads'
-import type { AnyObject, DeferredPromise } from '@naturalcycles/js-lib'
-import { _range, pDefer } from '@naturalcycles/js-lib'
+import { _range } from '@naturalcycles/js-lib'
+import type { DeferredPromise } from '@naturalcycles/js-lib/promise'
+import { pDefer } from '@naturalcycles/js-lib/promise'
+import type { AnyObject } from '@naturalcycles/js-lib/types'
 import through2Concurrent from 'through2-concurrent'
 import type { TransformTyped } from '../../stream.model.js'
 import type { WorkerInput, WorkerOutput } from './transformMultiThreaded.model.js'

package/src/stream/writable/writableForEach.ts

@@ -1,8 +1,8 @@
-import type { AsyncIndexedMapper, IndexedMapper } from '@naturalcycles/js-lib'
-import { _passNothingPredicate } from '@naturalcycles/js-lib'
-import type { TransformMapOptions } from '../index.js'
-import { transformMap, transformMapSync } from '../index.js'
+import type { AsyncIndexedMapper, IndexedMapper } from '@naturalcycles/js-lib/types'
+import { _passNothingPredicate } from '@naturalcycles/js-lib/types'
 import type { WritableTyped } from '../stream.model.js'
+import { transformMap, type TransformMapOptions } from '../transform/transformMap.js'
+import { transformMapSync } from '../transform/transformMapSync.js'
 
 /**
  * Just an alias to transformMap that declares OUT as void.

package/src/stream/writable/writableFork.ts

@@ -1,7 +1,7 @@
 import { Writable } from 'node:stream'
-import type { ReadableTyped } from '../index.js'
-import { _pipeline, readableCreate } from '../index.js'
-import type { TransformOptions, WritableTyped } from '../stream.model.js'
+import { _pipeline } from '../pipeline/pipeline.js'
+import { readableCreate } from '../readable/readableCreate.js'
+import type { ReadableTyped, TransformOptions, WritableTyped } from '../stream.model.js'
 
 /**
  * Allows "forking" a stream inside pipeline into a number of pipeline chains (2 or more).

package/src/stream/writable/writableVoid.ts

@@ -1,5 +1,5 @@
 import { Writable } from 'node:stream'
-import type { DeferredPromise } from '@naturalcycles/js-lib'
+import type { DeferredPromise } from '@naturalcycles/js-lib/promise'
 import type { TransformOptions } from '../stream.model.js'
 
 export interface WritableVoidOptions extends TransformOptions {

package/src/string/inspect.ts

@@ -1,7 +1,7 @@
 import type { InspectOptions } from 'node:util'
 import { inspect } from 'node:util'
-import type { JsonStringifyFunction, StringifyOptions } from '@naturalcycles/js-lib'
-import { _stringify } from '@naturalcycles/js-lib'
+import type { JsonStringifyFunction, StringifyOptions } from '@naturalcycles/js-lib/string'
+import { _stringify } from '@naturalcycles/js-lib/string'
 
 export interface InspectAnyOptions extends StringifyOptions, InspectOptions {}
 

package/src/util/buildInfo.util.ts

@@ -1,5 +1,7 @@
-import type { AnyObject, BuildInfo, UnixTimestamp } from '@naturalcycles/js-lib'
-import { _filterUndefinedValues, localTime } from '@naturalcycles/js-lib'
+import type { BuildInfo } from '@naturalcycles/js-lib'
+import { localTime } from '@naturalcycles/js-lib/datetime'
+import { _filterUndefinedValues } from '@naturalcycles/js-lib/object'
+import type { AnyObject, UnixTimestamp } from '@naturalcycles/js-lib/types'
 import { fs2 } from '../fs/fs2.js'
 import { git2 } from './git2.js'
 

package/src/util/env.util.ts

@@ -1,4 +1,4 @@
-import type { ValuesOf } from '@naturalcycles/js-lib'
+import type { ValuesOf } from '@naturalcycles/js-lib/types'
 import { fs2 } from '../fs/fs2.js'
 
 /**

package/src/util/git2.ts

@@ -1,7 +1,7 @@
 import { execSync } from 'node:child_process'
 import { basename } from 'node:path'
-import type { UnixTimestamp } from '@naturalcycles/js-lib'
-import { exec2 } from '../exec2.js'
+import type { UnixTimestamp } from '@naturalcycles/js-lib/types'
+import { exec2 } from '../exec2/exec2.js'
 
 /**
  * Set of utility functions to work with git.

package/src/validation/ajv/ajvSchema.ts

@@ -1,12 +1,9 @@
-import type { JsonSchema, JsonSchemaBuilder } from '@naturalcycles/js-lib'
-import {
-  _filterNullishValues,
-  _isObject,
-  _substringBefore,
-  JsonSchemaAnyBuilder,
-} from '@naturalcycles/js-lib'
-import type { Ajv, ValidateFunction } from 'ajv'
-import { fs2 } from '../../fs/fs2.js'
+import { _isObject, _lazyValue } from '@naturalcycles/js-lib'
+import type { JsonSchema, JsonSchemaBuilder } from '@naturalcycles/js-lib/json-schema'
+import { JsonSchemaAnyBuilder } from '@naturalcycles/js-lib/json-schema'
+import { _filterNullishValues } from '@naturalcycles/js-lib/object'
+import { _substringBefore } from '@naturalcycles/js-lib/string'
+import type { Ajv } from 'ajv'
 import { _inspect } from '../../string/inspect.js'
 import { AjvValidationError } from './ajvValidationError.js'
 import { getAjv } from './getAjv.js'
@@ -27,7 +24,7 @@ export interface AjvSchemaCfg {
    * Dependent schemas to pass to Ajv instance constructor.
    * Simpler than instantiating and passing ajv instance yourself.
    */
-  schemas?: (JsonSchema | JsonSchemaBuilder | AjvSchema)[]
+  // schemas?: (JsonSchema | JsonSchemaBuilder | AjvSchema)[]
 
   objectName?: string
 
@@ -38,7 +35,13 @@ export interface AjvSchemaCfg {
    *
    * This option is a "shortcut" to skip creating and passing Ajv instance.
    */
-  coerceTypes?: boolean
+  // coerceTypes?: boolean
+
+  /**
+   * If true - schema will be compiled on-demand (lazily).
+   * Default: false.
+   */
+  lazy?: boolean
 }
 
 /**
@@ -53,23 +56,40 @@ export class AjvSchema<T = unknown> {
     cfg: Partial<AjvSchemaCfg> = {},
   ) {
     this.cfg = {
+      lazy: false,
       ...cfg,
-      ajv:
-        cfg.ajv ||
-        getAjv({
-          schemas: cfg.schemas?.map(s => {
-            if (s instanceof AjvSchema) return s.schema
-            if (s instanceof JsonSchemaAnyBuilder) return s.build()
-            return s as JsonSchema
-          }),
-          coerceTypes: cfg.coerceTypes || false,
-          // verbose: true,
-        }),
+      ajv: cfg.ajv || getAjv(),
+      // ajv:
+      //   cfg.ajv ||
+      //   getAjv({
+      //     schemas: cfg.schemas?.map(s => {
+      //       if (s instanceof AjvSchema) return s.schema
+      //       if (s instanceof JsonSchemaAnyBuilder) return s.build()
+      //       return s as JsonSchema
+      //     }),
+      //     coerceTypes: cfg.coerceTypes || false,
+      //     // verbose: true,
+      //   }),
       // Auto-detecting "ObjectName" from $id of the schema (e.g "Address.schema.json")
       objectName: cfg.objectName || (schema.$id ? _substringBefore(schema.$id, '.') : undefined),
     }
 
-    this.validateFunction = this.cfg.ajv.compile<T>(schema)
+    if (!cfg.lazy) {
+      this.getValidateFunction() // compile eagerly
+    }
+  }
+
+  /**
+   * Shortcut for AjvSchema.create(schema, { lazy: true })
+   */
+  static createLazy<T>(
+    schema: JsonSchemaBuilder<T> | JsonSchema<T> | AjvSchema<T>,
+    cfg: Partial<AjvSchemaCfg> = {},
+  ): AjvSchema<T> {
+    return AjvSchema.create(schema, {
+      lazy: true,
+      ...cfg,
+    })
   }
 
   /**
@@ -92,21 +112,9 @@ export class AjvSchema<T = unknown> {
     return new AjvSchema<T>(schema as JsonSchema<T>, cfg)
   }
 
-  /**
-   * Create AjvSchema directly from a filePath of json schema.
-   * Convenient method that just does fs.readFileSync for you.
-   */
-  static readJsonSync<T = unknown>(
-    filePath: string,
-    cfg: Partial<AjvSchemaCfg> = {},
-  ): AjvSchema<T> {
-    fs2.requireFileToExist(filePath)
-    const schema = fs2.readJson<JsonSchema<T>>(filePath)
-    return new AjvSchema<T>(schema, cfg)
-  }
-
   readonly cfg: AjvSchemaCfg
-  private readonly validateFunction: ValidateFunction<T>
+
+  private getValidateFunction = _lazyValue(() => this.cfg.ajv.compile<T>(this.schema))
 
   /**
    * It returns the original object just for convenience.
@@ -123,13 +131,13 @@ export class AjvSchema<T = unknown> {
   }
 
   isValid(obj: T): boolean {
-    return this.validateFunction(obj)
+    return this.getValidateFunction()(obj)
   }
 
   getValidationError(obj: T, opt: AjvValidationOptions = {}): AjvValidationError | undefined {
     if (this.isValid(obj)) return
 
-    const errors = this.validateFunction.errors!
+    const errors = this.getValidateFunction().errors!
 
     const {
       objectId = _isObject(obj) ? (obj['id' as keyof T] as any) : undefined,

package/src/validation/ajv/ajvValidationError.ts

@@ -1,5 +1,5 @@
-import type { ErrorData } from '@naturalcycles/js-lib'
-import { AppError } from '@naturalcycles/js-lib'
+import type { ErrorData } from '@naturalcycles/js-lib/error'
+import { AppError } from '@naturalcycles/js-lib/error'
 import type { ErrorObject } from 'ajv'
 
 export interface AjvValidationErrorData extends ErrorData {