@naturalcycles/nodejs-lib 15.3.0 → 15.5.0

package/dist/validation/ajv/index.d.ts

@@ -1,5 +1,4 @@
 import Ajv from 'ajv';
-export * from './ajv.util.js';
 export * from './ajvSchema.js';
 export * from './ajvValidationError.js';
 export * from './getAjv.js';

package/dist/validation/ajv/index.js

@@ -1,5 +1,4 @@
 import Ajv from 'ajv';
-export * from './ajv.util.js';
 export * from './ajvSchema.js';
 export * from './ajvValidationError.js';
 export * from './getAjv.js';

package/dist/validation/joi/joi.validation.error.d.ts

@@ -1,5 +1,5 @@
 import type { ErrorData } from '@naturalcycles/js-lib/error';
-import { AppError } from '@naturalcycles/js-lib/error';
+import { AppError } from '@naturalcycles/js-lib/error/error.util.js';
 import type { ValidationErrorItem } from 'joi';
 /**
  * Example of ValidationErrorItem:

package/dist/validation/joi/joi.validation.error.js

@@ -1,4 +1,4 @@
-import { AppError } from '@naturalcycles/js-lib/error';
+import { AppError } from '@naturalcycles/js-lib/error/error.util.js';
 export class JoiValidationError extends AppError {
     constructor(message, data) {
         super(message, data, {

package/dist/validation/joi/joi.validation.util.d.ts

@@ -17,6 +17,8 @@ export declare function validate<T>(input: any, schema?: AnySchema<T>, objectNam
  * Returns JoiValidationResult with converted value and error (if any).
  * Does not throw.
  *
+ * Joi does NOT mutate the input.
+ *
  * If `schema` is undefined - returns value as is.
  */
 export declare function getValidationResult<T>(input: any, schema?: AnySchema<T>, objectName?: string, options?: ValidationOptions): JoiValidationResult<T>;

package/dist/validation/joi/joi.validation.util.js

@@ -6,7 +6,7 @@
  * "Converts" mean e.g trims all strings from leading/trailing spaces.
  */
 import { _hb, _isObject } from '@naturalcycles/js-lib';
-import { _truncateMiddle } from '@naturalcycles/js-lib/string';
+import { _truncateMiddle } from '@naturalcycles/js-lib/string/string.util.js';
 import { JoiValidationError } from './joi.validation.error.js';
 // Strip colors in production (for e.g Sentry reporting)
 // const stripColors = process.env.NODE_ENV === 'production' || !!process.env.GAE_INSTANCE
