@fiado/type-kit 3.236.0 → 3.238.0

package/_test_/unit/shipping/CreateShippingRequest.validation.test.ts

@@ -0,0 +1,71 @@
+import 'reflect-metadata';
+import { describe, it, expect } from '@jest/globals';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { CreateShippingRequest } from '../../../src/shipping/dtos/CreateShippingRequest';
+import { ShippingContentType } from '../../../src/shipping/enums/ShippingContentType';
+import { DeliveryTypeEnum } from '../../../src/shipping/enums/DeliveryTypeEnum';
+
+const BASE = {
+    sourceSystem: 'CARD_BUSINESS',
+    originReference: 'POMELO#card_9f3c1e',
+    fiadoReference: 'POMELO#card_9f3c1e',
+    contentType: ShippingContentType.CARD,
+    deliveryType: DeliveryTypeEnum.OFFICE,
+    recipient: { firstName: 'Maria', lastName: 'Gomez', phoneNumber: '5511110000' },
+    destinationAddress: {
+        street: 'Avenida Insurgentes',
+        addressNumber: '1234',
+        neighborhood: 'Del Valle',
+        municipality: 'Benito Juarez',
+        region: 'CDMX',
+        postalCode: '03100',
+    },
+    officeCode: 'OC-001',
+    officeName: 'ESTAFETA CENTRO',
+};
+
+async function errorsOf(payload: Record<string, unknown>): Promise<string[]> {
+    const errors = await validate(plainToInstance(CreateShippingRequest, payload));
+    return errors.map(e => e.property);
+}
+
+describe('CreateShippingRequest', () => {
+
+    it('acepta un request OFFICE completo', async () => {
+        expect(await errorsOf(BASE)).toEqual([]);
+    });
+
+    it('acepta HOME sin officeCode ni officeName', async () => {
+        const { officeCode, officeName, ...home } = BASE;
+        expect(await errorsOf({ ...home, deliveryType: DeliveryTypeEnum.HOME })).toEqual([]);
+    });
+
+    it('exige officeCode y officeName cuando deliveryType es OFFICE', async () => {
+        const { officeCode, officeName, ...sinOficina } = BASE;
+        const props = await errorsOf(sinOficina);
+        expect(props).toContain('officeCode');
+        expect(props).toContain('officeName');
+    });
+
+    it('rechaza contentType y deliveryType fuera del enum', async () => {
+        const props = await errorsOf({ ...BASE, contentType: 'celular', deliveryType: 'DOMICILIO' });
+        expect(props).toContain('contentType');
+        expect(props).toContain('deliveryType');
+    });
+
+    it('exige los campos anidados del destinatario y la direccion', async () => {
+        const props = await errorsOf({ ...BASE, recipient: {}, destinationAddress: {} });
+        expect(props).toContain('recipient');
+        expect(props).toContain('destinationAddress');
+    });
+
+    it('NO valida el techo de 60 de deliveryReference: eso lo hace el conector con error tipado', async () => {
+        expect(await errorsOf({ ...BASE, deliveryReference: 'x'.repeat(61) })).toEqual([]);
+    });
+
+    it('lastName, phoneNumberSecondary, deliveryReference y additionalData son opcionales', async () => {
+        const { recipient, ...rest } = BASE;
+        expect(await errorsOf({ ...rest, recipient: { firstName: 'Jose', phoneNumber: '5533330000' } })).toEqual([]);
+    });
+});

package/bin/index.d.ts

@@ -104,3 +104,4 @@ export * as Kyc from './kyc';
 export * from './messaging';
 export * from './complaint';
 export * as PhoneSales from './phoneSales';
+export * as Shipping from './shipping';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Observations = exports.IssuanceBusiness = exports.Blacklist = 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.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = 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.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = 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.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 = void 0;
-exports.PhoneSales = exports.Kyc = exports.LoanScoring = exports.LoanCredit = void 0;
+exports.Shipping = exports.PhoneSales = exports.Kyc = exports.LoanScoring = exports.LoanCredit = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -185,3 +185,7 @@ __exportStar(require("./complaint"), exports);
 // PhoneSales: DTOs del lambda cell-phone-sales-business — variantes de dispositivo (modelo/color/
 // storage/precio/stock), venta con delivery PICKUP|HOME y redención de código de referencia.
 exports.PhoneSales = __importStar(require("./phoneSales"));
