@webitel/api-services 26.8.75 → 26.8.77

package/src/validations/pauseTemplate/pauseTemplate.validations.ts

@@ -0,0 +1,51 @@
+import type {
+	WfmPauseTemplate,
+	WfmPauseTemplateCause,
+} from '@webitel/api-services/gen/models';
+import { z } from 'zod';
+
+import { flexibleLookupSchema } from '../_shared/lookup.validations';
+import type { ZodShape } from '../types';
+
+/**
+ * [Claude] the API returns the duration (minutes) as an int64 string. An emptied
+ * field becomes `undefined` (not `NaN` as with `z.coerce`), so the form shows
+ * "required" instead of zod's raw "expected number, received NaN".
+ */
+const durationMinutesSchema = z.preprocess(
+	(value) =>
+		value === '' || value === null || value === undefined
+			? undefined
+			: Number(value),
+	z.number().int().min(1),
+);
+
+/**
+ * [Claude] the pause cause is optional ("Not selected"), the duration is not.
+ */
+export const pauseTemplateCauseSchema = z.object({
+	cause: flexibleLookupSchema.nullish(),
+	duration: durationMinutesSchema,
+});
+
+/**
+ * [Claude] a new template row: no pause cause ("Not selected"), 30 minutes.
+ * Shared by the schema default and the form's "add row" action.
+ */
+export const getDefaultPauseTemplateCause = (): WfmPauseTemplateCause & {
+	duration: string;
+} => ({
+	duration: '30',
+});
+
+export const pauseTemplateSchema = z.object<ZodShape<WfmPauseTemplate>>({
+	name: z.string().min(1).max(250).default(''),
+	description: z.string().optional().default(''),
+	causes: z
+		.array(pauseTemplateCauseSchema)
+		.min(1)
+		// [Claude] `.prefault`, not `.default`: the API-shaped row (duration as a string) goes through the schema
+		.prefault(() => [
+			getDefaultPauseTemplateCause(),
+		]),
+});

package/src/validations/shiftTemplate/__tests__/shiftTemplate.validations.spec.ts

@@ -0,0 +1,146 @@
+import { getDefaultsFromZodSchema } from '@webitel/api-services/gen/utils';
+import { describe, expect, it } from 'vitest';
+
+import {
+	getDefaultShiftTemplateTime,
+	getShiftTemplateTimeRangeErrors,
+	shiftTemplateSchema,
+} from '../shiftTemplate.validations';
+
+const valid = {
+	name: 'Day',
+	times: [
+		{
+			start: 540,
+			end: 1200,
+		},
+	],
+};
+
+describe('shiftTemplateSchema', () => {
+	it('accepts a template with a name and a time range', () => {
+		expect(shiftTemplateSchema.safeParse(valid).success).toBe(true);
+	});
+
+	it('fills a new template with one 9:00–18:00 row', () => {
+		expect(getDefaultShiftTemplateTime()).toEqual({
+			start: 540,
+			end: 1080,
+		});
+		expect(getDefaultsFromZodSchema(shiftTemplateSchema, {})).toEqual(
+			expect.objectContaining({
+				times: [
+					getDefaultShiftTemplateTime(),
+				],
+			}),
+		);
+	});
+
+	it('accepts a new template once the name is filled', () => {
+		const defaults = getDefaultsFromZodSchema(
+			shiftTemplateSchema,
+			{},
+		) as object;
+
+		expect(
+			shiftTemplateSchema.safeParse({
+				...defaults,
+				name: 'Day',
+			}).success,
+		).toBe(true);
+	});
+
+	it('requires a name', () => {
+		expect(
+			shiftTemplateSchema.safeParse({
+				...valid,
+				name: '',
+			}).success,
+		).toBe(false);
+	});
+
+	it('rejects a name longer than 250 symbols', () => {
+		expect(
+			shiftTemplateSchema.safeParse({
+				...valid,
+				name: 'a'.repeat(251),
+			}).success,
+		).toBe(false);
+	});
+
+	it('requires at least one time range', () => {
+		expect(
+			shiftTemplateSchema.safeParse({
+				...valid,
+				times: [],
+			}).success,
+		).toBe(false);
+	});
+
+	it.each([
+		[
+			'end before start',
+			{
+				start: 600,
+				end: 540,
+			},
+		],
+		[
+			'zero duration',
+			{
+				start: 600,
+				end: 600,
+			},
+		],
+		[
+			'end out of the day',
+			{
+				start: 600,
+				end: 1440,
+			},
+		],
+		[
+			'empty start',
+			{
+				end: 600,
+			},
+		],
+	])('rejects a row with %s', (_, time) => {
+		expect(
+			shiftTemplateSchema.safeParse({
+				...valid,
+				times: [
+					time,
+				],
+			}).success,
+		).toBe(false);
+	});
+});
+
+describe('getShiftTemplateTimeRangeErrors', () => {
+	it('marks both ends of a row whose start is not before its end', () => {
+		expect(
+			getShiftTemplateTimeRangeErrors([
+				{
+					start: 540,
+					end: 1200,
+				},
+				{
+					start: 600,
+					end: 540,
+				},
+			]),
+		).toEqual([
+			{
+				index: 1,
+				prop: 'start',
+				key: 'timerangeStartLessThanEnd',
+			},
+			{
+				index: 1,
+				prop: 'end',
+				key: 'timerangeStartLessThanEnd',
+			},
+		]);
+	});
+});

package/src/validations/shiftTemplate/shiftTemplate.validations.ts

@@ -0,0 +1,38 @@
+import type { WfmShiftTemplate } from '@webitel/api-services/gen/models';
+import { z } from 'zod';
+
+import {
+	getTimeRangeErrors,
+	type TimeRange,
+	timeRangeSchema,
+} from '../_shared/timeRange.validations';
+import type { ZodShape } from '../types';
+
+/**
+ * [Claude] each row is a part of the shift within a day: start < end, both in minutes
+ */
+const shiftTemplateTimesSchema = z.array(timeRangeSchema).min(1);
+
+/**
+ * [Claude] row errors for `useTimeRangesValidation`: regle marks a row as a plain field,
+ * so the custom range issues are read from the schema directly
+ */
+export const getShiftTemplateTimeRangeErrors = (items: unknown) =>
+	getTimeRangeErrors(shiftTemplateTimesSchema, items);
+
+/**
+ * [Claude] a new template row: 9:00–18:00, 9 hours (minutes of the day).
+ * Shared by the schema default and the form's "add row" action.
+ */
+export const getDefaultShiftTemplateTime = (): TimeRange => ({
+	start: 9 * 60,
+	end: 18 * 60,
+});
+
+export const shiftTemplateSchema = z.object<ZodShape<WfmShiftTemplate>>({
+	name: z.string().min(1).max(250).default(''),
+	description: z.string().optional().default(''),
+	times: shiftTemplateTimesSchema.default(() => [
+		getDefaultShiftTemplateTime(),
+	]),
+});