@dr.pogodin/react-utils 1.47.0-alpha.1 → 1.47.0-alpha.11

package/build/types-code/shared/utils/config.d.ts

@@ -1,2 +1,4 @@
-declare const config: Record<string, unknown>;
-export default config;
+type ConfigT = Record<string, unknown>;
+export declare function getConfig(sync: true): ConfigT;
+export declare function getConfig(sync?: boolean): ConfigT | Promise<ConfigT>;
+export {};

package/build/types-code/shared/utils/index.d.ts

@@ -1,5 +1,5 @@
 import themedImpl, { COMPOSE, PRIORITY, type Theme, ThemeProvider } from '@dr.pogodin/react-themes';
-import config from './config';
+import { getConfig } from './config';
 import * as isomorphy from './isomorphy';
 import time from './time';
 import * as webpack from './webpack';
@@ -11,4 +11,4 @@ type ThemedT = typeof themedImpl & {
     PRIORITY: typeof PRIORITY;
 };
 declare const themed: ThemedT;
-export { type Theme, config, isomorphy, themed, ThemeProvider, time, webpack, };
+export { type Theme, getConfig, isomorphy, themed, ThemeProvider, time, webpack, };

package/build/types-code/shared/utils/splitComponent.d.ts

@@ -21,6 +21,11 @@ export declare function freeStyleSheets(chunkName: string, chunkGroups: ChunkGro
 type ComponentOrModule<PropsT> = ComponentType<PropsT> | {
     default: ComponentType<PropsT>;
 };
+type GenericComponentPropsT = {
+    children?: ReactNode;
+    ref?: RefObject<unknown>;
+    [propName: string]: unknown;
+};
 /**
  * Given an async component retrieval function `getComponent()` it creates
  * a special "code split" component, which uses <Suspense> to asynchronously
@@ -31,10 +36,7 @@ type ComponentOrModule<PropsT> = ComponentType<PropsT> | {
  * @param {React.Element} [options.placeholder]
  * @return {React.ElementType}
  */
-export default function splitComponent<ComponentPropsT extends {
-    children?: ReactNode;
-    ref?: RefObject<unknown>;
-}>({ chunkName, getComponent, placeholder, }: {
+export default function splitComponent<ComponentPropsT extends GenericComponentPropsT>({ chunkName, getComponent, placeholder, }: {
     chunkName: string;
     getComponent: () => Promise<ComponentOrModule<ComponentPropsT>>;
     placeholder?: ReactNode;

package/build/web/client/getInj.js

@@ -1,54 +1,65 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = getInj;
-var _forge = _interopRequireDefault(require("node-forge/lib/forge"));
-require("node-forge/lib/aes");
-var _buildInfo = require("../shared/utils/isomorphy/buildInfo");
+import "core-js/modules/es.array-buffer.detached.js";
+import "core-js/modules/es.array-buffer.transfer.js";
+import "core-js/modules/es.array-buffer.transfer-to-fixed-length.js";
+import "core-js/modules/es.typed-array.to-reversed.js";
+import "core-js/modules/es.typed-array.to-sorted.js";
+import "core-js/modules/es.typed-array.with.js";
+import "core-js/modules/web.dom-exception.stack.js";
 // Encapsulates retrieval of server-side data injection into HTML template.
 
 /* global document */
 
-// Note: this way, only required part of "node-forge": AES, and some utils,
-// is bundled into client-side code.
+import { getBuildInfo } from "../shared/utils/isomorphy/buildInfo";
+let inj;
+export default function getInj() {
+  inj ??= (async () => {
+    const metaElement = typeof document === 'undefined' ? null : document.querySelector('meta[itemprop="drpruinj"]');
+    if (metaElement) {
+      metaElement.remove();
 
-// eslint-disable-next-line import/no-unassigned-import
+      // NOTE: Since 2025 there is Uint8Array.fromBase64(), which should be
+      // preferred, but it is not supported by older environments yet.
+      const data = atob(metaElement.content);
 
-// Safeguard is needed here, because the server-side version of Docusaurus docs
-// is compiled (at least now) with settings suggesting it is a client-side
-// environment, but there is no document.
-let inj = {};
-const metaElement = typeof document === 'undefined' ? null : document.querySelector('meta[itemprop="drpruinj"]');
-if (metaElement) {
-  metaElement.remove();
-  let data = _forge.default.util.decode64(metaElement.content);
-  const {
-    key
-  } = (0, _buildInfo.getBuildInfo)();
-  const d = _forge.default.cipher.createDecipher('AES-CBC', key);
-  d.start({
-    iv: data.slice(0, key.length)
-  });
-  d.update(_forge.default.util.createBuffer(data.slice(key.length)));
-  d.finish();
-  data = _forge.default.util.decodeUtf8(d.output.data);
+      // TODO: Our current handling of this encryption / decryption follows
+      // a legacy approach, and can be enhanced by using Crypto features.
+      // Though, this is not strictly intended to be secure (it is more
+      // to obfurscate injected data, rather than really keeping them
+      // secure), thus it is fine like this for now.
+      const {
+        key
+      } = getBuildInfo();
+      const code = x => x.charCodeAt(0);
+      const dataBuffer = Uint8Array.from(data.slice(16), code);
+      const ivBuffer = Uint8Array.from(data.slice(0, 16), code);
+      const keyBuffer = Uint8Array.from(atob(key), code);
+      const cKey = await window.crypto.subtle.importKey('raw', keyBuffer, {
+        name: 'AES-CBC'
+      }, false, ['decrypt']);
+      const buffer = await window.crypto.subtle.decrypt({
+        iv: ivBuffer,
+        name: 'AES-CBC'
+      }, cKey, dataBuffer);
+      const decoder = new TextDecoder();
 
-  // TODO: Double-check, if there is a safer alternative to parse it?
-  // eslint-disable-next-line no-eval
-  inj = eval(`(${data})`);
-} else if (typeof window !== 'undefined' && window.REACT_UTILS_INJECTION) {
-  inj = window.REACT_UTILS_INJECTION;
-  delete window.REACT_UTILS_INJECTION;
-} else {
-  // Otherwise, a bunch of dependent stuff will easily fail in non-standard
-  // environments, where no client-side initialization is performed. Like tests,
-  // Docusaurus examples, etc.
-  inj = {};
-}
-function getInj() {
+      // eslint-disable-next-line no-eval
+      const res = eval(`(${decoder.decode(buffer)})`);
+
+      // NOTE: This is important, to be able to return the injection
+      // synchronously once it is initialized.
+      inj = res;
+      return res;
+    } else if (typeof window !== 'undefined' && window.REACT_UTILS_INJECTION) {
+      const res = window.REACT_UTILS_INJECTION;
+      delete window.REACT_UTILS_INJECTION;
+      return res;
+    }
+
+    // Otherwise, a bunch of dependent stuff will easily fail in non-standard
+    // environments, where no client-side initialization is performed. Like tests,
+    // Docusaurus examples, etc.
+    return {};
+  })();
   return inj;
 }
 //# sourceMappingURL=getInj.js.map

package/build/web/client/getInj.js.map

@@ -1 +1 @@
-{"version":3,"file":"getInj.js","names":["_forge","_interopRequireDefault","require","_buildInfo","inj","metaElement","document","querySelector","remove","data","forge","util","decode64","content","key","getBuildInfo","d","cipher","createDecipher","start","iv","slice","length","update","createBuffer","finish","decodeUtf8","output","eval","window","REACT_UTILS_INJECTION","getInj"],"sources":["../../../src/client/getInj.ts"],"sourcesContent":["// Encapsulates retrieval of server-side data injection into HTML template.\n\n/* global document */\n\n// Note: this way, only required part of \"node-forge\": AES, and some utils,\n// is bundled into client-side code.\nimport forge from 'node-forge/lib/forge';\n\n// eslint-disable-next-line import/no-unassigned-import\nimport 'node-forge/lib/aes';\n\nimport type { InjT } from 'utils/globalState';\n\nimport { getBuildInfo } from 'utils/isomorphy/buildInfo';\n\n// Safeguard is needed here, because the server-side version of Docusaurus docs\n// is compiled (at least now) with settings suggesting it is a client-side\n// environment, but there is no document.\nlet inj: InjT = {};\n\nconst metaElement: HTMLMetaElement | null = typeof document === 'undefined'\n  ? null : document.querySelector('meta[itemprop=\"drpruinj\"]');\n\nif (metaElement) {\n  metaElement.remove();\n  let data = forge.util.decode64(metaElement.content);\n\n  const { key } = getBuildInfo();\n  const d = forge.cipher.createDecipher('AES-CBC', key);\n  d.start({ iv: data.slice(0, key.length) });\n  d.update(forge.util.createBuffer(data.slice(key.length)));\n  d.finish();\n\n  data = forge.util.decodeUtf8(d.output.data);\n\n  // TODO: Double-check, if there is a safer alternative to parse it?\n  // eslint-disable-next-line no-eval\n  inj = eval(`(${data})`) as InjT;\n} else if (typeof window !== 'undefined' && window.REACT_UTILS_INJECTION) {\n  inj = window.REACT_UTILS_INJECTION;\n  delete window.REACT_UTILS_INJECTION;\n} else {\n  // Otherwise, a bunch of dependent stuff will easily fail in non-standard\n  // environments, where no client-side initialization is performed. Like tests,\n  // Docusaurus examples, etc.\n  inj = {};\n}\n\nexport default function getInj(): InjT {\n  return inj;\n}\n"],"mappings":";;;;;;;AAMA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AAGAA,OAAA;AAIA,IAAAC,UAAA,GAAAD,OAAA;AAbA;;AAEA;;AAEA;AACA;;AAGA;;AAOA;AACA;AACA;AACA,IAAIE,GAAS,GAAG,CAAC,CAAC;AAElB,MAAMC,WAAmC,GAAG,OAAOC,QAAQ,KAAK,WAAW,GACvE,IAAI,GAAGA,QAAQ,CAACC,aAAa,CAAC,2BAA2B,CAAC;AAE9D,IAAIF,WAAW,EAAE;EACfA,WAAW,CAACG,MAAM,CAAC,CAAC;EACpB,IAAIC,IAAI,GAAGC,cAAK,CAACC,IAAI,CAACC,QAAQ,CAACP,WAAW,CAACQ,OAAO,CAAC;EAEnD,MAAM;IAAEC;EAAI,CAAC,GAAG,IAAAC,uBAAY,EAAC,CAAC;EAC9B,MAAMC,CAAC,GAAGN,cAAK,CAACO,MAAM,CAACC,cAAc,CAAC,SAAS,EAAEJ,GAAG,CAAC;EACrDE,CAAC,CAACG,KAAK,CAAC;IAAEC,EAAE,EAAEX,IAAI,CAACY,KAAK,CAAC,CAAC,EAAEP,GAAG,CAACQ,MAAM;EAAE,CAAC,CAAC;EAC1CN,CAAC,CAACO,MAAM,CAACb,cAAK,CAACC,IAAI,CAACa,YAAY,CAACf,IAAI,CAACY,KAAK,CAACP,GAAG,CAACQ,MAAM,CAAC,CAAC,CAAC;EACzDN,CAAC,CAACS,MAAM,CAAC,CAAC;EAEVhB,IAAI,GAAGC,cAAK,CAACC,IAAI,CAACe,UAAU,CAACV,CAAC,CAACW,MAAM,CAAClB,IAAI,CAAC;;EAE3C;EACA;EACAL,GAAG,GAAGwB,IAAI,CAAC,IAAInB,IAAI,GAAG,CAAS;AACjC,CAAC,MAAM,IAAI,OAAOoB,MAAM,KAAK,WAAW,IAAIA,MAAM,CAACC,qBAAqB,EAAE;EACxE1B,GAAG,GAAGyB,MAAM,CAACC,qBAAqB;EAClC,OAAOD,MAAM,CAACC,qBAAqB;AACrC,CAAC,MAAM;EACL;EACA;EACA;EACA1B,GAAG,GAAG,CAAC,CAAC;AACV;AAEe,SAAS2B,MAAMA,CAAA,EAAS;EACrC,OAAO3B,GAAG;AACZ","ignoreList":[]}
+{"version":3,"file":"getInj.js","names":["getBuildInfo","inj","getInj","metaElement","document","querySelector","remove","data","atob","content","key","code","x","charCodeAt","dataBuffer","Uint8Array","from","slice","ivBuffer","keyBuffer","cKey","window","crypto","subtle","importKey","name","buffer","decrypt","iv","decoder","TextDecoder","res","eval","decode","REACT_UTILS_INJECTION"],"sources":["../../../src/client/getInj.ts"],"sourcesContent":["// Encapsulates retrieval of server-side data injection into HTML template.\n\n/* global document */\n\nimport type { InjT } from 'utils/globalState';\n\nimport { getBuildInfo } from 'utils/isomorphy/buildInfo';\n\nlet inj: InjT | Promise<InjT> | undefined;\n\nexport default function getInj(): InjT | Promise<InjT> {\n  inj ??= (async () => {\n    const metaElement: HTMLMetaElement | null = typeof document === 'undefined'\n      ? null : document.querySelector('meta[itemprop=\"drpruinj\"]');\n\n    if (metaElement) {\n      metaElement.remove();\n\n      // NOTE: Since 2025 there is Uint8Array.fromBase64(), which should be\n      // preferred, but it is not supported by older environments yet.\n      const data = atob(metaElement.content);\n\n      // TODO: Our current handling of this encryption / decryption follows\n      // a legacy approach, and can be enhanced by using Crypto features.\n      // Though, this is not strictly intended to be secure (it is more\n      // to obfurscate injected data, rather than really keeping them\n      // secure), thus it is fine like this for now.\n      const { key } = getBuildInfo();\n\n      const code = (x: string) => x.charCodeAt(0);\n      const dataBuffer = Uint8Array.from(data.slice(16), code);\n      const ivBuffer = Uint8Array.from(data.slice(0, 16), code);\n      const keyBuffer = Uint8Array.from(atob(key), code);\n\n      const cKey = await window.crypto.subtle.importKey(\n        'raw',\n        keyBuffer,\n        { name: 'AES-CBC' },\n        false,\n        ['decrypt'],\n      );\n\n      const buffer = await window.crypto.subtle.decrypt({\n        iv: ivBuffer,\n        name: 'AES-CBC',\n      }, cKey, dataBuffer);\n\n      const decoder = new TextDecoder();\n\n      // eslint-disable-next-line no-eval\n      const res = eval(`(${decoder.decode(buffer)})`) as InjT;\n\n      // NOTE: This is important, to be able to return the injection\n      // synchronously once it is initialized.\n      inj = res;\n\n      return res;\n    } else if (typeof window !== 'undefined' && window.REACT_UTILS_INJECTION) {\n      const res = window.REACT_UTILS_INJECTION;\n      delete window.REACT_UTILS_INJECTION;\n      return res;\n    }\n\n    // Otherwise, a bunch of dependent stuff will easily fail in non-standard\n    // environments, where no client-side initialization is performed. Like tests,\n    // Docusaurus examples, etc.\n    return {};\n  })();\n\n  return inj;\n}\n"],"mappings":";;;;;;;AAAA;;AAEA;;AAIA,SAASA,YAAY;AAErB,IAAIC,GAAqC;AAEzC,eAAe,SAASC,MAAMA,CAAA,EAAyB;EACrDD,GAAG,KAAK,CAAC,YAAY;IACnB,MAAME,WAAmC,GAAG,OAAOC,QAAQ,KAAK,WAAW,GACvE,IAAI,GAAGA,QAAQ,CAACC,aAAa,CAAC,2BAA2B,CAAC;IAE9D,IAAIF,WAAW,EAAE;MACfA,WAAW,CAACG,MAAM,CAAC,CAAC;;MAEpB;MACA;MACA,MAAMC,IAAI,GAAGC,IAAI,CAACL,WAAW,CAACM,OAAO,CAAC;;MAEtC;MACA;MACA;MACA;MACA;MACA,MAAM;QAAEC;MAAI,CAAC,GAAGV,YAAY,CAAC,CAAC;MAE9B,MAAMW,IAAI,GAAIC,CAAS,IAAKA,CAAC,CAACC,UAAU,CAAC,CAAC,CAAC;MAC3C,MAAMC,UAAU,GAAGC,UAAU,CAACC,IAAI,CAACT,IAAI,CAACU,KAAK,CAAC,EAAE,CAAC,EAAEN,IAAI,CAAC;MACxD,MAAMO,QAAQ,GAAGH,UAAU,CAACC,IAAI,CAACT,IAAI,CAACU,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAEN,IAAI,CAAC;MACzD,MAAMQ,SAAS,GAAGJ,UAAU,CAACC,IAAI,CAACR,IAAI,CAACE,GAAG,CAAC,EAAEC,IAAI,CAAC;MAElD,MAAMS,IAAI,GAAG,MAAMC,MAAM,CAACC,MAAM,CAACC,MAAM,CAACC,SAAS,CAC/C,KAAK,EACLL,SAAS,EACT;QAAEM,IAAI,EAAE;MAAU,CAAC,EACnB,KAAK,EACL,CAAC,SAAS,CACZ,CAAC;MAED,MAAMC,MAAM,GAAG,MAAML,MAAM,CAACC,MAAM,CAACC,MAAM,CAACI,OAAO,CAAC;QAChDC,EAAE,EAAEV,QAAQ;QACZO,IAAI,EAAE;MACR,CAAC,EAAEL,IAAI,EAAEN,UAAU,CAAC;MAEpB,MAAMe,OAAO,GAAG,IAAIC,WAAW,CAAC,CAAC;;MAEjC;MACA,MAAMC,GAAG,GAAGC,IAAI,CAAC,IAAIH,OAAO,CAACI,MAAM,CAACP,MAAM,CAAC,GAAG,CAAS;;MAEvD;MACA;MACAzB,GAAG,GAAG8B,GAAG;MAET,OAAOA,GAAG;IACZ,CAAC,MAAM,IAAI,OAAOV,MAAM,KAAK,WAAW,IAAIA,MAAM,CAACa,qBAAqB,EAAE;MACxE,MAAMH,GAAG,GAAGV,MAAM,CAACa,qBAAqB;MACxC,OAAOb,MAAM,CAACa,qBAAqB;MACnC,OAAOH,GAAG;IACZ;;IAEA;IACA;IACA;IACA,OAAO,CAAC,CAAC;EACX,CAAC,EAAE,CAAC;EAEJ,OAAO9B,GAAG;AACZ","ignoreList":[]}

package/build/web/client/index.js

@@ -1,38 +1,32 @@
-"use strict";
-
-var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.default = Launch;
-var _client = require("react-dom/client");
-var _reactHelmet = require("@dr.pogodin/react-helmet");
-var _reactRouter = require("react-router");
-var _reactGlobalState = require("@dr.pogodin/react-global-state");
-var _getInj = _interopRequireDefault(require("./getInj"));
-var _jsxRuntime = require("react/jsx-runtime");
 // Initialization of client-side code.
 /* global document */
 
+import { createRoot, hydrateRoot } from 'react-dom/client';
+import { HelmetProvider } from '@dr.pogodin/react-helmet';
+import { BrowserRouter } from 'react-router';
+import { GlobalStateProvider } from '@dr.pogodin/react-global-state';
+import getInj from "./getInj";
+import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Prepares and launches the app at client side.
  * @param Application Root application component
  * @param [options={}] Optional. Additional settings.
  */
-function Launch(Application, options = {}) {
+export async function launchClient(Application, options = {}) {
+  const inj = await getInj();
   const container = document.getElementById('react-view');
   if (!container) throw Error('Failed to find container for React app');
-  const scene = /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactGlobalState.GlobalStateProvider, {
-    initialState: (0, _getInj.default)().ISTATE ?? options.initialState,
-    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactRouter.BrowserRouter, {
-      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactHelmet.HelmetProvider, {
-        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(Application, {})
+  const scene = /*#__PURE__*/_jsx(GlobalStateProvider, {
+    initialState: inj.ISTATE ?? options.initialState,
+    children: /*#__PURE__*/_jsx(BrowserRouter, {
+      children: /*#__PURE__*/_jsx(HelmetProvider, {
+        children: /*#__PURE__*/_jsx(Application, {})
       })
     })
   });
   if (options.dontHydrate) {
-    const root = (0, _client.createRoot)(container);
+    const root = createRoot(container);
     root.render(scene);
-  } else (0, _client.hydrateRoot)(container, scene);
+  } else hydrateRoot(container, scene);
 }
 //# sourceMappingURL=index.js.map

package/build/web/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["_client","require","_reactHelmet","_reactRouter","_reactGlobalState","_getInj","_interopRequireDefault","_jsxRuntime","Launch","Application","options","container","document","getElementById","Error","scene","jsx","GlobalStateProvider","initialState","getInj","ISTATE","children","BrowserRouter","HelmetProvider","dontHydrate","root","createRoot","render","hydrateRoot"],"sources":["../../../src/client/index.tsx"],"sourcesContent":["// Initialization of client-side code.\n/* global document */\n\nimport type { ComponentType } from 'react';\nimport { createRoot, hydrateRoot } from 'react-dom/client';\nimport { HelmetProvider } from '@dr.pogodin/react-helmet';\nimport { BrowserRouter } from 'react-router';\n\nimport { GlobalStateProvider } from '@dr.pogodin/react-global-state';\n\nimport getInj from './getInj';\n\ntype OptionsT = {\n  dontHydrate?: boolean;\n  initialState?: unknown;\n};\n\n/**\n * Prepares and launches the app at client side.\n * @param Application Root application component\n * @param [options={}] Optional. Additional settings.\n */\nexport default function Launch(\n  Application: ComponentType,\n  options: OptionsT = {},\n): void {\n  const container = document.getElementById('react-view');\n  if (!container) throw Error('Failed to find container for React app');\n  const scene = (\n    <GlobalStateProvider initialState={getInj().ISTATE ?? options.initialState}>\n      <BrowserRouter>\n        <HelmetProvider>\n          <Application />\n        </HelmetProvider>\n      </BrowserRouter>\n    </GlobalStateProvider>\n  );\n\n  if (options.dontHydrate) {\n    const root = createRoot(container);\n    root.render(scene);\n  } else hydrateRoot(container, scene);\n}\n"],"mappings":";;;;;;;AAIA,IAAAA,OAAA,GAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AACA,IAAAE,YAAA,GAAAF,OAAA;AAEA,IAAAG,iBAAA,GAAAH,OAAA;AAEA,IAAAI,OAAA,GAAAC,sBAAA,CAAAL,OAAA;AAA8B,IAAAM,WAAA,GAAAN,OAAA;AAV9B;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACe,SAASO,MAAMA,CAC5BC,WAA0B,EAC1BC,OAAiB,GAAG,CAAC,CAAC,EAChB;EACN,MAAMC,SAAS,GAAGC,QAAQ,CAACC,cAAc,CAAC,YAAY,CAAC;EACvD,IAAI,CAACF,SAAS,EAAE,MAAMG,KAAK,CAAC,wCAAwC,CAAC;EACrE,MAAMC,KAAK,gBACT,IAAAR,WAAA,CAAAS,GAAA,EAACZ,iBAAA,CAAAa,mBAAmB;IAACC,YAAY,EAAE,IAAAC,eAAM,EAAC,CAAC,CAACC,MAAM,IAAIV,OAAO,CAACQ,YAAa;IAAAG,QAAA,eACzE,IAAAd,WAAA,CAAAS,GAAA,EAACb,YAAA,CAAAmB,aAAa;MAAAD,QAAA,eACZ,IAAAd,WAAA,CAAAS,GAAA,EAACd,YAAA,CAAAqB,cAAc;QAAAF,QAAA,eACb,IAAAd,WAAA,CAAAS,GAAA,EAACP,WAAW,IAAE;MAAC,CACD;IAAC,CACJ;EAAC,CACG,CACtB;EAED,IAAIC,OAAO,CAACc,WAAW,EAAE;IACvB,MAAMC,IAAI,GAAG,IAAAC,kBAAU,EAACf,SAAS,CAAC;IAClCc,IAAI,CAACE,MAAM,CAACZ,KAAK,CAAC;EACpB,CAAC,MAAM,IAAAa,mBAAW,EAACjB,SAAS,EAAEI,KAAK,CAAC;AACtC","ignoreList":[]}
+{"version":3,"file":"index.js","names":["createRoot","hydrateRoot","HelmetProvider","BrowserRouter","GlobalStateProvider","getInj","jsx","_jsx","launchClient","Application","options","inj","container","document","getElementById","Error","scene","initialState","ISTATE","children","dontHydrate","root","render"],"sources":["../../../src/client/index.tsx"],"sourcesContent":["// Initialization of client-side code.\n/* global document */\n\nimport type { ComponentType } from 'react';\nimport { createRoot, hydrateRoot } from 'react-dom/client';\nimport { HelmetProvider } from '@dr.pogodin/react-helmet';\nimport { BrowserRouter } from 'react-router';\n\nimport { GlobalStateProvider } from '@dr.pogodin/react-global-state';\n\nimport getInj from './getInj';\n\ntype OptionsT = {\n  dontHydrate?: boolean;\n  initialState?: unknown;\n};\n\n/**\n * Prepares and launches the app at client side.\n * @param Application Root application component\n * @param [options={}] Optional. Additional settings.\n */\nexport async function launchClient(\n  Application: ComponentType,\n  options: OptionsT = {},\n): Promise<void> {\n  const inj = await getInj();\n\n  const container = document.getElementById('react-view');\n  if (!container) throw Error('Failed to find container for React app');\n  const scene = (\n    <GlobalStateProvider initialState={inj.ISTATE ?? options.initialState}>\n      <BrowserRouter>\n        <HelmetProvider>\n          <Application />\n        </HelmetProvider>\n      </BrowserRouter>\n    </GlobalStateProvider>\n  );\n\n  if (options.dontHydrate) {\n    const root = createRoot(container);\n    root.render(scene);\n  } else hydrateRoot(container, scene);\n}\n"],"mappings":"AAAA;AACA;;AAGA,SAASA,UAAU,EAAEC,WAAW,QAAQ,kBAAkB;AAC1D,SAASC,cAAc,QAAQ,0BAA0B;AACzD,SAASC,aAAa,QAAQ,cAAc;AAE5C,SAASC,mBAAmB,QAAQ,gCAAgC;AAEpE,OAAOC,MAAM;AAAiB,SAAAC,GAAA,IAAAC,IAAA;AAO9B;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeC,YAAYA,CAChCC,WAA0B,EAC1BC,OAAiB,GAAG,CAAC,CAAC,EACP;EACf,MAAMC,GAAG,GAAG,MAAMN,MAAM,CAAC,CAAC;EAE1B,MAAMO,SAAS,GAAGC,QAAQ,CAACC,cAAc,CAAC,YAAY,CAAC;EACvD,IAAI,CAACF,SAAS,EAAE,MAAMG,KAAK,CAAC,wCAAwC,CAAC;EACrE,MAAMC,KAAK,gBACTT,IAAA,CAACH,mBAAmB;IAACa,YAAY,EAAEN,GAAG,CAACO,MAAM,IAAIR,OAAO,CAACO,YAAa;IAAAE,QAAA,eACpEZ,IAAA,CAACJ,aAAa;MAAAgB,QAAA,eACZZ,IAAA,CAACL,cAAc;QAAAiB,QAAA,eACbZ,IAAA,CAACE,WAAW,IAAE;MAAC,CACD;IAAC,CACJ;EAAC,CACG,CACtB;EAED,IAAIC,OAAO,CAACU,WAAW,EAAE;IACvB,MAAMC,IAAI,GAAGrB,UAAU,CAACY,SAAS,CAAC;IAClCS,IAAI,CAACC,MAAM,CAACN,KAAK,CAAC;EACpB,CAAC,MAAMf,WAAW,CAACW,SAAS,EAAEI,KAAK,CAAC;AACtC","ignoreList":[]}

package/build/web/client/init.js

@@ -1,13 +1,11 @@
-"use strict";
-
-var _buildInfo = require("../shared/utils/isomorphy/buildInfo");
 /**
  * Initialization of client-side environment.
  */
 
 /* global window */
 
-const buildInfo = (0, _buildInfo.getBuildInfo)();
+import { getBuildInfo } from "../shared/utils/isomorphy/buildInfo";
+const buildInfo = getBuildInfo();
 
 // TODO: Should be moved into buildInfo module?
 

package/build/web/client/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","names":["_buildInfo","require","buildInfo","getBuildInfo","process","env","NODE_ENV","console","warn","window","__DEV_BUILD_INFO__","BUILD_INFO","useServiceWorker","navigator","addEventListener","reg","serviceWorker","register","log","err"],"sources":["../../../src/client/init.ts"],"sourcesContent":["/**\n * Initialization of client-side environment.\n */\n\n/* global window */\n\nimport { type BuildInfoT, getBuildInfo } from 'utils/isomorphy/buildInfo';\n\nconst buildInfo = getBuildInfo();\n\n// TODO: Should be moved into buildInfo module?\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions\n  interface Window {\n    __DEV_BUILD_INFO__: BuildInfoT | undefined;\n  }\n}\n\ndeclare const BUILD_INFO: BuildInfoT | undefined;\n\nif (process.env.NODE_ENV !== 'production') {\n  // eslint-disable-next-line no-console\n  console.warn('Dev mode: \"BUILD_INFO\" attached to the global \"window\"');\n\n  // eslint-disable-next-line no-underscore-dangle\n  window.__DEV_BUILD_INFO__ = BUILD_INFO;\n}\n\n/* TODO: A proper logger should be moved to `@dr.pogodin/react-utils`. */\nconst { useServiceWorker } = buildInfo;\nif (useServiceWorker) {\n  const { navigator } = window;\n  if ('serviceWorker' in navigator) {\n    window.addEventListener('load', () => {\n      void (async () => {\n        try {\n          // Note: no matter the \"publicPath\", we want to serve the service worker\n          // from the web app root, to allow it control any and all pages of the\n          // web app (otherwise, it will be restricted to the scope of its path).\n          // The server takes it into account.\n          const reg = await navigator\n            .serviceWorker.register('/__service-worker.js');\n          // eslint-disable-next-line no-console\n          console.log('SW registered:', reg);\n        } catch (err) {\n          // eslint-disable-next-line no-console\n          console.log('SW registration failed:', err);\n        }\n      })();\n    });\n  }\n}\n"],"mappings":";;AAMA,IAAAA,UAAA,GAAAC,OAAA;AANA;AACA;AACA;;AAEA;;AAIA,MAAMC,SAAS,GAAG,IAAAC,uBAAY,EAAC,CAAC;;AAEhC;;AAUA,IAAIC,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;EACzC;EACAC,OAAO,CAACC,IAAI,CAAC,wDAAwD,CAAC;;EAEtE;EACAC,MAAM,CAACC,kBAAkB,GAAGC,UAAU;AACxC;;AAEA;AACA,MAAM;EAAEC;AAAiB,CAAC,GAAGV,SAAS;AACtC,IAAIU,gBAAgB,EAAE;EACpB,MAAM;IAAEC;EAAU,CAAC,GAAGJ,MAAM;EAC5B,IAAI,eAAe,IAAII,SAAS,EAAE;IAChCJ,MAAM,CAACK,gBAAgB,CAAC,MAAM,EAAE,MAAM;MACpC,KAAK,CAAC,YAAY;QAChB,IAAI;UACF;UACA;UACA;UACA;UACA,MAAMC,GAAG,GAAG,MAAMF,SAAS,CACxBG,aAAa,CAACC,QAAQ,CAAC,sBAAsB,CAAC;UACjD;UACAV,OAAO,CAACW,GAAG,CAAC,gBAAgB,EAAEH,GAAG,CAAC;QACpC,CAAC,CAAC,OAAOI,GAAG,EAAE;UACZ;UACAZ,OAAO,CAACW,GAAG,CAAC,yBAAyB,EAAEC,GAAG,CAAC;QAC7C;MACF,CAAC,EAAE,CAAC;IACN,CAAC,CAAC;EACJ;AACF","ignoreList":[]}
+{"version":3,"file":"init.js","names":["getBuildInfo","buildInfo","process","env","NODE_ENV","console","warn","window","__DEV_BUILD_INFO__","BUILD_INFO","useServiceWorker","navigator","addEventListener","reg","serviceWorker","register","log","err"],"sources":["../../../src/client/init.ts"],"sourcesContent":["/**\n * Initialization of client-side environment.\n */\n\n/* global window */\n\nimport { type BuildInfoT, getBuildInfo } from 'utils/isomorphy/buildInfo';\n\nconst buildInfo = getBuildInfo();\n\n// TODO: Should be moved into buildInfo module?\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions\n  interface Window {\n    __DEV_BUILD_INFO__: BuildInfoT | undefined;\n  }\n}\n\ndeclare const BUILD_INFO: BuildInfoT | undefined;\n\nif (process.env.NODE_ENV !== 'production') {\n  // eslint-disable-next-line no-console\n  console.warn('Dev mode: \"BUILD_INFO\" attached to the global \"window\"');\n\n  // eslint-disable-next-line no-underscore-dangle\n  window.__DEV_BUILD_INFO__ = BUILD_INFO;\n}\n\n/* TODO: A proper logger should be moved to `@dr.pogodin/react-utils`. */\nconst { useServiceWorker } = buildInfo;\nif (useServiceWorker) {\n  const { navigator } = window;\n  if ('serviceWorker' in navigator) {\n    window.addEventListener('load', () => {\n      void (async () => {\n        try {\n          // Note: no matter the \"publicPath\", we want to serve the service worker\n          // from the web app root, to allow it control any and all pages of the\n          // web app (otherwise, it will be restricted to the scope of its path).\n          // The server takes it into account.\n          const reg = await navigator\n            .serviceWorker.register('/__service-worker.js');\n          // eslint-disable-next-line no-console\n          console.log('SW registered:', reg);\n        } catch (err) {\n          // eslint-disable-next-line no-console\n          console.log('SW registration failed:', err);\n        }\n      })();\n    });\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;;AAEA;;AAEA,SAA0BA,YAAY;AAEtC,MAAMC,SAAS,GAAGD,YAAY,CAAC,CAAC;;AAEhC;;AAUA,IAAIE,OAAO,CAACC,GAAG,CAACC,QAAQ,KAAK,YAAY,EAAE;EACzC;EACAC,OAAO,CAACC,IAAI,CAAC,wDAAwD,CAAC;;EAEtE;EACAC,MAAM,CAACC,kBAAkB,GAAGC,UAAU;AACxC;;AAEA;AACA,MAAM;EAAEC;AAAiB,CAAC,GAAGT,SAAS;AACtC,IAAIS,gBAAgB,EAAE;EACpB,MAAM;IAAEC;EAAU,CAAC,GAAGJ,MAAM;EAC5B,IAAI,eAAe,IAAII,SAAS,EAAE;IAChCJ,MAAM,CAACK,gBAAgB,CAAC,MAAM,EAAE,MAAM;MACpC,KAAK,CAAC,YAAY;QAChB,IAAI;UACF;UACA;UACA;UACA;UACA,MAAMC,GAAG,GAAG,MAAMF,SAAS,CACxBG,aAAa,CAACC,QAAQ,CAAC,sBAAsB,CAAC;UACjD;UACAV,OAAO,CAACW,GAAG,CAAC,gBAAgB,EAAEH,GAAG,CAAC;QACpC,CAAC,CAAC,OAAOI,GAAG,EAAE;UACZ;UACAZ,OAAO,CAACW,GAAG,CAAC,yBAAyB,EAAEC,GAAG,CAAC;QAC7C;MACF,CAAC,EAAE,CAAC;IACN,CAAC,CAAC;EACJ;AACF","ignoreList":[]}

package/build/web/index.js

@@ -1,5 +1,3 @@
-import "./styles/global.scss";
-import { webpack } from "./shared/utils";
 // It is a safeguard against multiple instances / versions of the library
 // being loaded into environment by mistake (e.g. because of different
 // packages pinning down different exact versions of the lib, thus preventing
@@ -7,19 +5,7 @@ import { webpack } from "./shared/utils";
 if (global.REACT_UTILS_LIBRARY_LOADED) {
   throw Error('React utils library is already loaded');
 } else global.REACT_UTILS_LIBRARY_LOADED = true;
-
-// TODO: This is a rapid workaround to get rid of __dirname. I guess, later
-// we'll re-implement requireWeak() to accept import.meta.url directly, and
-// this workaround won't be needed.
-let dirname = import.meta.url;
-dirname = dirname.slice(5, dirname.lastIndexOf('/'));
-const server = webpack.requireWeak('./server', dirname);
-const client = server ? undefined
-
-// eslint-disable-next-line @typescript-eslint/no-require-imports
-: require("./client").default;
 export { getGlobalState, GlobalStateProvider, newAsyncDataEnvelope, useAsyncCollection, useAsyncData, useGlobalState, withGlobalStateType } from '@dr.pogodin/react-global-state';
 export * from "./shared/components";
-export { assertEmptyObject, config, Barrier, Cached, Emitter, isomorphy, getSsrContext, Semaphore, splitComponent, themed, ThemeProvider, time, webpack, withRetries } from "./shared/utils";
-export { client, server };
+export { assertEmptyObject, Barrier, Cached, Emitter, getConfig, isomorphy, getSsrContext, Semaphore, splitComponent, themed, ThemeProvider, time, webpack, withRetries } from "./shared/utils";
 //# sourceMappingURL=index.js.map

package/build/web/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["webpack","global","REACT_UTILS_LIBRARY_LOADED","Error","dirname","import","meta","url","slice","lastIndexOf","server","requireWeak","client","undefined","require","default","getGlobalState","GlobalStateProvider","newAsyncDataEnvelope","useAsyncCollection","useAsyncData","useGlobalState","withGlobalStateType","assertEmptyObject","config","Barrier","Cached","Emitter","isomorphy","getSsrContext","Semaphore","splitComponent","themed","ThemeProvider","time","withRetries"],"sources":["../../src/index.ts"],"sourcesContent":["import 'styles/global.scss';\n\nimport { webpack } from 'utils';\n\nimport type * as ClientM from './client';\nimport type * as ServerFactoryM from './server';\n\n// It is a safeguard against multiple instances / versions of the library\n// being loaded into environment by mistake (e.g. because of different\n// packages pinning down different exact versions of the lib, thus preventing\n// a proper dedupe and using a single common library version).\nif (global.REACT_UTILS_LIBRARY_LOADED) {\n  throw Error('React utils library is already loaded');\n} else global.REACT_UTILS_LIBRARY_LOADED = true;\n\n// TODO: This is a rapid workaround to get rid of __dirname. I guess, later\n// we'll re-implement requireWeak() to accept import.meta.url directly, and\n// this workaround won't be needed.\nlet dirname = import.meta.url;\ndirname = dirname.slice(5, dirname.lastIndexOf('/'));\n\nconst server = webpack.requireWeak<typeof ServerFactoryM>('./server', dirname);\n\nconst client = server\n  ? undefined\n\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  : (require('./client') as typeof ClientM).default;\n\nexport {\n  type AsyncCollectionT,\n  type AsyncCollectionLoaderT,\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type ForceT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  type UseGlobalStateResT,\n  type ValueOrInitializerT,\n  getGlobalState,\n  GlobalStateProvider,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n  withGlobalStateType,\n} from '@dr.pogodin/react-global-state';\n\nexport * from 'components';\n\nexport {\n  type BeforeRenderResT,\n  type BeforeRenderT,\n  type ConfigT,\n  type ServerSsrContext,\n  type ServerT,\n} from './server';\n\nexport {\n  assertEmptyObject,\n  config,\n  Barrier,\n  Cached,\n  Emitter,\n  isomorphy,\n  getSsrContext,\n  type Listener,\n  type ObjectKey,\n  Semaphore,\n  splitComponent,\n  type Theme,\n  themed,\n  ThemeProvider,\n  time,\n  webpack,\n  withRetries,\n} from 'utils';\n\nexport { client, server };\n"],"mappings":"AAAA;AAEA,SAASA,OAAO;AAKhB;AACA;AACA;AACA;AACA,IAAIC,MAAM,CAACC,0BAA0B,EAAE;EACrC,MAAMC,KAAK,CAAC,uCAAuC,CAAC;AACtD,CAAC,MAAMF,MAAM,CAACC,0BAA0B,GAAG,IAAI;;AAE/C;AACA;AACA;AACA,IAAIE,OAAO,GAAGC,MAAM,CAACC,IAAI,CAACC,GAAG;AAC7BH,OAAO,GAAGA,OAAO,CAACI,KAAK,CAAC,CAAC,EAAEJ,OAAO,CAACK,WAAW,CAAC,GAAG,CAAC,CAAC;AAEpD,MAAMC,MAAM,GAAGV,OAAO,CAACW,WAAW,CAAwB,UAAU,EAAEP,OAAO,CAAC;AAE9E,MAAMQ,MAAM,GAAGF,MAAM,GACjBG;;AAEF;AAAA,EACGC,OAAO,WAAW,CAAC,CAAoBC,OAAO;AAEnD,SAUEC,cAAc,EACdC,mBAAmB,EACnBC,oBAAoB,EACpBC,kBAAkB,EAClBC,YAAY,EACZC,cAAc,EACdC,mBAAmB,QACd,gCAAgC;AAEvC;AAUA,SACEC,iBAAiB,EACjBC,MAAM,EACNC,OAAO,EACPC,MAAM,EACNC,OAAO,EACPC,SAAS,EACTC,aAAa,EAGbC,SAAS,EACTC,cAAc,EAEdC,MAAM,EACNC,aAAa,EACbC,IAAI,EACJlC,OAAO,EACPmC,WAAW;AAGb,SAASvB,MAAM,EAAEF,MAAM","ignoreList":[]}
+{"version":3,"file":"index.js","names":["global","REACT_UTILS_LIBRARY_LOADED","Error","getGlobalState","GlobalStateProvider","newAsyncDataEnvelope","useAsyncCollection","useAsyncData","useGlobalState","withGlobalStateType","assertEmptyObject","Barrier","Cached","Emitter","getConfig","isomorphy","getSsrContext","Semaphore","splitComponent","themed","ThemeProvider","time","webpack","withRetries"],"sources":["../../src/index.ts"],"sourcesContent":["// It is a safeguard against multiple instances / versions of the library\n// being loaded into environment by mistake (e.g. because of different\n// packages pinning down different exact versions of the lib, thus preventing\n// a proper dedupe and using a single common library version).\nif (global.REACT_UTILS_LIBRARY_LOADED) {\n  throw Error('React utils library is already loaded');\n} else global.REACT_UTILS_LIBRARY_LOADED = true;\n\nexport {\n  type AsyncCollectionT,\n  type AsyncCollectionLoaderT,\n  type AsyncDataEnvelopeT,\n  type AsyncDataLoaderT,\n  type ForceT,\n  type UseAsyncDataOptionsT,\n  type UseAsyncDataResT,\n  type UseGlobalStateResT,\n  type ValueOrInitializerT,\n  getGlobalState,\n  GlobalStateProvider,\n  newAsyncDataEnvelope,\n  useAsyncCollection,\n  useAsyncData,\n  useGlobalState,\n  withGlobalStateType,\n} from '@dr.pogodin/react-global-state';\n\nexport * from 'components';\n\nexport {\n  type BeforeRenderResT,\n  type BeforeRenderT,\n  type ConfigT,\n  type ServerSsrContext,\n  type ServerT,\n} from './server';\n\nexport {\n  assertEmptyObject,\n  Barrier,\n  Cached,\n  Emitter,\n  getConfig,\n  isomorphy,\n  getSsrContext,\n  type Listener,\n  type ObjectKey,\n  Semaphore,\n  splitComponent,\n  type Theme,\n  themed,\n  ThemeProvider,\n  time,\n  webpack,\n  withRetries,\n} from 'utils';\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA,IAAIA,MAAM,CAACC,0BAA0B,EAAE;EACrC,MAAMC,KAAK,CAAC,uCAAuC,CAAC;AACtD,CAAC,MAAMF,MAAM,CAACC,0BAA0B,GAAG,IAAI;AAE/C,SAUEE,cAAc,EACdC,mBAAmB,EACnBC,oBAAoB,EACpBC,kBAAkB,EAClBC,YAAY,EACZC,cAAc,EACdC,mBAAmB,QACd,gCAAgC;AAEvC;AAUA,SACEC,iBAAiB,EACjBC,OAAO,EACPC,MAAM,EACNC,OAAO,EACPC,SAAS,EACTC,SAAS,EACTC,aAAa,EAGbC,SAAS,EACTC,cAAc,EAEdC,MAAM,EACNC,aAAa,EACbC,IAAI,EACJC,OAAO,EACPC,WAAW","ignoreList":[]}

package/build/web/server/index.js

@@ -1,34 +1,28 @@
 // eslint-disable-next-line import/no-unassigned-import
-import 'source-map-support/register';
+import 'source-map-support/register.js';
 import http from 'node:http';
 import https from 'node:https';
-import cloneDeep from 'lodash/cloneDeep';
-import defaults from 'lodash/defaults';
-import isFinite from 'lodash/isFinite';
-import isNumber from 'lodash/isNumber';
-import isString from 'lodash/isString';
-import toNumber from 'lodash/toNumber';
+import { cloneDeep, defaults } from 'lodash-es';
 
 // Polyfill required by ReactJS.
 // TODO: Double-check, if it is still required by React v19?
 // eslint-disable-next-line import/no-unassigned-import
-import 'raf/polyfill';
+import 'raf/polyfill.js';
 import serverFactory, { getDefaultCspSettings } from "./server";
 import { SCRIPT_LOCATIONS, newDefaultLogger } from "./renderer";
-import { errors } from "./utils";
-export { errors, getDefaultCspSettings };
+export * from "./utils";
+export { getDefaultCspSettings, SCRIPT_LOCATIONS };
 
 /**
  * Normalizes a port into a number, string, or false.
  * TODO: Drop this function?
  * @param value Port name or number.
- * @return Port number (Number), name (String), or false.
+ * @return Port number (Number), name (String).
  */
 function normalizePort(value) {
-  const port = toNumber(value);
-  if (isFinite(port)) return port; /* port number */
-  if (!isNumber(port)) return value; /* named pipe */
-  return false;
+  const port = typeof value === 'string' ? parseInt(value) : value;
+  if (Number.isFinite(port)) return port; /* port number */
+  return value; /* named pipe */
 }
 /**
  * Creates and launches web-server for ReactJS application. Allows zero
@@ -148,7 +142,7 @@ function normalizePort(value) {
  * defaults to 1 second.
  * @return Resolves to an object with created Express and HTTP servers.
  */
-export default async function launchServer(webpackConfig, options = {}) {
+export async function launchServer(webpackConfig, options = {}) {
   /* Options normalization. */
   const ops = cloneDeep(options);
 
@@ -177,7 +171,7 @@ export default async function launchServer(webpackConfig, options = {}) {
   /* Sets error handler for HTTP(S) server. */
   httpServer.on('error', error => {
     if (error.syscall !== 'listen') throw error;
-    const bind = isString(ops.port) ? `Pipe ${ops.port}` : `Port ${ops.port}`;
+    const bind = typeof ops.port === 'string' ? `Pipe ${ops.port}` : `Port ${ops.port}`;
 
     /* Human-readable message for some specific listen errors. */
     switch (error.code) {
@@ -196,7 +190,7 @@ export default async function launchServer(webpackConfig, options = {}) {
   /* Listening event handler for HTTP(S) server. */
   httpServer.on('listening', () => {
     const addr = httpServer.address();
-    const bind = isString(addr) ? `pipe ${addr}` : `port ${addr.port}`;
+    const bind = typeof addr === 'string' ? `pipe ${addr}` : `port ${addr.port}`;
     ops.logger.info(`Server listening on ${bind} in ${process.env.NODE_ENV} mode`);
   });
   httpServer.listen(ops.port);
@@ -205,7 +199,4 @@ export default async function launchServer(webpackConfig, options = {}) {
     httpServer
   };
 }
-launchServer.SCRIPT_LOCATIONS = SCRIPT_LOCATIONS;
-launchServer.getDefaultCspSettings = getDefaultCspSettings;
-launchServer.errors = errors;
 //# sourceMappingURL=index.js.map

package/build/web/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["http","https","cloneDeep","defaults","isFinite","isNumber","isString","toNumber","serverFactory","getDefaultCspSettings","SCRIPT_LOCATIONS","newDefaultLogger","errors","normalizePort","value","port","launchServer","webpackConfig","options","ops","process","env","PORT","httpsRedirect","logger","defaultLogLevel","defaultLoggerLogLevel","expressServer","httpServer","createServer","cert","key","on","error","syscall","bind","code","exit","undefined","addr","address","info","NODE_ENV","listen"],"sources":["../../../src/server/index.ts"],"sourcesContent":["// eslint-disable-next-line import/no-unassigned-import\nimport 'source-map-support/register';\n\nimport http from 'node:http';\nimport https from 'node:https';\n\nimport cloneDeep from 'lodash/cloneDeep';\nimport defaults from 'lodash/defaults';\nimport isFinite from 'lodash/isFinite';\nimport isNumber from 'lodash/isNumber';\nimport isString from 'lodash/isString';\nimport toNumber from 'lodash/toNumber';\n\n// Polyfill required by ReactJS.\n// TODO: Double-check, if it is still required by React v19?\n// eslint-disable-next-line import/no-unassigned-import\nimport 'raf/polyfill';\n\nimport type { Configuration } from 'webpack';\n\nimport serverFactory, {\n  type OptionsT as ServerOptionsT,\n  type ServerT,\n  getDefaultCspSettings,\n} from './server';\n\nimport { SCRIPT_LOCATIONS, newDefaultLogger } from './renderer';\n\nimport { errors } from './utils';\n\nexport type {\n  BeforeRenderResT,\n  BeforeRenderT,\n  ConfigT,\n  ServerSsrContext,\n} from './renderer';\n\nexport { errors, getDefaultCspSettings, type ServerT };\n\n/**\n * Normalizes a port into a number, string, or false.\n * TODO: Drop this function?\n * @param value Port name or number.\n * @return Port number (Number), name (String), or false.\n */\nfunction normalizePort(value: number | string) {\n  const port = toNumber(value);\n  if (isFinite(port)) return port; /* port number */\n  if (!isNumber(port)) return value; /* named pipe */\n  return false;\n}\n\ntype OptionsT = ServerOptionsT & {\n  https?: {\n    cert: string;\n    key: string;\n  };\n\n  // TODO: Should we limit it to number | string, and throw if it is different value?\n  port?: false | number | string;\n};\n\n/**\n * Creates and launches web-server for ReactJS application. Allows zero\n * or detailed configuration, supports server-side rendering,\n * and development tools, including Hot Module Reloading (HMR).\n *\n * NOTE: Many of options defined below are passed down to the server and\n * renderer factories, and their declared default values are set in those\n * factories, rather than here.\n *\n * @param {object} webpackConfig Webpack configuration used to build\n * the frontend bundle. In production mode the server will read out of it\n * `context`, `publicPath`, and a few other parameters, necessary to locate\n * and serve the app bundle. In development mode the server will use entire\n * provided config to build the app bundle in memory, and further watch and\n * update it via HMR.\n * @param {object} [options] Additional parameters.\n * @param {Component} [options.Application] The root ReactJS component of\n * the app to use for the server-side rendering. When not provided\n * the server-side rendering is disabled.\n * @param {function} [options.beforeExpressJsError] Asynchronous callback\n * (`(server) => Promise<boolean>`) to be executed just before the default error\n * handler is added to ExpressJS server. If the callback is provided and its\n * result resolves to a truthy value, `react-utils` won't attach the default\n * error handler.\n * @param {function} [options.beforeExpressJsSetup] Asynchronous callback\n * (`(server) => Promise) to be executed right after ExpressJS server creation,\n * before any configuration is performed.\n * @param {BeforeRenderHook} [options.beforeRender] The hook to run just before\n * the server-side rendering. For each incoming request, it will be executed\n * just before the HTML markup is generated at the server. It allows to load\n * and provide the data necessary for server-side rendering, and also to inject\n * additional configuration and scripts into the generated HTML code.\n * @param {boolean} [options.noCsp] Set `true` to disable\n * Content-Security-Policy (CSP) headers altogether.\n * @param {function} [options.cspSettingsHook] A hook allowing\n * to customize [CSP](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP)\n * settings for [helmet](https://github.com/helmetjs/helmet)'s\n * `contentSecurityPolicy` middleware on per-request basis.\n *\n * If provided it should be a with signature: \\\n * `(defaultSettings: object, req: object)` &rArr; `object` \\\n * which gets the default settings (also used without the hook),\n * and the incoming request object. The hook response will be passed\n * as options to the helmet `contentSecurityPolicy` middleware.\n *\n * Currently, the default settings is the following object in production\n * environment:\n * ```js\n * {\n *   directives: {\n *     defaultSrc: [\"'self'\"],\n *     baseUri: [\"'self'\"],\n *     blockAllMixedContent: [],\n *     fontSrc: [\"'self'\", 'https:', 'data:'],\n *     frameAncestors: [\"'self'\"],\n *     frameSrc: [\"'self'\", 'https://*.youtube.com'],\n *     imgSrc: [\"'self'\", 'data:'],\n *     objectSrc: [\"'none'\"],\n *     scriptSrc: [\"'self'\", \"'unsafe-eval'\", `'nonce-UNIQUE_NONCE_VALUE'`],\n *     scriptSrcAttr: [\"'none'\"],\n *     styleSrc: [\"'self'\", 'https:', \"'unsafe-inline'\"],\n *     upgradeInsecureRequests: [] // Removed in dev mode.\n *   }\n * }\n * ```\n * It matches the default value used by Helmet with a few updates:\n * - YouTube host is whitelisted in the `frameSrc` directive to ensure\n *   the {@link YouTubeVideo} component works.\n * - An unique per-request nonce is added to `scriptSrc` directive to\n *   whitelist auxiliary scripts injected by react-utils. The actual nonce\n *   value can be fetched by host code via `.nonce` field of `req` argument\n *   of `.beforeRender` hook.\n * - `upgradeInsecureRequests` directive is removed in development mode,\n *   to simplify local testing with http requests.\n * @param {string} [options.defaultLoggerLogLevel='info'] Log level for\n * the default logger, which is created if no `logger` option provided.\n * @param {boolean} [options.devMode] Pass in `true` to start the server in\n * development mode.\n * @param {string} [options.favicon] Path to the favicon to use by the server.\n * By default no favicon is used.\n * @param {object} [options.https] If provided, HTTPS server will be started,\n * instead of HTTP otherwise. The object should provide SSL certificate and key\n * via two string fields: `cert`, and `key`.\n * @param {string} [options.https.cert] SSL Certificate.\n * @param {string} [options.https.key] SSL key.\n * @param {boolean} [options.httpsRedirect=true] Pass in `true` to enable\n * automatic redirection of all incoming HTTP requests to HTTPS.\n *\n * To smoothly use it at `localhost` you need to run the server in HTTPS mode,\n * and also properly create and install a self-signed SSL sertificate on your\n * system. This article is helpful:\n * [How to get HTTPS working on your local development environment in 5 minutes](https://medium.freecodecamp.org/how-to-get-https-working-on-your-local-development-environment-in-5-minutes-7af615770eec)\n * @param {Logger} [options.logger] The logger to use at server side.\n * By default [`winston`](https://www.npmjs.com/package/winston) logger\n * with console transport is used. The logger you provide, or the default\n * `winston` logger otherwise, will be attached to the created ExpressJS server\n * object.\n * @param {function} [options.onExpressJsSetup] An async callback\n * (`(server) => Promise`) to be triggered when most of the server\n * configuration is completed, just before the server-side renderer,\n * and the default error handler are attached. You can use it to mount\n * custom API routes. The server-side logger can be accessed as `server.logger`.\n * @param {number|string} [options.port=3000] The port to start the server on.\n * @param {number} [options.staticCacheSize=1.e7] The maximum\n * static cache size in bytes. Defaults to ~10 MB.\n * @param {function} [options.staticCacheController] When given, it activates,\n * and controls the static caching of generated HTML markup. When this function\n * is provided, on each incoming request it is triggered with the request\n * passed in as the argument. To attempt to serve the response from the cache\n * it should return the object with the following fields:\n * - `key: string` &ndash; the cache key for the response;\n * - `maxage?: number` &ndash; the maximum age of cached result in ms.\n *   If undefined - infinite age is assumed.\n * @param {number} [options.maxSsrRounds=10] Maximum number of SSR rounds.\n * @param {number} [options.ssrTimeout=1000] SSR timeout in milliseconds,\n * defaults to 1 second.\n * @return Resolves to an object with created Express and HTTP servers.\n */\nexport default async function launchServer(\n  webpackConfig: Configuration,\n  options: OptionsT = {},\n): Promise<{\n  expressServer: ServerT;\n  httpServer: http.Server;\n}> {\n  /* Options normalization. */\n  const ops = cloneDeep(options);\n\n  // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing\n  ops.port = normalizePort(ops.port || process.env.PORT || 3000);\n  defaults(ops, { httpsRedirect: true });\n\n  // TODO: Need a separate type for normalized options, which guarantees\n  // the logger is set!\n  ops.logger ??= newDefaultLogger({\n    defaultLogLevel: ops.defaultLoggerLogLevel,\n  });\n\n  /* Creates servers, resolves and sets the port. */\n  const expressServer = await serverFactory(webpackConfig, ops);\n\n  let httpServer: http.Server;\n  if (ops.https) {\n    httpServer = https.createServer({\n      cert: ops.https.cert,\n      key: ops.https.key,\n    }, expressServer as unknown as () => void);\n  } else httpServer = http.createServer(expressServer as unknown as () => void);\n\n  /* Sets error handler for HTTP(S) server. */\n  httpServer.on('error', (error: Error) => {\n    if ((error as { syscall?: string }).syscall !== 'listen') throw error;\n    const bind = isString(ops.port) ? `Pipe ${ops.port}` : `Port ${ops.port}`;\n\n    /* Human-readable message for some specific listen errors. */\n    switch ((error as { code?: string }).code) {\n      case 'EACCES':\n        ops.logger!.error(`${bind} requires elevated privileges`);\n        return process.exit(1);\n      case 'EADDRINUSE':\n        ops.logger!.error(`${bind} is already in use`);\n        return process.exit(1);\n      case undefined:\n      default:\n        throw error;\n    }\n  });\n\n  /* Listening event handler for HTTP(S) server. */\n  httpServer.on('listening', () => {\n    const addr = httpServer.address()!;\n    const bind = isString(addr) ? `pipe ${addr}` : `port ${addr.port}`;\n    ops.logger!.info(`Server listening on ${bind} in ${\n      process.env.NODE_ENV} mode`);\n  });\n\n  httpServer.listen(ops.port);\n\n  return {\n    expressServer,\n    httpServer,\n  };\n}\n\nlaunchServer.SCRIPT_LOCATIONS = SCRIPT_LOCATIONS;\nlaunchServer.getDefaultCspSettings = getDefaultCspSettings;\nlaunchServer.errors = errors;\n"],"mappings":"AAAA;AACA,OAAO,6BAA6B;AAEpC,OAAOA,IAAI,MAAM,WAAW;AAC5B,OAAOC,KAAK,MAAM,YAAY;AAE9B,OAAOC,SAAS,MAAM,kBAAkB;AACxC,OAAOC,QAAQ,MAAM,iBAAiB;AACtC,OAAOC,QAAQ,MAAM,iBAAiB;AACtC,OAAOC,QAAQ,MAAM,iBAAiB;AACtC,OAAOC,QAAQ,MAAM,iBAAiB;AACtC,OAAOC,QAAQ,MAAM,iBAAiB;;AAEtC;AACA;AACA;AACA,OAAO,cAAc;AAIrB,OAAOC,aAAa,IAGlBC,qBAAqB;AAGvB,SAASC,gBAAgB,EAAEC,gBAAgB;AAE3C,SAASC,MAAM;AASf,SAASA,MAAM,EAAEH,qBAAqB;;AAEtC;AACA;AACA;AACA;AACA;AACA;AACA,SAASI,aAAaA,CAACC,KAAsB,EAAE;EAC7C,MAAMC,IAAI,GAAGR,QAAQ,CAACO,KAAK,CAAC;EAC5B,IAAIV,QAAQ,CAACW,IAAI,CAAC,EAAE,OAAOA,IAAI,CAAC,CAAC;EACjC,IAAI,CAACV,QAAQ,CAACU,IAAI,CAAC,EAAE,OAAOD,KAAK,CAAC,CAAC;EACnC,OAAO,KAAK;AACd;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,eAAeE,YAAYA,CACxCC,aAA4B,EAC5BC,OAAiB,GAAG,CAAC,CAAC,EAIrB;EACD;EACA,MAAMC,GAAG,GAAGjB,SAAS,CAACgB,OAAO,CAAC;;EAE9B;EACAC,GAAG,CAACJ,IAAI,GAAGF,aAAa,CAACM,GAAG,CAACJ,IAAI,IAAIK,OAAO,CAACC,GAAG,CAACC,IAAI,IAAI,IAAI,CAAC;EAC9DnB,QAAQ,CAACgB,GAAG,EAAE;IAAEI,aAAa,EAAE;EAAK,CAAC,CAAC;;EAEtC;EACA;EACAJ,GAAG,CAACK,MAAM,KAAKb,gBAAgB,CAAC;IAC9Bc,eAAe,EAAEN,GAAG,CAACO;EACvB,CAAC,CAAC;;EAEF;EACA,MAAMC,aAAa,GAAG,MAAMnB,aAAa,CAACS,aAAa,EAAEE,GAAG,CAAC;EAE7D,IAAIS,UAAuB;EAC3B,IAAIT,GAAG,CAAClB,KAAK,EAAE;IACb2B,UAAU,GAAG3B,KAAK,CAAC4B,YAAY,CAAC;MAC9BC,IAAI,EAAEX,GAAG,CAAClB,KAAK,CAAC6B,IAAI;MACpBC,GAAG,EAAEZ,GAAG,CAAClB,KAAK,CAAC8B;IACjB,CAAC,EAAEJ,aAAsC,CAAC;EAC5C,CAAC,MAAMC,UAAU,GAAG5B,IAAI,CAAC6B,YAAY,CAACF,aAAsC,CAAC;;EAE7E;EACAC,UAAU,CAACI,EAAE,CAAC,OAAO,EAAGC,KAAY,IAAK;IACvC,IAAKA,KAAK,CAA0BC,OAAO,KAAK,QAAQ,EAAE,MAAMD,KAAK;IACrE,MAAME,IAAI,GAAG7B,QAAQ,CAACa,GAAG,CAACJ,IAAI,CAAC,GAAG,QAAQI,GAAG,CAACJ,IAAI,EAAE,GAAG,QAAQI,GAAG,CAACJ,IAAI,EAAE;;IAEzE;IACA,QAASkB,KAAK,CAAuBG,IAAI;MACvC,KAAK,QAAQ;QACXjB,GAAG,CAACK,MAAM,CAAES,KAAK,CAAC,GAAGE,IAAI,+BAA+B,CAAC;QACzD,OAAOf,OAAO,CAACiB,IAAI,CAAC,CAAC,CAAC;MACxB,KAAK,YAAY;QACflB,GAAG,CAACK,MAAM,CAAES,KAAK,CAAC,GAAGE,IAAI,oBAAoB,CAAC;QAC9C,OAAOf,OAAO,CAACiB,IAAI,CAAC,CAAC,CAAC;MACxB,KAAKC,SAAS;MACd;QACE,MAAML,KAAK;IACf;EACF,CAAC,CAAC;;EAEF;EACAL,UAAU,CAACI,EAAE,CAAC,WAAW,EAAE,MAAM;IAC/B,MAAMO,IAAI,GAAGX,UAAU,CAACY,OAAO,CAAC,CAAE;IAClC,MAAML,IAAI,GAAG7B,QAAQ,CAACiC,IAAI,CAAC,GAAG,QAAQA,IAAI,EAAE,GAAG,QAAQA,IAAI,CAACxB,IAAI,EAAE;IAClEI,GAAG,CAACK,MAAM,CAAEiB,IAAI,CAAC,uBAAuBN,IAAI,OAC1Cf,OAAO,CAACC,GAAG,CAACqB,QAAQ,OAAO,CAAC;EAChC,CAAC,CAAC;EAEFd,UAAU,CAACe,MAAM,CAACxB,GAAG,CAACJ,IAAI,CAAC;EAE3B,OAAO;IACLY,aAAa;IACbC;EACF,CAAC;AACH;AAEAZ,YAAY,CAACN,gBAAgB,GAAGA,gBAAgB;AAChDM,YAAY,CAACP,qBAAqB,GAAGA,qBAAqB;AAC1DO,YAAY,CAACJ,MAAM,GAAGA,MAAM","ignoreList":[]}
+{"version":3,"file":"index.js","names":["http","https","cloneDeep","defaults","serverFactory","getDefaultCspSettings","SCRIPT_LOCATIONS","newDefaultLogger","normalizePort","value","port","parseInt","Number","isFinite","launchServer","webpackConfig","options","ops","process","env","PORT","httpsRedirect","logger","defaultLogLevel","defaultLoggerLogLevel","expressServer","httpServer","createServer","cert","key","on","error","syscall","bind","code","exit","undefined","addr","address","info","NODE_ENV","listen"],"sources":["../../../src/server/index.ts"],"sourcesContent":["// eslint-disable-next-line import/no-unassigned-import\nimport 'source-map-support/register.js';\n\nimport http from 'node:http';\nimport https from 'node:https';\n\nimport { cloneDeep, defaults } from 'lodash-es';\n\n// Polyfill required by ReactJS.\n// TODO: Double-check, if it is still required by React v19?\n// eslint-disable-next-line import/no-unassigned-import\nimport 'raf/polyfill.js';\n\nimport type { Configuration } from 'webpack';\n\nimport serverFactory, {\n  type OptionsT as ServerOptionsT,\n  type ServerT,\n  getDefaultCspSettings,\n} from './server';\n\nimport { SCRIPT_LOCATIONS, newDefaultLogger } from './renderer';\n\nexport * from './utils';\n\nexport type {\n  BeforeRenderResT,\n  BeforeRenderT,\n  ConfigT,\n  ServerSsrContext,\n} from './renderer';\n\nexport {\n  getDefaultCspSettings,\n  SCRIPT_LOCATIONS,\n  type ServerT,\n};\n\n/**\n * Normalizes a port into a number, string, or false.\n * TODO: Drop this function?\n * @param value Port name or number.\n * @return Port number (Number), name (String).\n */\nfunction normalizePort(value: number | string) {\n  const port = typeof value === 'string' ? parseInt(value) : value;\n  if (Number.isFinite(port)) return port; /* port number */\n  return value; /* named pipe */\n}\n\ntype OptionsT = ServerOptionsT & {\n  https?: {\n    cert: string;\n    key: string;\n  };\n\n  // TODO: Should we limit it to number | string, and throw if it is different value?\n  port?: false | number | string;\n};\n\n/**\n * Creates and launches web-server for ReactJS application. Allows zero\n * or detailed configuration, supports server-side rendering,\n * and development tools, including Hot Module Reloading (HMR).\n *\n * NOTE: Many of options defined below are passed down to the server and\n * renderer factories, and their declared default values are set in those\n * factories, rather than here.\n *\n * @param {object} webpackConfig Webpack configuration used to build\n * the frontend bundle. In production mode the server will read out of it\n * `context`, `publicPath`, and a few other parameters, necessary to locate\n * and serve the app bundle. In development mode the server will use entire\n * provided config to build the app bundle in memory, and further watch and\n * update it via HMR.\n * @param {object} [options] Additional parameters.\n * @param {Component} [options.Application] The root ReactJS component of\n * the app to use for the server-side rendering. When not provided\n * the server-side rendering is disabled.\n * @param {function} [options.beforeExpressJsError] Asynchronous callback\n * (`(server) => Promise<boolean>`) to be executed just before the default error\n * handler is added to ExpressJS server. If the callback is provided and its\n * result resolves to a truthy value, `react-utils` won't attach the default\n * error handler.\n * @param {function} [options.beforeExpressJsSetup] Asynchronous callback\n * (`(server) => Promise) to be executed right after ExpressJS server creation,\n * before any configuration is performed.\n * @param {BeforeRenderHook} [options.beforeRender] The hook to run just before\n * the server-side rendering. For each incoming request, it will be executed\n * just before the HTML markup is generated at the server. It allows to load\n * and provide the data necessary for server-side rendering, and also to inject\n * additional configuration and scripts into the generated HTML code.\n * @param {boolean} [options.noCsp] Set `true` to disable\n * Content-Security-Policy (CSP) headers altogether.\n * @param {function} [options.cspSettingsHook] A hook allowing\n * to customize [CSP](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP)\n * settings for [helmet](https://github.com/helmetjs/helmet)'s\n * `contentSecurityPolicy` middleware on per-request basis.\n *\n * If provided it should be a with signature: \\\n * `(defaultSettings: object, req: object)` &rArr; `object` \\\n * which gets the default settings (also used without the hook),\n * and the incoming request object. The hook response will be passed\n * as options to the helmet `contentSecurityPolicy` middleware.\n *\n * Currently, the default settings is the following object in production\n * environment:\n * ```js\n * {\n *   directives: {\n *     defaultSrc: [\"'self'\"],\n *     baseUri: [\"'self'\"],\n *     blockAllMixedContent: [],\n *     fontSrc: [\"'self'\", 'https:', 'data:'],\n *     frameAncestors: [\"'self'\"],\n *     frameSrc: [\"'self'\", 'https://*.youtube.com'],\n *     imgSrc: [\"'self'\", 'data:'],\n *     objectSrc: [\"'none'\"],\n *     scriptSrc: [\"'self'\", \"'unsafe-eval'\", `'nonce-UNIQUE_NONCE_VALUE'`],\n *     scriptSrcAttr: [\"'none'\"],\n *     styleSrc: [\"'self'\", 'https:', \"'unsafe-inline'\"],\n *     upgradeInsecureRequests: [] // Removed in dev mode.\n *   }\n * }\n * ```\n * It matches the default value used by Helmet with a few updates:\n * - YouTube host is whitelisted in the `frameSrc` directive to ensure\n *   the {@link YouTubeVideo} component works.\n * - An unique per-request nonce is added to `scriptSrc` directive to\n *   whitelist auxiliary scripts injected by react-utils. The actual nonce\n *   value can be fetched by host code via `.nonce` field of `req` argument\n *   of `.beforeRender` hook.\n * - `upgradeInsecureRequests` directive is removed in development mode,\n *   to simplify local testing with http requests.\n * @param {string} [options.defaultLoggerLogLevel='info'] Log level for\n * the default logger, which is created if no `logger` option provided.\n * @param {boolean} [options.devMode] Pass in `true` to start the server in\n * development mode.\n * @param {string} [options.favicon] Path to the favicon to use by the server.\n * By default no favicon is used.\n * @param {object} [options.https] If provided, HTTPS server will be started,\n * instead of HTTP otherwise. The object should provide SSL certificate and key\n * via two string fields: `cert`, and `key`.\n * @param {string} [options.https.cert] SSL Certificate.\n * @param {string} [options.https.key] SSL key.\n * @param {boolean} [options.httpsRedirect=true] Pass in `true` to enable\n * automatic redirection of all incoming HTTP requests to HTTPS.\n *\n * To smoothly use it at `localhost` you need to run the server in HTTPS mode,\n * and also properly create and install a self-signed SSL sertificate on your\n * system. This article is helpful:\n * [How to get HTTPS working on your local development environment in 5 minutes](https://medium.freecodecamp.org/how-to-get-https-working-on-your-local-development-environment-in-5-minutes-7af615770eec)\n * @param {Logger} [options.logger] The logger to use at server side.\n * By default [`winston`](https://www.npmjs.com/package/winston) logger\n * with console transport is used. The logger you provide, or the default\n * `winston` logger otherwise, will be attached to the created ExpressJS server\n * object.\n * @param {function} [options.onExpressJsSetup] An async callback\n * (`(server) => Promise`) to be triggered when most of the server\n * configuration is completed, just before the server-side renderer,\n * and the default error handler are attached. You can use it to mount\n * custom API routes. The server-side logger can be accessed as `server.logger`.\n * @param {number|string} [options.port=3000] The port to start the server on.\n * @param {number} [options.staticCacheSize=1.e7] The maximum\n * static cache size in bytes. Defaults to ~10 MB.\n * @param {function} [options.staticCacheController] When given, it activates,\n * and controls the static caching of generated HTML markup. When this function\n * is provided, on each incoming request it is triggered with the request\n * passed in as the argument. To attempt to serve the response from the cache\n * it should return the object with the following fields:\n * - `key: string` &ndash; the cache key for the response;\n * - `maxage?: number` &ndash; the maximum age of cached result in ms.\n *   If undefined - infinite age is assumed.\n * @param {number} [options.maxSsrRounds=10] Maximum number of SSR rounds.\n * @param {number} [options.ssrTimeout=1000] SSR timeout in milliseconds,\n * defaults to 1 second.\n * @return Resolves to an object with created Express and HTTP servers.\n */\nexport async function launchServer(\n  webpackConfig: Configuration,\n  options: OptionsT = {},\n): Promise<{\n  expressServer: ServerT;\n  httpServer: http.Server;\n}> {\n  /* Options normalization. */\n  const ops = cloneDeep(options);\n\n  // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing\n  ops.port = normalizePort(ops.port || process.env.PORT || 3000);\n  defaults(ops, { httpsRedirect: true });\n\n  // TODO: Need a separate type for normalized options, which guarantees\n  // the logger is set!\n  ops.logger ??= newDefaultLogger({\n    defaultLogLevel: ops.defaultLoggerLogLevel,\n  });\n\n  /* Creates servers, resolves and sets the port. */\n  const expressServer = await serverFactory(webpackConfig, ops);\n\n  let httpServer: http.Server;\n  if (ops.https) {\n    httpServer = https.createServer({\n      cert: ops.https.cert,\n      key: ops.https.key,\n    }, expressServer as unknown as () => void);\n  } else httpServer = http.createServer(expressServer as unknown as () => void);\n\n  /* Sets error handler for HTTP(S) server. */\n  httpServer.on('error', (error: Error) => {\n    if ((error as { syscall?: string }).syscall !== 'listen') throw error;\n    const bind = typeof ops.port === 'string' ? `Pipe ${ops.port}` : `Port ${ops.port}`;\n\n    /* Human-readable message for some specific listen errors. */\n    switch ((error as { code?: string }).code) {\n      case 'EACCES':\n        ops.logger!.error(`${bind} requires elevated privileges`);\n        return process.exit(1);\n      case 'EADDRINUSE':\n        ops.logger!.error(`${bind} is already in use`);\n        return process.exit(1);\n      case undefined:\n      default:\n        throw error;\n    }\n  });\n\n  /* Listening event handler for HTTP(S) server. */\n  httpServer.on('listening', () => {\n    const addr = httpServer.address()!;\n    const bind = typeof addr === 'string' ? `pipe ${addr}` : `port ${addr.port}`;\n    ops.logger!.info(`Server listening on ${bind} in ${\n      process.env.NODE_ENV} mode`);\n  });\n\n  httpServer.listen(ops.port);\n\n  return {\n    expressServer,\n    httpServer,\n  };\n}\n"],"mappings":"AAAA;AACA,OAAO,gCAAgC;AAEvC,OAAOA,IAAI,MAAM,WAAW;AAC5B,OAAOC,KAAK,MAAM,YAAY;AAE9B,SAASC,SAAS,EAAEC,QAAQ,QAAQ,WAAW;;AAE/C;AACA;AACA;AACA,OAAO,iBAAiB;AAIxB,OAAOC,aAAa,IAGlBC,qBAAqB;AAGvB,SAASC,gBAAgB,EAAEC,gBAAgB;AAE3C;AASA,SACEF,qBAAqB,EACrBC,gBAAgB;;AAIlB;AACA;AACA;AACA;AACA;AACA;AACA,SAASE,aAAaA,CAACC,KAAsB,EAAE;EAC7C,MAAMC,IAAI,GAAG,OAAOD,KAAK,KAAK,QAAQ,GAAGE,QAAQ,CAACF,KAAK,CAAC,GAAGA,KAAK;EAChE,IAAIG,MAAM,CAACC,QAAQ,CAACH,IAAI,CAAC,EAAE,OAAOA,IAAI,CAAC,CAAC;EACxC,OAAOD,KAAK,CAAC,CAAC;AAChB;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,eAAeK,YAAYA,CAChCC,aAA4B,EAC5BC,OAAiB,GAAG,CAAC,CAAC,EAIrB;EACD;EACA,MAAMC,GAAG,GAAGf,SAAS,CAACc,OAAO,CAAC;;EAE9B;EACAC,GAAG,CAACP,IAAI,GAAGF,aAAa,CAACS,GAAG,CAACP,IAAI,IAAIQ,OAAO,CAACC,GAAG,CAACC,IAAI,IAAI,IAAI,CAAC;EAC9DjB,QAAQ,CAACc,GAAG,EAAE;IAAEI,aAAa,EAAE;EAAK,CAAC,CAAC;;EAEtC;EACA;EACAJ,GAAG,CAACK,MAAM,KAAKf,gBAAgB,CAAC;IAC9BgB,eAAe,EAAEN,GAAG,CAACO;EACvB,CAAC,CAAC;;EAEF;EACA,MAAMC,aAAa,GAAG,MAAMrB,aAAa,CAACW,aAAa,EAAEE,GAAG,CAAC;EAE7D,IAAIS,UAAuB;EAC3B,IAAIT,GAAG,CAAChB,KAAK,EAAE;IACbyB,UAAU,GAAGzB,KAAK,CAAC0B,YAAY,CAAC;MAC9BC,IAAI,EAAEX,GAAG,CAAChB,KAAK,CAAC2B,IAAI;MACpBC,GAAG,EAAEZ,GAAG,CAAChB,KAAK,CAAC4B;IACjB,CAAC,EAAEJ,aAAsC,CAAC;EAC5C,CAAC,MAAMC,UAAU,GAAG1B,IAAI,CAAC2B,YAAY,CAACF,aAAsC,CAAC;;EAE7E;EACAC,UAAU,CAACI,EAAE,CAAC,OAAO,EAAGC,KAAY,IAAK;IACvC,IAAKA,KAAK,CAA0BC,OAAO,KAAK,QAAQ,EAAE,MAAMD,KAAK;IACrE,MAAME,IAAI,GAAG,OAAOhB,GAAG,CAACP,IAAI,KAAK,QAAQ,GAAG,QAAQO,GAAG,CAACP,IAAI,EAAE,GAAG,QAAQO,GAAG,CAACP,IAAI,EAAE;;IAEnF;IACA,QAASqB,KAAK,CAAuBG,IAAI;MACvC,KAAK,QAAQ;QACXjB,GAAG,CAACK,MAAM,CAAES,KAAK,CAAC,GAAGE,IAAI,+BAA+B,CAAC;QACzD,OAAOf,OAAO,CAACiB,IAAI,CAAC,CAAC,CAAC;MACxB,KAAK,YAAY;QACflB,GAAG,CAACK,MAAM,CAAES,KAAK,CAAC,GAAGE,IAAI,oBAAoB,CAAC;QAC9C,OAAOf,OAAO,CAACiB,IAAI,CAAC,CAAC,CAAC;MACxB,KAAKC,SAAS;MACd;QACE,MAAML,KAAK;IACf;EACF,CAAC,CAAC;;EAEF;EACAL,UAAU,CAACI,EAAE,CAAC,WAAW,EAAE,MAAM;IAC/B,MAAMO,IAAI,GAAGX,UAAU,CAACY,OAAO,CAAC,CAAE;IAClC,MAAML,IAAI,GAAG,OAAOI,IAAI,KAAK,QAAQ,GAAG,QAAQA,IAAI,EAAE,GAAG,QAAQA,IAAI,CAAC3B,IAAI,EAAE;IAC5EO,GAAG,CAACK,MAAM,CAAEiB,IAAI,CAAC,uBAAuBN,IAAI,OAC1Cf,OAAO,CAACC,GAAG,CAACqB,QAAQ,OAAO,CAAC;EAChC,CAAC,CAAC;EAEFd,UAAU,CAACe,MAAM,CAACxB,GAAG,CAACP,IAAI,CAAC;EAE3B,OAAO;IACLe,aAAa;IACbC;EACF,CAAC;AACH","ignoreList":[]}