+// Shipping: contrato genérico de envíos del fiado-estafeta-connector — agnóstico al producto
+// (tarjetas, teléfonos, …). ExternalShippingStatus se reexporta acá desde `card/` sin moverlo,
+// para no romper a los consumidores actuales del namespace Card.
+exports.Shipping = __importStar(require("./shipping"));

package/bin/retailWizard/dtos/requests/ProfileQuestionsRequest.d.ts

@@ -10,6 +10,10 @@
  * catálogos — mandar un valor fuera de catálogo deja un expediente que ningún backoffice sabe pintar,
  * y nadie lo rechaza en runtime porque del otro lado son strings libres.
  *
+ * ⚠️ Dos de los cinco NO usan el catálogo que su nombre sugiere. Está anotado en cada constante:
+ * `usageMonthly` sale de `Frequency` (no de `MoneyUsageCategories`) y `beneficialOwner` de `ActMXN`
+ * (no de `BeneficialOwnerMXN`). Sale de leer la pantalla real de la app, no de la doc.
+ *
  * ⚠️ `beneficialOwner` debe ser `SELF` para que la cuenta pueda abrir: `fiado-card-business` valida
  * exactamente ese valor. `OTHER` ("viene de otra persona") es una respuesta legítima del cliente que
  * BLOQUEA la apertura — la pantalla tiene que advertirlo antes, no descubrirlo después.
@@ -20,11 +24,23 @@
 export declare const MONTHLY_INCOME_VALUES: readonly ["0", "10000", "20000", "50000", "100000", "150000"];
 /** `dataType=ExtraSupport` — apoyo económico extra mensual. */
 export declare const EXTRA_SUPPORT_VALUES: readonly ["0", "2000", "10000", "20000", "50000", "60000"];
-/** `dataType=MoneyUsageCategories` — para qué usará el dinero. */
-export declare const USAGE_MONTHLY_VALUES: readonly ["DAILY_EXPENSES", "SAVINGS", "OTHER"];
+/**
+ * `dataType=Frequency` — con qué frecuencia va a usar la cuenta ("2 al día", "3 al día"…).
+ *
+ * ⚠️ El nombre del campo engaña: `MXN_UsageMonthly` NO es "para qué usa el dinero". Es la FRECUENCIA
+ * de operaciones, y su catálogo es `Frequency`, no `MoneyUsageCategories`. Verificado contra la
+ * pantalla real de la app (`CreateAddressMxScreen`), que manda
+ * `MXN_UsageMonthly: selectedPaymentOrPurchaseFrequency.value`.
+ */
+export declare const USAGE_MONTHLY_VALUES: readonly ["60", "90", "150", "180", "210", "240", "270", "300"];
 /** `dataType=PurchaseAmountMaxMXN` — monto máximo por operación. */
 export declare const MAXIMUM_TX_VALUES: readonly ["10000", "100000", "300000"];
