@fiado/type-kit 3.29.0 → 3.31.0

package/bin/messagesConnector/dtos/TemplateMessageCreateRequest.d.ts

@@ -0,0 +1,16 @@
+import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+/**
+ * Body para POST /templates (backoffice). Identifica un template por sus 4
+ * componentes de PK (messageType, channelType, language, country) + campos
+ * de contenido. `typeOfDirectoryId` es campo no-key del Row (ver TD pendiente).
+ */
+export declare class TemplateMessageCreateRequest {
+    messageType: string;
+    channelType: DeliveryChannelEnum;
+    language: string;
+    country: string;
+    typeOfDirectoryId: string;
+    template: string;
+    contentType: ContentTypeEnum;
+    subject?: string;
+}

package/bin/messagesConnector/dtos/TemplateMessageCreateRequest.js

@@ -0,0 +1,72 @@
+"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.TemplateMessageCreateRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const messaging_1 = require("../../messaging");
+const IsTemplatePlaceholders_1 = require("../validators/IsTemplatePlaceholders");
+/**
+ * Body para POST /templates (backoffice). Identifica un template por sus 4
+ * componentes de PK (messageType, channelType, language, country) + campos
+ * de contenido. `typeOfDirectoryId` es campo no-key del Row (ver TD pendiente).
+ */
+class TemplateMessageCreateRequest {
+}
+exports.TemplateMessageCreateRequest = TemplateMessageCreateRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "messageType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(messaging_1.DeliveryChannelEnum),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "channelType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "language", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "country", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "typeOfDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Validate)(IsTemplatePlaceholders_1.IsTemplatePlaceholders),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "template", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(messaging_1.ContentTypeEnum),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "contentType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Validate)(IsTemplatePlaceholders_1.IsTemplatePlaceholders),
+    __metadata("design:type", String)
+], TemplateMessageCreateRequest.prototype, "subject", void 0);

package/bin/messagesConnector/dtos/TemplateMessageListFiltersRequest.d.ts

@@ -0,0 +1,14 @@
+import { DeliveryChannelEnum } from '../../messaging';
+/**
+ * Query string de GET /templates. Todos los filtros son opcionales; si todos
+ * estan vacios, lista todo (scan paginado). `limit` default 20, max 100.
+ */
+export declare class TemplateMessageListFiltersRequest {
+    messageType?: string;
+    channelType?: DeliveryChannelEnum;
+    language?: string;
+    country?: string;
+    typeOfDirectoryId?: string;
+    limit?: number;
+    cursor?: string;
+}

package/bin/messagesConnector/dtos/TemplateMessageListFiltersRequest.js

@@ -0,0 +1,67 @@
+"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.TemplateMessageListFiltersRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const messaging_1 = require("../../messaging");
+/**
+ * Query string de GET /templates. Todos los filtros son opcionales; si todos
+ * estan vacios, lista todo (scan paginado). `limit` default 20, max 100.
+ */
+class TemplateMessageListFiltersRequest {
+}
+exports.TemplateMessageListFiltersRequest = TemplateMessageListFiltersRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TemplateMessageListFiltersRequest.prototype, "messageType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(messaging_1.DeliveryChannelEnum),
+    __metadata("design:type", String)
+], TemplateMessageListFiltersRequest.prototype, "channelType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TemplateMessageListFiltersRequest.prototype, "language", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TemplateMessageListFiltersRequest.prototype, "country", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TemplateMessageListFiltersRequest.prototype, "typeOfDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], TemplateMessageListFiltersRequest.prototype, "limit", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], TemplateMessageListFiltersRequest.prototype, "cursor", void 0);

package/bin/messagesConnector/dtos/TemplateMessageListResponse.d.ts

@@ -0,0 +1,10 @@
+import { TemplateMessageResponse } from './TemplateMessageResponse';
+/**
+ * Forma del response de GET /templates (list con filtros + paginacion cursor).
+ * `cursor` es opaco (base64 del LastEvaluatedKey de DDB) y el cliente lo pasa
+ * tal cual al siguiente GET. Si no hay mas paginas, se omite.
+ */
+export declare class TemplateMessageListResponse {
+    items: TemplateMessageResponse[];
+    cursor?: string;
+}

package/bin/messagesConnector/dtos/TemplateMessageListResponse.js

