@webitel/ui-sdk 25.4.52 → 25.4.54

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [v25.4.53] - 2025-04-04
+### :sparkles: New Features
+- [`d91de3c`](https://github.com/webitel/webitel-ui-sdk/commit/d91de3ce5cd6d6001519569a7f09ce50fe664219) - ui-datalist/ createdAt filter [WTEL-6512](https://webitel.atlassian.net/browse/WTEL-6512) *(commit by [@dlohvinov](https://github.com/dlohvinov))*
+
+### :bug: Bug Fixes
+- [`202b03a`](https://github.com/webitel/webitel-ui-sdk/commit/202b03ae2f5d8e0bacfa8bacb4999946a824ac4b) - search in api[WTEL-6567](https://webitel.atlassian.net/browse/WTEL-6567) *(commit by [@Lera24](https://github.com/Lera24))*
+
+
+## [v25.4.52] - 2025-04-03
+### :sparkles: New Features
+- [`8497209`](https://github.com/webitel/webitel-ui-sdk/commit/8497209e0a720302242feaf5a2038248f4f0727f) - added new locale and new icon for postprocessing form *(commit by [@liza-pohranichna](https://github.com/liza-pohranichna))*
+
+
 ## [v25.4.51] - 2025-04-03
 ### :bug: Bug Fixes
 - [`c87b176`](https://github.com/webitel/webitel-ui-sdk/commit/c87b1768de47753ceeb18045a200ded352b8405b) - delete enter days in timepicker component[WTEL-6651](https://webitel.atlassian.net/browse/WTEL-6651) *(commit by [@Lera24](https://github.com/Lera24))*
@@ -1814,3 +1827,5 @@
 [v25.4.48]: https://github.com/webitel/webitel-ui-sdk/compare/v25.4.47...v25.4.48
 [v25.4.49]: https://github.com/webitel/webitel-ui-sdk/compare/v25.4.48...v25.4.49
 [v25.4.51]: https://github.com/webitel/webitel-ui-sdk/compare/v25.4.50...v25.4.51
+[v25.4.52]: https://github.com/webitel/webitel-ui-sdk/compare/v25.4.51...v25.4.52
+[v25.4.53]: https://github.com/webitel/webitel-ui-sdk/compare/v25.4.52...v25.4.53

package/package.json

@@ -1,82 +1,60 @@
 {
   "name": "@webitel/ui-sdk",
-  "version": "25.4.52",
+  "version": "25.4.54",
   "private": false,
   "scripts": {
     "dev": "npm run docs:dev",
     "build": "vite build",
     "test:unit": "vitest",
-
     "publish-lib": "npm run build && npm publish --access public",
-
     "docs:dev": "vitepress dev docs --port 8080",
     "docs:build": "vitepress build docs",
-
     "lint:fix": "eslint --fix ./src && prettier --write --check ./src",
     "lint:fix-staged": "npx lint-staged",
     "lint:package": "publint",
-
     "orval": "orval",
     "tsc": "tsc -p tsconfig.json",
-
     "utils:link": "npm link",
     "utils:update-node": "nvm install --lts && nvm alias default node",
-    "utils:i": "npm install",
-
-    "prepare": "husky && husky install"
+    "utils:i": "npm install"
   },
   "main": "./dist/ui-sdk.js",
   "type": "module",
   "exports": {
     ".": "./dist/ui-sdk.js",
-
-    "./store": "./src/store/new/index.js",
-    "./store*":  "./src/store*",
-    "./src/store*":  "./src/store*",
-
-    "./enums": "./src/enums/index.js",
-    "./enums*":  "./src/enums*",
-    "./src/enums*":  "./src/enums*",
-
-    "./components": "./src/components/index.js",
-    "./components*":  "./src/components*",
-    "./src/components*":  "./src/components*",
-
-    "./scripts":  "./src/scripts/index.js",
-    "./scripts*":  "./src/scripts*",
-    "./src/scripts*":  "./src/scripts*",
-
-    "./api*":  "./src/api*",
-    "./src/api*":  "./src/api*",
-
-    "./locale*":  "./src/locale*",
-    "./src/locale*":  "./src/locale*",
-
-    "./composables*":  "./src/composables*",
-    "./src/composables*":  "./src/composables*",
-
-    "./css*":  "./src/css*",
-    "./src/css*":  "./src/css*",
-
-    "./directives*":  "./src/directives*",
-    "./src/directives*":  "./src/directives*",
-
-    "./mixins*":  "./src/mixins*",
-    "./src/mixins*":  "./src/mixins*",
-
-    "./validators*":  "./src/validators*",
-    "./src/validators*":  "./src/validators*",
-
-    "./modules*":  "./src/modules*",
-    "./src/modules*":  "./src/modules*",
-
-    "./plugins*":  "./src/plugins*",
-    "./src/plugins*":  "./src/plugins*",
-
-    "./tests*":  "./src/tests*",
-    "./src/tests*":  "./src/tests*",
-
-    "./dist*":  "./dist*"
+    "./store": "./src/store/new/index",
+    "./store*": "./src/store*",
+    "./src/store*": "./src/store*",
+    "./enums": "./src/enums/index",
+    "./enums*": "./src/enums*",
+    "./src/enums*": "./src/enums*",
+    "./components": "./src/components/index",
+    "./components*": "./src/components*",
+    "./src/components*": "./src/components*",
+    "./scripts": "./src/scripts/index",
+    "./scripts*": "./src/scripts*",
+    "./src/scripts*": "./src/scripts*",
+    "./api*": "./src/api*",
+    "./src/api*": "./src/api*",
+    "./locale*": "./src/locale*",
+    "./src/locale*": "./src/locale*",
+    "./composables*": "./src/composables*",
+    "./src/composables*": "./src/composables*",
+    "./css*": "./src/css*",
+    "./src/css*": "./src/css*",
+    "./directives*": "./src/directives*",
+    "./src/directives*": "./src/directives*",
+    "./mixins*": "./src/mixins*",
+    "./src/mixins*": "./src/mixins*",
+    "./validators*": "./src/validators*",
+    "./src/validators*": "./src/validators*",
+    "./modules*": "./src/modules*",
+    "./src/modules*": "./src/modules*",
+    "./plugins*": "./src/plugins*",
+    "./src/plugins*": "./src/plugins*",
+    "./tests*": "./src/tests*",
+    "./src/tests*": "./src/tests*",
+    "./dist*": "./dist*"
   },
   "files": [
     "dist/*",

package/src/api/clients/caseCloseReasonGroups/caseCloseReasonGroups.js

@@ -12,7 +12,6 @@ import applyTransform, {
   notify,
   sanitize,
   snakeToCamel,
-  starToSearch,
 } from '../../transformers/index.js';
 
 const instance = getDefaultInstance();
@@ -31,7 +30,6 @@ const getCloseReasonGroupsList = async (params) => {
 
   const { page, size, fields, sort, id, q } = applyTransform(params, [
     merge(getDefaultGetParams()),
-    starToSearch('search'),
     (params) => ({ ...params, q: params.search }),
     sanitize(fieldsToSend),
     camelToSnake(),

package/src/api/clients/caseCloseReasons/caseCloseReasons.js

@@ -12,7 +12,6 @@ import applyTransform, {
   notify,
   sanitize,
   snakeToCamel,
-  starToSearch,
 } from '../../transformers/index.js';
 
 const instance = getDefaultInstance();
@@ -31,7 +30,6 @@ const getCloseReasonsList = async ({ parentId, ...rest }) => {
 
   const { page, size, fields, sort, id, q } = applyTransform(rest, [
     merge(getDefaultGetParams()),
-    starToSearch('search'),
     (params) => ({ ...params, q: params.search }),
     sanitize(fieldsToSend),
     camelToSnake(),

package/src/api/clients/casePriorities/casePriorities.js

@@ -12,7 +12,6 @@ import applyTransform, {
   notify,
   sanitize,
   snakeToCamel,
-  starToSearch,
 } from '../../transformers/index.js';
 
 const instance = getDefaultInstance();
@@ -45,7 +44,6 @@ const getPrioritiesList = async (params) => {
     in_sla_cond: inSlaCond,
   } = applyTransform(params, [
     merge(getDefaultGetParams()),
-    starToSearch('search'),
     (params) => ({ ...params, q: params.search }),
     sanitize(fieldsToSend),
     camelToSnake(),

package/src/api/clients/caseSources/caseSources.js

@@ -12,7 +12,6 @@ import applyTransform, {
   notify,
   sanitize,
   snakeToCamel,
-  starToSearch,
 } from '../../transformers/index.js';
 
 const instance = getDefaultInstance();
@@ -34,7 +33,6 @@ const getSourcesList = async (params) => {
 
   const { page, size, fields, sort, id, q, type } = applyTransform(params, [
     merge(getDefaultGetParams()),
-    starToSearch('search'),
     (params) => ({ ...params, q: params.search }),
     sanitize(fieldsToSend),
     camelToSnake(),

package/src/api/clients/caseStatusConditions/caseStatusConditions.js

@@ -12,7 +12,6 @@ import applyTransform, {
   notify,
   sanitize,
   snakeToCamel,
-  starToSearch,
 } from '../../transformers/index.js';
 
 const instance = getDefaultInstance();
@@ -31,7 +30,6 @@ const getStatusConditionsList = async ({ parentId, ...rest }) => {
 
   const { page, size, fields, sort, id, q } = applyTransform(rest, [
     merge(getDefaultGetParams()),
-    starToSearch('search'),
     (params) => ({ ...params, q: params.search }),
     sanitize(fieldsToSend),
     camelToSnake(),

package/src/api/clients/caseStatuses/caseStatuses.js

@@ -12,7 +12,6 @@ import applyTransform, {
   notify,
   sanitize,
   snakeToCamel,
-  starToSearch,
 } from '../../transformers/index.js';
 
 const instance = getDefaultInstance();
@@ -27,7 +26,6 @@ const getStatusesList = async (params) => {
 
   const { page, size, fields, sort, id, q } = applyTransform(params, [
     merge(getDefaultGetParams()),
-    starToSearch('search'),
     (params) => ({ ...params, q: params.search }),
     sanitize(fieldsToSend),
     camelToSnake(),

package/src/api/clients/slaConditions/slaConditions.js

@@ -12,7 +12,6 @@ import applyTransform, {
   notify,
   sanitize,
   snakeToCamel,
-  starToSearch,
 } from '../../transformers/index.js';
 
 const instance = getDefaultInstance();
@@ -55,7 +54,6 @@ const getConditionsList = async ({ parentId, ...rest }) => {
     priority_id: priorityId,
   } = applyTransform(rest, [
     merge(getDefaultGetParams()),
-    starToSearch('search'),
     (params) => ({ ...params, q: params.search }),
     sanitize(fieldsToSend),
     camelToSnake(),

package/src/api/clients/slas/slas.js

@@ -12,7 +12,6 @@ import applyTransform, {
   notify,
   sanitize,
   snakeToCamel,
-  starToSearch,
 } from '../../transformers/index.js';
 
 const instance = getDefaultInstance();
@@ -35,7 +34,6 @@ const getSlasList = async (params) => {
 
   const { page, size, fields, sort, id, q } = applyTransform(params, [
     merge(getDefaultGetParams()),
-    starToSearch('search'),
     (params) => ({ ...params, q: params.search }),
     sanitize(fieldsToSend),
     camelToSnake(),

package/src/enums/RelativeDatetimeValue/RelativeDatetimeValue.ts

@@ -0,0 +1,11 @@
+const valuePrefix = 'rdt'; /* stands for relative datetime */
+
+export const RelativeDatetimeValue = {
+  Today: `${valuePrefix}_today`,
+  ThisWeek: `${valuePrefix}_this_week`,
+  ThisMonth: `${valuePrefix}_this_month`,
+  Custom: `${valuePrefix}_custom`,
+} as const;
+
+export type RelativeDatetimeValue =
+  (typeof RelativeDatetimeValue)[keyof typeof RelativeDatetimeValue];

package/src/enums/index.js

@@ -5,6 +5,7 @@ import { ComponentSize } from './ComponentSize/ComponentSize';
 import { CrudAction } from './CrudAction/CrudAction';
 import IconAction from './IconAction/IconAction.enum.js';
 import QueueType from './QueueType/QueueType.enum.js';
+import { RelativeDatetimeValue } from './RelativeDatetimeValue/RelativeDatetimeValue';
 import TypesExportedSettings from './TypesExportedSettings/TypesExportedSettings.enum.js';
 import { AdminSections } from './WebitelApplications/AdminSections';
 import { AuditorSections } from './WebitelApplications/AuditorSections';
@@ -13,6 +14,7 @@ import { SupervisorSections } from './WebitelApplications/SupervisorSections';
 import WebitelApplications from './WebitelApplications/WebitelApplications.enum.js';
 import { WtApplication } from './WebitelApplications/WtApplication';
 import { WtObject } from './WtObject/WtObject';
+
 export {
   AbstractUserStatus,
   AdminSections,
@@ -24,6 +26,7 @@ export {
   CrudAction,
   IconAction,
   QueueType,
+  RelativeDatetimeValue,
   SupervisorSections,
   TypesExportedSettings,
   WebitelApplications,

package/src/enums/index.ts

@@ -5,6 +5,7 @@ import { ComponentSize } from './ComponentSize/ComponentSize';
 import { CrudAction } from './CrudAction/CrudAction';
 import IconAction from './IconAction/IconAction.enum.js';
 import QueueType from './QueueType/QueueType.enum.js';
+import { RelativeDatetimeValue } from './RelativeDatetimeValue/RelativeDatetimeValue';
 import TypesExportedSettings from './TypesExportedSettings/TypesExportedSettings.enum.js';
 import { AdminSections } from './WebitelApplications/AdminSections';
 import { AuditorSections } from './WebitelApplications/AuditorSections';
@@ -25,6 +26,7 @@ export {
   CrudAction,
   IconAction,
   QueueType,
+  RelativeDatetimeValue,
   SupervisorSections,
   TypesExportedSettings,
   WebitelApplications,

package/src/locale/en/en.js

@@ -6,16 +6,19 @@ import {
   EngineRoutingSchemaType,
 } from 'webitel-sdk';
 
-import { IconAction } from '../../enums';
-import ChatGatewayProvider from '../../enums/ChatGatewayProvider/ChatGatewayProvider.enum.js';
-import QueueType from '../../enums/QueueType/QueueType.enum.js';
-import AdminSections from '../../enums/WebitelApplications/AdminSections.enum.js';
-import AuditorSections from '../../enums/WebitelApplications/AuditorSections.enum.js';
-import CrmSections from '../../enums/WebitelApplications/CrmSections.enum.js';
-import SupervisorSections from '../../enums/WebitelApplications/SupervisorSections.enum.js';
-import WebitelApplications from '../../enums/WebitelApplications/WebitelApplications.enum.js';
+import {
+  SupervisorSections,
+  WebitelApplications,
+  CrmSections,
+  AuditorSections,
+  AdminSections,
+  QueueType,
+  IconAction,
+  RelativeDatetimeValue,
+  ChatGatewayProvider,
+} from '../../enums';
+import { snakeToCamel } from '../../scripts';
 import { AccessMode } from '../../modules/ObjectPermissions/_internals/enums/AccessMode.enum.js';
-import { snakeToCamel } from '../../scripts/caseConverters.js';
 
 export default {
   // describes reusable buttons, actions, default titles, and other ui elements
@@ -62,7 +65,7 @@ export default {
     retry: 'Retry',
     downloadAll: 'Download all',
     warning: 'Warning',
-    doNotSave: "Don't save",
+    doNotSave: 'Don\'t save',
     required: 'Required',
     copy: 'Copy',
     new: 'New',
@@ -150,6 +153,9 @@ export default {
     grantor: 'Grantor | Grantors',
     role: 'Role | Roles',
     user: 'User | Users',
+    list: 'List | Lists',
+    contact: 'Contact | Contacts',
+    case: 'Case | Cases',
     calendar: 'Calendar | Calendars',
     direction: 'Direction',
     gateway: 'Gateway | Gateways',
@@ -425,10 +431,12 @@ export default {
         [IconAction.SAVE]: ({ linked }) => linked('reusable.save'),
         [IconAction.CANCEL]: ({ linked }) => linked('reusable.cancel'),
         [IconAction.SAVE_PRESET]: ({ linked }) => {
-          return `${linked('reusable.save')} ${linked('webitelUI.filters.presets.preset').toLowerCase()}`;
+          return `${linked('reusable.save')} ${linked('webitelUI.filters.presets.preset')
+          .toLowerCase()}`;
         },
         [IconAction.APPLY_PRESET]: ({ linked }) => {
-          return `${linked('vocabulary.apply')} ${linked('webitelUI.filters.presets.preset').toLowerCase()}`;
+          return `${linked('vocabulary.apply')} ${linked('webitelUI.filters.presets.preset')
+          .toLowerCase()}`;
         },
       },
     },
@@ -439,8 +447,8 @@ export default {
         text: 'Sorry, you have not enough privileges to see this page.',
       },
       page404: {
-        title: "Looks like you're lost",
-        text: "Sorry, we can't find the page you want.",
+        title: 'Looks like you\'re lost',
+        text: 'Sorry, we can\'t find the page you want.',
       },
     },
     copyAction: {
@@ -494,12 +502,11 @@ export default {
       exportToJson: 'Export to JSON',
     },
     filters: {
-      predefinedLabels: {
-        /* https://webitel.atlassian.net/browse/WTEL-6308?focusedCommentId=657415 */
-        createdAt: {
-          startOfToday: 'From the start of today',
-          startOfMonth: 'From this month',
-        },
+      datetime: {
+        [RelativeDatetimeValue.Today]: 'Today',
+        [RelativeDatetimeValue.ThisWeek]: 'This week',
+        [RelativeDatetimeValue.ThisMonth]: 'This month',
+        [RelativeDatetimeValue.Custom]: 'Custom date range',
       },
       addFilter: ({ linked }) => {
         return `${linked('reusable.add')} a ${linked(
@@ -550,6 +557,9 @@ export default {
       contactGroup: ({ linked }) => {
         return linked('cases.groupPerformers');
       },
+      createdAt: ({ linked }) => {
+        return linked('reusable.createdAt');
+      },
       createdAtFrom: ({ linked }) => {
         return linked('reusable.from');
       },

package/src/locale/ru/ru.js

@@ -6,16 +6,19 @@ import {
   EngineRoutingSchemaType,
 } from 'webitel-sdk';
 
-import { IconAction } from '../../enums';
-import ChatGatewayProvider from '../../enums/ChatGatewayProvider/ChatGatewayProvider.enum.js';
-import QueueType from '../../enums/QueueType/QueueType.enum.js';
-import AdminSections from '../../enums/WebitelApplications/AdminSections.enum.js';
-import AuditorSections from '../../enums/WebitelApplications/AuditorSections.enum.js';
-import CrmSections from '../../enums/WebitelApplications/CrmSections.enum.js';
-import SupervisorSections from '../../enums/WebitelApplications/SupervisorSections.enum.js';
-import WebitelApplications from '../../enums/WebitelApplications/WebitelApplications.enum.js';
+import {
+  AdminSections,
+  AuditorSections,
+  ChatGatewayProvider,
+  CrmSections,
+  IconAction,
+  QueueType,
+  RelativeDatetimeValue,
+  SupervisorSections,
+  WebitelApplications,
+} from '../../enums';
 import { AccessMode } from '../../modules/ObjectPermissions/_internals/enums/AccessMode.enum.js';
-import { snakeToCamel } from '../../scripts/caseConverters.js';
+import { snakeToCamel } from '../../scripts';
 
 export default {
   // describes reusable buttons, actions, default titles, and other ui elements
@@ -148,6 +151,9 @@ export default {
     grantee: 'Владелец прав | Владельцы прав',
     grantor: 'Праводатель | Праводатели',
     user: 'Пользователь | Пользователи',
+    list: 'Список | Списки',
+    contact: 'Контакт | Контакты',
+    case: 'Обращение | Обращения',
     role: 'Роль | Роли',
     calendar: 'Календарь | Календари',
     direction: 'Направление',
@@ -492,12 +498,11 @@ export default {
       exportToJson: 'Экспортировать в JSON',
     },
     filters: {
-      predefinedLabels: {
-        /* https://webitel.atlassian.net/browse/WTEL-6308?focusedCommentId=657415 */
-        createdAt: {
-          startOfToday: 'С начала дня',
-          startOfMonth: 'С начала этого месяца',
-        },
+      datetime: {
+        [RelativeDatetimeValue.Today]: 'Сегодня',
+        [RelativeDatetimeValue.ThisWeek]: 'Эта неделя',
+        [RelativeDatetimeValue.ThisMonth]: 'Этот месяц',
+        [RelativeDatetimeValue.Custom]: 'Выбранный диапазон дат',
       },
       addFilter: ({ linked }) => {
         return `${linked('reusable.add')} ${linked(
@@ -548,6 +553,9 @@ export default {
       contactGroup: ({ linked }) => {
         return linked('cases.groupPerformers');
       },
+      createdAt: ({ linked }) => {
+        return linked('reusable.createdAt');
+      },
       createdAtFrom: ({ linked }) => {
         return linked('reusable.from');
       },

package/src/locale/ua/ua.js

@@ -6,16 +6,19 @@ import {
   EngineRoutingSchemaType,
 } from 'webitel-sdk';
 
-import { IconAction } from '../../enums';
-import ChatGatewayProvider from '../../enums/ChatGatewayProvider/ChatGatewayProvider.enum.js';
-import QueueType from '../../enums/QueueType/QueueType.enum.js';
-import AdminSections from '../../enums/WebitelApplications/AdminSections.enum.js';
-import AuditorSections from '../../enums/WebitelApplications/AuditorSections.enum.js';
-import CrmSections from '../../enums/WebitelApplications/CrmSections.enum.js';
-import SupervisorSections from '../../enums/WebitelApplications/SupervisorSections.enum.js';
-import WebitelApplications from '../../enums/WebitelApplications/WebitelApplications.enum.js';
+import {
+  AdminSections,
+  AuditorSections,
+  ChatGatewayProvider,
+  CrmSections,
+  IconAction,
+  QueueType,
+  RelativeDatetimeValue,
+  SupervisorSections,
+  WebitelApplications,
+} from '../../enums';
 import { AccessMode } from '../../modules/ObjectPermissions/_internals/enums/AccessMode.enum.js';
-import { snakeToCamel } from '../../scripts/caseConverters.js';
+import { snakeToCamel } from '../../scripts';
 
 export default {
   // describes reusable buttons, actions, default titles, and other ui elements
@@ -148,6 +151,9 @@ export default {
     grantee: 'Власник прав | Власники прав',
     grantor: 'Надавач | Надавачі',
     user: 'Користувач | Користувачі',
+    list: 'Список | Списки',
+    contact: 'Контакт | Контакти',
+    case: 'Звернення | Звернення',
     role: 'Роль | Ролі',
     calendar: 'Календар | Календарі',
     direction: 'Напрямок',
@@ -492,12 +498,11 @@ export default {
       exportToJson: 'Експортувати в JSON',
     },
     filters: {
-      predefinedLabels: {
-        /* https://webitel.atlassian.net/browse/WTEL-6308?focusedCommentId=657415 */
-        createdAt: {
-          startOfToday: 'Від початку дня',
-          startOfMonth: 'Від початку місяця',
-        },
+      datetime: {
+        [RelativeDatetimeValue.Today]: 'Сьогодні',
+        [RelativeDatetimeValue.ThisWeek]: 'Цей тиждень',
+        [RelativeDatetimeValue.ThisMonth]: 'Цей місяць',
+        [RelativeDatetimeValue.Custom]: 'Власний діапазон дат',
       },
       addFilter: ({ linked }) => {
         return `${linked('reusable.add')} ${linked(
@@ -548,6 +553,9 @@ export default {
       contactGroup: ({ linked }) => {
         return linked('cases.groupPerformers');
       },
+      createdAt: ({ linked }) => {
+        return linked('reusable.createdAt');
+      },
       createdAtFrom: ({ linked }) => {
         return linked('reusable.from');
       },

package/src/scripts/index.js

@@ -21,6 +21,10 @@ import debounce from './debounce.js';
 import eventBus from './eventBus.js';
 import isEmpty from './isEmpty.js';
 import { wtlog } from './logger.js';
+import {
+  isRelativeDatetimeValue,
+  normalizeToTimestamp,
+} from './normalizeDatetime';
 import prettifyFileSize from './prettifyFileSize.js';
 import prettifyTime from './prettifyTime.js';
 import preventHiddenPageCallsDecorator from './preventHiddenPageCallsDecorator.js';
@@ -38,8 +42,10 @@ export {
   debounce,
   eventBus,
   isEmpty,
+  isRelativeDatetimeValue,
   kebabToCamel,
   kebabToSnake,
+  normalizeToTimestamp,
   objCamelToKebab,
   objCamelToSnake,
   objSnakeToCamel,

package/src/scripts/normalizeDatetime.ts

@@ -0,0 +1,77 @@
+import {
+  endOfMonth,
+  endOfToday,
+  endOfWeek,
+  startOfMonth,
+  startOfToday,
+  startOfWeek,
+} from 'date-fns';
+
+import { RelativeDatetimeValue } from '../enums';
+
+export type RelativeDatetimeRoundOption =
+  | 'start'
+  | 'end'; /* for "from" or "to" */
+
+export type NormalizeDatetimeValueParam =
+  | RelativeDatetimeValue
+  | number
+  | string
+  | null
+  | undefined;
+
+export type NormalizeDatetimeOptions = {
+  round?: RelativeDatetimeRoundOption;
+};
+
+export const isRelativeDatetimeValue = (value: string): boolean => {
+  return Object.values(RelativeDatetimeValue).includes(value);
+};
+
+const convertRelativeDatetimeToTimestamp = (
+  relativeValue: RelativeDatetimeValue,
+  options?: NormalizeDatetimeOptions,
+): number => {
+  if (options?.round === 'end') {
+    switch (relativeValue) {
+      case RelativeDatetimeValue.Today:
+        return endOfToday().getTime();
+      case RelativeDatetimeValue.ThisWeek:
+        return endOfWeek(Date.now()).getTime();
+      case RelativeDatetimeValue.ThisMonth:
+        return endOfMonth(Date.now()).getTime();
+      default:
+        return Date.now();
+    }
+  } else {
+    switch (relativeValue) {
+      case RelativeDatetimeValue.Today:
+        return startOfToday().getTime();
+      case RelativeDatetimeValue.ThisWeek:
+        return startOfWeek(Date.now()).getTime();
+      case RelativeDatetimeValue.ThisMonth:
+        return startOfMonth(Date.now()).getTime();
+      default:
+        return Date.now();
+    }
+  }
+};
+
+export const normalizeToTimestamp = (
+  value?: NormalizeDatetimeValueParam,
+  options: NormalizeDatetimeOptions = {},
+): number => {
+  if (value == null) {
+    return 0;
+  } else if (typeof value === 'number') {
+    return value;
+  } else if (isRelativeDatetimeValue(value)) {
+    return convertRelativeDatetimeToTimestamp(value, options);
+  } else if (typeof value === 'string') {
+    if (+value) {
+      return +value;
+    }
+  } else {
+    return Date.now();
+  }
+};