-/** `dataType=BeneficialOwnerMXN` — de quién es el dinero. */
+/**
+ * `dataType=ActMXN` — "¿Actúas por tu propia cuenta?" (`SELF` = "Sí, por mi propia cuenta").
+ *
+ * ⚠️ NO es `BeneficialOwnerMXN`. Los dos catálogos comparten los valores `SELF`/`OTHER`, pero la
+ * pregunta que la app le hace al cliente es la de `ActMXN` y esa es la redacción que debe mostrarse.
+ */
 export declare const BENEFICIAL_OWNER_VALUES: readonly ["SELF", "OTHER"];
 export declare class ProfileQuestionsRequest {
     monthlyIncome: string;

package/bin/retailWizard/dtos/requests/ProfileQuestionsRequest.js

@@ -24,6 +24,10 @@ const class_validator_1 = require("class-validator");
  * catálogos — mandar un valor fuera de catálogo deja un expediente que ningún backoffice sabe pintar,
  * y nadie lo rechaza en runtime porque del otro lado son strings libres.
  *
+ * ⚠️ Dos de los cinco NO usan el catálogo que su nombre sugiere. Está anotado en cada constante:
+ * `usageMonthly` sale de `Frequency` (no de `MoneyUsageCategories`) y `beneficialOwner` de `ActMXN`
+ * (no de `BeneficialOwnerMXN`). Sale de leer la pantalla real de la app, no de la doc.
+ *
  * ⚠️ `beneficialOwner` debe ser `SELF` para que la cuenta pueda abrir: `fiado-card-business` valida
  * exactamente ese valor. `OTHER` ("viene de otra persona") es una respuesta legítima del cliente que
  * BLOQUEA la apertura — la pantalla tiene que advertirlo antes, no descubrirlo después.
@@ -34,11 +38,23 @@ const class_validator_1 = require("class-validator");
 exports.MONTHLY_INCOME_VALUES = ['0', '10000', '20000', '50000', '100000', '150000'];
 /** `dataType=ExtraSupport` — apoyo económico extra mensual. */
 exports.EXTRA_SUPPORT_VALUES = ['0', '2000', '10000', '20000', '50000', '60000'];
-/** `dataType=MoneyUsageCategories` — para qué usará el dinero. */
-exports.USAGE_MONTHLY_VALUES = ['DAILY_EXPENSES', 'SAVINGS', 'OTHER'];
+/**
+ * `dataType=Frequency` — con qué frecuencia va a usar la cuenta ("2 al día", "3 al día"…).
+ *
+ * ⚠️ El nombre del campo engaña: `MXN_UsageMonthly` NO es "para qué usa el dinero". Es la FRECUENCIA
+ * de operaciones, y su catálogo es `Frequency`, no `MoneyUsageCategories`. Verificado contra la
+ * pantalla real de la app (`CreateAddressMxScreen`), que manda
+ * `MXN_UsageMonthly: selectedPaymentOrPurchaseFrequency.value`.
+ */
+exports.USAGE_MONTHLY_VALUES = ['60', '90', '150', '180', '210', '240', '270', '300'];
 /** `dataType=PurchaseAmountMaxMXN` — monto máximo por operación. */
 exports.MAXIMUM_TX_VALUES = ['10000', '100000', '300000'];
-/** `dataType=BeneficialOwnerMXN` — de quién es el dinero. */
+/**
+ * `dataType=ActMXN` — "¿Actúas por tu propia cuenta?" (`SELF` = "Sí, por mi propia cuenta").
+ *
+ * ⚠️ NO es `BeneficialOwnerMXN`. Los dos catálogos comparten los valores `SELF`/`OTHER`, pero la
+ * pregunta que la app le hace al cliente es la de `ActMXN` y esa es la redacción que debe mostrarse.
+ */
 exports.BENEFICIAL_OWNER_VALUES = ['SELF', 'OTHER'];
 class ProfileQuestionsRequest {
 }

package/bin/shipping/dtos/CreateShippingRequest.d.ts

@@ -0,0 +1,25 @@
+import { ShippingContentType } from '../enums/ShippingContentType';
+import { DeliveryTypeEnum } from '../enums/DeliveryTypeEnum';
+import { ShippingRecipient } from './ShippingRecipient';
+import { ShippingDestinationAddress } from './ShippingDestinationAddress';
+export declare class CreateShippingRequest {
+    sourceSystem: string;
+    /** Id de la operacion en el negocio origen. Clave de idempotencia. NO va al archivo. */
+    originReference: string;
+    /** Columna 12 del XLSX: referencia interna Fiado del envio. */
+    fiadoReference: string;
+    contentType: ShippingContentType;
+    deliveryType: DeliveryTypeEnum;
+    recipient: ShippingRecipient;
+    destinationAddress: ShippingDestinationAddress;
+    officeCode?: string;
+    officeName?: string;
+    /**
+     * Columna 10 (REFERENCIAS), ya compuesta por el consumidor. El techo de 60 caracteres lo
+     * hace cumplir el conector con error tipado: si se validara aca, el rechazo saldria como
+     * error de validacion generico y DeliveryReferenceTooLongError seria inalcanzable.
+     */
+    deliveryReference?: string;
+    /** Valores de las columnas 13+. Las claves matchean los extraColumns de la config. */
+    additionalData?: Record<string, string>;
+}

package/bin/shipping/dtos/CreateShippingRequest.js

@@ -0,0 +1,76 @@
+"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.CreateShippingRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ShippingContentType_1 = require("../enums/ShippingContentType");
+const DeliveryTypeEnum_1 = require("../enums/DeliveryTypeEnum");
+const ShippingRecipient_1 = require("./ShippingRecipient");
+const ShippingDestinationAddress_1 = require("./ShippingDestinationAddress");
+class CreateShippingRequest {
+}
+exports.CreateShippingRequest = CreateShippingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateShippingRequest.prototype, "sourceSystem", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateShippingRequest.prototype, "originReference", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateShippingRequest.prototype, "fiadoReference", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(ShippingContentType_1.ShippingContentType),
+    __metadata("design:type", String)
+], CreateShippingRequest.prototype, "contentType", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(DeliveryTypeEnum_1.DeliveryTypeEnum),
+    __metadata("design:type", String)
+], CreateShippingRequest.prototype, "deliveryType", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => ShippingRecipient_1.ShippingRecipient),
+    __metadata("design:type", ShippingRecipient_1.ShippingRecipient)
+], CreateShippingRequest.prototype, "recipient", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => ShippingDestinationAddress_1.ShippingDestinationAddress),
+    __metadata("design:type", ShippingDestinationAddress_1.ShippingDestinationAddress)
+], CreateShippingRequest.prototype, "destinationAddress", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)(o => o.deliveryType === DeliveryTypeEnum_1.DeliveryTypeEnum.OFFICE),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateShippingRequest.prototype, "officeCode", void 0);
+__decorate([
+    (0, class_validator_1.ValidateIf)(o => o.deliveryType === DeliveryTypeEnum_1.DeliveryTypeEnum.OFFICE),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CreateShippingRequest.prototype, "officeName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateShippingRequest.prototype, "deliveryReference", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], CreateShippingRequest.prototype, "additionalData", void 0);

package/bin/shipping/dtos/CreateShippingResponse.d.ts

@@ -0,0 +1,5 @@
+import { ExternalShippingStatus } from '../../card/enums/ExternalShippingStatus';
+export declare class CreateShippingResponse {
+    externalShippingId: string;
+    externalShippingStatus: ExternalShippingStatus;
+}

package/bin/shipping/dtos/CreateShippingResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreateShippingResponse = void 0;
+class CreateShippingResponse {
+}
+exports.CreateShippingResponse = CreateShippingResponse;

package/bin/shipping/dtos/ShippingDestinationAddress.d.ts

@@ -0,0 +1,8 @@
+export declare class ShippingDestinationAddress {
+    street: string;
+    addressNumber: string;
+    neighborhood: string;
+    municipality: string;
+    region: string;
+    postalCode: string;
+}

package/bin/shipping/dtos/ShippingDestinationAddress.js

@@ -0,0 +1,46 @@
+"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.ShippingDestinationAddress = void 0;
+const class_validator_1 = require("class-validator");
+class ShippingDestinationAddress {
+}
+exports.ShippingDestinationAddress = ShippingDestinationAddress;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ShippingDestinationAddress.prototype, "street", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ShippingDestinationAddress.prototype, "addressNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ShippingDestinationAddress.prototype, "neighborhood", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ShippingDestinationAddress.prototype, "municipality", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ShippingDestinationAddress.prototype, "region", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ShippingDestinationAddress.prototype, "postalCode", void 0);

package/bin/shipping/dtos/ShippingRecipient.d.ts

@@ -0,0 +1,6 @@
+export declare class ShippingRecipient {
+    firstName: string;
+    lastName?: string;
+    phoneNumber: string;
+    phoneNumberSecondary?: string;
+}

package/bin/shipping/dtos/ShippingRecipient.js

@@ -0,0 +1,36 @@
+"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.ShippingRecipient = void 0;
+const class_validator_1 = require("class-validator");
+class ShippingRecipient {
+}
+exports.ShippingRecipient = ShippingRecipient;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ShippingRecipient.prototype, "firstName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ShippingRecipient.prototype, "lastName", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ShippingRecipient.prototype, "phoneNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ShippingRecipient.prototype, "phoneNumberSecondary", void 0);

package/bin/shipping/dtos/UpdateShippingStatusRequest.d.ts

@@ -0,0 +1,15 @@
+import { ExternalShippingStatus } from '../../card/enums/ExternalShippingStatus';
+/**
+ * Notificacion conector -> negocio origen. Los 3 campos de tracking son opcionales porque un
+ * evento temprano de Estafeta puede no traer description y el consumidor no debe romper con un
+ * item degradado; el conector los manda siempre que los tenga.
+ */
+export declare class UpdateShippingStatusRequest {
+    externalShippingId: string;
+    originReference: string;
+    externalShippingStatus: ExternalShippingStatus;
+    externalShippingStatusDetail?: string;
+    shippingTrackingNumber?: string;
+    shippingTrackingUrl?: string;
+    occurredAt: string;
+}

package/bin/shipping/dtos/UpdateShippingStatusRequest.js

@@ -0,0 +1,55 @@
+"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.UpdateShippingStatusRequest = void 0;
+const class_validator_1 = require("class-validator");
+const ExternalShippingStatus_1 = require("../../card/enums/ExternalShippingStatus");
+/**
+ * Notificacion conector -> negocio origen. Los 3 campos de tracking son opcionales porque un
+ * evento temprano de Estafeta puede no traer description y el consumidor no debe romper con un
+ * item degradado; el conector los manda siempre que los tenga.
+ */
+class UpdateShippingStatusRequest {
+}
+exports.UpdateShippingStatusRequest = UpdateShippingStatusRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], UpdateShippingStatusRequest.prototype, "externalShippingId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], UpdateShippingStatusRequest.prototype, "originReference", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(ExternalShippingStatus_1.ExternalShippingStatus),
+    __metadata("design:type", String)
+], UpdateShippingStatusRequest.prototype, "externalShippingStatus", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateShippingStatusRequest.prototype, "externalShippingStatusDetail", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateShippingStatusRequest.prototype, "shippingTrackingNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateShippingStatusRequest.prototype, "shippingTrackingUrl", void 0);
+__decorate([
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], UpdateShippingStatusRequest.prototype, "occurredAt", void 0);

