@fiado/type-kit 3.597.0 → 3.599.0

package/_test_/unit/customerMessages/customerMessagesContract.test.ts

@@ -0,0 +1,71 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate, ValidationError } from 'class-validator';
+import { CustomerMessages } from '../../../src/index';
+import {
+    CUSTOMER_MANUAL_MESSAGE_CHANNELS,
+    CUSTOMER_MESSAGE_HISTORY_MAX_LIMIT,
+    CustomerManualMessageRequest,
+    CustomerMessageHistoryQuery,
+} from '../../../src/customerMessages/index';
+import { MessageMomentCategoryEnum } from '../../../src/messageMoments/index';
+import { DeliveryChannelExtendedEnum } from '../../../src/messagesConnector/index';
+
+const hasError = (errors: ValidationError[], property: string): boolean =>
+    errors.some((error) => error.property === property);
+
+const validateHistory = async (payload: Record<string, unknown>): Promise<ValidationError[]> =>
+    validate(plainToInstance(CustomerMessageHistoryQuery, payload), { whitelist: true });
+
+const validateManual = async (payload: Record<string, unknown>): Promise<ValidationError[]> =>
+    validate(plainToInstance(CustomerManualMessageRequest, payload), { whitelist: true });
+
+describe('CustomerMessageHistoryQuery', () => {
+    it('acepta solo la categoría', async () => {
+        expect(await validateHistory({ category: 'SALE' })).toEqual([]);
+    });
+
+    it('acepta cursor y limit del query string', async () => {
+        expect(await validateHistory({ category: 'CREDIT', cursor: 'abc', limit: '50' })).toEqual([]);
+    });
+
+    it.each([undefined, 'OTHER'])('rechaza la categoría %s', async (category) => {
+        expect(hasError(await validateHistory({ category }), 'category')).toBe(true);
+    });
+
+    it.each(['0', '51', '2.5', 'x'])('rechaza el limit %s', async (limit) => {
+        expect(hasError(await validateHistory({ category: 'SALE', limit }), 'limit')).toBe(true);
+    });
+
+    it('el límite máximo es 50', () => {
+        expect(CUSTOMER_MESSAGE_HISTORY_MAX_LIMIT).toBe(50);
+    });
+});
+
+describe('CustomerManualMessageRequest', () => {
+    it.each(['SMS', 'PUSH_NOTIFICATION'])('acepta el canal %s', async (channel) => {
+        expect(await validateManual({ templateId: 'PM-075', channel })).toEqual([]);
+    });
+
+    it.each(['MDM', 'MAIL', 'WHATSAPP', undefined])('rechaza el canal %s', async (channel) => {
+        expect(hasError(await validateManual({ templateId: 'PM-075', channel }), 'channel')).toBe(true);
+    });
+
+    it.each([undefined, 'PM-75', 'pm-075', 'PM-0755', 'X-075', 75])('rechaza el templateId %s', async (templateId) => {
+        expect(hasError(await validateManual({ templateId, channel: 'SMS' }), 'templateId')).toBe(true);
+    });
+
+    it('los canales manuales son SMS y push', () => {
+        expect(CUSTOMER_MANUAL_MESSAGE_CHANNELS).toEqual([
+            DeliveryChannelExtendedEnum.SMS,
+            DeliveryChannelExtendedEnum.PUSH_NOTIFICATION,
+        ]);
+    });
+});
+
+describe('barril CustomerMessages', () => {
+    it('se publica desde el índice raíz', () => {
+        expect(CustomerMessages.CustomerManualMessageRequest).toBe(CustomerManualMessageRequest);
+        expect(MessageMomentCategoryEnum.SALE).toBe('SALE');
+    });
+});

package/_test_/unit/messageMoments/MessageMomentClassification.test.ts

