@emarketeer/ts-microservice-commons 8.1.1 → 8.2.1

package/dist/lib/em-commons.js

@@ -677,6 +677,9 @@ if (script === 'cdk-lint') {
     result = runCommand('npx eslint -c node_modules/@emarketeer/ts-microservice-commons/dist/cdk/.eslintrc', scriptArgs);
 }
 if (script === 'jest') {
+    // --experimental-vm-modules is required so Jest can execute ES-module files
+    // in its VM — used by AWS SDK v3's dynamic credential-provider imports and
+    // by @mikro-orm/* (and other ESM-only packages) under EM_JEST_ESM_FRIENDLY=true.
     result = runCommand('npx cross-env NODE_OPTIONS="--max_old_space_size=4096 --experimental-vm-modules" jest -w 4 --ci --forceExit --config node_modules/@emarketeer/ts-microservice-commons/dist/lib/jest.config.js', scriptArgs);
 }
 if (!supportedCommands.includes(script)) {

package/dist/lib/jest-esm-warmup.mjs

@@ -0,0 +1,5 @@
+import { preloadMikroOrmModules } from '@eMarketeerSE/runtime-commons';
+
+// Runs at worker module-load phase (before beforeAll) when
+await preloadMikroOrmModules();
+//# sourceMappingURL=jest-esm-warmup.mjs.map

package/dist/lib/jest-esm-warmup.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest-esm-warmup.mjs","sources":["../../src/lib/jest-esm-warmup.ts"],"sourcesContent":["// Runs at worker module-load phase (before beforeAll) when\n// EM_JEST_ESM_FRIENDLY=true. Populates runtime-commons' internal\n// MikroORM / MySqlDriver closure variables so its lazy loader's\n// `if (!MikroORM)` short-circuits during test execution — the\n// dynamic import() never fires, so Jest's ESM teardown invariant\n// can't race it.\nimport { preloadMikroOrmModules } from '@eMarketeerSE/runtime-commons'\n\nawait preloadMikroOrmModules()\n"],"names":[],"mappings":";;AAAA;AAQA,MAAM,sBAAsB,EAAE"}

package/dist/lib/jest.config.js

@@ -5,6 +5,28 @@
 }(this, (function () { 'use strict';
 
   var esModules = ['@eMarketeerSE/runtime-commons'].join('|');
+  // Opt-in mode for services that depend on ESM-only packages (e.g. MikroORM).
+  // When EM_JEST_ESM_FRIENDLY=true:
+  //  - ts-jest compiles .ts as ESM (useESM), targeting es2022.
+  //  - extensionsToTreatAsEsm lets Jest load .ts through its ESM VM loader,
+  //    the same realm that handles ESM node_modules like @mikro-orm/*.
+  // Opting-in services must import { jest } from '@jest/globals' in test files
+  // that use jest.* APIs, since the `jest` global is CJS-only.
+  var rawEsmFriendly = process.env.EM_JEST_ESM_FRIENDLY;
+  var esmFriendly = (rawEsmFriendly === null || rawEsmFriendly === void 0 ? void 0 : rawEsmFriendly.trim().toLowerCase()) === 'true';
+  if (rawEsmFriendly !== undefined && !esmFriendly) {
+      // eslint-disable-next-line no-console
+      console.warn("[em-commons] EM_JEST_ESM_FRIENDLY=".concat(JSON.stringify(rawEsmFriendly), " ignored;")
+          + ' expected \'true\'. Falling back to default CJS Jest config.');
+  }
+  var tsJestTsConfig = {
+      target: esmFriendly ? 'es2022' : 'es6'
+  };
+  if (esmFriendly) {
+      // useESM needs an ES module output from TS; otherwise ts-jest still emits
+      // `exports.foo = ...` which explodes when Jest loads the file as ESM.
+      tsJestTsConfig.module = 'esnext';
+  }
   var config = {
       verbose: true,
       testEnvironment: 'node',
@@ -12,10 +34,9 @@
           '^.+\\.tsx?$': [
               'ts-jest',
               {
-                  tsconfig: {
-                      target: 'es6'
-                  },
-                  isolatedModules: true
+                  tsconfig: tsJestTsConfig,
+                  isolatedModules: true,
+                  useESM: esmFriendly
               }
           ]
       },
@@ -26,6 +47,15 @@
       moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
       transformIgnorePatterns: ["/node_modules/(?!".concat(esModules, ")")]
   };
+  if (esmFriendly) {
+      // Must match the set of TS extensions transformed above (^.+\.tsx?$), or Jest
+      // will load .tsx as CJS while ts-jest emits ESM for it and blow up at import.
+      config.extensionsToTreatAsEsm = ['.ts', '.tsx'];
+      // Preload runtime-commons' MikroORM modules during the worker's stable
+      // module-load phase so lazy loaders short-circuit at test time — avoids
+      // Jest's ESM teardown invariant racing dynamic imports in MikroORM.
+      config.setupFiles = [require.resolve('./jest-esm-warmup.mjs')];
+  }
   var shouldAddSetup = !process.argv.includes('unit');
   if (shouldAddSetup) {
       config.globalSetup = '<rootDir>/src/utils/func-test-setup.ts';

package/dist/types/lib/jest-esm-warmup.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emarketeer/ts-microservice-commons",
-  "version": "8.1.1",
+  "version": "8.2.1",
   "description": "",
   "keywords": [],
   "bin": {