@fiado/type-kit 3.440.0 → 3.441.0

package/bin/remittance/dtos/RemittanceBackofficeStats.d.ts

@@ -1,4 +1,11 @@
-export type RemittanceBackofficeStatsPeriod = "TODAY" | "WEEK" | "MONTH";
+/** `RANGE` = rango explícito (`from`/`to`) pedido con RemittanceBackofficeStatsRangeRequest. */
+export type RemittanceBackofficeStatsPeriod = "TODAY" | "WEEK" | "MONTH" | "RANGE";
+/** Rango explícito para las stats del backoffice (instantes ISO). `tzOffsetMinutes` = desfase del operador para agrupar por día. */
+export declare class RemittanceBackofficeStatsRangeRequest {
+    from: string;
+    to: string;
+    tzOffsetMinutes?: number;
+}
 export declare class RemittanceBackofficeStatsBucket {
     txCount: number;
     volumeUSD: number;
@@ -20,6 +27,8 @@ export declare class RemittanceBackofficeStatusBucket extends RemittanceBackoffi
 export declare class RemittanceBackofficeStats {
     period: RemittanceBackofficeStatsPeriod;
     from: string;
+    /** Fin del rango (exclusivo). Solo con `period = "RANGE"`. */
+    to?: string;
     totalTxs: number;
     volumeUSD: number;
     totalFeesUSD: number;

package/bin/remittance/dtos/RemittanceBackofficeStats.js

@@ -1,6 +1,35 @@
 "use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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.RemittanceBackofficeStats = exports.RemittanceBackofficeStatusBucket = exports.RemittanceBackofficeDayBucket = exports.RemittanceBackofficeCountryBucket = exports.RemittanceBackofficeStatsBucket = void 0;
+exports.RemittanceBackofficeStats = exports.RemittanceBackofficeStatusBucket = exports.RemittanceBackofficeDayBucket = exports.RemittanceBackofficeCountryBucket = exports.RemittanceBackofficeStatsBucket = exports.RemittanceBackofficeStatsRangeRequest = void 0;
+const class_validator_1 = require("class-validator");
+/** Rango explícito para las stats del backoffice (instantes ISO). `tzOffsetMinutes` = desfase del operador para agrupar por día. */
+class RemittanceBackofficeStatsRangeRequest {
+}
+exports.RemittanceBackofficeStatsRangeRequest = RemittanceBackofficeStatsRangeRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceBackofficeStatsRangeRequest.prototype, "from", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceBackofficeStatsRangeRequest.prototype, "to", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], RemittanceBackofficeStatsRangeRequest.prototype, "tzOffsetMinutes", void 0);
 class RemittanceBackofficeStatsBucket {
 }
 exports.RemittanceBackofficeStatsBucket = RemittanceBackofficeStatsBucket;

package/bin/remittance/dtos/RemittanceBeneficiary.d.ts

@@ -15,6 +15,17 @@ export interface RemittanceBeneficiaryAddress {
     stateName?: string;
     zipCode?: string;
 }
