@fiado/type-kit 3.664.0 → 3.665.0

package/_test_/unit/transferNote/transferNoteConfigAndPrivate.test.ts

@@ -268,3 +268,17 @@ describe('cambio de configuración con doble control', () => {
         expect(pendingChange.concept?.sign).toBe(TransferNoteConceptSignEnum.NEGATIVE);
     });
 });
+
+describe('PrivateListTransferNotesQuery sin perspectiva', () => {
+    const caller = { tenantId: 't-1', author: 'fiado-dashboard', actorId: 'sub-1' };
+
+    it('no recibe los filtros que dependen de quién consulta', () => {
+        const dto = plainToInstance(
+            PrivateListTransferNotesQuery,
+            { ...caller, direction: 'INCOMING', counterpartyType: 'RETAILER', retailerId: 'r-1', issuedFrom: '2026-11-01', issuedTo: '2026-11-07', limit: '20' },
+            { excludeExtraneousValues: true },
+        );
+        expect(dto).toMatchObject({ ...caller, limit: 20 });
+        ['direction', 'counterpartyType', 'retailerId', 'issuedFrom', 'issuedTo'].forEach((key) => expect(dto).not.toHaveProperty(key));
+    });
+});

package/_test_/unit/transferNote/transferNoteRequests.test.ts

@@ -22,6 +22,8 @@ const {
     TransferNoteStatusEnum,
     TransferNoteItemStatusEnum,
     TransferNoteConceptEnum,
+    TransferNoteDirectionEnum,
+    TransferNotePartyTypeEnum,
 } = TransferNote;
 
 function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
@@ -155,3 +157,56 @@ describe('queries de listado', () => {
         );
     });
 });
+
+describe('filtros opcionales del listado de notas', () => {
+    const filters = {
+        counterpartyType: TransferNotePartyTypeEnum.RETAILER,
+        direction: TransferNoteDirectionEnum.INCOMING,
+        issuedFrom: '2026-11-01',
+        issuedTo: '2026-11-07',
+        retailerId: 'r-1',
+    };
+
+    it('acepta todos los filtros juntos y un rango de un solo día', () => {
+        expect(errorsOf(ListTransferNotesQuery, filters)).toEqual([]);
+        expect(errorsOf(ListTransferNotesQuery, { issuedFrom: '2026-11-01', issuedTo: '2026-11-01' })).toEqual([]);
+    });
+
+    it('expone los filtros en el DTO', () => {
+        expect(plainToInstance(ListTransferNotesQuery, filters, { excludeExtraneousValues: true })).toMatchObject(filters);
+    });
+
+    it('rechaza retailerId vacío', () => {
+        expect(errorsOf(ListTransferNotesQuery, { retailerId: '' })).toEqual(['retailerId']);
+    });
+
+    it('el enum de dirección solo tiene INCOMING y OUTGOING', () => {
+        expect(Object.values(TransferNoteDirectionEnum)).toEqual(['INCOMING', 'OUTGOING']);
+    });
+
+    it('rechaza valores fuera de catálogo', () => {
+        expect(errorsOf(ListTransferNotesQuery, { counterpartyType: 'BANK', direction: 'SIDEWAYS' })).toEqual(
+            expect.arrayContaining(['counterpartyType', 'direction']),
+        );
+    });
+
+    it.each(['2026-11-1', '2026-02-30', '2026-11-01T00:00:00Z', 'ayer'])('rechaza el día %s', (day) => {
+        expect(errorsOf(ListTransferNotesQuery, { issuedFrom: day })).toContain('issuedFrom');
+        expect(errorsOf(ListTransferNotesQuery, { issuedTo: day })).toContain('issuedTo');
+    });
+
+    it('rechaza issuedFrom posterior a issuedTo', () => {
+        expect(errorsOf(ListTransferNotesQuery, { issuedFrom: '2026-11-08', issuedTo: '2026-11-07' })).toEqual(['issuedTo']);
+    });
+
+    it('acepta cualquiera de los extremos sin el otro', () => {
+        expect(errorsOf(ListTransferNotesQuery, { issuedFrom: '2026-11-08' })).toEqual([]);
+        expect(errorsOf(ListTransferNotesQuery, { issuedTo: '2026-11-08' })).toEqual([]);
+    });
+
+    it('la ruta del retailer hereda los filtros, salvo retailerId porque manda el path', () => {
+        const dto = plainToInstance(ListRetailerTransferNotesQuery, filters, { excludeExtraneousValues: true });
+        expect(dto).toMatchObject({ direction: filters.direction, counterpartyType: filters.counterpartyType, issuedFrom: filters.issuedFrom, issuedTo: filters.issuedTo });
+        expect(dto).not.toHaveProperty('retailerId');
+    });
+});