@@ -0,0 +1,31 @@
+"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.TemplateMessageListResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const TemplateMessageResponse_1 = require("./TemplateMessageResponse");
+/**
+ * Forma del response de GET /templates (list con filtros + paginacion cursor).
+ * `cursor` es opaco (base64 del LastEvaluatedKey de DDB) y el cliente lo pasa
+ * tal cual al siguiente GET. Si no hay mas paginas, se omite.
+ */
+class TemplateMessageListResponse {
+}
+exports.TemplateMessageListResponse = TemplateMessageListResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Type)(() => TemplateMessageResponse_1.TemplateMessageResponse),
+    __metadata("design:type", Array)
+], TemplateMessageListResponse.prototype, "items", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageListResponse.prototype, "cursor", void 0);

package/bin/messagesConnector/dtos/TemplateMessageResponse.d.ts

@@ -0,0 +1,23 @@
+import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+/**
+ * Forma del template retornada por GET /templates/{id}, POST, PUT.
+ * El `id` es opaco (base64url de la PK compuesta) y el cliente lo trata como
+ * string sin parsear. El `pk` se incluye para auditoria/debug pero NO se usa
+ * como identificador del recurso en otras llamadas.
+ */
+export declare class TemplateMessageResponse {
+    id: string;
+    pk: string;
+    messageType: string;
+    channelType: DeliveryChannelEnum;
+    language: string;
+    country: string;
+    typeOfDirectoryId: string;
+    template: string;
+    contentType: ContentTypeEnum;
+    subject?: string;
+    createdAt: number;
+    updatedAt: number;
+    createdBy?: string;
+    updatedBy?: string;
+}

package/bin/messagesConnector/dtos/TemplateMessageResponse.js

@@ -0,0 +1,79 @@
+"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.TemplateMessageResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const messaging_1 = require("../../messaging");
+/**
+ * Forma del template retornada por GET /templates/{id}, POST, PUT.
+ * El `id` es opaco (base64url de la PK compuesta) y el cliente lo trata como
+ * string sin parsear. El `pk` se incluye para auditoria/debug pero NO se usa
+ * como identificador del recurso en otras llamadas.
+ */
+class TemplateMessageResponse {
+}
+exports.TemplateMessageResponse = TemplateMessageResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "id", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "pk", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "messageType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "channelType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "language", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "country", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "typeOfDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "template", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "contentType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "subject", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], TemplateMessageResponse.prototype, "createdAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], TemplateMessageResponse.prototype, "updatedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "createdBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], TemplateMessageResponse.prototype, "updatedBy", void 0);

package/bin/messagesConnector/dtos/TemplateMessageUpdateRequest.d.ts

@@ -0,0 +1,16 @@
+import { ContentTypeEnum } from '../../messaging';
+/**
+ * Body para PUT /templates/{id} (backoffice). Solo campos no-key son mutables.
+ * Los componentes del PK (messageType, channelType, language, country) viven
+ * en el `{id}` opaco del path y NO se aceptan en el body (PK structurally
+ * immutable - ver spec seccion "Mutabilidad PK").
+ *
+ * La validacion cross-field (subject required ⇔ MAIL, HTML solo en MAIL) se
+ * hace en el manager con el channelType decodificado del path, no aca.
+ */
+export declare class TemplateMessageUpdateRequest {
+    typeOfDirectoryId?: string;
+    template?: string;
+    contentType?: ContentTypeEnum;
+    subject?: string;
+}

package/bin/messagesConnector/dtos/TemplateMessageUpdateRequest.js

