@agentsean/google 1.0.0

package/dist/connect-flow.d.ts

@@ -0,0 +1,63 @@
+import type { CredentialStore } from "@agentsean/credentials";
+import type { SqliteDatabase } from "@agentsean/db";
+import { loopbackRedirectUri } from "./oauth-config.js";
+import type { PendingStore } from "./pending.js";
+import { saveApiKey, type StoredGoogleGrant } from "./tokens.js";
+export type ConnectStartInput = {
+    mode?: "broker" | "byo" | undefined;
+    redirectUri: string;
+    siteId?: string | null | undefined;
+    credentialsJson?: string | undefined;
+    clientId?: string | undefined;
+    clientSecret?: string | undefined;
+};
+export declare function startConnect(opts: {
+    store: CredentialStore;
+    pending: PendingStore;
+    input: ConnectStartInput;
+    env?: NodeJS.ProcessEnv | undefined;
+}): Promise<{
+    authorizationUrl: string;
+    state: string;
+    mode: "broker" | "byo";
+}>;
+export declare function finishConnect(opts: {
+    store: CredentialStore;
+    pending: PendingStore;
+    query: {
+        code?: string | undefined;
+        state?: string | undefined;
+        payload?: string | undefined;
+    };
+    fetch?: typeof fetch | undefined;
+    env?: NodeJS.ProcessEnv | undefined;
+}): Promise<StoredGoogleGrant>;
+export declare function discoverProperties(opts: {
+    db: SqliteDatabase;
+    store: CredentialStore;
+    fetch?: typeof fetch | undefined;
+    siteId?: string | null | undefined;
+}): Promise<{
+    email: string | null;
+    testingModeSuspected: boolean;
+    gscSites: {
+        siteUrl: string;
+        permissionLevel: string;
+    }[];
+    ga4Properties: {
+        propertyId: string;
+        displayName: string;
+        accountId: string;
+        accountDisplayName: string;
+    }[];
+    suggestedGsc: string | null;
+}>;
+export declare function bindProperties(opts: {
+    db: SqliteDatabase;
+    store: CredentialStore;
+    siteId: string;
+    gscSiteUrl?: string | null | undefined;
+    ga4PropertyId?: string | null | undefined;
+}): Promise<void>;
+export { loopbackRedirectUri, saveApiKey };
+//# sourceMappingURL=connect-flow.d.ts.map

package/dist/connect-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-flow.d.ts","sourceRoot":"","sources":["../src/connect-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAEL,mBAAmB,EAEpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAKL,UAAU,EAEV,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AAUrB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,iBAAiB,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;CACrC,GAAG,OAAO,CAAC;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAA;CAAE,CAAC,CAmC/E;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;CACrC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6B7B;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACpC,GAAG,OAAO,CAAC;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzD,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,EAAE,CAAC;IACJ,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC,CA8CD;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,EAAE,EAAE,cAAc,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC3C,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB;AAED,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,CAAC"}

package/dist/connect-flow.js

