@webitel/api-services 26.8.32 → 26.8.33

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@webitel/api-services",
-	"version": "26.8.32",
+	"version": "26.8.33",
 	"private": false,
 	"repository": {
 		"type": "git",
@@ -72,6 +72,7 @@
 	},
 	"dependencies": {
 		"date-fns": "^4.1.0",
+		"date-fns-tz": "^3.2.0",
 		"lodash-es": "^4.17.21",
 		"qs-esm": "^7.0.2"
 	},

package/src/api/clients/activeCalls/__tests__/activeCalls.spec.ts

@@ -0,0 +1,51 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+
+const time = 123;
+
+const searchActiveCall = vi.fn(() =>
+	Promise.resolve({
+		data: {
+			items: [
+				{
+					created_at: time,
+					duration: 0,
+				},
+			],
+			next: false,
+		},
+	}),
+);
+
+vi.mock('../../../../gen-wire', async (importOriginal) => ({
+	...(await importOriginal<Record<string, unknown>>()),
+	getCallService: () => ({
+		searchActiveCall,
+	}),
+}));
+
+const { FormatDateMode } = await import('../../../../enums');
+const { convertDuration } = await import('../../../../scripts');
+const { formatDate } = await import('../../../../utils');
+const { ActiveCallsAPI } = await import('../activeCalls');
+
+/**
+ * getList owns the display formatting: createdAt as a full DATETIME and
+ * duration through the shared convertDuration helper.
+ */
+describe('ActiveCallsAPI.getList', () => {
+	beforeEach(() => searchActiveCall.mockClear());
+
+	it('formats duration and createdAt on each item', async () => {
+		const response = await ActiveCallsAPI.getList({});
+
+		expect(response).toEqual({
+			items: [
+				{
+					createdAt: formatDate(+time, FormatDateMode.DATETIME),
+					duration: convertDuration(0),
+				},
+			],
+			next: false,
+		});
+	});
+});

package/src/api/clients/activeCalls/activeCalls.ts

@@ -1,4 +1,7 @@
+import { FormatDateMode } from '../../../enums';
 import { getCallService } from '../../../gen-wire';
+import { convertDuration } from '../../../scripts';
+import { formatDate } from '../../../utils';
 import { getDefaultGetListResponse, getDefaultGetParams } from '../../defaults';
 import {
 	applyTransform,
@@ -9,10 +12,7 @@ import {
 } from '../../transformers';
 import type { ApiParams } from '../_shared/types';
 
-/**
- * Calls currently in progress. Durations and timestamps come back raw;
- * formatting them is the caller's job.
- */
+/** Calls currently in progress. */
 const getActiveCallsList = async (params: ApiParams) => {
 	const {
 		page,
@@ -34,6 +34,14 @@ const getActiveCallsList = async (params: ApiParams) => {
 		starToSearch('search'),
 	]);
 
+	const listResponseHandler = (items: ApiParams[]) => {
+		return items.map((item) => ({
+			...item,
+			duration: convertDuration(Number(item.duration ?? 0)),
+			createdAt: formatDate(Number(item.createdAt), FormatDateMode.DATETIME),
+		}));
+	};
+
 	try {
 		const response = await getCallService().searchActiveCall({
 			page,
@@ -57,7 +65,9 @@ const getActiveCallsList = async (params: ApiParams) => {
 			merge(getDefaultGetListResponse()),
 		]);
 		return {
-			items,
+			items: applyTransform(items, [
+				listResponseHandler,
+			]),
 			next,
 		};
 	} catch (err) {

package/src/enums/FormatDateMode/FormatDateMode.ts

@@ -0,0 +1,10 @@
+export const FormatDateMode = {
+	DATE: 'date',
+	TIME: 'time',
+	TIME_SEC: 'timeSec',
+	DATETIME: 'datetime',
+	DATETIME_SHORT: 'datetimeShort',
+} as const;
+
+export type FormatDateMode =
+	(typeof FormatDateMode)[keyof typeof FormatDateMode];

package/src/enums/index.ts

@@ -1,5 +1,6 @@
 import { CallReportingStatus } from './CallReportingStatus/CallReportingStatus';
 import { ChatGatewayProvider } from './ChatGatewayProvider/ChatGatewayPrivider';
+import { FormatDateMode } from './FormatDateMode/FormatDateMode';
 import { MemberStopCause } from './MemberStopCause/MemberStopCause';
 import {
 	QueueStrategy,
@@ -13,6 +14,7 @@ import { TypesResourceStrategy } from './TypesResourceStrategy/TypesResourceStra
 export {
 	CallReportingStatus,
 	ChatGatewayProvider,
+	FormatDateMode,
 	MemberStopCause,
 	QueueStrategy,
 	QueueStrategyList,

package/src/utils/formatDate.ts

@@ -0,0 +1,44 @@
+import { uk } from 'date-fns/locale';
+import { formatInTimeZone } from 'date-fns-tz';
+
+import type { FormatDateMode } from '../enums/FormatDateMode/FormatDateMode';
+
+/**
+ * Mirrors @webitel/ui-sdk's Userinfo TIMEZONE_STORAGE_KEY constant —
+ * duplicated here rather than imported to avoid a circular dependency
+ * (api-services must not depend on ui-sdk). Keep the literal in sync with
+ * ui-sdk/src/modules/Userinfo/constants/UserSettingsConstants.ts.
+ */
+const TIMEZONE_STORAGE_KEY = 'user-timezone-setting';
+
+function getUserTimeZone(): string {
+	return (
+		localStorage.getItem(TIMEZONE_STORAGE_KEY) ||
+		Intl.DateTimeFormat().resolvedOptions().timeZone
+	);
+}
+
+// https://date-fns.org/v4.1.0/docs/format
+const formatStringMap = {
+	date: 'P', // dd.MM.yyyy (13.11.2025)
+	time: 'p', // HH:mm (15:53)
+	timeSec: 'pp', // HH:mm:ss (15:53:00)
+	datetime: 'Ppp', // dd.MM.yyyy, HH:mm:ss (13.11.2025, 15:53:00)
+	datetimeShort: 'Pp', // dd.MM.yyyy, HH:mm (13.11.2025, 15:53)
+};
+
+export function formatDate(
+	date: string | number | Date,
+	to: (typeof FormatDateMode)[keyof typeof FormatDateMode],
+	{
+		timezone = undefined,
+	}: {
+		timezone?: string;
+	} = {},
+): string {
+	const timeZone = timezone ?? getUserTimeZone();
+
+	return formatInTimeZone(date, timeZone, formatStringMap[to], {
+		locale: uk,
+	});
+}

package/src/utils/index.ts

@@ -1,2 +1,3 @@
 export * from './api';
+export * from './formatDate';
 export * from './gen';