@fiado/type-kit 3.329.0 → 3.331.0

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,30 @@
+name: "Publish to npm"
+
+on:
+  push:
+    branches: [ develop ]
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+      - '.gitignore'
+      - '.npmignore'
+  workflow_dispatch:
+    inputs:
+      dry-run:
+        description: 'Corre build, test y npm publish --dry-run sin publicar de verdad'
+        required: false
+        default: false
+        type: boolean
+
+concurrency:
+  group: npm-publish-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    uses: Fiado-Today/github-workflows/.github/workflows/npm-publish.yml@develop
+    permissions:
+      contents: write
+    with:
+      dry-run: ${{ inputs.dry-run == true }}
+    secrets: inherit

package/_test_/unit/places/GetNearbyPlacesRequest.test.ts

@@ -0,0 +1,70 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { GetNearbyPlacesRequest, PlaceTypeEnum } from '../../../src/places/index';
+
+/** El request mínimo válido: punto + al menos un tipo. */
+const base = {
+  latitude: 19.4326,
+  longitude: -99.1332,
+  types: [PlaceTypeEnum.CashInMx],
+};
+
+const instancia = (raw: Record<string, unknown>): GetNearbyPlacesRequest =>
+  plainToInstance(GetNearbyPlacesRequest, raw);
+
+/**
+ * Mismo modo en que valida el consumidor real (`places-business`): `whitelist: true`.
+ * Importa que sea idéntico, ver el test del radio más abajo.
+ */
+const propiedadesConError = async (raw: Record<string, unknown>): Promise<string[]> =>
+  (await validate(instancia(raw) as object, { whitelist: true })).map((e) => e.property);
+
+describe('GetNearbyPlacesRequest', () => {
+  it('valida sin radius: el radio es opcional', async () => {
+    const dto = instancia(base);
+
+    expect(await validate(dto as object, { whitelist: true })).toHaveLength(0);
+    expect(dto.radius).toBeUndefined();
+  });
+
+  it('valida con radius', async () => {
+    const dto = instancia({ ...base, radius: 5 });
+
+    expect(await validate(dto as object, { whitelist: true })).toHaveLength(0);
+    expect(dto.radius).toBe(5);
+  });
+
+  /**
+   * El guard que de verdad importa. El consumidor valida con `whitelist: true`, que
+   * DESCARTA toda propiedad sin decorador. Si alguien le quita los decoradores a
+   * `radius`, este contrato sigue compilando y el lambda pierde el radio en silencio:
+   * el mapa se quedaría pidiendo siempre el default. Que falle acá, no en producción.
+   */
+  it('radius sobrevive al whitelist del validador', async () => {
+    const instancia = plainToInstance(GetNearbyPlacesRequest, { ...base, radius: 12 });
+
+    await validate(instancia as object, { whitelist: true });
+
+    expect(instancia.radius).toBe(12);
+  });
+
+  it('rechaza un radius que no es positivo', async () => {
+    expect(await propiedadesConError({ ...base, radius: 0 })).toContain('radius');
+    expect(await propiedadesConError({ ...base, radius: -3 })).toContain('radius');
+  });
+
+  it('rechaza un radius que no es número', async () => {
+    expect(await propiedadesConError({ ...base, radius: 'cinco' })).toContain('radius');
+  });
+
+  /** Los campos que ya existían siguen siendo obligatorios: el cambio es aditivo. */
+  it('sigue exigiendo punto y tipos', async () => {
+    expect(await propiedadesConError({ types: [PlaceTypeEnum.CashInMx] })).toEqual(
+      expect.arrayContaining(['latitude', 'longitude']),
+    );
+    expect(await propiedadesConError({ latitude: 19.4326, longitude: -99.1332, types: [] })).toContain(
+      'types',
+    );
+  });
+});

package/_test_/unit/retailWizard/wizardBlocked.test.ts

