@fiado/type-kit 3.386.0 → 3.388.0

package/bin/centralPayments/dtos/ConfirmMicroDepositsRequest.d.ts

@@ -0,0 +1,3 @@
+export declare class ConfirmMicroDepositsRequest {
+    ids: string[];
+}

package/bin/centralPayments/dtos/ConfirmMicroDepositsRequest.js

@@ -0,0 +1,22 @@
+"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.ConfirmMicroDepositsRequest = void 0;
+const class_validator_1 = require("class-validator");
+class ConfirmMicroDepositsRequest {
+}
+exports.ConfirmMicroDepositsRequest = ConfirmMicroDepositsRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], ConfirmMicroDepositsRequest.prototype, "ids", void 0);

package/bin/centralPayments/dtos/ConfirmMicroDepositsResponse.d.ts

@@ -0,0 +1,3 @@
+export declare class ConfirmMicroDepositsResponse {
+    confirmed: number;
+}

package/bin/centralPayments/dtos/ConfirmMicroDepositsResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmMicroDepositsResponse = void 0;
+class ConfirmMicroDepositsResponse {
+}
+exports.ConfirmMicroDepositsResponse = ConfirmMicroDepositsResponse;

package/bin/centralPayments/dtos/GetMicroDepositsResponse.d.ts

@@ -0,0 +1,4 @@
+import { MicroDepositBankGroupDto } from "./MicroDepositBankGroupDto";
+export declare class GetMicroDepositsResponse {
+    banks: MicroDepositBankGroupDto[];
+}

package/bin/centralPayments/dtos/GetMicroDepositsResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetMicroDepositsResponse = void 0;
+class GetMicroDepositsResponse {
+}
+exports.GetMicroDepositsResponse = GetMicroDepositsResponse;

package/bin/centralPayments/dtos/MicroDepositBankGroupDto.d.ts

@@ -0,0 +1,5 @@
+import { MicroDepositDto } from "./MicroDepositDto";
+export declare class MicroDepositBankGroupDto {
+    bankName: string;
+    deposits: MicroDepositDto[];
+}

package/bin/centralPayments/dtos/MicroDepositBankGroupDto.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicroDepositBankGroupDto = void 0;
+class MicroDepositBankGroupDto {
+}
+exports.MicroDepositBankGroupDto = MicroDepositBankGroupDto;

package/bin/centralPayments/dtos/MicroDepositDto.d.ts

@@ -0,0 +1,5 @@
+export declare class MicroDepositDto {
+    id: string;
+    amount: number;
+    currencyCode: string;
+}

package/bin/centralPayments/dtos/MicroDepositDto.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicroDepositDto = void 0;
+class MicroDepositDto {
+}
+exports.MicroDepositDto = MicroDepositDto;

package/bin/centralPayments/enums/MicroDepositStatusEnum.d.ts

@@ -0,0 +1,5 @@
+export declare enum MicroDepositStatusEnum {
+    PENDING = "PENDING",
+    CONFIRMED = "CONFIRMED",
+    SUPERSEDED = "SUPERSEDED"
+}

package/bin/centralPayments/enums/MicroDepositStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicroDepositStatusEnum = void 0;
+var MicroDepositStatusEnum;
+(function (MicroDepositStatusEnum) {
+    MicroDepositStatusEnum["PENDING"] = "PENDING";
+    MicroDepositStatusEnum["CONFIRMED"] = "CONFIRMED";
+    MicroDepositStatusEnum["SUPERSEDED"] = "SUPERSEDED";
+})(MicroDepositStatusEnum || (exports.MicroDepositStatusEnum = MicroDepositStatusEnum = {}));

package/bin/centralPayments/index.d.ts

@@ -9,7 +9,13 @@ export * from './dtos/CentralPaymentsTransactionInfo';
 export * from './dtos/CentralWebhookEventRequest';
 export * from './dtos/WebhookEventItem';
 export * from './dtos/GetEventsSinceResponse';
+export * from './dtos/MicroDepositDto';
+export * from './dtos/MicroDepositBankGroupDto';
+export * from './dtos/GetMicroDepositsResponse';
+export * from './dtos/ConfirmMicroDepositsRequest';
+export * from './dtos/ConfirmMicroDepositsResponse';
 export * from './enums/ServiceStatusEnum';
 export * from './enums/MerchantLocationDistanceUnitEnum';
 export * from './enums/CentralPaymentTransactionTypeEnum';
 export * from './enums/CentralPaymentMetadataTypeEnum';
+export * from './enums/MicroDepositStatusEnum';

package/bin/centralPayments/index.js

