@fiado/type-kit 3.637.0 → 3.639.0

package/bin/retailCommission/dtos/CommissionAccrual.d.ts

@@ -85,6 +85,8 @@ export interface CommissionSaleInput {
     /** `CASH` | `CREDIT`, para `PERCENT_BY_PAYMENT`. */
     paymentType: string;
     soldAt: string;
+    /** Cuándo se ganó la comisión: ubica la venta en su corte. Los devengos viejos no lo traen o lo traen en `null` (usar `soldAt`). */
+    earnedAt?: string | null;
     /** Las líneas de la venta. Las ventas que se calculan con reglas siempre las traen. */
     lines?: CommissionSaleLine[];
 }

package/bin/retailCommission/dtos/CommissionApi.d.ts

@@ -1,4 +1,5 @@
 import type { CommissionPlanStatusEnum } from '../enums/CommissionPlanStatusEnum';
+import type { CommissionRuleStatusEnum } from '../enums/CommissionRuleStatusEnum';
 import type { CommissionPayoutStatusEnum } from '../enums/CommissionPayoutStatusEnum';
 import type { CommissionAddOn, CommissionCategory, CommissionPlanSnapshot, CommissionQuota } from './CommissionPlan';
 import type { CommissionAccrual, CommissionAppliedBonus, CommissionSaleInput, CommissionSaleLine } from './CommissionAccrual';
@@ -227,12 +228,74 @@ export interface RuleActionResponse {
     rule: CommissionRule;
     snapshotId: string;
 }
