@fiado/type-kit 3.549.0 → 3.551.0

package/bin/retailCommission/dtos/CommissionLedger.js

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

package/bin/retailCommission/dtos/CommissionRule.d.ts

@@ -1,9 +1,11 @@
 import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
 import type { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
+import type { CommissionBillingPeriodEnum } from '../enums/CommissionBillingPeriodEnum';
 import type { CommissionBonusModeEnum } from '../enums/CommissionBonusModeEnum';
 import type { CommissionCountByEnum } from '../enums/CommissionCountByEnum';
 import type { CommissionMetricEnum } from '../enums/CommissionMetricEnum';
 import type { CommissionOperatorEnum } from '../enums/CommissionOperatorEnum';
+import type { CommissionPayTimingEnum } from '../enums/CommissionPayTimingEnum';
 import type { CommissionRuleStatusEnum } from '../enums/CommissionRuleStatusEnum';
 import type { CommissionWindowEnum } from '../enums/CommissionWindowEnum';
 /**
@@ -75,6 +77,8 @@ export interface CommissionRule {
     replacesOthers: boolean;
     /** Si la regla cuenta piezas o ventas. Ausente = `PIECE`. */
     countBy?: CommissionCountByEnum;
+    /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
+    payTiming?: CommissionPayTimingEnum;
     /** Sube en cada guardado. */
     version: number;
     /** La versión que está en el plan vigente. `null` si nunca se publicó. */
@@ -102,10 +106,19 @@ export interface CommissionPolicyCommissions {
     editedBy: string;
     editedAt: string;
 }
-/** Políticas de la cadena. Cada una es `null` mientras la cadena no la guarda. */
+/** Política de pagos a la wallet de los vendedores. */
+export interface CommissionPayoutPolicy {
+    /** Depositar las comisiones a la wallet. Apagado, todo se calcula y queda pendiente. */
+    walletDeposits: boolean;
+    /** Cada cuánto se le cobra a la cadena. */
+    chainBillingPeriod: CommissionBillingPeriodEnum;
+}
+/** Políticas de la cadena. `clawback` y `commissions` son `null` mientras la cadena no las guarda. */
 export interface CommissionPolicies {
     clawback: CommissionPolicyClawback | null;
     commissions: CommissionPolicyCommissions | null;
+    /** Ausente = depósitos encendidos y cobro semanal. */
+    payouts?: CommissionPayoutPolicy;
 }
 /**
  * El plan vigente: las reglas publicadas y las políticas, congeladas en un snapshot inmutable.

package/bin/retailCommission/enums/CommissionBillingPeriodEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cada cuánto se le cobra a la cadena lo que Fiado depositó a sus vendedores.
+ *
+ * WEEKLY - Semanal. Es el valor cuando la cadena no guardó la política.
+ * MONTHLY - Mensual.
+ */
+export declare enum CommissionBillingPeriodEnum {
+    WEEKLY = "WEEKLY",
+    MONTHLY = "MONTHLY"
+}

package/bin/retailCommission/enums/CommissionBillingPeriodEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionBillingPeriodEnum = void 0;
+/**
+ * Cada cuánto se le cobra a la cadena lo que Fiado depositó a sus vendedores.
+ *
+ * WEEKLY - Semanal. Es el valor cuando la cadena no guardó la política.
+ * MONTHLY - Mensual.
+ */
+var CommissionBillingPeriodEnum;
+(function (CommissionBillingPeriodEnum) {
+    CommissionBillingPeriodEnum["WEEKLY"] = "WEEKLY";
+    CommissionBillingPeriodEnum["MONTHLY"] = "MONTHLY";
+})(CommissionBillingPeriodEnum || (exports.CommissionBillingPeriodEnum = CommissionBillingPeriodEnum = {}));

package/bin/retailCommission/enums/CommissionLedgerMovementKindEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tipo de movimiento del libro de pagos. Un movimiento nunca cambia.
+ *
+ * EARN - Ganado: suma al exigible o al retenido.
+ * DEDUCT - Descontado del exigible.
+ * RELEASE - Liberación mensual: pasa de retenido a exigible.
+ * PAID_OUTSIDE - Pagado por fuera de la wallet: sale del exigible sin depósito.
+ */
+export declare enum CommissionLedgerMovementKindEnum {
+    EARN = "EARN",
+    DEDUCT = "DEDUCT",
+    RELEASE = "RELEASE",
+    PAID_OUTSIDE = "PAID_OUTSIDE"
+}

package/bin/retailCommission/enums/CommissionLedgerMovementKindEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionLedgerMovementKindEnum = void 0;
+/**
+ * Tipo de movimiento del libro de pagos. Un movimiento nunca cambia.
+ *
+ * EARN - Ganado: suma al exigible o al retenido.
+ * DEDUCT - Descontado del exigible.
+ * RELEASE - Liberación mensual: pasa de retenido a exigible.
+ * PAID_OUTSIDE - Pagado por fuera de la wallet: sale del exigible sin depósito.
+ */
+var CommissionLedgerMovementKindEnum;
+(function (CommissionLedgerMovementKindEnum) {
+    CommissionLedgerMovementKindEnum["EARN"] = "EARN";
+    CommissionLedgerMovementKindEnum["DEDUCT"] = "DEDUCT";
+    CommissionLedgerMovementKindEnum["RELEASE"] = "RELEASE";
+    CommissionLedgerMovementKindEnum["PAID_OUTSIDE"] = "PAID_OUTSIDE";
+})(CommissionLedgerMovementKindEnum || (exports.CommissionLedgerMovementKindEnum = CommissionLedgerMovementKindEnum = {}));

package/bin/retailCommission/enums/CommissionPayTimingEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cuándo se paga lo que gana una regla.
+ *
+ * ON_SALE - Al momento: se vuelve exigible al registrar la venta. Solo para reglas que únicamente
+ *   pagan bono por venta.
+ * ON_CUT - Al cierre de la semana. Es el valor cuando la regla no lo trae.
+ * MONTHLY - Al cierre del mes: se retiene hasta el día 1 del mes siguiente al lunes del corte.
+ */
+export declare enum CommissionPayTimingEnum {
+    ON_SALE = "ON_SALE",
+    ON_CUT = "ON_CUT",
+    MONTHLY = "MONTHLY"
+}

package/bin/retailCommission/enums/CommissionPayTimingEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPayTimingEnum = void 0;
+/**
+ * Cuándo se paga lo que gana una regla.
+ *
+ * ON_SALE - Al momento: se vuelve exigible al registrar la venta. Solo para reglas que únicamente
+ *   pagan bono por venta.
+ * ON_CUT - Al cierre de la semana. Es el valor cuando la regla no lo trae.
+ * MONTHLY - Al cierre del mes: se retiene hasta el día 1 del mes siguiente al lunes del corte.
+ */
+var CommissionPayTimingEnum;
+(function (CommissionPayTimingEnum) {
+    CommissionPayTimingEnum["ON_SALE"] = "ON_SALE";
+    CommissionPayTimingEnum["ON_CUT"] = "ON_CUT";
+    CommissionPayTimingEnum["MONTHLY"] = "MONTHLY";
+})(CommissionPayTimingEnum || (exports.CommissionPayTimingEnum = CommissionPayTimingEnum = {}));

package/bin/retailCommission/enums/CommissionPayTriggerEnum.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Qué pidió pagarle a un vendedor.
+ *
+ * SALE - Una venta con reglas al momento.
+ * CUT - El cierre del corte.
+ * RELEASE - La liberación mensual.
+ * ADJUSTMENT - Un ajuste manual.
+ * WALLET_LINKED - Se vinculó su wallet.
+ * RETRY - "Reintentar ahora" desde "Por pagar".
+ */
+export declare enum CommissionPayTriggerEnum {
+    SALE = "SALE",
+    CUT = "CUT",
+    RELEASE = "RELEASE",
+    ADJUSTMENT = "ADJUSTMENT",
+    WALLET_LINKED = "WALLET_LINKED",
+    RETRY = "RETRY"
+}

package/bin/retailCommission/enums/CommissionPayTriggerEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPayTriggerEnum = void 0;
+/**
+ * Qué pidió pagarle a un vendedor.
+ *
+ * SALE - Una venta con reglas al momento.
+ * CUT - El cierre del corte.
+ * RELEASE - La liberación mensual.
+ * ADJUSTMENT - Un ajuste manual.
+ * WALLET_LINKED - Se vinculó su wallet.
+ * RETRY - "Reintentar ahora" desde "Por pagar".
+ */
+var CommissionPayTriggerEnum;
+(function (CommissionPayTriggerEnum) {
+    CommissionPayTriggerEnum["SALE"] = "SALE";
+    CommissionPayTriggerEnum["CUT"] = "CUT";
+    CommissionPayTriggerEnum["RELEASE"] = "RELEASE";
+    CommissionPayTriggerEnum["ADJUSTMENT"] = "ADJUSTMENT";
+    CommissionPayTriggerEnum["WALLET_LINKED"] = "WALLET_LINKED";
+    CommissionPayTriggerEnum["RETRY"] = "RETRY";
+})(CommissionPayTriggerEnum || (exports.CommissionPayTriggerEnum = CommissionPayTriggerEnum = {}));

package/bin/retailCommission/enums/CommissionPaymentAttentionEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Por qué el saldo de un vendedor aparece en "Por pagar".
+ *
+ * NO_WALLET - No tiene wallet vinculada.
+ * REJECTED - Su último depósito se rechazó (cuenta bloqueada, tope de nivel...); el código va aparte.
+ * PAUSED - La cadena apagó los depósitos a la wallet.
+ * DEBT - Su exigible es negativo: debe.
+ */
+export declare enum CommissionPaymentAttentionEnum {
+    NO_WALLET = "NO_WALLET",
+    REJECTED = "REJECTED",
+    PAUSED = "PAUSED",
+    DEBT = "DEBT"
+}

package/bin/retailCommission/enums/CommissionPaymentAttentionEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPaymentAttentionEnum = void 0;
+/**
+ * Por qué el saldo de un vendedor aparece en "Por pagar".
+ *
+ * NO_WALLET - No tiene wallet vinculada.
+ * REJECTED - Su último depósito se rechazó (cuenta bloqueada, tope de nivel...); el código va aparte.
+ * PAUSED - La cadena apagó los depósitos a la wallet.
+ * DEBT - Su exigible es negativo: debe.
+ */
+var CommissionPaymentAttentionEnum;
+(function (CommissionPaymentAttentionEnum) {
+    CommissionPaymentAttentionEnum["NO_WALLET"] = "NO_WALLET";
+    CommissionPaymentAttentionEnum["REJECTED"] = "REJECTED";
+    CommissionPaymentAttentionEnum["PAUSED"] = "PAUSED";
+    CommissionPaymentAttentionEnum["DEBT"] = "DEBT";
+})(CommissionPaymentAttentionEnum || (exports.CommissionPaymentAttentionEnum = CommissionPaymentAttentionEnum = {}));

package/bin/retailCommission/enums/CommissionPaymentStatusEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Estado de un depósito de comisiones a la wallet del vendedor.
+ *
+ * PENDING - El monto se apartó y el depósito está en curso.
+ * ACCREDITED - Depositado, con folio.
+ * FAILED - Rechazado sin mover dinero: el monto vuelve al exigible.
+ * UNVERIFIED - Resultado ambiguo: el monto sigue apartado y no se reintenta solo; alguien lo revisa.
+ */
+export declare enum CommissionPaymentStatusEnum {
+    PENDING = "PENDING",
+    ACCREDITED = "ACCREDITED",
+    FAILED = "FAILED",
+    UNVERIFIED = "UNVERIFIED"
+}

package/bin/retailCommission/enums/CommissionPaymentStatusEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPaymentStatusEnum = void 0;
+/**
+ * Estado de un depósito de comisiones a la wallet del vendedor.
+ *
+ * PENDING - El monto se apartó y el depósito está en curso.
+ * ACCREDITED - Depositado, con folio.
+ * FAILED - Rechazado sin mover dinero: el monto vuelve al exigible.
+ * UNVERIFIED - Resultado ambiguo: el monto sigue apartado y no se reintenta solo; alguien lo revisa.
+ */
+var CommissionPaymentStatusEnum;
+(function (CommissionPaymentStatusEnum) {
+    CommissionPaymentStatusEnum["PENDING"] = "PENDING";
+    CommissionPaymentStatusEnum["ACCREDITED"] = "ACCREDITED";
+    CommissionPaymentStatusEnum["FAILED"] = "FAILED";
+    CommissionPaymentStatusEnum["UNVERIFIED"] = "UNVERIFIED";
+})(CommissionPaymentStatusEnum || (exports.CommissionPaymentStatusEnum = CommissionPaymentStatusEnum = {}));

package/bin/retailCommission/index.d.ts

@@ -20,11 +20,18 @@ export * from './enums/CommissionCountByEnum';
 export * from './enums/CommissionAggregateByEnum';
 export * from './enums/CommissionSeriesByEnum';
 export * from './enums/CommissionSimulationSkipEnum';
+export * from './enums/CommissionPayTimingEnum';
+export * from './enums/CommissionBillingPeriodEnum';
+export * from './enums/CommissionPaymentStatusEnum';
+export * from './enums/CommissionPaymentAttentionEnum';
+export * from './enums/CommissionLedgerMovementKindEnum';
+export * from './enums/CommissionPayTriggerEnum';
 export * from './dtos/CommissionPlan';
 export * from './dtos/CommissionRule';
 export * from './dtos/CommissionCouponAccrual';
 export * from './dtos/CommissionCalcTrace';
 export * from './dtos/CommissionAccrual';
 export * from './dtos/CommissionPayout';
+export * from './dtos/CommissionLedger';
 export * from './dtos/CommissionApi';
 export * from './dtos/PrivateLatestClosedPayout';

package/bin/retailCommission/index.js

@@ -37,6 +37,12 @@ __exportStar(require("./enums/CommissionCountByEnum"), exports);
 __exportStar(require("./enums/CommissionAggregateByEnum"), exports);
 __exportStar(require("./enums/CommissionSeriesByEnum"), exports);
 __exportStar(require("./enums/CommissionSimulationSkipEnum"), exports);
+__exportStar(require("./enums/CommissionPayTimingEnum"), exports);
+__exportStar(require("./enums/CommissionBillingPeriodEnum"), exports);
+__exportStar(require("./enums/CommissionPaymentStatusEnum"), exports);
+__exportStar(require("./enums/CommissionPaymentAttentionEnum"), exports);
+__exportStar(require("./enums/CommissionLedgerMovementKindEnum"), exports);
+__exportStar(require("./enums/CommissionPayTriggerEnum"), exports);
 // Entidades del dominio
 __exportStar(require("./dtos/CommissionPlan"), exports);
 __exportStar(require("./dtos/CommissionRule"), exports);
@@ -44,6 +50,7 @@ __exportStar(require("./dtos/CommissionCouponAccrual"), exports);
 __exportStar(require("./dtos/CommissionCalcTrace"), exports);
 __exportStar(require("./dtos/CommissionAccrual"), exports);
 __exportStar(require("./dtos/CommissionPayout"), exports);
+__exportStar(require("./dtos/CommissionLedger"), exports);
 // Contratos HTTP — uno por endpoint
 __exportStar(require("./dtos/CommissionApi"), exports);
 __exportStar(require("./dtos/PrivateLatestClosedPayout"), exports);

package/bin/retailOrg/dtos/RetailUser.d.ts

@@ -1,6 +1,7 @@
 import { CollectorSeniorityEnum } from '../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../enums/EmploymentTypeEnum';
 import { RetailUserStatusEnum } from '../enums/RetailUserStatusEnum';
+import { RetailUserWalletLinkMethodEnum } from '../enums/RetailUserWalletLinkMethodEnum';
 /**
  * RetailUser — usuario retail (empleado de tienda) de un retailer (SureKeep Fase 1 — pista Retail).
  * `cognitoSub` enlaza con la identidad en Cognito (validada vía platform-rbac por api-invoker).
@@ -28,6 +29,18 @@ export declare class RetailUser {
     /** Tiendas que cubre el cobrador (zona de cobranza); opcional. */
     coverageStoreIds?: string[];
     status: RetailUserStatusEnum;
+    /** Directorio de Fiado del dueño de la wallet PCF; `null` o ausente si no tiene wallet. */
+    fiadoDirectoryId?: string | null;
+    /** Cuenta PCF de la wallet. */
+    pcfAccountId?: string | null;
+    /** Cómo se encontró la wallet: por CLABE o por teléfono. */
+    walletLinkMethod?: RetailUserWalletLinkMethodEnum | null;
+    /** Últimos 4 dígitos de la CLABE; la CLABE completa no se guarda. */
+    walletClabeLast4?: string | null;
+    /** Cuándo se vinculó (ISO). */
+    walletLinkedAt?: string | null;
+    /** Quién la vinculó: el actorId del usuario del back office. */
+    walletLinkedBy?: string | null;
     createdAt: string;
     updatedAt: string;
     createdBy: string;

package/bin/retailOrg/dtos/RetailUser.js

@@ -16,6 +16,7 @@ const regex_1 = require("../../helpers/constans/regex");
 const CollectorSeniorityEnum_1 = require("../enums/CollectorSeniorityEnum");
 const EmploymentTypeEnum_1 = require("../enums/EmploymentTypeEnum");
 const RetailUserStatusEnum_1 = require("../enums/RetailUserStatusEnum");
+const RetailUserWalletLinkMethodEnum_1 = require("../enums/RetailUserWalletLinkMethodEnum");
 /**
  * RetailUser — usuario retail (empleado de tienda) de un retailer (SureKeep Fase 1 — pista Retail).
  * `cognitoSub` enlaza con la identidad en Cognito (validada vía platform-rbac por api-invoker).
@@ -89,6 +90,44 @@ __decorate([
     (0, class_validator_1.IsEnum)(RetailUserStatusEnum_1.RetailUserStatusEnum),
     __metadata("design:type", String)
 ], RetailUser.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailUser.prototype, "fiadoDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailUser.prototype, "pcfAccountId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RetailUserWalletLinkMethodEnum_1.RetailUserWalletLinkMethodEnum),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletLinkMethod", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^\d{4}$/, { message: 'walletClabeLast4 debe tener 4 dígitos' }),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletClabeLast4", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexIso8601, { message: 'walletLinkedAt debe ser una fecha ISO 8601' }),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletLinkedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletLinkedBy", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

package/bin/retailOrg/dtos/requests/LinkRetailUserWalletRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Body de `PUT /retailers/{retailerId}/users/{retailUserId}/wallet`: vincula la wallet PCF del
+ * vendedor por CLABE o por teléfono, exactamente uno. El servidor vuelve a resolver la cuenta.
+ */
+export declare class LinkRetailUserWalletRequest {
+    /** CLABE PCF, 18 dígitos. Solo se guardan los últimos 4; no va a logs completa. */
+    clabe?: string | null;
+    /** Teléfono de México: 10 dígitos, con o sin `+52`; retail-org lo normaliza a E.164. No va a logs completo. */
+    phone?: string | null;
+}

package/bin/retailOrg/dtos/requests/LinkRetailUserWalletRequest.js

@@ -0,0 +1,37 @@
+"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.LinkRetailUserWalletRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const IsSingleWalletKeyConstraint_1 = require("../../validators/IsSingleWalletKeyConstraint");
+/**
+ * Body de `PUT /retailers/{retailerId}/users/{retailUserId}/wallet`: vincula la wallet PCF del
+ * vendedor por CLABE o por teléfono, exactamente uno. El servidor vuelve a resolver la cuenta.
+ */
+class LinkRetailUserWalletRequest {
+}
+exports.LinkRetailUserWalletRequest = LinkRetailUserWalletRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.clabe != null || o.phone == null),
+    (0, class_validator_1.Validate)(IsSingleWalletKeyConstraint_1.IsSingleWalletKeyConstraint),
+    (0, class_validator_1.IsString)({ message: 'clabe debe ser texto' }),
+    (0, class_validator_1.Matches)(/^\d{18}$/, { message: 'clabe debe tener 18 dígitos' }),
+    __metadata("design:type", String)
+], LinkRetailUserWalletRequest.prototype, "clabe", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)({ message: 'phone debe ser texto' }),
+    (0, class_validator_1.Matches)(/^(\+52)?\d{10}$/, { message: 'phone debe tener 10 dígitos, con o sin +52' }),
+    __metadata("design:type", String)
+], LinkRetailUserWalletRequest.prototype, "phone", void 0);