@@ -12,11 +12,12 @@ describe('BlockedReasonEnum', () => {
 });
 
 describe('BlockedCategoryEnum', () => {
-  it('tiene las tres categorias que dicen quien resuelve', () => {
+  it('tiene las cuatro categorias que dicen quien resuelve', () => {
     expect(BlockedCategoryEnum.CUSTOMER_RECORD).toBe('CUSTOMER_RECORD');
     expect(BlockedCategoryEnum.UNDER_REVIEW).toBe('UNDER_REVIEW');
     expect(BlockedCategoryEnum.TEMPORARY).toBe('TEMPORARY');
-    expect(Object.keys(BlockedCategoryEnum)).toHaveLength(3);
+    expect(BlockedCategoryEnum.REJECTED).toBe('REJECTED');
+    expect(Object.keys(BlockedCategoryEnum)).toHaveLength(4);
   });
 
   it('ningun valor nombra listas de cumplimiento ni PLD', () => {

package/bin/identity/dtos/ManualApproval.d.ts

@@ -12,4 +12,13 @@ export interface ManualApproval {
     at: string;
     /** justificación obligatoria del override */
     reason: string;
+    /**
+     * Conclusión del oficial. Ausente en los sellos escritos antes de este campo, que solo se
+     * estampaban al aprobar: leerlos sin `verdict` equivale a `APPROVED`.
+     */
+    verdict?: ManualApprovalVerdict;
+    /** Alerta de PLD que se dictaminó, para rastrear el sello hasta su expediente. */
+    alertId?: string;
 }
+/** Conclusión del oficial de cumplimiento sobre la lista que revisó. */
+export type ManualApprovalVerdict = 'APPROVED' | 'REJECTED';

package/bin/identity/dtos/PeopleResponse.d.ts

@@ -131,6 +131,10 @@ export declare class PeopleResponse {
         /** Geolocalización aprobada. `null` = no evaluada; solo `false` bloquea. */
         geoApproved?: boolean | null;
         cnbvManualApproval?: ManualApproval | null;
+        /** Sello del oficial sobre las listas internacionales y PEP (`blackListApproved`). */
+        blackListManualApproval?: ManualApproval | null;
+        /** Sello del oficial sobre la lista negra interna de Fiado (`fiadoListApproved`). */
+        fiadoListManualApproval?: ManualApproval | null;
         minorManualApproval?: ManualApproval | null;
     };
     SIN: string | null;

package/bin/identity/dtos/PeopleUpdateRequest.d.ts

@@ -55,6 +55,8 @@ export declare class PeopleUpdateRequest {
     ofacListApproved?: boolean | null;
     cnbvListApproved?: boolean | null;
     cnbvManualApproval?: ManualApproval | null;
+    blackListManualApproval?: ManualApproval | null;
+    fiadoListManualApproval?: ManualApproval | null;
     minorManualApproval?: ManualApproval | null;
     blackListApproved?: boolean | null;
     whiteList?: boolean | null;

package/bin/places/dtos/GetNearbyPlacesRequest.d.ts

@@ -7,4 +7,17 @@ export declare class GetNearbyPlacesRequest {
     latitude: number;
     longitude: number;
     types: PlaceTypeEnum[];
+    /**
+     * Radio de búsqueda en km.
+     *
+     * Sólo aplica a los tipos que consultan un directorio EN VIVO del proveedor; los que
+     * se sirven de la cache geoespacial lo ignoran, porque su área la fija la resolución
+     * de las celdas y no un radio del request.
+     *
+     * Omitido = el default de quien atiende la búsqueda. No lleva `@Max` acá a propósito:
+     * el tope sano depende del proveedor (un directorio que no pagina devuelve miles de
+     * tiendas en una sola respuesta), así que lo aplica el lambda que lo consume y no este
+     * contrato, que es compartido.
+     */
+    radius?: number;
 }

package/bin/places/dtos/GetNearbyPlacesRequest.js

@@ -37,3 +37,9 @@ __decorate([
     (0, class_validator_1.IsEnum)(PlaceTypeEnum_1.PlaceTypeEnum, { each: true }),
     __metadata("design:type", Array)
 ], GetNearbyPlacesRequest.prototype, "types", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], GetNearbyPlacesRequest.prototype, "radius", void 0);

package/bin/places/dtos/GetNearbyPlacesResponse.d.ts

@@ -1,11 +1,25 @@
 import { EstablishmentDto } from './EstablishmentDto';
 import { OfficeDto } from '../../offices/dtos/OfficeDto';
+import { FundingStoreItem } from '../../walletFunding/dtos/FundingStoreItem';
 /**
  * Respuesta de la búsqueda unificada. Solo se incluyen los tipos pedidos en `types`.
  */
 export declare class GetNearbyPlacesResponse {
     cashInUs?: EstablishmentDto[];
     cashInMx?: EstablishmentDto[];
+    /**
+     * Cash-in MX servido por el directorio EN VIVO del proveedor de fondeo, en vez de
+     * por la cache geoespacial que alimenta `cashInMx`.
+     *
+     * Campo aparte a propósito, por dos razones. `FundingStoreItem` trae lo que
+     * `EstablishmentDto` no tiene y la app necesita pintar en el pin —comisión de caja,
+     * tope por operación, horario, logo—; y es el MISMO tipo que ya comparten el connector
+     * y el wallet-app, así que reusarlo evita una tercera declaración del mismo concepto.
+     *
+     * Cuál de los dos campos se llena lo decide la configuración de ruteo del lambda:
+     * viene uno u otro, nunca los dos.
+     */
+    cashInMxStores?: FundingStoreItem[];
     officeFiado?: OfficeDto[];
     storeFiado?: OfficeDto[];
 }

package/bin/retailWizard/enums/BlockedCategoryEnum.d.ts

@@ -11,5 +11,10 @@ export declare enum BlockedCategoryEnum {
      */
     UNDER_REVIEW = "UNDER_REVIEW",
     /** Falla pasajera del proveedor o de la lectura; cede sola cuando el servicio vuelve. */
-    TEMPORARY = "TEMPORARY"
+    TEMPORARY = "TEMPORARY",
+    /**
+     * Quien revisaba el caso ya resolvió que la cuenta no se abre. Es terminal: nadie la va a
+     * destrabar y la venta no continúa. Tampoco dice por qué.
+     */
+    REJECTED = "REJECTED"
 }

package/bin/retailWizard/enums/BlockedCategoryEnum.js

@@ -16,4 +16,9 @@ var BlockedCategoryEnum;
     BlockedCategoryEnum["UNDER_REVIEW"] = "UNDER_REVIEW";
     /** Falla pasajera del proveedor o de la lectura; cede sola cuando el servicio vuelve. */
     BlockedCategoryEnum["TEMPORARY"] = "TEMPORARY";
+    /**
+     * Quien revisaba el caso ya resolvió que la cuenta no se abre. Es terminal: nadie la va a
+     * destrabar y la venta no continúa. Tampoco dice por qué.
+     */
+    BlockedCategoryEnum["REJECTED"] = "REJECTED";
 })(BlockedCategoryEnum || (exports.BlockedCategoryEnum = BlockedCategoryEnum = {}));

package/bin/retailWizard/enums/PendingReasonEnum.d.ts

@@ -1,7 +1,7 @@
 /**
  * Motivo por el que un cliente quedó como prospecto, filtrados por paso.
  *
- * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los dos últimos los pone
+ * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los tres últimos los pone
  * el sistema cuando la venta se traba por la cuenta: no se ofrecen en el desplegable ni se editan.
  * SureKeep Fase 2 — pista Retail.
  */
@@ -27,7 +27,9 @@ export declare enum PendingReasonEnum {
      */
     ACCOUNT_UNDER_REVIEW = "ACCOUNT_UNDER_REVIEW",
     /** La cuenta no abrió por un dato del expediente o una falla del proveedor. */
-    ACCOUNT_OPEN_FAILED = "ACCOUNT_OPEN_FAILED"
+    ACCOUNT_OPEN_FAILED = "ACCOUNT_OPEN_FAILED",
+    /** La revisión terminó y la cuenta no se abre. La venta no continúa. */
+    ACCOUNT_REJECTED = "ACCOUNT_REJECTED"
 }
 /** Los que pone el sistema al trabarse la venta: no se ofrecen al vendedor ni se pueden editar. */
 export declare const SYSTEM_PENDING_REASONS: readonly PendingReasonEnum[];

package/bin/retailWizard/enums/PendingReasonEnum.js

@@ -4,7 +4,7 @@ exports.SYSTEM_PENDING_REASONS = exports.PendingReasonEnum = void 0;
 /**
  * Motivo por el que un cliente quedó como prospecto, filtrados por paso.
  *
- * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los dos últimos los pone
+ * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los tres últimos los pone
  * el sistema cuando la venta se traba por la cuenta: no se ofrecen en el desplegable ni se editan.
  * SureKeep Fase 2 — pista Retail.
  */
@@ -32,9 +32,12 @@ var PendingReasonEnum;
     PendingReasonEnum["ACCOUNT_UNDER_REVIEW"] = "ACCOUNT_UNDER_REVIEW";
     /** La cuenta no abrió por un dato del expediente o una falla del proveedor. */
     PendingReasonEnum["ACCOUNT_OPEN_FAILED"] = "ACCOUNT_OPEN_FAILED";
+    /** La revisión terminó y la cuenta no se abre. La venta no continúa. */
+    PendingReasonEnum["ACCOUNT_REJECTED"] = "ACCOUNT_REJECTED";
 })(PendingReasonEnum || (exports.PendingReasonEnum = PendingReasonEnum = {}));
 /** Los que pone el sistema al trabarse la venta: no se ofrecen al vendedor ni se pueden editar. */
 exports.SYSTEM_PENDING_REASONS = [
     PendingReasonEnum.ACCOUNT_UNDER_REVIEW,
     PendingReasonEnum.ACCOUNT_OPEN_FAILED,
+    PendingReasonEnum.ACCOUNT_REJECTED,
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.329.0",
+  "version": "3.331.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",
@@ -28,4 +28,4 @@
     "class-validator": "^0.14.2",
     "reflect-metadata": "^0.2.2"
   }
-}
+}

