@ssa-ui-kit/utils 0.0.1-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 SSA Group
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { callAll } from './utils/CallAll';
+export { throttle } from './utils/throttle';
+export * from './utils/debounce';
+export * as dateFormatters from './utils/dates/dateFormatters';
+export { mapObjIndexed } from './utils/objects/mapObjIndexed';
+export { generateRange } from './utils/pagination';
+export * from './utils/objects';
+export * from './utils/types';

package/dist/index.js

@@ -0,0 +1,2 @@
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports.SSAUtils=t():e.SSAUtils=t()}(self,(function(){return function(){"use strict";var e={d:function(t,n){for(var r in n)e.o(n,r)&&!e.o(t,r)&&Object.defineProperty(t,r,{enumerable:!0,get:n[r]})},o:function(e,t){return Object.prototype.hasOwnProperty.call(e,t)},r:function(e){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})}},t={};e.r(t),e.d(t,{assocPath:function(){return m},callAll:function(){return r},dateFormatters:function(){return n},debounce:function(){return u},dissocPath:function(){return S},generateRange:function(){return g},mapObjIndexed:function(){return h},path:function(){return y},pathOr:function(){return b},prop:function(){return w},propOr:function(){return T},throttle:function(){return o}});var n={};e.r(n),e.d(n,{formatDate:function(){return l},formatDayOfWeek:function(){return f},formatTime:function(){return a},getTimeAgo:function(){return d},printDayOfTheWeek:function(){return s}});const r=(...e)=>(...t)=>e.forEach((e=>e?.(...t))),o=(e,t)=>{let n=!1,r=null,o=null;return[function u(...i){n?r=i:(n=!0,e(...i),o=setTimeout((()=>{n=!1,r&&(u(...r),r=null)}),t))},function(){o&&clearTimeout(o)}]},u=(e,t=200)=>{let n=null;return[(...r)=>{n&&clearTimeout(n),n=setTimeout((()=>{n&&clearTimeout(n),e(...r)}),t)},function(){n&&clearTimeout(n)}]},i=["Sun","Mon","Tue","Wed","Thu","Fri","Sat"],c={year:31536e3,month:2592e3,week:604800,day:86400,hour:3600,min:60},a=e=>new Date(e).toLocaleTimeString("en-US",{hour:"2-digit",minute:"2-digit"}),f=e=>i[new Date(e).getDay()],l=e=>new Date(e).toLocaleDateString("en-US",{day:"2-digit",month:"short"}),s=e=>{switch(e){case 0:return"Sun";case 1:return"Mon";case 2:return"Tue";case 3:return"Wed";case 4:return"Thu";case 5:return"Fri";case 6:return"Sat"}},d=e=>{const t=new Date(e).getTime();if(Number.isNaN(t))throw new Error("Invalid date");const n=Math.floor((Date.now()-t)/1e3);let r;for(const e in c)if(r=Math.floor(n/c[e]),r>=1){return`${r} ${e}${r>1?"s":""} ago`}return"Just Now"},h=(e,t)=>Object.keys(t).reduce(((n,r)=>(n[r]=e(t[r],r,t),n)),{}),p=(e,t,n)=>{for(let r=t;r<n;++r)e.push(r)};var g=(e,t)=>{if(null==e||!Number.isInteger(e))throw new Error("Pages count should be an integer");if(e<=0)return[];let n=[1];if(1===e)return n;if(null!=t&&!Number.isInteger(t))throw new Error("Selected page should be an integer");if(null!=t&&(t<1||t>e))throw new Error(`Selected page ${t} is out of range`);if(t&&t>2){const r=((e,t)=>{const n=[];return t!==e&&n.push(t),t>1&&n.unshift(t-1),t+1<e&&n.push(t+1),n})(e,t),[o,,u]=r;o-2>1?n.push(-1):p(n,2,o),n=n.concat(r),e-u>2?n.push(-1):p(n,u+1,e)}else e<=5?p(n,2,e):n.push(2,3,-1);return n.push(e),n};const m=([e,...t],n)=>r=>JSON.parse(JSON.stringify({...r,[e]:t.length?m(t,n)(r[e]):n})),S=e=>t=>{const n=JSON.parse(JSON.stringify(t));return e.reduce(((t,n,r)=>(r===e.length-1&&delete t[n],t[n])),n),n},y=e=>t=>e.reduce(((e,t)=>e?.[t]),t),b=(e,t)=>n=>{const r=y(t)(n);return null==r?e:r},w=e=>t=>t?.[e],T=(e,t)=>n=>{const r=w(t)(n);return null==r?e:r};return t}()}));
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","mappings":"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","sources":["webpack://SSAUtils/webpack/universalModuleDefinition","webpack://SSAUtils/webpack/bootstrap","webpack://SSAUtils/webpack/runtime/define property getters","webpack://SSAUtils/webpack/runtime/hasOwnProperty shorthand","webpack://SSAUtils/webpack/runtime/make namespace object","webpack://SSAUtils/./src/utils/CallAll.ts","webpack://SSAUtils/./src/utils/throttle/throttle.ts","webpack://SSAUtils/./src/utils/debounce/debounce.ts","webpack://SSAUtils/./src/utils/dates/dateFormatters.ts","webpack://SSAUtils/./src/utils/objects/mapObjIndexed.ts","webpack://SSAUtils/./src/utils/pagination/generateRange.ts","webpack://SSAUtils/./src/utils/objects/assocPath.ts","webpack://SSAUtils/./src/utils/objects/dissocPath.ts","webpack://SSAUtils/./src/utils/objects/path.ts","webpack://SSAUtils/./src/utils/objects/pathOr.ts","webpack://SSAUtils/./src/utils/objects/prop.ts","webpack://SSAUtils/./src/utils/objects/propOr.ts"],"sourcesContent":["(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"SSAUtils\"] = factory();\n\telse\n\t\troot[\"SSAUtils\"] = factory();\n})(self, function() {\nreturn ","// The require scope\nvar __webpack_require__ = {};\n\n","// define getter functions for harmony exports\n__webpack_require__.d = function(exports, definition) {\n\tfor(var key in definition) {\n\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n\t\t}\n\t}\n};","__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }","// define __esModule on exports\n__webpack_require__.r = function(exports) {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};","/* eslint-disable @typescript-eslint/no-explicit-any */\nexport const callAll =\n  (...fns: any[]) =>\n  (...args: any) =>\n    fns.forEach((fn) => fn?.(...args));\n","// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype UnknownFn = (...args: any[]) => unknown;\ntype ThrottleFn = (\n  fn: UnknownFn,\n  delayMs: number,\n) => [(...args: unknown[]) => void, () => void];\n/* eslint-enable @typescript-eslint/no-explicit-any */\n\nexport const throttle: ThrottleFn = (fn, delayMs) => {\n  let isThrottled = false;\n  let savedArgs: unknown[] | null = null;\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  function throttledFn(...args: unknown[]) {\n    if (isThrottled) {\n      savedArgs = args;\n      return;\n    }\n\n    isThrottled = true;\n\n    fn(...args);\n\n    timeoutId = setTimeout(() => {\n      isThrottled = false;\n\n      // istanbul ignore else\n      if (savedArgs) {\n        throttledFn(...savedArgs);\n        savedArgs = null;\n      }\n    }, delayMs);\n  }\n\n  return [\n    throttledFn,\n    function cancel() {\n      if (timeoutId) {\n        clearTimeout(timeoutId);\n      }\n    },\n  ];\n};\n","type UnknownFn = (...args: any[]) => unknown;\n\nexport const debounce = (func: UnknownFn, wait = 200) => {\n  let timeoutId: NodeJS.Timeout | null = null;\n  const executedFunction = (...args: any[]) => {\n    const postponedFn = () => {\n      if (timeoutId) {\n        clearTimeout(timeoutId);\n      }\n      func(...args);\n    };\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n    }\n    timeoutId = setTimeout(postponedFn, wait);\n  };\n\n  const cancel = function () {\n    if (timeoutId) {\n      clearTimeout(timeoutId);\n    }\n  };\n  return [executedFunction, cancel];\n};\n","const dayOfWeekNames = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];\nconst periodValues: Record<string, number> = {\n  year: 31536000,\n  month: 2592000,\n  week: 604800,\n  day: 86400,\n  hour: 3600,\n  min: 60,\n};\n\nexport const formatTime = (timestampMs: number) =>\n  new Date(timestampMs).toLocaleTimeString('en-US', {\n    hour: '2-digit',\n    minute: '2-digit',\n  });\n\nexport const formatDayOfWeek = (timestampMs: number) =>\n  dayOfWeekNames[new Date(timestampMs).getDay()];\n\nexport const formatDate = (timestampMs: number) =>\n  new Date(timestampMs).toLocaleDateString('en-US', {\n    day: '2-digit',\n    month: 'short',\n  });\n\nexport const printDayOfTheWeek = (day: number) => {\n  switch (day) {\n    case 0:\n      return 'Sun';\n    case 1:\n      return 'Mon';\n    case 2:\n      return 'Tue';\n    case 3:\n      return 'Wed';\n    case 4:\n      return 'Thu';\n    case 5:\n      return 'Fri';\n    case 6:\n      return 'Sat';\n  }\n};\n\nexport const getTimeAgo = (timeValue: string | number) => {\n  const date = new Date(timeValue).getTime();\n  if (Number.isNaN(date)) {\n    throw new Error('Invalid date');\n  }\n  const diff = Math.floor((Date.now() - date) / 1000);\n  let interval;\n  for (const key in periodValues) {\n    interval = Math.floor(diff / periodValues[key]);\n    if (interval >= 1) {\n      const pluralValue = interval > 1 ? 's' : '';\n      return `${interval} ${key}${pluralValue} ago`;\n    }\n  }\n\n  return 'Just Now';\n};\n","type MapObjIndexedFn<T, U> = (\n  value: T,\n  key: string,\n  obj: Record<string, T>,\n) => U;\n\nexport const mapObjIndexed = <T, U>(\n  fn: MapObjIndexedFn<T, U>,\n  obj: Record<string, T>,\n): Record<string, U> => {\n  return Object.keys(obj).reduce((result: Record<string, U>, key: string) => {\n    result[key] = fn(obj[key], key, obj);\n    return result;\n  }, {});\n};\n","import { GenerateRangeFn } from './types';\n\n/**\n * The function that returns an array of page numbers to show in the pagination\n * component.\n *\n * Rules:\n * - To always show the 1st and the last page.\n * - To show one item before and one item after the selected page.\n * - To return \"-1\" for the skipped items. This is to be able to display \"...\" in\n * the pagination component.\n * */\nconst SKIPPED_ITEMS_DELTA = 2;\n\nconst getSelectedRange = (pagesCount: number, selectedPage: number) => {\n  const range: number[] = [];\n\n  if (selectedPage !== pagesCount) {\n    range.push(selectedPage);\n  }\n\n  if (selectedPage > 1) {\n    range.unshift(selectedPage - 1);\n  }\n\n  if (selectedPage + 1 < pagesCount) {\n    range.push(selectedPage + 1);\n  }\n\n  return range;\n};\n\nconst fill = (range: number[], minValue: number, maxValue: number) => {\n  for (let i = minValue; i < maxValue; ++i) {\n    range.push(i);\n  }\n};\n\nconst generateRange: GenerateRangeFn = (pagesCount, selectedPage) => {\n  if (pagesCount == null || !Number.isInteger(pagesCount)) {\n    throw new Error('Pages count should be an integer');\n  }\n\n  if (pagesCount <= 0) {\n    return [];\n  }\n\n  let range = [1];\n\n  if (pagesCount === 1) {\n    return range;\n  }\n\n  if (selectedPage != null && !Number.isInteger(selectedPage)) {\n    throw new Error('Selected page should be an integer');\n  }\n\n  if (selectedPage != null && (selectedPage < 1 || selectedPage > pagesCount)) {\n    throw new Error(`Selected page ${selectedPage} is out of range`);\n  }\n\n  if (selectedPage && selectedPage > 2) {\n    const selectedRange = getSelectedRange(pagesCount, selectedPage);\n\n    const [minSelectedRange, , maxSelectedRange] = selectedRange;\n\n    if (minSelectedRange - SKIPPED_ITEMS_DELTA > 1) {\n      range.push(-1);\n    } else {\n      fill(range, 2, minSelectedRange);\n    }\n\n    range = range.concat(selectedRange);\n\n    if (pagesCount - maxSelectedRange > SKIPPED_ITEMS_DELTA) {\n      range.push(-1);\n    } else {\n      fill(range, maxSelectedRange + 1, pagesCount);\n    }\n  } else if (pagesCount <= 5) {\n    fill(range, 2, pagesCount);\n  } else {\n    range.push(2, 3, -1);\n  }\n\n  range.push(pagesCount);\n\n  return range;\n};\n\nexport default generateRange;\n","export const assocPath =\n  <T>([first, ...rest]: string[], value: any) =>\n  (sourceObject: T): T =>\n    JSON.parse(\n      JSON.stringify({\n        ...sourceObject,\n        [first]: rest.length\n          ? assocPath(rest, value)((sourceObject as any)[first])\n          : value,\n      }),\n    ) as T;\n","export const dissocPath =\n  <T>(path: string[]) =>\n  (sourceObject: T): T => {\n    const resultObject = JSON.parse(JSON.stringify(sourceObject));\n\n    path.reduce((acc: any, key, index) => {\n      if (index === path.length - 1) {\n        delete acc[key];\n      }\n      return acc[key];\n    }, resultObject);\n\n    return resultObject;\n  };\n","export const path =\n  <T extends Record<string | number, any>, R>(path: string[]) =>\n  (obj: T): unknown =>\n    path.reduce((prev, curr: string | number) => prev?.[curr], obj);\n","import { path as originalPath } from './path';\n\nexport const pathOr =\n  <T extends Record<string | number, any>, R>(\n    defaultValue: any,\n    path: string[],\n  ) =>\n  (obj: T): R => {\n    const result = originalPath(path)(obj);\n    return result === null || result === undefined ? defaultValue : result;\n  };\n","export const prop =\n  <T extends Record<string | number, any>, R = any>(propName: string) =>\n  (obj: T): R =>\n    obj?.[propName];\n","import { prop } from './prop';\n\nexport const propOr =\n  <T extends Record<string | number, any>, R = any>(\n    defaultValue: any,\n    propName: string,\n  ) =>\n  (obj: T): R => {\n    const result = prop(propName)(obj);\n    return result === null || result === undefined ? defaultValue : result;\n  };\n"],"names":["root","factory","exports","module","define","amd","self","__webpack_require__","definition","key","o","Object","defineProperty","enumerable","get","obj","prop","prototype","hasOwnProperty","call","Symbol","toStringTag","value","callAll","fns","args","forEach","fn","throttle","delayMs","isThrottled","savedArgs","timeoutId","throttledFn","setTimeout","clearTimeout","debounce","func","wait","executedFunction","postponedFn","dayOfWeekNames","periodValues","year","month","week","day","hour","min","formatTime","timestampMs","Date","toLocaleTimeString","minute","formatDayOfWeek","getDay","formatDate","toLocaleDateString","printDayOfTheWeek","getTimeAgo","timeValue","date","getTime","Number","isNaN","Error","diff","Math","floor","now","interval","mapObjIndexed","keys","reduce","result","fill","range","minValue","maxValue","i","push","generateRange","pagesCount","selectedPage","isInteger","selectedRange","getSelectedRange","unshift","minSelectedRange","maxSelectedRange","concat","assocPath","first","rest","sourceObject","JSON","parse","stringify","length","dissocPath","path","resultObject","acc","index","prev","curr","pathOr","defaultValue","originalPath","propName","propOr"],"sourceRoot":""}

