@naturalcycles/nodejs-lib 15.3.0 → 15.5.0

package/dist/bin/slack-this.js

@@ -1,6 +1,6 @@
 #!/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 () => {
     const { channel, msg, username, emoji, webhook: webhookUrl, } = _yargs().options({

package/dist/csv/csvReader.js

@@ -1,5 +1,5 @@
 // Inspired by: https://gist.github.com/Jezternz/c8e9fafc2c114e079829974e3764db75
-import { _assert } from '@naturalcycles/js-lib/error';
+import { _assert } from '@naturalcycles/js-lib/error/assert.js';
 // export class CSVReader {
 //   constructor (cfg: CSVReaderConfig) {
 //     this.cfg = {

package/dist/csv/csvWriter.js

@@ -1,5 +1,5 @@
 // Inspired by: https://github.com/ryu1kn/csv-writer/
-import { _assert } from '@naturalcycles/js-lib/error';
+import { _assert } from '@naturalcycles/js-lib/error/assert.js';
 export class CSVWriter {
     constructor(cfg) {
         this.cfg = {

package/dist/diff/tableDiff.js

@@ -1,4 +1,4 @@
-import { _truncate } from '@naturalcycles/js-lib/string';
+import { _truncate } from '@naturalcycles/js-lib/string/string.util.js';
 /**
  * Compares 2 objects, logs their differences via `console.table`.
  *

package/dist/{exec2.d.ts → exec2/exec2.d.ts}

@@ -1,4 +1,4 @@
-import { AppError } from '@naturalcycles/js-lib/error';
+import { AppError } from '@naturalcycles/js-lib/error/error.util.js';
 import type { AnyObject, NumberOfMilliseconds } from '@naturalcycles/js-lib/types';
 /**
  * Set of utility functions to work with Spawn / Exec.

package/dist/{exec2.js → exec2/exec2.js}

@@ -1,8 +1,8 @@
 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 { dimGrey, dimRed, hasColors, white } from './colors/colors.js';
+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 { dimGrey, dimRed, hasColors, white } from '../colors/colors.js';
 /**
  * Set of utility functions to work with Spawn / Exec.
  *

package/dist/fs/fs2.js

@@ -16,7 +16,7 @@ Credit to: fs-extra (https://github.com/jprichardson/node-fs-extra)
 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.
  * Supposed to be almost a drop-in replacement for these things together:

package/dist/index.d.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/dist/index.js

@@ -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/dist/jwt/jwt.service.js

@@ -1,4 +1,5 @@
-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 jsonwebtoken from 'jsonwebtoken';
 import { anyObjectSchema } from '../validation/joi/joi.shared.schemas.js';
 import { validate } from '../validation/joi/joi.validation.util.js';

package/dist/script/runScript.d.ts

@@ -1,3 +1,4 @@
+import 'dotenv/config';
 import type { CommonLogger } from '@naturalcycles/js-lib/log';
 export interface RunScriptOptions {
     /**

package/dist/script/runScript.js

@@ -1,6 +1,8 @@
+import 'dotenv/config';
 import os from 'node:os';
-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 { dimGrey } from '../colors/colors.js';
 import { inspectStringifyFn } from '../string/inspect.js';
 const { DEBUG_RUN_SCRIPT } = process.env;
 /**
@@ -22,6 +24,7 @@ const { DEBUG_RUN_SCRIPT } = process.env;
  * Set env DEBUG_RUN_SCRIPT for extra debugging.
  */
 export function runScript(fn, opt = {}) {
+    checkAndlogEnvironment();
     setGlobalStringifyFunction(inspectStringifyFn);
     const { logger = console, noExit, registerUncaughtExceptionHandlers = true } = opt;
     if (registerUncaughtExceptionHandlers || DEBUG_RUN_SCRIPT) {
@@ -40,8 +43,6 @@ export function runScript(fn, opt = {}) {
     const timeout = setTimeout(() => { }, 10000000);
     void (async () => {
         try {
-            await import('dotenv/config');
-            await checkAndlogEnvironment();
             await fn();
             await pDelay(); // to ensure all async operations are completed
             if (DEBUG_RUN_SCRIPT)
@@ -62,8 +63,7 @@ export function runScript(fn, opt = {}) {
         }
     })();
 }
-async function checkAndlogEnvironment() {
-    const { dimGrey } = await import('../colors/colors.js');
+function checkAndlogEnvironment() {
     const { platform, arch, versions: { node }, env: { CPU_LIMIT, NODE_OPTIONS, TZ }, } = process;
     const cpuLimit = Number(CPU_LIMIT) || undefined;
     const availableParallelism = os.availableParallelism?.();

package/dist/secret/secrets-decrypt.util.js

@@ -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/dist/secret/secrets-encrypt.util.js

@@ -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/dist/security/secret.util.js

@@ -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 { decryptObject, decryptRandomIVBuffer } from './crypto.util.js';
 let loaded = false;
 const secretMap = {};

package/dist/slack/index.d.ts

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

package/dist/slack/index.js

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

package/dist/slack/slack.service.js

@@ -1,8 +1,8 @@
-import { localTime } from '@naturalcycles/js-lib/datetime';
+import { localTime } from '@naturalcycles/js-lib/datetime/localTime.js';
 import { getFetcher } from '@naturalcycles/js-lib/http';
 import { commonLoggerMinLevel, } 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 { _inspect } from '../index.js';
 const GAE = !!process.env['GAE_INSTANCE'];
 const DEFAULTS = {

package/dist/slack/slack.service.model.d.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/dist/stream/ndjson/ndjson.model.js

@@ -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 {
     static create(o = {}) {

package/dist/stream/ndjson/ndjsonMap.js

@@ -1,4 +1,4 @@
-import { ErrorMode } from '@naturalcycles/js-lib/error';
+import { ErrorMode } from '@naturalcycles/js-lib/error/errorMode.js';
 import { createReadStreamAsNDJSON, createWriteStreamAsNDJSON, } from '../index.js';
 import { _pipeline, transformLimit, transformLogProgress, transformMap } from '../index.js';
 /**

package/dist/stream/ndjson/ndjsonStreamForEach.d.ts

@@ -1,5 +1,6 @@
 import type { AbortableAsyncMapper } from '@naturalcycles/js-lib/types';
-import { type TransformLogProgressOptions, type TransformMapOptions } from '../index.js';
+import { type TransformLogProgressOptions } from '../transform/transformLogProgress.js';
+import { type TransformMapOptions } from '../transform/transformMap.js';
 export interface NDJSONStreamForEachOptions<IN = any> extends TransformMapOptions<IN, void>, TransformLogProgressOptions<IN> {
     inputFilePath: string;
 }

package/dist/stream/ndjson/ndjsonStreamForEach.js

@@ -1,6 +1,9 @@
-import { ErrorMode } from '@naturalcycles/js-lib/error';
-import { createReadStreamAsNDJSON, } from '../index.js';
-import { _pipeline, transformLogProgress, transformMap, writableVoid } from '../index.js';
+import { ErrorMode } from '@naturalcycles/js-lib/error/errorMode.js';
+import { _pipeline } from '../pipeline/pipeline.js';
+import { transformLogProgress, } from '../transform/transformLogProgress.js';
+import { transformMap } from '../transform/transformMap.js';
+import { writableVoid } from '../writable/writableVoid.js';
+import { createReadStreamAsNDJSON } from './createReadStreamAsNDJSON.js';
 /**
  * Convenience function to `forEach` through an ndjson file.
  */

package/dist/stream/pipeline/pipeline.js

@@ -1,7 +1,7 @@
 import { Transform } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
-import { _last } from '@naturalcycles/js-lib';
-import { pDefer } from '@naturalcycles/js-lib/promise';
+import { _last } from '@naturalcycles/js-lib/array/array.util.js';
+import { pDefer } from '@naturalcycles/js-lib/promise/pDefer.js';
 import { writablePushToArray } from '../writable/writablePushToArray.js';
 /**
  * Promisified `stream.pipeline`.

package/dist/stream/readable/readableForEach.d.ts

@@ -1,5 +1,5 @@
 import type { AbortableAsyncMapper, IndexedMapper } from '@naturalcycles/js-lib/types';
-import type { ReadableTyped } from '../index.js';
+import type { ReadableTyped } from '../stream.model.js';
 import type { TransformMapOptions } from '../transform/transformMap.js';
 /**
  * Convenience function to do `.forEach` over a Readable.

package/dist/stream/readable/readableForEach.js

@@ -1,5 +1,5 @@
 import { _passNothingPredicate } from '@naturalcycles/js-lib/types';
-import { _pipeline } from '../index.js';
+import { _pipeline } from '../pipeline/pipeline.js';
 import { transformMap } from '../transform/transformMap.js';
 /**
  * Convenience function to do `.forEach` over a Readable.

package/dist/stream/sizeStack.d.ts

@@ -1,5 +1,5 @@
 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';
 export declare class SizeStack extends NumberStack {
     name: string;
     constructor(name: string, size: number);

package/dist/stream/sizeStack.js

@@ -1,5 +1,5 @@
 import { _hb } from '@naturalcycles/js-lib';
-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';
 export class SizeStack extends NumberStack {

package/dist/stream/transform/transformLimit.d.ts

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

package/dist/stream/transform/transformLimit.js

@@ -1,5 +1,6 @@
-import { AbortableTransform, transformNoOp } from '../index.js';
+import { AbortableTransform } from '../pipeline/pipeline.js';
 import { pipelineClose } from '../stream.util.js';
+import { transformNoOp } from './transformNoOp.js';
 /**
  * Class only exists to be able to do `instanceof TransformLimit`
  * and to set sourceReadable+streamDone to it in `_pipeline`.

package/dist/stream/transform/transformMap.js

@@ -1,8 +1,8 @@
 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 { 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 { END, SKIP, } from '@naturalcycles/js-lib/types';
 import through2Concurrent from 'through2-concurrent';
 import { yellow } from '../../colors/colors.js';

package/dist/stream/transform/transformMapSimple.d.ts

@@ -1,4 +1,4 @@
-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/dist/stream/transform/transformMapSimple.js

@@ -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';
 /**
  * Simplest version of `transformMap`.
  * errorMode: IMMEDIATE

package/dist/stream/transform/transformOffset.js

@@ -1,5 +1,5 @@
 import { Transform } from 'node:stream';
-import { transformNoOp } from '../index.js';
+import { transformNoOp } from './transformNoOp.js';
 export function transformOffset(opt) {
     const { offset } = opt;
     if (!offset) {

package/dist/stream/transform/transformThrottle.js

@@ -1,6 +1,6 @@
 import { Transform } from 'node:stream';
 import { _ms, _since, localTime } from '@naturalcycles/js-lib/datetime';
-import { pDefer } from '@naturalcycles/js-lib/promise';
+import { pDefer } from '@naturalcycles/js-lib/promise/pDefer.js';
 /**
  * Allows to throttle the throughput of the stream.
  * For example, when you have an API with rate limit of 5000 requests per minute,

package/dist/stream/transform/worker/transformMultiThreaded.js

@@ -1,6 +1,6 @@
 import { Worker } from 'node:worker_threads';
-import { _range } from '@naturalcycles/js-lib';
-import { pDefer } from '@naturalcycles/js-lib/promise';
+import { _range } from '@naturalcycles/js-lib/array/range.js';
+import { pDefer } from '@naturalcycles/js-lib/promise/pDefer.js';
 import through2Concurrent from 'through2-concurrent';
 const workerProxyFilePath = `${import.meta.dirname}/workerClassProxy.js`;
 /**

package/dist/stream/writable/writableForEach.d.ts

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

package/dist/stream/writable/writableForEach.js

@@ -1,5 +1,6 @@
 import { _passNothingPredicate } from '@naturalcycles/js-lib/types';
-import { transformMap, transformMapSync } from '../index.js';
+import { transformMap } from '../transform/transformMap.js';
+import { transformMapSync } from '../transform/transformMapSync.js';
 /**
  * Just an alias to transformMap that declares OUT as void.
  */

package/dist/stream/writable/writableFork.js

@@ -1,5 +1,6 @@
 import { Writable } from 'node:stream';
-import { _pipeline, readableCreate } from '../index.js';
+import { _pipeline } from '../pipeline/pipeline.js';
+import { readableCreate } from '../readable/readableCreate.js';
 /**
  * Allows "forking" a stream inside pipeline into a number of pipeline chains (2 or more).
  * Currently does NOT (!) maintain backpressure.

package/dist/string/inspect.js

@@ -1,5 +1,5 @@
 import { inspect } from 'node:util';
-import { _stringify } from '@naturalcycles/js-lib/string';
+import { _stringify } from '@naturalcycles/js-lib/string/stringify.js';
 const INSPECT_OPT = {
     breakLength: 80, // default: ??
     depth: 10, // default: 2

package/dist/util/buildInfo.util.js

@@ -1,5 +1,5 @@
-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 { fs2 } from '../fs/fs2.js';
 import { git2 } from './git2.js';
 export function generateBuildInfo(opt = {}) {

package/dist/util/git2.js

@@ -1,6 +1,6 @@
 import { execSync } from 'node:child_process';
 import { basename } from 'node:path';
-import { exec2 } from '../exec2.js';
+import { exec2 } from '../exec2/exec2.js';
 /**
  * Set of utility functions to work with git.
  */

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

@@ -15,7 +15,6 @@ export interface AjvSchemaCfg {
      * Dependent schemas to pass to Ajv instance constructor.
      * Simpler than instantiating and passing ajv instance yourself.
      */
-    schemas?: (JsonSchema | JsonSchemaBuilder | AjvSchema)[];
     objectName?: string;
     /**
      * Option of Ajv.
@@ -24,7 +23,11 @@ export interface AjvSchemaCfg {
      *
      * This option is a "shortcut" to skip creating and passing Ajv instance.
      */
-    coerceTypes?: boolean;
+    /**
+     * If true - schema will be compiled on-demand (lazily).
+     * Default: false.
+     */
+    lazy?: boolean;
 }
 /**
  * On creation - compiles ajv validation function.
@@ -35,6 +38,10 @@ export interface AjvSchemaCfg {
 export declare class AjvSchema<T = unknown> {
     schema: JsonSchema<T>;
     private constructor();
+    /**
+     * Shortcut for AjvSchema.create(schema, { lazy: true })
+     */
+    static createLazy<T>(schema: JsonSchemaBuilder<T> | JsonSchema<T> | AjvSchema<T>, cfg?: Partial<AjvSchemaCfg>): AjvSchema<T>;
     /**
      * Conveniently allows to pass either JsonSchema or JsonSchemaBuilder, or existing AjvSchema.
      * If it's already an AjvSchema - it'll just return it without any processing.
@@ -45,13 +52,8 @@ export declare class AjvSchema<T = unknown> {
      * correctly for some reason.
      */
     static create<T>(schema: JsonSchemaBuilder<T> | JsonSchema<T> | AjvSchema<T>, cfg?: Partial<AjvSchemaCfg>): AjvSchema<T>;
-    /**
-     * 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>;
     readonly cfg: AjvSchemaCfg;
-    private readonly validateFunction;
+    private getValidateFunction;
     /**
      * It returns the original object just for convenience.
      * Reminder: Ajv will MUTATE your object under 2 circumstances:

package/dist/validation/ajv/ajvSchema.js

@@ -1,8 +1,7 @@
-import { _isObject } from '@naturalcycles/js-lib';
+import { _isObject, _lazyValue } from '@naturalcycles/js-lib';
 import { JsonSchemaAnyBuilder } from '@naturalcycles/js-lib/json-schema';
 import { _filterNullishValues } from '@naturalcycles/js-lib/object';
 import { _substringBefore } from '@naturalcycles/js-lib/string';
-import { fs2 } from '../../fs/fs2.js';
 import { _inspect } from '../../string/inspect.js';
 import { AjvValidationError } from './ajvValidationError.js';
 import { getAjv } from './getAjv.js';
@@ -17,23 +16,35 @@ export class AjvSchema {
     constructor(schema, cfg = {}) {
         this.schema = schema;
         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;
-                    }),
-                    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(schema);
+        if (!cfg.lazy) {
+            this.getValidateFunction(); // compile eagerly
+        }
+    }
+    /**
+     * Shortcut for AjvSchema.create(schema, { lazy: true })
+     */
+    static createLazy(schema, cfg = {}) {
+        return AjvSchema.create(schema, {
+            lazy: true,
+            ...cfg,
+        });
     }
     /**
      * Conveniently allows to pass either JsonSchema or JsonSchemaBuilder, or existing AjvSchema.
@@ -52,17 +63,8 @@ export class AjvSchema {
         }
         return new AjvSchema(schema, cfg);
     }
-    /**
-     * Create AjvSchema directly from a filePath of json schema.
-     * Convenient method that just does fs.readFileSync for you.
-     */
-    static readJsonSync(filePath, cfg = {}) {
-        fs2.requireFileToExist(filePath);
-        const schema = fs2.readJson(filePath);
-        return new AjvSchema(schema, cfg);
-    }
     cfg;
-    validateFunction;
+    getValidateFunction = _lazyValue(() => this.cfg.ajv.compile(this.schema));
     /**
      * It returns the original object just for convenience.
      * Reminder: Ajv will MUTATE your object under 2 circumstances:
@@ -78,12 +80,12 @@ export class AjvSchema {
         return obj;
     }
     isValid(obj) {
-        return this.validateFunction(obj);
+        return this.getValidateFunction()(obj);
     }
     getValidationError(obj, opt = {}) {
         if (this.isValid(obj))
             return;
-        const errors = this.validateFunction.errors;
+        const errors = this.getValidateFunction().errors;
         const { objectId = _isObject(obj) ? obj['id'] : undefined, objectName = this.cfg.objectName, } = opt;
         const name = [objectName || 'Object', objectId].filter(Boolean).join('.');
         let message = this.cfg.ajv.errorsText(errors, {

package/dist/validation/ajv/ajvValidationError.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 { ErrorObject } from 'ajv';
 export interface AjvValidationErrorData extends ErrorData {
     errors: ErrorObject[];

package/dist/validation/ajv/ajvValidationError.js

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

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

@@ -1,8 +1,17 @@
 import type { Options } from 'ajv';
 import { Ajv } from 'ajv';
+/**
+ * Return cached instance of Ajv with default (recommended) options.
+ *
+ * This function should be used as much as possible,
+ * to benefit from cached Ajv instance.
+ */
+export declare const getAjv: import("@naturalcycles/js-lib/types").Lazy<Ajv>;
 /**
  * Create Ajv with modified defaults.
  *
+ * !!! Please note that this function is EXPENSIVE computationally !!!
+ *
  * https://ajv.js.org/options.html
  */
-export declare function getAjv(opt?: Options): Ajv;
+export declare function createAjv(opt?: Options): Ajv;

package/dist/validation/ajv/getAjv.js

@@ -1,3 +1,4 @@
+import { _lazyValue } from '@naturalcycles/js-lib';
 import { Ajv } from 'ajv';
 import ajvFormats from 'ajv-formats';
 import ajvKeywords from 'ajv-keywords';
@@ -10,12 +11,21 @@ const AJV_OPTIONS = {
     // https://ajv.js.org/options.html#coercetypes
     coerceTypes: false, // while `false` - it won't mutate your input
 };
+/**
+ * Return cached instance of Ajv with default (recommended) options.
+ *
+ * This function should be used as much as possible,
+ * to benefit from cached Ajv instance.
+ */
+export const getAjv = _lazyValue(createAjv);
 /**
  * Create Ajv with modified defaults.
  *
+ * !!! Please note that this function is EXPENSIVE computationally !!!
+ *
  * https://ajv.js.org/options.html
  */
-export function getAjv(opt) {
+export function createAjv(opt) {
     const ajv = new Ajv({
         ...AJV_OPTIONS,
         ...opt,