@fiado/type-kit 3.515.0 → 3.516.0

package/_test_/unit/group/groupOwnerFields.test.ts

@@ -0,0 +1,32 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { GroupCreateRequest, GroupResponse, GroupStatus } from '../../../src/group';
+
+const base = { id: 'TAXMA', name: 'Taxma', status: GroupStatus.ACTIVE };
+
+describe('GroupCreateRequest.ownerDirectoryId', () => {
+    it('es opcional (la carga masiva por CSV no lo manda)', async () => {
+        expect(await validate(plainToInstance(GroupCreateRequest, base))).toEqual([]);
+    });
+    it('acepta un uuid v4', async () => {
+        const dto = plainToInstance(GroupCreateRequest, { ...base, ownerDirectoryId: 'b298ec6b-00b6-487b-b096-f4ac6ac8c91d' });
+        expect(await validate(dto)).toEqual([]);
+    });
+    it('rechaza lo que no es uuid v4', async () => {
+        const errors = await validate(plainToInstance(GroupCreateRequest, { ...base, ownerDirectoryId: 'no-es-uuid' }));
+        expect(errors[0].property).toBe('ownerDirectoryId');
+        expect(errors[0].constraints?.isUuid).toBeDefined();
+    });
+});
+
+describe('GroupResponse.owner', () => {
+    it('admite owner o null', () => {
+        const withOwner: Partial<GroupResponse> = {
+            owner: { agentId: 'AG-1', directoryId: 'DIR-1', name: null, email: null, status: 'ACTIVE' },
+        };
+        const withoutOwner: Partial<GroupResponse> = { owner: null };
+        expect(withOwner.owner?.agentId).toBe('AG-1');
+        expect(withoutOwner.owner).toBeNull();
+    });
+});

package/_test_/unit/referral-business/groupOwnersByGroupIdsDtos.test.ts

@@ -0,0 +1,46 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+    GroupOwnersByGroupIdsRequest,
+    GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH,
+} from '../../../src/referral-business';
+import type { GroupOwnerItem, GroupOwnersByGroupIdsResponse } from '../../../src/referral-business';
+
+describe('GroupOwnersByGroupIdsRequest', () => {
+    it('el tope del lote es 100', () => {
+        expect(GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH).toBe(100);
+    });
+    it('acepta una lista de groupIds', async () => {
+        const dto = plainToInstance(GroupOwnersByGroupIdsRequest, { groupIds: ['FIADO', 'TAXMA'] });
+        expect(await validate(dto)).toEqual([]);
+    });
+    it('acepta la lista vacía', async () => {
+        const dto = plainToInstance(GroupOwnersByGroupIdsRequest, { groupIds: [] });
+        expect(await validate(dto)).toEqual([]);
+    });
+    it('rechaza 101 ids con arrayMaxSize', async () => {
+        const ids = Array.from({ length: 101 }, (_, i) => `G${i}`);
+        const errors = await validate(plainToInstance(GroupOwnersByGroupIdsRequest, { groupIds: ids }));
+        expect(errors[0].property).toBe('groupIds');
+        expect(errors[0].constraints?.arrayMaxSize).toBeDefined();
+    });
+    it('rechaza si groupIds no es arreglo', async () => {
+        const errors = await validate(plainToInstance(GroupOwnersByGroupIdsRequest, { groupIds: 'FIADO' }));
+        expect(errors[0].constraints?.isArray).toBeDefined();
+    });
+    it('rechaza elementos que no son string', async () => {
+        const errors = await validate(plainToInstance(GroupOwnersByGroupIdsRequest, { groupIds: [1] }));
+        expect(errors[0].constraints?.isString).toBeDefined();
+    });
+});
+
+describe('GroupOwnersByGroupIdsResponse', () => {
+    it('es un mapa groupId → GroupOwnerItem', () => {
+        const owner: GroupOwnerItem = {
+            agentId: 'AG-1', directoryId: 'DIR-1', name: 'MARIA DAVALOS', email: 'm@taxma.com', status: 'ACTIVE',
+        };
+        const res: GroupOwnersByGroupIdsResponse = { TAXMA: owner };
+        expect(res.TAXMA.directoryId).toBe('DIR-1');
+    });
+});

package/bin/group/dtos/GroupCreateRequest.d.ts

