@hed-hog/lms 0.0.347 → 0.0.350

package/src/course/course.service.ts

@@ -1,6 +1,7 @@
 import { PrismaService } from '@hed-hog/api-prisma';
 import { IntegrationDeveloperApiService } from '@hed-hog/core';
 import { BadRequestException, Inject, Injectable, forwardRef } from '@nestjs/common';
+import { CourseOperationsIntegrationService } from './course-operations-integration.service';
 import { CreateCourseDto } from './dto/create-course.dto';
 import { UpdateCourseDto } from './dto/update-course.dto';
 
@@ -14,6 +15,12 @@ type CourseExtraFields = {
   offering_type?: 'scheduled' | 'on_demand' | 'blended' | null;
 };
 
+type CourseProjectFields = {
+  projectId?: number | null;
+  projectCode?: string | null;
+  projectName?: string | null;
+};
+
 type PersistCourseExtrasInput = {
   name?: string;
   isFeatured?: boolean;
@@ -28,6 +35,7 @@ export class CourseService {
     private readonly prisma: PrismaService,
     @Inject(forwardRef(() => IntegrationDeveloperApiService))
     private readonly integrationApi: IntegrationDeveloperApiService,
+    private readonly operationsIntegration: CourseOperationsIntegrationService,
   ) {}
 
   private normalizeLevel(value?: string | null) {
@@ -200,16 +208,25 @@ export class CourseService {
       this.prisma.course.count({ where }),
     ]);
 
-    const extrasById = await this.getCourseExtras(
-      courses.map((course) => course.id),
-    );
+    const courseIds = courses.map((course) => course.id);
+    const [extrasById, projectLinksById] = await Promise.all([
+      this.getCourseExtras(courseIds),
+      this.operationsIntegration.getCourseProjectLinks(courseIds),
+    ]);
 
     return {
       total,
       page,
       pageSize,
       lastPage: Math.max(1, Math.ceil(total / pageSize)),
-      data: courses.map((c) => this.mapCourse(c, undefined, extrasById.get(c.id))),
+      data: courses.map((c) =>
+        this.mapCourse(
+          c,
+          undefined,
+          extrasById.get(c.id),
+          projectLinksById.get(c.id),
+        ),
+      ),
     };
   }
 
