@agentsean/google 1.0.0

package/dist/incidents.d.ts

@@ -0,0 +1,51 @@
+import type { SqliteDatabase } from "@agentsean/db";
+export declare const INCIDENTS_JSON = "https://status.search.google.com/incidents.json";
+export declare const INCIDENTS_ATOM = "https://status.search.google.com/en/feed.atom";
+export declare const PRODUCTS_JSON = "https://status.search.google.com/products.json";
+export declare const SERVICE_RANKING = "rGHU1u87FJnkP6W2GwMi";
+export declare const SERVICE_CRAWLING = "QAVfsAEBQ159b2mEWBYF";
+export declare const SERVICE_INDEXING = "DRyTdKyPd41QXD2hnncp";
+export declare const SERVICE_SERVING = "pKUD9XkLn3TBLquSpQMD";
+export type GoogleIncident = {
+    id: string;
+    number?: string;
+    begin: string;
+    end?: string | null;
+    created?: string;
+    modified?: string;
+    external_desc: string;
+    status_impact?: string;
+    severity?: string;
+    service_key: string;
+    service_name: string;
+    uri?: string;
+};
+export declare function parseIncidentsJson(raw: unknown): GoogleIncident[];
+/** Minimal Atom fallback if incidents.json is down. */
+export declare function parseIncidentsAtom(xml: string): GoogleIncident[];
+export declare function fetchIncidents(fetchFn: typeof fetch): Promise<GoogleIncident[]>;
+type CuratedRow = {
+    id: string;
+    kind: string;
+    begin: string;
+    end: string | null;
+    title: string;
+    metricImpact: string[];
+    clicksAffected: boolean;
+    impressionsAffected: boolean;
+    positionAffected: boolean;
+    source: string;
+    notes?: string;
+};
+export declare function loadCuratedChangepoints(): CuratedRow[];
+export declare function upsertIncidents(db: SqliteDatabase, incidents: GoogleIncident[]): number;
+export declare function seedCuratedChangepoints(db: SqliteDatabase): number;
+export declare function changepointsOverlapping(db: SqliteDatabase, startDate: string, endDate: string): {
+    id: string;
+    title: string;
+    kind: string;
+    begin: string;
+    end: string | null;
+}[];
+export {};
+//# sourceMappingURL=incidents.d.ts.map

package/dist/incidents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incidents.d.ts","sourceRoot":"","sources":["../src/incidents.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,eAAO,MAAM,cAAc,oDAAoD,CAAC;AAChF,eAAO,MAAM,cAAc,kDAAkD,CAAC;AAC9E,eAAO,MAAM,aAAa,mDAAmD,CAAC;AAE9E,eAAO,MAAM,eAAe,yBAAyB,CAAC;AACtD,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,eAAe,yBAAyB,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,EAAE,CA0BjE;AAED,uDAAuD;AACvD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAkBhE;AAOD,wBAAsB,cAAc,CAAC,OAAO,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAgBrF;AAED,KAAK,UAAU,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAOF,wBAAgB,uBAAuB,IAAI,UAAU,EAAE,CAGtD;AAED,wBAAgB,eAAe,CAC7B,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,cAAc,EAAE,GAC1B,MAAM,CAoDR;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAmBlE;AAgDD,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,cAAc,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,CAiBlF"}

package/dist/incidents.js

