website-api 1.1.2 → 1.1.4

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

@@ -0,0 +1,303 @@
+import { solvePerimeterX, waitForManualSolve } from "../../challenges/perimeterx.js";
+import { defineSite } from "../../core/define-site.js";
+const ORIGIN = "https://www.zillow.com";
+/**
+ * `getHomeRecs` query (homepage "Trending Homes" / "Selling Soon" collections).
+ * NOTE: /graphql enforces a persisted-query safelist (rejects anything else with
+ * QUERY_NOT_IN_SAFELIST), so this MUST stay byte-for-byte what Zillow's client
+ * sends — do not trim or reformat it.
+ */
+const HOME_RECS_QUERY = `query getHomeRecs($placements: [ModulePlacement]) {
+  collections(
+    cExperienceId: "zillowWebHomePageCollections"
+    placements: $placements
+  ) {
+    collections {
+      __typename
+      contentType
+      recs {
+        id {
+          type
+          value
+          __typename
+        }
+        recsTags {
+          type
+          value
+          __typename
+        }
+        heroImage {
+          id
+          defaultLink
+          mediumSizeLink
+          highResolutionLink
+          __typename
+        }
+        __typename
+      }
+      name
+      placement
+      caption
+      contentType
+      link {
+        displayText
+        url
+        __typename
+      }
+      trackingTags {
+        type
+        value
+        __typename
+      }
+      propertyDetails {
+        address {
+          city
+          state
+          streetAddress
+          zipcode
+          __typename
+        }
+        attributionInfo {
+          brokerName
+          brokerPhoneNumber
+          mlsId
+          mlsName
+          agentName
+          agentPhoneNumber
+          providerLogo
+          __typename
+        }
+        bedrooms
+        bathrooms
+        homeStatus
+        resoFacts {
+          bathroomsFull
+          bathroomsHalf
+          bathroomsOneQuarter
+          bathroomsThreeQuarter
+          __typename
+        }
+        building {
+          buildingName
+          __typename
+        }
+        buildingId
+        country
+        currency
+        hdpUrl
+        newConstructionType
+        price
+        pslHomeType
+        pslMarketingStatus
+        pslProviderCategory
+        pslRawHomeStatus
+        videoId
+        isZillowOwned
+        zestimate
+        pslPublicForeclosureStage
+        listingStatusChangeDate
+        livingAreaValue
+        isRecentStatusChange
+        isPremierBuilder
+        isNonOwnerOccupied
+        isSavedByCurrentSignedInUser
+        totalRequiredMonthlyMaxFee
+        totalRequiredMonthlyMinFee
+        listPriceIncludesRequiredMonthlyFees
+        baseRent
+        photos {
+          url
+          width
+          height
+          __typename
+        }
+        zpid
+        listingMetadata {
+          isAdsRestricted
+          __typename
+        }
+        __typename
+      }
+    }
+    trackingTags {
+      type
+      value
+      __typename
+    }
+    __typename
+  }
+}`;
+/** "New York, NY" → "New-York-NY" for the /homes/.../{slug}_rb/ path. */
+function toRegionSlug(query) {
+    return query.trim().replace(/,\s*/g, "-").replace(/\s+/g, "-");
+}
+/** Zillow returns detailUrl as either an absolute URL or a "/homedetails/..." path. */
+function absUrl(u) {
+    if (!u)
+        return null;
+    return /^https?:\/\//.test(u) ? u : `${ORIGIN}${u}`;
+}
+const STATUS_PATH = {
+    for_sale: "for_sale",
+    for_rent: "for_rent",
+    sold: "recently_sold",
+};
+/**
+ * Zillow is fronted by PerimeterX/HUMAN. The lighter inline press-&-hold is
+ * auto-solved; the hardened iframe variant (what Zillow serves) rejects
+ * synthetic holds, so we fall back to waiting for a one-time human hold in the
+ * attached browser — which sets the _px3/_pxhd clearance cookies for the session.
+ */
+async function clearChallenge(page, log) {
+    const r = await solvePerimeterX(page, { log });
+    if (r.cleared)
+        return;
+    if (r.kind === "hard-block") {
+        throw new Error(`Zillow served a PerimeterX hard block (reference ${r.referenceId ?? "?"}). Wait for the IP to cool.`);
+    }
+    log("[zillow] press-&-hold needs a human — complete it in the attached Chrome window...");
+    const ok = await waitForManualSolve(page, { log });
+    if (!ok) {
+        throw new Error("Zillow PerimeterX press-&-hold was not cleared. Complete it in the attached browser, then retry.");
+    }
+}
+export default defineSite({
+    id: "zillow",
+    name: "Zillow",
+    domain: "zillow.com",
+    description: "Search Zillow listings, list trending homes, and resolve listing URLs (browser transport, auto-handles the PerimeterX challenge).",
+    transport: "browser",
+    cookies: "optional",
+    keepBrowserOpen: true, // keep the px clearance cookie warm for subsequent runs
+    parameters: [
+        {
+            name: "search",
+            type: "string",
+            description: 'Place to search, e.g. "Austin, TX" or "New York, NY"',
+            short: "s",
+        },
+        {
+            name: "status",
+            type: "string",
+            description: "for_sale | for_rent | sold (default for_sale)",
+            default: "for_sale",
+        },
+        {
+            name: "trending",
+            type: "boolean",
+            description: "List homepage trending / selling-soon collections",
+            short: "t",
+        },
+        { name: "zpid", type: "string", description: "Return the canonical listing URL for a zpid" },
+        { name: "limit", type: "number", description: "Cap the number of results returned" },
+        { name: "hold", type: "number", description: "PerimeterX press-&-hold duration in ms (default 11000)" },
+    ],
+    run: async (ctx) => {
+        // zpid → URL needs no network.
+        if (ctx.options.zpid) {
+            const zpid = String(ctx.options.zpid);
+            return { zpid, url: `${ORIGIN}/homedetails/${zpid}_zpid/` };
+        }
+        const page = await ctx.browser();
+        const log = (m) => ctx.debug && console.log(m);
+        const limit = ctx.options.limit !== undefined ? Number(ctx.options.limit) : undefined;
+        await clearChallenge(page, log);
+        // ── Trending homes (homepage collections via getHomeRecs) ──
+        if (ctx.options.trending) {
+            if (!page.url().startsWith(`${ORIGIN}/`) || new URL(page.url()).pathname !== "/") {
+                await page.goto(`${ORIGIN}/`, { waitUntil: "domcontentloaded" });
+                await clearChallenge(page, log);
+            }
+            const data = await page.evaluate(async (query) => {
+                const res = await fetch("/graphql", {
+                    method: "POST",
+                    credentials: "include",
+                    headers: {
+                        "content-type": "application/json",
+                        "client-id": "hops-homepage",
+                        "x-caller-id": "hops-homepage",
+                    },
+                    body: JSON.stringify({ operationName: "getHomeRecs", query, variables: {} }),
+                });
+                return res.json();
+            }, HOME_RECS_QUERY);
+            const cols = data?.data?.collections?.collections ?? [];
+            const collections = cols.map((c) => ({
+                name: c.name,
+                caption: c.caption,
+                contentType: c.contentType,
+                seeMoreUrl: c.link?.url ?? null,
+                homes: (c.propertyDetails ?? []).map((p) => ({
+                    zpid: p.zpid,
+                    url: absUrl(p.hdpUrl),
+                    price: p.price,
+                    beds: p.bedrooms,
+                    baths: p.bathrooms,
+                    area: p.livingAreaValue,
+                    status: p.homeStatus,
+                    address: p.address
+                        ? `${p.address.streetAddress}, ${p.address.city}, ${p.address.state} ${p.address.zipcode}`
+                        : null,
+                })),
+            }));
+            return { source: "getHomeRecs", collections };
+        }
+        // ── Search listings (navigate region URL → replay async-create-search-page-state) ──
+        if (ctx.options.search) {
+            const slug = toRegionSlug(String(ctx.options.search));
+            const status = STATUS_PATH[String(ctx.options.status || "for_sale")] ?? "for_sale";
+            await page.goto(`${ORIGIN}/homes/${status}/${slug}_rb/`, { waitUntil: "domcontentloaded" });
+            await clearChallenge(page, log);
+            const payload = await page.evaluate(async () => {
+                const nd = document.getElementById("__NEXT_DATA__");
+                if (!nd)
+                    return { error: "no __NEXT_DATA__" };
+                const j = JSON.parse(nd.textContent || "{}");
+                const sps = j?.props?.pageProps?.searchPageState;
+                const queryState = sps?.queryState;
+                if (!queryState)
+                    return { error: "no queryState" };
+                const res = await fetch("/async-create-search-page-state", {
+                    method: "PUT",
+                    credentials: "include",
+                    headers: { "content-type": "application/json" },
+                    body: JSON.stringify({
+                        searchQueryState: queryState,
+                        wants: { cat1: ["listResults", "mapResults"] },
+                        requestId: 2,
+                        isDebugRequest: false,
+                    }),
+                });
+                const data = await res.json();
+                return { queryState, data };
+            });
+            if (payload.error)
+                throw new Error(`Zillow search failed: ${payload.error}`);
+            const qs = payload.queryState;
+            const sr = payload.data?.cat1?.searchResults ?? {};
+            let results = sr.listResults ?? sr.mapResults ?? [];
+            const total = payload.data?.categoryTotals?.cat1?.totalResultCount ?? results.length;
+            if (limit && limit > 0)
+                results = results.slice(0, limit);
+            return {
+                query: String(ctx.options.search),
+                regionSelection: qs?.regionSelection,
+                mapBounds: qs?.mapBounds,
+                totalResultCount: total,
+                count: results.length,
+                results: results.map((r) => ({
+                    zpid: r.zpid,
+                    url: absUrl(r.detailUrl),
+                    address: r.address,
+                    price: r.price,
+                    beds: r.beds,
+                    baths: r.baths,
+                    area: r.area,
+                    status: r.statusType,
+                    latLong: r.latLong,
+                })),
+            };
+        }
+        throw new Error("Specify one of: --search <place>, --trending, or --zpid <id>.");
+    },
+});

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