+/** Campo adicional del payer registrado con el beneficiario (p. ej. tipo de cuenta): claves de UniTeller + etiquetas del catálogo. */
+export interface RemittanceBeneficiaryAdditionalField {
+    name: string;
+    value: string;
+    label?: string;
+    valueLabel?: string;
+    options?: Array<{
+        key: string;
+        label: string;
+    }>;
+}
 export declare class RemittanceBeneficiary {
     beneficiaryId: string;
     firstName: string;
@@ -33,7 +44,12 @@ export declare class RemittanceBeneficiary {
     accNumberLastFour?: string;
     address?: RemittanceBeneficiaryAddress;
     status: RemittanceBeneficiaryStatus;
+    /** Campos adicionales del payer. `undefined` = no resueltos todavía; `[]` = el payer no exige ninguno. */
+    additionalFields?: RemittanceBeneficiaryAdditionalField[];
     lastUsedAt?: string;
     createdAt: string;
     updatedAt: string;
+    /** Quién lo creó / actualizó: "USER" (app) o "BACKOFFICE:<email>". */
+    createdBy?: string;
+    updatedBy?: string;
 }

package/bin/remittance/dtos/RemittanceKyc.d.ts

@@ -92,6 +92,8 @@ export declare class KycOnboardingAttempt {
     rejectionMessage: string | null;
     request: Record<string, unknown> | null;
     response: Record<string, unknown> | null;
+    /** "BACKOFFICE:<email>" cuando el reintento salió del backoffice; ausente o null desde la app. */
+    initiatedBy?: string | null;
 }
 /** Historial de intentos de onboarding de un usuario (orden descendente por `at`). */
 export declare class KycOnboardingAttemptsResponse {

package/bin/remittance/dtos/RemittanceOnboardRequest.d.ts

@@ -20,4 +20,6 @@ export declare class RemittanceOnboardRequest {
     agreementLocale?: "EN" | "ES";
     privacyPolicyAgreement: "YES";
     userIPAddress?: string;
+    /** Quién dispara el registro cuando no es el usuario (p. ej. "BACKOFFICE:<email>"); queda en el intento. */
+    initiatedBy?: string;
 }

package/bin/remittance/dtos/RemittanceOnboardRequest.js

@@ -89,3 +89,8 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], RemittanceOnboardRequest.prototype, "userIPAddress", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RemittanceOnboardRequest.prototype, "initiatedBy", void 0);

package/bin/remittance/dtos/RemittanceOnboardingPrefill.d.ts

@@ -0,0 +1,25 @@
+import { RemittanceAddress } from "./RemittanceAddress";
+import { RemittanceOnboardRequest } from "./RemittanceOnboardRequest";
+import { RemittanceCountryISO } from "../enums/RemittanceCountryISO";
+/** Pide a benefits la composición del onboarding de un usuario sin ejecutarla (backoffice · reintento de registro). */
+export declare class RemittanceOnboardingPrefillRequest {
+    directoryId: string;
+    destinationCountryISOCode?: RemittanceCountryISO;
+    agreementLocale?: "EN" | "ES";
+}
+/** Motivo por el que la composición no se completó (mismos códigos que el bloqueo del onboarding). */
+export interface RemittanceOnboardingPrefillBlock {
+    code: string;
+    message: string;
+}
+/** Lo que la app mandaría hoy, tal cual lo arma benefits, más las direcciones US candidatas si la principal no sirve. */
+export declare class RemittanceOnboardingPrefillResponse {
+    /** Request completo cuando se pudo componer; null si hubo `block`. */
+    request: RemittanceOnboardRequest | null;
+    /** Con `block`, lo que sí se pudo resolver (nombres, fecha, teléfono, correo). */
+    partial?: Partial<RemittanceOnboardRequest>;
+    block?: RemittanceOnboardingPrefillBlock;
+    /** Direcciones US no borradas del usuario, ya mapeadas, para elegir una a mano. */
+    addressCandidates: RemittanceAddress[];
+    emailVerified: boolean;
+}

package/bin/remittance/dtos/RemittanceOnboardingPrefill.js

@@ -0,0 +1,37 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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.RemittanceOnboardingPrefillResponse = exports.RemittanceOnboardingPrefillRequest = void 0;
+const class_validator_1 = require("class-validator");
+const RemittanceCountryISO_1 = require("../enums/RemittanceCountryISO");
+/** Pide a benefits la composición del onboarding de un usuario sin ejecutarla (backoffice · reintento de registro). */
+class RemittanceOnboardingPrefillRequest {
+}
+exports.RemittanceOnboardingPrefillRequest = RemittanceOnboardingPrefillRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceOnboardingPrefillRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RemittanceCountryISO_1.RemittanceCountryISO),
+    __metadata("design:type", String)
+], RemittanceOnboardingPrefillRequest.prototype, "destinationCountryISOCode", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsIn)(["EN", "ES"]),
+    __metadata("design:type", String)
+], RemittanceOnboardingPrefillRequest.prototype, "agreementLocale", void 0);
+/** Lo que la app mandaría hoy, tal cual lo arma benefits, más las direcciones US candidatas si la principal no sirve. */
+class RemittanceOnboardingPrefillResponse {
+}
+exports.RemittanceOnboardingPrefillResponse = RemittanceOnboardingPrefillResponse;