@@ -26,8 +26,14 @@ __exportStar(require("./dtos/CentralPaymentsTransactionInfo"), exports);
 __exportStar(require("./dtos/CentralWebhookEventRequest"), exports);
 __exportStar(require("./dtos/WebhookEventItem"), exports);
 __exportStar(require("./dtos/GetEventsSinceResponse"), exports);
+__exportStar(require("./dtos/MicroDepositDto"), exports);
+__exportStar(require("./dtos/MicroDepositBankGroupDto"), exports);
+__exportStar(require("./dtos/GetMicroDepositsResponse"), exports);
+__exportStar(require("./dtos/ConfirmMicroDepositsRequest"), exports);
+__exportStar(require("./dtos/ConfirmMicroDepositsResponse"), exports);
 // central payments enums
 __exportStar(require("./enums/ServiceStatusEnum"), exports);
 __exportStar(require("./enums/MerchantLocationDistanceUnitEnum"), exports);
 __exportStar(require("./enums/CentralPaymentTransactionTypeEnum"), exports);
 __exportStar(require("./enums/CentralPaymentMetadataTypeEnum"), exports);
+__exportStar(require("./enums/MicroDepositStatusEnum"), exports);

package/bin/collection/dtos/CollectRequest.d.ts

@@ -1,3 +1,4 @@
+import { CollectionPricingDto } from './CollectionPricingDto';
 /**
  * Cobro inmediato y síncrono, con el importe ya resuelto por el dominio.
  *
@@ -14,4 +15,9 @@ export declare class CollectRequest {
     productId: string;
     chargeId: string;
     amount: number;
+    /**
+     * Tarifa con la que se cobra este cargo. Ausente, se aplica la configurada para la fuente — que es
+     * lo normal; se manda sólo cuando este cobro tiene condiciones propias.
+     */
+    pricing?: CollectionPricingDto;
 }

package/bin/collection/dtos/CollectRequest.js

@@ -11,6 +11,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CollectRequest = void 0;
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const CollectionPricingDto_1 = require("./CollectionPricingDto");
 /**
  * Cobro inmediato y síncrono, con el importe ya resuelto por el dominio.
  *
@@ -47,3 +49,9 @@ __decorate([
     (0, class_validator_1.IsNumber)(),
     __metadata("design:type", Number)
 ], CollectRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => CollectionPricingDto_1.CollectionPricingDto),
+    __metadata("design:type", CollectionPricingDto_1.CollectionPricingDto)
+], CollectRequest.prototype, "pricing", void 0);

package/bin/collection/dtos/CollectionAttemptDto.d.ts

@@ -1,3 +1,4 @@
+import { CollectionPricingDto } from './CollectionPricingDto';
 import { MechanismType } from '../enums/MechanismType';
 import { CollectionResultStatus } from '../enums/CollectionResultStatus';
 /** Un intento de cobro ejecutado sobre un intent, para el backoffice de monitoreo. */
@@ -11,5 +12,12 @@ export declare class CollectionAttemptDto {
     result?: CollectionResultStatus;
     errorCode?: string;
     errorDetail?: string;
+    /**
+     * La tarifa que se aplicó en ESTE intento. Se guarda por intento y no se deduce de la config
+     * porque la config puede haber cambiado desde entonces, y sin esto no habría forma de reconstruir
+     * con qué comisión se cobró.
+     */
+    pricing?: CollectionPricingDto;
+    collectionCycle?: number;
     createdAt: number;
 }

package/bin/collection/dtos/CollectionAttemptDto.js

@@ -11,6 +11,8 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CollectionAttemptDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const CollectionPricingDto_1 = require("./CollectionPricingDto");
 const MechanismType_1 = require("../enums/MechanismType");
 const CollectionResultStatus_1 = require("../enums/CollectionResultStatus");
 /** Un intento de cobro ejecutado sobre un intent, para el backoffice de monitoreo. */
@@ -57,6 +59,17 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], CollectionAttemptDto.prototype, "errorDetail", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => CollectionPricingDto_1.CollectionPricingDto),
+    __metadata("design:type", CollectionPricingDto_1.CollectionPricingDto)
+], CollectionAttemptDto.prototype, "pricing", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], CollectionAttemptDto.prototype, "collectionCycle", void 0);
 __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)

package/bin/collection/dtos/PendingChargeDto.d.ts

