tychat-contracts 1.3.17 → 1.3.19

package/dist/legal-terms/index.d.ts

@@ -1,5 +1,6 @@
 export * from './legal-term-template.dto';
 export * from './legal-term-preview.dto';
+export * from './legal-term-dispatch.dto';
 export * from './legal-term-signature-rpc.dto';
 export * from './legal-term-rmq-patterns';
 //# sourceMappingURL=index.d.ts.map

package/dist/legal-terms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/legal-terms/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/legal-terms/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC"}

package/dist/legal-terms/index.js

@@ -16,5 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./legal-term-template.dto"), exports);
 __exportStar(require("./legal-term-preview.dto"), exports);
+__exportStar(require("./legal-term-dispatch.dto"), exports);
 __exportStar(require("./legal-term-signature-rpc.dto"), exports);
 __exportStar(require("./legal-term-rmq-patterns"), exports);

package/dist/legal-terms/legal-term-dispatch.dto.d.ts

@@ -0,0 +1,21 @@
+/** Status do registro de envio na clínica (WhatsApp / fluxo). */
+export type LegalTermDispatchStatusValue = 'created' | 'sent' | 'failed';
+/** Status do documento na Clicksign (signature-service). */
+export type SignatureDocumentStatusValue = 'pending' | 'signed' | 'refused' | 'cancelled' | 'expired';
+/** Item agregado para a ficha do paciente (API: clinic + signature). */
+export type PatientLegalTermDispatchItemDto = {
+    id: string;
+    created_at: string;
+    procedure_ids: string[];
+    procedure_names: string[];
+    dispatch_status: LegalTermDispatchStatusValue;
+    error_code: string | null;
+    signature_document_id: string | null;
+    signature_status: SignatureDocumentStatusValue | null;
+    signed_at: string | null;
+    patient_signed: boolean | null;
+};
+export type PatientLegalTermDispatchesResponseDto = {
+    items: PatientLegalTermDispatchItemDto[];
+};
+//# sourceMappingURL=legal-term-dispatch.dto.d.ts.map

package/dist/legal-terms/legal-term-dispatch.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legal-term-dispatch.dto.d.ts","sourceRoot":"","sources":["../../src/legal-terms/legal-term-dispatch.dto.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzE,4DAA4D;AAC5D,MAAM,MAAM,4BAA4B,GACpC,SAAS,GACT,QAAQ,GACR,SAAS,GACT,WAAW,GACX,SAAS,CAAC;AAEd,wEAAwE;AACxE,MAAM,MAAM,+BAA+B,GAAG;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,4BAA4B,CAAC;IAC9C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,gBAAgB,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACtD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,OAAO,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IAClD,KAAK,EAAE,+BAA+B,EAAE,CAAC;CAC1C,CAAC"}

package/dist/legal-terms/legal-term-dispatch.dto.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/legal-terms/legal-term-preview.dto.d.ts

@@ -12,5 +12,10 @@ export declare class LegalTermSendDto {
     whatsappMessage: string;
     signerEmail?: string;
     instanceKey?: string;
+    tenantAutoSign?: boolean;
+    tenantSignerName?: string;
+    tenantSignerEmail?: string;
+    tenantSignerBirthday?: string;
+    tenantSignerDocumentation?: string;
 }
 //# sourceMappingURL=legal-term-preview.dto.d.ts.map

