website-api 1.1.2 → 1.1.4

package/dist/src/sites/bloomberg.com/index.js

@@ -0,0 +1,49 @@
+import { solvePerimeterX } from "../../challenges/perimeterx.js";
+import { defineSite } from "../../core/define-site.js";
+const BILLIONAIRES_URL = "https://www.bloomberg.com/billionaires/";
+/**
+ * The page embeds the entire ranking inline as a global:
+ *   `window.top500 = [ ...500 objects... ];`
+ * Each entry carries rank, worth/fWorth, biography, netWorthSummary, milestones,
+ * public/private/cash assets, schools, industry, etc. There is no JSON API — the
+ * data lives in the HTML — and the site is fronted by PerimeterX, so a plain
+ * fetch gets flagged. We drive the CDP-attached Chrome, clear any PerimeterX
+ * challenge automatically, then read the global out of the page.
+ */
+export default defineSite({
+    id: "bloomberg-billionaires",
+    name: "Bloomberg Billionaires Index",
+    domain: "bloomberg.com",
+    description: "Extracts the full Bloomberg Billionaires Index (window.top500) via the browser, auto-solving the PerimeterX challenge.",
+    transport: "browser",
+    cookies: "optional", // public data — no login required
+    // `--out <file>` and `--text` are global CLI flags; the framework writes
+    // whatever we return, so we just hand back the ranking array.
+    parameters: [
+        { name: "top", type: "number", description: "Only return the first N entries" },
+        { name: "hold", type: "number", description: "PerimeterX press-&-hold duration in ms (default 11000)" },
+    ],
+    run: async (ctx) => {
+        const page = await ctx.browser();
+        const log = (m) => ctx.debug && console.log(m);
+        // Ensure we're on the billionaires path even if an existing bloomberg tab was reused.
+        if (!page.url().startsWith(BILLIONAIRES_URL)) {
+            await page.goto(BILLIONAIRES_URL, { waitUntil: "domcontentloaded" });
+        }
+        const holdMs = ctx.options.hold !== undefined ? Number(ctx.options.hold) : undefined;
+        const challenge = await solvePerimeterX(page, { holdMs, log });
+        if (!challenge.cleared) {
+            const ref = challenge.referenceId ? ` (reference ${challenge.referenceId})` : "";
+            throw new Error(challenge.kind === "hard-block"
+                ? `Bloomberg served a PerimeterX hard block${ref}. The IP reputation is flagged — wait before retrying.`
+                : `Could not clear the PerimeterX press-&-hold challenge${ref}.`);
+        }
+        // window.top500 is set by an inline script; wait for it to populate.
+        await page.waitForFunction(() => Array.isArray(window.top500) && window.top500.length > 0, { timeout: 20_000 });
+        let data = await page.evaluate(() => window.top500);
+        const top = ctx.options.top !== undefined ? Number(ctx.options.top) : undefined;
+        if (top && top > 0)
+            data = data.slice(0, top);
+        return data;
+    },
+});

package/dist/src/sites/bloomberg.com/openapi.yaml

@@ -0,0 +1,38 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: Bloomberg Billionaires Index
+  description: Extracts the full Bloomberg Billionaires Index (window.top500) via the browser,
+    auto-solving the PerimeterX challenge.
+  version: 1.1.3
+servers:
+  - url: https://bloomberg.com
+paths: {}
+components:
+  securitySchemes:
+    chromeSession:
+      type: apiKey
+      in: cookie
+      name: session
+      description: "Authenticated via the user's real Chrome session: website-api injects decrypted Chrome
+        cookies for bloomberg.com into every request."
+x-website-api:
+  id: bloomberg-billionaires
+  domain: bloomberg.com
+  cookieDomain: bloomberg.com
+  transport: browser
+  cookies: optional
+  requiresLogin: false
+  imperative: true
+  cli:
+    command: website-api bloomberg-billionaires
+    positionals: []
+    parameters:
+      - flag: --top
+        type: number
+        description: Only return the first N entries
+        required: false
+      - flag: --hold
+        type: number
+        description: PerimeterX press-&-hold duration in ms (default 11000)
+        required: false

package/dist/src/sites/chase.com/download-helper.js

