tychat-contracts 1.6.21 → 1.6.24

package/src/conversations/conversation-contact-filters-query.validator.ts

@@ -1,10 +1,10 @@
-/**
- * @deprecated The filter validation logic has been moved to the API gateway.
- * This file is kept only for backward compatibility with existing imports.
- * The gateway now parses and validates the filters string before forwarding
- * the pre-validated ParsedFilterDto[] to the microservice.
- */
-export {
-  CONVERSATION_CONTACT_LIST_FILTER_KEYS,
-  type ConversationContactListFilterKeyDto,
-} from './list-conversation-contacts-query.dto';
+/**
+ * @deprecated The filter validation logic has been moved to the API gateway.
+ * This file is kept only for backward compatibility with existing imports.
+ * The gateway now parses and validates the filters string before forwarding
+ * the pre-validated ParsedFilterDto[] to the microservice.
+ */
+export {
+  CONVERSATION_CONTACT_LIST_FILTER_KEYS,
+  type ConversationContactListFilterKeyDto,
+} from './list-conversation-contacts-query.dto';

package/src/conversations/conversation-intention.dto.ts

@@ -1,24 +1,24 @@
-/**
- * All possible user intention types detected by the AI during a conversation.
- * Used to drive follow-up logic when the user becomes inactive.
- */
-export const CONVERSATION_INTENTIONS = [
-  'greeting',
-  'ask_services',
-  'ask_prices',
-  'ask_availability',
-  'select_service',
-  'provide_datetime',
-  'confirm_appointment',
-  'reject_appointment',
-  'provide_data',
-  'reschedule',
-  'cancel_appointment',
-  'check_appointment',
-  'clinic_info',
-  'human_handoff',
-  'out_of_scope',
-  'unclear',
-] as const;
-
-export type ConversationIntentionDto = (typeof CONVERSATION_INTENTIONS)[number];
+/**
+ * All possible user intention types detected by the AI during a conversation.
+ * Used to drive follow-up logic when the user becomes inactive.
+ */
+export const CONVERSATION_INTENTIONS = [
+  'greeting',
+  'ask_services',
+  'ask_prices',
+  'ask_availability',
+  'select_service',
+  'provide_datetime',
+  'confirm_appointment',
+  'reject_appointment',
+  'provide_data',
+  'reschedule',
+  'cancel_appointment',
+  'check_appointment',
+  'clinic_info',
+  'human_handoff',
+  'out_of_scope',
+  'unclear',
+] as const;
+
+export type ConversationIntentionDto = (typeof CONVERSATION_INTENTIONS)[number];

package/src/conversations/conversation-response.dto.ts

