website-api 1.1.3 → 1.1.4

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

@@ -0,0 +1,39 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: Ollama Usage
+  description: Fetches Ollama plan and usage details from the authenticated settings page.
+  version: 1.1.3
+servers:
+  - url: https://ollama.com
+paths:
+  /settings:
+    get:
+      summary: "Ollama Usage: GET /settings"
+      description: Fetches Ollama plan and usage details from the authenticated settings page.
+      operationId: ollama_usage_get__settings
+      responses:
+        "200":
+          description: Raw text/HTML body
+      security:
+        - chromeSession: []
+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 ollama.com into every request."
+x-website-api:
+  id: ollama-usage
+  domain: ollama.com
+  cookieDomain: ollama.com
+  transport: http
+  cookies: required
+  requiresLogin: true
+  imperative: false
+  cli:
+    command: website-api ollama-usage
+    positionals: []
+    parameters: []

package/dist/src/sites/perplexity.ai/index.js

@@ -1 +1,253 @@
-import{randomUUID as e}from"node:crypto";import{defineSite as t}from"../../core/define-site.js";const r="https://www.perplexity.ai/rest/sse/perplexity_ask";function n(e){return e.replace(/~1/g,"/").replace(/~0/g,"~")}export function applyPatchOne(e,t){const r=t.op,o=t.path??"";if(""===o){if("replace"===r||"add"===r)return t.value;if("remove"===r)return null}const s=o.split("/").slice(1).map(n);null==e&&(e=/^\d+$/.test(s[0]??"")?[]:{});let i=e;for(let e=0;e<s.length-1;e++){const t=s[e],r=/^\d+$/.test(s[e+1]??"");if(Array.isArray(i)){const e=Number(t);for(;i.length<=e;)i.push(r?[]:{});i=i[e]}else i[t]??=r?[]:{},i=i[t]}const a=s.at(-1);if(null==a)return e;if(Array.isArray(i)){const e="-"===a?i.length:Number(a);"add"===r?i.splice(e,0,t.value):"replace"===r?i[e]=t.value:"remove"===r&&i.splice(e,1)}else"remove"===r?delete i[a]:"add"!==r&&"replace"!==r||(i[a]=t.value);return e}export function applyBlockState(e,t){for(const r of t?.blocks??[]){const t=r.intended_usage;for(const[n,o]of Object.entries(r))"intended_usage"!==n&&"diff_block"!==n&&t&&(e[t]=o);const n=r.diff_block;if(n?.field){e[n.field]??=null;for(const t of n.patches??[])e[n.field]=applyPatchOne(e[n.field],t)}}}export function extractAnswer(e,t){for(const t of e?.blocks??[]){const e=t.markdown_block;if(null!=e?.answer)return e.answer;if(Array.isArray(e?.chunks))return e.chunks.join("")}for(const e of["ask_text","ask_text_0_markdown","markdown_block"]){const r=t[e];if(null!=r?.answer)return r.answer;if(Array.isArray(r?.chunks))return r.chunks.join("")}return null}export function reduceFrames(e){const t={};let r=null;for(const n of e)applyBlockState(t,n),(n.final||"COMPLETED"===n.status||n.text_completed)&&(r=n);return!r&&e.length&&(r=e[e.length-1]),{state:t,final:r,answer:extractAnswer(r,t),chunks:e}}export function makeDefaultBody(){return{params:{attachments:[],language:"en-US",timezone:Intl.DateTimeFormat().resolvedOptions().timeZone||"America/New_York",search_focus:"internet",sources:["web"],frontend_uuid:e(),mode:"copilot",model_preference:"claude46sonnet",is_related_query:!1,is_sponsored:!1,frontend_context_uuid:e(),prompt_source:"user",query_source:"home",is_incognito:!1,time_from_first_type:1,local_search_enabled:!1,use_schematized_api:!0,send_back_text_in_streaming_api:!1,supported_block_use_cases:["answer_modes","media_items","knowledge_cards","inline_entity_cards","place_widgets","finance_widgets","prediction_market_widgets","sports_widgets","flight_status_widgets","news_widgets","shopping_widgets","jobs_widgets","search_result_widgets","inline_images","inline_assets","placeholder_cards","diff_blocks","inline_knowledge_cards","entity_group_v2","refinement_filters","canvas_mode","maps_preview","answer_tabs","price_comparison_widgets","preserve_latex","generic_onboarding_widgets","in_context_suggestions","pending_followups","inline_claims","unified_assets","workflow_steps","background_agents"],client_coordinates:null,mentions:[],dsl_query:"",skip_search_enabled:!0,is_nav_suggestions_disabled:!1,source:"default",always_search_override:!1,override_no_search:!1,should_ask_for_mcp_tool_confirmation:!0,browser_agent_allow_once_from_toggle:!1,force_enable_browser_agent:!1,supported_features:["browser_agent_permission_banner_v1.1"],extended_context:!1,version:"2.18"},query_str:""}}export default t({id:"perplexity",name:"Perplexity AI Ask",domain:"perplexity.ai",description:"Fetches live streaming answers from Perplexity AI using its private REST/SSE API.",positionals:[{name:"question",description:"The query or question to ask Perplexity AI",required:!0,variadic:!0}],parameters:[{name:"model",type:"string",description:"Model preference (e.g. 'claude46sonnet')",default:"claude46sonnet",short:"m"},{name:"out",type:"string",description:"Write decoded response JSON to file instead of stdout"},{name:"timeout",type:"number",description:"Request timeout in milliseconds",default:75e3},{name:"text",type:"boolean",description:"Print only the extracted text answer",short:"t"}],run:async t=>{const n=t.options.question,o=t.options.model||"claude46sonnet",s=void 0!==t.options.timeout?Number(t.options.timeout):75e3;if(0===t.cookies().length)throw new Error("No login found in browser. Please log in to perplexity.ai in Google Chrome.");const i=makeDefaultBody();let a;i.params.frontend_uuid=e(),i.params.frontend_context_uuid=e(),i.params.model_preference=o,i.params.dsl_query=n,i.params.time_from_first_type=1,i.query_str=n;try{a=await t.http.sse(r,{method:"POST",headers:{"content-type":"application/json",origin:"https://www.perplexity.ai",referer:"https://www.perplexity.ai/","x-perplexity-request-endpoint":r,"x-request-id":i.params.frontend_uuid},body:JSON.stringify(i),signal:AbortSignal.timeout(s)})}catch(e){if(e instanceof Error&&("AbortError"===e.name||"TimeoutError"===e.name))throw new Error(`Perplexity request timed out after ${s}ms.`);throw e}const l=reduceFrames(a.frames);return{endpoint:r,http_code:a.status,content_type:a.contentType,request:{query:n,model_preference:o,frontend_uuid:i.params.frontend_uuid,frontend_context_uuid:i.params.frontend_context_uuid},answer:l.answer,state:l.state,final:l.final,chunks:l.chunks}}});
+import { randomUUID } from "node:crypto";
+import { defineSite } from "../../core/define-site.js";
+const ENDPOINT = "https://www.perplexity.ai/rest/sse/perplexity_ask";
+// ───────────────────────── SSE frame reducers (pure, testable) ─────────────────────────
+function decodePointerPart(s) {
+    return s.replace(/~1/g, "/").replace(/~0/g, "~");
+}
+export function applyPatchOne(doc, patch) {
+    const op = patch.op;
+    const path = patch.path ?? "";
+    if (path === "") {
+        if (op === "replace" || op === "add")
+            return patch.value;
+        if (op === "remove")
+            return null;
+    }
+    const parts = path.split("/").slice(1).map(decodePointerPart);
+    if (doc == null)
+        doc = /^\d+$/.test(parts[0] ?? "") ? [] : {};
+    let parent = doc;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const key = parts[i];
+        const nextIsArray = /^\d+$/.test(parts[i + 1] ?? "");
+        if (Array.isArray(parent)) {
+            const idx = Number(key);
+            while (parent.length <= idx)
+                parent.push(nextIsArray ? [] : {});
+            parent = parent[idx];
+        }
+        else {
+            parent[key] ??= nextIsArray ? [] : {};
+            parent = parent[key];
+        }
+    }
+    const last = parts.at(-1);
+    if (last == null)
+        return doc;
+    if (Array.isArray(parent)) {
+        const idx = last === "-" ? parent.length : Number(last);
+        if (op === "add")
+            parent.splice(idx, 0, patch.value);
+        else if (op === "replace")
+            parent[idx] = patch.value;
+        else if (op === "remove")
+            parent.splice(idx, 1);
+    }
+    else if (op === "remove") {
+        delete parent[last];
+    }
+    else if (op === "add" || op === "replace") {
+        parent[last] = patch.value;
+    }
+    return doc;
+}
+export function applyBlockState(state, data) {
+    for (const block of data?.blocks ?? []) {
+        const usage = block.intended_usage;
+        for (const [key, value] of Object.entries(block)) {
+            if (key === "intended_usage" || key === "diff_block")
+                continue;
+            if (usage)
+                state[usage] = value;
+        }
+        const diff = block.diff_block;
+        if (!diff?.field)
+            continue;
+        state[diff.field] ??= null;
+        for (const patch of diff.patches ?? []) {
+            state[diff.field] = applyPatchOne(state[diff.field], patch);
+        }
+    }
+}
+export function extractAnswer(final, state) {
+    for (const block of final?.blocks ?? []) {
+        const mb = block.markdown_block;
+        if (mb?.answer != null)
+            return mb.answer;
+        if (Array.isArray(mb?.chunks))
+            return mb.chunks.join("");
+    }
+    for (const key of ["ask_text", "ask_text_0_markdown", "markdown_block"]) {
+        const v = state[key];
+        if (v?.answer != null)
+            return v.answer;
+        if (Array.isArray(v?.chunks))
+            return v.chunks.join("");
+    }
+    return null;
+}
+/** Reduces a list of parsed SSE frames into the final answer + state. */
+export function reduceFrames(frames) {
+    const state = {};
+    let final = null;
+    for (const data of frames) {
+        applyBlockState(state, data);
+        if (data.final || data.status === "COMPLETED" || data.text_completed)
+            final = data;
+    }
+    if (!final && frames.length)
+        final = frames[frames.length - 1];
+    return { state, final, answer: extractAnswer(final, state), chunks: frames };
+}
+export function makeDefaultBody() {
+    return {
+        params: {
+            attachments: [],
+            language: "en-US",
+            timezone: Intl.DateTimeFormat().resolvedOptions().timeZone || "America/New_York",
+            search_focus: "internet",
+            sources: ["web"],
+            frontend_uuid: randomUUID(),
+            mode: "copilot",
+            model_preference: "claude46sonnet",
+            is_related_query: false,
+            is_sponsored: false,
+            frontend_context_uuid: randomUUID(),
+            prompt_source: "user",
+            query_source: "home",
+            is_incognito: false,
+            time_from_first_type: 1,
+            local_search_enabled: false,
+            use_schematized_api: true,
+            send_back_text_in_streaming_api: false,
+            supported_block_use_cases: [
+                "answer_modes",
+                "media_items",
+                "knowledge_cards",
+                "inline_entity_cards",
+                "place_widgets",
+                "finance_widgets",
+                "prediction_market_widgets",
+                "sports_widgets",
+                "flight_status_widgets",
+                "news_widgets",
+                "shopping_widgets",
+                "jobs_widgets",
+                "search_result_widgets",
+                "inline_images",
+                "inline_assets",
+                "placeholder_cards",
+                "diff_blocks",
+                "inline_knowledge_cards",
+                "entity_group_v2",
+                "refinement_filters",
+                "canvas_mode",
+                "maps_preview",
+                "answer_tabs",
+                "price_comparison_widgets",
+                "preserve_latex",
+                "generic_onboarding_widgets",
+                "in_context_suggestions",
+                "pending_followups",
+                "inline_claims",
+                "unified_assets",
+                "workflow_steps",
+                "background_agents",
+            ],
+            client_coordinates: null,
+            mentions: [],
+            dsl_query: "",
+            skip_search_enabled: true,
+            is_nav_suggestions_disabled: false,
+            source: "default",
+            always_search_override: false,
+            override_no_search: false,
+            should_ask_for_mcp_tool_confirmation: true,
+            browser_agent_allow_once_from_toggle: false,
+            force_enable_browser_agent: false,
+            supported_features: ["browser_agent_permission_banner_v1.1"],
+            extended_context: false,
+            version: "2.18",
+        },
+        query_str: "",
+    };
+}
+export default defineSite({
+    id: "perplexity",
+    name: "Perplexity AI Ask",
+    domain: "perplexity.ai",
+    description: "Fetches live streaming answers from Perplexity AI using its private REST/SSE API.",
+    positionals: [
+        {
+            name: "question",
+            description: "The query or question to ask Perplexity AI",
+            required: true,
+            variadic: true,
+        },
+    ],
+    parameters: [
+        {
+            name: "model",
+            type: "string",
+            description: "Model preference (e.g. 'claude46sonnet')",
+            default: "claude46sonnet",
+            short: "m",
+        },
+        { name: "out", type: "string", description: "Write decoded response JSON to file instead of stdout" },
+        { name: "timeout", type: "number", description: "Request timeout in milliseconds", default: 75000 },
+        { name: "text", type: "boolean", description: "Print only the extracted text answer", short: "t" },
+    ],
+    run: async (ctx) => {
+        const question = ctx.options.question;
+        const model = ctx.options.model || "claude46sonnet";
+        const timeout = ctx.options.timeout !== undefined ? Number(ctx.options.timeout) : 75000;
+        if (ctx.cookies().length === 0) {
+            throw new Error("No login found in browser. Please log in to perplexity.ai in Google Chrome.");
+        }
+        const body = makeDefaultBody();
+        body.params.frontend_uuid = randomUUID();
+        body.params.frontend_context_uuid = randomUUID();
+        body.params.model_preference = model;
+        body.params.dsl_query = question;
+        body.params.time_from_first_type = 1;
+        body.query_str = question;
+        let sse;
+        try {
+            sse = await ctx.http.sse(ENDPOINT, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    origin: "https://www.perplexity.ai",
+                    referer: "https://www.perplexity.ai/",
+                    "x-perplexity-request-endpoint": ENDPOINT,
+                    "x-request-id": body.params.frontend_uuid,
+                },
+                body: JSON.stringify(body),
+                signal: AbortSignal.timeout(timeout),
+            });
+        }
+        catch (err) {
+            if (err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError")) {
+                throw new Error(`Perplexity request timed out after ${timeout}ms.`);
+            }
+            throw err;
+        }
+        const decoded = reduceFrames(sse.frames);
+        return {
+            endpoint: ENDPOINT,
+            http_code: sse.status,
+            content_type: sse.contentType,
+            request: {
+                query: question,
+                model_preference: model,
+                frontend_uuid: body.params.frontend_uuid,
+                frontend_context_uuid: body.params.frontend_context_uuid,
+            },
+            answer: decoded.answer,
+            state: decoded.state,
+            final: decoded.final,
+            chunks: decoded.chunks,
+        };
+    },
+});