package/src/identity/dtos/ManualApproval.ts

@@ -13,4 +13,14 @@ export interface ManualApproval {
     at: string;
     /** justificación obligatoria del override */
     reason: string;
+    /**
+     * Conclusión del oficial. Ausente en los sellos escritos antes de este campo, que solo se
+     * estampaban al aprobar: leerlos sin `verdict` equivale a `APPROVED`.
+     */
+    verdict?: ManualApprovalVerdict;
+    /** Alerta de PLD que se dictaminó, para rastrear el sello hasta su expediente. */
+    alertId?: string;
 }
+
+/** Conclusión del oficial de cumplimiento sobre la lista que revisó. */
+export type ManualApprovalVerdict = 'APPROVED' | 'REJECTED';

package/src/identity/dtos/PeopleResponse.ts

@@ -137,6 +137,10 @@ export class PeopleResponse {
         /** Geolocalización aprobada. `null` = no evaluada; solo `false` bloquea. */
         geoApproved?:boolean | null;
         cnbvManualApproval?: ManualApproval | null;
+        /** Sello del oficial sobre las listas internacionales y PEP (`blackListApproved`). */
+        blackListManualApproval?: ManualApproval | null;
+        /** Sello del oficial sobre la lista negra interna de Fiado (`fiadoListApproved`). */
+        fiadoListManualApproval?: ManualApproval | null;
         minorManualApproval?: ManualApproval | null;
 
     }

