@fiado/type-kit 3.581.0 → 3.582.0

package/_test_/unit/retailOrg/dtos/retailerIntegrationMode.test.ts

@@ -0,0 +1,106 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    ActivateRetailerIntegrationRequest,
+    ActivateRetailerIntegrationResponse,
+    RetailIntegrationModeEnum,
+    RetailIntegrationSystemEnum,
+    Retailer,
+    RetailerStatusEnum,
+    RetailerTypeEnum,
+    RetailerValidationDto,
+    SetRetailerIntegrationModeRequest,
+} from '../../../../src/retailOrg/index';
+
+const base = {
+    retailerId: 'ret_001',
+    parentId: 'ROOT',
+    type: RetailerTypeEnum.CHAIN,
+    name: 'Tiendas del Centro',
+    legalName: 'Tiendas del Centro SA de CV',
+    rfc: 'VEN123456ABC',
+    contactEmail: 'contacto@tdc.mx',
+    contactPhone: '+525512345678',
+    address: { city: 'CDMX', region: 'CDMX', zipCode: '01000' },
+    status: RetailerStatusEnum.ACTIVE,
+    createdAt: '2026-07-14T10:00:00.000Z',
+    updatedAt: '2026-07-14T10:00:00.000Z',
+    createdBy: 'user_1',
+    updatedBy: 'user_1',
+};
+const errorsOf = async <T extends object>(cls: new () => T, plain: object) =>
+    (await validate(plainToInstance(cls, plain))).map(e => e.property);
+
+describe('RetailIntegrationModeEnum', () => {
+    it('trae SOFT y FULL', () => {
+        expect(Object.values(RetailIntegrationModeEnum)).toEqual(['SOFT', 'FULL']);
+    });
+});
+
+describe('Retailer.integrationMode', () => {
+    it('es opcional', async () => {
+        expect(await errorsOf(Retailer, base)).toEqual([]);
+    });
+
+    it('acepta un modo del enum', async () => {
+        expect(await errorsOf(Retailer, { ...base, integrationMode: 'FULL' })).toEqual([]);
+    });
+
+    it('rechaza un modo fuera del enum', async () => {
+        expect(await errorsOf(Retailer, { ...base, integrationMode: 'HARD' })).toContain('integrationMode');
+    });
+});
+
+describe('RetailerValidationDto.integrationMode', () => {
+    it('admite el modo opcional', () => {
+        const dto: RetailerValidationDto = {
+            retailerId: 'ret_001', name: 'x', type: RetailerTypeEnum.CHAIN, status: RetailerStatusEnum.ACTIVE, parentId: 'ROOT',
+            integrationMode: RetailIntegrationModeEnum.SOFT,
+        };
+        expect(dto.integrationMode).toBe('SOFT');
+    });
+});
+
+describe('ActivateRetailerIntegrationRequest.integrationMode', () => {
+    it('es opcional', async () => {
+        expect(await errorsOf(ActivateRetailerIntegrationRequest, { integrationSystem: 'ZENTRAL' })).toEqual([]);
+    });
+
+    it('acepta un modo del enum y lo expone', async () => {
+        const req = plainToInstance(ActivateRetailerIntegrationRequest, { integrationSystem: 'ZENTRAL', integrationMode: 'FULL' }, { excludeExtraneousValues: true });
+        expect(req.integrationMode).toBe(RetailIntegrationModeEnum.FULL);
+        expect(await validate(req)).toEqual([]);
+    });
+
+    it('rechaza un modo fuera del enum', async () => {
+        expect(await errorsOf(ActivateRetailerIntegrationRequest, { integrationSystem: 'ZENTRAL', integrationMode: 'HARD' })).toContain('integrationMode');
+    });
+});
+
+describe('ActivateRetailerIntegrationResponse.integrationMode', () => {
+    it('incluye el modo opcional', () => {
+        const response = plainToInstance(Retailer, {
+            ...base, integrationSystem: RetailIntegrationSystemEnum.ZENTRAL, integrationActivatedAt: '2026-10-25T10:00:00.000Z',
+            integrationActivatedBy: 'user_1', integrationMode: 'SOFT',
+        }) as ActivateRetailerIntegrationResponse;
+        expect(response.integrationMode).toBe(RetailIntegrationModeEnum.SOFT);
+    });
+});
+
+describe('SetRetailerIntegrationModeRequest', () => {
+    it('acepta SOFT y FULL', async () => {
+        expect(await errorsOf(SetRetailerIntegrationModeRequest, { integrationMode: 'SOFT' })).toEqual([]);
+        expect(await errorsOf(SetRetailerIntegrationModeRequest, { integrationMode: 'FULL' })).toEqual([]);
+    });
+
+    it('exige integrationMode dentro del enum', async () => {
+        expect(await errorsOf(SetRetailerIntegrationModeRequest, {})).toContain('integrationMode');
+        expect(await errorsOf(SetRetailerIntegrationModeRequest, { integrationMode: 'HARD' })).toContain('integrationMode');
+    });
+
+    it('expone integrationMode con excludeExtraneousValues', () => {
+        const req = plainToInstance(SetRetailerIntegrationModeRequest, { integrationMode: 'FULL', extra: 1 }, { excludeExtraneousValues: true });
+        expect(req).toEqual({ integrationMode: 'FULL' });
+    });
+});