package/bin/retailOrg/dtos/requests/LookupRetailUserWalletRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Body de `POST /retailers/{retailerId}/users/wallet-lookup`: busca una wallet PCF por CLABE o por
+ * teléfono, exactamente uno. No escribe nada.
+ */
+export declare class LookupRetailUserWalletRequest {
+    /** CLABE PCF, 18 dígitos. No va a logs completa. */
+    clabe?: string | null;
+    /** Teléfono de México: 10 dígitos, con o sin `+52`; retail-org lo normaliza a E.164. No va a logs completo. */
+    phone?: string | null;
+}

package/bin/retailOrg/dtos/requests/LookupRetailUserWalletRequest.js

@@ -0,0 +1,37 @@
+"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.LookupRetailUserWalletRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const IsSingleWalletKeyConstraint_1 = require("../../validators/IsSingleWalletKeyConstraint");
+/**
+ * Body de `POST /retailers/{retailerId}/users/wallet-lookup`: busca una wallet PCF por CLABE o por
+ * teléfono, exactamente uno. No escribe nada.
+ */
+class LookupRetailUserWalletRequest {
+}
+exports.LookupRetailUserWalletRequest = LookupRetailUserWalletRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.clabe != null || o.phone == null),
+    (0, class_validator_1.Validate)(IsSingleWalletKeyConstraint_1.IsSingleWalletKeyConstraint),
+    (0, class_validator_1.IsString)({ message: 'clabe debe ser texto' }),
+    (0, class_validator_1.Matches)(/^\d{18}$/, { message: 'clabe debe tener 18 dígitos' }),
+    __metadata("design:type", String)
+], LookupRetailUserWalletRequest.prototype, "clabe", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)({ message: 'phone debe ser texto' }),
+    (0, class_validator_1.Matches)(/^(\+52)?\d{10}$/, { message: 'phone debe tener 10 dígitos, con o sin +52' }),
+    __metadata("design:type", String)
+], LookupRetailUserWalletRequest.prototype, "phone", void 0);

