@webitel/api-services 26.8.56 → 26.8.57

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@webitel/api-services",
-	"version": "26.8.56",
+	"version": "26.8.57",
 	"private": false,
 	"repository": {
 		"type": "git",

package/src/api/clients/agents/__tests__/agentStatusStatistics.spec.ts

@@ -0,0 +1,45 @@
+import { describe, expect, it, vi } from 'vitest';
+
+const searchAgentStatusStatistic = vi.fn(() =>
+	Promise.resolve({
+		data: {
+			items: [
+				{},
+			],
+		},
+	}),
+);
+
+vi.mock('../../../../gen-wire', async (importOriginal) => ({
+	...(await importOriginal<Record<string, unknown>>()),
+	getAgentService: () => ({
+		searchAgentStatusStatistic,
+	}),
+}));
+
+const { AgentsAPI } = await import('../agents');
+
+const expectItems = [
+	{
+		_isSelected: false,
+		missed: 0,
+		transferred: 0,
+		statusDuration: '00:00:00',
+		utilization: '0.00%',
+		online: '00:00:00',
+		offline: '00:00:00',
+		pause: '00:00:00',
+		callTime: '00:00:00',
+		chatTime: '00:00:00',
+		occupancy: '0.00%',
+	},
+];
+
+describe('AgentsAPI.getStatusStatistics', () => {
+	it('formats the raw response', async () => {
+		const response = await AgentsAPI.getStatusStatistics({});
+
+		expect(response.items).toEqual(expectItems);
+		expect(response.next).toBe(false);
+	});
+});

package/src/api/clients/agents/agents.ts

@@ -215,11 +215,51 @@ const deleteAgent = async ({ id }: DeleteItemParams) => {
 	}
 };
 
