@fiado/type-kit 3.233.0 → 3.235.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/identity/enums/SelfieSourceEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Con qué criterio se resolvió cuál archivo de S3 es la selfie del usuario.
+ * Le dice al consumidor qué tan confiable es el match antes de mandarla a un facematch.
+ */
+export declare enum SelfieSourceEnum {
+    /** Matcheó el verificationId de la verificación vigente en People. */
+    VERIFICATION = "VERIFICATION",
+    /** No hubo match por verificación: se tomó el archivo de selfie más reciente del bucket. */
+    LATEST = "LATEST"
+}

package/bin/identity/enums/SelfieSourceEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelfieSourceEnum = void 0;
+/**
+ * Con qué criterio se resolvió cuál archivo de S3 es la selfie del usuario.
+ * Le dice al consumidor qué tan confiable es el match antes de mandarla a un facematch.
+ */
+var SelfieSourceEnum;
+(function (SelfieSourceEnum) {
+    /** Matcheó el verificationId de la verificación vigente en People. */
+    SelfieSourceEnum["VERIFICATION"] = "VERIFICATION";
+    /** No hubo match por verificación: se tomó el archivo de selfie más reciente del bucket. */
+    SelfieSourceEnum["LATEST"] = "LATEST";
+})(SelfieSourceEnum || (exports.SelfieSourceEnum = SelfieSourceEnum = {}));

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/enums/WizardStateEnum.d.ts

@@ -4,6 +4,9 @@
  * ACTIVE - Sesión en curso.
  * PAUSED_EXTERNAL_REFERRAL - Pausada por derivación a proveedor externo.
  * PAUSED_NO_TOPUP - El cliente salió sin recarga de bienvenida (M1 §1087).
+ * PAUSED_CURP_CONFLICT - El CURP verificado ya pertenece a otro cliente del silo. La identidad es
+ *   única por CURP, así que la sesión no puede continuar hasta que alguien resuelva a quién
+ *   corresponde. No es una cancelación (el cliente es válido) ni una falla del sistema.
  * COMPLETED - Venta cerrada.
  * EXPIRED - Expiró por inactividad (TTL DDB ~24h).
  * CANCELLED - Cancelada (incluye KYC PLD).
@@ -12,6 +15,7 @@ export declare enum WizardStateEnum {
     ACTIVE = "ACTIVE",
     PAUSED_EXTERNAL_REFERRAL = "PAUSED_EXTERNAL_REFERRAL",
     PAUSED_NO_TOPUP = "PAUSED_NO_TOPUP",
+    PAUSED_CURP_CONFLICT = "PAUSED_CURP_CONFLICT",
     COMPLETED = "COMPLETED",
     EXPIRED = "EXPIRED",
     CANCELLED = "CANCELLED"

package/bin/retailWizard/enums/WizardStateEnum.js

@@ -7,6 +7,9 @@ exports.WizardStateEnum = void 0;
  * ACTIVE - Sesión en curso.
  * PAUSED_EXTERNAL_REFERRAL - Pausada por derivación a proveedor externo.
  * PAUSED_NO_TOPUP - El cliente salió sin recarga de bienvenida (M1 §1087).
+ * PAUSED_CURP_CONFLICT - El CURP verificado ya pertenece a otro cliente del silo. La identidad es
+ *   única por CURP, así que la sesión no puede continuar hasta que alguien resuelva a quién
+ *   corresponde. No es una cancelación (el cliente es válido) ni una falla del sistema.
  * COMPLETED - Venta cerrada.
  * EXPIRED - Expiró por inactividad (TTL DDB ~24h).
  * CANCELLED - Cancelada (incluye KYC PLD).
@@ -16,6 +19,7 @@ var WizardStateEnum;
     WizardStateEnum["ACTIVE"] = "ACTIVE";
     WizardStateEnum["PAUSED_EXTERNAL_REFERRAL"] = "PAUSED_EXTERNAL_REFERRAL";
     WizardStateEnum["PAUSED_NO_TOPUP"] = "PAUSED_NO_TOPUP";
+    WizardStateEnum["PAUSED_CURP_CONFLICT"] = "PAUSED_CURP_CONFLICT";
     WizardStateEnum["COMPLETED"] = "COMPLETED";
     WizardStateEnum["EXPIRED"] = "EXPIRED";
     WizardStateEnum["CANCELLED"] = "CANCELLED";

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/{platformRbac/dtos/ResendSelfRegisterOtpRequest.js → shipping/dtos/ShippingDestinationAddress.js}

@@ -9,28 +9,38 @@ 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.ResendSelfRegisterOtpRequest = void 0;
-const class_transformer_1 = require("class-transformer");
+exports.ShippingDestinationAddress = void 0;
 const class_validator_1 = require("class-validator");
-/**
- * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
- * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
- * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
- * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
- * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
- */
-class ResendSelfRegisterOtpRequest {
+class ShippingDestinationAddress {
 }
-exports.ResendSelfRegisterOtpRequest = ResendSelfRegisterOtpRequest;
+exports.ShippingDestinationAddress = ShippingDestinationAddress;
 __decorate([
-    (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], ResendSelfRegisterOtpRequest.prototype, "tenantId", void 0);
+], ShippingDestinationAddress.prototype, "street", void 0);
 __decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsEmail)(),