package/bin/shipping/enums/DeliveryTypeEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum DeliveryTypeEnum {
+    HOME = "HOME",
+    OFFICE = "OFFICE"
+}

package/bin/shipping/enums/DeliveryTypeEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeliveryTypeEnum = void 0;
+var DeliveryTypeEnum;
+(function (DeliveryTypeEnum) {
+    DeliveryTypeEnum["HOME"] = "HOME";
+    DeliveryTypeEnum["OFFICE"] = "OFFICE";
+})(DeliveryTypeEnum || (exports.DeliveryTypeEnum = DeliveryTypeEnum = {}));

package/bin/shipping/enums/ShippingContentType.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tipo de contenido del envio. Determina la columna 11 del XLSX via el catalogo de labels,
+ * que vive en Dynamo: sumar un valor aca es un bump minor + una fila en el catalogo, sin
+ * deploy del conector.
+ */
+export declare enum ShippingContentType {
+    CARD = "CARD",
+    PHONE = "PHONE"
+}

package/bin/shipping/enums/ShippingContentType.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShippingContentType = void 0;
+/**
+ * Tipo de contenido del envio. Determina la columna 11 del XLSX via el catalogo de labels,
+ * que vive en Dynamo: sumar un valor aca es un bump minor + una fila en el catalogo, sin
+ * deploy del conector.
+ */
+var ShippingContentType;
+(function (ShippingContentType) {
+    ShippingContentType["CARD"] = "CARD";
+    ShippingContentType["PHONE"] = "PHONE";
+})(ShippingContentType || (exports.ShippingContentType = ShippingContentType = {}));