package/src/identity/dtos/PeopleUpdateRequest.ts

@@ -60,6 +60,8 @@ export class PeopleUpdateRequest {
     ofacListApproved?: boolean | null;
     cnbvListApproved?: boolean | null;
     cnbvManualApproval?: ManualApproval | null;
+    blackListManualApproval?: ManualApproval | null;
+    fiadoListManualApproval?: ManualApproval | null;
     minorManualApproval?: ManualApproval | null;
     blackListApproved?: boolean | null;
     whiteList?: boolean | null;

package/src/places/dtos/GetNearbyPlacesRequest.ts

@@ -1,4 +1,4 @@
-import { ArrayNotEmpty, IsArray, IsEnum, IsNumber, Max, Min } from 'class-validator';
+import { ArrayNotEmpty, IsArray, IsEnum, IsNumber, IsOptional, IsPositive, Max, Min } from 'class-validator';
 import { PlaceTypeEnum } from '../enums/PlaceTypeEnum';
 
 /**
@@ -20,4 +20,21 @@ export class GetNearbyPlacesRequest {
     @ArrayNotEmpty()
     @IsEnum(PlaceTypeEnum, { each: true })
     types: PlaceTypeEnum[];
+
+    /**
+     * Radio de búsqueda en km.
+     *
+     * Sólo aplica a los tipos que consultan un directorio EN VIVO del proveedor; los que
+     * se sirven de la cache geoespacial lo ignoran, porque su área la fija la resolución
+     * de las celdas y no un radio del request.
+     *
+     * Omitido = el default de quien atiende la búsqueda. No lleva `@Max` acá a propósito:
+     * el tope sano depende del proveedor (un directorio que no pagina devuelve miles de
+     * tiendas en una sola respuesta), así que lo aplica el lambda que lo consume y no este
+     * contrato, que es compartido.
+     */
+    @IsOptional()
+    @IsNumber()
+    @IsPositive()
+    radius?: number;
 }