@@ -50,6 +50,8 @@ export function validate(input, schema, objectName, opt = {}) {
  * Returns JoiValidationResult with converted value and error (if any).
  * Does not throw.
  *
+ * Joi does NOT mutate the input.
+ *
  * If `schema` is undefined - returns value as is.
  */
 export function getValidationResult(input, schema, objectName, options = {}) {

package/dist/validation/joi/string.extensions.js

@@ -1,4 +1,4 @@
-import { localTime } from '@naturalcycles/js-lib/datetime';
+import { localTime } from '@naturalcycles/js-lib/datetime/localTime.js';
 export function stringExtensions(joi) {
     return {
         type: 'string',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.3.0",
+  "version": "15.5.0",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@types/js-yaml": "^4",
@@ -22,22 +22,25 @@
     "yargs": "^18"
   },
   "devDependencies": {
-    "@naturalcycles/dev-lib": "*",
-    "@types/through2-concurrent": "^2"
+    "@types/through2-concurrent": "^2",
+    "@naturalcycles/dev-lib": "19.11.0"
   },
   "exports": {
     ".": "./dist/index.js",
     "./lruMemoCache": "./dist/cache/lruMemoCache.js",
     "./colors": "./dist/colors/colors.js",
     "./csv": "./dist/csv/index.js",
-    "./exec2": "./dist/exec2.js",
+    "./exec2": "./dist/exec2/exec2.js",
     "./fs2": "./dist/fs/fs2.js",
     "./env": "./dist/fs/json2env.js",
     "./kpy": "./dist/fs/kpy.js",
     "./yaml2": "./dist/fs/yaml2.js",
     "./glob": "./dist/glob/index.js",
     "./jwt": "./dist/jwt/jwt.service.js",
+    "./runScript": "./dist/script/runScript.js",
+    "./slack": "./dist/slack/index.js",
     "./stream": "./dist/stream/index.js",
+    "./stream/*.js": "./dist/stream/*.js",
     "./yargs": "./dist/yargs/yargs.util.js",
     "./ajv": "./dist/validation/ajv/index.js",
     "./joi": "./dist/validation/joi/index.js",
@@ -60,7 +63,6 @@
     "!src/**/__snapshots__",
     "!src/**/__exclude"
   ],
-  "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "publishConfig": {
     "access": "public"

package/src/bin/slack-this.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-import { SlackService } from '../index.js'
 import { runScript } from '../script/runScript.js'
+import { SlackService } from '../slack/index.js'
 import { _yargs } from '../yargs/yargs.util.js'
 
 runScript(async () => {

package/src/csv/csvReader.ts

@@ -1,6 +1,6 @@
 // Inspired by: https://gist.github.com/Jezternz/c8e9fafc2c114e079829974e3764db75
 
-import { _assert } from '@naturalcycles/js-lib/error'
+import { _assert } from '@naturalcycles/js-lib/error/assert.js'
 import type { AnyObject } from '@naturalcycles/js-lib/types'
 
 export interface CSVReaderConfig {

package/src/csv/csvWriter.ts

@@ -1,6 +1,6 @@
 // Inspired by: https://github.com/ryu1kn/csv-writer/
 
-import { _assert } from '@naturalcycles/js-lib/error'
+import { _assert } from '@naturalcycles/js-lib/error/assert.js'
 import type { AnyObject } from '@naturalcycles/js-lib/types'
 
 export interface CSVWriterConfig {

package/src/diff/tableDiff.ts

@@ -1,4 +1,4 @@
-import { _truncate } from '@naturalcycles/js-lib/string'
+import { _truncate } from '@naturalcycles/js-lib/string/string.util.js'
 import type { AnyObject } from '@naturalcycles/js-lib/types'
 
 export interface TableDiffOptions {

package/src/{exec2.ts → exec2/exec2.ts}

@@ -1,13 +1,13 @@
 import { execSync, spawn, spawnSync } from 'node:child_process'
-import { _since } from '@naturalcycles/js-lib/datetime'
-import { AppError } from '@naturalcycles/js-lib/error'
-import { _substringAfterLast } from '@naturalcycles/js-lib/string'
+import { _since } from '@naturalcycles/js-lib/datetime/time.util.js'
+import { AppError } from '@naturalcycles/js-lib/error/error.util.js'
+import { _substringAfterLast } from '@naturalcycles/js-lib/string/string.util.js'
 import type {
   AnyObject,
   NumberOfMilliseconds,
   UnixTimestampMillis,
 } from '@naturalcycles/js-lib/types'
-import { dimGrey, dimRed, hasColors, white } from './colors/colors.js'
+import { dimGrey, dimRed, hasColors, white } from '../colors/colors.js'
 
 /**
  * Set of utility functions to work with Spawn / Exec.

package/src/fs/fs2.ts

@@ -18,7 +18,7 @@ import type { RmOptions, Stats } from 'node:fs'
 import fs from 'node:fs'
 import fsp from 'node:fs/promises'
 import path from 'node:path'
-import { _jsonParse } from '@naturalcycles/js-lib/string'
+import { _jsonParse } from '@naturalcycles/js-lib/string/json.util.js'
 
 /**
  * fs2 conveniently groups filesystem functions together.

package/src/index.ts

@@ -2,14 +2,11 @@ export * from './buffer/buffer.util.js'
 export * from './diff/tableDiff.js'
 export * from './infra/process.util.js'
 export * from './log/log.util.js'
-export * from './script/runScript.js'
 export * from './security/crypto.util.js'
 export * from './security/hash.util.js'
 export * from './security/id.util.js'
 export * from './security/nanoid.js'
 export * from './security/secret.util.js'
-export * from './slack/slack.service.js'
-export * from './slack/slack.service.model.js'
 export * from './string/inspect.js'
 export * from './util/buildInfo.util.js'
 export * from './util/env.util.js'

package/src/jwt/jwt.service.ts

@@ -1,5 +1,6 @@
 import type { ErrorData } from '@naturalcycles/js-lib/error'
-import { _assert, _errorDataAppend } from '@naturalcycles/js-lib/error'
+import { _assert } from '@naturalcycles/js-lib/error/assert.js'
+import { _errorDataAppend } from '@naturalcycles/js-lib/error/error.util.js'
 import type { AnyObject, JWTString } from '@naturalcycles/js-lib/types'
 import type { AnySchema } from 'joi'
 import type { Algorithm, JwtHeader, SignOptions, VerifyOptions } from 'jsonwebtoken'

package/src/script/runScript.ts

@@ -1,8 +1,10 @@
+import 'dotenv/config'
 import os from 'node:os'
 import type { CommonLogger } from '@naturalcycles/js-lib/log'
-import { pDelay } from '@naturalcycles/js-lib/promise'
-import { setGlobalStringifyFunction } from '@naturalcycles/js-lib/string'
+import { pDelay } from '@naturalcycles/js-lib/promise/pDelay.js'
+import { setGlobalStringifyFunction } from '@naturalcycles/js-lib/string/stringify.js'
 import type { AnyObject } from '@naturalcycles/js-lib/types'
+import { dimGrey } from '../colors/colors.js'
 import { inspectStringifyFn } from '../string/inspect.js'
 
 export interface RunScriptOptions {
@@ -46,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
@@ -69,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
@@ -93,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/error'
+import { _assert } from '@naturalcycles/js-lib/error/assert.js'
 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/error'
+import { _assert } from '@naturalcycles/js-lib/error/assert.js'
 import { globSync } from 'tinyglobby'
 import { dimGrey, yellow } from '../colors/colors.js'
 import { fs2 } from '../fs/fs2.js'

package/src/security/secret.util.ts

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

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,6 +1,6 @@
 import type { CommonLogger } from '@naturalcycles/js-lib/log'
 import type { AnyObject } from '@naturalcycles/js-lib/types'
-import type { InspectAnyOptions } from '../index.js'
+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,15 +1,14 @@
-import { localTime } from '@naturalcycles/js-lib/datetime'
+import { localTime } from '@naturalcycles/js-lib/datetime/localTime.js'
 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 { _omit } from '@naturalcycles/js-lib/object/object.util.js'
+import { PQueue } from '@naturalcycles/js-lib/promise/pQueue.js'
 import type { AnyObject } from '@naturalcycles/js-lib/types'
-import type { InspectAnyOptions } from '../index.js'
-import { _inspect } from '../index.js'
+import { _inspect, type InspectAnyOptions } from '../index.js'
 import type {
   SlackApiBody,
   SlackAttachmentField,

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

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

package/src/stream/ndjson/ndjsonMap.ts

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

package/src/stream/ndjson/ndjsonStreamForEach.ts

@@ -1,11 +1,13 @@
-import { ErrorMode } from '@naturalcycles/js-lib/error'
+import { ErrorMode } from '@naturalcycles/js-lib/error/errorMode.js'
 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/pipeline/pipeline.ts

@@ -1,9 +1,9 @@
 import type { Readable, Writable } from 'node:stream'
 import { Transform } from 'node:stream'
 import { pipeline } from 'node:stream/promises'
-import { _last } from '@naturalcycles/js-lib'
+import { _last } from '@naturalcycles/js-lib/array/array.util.js'
 import type { DeferredPromise } from '@naturalcycles/js-lib/promise'
-import { pDefer } from '@naturalcycles/js-lib/promise'
+import { pDefer } from '@naturalcycles/js-lib/promise/pDefer.js'
 import type { AnyFunction } from '@naturalcycles/js-lib/types'
 import { writablePushToArray } from '../writable/writablePushToArray.js'
 

package/src/stream/readable/readableForEach.ts

@@ -1,7 +1,7 @@
 import type { AbortableAsyncMapper, IndexedMapper } from '@naturalcycles/js-lib/types'
 import { _passNothingPredicate } from '@naturalcycles/js-lib/types'
-import type { ReadableTyped } from '../index.js'
-import { _pipeline } from '../index.js'
+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/sizeStack.ts

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

package/src/stream/transform/transformLimit.ts

@@ -1,8 +1,9 @@
 import type { Readable } from 'node:stream'
 import type { CommonLogger } from '@naturalcycles/js-lib/log'
-import { AbortableTransform, transformNoOp } from '../index.js'
+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,9 +1,9 @@
 import { _hc } from '@naturalcycles/js-lib'
-import { _since } from '@naturalcycles/js-lib/datetime'
+import { _since } from '@naturalcycles/js-lib/datetime/time.util.js'
 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 { pFilter } from '@naturalcycles/js-lib/promise/pFilter.js'
+import { _stringify } from '@naturalcycles/js-lib/string/stringify.js'
 import {
   type AbortableAsyncMapper,
   type AsyncPredicate,

package/src/stream/transform/transformMapSimple.ts

@@ -1,5 +1,5 @@
 import { Transform } from 'node:stream'
-import { ErrorMode } from '@naturalcycles/js-lib/error'
+import { ErrorMode } from '@naturalcycles/js-lib/error/errorMode.js'
 import type { CommonLogger } from '@naturalcycles/js-lib/log'
 import type { IndexedMapper } from '@naturalcycles/js-lib/types'
 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/transformThrottle.ts

@@ -1,7 +1,7 @@
 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 { pDefer } from '@naturalcycles/js-lib/promise/pDefer.js'
 import type {
   NumberOfSeconds,
   PositiveInteger,

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

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

package/src/stream/writable/writableForEach.ts

@@ -1,8 +1,8 @@
 import type { AsyncIndexedMapper, IndexedMapper } from '@naturalcycles/js-lib/types'
 import { _passNothingPredicate } from '@naturalcycles/js-lib/types'
-import type { TransformMapOptions } from '../index.js'
-import { transformMap, transformMapSync } from '../index.js'
 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/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/string'
-import { _stringify } from '@naturalcycles/js-lib/string'
+import { _stringify } from '@naturalcycles/js-lib/string/stringify.js'
 
 export interface InspectAnyOptions extends StringifyOptions, InspectOptions {}
 

package/src/util/buildInfo.util.ts

@@ -1,6 +1,6 @@
 import type { BuildInfo } from '@naturalcycles/js-lib'
-import { localTime } from '@naturalcycles/js-lib/datetime'
-import { _filterUndefinedValues } from '@naturalcycles/js-lib/object'
+import { localTime } from '@naturalcycles/js-lib/datetime/localTime.js'
+import { _filterUndefinedValues } from '@naturalcycles/js-lib/object/object.util.js'
 import type { AnyObject, UnixTimestamp } from '@naturalcycles/js-lib/types'
 import { fs2 } from '../fs/fs2.js'
 import { git2 } from './git2.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/types'
-import { exec2 } from '../exec2.js'
+import { exec2 } from '../exec2/exec2.js'
 
 /**
  * Set of utility functions to work with git.

package/src/validation/ajv/ajvSchema.ts

@@ -1,10 +1,9 @@
-import { _isObject } from '@naturalcycles/js-lib'
+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, ValidateFunction } from 'ajv'
-import { fs2 } from '../../fs/fs2.js'
+import type { Ajv } from 'ajv'
 import { _inspect } from '../../string/inspect.js'
 import { AjvValidationError } from './ajvValidationError.js'
 import { getAjv } from './getAjv.js'
@@ -25,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
 
@@ -36,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
 }
 
 /**
@@ -51,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,
+    })
   }
 
   /**
@@ -90,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.
@@ -121,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/error'
-import { AppError } from '@naturalcycles/js-lib/error'
+import { AppError } from '@naturalcycles/js-lib/error/error.util.js'
 import type { ErrorObject } from 'ajv'
 
 export interface AjvValidationErrorData extends ErrorData {