@webitel/ui-sdk 26.6.95 → 26.6.97

package/src/enums/WtObject/WtObject.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Represents existing Webitel entities
+ */
+export declare const WtObject: {
+	readonly Agent: 'agent';
+	readonly Queue: 'queue';
+	readonly Contact: 'contact';
+	readonly Region: 'region';
+	readonly User: 'user';
+	readonly Resource: 'resource';
+	readonly Device: 'device';
+	readonly License: 'license';
+	readonly Flow: 'flow';
+	readonly Dialplan: 'dialplan';
+	readonly Gateway: 'gateway';
+	readonly Chatplan: 'chatplan';
+	readonly ChatGateway: 'chatGateway';
+	readonly Blacklist: 'blacklist';
+	readonly Calendar: 'calendar';
+	readonly Communication: 'communication';
+	readonly PauseCause: 'pauseCause';
+	readonly Media: 'media';
+	readonly ShiftTemplate: 'shiftTemplate';
+	readonly PauseTemplate: 'pauseTemplate';
+	readonly WorkingCondition: 'workingCondition';
+	readonly Skill: 'skill';
+	readonly Bucket: 'bucket';
+	readonly Member: 'member';
+	readonly ResourceGroup: 'resourceGroup';
+	readonly Team: 'team';
+	readonly Storage: 'storage';
+	readonly CognitiveProfile: 'cognitiveProfile';
+	readonly EmailProfile: 'emailProfile';
+	readonly SingleSignOn: 'singleSignOn';
+	readonly ImportCsv: 'importCsv';
+	readonly Trigger: 'trigger';
+	readonly Role: 'role';
+	readonly Object: 'object';
+	readonly ChangeLog: 'changelog';
+	readonly Configuration: 'configuration';
+	readonly GlobalVariable: 'globalVariable';
+	readonly Call: 'call';
+	readonly RecordFile: 'recordFile';
+	readonly ContactGroup: 'contactGroup';
+	readonly Case: 'case';
+	readonly CaseComment: 'caseComment';
+	readonly Slas: 'slas';
+	readonly ServiceCatalog: 'serviceCatalog';
+	readonly CaseSource: 'caseSource';
+	readonly CloseReasonGroup: 'closeReasonGroup';
+	readonly Priorities: 'priorities';
+	readonly Status: 'status';
+	readonly Source: 'source';
+	readonly CustomLookup: 'customLookup';
+	readonly AuditForm: 'auditForm';
+	readonly AuditRating: 'auditRating';
+	readonly QuickReply: 'quickReply';
+	readonly ListNumber: 'listNumber';
+	readonly AgentWorkingCondition: 'agentWorkingCondition';
+	readonly FilePolicy: 'filePolicy';
+	readonly PortalUser: 'portalUser';
+};
+export type WtObject = (typeof WtObject)[keyof typeof WtObject];

package/src/enums/WtTypeExtensionFieldKind/WtTypeExtensionFieldKind.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @name FieldType
+ * @description Enumerates (ONLY!) the types of field type.
+ */
+export declare const WtTypeExtensionFieldKind: {
+	readonly Text: 'string';
+	readonly Number: 'int32';
+	readonly Select: 'lookup';
+	readonly Multiselect: 'list';
+	readonly Calendar: 'datetime';
+	readonly Boolean: 'bool';
+};
+export type ExtensionFieldType =
+	(typeof WtTypeExtensionFieldKind)[keyof typeof WtTypeExtensionFieldKind];

package/src/enums/index.d.ts

