offcourse 1.0.1 → 1.2.0

package/dist/scraper/learningsuite/navigator.d.ts

@@ -0,0 +1,122 @@
+import type { Page } from "playwright";
+import { type Course, type Module, type Lesson } from "./schemas.js";
+export interface LearningSuiteCourse {
+    id: string;
+    title: string;
+    description: string | null;
+    thumbnailUrl: string | null;
+    moduleCount: number;
+    lessonCount: number;
+}
+export interface LearningSuiteModule {
+    id: string;
+    title: string;
+    description: string | null;
+    position: number;
+    isLocked: boolean;
+}
+export interface LearningSuiteLesson {
+    id: string;
+    title: string;
+    position: number;
+    moduleId: string;
+    isLocked: boolean;
+    isCompleted: boolean;
+}
+export interface LearningSuiteCourseStructure {
+    course: LearningSuiteCourse;
+    modules: (LearningSuiteModule & {
+        lessons: LearningSuiteLesson[];
+    })[];
+    tenantId: string;
+    domain: string;
+    courseSlug?: string;
+}
+export interface LearningSuiteScanProgress {
+    phase: "init" | "course" | "modules" | "lessons" | "done";
+    courseName?: string;
+    totalModules?: number;
+    currentModule?: string;
+    currentModuleIndex?: number;
+    lessonsFound?: number;
+    skippedLocked?: boolean;
+}
+/**
+ * Extracts the tenant ID from a LearningSuite URL.
+ * URL format: https://{subdomain}.learningsuite.io/...
+ */
+export declare function extractTenantFromUrl(url: string): {
+    subdomain: string;
+    tenantId: string | null;
+};
+/**
+ * Extracts the tenant ID from the page by inspecting network requests or localStorage.
+ */
+export declare function extractTenantId(page: Page): Promise<string | null>;
+/**
+ * Gets the auth token from localStorage.
+ */
+export declare function getAuthToken(page: Page): Promise<string | null>;
+/**
+ * Makes a GraphQL request to the LearningSuite API.
+ */
+export declare function graphqlRequest<T>(page: Page, tenantId: string, query: string, variables?: Record<string, unknown>): Promise<T | null>;
+/**
+ * Fetches all courses available to the user.
+ */
+export declare function fetchCourses(page: Page, tenantId: string): Promise<Course[]>;
+/**
+ * Fetches modules for a course.
+ */
+export declare function fetchModules(page: Page, tenantId: string, courseId: string): Promise<Module[]>;
+/**
+ * Fetches lessons for a module.
+ */
+export declare function fetchLessons(page: Page, tenantId: string, courseId: string, moduleId: string): Promise<Lesson[]>;
+/**
+ * Extracts courses from the page DOM (fallback method).
+ */
+export declare function extractCoursesFromPage(page: Page): Promise<LearningSuiteCourse[]>;
+/**
+ * Builds the complete course structure for a LearningSuite course using DOM extraction.
+ * This is more reliable than GraphQL as the API structure may vary between instances.
+ */
+export declare function buildLearningSuiteCourseStructure(page: Page, courseUrl: string, onProgress?: (progress: LearningSuiteScanProgress) => void): Promise<LearningSuiteCourseStructure | null>;
+/**
+ * Constructs the URL for a LearningSuite course.
+ */
+export declare function getLearningSuiteCourseUrl(domain: string, courseSlug: string, courseId: string): string;
+/**
+ * Constructs the URL for a LearningSuite lesson.
+ * URL format: /student/course/{slug}/{courseId}/{topicId}
+ * Note: The topicId (lessonId from module page) is enough - the server redirects to the full URL.
+ */
+export declare function getLearningSuiteLessonUrl(domain: string, courseSlug: string, courseId: string, _moduleId: string, // Unused - kept for API compatibility
+lessonId: string): string;
+/**
+ * Marks a lesson as completed by clicking the "Abschließen" button.
+ * This unlocks the next lesson in sequence.
+ *
+ * @returns true if successfully completed, false otherwise
+ */
+export declare function markLessonComplete(page: Page, lessonUrl: string): Promise<boolean>;
+/**
+ * Auto-completes all accessible lessons in sequence to unlock subsequent content.
+ * This is useful when lessons are sequentially locked.
+ *
+ * @param page - Playwright page
+ * @param lessons - List of lessons to complete
+ * @param onProgress - Callback for progress updates
+ * @returns Number of lessons successfully completed
+ */
+export declare function autoCompleteLessons(page: Page, lessons: {
+    url: string;
+    title: string;
+    isLocked: boolean;
+}[], onProgress?: (completed: number, total: number, currentLesson: string) => void): Promise<number>;
+/**
+ * Checks if a lesson page shows the lesson as completed.
+ */
+export declare function isLessonCompleted(page: Page): Promise<boolean>;
+export { slugify, createFolderName } from "../../shared/slug.js";
+//# sourceMappingURL=navigator.d.ts.map

package/dist/scraper/learningsuite/navigator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigator.d.ts","sourceRoot":"","sources":["../../../src/scraper/learningsuite/navigator.ts"],"names":[],"mappings":"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"}