@@ -1 +1,266 @@
-import{assertNotHtml as t}from"../../capabilities/download.js";const e={CARD:{mode:"cardGet",count:"/svc/rr/accounts/secure/gateway/credit-card/transactions/inquiry-maintenance/digital-transaction-activity/v1/transaction-counts",csv:"/svc/rr/accounts/secure/gateway/credit-card/transactions/inquiry-maintenance/digital-transaction-activity/v1/transaction-activities"},DDA:{mode:"formPost",count:"/svc/rr/accounts/secure/v1/account/activity/download/count/dda/list",csv:"/svc/rr/accounts/secure/v1/account/activity/download/dda/list"}},n=new Map([["current",{key:"current",label:"Current display, including filters"}],["current-display",{key:"current",label:"Current display, including filters"}],["all",{key:"all",label:"All transactions"}],["all-transactions",{key:"all",label:"All transactions"}],["date-range",{key:"date-range",label:"Choose a date range"}],["date range",{key:"date-range",label:"Choose a date range"}],["choose-date-range",{key:"date-range",label:"Choose a date range"}]]);export function normalizeActivity(t){const e=String(t||"").trim().toLowerCase(),a=n.get(e||"all");if(!a)throw new Error(`Unknown activity option: ${t}`);return a}export async function fetchDownloadOptions(t){t.url().includes("secure.chase.com")||await t.goto("https://secure.chase.com/web/auth/dashboard#/dashboard/overview",{waitUntil:"domcontentloaded"});const e=await t.evaluate(async t=>{const e=await fetch(t.url,{method:"POST",credentials:"include",headers:t.headers,body:""});return{status:e.status,text:await e.text()}},{url:"/svc/rr/accounts/secure/v1/account/activity/download/options/list",headers:{"content-type":"application/x-www-form-urlencoded; charset=UTF-8","x-jpmc-channel":"id=C30","x-jpmc-csrf-token":"NONE"}});if(e.status<200||e.status>=300)throw new Error("Download options request failed with status "+e.status);return JSON.parse(e.text)}export function collectAccounts(t){return(t.downloadAccountActivityOptions||[]).map(t=>({id:String(t.accountId||"").trim(),summaryType:String(t.summaryType||"").trim(),detailType:String(t.detailType||"").trim(),nickname:String(t.nickName||"").trim(),mask:String(t.mask||"").trim()})).filter(t=>t.id&&("CARD"===t.summaryType||"DDA"===t.summaryType)&&t.detailType)}export function formatAccountLabel(t){const e=[];return t.nickname&&e.push(t.nickname),t.mask&&e.push(`****${t.mask}`),e.length||e.push(`${t.summaryType}/${t.detailType}/${t.id}`),e.join(" ")}export function accountFileName(t){return`${[t.nickname||"account",t.summaryType,t.detailType,t.id].map(t=>String(t).trim().replace(/[^A-Za-z0-9._-]+/g,"-")).filter(Boolean).join("-").replace(/-+/g,"-").replace(/^-|-$/g,"")||"account"}.csv`}export function summarizeAccounts(t){const e=[`Found ${t.length} downloadable account${1===t.length?"":"s"}:`];for(const[n,a]of t.entries())e.push(`${n+1}. ${formatAccountLabel(a)} | ${a.summaryType},${a.detailType},${a.id}`);return e.join("\n")}export function selectAccounts(t,e){let n=[];if(e.accounts&&(n=e.accounts.split(/[\s,]+/).map(Number).filter(t=>!isNaN(t))),!n.length){const n=void 0!==e.limit?e.limit:e.first?1:null;return t.slice(0,n||void 0)}const a=[],o=new Set;for(const e of n){if(e<1||e>t.length)throw new Error(`Account number ${e} is out of range. Run list to see 1-${t.length}.`);o.has(e)||(o.add(e),a.push(t[e-1]))}return a}function a(t){return`${t.getFullYear()}${String(t.getMonth()+1).padStart(2,"0")}${String(t.getDate()).padStart(2,"0")}`}function o(t){const e=String(t||"").match(/^(\d{1,2})\/(\d{1,2})\/(\d{4})$/);if(!e)throw new Error(`Invalid date "${t}". Use mm/dd/yyyy format.`);const[,n,a,o]=e;return`${o}${n.padStart(2,"0")}${a.padStart(2,"0")}`}function r(t,e,n){if("CARD"===t.summaryType){const r=new Date,c=new Date(r);c.setFullYear(r.getFullYear()-2);const s={"account-activity-download-type-code":"CSV","digital-account-identifier":t.id};if("date-range"===n){if(!e.from||!e.to)throw new Error("date-range requires from and to in mm/dd/yyyy format");s["start-date"]=o(e.from),s["end-date"]=o(e.to)}else"all"===n&&(s["start-date"]=a(c),s["end-date"]=a(r),s["eligibility-indicator"]="true");return s}const r={transactionType:"ALL",filterTranType:"ALL",statementPeriodId:"ALL",downloadType:"CSV",accountId:t.id};if("all"===n&&(r.dateOption="LAST_24_MONTHS"),"date-range"===n){if(!e.from||!e.to)throw new Error("date-range requires from and to in mm/dd/yyyy format");r.dateOption="DATE_RANGE",r.dateLo=e.from,r.dateHi=e.to}return r}export async function fetchAccountCsv(t,n,a,o){const c=function(t){const n=e[t.summaryType];if(!n)throw new Error(`Unsupported account type for ${formatAccountLabel(t)}: ${t.summaryType}`);return n}(n),s={body:r(n,a,o),countUrl:c.count,csvUrl:c.csv,csrfUrl:"/svc/rl/accounts/secure/v1/csrf/token/list",mode:c.mode,headers:{"content-type":"application/x-www-form-urlencoded; charset=UTF-8","x-jpmc-channel":"id=C30","x-jpmc-csrf-token":"NONE"}},i=await t.evaluate(async t=>{const e=t=>new URLSearchParams(t).toString(),n=(n,a)=>fetch(n+"?"+e(a),{method:"GET",credentials:"include",headers:t.headers}),a=(n,a,o=t.headers)=>fetch(n,{method:"POST",credentials:"include",headers:o,body:e(a)}),o="cardGet"===t.mode?await n(t.countUrl,t.body):await a(t.countUrl,t.body);if(!o.ok)throw new Error("Download count request failed with status "+o.status);const r=await fetch(t.csrfUrl,{method:"POST",credentials:"include",headers:t.headers,body:""});if(!r.ok)throw new Error("CSRF token request failed with status "+r.status);const c=await r.json(),s=c.csrfToken||c.response?.csrfToken;if(!s)throw new Error("CSRF token was not present in Chase token response");const i={...t.body,csrftoken:s,submit:"Submit"},d="cardGet"===t.mode?await n(t.csvUrl,i):await a(t.csvUrl,i,{"content-type":"application/x-www-form-urlencoded"});return{status:d.status,contentType:d.headers.get("content-type")||"",text:await d.text()}},s);if(i.status<200||i.status>=300)throw new Error(`Download request failed with status ${i.status} for ${formatAccountLabel(n)}`);if(i.contentType&&!/csv|text|octet-stream/i.test(i.contentType))throw new Error(`Download for ${formatAccountLabel(n)} returned ${i.contentType||"unknown content type"}`);return i.text}export async function downloadAccounts(e,n){const a=n.options,o=normalizeActivity(a.activity||a.range);if(!("date-range"!==o.key||a.from&&a.to))throw new Error("activity date-range requires from and to in mm/dd/yyyy format");const r=collectAccounts(await fetchDownloadOptions(e));if(!r.length)throw new Error("No downloadable accounts were found in the Chase download options response.");if(a.list)return summarizeAccounts(r);const c=selectAccounts(r,a),s=[];for(const[r,i]of c.entries()){const d=formatAccountLabel(i),u=t(await fetchAccountCsv(e,i,a,o.key),d);if(a.download){const t=a.filename&&1===c.length?a.filename:accountFileName(i),e=await n.save(t,u);s.push(`Saved: ${e}`)}else s.push(`\n===== ${r+1}/${c.length}: ${d} =====\n`+(u.endsWith("\n")?u:`${u}\n`))}return s.join("\n")}
+import { assertNotHtml } from "../../capabilities/download.js";
+const CHASE_DASHBOARD_URL = "https://secure.chase.com/web/auth/dashboard#/dashboard/overview";
+const DOWNLOAD_OPTIONS_URL = "/svc/rr/accounts/secure/v1/account/activity/download/options/list";
+const CSRF_TOKEN_URL = "/svc/rl/accounts/secure/v1/csrf/token/list";
+const DOWNLOAD_ENDPOINTS = {
+    CARD: {
+        mode: "cardGet",
+        count: "/svc/rr/accounts/secure/gateway/credit-card/transactions/inquiry-maintenance/digital-transaction-activity/v1/transaction-counts",
+        csv: "/svc/rr/accounts/secure/gateway/credit-card/transactions/inquiry-maintenance/digital-transaction-activity/v1/transaction-activities",
+    },
+    DDA: {
+        mode: "formPost",
+        count: "/svc/rr/accounts/secure/v1/account/activity/download/count/dda/list",
+        csv: "/svc/rr/accounts/secure/v1/account/activity/download/dda/list",
+    },
+};
+const ACTIVITY_OPTIONS = new Map([
+    ["current", { key: "current", label: "Current display, including filters" }],
+    ["current-display", { key: "current", label: "Current display, including filters" }],
+    ["all", { key: "all", label: "All transactions" }],
+    ["all-transactions", { key: "all", label: "All transactions" }],
+    ["date-range", { key: "date-range", label: "Choose a date range" }],
+    ["date range", { key: "date-range", label: "Choose a date range" }],
+    ["choose-date-range", { key: "date-range", label: "Choose a date range" }],
+]);
+const DEFAULT_ACTIVITY = "all";
+export function normalizeActivity(value) {
+    const key = String(value || "")
+        .trim()
+        .toLowerCase();
+    const option = ACTIVITY_OPTIONS.get(key || DEFAULT_ACTIVITY);
+    if (!option)
+        throw new Error(`Unknown activity option: ${value}`);
+    return option;
+}
+function requestHeaders() {
+    return {
+        "content-type": "application/x-www-form-urlencoded; charset=UTF-8",
+        "x-jpmc-channel": "id=C30",
+        "x-jpmc-csrf-token": "NONE",
+    };
+}
+export async function fetchDownloadOptions(page) {
+    if (!page.url().includes("secure.chase.com")) {
+        await page.goto(CHASE_DASHBOARD_URL, { waitUntil: "domcontentloaded" });
+    }
+    const result = await page.evaluate(async (input) => {
+        const response = await fetch(input.url, {
+            method: "POST",
+            credentials: "include",
+            headers: input.headers,
+            body: "",
+        });
+        return { status: response.status, text: await response.text() };
+    }, { url: DOWNLOAD_OPTIONS_URL, headers: requestHeaders() });
+    if (result.status < 200 || result.status >= 300) {
+        throw new Error("Download options request failed with status " + result.status);
+    }
+    return JSON.parse(result.text);
+}
+export function collectAccounts(payload) {
+    return (payload.downloadAccountActivityOptions || [])
+        .map((account) => ({
+        id: String(account.accountId || "").trim(),
+        summaryType: String(account.summaryType || "").trim(),
+        detailType: String(account.detailType || "").trim(),
+        nickname: String(account.nickName || "").trim(),
+        mask: String(account.mask || "").trim(),
+    }))
+        .filter((a) => a.id && (a.summaryType === "CARD" || a.summaryType === "DDA") && a.detailType);
+}
+export function formatAccountLabel(account) {
+    const bits = [];
+    if (account.nickname)
+        bits.push(account.nickname);
+    if (account.mask)
+        bits.push(`****${account.mask}`);
+    if (!bits.length)
+        bits.push(`${account.summaryType}/${account.detailType}/${account.id}`);
+    return bits.join(" ");
+}
+export function accountFileName(account) {
+    const base = [account.nickname || "account", account.summaryType, account.detailType, account.id]
+        .map((part) => String(part)
+        .trim()
+        .replace(/[^A-Za-z0-9._-]+/g, "-"))
+        .filter(Boolean)
+        .join("-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    return `${base || "account"}.csv`;
+}
+export function summarizeAccounts(accounts) {
+    const lines = [`Found ${accounts.length} downloadable account${accounts.length === 1 ? "" : "s"}:`];
+    for (const [index, account] of accounts.entries()) {
+        lines.push(`${index + 1}. ${formatAccountLabel(account)} | ${account.summaryType},${account.detailType},${account.id}`);
+    }
+    return lines.join("\n");
+}
+export function selectAccounts(accounts, opts) {
+    let indexes = [];
+    if (opts.accounts)
+        indexes = opts.accounts
+            .split(/[\s,]+/)
+            .map(Number)
+            .filter((n) => !Number.isNaN(n));
+    if (!indexes.length) {
+        const limitVal = opts.limit !== undefined ? opts.limit : opts.first ? 1 : null;
+        return accounts.slice(0, limitVal || undefined);
+    }
+    const selected = [];
+    const seen = new Set();
+    for (const n of indexes) {
+        if (n < 1 || n > accounts.length) {
+            throw new Error(`Account number ${n} is out of range. Run list to see 1-${accounts.length}.`);
+        }
+        if (seen.has(n))
+            continue;
+        seen.add(n);
+        selected.push(accounts[n - 1]);
+    }
+    return selected;
+}
+function getEndpoints(account) {
+    const endpoints = DOWNLOAD_ENDPOINTS[account.summaryType];
+    if (!endpoints)
+        throw new Error(`Unsupported account type for ${formatAccountLabel(account)}: ${account.summaryType}`);
+    return endpoints;
+}
+function formatYmd(date) {
+    return `${date.getFullYear()}${String(date.getMonth() + 1).padStart(2, "0")}${String(date.getDate()).padStart(2, "0")}`;
+}
+function parseDateOption(value) {
+    const match = String(value || "").match(/^(\d{1,2})\/(\d{1,2})\/(\d{4})$/);
+    if (!match)
+        throw new Error(`Invalid date "${value}". Use mm/dd/yyyy format.`);
+    const [, month, day, year] = match;
+    return `${year}${month.padStart(2, "0")}${day.padStart(2, "0")}`;
+}
+function buildDownloadBody(account, opts, activityKey) {
+    if (account.summaryType === "CARD") {
+        const today = new Date();
+        const twoYearsAgo = new Date(today);
+        twoYearsAgo.setFullYear(today.getFullYear() - 2);
+        const body = {
+            "account-activity-download-type-code": "CSV",
+            "digital-account-identifier": account.id,
+        };
+        if (activityKey === "date-range") {
+            if (!opts.from || !opts.to)
+                throw new Error("date-range requires from and to in mm/dd/yyyy format");
+            body["start-date"] = parseDateOption(opts.from);
+            body["end-date"] = parseDateOption(opts.to);
+        }
+        else if (activityKey === "all") {
+            body["start-date"] = formatYmd(twoYearsAgo);
+            body["end-date"] = formatYmd(today);
+            body["eligibility-indicator"] = "true";
+        }
+        return body;
+    }
+    const body = {
+        transactionType: "ALL",
+        filterTranType: "ALL",
+        statementPeriodId: "ALL",
+        downloadType: "CSV",
+        accountId: account.id,
+    };
+    if (activityKey === "all")
+        body.dateOption = "LAST_24_MONTHS";
+    if (activityKey === "date-range") {
+        if (!opts.from || !opts.to)
+            throw new Error("date-range requires from and to in mm/dd/yyyy format");
+        body.dateOption = "DATE_RANGE";
+        body.dateLo = opts.from;
+        body.dateHi = opts.to;
+    }
+    return body;
+}
+export async function fetchAccountCsv(page, account, opts, activityKey) {
+    const endpoints = getEndpoints(account);
+    const input = {
+        body: buildDownloadBody(account, opts, activityKey),
+        countUrl: endpoints.count,
+        csvUrl: endpoints.csv,
+        csrfUrl: CSRF_TOKEN_URL,
+        mode: endpoints.mode,
+        headers: requestHeaders(),
+    };
+    const result = await page.evaluate(async (input) => {
+        const encode = (data) => new URLSearchParams(data).toString();
+        const getWithQuery = (url, data) => fetch(url + "?" + encode(data), {
+            method: "GET",
+            credentials: "include",
+            headers: input.headers,
+        });
+        const postForm = (url, data, headers = input.headers) => fetch(url, {
+            method: "POST",
+            credentials: "include",
+            headers: headers,
+            body: encode(data),
+        });
+        const countResponse = input.mode === "cardGet"
+            ? await getWithQuery(input.countUrl, input.body)
+            : await postForm(input.countUrl, input.body);
+        if (!countResponse.ok)
+            throw new Error("Download count request failed with status " + countResponse.status);
+        const tokenResponse = await fetch(input.csrfUrl, {
+            method: "POST",
+            credentials: "include",
+            headers: input.headers,
+            body: "",
+        });
+        if (!tokenResponse.ok)
+            throw new Error("CSRF token request failed with status " + tokenResponse.status);
+        const tokenPayload = await tokenResponse.json();
+        const csrfToken = tokenPayload.csrfToken || tokenPayload.response?.csrfToken;
+        if (!csrfToken)
+            throw new Error("CSRF token was not present in Chase token response");
+        const csvData = { ...input.body, csrftoken: csrfToken, submit: "Submit" };
+        const csvResponse = input.mode === "cardGet"
+            ? await getWithQuery(input.csvUrl, csvData)
+            : await postForm(input.csvUrl, csvData, { "content-type": "application/x-www-form-urlencoded" });
+        return {
+            status: csvResponse.status,
+            contentType: csvResponse.headers.get("content-type") || "",
+            text: await csvResponse.text(),
+        };
+    }, input);
+    if (result.status < 200 || result.status >= 300) {
+        throw new Error(`Download request failed with status ${result.status} for ${formatAccountLabel(account)}`);
+    }
+    if (result.contentType && !/csv|text|octet-stream/i.test(result.contentType)) {
+        throw new Error(`Download for ${formatAccountLabel(account)} returned ${result.contentType || "unknown content type"}`);
+    }
+    return result.text;
+}
+/** Discovers, selects, downloads, and saves (or prints) Chase account CSVs. */
+export async function downloadAccounts(page, ctx) {
+    const opts = ctx.options;
+    const activityOption = normalizeActivity(opts.activity || opts.range);
+    if (activityOption.key === "date-range" && (!opts.from || !opts.to)) {
+        throw new Error("activity date-range requires from and to in mm/dd/yyyy format");
+    }
+    const allAccounts = collectAccounts(await fetchDownloadOptions(page));
+    if (!allAccounts.length)
+        throw new Error("No downloadable accounts were found in the Chase download options response.");
+    if (opts.list)
+        return summarizeAccounts(allAccounts);
+    const accountsToProcess = selectAccounts(allAccounts, opts);
+    const results = [];
+    for (const [index, account] of accountsToProcess.entries()) {
+        const label = formatAccountLabel(account);
+        const csvText = assertNotHtml(await fetchAccountCsv(page, account, opts, activityOption.key), label);
+        if (opts.download) {
+            const fileName = opts.filename && accountsToProcess.length === 1 ? opts.filename : accountFileName(account);
+            const savedPath = await ctx.save(fileName, csvText);
+            results.push(`Saved: ${savedPath}`);
+        }
+        else {
+            results.push(`\n===== ${index + 1}/${accountsToProcess.length}: ${label} =====\n` +
+                (csvText.endsWith("\n") ? csvText : `${csvText}\n`));
+        }
+    }
+    return results.join("\n");
+}

package/dist/src/sites/chase.com/index.js

@@ -1 +1,87 @@
-import{defineSite as e}from"../../core/define-site.js";import{downloadAccounts as t}from"./download-helper.js";export default e({id:"chase",name:"Chase Bank",domain:"chase.com",description:"Logs into Chase, lists downloadable accounts, and downloads statement/transaction CSV files.",transport:"browser",cookies:"optional",keepBrowserOpen:!0,auth:{intendedUrl:"https://secure.chase.com/web/auth/dashboard#/dashboard/overview",emailSelector:'input[name="username"]',passwordSelector:'input[name="password"]',submitButtonSelector:"#signin-button",delayMs:1e3,pwdSelector:'input[type="password"], input[name="password"], input[id*="password"]',usernameSelectors:["#userId-input-field-input","input#userId-input","input#userId",'input[name="usr_name"]'],passwordSelectors:["#password-input-field-input","input#password-input","input#password"],submitSelectors:["#signin-button",'button[type="submit"]'],dashboardSelectors:[".accounts-group-container-bc","#account-groups-component-bc",'[data-testid="accounts-group-container"]',".innerTile","#DDA_ACCOUNTS"]},positionals:[{name:"accounts",description:"Account indexes to select (e.g. 1 3). Leave empty for all.",required:!1,variadic:!0}],parameters:[{name:"list",type:"boolean",description:"List downloadable accounts only",short:"l",default:!1},{name:"download",type:"boolean",description:"Save selected account CSV file(s) to cwd or --out-dir",short:"d",default:!1},{name:"limit",type:"number",description:"Only process the first n accounts"},{name:"first",type:"boolean",description:"Shortcut for --limit 1",default:!1},{name:"filename",type:"string",description:"Save one selected account to this filename (requires --download and one account)"},{name:"activity",type:"string",description:"Activity: current-display, all-transactions, date-range (default: all)"},{name:"range",type:"string",description:"Alias for --activity"},{name:"from",type:"string",description:"Start date for date-range (mm/dd/yyyy)"},{name:"to",type:"string",description:"End date for date-range (mm/dd/yyyy)"},{name:"out-dir",type:"string",description:"Write each CSV to <dir> instead of cwd"}],run:async e=>{const n=await e.browser();return await n.waitForTimeout(3e3),e.debug&&console.log("[chase] Running statement downloader flow..."),t(n,e)}});
+import { defineSite } from "../../core/define-site.js";
+import { downloadAccounts } from "./download-helper.js";
+export default defineSite({
+    id: "chase",
+    name: "Chase Bank",
+    domain: "chase.com",
+    description: "Logs into Chase, lists downloadable accounts, and downloads statement/transaction CSV files.",
+    transport: "browser",
+    cookies: "optional",
+    // Keep the authenticated tab open so the Chase session (and any 2FA) survives
+    // for the next command instead of forcing a fresh login each run.
+    keepBrowserOpen: true,
+    // Declarative login — connect() auto-detects the session and logs in only when
+    // needed. The logon form renders inside a secure.chase.com subframe; the
+    // helper fills whichever candidate is visible there. Primary selectors target
+    // the stable name="" attributes; id-based fallbacks cover DOM variants.
+    auth: {
+        intendedUrl: "https://secure.chase.com/web/auth/dashboard#/dashboard/overview",
+        emailSelector: 'input[name="username"]',
+        passwordSelector: 'input[name="password"]',
+        submitButtonSelector: "#signin-button",
+        delayMs: 1000,
+        pwdSelector: 'input[type="password"], input[name="password"], input[id*="password"]',
+        usernameSelectors: [
+            "#userId-input-field-input",
+            "input#userId-input",
+            "input#userId",
+            'input[name="usr_name"]',
+        ],
+        passwordSelectors: ["#password-input-field-input", "input#password-input", "input#password"],
+        submitSelectors: ["#signin-button", 'button[type="submit"]'],
+        dashboardSelectors: [
+            ".accounts-group-container-bc",
+            "#account-groups-component-bc",
+            '[data-testid="accounts-group-container"]',
+            ".innerTile",
+            "#DDA_ACCOUNTS",
+        ],
+    },
+    positionals: [
+        {
+            name: "accounts",
+            description: "Account indexes to select (e.g. 1 3). Leave empty for all.",
+            required: false,
+            variadic: true,
+        },
+    ],
+    parameters: [
+        {
+            name: "list",
+            type: "boolean",
+            description: "List downloadable accounts only",
+            short: "l",
+            default: false,
+        },
+        {
+            name: "download",
+            type: "boolean",
+            description: "Save selected account CSV file(s) to cwd or --out-dir",
+            short: "d",
+            default: false,
+        },
+        { name: "limit", type: "number", description: "Only process the first n accounts" },
+        { name: "first", type: "boolean", description: "Shortcut for --limit 1", default: false },
+        {
+            name: "filename",
+            type: "string",
+            description: "Save one selected account to this filename (requires --download and one account)",
+        },
+        {
+            name: "activity",
+            type: "string",
+            description: "Activity: current-display, all-transactions, date-range (default: all)",
+        },
+        { name: "range", type: "string", description: "Alias for --activity" },
+        { name: "from", type: "string", description: "Start date for date-range (mm/dd/yyyy)" },
+        { name: "to", type: "string", description: "End date for date-range (mm/dd/yyyy)" },
+        { name: "out-dir", type: "string", description: "Write each CSV to <dir> instead of cwd" },
+    ],
+    run: async (ctx) => {
+        const page = await ctx.browser();
+        await page.waitForTimeout(3000); // let the dashboard settle after navigation/login
+        if (ctx.debug)
+            console.log("[chase] Running statement downloader flow...");
+        return downloadAccounts(page, ctx);
+    },
+});

package/dist/src/sites/chase.com/openapi.yaml

@@ -0,0 +1,76 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: Chase Bank
+  description: Logs into Chase, lists downloadable accounts, and downloads statement/transaction CSV files.
+  version: 1.1.3
+servers:
+  - url: https://chase.com
+paths: {}
+components:
+  securitySchemes:
+    chromeSession:
+      type: apiKey
+      in: cookie
+      name: session
+      description: "Authenticated via the user's real Chrome session: website-api injects decrypted Chrome
+        cookies for chase.com into every request."
+x-website-api:
+  id: chase
+  domain: chase.com
+  cookieDomain: chase.com
+  transport: browser
+  cookies: optional
+  requiresLogin: true
+  imperative: true
+  cli:
+    command: website-api chase
+    positionals:
+      - name: accounts
+        description: Account indexes to select (e.g. 1 3). Leave empty for all.
+        required: false
+        variadic: true
+    parameters:
+      - flag: --list
+        type: boolean
+        description: List downloadable accounts only
+        default: false
+        required: false
+      - flag: --download
+        type: boolean
+        description: Save selected account CSV file(s) to cwd or --out-dir
+        default: false
+        required: false
+      - flag: --limit
+        type: number
+        description: Only process the first n accounts
+        required: false
+      - flag: --first
+        type: boolean
+        description: Shortcut for --limit 1
+        default: false
+        required: false
+      - flag: --filename
+        type: string
+        description: Save one selected account to this filename (requires --download and one account)
+        required: false
+      - flag: --activity
+        type: string
+        description: "Activity: current-display, all-transactions, date-range (default: all)"
+        required: false
+      - flag: --range
+        type: string
+        description: Alias for --activity
+        required: false
+      - flag: --from
+        type: string
+        description: Start date for date-range (mm/dd/yyyy)
+        required: false
+      - flag: --to
+        type: string
+        description: End date for date-range (mm/dd/yyyy)
+        required: false
+      - flag: --out-dir
+        type: string
+        description: Write each CSV to <dir> instead of cwd
+        required: false

package/dist/src/sites/chatgpt.com/index.js

@@ -1 +1,24 @@
-import{defineSite as t}from"../../core/define-site.js";export default t({id:"codex-usage",name:"ChatGPT / Codex Usage",domain:"chatgpt.com",description:"Fetches ChatGPT rate limit usage and quota details from the private wham/usage API.",run:async t=>{const a=await t.http.json("https://chatgpt.com/api/auth/session");if(!a?.accessToken)throw new Error("No ChatGPT login found in browser");return t.http.json("https://chatgpt.com/backend-api/wham/usage",{headers:{authorization:`Bearer ${a.accessToken}`}})}});
+import { defineSite } from "../../core/define-site.js";
+/**
+ * ChatGPT / Codex usage. A two-step flow:
+ *   1. Exchange Chrome cookies for a Bearer JWT via the Next-Auth session endpoint.
+ *   2. Use the JWT to query the private wham/usage endpoint.
+ *
+ * Cookie + User-Agent injection is handled by ctx.http, so the site only
+ * describes the two requests.
+ */
+export default defineSite({
+    id: "codex-usage",
+    name: "ChatGPT / Codex Usage",
+    domain: "chatgpt.com",
+    description: "Fetches ChatGPT rate limit usage and quota details from the private wham/usage API.",
+    run: async (ctx) => {
+        const session = await ctx.http.json("https://chatgpt.com/api/auth/session");
+        if (!session?.accessToken) {
+            throw new Error("No ChatGPT login found in browser");
+        }
+        return ctx.http.json("https://chatgpt.com/backend-api/wham/usage", {
+            headers: { authorization: `Bearer ${session.accessToken}` },
+        });
+    },
+});

package/dist/src/sites/chatgpt.com/openapi.yaml

@@ -0,0 +1,29 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: ChatGPT / Codex Usage
+  description: Fetches ChatGPT rate limit usage and quota details from the private wham/usage API.
+  version: 1.1.3
+servers:
+  - url: https://chatgpt.com
+paths: {}
+components:
+  securitySchemes:
+    chromeSession:
+      type: apiKey
+      in: cookie
+      name: session
+      description: "Authenticated via the user's real Chrome session: website-api injects decrypted Chrome
+        cookies for chatgpt.com into every request."
+x-website-api:
+  id: codex-usage
+  domain: chatgpt.com
+  cookieDomain: chatgpt.com
+  transport: http
+  cookies: required
+  requiresLogin: true
+  imperative: true
+  cli:
+    command: website-api codex-usage
+    positionals: []
+    parameters: []

package/dist/src/sites/claude.ai/claude-helpers.d.ts

@@ -0,0 +1,20 @@
+import type { SiteContext } from "../../types.js";
+/** Subset of the `/api/organizations` entry fields this site relies on. */
+export interface ClaudeOrg {
+    uuid: string;
+    name: string;
+    /** Set (e.g. "stripe_subscription") on paid orgs, null/absent on free ones. */
+    billing_type?: string | null;
+    rate_limit_tier?: string;
+    capabilities?: string[];
+    [key: string]: unknown;
+}
+/** Fetches the organizations visible to the logged-in browser session. */
+export declare function fetchOrganizations(ctx: SiteContext): Promise<ClaudeOrg[]>;
+/** Heuristic: a paid org carries a `billing_type` (e.g. "stripe_subscription"). */
+export declare function isPaidOrg(org: ClaudeOrg): boolean;
+/**
+ * Picks the org to query. Honors an explicit selector (matched by uuid or
+ * name), otherwise prefers the paid account, falling back to the first org.
+ */
+export declare function selectOrg(orgs: ClaudeOrg[], selector?: string): ClaudeOrg;

package/dist/src/sites/claude.ai/claude-helpers.js

@@ -0,0 +1,26 @@
+/** Fetches the organizations visible to the logged-in browser session. */
+export async function fetchOrganizations(ctx) {
+    const orgs = await ctx.http.json("https://claude.ai/api/organizations");
+    if (!Array.isArray(orgs) || orgs.length === 0) {
+        throw new Error("No Claude organizations found in browser session");
+    }
+    return orgs;
+}
+/** Heuristic: a paid org carries a `billing_type` (e.g. "stripe_subscription"). */
+export function isPaidOrg(org) {
+    return typeof org.billing_type === "string" && org.billing_type.length > 0;
+}
+/**
+ * Picks the org to query. Honors an explicit selector (matched by uuid or
+ * name), otherwise prefers the paid account, falling back to the first org.
+ */
+export function selectOrg(orgs, selector) {
+    if (selector) {
+        const s = selector.toLowerCase().trim();
+        const match = orgs.find((o) => o.uuid.toLowerCase() === s || o.name?.toLowerCase() === s);
+        if (!match)
+            throw new Error(`No Claude organization matching "${selector}"`);
+        return match;
+    }
+    return orgs.find(isPaidOrg) ?? orgs[0];
+}

package/dist/src/sites/claude.ai/index.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../../types.js").Site[];
+export default _default;