@@ -1,69 +1,69 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
-import { ConversationMessageTypeDto } from './conversation-type.dto';
-
-/**
- * Represents a persisted conversation message returned by the API.
- */
-export class ConversationResponseDto {
-  @ApiProperty({ description: 'Conversation message UUID', example: 'a1b2c3d4-...' })
-  @IsString()
-  @IsNotEmpty()
-  id: string;
-
-  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
-  @IsString()
-  @IsNotEmpty()
-  tenant: string;
-
-  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
-  @IsOptional()
-  unitId?: number;
-
-  @ApiProperty({
-    description: 'Patient UUID',
-    example: '550e8400-e29b-41d4-a716-446655440000',
-  })
-  @IsString()
-  @IsNotEmpty()
-  @IsUUID()
-  patientId: string;
-
-  @ApiProperty({
-    description: 'Session UUID grouping messages within the 24-hour window',
-    example: 'a1b2c3d4-...',
-  })
-  @IsString()
-  @IsNotEmpty()
-  sessionUuid: string;
-
-  @ApiProperty({
-    description: 'Conversation message type: "ia", "human" or "patient"',
-    example: 'patient',
-  })
-  type: ConversationMessageTypeDto;
-
-  @ApiProperty({
-    description: 'Message content',
-    example: 'Sure! Let me look up available slots for you.',
-  })
-  @IsString()
-  @IsNotEmpty()
-  message: string;
-
-  @ApiPropertyOptional({
-    description: 'AI usage record ID (only present when type is "ia")',
-    example: 'a1b2c3d4-...',
-  })
-  @IsOptional()
-  @IsString()
-  aiUsageId?: string;
-
-  @ApiProperty({
-    description: 'Creation timestamp (ISO 8601)',
-    example: '2024-01-01T00:00:00.000Z',
-  })
-  @IsString()
-  @IsNotEmpty()
-  createdAt: string;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
+import { ConversationMessageTypeDto } from './conversation-type.dto';
+
+/**
+ * Represents a persisted conversation message returned by the API.
+ */
+export class ConversationResponseDto {
+  @ApiProperty({ description: 'Conversation message UUID', example: 'a1b2c3d4-...' })
+  @IsString()
+  @IsNotEmpty()
+  id: string;
+
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  unitId?: number;
+
+  @ApiProperty({
+    description: 'Patient UUID',
+    example: '550e8400-e29b-41d4-a716-446655440000',
+  })
+  @IsString()
+  @IsNotEmpty()
+  @IsUUID()
+  patientId: string;
+
+  @ApiProperty({
+    description: 'Session UUID grouping messages within the 24-hour window',
+    example: 'a1b2c3d4-...',
+  })
+  @IsString()
+  @IsNotEmpty()
+  sessionUuid: string;
+
+  @ApiProperty({
+    description: 'Conversation message type: "ia", "human" or "patient"',
+    example: 'patient',
+  })
+  type: ConversationMessageTypeDto;
+
+  @ApiProperty({
+    description: 'Message content',
+    example: 'Sure! Let me look up available slots for you.',
+  })
+  @IsString()
+  @IsNotEmpty()
+  message: string;
+
+  @ApiPropertyOptional({
+    description: 'AI usage record ID (only present when type is "ia")',
+    example: 'a1b2c3d4-...',
+  })
+  @IsOptional()
+  @IsString()
+  aiUsageId?: string;
+
+  @ApiProperty({
+    description: 'Creation timestamp (ISO 8601)',
+    example: '2024-01-01T00:00:00.000Z',
+  })
+  @IsString()
+  @IsNotEmpty()
+  createdAt: string;
+}

package/src/conversations/conversation-session-response.dto.ts

@@ -1,65 +1,65 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsEnum, IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
-import { CONVERSATION_INTENTIONS, ConversationIntentionDto } from './conversation-intention.dto';
-
-/**
- * Represents a conversation session record returned by the API.
- * A session is valid for 24 hours from its start time.
- */
-export class ConversationSessionResponseDto {
-  @ApiProperty({ description: 'Session primary key (UUID)', example: 'a1b2c3d4-...' })
-  @IsString()
-  @IsNotEmpty()
-  id: string;
-
-  @ApiProperty({
-    description: 'Session UUID used to group all messages within the 24-hour window',
-    example: 'a1b2c3d4-...',
-  })
-  @IsString()
-  @IsNotEmpty()
-  sessionUuid: string;
-
-  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
-  @IsString()
-  @IsNotEmpty()
-  tenant: string;
-
-  @ApiProperty({
-    description: 'Patient UUID',
-    example: '550e8400-e29b-41d4-a716-446655440000',
-  })
-  @IsString()
-  @IsNotEmpty()
-  @IsUUID()
-  patientId: string;
-
-  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
-  @IsOptional()
-  unitId?: number;
-
-  @ApiPropertyOptional({
-    description: 'User intention detected by the AI for this session',
-    enum: CONVERSATION_INTENTIONS,
-    example: 'ask_services',
-  })
-  @IsOptional()
-  @IsEnum(CONVERSATION_INTENTIONS)
-  intention?: ConversationIntentionDto;
-
-  @ApiProperty({
-    description: 'Session start timestamp (ISO 8601)',
-    example: '2024-01-01T00:00:00.000Z',
-  })
-  @IsString()
-  @IsNotEmpty()
-  startedAt: string;
-
-  @ApiProperty({
-    description: 'Session expiration timestamp (ISO 8601, 24 h after start)',
-    example: '2024-01-02T00:00:00.000Z',
-  })
-  @IsString()
-  @IsNotEmpty()
-  expiresAt: string;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsEnum, IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
+import { CONVERSATION_INTENTIONS, ConversationIntentionDto } from './conversation-intention.dto';
+
+/**
+ * Represents a conversation session record returned by the API.
+ * A session is valid for 24 hours from its start time.
+ */
+export class ConversationSessionResponseDto {
+  @ApiProperty({ description: 'Session primary key (UUID)', example: 'a1b2c3d4-...' })
+  @IsString()
+  @IsNotEmpty()
+  id: string;
+
+  @ApiProperty({
+    description: 'Session UUID used to group all messages within the 24-hour window',
+    example: 'a1b2c3d4-...',
+  })
+  @IsString()
+  @IsNotEmpty()
+  sessionUuid: string;
+
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiProperty({
+    description: 'Patient UUID',
+    example: '550e8400-e29b-41d4-a716-446655440000',
+  })
+  @IsString()
+  @IsNotEmpty()
+  @IsUUID()
+  patientId: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  unitId?: number;
+
+  @ApiPropertyOptional({
+    description: 'User intention detected by the AI for this session',
+    enum: CONVERSATION_INTENTIONS,
+    example: 'ask_services',
+  })
+  @IsOptional()
+  @IsEnum(CONVERSATION_INTENTIONS)
+  intention?: ConversationIntentionDto;
+
+  @ApiProperty({
+    description: 'Session start timestamp (ISO 8601)',
+    example: '2024-01-01T00:00:00.000Z',
+  })
+  @IsString()
+  @IsNotEmpty()
+  startedAt: string;
+
+  @ApiProperty({
+    description: 'Session expiration timestamp (ISO 8601, 24 h after start)',
+    example: '2024-01-02T00:00:00.000Z',
+  })
+  @IsString()
+  @IsNotEmpty()
+  expiresAt: string;
+}

package/src/conversations/conversation-type.dto.ts

@@ -1,15 +1,15 @@
-// Allowed conversation session types.
-// "ia"    → patient interacting with the AI.
-// "human" → human staff member responding to the patient.
-// "waiting" → waiting queue for human handoff.
-export const CONVERSATION_SESSION_TYPES = ['ia', 'human', 'waiting'] as const;
-
-// Backwards-compatible alias for session types.
-export const CONVERSATION_TYPES = CONVERSATION_SESSION_TYPES;
-
-export type ConversationTypeDto = (typeof CONVERSATION_SESSION_TYPES)[number];
-
-// Allowed conversation message types for the `conversations` table.
-// "patient" → message authored by the patient/user (WhatsApp sender).
-export const CONVERSATION_MESSAGE_TYPES = ['ia', 'human', 'patient'] as const;
-export type ConversationMessageTypeDto = (typeof CONVERSATION_MESSAGE_TYPES)[number];
+// Allowed conversation session types.
+// "ia"    → patient interacting with the AI.
+// "human" → human staff member responding to the patient.
+// "waiting" → waiting queue for human handoff.
+export const CONVERSATION_SESSION_TYPES = ['ia', 'human', 'waiting'] as const;
+
+// Backwards-compatible alias for session types.
+export const CONVERSATION_TYPES = CONVERSATION_SESSION_TYPES;
+
+export type ConversationTypeDto = (typeof CONVERSATION_SESSION_TYPES)[number];
+
+// Allowed conversation message types for the `conversations` table.
+// "patient" → message authored by the patient/user (WhatsApp sender).
+export const CONVERSATION_MESSAGE_TYPES = ['ia', 'human', 'patient'] as const;
+export type ConversationMessageTypeDto = (typeof CONVERSATION_MESSAGE_TYPES)[number];

package/src/conversations/create-conversation-session.dto.ts

@@ -1,28 +1,28 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsInt, IsNotEmpty, IsOptional, IsString, IsUUID, Min } from 'class-validator';
-
-/**
- * Payload used to obtain (or create) an active 24-hour conversation session
- * for a given patient + tenant combination.
- */
-export class CreateConversationSessionDto {
-  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
-  @IsString()
-  @IsNotEmpty()
-  tenant: string;
-
-  @ApiProperty({
-    description: 'Patient UUID',
-    example: '550e8400-e29b-41d4-a716-446655440000',
-  })
-  @IsString()
-  @IsNotEmpty()
-  @IsUUID()
-  patientId: string;
-
-  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
-  @IsOptional()
-  @IsInt()
-  @Min(1)
-  unitId?: number;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsInt, IsNotEmpty, IsOptional, IsString, IsUUID, Min } from 'class-validator';
+
+/**
+ * Payload used to obtain (or create) an active 24-hour conversation session
+ * for a given patient + tenant combination.
+ */
+export class CreateConversationSessionDto {
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiProperty({
+    description: 'Patient UUID',
+    example: '550e8400-e29b-41d4-a716-446655440000',
+  })
+  @IsString()
+  @IsNotEmpty()
+  @IsUUID()
+  patientId: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+}

package/src/conversations/create-conversation.dto.ts

@@ -1,69 +1,69 @@
-import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import {
-  IsEnum,
-  IsInt,
-  IsNotEmpty,
-  IsOptional,
-  IsString,
-  IsUUID,
-  Min,
-} from 'class-validator';
-import { CONVERSATION_MESSAGE_TYPES, ConversationMessageTypeDto } from './conversation-type.dto';
-
-/**
- * Payload used to persist a single conversation message.
- * AiUsageId must be provided whenever type is "ia" so token costs can be tracked.
- */
-export class CreateConversationDto {
-  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
-  @IsString()
-  @IsNotEmpty()
-  tenant: string;
-
-  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
-  @IsOptional()
-  @IsInt()
-  @Min(1)
-  unitId?: number;
-
-  @ApiProperty({
-    description: 'Patient UUID',
-    example: '5511999999999',
-  })
-  @IsString()
-  @IsNotEmpty()
-  @IsUUID()
-  patientId: string;
-
-  @ApiProperty({
-    description: 'Session UUID that groups messages within the 24-hour window',
-    example: 'a1b2c3d4-...',
-  })
-  @IsUUID()
-  sessionUuid: string;
-
-  @ApiProperty({
-    description:
-      'Conversation message type: "ia" when the AI responds, "human" when staff responds, "patient" when the patient/user sends the message',
-    enum: CONVERSATION_MESSAGE_TYPES,
-    example: 'patient',
-  })
-  @IsEnum(CONVERSATION_MESSAGE_TYPES)
-  type: ConversationMessageTypeDto;
-
-  @ApiProperty({
-    description: 'Message content',
-    example: 'Hello, I need to schedule an appointment.',
-  })
-  @IsString()
-  @IsNotEmpty()
-  message: string;
-
-  @ApiPropertyOptional({
-    description: 'AI usage record ID — required when type is "ia"',
-    example: 'a1b2c3d4-...',
-  })
-  @IsOptional()
-  @IsString()
-  aiUsageId?: string;
-}
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsEnum,
+  IsInt,
+  IsNotEmpty,
+  IsOptional,
+  IsString,
+  IsUUID,
+  Min,
+} from 'class-validator';
+import { CONVERSATION_MESSAGE_TYPES, ConversationMessageTypeDto } from './conversation-type.dto';
+
+/**
+ * Payload used to persist a single conversation message.
+ * AiUsageId must be provided whenever type is "ia" so token costs can be tracked.
+ */
+export class CreateConversationDto {
+  @ApiProperty({ description: 'Tenant slug', example: 'clinic-alpha' })
+  @IsString()
+  @IsNotEmpty()
+  tenant: string;
+
+  @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })
+  @IsOptional()
+  @IsInt()
+  @Min(1)
+  unitId?: number;
+
+  @ApiProperty({
+    description: 'Patient UUID',
+    example: '5511999999999',
+  })
+  @IsString()
+  @IsNotEmpty()
+  @IsUUID()
+  patientId: string;
+
+  @ApiProperty({
+    description: 'Session UUID that groups messages within the 24-hour window',
+    example: 'a1b2c3d4-...',
+  })
+  @IsUUID()
+  sessionUuid: string;
+
+  @ApiProperty({
+    description:
+      'Conversation message type: "ia" when the AI responds, "human" when staff responds, "patient" when the patient/user sends the message',
+    enum: CONVERSATION_MESSAGE_TYPES,
+    example: 'patient',
+  })
+  @IsEnum(CONVERSATION_MESSAGE_TYPES)
+  type: ConversationMessageTypeDto;
+
+  @ApiProperty({
+    description: 'Message content',
+    example: 'Hello, I need to schedule an appointment.',
+  })
+  @IsString()
+  @IsNotEmpty()
+  message: string;
+
+  @ApiPropertyOptional({
+    description: 'AI usage record ID — required when type is "ia"',
+    example: 'a1b2c3d4-...',
+  })
+  @IsOptional()
+  @IsString()
+  aiUsageId?: string;
+}