package/bin/retailOrg/dtos/responses/LookupRetailUserWalletResponse.d.ts

@@ -0,0 +1,10 @@
+import type { RetailUserWalletLinkMethodEnum } from '../../enums/RetailUserWalletLinkMethodEnum';
+/** Respuesta de `POST /retailers/{retailerId}/users/wallet-lookup`. */
+export interface LookupRetailUserWalletResponse {
+    found: boolean;
+    active: boolean;
+    /** Nombre del titular para que el administrador confirme; `null` si no se encontró. */
+    holderName: string | null;
+    /** Por dónde se buscó. */
+    method: RetailUserWalletLinkMethodEnum;
+}

package/bin/retailOrg/dtos/responses/LookupRetailUserWalletResponse.js

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

package/bin/retailOrg/dtos/responses/PrivateRetailUserWalletResponse.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Respuesta de `GET /private/retailers/{retailerId}/users/{retailUserId}/wallet`: la wallet del
+ * vendedor para el motor de comisiones. Ambos `null` si no tiene wallet vinculada.
+ */
+export interface PrivateRetailUserWalletResponse {
+    directoryId: string | null;
+    pcfAccountId: string | null;
+}

package/bin/retailOrg/dtos/responses/PrivateRetailUserWalletResponse.js

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

package/bin/retailOrg/enums/RetailUserWalletLinkMethodEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cómo se encontró la wallet PCF del vendedor.
+ * @enum {string}
+ *
+ * @property {string} CLABE - Por la CLABE PCF capturada en el alta.
+ * @property {string} PHONE - Por el teléfono de su usuario de Fiado.
+ */
+export declare enum RetailUserWalletLinkMethodEnum {
+    CLABE = "CLABE",
+    PHONE = "PHONE"
+}