package/bin/retailOrg/dtos/Retailer.d.ts

@@ -1,6 +1,7 @@
 import { LocationAddress } from '../../address/dtos/LocationAddress';
 import { RetailerStatusEnum } from '../enums/RetailerStatusEnum';
 import { RetailerTypeEnum } from '../enums/RetailerTypeEnum';
+import { RetailIntegrationModeEnum } from '../enums/RetailIntegrationModeEnum';
 import { RetailIntegrationSystemEnum } from '../enums/RetailIntegrationSystemEnum';
 /**
  * Retailer — nodo raíz de la organización comercial SureKeep (cadena / subdistribuidor / franquicia).
@@ -32,4 +33,6 @@ export declare class Retailer {
     integrationSystem?: RetailIntegrationSystemEnum;
     integrationActivatedAt?: string;
     integrationActivatedBy?: string;
+    /** Modo de integración; ausente si el retailer no está integrado. */
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/bin/retailOrg/dtos/Retailer.js

@@ -16,6 +16,7 @@ const LocationAddress_1 = require("../../address/dtos/LocationAddress");
 const regex_1 = require("../../helpers/constans/regex");
 const RetailerStatusEnum_1 = require("../enums/RetailerStatusEnum");
 const RetailerTypeEnum_1 = require("../enums/RetailerTypeEnum");
+const RetailIntegrationModeEnum_1 = require("../enums/RetailIntegrationModeEnum");
 const RetailIntegrationSystemEnum_1 = require("../enums/RetailIntegrationSystemEnum");
 /**
  * Retailer — nodo raíz de la organización comercial SureKeep (cadena / subdistribuidor / franquicia).
@@ -122,3 +123,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], Retailer.prototype, "integrationActivatedBy", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RetailIntegrationModeEnum_1.RetailIntegrationModeEnum),
+    __metadata("design:type", String)
+], Retailer.prototype, "integrationMode", void 0);

package/bin/retailOrg/dtos/requests/ActivateRetailerIntegrationRequest.d.ts

@@ -1,5 +1,8 @@
+import { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
 import { RetailIntegrationSystemEnum } from '../../enums/RetailIntegrationSystemEnum';
 /** Body de POST /retailers/:retailerId/integration/activate. */
 export declare class ActivateRetailerIntegrationRequest {
     integrationSystem: RetailIntegrationSystemEnum;
+    /** Si no viene, el back usa SOFT. */
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/bin/retailOrg/dtos/requests/ActivateRetailerIntegrationRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActivateRetailerIntegrationRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const RetailIntegrationModeEnum_1 = require("../../enums/RetailIntegrationModeEnum");
 const RetailIntegrationSystemEnum_1 = require("../../enums/RetailIntegrationSystemEnum");
 /** Body de POST /retailers/:retailerId/integration/activate. */
 class ActivateRetailerIntegrationRequest {
@@ -22,3 +23,9 @@ __decorate([
     (0, class_validator_1.IsEnum)(RetailIntegrationSystemEnum_1.RetailIntegrationSystemEnum),
     __metadata("design:type", String)
 ], ActivateRetailerIntegrationRequest.prototype, "integrationSystem", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RetailIntegrationModeEnum_1.RetailIntegrationModeEnum),
+    __metadata("design:type", String)
+], ActivateRetailerIntegrationRequest.prototype, "integrationMode", void 0);

package/bin/retailOrg/dtos/requests/SetRetailerIntegrationModeRequest.d.ts