package/dist/src/sites/perplexity.ai/openapi.yaml

@@ -0,0 +1,51 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: Perplexity AI Ask
+  description: Fetches live streaming answers from Perplexity AI using its private REST/SSE API.
+  version: 1.1.3
+servers:
+  - url: https://perplexity.ai
+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 perplexity.ai into every request."
+x-website-api:
+  id: perplexity
+  domain: perplexity.ai
+  cookieDomain: perplexity.ai
+  transport: http
+  cookies: required
+  requiresLogin: true
+  imperative: true
+  cli:
+    command: website-api perplexity
+    positionals:
+      - name: question
+        description: The query or question to ask Perplexity AI
+        required: true
+        variadic: true
+    parameters:
+      - flag: --model
+        type: string
+        description: Model preference (e.g. 'claude46sonnet')
+        default: claude46sonnet
+        required: false
+      - flag: --out
+        type: string
+        description: Write decoded response JSON to file instead of stdout
+        required: false
+      - flag: --timeout
+        type: number
+        description: Request timeout in milliseconds
+        default: 75000
+        required: false
+      - flag: --text
+        type: boolean
+        description: Print only the extracted text answer
+        required: false

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

@@ -1 +1,243 @@
-import{defineSite as t}from"../../core/define-site.js";import{formatPropertyLabel as e,inferServiceTypeFromPropertyTitle as o,intervalToValue as r,normalizeInterval as a}from"./pseg-helpers.js";const i="https://mysmartenergy.nj.pseg.com/Dashboard";async function n(t,e){if(!e.url().toLowerCase().startsWith("https://mysmartenergy.nj.pseg.com/dashboard")){t.debug&&console.log(`Navigating to Dashboard from '${e.url()}'...`),await e.goto(i,{waitUntil:"domcontentloaded"});await e.locator("#LoginEmail").isVisible().catch(()=>!1)&&(t.debug&&console.log("Session expired or redirected to login. Re-authenticating..."),t.site.auth&&await t.site.auth.ensureLoggedIn({page:e,debug:t.debug,getCredentials:t.credentials}))}}async function s(t,e){return await async function(t,e){if(await n(t,e),!await e.locator('.selectPropertyContainer input[placeholder="Search"]').isVisible().catch(()=>!1)){const t=e.getByRole("link",{name:"Select Property"});await t.waitFor({state:"visible",timeout:5e3}).catch(()=>{});try{await t.click()}catch{await e.locator('a:has-text("Select Property")').first().click()}await e.waitForSelector(".selectPropertyContainer",{state:"visible",timeout:5e3})}}(t,e),e.evaluate(()=>Array.from(document.querySelectorAll(".selectPropertyContainer li")).map(t=>{const e=Array.from(t.querySelectorAll("h4"));return{propertyId:t.getAttribute("data-property-id")||"",propertyType:t.getAttribute("data-property-type")||"",title:t.querySelector("h2")?.textContent?.trim()||"",owner:e[0]?.textContent?.trim()||"",address:e[1]?.textContent?.trim()||"",isCurrent:t.classList.contains("current")}}))}async function l(t,e,o){return t.evaluate(({selector:t,value:e})=>{const o=document.querySelector(t);if(!o)throw new Error(`${t} select not found`);return o.value=e,o.dispatchEvent(new Event("change",{bubbles:!0})),{value:o.value}},{selector:`select[name="${e}"]`,value:o})}async function c(t,e,o){const a="Gas"===e?"4":"1";if("Gas"===e&&"Billing"!==o)throw new Error("Gas usage only supports the Billing interval.");const i=r(o);if(!i)throw new Error(`Unsupported interval mapping: ${o}`);await t.waitForSelector('select[name="SelectedServiceType"]',{state:"attached",timeout:5e3});const n=await l(t,"SelectedServiceType",a);if(n.value!==a)throw new Error(`Failed to set service type: ${JSON.stringify(n)}`);await t.waitForTimeout(500),await t.waitForSelector('select[name="SelectedInterval"]',{state:"attached",timeout:5e3});const s=await async function(t,e){return t.evaluate(t=>{const e=document.querySelector(t);if(!e)throw new Error(`${t} select not found`);return{value:e.value,options:Array.from(e.options).map(t=>({value:t.value,text:t.textContent?.trim()||""}))}},`select[name="${e}"]`)}(t,"SelectedInterval");if(!new Set(s.options.map(t=>t.value)).has(i)){const t=s.options.map(t=>t.text).join(", ");throw new Error(`Interval ${o} is not available for ${e}. Available: ${t}`)}const c=s.value===i?s:await l(t,"SelectedInterval",i);if(c.value!==i)throw new Error(`Failed to set interval: ${JSON.stringify(c)}`);return o}export default t({id:"pseg-usage",name:"PSEG Usage",domain:"mysmartenergy.nj.pseg.com",description:"Downloads PSEG Smart Energy usage data (CSV) or lists available properties.",transport:"browser",cookies:"optional",keepBrowserOpen:!0,auth:{intendedUrl:i,emailSelector:"#LoginEmail",passwordSelector:"#LoginPassword",submitButtonSelector:"button.loginBtn",delayMs:1e3},positionals:[{name:"property",description:"Property name (e.g. '100 Electric') or 1-based index.",required:!1}],parameters:[{name:"interval",type:"string",description:"15, 30, hourly, daily, weekly, monthly, billing",default:"billing",short:"i"},{name:"list",type:"boolean",description:"List all downloadable properties instead of downloading",short:"l"}],run:async t=>{const r=await t.browser();if(t.options.list){const o=await s(t,r),a=["Downloadable properties:"];for(const t of o){const o=t.isCurrent?" [current]":"";a.push(`${e(t)}${o} | ${t.address} | ${t.owner}`)}return a.join("\n")}const i=t.options.property;if(!i)throw new Error("Missing required argument: <property> or --list");const l=a(t.options.interval),u=await s(t,r),d=String(i).trim();let w;if(/^\d+$/.test(d)){const t=Number(d);if(t<1||t>u.length)throw new Error(`Property index ${t} is out of range. Use 1-${u.length}.`);w=u[t-1]}else{const t=d.toLowerCase();if(w=u.find(e=>e.title.trim().toLowerCase()===t)??u.find(o=>e(o).toLowerCase()===t),!w){const t=u.map(t=>e(t)).filter(Boolean).join(", ");throw new Error(`Property not found: ${i}. Available properties: ${t}`)}}const p=await async function(t,r,a){return await r.goto(`https://mysmartenergy.nj.pseg.com/Dashboard/SetMeterGroup?meterGroupId=${a.propertyId}`,{waitUntil:"domcontentloaded"}),await r.waitForTimeout(1e3),{label:e(a),title:a.title,serviceType:o(a.title)}}(0,r,w);return t.debug&&console.log(`Downloading ${p.label} usage CSV for ${l}...`),await n(t,r),await async function(t,e){const o="#downloadOptions";if(!await t.locator(o).isVisible().catch(()=>!1)){e&&console.log("Clicking 'Data' link...");try{await t.getByRole("link",{name:"Data"}).click()}catch{await t.locator('a:has-text("Data")').first().click()}try{return void await t.waitForSelector(o,{state:"visible",timeout:5e3})}catch{}try{await t.getByRole("link",{name:"download"}).click()}catch{await t.locator('a:has-text("download")').first().click()}await t.waitForSelector(o,{state:"visible",timeout:1e4})}}(r,t.debug),await c(r,p.serviceType,l),async function(t){return t.evaluate(async()=>{const t=document.querySelector("#downloadOptions");if(!t)throw new Error("Download form not found");const e=await fetch(t.action,{method:"POST",body:new FormData(t),credentials:"same-origin"});if(!e.ok)throw new Error(`Download request failed with status ${e.status} ${e.statusText}`);return e.text()})}(r)}});
+import { defineSite } from "../../core/define-site.js";
+import { formatPropertyLabel, inferServiceTypeFromPropertyTitle, intervalToValue, normalizeInterval, } from "./pseg-helpers.js";
+const DASHBOARD_URL = "https://mysmartenergy.nj.pseg.com/Dashboard";
+async function gotoDashboardIfNeeded(ctx, page) {
+    const url = page.url().toLowerCase();
+    if (!url.startsWith("https://mysmartenergy.nj.pseg.com/dashboard")) {
+        if (ctx.debug)
+            console.log(`Navigating to Dashboard from '${page.url()}'...`);
+        await page.goto(DASHBOARD_URL, { waitUntil: "domcontentloaded" });
+        const isLoginVisible = await page
+            .locator("#LoginEmail")
+            .isVisible()
+            .catch(() => false);
+        if (isLoginVisible) {
+            if (ctx.debug)
+                console.log("Session expired or redirected to login. Re-authenticating...");
+            if (ctx.site.auth) {
+                await ctx.site.auth.ensureLoggedIn({ page, debug: ctx.debug, getCredentials: ctx.credentials });
+            }
+        }
+    }
+}
+async function ensurePropertyOverlayOpen(ctx, page) {
+    await gotoDashboardIfNeeded(ctx, page);
+    const searchVisible = await page
+        .locator('.selectPropertyContainer input[placeholder="Search"]')
+        .isVisible()
+        .catch(() => false);
+    if (!searchVisible) {
+        const link = page.getByRole("link", { name: "Select Property" });
+        await link.waitFor({ state: "visible", timeout: 5000 }).catch(() => { });
+        try {
+            await link.click();
+        }
+        catch {
+            await page.locator('a:has-text("Select Property")').first().click();
+        }
+        await page.waitForSelector(".selectPropertyContainer", { state: "visible", timeout: 5000 });
+    }
+}
+async function getProperties(ctx, page) {
+    await ensurePropertyOverlayOpen(ctx, page);
+    return page.evaluate(() => {
+        const lis = Array.from(document.querySelectorAll(".selectPropertyContainer li"));
+        return lis.map((li) => {
+            const h4s = Array.from(li.querySelectorAll("h4"));
+            return {
+                propertyId: li.getAttribute("data-property-id") || "",
+                propertyType: li.getAttribute("data-property-type") || "",
+                title: li.querySelector("h2")?.textContent?.trim() || "",
+                owner: h4s[0]?.textContent?.trim() || "",
+                address: h4s[1]?.textContent?.trim() || "",
+                isCurrent: li.classList.contains("current"),
+            };
+        });
+    });
+}
+async function selectProperty(_ctx, page, property) {
+    await page.goto(`https://mysmartenergy.nj.pseg.com/Dashboard/SetMeterGroup?meterGroupId=${property.propertyId}`, { waitUntil: "domcontentloaded" });
+    await page.waitForTimeout(1000);
+    return {
+        label: formatPropertyLabel(property),
+        title: property.title,
+        serviceType: inferServiceTypeFromPropertyTitle(property.title),
+    };
+}
+async function openDownloadPanelIfNeeded(page, debug) {
+    const sel = "#downloadOptions";
+    if (await page
+        .locator(sel)
+        .isVisible()
+        .catch(() => false))
+        return;
+    if (debug)
+        console.log("Clicking 'Data' link...");
+    try {
+        await page.getByRole("link", { name: "Data" }).click();
+    }
+    catch {
+        await page.locator('a:has-text("Data")').first().click();
+    }
+    try {
+        await page.waitForSelector(sel, { state: "visible", timeout: 5000 });
+        return;
+    }
+    catch { }
+    try {
+        await page.getByRole("link", { name: "download" }).click();
+    }
+    catch {
+        await page.locator('a:has-text("download")').first().click();
+    }
+    await page.waitForSelector(sel, { state: "visible", timeout: 10000 });
+}
+async function setNativeSelectValue(page, selectName, value) {
+    return page.evaluate(({ selector, value }) => {
+        const select = document.querySelector(selector);
+        if (!select)
+            throw new Error(`${selector} select not found`);
+        select.value = value;
+        select.dispatchEvent(new Event("change", { bubbles: true }));
+        return { value: select.value };
+    }, { selector: `select[name="${selectName}"]`, value });
+}
+async function getSelectOptions(page, selectName) {
+    return page.evaluate((selector) => {
+        const select = document.querySelector(selector);
+        if (!select)
+            throw new Error(`${selector} select not found`);
+        return {
+            value: select.value,
+            options: Array.from(select.options).map((o) => ({ value: o.value, text: o.textContent?.trim() || "" })),
+        };
+    }, `select[name="${selectName}"]`);
+}
+async function setDownloadOptions(page, serviceType, interval) {
+    const serviceValue = serviceType === "Gas" ? "4" : "1";
+    if (serviceType === "Gas" && interval !== "Billing") {
+        throw new Error("Gas usage only supports the Billing interval.");
+    }
+    const intervalValue = intervalToValue(interval);
+    if (!intervalValue)
+        throw new Error(`Unsupported interval mapping: ${interval}`);
+    await page.waitForSelector('select[name="SelectedServiceType"]', { state: "attached", timeout: 5000 });
+    const serviceState = await setNativeSelectValue(page, "SelectedServiceType", serviceValue);
+    if (serviceState.value !== serviceValue) {
+        throw new Error(`Failed to set service type: ${JSON.stringify(serviceState)}`);
+    }
+    await page.waitForTimeout(500);
+    await page.waitForSelector('select[name="SelectedInterval"]', { state: "attached", timeout: 5000 });
+    const before = await getSelectOptions(page, "SelectedInterval");
+    if (!new Set(before.options.map((o) => o.value)).has(intervalValue)) {
+        const available = before.options.map((o) => o.text).join(", ");
+        throw new Error(`Interval ${interval} is not available for ${serviceType}. Available: ${available}`);
+    }
+    const state = before.value === intervalValue
+        ? before
+        : await setNativeSelectValue(page, "SelectedInterval", intervalValue);
+    if (state.value !== intervalValue)
+        throw new Error(`Failed to set interval: ${JSON.stringify(state)}`);
+    return interval;
+}
+async function fetchDownloadCsvText(page) {
+    return page.evaluate(async () => {
+        const form = document.querySelector("#downloadOptions");
+        if (!form)
+            throw new Error("Download form not found");
+        const response = await fetch(form.action, {
+            method: "POST",
+            body: new FormData(form),
+            credentials: "same-origin",
+        });
+        if (!response.ok)
+            throw new Error(`Download request failed with status ${response.status} ${response.statusText}`);
+        return response.text();
+    });
+}
+export default defineSite({
+    id: "pseg-usage",
+    name: "PSEG Usage",
+    domain: "mysmartenergy.nj.pseg.com",
+    description: "Downloads PSEG Smart Energy usage data (CSV) or lists available properties.",
+    transport: "browser",
+    cookies: "optional",
+    // Keep the authenticated tab open so the PSEG session survives for the next command.
+    keepBrowserOpen: true,
+    // Declarative login — passed as a plain config; the framework wraps it.
+    auth: {
+        intendedUrl: DASHBOARD_URL,
+        emailSelector: "#LoginEmail",
+        passwordSelector: "#LoginPassword",
+        submitButtonSelector: "button.loginBtn",
+        delayMs: 1000,
+    },
+    positionals: [
+        {
+            name: "property",
+            description: "Property name (e.g. '100 Electric') or 1-based index.",
+            required: false,
+        },
+    ],
+    parameters: [
+        {
+            name: "interval",
+            type: "string",
+            description: "15, 30, hourly, daily, weekly, monthly, billing",
+            default: "billing",
+            short: "i",
+        },
+        {
+            name: "list",
+            type: "boolean",
+            description: "List all downloadable properties instead of downloading",
+            short: "l",
+        },
+    ],
+    run: async (ctx) => {
+        const page = await ctx.browser();
+        if (ctx.options.list) {
+            const properties = await getProperties(ctx, page);
+            const out = ["Downloadable properties:"];
+            for (const p of properties) {
+                const tag = p.isCurrent ? " [current]" : "";
+                out.push(`${formatPropertyLabel(p)}${tag} | ${p.address} | ${p.owner}`);
+            }
+            return out.join("\n");
+        }
+        const propertyOption = ctx.options.property;
+        if (!propertyOption)
+            throw new Error("Missing required argument: <property> or --list");
+        const interval = normalizeInterval(ctx.options.interval);
+        const properties = await getProperties(ctx, page);
+        const clean = String(propertyOption).trim();
+        let property;
+        if (/^\d+$/.test(clean)) {
+            const idx = Number(clean);
+            if (idx < 1 || idx > properties.length) {
+                throw new Error(`Property index ${idx} is out of range. Use 1-${properties.length}.`);
+            }
+            property = properties[idx - 1];
+        }
+        else {
+            const target = clean.toLowerCase();
+            property =
+                properties.find((p) => p.title.trim().toLowerCase() === target) ??
+                    properties.find((p) => formatPropertyLabel(p).toLowerCase() === target);
+            if (!property) {
+                const available = properties
+                    .map((p) => formatPropertyLabel(p))
+                    .filter(Boolean)
+                    .join(", ");
+                throw new Error(`Property not found: ${propertyOption}. Available properties: ${available}`);
+            }
+        }
+        const selected = await selectProperty(ctx, page, property);
+        if (ctx.debug)
+            console.log(`Downloading ${selected.label} usage CSV for ${interval}...`);
+        await gotoDashboardIfNeeded(ctx, page);
+        await openDownloadPanelIfNeeded(page, ctx.debug);
+        await setDownloadOptions(page, selected.serviceType, interval);
+        return fetchDownloadCsvText(page);
+    },
+});

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

@@ -0,0 +1,42 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: PSEG Usage
+  description: Downloads PSEG Smart Energy usage data (CSV) or lists available properties.
+  version: 1.1.3
+servers:
+  - url: https://mysmartenergy.nj.pseg.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 mysmartenergy.nj.pseg.com into every request."
+x-website-api:
+  id: pseg-usage
+  domain: mysmartenergy.nj.pseg.com
+  cookieDomain: mysmartenergy.nj.pseg.com
+  transport: browser
+  cookies: optional
+  requiresLogin: true
+  imperative: true
+  cli:
+    command: website-api pseg-usage
+    positionals:
+      - name: property
+        description: Property name (e.g. '100 Electric') or 1-based index.
+        required: false
+        variadic: false
+    parameters:
+      - flag: --interval
+        type: string
+        description: 15, 30, hourly, daily, weekly, monthly, billing
+        default: billing
+        required: false
+      - flag: --list
+        type: boolean
+        description: List all downloadable properties instead of downloading
+        required: false