@naturalcycles/nodejs-lib 15.1.0 → 15.3.0

package/dist/bin/slack-this.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { SlackService } from '../index.js';
 import { runScript } from '../script/runScript.js';
-import { _yargs } from '../yargs/index.js';
+import { _yargs } from '../yargs/yargs.util.js';
 runScript(async () => {
     const { channel, msg, username, emoji, webhook: webhookUrl, } = _yargs().options({
         channel: {

package/dist/{util → cache}/lruMemoCache.d.ts

@@ -1,4 +1,4 @@
-import type { MemoCache } from '@naturalcycles/js-lib';
+import type { MemoCache } from '@naturalcycles/js-lib/decorators';
 import { LRUCache } from 'lru-cache';
 export type LRUMemoCacheOptions<KEY, VALUE> = Partial<LRUCache.Options<KEY, VALUE, any>>;
 /**

package/dist/csv/csvReader.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject } from '@naturalcycles/js-lib';
+import type { AnyObject } from '@naturalcycles/js-lib/types';
 export interface CSVReaderConfig {
     /**
      * Default: comma

package/dist/csv/csvReader.js

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

package/dist/csv/csvWriter.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject } from '@naturalcycles/js-lib';
+import type { AnyObject } from '@naturalcycles/js-lib/types';
 export interface CSVWriterConfig {
     /**
      * Default: comma

package/dist/csv/csvWriter.js

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

package/dist/csv/transformToCSV.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject } from '@naturalcycles/js-lib';
+import type { AnyObject } from '@naturalcycles/js-lib/types';
 import type { TransformTyped } from '../stream/stream.model.js';
 import type { CSVWriterConfig } from './csvWriter.js';
 export interface TransformToCSVOptions extends CSVWriterConfig {

package/dist/diff/tableDiff.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject } from '@naturalcycles/js-lib';
+import type { AnyObject } from '@naturalcycles/js-lib/types';
 export interface TableDiffOptions {
     /**
      * @default false

package/dist/diff/tableDiff.js

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

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

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

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

@@ -1,7 +1,8 @@
 import { execSync, spawn, spawnSync } from 'node:child_process';
-import { _substringAfterLast, } from '@naturalcycles/js-lib';
-import { _since, AppError } from '@naturalcycles/js-lib';
-import { dimGrey, dimRed, hasColors, white } from '../colors/colors.js';
+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';
 /**
  * Set of utility functions to work with Spawn / Exec.
  *

package/dist/fs/fs2.d.ts

@@ -1,7 +1,5 @@
 import type { RmOptions } from 'node:fs';
 import fs from 'node:fs';
-import type { DumpOptions } from 'js-yaml';
-import type { ReadableTyped, TransformTyped } from '../stream/stream.model.js';
 /**
  * fs2 conveniently groups filesystem functions together.
  * Supposed to be almost a drop-in replacement for these things together:
@@ -23,20 +21,14 @@ declare class FS2 {
     readBufferAsync(filePath: string): Promise<Buffer>;
     readJson<T = unknown>(filePath: string): T;
     readJsonAsync<T = unknown>(filePath: string): Promise<T>;
-    readYaml<T = unknown>(filePath: string): T;
-    readYamlAsync<T = unknown>(filePath: string): Promise<T>;
     writeFile(filePath: string, data: string | Buffer): void;
     writeFileAsync(filePath: string, data: string | Buffer): Promise<void>;
     writeJson(filePath: string, data: any, opt?: JsonOptions): void;
     writeJsonAsync(filePath: string, data: any, opt?: JsonOptions): Promise<void>;
-    writeYaml(filePath: string, data: any, opt?: DumpOptions): void;
-    writeYamlAsync(filePath: string, data: any, opt?: DumpOptions): Promise<void>;
     appendFile(filePath: string, data: string | Buffer): void;
     appendFileAsync(filePath: string, data: string | Buffer): Promise<void>;
     outputJson(filePath: string, data: any, opt?: JsonOptions): void;
     outputJsonAsync(filePath: string, data: any, opt?: JsonOptions): Promise<void>;
-    outputYaml(filePath: string, data: any, opt?: DumpOptions): void;
-    outputYamlAsync(filePath: string, data: any, opt?: DumpOptions): Promise<void>;
     outputFile(filePath: string, data: string | Buffer): void;
     outputFileAsync(filePath: string, data: string | Buffer): Promise<void>;
     pathExists(filePath: string): boolean;
@@ -80,8 +72,6 @@ declare class FS2 {
     readdirAsync: typeof fs.promises.readdir;
     createWriteStream: typeof fs.createWriteStream;
     createReadStream: typeof fs.createReadStream;
-    createReadStreamAsNDJSON<ROW = any>(inputPath: string): ReadableTyped<ROW>;
-    createWriteStreamAsNDJSON(outputPath: string): TransformTyped<any, any>[];
 }
 export declare const fs2: FS2;
 export interface JsonOptions {

package/dist/fs/fs2.js

@@ -16,11 +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 { createGzip, createUnzip } from 'node:zlib';
-import { _isTruthy, _jsonParse } from '@naturalcycles/js-lib';
-import yaml from 'js-yaml';
-import { transformToNDJson } from '../stream/ndjson/transformToNDJson.js';
-import { transformSplitOnNewline } from '../stream/transform/transformSplit.js';
+import { _jsonParse } from '@naturalcycles/js-lib/string';
 /**
  * fs2 conveniently groups filesystem functions together.
  * Supposed to be almost a drop-in replacement for these things together:
@@ -60,12 +56,6 @@ class FS2 {
         // eslint-disable-next-line @typescript-eslint/return-await
         return _jsonParse(str);
     }
-    readYaml(filePath) {
-        return yaml.load(fs.readFileSync(filePath, 'utf8'));
-    }
-    async readYamlAsync(filePath) {
-        return yaml.load(await fsp.readFile(filePath, 'utf8'));
-    }
     writeFile(filePath, data) {
         fs.writeFileSync(filePath, data);
     }
@@ -80,14 +70,6 @@ class FS2 {
         const str = stringify(data, opt);
         await fsp.writeFile(filePath, str);
     }
-    writeYaml(filePath, data, opt) {
-        const str = yaml.dump(data, opt);
-        fs.writeFileSync(filePath, str);
-    }
-    async writeYamlAsync(filePath, data, opt) {
-        const str = yaml.dump(data, opt);
-        await fsp.writeFile(filePath, str);
-    }
     appendFile(filePath, data) {
         fs.appendFileSync(filePath, data);
     }
@@ -102,14 +84,6 @@ class FS2 {
         const str = stringify(data, opt);
         await this.outputFileAsync(filePath, str);
     }
-    outputYaml(filePath, data, opt) {
-        const str = yaml.dump(data, opt);
-        this.outputFile(filePath, str);
-    }
-    async outputYamlAsync(filePath, data, opt) {
-        const str = yaml.dump(data, opt);
-        await this.outputFileAsync(filePath, str);
-    }
     outputFile(filePath, data) {
         const dirPath = path.dirname(filePath);
         if (!fs.existsSync(dirPath)) {
@@ -289,64 +263,6 @@ class FS2 {
     readdirAsync = fsp.readdir;
     createWriteStream = fs.createWriteStream;
     createReadStream = fs.createReadStream;
-    /*
-    Returns a Readable of [already parsed] NDJSON objects.
-  
-    Replaces a list of operations:
-    - requireFileToExist(inputPath)
-    - fs.createReadStream
-    - createUnzip (only if path ends with '.gz')
-    - transformSplitOnNewline
-    - transformJsonParse
-  
-    To add a Limit or Offset: just add .take() or .drop(), example:
-  
-    _pipeline([
-      fs2.createReadStreamAsNDJSON().take(100),
-      transformX(),
-    ])
-     */
-    createReadStreamAsNDJSON(inputPath) {
-        this.requireFileToExist(inputPath);
-        let stream = fs
-            .createReadStream(inputPath, {
-            highWaterMark: 64 * 1024, // no observed speedup
-        })
-            .on('error', err => stream.emit('error', err));
-        if (inputPath.endsWith('.gz')) {
-            stream = stream.pipe(createUnzip({
-                chunkSize: 64 * 1024, // speedup from ~3200 to 3800 rps!
-            }));
-        }
-        return stream.pipe(transformSplitOnNewline()).map(line => JSON.parse(line));
-        // For some crazy reason .map is much faster than transformJsonParse!
-        // ~5000 vs ~4000 rps !!!
-        // .on('error', err => stream.emit('error', err))
-        // .pipe(transformJsonParse<ROW>())
-    }
-    /*
-    Returns an array of Transforms, so that you can ...destructure them at
-    the end of the _pipeline.
-  
-    Replaces a list of operations:
-    - transformToNDJson
-    - createGzip (only if path ends with '.gz')
-    - fs.createWriteStream
-     */
-    createWriteStreamAsNDJSON(outputPath) {
-        this.ensureFile(outputPath);
-        return [
-            transformToNDJson(),
-            outputPath.endsWith('.gz')
-                ? createGzip({
-                // chunkSize: 64 * 1024, // no observed speedup
-                })
-                : undefined,
-            fs.createWriteStream(outputPath, {
-            // highWaterMark: 64 * 1024, // no observed speedup
-            }),
-        ].filter(_isTruthy);
-    }
 }
 export const fs2 = new FS2();
 function stringify(data, opt) {

package/dist/fs/json2env.d.ts

@@ -1,4 +1,4 @@
-import type { AnyObject } from '@naturalcycles/js-lib';
+import type { AnyObject } from '@naturalcycles/js-lib/types';
 export interface Json2EnvOptions {
     jsonPath: string;
     prefix?: string;

package/dist/fs/kpy.js

@@ -1,5 +1,5 @@
 import path from 'node:path';
-import { _since, localTime } from '@naturalcycles/js-lib';
+import { _since, localTime } from '@naturalcycles/js-lib/datetime';
 import { glob, globSync } from 'tinyglobby';
 import { boldWhite, dimGrey, grey, yellow } from '../colors/colors.js';
 import { fs2 } from './fs2.js';

package/dist/fs/yaml2.d.ts

@@ -0,0 +1,11 @@
+import type { DumpOptions } from 'js-yaml';
+declare class Yaml2 {
+    readYaml<T = unknown>(filePath: string): T;
+    readYamlAsync<T = unknown>(filePath: string): Promise<T>;
+    writeYaml(filePath: string, data: any, opt?: DumpOptions): void;
+    writeYamlAsync(filePath: string, data: any, opt?: DumpOptions): Promise<void>;
+    outputYaml(filePath: string, data: any, opt?: DumpOptions): void;
+    outputYamlAsync(filePath: string, data: any, opt?: DumpOptions): Promise<void>;
+}
+export declare const yaml2: Yaml2;
+export {};

package/dist/fs/yaml2.js

@@ -0,0 +1,29 @@
+import fs from 'node:fs';
+import fsp from 'node:fs/promises';
+import yaml from 'js-yaml';
+import { fs2 } from './fs2.js';
+class Yaml2 {
+    readYaml(filePath) {
+        return yaml.load(fs.readFileSync(filePath, 'utf8'));
+    }
+    async readYamlAsync(filePath) {
+        return yaml.load(await fsp.readFile(filePath, 'utf8'));
+    }
+    writeYaml(filePath, data, opt) {
+        const str = yaml.dump(data, opt);
+        fs.writeFileSync(filePath, str);
+    }
+    async writeYamlAsync(filePath, data, opt) {
+        const str = yaml.dump(data, opt);
+        await fsp.writeFile(filePath, str);
+    }
+    outputYaml(filePath, data, opt) {
+        const str = yaml.dump(data, opt);
+        fs2.outputFile(filePath, str);
+    }
+    async outputYamlAsync(filePath, data, opt) {
+        const str = yaml.dump(data, opt);
+        await fs2.outputFileAsync(filePath, str);
+    }
+}
+export const yaml2 = new Yaml2();

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export * from './buffer/buffer.util.js';
-export * from './colors/colors.js';
 export * from './diff/tableDiff.js';
 export * from './infra/process.util.js';
 export * from './log/log.util.js';
@@ -14,7 +13,4 @@ export * from './slack/slack.service.model.js';
 export * from './string/inspect.js';
 export * from './util/buildInfo.util.js';
 export * from './util/env.util.js';
-export * from './util/exec2.js';
 export * from './util/git2.js';
-export * from './util/lruMemoCache.js';
-export * from './util/zip.util.js';

package/dist/index.js

@@ -1,5 +1,4 @@
 export * from './buffer/buffer.util.js';
-export * from './colors/colors.js';
 export * from './diff/tableDiff.js';
 export * from './infra/process.util.js';
 export * from './log/log.util.js';
@@ -14,7 +13,4 @@ export * from './slack/slack.service.model.js';
 export * from './string/inspect.js';
 export * from './util/buildInfo.util.js';
 export * from './util/env.util.js';
-export * from './util/exec2.js';
 export * from './util/git2.js';
-export * from './util/lruMemoCache.js';
-export * from './util/zip.util.js';

package/dist/jwt/jwt.service.d.ts

@@ -1,4 +1,5 @@
-import type { AnyObject, ErrorData, JWTString } from '@naturalcycles/js-lib';
+import type { ErrorData } from '@naturalcycles/js-lib/error';
+import type { AnyObject, JWTString } from '@naturalcycles/js-lib/types';
 import type { AnySchema } from 'joi';
 import type { Algorithm, JwtHeader, SignOptions, VerifyOptions } from 'jsonwebtoken';
 import jsonwebtoken from 'jsonwebtoken';

package/dist/jwt/jwt.service.js

@@ -1,4 +1,4 @@
-import { _assert, _errorDataAppend } from '@naturalcycles/js-lib';
+import { _assert, _errorDataAppend } from '@naturalcycles/js-lib/error';
 import jsonwebtoken from 'jsonwebtoken';
 import { anyObjectSchema } from '../validation/joi/joi.shared.schemas.js';
 import { validate } from '../validation/joi/joi.validation.util.js';

package/dist/log/log.util.d.ts

@@ -1,4 +1,4 @@
 /**
  * CommonLogger that logs to process.stdout directly (bypassing console.log).
  */
-export declare const stdoutLogger: import("@naturalcycles/js-lib").CommonLogger;
+export declare const stdoutLogger: import("@naturalcycles/js-lib/log").CommonLogger;

package/dist/log/log.util.js

@@ -1,4 +1,4 @@
-import { commonLoggerCreate } from '@naturalcycles/js-lib';
+import { commonLoggerCreate } from '@naturalcycles/js-lib/log';
 import { _inspect } from '../string/inspect.js';
 /**
  * CommonLogger that logs to process.stdout directly (bypassing console.log).

package/dist/script/runScript.d.ts

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

package/dist/script/runScript.js

@@ -1,7 +1,6 @@
-import 'dotenv/config';
 import os from 'node:os';
-import { pDelay, setGlobalStringifyFunction } from '@naturalcycles/js-lib';
-import { dimGrey } from '../colors/colors.js';
+import { pDelay } from '@naturalcycles/js-lib/promise';
+import { setGlobalStringifyFunction } from '@naturalcycles/js-lib/string';
 import { inspectStringifyFn } from '../string/inspect.js';
 const { DEBUG_RUN_SCRIPT } = process.env;
 /**
@@ -23,7 +22,6 @@ 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) {
@@ -42,6 +40,8 @@ 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,7 +62,8 @@ export function runScript(fn, opt = {}) {
         }
     })();
 }
-function checkAndlogEnvironment() {
+async function checkAndlogEnvironment() {
+    const { dimGrey } = await import('../colors/colors.js');
     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';
+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/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';
+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/dist/security/crypto.util.d.ts

@@ -1,4 +1,4 @@
-import type { Base64String, StringMap } from '@naturalcycles/js-lib';
+import { type Base64String, type StringMap } from '@naturalcycles/js-lib/types';
 /**
  * Using aes-256-cbc.
  */

package/dist/security/crypto.util.js

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

package/dist/security/hash.util.d.ts

@@ -1,5 +1,5 @@
 import type { BinaryToTextEncoding } from 'node:crypto';
-import type { Base64String, Base64UrlString } from '@naturalcycles/js-lib';
+import type { Base64String, Base64UrlString } from '@naturalcycles/js-lib/types';
 export declare function md5(s: string | Buffer, outputEncoding?: BinaryToTextEncoding): string;
 export declare function md5AsBuffer(s: string | Buffer): Buffer;
 export declare function sha256(s: string | Buffer, outputEncoding?: BinaryToTextEncoding): string;

package/dist/security/secret.util.d.ts

@@ -1,4 +1,4 @@
-import type { Base64String, StringMap } from '@naturalcycles/js-lib';
+import type { Base64String, StringMap } from '@naturalcycles/js-lib/types';
 /**
  * Loads plaintext secrets from process.env, removes them, stores locally.
  * Make sure to call this function early on server startup, so secrets are removed from process.env

package/dist/security/secret.util.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync } from 'node:fs';
-import { _assert, _jsonParseIfPossible } from '@naturalcycles/js-lib';
+import { _assert } from '@naturalcycles/js-lib/error';
+import { _jsonParseIfPossible } from '@naturalcycles/js-lib/string';
 import { decryptObject, decryptRandomIVBuffer } from './crypto.util.js';
 let loaded = false;
 const secretMap = {};

package/dist/slack/slack.service.d.ts

@@ -1,4 +1,5 @@
-import type { AnyObject, CommonLogger, CommonLogLevel } from '@naturalcycles/js-lib';
+import { type CommonLogger, type CommonLogLevel } from '@naturalcycles/js-lib/log';
+import type { AnyObject } from '@naturalcycles/js-lib/types';
 import type { SlackAttachmentField, SlackMessage, SlackServiceCfg } from './slack.service.model.js';
 /**
  * Has 2 main methods:

package/dist/slack/slack.service.js

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

package/dist/slack/slack.service.model.d.ts

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

package/dist/stream/index.d.ts

@@ -1,3 +1,5 @@
+export * from './ndjson/createReadStreamAsNDJSON.js';
+export * from './ndjson/createWriteStreamAsNDJSON.js';
 export * from './ndjson/ndjson.model.js';
 export * from './ndjson/ndjsonMap.js';
 export * from './ndjson/ndjsonStreamForEach.js';

package/dist/stream/index.js

@@ -1,3 +1,5 @@
+export * from './ndjson/createReadStreamAsNDJSON.js';
+export * from './ndjson/createWriteStreamAsNDJSON.js';
 export * from './ndjson/ndjson.model.js';
 export * from './ndjson/ndjsonMap.js';
 export * from './ndjson/ndjsonStreamForEach.js';

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

@@ -0,0 +1,19 @@
+import type { ReadableTyped } from '../stream.model.js';
+/**
+  Returns a Readable of [already parsed] NDJSON objects.
+ 
+  Replaces a list of operations:
+  - requireFileToExist(inputPath)
+  - fs.createReadStream
+  - createUnzip (only if path ends with '.gz')
+  - transformSplitOnNewline
+  - transformJsonParse
+ 
+  To add a Limit or Offset: just add .take() or .drop(), example:
+ 
+  _pipeline([
+    fs2.createReadStreamAsNDJSON().take(100),
+    transformX(),
+  ])
+ */
+export declare function createReadStreamAsNDJSON<ROW = any>(inputPath: string): ReadableTyped<ROW>;

package/dist/stream/ndjson/createReadStreamAsNDJSON.js

@@ -0,0 +1,38 @@
+import { createUnzip } from 'node:zlib';
+import { fs2 } from '../../fs/fs2.js';
+import { transformSplitOnNewline } from '../transform/transformSplit.js';
+/**
+  Returns a Readable of [already parsed] NDJSON objects.
+ 
+  Replaces a list of operations:
+  - requireFileToExist(inputPath)
+  - fs.createReadStream
+  - createUnzip (only if path ends with '.gz')
+  - transformSplitOnNewline
+  - transformJsonParse
+ 
+  To add a Limit or Offset: just add .take() or .drop(), example:
+ 
+  _pipeline([
+    fs2.createReadStreamAsNDJSON().take(100),
+    transformX(),
+  ])
+ */
+export function createReadStreamAsNDJSON(inputPath) {
+    fs2.requireFileToExist(inputPath);
+    let stream = fs2
+        .createReadStream(inputPath, {
+        highWaterMark: 64 * 1024, // no observed speedup
+    })
+        .on('error', err => stream.emit('error', err));
+    if (inputPath.endsWith('.gz')) {
+        stream = stream.pipe(createUnzip({
+            chunkSize: 64 * 1024, // speedup from ~3200 to 3800 rps!
+        }));
+    }
+    return stream.pipe(transformSplitOnNewline()).map(line => JSON.parse(line));
+    // For some crazy reason .map is much faster than transformJsonParse!
+    // ~5000 vs ~4000 rps !!!
+    // .on('error', err => stream.emit('error', err))
+    // .pipe(transformJsonParse<ROW>())
+}

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

@@ -0,0 +1,11 @@
+import type { TransformTyped } from '../stream.model.js';
+/**
+  Returns an array of Transforms, so that you can ...destructure them at
+  the end of the _pipeline.
+ 
+  Replaces a list of operations:
+  - transformToNDJson
+  - createGzip (only if path ends with '.gz')
+  - fs.createWriteStream
+ */
+export declare function createWriteStreamAsNDJSON(outputPath: string): TransformTyped<any, any>[];

package/dist/stream/ndjson/createWriteStreamAsNDJSON.js

@@ -0,0 +1,27 @@
+import { createGzip } from 'node:zlib';
+import { _isTruthy } from '@naturalcycles/js-lib';
+import { fs2 } from '../../fs/fs2.js';
+import { transformToNDJson } from './transformToNDJson.js';
+/**
+  Returns an array of Transforms, so that you can ...destructure them at
+  the end of the _pipeline.
+ 
+  Replaces a list of operations:
+  - transformToNDJson
+  - createGzip (only if path ends with '.gz')
+  - fs.createWriteStream
+ */
+export function createWriteStreamAsNDJSON(outputPath) {
+    fs2.ensureFile(outputPath);
+    return [
+        transformToNDJson(),
+        outputPath.endsWith('.gz')
+            ? createGzip({
+            // chunkSize: 64 * 1024, // no observed speedup
+            })
+            : undefined,
+        fs2.createWriteStream(outputPath, {
+        // highWaterMark: 64 * 1024, // no observed speedup
+        }),
+    ].filter(_isTruthy);
+}

package/dist/stream/ndjson/ndjson.model.js

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

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

@@ -1,5 +1,5 @@
-import type { AbortableAsyncMapper } from '@naturalcycles/js-lib';
-import type { TransformLogProgressOptions, TransformMapOptions } from '../index.js';
+import type { AbortableAsyncMapper } from '@naturalcycles/js-lib/types';
+import { type TransformLogProgressOptions, type TransformMapOptions } from '../index.js';
 export interface NDJSONMapOptions<IN = any, OUT = IN> extends TransformMapOptions<IN, OUT>, TransformLogProgressOptions<IN> {
     inputFilePath: string;
     outputFilePath: string;