@@ -0,0 +1,85 @@
+import 'reflect-metadata';
+import {
+    MESSAGE_MOMENT_CATALOG,
+    MessageMomentCategoryEnum,
+    isCollectionMoment,
+    momentByMessageType,
+    momentsOfCategory,
+} from '../../../src/messageMoments/index';
+
+const S = MessageMomentCategoryEnum.SALE;
+const C = MessageMomentCategoryEnum.CREDIT;
+
+/** templateId, category, collection, manualSend. */
+const EXPECTED: ReadonlyArray<[string, MessageMomentCategoryEnum, boolean, boolean]> = [
+    ['PM-001', S, false, false],
+    ['PM-002', S, false, false],
+    ['PM-003', S, false, false],
+    ['PM-004', S, false, false],
+    ['PM-005', S, false, false],
+    ['PM-010', C, true, false],
+    ['PM-011', C, true, false],
+    ['PM-012', C, true, false],
+    ['PM-020', C, false, false],
+    ['PM-021', C, false, false],
+    ['PM-022', C, true, false],
+    ['PM-023', C, false, false],
+    ['PM-030', C, true, false],
+    ['PM-031', C, true, false],
+    ['PM-032', C, true, false],
+    ['PM-033', C, true, false],
+    ['PM-034', C, true, false],
+    ['PM-040', C, true, false],
+    ['PM-041', C, false, false],
+    ['PM-050', C, false, false],
+    ['PM-051', C, false, false],
+    ['PM-052', C, false, false],
+    ['PM-053', C, false, false],
+    ['PM-054', C, false, false],
+    ['PM-055', C, false, true],
+    ['PM-056', C, false, false],
+    ['PM-057', C, false, false],
+    ['PM-060', C, true, false],
+    ['PM-061', C, false, false],
+    ['PM-062', C, false, false],
+    ['PM-063', C, false, false],
+    ['PM-070', S, false, false],
+    ['PM-071', S, false, false],
+    ['PM-072', S, false, false],
+    ['PM-073', S, false, false],
+    ['PM-074', C, false, false],
+    ['PM-075', C, false, true],
+    ['PM-076', C, false, true],
+    ['PM-080', S, false, false],
+    ['PM-081', S, false, true],
+];
+
+describe('clasificación de los momentos', () => {
+    it('cubre todo el catálogo', () => {
+        expect(EXPECTED.map(([templateId]) => templateId)).toEqual(MESSAGE_MOMENT_CATALOG.map((m) => m.templateId));
+    });
+
+    it.each(EXPECTED)('%s es %s, collection=%s, manualSend=%s', (templateId, category, collection, manualSend) => {
+        const moment = MESSAGE_MOMENT_CATALOG.find((m) => m.templateId === templateId);
+        expect(moment).toMatchObject({ category, collection, manualSend });
+    });
+
+    it('isCollectionMoment responde por messageType y da false a lo que no está en el catálogo', () => {
+        expect(isCollectionMoment('COLLECTION_T_PLUS_1')).toBe(true);
+        expect(isCollectionMoment('PAYMENT_APPLIED')).toBe(false);
+        expect(isCollectionMoment('NOT_A_MOMENT')).toBe(false);
+    });
+
+    it('momentsOfCategory parte el catálogo en dos sin perder ni repetir', () => {
+        const sale = momentsOfCategory(S);
+        const credit = momentsOfCategory(C);
+        expect(sale).toHaveLength(11);
+        expect(credit).toHaveLength(29);
+        expect(sale.every((m) => m.category === S)).toBe(true);
+        expect(credit.every((m) => m.category === C)).toBe(true);
+    });
+
+    it('momentByMessageType encuentra la identidad clasificada', () => {
+        expect(momentByMessageType.get('OTP_CODE')?.category).toBe(S);
+    });
+});

package/_test_/unit/retailIntegration/reconciliationPreviewContracts.test.ts

