@webitel/api-services 26.8.64 → 26.8.66

package/src/gen-wire/webitel-im-api-gateway-v1-updates/webitel-im-api-gateway-v1-updates.zod.ts

@@ -27,6 +27,7 @@ export const updatesGetUpdatesResponseThreadsItemDialogLastMsgSenderRoleDefault
 export const updatesGetUpdatesResponseThreadsItemDialogMembersItemRoleDefault = `ROLE_UNSPECIFIED`;
 export const updatesGetUpdatesResponseThreadsItemDialogReadStatesItemMemberRoleDefault = `ROLE_UNSPECIFIED`;
 export const updatesGetUpdatesResponseThreadsItemDialogTypeDefault = `UNKNOWN`;
+export const updatesGetUpdatesResponseThreadsItemFailuresItemMemberRoleDefault = `ROLE_UNSPECIFIED`;
 export const updatesGetUpdatesResponseThreadsItemMemberChangesItemActionDefault = `THREAD_MEMBER_CHANGE_ACTION_UNSPECIFIED`;
 export const updatesGetUpdatesResponseThreadsItemMemberChangesItemByRoleDefault = `ROLE_UNSPECIFIED`;
 export const updatesGetUpdatesResponseThreadsItemMemberChangesItemMemberRoleDefault = `ROLE_UNSPECIFIED`;
