tychat-contracts 1.0.75 → 1.0.76

package/dist/connections/index.d.ts

@@ -1,2 +1,3 @@
 export * from './connections.dto';
+export * from './whatsapp-official.dto';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connections/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/connections/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC"}

package/dist/connections/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./connections.dto"), exports);
+__exportStar(require("./whatsapp-official.dto"), exports);

package/dist/connections/whatsapp-official.dto.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Payload to register a WhatsApp Official (Meta Cloud API) instance for a tenant.
+ * Requires the access token, phone number ID, and WhatsApp Business Account ID
+ * obtained from the Meta developer portal.
+ */
+export declare class CreateWhatsAppOfficialInstanceDto {
+    accessToken: string;
+    phoneNumberId: string;
+    wabaId: string;
+    webhookVerifyToken?: string;
+}
+/**
+ * Payload to send a pre-approved template message via WhatsApp Official (Meta Cloud API).
+ * Templates must be created and approved in the Meta Business Manager before use.
+ */
+export declare class SendWhatsAppOfficialTemplateDto {
+    to: string;
+    templateName: string;
+    languageCode: string;
+    bodyParameters?: string[];
+    headerParameters?: string[];
+}
+/**
+ * Payload to send a free-form text message via WhatsApp Official (Meta Cloud API).
+ * Only works within the 24-hour customer service window.
+ */
+export declare class SendWhatsAppOfficialTextDto {
+    to: string;
+    text: string;
+}
+//# sourceMappingURL=whatsapp-official.dto.d.ts.map

package/dist/connections/whatsapp-official.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-official.dto.d.ts","sourceRoot":"","sources":["../../src/connections/whatsapp-official.dto.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,qBAAa,iCAAiC;IAO5C,WAAW,EAAE,MAAM,CAAC;IAQpB,aAAa,EAAE,MAAM,CAAC;IAQtB,MAAM,EAAE,MAAM,CAAC;IAQf,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,+BAA+B;IAO1C,EAAE,EAAE,MAAM,CAAC;IAQX,YAAY,EAAE,MAAM,CAAC;IAQrB,YAAY,EAAE,MAAM,CAAC;IAWrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAS1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,2BAA2B;IAOtC,EAAE,EAAE,MAAM,CAAC;IAQX,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/connections/whatsapp-official.dto.js

@@ -0,0 +1,149 @@
+"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.SendWhatsAppOfficialTextDto = exports.SendWhatsAppOfficialTemplateDto = exports.CreateWhatsAppOfficialInstanceDto = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+/**
+ * Payload to register a WhatsApp Official (Meta Cloud API) instance for a tenant.
+ * Requires the access token, phone number ID, and WhatsApp Business Account ID
+ * obtained from the Meta developer portal.
+ */
+class CreateWhatsAppOfficialInstanceDto {
+    accessToken;
+    phoneNumberId;
+    wabaId;
+    webhookVerifyToken;
+}
+exports.CreateWhatsAppOfficialInstanceDto = CreateWhatsAppOfficialInstanceDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Meta Cloud API permanent access token',
+        example: 'EAABs...',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateWhatsAppOfficialInstanceDto.prototype, "accessToken", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Phone Number ID from Meta Business Manager',
+        example: '106540352242922',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateWhatsAppOfficialInstanceDto.prototype, "phoneNumberId", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'WhatsApp Business Account ID (WABA ID)',
+        example: '102291529438901',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateWhatsAppOfficialInstanceDto.prototype, "wabaId", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Webhook verify token used to validate Meta webhook registration',
+        example: 'my-verify-token',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateWhatsAppOfficialInstanceDto.prototype, "webhookVerifyToken", void 0);
+/**
+ * Payload to send a pre-approved template message via WhatsApp Official (Meta Cloud API).
+ * Templates must be created and approved in the Meta Business Manager before use.
+ */
+class SendWhatsAppOfficialTemplateDto {
+    to;
+    templateName;
+    languageCode;
+    bodyParameters;
+    headerParameters;
+}
+exports.SendWhatsAppOfficialTemplateDto = SendWhatsAppOfficialTemplateDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Recipient phone number with country code (digits only)',
+        example: '5511999999999',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendWhatsAppOfficialTemplateDto.prototype, "to", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Approved template name in Meta Business Manager',
+        example: 'appointment_confirmation',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendWhatsAppOfficialTemplateDto.prototype, "templateName", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Template language code (BCP 47)',
+        example: 'pt_BR',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendWhatsAppOfficialTemplateDto.prototype, "languageCode", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Template body variable components (positional parameters). ' +
+            'Each element replaces {{1}}, {{2}}, etc. in the template body.',
+        example: ['João', '15/04/2026 às 10:00'],
+        type: [String],
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], SendWhatsAppOfficialTemplateDto.prototype, "bodyParameters", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Template header variable components (positional parameters)',
+        example: ['Clínica Saúde'],
+        type: [String],
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], SendWhatsAppOfficialTemplateDto.prototype, "headerParameters", void 0);
+/**
+ * Payload to send a free-form text message via WhatsApp Official (Meta Cloud API).
+ * Only works within the 24-hour customer service window.
+ */
+class SendWhatsAppOfficialTextDto {
+    to;
+    text;
+}
+exports.SendWhatsAppOfficialTextDto = SendWhatsAppOfficialTextDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Recipient phone number with country code (digits only)',
+        example: '5511999999999',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendWhatsAppOfficialTextDto.prototype, "to", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({
+        description: 'Plain text message body',
+        example: 'Olá! Tudo bem?',
+    }),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SendWhatsAppOfficialTextDto.prototype, "text", void 0);