@@ -0,0 +1,56 @@
+"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.TemplateMessageUpdateRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const messaging_1 = require("../../messaging");
+const IsTemplatePlaceholders_1 = require("../validators/IsTemplatePlaceholders");
+/**
+ * Body para PUT /templates/{id} (backoffice). Solo campos no-key son mutables.
+ * Los componentes del PK (messageType, channelType, language, country) viven
+ * en el `{id}` opaco del path y NO se aceptan en el body (PK structurally
+ * immutable - ver spec seccion "Mutabilidad PK").
+ *
+ * La validacion cross-field (subject required ⇔ MAIL, HTML solo en MAIL) se
+ * hace en el manager con el channelType decodificado del path, no aca.
+ */
+class TemplateMessageUpdateRequest {
+}
+exports.TemplateMessageUpdateRequest = TemplateMessageUpdateRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], TemplateMessageUpdateRequest.prototype, "typeOfDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Validate)(IsTemplatePlaceholders_1.IsTemplatePlaceholders),
+    __metadata("design:type", String)
+], TemplateMessageUpdateRequest.prototype, "template", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(messaging_1.ContentTypeEnum),
+    __metadata("design:type", String)
+], TemplateMessageUpdateRequest.prototype, "contentType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Validate)(IsTemplatePlaceholders_1.IsTemplatePlaceholders),
+    __metadata("design:type", String)
+], TemplateMessageUpdateRequest.prototype, "subject", void 0);

package/bin/messagesConnector/index.d.ts

@@ -9,3 +9,9 @@ export * from './dtos/NotificationsPageResponse';
 export * from './dtos/NotificationsCursorResponse';
 export * from './dtos/NotificationsV3Response';
 export * from './dtos/MessagesByDestinationResponse';
+export * from './validators/IsTemplatePlaceholders';
+export * from './dtos/TemplateMessageCreateRequest';
+export * from './dtos/TemplateMessageUpdateRequest';
+export * from './dtos/TemplateMessageResponse';
+export * from './dtos/TemplateMessageListResponse';
+export * from './dtos/TemplateMessageListFiltersRequest';

package/bin/messagesConnector/index.js

@@ -25,3 +25,9 @@ __exportStar(require("./dtos/NotificationsPageResponse"), exports);
 __exportStar(require("./dtos/NotificationsCursorResponse"), exports);
 __exportStar(require("./dtos/NotificationsV3Response"), exports);
 __exportStar(require("./dtos/MessagesByDestinationResponse"), exports);
+__exportStar(require("./validators/IsTemplatePlaceholders"), exports);
+__exportStar(require("./dtos/TemplateMessageCreateRequest"), exports);
+__exportStar(require("./dtos/TemplateMessageUpdateRequest"), exports);
+__exportStar(require("./dtos/TemplateMessageResponse"), exports);
+__exportStar(require("./dtos/TemplateMessageListResponse"), exports);
+__exportStar(require("./dtos/TemplateMessageListFiltersRequest"), exports);

package/bin/messagesConnector/validators/IsTemplatePlaceholders.d.ts

@@ -0,0 +1,15 @@
+import { ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+/**
+ * Valida que un string solo contenga placeholders bien formados `{varName}` donde
+ * `varName` matchea `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
+ *  - Placeholders con espacios o caracteres invalidos (`{var name}`, `{var-1}`).
+ *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}` ).
+ *  - Placeholders vacios (`{}`).
+ * Acepta texto sin placeholders en absoluto.
+ *
+ * Uso en DTOs: `@Validate(IsTemplatePlaceholders)` sobre un campo string.
+ */
+export declare class IsTemplatePlaceholders implements ValidatorConstraintInterface {
+    validate(value: unknown): boolean;
+    defaultMessage(args: ValidationArguments): string;
+}

package/bin/messagesConnector/validators/IsTemplatePlaceholders.js

@@ -0,0 +1,58 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsTemplatePlaceholders = void 0;
+const class_validator_1 = require("class-validator");
+const VALID_PLACEHOLDER = /^[a-zA-Z][a-zA-Z0-9_]*$/;
+/**
+ * Valida que un string solo contenga placeholders bien formados `{varName}` donde
+ * `varName` matchea `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
+ *  - Placeholders con espacios o caracteres invalidos (`{var name}`, `{var-1}`).
+ *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}` ).
+ *  - Placeholders vacios (`{}`).
+ * Acepta texto sin placeholders en absoluto.
+ *
+ * Uso en DTOs: `@Validate(IsTemplatePlaceholders)` sobre un campo string.
+ */
+let IsTemplatePlaceholders = class IsTemplatePlaceholders {
+    validate(value) {
+        if (typeof value !== 'string')
+            return false;
+        // Detectar llaves desbalanceadas con un single-pass.
+        let depth = 0;
+        for (const ch of value) {
+            if (ch === '{') {
+                if (depth > 0)
+                    return false; // anidado no permitido
+                depth = 1;
+            }
+            else if (ch === '}') {
+                if (depth === 0)
+                    return false; // cierre sin apertura
+                depth = 0;
+            }
+        }
+        if (depth !== 0)
+            return false; // apertura sin cierre
+        // Validar que cada `{...}` matchea el regex.
+        const matches = value.match(/\{([^}]*)\}/g) ?? [];
+        for (const raw of matches) {
+            const inner = raw.slice(1, -1);
+            if (!VALID_PLACEHOLDER.test(inner))
+                return false;
+        }
+        return true;
+    }
+    defaultMessage(args) {
+        return `${args.property} contiene placeholders mal formados; debe seguir el patron {nombre} con nombre = [a-zA-Z][a-zA-Z0-9_]*`;
+    }
+};
+exports.IsTemplatePlaceholders = IsTemplatePlaceholders;
+exports.IsTemplatePlaceholders = IsTemplatePlaceholders = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'IsTemplatePlaceholders', async: false })
+], IsTemplatePlaceholders);

