@hed-hog/lms 0.0.305 → 0.0.306

package/src/class-group/class-group.service.ts

@@ -1,37 +1,37 @@
 import { PrismaService } from '@hed-hog/api-prisma';
-import {
-    BadRequestException,
-    ConflictException,
-    Injectable,
-    NotFoundException,
-} from '@nestjs/common';
-import { Prisma } from '@prisma/client';
-import { PrismaClientKnownRequestError } from '@prisma/client/runtime/library';
-import { randomUUID } from 'node:crypto';
-import {
-  CreateClassGroupDto,
-  type ClassGroupSessionRecurrenceDto,
-  type ClassGroupSessionTemplateDto,
-} from './dto/create-class-group.dto';
-import { CreateSessionDto, type SessionRecurrenceDto } from './dto/create-session.dto';
-import { UpdateClassGroupDto } from './dto/update-class-group.dto';
-import { UpdateSessionDto } from './dto/update-session.dto';
+import {
+    BadRequestException,
+    ConflictException,
+    Injectable,
+    NotFoundException,
+} from '@nestjs/common';
+import { Prisma } from '@prisma/client';
+import { PrismaClientKnownRequestError } from '@prisma/client/runtime/library';
+import { randomUUID } from 'node:crypto';
+import {
+  CreateClassGroupDto,
+  type ClassGroupSessionRecurrenceDto,
+  type ClassGroupSessionTemplateDto,
+} from './dto/create-class-group.dto';
+import { CreateSessionDto, type SessionRecurrenceDto } from './dto/create-session.dto';
+import { UpdateClassGroupDto } from './dto/update-class-group.dto';
+import { UpdateSessionDto } from './dto/update-session.dto';
 
 type SessionScope = 'single' | 'series';
 type SessionRecurrenceDay = 'MO' | 'TU' | 'WE' | 'TH' | 'FR' | 'SA' | 'SU';
 