package/bin/transferNote/constants/transferNoteValidation.d.ts

@@ -2,6 +2,8 @@
 export declare const TRANSFER_NOTE_MIN_REASON_LENGTH = 20;
 /** Semana ISO `YYYY-Www`, p. ej. `2026-W43`. */
 export declare const TRANSFER_NOTE_ISO_WEEK_PATTERN: RegExp;
+/** Día calendario `YYYY-MM-DD`. */
+export declare const TRANSFER_NOTE_DAY_PATTERN: RegExp;
 /** CLABE interbancaria de 18 dígitos. */
 export declare const TRANSFER_NOTE_CLABE_PATTERN: RegExp;
 export declare const TRANSFER_NOTE_MAX_PAGE_SIZE = 100;

package/bin/transferNote/constants/transferNoteValidation.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH = exports.TRANSFER_NOTE_MAX_PAGE_SIZE = exports.TRANSFER_NOTE_CLABE_PATTERN = exports.TRANSFER_NOTE_ISO_WEEK_PATTERN = exports.TRANSFER_NOTE_MIN_REASON_LENGTH = void 0;
+exports.TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH = exports.TRANSFER_NOTE_MAX_PAGE_SIZE = exports.TRANSFER_NOTE_CLABE_PATTERN = exports.TRANSFER_NOTE_DAY_PATTERN = exports.TRANSFER_NOTE_ISO_WEEK_PATTERN = exports.TRANSFER_NOTE_MIN_REASON_LENGTH = void 0;
 /** Largo mínimo de la razón de una emisión manual y de una objeción. */
 exports.TRANSFER_NOTE_MIN_REASON_LENGTH = 20;
 /** Semana ISO `YYYY-Www`, p. ej. `2026-W43`. */
 exports.TRANSFER_NOTE_ISO_WEEK_PATTERN = /^\d{4}-W(0[1-9]|[1-4]\d|5[0-3])$/;
+/** Día calendario `YYYY-MM-DD`. */
+exports.TRANSFER_NOTE_DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
 /** CLABE interbancaria de 18 dígitos. */
 exports.TRANSFER_NOTE_CLABE_PATTERN = /^\d{18}$/;
 exports.TRANSFER_NOTE_MAX_PAGE_SIZE = 100;

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

@@ -1,6 +1,6 @@
 import { TransferNoteConceptEnum } from '../../enums/TransferNoteConceptEnum';
 import { CancelTransferNoteRequest, CaptureTransferNoteSpeiRequest, IssueTransferNoteRequest, PreviewTransferNoteRequest, ResolveTransferNoteDisputeRequest, RevertTransferNoteSpeiRequest } from './TransferNoteActionRequests';
