@fiado/type-kit 3.494.0 → 3.496.0

package/bin/retailIntegration/models/RetailSystemUser.d.ts

@@ -0,0 +1,14 @@
+import { RetailUserAccessStatusEnum, RetailUserRoleEnum } from '../enums';
+export type RetailUserRole = `${RetailUserRoleEnum}`;
+export type RetailUserAccessStatus = `${RetailUserAccessStatusEnum}`;
+/** Usuario de la operación del retailer, tal como lo define la doc de integración. */
+export interface RetailSystemUser {
+    retailUserId: string;
+    displayName: string;
+    email: string;
+    phone: string | null;
+    homeStoreId: string;
+    zoneId: string | null;
+    role: RetailUserRole;
+    status: RetailUserAccessStatus;
+}

package/bin/retailIntegration/models/RetailSystemUser.js

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

package/bin/retailIntegration/validators/IsIsoDateTimeWithZone.d.ts

@@ -0,0 +1,6 @@
+import { ValidatorConstraintInterface } from 'class-validator';
+/** Acepta fecha y hora ISO-8601 con segundos y zona; sin zona se rechaza, como dice la doc. */
+export declare class IsIsoDateTimeWithZone implements ValidatorConstraintInterface {
+    validate(value: unknown): boolean;
+    defaultMessage(): string;
+}

package/bin/retailIntegration/validators/IsIsoDateTimeWithZone.js

@@ -0,0 +1,29 @@
+"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.IsIsoDateTimeWithZone = void 0;
+const class_validator_1 = require("class-validator");
+const ISO_DATE_TIME_WITH_ZONE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?(Z|[+-]\d{2}:\d{2})$/;
+/** Descarta fechas que `Date` recorre en silencio, como el 31 de febrero. */
+function isRealCalendarDate(value) {
+    const [year, month, day] = value.slice(0, 10).split('-').map(Number);
+    return !Number.isNaN(Date.parse(value)) && new Date(Date.UTC(year, month - 1, day)).getUTCDate() === day;
+}
+/** Acepta fecha y hora ISO-8601 con segundos y zona; sin zona se rechaza, como dice la doc. */
+let IsIsoDateTimeWithZone = class IsIsoDateTimeWithZone {
+    validate(value) {
+        return typeof value === 'string' && ISO_DATE_TIME_WITH_ZONE.test(value) && isRealCalendarDate(value);
+    }
+    defaultMessage() {
+        return 'debe ser fecha y hora ISO-8601 con zona, por ejemplo 2026-08-17T20:32:05Z';
+    }
+};
+exports.IsIsoDateTimeWithZone = IsIsoDateTimeWithZone;
+exports.IsIsoDateTimeWithZone = IsIsoDateTimeWithZone = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isIsoDateTimeWithZone', async: false })
+], IsIsoDateTimeWithZone);

package/bin/retailWizard/dtos/WizardSessionLookupEntry.d.ts

@@ -24,4 +24,6 @@ export interface WizardSessionLookupEntry {
     /** La venta que cerro esta sesion; `null` si todavia no cerro. */
     saleId?: string | null;
     folio?: string | null;
+    /** Vendedor de la sesión (`retailUserId` de retail-org). `null` si la sesión no lo tiene. */
+    sellerRetailUserId?: string | null;
 }

package/package.json

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

package/src/index.ts

@@ -125,6 +125,8 @@ export * as RetailWizard from './retailWizard';
 // RetailPromotions: DTOs/enums de retail-promotions-business (promos de venta, códigos de descuento y
 // cupones de VentasLuga). Porcentajes en puntos base, dinero en centavos.
 export * as RetailPromotions from './retailPromotions';
+// RetailIntegration: DTOs del retail-integration-connector (webhooks del retailer y salida hacia su sistema).
+export * as RetailIntegration from './retailIntegration';
 export * as DatalakeQuery from './datalakeQuery';
 // LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
 export * as LoanConfig from './loanConfig';