package/dist/utils/CallAll.d.ts

@@ -0,0 +1 @@
+export declare const callAll: (...fns: any[]) => (...args: any) => void;

package/dist/utils/dates/dateFormatters.d.ts

@@ -0,0 +1,5 @@
+export declare const formatTime: (timestampMs: number) => string;
+export declare const formatDayOfWeek: (timestampMs: number) => string;
+export declare const formatDate: (timestampMs: number) => string;
+export declare const printDayOfTheWeek: (day: number) => "Sun" | "Mon" | "Tue" | "Wed" | "Thu" | "Fri" | "Sat" | undefined;
+export declare const getTimeAgo: (timeValue: string | number) => string;

package/dist/utils/dates/dates.spec.d.ts

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

package/dist/utils/dates/index.d.ts

@@ -0,0 +1 @@
+export * as dateFormatters from './dateFormatters';

package/dist/utils/debounce/debounce.d.ts

@@ -0,0 +1,3 @@
+type UnknownFn = (...args: any[]) => unknown;
+export declare const debounce: (func: UnknownFn, wait?: number) => ((...args: any[]) => void)[];
+export {};

package/dist/utils/debounce/debounce.spec.d.ts

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

package/dist/utils/debounce/index.d.ts

@@ -0,0 +1 @@
+export { debounce } from './debounce';

