tychat-contracts 1.3.10 → 1.3.15

package/dist/analytics/event-analytic.enum.d.ts

@@ -2,6 +2,6 @@
  * Enum of all analytic event types emitted by microservices.
  * Each value follows the pattern: `domain.action`.
  */
-export declare const EVENT_ANALYTIC_TYPES: readonly ["patient.created", "patient.updated", "patient.deleted", "patient.status_changed", "appointment.created", "appointment.updated", "appointment.canceled", "appointment.rescheduled", "appointment.no_show", "appointment.finished", "appointment.procedure_finished", "checkin.effectued", "checkout.effectued", "message.sent", "message.received", "conversation.session_started", "conversation.session_ended", "conversation.transferred_to_human", "followup.abandonment.sent", "followup.appointment_confirmation.sent", "followup.satisfaction_booking.sent", "followup.satisfaction_finished.sent", "followup.no_show_reschedule.sent", "followup.wellness_check.sent", "followup.return_suggestion.sent", "followup.satisfaction_booking.response_received", "followup.satisfaction_finished.response_received", "followup.config_updated", "payment.created", "payment.payed", "payment.refunded", "payment.canceled", "payment.overdue", "payment_gateway.payment_created", "payment_gateway.payment_confirmed", "payment_gateway.payment_failed", "payment_gateway.payment_refunded", "payment_gateway.payment_canceled", "payment_gateway.payment_expired", "payment_gateway.webhook_received", "billing.invoice_created", "billing.invoice_paid", "ai.interaction", "ai.fallback", "auth.login", "auth.logout", "auth.password_reset", "user.created", "user.updated", "user.deleted", "notification.sent", "notification.failed", "whatsapp.connection_established", "whatsapp.connection_lost", "procedure.created", "procedure.updated", "procedure.deleted", "specialty.created", "specialty.updated", "specialty.deleted", "professional.created", "professional.updated", "professional.deleted", "configuration.updated", "storage.file_uploaded", "storage.file_deleted", "tenant.created", "tenant.updated"];
+export declare const EVENT_ANALYTIC_TYPES: readonly ["patient.created", "patient.updated", "patient.deleted", "patient.status_changed", "appointment.created", "appointment.updated", "appointment.canceled", "appointment.rescheduled", "appointment.no_show", "appointment.finished", "appointment.procedure_finished", "checkin.effectued", "checkout.effectued", "message.sent", "message.received", "conversation.session_started", "conversation.session_ended", "conversation.transferred_to_human", "followup.abandonment.sent", "followup.appointment_confirmation.sent", "followup.satisfaction_booking.sent", "followup.satisfaction_finished.sent", "followup.no_show_reschedule.sent", "followup.wellness_check.sent", "followup.return_suggestion.sent", "followup.satisfaction_booking.response_received", "followup.satisfaction_finished.response_received", "followup.config_updated", "payment.created", "payment.payed", "payment.refunded", "payment.canceled", "payment.overdue", "payment_gateway.payment_created", "payment_gateway.payment_confirmed", "payment_gateway.payment_failed", "payment_gateway.payment_refunded", "payment_gateway.payment_canceled", "payment_gateway.payment_expired", "payment_gateway.webhook_received", "billing.invoice_created", "billing.invoice_paid", "ai.interaction", "ai.fallback", "auth.login", "auth.logout", "auth.password_reset", "user.created", "user.updated", "user.deleted", "notification.sent", "notification.failed", "whatsapp.connection_established", "whatsapp.connection_lost", "procedure.created", "procedure.updated", "procedure.deleted", "specialty.created", "specialty.updated", "specialty.deleted", "professional.created", "professional.updated", "professional.deleted", "configuration.updated", "legal_term.template.updated", "storage.file_uploaded", "storage.file_deleted", "tenant.created", "tenant.updated"];
 export type EventAnalyticType = (typeof EVENT_ANALYTIC_TYPES)[number];
 //# sourceMappingURL=event-analytic.enum.d.ts.map

