@dr.pogodin/react-utils 1.23.9 → 1.23.11

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

@@ -1 +1 @@
-{"version":3,"file":"time.js","names":["_cookie","_interopRequireDefault","require","_dayjs","_lodash","_react","_jsUtils","_reactGlobalState","useCurrent","autorefresh","globalStatePath","precision","dayjs","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","Cookie","serialize","path","assign","DAY_MS","HOUR_MS","MIN_MS","YEAR_MS","timer","_default","exports","default"],"sources":["../../../../src/shared/utils/time.js"],"sourcesContent":["/* global document */\n\nimport Cookie from 'cookie';\nimport dayjs from 'dayjs';\nimport { assign } from 'lodash';\nimport { useEffect } from 'react';\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 { getSsrContext, useGlobalState } from '@dr.pogodin/react-global-state';\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 * @param {object} [options] Optional settings.\n * @param {string} [options.globalStatePath=\"currentTime\"] Global state path\n *  to keep the current time value.\n * @param {number} [options.precision= 5 * time.SEC_MS] Current time precision.\n *  The hook won't update the current time stored in the global state unless it\n *  is different from Date.now() result by this number (in milliseconds).\n *  Default to 5 seconds.\n * @param {boolean} [options.autorefresh=false] Set `true` to automatically\n *  refresh time stored in the global state with the given `precision` (and\n *  thus automatically re-rendering components dependent on this hook, or\n *  the global state with the period equal to the `precision`.\n * @return {number} Unix timestamp in milliseconds.\n */\nexport function useCurrent({\n  autorefresh = false,\n  globalStatePath = 'currentTime',\n  precision = 5 * dayjs.SEC_MS,\n} = {}) {\n  const [now, setter] = useGlobalState(globalStatePath, Date.now);\n  useEffect(() => {\n    let timerId;\n    const update = () => {\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 () => {\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 * @param {object} [options] Optional settings.\n * @param {string} [options.cookieName=\"timezoneOffset\"] Optional. The name of\n *  cookie to use to store the timezone offset. Defaults \"timezoneOffset\". Set\n *  to a falsy value to forbid using cookies altogether (in that case the hook\n *  will always return zero value at the server-side, and in the first render\n *  at the client-side).\n * @param {string} [options.timezoneOffset=\"timezoneOffset\"] Optional.\n *  The global state path to store the offset. Defaults \"timezoneOffset\".\n * @return {number} Timezone offset.\n */\nexport function useTimezoneOffset({\n  cookieName = 'timezoneOffset',\n  globalStatePath = 'timezoneOffset',\n} = {}) {\n  const ssrContext = getSsrContext(false);\n  const [offset, setOffset] = useGlobalState(globalStatePath, () => {\n    const value = cookieName && ssrContext?.req?.cookies?.[cookieName];\n    return value ? parseInt(value, 10) : 0;\n  });\n  useEffect(() => {\n    const date = new Date();\n    const value = date.getTimezoneOffset();\n    setOffset(value);\n    if (cookieName) {\n      document.cookie = Cookie.serialize(cookieName, value, { path: '/' });\n    }\n  }, [cookieName, setOffset]);\n  return offset;\n}\n\nassign(dayjs, {\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 dayjs;\n"],"mappings":"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"}
+{"version":3,"file":"time.js","names":["_cookie","_interopRequireDefault","require","_dayjs","_lodash","_react","_jsUtils","_reactGlobalState","useCurrent","autorefresh","globalStatePath","precision","dayjs","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","Cookie","serialize","path","assign","DAY_MS","HOUR_MS","MIN_MS","YEAR_MS","timer","_default","exports","default"],"sources":["../../../../src/shared/utils/time.js"],"sourcesContent":["/* global document */\n\nimport Cookie from 'cookie';\nimport dayjs from 'dayjs';\nimport { assign } from 'lodash';\nimport { useEffect } from 'react';\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 { getSsrContext, useGlobalState } from '@dr.pogodin/react-global-state';\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 * @param {object} [options] Optional settings.\n * @param {string} [options.globalStatePath=\"currentTime\"] Global state path\n *  to keep the current time value.\n * @param {number} [options.precision= 5 * time.SEC_MS] Current time precision.\n *  The hook won't update the current time stored in the global state unless it\n *  is different from Date.now() result by this number (in milliseconds).\n *  Default to 5 seconds.\n * @param {boolean} [options.autorefresh=false] Set `true` to automatically\n *  refresh time stored in the global state with the given `precision` (and\n *  thus automatically re-rendering components dependent on this hook, or\n *  the global state with the period equal to the `precision`.\n * @return {number} Unix timestamp in milliseconds.\n */\nexport function useCurrent({\n  autorefresh = false,\n  globalStatePath = 'currentTime',\n  precision = 5 * dayjs.SEC_MS,\n} = {}) {\n  const [now, setter] = useGlobalState(globalStatePath, Date.now);\n  useEffect(() => {\n    let timerId;\n    const update = () => {\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 () => {\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 * @param {object} [options] Optional settings.\n * @param {string} [options.cookieName=\"timezoneOffset\"] Optional. The name of\n *  cookie to use to store the timezone offset. Defaults \"timezoneOffset\". Set\n *  to a falsy value to forbid using cookies altogether (in that case the hook\n *  will always return zero value at the server-side, and in the first render\n *  at the client-side).\n * @param {string} [options.timezoneOffset=\"timezoneOffset\"] Optional.\n *  The global state path to store the offset. Defaults \"timezoneOffset\".\n * @return {number} Timezone offset.\n */\nexport function useTimezoneOffset({\n  cookieName = 'timezoneOffset',\n  globalStatePath = 'timezoneOffset',\n} = {}) {\n  const ssrContext = getSsrContext(false);\n  const [offset, setOffset] = useGlobalState(globalStatePath, () => {\n    const value = cookieName && ssrContext?.req?.cookies?.[cookieName];\n    return value ? parseInt(value, 10) : 0;\n  });\n  useEffect(() => {\n    const date = new Date();\n    const value = date.getTimezoneOffset();\n    setOffset(value);\n    if (cookieName) {\n      document.cookie = Cookie.serialize(cookieName, value, { path: '/' });\n    }\n  }, [cookieName, setOffset]);\n  return offset;\n}\n\nassign(dayjs, {\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 dayjs;\n"],"mappings":"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"}