package/bin/remittance/dtos/RemittancePayerAdditionalFieldDto.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Campo adicional requerido por un payer/receptionMethod, devuelto por el
+ * endpoint público `GET /remittance/payers/{code}/fields?...`.
+ *
+ * El frontend renderiza un control según `fieldType` y valida con `regex` /
+ * `minLen`/`maxLen` antes de submit. El valor capturado se envía al backend
+ * como `additionalFieldInfo: [{ name, value }, ...]` en la request de
+ * AddBeneficiary o SendMoneyPreview.
+ *
+ * Ejemplo real (Banco Industrial GTQ Account Credit): 1 field `accountType`
+ * dropdown con opciones { key:"01", value:"Checking" }, { key:"02", value:"Savings" }.
+ */
+export interface RemittancePayerAdditionalFieldDto {
+    fieldName: string;
+    fieldLabel: string;
+    /** "dropdown" | "text" | "number" | etc. — UI elige control según este valor. */
+    fieldType: string;
+    required: boolean;
+    /** Solo si `fieldType === "dropdown"`. */
+    fieldOptions?: Array<{
+        key: string;
+        value: string;
+    }>;
+    regex?: string;
+    minLen?: number;
+    maxLen?: number;
+    errorMsg?: string;
+    /** Mensaje informativo (no de error) que la UI puede mostrar como helper text. */
+    fieldMsg?: string;
+}

package/bin/remittance/dtos/RemittancePayerAdditionalFieldDto.js

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

package/bin/remittance/dtos/RemittancePayerBranchDto.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Sucursal de un payer (para método Cash Pickup), devuelta por el endpoint
+ * público `GET /remittance/payers/{code}/branches?...`.
+ *
+ * El frontend la consume en el flow de "Enviar dinero" cuando el beneficiario
+ * tiene `receptionMethod === "CASH_PICKUP"` y el payer marca `requiresBranch = true`.
+ *
+ * Nota de tamaño: un payer puede tener cientos de sucursales (ej. Gyt Continental
+ * GT ~300). Diseñar el UI con un buscador local sobre `name`/`address.city`.
+ */
+export interface RemittancePayerBranchDto {
+    branchCode: string;
+    name: string;
+    /** Horario de atención en formato libre (ej. "0900AM-0500PM"). */
+    branchHours?: string;
+    phoneNumber?: string;
+    address?: RemittancePayerBranchAddressDto;
+}
+export interface RemittancePayerBranchAddressDto {
+    address1?: string;
+    city?: string;
+    /** Código ISO 3166-2 (ej. "GT-GU"). */
+    state?: string;
+    stateName?: string;
+    country?: string;
+    countryISOCode?: string;
+    zipCode?: string;
+}

package/bin/remittance/dtos/RemittancePayerBranchDto.js

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

package/bin/remittance/dtos/RemittancePayerDto.d.ts

