tychat-contracts 1.0.70 → 1.0.71

package/dist/conversations/conversation-response.dto.d.ts

@@ -1,4 +1,4 @@
-import { ConversationTypeDto } from './conversation-type.dto';
+import { ConversationMessageTypeDto } from './conversation-type.dto';
 /**
  * Represents a persisted conversation message returned by the API.
  */
@@ -8,7 +8,7 @@ export declare class ConversationResponseDto {
     unitId?: number;
     patientId: string;
     sessionUuid: string;
-    type: ConversationTypeDto;
+    type: ConversationMessageTypeDto;
     message: string;
     aiUsageId?: string;
     createdAt: string;

package/dist/conversations/conversation-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D;;GAEG;AACH,qBAAa,uBAAuB;IAIlC,EAAE,EAAE,MAAM,CAAC;IAKX,MAAM,EAAE,MAAM,CAAC;IAIf,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,SAAS,EAAE,MAAM,CAAC;IAQlB,WAAW,EAAE,MAAM,CAAC;IAMpB,IAAI,EAAE,mBAAmB,CAAC;IAQ1B,OAAO,EAAE,MAAM,CAAC;IAQhB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"conversation-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-response.dto.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE;;GAEG;AACH,qBAAa,uBAAuB;IAIlC,EAAE,EAAE,MAAM,CAAC;IAKX,MAAM,EAAE,MAAM,CAAC;IAIf,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,SAAS,EAAE,MAAM,CAAC;IAQlB,WAAW,EAAE,MAAM,CAAC;IAMpB,IAAI,EAAE,0BAA0B,CAAC;IAQjC,OAAO,EAAE,MAAM,CAAC;IAQhB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/conversations/conversation-response.dto.js

@@ -46,11 +46,12 @@ __decorate([
 ], ConversationResponseDto.prototype, "unitId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Patient identifier (e.g. phone number)',
-        example: '5511999999999',
+        description: 'Patient UUID',
+        example: '550e8400-e29b-41d4-a716-446655440000',
     }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsUUID)(),
     __metadata("design:type", String)
 ], ConversationResponseDto.prototype, "patientId", void 0);
 __decorate([
@@ -64,8 +65,8 @@ __decorate([
 ], ConversationResponseDto.prototype, "sessionUuid", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Conversation type: "ia" or "human"',
-        example: 'ia',
+        description: 'Conversation message type: "ia", "human" or "patient"',
+        example: 'patient',
     }),
     __metadata("design:type", String)
 ], ConversationResponseDto.prototype, "type", void 0);

package/dist/conversations/conversation-session-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-session-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-session-response.dto.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,8BAA8B;IAIzC,EAAE,EAAE,MAAM,CAAC;IAQX,WAAW,EAAE,MAAM,CAAC;IAKpB,MAAM,EAAE,MAAM,CAAC;IAQf,SAAS,EAAE,MAAM,CAAC;IAIlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,SAAS,EAAE,MAAM,CAAC;IAQlB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"conversation-session-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-session-response.dto.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,8BAA8B;IAIzC,EAAE,EAAE,MAAM,CAAC;IAQX,WAAW,EAAE,MAAM,CAAC;IAKpB,MAAM,EAAE,MAAM,CAAC;IASf,SAAS,EAAE,MAAM,CAAC;IAIlB,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,SAAS,EAAE,MAAM,CAAC;IAQlB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/conversations/conversation-session-response.dto.js

