kalvium-worklog 1.0.0

package/dist/discover-position.js

@@ -0,0 +1,121 @@
+import { chromium } from "playwright";
+import { PROFILE_DIR, CONFIG_FILE, ensureInstallDir, saveConfig, } from "./config.js";
+/**
+ * Discover the user's internship position ID by capturing API calls.
+ * Tries headless first, falls back to headed browser for manual login.
+ */
+export async function discoverPosition() {
+    ensureInstallDir();
+    console.log("=== Discovering internship position ID ===\n");
+    // Step 1: Try headless first
+    console.log("1. Trying headless mode (existing session)...");
+    let captured = await discoverViaBrowser(true);
+    if (!captured.token) {
+        console.log("  No valid session. Opening browser for manual login...");
+        captured = await discoverViaBrowser(false);
+    }
+    if (!captured.token) {
+        console.log("\nERROR: Could not capture token. Please log in and try again.");
+        return false;
+    }
+    console.log(`   Token captured: ${captured.token.slice(0, 40)}...`);
+    // Step 2: Extract position ID from captured API URLs
+    const positionId = extractPositionId(captured.api_url ?? "");
+    if (!positionId) {
+        console.log("\nERROR: Could not determine position ID from API calls");
+        return false;
+    }
+    // Step 3: Save config
+    const worklogUrl = `https://student-api.kalvium.community/api/internships/worklogs/${positionId}`;
+    saveConfig({ position_id: positionId, worklog_api_url: worklogUrl });
+    console.log(`\n=== SUCCESS ===`);
+    console.log(`Position ID: ${positionId}`);
+    console.log(`Worklog API: ${worklogUrl}`);
+    console.log(`Saved to: ${CONFIG_FILE}`);
+    return true;
+}
+async function discoverViaBrowser(headless) {
+    const captured = {};
+    const context = await chromium.launchPersistentContext(PROFILE_DIR, {
+        headless: false,
+        args: [
+            "--disable-blink-features=AutomationControlled",
+            ...(headless ? ["--headless=new"] : []),
+        ],
+    });
+    const page = context.pages()[0] ?? (await context.newPage());
+    page.on("request", (req) => {
+        const url = req.url();
+        if (url.includes("student-api.kalvium")) {
+            const auth = req.headers()["authorization"] ?? "";
+            if (auth.startsWith("Bearer ")) {
+                captured.token = auth;
+            }
+            if (url.includes("internships")) {
+                captured.api_url = url;
+                console.log(`  Found API call: ${url}`);
+            }
+        }
+    });
+    if (headless) {
+        console.log("Loading kalvium.community/internships (headless)...");
+        try {
+            await page.goto("https://kalvium.community/internships", {
+                waitUntil: "domcontentloaded",
+                timeout: 30000,
+            });
+            await page
+                .waitForLoadState("networkidle", { timeout: 20000 })
+                .catch(() => { });
+            await page.waitForTimeout(8000);
+        }
+        catch {
+            // ignore
+        }
+    }
+    else {
+        console.log("\n  ========================================");
+        console.log("  Browser opened. Please log in now:");
+        console.log("  1. Click 'Continue with Google'");
+        console.log("  2. Sign in with your Kalvium account");
+        console.log("  3. Complete 2FA if prompted");
+        console.log("  4. Wait — the script continues automatically");
+        console.log("  ========================================\n");
+        await page.goto("https://kalvium.community/internships", {
+            waitUntil: "domcontentloaded",
+            timeout: 120000,
+        });
+        console.log("  Waiting for login to complete (up to 5 minutes)...");
+        for (let i = 0; i < 300; i++) {
+            if (captured.token && captured.api_url)
+                break;
+            await page.waitForTimeout(1000);
+            if (i > 0 && i % 30 === 0) {
+                const url = page.url();
+                if (url.includes("kalvium.community/internships") &&
+                    !url.includes("error")) {
+                    await page
+                        .waitForLoadState("networkidle", { timeout: 5000 })
+                        .catch(() => { });
+                }
+            }
+        }
+    }
+    await context.close();
+    return captured;
+}
+function extractPositionId(apiUrl) {
+    if (!apiUrl)
+        return null;
+    const parts = apiUrl.split("/");
+    const internshipsIdx = parts.indexOf("internships");
+    if (internshipsIdx === -1)
+        return null;
+    for (const part of parts.slice(internshipsIdx + 1)) {
+        // Position IDs are UUIDs (36 chars, 4 dashes)
+        if (part.length === 36 && part.split("-").length === 5) {
+            return part;
+        }
+    }
+    return null;
+}