package/dist/analytics/event-analytic.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-analytic.enum.d.ts","sourceRoot":"","sources":["../../src/analytics/event-analytic.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,8uDA6GvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"event-analytic.enum.d.ts","sourceRoot":"","sources":["../../src/analytics/event-analytic.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,6wDAgHvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/analytics/event-analytic.enum.js

@@ -89,6 +89,8 @@ exports.EVENT_ANALYTIC_TYPES = [
     'professional.deleted',
     // ── Configuration events ────────────────────────────────────────
     'configuration.updated',
+    // ── Legal term (clinic template) ────────────────────────────────
+    'legal_term.template.updated',
     // ── Storage events ──────────────────────────────────────────────
     'storage.file_uploaded',
     'storage.file_deleted',

package/dist/index.d.ts

@@ -19,4 +19,5 @@ export * from './analytics';
 export * from './cashback';
 export * from './filters';
 export * from './anamneses';
+export * from './legal-terms';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,MAAM,CAAC;AACrB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,MAAM,CAAC;AACrB,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -35,3 +35,4 @@ __exportStar(require("./analytics"), exports);
 __exportStar(require("./cashback"), exports);
 __exportStar(require("./filters"), exports);
 __exportStar(require("./anamneses"), exports);
+__exportStar(require("./legal-terms"), exports);

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

@@ -0,0 +1,5 @@
+export * from './legal-term-template.dto';
+export * from './legal-term-preview.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

@@ -0,0 +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"}

package/dist/legal-terms/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./legal-term-template.dto"), exports);
+__exportStar(require("./legal-term-preview.dto"), exports);
+__exportStar(require("./legal-term-signature-rpc.dto"), exports);
+__exportStar(require("./legal-term-rmq-patterns"), exports);

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

@@ -0,0 +1,15 @@
+/** Valores explícitos para substituição na pré-visualização (sem inferência heurística). */
+export declare class LegalTermPreviewRequestDto {
+    body_html?: string;
+    nome_paciente?: string;
+    cpf_exemplo?: string;
+    procedimento_nomes?: string[];
+    data_hora_iso?: string;
+}
+export declare class LegalTermSendDto {
+    procedureIds: string[];
+    whatsappMessage: string;
+    signerEmail?: string;
+    instanceKey?: string;
+}
+//# sourceMappingURL=legal-term-preview.dto.d.ts.map

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

@@ -0,0 +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;IAM9B,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"}

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

@@ -0,0 +1,100 @@
+"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.LegalTermSendDto = exports.LegalTermPreviewRequestDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/** Valores explícitos para substituição na pré-visualização (sem inferência heurística). */
+class LegalTermPreviewRequestDto {
+    body_html;
+    nome_paciente;
+    cpf_exemplo;
+    procedimento_nomes;
+    data_hora_iso;
+}
+exports.LegalTermPreviewRequestDto = LegalTermPreviewRequestDto;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'HTML atual do editor (rascunho); se omitido, usa o modelo salvo no banco',
+        maxLength: 500_000,
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500_000),
+    __metadata("design:type", String)
+], LegalTermPreviewRequestDto.prototype, "body_html", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Nome do paciente de exemplo' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], LegalTermPreviewRequestDto.prototype, "nome_paciente", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'CPF de exemplo (com ou sem máscara)' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(20),
+    __metadata("design:type", String)
+], LegalTermPreviewRequestDto.prototype, "cpf_exemplo", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ type: [String], description: 'Nomes de procedimentos na ordem' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], LegalTermPreviewRequestDto.prototype, "procedimento_nomes", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Data/hora ISO 8601 para {{ data_hora }}' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(40),
+    __metadata("design:type", String)
+], LegalTermPreviewRequestDto.prototype, "data_hora_iso", void 0);
+class LegalTermSendDto {
+    procedureIds;
+    whatsappMessage;
+    signerEmail;
+    instanceKey;
+}
+exports.LegalTermSendDto = LegalTermSendDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ type: [String], format: 'uuid' }),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsUUID)('4', { each: true }),
+    __metadata("design:type", Array)
+], LegalTermSendDto.prototype, "procedureIds", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Mensagem WhatsApp; deve conter exatamente {{ link_termo_juridico }}',
+        example: 'Olá, assine seu termo: {{ link_termo_juridico }}',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(4000),
+    __metadata("design:type", String)
+], LegalTermSendDto.prototype, "whatsappMessage", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'E-mail do signatário se o paciente não tiver e-mail cadastrado' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(320),
+    __metadata("design:type", String)
+], LegalTermSendDto.prototype, "signerEmail", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Instância Evolution (opcional). Se omitido, usa-se a da sessão ativa do paciente (igual a conversas).',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], LegalTermSendDto.prototype, "instanceKey", void 0);

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