@@ -0,0 +1,94 @@
+import 'reflect-metadata';
+import { plainToInstance, type ClassConstructor } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import {
+  type GetCatalogReconciliationResponse,
+  type GetOrgReconciliationResponse,
+  RECONCILIATION_PREVIEW_MAX_ITEMS,
+  type ReconciliationPreview,
+  ReconciliationEntityEnum,
+  ReconciliationRunStatusEnum,
+  ReconciliationTriggerEnum,
+  RetailEventRejectCodeEnum,
+  type RetailEventResult,
+  RetailEventResultEnum,
+  StartCatalogReconciliationRequest,
+  StartOrgReconciliationRequest,
+} from '../../../src/retailIntegration';
+
+function propsWithErrors<T extends object>(cls: ClassConstructor<T>, payload: object): string[] {
+  return validateSync(plainToInstance(cls, payload)).map((e) => e.property);
+}
+
+function exposed<T extends object>(cls: ClassConstructor<T>, payload: object): T {
+  return plainToInstance(cls, payload, { excludeExtraneousValues: true });
+}
+
+describe.each([
+  ['StartOrgReconciliationRequest', StartOrgReconciliationRequest as ClassConstructor<object>, 'STORES'],
+  ['StartCatalogReconciliationRequest', StartCatalogReconciliationRequest as ClassConstructor<object>, 'CATALOG'],
+] as const)('%s.dryRun', (_name, cls, entity) => {
+  it('es opcional', () => {
+    expect(propsWithErrors(cls, { entity })).toEqual([]);
+  });
+
+  it.each([true, false])('acepta %p', (dryRun) => {
+    expect(propsWithErrors(cls, { entity, dryRun })).toEqual([]);
+  });
+
+  it.each(['true', 1, 'yes'])('rechaza %p', (dryRun) => {
+    expect(propsWithErrors(cls, { entity, dryRun })).toContain('dryRun');
+  });
+
+  it('sobrevive a excludeExtraneousValues', () => {
+    expect({ ...exposed(cls, { entity, dryRun: true }) }).toMatchObject({ entity, dryRun: true });
+  });
+});
+
+describe('vista previa de la revisión', () => {
+  const counts = { seen: 3, created: 1, updated: 1, deactivated: 1, reactivated: 0, skipped: 0 };
+  const preview: ReconciliationPreview = {
+    created: [{ id: 's-1', label: 'Tienda Centro' }],
+    updated: [{ id: 'SKU-1', label: 'Equipo X', fields: ['price'] }],
+    deactivated: [{ id: '356938035643809', storeId: 's-1' }],
+    reactivated: [],
+    truncated: false,
+  };
+
+  it('el tope por lista es 200', () => {
+    expect(RECONCILIATION_PREVIEW_MAX_ITEMS).toBe(200);
+  });
+
+  it('las respuestas del GET llevan dryRun y preview', () => {
+    const org: GetOrgReconciliationResponse = {
+      runId: 'run-1',
+      retailerId: 'r-1',
+      entity: ReconciliationEntityEnum.STORES,
+      status: ReconciliationRunStatusEnum.COMPLETE,
+      trigger: ReconciliationTriggerEnum.MANUAL,
+      startedAt: '2026-10-27T10:00:00.000Z',
+      pagesProcessed: 1,
+      counts,
+      dryRun: true,
+      preview,
+    };
+    const catalog: GetCatalogReconciliationResponse = { ...org, entity: ReconciliationEntityEnum.INVENTORY };
+    expect(org.preview?.updated[0].fields).toEqual(['price']);
+    expect(catalog.dryRun).toBe(true);
+  });
+});
+
+describe('RetailEventResult.errors', () => {
+  it('lista todos los renglones malos de un REJECTED', () => {
+    const result: RetailEventResult = {
+      eventId: 'e-1',
+      result: RetailEventResultEnum.REJECTED,
+      code: RetailEventRejectCodeEnum.INVALID_IMEI,
+      errors: [
+        { index: 0, kind: 'piece', identifier: '123', sku: 'SKU-1', storeId: 's-1', code: RetailEventRejectCodeEnum.INVALID_IMEI },
+        { index: 2, kind: 'stock', sku: 'SKU-2', code: RetailEventRejectCodeEnum.SKU_NOT_STOCKABLE },
+      ],
+    };
+    expect(result.errors?.map((e) => e.index)).toEqual([0, 2]);
+  });
+});

package/bin/customerMessages/constants/CustomerMessageLimits.d.ts

@@ -0,0 +1,7 @@
+import { DeliveryChannelExtendedEnum } from '../../messagesConnector/enums/DeliveryChannelExtendedEnum';
+/** Máximo de mensajes por página del historial del cliente. */
+export declare const CUSTOMER_MESSAGE_HISTORY_MAX_LIMIT = 50;
+/** Id de ficha de un momento: `PM-` y tres dígitos. */
+export declare const MESSAGE_MOMENT_TEMPLATE_ID_PATTERN: RegExp;
+/** Canales por los que el backoffice puede enviar un momento a mano. */
+export declare const CUSTOMER_MANUAL_MESSAGE_CHANNELS: readonly DeliveryChannelExtendedEnum[];

