@hed-hog/operations 0.0.299 → 0.0.301

package/src/operations.controller.ts

@@ -1,182 +1,304 @@
-import { Role, User } from '@hed-hog/api';
-import {
-    Body,
-    Controller,
-    Get,
-    Param,
-    ParseIntPipe,
-    Patch,
-    Post,
-} from '@nestjs/common';
-import { OperationsService } from './operations.service';
-
-@Role()
-@Controller('operations')
-export class OperationsController {
-  constructor(private readonly operationsService: OperationsService) {}
-
-  @Get('dashboard')
-  getDashboard(@User() user) {
-    return this.operationsService.getDashboard(Number(user?.id || 0));
-  }
-
-  @Get('collaborators')
-  listCollaborators(@User() user) {
-    return this.operationsService.listCollaborators(Number(user?.id || 0));
-  }
-
-  @Get('collaborators/me')
-  getMyCollaborator(@User() user) {
-    return this.operationsService.getMyCollaborator(Number(user?.id || 0));
-  }
-
-  @Get('collaborators/:id')
-  getCollaborator(@User() user, @Param('id', ParseIntPipe) id: number) {
-    return this.operationsService.getCollaboratorByIdForUser(
-      Number(user?.id || 0),
-      id
-    );
-  }
-
-  @Get('collaborators/team')
-  getTeam(@User() user) {
-    return this.operationsService.getTeam(Number(user?.id || 0));
-  }
-
-  @Post('collaborators')
-  createCollaborator(@User() user, @Body() data) {
-    return this.operationsService.createCollaborator(Number(user?.id || 0), data);
-  }
-
-  @Patch('collaborators/:id')
-  updateCollaborator(
-    @User() user,
-    @Param('id', ParseIntPipe) id: number,
-    @Body() data
-  ) {
-    return this.operationsService.updateCollaborator(
-      Number(user?.id || 0),
-      id,
-      data
-    );
-  }
-
-  @Get('projects')
-  listProjects(@User() user) {
-    return this.operationsService.listProjects(Number(user?.id || 0));
-  }
-
-  @Get('projects/:id')
-  getProject(@User() user, @Param('id', ParseIntPipe) id: number) {
-    return this.operationsService.getProjectById(Number(user?.id || 0), id);
-  }
-
-  @Post('projects')
-  createProject(@User() user, @Body() data) {
-    return this.operationsService.createProject(Number(user?.id || 0), data);
-  }
-
-  @Patch('projects/:id')
-  updateProject(@User() user, @Param('id', ParseIntPipe) id: number, @Body() data) {
-    return this.operationsService.updateProject(Number(user?.id || 0), id, data);
-  }
-
-  @Get('contracts')
-  listContracts(@User() user) {
-    return this.operationsService.listContracts(Number(user?.id || 0));
-  }
-
-  @Get('contracts/:id')
-  getContract(@User() user, @Param('id', ParseIntPipe) id: number) {
-    return this.operationsService.getContractById(Number(user?.id || 0), id);
-  }
-
-  @Post('contracts')
-  createContract(@User() user, @Body() data) {
-    return this.operationsService.createContract(Number(user?.id || 0), data);
-  }
-
-  @Patch('contracts/:id')
-  updateContract(
-    @User() user,
-    @Param('id', ParseIntPipe) id: number,
-    @Body() data
-  ) {
-    return this.operationsService.updateContract(Number(user?.id || 0), id, data);
-  }
-
-  @Get('timesheets')
-  listTimesheets(@User() user) {
-    return this.operationsService.listTimesheets(Number(user?.id || 0));
-  }
-
-  @Post('timesheets')
-  createTimesheet(@User() user, @Body() data) {
-    return this.operationsService.createTimesheet(Number(user?.id || 0), data);
-  }
-
-  @Patch('timesheets/:id')
-  updateTimesheet(
-    @User() user,
-    @Param('id', ParseIntPipe) id: number,
-    @Body() data
-  ) {
-    return this.operationsService.updateTimesheet(Number(user?.id || 0), id, data);
-  }
-
-  @Post('timesheets/:id/submit')
-  submitTimesheet(@User() user, @Param('id', ParseIntPipe) id: number) {
-    return this.operationsService.submitTimesheet(Number(user?.id || 0), id);
-  }
-
-  @Get('time-off')
-  listTimeOffRequests(@User() user) {
-    return this.operationsService.listTimeOffRequests(Number(user?.id || 0));
-  }
-
-  @Post('time-off')
-  createTimeOffRequest(@User() user, @Body() data) {
-    return this.operationsService.createTimeOffRequest(Number(user?.id || 0), data);
-  }
-
-  @Get('schedule-adjustments')
-  listScheduleAdjustments(@User() user) {
-    return this.operationsService.listScheduleAdjustments(Number(user?.id || 0));
-  }
-
-  @Post('schedule-adjustments')
-  createScheduleAdjustmentRequest(@User() user, @Body() data) {
-    return this.operationsService.createScheduleAdjustmentRequest(
-      Number(user?.id || 0),
-      data
-    );
-  }
-
-  @Get('approvals')
-  listApprovals(@User() user) {
-    return this.operationsService.listApprovals(Number(user?.id || 0));
-  }
-
-  @Post('approvals/:id/approve')
-  approve(@User() user, @Param('id', ParseIntPipe) id: number, @Body() data) {
-    return this.operationsService.approve(Number(user?.id || 0), id, data);
-  }
-
-  @Post('approvals/:id/reject')
-  reject(@User() user, @Param('id', ParseIntPipe) id: number, @Body() data) {
-    return this.operationsService.reject(Number(user?.id || 0), id, data);
-  }
-
-  @Post('integration/examples/accounts-payable')
-  publishAccountsPayableReference(@User() user, @Body() data) {
-    return this.operationsService.publishAccountsPayableReference(
-      Number(user?.id || 0),
-      data,
-    );
-  }
-
-  @Get('team')
-  getSupervisorTeam(@User() user) {
-    return this.operationsService.getTeam(Number(user?.id || 0));
-  }
-}
+import { Role, User } from '@hed-hog/api';
+import {
+    Body,
+    Controller,
+    Delete,
+    Get,
+    Param,
+    ParseIntPipe,
+    Patch,
+    Post,
+} from '@nestjs/common';
+import { OperationsService } from './operations.service';
+
+@Role()
+@Controller('operations')
+export class OperationsController {
+  constructor(private readonly operationsService: OperationsService) {}
+
+  @Get('dashboard')
+  getDashboard(@User() user) {
+    return this.operationsService.getDashboard(Number(user?.id || 0));
+  }
+
+  @Get('collaborators')
+  listCollaborators(@User() user) {
+    return this.operationsService.listCollaborators(Number(user?.id || 0));
+  }
+
+  @Get('collaborators/me')
+  getMyCollaborator(@User() user) {
+    return this.operationsService.getMyCollaborator(Number(user?.id || 0));
+  }
+
+  @Get('collaborators/:id')
+  getCollaborator(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.getCollaboratorByIdForUser(
+      Number(user?.id || 0),
+      id
+    );
+  }
+
+  @Get('collaborators/team')
+  getTeam(@User() user) {
+    return this.operationsService.getTeam(Number(user?.id || 0));
+  }
+
+  @Post('collaborators')
+  createCollaborator(@User() user, @Body() data) {
+    return this.operationsService.createCollaborator(Number(user?.id || 0), data);
+  }
+
+  @Patch('collaborators/:id')
+  updateCollaborator(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.updateCollaborator(
+      Number(user?.id || 0),
+      id,
+      data
+    );
+  }
+
+  @Get('departments')
+  listDepartments(@User() user) {
+    return this.operationsService.listDepartments(Number(user?.id || 0));
+  }
+
+  @Post('departments')
+  createDepartment(@User() user, @Body() data) {
+    return this.operationsService.createDepartment(Number(user?.id || 0), data);
+  }
+
+  @Patch('departments/:id')
+  updateDepartment(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.updateDepartment(Number(user?.id || 0), id, data);
+  }
+
+  @Get('projects')
+  listProjects(@User() user) {
+    return this.operationsService.listProjects(Number(user?.id || 0));
+  }
+
+  @Get('projects/:id')
+  getProject(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.getProjectById(Number(user?.id || 0), id);
+  }
+
+  @Post('projects')
+  createProject(@User() user, @Body() data) {
+    return this.operationsService.createProject(Number(user?.id || 0), data);
+  }
+
+  @Patch('projects/:id')
+  updateProject(@User() user, @Param('id', ParseIntPipe) id: number, @Body() data) {
+    return this.operationsService.updateProject(Number(user?.id || 0), id, data);
+  }
+
+  @Get('contract-templates')
+  listContractTemplates(@User() user) {
+    return this.operationsService.listContractTemplates(Number(user?.id || 0));
+  }
+
+  @Get('contract-templates/:id')
+  getContractTemplate(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.getContractTemplateById(
+      Number(user?.id || 0),
+      id
+    );
+  }
+
+  @Post('contract-templates')
+  createContractTemplate(@User() user, @Body() data) {
+    return this.operationsService.createContractTemplate(
+      Number(user?.id || 0),
+      data
+    );
+  }
+
+  @Patch('contract-templates/:id')
+  updateContractTemplate(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.updateContractTemplate(
+      Number(user?.id || 0),
+      id,
+      data
+    );
+  }
+
+  @Get('contracts')
+  listContracts(@User() user) {
+    return this.operationsService.listContracts(Number(user?.id || 0));
+  }
+
+  @Get('contracts/:id')
+  getContract(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.getContractById(Number(user?.id || 0), id);
+  }
+
+  @Post('contracts/drafts')
+  createContractDraft(@User() user, @Body() data) {
+    return this.operationsService.createContractDraft(Number(user?.id || 0), data);
+  }
+
+  @Post('contracts')
+  createContract(@User() user, @Body() data) {
+    return this.operationsService.createContract(Number(user?.id || 0), data);
+  }
+
+  @Post('contracts/extract-draft')
+  extractContractDraft(@User() user, @Body() data) {
+    return this.operationsService.extractContractDraft(
+      Number(user?.id || 0),
+      data
+    );
+  }
+
+  @Post('contracts/:id/extract-source')
+  extractContractSource(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.extractContractSource(
+      Number(user?.id || 0),
+      id,
+      data
+    );
+  }
+
+  @Post('contracts/:id/generate-content')
+  generateContractContent(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.generateContractContent(
+      Number(user?.id || 0),
+      id,
+      data
+    );
+  }
+
+  @Post('contracts/:id/legal-review')
+  reviewContractLegally(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.reviewContractLegally(
+      Number(user?.id || 0),
+      id,
+      data
+    );
+  }
+
+  @Patch('contracts/:id')
+  updateContract(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.updateContract(Number(user?.id || 0), id, data);
+  }
+
+  @Delete('contracts/:id')
+  removeContract(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.removeContract(Number(user?.id || 0), id);
+  }
+
+  @Post('contracts/:id/generate-pdf')
+  generateContractPdf(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number
+  ) {
+    return this.operationsService.generateContractPdf(
+      Number(user?.id || 0),
+      id
+    );
+  }
+
+  @Get('timesheets')
+  listTimesheets(@User() user) {
+    return this.operationsService.listTimesheets(Number(user?.id || 0));
+  }
+
+  @Post('timesheets')
+  createTimesheet(@User() user, @Body() data) {
+    return this.operationsService.createTimesheet(Number(user?.id || 0), data);
+  }
+
+  @Patch('timesheets/:id')
+  updateTimesheet(
+    @User() user,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() data
+  ) {
+    return this.operationsService.updateTimesheet(Number(user?.id || 0), id, data);
+  }
+
+  @Post('timesheets/:id/submit')
+  submitTimesheet(@User() user, @Param('id', ParseIntPipe) id: number) {
+    return this.operationsService.submitTimesheet(Number(user?.id || 0), id);
+  }
+
+  @Get('time-off')
+  listTimeOffRequests(@User() user) {
+    return this.operationsService.listTimeOffRequests(Number(user?.id || 0));
+  }
+
+  @Post('time-off')
+  createTimeOffRequest(@User() user, @Body() data) {
+    return this.operationsService.createTimeOffRequest(Number(user?.id || 0), data);
+  }
+
+  @Get('schedule-adjustments')
+  listScheduleAdjustments(@User() user) {
+    return this.operationsService.listScheduleAdjustments(Number(user?.id || 0));
+  }
+
+  @Post('schedule-adjustments')
+  createScheduleAdjustmentRequest(@User() user, @Body() data) {
+    return this.operationsService.createScheduleAdjustmentRequest(
+      Number(user?.id || 0),
+      data
+    );
+  }
+
+  @Get('approvals')
+  listApprovals(@User() user) {
+    return this.operationsService.listApprovals(Number(user?.id || 0));
+  }
+
+  @Post('approvals/:id/approve')
+  approve(@User() user, @Param('id', ParseIntPipe) id: number, @Body() data) {
+    return this.operationsService.approve(Number(user?.id || 0), id, data);
+  }
+
+  @Post('approvals/:id/reject')
+  reject(@User() user, @Param('id', ParseIntPipe) id: number, @Body() data) {
+    return this.operationsService.reject(Number(user?.id || 0), id, data);
+  }
+
+  @Post('integration/examples/accounts-payable')
+  publishAccountsPayableReference(@User() user, @Body() data) {
+    return this.operationsService.publishAccountsPayableReference(
+      Number(user?.id || 0),
+      data,
+    );
+  }
+
+  @Get('team')
+  getSupervisorTeam(@User() user) {
+    return this.operationsService.getTeam(Number(user?.id || 0));
+  }
+}