-import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListTransferNotesQuery } from './TransferNoteQueries';
+import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListTransferNotesBaseQuery } from './TransferNoteQueries';
 /** Tenant y servicio que llama; el lambda valida `author` contra su lista permitida. */
 export declare class PrivateTransferNoteCaller {
     tenantId: string;
@@ -89,7 +89,7 @@ export declare class PrivateGetTransferNoteHistoryQuery extends PrivateTransferN
 export declare class PrivateGetTransferNotePdfQuery extends PrivateTransferNoteOperatorCaller {
 }
 /** Query de privateListTransferNotes. */
-export declare class PrivateListTransferNotesQuery extends ListTransferNotesQuery {
+export declare class PrivateListTransferNotesQuery extends ListTransferNotesBaseQuery {
     tenantId: string;
     author: string;
     /** `sub` de Azure AD del operador del dashboard. */

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

@@ -190,7 +190,7 @@ class PrivateGetTransferNotePdfQuery extends PrivateTransferNoteOperatorCaller {
 }
 exports.PrivateGetTransferNotePdfQuery = PrivateGetTransferNotePdfQuery;
 /** Query de privateListTransferNotes. */
-class PrivateListTransferNotesQuery extends TransferNoteQueries_1.ListTransferNotesQuery {
+class PrivateListTransferNotesQuery extends TransferNoteQueries_1.ListTransferNotesBaseQuery {
 }
 exports.PrivateListTransferNotesQuery = PrivateListTransferNotesQuery;
 __decorate([

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

@@ -1,8 +1,8 @@
 import { TransferNoteDisputeCategoryEnum } from '../../enums/TransferNoteDisputeCategoryEnum';
 import { CaptureTransferNoteSpeiRequest } from './TransferNoteActionRequests';
-import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListTransferNotesQuery } from './TransferNoteQueries';
+import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListViewerTransferNotesQuery } from './TransferNoteQueries';
 /** Query de publicListRetailerTransferNotes; el retailer va en la ruta. */
-export declare class ListRetailerTransferNotesQuery extends ListTransferNotesQuery {
+export declare class ListRetailerTransferNotesQuery extends ListViewerTransferNotesQuery {
 }
 /** Query de publicListRetailerTransferNotePool. */
 export declare class ListRetailerTransferNotePoolQuery extends ListTransferNotePoolQuery {

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

@@ -17,7 +17,7 @@ const TransferNoteActionRequests_1 = require("./TransferNoteActionRequests");
 const TransferNoteQueries_1 = require("./TransferNoteQueries");
 const transferNoteRequestDecorators_1 = require("./transferNoteRequestDecorators");
 /** Query de publicListRetailerTransferNotes; el retailer va en la ruta. */
-class ListRetailerTransferNotesQuery extends TransferNoteQueries_1.ListTransferNotesQuery {
+class ListRetailerTransferNotesQuery extends TransferNoteQueries_1.ListViewerTransferNotesQuery {
 }
 exports.ListRetailerTransferNotesQuery = ListRetailerTransferNotesQuery;
 /** Query de publicListRetailerTransferNotePool. */

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

@@ -1,9 +1,11 @@
 import { TransferNoteConceptEnum } from '../../enums/TransferNoteConceptEnum';
+import { TransferNoteDirectionEnum } from '../../enums/TransferNoteDirectionEnum';
 import { TransferNoteIssueOriginEnum } from '../../enums/TransferNoteIssueOriginEnum';
 import { TransferNoteItemStatusEnum } from '../../enums/TransferNoteItemStatusEnum';
+import { TransferNotePartyTypeEnum } from '../../enums/TransferNotePartyTypeEnum';
 import { TransferNoteStatusEnum } from '../../enums/TransferNoteStatusEnum';
-/** Query de publicListTransferNotes. */
-export declare class ListTransferNotesQuery {
+/** Filtros de la lista que no dependen de quién consulta; también los recibe la ruta privada. */
+export declare class ListTransferNotesBaseQuery {
     status?: TransferNoteStatusEnum;
     pairKey?: string;
     isoWeek?: string;
@@ -11,6 +13,21 @@ export declare class ListTransferNotesQuery {
     limit?: number;
     nextToken?: string;
 }
+/** Filtros de la lista vista desde una parte de la nota. */
+export declare class ListViewerTransferNotesQuery extends ListTransferNotesBaseQuery {
+    /** La otra parte de la nota, vista desde quien consulta. */
+    counterpartyType?: TransferNotePartyTypeEnum;
+    direction?: TransferNoteDirectionEnum;
+    /** Primer día de `issuedAt`, inclusivo, en hora de Ciudad de México. */
+    issuedFrom?: string;
+    /** Último día de `issuedAt`, inclusivo, en hora de Ciudad de México. */
+    issuedTo?: string;
+}
+/** Query de publicListTransferNotes. */
+export declare class ListTransferNotesQuery extends ListViewerTransferNotesQuery {
+    /** Deja las notas donde este retailer es pagador o receptor. */
+    retailerId?: string;
+}
 /** Query de publicListTransferNotePool: items por par, estado, concepto y fecha. */
 export declare class ListTransferNotePoolQuery {
     pairKey?: string;

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

@@ -9,48 +9,86 @@ 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.ListTransferNoteItemsQuery = exports.ListTransferNotePoolQuery = exports.ListTransferNotesQuery = void 0;
+exports.ListTransferNoteItemsQuery = exports.ListTransferNotePoolQuery = exports.ListTransferNotesQuery = exports.ListViewerTransferNotesQuery = exports.ListTransferNotesBaseQuery = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const TransferNoteConceptEnum_1 = require("../../enums/TransferNoteConceptEnum");
+const TransferNoteDirectionEnum_1 = require("../../enums/TransferNoteDirectionEnum");
 const TransferNoteIssueOriginEnum_1 = require("../../enums/TransferNoteIssueOriginEnum");
 const TransferNoteItemStatusEnum_1 = require("../../enums/TransferNoteItemStatusEnum");
+const TransferNotePartyTypeEnum_1 = require("../../enums/TransferNotePartyTypeEnum");
 const TransferNoteStatusEnum_1 = require("../../enums/TransferNoteStatusEnum");
 const transferNoteRequestDecorators_1 = require("./transferNoteRequestDecorators");
-/** Query de publicListTransferNotes. */
-class ListTransferNotesQuery {
+/** Filtros de la lista que no dependen de quién consulta; también los recibe la ruta privada. */
+class ListTransferNotesBaseQuery {
 }
-exports.ListTransferNotesQuery = ListTransferNotesQuery;
+exports.ListTransferNotesBaseQuery = ListTransferNotesBaseQuery;
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsEnum)(TransferNoteStatusEnum_1.TransferNoteStatusEnum),
     __metadata("design:type", String)
-], ListTransferNotesQuery.prototype, "status", void 0);
+], ListTransferNotesBaseQuery.prototype, "status", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
-], ListTransferNotesQuery.prototype, "pairKey", void 0);
+], ListTransferNotesBaseQuery.prototype, "pairKey", void 0);
 __decorate([
     (0, transferNoteRequestDecorators_1.OptionalIsoWeek)(),
     __metadata("design:type", String)
-], ListTransferNotesQuery.prototype, "isoWeek", void 0);
+], ListTransferNotesBaseQuery.prototype, "isoWeek", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsEnum)(TransferNoteIssueOriginEnum_1.TransferNoteIssueOriginEnum),
     __metadata("design:type", String)
-], ListTransferNotesQuery.prototype, "issueOrigin", void 0);
+], ListTransferNotesBaseQuery.prototype, "issueOrigin", void 0);
 __decorate([
     (0, transferNoteRequestDecorators_1.PageLimit)(),
     __metadata("design:type", Number)
-], ListTransferNotesQuery.prototype, "limit", void 0);
+], ListTransferNotesBaseQuery.prototype, "limit", void 0);
 __decorate([
     (0, transferNoteRequestDecorators_1.PageToken)(),
     __metadata("design:type", String)
-], ListTransferNotesQuery.prototype, "nextToken", void 0);
+], ListTransferNotesBaseQuery.prototype, "nextToken", void 0);
+/** Filtros de la lista vista desde una parte de la nota. */
+class ListViewerTransferNotesQuery extends ListTransferNotesBaseQuery {
+}
+exports.ListViewerTransferNotesQuery = ListViewerTransferNotesQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(TransferNotePartyTypeEnum_1.TransferNotePartyTypeEnum),
+    __metadata("design:type", String)
+], ListViewerTransferNotesQuery.prototype, "counterpartyType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(TransferNoteDirectionEnum_1.TransferNoteDirectionEnum),
+    __metadata("design:type", String)
+], ListViewerTransferNotesQuery.prototype, "direction", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalDay)(),
+    __metadata("design:type", String)
+], ListViewerTransferNotesQuery.prototype, "issuedFrom", void 0);
+__decorate([
+    (0, transferNoteRequestDecorators_1.OptionalDay)(),
+    (0, transferNoteRequestDecorators_1.NotBeforeDay)('issuedFrom'),
+    __metadata("design:type", String)
+], ListViewerTransferNotesQuery.prototype, "issuedTo", void 0);
+/** Query de publicListTransferNotes. */
+class ListTransferNotesQuery extends ListViewerTransferNotesQuery {
+}
+exports.ListTransferNotesQuery = ListTransferNotesQuery;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ListTransferNotesQuery.prototype, "retailerId", void 0);
 /** Query de publicListTransferNotePool: items por par, estado, concepto y fecha. */
 class ListTransferNotePoolQuery {
 }

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

