@hed-hog/lms 0.0.304 → 0.0.306

package/src/class-group/dto/create-class-group.dto.ts

@@ -0,0 +1,139 @@
+import {
+    IsArray,
+    IsEnum,
+    IsInt,
+    IsISO8601,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    IsUrl,
+    Matches,
+    MaxLength,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+import { Type } from 'class-transformer';
+import {
+  SESSION_RECURRENCE_DAYS,
+  SESSION_RECURRENCE_FREQUENCIES,
+} from './create-session.dto';
+
+export class ClassGroupSessionRecurrenceDto {
+  @IsEnum(SESSION_RECURRENCE_FREQUENCIES)
+  frequency: 'daily' | 'weekly' | 'monthly' | 'yearly';
+
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  @IsOptional()
+  interval?: number;
+
+  @IsISO8601()
+  until: string;
+
+  @IsArray()
+  @IsEnum(SESSION_RECURRENCE_DAYS, { each: true })
+  @IsOptional()
+  daysOfWeek?: Array<'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA' | 'SU'>;
+}
+
+export class ClassGroupSessionTemplateDto {
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  title: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+
+  @IsString()
+  @IsOptional()
+  location?: string;
+
+  @IsString()
+  @IsOptional()
+  @MaxLength(500)
+  meetingUrl?: string;
+
+  @IsString()
+  @IsOptional()
+  @Matches(/^#[0-9a-fA-F]{6}$/)
+  color?: string;
+
+  @ValidateNested()
+  @Type(() => ClassGroupSessionRecurrenceDto)
+  @IsOptional()
+  recurrence?: ClassGroupSessionRecurrenceDto;
+}
+
+export class CreateClassGroupDto {
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(50)
+  code: string;
+
+  @IsInt()
+  @Min(1)
+  courseId: number;
+
+  @IsInt()
+  @Min(1)
+  @IsOptional()
+  instructorId?: number;
+
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  title: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+
+  @IsEnum(['presential', 'online', 'hybrid'])
+  deliveryMode: 'presential' | 'online' | 'hybrid';
+
+  @IsEnum(['open', 'ongoing', 'completed', 'cancelled'])
+  @IsOptional()
+  status?: 'open' | 'ongoing' | 'completed' | 'cancelled';
+
+  @IsISO8601()
+  startDate: string;
+
+  @IsISO8601()
+  @IsOptional()
+  endDate?: string;
+
+  @IsString()
+  @Matches(/^([01]\d|2[0-3]):([0-5]\d)$/)
+  @IsOptional()
+  startTime?: string;
+
+  @IsString()
+  @Matches(/^([01]\d|2[0-3]):([0-5]\d)$/)
+  @IsOptional()
+  endTime?: string;
+
+  @IsString()
+  @IsOptional()
+  weekDays?: string;
+
+  @IsInt()
+  @Min(1)
+  @IsOptional()
+  capacity?: number;
+
+  @IsString()
+  @IsOptional()
+  location?: string;
+
+  @IsUrl({ require_tld: false })
+  @IsOptional()
+  virtualRoomUrl?: string;
+
+  @ValidateNested()
+  @Type(() => ClassGroupSessionTemplateDto)
+  @IsOptional()
+  sessionTemplate?: ClassGroupSessionTemplateDto;
+}

package/src/class-group/dto/create-session.dto.ts

@@ -0,0 +1,102 @@
+import { Type } from 'class-transformer';
+import {
+    ArrayUnique,
+    IsArray,
+    IsEnum,
+    IsISO8601,
+    IsInt,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    Matches,
+    MaxLength,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+
+export const SESSION_RECURRENCE_FREQUENCIES = [
+  'daily',
+  'weekly',
+  'monthly',
+  'yearly',
+] as const;
+
+export const SESSION_RECURRENCE_DAYS = [
+  'MO',
+  'TU',
+  'WE',
+  'TH',
+  'FR',
+  'SA',
+  'SU',
+] as const;
+
+export class SessionRecurrenceDto {
+  @IsEnum(SESSION_RECURRENCE_FREQUENCIES)
+  frequency: 'daily' | 'weekly' | 'monthly' | 'yearly';
+
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  @IsOptional()
+  interval?: number;
+
+  @IsISO8601()
+  until: string;
+
+  @IsArray()
+  @ArrayUnique()
+  @IsEnum(SESSION_RECURRENCE_DAYS, { each: true })
+  @IsOptional()
+  daysOfWeek?: Array<'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA' | 'SU'>;
+}
+
+export class CreateSessionDto {
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  title: string;
+
+  @IsString()
+  @IsOptional()
+  description?: string;
+
+  @IsISO8601()
+  sessionDate: string;
+
+  @IsString()
+  @Matches(/^([01]\d|2[0-3]):([0-5]\d)$/)
+  startTime: string;
+
+  @IsString()
+  @Matches(/^([01]\d|2[0-3]):([0-5]\d)$/)
+  endTime: string;
+
+  @IsString()
+  @IsOptional()
+  location?: string;
+
+  @IsString()
+  @IsOptional()
+  @MaxLength(500)
+  meetingUrl?: string;
+
+  @IsString()
+  @IsOptional()
+  @Matches(/^#[0-9a-fA-F]{6}$/)
+  color?: string;
+
+  @IsEnum(['scheduled', 'completed', 'cancelled'])
+  @IsOptional()
+  status?: 'scheduled' | 'completed' | 'cancelled';
+
+  @IsInt()
+  @Min(1)
+  @IsOptional()
+  instructorId?: number;
+
+  @ValidateNested()
+  @Type(() => SessionRecurrenceDto)
+  @IsOptional()
+  recurrence?: SessionRecurrenceDto;
+}

package/src/class-group/dto/enrollment.dto.ts

@@ -0,0 +1,70 @@
+import {
+    IsArray,
+    IsBoolean,
+    IsEmail,
+    IsInt,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    MaxLength,
+    Min,
+} from 'class-validator';
+
+export class EnrollStudentDto {
+  @IsInt()
+  @Min(1)
+  personId: number;
+}
+
+export class CreateStudentAndEnrollDto {
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  name: string;
+
+  @IsOptional()
+  @IsEmail()
+  @MaxLength(255)
+  email?: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(50)
+  phone?: string;
+}
+
+export class UpdateStudentProfileDto {
+  @IsOptional()
+  @IsString()
+  @IsNotEmpty()
+  @MaxLength(255)
+  name?: string;
+
+  @IsOptional()
+  @IsEmail()
+  @MaxLength(255)
+  email?: string;
+
+  @IsOptional()
+  @IsString()
+  @MaxLength(50)
+  phone?: string;
+}
+
+export class SaveAttendanceDto {
+  @IsArray()
+  attendance: AttendanceEntryDto[];
+}
+
+export class AttendanceEntryDto {
+  @IsInt()
+  @Min(1)
+  studentId: number;
+
+  @IsBoolean()
+  present: boolean;
+
+  @IsString()
+  @IsOptional()
+  justification?: string;
+}

package/src/class-group/dto/update-class-group.dto.ts

@@ -0,0 +1,4 @@
+import { PartialType } from '@nestjs/mapped-types';
+import { CreateClassGroupDto } from './create-class-group.dto';
+
+export class UpdateClassGroupDto extends PartialType(CreateClassGroupDto) {}

package/src/class-group/dto/update-session.dto.ts

@@ -0,0 +1,9 @@
+import { PartialType } from '@nestjs/mapped-types';
+import { IsEnum, IsOptional } from 'class-validator';
+import { CreateSessionDto } from './create-session.dto';
+
+export class UpdateSessionDto extends PartialType(CreateSessionDto) {
+	@IsEnum(['single', 'series'])
+	@IsOptional()
+	applyScope?: 'single' | 'series';
+}

package/src/course/course-structure.controller.ts

@@ -0,0 +1,85 @@
+import { Role } from '@hed-hog/api';
+import {
+  Body,
+  Controller,
+  Delete,
+  Get,
+  Param,
+  ParseIntPipe,
+  Patch,
+  Post,
+} from '@nestjs/common';
+import { CourseStructureService } from './course-structure.service';
+import { CreateCourseStructureLessonDto } from './dto/create-course-structure-lesson.dto';
+import { CreateCourseStructureSessionDto } from './dto/create-course-structure-session.dto';
+import { UpdateCourseStructureLessonDto } from './dto/update-course-structure-lesson.dto';
+import { UpdateCourseStructureSessionDto } from './dto/update-course-structure-session.dto';
+
+@Role()
+@Controller('lms/courses/:id/structure')
+export class CourseStructureController {
+  constructor(private readonly courseStructureService: CourseStructureService) {}
+
+  @Get()
+  getStructure(@Param('id', ParseIntPipe) courseId: number) {
+    return this.courseStructureService.getStructure(courseId);
+  }
+
+  @Post('sessions')
+  createSession(
+    @Param('id', ParseIntPipe) courseId: number,
+    @Body() dto: CreateCourseStructureSessionDto,
+  ) {
+    return this.courseStructureService.createSession(courseId, dto);
+  }
+
+  @Patch('sessions/:sessionId')
+  updateSession(
+    @Param('id', ParseIntPipe) courseId: number,
+    @Param('sessionId', ParseIntPipe) sessionId: number,
+    @Body() dto: UpdateCourseStructureSessionDto,
+  ) {
+    return this.courseStructureService.updateSession(courseId, sessionId, dto);
+  }
+
+  @Delete('sessions/:sessionId')
+  deleteSession(
+    @Param('id', ParseIntPipe) courseId: number,
+    @Param('sessionId', ParseIntPipe) sessionId: number,
+  ) {
+    return this.courseStructureService.deleteSession(courseId, sessionId);
+  }
+
+  @Post('sessions/:sessionId/lessons')
+  createLesson(
+    @Param('id', ParseIntPipe) courseId: number,
+    @Param('sessionId', ParseIntPipe) sessionId: number,
+    @Body() dto: CreateCourseStructureLessonDto,
+  ) {
+    return this.courseStructureService.createLesson(courseId, sessionId, dto);
+  }
+
+  @Patch('sessions/:sessionId/lessons/:lessonId')
+  updateLesson(
+    @Param('id', ParseIntPipe) courseId: number,
+    @Param('sessionId', ParseIntPipe) sessionId: number,
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+    @Body() dto: UpdateCourseStructureLessonDto,
+  ) {
+    return this.courseStructureService.updateLesson(
+      courseId,
+      sessionId,
+      lessonId,
+      dto,
+    );
+  }
+
+  @Delete('sessions/:sessionId/lessons/:lessonId')
+  deleteLesson(
+    @Param('id', ParseIntPipe) courseId: number,
+    @Param('sessionId', ParseIntPipe) sessionId: number,
+    @Param('lessonId', ParseIntPipe) lessonId: number,
+  ) {
+    return this.courseStructureService.deleteLesson(courseId, sessionId, lessonId);
+  }
+}