@hed-hog/lms 0.0.305 → 0.0.309

package/src/course/course.service.ts

@@ -5,21 +5,21 @@ import { UpdateCourseDto } from './dto/update-course.dto';
 
 type CourseImageTypeSlug = 'course-logo' | 'course-banner';
 
-type CourseExtraFields = {
-  code?: string | null;
-  is_featured?: boolean | null;
-  has_certificate?: boolean | null;
-  is_listed?: boolean | null;
-  offering_type?: 'scheduled' | 'on_demand' | 'blended' | null;
-};
-
-type PersistCourseExtrasInput = {
-  code?: string;
-  isFeatured?: boolean;
-  hasCertificate?: boolean;
-  isListed?: boolean;
-  offeringType?: 'scheduled' | 'on_demand' | 'blended';
-};
+type CourseExtraFields = {
+  name?: string | null;
+  is_featured?: boolean | null;
+  has_certificate?: boolean | null;
+  is_listed?: boolean | null;
+  offering_type?: 'scheduled' | 'on_demand' | 'blended' | null;
+};
+
+type PersistCourseExtrasInput = {
+  name?: string;
+  isFeatured?: boolean;
+  hasCertificate?: boolean;
+  isListed?: boolean;
+  offeringType?: 'scheduled' | 'on_demand' | 'blended';
+};
 
 @Injectable()
 export class CourseService {
@@ -40,9 +40,9 @@ export class CourseService {
     return undefined;
   }
 
-  private normalizeStatus(value?: string | null) {
-    if (!value) return undefined;
-    const normalized = String(value).trim().toLowerCase();
+  private normalizeStatus(value?: string | null) {
+    if (!value) return undefined;
+    const normalized = String(value).trim().toLowerCase();
     if (
       normalized === 'published' ||
       normalized === 'active' ||
@@ -55,39 +55,39 @@ export class CourseService {
     }
     if (normalized === 'archived' || normalized === 'arquivado') {
       return 'archived';
-    }
-    return undefined;
-  }
-
-  private normalizeOfferingType(value?: string | null) {
-    if (!value) return undefined;
-
-    const normalized = String(value).trim().toLowerCase();
-    if (normalized === 'scheduled') {
-      return 'scheduled';
-    }
-    if (
-      normalized === 'on_demand' ||
-      normalized === 'ondemand' ||
-      normalized === 'on-demand'
-    ) {
-      return 'on_demand';
-    }
-    if (normalized === 'blended') {
-      return 'blended';
-    }
-
-    return undefined;
-  }
-
-  private normalizeOptionalText(value?: string | null) {
-    const normalized = value?.trim();
-    return normalized ? normalized : undefined;
-  }
-
-  private resolveCourseTitle(title: string | undefined, slug: string) {
-    return this.normalizeOptionalText(title) ?? slug;
-  }
+    }
+    return undefined;
+  }
+
+  private normalizeOfferingType(value?: string | null) {
+    if (!value) return undefined;
+
+    const normalized = String(value).trim().toLowerCase();
+    if (normalized === 'scheduled') {
+      return 'scheduled';
+    }
+    if (
+      normalized === 'on_demand' ||
+      normalized === 'ondemand' ||
+      normalized === 'on-demand'
+    ) {
+      return 'on_demand';
+    }
+    if (normalized === 'blended') {
+      return 'blended';
+    }
+
+    return undefined;
+  }
+
+  private normalizeOptionalText(value?: string | null) {
+    const normalized = value?.trim();
+    return normalized ? normalized : undefined;
+  }
+
+  private resolveCourseTitle(title: string | undefined, slug: string) {
+    return this.normalizeOptionalText(title) ?? slug;
+  }
 
   async list(params: {
     page?: number;
@@ -154,11 +154,11 @@ export class CourseService {
             },
             orderBy: [{ is_primary: 'desc' }, { order: 'asc' }],
           },
-          _count: {
-            select: { course_enrollment: true, course_class_group: true },
-          },
-        },
-      }),
+          _count: {
+            select: { course_enrollment: true, course_class_group: true },
+          },
+        },
+      }),
       this.prisma.course.count({ where }),
     ]);
 