package/src/loanCredit/dtos/requests/CreateSellerPaymentRequest.ts

@@ -0,0 +1,40 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsUUID, Min, ValidateNested } from 'class-validator';
+import { InStorePaymentMethodEnum } from '../../enums/InStorePaymentMethodEnum';
+import { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+import { InStorePaymentDetail } from './InStorePaymentDetail';
+
+/** Body de `POST /seller/credits/{creditId}/payments`: el vendedor anota un pago recibido en tienda. */
+export class CreateSellerPaymentRequest {
+    @Expose()
+    @IsEnum(LoanCustomerPaymentTypeEnum)
+    type!: LoanCustomerPaymentTypeEnum;
+
+    /** El monto que vio el vendedor en las opciones; distinto al de hoy → 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    expectedAmountCents!: number;
+
+    /** Solo ADVANCE: cuántas cuotas adelanta. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(2)
+    installmentCount?: number;
+
+    @Expose()
+    @IsEnum(InStorePaymentMethodEnum)
+    method!: InStorePaymentMethodEnum;
+
+    /** Tarjeta: `cardLast4` + `authCode`; SPEI: `speiTrackingKey`; efectivo: sin detalle. */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => InStorePaymentDetail)
+    detail?: InStorePaymentDetail;
+
+    @Expose()
+    @IsUUID()
+    idempotencyKey!: string;
+}

package/src/loanCredit/dtos/requests/InStorePaymentDetail.ts

@@ -0,0 +1,27 @@
+import { Expose } from 'class-transformer';
+import { IsString, Length, Matches, ValidateIf } from 'class-validator';
+
+/**
+ * Dato de la forma de pago anotada en tienda; solo valida la forma, nunca lleva CLABE.
+ * Qué campo exige cada método lo decide loan-credit (400 INVALID_PAYMENT_DETAIL).
+ */
+export class InStorePaymentDetail {
+    /** Tarjeta: últimos 4 dígitos. */
+    @Expose()
+    @ValidateIf((detail: InStorePaymentDetail) => detail.cardLast4 !== undefined)
+    @Matches(/^\d{4}$/)
+    cardLast4?: string;
+
+    /** Tarjeta: número de autorización del voucher. */
+    @Expose()
+    @ValidateIf((detail: InStorePaymentDetail) => detail.authCode !== undefined)
+    @Matches(/^[A-Za-z0-9]{1,12}$/)
+    authCode?: string;
+
+    /** SPEI: clave de rastreo. */
+    @Expose()
+    @ValidateIf((detail: InStorePaymentDetail) => detail.speiTrackingKey !== undefined)
+    @IsString()
+    @Length(1, 30)
+    speiTrackingKey?: string;
+}

package/src/loanCredit/dtos/requests/OriginateLoanCreditRequest.ts

