@mo7yw4ng/openape 1.0.6 → 2.0.3

package/esm/src/lib/auth.js

@@ -1,286 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { chromium } from "playwright-core";
-import { acquireWsToken, loadWsToken, saveWsToken } from "./token.js";
-import { createLogger } from "./logger.js";
-import { getOutputFormat, getSessionPath } from "./utils.js";
-import { extractSessionInfo } from "./session.js";
-/**
- * Find a Chromium-based browser executable on Windows, macOS, or Linux.
- * Priority: Edge → Chrome → Brave
- */
-export function findEdgePath() {
-    const platform = process.platform;
-    if (platform === "darwin") {
-        const candidates = [
-            "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
-            "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
-            "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
-        ];
-        for (const candidate of candidates) {
-            if (fs.existsSync(candidate))
-                return candidate;
-        }
-    }
-    else if (platform === "linux") {
-        const candidates = [
-            "/usr/bin/microsoft-edge",
-            "/usr/bin/google-chrome",
-            "/usr/bin/chromium-browser",
-            "/usr/bin/chromium",
-            "/usr/bin/brave-browser",
-        ];
-        for (const candidate of candidates) {
-            if (fs.existsSync(candidate))
-                return candidate;
-        }
-    }
-    else if (platform === "win32") {
-        const roots = [
-            process.env.PROGRAMFILES,
-            process.env["PROGRAMFILES(X86)"],
-            process.env.LOCALAPPDATA,
-        ].filter(Boolean);
-        const browsers = [
-            { suffix: "Microsoft\\Edge\\Application\\msedge.exe" },
-            { suffix: "Google\\Chrome\\Application\\chrome.exe" },
-            { suffix: "BraveSoftware\\Brave-Browser\\Application\\brave.exe" },
-        ];
-        for (const { suffix } of browsers) {
-            for (const root of roots) {
-                const candidate = path.join(root, suffix);
-                if (fs.existsSync(candidate))
-                    return candidate;
-            }
-        }
-    }
-    else {
-        throw new Error(`不支援的作業系統：${platform}`);
-    }
-    throw new Error("找不到可用的瀏覽器（Edge / Chrome / Brave）。請確認已安裝其中一種。");
-}
-/**
- * Launch a browser and return an authenticated context.
- * Tries to restore a saved session first; falls back to fresh OAuth login.
- * Also acquires Moodle Web Service Token for API calls.
- */
-export async function launchAuthenticated(config, log) {
-    const edgePath = findEdgePath();
-    log.debug(`Using Edge: ${edgePath}`);
-    // Wait a bit to ensure any previous browser process has fully terminated
-    await new Promise(resolve => setTimeout(resolve, 1000));
-    const browser = await chromium.launch({
-        executablePath: edgePath,
-        headless: config.headless,
-        slowMo: config.slowMo,
-    });
-    // Try loading saved WS token first
-    let wsToken = loadWsToken(config.authStatePath) ?? undefined;
-    if (wsToken) {
-        log.info("Loaded saved Web Service Token.");
-    }
-    // Try restoring a saved session
-    const restored = await tryRestoreSession(browser, config, log);
-    if (restored) {
-        const page = restored.pages()[0] ?? (await restored.newPage());
-        // If no saved WS token, try to acquire one
-        if (!wsToken) {
-            try {
-                wsToken = await acquireWsToken(page, config, log);
-                saveWsToken(config.authStatePath, wsToken);
-            }
-            catch {
-                log.warn("Failed to acquire WS Token with restored session, continuing without it.");
-            }
-        }
-        return { browser, context: restored, page, wsToken };
-    }
-    // Fresh login
-    if (config.headless) {
-        await browser.close().catch(() => { });
-        throw new Error("找不到有效的 Session 或是 Session 已過期。\n" +
-            "請先執行 `openape login` 進行手動登入，或是加上 `--headed` 參數執行目前的指令以開啟登入畫面。");
-    }
-    const context = await browser.newContext();
-    const page = await context.newPage();
-    await login(page, config, log);
-    await saveSession(context, config.authStatePath, log);
-    // Acquire WS Token after successful login
-    if (!wsToken) {
-        try {
-            wsToken = await acquireWsToken(page, config, log);
-            saveWsToken(config.authStatePath, wsToken);
-        }
-        catch {
-            log.warn("Failed to acquire WS Token, continuing with sesskey-only auth.");
-        }
-    }
-    return { browser, context, page, wsToken };
-}
-/**
- * Safely close browser and context with timeout.
- * Designed for AI agent usage - no human interaction needed.
- * If noWait is true, initiates cleanup but doesn't wait for completion.
- *
- * Note: Closes sequentially (context first, then browser) to avoid libuv
- * assertion failures on Windows when handles are closed concurrently.
- */
-export async function closeBrowserSafely(browser, context, timeoutMs = 5000, noWait = false) {
-    const closePromises = [];
-    // Close context first with error handling
-    if (context) {
-        closePromises.push(Promise.race([
-            context.close().catch(() => { }),
-            new Promise(resolve => setTimeout(() => resolve(), timeoutMs))
-        ]));
-    }
-    // Close browser after context with error handling
-    closePromises.push(Promise.race([
-        browser.close().catch(() => { }),
-        new Promise(resolve => setTimeout(() => resolve(), timeoutMs))
-    ]));
-    if (noWait) {
-        // Fire and forget - don't wait for cleanup
-        Promise.allSettled(closePromises);
-        return;
-    }
-    // Wait sequentially to avoid libuv issues on Windows
-    for (const promise of closePromises) {
-        await promise.catch(() => { });
-    }
-}
-/**
- * Attempt to restore a session from stored state.
- * Returns null if the stored state doesn't exist or the session is expired.
- */
-async function tryRestoreSession(browser, config, log) {
-    const statePath = path.resolve(config.authStatePath);
-    if (!fs.existsSync(statePath)) {
-        log.debug("No saved session found, will perform fresh login.");
-        return null;
-    }
-    log.info("Restoring saved session...");
-    const context = await browser.newContext({ storageState: statePath });
-    const page = await context.newPage();
-    try {
-        await page.goto(`${config.moodleBaseUrl}/my/`, {
-            waitUntil: "domcontentloaded",
-            timeout: 15000,
-        });
-        // If we got redirected to a login page, the session is expired
-        const url = page.url();
-        if (url.includes("login") || url.includes("microsoftonline")) {
-            log.warn("Saved session expired, will re-authenticate.");
-            await context.close();
-            return null;
-        }
-        log.success("Session restored successfully.");
-        return context;
-    }
-    catch {
-        log.warn("Failed to restore session, will re-authenticate.");
-        await context.close();
-        return null;
-    }
-}
-/**
- * Save the current session state to disk for future reuse.
- */
-async function saveSession(context, statePath, log) {
-    try {
-        await context.storageState({ path: statePath });
-        log.debug("Session saved for future reuse.");
-    }
-    catch (err) {
-        log.warn(`Failed to save session: ${err}`);
-    }
-}
-/**
- * Perform Microsoft OAuth login flow.
- */
-async function login(page, config, log) {
-    log.info("Starting Microsoft OAuth login...");
-    await page.goto(`${config.moodleBaseUrl}/auth/oauth2/login.php`, {
-        waitUntil: "domcontentloaded",
-        timeout: 30000,
-    });
-    // Wait for Microsoft login page or redirect back to Moodle
-    try {
-        await page.waitForURL((url) => url.toString().includes("microsoftonline") ||
-            url.toString().includes("login.microsoftonline") ||
-            (url.toString().includes("ilearning.cycu.edu.tw") &&
-                !url.toString().includes("auth/oauth2/login")), { timeout: 10000 });
-        const url = page.url().toString();
-        if (url.includes("microsoftonline") || url.includes("login.microsoftonline")) {
-            log.info("Microsoft login page detected. Please complete login in the browser.");
-            log.info("Waiting for redirect back to Moodle...");
-            await page.waitForURL((u) => u.toString().includes("ilearning.cycu.edu.tw") &&
-                !u.toString().includes("microsoftonline") &&
-                !u.toString().includes("login.microsoftonline"), { timeout: 300000 });
-        }
-    }
-    catch {
-        // Already logged in or redirected
-    }
-    // Verify we're logged in
-    const finalUrl = page.url().toString();
-    if (finalUrl.includes("login") ||
-        finalUrl.includes("microsoftonline") ||
-        finalUrl === config.moodleBaseUrl + "/auth/oauth2/login.php") {
-        throw new Error(`登入後未重新導向回 Moodle。目前 URL: ${finalUrl}`);
-    }
-    log.success("Login completed successfully.");
-}
-/**
- * Create API context for WS token operations (no browser required).
- * Returns null if session is invalid or WS token is missing.
- */
-export async function createApiContext(options, command) {
-    const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
-    const outputFormat = command ? getOutputFormat(command) : "json";
-    const silent = outputFormat === "json" && !opts.verbose;
-    const log = createLogger(opts.verbose, silent, outputFormat);
-    const sessionPath = getSessionPath();
-    const wsToken = loadWsToken(sessionPath);
-    if (!wsToken) {
-        log.error("未找到 WS token。請先執行 'openape login' 進行登入。");
-        return null;
-    }
-    return {
-        log,
-        session: {
-            wsToken,
-            moodleBaseUrl: "https://ilearning.cycu.edu.tw",
-        },
-    };
-}
-/**
- * Create an authenticated browser context for commands that need page access.
- * Launches a browser, restores or creates a session, and extracts session info.
- */
-export async function createBrowserContext(options, command) {
-    const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
-    const outputFormat = command ? getOutputFormat(command) : "json";
-    const silent = outputFormat === "json" && !opts.verbose;
-    const log = createLogger(opts.verbose, silent, outputFormat);
-    const sessionPath = getSessionPath();
-    const headed = "headed" in options ? options.headed : false;
-    const config = {
-        courseUrl: "",
-        moodleBaseUrl: "https://ilearning.cycu.edu.tw",
-        headless: !headed,
-        slowMo: 0,
-        authStatePath: sessionPath,
-        ollamaBaseUrl: "",
-    };
-    try {
-        log.info("啟動瀏覽器...");
-        const { browser, context, page, wsToken } = await launchAuthenticated(config, log);
-        const session = await extractSessionInfo(page, config, log, wsToken);
-        return { log, page, session, browser, context };
-    }
-    catch (err) {
-        log.error(err instanceof Error ? err.message : String(err));
-        return null;
-    }
-}

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

