@mo7yw4ng/openape 1.0.0 → 1.0.2

package/esm/src/lib/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/src/lib/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEjE;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CA6CtB"}

package/esm/src/lib/session.js

@@ -0,0 +1,42 @@
+/**
+ * Extract Moodle sesskey from the current page.
+ * The sesskey is required for all AJAX calls.
+ */
+export async function extractSessionInfo(page, config, log, wsToken) {
+    // Ensure we're on a Moodle page
+    const url = page.url();
+    if (!url.includes(config.moodleBaseUrl.replace("https://", ""))) {
+        await page.goto(`${config.moodleBaseUrl}/my/`, {
+            waitUntil: "domcontentloaded",
+        });
+    }
+    // Try extracting sesskey from M.cfg (Moodle's JS config object)
+    // Use string to avoid dnt transforming globalThis/window to dntShim
+    let sesskey = await page.evaluate("() => self.M?.cfg?.sesskey ?? null");
+    // Fallback: extract from a hidden input
+    if (!sesskey) {
+        sesskey = await page.evaluate(() => {
+            const el = document.querySelector('input[name="sesskey"]');
+            return el?.value ?? null;
+        });
+    }
+    // Fallback: regex on page source
+    if (!sesskey) {
+        const content = await page.content();
+        const match = content.match(/"sesskey"\s*:\s*"([a-zA-Z0-9]+)"/);
+        sesskey = match?.[1] ?? null;
+    }
+    if (!sesskey) {
+        throw new Error("Failed to extract sesskey from Moodle page.");
+    }
+    log.debug(`Extracted sesskey: ${sesskey}`);
+    const sessionInfo = {
+        sesskey,
+        moodleBaseUrl: config.moodleBaseUrl,
+    };
+    if (wsToken) {
+        sessionInfo.wsToken = wsToken;
+        log.debug("Web Service Token included in session");
+    }
+    return sessionInfo;
+}

package/esm/src/lib/token.d.ts

@@ -0,0 +1,38 @@
+import type { Page } from "playwright-core";
+import type { AppConfig, Logger } from "./types.js";
+/**
+ * Get the session metadata file path from the auth state path.
+ * E.g., .auth/storage-state.json -> .auth/session-meta.json
+ */
+export declare function getSessionMetaPath(authStatePath: string): string;
+/**
+ * Load sesskey from metadata if it exists and is valid.
+ * Sesskey is typically valid for 6 hours.
+ */
+export declare function loadSesskey(authStatePath: string): string | null;
+/**
+ * Save sesskey to metadata.
+ */
+export declare function saveSesskey(authStatePath: string, sesskey: string): void;
+/**
+ * Load WS token from metadata if it exists and is valid.
+ * WS token is valid for 24 hours.
+ */
+export declare function loadWsToken(authStatePath: string): string | null;
+/**
+ * Save WS token to metadata.
+ */
+export declare function saveWsToken(authStatePath: string, token: string): void;
+/**
+ * Acquire Moodle Web Service Token via mobile app launch endpoint.
+ *
+ * Process:
+ * 1. Visit admin/tool/mobile/launch.php with service=moodle_mobile_app
+ * 2. Server redirects to moodlemobile://token=BASE64_DATA (which causes ERR_ABORTED)
+ * 3. We catch the redirect from the response and extract the token
+ *
+ * @returns The Web Service Token for Moodle API calls
+ * @throws Error if token acquisition fails
+ */
+export declare function acquireWsToken(page: Page, config: AppConfig, log: Logger): Promise<string>;
+//# sourceMappingURL=token.d.ts.map

package/esm/src/lib/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/src/lib/token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAWpD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGhE;AA8BD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKxE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAKtE;AAuBD;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,CAsEjB"}

package/esm/src/lib/token.js