package/bin/customerMessages/constants/CustomerMessageLimits.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CUSTOMER_MANUAL_MESSAGE_CHANNELS = exports.MESSAGE_MOMENT_TEMPLATE_ID_PATTERN = exports.CUSTOMER_MESSAGE_HISTORY_MAX_LIMIT = void 0;
+const DeliveryChannelExtendedEnum_1 = require("../../messagesConnector/enums/DeliveryChannelExtendedEnum");
+/** Máximo de mensajes por página del historial del cliente. */
+exports.CUSTOMER_MESSAGE_HISTORY_MAX_LIMIT = 50;
+/** Id de ficha de un momento: `PM-` y tres dígitos. */
+exports.MESSAGE_MOMENT_TEMPLATE_ID_PATTERN = /^PM-\d{3}$/;
+/** Canales por los que el backoffice puede enviar un momento a mano. */
+exports.CUSTOMER_MANUAL_MESSAGE_CHANNELS = [
+    DeliveryChannelExtendedEnum_1.DeliveryChannelExtendedEnum.SMS,
+    DeliveryChannelExtendedEnum_1.DeliveryChannelExtendedEnum.PUSH_NOTIFICATION,
+];

package/bin/customerMessages/dtos/requests/CustomerManualMessageRequest.d.ts

@@ -0,0 +1,6 @@
+import { DeliveryChannelExtendedEnum } from '../../../messagesConnector/enums/DeliveryChannelExtendedEnum';
+/** Body del envío manual de un momento a un cliente desde el backoffice. */
+export declare class CustomerManualMessageRequest {
+    templateId: string;
+    channel: DeliveryChannelExtendedEnum;
+}

package/bin/customerMessages/dtos/requests/CustomerManualMessageRequest.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.CustomerManualMessageRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const DeliveryChannelExtendedEnum_1 = require("../../../messagesConnector/enums/DeliveryChannelExtendedEnum");
+const CustomerMessageLimits_1 = require("../../constants/CustomerMessageLimits");
+/** Body del envío manual de un momento a un cliente desde el backoffice. */
+class CustomerManualMessageRequest {
+}
+exports.CustomerManualMessageRequest = CustomerManualMessageRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(CustomerMessageLimits_1.MESSAGE_MOMENT_TEMPLATE_ID_PATTERN),
+    __metadata("design:type", String)
+], CustomerManualMessageRequest.prototype, "templateId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsIn)(CustomerMessageLimits_1.CUSTOMER_MANUAL_MESSAGE_CHANNELS),
+    __metadata("design:type", String)
+], CustomerManualMessageRequest.prototype, "channel", void 0);

package/bin/customerMessages/dtos/requests/CustomerMessageHistoryQuery.d.ts

@@ -0,0 +1,8 @@
+import { MessageMomentCategoryEnum } from '../../../messageMoments/enums/MessageMomentCategoryEnum';
+/** Query del historial de mensajes de un cliente, filtrado por venta o crédito. */
+export declare class CustomerMessageHistoryQuery {
+    category: MessageMomentCategoryEnum;
+    /** Cursor opaco de la página anterior. */
+    cursor?: string;
+    limit?: number;
+}

package/bin/customerMessages/dtos/requests/CustomerMessageHistoryQuery.js

@@ -0,0 +1,40 @@
+"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.CustomerMessageHistoryQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const MessageMomentCategoryEnum_1 = require("../../../messageMoments/enums/MessageMomentCategoryEnum");
+const CustomerMessageLimits_1 = require("../../constants/CustomerMessageLimits");
+/** Query del historial de mensajes de un cliente, filtrado por venta o crédito. */
+class CustomerMessageHistoryQuery {
+}
+exports.CustomerMessageHistoryQuery = CustomerMessageHistoryQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(MessageMomentCategoryEnum_1.MessageMomentCategoryEnum),
+    __metadata("design:type", String)
+], CustomerMessageHistoryQuery.prototype, "category", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CustomerMessageHistoryQuery.prototype, "cursor", 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)(CustomerMessageLimits_1.CUSTOMER_MESSAGE_HISTORY_MAX_LIMIT),
+    __metadata("design:type", Number)
+], CustomerMessageHistoryQuery.prototype, "limit", void 0);

package/bin/customerMessages/dtos/responses/CollectionQuotaDay.d.ts

@@ -0,0 +1,9 @@
+import { DeliveryChannelExtendedEnum } from '../../../messagesConnector/enums/DeliveryChannelExtendedEnum';
+/** Mensajes de cobranza de un día de tienda en un canal: enviados y bloqueados por el tope. */
+export declare class CollectionQuotaDay {
+    /** YYYY-MM-DD en la zona de la tienda. */
+    storeDay: string;
+    channel: DeliveryChannelExtendedEnum;
+    sent: number;
+    blocked: number;
+}