package/bin/shipping/index.d.ts

@@ -0,0 +1,8 @@
+export * from './dtos/ShippingRecipient';
+export * from './dtos/ShippingDestinationAddress';
+export * from './dtos/CreateShippingRequest';
+export * from './dtos/CreateShippingResponse';
+export * from './dtos/UpdateShippingStatusRequest';
+export * from './enums/ShippingContentType';
+export * from './enums/DeliveryTypeEnum';
+export { ExternalShippingStatus } from '../card/enums/ExternalShippingStatus';

package/bin/shipping/index.js

@@ -0,0 +1,31 @@
+"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 });
+exports.ExternalShippingStatus = void 0;
+//dtos
+__exportStar(require("./dtos/ShippingRecipient"), exports);
+__exportStar(require("./dtos/ShippingDestinationAddress"), exports);
+__exportStar(require("./dtos/CreateShippingRequest"), exports);
+__exportStar(require("./dtos/CreateShippingResponse"), exports);
+__exportStar(require("./dtos/UpdateShippingStatusRequest"), exports);
+//enums
+__exportStar(require("./enums/ShippingContentType"), exports);
+__exportStar(require("./enums/DeliveryTypeEnum"), exports);
+// ExternalShippingStatus es agnostico al producto: se reexporta desde shipping SIN tocar el
+// export de card, para que el dominio nuevo no importe del namespace de un producto y los
+// consumidores actuales no se rompan.
+var ExternalShippingStatus_1 = require("../card/enums/ExternalShippingStatus");
+Object.defineProperty(exports, "ExternalShippingStatus", { enumerable: true, get: function () { return ExternalShippingStatus_1.ExternalShippingStatus; } });

