@hed-hog/lms 0.0.365 → 0.0.370

package/src/platforma/platforma-video.service.ts

@@ -1,5 +1,6 @@
 import { FileService } from '@hed-hog/core';
 import { PrismaService } from '@hed-hog/api-prisma';
+import { balanceSubtitleLines } from '../course/subtitle.util';
 import {
   forwardRef,
   Inject,
@@ -128,6 +129,56 @@ export class PlatformaVideoService {
     stream.pipe(res);
   }
 
+  // ---------------------------------------------------------------------------
+  // Admin preview endpoints (no published check)
+  // ---------------------------------------------------------------------------
+
+  async generateAdminHlsToken(lessonId: number) {
+    const lesson = await this.prisma.course_lesson.findFirst({
+      where: { id: lessonId },
+      select: {
+        id: true,
+        course_lesson_file: {
+          where: { type: 'video_hls', file_id: { not: null } },
+          select: { id: true },
+        },
+      },
+    });
+
+    if (!lesson) throw new NotFoundException('Lesson not found');
+    if (lesson.course_lesson_file.length === 0) throw new NotFoundException('No HLS stream available for this lesson');
+
+    const token = this.jwtService.sign(
+      { lessonId },
+      { secret: process.env.JWT_SECRET, expiresIn: '4h' },
+    );
+
+    return { token, expiresIn: 14400 };
+  }
+
+  async generateAdminSubtitlesToken(lessonId: number, localeId?: number) {
+    const lesson = await this.prisma.course_lesson.findFirst({
+      where: { id: lessonId },
+      select: { id: true },
+    });
+
+    if (!lesson) throw new NotFoundException('Lesson not found');
+
+    const where: Record<string, unknown> = { course_lesson_id: lessonId };
+    if (localeId !== undefined) where['locale_id'] = localeId;
+
+    const count = await (this.prisma as any).course_lesson_transcription_segment.count({ where });
+
+    if (count === 0) throw new NotFoundException('No subtitles available for this lesson');
+
+    const token = this.jwtService.sign(
+      { lessonId, localeId: localeId ?? null, type: 'subtitles' },
+      { secret: process.env.JWT_SECRET, expiresIn: '4h' },
+    );
+
+    return { token, expiresIn: 14400 };
+  }
+
   // ---------------------------------------------------------------------------
   // HLS endpoints
   // ---------------------------------------------------------------------------
@@ -299,18 +350,23 @@ export class PlatformaVideoService {
 
   async serveSubtitles(token: string, res: Response) {
     let lessonId: number;
+    let localeId: number | null | undefined;
     try {
-      const payload = this.jwtService.verify<{ lessonId: number; type: string }>(token, {
+      const payload = this.jwtService.verify<{ lessonId: number; localeId?: number | null; type: string }>(token, {
         secret: process.env.JWT_SECRET,
       });
       if (payload.type !== 'subtitles') throw new Error('Wrong token type');
       lessonId = payload.lessonId;
+      localeId = payload.localeId;
     } catch {
       throw new UnauthorizedException('Invalid or expired subtitles token');
     }
 
+    const where: Record<string, unknown> = { course_lesson_id: lessonId };
+    if (localeId != null) where['locale_id'] = localeId;
+
     const segments = await (this.prisma as any).course_lesson_transcription_segment.findMany({
-      where: { course_lesson_id: lessonId },
+      where,
       orderBy: { start_seconds: 'asc' },
       select: { start_seconds: true, end_seconds: true, text: true },
     });
@@ -339,7 +395,7 @@ export class PlatformaVideoService {
     const cues = segments.map((seg, i) => {
       const start = this.secondsToVttTime(seg.start_seconds);
       const end = this.secondsToVttTime(seg.end_seconds);
-      return `${i + 1}\n${start} --> ${end}\n${seg.text}`;
+      return `${i + 1}\n${start} --> ${end}\n${balanceSubtitleLines(seg.text)}`;
     });
     return `WEBVTT\n\n${cues.join('\n\n')}\n`;
   }

package/src/platforma/platforma.controller.ts

@@ -4,10 +4,18 @@ import { Body, Controller, Delete, Get, Param, ParseIntPipe, Patch, Post, Put, Q
 import type { Request, Response } from 'express';
 import { BitcodeWalletService } from '../bitcode-wallet/bitcode-wallet.service';
 import { CreateCurrentBitcodeWalletTransactionDto } from '../bitcode-wallet/dto/create-current-bitcode-wallet-transaction.dto';
+import { LmsCertificateService } from '../certificate/certificate.service';
+import { UpdateCertificatePublicAccessDto } from '../certificate/dto/update-certificate-public-access.dto';
+import { CourseLessonDiscussionService } from '../course-lesson-discussion/course-lesson-discussion.service';
+import { CreateCourseLessonDiscussionTopicDto } from '../course-lesson-discussion/dto/create-course-lesson-discussion-topic.dto';
 import { EvaluationService } from '../evaluation/evaluation.service';
 import { TrainingStudentService } from '../enterprise/training/training-student.service';
+import { HeartbeatDto } from './dto/heartbeat.dto';
 import { UpdatePlatformaProfileDto } from './dto/update-profile.dto';
+import { PlatformaHeartbeatService } from './platforma-heartbeat.service';
+import { PlatformaPerformanceService } from './platforma-performance.service';
 import { PlatformaService } from './platforma.service';
+import { PlatformaSearchService } from './platforma-search.service';
 import { PlatformaVideoService } from './platforma-video.service';
 
 @NoRole()
@@ -20,6 +28,11 @@ export class PlataformaController {
     private readonly bitcodeWalletService: BitcodeWalletService,
     private readonly platformaVideoService: PlatformaVideoService,
     private readonly evaluationService: EvaluationService,
+    private readonly heartbeatService: PlatformaHeartbeatService,
+    private readonly performanceService: PlatformaPerformanceService,
+    private readonly searchService: PlatformaSearchService,
+    private readonly certificateService: LmsCertificateService,
+    private readonly discussionService: CourseLessonDiscussionService,
   ) {}
 
   @Get()
@@ -54,11 +67,48 @@ export class PlataformaController {
     return this.trainingStudentService.getPublishedCourseBySlug(slug, userId);
   }
 
+  @Get('search')
+  search(
+    @Query('q') q = '',
+    @Query('types') types?: string,
+    @Query('pageSize') pageSize?: string,
+  ) {
+    return this.searchService.search(
+      q,
+      types ? types.split(',').filter(Boolean) : [],
+      pageSize ? Math.max(1, Number(pageSize)) : 5,
+    );
+  }
+
   @Get('lessons/:lessonId')
   getLessonDetail(@Param('lessonId', ParseIntPipe) lessonId: number) {
     return this.trainingStudentService.getLessonDetail(lessonId);
   }
 
+  @Get('lessons/:lessonId/my-answers')
+  getLessonStudentAnswers(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @User('id') userId: number,
+  ) {
+    return this.trainingStudentService.getLessonStudentAnswers(userId, lessonId);
+  }
+
+  @Post('lessons/:lessonId/questions/:questionId/answer')
+  submitLessonAnswer(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @Param('questionId', ParseIntPipe) questionId: number,
+    @User('id') userId: number,
+    @Body() body: { optionId?: number; answerText?: string },
+  ) {
+    return this.trainingStudentService.submitLessonAnswer(
+      userId,
+      lessonId,
+      questionId,
+      body.optionId ?? null,
+      body.answerText ?? null,
+    );
+  }
+
   @Get('lessons/:lessonId/video-token')
   getVideoToken(
     @Param('lessonId', ParseIntPipe) lessonId: number,
@@ -226,6 +276,28 @@ export class PlataformaController {
     return this.bitcodeWalletService.createCurrentUserTransaction(userId, dto);
   }
 
+  @Get('performance/summary')
+  getPerformanceSummary(
+    @User('id') userId: number,
+    @Query('period') period?: string,
+  ) {
+    return this.performanceService.getSummary(userId, period ?? '30d');
+  }
+
+  @Post('heartbeat')
+  heartbeat(
+    @User('id') userId: number,
+    @Body() dto: HeartbeatDto,
+    @Req() req: Request,
+  ) {
+    const ip =
+      (req.headers['x-forwarded-for'] as string)?.split(',')[0]?.trim() ??
+      req.socket?.remoteAddress ??
+      '';
+    const userAgent = (req.headers['user-agent'] as string) ?? '';
+    return this.heartbeatService.enqueue(userId, ip, userAgent, dto);
+  }
+
   @Get('profile')
   getProfile(@User('id') userId: number) {
     return this.platforma.getProfile(userId);
@@ -238,4 +310,62 @@ export class PlataformaController {
   ) {
     return this.platforma.updateProfile(userId, dto);
   }
+
+  @Get('certificates')
+  getStudentCertificates(
+    @User('id') userId: number,
+    @Query('page') page?: string,
+    @Query('pageSize') pageSize?: string,
+    @Query('type') type?: string,
+  ) {
+    return this.certificateService.listIssuedForStudent(userId, {
+      page: page ? Number(page) : 1,
+      pageSize: pageSize ? Number(pageSize) : 12,
+      type,
+    });
+  }
+
+  @Patch('certificates/:id/public-access')
+  updateStudentCertificateAccess(
+    @User('id') userId: number,
+    @Param('id', ParseIntPipe) id: number,
+    @Body() dto: UpdateCertificatePublicAccessDto,
+  ) {
+    return this.certificateService.updatePublicAccessForStudent(userId, id, dto.publicAccess);
+  }
+
+  @Get('lessons/:lessonId/discussion/topics')
+  listDiscussionTopics(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @User('id') userId: number,
+  ) {
+    return this.discussionService.listTopics(lessonId, userId);
+  }
+
+  @Post('lessons/:lessonId/discussion/topics')
+  createDiscussionTopic(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @User('id') userId: number,
+    @Body() dto: CreateCourseLessonDiscussionTopicDto,
+  ) {
+    return this.discussionService.createTopic(lessonId, userId, dto);
+  }
+
+  @Post('lessons/:lessonId/discussion/topics/:topicId/likes')
+  likeDiscussionTopic(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @Param('topicId', ParseIntPipe) topicId: number,
+    @User('id') userId: number,
+  ) {
+    return this.discussionService.likeTopic(lessonId, topicId, userId);
+  }
+
+  @Delete('lessons/:lessonId/discussion/topics/:topicId/likes')
+  unlikeDiscussionTopic(
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @Param('topicId', ParseIntPipe) topicId: number,
+    @User('id') userId: number,
+  ) {
+    return this.discussionService.unlikeTopic(lessonId, topicId, userId);
+  }
 }

package/src/realtime/lms-realtime.controller.ts

@@ -1,4 +1,5 @@
-import { Controller, Get } from '@nestjs/common';
+import { Controller, Get, Req, Res } from '@nestjs/common';
+import type { Request, Response } from 'express';
 import { LmsRealtimeCursor, LmsRealtimeService } from './lms-realtime.service';
 
 @Controller('lms/realtime')
@@ -9,4 +10,29 @@ export class LmsRealtimeController {
   getCursor(): LmsRealtimeCursor {
     return this.lmsRealtime.getCursor();
   }
+
+  @Get('activity/stream')
+  streamActivity(@Req() req: Request, @Res() res: Response) {
+    res.set({
+      'Content-Type': 'text/event-stream',
+      'Cache-Control': 'no-cache',
+      Connection: 'keep-alive',
+      'X-Accel-Buffering': 'no',
+    });
+    res.flushHeaders();
+
+    const unsub = this.lmsRealtime.subscribe((event) => {
+      if (event.domain === 'lesson_view') {
+        res.write(`data: ${JSON.stringify(event)}\n\n`);
+      }
+    });
+
+    // Send a heartbeat every 25s to keep the connection alive through proxies
+    const heartbeat = setInterval(() => res.write(': ping\n\n'), 25_000);
+
+    req.on('close', () => {
+      clearInterval(heartbeat);
+      unsub();
+    });
+  }
 }

package/src/realtime/lms-realtime.service.ts

@@ -8,7 +8,8 @@ export type LmsRealtimeDomain =
   | 'exam_attempt'
   | 'enterprise'
   | 'instructor'
-  | 'achievement';
+  | 'achievement'
+  | 'lesson_view';
 
 export type LmsRealtimeEventType =
   | 'created'

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

@@ -31,6 +31,28 @@ export class LearningPathItemDto {
   isRequired?: boolean;
 }
 
+export class LearningPathModuleDto {
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  title: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+
+  @IsInt()
+  @Min(0)
+  @IsOptional()
+  order?: number;
+
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => LearningPathItemDto)
+  @IsOptional()
+  items?: LearningPathItemDto[];
+}
+
 export class CreateTrainingDto {
   @IsString()
   @IsNotEmpty()
@@ -82,4 +104,18 @@ export class CreateTrainingDto {
   @IsOptional()
   @MaxLength(32)
   secondaryColor?: string;
+
+  @IsInt()
+  @IsOptional()
+  bannerFileId?: number | null;
+
+  @IsInt()
+  @IsOptional()
+  certificateTemplateId?: number | null;
+
+  @IsArray()
+  @ValidateNested({ each: true })
+  @Type(() => LearningPathModuleDto)
+  @IsOptional()
+  modules?: LearningPathModuleDto[];
 }