@gscdump/contracts 1.5.4 → 2.0.1

package/dist/schemas.mjs

@@ -84,14 +84,6 @@ const siteListItemSchema = z.object({
 	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(),
@@ -131,10 +123,6 @@ 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)
@@ -282,7 +270,9 @@ const indexingInspectAnyResponseSchema = z.union([indexingInspectResponseSchema,
 const sitemapChangesTruncationReasonSchema = z.enum([
 	"scan_limit",
 	"added_limit",
-	"removed_limit"
+	"removed_limit",
+	"updated_limit",
+	"history_unavailable"
 ]);
 const sitemapChangesCompletenessSchema = z.discriminatedUnion("_tag", [z.object({
 	_tag: z.literal("complete"),
@@ -291,10 +281,12 @@ const sitemapChangesCompletenessSchema = z.discriminatedUnion("_tag", [z.object(
 	_tag: z.literal("truncated"),
 	scannedUrls: z.number().int().nonnegative(),
 	reasons: z.array(sitemapChangesTruncationReasonSchema).min(1),
+	historyAvailableFrom: z.number().int().nonnegative().optional(),
 	limits: z.object({
 		scannedUrls: z.number().int().positive(),
 		added: z.number().int().positive(),
-		removed: z.number().int().positive()
+		removed: z.number().int().positive(),
+		updated: z.number().int().positive()
 	}).loose()
 }).loose()]);
 const sitemapChangesResponseSchema = z.object({
@@ -311,6 +303,7 @@ const sitemapChangesResponseSchema = z.object({
 	summary: z.object({
 		totalAdded: z.number(),
 		totalRemoved: z.number(),
+		totalUpdated: z.number(),
 		period: z.object({ days: z.number() })
 	}).loose(),
 	completeness: sitemapChangesCompletenessSchema
@@ -703,6 +696,19 @@ const gscdumpAnalysisBundleResponseSchema = z.object({
 	})),
 	meta: gscdumpAnalysisMetaSchema
 }).loose();
+const gscdumpSitemapGenerationSchema = z.object({
+	id: z.string().min(1),
+	observedAt: z.number().int().nonnegative(),
+	publishedAt: z.number().int().nonnegative(),
+	completeness: z.object({ _tag: z.literal("complete") }).strict(),
+	membershipHistoryAvailableFrom: z.number().int().nonnegative().nullable(),
+	legacyImport: z.discriminatedUnion("_tag", [z.object({ _tag: z.literal("none") }).strict(), z.object({
+		_tag: z.literal("metadata_only"),
+		importedAt: z.number().int().nonnegative(),
+		recordCount: z.number().int().nonnegative(),
+		source: z.literal("gsc_sitemaps")
+	}).strict()])
+}).strict();
 const gscdumpSitemapsResponseSchema = z.object({
 	sitemaps: z.array(z.object({
 		path: z.string(),
@@ -737,7 +743,8 @@ const gscdumpSitemapsResponseSchema = z.object({
 			excludedCount: z.number().int().nonnegative(),
 			duplicateCount: z.number().int().nonnegative()
 		})
-	}).loose()
+	}).loose(),
+	generation: z.lazy(() => gscdumpSitemapGenerationSchema).nullable()
 }).loose();
 const gscdumpSitemapChangesResponseSchema = z.object({
 	added: z.array(z.object({
@@ -750,12 +757,21 @@ const gscdumpSitemapChangesResponseSchema = z.object({
 		sitemap: z.string(),
 		removedAt: z.number()
 	}).loose()),
+	updated: z.array(z.object({
+		url: z.string(),
+		sitemap: z.string(),
+		previousLastmod: z.string().nullable(),
+		lastmod: z.string().nullable(),
+		observedAt: z.number()
+	}).loose()),
 	summary: z.object({
 		totalAdded: z.number(),
 		totalRemoved: z.number(),
+		totalUpdated: z.number(),
 		period: z.object({ days: z.number() })
 	}).optional(),
-	completeness: sitemapChangesCompletenessSchema
+	completeness: sitemapChangesCompletenessSchema,
+	generation: z.lazy(() => gscdumpSitemapGenerationSchema).nullable()
 }).loose();
 const indexingUrlsParamsSchema = z.object({
 	limit: z.number().optional(),
@@ -1454,8 +1470,6 @@ const analyticsEndpointSchemas = {
 	analyticsSites: { response: z.array(siteListItemSchema) },
 	analyticsCountries: { response: countriesResponseSchema },
 	analyticsSearchAppearance: { response: searchAppearanceResponseSchema },
-	analyticsSitemapHistory: { response: sitemapHistoryResponseSchema },
-	analyticsSitemaps: { response: sitemapIndexSchema },
 	analyticsInspectionHistory: { response: inspectionHistoryResponseSchema },
 	analyticsInspections: { response: inspectionIndexSchema },
 	analyticsRollup: { response: rollupEnvelopeSchema },
@@ -1472,7 +1486,6 @@ const analyticsEndpointSchemas = {
 		body: indexingInspectRequestSchema,
 		response: indexingInspectAnyResponseSchema
 	},
-	analyticsSitemapChanges: { response: sitemapChangesResponseSchema },
 	analyticsAnalysisSources: { response: gscdumpAnalysisSourcesResponseSchema },
 	analyticsQueryDimSource: { response: queryDimSourceResponseSchema },
 	analyticsBulkSources: { response: bulkFileResolutionResponseSchema },
@@ -1513,33 +1526,80 @@ const partnerSitemapActionResponseSchema = z.discriminatedUnion("action", [
 ]);
 const gscdumpSitemapMembershipParamsSchema = z.object({
 	urls: z.array(z.string().min(1).max(2048)).max(500),
-	maxAgeDays: z.number().int().positive().max(365).optional()
-});
-const gscdumpSitemapMembershipUrlSchema = z.object({
-	url: z.string(),
-	normalized: z.string(),
-	inSitemap: z.boolean(),
-	sitemapUrl: z.string().nullable().optional(),
-	lastSeenAt: z.string().nullable().optional(),
-	lastmod: z.string().nullable().optional(),
-	sitemapFetchedAt: z.string().nullable().optional()
-}).loose();
+	generationId: z.string().min(1).optional()
+}).strict();
+const gscdumpSitemapMembershipEvidenceSchema = z.discriminatedUnion("_tag", [
+	z.object({
+		_tag: z.literal("present"),
+		url: z.string(),
+		feedpath: z.string(),
+		lastmod: z.string().nullable(),
+		firstSeenAt: z.number().int().nonnegative(),
+		lastSeenAt: z.number().int().nonnegative()
+	}).strict(),
+	z.object({
+		_tag: z.literal("absent"),
+		url: z.string(),
+		observedAt: z.number().int().nonnegative()
+	}).strict(),
+	z.object({
+		_tag: z.literal("unknown"),
+		url: z.string(),
+		reason: z.enum([
+			"no_generation",
+			"generation_not_found",
+			"generation_incomplete",
+			"history_pruned",
+			"invalid_url"
+		])
+	}).strict()
+]);
 const gscdumpSitemapMembershipResponseSchema = z.object({
-	urls: z.array(gscdumpSitemapMembershipUrlSchema),
+	generation: gscdumpSitemapGenerationSchema.nullable(),
+	evidence: z.array(gscdumpSitemapMembershipEvidenceSchema),
 	meta: z.object({
-		available: z.boolean(),
-		reason: z.enum([
-			"empty",
-			"endpoint_unavailable",
-			"site_url_cap_exceeded",
-			"stale_sitemaps"
-		]).nullable(),
 		requested: z.number().int().nonnegative(),
 		checked: z.number().int().nonnegative(),
-		matched: z.number().int().nonnegative(),
-		newestFetchedAt: z.string().nullable()
-	}).loose()
-}).loose();
+		matched: z.number().int().nonnegative()
+	}).strict()
+}).strict();
+const gscdumpSitemapUrlsQuerySchema = z.object({
+	generationId: z.string().min(1).optional(),
+	feedpath: z.string().min(1).optional(),
+	cursor: z.string().min(1).optional(),
+	limit: z.coerce.number().int().min(1).max(1e4).optional()
+}).strict();
+const gscdumpSitemapUrlsResponseSchema = z.object({
+	generation: gscdumpSitemapGenerationSchema,
+	items: z.array(z.object({
+		url: z.string(),
+		feedpath: z.string(),
+		lastmod: z.string().nullable(),
+		firstSeenAt: z.number().int().nonnegative(),
+		lastSeenAt: z.number().int().nonnegative()
+	}).strict()),
+	page: z.object({
+		nextCursor: z.string().nullable(),
+		limit: z.number().int().positive()
+	}).strict()
+}).strict();
+const gscdumpSitemapExportQuerySchema = z.object({
+	generationId: z.string().min(1).optional(),
+	feedpath: z.string().min(1).optional()
+}).strict();
+const gscdumpSitemapExportResponseSchema = z.object({
+	generation: gscdumpSitemapGenerationSchema,
+	export: z.discriminatedUnion("_tag", [z.object({
+		_tag: z.literal("url"),
+		url: z.url(),
+		expiresAt: z.number().int().nonnegative(),
+		contentType: z.literal("application/x-ndjson"),
+		contentEncoding: z.enum(["identity", "gzip"])
+	}).strict(), z.object({
+		_tag: z.literal("unavailable"),
+		reason: z.enum(["generation_not_found", "export_unavailable"])
+	}).strict()])
+}).strict();
 const partnerControlEndpointSchemas = {
 	appUser: { response: gscdumpUserMeResponseSchema },
 	appHealth: { response: gscdumpHealthResponseSchema },
@@ -1581,16 +1641,6 @@ const partnerControlEndpointSchemas = {
 		options: dataDetailOptionsSchema,
 		response: gscdumpDataDetailResponseSchema
 	},
-	getSitemaps: { response: gscdumpSitemapsResponseSchema },
-	getSitemapChanges: { response: gscdumpSitemapChangesResponseSchema },
-	postSitemaps: {
-		body: partnerSitemapActionSchema,
-		response: partnerSitemapActionResponseSchema
-	},
-	getSitemapMembership: {
-		body: gscdumpSitemapMembershipParamsSchema,
-		response: gscdumpSitemapMembershipResponseSchema
-	},
 	getIndexing: { response: gscdumpIndexingResponseSchema },
 	getIndexingUrls: {
 		query: indexingUrlsParamsSchema,
@@ -1676,4 +1726,4 @@ const partnerEndpointSchemas = {
 	...analyticsEndpointSchemas,
 	...partnerControlEndpointSchemas
 };
-export { GSCDUMP_INDEXING_TRANSITION_FIELDS, SEARCH_TYPE_CAPABILITIES, addPartnerTeamMemberSchema, analyticsEndpointSchemas, backfillRangeSchema, backfillResponseSchema, bindPartnerSiteTeamSchema, bindPartnerTeamCatalogResponseSchema, bindPartnerTeamCatalogSchema, builderStateSchema, bulkFileResolutionResponseSchema, bulkRegisterPartnerSitesResponseSchema, bulkRegisterPartnerSitesSchema, canonicalDifferenceKindSchema, 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, gscdumpIndexingTransitionFieldSchema, 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, sitemapChangesCompletenessSchema, sitemapChangesResponseSchema, sitemapChangesTruncationReasonSchema, sitemapHistoryRecordSchema, sitemapHistoryResponseSchema, sitemapIndexSchema, sourceInfoResponseSchema, teamCatalogRefSchema, updatePartnerUserTokensSchema, whoamiResponseSchema };
+export { GSCDUMP_INDEXING_TRANSITION_FIELDS, SEARCH_TYPE_CAPABILITIES, addPartnerTeamMemberSchema, analyticsEndpointSchemas, backfillRangeSchema, backfillResponseSchema, bindPartnerSiteTeamSchema, bindPartnerTeamCatalogResponseSchema, bindPartnerTeamCatalogSchema, builderStateSchema, bulkFileResolutionResponseSchema, bulkRegisterPartnerSitesResponseSchema, bulkRegisterPartnerSitesSchema, canonicalDifferenceKindSchema, 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, gscdumpIndexingTransitionFieldSchema, gscdumpIndexingUrlsResponseSchema, gscdumpKeywordSparklinesParamsSchema, gscdumpKeywordSparklinesResponseSchema, gscdumpMetaSchema, gscdumpPageTrendParamsSchema, gscdumpPageTrendResponseSchema, gscdumpPermissionRecoverySchema, gscdumpQueryTrendParamsSchema, gscdumpQueryTrendResponseSchema, gscdumpSiteRegistrationSchema, gscdumpSiteReportResponseSchema, gscdumpSitemapChangesResponseSchema, gscdumpSitemapExportQuerySchema, gscdumpSitemapExportResponseSchema, gscdumpSitemapGenerationSchema, gscdumpSitemapMembershipEvidenceSchema, gscdumpSitemapMembershipParamsSchema, gscdumpSitemapMembershipResponseSchema, gscdumpSitemapUrlsQuerySchema, gscdumpSitemapUrlsResponseSchema, 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, sitemapChangesCompletenessSchema, sitemapChangesResponseSchema, sitemapChangesTruncationReasonSchema, sourceInfoResponseSchema, teamCatalogRefSchema, updatePartnerUserTokensSchema, whoamiResponseSchema };

package/dist/types.d.mts

@@ -81,30 +81,6 @@ interface ScheduleState {
   consecutiveUnchanged: number;
   policyVersion: number;
 }
-interface SitemapHistoryRecord {
-  path: string;
-  capturedAt: string;
-  lastDownloaded?: string;
-  lastSubmitted?: string;
-  type?: string;
-  isPending?: boolean;
-  isSitemapsIndex?: boolean;
-  errors?: string;
-  warnings?: string;
-  contents?: Array<{
-    type?: string;
-    submitted?: string;
-    indexed?: string;
-  }>;
-  raw?: unknown;
-  urlCount?: number;
-  contentHash?: string;
-  schedule?: ScheduleState;
-}
-interface SitemapHistoryResponse {
-  path: string | null;
-  snapshots: SitemapHistoryRecord[];
-}
 /**
  * Wire-format extension carried under `InspectionHistoryRecord.raw`.
  *
@@ -155,10 +131,6 @@ interface InspectionHistoryResponse {
   url: string | null;
   records: InspectionHistoryRecord[];
 }
-interface SitemapIndex {
-  version: 1;
-  records: Record<string, SitemapHistoryRecord>;
-}
 interface InspectionIndex {
   version: 1;
   records: Record<string, InspectionHistoryRecord>;
@@ -313,11 +285,13 @@ type SitemapChangesCompleteness = {
 } | {
   _tag: 'truncated';
   scannedUrls: number;
-  reasons: Array<'scan_limit' | 'added_limit' | 'removed_limit'>;
+  reasons: Array<'scan_limit' | 'added_limit' | 'removed_limit' | 'updated_limit' | 'history_unavailable'>;
+  historyAvailableFrom?: number;
   limits: {
     scannedUrls: number;
     added: number;
     removed: number;
+    updated: number;
   };
 };
 interface SitemapChangesResponse {
@@ -326,6 +300,7 @@ interface SitemapChangesResponse {
   summary: {
     totalAdded: number;
     totalRemoved: number;
+    totalUpdated: number;
     period: {
       days: number;
     };
@@ -645,6 +620,7 @@ interface GscdumpSitemapsResponse {
       duplicateCount: number;
     };
   };
+  generation: GscdumpSitemapGeneration | null;
 }
 interface GscdumpSitemapChangesResponse {
   added: {
@@ -657,14 +633,40 @@ interface GscdumpSitemapChangesResponse {
     sitemap: string;
     removedAt: number;
   }[];
+  updated: {
+    url: string;
+    sitemap: string;
+    previousLastmod: string | null;
+    lastmod: string | null;
+    observedAt: number;
+  }[];
   summary?: {
     totalAdded: number;
     totalRemoved: number;
+    totalUpdated: number;
     period: {
       days: number;
     };
   };
   completeness: SitemapChangesCompleteness;
+  generation: GscdumpSitemapGeneration | null;
+}
+interface GscdumpSitemapGeneration {
+  id: string;
+  observedAt: number;
+  publishedAt: number;
+  completeness: {
+    _tag: 'complete';
+  };
+  membershipHistoryAvailableFrom: number | null;
+  legacyImport: {
+    _tag: 'none';
+  } | {
+    _tag: 'metadata_only';
+    importedAt: number;
+    recordCount: number;
+    source: 'gsc_sitemaps';
+  };
 }
 type PartnerSitemapAction = {
   action: 'submit' | 'delete';
@@ -692,27 +694,58 @@ type PartnerSitemapActionResponse = {
 };
 interface GscdumpSitemapMembershipParams {
   urls: string[];
-  maxAgeDays?: number;
+  generationId?: string;
 }
-type GscdumpSitemapMembershipUnavailableReason = 'empty' | 'endpoint_unavailable' | 'site_url_cap_exceeded' | 'stale_sitemaps';
-interface GscdumpSitemapMembershipUrl {
+type GscdumpSitemapMembershipEvidence = {
+  _tag: 'present';
   url: string;
-  normalized: string;
-  inSitemap: boolean;
-  sitemapUrl?: string | null;
-  lastSeenAt?: string | null;
-  lastmod?: string | null;
-  sitemapFetchedAt?: string | null;
-}
+  feedpath: string;
+  lastmod: string | null;
+  firstSeenAt: number;
+  lastSeenAt: number;
+} | {
+  _tag: 'absent';
+  url: string;
+  observedAt: number;
+} | {
+  _tag: 'unknown';
+  url: string;
+  reason: 'no_generation' | 'generation_not_found' | 'generation_incomplete' | 'history_pruned' | 'invalid_url';
+};
 interface GscdumpSitemapMembershipResponse {
-  urls: GscdumpSitemapMembershipUrl[];
+  generation: GscdumpSitemapGeneration | null;
+  evidence: GscdumpSitemapMembershipEvidence[];
   meta: {
-    available: boolean;
-    reason: GscdumpSitemapMembershipUnavailableReason | null;
     requested: number;
     checked: number;
     matched: number;
-    newestFetchedAt: string | null;
+  };
+}
+interface GscdumpSitemapUrlsResponse {
+  generation: GscdumpSitemapGeneration;
+  items: Array<{
+    url: string;
+    feedpath: string;
+    lastmod: string | null;
+    firstSeenAt: number;
+    lastSeenAt: number;
+  }>;
+  page: {
+    nextCursor: string | null;
+    limit: number;
+  };
+}
+interface GscdumpSitemapExportResponse {
+  generation: GscdumpSitemapGeneration;
+  export: {
+    _tag: 'url';
+    url: string;
+    expiresAt: number;
+    contentType: 'application/x-ndjson';
+    contentEncoding: 'identity' | 'gzip';
+  } | {
+    _tag: 'unavailable';
+    reason: 'generation_not_found' | 'export_unavailable';
   };
 }
 interface GscdumpIndexingTrendPoint {
@@ -1390,4 +1423,4 @@ interface PartnerWebhookHeaders {
   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, GscSearchType, 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, 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, SitemapChangesCompleteness, SitemapChangesResponse, SitemapHistoryRecord, SitemapHistoryResponse, SitemapIndex, SitemapRemovedRow, SourceInfoOptions, SourceInfoResponse, TableName, TableSchema, TenantCtx, UpdatePartnerUserTokensParams, WebhookEnvelope, WebhookEventType, WhoamiResponse };
+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, 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 };