package/src/operations.module.ts

@@ -1,22 +1,26 @@
-import { LocaleModule } from '@hed-hog/api-locale';
-import { PaginationModule } from '@hed-hog/api-pagination';
-import { PrismaModule } from '@hed-hog/api-prisma';
-import { IntegrationModule } from '@hed-hog/core';
-import { forwardRef, Module } from '@nestjs/common';
-import { ConfigModule } from '@nestjs/config';
-import { OperationsController } from './operations.controller';
-import { OperationsService } from './operations.service';
-
-@Module({
-  imports: [
-    ConfigModule.forRoot(),
-    forwardRef(() => PaginationModule),
-    forwardRef(() => PrismaModule),
-    forwardRef(() => LocaleModule),
-    forwardRef(() => IntegrationModule),
-  ],
-  controllers: [OperationsController],
-  providers: [OperationsService],
-  exports: [OperationsService],
-})
-export class OperationsModule {}
+import { LocaleModule } from '@hed-hog/api-locale';
+import { PaginationModule } from '@hed-hog/api-pagination';
+import { PrismaModule } from '@hed-hog/api-prisma';
+import { AiModule, FileModule, IntegrationModule, SettingModule } from '@hed-hog/core';
+import { forwardRef, Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { OperationsController } from './operations.controller';
+import { OperationsProposalSubscriber } from './operations.proposal.subscriber';
+import { OperationsService } from './operations.service';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot(),
+    forwardRef(() => PaginationModule),
+    forwardRef(() => PrismaModule),
+    forwardRef(() => LocaleModule),
+    forwardRef(() => AiModule),
+    forwardRef(() => FileModule),
+    forwardRef(() => IntegrationModule),
+    forwardRef(() => SettingModule),
+  ],
+  controllers: [OperationsController],
+  providers: [OperationsService, OperationsProposalSubscriber],
+  exports: [OperationsService],
+})
+export class OperationsModule {}

