@goxtechnologies/connectwise-psa-mcp 1.3.0 → 1.4.2

package/dist/services/report-cache.js

@@ -0,0 +1,230 @@
+// ConnectWise PSA MCP Server — SQLite-backed Report Cache
+import { fileURLToPath } from 'url';
+import { join, dirname } from 'path';
+import { createHash } from 'crypto';
+import Database from 'better-sqlite3';
+// ---------------------------------------------------------------------------
+// Default DB path — resolves to data/report-cache.db relative to package root
+// ---------------------------------------------------------------------------
+function defaultDbPath() {
+    const scriptDir = dirname(fileURLToPath(import.meta.url));
+    return join(scriptDir, '..', '..', 'data', 'report-cache.db');
+}
+// ---------------------------------------------------------------------------
+// ReportCache
+// ---------------------------------------------------------------------------
+export class ReportCache {
+    db;
+    constructor(dbPath) {
+        const resolved = dbPath ?? defaultDbPath();
+        this.db = new Database(resolved);
+        this.initialize();
+    }
+    // -------------------------------------------------------------------------
+    // Initialization — apply PRAGMAs then run DDL
+    // -------------------------------------------------------------------------
+    initialize() {
+        // PRAGMAs that affect the connection must be set via pragma(), not exec()
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('synchronous = NORMAL');
+        this.db.pragma('cache_size = -16000');
+        this.db.pragma('temp_store = MEMORY');
+        // Create tables & indexes — exec() handles multi-statement DDL
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS report_cache (
+        id            INTEGER PRIMARY KEY,
+        report_id     TEXT NOT NULL,
+        params_hash   TEXT NOT NULL,
+        params_json   TEXT NOT NULL CHECK(json_valid(params_json)),
+        data          TEXT NOT NULL CHECK(json_valid(data)),
+        fetched_at    INTEGER NOT NULL,
+        source        TEXT NOT NULL CHECK(source IN ('xhr', 'export', 'dom')),
+        UNIQUE(report_id, params_hash)
+      );
+
+      CREATE TABLE IF NOT EXISTS report_history (
+        id            INTEGER PRIMARY KEY,
+        report_id     TEXT NOT NULL,
+        params_hash   TEXT NOT NULL,
+        params_json   TEXT NOT NULL CHECK(json_valid(params_json)),
+        data          TEXT NOT NULL CHECK(json_valid(data)),
+        fetched_at    INTEGER NOT NULL,
+        source        TEXT NOT NULL CHECK(source IN ('xhr', 'export', 'dom'))
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_history_report_fetched ON report_history(report_id, fetched_at DESC);
+      CREATE INDEX IF NOT EXISTS idx_history_fetched_at ON report_history(fetched_at);
+
+      CREATE TABLE IF NOT EXISTS calibration_log (
+        id            INTEGER PRIMARY KEY,
+        report_id     TEXT NOT NULL,
+        params_hash   TEXT NOT NULL,
+        params_json   TEXT NOT NULL CHECK(json_valid(params_json)),
+        web_value     TEXT NOT NULL,
+        api_value     TEXT NOT NULL,
+        match_type    TEXT NOT NULL DEFAULT 'scalar' CHECK(match_type IN ('scalar', 'row_count', 'full_compare')),
+        drift         REAL,
+        logged_at     INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_calibration_report_logged ON calibration_log(report_id, logged_at DESC);
+    `);
+    }
+    // -------------------------------------------------------------------------
+    // hashParams — deep-sort keys, SHA-256, first 16 hex chars
+    // -------------------------------------------------------------------------
+    hashParams(params) {
+        const normalized = sortKeysDeep(params);
+        const json = JSON.stringify(normalized);
+        return createHash('sha256').update(json).digest('hex').slice(0, 16);
+    }
+    // -------------------------------------------------------------------------
+    // get — lookup by (report_id, params_hash), enforce TTL at read time
+    // -------------------------------------------------------------------------
+    get(reportId, paramsHash, ttlMinutes) {
+        const row = this.db
+            .prepare('SELECT * FROM report_cache WHERE report_id = ? AND params_hash = ?')
+            .get(reportId, paramsHash);
+        if (!row)
+            return null;
+        const expiresAt = row.fetched_at + ttlMinutes * 60 * 1000;
+        if (Date.now() >= expiresAt)
+            return null;
+        return {
+            report_id: row.report_id,
+            params_hash: row.params_hash,
+            params_json: row.params_json,
+            data: JSON.parse(row.data),
+            fetched_at: row.fetched_at,
+            source: row.source,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // set — upsert cache + append history in a single transaction
+    // -------------------------------------------------------------------------
+    set(reportId, params, data, source) {
+        const paramsHash = this.hashParams(params);
+        const paramsJson = JSON.stringify(params);
+        const dataJson = JSON.stringify(data);
+        const now = Date.now();
+        const upsert = this.db.prepare(`
+      INSERT INTO report_cache (report_id, params_hash, params_json, data, fetched_at, source)
+      VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT(report_id, params_hash) DO UPDATE SET
+        params_json = excluded.params_json,
+        data        = excluded.data,
+        fetched_at  = excluded.fetched_at,
+        source      = excluded.source
+    `);
+        const appendHistory = this.db.prepare(`
+      INSERT INTO report_history (report_id, params_hash, params_json, data, fetched_at, source)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `);
+        const tx = this.db.transaction(() => {
+            upsert.run(reportId, paramsHash, paramsJson, dataJson, now, source);
+            appendHistory.run(reportId, paramsHash, paramsJson, dataJson, now, source);
+        });
+        tx();
+    }
+    // -------------------------------------------------------------------------
+    // invalidate — delete from cache by report_id, or all if no arg
+    // -------------------------------------------------------------------------
+    invalidate(reportId) {
+        if (reportId !== undefined) {
+            this.db.prepare('DELETE FROM report_cache WHERE report_id = ?').run(reportId);
+        }
+        else {
+            this.db.prepare('DELETE FROM report_cache').run();
+        }
+    }
+    // -------------------------------------------------------------------------
+    // getHistory — ordered by fetched_at DESC
+    // -------------------------------------------------------------------------
+    getHistory(reportId, limit = 50) {
+        const rows = this.db
+            .prepare('SELECT * FROM report_history WHERE report_id = ? ORDER BY fetched_at DESC, id DESC LIMIT ?')
+            .all(reportId, limit);
+        return rows.map((row) => ({
+            id: row.id,
+            report_id: row.report_id,
+            params_hash: row.params_hash,
+            params_json: row.params_json,
+            data: JSON.parse(row.data),
+            fetched_at: row.fetched_at,
+            source: row.source,
+        }));
+    }
+    // -------------------------------------------------------------------------
+    // purgeHistory — delete rows older than retention cutoff, return count
+    // -------------------------------------------------------------------------
+    purgeHistory(retentionDays) {
+        const cutoff = Date.now() - retentionDays * 24 * 60 * 60 * 1000;
+        const result = this.db
+            .prepare('DELETE FROM report_history WHERE fetched_at <= ?')
+            .run(cutoff);
+        return result.changes;
+    }
+    // -------------------------------------------------------------------------
+    // logCalibration — insert into calibration_log
+    // -------------------------------------------------------------------------
+    logCalibration(reportId, params, webValue, apiValue, matchType, drift) {
+        const paramsHash = this.hashParams(params);
+        const paramsJson = JSON.stringify(params);
+        const now = Date.now();
+        this.db
+            .prepare(`
+        INSERT INTO calibration_log
+          (report_id, params_hash, params_json, web_value, api_value, match_type, drift, logged_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      `)
+            .run(reportId, paramsHash, paramsJson, webValue, apiValue, matchType, drift ?? null, now);
+    }
+    // -------------------------------------------------------------------------
+    // getCalibrationLog — ordered by logged_at DESC
+    // -------------------------------------------------------------------------
+    getCalibrationLog(reportId, limit = 50) {
+        const rows = this.db
+            .prepare('SELECT * FROM calibration_log WHERE report_id = ? ORDER BY logged_at DESC LIMIT ?')
+            .all(reportId, limit);
+        return rows.map((row) => ({
+            id: row.id,
+            report_id: row.report_id,
+            params_hash: row.params_hash,
+            params_json: row.params_json,
+            web_value: row.web_value,
+            api_value: row.api_value,
+            match_type: row.match_type,
+            drift: row.drift,
+            logged_at: row.logged_at,
+        }));
+    }
+    // -------------------------------------------------------------------------
+    // close
+    // -------------------------------------------------------------------------
+    close() {
+        this.db.close();
+    }
+}
+// ---------------------------------------------------------------------------
+// Private helpers
+// ---------------------------------------------------------------------------
+/**
+ * Deep-sorts an object's keys recursively so that hashing is order-independent.
+ * Arrays are left in their original order (element order is semantically significant).
+ */
+function sortKeysDeep(value) {
+    if (Array.isArray(value)) {
+        return value.map(sortKeysDeep);
+    }
+    if (value !== null && typeof value === 'object') {
+        const obj = value;
+        return Object.keys(obj)
+            .sort()
+            .reduce((acc, key) => {
+            acc[key] = sortKeysDeep(obj[key]);
+            return acc;
+        }, {});
+    }
+    return value;
+}
+//# sourceMappingURL=report-cache.js.map

package/dist/services/report-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-cache.js","sourceRoot":"","sources":["../../src/services/report-cache.ts"],"names":[],"mappings":"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"}

package/dist/services/report-config.d.ts

@@ -0,0 +1,28 @@
+import type { ReportConfig } from '../types/reports.js';
+/**
+ * Load the report configuration from `data/reports.json`, optionally
+ * deep-merged with a local override file found at:
+ *   1. ~/.config/connectwise-psa/reports.local.json  (primary)
+ *   2. <package_root>/reports.local.json              (fallback)
+ */
+export declare function loadReportConfig(): ReportConfig;
+/**
+ * Deep-merge local overrides into the base config.
+ * - Reports are matched by `id`.
+ * - Matching reports: local fields override base fields (shallow spread — arrays replaced).
+ * - New reports in local (no matching id in base) are appended.
+ */
+export declare function mergeLocalOverrides(base: ReportConfig, local: Partial<ReportConfig>): ReportConfig;
+/**
+ * Replace `{{var}}` placeholders in a template string with values from the
+ * vars map. Unknown placeholders are left as-is.
+ */
+export declare function resolveTemplateVars(template: string, vars: Record<string, string>): string;
+/**
+ * Derive standard template variables from environment:
+ * - `cw_base`    — origin of CW_API_URL (e.g. https://na.myconnectwise.net)
+ * - `cw_version` — CW_WEB_VERSION env var (default: v2025_1)
+ * - `cw_locale`  — CW_LOCALE env var (default: en_CA)
+ */
+export declare function getTemplateVars(): Record<string, string>;
+//# sourceMappingURL=report-config.d.ts.map

package/dist/services/report-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-config.d.ts","sourceRoot":"","sources":["../../src/services/report-config.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,qBAAqB,CAAC;AAkB1E;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAwB/C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAC3B,YAAY,CAoBd;AAkCD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBxD"}

package/dist/services/report-config.js

@@ -0,0 +1,127 @@
+// ConnectWise PSA MCP Server — Report Config Loader
+import { readFileSync, existsSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+// ---------------------------------------------------------------------------
+// Module-level path resolution (same pattern as fast-memory.ts)
+// ---------------------------------------------------------------------------
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/** Resolve the package root directory. When built, __dirname is dist/services/ */
+function getPackageRoot() {
+    return process.env['CLAUDE_PLUGIN_ROOT'] ?? resolve(__dirname, '../..');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Load the report configuration from `data/reports.json`, optionally
+ * deep-merged with a local override file found at:
+ *   1. ~/.config/connectwise-psa/reports.local.json  (primary)
+ *   2. <package_root>/reports.local.json              (fallback)
+ */
+export function loadReportConfig() {
+    // Shipped config — resolved relative to compiled module (dist/services/ → ../../data/)
+    const shippedPath = join(__dirname, '..', '..', 'data', 'reports.json');
+    const base = JSON.parse(readFileSync(shippedPath, 'utf-8'));
+    // Search for local override file
+    const homeDir = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '';
+    const overrideCandidates = [
+        join(homeDir, '.config', 'connectwise-psa', 'reports.local.json'),
+        join(getPackageRoot(), 'reports.local.json'),
+    ];
+    const localPath = overrideCandidates.find((p) => existsSync(p));
+    if (!localPath)
+        return base;
+    let local;
+    try {
+        local = JSON.parse(readFileSync(localPath, 'utf-8'));
+    }
+    catch {
+        // Malformed local file — silently skip
+        return base;
+    }
+    return mergeLocalOverrides(base, local);
+}
+/**
+ * Deep-merge local overrides into the base config.
+ * - Reports are matched by `id`.
+ * - Matching reports: local fields override base fields (shallow spread — arrays replaced).
+ * - New reports in local (no matching id in base) are appended.
+ */
+export function mergeLocalOverrides(base, local) {
+    if (!local.reports || local.reports.length === 0)
+        return base;
+    const merged = base.reports.map((baseReport) => {
+        const localReport = local.reports.find((r) => r.id === baseReport.id);
+        if (!localReport)
+            return baseReport;
+        // Deep-merge: spread base then spread local — this replaces arrays as-is
+        return deepMergeReport(baseReport, localReport);
+    });
+    // Append reports from local that don't exist in base
+    for (const localReport of local.reports) {
+        const existsInBase = base.reports.some((r) => r.id === localReport.id);
+        if (!existsInBase) {
+            merged.push(localReport);
+        }
+    }
+    return { reports: merged };
+}
+/**
+ * Deep-merge two ReportDefinition objects. Local values override base values.
+ * Objects are recursively merged; arrays are replaced (not concatenated).
+ */
+function deepMergeReport(base, local) {
+    const result = { ...base };
+    for (const [key, localVal] of Object.entries(local)) {
+        const baseVal = base[key];
+        if (localVal !== null &&
+            typeof localVal === 'object' &&
+            !Array.isArray(localVal) &&
+            baseVal !== null &&
+            typeof baseVal === 'object' &&
+            !Array.isArray(baseVal)) {
+            // Both are plain objects — recurse
+            result[key] = { ...baseVal, ...localVal };
+        }
+        else {
+            // Primitive, array, or null — local wins outright
+            result[key] = localVal;
+        }
+    }
+    return result;
+}
+/**
+ * Replace `{{var}}` placeholders in a template string with values from the
+ * vars map. Unknown placeholders are left as-is.
+ */
+export function resolveTemplateVars(template, vars) {
+    return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+        return Object.prototype.hasOwnProperty.call(vars, key) ? vars[key] : match;
+    });
+}
+/**
+ * Derive standard template variables from environment:
+ * - `cw_base`    — origin of CW_API_URL (e.g. https://na.myconnectwise.net)
+ * - `cw_version` — CW_WEB_VERSION env var (default: v2025_1)
+ * - `cw_locale`  — CW_LOCALE env var (default: en_CA)
+ */
+export function getTemplateVars() {
+    const apiUrl = process.env['CW_API_URL'] ?? '';
+    let cwBase = '';
+    if (apiUrl) {
+        try {
+            cwBase = new URL(apiUrl).origin;
+        }
+        catch {
+            // Malformed URL — leave empty
+        }
+    }
+    return {
+        cw_base: cwBase,
+        cw_version: process.env['CW_WEB_VERSION'] ?? 'v2025_1',
+        cw_locale: process.env['CW_LOCALE'] ?? 'en_CA',
+    };
+}
+//# sourceMappingURL=report-config.js.map

package/dist/services/report-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-config.js","sourceRoot":"","sources":["../../src/services/report-config.ts"],"names":[],"mappings":"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"}

package/dist/services/totp.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Decodes a base32-encoded string (RFC 4648) into a Buffer.
+ * Case-insensitive. Strips trailing '=' padding.
+ * Throws an Error with "invalid base32" for unrecognised characters.
+ */
+export declare function decodeBase32(input: string): Buffer;
+/**
+ * Generates a 6-digit TOTP code per RFC 6238 / HOTP RFC 4226.
+ *
+ * @param secret  Base32-encoded shared secret
+ * @param counter Time step counter (defaults to current 30-second window)
+ */
+export declare function generateTOTP(secret: string, counter?: number): string;
+/**
+ * Returns the number of seconds remaining in the current 30-second TOTP window.
+ */
+export declare function secondsRemaining(): number;
+/**
+ * Generates a TOTP code, but waits for the next window first if fewer than
+ * `threshold` seconds (default 5) remain in the current window. This prevents
+ * codes from expiring mid-request.
+ *
+ * @param secret    Base32-encoded shared secret
+ * @param threshold Minimum seconds remaining before generating (default 5)
+ */
+export declare function generateTOTPSafe(secret: string, threshold?: number): Promise<string>;
+//# sourceMappingURL=totp.d.ts.map

package/dist/services/totp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"totp.d.ts","sourceRoot":"","sources":["../../src/services/totp.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBlD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAyBrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,SAAS,SAAI,GACZ,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/services/totp.js

@@ -0,0 +1,76 @@
+import { createHmac } from 'node:crypto';
+// RFC 4648 base32 alphabet
+const BASE32_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
+/**
+ * Decodes a base32-encoded string (RFC 4648) into a Buffer.
+ * Case-insensitive. Strips trailing '=' padding.
+ * Throws an Error with "invalid base32" for unrecognised characters.
+ */
+export function decodeBase32(input) {
+    const str = input.toUpperCase().replace(/=+$/, '');
+    let bits = 0;
+    let value = 0;
+    const bytes = [];
+    for (const char of str) {
+        const idx = BASE32_ALPHABET.indexOf(char);
+        if (idx === -1) {
+            throw new Error(`invalid base32 character: '${char}'`);
+        }
+        value = (value << 5) | idx;
+        bits += 5;
+        if (bits >= 8) {
+            bits -= 8;
+            bytes.push((value >>> bits) & 0xff);
+        }
+    }
+    return Buffer.from(bytes);
+}
+/**
+ * Generates a 6-digit TOTP code per RFC 6238 / HOTP RFC 4226.
+ *
+ * @param secret  Base32-encoded shared secret
+ * @param counter Time step counter (defaults to current 30-second window)
+ */
+export function generateTOTP(secret, counter) {
+    const step = counter ?? Math.floor(Date.now() / 1000 / 30);
+    const key = decodeBase32(secret);
+    // Encode counter as 8-byte big-endian buffer
+    const counterBuf = Buffer.alloc(8);
+    // JavaScript bitwise ops are 32-bit; handle upper 32 bits separately
+    const hi = Math.floor(step / 0x100000000);
+    const lo = step >>> 0;
+    counterBuf.writeUInt32BE(hi, 0);
+    counterBuf.writeUInt32BE(lo, 4);
+    const hmac = createHmac('sha1', key).update(counterBuf).digest();
+    // Dynamic truncation
+    const offset = hmac[hmac.length - 1] & 0x0f;
+    const code = (((hmac[offset] & 0x7f) << 24) |
+        ((hmac[offset + 1] & 0xff) << 16) |
+        ((hmac[offset + 2] & 0xff) << 8) |
+        (hmac[offset + 3] & 0xff)) %
+        1_000_000;
+    return code.toString().padStart(6, '0');
+}
+/**
+ * Returns the number of seconds remaining in the current 30-second TOTP window.
+ */
+export function secondsRemaining() {
+    return 30 - (Math.floor(Date.now() / 1000) % 30);
+}
+/**
+ * Generates a TOTP code, but waits for the next window first if fewer than
+ * `threshold` seconds (default 5) remain in the current window. This prevents
+ * codes from expiring mid-request.
+ *
+ * @param secret    Base32-encoded shared secret
+ * @param threshold Minimum seconds remaining before generating (default 5)
+ */
+export async function generateTOTPSafe(secret, threshold = 5) {
+    const remaining = secondsRemaining();
+    if (remaining < threshold) {
+        // Wait for the next window + 100 ms buffer
+        await new Promise((resolve) => setTimeout(resolve, remaining * 1000 + 100));
+    }
+    return generateTOTP(secret);
+}
+//# sourceMappingURL=totp.js.map

package/dist/services/totp.js.map

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

package/dist/services/web-scraper.d.ts

@@ -0,0 +1,76 @@
+import type { Page, Response as PWResponse } from 'playwright';
+/**
+ * Returns true if the `playwright` package is installed and importable.
+ * Result is cached after the first call.
+ */
+export declare function isPlaywrightAvailable(): Promise<boolean>;
+/** Returns the singleton WebScraper instance (creates it on first call). */
+export declare function getWebScraper(): WebScraper;
+export declare class WebScraper {
+    private browser;
+    private context;
+    private initialized;
+    private semaphore;
+    private requestCount;
+    private contextCreatedAt;
+    private cleanupRegistered;
+    private authFailCount;
+    private readonly AUTH_FAIL_LIMIT;
+    constructor();
+    /**
+     * Launch the browser, restore storageState if available, and register
+     * process cleanup hooks. Safe to call multiple times — subsequent calls are
+     * no-ops if already initialized.
+     */
+    init(): Promise<void>;
+    /** Close the browser context and browser cleanly. */
+    shutdown(): Promise<void>;
+    /** Returns true if the browser has been launched and not yet shut down. */
+    isInitialized(): boolean;
+    /**
+     * Ensure the browser session is authenticated.
+     * Fast path: checks cookie expiry in storageState.
+     * Slow path: navigates to CW and runs the login flow.
+     */
+    ensureAuth(): Promise<void>;
+    /**
+     * Returns true if storageState contains at least one non-expired cookie
+     * (with more than SESSION_STALE_WINDOW_MS remaining).
+     */
+    private hasValidSession;
+    /**
+     * Returns true if the current page is showing a login form.
+     */
+    private isOnLoginPage;
+    /**
+     * Walk through the modular login steps, filling in credentials and TOTP as needed.
+     */
+    private authenticate;
+    /**
+     * Acquire an authenticated page.
+     * Recycles context if needed, ensures auth, waits for semaphore, creates page.
+     */
+    acquirePage(): Promise<Page>;
+    /**
+     * Release a page acquired via acquirePage().
+     * Closes the page, releases the semaphore, and cleans the downloads folder.
+     */
+    releasePage(page: Page): void;
+    /**
+     * Run `action` while listening for network responses matching `urlPattern`.
+     * Resolves with all matched responses once the pattern is satisfied or
+     * `timeoutMs` elapses.
+     */
+    captureResponses(page: Page, action: () => Promise<void>, urlPattern: string | RegExp, timeoutMs?: number): Promise<PWResponse[]>;
+    /** Close the existing context and create a fresh one, restoring storageState if present. */
+    private createContext;
+    /** Recycle the browser context if it has been used too much or too long. */
+    private recycleIfNeeded;
+    /** Register process-level cleanup hooks (once). */
+    private registerCleanupHooks;
+    /** Delete all files in the downloads directory. */
+    private cleanDownloads;
+    /** Derive the CW web base URL from CW_API_URL. */
+    private getCWBase;
+}
+//# sourceMappingURL=web-scraper.d.ts.map

package/dist/services/web-scraper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-scraper.d.ts","sourceRoot":"","sources":["../../src/services/web-scraper.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAA2B,IAAI,EAAE,QAAQ,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AA2ExF;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAS9D;AAQD,4EAA4E;AAC5E,wBAAgB,aAAa,IAAI,UAAU,CAG1C;AAMD,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,iBAAiB,CAAS;IAGlC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAK;;IAWrC;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,qDAAqD;IAC/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB/B,2EAA2E;IAC3E,aAAa,IAAI,OAAO;IAQxB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCjC;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkBvB;;OAEG;YACW,aAAa;IAgB3B;;OAEG;YACW,YAAY;IAwD1B;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAclC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAU7B;;;;OAIG;IACG,gBAAgB,CACpB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC3B,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,SAAS,SAAS,GACjB,OAAO,CAAC,UAAU,EAAE,CAAC;IAkCxB,4FAA4F;YAC9E,aAAa;IAsB3B,4EAA4E;YAC9D,eAAe;IAS7B,mDAAmD;IACnD,OAAO,CAAC,oBAAoB;IAkB5B,mDAAmD;IACnD,OAAO,CAAC,cAAc;IAgBtB,kDAAkD;IAClD,OAAO,CAAC,SAAS;CAYlB"}