package/bin/customerMessages/dtos/responses/CollectionQuotaDay.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionQuotaDay = void 0;
+/** Mensajes de cobranza de un día de tienda en un canal: enviados y bloqueados por el tope. */
+class CollectionQuotaDay {
+}
+exports.CollectionQuotaDay = CollectionQuotaDay;

package/bin/customerMessages/dtos/responses/CollectionQuotaResponse.d.ts

@@ -0,0 +1,8 @@
+import { CollectionQuotaDay } from './CollectionQuotaDay';
+/** Contador diario de cobranza del cliente por canal. */
+export declare class CollectionQuotaResponse {
+    maxPerChannel: number;
+    /** YYYY-MM-DD del día de tienda actual. */
+    today: string;
+    days: CollectionQuotaDay[];
+}

package/bin/customerMessages/dtos/responses/CollectionQuotaResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionQuotaResponse = void 0;
+/** Contador diario de cobranza del cliente por canal. */
+class CollectionQuotaResponse {
+}
+exports.CollectionQuotaResponse = CollectionQuotaResponse;

package/bin/customerMessages/dtos/responses/CustomerManualMessageResponse.d.ts

@@ -0,0 +1,4 @@
+/** Respuesta del envío manual: el id del mensaje encolado. */
+export declare class CustomerManualMessageResponse {
+    queueMessageId: string;
+}

package/bin/customerMessages/dtos/responses/CustomerManualMessageResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomerManualMessageResponse = void 0;
+/** Respuesta del envío manual: el id del mensaje encolado. */
+class CustomerManualMessageResponse {
+}
+exports.CustomerManualMessageResponse = CustomerManualMessageResponse;

package/bin/customerMessages/dtos/responses/CustomerMessageHistoryItem.d.ts

@@ -0,0 +1,19 @@
+import { MessageMomentCategoryEnum } from '../../../messageMoments/enums/MessageMomentCategoryEnum';
+import { DeliveryChannelExtendedEnum } from '../../../messagesConnector/enums/DeliveryChannelExtendedEnum';
+import { MessageLogStatusEnum } from '../../../messagesConnector/enums/MessageLogStatusEnum';
+import { NotificationOriginEnum } from '../../../messagesConnector/enums/NotificationOriginEnum';
+/** Un mensaje del historial del cliente, clasificado por su momento. */
+export declare class CustomerMessageHistoryItem {
+    messageId: string;
+    templateId: string;
+    messageType: string;
+    category: MessageMomentCategoryEnum;
+    collection: boolean;
+    channelType: DeliveryChannelExtendedEnum;
+    status: MessageLogStatusEnum;
+    /** Null cuando el texto no se muestra, como el OTP. */
+    renderedMessage: string | null;
+    origin: NotificationOriginEnum;
+    /** ISO 8601. */
+    createdAt: string;
+}

package/bin/customerMessages/dtos/responses/CustomerMessageHistoryItem.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomerMessageHistoryItem = void 0;
+/** Un mensaje del historial del cliente, clasificado por su momento. */
+class CustomerMessageHistoryItem {
+}
+exports.CustomerMessageHistoryItem = CustomerMessageHistoryItem;

package/bin/customerMessages/dtos/responses/CustomerMessageHistoryResponse.d.ts

@@ -0,0 +1,8 @@
+import { CustomerMessageHistoryItem } from './CustomerMessageHistoryItem';
+/** Página del historial del cliente, del más nuevo al más viejo. `nextCursor` en null: no hay más. */
+export declare class CustomerMessageHistoryResponse {
+    /** False si el cliente no tiene cuenta Fiado; entonces `items` viene vacío. */
+    hasFiadoAccount: boolean;
+    items: CustomerMessageHistoryItem[];
+    nextCursor: string | null;
+}

package/bin/customerMessages/dtos/responses/CustomerMessageHistoryResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomerMessageHistoryResponse = void 0;
+/** Página del historial del cliente, del más nuevo al más viejo. `nextCursor` en null: no hay más. */
+class CustomerMessageHistoryResponse {
+}
+exports.CustomerMessageHistoryResponse = CustomerMessageHistoryResponse;

package/bin/customerMessages/index.d.ts