package/bin/retailOrg/enums/RetailUserWalletLinkMethodEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailUserWalletLinkMethodEnum = void 0;
+/**
+ * Cómo se encontró la wallet PCF del vendedor.
+ * @enum {string}
+ *
+ * @property {string} CLABE - Por la CLABE PCF capturada en el alta.
+ * @property {string} PHONE - Por el teléfono de su usuario de Fiado.
+ */
+var RetailUserWalletLinkMethodEnum;
+(function (RetailUserWalletLinkMethodEnum) {
+    RetailUserWalletLinkMethodEnum["CLABE"] = "CLABE";
+    RetailUserWalletLinkMethodEnum["PHONE"] = "PHONE";
+})(RetailUserWalletLinkMethodEnum || (exports.RetailUserWalletLinkMethodEnum = RetailUserWalletLinkMethodEnum = {}));

package/bin/retailOrg/index.d.ts

@@ -5,6 +5,7 @@ export * from './enums/StoreStatusEnum';
 export * from './enums/RetailUserStatusEnum';
 export * from './enums/EmploymentTypeEnum';
 export * from './enums/CollectorSeniorityEnum';
+export * from './enums/RetailUserWalletLinkMethodEnum';
 export * from './enums/GoalTargetTypeEnum';
 export * from './dtos/GeoLocation';
 export * from './dtos/GoalAmounts';