@@ -1,6 +0,0 @@
-import type { AppConfig } from "./types.js";
-/**
- * Load config from .env file (if it exists).
- */
-export declare function loadConfig(baseDir?: string): AppConfig;
-//# sourceMappingURL=config.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/src/lib/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAgBtD"}

package/esm/src/lib/config.js

@@ -1,36 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-/**
- * Load config from .env file (if it exists).
- */
-export function loadConfig(baseDir) {
-    const envPath = baseDir ? path.resolve(baseDir, ".env") : path.resolve(".env");
-    if (fs.existsSync(envPath)) {
-        const envContent = fs.readFileSync(envPath, "utf8");
-        for (const line of envContent.split("\n")) {
-            const trimmed = line.trim();
-            if (!trimmed || trimmed.startsWith("#"))
-                continue;
-            const eqIdx = trimmed.indexOf("=");
-            if (eqIdx === -1)
-                continue;
-            const key = trimmed.slice(0, eqIdx).trim();
-            const value = trimmed.slice(eqIdx + 1).trim();
-            if (!process.env[key])
-                process.env[key] = value;
-        }
-    }
-    return buildConfig();
-}
-function buildConfig() {
-    const moodleBaseUrl = (process.env.MOODLE_BASE_URL ?? "https://ilearning.cycu.edu.tw").replace(/\/$/, "");
-    return {
-        courseUrl: "",
-        moodleBaseUrl,
-        headless: process.env.HEADLESS !== "false",
-        slowMo: parseInt(process.env.SLOW_MO ?? "0", 10),
-        authStatePath: process.env.AUTH_STATE_PATH ?? ".auth/storage-state.json",
-        ollamaModel: process.env.MODEL,
-        ollamaBaseUrl: (process.env.OLLAMA_BASE_URL ?? "http://localhost:11434").replace(/\/$/, ""),
-    };
-}

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