+/** Un campo de la regla que cambió de una versión a la siguiente, con su valor antes y después. */
+export type CommissionRuleChange = {
+    field: 'name';
+    before: string;
+    after: string;
+} | {
+    field: 'description';
+    before: string | null;
+    after: string | null;
+} | {
+    field: 'levers';
+    before: CommissionRuleLevers;
+    after: CommissionRuleLevers;
+} | {
+    field: 'scope';
+    before: CommissionRuleScope;
+    after: CommissionRuleScope;
+} | {
+    field: 'condition';
+    before: CommissionRuleCondition | null;
+    after: CommissionRuleCondition | null;
+} | {
+    field: 'effectiveFrom';
+    before: string;
+    after: string;
+} | {
+    field: 'effectiveTo';
+    before: string | null;
+    after: string | null;
+} | {
+    field: 'priority';
+    before: number;
+    after: number;
+} | {
+    field: 'replacesOthers';
+    before: boolean;
+    after: boolean;
+} | {
+    field: 'countBy';
+    before: CommissionCountByEnum;
+    after: CommissionCountByEnum;
+} | {
+    field: 'payTiming';
+    before: CommissionPayTimingEnum;
+    after: CommissionPayTimingEnum;
+} | {
+    field: 'onSaleAdvanceBps';
+    before: number | null;
+    after: number | null;
+};
 /** Un evento del historial de una regla. */
 export interface CommissionRuleEvent {
     at: string;
     action: string;
     performedBy: string;
     version: number | null;
+    /**
+     * Solo en ediciones: lo que cambió respecto a la versión anterior; vacío si no cambió ningún campo.
+     * Ausente si no hay versión anterior con qué comparar, y en motores anteriores.
+     */
+    changes?: CommissionRuleChange[];
+    /** Junto a `changes`: si la versión editada cuenta piezas o ventas, para leer sus palancas y su condición. */
+    countBy?: CommissionCountByEnum;
+    /** El estado que tenía la regla y el que le dejó el evento; `null` si no lo cambió o no se sabe. Ausente en motores anteriores. */
+    statusChange?: {
+        from: CommissionRuleStatusEnum;
+        to: CommissionRuleStatusEnum;
+    } | null;
 }
 /** `GET /backoffice/commissions/rules/{ruleId}/history` — del más nuevo al más viejo. */
 export interface RuleHistoryResponse {

package/bin/retailWizard/dtos/Sale.d.ts

@@ -97,6 +97,10 @@ export interface Sale {
     cancelledAt: string | null;
     /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
     cancelReason: string | null;
+    /** La comisión espera a que el cliente active su app: contraseña, contrato y número secreto. Ausente si no espera. */
+    commissionAwaitingApp?: boolean;
+    /** ISO; cuándo se ganó la comisión, si el cliente activó su app después de cerrar. Ausente: al cerrar o en espera. */
+    commissionEarnedAt?: string;
     /** Si la venta se puede cancelar hoy y, si no, por qué; solo lo trae el detalle del backoffice. */
     cancellation?: SaleCancellation;
     /**

package/bin/retailWizard/events/RetailCommissionInboundMessage.d.ts

@@ -46,6 +46,11 @@ export declare class RetailCommissionInboundMessage {
     soldAt: string;
     /** soldAt en la venta; cancelledAt en la cancelación. */
     occurredAt: string;
+    /**
+     * Cuándo se ganó la comisión, si el cliente activó su app después de cerrar la venta. Ubica la venta en
+     * su corte. Ausente: se ganó al cerrar (`soldAt`).
+     */
+    earnedAt?: string;
     /** Motivo de la cancelación; puede venir vacío. */
     cancelReason?: string;
     lines: RetailCommissionInboundLine[];

package/bin/retailWizard/events/RetailCommissionInboundMessage.js

@@ -153,6 +153,11 @@ __decorate([
     (0, class_validator_1.IsISO8601)(),
     __metadata("design:type", String)
 ], RetailCommissionInboundMessage.prototype, "occurredAt", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], RetailCommissionInboundMessage.prototype, "earnedAt", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),

package/package.json

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

package/src/retailCommission/dtos/CommissionAccrual.ts

@@ -88,6 +88,8 @@ export interface CommissionSaleInput {
     /** `CASH` | `CREDIT`, para `PERCENT_BY_PAYMENT`. */
     paymentType: string;
     soldAt: string;
+    /** Cuándo se ganó la comisión: ubica la venta en su corte. Los devengos viejos no lo traen o lo traen en `null` (usar `soldAt`). */
+    earnedAt?: string | null;
     /** Las líneas de la venta. Las ventas que se calculan con reglas siempre las traen. */
     lines?: CommissionSaleLine[];
 }

package/src/retailCommission/dtos/CommissionApi.ts

@@ -1,4 +1,5 @@
 import type { CommissionPlanStatusEnum } from '../enums/CommissionPlanStatusEnum';
+import type { CommissionRuleStatusEnum } from '../enums/CommissionRuleStatusEnum';
 import type { CommissionPayoutStatusEnum } from '../enums/CommissionPayoutStatusEnum';
 import type {
     CommissionAddOn,
@@ -295,12 +296,36 @@ export interface RuleActionResponse {
     snapshotId: string;
 }
 
+/** Un campo de la regla que cambió de una versión a la siguiente, con su valor antes y después. */
+export type CommissionRuleChange =
+    | { field: 'name'; before: string; after: string }
+    | { field: 'description'; before: string | null; after: string | null }
+    | { field: 'levers'; before: CommissionRuleLevers; after: CommissionRuleLevers }
+    | { field: 'scope'; before: CommissionRuleScope; after: CommissionRuleScope }
+    | { field: 'condition'; before: CommissionRuleCondition | null; after: CommissionRuleCondition | null }
+    | { field: 'effectiveFrom'; before: string; after: string }
+    | { field: 'effectiveTo'; before: string | null; after: string | null }
+    | { field: 'priority'; before: number; after: number }
+    | { field: 'replacesOthers'; before: boolean; after: boolean }
+    | { field: 'countBy'; before: CommissionCountByEnum; after: CommissionCountByEnum }
+    | { field: 'payTiming'; before: CommissionPayTimingEnum; after: CommissionPayTimingEnum }
+    | { field: 'onSaleAdvanceBps'; before: number | null; after: number | null };
+
 /** Un evento del historial de una regla. */
 export interface CommissionRuleEvent {
     at: string;
     action: string;
     performedBy: string;
     version: number | null;
+    /**
+     * Solo en ediciones: lo que cambió respecto a la versión anterior; vacío si no cambió ningún campo.
+     * Ausente si no hay versión anterior con qué comparar, y en motores anteriores.
+     */
+    changes?: CommissionRuleChange[];
+    /** Junto a `changes`: si la versión editada cuenta piezas o ventas, para leer sus palancas y su condición. */
+    countBy?: CommissionCountByEnum;
+    /** El estado que tenía la regla y el que le dejó el evento; `null` si no lo cambió o no se sabe. Ausente en motores anteriores. */
+    statusChange?: { from: CommissionRuleStatusEnum; to: CommissionRuleStatusEnum } | null;
 }
 
 /** `GET /backoffice/commissions/rules/{ruleId}/history` — del más nuevo al más viejo. */

package/src/retailWizard/dtos/Sale.ts

@@ -98,6 +98,10 @@ export interface Sale {
   cancelledAt: string | null;
   /** Reason OBLIGATORIO en cancelación (AuditTrail) — flujo C. */
   cancelReason: string | null;
+  /** La comisión espera a que el cliente active su app: contraseña, contrato y número secreto. Ausente si no espera. */
+  commissionAwaitingApp?: boolean;
+  /** ISO; cuándo se ganó la comisión, si el cliente activó su app después de cerrar. Ausente: al cerrar o en espera. */
+  commissionEarnedAt?: string;
   /** Si la venta se puede cancelar hoy y, si no, por qué; solo lo trae el detalle del backoffice. */
   cancellation?: SaleCancellation;
   /**

package/src/retailWizard/events/RetailCommissionInboundMessage.ts

@@ -131,6 +131,14 @@ export class RetailCommissionInboundMessage {
     @IsISO8601()
     occurredAt!: string;
 
+    /**
+     * Cuándo se ganó la comisión, si el cliente activó su app después de cerrar la venta. Ubica la venta en
+     * su corte. Ausente: se ganó al cerrar (`soldAt`).
+     */
+    @IsOptional()
+    @IsISO8601()
+    earnedAt?: string;
+
     /** Motivo de la cancelación; puede venir vacío. */
     @IsOptional()
     @IsString()