@@ -84,13 +84,22 @@ export class OriginateLoanCreditRequest {
 
     /**
      * Tienda donde se vende. El motor la persiste y la reenvía al simulador del catálogo en cada
-     * cotización — al RE-cotizar el wizard no la vuelve a mandar, así que sin guardarla la venta
-     * perdería su promoción a mitad del paso 06.
+     * cotización. Obligatoria: sin ella el crédito no tiene tienda en su cartera.
+     */
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    storeId!: string;
+
+    /**
+     * Vendedor que origina: el `retailUserId` de retail-org que la sesión del wizard guarda como
+     * `sellerRetailUserId`. Llave de la cartera del vendedor en loan-credit.
      */
     @Expose()
     @IsOptional()
     @IsString()
-    storeId?: string;
+    @IsNotEmpty()
+    sellerId?: string;
 
     /** SKU del equipo, por el mismo motivo que `storeId`: resuelve promociones acotadas por producto. */
     @Expose()

package/src/loanCredit/dtos/responses/CreditCustomerListItem.ts

@@ -0,0 +1,51 @@
+import type { PaginatedResult } from '../../../retailOrg';
+import type { CreditCustomerStateEnum } from '../../enums/CreditCustomerStateEnum';
+import type { LoanPaymentOriginEnum } from '../../enums/LoanPaymentOriginEnum';
+
+/** Segmento del catálogo al que pertenece el cliente. */
+export interface CreditCustomerSegment {
+    segmentId: string;
+    name: string;
+}
+
+/** Último pago que entró al crédito: cuándo y por dónde. */
+export interface CreditLastPayment {
+    at: string;
+    origin: LoanPaymentOriginEnum;
+    storeId?: string;
+    storeName?: string;
+}
+
+/** Bloque de crédito de la fila de Clientes; sin lectura todo va en null. */
+export interface CreditCustomerCredit {
+    state: CreditCustomerStateEnum;
+    clientLevel: string | null;
+    sciScore: number | null;
+    /** Si el SCI es el vivo del acreditado o el congelado al originar. */
+    sciSource: string | null;
+    creditsCount: number | null;
+    activeCreditsCount: number | null;
+    settledCreditsCount: number | null;
+    writtenOffCreditsCount: number | null;
+    outstandingBalanceCents: number | null;
+    arrearsDays: number | null;
+    lastPaymentAt: string | null;
+    /** Ausente en créditos sin pago desde que existe el campo: el front cae a `lastPaymentAt`. */
+    lastPayment?: CreditLastPayment;
+    /** Crédito vigente; si hubiera más de uno vivo, el más reciente. */
+    activeCreditId: string | null;
+}
+
+/** Fila de la tabla Clientes del backoffice. */
+export interface CreditCustomerListItem {
+    retailCustomerId: string;
+    fullName: string | null;
+    phone: string | null;
+    originStoreId: string | null;
+    segments: CreditCustomerSegment[];
+    /** `false` = la consulta de segmentos falló: la celda dice «sin leer», no «ninguno». */
+    segmentsRead: boolean;
+    credit: CreditCustomerCredit;
+}
+
+export type CreditCustomerPage = PaginatedResult<CreditCustomerListItem>;

package/src/loanCredit/dtos/responses/CreditSaleContext.ts

@@ -41,4 +41,6 @@ export interface CreditSaleContext {
     storeName: string | null;
     storeNameStatus: WizardSessionLookupStatusEnum;
     storeNameReason?: SaleContextReason;
+    /** Venta que cerró la sesión. `null` si no cerró; ausente si el lote al wizard no respondió. */
+    saleId?: string | null;
 }

package/src/loanCredit/dtos/responses/InStorePaymentListItem.ts

@@ -0,0 +1,21 @@
+import type { InStorePaymentMethodEnum } from '../../enums/InStorePaymentMethodEnum';
+import type { LoanChargeKindEnum } from '../../enums/LoanChargeKindEnum';
+import type { NamedRef } from './SellerPaymentResult';
+
+/** Un cobro en tienda en la conciliación de la cadena. */
+export interface InStorePaymentListItem {
+    receipt: string;
+    creditId: string;
+    paymentId: string;
+    chargeKind: LoanChargeKindEnum;
+    amountCents: number;
+    method: InStorePaymentMethodEnum;
+    collectedBySeller: NamedRef;
+    appliedAt: string;
+}
+
+/** `GET /seller/stores/{storeId}/in-store-payments`; `nextToken` ausente = última página. */
+export interface InStorePaymentListResponse {
+    items: InStorePaymentListItem[];
+    nextToken?: string;
+}

package/src/loanCredit/dtos/responses/LoanPaymentListItem.ts

@@ -1,7 +1,10 @@
 import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
 import { MechanismType } from '../../../collection/enums/MechanismType';
 import { CurrencyId } from '../../../currency/enums/CurrencyId';
+import type { InStorePaymentMethodEnum } from '../../enums/InStorePaymentMethodEnum';
 import { LoanChargeKindEnum } from '../../enums/LoanChargeKindEnum';
+import type { LoanPaymentOriginEnum } from '../../enums/LoanPaymentOriginEnum';
+import type { NamedRef } from './SellerPaymentResult';
 
 /** Un pago del historial de un crédito, tal como lo asentó el motor de cobro en `LoanPayment_GT`. */
 export interface LoanPaymentListItem {
@@ -10,7 +13,8 @@ export interface LoanPaymentListItem {
     receipt: string;
     installmentNumber: number;
     attemptId: string;
-    mechanism: MechanismType;
+    /** Ausente en los pagos en tienda: ahí no hubo motor. */
+    mechanism?: MechanismType;
     result: CollectionResultStatus;
     currency: CurrencyId;
     collectedCents: number;
@@ -30,6 +34,12 @@ export interface LoanPaymentListItem {
     chargeKind?: LoanChargeKindEnum;
     /** Saldo de capital del crédito después de este pago. Ausente en pagos viejos. */
     creditPrincipalBalanceAfterCents?: number;
+    /** Ausente en filas viejas = COLLECTION_ENGINE. */
+    origin?: LoanPaymentOriginEnum;
+    inStoreMethod?: InStorePaymentMethodEnum;
+    /** Tienda y vendedor con el nombre congelado al cobrar; el cliente nunca recibe `collectedBySeller.id`. */
+    collectedAtStore?: NamedRef;
+    collectedBySeller?: { id?: string; name: string | null };
 }
 
 /** Página del historial. El fin lo marca la AUSENCIA de `nextToken`, nunca una página corta. */

package/src/loanCredit/dtos/responses/SellerCreditDetailResponse.ts

@@ -0,0 +1,11 @@
+import { LoanCreditDetail } from './LoanCreditDetail';
+import { LoanInstallmentResponse } from './LoanInstallmentResponse';
+import { LoanPaymentListItem } from './LoanPaymentListItem';
+
+/** Detalle de un crédito propio del vendedor (`GET /seller/credits/{creditId}`): crédito, plan y últimos cobros. */
+export interface SellerCreditDetailResponse {
+    credit: LoanCreditDetail;
+    installments: LoanInstallmentResponse[];
+    /** Los últimos cobros asentados, del más reciente al más viejo (máximo 3). */
+    recentPayments: LoanPaymentListItem[];
+}

package/src/loanCredit/dtos/responses/SellerCreditListResponse.ts

@@ -0,0 +1,8 @@
+import { SellerCreditRow } from './SellerCreditRow';
+
+/** La cartera viva COMPLETA del vendedor, sin paginar. `truncated` = se alcanzó el tope de lectura. */
+export interface SellerCreditListResponse {
+    items: SellerCreditRow[];
+    count: number;
+    truncated: boolean;
+}

package/src/loanCredit/dtos/responses/SellerCreditLookupResult.ts

@@ -0,0 +1,11 @@
+import type { SellerNextInstallment } from './SellerPaymentResult';
+
+/** Respuesta de `GET /seller/credits/lookup`: lo mínimo para confirmar que es el crédito correcto. */
+export interface SellerCreditLookupResult {
+    creditId: string;
+    /** PII: nunca se loguea. */
+    customerName: string | null;
+    productBrand: string | null;
+    productModel: string | null;
+    nextInstallment: SellerNextInstallment | null;
+}

package/src/loanCredit/dtos/responses/SellerCreditRow.ts

@@ -0,0 +1,26 @@
+import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
+import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
+import { CreditSaleContext } from './CreditSaleContext';
+import { LoanInstallmentResponse } from './LoanInstallmentResponse';
+
+/**
+ * Una fila de la cartera del vendedor (`GET /seller/credits`, loan-credit-business). Montos en
+ * cents · instantes ISO-8601. Con `summaryUnavailable` las cifras del plan llegan en `null`, nunca en cero.
+ */
+export interface SellerCreditRow {
+    creditId: string;
+    status: LoanCreditStatusEnum;
+    termWeeks: number;
+    equipmentPriceCents: number;
+    clientLevelAtOrigination?: ClientLevelEnum;
+    imei?: string;
+    createdAt: string;
+    summaryUnavailable: boolean;
+    paidInstallments: number | null;
+    outstandingBalanceCents: number | null;
+    overdueDays: number | null;
+    overdueAmountCents: number | null;
+    /** Primera cuota que todavía se debe; `null` si ya no debe nada o si el plan no se leyó. */
+    currentInstallment: LoanInstallmentResponse | null;
+    saleContext: CreditSaleContext;
+}

package/src/loanCredit/dtos/responses/SellerPaymentOptions.ts

@@ -0,0 +1,29 @@
+import type { LoanPaymentOptionUnavailableReasonEnum } from '../../enums/LoanPaymentOptionUnavailableReasonEnum';
+import type { SellerNextInstallment } from './SellerPaymentResult';
+
+/** Una opción de cobro en tienda: disponible con su monto o rango, o no con su razón. */
+export interface SellerPaymentOption {
+    available: boolean;
+    unavailableReason?: LoanPaymentOptionUnavailableReasonEnum;
+    amountCents?: number;
+}
+
+/** Resumen del crédito de la opción A del canvas. */
+export interface SellerCreditPaymentSummary {
+    totalCents: number;
+    paidCents: number;
+    remainingCents: number;
+    nextInstallment: SellerNextInstallment | null;
+}
+
+/** Respuesta de `GET /seller/credits/{creditId}/payment-options`: fuente de `expectedAmountCents`. */
+export interface SellerPaymentOptions {
+    creditId: string;
+    summary: SellerCreditPaymentSummary;
+    /** Su cuota: las exigibles hoy (vencidas y la de hoy) o, sin nada exigible, la siguiente. */
+    nextInstallment: SellerPaymentOption & { installmentNumbers?: number[]; overdueCount?: number };
+    advance: SellerPaymentOption & { minInstallments?: number; maxInstallments?: number; installmentAmountsCents?: number[] };
+    prepayment: SellerPaymentOption & { minAmountCents?: number; maxAmountCents?: number };
+    /** Liquidar: el neto de la cotización de hoy. */
+    settlement: SellerPaymentOption;
+}

package/src/loanCredit/dtos/responses/SellerPaymentResult.ts

@@ -0,0 +1,43 @@
+import type { InStorePaymentMethodEnum } from '../../enums/InStorePaymentMethodEnum';
+import type { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+import type { LoanInstallmentStatusEnum } from '../../enums/LoanInstallmentStatusEnum';
+
+/** Algo con id y el nombre congelado al cobrar. */
+export interface NamedRef {
+    id: string;
+    name: string | null;
+}
+
+/** La cuota que sigue después del pago; null si ya no queda ninguna abierta. */
+export interface SellerNextInstallment {
+    installmentNumber: number;
+    dueDate: string | null;
+    amountCents: number;
+    status: LoanInstallmentStatusEnum;
+}
+
+/** El crédito con su equipo, para que el comprobante diga qué se pagó. */
+export interface SellerPaymentCredit {
+    creditId: string;
+    imei: string | null;
+    productBrand: string | null;
+    productModel: string | null;
+}
+
+/** Respuesta 200 de `POST /seller/credits/{creditId}/payments`: el comprobante en pantalla. */
+export interface SellerPaymentResult {
+    creditId: string;
+    /** Folio `SK-TD-…`. */
+    receipt: string;
+    amountCents: number;
+    type: LoanCustomerPaymentTypeEnum;
+    method: InStorePaymentMethodEnum;
+    appliedAt: string;
+    outstandingBalanceAfterCents: number;
+    /** Solo si el pago emitió documento (comprobante de adelanto o constancia de liquidación). */
+    documentId?: string;
+    collectedAtStore: NamedRef;
+    collectedBySeller: NamedRef;
+    nextInstallment: SellerNextInstallment | null;
+    credit: SellerPaymentCredit;
+}

package/src/loanCredit/enums/CreditCustomerStateEnum.ts

@@ -0,0 +1,6 @@
+/** Estado del bloque de crédito de la fila de Clientes: leído, sin acreditado o sin leer. */
+export enum CreditCustomerStateEnum {
+    READ = 'READ',
+    NO_BORROWER = 'NO_BORROWER',
+    UNAVAILABLE = 'UNAVAILABLE',
+}

package/src/loanCredit/enums/InStorePaymentMethodEnum.ts

@@ -0,0 +1,6 @@
+/** Forma en que el cliente pagó en tienda. Solo se anota: no se verifica contra banco ni terminal. */
+export enum InStorePaymentMethodEnum {
+    CASH = 'CASH',
+    CARD = 'CARD',
+    WIRE = 'WIRE',
+}

package/src/loanCredit/enums/LoanPaymentOriginEnum.ts

@@ -0,0 +1,5 @@
+/** Por dónde entró el pago al crédito. Ausente en filas viejas = COLLECTION_ENGINE. */
+export enum LoanPaymentOriginEnum {
+    COLLECTION_ENGINE = 'COLLECTION_ENGINE',
+    IN_STORE = 'IN_STORE',
+}

package/src/loanCredit/index.ts

@@ -49,6 +49,10 @@ export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';
 export * from './dtos/responses/SignLoanCreditResponse';
 export * from './dtos/responses/ActivationCheckResponse';
+// Cartera del vendedor (pantalla Cobro del Portal Vendedor)
+export * from './dtos/responses/SellerCreditRow';
+export * from './dtos/responses/SellerCreditListResponse';
+export * from './dtos/responses/SellerCreditDetailResponse';
 
 // Device / MDM — contrato hacia los callers de loan-credit
 export * from './enums/LoanDeviceMdmStatusEnum';
@@ -163,3 +167,15 @@ export * from './enums/LoanPaymentOptionUnavailableReasonEnum';
 export * from './dtos/requests/CreateCustomerPaymentRequest';
 export * from './dtos/responses/LoanCustomerPaymentOptions';
 export * from './dtos/responses/LoanCustomerPaymentResult';
+
+// Cobro en tienda del Portal del Vendedor
+export * from './enums/InStorePaymentMethodEnum';
+export * from './enums/LoanPaymentOriginEnum';
+export * from './enums/CreditCustomerStateEnum';
+export * from './dtos/requests/InStorePaymentDetail';
+export * from './dtos/requests/CreateSellerPaymentRequest';
+export * from './dtos/responses/SellerPaymentResult';
+export * from './dtos/responses/SellerPaymentOptions';
+export * from './dtos/responses/SellerCreditLookupResult';
+export * from './dtos/responses/InStorePaymentListItem';
+export * from './dtos/responses/CreditCustomerListItem';

package/src/retailIntegration/constants/retailIntegrationLimits.ts

@@ -0,0 +1,9 @@
+/** Tope de `eventId`: el límite seguro de una llave de DynamoDB. */
+export const RETAIL_EVENT_ID_MAX_LENGTH = 1024;
+
+/** Rango de `limit` en las listas paginadas del retailer. */
+export const RETAIL_LIST_LIMIT_MIN = 1;
+export const RETAIL_LIST_LIMIT_MAX = 200;
+
+/** Forma válida de un `tenantId`; también arma el nombre del secreto del retailer. */
+export const RETAIL_TENANT_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;

package/src/retailIntegration/dtos/ApplyRetailEventRequest.ts

@@ -0,0 +1,49 @@
+import { IsString, Matches } from 'class-validator';
+import { RETAIL_TENANT_ID_PATTERN } from '../constants/retailIntegrationLimits';
+import { ReceiveInventoryEventRequest } from './ReceiveInventoryEventRequest';
+import { ReceiveProductEventRequest } from './ReceiveProductEventRequest';
+import { ReceiveRetailUserEventRequest } from './ReceiveRetailUserEventRequest';
+import { ReceiveStoreEventRequest } from './ReceiveStoreEventRequest';
+import { RetailEventResult } from './RetailEventResult';
+
+/** Evento de tienda que el connector manda a retail-org-business, con el tenant de la credencial. */
+export class ApplyStoreEventRequest extends ReceiveStoreEventRequest {
+    @IsString()
+    @Matches(RETAIL_TENANT_ID_PATTERN)
+    tenantId!: string;
+}
+
+/** Evento de usuario que el connector manda a retail-org-business, con el tenant de la credencial. */
+export class ApplyRetailUserEventRequest extends ReceiveRetailUserEventRequest {
+    @IsString()
+    @Matches(RETAIL_TENANT_ID_PATTERN)
+    tenantId!: string;
+}
+
+/** Evento de producto que el connector manda a retail-catalog-business, con el tenant de la credencial. */
+export class ApplyProductEventRequest extends ReceiveProductEventRequest {
+    @IsString()
+    @Matches(RETAIL_TENANT_ID_PATTERN)
+    tenantId!: string;
+}
+
+/** Evento de inventario que el connector manda a retail-catalog-business, con el tenant de la credencial. */
+export class ApplyInventoryEventRequest extends ReceiveInventoryEventRequest {
+    @IsString()
+    @Matches(RETAIL_TENANT_ID_PATTERN)
+    tenantId!: string;
+}
+
+/** Cualquiera de los cuatro eventos que el connector manda a un destino. */
+export type ApplyRetailEventRequest =
+    | ApplyStoreEventRequest
+    | ApplyRetailUserEventRequest
+    | ApplyProductEventRequest
+    | ApplyInventoryEventRequest;
+
+/** El destino contesta `200` con `result`; un rechazo de negocio es `REJECTED`, nunca 4xx. */
+export type ApplyRetailEventResponse = RetailEventResult;
+export type ApplyStoreEventResponse = RetailEventResult;
+export type ApplyRetailUserEventResponse = RetailEventResult;
+export type ApplyProductEventResponse = RetailEventResult;
+export type ApplyInventoryEventResponse = RetailEventResult;

package/src/retailIntegration/dtos/GetRetailInventoryRequest.ts

@@ -0,0 +1,9 @@
+import { IsString, Matches } from 'class-validator';
+import { RetailTenantQuery } from './RetailTenantQuery';
+
+/** Query de `GET /private/retail/inventory`; el inventario es por tienda y no pagina. */
+export class GetRetailInventoryRequest extends RetailTenantQuery {
+    @IsString()
+    @Matches(/\S/)
+    storeId!: string;
+}

package/src/retailIntegration/dtos/ListRetailCatalogRequest.ts

@@ -0,0 +1,4 @@
+import { RetailPagedQuery } from './RetailPagedQuery';
+
+/** Query de `GET /private/retail/catalog`. */
+export class ListRetailCatalogRequest extends RetailPagedQuery {}

package/src/retailIntegration/dtos/ListRetailStoresRequest.ts

@@ -0,0 +1,4 @@
+import { RetailPagedQuery } from './RetailPagedQuery';
+
+/** Query de `GET /private/retail/stores`. */
+export class ListRetailStoresRequest extends RetailPagedQuery {}

package/src/retailIntegration/dtos/ListRetailUsersRequest.ts

@@ -0,0 +1,10 @@
+import { IsOptional, IsString, Matches } from 'class-validator';
+import { RetailPagedQuery } from './RetailPagedQuery';
+
+/** Query de `GET /private/retail/users`; sin `storeId` trae todos los usuarios. */
+export class ListRetailUsersRequest extends RetailPagedQuery {
+    @IsOptional()
+    @IsString()
+    @Matches(/\S/)
+    storeId?: string;
+}

package/src/retailIntegration/dtos/ReceiveInventoryEventRequest.ts

@@ -0,0 +1,9 @@
+import { IsIn } from 'class-validator';
+import { InventoryEventTypeEnum } from '../enums/InventoryEventTypeEnum';
+import { RetailEventEnvelope } from './RetailEventEnvelope';
+
+/** Sobre de `POST /webhooks/inventory`. */
+export class ReceiveInventoryEventRequest extends RetailEventEnvelope {
+    @IsIn(Object.values(InventoryEventTypeEnum))
+    eventType!: InventoryEventTypeEnum;
+}

package/src/retailIntegration/dtos/ReceiveProductEventRequest.ts

@@ -0,0 +1,9 @@
+import { IsIn } from 'class-validator';
+import { ProductEventTypeEnum } from '../enums/ProductEventTypeEnum';
+import { RetailEventEnvelope } from './RetailEventEnvelope';
+
+/** Sobre de `POST /webhooks/catalog`. */
+export class ReceiveProductEventRequest extends RetailEventEnvelope {
+    @IsIn(Object.values(ProductEventTypeEnum))
+    eventType!: ProductEventTypeEnum;
+}

package/src/retailIntegration/dtos/ReceiveRetailEventRequest.ts

@@ -0,0 +1,18 @@
+import { InventoryEventTypeEnum } from '../enums/InventoryEventTypeEnum';
+import { ProductEventTypeEnum } from '../enums/ProductEventTypeEnum';
+import { RetailUserEventTypeEnum } from '../enums/RetailUserEventTypeEnum';
+import { StoreEventTypeEnum } from '../enums/StoreEventTypeEnum';
+import { ReceiveInventoryEventRequest } from './ReceiveInventoryEventRequest';
+import { ReceiveProductEventRequest } from './ReceiveProductEventRequest';
+import { ReceiveRetailUserEventRequest } from './ReceiveRetailUserEventRequest';
+import { ReceiveStoreEventRequest } from './ReceiveStoreEventRequest';
+
+/** Cualquier `eventType` aceptado por alguno de los cuatro webhooks. */
+export type RetailEventType = StoreEventTypeEnum | RetailUserEventTypeEnum | ProductEventTypeEnum | InventoryEventTypeEnum;
+
+/** Sobre ya validado de cualquiera de los cuatro webhooks. */
+export type ReceiveRetailEventRequest =
+    | ReceiveStoreEventRequest
+    | ReceiveRetailUserEventRequest
+    | ReceiveProductEventRequest
+    | ReceiveInventoryEventRequest;

package/src/retailIntegration/dtos/ReceiveRetailUserEventRequest.ts

@@ -0,0 +1,9 @@
+import { IsIn } from 'class-validator';
+import { RetailUserEventTypeEnum } from '../enums/RetailUserEventTypeEnum';
+import { RetailEventEnvelope } from './RetailEventEnvelope';
+
+/** Sobre de `POST /webhooks/users`. */
+export class ReceiveRetailUserEventRequest extends RetailEventEnvelope {
+    @IsIn(Object.values(RetailUserEventTypeEnum))
+    eventType!: RetailUserEventTypeEnum;
+}

package/src/retailIntegration/dtos/ReceiveStoreEventRequest.ts

@@ -0,0 +1,9 @@
+import { IsIn } from 'class-validator';
+import { StoreEventTypeEnum } from '../enums/StoreEventTypeEnum';
+import { RetailEventEnvelope } from './RetailEventEnvelope';
+
+/** Sobre de `POST /webhooks/stores`. */
+export class ReceiveStoreEventRequest extends RetailEventEnvelope {
+    @IsIn(Object.values(StoreEventTypeEnum))
+    eventType!: StoreEventTypeEnum;
+}