+    (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)
-], ResendSelfRegisterOtpRequest.prototype, "email", void 0);
+], 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/{platformRbac/dtos/ResendOtpRequest.js → shipping/dtos/ShippingRecipient.js}

@@ -9,28 +9,28 @@ 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.ResendOtpRequest = void 0;
-const class_transformer_1 = require("class-transformer");
+exports.ShippingRecipient = void 0;
 const class_validator_1 = require("class-validator");
-/**
- * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
- * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
- * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
- * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
- * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
- */
-class ResendOtpRequest {
+class ShippingRecipient {
 }
-exports.ResendOtpRequest = ResendOtpRequest;
+exports.ShippingRecipient = ShippingRecipient;
 __decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], ResendOtpRequest.prototype, "email", void 0);
+], 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_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], ResendOtpRequest.prototype, "tenantId", void 0);
+], 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.233.0",
+  "version": "3.235.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/enums/WizardStateEnum.ts

@@ -4,6 +4,9 @@
  * ACTIVE - Sesión en curso.
  * PAUSED_EXTERNAL_REFERRAL - Pausada por derivación a proveedor externo.
  * PAUSED_NO_TOPUP - El cliente salió sin recarga de bienvenida (M1 §1087).
+ * PAUSED_CURP_CONFLICT - El CURP verificado ya pertenece a otro cliente del silo. La identidad es
+ *   única por CURP, así que la sesión no puede continuar hasta que alguien resuelva a quién
+ *   corresponde. No es una cancelación (el cliente es válido) ni una falla del sistema.
  * COMPLETED - Venta cerrada.
  * EXPIRED - Expiró por inactividad (TTL DDB ~24h).
  * CANCELLED - Cancelada (incluye KYC PLD).
@@ -12,6 +15,7 @@ export enum WizardStateEnum {
     ACTIVE = 'ACTIVE',
     PAUSED_EXTERNAL_REFERRAL = 'PAUSED_EXTERNAL_REFERRAL',
     PAUSED_NO_TOPUP = 'PAUSED_NO_TOPUP',
+    PAUSED_CURP_CONFLICT = 'PAUSED_CURP_CONFLICT',
     COMPLETED = 'COMPLETED',
     EXPIRED = 'EXPIRED',
     CANCELLED = 'CANCELLED',

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';

package/bin/benefitCenter/enums/BenefitFlowEnum.d.ts

@@ -1,11 +0,0 @@
-export declare enum BenefitFlowEnum {
-    TOPUPS = "TOPUPS",
-    BILL_PAYMENT = "BILL_PAYMENT",
-    CREDIT = "CREDIT",
-    INSURANCE = "INSURANCE",
-    DONATION = "DONATION",
-    PHARMACY = "PHARMACY",
-    REMITTANCE = "REMITTANCE",
-    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
-    WALLET_FUNDING = "WALLET_FUNDING"
-}

package/bin/benefitCenter/enums/BenefitFlowEnum.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BenefitFlowEnum = void 0;
-var BenefitFlowEnum;
-(function (BenefitFlowEnum) {
-    BenefitFlowEnum["TOPUPS"] = "TOPUPS";
-    BenefitFlowEnum["BILL_PAYMENT"] = "BILL_PAYMENT";
-    BenefitFlowEnum["CREDIT"] = "CREDIT";
-    BenefitFlowEnum["INSURANCE"] = "INSURANCE";
-    BenefitFlowEnum["DONATION"] = "DONATION";
-    BenefitFlowEnum["PHARMACY"] = "PHARMACY";
-    BenefitFlowEnum["REMITTANCE"] = "REMITTANCE";
-    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
-    BenefitFlowEnum["WALLET_FUNDING"] = "WALLET_FUNDING";
-})(BenefitFlowEnum || (exports.BenefitFlowEnum = BenefitFlowEnum = {}));

package/bin/loanConfig/enums/ModifiableByRoleEnum.d.ts

@@ -1,11 +0,0 @@
-/**
- * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
- * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
- * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
- * @enum {string}
- */
-export declare enum ModifiableByRoleEnum {
-    SUPER_ADMIN = "super_admin",
-    SOFOM_ADMIN = "sofom_admin",
-    RETAILER_ADMIN = "retailer_admin"
-}

package/bin/loanConfig/enums/ModifiableByRoleEnum.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ModifiableByRoleEnum = void 0;
-/**
- * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
- * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
- * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
- * @enum {string}
- */
-var ModifiableByRoleEnum;
-(function (ModifiableByRoleEnum) {
-    ModifiableByRoleEnum["SUPER_ADMIN"] = "super_admin";
-    ModifiableByRoleEnum["SOFOM_ADMIN"] = "sofom_admin";
-    ModifiableByRoleEnum["RETAILER_ADMIN"] = "retailer_admin";
-})(ModifiableByRoleEnum || (exports.ModifiableByRoleEnum = ModifiableByRoleEnum = {}));

package/bin/places/dtos/CashInFeeDto.d.ts

@@ -1,17 +0,0 @@
-import { CurrencyId } from '../../currency/enums/CurrencyId';
-/**
- * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
- * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
- * - Passport (MX): por red → `fixed` + `percentage`.
- * Response DTO — sin decoradores de validación.
- */
-export declare class CashInFeeDto {
-    /** Comisión fija, en la moneda del país. */
-    fixed?: number;
-    /** Porcentaje del monto depositado (0–100). */
-    percentage?: number;
-    /** Tope máximo de comisión (GreenDot: el asociado cobra hasta este cap). */
-    cap?: number;
-    /** Moneda del fee: USD (GreenDot) | MXN (Passport). */
-    currency: CurrencyId;
-}

package/bin/places/dtos/CashInFeeDto.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CashInFeeDto = void 0;
-/**
- * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
- * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
- * - Passport (MX): por red → `fixed` + `percentage`.
- * Response DTO — sin decoradores de validación.
- */
-class CashInFeeDto {
-}
-exports.CashInFeeDto = CashInFeeDto;

package/bin/platformRbac/dtos/ResendOtpRequest.d.ts

@@ -1,22 +0,0 @@
-import { MfaMethodEnum } from '../enums/MfaMethodEnum';
-/**
- * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
- * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
- * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
- * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
- * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
- */
-export declare class ResendOtpRequest {
-    email: string;
-    tenantId: string;
-}
-/**
- * Respuesta del resend-otp. `session`/`mfaMethod` frescos del nuevo challenge CUSTOM_AUTH.
- * Plain sin validators (no validamos lo que mandamos al cliente — fiado-validation-and-dtos § 7).
- * Ambos opcionales: en los caminos de rechazo silencioso (anti-enumeración) o ramas sin CUSTOM_AUTH
- * el server responde 200 genérico sin session ni método.
- */
-export interface ResendOtpResponse {
-    session?: string;
-    mfaMethod?: MfaMethodEnum;
-}

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.d.ts

@@ -1,11 +0,0 @@
-/**
- * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
- * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
- * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
- * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
- * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
- */
-export declare class ResendSelfRegisterOtpRequest {
-    tenantId: string;
-    email: string;
-}