@@ -0,0 +1,34 @@
+import { ReceptionMethod } from "../enums/ReceptionMethod";
+/**
+ * Payer disponible para un país+currency, devuelto por el endpoint público
+ * `GET /remittance/countries/{iso}/payers?currencyISO=XXX`.
+ *
+ * Lo consume el frontend en Pantalla 9 (Método + Payer) del wizard de agregar
+ * beneficiario. Provee toda la metadata necesaria para que la app:
+ *  1. Muestre los métodos de recepción soportados por el payer.
+ *  2. Decida si el wizard debe mostrar el paso de "selección de sucursal"
+ *     (`requiresBranch === true`) o el de "campos adicionales"
+ *     (`requiresAdditionalFields === true`).
+ *  3. Valide el `accNumber` del lado del cliente con `accNumberRegex` antes
+ *     de hacer submit (mejor UX que esperar 400 del backend).
+ */
+export interface RemittancePayerDto {
+    /** Código UNIR del payer (ej. "GCA10" Banrural). Usado como `payerCode` en AddBeneficiary. */
+    payerCode: string;
+    /** Nombre legible (ej. "Banrural", "B. Industrial"). */
+    name: string;
+    /** Métodos de recepción soportados por este payer en este país+currency. */
+    receptionMethods: ReceptionMethod[];
+    /** Si true, hay que llamar a `/remittance/payers/{code}/branches` cuando el usuario elige Cash Pickup. */
+    requiresBranch: boolean;
+    /** Si true, hay que llamar a `/remittance/payers/{code}/fields` para conocer campos extra requeridos. */
+    requiresAdditionalFields: boolean;
+    /** Regex de validación del `accNumber` (solo si `receptionMethod` = ACCOUNT_CREDIT). */
+    accNumberRegex?: string;
+    /** Mensaje legible para mostrar al usuario cuando el `accNumber` no pasa el regex. */
+    accNumberHelperText?: string;
+    /** URL absoluta del logo del payer (puede no venir). */
+    logoUrl?: string;
+    /** Orden de aparición sugerido por UNIR (asc). */
+    sortOrder?: number;
+}

package/bin/remittance/dtos/RemittancePayerDto.js

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

package/bin/remittance/dtos/RemittanceStateDto.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado / departamento del país destino de una remesa.
+ * Devuelto por el endpoint público `GET /remittance/countries/{iso}/states`.
+ *
+ * `stateISO` viene en formato ISO 3166-2 (ej. "GT-GU" Guatemala, "SV-SS" San Salvador,
+ * "HN-AT" Atlántida, "NI-MN" Managua).
+ */
+export interface RemittanceStateDto {
+    stateISO: string;
+    name: string;
+}

package/bin/remittance/dtos/RemittanceStateDto.js

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

package/bin/remittance/dtos/index.d.ts

@@ -13,3 +13,7 @@ export * from "./RemittanceSendPreviewResponse";
 export * from "./RemittanceTransaction";
 export * from "./RemittanceLimitsInfo";
 export * from "./RemittanceHomeResponse";
+export * from "./RemittanceStateDto";
+export * from "./RemittancePayerDto";
+export * from "./RemittancePayerBranchDto";
+export * from "./RemittancePayerAdditionalFieldDto";

package/bin/remittance/dtos/index.js

@@ -29,3 +29,7 @@ __exportStar(require("./RemittanceSendPreviewResponse"), exports);
 __exportStar(require("./RemittanceTransaction"), exports);
 __exportStar(require("./RemittanceLimitsInfo"), exports);
 __exportStar(require("./RemittanceHomeResponse"), exports);
+__exportStar(require("./RemittanceStateDto"), exports);
+__exportStar(require("./RemittancePayerDto"), exports);
+__exportStar(require("./RemittancePayerBranchDto"), exports);
+__exportStar(require("./RemittancePayerAdditionalFieldDto"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.29.0",
+  "version": "3.31.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/messagesConnector/dtos/TemplateMessageCreateRequest.ts

@@ -0,0 +1,51 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsOptional, IsString, Validate } from 'class-validator';
+import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+import { IsTemplatePlaceholders } from '../validators/IsTemplatePlaceholders';
+
+/**
+ * Body para POST /templates (backoffice). Identifica un template por sus 4
+ * componentes de PK (messageType, channelType, language, country) + campos
+ * de contenido. `typeOfDirectoryId` es campo no-key del Row (ver TD pendiente).
+ */
+export class TemplateMessageCreateRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    messageType!: string;
+
+    @Expose()
+    @IsEnum(DeliveryChannelEnum)
+    channelType!: DeliveryChannelEnum;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    language!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    country!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    typeOfDirectoryId!: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @Validate(IsTemplatePlaceholders)
+    template!: string;
+
+    @Expose()
+    @IsEnum(ContentTypeEnum)
+    contentType!: ContentTypeEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Validate(IsTemplatePlaceholders)
+    subject?: string;
+}