@@ -0,0 +1,55 @@
+# Generated by `pnpm generate:openapi` — do not edit by hand.
+openapi: 3.1.0
+info:
+  title: Zillow
+  description: Search Zillow listings, list trending homes, and resolve listing URLs (browser
+    transport, auto-handles the PerimeterX challenge).
+  version: 1.1.3
+servers:
+  - url: https://zillow.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 zillow.com into every request."
+x-website-api:
+  id: zillow
+  domain: zillow.com
+  cookieDomain: zillow.com
+  transport: browser
+  cookies: optional
+  requiresLogin: false
+  imperative: true
+  cli:
+    command: website-api zillow
+    positionals: []
+    parameters:
+      - flag: --search
+        type: string
+        description: Place to search, e.g. "Austin, TX" or "New York, NY"
+        required: false
+      - flag: --status
+        type: string
+        description: for_sale | for_rent | sold (default for_sale)
+        default: for_sale
+        required: false
+      - flag: --trending
+        type: boolean
+        description: List homepage trending / selling-soon collections
+        required: false
+      - flag: --zpid
+        type: string
+        description: Return the canonical listing URL for a zpid
+        required: false
+      - flag: --limit
+        type: number
+        description: Cap the number of results returned
+        required: false
+      - flag: --hold
+        type: number
+        description: PerimeterX press-&-hold duration in ms (default 11000)
+        required: false