@@ -209,7 +209,13 @@ export class CourseService {
           },
           include: {
             image_type: {
-              select: { slug: true },
+              select: {
+                slug: true,
+                suggested_width: true,
+                suggested_height: true,
+                allowed_extensions: true,
+                aspect_ratio: true,
+              },
             },
             file: {
               select: { id: true, filename: true },
@@ -306,14 +312,13 @@ export class CourseService {
     }, extrasById.get(id));
   }
 
-  async create(dto: CreateCourseDto) {
-    const { categorySlugs, logoFileId, bannerFileId, instructorIds, ...data } = dto;
-    const normalizedSlug = data.slug.trim();
-    const resolvedCode = this.normalizeCourseCode(data.code ?? normalizedSlug);
-    const resolvedTitle = this.resolveCourseTitle(data.title, normalizedSlug);
-
-    const categories = categorySlugs?.length
-      ? await this.prisma.category.findMany({
+  async create(dto: CreateCourseDto) {
+    const { categorySlugs, logoFileId, bannerFileId, instructorIds, ...data } = dto;
+    const normalizedSlug = data.slug.trim();
+    const resolvedTitle = this.resolveCourseTitle(data.title, normalizedSlug);
+
+    const categories = categorySlugs?.length
+      ? await this.prisma.category.findMany({
           where: { slug: { in: categorySlugs } },
           select: { id: true },
         })
@@ -330,15 +335,16 @@ export class CourseService {
       validInstructorIds = instructorIds.filter((id) => validIds.has(id));
     }
 
-    const c = await this.prisma.course.create({
-      data: {
-        slug: normalizedSlug,
-        title: resolvedTitle,
-        ...(data.description !== undefined && {
-          description: data.description,
-        }),
-        level: this.normalizeLevel(data.level) ?? 'beginner',
-        status: this.normalizeStatus(data.status) ?? 'draft',
+    const c = await this.prisma.course.create({
+      data: {
+        name: data.name,
+        slug: normalizedSlug,
+        title: resolvedTitle,
+        ...(data.description !== undefined && {
+          description: data.description,
+        }),
+        level: this.normalizeLevel(data.level) ?? 'beginner',
+        status: this.normalizeStatus(data.status) ?? 'draft',
         ...(data.requirements !== undefined && {
           requirements: data.requirements,
         }),
@@ -425,42 +431,41 @@ export class CourseService {
       bannerFileId,
     });
 
-    await this.persistCourseExtras(c.id, {
-      ...data,
-      ...(resolvedCode && { code: resolvedCode }),
-      offeringType: this.normalizeOfferingType(data.offeringType) ?? 'on_demand',
-    });
+    await this.persistCourseExtras(c.id, {
+      ...data,
+      offeringType: this.normalizeOfferingType(data.offeringType) ?? 'on_demand',
+    });
 
     const extrasById = await this.getCourseExtras([c.id]);
 
     return this.mapCourse(c, undefined, extrasById.get(c.id));
   }
 
-  async update(id: number, dto: UpdateCourseDto) {
-    const { categorySlugs, logoFileId, bannerFileId, instructorIds, ...data } = dto;
-    let existingSlug: string | undefined;
-
-    if (
-      data.title !== undefined &&
-      this.normalizeOptionalText(data.title) === undefined &&
-      data.slug === undefined
-    ) {
-      const currentCourse = await this.prisma.course.findUnique({
-        where: { id },
-        select: { slug: true },
-      });
-
-      existingSlug = currentCourse?.slug;
-    }
-
-    const resolvedSlug = data.slug !== undefined ? data.slug.trim() : undefined;
-    const resolvedTitle =
-      data.title !== undefined
-        ? this.resolveCourseTitle(data.title, resolvedSlug ?? existingSlug ?? '')
-        : undefined;
-
-    const categories = categorySlugs?.length
-      ? await this.prisma.category.findMany({
+  async update(id: number, dto: UpdateCourseDto) {
+    const { categorySlugs, logoFileId, bannerFileId, instructorIds, ...data } = dto;
+    let existingSlug: string | undefined;
+
+    if (
+      data.title !== undefined &&
+      this.normalizeOptionalText(data.title) === undefined &&
+      data.slug === undefined
+    ) {
+      const currentCourse = await this.prisma.course.findUnique({
+        where: { id },
+        select: { slug: true },
+      });
+
+      existingSlug = currentCourse?.slug;
+    }
+
+    const resolvedSlug = data.slug !== undefined ? data.slug.trim() : undefined;
+    const resolvedTitle =
+      data.title !== undefined
+        ? this.resolveCourseTitle(data.title, resolvedSlug ?? existingSlug ?? '')
+        : undefined;
+
+    const categories = categorySlugs?.length
+      ? await this.prisma.category.findMany({
           where: { slug: { in: categorySlugs } },
           select: { id: true },
         })
@@ -487,14 +492,15 @@ export class CourseService {
       });
     }
 
-    const c = await this.prisma.course.update({
-      where: { id },
-      data: {
-        ...(resolvedSlug !== undefined && { slug: resolvedSlug }),
-        ...(resolvedTitle !== undefined && { title: resolvedTitle }),
-        ...(data.description !== undefined && { description: data.description }),
-        ...(data.level !== undefined && {
-          level: this.normalizeLevel(data.level),
+    const c = await this.prisma.course.update({
+      where: { id },
+      data: {
+        ...(data.name !== undefined && { name: data.name }),
+        ...(resolvedSlug !== undefined && { slug: resolvedSlug }),
+        ...(resolvedTitle !== undefined && { title: resolvedTitle }),
+        ...(data.description !== undefined && { description: data.description }),
+        ...(data.level !== undefined && {
+          level: this.normalizeLevel(data.level),
         }),
         ...(data.status !== undefined && {
           status: this.normalizeStatus(data.status),
@@ -594,7 +600,7 @@ export class CourseService {
       bannerFileId,
     });
 
-    await this.persistCourseExtras(id, data);
+    await this.persistCourseExtras(id, data);
 
     const extrasById = await this.getCourseExtras([id]);
 
@@ -606,7 +612,7 @@ export class CourseService {
     return { success: true };
   }
 
-  private mapCourse(
+  private mapCourse(
     c: any,
     metrics?: {
       lessonCount?: number;
@@ -620,16 +626,16 @@ export class CourseService {
       }[];
     },
     extras?: CourseExtraFields,
-  ) {
-    const rawCode = extras?.code ?? c.code ?? c.slug;
-    const resolvedTitle = this.normalizeOptionalText(c.title) ?? c.slug;
-    const courseImages = Array.isArray(c.course_image) ? c.course_image : [];
-    const classCount = c._count?.course_class_group ?? 0;
-    const offeringType =
-      this.normalizeOfferingType(extras?.offering_type) ??
-      (classCount > 0 ? 'scheduled' : 'on_demand');
-
-    const logoImage = courseImages.find(
+  ) {
+    const resolvedName = extras?.name ?? c.name ?? null;
+    const resolvedTitle = this.normalizeOptionalText(c.title) ?? c.slug;
+    const courseImages = Array.isArray(c.course_image) ? c.course_image : [];
+    const classCount = c._count?.course_class_group ?? 0;
+    const offeringType =
+      this.normalizeOfferingType(extras?.offering_type) ??
+      (classCount > 0 ? 'scheduled' : 'on_demand');
+
+    const logoImage = courseImages.find(
       (courseImage: any) => courseImage.image_type?.slug === 'course-logo',
     );
     const bannerImage = courseImages.find(
@@ -638,12 +644,10 @@ export class CourseService {
 
     return {
       id: c.id,
-      code:
-        rawCode?.toUpperCase().replace(/[^A-Z0-9-]+/g, '-').slice(0, 32) ??
-        '',
-      slug: c.slug,
-      title: resolvedTitle,
-      description: c.description ?? '',
+      name: resolvedName ?? '',
+      slug: c.slug,
+      title: resolvedTitle,
+      description: c.description ?? '',
       level: c.level,
       status: c.status,
       durationHours: c.duration_hours ?? 0,
@@ -657,8 +661,24 @@ export class CourseService {
       secondaryContrastColor: c.secondary_contrast_color ?? null,
       logoFileId: logoImage?.file?.id ?? logoImage?.file_id ?? null,
       logoFilename: logoImage?.file?.filename ?? null,
+      logoImageType: logoImage?.image_type
+        ? {
+            suggestedWidth: logoImage.image_type.suggested_width ?? null,
+            suggestedHeight: logoImage.image_type.suggested_height ?? null,
+            allowedExtensions: logoImage.image_type.allowed_extensions ?? null,
+            aspectRatio: logoImage.image_type.aspect_ratio ?? null,
+          }
+        : null,
       bannerFileId: bannerImage?.file?.id ?? bannerImage?.file_id ?? null,
       bannerFilename: bannerImage?.file?.filename ?? null,
+      bannerImageType: bannerImage?.image_type
+        ? {
+            suggestedWidth: bannerImage.image_type.suggested_width ?? null,
+            suggestedHeight: bannerImage.image_type.suggested_height ?? null,
+            allowedExtensions: bannerImage.image_type.allowed_extensions ?? null,
+            aspectRatio: bannerImage.image_type.aspect_ratio ?? null,
+          }
+        : null,
       categories: (c.course_category ?? []).map(
         (cc: any) => cc.category?.slug ?? '',
       ),
@@ -666,14 +686,14 @@ export class CourseService {
         (cc: any) => cc.category?.id ?? 0,
       ),
       isFeatured: extras?.is_featured ?? c.is_featured ?? false,
-      hasCertificate: extras?.has_certificate ?? c.has_certificate ?? false,
-      isListed: extras?.is_listed ?? c.is_listed ?? false,
-      offeringType,
-      enrollmentCount: c._count?.course_enrollment ?? 0,
-      moduleCount: c._count?.course_module ?? 0,
-      classCount,
-      lessonCount: metrics?.lessonCount ?? 0,
-      sessionCount: metrics?.sessionCount ?? 0,
+      hasCertificate: extras?.has_certificate ?? c.has_certificate ?? false,
+      isListed: extras?.is_listed ?? c.is_listed ?? false,
+      offeringType,
+      enrollmentCount: c._count?.course_enrollment ?? 0,
+      moduleCount: c._count?.course_module ?? 0,
+      classCount,
+      lessonCount: metrics?.lessonCount ?? 0,
+      sessionCount: metrics?.sessionCount ?? 0,
       averageCompletion: Math.round(metrics?.averageCompletion ?? 0),
       certificatesIssued:
         metrics?.certificatesIssued ?? c._count?.certificate ?? 0,
@@ -720,29 +740,29 @@ export class CourseService {
     try {
       const idsCsv = normalizedIds.join(',');
       const rows = (await this.prisma.$queryRawUnsafe(
-        `
-          SELECT id, code, is_featured, has_certificate, is_listed, offering_type
-          FROM course
-          WHERE id IN (${idsCsv})
-        `,
+        `
+          SELECT id, name, is_featured, has_certificate, is_listed, offering_type
+          FROM course
+          WHERE id IN (${idsCsv})
+        `,
       )) as Array<{
         id: number;
-        code: string | null;
+        name: string | null;
         is_featured: boolean | null;
-        has_certificate: boolean | null;
-        is_listed: boolean | null;
-        offering_type: 'scheduled' | 'on_demand' | 'blended' | null;
-      }>;
-
-      for (const row of rows) {
-        extrasById.set(row.id, {
-          code: row.code,
-          is_featured: row.is_featured,
-          has_certificate: row.has_certificate,
-          is_listed: row.is_listed,
-          offering_type: row.offering_type,
-        });
-      }
+        has_certificate: boolean | null;
+        is_listed: boolean | null;
+        offering_type: 'scheduled' | 'on_demand' | 'blended' | null;
+      }>;
+
+      for (const row of rows) {
+        extrasById.set(row.id, {
+          name: row.name,
+          is_featured: row.is_featured,
+          has_certificate: row.has_certificate,
+          is_listed: row.is_listed,
+          offering_type: row.offering_type,
+        });
+      }
     } catch {
       return extrasById;
     }
@@ -757,9 +777,9 @@ export class CourseService {
     const sets: string[] = [];
     const params: Array<string | boolean | number> = [];
 
-    if (data.code !== undefined) {
-      params.push(data.code);
-      sets.push(`code = $${params.length}`);
+    if (data.name !== undefined) {
+      params.push(data.name);
+      sets.push(`name = $${params.length}`);
     }
 
     if (data.isFeatured !== undefined) {
@@ -772,15 +792,15 @@ export class CourseService {
       sets.push(`has_certificate = $${params.length}`);
     }
 
-    if (data.isListed !== undefined) {
-      params.push(data.isListed);
-      sets.push(`is_listed = $${params.length}`);
-    }
-
-    if (data.offeringType !== undefined) {
-      params.push(data.offeringType);
-      sets.push(`offering_type = $${params.length}`);
-    }
+    if (data.isListed !== undefined) {
+      params.push(data.isListed);
+      sets.push(`is_listed = $${params.length}`);
+    }
+
+    if (data.offeringType !== undefined) {
+      params.push(data.offeringType);
+      sets.push(`offering_type = $${params.length}`);
+    }
 
     if (sets.length === 0) {
       return;
@@ -802,18 +822,6 @@ export class CourseService {
     }
   }
 
-  private normalizeCourseCode(value?: string | null) {
-    const normalized = String(value ?? '')
-      .trim()
-      .toUpperCase()
-      .replace(/[^A-Z0-9-]+/g, '-')
-      .replace(/-+/g, '-')
-      .replace(/^-+|-+$/g, '')
-      .slice(0, 32);
-
-    return normalized || undefined;
-  }
-
   private async syncCourseImages(
     courseId: number,
     data: {
@@ -908,11 +916,35 @@ export class CourseService {
       return existing;
     }
 
+    const specsBySlug: Record<
+      CourseImageTypeSlug,
+      {
+        suggested_width: number;
+        suggested_height: number;
+        allowed_extensions: string;
+        aspect_ratio: string;
+      }
+    > = {
+      'course-logo': {
+        suggested_width: 500,
+        suggested_height: 500,
+        allowed_extensions: 'png,webp',
+        aspect_ratio: '1:1',
+      },
+      'course-banner': {
+        suggested_width: 1920,
+        suggested_height: 540,
+        allowed_extensions: 'jpg,png,webp',
+        aspect_ratio: '16:9',
+      },
+    };
+
     return this.prisma.image_type.create({
       data: {
         name: imageTypeSlug === 'course-logo' ? 'Course Logo' : 'Course Banner',
         slug: imageTypeSlug,
         applies_to_course: true,
+        ...specsBySlug[imageTypeSlug],
       },
       select: { id: true },
     });

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

@@ -56,8 +56,9 @@ export class CreateCourseStructureLessonDto {
   tipo: 'video' | 'questao' | 'post' | 'exercicio';
 
   @IsInt()
-  @Min(1)
-  duracao: number;
+  @Min(0)
+  @IsOptional()
+  duracao: number = 0;
 
   @IsEnum(['youtube', 'vimeo', 'bunny', 'custom'])
   @IsOptional()

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

@@ -14,17 +14,20 @@ export class CreateCourseDto {
   @IsString()
   @MaxLength(32)
   @IsOptional()
-  code?: string;
+  name?: string;
 
   @IsString()
   @IsNotEmpty()
   @MaxLength(255)
+  @Matches(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, {
+    message: 'slug deve conter apenas letras minúsculas, números e hífens, sem espaços',
+  })
   slug: string;
 
-  @IsString()
-  @MaxLength(255)
-  @IsOptional()
-  title?: string;
+  @IsString()
+  @MaxLength(255)
+  @IsOptional()
+  title?: string;
 
   @IsString()
   @IsOptional()
@@ -52,17 +55,17 @@ export class CreateCourseDto {
   @IsOptional()
   level?: 'beginner' | 'intermediate' | 'advanced';
 
-  @IsEnum(['draft', 'published', 'archived'])
-  @IsOptional()
-  status?: 'draft' | 'published' | 'archived';
-
-  @IsEnum(['scheduled', 'on_demand', 'blended'])
-  @IsOptional()
-  offeringType?: 'scheduled' | 'on_demand' | 'blended';
-
-  @IsBoolean()
-  @IsOptional()
-  isFeatured?: boolean;
+  @IsEnum(['draft', 'published', 'archived'])
+  @IsOptional()
+  status?: 'draft' | 'published' | 'archived';
+
+  @IsEnum(['scheduled', 'on_demand', 'blended'])
+  @IsOptional()
+  offeringType?: 'scheduled' | 'on_demand' | 'blended';
+
+  @IsBoolean()
+  @IsOptional()
+  isFeatured?: boolean;
 
   @IsBoolean()
   @IsOptional()

package/src/course/dto/move-lesson.dto.ts

@@ -0,0 +1,17 @@
+import { IsInt, IsOptional, IsPositive, Min } from 'class-validator';
+
+export class MoveLessonDto {
+  /** ID of the destination session (course_module). */
+  @IsInt()
+  @IsPositive()
+  toSessionId: number;
+
+  /**
+   * Zero-based index within the destination session.
+   * If omitted, the lesson is appended at the end.
+   */
+  @IsOptional()
+  @IsInt()
+  @Min(0)
+  toIndex?: number;
+}

package/src/course/dto/paste-lessons.dto.ts

@@ -0,0 +1,9 @@
+import { ArrayMinSize, IsArray, IsInt, IsPositive } from 'class-validator';
+
+export class PasteLessonsDto {
+  @IsArray()
+  @ArrayMinSize(1)
+  @IsInt({ each: true })
+  @IsPositive({ each: true })
+  lessonIds: number[];
+}

package/src/course/dto/reorder-lessons.dto.ts

@@ -0,0 +1,10 @@
+import { ArrayMinSize, IsArray, IsInt, IsPositive } from 'class-validator';
+
+export class ReorderLessonsDto {
+  /** Ordered array of lesson IDs in their new positions within the session. */
+  @IsArray()
+  @ArrayMinSize(1)
+  @IsInt({ each: true })
+  @IsPositive({ each: true })
+  lessonIds: number[];
+}

package/src/course/dto/reorder-sessions.dto.ts

@@ -0,0 +1,10 @@
+import { ArrayMinSize, IsArray, IsInt, IsPositive } from 'class-validator';
+
+export class ReorderSessionsDto {
+  /** Ordered array of session IDs reflecting the new visual order. */
+  @IsArray()
+  @ArrayMinSize(1)
+  @IsInt({ each: true })
+  @IsPositive({ each: true })
+  sessionIds: number[];
+}

package/src/training/training.controller.ts

@@ -15,7 +15,7 @@ import { UpdateTrainingDto } from './dto/update-training.dto';
 import { TrainingService } from './training.service';
 
 @Role()
-@Controller('lms/training')
+@Controller('lms/paths')
 export class TrainingController {
   constructor(private readonly trainingService: TrainingService) {}
 

package/dist/enterprise/dto/add-enterprise-lead.dto.d.ts

@@ -1,4 +0,0 @@
-export declare class AddEnterpriseLeadDto {
-    person_id: number;
-}
-//# sourceMappingURL=add-enterprise-lead.dto.d.ts.map