@naturalcycles/nodejs-lib 14.1.0 → 14.2.0

package/dist/script/runScript.d.ts

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

package/dist/script/runScript.js

@@ -1,3 +1,4 @@
+import 'dotenv/config';
 import os from 'node:os';
 import { pDelay, setGlobalStringifyFunction } from '@naturalcycles/js-lib';
 import { dimGrey } from '../colors/colors.js';
@@ -22,7 +23,7 @@ const { DEBUG_RUN_SCRIPT } = process.env;
  * Set env DEBUG_RUN_SCRIPT for extra debugging.
  */
 export function runScript(fn, opt = {}) {
-    logEnvironment();
+    checkAndlogEnvironment();
     setGlobalStringifyFunction(inspectStringifyFn);
     const { logger = console, noExit, registerUncaughtExceptionHandlers = true } = opt;
     if (registerUncaughtExceptionHandlers || DEBUG_RUN_SCRIPT) {
@@ -40,7 +41,6 @@ export function runScript(fn, opt = {}) {
     // fake timeout, to ensure node.js process won't exit until runScript main promise is resolved
     const timeout = setTimeout(() => { }, 10000000);
     void (async () => {
-        await import('dotenv/config');
         try {
             await fn();
             await pDelay(); // to ensure all async operations are completed
@@ -62,24 +62,40 @@ export function runScript(fn, opt = {}) {
         }
     })();
 }
-function logEnvironment() {
-    const { platform, arch, versions: { node }, env: { CPU_LIMIT, NODE_OPTIONS }, } = process;
+function checkAndlogEnvironment() {
+    const { platform, arch, versions: { node }, env: { CPU_LIMIT, NODE_OPTIONS, TZ }, } = process;
     const cpuLimit = Number(CPU_LIMIT) || undefined;
     const availableParallelism = os.availableParallelism?.();
     const cpus = os.cpus().length;
-    console.log(dimGrey(Object.entries({
+    console.log(dimGrey(formatObject({
         node: `${node} ${platform} ${arch}`,
-        NODE_OPTIONS: NODE_OPTIONS || 'not defined',
         cpus,
         availableParallelism,
         cpuLimit,
-    })
-        .map(([k, v]) => `${k}: ${v}`)
-        .join(', ')));
+    }) +
+        '\n' +
+        formatObject({
+            NODE_OPTIONS: NODE_OPTIONS || 'not defined',
+            TZ,
+        })));
     if (!NODE_OPTIONS) {
         console.warn(`NODE_OPTIONS env variable is not defined. You may run into out-of-memory issues when running memory-intensive scripts. It's recommended to set it to:\n--max-old-space-size=12000`);
     }
     else if (NODE_OPTIONS.includes('max_old')) {
         console.warn(`It looks like you're using "max_old_space_size" syntax with underscores instead of dashes - it's WRONG and doesn't work in environment variables. Strongly advised to rename it to "max-old-space-size"`);
     }
+    if (!TZ) {
+        console.error([
+            '!!! TZ environment variable is required to be set, but was not set.',
+            'The runScript will exit and not continue further because of that,',
+            'please ensure the TZ variable and try again.',
+            'If you are running locally, you can add TZ=UTC to the local .env file.',
+        ].join('\n'));
+        process.exit(1);
+    }
+}
+function formatObject(obj) {
+    return Object.entries(obj)
+        .map(([k, v]) => `${k}: ${v}`)
+        .join(', ');
 }

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

@@ -1,11 +1,7 @@
-import { dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { Worker } from 'node:worker_threads';
 import { _range, pDefer } from '@naturalcycles/js-lib';
 import through2Concurrent from 'through2-concurrent';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const workerProxyFilePath = `${__dirname}/workerClassProxy.js`;
+const workerProxyFilePath = `${import.meta.dirname}/workerClassProxy.js`;
 /**
  * Spawns a pool of Workers (threads).
  * Distributes (using round-robin, equally) all inputs over Workers.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/nodejs-lib",
   "type": "module",
-  "version": "14.1.0",
+  "version": "14.2.0",
   "scripts": {
     "prepare": "husky",
     "build": "dev-lib build",

package/src/script/runScript.ts

@@ -1,5 +1,6 @@
+import 'dotenv/config'
 import os from 'node:os'
-import type { CommonLogger } from '@naturalcycles/js-lib'
+import type { AnyObject, CommonLogger } from '@naturalcycles/js-lib'
 import { pDelay, setGlobalStringifyFunction } from '@naturalcycles/js-lib'
 import { dimGrey } from '../colors/colors.js'
 import { inspectStringifyFn } from '../string/inspect.js'
@@ -45,7 +46,7 @@ const { DEBUG_RUN_SCRIPT } = process.env
  * Set env DEBUG_RUN_SCRIPT for extra debugging.
  */
 export function runScript(fn: (...args: any[]) => any, opt: RunScriptOptions = {}): void {
-  logEnvironment()
+  checkAndlogEnvironment()
   setGlobalStringifyFunction(inspectStringifyFn)
 
   const { logger = console, noExit, registerUncaughtExceptionHandlers = true } = opt
@@ -68,8 +69,6 @@ export function runScript(fn: (...args: any[]) => any, opt: RunScriptOptions = {
   const timeout = setTimeout(() => {}, 10000000)
 
   void (async () => {
-    await import('dotenv/config')
-
     try {
       await fn()
 
@@ -92,12 +91,12 @@ export function runScript(fn: (...args: any[]) => any, opt: RunScriptOptions = {
   })()
 }
 
-function logEnvironment(): void {
+function checkAndlogEnvironment(): void {
   const {
     platform,
     arch,
     versions: { node },
-    env: { CPU_LIMIT, NODE_OPTIONS },
+    env: { CPU_LIMIT, NODE_OPTIONS, TZ },
   } = process
 
   const cpuLimit = Number(CPU_LIMIT) || undefined
@@ -105,15 +104,17 @@ function logEnvironment(): void {
   const cpus = os.cpus().length
   console.log(
     dimGrey(
-      Object.entries({
+      formatObject({
         node: `${node} ${platform} ${arch}`,
-        NODE_OPTIONS: NODE_OPTIONS || 'not defined',
         cpus,
         availableParallelism,
         cpuLimit,
-      })
-        .map(([k, v]) => `${k}: ${v}`)
-        .join(', '),
+      }) +
+        '\n' +
+        formatObject({
+          NODE_OPTIONS: NODE_OPTIONS || 'not defined',
+          TZ,
+        }),
     ),
   )
 
@@ -126,4 +127,22 @@ function logEnvironment(): void {
       `It looks like you're using "max_old_space_size" syntax with underscores instead of dashes - it's WRONG and doesn't work in environment variables. Strongly advised to rename it to "max-old-space-size"`,
     )
   }
+
+  if (!TZ) {
+    console.error(
+      [
+        '!!! TZ environment variable is required to be set, but was not set.',
+        'The runScript will exit and not continue further because of that,',
+        'please ensure the TZ variable and try again.',
+        'If you are running locally, you can add TZ=UTC to the local .env file.',
+      ].join('\n'),
+    )
+    process.exit(1)
+  }
+}
+
+function formatObject(obj: AnyObject): string {
+  return Object.entries(obj)
+    .map(([k, v]) => `${k}: ${v}`)
+    .join(', ')
 }

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

@@ -1,5 +1,3 @@
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
 import { Worker } from 'node:worker_threads'
 import type { AnyObject, DeferredPromise } from '@naturalcycles/js-lib'
 import { _range, pDefer } from '@naturalcycles/js-lib'
@@ -7,9 +5,6 @@ import through2Concurrent from 'through2-concurrent'
 import type { TransformTyped } from '../../stream.model.js'
 import type { WorkerInput, WorkerOutput } from './transformMultiThreaded.model.js'
 
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = dirname(__filename)
-
 export interface TransformMultiThreadedOptions {
   /**
    * Absolute path to a js file with worker code
@@ -37,7 +32,7 @@ export interface TransformMultiThreadedOptions {
   workerData?: AnyObject
 }
 
-const workerProxyFilePath = `${__dirname}/workerClassProxy.js`
+const workerProxyFilePath = `${import.meta.dirname}/workerClassProxy.js`
 
 /**
  * Spawns a pool of Workers (threads).