package/src/places/dtos/GetNearbyPlacesResponse.ts

@@ -1,5 +1,6 @@
 import { EstablishmentDto } from './EstablishmentDto';
 import { OfficeDto } from '../../offices/dtos/OfficeDto';
+import { FundingStoreItem } from '../../walletFunding/dtos/FundingStoreItem';
 
 /**
  * Respuesta de la búsqueda unificada. Solo se incluyen los tipos pedidos en `types`.
@@ -7,6 +8,19 @@ import { OfficeDto } from '../../offices/dtos/OfficeDto';
 export class GetNearbyPlacesResponse {
     cashInUs?: EstablishmentDto[];
     cashInMx?: EstablishmentDto[];
+    /**
+     * Cash-in MX servido por el directorio EN VIVO del proveedor de fondeo, en vez de
+     * por la cache geoespacial que alimenta `cashInMx`.
+     *
+     * Campo aparte a propósito, por dos razones. `FundingStoreItem` trae lo que
+     * `EstablishmentDto` no tiene y la app necesita pintar en el pin —comisión de caja,
+     * tope por operación, horario, logo—; y es el MISMO tipo que ya comparten el connector
+     * y el wallet-app, así que reusarlo evita una tercera declaración del mismo concepto.
+     *
+     * Cuál de los dos campos se llena lo decide la configuración de ruteo del lambda:
+     * viene uno u otro, nunca los dos.
+     */
+    cashInMxStores?: FundingStoreItem[];
     officeFiado?: OfficeDto[];
     storeFiado?: OfficeDto[];
 }

package/src/retailWizard/enums/BlockedCategoryEnum.ts

@@ -12,4 +12,9 @@ export enum BlockedCategoryEnum {
     UNDER_REVIEW = 'UNDER_REVIEW',
     /** Falla pasajera del proveedor o de la lectura; cede sola cuando el servicio vuelve. */
     TEMPORARY = 'TEMPORARY',
+    /**
+     * Quien revisaba el caso ya resolvió que la cuenta no se abre. Es terminal: nadie la va a
+     * destrabar y la venta no continúa. Tampoco dice por qué.
+     */
+    REJECTED = 'REJECTED',
 }

package/src/retailWizard/enums/PendingReasonEnum.ts

@@ -1,7 +1,7 @@
 /**
  * Motivo por el que un cliente quedó como prospecto, filtrados por paso.
  *
- * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los dos últimos los pone
+ * Los primeros quince son objeciones del CLIENTE y los elige el vendedor. Los tres últimos los pone
  * el sistema cuando la venta se traba por la cuenta: no se ofrecen en el desplegable ni se editan.
  * SureKeep Fase 2 — pista Retail.
  */
@@ -28,10 +28,13 @@ export enum PendingReasonEnum {
     ACCOUNT_UNDER_REVIEW = 'ACCOUNT_UNDER_REVIEW',
     /** La cuenta no abrió por un dato del expediente o una falla del proveedor. */
     ACCOUNT_OPEN_FAILED = 'ACCOUNT_OPEN_FAILED',
+    /** La revisión terminó y la cuenta no se abre. La venta no continúa. */
+    ACCOUNT_REJECTED = 'ACCOUNT_REJECTED',
 }
 
 /** Los que pone el sistema al trabarse la venta: no se ofrecen al vendedor ni se pueden editar. */
 export const SYSTEM_PENDING_REASONS: readonly PendingReasonEnum[] = [
     PendingReasonEnum.ACCOUNT_UNDER_REVIEW,
     PendingReasonEnum.ACCOUNT_OPEN_FAILED,
+    PendingReasonEnum.ACCOUNT_REJECTED,
 ] as const;