@gscdump/contracts 3.5.0 → 3.6.0

package/dist/types.d.mts

@@ -1,35 +1,35 @@
 import { GscSearchType } from "./search-types.mjs";
 import { FileResolutionResponse } from "./file-resolution.mjs";
 import { AccountNextAction, AccountStatus, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite } from "./onboarding.mjs";
-type TableName = 'pages' | 'queries' | 'countries' | 'page_queries' | 'dates' | 'search_appearance' | 'search_appearance_pages' | 'search_appearance_queries' | 'search_appearance_page_queries' | 'hourly_pages';
+export 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 {
+export type Grain = 'day' | 'hour';
+export type Row = Record<string, unknown>;
+export type ColumnType = 'DATE' | 'VARCHAR' | 'INTEGER' | 'BIGINT' | 'DOUBLE';
+export interface ColumnDef {
   name: string;
   type: ColumnType;
   nullable: boolean;
 }
-interface TableSchema {
+export interface TableSchema {
   name: TableName;
   columns: ColumnDef[];
   sortKey: string[];
   version: number;
 }
-interface TenantCtx {
+export interface TenantCtx {
   userId: string;
   siteId?: string;
 }
-type Dimension = 'page' | 'query' | 'queryCanonical' | 'country' | 'device' | 'date' | 'searchAppearance' | 'hour';
-type Metric = 'clicks' | 'impressions' | 'ctr' | 'position';
-type Filter = unknown;
-interface BuilderStateWire {
+export type Dimension = 'page' | 'query' | 'queryCanonical' | 'country' | 'device' | 'date' | 'searchAppearance' | 'hour';
+export type Metric = 'clicks' | 'impressions' | 'ctr' | 'position';
+export type Filter = unknown;
+export interface BuilderStateWire {
   dimensions: Dimension[];
   metrics?: Metric[];
   filter?: Filter;
@@ -41,42 +41,42 @@ interface BuilderStateWire {
   startRow?: number;
   searchType?: GscSearchType;
 }
-interface GscApiRange {
+export interface GscApiRange {
   start: string;
   end: string;
 }
-interface CountryRow {
+export interface CountryRow {
   country: string;
   clicks: number;
   impressions: number;
   sum_position: number;
 }
-interface CountriesResponse {
+export interface CountriesResponse {
   rows: CountryRow[];
   range: GscApiRange;
   generatedAt: string;
   source: 'gsc-api' | 'engine';
 }
-interface SearchAppearanceRow {
+export interface SearchAppearanceRow {
   searchAppearance: string;
   clicks: number;
   impressions: number;
   sum_position: number;
 }
-interface SearchAppearanceResponse {
+export interface SearchAppearanceResponse {
   rows: SearchAppearanceRow[];
   range: GscApiRange;
   generatedAt: string;
   source: 'gsc-api' | 'engine';
 }
-interface SiteListItem {
+export interface SiteListItem {
   id: string;
   label: string;
   hostname: string;
   propertyType: 'domain' | 'url-prefix';
   readBackend?: 'd1' | 'r2';
 }
-interface ScheduleState {
+export interface ScheduleState {
   nextAt: number;
   consecutiveUnchanged: number;
   policyVersion: number;
@@ -91,7 +91,7 @@ interface ScheduleState {
  * Additional keys are tolerated (`[key: string]: unknown`) for
  * forward-compatibility — new fields can ship without a contract bump.
  */
-interface InspectionRecordRaw {
+export interface InspectionRecordRaw {
   /** Adaptive recheck schedule owned by `inspectionPolicy.observe`. */
   schedule?: ScheduleState;
   /** Unix seconds. Mirrors the `next_check_after` column. */
@@ -112,7 +112,7 @@ interface InspectionRecordRaw {
   inspectionResultLink?: string | null;
   [key: string]: unknown;
 }
-interface InspectionHistoryRecord {
+export interface InspectionHistoryRecord {
   url: string;
   inspectedAt: string;
   indexStatus?: string;
@@ -127,32 +127,32 @@ interface InspectionHistoryRecord {
   richResultsVerdict?: string;
   raw?: InspectionRecordRaw;
 }
-interface InspectionHistoryResponse {
+export interface InspectionHistoryResponse {
   url: string | null;
   records: InspectionHistoryRecord[];
 }
-interface InspectionIndex {
+export interface InspectionIndex {
   version: 1;
   records: Record<string, InspectionHistoryRecord>;
 }
-interface RollupEnvelope<T = unknown> {
+export interface RollupEnvelope<T = unknown> {
   version: 1;
   id: string;
   builtAt: number;
   windowDays: number | null;
   payload: T;
 }
-interface GscRowQueryMeta {
+export interface GscRowQueryMeta {
   sourceName: string;
   sourceKind: 'row' | 'sql';
   queryMs: number;
 }
-interface GscRowQueryResponse<T = Record<string, unknown>> {
+export interface GscRowQueryResponse<T = Record<string, unknown>> {
   rows: T[];
   meta: GscRowQueryMeta;
 }
-type IndexingUrlStatus = 'indexed' | 'not_indexed' | 'pending';
-interface IndexingUrlRow {
+export type IndexingUrlStatus = 'indexed' | 'not_indexed' | 'pending';
+export interface IndexingUrlRow {
   url: string;
   issueType?: string | null;
   verdict: string | null;
@@ -175,7 +175,7 @@ interface IndexingUrlRow {
   lastCheckedAt: string;
   checkCount: number;
 }
-interface IndexingUrlsResponse {
+export interface IndexingUrlsResponse {
   urls: IndexingUrlRow[];
   pagination: {
     total: number;
@@ -189,8 +189,8 @@ interface IndexingUrlsResponse {
     issue: string | null;
   };
 }
-type IndexingIssueSeverity = 'error' | 'warning' | 'info';
-interface IndexingIssue {
+export type IndexingIssueSeverity = 'error' | 'warning' | 'info';
+export interface IndexingIssue {
   type: string;
   label: string;
   severity: IndexingIssueSeverity;
@@ -198,7 +198,7 @@ interface IndexingIssue {
   description: string;
   fix: string;
 }
-interface IndexingDiagnostics {
+export interface IndexingDiagnostics {
   summary: {
     totalUrls: number;
     indexed: number;
@@ -215,14 +215,14 @@ interface IndexingDiagnostics {
     rollupBuiltAt?: number;
   };
 }
-interface IndexingDiagnosticsParams {
+export interface IndexingDiagnosticsParams {
   sampleIssues?: string[] | string;
   sampleLimit?: number;
 }
-interface IndexingInspectRequest {
+export interface IndexingInspectRequest {
   urls: string[];
 }
-interface IndexingInspectResult {
+export interface IndexingInspectResult {
   url: string;
   verdict: string | null;
   coverageState: string | null;
@@ -241,12 +241,12 @@ interface IndexingInspectResult {
   richResultsItems: string | null;
   inspectionResultLink: string | null;
 }
-interface IndexingInspectRateLimit {
+export interface IndexingInspectRateLimit {
   reserved: number;
   remaining: number;
   limit: number;
 }
-interface IndexingInspectResponse {
+export interface IndexingInspectResponse {
   siteId: string;
   rateLimit: IndexingInspectRateLimit;
   results: IndexingInspectResult[];
@@ -259,7 +259,7 @@ interface IndexingInspectResponse {
     reason: string;
   }>;
 }
-interface IndexingInspectRateLimited {
+export interface IndexingInspectRateLimited {
   error: 'rate_limited';
   message: string;
   rateLimit: {
@@ -269,17 +269,17 @@ interface IndexingInspectRateLimited {
   };
   retryAfterSeconds: number;
 }
-interface SitemapAddedRow {
+export interface SitemapAddedRow {
   url: string;
   sitemap: string;
   firstSeenAt: number;
 }
-interface SitemapRemovedRow {
+export interface SitemapRemovedRow {
   url: string;
   sitemap: string;
   removedAt: number;
 }
-type SitemapChangesCompleteness = {
+export type SitemapChangesCompleteness = {
   _tag: 'complete';
   scannedUrls: number;
 } | {
@@ -294,7 +294,7 @@ type SitemapChangesCompleteness = {
     updated: number;
   };
 };
-interface SitemapChangesResponse {
+export interface SitemapChangesResponse {
   added: SitemapAddedRow[];
   removed: SitemapRemovedRow[];
   summary: {
@@ -307,8 +307,8 @@ interface SitemapChangesResponse {
   };
   completeness: SitemapChangesCompleteness;
 }
-type AnalysisSourcesResponse = GscdumpAnalysisSourcesResponse;
-interface SourceInfoResponse {
+export type AnalysisSourcesResponse = GscdumpAnalysisSourcesResponse;
+export interface SourceInfoResponse {
   name: string;
   kind: 'row' | 'sql';
   capabilities: {
@@ -319,22 +319,22 @@ interface SourceInfoResponse {
   browserAttachEligible: boolean;
   identityAttrs?: Record<string, unknown> | null;
 }
-interface WhoamiResponse {
+export interface WhoamiResponse {
   userId?: string | null;
   plan?: string | null;
   attrs?: Record<string, unknown>;
 }
-interface BackfillRange {
+export interface BackfillRange {
   startDate: string;
   endDate: string;
 }
-interface BackfillResponse {
+export interface BackfillResponse {
   ok?: boolean;
   queued?: boolean;
   [key: string]: unknown;
 }
-type GscComparisonFilter = 'new' | 'lost' | 'improving' | 'declining';
-interface GscdumpDataRow {
+export type GscComparisonFilter = 'new' | 'lost' | 'improving' | 'declining';
+export interface GscdumpDataRow {
   page?: string;
   query?: string;
   queryCanonical?: string;
@@ -364,7 +364,7 @@ interface GscdumpDataRow {
   firstDate?: string;
   lastDate?: string;
 }
-interface GscdumpMeta {
+export interface GscdumpMeta {
   siteUrl: string;
   syncStatus: string;
   newestDateSynced: string | null;
@@ -381,19 +381,19 @@ interface GscdumpMeta {
     daysRemaining?: number;
   };
 }
-interface GscdumpTotals {
+export interface GscdumpTotals {
   clicks: number;
   impressions: number;
   ctr: number;
   position: number;
 }
-interface GscdumpDataResponse {
+export interface GscdumpDataResponse {
   rows: GscdumpDataRow[];
   totalCount: number;
   totals: GscdumpTotals;
   meta: GscdumpMeta;
 }
-interface GscdumpDataDetailResponse {
+export interface GscdumpDataDetailResponse {
   daily: Array<{
     date: string;
     clicks: number;
@@ -412,13 +412,13 @@ interface GscdumpDataDetailResponse {
   previousTotals?: GscdumpTotals;
   meta: GscdumpMeta;
 }
-interface GscdumpUserRegistration {
+export interface GscdumpUserRegistration {
   userId: string;
   apiKey?: string;
   isNew?: boolean;
   status?: 'provisioning' | 'ready';
 }
-interface GscdumpUserStatus {
+export interface GscdumpUserStatus {
   userId: string;
   status: 'provisioning' | 'ready' | 'reauth_required';
   databaseReady?: boolean;
@@ -429,12 +429,12 @@ interface GscdumpUserStatus {
   nextAction?: 'reconnect_google' | 'none';
   grantedScopes?: string | null;
 }
-interface GscdumpUserTokenUpdate {
+export interface GscdumpUserTokenUpdate {
   userId: string;
   updated: boolean;
   sites: GscdumpAvailableSite[];
 }
-interface GscdumpAvailableSite {
+export interface GscdumpAvailableSite {
   siteUrl: string;
   permissionLevel: string;
   registered: boolean;
@@ -452,16 +452,16 @@ interface GscdumpAvailableSite {
   newestDateSynced?: string | null;
   oldestDateSynced?: string | null;
 }
-interface GscdumpSiteIntIdCrosswalkEntry {
+export interface GscdumpSiteIntIdCrosswalkEntry {
   siteId: string;
   intId: number;
   siteUrl: string;
 }
-interface GscdumpSiteIntIdCrosswalkResponse {
+export interface GscdumpSiteIntIdCrosswalkResponse {
   crosswalk: Record<string, number>;
   sites: GscdumpSiteIntIdCrosswalkEntry[];
 }
-interface GscdumpSiteRegistration {
+export interface GscdumpSiteRegistration {
   siteId: string;
   /** Integer alias (`user_sites.int_id`) — the int JOIN key partners denormalize into their own catalog namespaces. */
   intId?: number | null;
@@ -476,22 +476,22 @@ interface GscdumpSiteRegistration {
   grantedScopes?: string[];
   site?: PartnerLifecycleSite | null;
 }
-type GscVerificationMethod = 'META' | 'FILE' | 'DNS_TXT' | 'DNS_CNAME' | 'ANALYTICS' | 'TAG_MANAGER';
-interface GscVerificationSite {
+export type GscVerificationMethod = 'META' | 'FILE' | 'DNS_TXT' | 'DNS_CNAME' | 'ANALYTICS' | 'TAG_MANAGER';
+export interface GscVerificationSite {
   type: 'SITE' | 'INET_DOMAIN';
   identifier: string;
 }
-interface GscVerificationDnsRecord {
+export interface GscVerificationDnsRecord {
   type: 'TXT' | 'CNAME';
   host: string;
   value: string;
 }
-interface GscVerificationRequest {
+export interface GscVerificationRequest {
   userId?: string;
   siteUrl: string;
   method?: GscVerificationMethod;
 }
-interface GscVerificationTokenResponse {
+export interface GscVerificationTokenResponse {
   siteUrl: string;
   site: GscVerificationSite;
   method: GscVerificationMethod;
@@ -499,14 +499,14 @@ interface GscVerificationTokenResponse {
   metaContent: string | null;
   dnsRecord: GscVerificationDnsRecord | null;
 }
-interface GscAddAndVerifyResponse {
+export interface GscAddAndVerifyResponse {
   siteUrl: string;
   site: GscVerificationSite;
   method: GscVerificationMethod;
   verified: true;
   owners: string[];
 }
-interface GscdumpUserSite {
+export interface GscdumpUserSite {
   siteId: string;
   siteUrl: string;
   analyticsSyncStatus?: 'idle' | 'pending' | 'syncing' | 'synced' | 'error';
@@ -539,7 +539,7 @@ interface GscdumpUserSite {
   newestDateSynced: string | null;
   oldestDateSynced: string | null;
 }
-interface GscdumpSyncStatusResponse {
+export interface GscdumpSyncStatusResponse {
   siteUrl: string;
   syncStatus: 'pending' | 'syncing' | 'synced' | 'error';
   oldestDateAvailable: string | null;
@@ -582,7 +582,7 @@ interface GscdumpSyncStatusResponse {
     retryCount: number;
   }>;
 }
-interface GscdumpSitemap {
+export interface GscdumpSitemap {
   path: string;
   errors: number;
   warnings: number;
@@ -594,20 +594,20 @@ interface GscdumpSitemap {
   isPending: boolean;
   fetchedAt: number;
 }
-interface GscdumpSitemapHistory {
+export interface GscdumpSitemapHistory {
   date: string;
   errors: number;
   warnings: number;
   urlCount: number;
   urlDelta: number;
 }
-interface GscdumpPerSitemapHistoryEntry {
+export interface GscdumpPerSitemapHistoryEntry {
   date: string;
   urlCount: number;
   changed: boolean;
   urlDelta: number;
 }
-interface GscdumpSitemapsResponse {
+export interface GscdumpSitemapsResponse {
   sitemaps: GscdumpSitemap[];
   history: GscdumpSitemapHistory[];
   perSitemapHistory: Record<string, GscdumpPerSitemapHistoryEntry[]>;
@@ -622,7 +622,7 @@ interface GscdumpSitemapsResponse {
   };
   generation: GscdumpSitemapGeneration | null;
 }
-interface GscdumpSitemapChangesResponse {
+export interface GscdumpSitemapChangesResponse {
   added: {
     url: string;
     sitemap: string;
@@ -651,7 +651,7 @@ interface GscdumpSitemapChangesResponse {
   completeness: SitemapChangesCompleteness;
   generation: GscdumpSitemapGeneration | null;
 }
-interface GscdumpSitemapGeneration {
+export interface GscdumpSitemapGeneration {
   id: string;
   observedAt: number;
   publishedAt: number;
@@ -668,13 +668,13 @@ interface GscdumpSitemapGeneration {
     source: 'gsc_sitemaps';
   };
 }
-type PartnerSitemapAction = {
+export type PartnerSitemapAction = {
   action: 'submit' | 'delete';
   sitemapUrl: string;
 } | {
   action: 'refresh' | 'auto-discover';
 };
-type PartnerSitemapActionResponse = {
+export type PartnerSitemapActionResponse = {
   success: boolean;
   action: 'submitted' | 'deleted';
   sitemapUrl: string;
@@ -692,11 +692,11 @@ type PartnerSitemapActionResponse = {
   submitError?: string | null;
   sitemapCount: number;
 };
-interface GscdumpSitemapMembershipParams {
+export interface GscdumpSitemapMembershipParams {
   urls: string[];
   generationId?: string;
 }
-type GscdumpSitemapMembershipEvidence = {
+export type GscdumpSitemapMembershipEvidence = {
   _tag: 'present';
   url: string;
   feedpath: string;
@@ -712,7 +712,7 @@ type GscdumpSitemapMembershipEvidence = {
   url: string;
   reason: 'no_generation' | 'generation_not_found' | 'generation_incomplete' | 'history_pruned' | 'invalid_url';
 };
-interface GscdumpSitemapMembershipResponse {
+export interface GscdumpSitemapMembershipResponse {
   generation: GscdumpSitemapGeneration | null;
   evidence: GscdumpSitemapMembershipEvidence[];
   meta: {
@@ -721,7 +721,7 @@ interface GscdumpSitemapMembershipResponse {
     matched: number;
   };
 }
-interface GscdumpSitemapUrlsResponse {
+export interface GscdumpSitemapUrlsResponse {
   generation: GscdumpSitemapGeneration;
   items: Array<{
     url: string;
@@ -735,7 +735,7 @@ interface GscdumpSitemapUrlsResponse {
     limit: number;
   };
 }
-interface GscdumpSitemapExportResponse {
+export interface GscdumpSitemapExportResponse {
   generation: GscdumpSitemapGeneration;
   export: {
     _tag: 'url';
@@ -748,7 +748,7 @@ interface GscdumpSitemapExportResponse {
     reason: 'generation_not_found' | 'export_unavailable';
   };
 }
-interface GscdumpIndexingTrendPoint {
+export interface GscdumpIndexingTrendPoint {
   date: string;
   totalUrls: number;
   indexedCount: number | null;
@@ -775,7 +775,7 @@ interface GscdumpIndexingTrendPoint {
     richResultsFail: number;
   };
 }
-interface GscdumpIndexingResponse {
+export interface GscdumpIndexingResponse {
   trend: GscdumpIndexingTrendPoint[];
   summary: {
     totalUrls: number;
@@ -813,14 +813,14 @@ interface GscdumpIndexingResponse {
     rollupBuiltAt?: number;
   };
 }
-type GscdumpIndexingUrlStatus = 'indexed' | 'not_indexed' | 'pending';
-type GscdumpIndexingIssueSeverity = 'error' | 'warning' | 'info';
-type GscdumpCanonicalDifferenceKind = 'none' | 'formatting' | 'path' | 'cross_domain';
-interface GscdumpRichResultItem {
+export type GscdumpIndexingUrlStatus = 'indexed' | 'not_indexed' | 'pending';
+export type GscdumpIndexingIssueSeverity = 'error' | 'warning' | 'info';
+export type GscdumpCanonicalDifferenceKind = 'none' | 'formatting' | 'path' | 'cross_domain';
+export interface GscdumpRichResultItem {
   richResultType: string;
   items?: unknown[];
 }
-interface GscdumpIndexingUrl {
+export interface GscdumpIndexingUrl {
   url: string;
   issueType?: string | null;
   verdict: string | null;
@@ -844,7 +844,7 @@ interface GscdumpIndexingUrl {
   lastCheckedAt: string;
   checkCount?: number;
 }
-interface GscdumpIndexingUrlsResponse {
+export interface GscdumpIndexingUrlsResponse {
   urls: GscdumpIndexingUrl[];
   pagination: {
     total: number;
@@ -859,7 +859,7 @@ interface GscdumpIndexingUrlsResponse {
     issue: string | null;
   };
 }
-interface GscdumpIndexingDiagnosticsResponse {
+export interface GscdumpIndexingDiagnosticsResponse {
   summary: {
     totalUrls: number;
     indexed: number;
@@ -883,12 +883,12 @@ interface GscdumpIndexingDiagnosticsResponse {
     rollupBuiltAt?: number;
   };
 }
-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 {
+export type GscdumpIndexingInspectRequest = IndexingInspectRequest;
+export type GscdumpIndexingInspectResult = IndexingInspectResult;
+export type GscdumpIndexingInspectResponse = IndexingInspectResponse;
+export type GscdumpIndexingInspectRateLimited = IndexingInspectRateLimited;
+export type GscdumpAnalysisPreset = 'striking-distance' | 'opportunity' | 'decay' | 'zero-click' | 'non-brand' | 'brand-only' | 'movers-rising' | 'movers-declining';
+export interface GscdumpAnalysisParams {
   preset: GscdumpAnalysisPreset;
   startDate: string;
   endDate: string;
@@ -904,7 +904,7 @@ interface GscdumpAnalysisParams {
   maxCtr?: number;
   searchType?: GscSearchType;
 }
-interface GscdumpAnalysisResponse {
+export interface GscdumpAnalysisResponse {
   preset: GscdumpAnalysisPreset;
   keywords: Array<Record<string, unknown>>;
   totalCount: number;
@@ -921,10 +921,10 @@ interface GscdumpAnalysisResponse {
     presetDescription?: string;
   };
 }
-interface GscdumpAnalysisBundleParams extends Omit<GscdumpAnalysisParams, 'preset'> {
+export interface GscdumpAnalysisBundleParams extends Omit<GscdumpAnalysisParams, 'preset'> {
   presets: GscdumpAnalysisPreset[];
 }
-interface GscdumpAnalysisBundleResponse {
+export interface GscdumpAnalysisBundleResponse {
   bundle: Record<string, {
     keywords: Array<Record<string, unknown>>;
     totalCount: number;
@@ -933,7 +933,7 @@ interface GscdumpAnalysisBundleResponse {
   }>;
   meta: GscdumpAnalysisResponse['meta'];
 }
-interface RegisterPartnerUserParams {
+export interface RegisterPartnerUserParams {
   userGoogleId: string;
   userEmail: string;
   userName?: string;
@@ -941,12 +941,12 @@ interface RegisterPartnerUserParams {
   refreshToken: string;
   tokenExpiresAt?: number;
 }
-interface UpdatePartnerUserTokensParams {
+export interface UpdatePartnerUserTokensParams {
   accessToken: string;
   refreshToken: string;
   tokenExpiresAt?: number;
 }
-interface RegisterPartnerSiteParams {
+export interface RegisterPartnerSiteParams {
   userId: string;
   siteUrl: string;
   requestedUrl?: string;
@@ -959,7 +959,7 @@ interface RegisterPartnerSiteParams {
   enabledSearchTypes?: GscSearchType[];
   catalogSiteId?: number;
 }
-interface BulkRegisterPartnerSitesParams {
+export interface BulkRegisterPartnerSitesParams {
   userId?: string;
   siteUrls?: string[];
   sites?: Array<{
@@ -973,7 +973,7 @@ interface BulkRegisterPartnerSitesParams {
     enabledSearchTypes?: GscSearchType[];
   }>;
 }
-interface BulkRegisterPartnerSiteResult {
+export interface BulkRegisterPartnerSiteResult {
   siteUrl: string;
   siteId?: string;
   status: 'registered' | 'already_exists' | 'not_found' | 'error';
@@ -984,7 +984,7 @@ interface BulkRegisterPartnerSiteResult {
   indexingPermissionLevel?: string | null;
   grantedScopes?: string[];
 }
-interface BulkRegisterPartnerSitesResponse {
+export interface BulkRegisterPartnerSitesResponse {
   results: BulkRegisterPartnerSiteResult[];
   summary: {
     registered: number;
@@ -993,23 +993,23 @@ interface BulkRegisterPartnerSitesResponse {
     errors: number;
   };
 }
-interface DeletePartnerUserResponse {
+export interface DeletePartnerUserResponse {
   ok: true;
   queued: true;
   userId: number;
   publicId: string;
 }
-type GscdumpAnalysisSourcesResponse = FileResolutionResponse;
-interface SearchTypeOptions {
+export type GscdumpAnalysisSourcesResponse = FileResolutionResponse;
+export interface SearchTypeOptions {
   searchType?: GscSearchType;
 }
-interface SourceInfoOptions extends SearchTypeOptions {
+export interface SourceInfoOptions extends SearchTypeOptions {
   start?: string;
   end?: string;
   startDate?: string;
   endDate?: string;
 }
-interface AnalysisSourcesOptions extends SearchTypeOptions {
+export interface AnalysisSourcesOptions extends SearchTypeOptions {
   tables?: string[] | string;
   start?: string;
   end?: string;
@@ -1022,16 +1022,16 @@ interface AnalysisSourcesOptions extends SearchTypeOptions {
   /** Client-derived per-table parquet file-count ceiling. */
   maxFiles?: number;
 }
-interface DataQueryOptions {
+export interface DataQueryOptions {
   comparison?: BuilderStateWire;
   filter?: GscComparisonFilter;
   searchType?: GscSearchType;
 }
-interface DataDetailOptions {
+export interface DataDetailOptions {
   comparison?: BuilderStateWire;
   searchType?: GscSearchType;
 }
-interface IndexingUrlsParams {
+export interface IndexingUrlsParams {
   limit?: number;
   offset?: number;
   status?: GscdumpIndexingUrlStatus;
@@ -1045,41 +1045,41 @@ interface IndexingUrlsParams {
    */
   count?: 0 | false;
 }
-interface GscdumpUserSettings {
+export interface GscdumpUserSettings {
   browserAnalyzerEnabled: boolean;
 }
-interface GscdumpPermissionRecovery {
+export interface GscdumpPermissionRecovery {
   success: boolean;
   permissionLevel: string | null;
   jobsQueued: number;
   message: string;
 }
-interface GscdumpTopAssociationParams {
+export interface GscdumpTopAssociationParams {
   type: 'topPage' | 'topKeyword';
   identifier: string;
   startDate: string;
   endDate: string;
 }
-interface GscdumpTopAssociationResponse {
+export interface GscdumpTopAssociationResponse {
   value: string | null;
 }
-interface GscdumpKeywordSparklinesParams {
+export interface GscdumpKeywordSparklinesParams {
   keywords: string[];
   startDate: string;
   endDate: string;
   searchType?: GscSearchType;
 }
-interface GscdumpKeywordSparklinesResponse {
+export interface GscdumpKeywordSparklinesResponse {
   sparklines: Record<string, number[]>;
 }
-interface GscdumpQueryTrendParams {
+export interface GscdumpQueryTrendParams {
   startDate: string;
   endDate: string;
   prevStartDate?: string;
   prevEndDate?: string;
   searchType?: GscSearchType;
 }
-interface GscdumpQueryTrendResponse {
+export interface GscdumpQueryTrendResponse {
   daily: Array<{
     date: string;
     queryCount: number;
@@ -1091,14 +1091,14 @@ interface GscdumpQueryTrendResponse {
     syncStatus: string | null;
   };
 }
-interface GscdumpPageTrendParams {
+export interface GscdumpPageTrendParams {
   startDate: string;
   endDate: string;
   prevStartDate?: string;
   prevEndDate?: string;
   searchType?: GscSearchType;
 }
-interface GscdumpPageTrendResponse {
+export interface GscdumpPageTrendResponse {
   daily: Array<{
     date: string;
     pageCount: number;
@@ -1110,7 +1110,7 @@ interface GscdumpPageTrendResponse {
     syncStatus: string | null;
   };
 }
-interface GscdumpCanonicalMismatchRow {
+export interface GscdumpCanonicalMismatchRow {
   url: string;
   userCanonical: string;
   googleCanonical: string;
@@ -1120,7 +1120,7 @@ interface GscdumpCanonicalMismatchRow {
   lastCheckedAt: string | null;
   kind: Extract<GscdumpCanonicalDifferenceKind, 'path' | 'cross_domain'>;
 }
-interface GscdumpCanonicalMismatchesResponse {
+export interface GscdumpCanonicalMismatchesResponse {
   mismatches: GscdumpCanonicalMismatchRow[];
   totalCount: number;
   consolidationTargets: Array<{
@@ -1136,7 +1136,7 @@ interface GscdumpCanonicalMismatchesResponse {
     syncStatus: string | null;
   };
 }
-interface GscdumpIndexPercentTrendPoint {
+export interface GscdumpIndexPercentTrendPoint {
   date: string;
   percent: number;
   total: number;
@@ -1144,22 +1144,22 @@ interface GscdumpIndexPercentTrendPoint {
   added: number | null;
   removed: number | null;
 }
-interface GscdumpInvisibleUrlRow {
+export interface GscdumpInvisibleUrlRow {
   url: string;
   firstSeen?: string;
   lastmod: string | null;
 }
-interface GscdumpOrphanPageRow {
+export interface GscdumpOrphanPageRow {
   url: string;
   impressions: number | null;
   clicks: number | null;
 }
-interface GscdumpIndexPercentSitemap {
+export interface GscdumpIndexPercentSitemap {
   path: string;
   urlCount: number;
   isIndex: boolean;
 }
-interface GscdumpIndexPercentResponse {
+export interface GscdumpIndexPercentResponse {
   trend: GscdumpIndexPercentTrendPoint[];
   invisibleUrls: GscdumpInvisibleUrlRow[];
   invisibleCount: number;
@@ -1180,7 +1180,7 @@ interface GscdumpIndexPercentResponse {
     newestDateSynced: string | null;
   };
 }
-interface GscdumpUserMeResponse {
+export interface GscdumpUserMeResponse {
   id: string;
   name?: string;
   email: string;
@@ -1198,7 +1198,7 @@ interface GscdumpUserMeResponse {
     lastUsed: number | null;
   } | null;
 }
-interface GscdumpHealthResponse {
+export interface GscdumpHealthResponse {
   timestamp: number;
   jobs: {
     byStatus: Record<string, number>;
@@ -1221,11 +1221,11 @@ interface GscdumpHealthResponse {
     byPlan: Record<string, number>;
   };
 }
-interface GscdumpSyncProgressDateStatus {
+export interface GscdumpSyncProgressDateStatus {
   date: string;
   status: 'completed' | 'queued' | 'processing' | 'failed';
 }
-interface GscdumpSyncProgressPhaseCounts {
+export interface GscdumpSyncProgressPhaseCounts {
   total: number;
   done: number;
   pending: number;
@@ -1234,7 +1234,7 @@ interface GscdumpSyncProgressPhaseCounts {
   percent: number;
   rows: number;
 }
-interface GscdumpSyncProgressSite {
+export interface GscdumpSyncProgressSite {
   id: string;
   userId: number;
   partnerId: string | null;
@@ -1268,7 +1268,7 @@ interface GscdumpSyncProgressSite {
   totalRows: number;
   dateStatuses: GscdumpSyncProgressDateStatus[];
 }
-interface GscdumpSyncProgressResponse {
+export interface GscdumpSyncProgressResponse {
   summary: {
     total: number;
     inInitial: number;
@@ -1289,8 +1289,8 @@ interface GscdumpSyncProgressResponse {
   };
   hasD1Stats: boolean;
 }
-type GscdumpSyncJobStatus = 'queued' | 'processing' | 'completed' | 'failed' | 'scheduled';
-interface GscdumpSyncJobItem {
+export type GscdumpSyncJobStatus = 'queued' | 'processing' | 'completed' | 'failed' | 'scheduled';
+export interface GscdumpSyncJobItem {
   id: number;
   userSiteId: string | null;
   tableName?: string;
@@ -1308,11 +1308,11 @@ interface GscdumpSyncJobItem {
   startedAt: number | null;
   completedAt: number | null;
 }
-interface GscdumpSyncJobsQueueCounts {
+export interface GscdumpSyncJobsQueueCounts {
   queued: number;
   processing: number;
 }
-interface GscdumpSyncJobsResponse {
+export interface GscdumpSyncJobsResponse {
   jobs: GscdumpSyncJobItem[];
   summary: {
     queued: number;
@@ -1327,13 +1327,13 @@ interface GscdumpSyncJobsResponse {
     extended: GscdumpSyncJobsQueueCounts | undefined;
   };
 }
-interface GscdumpSiteReportResponse<TResult = unknown> {
+export interface GscdumpSiteReportResponse<TResult = unknown> {
   status: 'done' | 'error';
   cached: boolean;
   result?: TResult;
   error?: string;
 }
-interface GscdumpTeamRow {
+export interface GscdumpTeamRow {
   id: string;
   ownerId: number;
   name: string;
@@ -1341,7 +1341,7 @@ interface GscdumpTeamRow {
   createdAt: number;
   updatedAt: number;
 }
-interface GscdumpTeamMemberRow {
+export interface GscdumpTeamMemberRow {
   userId: number;
   publicId: string;
   name: string | null;
@@ -1350,19 +1350,19 @@ interface GscdumpTeamMemberRow {
   role: 'admin' | 'editor' | 'viewer';
   joinedAt: number;
 }
-interface CreatePartnerTeamParams {
+export interface CreatePartnerTeamParams {
   ownerUserId: string;
   name: string;
   personalTeam?: boolean;
 }
-interface AddPartnerTeamMemberParams {
+export interface AddPartnerTeamMemberParams {
   userId: string;
   role: GscdumpTeamMemberRow['role'];
 }
-interface BindPartnerSiteTeamParams {
+export interface BindPartnerSiteTeamParams {
   teamId: string | null;
 }
-interface GscdumpTeamCatalogRef {
+export interface GscdumpTeamCatalogRef {
   teamId: string;
   catalogUri: string | null;
   warehouse: string | null;
@@ -1373,13 +1373,13 @@ interface GscdumpTeamCatalogRef {
   catalogTablesReady: boolean;
   readsEnabled: boolean;
 }
-interface BindPartnerTeamCatalogParams {
+export interface BindPartnerTeamCatalogParams {
   catalogUri: string;
   warehouse: string;
   namespace?: string;
   bucket?: string;
 }
-interface BindPartnerTeamCatalogResponse {
+export interface BindPartnerTeamCatalogResponse {
   teamId: string;
   status: 'ready';
   catalogUri: string;
@@ -1387,9 +1387,9 @@ interface BindPartnerTeamCatalogResponse {
   bucket: string;
   namespace: string;
 }
-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>> {
+export type CanonicalWebhookEventType = 'user.lifecycle.changed' | 'site.lifecycle.changed' | 'site.analytics.ready' | 'site.indexing.ready' | 'site.auth.failed' | 'job.failed';
+export type WebhookEventType = CanonicalWebhookEventType;
+export interface WebhookEnvelope<TData extends Record<string, unknown> = Record<string, unknown>> {
   contractVersion: string;
   deliveryId: string;
   event: CanonicalWebhookEventType;
@@ -1402,8 +1402,8 @@ interface WebhookEnvelope<TData extends Record<string, unknown> = Record<string,
   occurredAt: string;
   data: TData;
 }
-type PartnerWebhookData = Record<string, unknown>;
-interface CreateWebhookEnvelopeOptions<TData extends Record<string, unknown> = Record<string, unknown>> {
+export type PartnerWebhookData = Record<string, unknown>;
+export interface CreateWebhookEnvelopeOptions<TData extends Record<string, unknown> = Record<string, unknown>> {
   event: CanonicalWebhookEventType;
   partnerId: string;
   userId: string | null;
@@ -1416,11 +1416,11 @@ interface CreateWebhookEnvelopeOptions<TData extends Record<string, unknown> = R
   occurredAt?: string | Date;
   contractVersion?: string;
 }
-interface PartnerWebhookHeaders {
+export interface PartnerWebhookHeaders {
   event?: string | null;
   delivery?: string | null;
   contractVersion?: string | null;
   timestamp?: string | null;
   signature?: string | null;
 }
-export { AddPartnerTeamMemberParams, AnalysisSourcesOptions, AnalysisSourcesResponse, BackfillRange, BackfillResponse, BindPartnerSiteTeamParams, BindPartnerTeamCatalogParams, BindPartnerTeamCatalogResponse, BuilderStateWire, BulkRegisterPartnerSiteResult, BulkRegisterPartnerSitesParams, BulkRegisterPartnerSitesResponse, CanonicalWebhookEventType, ColumnDef, ColumnType, CountriesResponse, CountryRow, CreatePartnerTeamParams, CreateWebhookEnvelopeOptions, DataDetailOptions, DataQueryOptions, DeletePartnerUserResponse, Dimension, Filter, Grain, GscAddAndVerifyResponse, GscApiRange, GscComparisonFilter, GscRowQueryMeta, GscRowQueryResponse, GscVerificationDnsRecord, GscVerificationMethod, GscVerificationRequest, GscVerificationSite, GscVerificationTokenResponse, GscdumpAnalysisBundleParams, GscdumpAnalysisBundleResponse, GscdumpAnalysisParams, GscdumpAnalysisPreset, GscdumpAnalysisResponse, GscdumpAnalysisSourcesResponse, GscdumpAvailableSite, GscdumpCanonicalDifferenceKind, GscdumpCanonicalMismatchRow, GscdumpCanonicalMismatchesResponse, GscdumpDataDetailResponse, GscdumpDataResponse, GscdumpDataRow, 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, GscdumpSiteIntIdCrosswalkEntry, GscdumpSiteIntIdCrosswalkResponse, GscdumpSiteRegistration, GscdumpSiteReportResponse, GscdumpSitemap, GscdumpSitemapChangesResponse, GscdumpSitemapExportResponse, GscdumpSitemapGeneration, GscdumpSitemapHistory, GscdumpSitemapMembershipEvidence, GscdumpSitemapMembershipParams, GscdumpSitemapMembershipResponse, GscdumpSitemapUrlsResponse, GscdumpSitemapsResponse, GscdumpSyncJobItem, GscdumpSyncJobStatus, GscdumpSyncJobsQueueCounts, GscdumpSyncJobsResponse, GscdumpSyncProgressDateStatus, GscdumpSyncProgressPhaseCounts, GscdumpSyncProgressResponse, GscdumpSyncProgressSite, GscdumpSyncStatusResponse, GscdumpTeamCatalogRef, GscdumpTeamMemberRow, GscdumpTeamRow, GscdumpTopAssociationParams, GscdumpTopAssociationResponse, GscdumpTotals, GscdumpUserMeResponse, GscdumpUserRegistration, GscdumpUserSettings, GscdumpUserSite, GscdumpUserStatus, GscdumpUserTokenUpdate, IndexingDiagnostics, IndexingDiagnosticsParams, IndexingInspectRateLimit, IndexingInspectRateLimited, IndexingInspectRequest, IndexingInspectResponse, IndexingInspectResult, IndexingIssue, IndexingIssueSeverity, IndexingUrlRow, IndexingUrlStatus, IndexingUrlsParams, IndexingUrlsResponse, InspectionHistoryRecord, InspectionHistoryResponse, InspectionIndex, InspectionRecordRaw, Metric, type PartnerLifecycleAccount, type PartnerLifecycleResponse, type PartnerLifecycleSite, PartnerSitemapAction, PartnerSitemapActionResponse, PartnerWebhookData, PartnerWebhookHeaders, RegisterPartnerSiteParams, RegisterPartnerUserParams, RollupEnvelope, Row, ScheduleState, SearchAppearanceResponse, SearchAppearanceRow, SearchTypeOptions, SiteListItem, SitemapAddedRow, SitemapChangesCompleteness, SitemapChangesResponse, SitemapRemovedRow, SourceInfoOptions, SourceInfoResponse, TableName, TableSchema, TenantCtx, UpdatePartnerUserTokensParams, WebhookEnvelope, WebhookEventType, WhoamiResponse };
+export type { PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite };