@fiado/type-kit 3.189.0 → 3.191.0

package/_test_/unit/retailOrg/dtos/validation/validationDtos.test.ts

@@ -1,11 +1,13 @@
 import { RetailerValidationDto } from '../../../../../src/retailOrg/dtos/validation/RetailerValidationDto';
 import { StoreValidationDto } from '../../../../../src/retailOrg/dtos/validation/StoreValidationDto';
 import { RetailUserValidationDto } from '../../../../../src/retailOrg/dtos/validation/RetailUserValidationDto';
+import { CollectorValidationDto } from '../../../../../src/retailOrg/dtos/validation/CollectorValidationDto';
 import { RetailerTypeEnum } from '../../../../../src/retailOrg/enums/RetailerTypeEnum';
 import { RetailerStatusEnum } from '../../../../../src/retailOrg/enums/RetailerStatusEnum';
 import { StoreStatusEnum } from '../../../../../src/retailOrg/enums/StoreStatusEnum';
 import { EmploymentTypeEnum } from '../../../../../src/retailOrg/enums/EmploymentTypeEnum';
 import { RetailUserStatusEnum } from '../../../../../src/retailOrg/enums/RetailUserStatusEnum';
+import { CollectorSeniorityEnum } from '../../../../../src/retailOrg/enums/CollectorSeniorityEnum';
 
 describe('ValidationDtos (shapes mínimos de endpoints privados)', () => {
     it('RetailerValidationDto acepta el shape mínimo', () => {
@@ -46,4 +48,29 @@ describe('ValidationDtos (shapes mínimos de endpoints privados)', () => {
         expect(dto.employmentType).toBe(EmploymentTypeEnum.EMPLOYEE);
         expect(dto.commissionTier).toBe('TIER_A');
     });
+
+    it('CollectorValidationDto acepta el shape con seniority (coverageStoreIds requerido)', () => {
+        const dto: CollectorValidationDto = {
+            retailUserId: 'ru_001',
+            coverageStoreIds: ['store_001', 'store_002'],
+            collectorSeniority: CollectorSeniorityEnum.SENIOR,
+            status: RetailUserStatusEnum.ACTIVE,
+            commissionTier: 'TIER_A',
+        };
+        expect(dto.coverageStoreIds).toHaveLength(2);
+        expect(dto.collectorSeniority).toBe(CollectorSeniorityEnum.SENIOR);
+        expect(dto.status).toBe(RetailUserStatusEnum.ACTIVE);
+    });
+
+    it('CollectorValidationDto acepta un cobrador SIN seniority (collectorSeniority opcional)', () => {
+        const dto: CollectorValidationDto = {
+            retailUserId: 'ru_002',
+            coverageStoreIds: [],
+            status: RetailUserStatusEnum.ACTIVE,
+            commissionTier: 'collector',
+        };
+        expect(dto.collectorSeniority).toBeUndefined();
+        expect(dto.coverageStoreIds).toHaveLength(0);
+        expect(dto.commissionTier).toBe('collector');
+    });
 });

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

@@ -0,0 +1,11 @@
+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

@@ -0,0 +1,15 @@
+"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/index.d.ts

@@ -89,6 +89,8 @@ export * as Modelias from './modelias';
 export * as NetworkConnector from './networkConnector';
 export * as EmailVerification from './emailVerification';
 export * as RetailOrg from './retailOrg';
+export * as RetailCatalog from './retailCatalog';
+export * as RetailCards from './retailCards';
 export * as LoanConfig from './loanConfig';
 export * as LoanOfferings from './loanOfferings';
 export * as LoanCollectorAssignment from './loanCollectorAssignment';

package/bin/index.js

@@ -37,7 +37,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Device = 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.Account = exports.Crypto = void 0;
-exports.LoanCollectorAssignment = exports.LoanOfferings = exports.LoanConfig = 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 = void 0;
+exports.LoanCollectorAssignment = exports.LoanOfferings = exports.LoanConfig = 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 = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.Activity = __importStar(require("./activity"));
@@ -143,6 +143,12 @@ exports.EmailVerification = __importStar(require("./emailVerification"));
 // RetailOrg: DTOs/enums del lambda retail-org-business (SureKeep Fase 1 — pista Retail).
 // Dominio de retailers → zonas → tiendas → usuarios retail.
 exports.RetailOrg = __importStar(require("./retailOrg"));
+// RetailCatalog: DTOs/enums del lambda retail-catalog-business (comp 05 — catálogo de productos
+// por SKU + inventario por IMEI; SureKeep Fase 1 — pista Retail).
+exports.RetailCatalog = __importStar(require("./retailCatalog"));
+// RetailCards: DTOs/enums del lambda retail-cards-business (comp 06 — tarjetas físicas PCF:
+// lotes, stock y asignación; SureKeep Fase 1 — pista Retail).
+exports.RetailCards = __importStar(require("./retailCards"));
 // LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
 exports.LoanConfig = __importStar(require("./loanConfig"));
 // LoanOfferings: DTOs/enums del lambda loan-offerings-business (comp 07 — planes de crédito,

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

@@ -0,0 +1,11 @@
+/**
+ * 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

@@ -0,0 +1,15 @@
+"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

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1,12 @@
+"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

@@ -0,0 +1,22 @@
+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/ResendOtpRequest.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.ResendOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+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 {
+}
+exports.ResendOtpRequest = ResendOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendOtpRequest.prototype, "email", 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);

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

@@ -0,0 +1,11 @@
+/**
+ * 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;
+}

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.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.ResendSelfRegisterOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+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 {
+}
+exports.ResendSelfRegisterOtpRequest = ResendSelfRegisterOtpRequest;
+__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);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "email", void 0);

package/bin/retailCards/dtos/requests/AssignCardRequest.d.ts

@@ -0,0 +1,6 @@
+/** Body de la asignación de una tarjeta física a un cliente. */
+export declare class AssignCardRequest {
+    assignedToCustomerId: string;
+    assignedByUserId: string;
+    creditId?: string;
+}

package/bin/retailCards/dtos/requests/AssignCardRequest.js

@@ -0,0 +1,30 @@
+"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.AssignCardRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** Body de la asignación de una tarjeta física a un cliente. */
+class AssignCardRequest {
+}
+exports.AssignCardRequest = AssignCardRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AssignCardRequest.prototype, "assignedToCustomerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AssignCardRequest.prototype, "assignedByUserId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AssignCardRequest.prototype, "creditId", void 0);

package/bin/retailCards/dtos/requests/CancelCardRequest.d.ts

@@ -0,0 +1,5 @@
+import { CardCancelReasonEnum } from '../../enums/CardCancelReasonEnum';
+/** Body de la cancelación (anulación) de una tarjeta física. */
+export declare class CancelCardRequest {
+    reason: CardCancelReasonEnum;
+}

package/bin/retailCards/dtos/requests/CancelCardRequest.js

@@ -0,0 +1,22 @@
+"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.CancelCardRequest = void 0;
+const class_validator_1 = require("class-validator");
+const CardCancelReasonEnum_1 = require("../../enums/CardCancelReasonEnum");
+/** Body de la cancelación (anulación) de una tarjeta física. */
+class CancelCardRequest {
+}
+exports.CancelCardRequest = CancelCardRequest;
+__decorate([
+    (0, class_validator_1.IsEnum)(CardCancelReasonEnum_1.CardCancelReasonEnum),
+    __metadata("design:type", String)
+], CancelCardRequest.prototype, "reason", void 0);

package/bin/retailCards/dtos/requests/RegisterCardBatchRequest.d.ts

@@ -0,0 +1,7 @@
+/** Body del registro (recepción) de un lote de tarjetas para una tienda. */
+export declare class RegisterCardBatchRequest {
+    storeId: string;
+    totalCards: number;
+    cardNumbers: string[];
+    notes?: string | null;
+}

package/bin/retailCards/dtos/requests/RegisterCardBatchRequest.js

@@ -0,0 +1,38 @@
+"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.RegisterCardBatchRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** Body del registro (recepción) de un lote de tarjetas para una tienda. */
+class RegisterCardBatchRequest {
+}
+exports.RegisterCardBatchRequest = RegisterCardBatchRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RegisterCardBatchRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(1000),
+    __metadata("design:type", Number)
+], RegisterCardBatchRequest.prototype, "totalCards", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(1000),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], RegisterCardBatchRequest.prototype, "cardNumbers", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RegisterCardBatchRequest.prototype, "notes", void 0);

package/bin/retailCards/dtos/responses/CardBatchResponse.d.ts

@@ -0,0 +1,17 @@
+import { CardBatchStatusEnum } from '../../enums/CardBatchStatusEnum';
+/** Representación de un lote de tarjetas hacia el cliente. */
+export interface CardBatchResponse {
+    batchId: string;
+    retailerId: string;
+    storeId: string;
+    totalCards: number;
+    expectedCardCount: number;
+    loadedCount: number;
+    availableCount: number;
+    assignedCount: number;
+    cancelledCount: number;
+    status: CardBatchStatusEnum;
+    receivedAt: string;
+    receivedByUserId: string;
+    notes: string | null;
+}

package/bin/retailCards/dtos/responses/CardBatchResponse.js

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

package/bin/retailCards/dtos/responses/RetailCardResponse.d.ts

@@ -0,0 +1,12 @@
+import { RetailCardStatusEnum } from '../../enums/RetailCardStatusEnum';
+/** Representación de una tarjeta física hacia el cliente. */
+export interface RetailCardResponse {
+    cardNumber: string;
+    retailerId: string;
+    batchId: string;
+    storeId: string;
+    status: RetailCardStatusEnum;
+    assignedToCustomerId: string | null;
+    assignedAt: string | null;
+    assignedByUserId: string | null;
+}

