@gscdump/contracts 0.26.10 → 0.27.0

package/dist/_chunks/types.d.mts

@@ -0,0 +1,1557 @@
+declare const GSCDUMP_ONBOARDING_CONTRACT_VERSION: "2026-05-11";
+declare const GSCDUMP_REQUIRED_ANALYTICS_SCOPE: "https://www.googleapis.com/auth/webmasters.readonly";
+declare const GSCDUMP_WRITE_ANALYTICS_SCOPE: "https://www.googleapis.com/auth/webmasters";
+declare const GSCDUMP_OPTIONAL_INDEXING_SCOPE: "https://www.googleapis.com/auth/indexing";
+declare const accountStatuses: readonly ["disconnected", "oauth_received", "scope_missing", "refresh_missing", "db_provisioning", "ready", "reauth_required"];
+declare const accountNextActions: readonly ["connect_google", "reconnect_google", "wait_for_provisioning", "none"];
+declare const propertyStatuses: readonly ["no_local_site", "no_gsc_property", "unverified_property", "verified_candidate", "registered", "linked"];
+declare const propertyNextActions: readonly ["create_site", "verify_gsc_property", "choose_property", "register_site", "none"];
+declare const analyticsStatuses: readonly ["not_registered", "queued", "preparing", "syncing", "queryable_live", "queryable_partial", "ready", "failed"];
+declare const analyticsNextActions: readonly ["wait_for_sync", "retry_sync", "none"];
+declare const querySourceModes: readonly ["none", "live", "d1", "r2", "mixed"];
+declare const sitemapStatuses: readonly ["unknown", "discovering", "none_found", "auto_submitted", "syncing", "ready", "failed"];
+declare const sitemapNextActions: readonly ["submit_sitemap", "wait_for_sitemaps", "retry_sitemaps", "none"];
+declare const indexingStatuses: readonly ["not_requested", "missing_scope", "insufficient_permission", "waiting_for_sitemaps", "discovering", "checking", "ready", "budget_exhausted", "no_urls", "failed"];
+declare const indexingNextActions: readonly ["reconnect_google", "fix_gsc_permission", "wait_for_sitemaps", "wait_for_indexing", "retry_indexing", "none"];
+declare const lifecycleWebhookEvents: readonly ["user.lifecycle.changed", "site.lifecycle.changed", "site.analytics.ready", "site.indexing.ready", "site.auth.failed", "job.failed"];
+declare const lifecycleErrorCodes: readonly ["missing_refresh_token", "missing_analytics_scope", "missing_indexing_scope", "token_refresh_failed", "permission_lost", "insufficient_gsc_permission", "gsc_property_not_found", "gsc_property_unverified", "user_database_not_provisioned", "sync_failed", "sitemap_sync_failed", "indexing_failed"];
+type AccountStatus = typeof accountStatuses[number];
+type AccountNextAction = typeof accountNextActions[number];
+type PropertyStatus = typeof propertyStatuses[number];
+type PropertyNextAction = typeof propertyNextActions[number];
+type AnalyticsStatus = typeof analyticsStatuses[number];
+type AnalyticsNextAction = typeof analyticsNextActions[number];
+type QuerySourceMode = typeof querySourceModes[number];
+type SitemapStatus = typeof sitemapStatuses[number];
+type SitemapNextAction = typeof sitemapNextActions[number];
+type IndexingStatus = typeof indexingStatuses[number];
+type IndexingNextAction = typeof indexingNextActions[number];
+type LifecycleWebhookEvent = typeof lifecycleWebhookEvents[number];
+type LifecycleErrorCode = typeof lifecycleErrorCodes[number];
+interface LifecycleProgress {
+  completed: number;
+  failed: number;
+  total: number;
+  percent: number;
+}
+interface LifecycleError {
+  code: LifecycleErrorCode;
+  message: string;
+  retryable: boolean;
+}
+interface PartnerLifecycleAccount {
+  status: AccountStatus;
+  grantedScopes: string[];
+  missingScopes: string[];
+  nextAction: AccountNextAction;
+}
+interface PartnerLifecycleSite {
+  siteId: string;
+  externalSiteId: string | null;
+  requestedUrl: string;
+  gscPropertyUrl: string | null;
+  permissionLevel: string | null;
+  property: {
+    status: PropertyStatus;
+    nextAction: PropertyNextAction;
+  };
+  analytics: {
+    status: AnalyticsStatus;
+    progress: LifecycleProgress;
+    queryable: boolean;
+    sourceMode: QuerySourceMode;
+    syncedRange: {
+      oldest: string | null;
+      newest: string | null;
+    };
+    nextAction: AnalyticsNextAction;
+  };
+  sitemaps: {
+    status: SitemapStatus;
+    discoveredCount: number;
+    nextAction: SitemapNextAction;
+  };
+  indexing: {
+    status: IndexingStatus;
+    eligible: boolean;
+    reason: string | null;
+    progress: LifecycleProgress;
+    nextAction: IndexingNextAction;
+  };
+  latestError: LifecycleError | null;
+  lifecycleRevision: number;
+  updatedAt: string;
+}
+interface PartnerLifecycleResponse {
+  contractVersion: typeof GSCDUMP_ONBOARDING_CONTRACT_VERSION;
+  userId: string;
+  partnerId: string | null;
+  account: PartnerLifecycleAccount;
+  sites: PartnerLifecycleSite[];
+}
+interface LifecycleWebhookEnvelope<TData extends Record<string, unknown> = Record<string, unknown>> {
+  contractVersion: typeof GSCDUMP_ONBOARDING_CONTRACT_VERSION;
+  deliveryId: string;
+  event: LifecycleWebhookEvent;
+  partnerId: string;
+  userId: string;
+  siteId?: string;
+  externalUserId?: string | null;
+  externalSiteId?: string | null;
+  lifecycleRevision: number;
+  occurredAt: string;
+  data: TData;
+}
+declare function parseGrantedScopes(scopes: string | null | undefined): string[];
+declare function hasRequiredAnalyticsScope(scopes: string | string[] | null | undefined): boolean;
+declare function hasOptionalIndexingScope(scopes: string | string[] | null | undefined): boolean;
+type TableName = 'pages' | 'queries' | 'countries' | 'page_queries' | 'dates' | 'search_appearance' | 'search_appearance_pages' | 'search_appearance_queries' | 'search_appearance_page_queries' | 'hourly_pages';
+/**
+ * Temporal granularity axis. Daily callers (`'day'`, default) read/write rows
+ *  keyed by `date`; hourly callers (`'hour'`) read/write rows that additionally
+ *  carry a `hour` field. Composes with `searchType` — hourly is only meaningful
+ *  for Discover at the moment but the engine is generic.
+ */
+type Grain = 'day' | 'hour';
+type Row = Record<string, unknown>;
+type ColumnType = 'DATE' | 'VARCHAR' | 'INTEGER' | 'BIGINT' | 'DOUBLE';
+interface ColumnDef {
+  name: string;
+  type: ColumnType;
+  nullable: boolean;
+}
+interface TableSchema {
+  name: TableName;
+  columns: ColumnDef[];
+  sortKey: string[];
+  version: number;
+}
+interface TenantCtx {
+  userId: string;
+  siteId?: string;
+}
+type Dimension = 'page' | 'query' | 'queryCanonical' | 'country' | 'device' | 'date' | 'searchAppearance' | 'hour';
+type Metric = 'clicks' | 'impressions' | 'ctr' | 'position';
+type GscSearchType = 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
+type Filter = unknown;
+interface BuilderState {
+  dimensions: Dimension[];
+  metrics?: Metric[];
+  filter?: Filter;
+  orderBy?: {
+    column: Metric | 'date';
+    dir: 'asc' | 'desc';
+  };
+  rowLimit?: number;
+  startRow?: number;
+  searchType?: GscSearchType;
+}
+interface GscApiRange {
+  start: string;
+  end: string;
+}
+interface CountryRow {
+  country: string;
+  clicks: number;
+  impressions: number;
+  sum_position: number;
+}
+interface CountriesResponse {
+  rows: CountryRow[];
+  range: GscApiRange;
+  generatedAt: string;
+  source: 'gsc-api' | 'engine';
+}
+interface SearchAppearanceRow {
+  searchAppearance: string;
+  clicks: number;
+  impressions: number;
+  sum_position: number;
+}
+interface SearchAppearanceResponse {
+  rows: SearchAppearanceRow[];
+  range: GscApiRange;
+  generatedAt: string;
+  source: 'gsc-api' | 'engine';
+}
+interface SiteListItem {
+  id: string;
+  label: string;
+  hostname: string;
+  propertyType: 'domain' | 'url-prefix';
+  readBackend?: 'd1' | 'r2';
+}
+interface ScheduleState {
+  nextAt: number;
+  consecutiveUnchanged: number;
+  policyVersion: number;
+}
+interface SitemapHistoryRecord {
+  path: string;
+  capturedAt: string;
+  lastDownloaded?: string;
+  lastSubmitted?: string;
+  type?: string;
+  isPending?: boolean;
+  isSitemapsIndex?: boolean;
+  errors?: string;
+  warnings?: string;
+  contents?: Array<{
+    type?: string;
+    submitted?: string;
+    indexed?: string;
+  }>;
+  raw?: unknown;
+  urlCount?: number;
+  contentHash?: string;
+  schedule?: ScheduleState;
+}
+interface SitemapHistoryResponse {
+  path: string | null;
+  snapshots: SitemapHistoryRecord[];
+}
+/**
+ * Wire-format extension carried under `InspectionHistoryRecord.raw`.
+ *
+ * Source of truth: D1 `url_indexing_status` (per the 2026-05-19 redesign).
+ * Most fields are JSON-encoded TEXT in D1 and surface here unchanged as
+ * `string | null`; consumers parse on read.
+ *
+ * Additional keys are tolerated (`[key: string]: unknown`) for
+ * forward-compatibility — new fields can ship without a contract bump.
+ */
+interface InspectionRecordRaw {
+  /** Adaptive recheck schedule owned by `inspectionPolicy.observe`. */
+  schedule?: ScheduleState;
+  /** Unix seconds. Mirrors the `next_check_after` column. */
+  nextCheckAfter?: number;
+  /** Mirrors the `next_check_priority` column. */
+  priority?: 'high' | 'medium' | 'low';
+  /** JSON-encoded `string[]` of sitemap URLs containing this URL. */
+  sitemaps?: string | null;
+  /** JSON-encoded `string[]` of referring URLs Google reported. */
+  referringUrls?: string | null;
+  /** Crawler that fetched the URL (`Googlebot smartphone` etc.). */
+  crawlingUserAgent?: string | null;
+  /** JSON-encoded mobile-usability issues. */
+  mobileIssues?: string | null;
+  /** JSON-encoded rich-results items array. */
+  richResultsItems?: string | null;
+  /** Deep link into the GSC URL Inspection tool. */
+  inspectionResultLink?: string | null;
+  [key: string]: unknown;
+}
+interface InspectionHistoryRecord {
+  url: string;
+  inspectedAt: string;
+  indexStatus?: string;
+  lastCrawlTime?: string;
+  googleCanonical?: string;
+  userCanonical?: string;
+  coverageState?: string;
+  robotsTxtState?: string;
+  indexingState?: string;
+  pageFetchState?: string;
+  mobileUsabilityVerdict?: string;
+  richResultsVerdict?: string;
+  raw?: InspectionRecordRaw;
+}
+interface InspectionHistoryResponse {
+  url: string | null;
+  records: InspectionHistoryRecord[];
+}
+interface SitemapIndex {
+  version: 1;
+  records: Record<string, SitemapHistoryRecord>;
+}
+interface InspectionIndex {
+  version: 1;
+  records: Record<string, InspectionHistoryRecord>;
+}
+interface RollupEnvelope<T = unknown> {
+  version: 1;
+  id: string;
+  builtAt: number;
+  windowDays: number | null;
+  payload: T;
+}
+interface GscRowQueryMeta {
+  sourceName: string;
+  sourceKind: 'row' | 'sql';
+  queryMs: number;
+}
+interface GscRowQueryResponse<T = Record<string, unknown>> {
+  rows: T[];
+  meta: GscRowQueryMeta;
+}
+type IndexingUrlStatus = 'indexed' | 'not_indexed' | 'pending';
+interface IndexingUrlRow {
+  url: string;
+  verdict: string | null;
+  coverageState: string | null;
+  indexingState: string | null;
+  robotsTxtState: string | null;
+  pageFetchState: string | null;
+  lastCrawlTime: string | null;
+  crawlingUserAgent: string | null;
+  userCanonical: string | null;
+  googleCanonical: string | null;
+  sitemaps: string[] | null;
+  referringUrls: string[] | null;
+  mobileVerdict: string | null;
+  mobileIssues: unknown[] | null;
+  richResultsVerdict: string | null;
+  richResultsItems: unknown[] | null;
+  inspectionResultLink: string | null;
+  firstCheckedAt: string;
+  lastCheckedAt: string;
+  checkCount: number;
+}
+interface IndexingUrlsResponse {
+  urls: IndexingUrlRow[];
+  pagination: {
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+  };
+  meta: {
+    siteUrl: string;
+    status: string;
+    issue: string | null;
+  };
+}
+type IndexingIssueSeverity = 'error' | 'warning' | 'info';
+interface IndexingIssue {
+  type: string;
+  label: string;
+  severity: IndexingIssueSeverity;
+  count: number;
+}
+interface IndexingDiagnostics {
+  summary: {
+    totalUrls: number;
+    indexed: number;
+    indexedPercent: number;
+  };
+  issues: IndexingIssue[];
+  meta: {
+    siteUrl: string;
+  };
+}
+interface IndexingInspectRequest {
+  urls: string[];
+}
+interface IndexingInspectResult {
+  url: string;
+  verdict: string | null;
+  coverageState: string | null;
+  indexingState: string | null;
+  robotsTxtState: string | null;
+  pageFetchState: string | null;
+  lastCrawlTime: string | null;
+  crawlingUserAgent: string | null;
+  userCanonical: string | null;
+  googleCanonical: string | null;
+  sitemaps: string | null;
+  referringUrls: string | null;
+  mobileVerdict: string | null;
+  mobileIssues: string | null;
+  richResultsVerdict: string | null;
+  richResultsItems: string | null;
+  inspectionResultLink: string | null;
+}
+interface IndexingInspectRateLimit {
+  reserved: number;
+  remaining: number;
+  limit: number;
+}
+interface IndexingInspectResponse {
+  siteId: string;
+  rateLimit: IndexingInspectRateLimit;
+  results: IndexingInspectResult[];
+  errors: Array<{
+    url: string;
+    error: string;
+  }>;
+  skipped: Array<{
+    url: string;
+    reason: string;
+  }>;
+}
+interface IndexingInspectRateLimited {
+  error: 'rate_limited';
+  message: string;
+  rateLimit: {
+    reserved: 0;
+    remaining: 0;
+    limit: number;
+  };
+  retryAfterSeconds: number;
+}
+interface SitemapAddedRow {
+  url: string;
+  sitemap: string;
+  firstSeenAt: number;
+}
+interface SitemapRemovedRow {
+  url: string;
+  sitemap: string;
+  removedAt: number;
+}
+interface SitemapChangesResponse {
+  added: SitemapAddedRow[];
+  removed: SitemapRemovedRow[];
+  summary: {
+    totalAdded: number;
+    totalRemoved: number;
+    period: {
+      days: number;
+    };
+  };
+}
+type AnalysisSourcesResponse = GscdumpAnalysisSourcesResponse;
+interface SourceInfoResponse {
+  name: string;
+  kind: 'row' | 'sql';
+  capabilities: {
+    attachedTables?: boolean;
+    [k: string]: unknown;
+  };
+  supportedAnalyzerIds: string[];
+  browserAttachEligible: boolean;
+  identityAttrs?: Record<string, unknown> | null;
+}
+interface WhoamiResponse {
+  userId?: string | null;
+  plan?: string | null;
+  attrs?: Record<string, unknown>;
+}
+interface BackfillRange {
+  startDate: string;
+  endDate: string;
+}
+interface BackfillResponse {
+  ok?: boolean;
+  queued?: boolean;
+  [key: string]: unknown;
+}
+interface AnalyticsClient {
+  whoami: () => Promise<WhoamiResponse>;
+  listSites: () => Promise<SiteListItem[]>;
+  getSourceInfo: (siteId: string, options?: SourceInfoOptions) => Promise<SourceInfoResponse>;
+  getAnalysisSources: (siteId: string, tables?: string[] | string | AnalysisSourcesOptions, options?: SearchTypeOptions | SourceInfoOptions) => Promise<AnalysisSourcesResponse>;
+  analyze: <T = unknown>(siteId: string, params: unknown) => Promise<T>;
+  queryRows: <T = Record<string, unknown>>(siteId: string, state: unknown) => Promise<GscRowQueryResponse<T>>;
+  getRollup: <T = unknown>(siteId: string, rollupId: string, params?: {
+    start?: string;
+    end?: string;
+  }) => Promise<RollupEnvelope<T>>;
+  requestBackfill: (siteId: string, range: BackfillRange) => Promise<BackfillResponse>;
+  getSitemaps: (siteId: string) => Promise<SitemapIndex>;
+  getSitemapHistory: (siteId: string, hash: string) => Promise<SitemapHistoryResponse>;
+  getSitemapChanges: (siteId: string, params?: {
+    days?: number;
+  }) => Promise<SitemapChangesResponse>;
+  getInspections: (siteId: string) => Promise<InspectionIndex>;
+  getInspectionHistory: (siteId: string, hash: string) => Promise<InspectionHistoryResponse>;
+  getIndexingUrls: (siteId: string, params?: {
+    limit?: number;
+    offset?: number;
+    status?: IndexingUrlStatus;
+    issue?: string;
+    search?: string;
+  }) => Promise<IndexingUrlsResponse>;
+  getIndexingDiagnostics: (siteId: string) => Promise<IndexingDiagnostics>;
+  requestIndexingInspect: (siteId: string, body: IndexingInspectRequest) => Promise<IndexingInspectResponse | IndexingInspectRateLimited>;
+  getCountries: (siteId: string, range: {
+    start: string;
+    end: string;
+  }) => Promise<CountriesResponse>;
+  getSearchAppearance: (siteId: string, range: {
+    start: string;
+    end: string;
+  }) => Promise<SearchAppearanceResponse>;
+}
+type GscComparisonFilter = 'new' | 'lost' | 'improving' | 'declining';
+interface GscdumpDataRow {
+  page?: string;
+  query?: string;
+  queryCanonical?: string;
+  country?: string;
+  device?: string;
+  date?: string;
+  clicks: number;
+  impressions: number;
+  ctr: number;
+  position: number;
+  prevClicks?: number;
+  prevImpressions?: number;
+  prevCtr?: number;
+  prevPosition?: number;
+  topKeyword?: string;
+  topPage?: string;
+  variantCount?: number;
+  variants?: Array<{
+    query: string;
+    clicks: number;
+    impressions: number;
+    position: number;
+  }>;
+  difficulty?: number;
+  searchVolume?: number;
+  cpc?: number;
+  firstDate?: string;
+  lastDate?: string;
+}
+interface GscdumpMeta {
+  siteUrl: string;
+  syncStatus: string;
+  newestDateSynced: string | null;
+  oldestDateSynced: string | null;
+  dataDelay: string;
+  dataEndDate?: string | null;
+  warnings?: string[];
+  enrichment?: {
+    lastEnriched: number;
+    isDue: boolean;
+  };
+  backfill?: {
+    percent: number;
+    daysRemaining?: number;
+  };
+}
+interface GscdumpTotals {
+  clicks: number;
+  impressions: number;
+  ctr: number;
+  position: number;
+}
+interface GscdumpDataResponse {
+  rows: GscdumpDataRow[];
+  totalCount: number;
+  totals: GscdumpTotals;
+  meta: GscdumpMeta;
+}
+interface GscdumpDataDetailResponse {
+  daily: Array<{
+    date: string;
+    clicks: number;
+    impressions: number;
+    ctr: number;
+    position: number;
+  }>;
+  totals: GscdumpTotals;
+  previousTotals?: GscdumpTotals;
+  meta: GscdumpMeta;
+}
+interface GscdumpUserRegistration {
+  userId: string;
+  apiKey?: string;
+  isNew?: boolean;
+  status?: 'provisioning' | 'ready';
+}
+interface GscdumpUserStatus {
+  userId: string;
+  status: 'provisioning' | 'ready' | 'reauth_required';
+  databaseReady?: boolean;
+  needsReauth?: boolean;
+  reauthRequired?: boolean;
+  reauthReason?: string | null;
+  authFailureCount?: number;
+  nextAction?: 'reconnect_google' | 'none';
+  grantedScopes?: string | null;
+}
+interface GscdumpUserTokenUpdate {
+  userId: string;
+  updated: boolean;
+  sites: GscdumpAvailableSite[];
+}
+interface GscdumpAvailableSite {
+  siteUrl: string;
+  permissionLevel: string;
+  registered: boolean;
+  siteId?: string;
+  syncStatus?: 'pending' | 'syncing' | 'synced' | 'error';
+  syncProgress?: {
+    completed: number;
+    failed?: number;
+    total: number;
+    percent: number;
+  };
+  lastSyncAt?: number | null;
+  newestDateSynced?: string | null;
+  oldestDateSynced?: string | null;
+}
+interface GscdumpSiteRegistration {
+  siteId: string;
+  status: 'idle' | 'pending' | 'syncing' | 'synced' | 'error';
+  message?: string;
+  existing?: boolean;
+  indexingEligible?: boolean;
+  indexingIneligibleReason?: 'missing_indexing_scope' | 'insufficient_gsc_permission';
+  indexingPermissionLevel?: string | null;
+  grantedScopes?: string[];
+}
+interface GscdumpUserSite {
+  siteId: string;
+  siteUrl: string;
+  analyticsSyncStatus?: 'idle' | 'pending' | 'syncing' | 'synced' | 'error';
+  analyticsSyncProgress?: {
+    completed: number;
+    failed?: number;
+    total: number;
+    percent: number;
+  };
+  syncStatus: 'idle' | 'pending' | 'syncing' | 'synced' | 'error';
+  syncProgress?: {
+    completed: number;
+    failed?: number;
+    total: number;
+    percent: number;
+  };
+  indexingEligible?: boolean;
+  indexingIneligibleReason?: 'missing_indexing_scope' | 'insufficient_gsc_permission';
+  indexingPermissionLevel?: string | null;
+  grantedScopes?: string[];
+  indexingStatus?: 'not_started' | 'indexing' | 'complete';
+  indexingProgress?: {
+    completed: number;
+    failed?: number;
+    total: number;
+    percent: number;
+  };
+  indexingUrl?: string;
+  lastSyncAt: number | null;
+  newestDateSynced: string | null;
+  oldestDateSynced: string | null;
+}
+interface GscdumpSyncStatusResponse {
+  siteUrl: string;
+  syncStatus: 'pending' | 'syncing' | 'synced' | 'error';
+  oldestDateAvailable: string | null;
+  oldestDateSynced: string | null;
+  newestDateSynced: string | null;
+  lastSyncAt: number | null;
+  lastError: string | null;
+  jobs: {
+    queued: number;
+    processing: number;
+    completed: number;
+    failed: number;
+  };
+  progress: number;
+  jobProgress: number;
+  daysSynced: number;
+  daysAvailable: number;
+  isSyncing: boolean;
+  hasData: boolean;
+  isComplete: boolean;
+  tables: Record<string, {
+    queued: number;
+    processing: number;
+    completed: number;
+    failed: number;
+    totalRows: number;
+  }>;
+  days?: Record<string, {
+    tables: Record<string, {
+      status: string;
+      rowsFetched: number;
+      rowsInserted: number;
+      error: string | null;
+    }>;
+  }>;
+  failedJobs?: Array<{
+    date: string;
+    tableName: string;
+    error: string;
+    retryCount: number;
+  }>;
+}
+interface GscdumpSitemap {
+  path: string;
+  errors: number;
+  warnings: number;
+  urlCount: number;
+  isIndex: boolean;
+  contentHash: string | null;
+  lastDownloaded: string | null;
+  lastError: string | null;
+  isPending: boolean;
+  fetchedAt: number;
+}
+interface GscdumpSitemapHistory {
+  date: string;
+  errors: number;
+  warnings: number;
+  urlCount: number;
+  urlDelta: number;
+}
+interface GscdumpPerSitemapHistoryEntry {
+  date: string;
+  urlCount: number;
+  changed: boolean;
+  urlDelta: number;
+}
+interface GscdumpSitemapsResponse {
+  sitemaps: GscdumpSitemap[];
+  history: GscdumpSitemapHistory[];
+  perSitemapHistory: Record<string, GscdumpPerSitemapHistoryEntry[]>;
+  meta: {
+    siteUrl: string;
+    gscPropertyUrl?: string;
+    syncStatus: string | null;
+  };
+}
+interface GscdumpSitemapChangesResponse {
+  added: {
+    url: string;
+    sitemap: string;
+    firstSeenAt: number;
+  }[];
+  removed: {
+    url: string;
+    sitemap: string;
+    removedAt: number;
+  }[];
+  summary?: {
+    totalAdded: number;
+    totalRemoved: number;
+    period: {
+      days: number;
+    };
+  };
+}
+interface GscdumpIndexingTrendPoint {
+  date: string;
+  totalUrls: number;
+  indexedCount: number | null;
+  notIndexedCount: number | null;
+  errorCount: number | null;
+  indexedPercent: number;
+  issues: {
+    blockedByRobots: number | null;
+    noindexDetected: number | null;
+    soft404: number | null;
+    redirect: number | null;
+    notFound: number | null;
+    serverError: number | null;
+  };
+  coverage: {
+    submittedIndexed: number | null;
+    crawledNotIndexed: number | null;
+    discoveredNotCrawled: number | null;
+  };
+  signals: {
+    mobilePass: number;
+    mobileFail: number;
+    richResultsPass: number;
+    richResultsFail: number;
+  };
+}
+interface GscdumpIndexingResponse {
+  trend: GscdumpIndexingTrendPoint[];
+  summary: {
+    totalUrls: number;
+    indexed: number;
+    notIndexed: number;
+    pending: number;
+    indexedPercent: number;
+    oldestCheck: string | null;
+    newestCheck: string | null;
+    change7d: number | null;
+    change28d: number | null;
+    signals: {
+      mobilePass: number;
+      mobileFail: number;
+      mobileUnspecified: number;
+      richResultsPass: number;
+      richResultsFail: number;
+      richResultTypes: Array<{
+        type: string;
+        count: number;
+      }>;
+      crawlingMobile: number;
+      crawlingDesktop: number;
+    };
+  };
+  meta: {
+    siteUrl: string;
+    syncStatus: string | null;
+    indexingStatus: 'pending' | 'partial' | 'complete';
+    indexingProgress: number;
+    sitemapTotal: number;
+    inspectedCount: number;
+    noSitemapsSubmitted: boolean;
+    sitemapsPending: boolean;
+    rollupBuiltAt?: number;
+  };
+}
+type GscdumpIndexingUrlStatus = 'indexed' | 'not_indexed' | 'pending';
+type GscdumpIndexingIssueSeverity = 'error' | 'warning' | 'info';
+interface GscdumpRichResultItem {
+  richResultType: string;
+  items?: unknown[];
+}
+interface GscdumpIndexingUrl {
+  url: string;
+  verdict: string | null;
+  coverageState: string | null;
+  indexingState: string | null;
+  robotsTxtState?: string | null;
+  pageFetchState?: string | null;
+  lastCrawlTime: string | null;
+  crawlingUserAgent?: string | null;
+  userCanonical?: string | null;
+  googleCanonical?: string | null;
+  sitemaps?: string[] | null;
+  referringUrls?: string[] | null;
+  mobileVerdict?: string | null;
+  mobileIssues?: string[] | null;
+  richResultsVerdict?: string | null;
+  richResultsItems?: GscdumpRichResultItem[] | null;
+  inspectionResultLink?: string | null;
+  firstCheckedAt: string;
+  lastCheckedAt: string;
+  checkCount?: number;
+}
+interface GscdumpIndexingUrlsResponse {
+  urls: GscdumpIndexingUrl[];
+  pagination: {
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+  };
+  meta: {
+    siteUrl: string;
+    gscPropertyUrl?: string;
+    status: string;
+    issue: string | null;
+  };
+}
+interface GscdumpIndexingDiagnosticsResponse {
+  summary: {
+    totalUrls: number;
+    indexed: number;
+    indexedPercent: number;
+  };
+  issues: {
+    type: string;
+    label: string;
+    severity: GscdumpIndexingIssueSeverity;
+    count: number;
+  }[];
+  meta: {
+    siteUrl: string;
+  };
+}
+type GscdumpIndexingInspectRequest = IndexingInspectRequest;
+type GscdumpIndexingInspectResult = IndexingInspectResult;
+type GscdumpIndexingInspectResponse = IndexingInspectResponse;
+type GscdumpIndexingInspectRateLimited = IndexingInspectRateLimited;
+type GscdumpAnalysisPreset = 'striking-distance' | 'opportunity' | 'decay' | 'zero-click' | 'non-brand' | 'brand-only' | 'movers-rising' | 'movers-declining';
+interface GscdumpAnalysisParams {
+  preset: GscdumpAnalysisPreset;
+  startDate: string;
+  endDate: string;
+  prevStartDate?: string;
+  prevEndDate?: string;
+  brandTerms?: string;
+  limit?: number;
+  offset?: number;
+  search?: string;
+  minImpressions?: number;
+  minPosition?: number;
+  maxPosition?: number;
+  maxCtr?: number;
+  searchType?: GscSearchType;
+}
+interface GscdumpAnalysisResponse {
+  preset: GscdumpAnalysisPreset;
+  keywords: Array<Record<string, unknown>>;
+  totalCount: number;
+  summary?: Record<string, unknown>;
+  meta: GscdumpMeta;
+}
+interface RegisterPartnerUserParams {
+  userGoogleId: string;
+  userEmail: string;
+  userName?: string;
+  accessToken: string;
+  refreshToken: string;
+  tokenExpiresAt?: number;
+}
+interface UpdatePartnerUserTokensParams {
+  accessToken: string;
+  refreshToken: string;
+  tokenExpiresAt?: number;
+}
+interface RegisterPartnerSiteParams {
+  userId: string;
+  siteUrl: string;
+  requestedUrl?: string;
+  gscPropertyUrl?: string;
+  externalSiteId?: string;
+  externalSiteUrl?: string;
+  webhookUrl?: string;
+  webhookEvents?: WebhookEventType[];
+  teamId?: string;
+}
+interface BulkRegisterPartnerSitesParams {
+  userId?: string;
+  siteUrls?: string[];
+  sites?: Array<{
+    siteUrl?: string;
+    requestedUrl?: string;
+    gscPropertyUrl?: string;
+    externalSiteId?: string;
+    externalSiteUrl?: string;
+    webhookUrl?: string;
+    webhookEvents?: WebhookEventType[];
+  }>;
+}
+interface BulkRegisterPartnerSiteResult {
+  siteUrl: string;
+  siteId?: string;
+  status: 'registered' | 'already_exists' | 'not_found' | 'error';
+  error?: string;
+  site?: PartnerLifecycleSite | null;
+  indexingEligible?: boolean;
+  indexingIneligibleReason?: 'missing_indexing_scope' | 'insufficient_gsc_permission';
+  indexingPermissionLevel?: string | null;
+  grantedScopes?: string[];
+}
+interface BulkRegisterPartnerSitesResponse {
+  results: BulkRegisterPartnerSiteResult[];
+  summary: {
+    registered: number;
+    alreadyExists: number;
+    notFound: number;
+    errors: number;
+  };
+}
+interface DeletePartnerUserResponse {
+  ok: true;
+  queued: true;
+  userId: number;
+  publicId: string;
+}
+interface GscdumpAnalysisSourcesResponse {
+  tables: Record<string, string[]>;
+  generatedAt: string;
+  manifestVersion: string;
+  searchType?: GscSearchType;
+  canUseBrowser?: boolean;
+  fallback?: string;
+  reason?: string;
+  estimatedBytes?: number;
+  estimatedFiles?: number;
+  coveragePlan?: unknown;
+}
+interface SearchTypeOptions {
+  searchType?: GscSearchType;
+}
+interface SourceInfoOptions extends SearchTypeOptions {
+  start?: string;
+  end?: string;
+  startDate?: string;
+  endDate?: string;
+}
+interface AnalysisSourcesOptions extends SearchTypeOptions {
+  tables?: string[] | string;
+  start?: string;
+  end?: string;
+  startDate?: string;
+  endDate?: string;
+}
+interface DataQueryOptions {
+  comparison?: BuilderState;
+  filter?: GscComparisonFilter;
+  searchType?: GscSearchType;
+}
+interface DataDetailOptions {
+  comparison?: BuilderState;
+  searchType?: GscSearchType;
+}
+interface IndexingUrlsParams {
+  limit?: number;
+  offset?: number;
+  status?: GscdumpIndexingUrlStatus;
+  issue?: string;
+  search?: string;
+}
+interface GscdumpUserSettings {
+  browserAnalyzerEnabled: boolean;
+}
+interface GscdumpPermissionRecovery {
+  success: boolean;
+  permissionLevel: string | null;
+  jobsQueued: number;
+  message: string;
+}
+interface GscdumpTopAssociationParams {
+  type: 'topPage' | 'topKeyword';
+  identifier: string;
+  startDate: string;
+  endDate: string;
+}
+interface GscdumpTopAssociationResponse {
+  value: string | null;
+}
+interface GscdumpKeywordSparklinesParams {
+  keywords: string[];
+  startDate: string;
+  endDate: string;
+  searchType?: GscSearchType;
+}
+interface GscdumpKeywordSparklinesResponse {
+  sparklines: Record<string, number[]>;
+}
+interface GscdumpQueryTrendParams {
+  startDate: string;
+  endDate: string;
+  prevStartDate?: string;
+  prevEndDate?: string;
+  searchType?: GscSearchType;
+}
+interface GscdumpQueryTrendResponse {
+  daily: Array<{
+    date: string;
+    queryCount: number;
+  }>;
+  total: number;
+  previousTotal?: number;
+  meta: {
+    siteUrl: string;
+    syncStatus: string | null;
+  };
+}
+interface GscdumpPageTrendParams {
+  startDate: string;
+  endDate: string;
+  prevStartDate?: string;
+  prevEndDate?: string;
+  searchType?: GscSearchType;
+}
+interface GscdumpPageTrendResponse {
+  daily: Array<{
+    date: string;
+    pageCount: number;
+  }>;
+  total: number;
+  previousTotal?: number;
+  meta: {
+    siteUrl: string;
+    syncStatus: string | null;
+  };
+}
+interface GscdumpDateRangeParams {
+  startDate: string;
+  endDate: string;
+}
+interface GscdumpCanonicalMismatchRow {
+  url: string;
+  userCanonical: string;
+  googleCanonical: string;
+  verdict: string | null;
+  coverageState: string | null;
+  lastCrawlTime: string | null;
+  lastCheckedAt: string | null;
+}
+interface GscdumpCanonicalMismatchesResponse {
+  mismatches: GscdumpCanonicalMismatchRow[];
+  totalCount: number;
+  consolidationTargets: Array<{
+    google_canonical: string;
+    count: number;
+  }>;
+  trend: Array<{
+    date: string;
+    count: number;
+  }>;
+  meta: {
+    siteUrl: string;
+    syncStatus: string | null;
+  };
+}
+interface GscdumpIndexPercentTrendPoint {
+  date: string;
+  percent: number;
+  total: number;
+  visible: number;
+  added: number | null;
+  removed: number | null;
+}
+interface GscdumpInvisibleUrlRow {
+  url: string;
+  firstSeen?: string;
+  lastmod: string | null;
+}
+interface GscdumpOrphanPageRow {
+  url: string;
+  impressions: number | null;
+  clicks: number | null;
+}
+interface GscdumpIndexPercentSitemap {
+  path: string;
+  urlCount: number;
+  isIndex: boolean;
+}
+interface GscdumpIndexPercentResponse {
+  trend: GscdumpIndexPercentTrendPoint[];
+  invisibleUrls: GscdumpInvisibleUrlRow[];
+  invisibleCount: number;
+  orphanPages: GscdumpOrphanPageRow[];
+  orphanCount: number;
+  sitemaps: GscdumpIndexPercentSitemap[];
+  summary: {
+    currentPercent: number;
+    totalSitemapUrls: number;
+    visibleUrls: number;
+    change7d: number | null;
+    change28d: number | null;
+    dataDate: string;
+  };
+  meta: {
+    siteUrl: string;
+    syncStatus: string | null;
+    newestDateSynced: string | null;
+  };
+}
+interface GscdumpUserMeResponse {
+  id: string;
+  name?: string;
+  email: string;
+  picture?: string;
+  setupComplete: boolean;
+  databaseReady: boolean;
+  plan: string;
+  accountStatus: AccountStatus;
+  accountNextAction: AccountNextAction;
+  missingScopes: string[];
+  browserAnalyzerEnabled: boolean;
+  stats: {
+    activeSessions: number;
+    totalApiCalls: number;
+    lastUsed: number | null;
+  } | null;
+}
+interface GscdumpHealthResponse {
+  timestamp: number;
+  jobs: {
+    byStatus: Record<string, number>;
+    byQueue: Record<string, number>;
+    stuck: number;
+    oldCompleted: number;
+  };
+  failures: {
+    lastHour: number;
+  };
+  users: {
+    needsReauth: number;
+  };
+  throughput: {
+    completedLastHour: number;
+  };
+  totals: {
+    users: number;
+    sites: number;
+    byPlan: Record<string, number>;
+  };
+}
+interface GscdumpSyncProgressDateStatus {
+  date: string;
+  status: 'completed' | 'queued' | 'processing' | 'failed';
+}
+interface GscdumpSyncProgressPhaseCounts {
+  total: number;
+  done: number;
+  pending: number;
+  stuck: number;
+  failed: number;
+  percent: number;
+  rows: number;
+}
+interface GscdumpSyncProgressSite {
+  id: string;
+  userId: number;
+  partnerId: number | null;
+  siteUrl: string;
+  syncStatus: string | null;
+  lastError: string | null;
+  createdAt: number;
+  oldestDateSynced: string | null;
+  newestDateSynced: string | null;
+  oldestDateAvailable: string | null;
+  userEmail: string | null;
+  partnerName: string | null;
+  needsReauth: boolean;
+  authFailureCount: number;
+  currentPhase: 'initial' | 'backfill' | 'complete';
+  isStalled: boolean;
+  stallDays: number;
+  needsContinuation: boolean;
+  missingDays: number;
+  initial: GscdumpSyncProgressPhaseCounts;
+  backfill: GscdumpSyncProgressPhaseCounts & {
+    processing: number;
+    daysTarget: number;
+    daysQueued: number;
+  };
+  tables: Record<string, {
+    percent: number;
+    rows: number;
+  }>;
+  overallPercent: number;
+  totalRows: number;
+  dateStatuses: GscdumpSyncProgressDateStatus[];
+}
+interface GscdumpSyncProgressResponse {
+  summary: {
+    total: number;
+    inInitial: number;
+    inBackfill: number;
+    complete: number;
+    stalled: number;
+    authBlocked: number;
+    totalRows: number;
+    avgInitialPercent: number;
+    avgBackfillPercent: number;
+  };
+  sites: GscdumpSyncProgressSite[];
+  pagination: {
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+  };
+  hasD1Stats: boolean;
+}
+type GscdumpSyncJobStatus = 'queued' | 'processing' | 'completed' | 'failed' | 'scheduled';
+interface GscdumpSyncJobItem {
+  id: number;
+  userSiteId: string | null;
+  tableName?: string;
+  tableTier?: string;
+  date?: string;
+  priority?: string;
+  status: GscdumpSyncJobStatus;
+  siteUrl: string | null;
+  userEmail?: string | null;
+  rowsFetched: number | null;
+  rowsInserted: number | null;
+  error: string | null;
+  retryCount: number;
+  queuedAt: number;
+  startedAt: number | null;
+  completedAt: number | null;
+}
+interface GscdumpSyncJobsQueueCounts {
+  queued: number;
+  processing: number;
+}
+interface GscdumpSyncJobsResponse {
+  jobs: GscdumpSyncJobItem[];
+  summary: {
+    queued: number;
+    processing: number;
+    completed: number;
+    failed: number;
+  };
+  queues: Record<string, GscdumpSyncJobsQueueCounts>;
+  tiers?: {
+    critical: GscdumpSyncJobsQueueCounts | undefined;
+    standard: GscdumpSyncJobsQueueCounts | undefined;
+    extended: GscdumpSyncJobsQueueCounts | undefined;
+  };
+}
+interface GscdumpSiteReportResponse<TResult = unknown> {
+  status: 'done' | 'error';
+  cached: boolean;
+  result?: TResult;
+  error?: string;
+}
+interface GscdumpTeamRow {
+  id: string;
+  ownerId: number;
+  name: string;
+  personalTeam: boolean;
+  createdAt: number;
+  updatedAt: number;
+}
+interface GscdumpTeamMemberRow {
+  userId: number;
+  publicId: string;
+  name: string | null;
+  email: string;
+  picture: string | null;
+  role: 'admin' | 'editor' | 'viewer';
+  joinedAt: number;
+}
+interface CreatePartnerTeamParams {
+  ownerUserId: string;
+  name: string;
+  personalTeam?: boolean;
+}
+interface AddPartnerTeamMemberParams {
+  userId: string;
+  role: GscdumpTeamMemberRow['role'];
+}
+interface BindPartnerSiteTeamParams {
+  teamId: string | null;
+}
+interface PartnerClient {
+  registerUser: (params: RegisterPartnerUserParams) => Promise<GscdumpUserRegistration>;
+  updateUserTokens: (userId: string, params: UpdatePartnerUserTokensParams) => Promise<GscdumpUserTokenUpdate>;
+  getUserStatus: (userId: string) => Promise<GscdumpUserStatus>;
+  getUserLifecycle: (userId: string) => Promise<PartnerLifecycleResponse>;
+  waitForUserReady: (userId: string, options?: {
+    attempts?: number;
+    intervalMs?: number;
+  }) => Promise<GscdumpUserStatus>;
+  waitForUserLifecycleReady: (userId: string, options?: {
+    attempts?: number;
+    intervalMs?: number;
+  }) => Promise<PartnerLifecycleResponse>;
+  getUserSites: (userId: string) => Promise<{
+    sites: GscdumpUserSite[];
+  }>;
+  getAvailableSites: (userId: string) => Promise<{
+    sites: GscdumpAvailableSite[];
+  }>;
+  registerSite: (params: RegisterPartnerSiteParams) => Promise<GscdumpSiteRegistration>;
+  bulkRegisterSites: (params: BulkRegisterPartnerSitesParams) => Promise<BulkRegisterPartnerSitesResponse>;
+  deleteUser: (userId: string) => Promise<DeletePartnerUserResponse>;
+  deleteSite: (siteId: string) => Promise<{
+    success: boolean;
+  }>;
+  getAnalysisSources: (siteId: string, tables?: string[] | string | AnalysisSourcesOptions, options?: SearchTypeOptions | SourceInfoOptions) => Promise<GscdumpAnalysisSourcesResponse>;
+  getSiteSyncStatus: (siteId: string, userId?: string) => Promise<GscdumpSyncStatusResponse>;
+  getData: (siteId: string, state: BuilderState, options?: DataQueryOptions) => Promise<GscdumpDataResponse>;
+  getDataDetail: (siteId: string, state: BuilderState, options?: DataDetailOptions) => Promise<GscdumpDataDetailResponse>;
+  getAnalysis: (siteId: string, params: GscdumpAnalysisParams) => Promise<GscdumpAnalysisResponse>;
+  getSitemaps: (siteId: string) => Promise<GscdumpSitemapsResponse>;
+  getSitemapChanges: (siteId: string, days?: number) => Promise<GscdumpSitemapChangesResponse>;
+  submitSitemap: (siteId: string, sitemapUrl: string, action?: 'submit' | 'delete') => Promise<{
+    success: boolean;
+    action: 'submitted' | 'deleted';
+    sitemapUrl: string;
+  }>;
+  refreshSitemaps: (siteId: string) => Promise<{
+    success: boolean;
+    action: 'refreshed';
+    sitemapCount: number;
+    changed: boolean;
+  }>;
+  getIndexing: (siteId: string, days?: number) => Promise<GscdumpIndexingResponse>;
+  getIndexingUrls: (siteId: string, params?: IndexingUrlsParams) => Promise<GscdumpIndexingUrlsResponse>;
+  getIndexingDiagnostics: (siteId: string) => Promise<GscdumpIndexingDiagnosticsResponse>;
+  requestIndexingInspect: (siteId: string, body: IndexingInspectRequest) => Promise<IndexingInspectResponse | IndexingInspectRateLimited>;
+  getUserSettings: () => Promise<GscdumpUserSettings>;
+  patchUserSettings: (body: Partial<GscdumpUserSettings>) => Promise<GscdumpUserSettings>;
+  recoverPermission: (siteId: string) => Promise<GscdumpPermissionRecovery>;
+  getTopAssociation: (siteId: string, params: GscdumpTopAssociationParams) => Promise<GscdumpTopAssociationResponse>;
+  getKeywordSparklines: (siteId: string, params: GscdumpKeywordSparklinesParams) => Promise<GscdumpKeywordSparklinesResponse>;
+  getQueryTrend: (siteId: string, params: GscdumpQueryTrendParams) => Promise<GscdumpQueryTrendResponse>;
+  getPageTrend: (siteId: string, params: GscdumpPageTrendParams) => Promise<GscdumpPageTrendResponse>;
+  getCanonicalMismatches: (siteId: string) => Promise<GscdumpCanonicalMismatchesResponse>;
+  getContentVelocity: <T = unknown>(siteId: string, days?: number) => Promise<T>;
+  getCtrCurve: <T = unknown>(siteId: string, params: GscdumpDateRangeParams) => Promise<T>;
+  getDarkTraffic: <T = unknown>(siteId: string, params: GscdumpDateRangeParams) => Promise<T>;
+  getDeviceGap: <T = unknown>(siteId: string, params: GscdumpDateRangeParams) => Promise<T>;
+  getIndexPercent: (siteId: string, params?: {
+    invisibleLimit?: number;
+    invisibleOffset?: number;
+    orphanLimit?: number;
+  }) => Promise<GscdumpIndexPercentResponse>;
+  getKeywordBreadth: <T = unknown>(siteId: string, params: GscdumpDateRangeParams) => Promise<T>;
+  getPositionDistribution: <T = unknown>(siteId: string, params: GscdumpDateRangeParams) => Promise<T>;
+  createTeam: (params: CreatePartnerTeamParams) => Promise<{
+    team: GscdumpTeamRow;
+  }>;
+  renameTeam: (teamId: string, params: {
+    name: string;
+  }) => Promise<{
+    ok: true;
+    name: string;
+  }>;
+  deleteTeam: (teamId: string) => Promise<{
+    ok: true;
+  }>;
+  listTeamMembers: (teamId: string) => Promise<{
+    members: GscdumpTeamMemberRow[];
+  }>;
+  addTeamMember: (teamId: string, params: AddPartnerTeamMemberParams) => Promise<{
+    ok: true;
+    role: string;
+    alreadyExisted?: boolean;
+  }>;
+  updateTeamMemberRole: (teamId: string, userId: string, params: {
+    role: GscdumpTeamMemberRow['role'];
+  }) => Promise<{
+    ok: true;
+    role: string;
+  }>;
+  removeTeamMember: (teamId: string, userId: string) => Promise<{
+    ok: true;
+  }>;
+  bindSiteToTeam: (userId: string, siteId: string, params: BindPartnerSiteTeamParams) => Promise<{
+    ok: true;
+    teamId: string | null;
+  }>;
+}
+type PartnerRealtimeEventType = 'sync.progress' | 'sync.complete' | 'sync.job_complete' | 'sync.site_complete' | 'sync.failed' | 'job.failed' | 'auth.failed' | 'auth.needs_reauth' | 'site.added' | 'site.removed' | 'enrichment.complete';
+interface RealtimeSyncProgressEvent {
+  event: 'sync.progress';
+  siteId: string;
+  siteUrl: string;
+  table: string;
+  date: string;
+  progress: number;
+}
+interface RealtimeSyncCompleteEvent {
+  event: 'sync.complete';
+  userId: number;
+  siteId: string;
+  siteUrl: string;
+  table: string;
+  date: string;
+  rowsFetched: number;
+  rowsInserted: number;
+  timestamp: number;
+}
+interface RealtimeSyncJobCompleteEvent {
+  event: 'sync.job_complete';
+  userId: number;
+  siteId: string;
+  siteUrl: string;
+  table: string;
+  date: string;
+  rowsFetched: number;
+  rowsInserted: number;
+  syncStatus: string;
+  timestamp: number;
+}
+interface RealtimeSyncSiteCompleteEvent {
+  event: 'sync.site_complete';
+  userId: number;
+  siteId: string;
+  siteUrl: string;
+  syncStatus: string;
+  timestamp: number;
+}
+interface RealtimeSyncFailedEvent {
+  event: 'sync.failed';
+  userId: number;
+  siteId: string;
+  siteUrl: string;
+  table: string;
+  date: string;
+  error: string;
+  timestamp: number;
+}
+interface RealtimeJobFailedEvent {
+  event: 'job.failed';
+  siteId: string;
+  siteUrl: string;
+  table: string;
+  date: string;
+  error: string;
+  timestamp: number;
+}
+interface RealtimeSiteAddedEvent {
+  event: 'site.added';
+  userId: number;
+  siteId: string;
+  siteUrl: string;
+}
+interface RealtimeSiteRemovedEvent {
+  event: 'site.removed';
+  userId: number;
+  siteId: string;
+  siteUrl: string;
+}
+interface RealtimeAuthFailedEvent {
+  event: 'auth.failed';
+  userId: number;
+  siteId: string;
+  siteUrl: string;
+  error: string;
+  timestamp: number;
+}
+interface RealtimeNeedsReauthEvent {
+  event: 'auth.needs_reauth';
+  userId: number;
+  failureCount: number;
+  timestamp: number;
+}
+interface RealtimeEnrichmentCompleteEvent {
+  event: 'enrichment.complete';
+  siteId: string;
+  userId: number;
+  timestamp: number;
+}
+type PartnerRealtimeEvent = RealtimeSyncProgressEvent | RealtimeSyncCompleteEvent | RealtimeSyncJobCompleteEvent | RealtimeSyncSiteCompleteEvent | RealtimeSyncFailedEvent | RealtimeJobFailedEvent | RealtimeSiteAddedEvent | RealtimeSiteRemovedEvent | RealtimeAuthFailedEvent | RealtimeNeedsReauthEvent | RealtimeEnrichmentCompleteEvent;
+interface RealtimeAuthRequiredMessage {
+  event: 'auth.required';
+  message: string;
+}
+interface RealtimeConnectedMessage {
+  event: 'connected';
+  partnerId?: string;
+  userId?: number;
+  message: string;
+}
+interface RealtimeSubscribedMessage {
+  type: 'subscribed';
+  siteIds?: string[];
+  partnerIds?: string[];
+}
+interface RealtimePongMessage {
+  type: 'pong';
+  timestamp: number;
+}
+interface RealtimeErrorMessage {
+  type: 'error';
+  message: string;
+}
+type PartnerRealtimeMessage = PartnerRealtimeEvent | RealtimeAuthRequiredMessage | RealtimeConnectedMessage | RealtimeSubscribedMessage | RealtimePongMessage | RealtimeErrorMessage;
+type CanonicalWebhookEventType = 'user.lifecycle.changed' | 'site.lifecycle.changed' | 'site.analytics.ready' | 'site.indexing.ready' | 'site.auth.failed' | 'job.failed';
+type WebhookEventType = CanonicalWebhookEventType;
+interface WebhookEnvelope<TData extends Record<string, unknown> = Record<string, unknown>> {
+  contractVersion: string;
+  deliveryId: string;
+  event: CanonicalWebhookEventType;
+  partnerId: string;
+  userId: string | null;
+  siteId?: string;
+  externalUserId?: string | null;
+  externalSiteId?: string | null;
+  lifecycleRevision: number;
+  occurredAt: string;
+  data: TData;
+}
+type PartnerWebhookData = Record<string, unknown>;
+interface CreateWebhookEnvelopeOptions<TData extends Record<string, unknown> = Record<string, unknown>> {
+  event: CanonicalWebhookEventType;
+  partnerId: string;
+  userId: string | null;
+  siteId?: string;
+  externalUserId?: string | null;
+  externalSiteId?: string | null;
+  lifecycleRevision: number;
+  data: TData;
+  deliveryId?: string;
+  occurredAt?: string | Date;
+  contractVersion?: string;
+}
+interface PartnerWebhookHeaders {
+  event?: string | null;
+  delivery?: string | null;
+  contractVersion?: string | null;
+  timestamp?: string | null;
+  signature?: string | null;
+}
+export { AccountNextAction, AccountStatus, AddPartnerTeamMemberParams, AnalysisSourcesOptions, AnalysisSourcesResponse, AnalyticsClient, AnalyticsNextAction, AnalyticsStatus, BackfillRange, BackfillResponse, BindPartnerSiteTeamParams, BuilderState, BulkRegisterPartnerSiteResult, BulkRegisterPartnerSitesParams, BulkRegisterPartnerSitesResponse, CanonicalWebhookEventType, ColumnDef, ColumnType, CountriesResponse, CountryRow, CreatePartnerTeamParams, CreateWebhookEnvelopeOptions, DataDetailOptions, DataQueryOptions, DeletePartnerUserResponse, Dimension, Filter, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSCDUMP_WRITE_ANALYTICS_SCOPE, Grain, GscApiRange, GscComparisonFilter, GscRowQueryMeta, GscRowQueryResponse, GscSearchType, GscdumpAnalysisParams, GscdumpAnalysisPreset, GscdumpAnalysisResponse, GscdumpAnalysisSourcesResponse, GscdumpAvailableSite, GscdumpCanonicalMismatchRow, GscdumpCanonicalMismatchesResponse, GscdumpDataDetailResponse, GscdumpDataResponse, GscdumpDataRow, GscdumpDateRangeParams, GscdumpHealthResponse, GscdumpIndexPercentResponse, GscdumpIndexPercentSitemap, GscdumpIndexPercentTrendPoint, GscdumpIndexingDiagnosticsResponse, GscdumpIndexingInspectRateLimited, GscdumpIndexingInspectRequest, GscdumpIndexingInspectResponse, GscdumpIndexingInspectResult, GscdumpIndexingIssueSeverity, GscdumpIndexingResponse, GscdumpIndexingTrendPoint, GscdumpIndexingUrl, GscdumpIndexingUrlStatus, GscdumpIndexingUrlsResponse, GscdumpInvisibleUrlRow, GscdumpKeywordSparklinesParams, GscdumpKeywordSparklinesResponse, GscdumpMeta, GscdumpOrphanPageRow, GscdumpPageTrendParams, GscdumpPageTrendResponse, GscdumpPerSitemapHistoryEntry, GscdumpPermissionRecovery, GscdumpQueryTrendParams, GscdumpQueryTrendResponse, GscdumpRichResultItem, GscdumpSiteRegistration, GscdumpSiteReportResponse, GscdumpSitemap, GscdumpSitemapChangesResponse, GscdumpSitemapHistory, GscdumpSitemapsResponse, GscdumpSyncJobItem, GscdumpSyncJobStatus, GscdumpSyncJobsQueueCounts, GscdumpSyncJobsResponse, GscdumpSyncProgressDateStatus, GscdumpSyncProgressPhaseCounts, GscdumpSyncProgressResponse, GscdumpSyncProgressSite, GscdumpSyncStatusResponse, GscdumpTeamMemberRow, GscdumpTeamRow, GscdumpTopAssociationParams, GscdumpTopAssociationResponse, GscdumpTotals, GscdumpUserMeResponse, GscdumpUserRegistration, GscdumpUserSettings, GscdumpUserSite, GscdumpUserStatus, GscdumpUserTokenUpdate, IndexingDiagnostics, IndexingInspectRateLimit, IndexingInspectRateLimited, IndexingInspectRequest, IndexingInspectResponse, IndexingInspectResult, IndexingIssue, IndexingIssueSeverity, IndexingNextAction, IndexingStatus, IndexingUrlRow, IndexingUrlStatus, IndexingUrlsParams, IndexingUrlsResponse, InspectionHistoryRecord, InspectionHistoryResponse, InspectionIndex, InspectionRecordRaw, LifecycleError, LifecycleErrorCode, LifecycleProgress, LifecycleWebhookEnvelope, LifecycleWebhookEvent, Metric, PartnerClient, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite, PartnerRealtimeEvent, PartnerRealtimeEventType, PartnerRealtimeMessage, PartnerWebhookData, PartnerWebhookHeaders, PropertyNextAction, PropertyStatus, QuerySourceMode, RealtimeAuthFailedEvent, RealtimeAuthRequiredMessage, RealtimeConnectedMessage, RealtimeEnrichmentCompleteEvent, RealtimeErrorMessage, RealtimeJobFailedEvent, RealtimeNeedsReauthEvent, RealtimePongMessage, RealtimeSiteAddedEvent, RealtimeSiteRemovedEvent, RealtimeSubscribedMessage, RealtimeSyncCompleteEvent, RealtimeSyncFailedEvent, RealtimeSyncJobCompleteEvent, RealtimeSyncProgressEvent, RealtimeSyncSiteCompleteEvent, RegisterPartnerSiteParams, RegisterPartnerUserParams, RollupEnvelope, Row, ScheduleState, SearchAppearanceResponse, SearchAppearanceRow, SearchTypeOptions, SiteListItem, SitemapAddedRow, SitemapChangesResponse, SitemapHistoryRecord, SitemapHistoryResponse, SitemapIndex, SitemapNextAction, SitemapRemovedRow, SitemapStatus, SourceInfoOptions, SourceInfoResponse, TableName, TableSchema, TenantCtx, UpdatePartnerUserTokensParams, WebhookEnvelope, WebhookEventType, WhoamiResponse, accountNextActions, accountStatuses, analyticsNextActions, analyticsStatuses, hasOptionalIndexingScope, hasRequiredAnalyticsScope, indexingNextActions, indexingStatuses, lifecycleErrorCodes, lifecycleWebhookEvents, parseGrantedScopes, propertyNextActions, propertyStatuses, querySourceModes, sitemapNextActions, sitemapStatuses };