@fiado/type-kit 3.658.0 → 3.660.0

package/_test_/unit/retailOrg/dtos/RetailUser.test.ts

@@ -107,6 +107,7 @@ describe('RetailUser — wallet PCF', () => {
             pcfAccountId: null,
             walletLinkMethod: null,
             walletClabeLast4: null,
+            walletPhoneLast4: null,
             walletLinkedAt: null,
             walletLinkedBy: null,
         };
@@ -124,6 +125,17 @@ describe('RetailUser — wallet PCF', () => {
         expect(errors.some(e => e.property === 'walletClabeLast4')).toBe(true);
     });
 
+    it('valida la wallet vinculada por teléfono con sus últimos 4', async () => {
+        const byPhone = { ...linked, walletLinkMethod: RetailUserWalletLinkMethodEnum.PHONE, walletClabeLast4: null, walletPhoneLast4: '9900' };
+        const errors = await validate(plainToInstance(RetailUser, byPhone));
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si walletPhoneLast4 trae el teléfono completo', async () => {
+        const errors = await validate(plainToInstance(RetailUser, { ...linked, walletPhoneLast4: '5512345678' }));
+        expect(errors.some(e => e.property === 'walletPhoneLast4')).toBe(true);
+    });
+
     it('falla si walletLinkedAt no es ISO 8601', async () => {
         const errors = await validate(plainToInstance(RetailUser, { ...linked, walletLinkedAt: '20/10/2026' }));
         expect(errors.some(e => e.property === 'walletLinkedAt')).toBe(true);

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

@@ -37,6 +37,8 @@ export declare class RetailUser {
     walletLinkMethod?: RetailUserWalletLinkMethodEnum | null;
     /** Últimos 4 dígitos de la CLABE; la CLABE completa no se guarda. */
     walletClabeLast4?: string | null;
+    /** Últimos 4 dígitos del teléfono con que se buscó la wallet; el teléfono completo no se guarda. */
+    walletPhoneLast4?: string | null;
     /** Cuándo se vinculó (ISO). */
     walletLinkedAt?: string | null;
     /** Quién la vinculó: el actorId del usuario del back office. */

package/bin/retailOrg/dtos/RetailUser.js

@@ -115,6 +115,13 @@ __decorate([
     (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)(/^\d{4}$/, { message: 'walletPhoneLast4 debe tener 4 dígitos' }),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletPhoneLast4", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/transferNote/dtos/requests/PrivateTransferNoteRequests.d.ts

@@ -119,6 +119,16 @@ export declare class PrivateListTransferNoteItemsQuery extends ListTransferNoteI
 export declare class PrivateRunTransferNoteCutoffRequest extends PrivateTransferNoteCaller {
     isoWeek: string;
 }
+/**
+ * Body de privatePullTransferNotePool: trae al pool todo lo pendiente de los feeds hasta ahora,
+ * sin exigir semana cerrada ni emitir notas. Corre síncrono; idempotente por los candados SOURCE
+ * existentes (un registro ya tomado se cuenta como `duplicates`, no se repite).
+ *
+ * Reusa la lógica de `poolConcepts` del corte; el corte semanal queda intacto como red de seguridad.
+ * Lo llama el operador del dashboard para ver cobros nuevos sin esperar al lunes 00:01 CDMX.
+ */
+export declare class PrivatePullTransferNotePoolRequest extends PrivateTransferNoteOperatorCaller {
+}
 /** Body de privateCreateTransferNoteAdjustment; un `adjustmentKey` repetido devuelve el primer ajuste. */
 export declare class PrivateCreateTransferNoteAdjustmentRequest extends PrivateTransferNoteCaller {
     adjustmentKey: string;

package/bin/transferNote/dtos/requests/PrivateTransferNoteRequests.js

@@ -9,7 +9,7 @@ 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.PrivateGetTransferNoteItemBySourceQuery = exports.PrivateCreateTransferNoteAdjustmentRequest = exports.PrivateRunTransferNoteCutoffRequest = exports.PrivateListTransferNoteItemsQuery = exports.PrivateListTransferNotePoolQuery = exports.PrivateListTransferNotesQuery = exports.PrivateGetTransferNotePdfQuery = exports.PrivateGetTransferNoteHistoryQuery = exports.PrivateGetTransferNoteQuery = exports.PrivateConfirmTransferNoteSettlementRequest = exports.PrivateCreateSpeiReceiptUploadUrlRequest = exports.PrivateSendTransferNoteNoticeRequest = exports.PrivateConfirmTransferNoteReceptionRequest = exports.PrivateResolveTransferNoteDisputeRequest = exports.PrivateCancelTransferNoteRequest = exports.PrivateRevertTransferNoteSpeiRequest = exports.PrivateCaptureTransferNoteSpeiRequest = exports.PrivateIssueTransferNoteRequest = exports.PrivatePreviewTransferNoteRequest = exports.PrivateTransferNoteOperatorCaller = exports.PrivateTransferNoteCaller = void 0;
+exports.PrivateGetTransferNoteItemBySourceQuery = exports.PrivateCreateTransferNoteAdjustmentRequest = exports.PrivatePullTransferNotePoolRequest = exports.PrivateRunTransferNoteCutoffRequest = exports.PrivateListTransferNoteItemsQuery = exports.PrivateListTransferNotePoolQuery = exports.PrivateListTransferNotesQuery = exports.PrivateGetTransferNotePdfQuery = exports.PrivateGetTransferNoteHistoryQuery = exports.PrivateGetTransferNoteQuery = exports.PrivateConfirmTransferNoteSettlementRequest = exports.PrivateCreateSpeiReceiptUploadUrlRequest = exports.PrivateSendTransferNoteNoticeRequest = exports.PrivateConfirmTransferNoteReceptionRequest = exports.PrivateResolveTransferNoteDisputeRequest = exports.PrivateCancelTransferNoteRequest = exports.PrivateRevertTransferNoteSpeiRequest = exports.PrivateCaptureTransferNoteSpeiRequest = exports.PrivateIssueTransferNoteRequest = exports.PrivatePreviewTransferNoteRequest = exports.PrivateTransferNoteOperatorCaller = exports.PrivateTransferNoteCaller = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const transferNoteValidation_1 = require("../../constants/transferNoteValidation");
@@ -258,6 +258,17 @@ __decorate([
     (0, class_validator_1.Matches)(transferNoteValidation_1.TRANSFER_NOTE_ISO_WEEK_PATTERN),
     __metadata("design:type", String)
 ], PrivateRunTransferNoteCutoffRequest.prototype, "isoWeek", void 0);
+/**
+ * Body de privatePullTransferNotePool: trae al pool todo lo pendiente de los feeds hasta ahora,
+ * sin exigir semana cerrada ni emitir notas. Corre síncrono; idempotente por los candados SOURCE
+ * existentes (un registro ya tomado se cuenta como `duplicates`, no se repite).
+ *
+ * Reusa la lógica de `poolConcepts` del corte; el corte semanal queda intacto como red de seguridad.
+ * Lo llama el operador del dashboard para ver cobros nuevos sin esperar al lunes 00:01 CDMX.
+ */
+class PrivatePullTransferNotePoolRequest extends PrivateTransferNoteOperatorCaller {
+}
+exports.PrivatePullTransferNotePoolRequest = PrivatePullTransferNotePoolRequest;
 /** Body de privateCreateTransferNoteAdjustment; un `adjustmentKey` repetido devuelve el primer ajuste. */
 class PrivateCreateTransferNoteAdjustmentRequest extends PrivateTransferNoteCaller {
 }

package/bin/transferNote/dtos/responses/PrivateTransferNoteResponses.d.ts

@@ -1,3 +1,4 @@
+import { TransferNoteConceptEnum } from '../../enums/TransferNoteConceptEnum';
 import { TransferNote } from '../TransferNote';
 import { TransferNoteItem } from '../TransferNoteItem';
 import { TransferNoteSignedUrl } from '../TransferNoteSignedUrl';
@@ -21,6 +22,28 @@ export type PrivateGetTransferNotePdfResponse = TransferNoteSignedUrl;
 export interface PrivateRunTransferNoteCutoffResponse {
     runId: string;
 }
+/**
+ * Resultado por concepto de llenar el pool: `pooled` entra nuevo, `duplicates` ya tomados por el
+ * candado SOURCE en una corrida previa, `skipped` records fuera del par o del alcance, `heldReversals`
+ * son reversas sin su original tomado (quedan para revisión, no entran como item negativo).
+ */
+export interface PrivatePullTransferNotePoolConceptResult {
+    concept: TransferNoteConceptEnum;
+    pooled: number;
+    duplicates: number;
+    skipped: number;
+    heldReversals: string[];
+}
+/**
+ * Respuesta 200 de privatePullTransferNotePool: resumen por concepto activo, más los conceptos cuyo
+ * feed falló y el timestamp hasta donde se leyó. Reintentable: los candados SOURCE evitan duplicados.
+ */
+export interface PrivatePullTransferNotePoolResponse {
+    tenantId: string;
+    pulledThrough: string;
+    perConcept: PrivatePullTransferNotePoolConceptResult[];
+    failedConcepts: TransferNoteConceptEnum[];
+}
 /** El item de ajuste; un `adjustmentKey` repetido devuelve el primero. */
 export type PrivateCreateTransferNoteAdjustmentResponse = TransferNoteItem;
 export type PrivateGetTransferNoteItemBySourceResponse = TransferNoteItem;

package/package.json

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

package/src/retailOrg/dtos/RetailUser.ts

@@ -100,6 +100,13 @@ export class RetailUser {
     @Matches(/^\d{4}$/, { message: 'walletClabeLast4 debe tener 4 dígitos' })
     walletClabeLast4?: string | null;
 
+    /** Últimos 4 dígitos del teléfono con que se buscó la wallet; el teléfono completo no se guarda. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(/^\d{4}$/, { message: 'walletPhoneLast4 debe tener 4 dígitos' })
+    walletPhoneLast4?: string | null;
+
     /** Cuándo se vinculó (ISO). */
     @Expose()
     @IsOptional()

package/src/transferNote/dtos/requests/PrivateTransferNoteRequests.ts

@@ -214,6 +214,16 @@ export class PrivateRunTransferNoteCutoffRequest extends PrivateTransferNoteCall
     isoWeek!: string;
 }
 
+/**
+ * Body de privatePullTransferNotePool: trae al pool todo lo pendiente de los feeds hasta ahora,
+ * sin exigir semana cerrada ni emitir notas. Corre síncrono; idempotente por los candados SOURCE
+ * existentes (un registro ya tomado se cuenta como `duplicates`, no se repite).
+ *
+ * Reusa la lógica de `poolConcepts` del corte; el corte semanal queda intacto como red de seguridad.
+ * Lo llama el operador del dashboard para ver cobros nuevos sin esperar al lunes 00:01 CDMX.
+ */
+export class PrivatePullTransferNotePoolRequest extends PrivateTransferNoteOperatorCaller {}
+
 /** Body de privateCreateTransferNoteAdjustment; un `adjustmentKey` repetido devuelve el primer ajuste. */
 export class PrivateCreateTransferNoteAdjustmentRequest extends PrivateTransferNoteCaller {
     @RequiredId()

package/src/transferNote/dtos/responses/PrivateTransferNoteResponses.ts

@@ -1,3 +1,4 @@
+import { TransferNoteConceptEnum } from '../../enums/TransferNoteConceptEnum';
 import { TransferNote } from '../TransferNote';
 import { TransferNoteItem } from '../TransferNoteItem';
 import { TransferNoteSignedUrl } from '../TransferNoteSignedUrl';
@@ -31,6 +32,30 @@ export interface PrivateRunTransferNoteCutoffResponse {
     runId: string;
 }
 
+/**
+ * Resultado por concepto de llenar el pool: `pooled` entra nuevo, `duplicates` ya tomados por el
+ * candado SOURCE en una corrida previa, `skipped` records fuera del par o del alcance, `heldReversals`
+ * son reversas sin su original tomado (quedan para revisión, no entran como item negativo).
+ */
+export interface PrivatePullTransferNotePoolConceptResult {
+    concept: TransferNoteConceptEnum;
+    pooled: number;
+    duplicates: number;
+    skipped: number;
+    heldReversals: string[];
+}
+
+/**
+ * Respuesta 200 de privatePullTransferNotePool: resumen por concepto activo, más los conceptos cuyo
+ * feed falló y el timestamp hasta donde se leyó. Reintentable: los candados SOURCE evitan duplicados.
+ */
+export interface PrivatePullTransferNotePoolResponse {
+    tenantId: string;
+    pulledThrough: string;
+    perConcept: PrivatePullTransferNotePoolConceptResult[];
+    failedConcepts: TransferNoteConceptEnum[];
+}
+
 /** El item de ajuste; un `adjustmentKey` repetido devuelve el primero. */
 export type PrivateCreateTransferNoteAdjustmentResponse = TransferNoteItem;
 export type PrivateGetTransferNoteItemBySourceResponse = TransferNoteItem;