package/dist/utils/objects/assocPath.d.ts

@@ -0,0 +1 @@
+export declare const assocPath: <T>([first, ...rest]: string[], value: any) => (sourceObject: T) => T;

package/dist/utils/objects/assocPath.spec.d.ts

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

package/dist/utils/objects/dissocPath.d.ts

@@ -0,0 +1 @@
+export declare const dissocPath: <T>(path: string[]) => (sourceObject: T) => T;

package/dist/utils/objects/dissocPath.spec.d.ts

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

package/dist/utils/objects/index.d.ts

@@ -0,0 +1,7 @@
+export * from './mapObjIndexed';
+export * from './assocPath';
+export * from './dissocPath';
+export * from './path';
+export * from './pathOr';
+export * from './prop';
+export * from './propOr';

package/dist/utils/objects/mapObjIndexed.d.ts

@@ -0,0 +1,3 @@
+type MapObjIndexedFn<T, U> = (value: T, key: string, obj: Record<string, T>) => U;
+export declare const mapObjIndexed: <T, U>(fn: MapObjIndexedFn<T, U>, obj: Record<string, T>) => Record<string, U>;
+export {};

package/dist/utils/objects/mapObjIndexed.spec.d.ts

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

package/dist/utils/objects/path.d.ts

@@ -0,0 +1 @@
+export declare const path: <T extends Record<string | number, any>, R>(path: string[]) => (obj: T) => unknown;