@@ -0,0 +1,150 @@
+import { sites } from "@agentsean/db";
+import { eq } from "drizzle-orm";
+import { resolveOAuthConfig, loopbackRedirectUri, parseDesktopClientJson, } from "./oauth-config.js";
+import { startByoAuthorization, exchangeByoCode } from "./oauth-desktop.js";
+import { grantFromBrokerHandoff, startBrokerAuthorization } from "./oauth-broker.js";
+import { loadByoClient, loadGrant, saveByoClient, saveGrant, saveApiKey, } from "./tokens.js";
+import { createGscClient } from "./gsc.js";
+import { createGa4Client } from "./ga4.js";
+import { createQuotaManager } from "./quota.js";
+import { defaultSleep } from "./http.js";
+import { upsertGa4Connection, upsertGscConnection } from "./persist.js";
+import { GOOGLE_USERINFO_URL } from "./scopes.js";
+import { GscTokenError } from "./errors.js";
+import { normalizeGscSiteUrl } from "./scopes.js";
+export async function startConnect(opts) {
+    const cfg = resolveOAuthConfig(opts.env);
+    let byo = cfg.byo;
+    if (opts.input.credentialsJson) {
+        byo = parseDesktopClientJson(opts.input.credentialsJson);
+    }
+    else if (opts.input.clientId && opts.input.clientSecret) {
+        byo = { clientId: opts.input.clientId, clientSecret: opts.input.clientSecret };
+    }
+    const mode = opts.input.mode ?? (byo ? "byo" : "broker");
+    if (mode === "byo") {
+        if (!byo) {
+            throw new GscTokenError("BYO Google Cloud project requires GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET, or --credentials client_secret.json.");
+        }
+        await saveByoClient(opts.store, byo);
+        const started = startByoAuthorization({
+            client: byo,
+            redirectUri: opts.input.redirectUri,
+            pending: opts.pending,
+            siteId: opts.input.siteId,
+        });
+        return { ...started, mode: "byo" };
+    }
+    const started = startBrokerAuthorization({
+        brokerUrl: cfg.brokerUrl,
+        redirectUri: opts.input.redirectUri,
+        pending: opts.pending,
+        siteId: opts.input.siteId,
+    });
+    return {
+        authorizationUrl: started.authorizationUrl,
+        state: started.state,
+        mode: "broker",
+    };
+}
+export async function finishConnect(opts) {
+    const state = opts.query.state;
+    if (!state)
+        throw new GscTokenError("OAuth callback missing state.");
+    const pending = opts.pending.take(state);
+    if (!pending)
+        throw new GscTokenError("OAuth state is unknown or expired. Start connect again.");
+    const prev = await loadGrant(opts.store);
+    const fetchFn = opts.fetch ?? fetch;
+    if (pending.mode === "broker") {
+        if (!opts.query.payload)
+            throw new GscTokenError("Broker callback missing sealed payload.");
+        const grant = grantFromBrokerHandoff(pending, opts.query.payload, prev);
+        await saveGrant(opts.store, grant);
+        return grant;
+    }
+    if (!opts.query.code)
+        throw new GscTokenError("OAuth callback missing code.");
+    const cfg = resolveOAuthConfig(opts.env);
+    const byo = (await loadByoClient(opts.store)) ?? cfg.byo;
+    if (!byo)
+        throw new GscTokenError("BYO client credentials missing at token exchange.");
+    const grant = await exchangeByoCode({
+        client: byo,
+        pending,
+        code: opts.query.code,
+        fetch: fetchFn,
+        prev,
+    });
+    await saveGrant(opts.store, grant);
+    return grant;
+}
+export async function discoverProperties(opts) {
+    const grant = await loadGrant(opts.store);
+    if (!grant)
+        throw new GscTokenError("Google is not connected.");
+    const http = {
+        fetch: opts.fetch ?? fetch,
+        quota: createQuotaManager(opts.db),
+        maxRetries: 2,
+        sleep: defaultSleep,
+        maxBackoffMs: 1000,
+    };
+    const getToken = async () => grant.accessToken;
+    const gsc = createGscClient({ http, getToken });
+    const ga4 = createGa4Client({ http, getToken });
+    let email = grant.email;
+    try {
+        const res = await http.fetch(GOOGLE_USERINFO_URL, {
+            headers: { Authorization: `Bearer ${grant.accessToken}` },
+        });
+        if (res.ok) {
+            const info = (await res.json());
+            email = typeof info.email === "string" ? info.email : email;
+        }
+    }
+    catch {
+        // ignore
+    }
+    const gscSites = await gsc.listSites();
+    const ga4Properties = await ga4.listProperties();
+    let suggestedGsc = null;
+    if (opts.siteId) {
+        const site = opts.db.select().from(sites).where(eq(sites.id, opts.siteId)).get();
+        if (site) {
+            const want = normalizeGscSiteUrl(site.origin);
+            suggestedGsc =
+                gscSites.find((s) => s.siteUrl === want)?.siteUrl ??
+                    gscSites.find((s) => site.origin.startsWith(s.siteUrl.replace(/\/$/, "")))
+                        ?.siteUrl ??
+                    null;
+        }
+    }
+    return {
+        email,
+        testingModeSuspected: grant.testingModeSuspected,
+        gscSites,
+        ga4Properties,
+        suggestedGsc,
+    };
+}
+export async function bindProperties(opts) {
+    const grant = await loadGrant(opts.store);
+    if (opts.gscSiteUrl) {
+        upsertGscConnection(opts.db, {
+            siteId: opts.siteId,
+            siteUrl: opts.gscSiteUrl,
+            accountEmail: grant?.email,
+            googleSub: grant?.googleSub,
+        });
+    }
+    if (opts.ga4PropertyId) {
+        upsertGa4Connection(opts.db, {
+            siteId: opts.siteId,
+            propertyId: opts.ga4PropertyId,
+            accountEmail: grant?.email,
+        });
+    }
+}
+export { loopbackRedirectUri, saveApiKey };
+//# sourceMappingURL=connect-flow.js.map

package/dist/connect-flow.js.map

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

package/dist/crux.d.ts

