@naturalcycles/nodejs-lib 15.132.0 → 15.133.0

package/dist/csv/csvWriter.d.ts

@@ -18,15 +18,15 @@ export declare class CSVWriter {
     cfg: CSVWriterConfig & {
         delimiter: string;
     };
-    writeRows(rows: AnyObject[]): string;
+    writeRows(rows: readonly AnyObject[]): string;
     writeHeader(): string;
     writeRow(row: AnyObject): string;
     private quoteIfNeeded;
     private quote;
     private shouldQuote;
 }
-export declare function arrayToCSVString(arr: AnyObject[], cfg?: CSVWriterConfig): string;
+export declare function arrayToCSVString(arr: readonly AnyObject[], cfg?: CSVWriterConfig): string;
 /**
  * Iterates over the whole array and notes all possible columns.
  */
-export declare function arrayToCSVColumns(arr: AnyObject[]): string[];
+export declare function arrayToCSVColumns(arr: readonly AnyObject[]): string[];

package/dist/exec2/exec2.js

@@ -50,9 +50,9 @@ class Exec2 {
      */
     spawn(cmd, opt = {}) {
         const { shell = true, cwd, env, passProcessEnv = true, forceColor = hasColors, stdio = 'inherit', maxBuffer = defaultMaxBuffer, } = opt;
-        opt.log ??= true; // by default log should be true, as we are printing the output
-        opt.logStart ??= opt.log;
-        opt.logFinish ??= opt.log;
+        const log = opt.log ?? true; // by default log should be true, as we are printing the output
+        // Copy, to not mutate the input options
+        opt = { ...opt, log, logStart: opt.logStart ?? log, logFinish: opt.logFinish ?? log };
         const started = Date.now();
         this.logStart(cmd, opt);
         const r = spawnSync(cmd, opt.args, {
@@ -92,8 +92,12 @@ class Exec2 {
      */
     exec(cmd, opt = {}) {
         const { cwd, env, passProcessEnv = true, timeout, stdio, maxBuffer = defaultMaxBuffer } = opt;
-        opt.logStart ??= opt.log ?? false;
-        opt.logFinish ??= opt.log ?? false;
+        // Copy, to not mutate the input options
+        opt = {
+            ...opt,
+            logStart: opt.logStart ?? opt.log ?? false,
+            logFinish: opt.logFinish ?? opt.log ?? false,
+        };
         const started = Date.now();
         this.logStart(cmd, opt);
         try {
@@ -141,9 +145,9 @@ class Exec2 {
      */
     async spawnAsync(cmd, opt = {}) {
         const { shell = true, cwd, env, passProcessEnv = true, forceColor = hasColors, stdio = 'inherit', } = opt;
-        opt.log ??= true; // by default log should be true, as we are printing the output
-        opt.logStart ??= opt.log;
-        opt.logFinish ??= opt.log;
+        const log = opt.log ?? true; // by default log should be true, as we are printing the output
+        // Copy, to not mutate the input options
+        opt = { ...opt, log, logStart: opt.logStart ?? log, logFinish: opt.logFinish ?? log };
         const started = Date.now();
         this.logStart(cmd, opt);
         await new Promise((resolve, reject) => {
@@ -196,9 +200,9 @@ class Exec2 {
      */
     async spawnAsyncAndReturn(cmd, opt = {}) {
         const { shell = true, printWhileRunning = true, collectOutputWhileRunning = true, throwOnNonZeroCode = true, cwd, env, passProcessEnv = true, forceColor = hasColors, } = opt;
-        opt.log ??= printWhileRunning; // by default log should be true, as we are printing the output
-        opt.logStart ??= opt.log;
-        opt.logFinish ??= opt.log;
+        const log = opt.log ?? printWhileRunning; // by default log should be true, as we are printing the output
+        // Copy, to not mutate the input options
+        opt = { ...opt, log, logStart: opt.logStart ?? log, logFinish: opt.logFinish ?? log };
         const started = Date.now();
         this.logStart(cmd, opt);
         let stdout = '';

package/dist/fs/kpy.js

@@ -5,7 +5,7 @@ import { boldWhite, dimGrey, grey, yellow } from '../colors/colors.js';
 import { fs2 } from './fs2.js';
 export async function kpy(opt) {
     const started = localTime.nowUnixMillis();
-    kpyPrepare(opt);
+    opt = kpyPrepare(opt);
     const filenames = await glob(opt.inputPatterns, {
         cwd: opt.baseDir,
         dot: opt.dotfiles,
@@ -34,7 +34,7 @@ export async function kpy(opt) {
 }
 export function kpySync(opt) {
     const started = localTime.nowUnixMillis();
-    kpyPrepare(opt);
+    opt = kpyPrepare(opt);
     const filenames = globSync(opt.inputPatterns, {
         cwd: opt.baseDir,
         dot: opt.dotfiles,
@@ -59,16 +59,21 @@ export function kpySync(opt) {
     }
     kpyLogResult(opt, filenames, started);
 }
-function kpyPrepare(opt) {
-    // Default pattern
-    if (!opt.inputPatterns?.length)
-        opt.inputPatterns = ['**'];
-    // default to cwd
-    opt.baseDir ||= '.';
-    opt.outputDir ||= '.';
+/**
+ * Returns normalized copy of the options. Does not mutate the input options.
+ */
+function kpyPrepare(inputOpt) {
+    const opt = {
+        ...inputOpt,
+        // Default pattern
+        inputPatterns: inputOpt.inputPatterns?.length ? inputOpt.inputPatterns.slice() : ['**'],
+        // default to cwd
+        baseDir: inputOpt.baseDir || '.',
+        outputDir: inputOpt.outputDir || '.',
+    };
     if (!fs2.pathExists(opt.baseDir)) {
         console.log(`kpy: baseDir doesn't exist: ${boldWhite(opt.baseDir)}`);
-        return;
+        return opt;
     }
     fs2.ensureDir(opt.outputDir);
     // Expand directories (ex-globby feature), experimental!
@@ -84,6 +89,7 @@ function kpyPrepare(opt) {
         console.log({ extraPatterns });
     }
     opt.inputPatterns.push(...extraPatterns);
+    return opt;
 }
 function kpyLogFilenames(opt, filenames) {
     if (opt.silent)

package/dist/secret/secrets-decrypt.util.d.ts

@@ -9,4 +9,4 @@ export interface DecryptCLIOptions {
  * Decrypts all files in given directory (*.enc), saves decrypted versions without ending `.enc`.
  * Using provided encKey.
  */
-export declare function secretsDecrypt(dir: string[], file: string | undefined, encKeyBuffer: Buffer, del?: boolean, jsonMode?: boolean): void;
+export declare function secretsDecrypt(dir: readonly string[], file: string | undefined, encKeyBuffer: Buffer, del?: boolean, jsonMode?: boolean): void;

package/dist/secret/secrets-encrypt.util.d.ts

@@ -9,4 +9,4 @@ export interface EncryptCLIOptions {
  * Encrypts all files in given directory (except *.enc), saves encrypted versions as filename.ext.enc.
  * Using provided encKey.
  */
-export declare function secretsEncrypt(pattern: string[], file: string | undefined, encKeyBuffer: Buffer, del?: boolean, jsonMode?: boolean): void;
+export declare function secretsEncrypt(pattern: readonly string[], file: string | undefined, encKeyBuffer: Buffer, del?: boolean, jsonMode?: boolean): void;

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

@@ -1,7 +1,7 @@
 export declare class NDJsonStats {
     static create(o?: Partial<NDJsonStats>): NDJsonStats;
     static empty(): NDJsonStats;
-    static createCombined(stats: NDJsonStats[]): NDJsonStats;
+    static createCombined(stats: readonly NDJsonStats[]): NDJsonStats;
     tookMillis: number;
     rows: number;
     sizeBytes: number;

package/dist/stream/pipeline.d.ts

@@ -30,7 +30,7 @@ export declare class Pipeline<T = unknown> {
      * Technically same as `fromIterable` (since Array is Iterable),
      * but named a bit friendlier.
      */
-    static fromArray<T>(input: T[]): Pipeline<T>;
+    static fromArray<T>(input: readonly T[]): Pipeline<T>;
     static fromIterable<T>(input: Iterable<T> | AsyncIterable<T>): Pipeline<T>;
     static fromNDJsonFile<T>(sourceFilePath: string): Pipeline<T>;
     static fromFile(sourceFilePath: string): Pipeline<Uint8Array>;
@@ -76,7 +76,7 @@ export declare class Pipeline<T = unknown> {
      * Helper method to add multiple transforms at once.
      * Not type safe! Prefer using singular `transform()` multiple times for type safety.
      */
-    transformMany<TO>(transforms: Transform[]): Pipeline<TO>;
+    transformMany<TO>(transforms: readonly Transform[]): Pipeline<TO>;
     fork(fn: (pipeline: Pipeline<T>) => Promise<void>, opt?: TransformOptions): this;
     /**
      * Utility method just to conveniently type-cast the current Pipeline type.

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

@@ -12,8 +12,8 @@ import type { TransformOptions } from '../stream.model.js';
  * @experimental
  */
 export declare class ReadableCombined<T> extends Readable implements ReadableTyped<T> {
-    inputs: Readable[];
-    static create<T>(inputs: Readable[], opt?: TransformOptions): ReadableCombined<T>;
+    inputs: readonly Readable[];
+    static create<T>(inputs: readonly Readable[], opt?: TransformOptions): ReadableCombined<T>;
     private constructor();
     private logger;
     /**

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

@@ -7,4 +7,4 @@ import type { ReadableTyped } from '../stream.model.js';
  *
  * For simple cases use Readable.from(...) (Node.js 12+)
  */
-export declare function readableFromArray<IN, OUT>(items: IN[], mapper?: AbortableAsyncMapper<IN, OUT>, opt?: ReadableOptions): ReadableTyped<OUT>;
+export declare function readableFromArray<IN, OUT>(items: readonly IN[], mapper?: AbortableAsyncMapper<IN, OUT>, opt?: ReadableOptions): ReadableTyped<OUT>;

package/dist/validation/ajv/from-data/generateJsonSchemaFromData.d.ts

@@ -5,4 +5,4 @@ import type { JsonSchema } from '../jSchema.js';
  *
  * `additionalProperties` is set to `true`, cause it's safer.
  */
-export declare function generateJsonSchemaFromData<T extends AnyObject = AnyObject>(rows: AnyObject[]): JsonSchema<T>;
+export declare function generateJsonSchemaFromData<T extends AnyObject = AnyObject>(rows: readonly AnyObject[]): JsonSchema<T>;

package/dist/validation/ajv/jsonSchemaBuilder.util.d.ts

@@ -1,15 +1,15 @@
 import type { AnyObject } from '@naturalcycles/js-lib/types';
 import type { JsonSchema } from './jSchema.js';
-export declare const JSON_SCHEMA_ORDER: string[];
+export declare const JSON_SCHEMA_ORDER: readonly string[];
 /**
  * Merges s2 into s1 (mutates s1) and returns s1.
  * Does not mutate s2.
  * API similar to Object.assign(s1, s2)
  */
 export declare function mergeJsonSchemaObjects<T1 extends AnyObject, T2 extends AnyObject>(schema1: JsonSchema<T1>, schema2: JsonSchema<T2>): JsonSchema<T1 & T2>;
-export declare function isEveryItemString(arr: any[]): boolean;
-export declare function isEveryItemNumber(arr: any[]): boolean;
-export declare function isEveryItemPrimitive(arr: any[]): boolean;
+export declare function isEveryItemString(arr: readonly any[]): boolean;
+export declare function isEveryItemNumber(arr: readonly any[]): boolean;
+export declare function isEveryItemPrimitive(arr: readonly any[]): boolean;
 /**
  * Values of the `format` keyword that `j` builders emit, named after the js-lib types they produce.
  * PascalCase on purpose, to never collide with standard, ajv-formats or OpenAPI formats (all lowercase),

package/dist/zip/zip2.d.ts

@@ -66,11 +66,11 @@ declare class Zip2 {
      *
      * Returns the list of extracted entries.
      */
-    extractZipFileToDirectory(zipFilePath: string, destDir: string): Promise<ZipEntry[]>;
+    extractZipFileToDirectory(zipFilePath: string, destDir: string): Promise<readonly ZipEntry[]>;
     /**
      * Create a zip archive on disk from a list of files and/or directories.
      */
-    zipPaths(paths: string[], outputZipFilePath: string, opt?: ZipPathsOptions): Promise<void>;
+    zipPaths(paths: readonly string[], outputZipFilePath: string, opt?: ZipPathsOptions): Promise<void>;
     /**
      * Create a zip archive on disk, returning a {@link ZipWriter} that streams to it.
      *
@@ -90,7 +90,7 @@ declare class Zip2 {
      *
      * For large archives or streamed inputs prefer {@link createZip} / {@link ZipWriter}.
      */
-    createZipBuffer(entries: ZipFileEntry[]): Promise<Buffer<ArrayBuffer>>;
+    createZipBuffer(entries: readonly ZipFileEntry[]): Promise<Buffer<ArrayBuffer>>;
 }
 export declare const zip2: Zip2;
 export {};

package/dist/zip/zipReader.d.ts

@@ -33,7 +33,7 @@ export declare class ZipReader implements AsyncDisposable {
      * All entries (files and directories) found in the archive,
      * in central-directory order.
      */
-    readonly entries: ZipEntry[];
+    readonly entries: readonly ZipEntry[];
     /**
      * Archive-level comment (empty string if none).
      */
@@ -43,7 +43,7 @@ export declare class ZipReader implements AsyncDisposable {
      * All entries (files and directories) found in the archive,
      * in central-directory order.
      */
-    entries: ZipEntry[], 
+    entries: readonly ZipEntry[], 
     /**
      * Archive-level comment (empty string if none).
      */
@@ -66,7 +66,7 @@ export declare class ZipReader implements AsyncDisposable {
      * Extract all entries into `destDir`, streaming each file to disk.
      * See {@link extractZip}.
      */
-    extractAll(destDir: string): Promise<ZipEntry[]>;
+    extractAll(destDir: string): Promise<readonly ZipEntry[]>;
     /**
      * Close the underlying file handle. No-op for buffer-backed archives.
      * Safe to call multiple times.

package/dist/zip/zipWriter.d.ts

@@ -19,13 +19,13 @@ import type { UnixTimestamp } from '@naturalcycles/js-lib/types';
  *
  * On failure the partially-written archive is removed.
  */
-export declare function zipPaths(paths: string[], outputZipFilePath: string, opt?: ZipPathsOptions): Promise<void>;
+export declare function zipPaths(paths: readonly string[], outputZipFilePath: string, opt?: ZipPathsOptions): Promise<void>;
 /**
  * Build a zip archive entirely in memory and return it as a Buffer.
  *
  * For large archives or streamed inputs prefer {@link createZip} / {@link ZipWriter}.
  */
-export declare function createZipBuffer(entries: ZipFileEntry[]): Promise<Buffer<ArrayBuffer>>;
+export declare function createZipBuffer(entries: readonly ZipFileEntry[]): Promise<Buffer<ArrayBuffer>>;
 /**
  * Options for {@link zipPaths}.
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.132.0",
+  "version": "15.133.0",
   "dependencies": {
     "@naturalcycles/js-lib": "^15",
     "@standard-schema/spec": "^1",
@@ -14,7 +14,7 @@
     "yaml": "^2"
   },
   "devDependencies": {
-    "@naturalcycles/dev-lib": "0.0.0",
+    "@naturalcycles/dev-lib": "20.68.0",
     "typescript": "^7"
   },
   "exports": {

package/src/csv/csvWriter.ts

@@ -31,7 +31,7 @@ export class CSVWriter {
 
   cfg: CSVWriterConfig & { delimiter: string }
 
-  writeRows(rows: AnyObject[]): string {
+  writeRows(rows: readonly AnyObject[]): string {
     let s = ''
 
     // Detect columns based on content, if not defined upfront
@@ -68,7 +68,7 @@ export class CSVWriter {
   }
 }
 
-export function arrayToCSVString(arr: AnyObject[], cfg: CSVWriterConfig = {}): string {
+export function arrayToCSVString(arr: readonly AnyObject[], cfg: CSVWriterConfig = {}): string {
   const writer = new CSVWriter(cfg)
   return writer.writeRows(arr)
 }
@@ -76,7 +76,7 @@ export function arrayToCSVString(arr: AnyObject[], cfg: CSVWriterConfig = {}): s
 /**
  * Iterates over the whole array and notes all possible columns.
  */
-export function arrayToCSVColumns(arr: AnyObject[]): string[] {
+export function arrayToCSVColumns(arr: readonly AnyObject[]): string[] {
   const cols = new Set<string>()
   for (const row of arr) {
     for (const col of Object.keys(row)) {

package/src/exec2/exec2.ts

@@ -66,9 +66,9 @@ class Exec2 {
       stdio = 'inherit',
       maxBuffer = defaultMaxBuffer,
     } = opt
-    opt.log ??= true // by default log should be true, as we are printing the output
-    opt.logStart ??= opt.log
-    opt.logFinish ??= opt.log
+    const log = opt.log ?? true // by default log should be true, as we are printing the output
+    // Copy, to not mutate the input options
+    opt = { ...opt, log, logStart: opt.logStart ?? log, logFinish: opt.logFinish ?? log }
     const started = Date.now() as UnixTimestampMillis
     this.logStart(cmd, opt)
 
@@ -112,8 +112,12 @@ class Exec2 {
    */
   exec(cmd: string, opt: ExecOptions = {}): string {
     const { cwd, env, passProcessEnv = true, timeout, stdio, maxBuffer = defaultMaxBuffer } = opt
-    opt.logStart ??= opt.log ?? false
-    opt.logFinish ??= opt.log ?? false
+    // Copy, to not mutate the input options
+    opt = {
+      ...opt,
+      logStart: opt.logStart ?? opt.log ?? false,
+      logFinish: opt.logFinish ?? opt.log ?? false,
+    }
     const started = Date.now() as UnixTimestampMillis
     this.logStart(cmd, opt)
 
@@ -170,9 +174,9 @@ class Exec2 {
       forceColor = hasColors,
       stdio = 'inherit',
     } = opt
-    opt.log ??= true // by default log should be true, as we are printing the output
-    opt.logStart ??= opt.log
-    opt.logFinish ??= opt.log
+    const log = opt.log ?? true // by default log should be true, as we are printing the output
+    // Copy, to not mutate the input options
+    opt = { ...opt, log, logStart: opt.logStart ?? log, logFinish: opt.logFinish ?? log }
     const started = Date.now() as UnixTimestampMillis
     this.logStart(cmd, opt)
 
@@ -238,9 +242,9 @@ class Exec2 {
       passProcessEnv = true,
       forceColor = hasColors,
     } = opt
-    opt.log ??= printWhileRunning // by default log should be true, as we are printing the output
-    opt.logStart ??= opt.log
-    opt.logFinish ??= opt.log
+    const log = opt.log ?? printWhileRunning // by default log should be true, as we are printing the output
+    // Copy, to not mutate the input options
+    opt = { ...opt, log, logStart: opt.logStart ?? log, logFinish: opt.logFinish ?? log }
     const started = Date.now() as UnixTimestampMillis
     this.logStart(cmd, opt)
     let stdout = ''

package/src/fs/kpy.ts

@@ -47,7 +47,7 @@ export interface KpyOptions {
 export async function kpy(opt: KpyOptions): Promise<void> {
   const started = localTime.nowUnixMillis()
 
-  kpyPrepare(opt)
+  opt = kpyPrepare(opt)
 
   const filenames = await glob(opt.inputPatterns!, {
     cwd: opt.baseDir,
@@ -86,7 +86,7 @@ export async function kpy(opt: KpyOptions): Promise<void> {
 export function kpySync(opt: KpyOptions): void {
   const started = localTime.nowUnixMillis()
 
-  kpyPrepare(opt)
+  opt = kpyPrepare(opt)
 
   const filenames = globSync(opt.inputPatterns!, {
     cwd: opt.baseDir,
@@ -118,17 +118,22 @@ export function kpySync(opt: KpyOptions): void {
   kpyLogResult(opt, filenames, started)
 }
 
-function kpyPrepare(opt: KpyOptions): void {
-  // Default pattern
-  if (!opt.inputPatterns?.length) opt.inputPatterns = ['**']
-
-  // default to cwd
-  opt.baseDir ||= '.'
-  opt.outputDir ||= '.'
+/**
+ * Returns normalized copy of the options. Does not mutate the input options.
+ */
+function kpyPrepare(inputOpt: KpyOptions): KpyOptions {
+  const opt = {
+    ...inputOpt,
+    // Default pattern
+    inputPatterns: inputOpt.inputPatterns?.length ? inputOpt.inputPatterns.slice() : ['**'],
+    // default to cwd
+    baseDir: inputOpt.baseDir || '.',
+    outputDir: inputOpt.outputDir || '.',
+  }
 
   if (!fs2.pathExists(opt.baseDir)) {
     console.log(`kpy: baseDir doesn't exist: ${boldWhite(opt.baseDir)}`)
-    return
+    return opt
   }
 
   fs2.ensureDir(opt.outputDir)
@@ -147,9 +152,10 @@ function kpyPrepare(opt: KpyOptions): void {
     console.log({ extraPatterns })
   }
   opt.inputPatterns.push(...extraPatterns)
+  return opt
 }
 
-function kpyLogFilenames(opt: KpyOptions, filenames: string[]): void {
+function kpyLogFilenames(opt: KpyOptions, filenames: readonly string[]): void {
   if (opt.silent) return
 
   // console.log({filenames})
@@ -160,7 +166,11 @@ function kpyLogFilenames(opt: KpyOptions, filenames: string[]): void {
   )
 }
 
-function kpyLogResult(opt: KpyOptions, filenames: string[], started: UnixTimestampMillis): void {
+function kpyLogResult(
+  opt: KpyOptions,
+  filenames: readonly string[],
+  started: UnixTimestampMillis,
+): void {
   if (opt.silent || filenames.length === 0) return
 
   console.log(

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

@@ -25,7 +25,7 @@ export interface DecryptCLIOptions {
  * Using provided encKey.
  */
 export function secretsDecrypt(
-  dir: string[],
+  dir: readonly string[],
   file: string | undefined,
   encKeyBuffer: Buffer,
   del = false,

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

@@ -19,7 +19,7 @@ export interface EncryptCLIOptions {
  * Using provided encKey.
  */
 export function secretsEncrypt(
-  pattern: string[],
+  pattern: readonly string[],
   file: string | undefined,
   encKeyBuffer: Buffer,
   del = false,

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

@@ -11,7 +11,7 @@ export class NDJsonStats {
     return new NDJsonStats()
   }
 
-  static createCombined(stats: NDJsonStats[]): NDJsonStats {
+  static createCombined(stats: readonly NDJsonStats[]): NDJsonStats {
     // oxlint-disable-next-line unicorn/no-array-reduce
     return stats.reduce((statsTotal, stats) => statsTotal.add(stats), new NDJsonStats())
   }

package/src/stream/pipeline.ts

@@ -93,7 +93,7 @@ export class Pipeline<T = unknown> {
    * Technically same as `fromIterable` (since Array is Iterable),
    * but named a bit friendlier.
    */
-  static fromArray<T>(input: T[]): Pipeline<T> {
+  static fromArray<T>(input: readonly T[]): Pipeline<T> {
     return new Pipeline(Readable.from(input))
   }
 
@@ -265,7 +265,7 @@ export class Pipeline<T = unknown> {
    * Helper method to add multiple transforms at once.
    * Not type safe! Prefer using singular `transform()` multiple times for type safety.
    */
-  transformMany<TO>(transforms: Transform[]): Pipeline<TO> {
+  transformMany<TO>(transforms: readonly Transform[]): Pipeline<TO> {
     this.transforms.push(...transforms)
     return this as any
   }

package/src/stream/readable/readableCombined.ts

@@ -18,12 +18,12 @@ import type { TransformOptions } from '../stream.model.js'
  * @experimental
  */
 export class ReadableCombined<T> extends Readable implements ReadableTyped<T> {
-  static create<T>(inputs: Readable[], opt: TransformOptions = {}): ReadableCombined<T> {
+  static create<T>(inputs: readonly Readable[], opt: TransformOptions = {}): ReadableCombined<T> {
     return new ReadableCombined<T>(inputs, opt)
   }
 
   private constructor(
-    public inputs: Readable[],
+    public inputs: readonly Readable[],
     opt: TransformOptions,
   ) {
     const { objectMode = true, highWaterMark } = opt

package/src/stream/readable/readableFromArray.ts

@@ -11,7 +11,7 @@ import type { ReadableTyped } from '../stream.model.js'
  * For simple cases use Readable.from(...) (Node.js 12+)
  */
 export function readableFromArray<IN, OUT>(
-  items: IN[],
+  items: readonly IN[],
   mapper: AbortableAsyncMapper<IN, OUT> = _passthroughMapper,
   opt?: ReadableOptions,
 ): ReadableTyped<OUT> {

package/src/stream/transform/transformFlatten.ts

@@ -5,7 +5,7 @@ export function transformFlatten<T>(): TransformTyped<T[], T> {
   return new Transform({
     objectMode: true,
     highWaterMark: 1,
-    transform(chunk: T[], _, cb) {
+    transform(chunk: readonly T[], _, cb) {
       for (const item of chunk) {
         this.push(item)
       }
@@ -18,7 +18,7 @@ export function transformFlattenIfNeeded<T>(): TransformTyped<T[], T> {
   return new Transform({
     objectMode: true,
     highWaterMark: 1,
-    transform(chunk: T[], _, cb) {
+    transform(chunk: readonly T[], _, cb) {
       if (Array.isArray(chunk)) {
         for (const item of chunk) {
           this.push(item)

package/src/validation/ajv/from-data/generateJsonSchemaFromData.ts

@@ -12,12 +12,12 @@ type Type = PrimitiveType | 'array' | 'object'
  * `additionalProperties` is set to `true`, cause it's safer.
  */
 export function generateJsonSchemaFromData<T extends AnyObject = AnyObject>(
-  rows: AnyObject[],
+  rows: readonly AnyObject[],
 ): JsonSchema<T> {
   return objectToJsonSchema<T>(rows)
 }
 
-function objectToJsonSchema<T extends AnyObject>(rows: AnyObject[]): JsonSchema<T> {
+function objectToJsonSchema<T extends AnyObject>(rows: readonly AnyObject[]): JsonSchema<T> {
   const typesByKey: StringMap<Set<Type>> = {}
 
   rows.forEach(r => {
@@ -48,7 +48,7 @@ function objectToJsonSchema<T extends AnyObject>(rows: AnyObject[]): JsonSchema<
   return s
 }
 
-function mergeTypes(types: Type[], samples: any[]): JsonSchema | undefined {
+function mergeTypes(types: readonly Type[], samples: readonly any[]): JsonSchema | undefined {
   // skip "undefined" types
   types = types.filter(t => t !== 'undefined')
 

package/src/validation/ajv/getAjv.ts

@@ -456,7 +456,7 @@ export function createAjv(opt?: Options): Ajv2020 {
     errors: false,
     schemaType: 'array',
     validate: function validate(
-      optionalValues: (string | number | boolean)[],
+      optionalValues: readonly (string | number | boolean)[],
       data: string | number | boolean,
       _schema,
       ctx,
@@ -549,7 +549,12 @@ export function createAjv(opt?: Options): Ajv2020 {
     modifying: false,
     errors: true,
     schemaType: 'array',
-    validate: function validate(exclusiveProperties: string[][], data: AnyObject, _schema, ctx) {
+    validate: function validate(
+      exclusiveProperties: readonly string[][],
+      data: AnyObject,
+      _schema,
+      ctx,
+    ) {
       if (typeof data !== 'object') return true
 
       for (const props of exclusiveProperties) {
@@ -619,7 +624,7 @@ export function createAjv(opt?: Options): Ajv2020 {
     modifying: true,
     errors: true,
     schemaType: 'array',
-    compile(schemas: JSchema<any, any>[], _parentSchema, _it) {
+    compile(schemas: readonly JSchema<any, any>[], _parentSchema, _it) {
       const validators = schemas.map(schema => ajv.compile(schema))
 
       function validate(data: AnyObject, ctx: any): boolean {
@@ -689,7 +694,12 @@ export function createAjv(opt?: Options): Ajv2020 {
     modifying: false,
     errors: true,
     schemaType: 'array',
-    validate: function validate(customValidations: CustomValidatorFn[], data: any, _schema, ctx) {
+    validate: function validate(
+      customValidations: readonly CustomValidatorFn[],
+      data: any,
+      _schema,
+      ctx,
+    ) {
       if (!customValidations?.length) return true
 
       for (const validator of customValidations) {
@@ -715,7 +725,7 @@ export function createAjv(opt?: Options): Ajv2020 {
     errors: false,
     schemaType: 'array',
     validate: function validate(
-      customConversions: CustomConverterFn<any>[],
+      customConversions: readonly CustomConverterFn<any>[],
       data: any,
       _schema,
       ctx,

package/src/validation/ajv/jsonSchemaBuilder.util.ts

@@ -3,7 +3,7 @@ import { _filterNullishValues } from '@naturalcycles/js-lib/object'
 import type { AnyObject } from '@naturalcycles/js-lib/types'
 import type { JsonSchema } from './jSchema.js'
 
-export const JSON_SCHEMA_ORDER = [
+export const JSON_SCHEMA_ORDER: readonly string[] = [
   '$schema',
   '$id',
   'title',
@@ -79,21 +79,21 @@ export function mergeJsonSchemaObjects<T1 extends AnyObject, T2 extends AnyObjec
   return _filterNullishValues(s1, { mutate: true })
 }
 
-export function isEveryItemString(arr: any[]): boolean {
+export function isEveryItemString(arr: readonly any[]): boolean {
   for (const item of arr) {
     if (typeof item !== 'string') return false
   }
   return true
 }
 
-export function isEveryItemNumber(arr: any[]): boolean {
+export function isEveryItemNumber(arr: readonly any[]): boolean {
   for (const item of arr) {
     if (typeof item !== 'number') return false
   }
   return true
 }
 
-export function isEveryItemPrimitive(arr: any[]): boolean {
+export function isEveryItemPrimitive(arr: readonly any[]): boolean {
   for (const item of arr) {
     if (typeof item !== 'number' && typeof item !== 'string' && typeof item !== 'symbol') {
       return false

package/src/zip/zip2.ts

@@ -177,7 +177,10 @@ class Zip2 {
    *
    * Returns the list of extracted entries.
    */
-  async extractZipFileToDirectory(zipFilePath: string, destDir: string): Promise<ZipEntry[]> {
+  async extractZipFileToDirectory(
+    zipFilePath: string,
+    destDir: string,
+  ): Promise<readonly ZipEntry[]> {
     const zip = await openZip(zipFilePath)
     try {
       return await zip.extractAll(destDir)
@@ -189,7 +192,11 @@ class Zip2 {
   /**
    * Create a zip archive on disk from a list of files and/or directories.
    */
-  async zipPaths(paths: string[], outputZipFilePath: string, opt?: ZipPathsOptions): Promise<void> {
+  async zipPaths(
+    paths: readonly string[],
+    outputZipFilePath: string,
+    opt?: ZipPathsOptions,
+  ): Promise<void> {
     return await zipPaths(paths, outputZipFilePath, opt)
   }
 
@@ -215,7 +222,7 @@ class Zip2 {
    *
    * For large archives or streamed inputs prefer {@link createZip} / {@link ZipWriter}.
    */
-  async createZipBuffer(entries: ZipFileEntry[]): Promise<Buffer<ArrayBuffer>> {
+  async createZipBuffer(entries: readonly ZipFileEntry[]): Promise<Buffer<ArrayBuffer>> {
     return await createZipBuffer(entries)
   }
 }

package/src/zip/zipReader.ts

@@ -100,7 +100,7 @@ export class ZipReader implements AsyncDisposable {
      * All entries (files and directories) found in the archive,
      * in central-directory order.
      */
-    readonly entries: ZipEntry[],
+    readonly entries: readonly ZipEntry[],
     /**
      * Archive-level comment (empty string if none).
      */
@@ -160,7 +160,7 @@ export class ZipReader implements AsyncDisposable {
    * Extract all entries into `destDir`, streaming each file to disk.
    * See {@link extractZip}.
    */
-  async extractAll(destDir: string): Promise<ZipEntry[]> {
+  async extractAll(destDir: string): Promise<readonly ZipEntry[]> {
     const root = path.resolve(destDir)
     for (const entry of this.entries) {
       const targetPath = assertPathInside(root, entry.fileName)
@@ -402,7 +402,7 @@ function parseExtraFields(buf: Buffer): ExtraField[] {
 }
 
 function readZip64ExtraField(
-  extraFields: ExtraField[],
+  extraFields: readonly ExtraField[],
   uncompressedSize: number,
   compressedSize: number,
   relativeOffsetOfLocalHeader: number,
@@ -431,7 +431,7 @@ function readZip64ExtraField(
 function decodeFileName(
   generalPurposeBitFlag: number,
   fileNameRaw: Buffer,
-  extraFields: ExtraField[],
+  extraFields: readonly ExtraField[],
 ): string {
   // Info-ZIP Unicode Path Extra Field (0x7075): an authoritative UTF-8 name,
   // used only if its stored CRC-32 matches the raw name. See yauzl#33.
@@ -449,7 +449,11 @@ function decodeFileName(
   return normalizeZipEntryName(decodeBuffer(fileNameRaw, hasUtf8Flag))
 }
 
-function parseLastModified(date: number, time: number, extraFields: ExtraField[]): UnixTimestamp {
+function parseLastModified(
+  date: number,
+  time: number,
+  extraFields: readonly ExtraField[],
+): UnixTimestamp {
   // Prefer the Info-ZIP "UT" extended timestamp (0x5455) if it carries mtime.
   // Its payload is already a Unix timestamp in seconds.
   const ut = extraFields.find(f => f.id === 0x5455)

package/src/zip/zipWriter.ts

@@ -76,7 +76,7 @@ const deflateRawAsync = promisify(zlib.deflateRaw.bind(zlib))
  * On failure the partially-written archive is removed.
  */
 export async function zipPaths(
-  paths: string[],
+  paths: readonly string[],
   outputZipFilePath: string,
   opt: ZipPathsOptions = {},
 ): Promise<void> {
@@ -105,7 +105,9 @@ export async function zipPaths(
  *
  * For large archives or streamed inputs prefer {@link createZip} / {@link ZipWriter}.
  */
-export async function createZipBuffer(entries: ZipFileEntry[]): Promise<Buffer<ArrayBuffer>> {
+export async function createZipBuffer(
+  entries: readonly ZipFileEntry[],
+): Promise<Buffer<ArrayBuffer>> {
   const chunks: Buffer[] = []
   const sink = new Writable({
     write(chunk: Buffer, _enc, cb) {
@@ -684,7 +686,10 @@ interface FileToZip {
  * Expand input paths (files and/or directories) into a flat list of files to add,
  * resolving each entry's archive name relative to `baseDir` (or each input's parent).
  */
-async function collectFiles(inputs: string[], baseDir: string | undefined): Promise<FileToZip[]> {
+async function collectFiles(
+  inputs: readonly string[],
+  baseDir: string | undefined,
+): Promise<FileToZip[]> {
   const files: FileToZip[] = []
   for (const input of inputs) {
     const stats = await fsp.stat(input)