package/dist/utils/objects/path.spec.d.ts

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

package/dist/utils/objects/pathOr.d.ts

@@ -0,0 +1 @@
+export declare const pathOr: <T extends Record<string | number, any>, R>(defaultValue: any, path: string[]) => (obj: T) => R;

package/dist/utils/objects/pathOr.spec.d.ts

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

package/dist/utils/objects/prop.d.ts

@@ -0,0 +1 @@
+export declare const prop: <T extends Record<string | number, any>, R = any>(propName: string) => (obj: T) => R;

package/dist/utils/objects/prop.spec.d.ts

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

package/dist/utils/objects/propOr.d.ts

@@ -0,0 +1 @@
+export declare const propOr: <T extends Record<string | number, any>, R = any>(defaultValue: any, propName: string) => (obj: T) => R;

package/dist/utils/objects/propOr.spec.d.ts

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

package/dist/utils/pagination/generateRange.d.ts

@@ -0,0 +1,3 @@
+import { GenerateRangeFn } from './types';
+declare const generateRange: GenerateRangeFn;
+export default generateRange;

package/dist/utils/pagination/generateRange.spec.d.ts

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

package/dist/utils/pagination/index.d.ts

@@ -0,0 +1 @@
+export { default as generateRange } from './generateRange';

package/dist/utils/pagination/types.d.ts