@@ -12,6 +12,10 @@ export declare function OptionalEmail(): PropertyDecorator;
 export declare function RequiredActorId(): PropertyDecorator;
 /** Semana ISO opcional `YYYY-Www`. */
 export declare function OptionalIsoWeek(): PropertyDecorator;
+/** Día opcional `YYYY-MM-DD` que exista en el calendario. */
+export declare function OptionalDay(): PropertyDecorator;
+/** El día no puede ser anterior al de `startField`, si ese viene. */
+export declare function NotBeforeDay(startField: string): PropertyDecorator;
 /** Tamaño de página opcional, 1 a 100, llega como string en el query. */
 export declare function PageLimit(): PropertyDecorator;
 /** Cursor opcional de paginación. */

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

@@ -7,6 +7,8 @@ exports.RequiredEmail = RequiredEmail;
 exports.OptionalEmail = OptionalEmail;
 exports.RequiredActorId = RequiredActorId;
 exports.OptionalIsoWeek = OptionalIsoWeek;
+exports.OptionalDay = OptionalDay;
+exports.NotBeforeDay = NotBeforeDay;
 exports.PageLimit = PageLimit;
 exports.PageToken = PageToken;
 const class_transformer_1 = require("class-transformer");
@@ -78,6 +80,28 @@ function OptionalIsoWeek() {
         (0, class_validator_1.Matches)(transferNoteValidation_1.TRANSFER_NOTE_ISO_WEEK_PATTERN)(target, key);
     };
 }