@@ -5,6 +5,7 @@ export declare class GroupCreateRequest {
     description: string;
     leaderEmail?: string | null;
     leaderDirectoryId?: string | null;
+    ownerDirectoryId?: string;
     status: GroupStatus;
     codeToRefer?: Array<string>;
     uniqueMainDirectory?: string;

package/bin/group/dtos/GroupCreateRequest.js

@@ -44,6 +44,11 @@ __decorate([
     (0, class_transformer_1.Transform)(({ value }) => value ?? null),
     __metadata("design:type", String)
 ], GroupCreateRequest.prototype, "leaderDirectoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)('4'),
+    __metadata("design:type", String)
+], GroupCreateRequest.prototype, "ownerDirectoryId", void 0);
 __decorate([
     (0, class_validator_1.IsEnum)(GroupStatus_1.GroupStatus),
     __metadata("design:type", String)

package/bin/group/dtos/GroupResponse.d.ts

@@ -1,4 +1,5 @@
 import { GroupStatus } from "../enums/GroupStatus";
+import type { GroupOwnerItem } from "../../referral-business/dtos/GroupOwnersByGroupIdsResponse";
 export declare class GroupResponse {
     id: string;
     name: string;
@@ -15,4 +16,5 @@ export declare class GroupResponse {
     imageUrl?: string | null;
     imageUrlSigned?: string | null;
     parentGroupId: string;
+    owner?: GroupOwnerItem | null;
 }

package/bin/referral-business/dtos/GroupOwnersByGroupIdsRequest.d.ts

@@ -0,0 +1,4 @@
+export declare const GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH = 100;
+export declare class GroupOwnersByGroupIdsRequest {
+    groupIds: string[];
+}

package/bin/referral-business/dtos/GroupOwnersByGroupIdsRequest.js

@@ -0,0 +1,25 @@
+"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.GroupOwnersByGroupIdsRequest = exports.GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH = void 0;
+const class_validator_1 = require("class-validator");
+// Tope de groupIds por request del endpoint batch de owners de grupo.
+exports.GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH = 100;
+// Body de POST /private/agents/owners/by-group-ids; la lista vacía es válida y responde {}.
+class GroupOwnersByGroupIdsRequest {
+}
+exports.GroupOwnersByGroupIdsRequest = GroupOwnersByGroupIdsRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(exports.GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], GroupOwnersByGroupIdsRequest.prototype, "groupIds", void 0);

package/bin/referral-business/dtos/GroupOwnersByGroupIdsResponse.d.ts

@@ -0,0 +1,8 @@
+export interface GroupOwnerItem {
+    agentId: string;
+    directoryId: string;
+    name: string | null;
+    email: string | null;
+    status: string;
+}
+export type GroupOwnersByGroupIdsResponse = Record<string, GroupOwnerItem>;

package/bin/referral-business/dtos/GroupOwnersByGroupIdsResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/referral-business/index.d.ts

@@ -1,3 +1,5 @@
 export * from './enums/AgentRoleEnum';
 export * from './dtos/AgentsByDirectoryIdsRequest';
 export * from './dtos/AgentsByDirectoryIdsResponse';
+export * from './dtos/GroupOwnersByGroupIdsRequest';
+export * from './dtos/GroupOwnersByGroupIdsResponse';

package/bin/referral-business/index.js

@@ -19,3 +19,5 @@ __exportStar(require("./enums/AgentRoleEnum"), exports);
 //dtos
 __exportStar(require("./dtos/AgentsByDirectoryIdsRequest"), exports);
 __exportStar(require("./dtos/AgentsByDirectoryIdsResponse"), exports);
+__exportStar(require("./dtos/GroupOwnersByGroupIdsRequest"), exports);
+__exportStar(require("./dtos/GroupOwnersByGroupIdsResponse"), exports);

package/package.json

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

package/src/group/dtos/GroupCreateRequest.ts

@@ -1,4 +1,4 @@
-import {IsEnum, IsNotEmpty, IsOptional, IsString, Length} from "class-validator";
+import {IsEnum, IsNotEmpty, IsOptional, IsString, IsUUID, Length} from "class-validator";
 import {Transform} from "class-transformer";
 import {GroupStatus} from "../enums/GroupStatus";
 
@@ -26,6 +26,12 @@ export class GroupCreateRequest {
     @Transform(({value}) => value ?? null)
     leaderDirectoryId?: string | null;
 
+    // Directorio que será el agente OWNER_<grupo>. Opcional en el DTO porque la carga por CSV no lo trae;
+    // el alta del backoffice lo exige en el controller de group-business.
+    @IsOptional()
+    @IsUUID('4')
+    ownerDirectoryId?: string;
+
     @IsEnum(GroupStatus)
     status: GroupStatus;
 

package/src/group/dtos/GroupResponse.ts

@@ -1,4 +1,5 @@
 import { GroupStatus } from "../enums/GroupStatus"
+import type { GroupOwnerItem } from "../../referral-business/dtos/GroupOwnersByGroupIdsResponse"
 
 
 export class GroupResponse {
@@ -17,6 +18,9 @@ export class GroupResponse {
     imageUrl?: string | null
     imageUrlSigned?: string | null
     parentGroupId: string
+    // Agente OWNER_<grupo> resuelto en vivo desde referral-business. null = sin owner o no se pudo resolver;
+    // ausente = la lectura no lo pidió. Reemplaza a leaderNames/leaderEmail/leaderDirectoryId (ya no se escriben).
+    owner?: GroupOwnerItem | null
 }
 
 

package/src/referral-business/dtos/GroupOwnersByGroupIdsRequest.ts

@@ -0,0 +1,12 @@
+import { ArrayMaxSize, IsArray, IsString } from "class-validator";
+
+// Tope de groupIds por request del endpoint batch de owners de grupo.
+export const GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH = 100;
+
+// Body de POST /private/agents/owners/by-group-ids; la lista vacía es válida y responde {}.
+export class GroupOwnersByGroupIdsRequest {
+    @IsArray()
+    @ArrayMaxSize(GROUP_OWNERS_BY_GROUP_IDS_MAX_BATCH)
+    @IsString({ each: true })
+    groupIds!: string[];
+}

package/src/referral-business/dtos/GroupOwnersByGroupIdsResponse.ts

@@ -0,0 +1,11 @@
+// Agente OWNER_<grupo> de Agents_GT (excluye DELETE; ACTIVE gana). name/email null si no se pudieron resolver.
+export interface GroupOwnerItem {
+    agentId: string;
+    directoryId: string;
+    name: string | null;
+    email: string | null;
+    status: string;
+}
+
+// Respuesta de POST /private/agents/owners/by-group-ids; un grupo sin owner no aparece.
+export type GroupOwnersByGroupIdsResponse = Record<string, GroupOwnerItem>;

package/src/referral-business/index.ts

@@ -4,3 +4,5 @@ export * from './enums/AgentRoleEnum';
 //dtos
 export * from './dtos/AgentsByDirectoryIdsRequest';
 export * from './dtos/AgentsByDirectoryIdsResponse';
+export * from './dtos/GroupOwnersByGroupIdsRequest';
+export * from './dtos/GroupOwnersByGroupIdsResponse';