@@ -1,4 +1,5 @@
 import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { CollectionPricingDto } from './CollectionPricingDto';
 /**
  * Un cargo vivo, según el dominio que lleva la deuda.
  *
@@ -8,6 +9,11 @@ import { CurrencyId } from '../../currency/enums/CurrencyId';
  *
  * El desglose (capital, interés, impuesto) es opcional y no participa del cobro: viaja para que el
  * asiento y los reportes puedan reconstruirlo.
+ *
+ * `pricing` sigue el mismo criterio que `amount`: las condiciones comerciales de una cartera las
+ * conoce el dominio, no el motor. Va por cargo y no por producto porque la misma mecánica de cobro
+ * puede tarifarse distinto para un cliente concreto —una promoción, un beneficio, la comisión
+ * perdonada de la primera cuota—. Ausente, el motor aplica la tarifa configurada para la fuente.
  */
 export declare class PendingChargeDto {
     chargeId: string;
@@ -25,5 +31,6 @@ export declare class PendingChargeDto {
     taxAmount?: number;
     outstandingBalance?: number;
     amountCollected?: number;
+    pricing?: CollectionPricingDto;
     metadata?: Record<string, unknown>;
 }

package/bin/collection/dtos/PendingChargeDto.js

@@ -11,7 +11,9 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PendingChargeDto = void 0;
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
 const CurrencyId_1 = require("../../currency/enums/CurrencyId");
+const CollectionPricingDto_1 = require("./CollectionPricingDto");
 /**
  * Un cargo vivo, según el dominio que lleva la deuda.
  *
@@ -21,6 +23,11 @@ const CurrencyId_1 = require("../../currency/enums/CurrencyId");
  *
  * El desglose (capital, interés, impuesto) es opcional y no participa del cobro: viaja para que el
  * asiento y los reportes puedan reconstruirlo.
+ *
+ * `pricing` sigue el mismo criterio que `amount`: las condiciones comerciales de una cartera las
+ * conoce el dominio, no el motor. Va por cargo y no por producto porque la misma mecánica de cobro
+ * puede tarifarse distinto para un cliente concreto —una promoción, un beneficio, la comisión
+ * perdonada de la primera cuota—. Ausente, el motor aplica la tarifa configurada para la fuente.
  */
 class PendingChargeDto {
 }
@@ -90,6 +97,12 @@ __decorate([
     (0, class_validator_1.IsNumber)(),
     __metadata("design:type", Number)
 ], PendingChargeDto.prototype, "amountCollected", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => CollectionPricingDto_1.CollectionPricingDto),
+    __metadata("design:type", CollectionPricingDto_1.CollectionPricingDto)
+], PendingChargeDto.prototype, "pricing", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsObject)(),

package/package.json

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

package/src/centralPayments/dtos/ConfirmMicroDepositsRequest.ts

@@ -0,0 +1,8 @@
+import {ArrayNotEmpty, IsArray, IsString} from "class-validator";
+
+export class ConfirmMicroDepositsRequest {
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({each: true})
+    ids: string[];
+}

package/src/centralPayments/dtos/ConfirmMicroDepositsResponse.ts

@@ -0,0 +1,3 @@
+export class ConfirmMicroDepositsResponse {
+    confirmed: number;
+}

package/src/centralPayments/dtos/GetMicroDepositsResponse.ts

@@ -0,0 +1,5 @@
+import {MicroDepositBankGroupDto} from "./MicroDepositBankGroupDto";
+
+export class GetMicroDepositsResponse {
+    banks: MicroDepositBankGroupDto[];
+}

package/src/centralPayments/dtos/MicroDepositBankGroupDto.ts

@@ -0,0 +1,6 @@
+import {MicroDepositDto} from "./MicroDepositDto";
+
+export class MicroDepositBankGroupDto {
+    bankName: string;
+    deposits: MicroDepositDto[];
+}

package/src/centralPayments/dtos/MicroDepositDto.ts

@@ -0,0 +1,5 @@
+export class MicroDepositDto {
+    id: string;
+    amount: number;
+    currencyCode: string;
+}

package/src/centralPayments/enums/MicroDepositStatusEnum.ts

@@ -0,0 +1,5 @@
+export enum MicroDepositStatusEnum {
+    PENDING = "PENDING",
+    CONFIRMED = "CONFIRMED",
+    SUPERSEDED = "SUPERSEDED"
+}

package/src/centralPayments/index.ts

@@ -11,9 +11,15 @@ export * from './dtos/CentralPaymentsTransactionInfo';
 export * from './dtos/CentralWebhookEventRequest';
 export * from './dtos/WebhookEventItem';
 export * from './dtos/GetEventsSinceResponse';
