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

package/build/production/shared/utils/splitComponent.js.map

@@ -1 +1 @@
-{"version":3,"file":"splitComponent.js","names":["_react","require","_jsUtils","_globalState","_isomorphy","_jsxRuntime","clientChunkGroups","IS_CLIENT_SIDE","default","CHUNK_GROUPS","refCounts","getPublicPath","getBuildInfo","publicPath","bookStyleSheet","name","loadedSheets","refCount","res","path","fullPath","document","location","origin","has","link","querySelector","createElement","setAttribute","head","appendChild","Barrier","addEventListener","Error","resolve","current","getLoadedStyleSheets","Set","styleSheets","href","add","assertChunkName","chunkName","chunkGroups","bookStyleSheets","promises","assets","Promise","asset","endsWith","promise","push","length","allSettled","then","freeStyleSheets","pathRefCount","remove","usedChunkNames","splitComponent","getComponent","placeholder","LazyComponent","lazy","resolved","Component","Wrapper","children","ref","rest","IS_SERVER_SIDE","chunks","getSsrContext","includes","useInsertionEffect","jsx","CodeSplit","Suspense","fallback"],"sources":["../../../../src/shared/utils/splitComponent.tsx"],"sourcesContent":["/* global document */\n\nimport {\n  type ComponentType,\n  type FunctionComponent,\n  type ReactNode,\n  type RefObject,\n  Suspense,\n  lazy,\n  useInsertionEffect,\n} from 'react';\n\nimport { Barrier } from '@dr.pogodin/js-utils';\n\nimport { type ChunkGroupsT, getSsrContext } from './globalState';\n\nimport {\n  IS_CLIENT_SIDE,\n  IS_SERVER_SIDE,\n  getBuildInfo,\n} from './isomorphy';\n\n// Note: At the client side we can get chunk groups immediately when loading\n// the module; at the server-side we only can get them within React render flow.\n// Thus, we set and use the following variable at the client-side, and then when\n// needed on the server side, we'll fetch it differently.\nlet clientChunkGroups: ChunkGroupsT;\n\nif (IS_CLIENT_SIDE) {\n  // TODO: Rewrite to avoid these overrides of ESLint rules.\n  /* eslint-disable @typescript-eslint/no-unsafe-assignment,\n    @typescript-eslint/no-require-imports,\n    @typescript-eslint/no-unsafe-call,\n    @typescript-eslint/no-unsafe-member-access */\n  clientChunkGroups = require('client/getInj').default().CHUNK_GROUPS ?? {};\n  /* eslint-enable @typescript-eslint/no-unsafe-assignment,\n    @typescript-eslint/no-require-imports,\n    @typescript-eslint/no-unsafe-call,\n    @typescript-eslint/no-unsafe-member-access */\n}\n\nconst refCounts: Record<string, number> = {};\n\nfunction getPublicPath() {\n  return getBuildInfo().publicPath;\n}\n\n/**\n * Client-side only! Ensures the specified CSS stylesheet is loaded into\n * the document; loads if it is missing; and does simple reference counting\n * to facilitate future clean-up.\n * @param name\n * @param loadedSheets\n * @param refCount\n * @return\n */\nfunction bookStyleSheet(\n  name: string,\n  loadedSheets: Set<string>,\n  refCount: boolean,\n): Promise<void> | undefined {\n  let res: Barrier<void> | undefined;\n  const path = `${getPublicPath()}/${name}`;\n  const fullPath = `${document.location.origin}${path}`;\n\n  if (!loadedSheets.has(fullPath)) {\n    let link = document.querySelector(`link[href=\"${path}\"]`);\n\n    if (!link) {\n      link = document.createElement('link');\n      link.setAttribute('rel', 'stylesheet');\n      link.setAttribute('href', path);\n      document.head.appendChild(link);\n    }\n\n    res = new Barrier<void>();\n    link.addEventListener('load', () => {\n      if (!res) throw Error('Internal error');\n      void res.resolve();\n    });\n    link.addEventListener('error', () => {\n      if (!res) throw Error('Internal error');\n      void res.resolve();\n    });\n  }\n\n  if (refCount) {\n    const current = refCounts[path] ?? 0;\n    refCounts[path] = 1 + current;\n  }\n\n  return res;\n}\n\n/**\n * Generates the set of URLs for currently loaded, linked stylesheets.\n * @return\n */\nfunction getLoadedStyleSheets(): Set<string> {\n  const res = new Set<string>();\n  const { styleSheets } = document;\n  for (const { href } of styleSheets) {\n    if (href) res.add(href);\n  }\n  return res;\n}\n\nfunction assertChunkName(\n  chunkName: string,\n  chunkGroups: ChunkGroupsT,\n) {\n  if (chunkGroups[chunkName]) return;\n  throw Error(`Unknown chunk name \"${chunkName}\"`);\n}\n\n/**\n * Client-side only! Ensures all CSS stylesheets required for the specified\n * code chunk are loaded into the document; loads the missing ones; and does\n * simple reference counting to facilitate future clean-up.\n * @param chunkName Chunk name.\n * @param refCount\n * @return Resolves once all pending stylesheets, necessary for\n *  the chunk, are either loaded, or failed to load.\n */\nexport async function bookStyleSheets(\n  chunkName: string,\n  chunkGroups: ChunkGroupsT,\n  refCount: boolean,\n): Promise<void> {\n  const promises = [];\n  const assets = chunkGroups[chunkName];\n  if (!assets) return Promise.resolve();\n\n  const loadedSheets = getLoadedStyleSheets();\n\n  for (const asset of assets) {\n    if (asset.endsWith('.css')) {\n      const promise = bookStyleSheet(asset, loadedSheets, refCount);\n      if (promise) promises.push(promise);\n    }\n  }\n\n  return promises.length\n    ? Promise.allSettled(promises).then()\n    : Promise.resolve();\n}\n\n/**\n * Client-side only! Frees from the document all CSS stylesheets that are\n * required by the specified chunk, and have reference counter equal to one\n * (for chunks with larger reference counter values, it just decrements\n * the reference counter).\n * @param {string} chunkName\n */\nexport function freeStyleSheets(\n  chunkName: string,\n  chunkGroups: ChunkGroupsT,\n): void {\n  const assets = chunkGroups[chunkName];\n  if (!assets) return;\n\n  for (const asset of assets) {\n    if (asset.endsWith('.css')) {\n      const path = `${getPublicPath()}/${asset}`;\n\n      const pathRefCount = refCounts[path];\n      if (pathRefCount) {\n        if (pathRefCount <= 1) {\n          document.head.querySelector(`link[href=\"${path}\"]`)!.remove();\n          delete refCounts[path];\n        } else refCounts[path] = pathRefCount - 1;\n      }\n    }\n  }\n}\n\n// Holds the set of chunk names already used for splitComponent() calls.\nconst usedChunkNames = new Set();\n\ntype ComponentOrModule<PropsT> = ComponentType<PropsT> | {\n  default: ComponentType<PropsT>;\n};\n\n/**\n * Given an async component retrieval function `getComponent()` it creates\n * a special \"code split\" component, which uses <Suspense> to asynchronously\n * load on demand the code required by `getComponent()`.\n * @param options\n * @param options.chunkName\n * @param {function} options.getComponent\n * @param {React.Element} [options.placeholder]\n * @return {React.ElementType}\n */\nexport default function splitComponent<\n  ComponentPropsT extends { children?: ReactNode; ref?: RefObject<unknown> },\n>({\n  chunkName,\n  getComponent,\n  placeholder,\n}: {\n  chunkName: string;\n  getComponent: () => Promise<ComponentOrModule<ComponentPropsT>>;\n  placeholder?: ReactNode;\n}): FunctionComponent<ComponentPropsT> {\n  // On the client side we can check right away if the chunk name is known.\n  if (IS_CLIENT_SIDE) assertChunkName(chunkName, clientChunkGroups);\n\n  // The correct usage of splitComponent() assumes a single call per chunk.\n  if (usedChunkNames.has(chunkName)) {\n    throw Error(`Repeated splitComponent() call for the chunk \"${chunkName}\"`);\n  } else usedChunkNames.add(chunkName);\n\n  const LazyComponent = lazy(async () => {\n    const resolved = await getComponent();\n    const Component = 'default' in resolved ? resolved.default : resolved;\n\n    // This pre-loads necessary stylesheets prior to the first mount of\n    // the component (the lazy load function is executed by React one at\n    // the frist mount).\n    if (IS_CLIENT_SIDE) {\n      await bookStyleSheets(chunkName, clientChunkGroups, false);\n    }\n\n    const Wrapper: FunctionComponent<ComponentPropsT> = ({\n      children,\n      ref,\n      ...rest\n    }) => {\n      // On the server side we'll assert the chunk name here,\n      // and also push it to the SSR chunks array.\n      if (IS_SERVER_SIDE) {\n        const { chunkGroups, chunks } = getSsrContext()!;\n        assertChunkName(chunkName, chunkGroups);\n        if (!chunks.includes(chunkName)) chunks.push(chunkName);\n      }\n\n      // This takes care about stylesheets management every time an instance of\n      // this component is mounted / unmounted.\n      useInsertionEffect(() => {\n        void bookStyleSheets(chunkName, clientChunkGroups, true);\n        return () => {\n          freeStyleSheets(chunkName, clientChunkGroups);\n        };\n      }, []);\n\n      return (\n        <Component\n          // eslint-disable-next-line react/jsx-props-no-spreading\n          {...(rest as unknown as ComponentPropsT)}\n          ref={ref}\n        >\n          {children}\n        </Component>\n      );\n    };\n\n    return { default: Wrapper };\n  });\n\n  const CodeSplit: React.FunctionComponent<ComponentPropsT> = ({\n    children,\n    ...rest\n  }: ComponentPropsT) => (\n    <Suspense fallback={placeholder}>\n      <LazyComponent\n        // eslint-disable-next-line react/jsx-props-no-spreading\n        {...rest as Parameters<typeof LazyComponent>[0]}\n      >\n        {children}\n      </LazyComponent>\n    </Suspense>\n  );\n\n  return CodeSplit;\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"splitComponent.js","names":["_react","require","_jsUtils","_globalState","_isomorphy","_jsxRuntime","clientChunkGroups","IS_CLIENT_SIDE","default","CHUNK_GROUPS","refCounts","getPublicPath","getBuildInfo","publicPath","bookStyleSheet","name","loadedSheets","refCount","res","path","fullPath","document","location","origin","has","link","querySelector","createElement","setAttribute","head","appendChild","Barrier","addEventListener","Error","resolve","current","getLoadedStyleSheets","Set","styleSheets","href","add","assertChunkName","chunkName","chunkGroups","bookStyleSheets","promises","assets","Promise","asset","endsWith","promise","push","length","allSettled","then","freeStyleSheets","pathRefCount","remove","usedChunkNames","splitComponent","getComponent","placeholder","LazyComponent","lazy","resolved","Component","Wrapper","children","ref","rest","IS_SERVER_SIDE","chunks","getSsrContext","includes","useInsertionEffect","_jsx","CodeSplit","Suspense","fallback"],"sources":["../../../../src/shared/utils/splitComponent.tsx"],"sourcesContent":["/* global document */\n\nimport {\n  type ComponentType,\n  type FunctionComponent,\n  type ReactNode,\n  type RefObject,\n  Suspense,\n  lazy,\n  useInsertionEffect,\n} from 'react';\n\nimport { Barrier } from '@dr.pogodin/js-utils';\n\nimport { type ChunkGroupsT, getSsrContext } from './globalState';\n\nimport {\n  IS_CLIENT_SIDE,\n  IS_SERVER_SIDE,\n  getBuildInfo,\n} from './isomorphy';\n\n// Note: At the client side we can get chunk groups immediately when loading\n// the module; at the server-side we only can get them within React render flow.\n// Thus, we set and use the following variable at the client-side, and then when\n// needed on the server side, we'll fetch it differently.\nlet clientChunkGroups: ChunkGroupsT;\n\nif (IS_CLIENT_SIDE) {\n  // TODO: Rewrite to avoid these overrides of ESLint rules.\n  /* eslint-disable @typescript-eslint/no-unsafe-assignment,\n    @typescript-eslint/no-require-imports,\n    @typescript-eslint/no-unsafe-call,\n    @typescript-eslint/no-unsafe-member-access */\n  clientChunkGroups = require('client/getInj').default().CHUNK_GROUPS ?? {};\n  /* eslint-enable @typescript-eslint/no-unsafe-assignment,\n    @typescript-eslint/no-require-imports,\n    @typescript-eslint/no-unsafe-call,\n    @typescript-eslint/no-unsafe-member-access */\n}\n\nconst refCounts: Record<string, number> = {};\n\nfunction getPublicPath() {\n  return getBuildInfo().publicPath;\n}\n\n/**\n * Client-side only! Ensures the specified CSS stylesheet is loaded into\n * the document; loads if it is missing; and does simple reference counting\n * to facilitate future clean-up.\n * @param name\n * @param loadedSheets\n * @param refCount\n * @return\n */\nfunction bookStyleSheet(\n  name: string,\n  loadedSheets: Set<string>,\n  refCount: boolean,\n): Promise<void> | undefined {\n  let res: Barrier<void> | undefined;\n  const path = `${getPublicPath()}/${name}`;\n  const fullPath = `${document.location.origin}${path}`;\n\n  if (!loadedSheets.has(fullPath)) {\n    let link = document.querySelector(`link[href=\"${path}\"]`);\n\n    if (!link) {\n      link = document.createElement('link');\n      link.setAttribute('rel', 'stylesheet');\n      link.setAttribute('href', path);\n      document.head.appendChild(link);\n    }\n\n    res = new Barrier<void>();\n    link.addEventListener('load', () => {\n      if (!res) throw Error('Internal error');\n      void res.resolve();\n    });\n    link.addEventListener('error', () => {\n      if (!res) throw Error('Internal error');\n      void res.resolve();\n    });\n  }\n\n  if (refCount) {\n    const current = refCounts[path] ?? 0;\n    refCounts[path] = 1 + current;\n  }\n\n  return res;\n}\n\n/**\n * Generates the set of URLs for currently loaded, linked stylesheets.\n * @return\n */\nfunction getLoadedStyleSheets(): Set<string> {\n  const res = new Set<string>();\n  const { styleSheets } = document;\n  for (const { href } of styleSheets) {\n    if (href) res.add(href);\n  }\n  return res;\n}\n\nfunction assertChunkName(\n  chunkName: string,\n  chunkGroups: ChunkGroupsT,\n) {\n  if (chunkGroups[chunkName]) return;\n  throw Error(`Unknown chunk name \"${chunkName}\"`);\n}\n\n/**\n * Client-side only! Ensures all CSS stylesheets required for the specified\n * code chunk are loaded into the document; loads the missing ones; and does\n * simple reference counting to facilitate future clean-up.\n * @param chunkName Chunk name.\n * @param refCount\n * @return Resolves once all pending stylesheets, necessary for\n *  the chunk, are either loaded, or failed to load.\n */\nexport async function bookStyleSheets(\n  chunkName: string,\n  chunkGroups: ChunkGroupsT,\n  refCount: boolean,\n): Promise<void> {\n  const promises = [];\n  const assets = chunkGroups[chunkName];\n  if (!assets) return Promise.resolve();\n\n  const loadedSheets = getLoadedStyleSheets();\n\n  for (const asset of assets) {\n    if (asset.endsWith('.css')) {\n      const promise = bookStyleSheet(asset, loadedSheets, refCount);\n      if (promise) promises.push(promise);\n    }\n  }\n\n  return promises.length\n    ? Promise.allSettled(promises).then()\n    : Promise.resolve();\n}\n\n/**\n * Client-side only! Frees from the document all CSS stylesheets that are\n * required by the specified chunk, and have reference counter equal to one\n * (for chunks with larger reference counter values, it just decrements\n * the reference counter).\n * @param {string} chunkName\n */\nexport function freeStyleSheets(\n  chunkName: string,\n  chunkGroups: ChunkGroupsT,\n): void {\n  const assets = chunkGroups[chunkName];\n  if (!assets) return;\n\n  for (const asset of assets) {\n    if (asset.endsWith('.css')) {\n      const path = `${getPublicPath()}/${asset}`;\n\n      const pathRefCount = refCounts[path];\n      if (pathRefCount) {\n        if (pathRefCount <= 1) {\n          document.head.querySelector(`link[href=\"${path}\"]`)!.remove();\n          delete refCounts[path];\n        } else refCounts[path] = pathRefCount - 1;\n      }\n    }\n  }\n}\n\n// Holds the set of chunk names already used for splitComponent() calls.\nconst usedChunkNames = new Set();\n\ntype ComponentOrModule<PropsT> = ComponentType<PropsT> | {\n  default: ComponentType<PropsT>;\n};\n\n/**\n * Given an async component retrieval function `getComponent()` it creates\n * a special \"code split\" component, which uses <Suspense> to asynchronously\n * load on demand the code required by `getComponent()`.\n * @param options\n * @param options.chunkName\n * @param {function} options.getComponent\n * @param {React.Element} [options.placeholder]\n * @return {React.ElementType}\n */\nexport default function splitComponent<\n  ComponentPropsT extends { children?: ReactNode; ref?: RefObject<unknown> },\n>({\n  chunkName,\n  getComponent,\n  placeholder,\n}: {\n  chunkName: string;\n  getComponent: () => Promise<ComponentOrModule<ComponentPropsT>>;\n  placeholder?: ReactNode;\n}): FunctionComponent<ComponentPropsT> {\n  // On the client side we can check right away if the chunk name is known.\n  if (IS_CLIENT_SIDE) assertChunkName(chunkName, clientChunkGroups);\n\n  // The correct usage of splitComponent() assumes a single call per chunk.\n  if (usedChunkNames.has(chunkName)) {\n    throw Error(`Repeated splitComponent() call for the chunk \"${chunkName}\"`);\n  } else usedChunkNames.add(chunkName);\n\n  const LazyComponent = lazy(async () => {\n    const resolved = await getComponent();\n    const Component = 'default' in resolved ? resolved.default : resolved;\n\n    // This pre-loads necessary stylesheets prior to the first mount of\n    // the component (the lazy load function is executed by React one at\n    // the frist mount).\n    if (IS_CLIENT_SIDE) {\n      await bookStyleSheets(chunkName, clientChunkGroups, false);\n    }\n\n    const Wrapper: FunctionComponent<ComponentPropsT> = ({\n      children,\n      ref,\n      ...rest\n    }) => {\n      // On the server side we'll assert the chunk name here,\n      // and also push it to the SSR chunks array.\n      if (IS_SERVER_SIDE) {\n        const { chunkGroups, chunks } = getSsrContext()!;\n        assertChunkName(chunkName, chunkGroups);\n        if (!chunks.includes(chunkName)) chunks.push(chunkName);\n      }\n\n      // This takes care about stylesheets management every time an instance of\n      // this component is mounted / unmounted.\n      useInsertionEffect(() => {\n        void bookStyleSheets(chunkName, clientChunkGroups, true);\n        return () => {\n          freeStyleSheets(chunkName, clientChunkGroups);\n        };\n      }, []);\n\n      return (\n        <Component\n          // eslint-disable-next-line react/jsx-props-no-spreading\n          {...(rest as unknown as ComponentPropsT)}\n          ref={ref}\n        >\n          {children}\n        </Component>\n      );\n    };\n\n    return { default: Wrapper };\n  });\n\n  const CodeSplit: React.FunctionComponent<ComponentPropsT> = ({\n    children,\n    ...rest\n  }: ComponentPropsT) => (\n    <Suspense fallback={placeholder}>\n      <LazyComponent\n        // eslint-disable-next-line react/jsx-props-no-spreading\n        {...rest as Parameters<typeof LazyComponent>[0]}\n      >\n        {children}\n      </LazyComponent>\n    </Suspense>\n  );\n\n  return CodeSplit;\n}\n"],"mappings":"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","ignoreList":[]}

package/build/production/shared/utils/time.js.map

@@ -1 +1 @@
-{"version":3,"file":"time.js","names":["_cookie","require","_react","_dayjs","_interopRequireDefault","_jsUtils","_reactGlobalState","_globalState","useCurrent","autorefresh","globalStatePath","precision","SEC_MS","now","setter","useGlobalState","Date","useEffect","timerId","update","old","neu","Math","abs","setTimeout","clearTimeout","useTimezoneOffset","cookieName","ssrContext","getSsrContext","offset","setOffset","value","req","cookies","parseInt","date","getTimezoneOffset","document","cookie","serialize","toString","path","time","DAY_MS","HOUR_MS","MIN_MS","YEAR_MS","timer","_default","exports","default","Object","assign","dayjs"],"sources":["../../../../src/shared/utils/time.ts"],"sourcesContent":["import { serialize } from 'cookie';\nimport { useEffect } from 'react';\nimport dayjs from 'dayjs';\n\nimport {\n  DAY_MS,\n  HOUR_MS,\n  MIN_MS,\n  SEC_MS,\n  YEAR_MS,\n  timer,\n} from '@dr.pogodin/js-utils';\n\nimport { type ForceT, useGlobalState } from '@dr.pogodin/react-global-state';\n\nimport { getSsrContext } from './globalState';\n\n/**\n * This react hook wraps Date.now() function in a SSR friendly way,\n * ensuring that all calls to useCurrent() within the same render return\n * exactly the same time (which is retrieved from Date.now() first, and\n * then stored in the global state to be reused in all other calls), which\n * is also passed and used in the first client side render, and then updated\n * with a finite precision to avoid infinite re-rendering loops.\n */\n// TODO: Should we request the state type as generic parameter, to be able\n// to verify the give globalStatePath is correct?\nexport function useCurrent({\n  autorefresh = false,\n  globalStatePath = 'currentTime',\n  precision = 5 * SEC_MS,\n} = {}): number {\n  const [now, setter] = useGlobalState<ForceT, number>(\n    globalStatePath,\n    Date.now,\n  );\n  useEffect(() => {\n    let timerId: NodeJS.Timeout | undefined;\n    const update = (): void => {\n      setter((old) => {\n        const neu = Date.now();\n        return Math.abs(neu - old) > precision ? neu : old;\n      });\n      if (autorefresh) timerId = setTimeout(update, precision);\n    };\n    update();\n    return (): void => {\n      if (timerId) clearTimeout(timerId);\n    };\n  }, [autorefresh, precision, setter]);\n  return now;\n}\n\n/**\n * Wraps the standard Date.getTimezoneOffset() method in a SSR-friendly way.\n * This hook retrieves the offset value at the client side and uses a cookie\n * to pass it to the server in subsequent requests from that user. At the server\n * side the value from cookie is used in renders and passed back to the client\n * via the global state. Prior to the value being known (in the very first\n * request from the user, when the cookie is still missing), zero value is used\n * as the default value.\n */\n// TODO: Should we request the state type as generic parameter, to be able\n// to verify the give globalStatePath is correct?\nexport function useTimezoneOffset({\n  cookieName = 'timezoneOffset',\n  globalStatePath = 'timezoneOffset',\n} = {}): number {\n  const ssrContext = getSsrContext(false);\n  const [offset, setOffset] = useGlobalState<ForceT, number>(\n    globalStatePath,\n    () => {\n      const value = cookieName\n        && ssrContext?.req.cookies[cookieName] as string;\n      return value ? parseInt(value) : 0;\n    },\n  );\n  useEffect(() => {\n    const date = new Date();\n    const value = date.getTimezoneOffset();\n    setOffset(value);\n    if (cookieName) {\n      document.cookie = serialize(cookieName, value.toString(), { path: '/' });\n    }\n  }, [cookieName, setOffset]);\n  return offset;\n}\n\nconst time = {\n  DAY_MS,\n  HOUR_MS,\n  MIN_MS,\n  SEC_MS,\n  YEAR_MS,\n  now: Date.now,\n  timer,\n  useCurrent,\n  useTimezoneOffset,\n};\n\nexport default Object.assign(dayjs, time);\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"time.js","names":["_cookie","require","_react","_dayjs","_interopRequireDefault","_jsUtils","_reactGlobalState","_globalState","useCurrent","autorefresh","globalStatePath","precision","SEC_MS","now","setter","useGlobalState","Date","useEffect","timerId","update","old","neu","Math","abs","setTimeout","clearTimeout","useTimezoneOffset","cookieName","ssrContext","getSsrContext","offset","setOffset","value","req","cookies","parseInt","date","getTimezoneOffset","document","cookie","serialize","toString","path","time","DAY_MS","HOUR_MS","MIN_MS","YEAR_MS","timer","_default","exports","default","Object","assign","dayjs"],"sources":["../../../../src/shared/utils/time.ts"],"sourcesContent":["import { serialize } from 'cookie';\nimport { useEffect } from 'react';\nimport dayjs from 'dayjs';\n\nimport {\n  DAY_MS,\n  HOUR_MS,\n  MIN_MS,\n  SEC_MS,\n  YEAR_MS,\n  timer,\n} from '@dr.pogodin/js-utils';\n\nimport { type ForceT, useGlobalState } from '@dr.pogodin/react-global-state';\n\nimport { getSsrContext } from './globalState';\n\n/**\n * This react hook wraps Date.now() function in a SSR friendly way,\n * ensuring that all calls to useCurrent() within the same render return\n * exactly the same time (which is retrieved from Date.now() first, and\n * then stored in the global state to be reused in all other calls), which\n * is also passed and used in the first client side render, and then updated\n * with a finite precision to avoid infinite re-rendering loops.\n */\n// TODO: Should we request the state type as generic parameter, to be able\n// to verify the give globalStatePath is correct?\nexport function useCurrent({\n  autorefresh = false,\n  globalStatePath = 'currentTime',\n  precision = 5 * SEC_MS,\n} = {}): number {\n  const [now, setter] = useGlobalState<ForceT, number>(\n    globalStatePath,\n    Date.now,\n  );\n  useEffect(() => {\n    let timerId: NodeJS.Timeout | undefined;\n    const update = (): void => {\n      setter((old) => {\n        const neu = Date.now();\n        return Math.abs(neu - old) > precision ? neu : old;\n      });\n      if (autorefresh) timerId = setTimeout(update, precision);\n    };\n    update();\n    return (): void => {\n      if (timerId) clearTimeout(timerId);\n    };\n  }, [autorefresh, precision, setter]);\n  return now;\n}\n\n/**\n * Wraps the standard Date.getTimezoneOffset() method in a SSR-friendly way.\n * This hook retrieves the offset value at the client side and uses a cookie\n * to pass it to the server in subsequent requests from that user. At the server\n * side the value from cookie is used in renders and passed back to the client\n * via the global state. Prior to the value being known (in the very first\n * request from the user, when the cookie is still missing), zero value is used\n * as the default value.\n */\n// TODO: Should we request the state type as generic parameter, to be able\n// to verify the give globalStatePath is correct?\nexport function useTimezoneOffset({\n  cookieName = 'timezoneOffset',\n  globalStatePath = 'timezoneOffset',\n} = {}): number {\n  const ssrContext = getSsrContext(false);\n  const [offset, setOffset] = useGlobalState<ForceT, number>(\n    globalStatePath,\n    () => {\n      const value = cookieName\n        && ssrContext?.req.cookies[cookieName] as string;\n      return value ? parseInt(value) : 0;\n    },\n  );\n  useEffect(() => {\n    const date = new Date();\n    const value = date.getTimezoneOffset();\n    setOffset(value);\n    if (cookieName) {\n      document.cookie = serialize(cookieName, value.toString(), { path: '/' });\n    }\n  }, [cookieName, setOffset]);\n  return offset;\n}\n\nconst time = {\n  DAY_MS,\n  HOUR_MS,\n  MIN_MS,\n  SEC_MS,\n  YEAR_MS,\n  now: Date.now,\n  timer,\n  useCurrent,\n  useTimezoneOffset,\n};\n\nexport default Object.assign(dayjs, time);\n"],"mappings":"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","ignoreList":[]}

package/build/web/client/getInj.js

@@ -0,0 +1,54 @@
+"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");
+// 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.
+
+// eslint-disable-next-line import/no-unassigned-import
+
+// 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: 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() {
+  return inj;
+}
+//# sourceMappingURL=getInj.js.map

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

@@ -0,0 +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":[]}

package/build/web/client/index.js

@@ -0,0 +1,38 @@
+"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 */
+
+/**
+ * Prepares and launches the app at client side.
+ * @param Application Root application component
+ * @param [options={}] Optional. Additional settings.
+ */
+function Launch(Application, options = {}) {
+  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, {})
+      })
+    })
+  });
+  if (options.dontHydrate) {
+    const root = (0, _client.createRoot)(container);
+    root.render(scene);
+  } else (0, _client.hydrateRoot)(container, scene);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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":[]}