@@ -0,0 +1,88 @@
+import AbstractUserStatus from './AbstractUserStatus/AbstractUserStatus.enum.js';
+import AgentStatus from './AgentStatus/AgentStatus.enum.js';
+import { BroadcastChannelName } from './BroadcastChannelName/BroadcastChannelName';
+import type {
+	UserSettingsBroadcastMessage,
+	WebphoneBroadcastMessage,
+	WebphoneBroadcastPayload,
+} from './BroadcastChannelName/UserSettingsBroadcastMessage';
+import { ButtonColor } from './ButtonColor/ButtonColor';
+import { ButtonVariant } from './ButtonVariant/ButtonVariant';
+import ChatGatewayProvider from './ChatGatewayProvider/ChatGatewayProvider.enum.js';
+import ProviderIconType from './ChatGatewayProvider/ProviderIconType.enum';
+import { ChipColor } from './ChipColor/ChipColor';
+import { ComponentSize } from './ComponentSize/ComponentSize';
+import {
+	ConnectionQualityLevels,
+	type ConnectionQualityLevelsType,
+} from './ConnectionQualityLevel/ConnectionQualityLevel.enum';
+import { CrudAction } from './CrudAction/CrudAction';
+import { DefaultWorkspaceTabSettings } from './DefaultWorkspaceTabSettings/DefaultWorkspaceTabSettings';
+import { EmptyCause } from './EmptyCause/EmptyCause';
+import { FormatDateMode } from './FormatDateMode/FormatDateMode';
+import IconAction from './IconAction/IconAction.enum.js';
+import { IconColor } from './IconColor/IconColor';
+import { LoginOptions } from './LoginOptions/LoginOptions';
+import { MessageColor } from './MessageColor/MessageColor';
+import { MessageVariant } from './MessageVariant/MessageVariant';
+import { MimeTypes } from './MimeTypes/MimeTypes.enum';
+import { ProcessingTableColumnType } from './ProcessingTableColumnType/ProcessingTableColumnType';
+import { QueueType, QueueTypeName } from './QueueType/QueueType.enum';
+import { RelativeDatetimeValue } from './RelativeDatetimeValue/RelativeDatetimeValue';
+import { RingtoneType } from './RingtoneType/RingtoneType.js';
+import { SingleSignOnProvider } from './SingleSignOnProvider/SingleSignOnProvider';
+import { SingleSignOnProviderIconMappings } from './SingleSignOnProviderIconMappings/SingleSignOnProviderIconMappings';
+import TypesExportedSettings from './TypesExportedSettings/TypesExportedSettings.enum.js';
+import { AdminSections } from './WebitelApplications/AdminSections';
+import { AuditorSections } from './WebitelApplications/AuditorSections';
+import { CrmSections } from './WebitelApplications/CrmSections';
+import { SupervisorSections } from './WebitelApplications/SupervisorSections';
+import { WfmSections } from './WebitelApplications/WfmSections';
+import { WtApplication } from './WebitelApplications/WtApplication';
+import { WtObject } from './WtObject/WtObject';
+import { WtTypeExtensionFieldKind } from './WtTypeExtensionFieldKind/WtTypeExtensionFieldKind';
+
+export type {
+	ConnectionQualityLevelsType,
+	UserSettingsBroadcastMessage,
+	WebphoneBroadcastMessage,
+	WebphoneBroadcastPayload,
+};
+export {
+	AbstractUserStatus,
+	AdminSections,
+	AgentStatus,
+	AuditorSections,
+	BroadcastChannelName,
+	ButtonColor,
+	ButtonVariant,
+	ChatGatewayProvider,
+	ChipColor,
+	ComponentSize,
+	ConnectionQualityLevels,
+	CrmSections,
+	CrudAction,
+	DefaultWorkspaceTabSettings,
+	EmptyCause,
+	FormatDateMode,
+	IconAction,
+	IconColor,
+	LoginOptions,
+	MessageColor,
+	MessageVariant,
+	MimeTypes,
+	ProcessingTableColumnType,
+	ProviderIconType,
+	QueueType,
+	QueueTypeName,
+	RelativeDatetimeValue,
+	RingtoneType,
+	SingleSignOnProvider,
+	SingleSignOnProviderIconMappings,
+	SupervisorSections,
+	TypesExportedSettings,
+	WfmSections,
+	WtApplication,
+	WtObject,
+	WtTypeExtensionFieldKind,
+};

package/src/install.ts

@@ -7,6 +7,7 @@ import './css/tailwind.css';
 import { generateInstance } from '@webitel/api-services/api/axios';
 import { fillIconsRepository } from './assets/icons';
 import Components from './components'; // init all components
+import { EVENT_BUS_INJECTION_KEY } from './composables/useEventBus/useEventBus';
 import Directives from './directives'; // init all directives
 import initPrimevue from './plugins/primevue/primevue.plugin';
 
@@ -23,7 +24,7 @@ export default {
 		Object.keys(globals).forEach((globalKey) => {
 			app.provide(globalKey, globals[globalKey]);
 		});
-		app.provide('$eventBus', eventBus);
+		app.provide(EVENT_BUS_INJECTION_KEY, eventBus);
 		initPrimevue(app);
 	},
 	generateInstance,

package/src/mixins/validationMixin/regle/useRegleValidation.ts