@@ -0,0 +1,178 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Get the session metadata file path from the auth state path.
+ * E.g., .auth/storage-state.json -> .auth/session-meta.json
+ */
+export function getSessionMetaPath(authStatePath) {
+    const dir = path.dirname(authStatePath);
+    return path.join(dir, "session-meta.json");
+}
+/**
+ * Load session metadata from file.
+ */
+function loadSessionMeta(authStatePath) {
+    const metaPath = getSessionMetaPath(authStatePath);
+    try {
+        if (fs.existsSync(metaPath)) {
+            const content = fs.readFileSync(metaPath, "utf8");
+            return JSON.parse(content);
+        }
+    }
+    catch {
+        // Ignore errors, return empty meta
+    }
+    return {};
+}
+/**
+ * Save session metadata to file.
+ */
+function saveSessionMeta(authStatePath, meta) {
+    const metaPath = getSessionMetaPath(authStatePath);
+    try {
+        fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2));
+    }
+    catch {
+        // Ignore save errors
+    }
+}
+/**
+ * Load sesskey from metadata if it exists and is valid.
+ * Sesskey is typically valid for 6 hours.
+ */
+export function loadSesskey(authStatePath) {
+    const meta = loadSessionMeta(authStatePath);
+    if (meta.sesskey && meta.sesskeyTimestamp) {
+        const age = Date.now() - meta.sesskeyTimestamp;
+        if (age < 6 * 60 * 60 * 1000) {
+            return meta.sesskey;
+        }
+    }
+    return null;
+}
+/**
+ * Save sesskey to metadata.
+ */
+export function saveSesskey(authStatePath, sesskey) {
+    const meta = loadSessionMeta(authStatePath);
+    meta.sesskey = sesskey;
+    meta.sesskeyTimestamp = Date.now();
+    saveSessionMeta(authStatePath, meta);
+}
+/**
+ * Load WS token from metadata if it exists and is valid.
+ * WS token is valid for 24 hours.
+ */
+export function loadWsToken(authStatePath) {
+    const meta = loadSessionMeta(authStatePath);
+    if (meta.wsToken && meta.wsTokenTimestamp) {
+        const age = Date.now() - meta.wsTokenTimestamp;
+        if (age < 24 * 60 * 60 * 1000) {
+            return meta.wsToken;
+        }
+    }
+    return null;
+}
+/**
+ * Save WS token to metadata.
+ */
+export function saveWsToken(authStatePath, token) {
+    const meta = loadSessionMeta(authStatePath);
+    meta.wsToken = token;
+    meta.wsTokenTimestamp = Date.now();
+    saveSessionMeta(authStatePath, meta);
+}
+/**
+ * Extract and decode the Web Service Token from moodlemobile:// URL
+ * Format: moodlemobile://token=BASE64_DATA
+ * Decoded: token:::site_url:::other_params
+ */
+function extractTokenFromCustomScheme(url) {
+    try {
+        const match = url.match(/token=([A-Za-z0-9+/=]+)/);
+        if (!match)
+            return null;
+        // Base64 decode the token data
+        const decoded = atob(match[1]);
+        const parts = decoded.split(":::");
+        // The second part (index 1) is the actual WS token
+        return parts.length >= 2 ? parts[1] : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Acquire Moodle Web Service Token via mobile app launch endpoint.
+ *
+ * Process:
+ * 1. Visit admin/tool/mobile/launch.php with service=moodle_mobile_app
+ * 2. Server redirects to moodlemobile://token=BASE64_DATA (which causes ERR_ABORTED)
+ * 3. We catch the redirect from the response and extract the token
+ *
+ * @returns The Web Service Token for Moodle API calls
+ * @throws Error if token acquisition fails
+ */
+export async function acquireWsToken(page, config, log) {
+    log.info("Acquiring Moodle Web Service Token...");
+    // Generate random UUID for passport parameter
+    const passport = crypto.randomUUID();
+    const launchUrl = `${config.moodleBaseUrl}/admin/tool/mobile/launch.php?service=moodle_mobile_app&passport=${passport}`;
+    log.debug(`Token acquisition URL: ${launchUrl}`);
+    // Set up response listener to catch the redirect
+    let tokenFound = false;
+    const tokenPromise = new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            if (!tokenFound) {
+                page.off("response", responseHandler);
+                reject(new Error("Token acquisition timed out - no redirect received"));
+            }
+        }, 15000);
+        const responseHandler = async (response) => {
+            try {
+                const status = response.status();
+                const headers = response.headers();
+                // Check for redirect to custom scheme
+                const location = headers["location"] || headers["Location"];
+                if (location && location.startsWith("moodlemobile://")) {
+                    clearTimeout(timeout);
+                    tokenFound = true;
+                    page.off("response", responseHandler);
+                    const token = extractTokenFromCustomScheme(location);
+                    if (token) {
+                        resolve(token);
+                    }
+                    else {
+                        reject(new Error("Failed to extract token from custom scheme URL"));
+                    }
+                }
+            }
+            catch (err) {
+                // Ignore errors in response handler
+            }
+        };
+        page.on("response", responseHandler);
+    });
+    try {
+        // Navigate to the launch endpoint - expect it to fail with ERR_ABORTED
+        // because the browser can't handle moodlemobile:// scheme
+        await page.goto(launchUrl, {
+            waitUntil: "domcontentloaded",
+            timeout: 10000,
+        }).catch(() => {
+            // Expected: navigation will fail due to custom scheme redirect
+            // The token should have been captured by our response handler
+            log.debug("Navigation failed as expected (custom scheme redirect)");
+        });
+        // Wait for the intercepted token
+        const token = await tokenPromise;
+        log.success("Web Service Token acquired successfully");
+        log.debug(`Token (first 10 chars): ${token.substring(0, 10)}...`);
+        return token;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        log.warn(`Failed to acquire WS Token: ${message}`);
+        throw error;
+    }
+}