@@ -0,0 +1,6 @@
+export declare const LEGAL_TERM_TEMPLATE_GET = "legalTerm.template.get";
+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";
+//# sourceMappingURL=legal-term-rmq-patterns.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,8 @@
+"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.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';

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

@@ -0,0 +1,20 @@
+/** Payload RPC: tychat-api → tychat-signature-service (criar envelope Clicksign v3). */
+export declare class CreateLegalSigningEnvelopeRpcDto {
+    tenant: string;
+    patientId: string;
+    legalTermDispatchId?: string;
+    signerName: string;
+    signerEmail: string;
+    pdfBase64?: string;
+    renderedHtml?: string;
+    documentFilename: string;
+    envelopeName?: string;
+}
+export declare class CreateLegalSigningEnvelopeRpcResultDto {
+    signatureDocumentId: string;
+    signingUrl: string;
+    clicksignEnvelopeId: string;
+    clicksignDocumentId: string;
+    clicksignSignerId?: string;
+}
+//# sourceMappingURL=legal-term-signature-rpc.dto.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,116 @@
+"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.CreateLegalSigningEnvelopeRpcResultDto = exports.CreateLegalSigningEnvelopeRpcDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/** Payload RPC: tychat-api → tychat-signature-service (criar envelope Clicksign v3). */
+class CreateLegalSigningEnvelopeRpcDto {
+    tenant;
+    patientId;
+    legalTermDispatchId;
+    signerName;
+    signerEmail;
+    pdfBase64;
+    renderedHtml;
+    documentFilename;
+    envelopeName;
+}
+exports.CreateLegalSigningEnvelopeRpcDto = CreateLegalSigningEnvelopeRpcDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'Slug do tenant' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "tenant", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ format: 'uuid' }),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "patientId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ format: 'uuid', description: 'ID do dispatch na clínica (preenchido após create se fluxo inverter)' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "legalTermDispatchId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "signerName", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.MaxLength)(320),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "signerEmail", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'PDF em base64 (sem prefixo data:); omitir se enviar renderedHtml' }),
+    (0, class_validator_1.ValidateIf)((o) => !o.renderedHtml?.trim()),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "pdfBase64", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'HTML já renderizado do termo; convertido para PDF no signature-service se pdfBase64 ausente',
+    }),
+    (0, class_validator_1.ValidateIf)((o) => !o.pdfBase64?.trim()),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "renderedHtml", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ example: 'termo-juridico.pdf' }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(255),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "documentFilename", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: 'Nome exibido do envelope na Clicksign' }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcDto.prototype, "envelopeName", void 0);
+class CreateLegalSigningEnvelopeRpcResultDto {
+    signatureDocumentId;
+    signingUrl;
+    clicksignEnvelopeId;
+    clicksignDocumentId;
+    clicksignSignerId;
+}
+exports.CreateLegalSigningEnvelopeRpcResultDto = CreateLegalSigningEnvelopeRpcResultDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ format: 'uuid' }),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcResultDto.prototype, "signatureDocumentId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcResultDto.prototype, "signingUrl", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcResultDto.prototype, "clicksignEnvelopeId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcResultDto.prototype, "clicksignDocumentId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)(),
+    __metadata("design:type", String)
+], CreateLegalSigningEnvelopeRpcResultDto.prototype, "clicksignSignerId", void 0);

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