@@ -1,3 +0,0 @@
-import type { Logger, OutputFormat } from "./types.js";
-export declare function createLogger(verbose?: boolean, silent?: boolean, outputFormat?: OutputFormat): Logger;
-//# sourceMappingURL=logger.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/src/lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAOvD,wBAAgB,YAAY,CAAC,OAAO,UAAQ,EAAE,MAAM,UAAQ,EAAE,YAAY,GAAE,YAAqB,GAAG,MAAM,CAuBzG"}

package/esm/src/lib/logger.js

@@ -1,26 +0,0 @@
-const NO_COLOR = !!process.env.NO_COLOR;
-const c = (code, text) => NO_COLOR ? text : `\x1b[${code}m${text}\x1b[0m`;
-export function createLogger(verbose = false, silent = false, outputFormat = "json") {
-    const errorFn = outputFormat === "json"
-        ? (msg) => console.error(JSON.stringify({ error: msg }))
-        : (msg) => console.error(c("31", "[ERR]") + `   ${msg}`);
-    if (silent) {
-        return {
-            info: (_msg) => { },
-            success: (_msg) => { },
-            warn: (_msg) => { },
-            error: errorFn,
-            debug: (_msg) => { },
-        };
-    }
-    return {
-        info: (msg) => console.error(c("36", "[INFO]") + `  ${msg}`),
-        success: (msg) => console.error(c("32", "[OK]") + `    ${msg}`),
-        warn: (msg) => console.error(c("33", "[WARN]") + `  ${msg}`),
-        error: errorFn,
-        debug: (msg) => {
-            if (verbose)
-                console.error(c("90", "[DBG]") + `   ${msg}`);
-        },
-    };
-}