+export * from './dtos/MicroDepositDto';
+export * from './dtos/MicroDepositBankGroupDto';
+export * from './dtos/GetMicroDepositsResponse';
+export * from './dtos/ConfirmMicroDepositsRequest';
+export * from './dtos/ConfirmMicroDepositsResponse';
 
 // central payments enums
 export * from './enums/ServiceStatusEnum';
 export * from './enums/MerchantLocationDistanceUnitEnum';
 export * from './enums/CentralPaymentTransactionTypeEnum';
 export * from './enums/CentralPaymentMetadataTypeEnum';
+export * from './enums/MicroDepositStatusEnum';

package/src/collection/dtos/CollectRequest.ts

@@ -1,4 +1,6 @@
-import { IsString, IsNumber } from 'class-validator';
+import { IsString, IsNumber, IsOptional, ValidateNested } from 'class-validator';
+import { Type } from 'class-transformer';
+import { CollectionPricingDto } from './CollectionPricingDto';
 
 /**
  * Cobro inmediato y síncrono, con el importe ya resuelto por el dominio.
@@ -16,4 +18,10 @@ export class CollectRequest {
   @IsString() productId!: string;
   @IsString() chargeId!: string;
   @IsNumber() amount!: number;
+
+  /**
+   * Tarifa con la que se cobra este cargo. Ausente, se aplica la configurada para la fuente — que es
+   * lo normal; se manda sólo cuando este cobro tiene condiciones propias.
+   */
+  @IsOptional() @ValidateNested() @Type(() => CollectionPricingDto) pricing?: CollectionPricingDto;
 }

package/src/collection/dtos/CollectionAttemptDto.ts

@@ -1,4 +1,6 @@
-import { IsString, IsInt, IsEnum, IsOptional, IsNumber } from 'class-validator';
+import { IsString, IsInt, IsEnum, IsOptional, IsNumber, ValidateNested } from 'class-validator';
+import { Type } from 'class-transformer';
+import { CollectionPricingDto } from './CollectionPricingDto';
 import { MechanismType } from '../enums/MechanismType';
 import { CollectionResultStatus } from '../enums/CollectionResultStatus';
 
@@ -13,5 +15,13 @@ export class CollectionAttemptDto {
   @IsOptional() @IsEnum(CollectionResultStatus) result?: CollectionResultStatus;
   @IsOptional() @IsString() errorCode?: string;
   @IsOptional() @IsString() errorDetail?: string;
+
+  /**
+   * La tarifa que se aplicó en ESTE intento. Se guarda por intento y no se deduce de la config
+   * porque la config puede haber cambiado desde entonces, y sin esto no habría forma de reconstruir
+   * con qué comisión se cobró.
+   */
+  @IsOptional() @ValidateNested() @Type(() => CollectionPricingDto) pricing?: CollectionPricingDto;
+  @IsOptional() @IsInt() collectionCycle?: number;
   @IsInt() createdAt!: number;                    // epoch ms
 }

package/src/collection/dtos/PendingChargeDto.ts

@@ -1,5 +1,7 @@
-import { IsString, IsInt, IsOptional, IsEnum, IsObject, IsNumber } from 'class-validator';
+import { IsString, IsInt, IsOptional, IsEnum, IsObject, IsNumber, ValidateNested } from 'class-validator';
+import { Type } from 'class-transformer';
 import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { CollectionPricingDto } from './CollectionPricingDto';
 
 /**
  * Un cargo vivo, según el dominio que lleva la deuda.
@@ -10,6 +12,11 @@ import { CurrencyId } from '../../currency/enums/CurrencyId';
  *
  * El desglose (capital, interés, impuesto) es opcional y no participa del cobro: viaja para que el
  * asiento y los reportes puedan reconstruirlo.
+ *
+ * `pricing` sigue el mismo criterio que `amount`: las condiciones comerciales de una cartera las
+ * conoce el dominio, no el motor. Va por cargo y no por producto porque la misma mecánica de cobro
+ * puede tarifarse distinto para un cliente concreto —una promoción, un beneficio, la comisión
+ * perdonada de la primera cuota—. Ausente, el motor aplica la tarifa configurada para la fuente.
  */
 export class PendingChargeDto {
   @IsString() chargeId!: string;          // record_id / INSTALLMENT#n
@@ -27,5 +34,6 @@ export class PendingChargeDto {
   @IsOptional() @IsNumber() taxAmount?: number;
   @IsOptional() @IsNumber() outstandingBalance?: number;
   @IsOptional() @IsNumber() amountCollected?: number;
+  @IsOptional() @ValidateNested() @Type(() => CollectionPricingDto) pricing?: CollectionPricingDto;
   @IsOptional() @IsObject() metadata?: Record<string, unknown>; // por-dominio (fiado_/loanco_interest, imei…)
 }