@fiado/type-kit 3.46.2 → 3.48.0

package/src/beneficiary/dtos/AccountBeneficiaryResponse.ts

@@ -1,27 +1,27 @@
-import { CountryId } from "../../country";
-
-
-
-
-export class AccountBeneficiaryResponse {
-    id: string;
-    accountId: string;
-    countryId: CountryId;
-    accountType: string;
-    directoryId: string;
-    peopleId: string;
-
-    beneficiaryDirectorId?: string;
-    beneficiaryPeopleId?: string;
-    phoneNumber?: string | null;
-
-    dateOfBirth?: string | null;
-    stateOfBirth?: string;
-    relationType: string;
-    percentage: number;
-    countryOfResidence?: string;
-    address: string;
-    names: string;
-    paternalLastName?: string;
-    maternalLastName?: string;
+import { CountryId } from "../../country";
+
+
+
+
+export class AccountBeneficiaryResponse {
+    id: string;
+    accountId: string;
+    countryId: CountryId;
+    accountType: string;
+    directoryId: string;
+    peopleId: string;
+
+    beneficiaryDirectorId?: string;
+    beneficiaryPeopleId?: string;
+    phoneNumber?: string | null;
+
+    dateOfBirth?: string | null;
+    stateOfBirth?: string;
+    relationType: string;
+    percentage: number;
+    countryOfResidence?: string;
+    address: string;
+    names: string;
+    paternalLastName?: string;
+    maternalLastName?: string;
 }

package/src/beneficiary/dtos/AccountBeneficiaryUpdateRequest.ts

@@ -1,42 +1,42 @@
-import {IsDateString, IsNumber, IsOptional, IsString, IsUUID, Max, Min} from 'class-validator';
-import {IsPhoneNumberFiado} from '../../card/validations/IsPhoneNumberConstraint';
-
-export class AccountBeneficiaryUpdateRequest {
-
-    @IsOptional()
-    @IsUUID()
-    accountId?: string;
-
-    @IsOptional()
-    @IsPhoneNumberFiado()
-    phoneNumber?: string;
-
-    @IsOptional()
-    @IsString()
-    fullName?: string;
-
-    @IsOptional()
-    @IsDateString()
-    dateOfBirth?: string;
-
-    @IsOptional()
-    @IsString()
-    stateOfBirth?: string;
-
-    @IsOptional()
-    @IsString()
-    relationType?: string;
-
-    @IsOptional()
-    @IsNumber()
-    @Min(0)
-    @Max(100)
-    percentage?: number;
-
-    @IsOptional()
-    @IsString()
-    countryOfResidence?: string;
-
-    @IsString()
-    secretNumber: string;
-}
+import {IsDateString, IsNumber, IsOptional, IsString, IsUUID, Max, Min} from 'class-validator';
+import {IsPhoneNumberFiado} from '../../card/validations/IsPhoneNumberConstraint';
+
+export class AccountBeneficiaryUpdateRequest {
+
+    @IsOptional()
+    @IsUUID()
+    accountId?: string;
+
+    @IsOptional()
+    @IsPhoneNumberFiado()
+    phoneNumber?: string;
+
+    @IsOptional()
+    @IsString()
+    fullName?: string;
+
+    @IsOptional()
+    @IsDateString()
+    dateOfBirth?: string;
+
+    @IsOptional()
+    @IsString()
+    stateOfBirth?: string;
+
+    @IsOptional()
+    @IsString()
+    relationType?: string;
+
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    @Max(100)
+    percentage?: number;
+
+    @IsOptional()
+    @IsString()
+    countryOfResidence?: string;
+
+    @IsString()
+    secretNumber: string;
+}

package/src/beneficiary/enums/AccountType.ts

@@ -1,7 +1,7 @@
-
-
-
-export enum AccountType {
-    PAGOCONFIADO = 'PAGOCONFIADO',
-    FIADO_INC = 'FIADO_INC',
+
+
+
+export enum AccountType {
+    PAGOCONFIADO = 'PAGOCONFIADO',
+    FIADO_INC = 'FIADO_INC',
 }   

package/src/beneficiary/index.ts

@@ -1,8 +1,8 @@
-
-//dtos
-export * from './dtos/AccountBeneficiaryUpdateRequest';
-export * from './dtos/AccountBeneficiaryCreateRequest';
-export * from './dtos/AccountBeneficiaryResponse';
-
-//enums
+
+//dtos
+export * from './dtos/AccountBeneficiaryUpdateRequest';
+export * from './dtos/AccountBeneficiaryCreateRequest';
+export * from './dtos/AccountBeneficiaryResponse';
+
+//enums
 export * from './enums/AccountType';

package/src/benefitCenter/dtos/AuthorizeBenefitsMarketplaceTransactionRequest.ts

@@ -1,138 +1,138 @@
-import {
-    IsLatitude,
-    IsLongitude,
-    IsNotEmpty,
-    IsNumber,
-    IsObject,
-    IsOptional,
-    IsPositive,
-    IsString,
-    Matches,
-    Max,
-    MaxLength,
-} from "class-validator";
-
-/**
- * Request del endpoint nuevo `POST /authorizeBenefitsMarketplaceTransaction`
- * en `transaction-processor-business` (PublicController). Lo invoca la app
- * para todos los flujos del Centro de Beneficios.
- *
- * NO se reusa `AuthorizePaymentTransactionRequest` ni similares: este DTO
- * es dedicado, sin sub-objetos opcionales, con los campos del Centro como
- * ciudadanos de primera clase.
- *
- * Los endpoints `authorize*Transaction` actuales del procesador no se tocan
- * y siguen recibiendo su tráfico legacy. Ver doc Fase 2 §5.1.
- */
-export class AuthorizeBenefitsMarketplaceTransactionRequest {
-    /**
-     * Reusa entradas existentes en `ProductCatalog_GT` del procesador
-     * (`MEX_TOPUP`, `MEX_SERVICE_PAYMENT`, …). No se agregan entradas nuevas
-     * en Fase 2 (ver doc §10).
-     *
-     * El factory dinámico `TransactionProcessorFactory.getMarketplaceInstance`
-     * deriva el token del binding desde aquí (`MEX_<X>` →
-     * `BenefitsMarketplace<X>TransactionService`). La regex impone el contrato
-     * y permite que el factory falle con 400 en lugar de 500 si llega algo
-     * fuera de la convención.
-     */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    @Matches(/^MEX_[A-Z][A-Z_]*$/, {
-        message: "productCatalogId debe seguir el formato MEX_<UPPER_SNAKE>",
-    })
-    productCatalogId!: string;
-
-    /**
-     * Idempotency key generada por la **app** (UUID por intento).
-     * Lo consume el decorador `@IdempotencyController` del procesador para
-     * deduplicar reintentos del cliente.
-     *
-     * Distinto de `BenefitPaymentRequest.transactionNumber` que el procesador
-     * genera internamente al crear la transacción y envía al marketplace y
-     * al conector como idempotency key del lado del proveedor. La app NO
-     * debe generar `transactionNumber` — por eso este DTO no lo expone.
-     */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    idempotencyKey!: string;
-
-    /**
-     * Monto en unidad mayor de la moneda (no centavos). Como mucho 2 decimales.
-     * El `Max` cap es defensivo — atrapa errores obvios (montos absurdos por
-     * bugs de UI) sin restringir casos legítimos. Ajustar si la operatoria
-     * requiere techos mayores.
-     */
-    @IsNumber({maxDecimalPlaces: 2})
-    @IsPositive()
-    @Max(1_000_000)
-    amount!: number;
-
-    /** ISO numeric (3 chars). Ej: "484" (MXN), "840" (USD). */
-    @IsString()
-    @Matches(/^\d{3}$/, {
-        message: "currencyId debe ser ISO numérico de 3 dígitos",
-    })
-    currencyId!: string;
-
-    // Campos del Centro de Beneficios — first-class, no opcionales
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    benefitId!: string;
-
-    /**
-     * `leafId = base64url("<moduleName>::<idServicio>")`. Convención
-     * cross-componente del Centro (ver
-     * `docs/favorites/05b-favoritos-ligados-a-producto.md`). La regex
-     * enforce el charset base64url sin tener que decodificar acá.
-     */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(256)
-    @Matches(/^[A-Za-z0-9_-]+$/, {
-        message: "leafId debe estar codificado en base64url (charset A-Za-z0-9_-)",
-    })
-    leafId!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    productId!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(128)
-    reference!: string;
-
-    /**
-     * Decide a qué conector apuntar dentro del marketplace. Va concatenado
-     * a la URL `POST /pay/{moduleName}` del marketplace privado. La regex
-     * restringe a charset seguro (kebab-case minúsculas), previene
-     * inyecciones de path y matchea la convención de naming de los
-     * lambdas Fiado.
-     */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(128)
-    @Matches(/^[a-z][a-z0-9-]*$/, {
-        message: "moduleName debe ser kebab-case minúsculas",
-    })
-    moduleName!: string;
-
-    /** Inputs dinámicos del leaf — opcionales según el servicio. */
-    @IsOptional()
-    @IsObject()
-    inputs?: Record<string, string | number | boolean>;
-
-    @IsOptional()
-    @IsLatitude()
-    latitude?: number;
-
-    @IsOptional()
-    @IsLongitude()
-    longitude?: number;
-}
+import {
+    IsLatitude,
+    IsLongitude,
+    IsNotEmpty,
+    IsNumber,
+    IsObject,
+    IsOptional,
+    IsPositive,
+    IsString,
+    Matches,
+    Max,
+    MaxLength,
+} from "class-validator";
+
+/**
+ * Request del endpoint nuevo `POST /authorizeBenefitsMarketplaceTransaction`
+ * en `transaction-processor-business` (PublicController). Lo invoca la app
+ * para todos los flujos del Centro de Beneficios.
+ *
+ * NO se reusa `AuthorizePaymentTransactionRequest` ni similares: este DTO
+ * es dedicado, sin sub-objetos opcionales, con los campos del Centro como
+ * ciudadanos de primera clase.
+ *
+ * Los endpoints `authorize*Transaction` actuales del procesador no se tocan
+ * y siguen recibiendo su tráfico legacy. Ver doc Fase 2 §5.1.
+ */
+export class AuthorizeBenefitsMarketplaceTransactionRequest {
+    /**
+     * Reusa entradas existentes en `ProductCatalog_GT` del procesador
+     * (`MEX_TOPUP`, `MEX_SERVICE_PAYMENT`, …). No se agregan entradas nuevas
+     * en Fase 2 (ver doc §10).
+     *
+     * El factory dinámico `TransactionProcessorFactory.getMarketplaceInstance`
+     * deriva el token del binding desde aquí (`MEX_<X>` →
+     * `BenefitsMarketplace<X>TransactionService`). La regex impone el contrato
+     * y permite que el factory falle con 400 en lugar de 500 si llega algo
+     * fuera de la convención.
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    @Matches(/^MEX_[A-Z][A-Z_]*$/, {
+        message: "productCatalogId debe seguir el formato MEX_<UPPER_SNAKE>",
+    })
+    productCatalogId!: string;
+
+    /**
+     * Idempotency key generada por la **app** (UUID por intento).
+     * Lo consume el decorador `@IdempotencyController` del procesador para
+     * deduplicar reintentos del cliente.
+     *
+     * Distinto de `BenefitPaymentRequest.transactionNumber` que el procesador
+     * genera internamente al crear la transacción y envía al marketplace y
+     * al conector como idempotency key del lado del proveedor. La app NO
+     * debe generar `transactionNumber` — por eso este DTO no lo expone.
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    idempotencyKey!: string;
+
+    /**
+     * Monto en unidad mayor de la moneda (no centavos). Como mucho 2 decimales.
+     * El `Max` cap es defensivo — atrapa errores obvios (montos absurdos por
+     * bugs de UI) sin restringir casos legítimos. Ajustar si la operatoria
+     * requiere techos mayores.
+     */
+    @IsNumber({maxDecimalPlaces: 2})
+    @IsPositive()
+    @Max(1_000_000)
+    amount!: number;
+
+    /** ISO numeric (3 chars). Ej: "484" (MXN), "840" (USD). */
+    @IsString()
+    @Matches(/^\d{3}$/, {
+        message: "currencyId debe ser ISO numérico de 3 dígitos",
+    })
+    currencyId!: string;
+
+    // Campos del Centro de Beneficios — first-class, no opcionales
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    benefitId!: string;
+
+    /**
+     * `leafId = base64url("<moduleName>::<idServicio>")`. Convención
+     * cross-componente del Centro (ver
+     * `docs/favorites/05b-favoritos-ligados-a-producto.md`). La regex
+     * enforce el charset base64url sin tener que decodificar acá.
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(256)
+    @Matches(/^[A-Za-z0-9_-]+$/, {
+        message: "leafId debe estar codificado en base64url (charset A-Za-z0-9_-)",
+    })
+    leafId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    productId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(128)
+    reference!: string;
+
+    /**
+     * Decide a qué conector apuntar dentro del marketplace. Va concatenado
+     * a la URL `POST /pay/{moduleName}` del marketplace privado. La regex
+     * restringe a charset seguro (kebab-case minúsculas), previene
+     * inyecciones de path y matchea la convención de naming de los
+     * lambdas Fiado.
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(128)
+    @Matches(/^[a-z][a-z0-9-]*$/, {
+        message: "moduleName debe ser kebab-case minúsculas",
+    })
+    moduleName!: string;
+
+    /** Inputs dinámicos del leaf — opcionales según el servicio. */
+    @IsOptional()
+    @IsObject()
+    inputs?: Record<string, string | number | boolean>;
+
+    @IsOptional()
+    @IsLatitude()
+    latitude?: number;
+
+    @IsOptional()
+    @IsLongitude()
+    longitude?: number;
+}

package/src/benefitCenter/dtos/BackofficeInputLabelsUpdateRequest.ts

@@ -1,16 +1,16 @@
-import { IsNotEmpty, IsObject } from "class-validator";
-
-/**
- * Body de PUT /backoffice/leaves/{leafId}/input-labels.
- *
- * Override de los `label` del inputSchema, keyed por `key` de campo
- * (ej. `{ "phoneNumber": "Tu número Telcel" }`). El conector guarda el map y
- * lo aplica al construir el schema; los campos sin override mantienen el label
- * generado.
- */
-export class BackofficeInputLabelsUpdateRequest {
-    /** Map fieldKey → label. Los valores deben ser strings. */
-    @IsObject()
-    @IsNotEmpty()
-    labels!: Record<string, string>;
-}
+import { IsNotEmpty, IsObject } from "class-validator";
+
+/**
+ * Body de PUT /backoffice/leaves/{leafId}/input-labels.
+ *
+ * Override de los `label` del inputSchema, keyed por `key` de campo
+ * (ej. `{ "phoneNumber": "Tu número Telcel" }`). El conector guarda el map y
+ * lo aplica al construir el schema; los campos sin override mantienen el label
+ * generado.
+ */
+export class BackofficeInputLabelsUpdateRequest {
+    /** Map fieldKey → label. Los valores deben ser strings. */
+    @IsObject()
+    @IsNotEmpty()
+    labels!: Record<string, string>;
+}

package/src/benefitCenter/dtos/BackofficeLeafCreateRequest.ts

@@ -1,90 +1,90 @@
-import {
-    ArrayNotEmpty,
-    IsArray,
-    IsBoolean,
-    IsEnum,
-    IsInt,
-    IsNotEmpty,
-    IsOptional,
-    IsString,
-    Min,
-    ValidateNested,
-} from "class-validator";
-import { Type } from "class-transformer";
-import { Provider } from "../../provider/enums/Provider";
-import { BackofficeProductCreateItem } from "./BackofficeProductCreateItem";
-
-/**
- * Body de POST /backoffice/leaves — alta manual de un servicio nuevo en el
- * catálogo, en forma estándar. bmb rutea por `provider` al conector destino,
- * que traduce a su forma nativa y persiste.
- *
- * `serviceId` (idServicio) y los `productId` vienen del Excel del proveedor
- * (ids reales). Si el `serviceId` ya existe → 409 (no sobrescribe).
- */
-export class BackofficeLeafCreateRequest {
-    /** Determina el conector destino (STP vs multicomm). */
-    @IsEnum(Provider)
-    provider!: Provider;
-
-    /** "ben-3" (recargas) | "ben-6" (pagos). */
-    @IsString()
-    @IsNotEmpty()
-    benefitId!: string;
-
-    /** idServicio real del proveedor (del Excel). */
-    @IsString()
-    @IsNotEmpty()
-    serviceId!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    serviceName!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    category!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    subcategory!: string;
-
-    /** Código de moneda ISO (ej. "MXN", "USD"). */
-    @IsString()
-    @IsNotEmpty()
-    currency!: string;
-
-    /** Código ISO numérico del país destino (ej. "484"). */
-    @IsString()
-    @IsNotEmpty()
-    countryId!: string;
-
-    /** Logo del servicio (→ logoSrc). */
-    @IsOptional()
-    @IsString()
-    logo?: string;
-
-    /** Orden del servicio dentro de su subcategoría. Default 1. */
-    @IsOptional()
-    @IsInt()
-    @Min(0)
-    serviceOrder?: number;
-
-    /** Orden de la subcategoría. Default 1. */
-    @IsOptional()
-    @IsInt()
-    @Min(0)
-    subcategoryOrder?: number;
-
-    /** Habilitado en el catálogo público. Default true. */
-    @IsOptional()
-    @IsBoolean()
-    enabled?: boolean;
-
-    /** Productos del servicio (≥1). */
-    @IsArray()
-    @ArrayNotEmpty()
-    @ValidateNested({ each: true })
-    @Type(() => BackofficeProductCreateItem)
-    products!: BackofficeProductCreateItem[];
-}
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsInt,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    Min,
+    ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { Provider } from "../../provider/enums/Provider";
+import { BackofficeProductCreateItem } from "./BackofficeProductCreateItem";
+
+/**
+ * Body de POST /backoffice/leaves — alta manual de un servicio nuevo en el
+ * catálogo, en forma estándar. bmb rutea por `provider` al conector destino,
+ * que traduce a su forma nativa y persiste.
+ *
+ * `serviceId` (idServicio) y los `productId` vienen del Excel del proveedor
+ * (ids reales). Si el `serviceId` ya existe → 409 (no sobrescribe).
+ */
+export class BackofficeLeafCreateRequest {
+    /** Determina el conector destino (STP vs multicomm). */
+    @IsEnum(Provider)
+    provider!: Provider;
+
+    /** "ben-3" (recargas) | "ben-6" (pagos). */
+    @IsString()
+    @IsNotEmpty()
+    benefitId!: string;
+
+    /** idServicio real del proveedor (del Excel). */
+    @IsString()
+    @IsNotEmpty()
+    serviceId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    serviceName!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    category!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    subcategory!: string;
+
+    /** Código de moneda ISO (ej. "MXN", "USD"). */
+    @IsString()
+    @IsNotEmpty()
+    currency!: string;
+
+    /** Código ISO numérico del país destino (ej. "484"). */
+    @IsString()
+    @IsNotEmpty()
+    countryId!: string;
+
+    /** Logo del servicio (→ logoSrc). */
+    @IsOptional()
+    @IsString()
+    logo?: string;
+
+    /** Orden del servicio dentro de su subcategoría. Default 1. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    serviceOrder?: number;
+
+    /** Orden de la subcategoría. Default 1. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    subcategoryOrder?: number;
+
+    /** Habilitado en el catálogo público. Default true. */
+    @IsOptional()
+    @IsBoolean()
+    enabled?: boolean;
+
+    /** Productos del servicio (≥1). */
+    @IsArray()
+    @ArrayNotEmpty()
+    @ValidateNested({ each: true })
+    @Type(() => BackofficeProductCreateItem)
+    products!: BackofficeProductCreateItem[];
+}