package/build/web/client/init.js

@@ -0,0 +1,49 @@
+"use strict";
+
+var _buildInfo = require("../shared/utils/isomorphy/buildInfo");
+/**
+ * Initialization of client-side environment.
+ */
+
+/* global window */
+
+const buildInfo = (0, _buildInfo.getBuildInfo)();
+
+// TODO: Should be moved into buildInfo module?
+
+if (process.env.NODE_ENV !== 'production') {
+  // eslint-disable-next-line no-console
+  console.warn('Dev mode: "BUILD_INFO" attached to the global "window"');
+
+  // eslint-disable-next-line no-underscore-dangle
+  window.__DEV_BUILD_INFO__ = BUILD_INFO;
+}
+
+/* TODO: A proper logger should be moved to `@dr.pogodin/react-utils`. */
+const {
+  useServiceWorker
+} = buildInfo;
+if (useServiceWorker) {
+  const {
+    navigator
+  } = window;
+  if ('serviceWorker' in navigator) {
+    window.addEventListener('load', () => {
+      void (async () => {
+        try {
+          // Note: no matter the "publicPath", we want to serve the service worker
+          // from the web app root, to allow it control any and all pages of the
+          // web app (otherwise, it will be restricted to the scope of its path).
+          // The server takes it into account.
+          const reg = await navigator.serviceWorker.register('/__service-worker.js');
+          // eslint-disable-next-line no-console
+          console.log('SW registered:', reg);
+        } catch (err) {
+          // eslint-disable-next-line no-console
+          console.log('SW registration failed:', err);
+        }
+      })();
+    });
+  }
+}
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +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":[]}