package/dist/conversations/followup-config-response.dto.d.ts

@@ -25,6 +25,13 @@ export declare class FollowupConfigResponseDto {
     wellnessCheckEnabled: boolean;
     returnSuggestionDelayMinutes: number;
     returnSuggestionEnabled: boolean;
+    templateAppointmentConfirmation?: string;
+    templateSatisfactionBooking?: string;
+    templateSatisfactionFinished?: string;
+    templateNoShowReschedule?: string;
+    templateWellnessCheck?: string;
+    templateReturnSuggestion?: string;
+    templateAbandonment?: string;
     enabled: boolean;
 }
 //# sourceMappingURL=followup-config-response.dto.d.ts.map

package/dist/conversations/followup-config-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"followup-config-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-config-response.dto.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,qBAAa,yBAAyB;IAIpC,EAAE,EAAE,MAAM,CAAC;IAMX,MAAM,CAAC,EAAE,MAAM,CAAC;IAYhB,2BAA2B,EAAE,MAAM,CAAC;IAKpC,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAS9B,yBAAyB,EAAE,MAAM,CAAC;IAIlC,mBAAmB,EAAE,OAAO,CAAC;IAS7B,+BAA+B,EAAE,MAAM,CAAC;IAIxC,0BAA0B,EAAE,OAAO,CAAC;IAKpC,gCAAgC,EAAE,MAAM,CAAC;IAIzC,2BAA2B,EAAE,OAAO,CAAC;IASrC,kBAAkB,EAAE,MAAM,CAAC;IAI3B,aAAa,EAAE,OAAO,CAAC;IASvB,yBAAyB,EAAE,MAAM,CAAC;IAIlC,oBAAoB,EAAE,OAAO,CAAC;IAS9B,4BAA4B,EAAE,MAAM,CAAC;IAIrC,uBAAuB,EAAE,OAAO,CAAC;IAQjC,OAAO,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"followup-config-response.dto.d.ts","sourceRoot":"","sources":["../../src/conversations/followup-config-response.dto.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,qBAAa,yBAAyB;IAIpC,EAAE,EAAE,MAAM,CAAC;IAMX,MAAM,CAAC,EAAE,MAAM,CAAC;IAYhB,2BAA2B,EAAE,MAAM,CAAC;IAKpC,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAK9B,qBAAqB,EAAE,MAAM,CAAC;IAS9B,yBAAyB,EAAE,MAAM,CAAC;IAIlC,mBAAmB,EAAE,OAAO,CAAC;IAS7B,+BAA+B,EAAE,MAAM,CAAC;IAIxC,0BAA0B,EAAE,OAAO,CAAC;IAKpC,gCAAgC,EAAE,MAAM,CAAC;IAIzC,2BAA2B,EAAE,OAAO,CAAC;IASrC,kBAAkB,EAAE,MAAM,CAAC;IAI3B,aAAa,EAAE,OAAO,CAAC;IASvB,yBAAyB,EAAE,MAAM,CAAC;IAIlC,oBAAoB,EAAE,OAAO,CAAC;IAS9B,4BAA4B,EAAE,MAAM,CAAC;IAIrC,uBAAuB,EAAE,OAAO,CAAC;IAYjC,+BAA+B,CAAC,EAAE,MAAM,CAAC;IAQzC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAQrC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IAQtC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAQlC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAQ/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAQlC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAQ7B,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/conversations/followup-config-response.dto.js

