@rawdash/connector-google-analytics 0.15.0 → 0.16.0

package/README.md

@@ -1,119 +1,104 @@
+<!-- This file is generated from connector metadata by scripts/generate-connector-docs.ts. Do not edit by hand. -->
+
 # @rawdash/connector-google-analytics
 
-Rawdash connector for Google Analytics 4 — syncs traffic, source/medium attribution, top pages, events, conversions, and geo data via the [GA4 Data API](https://developers.google.com/analytics/devguides/reporting/data/v1).
+[![npm version](https://img.shields.io/npm/v/@rawdash/connector-google-analytics)](https://www.npmjs.com/package/@rawdash/connector-google-analytics)
+[![license](https://img.shields.io/npm/l/@rawdash/connector-google-analytics)](https://github.com/rawdash/rawdash/blob/main/LICENSE)
 
-## Auth setup
+Sync daily GA4 traffic, acquisition, top pages, events, conversions, and geography metrics from a Google Analytics 4 property.
 
-The connector supports two authentication methods. **Service account JSON** is recommended for server-side use.
+## Install
 
-### Option A — Service account (recommended)
+```sh
+npm install @rawdash/connector-google-analytics
+```
 
-1. Open [Google Cloud Console](https://console.cloud.google.com) and select (or create) your project.
-2. Navigate to **IAM & Admin → Service Accounts** and click **Create Service Account**.
-3. Give it a name (e.g. `rawdash-ga4-reader`) and click **Create and continue**.
-4. Skip the optional role assignment on this screen — click **Done**.
-5. In Google Analytics, go to **Admin → Account Access Management** and add the service account email with the **Viewer** role.
-6. Back in Cloud Console, open the service account → **Keys** → **Add key → Create new key → JSON**.
-7. Download the `.json` file and store its contents as the secret `GA_SERVICE_ACCOUNT_JSON`.
+## Authentication
 
-### Option B — OAuth refresh token
+Authenticate against the GA4 Data API with either a Google service account JSON key (recommended) or an OAuth 2.0 refresh-token tuple. The identity must have at least the Analytics Viewer role on the property.
 
-1. Create an OAuth 2.0 client ID in [Google Cloud Console](https://console.cloud.google.com) → **APIs & Services → Credentials → Create Credentials → OAuth client ID** (type: Web application).
-2. Run the OAuth consent flow with scope `https://www.googleapis.com/auth/analytics.readonly`.
-3. Exchange the authorization code for a refresh token using the token endpoint.
-4. Store the refresh token as `GA_REFRESH_TOKEN`, the client ID as `GA_CLIENT_ID`, and the client secret as `GA_CLIENT_SECRET`.
+1. Find your GA4 Property ID under Google Analytics -> Admin -> Property settings (numeric, e.g. 123456789).
+2. Recommended: create a service account at Google Cloud -> IAM & Admin -> Service Accounts, generate a JSON key, and grant it the Analytics Viewer role on the property. Store the JSON as a secret and reference it as serviceAccountJson: secret("GA4_SERVICE_ACCOUNT_JSON").
+3. Alternative: provide an OAuth 2.0 refresh token with the analytics.readonly scope together with its clientId and clientSecret from the Google Cloud Console.
 
 ## Configuration
 
-Service account auth:
-
-```ts
-import { secret } from '@rawdash/core';
-
-const ga4 = {
-  name: 'ga4',
-  connectorId: 'google-analytics',
-  config: {
-    propertyId: '123456789',
-    serviceAccountJson: secret('GA_SERVICE_ACCOUNT_JSON'),
-  },
-};
-```
-
-OAuth auth:
+| Field                | Type   | Required | Description                                                                                                                                             |
+| -------------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `propertyId`         | string | Yes      | Numeric ID of your GA4 property (e.g. 123456789). Find it in Google Analytics → Admin → Property settings.                                              |
+| `serviceAccountJson` | secret | No       | Contents of the JSON key file for a Google service account with the Analytics Viewer role. Create one at Google Cloud → IAM & Admin → Service Accounts. |
+| `refreshToken`       | secret | No       | Google OAuth 2.0 refresh token with analytics.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
+
+- **`ga4_traffic_by_day`** _(metric)_ - Daily site traffic totals - sessions, total users, new users, page views, and engagement rate.
+  - Endpoint: `POST /v1beta/properties/{propertyId}:runReport`
+  - Unit: sessions
+  - Granularity: day
+  - Dimensions: `date`
+- **`ga4_traffic_by_source`** _(metric)_ - Daily sessions and conversions broken down by acquisition source and medium.
+  - Endpoint: `POST /v1beta/properties/{propertyId}:runReport`
+  - Unit: sessions
+  - Granularity: day
+  - Dimensions: `date`, `sessionSource`, `sessionMedium`
+- **`ga4_top_pages`** _(metric)_ - Daily page views and average session duration bucketed by page path.
+  - Endpoint: `POST /v1beta/properties/{propertyId}:runReport`
+  - Unit: page_views
+  - Granularity: day
+  - Dimensions: `date`, `pagePath`
+- **`ga4_events`** _(metric)_ - Daily event counts and the users that triggered them, bucketed by event name.
+  - Endpoint: `POST /v1beta/properties/{propertyId}:runReport`
+  - Unit: events
+  - Granularity: day
+  - Dimensions: `date`, `eventName`
+- **`ga4_conversions`** _(metric)_ - Daily conversion counts and total revenue bucketed by conversion event name.
+  - Endpoint: `POST /v1beta/properties/{propertyId}:runReport`
+  - Unit: conversions
+  - Granularity: day
+  - Dimensions: `date`, `eventName`
+- **`ga4_geo`** _(metric)_ - Daily sessions and total users bucketed by visitor country.
+  - Endpoint: `POST /v1beta/properties/{propertyId}:runReport`
+  - Unit: sessions
+  - Granularity: day
+  - Dimensions: `date`, `country`
+
+## Example
 
 ```ts
-import { secret } from '@rawdash/core';
-
-const ga4 = {
-  name: 'ga4',
+import {
+  defineConfig,
+  defineDashboard,
+  defineMetric,
+  secret,
+} from '@rawdash/core';
+
+const googleAnalytics = {
+  name: 'googleAnalytics',
   connectorId: 'google-analytics',
   config: {
     propertyId: '123456789',
-    refreshToken: secret('GA_REFRESH_TOKEN'),
-    clientId: process.env['GA_CLIENT_ID']!,
-    clientSecret: secret('GA_CLIENT_SECRET'),
+    serviceAccountJson: secret('GA4_SERVICE_ACCOUNT_JSON'),
+    lookbackDays: 90,
   },
 };
-```
-
-Register the connector class when mounting the engine:
-
-```ts
-import { GA4Connector } from '@rawdash/connector-google-analytics';
-import { mountEngine } from '@rawdash/hono';
-
-mountEngine(config, {
-  connectorRegistry: { 'google-analytics': GA4Connector },
-});
-```
-
-Then wire it into `defineConfig`:
-
-```ts
-import { defineConfig, defineDashboard, defineMetric } from '@rawdash/core';
 
 export default defineConfig({
-  connectors: [ga4],
+  connectors: [googleAnalytics],
   dashboards: {
-    marketing: defineDashboard({
+    traffic: defineDashboard({
       widgets: {
-        sessions_today: {
-          kind: 'stat',
-          title: 'Sessions today',
-          metric: defineMetric({
-            connector: ga4,
-            shape: 'metric',
-            name: 'ga4_traffic_by_day',
-            field: 'sessions',
-            fn: 'sum',
-            window: '1d',
-          }),
-        },
-        sessions_over_time: {
+        sessions: {
           kind: 'timeseries',
-          title: 'Sessions over time',
+          title: 'Daily sessions',
           window: '30d',
           metric: defineMetric({
-            connector: ga4,
+            connector: googleAnalytics,
             shape: 'metric',
             name: 'ga4_traffic_by_day',
-            field: 'sessions',
-            fn: 'sum',
-            window: '30d',
-            groupBy: { field: 'ts', granularity: 'day' },
-          }),
-        },
-        traffic_by_source: {
-          kind: 'distribution',
-          title: 'Traffic by source',
-          metric: defineMetric({
-            connector: ga4,
-            shape: 'metric',
-            name: 'ga4_traffic_by_source',
-            field: 'sessions',
             fn: 'sum',
-            window: '30d',
           }),
         },
       },
@@ -122,69 +107,21 @@ export default defineConfig({
 });
 ```
 
-## Data model
+## Rate limits
 
-All resources are stored as **metric samples** (`shape: 'metric'`). The `ts` field is the date in Unix milliseconds. All GA4 dimensions and metrics are available as attributes on each sample.
+GA4 Data API quota is 200,000 tokens/day per property (default); 429 responses are retried automatically with exponential backoff.
 
-| Metric name             | Dimensions                         | Metrics (attributes)                                            |
-| ----------------------- | ---------------------------------- | --------------------------------------------------------------- |
-| `ga4_traffic_by_day`    | date                               | sessions, totalUsers, newUsers, screenPageViews, engagementRate |
-| `ga4_traffic_by_source` | date, sessionSource, sessionMedium | sessions, conversions                                           |
-| `ga4_top_pages`         | date, pagePath                     | screenPageViews, averageSessionDuration                         |
-| `ga4_events`            | date, eventName                    | eventCount, totalUsers                                          |
-| `ga4_conversions`       | date, eventName                    | conversions, totalRevenue                                       |
-| `ga4_geo`               | date, country                      | sessions, totalUsers                                            |
+## Limitations
 
-The `value` field of each metric sample contains the first metric in the table above (e.g. `sessions` for `ga4_traffic_by_day`). All other metrics are accessible via attribute names.
-
-## Schemas
-
-`GA4Connector.schemas` declares the Zod schema for each `request()` resource — one per `runReport` phase, plus the OAuth token exchange. Used by the cloud shape-drift pipeline to populate `connector_baselines`, and by the package's property tests.
-
-| Resource            | Represents                                                                  |
-| ------------------- | --------------------------------------------------------------------------- |
-| `oauth_token`       | `POST https://oauth2.googleapis.com/token` — access-token exchange response |
-| `traffic_by_day`    | `properties/{id}:runReport` with `dimensions=[date]`                        |
-| `traffic_by_source` | `runReport` with `dimensions=[date, sessionSource, sessionMedium]`          |
-| `top_pages`         | `runReport` with `dimensions=[date, pagePath]`                              |
-| `events`            | `runReport` with `dimensions=[date, eventName]`                             |
-| `conversions`       | `runReport` with `dimensions=[date, eventName]`                             |
-| `geo`               | `runReport` with `dimensions=[date, country]`                               |
-
-## Sync behaviour
-
-- **Backfill** (`mode: 'full'`): fetches a rolling window (default 90 days, configurable via `lookbackDays`) for all six resources.
-- **Incremental** (`mode: 'latest'`): fetches the trailing 30 days to catch late-arriving attribution data (GA4 can attribute conversions up to 3 days after the session).
-- Both modes **clear existing metric data** for each resource before re-inserting, preventing duplicate rows from accumulating across sync runs.
-- **Pagination**: uses the GA4 Data API `offset`/`limit` model with 10 000 rows per page. Interrupted syncs return a cursor and resume from the same phase and offset.
-- **Rate limits**: the GA4 Data API quota is 200 000 tokens/day per property (default). 429 responses are handled automatically by the built-in HTTP client with exponential back-off.
-
-## Registering in the MCP server
-
-```ts
-import {
-  GA4Connector,
-  configFields,
-} from '@rawdash/connector-google-analytics';
-
-createMcpServer({
-  // ...
-  connectorFactories: [
-    {
-      id: 'google-analytics',
-      configFields,
-      create: GA4Connector.create,
-    },
-  ],
-});
-```
+- Incremental syncs use a 30-day window because GA4 can attribute conversions up to 3 days after the session.
+- Report pagination is 10,000 rows per page.
 
-## Property tests
+## Links
 
-Resources in this connector have fast-check property tests under `src/property.test.ts` that:
+- [Rawdash docs](https://rawdash.dev/docs/connectors/)
+- [Google Analytics API docs](https://developers.google.com/analytics/devguides/reporting/data/v1)
+- [GitHub](https://github.com/rawdash/rawdash)
 
-1. Generate N≥50 synthetic API payloads from a Zod schema mirroring the upstream API response.
-2. Pipe them through `connector.sync()` against an `InMemoryStorage` instance.
-3. Assert universal invariants — non-empty entity ids, finite event timestamps, no `undefined` leaking into storage, no thrown errors on any valid input — plus per-resource counts.
+## License
 
-The helper lives in `@rawdash/connector-test-utils`. When adding a new resource, add a Zod schema for its payload and a test wired up via `runPropertySyncTest`.
+Apache-2.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult } from '@rawdash/core';
+import { BaseConnector, ConnectorContext, SyncOptions, StorageHandle, SyncResult, ConnectorDoc } from '@rawdash/core';
 import { z } from 'zod';
 
 declare const configFields: z.ZodObject<{
@@ -15,6 +15,7 @@ declare const configFields: z.ZodObject<{
     }, z.core.$strip>>;
     lookbackDays: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
+declare const doc: ConnectorDoc;
 interface GA4Settings {
     propertyId: string;
     lookbackDays?: number;
@@ -56,6 +57,168 @@ declare function rowToMetricSample(row: GA4ReportRow, dimensionHeaders: string[]
 };
 declare class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {
     static readonly id = "google-analytics";
+    static readonly resources: {
+        readonly ga4_traffic_by_day: {
+            readonly shape: "metric";
+            readonly description: "Daily site traffic totals - sessions, total users, new users, page views, and engagement rate.";
+            readonly unit: "sessions";
+            readonly granularity: "day";
+            readonly endpoint: "POST /v1beta/properties/{propertyId}:runReport";
+            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 traffic_by_day: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        dimensionValues: z.ZodTuple<[z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        metricValues: z.ZodArray<z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly ga4_traffic_by_source: {
+            readonly shape: "metric";
+            readonly description: "Daily sessions and conversions broken down by acquisition source and medium.";
+            readonly unit: "sessions";
+            readonly granularity: "day";
+            readonly endpoint: "POST /v1beta/properties/{propertyId}:runReport";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample.";
+            }, {
+                readonly name: "sessionSource";
+                readonly description: "Origin of the session (e.g. google, direct, newsletter).";
+            }, {
+                readonly name: "sessionMedium";
+                readonly description: "Acquisition medium of the session (e.g. organic, cpc, referral).";
+            }];
+            readonly responses: {
+                readonly traffic_by_source: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        dimensionValues: z.ZodTuple<[z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        metricValues: z.ZodArray<z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly ga4_top_pages: {
+            readonly shape: "metric";
+            readonly description: "Daily page views and average session duration bucketed by page path.";
+            readonly unit: "page_views";
+            readonly granularity: "day";
+            readonly endpoint: "POST /v1beta/properties/{propertyId}:runReport";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample.";
+            }, {
+                readonly name: "pagePath";
+                readonly description: "URL path of the page that was viewed.";
+            }];
+            readonly responses: {
+                readonly top_pages: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        dimensionValues: z.ZodTuple<[z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        metricValues: z.ZodArray<z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly ga4_events: {
+            readonly shape: "metric";
+            readonly description: "Daily event counts and the users that triggered them, bucketed by event name.";
+            readonly unit: "events";
+            readonly granularity: "day";
+            readonly endpoint: "POST /v1beta/properties/{propertyId}:runReport";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample.";
+            }, {
+                readonly name: "eventName";
+                readonly description: "GA4 event name (e.g. page_view, scroll, click).";
+            }];
+            readonly responses: {
+                readonly events: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        dimensionValues: z.ZodTuple<[z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        metricValues: z.ZodArray<z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly ga4_conversions: {
+            readonly shape: "metric";
+            readonly description: "Daily conversion counts and total revenue bucketed by conversion event name.";
+            readonly unit: "conversions";
+            readonly granularity: "day";
+            readonly endpoint: "POST /v1beta/properties/{propertyId}:runReport";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample.";
+            }, {
+                readonly name: "eventName";
+                readonly description: "GA4 conversion event name (e.g. purchase, generate_lead).";
+            }];
+            readonly responses: {
+                readonly conversions: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        dimensionValues: z.ZodTuple<[z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        metricValues: z.ZodArray<z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+        readonly ga4_geo: {
+            readonly shape: "metric";
+            readonly description: "Daily sessions and total users bucketed by visitor country.";
+            readonly unit: "sessions";
+            readonly granularity: "day";
+            readonly endpoint: "POST /v1beta/properties/{propertyId}:runReport";
+            readonly dimensions: [{
+                readonly name: "date";
+                readonly description: "Calendar day of the metric sample.";
+            }, {
+                readonly name: "country";
+                readonly description: "Country the session originated from.";
+            }];
+            readonly responses: {
+                readonly geo: z.ZodObject<{
+                    rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                        dimensionValues: z.ZodTuple<[z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>, ...z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>[]], null>;
+                        metricValues: z.ZodArray<z.ZodObject<{
+                            value: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>>;
+                }, z.core.$strip>;
+            };
+        };
+    };
     static readonly schemas: {
         readonly oauth_token: z.ZodObject<{
             access_token: z.ZodString;
@@ -71,6 +234,7 @@ declare class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;
+    } & {
         readonly traffic_by_source: z.ZodObject<{
             rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 dimensionValues: z.ZodTuple<[z.ZodObject<{
@@ -81,6 +245,7 @@ declare class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;
+    } & {
         readonly top_pages: z.ZodObject<{
             rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 dimensionValues: z.ZodTuple<[z.ZodObject<{
@@ -91,6 +256,7 @@ declare class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;
+    } & {
         readonly events: z.ZodObject<{
             rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 dimensionValues: z.ZodTuple<[z.ZodObject<{
@@ -101,6 +267,7 @@ declare class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;
+    } & {
         readonly conversions: z.ZodObject<{
             rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 dimensionValues: z.ZodTuple<[z.ZodObject<{
@@ -111,6 +278,7 @@ declare class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;
+    } & {
         readonly geo: z.ZodObject<{
             rows: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 dimensionValues: z.ZodTuple<[z.ZodObject<{
@@ -121,7 +289,7 @@ declare class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
         }, z.core.$strip>;
-    };
+    } & Readonly<Record<string, z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>>;
     static create(input: unknown, ctx?: ConnectorContext): GA4Connector;
     readonly id = "google-analytics";
     readonly credentials: {
@@ -149,4 +317,4 @@ declare class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {
     sync(options: SyncOptions, storage: StorageHandle, signal?: AbortSignal): Promise<SyncResult>;
 }
 
-export { GA4Connector, type GA4Settings, configFields, GA4Connector as default, rowToMetricSample };
+export { GA4Connector, type GA4Settings, configFields, GA4Connector as default, doc, rowToMetricSample };

package/dist/index.js

@@ -1,7 +1,17 @@
+// ../../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-analytics.ts
 import {
   BaseConnector,
-  defineConfigFields
+  defineConfigFields,
+  defineConnectorDoc,
+  defineResources,
+  schemasFromResources
 } from "@rawdash/core";
 import { z } from "zod";
 var configFields = defineConfigFields(
@@ -43,6 +53,30 @@ var configFields = defineConfigFields(
     }
   )
 );
+var doc = defineConnectorDoc({
+  displayName: "Google Analytics",
+  category: "analytics",
+  brandColor: "#E37400",
+  tagline: "Sync daily GA4 traffic, acquisition, top pages, events, conversions, and geography metrics from a Google Analytics 4 property.",
+  vendor: {
+    name: "Google Analytics",
+    apiDocs: "https://developers.google.com/analytics/devguides/reporting/data/v1",
+    website: "https://analytics.google.com"
+  },
+  auth: {
+    summary: "Authenticate against the GA4 Data API with either a Google service account JSON key (recommended) or an OAuth 2.0 refresh-token tuple. The identity must have at least the Analytics Viewer role on the property.",
+    setup: [
+      "Find your GA4 Property ID under Google Analytics -> Admin -> Property settings (numeric, e.g. 123456789).",
+      'Recommended: create a service account at Google Cloud -> IAM & Admin -> Service Accounts, generate a JSON key, and grant it the Analytics Viewer role on the property. Store the JSON as a secret and reference it as serviceAccountJson: secret("GA4_SERVICE_ACCOUNT_JSON").',
+      "Alternative: provide an OAuth 2.0 refresh token with the analytics.readonly scope together with its clientId and clientSecret from the Google Cloud Console."
+    ]
+  },
+  rateLimit: "GA4 Data API quota is 200,000 tokens/day per property (default); 429 responses are retried automatically with exponential backoff.",
+  limitations: [
+    "Incremental syncs use a 30-day window because GA4 can attribute conversions up to 3 days after the session.",
+    "Report pagination is 10,000 rows per page."
+  ]
+});
 var ga4Credentials = {
   serviceAccountJson: {
     description: "Google service account JSON key (base64 or raw JSON)",
@@ -215,8 +249,20 @@ var INCREMENTAL_LOOKBACK_DAYS = 30;
 function getDateRange(options, lookbackDays) {
   const now = Date.now();
   const endDate = toGA4Date(new Date(now));
-  const days = options.mode === "latest" && options.since ? INCREMENTAL_LOOKBACK_DAYS : lookbackDays;
-  const startMs = now - (days - 1) * MS_PER_DAY;
+  if (options.mode === "latest" && options.since) {
+    const startMs2 = now - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY;
+    return { startDate: toGA4Date(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: toGA4Date(new Date(startMs2)), endDate };
+    }
+  }
+  const startMs = now - (lookbackDays - 1) * MS_PER_DAY;
   return { startDate: toGA4Date(new Date(startMs)), endDate };
 }
 function rowToMetricSample(row, dimensionHeaders, metricHeaders, metricName) {
@@ -263,17 +309,105 @@ var tokenResponseSchema = z.object({
   access_token: z.string().min(1),
   expires_in: z.number().int().positive().optional()
 });
+var googleAnalyticsResources = defineResources({
+  ga4_traffic_by_day: {
+    shape: "metric",
+    description: "Daily site traffic totals - sessions, total users, new users, page views, and engagement rate.",
+    unit: "sessions",
+    granularity: "day",
+    endpoint: "POST /v1beta/properties/{propertyId}:runReport",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." }
+    ],
+    responses: {
+      oauth_token: tokenResponseSchema,
+      traffic_by_day: reportSchema(1)
+    }
+  },
+  ga4_traffic_by_source: {
+    shape: "metric",
+    description: "Daily sessions and conversions broken down by acquisition source and medium.",
+    unit: "sessions",
+    granularity: "day",
+    endpoint: "POST /v1beta/properties/{propertyId}:runReport",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." },
+      {
+        name: "sessionSource",
+        description: "Origin of the session (e.g. google, direct, newsletter)."
+      },
+      {
+        name: "sessionMedium",
+        description: "Acquisition medium of the session (e.g. organic, cpc, referral)."
+      }
+    ],
+    responses: { traffic_by_source: reportSchema(3) }
+  },
+  ga4_top_pages: {
+    shape: "metric",
+    description: "Daily page views and average session duration bucketed by page path.",
+    unit: "page_views",
+    granularity: "day",
+    endpoint: "POST /v1beta/properties/{propertyId}:runReport",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." },
+      {
+        name: "pagePath",
+        description: "URL path of the page that was viewed."
+      }
+    ],
+    responses: { top_pages: reportSchema(2) }
+  },
+  ga4_events: {
+    shape: "metric",
+    description: "Daily event counts and the users that triggered them, bucketed by event name.",
+    unit: "events",
+    granularity: "day",
+    endpoint: "POST /v1beta/properties/{propertyId}:runReport",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." },
+      {
+        name: "eventName",
+        description: "GA4 event name (e.g. page_view, scroll, click)."
+      }
+    ],
+    responses: { events: reportSchema(2) }
+  },
+  ga4_conversions: {
+    shape: "metric",
+    description: "Daily conversion counts and total revenue bucketed by conversion event name.",
+    unit: "conversions",
+    granularity: "day",
+    endpoint: "POST /v1beta/properties/{propertyId}:runReport",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." },
+      {
+        name: "eventName",
+        description: "GA4 conversion event name (e.g. purchase, generate_lead)."
+      }
+    ],
+    responses: { conversions: reportSchema(2) }
+  },
+  ga4_geo: {
+    shape: "metric",
+    description: "Daily sessions and total users bucketed by visitor country.",
+    unit: "sessions",
+    granularity: "day",
+    endpoint: "POST /v1beta/properties/{propertyId}:runReport",
+    dimensions: [
+      { name: "date", description: "Calendar day of the metric sample." },
+      {
+        name: "country",
+        description: "Country the session originated from."
+      }
+    ],
+    responses: { geo: reportSchema(2) }
+  }
+});
 var GA4Connector = class _GA4Connector extends BaseConnector {
   static id = "google-analytics";
-  static schemas = {
-    oauth_token: tokenResponseSchema,
-    traffic_by_day: reportSchema(1),
-    traffic_by_source: reportSchema(3),
-    top_pages: reportSchema(2),
-    events: reportSchema(2),
-    conversions: reportSchema(2),
-    geo: reportSchema(2)
-  };
+  static resources = googleAnalyticsResources;
+  static schemas = schemasFromResources(googleAnalyticsResources);
   static create(input, ctx) {
     const parsed = configFields.parse(input);
     return new _GA4Connector(
@@ -351,7 +485,7 @@ var GA4Connector = class _GA4Connector extends BaseConnector {
       headers: {
         Authorization: `Bearer ${accessToken}`,
         "Content-Type": "application/json",
-        "User-Agent": "rawdash/connector-google-analytics (+https://rawdash.dev)"
+        "User-Agent": connectorUserAgent("google-analytics")
       },
       body: JSON.stringify(body),
       signal
@@ -433,6 +567,7 @@ export {
   GA4Connector,
   configFields,
   index_default as default,
+  doc,
   rowToMetricSample
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/google-analytics.ts","../src/index.ts"],"sourcesContent":["import {\n  BaseConnector,\n  type ConnectorContext,\n  type CredentialsSchema,\n  type StorageHandle,\n  type SyncOptions,\n  type SyncResult,\n  defineConfigFields,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\nexport const configFields = defineConfigFields(\n  z\n    .object({\n      propertyId: z\n        .string()\n        .trim()\n        .regex(/^\\d+$/, 'GA4 Property ID must be digits only')\n        .meta({\n          label: 'GA4 Property ID',\n          description:\n            'Numeric ID of your GA4 property (e.g. 123456789). Find it in Google Analytics → Admin → Property settings.',\n          placeholder: '123456789',\n        }),\n      serviceAccountJson: z.object({ $secret: z.string() }).optional().meta({\n        label: 'Service Account JSON (recommended)',\n        description:\n          'Contents of the JSON key file for a Google service account with the Analytics Viewer role. Create one at Google Cloud → IAM & Admin → Service Accounts.',\n        secret: true,\n      }),\n      refreshToken: z.object({ $secret: z.string() }).optional().meta({\n        label: 'OAuth Refresh Token',\n        description:\n          'Google OAuth 2.0 refresh token with analytics.readonly scope. Required if not using serviceAccountJson.',\n        secret: true,\n      }),\n      clientId: z.string().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.object({ $secret: z.string() }).optional().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\n// ---------------------------------------------------------------------------\n// Settings / credentials\n// ---------------------------------------------------------------------------\n\nexport interface GA4Settings {\n  propertyId: string;\n  lookbackDays?: number;\n}\n\nconst ga4Credentials = {\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 GA4Credentials = typeof ga4Credentials;\n\n// ---------------------------------------------------------------------------\n// Sync phases + cursor\n// ---------------------------------------------------------------------------\n\nconst PHASE_ORDER = [\n  'traffic_by_day',\n  'traffic_by_source',\n  'top_pages',\n  'events',\n  'conversions',\n  'geo',\n] as const;\n\ntype GA4Phase = (typeof PHASE_ORDER)[number];\n\ninterface GA4DateRange {\n  startDate: string;\n  endDate: string;\n}\n\ninterface GA4SyncCursor {\n  phase: GA4Phase;\n  // dateRange always populated, even when we abort between phases, so a\n  // resumed run uses the original window for every remaining phase.\n  dateRange: GA4DateRange;\n}\n\nconst GA4_DATE_RE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nfunction isGA4DateString(value: unknown): value is string {\n  return typeof value === 'string' && GA4_DATE_RE.test(value);\n}\n\nfunction isGA4DateRange(value: unknown): value is GA4DateRange {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const v = value as { startDate?: unknown; endDate?: unknown };\n  return isGA4DateString(v.startDate) && isGA4DateString(v.endDate);\n}\n\nfunction isGA4SyncCursor(value: unknown): value is GA4SyncCursor {\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 isGA4DateRange(v.dateRange);\n}\n\n// ---------------------------------------------------------------------------\n// Phase configs — dimensions + metrics for each resource\n// ---------------------------------------------------------------------------\n\ninterface PhaseConfig {\n  dimensions: string[];\n  metrics: string[];\n  metricName: string;\n}\n\nconst PHASE_CONFIGS: Record<GA4Phase, PhaseConfig> = {\n  traffic_by_day: {\n    dimensions: ['date'],\n    metrics: [\n      'sessions',\n      'totalUsers',\n      'newUsers',\n      'screenPageViews',\n      'engagementRate',\n    ],\n    metricName: 'ga4_traffic_by_day',\n  },\n  traffic_by_source: {\n    dimensions: ['date', 'sessionSource', 'sessionMedium'],\n    metrics: ['sessions', 'conversions'],\n    metricName: 'ga4_traffic_by_source',\n  },\n  top_pages: {\n    dimensions: ['date', 'pagePath'],\n    metrics: ['screenPageViews', 'averageSessionDuration'],\n    metricName: 'ga4_top_pages',\n  },\n  events: {\n    dimensions: ['date', 'eventName'],\n    metrics: ['eventCount', 'totalUsers'],\n    metricName: 'ga4_events',\n  },\n  conversions: {\n    dimensions: ['date', 'eventName'],\n    metrics: ['conversions', 'totalRevenue'],\n    metricName: 'ga4_conversions',\n  },\n  geo: {\n    dimensions: ['date', 'country'],\n    metrics: ['sessions', 'totalUsers'],\n    metricName: 'ga4_geo',\n  },\n};\n\nconst ROWS_PER_PAGE = 10_000;\n\n// ---------------------------------------------------------------------------\n// GA4 Data API types\n// ---------------------------------------------------------------------------\n\nexport interface GA4DimensionValue {\n  value: string;\n}\n\nexport interface GA4MetricValue {\n  value: string;\n}\n\nexport interface GA4ReportRow {\n  dimensionValues: GA4DimensionValue[];\n  metricValues: GA4MetricValue[];\n}\n\ninterface GA4ReportResponse {\n  rows?: GA4ReportRow[];\n  rowCount?: number;\n  dimensionHeaders?: Array<{ name: string }>;\n  metricHeaders?: Array<{ name: string; type: 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/analytics.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 toGA4Date(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 ga4DateToMs(ga4Date: string): number {\n  // GA4 dates arrive as 'YYYYMMDD'\n  const y = ga4Date.slice(0, 4);\n  const m = ga4Date.slice(4, 6);\n  const d = ga4Date.slice(6, 8);\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 = 30;\n\nfunction getDateRange(\n  options: SyncOptions,\n  lookbackDays: number,\n): GA4DateRange {\n  const now = Date.now();\n  const endDate = toGA4Date(new Date(now));\n  const days =\n    options.mode === 'latest' && options.since\n      ? INCREMENTAL_LOOKBACK_DAYS\n      : lookbackDays;\n  const startMs = now - (days - 1) * MS_PER_DAY;\n  return { startDate: toGA4Date(new Date(startMs)), endDate };\n}\n\n// ---------------------------------------------------------------------------\n// Row conversion\n// ---------------------------------------------------------------------------\n\nexport function rowToMetricSample(\n  row: GA4ReportRow,\n  dimensionHeaders: string[],\n  metricHeaders: string[],\n  metricName: string,\n): {\n  name: string;\n  ts: number;\n  value: number;\n  attributes: Record<string, string | number>;\n} {\n  const dims: Record<string, string> = {};\n  for (let i = 0; i < dimensionHeaders.length; i++) {\n    dims[dimensionHeaders[i]!] = row.dimensionValues[i]?.value ?? '';\n  }\n\n  const mets: Record<string, number> = {};\n  for (let i = 0; i < metricHeaders.length; i++) {\n    mets[metricHeaders[i]!] =\n      parseFloat(row.metricValues[i]?.value ?? '0') || 0;\n  }\n\n  const dateStr = dims['date'] ?? '19700101';\n  const ts = ga4DateToMs(dateStr);\n  const primaryValue = mets[metricHeaders[0]!] ?? 0;\n\n  return {\n    name: metricName,\n    ts,\n    value: primaryValue,\n    attributes: { ...dims, ...mets },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// GA4Connector\n// ---------------------------------------------------------------------------\n\n// ---------------------------------------------------------------------------\n// Schemas — describe the per-resource API response shape consumed by request()\n// ---------------------------------------------------------------------------\n\nconst dateDimensionValue = z.object({\n  value: z.string().regex(/^(19|20)\\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\\d|3[01])$/),\n});\n\nconst stringDimensionValue = z.object({ value: z.string() });\nconst numericMetricValue = z.object({\n  value: z.string().regex(/^-?\\d+(\\.\\d+)?$/),\n});\n\nfunction reportSchema(dimensionCount: number) {\n  const dims =\n    dimensionCount === 1\n      ? z.tuple([dateDimensionValue])\n      : z.tuple([\n          dateDimensionValue,\n          ...Array(dimensionCount - 1).fill(stringDimensionValue),\n        ] as [typeof dateDimensionValue, ...z.ZodType[]]);\n  return z.object({\n    rows: z\n      .array(\n        z.object({\n          dimensionValues: dims,\n          metricValues: z.array(numericMetricValue).nonempty(),\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\nexport class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {\n  static readonly id = 'google-analytics';\n\n  static readonly schemas = {\n    oauth_token: tokenResponseSchema,\n    traffic_by_day: reportSchema(1),\n    traffic_by_source: reportSchema(3),\n    top_pages: reportSchema(2),\n    events: reportSchema(2),\n    conversions: reportSchema(2),\n    geo: reportSchema(2),\n  } as const;\n\n  static create(input: unknown, ctx?: ConnectorContext): GA4Connector {\n    const parsed = configFields.parse(input);\n    return new GA4Connector(\n      {\n        propertyId: parsed.propertyId,\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-analytics';\n  override readonly credentials = ga4Credentials;\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      'GA4 connector: provide either serviceAccountJson or (refreshToken + clientId + clientSecret)',\n    );\n  }\n\n  private async runReport(\n    accessToken: string,\n    phase: GA4Phase,\n    dateRange: { startDate: string; endDate: string },\n    offset: number,\n    signal?: AbortSignal,\n  ): Promise<GA4ReportResponse> {\n    const { dimensions, metrics } = PHASE_CONFIGS[phase];\n    const url = `https://analyticsdata.googleapis.com/v1beta/properties/${this.settings.propertyId}:runReport`;\n\n    const body: Record<string, unknown> = {\n      dimensions: dimensions.map((name) => ({ name })),\n      metrics: metrics.map((name) => ({ name })),\n      dateRanges: [\n        { startDate: dateRange.startDate, endDate: dateRange.endDate },\n      ],\n      limit: ROWS_PER_PAGE,\n      offset,\n    };\n\n    const res = await this.post<GA4ReportResponse>(url, {\n      resource: phase,\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n        'Content-Type': 'application/json',\n        'User-Agent':\n          'rawdash/connector-google-analytics (+https://rawdash.dev)',\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 = isGA4SyncCursor(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: GA4Phase,\n      offset: number,\n      sig: AbortSignal | undefined,\n    ): Promise<GA4ReportResponse> => {\n      const token = await getToken(sig);\n      try {\n        return await this.runReport(token, phase, dateRange, offset, sig);\n      } catch (err) {\n        console.warn(\n          `[ga4] 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, offset, sig);\n      }\n    };\n\n    const drainPhase = async (phase: GA4Phase): Promise<GA4ReportRow[]> => {\n      const allRows: GA4ReportRow[] = [];\n      let offset = 0;\n      for (;;) {\n        const response = await runReportWithRetry(phase, offset, signal);\n        const rows = response.rows ?? [];\n        allRows.push(...rows);\n        offset += rows.length;\n        if (rows.length === 0) {\n          break;\n        }\n        // Prefer the API's authoritative rowCount when available; fall back\n        // to a short-page heuristic only when GA4 omits it, so a missing\n        // field can't truncate a multi-page dataset to its first page.\n        const done =\n          typeof response.rowCount === 'number'\n            ? offset >= response.rowCount\n            : rows.length < ROWS_PER_PAGE;\n        if (done) {\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: GA4ReportRow[];\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.metrics, 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 { GA4Connector } from './google-analytics';\n\nexport {\n  configFields,\n  GA4Connector,\n  rowToMetricSample,\n} from './google-analytics';\nexport type { GA4Settings } from './google-analytics';\nexport default GA4Connector;\n"],"mappings":"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","names":[]}
+{"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-analytics.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      propertyId: z\n        .string()\n        .trim()\n        .regex(/^\\d+$/, 'GA4 Property ID must be digits only')\n        .meta({\n          label: 'GA4 Property ID',\n          description:\n            'Numeric ID of your GA4 property (e.g. 123456789). Find it in Google Analytics → Admin → Property settings.',\n          placeholder: '123456789',\n        }),\n      serviceAccountJson: z.object({ $secret: z.string() }).optional().meta({\n        label: 'Service Account JSON (recommended)',\n        description:\n          'Contents of the JSON key file for a Google service account with the Analytics Viewer role. Create one at Google Cloud → IAM & Admin → Service Accounts.',\n        secret: true,\n      }),\n      refreshToken: z.object({ $secret: z.string() }).optional().meta({\n        label: 'OAuth Refresh Token',\n        description:\n          'Google OAuth 2.0 refresh token with analytics.readonly scope. Required if not using serviceAccountJson.',\n        secret: true,\n      }),\n      clientId: z.string().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.object({ $secret: z.string() }).optional().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 Analytics',\n  category: 'analytics',\n  brandColor: '#E37400',\n  tagline:\n    'Sync daily GA4 traffic, acquisition, top pages, events, conversions, and geography metrics from a Google Analytics 4 property.',\n  vendor: {\n    name: 'Google Analytics',\n    apiDocs:\n      'https://developers.google.com/analytics/devguides/reporting/data/v1',\n    website: 'https://analytics.google.com',\n  },\n  auth: {\n    summary:\n      'Authenticate against the GA4 Data API with either a Google service account JSON key (recommended) or an OAuth 2.0 refresh-token tuple. The identity must have at least the Analytics Viewer role on the property.',\n    setup: [\n      'Find your GA4 Property ID under Google Analytics -> Admin -> Property settings (numeric, e.g. 123456789).',\n      'Recommended: create a service account at Google Cloud -> IAM & Admin -> Service Accounts, generate a JSON key, and grant it the Analytics Viewer role on the property. Store the JSON as a secret and reference it as serviceAccountJson: secret(\"GA4_SERVICE_ACCOUNT_JSON\").',\n      'Alternative: provide an OAuth 2.0 refresh token with the analytics.readonly scope together with its clientId and clientSecret from the Google Cloud Console.',\n    ],\n  },\n  rateLimit:\n    'GA4 Data API quota is 200,000 tokens/day per property (default); 429 responses are retried automatically with exponential backoff.',\n  limitations: [\n    'Incremental syncs use a 30-day window because GA4 can attribute conversions up to 3 days after the session.',\n    'Report pagination is 10,000 rows per page.',\n  ],\n});\n\n// ---------------------------------------------------------------------------\n// Settings / credentials\n// ---------------------------------------------------------------------------\n\nexport interface GA4Settings {\n  propertyId: string;\n  lookbackDays?: number;\n}\n\nconst ga4Credentials = {\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 GA4Credentials = typeof ga4Credentials;\n\n// ---------------------------------------------------------------------------\n// Sync phases + cursor\n// ---------------------------------------------------------------------------\n\nconst PHASE_ORDER = [\n  'traffic_by_day',\n  'traffic_by_source',\n  'top_pages',\n  'events',\n  'conversions',\n  'geo',\n] as const;\n\ntype GA4Phase = (typeof PHASE_ORDER)[number];\n\ninterface GA4DateRange {\n  startDate: string;\n  endDate: string;\n}\n\ninterface GA4SyncCursor {\n  phase: GA4Phase;\n  // dateRange always populated, even when we abort between phases, so a\n  // resumed run uses the original window for every remaining phase.\n  dateRange: GA4DateRange;\n}\n\nconst GA4_DATE_RE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nfunction isGA4DateString(value: unknown): value is string {\n  return typeof value === 'string' && GA4_DATE_RE.test(value);\n}\n\nfunction isGA4DateRange(value: unknown): value is GA4DateRange {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const v = value as { startDate?: unknown; endDate?: unknown };\n  return isGA4DateString(v.startDate) && isGA4DateString(v.endDate);\n}\n\nfunction isGA4SyncCursor(value: unknown): value is GA4SyncCursor {\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 isGA4DateRange(v.dateRange);\n}\n\n// ---------------------------------------------------------------------------\n// Phase configs — dimensions + metrics for each resource\n// ---------------------------------------------------------------------------\n\ninterface PhaseConfig {\n  dimensions: string[];\n  metrics: string[];\n  metricName: string;\n}\n\nconst PHASE_CONFIGS: Record<GA4Phase, PhaseConfig> = {\n  traffic_by_day: {\n    dimensions: ['date'],\n    metrics: [\n      'sessions',\n      'totalUsers',\n      'newUsers',\n      'screenPageViews',\n      'engagementRate',\n    ],\n    metricName: 'ga4_traffic_by_day',\n  },\n  traffic_by_source: {\n    dimensions: ['date', 'sessionSource', 'sessionMedium'],\n    metrics: ['sessions', 'conversions'],\n    metricName: 'ga4_traffic_by_source',\n  },\n  top_pages: {\n    dimensions: ['date', 'pagePath'],\n    metrics: ['screenPageViews', 'averageSessionDuration'],\n    metricName: 'ga4_top_pages',\n  },\n  events: {\n    dimensions: ['date', 'eventName'],\n    metrics: ['eventCount', 'totalUsers'],\n    metricName: 'ga4_events',\n  },\n  conversions: {\n    dimensions: ['date', 'eventName'],\n    metrics: ['conversions', 'totalRevenue'],\n    metricName: 'ga4_conversions',\n  },\n  geo: {\n    dimensions: ['date', 'country'],\n    metrics: ['sessions', 'totalUsers'],\n    metricName: 'ga4_geo',\n  },\n};\n\nconst ROWS_PER_PAGE = 10_000;\n\n// ---------------------------------------------------------------------------\n// GA4 Data API types\n// ---------------------------------------------------------------------------\n\nexport interface GA4DimensionValue {\n  value: string;\n}\n\nexport interface GA4MetricValue {\n  value: string;\n}\n\nexport interface GA4ReportRow {\n  dimensionValues: GA4DimensionValue[];\n  metricValues: GA4MetricValue[];\n}\n\ninterface GA4ReportResponse {\n  rows?: GA4ReportRow[];\n  rowCount?: number;\n  dimensionHeaders?: Array<{ name: string }>;\n  metricHeaders?: Array<{ name: string; type: 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/analytics.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 toGA4Date(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 ga4DateToMs(ga4Date: string): number {\n  // GA4 dates arrive as 'YYYYMMDD'\n  const y = ga4Date.slice(0, 4);\n  const m = ga4Date.slice(4, 6);\n  const d = ga4Date.slice(6, 8);\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 = 30;\n\nfunction getDateRange(\n  options: SyncOptions,\n  lookbackDays: number,\n): GA4DateRange {\n  const now = Date.now();\n  const endDate = toGA4Date(new Date(now));\n  if (options.mode === 'latest' && options.since) {\n    const startMs = now - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY;\n    return { startDate: toGA4Date(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: toGA4Date(new Date(startMs)), endDate };\n    }\n  }\n  const startMs = now - (lookbackDays - 1) * MS_PER_DAY;\n  return { startDate: toGA4Date(new Date(startMs)), endDate };\n}\n\n// ---------------------------------------------------------------------------\n// Row conversion\n// ---------------------------------------------------------------------------\n\nexport function rowToMetricSample(\n  row: GA4ReportRow,\n  dimensionHeaders: string[],\n  metricHeaders: string[],\n  metricName: string,\n): {\n  name: string;\n  ts: number;\n  value: number;\n  attributes: Record<string, string | number>;\n} {\n  const dims: Record<string, string> = {};\n  for (let i = 0; i < dimensionHeaders.length; i++) {\n    dims[dimensionHeaders[i]!] = row.dimensionValues[i]?.value ?? '';\n  }\n\n  const mets: Record<string, number> = {};\n  for (let i = 0; i < metricHeaders.length; i++) {\n    mets[metricHeaders[i]!] =\n      parseFloat(row.metricValues[i]?.value ?? '0') || 0;\n  }\n\n  const dateStr = dims['date'] ?? '19700101';\n  const ts = ga4DateToMs(dateStr);\n  const primaryValue = mets[metricHeaders[0]!] ?? 0;\n\n  return {\n    name: metricName,\n    ts,\n    value: primaryValue,\n    attributes: { ...dims, ...mets },\n  };\n}\n\n// ---------------------------------------------------------------------------\n// GA4Connector\n// ---------------------------------------------------------------------------\n\n// ---------------------------------------------------------------------------\n// Schemas — describe the per-resource API response shape consumed by request()\n// ---------------------------------------------------------------------------\n\nconst dateDimensionValue = z.object({\n  value: z.string().regex(/^(19|20)\\d{2}(0[1-9]|1[0-2])(0[1-9]|[12]\\d|3[01])$/),\n});\n\nconst stringDimensionValue = z.object({ value: z.string() });\nconst numericMetricValue = z.object({\n  value: z.string().regex(/^-?\\d+(\\.\\d+)?$/),\n});\n\nfunction reportSchema(dimensionCount: number) {\n  const dims =\n    dimensionCount === 1\n      ? z.tuple([dateDimensionValue])\n      : z.tuple([\n          dateDimensionValue,\n          ...Array(dimensionCount - 1).fill(stringDimensionValue),\n        ] as [typeof dateDimensionValue, ...z.ZodType[]]);\n  return z.object({\n    rows: z\n      .array(\n        z.object({\n          dimensionValues: dims,\n          metricValues: z.array(numericMetricValue).nonempty(),\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 googleAnalyticsResources = defineResources({\n  ga4_traffic_by_day: {\n    shape: 'metric',\n    description:\n      'Daily site traffic totals - sessions, total users, new users, page views, and engagement rate.',\n    unit: 'sessions',\n    granularity: 'day',\n    endpoint: 'POST /v1beta/properties/{propertyId}:runReport',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n    ],\n    responses: {\n      oauth_token: tokenResponseSchema,\n      traffic_by_day: reportSchema(1),\n    },\n  },\n  ga4_traffic_by_source: {\n    shape: 'metric',\n    description:\n      'Daily sessions and conversions broken down by acquisition source and medium.',\n    unit: 'sessions',\n    granularity: 'day',\n    endpoint: 'POST /v1beta/properties/{propertyId}:runReport',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n      {\n        name: 'sessionSource',\n        description: 'Origin of the session (e.g. google, direct, newsletter).',\n      },\n      {\n        name: 'sessionMedium',\n        description:\n          'Acquisition medium of the session (e.g. organic, cpc, referral).',\n      },\n    ],\n    responses: { traffic_by_source: reportSchema(3) },\n  },\n  ga4_top_pages: {\n    shape: 'metric',\n    description:\n      'Daily page views and average session duration bucketed by page path.',\n    unit: 'page_views',\n    granularity: 'day',\n    endpoint: 'POST /v1beta/properties/{propertyId}:runReport',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n      {\n        name: 'pagePath',\n        description: 'URL path of the page that was viewed.',\n      },\n    ],\n    responses: { top_pages: reportSchema(2) },\n  },\n  ga4_events: {\n    shape: 'metric',\n    description:\n      'Daily event counts and the users that triggered them, bucketed by event name.',\n    unit: 'events',\n    granularity: 'day',\n    endpoint: 'POST /v1beta/properties/{propertyId}:runReport',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n      {\n        name: 'eventName',\n        description: 'GA4 event name (e.g. page_view, scroll, click).',\n      },\n    ],\n    responses: { events: reportSchema(2) },\n  },\n  ga4_conversions: {\n    shape: 'metric',\n    description:\n      'Daily conversion counts and total revenue bucketed by conversion event name.',\n    unit: 'conversions',\n    granularity: 'day',\n    endpoint: 'POST /v1beta/properties/{propertyId}:runReport',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n      {\n        name: 'eventName',\n        description:\n          'GA4 conversion event name (e.g. purchase, generate_lead).',\n      },\n    ],\n    responses: { conversions: reportSchema(2) },\n  },\n  ga4_geo: {\n    shape: 'metric',\n    description: 'Daily sessions and total users bucketed by visitor country.',\n    unit: 'sessions',\n    granularity: 'day',\n    endpoint: 'POST /v1beta/properties/{propertyId}:runReport',\n    dimensions: [\n      { name: 'date', description: 'Calendar day of the metric sample.' },\n      {\n        name: 'country',\n        description: 'Country the session originated from.',\n      },\n    ],\n    responses: { geo: reportSchema(2) },\n  },\n});\n\nexport class GA4Connector extends BaseConnector<GA4Settings, GA4Credentials> {\n  static readonly id = 'google-analytics';\n\n  static readonly resources = googleAnalyticsResources;\n\n  static readonly schemas = schemasFromResources(googleAnalyticsResources);\n\n  static create(input: unknown, ctx?: ConnectorContext): GA4Connector {\n    const parsed = configFields.parse(input);\n    return new GA4Connector(\n      {\n        propertyId: parsed.propertyId,\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-analytics';\n  override readonly credentials = ga4Credentials;\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      'GA4 connector: provide either serviceAccountJson or (refreshToken + clientId + clientSecret)',\n    );\n  }\n\n  private async runReport(\n    accessToken: string,\n    phase: GA4Phase,\n    dateRange: { startDate: string; endDate: string },\n    offset: number,\n    signal?: AbortSignal,\n  ): Promise<GA4ReportResponse> {\n    const { dimensions, metrics } = PHASE_CONFIGS[phase];\n    const url = `https://analyticsdata.googleapis.com/v1beta/properties/${this.settings.propertyId}:runReport`;\n\n    const body: Record<string, unknown> = {\n      dimensions: dimensions.map((name) => ({ name })),\n      metrics: metrics.map((name) => ({ name })),\n      dateRanges: [\n        { startDate: dateRange.startDate, endDate: dateRange.endDate },\n      ],\n      limit: ROWS_PER_PAGE,\n      offset,\n    };\n\n    const res = await this.post<GA4ReportResponse>(url, {\n      resource: phase,\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n        'Content-Type': 'application/json',\n        'User-Agent': connectorUserAgent('google-analytics'),\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 = isGA4SyncCursor(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: GA4Phase,\n      offset: number,\n      sig: AbortSignal | undefined,\n    ): Promise<GA4ReportResponse> => {\n      const token = await getToken(sig);\n      try {\n        return await this.runReport(token, phase, dateRange, offset, sig);\n      } catch (err) {\n        console.warn(\n          `[ga4] 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, offset, sig);\n      }\n    };\n\n    const drainPhase = async (phase: GA4Phase): Promise<GA4ReportRow[]> => {\n      const allRows: GA4ReportRow[] = [];\n      let offset = 0;\n      for (;;) {\n        const response = await runReportWithRetry(phase, offset, signal);\n        const rows = response.rows ?? [];\n        allRows.push(...rows);\n        offset += rows.length;\n        if (rows.length === 0) {\n          break;\n        }\n        // Prefer the API's authoritative rowCount when available; fall back\n        // to a short-page heuristic only when GA4 omits it, so a missing\n        // field can't truncate a multi-page dataset to its first page.\n        const done =\n          typeof response.rowCount === 'number'\n            ? offset >= response.rowCount\n            : rows.length < ROWS_PER_PAGE;\n        if (done) {\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: GA4ReportRow[];\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.metrics, 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 { GA4Connector } from './google-analytics';\n\nexport {\n  configFields,\n  doc,\n  GA4Connector,\n  rowToMetricSample,\n} from './google-analytics';\nexport type { GA4Settings } from './google-analytics';\nexport default GA4Connector;\n"],"mappings":"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","names":["startMs"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rawdash/connector-google-analytics",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Rawdash connector for Google Analytics 4 — syncs traffic, sources, pages, events, conversions, and geo data into the six-shape storage model",
   "license": "Apache-2.0",
   "type": "module",
@@ -23,15 +23,15 @@
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@rawdash/core": "0.15.0"
+    "@rawdash/core": "0.16.0"
   },
   "devDependencies": {
     "fast-check": "^4.8.0",
     "tsup": "^8.0.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.4",
-    "@rawdash/connector-shared": "0.2.0",
-    "@rawdash/connector-test-utils": "0.0.2"
+    "@rawdash/connector-shared": "0.3.0",
+    "@rawdash/connector-test-utils": "0.0.3"
   },
   "scripts": {
     "build": "tsup",