package/bin/retailCards/dtos/responses/RetailCardResponse.js

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

package/bin/retailCards/dtos/responses/StockAlertItem.d.ts

@@ -0,0 +1,7 @@
+/** Ítem de alerta de stock por tienda. */
+export interface StockAlertItem {
+    storeId: string;
+    storeName: string;
+    availableCount: number;
+    threshold: number;
+}

package/bin/retailCards/dtos/responses/StockAlertItem.js

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

package/bin/retailCards/dtos/responses/StockAlertsResponse.d.ts

@@ -0,0 +1,5 @@
+import { StockAlertItem } from './StockAlertItem';
+/** Respuesta del reporte de alertas de stock. */
+export interface StockAlertsResponse {
+    alerts: StockAlertItem[];
+}

package/bin/retailCards/dtos/responses/StockAlertsResponse.js

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

package/bin/retailCards/enums/CardBatchStatusEnum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Estado de un lote de tarjetas.
+ * @enum {string}
+ *
+ * @property {string} RECEIVING - Transitorio, carga en curso (DEC-004/DEC-008).
+ * @property {string} RECEIVED - Carga completada, lote atado a una tienda (happy-path F1).
+ * @property {string} FAILED - Terminal, la carga del lote falló (DEC-004/DEC-008).
+ * @property {string} DISTRIBUTED - Reservado F1 — lote centralizado repartido a varias tiendas (TD-008).
+ * @property {string} CLOSED - Reservado F1 — cierre manual del lote (TD-008).
+ */
+export declare enum CardBatchStatusEnum {
+    RECEIVING = "RECEIVING",
+    RECEIVED = "RECEIVED",
+    FAILED = "FAILED",
+    DISTRIBUTED = "DISTRIBUTED",
+    CLOSED = "CLOSED"
+}

package/bin/retailCards/enums/CardBatchStatusEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardBatchStatusEnum = void 0;
+/**
+ * Estado de un lote de tarjetas.
+ * @enum {string}
+ *
+ * @property {string} RECEIVING - Transitorio, carga en curso (DEC-004/DEC-008).
+ * @property {string} RECEIVED - Carga completada, lote atado a una tienda (happy-path F1).
+ * @property {string} FAILED - Terminal, la carga del lote falló (DEC-004/DEC-008).
+ * @property {string} DISTRIBUTED - Reservado F1 — lote centralizado repartido a varias tiendas (TD-008).
+ * @property {string} CLOSED - Reservado F1 — cierre manual del lote (TD-008).
+ */
+var CardBatchStatusEnum;
+(function (CardBatchStatusEnum) {
+    CardBatchStatusEnum["RECEIVING"] = "RECEIVING";
+    CardBatchStatusEnum["RECEIVED"] = "RECEIVED";
+    CardBatchStatusEnum["FAILED"] = "FAILED";
+    CardBatchStatusEnum["DISTRIBUTED"] = "DISTRIBUTED";
+    CardBatchStatusEnum["CLOSED"] = "CLOSED";
+})(CardBatchStatusEnum || (exports.CardBatchStatusEnum = CardBatchStatusEnum = {}));

package/bin/retailCards/enums/CardCancelReasonEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Motivo de cancelación de una tarjeta física.
+ * @enum {string}
+ *
+ * @property {string} PLASTIC_DAMAGED - Plástico dañado.
+ * @property {string} LOST - Tarjeta perdida.
+ * @property {string} THEFT_REPORTED - Robo reportado.
+ */
+export declare enum CardCancelReasonEnum {
+    PLASTIC_DAMAGED = "PLASTIC_DAMAGED",
+    LOST = "LOST",
+    THEFT_REPORTED = "THEFT_REPORTED"
+}