@@ -0,0 +1,37 @@
+import { type GoogleHttp } from "./http.js";
+export type CruxFormFactor = "PHONE" | "DESKTOP" | "TABLET" | "ALL";
+export type CruxMetrics = {
+    lcpP75: number | null;
+    inpP75: number | null;
+    clsP75: number | null;
+    ttfbP75: number | null;
+    fcpP75: number | null;
+};
+export type CruxRecord = CruxMetrics & {
+    identifier: string;
+    identifierKind: "url" | "origin";
+    formFactor: CruxFormFactor;
+    collectionDate: string;
+    insufficientTraffic: boolean;
+    sourceApi: "crux" | "crux_history";
+    raw: unknown;
+};
+/**
+ * URL-level 404 is normal (insufficient traffic), not an error.
+ * Fall back to origin-level.
+ */
+export declare function queryCruxWithFallback(opts: {
+    http: GoogleHttp;
+    apiKey: string;
+    url: string;
+    origin: string;
+    formFactor?: CruxFormFactor | undefined;
+}): Promise<CruxRecord>;
+export declare function queryCruxHistory(opts: {
+    http: GoogleHttp;
+    apiKey: string;
+    origin: string;
+    formFactor?: CruxFormFactor | undefined;
+    collectionPeriodCount?: number | undefined;
+}): Promise<unknown>;
+//# sourceMappingURL=crux.d.ts.map

package/dist/crux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crux.d.ts","sourceRoot":"","sources":["../src/crux.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAMzD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEpE,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,KAAK,GAAG,QAAQ,CAAC;IACjC,UAAU,EAAE,cAAc,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC;IACnC,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAyCF;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;CACzC,GAAG,OAAO,CAAC,UAAU,CAAC,CA+DtB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACxC,qBAAqB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5C,GAAG,OAAO,CAAC,OAAO,CAAC,CAanB"}

package/dist/crux.js