@@ -1386,7 +1387,7 @@ export const UpdatesGetUpdatesResponse = zod.object({
 							.string()
 							.optional()
 							.describe(
-								'GetUpdates cursor read before this thread (set by Get; Search carries it on the response).',
+								"The caller's GetUpdates cursor as of this read (set by Get; Search carries it on the response).",
 							),
 						variables: zod
 							.object({
@@ -1500,8 +1501,137 @@ export const UpdatesGetUpdatesResponse = zod.object({
 					})
 					.optional()
 					.describe(
-						'The thread itself, set when it is new to the caller (created or joined since cursor).',
+						'The thread itself, set when it is new to the caller (created or joined since cursor).\nSame model as the thread list, except last_msg and updates_cursor are never set here.',
 					),
+				failures: zod
+					.array(
+						zod
+							.object({
+								error: zod
+									.object({
+										code: zod.string().optional(),
+										message: zod.string().optional(),
+									})
+									.optional(),
+								member: zod
+									.object({
+										contact: zod
+											.object({
+												app_id: zod
+													.string()
+													.optional()
+													.describe(
+														'Identifier of the specific integration app or bot.',
+													),
+												created_at: zod
+													.string()
+													.optional()
+													.describe(
+														'Record creation timestamp (Unix Epoch in milliseconds).',
+													),
+												is_bot: zod
+													.boolean()
+													.optional()
+													.describe(
+														'Represents if usere is real person or automatic script.',
+													),
+												iss: zod
+													.string()
+													.optional()
+													.describe(
+														'Provider-specific unique identifier (Issuer ID).',
+													),
+												metadata: zod
+													.record(zod.string(), zod.string())
+													.optional()
+													.describe(
+														'Additional dynamic attributes provided by the messenger.',
+													),
+												name: zod
+													.string()
+													.optional()
+													.describe('Display name of the contact.'),
+												sub: zod
+													.string()
+													.optional()
+													.describe(
+														'Associated internal system subject/identifier.',
+													),
+												type: zod
+													.string()
+													.optional()
+													.describe(
+														"Channel type (e.g., 'webchat', 'telegram').",
+													),
+												updated_at: zod
+													.string()
+													.optional()
+													.describe(
+														'Last record update timestamp (Unix Epoch in milliseconds).',
+													),
+												username: zod
+													.string()
+													.optional()
+													.describe('Technical username or handle.'),
+												vias: zod
+													.array(
+														zod.object({
+															contact_id: zod.string().optional(),
+															created_at: zod.string().optional(),
+															disable: zod.boolean().optional(),
+															disable_reason: zod.string().optional(),
+															metadata: zod.looseObject({}).optional(),
+															updated_at: zod.string().optional(),
+															via: zod.string().optional(),
+														}),
+													)
+													.optional(),
+											})
+											.optional()
+											.describe(
+												'Contact represents an external messaging identity.',
+											),
+										id: zod.string().optional(),
+										permissions: zod
+											.object({
+												can_add_members: zod.boolean().optional(),
+												can_change_members_permissions: zod
+													.boolean()
+													.optional(),
+												can_change_thread_info: zod.boolean().optional(),
+												can_delete_messages: zod.boolean().optional(),
+												can_remove_members: zod.boolean().optional(),
+												can_send_messages: zod.boolean().optional(),
+												created_at: zod.string().optional(),
+												id: zod.string().optional(),
+												member_id: zod.string().optional(),
+												updated_at: zod.string().optional(),
+											})
+											.optional(),
+										role: zod
+											.enum([
+												'ROLE_UNSPECIFIED',
+												'ROLE_MEMBER',
+												'ROLE_ADMIN',
+												'ROLE_OWNER',
+												'ROLE_SUPERVISOR',
+											])
+											.default(
+												updatesGetUpdatesResponseThreadsItemFailuresItemMemberRoleDefault,
+											),
+									})
+									.optional()
+									.describe(
+										'ThreadMember represents a thread participant\nwith optional type-specific settings.',
+									),
+								message_id: zod.string().optional(),
+							})
+							.describe(
+								'MessageFailure is a message that could not be delivered to a member.',
+							),
+					)
+					.optional()
+					.describe('Messages that failed to reach a member since the cursor.'),
 				left: zod
 					.boolean()
 					.optional()
@@ -3341,7 +3471,9 @@ export const UpdatesGetUpdatesResponse = zod.object({
 						type: zod.int().optional(),
 					})
 					.optional()
-					.describe('Newest message for the list preview; set with dialog.'),
+					.describe(
+						'Newest message for the list preview, in place of dialog.last_msg; set with dialog.',
+					),
 				unread_count: zod.string().optional(),
 			}),
 		)

package/src/scripts/convertDuration/convertDuration.ts

@@ -1,9 +1,3 @@
-/*
- * @author @Lera
- * fixme: change on library
- *  https://webitel.atlassian.net/browse/WTEL-7842?focusedCommentId=702198
- * */
-
 export interface ConvertDurationOptions {
 	/**
 	 * Keep the hours segment when the duration is under an hour.

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

@@ -0,0 +1,96 @@
+import { getDefaultsFromZodSchema } from '@webitel/api-services/gen/utils';
+import { describe, expect, it } from 'vitest';
+
+import { agentSchema } from '../agent.validations';
+
+const filledAgent = {
+	user: {
+		id: '1',
+		name: 'John',
+	},
+	team: {
+		id: 2,
+		name: 'Support',
+	},
+	chatCount: 1,
+	taskCount: 1,
+};
+
+const issuePaths = (value: Record<string, unknown>) =>
+	agentSchema
+		.safeParse(value)
+		.error?.issues.map((issue) => issue.path.join('.')) ?? [];
+
+describe('agentSchema', () => {
+	it('seeds a new agent with the defaults the form expects', () => {
+		expect(getDefaultsFromZodSchema(agentSchema, {})).toMatchObject({
+			supervisor: [],
+			auditor: [],
+			region: {},
+			greetingMedia: {},
+			progressiveCount: null,
+			chatCount: 1,
+			taskCount: 1,
+			extraChatCount: 0,
+			isSupervisor: false,
+			screenControl: false,
+		});
+	});
+
+	it('requires a user and a team', () => {
+		const paths = issuePaths({
+			user: {},
+			team: {},
+			chatCount: 1,
+			taskCount: 1,
+		});
+
+		expect(paths).toContain('user');
+		expect(paths).toContain('team');
+	});
+
+	it('requires chat and task counts of at least 1', () => {
+		const paths = issuePaths({
+			...filledAgent,
+			chatCount: 0,
+			taskCount: null,
+		});
+
+		expect(paths).toContain('chatCount');
+		expect(paths).toContain('taskCount');
+	});
+
+	it('accepts an emptied progressive count, rejects one below 1', () => {
+		expect(
+			issuePaths({
+				...filledAgent,
+				progressiveCount: null,
+			}),
+		).not.toContain('progressiveCount');
+		expect(
+			issuePaths({
+				...filledAgent,
+				progressiveCount: 0,
+			}),
+		).toContain('progressiveCount');
+	});
+
+	it('accepts an emptied extra chat count, rejects a negative one', () => {
+		expect(
+			issuePaths({
+				...filledAgent,
+				extraChatCount: null,
+			}),
+		).not.toContain('extraChatCount');
+		expect(
+			issuePaths({
+				...filledAgent,
+				extraChatCount: -1,
+			}),
+		).toContain('extraChatCount');
+	});
+
+	it('accepts a valid agent', () => {
+		expect(agentSchema.safeParse(filledAgent).success).toBe(true);
+	});
+});

package/src/validations/agent/agent.validations.ts

@@ -0,0 +1,25 @@
+import type { EngineAgent } from '@webitel/api-services/gen/models';
+import { z } from 'zod';
+
+import {
+	filledLookupSchema,
+	flexibleLookupSchema,
+} from '../_shared/lookup.validations';
+import type { ZodShape } from '../types';
+
+export const agentSchema = z.object<ZodShape<EngineAgent>>({
+	id: z.string().optional(),
+	user: filledLookupSchema,
+	team: filledLookupSchema,
+	supervisor: z.array(flexibleLookupSchema).optional().default([]),
+	auditor: z.array(flexibleLookupSchema).optional().default([]),
+	region: flexibleLookupSchema.optional().default({}),
+	greetingMedia: flexibleLookupSchema.optional().default({}),
+	progressiveCount: z.number().min(1).nullable().optional().default(null),
+	chatCount: z.number().min(1).default(1),
+	taskCount: z.number().min(1).default(1),
+	extraChatCount: z.number().min(0).nullable().optional().default(0),
+	isSupervisor: z.boolean().optional().default(false),
+	screenControl: z.boolean().optional().default(false),
+	allowSetScreenControl: z.boolean().optional(),
+});

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

@@ -0,0 +1,24 @@
+import { describe, expect, it } from 'vitest';
+
+import { agentSubordinateSchema } from '../agentSubordinate.validations';
+
+describe('agentSubordinateSchema', () => {
+	it('requires an agent', () => {
+		expect(
+			agentSubordinateSchema.safeParse({
+				agent: {},
+			}).success,
+		).toBe(false);
+	});
+
+	it('accepts a picked agent', () => {
+		expect(
+			agentSubordinateSchema.safeParse({
+				agent: {
+					id: '1',
+					name: 'John',
+				},
+			}).success,
+		).toBe(true);
+	});
+});

package/src/validations/agentSubordinate/agentSubordinate.validations.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+
+import { filledLookupSchema } from '../_shared/lookup.validations';
+
+export const agentSubordinateSchema = z.object({
+	agent: filledLookupSchema,
+});

package/src/validations/index.ts

@@ -5,8 +5,10 @@ export * from './_shared/lookup.validations';
 export * from './_shared/phoneNumber.validations';
 export * from './_shared/variablePair.validations';
 export * from './adjunctType/adjunctType.validations';
+export * from './agent/agent.validations';
 export * from './agentPauseCause/agentPauseCause.validations';
 export * from './agentSkill/agentSkill.validations';
+export * from './agentSubordinate/agentSubordinate.validations';
 export * from './auditForm/auditForm.validations';
 export * from './bucket/bucket.validations';
 export * from './calendar/calendar.validations';