@@ -293,7 +310,10 @@ export class CourseService {
 
     if (!c) return null;
 
-    const extrasById = await this.getCourseExtras([id]);
+    const [extrasById, projectLinksById] = await Promise.all([
+      this.getCourseExtras([id]),
+      this.operationsIntegration.getCourseProjectLinks([id]),
+    ]);
 
     const [lessonCount, sessionCount, certificatesIssued, avgProgress, modules] =
       await Promise.all([
@@ -344,13 +364,18 @@ export class CourseService {
       };
     });
 
-    return this.mapCourse(c, {
-      lessonCount,
-      sessionCount,
-      certificatesIssued,
-      averageCompletion: avgProgress._avg.progress_percent ?? 0,
-      progressByModule,
-    }, extrasById.get(id));
+    return this.mapCourse(
+      c,
+      {
+        lessonCount,
+        sessionCount,
+        certificatesIssued,
+        averageCompletion: avgProgress._avg.progress_percent ?? 0,
+        progressByModule,
+      },
+      extrasById.get(id),
+      projectLinksById.get(id),
+    );
   }
 
   async create(dto: CreateCourseDto) {
@@ -360,12 +385,17 @@ export class CourseService {
       bannerFileId,
       instructorIds,
       certificateModel,
+      operationsProjectId,
       ...data
     } = dto;
     const normalizedSlug = data.slug.trim();
     const resolvedTitle = this.resolveCourseTitle(data.title, normalizedSlug);
     const certificateTemplateId =
       await this.resolveCertificateTemplateId(certificateModel);
+    const resolvedOperationsProjectId =
+      await this.operationsIntegration.resolveOperationsProjectId(
+        operationsProjectId,
+      );
 
     const categories = categorySlugs?.length
       ? await this.prisma.category.findMany({
@@ -491,10 +521,22 @@ export class CourseService {
       ...data,
       offeringType: this.normalizeOfferingType(data.offeringType) ?? 'on_demand',
     });
+    await this.operationsIntegration.persistCourseProjectLink(
+      c.id,
+      resolvedOperationsProjectId ?? null,
+    );
 
-    const extrasById = await this.getCourseExtras([c.id]);
+    const [extrasById, projectLinksById] = await Promise.all([
+      this.getCourseExtras([c.id]),
+      this.operationsIntegration.getCourseProjectLinks([c.id]),
+    ]);
 
-    const result = this.mapCourse(c, undefined, extrasById.get(c.id));
+    const result = this.mapCourse(
+      c,
+      undefined,
+      extrasById.get(c.id),
+      projectLinksById.get(c.id),
+    );
 
     await this.integrationApi.publishEvent({
       eventName: 'lms.course.created',
@@ -514,6 +556,7 @@ export class CourseService {
       bannerFileId,
       instructorIds,
       certificateModel,
+      operationsProjectId,
       ...data
     } = dto;
     let existingSlug: string | undefined;
@@ -538,6 +581,10 @@ export class CourseService {
         : undefined;
     const certificateTemplateId =
       await this.resolveCertificateTemplateId(certificateModel);
+    const resolvedOperationsProjectId =
+      await this.operationsIntegration.resolveOperationsProjectId(
+        operationsProjectId,
+      );
 
     const categories = categorySlugs?.length
       ? await this.prisma.category.findMany({
@@ -682,10 +729,27 @@ export class CourseService {
     });
 
     await this.persistCourseExtras(id, data);
+    if (resolvedOperationsProjectId !== undefined) {
+      await this.operationsIntegration.persistCourseProjectLink(
+        id,
+        resolvedOperationsProjectId,
+      );
+      if (resolvedOperationsProjectId) {
+        await this.operationsIntegration.createMissingTasksForCourseLessons(id);
+      }
+    }
 
-    const extrasById = await this.getCourseExtras([id]);
+    const [extrasById, projectLinksById] = await Promise.all([
+      this.getCourseExtras([id]),
+      this.operationsIntegration.getCourseProjectLinks([id]),
+    ]);
 
-    const updateResult = this.mapCourse(c, undefined, extrasById.get(id));
+    const updateResult = this.mapCourse(
+      c,
+      undefined,
+      extrasById.get(id),
+      projectLinksById.get(id),
+    );
 
     await this.integrationApi.publishEvent({
       eventName: 'lms.course.updated',
@@ -726,6 +790,7 @@ export class CourseService {
       }[];
     },
     extras?: CourseExtraFields,
+    project?: CourseProjectFields,
   ) {
     const resolvedName = extras?.name ?? c.name ?? null;
     const resolvedTitle = this.normalizeOptionalText(c.title) ?? c.slug;
@@ -789,6 +854,9 @@ export class CourseService {
       hasCertificate: extras?.has_certificate ?? c.has_certificate ?? false,
       isListed: extras?.is_listed ?? c.is_listed ?? false,
       offeringType,
+      operationsProjectId: project?.projectId ?? null,
+      operationsProjectCode: project?.projectCode ?? null,
+      operationsProjectName: project?.projectName ?? null,
       enrollmentCount: c._count?.course_enrollment ?? 0,
       moduleCount: c._count?.course_module ?? 0,
       classCount,
@@ -879,37 +947,48 @@ export class CourseService {
     id: number,
     data: PersistCourseExtrasInput,
   ) {
-    const updateData: Record<string, string | boolean> = {};
+    const setClauses: string[] = [];
+    const values: Array<string | boolean | number> = [];
+
+    const pushSetClause = (column: string, value: string | boolean) => {
+      values.push(value);
+      setClauses.push(`${column} = $${values.length}`);
+    };
 
     if (data.name !== undefined) {
-      updateData.name = data.name;
+      pushSetClause('name', data.name);
     }
 
     if (data.isFeatured !== undefined) {
-      updateData.is_featured = data.isFeatured;
+      pushSetClause('is_featured', data.isFeatured);
     }
 
     if (data.hasCertificate !== undefined) {
-      updateData.has_certificate = data.hasCertificate;
+      pushSetClause('has_certificate', data.hasCertificate);
     }
 
     if (data.isListed !== undefined) {
-      updateData.is_listed = data.isListed;
+      pushSetClause('is_listed', data.isListed);
     }
 
     if (data.offeringType !== undefined) {
-      updateData.offering_type = data.offeringType;
+      pushSetClause('offering_type', data.offeringType);
     }
 
-    if (Object.keys(updateData).length === 0) {
+    if (setClauses.length === 0) {
       return;
     }
 
     try {
-      await this.prisma.course.update({
-        where: { id },
-        data: updateData as any,
-      });
+      values.push(id);
+      await this.prisma.$executeRawUnsafe(
+        `
+          UPDATE course
+          SET ${setClauses.join(', ')}
+          WHERE id = $${values.length}
+        `,
+        ...values,
+      );
     } catch {
       // Some environments may still be behind the current course schema.
     }

package/src/course/dto/create-course.dto.ts

@@ -1,3 +1,6 @@
+import {
+    Type,
+} from 'class-transformer';
 import {
     IsArray,
     IsBoolean,
@@ -115,4 +118,9 @@ export class CreateCourseDto {
   @IsInt()
   @IsOptional()
   bannerFileId?: number | null;
+
+  @Type(() => Number)
+  @IsInt()
+  @IsOptional()
+  operationsProjectId?: number | null;
 }

package/src/course/dto/update-course-resources.dto.ts

@@ -0,0 +1,39 @@
+import { Type } from 'class-transformer';
+import {
+    IsArray,
+    IsBoolean,
+    IsInt,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    MaxLength,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+
+class CourseResourceDto {
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  nome: string;
+
+  @IsInt()
+  @Min(1)
+  @IsOptional()
+  fileId?: number;
+
+  @IsString()
+  @IsOptional()
+  tipo?: string;
+
+  @IsBoolean()
+  @IsOptional()
+  publico?: boolean;
+}
+
+export class UpdateCourseResourcesDto {
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => CourseResourceDto)
+  recursos: CourseResourceDto[] = [];
+}

package/src/course-lesson-discussion/course-lesson-discussion.controller.ts

@@ -0,0 +1,55 @@
+import { Role, User } from '@hed-hog/api';
+import {
+  Body,
+  Controller,
+  Delete,
+  Get,
+  Param,
+  ParseIntPipe,
+  Post,
+} from '@nestjs/common';
+import { CreateCourseLessonDiscussionTopicDto } from './dto/create-course-lesson-discussion-topic.dto';
+import { CourseLessonDiscussionService } from './course-lesson-discussion.service';
+
+@Role()
+@Controller('lms/course-lessons/:lessonId/discussion')
+export class CourseLessonDiscussionController {
+  constructor(
+    private readonly discussionService: CourseLessonDiscussionService
+  ) {}
+
+  @Get('topics')
+  listTopics(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @User('id') userId: number
+  ) {
+    return this.discussionService.listTopics(lessonId, userId);
+  }
+
+  @Post('topics')
+  createTopic(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @User('id') userId: number,
+    @Body() dto: CreateCourseLessonDiscussionTopicDto
+  ) {
+    return this.discussionService.createTopic(lessonId, userId, dto);
+  }
+
+  @Post('topics/:topicId/likes')
+  likeTopic(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @Param('topicId', ParseIntPipe) topicId: number,
+    @User('id') userId: number
+  ) {
+    return this.discussionService.likeTopic(lessonId, topicId, userId);
+  }
+
+  @Delete('topics/:topicId/likes')
+  unlikeTopic(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @Param('topicId', ParseIntPipe) topicId: number,
+    @User('id') userId: number
+  ) {
+    return this.discussionService.unlikeTopic(lessonId, topicId, userId);
+  }
+}

package/src/course-lesson-discussion/course-lesson-discussion.mcp-tools.ts

@@ -0,0 +1,75 @@
+import { McpContext, McpTool } from '@hed-hog/core';
+import { Injectable } from '@nestjs/common';
+import { CourseLessonDiscussionService } from './course-lesson-discussion.service';
+
+@Injectable()
+export class LmsCourseLessonDiscussionMcpTools {
+  constructor(private readonly discussionService: CourseLessonDiscussionService) {}
+
+  @McpTool({
+    name: 'lms.lesson-discussion.topics.list',
+    description: 'Lists discussion topics for a course lesson, returned as a thread tree. Requires the authenticated user to be enrolled in the course.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        lessonId: { type: 'number', description: 'Course lesson ID' },
+      },
+      required: ['lessonId'],
+    },
+    readOnly: true,
+  })
+  async listTopics(args: { lessonId: number }, context: McpContext): Promise<any> {
+    return this.discussionService.listTopics(args.lessonId, context.userId);
+  }
+
+  @McpTool({
+    name: 'lms.lesson-discussion.topics.create',
+    description: 'Creates a new discussion topic (or reply) on a course lesson.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        lessonId: { type: 'number', description: 'Course lesson ID' },
+        content: { type: 'string', description: 'Topic content (HTML allowed, scripts stripped)' },
+        playerTimeSeconds: { type: 'number', description: 'Video player timestamp in seconds when the topic was created' },
+        parentTopicId: { type: 'number', description: 'Parent topic ID for replies' },
+      },
+      required: ['lessonId', 'content', 'playerTimeSeconds'],
+    },
+  })
+  async createTopic(args: { lessonId: number; [key: string]: any }, context: McpContext): Promise<any> {
+    const { lessonId, ...dto } = args;
+    return this.discussionService.createTopic(lessonId, context.userId, dto as any);
+  }
+
+  @McpTool({
+    name: 'lms.lesson-discussion.topics.like',
+    description: 'Likes a discussion topic on a course lesson.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        lessonId: { type: 'number', description: 'Course lesson ID' },
+        topicId: { type: 'number', description: 'Topic ID to like' },
+      },
+      required: ['lessonId', 'topicId'],
+    },
+  })
+  async likeTopic(args: { lessonId: number; topicId: number }, context: McpContext): Promise<any> {
+    return this.discussionService.likeTopic(args.lessonId, args.topicId, context.userId);
+  }
+
+  @McpTool({
+    name: 'lms.lesson-discussion.topics.unlike',
+    description: 'Removes the like from a discussion topic on a course lesson.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        lessonId: { type: 'number', description: 'Course lesson ID' },
+        topicId: { type: 'number', description: 'Topic ID to unlike' },
+      },
+      required: ['lessonId', 'topicId'],
+    },
+  })
+  async unlikeTopic(args: { lessonId: number; topicId: number }, context: McpContext): Promise<any> {
+    return this.discussionService.unlikeTopic(args.lessonId, args.topicId, context.userId);
+  }
+}

package/src/course-lesson-discussion/course-lesson-discussion.module.ts

@@ -0,0 +1,13 @@
+import { PrismaModule } from '@hed-hog/api-prisma';
+import { forwardRef, Module } from '@nestjs/common';
+import { CourseLessonDiscussionController } from './course-lesson-discussion.controller';
+import { LmsCourseLessonDiscussionMcpTools } from './course-lesson-discussion.mcp-tools';
+import { CourseLessonDiscussionService } from './course-lesson-discussion.service';
+
+@Module({
+  imports: [forwardRef(() => PrismaModule)],
+  controllers: [CourseLessonDiscussionController],
+  providers: [CourseLessonDiscussionService, LmsCourseLessonDiscussionMcpTools],
+  exports: [CourseLessonDiscussionService],
+})
+export class CourseLessonDiscussionModule {}