+/** Día opcional `YYYY-MM-DD` que exista en el calendario. */
+function OptionalDay() {
+    return (target, key) => {
+        (0, class_transformer_1.Expose)()(target, key);
+        (0, class_validator_1.IsOptional)()(target, key);
+        (0, class_validator_1.Matches)(transferNoteValidation_1.TRANSFER_NOTE_DAY_PATTERN)(target, key);
+        (0, class_validator_1.IsISO8601)({ strict: true })(target, key);
+    };
+}
+/** El día no puede ser anterior al de `startField`, si ese viene. */
+function NotBeforeDay(startField) {
+    return (0, class_validator_1.ValidateBy)({
+        name: 'notBeforeDay',
+        validator: {
+            validate: (value, args) => {
+                const start = (args?.object)[startField];
+                return typeof start !== 'string' || typeof value !== 'string' || start <= value;
+            },
+            defaultMessage: () => `$property no puede ser anterior a ${startField}`,
+        },
+    });
+}
 /** Tamaño de página opcional, 1 a 100, llega como string en el query. */
 function PageLimit() {
     return (target, key) => {

package/bin/transferNote/enums/TransferNoteDirectionEnum.d.ts

@@ -0,0 +1,5 @@
+/** Sentido de la nota visto desde quien consulta: INCOMING si es el receptor, OUTGOING si es el pagador. */
+export declare enum TransferNoteDirectionEnum {
+    INCOMING = "INCOMING",
+    OUTGOING = "OUTGOING"
+}

package/bin/transferNote/enums/TransferNoteDirectionEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferNoteDirectionEnum = void 0;
+/** Sentido de la nota visto desde quien consulta: INCOMING si es el receptor, OUTGOING si es el pagador. */
+var TransferNoteDirectionEnum;
+(function (TransferNoteDirectionEnum) {
+    TransferNoteDirectionEnum["INCOMING"] = "INCOMING";
+    TransferNoteDirectionEnum["OUTGOING"] = "OUTGOING";
+})(TransferNoteDirectionEnum || (exports.TransferNoteDirectionEnum = TransferNoteDirectionEnum = {}));

package/bin/transferNote/index.d.ts

@@ -3,6 +3,7 @@ export * from './enums/TransferNoteItemStatusEnum';
 export * from './enums/TransferNoteConceptEnum';
 export * from './enums/TransferNoteConceptSignEnum';
 export * from './enums/TransferNotePartyTypeEnum';
+export * from './enums/TransferNoteDirectionEnum';
 export * from './enums/TransferNoteDisputeCategoryEnum';
 export * from './enums/TransferNoteDisputeDecisionEnum';
 export * from './enums/TransferNoteIssueOriginEnum';

package/bin/transferNote/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./enums/TransferNoteItemStatusEnum"), exports);
 __exportStar(require("./enums/TransferNoteConceptEnum"), exports);
 __exportStar(require("./enums/TransferNoteConceptSignEnum"), exports);
 __exportStar(require("./enums/TransferNotePartyTypeEnum"), exports);
+__exportStar(require("./enums/TransferNoteDirectionEnum"), exports);
 __exportStar(require("./enums/TransferNoteDisputeCategoryEnum"), exports);
 __exportStar(require("./enums/TransferNoteDisputeDecisionEnum"), exports);
 __exportStar(require("./enums/TransferNoteIssueOriginEnum"), exports);

package/package.json

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

package/src/transferNote/constants/transferNoteValidation.ts

@@ -4,6 +4,9 @@ export const TRANSFER_NOTE_MIN_REASON_LENGTH = 20;
 /** Semana ISO `YYYY-Www`, p. ej. `2026-W43`. */
 export const TRANSFER_NOTE_ISO_WEEK_PATTERN = /^\d{4}-W(0[1-9]|[1-4]\d|5[0-3])$/;
 
+/** Día calendario `YYYY-MM-DD`. */
+export const TRANSFER_NOTE_DAY_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+
 /** CLABE interbancaria de 18 dígitos. */
 export const TRANSFER_NOTE_CLABE_PATTERN = /^\d{18}$/;
 

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

@@ -10,7 +10,7 @@ import {
     ResolveTransferNoteDisputeRequest,
     RevertTransferNoteSpeiRequest,
 } from './TransferNoteActionRequests';
-import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListTransferNotesQuery } from './TransferNoteQueries';
+import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListTransferNotesBaseQuery } from './TransferNoteQueries';
 import { OptionalEmail, RequiredActorId, RequiredId, RequiredReason } from './transferNoteRequestDecorators';
 
 /** Tenant y servicio que llama; el lambda valida `author` contra su lista permitida. */