package/dist/legal-terms/legal-term-preview.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legal-term-preview.dto.d.ts","sourceRoot":"","sources":["../../src/legal-terms/legal-term-preview.dto.ts"],"names":[],"mappings":"AAGA,4FAA4F;AAC5F,qBAAa,0BAA0B;IAQrC,SAAS,CAAC,EAAE,MAAM,CAAC;IAMnB,aAAa,CAAC,EAAE,MAAM,CAAC;IAMvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAMrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAU9B,+BAA+B,CAAC,EAAE,MAAM,EAAE,CAAC;IAM3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,gBAAgB;IAI3B,YAAY,EAAE,MAAM,EAAE,CAAC;IASvB,eAAe,EAAE,MAAM,CAAC;IAMxB,WAAW,CAAC,EAAE,MAAM,CAAC;IASrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"legal-term-preview.dto.d.ts","sourceRoot":"","sources":["../../src/legal-terms/legal-term-preview.dto.ts"],"names":[],"mappings":"AAcA,4FAA4F;AAC5F,qBAAa,0BAA0B;IAQrC,SAAS,CAAC,EAAE,MAAM,CAAC;IAMnB,aAAa,CAAC,EAAE,MAAM,CAAC;IAMvB,WAAW,CAAC,EAAE,MAAM,CAAC;IAMrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAU9B,+BAA+B,CAAC,EAAE,MAAM,EAAE,CAAC;IAM3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,gBAAgB;IAI3B,YAAY,EAAE,MAAM,EAAE,CAAC;IASvB,eAAe,EAAE,MAAM,CAAC;IAMxB,WAAW,CAAC,EAAE,MAAM,CAAC;IASrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAQrB,cAAc,CAAC,EAAE,OAAO,CAAC;IAMzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAO3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAM9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC"}

package/dist/legal-terms/legal-term-preview.dto.js

@@ -75,6 +75,11 @@ class LegalTermSendDto {
     whatsappMessage;
     signerEmail;
     instanceKey;
+    tenantAutoSign;
+    tenantSignerName;
+    tenantSignerEmail;
+    tenantSignerBirthday;
+    tenantSignerDocumentation;
 }
 exports.LegalTermSendDto = LegalTermSendDto;
 __decorate([
@@ -109,3 +114,39 @@ __decorate([
     (0, class_validator_1.MaxLength)(128),
     __metadata("design:type", String)
 ], LegalTermSendDto.prototype, "instanceKey", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Assinatura automática do representante da clínica (Clicksign) antes do paciente. Exige tenantSignerName, tenantSignerEmail, tenantSignerBirthday (YYYY-MM-DD) e tenantSignerDocumentation (CPF).',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], LegalTermSendDto.prototype, "tenantAutoSign", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.tenantAutoSign === true),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], LegalTermSendDto.prototype, "tenantSignerName", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.tenantAutoSign === true),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.MaxLength)(320),
+    __metadata("design:type", String)
+], LegalTermSendDto.prototype, "tenantSignerEmail", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.tenantAutoSign === true),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^\d{4}-\d{2}-\d{2}$/, {
+        message: 'tenantSignerBirthday deve ser ISO (YYYY-MM-DD)',
+    }),
+    __metadata("design:type", String)
+], LegalTermSendDto.prototype, "tenantSignerBirthday", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.tenantAutoSign === true),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(11),
+    (0, class_validator_1.MaxLength)(14),
+    __metadata("design:type", String)
+], LegalTermSendDto.prototype, "tenantSignerDocumentation", void 0);

package/dist/legal-terms/legal-term-rmq-patterns.d.ts

@@ -3,4 +3,6 @@ export declare const LEGAL_TERM_TEMPLATE_UPSERT = "legalTerm.template.upsert";
 export declare const LEGAL_TERM_DISPATCH_CREATE = "legalTerm.dispatch.create";
 export declare const LEGAL_TERM_DISPATCH_LIST_BY_PATIENT = "legalTerm.dispatch.listByPatient";
 export declare const SIGNATURE_LEGAL_ENVELOPE_CREATE = "signature.legalEnvelope.create";
+/** Resumo de documentos por IDs (tenant + escopo); usado pela API para enriquecer dispatches. */
+export declare const SIGNATURE_DOCUMENTS_SUMMARY_BY_IDS = "signature.documents.summaryByIds";
 //# sourceMappingURL=legal-term-rmq-patterns.d.ts.map

