@webitel/api-services 1.0.10 → 1.0.11

package/src/api/clients/queues/queues.ts

@@ -287,6 +287,57 @@ export {
 	QueueTypeDefaults,
 } from './defaults/queueTypeDefaults';
 
+/**
+ * Aggregated queue performance over a joined-at window — the supervisor queues
+ * table. Percentages and durations come back raw.
+ */
+const getQueuesReportGeneral = async (params: ApiParams) => {
+	const {
+		page,
+		size,
+		joinedAtFrom,
+		joinedAtTo,
+		fields,
+		sort,
+		search,
+		queue,
+		team,
+		queueType,
+	} = applyTransform(params, [
+		merge(getDefaultGetParams()),
+		starToSearch('search'),
+	]);
+
+	try {
+		const response = await getQueueService().searchQueueReportGeneral({
+			page,
+			size,
+			'joined_at.from': joinedAtFrom,
+			'joined_at.to': joinedAtTo,
+			fields,
+			sort,
+			// the generated param is `q`; `search` is what the datalist store sends
+			q: search,
+			queue_id: queue,
+			team_id: team,
+			type: queueType,
+		});
+		const { items, next, aggs } = applyTransform(response.data, [
+			snakeToCamel(),
+			merge(getDefaultGetListResponse()),
+		]);
+		return {
+			items,
+			aggs,
+			next,
+		};
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
 export const QueuesAPI = {
 	getList: getQueuesList,
 	get: getQueue,
@@ -296,6 +347,7 @@ export const QueuesAPI = {
 	delete: deleteQueue,
 	getLookup: getQueuesLookup,
 	getQueuesTags,
+	getReportGeneral: getQueuesReportGeneral,
 	// `getPermissionsList` + `patchPermissions`, the pair PermissionsApiModule
 	// adapts for ui-datalist's permissions page.
 	...generatePermissionsApi(baseUrl),

package/src/api/clients/regions/regions.ts

@@ -1,10 +1,5 @@
-import { RegionServiceApiFactory } from 'webitel-sdk';
-import {
-	getDefaultGetListResponse,
-	getDefaultGetParams,
-	getDefaultInstance,
-	getDefaultOpenAPIConfig,
-} from '../../defaults';
+import { getRegionService } from '../../../gen-wire';
+import { getDefaultGetListResponse, getDefaultGetParams } from '../../defaults';
 import {
 	applyTransform,
 	camelToSnake,
@@ -22,26 +17,27 @@ import type {
 	UpdateItemParams,
 } from '../_shared/types';
 
-const instance = getDefaultInstance();
-const configuration = getDefaultOpenAPIConfig();
-
-const regionService = RegionServiceApiFactory(configuration, '', instance);
-
 const getRegionsList = async (params: ApiParams) => {
-	const { page, size, search, sort, fields, id } = applyTransform(params, [
+	const requestParams = applyTransform(params, [
 		merge(getDefaultGetParams()),
 		starToSearch('search'),
+		camelToSnake(),
+		(params) => ({
+			...params,
+			q: params.search,
+		}),
+		sanitize([
+			'page',
+			'size',
+			'q',
+			'sort',
+			'fields',
+			'id',
+		]),
 	]);
 
 	try {
-		const response = await regionService.searchRegion(
-			page,
-			size,
-			search,
-			sort,
-			fields,
-			id,
-		);
+		const response = await getRegionService().searchRegion(requestParams);
 		const { items, next } = applyTransform(response.data, [
 			snakeToCamel(),
 			merge(getDefaultGetListResponse()),
@@ -59,7 +55,7 @@ const getRegionsList = async (params: ApiParams) => {
 
 const getRegion = async ({ itemId: id }: GetItemParams) => {
 	try {
-		const response = await regionService.readRegion(String(id));
+		const response = await getRegionService().readRegion(String(id));
 		return applyTransform(response.data, [
 			snakeToCamel(),
 		]);
@@ -82,7 +78,7 @@ const addRegion = async ({ itemInstance }: AddItemParams) => {
 		camelToSnake(),
 	]);
 	try {
-		const response = await regionService.createRegion(item);
+		const response = await getRegionService().createRegion(item);
 		return applyTransform(response.data, [
 			snakeToCamel(),
 		]);
@@ -99,7 +95,7 @@ const updateRegion = async ({ itemInstance, itemId: id }: UpdateItemParams) => {
 		camelToSnake(),
 	]);
 	try {
-		const response = await regionService.updateRegion(String(id), item);
+		const response = await getRegionService().updateRegion(String(id), item);
 		return applyTransform(response.data, [
 			snakeToCamel(),
 		]);
@@ -112,7 +108,7 @@ const updateRegion = async ({ itemInstance, itemId: id }: UpdateItemParams) => {
 
 const deleteRegion = async ({ id }: DeleteItemParams) => {
 	try {
-		const response = await regionService.deleteRegion(String(id));
+		const response = await getRegionService().deleteRegion(String(id));
 		return applyTransform(response.data, []);
 	} catch (err) {
 		throw applyTransform(err, [

package/src/api/clients/schemaVariables/schemaVariables.ts

@@ -0,0 +1,167 @@
+import { getSchemaVariablesService } from '../../../gen-wire';
+import { getDefaultGetListResponse, getDefaultGetParams } from '../../defaults';
+import {
+	applyTransform,
+	camelToSnake,
+	merge,
+	notify,
+	sanitize,
+	snakeToCamel,
+	starToSearch,
+} from '../../transformers';
+import type {
+	AddItemParams,
+	ApiParams,
+	DeleteItemParams,
+	GetItemParams,
+	PatchItemParams,
+	UpdateItemParams,
+} from '../_shared/types';
+
+/** "Global variables" in the admin UI. */
+const fieldsToSend = [
+	'id',
+	'name',
+	'value',
+	'encrypt',
+];
+
+const getSchemaVariablesList = async (params: ApiParams) => {
+	const { page, size, search, sort, fields } = applyTransform(params, [
+		merge(getDefaultGetParams()),
+		starToSearch('search'),
+	]);
+
+	try {
+		const response = await getSchemaVariablesService().searchSchemaVariable({
+			page,
+			size,
+			// the generated param is `q`; `search` is what the datalist store sends
+			q: search,
+			sort,
+			fields,
+		});
+		const { items, next } = applyTransform(response.data, [
+			snakeToCamel(),
+			merge(getDefaultGetListResponse()),
+		]);
+		return {
+			items,
+			next,
+		};
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const getSchemaVariable = async ({ itemId: id }: GetItemParams) => {
+	try {
+		const response = await getSchemaVariablesService().readSchemaVariable(
+			Number(id),
+		);
+		return applyTransform(response.data, [
+			snakeToCamel(),
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const addSchemaVariable = async ({ itemInstance }: AddItemParams) => {
+	const item = applyTransform(itemInstance, [
+		sanitize(fieldsToSend),
+		camelToSnake(),
+	]);
+	try {
+		const response =
+			await getSchemaVariablesService().createSchemaVariable(item);
+		return applyTransform(response.data, [
+			snakeToCamel(),
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const updateSchemaVariable = async ({
+	itemInstance,
+	itemId: id,
+}: UpdateItemParams) => {
+	const item = applyTransform(itemInstance, [
+		sanitize(fieldsToSend),
+		camelToSnake(),
+	]);
+	try {
+		const response = await getSchemaVariablesService().updateSchemaVariable(
+			Number(id),
+			item,
+		);
+		return applyTransform(response.data, [
+			snakeToCamel(),
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const patchSchemaVariable = async ({ changes, id }: PatchItemParams) => {
+	const body = applyTransform(changes, [
+		sanitize(fieldsToSend),
+		camelToSnake(),
+	]);
+	try {
+		const response = await getSchemaVariablesService().patchSchemaVariable(
+			Number(id),
+			body,
+		);
+		return applyTransform(response.data, [
+			snakeToCamel(),
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const deleteSchemaVariable = async ({ id }: DeleteItemParams) => {
+	try {
+		const response = await getSchemaVariablesService().deleteSchemaVariable(
+			Number(id),
+		);
+		return applyTransform(response.data, []);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const getSchemaVariablesLookup = (
+	params: Parameters<typeof getSchemaVariablesList>[0],
+) =>
+	getSchemaVariablesList({
+		...params,
+		fields: params.fields || [
+			'id',
+			'name',
+		],
+	});
+
+export const SchemaVariablesAPI = {
+	getList: getSchemaVariablesList,
+	get: getSchemaVariable,
+	add: addSchemaVariable,
+	update: updateSchemaVariable,
+	patch: patchSchemaVariable,
+	delete: deleteSchemaVariable,
+	getLookup: getSchemaVariablesLookup,
+};

package/src/api/clients/shiftTemplates/shiftTemplates.ts

@@ -0,0 +1,176 @@
+import { getShiftTemplateService } from '../../../gen-wire';
+import { getDefaultGetListResponse, getDefaultGetParams } from '../../defaults';
+import {
+	applyTransform,
+	camelToSnake,
+	merge,
+	notify,
+	sanitize,
+	snakeToCamel,
+} from '../../transformers';
+import type {
+	AddItemParams,
+	ApiParams,
+	DeleteItemParams,
+	GetItemParams,
+	UpdateItemParams,
+} from '../_shared/types';
+
+const fieldsToSend = [
+	'name',
+	'description',
+	'times',
+];
+
+/**
+ * WFM services wrap both request and response payloads in an `item` envelope.
+ */
+const itemResponseHandler = (response: ApiParams) => {
+	const copy = {
+		...response.item,
+	};
+
+	copy.times = copy.times?.map((time: ApiParams) => ({
+		...time,
+		duration: time.end - time.start,
+	}));
+
+	return copy;
+};
+
+const getShiftTemplatesList = async (params: ApiParams) => {
+	const {
+		search: q,
+		page,
+		size,
+		sort,
+		fields,
+	} = applyTransform(params, [
+		merge(getDefaultGetParams()),
+	]);
+
+	try {
+		const response =
+			await getShiftTemplateService().shiftTemplateServiceSearchShiftTemplate({
+				q,
+				page,
+				size,
+				sort,
+				fields,
+			});
+		const { items, next } = applyTransform(response.data, [
+			snakeToCamel(),
+			merge(getDefaultGetListResponse()),
+		]);
+		return {
+			items,
+			next,
+		};
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const getShiftTemplate = async ({ itemId: id }: GetItemParams) => {
+	try {
+		const response =
+			await getShiftTemplateService().shiftTemplateServiceReadShiftTemplate(
+				String(id),
+			);
+		return applyTransform(response.data, [
+			snakeToCamel(),
+			itemResponseHandler,
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const addShiftTemplate = async ({ itemInstance }: AddItemParams) => {
+	const item = applyTransform(itemInstance, [
+		sanitize(fieldsToSend),
+		camelToSnake(),
+	]);
+	try {
+		const response =
+			await getShiftTemplateService().shiftTemplateServiceCreateShiftTemplate({
+				item: {
+					...item,
+				},
+			});
+		return applyTransform(response.data, [
+			snakeToCamel(),
+			itemResponseHandler,
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const updateShiftTemplate = async ({
+	itemInstance,
+	itemId: id,
+}: UpdateItemParams) => {
+	const item = applyTransform(itemInstance, [
+		sanitize(fieldsToSend),
+		camelToSnake(),
+	]);
+	try {
+		const response =
+			await getShiftTemplateService().shiftTemplateServiceUpdateShiftTemplate(
+				String(id),
+				{
+					item: {
+						...item,
+					},
+				},
+			);
+		return applyTransform(response.data, [
+			snakeToCamel(),
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const deleteShiftTemplate = async ({ id }: DeleteItemParams) => {
+	try {
+		const response =
+			await getShiftTemplateService().shiftTemplateServiceDeleteShiftTemplate(
+				String(id),
+			);
+		return applyTransform(response.data, []);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const getShiftTemplatesLookup = (
+	params: Parameters<typeof getShiftTemplatesList>[0],
+) =>
+	getShiftTemplatesList({
+		...params,
+		fields: params.fields || [
+			'id',
+			'name',
+		],
+	});
+
+export const ShiftTemplatesAPI = {
+	getList: getShiftTemplatesList,
+	get: getShiftTemplate,
+	add: addShiftTemplate,
+	update: updateShiftTemplate,
+	delete: deleteShiftTemplate,
+	getLookup: getShiftTemplatesLookup,
+};

package/src/api/clients/skills/skillAgents.ts

@@ -0,0 +1,190 @@
+import { getSkillService } from '../../../gen-wire';
+import { getDefaultGetListResponse, getDefaultGetParams } from '../../defaults';
+import {
+	applyTransform,
+	camelToSnake,
+	merge,
+	mergeEach,
+	notify,
+	sanitize,
+	snakeToCamel,
+	starToSearch,
+} from '../../transformers';
+import type {
+	ApiParams,
+	NestedAddItemParams,
+	NestedDeleteItemParams,
+	NestedGetItemParams,
+	NestedPatchItemParams,
+	UpdateItemParams,
+} from '../_shared/types';
+
+/** Agents holding a given skill. `parentId` is the skill. */
+const defaultObject = {
+	agent: {},
+	skill: {},
+	team: {},
+	capacity: 10,
+	enabled: false,
+};
+
+const fieldsToSend = [
+	'capacity',
+	'skill',
+	'team',
+	'enabled',
+	'agent',
+	'user',
+	'q',
+];
+
+const getSkillAgentsList = async (params: ApiParams) => {
+	const { parentId, page, size, search, sort, fields, id, agentId } =
+		applyTransform(params, [
+			merge(getDefaultGetParams()),
+			starToSearch('search'),
+		]);
+
+	try {
+		const response = await getSkillService().searchSkillAgent(
+			String(parentId),
+			{
+				page,
+				size,
+				// the generated param is `q`; `search` is what the datalist store sends
+				q: search,
+				sort,
+				fields,
+				id,
+				agent_id: agentId,
+			},
+		);
+		const { items, next, aggs } = applyTransform(response.data, [
+			snakeToCamel(),
+			merge(getDefaultGetListResponse()),
+		]);
+		return {
+			items: applyTransform(items, [
+				mergeEach(defaultObject),
+			]),
+			next,
+			aggs,
+		};
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const getSkillAgent = async ({ itemId: id }: NestedGetItemParams) => {
+	try {
+		const response = await getSkillService().readSkill(String(id));
+		return applyTransform(response.data, [
+			snakeToCamel(),
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const addSkillAgent = async ({
+	parentId,
+	itemInstance,
+}: NestedAddItemParams) => {
+	const item = applyTransform(itemInstance, [
+		sanitize(fieldsToSend),
+		camelToSnake(),
+	]);
+	try {
+		const response = await getSkillService().createSkillAgent(
+			String(parentId),
+			item,
+		);
+		return applyTransform(response.data, [
+			snakeToCamel(),
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+/**
+ * Bulk edit: the body carries the ids to change, so `id` rides along with the
+ * sanitized changes rather than going in the path.
+ */
+const patchSkillAgent = async ({
+	parentId,
+	changes,
+	id,
+}: NestedPatchItemParams) => {
+	const sanitizedChanges = applyTransform(changes, [
+		sanitize(fieldsToSend),
+		camelToSnake(),
+		starToSearch('q'),
+	]);
+	try {
+		const response = await getSkillService().patchSkillAgent(String(parentId), {
+			...sanitizedChanges,
+			id,
+		});
+		return applyTransform(response.data, [
+			snakeToCamel(),
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const updateSkillAgent = async ({
+	itemId: id,
+	itemInstance,
+}: UpdateItemParams) => {
+	const item = applyTransform(itemInstance, [
+		sanitize(fieldsToSend),
+		camelToSnake(),
+	]);
+	try {
+		const response = await getSkillService().updateSkill(String(id), item);
+		return applyTransform(response.data, [
+			snakeToCamel(),
+		]);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+const deleteSkillAgent = async ({ parentId, id }: NestedDeleteItemParams) => {
+	try {
+		const response = await getSkillService().deleteSkillAgent(
+			String(parentId),
+			{
+				id: [
+					String(id),
+				],
+			},
+		);
+		return applyTransform(response.data, []);
+	} catch (err) {
+		throw applyTransform(err, [
+			notify,
+		]);
+	}
+};
+
+export const SkillAgentsAPI = {
+	getList: getSkillAgentsList,
+	get: getSkillAgent,
+	add: addSkillAgent,
+	patch: patchSkillAgent,
+	update: updateSkillAgent,
+	delete: deleteSkillAgent,
+};