package/build/web/index.js

@@ -0,0 +1,25 @@
+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
+// a proper dedupe and using a single common library version).
+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 };
+//# sourceMappingURL=index.js.map

package/build/web/index.js.map

@@ -0,0 +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":[]}

package/build/web/server/Cache.js

@@ -0,0 +1,54 @@
+/**
+ * Implements the static cache.
+ */
+export default class Cache {
+  items = {};
+  size = 0;
+  constructor(maxSize) {
+    this.maxSize = maxSize;
+  }
+
+  /**
+   * Cache lookup.
+   * @param key Item key to look for.
+   * @param [maxage=Number.MAX_VALUE] Optional. The maximum age of
+   *  cached item to serve. Default to infinite.
+   * @returns Cached item, or null if the item is absent in cache,
+   *  or stale.
+   */
+  get({
+    key,
+    maxage = Number.MAX_VALUE
+  }) {
+    const item = this.items[key];
+    return item && Date.now() - item.timestamp < maxage ? item.data : null;
+  }
+
+  /**
+   * Adds item to cache.
+   * @param data Item to add.
+   * @param key Key to store the item at.
+   * @param size Byte size of the item.
+   */
+  add(data, key, size) {
+    const cached = this.items[key];
+    if (cached) this.size -= cached.size;
+    this.items[key] = {
+      data,
+      size,
+      timestamp: Date.now()
+    };
+    this.size += size;
+    if (this.size > this.maxSize) {
+      const entries = Object.entries(this.items);
+      entries.sort((a, b) => a[1].timestamp - b[1].timestamp);
+      for (const entry of entries) {
+        const [itemKey, item] = entry;
+        delete this.items[itemKey];
+        this.size -= item.size;
+        if (this.size < this.maxSize / 2) break;
+      }
+    }
+  }
+}
+//# sourceMappingURL=Cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Cache.js","names":["Cache","items","size","constructor","maxSize","get","key","maxage","Number","MAX_VALUE","item","Date","now","timestamp","data","add","cached","entries","Object","sort","a","b","entry","itemKey"],"sources":["../../../src/server/Cache.ts"],"sourcesContent":["type CachedItemT<DatumT> = {\n  data: DatumT;\n  size: number;\n  timestamp: number;\n};\n\n/**\n * Implements the static cache.\n */\nexport default class Cache<DatumT> {\n  private items: Record<string, CachedItemT<DatumT>> = {};\n\n  private size = 0;\n\n  constructor(private maxSize: number) { }\n\n  /**\n   * Cache lookup.\n   * @param key Item key to look for.\n   * @param [maxage=Number.MAX_VALUE] Optional. The maximum age of\n   *  cached item to serve. Default to infinite.\n   * @returns Cached item, or null if the item is absent in cache,\n   *  or stale.\n   */\n  get({\n    key,\n    maxage = Number.MAX_VALUE,\n  }: {\n    key: string;\n    maxage?: number;\n  }): DatumT | null {\n    const item = this.items[key];\n    return item && Date.now() - item.timestamp < maxage ? item.data : null;\n  }\n\n  /**\n   * Adds item to cache.\n   * @param data Item to add.\n   * @param key Key to store the item at.\n   * @param size Byte size of the item.\n   */\n  add(data: DatumT, key: string, size: number): void {\n    const cached = this.items[key];\n    if (cached) this.size -= cached.size;\n\n    this.items[key] = { data, size, timestamp: Date.now() };\n    this.size += size;\n\n    if (this.size > this.maxSize) {\n      const entries = Object.entries(this.items);\n      entries.sort((a, b) => a[1].timestamp - b[1].timestamp);\n\n      for (const entry of entries) {\n        const [itemKey, item] = entry;\n        delete this.items[itemKey];\n        this.size -= item.size;\n        if (this.size < this.maxSize / 2) break;\n      }\n    }\n  }\n}\n"],"mappings":"AAMA;AACA;AACA;AACA,eAAe,MAAMA,KAAK,CAAS;EACzBC,KAAK,GAAwC,CAAC,CAAC;EAE/CC,IAAI,GAAG,CAAC;EAEhBC,WAAWA,CAASC,OAAe,EAAE;IAAA,KAAjBA,OAAe,GAAfA,OAAe;EAAI;;EAEvC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,GAAGA,CAAC;IACFC,GAAG;IACHC,MAAM,GAAGC,MAAM,CAACC;EAIlB,CAAC,EAAiB;IAChB,MAAMC,IAAI,GAAG,IAAI,CAACT,KAAK,CAACK,GAAG,CAAC;IAC5B,OAAOI,IAAI,IAAIC,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGF,IAAI,CAACG,SAAS,GAAGN,MAAM,GAAGG,IAAI,CAACI,IAAI,GAAG,IAAI;EACxE;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEC,GAAGA,CAACD,IAAY,EAAER,GAAW,EAAEJ,IAAY,EAAQ;IACjD,MAAMc,MAAM,GAAG,IAAI,CAACf,KAAK,CAACK,GAAG,CAAC;IAC9B,IAAIU,MAAM,EAAE,IAAI,CAACd,IAAI,IAAIc,MAAM,CAACd,IAAI;IAEpC,IAAI,CAACD,KAAK,CAACK,GAAG,CAAC,GAAG;MAAEQ,IAAI;MAAEZ,IAAI;MAAEW,SAAS,EAAEF,IAAI,CAACC,GAAG,CAAC;IAAE,CAAC;IACvD,IAAI,CAACV,IAAI,IAAIA,IAAI;IAEjB,IAAI,IAAI,CAACA,IAAI,GAAG,IAAI,CAACE,OAAO,EAAE;MAC5B,MAAMa,OAAO,GAAGC,MAAM,CAACD,OAAO,CAAC,IAAI,CAAChB,KAAK,CAAC;MAC1CgB,OAAO,CAACE,IAAI,CAAC,CAACC,CAAC,EAAEC,CAAC,KAAKD,CAAC,CAAC,CAAC,CAAC,CAACP,SAAS,GAAGQ,CAAC,CAAC,CAAC,CAAC,CAACR,SAAS,CAAC;MAEvD,KAAK,MAAMS,KAAK,IAAIL,OAAO,EAAE;QAC3B,MAAM,CAACM,OAAO,EAAEb,IAAI,CAAC,GAAGY,KAAK;QAC7B,OAAO,IAAI,CAACrB,KAAK,CAACsB,OAAO,CAAC;QAC1B,IAAI,CAACrB,IAAI,IAAIQ,IAAI,CAACR,IAAI;QACtB,IAAI,IAAI,CAACA,IAAI,GAAG,IAAI,CAACE,OAAO,GAAG,CAAC,EAAE;MACpC;IACF;EACF;AACF","ignoreList":[]}