@@ -18,6 +19,7 @@ export * from './dtos/validation/RetailUserValidationDto';
 export * from './dtos/validation/CollectorValidationDto';
 export * from './dtos/validation/PrivateSellerListResponse';
 export * from './dtos/PaginatedResult';
+export * from './validators/IsSingleWalletKeyConstraint';
 export * from './dtos/requests/RetailAddressInput';
 export * from './dtos/requests/CreateRetailerRequest';
 export * from './dtos/requests/UpdateRetailerRequest';
@@ -34,6 +36,8 @@ export * from './dtos/requests/ProvisionRetailUserRequest';
 export * from './dtos/requests/UpdateRetailUserRequest';
 export * from './dtos/requests/ChangeRetailUserStatusRequest';
 export * from './dtos/requests/TransferRetailUserRequest';
+export * from './dtos/requests/LookupRetailUserWalletRequest';
+export * from './dtos/requests/LinkRetailUserWalletRequest';
 export * from './dtos/requests/GoalListQuery';
 export * from './dtos/requests/GoalUpsertRequest';
 export * from './dtos/requests/GoalPathParams';
@@ -46,3 +50,5 @@ export * from './dtos/responses/GoalUpsertResponse';
 export * from './dtos/responses/PrivateGoalListResponse';
 export * from './dtos/responses/StoreKpiResponse';
 export * from './dtos/responses/SellerKpiResponse';