@@ -157,7 +157,7 @@ export class PrivateGetTransferNoteHistoryQuery extends PrivateTransferNoteOpera
 export class PrivateGetTransferNotePdfQuery extends PrivateTransferNoteOperatorCaller {}
 
 /** Query de privateListTransferNotes. */
-export class PrivateListTransferNotesQuery extends ListTransferNotesQuery {
+export class PrivateListTransferNotesQuery extends ListTransferNotesBaseQuery {
     @RequiredId()
     tenantId!: string;
 

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

@@ -2,11 +2,11 @@ import { Expose } from 'class-transformer';
 import { IsEnum } from 'class-validator';
 import { TransferNoteDisputeCategoryEnum } from '../../enums/TransferNoteDisputeCategoryEnum';
 import { CaptureTransferNoteSpeiRequest } from './TransferNoteActionRequests';
-import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListTransferNotesQuery } from './TransferNoteQueries';
+import { ListTransferNoteItemsQuery, ListTransferNotePoolQuery, ListViewerTransferNotesQuery } from './TransferNoteQueries';
 import { LongReason } from './transferNoteRequestDecorators';
 
 /** Query de publicListRetailerTransferNotes; el retailer va en la ruta. */
-export class ListRetailerTransferNotesQuery extends ListTransferNotesQuery {}
+export class ListRetailerTransferNotesQuery extends ListViewerTransferNotesQuery {}
 
 /** Query de publicListRetailerTransferNotePool. */
 export class ListRetailerTransferNotePoolQuery extends ListTransferNotePoolQuery {}

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

@@ -1,13 +1,15 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsISO8601, IsOptional, IsString } from 'class-validator';
+import { IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString } from 'class-validator';
 import { TransferNoteConceptEnum } from '../../enums/TransferNoteConceptEnum';
+import { TransferNoteDirectionEnum } from '../../enums/TransferNoteDirectionEnum';
 import { TransferNoteIssueOriginEnum } from '../../enums/TransferNoteIssueOriginEnum';
 import { TransferNoteItemStatusEnum } from '../../enums/TransferNoteItemStatusEnum';
+import { TransferNotePartyTypeEnum } from '../../enums/TransferNotePartyTypeEnum';
 import { TransferNoteStatusEnum } from '../../enums/TransferNoteStatusEnum';
-import { OptionalIsoWeek, PageLimit, PageToken } from './transferNoteRequestDecorators';
+import { NotBeforeDay, OptionalDay, OptionalIsoWeek, PageLimit, PageToken } from './transferNoteRequestDecorators';
 