@@ -0,0 +1,112 @@
+import { googleFetch } from "./http.js";
+const CRUX = "https://chromeuxreport.googleapis.com/v1/records:queryRecord";
+const CRUX_HISTORY = "https://chromeuxreport.googleapis.com/v1/records:queryHistoryRecord";
+function p75(metrics, name) {
+    if (!metrics || typeof metrics !== "object")
+        return null;
+    const m = metrics[name];
+    const v = m?.percentiles?.p75;
+    return typeof v === "number" ? v : null;
+}
+function metricsOf(obj) {
+    return {
+        lcpP75: p75(obj, "largest_contentful_paint"),
+        inpP75: p75(obj, "interaction_to_next_paint"),
+        clsP75: p75(obj, "cumulative_layout_shift"),
+        ttfbP75: p75(obj, "experimental_time_to_first_byte"),
+        fcpP75: p75(obj, "first_contentful_paint"),
+    };
+}
+async function queryCrux(opts) {
+    const endpoint = opts.history ? CRUX_HISTORY : CRUX;
+    const res = await googleFetch(opts.http, "crux", "project", `${endpoint}?key=${encodeURIComponent(opts.apiKey)}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(opts.body),
+    });
+    const json = await res.json().catch(() => ({}));
+    return { status: res.status, json };
+}
+/**
+ * URL-level 404 is normal (insufficient traffic), not an error.
+ * Fall back to origin-level.
+ */
+export async function queryCruxWithFallback(opts) {
+    const formFactor = opts.formFactor ?? "PHONE";
+    const today = new Date().toISOString().slice(0, 10);
+    const ff = formFactor === "ALL" ? undefined : formFactor;
+    const urlBody = { url: opts.url };
+    if (ff)
+        urlBody.formFactor = ff;
+    const urlHit = await queryCrux({
+        http: opts.http,
+        apiKey: opts.apiKey,
+        body: urlBody,
+        history: false,
+    });
+    if (urlHit.status === 200) {
+        const rec = urlHit.json;
+        return {
+            identifier: opts.url,
+            identifierKind: "url",
+            formFactor,
+            collectionDate: today,
+            insufficientTraffic: false,
+            sourceApi: "crux",
+            raw: urlHit.json,
+            ...metricsOf(rec.record?.metrics),
+        };
+    }
+    const originBody = { origin: opts.origin };
+    if (ff)
+        originBody.formFactor = ff;
+    const originHit = await queryCrux({
+        http: opts.http,
+        apiKey: opts.apiKey,
+        body: originBody,
+        history: false,
+    });
+    if (originHit.status === 200) {
+        const rec = originHit.json;
+        return {
+            identifier: opts.origin,
+            identifierKind: "origin",
+            formFactor,
+            collectionDate: today,
+            insufficientTraffic: urlHit.status === 404,
+            sourceApi: "crux",
+            raw: originHit.json,
+            ...metricsOf(rec.record?.metrics),
+        };
+    }
+    return {
+        identifier: opts.origin,
+        identifierKind: "origin",
+        formFactor,
+        collectionDate: today,
+        insufficientTraffic: true,
+        sourceApi: "crux",
+        raw: originHit.json,
+        lcpP75: null,
+        inpP75: null,
+        clsP75: null,
+        ttfbP75: null,
+        fcpP75: null,
+    };
+}
+export async function queryCruxHistory(opts) {
+    const body = {
+        origin: opts.origin,
+        collectionPeriodCount: opts.collectionPeriodCount ?? 25,
+    };
+    if (opts.formFactor && opts.formFactor !== "ALL")
+        body.formFactor = opts.formFactor;
+    const hit = await queryCrux({
+        http: opts.http,
+        apiKey: opts.apiKey,
+        body,
+        history: true,
+    });
+    return hit.json;
+}
+//# sourceMappingURL=crux.js.map

package/dist/crux.js.map

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

package/dist/data/changepoints.json

@@ -0,0 +1,174 @@
+[
+  {
+    "id": "gsc-impressions-logging-error-2025",
+    "kind": "DATA_ANOMALY",
+    "begin": "2025-05-13",
+    "end": "2026-04-27",
+    "title": "GSC impressions logging error",
+    "metricImpact": ["impressions", "ctr", "position"],
+    "clicksAffected": false,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated",
+    "notes": "Google Data Anomalies: impressions, CTR and average position inaccurate 2025-05-13 → 2026-04-27. Clicks unaffected. Never backfilled. Default every metric to clicks."
+  },
+  {
+    "id": "gsc-num100-removal-2025",
+    "kind": "DATA_COLLECTION_CHANGE",
+    "begin": "2025-09-10",
+    "end": "2025-09-14",
+    "title": "&num=100 parameter removed",
+    "metricImpact": ["impressions", "position"],
+    "clicksAffected": false,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated",
+    "notes": "Google stopped honoring &num=100 ~2025-09-10–14. Bot-inflated impressions vanished; clicks stayed flat; average position improved mechanically. Never officially announced. Naive YoY impression comparison is a false decay alert."
+  },
+  {
+    "id": "gsc-ai-mode-foldin-2025-06-17",
+    "kind": "DATA_COLLECTION_CHANGE",
+    "begin": "2025-06-17",
+    "end": "2025-06-17",
+    "title": "AI Mode folded into GSC totals",
+    "metricImpact": ["impressions"],
+    "clicksAffected": false,
+    "impressionsAffected": true,
+    "positionAffected": false,
+    "source": "curated",
+    "notes": "AI Mode impressions folded into Search Console totals. Impressions step up."
+  },
+  {
+    "id": "gsc-impressions-fix-rollout-2026",
+    "kind": "DATA_ANOMALY",
+    "begin": "2026-04-03",
+    "end": "2026-04-27",
+    "title": "GSC impressions logging error correction rollout",
+    "metricImpact": ["impressions", "ctr", "position"],
+    "clicksAffected": false,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated",
+    "notes": "Correction of the 2025-05-13 logging error, going forward only. Impressions drop as the inflation ends. No historical backfill."
+  },
+  {
+    "id": "core-2025-03",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2025-03-13",
+    "end": "2025-03-27",
+    "title": "March 2025 core update",
+    "metricImpact": ["clicks", "impressions", "position"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated"
+  },
+  {
+    "id": "core-2025-06",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2025-06-30",
+    "end": "2025-07-17",
+    "title": "June 2025 core update",
+    "metricImpact": ["clicks", "impressions", "position"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated"
+  },
+  {
+    "id": "spam-2025-08",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2025-08-26",
+    "end": "2025-09-22",
+    "title": "August 2025 spam update",
+    "metricImpact": ["clicks", "impressions", "position"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated"
+  },
+  {
+    "id": "core-2025-12",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2025-12-11",
+    "end": "2025-12-29",
+    "title": "December 2025 core update",
+    "metricImpact": ["clicks", "impressions", "position"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated"
+  },
+  {
+    "id": "discover-2026-02",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2026-02-05",
+    "end": "2026-02-27",
+    "title": "February 2026 Discover update",
+    "metricImpact": ["clicks", "impressions"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": false,
+    "source": "curated"
+  },
+  {
+    "id": "spam-2026-03",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2026-03-24",
+    "end": "2026-03-25",
+    "title": "March 2026 spam update",
+    "metricImpact": ["clicks", "impressions", "position"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated"
+  },
+  {
+    "id": "core-2026-03",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2026-03-27",
+    "end": "2026-04-08",
+    "title": "March 2026 core update",
+    "metricImpact": ["clicks", "impressions", "position"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated"
+  },
+  {
+    "id": "core-2026-05",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2026-05-21",
+    "end": "2026-06-02",
+    "title": "May 2026 core update",
+    "metricImpact": ["clicks", "impressions", "position"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated"
+  },
+  {
+    "id": "spam-2026-06",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2026-06-24",
+    "end": "2026-06-26",
+    "title": "June 2026 spam update",
+    "metricImpact": ["clicks", "impressions", "position"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated"
+  },
+  {
+    "id": "spam-2026-08",
+    "kind": "GOOGLE_RANKING_UPDATE",
+    "begin": "2026-08-18",
+    "end": "2026-08-21",
+    "title": "August 2026 spam update",
+    "metricImpact": ["clicks", "impressions", "position"],
+    "clicksAffected": true,
+    "impressionsAffected": true,
+    "positionAffected": true,
+    "source": "curated"
+  }
+]

package/dist/data/quotas.json

@@ -0,0 +1,17 @@
+{
+  "gsc.searchAnalytics": {
+    "qpm": 1200,
+    "rowLimitMax": 25000,
+    "rowsPerDayPerType": 50000
+  },
+  "gsc.urlInspection": { "qpdPerSite": 2000, "qpmPerSite": 600 },
+  "gsc.other": { "qps": 20, "qpm": 200 },
+  "ga4.data": {
+    "tokensPerHourProjectProperty": 14000,
+    "tokensPerDayProperty": 200000,
+    "maxRows": 250000
+  },
+  "psi": { "qpd": 25000, "qpm": 240 },
+  "crux": { "qpm": 150, "purchasable": false },
+  "indexing": { "qpd": 200, "allowedTypes": ["JobPosting", "BroadcastEvent"] }
+}

package/dist/errors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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 declare class GscApiError extends Error {
+    readonly status: number;
+    readonly body?: string | undefined;
+    constructor(status: number, message: string, body?: string | undefined);
+}
+export declare class GscTokenError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class GscNotConnectedError extends Error {
+    readonly siteId: string;
+    constructor(siteId: string);
+}
+export declare class Ga4AdminApiError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export declare class Ga4TokenError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class Ga4DataApiError extends Error {
+    readonly status: number;
+    readonly retryAfterSeconds: number | null;
+    readonly upstreamReason: string | null;
+    constructor(status: number, message: string, retryAfterSeconds?: number | null, upstreamReason?: string | null);
+}
+export declare class Ga4NotConnectedError extends Error {
+    readonly siteId: string;
+    constructor(siteId: string);
+}
+export declare class QuotaExceededError extends Error {
+    readonly api: string;
+    readonly retryAfterMs: number;
+    constructor(api: string, message: string, retryAfterMs: number);
+}
+export declare function gscMessageForStatus(status: number, body: string): string;
+export declare function ga4AdminMessageForStatus(status: number): string;
+export declare function ga4DataMessageForStatus(status: number): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,WAAY,SAAQ,KAAK;aAElB,MAAM,EAAE,MAAM;aAEd,IAAI,CAAC,EAAE,MAAM;gBAFb,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED,qBAAa,aAAc,SAAQ,KAAK;aAGX,KAAK,CAAC,EAAE,OAAO;gBADxC,OAAO,EAAE,MAAM,EACU,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3C;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI3C;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM;CAKlB;AAED,qBAAa,aAAc,SAAQ,KAAK;aAGX,KAAK,CAAC,EAAE,OAAO;gBADxC,OAAO,EAAE,MAAM,EACU,KAAK,CAAC,EAAE,OAAO,YAAA;CAK3C;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,MAAM,EAAE,MAAM;aAEd,iBAAiB,EAAE,MAAM,GAAG,IAAI;aAChC,cAAc,EAAE,MAAM,GAAG,IAAI;gBAH7B,MAAM,EAAE,MAAM,EAC9B,OAAO,EAAE,MAAM,EACC,iBAAiB,GAAE,MAAM,GAAG,IAAW,EACvC,cAAc,GAAE,MAAM,GAAG,IAAW;CAKvD;AAED,qBAAa,oBAAqB,SAAQ,KAAK;aACjB,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI3C;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,GAAG,EAAE,MAAM;aAEX,YAAY,EAAE,MAAM;gBAFpB,GAAG,EAAE,MAAM,EAC3B,OAAO,EAAE,MAAM,EACC,YAAY,EAAE,MAAM;CAKvC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWxE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK9D"}