@@ -0,0 +1 @@
+export type GenerateRangeFn = (pagesCount: number, selectedPage?: number) => Array<number>;

package/dist/utils/throttle/index.d.ts

@@ -0,0 +1 @@
+export { throttle } from './throttle';

package/dist/utils/throttle/throttle.d.ts

@@ -0,0 +1,4 @@
+type UnknownFn = (...args: any[]) => unknown;
+type ThrottleFn = (fn: UnknownFn, delayMs: number) => [(...args: unknown[]) => void, () => void];
+export declare const throttle: ThrottleFn;
+export {};

package/dist/utils/throttle/throttle.spec.d.ts

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

package/dist/utils/types.d.ts

@@ -0,0 +1,4 @@
+export type PathValue = string | number | boolean | null;
+export interface PathObject {
+    [key: string | number]: PathValue | PathObject;
+}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@ssa-ui-kit/utils",
+  "version": "0.0.1-alpha",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "private": false,
+  "sideEffects": false,
+  "author": "SSA Group",
+  "license": "MIT",
+  "description": "SSA UI Kit utilities",
+  "keywords": [
+    "react",
+    "SSA UI Kit",
+    "utils"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ssagroup/ui-kit.git",
+    "directory": "packages/utils"
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^5.16.5",
+    "extend-expect": "^1.0.2",
+    "resolve-tspaths": "^0.8.16",
+    "terser-webpack-plugin": "^5.3.9",
+    "webpack": "^5.85.0"
+  },
+  "browserslist": [
+    ">0.1%",
+    "not dead",
+    "not op_mini all"
+  ],
+  "scripts": {
+    "build": "webpack --mode=production --node-env=production && tsc --build --force ./tsconfig.build.json && resolve-tspaths -p ./tsconfig.build.json",
+    "ts-show-config": "tsc --showConfig -p ./tsconfig.json",
+    "ts-show-config-build": "tsc --showConfig -p ./tsconfig.build.json",
+    "ts-check": "tsc -p ./tsconfig.json",
+    "ts-check-build": "tsc -p ./tsconfig.build.json"
+  }
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export { callAll } from './utils/CallAll';
+export { throttle } from './utils/throttle';
+export * from './utils/debounce';
+export * as dateFormatters from './utils/dates/dateFormatters';
+export { mapObjIndexed } from './utils/objects/mapObjIndexed';
+export { generateRange } from './utils/pagination';
+export * from './utils/objects';
+export * from './utils/types';