@@ -0,0 +1,5 @@
+import { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
+/** Body del endpoint que cambia el modo de integración de un retailer ya integrado. */
+export declare class SetRetailerIntegrationModeRequest {
+    integrationMode: RetailIntegrationModeEnum;
+}

package/bin/retailOrg/dtos/requests/SetRetailerIntegrationModeRequest.js

@@ -0,0 +1,24 @@
+"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.SetRetailerIntegrationModeRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RetailIntegrationModeEnum_1 = require("../../enums/RetailIntegrationModeEnum");
+/** Body del endpoint que cambia el modo de integración de un retailer ya integrado. */
+class SetRetailerIntegrationModeRequest {
+}
+exports.SetRetailerIntegrationModeRequest = SetRetailerIntegrationModeRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(RetailIntegrationModeEnum_1.RetailIntegrationModeEnum),
+    __metadata("design:type", String)
+], SetRetailerIntegrationModeRequest.prototype, "integrationMode", void 0);

package/bin/retailOrg/dtos/validation/RetailerValidationDto.d.ts

@@ -1,5 +1,6 @@
 import type { RetailerStatusEnum } from '../../enums/RetailerStatusEnum';
 import type { RetailerTypeEnum } from '../../enums/RetailerTypeEnum';
+import type { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
 import type { RetailIntegrationSystemEnum } from '../../enums/RetailIntegrationSystemEnum';
 /**
  * Shape mínimo que devuelve el endpoint privado de validación de retailer (consumido por otros
@@ -15,4 +16,5 @@ export interface RetailerValidationDto {
     /** Bandera «integrado»; ausente si el retailer no está integrado. */
     integrationSystem?: RetailIntegrationSystemEnum;
     integrationActivatedAt?: string;
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/bin/retailOrg/enums/RetailIntegrationModeEnum.d.ts

@@ -0,0 +1,5 @@
+/** Alcance de la revisión contra el sistema externo: SOFT solo aplica altas y cambios, nunca bajas; FULL aplica todo. */
+export declare enum RetailIntegrationModeEnum {
+    SOFT = "SOFT",
+    FULL = "FULL"
+}

package/bin/retailOrg/enums/RetailIntegrationModeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailIntegrationModeEnum = void 0;
+/** Alcance de la revisión contra el sistema externo: SOFT solo aplica altas y cambios, nunca bajas; FULL aplica todo. */
+var RetailIntegrationModeEnum;
+(function (RetailIntegrationModeEnum) {
+    RetailIntegrationModeEnum["SOFT"] = "SOFT";
+    RetailIntegrationModeEnum["FULL"] = "FULL";
+})(RetailIntegrationModeEnum || (exports.RetailIntegrationModeEnum = RetailIntegrationModeEnum = {}));

package/bin/retailOrg/index.d.ts

@@ -7,6 +7,7 @@ export * from './enums/EmploymentTypeEnum';
 export * from './enums/CollectorSeniorityEnum';
 export * from './enums/RetailUserWalletLinkMethodEnum';
 export * from './enums/RetailIntegrationSystemEnum';
+export * from './enums/RetailIntegrationModeEnum';
 export * from './enums/GoalTargetTypeEnum';
 export * from './dtos/GeoLocation';
 export * from './dtos/GoalAmounts';
@@ -46,6 +47,7 @@ export * from './dtos/requests/PrivateGoalListQuery';
 export * from './dtos/requests/KpiQuery';
 export * from './dtos/requests/PrivateSellerListQuery';
 export * from './dtos/requests/ActivateRetailerIntegrationRequest';
+export * from './dtos/requests/SetRetailerIntegrationModeRequest';
 export * from './dtos/responses/RetailerHierarchyResponse';
 export * from './dtos/responses/GoalListResponse';
 export * from './dtos/responses/GoalUpsertResponse';

package/bin/retailOrg/index.js

@@ -23,6 +23,7 @@ __exportStar(require("./enums/EmploymentTypeEnum"), exports);
 __exportStar(require("./enums/CollectorSeniorityEnum"), exports);
 __exportStar(require("./enums/RetailUserWalletLinkMethodEnum"), exports);
 __exportStar(require("./enums/RetailIntegrationSystemEnum"), exports);
+__exportStar(require("./enums/RetailIntegrationModeEnum"), exports);
 // F3 — Portal Admin VentasLuga (metas de venta del periodo)
 __exportStar(require("./enums/GoalTargetTypeEnum"), exports);
 // Entity DTOs
@@ -69,6 +70,7 @@ __exportStar(require("./dtos/requests/PrivateGoalListQuery"), exports);
 __exportStar(require("./dtos/requests/KpiQuery"), exports);
 __exportStar(require("./dtos/requests/PrivateSellerListQuery"), exports);
 __exportStar(require("./dtos/requests/ActivateRetailerIntegrationRequest"), exports);
+__exportStar(require("./dtos/requests/SetRetailerIntegrationModeRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/RetailerHierarchyResponse"), exports);
 __exportStar(require("./dtos/responses/GoalListResponse"), exports);

package/package.json

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

package/src/retailOrg/dtos/Retailer.ts

@@ -4,6 +4,7 @@ import { LocationAddress } from '../../address/dtos/LocationAddress';
 import { regexIso8601 } from '../../helpers/constans/regex';
 import { RetailerStatusEnum } from '../enums/RetailerStatusEnum';
 import { RetailerTypeEnum } from '../enums/RetailerTypeEnum';
+import { RetailIntegrationModeEnum } from '../enums/RetailIntegrationModeEnum';
 import { RetailIntegrationSystemEnum } from '../enums/RetailIntegrationSystemEnum';
 
 /**
@@ -96,4 +97,10 @@ export class Retailer {
     @IsOptional()
     @IsString()
     integrationActivatedBy?: string;
+
+    /** Modo de integración; ausente si el retailer no está integrado. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(RetailIntegrationModeEnum)
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/src/retailOrg/dtos/requests/ActivateRetailerIntegrationRequest.ts

@@ -1,5 +1,6 @@
 import { Expose } from 'class-transformer';
-import { IsEnum } from 'class-validator';
+import { IsEnum, IsOptional } from 'class-validator';
+import { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
 import { RetailIntegrationSystemEnum } from '../../enums/RetailIntegrationSystemEnum';
 
 /** Body de POST /retailers/:retailerId/integration/activate. */
@@ -7,4 +8,10 @@ export class ActivateRetailerIntegrationRequest {
     @Expose()
     @IsEnum(RetailIntegrationSystemEnum)
     integrationSystem!: RetailIntegrationSystemEnum;
+
+    /** Si no viene, el back usa SOFT. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(RetailIntegrationModeEnum)
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/src/retailOrg/dtos/requests/SetRetailerIntegrationModeRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
+
+/** Body del endpoint que cambia el modo de integración de un retailer ya integrado. */
+export class SetRetailerIntegrationModeRequest {
+    @Expose()
+    @IsEnum(RetailIntegrationModeEnum)
+    integrationMode!: RetailIntegrationModeEnum;
+}

package/src/retailOrg/dtos/validation/RetailerValidationDto.ts

@@ -1,5 +1,6 @@
 import type { RetailerStatusEnum } from '../../enums/RetailerStatusEnum';
 import type { RetailerTypeEnum } from '../../enums/RetailerTypeEnum';
+import type { RetailIntegrationModeEnum } from '../../enums/RetailIntegrationModeEnum';
 import type { RetailIntegrationSystemEnum } from '../../enums/RetailIntegrationSystemEnum';
 
 /**
@@ -16,4 +17,5 @@ export interface RetailerValidationDto {
     /** Bandera «integrado»; ausente si el retailer no está integrado. */
     integrationSystem?: RetailIntegrationSystemEnum;
     integrationActivatedAt?: string;
+    integrationMode?: RetailIntegrationModeEnum;
 }

package/src/retailOrg/enums/RetailIntegrationModeEnum.ts

@@ -0,0 +1,5 @@
+/** Alcance de la revisión contra el sistema externo: SOFT solo aplica altas y cambios, nunca bajas; FULL aplica todo. */
+export enum RetailIntegrationModeEnum {
+    SOFT = 'SOFT',
+    FULL = 'FULL',
+}

package/src/retailOrg/index.ts

@@ -7,6 +7,7 @@ export * from './enums/EmploymentTypeEnum';
 export * from './enums/CollectorSeniorityEnum';
 export * from './enums/RetailUserWalletLinkMethodEnum';
 export * from './enums/RetailIntegrationSystemEnum';
+export * from './enums/RetailIntegrationModeEnum';
 // F3 — Portal Admin VentasLuga (metas de venta del periodo)
 export * from './enums/GoalTargetTypeEnum';
 
@@ -58,6 +59,7 @@ export * from './dtos/requests/PrivateGoalListQuery';
 export * from './dtos/requests/KpiQuery';
 export * from './dtos/requests/PrivateSellerListQuery';
 export * from './dtos/requests/ActivateRetailerIntegrationRequest';
+export * from './dtos/requests/SetRetailerIntegrationModeRequest';
 
 // Response DTOs
 export * from './dtos/responses/RetailerHierarchyResponse';