@@ -2,23 +2,23 @@ import type { RegleFieldStatus } from '@regle/core';
 import { type ComputedRef, computed, type Ref } from 'vue';
 
 export type UseFieldValidationParams = {
-	field: Ref<RegleFieldStatus<string>>;
+	field?: Ref<RegleFieldStatus<string>>;
 };
 
 export type UseFieldValidationReturn = {
 	invalid: ComputedRef<boolean | null>; // null if is not validated
-	validationText?: ComputedRef<string>;
+	validationText?: ComputedRef<string | undefined>;
 };
 
 export const useFieldValidation = ({
 	field: fieldRef,
 }: UseFieldValidationParams): UseFieldValidationReturn => {
 	const invalid = computed(() => {
-		return fieldRef.value.$error;
+		return fieldRef?.value.$error ?? null;
 	});
 
 	const validationText = computed(() => {
-		return fieldRef.value?.$errors?.at(0);
+		return fieldRef?.value?.$errors?.at(0);
 	});
 
 	return {

package/src/mixins/validationMixin/useValidation.ts

@@ -10,15 +10,20 @@ import {
 	useFieldValidation as useVuelidateValidation,
 } from './vuelidate/useVuelidateValidation';
 
-type CompatVuelidateParams = {
-	v: UseVuelidateFieldValidationParams['field'];
+type UseValidationParams = {
+	/** vuelidate field validation (compat) */
+	v?: UseVuelidateFieldValidationParams['field'];
+	/** vuelidate custom validations (compat) */
+	customValidators?: UseVuelidateFieldValidationParams['customValidators'];
+	/** regle field validation */
+	regleValidation?: UseRegleFieldValidationParams['field'];
 };
 
 export const useValidation = ({
 	v: vuelidateValidation,
 	customValidators: inputCustomValidators, // vuelidate custom validations, compat
 	regleValidation,
-}: UseRegleFieldValidationParams | CompatVuelidateParams) => {
+}: UseValidationParams) => {
 	const {
 		isValidation: isVuelidateValidation,
 		invalid: vuelidateInvalid,

package/src/mixins/validationMixin/vuelidate/useVuelidateValidation.ts

@@ -1,10 +1,22 @@
 import type { Validation } from '@vuelidate/core';
-import { computed, isReactive, type Ref } from 'vue';
+import {
+	type ComputedRef,
+	computed,
+	isReactive,
+	isRef,
+	type Ref,
+	unref,
+} from 'vue';
 import { useI18n } from 'vue-i18n';
 
+type CompatCustomValidator = {
+	name: string;
+	text: string;
+};
+
 export type UseFieldValidationParams = {
-	field: Ref<Validation>;
-	customValidators?: Array<object>;
+	field?: Ref<Validation>;
+	customValidators?: CompatCustomValidator[];
 };
 
 export const useFieldValidation = ({
@@ -14,11 +26,15 @@ export const useFieldValidation = ({
 	const { t } = useI18n();
 
 	// support vue options api, where v is a reactive, not ref
-	let v = inputV;
-	let customValidators = inputCustomValidators;
+	let v: Ref<Validation> | ComputedRef<Validation | undefined> | undefined =
+		inputV;
+	let customValidators:
+		| CompatCustomValidator[]
+		| ComputedRef<CompatCustomValidator[] | undefined>
+		| undefined = inputCustomValidators;
 
-	if (isReactive(v)) {
-		v = computed(() => inputV);
+	if (isReactive(inputV)) {
+		v = computed(() => unref(inputV));
 		customValidators = computed(() => inputCustomValidators);
 	}
 	// end
@@ -26,66 +42,73 @@ export const useFieldValidation = ({
 	const isValidation = computed(
 		() => !!v && !!v.value && !!Object.keys(v.value).length,
 	);
-	const invalid = computed(() => isValidation.value && v.value.$error);
+	const invalid = computed(() => isValidation.value && v?.value?.$error);
 
 	const validationText = computed(() => {
 		let validationText = '';
-		if (isValidation.value && invalid.value) {
-			if (v.value.required?.$invalid) validationText = t('validation.required');
-			else if (v.value.numeric?.$invalid)
+		const validation = v?.value;
+		if (validation && isValidation.value && invalid.value) {
+			if (validation.required?.$invalid)
+				validationText = t('validation.required');
+			else if (validation.numeric?.$invalid)
 				validationText = t('validation.numeric');
-			else if (v.value.email?.$invalid) validationText = t('validation.email');
-			else if (v.value.gatewayHostValidator?.$invalid)
+			else if (validation.email?.$invalid)
+				validationText = t('validation.email');
+			else if (validation.gatewayHostValidator?.$invalid)
 				validationText = t('validation.gatewayHostValidator');
-			else if (v.value.ipValidator?.$invalid)
+			else if (validation.ipValidator?.$invalid)
 				validationText = t('validation.ipValidator');
-			else if (v.value.macValidator?.$invalid)
+			else if (validation.macValidator?.$invalid)
 				validationText = t('validation.macValidator');
-			else if (v.value.minValue?.$invalid)
+			else if (validation.minValue?.$invalid)
 				validationText = t('validation.minValue', {
-					min: v.value.minValue.$params.min,
+					min: validation.minValue.$params.min,
 				});
-			else if (v.value.maxValue?.$invalid)
+			else if (validation.maxValue?.$invalid)
 				validationText = t('validation.maxValue', {
-					max: v.value.maxValue.$params.max,
+					max: validation.maxValue.$params.max,
 				});
-			else if (v.value.maxLength?.$invalid)
+			else if (validation.maxLength?.$invalid)
 				validationText = t('validation.maxLength', {
-					max: v.value.maxLength.$params.max,
+					max: validation.maxLength.$params.max,
 				});
-			else if (v.value.sipAccountValidator?.$invalid)
+			else if (validation.sipAccountValidator?.$invalid)
 				validationText = t('validation.sipAccountValidator');
-			else if (v.value.minLength?.$invalid)
+			else if (validation.minLength?.$invalid)
 				validationText = t('validation.minLength', {
-					min: v.value.minLength.$params.min,
+					min: validation.minLength.$params.min,
 				});
-			else if (v.value.url?.$invalid) validationText = `${t('validation.url')}`;
-			else if (v.value.regExpValidator?.$invalid)
+			else if (validation.url?.$invalid)
+				validationText = `${t('validation.url')}`;
+			else if (validation.regExpValidator?.$invalid)
 				validationText = `${t('validation.regExpValidator')}`;
-			else if (v.value.sameAs?.$invalid)
+			else if (validation.sameAs?.$invalid)
 				validationText = `${t('validation.sameAs')}`;
-			else if (v.value.domainValidator?.$invalid)
+			else if (validation.domainValidator?.$invalid)
 				validationText = `${t('validation.domainValidator')}`;
-			else if (v.value.decimalValidator?.$invalid)
-				validationText = `${t('validation.decimalValidator')} ${v.value.decimalValidator.$params.count}`;
-			else if (v.value.websocketValidator?.$invalid)
+			else if (validation.decimalValidator?.$invalid)
+				validationText = `${t('validation.decimalValidator')} ${validation.decimalValidator.$params.count}`;
+			else if (validation.websocketValidator?.$invalid)
 				validationText = `${t('validation.websocketValidator')}`;
-			else if (v.value.integer?.$invalid)
+			else if (validation.integer?.$invalid)
 				validationText = `${t('validation.integer')}`;
-			else if (v.value.regex?.$invalid)
+			else if (validation.regex?.$invalid)
 				validationText =
-					v.value.regex?.$message ||
-					`${t('validation.isRegExpMatched')} ${v.value.regex?.$params?.regex}`;
-			else if (v.value.nameAlreadyInUse?.$invalid) {
+					validation.regex?.$message ||
+					`${t('validation.isRegExpMatched')} ${validation.regex?.$params?.regex}`;
+			else if (validation.nameAlreadyInUse?.$invalid) {
 				validationText = t('validation.nameAlreadyInUse');
-			} else if (v.value.phoneNumberSymbolsValidator?.$invalid) {
+			} else if (validation.phoneNumberSymbolsValidator?.$invalid) {
 				validationText = t('validation.phoneNumberSymbolsValidator');
 			}
 		}
 
-		if (customValidators?.value) {
-			for (const { name, text } of customValidators.value) {
-				if (v.value[name]?.$invalid) validationText = text;
+		const resolvedCustomValidators = isRef(customValidators)
+			? customValidators.value
+			: undefined;
+		if (resolvedCustomValidators) {
+			for (const { name, text } of resolvedCustomValidators) {
+				if (validation?.[name]?.$invalid) validationText = text;
 			}
 			return validationText;
 		}

package/src/modules/CSVExport/composables/useCSVExport.ts

@@ -41,7 +41,7 @@ export function useCSVExport({ selected }: { selected: Ref<number[]> }) {
 
 	async function exportCSV(exportParams?: Record<string, unknown>) {
 		const routeQuery = route.query;
-		const params = {
+		const params: Record<string, unknown> = {
 			...(exportParams || routeQuery),
 			size: CSV_EXPORT_BATCH_SIZE,
 		};

package/src/modules/CallSession/modules/ScreenSharing/screen-sharing.vue

@@ -34,8 +34,7 @@
 
 <script setup lang="ts">
 import { WtVidstackPlayer } from '@webitel/ui-sdk/components';
-import { defineEmits, useAttrs } from 'vue';
-
+import { useAttrs } from 'vue';
 import {
 	RecordingIndicator,
 	ScreenSharingControlsPanel,

package/src/modules/CallSession/modules/VideoCall/composables/useDocumentPiP/domTraversal.ts

@@ -5,12 +5,12 @@ export const domTraversal = (
 	if (root instanceof Element) {
 		visit(root);
 		if (root.shadowRoot) {
-			for (const child of root.shadowRoot.children) {
+			for (const child of Array.from(root.shadowRoot.children)) {
 				domTraversal(child, visit);
 			}
 		}
 	}
-	for (const child of root.children) {
+	for (const child of Array.from(root.children)) {
 		domTraversal(child, visit);
 	}
 };

package/src/modules/CallSession/modules/VideoCall/video-call.vue

@@ -274,7 +274,7 @@ const emitKeys = {
 	[VideoCallAction.Settings]: `action:${VideoCallAction.Settings}`,
 	[VideoCallAction.Chat]: `action:${VideoCallAction.Chat}`,
 	[VideoCallAction.Hangup]: `action:${VideoCallAction.Hangup}`,
-};
+} as const;
 
 const { t } = useI18n();
 

package/src/modules/CallSession/types/index.ts

@@ -1,4 +1,4 @@
-import { ScreenSharingSession } from './ScreenSharingSession';
-import { ScreenshotStatus } from './ScreenshotStatus';
+import type { ScreenSharingSession } from './ScreenSharingSession';
+import type { ScreenshotStatus } from './ScreenshotStatus';
 
-export { ScreenSharingSession, ScreenshotStatus };
+export type { ScreenSharingSession, ScreenshotStatus };

package/src/modules/UploadCsvPopup/composable/useUploadCsv.ts

@@ -20,7 +20,7 @@ const useUploadCsv = ({ props, emit, skipHeaders, separator }) => {
 	const parsedFile = ref(null);
 	const isParsingPreview = ref(false);
 	const parseErrorStackTrace = ref('');
-	const csvPreview = ref([
+	const csvPreview = ref<unknown[]>([
 		[],
 	]);
 

package/src/modules/UploadCsvPopup/scripts/parseCSV.ts

@@ -1,6 +1,6 @@
 import { parse } from 'csv-parse/browser/esm';
 
-const parseCSV = (csvStr, options = {}) =>
+const parseCSV = (csvStr, options = {}): Promise<unknown[]> =>
 	new Promise((resolve, reject) => {
 		parse(
 			csvStr,

package/src/modules/UserNotifications/maps/userNotificationConfigsMap.ts

@@ -1,21 +1,24 @@
-import { ApiUserWarningId } from '@webitel/api-services/gen/models';
+import {
+	type ApiUserWarning,
+	ApiUserWarningId,
+} from '@webitel/api-services/gen/models';
 import type { NotificationsType } from '../types/UserNotifications';
 
 const HOURS_IN_DAY = 24;
 
 export const USER_NOTIFICATION_CONFIGS_MAP = new Map<
 	ApiUserWarningId,
-	(warningId: ApiUserWarningId) => NotificationsType
+	(warning: ApiUserWarning) => NotificationsType
 >([
 	[
 		ApiUserWarningId.PasswordExpiresSoon,
 		({ warningData: data }) => ({
 			type: 'info',
-			localeKey: data.passwordExpiry.daysRemaining
+			localeKey: data?.passwordExpiry?.daysRemaining
 				? 'passwordExpirationMessageDays'
 				: 'passwordExpirationMessageHours',
 			params: {
-				amount: data.passwordExpiry.daysRemaining || HOURS_IN_DAY,
+				amount: data?.passwordExpiry?.daysRemaining || HOURS_IN_DAY,
 			},
 		}),
 	],
@@ -25,8 +28,8 @@ export const USER_NOTIFICATION_CONFIGS_MAP = new Map<
 			type: 'info',
 			localeKey: 'licenseExpirationSoonMessage',
 			params: {
-				amount: data.licenseExpiry.daysRemaining,
-				name: data.licenseExpiry.licenseName,
+				amount: data?.licenseExpiry?.daysRemaining,
+				name: data?.licenseExpiry?.licenseName,
 			},
 		}),
 	],
@@ -36,7 +39,7 @@ export const USER_NOTIFICATION_CONFIGS_MAP = new Map<
 			type: 'info',
 			localeKey: 'licenseExpirationMessage',
 			params: {
-				name: data.licenseExpiry.licenseName,
+				name: data?.licenseExpiry?.licenseName,
 			},
 		}),
 	],

package/src/modules/UserNotifications/stores/userNotificationsStore.ts

@@ -59,6 +59,7 @@ export const createUserNotificationsStore = () => {
 		const mapNotifications = (array: ApiUserWarning[]) => {
 			return array
 				.map((warning) => {
+					if (!warning.id) return null;
 					const map = USER_NOTIFICATION_CONFIGS_MAP.get(warning.id);
 					if (!map) return null;
 					return map(warning);

package/src/modules/UserNotifications/types/UserNotifications.ts

@@ -1,5 +1,6 @@
 interface UserNotificationsConfigsParams {
-	amount?: number;
+	/** generated API types serialize int64 counters as strings */
+	amount?: number | string;
 	name?: string;
 }
 

package/src/modules/Userinfo/constants/UserSettingsConstants.d.ts

@@ -0,0 +1 @@
+export declare const TIMEZONE_STORAGE_KEY = 'user-timezone-setting';

package/src/scripts/__tests__/isEmpty.spec.js

@@ -1,4 +1,4 @@
-import isEmpty from '../isEmpty.js';
+import isEmpty from '../isEmpty';
 
 describe('isEmpty', () => {
 	it('falsy cases (not empty)', () => {

package/src/scripts/downloadFile/types/downloadFile.types.ts

@@ -1,7 +1,13 @@
 import type { FileFormat } from './fileFormat.types';
 
+/** Minimal shape of the (axios-style) HTTP response consumed by `downloadFile`. */
+export interface DownloadFileResponse {
+	data: BlobPart;
+	headers?: Record<string, string | undefined>;
+}
+
 export interface DownloadFileOptions {
-	response: never;
+	response: DownloadFileResponse;
 	fileFormat: FileFormat;
 	filename?: string;
 	mimetype?: string;

package/src/scripts/index.js

@@ -22,7 +22,7 @@ import downloadFile from './downloadFile/downloadFile';
 import eventBus from './eventBus.js';
 import { getConnectionQuality } from './getConnectionQuality.ts';
 import { getEndOfDay, getStartOfDay } from './getDefaultFilterDate.js';
-import isEmpty from './isEmpty.js';
+import isEmpty from './isEmpty';
 import { wtlog } from './logger.js';
 import {
 	isRelativeDatetimeValue,

package/src/scripts/{isEmpty.js → isEmpty.ts}

@@ -1,6 +1,15 @@
+type EmptyValue =
+	| undefined
+	| null
+	| ''
+	| 0
+	| false
+	| never[]
+	| Record<PropertyKey, never>;
+
 // checks if value is Falsy,
 // including empty arrays or objects
-const isEmpty = (value) => {
+const isEmpty = <T>(value: T): value is Extract<T, EmptyValue> => {
 	if (Array.isArray(value)) return !value.length;
 	if (typeof value === 'object') return !value || !Object.keys(value).length;
 	return !value;

package/src/scripts/normalizeDatetime.ts

@@ -24,8 +24,10 @@ export type NormalizeDatetimeOptions = {
 	round?: RelativeDatetimeRoundOption;
 };
 
-export const isRelativeDatetimeValue = (value: string): boolean => {
-	return Object.values(RelativeDatetimeValue).includes(value);
+export const isRelativeDatetimeValue = (
+	value: string,
+): value is RelativeDatetimeValue => {
+	return (Object.values(RelativeDatetimeValue) as string[]).includes(value);
 };
 
 const convertRelativeDatetimeToTimestamp = (

package/src/utils/displayText.d.ts

@@ -0,0 +1,2 @@
+export declare const EMPTY_SYMBOL = '-';
+export declare const displayText: (text: string) => string;

package/src/utils/formatDate.d.ts

@@ -0,0 +1,10 @@
+import type { FormatDateMode } from '../enums';
+export declare function formatDate(
+	date: string | number | Date,
+	to: (typeof FormatDateMode)[keyof typeof FormatDateMode],
+	{
+		timezone,
+	}?: {
+		timezone?: string;
+	},
+): string;

package/src/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './displayText';
+export * from './formatDate';