@@ -58,6 +58,16 @@ class FollowupConfigResponseDto {
     returnSuggestionDelayMinutes;
     returnSuggestionEnabled;
     // ---------------------------------------------------------------------------
+    // WhatsApp Official template IDs (per follow-up type)
+    // ---------------------------------------------------------------------------
+    templateAppointmentConfirmation;
+    templateSatisfactionBooking;
+    templateSatisfactionFinished;
+    templateNoShowReschedule;
+    templateWellnessCheck;
+    templateReturnSuggestion;
+    templateAbandonment;
+    // ---------------------------------------------------------------------------
     // Global setting
     // ---------------------------------------------------------------------------
     enabled;
@@ -181,6 +191,69 @@ __decorate([
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], FollowupConfigResponseDto.prototype, "returnSuggestionEnabled", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'WhatsApp Official template name for appointment confirmation follow-ups',
+        example: 'appointment_confirmation',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FollowupConfigResponseDto.prototype, "templateAppointmentConfirmation", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'WhatsApp Official template name for satisfaction booking follow-ups',
+        example: 'satisfaction_booking',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FollowupConfigResponseDto.prototype, "templateSatisfactionBooking", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'WhatsApp Official template name for satisfaction finished follow-ups',
+        example: 'satisfaction_finished',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FollowupConfigResponseDto.prototype, "templateSatisfactionFinished", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'WhatsApp Official template name for no-show reschedule follow-ups',
+        example: 'no_show_reschedule',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FollowupConfigResponseDto.prototype, "templateNoShowReschedule", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'WhatsApp Official template name for wellness check follow-ups',
+        example: 'wellness_check',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FollowupConfigResponseDto.prototype, "templateWellnessCheck", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'WhatsApp Official template name for return suggestion follow-ups',
+        example: 'return_suggestion',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FollowupConfigResponseDto.prototype, "templateReturnSuggestion", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'WhatsApp Official template name for abandonment follow-ups',
+        example: 'abandonment_followup',
+    }),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], FollowupConfigResponseDto.prototype, "templateAbandonment", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({ description: 'Whether abandonment follow-up is enabled for this tenant' }),
     (0, class_validator_1.IsBoolean)(),

package/dist/tenants/index.d.ts

@@ -1,4 +1,6 @@
 export * from './update-tenant-environment-url.dto';
 export * from './get-tenant-by-address.query.dto';
 export * from './tenant-public-by-address-response.dto';
+export * from './whatsapp-provider-kind.dto';
+export * from './tenant-slug.util';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tenants/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tenants/index.ts"],"names":[],"mappings":"AAAA,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,yCAAyC,CAAC;AACxD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC"}

package/dist/tenants/index.js

@@ -17,3 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./update-tenant-environment-url.dto"), exports);
 __exportStar(require("./get-tenant-by-address.query.dto"), exports);
 __exportStar(require("./tenant-public-by-address-response.dto"), exports);
+__exportStar(require("./whatsapp-provider-kind.dto"), exports);
+__exportStar(require("./tenant-slug.util"), exports);