@@ -0,0 +1,10 @@
+export declare class LegalTermTemplateDto {
+    id: string;
+    body_html: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare class UpsertLegalTermTemplateDto {
+    body_html: string;
+}
+//# sourceMappingURL=legal-term-template.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legal-term-template.dto.d.ts","sourceRoot":"","sources":["../../src/legal-terms/legal-term-template.dto.ts"],"names":[],"mappings":"AAGA,qBAAa,oBAAoB;IAE/B,EAAE,EAAE,MAAM,CAAC;IAGX,SAAS,EAAE,MAAM,CAAC;IAGlB,SAAS,EAAE,IAAI,CAAC;IAGhB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,qBAAa,0BAA0B;IAKrC,SAAS,EAAE,MAAM,CAAC;CACnB"}

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

@@ -0,0 +1,48 @@
+"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.UpsertLegalTermTemplateDto = exports.LegalTermTemplateDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+class LegalTermTemplateDto {
+    id;
+    body_html;
+    createdAt;
+    updatedAt;
+}
+exports.LegalTermTemplateDto = LegalTermTemplateDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ format: 'uuid' }),
+    __metadata("design:type", String)
+], LegalTermTemplateDto.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'HTML do termo (editor rico)' }),
+    __metadata("design:type", String)
+], LegalTermTemplateDto.prototype, "body_html", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", Date)
+], LegalTermTemplateDto.prototype, "createdAt", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)(),
+    __metadata("design:type", Date)
+], LegalTermTemplateDto.prototype, "updatedAt", void 0);
+class UpsertLegalTermTemplateDto {
+    body_html;
+}
+exports.UpsertLegalTermTemplateDto = UpsertLegalTermTemplateDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: 'HTML do termo (editor rico)', minLength: 1, maxLength: 500_000 }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MinLength)(1),
+    (0, class_validator_1.MaxLength)(500_000),
+    __metadata("design:type", String)
+], UpsertLegalTermTemplateDto.prototype, "body_html", void 0);

package/package.json

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

package/src/analytics/event-analytic.enum.ts