package/src/utils/CallAll.ts

@@ -0,0 +1,5 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export const callAll =
+  (...fns: any[]) =>
+  (...args: any) =>
+    fns.forEach((fn) => fn?.(...args));

package/src/utils/dates/dateFormatters.ts

@@ -0,0 +1,61 @@
+const dayOfWeekNames = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+const periodValues: Record<string, number> = {
+  year: 31536000,
+  month: 2592000,
+  week: 604800,
+  day: 86400,
+  hour: 3600,
+  min: 60,
+};
+
+export const formatTime = (timestampMs: number) =>
+  new Date(timestampMs).toLocaleTimeString('en-US', {
+    hour: '2-digit',
+    minute: '2-digit',
+  });
+
+export const formatDayOfWeek = (timestampMs: number) =>
+  dayOfWeekNames[new Date(timestampMs).getDay()];
+
+export const formatDate = (timestampMs: number) =>
+  new Date(timestampMs).toLocaleDateString('en-US', {
+    day: '2-digit',
+    month: 'short',
+  });
+
+export const printDayOfTheWeek = (day: number) => {
+  switch (day) {
+    case 0:
+      return 'Sun';
+    case 1:
+      return 'Mon';
+    case 2:
+      return 'Tue';
+    case 3:
+      return 'Wed';
+    case 4:
+      return 'Thu';
+    case 5:
+      return 'Fri';
+    case 6:
+      return 'Sat';
+  }
+};
+
+export const getTimeAgo = (timeValue: string | number) => {
+  const date = new Date(timeValue).getTime();
+  if (Number.isNaN(date)) {
+    throw new Error('Invalid date');
+  }
+  const diff = Math.floor((Date.now() - date) / 1000);
+  let interval;
+  for (const key in periodValues) {
+    interval = Math.floor(diff / periodValues[key]);
+    if (interval >= 1) {
+      const pluralValue = interval > 1 ? 's' : '';
+      return `${interval} ${key}${pluralValue} ago`;
+    }
+  }
+
+  return 'Just Now';
+};

package/src/utils/dates/dates.spec.tsx

