@gscdump/contracts 0.26.10 → 0.27.1

package/dist/_chunks/schemas.mjs

@@ -0,0 +1,1554 @@
+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 lifecycleWebhookEvents = [
+	"user.lifecycle.changed",
+	"site.lifecycle.changed",
+	"site.analytics.ready",
+	"site.indexing.ready",
+	"site.auth.failed",
+	"job.failed"
+];
+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) {
+	return (scopes ?? "").split(/\s+/).map((s) => s.trim()).filter(Boolean);
+}
+function hasRequiredAnalyticsScope(scopes) {
+	const granted = Array.isArray(scopes) ? scopes : parseGrantedScopes(scopes);
+	return granted.includes("https://www.googleapis.com/auth/webmasters.readonly") || granted.includes("https://www.googleapis.com/auth/webmasters");
+}
+function hasOptionalIndexingScope(scopes) {
+	return (Array.isArray(scopes) ? scopes : parseGrantedScopes(scopes)).includes(GSCDUMP_OPTIONAL_INDEXING_SCOPE);
+}
+const partnerRoutes = {
+	partner: {
+		users: {
+			byId: (userId) => `/partner/users/${encodeURIComponent(userId)}`,
+			lifecycle: (userId) => `/partner/users/${encodeURIComponent(userId)}/lifecycle`,
+			siteTeam: (userId, siteId) => `/partner/users/${encodeURIComponent(userId)}/sites/${encodeURIComponent(siteId)}`
+		},
+		sites: {
+			register: "/partner/sites/register",
+			bulkRegister: "/partner/sites/bulk-register"
+		}
+	},
+	users: {
+		register: "/users/register",
+		tokens: (userId) => `/users/${encodeURIComponent(userId)}/tokens`,
+		status: (userId) => `/users/${encodeURIComponent(userId)}/status`,
+		lifecycle: (userId) => `/users/${encodeURIComponent(userId)}/lifecycle`,
+		sites: (userId) => `/users/${encodeURIComponent(userId)}/sites`,
+		availableSites: (userId) => `/users/${encodeURIComponent(userId)}/available-sites`,
+		siteTeam: (userId, siteId) => `/partner/users/${encodeURIComponent(userId)}/sites/${encodeURIComponent(siteId)}`
+	},
+	sites: {
+		register: "/sites/register",
+		bulkRegister: "/sites/bulk-register",
+		byId: (siteId) => `/sites/${encodeURIComponent(siteId)}`,
+		analysisSources: (siteId) => `/sites/${encodeURIComponent(siteId)}/analysis-sources`,
+		syncStatus: (siteId) => `/sites/${encodeURIComponent(siteId)}/sync-status`,
+		data: (siteId) => `/sites/${encodeURIComponent(siteId)}/data`,
+		dataDetail: (siteId) => `/sites/${encodeURIComponent(siteId)}/data/detail`,
+		analysis: (siteId) => `/sites/${encodeURIComponent(siteId)}/analysis`,
+		sitemaps: (siteId) => `/sites/${encodeURIComponent(siteId)}/sitemaps`,
+		sitemapChanges: (siteId) => `/sites/${encodeURIComponent(siteId)}/sitemaps/changes`,
+		indexing: (siteId) => `/sites/${encodeURIComponent(siteId)}/indexing`,
+		indexingUrls: (siteId) => `/sites/${encodeURIComponent(siteId)}/indexing/urls`,
+		indexingDiagnostics: (siteId) => `/sites/${encodeURIComponent(siteId)}/indexing/diagnostics`,
+		indexingInspect: (siteId) => `/sites/${encodeURIComponent(siteId)}/indexing/inspect`,
+		recoverPermission: (siteId) => `/sites/${encodeURIComponent(siteId)}/recover-permission`,
+		canonicalMismatches: (siteId) => `/sites/${encodeURIComponent(siteId)}/canonical-mismatches`,
+		topAssociation: (siteId) => `/sites/${encodeURIComponent(siteId)}/data/top-association`,
+		keywordSparklines: (siteId) => `/sites/${encodeURIComponent(siteId)}/data/keyword-sparklines`,
+		queryTrend: (siteId) => `/sites/${encodeURIComponent(siteId)}/data/query-trend`,
+		pageTrend: (siteId) => `/sites/${encodeURIComponent(siteId)}/data/page-trend`,
+		contentVelocity: (siteId) => `/sites/${encodeURIComponent(siteId)}/content-velocity`,
+		ctrCurve: (siteId) => `/sites/${encodeURIComponent(siteId)}/ctr-curve`,
+		darkTraffic: (siteId) => `/sites/${encodeURIComponent(siteId)}/dark-traffic`,
+		deviceGap: (siteId) => `/sites/${encodeURIComponent(siteId)}/device-gap`,
+		indexPercent: (siteId) => `/sites/${encodeURIComponent(siteId)}/index-percent`,
+		keywordBreadth: (siteId) => `/sites/${encodeURIComponent(siteId)}/keyword-breadth`,
+		positionDistribution: (siteId) => `/sites/${encodeURIComponent(siteId)}/position-distribution`
+	},
+	settings: { user: "/user/settings" },
+	teams: {
+		create: "/partner/teams",
+		byId: (teamId) => `/partner/teams/${encodeURIComponent(teamId)}`,
+		members: (teamId) => `/partner/teams/${encodeURIComponent(teamId)}/members`,
+		member: (teamId, userId) => `/partner/teams/${encodeURIComponent(teamId)}/members/${encodeURIComponent(userId)}`
+	},
+	realtime: {
+		partner: "/ws/partner",
+		user: "/ws/user"
+	}
+};
+const analyticsRoutes = {
+	whoami: "/api/__gsc/whoami",
+	sites: "/api/__gsc/sites",
+	site: {
+		sourceInfo: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/source-info`,
+		analysisSources: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/analysis-sources`,
+		analyze: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/analyze`,
+		rows: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/rows`,
+		rollup: (siteId, rollupId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/rollup/${encodeURIComponent(rollupId)}`,
+		backfill: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/backfill`,
+		sitemaps: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/sitemaps`,
+		sitemapHistory: (siteId, hash) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/sitemaps/${encodeURIComponent(hash)}`,
+		sitemapChanges: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/sitemaps/changes`,
+		inspections: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/inspections`,
+		inspectionHistory: (siteId, hash) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/inspections/${encodeURIComponent(hash)}`,
+		indexingUrls: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/indexing/urls`,
+		indexingDiagnostics: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/indexing/diagnostics`,
+		indexingInspect: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/indexing/inspect`,
+		countries: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/countries`,
+		searchAppearance: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/search-appearance`,
+		topAssociation: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/data/top-association`
+	},
+	syncProgress: "/api/sync-progress"
+};
+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",
+	"image",
+	"video",
+	"news",
+	"discover",
+	"googleNews"
+]);
+const builderStateSchema = z.object({ searchType: searchTypeSchema.optional() }).loose();
+const gscComparisonFilterSchema = z.enum([
+	"new",
+	"lost",
+	"improving",
+	"declining"
+]);
+const gscApiRangeSchema = z.object({
+	start: z.string(),
+	end: z.string()
+});
+const countryRowSchema = z.object({
+	country: z.string(),
+	clicks: z.number(),
+	impressions: z.number(),
+	sum_position: z.number()
+}).loose();
+const countriesResponseSchema = z.object({
+	rows: z.array(countryRowSchema),
+	range: gscApiRangeSchema,
+	generatedAt: z.string(),
+	source: z.enum(["gsc-api", "engine"])
+}).loose();
+const searchAppearanceRowSchema = z.object({
+	searchAppearance: z.string(),
+	clicks: z.number(),
+	impressions: z.number(),
+	sum_position: z.number()
+}).loose();
+const searchAppearanceResponseSchema = z.object({
+	rows: z.array(searchAppearanceRowSchema),
+	range: gscApiRangeSchema,
+	generatedAt: z.string(),
+	source: z.enum(["gsc-api", "engine"])
+}).loose();
+const siteListItemSchema = z.object({
+	id: z.string(),
+	label: z.string(),
+	hostname: z.string(),
+	propertyType: z.enum(["domain", "url-prefix"]),
+	readBackend: z.enum(["d1", "r2"]).optional()
+}).loose();
+const sitemapHistoryRecordSchema = z.object({
+	path: z.string(),
+	capturedAt: z.string()
+}).loose();
+const sitemapHistoryResponseSchema = z.object({
+	path: z.string().nullable(),
+	snapshots: z.array(sitemapHistoryRecordSchema)
+}).loose();
+const scheduleStateSchema = z.object({
+	nextAt: z.number(),
+	consecutiveUnchanged: z.number(),
+	policyVersion: z.number()
+}).loose();
+const inspectionRecordRawSchema = z.object({
+	schedule: scheduleStateSchema.optional(),
+	nextCheckAfter: z.number().optional(),
+	priority: z.enum([
+		"high",
+		"medium",
+		"low"
+	]).optional(),
+	sitemaps: z.string().nullable().optional(),
+	referringUrls: z.string().nullable().optional(),
+	crawlingUserAgent: z.string().nullable().optional(),
+	mobileIssues: z.string().nullable().optional(),
+	richResultsItems: z.string().nullable().optional(),
+	inspectionResultLink: z.string().nullable().optional()
+}).loose();
+const inspectionHistoryRecordSchema = z.object({
+	url: z.string(),
+	inspectedAt: z.string(),
+	indexStatus: z.string().optional(),
+	lastCrawlTime: z.string().optional(),
+	googleCanonical: z.string().optional(),
+	userCanonical: z.string().optional(),
+	coverageState: z.string().optional(),
+	robotsTxtState: z.string().optional(),
+	indexingState: z.string().optional(),
+	pageFetchState: z.string().optional(),
+	mobileUsabilityVerdict: z.string().optional(),
+	richResultsVerdict: z.string().optional(),
+	raw: inspectionRecordRawSchema.optional()
+}).loose();
+const inspectionHistoryResponseSchema = z.object({
+	url: z.string().nullable(),
+	records: z.array(inspectionHistoryRecordSchema)
+}).loose();
+const sitemapIndexSchema = z.object({
+	version: z.literal(1),
+	records: z.record(z.string(), sitemapHistoryRecordSchema)
+}).loose();
+const inspectionIndexSchema = z.object({
+	version: z.literal(1),
+	records: z.record(z.string(), inspectionHistoryRecordSchema)
+}).loose();
+const rollupEnvelopeSchema = z.object({
+	version: z.literal(1),
+	id: z.string(),
+	builtAt: z.number(),
+	windowDays: z.number().nullable(),
+	payload: z.unknown()
+}).loose();
+const gscRowQueryMetaSchema = z.object({
+	sourceName: z.string(),
+	sourceKind: z.enum(["row", "sql"]),
+	queryMs: z.number()
+}).loose();
+const gscRowQueryResponseSchema = z.object({
+	rows: z.array(unknownRecord),
+	meta: gscRowQueryMetaSchema
+}).loose();
+const indexingUrlStatusSchema = z.enum([
+	"indexed",
+	"not_indexed",
+	"pending"
+]);
+const indexingUrlRowSchema = z.object({
+	url: z.string(),
+	verdict: z.string().nullable(),
+	coverageState: z.string().nullable(),
+	indexingState: z.string().nullable(),
+	robotsTxtState: z.string().nullable(),
+	pageFetchState: z.string().nullable(),
+	lastCrawlTime: z.string().nullable(),
+	crawlingUserAgent: z.string().nullable(),
+	userCanonical: z.string().nullable(),
+	googleCanonical: z.string().nullable(),
+	sitemaps: z.array(z.string()).nullable(),
+	referringUrls: z.array(z.string()).nullable(),
+	mobileVerdict: z.string().nullable(),
+	mobileIssues: z.array(z.unknown()).nullable(),
+	richResultsVerdict: z.string().nullable(),
+	richResultsItems: z.array(z.unknown()).nullable(),
+	inspectionResultLink: z.string().nullable(),
+	firstCheckedAt: z.string(),
+	lastCheckedAt: z.string(),
+	checkCount: z.number()
+}).loose();
+const indexingUrlsResponseSchema = z.object({
+	urls: z.array(indexingUrlRowSchema),
+	pagination: z.object({
+		total: z.number(),
+		limit: z.number(),
+		offset: z.number(),
+		hasMore: z.boolean()
+	}).loose(),
+	meta: z.object({
+		siteUrl: z.string(),
+		gscPropertyUrl: z.string().optional(),
+		status: z.string(),
+		issue: z.string().nullable()
+	}).loose()
+}).loose();
+const indexingIssueSchema = z.object({
+	type: z.string(),
+	label: z.string(),
+	severity: z.enum([
+		"error",
+		"warning",
+		"info"
+	]),
+	count: z.number()
+}).loose();
+const indexingDiagnosticsSchema = z.object({
+	summary: z.object({
+		totalUrls: z.number(),
+		indexed: z.number(),
+		indexedPercent: z.number()
+	}).loose(),
+	issues: z.array(indexingIssueSchema),
+	meta: z.object({ siteUrl: z.string() }).loose()
+}).loose();
+const indexingInspectRequestSchema = z.object({ urls: z.array(z.string().url()).min(1).max(10) });
+const indexingInspectResultSchema = z.object({
+	url: z.string(),
+	verdict: z.string().nullable(),
+	coverageState: z.string().nullable(),
+	indexingState: z.string().nullable(),
+	robotsTxtState: z.string().nullable(),
+	pageFetchState: z.string().nullable(),
+	lastCrawlTime: z.string().nullable(),
+	crawlingUserAgent: z.string().nullable(),
+	userCanonical: z.string().nullable(),
+	googleCanonical: z.string().nullable(),
+	sitemaps: z.string().nullable(),
+	referringUrls: z.string().nullable(),
+	mobileVerdict: z.string().nullable(),
+	mobileIssues: z.string().nullable(),
+	richResultsVerdict: z.string().nullable(),
+	richResultsItems: z.string().nullable(),
+	inspectionResultLink: z.string().nullable()
+}).loose();
+const indexingInspectResponseSchema = z.object({
+	siteId: z.string(),
+	rateLimit: z.object({
+		reserved: z.number(),
+		remaining: z.number(),
+		limit: z.number()
+	}).loose(),
+	results: z.array(indexingInspectResultSchema),
+	errors: z.array(z.object({
+		url: z.string(),
+		error: z.string()
+	}).loose()),
+	skipped: z.array(z.object({
+		url: z.string(),
+		reason: z.string()
+	}).loose())
+}).loose();
+const indexingInspectRateLimitedSchema = z.object({
+	error: z.literal("rate_limited"),
+	message: z.string(),
+	rateLimit: z.object({
+		reserved: z.literal(0),
+		remaining: z.literal(0),
+		limit: z.number()
+	}).loose(),
+	retryAfterSeconds: z.number()
+}).loose();
+const indexingInspectAnyResponseSchema = z.union([indexingInspectResponseSchema, indexingInspectRateLimitedSchema]);
+const sitemapChangesResponseSchema = z.object({
+	added: z.array(z.object({
+		url: z.string(),
+		sitemap: z.string(),
+		firstSeenAt: z.number()
+	}).loose()),
+	removed: z.array(z.object({
+		url: z.string(),
+		sitemap: z.string(),
+		removedAt: z.number()
+	}).loose()),
+	summary: z.object({
+		totalAdded: z.number(),
+		totalRemoved: z.number(),
+		period: z.object({ days: z.number() })
+	}).loose()
+}).loose();
+const sourceInfoResponseSchema = z.object({
+	name: z.string(),
+	kind: z.enum(["row", "sql"]),
+	capabilities: z.object({ attachedTables: z.boolean().optional() }).loose(),
+	supportedAnalyzerIds: z.array(z.string()),
+	browserAttachEligible: z.boolean(),
+	identityAttrs: unknownRecord.nullable().optional()
+}).loose();
+const whoamiResponseSchema = z.object({
+	userId: z.string().nullable().optional(),
+	plan: z.string().nullable().optional(),
+	attrs: unknownRecord.optional()
+}).loose();
+const backfillRangeSchema = z.object({
+	startDate: z.string(),
+	endDate: z.string()
+}).loose();
+const backfillResponseSchema = z.object({
+	ok: z.boolean().optional(),
+	queued: z.boolean().optional()
+}).loose();
+const gscdumpTotalsSchema = z.object({
+	clicks: z.number(),
+	impressions: z.number(),
+	ctr: z.number(),
+	position: z.number()
+});
+const gscdumpMetaSchema = z.object({
+	siteUrl: z.string(),
+	syncStatus: z.string(),
+	newestDateSynced: z.string().nullable(),
+	oldestDateSynced: z.string().nullable(),
+	dataDelay: z.string(),
+	dataEndDate: z.string().nullable().optional(),
+	warnings: z.array(z.string()).optional(),
+	enrichment: z.object({
+		lastEnriched: z.number(),
+		isDue: z.boolean()
+	}).optional(),
+	backfill: z.object({
+		percent: z.number(),
+		daysRemaining: z.number().optional()
+	}).optional()
+}).loose();
+const gscdumpDataRowSchema = z.object({
+	clicks: z.number(),
+	impressions: z.number(),
+	ctr: z.number(),
+	position: z.number()
+}).loose();
+const gscdumpDataResponseSchema = z.object({
+	rows: z.array(gscdumpDataRowSchema),
+	totalCount: z.number(),
+	totals: gscdumpTotalsSchema,
+	meta: gscdumpMetaSchema
+});
+const gscdumpDataDetailResponseSchema = z.object({
+	daily: z.array(z.object({
+		date: z.string(),
+		clicks: z.number(),
+		impressions: z.number(),
+		ctr: z.number(),
+		position: z.number()
+	}).loose()),
+	totals: gscdumpTotalsSchema,
+	previousTotals: gscdumpTotalsSchema.optional(),
+	meta: gscdumpMetaSchema
+});
+const registerPartnerUserSchema = z.object({
+	userGoogleId: z.string().min(1),
+	userEmail: z.email(),
+	userName: z.string().optional(),
+	accessToken: z.string().min(1),
+	refreshToken: z.string().min(1),
+	tokenExpiresAt: z.number().optional()
+});
+const updatePartnerUserTokensSchema = z.object({
+	accessToken: z.string().min(1),
+	refreshToken: z.string().min(1),
+	tokenExpiresAt: z.number().optional()
+});
+const gscdumpUserRegistrationSchema = z.object({
+	userId: z.string(),
+	apiKey: z.string().optional(),
+	isNew: z.boolean().optional(),
+	status: z.enum(["provisioning", "ready"]).optional()
+}).loose();
+const gscdumpUserStatusSchema = z.object({
+	userId: z.string(),
+	status: z.enum([
+		"provisioning",
+		"ready",
+		"reauth_required"
+	]),
+	databaseReady: z.boolean().optional(),
+	needsReauth: z.boolean().optional(),
+	reauthRequired: z.boolean().optional(),
+	reauthReason: z.string().nullable().optional(),
+	authFailureCount: z.number().optional(),
+	nextAction: z.enum(["reconnect_google", "none"]).optional(),
+	grantedScopes: z.string().nullable().optional()
+}).loose();
+const lifecycleProgressSchema = z.object({
+	completed: z.number(),
+	failed: z.number(),
+	total: z.number(),
+	percent: z.number()
+});
+const lifecycleErrorSchema = z.object({
+	code: z.enum(lifecycleErrorCodes),
+	message: z.string(),
+	retryable: z.boolean()
+});
+const partnerLifecycleAccountSchema = z.object({
+	status: z.enum(accountStatuses),
+	grantedScopes: z.array(z.string()),
+	missingScopes: z.array(z.string()),
+	nextAction: z.enum(accountNextActions)
+}).loose();
+const partnerLifecycleSiteSchema = z.object({
+	siteId: z.string(),
+	externalSiteId: z.string().nullable(),
+	requestedUrl: z.string(),
+	gscPropertyUrl: z.string().nullable(),
+	permissionLevel: z.string().nullable(),
+	property: z.object({
+		status: z.enum(propertyStatuses),
+		nextAction: z.enum(propertyNextActions)
+	}).loose(),
+	analytics: z.object({
+		status: z.enum(analyticsStatuses),
+		progress: lifecycleProgressSchema,
+		queryable: z.boolean(),
+		sourceMode: z.enum(querySourceModes),
+		syncedRange: z.object({
+			oldest: z.string().nullable(),
+			newest: z.string().nullable()
+		}).loose(),
+		nextAction: z.enum(analyticsNextActions)
+	}).loose(),
+	sitemaps: z.object({
+		status: z.enum(sitemapStatuses),
+		discoveredCount: z.number(),
+		nextAction: z.enum(sitemapNextActions)
+	}).loose(),
+	indexing: z.object({
+		status: z.enum(indexingStatuses),
+		eligible: z.boolean(),
+		reason: z.string().nullable(),
+		progress: lifecycleProgressSchema,
+		nextAction: z.enum(indexingNextActions)
+	}).loose(),
+	latestError: lifecycleErrorSchema.nullable(),
+	lifecycleRevision: z.number(),
+	updatedAt: z.string()
+}).loose();
+const partnerLifecycleResponseSchema = z.object({
+	contractVersion: z.literal(GSCDUMP_ONBOARDING_CONTRACT_VERSION),
+	userId: z.string(),
+	partnerId: z.string().nullable(),
+	account: partnerLifecycleAccountSchema,
+	sites: z.array(partnerLifecycleSiteSchema)
+}).loose();
+const gscdumpAvailableSiteSchema = z.object({
+	siteUrl: z.string(),
+	permissionLevel: z.string(),
+	registered: z.boolean(),
+	siteId: z.string().optional(),
+	syncStatus: z.enum([
+		"pending",
+		"syncing",
+		"synced",
+		"error"
+	]).nullable().optional(),
+	syncProgress: z.object({
+		completed: z.number(),
+		failed: z.number().optional(),
+		total: z.number(),
+		percent: z.number()
+	}).optional(),
+	lastSyncAt: z.number().nullable().optional(),
+	newestDateSynced: z.string().nullable().optional(),
+	oldestDateSynced: z.string().nullable().optional()
+}).loose();
+const gscdumpUserSiteSchema = z.object({
+	siteId: z.string(),
+	siteUrl: z.string(),
+	syncStatus: z.enum([
+		"idle",
+		"pending",
+		"syncing",
+		"synced",
+		"error"
+	]),
+	lastSyncAt: z.number().nullable(),
+	newestDateSynced: z.string().nullable(),
+	oldestDateSynced: z.string().nullable()
+}).loose();
+const gscdumpSiteRegistrationSchema = z.object({
+	siteId: z.string(),
+	status: z.enum([
+		"idle",
+		"pending",
+		"syncing",
+		"synced",
+		"error"
+	]),
+	message: z.string().optional(),
+	existing: z.boolean().optional(),
+	indexingEligible: z.boolean().optional(),
+	indexingIneligibleReason: z.enum(["missing_indexing_scope", "insufficient_gsc_permission"]).optional(),
+	indexingPermissionLevel: z.string().nullable().optional(),
+	grantedScopes: z.array(z.string()).optional()
+}).loose();
+const registerPartnerSiteSchema = z.object({
+	userId: z.string(),
+	siteUrl: z.string().min(1),
+	requestedUrl: z.string().optional(),
+	gscPropertyUrl: z.string().optional(),
+	externalSiteId: z.string().optional(),
+	externalSiteUrl: z.string().optional(),
+	webhookUrl: z.url().optional(),
+	webhookEvents: z.array(z.enum(CANONICAL_WEBHOOK_EVENTS)).optional(),
+	teamId: z.string().optional(),
+	enabledSearchTypes: z.array(searchTypeSchema).optional()
+});
+const bulkRegisterPartnerSitesSchema = z.object({
+	userId: z.string().optional(),
+	siteUrls: z.array(z.string().min(1)).optional(),
+	sites: z.array(z.object({
+		siteUrl: z.string().optional(),
+		requestedUrl: z.string().optional(),
+		gscPropertyUrl: z.string().optional(),
+		externalSiteId: z.string().optional(),
+		externalSiteUrl: z.string().optional(),
+		webhookUrl: z.url().optional(),
+		webhookEvents: z.array(z.enum(CANONICAL_WEBHOOK_EVENTS)).optional()
+	}).loose()).optional()
+}).refine((value) => (value.siteUrls?.length ?? 0) > 0 || (value.sites?.length ?? 0) > 0, { message: "siteUrls or sites is required" });
+const bulkRegisterPartnerSitesResponseSchema = z.object({
+	results: z.array(z.object({
+		siteUrl: z.string(),
+		siteId: z.string().optional(),
+		status: z.enum([
+			"registered",
+			"already_exists",
+			"not_found",
+			"error"
+		]),
+		error: z.string().optional(),
+		site: unknownRecord.nullable().optional(),
+		indexingEligible: z.boolean().optional(),
+		indexingIneligibleReason: z.enum(["missing_indexing_scope", "insufficient_gsc_permission"]).optional(),
+		indexingPermissionLevel: z.string().nullable().optional(),
+		grantedScopes: z.array(z.string()).optional()
+	}).loose()),
+	summary: z.object({
+		registered: z.number(),
+		alreadyExists: z.number(),
+		notFound: z.number(),
+		errors: z.number()
+	})
+}).loose();
+const dataQueryOptionsSchema = z.object({
+	comparison: builderStateSchema.optional(),
+	filter: gscComparisonFilterSchema.optional(),
+	searchType: searchTypeSchema.optional()
+}).optional();
+const dataDetailOptionsSchema = z.object({
+	comparison: builderStateSchema.optional(),
+	searchType: searchTypeSchema.optional()
+}).optional();
+const gscdumpAnalysisPresetSchema = z.enum([
+	"striking-distance",
+	"opportunity",
+	"decay",
+	"zero-click",
+	"non-brand",
+	"brand-only",
+	"movers-rising",
+	"movers-declining"
+]);
+const gscdumpAnalysisParamsSchema = z.object({
+	preset: gscdumpAnalysisPresetSchema,
+	startDate: z.string(),
+	endDate: z.string(),
+	prevStartDate: z.string().optional(),
+	prevEndDate: z.string().optional(),
+	brandTerms: z.string().optional(),
+	limit: z.number().optional(),
+	offset: z.number().optional(),
+	search: z.string().optional(),
+	minImpressions: z.number().optional(),
+	minPosition: z.number().optional(),
+	maxPosition: z.number().optional(),
+	maxCtr: z.number().optional(),
+	searchType: searchTypeSchema.optional()
+}).superRefine((value, ctx) => {
+	if ((value.preset === "brand-only" || value.preset === "non-brand") && !value.brandTerms?.trim()) ctx.addIssue({
+		code: "custom",
+		path: ["brandTerms"],
+		message: "brandTerms is required for brand/non-brand presets"
+	});
+});
+const gscdumpAnalysisResponseSchema = z.object({
+	preset: gscdumpAnalysisPresetSchema,
+	keywords: z.array(unknownRecord),
+	totalCount: z.number(),
+	summary: unknownRecord.optional(),
+	meta: gscdumpMetaSchema
+}).loose();
+const gscdumpSitemapsResponseSchema = z.object({
+	sitemaps: z.array(z.object({
+		path: z.string(),
+		urlCount: z.number(),
+		errors: z.number(),
+		warnings: z.number(),
+		isIndex: z.boolean().optional(),
+		lastSubmitted: z.string().nullable().optional(),
+		lastDownloaded: z.string().nullable().optional()
+	}).loose()),
+	history: z.array(z.object({
+		date: z.string(),
+		errors: z.number(),
+		warnings: z.number(),
+		urlCount: z.number(),
+		urlDelta: z.number()
+	}).loose()),
+	perSitemapHistory: z.record(z.string(), z.array(z.object({
+		date: z.string(),
+		urlCount: z.number(),
+		changed: z.boolean(),
+		urlDelta: z.number()
+	}).loose())),
+	meta: z.object({
+		siteUrl: z.string(),
+		syncStatus: z.string().nullable()
+	}).loose()
+}).loose();
+const gscdumpSitemapChangesResponseSchema = z.object({
+	added: z.array(z.object({
+		url: z.string(),
+		sitemap: z.string(),
+		firstSeenAt: z.number()
+	}).loose()),
+	removed: z.array(z.object({
+		url: z.string(),
+		sitemap: z.string(),
+		removedAt: z.number()
+	}).loose()),
+	summary: z.object({
+		totalAdded: z.number(),
+		totalRemoved: z.number(),
+		period: z.object({ days: z.number() })
+	}).optional()
+}).loose();
+const indexingUrlsParamsSchema = z.object({
+	limit: z.number().optional(),
+	offset: z.number().optional(),
+	status: z.enum([
+		"indexed",
+		"not_indexed",
+		"pending"
+	]).optional(),
+	issue: z.string().optional(),
+	search: z.string().optional()
+}).optional();
+const gscdumpIndexingResponseSchema = z.object({
+	trend: z.array(z.object({
+		date: z.string(),
+		totalUrls: z.number(),
+		indexedCount: z.number().nullable(),
+		notIndexedCount: z.number().nullable(),
+		errorCount: z.number().nullable(),
+		indexedPercent: z.number(),
+		issues: z.object({
+			blockedByRobots: z.number().nullable(),
+			noindexDetected: z.number().nullable(),
+			soft404: z.number().nullable(),
+			redirect: z.number().nullable(),
+			notFound: z.number().nullable(),
+			serverError: z.number().nullable()
+		}).loose(),
+		coverage: z.object({
+			submittedIndexed: z.number().nullable(),
+			crawledNotIndexed: z.number().nullable(),
+			discoveredNotCrawled: z.number().nullable()
+		}).loose(),
+		signals: z.object({
+			mobilePass: z.number(),
+			mobileFail: z.number(),
+			richResultsPass: z.number(),
+			richResultsFail: z.number()
+		}).loose()
+	}).loose()),
+	summary: z.object({
+		totalUrls: z.number(),
+		indexed: z.number(),
+		notIndexed: z.number(),
+		pending: z.number(),
+		indexedPercent: z.number(),
+		oldestCheck: z.string().nullable(),
+		newestCheck: z.string().nullable(),
+		change7d: z.number().nullable(),
+		change28d: z.number().nullable(),
+		signals: z.object({
+			mobilePass: z.number(),
+			mobileFail: z.number(),
+			mobileUnspecified: z.number(),
+			richResultsPass: z.number(),
+			richResultsFail: z.number(),
+			richResultTypes: z.array(z.object({
+				type: z.string(),
+				count: z.number()
+			}).loose()),
+			crawlingMobile: z.number(),
+			crawlingDesktop: z.number()
+		}).loose()
+	}).loose(),
+	meta: z.object({
+		siteUrl: z.string(),
+		syncStatus: z.string().nullable(),
+		indexingStatus: z.enum([
+			"pending",
+			"partial",
+			"complete"
+		]),
+		indexingProgress: z.number(),
+		sitemapTotal: z.number(),
+		inspectedCount: z.number(),
+		noSitemapsSubmitted: z.boolean(),
+		sitemapsPending: z.boolean(),
+		rollupBuiltAt: z.number().optional()
+	}).loose()
+}).loose();
+const gscdumpIndexingUrlsResponseSchema = z.object({
+	urls: z.array(unknownRecord),
+	pagination: z.object({
+		total: z.number(),
+		limit: z.number(),
+		offset: z.number(),
+		hasMore: z.boolean()
+	}),
+	meta: z.object({
+		siteUrl: z.string(),
+		status: z.string(),
+		issue: z.string().nullable()
+	}).loose()
+}).loose();
+const gscdumpIndexingDiagnosticsResponseSchema = z.object({
+	summary: z.object({
+		totalUrls: z.number(),
+		indexed: z.number(),
+		indexedPercent: z.number()
+	}).loose(),
+	issues: z.array(unknownRecord),
+	meta: z.object({ siteUrl: z.string() }).loose()
+}).loose();
+const gscdumpUserSettingsSchema = z.object({ browserAnalyzerEnabled: z.boolean() }).loose();
+const gscdumpPermissionRecoverySchema = z.object({
+	success: z.boolean(),
+	permissionLevel: z.string().nullable(),
+	jobsQueued: z.number(),
+	message: z.string()
+}).loose();
+const gscdumpUserMeResponseSchema = z.object({
+	id: z.string(),
+	name: z.string().optional(),
+	email: z.string(),
+	picture: z.string().optional(),
+	setupComplete: z.boolean(),
+	databaseReady: z.boolean(),
+	plan: z.string(),
+	accountStatus: z.enum(accountStatuses),
+	accountNextAction: z.enum(accountNextActions),
+	missingScopes: z.array(z.string()),
+	browserAnalyzerEnabled: z.boolean(),
+	stats: z.object({
+		activeSessions: z.number(),
+		totalApiCalls: z.number(),
+		lastUsed: z.number().nullable()
+	}).nullable()
+}).loose();
+const gscdumpHealthResponseSchema = z.object({
+	timestamp: z.number(),
+	jobs: z.object({
+		byStatus: z.record(z.string(), z.number()),
+		byQueue: z.record(z.string(), z.number()),
+		stuck: z.number(),
+		oldCompleted: z.number()
+	}).loose(),
+	failures: z.object({ lastHour: z.number() }).loose(),
+	users: z.object({ needsReauth: z.number() }).loose(),
+	throughput: z.object({ completedLastHour: z.number() }).loose(),
+	totals: z.object({
+		users: z.number(),
+		sites: z.number(),
+		byPlan: z.record(z.string(), z.number())
+	}).loose()
+}).loose();
+const syncProgressPhaseCountsSchema = z.object({
+	total: z.number(),
+	done: z.number(),
+	pending: z.number(),
+	stuck: z.number(),
+	failed: z.number(),
+	percent: z.number(),
+	rows: z.number()
+}).loose();
+const gscdumpSyncProgressResponseSchema = z.object({
+	summary: z.object({
+		total: z.number(),
+		inInitial: z.number(),
+		inBackfill: z.number(),
+		complete: z.number(),
+		stalled: z.number(),
+		authBlocked: z.number(),
+		totalRows: z.number(),
+		avgInitialPercent: z.number(),
+		avgBackfillPercent: z.number()
+	}).loose(),
+	sites: z.array(z.object({
+		id: z.string(),
+		userId: z.number(),
+		partnerId: z.number().nullable(),
+		siteUrl: z.string(),
+		syncStatus: z.string().nullable(),
+		lastError: z.string().nullable(),
+		createdAt: z.number(),
+		oldestDateSynced: z.string().nullable(),
+		newestDateSynced: z.string().nullable(),
+		oldestDateAvailable: z.string().nullable(),
+		userEmail: z.string().nullable(),
+		partnerName: z.string().nullable(),
+		needsReauth: z.boolean(),
+		authFailureCount: z.number(),
+		currentPhase: z.enum([
+			"initial",
+			"backfill",
+			"complete"
+		]),
+		isStalled: z.boolean(),
+		stallDays: z.number(),
+		needsContinuation: z.boolean(),
+		missingDays: z.number(),
+		initial: syncProgressPhaseCountsSchema,
+		backfill: syncProgressPhaseCountsSchema.extend({
+			processing: z.number(),
+			daysTarget: z.number(),
+			daysQueued: z.number()
+		}).loose(),
+		tables: z.record(z.string(), z.object({
+			percent: z.number(),
+			rows: z.number()
+		}).loose()),
+		overallPercent: z.number(),
+		totalRows: z.number(),
+		dateStatuses: z.array(z.object({
+			date: z.string(),
+			status: z.enum([
+				"completed",
+				"queued",
+				"processing",
+				"failed"
+			])
+		}).loose())
+	}).loose()),
+	pagination: z.object({
+		total: z.number(),
+		limit: z.number(),
+		offset: z.number(),
+		hasMore: z.boolean()
+	}).loose(),
+	hasD1Stats: z.boolean()
+}).loose();
+const syncJobsQueueCountsSchema = z.object({
+	queued: z.number(),
+	processing: z.number()
+}).loose();
+const gscdumpSyncJobsResponseSchema = z.object({
+	jobs: z.array(z.object({
+		id: z.number(),
+		userSiteId: z.string().nullable(),
+		tableName: z.string().optional(),
+		tableTier: z.string().optional(),
+		date: z.string().optional(),
+		priority: z.string().optional(),
+		status: z.enum([
+			"queued",
+			"processing",
+			"completed",
+			"failed",
+			"scheduled"
+		]),
+		siteUrl: z.string().nullable(),
+		userEmail: z.string().nullable().optional(),
+		rowsFetched: z.number().nullable(),
+		rowsInserted: z.number().nullable(),
+		error: z.string().nullable(),
+		retryCount: z.number(),
+		queuedAt: z.number(),
+		startedAt: z.number().nullable(),
+		completedAt: z.number().nullable()
+	}).loose()),
+	summary: z.object({
+		queued: z.number(),
+		processing: z.number(),
+		completed: z.number(),
+		failed: z.number()
+	}).loose(),
+	queues: z.record(z.string(), syncJobsQueueCountsSchema),
+	tiers: z.object({
+		critical: syncJobsQueueCountsSchema.optional(),
+		standard: syncJobsQueueCountsSchema.optional(),
+		extended: syncJobsQueueCountsSchema.optional()
+	}).loose().optional()
+}).loose();
+const gscdumpSiteReportResponseSchema = z.object({
+	status: z.enum(["done", "error"]),
+	cached: z.boolean(),
+	result: z.unknown().optional(),
+	error: z.string().optional()
+}).loose();
+const gscdumpTopAssociationParamsSchema = z.object({
+	type: z.enum(["topPage", "topKeyword"]),
+	identifier: z.string().min(1),
+	startDate: z.string(),
+	endDate: z.string()
+});
+const gscdumpTopAssociationResponseSchema = z.object({ value: z.string().nullable() }).loose();
+const gscdumpAnalysisSourcesResponseSchema = z.object({
+	tables: z.record(z.string(), z.array(z.string())),
+	generatedAt: z.string(),
+	manifestVersion: z.string()
+}).loose();
+const gscdumpKeywordSparklinesParamsSchema = z.object({
+	keywords: z.array(z.string()).min(1).max(20),
+	startDate: z.string(),
+	endDate: z.string(),
+	searchType: searchTypeSchema.optional()
+});
+const gscdumpKeywordSparklinesResponseSchema = z.object({ sparklines: z.record(z.string(), z.array(z.number())) }).loose();
+const gscdumpQueryTrendParamsSchema = z.object({
+	startDate: z.string(),
+	endDate: z.string(),
+	prevStartDate: z.string().optional(),
+	prevEndDate: z.string().optional(),
+	searchType: searchTypeSchema.optional()
+});
+const gscdumpQueryTrendResponseSchema = z.object({
+	daily: z.array(z.object({
+		date: z.string(),
+		queryCount: z.number()
+	}).loose()),
+	total: z.number(),
+	previousTotal: z.number().optional(),
+	meta: z.object({
+		siteUrl: z.string(),
+		syncStatus: z.string().nullable()
+	}).loose()
+}).loose();
+const gscdumpPageTrendParamsSchema = z.object({
+	startDate: z.string(),
+	endDate: z.string(),
+	prevStartDate: z.string().optional(),
+	prevEndDate: z.string().optional(),
+	searchType: searchTypeSchema.optional()
+});
+const gscdumpPageTrendResponseSchema = z.object({
+	daily: z.array(z.object({
+		date: z.string(),
+		pageCount: z.number()
+	}).loose()),
+	total: z.number(),
+	previousTotal: z.number().optional(),
+	meta: z.object({
+		siteUrl: z.string(),
+		syncStatus: z.string().nullable()
+	}).loose()
+}).loose();
+const gscdumpDateRangeParamsSchema = z.object({
+	startDate: z.string(),
+	endDate: z.string()
+});
+const gscdumpIndexPercentParamsSchema = z.object({
+	invisibleLimit: z.number().optional(),
+	invisibleOffset: z.number().optional(),
+	orphanLimit: z.number().optional()
+}).optional();
+const gscdumpCanonicalMismatchesResponseSchema = z.object({
+	mismatches: z.array(z.object({
+		url: z.string(),
+		userCanonical: z.string(),
+		googleCanonical: z.string(),
+		verdict: z.string().nullable(),
+		coverageState: z.string().nullable(),
+		lastCrawlTime: z.string().nullable(),
+		lastCheckedAt: z.string().nullable()
+	}).loose()),
+	totalCount: z.number(),
+	consolidationTargets: z.array(z.object({
+		google_canonical: z.string(),
+		count: z.number()
+	}).loose()),
+	trend: z.array(z.object({
+		date: z.string(),
+		count: z.number()
+	}).loose()),
+	meta: z.object({
+		siteUrl: z.string(),
+		syncStatus: z.string().nullable()
+	}).loose()
+}).loose();
+const gscdumpIndexPercentResponseSchema = z.object({
+	trend: z.array(z.object({
+		date: z.string(),
+		percent: z.number(),
+		total: z.number(),
+		visible: z.number(),
+		added: z.number().nullable(),
+		removed: z.number().nullable()
+	}).loose()),
+	invisibleUrls: z.array(z.object({
+		url: z.string(),
+		firstSeen: z.string().optional(),
+		lastmod: z.string().nullable()
+	}).loose()),
+	invisibleCount: z.number(),
+	orphanPages: z.array(z.object({
+		url: z.string(),
+		impressions: z.number().nullable(),
+		clicks: z.number().nullable()
+	}).loose()),
+	orphanCount: z.number(),
+	sitemaps: z.array(z.object({
+		path: z.string(),
+		urlCount: z.number(),
+		isIndex: z.boolean()
+	}).loose()),
+	summary: z.object({
+		currentPercent: z.number(),
+		totalSitemapUrls: z.number(),
+		visibleUrls: z.number(),
+		change7d: z.number().nullable(),
+		change28d: z.number().nullable(),
+		dataDate: z.string()
+	}).loose(),
+	meta: z.object({
+		siteUrl: z.string(),
+		syncStatus: z.string().nullable(),
+		newestDateSynced: z.string().nullable()
+	}).loose()
+}).loose();
+const gscdumpDeletePartnerUserResponseSchema = z.object({
+	ok: z.literal(true),
+	queued: z.literal(true),
+	userId: z.number(),
+	publicId: z.string()
+}).loose();
+const gscdumpTeamRoleSchema = z.enum([
+	"admin",
+	"editor",
+	"viewer"
+]);
+const gscdumpTeamRowSchema = z.object({
+	id: z.string(),
+	ownerId: z.number(),
+	name: z.string(),
+	personalTeam: z.boolean(),
+	createdAt: z.number(),
+	updatedAt: z.number()
+}).loose();
+const gscdumpTeamMemberRowSchema = z.object({
+	userId: z.number(),
+	publicId: z.string(),
+	name: z.string().nullable(),
+	email: z.email(),
+	picture: z.string().nullable(),
+	role: gscdumpTeamRoleSchema,
+	joinedAt: z.number()
+}).loose();
+const createPartnerTeamSchema = z.object({
+	ownerUserId: z.string(),
+	name: z.string().min(2).max(60),
+	personalTeam: z.boolean().optional()
+});
+const addPartnerTeamMemberSchema = z.object({
+	userId: z.string(),
+	role: gscdumpTeamRoleSchema
+});
+const bindPartnerSiteTeamSchema = z.object({ teamId: z.string().nullable() });
+const partnerRealtimeEventSchema = z.discriminatedUnion("event", [
+	z.object({
+		event: z.literal("sync.progress"),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		table: z.string(),
+		date: z.string(),
+		progress: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("sync.complete"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		table: z.string(),
+		date: z.string(),
+		rowsFetched: z.number(),
+		rowsInserted: z.number(),
+		timestamp: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("sync.job_complete"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		table: z.string(),
+		date: z.string(),
+		rowsFetched: z.number(),
+		rowsInserted: z.number(),
+		syncStatus: z.string(),
+		timestamp: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("sync.site_complete"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		syncStatus: z.string(),
+		timestamp: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("sync.failed"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		table: z.string(),
+		date: z.string(),
+		error: z.string(),
+		timestamp: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("job.failed"),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		table: z.string(),
+		date: z.string(),
+		error: z.string(),
+		timestamp: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("site.added"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string()
+	}).loose(),
+	z.object({
+		event: z.literal("site.removed"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string()
+	}).loose(),
+	z.object({
+		event: z.literal("auth.failed"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		error: z.string(),
+		timestamp: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("auth.needs_reauth"),
+		userId: z.number(),
+		failureCount: z.number(),
+		timestamp: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("enrichment.complete"),
+		siteId: z.string(),
+		userId: z.number(),
+		timestamp: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("sitemap.progress"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		discovered: z.number(),
+		total: z.number(),
+		progress: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("sitemap.complete"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		discoveredCount: z.number(),
+		timestamp: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("indexing.progress"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		checked: z.number(),
+		total: z.number(),
+		progress: z.number()
+	}).loose(),
+	z.object({
+		event: z.literal("indexing.complete"),
+		userId: z.number(),
+		siteId: z.string(),
+		siteUrl: z.string(),
+		totalUrls: z.number(),
+		indexedCount: z.number(),
+		timestamp: z.number()
+	}).loose()
+]);
+const canonicalWebhookEventTypeSchema = z.enum(CANONICAL_WEBHOOK_EVENTS);
+const webhookEventTypeSchema = canonicalWebhookEventTypeSchema;
+const jobFailedWebhookPayloadSchema = z.object({
+	event: z.literal("job.failed"),
+	siteId: z.string(),
+	siteUrl: z.string(),
+	table: z.string(),
+	date: z.string(),
+	error: z.string(),
+	timestamp: z.number()
+}).loose();
+const partnerWebhookDataSchema = unknownRecord;
+const partnerWebhookEnvelopeSchema = z.object({
+	contractVersion: z.literal(WEBHOOK_CONTRACT_VERSION),
+	deliveryId: z.string().min(1),
+	event: canonicalWebhookEventTypeSchema,
+	partnerId: z.string().min(1),
+	userId: z.string().nullable(),
+	siteId: z.string().optional(),
+	externalUserId: z.string().nullable().optional(),
+	externalSiteId: z.string().nullable().optional(),
+	lifecycleRevision: z.number().int(),
+	occurredAt: z.iso.datetime(),
+	data: partnerWebhookDataSchema
+}).loose();
+const analyticsEndpointSchemas = {
+	analyticsWhoami: { response: whoamiResponseSchema },
+	analyticsSites: { response: z.array(siteListItemSchema) },
+	analyticsCountries: { response: countriesResponseSchema },
+	analyticsSearchAppearance: { response: searchAppearanceResponseSchema },
+	analyticsSitemapHistory: { response: sitemapHistoryResponseSchema },
+	analyticsSitemaps: { response: sitemapIndexSchema },
+	analyticsInspectionHistory: { response: inspectionHistoryResponseSchema },
+	analyticsInspections: { response: inspectionIndexSchema },
+	analyticsRows: { response: gscRowQueryResponseSchema },
+	analyticsRollup: { response: rollupEnvelopeSchema },
+	analyticsBackfill: {
+		body: backfillRangeSchema,
+		response: backfillResponseSchema
+	},
+	analyticsIndexingUrls: { response: indexingUrlsResponseSchema },
+	analyticsIndexingDiagnostics: { response: indexingDiagnosticsSchema },
+	analyticsIndexingInspect: {
+		body: indexingInspectRequestSchema,
+		response: indexingInspectAnyResponseSchema
+	},
+	analyticsSitemapChanges: { response: sitemapChangesResponseSchema },
+	analyticsAnalysisSources: { response: gscdumpAnalysisSourcesResponseSchema },
+	analyticsSourceInfo: { response: sourceInfoResponseSchema }
+};
+const partnerControlEndpointSchemas = {
+	appUser: { response: gscdumpUserMeResponseSchema },
+	appHealth: { response: gscdumpHealthResponseSchema },
+	appSyncProgress: { response: gscdumpSyncProgressResponseSchema },
+	appSyncJobs: { response: gscdumpSyncJobsResponseSchema },
+	registerUser: {
+		body: registerPartnerUserSchema,
+		response: gscdumpUserRegistrationSchema
+	},
+	updateUserTokens: {
+		body: updatePartnerUserTokensSchema,
+		response: z.object({
+			userId: z.string(),
+			updated: z.boolean(),
+			sites: z.array(gscdumpAvailableSiteSchema)
+		}).loose()
+	},
+	getUserStatus: { response: gscdumpUserStatusSchema },
+	getUserLifecycle: { response: partnerLifecycleResponseSchema },
+	getUserSites: { response: z.object({ sites: z.array(gscdumpUserSiteSchema) }).loose() },
+	getAvailableSites: { response: z.object({ sites: z.array(gscdumpAvailableSiteSchema) }).loose() },
+	registerSite: {
+		body: registerPartnerSiteSchema,
+		response: gscdumpSiteRegistrationSchema
+	},
+	bulkRegisterSites: {
+		body: bulkRegisterPartnerSitesSchema,
+		response: bulkRegisterPartnerSitesResponseSchema
+	},
+	deleteUser: { response: gscdumpDeletePartnerUserResponseSchema },
+	getAnalysisSources: { response: gscdumpAnalysisSourcesResponseSchema },
+	getData: {
+		state: builderStateSchema,
+		options: dataQueryOptionsSchema,
+		response: gscdumpDataResponseSchema
+	},
+	getDataDetail: {
+		state: builderStateSchema,
+		options: dataDetailOptionsSchema,
+		response: gscdumpDataDetailResponseSchema
+	},
+	getAnalysis: {
+		query: gscdumpAnalysisParamsSchema,
+		response: gscdumpAnalysisResponseSchema
+	},
+	getSitemaps: { response: gscdumpSitemapsResponseSchema },
+	getSitemapChanges: { response: gscdumpSitemapChangesResponseSchema },
+	getIndexing: { response: gscdumpIndexingResponseSchema },
+	getIndexingUrls: {
+		query: indexingUrlsParamsSchema,
+		response: gscdumpIndexingUrlsResponseSchema
+	},
+	getIndexingDiagnostics: { response: gscdumpIndexingDiagnosticsResponseSchema },
+	getIndexingInspect: {
+		body: indexingInspectRequestSchema,
+		response: indexingInspectAnyResponseSchema
+	},
+	getUserSettings: { response: gscdumpUserSettingsSchema },
+	patchUserSettings: {
+		body: gscdumpUserSettingsSchema.partial(),
+		response: gscdumpUserSettingsSchema
+	},
+	recoverPermission: { response: gscdumpPermissionRecoverySchema },
+	getTopAssociation: {
+		query: gscdumpTopAssociationParamsSchema,
+		response: gscdumpTopAssociationResponseSchema
+	},
+	getKeywordSparklines: {
+		body: gscdumpKeywordSparklinesParamsSchema,
+		response: gscdumpKeywordSparklinesResponseSchema
+	},
+	getQueryTrend: {
+		query: gscdumpQueryTrendParamsSchema,
+		response: gscdumpQueryTrendResponseSchema
+	},
+	getPageTrend: {
+		query: gscdumpPageTrendParamsSchema,
+		response: gscdumpPageTrendResponseSchema
+	},
+	getDateRangeInsight: {
+		query: gscdumpDateRangeParamsSchema,
+		response: unknownRecord
+	},
+	getCanonicalMismatches: { response: gscdumpCanonicalMismatchesResponseSchema },
+	getIndexPercent: {
+		query: gscdumpIndexPercentParamsSchema,
+		response: gscdumpIndexPercentResponseSchema
+	},
+	getSiteReport: { response: gscdumpSiteReportResponseSchema },
+	createTeam: {
+		body: createPartnerTeamSchema,
+		response: z.object({ team: gscdumpTeamRowSchema }).loose()
+	},
+	listTeamMembers: { response: z.object({ members: z.array(gscdumpTeamMemberRowSchema) }).loose() },
+	addTeamMember: {
+		body: addPartnerTeamMemberSchema,
+		response: unknownRecord
+	},
+	bindSiteToTeam: {
+		body: bindPartnerSiteTeamSchema,
+		response: z.object({
+			ok: z.literal(true),
+			teamId: z.string().nullable()
+		}).loose()
+	},
+	realtimeEvent: { message: partnerRealtimeEventSchema },
+	webhook: { message: partnerWebhookEnvelopeSchema }
+};
+const partnerEndpointSchemas = {
+	...analyticsEndpointSchemas,
+	...partnerControlEndpointSchemas
+};
+export { CANONICAL_WEBHOOK_EVENTS, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSCDUMP_WRITE_ANALYTICS_SCOPE, 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, analyticsRoutes, analyticsStatuses, backfillRangeSchema, backfillResponseSchema, bindPartnerSiteTeamSchema, builderStateSchema, bulkRegisterPartnerSitesResponseSchema, bulkRegisterPartnerSitesSchema, canonicalWebhookEventTypeSchema, countriesResponseSchema, countryRowSchema, createPartnerTeamSchema, dataDetailOptionsSchema, dataQueryOptionsSchema, gscApiRangeSchema, gscComparisonFilterSchema, gscRowQueryMetaSchema, gscRowQueryResponseSchema, gscdumpAnalysisParamsSchema, gscdumpAnalysisPresetSchema, gscdumpAnalysisResponseSchema, gscdumpAnalysisSourcesResponseSchema, gscdumpAvailableSiteSchema, gscdumpCanonicalMismatchesResponseSchema, gscdumpDataDetailResponseSchema, gscdumpDataResponseSchema, gscdumpDataRowSchema, gscdumpDateRangeParamsSchema, gscdumpDeletePartnerUserResponseSchema, gscdumpHealthResponseSchema, gscdumpIndexPercentParamsSchema, gscdumpIndexPercentResponseSchema, gscdumpIndexingDiagnosticsResponseSchema, gscdumpIndexingResponseSchema, gscdumpIndexingUrlsResponseSchema, gscdumpKeywordSparklinesParamsSchema, gscdumpKeywordSparklinesResponseSchema, gscdumpMetaSchema, gscdumpPageTrendParamsSchema, gscdumpPageTrendResponseSchema, gscdumpPermissionRecoverySchema, gscdumpQueryTrendParamsSchema, gscdumpQueryTrendResponseSchema, gscdumpSiteRegistrationSchema, gscdumpSiteReportResponseSchema, gscdumpSitemapChangesResponseSchema, gscdumpSitemapsResponseSchema, gscdumpSyncJobsResponseSchema, gscdumpSyncProgressResponseSchema, gscdumpTeamMemberRowSchema, gscdumpTeamRoleSchema, gscdumpTeamRowSchema, gscdumpTopAssociationParamsSchema, gscdumpTopAssociationResponseSchema, gscdumpTotalsSchema, gscdumpUserMeResponseSchema, gscdumpUserRegistrationSchema, gscdumpUserSettingsSchema, gscdumpUserSiteSchema, gscdumpUserStatusSchema, hasOptionalIndexingScope, hasRequiredAnalyticsScope, indexingDiagnosticsSchema, indexingInspectAnyResponseSchema, indexingInspectRateLimitedSchema, indexingInspectRequestSchema, indexingInspectResponseSchema, indexingInspectResultSchema, indexingIssueSchema, indexingNextActions, indexingStatuses, indexingUrlRowSchema, indexingUrlStatusSchema, indexingUrlsParamsSchema, indexingUrlsResponseSchema, inspectionHistoryRecordSchema, inspectionHistoryResponseSchema, inspectionIndexSchema, inspectionRecordRawSchema, jobFailedWebhookPayloadSchema, lifecycleErrorCodes, lifecycleErrorSchema, lifecycleProgressSchema, lifecycleWebhookEvents, parseGrantedScopes, partnerControlEndpointSchemas, partnerEndpointSchemas, partnerLifecycleAccountSchema, partnerLifecycleResponseSchema, partnerLifecycleSiteSchema, partnerRealtimeEventSchema, partnerRoutes, partnerWebhookDataSchema, partnerWebhookEnvelopeSchema, propertyNextActions, propertyStatuses, querySourceModes, registerPartnerSiteSchema, registerPartnerUserSchema, rollupEnvelopeSchema, scheduleStateSchema, searchAppearanceResponseSchema, searchAppearanceRowSchema, searchTypeSchema, siteListItemSchema, sitemapChangesResponseSchema, sitemapHistoryRecordSchema, sitemapHistoryResponseSchema, sitemapIndexSchema, sitemapNextActions, sitemapStatuses, sourceInfoResponseSchema, updatePartnerUserTokensSchema, webhookEventTypeSchema, whoamiResponseSchema };