package/src/messagesConnector/dtos/TemplateMessageListFiltersRequest.ts

@@ -0,0 +1,47 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+import { DeliveryChannelEnum } from '../../messaging';
+
+/**
+ * Query string de GET /templates. Todos los filtros son opcionales; si todos
+ * estan vacios, lista todo (scan paginado). `limit` default 20, max 100.
+ */
+export class TemplateMessageListFiltersRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    messageType?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(DeliveryChannelEnum)
+    channelType?: DeliveryChannelEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    language?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    country?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    typeOfDirectoryId?: string;
+
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    limit?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    cursor?: string;
+}

package/src/messagesConnector/dtos/TemplateMessageListResponse.ts

@@ -0,0 +1,16 @@
+import { Expose, Type } from 'class-transformer';
+import { TemplateMessageResponse } from './TemplateMessageResponse';
+
+/**
+ * Forma del response de GET /templates (list con filtros + paginacion cursor).
+ * `cursor` es opaco (base64 del LastEvaluatedKey de DDB) y el cliente lo pasa
+ * tal cual al siguiente GET. Si no hay mas paginas, se omite.
+ */
+export class TemplateMessageListResponse {
+    @Expose()
+    @Type(() => TemplateMessageResponse)
+    items!: TemplateMessageResponse[];
+
+    @Expose()
+    cursor?: string;
+}

package/src/messagesConnector/dtos/TemplateMessageResponse.ts

@@ -0,0 +1,52 @@
+import { Expose } from 'class-transformer';
+import { ContentTypeEnum, DeliveryChannelEnum } from '../../messaging';
+
+/**
+ * Forma del template retornada por GET /templates/{id}, POST, PUT.
+ * El `id` es opaco (base64url de la PK compuesta) y el cliente lo trata como
+ * string sin parsear. El `pk` se incluye para auditoria/debug pero NO se usa
+ * como identificador del recurso en otras llamadas.
+ */
+export class TemplateMessageResponse {
+    @Expose()
+    id!: string;
+
+    @Expose()
+    pk!: string;
+
+    @Expose()
+    messageType!: string;
+
+    @Expose()
+    channelType!: DeliveryChannelEnum;
+
+    @Expose()
+    language!: string;
+
+    @Expose()
+    country!: string;
+
+    @Expose()
+    typeOfDirectoryId!: string;
+
+    @Expose()
+    template!: string;
+
+    @Expose()
+    contentType!: ContentTypeEnum;
+
+    @Expose()
+    subject?: string;
+
+    @Expose()
+    createdAt!: number;
+
+    @Expose()
+    updatedAt!: number;
+
+    @Expose()
+    createdBy?: string;
+
+    @Expose()
+    updatedBy?: string;
+}

package/src/messagesConnector/dtos/TemplateMessageUpdateRequest.ts

@@ -0,0 +1,39 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsOptional, IsString, Validate } from 'class-validator';
+import { ContentTypeEnum } from '../../messaging';
+import { IsTemplatePlaceholders } from '../validators/IsTemplatePlaceholders';
+
+/**
+ * Body para PUT /templates/{id} (backoffice). Solo campos no-key son mutables.
+ * Los componentes del PK (messageType, channelType, language, country) viven
+ * en el `{id}` opaco del path y NO se aceptan en el body (PK structurally
+ * immutable - ver spec seccion "Mutabilidad PK").
+ *
+ * La validacion cross-field (subject required ⇔ MAIL, HTML solo en MAIL) se
+ * hace en el manager con el channelType decodificado del path, no aca.
+ */
+export class TemplateMessageUpdateRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    typeOfDirectoryId?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @Validate(IsTemplatePlaceholders)
+    template?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(ContentTypeEnum)
+    contentType?: ContentTypeEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Validate(IsTemplatePlaceholders)
+    subject?: string;
+}

package/src/messagesConnector/index.ts