@@ -0,0 +1,127 @@
+import { dateFormatters } from './index';
+
+const { getTimeAgo } = dateFormatters;
+const date = Date.now();
+const timeValuesArr = [
+  {
+    input: date - 6000,
+    output: 'Just Now',
+  },
+  {
+    input: date - 60000,
+    output: '1 min ago',
+  },
+  {
+    input: date - 120000,
+    output: '2 mins ago',
+  },
+  {
+    input: date - 6000000,
+    output: '1 hour ago',
+  },
+  {
+    input: date - 8000000,
+    output: '2 hours ago',
+  },
+  {
+    input: date - 120000000,
+    output: '1 day ago',
+  },
+  {
+    input: date - 240000000,
+    output: '2 days ago',
+  },
+  {
+    input: date - 1200000000,
+    output: '1 week ago',
+  },
+  {
+    input: date - 1400000000,
+    output: '2 weeks ago',
+  },
+  {
+    input: date - 3000000000,
+    output: '1 month ago',
+  },
+  {
+    input: date - 6000000000,
+    output: '2 months ago',
+  },
+  {
+    input: date - 36000000000,
+    output: '1 year ago',
+  },
+  {
+    input: date - 64000000000,
+    output: '2 years ago',
+  },
+];
+
+describe('dates', () => {
+  describe('dateFormatters', () => {
+    const testDateMs = 1681228541711; // 2023-04-11 16:55 GMT+0
+
+    describe('formatTime()', () => {
+      it('formats epoch ms as a time string', () => {
+        const result = dateFormatters.formatTime(testDateMs);
+        expect(result).toEqual('04:55 PM');
+      });
+    });
+
+    describe('formatDayOfWeek()', () => {
+      it('formats epoch ms as a day of week string', () => {
+        const result = dateFormatters.formatDayOfWeek(testDateMs);
+        expect(result).toEqual('Tue');
+      });
+    });
+
+    describe('formatDate()', () => {
+      it('formats epoch ms as a date string', () => {
+        const result = dateFormatters.formatDate(testDateMs);
+        expect(result).toEqual('Apr 11');
+      });
+    });
+
+    describe('printDayOfTheWeek()', () => {
+      it('translate getDay() code to string', () => {
+        const sunday = dateFormatters.printDayOfTheWeek(0);
+        expect(sunday).toEqual('Sun');
+
+        const monday = dateFormatters.printDayOfTheWeek(1);
+        expect(monday).toEqual('Mon');
+
+        const tuesday = dateFormatters.printDayOfTheWeek(2);
+        expect(tuesday).toEqual('Tue');
+
+        const wednesday = dateFormatters.printDayOfTheWeek(3);
+        expect(wednesday).toEqual('Wed');
+
+        const thursday = dateFormatters.printDayOfTheWeek(4);
+        expect(thursday).toEqual('Thu');
+
+        const friday = dateFormatters.printDayOfTheWeek(5);
+        expect(friday).toEqual('Fri');
+
+        const saturday = dateFormatters.printDayOfTheWeek(6);
+        expect(saturday).toEqual('Sat');
+      });
+    });
+
+    describe('getTimeAgo()', () => {
+      it('Returns an error when passing an invalid time value', () => {
+        expect(() => getTimeAgo('Date')).toThrow(new Error('Invalid date'));
+        expect(() => getTimeAgo('20-20-23')).toThrow(new Error('Invalid date'));
+        expect(() => getTimeAgo('1618301456781')).toThrow(
+          new Error('Invalid date'),
+        );
+      });
+
+      timeValuesArr.forEach((item) => {
+        const periodName = item.output.replace(/[0-9] | ago/g, '');
+        it(`Returns the "${periodName}"`, () => {
+          expect(getTimeAgo(item.input)).toEqual(item.output);
+        });
+      });
+    });
+  });
+});

package/src/utils/dates/index.ts

@@ -0,0 +1 @@
+export * as dateFormatters from './dateFormatters';

package/src/utils/debounce/debounce.spec.ts