+export * from './dtos/responses/LookupRetailUserWalletResponse';
+export * from './dtos/responses/PrivateRetailUserWalletResponse';

package/bin/retailOrg/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./enums/StoreStatusEnum"), exports);
 __exportStar(require("./enums/RetailUserStatusEnum"), exports);
 __exportStar(require("./enums/EmploymentTypeEnum"), exports);
 __exportStar(require("./enums/CollectorSeniorityEnum"), exports);
+__exportStar(require("./enums/RetailUserWalletLinkMethodEnum"), exports);
 // F3 — Portal Admin VentasLuga (metas de venta del periodo)
 __exportStar(require("./enums/GoalTargetTypeEnum"), exports);
 // Entity DTOs
@@ -38,6 +39,8 @@ __exportStar(require("./dtos/validation/CollectorValidationDto"), exports);
 __exportStar(require("./dtos/validation/PrivateSellerListResponse"), exports);
 // Paginación genérica
 __exportStar(require("./dtos/PaginatedResult"), exports);
+// Validadores
+__exportStar(require("./validators/IsSingleWalletKeyConstraint"), exports);
 // Request DTOs (input validado por endpoint)
 __exportStar(require("./dtos/requests/RetailAddressInput"), exports);
 __exportStar(require("./dtos/requests/CreateRetailerRequest"), exports);
