saros-proxy 0.1.0

package/dist/scraper.js

@@ -0,0 +1,239 @@
+/**
+ * scraper.ts — Dashboard scraper; Saros uses this to predict account exhaustion.
+ *
+ * Provides both one-shot scraping (scrapeDashboard) and a background scraper
+ * that periodically fetches dashboard pages for all configured accounts.
+ * Uses recursive setTimeout (not setInterval) with AbortController to prevent
+ * overlapping cycles and to support clean shutdown.
+ */
+import { parseAllUsage } from './dashboard-parser.js';
+import { logger } from './logger.js';
+/** Module-level store: workspaceId → AccountUsage */
+const usageStore = new Map();
+/** Active timer handle, if any */
+let scraperTimer = null;
+/** AbortController for the current scrape cycle, if any */
+let abortController = null;
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const FIREFOX_UA = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:136.0) Gecko/20100101 Firefox/136.0';
+const DEFAULT_TIMEOUT_MS = 15_000;
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Combine multiple AbortSignals into one — fires when any of them fire.
+ * Cleans up listeners when any signal fires or when the resulting signal
+ * is garbage collected.
+ */
+function anySignal(signals) {
+    const controller = new AbortController();
+    for (const signal of signals) {
+        if (signal.aborted) {
+            controller.abort(signal.reason);
+            return controller.signal;
+        }
+        signal.addEventListener('abort', () => controller.abort(signal.reason), { once: true });
+    }
+    return controller.signal;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Fetch the OpenCode-Go dashboard and parse usage percentages.
+ *
+ * Makes a single HTTP GET request to `https://opencode.ai/workspace/{workspaceId}/go`
+ * with the provided auth cookie. On a successful 2xx response the HTML is parsed
+ * with {@link parseAllUsage} and the resulting usage data is returned.
+ *
+ * @param workspaceId — The OpenCode workspace identifier.
+ * @param authCookie  — The `auth` cookie value for authentication.
+ * @param options     - Optional settings.
+ * @param options.timeoutMs - Request timeout in milliseconds (default: 15000).
+ * @returns A {@link ScrapeResult} with status, parsed data, and timing info.
+ */
+export async function scrapeDashboard(workspaceId, authCookie, options) {
+    const start = performance.now();
+    const timeoutMs = options?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const url = `https://opencode.ai/workspace/${encodeURIComponent(workspaceId)}/go`;
+    try {
+        // Combine external signal with timeout via race
+        const externalSignal = options?.signal;
+        const timeoutSignal = AbortSignal.timeout(timeoutMs);
+        const combinedSignal = externalSignal
+            ? anySignal([externalSignal, timeoutSignal])
+            : timeoutSignal;
+        const response = await fetch(url, {
+            headers: {
+                Cookie: `auth=${authCookie}`,
+                'User-Agent': FIREFOX_UA,
+            },
+            signal: combinedSignal,
+        });
+        const httpStatus = response.status;
+        const durationMs = Math.round(performance.now() - start);
+        // Classify HTTP error status into a user-facing error message
+        if (!response.ok) {
+            let error;
+            if (httpStatus === 401 || httpStatus === 403) {
+                error = 'Cookie expired or invalid';
+            }
+            else if (httpStatus === 429) {
+                error = 'Rate limited by opencode.ai';
+            }
+            else {
+                error = `HTTP ${httpStatus}`;
+            }
+            return {
+                success: false,
+                error,
+                httpStatus,
+                durationMs,
+            };
+        }
+        // Parse HTML body
+        const html = await response.text();
+        const usage = parseAllUsage(html);
+        return {
+            success: true,
+            usage,
+            httpStatus,
+            durationMs,
+        };
+    }
+    catch (err) {
+        const durationMs = Math.round(performance.now() - start);
+        // Timeout
+        if (err instanceof DOMException && err.name === 'TimeoutError') {
+            return {
+                success: false,
+                error: 'Request timed out',
+                durationMs,
+            };
+        }
+        // Intentional abort (from our AbortController during stop)
+        if (err instanceof DOMException && err.name === 'AbortError') {
+            return {
+                success: false,
+                error: 'Aborted',
+                durationMs,
+            };
+        }
+        // Network or other errors
+        const message = err instanceof Error ? err.message : 'Unknown fetch error';
+        return {
+            success: false,
+            error: message,
+            durationMs,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Usage store accessors
+// ---------------------------------------------------------------------------
+/**
+ * Get all usage data (for health endpoint).
+ */
+export function getAllUsage() {
+    return new Map(usageStore);
+}
+/**
+ * Clear the in-memory usage store (for testing).
+ * Production code should NOT call this unless resetting state is intentional.
+ */
+export function clearUsageStore() {
+    usageStore.clear();
+}
+// ---------------------------------------------------------------------------
+// Timer management
+// ---------------------------------------------------------------------------
+/**
+ * Scrape a single account and update the store.
+ */
+async function scrapeAndStore(account, signal) {
+    const result = await scrapeDashboard(account.workspaceId, account.authCookie, { signal });
+    if (result.success && result.usage) {
+        usageStore.set(account.workspaceId, {
+            usage: result.usage,
+            lastScrapedAt: new Date(),
+        });
+        logger.info({ workspaceId: account.workspaceId, durationMs: result.durationMs }, 'Scraped dashboard for %s', account.workspaceId);
+    }
+    else {
+        const prev = usageStore.get(account.workspaceId);
+        usageStore.set(account.workspaceId, {
+            usage: prev?.usage ?? { rolling: null, weekly: null, monthly: null },
+            lastScrapedAt: new Date(),
+            lastError: result.error ?? 'Unknown error',
+        });
+        logger.warn({ workspaceId: account.workspaceId, error: result.error, httpStatus: result.httpStatus }, 'Failed to scrape dashboard for %s: %s', account.workspaceId, result.error);
+    }
+    // Error already logged and stored above — no further action needed
+}
+/**
+ * Run a full scrape cycle across all configured accounts sequentially.
+ * Checks the abort signal between accounts and returns early if aborted.
+ */
+async function runScrapeCycle(accounts, signal) {
+    for (const account of accounts) {
+        if (signal?.aborted)
+            return;
+        await scrapeAndStore(account, signal);
+    }
+}
+/**
+ * Start the background scraper.
+ * Scrapes all configured accounts every intervalMs using recursive setTimeout,
+ * preventing overlapping cycles. If already running, aborts the previous cycle
+ * and clears its timer first.
+ */
+export function startScraper(accounts, intervalMs) {
+    // Cancel any in-flight cycle and clear any existing timer
+    stopScraper();
+    const controller = new AbortController();
+    abortController = controller;
+    const schedule = async () => {
+        if (controller.signal.aborted)
+            return;
+        await runScrapeCycle(accounts, controller.signal).catch((err) => {
+            logger.error({ err }, 'Scrape cycle failed');
+        });
+        if (controller.signal.aborted)
+            return;
+        scraperTimer = setTimeout(schedule, intervalMs);
+        // Allow the process to exit even if the timer is still running
+        if (scraperTimer && typeof scraperTimer === 'object' && 'unref' in scraperTimer) {
+            scraperTimer.unref();
+        }
+    };
+    // Start first cycle immediately
+    schedule().catch((err) => {
+        logger.error({ err }, 'Initial scrape cycle failed');
+    });
+    logger.info('Background scraper started (interval: %d ms, accounts: %d)', intervalMs, accounts.length);
+}
+/**
+ * Stop the background scraper.
+ * Aborts any in-flight scrape cycle and clears the scheduled timer.
+ */
+export function stopScraper() {
+    if (abortController !== null) {
+        abortController.abort();
+        abortController = null;
+    }
+    if (scraperTimer !== null) {
+        clearTimeout(scraperTimer);
+        scraperTimer = null;
+    }
+    // Only log if we actually stopped something — allows idempotent calls from startScraper
+    // without spurious "stopped" messages when nothing was running.
+}
+/**
+ * Check if the scraper is currently running (either a cycle in flight or a timer scheduled).
+ */
+export function isScraperRunning() {
+    return scraperTimer !== null || abortController !== null;
+}
+//# sourceMappingURL=scraper.js.map

package/dist/scraper.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,34 @@
+/**
+ * validation.ts — Shared validation functions for config and setup.
+ *
+ * Centralises input validation patterns used across config.ts and setup.ts
+ * to ensure consistent rules and reduce duplication.
+ */
+/**
+ * Check if the given value is a valid TCP port number (1–65535).
+ */
+export declare function isValidPort(value: unknown): value is number;
+/**
+ * Check if the given string looks like a valid API key.
+ * Must start with `sk-` and be at least {@link MIN_KEY_LENGTH} characters long.
+ */
+export declare function isValidApiKey(key: unknown): key is string;
+/**
+ * Check if the given value is a valid HTTPS URL.
+ * SSRF prevention: only HTTPS URLs are accepted.
+ */
+export declare function isValidHttpsUrl(url: unknown): url is string;
+/**
+ * Check if the given string is a valid positive integer within an optional range.
+ * Trims whitespace before parsing.
+ *
+ * @param val - The string value to check.
+ * @param min - Minimum accepted value (default: 1).
+ * @param max - Maximum accepted value (default: 100).
+ * @returns `true` if the value is a positive integer in the given range.
+ */
+export declare function isValidPositiveInt(val: string, min?: number, max?: number): boolean;
+/**
+ * Check if the given string is a valid workspace ID (matches `wrk_[A-Za-z0-9]+`).
+ */
+export declare function isValidWorkspaceId(id: unknown): id is string;

package/dist/validation.js

@@ -0,0 +1,64 @@
+/**
+ * validation.ts — Shared validation functions for config and setup.
+ *
+ * Centralises input validation patterns used across config.ts and setup.ts
+ * to ensure consistent rules and reduce duplication.
+ */
+import { API_KEY_PREFIX, MIN_KEY_LENGTH, WORKSPACE_ID_REGEX } from './constants.js';
+/**
+ * Check if the given value is a valid TCP port number (1–65535).
+ */
+export function isValidPort(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (!/^\d+$/.test(trimmed))
+            return false;
+        value = Number.parseInt(trimmed, 10);
+    }
+    return typeof value === 'number' && Number.isInteger(value) && value >= 1 && value <= 65535;
+}
+/**
+ * Check if the given string looks like a valid API key.
+ * Must start with `sk-` and be at least {@link MIN_KEY_LENGTH} characters long.
+ */
+export function isValidApiKey(key) {
+    return typeof key === 'string' && key.startsWith(API_KEY_PREFIX) && key.length >= MIN_KEY_LENGTH;
+}
+/**
+ * Check if the given value is a valid HTTPS URL.
+ * SSRF prevention: only HTTPS URLs are accepted.
+ */
+export function isValidHttpsUrl(url) {
+    if (typeof url !== 'string')
+        return false;
+    try {
+        const parsed = new URL(url);
+        return parsed.protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if the given string is a valid positive integer within an optional range.
+ * Trims whitespace before parsing.
+ *
+ * @param val - The string value to check.
+ * @param min - Minimum accepted value (default: 1).
+ * @param max - Maximum accepted value (default: 100).
+ * @returns `true` if the value is a positive integer in the given range.
+ */
+export function isValidPositiveInt(val, min = 1, max = 100) {
+    const trimmed = val.trim();
+    if (!/^\d+$/.test(trimmed))
+        return false;
+    const n = Number.parseInt(trimmed, 10);
+    return n >= min && n <= max;
+}
+/**
+ * Check if the given string is a valid workspace ID (matches `wrk_[A-Za-z0-9]+`).
+ */
+export function isValidWorkspaceId(id) {
+    return typeof id === 'string' && WORKSPACE_ID_REGEX.test(id);
+}
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpF;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC;AAC9F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,cAAc,CAAC;AACnG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG;IAChE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAW;IAC5C,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "saros-proxy",
+  "version": "0.1.0",
+  "description": "Saros — predictive multi-account proxy for the OpenCode-Go API. Cycles between accounts before they exhaust.",
+  "type": "module",
+  "bin": {
+    "saros-proxy": "dist/index.js",
+    "saros-proxy-setup": "dist/cli/setup.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "setup": "tsx src/cli/setup.ts",
+    "prototype": "tsx prototype/prototype.ts",
+    "proto:usage": "tsx prototype/usage-switching.ts",
+    "proto:probe": "tsx prototype/api-probe.ts",
+    "proto:scrape": "tsx prototype/dashboard-scraper.ts",
+    "proto:setup": "tsx prototype/setup-wizard.ts",
+    "proto:autostart": "tsx prototype/auto-start.ts",
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "vitest",
+    "docker:build": "docker compose build proxy",
+    "docker:run": "docker compose up proxy",
+    "docker:test": "docker compose run --rm test"
+  },
+  "keywords": [
+    "opencode",
+    "proxy",
+    "multi-account",
+    "failover",
+    "load-balancer",
+    "api-gateway",
+    "circuit-breaker",
+    "saros",
+    "saros-proxy"
+  ],
+  "author": "Saros Contributors",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vitorvilaca3011/saros-proxy.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vitorvilaca3011/saros-proxy/issues"
+  },
+  "homepage": "https://github.com/vitorvilaca3011/saros-proxy#readme",
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@vitest/coverage-v8": "^4.1.8",
+    "pino-pretty": "^13.1.3",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.5.1",
+    "@hono/node-server": "^2.0.4",
+    "chalk": "^5.6.2",
+    "hono": "^4.12.23",
+    "hono-rate-limiter": "^0.5.3",
+    "pino": "^10.3.1",
+    "yaml": "^2.9.0"
+  }
+}