@gscdump/contracts 1.3.2 → 1.4.1

package/dist/{_chunks/schemas.mjs → schemas.mjs}

@@ -1,140 +1,6 @@
+import { GSCDUMP_ONBOARDING_CONTRACT_VERSION, accountNextActions, accountStatuses, analyticsNextActions, analyticsStatuses, indexingNextActions, indexingStatuses, lifecycleErrorCodes, propertyNextActions, propertyStatuses, querySourceModes, sitemapNextActions, sitemapStatuses } from "./onboarding.mjs";
+import { CANONICAL_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION } from "./webhook-constants.mjs";
 import { z } from "zod";
-const GSCDUMP_ONBOARDING_CONTRACT_VERSION = "2026-05-11";
-const GSCDUMP_REQUIRED_ANALYTICS_SCOPE = "https://www.googleapis.com/auth/webmasters.readonly";
-const GSCDUMP_WRITE_ANALYTICS_SCOPE = "https://www.googleapis.com/auth/webmasters";
-const GSCDUMP_OPTIONAL_INDEXING_SCOPE = "https://www.googleapis.com/auth/indexing";
-const accountStatuses = [
-	"disconnected",
-	"oauth_received",
-	"scope_missing",
-	"refresh_missing",
-	"db_provisioning",
-	"ready",
-	"reauth_required"
-];
-const accountNextActions = [
-	"connect_google",
-	"reconnect_google",
-	"wait_for_provisioning",
-	"none"
-];
-const propertyStatuses = [
-	"no_local_site",
-	"no_gsc_property",
-	"unverified_property",
-	"verified_candidate",
-	"registered",
-	"linked"
-];
-const propertyNextActions = [
-	"create_site",
-	"verify_gsc_property",
-	"choose_property",
-	"register_site",
-	"none"
-];
-const analyticsStatuses = [
-	"not_registered",
-	"queued",
-	"preparing",
-	"syncing",
-	"queryable_live",
-	"queryable_partial",
-	"ready",
-	"failed"
-];
-const analyticsNextActions = [
-	"wait_for_sync",
-	"retry_sync",
-	"none"
-];
-const querySourceModes = [
-	"none",
-	"live",
-	"d1",
-	"r2",
-	"mixed"
-];
-const sitemapStatuses = [
-	"unknown",
-	"discovering",
-	"none_found",
-	"auto_submitted",
-	"syncing",
-	"ready",
-	"failed"
-];
-const sitemapNextActions = [
-	"submit_sitemap",
-	"wait_for_sitemaps",
-	"retry_sitemaps",
-	"none"
-];
-const indexingStatuses = [
-	"not_requested",
-	"missing_scope",
-	"insufficient_permission",
-	"waiting_for_sitemaps",
-	"discovering",
-	"checking",
-	"ready",
-	"budget_exhausted",
-	"no_urls",
-	"failed"
-];
-const indexingNextActions = [
-	"reconnect_google",
-	"fix_gsc_permission",
-	"wait_for_sitemaps",
-	"wait_for_indexing",
-	"retry_indexing",
-	"none"
-];
-const lifecycleErrorCodes = [
-	"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"
-];
-function parseGrantedScopes(scopes) {
-	if (!scopes) return [];
-	if (typeof scopes === "string") return scopes.split(/\s+/).map((scope) => scope.trim()).filter(Boolean);
-	return scopes.map((scope) => scope.trim()).filter(Boolean);
-}
-function hasGoogleScope(scopes, scope) {
-	const granted = parseGrantedScopes(scopes);
-	const suffix = scope.replace("https://www.googleapis.com/auth/", "");
-	return granted.includes(scope) || granted.includes(suffix);
-}
-function hasRequiredAnalyticsScope(scopes) {
-	return hasGoogleScope(scopes, "https://www.googleapis.com/auth/webmasters.readonly") || hasGoogleScope(scopes, "https://www.googleapis.com/auth/webmasters");
-}
-function hasOptionalIndexingScope(scopes) {
-	return hasGoogleScope(scopes, GSCDUMP_OPTIONAL_INDEXING_SCOPE);
-}
-const WEBHOOK_CONTRACT_VERSION = "2026-05-11";
-const WEBHOOK_SIGNATURE_HEADER = "X-GSCDump-Signature";
-const WEBHOOK_EVENT_HEADER = "X-GSCDump-Event";
-const WEBHOOK_DELIVERY_HEADER = "X-GSCDump-Delivery";
-const WEBHOOK_CONTRACT_VERSION_HEADER = "X-GSCDump-Contract-Version";
-const WEBHOOK_TIMESTAMP_HEADER = "X-GSCDump-Timestamp";
-const CANONICAL_WEBHOOK_EVENTS = [
-	"user.lifecycle.changed",
-	"site.lifecycle.changed",
-	"site.analytics.ready",
-	"site.indexing.ready",
-	"site.auth.failed",
-	"job.failed"
-];
-const VALID_WEBHOOK_EVENTS = CANONICAL_WEBHOOK_EVENTS;
 const unknownRecord = z.record(z.string(), z.unknown());
 const searchTypeSchema = z.enum([
 	"web",
@@ -1766,4 +1632,4 @@ const partnerEndpointSchemas = {
 	...analyticsEndpointSchemas,
 	...partnerControlEndpointSchemas
 };
-export { CANONICAL_WEBHOOK_EVENTS, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSCDUMP_WRITE_ANALYTICS_SCOPE, SEARCH_TYPE_CAPABILITIES, VALID_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION, WEBHOOK_CONTRACT_VERSION_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, accountNextActions, accountStatuses, addPartnerTeamMemberSchema, analyticsEndpointSchemas, analyticsNextActions, analyticsStatuses, backfillRangeSchema, backfillResponseSchema, bindPartnerSiteTeamSchema, bindPartnerTeamCatalogResponseSchema, bindPartnerTeamCatalogSchema, builderStateSchema, bulkFileResolutionResponseSchema, bulkRegisterPartnerSitesResponseSchema, bulkRegisterPartnerSitesSchema, canonicalWebhookEventTypeSchema, countriesResponseSchema, countryRowSchema, createPartnerTeamSchema, dataDetailOptionsSchema, dataQueryOptionsSchema, gscAddAndVerifyResponseSchema, gscApiRangeSchema, gscComparisonFilterSchema, gscRowQueryMetaSchema, gscRowQueryResponseSchema, gscVerificationDnsRecordSchema, gscVerificationMethodSchema, gscVerificationRequestSchema, gscVerificationSiteSchema, gscVerificationTokenResponseSchema, gscdumpAnalysisBaseParamsSchema, gscdumpAnalysisBundleResponseSchema, gscdumpAnalysisMetaSchema, gscdumpAnalysisParamsSchema, gscdumpAnalysisPresetSchema, gscdumpAnalysisResponseSchema, gscdumpAnalysisSourcesResponseSchema, gscdumpAvailableSiteSchema, gscdumpCanonicalMismatchesResponseSchema, gscdumpDataDetailResponseSchema, gscdumpDataResponseSchema, gscdumpDataRowSchema, gscdumpDeletePartnerUserResponseSchema, gscdumpHealthResponseSchema, gscdumpIndexPercentParamsSchema, gscdumpIndexPercentResponseSchema, gscdumpIndexingDiagnosticsResponseSchema, gscdumpIndexingResponseSchema, gscdumpIndexingUrlsResponseSchema, gscdumpKeywordSparklinesParamsSchema, gscdumpKeywordSparklinesResponseSchema, gscdumpMetaSchema, gscdumpPageTrendParamsSchema, gscdumpPageTrendResponseSchema, gscdumpPermissionRecoverySchema, gscdumpQueryTrendParamsSchema, gscdumpQueryTrendResponseSchema, gscdumpSiteRegistrationSchema, gscdumpSiteReportResponseSchema, gscdumpSitemapChangesResponseSchema, gscdumpSitemapMembershipParamsSchema, gscdumpSitemapMembershipResponseSchema, gscdumpSitemapMembershipUrlSchema, gscdumpSitemapsResponseSchema, gscdumpSyncJobsResponseSchema, gscdumpSyncProgressResponseSchema, gscdumpTeamMemberRowSchema, gscdumpTeamRoleSchema, gscdumpTeamRowSchema, gscdumpTopAssociationParamsSchema, gscdumpTopAssociationResponseSchema, gscdumpTotalsSchema, gscdumpUserMeResponseSchema, gscdumpUserRegistrationSchema, gscdumpUserSettingsSchema, gscdumpUserSiteSchema, gscdumpUserStatusSchema, hasOptionalIndexingScope, hasRequiredAnalyticsScope, indexingDiagnosticsParamsSchema, indexingDiagnosticsSchema, indexingInspectAnyResponseSchema, indexingInspectRateLimitedSchema, indexingInspectRequestSchema, indexingInspectResponseSchema, indexingInspectResultSchema, indexingIssueSchema, indexingNextActions, indexingStatuses, indexingUrlRowSchema, indexingUrlsParamsSchema, indexingUrlsResponseSchema, inspectionHistoryRecordSchema, inspectionHistoryResponseSchema, inspectionIndexSchema, inspectionRecordRawSchema, lifecycleErrorCodes, lifecycleErrorSchema, lifecycleProgressSchema, parseGrantedScopes, partnerControlEndpointSchemas, partnerEndpointSchemas, partnerLifecycleAccountSchema, partnerLifecycleResponseSchema, partnerLifecycleSiteSchema, partnerRealtimeEventSchema, partnerSiteTeamBindingResponseSchema, partnerSitemapActionResponseSchema, partnerSitemapActionSchema, partnerTeamCreatedResponseSchema, partnerTeamDeletedResponseSchema, partnerTeamMemberAddedResponseSchema, partnerTeamMemberRemovedResponseSchema, partnerTeamMemberRoleResponseSchema, partnerTeamMembersResponseSchema, partnerTeamRenamedResponseSchema, partnerWebhookDataSchema, partnerWebhookEnvelopeSchema, propertyNextActions, propertyStatuses, queryDimSourceResponseSchema, querySourceModes, registerPartnerSiteSchema, registerPartnerUserSchema, renamePartnerTeamSchema, rollupEnvelopeSchema, scheduleStateSchema, searchAppearanceResponseSchema, searchAppearanceRowSchema, searchTypeSchema, searchTypeSupportsDimensions, searchTypeSupportsQueries, siteIntIdCrosswalkResponseSchema, siteListItemSchema, sitemapChangesResponseSchema, sitemapHistoryRecordSchema, sitemapHistoryResponseSchema, sitemapIndexSchema, sitemapNextActions, sitemapStatuses, sourceInfoResponseSchema, teamCatalogRefSchema, updatePartnerUserTokensSchema, whoamiResponseSchema };
+export { SEARCH_TYPE_CAPABILITIES, addPartnerTeamMemberSchema, analyticsEndpointSchemas, backfillRangeSchema, backfillResponseSchema, bindPartnerSiteTeamSchema, bindPartnerTeamCatalogResponseSchema, bindPartnerTeamCatalogSchema, builderStateSchema, bulkFileResolutionResponseSchema, bulkRegisterPartnerSitesResponseSchema, bulkRegisterPartnerSitesSchema, canonicalWebhookEventTypeSchema, countriesResponseSchema, countryRowSchema, createPartnerTeamSchema, dataDetailOptionsSchema, dataQueryOptionsSchema, gscAddAndVerifyResponseSchema, gscApiRangeSchema, gscComparisonFilterSchema, gscRowQueryMetaSchema, gscRowQueryResponseSchema, gscVerificationDnsRecordSchema, gscVerificationMethodSchema, gscVerificationRequestSchema, gscVerificationSiteSchema, gscVerificationTokenResponseSchema, gscdumpAnalysisBaseParamsSchema, gscdumpAnalysisBundleResponseSchema, gscdumpAnalysisMetaSchema, gscdumpAnalysisParamsSchema, gscdumpAnalysisPresetSchema, gscdumpAnalysisResponseSchema, gscdumpAnalysisSourcesResponseSchema, gscdumpAvailableSiteSchema, gscdumpCanonicalMismatchesResponseSchema, gscdumpDataDetailResponseSchema, gscdumpDataResponseSchema, gscdumpDataRowSchema, gscdumpDeletePartnerUserResponseSchema, gscdumpHealthResponseSchema, gscdumpIndexPercentParamsSchema, gscdumpIndexPercentResponseSchema, gscdumpIndexingDiagnosticsResponseSchema, gscdumpIndexingResponseSchema, gscdumpIndexingUrlsResponseSchema, gscdumpKeywordSparklinesParamsSchema, gscdumpKeywordSparklinesResponseSchema, gscdumpMetaSchema, gscdumpPageTrendParamsSchema, gscdumpPageTrendResponseSchema, gscdumpPermissionRecoverySchema, gscdumpQueryTrendParamsSchema, gscdumpQueryTrendResponseSchema, gscdumpSiteRegistrationSchema, gscdumpSiteReportResponseSchema, gscdumpSitemapChangesResponseSchema, gscdumpSitemapMembershipParamsSchema, gscdumpSitemapMembershipResponseSchema, gscdumpSitemapMembershipUrlSchema, gscdumpSitemapsResponseSchema, gscdumpSyncJobsResponseSchema, gscdumpSyncProgressResponseSchema, gscdumpTeamMemberRowSchema, gscdumpTeamRoleSchema, gscdumpTeamRowSchema, gscdumpTopAssociationParamsSchema, gscdumpTopAssociationResponseSchema, gscdumpTotalsSchema, gscdumpUserMeResponseSchema, gscdumpUserRegistrationSchema, gscdumpUserSettingsSchema, gscdumpUserSiteSchema, gscdumpUserStatusSchema, indexingDiagnosticsParamsSchema, indexingDiagnosticsSchema, indexingInspectAnyResponseSchema, indexingInspectRateLimitedSchema, indexingInspectRequestSchema, indexingInspectResponseSchema, indexingInspectResultSchema, indexingIssueSchema, indexingUrlRowSchema, indexingUrlsParamsSchema, indexingUrlsResponseSchema, inspectionHistoryRecordSchema, inspectionHistoryResponseSchema, inspectionIndexSchema, inspectionRecordRawSchema, lifecycleErrorSchema, lifecycleProgressSchema, partnerControlEndpointSchemas, partnerEndpointSchemas, partnerLifecycleAccountSchema, partnerLifecycleResponseSchema, partnerLifecycleSiteSchema, partnerRealtimeEventSchema, partnerSiteTeamBindingResponseSchema, partnerSitemapActionResponseSchema, partnerSitemapActionSchema, partnerTeamCreatedResponseSchema, partnerTeamDeletedResponseSchema, partnerTeamMemberAddedResponseSchema, partnerTeamMemberRemovedResponseSchema, partnerTeamMemberRoleResponseSchema, partnerTeamMembersResponseSchema, partnerTeamRenamedResponseSchema, partnerWebhookDataSchema, partnerWebhookEnvelopeSchema, queryDimSourceResponseSchema, registerPartnerSiteSchema, registerPartnerUserSchema, renamePartnerTeamSchema, rollupEnvelopeSchema, scheduleStateSchema, searchAppearanceResponseSchema, searchAppearanceRowSchema, searchTypeSchema, searchTypeSupportsDimensions, searchTypeSupportsQueries, siteIntIdCrosswalkResponseSchema, siteListItemSchema, sitemapChangesResponseSchema, sitemapHistoryRecordSchema, sitemapHistoryResponseSchema, sitemapIndexSchema, sourceInfoResponseSchema, teamCatalogRefSchema, updatePartnerUserTokensSchema, whoamiResponseSchema };

package/dist/{_chunks/types.d.mts → types.d.mts}

@@ -1,268 +1,5 @@
-/** The 6 Iceberg fact tables — string-typed here to avoid an engine dep. */
-type FileResolutionTable = 'pages' | 'queries' | 'countries' | 'page_queries' | 'dates' | 'search_appearance' | 'search_appearance_pages' | 'search_appearance_queries' | 'search_appearance_page_queries';
-/** Request query params for `GET /api/sites/[siteId]/analysis-sources`. */
-interface FileResolutionRequest {
-  /** `YYYY-MM-DD` inclusive. Required — no date range = no resolution. */
-  start: string;
-  /** `YYYY-MM-DD` inclusive. */
-  end: string;
-  searchType?: GscSearchType;
-  /**
-   * Restrict resolution to these tables. Omitted = all 5. The archetype the
-   * caller intends determines which tables it needs.
-   */
-  tables?: FileResolutionTable[];
-  /** Client-derived browser attachment byte ceiling. */
-  maxBytes?: number;
-  /** Client-derived browser attachment row ceiling. */
-  maxRows?: number;
-  /** Client-derived per-table parquet file-count ceiling. */
-  maxFiles?: number;
-  /**
-   * The archetype the caller will run. Lets the endpoint route the 2
-   * window-function archetypes straight to the server tail even when the
-   * data would be browser-eligible by size.
-   */
-  archetype?: string;
-}
-/**
- * One compacted Iceberg parquet data file the browser should fetch into OPFS.
- */
-interface ResolvedParquetFile {
-  /**
-   * Same-origin URL (`/api/r2-data/<key>?...`) carrying a signed size hint
-   * and a short-lived exact-key access token. Stable for the file's lifetime
-   * (content-addressed).
-   */
-  url: string;
-  /** Byte size — drives the browser-eligibility sum and OPFS quota planning. */
-  bytes: number;
-  /**
-   * Opaque content-stable identifier for this parquet file. Two requests for
-   * the same bytes MUST return the same `contentHash`; any change in bytes
-   * MUST yield a different one. The OPFS cache uses this as the file's
-   * address (encoded into the cache filename) — it is NOT required to be a
-   * SHA-256.
-   *
-   * In practice the server returns the Iceberg `data_file.file_path` object
-   * key, which is UUID-derived and content-addressed by convention.
-   */
-  contentHash: string;
-  /** Row count, for eligibility accounting + diagnostics. */
-  rowCount: number;
-}
-/** Per-table resolution result. */
-interface ResolvedTable {
-  table: FileResolutionTable;
-  /**
-   * `'browser'` — `files` is populated; the browser downloads + attaches.
-   * `'server'`  — this `(site, table)` exceeds the eligibility ceiling;
-   *               `files` is empty and queries route to the server tail.
-   */
-  mode: 'browser' | 'server';
-  /** Compacted Iceberg data files. Empty when `mode === 'server'`. */
-  files: ResolvedParquetFile[];
-  /**
-   * Recent-window overlay parquet — the non-stable tail (the freshest days the
-   * ingest stability cutoff excludes from the lake), materialized out-of-band at
-   * `_recent_overlay/{site}/{searchType}/{table}.parquet`. When present, the
-   * browser unions it with an anti-join dedup (the lake wins on any shared day;
-   * the overlay supplies only days the lake lacks) so the freshest days serve
-   * from the overlay instead of returning 0. Absent (`undefined`) when no
-   * overlay exists for this `(site, searchType, table)` or for `mode: 'server'`.
-   *
-   * The overlay is OVERWRITTEN in place each sync, so its `contentHash` MUST
-   * change whenever the bytes change (the server derives it from the R2 object
-   * etag) — otherwise the OPFS cache would serve a stale overlay. The enclosing
-   * `FileResolutionResponse.snapshotVersion` folds the overlay hash in for the
-   * same reason (it gates browser re-attach).
-   */
-  overlay?: ResolvedParquetFile;
-  /** Total bytes across `files` — compared against the ceiling. */
-  totalBytes: number;
-  /** Total rows across `files`. */
-  totalRows: number;
-}
-/** Server-tail directive — how an ineligible `(site, table)` is queried. */
-interface ServerTailDirective {
-  /**
-   * `'r2-sql'`  — server runs the query via R2 SQL over the Iceberg table.
-   * `'duckdb'`  — server runs DuckDB-over-Iceberg-files (caller-supplied SQL,
-   * or a query R2 SQL still can't run — see `dispatcher.ts` for the current
-   * escalation rules, re-verified against real R2 SQL 2026-07-03; R2 SQL now
-   * supports window functions, `COUNT(DISTINCT)`, JOINs and CTEs, so the split
-   * is no longer a fixed "window functions → duckdb" rule).
-   */
-  engine: 'r2-sql' | 'duckdb';
-  /** Endpoint the consumer POSTs the archetype query to. */
-  endpoint: string;
-}
-/** Response body of the file-resolution endpoint. */
-interface FileResolutionResponse {
-  siteId: string;
-  searchType: GscSearchType;
-  range: {
-    start: string;
-    end: string;
-  };
-  /**
-   * Stable hash over the resolved file set. The browser re-attaches only when
-   * this changes (new compaction landed). Replaces the old `manifestVersion`.
-   */
-  snapshotVersion: string;
-  generatedAt: string;
-  /** Per-table resolution. */
-  tables: ResolvedTable[];
-  /**
-   * Present iff at least one table resolved to `mode: 'server'`. Tells the
-   * consumer how to route the server-tail queries for those tables.
-   */
-  serverTail?: ServerTailDirective;
-  /**
-   * The per-(site,table) browser-eligibility ceiling in effect, echoed so the
-   * consumer can show "X is too large for local analysis" UX without
-   * hard-coding the threshold.
-   */
-  eligibilityCeiling: {
-    maxBytes: number;
-    maxRows: number;
-    maxFiles: number;
-  };
-}
-/** One canonical query-dimension sidecar object for browser attachment. */
-interface QueryDimSourceFile {
-  url: string;
-  bytes: number;
-  contentHash: string;
-}
-/** Response from the versioned query-dimension sidecar resolver. */
-interface QueryDimSourceResponse {
-  file: QueryDimSourceFile | null;
-}
-/** Multi-site file-resolution response. Inaccessible sites are omitted. */
-interface BulkFileResolutionResponse {
-  generatedAt: string;
-  siteCount: number;
-  maxSites: number;
-  results: Record<string, FileResolutionResponse>;
-}
-/** Request query for the multi-site file resolver. */
-interface BulkFileResolutionRequest extends FileResolutionRequest {
-  /** Public site ids to resolve. Partner callers must supply this list. */
-  siteIds?: string[];
-}
-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";
-type GoogleScopesInput = string | readonly string[] | null | undefined;
-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 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 = 'user.lifecycle.changed' | 'site.lifecycle.changed' | 'site.analytics.ready' | 'site.indexing.ready' | 'site.auth.failed' | 'job.failed';
-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;
-  /** Integer alias (`user_sites.int_id`) — the int JOIN key partners denormalize into their own catalog namespaces. Nullable only for pre-0029 unbackfilled rows. */
-  intId: number | null;
-  /** Team-scoped catalog identifier (`user_sites.catalog_site_id`). Defaults to `intId` for sites without a caller-supplied catalog ID. */
-  catalogSiteId: number | null;
-  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;
-  currentTeamId: 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: GoogleScopesInput): string[];
-declare function hasRequiredAnalyticsScope(scopes: GoogleScopesInput): boolean;
-declare function hasOptionalIndexingScope(scopes: GoogleScopesInput): boolean;
+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';
 /**
  * Temporal granularity axis. Daily callers (`'day'`, default) read/write rows
@@ -1627,4 +1364,4 @@ interface PartnerWebhookHeaders {
   timestamp?: string | null;
   signature?: string | null;
 }
-export { AccountNextAction, AccountStatus, AddPartnerTeamMemberParams, AnalysisSourcesOptions, AnalysisSourcesResponse, AnalyticsNextAction, AnalyticsStatus, BackfillRange, BackfillResponse, BindPartnerSiteTeamParams, BindPartnerTeamCatalogParams, BindPartnerTeamCatalogResponse, BuilderStateWire, BulkFileResolutionRequest, BulkFileResolutionResponse, BulkRegisterPartnerSiteResult, BulkRegisterPartnerSitesParams, BulkRegisterPartnerSitesResponse, CanonicalWebhookEventType, ColumnDef, ColumnType, CountriesResponse, CountryRow, CreatePartnerTeamParams, CreateWebhookEnvelopeOptions, DataDetailOptions, DataQueryOptions, DeletePartnerUserResponse, Dimension, FileResolutionRequest, FileResolutionResponse, FileResolutionTable, Filter, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSCDUMP_WRITE_ANALYTICS_SCOPE, Grain, GscAddAndVerifyResponse, GscApiRange, GscComparisonFilter, GscRowQueryMeta, GscRowQueryResponse, GscSearchType, GscVerificationDnsRecord, GscVerificationMethod, GscVerificationRequest, GscVerificationSite, GscVerificationTokenResponse, GscdumpAnalysisBundleParams, GscdumpAnalysisBundleResponse, GscdumpAnalysisParams, GscdumpAnalysisPreset, GscdumpAnalysisResponse, GscdumpAnalysisSourcesResponse, GscdumpAvailableSite, 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, GscdumpSitemapHistory, GscdumpSitemapMembershipParams, GscdumpSitemapMembershipResponse, GscdumpSitemapMembershipUnavailableReason, GscdumpSitemapMembershipUrl, 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, IndexingNextAction, IndexingStatus, IndexingUrlRow, IndexingUrlStatus, IndexingUrlsParams, IndexingUrlsResponse, InspectionHistoryRecord, InspectionHistoryResponse, InspectionIndex, InspectionRecordRaw, LifecycleError, LifecycleErrorCode, LifecycleProgress, LifecycleWebhookEnvelope, LifecycleWebhookEvent, Metric, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite, PartnerSitemapAction, PartnerSitemapActionResponse, PartnerWebhookData, PartnerWebhookHeaders, PropertyNextAction, PropertyStatus, QueryDimSourceFile, QueryDimSourceResponse, QuerySourceMode, RegisterPartnerSiteParams, RegisterPartnerUserParams, ResolvedParquetFile, ResolvedTable, RollupEnvelope, Row, ScheduleState, SearchAppearanceResponse, SearchAppearanceRow, SearchTypeOptions, ServerTailDirective, 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, parseGrantedScopes, propertyNextActions, propertyStatuses, querySourceModes, sitemapNextActions, sitemapStatuses };
+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, GscSearchType, GscVerificationDnsRecord, GscVerificationMethod, GscVerificationRequest, GscVerificationSite, GscVerificationTokenResponse, GscdumpAnalysisBundleParams, GscdumpAnalysisBundleResponse, GscdumpAnalysisParams, GscdumpAnalysisPreset, GscdumpAnalysisResponse, GscdumpAnalysisSourcesResponse, GscdumpAvailableSite, 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, GscdumpSitemapHistory, GscdumpSitemapMembershipParams, GscdumpSitemapMembershipResponse, GscdumpSitemapMembershipUnavailableReason, GscdumpSitemapMembershipUrl, 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, SitemapChangesResponse, SitemapHistoryRecord, SitemapHistoryResponse, SitemapIndex, SitemapRemovedRow, SourceInfoOptions, SourceInfoResponse, TableName, TableSchema, TenantCtx, UpdatePartnerUserTokensParams, WebhookEnvelope, WebhookEventType, WhoamiResponse };

package/dist/v1/documents.d.mts

@@ -0,0 +1,4 @@
+type ContractDocument = Record<string, unknown>;
+declare function serializeContractDocument(document: ContractDocument): string;
+declare function createGscdumpV1Documents(): Record<'openapi.partner.v1.json' | 'openapi.analytics.v1.json' | 'openapi.realtime.v1.json' | 'asyncapi.realtime.v1.json', ContractDocument>;
+export { ContractDocument, createGscdumpV1Documents, serializeContractDocument };