@@ -49,11 +49,12 @@ __decorate([
 ], ConversationSessionResponseDto.prototype, "tenant", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Patient identifier (e.g. phone number)',
-        example: '5511999999999',
+        description: 'Patient UUID',
+        example: '550e8400-e29b-41d4-a716-446655440000',
     }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsUUID)(),
     __metadata("design:type", String)
 ], ConversationSessionResponseDto.prototype, "patientId", void 0);
 __decorate([

package/dist/conversations/conversation-type.dto.d.ts

@@ -1,3 +1,6 @@
+export declare const CONVERSATION_SESSION_TYPES: readonly ["ia", "human"];
 export declare const CONVERSATION_TYPES: readonly ["ia", "human"];
-export type ConversationTypeDto = (typeof CONVERSATION_TYPES)[number];
+export type ConversationTypeDto = (typeof CONVERSATION_SESSION_TYPES)[number];
+export declare const CONVERSATION_MESSAGE_TYPES: readonly ["ia", "human", "patient"];
+export type ConversationMessageTypeDto = (typeof CONVERSATION_MESSAGE_TYPES)[number];
 //# sourceMappingURL=conversation-type.dto.d.ts.map

package/dist/conversations/conversation-type.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-type.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-type.dto.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,kBAAkB,0BAA2B,CAAC;AAC3D,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"conversation-type.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/conversation-type.dto.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,0BAA0B,0BAA2B,CAAC;AAGnE,eAAO,MAAM,kBAAkB,0BAA6B,CAAC;AAE7D,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAI9E,eAAO,MAAM,0BAA0B,qCAAsC,CAAC;AAC9E,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/conversations/conversation-type.dto.js

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONVERSATION_TYPES = void 0;
-// Allowed conversation types.
+exports.CONVERSATION_MESSAGE_TYPES = exports.CONVERSATION_TYPES = exports.CONVERSATION_SESSION_TYPES = void 0;
+// Allowed conversation session types.
 // "ia"    → patient interacting with the AI.
 // "human" → human staff member responding to the patient.
-exports.CONVERSATION_TYPES = ['ia', 'human'];
+exports.CONVERSATION_SESSION_TYPES = ['ia', 'human'];
+// Backwards-compatible alias for session types.
+exports.CONVERSATION_TYPES = exports.CONVERSATION_SESSION_TYPES;
+// Allowed conversation message types for the `conversations` table.
+// "patient" → message authored by the patient/user (WhatsApp sender).
+exports.CONVERSATION_MESSAGE_TYPES = ['ia', 'human', 'patient'];

package/dist/conversations/create-conversation-session.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-conversation-session.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/create-conversation-session.dto.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,4BAA4B;IAIvC,MAAM,EAAE,MAAM,CAAC;IAQf,SAAS,EAAE,MAAM,CAAC;IAMlB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"create-conversation-session.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/create-conversation-session.dto.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,4BAA4B;IAIvC,MAAM,EAAE,MAAM,CAAC;IASf,SAAS,EAAE,MAAM,CAAC;IAMlB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/conversations/create-conversation-session.dto.js

@@ -30,11 +30,12 @@ __decorate([
 ], CreateConversationSessionDto.prototype, "tenant", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Patient identifier (e.g. phone number or WhatsApp id)',
-        example: '5511999999999',
+        description: 'Patient UUID',
+        example: '550e8400-e29b-41d4-a716-446655440000',
     }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsUUID)(),
     __metadata("design:type", String)
 ], CreateConversationSessionDto.prototype, "patientId", void 0);
 __decorate([

package/dist/conversations/create-conversation.dto.d.ts

@@ -1,4 +1,4 @@
-import { ConversationTypeDto } from './conversation-type.dto';
+import { 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.
@@ -8,7 +8,7 @@ export declare class CreateConversationDto {
     unitId?: number;
     patientId: string;
     sessionUuid: string;
-    type: ConversationTypeDto;
+    type: ConversationMessageTypeDto;
     message: string;
     aiUsageId?: string;
 }

package/dist/conversations/create-conversation.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-conversation.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/create-conversation.dto.ts"],"names":[],"mappings":"AAUA,OAAO,EAAsB,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAElF;;;GAGG;AACH,qBAAa,qBAAqB;IAIhC,MAAM,EAAE,MAAM,CAAC;IAMf,MAAM,CAAC,EAAE,MAAM,CAAC;IAQhB,SAAS,EAAE,MAAM,CAAC;IAOlB,WAAW,EAAE,MAAM,CAAC;IASpB,IAAI,EAAE,mBAAmB,CAAC;IAQ1B,OAAO,EAAE,MAAM,CAAC;IAQhB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"create-conversation.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/create-conversation.dto.ts"],"names":[],"mappings":"AAUA,OAAO,EAA8B,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAEjG;;;GAGG;AACH,qBAAa,qBAAqB;IAIhC,MAAM,EAAE,MAAM,CAAC;IAMf,MAAM,CAAC,EAAE,MAAM,CAAC;IAShB,SAAS,EAAE,MAAM,CAAC;IAOlB,WAAW,EAAE,MAAM,CAAC;IASpB,IAAI,EAAE,0BAA0B,CAAC;IAQjC,OAAO,EAAE,MAAM,CAAC;IAQhB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/conversations/create-conversation.dto.js

@@ -42,11 +42,12 @@ __decorate([
 ], CreateConversationDto.prototype, "unitId", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Patient identifier (e.g. phone number)',
+        description: 'Patient UUID',
         example: '5511999999999',
     }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsUUID)(),
     __metadata("design:type", String)
 ], CreateConversationDto.prototype, "patientId", void 0);
 __decorate([
@@ -59,11 +60,11 @@ __decorate([
 ], CreateConversationDto.prototype, "sessionUuid", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({
-        description: 'Conversation type: "ia" when the AI responds to the patient, "human" when a staff member responds',
-        enum: conversation_type_dto_1.CONVERSATION_TYPES,
-        example: 'ia',
+        description: 'Conversation message type: "ia" when the AI responds, "human" when staff responds, "patient" when the patient/user sends the message',
+        enum: conversation_type_dto_1.CONVERSATION_MESSAGE_TYPES,
+        example: 'patient',
     }),
-    (0, class_validator_1.IsEnum)(conversation_type_dto_1.CONVERSATION_TYPES),
+    (0, class_validator_1.IsEnum)(conversation_type_dto_1.CONVERSATION_MESSAGE_TYPES),
     __metadata("design:type", String)
 ], CreateConversationDto.prototype, "type", void 0);
 __decorate([

package/dist/patients/index.d.ts

@@ -2,4 +2,5 @@ export * from './create-patient.dto';
 export * from './update-patient.dto';
 export * from './patient-history-entry.dto';
 export * from './list-patients-query.dto';
+export * from './upsert-patient-by-phone.dto';
 //# sourceMappingURL=index.d.ts.map

package/dist/patients/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patients/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patients/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC"}

package/dist/patients/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./create-patient.dto"), exports);
 __exportStar(require("./update-patient.dto"), exports);
 __exportStar(require("./patient-history-entry.dto"), exports);
 __exportStar(require("./list-patients-query.dto"), exports);
+__exportStar(require("./upsert-patient-by-phone.dto"), exports);

package/dist/patients/upsert-patient-by-phone.dto.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Minimal patient information used to upsert a patient based on WhatsApp phone.
+ * Used for incoming webhook messages where we don't have CPF/birthDate yet.
+ */
+export declare class UpsertPatientByPhoneDto {
+    phone: string;
+    pushName?: string;
+}
+//# sourceMappingURL=upsert-patient-by-phone.dto.d.ts.map

package/dist/patients/upsert-patient-by-phone.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upsert-patient-by-phone.dto.d.ts","sourceRoot":"","sources":["../../src/patients/upsert-patient-by-phone.dto.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,qBAAa,uBAAuB;IASlC,KAAK,EAAE,MAAM,CAAC;IAUd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/patients/upsert-patient-by-phone.dto.js

@@ -0,0 +1,45 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpsertPatientByPhoneDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * Minimal patient information used to upsert a patient based on WhatsApp phone.
+ * Used for incoming webhook messages where we don't have CPF/birthDate yet.
+ */
+class UpsertPatientByPhoneDto {
+    phone;
+    pushName;
+}
+exports.UpsertPatientByPhoneDto = UpsertPatientByPhoneDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Patient phone as received from WhatsApp (local/normalized format)',
+        example: '5511999999999',
+        maxLength: 30,
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(30),
+    __metadata("design:type", String)
+], UpsertPatientByPhoneDto.prototype, "phone", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'WhatsApp contact display name (PushName)',
+        example: 'Maria Silva',
+        maxLength: 255,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], UpsertPatientByPhoneDto.prototype, "pushName", void 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.0.70",
+  "version": "1.0.71",
   "description": "DTOs compartilhados com class-validator (API e microserviços)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

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

@@ -1,6 +1,6 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
-import { ConversationTypeDto } from './conversation-type.dto';
+import { IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
+import { ConversationMessageTypeDto } from './conversation-type.dto';
 
 /**
  * Represents a persisted conversation message returned by the API.
@@ -21,11 +21,12 @@ export class ConversationResponseDto {
   unitId?: number;
 
   @ApiProperty({
-    description: 'Patient identifier (e.g. phone number)',
-    example: '5511999999999',
+    description: 'Patient UUID',
+    example: '550e8400-e29b-41d4-a716-446655440000',
   })
   @IsString()
   @IsNotEmpty()
+  @IsUUID()
   patientId: string;
 
   @ApiProperty({
@@ -37,10 +38,10 @@ export class ConversationResponseDto {
   sessionUuid: string;
 
   @ApiProperty({
-    description: 'Conversation type: "ia" or "human"',
-    example: 'ia',
+    description: 'Conversation message type: "ia", "human" or "patient"',
+    example: 'patient',
   })
-  type: ConversationTypeDto;
+  type: ConversationMessageTypeDto;
 
   @ApiProperty({
     description: 'Message content',

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

@@ -1,5 +1,5 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { IsNotEmpty, IsOptional, IsString, IsUUID } from 'class-validator';
 
 /**
  * Represents a conversation session record returned by the API.
@@ -25,11 +25,12 @@ export class ConversationSessionResponseDto {
   tenant: string;
 
   @ApiProperty({
-    description: 'Patient identifier (e.g. phone number)',
-    example: '5511999999999',
+    description: 'Patient UUID',
+    example: '550e8400-e29b-41d4-a716-446655440000',
   })
   @IsString()
   @IsNotEmpty()
+  @IsUUID()
   patientId: string;
 
   @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })

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

@@ -1,5 +1,14 @@
-// Allowed conversation types.
+// Allowed conversation session types.
 // "ia"    → patient interacting with the AI.
 // "human" → human staff member responding to the patient.
-export const CONVERSATION_TYPES = ['ia', 'human'] as const;
-export type ConversationTypeDto = (typeof CONVERSATION_TYPES)[number];
+export const CONVERSATION_SESSION_TYPES = ['ia', 'human'] 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,5 +1,5 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsInt, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
+import { IsInt, IsNotEmpty, IsOptional, IsString, IsUUID, Min } from 'class-validator';
 
 /**
  * Payload used to obtain (or create) an active 24-hour conversation session
@@ -12,11 +12,12 @@ export class CreateConversationSessionDto {
   tenant: string;
 
   @ApiProperty({
-    description: 'Patient identifier (e.g. phone number or WhatsApp id)',
-    example: '5511999999999',
+    description: 'Patient UUID',
+    example: '550e8400-e29b-41d4-a716-446655440000',
   })
   @IsString()
   @IsNotEmpty()
+  @IsUUID()
   patientId: string;
 
   @ApiPropertyOptional({ description: 'Tenant unit id', example: 1 })

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

@@ -8,7 +8,7 @@ import {
   IsUUID,
   Min,
 } from 'class-validator';
-import { CONVERSATION_TYPES, ConversationTypeDto } from './conversation-type.dto';
+import { CONVERSATION_MESSAGE_TYPES, ConversationMessageTypeDto } from './conversation-type.dto';
 
 /**
  * Payload used to persist a single conversation message.
@@ -27,11 +27,12 @@ export class CreateConversationDto {
   unitId?: number;
 
   @ApiProperty({
-    description: 'Patient identifier (e.g. phone number)',
+    description: 'Patient UUID',
     example: '5511999999999',
   })
   @IsString()
   @IsNotEmpty()
+  @IsUUID()
   patientId: string;
 
   @ApiProperty({
@@ -43,12 +44,12 @@ export class CreateConversationDto {
 
   @ApiProperty({
     description:
-      'Conversation type: "ia" when the AI responds to the patient, "human" when a staff member responds',
-    enum: CONVERSATION_TYPES,
-    example: 'ia',
+      '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_TYPES)
-  type: ConversationTypeDto;
+  @IsEnum(CONVERSATION_MESSAGE_TYPES)
+  type: ConversationMessageTypeDto;
 
   @ApiProperty({
     description: 'Message content',

package/src/patients/index.ts

@@ -2,4 +2,5 @@ export * from './create-patient.dto';
 export * from './update-patient.dto';
 export * from './patient-history-entry.dto';
 export * from './list-patients-query.dto';
+export * from './upsert-patient-by-phone.dto';
 

package/src/patients/upsert-patient-by-phone.dto.ts

@@ -0,0 +1,29 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+
+/**
+ * Minimal patient information used to upsert a patient based on WhatsApp phone.
+ * Used for incoming webhook messages where we don't have CPF/birthDate yet.
+ */
+export class UpsertPatientByPhoneDto {
+  @ApiProperty({
+    description: 'Patient phone as received from WhatsApp (local/normalized format)',
+    example: '5511999999999',
+    maxLength: 30,
+  })
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(30)
+  phone: string;
+
+  @ApiPropertyOptional({
+    description: 'WhatsApp contact display name (PushName)',
+    example: 'Maria Silva',
+    maxLength: 255,
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(255)
+  pushName?: string;
+}
+