@@ -0,0 +1,85 @@
+import { debounce } from '.';
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const callNTimes = (fn: any, n: number) => {
+  for (let i = 0; i < n; i++) {
+    fn();
+  }
+};
+
+describe('debounce', () => {
+  beforeEach(() => {
+    jest.useFakeTimers();
+    jest.spyOn(global, 'setTimeout');
+    jest.spyOn(global, 'clearTimeout');
+  });
+
+  afterAll(() => {
+    jest.useRealTimers();
+    jest.restoreAllMocks();
+  });
+
+  it('should cancel immediately without executing', () => {
+    const fn = jest.fn();
+    const [debouncedFn, cancel] = debounce(fn, 100);
+
+    debouncedFn();
+    // Cancel should not execute any pending call
+    cancel();
+    jest.advanceTimersByTime(150);
+    expect(fn).toHaveBeenCalledTimes(0);
+  });
+
+  it('should execute deferred function on the second time, after cancelling for the first time', () => {
+    const fn = jest.fn();
+    const [debouncedFn, cancel] = debounce(fn, 100);
+
+    debouncedFn();
+    // Cancel should not execute any pending call
+    cancel();
+    jest.advanceTimersByTime(150);
+    expect(fn).toHaveBeenCalledTimes(0);
+
+    debouncedFn();
+    jest.advanceTimersByTime(150);
+    expect(fn).toHaveBeenCalledTimes(1);
+  });
+
+  it('delays a function call', () => {
+    const fn = jest.fn();
+    const [debouncedFn, cancel] = debounce(fn, 100);
+
+    // Subsequent calls within the throttle window should be throttled
+    callNTimes(debouncedFn, 3);
+    jest.advanceTimersByTime(50);
+    expect(fn).toHaveBeenCalledTimes(0);
+    jest.advanceTimersByTime(500);
+    expect(fn).toHaveBeenCalledTimes(1);
+
+    // After the throttle window, the next call should execute
+    debouncedFn();
+
+    // Wait for the throttle window to pass
+    jest.advanceTimersByTime(500);
+    expect(fn).toHaveBeenCalledTimes(2);
+
+    // Calling the throttled function after cancel should execute
+    debouncedFn();
+    // ...but cancelled by triggering the cancel function
+    cancel();
+    expect(fn).toHaveBeenCalledTimes(2);
+  });
+
+  it('should debounce and execute the last call within debounce window', () => {
+    const fn = jest.fn();
+    const [debouncedFn] = debounce(fn, 100);
+
+    callNTimes(debouncedFn, 3);
+    jest.advanceTimersByTime(100);
+    expect(fn).toHaveBeenCalledTimes(1);
+
+    debouncedFn();
+    jest.advanceTimersByTime(150);
+    expect(fn).toHaveBeenCalledTimes(2);
+  });
+});

package/src/utils/debounce/debounce.ts

@@ -0,0 +1,24 @@
+type UnknownFn = (...args: any[]) => unknown;
+
+export const debounce = (func: UnknownFn, wait = 200) => {
+  let timeoutId: NodeJS.Timeout | null = null;
+  const executedFunction = (...args: any[]) => {
+    const postponedFn = () => {
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+      }
+      func(...args);
+    };
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+    timeoutId = setTimeout(postponedFn, wait);
+  };
+
+  const cancel = function () {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+  };
+  return [executedFunction, cancel];
+};

package/src/utils/debounce/index.ts

@@ -0,0 +1 @@
+export { debounce } from './debounce';

package/src/utils/objects/assocPath.spec.tsx

@@ -0,0 +1,53 @@
+import { assocPath } from '.';
+
+describe('utils => objects => assocPath', () => {
+  it('assocPath should work', () => {
+    const data = {
+      a: {
+        name: 'a',
+        value: 1,
+      },
+      b: {
+        name: 'b',
+        value: 2,
+      },
+    };
+    const result = assocPath(['c', 'name'], 'c')(data);
+    expect(result).toEqual({
+      a: {
+        name: 'a',
+        value: 1,
+      },
+      b: {
+        name: 'b',
+        value: 2,
+      },
+      c: {
+        name: 'c',
+      },
+    });
+  });
+  it('assocPath should not change source object', () => {
+    const data = {
+      a: {
+        name: 'a',
+        value: 1,
+      },
+      b: {
+        name: 'b',
+        value: 2,
+      },
+    };
+    assocPath(['c', 'name'], 'c')(data);
+    expect(data).toEqual({
+      a: {
+        name: 'a',
+        value: 1,
+      },
+      b: {
+        name: 'b',
+        value: 2,
+      },
+    });
+  });
+});

package/src/utils/objects/assocPath.ts

@@ -0,0 +1,11 @@
+export const assocPath =
+  <T>([first, ...rest]: string[], value: any) =>
+  (sourceObject: T): T =>
+    JSON.parse(
+      JSON.stringify({
+        ...sourceObject,
+        [first]: rest.length
+          ? assocPath(rest, value)((sourceObject as any)[first])
+          : value,
+      }),
+    ) as T;