package/dist/tenants/tenant-slug.util.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Utility functions for tenant slug <-> domain transformations.
+ *
+ * Convention:
+ * - Slugs stored in DB use underscores for word separation (e.g. "clinica_sampaio")
+ *   or are single words (e.g. "homolog"). Hyphens are NOT allowed in slugs.
+ * - DNS hostnames use hyphens (underscores are invalid in DNS labels).
+ * - Conversion is bijective: slug "clinica_sampaio" <-> domain "clinica-sampaio"
+ *
+ * Examples:
+ * - Slug "homolog"          -> domain segment "homolog"           -> slug "homolog"
+ * - Slug "clinica_sampaio"  -> domain segment "clinica-sampaio"   -> slug "clinica_sampaio"
+ */
+/**
+ * Converts a tenant slug to a DNS-safe domain segment.
+ * Replaces underscores with hyphens and lowercases the result.
+ *
+ * @example slugToDomainSegment("clinica_sampaio") // "clinica-sampaio"
+ * @example slugToDomainSegment("homolog")         // "homolog"
+ */
+export declare function slugToDomainSegment(slug: string): string;
+/**
+ * Converts a domain segment back to the tenant slug.
+ * Replaces hyphens with underscores (the stored DB format).
+ *
+ * @example domainSegmentToSlug("clinica-sampaio") // "clinica_sampaio"
+ * @example domainSegmentToSlug("homolog")         // "homolog"
+ */
+export declare function domainSegmentToSlug(domainSegment: string): string;
+/**
+ * Regex pattern that validates an acceptable tenant slug.
+ * Allows lowercase alphanumeric characters and underscores only (no hyphens).
+ * Must start and end with an alphanumeric character.
+ * Single-character slugs (e.g. "a") are allowed.
+ * Max 63 chars (DNS label limit after _ -> - conversion).
+ */
+export declare const TENANT_SLUG_REGEX: RegExp;
+/**
+ * Validates whether a slug is acceptable.
+ * Rules:
+ * - Only lowercase letters, digits, and underscores (no hyphens)
+ * - Must start and end with a letter or digit
+ * - Length between 1 and 63 characters
+ */
+export declare function isValidTenantSlug(slug: string): boolean;
+//# sourceMappingURL=tenant-slug.util.d.ts.map

package/dist/tenants/tenant-slug.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-slug.util.d.ts","sourceRoot":"","sources":["../../src/tenants/tenant-slug.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,QAAoC,CAAC;AAEnE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD"}

package/dist/tenants/tenant-slug.util.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Utility functions for tenant slug <-> domain transformations.
+ *
+ * Convention:
+ * - Slugs stored in DB use underscores for word separation (e.g. "clinica_sampaio")
+ *   or are single words (e.g. "homolog"). Hyphens are NOT allowed in slugs.
+ * - DNS hostnames use hyphens (underscores are invalid in DNS labels).
+ * - Conversion is bijective: slug "clinica_sampaio" <-> domain "clinica-sampaio"
+ *
+ * Examples:
+ * - Slug "homolog"          -> domain segment "homolog"           -> slug "homolog"
+ * - Slug "clinica_sampaio"  -> domain segment "clinica-sampaio"   -> slug "clinica_sampaio"
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TENANT_SLUG_REGEX = void 0;
+exports.slugToDomainSegment = slugToDomainSegment;
+exports.domainSegmentToSlug = domainSegmentToSlug;
+exports.isValidTenantSlug = isValidTenantSlug;
+/**
+ * Converts a tenant slug to a DNS-safe domain segment.
+ * Replaces underscores with hyphens and lowercases the result.
+ *
+ * @example slugToDomainSegment("clinica_sampaio") // "clinica-sampaio"
+ * @example slugToDomainSegment("homolog")         // "homolog"
+ */
+function slugToDomainSegment(slug) {
+    return (slug || 'default').toLowerCase().replace(/_/g, '-');
+}
+/**
+ * Converts a domain segment back to the tenant slug.
+ * Replaces hyphens with underscores (the stored DB format).
+ *
+ * @example domainSegmentToSlug("clinica-sampaio") // "clinica_sampaio"
+ * @example domainSegmentToSlug("homolog")         // "homolog"
+ */
+function domainSegmentToSlug(domainSegment) {
+    return (domainSegment || 'default').toLowerCase().replace(/-/g, '_');
+}
+/**
+ * Regex pattern that validates an acceptable tenant slug.
+ * Allows lowercase alphanumeric characters and underscores only (no hyphens).
+ * Must start and end with an alphanumeric character.
+ * Single-character slugs (e.g. "a") are allowed.
+ * Max 63 chars (DNS label limit after _ -> - conversion).
+ */
+exports.TENANT_SLUG_REGEX = /^[a-z0-9]([a-z0-9_]*[a-z0-9])?$/;
+/**
+ * Validates whether a slug is acceptable.
+ * Rules:
+ * - Only lowercase letters, digits, and underscores (no hyphens)
+ * - Must start and end with a letter or digit
+ * - Length between 1 and 63 characters
+ */
+function isValidTenantSlug(slug) {
+    if (!slug || slug.length > 63)
+        return false;
+    return exports.TENANT_SLUG_REGEX.test(slug.toLowerCase());
+}

