@fiado/type-kit 3.624.0 → 3.626.0

package/_test_/unit/reconciliation/screenStateQuery.test.ts

@@ -0,0 +1,39 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import * as Reconciliation from '../../../src/reconciliation';
+
+const {
+    ListReconciliationItemsQuery,
+    PrivateListReconciliationItemsQuery,
+    ReconciliationItemStateEnum: S,
+    RECONCILIATION_SCREEN_ITEM_STATES,
+} = Reconciliation;
+
+function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
+    const dto = plainToInstance(cls, payload, { excludeExtraneousValues: true });
+    return validateSync(dto).map((e) => e.property);
+}
+
+const operator = { tenantId: 'surekeep', author: 'conciliacion-dashboard', actorId: 'aZ3x9Qk-azure-ad-sub_01' };
+
+describe('RECONCILIATION_SCREEN_ITEM_STATES', () => {
+    it('trae todos los estados menos TEST', () => {
+        expect(RECONCILIATION_SCREEN_ITEM_STATES).not.toContain(S.TEST);
+        expect([...RECONCILIATION_SCREEN_ITEM_STATES, S.TEST].sort()).toEqual(Object.values(S).sort());
+    });
+});
+
+describe('screenState en la lista de partidas', () => {
+    it.each([
+        [ListReconciliationItemsQuery, { definitionId: 'd1' }],
+        [PrivateListReconciliationItemsQuery, { definitionId: 'd1', ...operator }],
+    ])('%p acepta un estado de la matriz, rechaza TEST y es opcional', (cls, base) => {
+        const ok = plainToInstance(cls as never, { ...base, screenState: 'AMOUNT_MISMATCH' }, { excludeExtraneousValues: true }) as { screenState?: string };
+        expect(ok.screenState).toBe(S.AMOUNT_MISMATCH);
+        expect(errorsOf(cls as never, { ...base, screenState: 'AMOUNT_MISMATCH' })).toEqual([]);
+        expect(errorsOf(cls as never, base)).toEqual([]);
+        expect(errorsOf(cls as never, { ...base, screenState: 'TEST' })).toEqual(['screenState']);
+        expect(errorsOf(cls as never, { ...base, screenState: 'NOPE' })).toEqual(['screenState']);
+    });
+});

package/bin/meetings/dtos/MeetingResponse.d.ts

