@agentsean/google 1.0.0

package/dist/errors.js

@@ -0,0 +1,110 @@
+/**
+ * Adapted from OpenSEO `src/server/lib/gscErrors.ts` and `ga4Errors.ts` (MIT).
+ * Copyright (c) 2026 Ben Senescu and contributors.
+ *
+ * Workers/Better-Auth bindings stripped. Status-driven user-facing messages kept.
+ */
+export class GscApiError extends Error {
+    status;
+    body;
+    constructor(status, message, body) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "GscApiError";
+    }
+}
+export class GscTokenError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = "GscTokenError";
+    }
+}
+export class GscNotConnectedError extends Error {
+    siteId;
+    constructor(siteId) {
+        super("Search Console is not connected for this site");
+        this.siteId = siteId;
+        this.name = "GscNotConnectedError";
+    }
+}
+export class Ga4AdminApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = "Ga4AdminApiError";
+    }
+}
+export class Ga4TokenError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = "Ga4TokenError";
+    }
+}
+export class Ga4DataApiError extends Error {
+    status;
+    retryAfterSeconds;
+    upstreamReason;
+    constructor(status, message, retryAfterSeconds = null, upstreamReason = null) {
+        super(message);
+        this.status = status;
+        this.retryAfterSeconds = retryAfterSeconds;
+        this.upstreamReason = upstreamReason;
+        this.name = "Ga4DataApiError";
+    }
+}
+export class Ga4NotConnectedError extends Error {
+    siteId;
+    constructor(siteId) {
+        super("Google Analytics is not connected for this site");
+        this.siteId = siteId;
+        this.name = "Ga4NotConnectedError";
+    }
+}
+export class QuotaExceededError extends Error {
+    api;
+    retryAfterMs;
+    constructor(api, message, retryAfterMs) {
+        super(message);
+        this.api = api;
+        this.retryAfterMs = retryAfterMs;
+        this.name = "QuotaExceededError";
+    }
+}
+export function gscMessageForStatus(status, body) {
+    if (status === 401 || status === 403) {
+        return "Search Console denied access to this property (no verified permission, or the connection was revoked).";
+    }
+    if (status === 429) {
+        return "Search Console rate limit reached. Retry shortly.";
+    }
+    if (status === 404) {
+        return "Search Console property not found. It may have been removed in Search Console.";
+    }
+    return `Search Console API error (${status}): ${body.slice(0, 300)}`;
+}
+export function ga4AdminMessageForStatus(status) {
+    if (status === 401)
+        return "Google Analytics connection expired.";
+    if (status === 403) {
+        return "Google Analytics denied access. Check the account's property access and enabled APIs.";
+    }
+    if (status === 429)
+        return "Google Analytics rate limit reached.";
+    return `Google Analytics Admin API error (${status}).`;
+}
+export function ga4DataMessageForStatus(status) {
+    if (status === 401)
+        return "Google Analytics connection expired.";
+    if (status === 403)
+        return "Google Analytics Data API denied access.";
+    if (status === 429)
+        return "Google Analytics Data API quota exhausted.";
+    return `Google Analytics Data API error (${status}).`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/ga4.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Adapted from OpenSEO `src/server/lib/ga4Client.ts` and `ga4Errors.ts` (MIT).
+ * Copyright (c) 2026 Ben Senescu and contributors.
+ *
+ * Sparse-response handling kept: ProtoJSON omits default scalars. Workers
+ * bindings and Better Auth token minting stripped.
+ */
+import { type GoogleHttp } from "./http.js";
+export type Ga4PropertySummary = {
+    propertyId: string;
+    displayName: string;
+    accountId: string;
+    accountDisplayName: string;
+};
+export type Ga4Property = {
+    name: string;
+    displayName: string;
+    timeZone: string;
+    currencyCode: string;
+};
+export type Ga4ReportRow = {
+    dimensionValues: string[];
+    metricValues: number[];
+};
+export type Ga4Client = {
+    listProperties: () => Promise<Ga4PropertySummary[]>;
+    getProperty: (propertyId: string) => Promise<Ga4Property>;
+    runReport: (opts: {
+        propertyId: string;
+        startDate: string;
+        endDate: string;
+        dimensions: string[];
+        metrics: string[];
+        dimensionFilter?: unknown;
+        limit?: number | undefined;
+    }) => Promise<{
+        rows: Ga4ReportRow[];
+        tokensConsumed: number;
+    }>;
+};
+export declare function createGa4Client(opts: {
+    http: GoogleHttp;
+    getToken: () => Promise<string>;
+}): Ga4Client;
+export declare function googleOrganicFilter(): unknown;
+//# sourceMappingURL=ga4.d.ts.map

package/dist/ga4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ga4.d.ts","sourceRoot":"","sources":["../src/ga4.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAKjE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,cAAc,EAAE,MAAM,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACpD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,SAAS,EAAE,CAAC,IAAI,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC5B,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjE,CAAC;AAWF,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC,GAAG,SAAS,CA0HZ;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAmB7C"}

package/dist/ga4.js

@@ -0,0 +1,126 @@
+/**
+ * Adapted from OpenSEO `src/server/lib/ga4Client.ts` and `ga4Errors.ts` (MIT).
+ * Copyright (c) 2026 Ben Senescu and contributors.
+ *
+ * Sparse-response handling kept: ProtoJSON omits default scalars. Workers
+ * bindings and Better Auth token minting stripped.
+ */
+import { Ga4AdminApiError, Ga4DataApiError, ga4AdminMessageForStatus, ga4DataMessageForStatus, } from "./errors.js";
+import { bearer, googleFetch } from "./http.js";
+const GA4_ADMIN = "https://analyticsadmin.googleapis.com/v1beta";
+const GA4_DATA = "https://analyticsdata.googleapis.com/v1beta";
+function num(value) {
+    if (typeof value === "number")
+        return value;
+    if (typeof value === "string")
+        return Number(value) || 0;
+    if (value && typeof value === "object" && "value" in value) {
+        return Number(value.value) || 0;
+    }
+    return 0;
+}
+export function createGa4Client(opts) {
+    const adminGet = async (path) => {
+        const token = await opts.getToken();
+        const res = await googleFetch(opts.http, "ga4.data", "admin", `${GA4_ADMIN}/${path}`, {
+            headers: bearer(token),
+        });
+        if (!res.ok) {
+            throw new Ga4AdminApiError(res.status, ga4AdminMessageForStatus(res.status));
+        }
+        return (await res.json());
+    };
+    return {
+        async listProperties() {
+            const out = [];
+            let pageToken;
+            for (let i = 0; i < 100; i++) {
+                const q = pageToken ? `?pageToken=${encodeURIComponent(pageToken)}` : "";
+                const data = await adminGet(`accountSummaries${q}`);
+                for (const acc of data.accountSummaries ?? []) {
+                    for (const p of acc.propertySummaries ?? []) {
+                        if (!p.property)
+                            continue;
+                        out.push({
+                            propertyId: p.property,
+                            displayName: p.displayName ?? p.property,
+                            accountId: acc.account ?? "",
+                            accountDisplayName: acc.displayName ?? "",
+                        });
+                    }
+                }
+                pageToken = data.nextPageToken;
+                if (!pageToken)
+                    break;
+            }
+            return out;
+        },
+        async getProperty(propertyId) {
+            const id = propertyId.startsWith("properties/")
+                ? propertyId
+                : `properties/${propertyId}`;
+            const data = await adminGet(id);
+            return {
+                name: data.name ?? id,
+                displayName: data.displayName ?? id,
+                timeZone: data.timeZone ?? "UTC",
+                currencyCode: data.currencyCode ?? "USD",
+            };
+        },
+        async runReport(input) {
+            const token = await opts.getToken();
+            const id = input.propertyId.startsWith("properties/")
+                ? input.propertyId
+                : `properties/${input.propertyId}`;
+            const body = {
+                dateRanges: [{ startDate: input.startDate, endDate: input.endDate }],
+                dimensions: input.dimensions.map((name) => ({ name })),
+                metrics: input.metrics.map((name) => ({ name })),
+                limit: String(input.limit ?? 10000),
+                ...(input.dimensionFilter ? { dimensionFilter: input.dimensionFilter } : {}),
+            };
+            const res = await googleFetch(opts.http, "ga4.data", id, `${GA4_DATA}/${id}:runReport`, {
+                method: "POST",
+                headers: bearer(token, { "Content-Type": "application/json" }),
+                body: JSON.stringify(body),
+            });
+            if (!res.ok) {
+                const text = await res.text().catch(() => "");
+                let retryAfter = null;
+                const ra = res.headers.get("retry-after");
+                if (ra)
+                    retryAfter = Number(ra) || null;
+                throw new Ga4DataApiError(res.status, ga4DataMessageForStatus(res.status), retryAfter, text.slice(0, 300));
+            }
+            const data = (await res.json());
+            // Sparse: omitted rows mean zero. Empty array is a valid sparse response.
+            const rows = (data.rows ?? []).map((r) => ({
+                dimensionValues: (r.dimensionValues ?? []).map((d) => d.value ?? ""),
+                metricValues: (r.metricValues ?? []).map((m) => num(m.value)),
+            }));
+            const tokensConsumed = data.propertyQuota?.tokensPerHour?.consumed ?? 1;
+            return { rows, tokensConsumed };
+        },
+    };
+}
+export function googleOrganicFilter() {
+    return {
+        andGroup: {
+            expressions: [
+                {
+                    filter: {
+                        fieldName: "sessionSource",
+                        stringFilter: { matchType: "EXACT", value: "google" },
+                    },
+                },
+                {
+                    filter: {
+                        fieldName: "sessionMedium",
+                        stringFilter: { matchType: "EXACT", value: "organic" },
+                    },
+                },
+            ],
+        },
+    };
+}
+//# sourceMappingURL=ga4.js.map

package/dist/ga4.js.map

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

package/dist/gsc.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Adapted from OpenSEO `src/server/lib/gscClient.ts` and
+ * `src/server/features/gsc/searchAnalytics.ts` (MIT).
+ * Copyright (c) 2026 Ben Senescu and contributors.
+ *
+ * Workers/Better-Auth bindings stripped. Pagination uses the real 25,000
+ * rowLimit (OpenSEO capped MCP at 1,000). siteUrl is used verbatim.
+ */
+import { type GoogleHttp } from "./http.js";
+export declare const GSC_ROW_LIMIT_MAX = 25000;
+export declare const GSC_ROWS_PER_DAY_PER_TYPE = 50000;
+export declare const GSC_SEARCH_TYPES: readonly ["web", "image", "video", "news", "discover", "googleNews"];
+export type GscSite = {
+    siteUrl: string;
+    permissionLevel: string;
+};
+export type GscSearchAnalyticsRow = {
+    keys?: string[] | undefined;
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+};
+export type GscSearchAnalyticsRequest = {
+    startDate: string;
+    endDate: string;
+    dimensions?: string[] | undefined;
+    dimensionFilterGroups?: Array<{
+        groupType: "and" | "or";
+        filters: Array<{
+            dimension: string;
+            operator: string;
+            expression: string;
+        }>;
+    }> | undefined;
+    rowLimit?: number | undefined;
+    startRow?: number | undefined;
+    type?: string | undefined;
+    dataState?: string | undefined;
+    aggregationType?: string | undefined;
+};
+export type UrlInspectionResult = {
+    indexStatusResult?: {
+        verdict?: string;
+        coverageState?: string;
+        robotsTxtState?: string;
+        indexingState?: string;
+        lastCrawlTime?: string;
+        pageFetchState?: string;
+        googleCanonical?: string;
+        userCanonical?: string;
+        crawledAs?: string;
+        sitemap?: string[];
+        referringUrls?: string[];
+    };
+    mobileUsabilityResult?: {
+        verdict?: string;
+    };
+    richResultsResult?: {
+        verdict?: string;
+    };
+    inspectionResultLink?: string;
+};
+export type GscClient = {
+    listSites: () => Promise<GscSite[]>;
+    addSite: (siteUrl: string) => Promise<void>;
+    listSitemaps: (siteUrl: string) => Promise<unknown>;
+    submitSitemap: (siteUrl: string, feedpath: string) => Promise<void>;
+    deleteSitemap: (siteUrl: string, feedpath: string) => Promise<void>;
+    querySearchAnalytics: (siteUrl: string, body: GscSearchAnalyticsRequest) => Promise<{
+        rows: GscSearchAnalyticsRow[];
+        firstIncompleteDate: string | null;
+    }>;
+    querySearchAnalyticsAllPages: (siteUrl: string, body: Omit<GscSearchAnalyticsRequest, "startRow" | "rowLimit"> & {
+        rowLimit?: number | undefined;
+    }) => Promise<{
+        rows: GscSearchAnalyticsRow[];
+        firstIncompleteDate: string | null;
+    }>;
+    inspectUrl: (siteUrl: string, inspectionUrl: string, languageCode?: string | undefined) => Promise<UrlInspectionResult | null>;
+};
+export declare function createGscClient(opts: {
+    http: GoogleHttp;
+    getToken: () => Promise<string>;
+}): GscClient;
+export declare function ymd(d: Date): string;
+export declare function subtractUtcDays(d: Date, days: number): Date;
+export declare function subtractUtcMonths(date: Date, months: number): Date;
+/** final data trails ~2–3 days. Never hardcode lag when metadata is present. */
+export declare function defaultGscWindow(today?: Date): {
+    startDate: string;
+    endDate: string;
+};
+export declare function monthChunks(startDate: string, endDate: string): {
+    startDate: string;
+    endDate: string;
+}[];
+//# sourceMappingURL=gsc.d.ts.map

package/dist/gsc.d.ts.map

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

package/dist/gsc.js

@@ -0,0 +1,141 @@
+/**
+ * Adapted from OpenSEO `src/server/lib/gscClient.ts` and
+ * `src/server/features/gsc/searchAnalytics.ts` (MIT).
+ * Copyright (c) 2026 Ben Senescu and contributors.
+ *
+ * Workers/Better-Auth bindings stripped. Pagination uses the real 25,000
+ * rowLimit (OpenSEO capped MCP at 1,000). siteUrl is used verbatim.
+ */
+import { encodeSiteUrl } from "./scopes.js";
+import { GscApiError, gscMessageForStatus } from "./errors.js";
+import { bearer, googleFetch } from "./http.js";
+const GSC_API_BASE = "https://www.googleapis.com/webmasters/v3";
+const INSPECT_URL = "https://searchconsole.googleapis.com/v1/urlInspection/index:inspect";
+export const GSC_ROW_LIMIT_MAX = 25_000;
+export const GSC_ROWS_PER_DAY_PER_TYPE = 50_000;
+export const GSC_SEARCH_TYPES = [
+    "web",
+    "image",
+    "video",
+    "news",
+    "discover",
+    "googleNews",
+];
+export function createGscClient(opts) {
+    const request = async (api, scopeKey, url, init) => {
+        const token = await opts.getToken();
+        const hasBody = init?.body !== undefined;
+        const res = await googleFetch(opts.http, api, scopeKey, url, {
+            method: init?.method ?? "GET",
+            headers: bearer(token, hasBody ? { "Content-Type": "application/json" } : undefined),
+            ...(hasBody ? { body: JSON.stringify(init?.body) } : {}),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new GscApiError(res.status, gscMessageForStatus(res.status, body), body);
+        }
+        if (res.status === 204)
+            return undefined;
+        return (await res.json());
+    };
+    return {
+        async listSites() {
+            const data = await request("gsc.other", "sites", `${GSC_API_BASE}/sites`);
+            return data.siteEntry ?? [];
+        },
+        async addSite(siteUrl) {
+            await request("gsc.other", siteUrl, `${GSC_API_BASE}/sites/${encodeSiteUrl(siteUrl)}`, { method: "PUT", body: {} });
+        },
+        async listSitemaps(siteUrl) {
+            return request("gsc.other", siteUrl, `${GSC_API_BASE}/sites/${encodeSiteUrl(siteUrl)}/sitemaps`);
+        },
+        async submitSitemap(siteUrl, feedpath) {
+            await request("gsc.other", siteUrl, `${GSC_API_BASE}/sites/${encodeSiteUrl(siteUrl)}/sitemaps/${encodeURIComponent(feedpath)}`, { method: "PUT", body: {} });
+        },
+        async deleteSitemap(siteUrl, feedpath) {
+            await request("gsc.other", siteUrl, `${GSC_API_BASE}/sites/${encodeSiteUrl(siteUrl)}/sitemaps/${encodeURIComponent(feedpath)}`, { method: "DELETE" });
+        },
+        async querySearchAnalytics(siteUrl, body) {
+            const data = await request("gsc.searchAnalytics", siteUrl, `${GSC_API_BASE}/sites/${encodeSiteUrl(siteUrl)}/searchAnalytics/query`, {
+                method: "POST",
+                body: {
+                    ...body,
+                    rowLimit: Math.min(body.rowLimit ?? GSC_ROW_LIMIT_MAX, GSC_ROW_LIMIT_MAX),
+                },
+            });
+            return {
+                rows: data.rows ?? [],
+                firstIncompleteDate: data.metadata?.firstIncompleteDate ?? null,
+            };
+        },
+        async querySearchAnalyticsAllPages(siteUrl, body) {
+            const rowLimit = Math.min(body.rowLimit ?? GSC_ROW_LIMIT_MAX, GSC_ROW_LIMIT_MAX);
+            const rows = [];
+            let startRow = 0;
+            let firstIncompleteDate = null;
+            for (;;) {
+                const page = await this.querySearchAnalytics(siteUrl, {
+                    ...body,
+                    rowLimit,
+                    startRow,
+                });
+                if (page.firstIncompleteDate)
+                    firstIncompleteDate = page.firstIncompleteDate;
+                rows.push(...page.rows);
+                if (page.rows.length < rowLimit)
+                    break;
+                startRow += page.rows.length;
+                if (startRow >= GSC_ROWS_PER_DAY_PER_TYPE)
+                    break;
+            }
+            return { rows, firstIncompleteDate };
+        },
+        async inspectUrl(siteUrl, inspectionUrl, languageCode) {
+            const data = await request("gsc.urlInspection", siteUrl, INSPECT_URL, {
+                method: "POST",
+                body: {
+                    siteUrl,
+                    inspectionUrl,
+                    ...(languageCode ? { languageCode } : {}),
+                },
+            });
+            return data.inspectionResult ?? null;
+        },
+    };
+}
+export function ymd(d) {
+    return d.toISOString().slice(0, 10);
+}
+export function subtractUtcDays(d, days) {
+    const n = new Date(d);
+    n.setUTCDate(n.getUTCDate() - days);
+    return n;
+}
+export function subtractUtcMonths(date, months) {
+    const day = date.getUTCDate();
+    const d = new Date(date);
+    d.setUTCDate(1);
+    d.setUTCMonth(d.getUTCMonth() - months);
+    const daysInTarget = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 0)).getUTCDate();
+    d.setUTCDate(Math.min(day, daysInTarget));
+    return d;
+}
+/** final data trails ~2–3 days. Never hardcode lag when metadata is present. */
+export function defaultGscWindow(today = new Date()) {
+    const end = subtractUtcDays(today, 3);
+    const start = subtractUtcMonths(end, 16);
+    return { startDate: ymd(start), endDate: ymd(end) };
+}
+export function monthChunks(startDate, endDate) {
+    const chunks = [];
+    let cursor = new Date(`${startDate}T00:00:00Z`);
+    const end = new Date(`${endDate}T00:00:00Z`);
+    while (cursor <= end) {
+        const monthEnd = new Date(Date.UTC(cursor.getUTCFullYear(), cursor.getUTCMonth() + 1, 0));
+        const sliceEnd = monthEnd < end ? monthEnd : end;
+        chunks.push({ startDate: ymd(cursor), endDate: ymd(sliceEnd) });
+        cursor = new Date(Date.UTC(sliceEnd.getUTCFullYear(), sliceEnd.getUTCMonth(), sliceEnd.getUTCDate() + 1));
+    }
+    return chunks;
+}
+//# sourceMappingURL=gsc.js.map

