@rawdash/connector-google-ads 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +131 -0
  2. package/dist/index.d.ts +498 -0
  3. package/dist/index.js +703 -0
  4. package/dist/index.js.map +1 -0
  5. package/package.json +42 -0
package/dist/index.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../connector-shared/src/errors.ts","../../../connector-shared/src/retry.ts","../../../connector-shared/src/version.ts","../../../connector-shared/src/request.ts","../../../connector-shared/src/rate-limit.ts","../../../connector-shared/src/sanitize.ts","../../../connector-shared/src/epoch.ts","../../../connector-shared/src/pagination.ts","../../../connector-shared/src/logger.ts","../src/google-ads.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 makeChunkedCursorGuard,\n paginateChunked,\n schemasFromResources,\n selectActivePhases,\n} from '@rawdash/core';\nimport { z } from 'zod';\n\n// ---------------------------------------------------------------------------\n// configFields / doc\n// ---------------------------------------------------------------------------\n\nexport const configFields = defineConfigFields(\n z.object({\n customerId: z\n .string()\n .trim()\n .regex(\n /^\\d{10}$/,\n 'customerId must be the 10-digit Google Ads ID, digits only (no dashes)',\n )\n .meta({\n label: 'Customer ID',\n description:\n 'Google Ads customer ID for the account to sync, digits only (the dashed form 123-456-7890 with the dashes removed).',\n placeholder: '1234567890',\n }),\n loginCustomerId: z\n .string()\n .trim()\n .regex(\n /^\\d{10}$/,\n 'loginCustomerId must be a 10-digit Google Ads ID, digits only',\n )\n .optional()\n .meta({\n label: 'Login Customer ID (MCC)',\n description:\n 'Manager (MCC) account ID, digits only. Set this when the OAuth credential authenticates against an MCC that owns the customer account.',\n placeholder: '1234567890',\n }),\n clientId: z.string().min(1).meta({\n label: 'OAuth Client ID',\n description:\n 'OAuth 2.0 client ID from a Google Cloud project that has the Google Ads API enabled.',\n placeholder: '…apps.googleusercontent.com',\n }),\n clientSecret: z.object({ $secret: z.string() }).meta({\n label: 'OAuth Client Secret',\n description: 'OAuth 2.0 client secret paired with the client ID above.',\n secret: true,\n }),\n refreshToken: z.object({ $secret: z.string() }).meta({\n label: 'OAuth Refresh Token',\n description:\n 'Google OAuth 2.0 refresh token issued for the https://www.googleapis.com/auth/adwords scope.',\n secret: true,\n }),\n developerToken: z.object({ $secret: z.string() }).meta({\n label: 'Developer Token',\n description:\n 'Google Ads API developer token from the manager account that owns API access (Tools → API Center).',\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 of metric history to fetch on a full sync. Defaults to 90.',\n placeholder: '90',\n }),\n resources: z\n .array(\n z.enum([\n 'campaigns',\n 'campaign_metrics',\n 'ad_group_metrics',\n 'keyword_metrics',\n ]),\n )\n .nonempty()\n .optional()\n .meta({\n label: 'Resources',\n description:\n 'Which Google Ads resources to sync. Omit to sync everything; pin a subset to avoid pulling keyword-level metrics on a quota-limited token.',\n }),\n }),\n);\n\nexport const doc: ConnectorDoc = defineConnectorDoc({\n displayName: 'Google Ads',\n category: 'marketing',\n brandColor: '#4285F4',\n tagline:\n 'Sync Google Ads campaigns plus daily campaign, ad-group, and keyword performance (impressions, clicks, cost, conversions) via GAQL.',\n vendor: {\n name: 'Google Ads',\n apiDocs: 'https://developers.google.com/google-ads/api/docs/start',\n website: 'https://ads.google.com',\n },\n auth: {\n summary:\n 'OAuth 2.0 refresh token against an account with read access to the Google Ads customer, plus a developer token from the manager account that owns API access.',\n setup: [\n 'Apply for Google Ads API access from your manager account (Tools → API Center). Copy the developer token - it lives on the manager, not the child account.',\n 'In Google Cloud Console, enable the Google Ads API on a project, create an OAuth 2.0 client ID, and complete the OAuth consent flow for the adwords scope to obtain a refresh token. The official walkthrough is at https://developers.google.com/google-ads/api/docs/oauth/overview.',\n 'Find the Google Ads customer ID at the top of the Ads UI (e.g. 123-456-7890) and store it without dashes (e.g. 1234567890).',\n 'If the OAuth credential authenticates against an MCC that owns the customer, set `loginCustomerId` to the MCC id (digits only). For a direct-access account, omit it.',\n 'Store the client secret, refresh token, and developer token as secrets, then reference them as `clientSecret: secret(\"GADS_CLIENT_SECRET\")`, `refreshToken: secret(\"GADS_REFRESH_TOKEN\")`, and `developerToken: secret(\"GADS_DEVELOPER_TOKEN\")`.',\n ],\n },\n rateLimit:\n 'Google Ads API basic-access tokens get a 15,000 operations / day quota per developer token; the connector treats 429 (RESOURCE_EXHAUSTED) as a transient error and the host backs off.',\n limitations: [\n 'Cost values are stored in account currency units (cost_micros ÷ 1,000,000); the original micro-precision integer is also exposed in attributes.',\n 'Keyword metrics use the historical (per-day) quality score from `metrics.historical_quality_score`; criteria with no impressions on a day will report a null quality score.',\n 'Incremental syncs trail the last 3 days because Google Ads can attribute conversions to a click up to 3 days after the event.',\n 'Audience-, asset-, and recommendation-level reporting are out of scope; this connector covers campaign / ad-group / keyword performance only.',\n ],\n});\n\n// ---------------------------------------------------------------------------\n// Settings / credentials\n// ---------------------------------------------------------------------------\n\nexport interface GoogleAdsSettings {\n customerId: string;\n loginCustomerId?: string;\n lookbackDays?: number;\n resources?: readonly GoogleAdsResource[];\n}\n\nconst googleAdsCredentials = {\n clientId: {\n description: 'Google OAuth 2.0 client ID (public, not a secret)',\n auth: 'required' as const,\n },\n clientSecret: {\n description: 'Google OAuth 2.0 client secret',\n auth: 'required' as const,\n },\n refreshToken: {\n description: 'Google OAuth 2.0 refresh token with the adwords scope',\n auth: 'required' as const,\n },\n developerToken: {\n description: 'Google Ads API developer token',\n auth: 'required' as const,\n },\n} satisfies CredentialsSchema;\n\ntype GoogleAdsCredentials = typeof googleAdsCredentials;\n\n// ---------------------------------------------------------------------------\n// Sync phases + cursor\n// ---------------------------------------------------------------------------\n\nconst PHASE_ORDER = [\n 'campaigns',\n 'campaign_metrics',\n 'ad_group_metrics',\n 'keyword_metrics',\n] as const;\n\ntype GoogleAdsPhase = (typeof PHASE_ORDER)[number];\n\nexport type GoogleAdsResource = GoogleAdsPhase;\n\nconst isGoogleAdsSyncCursor = makeChunkedCursorGuard(PHASE_ORDER);\n\nconst API_VERSION = 'v18';\nconst PAGE_SIZE = 10_000;\nconst MS_PER_DAY = 24 * 60 * 60 * 1000;\nconst DEFAULT_LOOKBACK_DAYS = 90;\nconst INCREMENTAL_LOOKBACK_DAYS = 3;\nconst MICROS_PER_UNIT = 1_000_000;\nconst TOKEN_URL = 'https://oauth2.googleapis.com/token';\n\nconst ENTITY_TYPE_CAMPAIGN = 'google_ads_campaign';\nconst METRIC_NAME: Record<GoogleAdsPhase, string> = {\n campaigns: ENTITY_TYPE_CAMPAIGN,\n campaign_metrics: 'google_ads_campaign_metrics',\n ad_group_metrics: 'google_ads_ad_group_metrics',\n keyword_metrics: 'google_ads_keyword_metrics',\n};\n\n// ---------------------------------------------------------------------------\n// Google Ads API response shapes (GAQL search)\n// ---------------------------------------------------------------------------\n\n// INT64 fields come back as JSON strings; everything else may be string|number\n// depending on the field. We coerce in the writers. Empty strings aren't a\n// valid representation of any numeric value upstream, so the schema rejects\n// them - that also keeps fast-check from generating zero-length entity ids.\nconst int64String = z.union([z.string().min(1), z.number()]);\n\nconst segmentsSchema = z.object({\n date: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/),\n});\n\nconst dateString = z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/);\n\nconst campaignFieldsSchema = z.object({\n id: int64String,\n name: z.string().nullish(),\n status: z.string().nullish(),\n biddingStrategyType: z.string().nullish(),\n startDate: dateString.nullish(),\n endDate: dateString.nullish(),\n resourceName: z.string().nullish(),\n});\n\nconst metricsSchema = z.object({\n impressions: int64String.nullish(),\n clicks: int64String.nullish(),\n costMicros: int64String.nullish(),\n conversions: z.number().nullish(),\n conversionsValue: z.number().nullish(),\n historicalQualityScore: int64String.nullish(),\n});\n\nconst campaignRowSchema = z.object({\n campaign: campaignFieldsSchema,\n});\n\nconst campaignMetricRowSchema = z.object({\n segments: segmentsSchema,\n campaign: z.object({\n id: int64String,\n name: z.string().nullish(),\n resourceName: z.string().nullish(),\n }),\n metrics: metricsSchema,\n});\n\nconst adGroupMetricRowSchema = z.object({\n segments: segmentsSchema,\n campaign: z.object({ id: int64String }).nullish(),\n adGroup: z.object({\n id: int64String,\n name: z.string().nullish(),\n resourceName: z.string().nullish(),\n }),\n metrics: metricsSchema,\n});\n\nconst keywordMetricRowSchema = z.object({\n segments: segmentsSchema,\n adGroup: z.object({ id: int64String }).nullish(),\n adGroupCriterion: z.object({\n criterionId: int64String,\n keyword: z\n .object({\n text: z.string().nullish(),\n matchType: z.string().nullish(),\n })\n .nullish(),\n resourceName: z.string().nullish(),\n }),\n metrics: metricsSchema,\n});\n\nconst campaignsResponseSchema = z.array(campaignRowSchema);\nconst campaignMetricsResponseSchema = z.array(campaignMetricRowSchema);\nconst adGroupMetricsResponseSchema = z.array(adGroupMetricRowSchema);\nconst keywordMetricsResponseSchema = z.array(keywordMetricRowSchema);\n\ntype CampaignRow = z.infer<typeof campaignRowSchema>;\ntype CampaignMetricRow = z.infer<typeof campaignMetricRowSchema>;\ntype AdGroupMetricRow = z.infer<typeof adGroupMetricRowSchema>;\ntype KeywordMetricRow = z.infer<typeof keywordMetricRowSchema>;\n\nconst googleAdsResources = defineResources({\n [ENTITY_TYPE_CAMPAIGN]: {\n shape: 'entity',\n description:\n 'Google Ads campaigns with id, name, status, bidding strategy type, and start / end dates.',\n endpoint: 'POST /v18/customers/{customerId}/googleAds:search',\n fields: [\n { name: 'id', description: 'Numeric Google Ads campaign id.' },\n { name: 'name', description: 'Campaign display name.' },\n {\n name: 'status',\n description:\n 'Campaign status (ENABLED, PAUSED, REMOVED, UNKNOWN, UNSPECIFIED).',\n },\n {\n name: 'biddingStrategyType',\n description:\n 'Bidding strategy in use (e.g. MAXIMIZE_CONVERSIONS, MANUAL_CPC).',\n },\n { name: 'startDate', description: 'Campaign start date (YYYY-MM-DD).' },\n {\n name: 'endDate',\n description: 'Campaign end date (YYYY-MM-DD), if set.',\n },\n ],\n responses: {\n oauth_token: z.object({\n access_token: z.string().min(1),\n expires_in: z.number().int().positive().optional(),\n }),\n campaigns: campaignsResponseSchema,\n },\n },\n google_ads_campaign_metrics: {\n shape: 'metric',\n description:\n 'Daily campaign performance - impressions, clicks, cost, conversions, and conversion value per (date, campaignId).',\n endpoint: 'POST /v18/customers/{customerId}/googleAds:search',\n unit: 'cost',\n granularity: 'day',\n dimensions: [\n { name: 'date', description: 'Calendar day of the metric sample.' },\n { name: 'campaignId', description: 'Numeric Google Ads campaign id.' },\n {\n name: 'campaignName',\n description: 'Campaign display name at sync time.',\n },\n { name: 'impressions', description: 'Ad impressions served on the day.' },\n { name: 'clicks', description: 'Clicks recorded on the day.' },\n {\n name: 'cost',\n description:\n 'Cost in account currency units (cost_micros ÷ 1,000,000).',\n },\n {\n name: 'costMicros',\n description: 'Raw cost in micros, as returned by the API.',\n },\n {\n name: 'conversions',\n description: 'Counted conversions attributed to the day.',\n },\n {\n name: 'conversionsValue',\n description: 'Total value of conversions for the day.',\n },\n ],\n notes:\n 'Sample value is `cost` (account currency units). All other fields are mirrored in attributes for filtering and ratio metrics (CPA = cost / conversions, ROAS = conversionsValue / cost).',\n responses: { campaign_metrics: campaignMetricsResponseSchema },\n },\n google_ads_ad_group_metrics: {\n shape: 'metric',\n description:\n 'Daily ad-group performance - impressions, clicks, cost, and conversions per (date, adGroupId).',\n endpoint: 'POST /v18/customers/{customerId}/googleAds:search',\n unit: 'cost',\n granularity: 'day',\n dimensions: [\n { name: 'date', description: 'Calendar day of the metric sample.' },\n { name: 'adGroupId', description: 'Numeric Google Ads ad-group id.' },\n {\n name: 'adGroupName',\n description: 'Ad-group display name at sync time.',\n },\n { name: 'campaignId', description: 'Parent campaign id.' },\n { name: 'impressions', description: 'Ad impressions served on the day.' },\n { name: 'clicks', description: 'Clicks recorded on the day.' },\n { name: 'cost', description: 'Cost in account currency units.' },\n {\n name: 'costMicros',\n description: 'Raw cost in micros, as returned by the API.',\n },\n {\n name: 'conversions',\n description: 'Counted conversions attributed to the day.',\n },\n ],\n responses: { ad_group_metrics: adGroupMetricsResponseSchema },\n },\n google_ads_keyword_metrics: {\n shape: 'metric',\n description:\n 'Daily keyword performance - impressions, clicks, cost, and historical quality score per (date, criterionId).',\n endpoint: 'POST /v18/customers/{customerId}/googleAds:search',\n unit: 'cost',\n granularity: 'day',\n dimensions: [\n { name: 'date', description: 'Calendar day of the metric sample.' },\n {\n name: 'criterionId',\n description: 'Numeric keyword (ad-group criterion) id.',\n },\n { name: 'keywordText', description: 'Keyword text.' },\n {\n name: 'matchType',\n description: 'Match type (EXACT, PHRASE, BROAD, …).',\n },\n { name: 'adGroupId', description: 'Parent ad-group id.' },\n { name: 'impressions', description: 'Ad impressions served on the day.' },\n { name: 'clicks', description: 'Clicks recorded on the day.' },\n { name: 'cost', description: 'Cost in account currency units.' },\n {\n name: 'costMicros',\n description: 'Raw cost in micros, as returned by the API.',\n },\n {\n name: 'qualityScore',\n description:\n 'Historical quality score for the day (1-10), null when no impressions.',\n },\n ],\n notes:\n 'Driven by `keyword_view`; the cost / impression columns roll up to the criterion-day pair.',\n responses: { keyword_metrics: keywordMetricsResponseSchema },\n },\n});\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction toDateString(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\nconst DATE_RE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\n\nfunction dateStringToMs(yyyyMmDd: string): number {\n // Reject anything that doesn't match YYYY-MM-DD so a surprise upstream\n // value (e.g. an empty string or a malformed date) doesn't write NaN into\n // entity.updated_at / metric.ts.\n const m = DATE_RE.exec(yyyyMmDd);\n if (!m) {\n return 0;\n }\n const ms = Date.UTC(Number(m[1]), Number(m[2]) - 1, Number(m[3]));\n return Number.isFinite(ms) ? ms : 0;\n}\n\ninterface DateRange {\n startDate: string;\n endDate: string;\n}\n\nexport function getDateRange(\n options: SyncOptions,\n lookbackDays: number,\n now: number = Date.now(),\n): DateRange {\n const endDate = toDateString(new Date(now));\n if (options.mode === 'latest') {\n const startMs = now - (INCREMENTAL_LOOKBACK_DAYS - 1) * MS_PER_DAY;\n return { startDate: toDateString(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: toDateString(new Date(startMs)), endDate };\n }\n }\n const startMs = now - (lookbackDays - 1) * MS_PER_DAY;\n return { startDate: toDateString(new Date(startMs)), endDate };\n}\n\nfunction coerceInt(value: unknown): number {\n if (typeof value === 'number') {\n return Number.isFinite(value) ? value : 0;\n }\n if (typeof value === 'string' && value !== '') {\n const n = Number(value);\n return Number.isFinite(n) ? n : 0;\n }\n return 0;\n}\n\nfunction coerceIntOrNull(value: unknown): number | null {\n if (value === null || value === undefined) {\n return null;\n }\n const n = coerceInt(value);\n return n;\n}\n\nfunction microsToUnits(micros: unknown): number {\n return coerceInt(micros) / MICROS_PER_UNIT;\n}\n\n// ---------------------------------------------------------------------------\n// GAQL queries - one per phase. Date ranges are interpolated, not parameterised\n// (GAQL has no bind variables); range bounds are server-side string literals.\n// ---------------------------------------------------------------------------\n\nfunction campaignsQuery(): string {\n return [\n 'SELECT',\n ' campaign.id,',\n ' campaign.name,',\n ' campaign.status,',\n ' campaign.bidding_strategy_type,',\n ' campaign.start_date,',\n ' campaign.end_date',\n 'FROM campaign',\n ].join(' ');\n}\n\nfunction campaignMetricsQuery(range: DateRange): string {\n return [\n 'SELECT',\n ' segments.date,',\n ' campaign.id,',\n ' campaign.name,',\n ' metrics.impressions,',\n ' metrics.clicks,',\n ' metrics.cost_micros,',\n ' metrics.conversions,',\n ' metrics.conversions_value',\n 'FROM campaign',\n `WHERE segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'`,\n ].join(' ');\n}\n\nfunction adGroupMetricsQuery(range: DateRange): string {\n return [\n 'SELECT',\n ' segments.date,',\n ' campaign.id,',\n ' ad_group.id,',\n ' ad_group.name,',\n ' metrics.impressions,',\n ' metrics.clicks,',\n ' metrics.cost_micros,',\n ' metrics.conversions',\n 'FROM ad_group',\n `WHERE segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'`,\n ].join(' ');\n}\n\nfunction keywordMetricsQuery(range: DateRange): string {\n return [\n 'SELECT',\n ' segments.date,',\n ' ad_group.id,',\n ' ad_group_criterion.criterion_id,',\n ' ad_group_criterion.keyword.text,',\n ' ad_group_criterion.keyword.match_type,',\n ' metrics.impressions,',\n ' metrics.clicks,',\n ' metrics.cost_micros,',\n ' metrics.historical_quality_score',\n 'FROM keyword_view',\n `WHERE segments.date BETWEEN '${range.startDate}' AND '${range.endDate}'`,\n ].join(' ');\n}\n\nfunction queryForPhase(phase: GoogleAdsPhase, range: DateRange): string {\n switch (phase) {\n case 'campaigns':\n return campaignsQuery();\n case 'campaign_metrics':\n return campaignMetricsQuery(range);\n case 'ad_group_metrics':\n return adGroupMetricsQuery(range);\n case 'keyword_metrics':\n return keywordMetricsQuery(range);\n }\n}\n\n// ---------------------------------------------------------------------------\n// Row → storage write helpers\n// ---------------------------------------------------------------------------\n\nexport function campaignToEntity(row: CampaignRow): {\n type: string;\n id: string;\n attributes: Record<string, string | number | null>;\n updated_at: number;\n} {\n const c = row.campaign;\n // Campaign upstream has no updated_at field. Use the start_date as a stable\n // freshness signal so re-syncs of the same row don't churn updated_at; for\n // campaigns with no start_date (rare), fall back to 0 which still makes the\n // upsert idempotent.\n const startMs = c.startDate ? dateStringToMs(c.startDate) : 0;\n return {\n type: ENTITY_TYPE_CAMPAIGN,\n id: String(c.id),\n attributes: {\n name: c.name ?? null,\n status: c.status ?? null,\n biddingStrategyType: c.biddingStrategyType ?? null,\n startDate: c.startDate ?? null,\n endDate: c.endDate ?? null,\n resourceName: c.resourceName ?? null,\n },\n updated_at: startMs,\n };\n}\n\nexport function campaignMetricRowToSample(row: CampaignMetricRow): {\n name: string;\n ts: number;\n value: number;\n attributes: Record<string, string | number | null>;\n} {\n const m = row.metrics;\n const cost = microsToUnits(m.costMicros);\n return {\n name: METRIC_NAME.campaign_metrics,\n ts: dateStringToMs(row.segments.date),\n value: cost,\n attributes: {\n date: row.segments.date,\n campaignId: String(row.campaign.id),\n campaignName: row.campaign.name ?? null,\n impressions: coerceInt(m.impressions),\n clicks: coerceInt(m.clicks),\n cost,\n costMicros: coerceInt(m.costMicros),\n conversions: typeof m.conversions === 'number' ? m.conversions : 0,\n conversionsValue:\n typeof m.conversionsValue === 'number' ? m.conversionsValue : 0,\n },\n };\n}\n\nexport function adGroupMetricRowToSample(row: AdGroupMetricRow): {\n name: string;\n ts: number;\n value: number;\n attributes: Record<string, string | number | null>;\n} {\n const m = row.metrics;\n const cost = microsToUnits(m.costMicros);\n return {\n name: METRIC_NAME.ad_group_metrics,\n ts: dateStringToMs(row.segments.date),\n value: cost,\n attributes: {\n date: row.segments.date,\n adGroupId: String(row.adGroup.id),\n adGroupName: row.adGroup.name ?? null,\n campaignId: row.campaign?.id != null ? String(row.campaign.id) : null,\n impressions: coerceInt(m.impressions),\n clicks: coerceInt(m.clicks),\n cost,\n costMicros: coerceInt(m.costMicros),\n conversions: typeof m.conversions === 'number' ? m.conversions : 0,\n },\n };\n}\n\nexport function keywordMetricRowToSample(row: KeywordMetricRow): {\n name: string;\n ts: number;\n value: number;\n attributes: Record<string, string | number | null>;\n} {\n const m = row.metrics;\n const cost = microsToUnits(m.costMicros);\n return {\n name: METRIC_NAME.keyword_metrics,\n ts: dateStringToMs(row.segments.date),\n value: cost,\n attributes: {\n date: row.segments.date,\n criterionId: String(row.adGroupCriterion.criterionId),\n keywordText: row.adGroupCriterion.keyword?.text ?? null,\n matchType: row.adGroupCriterion.keyword?.matchType ?? null,\n adGroupId: row.adGroup?.id != null ? String(row.adGroup.id) : null,\n impressions: coerceInt(m.impressions),\n clicks: coerceInt(m.clicks),\n cost,\n costMicros: coerceInt(m.costMicros),\n qualityScore: coerceIntOrNull(m.historicalQualityScore),\n },\n };\n}\n\n// ---------------------------------------------------------------------------\n// GoogleAdsConnector\n// ---------------------------------------------------------------------------\n\ninterface TokenResponse {\n access_token: string;\n expires_in?: number;\n}\n\ninterface SearchResponse<TRow> {\n results?: TRow[];\n nextPageToken?: string;\n}\n\nexport class GoogleAdsConnector extends BaseConnector<\n GoogleAdsSettings,\n GoogleAdsCredentials\n> {\n static readonly id = 'google-ads';\n\n static readonly resources = googleAdsResources;\n\n static readonly schemas = schemasFromResources(googleAdsResources);\n\n static create(input: unknown, ctx?: ConnectorContext): GoogleAdsConnector {\n const parsed = configFields.parse(input);\n return new GoogleAdsConnector(\n {\n customerId: parsed.customerId,\n loginCustomerId: parsed.loginCustomerId,\n lookbackDays: parsed.lookbackDays,\n resources: parsed.resources,\n },\n {\n clientId: parsed.clientId,\n clientSecret: parsed.clientSecret,\n refreshToken: parsed.refreshToken,\n developerToken: parsed.developerToken,\n },\n ctx,\n );\n }\n\n readonly id = 'google-ads';\n override readonly credentials = googleAdsCredentials;\n\n private cachedToken: { token: string; expiresAt: number } | null = null;\n\n private async fetchAccessToken(\n signal: AbortSignal | undefined,\n ): Promise<{ token: string; expiresAt: number }> {\n const body = new URLSearchParams({\n grant_type: 'refresh_token',\n client_id: this.creds.clientId,\n client_secret: this.creds.clientSecret,\n refresh_token: this.creds.refreshToken,\n }).toString();\n const res = await this.post<TokenResponse>(TOKEN_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 // Refresh 60s before expiry so a long-running phase doesn't 401 on the\n // boundary.\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 this.cachedToken = await this.fetchAccessToken(signal);\n return this.cachedToken.token;\n }\n\n private buildHeaders(accessToken: string): Record<string, string> {\n const headers: Record<string, string> = {\n Authorization: `Bearer ${accessToken}`,\n 'Content-Type': 'application/json',\n 'developer-token': this.creds.developerToken,\n 'User-Agent': connectorUserAgent('google-ads'),\n };\n if (this.settings.loginCustomerId) {\n headers['login-customer-id'] = this.settings.loginCustomerId;\n }\n return headers;\n }\n\n private async searchPage<TRow>(\n phase: GoogleAdsPhase,\n range: DateRange,\n pageToken: string | null,\n signal?: AbortSignal,\n ): Promise<{ items: TRow[]; next: string | null }> {\n const token = await this.getAccessToken(signal);\n const url = `https://googleads.googleapis.com/${API_VERSION}/customers/${this.settings.customerId}/googleAds:search`;\n const body: Record<string, unknown> = {\n query: queryForPhase(phase, range),\n pageSize: PAGE_SIZE,\n };\n if (pageToken) {\n body.pageToken = pageToken;\n }\n const res = await this.post<SearchResponse<TRow>>(url, {\n resource: phase,\n headers: this.buildHeaders(token),\n body: JSON.stringify(body),\n signal,\n });\n return {\n items: res.body.results ?? [],\n next: res.body.nextPageToken ?? null,\n };\n }\n\n private async writePhase(\n phase: GoogleAdsPhase,\n items: unknown[],\n storage: StorageHandle,\n ): Promise<void> {\n switch (phase) {\n case 'campaigns': {\n for (const row of items as CampaignRow[]) {\n await storage.entity(campaignToEntity(row));\n }\n return;\n }\n case 'campaign_metrics': {\n const samples = (items as CampaignMetricRow[]).map(\n campaignMetricRowToSample,\n );\n await storage.metrics(samples, {\n names: [METRIC_NAME.campaign_metrics],\n });\n return;\n }\n case 'ad_group_metrics': {\n const samples = (items as AdGroupMetricRow[]).map(\n adGroupMetricRowToSample,\n );\n await storage.metrics(samples, {\n names: [METRIC_NAME.ad_group_metrics],\n });\n return;\n }\n case 'keyword_metrics': {\n const samples = (items as KeywordMetricRow[]).map(\n keywordMetricRowToSample,\n );\n await storage.metrics(samples, {\n names: [METRIC_NAME.keyword_metrics],\n });\n return;\n }\n }\n }\n\n private async clearScopeOnFirstPage(\n phase: GoogleAdsPhase,\n storage: StorageHandle,\n isFull: boolean,\n ): Promise<void> {\n if (phase === 'campaigns') {\n // Entities upsert by id, so only a full backfill needs to drop stale\n // rows; incremental ticks just overwrite the records they touch.\n if (isFull) {\n await storage.entities([], { types: [ENTITY_TYPE_CAMPAIGN] });\n }\n return;\n }\n // Metric phases always rewrite the requested date window - clearing by\n // name keeps writes idempotent across runs and prevents partial-page\n // failures from leaving orphaned samples.\n await storage.metrics([], { names: [METRIC_NAME[phase]] });\n }\n\n async sync(\n options: SyncOptions,\n storage: StorageHandle,\n signal?: AbortSignal,\n ): Promise<SyncResult> {\n const lookbackDays = this.settings.lookbackDays ?? DEFAULT_LOOKBACK_DAYS;\n const range = getDateRange(options, lookbackDays);\n const isFull = options.mode === 'full';\n\n const phases = selectActivePhases<GoogleAdsResource, GoogleAdsPhase>(\n (r) => r,\n PHASE_ORDER,\n this.settings.resources,\n );\n\n const cursor = isGoogleAdsSyncCursor(options.cursor)\n ? options.cursor\n : undefined;\n\n return paginateChunked<GoogleAdsPhase, string>({\n phases,\n cursor,\n signal,\n logger: this.logger,\n fetchPage: (phase, page, sig) =>\n this.searchPage<unknown>(phase, range, page, sig),\n writeBatch: async (phase, items, page) => {\n if (page === null) {\n await this.clearScopeOnFirstPage(phase, storage, isFull);\n }\n await this.writePhase(phase, items, storage);\n },\n });\n }\n}\n","import { GoogleAdsConnector } from './google-ads';\n\nexport {\n adGroupMetricRowToSample,\n campaignMetricRowToSample,\n campaignToEntity,\n configFields,\n doc,\n getDateRange,\n GoogleAdsConnector,\n keywordMetricRowToSample,\n} from './google-ads';\nexport type { GoogleAdsResource, GoogleAdsSettings } from './google-ads';\nexport default GoogleAdsConnector;\n"],"mappings":";AEAO,IAAM,sBAAsB;AAE5B,IAAM,qBAAqB,qBAAqB,mBAAmB;AAEnE,SAAS,mBAAmB,aAA6B;AAC9D,SAAO,qBAAqB,WAAW,IAAI,mBAAmB;AAChE;;;AOLA;AAAA,EACE;AAAA,EAOA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,SAAS;AAMX,IAAM,eAAe;AAAA,EAC1B,EAAE,OAAO;AAAA,IACP,YAAY,EACT,OAAO,EACP,KAAK,EACL;AAAA,MACC;AAAA,MACA;AAAA,IACF,EACC,KAAK;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,MACF,aAAa;AAAA,IACf,CAAC;AAAA,IACH,iBAAiB,EACd,OAAO,EACP,KAAK,EACL;AAAA,MACC;AAAA,MACA;AAAA,IACF,EACC,SAAS,EACT,KAAK;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,MACF,aAAa;AAAA,IACf,CAAC;AAAA,IACH,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,KAAK;AAAA,MAC/B,OAAO;AAAA,MACP,aACE;AAAA,MACF,aAAa;AAAA,IACf,CAAC;AAAA,IACD,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK;AAAA,MACnD,OAAO;AAAA,MACP,aAAa;AAAA,MACb,QAAQ;AAAA,IACV,CAAC;AAAA,IACD,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK;AAAA,MACnD,OAAO;AAAA,MACP,aACE;AAAA,MACF,QAAQ;AAAA,IACV,CAAC;AAAA,IACD,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK;AAAA,MACrD,OAAO;AAAA,MACP,aACE;AAAA,MACF,QAAQ;AAAA,IACV,CAAC;AAAA,IACD,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK;AAAA,MACxD,OAAO;AAAA,MACP,aACE;AAAA,MACF,aAAa;AAAA,IACf,CAAC;AAAA,IACD,WAAW,EACR;AAAA,MACC,EAAE,KAAK;AAAA,QACL;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH,EACC,SAAS,EACT,SAAS,EACT,KAAK;AAAA,MACJ,OAAO;AAAA,MACP,aACE;AAAA,IACJ,CAAC;AAAA,EACL,CAAC;AACH;AAEO,IAAM,MAAoB,mBAAmB;AAAA,EAClD,aAAa;AAAA,EACb,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,SACE;AAAA,EACF,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,SAAS;AAAA,IACT,SAAS;AAAA,EACX;AAAA,EACA,MAAM;AAAA,IACJ,SACE;AAAA,IACF,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EACA,WACE;AAAA,EACF,aAAa;AAAA,IACX;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF,CAAC;AAaD,IAAM,uBAAuB;AAAA,EAC3B,UAAU;AAAA,IACR,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,cAAc;AAAA,IACZ,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,cAAc;AAAA,IACZ,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AAAA,EACA,gBAAgB;AAAA,IACd,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AACF;AAQA,IAAM,cAAc;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAMA,IAAM,wBAAwB,uBAAuB,WAAW;AAEhE,IAAM,cAAc;AACpB,IAAM,YAAY;AAClB,IAAM,aAAa,KAAK,KAAK,KAAK;AAClC,IAAM,wBAAwB;AAC9B,IAAM,4BAA4B;AAClC,IAAM,kBAAkB;AACxB,IAAM,YAAY;AAElB,IAAM,uBAAuB;AAC7B,IAAM,cAA8C;AAAA,EAClD,WAAW;AAAA,EACX,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAiB;AACnB;AAUA,IAAM,cAAc,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAE3D,IAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,MAAM,EAAE,OAAO,EAAE,MAAM,qBAAqB;AAC9C,CAAC;AAED,IAAM,aAAa,EAAE,OAAO,EAAE,MAAM,qBAAqB;AAEzD,IAAM,uBAAuB,EAAE,OAAO;AAAA,EACpC,IAAI;AAAA,EACJ,MAAM,EAAE,OAAO,EAAE,QAAQ;AAAA,EACzB,QAAQ,EAAE,OAAO,EAAE,QAAQ;AAAA,EAC3B,qBAAqB,EAAE,OAAO,EAAE,QAAQ;AAAA,EACxC,WAAW,WAAW,QAAQ;AAAA,EAC9B,SAAS,WAAW,QAAQ;AAAA,EAC5B,cAAc,EAAE,OAAO,EAAE,QAAQ;AACnC,CAAC;AAED,IAAM,gBAAgB,EAAE,OAAO;AAAA,EAC7B,aAAa,YAAY,QAAQ;AAAA,EACjC,QAAQ,YAAY,QAAQ;AAAA,EAC5B,YAAY,YAAY,QAAQ;AAAA,EAChC,aAAa,EAAE,OAAO,EAAE,QAAQ;AAAA,EAChC,kBAAkB,EAAE,OAAO,EAAE,QAAQ;AAAA,EACrC,wBAAwB,YAAY,QAAQ;AAC9C,CAAC;AAED,IAAM,oBAAoB,EAAE,OAAO;AAAA,EACjC,UAAU;AACZ,CAAC;AAED,IAAM,0BAA0B,EAAE,OAAO;AAAA,EACvC,UAAU;AAAA,EACV,UAAU,EAAE,OAAO;AAAA,IACjB,IAAI;AAAA,IACJ,MAAM,EAAE,OAAO,EAAE,QAAQ;AAAA,IACzB,cAAc,EAAE,OAAO,EAAE,QAAQ;AAAA,EACnC,CAAC;AAAA,EACD,SAAS;AACX,CAAC;AAED,IAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,UAAU;AAAA,EACV,UAAU,EAAE,OAAO,EAAE,IAAI,YAAY,CAAC,EAAE,QAAQ;AAAA,EAChD,SAAS,EAAE,OAAO;AAAA,IAChB,IAAI;AAAA,IACJ,MAAM,EAAE,OAAO,EAAE,QAAQ;AAAA,IACzB,cAAc,EAAE,OAAO,EAAE,QAAQ;AAAA,EACnC,CAAC;AAAA,EACD,SAAS;AACX,CAAC;AAED,IAAM,yBAAyB,EAAE,OAAO;AAAA,EACtC,UAAU;AAAA,EACV,SAAS,EAAE,OAAO,EAAE,IAAI,YAAY,CAAC,EAAE,QAAQ;AAAA,EAC/C,kBAAkB,EAAE,OAAO;AAAA,IACzB,aAAa;AAAA,IACb,SAAS,EACN,OAAO;AAAA,MACN,MAAM,EAAE,OAAO,EAAE,QAAQ;AAAA,MACzB,WAAW,EAAE,OAAO,EAAE,QAAQ;AAAA,IAChC,CAAC,EACA,QAAQ;AAAA,IACX,cAAc,EAAE,OAAO,EAAE,QAAQ;AAAA,EACnC,CAAC;AAAA,EACD,SAAS;AACX,CAAC;AAED,IAAM,0BAA0B,EAAE,MAAM,iBAAiB;AACzD,IAAM,gCAAgC,EAAE,MAAM,uBAAuB;AACrE,IAAM,+BAA+B,EAAE,MAAM,sBAAsB;AACnE,IAAM,+BAA+B,EAAE,MAAM,sBAAsB;AAOnE,IAAM,qBAAqB,gBAAgB;AAAA,EACzC,CAAC,oBAAoB,GAAG;AAAA,IACtB,OAAO;AAAA,IACP,aACE;AAAA,IACF,UAAU;AAAA,IACV,QAAQ;AAAA,MACN,EAAE,MAAM,MAAM,aAAa,kCAAkC;AAAA,MAC7D,EAAE,MAAM,QAAQ,aAAa,yBAAyB;AAAA,MACtD;AAAA,QACE,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA,EAAE,MAAM,aAAa,aAAa,oCAAoC;AAAA,MACtE;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,IACF;AAAA,IACA,WAAW;AAAA,MACT,aAAa,EAAE,OAAO;AAAA,QACpB,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,QAC9B,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS;AAAA,MACnD,CAAC;AAAA,MACD,WAAW;AAAA,IACb;AAAA,EACF;AAAA,EACA,6BAA6B;AAAA,IAC3B,OAAO;AAAA,IACP,aACE;AAAA,IACF,UAAU;AAAA,IACV,MAAM;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,MACV,EAAE,MAAM,QAAQ,aAAa,qCAAqC;AAAA,MAClE,EAAE,MAAM,cAAc,aAAa,kCAAkC;AAAA,MACrE;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA,EAAE,MAAM,eAAe,aAAa,oCAAoC;AAAA,MACxE,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,MAC7D;AAAA,QACE,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,IACF;AAAA,IACA,OACE;AAAA,IACF,WAAW,EAAE,kBAAkB,8BAA8B;AAAA,EAC/D;AAAA,EACA,6BAA6B;AAAA,IAC3B,OAAO;AAAA,IACP,aACE;AAAA,IACF,UAAU;AAAA,IACV,MAAM;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,MACV,EAAE,MAAM,QAAQ,aAAa,qCAAqC;AAAA,MAClE,EAAE,MAAM,aAAa,aAAa,kCAAkC;AAAA,MACpE;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA,EAAE,MAAM,cAAc,aAAa,sBAAsB;AAAA,MACzD,EAAE,MAAM,eAAe,aAAa,oCAAoC;AAAA,MACxE,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,MAC7D,EAAE,MAAM,QAAQ,aAAa,kCAAkC;AAAA,MAC/D;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,IACF;AAAA,IACA,WAAW,EAAE,kBAAkB,6BAA6B;AAAA,EAC9D;AAAA,EACA,4BAA4B;AAAA,IAC1B,OAAO;AAAA,IACP,aACE;AAAA,IACF,UAAU;AAAA,IACV,MAAM;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,MACV,EAAE,MAAM,QAAQ,aAAa,qCAAqC;AAAA,MAClE;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA,EAAE,MAAM,eAAe,aAAa,gBAAgB;AAAA,MACpD;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA,EAAE,MAAM,aAAa,aAAa,sBAAsB;AAAA,MACxD,EAAE,MAAM,eAAe,aAAa,oCAAoC;AAAA,MACxE,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,MAC7D,EAAE,MAAM,QAAQ,aAAa,kCAAkC;AAAA,MAC/D;AAAA,QACE,MAAM;AAAA,QACN,aAAa;AAAA,MACf;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,aACE;AAAA,MACJ;AAAA,IACF;AAAA,IACA,OACE;AAAA,IACF,WAAW,EAAE,iBAAiB,6BAA6B;AAAA,EAC7D;AACF,CAAC;AAMD,SAAS,aAAa,MAAoB;AACxC,QAAM,IAAI,KAAK,eAAe;AAC9B,QAAM,IAAI,OAAO,KAAK,YAAY,IAAI,CAAC,EAAE,SAAS,GAAG,GAAG;AACxD,QAAM,IAAI,OAAO,KAAK,WAAW,CAAC,EAAE,SAAS,GAAG,GAAG;AACnD,SAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;AACvB;AAEA,IAAM,UAAU;AAEhB,SAAS,eAAe,UAA0B;AAIhD,QAAM,IAAI,QAAQ,KAAK,QAAQ;AAC/B,MAAI,CAAC,GAAG;AACN,WAAO;AAAA,EACT;AACA,QAAM,KAAK,KAAK,IAAI,OAAO,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC;AAChE,SAAO,OAAO,SAAS,EAAE,IAAI,KAAK;AACpC;AAOO,SAAS,aACd,SACA,cACA,MAAc,KAAK,IAAI,GACZ;AACX,QAAM,UAAU,aAAa,IAAI,KAAK,GAAG,CAAC;AAC1C,MAAI,QAAQ,SAAS,UAAU;AAC7B,UAAMA,WAAU,OAAO,4BAA4B,KAAK;AACxD,WAAO,EAAE,WAAW,aAAa,IAAI,KAAKA,QAAO,CAAC,GAAG,QAAQ;AAAA,EAC/D;AACA,MAAI,QAAQ,OAAO;AACjB,UAAM,UAAU,IAAI,KAAK,QAAQ,KAAK,EAAE,QAAQ;AAChD,QAAI,OAAO,SAAS,OAAO,GAAG;AAC5B,YAAM,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,WAAW,UAAU,CAAC;AAChE,YAAM,aAAa,KAAK,IAAI,MAAM,YAAY;AAC9C,YAAMA,WAAU,OAAO,aAAa,KAAK;AACzC,aAAO,EAAE,WAAW,aAAa,IAAI,KAAKA,QAAO,CAAC,GAAG,QAAQ;AAAA,IAC/D;AAAA,EACF;AACA,QAAM,UAAU,OAAO,eAAe,KAAK;AAC3C,SAAO,EAAE,WAAW,aAAa,IAAI,KAAK,OAAO,CAAC,GAAG,QAAQ;AAC/D;AAEA,SAAS,UAAU,OAAwB;AACzC,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,OAAO,SAAS,KAAK,IAAI,QAAQ;AAAA,EAC1C;AACA,MAAI,OAAO,UAAU,YAAY,UAAU,IAAI;AAC7C,UAAM,IAAI,OAAO,KAAK;AACtB,WAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAAA,EAClC;AACA,SAAO;AACT;AAEA,SAAS,gBAAgB,OAA+B;AACtD,MAAI,UAAU,QAAQ,UAAU,QAAW;AACzC,WAAO;AAAA,EACT;AACA,QAAM,IAAI,UAAU,KAAK;AACzB,SAAO;AACT;AAEA,SAAS,cAAc,QAAyB;AAC9C,SAAO,UAAU,MAAM,IAAI;AAC7B;AAOA,SAAS,iBAAyB;AAChC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,GAAG;AACZ;AAEA,SAAS,qBAAqB,OAA0B;AACtD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gCAAgC,MAAM,SAAS,UAAU,MAAM,OAAO;AAAA,EACxE,EAAE,KAAK,GAAG;AACZ;AAEA,SAAS,oBAAoB,OAA0B;AACrD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gCAAgC,MAAM,SAAS,UAAU,MAAM,OAAO;AAAA,EACxE,EAAE,KAAK,GAAG;AACZ;AAEA,SAAS,oBAAoB,OAA0B;AACrD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gCAAgC,MAAM,SAAS,UAAU,MAAM,OAAO;AAAA,EACxE,EAAE,KAAK,GAAG;AACZ;AAEA,SAAS,cAAc,OAAuB,OAA0B;AACtE,UAAQ,OAAO;AAAA,IACb,KAAK;AACH,aAAO,eAAe;AAAA,IACxB,KAAK;AACH,aAAO,qBAAqB,KAAK;AAAA,IACnC,KAAK;AACH,aAAO,oBAAoB,KAAK;AAAA,IAClC,KAAK;AACH,aAAO,oBAAoB,KAAK;AAAA,EACpC;AACF;AAMO,SAAS,iBAAiB,KAK/B;AACA,QAAM,IAAI,IAAI;AAKd,QAAM,UAAU,EAAE,YAAY,eAAe,EAAE,SAAS,IAAI;AAC5D,SAAO;AAAA,IACL,MAAM;AAAA,IACN,IAAI,OAAO,EAAE,EAAE;AAAA,IACf,YAAY;AAAA,MACV,MAAM,EAAE,QAAQ;AAAA,MAChB,QAAQ,EAAE,UAAU;AAAA,MACpB,qBAAqB,EAAE,uBAAuB;AAAA,MAC9C,WAAW,EAAE,aAAa;AAAA,MAC1B,SAAS,EAAE,WAAW;AAAA,MACtB,cAAc,EAAE,gBAAgB;AAAA,IAClC;AAAA,IACA,YAAY;AAAA,EACd;AACF;AAEO,SAAS,0BAA0B,KAKxC;AACA,QAAM,IAAI,IAAI;AACd,QAAM,OAAO,cAAc,EAAE,UAAU;AACvC,SAAO;AAAA,IACL,MAAM,YAAY;AAAA,IAClB,IAAI,eAAe,IAAI,SAAS,IAAI;AAAA,IACpC,OAAO;AAAA,IACP,YAAY;AAAA,MACV,MAAM,IAAI,SAAS;AAAA,MACnB,YAAY,OAAO,IAAI,SAAS,EAAE;AAAA,MAClC,cAAc,IAAI,SAAS,QAAQ;AAAA,MACnC,aAAa,UAAU,EAAE,WAAW;AAAA,MACpC,QAAQ,UAAU,EAAE,MAAM;AAAA,MAC1B;AAAA,MACA,YAAY,UAAU,EAAE,UAAU;AAAA,MAClC,aAAa,OAAO,EAAE,gBAAgB,WAAW,EAAE,cAAc;AAAA,MACjE,kBACE,OAAO,EAAE,qBAAqB,WAAW,EAAE,mBAAmB;AAAA,IAClE;AAAA,EACF;AACF;AAEO,SAAS,yBAAyB,KAKvC;AACA,QAAM,IAAI,IAAI;AACd,QAAM,OAAO,cAAc,EAAE,UAAU;AACvC,SAAO;AAAA,IACL,MAAM,YAAY;AAAA,IAClB,IAAI,eAAe,IAAI,SAAS,IAAI;AAAA,IACpC,OAAO;AAAA,IACP,YAAY;AAAA,MACV,MAAM,IAAI,SAAS;AAAA,MACnB,WAAW,OAAO,IAAI,QAAQ,EAAE;AAAA,MAChC,aAAa,IAAI,QAAQ,QAAQ;AAAA,MACjC,YAAY,IAAI,UAAU,MAAM,OAAO,OAAO,IAAI,SAAS,EAAE,IAAI;AAAA,MACjE,aAAa,UAAU,EAAE,WAAW;AAAA,MACpC,QAAQ,UAAU,EAAE,MAAM;AAAA,MAC1B;AAAA,MACA,YAAY,UAAU,EAAE,UAAU;AAAA,MAClC,aAAa,OAAO,EAAE,gBAAgB,WAAW,EAAE,cAAc;AAAA,IACnE;AAAA,EACF;AACF;AAEO,SAAS,yBAAyB,KAKvC;AACA,QAAM,IAAI,IAAI;AACd,QAAM,OAAO,cAAc,EAAE,UAAU;AACvC,SAAO;AAAA,IACL,MAAM,YAAY;AAAA,IAClB,IAAI,eAAe,IAAI,SAAS,IAAI;AAAA,IACpC,OAAO;AAAA,IACP,YAAY;AAAA,MACV,MAAM,IAAI,SAAS;AAAA,MACnB,aAAa,OAAO,IAAI,iBAAiB,WAAW;AAAA,MACpD,aAAa,IAAI,iBAAiB,SAAS,QAAQ;AAAA,MACnD,WAAW,IAAI,iBAAiB,SAAS,aAAa;AAAA,MACtD,WAAW,IAAI,SAAS,MAAM,OAAO,OAAO,IAAI,QAAQ,EAAE,IAAI;AAAA,MAC9D,aAAa,UAAU,EAAE,WAAW;AAAA,MACpC,QAAQ,UAAU,EAAE,MAAM;AAAA,MAC1B;AAAA,MACA,YAAY,UAAU,EAAE,UAAU;AAAA,MAClC,cAAc,gBAAgB,EAAE,sBAAsB;AAAA,IACxD;AAAA,EACF;AACF;AAgBO,IAAM,qBAAN,MAAM,4BAA2B,cAGtC;AAAA,EACA,OAAgB,KAAK;AAAA,EAErB,OAAgB,YAAY;AAAA,EAE5B,OAAgB,UAAU,qBAAqB,kBAAkB;AAAA,EAEjE,OAAO,OAAO,OAAgB,KAA4C;AACxE,UAAM,SAAS,aAAa,MAAM,KAAK;AACvC,WAAO,IAAI;AAAA,MACT;AAAA,QACE,YAAY,OAAO;AAAA,QACnB,iBAAiB,OAAO;AAAA,QACxB,cAAc,OAAO;AAAA,QACrB,WAAW,OAAO;AAAA,MACpB;AAAA,MACA;AAAA,QACE,UAAU,OAAO;AAAA,QACjB,cAAc,OAAO;AAAA,QACrB,cAAc,OAAO;AAAA,QACrB,gBAAgB,OAAO;AAAA,MACzB;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAES,KAAK;AAAA,EACI,cAAc;AAAA,EAExB,cAA2D;AAAA,EAEnE,MAAc,iBACZ,QAC+C;AAC/C,UAAM,OAAO,IAAI,gBAAgB;AAAA,MAC/B,YAAY;AAAA,MACZ,WAAW,KAAK,MAAM;AAAA,MACtB,eAAe,KAAK,MAAM;AAAA,MAC1B,eAAe,KAAK,MAAM;AAAA,IAC5B,CAAC,EAAE,SAAS;AACZ,UAAM,MAAM,MAAM,KAAK,KAAoB,WAAW;AAAA,MACpD,UAAU;AAAA,MACV,SAAS,EAAE,gBAAgB,oCAAoC;AAAA,MAC/D;AAAA,MACA;AAAA,IACF,CAAC;AACD,UAAM,YAAY,IAAI,KAAK,cAAc;AACzC,WAAO;AAAA,MACL,OAAO,IAAI,KAAK;AAAA;AAAA;AAAA,MAGhB,WAAW,KAAK,IAAI,KAAK,YAAY,MAAM;AAAA,IAC7C;AAAA,EACF;AAAA,EAEA,MAAc,eAAe,QAAuC;AAClE,QAAI,KAAK,eAAe,KAAK,IAAI,IAAI,KAAK,YAAY,WAAW;AAC/D,aAAO,KAAK,YAAY;AAAA,IAC1B;AACA,SAAK,cAAc,MAAM,KAAK,iBAAiB,MAAM;AACrD,WAAO,KAAK,YAAY;AAAA,EAC1B;AAAA,EAEQ,aAAa,aAA6C;AAChE,UAAM,UAAkC;AAAA,MACtC,eAAe,UAAU,WAAW;AAAA,MACpC,gBAAgB;AAAA,MAChB,mBAAmB,KAAK,MAAM;AAAA,MAC9B,cAAc,mBAAmB,YAAY;AAAA,IAC/C;AACA,QAAI,KAAK,SAAS,iBAAiB;AACjC,cAAQ,mBAAmB,IAAI,KAAK,SAAS;AAAA,IAC/C;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAc,WACZ,OACA,OACA,WACA,QACiD;AACjD,UAAM,QAAQ,MAAM,KAAK,eAAe,MAAM;AAC9C,UAAM,MAAM,oCAAoC,WAAW,cAAc,KAAK,SAAS,UAAU;AACjG,UAAM,OAAgC;AAAA,MACpC,OAAO,cAAc,OAAO,KAAK;AAAA,MACjC,UAAU;AAAA,IACZ;AACA,QAAI,WAAW;AACb,WAAK,YAAY;AAAA,IACnB;AACA,UAAM,MAAM,MAAM,KAAK,KAA2B,KAAK;AAAA,MACrD,UAAU;AAAA,MACV,SAAS,KAAK,aAAa,KAAK;AAAA,MAChC,MAAM,KAAK,UAAU,IAAI;AAAA,MACzB;AAAA,IACF,CAAC;AACD,WAAO;AAAA,MACL,OAAO,IAAI,KAAK,WAAW,CAAC;AAAA,MAC5B,MAAM,IAAI,KAAK,iBAAiB;AAAA,IAClC;AAAA,EACF;AAAA,EAEA,MAAc,WACZ,OACA,OACA,SACe;AACf,YAAQ,OAAO;AAAA,MACb,KAAK,aAAa;AAChB,mBAAW,OAAO,OAAwB;AACxC,gBAAM,QAAQ,OAAO,iBAAiB,GAAG,CAAC;AAAA,QAC5C;AACA;AAAA,MACF;AAAA,MACA,KAAK,oBAAoB;AACvB,cAAM,UAAW,MAA8B;AAAA,UAC7C;AAAA,QACF;AACA,cAAM,QAAQ,QAAQ,SAAS;AAAA,UAC7B,OAAO,CAAC,YAAY,gBAAgB;AAAA,QACtC,CAAC;AACD;AAAA,MACF;AAAA,MACA,KAAK,oBAAoB;AACvB,cAAM,UAAW,MAA6B;AAAA,UAC5C;AAAA,QACF;AACA,cAAM,QAAQ,QAAQ,SAAS;AAAA,UAC7B,OAAO,CAAC,YAAY,gBAAgB;AAAA,QACtC,CAAC;AACD;AAAA,MACF;AAAA,MACA,KAAK,mBAAmB;AACtB,cAAM,UAAW,MAA6B;AAAA,UAC5C;AAAA,QACF;AACA,cAAM,QAAQ,QAAQ,SAAS;AAAA,UAC7B,OAAO,CAAC,YAAY,eAAe;AAAA,QACrC,CAAC;AACD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,sBACZ,OACA,SACA,QACe;AACf,QAAI,UAAU,aAAa;AAGzB,UAAI,QAAQ;AACV,cAAM,QAAQ,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,oBAAoB,EAAE,CAAC;AAAA,MAC9D;AACA;AAAA,IACF;AAIA,UAAM,QAAQ,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;AAAA,EAC3D;AAAA,EAEA,MAAM,KACJ,SACA,SACA,QACqB;AACrB,UAAM,eAAe,KAAK,SAAS,gBAAgB;AACnD,UAAM,QAAQ,aAAa,SAAS,YAAY;AAChD,UAAM,SAAS,QAAQ,SAAS;AAEhC,UAAM,SAAS;AAAA,MACb,CAAC,MAAM;AAAA,MACP;AAAA,MACA,KAAK,SAAS;AAAA,IAChB;AAEA,UAAM,SAAS,sBAAsB,QAAQ,MAAM,IAC/C,QAAQ,SACR;AAEJ,WAAO,gBAAwC;AAAA,MAC7C;AAAA,MACA;AAAA,MACA;AAAA,MACA,QAAQ,KAAK;AAAA,MACb,WAAW,CAAC,OAAO,MAAM,QACvB,KAAK,WAAoB,OAAO,OAAO,MAAM,GAAG;AAAA,MAClD,YAAY,OAAO,OAAO,OAAO,SAAS;AACxC,YAAI,SAAS,MAAM;AACjB,gBAAM,KAAK,sBAAsB,OAAO,SAAS,MAAM;AAAA,QACzD;AACA,cAAM,KAAK,WAAW,OAAO,OAAO,OAAO;AAAA,MAC7C;AAAA,IACF,CAAC;AAAA,EACH;AACF;;;AC13BA,IAAO,gBAAQ;","names":["startMs"]}
package/package.json ADDED
@@ -0,0 +1,42 @@
1
+ {
2
+ "name": "@rawdash/connector-google-ads",
3
+ "version": "0.16.0",
4
+ "description": "Rawdash connector for Google Ads — syncs campaigns plus daily campaign / ad-group / keyword performance metrics into the six-shape storage model",
5
+ "license": "Apache-2.0",
6
+ "type": "module",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "https://github.com/rawdash/rawdash.git",
10
+ "directory": "packages/connectors/google-ads"
11
+ },
12
+ "files": [
13
+ "dist",
14
+ "README.md",
15
+ "LICENSE"
16
+ ],
17
+ "exports": {
18
+ ".": {
19
+ "@rawdash/source": "./src/index.ts",
20
+ "types": "./dist/index.d.ts",
21
+ "import": "./dist/index.js"
22
+ }
23
+ },
24
+ "scripts": {
25
+ "build": "tsup",
26
+ "typecheck": "tsc --noEmit",
27
+ "lint": "eslint src",
28
+ "test": "vitest run"
29
+ },
30
+ "dependencies": {
31
+ "@rawdash/core": "workspace:*",
32
+ "zod": "^4.4.3"
33
+ },
34
+ "devDependencies": {
35
+ "@rawdash/connector-shared": "workspace:*",
36
+ "@rawdash/connector-test-utils": "workspace:*",
37
+ "fast-check": "^4.8.0",
38
+ "tsup": "^8.0.0",
39
+ "typescript": "^5.7.2",
40
+ "vitest": "^4.1.4"
41
+ }
42
+ }