@@ -56,6 +56,12 @@ export declare class MeetingResponse {
     registeredCount?: number;
     /** Cuántos de esos PARTICIPANT quedaron ATTENDED. Mismo mantenimiento que registeredCount. */
     attendedCount?: number;
+    /**
+     * Epoch ms de la última vez que se pidió iniciarla desde el back office («Iniciar»). Una reunión de la
+     * plataforma puede tener varias filas (una por fecha en que se dio); con esto el back office sabe desde
+     * cuál se inició la sesión que está corriendo y marca ésa como «En curso».
+     */
+    startRequestedAt?: number;
     tenantId?: string;
     /** Epoch ms, como el resto de la flota. */
     createdAt?: number;

package/bin/reconciliation/constants/reconciliationValidation.d.ts

@@ -1,3 +1,4 @@
+import { ReconciliationItemStateEnum } from '../enums/ReconciliationItemStateEnum';
 /** Periodo de una corrida: día `YYYY-MM-DD`, semana ISO `YYYY-Www` o mes `YYYY-MM`. */
 export declare const RECONCILIATION_PERIOD_KEY_PATTERN: RegExp;
 /** Mes `YYYY-MM`. */
@@ -14,3 +15,5 @@ export declare const RECONCILIATION_MAX_BANK_ACCOUNTS = 10;
 export declare const RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS = 30;
 /** Registros por página de un feed de dueño. */
 export declare const RECONCILIATION_FEED_PAGE_SIZE = 500;
+/** Estados que muestra la matriz: todos menos `TEST`, que vive en su propia lista. */
+export declare const RECONCILIATION_SCREEN_ITEM_STATES: readonly ReconciliationItemStateEnum[];

package/bin/reconciliation/constants/reconciliationValidation.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECONCILIATION_FEED_PAGE_SIZE = exports.RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS = exports.RECONCILIATION_MAX_BANK_ACCOUNTS = exports.RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH = exports.RECONCILIATION_BANK_PATH_SEGMENT_PATTERN = exports.RECONCILIATION_MIN_NOTE_LENGTH = exports.RECONCILIATION_MONTH_PATTERN = exports.RECONCILIATION_PERIOD_KEY_PATTERN = void 0;
+exports.RECONCILIATION_SCREEN_ITEM_STATES = exports.RECONCILIATION_FEED_PAGE_SIZE = exports.RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS = exports.RECONCILIATION_MAX_BANK_ACCOUNTS = exports.RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH = exports.RECONCILIATION_BANK_PATH_SEGMENT_PATTERN = exports.RECONCILIATION_MIN_NOTE_LENGTH = exports.RECONCILIATION_MONTH_PATTERN = exports.RECONCILIATION_PERIOD_KEY_PATTERN = void 0;
+const ReconciliationItemStateEnum_1 = require("../enums/ReconciliationItemStateEnum");
 /** Periodo de una corrida: día `YYYY-MM-DD`, semana ISO `YYYY-Www` o mes `YYYY-MM`. */
 exports.RECONCILIATION_PERIOD_KEY_PATTERN = /^\d{4}-((0[1-9]|1[0-2])(-(0[1-9]|[12]\d|3[01]))?|W(0[1-9]|[1-4]\d|5[0-3]))$/;
 /** Mes `YYYY-MM`. */
@@ -17,3 +18,5 @@ exports.RECONCILIATION_MAX_BANK_ACCOUNTS = 10;
 exports.RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS = 30;
 /** Registros por página de un feed de dueño. */
 exports.RECONCILIATION_FEED_PAGE_SIZE = 500;
+/** Estados que muestra la matriz: todos menos `TEST`, que vive en su propia lista. */
+exports.RECONCILIATION_SCREEN_ITEM_STATES = Object.values(ReconciliationItemStateEnum_1.ReconciliationItemStateEnum).filter((state) => state !== ReconciliationItemStateEnum_1.ReconciliationItemStateEnum.TEST);

package/bin/reconciliation/dtos/requests/ReconciliationQueries.d.ts

@@ -47,6 +47,8 @@ export declare class ListReconciliationItemsQuery {
     from?: string;
     to?: string;
     state?: ReconciliationItemStateEnum;
+    /** Estado de la matriz; no admite `TEST`. */
+    screenState?: ReconciliationItemStateEnum;
     concept?: ReconciliationFeedConceptEnum;
     counterpartyId?: string;
     format?: ReconciliationExportFormatEnum;

package/bin/reconciliation/dtos/requests/ReconciliationQueries.js

@@ -165,6 +165,12 @@ __decorate([
     (0, class_validator_1.IsEnum)(ReconciliationItemStateEnum_1.ReconciliationItemStateEnum),
     __metadata("design:type", String)
 ], ListReconciliationItemsQuery.prototype, "state", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(reconciliationValidation_1.RECONCILIATION_SCREEN_ITEM_STATES),
+    __metadata("design:type", String)
+], ListReconciliationItemsQuery.prototype, "screenState", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/package.json

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

package/src/meetings/dtos/MeetingResponse.ts

@@ -57,6 +57,12 @@ export class MeetingResponse {
     registeredCount?: number;
     /** Cuántos de esos PARTICIPANT quedaron ATTENDED. Mismo mantenimiento que registeredCount. */
     attendedCount?: number;
+    /**
+     * Epoch ms de la última vez que se pidió iniciarla desde el back office («Iniciar»). Una reunión de la
+     * plataforma puede tener varias filas (una por fecha en que se dio); con esto el back office sabe desde
+     * cuál se inició la sesión que está corriendo y marca ésa como «En curso».
+     */
+    startRequestedAt?: number;
     tenantId?: string;
     /** Epoch ms, como el resto de la flota. */
     createdAt?: number;

package/src/reconciliation/constants/reconciliationValidation.ts

@@ -1,3 +1,5 @@
+import { ReconciliationItemStateEnum } from '../enums/ReconciliationItemStateEnum';
+
 /** Periodo de una corrida: día `YYYY-MM-DD`, semana ISO `YYYY-Www` o mes `YYYY-MM`. */
 export const RECONCILIATION_PERIOD_KEY_PATTERN = /^\d{4}-((0[1-9]|1[0-2])(-(0[1-9]|[12]\d|3[01]))?|W(0[1-9]|[1-4]\d|5[0-3]))$/;
 
@@ -21,3 +23,8 @@ export const RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS = 30;
 
 /** Registros por página de un feed de dueño. */
 export const RECONCILIATION_FEED_PAGE_SIZE = 500;
+
+/** Estados que muestra la matriz: todos menos `TEST`, que vive en su propia lista. */
+export const RECONCILIATION_SCREEN_ITEM_STATES: readonly ReconciliationItemStateEnum[] = Object.values(ReconciliationItemStateEnum).filter(
+    (state) => state !== ReconciliationItemStateEnum.TEST,
+);

package/src/reconciliation/dtos/requests/ReconciliationQueries.ts

@@ -1,7 +1,7 @@
 import { Expose, Type } from 'class-transformer';
-import { IsEnum, IsInt, IsISO8601, IsOptional, IsString, Matches, Max, Min } from 'class-validator';
+import { IsEnum, IsIn, IsInt, IsISO8601, IsOptional, IsString, Matches, Max, Min } from 'class-validator';
 import { TransferNotePartyTypeEnum } from '../../../transferNote/enums/TransferNotePartyTypeEnum';
-import { RECONCILIATION_MONTH_PATTERN } from '../../constants/reconciliationValidation';
+import { RECONCILIATION_MONTH_PATTERN, RECONCILIATION_SCREEN_ITEM_STATES } from '../../constants/reconciliationValidation';
 import { ReconciliationDefinitionStatusEnum } from '../../enums/ReconciliationDefinitionStatusEnum';
 import { ReconciliationExportFormatEnum } from '../../enums/ReconciliationExportFormatEnum';
 import { ReconciliationFeedConceptEnum } from '../../enums/ReconciliationFeedConceptEnum';
@@ -126,6 +126,12 @@ export class ListReconciliationItemsQuery {
     @IsEnum(ReconciliationItemStateEnum)
     state?: ReconciliationItemStateEnum;
 
+    /** Estado de la matriz; no admite `TEST`. */
+    @Expose()
+    @IsOptional()
+    @IsIn(RECONCILIATION_SCREEN_ITEM_STATES)
+    screenState?: ReconciliationItemStateEnum;
+
     @Expose()
     @IsOptional()
     @IsEnum(ReconciliationFeedConceptEnum)