@@ -0,0 +1,8 @@
+export * from './constants/CustomerMessageLimits';
+export * from './dtos/requests/CustomerMessageHistoryQuery';
+export * from './dtos/requests/CustomerManualMessageRequest';
+export * from './dtos/responses/CustomerMessageHistoryItem';
+export * from './dtos/responses/CustomerMessageHistoryResponse';
+export * from './dtos/responses/CollectionQuotaDay';
+export * from './dtos/responses/CollectionQuotaResponse';
+export * from './dtos/responses/CustomerManualMessageResponse';

package/bin/customerMessages/index.js

@@ -0,0 +1,24 @@
+"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("./constants/CustomerMessageLimits"), exports);
+__exportStar(require("./dtos/requests/CustomerMessageHistoryQuery"), exports);
+__exportStar(require("./dtos/requests/CustomerManualMessageRequest"), exports);
+__exportStar(require("./dtos/responses/CustomerMessageHistoryItem"), exports);
+__exportStar(require("./dtos/responses/CustomerMessageHistoryResponse"), exports);
+__exportStar(require("./dtos/responses/CollectionQuotaDay"), exports);
+__exportStar(require("./dtos/responses/CollectionQuotaResponse"), exports);
+__exportStar(require("./dtos/responses/CustomerManualMessageResponse"), exports);

package/bin/index.d.ts

@@ -131,3 +131,4 @@ export * as PdfRender from './pdfRender';
 export * as Rules from './rules';
 export * as LoanRetailAudit from './loanRetailAudit';
 export * as TaskManager from './task-manager-business';
+export * as CustomerMessages from './customerMessages';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.FiadoIncFavorite = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.MessageMoments = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.UsMarketGrowthBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = void 0;
-exports.TaskManager = exports.LoanRetailAudit = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = void 0;
+exports.CustomerMessages = exports.TaskManager = exports.LoanRetailAudit = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -257,3 +257,5 @@ exports.Rules = __importStar(require("./rules"));
 exports.LoanRetailAudit = __importStar(require("./loanRetailAudit"));
 // TaskManager: DTOs del lambda task-manager-business (gestor genérico de tareas; primer tipo MARKETING_MATERIAL).
 exports.TaskManager = __importStar(require("./task-manager-business"));
+// CustomerMessages: historial de mensajes del cliente por venta o crédito, contador de cobranza y envío manual.
+exports.CustomerMessages = __importStar(require("./customerMessages"));

package/bin/messageMoments/constants/MessageMomentCatalog.d.ts

@@ -1,5 +1,6 @@
 import { MessageMomentEnum } from '../enums/MessageMomentEnum';
 import { MessageMomentBlockEnum } from '../enums/MessageMomentBlockEnum';