package/dist/tenants/tenant-slug.util.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tenant-slug.util.spec.d.ts.map

package/dist/tenants/tenant-slug.util.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant-slug.util.spec.d.ts","sourceRoot":"","sources":["../../src/tenants/tenant-slug.util.spec.ts"],"names":[],"mappings":""}

package/dist/tenants/tenant-slug.util.spec.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tenant_slug_util_1 = require("./tenant-slug.util");
+describe('slugToDomainSegment', () => {
+    it('converts underscores to hyphens', () => {
+        expect((0, tenant_slug_util_1.slugToDomainSegment)('clinica_sampaio')).toBe('clinica-sampaio');
+    });
+    it('keeps single-word slugs unchanged', () => {
+        expect((0, tenant_slug_util_1.slugToDomainSegment)('homolog')).toBe('homolog');
+    });
+    it('handles multiple underscores', () => {
+        expect((0, tenant_slug_util_1.slugToDomainSegment)('my_big_clinic')).toBe('my-big-clinic');
+    });
+    it('lowercases the result', () => {
+        expect((0, tenant_slug_util_1.slugToDomainSegment)('Homolog')).toBe('homolog');
+        expect((0, tenant_slug_util_1.slugToDomainSegment)('Clinica_Sampaio')).toBe('clinica-sampaio');
+    });
+    it('returns default for empty string', () => {
+        expect((0, tenant_slug_util_1.slugToDomainSegment)('')).toBe('default');
+    });
+    it('keeps numeric slugs unchanged', () => {
+        expect((0, tenant_slug_util_1.slugToDomainSegment)('tenant01')).toBe('tenant01');
+    });
+});
+describe('domainSegmentToSlug', () => {
+    it('converts hyphens to underscores', () => {
+        expect((0, tenant_slug_util_1.domainSegmentToSlug)('clinica-sampaio')).toBe('clinica_sampaio');
+    });
+    it('keeps single-word segments unchanged', () => {
+        expect((0, tenant_slug_util_1.domainSegmentToSlug)('homolog')).toBe('homolog');
+    });
+    it('handles multiple hyphens', () => {
+        expect((0, tenant_slug_util_1.domainSegmentToSlug)('my-big-clinic')).toBe('my_big_clinic');
+    });
+    it('lowercases the result', () => {
+        expect((0, tenant_slug_util_1.domainSegmentToSlug)('Homolog')).toBe('homolog');
+    });
+    it('returns default for empty string', () => {
+        expect((0, tenant_slug_util_1.domainSegmentToSlug)('')).toBe('default');
+    });
+});
+describe('round-trip slug <-> domain', () => {
+    const cases = ['homolog', 'clinica_sampaio', 'my_big_clinic', 'tenant01', 'a'];
+    it.each(cases)('slug "%s" survives round-trip', (slug) => {
+        const domain = (0, tenant_slug_util_1.slugToDomainSegment)(slug);
+        const back = (0, tenant_slug_util_1.domainSegmentToSlug)(domain);
+        expect(back).toBe(slug);
+    });
+});
+describe('isValidTenantSlug', () => {
+    it('accepts single-word slugs', () => {
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('homolog')).toBe(true);
+    });
+    it('accepts underscore slugs', () => {
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('clinica_sampaio')).toBe(true);
+    });
+    it('accepts single char slug', () => {
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('a')).toBe(true);
+    });
+    it('accepts numeric slugs', () => {
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('tenant01')).toBe(true);
+    });
+    it('rejects hyphens', () => {
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('clinica-sampaio')).toBe(false);
+    });
+    it('rejects slugs starting with underscore', () => {
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('_invalid')).toBe(false);
+    });
+    it('rejects slugs ending with underscore', () => {
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('invalid_')).toBe(false);
+    });
+    it('rejects empty string', () => {
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('')).toBe(false);
+    });
+    it('rejects special characters', () => {
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('my.clinic')).toBe(false);
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('my clinic')).toBe(false);
+        expect((0, tenant_slug_util_1.isValidTenantSlug)('my@clinic')).toBe(false);
+    });
+    it('rejects strings longer than 63 chars', () => {
+        const longSlug = 'a'.repeat(64);
+        expect((0, tenant_slug_util_1.isValidTenantSlug)(longSlug)).toBe(false);
+    });
+    it('accepts strings exactly 63 chars', () => {
+        const slug = 'a'.repeat(63);
+        expect((0, tenant_slug_util_1.isValidTenantSlug)(slug)).toBe(true);
+    });
+});
+describe('TENANT_SLUG_REGEX', () => {
+    it('matches valid slugs', () => {
+        expect(tenant_slug_util_1.TENANT_SLUG_REGEX.test('homolog')).toBe(true);
+        expect(tenant_slug_util_1.TENANT_SLUG_REGEX.test('clinica_sampaio')).toBe(true);
+        expect(tenant_slug_util_1.TENANT_SLUG_REGEX.test('a1b2')).toBe(true);
+    });
+    it('does not match hyphens', () => {
+        expect(tenant_slug_util_1.TENANT_SLUG_REGEX.test('clinica-sampaio')).toBe(false);
+    });
+    it('does not match leading/trailing underscores', () => {
+        expect(tenant_slug_util_1.TENANT_SLUG_REGEX.test('_test')).toBe(false);
+        expect(tenant_slug_util_1.TENANT_SLUG_REGEX.test('test_')).toBe(false);
+    });
+});