package/dist/gsc.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,14 @@
+import type { QuotaApi, QuotaManager } from "./quota.js";
+export type FetchFn = typeof fetch;
+export type GoogleHttp = {
+    fetch: FetchFn;
+    quota: QuotaManager;
+    maxRetries: number;
+    sleep: (ms: number) => Promise<void>;
+    /** Cap for tests. GSC load-quota advice is wait 15 minutes. */
+    maxBackoffMs: number;
+};
+export declare function defaultSleep(ms: number): Promise<void>;
+export declare function googleFetch(http: GoogleHttp, api: QuotaApi, scopeKey: string, url: string, init: RequestInit, cost?: number): Promise<Response>;
+export declare function bearer(token: string, extra?: Record<string, string>): Record<string, string>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD,MAAM,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC;AAEnC,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAIF,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtD;AAaD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,IAAI,SAAI,GACP,OAAO,CAAC,QAAQ,CAAC,CA4BnB;AAED,wBAAgB,MAAM,CACpB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB"}

package/dist/http.js

@@ -0,0 +1,47 @@
+import { QuotaExceededError } from "./errors.js";
+const LOAD_QUOTA_WAIT_MS = 15 * 60_000;
+export function defaultSleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function retryAfterMs(res, attempt, maxBackoffMs) {
+    const header = res.headers.get("retry-after");
+    if (header) {
+        const sec = Number(header);
+        if (Number.isFinite(sec) && sec >= 0)
+            return Math.min(sec * 1000, maxBackoffMs);
+    }
+    const exp = Math.min(1000 * 2 ** attempt, maxBackoffMs);
+    const jitter = Math.floor(Math.random() * 250);
+    return exp + jitter;
+}
+export async function googleFetch(http, api, scopeKey, url, init, cost = 1) {
+    await http.quota.acquire(api, scopeKey, cost);
+    let last;
+    for (let n = 0; n <= http.maxRetries; n++) {
+        const res = await http.fetch(url, init);
+        last = res;
+        if (res.status === 429 || res.status >= 500) {
+            if (n === http.maxRetries)
+                break;
+            let wait = retryAfterMs(res, n, http.maxBackoffMs);
+            if (api === "gsc.searchAnalytics" && res.status === 429) {
+                wait = Math.min(LOAD_QUOTA_WAIT_MS, Math.max(wait, http.maxBackoffMs));
+            }
+            await http.sleep(wait);
+            continue;
+        }
+        http.quota.record(api, scopeKey, cost);
+        return res;
+    }
+    if (!last)
+        throw new Error("googleFetch: no response");
+    if (last.status === 429) {
+        throw new QuotaExceededError(api, `${api} returned 429 after retries`, http.maxBackoffMs);
+    }
+    http.quota.record(api, scopeKey, cost);
+    return last;
+}
+export function bearer(token, extra) {
+    return { Authorization: `Bearer ${token}`, ...extra };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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