package/package.json

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

package/src/index.ts

@@ -144,3 +144,7 @@ export * from './complaint';
 // PhoneSales: DTOs del lambda cell-phone-sales-business — variantes de dispositivo (modelo/color/
 // storage/precio/stock), venta con delivery PICKUP|HOME y redención de código de referencia.
 export * as PhoneSales from './phoneSales';
+// Shipping: contrato genérico de envíos del fiado-estafeta-connector — agnóstico al producto
+// (tarjetas, teléfonos, …). ExternalShippingStatus se reexporta acá desde `card/` sin moverlo,
+// para no romper a los consumidores actuales del namespace Card.
+export * as Shipping from './shipping';

package/src/retailWizard/dtos/requests/ProfileQuestionsRequest.ts

@@ -13,6 +13,10 @@ import { IsIn, IsString } from 'class-validator';
  * catálogos — mandar un valor fuera de catálogo deja un expediente que ningún backoffice sabe pintar,
  * y nadie lo rechaza en runtime porque del otro lado son strings libres.
  *
+ * ⚠️ Dos de los cinco NO usan el catálogo que su nombre sugiere. Está anotado en cada constante:
+ * `usageMonthly` sale de `Frequency` (no de `MoneyUsageCategories`) y `beneficialOwner` de `ActMXN`
+ * (no de `BeneficialOwnerMXN`). Sale de leer la pantalla real de la app, no de la doc.
+ *
  * ⚠️ `beneficialOwner` debe ser `SELF` para que la cuenta pueda abrir: `fiado-card-business` valida
  * exactamente ese valor. `OTHER` ("viene de otra persona") es una respuesta legítima del cliente que
  * BLOQUEA la apertura — la pantalla tiene que advertirlo antes, no descubrirlo después.