package/esm/src/lib/types.d.ts

@@ -0,0 +1,271 @@
+import type { Page } from "playwright-core";
+export interface AppConfig {
+    courseUrl: string;
+    moodleBaseUrl: string;
+    headless: boolean;
+    slowMo: number;
+    authStatePath: string;
+    ollamaModel?: string;
+    ollamaBaseUrl: string;
+}
+export interface SessionInfo {
+    sesskey: string;
+    moodleBaseUrl: string;
+    wsToken?: string;
+    wsTokenExpires?: number;
+}
+export interface Logger {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+    debug: (msg: string) => void;
+}
+export interface EnrolledCourse {
+    id: number;
+    fullname: string;
+    shortname: string;
+    idnumber?: string;
+    category?: string;
+    progress?: number;
+    startdate?: number;
+    enddate?: number;
+}
+export interface SuperVideoModule {
+    cmid: string;
+    name: string;
+    url: string;
+    isComplete: boolean;
+}
+export interface VideoActivity {
+    name: string;
+    url: string;
+    viewId: number;
+    duration: number;
+    existingPercent: number;
+}
+export interface QuizModule {
+    cmid: string;
+    name: string;
+    url: string;
+    isComplete: boolean;
+    timeOpen?: number;
+    timeClose?: number;
+}
+export interface ForumModule {
+    cmid: string;
+    forumId: number;
+    name: string;
+    url: string;
+    courseId: number;
+    forumType: string;
+}
+export interface ForumPost {
+    id: number;
+    subject: string;
+    author: string;
+    authorId?: number;
+    created: number;
+    modified: number;
+    message: string;
+    discussionId: number;
+    replies?: ForumPost[];
+    unread?: boolean;
+}
+export interface ForumDiscussion {
+    id: number;
+    forumId: number;
+    name: string;
+    firstPostId: number;
+    userId: number;
+    userFullName: string;
+    groupId?: number;
+    timedue?: number;
+    timeModified: number;
+    timeStart?: number;
+    timeEnd?: number;
+    userModified?: number;
+    userModifiedFullName?: string;
+    postCount?: number;
+    unread?: boolean;
+    subject?: string;
+    message?: string;
+    pinned?: boolean;
+    locked?: boolean;
+    starred?: boolean;
+}
+export interface AnnouncementPost {
+    id: number;
+    subject: string;
+    content: string;
+    author: string;
+    authorId?: number;
+    courseId: number;
+    createdAt: number;
+    modifiedAt?: number;
+    attachments?: AnnouncementAttachment[];
+    unread?: boolean;
+}
+export interface AnnouncementAttachment {
+    filename: string;
+    url: string;
+    filesize: number;
+    mimetype: string;
+}
+export interface ResourceModule {
+    cmid: string;
+    name: string;
+    url: string;
+    courseId: number;
+    modType: string;
+    mimetype?: string;
+    filesize?: number;
+    modified?: number;
+}
+export interface FolderContents {
+    files: ResourceFile[];
+    folders: FolderInfo[];
+}
+export interface ResourceFile {
+    filename: string;
+    url: string;
+    filesize: number;
+    mimetype: string;
+    modified: number;
+    path?: string;
+}
+export interface FolderInfo {
+    name: string;
+    id: number;
+    path: string;
+}
+export interface AssignmentModule {
+    cmid: string;
+    name: string;
+    url: string;
+    courseId: number;
+    duedate?: number;
+    cutoffdate?: number;
+    allowSubmissionsFromDate?: number;
+    gradingduedate?: number;
+    submissionStatus?: string;
+    grade?: GradeInfo;
+    lateSubmission?: boolean;
+    extensionduedate?: number;
+}
+export interface AssignmentSubmission {
+    id: number;
+    assignmentId: number;
+    userId: number;
+    timemodified: number;
+    status: string;
+    files?: SubmissionFile[];
+    grade?: GradeInfo;
+    feedback?: string;
+}
+export interface SubmissionFile {
+    filename: string;
+    url: string;
+    filesize: number;
+    mimetype: string;
+    timemodified: number;
+}
+export interface GradeInfo {
+    grade: string;
+    gradeFormatted: string;
+    grader?: string;
+    timedue?: number;
+    timemodified?: number;
+}
+export interface CourseGrade {
+    courseId: number;
+    courseName: string;
+    grade?: string;
+    gradeFormatted?: string;
+    rank?: number;
+    totalUsers?: number;
+    items?: GradeItem[];
+}
+export interface GradeItem {
+    id: number;
+    name: string;
+    grade?: string;
+    gradeFormatted?: string;
+    range?: string;
+    percentage?: number;
+    weight?: number;
+    feedback?: string;
+    graded?: boolean;
+}
+export interface CalendarEvent {
+    id: number;
+    name: string;
+    description?: string;
+    format: number;
+    courseid?: number;
+    categoryid?: number;
+    groupid?: number;
+    userid?: number;
+    moduleid?: number;
+    modulename?: string;
+    instance?: number;
+    eventtype: string;
+    timestart: number;
+    timeduration?: number;
+    timedue?: number;
+    visible?: number;
+    location?: string;
+}
+export interface QuestionParsing {
+    id: string;
+    text: string;
+    options: {
+        value: string;
+        text: string;
+    }[];
+    type: "radio" | "checkbox";
+}
+export interface QuestionAnswer {
+    questionId: string;
+    reasoning: string;
+    answerValues: string[];
+}
+export type OutputFormat = "json" | "csv" | "table" | "silent";
+export interface OutputOptions {
+    format: OutputFormat;
+    fields?: string[];
+    pretty?: boolean;
+}
+export interface ProgressPayload {
+    view_id: number;
+    currenttime: number;
+    duration: number;
+    percent: number;
+    mapa: string;
+}
+export interface AjaxResponse {
+    error: boolean;
+    data?: {
+        success?: boolean;
+        exec?: string;
+    };
+    exception?: {
+        message: string;
+        errorcode: string;
+    };
+}
+export interface CommandContext {
+    page: Page;
+    session: SessionInfo;
+    config: AppConfig;
+    log: Logger;
+}
+export interface CommandOptions {
+    output?: OutputFormat;
+    courseUrl?: string;
+    courseId?: number;
+    verbose?: boolean;
+    headed?: boolean;
+    dryRun?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/esm/src/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAI5C,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAID,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAID,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAID,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/esm/src/lib/types.js

@@ -0,0 +1 @@
+export {};

package/esm/src/lib/utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns the base directory for config/storage resolving.
+ * Handles both Deno (raw/compiled) and Node.js (npx).
+ */
+export declare function getBaseDir(): string;
+/**
+ * Strip HTML tags from a string.
+ * Preserves text content while removing all HTML markup.
+ */
+export declare function stripHtmlTags(html: string): string;
+/**
+ * Extract clean course name from Moodle fullname.
+ * Removes mlang tags, course codes, and instructor info.
+ * Example: "{mlang zh-tw}1142爵士樂賞析(遠距)-楊曊恩..." -> "爵士樂賞析"
+ */
+export declare function extractCourseName(fullname: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/esm/src/lib/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/src/lib/utils.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CASnC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAelD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO1D"}

package/esm/src/lib/utils.js

@@ -0,0 +1,51 @@
+import * as dntShim from "../../_dnt.shims.js";
+import { dirname } from "node:path";
+/**
+ * Returns the base directory for config/storage resolving.
+ * Handles both Deno (raw/compiled) and Node.js (npx).
+ */
+export function getBaseDir() {
+    // @ts-ignore - Deno global is available in Deno
+    if (typeof dntShim.Deno !== "undefined" && typeof dntShim.Deno.execPath === "function") {
+        // @ts-ignore
+        const exeDir = dirname(dntShim.Deno.execPath());
+        return exeDir.includes("deno") ? process.cwd() : exeDir;
+    }
+    // Node.js or dnt runtime
+    return process.cwd();
+}
+/**
+ * Strip HTML tags from a string.
+ * Preserves text content while removing all HTML markup.
+ */
+export function stripHtmlTags(html) {
+    if (!html)
+        return "";
+    // Remove HTML tags
+    return html.replace(/<[^>]*>/g, "")
+        // Replace HTML entities with their characters
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&#(\d+);/g, (_, dec) => String.fromCharCode(parseInt(dec, 10)))
+        // Clean up excessive whitespace
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/**
+ * Extract clean course name from Moodle fullname.
+ * Removes mlang tags, course codes, and instructor info.
+ * Example: "{mlang zh-tw}1142爵士樂賞析(遠距)-楊曊恩..." -> "爵士樂賞析"
+ */
+export function extractCourseName(fullname) {
+    if (!fullname)
+        return "";
+    // Remove {mlang ...} tags
+    let cleaned = fullname.replace(/\{mlang[^}]*\}/g, "");
+    // Match: 4+ digits + course name (until (, -, or [)
+    const match = cleaned.match(/\d{4,}([^([-]+)/);
+    return match ? match[1].trim() : fullname;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mo7yw4ng/openape",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "CLI tool for CYCU i-Learning platform",
   "keywords": [
     "ilearning",
@@ -12,12 +12,13 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mo7yw4ng/openape.git"
+    "url": "https://github.com/MO7YW4NG/openape"
   },
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/mo7yw4ng/openape/issues"
   },
+  "scripts": {},
   "bin": {
     "openape": "./script/src/index.js"
   },
@@ -25,10 +26,13 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
+    "commander": "^12.1.0",
+    "node-html-parser": "^6.1.13",
+    "playwright-core": "^1.48.0",
     "@deno/shim-deno": "~0.18.0"
   },
   "devDependencies": {
     "@types/node": "^20.9.0"
   },
-  "_generatedBy": "dnt@0.40.0"
+  "_generatedBy": "dnt@dev"
 }