@@ -9,3 +9,9 @@ export * from './dtos/NotificationsPageResponse';
 export * from './dtos/NotificationsCursorResponse';
 export * from './dtos/NotificationsV3Response';
 export * from './dtos/MessagesByDestinationResponse';
+export * from './validators/IsTemplatePlaceholders';
+export * from './dtos/TemplateMessageCreateRequest';
+export * from './dtos/TemplateMessageUpdateRequest';
+export * from './dtos/TemplateMessageResponse';
+export * from './dtos/TemplateMessageListResponse';
+export * from './dtos/TemplateMessageListFiltersRequest';

package/src/messagesConnector/validators/IsTemplatePlaceholders.ts

@@ -0,0 +1,45 @@
+import { ValidatorConstraint, ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+
+const VALID_PLACEHOLDER = /^[a-zA-Z][a-zA-Z0-9_]*$/;
+
+/**
+ * Valida que un string solo contenga placeholders bien formados `{varName}` donde
+ * `varName` matchea `^[a-zA-Z][a-zA-Z0-9_]*$`. Rechaza:
+ *  - Placeholders con espacios o caracteres invalidos (`{var name}`, `{var-1}`).
+ *  - Llaves sin balancear (`abc {def`, `abc } def`, `{ {nested}` ).
+ *  - Placeholders vacios (`{}`).
+ * Acepta texto sin placeholders en absoluto.
+ *
+ * Uso en DTOs: `@Validate(IsTemplatePlaceholders)` sobre un campo string.
+ */
+@ValidatorConstraint({ name: 'IsTemplatePlaceholders', async: false })
+export class IsTemplatePlaceholders implements ValidatorConstraintInterface {
+    validate(value: unknown): boolean {
+        if (typeof value !== 'string') return false;
+
+        // Detectar llaves desbalanceadas con un single-pass.
+        let depth = 0;
+        for (const ch of value) {
+            if (ch === '{') {
+                if (depth > 0) return false; // anidado no permitido
+                depth = 1;
+            } else if (ch === '}') {
+                if (depth === 0) return false; // cierre sin apertura
+                depth = 0;
+            }
+        }
+        if (depth !== 0) return false; // apertura sin cierre
+
+        // Validar que cada `{...}` matchea el regex.
+        const matches = value.match(/\{([^}]*)\}/g) ?? [];
+        for (const raw of matches) {
+            const inner = raw.slice(1, -1);
+            if (!VALID_PLACEHOLDER.test(inner)) return false;
+        }
+        return true;
+    }
+
+    defaultMessage(args: ValidationArguments): string {
+        return `${args.property} contiene placeholders mal formados; debe seguir el patron {nombre} con nombre = [a-zA-Z][a-zA-Z0-9_]*`;
+    }
+}

package/src/remittance/dtos/RemittancePayerAdditionalFieldDto.ts

@@ -0,0 +1,27 @@
+/**
+ * Campo adicional requerido por un payer/receptionMethod, devuelto por el
+ * endpoint público `GET /remittance/payers/{code}/fields?...`.
+ *
+ * El frontend renderiza un control según `fieldType` y valida con `regex` /
+ * `minLen`/`maxLen` antes de submit. El valor capturado se envía al backend
+ * como `additionalFieldInfo: [{ name, value }, ...]` en la request de
+ * AddBeneficiary o SendMoneyPreview.
+ *
+ * Ejemplo real (Banco Industrial GTQ Account Credit): 1 field `accountType`
+ * dropdown con opciones { key:"01", value:"Checking" }, { key:"02", value:"Savings" }.
+ */
+export interface RemittancePayerAdditionalFieldDto {
+    fieldName: string;
+    fieldLabel: string;
+    /** "dropdown" | "text" | "number" | etc. — UI elige control según este valor. */
+    fieldType: string;
+    required: boolean;
+    /** Solo si `fieldType === "dropdown"`. */
+    fieldOptions?: Array<{ key: string; value: string }>;
+    regex?: string;
+    minLen?: number;
+    maxLen?: number;
+    errorMsg?: string;
+    /** Mensaje informativo (no de error) que la UI puede mostrar como helper text. */
+    fieldMsg?: string;
+}

package/src/remittance/dtos/RemittancePayerBranchDto.ts

