@jsenv/core 24.5.8 → 24.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsenv/core",
-  "version": "24.5.8",
+  "version": "24.6.1",
   "description": "Tool to develop, test and build js projects",
   "license": "MIT",
   "repository": {
@@ -11,7 +11,8 @@
     "node": ">=14.9.0"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "type": "module",
   "exports": {
@@ -135,4 +136,4 @@
     "redux": "4.1.2",
     "rollup-plugin-import-assert": "1.1.1"
   }
-}
+}

package/src/buildProject.js

@@ -159,9 +159,8 @@ export const buildProject = async ({
     jsenvDirectoryRelativeUrl,
     jsenvDirectoryClean,
     // build compiled files are written into a different directory
-    // than exploring-server. This is because here we compile for rollup
+    // than dev-server. This is because here we compile for rollup
     // that is expecting esmodule format, not systemjs
-    // + some more differences like import.meta.dev
     outDirectoryName: "build",
     importDefaultExtension,
     moduleOutFormat: "esmodule", // rollup or jsenv rollup plugin will transform into the right format

package/src/executeTestPlan.js

@@ -32,20 +32,23 @@ export const executeTestPlan = async ({
   importDefaultExtension,
 
   testPlan,
-  defaultMsAllocatedPerExecution,
-  cooldownBetweenExecutions,
 
-  maxExecutionsInParallel,
+  logMemoryHeapUsage = false,
   completedExecutionLogAbbreviation = false,
   completedExecutionLogMerging = false,
   logSummary = true,
   updateProcessExitCode = true,
+
+  maxExecutionsInParallel = 1,
+  defaultMsAllocatedPerExecution = 30000,
   // stopAfterExecute: true to ensure runtime is stopped once executed
   // because we have what we wants: execution is completed and
   // we have associated coverage and capturedConsole
   // passsing false means all node process and browsers launched stays opened
   // (can eventually be used for debug)
   stopAfterExecute = true,
+  cooldownBetweenExecutions = 0,
+  gcBetweenExecutions = logMemoryHeapUsage,
 
   coverage = process.argv.includes("--cover") ||
     process.argv.includes("--coverage"),
@@ -148,13 +151,16 @@ export const executeTestPlan = async ({
     importResolutionMethod,
     importDefaultExtension,
 
+    logMemoryHeapUsage,
+    completedExecutionLogMerging,
+    completedExecutionLogAbbreviation,
+    logSummary,
+
     defaultMsAllocatedPerExecution,
     maxExecutionsInParallel,
     stopAfterExecute,
     cooldownBetweenExecutions,
-    completedExecutionLogMerging,
-    completedExecutionLogAbbreviation,
-    logSummary,
+    gcBetweenExecutions,
 
     coverage,
     coverageConfig,

package/src/internal/compiling/js-compilation-service/jsenvTransform.js

@@ -52,6 +52,9 @@ export const jsenvTransform = async ({
     parserOpts: {
       allowAwaitOutsideFunction: allowTopLevelAwait,
     },
+    generatorOpts: {
+      compact: false,
+    },
   }
 
   const babelHelperName = filePathToBabelHelperName(inputPath)

package/src/internal/executing/createSummaryLog.js

@@ -1,16 +1,17 @@
 import { ANSI } from "@jsenv/log"
 
 import { msAsDuration } from "../logs/msAsDuration.js"
+import { formatByte } from "../logs/byte.js"
 import { EXECUTION_COLORS } from "./execution_colors.js"
 
 export const createSummaryLog = (
   summary,
 ) => `-------------- summary -----------------
-${createSummaryMessage(summary)}
+${createAllExecutionsSummary(summary)}
 total duration: ${msAsDuration(summary.duration)}
 ----------------------------------------`
 
-const createSummaryMessage = ({
+const createAllExecutionsSummary = ({
   executionCount,
   abortedCount,
   timedoutCount,
@@ -24,7 +25,7 @@ const createSummaryMessage = ({
 
   const executionLabel =
     executionCount === 1 ? `1 execution` : `${executionCount} executions`
-  return `${executionLabel}: ${createSummaryDetails({
+  return `${executionLabel}: ${createStatusSummary({
     executionCount,
     abortedCount,
     timedoutCount,
@@ -34,7 +35,32 @@ const createSummaryMessage = ({
   })}`
 }
 
-export const createSummaryDetails = ({
+export const createIntermediateSummary = ({
+  executionCount,
+  abortedCount,
+  timedoutCount,
+  erroredCount,
+  completedCount,
+  cancelledCount,
+  memoryHeap,
+}) => {
+  let intermediateSummary = createStatusSummary({
+    executionCount,
+    abortedCount,
+    timedoutCount,
+    erroredCount,
+    completedCount,
+    cancelledCount,
+  })
+
+  if (memoryHeap) {
+    intermediateSummary += ` / memory heap: ${formatByte(memoryHeap)}`
+  }
+
+  return intermediateSummary
+}
+
+const createStatusSummary = ({
   executionCount,
   abortedCount,
   timedoutCount,

package/src/internal/executing/executeConcurrently.js

@@ -1,4 +1,5 @@
 import { existsSync } from "node:fs"
+import { memoryUsage } from "node:process"
 import wrapAnsi from "wrap-ansi"
 import cuid from "cuid"
 import { loggerToLevels } from "@jsenv/logger"
@@ -17,6 +18,7 @@ import { launchAndExecute } from "../executing/launchAndExecute.js"
 import { reportToCoverage } from "./coverage/reportToCoverage.js"
 import { formatExecuting, formatExecutionResult } from "./executionLogs.js"
 import { createSummaryLog } from "./createSummaryLog.js"
+import { ensureGlobalGc } from "./gc.js"
 
 export const executeConcurrently = async (
   executionSteps,
@@ -28,16 +30,19 @@ export const executeConcurrently = async (
 
     projectDirectoryUrl,
     compileServer,
-
     babelPluginMap,
 
-    defaultMsAllocatedPerExecution = 30000,
-    cooldownBetweenExecutions = 0,
-    maxExecutionsInParallel = 1,
-    stopAfterExecute,
+    logSummary,
+    logMemoryHeapUsage,
     completedExecutionLogMerging,
     completedExecutionLogAbbreviation,
 
+    maxExecutionsInParallel,
+    defaultMsAllocatedPerExecution,
+    stopAfterExecute,
+    cooldownBetweenExecutions,
+    gcBetweenExecutions,
+
     coverage,
     coverageConfig,
     coverageIncludeMissing,
@@ -48,8 +53,6 @@ export const executeConcurrently = async (
 
     beforeExecutionCallback = () => {},
     afterExecutionCallback = () => {},
-
-    logSummary,
   },
 ) => {
   if (completedExecutionLogMerging && !process.stdout.isTTY) {
@@ -62,12 +65,15 @@ export const executeConcurrently = async (
   const executionSpinner = executionLogsEnabled && process.stdout.isTTY
 
   const startMs = Date.now()
-
   const report = {}
   const executionCount = executionSteps.length
 
   let transformReturnValue = (value) => value
 
+  if (gcBetweenExecutions) {
+    ensureGlobalGc()
+  }
+
   const coverageTempDirectoryUrl = resolveUrl(
     coverageTempDirectoryRelativeUrl,
     projectDirectoryUrl,
@@ -185,6 +191,9 @@ export const executeConcurrently = async (
             timedoutCount,
             erroredCount,
             completedCount,
+            ...(logMemoryHeapUsage
+              ? { memoryHeap: memoryUsage().heapUsed }
+              : {}),
           }),
         })
       }
@@ -249,6 +258,10 @@ export const executeConcurrently = async (
         completedCount++
       }
 
+      if (gcBetweenExecutions) {
+        global.gc()
+      }
+
       if (executionLogsEnabled) {
         let log = formatExecutionResult(afterExecutionInfo, {
           completedExecutionLogAbbreviation,
@@ -257,6 +270,7 @@ export const executeConcurrently = async (
           timedoutCount,
           erroredCount,
           completedCount,
+          ...(logMemoryHeapUsage ? { memoryHeap: memoryUsage().heapUsed } : {}),
         })
         log = `${log}
 

package/src/internal/executing/executePlan.js

@@ -24,13 +24,16 @@ export const executePlan = async (
     importResolutionMethod,
     importDefaultExtension,
 
+    logSummary,
+    logMemoryHeapUsage,
+    completedExecutionLogMerging,
+    completedExecutionLogAbbreviation,
+
     defaultMsAllocatedPerExecution,
     maxExecutionsInParallel,
+    gcBetweenExecutions,
     stopAfterExecute,
     cooldownBetweenExecutions,
-    completedExecutionLogMerging,
-    completedExecutionLogAbbreviation,
-    logSummary,
 
     coverage,
     coverageConfig,
@@ -169,13 +172,16 @@ export const executePlan = async (
 
       babelPluginMap: compileServer.babelPluginMap,
 
+      logSummary,
+      logMemoryHeapUsage,
+      completedExecutionLogMerging,
+      completedExecutionLogAbbreviation,
+
       defaultMsAllocatedPerExecution,
       maxExecutionsInParallel,
       stopAfterExecute,
+      gcBetweenExecutions,
       cooldownBetweenExecutions,
-      completedExecutionLogMerging,
-      completedExecutionLogAbbreviation,
-      logSummary,
 
       coverage,
       coverageConfig,

package/src/internal/executing/executionLogs.js

@@ -2,11 +2,18 @@ import { ANSI, UNICODE } from "@jsenv/log"
 
 import { msAsDuration } from "../logs/msAsDuration.js"
 import { EXECUTION_COLORS } from "./execution_colors.js"
-import { createSummaryDetails } from "./createSummaryLog.js"
+import { createIntermediateSummary } from "./createSummaryLog.js"
 
 export const formatExecuting = (
   { executionIndex },
-  { executionCount, abortedCount, timedoutCount, erroredCount, completedCount },
+  {
+    executionCount,
+    abortedCount,
+    timedoutCount,
+    erroredCount,
+    completedCount,
+    memoryHeap,
+  },
 ) => {
   const executionNumber = executionIndex + 1
   const description = ANSI.color(
@@ -16,12 +23,13 @@ export const formatExecuting = (
   const summary =
     executionIndex === 0
       ? ""
-      : `(${createSummaryDetails({
+      : `(${createIntermediateSummary({
           executionCount: executionIndex,
           abortedCount,
           timedoutCount,
           erroredCount,
           completedCount,
+          memoryHeap,
         })})`
 
   return formatExecution({
@@ -45,6 +53,7 @@ export const formatExecutionResult = (
     timedoutCount,
     erroredCount,
     completedCount,
+    memoryHeap,
   },
 ) => {
   const executionNumber = executionIndex + 1
@@ -57,12 +66,13 @@ export const formatExecutionResult = (
     allocatedMs,
   })
 
-  const summary = `(${createSummaryDetails({
+  const summary = `(${createIntermediateSummary({
     executionCount: executionNumber,
     abortedCount,
     timedoutCount,
     erroredCount,
     completedCount,
+    memoryHeap,
   })})`
 
   if (completedExecutionLogAbbreviation && status === "completed") {

package/src/internal/executing/gc.js

@@ -0,0 +1,9 @@
+import v8 from "node:v8"
+import { runInNewContext } from "node:vm"
+
+export const ensureGlobalGc = () => {
+  if (!global.gc) {
+    v8.setFlagsFromString("--expose_gc")
+    global.gc = runInNewContext("gc")
+  }
+}

package/src/internal/logs/byte.js

@@ -0,0 +1,10 @@
+import { createRequire } from "module"
+
+const require = createRequire(import.meta.url)
+
+// https://github.com/visionmedia/bytes.js/
+const bytes = require("bytes")
+
+export const formatByte = (metricValue) => {
+  return bytes(metricValue, { decimalPlaces: 2, unitSeparator: " " })
+}