package/build/web/server/index.js

@@ -0,0 +1,211 @@
+// eslint-disable-next-line import/no-unassigned-import
+import 'source-map-support/register';
+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';
+
+// 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 serverFactory, { getDefaultCspSettings } from "./server";
+import { SCRIPT_LOCATIONS, newDefaultLogger } from "./renderer";
+import { errors } from "./utils";
+export { errors, getDefaultCspSettings };
+
+/**
+ * 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.
+ */
+function normalizePort(value) {
+  const port = toNumber(value);
+  if (isFinite(port)) return port; /* port number */
+  if (!isNumber(port)) return value; /* named pipe */
+  return false;
+}
+/**
+ * Creates and launches web-server for ReactJS application. Allows zero
+ * or detailed configuration, supports server-side rendering,
+ * and development tools, including Hot Module Reloading (HMR).
+ *
+ * NOTE: Many of options defined below are passed down to the server and
+ * renderer factories, and their declared default values are set in those
+ * factories, rather than here.
+ *
+ * @param {object} webpackConfig Webpack configuration used to build
+ * the frontend bundle. In production mode the server will read out of it
+ * `context`, `publicPath`, and a few other parameters, necessary to locate
+ * and serve the app bundle. In development mode the server will use entire
+ * provided config to build the app bundle in memory, and further watch and
+ * update it via HMR.
+ * @param {object} [options] Additional parameters.
+ * @param {Component} [options.Application] The root ReactJS component of
+ * the app to use for the server-side rendering. When not provided
+ * the server-side rendering is disabled.
+ * @param {function} [options.beforeExpressJsError] Asynchronous callback
+ * (`(server) => Promise<boolean>`) to be executed just before the default error
+ * handler is added to ExpressJS server. If the callback is provided and its
+ * result resolves to a truthy value, `react-utils` won't attach the default
+ * error handler.
+ * @param {function} [options.beforeExpressJsSetup] Asynchronous callback
+ * (`(server) => Promise) to be executed right after ExpressJS server creation,
+ * before any configuration is performed.
+ * @param {BeforeRenderHook} [options.beforeRender] The hook to run just before
+ * the server-side rendering. For each incoming request, it will be executed
+ * just before the HTML markup is generated at the server. It allows to load
+ * and provide the data necessary for server-side rendering, and also to inject
+ * additional configuration and scripts into the generated HTML code.
+ * @param {boolean} [options.noCsp] Set `true` to disable
+ * Content-Security-Policy (CSP) headers altogether.
+ * @param {function} [options.cspSettingsHook] A hook allowing
+ * to customize [CSP](https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP)
+ * settings for [helmet](https://github.com/helmetjs/helmet)'s
+ * `contentSecurityPolicy` middleware on per-request basis.
+ *
+ * If provided it should be a with signature: \
+ * `(defaultSettings: object, req: object)` &rArr; `object` \
+ * which gets the default settings (also used without the hook),
+ * and the incoming request object. The hook response will be passed
+ * as options to the helmet `contentSecurityPolicy` middleware.
+ *
+ * Currently, the default settings is the following object in production
+ * environment:
+ * ```js
+ * {
+ *   directives: {
+ *     defaultSrc: ["'self'"],
+ *     baseUri: ["'self'"],
+ *     blockAllMixedContent: [],
+ *     fontSrc: ["'self'", 'https:', 'data:'],
+ *     frameAncestors: ["'self'"],
+ *     frameSrc: ["'self'", 'https://*.youtube.com'],
+ *     imgSrc: ["'self'", 'data:'],
+ *     objectSrc: ["'none'"],
+ *     scriptSrc: ["'self'", "'unsafe-eval'", `'nonce-UNIQUE_NONCE_VALUE'`],
+ *     scriptSrcAttr: ["'none'"],
+ *     styleSrc: ["'self'", 'https:', "'unsafe-inline'"],
+ *     upgradeInsecureRequests: [] // Removed in dev mode.
+ *   }
+ * }
+ * ```
+ * It matches the default value used by Helmet with a few updates:
+ * - YouTube host is whitelisted in the `frameSrc` directive to ensure
+ *   the {@link YouTubeVideo} component works.
+ * - An unique per-request nonce is added to `scriptSrc` directive to
+ *   whitelist auxiliary scripts injected by react-utils. The actual nonce
+ *   value can be fetched by host code via `.nonce` field of `req` argument
+ *   of `.beforeRender` hook.
+ * - `upgradeInsecureRequests` directive is removed in development mode,
+ *   to simplify local testing with http requests.
+ * @param {string} [options.defaultLoggerLogLevel='info'] Log level for
+ * the default logger, which is created if no `logger` option provided.
+ * @param {boolean} [options.devMode] Pass in `true` to start the server in
+ * development mode.
+ * @param {string} [options.favicon] Path to the favicon to use by the server.
+ * By default no favicon is used.
+ * @param {object} [options.https] If provided, HTTPS server will be started,
+ * instead of HTTP otherwise. The object should provide SSL certificate and key
+ * via two string fields: `cert`, and `key`.
+ * @param {string} [options.https.cert] SSL Certificate.
+ * @param {string} [options.https.key] SSL key.
+ * @param {boolean} [options.httpsRedirect=true] Pass in `true` to enable
+ * automatic redirection of all incoming HTTP requests to HTTPS.
+ *
+ * To smoothly use it at `localhost` you need to run the server in HTTPS mode,
+ * and also properly create and install a self-signed SSL sertificate on your
+ * system. This article is helpful:
+ * [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)
+ * @param {Logger} [options.logger] The logger to use at server side.
+ * By default [`winston`](https://www.npmjs.com/package/winston) logger
+ * with console transport is used. The logger you provide, or the default
+ * `winston` logger otherwise, will be attached to the created ExpressJS server
+ * object.
+ * @param {function} [options.onExpressJsSetup] An async callback
+ * (`(server) => Promise`) to be triggered when most of the server
+ * configuration is completed, just before the server-side renderer,
+ * and the default error handler are attached. You can use it to mount
+ * custom API routes. The server-side logger can be accessed as `server.logger`.
+ * @param {number|string} [options.port=3000] The port to start the server on.
+ * @param {number} [options.staticCacheSize=1.e7] The maximum
+ * static cache size in bytes. Defaults to ~10 MB.
+ * @param {function} [options.staticCacheController] When given, it activates,
+ * and controls the static caching of generated HTML markup. When this function
+ * is provided, on each incoming request it is triggered with the request
+ * passed in as the argument. To attempt to serve the response from the cache
+ * it should return the object with the following fields:
+ * - `key: string` &ndash; the cache key for the response;
+ * - `maxage?: number` &ndash; the maximum age of cached result in ms.
+ *   If undefined - infinite age is assumed.
+ * @param {number} [options.maxSsrRounds=10] Maximum number of SSR rounds.
+ * @param {number} [options.ssrTimeout=1000] SSR timeout in milliseconds,
+ * defaults to 1 second.
+ * @return Resolves to an object with created Express and HTTP servers.
+ */
+export default async function launchServer(webpackConfig, options = {}) {
+  /* Options normalization. */
+  const ops = cloneDeep(options);
+
+  // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+  ops.port = normalizePort(ops.port || process.env.PORT || 3000);
+  defaults(ops, {
+    httpsRedirect: true
+  });
+
+  // TODO: Need a separate type for normalized options, which guarantees
+  // the logger is set!
+  ops.logger ??= newDefaultLogger({
+    defaultLogLevel: ops.defaultLoggerLogLevel
+  });
+
+  /* Creates servers, resolves and sets the port. */
+  const expressServer = await serverFactory(webpackConfig, ops);
+  let httpServer;
+  if (ops.https) {
+    httpServer = https.createServer({
+      cert: ops.https.cert,
+      key: ops.https.key
+    }, expressServer);
+  } else httpServer = http.createServer(expressServer);
+
+  /* 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}`;
+
+    /* Human-readable message for some specific listen errors. */
+    switch (error.code) {
+      case 'EACCES':
+        ops.logger.error(`${bind} requires elevated privileges`);
+        return process.exit(1);
+      case 'EADDRINUSE':
+        ops.logger.error(`${bind} is already in use`);
+        return process.exit(1);
+      case undefined:
+      default:
+        throw error;
+    }
+  });
+
+  /* Listening event handler for HTTP(S) server. */
+  httpServer.on('listening', () => {
+    const addr = httpServer.address();
+    const bind = isString(addr) ? `pipe ${addr}` : `port ${addr.port}`;
+    ops.logger.info(`Server listening on ${bind} in ${process.env.NODE_ENV} mode`);
+  });
+  httpServer.listen(ops.port);
+  return {
+    expressServer,
+    httpServer
+  };
+}
+launchServer.SCRIPT_LOCATIONS = SCRIPT_LOCATIONS;
+launchServer.getDefaultCspSettings = getDefaultCspSettings;
+launchServer.errors = errors;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +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":[]}