package/dist/src/types.d.ts

@@ -185,6 +185,13 @@ export interface SiteDef {
     domain: string;
     /** Short description of what data this site fetches. */
     description: string;
+    /**
+     * Domain to resolve Chrome cookies for, when it differs from `domain`. Use
+     * for sites whose auth cookies live on a parent domain — e.g. Gemini runs on
+     * `gemini.google.com` but its session cookies are scoped to `google.com`.
+     * Defaults to `domain`.
+     */
+    cookieDomain?: string;
     /** Transport used to reach the site. Defaults to "http". */
     transport?: "http" | "browser";
     /** Whether valid cookies are required. Defaults to "required". */
@@ -216,6 +223,8 @@ export interface Site {
     id: string;
     name: string;
     domain: string;
+    /** Domain used for cookie resolution (defaults to `domain`). */
+    cookieDomain: string;
     description: string;
     transport: "http" | "browser";
     cookies: "required" | "optional";
@@ -226,6 +235,8 @@ export interface Site {
     positionals: PositionalDefinition[];
     /** URL the browser transport lands on (from endpoints[0] or https://domain). */
     landingUrl: string;
+    /** The declared endpoints, preserved for tooling (e.g. OpenAPI generation). */
+    endpoints?: Endpoint[];
     run: (ctx: SiteContext) => Promise<unknown>;
     /** Set by the loader: where this site was discovered. */
     origin?: "bundled" | "extension";
@@ -245,6 +256,11 @@ export interface QueryOptions {
     userAgent?: string;
     /** When true, print full HTTP request/response details for debugging. */
     debug?: boolean;
+    /**
+     * Show the managed Chrome window (browser transport). Defaults to headless;
+     * an already-open CDP session is always reused regardless of this flag.
+     */
+    headed?: boolean;
     /** Directory to write downloads to. */
     outDir?: string;
     /** Allows passing custom site-specific parameters. */

package/dist/src/types.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/src/util/args-parser.js

@@ -1 +1,145 @@
-const e=[{name:"profile",type:"string",description:"specific Chrome profile directory (e.g., 'Default')"},{name:"user-agent",type:"string",description:"custom User-Agent header for HTTP requests",short:"u"},{name:"debug",type:"boolean",description:"Print full HTTP request and response bodies for debugging"},{name:"keep-open",type:"boolean",description:"Leave the browser tab open after running (preserve the logged-in session)"},{name:"out",type:"string",description:"Write decoded response JSON/text to file instead of stdout",short:"o"}];export function parseArgsForWebsite(r=[],n=[],o){let i=!1;const s={},a=[...n,...e];for(const e of a){const r=t(e.name);void 0!==e.default?s[r]=e.default:"boolean"===e.type&&(s[r]=!1)}const c={};for(const e of r)c[e.name]=[];let p=0;for(let e=0;e<o.length;e++){const n=o[e];if("--help"!==n&&"-h"!==n)if(n.startsWith("-")){let r;const i=!n.startsWith("--"),c=i?n.slice(1):n.slice(2);if(r=i?a.find(e=>e.short===c):a.find(e=>e.name===c),!r)throw new Error(`Unknown option: ${n}`);const p=t(r.name);if("boolean"===r.type)s[p]=!0;else if("string"===r.type){const t=o[e+1];if(void 0===t||t.startsWith("-"))throw new Error(`Option ${n} requires a value`);s[p]=t,e++}else if("number"===r.type){const t=o[e+1];if(void 0===t||t.startsWith("-"))throw new Error(`Option ${n} requires a numeric value`);const r=Number(t);if(isNaN(r))throw new Error(`Option ${n} requires a valid numeric value, received: "${t}"`);s[p]=r,e++}}else if(p<r.length){const e=r[p];c[e.name].push(n),e.variadic||p++}else{const e=r[r.length-1];if(!e?.variadic)throw new Error(`Unexpected extra argument: "${n}"`);c[e.name].push(n)}else i=!0}for(const e of r){const r=c[e.name];if(e.required&&0===r.length&&!i)throw new Error(`Missing required argument: <${e.name}>`);s[t(e.name)]=r.length>0?r.join(" "):null}for(const e of a){const r=t(e.name);if(e.required&&void 0===s[r]&&!i)throw new Error(`Missing required option: --${e.name}`)}return{options:s,helpRequested:i}}function t(e){return e.replace(/-([a-z])/g,(e,t)=>t.toUpperCase())}
+const GLOBAL_PARAMETERS = [
+    { name: "profile", type: "string", description: "specific Chrome profile directory (e.g., 'Default')" },
+    {
+        name: "user-agent",
+        type: "string",
+        description: "custom User-Agent header for HTTP requests",
+        short: "u",
+    },
+    {
+        name: "debug",
+        type: "boolean",
+        description: "Print full HTTP request and response bodies for debugging",
+    },
+    {
+        name: "keep-open",
+        type: "boolean",
+        description: "Leave the browser tab open after running (preserve the logged-in session)",
+    },
+    {
+        name: "headed",
+        type: "boolean",
+        description: "Show the managed Chrome window (default headless; reuses an already-open session)",
+    },
+    {
+        name: "out",
+        type: "string",
+        description: "Write decoded response JSON/text to file instead of stdout",
+        short: "o",
+    },
+];
+/**
+ * Parses raw command-line arguments based on positional and parameter schemas of a website adapter.
+ * Handles defaults, types, validation, variadic trailing arguments, and maps kebab-case CLI options to camelCase.
+ *
+ * @param positionalDefs Expected positional arguments schema
+ * @param parameterDefs Expected custom parameter option flags schema
+ * @param argv Command line arguments (excluding node, cli paths and website id)
+ */
+export function parseArgsForWebsite(positionalDefs = [], parameterDefs = [], argv) {
+    let helpRequested = false;
+    const options = {};
+    // Combine custom parameters with global parameters
+    const allParameters = [...parameterDefs, ...GLOBAL_PARAMETERS];
+    // Initialize defaults
+    for (const param of allParameters) {
+        const camelName = toCamelCase(param.name);
+        if (param.default !== undefined) {
+            options[camelName] = param.default;
+        }
+        else if (param.type === "boolean") {
+            options[camelName] = false;
+        }
+    }
+    const positionalValues = {};
+    for (const pos of positionalDefs) {
+        positionalValues[pos.name] = [];
+    }
+    let positionalIdx = 0;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            helpRequested = true;
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            // It is an option/flag!
+            let matchedParam;
+            const isShort = !arg.startsWith("--");
+            const flagName = isShort ? arg.slice(1) : arg.slice(2);
+            if (isShort) {
+                matchedParam = allParameters.find((p) => p.short === flagName);
+            }
+            else {
+                matchedParam = allParameters.find((p) => p.name === flagName);
+            }
+            if (!matchedParam) {
+                throw new Error(`Unknown option: ${arg}`);
+            }
+            const camelName = toCamelCase(matchedParam.name);
+            if (matchedParam.type === "boolean") {
+                options[camelName] = true;
+            }
+            else if (matchedParam.type === "string") {
+                const nextVal = argv[i + 1];
+                if (nextVal === undefined || nextVal.startsWith("-")) {
+                    throw new Error(`Option ${arg} requires a value`);
+                }
+                options[camelName] = nextVal;
+                i++; // Skip the value in the next iteration
+            }
+            else if (matchedParam.type === "number") {
+                const nextVal = argv[i + 1];
+                if (nextVal === undefined || nextVal.startsWith("-")) {
+                    throw new Error(`Option ${arg} requires a numeric value`);
+                }
+                const num = Number(nextVal);
+                if (Number.isNaN(num)) {
+                    throw new Error(`Option ${arg} requires a valid numeric value, received: "${nextVal}"`);
+                }
+                options[camelName] = num;
+                i++;
+            }
+        }
+        else {
+            // It's a positional argument!
+            if (positionalIdx < positionalDefs.length) {
+                const currentPos = positionalDefs[positionalIdx];
+                positionalValues[currentPos.name].push(arg);
+                // If the positional is not variadic, move to the next positional definition
+                if (!currentPos.variadic) {
+                    positionalIdx++;
+                }
+            }
+            else {
+                // Extra positional arguments: if the last positional was variadic, append to it!
+                const lastPos = positionalDefs[positionalDefs.length - 1];
+                if (lastPos?.variadic) {
+                    positionalValues[lastPos.name].push(arg);
+                }
+                else {
+                    throw new Error(`Unexpected extra argument: "${arg}"`);
+                }
+            }
+        }
+    }
+    // Join and validate positionals
+    for (const pos of positionalDefs) {
+        const vals = positionalValues[pos.name];
+        if (pos.required && vals.length === 0 && !helpRequested) {
+            throw new Error(`Missing required argument: <${pos.name}>`);
+        }
+        options[toCamelCase(pos.name)] = vals.length > 0 ? vals.join(" ") : null;
+    }
+    // Validate required parameters
+    for (const param of allParameters) {
+        const camelName = toCamelCase(param.name);
+        if (param.required && options[camelName] === undefined && !helpRequested) {
+            throw new Error(`Missing required option: --${param.name}`);
+        }
+    }
+    return { options, helpRequested };
+}
+function toCamelCase(str) {
+    return str.replace(/-([a-z])/g, (_, g) => g.toUpperCase());
+}

package/dist/src/util/google-json.js

@@ -1 +1,74 @@
-function o(o,e){let r=o;for(const o of e){if(null==r||!Array.isArray(r))return;r=r[o]}return r}export function parseGoogleJsonWithSchema(e,r){const n={};for(const[t,s]of Object.entries(r)){const r=o(e,s.path);s.items&&Array.isArray(r)?n[t]=r.map(o=>parseGoogleJsonWithSchema(o,s.items)):n[t]=s.transform?s.transform(r):r}return n}export function decodeGoogleJson(o,e){let r=o.trim();r.startsWith(")]}'")&&(r=r.substring(4).trim());const n=r.indexOf("\n");if(-1===n)throw new Error("Invalid Google JSON response format: No newline found");const t=r.substring(0,n).trim(),s=parseInt(t,10);if(isNaN(s))throw new Error(`Invalid Google JSON response chunk length: "${t}"`);let i=r.substring(n+1,n+1+s);const a=i.lastIndexOf("]]");-1!==a&&(i=i.substring(0,a+2));const c=JSON.parse(i).find(o=>Array.isArray(o)&&o[1]===e);if(!c)throw new Error(`RPC ID "${e}" payload not found in Google JSON response`);return JSON.parse(c[2])}export const decode_google_json=decodeGoogleJson;export const parse_google_json_with_schema=parseGoogleJsonWithSchema;export const decodeGoogleJsonWithSchema=(o,e,r)=>parseGoogleJsonWithSchema(decodeGoogleJson(o,e),r);export const decode_google_json_with_schema=decodeGoogleJsonWithSchema;
+/**
+ * Traverses a nested array to retrieve the value at a specified path of indices.
+ */
+function getValueByPath(obj, path) {
+    let current = obj;
+    for (const index of path) {
+        if (current === undefined || current === null || !Array.isArray(current)) {
+            return undefined;
+        }
+        current = current[index];
+    }
+    return current;
+}
+/**
+ * Parses and transforms Google batchexecute payload array using a universal schema mapping.
+ *
+ * @param payload The decoded RPC payload array.
+ * @param schema The universal schema mapping fields to array paths and options.
+ * @returns The normalized JSON structure.
+ */
+export function parseGoogleJsonWithSchema(payload, schema) {
+    const result = {};
+    for (const [key, field] of Object.entries(schema)) {
+        const rawVal = getValueByPath(payload, field.path);
+        if (field.items && Array.isArray(rawVal)) {
+            result[key] = rawVal.map((item) => parseGoogleJsonWithSchema(item, field.items));
+        }
+        else {
+            result[key] = field.transform ? field.transform(rawVal) : rawVal;
+        }
+    }
+    return result;
+}
+/**
+ * Decodes raw Google batchexecute response envelope and extracts the payload for a given RPC ID.
+ *
+ * @param rawResponse The raw HTTP response body from Google's batchexecute endpoint.
+ * @param rpcId The Google RPC ID to extract (e.g. 'jSf9Qc').
+ * @returns The parsed JSON payload for the requested RPC ID.
+ */
+export function decodeGoogleJson(rawResponse, rpcId) {
+    let text = rawResponse.trim();
+    if (text.startsWith(")]}'")) {
+        text = text.substring(4).trim();
+    }
+    const firstNewline = text.indexOf("\n");
+    if (firstNewline === -1) {
+        throw new Error("Invalid Google JSON response format: No newline found");
+    }
+    const prefix = text.substring(0, firstNewline).trim();
+    const chunkLength = parseInt(prefix, 10);
+    if (Number.isNaN(chunkLength)) {
+        throw new Error(`Invalid Google JSON response chunk length: "${prefix}"`);
+    }
+    let jsonStr = text.substring(firstNewline + 1, firstNewline + 1 + chunkLength);
+    const lastBrackets = jsonStr.lastIndexOf("]]");
+    if (lastBrackets !== -1) {
+        jsonStr = jsonStr.substring(0, lastBrackets + 2);
+    }
+    const envelope = JSON.parse(jsonStr);
+    const rpcMessage = envelope.find((msg) => Array.isArray(msg) && msg[1] === rpcId);
+    if (!rpcMessage) {
+        throw new Error(`RPC ID "${rpcId}" payload not found in Google JSON response`);
+    }
+    return JSON.parse(rpcMessage[2]);
+}
+// Aliases for backward compatibility or snake_case preferences
+export const decode_google_json = decodeGoogleJson;
+export const parse_google_json_with_schema = parseGoogleJsonWithSchema;
+export const decodeGoogleJsonWithSchema = (rawResponse, rpcId, schema) => {
+    const payload = decodeGoogleJson(rawResponse, rpcId);
+    return parseGoogleJsonWithSchema(payload, schema);
+};
+export const decode_google_json_with_schema = decodeGoogleJsonWithSchema;

package/dist/src/website-api.d.ts

@@ -1,9 +1,9 @@
-export { defineSite, isSite } from "./core/define-site.js";
-export type { Site, SiteDef, SiteContext, Endpoint, QueryOptions, ParameterDefinition, PositionalDefinition, FingerprintOption, FingerprintConfig, FormLoginConfig, LoginStrategy, LoginContext, Credentials, HttpCapability, SSEResult, } from "./types.js";
 export { FormLoginStrategy } from "./capabilities/login/login-strategy.js";
-export { sites, loadSites, setSites, getSite, queryWebsite, createUniversalSite, } from "./core/runtime.js";
-export { discoverSites, extensionRoots, BUNDLED_SITES_DIR } from "./core/loader.js";
-export { createContext } from "./core/context.js";
 export type { ContextProviders, ManagedContext } from "./core/context.js";
-export { DEFAULT_REGISTRY, resolveRegistries, addRegistry, removeRegistry, parseRepoSpec, loadIndex, searchRegistries, resolveEntry, installEntry, listInstalled, removeInstalled, configPath, } from "./core/registry.js";
-export type { RegistrySource, RegistryFile, RegistrySiteEntry, RegistryIndex, InstalledRecord, FoundEntry, } from "./core/registry.js";
+export { createContext } from "./core/context.js";
+export { defineSite, isSite } from "./core/define-site.js";
+export { BUNDLED_SITES_DIR, discoverSites, extensionRoots } from "./core/loader.js";
+export type { FoundEntry, InstalledRecord, RegistryFile, RegistryIndex, RegistrySiteEntry, RegistrySource, } from "./core/registry.js";
+export { addRegistry, configPath, DEFAULT_REGISTRY, installEntry, listInstalled, loadIndex, parseRepoSpec, removeInstalled, removeRegistry, resolveEntry, resolveRegistries, searchRegistries, } from "./core/registry.js";
+export { createUniversalSite, getSite, loadSites, queryWebsite, runSite, setSites, sites, } from "./core/runtime.js";
+export type { Credentials, Endpoint, FingerprintConfig, FingerprintOption, FormLoginConfig, HttpCapability, LoginContext, LoginStrategy, ParameterDefinition, PositionalDefinition, QueryOptions, Site, SiteContext, SiteDef, SSEResult, } from "./types.js";

package/dist/src/website-api.js

@@ -1 +1,13 @@
-import{loadEnv as e}from"./env.js";e();export{defineSite,isSite}from"./core/define-site.js";export{FormLoginStrategy}from"./capabilities/login/login-strategy.js";export{sites,loadSites,setSites,getSite,queryWebsite,createUniversalSite}from"./core/runtime.js";export{discoverSites,extensionRoots,BUNDLED_SITES_DIR}from"./core/loader.js";export{createContext}from"./core/context.js";export{DEFAULT_REGISTRY,resolveRegistries,addRegistry,removeRegistry,parseRepoSpec,loadIndex,searchRegistries,resolveEntry,installEntry,listInstalled,removeInstalled,configPath}from"./core/registry.js";
+import { loadEnv } from "./env.js";
+// Load environment variables (.env) on import.
+loadEnv();
+// ── login strategies (for sites that need a custom auth flow) ──
+export { FormLoginStrategy } from "./capabilities/login/login-strategy.js";
+export { createContext } from "./core/context.js";
+// ── public authoring + types ──
+export { defineSite, isSite } from "./core/define-site.js";
+export { BUNDLED_SITES_DIR, discoverSites, extensionRoots } from "./core/loader.js";
+// ── remote site registry (search + install extensions) ──
+export { addRegistry, configPath, DEFAULT_REGISTRY, installEntry, listInstalled, loadIndex, parseRepoSpec, removeInstalled, removeRegistry, resolveEntry, resolveRegistries, searchRegistries, } from "./core/registry.js";
+// ── runtime + registry ──
+export { createUniversalSite, getSite, loadSites, queryWebsite, runSite, setSites, sites, } from "./core/runtime.js";