-type NormalizedSessionRecurrence = {
-  frequency: 'daily' | 'weekly' | 'monthly' | 'yearly';
-  interval: number;
-  until: string;
-  daysOfWeek?: SessionRecurrenceDay[];
-};
-
-type ClassSessionTemplateSummary = {
-  title: string;
-  isRecurring: boolean;
-  recurrence?: NormalizedSessionRecurrence | null;
-};
+type NormalizedSessionRecurrence = {
+  frequency: 'daily' | 'weekly' | 'monthly' | 'yearly';
+  interval: number;
+  until: string;
+  daysOfWeek?: SessionRecurrenceDay[];
+};
+
+type ClassSessionTemplateSummary = {
+  title: string;
+  isRecurring: boolean;
+  recurrence?: NormalizedSessionRecurrence | null;
+};
 
 @Injectable()
 export class ClassGroupService {
@@ -133,7 +133,7 @@ export class ClassGroupService {
     const pageSize = Math.max(Number(params.pageSize) || 12, 1);
     const skip = (page - 1) * pageSize;
 
-    const where: any = {};
+    const where: any = {};
 
     const status = this.normalizeStatus(params.status);
     if (status) {
@@ -230,33 +230,33 @@ export class ClassGroupService {
     };
   }
 
-  async getById(id: number) {
-    const item = await this.prisma.course_class_group.findUnique({
-      where: { id },
-      include: this.getClassGroupInclude(),
-    });
-
-    if (!item) {
-      return null;
-    }
-
-    const sessionTemplateSummary = await this.getClassSessionTemplateSummary(id);
-
-    return {
-      ...this.mapClassGroup(item),
-      sessionTitle: sessionTemplateSummary?.title ?? null,
-      sessionRecurrenceSummary: sessionTemplateSummary
-        ? {
-            ...(sessionTemplateSummary.recurrence ?? {}),
-            isRecurring: sessionTemplateSummary.isRecurring,
-          }
-        : null,
-    };
-  }
-
-  async create(dto: CreateClassGroupDto) {
-    await this.assertCourseExists(dto.courseId);
-    if (dto.instructorId) {
+  async getById(id: number) {
+    const item = await this.prisma.course_class_group.findUnique({
+      where: { id },
+      include: this.getClassGroupInclude(),
+    });
+
+    if (!item) {
+      return null;
+    }
+
+    const sessionTemplateSummary = await this.getClassSessionTemplateSummary(id);
+
+    return {
+      ...this.mapClassGroup(item),
+      sessionTitle: sessionTemplateSummary?.title ?? null,
+      sessionRecurrenceSummary: sessionTemplateSummary
+        ? {
+            ...(sessionTemplateSummary.recurrence ?? {}),
+            isRecurring: sessionTemplateSummary.isRecurring,
+          }
+        : null,
+    };
+  }
+
+  async create(dto: CreateClassGroupDto) {
+    await this.assertCourseExists(dto.courseId);
+    if (dto.instructorId) {
       await this.assertInstructorExists(dto.instructorId);
     }
     this.assertDatesAndTimes({
@@ -264,68 +264,68 @@ export class ClassGroupService {
       endDate: dto.endDate,
       startTime: dto.startTime,
       endTime: dto.endTime,
-    });
-
-    try {
-      const created = await this.prisma.$transaction(async (tx) => {
-        const createdClass = await tx.course_class_group.create({
-          data: {
-            code: dto.code,
-            course_id: dto.courseId,
-            instructor_id: dto.instructorId,
-            title: dto.title,
-            description: dto.description,
-            delivery_mode: dto.deliveryMode,
-            status: dto.status ?? 'open',
-            start_date: new Date(dto.startDate),
-            end_date: dto.endDate ? new Date(dto.endDate) : null,
-            start_time: dto.startTime,
-            end_time: dto.endTime,
-            week_days: dto.weekDays,
-            capacity: dto.capacity ?? 30,
-            location: dto.location,
-            virtual_room_url: dto.virtualRoomUrl,
-          },
-          include: this.getClassGroupInclude(),
-        });
-
-        if (dto.sessionTemplate) {
-          await this.syncClassSessionsFromTemplate(
-            tx,
-            createdClass.id,
-            createdClass,
-            dto.sessionTemplate,
-          );
-        }
-
-        return createdClass;
-      });
-
-      return this.mapClassGroup(created);
-    } catch (error) {
-      this.handlePrismaError(error);
+    });
+
+    try {
+      const created = await this.prisma.$transaction(async (tx) => {
+        const createdClass = await tx.course_class_group.create({
+          data: {
+            code: dto.code,
+            course_id: dto.courseId,
+            instructor_id: dto.instructorId,
+            title: dto.title,
+            description: dto.description,
+            delivery_mode: dto.deliveryMode,
+            status: dto.status ?? 'open',
+            start_date: new Date(dto.startDate),
+            end_date: dto.endDate ? new Date(dto.endDate) : null,
+            start_time: dto.startTime,
+            end_time: dto.endTime,
+            week_days: dto.weekDays,
+            capacity: dto.capacity ?? 30,
+            location: dto.location,
+            virtual_room_url: dto.virtualRoomUrl,
+          },
+          include: this.getClassGroupInclude(),
+        });
+
+        if (dto.sessionTemplate) {
+          await this.syncClassSessionsFromTemplate(
+            tx,
+            createdClass.id,
+            createdClass,
+            dto.sessionTemplate,
+          );
+        }
+
+        return createdClass;
+      });
+
+      return this.mapClassGroup(created);
+    } catch (error) {
+      this.handlePrismaError(error);
     }
   }
 
   async update(id: number, dto: UpdateClassGroupDto) {
     const existing = await this.prisma.course_class_group.findUnique({
       where: { id },
-      select: {
-        id: true,
-        course_id: true,
-        code: true,
-        title: true,
-        description: true,
-        delivery_mode: true,
-        instructor_id: true,
-        start_date: true,
-        end_date: true,
-        start_time: true,
-        end_time: true,
-        location: true,
-        virtual_room_url: true,
-      },
-    });
+      select: {
+        id: true,
+        course_id: true,
+        code: true,
+        title: true,
+        description: true,
+        delivery_mode: true,
+        instructor_id: true,
+        start_date: true,
+        end_date: true,
+        start_time: true,
+        end_time: true,
+        location: true,
+        virtual_room_url: true,
+      },
+    });
 
     if (!existing) {
       throw new NotFoundException('Class not found');
@@ -351,198 +351,198 @@ export class ClassGroupService {
 
     const status =
       dto.status !== undefined ? this.normalizeStatus(dto.status) : undefined;
-    const deliveryMode =
-      dto.deliveryMode !== undefined
-        ? this.normalizeDeliveryMode(dto.deliveryMode)
-        : undefined;
-
-    try {
-      const updated = await this.prisma.$transaction(async (tx) => {
-        const updatedClass = await tx.course_class_group.update({
-          where: { id },
-          data: {
-            ...(dto.code !== undefined && { code: dto.code }),
-            ...(dto.courseId !== undefined && { course_id: dto.courseId }),
-            ...(dto.instructorId !== undefined && {
-              instructor_id: dto.instructorId,
-            }),
-            ...(dto.title !== undefined && { title: dto.title }),
-            ...(dto.description !== undefined && { description: dto.description }),
-            ...(deliveryMode !== undefined && { delivery_mode: deliveryMode }),
-            ...(status !== undefined && { status }),
-            ...(dto.startDate !== undefined && { start_date: new Date(dto.startDate) }),
-            ...(dto.endDate !== undefined && {
-              end_date: dto.endDate ? new Date(dto.endDate) : null,
-            }),
-            ...(dto.startTime !== undefined && { start_time: dto.startTime }),
-            ...(dto.endTime !== undefined && { end_time: dto.endTime }),
-            ...(dto.weekDays !== undefined && { week_days: dto.weekDays }),
-            ...(dto.capacity !== undefined && { capacity: dto.capacity }),
-            ...(dto.location !== undefined && { location: dto.location }),
-            ...(dto.virtualRoomUrl !== undefined && {
-              virtual_room_url: dto.virtualRoomUrl,
-            }),
-          },
-          include: this.getClassGroupInclude(),
-        });
-
-        if (dto.sessionTemplate) {
-          await this.syncClassSessionsFromTemplate(
-            tx,
-            id,
-            updatedClass,
-            dto.sessionTemplate,
-            { futureOnly: true },
-          );
-        }
-
-        return updatedClass;
-      });
-
-      return this.mapClassGroup(updated);
-    } catch (error) {
-      this.handlePrismaError(error);
+    const deliveryMode =
+      dto.deliveryMode !== undefined
+        ? this.normalizeDeliveryMode(dto.deliveryMode)
+        : undefined;
+
+    try {
+      const updated = await this.prisma.$transaction(async (tx) => {
+        const updatedClass = await tx.course_class_group.update({
+          where: { id },
+          data: {
+            ...(dto.code !== undefined && { code: dto.code }),
+            ...(dto.courseId !== undefined && { course_id: dto.courseId }),
+            ...(dto.instructorId !== undefined && {
+              instructor_id: dto.instructorId,
+            }),
+            ...(dto.title !== undefined && { title: dto.title }),
+            ...(dto.description !== undefined && { description: dto.description }),
+            ...(deliveryMode !== undefined && { delivery_mode: deliveryMode }),
+            ...(status !== undefined && { status }),
+            ...(dto.startDate !== undefined && { start_date: new Date(dto.startDate) }),
+            ...(dto.endDate !== undefined && {
+              end_date: dto.endDate ? new Date(dto.endDate) : null,
+            }),
+            ...(dto.startTime !== undefined && { start_time: dto.startTime }),
+            ...(dto.endTime !== undefined && { end_time: dto.endTime }),
+            ...(dto.weekDays !== undefined && { week_days: dto.weekDays }),
+            ...(dto.capacity !== undefined && { capacity: dto.capacity }),
+            ...(dto.location !== undefined && { location: dto.location }),
+            ...(dto.virtualRoomUrl !== undefined && {
+              virtual_room_url: dto.virtualRoomUrl,
+            }),
+          },
+          include: this.getClassGroupInclude(),
+        });
+
+        if (dto.sessionTemplate) {
+          await this.syncClassSessionsFromTemplate(
+            tx,
+            id,
+            updatedClass,
+            dto.sessionTemplate,
+            { futureOnly: true },
+          );
+        }
+
+        return updatedClass;
+      });
+
+      return this.mapClassGroup(updated);
+    } catch (error) {
+      this.handlePrismaError(error);
+    }
+  }
+
+  async remove(id: number) {
+    await this.prisma.course_class_group.delete({ where: { id } });
+    return { success: true };
+  }
+
+  private async getClassSessionTemplateSummary(
+    classGroupId: number,
+  ): Promise<ClassSessionTemplateSummary | null> {
+    const today = this.getSessionMutationFloorDate();
+    const session =
+      (await this.prisma.course_class_session.findFirst({
+        where: {
+          course_class_group_id: classGroupId,
+          session_date: { gte: today },
+          status: { notIn: ['completed', 'cancelled'] },
+        },
+        orderBy: [{ session_date: 'asc' }, { occurrence_index: 'asc' }],
+        select: {
+          title: true,
+          recurrence_rule: true,
+          recurrence_id: true,
+        },
+      })) ??
+      (await this.prisma.course_class_session.findFirst({
+        where: { course_class_group_id: classGroupId },
+        orderBy: [{ session_date: 'asc' }, { occurrence_index: 'asc' }],
+        select: {
+          title: true,
+          recurrence_rule: true,
+          recurrence_id: true,
+        },
+      }));
+
+    if (!session) {
+      return null;
+    }
+
+    return {
+      title: session.title,
+      recurrence: this.parseRecurrenceRule(session.recurrence_rule),
+      isRecurring: Boolean(session.recurrence_id),
+    };
+  }
+
+  private getSessionMutationFloorDate() {
+    return this.normalizeSessionDate(new Date());
+  }
+
+  private buildClassSessionDto(
+    classGroup: any,
+    sessionTemplate: ClassGroupSessionTemplateDto,
+  ): CreateSessionDto {
+    if (!classGroup.start_date) {
+      throw new BadRequestException('Class start date is required to generate sessions');
+    }
+
+    if (!classGroup.start_time || !classGroup.end_time) {
+      throw new BadRequestException('Class start and end times are required to generate sessions');
     }
+
+    const deliveryMode = classGroup.delivery_mode;
+    const isOnline = deliveryMode === 'online';
+    const isHybrid = deliveryMode === 'hybrid';
+
+    return {
+      title: sessionTemplate.title.trim(),
+      description: sessionTemplate.description ?? classGroup.description ?? undefined,
+      sessionDate: this.toDateKey(this.normalizeSessionDate(classGroup.start_date)),
+      startTime: classGroup.start_time,
+      endTime: classGroup.end_time,
+      location:
+        isOnline && !isHybrid
+          ? undefined
+          : sessionTemplate.location ?? classGroup.location ?? undefined,
+      meetingUrl:
+        !isOnline && !isHybrid
+          ? undefined
+          : sessionTemplate.meetingUrl ?? classGroup.virtual_room_url ?? undefined,
+      color: sessionTemplate.color ?? undefined,
+      status: 'scheduled',
+      instructorId: classGroup.instructor_id ?? undefined,
+      recurrence: sessionTemplate.recurrence
+        ? this.toSessionRecurrenceDto(sessionTemplate.recurrence)
+        : undefined,
+    };
+  }
+
+  private toSessionRecurrenceDto(
+    recurrence: ClassGroupSessionRecurrenceDto,
+  ): SessionRecurrenceDto {
+    return {
+      frequency: recurrence.frequency,
+      interval: recurrence.interval,
+      until: recurrence.until,
+      daysOfWeek: recurrence.daysOfWeek,
+    };
   }
 
-  async remove(id: number) {
-    await this.prisma.course_class_group.delete({ where: { id } });
-    return { success: true };
-  }
-
-  private async getClassSessionTemplateSummary(
-    classGroupId: number,
-  ): Promise<ClassSessionTemplateSummary | null> {
-    const today = this.getSessionMutationFloorDate();
-    const session =
-      (await this.prisma.course_class_session.findFirst({
-        where: {
-          course_class_group_id: classGroupId,
-          session_date: { gte: today },
-          status: { notIn: ['completed', 'cancelled'] },
-        },
-        orderBy: [{ session_date: 'asc' }, { occurrence_index: 'asc' }],
-        select: {
-          title: true,
-          recurrence_rule: true,
-          recurrence_id: true,
-        },
-      })) ??
-      (await this.prisma.course_class_session.findFirst({
-        where: { course_class_group_id: classGroupId },
-        orderBy: [{ session_date: 'asc' }, { occurrence_index: 'asc' }],
-        select: {
-          title: true,
-          recurrence_rule: true,
-          recurrence_id: true,
-        },
-      }));
-
-    if (!session) {
-      return null;
-    }
-
-    return {
-      title: session.title,
-      recurrence: this.parseRecurrenceRule(session.recurrence_rule),
-      isRecurring: Boolean(session.recurrence_id),
-    };
-  }
-
-  private getSessionMutationFloorDate() {
-    return this.normalizeSessionDate(new Date());
-  }
-
-  private buildClassSessionDto(
-    classGroup: any,
-    sessionTemplate: ClassGroupSessionTemplateDto,
-  ): CreateSessionDto {
-    if (!classGroup.start_date) {
-      throw new BadRequestException('Class start date is required to generate sessions');
-    }
-
-    if (!classGroup.start_time || !classGroup.end_time) {
-      throw new BadRequestException('Class start and end times are required to generate sessions');
-    }
-
-    const deliveryMode = classGroup.delivery_mode;
-    const isOnline = deliveryMode === 'online';
-    const isHybrid = deliveryMode === 'hybrid';
-
-    return {
-      title: sessionTemplate.title.trim(),
-      description: sessionTemplate.description ?? classGroup.description ?? undefined,
-      sessionDate: this.toDateKey(this.normalizeSessionDate(classGroup.start_date)),
-      startTime: classGroup.start_time,
-      endTime: classGroup.end_time,
-      location:
-        isOnline && !isHybrid
-          ? undefined
-          : sessionTemplate.location ?? classGroup.location ?? undefined,
-      meetingUrl:
-        !isOnline && !isHybrid
-          ? undefined
-          : sessionTemplate.meetingUrl ?? classGroup.virtual_room_url ?? undefined,
-      color: sessionTemplate.color ?? undefined,
-      status: 'scheduled',
-      instructorId: classGroup.instructor_id ?? undefined,
-      recurrence: sessionTemplate.recurrence
-        ? this.toSessionRecurrenceDto(sessionTemplate.recurrence)
-        : undefined,
-    };
-  }
-
-  private toSessionRecurrenceDto(
-    recurrence: ClassGroupSessionRecurrenceDto,
-  ): SessionRecurrenceDto {
-    return {
-      frequency: recurrence.frequency,
-      interval: recurrence.interval,
-      until: recurrence.until,
-      daysOfWeek: recurrence.daysOfWeek,
-    };
-  }
-
-  private async syncClassSessionsFromTemplate(
-    tx: Prisma.TransactionClient,
-    classGroupId: number,
-    classGroup: any,
-    sessionTemplate: ClassGroupSessionTemplateDto,
-    options?: { futureOnly?: boolean },
-  ) {
-    const createDto = this.buildClassSessionDto(classGroup, sessionTemplate);
-    const mutableWhere: any = {
-      course_class_group_id: classGroupId,
-    };
-
-    if (options?.futureOnly) {
-      mutableWhere.session_date = { gte: this.getSessionMutationFloorDate() };
-      mutableWhere.status = { notIn: ['completed', 'cancelled'] };
-    }
-
-    const mutableSessions = await tx.course_class_session.findMany({
-      where: mutableWhere,
-      select: { id: true },
-    });
-
-    if (mutableSessions.length > 0) {
-      const sessionIds = mutableSessions.map((session) => session.id);
-
-      await tx.course_class_attendance.deleteMany({
-        where: { course_class_session_id: { in: sessionIds } },
-      });
-      await tx.course_class_session_instructor.deleteMany({
-        where: { course_class_session_id: { in: sessionIds } },
-      });
-      await tx.course_class_session.deleteMany({
-        where: { id: { in: sessionIds } },
-      });
-    }
-
-    await this.createSessionSeriesInTransaction(tx, classGroupId, createDto, {
-      minDate: options?.futureOnly ? this.getSessionMutationFloorDate() : undefined,
-    });
-  }
+  private async syncClassSessionsFromTemplate(
+    tx: Prisma.TransactionClient,
+    classGroupId: number,
+    classGroup: any,
+    sessionTemplate: ClassGroupSessionTemplateDto,
+    options?: { futureOnly?: boolean },
+  ) {
+    const createDto = this.buildClassSessionDto(classGroup, sessionTemplate);
+    const mutableWhere: any = {
+      course_class_group_id: classGroupId,
+    };
+
+    if (options?.futureOnly) {
+      mutableWhere.session_date = { gte: this.getSessionMutationFloorDate() };
+      mutableWhere.status = { notIn: ['completed', 'cancelled'] };
+    }
+
+    const mutableSessions = await tx.course_class_session.findMany({
+      where: mutableWhere,
+      select: { id: true },
+    });
+
+    if (mutableSessions.length > 0) {
+      const sessionIds = mutableSessions.map((session) => session.id);
+
+      await tx.course_class_attendance.deleteMany({
+        where: { course_class_session_id: { in: sessionIds } },
+      });
+      await tx.course_class_session_instructor.deleteMany({
+        where: { course_class_session_id: { in: sessionIds } },
+      });
+      await tx.course_class_session.deleteMany({
+        where: { id: { in: sessionIds } },
+      });
+    }
+
+    await this.createSessionSeriesInTransaction(tx, classGroupId, createDto, {
+      minDate: options?.futureOnly ? this.getSessionMutationFloorDate() : undefined,
+    });
+  }
 
   private mapClassGroup(item: any) {
     const instructorName =
@@ -1148,117 +1148,117 @@ export class ClassGroupService {
     return sessions.map((s) => this.mapSession(s));
   }
 
-  async createSession(classGroupId: number, dto: CreateSessionDto) {
-    const group = await this.prisma.course_class_group.findUnique({
-      where: { id: classGroupId },
-      select: { id: true },
-    });
+  async createSession(classGroupId: number, dto: CreateSessionDto) {
+    const group = await this.prisma.course_class_group.findUnique({
+      where: { id: classGroupId },
+      select: { id: true },
+    });
     if (!group) throw new NotFoundException('Class not found');
 
-    if (dto.instructorId) {
-      await this.assertInstructorExists(dto.instructorId);
-    }
-
-    const created = await this.prisma.$transaction((tx) =>
-      this.createSessionSeriesInTransaction(tx, classGroupId, dto),
-    );
-
-    if (!created) {
-      throw new BadRequestException('No sessions were generated for the provided recurrence');
-    }
-
-    return this.mapSession(created);
-  }
-
-  private async createSessionSeriesInTransaction(
-    tx: Prisma.TransactionClient,
-    classGroupId: number,
-    dto: CreateSessionDto,
-    options?: { minDate?: Date },
-  ) {
-    const normalizedRecurrence = dto.recurrence
-      ? this.normalizeSessionRecurrence(dto.recurrence, dto.sessionDate)
-      : null;
-    const fullOccurrenceDates = normalizedRecurrence
-      ? this.buildRecurringSessionDates(dto.sessionDate, normalizedRecurrence)
-      : [this.toSessionDate(dto.sessionDate)];
-    const occurrenceDates = options?.minDate
-      ? fullOccurrenceDates.filter(
-          (date) =>
-            this.normalizeSessionDate(date).getTime() >=
-            this.normalizeSessionDate(options.minDate!).getTime(),
-        )
-      : fullOccurrenceDates;
-
-    if (occurrenceDates.length === 0) {
-      return null;
-    }
-
-    const recurrenceId = normalizedRecurrence ? randomUUID() : null;
-    const recurrenceRule = normalizedRecurrence
-      ? JSON.stringify(normalizedRecurrence)
-      : null;
-
-    const first = await tx.course_class_session.create({
-      data: {
-        course_class_group_id: classGroupId,
-        title: dto.title,
-        description: dto.description ?? null,
-        session_date: occurrenceDates[0],
-        start_time: dto.startTime,
-        end_time: dto.endTime,
-        location: dto.location ?? null,
-        meeting_url: dto.meetingUrl ?? null,
-        color: dto.color ?? null,
-        status: dto.status ?? 'scheduled',
-        recurrence_id: recurrenceId,
-        recurrence_rule: recurrenceRule,
-        occurrence_index: normalizedRecurrence ? 0 : null,
-        is_exception: false,
-        ...(dto.instructorId && {
-          course_class_session_instructor: {
-            create: {
-              instructor_id: dto.instructorId,
-              role: 'lead',
-            },
-          },
-        }),
-      },
-      include: this.getSessionInclude(),
-    });
-
-    for (let index = 1; index < occurrenceDates.length; index += 1) {
-      await tx.course_class_session.create({
-        data: {
-          course_class_group_id: classGroupId,
-          title: dto.title,
-          description: dto.description ?? null,
-          session_date: occurrenceDates[index],
-          start_time: dto.startTime,
-          end_time: dto.endTime,
-          location: dto.location ?? null,
-          meeting_url: dto.meetingUrl ?? null,
-          color: dto.color ?? null,
-          status: dto.status ?? 'scheduled',
-          recurrence_id: recurrenceId,
-          recurrence_rule: recurrenceRule,
-          occurrence_index: normalizedRecurrence ? index : null,
-          is_exception: false,
-          parent_session_id: first.id,
-          ...(dto.instructorId && {
-            course_class_session_instructor: {
-              create: {
-                instructor_id: dto.instructorId,
-                role: 'lead',
-              },
-            },
-          }),
-        },
-      });
-    }
-
-    return first;
-  }
+    if (dto.instructorId) {
+      await this.assertInstructorExists(dto.instructorId);
+    }
+
+    const created = await this.prisma.$transaction((tx) =>
+      this.createSessionSeriesInTransaction(tx, classGroupId, dto),
+    );
+
+    if (!created) {
+      throw new BadRequestException('No sessions were generated for the provided recurrence');
+    }
+
+    return this.mapSession(created);
+  }
+
+  private async createSessionSeriesInTransaction(
+    tx: Prisma.TransactionClient,
+    classGroupId: number,
+    dto: CreateSessionDto,
+    options?: { minDate?: Date },
+  ) {
+    const normalizedRecurrence = dto.recurrence
+      ? this.normalizeSessionRecurrence(dto.recurrence, dto.sessionDate)
+      : null;
+    const fullOccurrenceDates = normalizedRecurrence
+      ? this.buildRecurringSessionDates(dto.sessionDate, normalizedRecurrence)
+      : [this.toSessionDate(dto.sessionDate)];
+    const occurrenceDates = options?.minDate
+      ? fullOccurrenceDates.filter(
+          (date) =>
+            this.normalizeSessionDate(date).getTime() >=
+            this.normalizeSessionDate(options.minDate!).getTime(),
+        )
+      : fullOccurrenceDates;
+
+    if (occurrenceDates.length === 0) {
+      return null;
+    }
+
+    const recurrenceId = normalizedRecurrence ? randomUUID() : null;
+    const recurrenceRule = normalizedRecurrence
+      ? JSON.stringify(normalizedRecurrence)
+      : null;
+
+    const first = await tx.course_class_session.create({
+      data: {
+        course_class_group_id: classGroupId,
+        title: dto.title,
+        description: dto.description ?? null,
+        session_date: occurrenceDates[0],
+        start_time: dto.startTime,
+        end_time: dto.endTime,
+        location: dto.location ?? null,
+        meeting_url: dto.meetingUrl ?? null,
+        color: dto.color ?? null,
+        status: dto.status ?? 'scheduled',
+        recurrence_id: recurrenceId,
+        recurrence_rule: recurrenceRule,
+        occurrence_index: normalizedRecurrence ? 0 : null,
+        is_exception: false,
+        ...(dto.instructorId && {
+          course_class_session_instructor: {
+            create: {
+              instructor_id: dto.instructorId,
+              role: 'lead',
+            },
+          },
+        }),
+      },
+      include: this.getSessionInclude(),
+    });
+
+    for (let index = 1; index < occurrenceDates.length; index += 1) {
+      await tx.course_class_session.create({
+        data: {
+          course_class_group_id: classGroupId,
+          title: dto.title,
+          description: dto.description ?? null,
+          session_date: occurrenceDates[index],
+          start_time: dto.startTime,
+          end_time: dto.endTime,
+          location: dto.location ?? null,
+          meeting_url: dto.meetingUrl ?? null,
+          color: dto.color ?? null,
+          status: dto.status ?? 'scheduled',
+          recurrence_id: recurrenceId,
+          recurrence_rule: recurrenceRule,
+          occurrence_index: normalizedRecurrence ? index : null,
+          is_exception: false,
+          parent_session_id: first.id,
+          ...(dto.instructorId && {
+            course_class_session_instructor: {
+              create: {
+                instructor_id: dto.instructorId,
+                role: 'lead',
+              },
+            },
+          }),
+        },
+      });
+    }
+
+    return first;
+  }
 
   async updateSession(
     classGroupId: number,
@@ -1791,8 +1791,8 @@ export class ClassGroupService {
 
   private handlePrismaError(error: unknown): never {
     if (
-      error instanceof PrismaClientKnownRequestError &&
-      error.code === 'P2002'
+      error instanceof PrismaClientKnownRequestError &&
+      error.code === 'P2002'
     ) {
       throw new ConflictException('Class code already exists');
     }