@@ -55,6 +58,8 @@ __exportStar(require("./dtos/requests/ProvisionRetailUserRequest"), exports);
 __exportStar(require("./dtos/requests/UpdateRetailUserRequest"), exports);
 __exportStar(require("./dtos/requests/ChangeRetailUserStatusRequest"), exports);
 __exportStar(require("./dtos/requests/TransferRetailUserRequest"), exports);
+__exportStar(require("./dtos/requests/LookupRetailUserWalletRequest"), exports);
+__exportStar(require("./dtos/requests/LinkRetailUserWalletRequest"), exports);
 // F3 — metas y KPIs del Portal Admin VL
 __exportStar(require("./dtos/requests/GoalListQuery"), exports);
 __exportStar(require("./dtos/requests/GoalUpsertRequest"), exports);
@@ -69,3 +74,5 @@ __exportStar(require("./dtos/responses/GoalUpsertResponse"), exports);
 __exportStar(require("./dtos/responses/PrivateGoalListResponse"), exports);
 __exportStar(require("./dtos/responses/StoreKpiResponse"), exports);
 __exportStar(require("./dtos/responses/SellerKpiResponse"), exports);
+__exportStar(require("./dtos/responses/LookupRetailUserWalletResponse"), exports);
+__exportStar(require("./dtos/responses/PrivateRetailUserWalletResponse"), exports);

package/bin/retailOrg/validators/IsSingleWalletKeyConstraint.d.ts

@@ -0,0 +1,6 @@
+import { type ValidationArguments, type ValidatorConstraintInterface } from 'class-validator';
+/** Exige exactamente uno de `clabe` o `phone`. */
+export declare class IsSingleWalletKeyConstraint implements ValidatorConstraintInterface {
+    validate(_value: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/retailOrg/validators/IsSingleWalletKeyConstraint.js

@@ -0,0 +1,24 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsSingleWalletKeyConstraint = void 0;
+const class_validator_1 = require("class-validator");
+/** Exige exactamente uno de `clabe` o `phone`. */
+let IsSingleWalletKeyConstraint = class IsSingleWalletKeyConstraint {
+    validate(_value, args) {
+        const o = args.object;
+        return (o.clabe != null) !== (o.phone != null);
+    }
+    defaultMessage() {
+        return 'debe venir clabe o phone, solo uno';
+    }
+};
+exports.IsSingleWalletKeyConstraint = IsSingleWalletKeyConstraint;
+exports.IsSingleWalletKeyConstraint = IsSingleWalletKeyConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isSingleWalletKey', async: false })
+], IsSingleWalletKeyConstraint);