@rawdash/connector-google-search-console 0.16.0

package/README.md

@@ -0,0 +1,117 @@
+<!-- This file is generated from connector metadata by scripts/generate-connector-docs.ts. Do not edit by hand. -->
+
+# @rawdash/connector-google-search-console
+
+[![npm version](https://img.shields.io/npm/v/@rawdash/connector-google-search-console)](https://www.npmjs.com/package/@rawdash/connector-google-search-console)
+[![license](https://img.shields.io/npm/l/@rawdash/connector-google-search-console)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
+
+Sync daily Search Console SEO metrics - clicks, impressions, CTR, and average position - by date, query, page, and country.
+
+## Install
+
+```sh
+npm install @rawdash/connector-google-search-console
+```
+
+## Authentication
+
+Authenticate against the Search Console API with either a Google service account JSON key (recommended) or an OAuth 2.0 refresh-token tuple. The identity must be added as a user on the Search Console property (Owner or Full user).
+
+1. Identify the property to sync. URL-prefix properties use the full origin (e.g. https://example.com/); Domain properties use the sc-domain:example.com format.
+2. Recommended: create a service account at Google Cloud -> IAM & Admin -> Service Accounts, generate a JSON key, then in Search Console add the service account email as a user on the property. Store the JSON as a secret and reference it as serviceAccountJson: secret("GSC_SERVICE_ACCOUNT_JSON").
+3. Alternative: provide an OAuth 2.0 refresh token with the webmasters.readonly scope together with its clientId and clientSecret from the Google Cloud Console.
+
+## Configuration
+
+| Field                | Type   | Required | Description                                                                                                                                                                                                  |
+| -------------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `siteUrl`            | string | Yes      | Verified Search Console property. URL-prefix properties look like "https://example.com/"; Domain properties look like "sc-domain:example.com".                                                               |
+| `serviceAccountJson` | secret | No       | Contents of the JSON key file for a Google service account that has been added as a Search Console user (Owner or Full user) on the property. Create one at Google Cloud -> IAM & Admin -> Service Accounts. |
+| `refreshToken`       | secret | No       | Google OAuth 2.0 refresh token with webmasters.readonly scope. Required if not using serviceAccountJson.                                                                                                     |
+| `clientId`           | string | No       | OAuth 2.0 client ID from Google Cloud Console. Required when using refreshToken auth.                                                                                                                        |
+| `clientSecret`       | secret | No       | OAuth 2.0 client secret from Google Cloud Console. Required when using refreshToken auth.                                                                                                                    |
+| `lookbackDays`       | number | No       | How many calendar days to fetch on a full sync. Defaults to 90.                                                                                                                                              |
+
+## Resources
+
+- **`gsc_search_analytics_by_day`** _(metric)_ - Daily site totals - clicks, impressions, CTR, and average position across all queries and pages.
+  - Endpoint: `POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query`
+  - Unit: clicks
+  - Granularity: day
+  - Dimensions: `date`
+- **`gsc_top_queries`** _(metric)_ - Daily clicks, impressions, CTR, and average position broken down by search query.
+  - Endpoint: `POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query`
+  - Unit: clicks
+  - Granularity: day
+  - Dimensions: `date`, `query`
+- **`gsc_top_pages`** _(metric)_ - Daily clicks, impressions, CTR, and average position broken down by landing page URL.
+  - Endpoint: `POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query`
+  - Unit: clicks
+  - Granularity: day
+  - Dimensions: `date`, `page`
+- **`gsc_top_countries`** _(metric)_ - Daily clicks, impressions, CTR, and average position broken down by visitor country.
+  - Endpoint: `POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query`
+  - Unit: clicks
+  - Granularity: day
+  - Dimensions: `date`, `country`
+
+## Example
+
+```ts
+import {
+  defineConfig,
+  defineDashboard,
+  defineMetric,
+  secret,
+} from '@rawdash/core';
+
+const googleSearchConsole = {
+  name: 'googleSearchConsole',
+  connectorId: 'google-search-console',
+  config: {
+    siteUrl: 'https://example.com/',
+    serviceAccountJson: secret('GSC_SERVICE_ACCOUNT_JSON'),
+    lookbackDays: 90,
+  },
+};
+
+export default defineConfig({
+  connectors: [googleSearchConsole],
+  dashboards: {
+    seo: defineDashboard({
+      widgets: {
+        clicks: {
+          kind: 'timeseries',
+          title: 'Daily search clicks',
+          window: '30d',
+          metric: defineMetric({
+            connector: googleSearchConsole,
+            shape: 'metric',
+            name: 'gsc_search_analytics_by_day',
+            fn: 'sum',
+          }),
+        },
+      },
+    }),
+  },
+});
+```
+
+## Rate limits
+
+Search Console API quota is 1,200 queries per minute per project (default); 429 responses are retried automatically with exponential backoff.
+
+## Limitations
+
+- Search Console aggregates data with a 2-3 day lag, so incremental syncs refetch the trailing 3 days.
+- Each query is paginated 25,000 rows per page; a phase that yields more than that paginates by startRow.
+
+## Links
+
+- [Rawdash docs](https://rawdash.dev/docs/connectors/)
+- [Google Search Console API docs](https://developers.google.com/webmaster-tools/v1/api_reference_index)
+- [GitHub](https://github.com/rawdash/rawdash)
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,232 @@
+import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, ConnectorDoc } from '@rawdash/core';
+import { z } from 'zod';
+
+declare const configFields: z.ZodObject<{
+    siteUrl: z.ZodString;
+    serviceAccountJson: z.ZodOptional<z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>>;
+    refreshToken: z.ZodOptional<z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>>;
+    clientId: z.ZodOptional<z.ZodString>;
+    clientSecret: z.ZodOptional<z.ZodObject<{
+        $secret: z.ZodString;
+    }, z.core.$strip>>;
+    lookbackDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const doc: ConnectorDoc;
+interface GSCSettings {
+    siteUrl: string;
+    lookbackDays?: number;
+}
+declare const gscCredentials: {
+    serviceAccountJson: {
+        description: string;
+        auth: "optional";
+    };
+    refreshToken: {
+        description: string;
+        auth: "optional";
+    };
+    clientId: {
+        description: string;
+        auth: "optional";
+    };
+    clientSecret: {
+        description: string;
+        auth: "optional";
+    };
+};
+type GSCCredentials = typeof gscCredentials;
+interface GSCReportRow {
+    keys?: string[];
+    clicks?: number;
+    impressions?: number;
+    ctr?: number;
+    position?: number;
+}
+declare function rowToMetricSample(row: GSCReportRow, dimensions: string[], metricName: string): {
+    name: string;
+    ts: number;
+    value: number;
+    attributes: Record<string, string | number>;
+};
+declare class GSCConnector extends BaseConnector<GSCSettings, GSCCredentials> {
+    static readonly id = "google-search-console";
+    static readonly resources: {
+        readonly gsc_search_analytics_by_day: {
+            readonly shape: "metric";
+            readonly description: "Daily site totals - clicks, impressions, CTR, and average position across all queries and pages.";
+            readonly unit: "clicks";
+            readonly granularity: "day";
+            readonly endpoint: "POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample.";
+            }];
+            readonly responses: {
+                readonly oauth_token: z.ZodObject<{
+                    access_token: z.ZodString;
+                    expires_in: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>;
+                readonly search_analytics_by_day: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        keys: z.ZodTuple<[z.ZodString, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        clicks: z.ZodOptional<z.ZodNumber>;
+                        impressions: z.ZodOptional<z.ZodNumber>;
+                        ctr: z.ZodOptional<z.ZodNumber>;
+                        position: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly gsc_top_queries: {
+            readonly shape: "metric";
+            readonly description: "Daily clicks, impressions, CTR, and average position broken down by search query.";
+            readonly unit: "clicks";
+            readonly granularity: "day";
+            readonly endpoint: "POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample.";
+            }, {
+                readonly name: "query";
+                readonly description: "Search term that surfaced a result for the property.";
+            }];
+            readonly responses: {
+                readonly top_queries: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        keys: z.ZodTuple<[z.ZodString, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        clicks: z.ZodOptional<z.ZodNumber>;
+                        impressions: z.ZodOptional<z.ZodNumber>;
+                        ctr: z.ZodOptional<z.ZodNumber>;
+                        position: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly gsc_top_pages: {
+            readonly shape: "metric";
+            readonly description: "Daily clicks, impressions, CTR, and average position broken down by landing page URL.";
+            readonly unit: "clicks";
+            readonly granularity: "day";
+            readonly endpoint: "POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample.";
+            }, {
+                readonly name: "page";
+                readonly description: "Canonical URL of the page that surfaced in search.";
+            }];
+            readonly responses: {
+                readonly top_pages: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        keys: z.ZodTuple<[z.ZodString, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        clicks: z.ZodOptional<z.ZodNumber>;
+                        impressions: z.ZodOptional<z.ZodNumber>;
+                        ctr: z.ZodOptional<z.ZodNumber>;
+                        position: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly gsc_top_countries: {
+            readonly shape: "metric";
+            readonly description: "Daily clicks, impressions, CTR, and average position broken down by visitor country.";
+            readonly unit: "clicks";
+            readonly granularity: "day";
+            readonly endpoint: "POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample.";
+            }, {
+                readonly name: "country";
+                readonly description: "ISO 3166-1 alpha-3 country code of the searcher.";
+            }];
+            readonly responses: {
+                readonly top_countries: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        keys: z.ZodTuple<[z.ZodString, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        clicks: z.ZodOptional<z.ZodNumber>;
+                        impressions: z.ZodOptional<z.ZodNumber>;
+                        ctr: z.ZodOptional<z.ZodNumber>;
+                        position: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+    };
+    static readonly schemas: {
+        readonly oauth_token: z.ZodObject<{
+            access_token: z.ZodString;
+            expires_in: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        readonly search_analytics_by_day: z.ZodObject<{
+            rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                keys: z.ZodTuple<[z.ZodString, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                clicks: z.ZodOptional<z.ZodNumber>;
+                impressions: z.ZodOptional<z.ZodNumber>;
+                ctr: z.ZodOptional<z.ZodNumber>;
+                position: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & {
+        readonly top_queries: z.ZodObject<{
+            rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                keys: z.ZodTuple<[z.ZodString, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                clicks: z.ZodOptional<z.ZodNumber>;
+                impressions: z.ZodOptional<z.ZodNumber>;
+                ctr: z.ZodOptional<z.ZodNumber>;
+                position: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & {
+        readonly top_pages: z.ZodObject<{
+            rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                keys: z.ZodTuple<[z.ZodString, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                clicks: z.ZodOptional<z.ZodNumber>;
+                impressions: z.ZodOptional<z.ZodNumber>;
+                ctr: z.ZodOptional<z.ZodNumber>;
+                position: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & {
+        readonly top_countries: z.ZodObject<{
+            rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                keys: z.ZodTuple<[z.ZodString, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                clicks: z.ZodOptional<z.ZodNumber>;
+                impressions: z.ZodOptional<z.ZodNumber>;
+                ctr: z.ZodOptional<z.ZodNumber>;
+                position: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    } & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
+    static create(input: unknown, ctx?: ConnectorContext): GSCConnector;
+    readonly id = "google-search-console";
+    readonly credentials: {
+        serviceAccountJson: {
+            description: string;
+            auth: "optional";
+        };
+        refreshToken: {
+            description: string;
+            auth: "optional";
+        };
+        clientId: {
+            description: string;
+            auth: "optional";
+        };
+        clientSecret: {
+            description: string;
+            auth: "optional";
+        };
+    };
+    private cachedToken;
+    private fetchOAuthToken;
+    private getAccessToken;
+    private runReport;
+    sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
+}
+
+export { GSCConnector, type GSCSettings, configFields, GSCConnector as default, doc, rowToMetricSample };

package/dist/index.js

@@ -0,0 +1,509 @@
+// ../../connector-shared/dist/index.js
+var HTTP_CLIENT_VERSION = "0.0.0";
+var DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+function connectorUserAgent(connectorId) {
+  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;
+}
+
+// src/google-search-console.ts
+import {
+  BaseConnector,
+  defineConfigFields,
+  defineConnectorDoc,
+  defineResources,
+  schemasFromResources
+} from "@rawdash/core";
+import { z } from "zod";
+var configFields = defineConfigFields(
+  z.object({
+    siteUrl: z.string().trim().min(1).meta({
+      label: "Site URL",
+      description: 'Verified Search Console property. URL-prefix properties look like "https://example.com/"; Domain properties look like "sc-domain:example.com".',
+      placeholder: "https://example.com/"
+    }),
+    serviceAccountJson: z.object({ $secret: z.string().trim().min(1) }).optional().meta({
+      label: "Service Account JSON (recommended)",
+      description: "Contents of the JSON key file for a Google service account that has been added as a Search Console user (Owner or Full user) on the property. Create one at Google Cloud -> IAM & Admin -> Service Accounts.",
+      secret: true
+    }),
+    refreshToken: z.object({ $secret: z.string().trim().min(1) }).optional().meta({
+      label: "OAuth Refresh Token",
+      description: "Google OAuth 2.0 refresh token with webmasters.readonly scope. Required if not using serviceAccountJson.",
+      secret: true
+    }),
+    clientId: z.string().trim().min(1).optional().meta({
+      label: "OAuth Client ID",
+      description: "OAuth 2.0 client ID from Google Cloud Console. Required when using refreshToken auth.",
+      placeholder: "...apps.googleusercontent.com"
+    }),
+    clientSecret: z.object({ $secret: z.string().trim().min(1) }).optional().meta({
+      label: "OAuth Client Secret",
+      description: "OAuth 2.0 client secret from Google Cloud Console. Required when using refreshToken auth.",
+      secret: true
+    }),
+    lookbackDays: z.number().int().positive().optional().meta({
+      label: "Lookback days (full sync)",
+      description: "How many calendar days to fetch on a full sync. Defaults to 90.",
+      placeholder: "90"
+    })
+  }).refine(
+    (val) => val.serviceAccountJson !== void 0 || val.refreshToken !== void 0 && val.clientId !== void 0 && val.clientSecret !== void 0,
+    {
+      message: "Provide either serviceAccountJson or the full OAuth tuple (refreshToken + clientId + clientSecret)"
+    }
+  )
+);
+var doc = defineConnectorDoc({
+  displayName: "Google Search Console",
+  category: "marketing",
+  brandColor: "#458CF5",
+  tagline: "Sync daily Search Console SEO metrics - clicks, impressions, CTR, and average position - by date, query, page, and country.",
+  vendor: {
+    name: "Google Search Console",
+    apiDocs: "https://developers.google.com/webmaster-tools/v1/api_reference_index",
+    website: "https://search.google.com/search-console"
+  },
+  auth: {
+    summary: "Authenticate against the Search Console API with either a Google service account JSON key (recommended) or an OAuth 2.0 refresh-token tuple. The identity must be added as a user on the Search Console property (Owner or Full user).",
+    setup: [
+      "Identify the property to sync. URL-prefix properties use the full origin (e.g. https://example.com/); Domain properties use the sc-domain:example.com format.",
+      'Recommended: create a service account at Google Cloud -> IAM & Admin -> Service Accounts, generate a JSON key, then in Search Console add the service account email as a user on the property. Store the JSON as a secret and reference it as serviceAccountJson: secret("GSC_SERVICE_ACCOUNT_JSON").',
+      "Alternative: provide an OAuth 2.0 refresh token with the webmasters.readonly scope together with its clientId and clientSecret from the Google Cloud Console."
+    ]
+  },
+  rateLimit: "Search Console API quota is 1,200 queries per minute per project (default); 429 responses are retried automatically with exponential backoff.",
+  limitations: [
+    "Search Console aggregates data with a 2-3 day lag, so incremental syncs refetch the trailing 3 days.",
+    "Each query is paginated 25,000 rows per page; a phase that yields more than that paginates by startRow."
+  ]
+});
+var gscCredentials = {
+  serviceAccountJson: {
+    description: "Google service account JSON key (base64 or raw JSON)",
+    auth: "optional"
+  },
+  refreshToken: {
+    description: "Google OAuth 2.0 refresh token",
+    auth: "optional"
+  },
+  clientId: {
+    description: "Google OAuth 2.0 client ID",
+    auth: "optional"
+  },
+  clientSecret: {
+    description: "Google OAuth 2.0 client secret",
+    auth: "optional"
+  }
+};
+var PHASE_ORDER = [
+  "search_analytics_by_day",
+  "top_queries",
+  "top_pages",
+  "top_countries"
+];
+var GSC_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function isGSCDateString(value) {
+  return typeof value === "string" && GSC_DATE_RE.test(value);
+}
+function isGSCDateRange(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const v = value;
+  return isGSCDateString(v.startDate) && isGSCDateString(v.endDate);
+}
+function isGSCSyncCursor(value) {
+  if (typeof value !== "object" || value === null) {
+    return false;
+  }
+  const v = value;
+  if (typeof v.phase !== "string") {
+    return false;
+  }
+  if (!PHASE_ORDER.includes(v.phase)) {
+    return false;
+  }
+  return isGSCDateRange(v.dateRange);
+}
+var PHASE_CONFIGS = {
+  search_analytics_by_day: {
+    dimensions: ["date"],
+    metricName: "gsc_search_analytics_by_day"
+  },
+  top_queries: {
+    dimensions: ["date", "query"],
+    metricName: "gsc_top_queries"
+  },
+  top_pages: {
+    dimensions: ["date", "page"],
+    metricName: "gsc_top_pages"
+  },
+  top_countries: {
+    dimensions: ["date", "country"],
+    metricName: "gsc_top_countries"
+  }
+};
+var ROWS_PER_PAGE = 25e3;
+var METRIC_FIELDS = ["clicks", "impressions", "ctr", "position"];
+function base64urlFromBytes(bytes) {
+  let binary = "";
+  for (let i = 0; i < bytes.length; i++) {
+    binary += String.fromCharCode(bytes[i]);
+  }
+  return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+function base64urlFromString(str) {
+  return base64urlFromBytes(new TextEncoder().encode(str));
+}
+async function signRS256JWT(payload, privateKeyPem) {
+  const header = { alg: "RS256", typ: "JWT" };
+  const headerB64 = base64urlFromString(JSON.stringify(header));
+  const payloadB64 = base64urlFromString(JSON.stringify(payload));
+  const signingInput = `${headerB64}.${payloadB64}`;
+  const pemContent = privateKeyPem.replace(/-----BEGIN PRIVATE KEY-----/g, "").replace(/-----END PRIVATE KEY-----/g, "").replace(/\s/g, "");
+  const der = Uint8Array.from(atob(pemContent), (c) => c.charCodeAt(0));
+  const key = await globalThis.crypto.subtle.importKey(
+    "pkcs8",
+    der,
+    { name: "RSASSA-PKCS1-v1_5", hash: "SHA-256" },
+    false,
+    ["sign"]
+  );
+  const signature = await globalThis.crypto.subtle.sign(
+    "RSASSA-PKCS1-v1_5",
+    key,
+    new TextEncoder().encode(signingInput)
+  );
+  return `${signingInput}.${base64urlFromBytes(new Uint8Array(signature))}`;
+}
+function parseServiceAccountJson(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith("{")) {
+    return JSON.parse(trimmed);
+  }
+  const binary = atob(trimmed);
+  const bytes = new Uint8Array(binary.length);
+  for (let i = 0; i < binary.length; i++) {
+    bytes[i] = binary.charCodeAt(i);
+  }
+  const decoded = new TextDecoder().decode(bytes);
+  return JSON.parse(decoded);
+}
+async function buildServiceAccountJwt(serviceAccountJson) {
+  const sa = parseServiceAccountJson(serviceAccountJson);
+  const now = Math.floor(Date.now() / 1e3);
+  const jwt = await signRS256JWT(
+    {
+      iss: sa.client_email,
+      scope: "https://www.googleapis.com/auth/webmasters.readonly",
+      aud: sa.token_uri ?? "https://oauth2.googleapis.com/token",
+      exp: now + 3600,
+      iat: now
+    },
+    sa.private_key
+  );
+  const body = new URLSearchParams({
+    grant_type: "urn:ietf:params:oauth:grant-type:jwt-bearer",
+    assertion: jwt
+  }).toString();
+  return {
+    url: sa.token_uri ?? "https://oauth2.googleapis.com/token",
+    body
+  };
+}
+function toGSCDate(date) {
+  const y = date.getUTCFullYear();
+  const m = String(date.getUTCMonth() + 1).padStart(2, "0");
+  const d = String(date.getUTCDate()).padStart(2, "0");
+  return `${y}-${m}-${d}`;
+}
+function gscDateToMs(gscDate) {
+  const y = gscDate.slice(0, 4);
+  const m = gscDate.slice(5, 7);
+  const d = gscDate.slice(8, 10);
+  return Date.UTC(Number(y), Number(m) - 1, Number(d));
+}
+var MS_PER_DAY = 24 * 60 * 60 * 1e3;
+var INCREMENTAL_LOOKBACK_DAYS = 3;
+function getDateRange(options, lookbackDays) {
+  const now = Date.now();
+  const endDate = toGSCDate(new Date(now));
+  if (options.mode === "latest") {
+    const startMs2 = now - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY;
+    return { startDate: toGSCDate(new Date(startMs2)), endDate };
+  }
+  if (options.since) {
+    const sinceMs = new Date(options.since).getTime();
+    if (Number.isFinite(sinceMs)) {
+      const days = Math.max(1, Math.ceil((now - sinceMs) / MS_PER_DAY));
+      const cappedDays = Math.min(days, lookbackDays);
+      const startMs2 = now - (cappedDays - 1) * MS_PER_DAY;
+      return { startDate: toGSCDate(new Date(startMs2)), endDate };
+    }
+  }
+  const startMs = now - (lookbackDays - 1) * MS_PER_DAY;
+  return { startDate: toGSCDate(new Date(startMs)), endDate };
+}
+function rowToMetricSample(row, dimensions, metricName) {
+  const attributes = {};
+  const keys = row.keys ?? [];
+  for (let i = 0; i < dimensions.length; i++) {
+    attributes[dimensions[i]] = keys[i] ?? "";
+  }
+  for (const field of METRIC_FIELDS) {
+    const raw = row[field];
+    attributes[field] = typeof raw === "number" && Number.isFinite(raw) ? raw : 0;
+  }
+  const dateStr = typeof attributes["date"] === "string" ? attributes["date"] : "1970-01-01";
+  const ts = gscDateToMs(dateStr);
+  const primaryValue = attributes["clicks"];
+  return {
+    name: metricName,
+    ts,
+    value: primaryValue,
+    attributes
+  };
+}
+var dateKey = z.string().regex(/^(19|20)\d{2}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$/);
+var stringKey = z.string();
+var numericField = z.number();
+function reportSchema(dimensionCount) {
+  const keys = dimensionCount === 1 ? z.tuple([dateKey]) : z.tuple([dateKey, ...Array(dimensionCount - 1).fill(stringKey)]);
+  return z.object({
+    rows: z.array(
+      z.object({
+        keys,
+        clicks: numericField.optional(),
+        impressions: numericField.optional(),
+        ctr: numericField.optional(),
+        position: numericField.optional()
+      })
+    ).optional()
+  });
+}
+var tokenResponseSchema = z.object({
+  access_token: z.string().min(1),
+  expires_in: z.number().int().positive().optional()
+});
+var googleSearchConsoleResources = defineResources({
+  gsc_search_analytics_by_day: {
+    shape: "metric",
+    description: "Daily site totals - clicks, impressions, CTR, and average position across all queries and pages.",
+    unit: "clicks",
+    granularity: "day",
+    endpoint: "POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." }
+    ],
+    responses: {
+      oauth_token: tokenResponseSchema,
+      search_analytics_by_day: reportSchema(1)
+    }
+  },
+  gsc_top_queries: {
+    shape: "metric",
+    description: "Daily clicks, impressions, CTR, and average position broken down by search query.",
+    unit: "clicks",
+    granularity: "day",
+    endpoint: "POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." },
+      {
+        name: "query",
+        description: "Search term that surfaced a result for the property."
+      }
+    ],
+    responses: { top_queries: reportSchema(2) }
+  },
+  gsc_top_pages: {
+    shape: "metric",
+    description: "Daily clicks, impressions, CTR, and average position broken down by landing page URL.",
+    unit: "clicks",
+    granularity: "day",
+    endpoint: "POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." },
+      {
+        name: "page",
+        description: "Canonical URL of the page that surfaced in search."
+      }
+    ],
+    responses: { top_pages: reportSchema(2) }
+  },
+  gsc_top_countries: {
+    shape: "metric",
+    description: "Daily clicks, impressions, CTR, and average position broken down by visitor country.",
+    unit: "clicks",
+    granularity: "day",
+    endpoint: "POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." },
+      {
+        name: "country",
+        description: "ISO 3166-1 alpha-3 country code of the searcher."
+      }
+    ],
+    responses: { top_countries: reportSchema(2) }
+  }
+});
+var GSCConnector = class _GSCConnector extends BaseConnector {
+  static id = "google-search-console";
+  static resources = googleSearchConsoleResources;
+  static schemas = schemasFromResources(googleSearchConsoleResources);
+  static create(input, ctx) {
+    const parsed = configFields.parse(input);
+    return new _GSCConnector(
+      {
+        siteUrl: parsed.siteUrl,
+        lookbackDays: parsed.lookbackDays
+      },
+      {
+        serviceAccountJson: parsed.serviceAccountJson,
+        refreshToken: parsed.refreshToken,
+        clientId: parsed.clientId,
+        clientSecret: parsed.clientSecret
+      },
+      ctx
+    );
+  }
+  id = "google-search-console";
+  credentials = gscCredentials;
+  cachedToken = null;
+  async fetchOAuthToken(url, body, signal) {
+    const res = await this.post(url, {
+      resource: "oauth_token",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body,
+      signal
+    });
+    const expiresIn = res.body.expires_in ?? 3600;
+    return {
+      token: res.body.access_token,
+      expiresAt: Date.now() + (expiresIn - 60) * 1e3
+    };
+  }
+  async getAccessToken(signal) {
+    if (this.cachedToken && Date.now() < this.cachedToken.expiresAt) {
+      return this.cachedToken.token;
+    }
+    const { serviceAccountJson, refreshToken, clientId, clientSecret } = this.creds;
+    if (serviceAccountJson) {
+      const { url, body } = await buildServiceAccountJwt(serviceAccountJson);
+      this.cachedToken = await this.fetchOAuthToken(url, body, signal);
+      return this.cachedToken.token;
+    }
+    if (refreshToken && clientId && clientSecret) {
+      const body = new URLSearchParams({
+        grant_type: "refresh_token",
+        refresh_token: refreshToken,
+        client_id: clientId,
+        client_secret: clientSecret
+      }).toString();
+      this.cachedToken = await this.fetchOAuthToken(
+        "https://oauth2.googleapis.com/token",
+        body,
+        signal
+      );
+      return this.cachedToken.token;
+    }
+    throw new Error(
+      "GSC connector: provide either serviceAccountJson or (refreshToken + clientId + clientSecret)"
+    );
+  }
+  async runReport(accessToken, phase, dateRange, startRow, signal) {
+    const { dimensions } = PHASE_CONFIGS[phase];
+    const url = `https://searchconsole.googleapis.com/webmasters/v3/sites/${encodeURIComponent(this.settings.siteUrl)}/searchAnalytics/query`;
+    const body = {
+      startDate: dateRange.startDate,
+      endDate: dateRange.endDate,
+      dimensions,
+      rowLimit: ROWS_PER_PAGE,
+      startRow
+    };
+    const res = await this.post(url, {
+      resource: phase,
+      headers: {
+        Authorization: `Bearer ${accessToken}`,
+        "Content-Type": "application/json",
+        "User-Agent": connectorUserAgent("google-search-console")
+      },
+      body: JSON.stringify(body),
+      signal
+    });
+    return res.body;
+  }
+  async sync(options, storage, signal) {
+    const lookbackDays = this.settings.lookbackDays ?? 90;
+    const cursor = isGSCSyncCursor(options.cursor) ? options.cursor : void 0;
+    const dateRange = cursor?.dateRange ?? getDateRange(options, lookbackDays);
+    let accessToken = null;
+    const getToken = async (sig) => {
+      if (!accessToken) {
+        accessToken = await this.getAccessToken(sig);
+      }
+      return accessToken;
+    };
+    const runReportWithRetry = async (phase, startRow, sig) => {
+      const token = await getToken(sig);
+      try {
+        return await this.runReport(token, phase, dateRange, startRow, sig);
+      } catch (err) {
+        console.warn(
+          `[gsc] runReport failed, refreshing token and retrying once`,
+          err
+        );
+        accessToken = null;
+        const freshToken = await getToken(sig);
+        return this.runReport(freshToken, phase, dateRange, startRow, sig);
+      }
+    };
+    const drainPhase = async (phase) => {
+      const allRows = [];
+      let startRow = 0;
+      for (; ; ) {
+        const response = await runReportWithRetry(phase, startRow, signal);
+        const rows = response.rows ?? [];
+        allRows.push(...rows);
+        startRow += rows.length;
+        if (rows.length < ROWS_PER_PAGE) {
+          break;
+        }
+      }
+      return allRows;
+    };
+    const resumeIdx = cursor ? PHASE_ORDER.indexOf(cursor.phase) : -1;
+    const startIdx = resumeIdx >= 0 ? resumeIdx : 0;
+    for (let i = startIdx; i < PHASE_ORDER.length; i++) {
+      const phase = PHASE_ORDER[i];
+      if (signal?.aborted) {
+        return { done: false, cursor: { phase, dateRange } };
+      }
+      let rows;
+      try {
+        rows = await drainPhase(phase);
+      } catch (err) {
+        if (signal?.aborted) {
+          return { done: false, cursor: { phase, dateRange } };
+        }
+        throw err;
+      }
+      const cfg = PHASE_CONFIGS[phase];
+      const samples = rows.map(
+        (row) => rowToMetricSample(row, cfg.dimensions, cfg.metricName)
+      );
+      await storage.metrics(samples, { names: [cfg.metricName] });
+    }
+    return { done: true };
+  }
+};
+
+// src/index.ts
+var index_default = GSCConnector;
+export {
+  GSCConnector,
+  configFields,
+  index_default as default,
+  doc,
+  rowToMetricSample
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../connector-shared/src/errors.ts","../../../connector-shared/src/retry.ts","../../../connector-shared/src/version.ts","../../../connector-shared/src/request.ts","../../../connector-shared/src/rate-limit.ts","../../../connector-shared/src/sanitize.ts","../../../connector-shared/src/epoch.ts","../../../connector-shared/src/pagination.ts","../../../connector-shared/src/logger.ts","../src/google-search-console.ts","../src/index.ts"],"sourcesContent":["import type { HttpResponse } from './types';\n\nexport type HttpErrorKind =\n  | 'transient'\n  | 'rate_limit'\n  | 'auth'\n  | 'upstream_bug'\n  | 'client_bug';\n\nexport abstract class HttpClientError extends Error {\n  abstract readonly kind: HttpErrorKind;\n  readonly response?: HttpResponse;\n\n  constructor(message: string, response?: HttpResponse) {\n    super(message);\n    this.name = new.target.name;\n    this.response = response;\n  }\n}\n\nexport class TransientError extends HttpClientError {\n  readonly kind = 'transient' as const;\n}\n\nexport class RateLimitError extends HttpClientError {\n  readonly kind = 'rate_limit' as const;\n  readonly retryAfter?: Date;\n\n  constructor(message: string, response?: HttpResponse, retryAfter?: Date) {\n    super(message, response);\n    this.retryAfter = retryAfter;\n  }\n}\n\nexport class AuthError extends HttpClientError {\n  readonly kind = 'auth' as const;\n}\n\nexport class UpstreamBugError extends HttpClientError {\n  readonly kind = 'upstream_bug' as const;\n}\n\nexport class ClientBugError extends HttpClientError {\n  readonly kind = 'client_bug' as const;\n}\n\nexport function classifyStatus(status: number): HttpErrorKind {\n  if (status === 429) {\n    return 'rate_limit';\n  }\n  if (status === 401 || status === 403) {\n    return 'auth';\n  }\n  if (status === 408) {\n    return 'transient';\n  }\n  if (status >= 500) {\n    return 'upstream_bug';\n  }\n  if (status >= 400) {\n    return 'client_bug';\n  }\n  return 'client_bug';\n}\n\nexport function errorForStatus(\n  message: string,\n  response: HttpResponse,\n  retryAfter?: Date,\n): HttpClientError {\n  const kind = classifyStatus(response.status);\n  switch (kind) {\n    case 'rate_limit':\n      return new RateLimitError(message, response, retryAfter);\n    case 'auth':\n      return new AuthError(message, response);\n    case 'transient':\n      return new TransientError(message, response);\n    case 'upstream_bug':\n      return new UpstreamBugError(message, response);\n    case 'client_bug':\n      return new ClientBugError(message, response);\n  }\n}\n","import { HttpClientError, RateLimitError, TransientError } from './errors';\n\nexport interface RetryPolicy {\n  maxAttempts?: number;\n  initialDelayMs?: number;\n  maxDelayMs?: number;\n  retryOn?: (status: number | null, err?: Error) => boolean;\n}\n\nexport const defaultRetryOn = (status: number | null, err?: Error): boolean => {\n  if (err instanceof RateLimitError) {\n    return true;\n  }\n  if (err instanceof TransientError) {\n    return true;\n  }\n  if (status === null) {\n    return err instanceof Error && !(err instanceof HttpClientError);\n  }\n  if (status === 408 || status === 429) {\n    return true;\n  }\n  if (status >= 500) {\n    return true;\n  }\n  return false;\n};\n\nexport function backoffDelayMs(\n  attempt: number,\n  policy: Required<Pick<RetryPolicy, 'initialDelayMs' | 'maxDelayMs'>>,\n): number {\n  const base = policy.initialDelayMs * 2 ** attempt;\n  const jitter = base * 0.25 * Math.random();\n  return Math.min(base + jitter, policy.maxDelayMs);\n}\n\nexport function parseRetryAfter(\n  headerValue: string | null,\n  now: Date = new Date(),\n): Date | undefined {\n  if (!headerValue) {\n    return undefined;\n  }\n  const trimmed = headerValue.trim();\n  if (/^\\d+$/.test(trimmed)) {\n    return new Date(now.getTime() + Number(trimmed) * 1000);\n  }\n  const parsed = Date.parse(trimmed);\n  if (Number.isNaN(parsed)) {\n    return undefined;\n  }\n  return new Date(parsed);\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  if (signal?.aborted) {\n    return Promise.reject(signal.reason ?? new Error('Aborted'));\n  }\n  return new Promise<void>((resolve, reject) => {\n    const onAbort = () => {\n      clearTimeout(timer);\n      reject(signal!.reason ?? new Error('Aborted'));\n    };\n    const timer = setTimeout(() => {\n      signal?.removeEventListener('abort', onAbort);\n      resolve();\n    }, ms);\n    signal?.addEventListener('abort', onAbort, { once: true });\n  });\n}\n","export const HTTP_CLIENT_VERSION = '0.0.0';\n\nexport const DEFAULT_USER_AGENT = `rawdash-connector/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n\nexport function connectorUserAgent(connectorId: string): string {\n  return `rawdash-connector-${connectorId}/${HTTP_CLIENT_VERSION} (+https://rawdash.dev)`;\n}\n","import {\n  AuthError,\n  ClientBugError,\n  HttpClientError,\n  RateLimitError,\n  TransientError,\n  UpstreamBugError,\n  errorForStatus,\n} from './errors';\nimport { defaultRetryOn, parseRetryAfter, sleep } from './retry';\nimport type { FetchLike, HttpMethod, HttpRequest, HttpResponse } from './types';\nimport { DEFAULT_USER_AGENT } from './version';\n\nconst DEFAULT_TIMEOUT_MS = 10_000;\nconst DEFAULT_MAX_ATTEMPTS = 3;\nconst DEFAULT_INITIAL_DELAY_MS = 1000;\nconst DEFAULT_MAX_DELAY_MS = 60_000;\nconst OBSERVER_TIMEOUT_MS = 250;\n\nexport interface RequestObservation {\n  url: string;\n  method: HttpMethod;\n  status: number;\n  resource: string;\n  requestId: string;\n  body: unknown;\n}\n\nexport type RequestObserver = (\n  event: RequestObservation,\n) => void | Promise<void>;\n\nexport interface RequestOptions {\n  fetch?: FetchLike;\n  observer?: RequestObserver;\n  resource: string;\n  requestId?: string;\n}\n\nasync function notifyObserver(\n  observer: RequestObserver,\n  event: RequestObservation,\n): Promise<void> {\n  let result: void | Promise<void>;\n  try {\n    result = observer(event);\n  } catch (err) {\n    console.warn('[connector-shared] request observer threw:', err);\n    return;\n  }\n  if (!(result instanceof Promise)) {\n    return;\n  }\n  const guarded = result.catch((err) => {\n    console.warn('[connector-shared] request observer rejected:', err);\n  });\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const timeout = new Promise<void>((resolve) => {\n    timer = setTimeout(resolve, OBSERVER_TIMEOUT_MS);\n  });\n  try {\n    await Promise.race([guarded, timeout]);\n  } finally {\n    if (timer) {\n      clearTimeout(timer);\n    }\n  }\n}\n\nfunction newRequestId(): string {\n  const c = (globalThis as { crypto?: { randomUUID?: () => string } }).crypto;\n  if (c?.randomUUID) {\n    return c.randomUUID();\n  }\n  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;\n}\n\nfunction mergeHeaders(\n  defaults: Record<string, string>,\n  overrides: Record<string, string> | undefined,\n): Record<string, string> {\n  const merged: Record<string, string> = {};\n  for (const [k, v] of Object.entries(defaults)) {\n    merged[k.toLowerCase()] = v;\n  }\n  if (overrides) {\n    for (const [k, v] of Object.entries(overrides)) {\n      merged[k.toLowerCase()] = v;\n    }\n  }\n  return merged;\n}\n\nfunction linkTimeoutSignal(\n  parent: AbortSignal | undefined,\n  timeoutMs: number,\n): { signal: AbortSignal; cancel: () => void } {\n  const controller = new AbortController();\n  const onParentAbort = () => {\n    controller.abort(parent?.reason);\n  };\n  if (parent) {\n    if (parent.aborted) {\n      controller.abort(parent.reason);\n    } else {\n      parent.addEventListener('abort', onParentAbort, { once: true });\n    }\n  }\n  const timer = setTimeout(() => {\n    controller.abort(new Error(`Request timed out after ${timeoutMs}ms`));\n  }, timeoutMs);\n  return {\n    signal: controller.signal,\n    cancel: () => {\n      clearTimeout(timer);\n      if (parent) {\n        parent.removeEventListener('abort', onParentAbort);\n      }\n    },\n  };\n}\n\nasync function readBody(res: Response, parseJson: boolean): Promise<unknown> {\n  if (res.status === 204 || res.status === 205) {\n    return null;\n  }\n  const contentType = res.headers.get('content-type') ?? '';\n  if (parseJson && contentType.includes('application/json')) {\n    const text = await res.text();\n    if (text.length === 0) {\n      return null;\n    }\n    return JSON.parse(text);\n  }\n  return res.text();\n}\n\nexport async function request<T = unknown>(\n  req: HttpRequest,\n  options: RequestOptions,\n): Promise<HttpResponse<T>> {\n  const fetchImpl: FetchLike = options.fetch ?? (globalThis.fetch as FetchLike);\n  const retry = req.retry ?? {};\n  const maxAttempts = retry.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;\n  const initialDelayMs = retry.initialDelayMs ?? DEFAULT_INITIAL_DELAY_MS;\n  const maxDelayMs = retry.maxDelayMs ?? DEFAULT_MAX_DELAY_MS;\n  const retryOn = retry.retryOn ?? defaultRetryOn;\n  const timeoutMs = req.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const parseJson = req.parseJson ?? true;\n\n  const headers = mergeHeaders(\n    {\n      'User-Agent': DEFAULT_USER_AGENT,\n      Accept: 'application/json',\n    },\n    req.headers,\n  );\n\n  let lastErr: Error | undefined;\n\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\n    req.signal?.throwIfAborted();\n\n    const { signal, cancel } = linkTimeoutSignal(req.signal, timeoutMs);\n    let res: Response;\n    try {\n      res = await fetchImpl(req.url, {\n        method: req.method ?? 'GET',\n        headers,\n        body: req.body as RequestInit['body'],\n        signal,\n      });\n    } catch (err) {\n      cancel();\n      if (req.signal?.aborted) {\n        throw req.signal.reason ?? err;\n      }\n      const error = err instanceof Error ? err : new Error(String(err));\n      lastErr = error;\n      if (attempt < maxAttempts - 1 && retryOn(null, error)) {\n        const delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n        await sleep(delay, req.signal);\n        continue;\n      }\n      throw new TransientError(error.message);\n    }\n    cancel();\n\n    const body = await readBody(res, parseJson);\n    const httpResponse: HttpResponse<T> = {\n      status: res.status,\n      headers: res.headers,\n      body: body as T,\n    };\n    if (req.rateLimit) {\n      const state = req.rateLimit.parse(res.headers);\n      if (state) {\n        httpResponse.rateLimitState = state;\n      }\n    }\n\n    if (options.observer) {\n      await notifyObserver(options.observer, {\n        url: req.url,\n        method: req.method ?? 'GET',\n        status: res.status,\n        resource: options.resource,\n        requestId: options.requestId ?? newRequestId(),\n        body,\n      });\n    }\n\n    if (res.ok) {\n      return httpResponse;\n    }\n\n    const retryAfter = parseRetryAfter(res.headers.get('retry-after'));\n    const message = `HTTP ${res.status} ${res.statusText} for ${req.method ?? 'GET'} ${req.url}`;\n    const err = errorForStatus(message, httpResponse, retryAfter);\n\n    if (\n      attempt < maxAttempts - 1 &&\n      retryOn(res.status, err) &&\n      !(err instanceof AuthError) &&\n      !(err instanceof ClientBugError)\n    ) {\n      lastErr = err;\n      let delay = computeDelay(attempt, initialDelayMs, maxDelayMs);\n      if (err instanceof RateLimitError && retryAfter) {\n        const wait = retryAfter.getTime() - Date.now();\n        if (wait > 0) {\n          delay = Math.min(wait, maxDelayMs);\n        }\n      }\n      await sleep(delay, req.signal);\n      continue;\n    }\n\n    throw err;\n  }\n\n  throw lastErr ?? new UpstreamBugError('Exhausted retry attempts');\n}\n\nfunction computeDelay(\n  attempt: number,\n  initialDelayMs: number,\n  maxDelayMs: number,\n): number {\n  const base = initialDelayMs * 2 ** attempt;\n  const jitter = base * 0.25 * Math.random();\n  return Math.min(base + jitter, maxDelayMs);\n}\n\nexport { HttpClientError };\n","export interface RateLimitState {\n  remaining: number;\n  resetAt: Date;\n}\n\nexport interface RateLimitPolicy {\n  parse(headers: Headers): RateLimitState | null;\n}\n\nexport interface StandardRateLimitPolicyConfig {\n  remainingHeader: string;\n  resetHeader: string;\n  resetUnit: 's' | 'ms';\n  resetFallbackMs?: number;\n}\n\nexport function standardRateLimitPolicy(\n  config: StandardRateLimitPolicyConfig,\n): RateLimitPolicy {\n  const { remainingHeader, resetHeader, resetUnit, resetFallbackMs } = config;\n  const multiplier = resetUnit === 's' ? 1000 : 1;\n  return {\n    parse(h) {\n      const remainingRaw = h.get(remainingHeader);\n      if (remainingRaw === null || remainingRaw.trim() === '') {\n        return null;\n      }\n      const remaining = Number(remainingRaw);\n      if (!Number.isFinite(remaining)) {\n        return null;\n      }\n      const resetRaw = h.get(resetHeader);\n      if (resetRaw === null) {\n        if (resetFallbackMs === undefined) {\n          return null;\n        }\n        return {\n          remaining,\n          resetAt: new Date(Date.now() + resetFallbackMs),\n        };\n      }\n      if (resetRaw.trim() === '') {\n        return null;\n      }\n      const reset = Number(resetRaw);\n      if (!Number.isFinite(reset) || reset < 0) {\n        return null;\n      }\n      const resetMs = reset * multiplier;\n      if (!Number.isFinite(resetMs)) {\n        return null;\n      }\n      return { remaining, resetAt: new Date(resetMs) };\n    },\n  };\n}\n","export interface SanitizeAllowedUrlOptions {\n  url: string | null;\n  host: string;\n  pathname: string;\n  protocol?: 'https:' | 'http:';\n}\n\nexport function sanitizeAllowedUrl(\n  options: SanitizeAllowedUrlOptions,\n): string | null {\n  const { url, host, pathname, protocol = 'https:' } = options;\n  if (url === null) {\n    return null;\n  }\n  try {\n    const u = new URL(url);\n    if (u.protocol !== protocol || u.host !== host || u.pathname !== pathname) {\n      return null;\n    }\n    return u.toString();\n  } catch {\n    return null;\n  }\n}\n","export type EpochUnit = 'ms' | 's' | 'iso';\n\nexport function parseEpoch(\n  value: number | string | null | undefined,\n  unit: EpochUnit,\n): number | null {\n  if (value === null || value === undefined) {\n    return null;\n  }\n  if (unit === 'iso') {\n    if (typeof value !== 'string') {\n      return null;\n    }\n    const ms = new Date(value).getTime();\n    return Number.isFinite(ms) ? ms : null;\n  }\n  if (typeof value === 'string' && value.trim() === '') {\n    return null;\n  }\n  const n = typeof value === 'number' ? value : Number(value);\n  if (!Number.isFinite(n)) {\n    return null;\n  }\n  const result = unit === 's' ? n * 1000 : n;\n  return Number.isFinite(result) ? result : null;\n}\n","import { request } from './request';\nimport type { HttpRequest } from './types';\n\nexport function parseLinkHeader(header: string | null): Record<string, string> {\n  if (!header) {\n    return {};\n  }\n  const result: Record<string, string> = {};\n  for (const part of header.split(',')) {\n    const match = part.match(/<([^>]+)>\\s*;\\s*rel=\"([^\"]+)\"/);\n    if (match) {\n      result[match[2]!] = match[1]!;\n    }\n  }\n  return result;\n}\n\nexport async function* paginateLink<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => T[],\n  options: { resource: string },\n): AsyncIterable<T> {\n  let next: string | null = initial.url;\n  while (next) {\n    const res: Awaited<ReturnType<typeof request>> = await request(\n      {\n        ...initial,\n        url: next,\n      },\n      { resource: options.resource },\n    );\n    for (const item of parse(res.body)) {\n      yield item;\n    }\n    const links = parseLinkHeader(res.headers.get('link'));\n    next = links['next'] ?? null;\n  }\n}\n\nexport async function* paginateCursor<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => { items: T[]; nextCursor: string | null },\n  buildNext: (req: HttpRequest, cursor: string) => HttpRequest,\n  options: { resource: string },\n): AsyncIterable<T> {\n  let req: HttpRequest = initial;\n  while (true) {\n    const res = await request(req, { resource: options.resource });\n    const { items, nextCursor } = parse(res.body);\n    for (const item of items) {\n      yield item;\n    }\n    if (!nextCursor) {\n      return;\n    }\n    req = buildNext(req, nextCursor);\n  }\n}\n\nexport async function* paginatePage<T>(\n  initial: HttpRequest,\n  parse: (body: unknown) => { items: T[]; hasMore: boolean },\n  buildPage: (req: HttpRequest, page: number) => HttpRequest,\n  options: { resource: string },\n): AsyncIterable<T> {\n  let page = 1;\n  while (true) {\n    const req = page === 1 ? initial : buildPage(initial, page);\n    const res = await request(req, { resource: options.resource });\n    const { items, hasMore } = parse(res.body);\n    for (const item of items) {\n      yield item;\n    }\n    if (!hasMore || items.length === 0) {\n      return;\n    }\n    page++;\n  }\n}\n","export type LogFields = Record<string, unknown>;\n\nexport interface ConnectorLogger {\n  info(event: string, fields?: LogFields): void;\n  warn(event: string, fields?: LogFields): void;\n}\n\nexport interface ConnectorLoggerOptions {\n  scope: string;\n}\n\nconst MAX_VALUE_LEN = 120;\n\nfunction truncate(s: string, max = MAX_VALUE_LEN): string {\n  if (s.length <= max) {\n    return s;\n  }\n  return `${s.slice(0, max - 1)}…`;\n}\n\nfunction formatValue(value: unknown): string {\n  if (value === null) {\n    return 'null';\n  }\n  if (value === undefined) {\n    return '';\n  }\n  if (typeof value === 'number' || typeof value === 'boolean') {\n    return String(value);\n  }\n  if (typeof value === 'string') {\n    const t = truncate(value);\n    if (/[\\s\"=]/.test(t)) {\n      return JSON.stringify(t);\n    }\n    return t;\n  }\n  if (typeof value === 'bigint') {\n    return value.toString();\n  }\n  let json: string | undefined;\n  try {\n    json = JSON.stringify(value);\n  } catch {\n    json = undefined;\n  }\n  return truncate(json ?? String(value));\n}\n\nexport function formatLogFields(fields?: LogFields): string {\n  if (!fields) {\n    return '';\n  }\n  const parts: string[] = [];\n  for (const [k, v] of Object.entries(fields)) {\n    if (v === undefined) {\n      continue;\n    }\n    parts.push(`${k}=${formatValue(v)}`);\n  }\n  return parts.length > 0 ? ` ${parts.join(' ')}` : '';\n}\n\nexport function formatLogLine(\n  scope: string,\n  event: string,\n  fields?: LogFields,\n): string {\n  return `[${scope}] ${event}${formatLogFields(fields)}`;\n}\n\nexport function createDefaultConnectorLogger(\n  opts: ConnectorLoggerOptions,\n): ConnectorLogger {\n  return {\n    info(event, fields) {\n      console.info(formatLogLine(opts.scope, event, fields));\n    },\n    warn(event, fields) {\n      console.warn(formatLogLine(opts.scope, event, fields));\n    },\n  };\n}\n\nconst NOOP_LOGGER: ConnectorLogger = {\n  info() {},\n  warn() {},\n};\n\nexport function noopConnectorLogger(): ConnectorLogger {\n  return NOOP_LOGGER;\n}\n","import { connectorUserAgent } from '@rawdash/connector-shared';\nimport {\n  BaseConnector,\n  type ConnectorContext,\n  type ConnectorDoc,\n  type CredentialsSchema,\n  type StorageHandle,\n  type SyncOptions,\n  type SyncResult,\n  defineConfigFields,\n  defineConnectorDoc,\n  defineResources,\n  schemasFromResources,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\nexport const configFields = defineConfigFields(\n  z\n    .object({\n      siteUrl: z.string().trim().min(1).meta({\n        label: 'Site URL',\n        description:\n          'Verified Search Console property. URL-prefix properties look like \"https://example.com/\"; Domain properties look like \"sc-domain:example.com\".',\n        placeholder: 'https://example.com/',\n      }),\n      serviceAccountJson: z\n        .object({ $secret: z.string().trim().min(1) })\n        .optional()\n        .meta({\n          label: 'Service Account JSON (recommended)',\n          description:\n            'Contents of the JSON key file for a Google service account that has been added as a Search Console user (Owner or Full user) on the property. Create one at Google Cloud -> IAM & Admin -> Service Accounts.',\n          secret: true,\n        }),\n      refreshToken: z\n        .object({ $secret: z.string().trim().min(1) })\n        .optional()\n        .meta({\n          label: 'OAuth Refresh Token',\n          description:\n            'Google OAuth 2.0 refresh token with webmasters.readonly scope. Required if not using serviceAccountJson.',\n          secret: true,\n        }),\n      clientId: z.string().trim().min(1).optional().meta({\n        label: 'OAuth Client ID',\n        description:\n          'OAuth 2.0 client ID from Google Cloud Console. Required when using refreshToken auth.',\n        placeholder: '...apps.googleusercontent.com',\n      }),\n      clientSecret: z\n        .object({ $secret: z.string().trim().min(1) })\n        .optional()\n        .meta({\n          label: 'OAuth Client Secret',\n          description:\n            'OAuth 2.0 client secret from Google Cloud Console. Required when using refreshToken auth.',\n          secret: true,\n        }),\n      lookbackDays: z.number().int().positive().optional().meta({\n        label: 'Lookback days (full sync)',\n        description:\n          'How many calendar days to fetch on a full sync. Defaults to 90.',\n        placeholder: '90',\n      }),\n    })\n    .refine(\n      (val) =>\n        val.serviceAccountJson !== undefined ||\n        (val.refreshToken !== undefined &&\n          val.clientId !== undefined &&\n          val.clientSecret !== undefined),\n      {\n        message:\n          'Provide either serviceAccountJson or the full OAuth tuple (refreshToken + clientId + clientSecret)',\n      },\n    ),\n);\n\nexport const doc: ConnectorDoc = defineConnectorDoc({\n  displayName: 'Google Search Console',\n  category: 'marketing',\n  brandColor: '#458CF5',\n  tagline:\n    'Sync daily Search Console SEO metrics - clicks, impressions, CTR, and average position - by date, query, page, and country.',\n  vendor: {\n    name: 'Google Search Console',\n    apiDocs:\n      'https://developers.google.com/webmaster-tools/v1/api_reference_index',\n    website: 'https://search.google.com/search-console',\n  },\n  auth: {\n    summary:\n      'Authenticate against the Search Console API with either a Google service account JSON key (recommended) or an OAuth 2.0 refresh-token tuple. The identity must be added as a user on the Search Console property (Owner or Full user).',\n    setup: [\n      'Identify the property to sync. URL-prefix properties use the full origin (e.g. https://example.com/); Domain properties use the sc-domain:example.com format.',\n      'Recommended: create a service account at Google Cloud -> IAM & Admin -> Service Accounts, generate a JSON key, then in Search Console add the service account email as a user on the property. Store the JSON as a secret and reference it as serviceAccountJson: secret(\"GSC_SERVICE_ACCOUNT_JSON\").',\n      'Alternative: provide an OAuth 2.0 refresh token with the webmasters.readonly scope together with its clientId and clientSecret from the Google Cloud Console.',\n    ],\n  },\n  rateLimit:\n    'Search Console API quota is 1,200 queries per minute per project (default); 429 responses are retried automatically with exponential backoff.',\n  limitations: [\n    'Search Console aggregates data with a 2-3 day lag, so incremental syncs refetch the trailing 3 days.',\n    'Each query is paginated 25,000 rows per page; a phase that yields more than that paginates by startRow.',\n  ],\n});\n\n// ---------------------------------------------------------------------------\n// Settings / credentials\n// ---------------------------------------------------------------------------\n\nexport interface GSCSettings {\n  siteUrl: string;\n  lookbackDays?: number;\n}\n\nconst gscCredentials = {\n  serviceAccountJson: {\n    description: 'Google service account JSON key (base64 or raw JSON)',\n    auth: 'optional' as const,\n  },\n  refreshToken: {\n    description: 'Google OAuth 2.0 refresh token',\n    auth: 'optional' as const,\n  },\n  clientId: {\n    description: 'Google OAuth 2.0 client ID',\n    auth: 'optional' as const,\n  },\n  clientSecret: {\n    description: 'Google OAuth 2.0 client secret',\n    auth: 'optional' as const,\n  },\n} satisfies CredentialsSchema;\n\ntype GSCCredentials = typeof gscCredentials;\n\n// ---------------------------------------------------------------------------\n// Sync phases + cursor\n// ---------------------------------------------------------------------------\n\nconst PHASE_ORDER = [\n  'search_analytics_by_day',\n  'top_queries',\n  'top_pages',\n  'top_countries',\n] as const;\n\ntype GSCPhase = (typeof PHASE_ORDER)[number];\n\ninterface GSCDateRange {\n  startDate: string;\n  endDate: string;\n}\n\ninterface GSCSyncCursor {\n  phase: GSCPhase;\n  dateRange: GSCDateRange;\n}\n\nconst GSC_DATE_RE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nfunction isGSCDateString(value: unknown): value is string {\n  return typeof value === 'string' && GSC_DATE_RE.test(value);\n}\n\nfunction isGSCDateRange(value: unknown): value is GSCDateRange {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const v = value as { startDate?: unknown; endDate?: unknown };\n  return isGSCDateString(v.startDate) && isGSCDateString(v.endDate);\n}\n\nfunction isGSCSyncCursor(value: unknown): value is GSCSyncCursor {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const v = value as { phase?: unknown; dateRange?: unknown };\n  if (typeof v.phase !== 'string') {\n    return false;\n  }\n  if (!(PHASE_ORDER as readonly string[]).includes(v.phase)) {\n    return false;\n  }\n  return isGSCDateRange(v.dateRange);\n}\n\n// ---------------------------------------------------------------------------\n// Phase configs - dimensions for each resource\n// ---------------------------------------------------------------------------\n\ninterface PhaseConfig {\n  dimensions: string[];\n  metricName: string;\n}\n\nconst PHASE_CONFIGS: Record<GSCPhase, PhaseConfig> = {\n  search_analytics_by_day: {\n    dimensions: ['date'],\n    metricName: 'gsc_search_analytics_by_day',\n  },\n  top_queries: {\n    dimensions: ['date', 'query'],\n    metricName: 'gsc_top_queries',\n  },\n  top_pages: {\n    dimensions: ['date', 'page'],\n    metricName: 'gsc_top_pages',\n  },\n  top_countries: {\n    dimensions: ['date', 'country'],\n    metricName: 'gsc_top_countries',\n  },\n};\n\nconst ROWS_PER_PAGE = 25_000;\nconst METRIC_FIELDS = ['clicks', 'impressions', 'ctr', 'position'] as const;\n\n// ---------------------------------------------------------------------------\n// GSC Search Analytics API types\n// ---------------------------------------------------------------------------\n\nexport interface GSCReportRow {\n  keys?: string[];\n  clicks?: number;\n  impressions?: number;\n  ctr?: number;\n  position?: number;\n}\n\ninterface GSCReportResponse {\n  rows?: GSCReportRow[];\n  responseAggregationType?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Service account / OAuth token helpers\n// ---------------------------------------------------------------------------\n\ninterface ServiceAccountKey {\n  client_email: string;\n  private_key: string;\n  token_uri?: string;\n}\n\ninterface TokenResponse {\n  access_token: string;\n  expires_in?: number;\n}\n\nfunction base64urlFromBytes(bytes: Uint8Array): string {\n  let binary = '';\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]!);\n  }\n  return btoa(binary).replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=/g, '');\n}\n\nfunction base64urlFromString(str: string): string {\n  return base64urlFromBytes(new TextEncoder().encode(str));\n}\n\nasync function signRS256JWT(\n  payload: Record<string, unknown>,\n  privateKeyPem: string,\n): Promise<string> {\n  const header = { alg: 'RS256', typ: 'JWT' };\n  const headerB64 = base64urlFromString(JSON.stringify(header));\n  const payloadB64 = base64urlFromString(JSON.stringify(payload));\n  const signingInput = `${headerB64}.${payloadB64}`;\n\n  const pemContent = privateKeyPem\n    .replace(/-----BEGIN PRIVATE KEY-----/g, '')\n    .replace(/-----END PRIVATE KEY-----/g, '')\n    .replace(/\\s/g, '');\n  const der = Uint8Array.from(atob(pemContent), (c) => c.charCodeAt(0));\n\n  const key = await globalThis.crypto.subtle.importKey(\n    'pkcs8',\n    der,\n    { name: 'RSASSA-PKCS1-v1_5', hash: 'SHA-256' },\n    false,\n    ['sign'],\n  );\n\n  const signature = await globalThis.crypto.subtle.sign(\n    'RSASSA-PKCS1-v1_5',\n    key,\n    new TextEncoder().encode(signingInput),\n  );\n\n  return `${signingInput}.${base64urlFromBytes(new Uint8Array(signature))}`;\n}\n\nfunction parseServiceAccountJson(value: string): ServiceAccountKey {\n  const trimmed = value.trim();\n  if (trimmed.startsWith('{')) {\n    return JSON.parse(trimmed) as ServiceAccountKey;\n  }\n  const binary = atob(trimmed);\n  const bytes = new Uint8Array(binary.length);\n  for (let i = 0; i < binary.length; i++) {\n    bytes[i] = binary.charCodeAt(i);\n  }\n  const decoded = new TextDecoder().decode(bytes);\n  return JSON.parse(decoded) as ServiceAccountKey;\n}\n\nasync function buildServiceAccountJwt(\n  serviceAccountJson: string,\n): Promise<{ url: string; body: string }> {\n  const sa = parseServiceAccountJson(serviceAccountJson);\n  const now = Math.floor(Date.now() / 1000);\n  const jwt = await signRS256JWT(\n    {\n      iss: sa.client_email,\n      scope: 'https://www.googleapis.com/auth/webmasters.readonly',\n      aud: sa.token_uri ?? 'https://oauth2.googleapis.com/token',\n      exp: now + 3600,\n      iat: now,\n    },\n    sa.private_key,\n  );\n\n  const body = new URLSearchParams({\n    grant_type: 'urn:ietf:params:oauth:grant-type:jwt-bearer',\n    assertion: jwt,\n  }).toString();\n\n  return {\n    url: sa.token_uri ?? 'https://oauth2.googleapis.com/token',\n    body,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Date helpers\n// ---------------------------------------------------------------------------\n\nfunction toGSCDate(date: Date): string {\n  const y = date.getUTCFullYear();\n  const m = String(date.getUTCMonth() + 1).padStart(2, '0');\n  const d = String(date.getUTCDate()).padStart(2, '0');\n  return `${y}-${m}-${d}`;\n}\n\nfunction gscDateToMs(gscDate: string): number {\n  // GSC date dimension comes back as 'YYYY-MM-DD'\n  const y = gscDate.slice(0, 4);\n  const m = gscDate.slice(5, 7);\n  const d = gscDate.slice(8, 10);\n  return Date.UTC(Number(y), Number(m) - 1, Number(d));\n}\n\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\nconst INCREMENTAL_LOOKBACK_DAYS = 3;\n\nfunction getDateRange(\n  options: SyncOptions,\n  lookbackDays: number,\n): GSCDateRange {\n  const now = Date.now();\n  const endDate = toGSCDate(new Date(now));\n  if (options.mode === 'latest') {\n    const startMs = now - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY;\n    return { startDate: toGSCDate(new Date(startMs)), endDate };\n  }\n  if (options.since) {\n    const sinceMs = new Date(options.since).getTime();\n    if (Number.isFinite(sinceMs)) {\n      const days = Math.max(1, Math.ceil((now - sinceMs) / MS_PER_DAY));\n      const cappedDays = Math.min(days, lookbackDays);\n      const startMs = now - (cappedDays - 1) * MS_PER_DAY;\n      return { startDate: toGSCDate(new Date(startMs)), endDate };\n    }\n  }\n  const startMs = now - (lookbackDays - 1) * MS_PER_DAY;\n  return { startDate: toGSCDate(new Date(startMs)), endDate };\n}\n\n// ---------------------------------------------------------------------------\n// Row conversion\n// ---------------------------------------------------------------------------\n\nexport function rowToMetricSample(\n  row: GSCReportRow,\n  dimensions: string[],\n  metricName: string,\n): {\n  name: string;\n  ts: number;\n  value: number;\n  attributes: Record<string, string | number>;\n} {\n  const attributes: Record<string, string | number> = {};\n  const keys = row.keys ?? [];\n  for (let i = 0; i < dimensions.length; i++) {\n    attributes[dimensions[i]!] = keys[i] ?? '';\n  }\n\n  for (const field of METRIC_FIELDS) {\n    const raw = row[field];\n    attributes[field] =\n      typeof raw === 'number' && Number.isFinite(raw) ? raw : 0;\n  }\n\n  const dateStr =\n    typeof attributes['date'] === 'string' ? attributes['date'] : '1970-01-01';\n  const ts = gscDateToMs(dateStr);\n  const primaryValue = attributes['clicks'] as number;\n\n  return {\n    name: metricName,\n    ts,\n    value: primaryValue,\n    attributes,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Schemas - describe the per-resource API response shape consumed by request()\n// ---------------------------------------------------------------------------\n\nconst dateKey = z\n  .string()\n  .regex(/^(19|20)\\d{2}-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$/);\nconst stringKey = z.string();\nconst numericField = z.number();\n\nfunction reportSchema(dimensionCount: number) {\n  const keys =\n    dimensionCount === 1\n      ? z.tuple([dateKey])\n      : z.tuple([dateKey, ...Array(dimensionCount - 1).fill(stringKey)] as [\n          typeof dateKey,\n          ...z.ZodType[],\n        ]);\n  return z.object({\n    rows: z\n      .array(\n        z.object({\n          keys,\n          clicks: numericField.optional(),\n          impressions: numericField.optional(),\n          ctr: numericField.optional(),\n          position: numericField.optional(),\n        }),\n      )\n      .optional(),\n  });\n}\n\nconst tokenResponseSchema = z.object({\n  access_token: z.string().min(1),\n  expires_in: z.number().int().positive().optional(),\n});\n\nconst googleSearchConsoleResources = defineResources({\n  gsc_search_analytics_by_day: {\n    shape: 'metric',\n    description:\n      'Daily site totals - clicks, impressions, CTR, and average position across all queries and pages.',\n    unit: 'clicks',\n    granularity: 'day',\n    endpoint: 'POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n    ],\n    responses: {\n      oauth_token: tokenResponseSchema,\n      search_analytics_by_day: reportSchema(1),\n    },\n  },\n  gsc_top_queries: {\n    shape: 'metric',\n    description:\n      'Daily clicks, impressions, CTR, and average position broken down by search query.',\n    unit: 'clicks',\n    granularity: 'day',\n    endpoint: 'POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n      {\n        name: 'query',\n        description: 'Search term that surfaced a result for the property.',\n      },\n    ],\n    responses: { top_queries: reportSchema(2) },\n  },\n  gsc_top_pages: {\n    shape: 'metric',\n    description:\n      'Daily clicks, impressions, CTR, and average position broken down by landing page URL.',\n    unit: 'clicks',\n    granularity: 'day',\n    endpoint: 'POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n      {\n        name: 'page',\n        description: 'Canonical URL of the page that surfaced in search.',\n      },\n    ],\n    responses: { top_pages: reportSchema(2) },\n  },\n  gsc_top_countries: {\n    shape: 'metric',\n    description:\n      'Daily clicks, impressions, CTR, and average position broken down by visitor country.',\n    unit: 'clicks',\n    granularity: 'day',\n    endpoint: 'POST /webmasters/v3/sites/{siteUrl}/searchAnalytics/query',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n      {\n        name: 'country',\n        description: 'ISO 3166-1 alpha-3 country code of the searcher.',\n      },\n    ],\n    responses: { top_countries: reportSchema(2) },\n  },\n});\n\nexport class GSCConnector extends BaseConnector<GSCSettings, GSCCredentials> {\n  static readonly id = 'google-search-console';\n\n  static readonly resources = googleSearchConsoleResources;\n\n  static readonly schemas = schemasFromResources(googleSearchConsoleResources);\n\n  static create(input: unknown, ctx?: ConnectorContext): GSCConnector {\n    const parsed = configFields.parse(input);\n    return new GSCConnector(\n      {\n        siteUrl: parsed.siteUrl,\n        lookbackDays: parsed.lookbackDays,\n      },\n      {\n        serviceAccountJson: parsed.serviceAccountJson,\n        refreshToken: parsed.refreshToken,\n        clientId: parsed.clientId,\n        clientSecret: parsed.clientSecret,\n      },\n      ctx,\n    );\n  }\n\n  readonly id = 'google-search-console';\n  override readonly credentials = gscCredentials;\n\n  private cachedToken: { token: string; expiresAt: number } | null = null;\n\n  private async fetchOAuthToken(\n    url: string,\n    body: string,\n    signal: AbortSignal | undefined,\n  ): Promise<{ token: string; expiresAt: number }> {\n    const res = await this.post<TokenResponse>(url, {\n      resource: 'oauth_token',\n      headers: { 'Content-Type': 'application/x-www-form-urlencoded' },\n      body,\n      signal,\n    });\n    const expiresIn = res.body.expires_in ?? 3600;\n    return {\n      token: res.body.access_token,\n      expiresAt: Date.now() + (expiresIn - 60) * 1000,\n    };\n  }\n\n  private async getAccessToken(signal?: AbortSignal): Promise<string> {\n    if (this.cachedToken && Date.now() < this.cachedToken.expiresAt) {\n      return this.cachedToken.token;\n    }\n\n    const { serviceAccountJson, refreshToken, clientId, clientSecret } =\n      this.creds;\n\n    if (serviceAccountJson) {\n      const { url, body } = await buildServiceAccountJwt(serviceAccountJson);\n      this.cachedToken = await this.fetchOAuthToken(url, body, signal);\n      return this.cachedToken.token;\n    }\n\n    if (refreshToken && clientId && clientSecret) {\n      const body = new URLSearchParams({\n        grant_type: 'refresh_token',\n        refresh_token: refreshToken,\n        client_id: clientId,\n        client_secret: clientSecret,\n      }).toString();\n      this.cachedToken = await this.fetchOAuthToken(\n        'https://oauth2.googleapis.com/token',\n        body,\n        signal,\n      );\n      return this.cachedToken.token;\n    }\n\n    throw new Error(\n      'GSC connector: provide either serviceAccountJson or (refreshToken + clientId + clientSecret)',\n    );\n  }\n\n  private async runReport(\n    accessToken: string,\n    phase: GSCPhase,\n    dateRange: GSCDateRange,\n    startRow: number,\n    signal?: AbortSignal,\n  ): Promise<GSCReportResponse> {\n    const { dimensions } = PHASE_CONFIGS[phase];\n    const url = `https://searchconsole.googleapis.com/webmasters/v3/sites/${encodeURIComponent(this.settings.siteUrl)}/searchAnalytics/query`;\n\n    const body: Record<string, unknown> = {\n      startDate: dateRange.startDate,\n      endDate: dateRange.endDate,\n      dimensions,\n      rowLimit: ROWS_PER_PAGE,\n      startRow,\n    };\n\n    const res = await this.post<GSCReportResponse>(url, {\n      resource: phase,\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n        'Content-Type': 'application/json',\n        'User-Agent': connectorUserAgent('google-search-console'),\n      },\n      body: JSON.stringify(body),\n      signal,\n    });\n    return res.body;\n  }\n\n  async sync(\n    options: SyncOptions,\n    storage: StorageHandle,\n    signal?: AbortSignal,\n  ): Promise<SyncResult> {\n    const lookbackDays = this.settings.lookbackDays ?? 90;\n\n    const cursor = isGSCSyncCursor(options.cursor) ? options.cursor : undefined;\n    // Restore the originally-computed window on resume so phases stay aligned\n    // across midnight rollovers and lookbackDays changes between runs.\n    const dateRange = cursor?.dateRange ?? getDateRange(options, lookbackDays);\n\n    let accessToken: string | null = null;\n    const getToken = async (sig?: AbortSignal): Promise<string> => {\n      if (!accessToken) {\n        accessToken = await this.getAccessToken(sig);\n      }\n      return accessToken;\n    };\n\n    const runReportWithRetry = async (\n      phase: GSCPhase,\n      startRow: number,\n      sig: AbortSignal | undefined,\n    ): Promise<GSCReportResponse> => {\n      const token = await getToken(sig);\n      try {\n        return await this.runReport(token, phase, dateRange, startRow, sig);\n      } catch (err) {\n        console.warn(\n          `[gsc] runReport failed, refreshing token and retrying once`,\n          err,\n        );\n        accessToken = null;\n        const freshToken = await getToken(sig);\n        return this.runReport(freshToken, phase, dateRange, startRow, sig);\n      }\n    };\n\n    const drainPhase = async (phase: GSCPhase): Promise<GSCReportRow[]> => {\n      const allRows: GSCReportRow[] = [];\n      let startRow = 0;\n      for (;;) {\n        const response = await runReportWithRetry(phase, startRow, signal);\n        const rows = response.rows ?? [];\n        allRows.push(...rows);\n        startRow += rows.length;\n        // GSC has no totalRowCount field on responses, so a short page is the\n        // terminating signal. Empty page also breaks out (covers the rare\n        // \"exact multiple of rowLimit\" case where one extra request is fine).\n        if (rows.length < ROWS_PER_PAGE) {\n          break;\n        }\n      }\n      return allRows;\n    };\n\n    const resumeIdx = cursor ? PHASE_ORDER.indexOf(cursor.phase) : -1;\n    const startIdx = resumeIdx >= 0 ? resumeIdx : 0;\n\n    for (let i = startIdx; i < PHASE_ORDER.length; i++) {\n      const phase = PHASE_ORDER[i]!;\n      if (signal?.aborted) {\n        return { done: false, cursor: { phase, dateRange } };\n      }\n\n      // Drain every page of this phase in-memory before writing so the commit\n      // is one atomic call. A mid-phase failure restarts this phase from\n      // scratch on the next sync; the clear-and-replace below wipes partial\n      // state. If the abort signal trips mid-drain, surface a resumable\n      // cursor instead of throwing the AbortError up to the caller.\n      let rows: GSCReportRow[];\n      try {\n        rows = await drainPhase(phase);\n      } catch (err) {\n        if (signal?.aborted) {\n          return { done: false, cursor: { phase, dateRange } };\n        }\n        throw err;\n      }\n      const cfg = PHASE_CONFIGS[phase];\n      const samples = rows.map((row) =>\n        rowToMetricSample(row, cfg.dimensions, cfg.metricName),\n      );\n      // Scoping by name ensures stale rows are wiped even when samples is empty.\n      await storage.metrics(samples, { names: [cfg.metricName] });\n    }\n\n    return { done: true };\n  }\n}\n","import { GSCConnector } from './google-search-console';\n\nexport {\n  configFields,\n  doc,\n  GSCConnector,\n  rowToMetricSample,\n} from './google-search-console';\nexport type { GSCSettings } from './google-search-console';\nexport default GSCConnector;\n"],"mappings":"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","names":["startMs"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@rawdash/connector-google-search-console",
+  "version": "0.16.0",
+  "description": "Rawdash connector for Google Search Console - syncs SEO impressions, clicks, CTR, and position by day, query, page, and country into the six-shape storage model",
+  "license": "Apache-2.0",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rawdash/rawdash.git",
+    "directory": "packages/connectors/google-search-console"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "@rawdash/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@rawdash/core": "workspace:*",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@rawdash/connector-shared": "workspace:*",
+    "@rawdash/connector-test-utils": "workspace:*",
+    "fast-check": "^4.8.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.4"
+  }
+}