@gscdump/contracts 0.25.1 → 0.25.3

package/dist/index.d.mts

@@ -789,6 +789,11 @@ interface GscdumpIndexingResponse {
   };
 }
 type GscdumpIndexingUrlStatus = 'indexed' | 'not_indexed' | 'pending';
+type GscdumpIndexingIssueSeverity = 'error' | 'warning' | 'info';
+interface GscdumpRichResultItem {
+  richResultType: string;
+  items?: unknown[];
+}
 interface GscdumpIndexingUrl {
   url: string;
   verdict: string | null;
@@ -803,9 +808,9 @@ interface GscdumpIndexingUrl {
   sitemaps?: string[] | null;
   referringUrls?: string[] | null;
   mobileVerdict?: string | null;
-  mobileIssues?: unknown[] | null;
+  mobileIssues?: string[] | null;
   richResultsVerdict?: string | null;
-  richResultsItems?: unknown[] | null;
+  richResultsItems?: GscdumpRichResultItem[] | null;
   inspectionResultLink?: string | null;
   firstCheckedAt: string;
   lastCheckedAt: string;
@@ -834,7 +839,7 @@ interface GscdumpIndexingDiagnosticsResponse {
   issues: {
     type: string;
     label: string;
-    severity: string;
+    severity: GscdumpIndexingIssueSeverity;
     count: number;
   }[];
   meta: {
@@ -1022,6 +1027,25 @@ interface GscdumpQueryTrendResponse {
     syncStatus: string | null;
   };
 }
+interface GscdumpPageTrendParams {
+  startDate: string;
+  endDate: string;
+  prevStartDate?: string;
+  prevEndDate?: string;
+  searchType?: GscSearchType;
+}
+interface GscdumpPageTrendResponse {
+  daily: Array<{
+    date: string;
+    pageCount: number;
+  }>;
+  total: number;
+  previousTotal?: number;
+  meta: {
+    siteUrl: string;
+    syncStatus: string | null;
+  };
+}
 interface GscdumpDateRangeParams {
   startDate: string;
   endDate: string;
@@ -1330,6 +1354,7 @@ interface PartnerClient {
   getTopAssociation: (siteId: string, params: GscdumpTopAssociationParams) => Promise<GscdumpTopAssociationResponse>;
   getKeywordSparklines: (siteId: string, params: GscdumpKeywordSparklinesParams) => Promise<GscdumpKeywordSparklinesResponse>;
   getQueryTrend: (siteId: string, params: GscdumpQueryTrendParams) => Promise<GscdumpQueryTrendResponse>;
+  getPageTrend: (siteId: string, params: GscdumpPageTrendParams) => Promise<GscdumpPageTrendResponse>;
   getCanonicalMismatches: (siteId: string) => Promise<GscdumpCanonicalMismatchesResponse>;
   getContentVelocity: <T = unknown>(siteId: string, days?: number) => Promise<T>;
   getCtrCurve: <T = unknown>(siteId: string, params: GscdumpDateRangeParams) => Promise<T>;
@@ -1674,6 +1699,7 @@ declare const partnerRoutes: {
     readonly topAssociation: (siteId: string) => string;
     readonly keywordSparklines: (siteId: string) => string;
     readonly queryTrend: (siteId: string) => string;
+    readonly pageTrend: (siteId: string) => string;
     readonly contentVelocity: (siteId: string) => string;
     readonly ctrCurve: (siteId: string) => string;
     readonly darkTraffic: (siteId: string) => string;
@@ -2948,17 +2974,44 @@ declare const gscdumpAnalysisResponseSchema: z.ZodObject<{
   }, z.core.$loose>;
 }, z.core.$loose>;
 declare const gscdumpSitemapsResponseSchema: z.ZodObject<{
-  sitemaps: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  history: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  perSitemapHistory: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+  sitemaps: z.ZodArray<z.ZodObject<{
+    path: z.ZodString;
+    urlCount: z.ZodNumber;
+    errors: z.ZodNumber;
+    warnings: z.ZodNumber;
+    isIndex: z.ZodOptional<z.ZodBoolean>;
+    lastSubmitted: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lastDownloaded: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$loose>>;
+  history: z.ZodArray<z.ZodObject<{
+    date: z.ZodString;
+    errors: z.ZodNumber;
+    warnings: z.ZodNumber;
+    urlCount: z.ZodNumber;
+    urlDelta: z.ZodNumber;
+  }, z.core.$loose>>;
+  perSitemapHistory: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+    date: z.ZodString;
+    urlCount: z.ZodNumber;
+    changed: z.ZodBoolean;
+    urlDelta: z.ZodNumber;
+  }, z.core.$loose>>>;
   meta: z.ZodObject<{
     siteUrl: z.ZodString;
     syncStatus: z.ZodNullable<z.ZodString>;
   }, z.core.$loose>;
 }, z.core.$loose>;
 declare const gscdumpSitemapChangesResponseSchema: z.ZodObject<{
-  added: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  removed: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  added: z.ZodArray<z.ZodObject<{
+    url: z.ZodString;
+    sitemap: z.ZodString;
+    firstSeenAt: z.ZodNumber;
+  }, z.core.$loose>>;
+  removed: z.ZodArray<z.ZodObject<{
+    url: z.ZodString;
+    sitemap: z.ZodString;
+    removedAt: z.ZodNumber;
+  }, z.core.$loose>>;
   summary: z.ZodOptional<z.ZodObject<{
     totalAdded: z.ZodNumber;
     totalRemoved: z.ZodNumber;
@@ -3333,6 +3386,32 @@ declare const gscdumpQueryTrendResponseSchema: z.ZodObject<{
     syncStatus: z.ZodNullable<z.ZodString>;
   }, z.core.$loose>;
 }, z.core.$loose>;
+declare const gscdumpPageTrendParamsSchema: z.ZodObject<{
+  startDate: z.ZodString;
+  endDate: z.ZodString;
+  prevStartDate: z.ZodOptional<z.ZodString>;
+  prevEndDate: z.ZodOptional<z.ZodString>;
+  searchType: z.ZodOptional<z.ZodEnum<{
+    web: "web";
+    image: "image";
+    video: "video";
+    news: "news";
+    discover: "discover";
+    googleNews: "googleNews";
+  }>>;
+}, z.core.$strip>;
+declare const gscdumpPageTrendResponseSchema: z.ZodObject<{
+  daily: z.ZodArray<z.ZodObject<{
+    date: z.ZodString;
+    pageCount: z.ZodNumber;
+  }, z.core.$loose>>;
+  total: z.ZodNumber;
+  previousTotal: z.ZodOptional<z.ZodNumber>;
+  meta: z.ZodObject<{
+    siteUrl: z.ZodString;
+    syncStatus: z.ZodNullable<z.ZodString>;
+  }, z.core.$loose>;
+}, z.core.$loose>;
 declare const gscdumpDateRangeParamsSchema: z.ZodObject<{
   startDate: z.ZodString;
   endDate: z.ZodString;
@@ -4697,9 +4776,28 @@ declare const partnerEndpointSchemas: {
   };
   readonly getSitemaps: {
     readonly response: z.ZodObject<{
-      sitemaps: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-      history: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-      perSitemapHistory: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+      sitemaps: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        urlCount: z.ZodNumber;
+        errors: z.ZodNumber;
+        warnings: z.ZodNumber;
+        isIndex: z.ZodOptional<z.ZodBoolean>;
+        lastSubmitted: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        lastDownloaded: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+      }, z.core.$loose>>;
+      history: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        errors: z.ZodNumber;
+        warnings: z.ZodNumber;
+        urlCount: z.ZodNumber;
+        urlDelta: z.ZodNumber;
+      }, z.core.$loose>>;
+      perSitemapHistory: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        urlCount: z.ZodNumber;
+        changed: z.ZodBoolean;
+        urlDelta: z.ZodNumber;
+      }, z.core.$loose>>>;
       meta: z.ZodObject<{
         siteUrl: z.ZodString;
         syncStatus: z.ZodNullable<z.ZodString>;
@@ -4708,8 +4806,16 @@ declare const partnerEndpointSchemas: {
   };
   readonly getSitemapChanges: {
     readonly response: z.ZodObject<{
-      added: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-      removed: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+      added: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        sitemap: z.ZodString;
+        firstSeenAt: z.ZodNumber;
+      }, z.core.$loose>>;
+      removed: z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        sitemap: z.ZodString;
+        removedAt: z.ZodNumber;
+      }, z.core.$loose>>;
       summary: z.ZodOptional<z.ZodObject<{
         totalAdded: z.ZodNumber;
         totalRemoved: z.ZodNumber;
@@ -4959,6 +5065,34 @@ declare const partnerEndpointSchemas: {
       }, z.core.$loose>;
     }, z.core.$loose>;
   };
+  readonly getPageTrend: {
+    readonly query: z.ZodObject<{
+      startDate: z.ZodString;
+      endDate: z.ZodString;
+      prevStartDate: z.ZodOptional<z.ZodString>;
+      prevEndDate: z.ZodOptional<z.ZodString>;
+      searchType: z.ZodOptional<z.ZodEnum<{
+        web: "web";
+        image: "image";
+        video: "video";
+        news: "news";
+        discover: "discover";
+        googleNews: "googleNews";
+      }>>;
+    }, z.core.$strip>;
+    readonly response: z.ZodObject<{
+      daily: z.ZodArray<z.ZodObject<{
+        date: z.ZodString;
+        pageCount: z.ZodNumber;
+      }, z.core.$loose>>;
+      total: z.ZodNumber;
+      previousTotal: z.ZodOptional<z.ZodNumber>;
+      meta: z.ZodObject<{
+        siteUrl: z.ZodString;
+        syncStatus: z.ZodNullable<z.ZodString>;
+      }, z.core.$loose>;
+    }, z.core.$loose>;
+  };
   readonly getDateRangeInsight: {
     readonly query: z.ZodObject<{
       startDate: z.ZodString;
@@ -5217,4 +5351,4 @@ declare const WEBHOOK_CONTRACT_VERSION_HEADER = "X-GSCDump-Contract-Version";
 declare const WEBHOOK_TIMESTAMP_HEADER = "X-GSCDump-Timestamp";
 declare const CANONICAL_WEBHOOK_EVENTS: readonly ["user.lifecycle.changed", "site.lifecycle.changed", "site.analytics.ready", "site.indexing.ready", "site.auth.failed", "job.failed"];
 declare const VALID_WEBHOOK_EVENTS: readonly ["user.lifecycle.changed", "site.lifecycle.changed", "site.analytics.ready", "site.indexing.ready", "site.auth.failed", "job.failed"];
-export { AccountNextAction, AccountStatus, type AddPartnerTeamMemberParams, type AnalysisSourcesOptions, type AnalysisSourcesResponse, type AnalyticsClient, AnalyticsNextAction, AnalyticsStatus, type BackfillRange, type BackfillResponse, type BindPartnerSiteTeamParams, type BuilderState, type BulkRegisterPartnerSiteResult, type BulkRegisterPartnerSitesParams, type BulkRegisterPartnerSitesResponse, CANONICAL_WEBHOOK_EVENTS, type CanonicalWebhookEventType, type ColumnDef, type ColumnType, type CountriesResponse, type CountryRow, type CreatePartnerTeamParams, type CreateWebhookEnvelopeOptions, type DataDetailOptions, type DataQueryOptions, type DeletePartnerUserResponse, type Dimension, type FileResolutionRequest, type FileResolutionResponse, type FileResolutionTable, type Filter, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSCDUMP_WRITE_ANALYTICS_SCOPE, type Grain, type GscApiRange, type GscComparisonFilter, type GscRowQueryMeta, type GscRowQueryResponse, type GscSearchType, type GscdumpAnalysisParams, type GscdumpAnalysisPreset, type GscdumpAnalysisResponse, type GscdumpAnalysisSourcesResponse, type GscdumpAvailableSite, type GscdumpCanonicalMismatchRow, type GscdumpCanonicalMismatchesResponse, type GscdumpDataDetailResponse, type GscdumpDataResponse, type GscdumpDataRow, type GscdumpDateRangeParams, type GscdumpHealthResponse, type GscdumpIndexPercentResponse, type GscdumpIndexPercentSitemap, type GscdumpIndexPercentTrendPoint, type GscdumpIndexingDiagnosticsResponse, type GscdumpIndexingInspectRateLimited, type GscdumpIndexingInspectRequest, type GscdumpIndexingInspectResponse, type GscdumpIndexingInspectResult, type GscdumpIndexingResponse, type GscdumpIndexingTrendPoint, type GscdumpIndexingUrl, type GscdumpIndexingUrlStatus, type GscdumpIndexingUrlsResponse, type GscdumpInvisibleUrlRow, type GscdumpKeywordSparklinesParams, type GscdumpKeywordSparklinesResponse, type GscdumpMeta, type GscdumpOrphanPageRow, type GscdumpPerSitemapHistoryEntry, type GscdumpPermissionRecovery, type GscdumpQueryTrendParams, type GscdumpQueryTrendResponse, type GscdumpSiteRegistration, type GscdumpSiteReportResponse, type GscdumpSitemap, type GscdumpSitemapChangesResponse, type GscdumpSitemapHistory, type GscdumpSitemapsResponse, type GscdumpSyncJobItem, type GscdumpSyncJobStatus, type GscdumpSyncJobsQueueCounts, type GscdumpSyncJobsResponse, type GscdumpSyncProgressDateStatus, type GscdumpSyncProgressPhaseCounts, type GscdumpSyncProgressResponse, type GscdumpSyncProgressSite, type GscdumpSyncStatusResponse, type GscdumpTeamMemberRow, type GscdumpTeamRow, type GscdumpTopAssociationParams, type GscdumpTopAssociationResponse, type GscdumpTotals, type GscdumpUserMeResponse, type GscdumpUserRegistration, type GscdumpUserSettings, type GscdumpUserSite, type GscdumpUserStatus, type GscdumpUserTokenUpdate, type IndexingDiagnostics, type IndexingInspectRateLimit, type IndexingInspectRateLimited, type IndexingInspectRequest, type IndexingInspectResponse, type IndexingInspectResult, type IndexingIssue, type IndexingIssueSeverity, IndexingNextAction, IndexingStatus, type IndexingUrlRow, type IndexingUrlStatus, type IndexingUrlsParams, type IndexingUrlsResponse, type InspectionHistoryRecord, type InspectionHistoryResponse, type InspectionIndex, type InspectionRecordRaw, LifecycleError, LifecycleErrorCode, LifecycleProgress, LifecycleWebhookEnvelope, LifecycleWebhookEvent, type Metric, type PartnerClient, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite, type PartnerRealtimeEvent, type PartnerRealtimeEventType, type PartnerRealtimeMessage, type PartnerWebhookData, type PartnerWebhookHeaders, PropertyNextAction, PropertyStatus, QuerySourceMode, type RealtimeAuthFailedEvent, type RealtimeAuthRequiredMessage, type RealtimeConnectedMessage, type RealtimeEnrichmentCompleteEvent, type RealtimeErrorMessage, type RealtimeJobFailedEvent, type RealtimeNeedsReauthEvent, type RealtimePongMessage, type RealtimeSiteAddedEvent, type RealtimeSiteRemovedEvent, type RealtimeSubscribedMessage, type RealtimeSyncCompleteEvent, type RealtimeSyncFailedEvent, type RealtimeSyncJobCompleteEvent, type RealtimeSyncProgressEvent, type RealtimeSyncSiteCompleteEvent, type RegisterPartnerSiteParams, type RegisterPartnerUserParams, type ResolvedParquetFile, type ResolvedTable, type RollupEnvelope, type Row, type ScheduleState, type SearchAppearanceResponse, type SearchAppearanceRow, type SearchTypeOptions, type ServerTailDirective, type SiteListItem, type SitemapAddedRow, type SitemapChangesResponse, type SitemapHistoryRecord, type SitemapHistoryResponse, type SitemapIndex, SitemapNextAction, type SitemapRemovedRow, SitemapStatus, type SourceInfoOptions, type SourceInfoResponse, type TableName, type TableSchema, type TenantCtx, type UpdatePartnerUserTokensParams, VALID_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION, WEBHOOK_CONTRACT_VERSION_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, type WebhookEnvelope, type WebhookEventType, type WhoamiResponse, accountNextActions, accountStatuses, addPartnerTeamMemberSchema, 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, 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, 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 };
+export { AccountNextAction, AccountStatus, type AddPartnerTeamMemberParams, type AnalysisSourcesOptions, type AnalysisSourcesResponse, type AnalyticsClient, AnalyticsNextAction, AnalyticsStatus, type BackfillRange, type BackfillResponse, type BindPartnerSiteTeamParams, type BuilderState, type BulkRegisterPartnerSiteResult, type BulkRegisterPartnerSitesParams, type BulkRegisterPartnerSitesResponse, CANONICAL_WEBHOOK_EVENTS, type CanonicalWebhookEventType, type ColumnDef, type ColumnType, type CountriesResponse, type CountryRow, type CreatePartnerTeamParams, type CreateWebhookEnvelopeOptions, type DataDetailOptions, type DataQueryOptions, type DeletePartnerUserResponse, type Dimension, type FileResolutionRequest, type FileResolutionResponse, type FileResolutionTable, type Filter, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSCDUMP_WRITE_ANALYTICS_SCOPE, type Grain, type GscApiRange, type GscComparisonFilter, type GscRowQueryMeta, type GscRowQueryResponse, type GscSearchType, type GscdumpAnalysisParams, type GscdumpAnalysisPreset, type GscdumpAnalysisResponse, type GscdumpAnalysisSourcesResponse, type GscdumpAvailableSite, type GscdumpCanonicalMismatchRow, type GscdumpCanonicalMismatchesResponse, type GscdumpDataDetailResponse, type GscdumpDataResponse, type GscdumpDataRow, type GscdumpDateRangeParams, type GscdumpHealthResponse, type GscdumpIndexPercentResponse, type GscdumpIndexPercentSitemap, type GscdumpIndexPercentTrendPoint, type GscdumpIndexingDiagnosticsResponse, type GscdumpIndexingInspectRateLimited, type GscdumpIndexingInspectRequest, type GscdumpIndexingInspectResponse, type GscdumpIndexingInspectResult, type GscdumpIndexingIssueSeverity, type GscdumpIndexingResponse, type GscdumpIndexingTrendPoint, type GscdumpIndexingUrl, type GscdumpIndexingUrlStatus, type GscdumpIndexingUrlsResponse, type GscdumpInvisibleUrlRow, type GscdumpKeywordSparklinesParams, type GscdumpKeywordSparklinesResponse, type GscdumpMeta, type GscdumpOrphanPageRow, type GscdumpPageTrendParams, type GscdumpPageTrendResponse, type GscdumpPerSitemapHistoryEntry, type GscdumpPermissionRecovery, type GscdumpQueryTrendParams, type GscdumpQueryTrendResponse, type GscdumpRichResultItem, type GscdumpSiteRegistration, type GscdumpSiteReportResponse, type GscdumpSitemap, type GscdumpSitemapChangesResponse, type GscdumpSitemapHistory, type GscdumpSitemapsResponse, type GscdumpSyncJobItem, type GscdumpSyncJobStatus, type GscdumpSyncJobsQueueCounts, type GscdumpSyncJobsResponse, type GscdumpSyncProgressDateStatus, type GscdumpSyncProgressPhaseCounts, type GscdumpSyncProgressResponse, type GscdumpSyncProgressSite, type GscdumpSyncStatusResponse, type GscdumpTeamMemberRow, type GscdumpTeamRow, type GscdumpTopAssociationParams, type GscdumpTopAssociationResponse, type GscdumpTotals, type GscdumpUserMeResponse, type GscdumpUserRegistration, type GscdumpUserSettings, type GscdumpUserSite, type GscdumpUserStatus, type GscdumpUserTokenUpdate, type IndexingDiagnostics, type IndexingInspectRateLimit, type IndexingInspectRateLimited, type IndexingInspectRequest, type IndexingInspectResponse, type IndexingInspectResult, type IndexingIssue, type IndexingIssueSeverity, IndexingNextAction, IndexingStatus, type IndexingUrlRow, type IndexingUrlStatus, type IndexingUrlsParams, type IndexingUrlsResponse, type InspectionHistoryRecord, type InspectionHistoryResponse, type InspectionIndex, type InspectionRecordRaw, LifecycleError, LifecycleErrorCode, LifecycleProgress, LifecycleWebhookEnvelope, LifecycleWebhookEvent, type Metric, type PartnerClient, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite, type PartnerRealtimeEvent, type PartnerRealtimeEventType, type PartnerRealtimeMessage, type PartnerWebhookData, type PartnerWebhookHeaders, PropertyNextAction, PropertyStatus, QuerySourceMode, type RealtimeAuthFailedEvent, type RealtimeAuthRequiredMessage, type RealtimeConnectedMessage, type RealtimeEnrichmentCompleteEvent, type RealtimeErrorMessage, type RealtimeJobFailedEvent, type RealtimeNeedsReauthEvent, type RealtimePongMessage, type RealtimeSiteAddedEvent, type RealtimeSiteRemovedEvent, type RealtimeSubscribedMessage, type RealtimeSyncCompleteEvent, type RealtimeSyncFailedEvent, type RealtimeSyncJobCompleteEvent, type RealtimeSyncProgressEvent, type RealtimeSyncSiteCompleteEvent, type RegisterPartnerSiteParams, type RegisterPartnerUserParams, type ResolvedParquetFile, type ResolvedTable, type RollupEnvelope, type Row, type ScheduleState, type SearchAppearanceResponse, type SearchAppearanceRow, type SearchTypeOptions, type ServerTailDirective, type SiteListItem, type SitemapAddedRow, type SitemapChangesResponse, type SitemapHistoryRecord, type SitemapHistoryResponse, type SitemapIndex, SitemapNextAction, type SitemapRemovedRow, SitemapStatus, type SourceInfoOptions, type SourceInfoResponse, type TableName, type TableSchema, type TenantCtx, type UpdatePartnerUserTokensParams, VALID_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION, WEBHOOK_CONTRACT_VERSION_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, type WebhookEnvelope, type WebhookEventType, type WhoamiResponse, accountNextActions, accountStatuses, addPartnerTeamMemberSchema, 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, 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 };

package/dist/index.mjs

@@ -163,6 +163,7 @@ const partnerRoutes = {
 		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`,
@@ -781,17 +782,44 @@ const gscdumpAnalysisResponseSchema = z.object({
 	meta: gscdumpMetaSchema
 }).loose();
 const gscdumpSitemapsResponseSchema = z.object({
-	sitemaps: z.array(unknownRecord),
-	history: z.array(unknownRecord),
-	perSitemapHistory: z.record(z.string(), z.array(unknownRecord)),
+	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(unknownRecord),
-	removed: z.array(unknownRecord),
+	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(),
@@ -1103,6 +1131,25 @@ const gscdumpQueryTrendResponseSchema = z.object({
 		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()
@@ -1429,6 +1476,10 @@ const partnerEndpointSchemas = {
 		query: gscdumpQueryTrendParamsSchema,
 		response: gscdumpQueryTrendResponseSchema
 	},
+	getPageTrend: {
+		query: gscdumpPageTrendParamsSchema,
+		response: gscdumpPageTrendResponseSchema
+	},
 	getDateRangeInsight: {
 		query: gscdumpDateRangeParamsSchema,
 		response: unknownRecord
@@ -1458,4 +1509,4 @@ const partnerEndpointSchemas = {
 	realtimeEvent: { message: partnerRealtimeEventSchema },
 	webhook: { message: partnerWebhookEnvelopeSchema }
 };
-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, 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, 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, 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 };
+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, 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, 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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/contracts",
   "type": "module",
-  "version": "0.25.1",
+  "version": "0.25.3",
   "description": "Shared gscdump.com API, webhook, realtime, and lifecycle contracts.",
   "author": {
     "name": "Harlan Wilton",