package/bin/remittance/dtos/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./RemittanceAddress";
 export * from "./RemittanceOnboardRequest";
 export * from "./RemittanceOnboardResponse";
+export * from "./RemittanceOnboardingPrefill";
 export * from "./RemittanceSecurityQuestionsResponse";
 export * from "./RemittanceBeneficiary";
 export * from "./RemittanceAddBeneficiaryRequest";

package/bin/remittance/dtos/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./RemittanceAddress"), exports);
 __exportStar(require("./RemittanceOnboardRequest"), exports);
 __exportStar(require("./RemittanceOnboardResponse"), exports);
+__exportStar(require("./RemittanceOnboardingPrefill"), exports);
 __exportStar(require("./RemittanceSecurityQuestionsResponse"), exports);
 __exportStar(require("./RemittanceBeneficiary"), exports);
 __exportStar(require("./RemittanceAddBeneficiaryRequest"), exports);

package/package.json

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

package/src/remittance/dtos/RemittanceBackofficeStats.ts

@@ -1,4 +1,22 @@
-export type RemittanceBackofficeStatsPeriod = "TODAY" | "WEEK" | "MONTH";
+import { IsInt, IsNotEmpty, IsOptional, IsString } from "class-validator";
+
+/** `RANGE` = rango explícito (`from`/`to`) pedido con RemittanceBackofficeStatsRangeRequest. */
+export type RemittanceBackofficeStatsPeriod = "TODAY" | "WEEK" | "MONTH" | "RANGE";
+
+/** Rango explícito para las stats del backoffice (instantes ISO). `tzOffsetMinutes` = desfase del operador para agrupar por día. */
+export class RemittanceBackofficeStatsRangeRequest {
+    @IsString()
+    @IsNotEmpty()
+    from!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    to!: string;
+
+    @IsOptional()
+    @IsInt()
+    tzOffsetMinutes?: number;
+}
 
 export class RemittanceBackofficeStatsBucket {
     txCount!: number;
@@ -25,6 +43,8 @@ export class RemittanceBackofficeStatusBucket extends RemittanceBackofficeStatsB
 export class RemittanceBackofficeStats {
     period!: RemittanceBackofficeStatsPeriod;
     from!: string;
+    /** Fin del rango (exclusivo). Solo con `period = "RANGE"`. */
+    to?: string;
     totalTxs!: number;
     volumeUSD!: number;
     totalFeesUSD!: number;

package/src/remittance/dtos/RemittanceBeneficiary.ts

@@ -19,6 +19,15 @@ export interface RemittanceBeneficiaryAddress {
     zipCode?: string;
 }
 
+/** Campo adicional del payer registrado con el beneficiario (p. ej. tipo de cuenta): claves de UniTeller + etiquetas del catálogo. */
+export interface RemittanceBeneficiaryAdditionalField {
+    name: string;                                      // clave del campo en UniTeller, p. ej. "accountType"
+    value: string;                                     // clave del valor, p. ej. "CC"
+    label?: string;                                    // etiqueta del campo, p. ej. "Account Type"
+    valueLabel?: string;                               // etiqueta del valor, p. ej. "Checking"
+    options?: Array<{ key: string; label: string }>;  // opciones que ofrecía el payer al resolver
+}
+
 export class RemittanceBeneficiary {
     beneficiaryId!: string;
     firstName!: string;
@@ -37,7 +46,12 @@ export class RemittanceBeneficiary {
     accNumberLastFour?: string;       // se mantiene por compat con consumers previos
     address?: RemittanceBeneficiaryAddress;
     status!: RemittanceBeneficiaryStatus;
+    /** Campos adicionales del payer. `undefined` = no resueltos todavía; `[]` = el payer no exige ninguno. */
+    additionalFields?: RemittanceBeneficiaryAdditionalField[];
     lastUsedAt?: string;
     createdAt!: string;
     updatedAt!: string;
+    /** Quién lo creó / actualizó: "USER" (app) o "BACKOFFICE:<email>". */
+    createdBy?: string;
+    updatedBy?: string;
 }

package/src/remittance/dtos/RemittanceKyc.ts

@@ -101,6 +101,8 @@ export class KycOnboardingAttempt {
     rejectionMessage!: string | null;
     request!: Record<string, unknown> | null;
     response!: Record<string, unknown> | null;
+    /** "BACKOFFICE:<email>" cuando el reintento salió del backoffice; ausente o null desde la app. */
+    initiatedBy?: string | null;
 }
 
 /** Historial de intentos de onboarding de un usuario (orden descendente por `at`). */

package/src/remittance/dtos/RemittanceOnboardRequest.ts

@@ -61,4 +61,9 @@ export class RemittanceOnboardRequest {
     @IsOptional()
     @IsString()
     userIPAddress?: string;
+
+    /** Quién dispara el registro cuando no es el usuario (p. ej. "BACKOFFICE:<email>"); queda en el intento. */
+    @IsOptional()
+    @IsString()
+    initiatedBy?: string;
 }

package/src/remittance/dtos/RemittanceOnboardingPrefill.ts

@@ -0,0 +1,37 @@
+import { IsEnum, IsIn, IsNotEmpty, IsOptional, IsString } from "class-validator";
+import { RemittanceAddress } from "./RemittanceAddress";
+import { RemittanceOnboardRequest } from "./RemittanceOnboardRequest";
+import { RemittanceCountryISO } from "../enums/RemittanceCountryISO";
+
+/** Pide a benefits la composición del onboarding de un usuario sin ejecutarla (backoffice · reintento de registro). */
+export class RemittanceOnboardingPrefillRequest {
+    @IsString()
+    @IsNotEmpty()
+    directoryId!: string;
+
+    @IsOptional()
+    @IsEnum(RemittanceCountryISO)
+    destinationCountryISOCode?: RemittanceCountryISO;
+
+    @IsOptional()
+    @IsIn(["EN", "ES"])
+    agreementLocale?: "EN" | "ES";
+}
+
+/** Motivo por el que la composición no se completó (mismos códigos que el bloqueo del onboarding). */
+export interface RemittanceOnboardingPrefillBlock {
+    code: string;
+    message: string;
+}
+
+/** Lo que la app mandaría hoy, tal cual lo arma benefits, más las direcciones US candidatas si la principal no sirve. */
+export class RemittanceOnboardingPrefillResponse {
+    /** Request completo cuando se pudo componer; null si hubo `block`. */
+    request!: RemittanceOnboardRequest | null;
+    /** Con `block`, lo que sí se pudo resolver (nombres, fecha, teléfono, correo). */
+    partial?: Partial<RemittanceOnboardRequest>;
+    block?: RemittanceOnboardingPrefillBlock;
+    /** Direcciones US no borradas del usuario, ya mapeadas, para elegir una a mano. */
+    addressCandidates!: RemittanceAddress[];
+    emailVerified!: boolean;
+}

package/src/remittance/dtos/index.ts

@@ -1,6 +1,7 @@
 export * from "./RemittanceAddress";
 export * from "./RemittanceOnboardRequest";
 export * from "./RemittanceOnboardResponse";
+export * from "./RemittanceOnboardingPrefill";
 export * from "./RemittanceSecurityQuestionsResponse";
 export * from "./RemittanceBeneficiary";
 export * from "./RemittanceAddBeneficiaryRequest";