+import { MessageMomentCategoryEnum } from '../enums/MessageMomentCategoryEnum';
 /** Quién es un momento: su id de ficha, su plantilla, su bloque y las variables que emite. */
 export interface MessageMomentIdentity {
     /** Id del momento (`PM-001`); en minúsculas es el prefijo de sus keys en la ficha. */
@@ -9,6 +10,12 @@ export interface MessageMomentIdentity {
     blockId: MessageMomentBlockEnum;
     alwaysVariables: readonly string[];
     conditionalVariables: readonly string[];
+    /** Historial del cliente donde aparece: venta o crédito. */
+    category: MessageMomentCategoryEnum;
+    /** Es cobranza: cuenta contra el tope diario por canal. */
+    collection: boolean;
+    /** El backoffice lo puede enviar a mano. */
+    manualSend: boolean;
 }
 /** Los 38 momentos del crédito EN ORDEN de recorrido y al final los de referidos. `PM-071` apunta al OTP de plataforma. */
 export declare const MESSAGE_MOMENT_CATALOG: readonly MessageMomentIdentity[];
@@ -16,3 +23,7 @@ export declare const MESSAGE_MOMENT_CATALOG: readonly MessageMomentIdentity[];
 export declare const momentByTemplateId: ReadonlyMap<string, MessageMomentIdentity>;
 /** La identidad por messageType de la plantilla. */
 export declare const momentByMessageType: ReadonlyMap<string, MessageMomentIdentity>;
+/** Si el messageType es de cobranza; false para lo que no está en el catálogo. */
+export declare function isCollectionMoment(messageType: string): boolean;
+/** Los momentos de una categoría, en el orden del catálogo. */
+export declare function momentsOfCategory(category: MessageMomentCategoryEnum): readonly MessageMomentIdentity[];

package/bin/messageMoments/constants/MessageMomentCatalog.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.momentByMessageType = exports.momentByTemplateId = exports.MESSAGE_MOMENT_CATALOG = void 0;
+exports.isCollectionMoment = isCollectionMoment;
+exports.momentsOfCategory = momentsOfCategory;
 const MessageMomentEnum_1 = require("../enums/MessageMomentEnum");
 const MessageMomentBlockEnum_1 = require("../enums/MessageMomentBlockEnum");
+const MessageMomentClassification_1 = require("./MessageMomentClassification");
 const MessageMomentVariables_1 = require("./MessageMomentVariables");
 /** Un momento del crédito: las variables del crédito más las que solo emite él. */
 function creditMoment(templateId, messageType, blockId) {
@@ -12,11 +15,12 @@ function creditMoment(templateId, messageType, blockId) {
         blockId,
         alwaysVariables: [...MessageMomentVariables_1.CREDIT_MOMENT_ALWAYS_VARIABLES, ...(MessageMomentVariables_1.MOMENT_SPECIFIC_VARIABLES[messageType] ?? [])],
         conditionalVariables: MessageMomentVariables_1.CREDIT_MOMENT_CONDITIONAL_VARIABLES,
+        ...(0, MessageMomentClassification_1.classifyMoment)(messageType, blockId),
     };
 }
 /** Un momento fuera del crédito: solo las variables que su emisor manda. */
 function standaloneMoment(templateId, messageType, blockId, alwaysVariables, conditionalVariables = []) {
-    return { templateId, messageType, blockId, alwaysVariables, conditionalVariables };
+    return { templateId, messageType, blockId, alwaysVariables, conditionalVariables, ...(0, MessageMomentClassification_1.classifyMoment)(messageType, blockId) };
 }
 const B = MessageMomentBlockEnum_1.MessageMomentBlockEnum;
 const M = MessageMomentEnum_1.MessageMomentEnum;
@@ -67,3 +71,11 @@ exports.MESSAGE_MOMENT_CATALOG = [
 exports.momentByTemplateId = new Map(exports.MESSAGE_MOMENT_CATALOG.map((moment) => [moment.templateId, moment]));
 /** La identidad por messageType de la plantilla. */
 exports.momentByMessageType = new Map(exports.MESSAGE_MOMENT_CATALOG.map((moment) => [moment.messageType, moment]));
+/** Si el messageType es de cobranza; false para lo que no está en el catálogo. */
+function isCollectionMoment(messageType) {
+    return exports.momentByMessageType.get(messageType)?.collection ?? false;
+}
+/** Los momentos de una categoría, en el orden del catálogo. */
+function momentsOfCategory(category) {
+    return exports.MESSAGE_MOMENT_CATALOG.filter((moment) => moment.category === category);
+}

package/bin/messageMoments/constants/MessageMomentClassification.d.ts

@@ -0,0 +1,19 @@
+import { MessageMomentBlockEnum } from '../enums/MessageMomentBlockEnum';
+import { MessageMomentCategoryEnum } from '../enums/MessageMomentCategoryEnum';
+import { MessageMomentEnum } from '../enums/MessageMomentEnum';
+/** Categoría por defecto de cada bloque; un momento nuevo la hereda. */
+export declare const BLOCK_DEFAULT_CATEGORY: Readonly<Record<MessageMomentBlockEnum, MessageMomentCategoryEnum>>;
+/** Momentos del bloque de servicio que van al historial del crédito. */
+export declare const CREDIT_CATEGORY_OVERRIDES: ReadonlySet<MessageMomentEnum>;
+/** Bloques cuyos momentos son de cobranza y cuentan contra el tope diario. */
+export declare const COLLECTION_BLOCKS: ReadonlySet<MessageMomentBlockEnum>;
+/** Momentos de cobranza fuera de esos bloques. */
+export declare const COLLECTION_MOMENT_OVERRIDES: ReadonlySet<MessageMomentEnum>;
+/** Momentos que el backoffice puede enviar a mano a un cliente. */
+export declare const MANUAL_SEND_MOMENTS: ReadonlySet<MessageMomentEnum>;
+/** Clasificación de un momento: la de su bloque, salvo que esté en una lista de excepciones. */
+export declare function classifyMoment(messageType: MessageMomentEnum, blockId: MessageMomentBlockEnum): {
+    category: MessageMomentCategoryEnum;
+    collection: boolean;
+    manualSend: boolean;
+};