package/bin/retailCards/enums/CardCancelReasonEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardCancelReasonEnum = void 0;
+/**
+ * Motivo de cancelación de una tarjeta física.
+ * @enum {string}
+ *
+ * @property {string} PLASTIC_DAMAGED - Plástico dañado.
+ * @property {string} LOST - Tarjeta perdida.
+ * @property {string} THEFT_REPORTED - Robo reportado.
+ */
+var CardCancelReasonEnum;
+(function (CardCancelReasonEnum) {
+    CardCancelReasonEnum["PLASTIC_DAMAGED"] = "PLASTIC_DAMAGED";
+    CardCancelReasonEnum["LOST"] = "LOST";
+    CardCancelReasonEnum["THEFT_REPORTED"] = "THEFT_REPORTED";
+})(CardCancelReasonEnum || (exports.CardCancelReasonEnum = CardCancelReasonEnum = {}));

package/bin/retailCards/enums/RetailCardStatusEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Estado de una tarjeta física individual.
+ * @enum {string}
+ *
+ * @property {string} AVAILABLE - Cargada en stock, disponible para asignar.
+ * @property {string} ASSIGNED - Asignada a un cliente.
+ * @property {string} CANCELLED - Anulada (plástico dañado, pérdida o robo). Estado terminal.
+ */
+export declare enum RetailCardStatusEnum {
+    AVAILABLE = "AVAILABLE",
+    ASSIGNED = "ASSIGNED",
+    CANCELLED = "CANCELLED"
+}

package/bin/retailCards/enums/RetailCardStatusEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailCardStatusEnum = void 0;
+/**
+ * Estado de una tarjeta física individual.
+ * @enum {string}
+ *
+ * @property {string} AVAILABLE - Cargada en stock, disponible para asignar.
+ * @property {string} ASSIGNED - Asignada a un cliente.
+ * @property {string} CANCELLED - Anulada (plástico dañado, pérdida o robo). Estado terminal.
+ */
+var RetailCardStatusEnum;
+(function (RetailCardStatusEnum) {
+    RetailCardStatusEnum["AVAILABLE"] = "AVAILABLE";
+    RetailCardStatusEnum["ASSIGNED"] = "ASSIGNED";
+    RetailCardStatusEnum["CANCELLED"] = "CANCELLED";
+})(RetailCardStatusEnum || (exports.RetailCardStatusEnum = RetailCardStatusEnum = {}));

package/bin/retailCards/events/CardBatchReceivedV1.d.ts

@@ -0,0 +1,9 @@
+/** Emitido cuando un lote de tarjetas se recibe (RECEIVED). */
+export interface CardBatchReceivedV1 {
+    batchId: string;
+    retailerId: string;
+    storeId: string;
+    totalCards: number;
+    receivedByUserId: string;
+    occurredAt: string;
+}

package/bin/retailCards/events/CardBatchReceivedV1.js

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

package/bin/retailCards/events/RetailCardAssignedV1.d.ts

@@ -0,0 +1,10 @@
+/** Emitido cuando una tarjeta se asigna a un cliente. */
+export interface RetailCardAssignedV1 {
+    cardNumber: string;
+    retailerId: string;
+    storeId: string;
+    assignedToCustomerId: string;
+    assignedByUserId: string;
+    creditId?: string;
+    occurredAt: string;
+}

package/bin/retailCards/events/RetailCardAssignedV1.js

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

package/bin/retailCards/events/RetailCardCancelledV1.d.ts

@@ -0,0 +1,9 @@
+import { CardCancelReasonEnum } from '../enums/CardCancelReasonEnum';
+/** Emitido cuando una tarjeta se cancela (anula). */
+export interface RetailCardCancelledV1 {
+    cardNumber: string;
+    retailerId: string;
+    storeId: string;
+    reason: CardCancelReasonEnum;
+    occurredAt: string;
+}

package/bin/retailCards/events/RetailCardCancelledV1.js

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

package/bin/retailCards/events/RetailCardReleasedV1.d.ts

@@ -0,0 +1,7 @@
+/** Emitido cuando una tarjeta se libera (vuelve a AVAILABLE). */
+export interface RetailCardReleasedV1 {
+    cardNumber: string;
+    retailerId: string;
+    storeId: string;
+    occurredAt: string;
+}

package/bin/retailCards/events/RetailCardReleasedV1.js

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