@@ -0,0 +1,221 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { randomUUID } from "node:crypto";
+import { eq } from "drizzle-orm";
+import { googleChangepoints, googleIncidents } from "@agentsean/db";
+export const INCIDENTS_JSON = "https://status.search.google.com/incidents.json";
+export const INCIDENTS_ATOM = "https://status.search.google.com/en/feed.atom";
+export const PRODUCTS_JSON = "https://status.search.google.com/products.json";
+export const SERVICE_RANKING = "rGHU1u87FJnkP6W2GwMi";
+export const SERVICE_CRAWLING = "QAVfsAEBQ159b2mEWBYF";
+export const SERVICE_INDEXING = "DRyTdKyPd41QXD2hnncp";
+export const SERVICE_SERVING = "pKUD9XkLn3TBLquSpQMD";
+export function parseIncidentsJson(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const row of raw) {
+        if (!row || typeof row !== "object")
+            continue;
+        const r = row;
+        if (typeof r.id !== "string" || typeof r.begin !== "string")
+            continue;
+        if (typeof r.external_desc !== "string" || typeof r.service_key !== "string")
+            continue;
+        const incident = {
+            id: r.id,
+            begin: r.begin,
+            end: typeof r.end === "string" ? r.end : null,
+            external_desc: r.external_desc,
+            service_key: r.service_key,
+            service_name: typeof r.service_name === "string" ? r.service_name : "unknown",
+        };
+        if (typeof r.number === "string")
+            incident.number = r.number;
+        if (typeof r.created === "string")
+            incident.created = r.created;
+        if (typeof r.modified === "string")
+            incident.modified = r.modified;
+        if (typeof r.status_impact === "string")
+            incident.status_impact = r.status_impact;
+        if (typeof r.severity === "string")
+            incident.severity = r.severity;
+        if (typeof r.uri === "string")
+            incident.uri = r.uri;
+        out.push(incident);
+    }
+    return out;
+}
+/** Minimal Atom fallback if incidents.json is down. */
+export function parseIncidentsAtom(xml) {
+    const entries = xml.split(/<entry[\s>]/i).slice(1);
+    const out = [];
+    for (const e of entries) {
+        const title = inner(e, "title") ?? "Google Search incident";
+        const updated = inner(e, "updated") ?? inner(e, "published") ?? new Date().toISOString();
+        const id = inner(e, "id") ?? title;
+        out.push({
+            id: id.slice(0, 64),
+            begin: updated,
+            end: null,
+            external_desc: title,
+            service_key: SERVICE_RANKING,
+            service_name: "Ranking",
+        });
+    }
+    return out;
+}
+function inner(xml, tag) {
+    const m = xml.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`, "i"));
+    return m?.[1]?.replace(/<!\[CDATA\[|\]\]>/g, "").trim() ?? null;
+}
+export async function fetchIncidents(fetchFn) {
+    try {
+        const res = await fetchFn(INCIDENTS_JSON, {
+            headers: { accept: "application/json" },
+        });
+        if (res.ok) {
+            return parseIncidentsJson(await res.json());
+        }
+    }
+    catch {
+        // fall through to Atom
+    }
+    const atom = await fetchFn(INCIDENTS_ATOM, {
+        headers: { accept: "application/atom+xml, application/xml, text/xml" },
+    });
+    if (!atom.ok)
+        return [];
+    return parseIncidentsAtom(await atom.text());
+}
+function curatedPath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return join(here, "data", "changepoints.json");
+}
+export function loadCuratedChangepoints() {
+    const raw = JSON.parse(readFileSync(curatedPath(), "utf8"));
+    return raw;
+}
+export function upsertIncidents(db, incidents) {
+    const now = new Date().toISOString();
+    let n = 0;
+    for (const inc of incidents) {
+        const existing = db
+            .select()
+            .from(googleIncidents)
+            .where(eq(googleIncidents.id, inc.id))
+            .get();
+        const values = {
+            id: inc.id,
+            number: inc.number ?? null,
+            begin: inc.begin,
+            end: inc.end ?? null,
+            created: inc.created ?? null,
+            modified: inc.modified ?? null,
+            externalDesc: inc.external_desc,
+            statusImpact: inc.status_impact ?? null,
+            severity: inc.severity ?? null,
+            serviceKey: inc.service_key,
+            serviceName: inc.service_name,
+            uri: inc.uri ?? null,
+            raw: JSON.stringify(inc),
+            ingestedAt: now,
+        };
+        if (existing) {
+            db.update(googleIncidents)
+                .set(values)
+                .where(eq(googleIncidents.id, inc.id))
+                .run();
+        }
+        else {
+            db.insert(googleIncidents).values(values).run();
+        }
+        n += 1;
+        if (inc.service_key === SERVICE_RANKING) {
+            upsertChangepoint(db, {
+                kind: "GOOGLE_RANKING_UPDATE",
+                begin: inc.begin.slice(0, 10),
+                end: inc.end ? inc.end.slice(0, 10) : null,
+                title: inc.external_desc,
+                metricImpact: ["clicks", "impressions", "position"],
+                clicksAffected: 1,
+                impressionsAffected: 1,
+                positionAffected: 1,
+                source: "incidents",
+                incidentId: inc.id,
+                notes: null,
+            });
+        }
+    }
+    return n;
+}
+export function seedCuratedChangepoints(db) {
+    let n = 0;
+    for (const row of loadCuratedChangepoints()) {
+        upsertChangepoint(db, {
+            kind: row.kind,
+            begin: row.begin,
+            end: row.end,
+            title: row.title,
+            metricImpact: row.metricImpact,
+            clicksAffected: row.clicksAffected ? 1 : 0,
+            impressionsAffected: row.impressionsAffected ? 1 : 0,
+            positionAffected: row.positionAffected ? 1 : 0,
+            source: row.source,
+            incidentId: null,
+            notes: row.notes ?? null,
+        });
+        n += 1;
+    }
+    return n;
+}
+function upsertChangepoint(db, row) {
+    const existing = db
+        .select()
+        .from(googleChangepoints)
+        .all()
+        .find((r) => r.kind === row.kind && r.begin === row.begin && r.title === row.title);
+    const values = {
+        kind: row.kind,
+        begin: row.begin,
+        end: row.end,
+        title: row.title,
+        metricImpact: JSON.stringify(row.metricImpact),
+        clicksAffected: row.clicksAffected,
+        impressionsAffected: row.impressionsAffected,
+        positionAffected: row.positionAffected,
+        source: row.source,
+        incidentId: row.incidentId,
+        notes: row.notes,
+    };
+    if (existing) {
+        db.update(googleChangepoints)
+            .set(values)
+            .where(eq(googleChangepoints.id, existing.id))
+            .run();
+        return;
+    }
+    db.insert(googleChangepoints)
+        .values({ id: randomUUID(), ...values })
+        .run();
+}
+export function changepointsOverlapping(db, startDate, endDate) {
+    return db
+        .select()
+        .from(googleChangepoints)
+        .all()
+        .filter((r) => {
+        const b = r.begin;
+        const e = r.end ?? r.begin;
+        return b <= endDate && e >= startDate;
+    })
+        .map((r) => ({
+        id: r.id,
+        title: r.title,
+        kind: r.kind,
+        begin: r.begin,
+        end: r.end,
+    }));
+}
+//# sourceMappingURL=incidents.js.map

package/dist/incidents.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { CONNECT_SCOPES, DEFAULT_BROKER_URL, SCOPE, encodeSiteUrl, normalizeGscSiteUrl, } from "./scopes.js";
+export { generatePkce, randomState, randomWrapKey } from "./pkce.js";
+export { seal, unseal } from "./seal.js";
+export { resolveOAuthConfig, parseDesktopClientJson, loopbackRedirectUri, } from "./oauth-config.js";
+export { createPendingStore, type PendingStore, type PendingOauth } from "./pending.js";
+export { startByoAuthorization, exchangeByoCode, buildGoogleAuthUrl, } from "./oauth-desktop.js";
+export { startBrokerAuthorization, grantFromBrokerHandoff, brokerRefreshAccessToken, } from "./oauth-broker.js";
+export { brokerStartUrl, brokerHandleGoogleCallback, brokerHandleRefresh, loadBrokerSecrets, setBrokerRegisteredCallback, sealWithWrapKey, } from "./broker.js";
+export { loadGrant, saveGrant, loadByoClient, saveByoClient, loadApiKey, saveApiKey, grantFromTokenResponse, testingModeFromTokenResponse, refreshAccessToken, validAccessToken, type StoredGoogleGrant, type ByoClient, } from "./tokens.js";
+export { GscApiError, GscTokenError, GscNotConnectedError, Ga4AdminApiError, Ga4DataApiError, Ga4NotConnectedError, QuotaExceededError, } from "./errors.js";
+export { createQuotaManager, LIMITS, type QuotaManager } from "./quota.js";
+export { createGscClient, defaultGscWindow, monthChunks, GSC_ROW_LIMIT_MAX, } from "./gsc.js";
+export { createGa4Client, googleOrganicFilter } from "./ga4.js";
+export { createSiteVerificationClient, metaVerificationTag, fileVerificationPath, } from "./verification.js";
+export { runPsi } from "./psi.js";
+export { queryCruxWithFallback, queryCruxHistory } from "./crux.js";
+export { fetchIncidents, parseIncidentsJson, parseIncidentsAtom, upsertIncidents, seedCuratedChangepoints, changepointsOverlapping, SERVICE_RANKING, } from "./incidents.js";
+export { decideMetric, preferredMetric, impressionsContaminated, num100Straddle, DEFAULT_METRIC, IMPRESSIONS_BUG_BEGIN, IMPRESSIONS_BUG_END, NUM100_BEGIN, NUM100_END, } from "./integrity.js";
+export { computeResidual, reconcileSite } from "./reconcile.js";
+export { DISCREPANCY_CAUSES, GSC_ANONYMIZED_SHARE, EU_GA4_INVISIBLE_LOW, EU_GA4_INVISIBLE_HIGH, isEuTimeZone, type DiscrepancyCause, type DiscrepancyCauseCode, } from "./causes.js";
+export { buildWaterfall, waterfallFromSite, persistWaterfall, type WaterfallInput, type WaterfallResult, type WaterfallStep, } from "./waterfall.js";
+export { syncGoogle, type SyncResult } from "./sync.js";
+export { loadAuditExtras } from "./audit-extras.js";
+export { startConnect, finishConnect, discoverProperties, bindProperties, } from "./connect-flow.js";
+export { upsertGscConnection, upsertGa4Connection, persistVerification, } from "./persist.js";
+export { defaultSleep, type GoogleHttp } from "./http.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,27 @@
+export { CONNECT_SCOPES, DEFAULT_BROKER_URL, SCOPE, encodeSiteUrl, normalizeGscSiteUrl, } from "./scopes.js";
+export { generatePkce, randomState, randomWrapKey } from "./pkce.js";
+export { seal, unseal } from "./seal.js";
+export { resolveOAuthConfig, parseDesktopClientJson, loopbackRedirectUri, } from "./oauth-config.js";
+export { createPendingStore } from "./pending.js";
+export { startByoAuthorization, exchangeByoCode, buildGoogleAuthUrl, } from "./oauth-desktop.js";
+export { startBrokerAuthorization, grantFromBrokerHandoff, brokerRefreshAccessToken, } from "./oauth-broker.js";
+export { brokerStartUrl, brokerHandleGoogleCallback, brokerHandleRefresh, loadBrokerSecrets, setBrokerRegisteredCallback, sealWithWrapKey, } from "./broker.js";
+export { loadGrant, saveGrant, loadByoClient, saveByoClient, loadApiKey, saveApiKey, grantFromTokenResponse, testingModeFromTokenResponse, refreshAccessToken, validAccessToken, } from "./tokens.js";
+export { GscApiError, GscTokenError, GscNotConnectedError, Ga4AdminApiError, Ga4DataApiError, Ga4NotConnectedError, QuotaExceededError, } from "./errors.js";
+export { createQuotaManager, LIMITS } from "./quota.js";
+export { createGscClient, defaultGscWindow, monthChunks, GSC_ROW_LIMIT_MAX, } from "./gsc.js";
+export { createGa4Client, googleOrganicFilter } from "./ga4.js";
+export { createSiteVerificationClient, metaVerificationTag, fileVerificationPath, } from "./verification.js";
+export { runPsi } from "./psi.js";
+export { queryCruxWithFallback, queryCruxHistory } from "./crux.js";
+export { fetchIncidents, parseIncidentsJson, parseIncidentsAtom, upsertIncidents, seedCuratedChangepoints, changepointsOverlapping, SERVICE_RANKING, } from "./incidents.js";
+export { decideMetric, preferredMetric, impressionsContaminated, num100Straddle, DEFAULT_METRIC, IMPRESSIONS_BUG_BEGIN, IMPRESSIONS_BUG_END, NUM100_BEGIN, NUM100_END, } from "./integrity.js";
+export { computeResidual, reconcileSite } from "./reconcile.js";
+export { DISCREPANCY_CAUSES, GSC_ANONYMIZED_SHARE, EU_GA4_INVISIBLE_LOW, EU_GA4_INVISIBLE_HIGH, isEuTimeZone, } from "./causes.js";
+export { buildWaterfall, waterfallFromSite, persistWaterfall, } from "./waterfall.js";
+export { syncGoogle } from "./sync.js";
+export { loadAuditExtras } from "./audit-extras.js";
+export { startConnect, finishConnect, discoverProperties, bindProperties, } from "./connect-flow.js";
+export { upsertGscConnection, upsertGa4Connection, persistVerification, } from "./persist.js";
+export { defaultSleep } from "./http.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,KAAK,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAwC,MAAM,cAAc,CAAC;AACxF,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,sBAAsB,EACtB,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,GAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAqB,MAAM,YAAY,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,GAGb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GAIjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,UAAU,EAAmB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAmB,MAAM,WAAW,CAAC"}

package/dist/integrity.d.ts

@@ -0,0 +1,32 @@
+/** Data-integrity landmines that must be encoded now (PLAN.md Phase 2). */
+export declare const IMPRESSIONS_BUG_BEGIN = "2025-05-13";
+export declare const IMPRESSIONS_BUG_END = "2026-04-27";
+export declare const NUM100_BEGIN = "2025-09-10";
+export declare const NUM100_END = "2025-09-14";
+export declare const NUM100_STRADDLE = "2025-09-12";
+export type GscMetric = "clicks" | "impressions" | "ctr" | "position";
+export declare const DEFAULT_METRIC: GscMetric;
+export declare function rangesOverlap(aStart: string, aEnd: string, bStart: string, bEnd: string): boolean;
+export declare function impressionsContaminated(startDate: string, endDate: string): boolean;
+export declare function num100Straddle(startDate: string, endDate: string): boolean;
+export type MetricDecision = {
+    metric: GscMetric;
+    allowed: boolean;
+    reasons: string[];
+};
+/**
+ * Default every metric to clicks. Impressions/CTR/position are blocked across
+ * the logging-error window and across the &num=100 removal.
+ */
+export declare function decideMetric(requested: GscMetric, startDate: string, endDate: string): MetricDecision;
+export declare function preferredMetric(requested: GscMetric | undefined, startDate: string, endDate: string): MetricDecision;
+export declare function annotateSeries<T extends {
+    date: string;
+}>(rows: T[], overlapping: {
+    begin: string;
+    end: string | null;
+    title: string;
+}[]): (T & {
+    annotations: string[];
+})[];
+//# sourceMappingURL=integrity.d.ts.map

package/dist/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../src/integrity.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAClD,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAChD,eAAO,MAAM,YAAY,eAAe,CAAC;AACzC,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,KAAK,GAAG,UAAU,CAAC;AAEtE,eAAO,MAAM,cAAc,EAAE,SAAoB,CAAC;AAElD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAET;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1E;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,cAAc,CAsBhB;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,cAAc,CAEhB;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACvD,IAAI,EAAE,CAAC,EAAE,EACT,WAAW,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAClE,CAAC,CAAC,GAAG;IAAE,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAAE,CAUnC"}

package/dist/integrity.js

@@ -0,0 +1,52 @@
+/** Data-integrity landmines that must be encoded now (PLAN.md Phase 2). */
+export const IMPRESSIONS_BUG_BEGIN = "2025-05-13";
+export const IMPRESSIONS_BUG_END = "2026-04-27";
+export const NUM100_BEGIN = "2025-09-10";
+export const NUM100_END = "2025-09-14";
+export const NUM100_STRADDLE = "2025-09-12";
+export const DEFAULT_METRIC = "clicks";
+export function rangesOverlap(aStart, aEnd, bStart, bEnd) {
+    return aStart <= bEnd && bStart <= aEnd;
+}
+export function impressionsContaminated(startDate, endDate) {
+    return rangesOverlap(startDate, endDate, IMPRESSIONS_BUG_BEGIN, IMPRESSIONS_BUG_END);
+}
+export function num100Straddle(startDate, endDate) {
+    return startDate <= NUM100_STRADDLE && endDate >= NUM100_STRADDLE;
+}
+/**
+ * Default every metric to clicks. Impressions/CTR/position are blocked across
+ * the logging-error window and across the &num=100 removal.
+ */
+export function decideMetric(requested, startDate, endDate) {
+    const reasons = [];
+    if (requested === "clicks") {
+        return { metric: "clicks", allowed: true, reasons };
+    }
+    if (impressionsContaminated(startDate, endDate)) {
+        reasons.push(`Impressions logging error ${IMPRESSIONS_BUG_BEGIN} → ${IMPRESSIONS_BUG_END} overlaps this window. Clicks are unaffected; impressions, CTR and average position are not.`);
+    }
+    if ((requested === "impressions" || requested === "position") &&
+        num100Straddle(startDate, endDate)) {
+        reasons.push(`&num=100 removal ${NUM100_BEGIN} → ${NUM100_END} straddles this window. Naive year-over-year impression comparison is a false decay alert.`);
+    }
+    if (reasons.length > 0) {
+        return { metric: "clicks", allowed: false, reasons };
+    }
+    return { metric: requested, allowed: true, reasons };
+}
+export function preferredMetric(requested, startDate, endDate) {
+    return decideMetric(requested ?? DEFAULT_METRIC, startDate, endDate);
+}
+export function annotateSeries(rows, overlapping) {
+    return rows.map((row) => {
+        const annotations = overlapping
+            .filter((c) => {
+            const e = c.end ?? c.begin;
+            return c.begin <= row.date && row.date <= e;
+        })
+            .map((c) => c.title);
+        return { ...row, annotations };
+    });
+}
+//# sourceMappingURL=integrity.js.map

package/dist/integrity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.js","sourceRoot":"","sources":["../src/integrity.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAClD,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAChD,MAAM,CAAC,MAAM,YAAY,GAAG,YAAY,CAAC;AACzC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAI5C,MAAM,CAAC,MAAM,cAAc,GAAc,QAAQ,CAAC;AAElD,MAAM,UAAU,aAAa,CAC3B,MAAc,EACd,IAAY,EACZ,MAAc,EACd,IAAY;IAEZ,OAAO,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAAiB,EAAE,OAAe;IACxE,OAAO,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAe;IAC/D,OAAO,SAAS,IAAI,eAAe,IAAI,OAAO,IAAI,eAAe,CAAC;AACpE,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAoB,EACpB,SAAiB,EACjB,OAAe;IAEf,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACtD,CAAC;IACD,IAAI,uBAAuB,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,CACV,6BAA6B,qBAAqB,MAAM,mBAAmB,8FAA8F,CAC1K,CAAC;IACJ,CAAC;IACD,IACE,CAAC,SAAS,KAAK,aAAa,IAAI,SAAS,KAAK,UAAU,CAAC;QACzD,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,EAClC,CAAC;QACD,OAAO,CAAC,IAAI,CACV,oBAAoB,YAAY,MAAM,UAAU,4FAA4F,CAC7I,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAAgC,EAChC,SAAiB,EACjB,OAAe;IAEf,OAAO,YAAY,CAAC,SAAS,IAAI,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAS,EACT,WAAmE;IAEnE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,WAAW;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACZ,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC;YAC3B,OAAO,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;QAC9C,CAAC,CAAC;aACD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACvB,OAAO,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/oauth-broker.d.ts

@@ -0,0 +1,38 @@
+import type { PendingOauth, PendingStore } from "./pending.js";
+import { type StoredGoogleGrant } from "./tokens.js";
+/**
+ * Local origin POSTs (or navigates) to the hosted broker. The hosted page never
+ * talks to the daemon — Chrome 142+ Local Network Access would prompt and break.
+ * Tokens come back on a 302 to http://127.0.0.1:<port>/oauth/callback.
+ */
+export declare function startBrokerAuthorization(opts: {
+    brokerUrl: string;
+    redirectUri: string;
+    pending: PendingStore;
+    siteId?: string | null | undefined;
+    scopes?: readonly string[] | undefined;
+}): {
+    authorizationUrl: string;
+    state: string;
+    wrapKeyB64: string;
+};
+export type BrokerHandoff = {
+    access_token: string;
+    refresh_token?: string | undefined;
+    expires_in?: number | undefined;
+    scope?: string | undefined;
+    token_type?: string | undefined;
+    refresh_token_expires_in?: number | undefined;
+    email?: string | undefined;
+    sub?: string | undefined;
+};
+export declare function openBrokerHandoff(pending: PendingOauth, payload: string): BrokerHandoff;
+export declare function grantFromBrokerHandoff(pending: PendingOauth, payload: string, prev: StoredGoogleGrant | null): StoredGoogleGrant;
+export declare function brokerRefreshAccessToken(brokerUrl: string, refreshToken: string, wrapKey: Buffer, fetchFn: typeof fetch): Promise<{
+    access_token: string;
+    expires_in?: number | undefined;
+    refresh_token?: string | undefined;
+    refresh_token_expires_in?: number | undefined;
+    scope?: string | undefined;
+}>;
+//# sourceMappingURL=oauth-broker.d.ts.map

package/dist/oauth-broker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-broker.d.ts","sourceRoot":"","sources":["../src/oauth-broker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAA0B,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG7E;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACxC,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CA2BlE;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GACd,aAAa,CAYf;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAC7B,iBAAiB,CAOnB;AAED,wBAAsB,wBAAwB,CAC5C,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,KAAK,GACpB,OAAO,CAAC;IACT,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,wBAAwB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC,CAkBD"}

package/dist/oauth-broker.js

@@ -0,0 +1,81 @@
+import { CONNECT_SCOPES } from "./scopes.js";
+import { randomState, randomWrapKey } from "./pkce.js";
+import { unseal } from "./seal.js";
+import { grantFromTokenResponse } from "./tokens.js";
+import { GscTokenError } from "./errors.js";
+/**
+ * Local origin POSTs (or navigates) to the hosted broker. The hosted page never
+ * talks to the daemon — Chrome 142+ Local Network Access would prompt and break.
+ * Tokens come back on a 302 to http://127.0.0.1:<port>/oauth/callback.
+ */
+export function startBrokerAuthorization(opts) {
+    const state = randomState();
+    const wrap = randomWrapKey();
+    const wrapKeyB64 = wrap.toString("base64url");
+    const row = {
+        state,
+        verifier: null,
+        wrapKeyB64,
+        mode: "broker",
+        createdAt: Date.now(),
+        siteId: opts.siteId ?? null,
+        redirectUri: opts.redirectUri,
+        clientId: null,
+    };
+    opts.pending.set(row);
+    const params = new URLSearchParams({
+        redirect_uri: opts.redirectUri,
+        state,
+        wrap_key: wrapKeyB64,
+        scope: (opts.scopes ?? CONNECT_SCOPES).join(" "),
+    });
+    const base = opts.brokerUrl.replace(/\/$/, "");
+    return {
+        state,
+        wrapKeyB64,
+        authorizationUrl: `${base}/google/start?${params.toString()}`,
+    };
+}
+export function openBrokerHandoff(pending, payload) {
+    const key = Buffer.from(pending.wrapKeyB64, "base64url");
+    let parsed;
+    try {
+        parsed = JSON.parse(unseal(key, payload));
+    }
+    catch (err) {
+        throw new GscTokenError("Could not unseal broker handoff.", err);
+    }
+    if (!parsed.access_token) {
+        throw new GscTokenError("Broker handoff missing access_token.");
+    }
+    return parsed;
+}
+export function grantFromBrokerHandoff(pending, payload, prev) {
+    const handoff = openBrokerHandoff(pending, payload);
+    return grantFromTokenResponse(handoff, prev, {
+        mode: "broker",
+        email: handoff.email ?? null,
+        googleSub: handoff.sub ?? null,
+    });
+}
+export async function brokerRefreshAccessToken(brokerUrl, refreshToken, wrapKey, fetchFn) {
+    const res = await fetchFn(`${brokerUrl.replace(/\/$/, "")}/google/refresh`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            refresh_token: refreshToken,
+            wrap_key: wrapKey.toString("base64url"),
+        }),
+    });
+    if (!res.ok) {
+        throw new GscTokenError(`Broker refresh failed (${res.status}).`);
+    }
+    const json = (await res.json());
+    if (!json.payload)
+        throw new GscTokenError("Broker refresh missing payload.");
+    const opened = JSON.parse(unseal(wrapKey, json.payload));
+    if (!opened.access_token)
+        throw new GscTokenError("Broker refresh missing access_token.");
+    return opened;
+}
+//# sourceMappingURL=oauth-broker.js.map

package/dist/oauth-broker.js.map

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

package/dist/oauth-config.d.ts

@@ -0,0 +1,16 @@
+import type { ByoClient } from "./tokens.js";
+export type GoogleOAuthConfig = {
+    mode: "broker" | "byo";
+    brokerUrl: string;
+    byo: ByoClient | null;
+    apiKey: string | null;
+};
+export declare function resolveOAuthConfig(env?: NodeJS.ProcessEnv): {
+    byo: ByoClient | null;
+    brokerUrl: string;
+    apiKey: string | null;
+};
+export declare function parseDesktopClientJson(raw: string): ByoClient;
+/** RFC 8252: IP literal, not localhost. Desktop clients accept any port. */
+export declare function loopbackRedirectUri(port: number): string;
+//# sourceMappingURL=oauth-config.d.ts.map

package/dist/oauth-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-config.d.ts","sourceRoot":"","sources":["../src/oauth-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG;IACxE,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAYA;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAgB7D;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/oauth-config.js

@@ -0,0 +1,24 @@
+import { DEFAULT_BROKER_URL } from "./scopes.js";
+export function resolveOAuthConfig(env = process.env) {
+    const clientId = env["GOOGLE_CLIENT_ID"]?.trim() || env["SEAN_GOOGLE_CLIENT_ID"]?.trim();
+    const clientSecret = env["GOOGLE_CLIENT_SECRET"]?.trim() || env["SEAN_GOOGLE_CLIENT_SECRET"]?.trim();
+    const byo = clientId && clientSecret ? { clientId, clientSecret } : null;
+    const brokerUrl = (env["SEAN_OAUTH_BROKER_URL"]?.trim() || DEFAULT_BROKER_URL).replace(/\/$/, "");
+    const apiKey = env["GOOGLE_API_KEY"]?.trim() || env["SEAN_GOOGLE_API_KEY"]?.trim() || null;
+    return { byo, brokerUrl, apiKey };
+}
+export function parseDesktopClientJson(raw) {
+    const parsed = JSON.parse(raw);
+    const installed = parsed.installed ?? parsed.web;
+    const clientId = parsed.client_id ?? installed?.client_id;
+    const clientSecret = parsed.client_secret ?? installed?.client_secret;
+    if (!clientId || !clientSecret) {
+        throw new Error("client_secret.json is missing client_id/client_secret. Create a Desktop app OAuth client.");
+    }
+    return { clientId, clientSecret };
+}
+/** RFC 8252: IP literal, not localhost. Desktop clients accept any port. */
+export function loopbackRedirectUri(port) {
+    return `http://127.0.0.1:${port}/oauth/callback`;
+}
+//# sourceMappingURL=oauth-config.js.map