@@ -0,0 +1,29 @@
+/**
+ * Sucursal de un payer (para método Cash Pickup), devuelta por el endpoint
+ * público `GET /remittance/payers/{code}/branches?...`.
+ *
+ * El frontend la consume en el flow de "Enviar dinero" cuando el beneficiario
+ * tiene `receptionMethod === "CASH_PICKUP"` y el payer marca `requiresBranch = true`.
+ *
+ * Nota de tamaño: un payer puede tener cientos de sucursales (ej. Gyt Continental
+ * GT ~300). Diseñar el UI con un buscador local sobre `name`/`address.city`.
+ */
+export interface RemittancePayerBranchDto {
+    branchCode: string;
+    name: string;
+    /** Horario de atención en formato libre (ej. "0900AM-0500PM"). */
+    branchHours?: string;
+    phoneNumber?: string;
+    address?: RemittancePayerBranchAddressDto;
+}
+
+export interface RemittancePayerBranchAddressDto {
+    address1?: string;
+    city?: string;
+    /** Código ISO 3166-2 (ej. "GT-GU"). */
+    state?: string;
+    stateName?: string;
+    country?: string;
+    countryISOCode?: string;
+    zipCode?: string;
+}

package/src/remittance/dtos/RemittancePayerDto.ts

@@ -0,0 +1,35 @@
+import { ReceptionMethod } from "../enums/ReceptionMethod";
+
+/**
+ * Payer disponible para un país+currency, devuelto por el endpoint público
+ * `GET /remittance/countries/{iso}/payers?currencyISO=XXX`.
+ *
+ * Lo consume el frontend en Pantalla 9 (Método + Payer) del wizard de agregar
+ * beneficiario. Provee toda la metadata necesaria para que la app:
+ *  1. Muestre los métodos de recepción soportados por el payer.
+ *  2. Decida si el wizard debe mostrar el paso de "selección de sucursal"
+ *     (`requiresBranch === true`) o el de "campos adicionales"
+ *     (`requiresAdditionalFields === true`).
+ *  3. Valide el `accNumber` del lado del cliente con `accNumberRegex` antes
+ *     de hacer submit (mejor UX que esperar 400 del backend).
+ */
+export interface RemittancePayerDto {
+    /** Código UNIR del payer (ej. "GCA10" Banrural). Usado como `payerCode` en AddBeneficiary. */
+    payerCode: string;
+    /** Nombre legible (ej. "Banrural", "B. Industrial"). */
+    name: string;
+    /** Métodos de recepción soportados por este payer en este país+currency. */
+    receptionMethods: ReceptionMethod[];
+    /** Si true, hay que llamar a `/remittance/payers/{code}/branches` cuando el usuario elige Cash Pickup. */
+    requiresBranch: boolean;
+    /** Si true, hay que llamar a `/remittance/payers/{code}/fields` para conocer campos extra requeridos. */
+    requiresAdditionalFields: boolean;
+    /** Regex de validación del `accNumber` (solo si `receptionMethod` = ACCOUNT_CREDIT). */
+    accNumberRegex?: string;
+    /** Mensaje legible para mostrar al usuario cuando el `accNumber` no pasa el regex. */
+    accNumberHelperText?: string;
+    /** URL absoluta del logo del payer (puede no venir). */
+    logoUrl?: string;
+    /** Orden de aparición sugerido por UNIR (asc). */
+    sortOrder?: number;
+}

package/src/remittance/dtos/RemittanceStateDto.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado / departamento del país destino de una remesa.
+ * Devuelto por el endpoint público `GET /remittance/countries/{iso}/states`.
+ *
+ * `stateISO` viene en formato ISO 3166-2 (ej. "GT-GU" Guatemala, "SV-SS" San Salvador,
+ * "HN-AT" Atlántida, "NI-MN" Managua).
+ */
+export interface RemittanceStateDto {
+    stateISO: string;
+    name: string;
+}

package/src/remittance/dtos/index.ts

@@ -13,3 +13,7 @@ export * from "./RemittanceSendPreviewResponse";
 export * from "./RemittanceTransaction";
 export * from "./RemittanceLimitsInfo";
 export * from "./RemittanceHomeResponse";
+export * from "./RemittanceStateDto";
+export * from "./RemittancePayerDto";
+export * from "./RemittancePayerBranchDto";
+export * from "./RemittancePayerAdditionalFieldDto";