package/dist/generate-webapp.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generate a phone-friendly web app HTML file with the refresh token embedded.
+ */
+export declare function generateWebapp(outputPath?: string): Promise<boolean>;

package/dist/generate-webapp.js

@@ -0,0 +1,61 @@
+import { readFileSync, writeFileSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+import { loadToken, ensureInstallDir, getPositionIdFromToken } from "./config.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Generate a phone-friendly web app HTML file with the refresh token embedded.
+ */
+export async function generateWebapp(outputPath) {
+    ensureInstallDir();
+    const token = loadToken();
+    if (!token) {
+        console.log("ERROR: No token found. Run `kalvium-worklog login` first.");
+        return false;
+    }
+    // Find template — check dist/templates (published), then ../templates (dev)
+    const templateCandidates = [
+        join(__dirname, "..", "templates", "worklog_template.html"),
+        join(__dirname, "templates", "worklog_template.html"),
+    ];
+    let templateHtml = null;
+    for (const path of templateCandidates) {
+        if (existsSync(path)) {
+            templateHtml = readFileSync(path, "utf-8");
+            break;
+        }
+    }
+    if (!templateHtml) {
+        console.log("ERROR: Template not found.");
+        return false;
+    }
+    // Inject token into HTML
+    const tokenJson = JSON.stringify(token);
+    const injectScript = `
+<script>
+const EMBEDDED_TOKEN = ${tokenJson};
+if (!localStorage.getItem("kalvium_tokens")) {
+    localStorage.setItem("kalvium_tokens", JSON.stringify(EMBEDDED_TOKEN));
+}
+</script>
+`;
+    const html = templateHtml.replace("</body>", injectScript + "\n</body>");
+    // Write output
+    const outPath = outputPath ?? join(homedir(), "KalviumWorklog.html");
+    writeFileSync(outPath, html);
+    console.log(`  Web app generated: ${outPath}`);
+    console.log(`  Size: ${html.length} bytes`);
+    // Show position ID from JWT
+    const posId = getPositionIdFromToken(token);
+    if (posId) {
+        console.log(`  Position ID (from JWT): ${posId}`);
+    }
+    console.log(`\n  To set up on phone:`);
+    console.log(`  1. AirDrop '${outPath}' to your phone, OR`);
+    console.log(`  2. Open the file in Safari → Share → Add to Home Screen`);
+    console.log(`\n  Or manually transfer the token:`);
+    console.log(`  - Open the web app on your phone`);
+    console.log(`  - Tap 'Setup / Token' → paste token JSON → Save`);
+    return true;
+}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { captureToken } from "./capture-token.js";
+export { discoverPosition } from "./discover-position.js";
+export { submitWorklog, checkStatus, dailySubmit, STATUS_OPTIONS } from "./submit.js";
+export type { SubmitOptions, SubmitResult } from "./submit.js";
+export { setupScheduler, removeScheduler } from "./scheduler.js";
+export type { ScheduleOptions } from "./scheduler.js";
+export { generateWebapp } from "./generate-webapp.js";
+export { refreshToken } from "./refresh.js";
+export { loadToken, saveToken, loadConfig, saveConfig, getWorklogApi, INSTALL_DIR, TOKEN_FILE, CONFIG_FILE, LOG_FILE, } from "./config.js";
+export type { TokenData, ConfigData } from "./config.js";

package/dist/index.js

@@ -0,0 +1,7 @@
+export { captureToken } from "./capture-token.js";
+export { discoverPosition } from "./discover-position.js";
+export { submitWorklog, checkStatus, dailySubmit, STATUS_OPTIONS } from "./submit.js";
+export { setupScheduler, removeScheduler } from "./scheduler.js";
+export { generateWebapp } from "./generate-webapp.js";
+export { refreshToken } from "./refresh.js";
+export { loadToken, saveToken, loadConfig, saveConfig, getWorklogApi, INSTALL_DIR, TOKEN_FILE, CONFIG_FILE, LOG_FILE, } from "./config.js";

package/dist/postinstall.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Postinstall script — runs automatically after `npm install kalvium-worklog`.
+ *
+ * If the package is installed globally, prompts the user to run setup.
+ * If installed locally (as a dependency), just prints info.
+ *
+ * IMPORTANT: This must not block or require user input during npm install
+ * in CI environments. It only prints guidance.
+ */
+export {};

package/dist/postinstall.js

@@ -0,0 +1,73 @@
+/**
+ * Postinstall script — runs automatically after `npm install kalvium-worklog`.
+ *
+ * If the package is installed globally, prompts the user to run setup.
+ * If installed locally (as a dependency), just prints info.
+ *
+ * IMPORTANT: This must not block or require user input during npm install
+ * in CI environments. It only prints guidance.
+ */
+import { existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const TOKEN_FILE = join(homedir(), ".kalvium", "refresh_token.json");
+const CONFIG_FILE = join(homedir(), ".kalvium", "config.json");
+// Detect if this is a global install
+const isGlobal = process.env.npm_config_global === "true";
+// Don't run postinstall in CI or during npm publish
+const isCI = process.env.CI === "true" || process.env.GITHUB_ACTIONS === "true";
+if (isCI) {
+    process.exit(0);
+}
+// Use stderr for output — npm suppresses stdout from lifecycle scripts
+// but stderr is always shown
+const log = (msg) => console.error(msg);
+const GREEN = "\x1b[0;32m";
+const CYAN = "\x1b[0;36m";
+const YELLOW = "\x1b[1;33m";
+const BOLD = "\x1b[1m";
+const NC = "\x1b[0m";
+log("");
+log(CYAN + "==".repeat(25) + NC);
+log(CYAN + "   " + BOLD + "Kalvium Worklog" + NC + CYAN + " installed successfully!" + " ".repeat(7) + NC);
+log(CYAN + "==".repeat(25) + NC);
+log("");
+const alreadySetup = existsSync(TOKEN_FILE) && existsSync(CONFIG_FILE);
+if (alreadySetup) {
+    log(GREEN + "OK" + NC + " You are already set up!");
+    log("");
+    log("  Quick commands:");
+    log("    " + BOLD + "kalvium-worklog submit" + NC + "              submit worklog");
+    log("    " + BOLD + "kalvium-worklog status" + NC + "              check status");
+    log("");
+}
+else if (isGlobal) {
+    log("  To get started, run:");
+    log("");
+    log("    " + BOLD + "kalvium-worklog install" + NC);
+    log("");
+    log("  This will:");
+    log("    1. Open a browser for you to log in to Kalvium");
+    log("    2. Auto-discover your internship position ID");
+    log("    3. Set up daily auto-submit at your chosen time");
+    log("    4. Generate a phone web app");
+    log("");
+    log("  Or set up step by step:");
+    log("    " + BOLD + "kalvium-worklog login" + NC + "       log in");
+    log("    " + BOLD + "kalvium-worklog discover" + NC + "    find position ID");
+    log("    " + BOLD + "kalvium-worklog schedule 14:00" + NC + "  daily at 2 PM");
+    log("");
+}
+else {
+    // Local install — use npx
+    log("  To get started, run:");
+    log("");
+    log("    " + BOLD + "npx kalvium-worklog install" + NC);
+    log("");
+    log("  Or install globally first:");
+    log("    " + BOLD + "npm install -g kalvium-worklog" + NC);
+    log("    " + BOLD + "kalvium-worklog install" + NC);
+    log("");
+}
+log("  Docs: " + YELLOW + "https://github.com/kp/kalvium-worklog" + NC);
+log("");

package/dist/refresh.d.ts

@@ -0,0 +1,7 @@
+export declare function log(message: string): void;
+export interface RefreshResult {
+    success: boolean;
+    accessToken?: string;
+    error?: string;
+}
+export declare function refreshToken(): Promise<RefreshResult>;

package/dist/refresh.js

@@ -0,0 +1,42 @@
+import { appendFileSync } from "fs";
+import { LOG_FILE, ensureInstallDir } from "./config.js";
+export function log(message) {
+    ensureInstallDir();
+    const timestamp = new Date().toISOString().replace("T", " ").slice(0, 19);
+    const line = `${timestamp} ${message}\n`;
+    try {
+        appendFileSync(LOG_FILE, line);
+    }
+    catch {
+        // ignore
+    }
+    console.log(message);
+}
+export async function refreshToken() {
+    const { loadToken, saveToken, KEYCLOAK_URL, CLIENT_ID } = await import("./config.js");
+    const token = loadToken();
+    if (!token?.refresh_token) {
+        return { success: false, error: "No refresh token found" };
+    }
+    const body = new URLSearchParams({
+        grant_type: "refresh_token",
+        client_id: CLIENT_ID,
+        refresh_token: token.refresh_token,
+    });
+    try {
+        const res = await fetch(KEYCLOAK_URL, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body,
+        });
+        const data = await res.json();
+        if (data.error) {
+            return { success: false, error: data.error };
+        }
+        saveToken(data);
+        return { success: true, accessToken: data.access_token };
+    }
+    catch (e) {
+        return { success: false, error: String(e) };
+    }
+}

package/dist/scheduler.d.ts

@@ -0,0 +1,15 @@
+export interface ScheduleOptions {
+    hour: number;
+    minute: number;
+}
+/**
+ * Set up daily auto-submit scheduler.
+ * macOS: launchd
+ * Windows: Task Scheduler
+ * Linux: cron
+ */
+export declare function setupScheduler(options: ScheduleOptions): Promise<boolean>;
+/**
+ * Remove the scheduled task.
+ */
+export declare function removeScheduler(): Promise<boolean>;

package/dist/scheduler.js

@@ -0,0 +1,200 @@
+import { homedir, platform } from "os";
+import { join } from "path";
+import { writeFileSync, existsSync, mkdirSync } from "fs";
+import { execSync } from "child_process";
+import { INSTALL_DIR, LOG_FILE, ensureInstallDir } from "./config.js";
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const IS_MAC = platform() === "darwin";
+const IS_WINDOWS = platform() === "win32";
+const IS_LINUX = platform() === "linux";
+/**
+ * Set up daily auto-submit scheduler.
+ * macOS: launchd
+ * Windows: Task Scheduler
+ * Linux: cron
+ */
+export async function setupScheduler(options) {
+    const { hour, minute } = options;
+    if (IS_MAC) {
+        return setupLaunchd(hour, minute);
+    }
+    else if (IS_WINDOWS) {
+        return setupTaskScheduler(hour, minute);
+    }
+    else if (IS_LINUX) {
+        return setupCron(hour, minute);
+    }
+    console.log("Unknown OS — cannot set up scheduler. Use `kalvium-worklog submit` manually.");
+    return false;
+}
+function formatTime(hour, minute) {
+    if (hour < 12)
+        return `${hour}:${minute.toString().padStart(2, "0")} AM`;
+    if (hour === 12)
+        return `12:${minute.toString().padStart(2, "0")} PM`;
+    return `${hour - 12}:${minute.toString().padStart(2, "0")} PM`;
+}
+/**
+ * Copy the daily-submit.js script to ~/.kalvium/ as a wrapper that
+ * imports from the npm package's dist directory (using absolute paths).
+ * This way it works even if the package is updated.
+ */
+function copyDailyScript() {
+    ensureInstallDir();
+    const dst = join(INSTALL_DIR, "daily_submit.js");
+    // Create a wrapper that imports from the package's dist directory
+    const distDir = __dirname;
+    const wrapper = `#!/usr/bin/env node
+// Auto-generated by kalvium-worklog. Do not edit.
+import { dailySubmit } from "${join(distDir, "submit.js")}";
+dailySubmit().then((ok) => process.exit(ok ? 0 : 1));
+`;
+    writeFileSync(dst, wrapper);
+    return dst;
+}
+function setupLaunchd(hour, minute) {
+    const launchAgentsDir = join(homedir(), "Library", "LaunchAgents");
+    if (!existsSync(launchAgentsDir)) {
+        mkdirSync(launchAgentsDir, { recursive: true });
+    }
+    const plistPath = join(launchAgentsDir, "com.kalvium.worklog.plist");
+    const dailyScript = copyDailyScript();
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>com.kalvium.worklog</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${process.execPath}</string>
+        <string>${dailyScript}</string>
+    </array>
+    <key>StartCalendarInterval</key>
+    <dict>
+        <key>Hour</key>
+        <integer>${hour}</integer>
+        <key>Minute</key>
+        <integer>${minute}</integer>
+        <key>Weekday</key>
+        <array>
+            <integer>1</integer>
+            <integer>2</integer>
+            <integer>3</integer>
+            <integer>4</integer>
+            <integer>5</integer>
+        </array>
+    </dict>
+    <key>StandardOutPath</key>
+    <string>${LOG_FILE}</string>
+    <key>StandardErrorPath</key>
+    <string>${LOG_FILE}</string>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>HOME</key>
+        <string>${homedir()}</string>
+        <key>PATH</key>
+        <string>/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin</string>
+    </dict>
+</dict>
+</plist>`;
+    writeFileSync(plistPath, plist);
+    execSync(`launchctl unload "${plistPath}"`, { stdio: "ignore" });
+    execSync(`launchctl load "${plistPath}"`, { stdio: "ignore" });
+    console.log(`Daily auto-submit installed (${formatTime(hour, minute)} every weekday)`);
+    return true;
+}
+function setupTaskScheduler(hour, minute) {
+    const dailyScript = copyDailyScript();
+    const batPath = join(INSTALL_DIR, "daily_submit.bat");
+    // Create batch wrapper
+    writeFileSync(batPath, `@echo off\r\n"${process.execPath}" "${dailyScript}"\r\n`);
+    // Remove existing task
+    try {
+        execSync('schtasks /Delete /TN "KalviumWorklog" /F', { stdio: "ignore" });
+    }
+    catch {
+        // task doesn't exist yet
+    }
+    const timeStr = `${hour.toString().padStart(2, "0")}:${minute
+        .toString()
+        .padStart(2, "0")}`;
+    try {
+        execSync(`schtasks /Create /TN "KalviumWorklog" /TR "${batPath}" /SC WEEKLY /D MON,TUE,WED,THU,FRI /ST ${timeStr} /F`, { stdio: "pipe" });
+        console.log(`Daily auto-submit installed (${formatTime(hour, minute)} every weekday)`);
+        return true;
+    }
+    catch (e) {
+        console.log(`Failed to create scheduled task: ${e}`);
+        return false;
+    }
+}
+function setupCron(hour, minute) {
+    const dailyScript = copyDailyScript();
+    const cronLine = `${minute} ${hour} * * 1-5 ${process.execPath} ${dailyScript} >> ${LOG_FILE} 2>&1`;
+    // Read existing crontab
+    let crontab = "";
+    try {
+        crontab = execSync("crontab -l", { encoding: "utf-8" });
+    }
+    catch {
+        // no crontab yet
+    }
+    // Remove existing kalvium entry
+    const lines = crontab
+        .split("\n")
+        .filter((line) => !line.includes("kalvium") && !line.includes("KalviumWorklog"));
+    // Add new entry
+    lines.push(cronLine);
+    // Write back
+    const newCrontab = lines.join("\n") + "\n";
+    execSync(`echo "${newCrontab.replace(/"/g, '\\"')}" | crontab -`);
+    console.log(`Daily auto-submit installed (${formatTime(hour, minute)} every weekday via cron)`);
+    return true;
+}
+/**
+ * Remove the scheduled task.
+ */
+export async function removeScheduler() {
+    if (IS_MAC) {
+        const plistPath = join(homedir(), "Library/LaunchAgents/com.kalvium.worklog.plist");
+        try {
+            execSync(`launchctl unload "${plistPath}"`, { stdio: "ignore" });
+        }
+        catch {
+            // ignore
+        }
+        if (existsSync(plistPath)) {
+            execSync(`rm "${plistPath}"`);
+        }
+        console.log("Daily auto-submit removed.");
+        return true;
+    }
+    else if (IS_WINDOWS) {
+        try {
+            execSync('schtasks /Delete /TN "KalviumWorklog" /F', { stdio: "ignore" });
+        }
+        catch {
+            // ignore
+        }
+        console.log("Daily auto-submit removed.");
+        return true;
+    }
+    else if (IS_LINUX) {
+        try {
+            const crontab = execSync("crontab -l", { encoding: "utf-8" });
+            const lines = crontab
+                .split("\n")
+                .filter((line) => !line.includes("kalvium") && !line.includes("KalviumWorklog"));
+            execSync(`echo "${lines.join("\n")}" | crontab -`);
+        }
+        catch {
+            // ignore
+        }
+        console.log("Daily auto-submit removed.");
+        return true;
+    }
+    return false;
+}

package/dist/submit.d.ts

@@ -0,0 +1,26 @@
+export interface SubmitOptions {
+    text?: string;
+    status?: string;
+    dryRun?: boolean;
+}
+export interface SubmitResult {
+    success: boolean;
+    message: string;
+    worklogId?: string;
+}
+export declare const STATUS_OPTIONS: Record<string, string>;
+/**
+ * Submit worklog with auto-relogin retry.
+ * If the refresh token has expired, automatically opens a browser
+ * for re-login and retries the submission.
+ */
+export declare function submitWorklog(options?: SubmitOptions): Promise<SubmitResult>;
+/**
+ * Check recent worklog status with auto-relogin retry.
+ */
+export declare function checkStatus(): Promise<void>;
+/**
+ * Daily auto-submit (used by scheduler).
+ * Skips weekends. Logs to file.
+ */
+export declare function dailySubmit(): Promise<boolean>;