package/dist/legal-terms/legal-term-rmq-patterns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legal-term-rmq-patterns.d.ts","sourceRoot":"","sources":["../../src/legal-terms/legal-term-rmq-patterns.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AACtE,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AACtE,eAAO,MAAM,mCAAmC,qCAAqC,CAAC;AACtF,eAAO,MAAM,+BAA+B,mCAAmC,CAAC"}
+{"version":3,"file":"legal-term-rmq-patterns.d.ts","sourceRoot":"","sources":["../../src/legal-terms/legal-term-rmq-patterns.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,2BAA2B,CAAC;AAChE,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AACtE,eAAO,MAAM,0BAA0B,8BAA8B,CAAC;AACtE,eAAO,MAAM,mCAAmC,qCAAqC,CAAC;AACtF,eAAO,MAAM,+BAA+B,mCAAmC,CAAC;AAChF,iGAAiG;AACjG,eAAO,MAAM,kCAAkC,qCAAqC,CAAC"}

package/dist/legal-terms/legal-term-rmq-patterns.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SIGNATURE_LEGAL_ENVELOPE_CREATE = exports.LEGAL_TERM_DISPATCH_LIST_BY_PATIENT = exports.LEGAL_TERM_DISPATCH_CREATE = exports.LEGAL_TERM_TEMPLATE_UPSERT = exports.LEGAL_TERM_TEMPLATE_GET = void 0;
+exports.SIGNATURE_DOCUMENTS_SUMMARY_BY_IDS = exports.SIGNATURE_LEGAL_ENVELOPE_CREATE = exports.LEGAL_TERM_DISPATCH_LIST_BY_PATIENT = exports.LEGAL_TERM_DISPATCH_CREATE = exports.LEGAL_TERM_TEMPLATE_UPSERT = exports.LEGAL_TERM_TEMPLATE_GET = void 0;
 exports.LEGAL_TERM_TEMPLATE_GET = 'legalTerm.template.get';
 exports.LEGAL_TERM_TEMPLATE_UPSERT = 'legalTerm.template.upsert';
 exports.LEGAL_TERM_DISPATCH_CREATE = 'legalTerm.dispatch.create';
 exports.LEGAL_TERM_DISPATCH_LIST_BY_PATIENT = 'legalTerm.dispatch.listByPatient';
 exports.SIGNATURE_LEGAL_ENVELOPE_CREATE = 'signature.legalEnvelope.create';
+/** Resumo de documentos por IDs (tenant + escopo); usado pela API para enriquecer dispatches. */
+exports.SIGNATURE_DOCUMENTS_SUMMARY_BY_IDS = 'signature.documents.summaryByIds';

package/dist/legal-terms/legal-term-signature-rpc.dto.d.ts

@@ -9,6 +9,11 @@ export declare class CreateLegalSigningEnvelopeRpcDto {
     renderedHtml?: string;
     documentFilename: string;
     envelopeName?: string;
+    tenantAutoSign?: boolean;
+    tenantSignerName?: string;
+    tenantSignerEmail?: string;
+    tenantSignerBirthday?: string;
+    tenantSignerDocumentation?: string;
 }
 export declare class CreateLegalSigningEnvelopeRpcResultDto {
     signatureDocumentId: string;
@@ -17,4 +22,12 @@ export declare class CreateLegalSigningEnvelopeRpcResultDto {
     clicksignDocumentId: string;
     clicksignSignerId?: string;
 }
+/** Resposta RPC: um documento por ID solicitado (apenas linhas do tenant). */
+export type SignatureDocumentSummaryItemDto = {
+    id: string;
+    signature_status: 'pending' | 'signed' | 'refused' | 'cancelled' | 'expired';
+    patient_signed: boolean;
+    /** ISO-8601 UTC ou null */
+    signed_at: string | null;
+};
 //# sourceMappingURL=legal-term-signature-rpc.dto.d.ts.map

package/dist/legal-terms/legal-term-signature-rpc.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"legal-term-signature-rpc.dto.d.ts","sourceRoot":"","sources":["../../src/legal-terms/legal-term-signature-rpc.dto.ts"],"names":[],"mappings":"AAWA,wFAAwF;AACxF,qBAAa,gCAAgC;IAK3C,MAAM,EAAE,MAAM,CAAC;IAIf,SAAS,EAAE,MAAM,CAAC;IAKlB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAM7B,UAAU,EAAE,MAAM,CAAC;IAKnB,WAAW,EAAE,MAAM,CAAC;IAMpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAMtB,gBAAgB,EAAE,MAAM,CAAC;IAMzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,sCAAsC;IAEjD,mBAAmB,EAAE,MAAM,CAAC;IAG5B,UAAU,EAAE,MAAM,CAAC;IAGnB,mBAAmB,EAAE,MAAM,CAAC;IAG5B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"legal-term-signature-rpc.dto.d.ts","sourceRoot":"","sources":["../../src/legal-terms/legal-term-signature-rpc.dto.ts"],"names":[],"mappings":"AAaA,wFAAwF;AACxF,qBAAa,gCAAgC;IAK3C,MAAM,EAAE,MAAM,CAAC;IAIf,SAAS,EAAE,MAAM,CAAC;IAKlB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAM7B,UAAU,EAAE,MAAM,CAAC;IAKnB,WAAW,EAAE,MAAM,CAAC;IAMpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAQnB,YAAY,CAAC,EAAE,MAAM,CAAC;IAUtB,gBAAgB,EAAE,MAAM,CAAC;IAMzB,YAAY,CAAC,EAAE,MAAM,CAAC;IAQtB,cAAc,CAAC,EAAE,OAAO,CAAC;IAMzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAK1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAO3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAM9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,qBAAa,sCAAsC;IAEjD,mBAAmB,EAAE,MAAM,CAAC;IAG5B,UAAU,EAAE,MAAM,CAAC;IAGnB,mBAAmB,EAAE,MAAM,CAAC;IAG5B,mBAAmB,EAAE,MAAM,CAAC;IAG5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,8EAA8E;AAC9E,MAAM,MAAM,+BAA+B,GAAG;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EACZ,SAAS,GACT,QAAQ,GACR,SAAS,GACT,WAAW,GACX,SAAS,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC"}

package/dist/legal-terms/legal-term-signature-rpc.dto.js

@@ -23,6 +23,11 @@ class CreateLegalSigningEnvelopeRpcDto {
     renderedHtml;
     documentFilename;
     envelopeName;
+    tenantAutoSign;
+    tenantSignerName;
+    tenantSignerEmail;
+    tenantSignerBirthday;
+    tenantSignerDocumentation;
 }
 exports.CreateLegalSigningEnvelopeRpcDto = CreateLegalSigningEnvelopeRpcDto;
 __decorate([
@@ -73,7 +78,10 @@ __decorate([
     __metadata("design:type", String)
 ], CreateLegalSigningEnvelopeRpcDto.prototype, "renderedHtml", void 0);
 __decorate([
-    (0, swagger_1.ApiProperty)({ example: 'termo-juridico.pdf' }),
+    (0, swagger_1.ApiProperty)({
+        example: 'termo-juridico.pdf',
+        description: 'Nome do arquivo no envelope. Com renderedHtml o PDF é gerado no signature-service (html-to-pdfmake + pdfmake); com pdfBase64, o binário enviado já é PDF.',
+    }),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.MinLength)(1),
     (0, class_validator_1.MaxLength)(255),
@@ -86,6 +94,42 @@ __decorate([
     (0, class_validator_1.MaxLength)(500),
     __metadata("design:type", String)
 ], CreateLegalSigningEnvelopeRpcDto.prototype, "envelopeName", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Incluir signatário da clínica (PJ) com assinatura automática na Clicksign antes do paciente. Exige conta com termo de assinatura automática válido.',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "tenantAutoSign", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.tenantAutoSign === true),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "tenantSignerName", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.tenantAutoSign === true),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.MaxLength)(320),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "tenantSignerEmail", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.tenantAutoSign === true),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^\d{4}-\d{2}-\d{2}$/, {
+        message: 'tenantSignerBirthday deve ser ISO (YYYY-MM-DD)',
+    }),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "tenantSignerBirthday", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)((o) => o.tenantAutoSign === true),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(11),
+    (0, class_validator_1.MaxLength)(14),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "tenantSignerDocumentation", void 0);
 class CreateLegalSigningEnvelopeRpcResultDto {
     signatureDocumentId;
     signingUrl;

package/package.json

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

package/src/legal-terms/index.ts

@@ -1,4 +1,5 @@
 export * from './legal-term-template.dto';
 export * from './legal-term-preview.dto';
+export * from './legal-term-dispatch.dto';
 export * from './legal-term-signature-rpc.dto';
 export * from './legal-term-rmq-patterns';

package/src/legal-terms/legal-term-dispatch.dto.ts

@@ -0,0 +1,28 @@
+/** Status do registro de envio na clínica (WhatsApp / fluxo). */
+export type LegalTermDispatchStatusValue = 'created' | 'sent' | 'failed';
+
+/** Status do documento na Clicksign (signature-service). */
+export type SignatureDocumentStatusValue =
+  | 'pending'
+  | 'signed'
+  | 'refused'
+  | 'cancelled'
+  | 'expired';
+
+/** Item agregado para a ficha do paciente (API: clinic + signature). */
+export type PatientLegalTermDispatchItemDto = {
+  id: string;
+  created_at: string;
+  procedure_ids: string[];
+  procedure_names: string[];
+  dispatch_status: LegalTermDispatchStatusValue;
+  error_code: string | null;
+  signature_document_id: string | null;
+  signature_status: SignatureDocumentStatusValue | null;
+  signed_at: string | null;
+  patient_signed: boolean | null;
+};
+
+export type PatientLegalTermDispatchesResponseDto = {
+  items: PatientLegalTermDispatchItemDto[];
+};

package/src/legal-terms/legal-term-preview.dto.ts

@@ -1,5 +1,16 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsArray, IsOptional, IsString, IsUUID, MaxLength, MinLength } from 'class-validator';
+import {
+  IsArray,
+  IsBoolean,
+  IsEmail,
+  IsOptional,
+  IsString,
+  IsUUID,
+  Matches,
+  MaxLength,
+  MinLength,
+  ValidateIf,
+} from 'class-validator';
 
 /** Valores explícitos para substituição na pré-visualização (sem inferência heurística). */
 export class LegalTermPreviewRequestDto {
@@ -76,4 +87,36 @@ export class LegalTermSendDto {
   @IsString()
   @MaxLength(128)
   instanceKey?: string;
+
+  @ApiPropertyOptional({
+    description:
+      'Assinatura automática do representante da clínica (Clicksign) antes do paciente. Exige tenantSignerName, tenantSignerEmail, tenantSignerBirthday (YYYY-MM-DD) e tenantSignerDocumentation (CPF).',
+  })
+  @IsOptional()
+  @IsBoolean()
+  tenantAutoSign?: boolean;
+
+  @ValidateIf((o: LegalTermSendDto) => o.tenantAutoSign === true)
+  @IsString()
+  @MinLength(1)
+  @MaxLength(500)
+  tenantSignerName?: string;
+
+  @ValidateIf((o: LegalTermSendDto) => o.tenantAutoSign === true)
+  @IsEmail()
+  @MaxLength(320)
+  tenantSignerEmail?: string;
+
+  @ValidateIf((o: LegalTermSendDto) => o.tenantAutoSign === true)
+  @IsString()
+  @Matches(/^\d{4}-\d{2}-\d{2}$/, {
+    message: 'tenantSignerBirthday deve ser ISO (YYYY-MM-DD)',
+  })
+  tenantSignerBirthday?: string;
+
+  @ValidateIf((o: LegalTermSendDto) => o.tenantAutoSign === true)
+  @IsString()
+  @MinLength(11)
+  @MaxLength(14)
+  tenantSignerDocumentation?: string;
 }

package/src/legal-terms/legal-term-rmq-patterns.ts

@@ -3,3 +3,5 @@ export const LEGAL_TERM_TEMPLATE_UPSERT = 'legalTerm.template.upsert';
 export const LEGAL_TERM_DISPATCH_CREATE = 'legalTerm.dispatch.create';
 export const LEGAL_TERM_DISPATCH_LIST_BY_PATIENT = 'legalTerm.dispatch.listByPatient';
 export const SIGNATURE_LEGAL_ENVELOPE_CREATE = 'signature.legalEnvelope.create';
+/** Resumo de documentos por IDs (tenant + escopo); usado pela API para enriquecer dispatches. */
+export const SIGNATURE_DOCUMENTS_SUMMARY_BY_IDS = 'signature.documents.summaryByIds';

package/src/legal-terms/legal-term-signature-rpc.dto.ts

@@ -1,9 +1,11 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import {
+  IsBoolean,
   IsEmail,
   IsOptional,
   IsString,
   IsUUID,
+  Matches,
   MaxLength,
   MinLength,
   ValidateIf,
@@ -51,7 +53,11 @@ export class CreateLegalSigningEnvelopeRpcDto {
   @MinLength(1)
   renderedHtml?: string;
 
-  @ApiProperty({ example: 'termo-juridico.pdf' })
+  @ApiProperty({
+    example: 'termo-juridico.pdf',
+    description:
+      'Nome do arquivo no envelope. Com renderedHtml o PDF é gerado no signature-service (html-to-pdfmake + pdfmake); com pdfBase64, o binário enviado já é PDF.',
+  })
   @IsString()
   @MinLength(1)
   @MaxLength(255)
@@ -62,6 +68,38 @@ export class CreateLegalSigningEnvelopeRpcDto {
   @IsString()
   @MaxLength(500)
   envelopeName?: string;
+
+  @ApiPropertyOptional({
+    description:
+      'Incluir signatário da clínica (PJ) com assinatura automática na Clicksign antes do paciente. Exige conta com termo de assinatura automática válido.',
+  })
+  @IsOptional()
+  @IsBoolean()
+  tenantAutoSign?: boolean;
+
+  @ValidateIf((o: CreateLegalSigningEnvelopeRpcDto) => o.tenantAutoSign === true)
+  @IsString()
+  @MinLength(1)
+  @MaxLength(500)
+  tenantSignerName?: string;
+
+  @ValidateIf((o: CreateLegalSigningEnvelopeRpcDto) => o.tenantAutoSign === true)
+  @IsEmail()
+  @MaxLength(320)
+  tenantSignerEmail?: string;
+
+  @ValidateIf((o: CreateLegalSigningEnvelopeRpcDto) => o.tenantAutoSign === true)
+  @IsString()
+  @Matches(/^\d{4}-\d{2}-\d{2}$/, {
+    message: 'tenantSignerBirthday deve ser ISO (YYYY-MM-DD)',
+  })
+  tenantSignerBirthday?: string;
+
+  @ValidateIf((o: CreateLegalSigningEnvelopeRpcDto) => o.tenantAutoSign === true)
+  @IsString()
+  @MinLength(11)
+  @MaxLength(14)
+  tenantSignerDocumentation?: string;
 }
 
 export class CreateLegalSigningEnvelopeRpcResultDto {
@@ -80,3 +118,17 @@ export class CreateLegalSigningEnvelopeRpcResultDto {
   @ApiPropertyOptional()
   clicksignSignerId?: string;
 }
+
+/** Resposta RPC: um documento por ID solicitado (apenas linhas do tenant). */
+export type SignatureDocumentSummaryItemDto = {
+  id: string;
+  signature_status:
+    | 'pending'
+    | 'signed'
+    | 'refused'
+    | 'cancelled'
+    | 'expired';
+  patient_signed: boolean;
+  /** ISO-8601 UTC ou null */
+  signed_at: string | null;
+};