-/**
- * Per-agent status/occupancy statistics over a time window — the supervisor
- * agents table. Durations come back raw; formatting them is the caller's job.
- */
+/** Per-agent status/occupancy statistics over a time window — the supervisor agents table. */
 const getAgentStatusStatistics = async (params: ApiParams) => {
+	const defaultParams = {
+		search: '',
+		sort: '+name',
+		fields: [],
+		from: new Date().setHours(0, 0, 0, 0),
+		to: new Date().setHours(23, 59, 59, 999),
+		utilizationFrom: '0',
+	};
+
+	const defaultObject = {
+		offline: 0,
+		online: 0,
+		pause: 0,
+		statusDuration: 0,
+		transferred: 0,
+		missed: 0,
+		utilization: 0,
+		occupancy: 0,
+		callTime: 0,
+		chatTime: 0,
+	};
+
+	const listResponseHandler = (items: ApiParams[]) => {
+		return items.map((item) => {
+			const merged = {
+				...defaultObject,
+				...item,
+			};
+			return {
+				...merged,
+				_isSelected: false,
+				statusDuration: convertStatusDuration(merged.statusDuration),
+				utilization: `${merged.utilization.toFixed(2)}%`,
+				occupancy: `${merged.occupancy.toFixed(2)}%`,
+				online: convertDuration(merged.online),
+				offline: convertDuration(merged.offline),
+				pause: convertDuration(merged.pause),
+				callTime: convertDuration(merged.callTime),
+				chatTime: convertDuration(merged.chatTime),
+			};
+		});
+	};
+
 	const {
 		page,
 		size,
@@ -229,7 +269,6 @@ const getAgentStatusStatistics = async (params: ApiParams) => {
 		fields,
 		from,
 		to,
-		status,
 		queue,
 		team,
 		skill,
@@ -237,9 +276,13 @@ const getAgentStatusStatistics = async (params: ApiParams) => {
 		auditor,
 		region,
 		utilizationFrom,
-		utilizationTo,
+		// the filter is named after the progress bar it drives
+		utilizationProgress,
+		// the generated param is `status`; `agentStatus` is what the datalist store sends
+		agentStatus,
 		callNow,
 	} = applyTransform(params, [
+		merge(defaultParams),
 		merge(getDefaultGetParams()),
 	]);
 
@@ -252,13 +295,13 @@ const getAgentStatusStatistics = async (params: ApiParams) => {
 			sort,
 			fields,
 			agent_id: ids,
-			'time.from': from,
-			'time.to': to,
-			status,
+			'time.from': from == null ? undefined : String(from),
+			'time.to': to == null ? undefined : String(to),
+			status: agentStatus,
 			queue_id: queue,
 			team_id: team,
 			'utilization.from': utilizationFrom,
-			'utilization.to': utilizationTo,
+			'utilization.to': utilizationProgress,
 			has_call: callNow,
 			skill_id: skill,
 			region_id: region,
@@ -270,7 +313,9 @@ const getAgentStatusStatistics = async (params: ApiParams) => {
 			merge(getDefaultGetListResponse()),
 		]);
 		return {
-			items,
+			items: applyTransform(items, [
+				listResponseHandler,
+			]),
 			next,
 		};
 	} catch (err) {

package/src/api/clients/fileServices/fileServices.ts

@@ -18,6 +18,11 @@ import type {
 	SearchScreenRecordingsByAgentParams as SearchScreenRecordingsByAgentWireParams,
 	SearchScreenRecordingsParams as SearchScreenRecordingsWireParams,
 } from '../../../gen-wire/_models';
+import type {
+	DatetimeRangeValue,
+	NormalizeDatetimeValueParam,
+} from '../../../scripts';
+import { normalizeDatetimeRange } from '../../../scripts';
 import { getDefaultGetListResponse, getDefaultGetParams } from '../../defaults';
 import {
 	applyTransform,
@@ -159,14 +164,29 @@ const getScreenRecordingsByAgent = async (
 	params: SearchScreenRecordingsByAgentParams & {
 		agentId: ApiId;
 		search?: string;
+		/** the datalist store's uploadedAt date-range filter sends this combined value */
+		uploadedAt?: DatetimeRangeValue | NormalizeDatetimeValueParam;
 	},
 ) => {
+	const { uploadedAt, ...restParams } = params;
+	const normalizedUploadedAt = normalizeDatetimeRange(uploadedAt);
+
 	const fieldsToSend = getShallowFieldsToSendFromZodSchema(
 		SearchScreenRecordingsByAgentQueryParams,
 	);
 
 	const requestParams = applyTransform<SearchScreenRecordingsByAgentWireParams>(
-		params,
+		{
+			...restParams,
+			uploadedAtFrom:
+				normalizedUploadedAt?.from == null
+					? restParams.uploadedAtFrom
+					: String(normalizedUploadedAt.from),
+			uploadedAtTo:
+				normalizedUploadedAt?.to == null
+					? restParams.uploadedAtTo
+					: String(normalizedUploadedAt.to),
+		},
 		[
 			merge(getDefaultGetParams()),
 			sanitizeToWire(fieldsToSend),

package/src/api/clients/pdfServices/pdfServices.ts

@@ -17,6 +17,11 @@ import type {
 	ListCallExportsParams as ListCallExportsWireParams,
 	ListScreenrecordingExportsParams as ListScreenrecordingExportsWireParams,
 } from '../../../gen-wire/_models';
+import type {
+	DatetimeRangeValue,
+	NormalizeDatetimeValueParam,
+} from '../../../scripts';
+import { normalizeDatetimeRange } from '../../../scripts';
 import { getDefaultGetListResponse, getDefaultGetParams } from '../../defaults';
 import {
 	applyTransform,
@@ -60,14 +65,29 @@ const createScreenrecordingExport = async ({
 const listScreenrecordingExports = async (
 	params: ListScreenrecordingExportsParams & {
 		agentId: ApiId;
+		/** the datalist store's uploadedAt date-range filter sends this combined value */
+		uploadedAt?: DatetimeRangeValue | NormalizeDatetimeValueParam;
 	},
 ) => {
+	const { uploadedAt, ...restParams } = params;
+	const normalizedUploadedAt = normalizeDatetimeRange(uploadedAt);
+
 	const fieldsToSend = getShallowFieldsToSendFromZodSchema(
 		ListScreenrecordingExportsQueryParams,
 	);
 
 	const requestParams = applyTransform<ListScreenrecordingExportsWireParams>(
-		params,
+		{
+			...restParams,
+			uploadedAtFrom:
+				normalizedUploadedAt?.from == null
+					? restParams.uploadedAtFrom
+					: String(normalizedUploadedAt.from),
+			uploadedAtTo:
+				normalizedUploadedAt?.to == null
+					? restParams.uploadedAtTo
+					: String(normalizedUploadedAt.to),
+		},
 		[
 			merge(getDefaultGetParams()),
 			sanitizeToWire(fieldsToSend),