-/** Query de publicListTransferNotes. */
-export class ListTransferNotesQuery {
+/** Filtros de la lista que no dependen de quién consulta; también los recibe la ruta privada. */
+export class ListTransferNotesBaseQuery {
     @Expose()
     @IsOptional()
     @IsEnum(TransferNoteStatusEnum)
@@ -33,6 +35,39 @@ export class ListTransferNotesQuery {
     nextToken?: string;
 }
 
+/** Filtros de la lista vista desde una parte de la nota. */
+export class ListViewerTransferNotesQuery extends ListTransferNotesBaseQuery {
+    /** La otra parte de la nota, vista desde quien consulta. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(TransferNotePartyTypeEnum)
+    counterpartyType?: TransferNotePartyTypeEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsEnum(TransferNoteDirectionEnum)
+    direction?: TransferNoteDirectionEnum;
+
+    /** Primer día de `issuedAt`, inclusivo, en hora de Ciudad de México. */
+    @OptionalDay()
+    issuedFrom?: string;
+
+    /** Último día de `issuedAt`, inclusivo, en hora de Ciudad de México. */
+    @OptionalDay()
+    @NotBeforeDay('issuedFrom')
+    issuedTo?: string;
+}
+
+/** Query de publicListTransferNotes. */
+export class ListTransferNotesQuery extends ListViewerTransferNotesQuery {
+    /** Deja las notas donde este retailer es pagador o receptor. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    retailerId?: string;
+}
+
 /** Query de publicListTransferNotePool: items por par, estado, concepto y fecha. */
 export class ListTransferNotePoolQuery {
     @Expose()

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

@@ -1,7 +1,8 @@
 import { Expose, Transform, Type } from 'class-transformer';
-import { IsEmail, IsInt, IsNotEmpty, IsOptional, IsString, Matches, Max, MaxLength, Min, MinLength, ValidateBy, isEmail } from 'class-validator';
+import { IsEmail, IsISO8601, IsInt, IsNotEmpty, IsOptional, IsString, Matches, Max, MaxLength, Min, MinLength, ValidateBy, isEmail } from 'class-validator';
 import {
     TRANSFER_NOTE_ACTOR_ID_MAX_LENGTH,
+    TRANSFER_NOTE_DAY_PATTERN,
     TRANSFER_NOTE_ISO_WEEK_PATTERN,
     TRANSFER_NOTE_MAX_PAGE_SIZE,
     TRANSFER_NOTE_MIN_REASON_LENGTH,
@@ -81,6 +82,30 @@ export function OptionalIsoWeek(): PropertyDecorator {
     };
 }
 
+/** Día opcional `YYYY-MM-DD` que exista en el calendario. */
+export function OptionalDay(): PropertyDecorator {
+    return (target, key) => {
+        Expose()(target, key);
+        IsOptional()(target, key);
+        Matches(TRANSFER_NOTE_DAY_PATTERN)(target, key);
+        IsISO8601({ strict: true })(target, key);
+    };
+}
+
+/** El día no puede ser anterior al de `startField`, si ese viene. */
+export function NotBeforeDay(startField: string): PropertyDecorator {
+    return ValidateBy({
+        name: 'notBeforeDay',
+        validator: {
+            validate: (value, args) => {
+                const start = (args?.object as Record<string, unknown>)[startField];
+                return typeof start !== 'string' || typeof value !== 'string' || start <= value;
+            },
+            defaultMessage: () => `$property no puede ser anterior a ${startField}`,
+        },
+    });
+}
+
 /** Tamaño de página opcional, 1 a 100, llega como string en el query. */
 export function PageLimit(): PropertyDecorator {
     return (target, key) => {

package/src/transferNote/enums/TransferNoteDirectionEnum.ts

@@ -0,0 +1,5 @@
+/** Sentido de la nota visto desde quien consulta: INCOMING si es el receptor, OUTGOING si es el pagador. */
+export enum TransferNoteDirectionEnum {
+    INCOMING = 'INCOMING',
+    OUTGOING = 'OUTGOING',
+}

package/src/transferNote/index.ts

@@ -4,6 +4,7 @@ export * from './enums/TransferNoteItemStatusEnum';
 export * from './enums/TransferNoteConceptEnum';
 export * from './enums/TransferNoteConceptSignEnum';
 export * from './enums/TransferNotePartyTypeEnum';
+export * from './enums/TransferNoteDirectionEnum';
 export * from './enums/TransferNoteDisputeCategoryEnum';
 export * from './enums/TransferNoteDisputeDecisionEnum';
 export * from './enums/TransferNoteIssueOriginEnum';