@@ -26,13 +30,25 @@ export const MONTHLY_INCOME_VALUES = ['0', '10000', '20000', '50000', '100000',
 /** `dataType=ExtraSupport` — apoyo económico extra mensual. */
 export const EXTRA_SUPPORT_VALUES = ['0', '2000', '10000', '20000', '50000', '60000'] as const;
 
-/** `dataType=MoneyUsageCategories` — para qué usará el dinero. */
-export const USAGE_MONTHLY_VALUES = ['DAILY_EXPENSES', 'SAVINGS', 'OTHER'] as const;
+/**
+ * `dataType=Frequency` — con qué frecuencia va a usar la cuenta ("2 al día", "3 al día"…).
+ *
+ * ⚠️ El nombre del campo engaña: `MXN_UsageMonthly` NO es "para qué usa el dinero". Es la FRECUENCIA
+ * de operaciones, y su catálogo es `Frequency`, no `MoneyUsageCategories`. Verificado contra la
+ * pantalla real de la app (`CreateAddressMxScreen`), que manda
+ * `MXN_UsageMonthly: selectedPaymentOrPurchaseFrequency.value`.
+ */
+export const USAGE_MONTHLY_VALUES = ['60', '90', '150', '180', '210', '240', '270', '300'] as const;
 
 /** `dataType=PurchaseAmountMaxMXN` — monto máximo por operación. */
 export const MAXIMUM_TX_VALUES = ['10000', '100000', '300000'] as const;
 
-/** `dataType=BeneficialOwnerMXN` — de quién es el dinero. */
+/**
+ * `dataType=ActMXN` — "¿Actúas por tu propia cuenta?" (`SELF` = "Sí, por mi propia cuenta").
+ *
+ * ⚠️ NO es `BeneficialOwnerMXN`. Los dos catálogos comparten los valores `SELF`/`OTHER`, pero la
+ * pregunta que la app le hace al cliente es la de `ActMXN` y esa es la redacción que debe mostrarse.
+ */
 export const BENEFICIAL_OWNER_VALUES = ['SELF', 'OTHER'] as const;
 
 export class ProfileQuestionsRequest {

package/src/shipping/dtos/CreateShippingRequest.ts

@@ -0,0 +1,60 @@
+import { Type } from 'class-transformer';
+import { IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, ValidateIf, ValidateNested } from 'class-validator';
+import { ShippingContentType } from '../enums/ShippingContentType';
+import { DeliveryTypeEnum } from '../enums/DeliveryTypeEnum';
+import { ShippingRecipient } from './ShippingRecipient';
+import { ShippingDestinationAddress } from './ShippingDestinationAddress';
+
+export class CreateShippingRequest {
+    @IsString()
+    @IsNotEmpty()
+    sourceSystem: string;
+
+    /** Id de la operacion en el negocio origen. Clave de idempotencia. NO va al archivo. */
+    @IsString()
+    @IsNotEmpty()
+    originReference: string;
+
+    /** Columna 12 del XLSX: referencia interna Fiado del envio. */
+    @IsString()
+    @IsNotEmpty()
+    fiadoReference: string;
+
+    @IsEnum(ShippingContentType)
+    contentType: ShippingContentType;
+
+    @IsEnum(DeliveryTypeEnum)
+    deliveryType: DeliveryTypeEnum;
+
+    @ValidateNested()
+    @Type(() => ShippingRecipient)
+    recipient: ShippingRecipient;
+
+    @ValidateNested()
+    @Type(() => ShippingDestinationAddress)
+    destinationAddress: ShippingDestinationAddress;
+
+    @ValidateIf(o => o.deliveryType === DeliveryTypeEnum.OFFICE)
+    @IsString()
+    @IsNotEmpty()
+    officeCode?: string;
+
+    @ValidateIf(o => o.deliveryType === DeliveryTypeEnum.OFFICE)
+    @IsString()
+    @IsNotEmpty()
+    officeName?: string;
+
+    /**
+     * Columna 10 (REFERENCIAS), ya compuesta por el consumidor. El techo de 60 caracteres lo
+     * hace cumplir el conector con error tipado: si se validara aca, el rechazo saldria como
+     * error de validacion generico y DeliveryReferenceTooLongError seria inalcanzable.
+     */
+    @IsOptional()
+    @IsString()
+    deliveryReference?: string;
+
+    /** Valores de las columnas 13+. Las claves matchean los extraColumns de la config. */
+    @IsOptional()
+    @IsObject()
+    additionalData?: Record<string, string>;
+}

package/src/shipping/dtos/CreateShippingResponse.ts

@@ -0,0 +1,6 @@
+import { ExternalShippingStatus } from '../../card/enums/ExternalShippingStatus';
+
+export class CreateShippingResponse {
+    externalShippingId: string;
+    externalShippingStatus: ExternalShippingStatus;
+}

package/src/shipping/dtos/ShippingDestinationAddress.ts

@@ -0,0 +1,27 @@
+import { IsNotEmpty, IsString } from 'class-validator';
+
+export class ShippingDestinationAddress {
+    @IsString()
+    @IsNotEmpty()
+    street: string;
+
+    @IsString()
+    @IsNotEmpty()
+    addressNumber: string;
+
+    @IsString()
+    @IsNotEmpty()
+    neighborhood: string;
+
+    @IsString()
+    @IsNotEmpty()
+    municipality: string;
+
+    @IsString()
+    @IsNotEmpty()
+    region: string;
+
+    @IsString()
+    @IsNotEmpty()
+    postalCode: string;
+}

package/src/shipping/dtos/ShippingRecipient.ts

@@ -0,0 +1,19 @@
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+
+export class ShippingRecipient {
+    @IsString()
+    @IsNotEmpty()
+    firstName: string;
+
+    @IsOptional()
+    @IsString()
+    lastName?: string;
+
+    @IsString()
+    @IsNotEmpty()
+    phoneNumber: string;
+
+    @IsOptional()
+    @IsString()
+    phoneNumberSecondary?: string;
+}

package/src/shipping/dtos/UpdateShippingStatusRequest.ts

@@ -0,0 +1,35 @@
+import { IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { ExternalShippingStatus } from '../../card/enums/ExternalShippingStatus';
+
+/**
+ * Notificacion conector -> negocio origen. Los 3 campos de tracking son opcionales porque un
+ * evento temprano de Estafeta puede no traer description y el consumidor no debe romper con un
+ * item degradado; el conector los manda siempre que los tenga.
+ */
+export class UpdateShippingStatusRequest {
+    @IsString()
+    @IsNotEmpty()
+    externalShippingId: string;
+
+    @IsString()
+    @IsNotEmpty()
+    originReference: string;
+
+    @IsEnum(ExternalShippingStatus)
+    externalShippingStatus: ExternalShippingStatus;
+
+    @IsOptional()
+    @IsString()
+    externalShippingStatusDetail?: string;
+
+    @IsOptional()
+    @IsString()
+    shippingTrackingNumber?: string;
+
+    @IsOptional()
+    @IsString()
+    shippingTrackingUrl?: string;
+
+    @IsISO8601()
+    occurredAt: string;
+}

package/src/shipping/enums/DeliveryTypeEnum.ts

@@ -0,0 +1,4 @@
+export enum DeliveryTypeEnum {
+    HOME = 'HOME',
+    OFFICE = 'OFFICE',
+}

package/src/shipping/enums/ShippingContentType.ts

@@ -0,0 +1,9 @@
+/**
+ * Tipo de contenido del envio. Determina la columna 11 del XLSX via el catalogo de labels,
+ * que vive en Dynamo: sumar un valor aca es un bump minor + una fila en el catalogo, sin
+ * deploy del conector.
+ */
+export enum ShippingContentType {
+    CARD = 'CARD',
+    PHONE = 'PHONE',
+}

package/src/shipping/index.ts

@@ -0,0 +1,15 @@
+//dtos
+export * from './dtos/ShippingRecipient';
+export * from './dtos/ShippingDestinationAddress';
+export * from './dtos/CreateShippingRequest';
+export * from './dtos/CreateShippingResponse';
+export * from './dtos/UpdateShippingStatusRequest';
+
+//enums
+export * from './enums/ShippingContentType';
+export * from './enums/DeliveryTypeEnum';
+
+// ExternalShippingStatus es agnostico al producto: se reexporta desde shipping SIN tocar el
+// export de card, para que el dominio nuevo no importe del namespace de un producto y los
+// consumidores actuales no se rompan.
+export { ExternalShippingStatus } from '../card/enums/ExternalShippingStatus';