@@ -104,6 +104,9 @@ export const EVENT_ANALYTIC_TYPES = [
   // ── Configuration events ────────────────────────────────────────
   'configuration.updated',
 
+  // ── Legal term (clinic template) ────────────────────────────────
+  'legal_term.template.updated',
+
   // ── Storage events ──────────────────────────────────────────────
   'storage.file_uploaded',
   'storage.file_deleted',

package/src/index.ts

@@ -19,3 +19,4 @@ export * from './analytics';
 export * from './cashback';
 export * from './filters';
 export * from './anamneses';
+export * from './legal-terms';

package/src/legal-terms/index.ts

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

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

@@ -0,0 +1,69 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsArray, IsOptional, IsString, IsUUID, MaxLength, MinLength } from 'class-validator';
+
+/** Valores explícitos para substituição na pré-visualização (sem inferência heurística). */
+export class LegalTermPreviewRequestDto {
+  @ApiPropertyOptional({
+    description: 'HTML atual do editor (rascunho); se omitido, usa o modelo salvo no banco',
+    maxLength: 500_000,
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500_000)
+  body_html?: string;
+
+  @ApiPropertyOptional({ description: 'Nome do paciente de exemplo' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  nome_paciente?: string;
+
+  @ApiPropertyOptional({ description: 'CPF de exemplo (com ou sem máscara)' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(20)
+  cpf_exemplo?: string;
+
+  @ApiPropertyOptional({ type: [String], description: 'Nomes de procedimentos na ordem' })
+  @IsOptional()
+  @IsArray()
+  @IsString({ each: true })
+  procedimento_nomes?: string[];
+
+  @ApiPropertyOptional({ description: 'Data/hora ISO 8601 para {{ data_hora }}' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(40)
+  data_hora_iso?: string;
+}
+
+export class LegalTermSendDto {
+  @ApiProperty({ type: [String], format: 'uuid' })
+  @IsArray()
+  @IsUUID('4', { each: true })
+  procedureIds: string[];
+
+  @ApiProperty({
+    description: 'Mensagem WhatsApp; deve conter exatamente {{ link_termo_juridico }}',
+    example: 'Olá, assine seu termo: {{ link_termo_juridico }}',
+  })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(4000)
+  whatsappMessage: string;
+
+  @ApiPropertyOptional({ description: 'E-mail do signatário se o paciente não tiver e-mail cadastrado' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(320)
+  signerEmail?: string;
+
+  @ApiPropertyOptional({
+    description:
+      'Instância Evolution (opcional). Se omitido, usa-se a da sessão ativa do paciente (igual a conversas).',
+  })
+  @IsOptional()
+  @IsString()
+  @MaxLength(128)
+  instanceKey?: string;
+}

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

@@ -0,0 +1,5 @@
+export const LEGAL_TERM_TEMPLATE_GET = 'legalTerm.template.get';
+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';

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

@@ -0,0 +1,82 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import {
+  IsEmail,
+  IsOptional,
+  IsString,
+  IsUUID,
+  MaxLength,
+  MinLength,
+  ValidateIf,
+} from 'class-validator';
+
+/** Payload RPC: tychat-api → tychat-signature-service (criar envelope Clicksign v3). */
+export class CreateLegalSigningEnvelopeRpcDto {
+  @ApiProperty({ description: 'Slug do tenant' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(128)
+  tenant: string;
+
+  @ApiProperty({ format: 'uuid' })
+  @IsUUID('4')
+  patientId: string;
+
+  @ApiPropertyOptional({ format: 'uuid', description: 'ID do dispatch na clínica (preenchido após create se fluxo inverter)' })
+  @IsOptional()
+  @IsUUID('4')
+  legalTermDispatchId?: string;
+
+  @ApiProperty()
+  @IsString()
+  @MinLength(1)
+  @MaxLength(500)
+  signerName: string;
+
+  @ApiProperty()
+  @IsEmail()
+  @MaxLength(320)
+  signerEmail: string;
+
+  @ApiPropertyOptional({ description: 'PDF em base64 (sem prefixo data:); omitir se enviar renderedHtml' })
+  @ValidateIf((o: CreateLegalSigningEnvelopeRpcDto) => !o.renderedHtml?.trim())
+  @IsString()
+  @MinLength(1)
+  pdfBase64?: string;
+
+  @ApiPropertyOptional({
+    description: 'HTML já renderizado do termo; convertido para PDF no signature-service se pdfBase64 ausente',
+  })
+  @ValidateIf((o: CreateLegalSigningEnvelopeRpcDto) => !o.pdfBase64?.trim())
+  @IsString()
+  @MinLength(1)
+  renderedHtml?: string;
+
+  @ApiProperty({ example: 'termo-juridico.pdf' })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(255)
+  documentFilename: string;
+
+  @ApiPropertyOptional({ description: 'Nome exibido do envelope na Clicksign' })
+  @IsOptional()
+  @IsString()
+  @MaxLength(500)
+  envelopeName?: string;
+}
+
+export class CreateLegalSigningEnvelopeRpcResultDto {
+  @ApiProperty({ format: 'uuid' })
+  signatureDocumentId: string;
+
+  @ApiProperty()
+  signingUrl: string;
+
+  @ApiProperty()
+  clicksignEnvelopeId: string;
+
+  @ApiProperty()
+  clicksignDocumentId: string;
+
+  @ApiPropertyOptional()
+  clicksignSignerId?: string;
+}

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

@@ -0,0 +1,24 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString, MaxLength, MinLength } from 'class-validator';
+
+export class LegalTermTemplateDto {
+  @ApiProperty({ format: 'uuid' })
+  id: string;
+
+  @ApiProperty({ description: 'HTML do termo (editor rico)' })
+  body_html: string;
+
+  @ApiProperty()
+  createdAt: Date;
+
+  @ApiProperty()
+  updatedAt: Date;
+}
+
+export class UpsertLegalTermTemplateDto {
+  @ApiProperty({ description: 'HTML do termo (editor rico)', minLength: 1, maxLength: 500_000 })
+  @IsString()
+  @MinLength(1)
+  @MaxLength(500_000)
+  body_html: string;
+}