@naturalcycles/nodejs-lib 15.137.0 → 15.139.0

package/dist/cache/lruMemoCache.d.ts

@@ -15,6 +15,7 @@ export declare class LRUMemoCache<KEY = any, VALUE = any> implements MemoCache<K
     has(k: any): boolean;
     get(k: any): any;
     set(k: any, v: any): void;
+    delete(k: any): void;
     clear(): void;
 }
 /**
@@ -26,5 +27,6 @@ export declare class LRUAsyncMemoCache<KEY = any, VALUE = any> implements AsyncM
     has(k: any): Promise<boolean>;
     get(k: any): Promise<VALUE | typeof MISS>;
     set(k: any, v: any): Promise<void>;
+    delete(k: any): Promise<void>;
     clear(): Promise<void>;
 }

package/dist/cache/lruMemoCache.js

@@ -24,6 +24,9 @@ export class LRUMemoCache {
     set(k, v) {
         this.lru.set(k, v);
     }
+    delete(k) {
+        this.lru.delete(k);
+    }
     clear() {
         this.lru.clear();
     }
@@ -53,6 +56,9 @@ export class LRUAsyncMemoCache {
     async set(k, v) {
         this.lru.set(k, v === undefined ? UNDEFINED : v);
     }
+    async delete(k) {
+        this.lru.delete(k);
+    }
     async clear() {
         this.lru.clear();
     }

package/dist/security/secret.util.js

@@ -106,7 +106,5 @@ export function setSecretMap(map) {
         .join(', ')}`);
 }
 function requireLoaded() {
-    if (!loaded) {
-        throw new Error(`Secrets were not loaded! Call loadSecrets() before accessing secrets.`);
-    }
+    _assert(loaded, `Secrets were not loaded! Call loadSecrets() before accessing secrets.`);
 }

package/dist/stream/transform/transformSplit.js

@@ -1,4 +1,5 @@
 import { Transform } from 'node:stream';
+import { _assert } from '@naturalcycles/js-lib/error';
 // The code below is carefully adopted from: https://github.com/max-mapper/binary-split
 // (including the v2.0.0 performance improvements: native Buffer#indexOf and linear-time long lines)
 /**
@@ -22,9 +23,7 @@ export function transformSplitOnNewline() {
  */
 export function transformSplit(separator = '\n') {
     const matcher = Buffer.from(separator);
-    if (matcher.length === 0) {
-        throw new Error('transformSplit: separator must not be empty');
-    }
+    _assert(matcher.length !== 0, 'transformSplit: separator must not be empty');
     const matcherLength = matcher.length;
     // indexOf with a byte value is much faster than with a 1-byte Buffer, which matters for short lines
     const needle = matcherLength === 1 ? matcher[0] : matcher;

package/dist/zip/zipReader.js

@@ -25,6 +25,7 @@ import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 import { promisify } from 'node:util';
 import zlib from 'node:zlib';
+import { _assert } from '@naturalcycles/js-lib/error';
 import { assertSafeZipEntryName, CDFH_SIG, CDFH_SIZE, DEFLATE, dosDateTimeToUnix, EOCDR_SIG, EOCDR_SIZE, LOCAL_FILE_HEADER_SIG, MAX_COMMENT_SIZE, normalizeZipEntryName, readUInt64LE, STORED, ZIP64_EOCDL_SIG, ZIP64_EOCDL_SIZE, ZIP64_EOCDR_SIG, ZIP64_EOCDR_SIZE, } from './zipInternal.js';
 // oxlint-disable no-bitwise -- parsing the binary ZIP format requires bitwise ops on bit flags and packed DOS date/time fields
 const inflateRawAsync = promisify(zlib.inflateRaw.bind(zlib));
@@ -239,12 +240,8 @@ async function readEndOfCentralDirectory(source) {
         if (locatorIndex >= 0 && buf.readUInt32LE(locatorIndex) === ZIP64_EOCDL_SIG) {
             const zip64EocdrOffset = readUInt64LE(buf, locatorIndex + 8);
             const zip64 = await source.read(zip64EocdrOffset, ZIP64_EOCDR_SIZE);
-            if (zip64.readUInt32LE(0) !== ZIP64_EOCDR_SIG) {
-                throw new Error('invalid zip64 end of central directory record signature');
-            }
-            if (zip64.readUInt32LE(16) !== 0) {
-                throw new Error('multi-disk zip files are not supported');
-            }
+            _assert(zip64.readUInt32LE(0) === ZIP64_EOCDR_SIG, 'invalid zip64 end of central directory record signature');
+            _assert(zip64.readUInt32LE(16) === 0, 'multi-disk zip files are not supported');
             entryCount = readUInt64LE(zip64, 32);
             centralDirectoryOffset = readUInt64LE(zip64, 48);
             centralDirectoryEnd = zip64EocdrOffset;

package/dist/zip/zipWriter.js

@@ -29,6 +29,7 @@ import { finished, pipeline } from 'node:stream/promises';
 import { promisify } from 'node:util';
 import zlib from 'node:zlib';
 import { comparators } from '@naturalcycles/js-lib/array/sort.js';
+import { _assert } from '@naturalcycles/js-lib/error/assert.js';
 import { glob } from 'tinyglobby';
 import { assertSafeZipEntryName, CDFH_SIG, CDFH_SIZE, DATA_DESCRIPTOR_SIG, DEFLATE, EOCDR_SIG, EOCDR_SIZE, LOCAL_FILE_HEADER_SIG, MAX_COMMENT_SIZE, normalizeZipEntryName, STORED, unixToDosDateTime, writeUInt64LE, ZIP64_EOCDL_SIG, ZIP64_EOCDL_SIZE, ZIP64_EOCDR_SIG, ZIP64_EOCDR_SIZE, } from './zipInternal.js';
 // oxlint-disable no-bitwise, unicorn/prefer-math-trunc -- writing the binary ZIP format requires bitwise ops on bit flags, packed DOS date/time fields, and unsigned 32-bit attribute packing
@@ -187,9 +188,7 @@ export class ZipWriter {
         }
         // A comment containing this signature would confuse readers that scan
         // backwards for the end-of-central-directory record.
-        if (comment.includes(EOCDR_SIG_BYTES)) {
-            throw new Error('archive comment must not contain the end-of-central-directory signature');
-        }
+        _assert(!comment.includes(EOCDR_SIG_BYTES), 'archive comment must not contain the end-of-central-directory signature');
         this.finalized = true;
         const centralDirectoryOffset = this.offset;
         for (const entry of this.entries) {
@@ -215,8 +214,7 @@ export class ZipWriter {
     assertWritable() {
         if (this.streamError)
             throw this.streamError;
-        if (this.finalized)
-            throw new Error('ZipWriter has already been finalized');
+        _assert(!this.finalized, 'ZipWriter has already been finalized');
     }
     /** Build the in-memory representation of an entry from its name and options. */
     createEntry(fileName, isDirectory, opt) {
@@ -508,8 +506,7 @@ function buildEndRecords(input) {
     return Buffer.concat([zip64Eocdr, locator, eocdr]);
 }
 function normalizeAndValidateEntryName(fileName, isDirectory) {
-    if (!fileName)
-        throw new Error('zip entry name must not be empty');
+    _assert(fileName, 'zip entry name must not be empty');
     let name = normalizeZipEntryName(fileName);
     if (isDirectory) {
         if (!name.endsWith('/'))

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "15.137.0",
+  "version": "15.139.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.70.0",
     "typescript": "^7"
   },
   "exports": {

package/src/cache/lruMemoCache.ts

@@ -34,6 +34,10 @@ export class LRUMemoCache<KEY = any, VALUE = any> implements MemoCache<KEY, VALU
     this.lru.set(k, v)
   }
 
+  delete(k: any): void {
+    this.lru.delete(k)
+  }
+
   clear(): void {
     this.lru.clear()
   }
@@ -69,6 +73,10 @@ export class LRUAsyncMemoCache<KEY = any, VALUE = any> implements AsyncMemoCache
     this.lru.set(k, v === undefined ? UNDEFINED : v)
   }
 
+  async delete(k: any): Promise<void> {
+    this.lru.delete(k)
+  }
+
   async clear(): Promise<void> {
     this.lru.clear()
   }

package/src/security/secret.util.ts

@@ -151,7 +151,5 @@ export function setSecretMap(map: StringMap): void {
 }
 
 function requireLoaded(): void {
-  if (!loaded) {
-    throw new Error(`Secrets were not loaded! Call loadSecrets() before accessing secrets.`)
-  }
+  _assert(loaded, `Secrets were not loaded! Call loadSecrets() before accessing secrets.`)
 }

package/src/stream/transform/transformSplit.ts

@@ -1,4 +1,5 @@
 import { Transform } from 'node:stream'
+import { _assert } from '@naturalcycles/js-lib/error'
 import type { TransformTyped } from '../stream.model.js'
 
 // The code below is carefully adopted from: https://github.com/max-mapper/binary-split
@@ -26,9 +27,7 @@ export function transformSplitOnNewline(): TransformTyped<Buffer, Buffer> {
  */
 export function transformSplit(separator = '\n'): TransformTyped<Buffer, Buffer> {
   const matcher = Buffer.from(separator)
-  if (matcher.length === 0) {
-    throw new Error('transformSplit: separator must not be empty')
-  }
+  _assert(matcher.length !== 0, 'transformSplit: separator must not be empty')
   const matcherLength = matcher.length
   // indexOf with a byte value is much faster than with a 1-byte Buffer, which matters for short lines
   const needle = matcherLength === 1 ? matcher[0]! : matcher

package/src/stream/transform/worker/workerClassProxy.js

@@ -4,6 +4,8 @@ import { workerData, parentPort } from 'node:worker_threads'
 
 const { workerFile, workerIndex, logEvery = 1000, metric = 'worker', silent } = workerData || {}
 
+// The worker entry stays dependency-free, so no `_assert` here
+// oxlint-disable-next-line nc/prefer-assert
 if (!workerFile) {
   throw new Error('workerData.workerFile is required!')
 }

package/src/zip/zipReader.ts

@@ -27,6 +27,7 @@ import { Readable } from 'node:stream'
 import { pipeline } from 'node:stream/promises'
 import { promisify } from 'node:util'
 import zlib from 'node:zlib'
+import { _assert } from '@naturalcycles/js-lib/error'
 import type { UnixTimestamp } from '@naturalcycles/js-lib/types'
 import {
   assertSafeZipEntryName,
@@ -283,12 +284,11 @@ async function readEndOfCentralDirectory(source: ZipSource): Promise<EndOfCentra
     if (locatorIndex >= 0 && buf.readUInt32LE(locatorIndex) === ZIP64_EOCDL_SIG) {
       const zip64EocdrOffset = readUInt64LE(buf, locatorIndex + 8)
       const zip64 = await source.read(zip64EocdrOffset, ZIP64_EOCDR_SIZE)
-      if (zip64.readUInt32LE(0) !== ZIP64_EOCDR_SIG) {
-        throw new Error('invalid zip64 end of central directory record signature')
-      }
-      if (zip64.readUInt32LE(16) !== 0) {
-        throw new Error('multi-disk zip files are not supported')
-      }
+      _assert(
+        zip64.readUInt32LE(0) === ZIP64_EOCDR_SIG,
+        'invalid zip64 end of central directory record signature',
+      )
+      _assert(zip64.readUInt32LE(16) === 0, 'multi-disk zip files are not supported')
       entryCount = readUInt64LE(zip64, 32)
       centralDirectoryOffset = readUInt64LE(zip64, 48)
       centralDirectoryEnd = zip64EocdrOffset

package/src/zip/zipWriter.ts

@@ -31,6 +31,7 @@ import { finished, pipeline } from 'node:stream/promises'
 import { promisify } from 'node:util'
 import zlib from 'node:zlib'
 import { comparators } from '@naturalcycles/js-lib/array/sort.js'
+import { _assert } from '@naturalcycles/js-lib/error/assert.js'
 import type { UnixTimestamp } from '@naturalcycles/js-lib/types'
 import { glob } from 'tinyglobby'
 import {
@@ -250,9 +251,10 @@ export class ZipWriter implements AsyncDisposable {
     }
     // A comment containing this signature would confuse readers that scan
     // backwards for the end-of-central-directory record.
-    if (comment.includes(EOCDR_SIG_BYTES)) {
-      throw new Error('archive comment must not contain the end-of-central-directory signature')
-    }
+    _assert(
+      !comment.includes(EOCDR_SIG_BYTES),
+      'archive comment must not contain the end-of-central-directory signature',
+    )
     this.finalized = true
 
     const centralDirectoryOffset = this.offset
@@ -282,7 +284,7 @@ export class ZipWriter implements AsyncDisposable {
 
   private assertWritable(): void {
     if (this.streamError) throw this.streamError
-    if (this.finalized) throw new Error('ZipWriter has already been finalized')
+    _assert(!this.finalized, 'ZipWriter has already been finalized')
   }
 
   /** Build the in-memory representation of an entry from its name and options. */
@@ -659,7 +661,7 @@ function buildEndRecords(input: EndRecordsInput): Buffer {
 }
 
 function normalizeAndValidateEntryName(fileName: string, isDirectory: boolean): string {
-  if (!fileName) throw new Error('zip entry name must not be empty')
+  _assert(fileName, 'zip entry name must not be empty')
   let name = normalizeZipEntryName(fileName)
   if (isDirectory) {
     if (!name.endsWith('/')) name += '/'