package/dist/tenants/whatsapp-provider-kind.dto.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Supported WhatsApp provider types for tenant instance provisioning.
+ *
+ * - `evolution_api`: Evolution API v2 (Baileys-based unofficial).
+ * - `whatsapp_official`: Meta Cloud API (official WhatsApp Business).
+ */
+export declare const WHATSAPP_PROVIDER_KINDS: readonly ["evolution_api", "whatsapp_official"];
+export type WhatsAppProviderKindDto = (typeof WHATSAPP_PROVIDER_KINDS)[number];
+//# sourceMappingURL=whatsapp-provider-kind.dto.d.ts.map

package/dist/tenants/whatsapp-provider-kind.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-provider-kind.dto.d.ts","sourceRoot":"","sources":["../../src/tenants/whatsapp-provider-kind.dto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,iDAG1B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/tenants/whatsapp-provider-kind.dto.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WHATSAPP_PROVIDER_KINDS = void 0;
+/**
+ * Supported WhatsApp provider types for tenant instance provisioning.
+ *
+ * - `evolution_api`: Evolution API v2 (Baileys-based unofficial).
+ * - `whatsapp_official`: Meta Cloud API (official WhatsApp Business).
+ */
+exports.WHATSAPP_PROVIDER_KINDS = [
+    'evolution_api',
+    'whatsapp_official',
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tychat-contracts",
-  "version": "1.0.75",
+  "version": "1.0.76",
   "description": "DTOs compartilhados com class-validator (API e microserviços)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,6 +13,7 @@
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
     "ioredis": "^5.10.0",
+    "jest": "^30.3.0",
     "reflect-metadata": "*"
   },
   "devDependencies": {

package/src/connections/index.ts

@@ -1 +1,2 @@
 export * from './connections.dto';
+export * from './whatsapp-official.dto';

package/src/connections/whatsapp-official.dto.ts

@@ -0,0 +1,113 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Payload to register a WhatsApp Official (Meta Cloud API) instance for a tenant.
+ * Requires the access token, phone number ID, and WhatsApp Business Account ID
+ * obtained from the Meta developer portal.
+ */
+export class CreateWhatsAppOfficialInstanceDto {
+  @ApiProperty({
+    description: 'Meta Cloud API permanent access token',
+    example: 'EAABs...',
+  })
+  @IsString()
+  @IsNotEmpty()
+  accessToken: string;
+
+  @ApiProperty({
+    description: 'Phone Number ID from Meta Business Manager',
+    example: '106540352242922',
+  })
+  @IsString()
+  @IsNotEmpty()
+  phoneNumberId: string;
+
+  @ApiProperty({
+    description: 'WhatsApp Business Account ID (WABA ID)',
+    example: '102291529438901',
+  })
+  @IsString()
+  @IsNotEmpty()
+  wabaId: string;
+
+  @ApiPropertyOptional({
+    description: 'Webhook verify token used to validate Meta webhook registration',
+    example: 'my-verify-token',
+  })
+  @IsOptional()
+  @IsString()
+  webhookVerifyToken?: string;
+}
+
+/**
+ * Payload to send a pre-approved template message via WhatsApp Official (Meta Cloud API).
+ * Templates must be created and approved in the Meta Business Manager before use.
+ */
+export class SendWhatsAppOfficialTemplateDto {
+  @ApiProperty({
+    description: 'Recipient phone number with country code (digits only)',
+    example: '5511999999999',
+  })
+  @IsString()
+  @IsNotEmpty()
+  to: string;
+
+  @ApiProperty({
+    description: 'Approved template name in Meta Business Manager',
+    example: 'appointment_confirmation',
+  })
+  @IsString()
+  @IsNotEmpty()
+  templateName: string;
+
+  @ApiProperty({
+    description: 'Template language code (BCP 47)',
+    example: 'pt_BR',
+  })
+  @IsString()
+  @IsNotEmpty()
+  languageCode: string;
+
+  @ApiPropertyOptional({
+    description:
+      'Template body variable components (positional parameters). ' +
+      'Each element replaces {{1}}, {{2}}, etc. in the template body.',
+    example: ['João', '15/04/2026 às 10:00'],
+    type: [String],
+  })
+  @IsOptional()
+  @IsString({ each: true })
+  bodyParameters?: string[];
+
+  @ApiPropertyOptional({
+    description: 'Template header variable components (positional parameters)',
+    example: ['Clínica Saúde'],
+    type: [String],
+  })
+  @IsOptional()
+  @IsString({ each: true })
+  headerParameters?: string[];
+}
+
+/**
+ * Payload to send a free-form text message via WhatsApp Official (Meta Cloud API).
+ * Only works within the 24-hour customer service window.
+ */
+export class SendWhatsAppOfficialTextDto {
+  @ApiProperty({
+    description: 'Recipient phone number with country code (digits only)',
+    example: '5511999999999',
+  })
+  @IsString()
+  @IsNotEmpty()
+  to: string;
+
+  @ApiProperty({
+    description: 'Plain text message body',
+    example: 'Olá! Tudo bem?',
+  })
+  @IsString()
+  @IsNotEmpty()
+  text: string;
+}

package/src/conversations/followup-config-response.dto.ts

@@ -130,6 +130,66 @@ export class FollowupConfigResponseDto {
   @IsBoolean()
   returnSuggestionEnabled: boolean;
 
+  // ---------------------------------------------------------------------------
+  // WhatsApp Official template IDs (per follow-up type)
+  // ---------------------------------------------------------------------------
+
+  @ApiPropertyOptional({
+    description: 'WhatsApp Official template name for appointment confirmation follow-ups',
+    example: 'appointment_confirmation',
+  })
+  @IsOptional()
+  @IsString()
+  templateAppointmentConfirmation?: string;
+
+  @ApiPropertyOptional({
+    description: 'WhatsApp Official template name for satisfaction booking follow-ups',
+    example: 'satisfaction_booking',
+  })
+  @IsOptional()
+  @IsString()
+  templateSatisfactionBooking?: string;
+
+  @ApiPropertyOptional({
+    description: 'WhatsApp Official template name for satisfaction finished follow-ups',
+    example: 'satisfaction_finished',
+  })
+  @IsOptional()
+  @IsString()
+  templateSatisfactionFinished?: string;
+
+  @ApiPropertyOptional({
+    description: 'WhatsApp Official template name for no-show reschedule follow-ups',
+    example: 'no_show_reschedule',
+  })
+  @IsOptional()
+  @IsString()
+  templateNoShowReschedule?: string;
+
+  @ApiPropertyOptional({
+    description: 'WhatsApp Official template name for wellness check follow-ups',
+    example: 'wellness_check',
+  })
+  @IsOptional()
+  @IsString()
+  templateWellnessCheck?: string;
+
+  @ApiPropertyOptional({
+    description: 'WhatsApp Official template name for return suggestion follow-ups',
+    example: 'return_suggestion',
+  })
+  @IsOptional()
+  @IsString()
+  templateReturnSuggestion?: string;
+
+  @ApiPropertyOptional({
+    description: 'WhatsApp Official template name for abandonment follow-ups',
+    example: 'abandonment_followup',
+  })
+  @IsOptional()
+  @IsString()
+  templateAbandonment?: string;
+
   // ---------------------------------------------------------------------------
   // Global setting
   // ---------------------------------------------------------------------------

package/src/tenants/index.ts

@@ -1,3 +1,5 @@
 export * from './update-tenant-environment-url.dto';
 export * from './get-tenant-by-address.query.dto';
 export * from './tenant-public-by-address-response.dto';
+export * from './whatsapp-provider-kind.dto';
+export * from './tenant-slug.util';

package/src/tenants/tenant-slug.util.ts

@@ -0,0 +1,56 @@
+/**
+ * Utility functions for tenant slug <-> domain transformations.
+ *
+ * Convention:
+ * - Slugs stored in DB use underscores for word separation (e.g. "clinica_sampaio")
+ *   or are single words (e.g. "homolog"). Hyphens are NOT allowed in slugs.
+ * - DNS hostnames use hyphens (underscores are invalid in DNS labels).
+ * - Conversion is bijective: slug "clinica_sampaio" <-> domain "clinica-sampaio"
+ *
+ * Examples:
+ * - Slug "homolog"          -> domain segment "homolog"           -> slug "homolog"
+ * - Slug "clinica_sampaio"  -> domain segment "clinica-sampaio"   -> slug "clinica_sampaio"
+ */
+
+/**
+ * Converts a tenant slug to a DNS-safe domain segment.
+ * Replaces underscores with hyphens and lowercases the result.
+ *
+ * @example slugToDomainSegment("clinica_sampaio") // "clinica-sampaio"
+ * @example slugToDomainSegment("homolog")         // "homolog"
+ */
+export function slugToDomainSegment(slug: string): string {
+  return (slug || 'default').toLowerCase().replace(/_/g, '-');
+}
+
+/**
+ * Converts a domain segment back to the tenant slug.
+ * Replaces hyphens with underscores (the stored DB format).
+ *
+ * @example domainSegmentToSlug("clinica-sampaio") // "clinica_sampaio"
+ * @example domainSegmentToSlug("homolog")         // "homolog"
+ */
+export function domainSegmentToSlug(domainSegment: string): string {
+  return (domainSegment || 'default').toLowerCase().replace(/-/g, '_');
+}
+
+/**
+ * Regex pattern that validates an acceptable tenant slug.
+ * Allows lowercase alphanumeric characters and underscores only (no hyphens).
+ * Must start and end with an alphanumeric character.
+ * Single-character slugs (e.g. "a") are allowed.
+ * Max 63 chars (DNS label limit after _ -> - conversion).
+ */
+export const TENANT_SLUG_REGEX = /^[a-z0-9]([a-z0-9_]*[a-z0-9])?$/;
+
+/**
+ * Validates whether a slug is acceptable.
+ * Rules:
+ * - Only lowercase letters, digits, and underscores (no hyphens)
+ * - Must start and end with a letter or digit
+ * - Length between 1 and 63 characters
+ */
+export function isValidTenantSlug(slug: string): boolean {
+  if (!slug || slug.length > 63) return false;
+  return TENANT_SLUG_REGEX.test(slug.toLowerCase());
+}

package/src/tenants/whatsapp-provider-kind.dto.ts

@@ -0,0 +1,12 @@
+/**
+ * Supported WhatsApp provider types for tenant instance provisioning.
+ *
+ * - `evolution_api`: Evolution API v2 (Baileys-based unofficial).
+ * - `whatsapp_official`: Meta Cloud API (official WhatsApp Business).
+ */
+export const WHATSAPP_PROVIDER_KINDS = [
+  'evolution_api',
+  'whatsapp_official',
+] as const;
+
+export type WhatsAppProviderKindDto = (typeof WHATSAPP_PROVIDER_KINDS)[number];