package/src/operations.proposal.subscriber.spec.ts

@@ -0,0 +1,121 @@
+/// <reference types="jest" />
+
+import { OperationsProposalSubscriber } from './operations.proposal.subscriber';
+
+describe('OperationsProposalSubscriber', () => {
+  let integrationApi: {
+    subscribeMany: jest.Mock;
+    findLinksBySource: jest.Mock;
+    createLink: jest.Mock;
+  };
+  let operationsService: {
+    createContractFromProposalIntegration: jest.Mock;
+  };
+  let subscriber: OperationsProposalSubscriber;
+
+  beforeEach(() => {
+    integrationApi = {
+      subscribeMany: jest.fn(),
+      findLinksBySource: jest.fn(),
+      createLink: jest.fn().mockResolvedValue(undefined),
+    };
+
+    operationsService = {
+      createContractFromProposalIntegration: jest
+        .fn()
+        .mockResolvedValue({ id: 88, code: 'CTR-088' }),
+    };
+
+    subscriber = new OperationsProposalSubscriber(
+      integrationApi as any,
+      operationsService as any,
+    );
+  });
+
+  afterEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('registers handlers for the proposal approval and conversion flow', () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+
+    expect(subscriptions).toHaveLength(2);
+    expect(subscriptions.map((entry: { eventName: string }) => entry.eventName)).toEqual(
+      expect.arrayContaining([
+        'contact.proposal.convert_requested',
+        'contact.proposal.approved',
+      ]),
+    );
+  });
+
+  it('skips duplicate contract generation when the integration link already exists', async () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+    const convertRequested = subscriptions.find(
+      (entry: { eventName: string }) => entry.eventName === 'contact.proposal.convert_requested',
+    );
+
+    integrationApi.findLinksBySource.mockResolvedValue([
+      {
+        targetModule: 'operations',
+        targetEntityType: 'contract',
+        targetEntityId: '88',
+      },
+    ]);
+
+    await convertRequested.handler({
+      eventName: 'contact.proposal.convert_requested',
+      sourceModule: 'contact',
+      aggregateType: 'proposal',
+      aggregateId: '1001',
+      payload: {
+        proposalId: 1001,
+      },
+    });
+
+    expect(operationsService.createContractFromProposalIntegration).not.toHaveBeenCalled();
+    expect(integrationApi.createLink).not.toHaveBeenCalled();
+  });
+
+  it('creates the integration link after generating a contract draft', async () => {
+    subscriber.onModuleInit();
+
+    const subscriptions = integrationApi.subscribeMany.mock.calls[0][0];
+    const approved = subscriptions.find(
+      (entry: { eventName: string }) => entry.eventName === 'contact.proposal.approved',
+    );
+
+    integrationApi.findLinksBySource.mockResolvedValue([]);
+
+    await approved.handler({
+      eventName: 'contact.proposal.approved',
+      sourceModule: 'contact',
+      aggregateType: 'proposal',
+      aggregateId: '1002',
+      payload: {
+        proposalId: 1002,
+      },
+    });
+
+    expect(operationsService.createContractFromProposalIntegration).toHaveBeenCalledWith({
+      proposalId: 1002,
+    });
+    expect(integrationApi.createLink).toHaveBeenCalledWith(
+      expect.objectContaining({
+        sourceModule: 'contact',
+        sourceEntityType: 'proposal',
+        sourceEntityId: '1002',
+        targetModule: 'operations',
+        targetEntityType: 'contract',
+        targetEntityId: '88',
+        metadata: expect.objectContaining({
+          eventName: 'contact.proposal.approved',
+          contractCode: 'CTR-088',
+        }),
+      }),
+    );
+  });
+});