@gscdump/sdk 0.39.0 → 0.40.2

package/README.md

@@ -3,10 +3,9 @@
 Consumer SDK for hosted gscdump.com integrations.
 
 > The descriptor-driven HTTP client and ticketed realtime state machine are
-> exported from `@gscdump/sdk/v1`. Existing root HTTP/realtime clients remain
-> legacy compatibility surfaces during the release and cutover overlap; the
-> legacy socket client still sends a long-lived key in its first frame and must
-> not be used for a v1 browser integration. See the
+> exported from `@gscdump/sdk/v1`. The root HTTP client remains a temporary
+> compatibility surface during the release and cutover overlap; the unsafe
+> long-lived-key realtime client was removed before v1. See the
 > [v1 contract](../../docs/hosted-api-v1.md).
 
 This package is for partner applications that consume gscdump.com APIs,
@@ -14,9 +13,9 @@ webhooks, and realtime events. Callers inject the HTTP transport and auth they
 want to use; route construction stays inside the hosted adapter.
 
 ```ts
-import { createGscdumpClient } from '@gscdump/sdk'
+import { createPartnerClient } from '@gscdump/sdk'
 
-const gscdump = createGscdumpClient({
+const gscdump = createPartnerClient({
   apiBase: 'https://example.com/api',
   apiKey: process.env.GSCDUMP_API_KEY,
   fetch: $fetch,

package/dist/_chunks/query.d.mts

@@ -1,2 +1,2 @@
 import * as import_gscdump_query from "gscdump/query";
-export { import_gscdump_query as query_d_exports };
+export { __exportAll, __reExport, query_d_exports };

package/dist/index.d.mts

@@ -1,6 +1,7 @@
-import { query_d_exports } from "./_chunks/query.mjs";
+import { __exportAll, __reExport, query_d_exports } from "./_chunks/query.mjs";
 import { Result } from "gscdump/result";
-import { AddPartnerTeamMemberParams, AnalyticsClient, AnalyticsClient as AnalyticsClient$1, BackfillRange, BackfillResponse, BindPartnerSiteTeamParams, BuilderState, BulkRegisterPartnerSiteResult, BulkRegisterPartnerSitesParams, BulkRegisterPartnerSitesResponse, CANONICAL_WEBHOOK_EVENTS, CanonicalWebhookEventType, CreatePartnerTeamParams, CreateWebhookEnvelopeOptions, DataDetailOptions, DataQueryOptions, DeletePartnerUserResponse, GscComparisonFilter, GscdumpAnalysisParams, GscdumpAnalysisPreset, GscdumpAnalysisResponse, GscdumpAnalysisSourcesResponse, GscdumpAvailableSite, GscdumpCanonicalMismatchesResponse, GscdumpDataDetailResponse, GscdumpDataResponse, GscdumpDataRow, GscdumpDateRangeParams, GscdumpIndexPercentResponse, GscdumpIndexingDiagnosticsResponse, GscdumpIndexingResponse, GscdumpIndexingUrlStatus, GscdumpIndexingUrlsResponse, GscdumpKeywordSparklinesParams, GscdumpKeywordSparklinesResponse, GscdumpMeta, GscdumpPageTrendParams, GscdumpPageTrendResponse, GscdumpPermissionRecovery, GscdumpQueryTrendParams, GscdumpQueryTrendResponse, GscdumpSiteRegistration, GscdumpSitemap, GscdumpSitemapChangesResponse, GscdumpSitemapHistory, GscdumpSitemapsResponse, GscdumpSyncStatusResponse, GscdumpSyncStatusResponse as GscdumpSyncStatusResponse$1, GscdumpTeamMemberRow, GscdumpTeamRow, GscdumpTopAssociationParams, GscdumpTopAssociationResponse, GscdumpTotals, GscdumpUserRegistration, GscdumpUserSettings, GscdumpUserSite, GscdumpUserSite as GscdumpUserSite$1, GscdumpUserStatus, GscdumpUserTokenUpdate, IndexingDiagnosticsParams, IndexingUrlsParams, InspectionHistoryResponse, InspectionIndex, PartnerClient, PartnerClient as PartnerClient$1, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleResponse as PartnerLifecycleResponse$1, PartnerLifecycleSite, PartnerLifecycleSite as PartnerLifecycleSite$1, PartnerRealtimeEvent, PartnerRealtimeEvent as PartnerRealtimeEvent$1, PartnerRealtimeEventType, PartnerRealtimeMessage, PartnerRealtimeMessage as PartnerRealtimeMessage$1, PartnerWebhookData, PartnerWebhookHeaders, PartnerWebhookHeaders as PartnerWebhookHeaders$1, RealtimeAuthFailedEvent, RealtimeAuthRequiredMessage, RealtimeConnectedMessage, RealtimeEnrichmentCompleteEvent, RealtimeErrorMessage, RealtimeJobFailedEvent, RealtimeNeedsReauthEvent, RealtimePongMessage, RealtimeSiteAddedEvent, RealtimeSiteRemovedEvent, RealtimeSubscribedMessage, RealtimeSyncCompleteEvent, RealtimeSyncFailedEvent, RealtimeSyncJobCompleteEvent, RealtimeSyncProgressEvent, RealtimeSyncSiteCompleteEvent, RegisterPartnerSiteParams, RegisterPartnerUserParams, RollupEnvelope, UpdatePartnerUserTokensParams, VALID_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION, WEBHOOK_CONTRACT_VERSION_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, WebhookEnvelope, WebhookEnvelope as WebhookEnvelope$1, WebhookEventType, WhoamiResponse } from "@gscdump/contracts";
+import { arbitrarySql as arbitrarySql$1, auxCloudOnly as auxCloudOnly$1, entityDailySparkline as entityDailySparkline$1, entityDailyTimeseries as entityDailyTimeseries$1, multiSeriesStackedDaily as multiSeriesStackedDaily$1, singleRowLookup as singleRowLookup$1, siteDailyTimeseries as siteDailyTimeseries$1, topNBreakdown as topNBreakdown$1, twoDimensionDetail as twoDimensionDetail$1 } from "@gscdump/contracts/archetypes";
+import { AddPartnerTeamMemberParams, AnalyticsClient, AnalyticsClient as AnalyticsClient$1, BackfillRange, BackfillResponse, BindPartnerSiteTeamParams, BuilderState, BulkRegisterPartnerSiteResult, BulkRegisterPartnerSitesParams, BulkRegisterPartnerSitesResponse, CANONICAL_WEBHOOK_EVENTS, CanonicalWebhookEventType, CreatePartnerTeamParams, CreateWebhookEnvelopeOptions, DataDetailOptions, DataQueryOptions, DeletePartnerUserResponse, GscComparisonFilter, GscdumpAnalysisParams, GscdumpAnalysisPreset, GscdumpAnalysisResponse, GscdumpAnalysisSourcesResponse, GscdumpAvailableSite, GscdumpCanonicalMismatchesResponse, GscdumpDataDetailResponse, GscdumpDataResponse, GscdumpDataRow, GscdumpDateRangeParams, GscdumpIndexPercentResponse, GscdumpIndexingDiagnosticsResponse, GscdumpIndexingResponse, GscdumpIndexingUrlStatus, GscdumpIndexingUrlsResponse, GscdumpKeywordSparklinesParams, GscdumpKeywordSparklinesResponse, GscdumpMeta, GscdumpPageTrendParams, GscdumpPageTrendResponse, GscdumpPermissionRecovery, GscdumpQueryTrendParams, GscdumpQueryTrendResponse, GscdumpSiteRegistration, GscdumpSitemap, GscdumpSitemapChangesResponse, GscdumpSitemapHistory, GscdumpSitemapsResponse, GscdumpSyncStatusResponse, GscdumpSyncStatusResponse as GscdumpSyncStatusResponse$1, GscdumpTeamMemberRow, GscdumpTeamRow, GscdumpTopAssociationParams, GscdumpTopAssociationResponse, GscdumpTotals, GscdumpUserRegistration, GscdumpUserSettings, GscdumpUserSite, GscdumpUserSite as GscdumpUserSite$1, GscdumpUserStatus, GscdumpUserTokenUpdate, IndexingDiagnosticsParams, IndexingUrlsParams, InspectionHistoryResponse, InspectionIndex, PartnerClient, PartnerClient as PartnerClient$1, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite, PartnerLifecycleSite as PartnerLifecycleSite$1, PartnerWebhookData, PartnerWebhookHeaders, PartnerWebhookHeaders as PartnerWebhookHeaders$1, RegisterPartnerSiteParams, RegisterPartnerUserParams, RollupEnvelope, SourceInfoOptions, UpdatePartnerUserTokensParams, VALID_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION, WEBHOOK_CONTRACT_VERSION_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, WebhookEnvelope, WebhookEnvelope as WebhookEnvelope$1, WebhookEventType, WhoamiResponse } from "@gscdump/contracts";
 import { ZodTypeAny } from "zod";
 import { ActionSource } from "@gscdump/analysis";
 import { AnalysisTool } from "@gscdump/engine/analysis-types";
@@ -136,7 +137,20 @@ interface DailyAnonInput {
   anonymizedImpressionsPct: number;
 }
 declare function weightedAnonPct(days: readonly DailyAnonInput[] | null | undefined, window?: number): number | null;
+declare namespace archetypes_d_exports {
+  export { ARCHETYPE_EXECUTION_CLASS, arbitrarySql, auxCloudOnly, entityDailySparkline, entityDailyTimeseries, multiSeriesStackedDaily, singleRowLookup, siteDailyTimeseries, topNBreakdown, twoDimensionDetail };
+}
 import * as import__gscdump_contracts_archetypes from "@gscdump/contracts/archetypes";
+declare const ARCHETYPE_EXECUTION_CLASS: Record<import("@gscdump/contracts").QueryArchetype, import("@gscdump/contracts").ArchetypeExecutionClass>;
+declare const arbitrarySql: typeof arbitrarySql$1;
+declare const auxCloudOnly: typeof auxCloudOnly$1;
+declare const entityDailySparkline: typeof entityDailySparkline$1;
+declare const entityDailyTimeseries: typeof entityDailyTimeseries$1;
+declare const multiSeriesStackedDaily: typeof multiSeriesStackedDaily$1;
+declare const singleRowLookup: typeof singleRowLookup$1;
+declare const siteDailyTimeseries: typeof siteDailyTimeseries$1;
+declare const topNBreakdown: typeof topNBreakdown$1;
+declare const twoDimensionDetail: typeof twoDimensionDetail$1;
 type PartnerFetch = HostedFetch;
 type PartnerHeaders = HostedHeaders;
 type PartnerFetchOptions = HostedFetchOptions;
@@ -156,7 +170,6 @@ interface PartnerClientOptions extends HostedClientOptions {
   validate?: boolean | 'request' | 'response';
 }
 declare function createPartnerClient(options?: PartnerClientOptions): PartnerClient$1;
-declare const createGscdumpClient: typeof createPartnerClient;
 declare const COUNTRY_NAMES: Record<string, string>;
 declare const countryName: (code: string) => string;
 declare const CWV_GOOD_LCP = 2500;
@@ -213,7 +226,7 @@ interface GscClassifiedError {
   code?: number;
   /** Best-effort human message: server-supplied `message`, then `data.message`, then the error's own message. */
   message?: string;
-  /** Seconds the server suggested waiting (429 with `retryAfter` payload). */
+  /** Seconds the server suggested waiting (429/503 retry payloads). */
   retryAfter?: number;
 }
 declare function classifyGscError(e: unknown): GscClassifiedError;
@@ -246,6 +259,14 @@ interface DateRangeResult {
   yearEnd: string;
   days: number;
 }
+interface PeriodOptions {
+  /** Subtract GSC's stable-data latency from `end`. Default `true`. */
+  stableData?: boolean;
+  /** IANA timezone used to resolve today's calendar date. Default GSC/Pacific time. */
+  timezone?: string;
+  /** Clock used to resolve today's calendar date. Defaults to the current time. */
+  now?: Date;
+}
 declare function isCustomPeriod(p: Period | string): p is CustomPeriod;
 declare function parseCustomPeriod(p: Period | string): {
   start: string;
@@ -253,8 +274,8 @@ declare function parseCustomPeriod(p: Period | string): {
   prevStart?: string;
   prevEnd?: string;
 } | null;
-declare function periodToDateRange(period: Period | string, stableData?: boolean): DateRangeResult;
-declare function periodToDays(period: Period | string): number;
+declare function periodToDateRange(period: Period | string, stableDataOrOptions?: boolean | PeriodOptions): DateRangeResult;
+declare function periodToDays(period: Period | string, stableDataOrOptions?: boolean | PeriodOptions): number;
 declare function compareRange(range: DateRangeResult, mode: CompareMode): {
   start: string;
   end: string;
@@ -349,6 +370,29 @@ declare function positionFor(r: {
   impressions: number;
   sum_position: number;
 }): number;
+type GscSearchType = 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
+interface SearchTypeOptions {
+  searchType?: GscSearchType;
+}
+interface SourceRangeOptions {
+  start?: string;
+  end?: string;
+  startDate?: string;
+  endDate?: string;
+}
+interface AnalysisSourcesOptions extends SearchTypeOptions, SourceRangeOptions {
+  tables?: string[] | string;
+  maxBytes?: number;
+  maxRows?: number;
+  maxFiles?: number;
+}
+declare const DEFAULT_SEARCH_TYPE: GscSearchType;
+declare function withDefaultSearchType<T extends object>(value: T, searchType?: GscSearchType): T & SearchTypeOptions;
+declare function withDefaultSearchType<T>(value: T, searchType?: GscSearchType): T;
+declare function searchTypeQuery(searchType?: GscSearchType): Record<string, string>;
+declare function dateRangeOptionsQuery(options: SourceRangeOptions | undefined): Record<string, string>;
+declare function sourceInfoQuery(options: SourceInfoOptions | undefined): Record<string, string>;
+declare function tablesQuery(tablesOrOptions: string[] | string | AnalysisSourcesOptions | undefined, options?: AnalysisSourcesOptions): Record<string, string>;
 interface IndexingIssueDetail {
   description: string;
   fix: string;
@@ -403,83 +447,18 @@ declare const issueTypeToGroup: Record<string, string>;
 declare function enrichIssueDetails(modules?: {
   name: string;
 }[]): Record<string, IndexingIssueDetail>;
-declare function analyticsStatusToSyncStatus(status: PartnerLifecycleSite$1['analytics']['status']): GscdumpUserSite$1['syncStatus'];
-declare function lifecycleSiteToUserSite(site: PartnerLifecycleSite$1): GscdumpUserSite$1;
-declare function lifecycleSiteToSyncStatus(site: PartnerLifecycleSite$1): GscdumpSyncStatusResponse$1;
-declare function findLifecycleSite(lifecycle: PartnerLifecycleResponse$1, siteIdOrPropertyUrl: string): PartnerLifecycleSite$1 | null;
-type PartnerRealtimeScope = 'partner' | 'user';
-type PartnerRealtimeStatus = 'idle' | 'connecting' | 'open' | 'authenticated' | 'closed' | 'error';
-type PartnerRealtimeHandler<T> = (value: T) => void;
-interface PartnerWebSocketLike {
-  readyState: number;
-  onopen: ((event: unknown) => void) | null;
-  onmessage: ((event: {
-    data: unknown;
-  }) => void) | null;
-  onerror: ((event: unknown) => void) | null;
-  onclose: ((event: unknown) => void) | null;
-  send: (data: string) => void;
-  close: (code?: number, reason?: string) => void;
-}
-interface PartnerWebSocketConstructor {
-  new (url: string, protocols?: string | string[]): PartnerWebSocketLike;
-}
-interface PartnerRealtimeReconnectOptions {
-  /** Default `true`. Set `false` to disable automatic reconnection entirely. */
-  enabled?: boolean;
-  /** First-retry delay in ms; doubles each attempt. Default `1000`. */
-  baseDelayMs?: number;
-  /** Upper bound on the backoff delay in ms. Default `30000`. */
-  maxDelayMs?: number;
-  /** Stop after this many consecutive failed attempts. Default `Infinity`. */
-  maxRetries?: number;
-  /** Apply equal-jitter to each delay so many clients don't reconnect in lockstep. Default `true`. */
-  jitter?: boolean;
-}
-interface PartnerRealtimeOptions {
-  /**
-   * HTTP API base used only to derive a same-origin websocket base when `wsBase`
-   * is omitted. Prefer passing `wsBase` when the websocket origin differs.
-   */
-  apiBase?: string;
-  /** WebSocket origin base, for example `wss://origin.example`. */
-  wsBase?: string;
-  /** Partner or user API key sent in the first auth message. */
-  apiKey: string;
-  /** `/ws/partner` or `/ws/user`. User scope supports partner key + user id. */
-  scope?: PartnerRealtimeScope;
-  /** Required by the hosted `/ws/user` route when authenticating with a partner API key. */
-  userId?: number | string;
-  /** Optional initial site filter sent after authentication succeeds. */
-  siteIds?: string[];
-  protocols?: string | string[];
-  WebSocket?: PartnerWebSocketConstructor;
-  /**
-   * Automatic reconnection on unexpected close (network drop, server restart).
-   * A raw WebSocket `error` Event carries no actionable detail, so rather than
-   * surfacing it the client transparently reconnects with exponential backoff.
-   * `true` (default) uses defaults; pass an object to tune; `false` disables.
-   * The backoff counter resets once a reconnection reaches `authenticated`.
-   */
-  reconnect?: boolean | PartnerRealtimeReconnectOptions;
-  /** Injected timer hooks (for tests). Defaults to global `setTimeout`/`clearTimeout`. */
-  setTimeout?: (handler: () => void, ms: number) => unknown;
-  clearTimeout?: (handle: unknown) => void;
-}
-interface PartnerRealtimeClient {
-  readonly status: PartnerRealtimeStatus;
-  readonly socket: PartnerWebSocketLike | null;
-  connect: () => PartnerWebSocketLike;
-  close: (code?: number, reason?: string) => void;
-  ping: () => void;
-  subscribe: (siteIds: string[]) => void;
-  onStatus: (handler: PartnerRealtimeHandler<PartnerRealtimeStatus>) => () => void;
-  onMessage: (handler: PartnerRealtimeHandler<PartnerRealtimeMessage$1>) => () => void;
-  onEvent: (handler: PartnerRealtimeHandler<PartnerRealtimeEvent$1>) => () => void;
-  onError: (handler: PartnerRealtimeHandler<unknown>) => () => void;
-}
-declare function createPartnerRealtimeClient(options: PartnerRealtimeOptions): PartnerRealtimeClient;
-declare const createGscdumpRealtimeClient: typeof createPartnerRealtimeClient;
+/**
+ * Stable lifecycle fields shared by the legacy partner response and public v1.
+ * Keeping the adapters structural lets consumers migrate to v1 without
+ * re-introducing legacy-only fields such as `intId` or `lifecycleRevision`.
+ */
+type LifecycleSiteLike = Pick<PartnerLifecycleSite$1, 'siteId' | 'externalSiteId' | 'requestedUrl' | 'gscPropertyUrl' | 'permissionLevel' | 'analytics' | 'indexing' | 'latestError' | 'updatedAt'>;
+declare function analyticsStatusToSyncStatus(status: LifecycleSiteLike['analytics']['status']): GscdumpUserSite$1['syncStatus'];
+declare function lifecycleSiteToUserSite(site: LifecycleSiteLike): GscdumpUserSite$1;
+declare function lifecycleSiteToSyncStatus(site: LifecycleSiteLike): GscdumpSyncStatusResponse$1;
+declare function findLifecycleSite<TSite extends LifecycleSiteLike>(lifecycle: {
+  sites: readonly TSite[];
+}, siteIdOrPropertyUrl: string): TSite | null;
 type SearchConsoleStageKey = 'not_connected' | 'waiting_for_data' | 'weak_discovery' | 'discovery_backlog' | 'crawl_blocked' | 'indexability_blocked' | 'index_rejection' | 'partially_indexed' | 'indexed_invisible' | 'visible_not_clicked' | 'ranking_stalled' | 'declining_visibility' | 'healthy_growth_ready';
 type SearchConsoleStageSeverity = 'success' | 'error' | 'warning' | 'info' | 'neutral';
 interface SearchConsoleStageEvidence {
@@ -754,7 +733,6 @@ declare function parseWebhookPayload<TData extends Record<string, unknown> = Rec
   validateSignature?: boolean;
 }): Promise<WebhookEnvelope$1<TData>>;
 declare function readWebhookHeaders(headers: Headers | PartnerWebhookHeaders$1 | null | undefined): Required<PartnerWebhookHeaders$1>;
-type ARCHETYPE_EXECUTION_CLASS = import__gscdump_contracts_archetypes.ARCHETYPE_EXECUTION_CLASS;
 type ArbitrarySqlQuery = import__gscdump_contracts_archetypes.ArbitrarySqlQuery;
 type ArchetypeExecutionClass = import__gscdump_contracts_archetypes.ArchetypeExecutionClass;
 type ArchetypeFacet = import__gscdump_contracts_archetypes.ArchetypeFacet;
@@ -774,4 +752,5 @@ type SingleRowLookupQuery = import__gscdump_contracts_archetypes.SingleRowLookup
 type SiteDailyTimeseriesQuery = import__gscdump_contracts_archetypes.SiteDailyTimeseriesQuery;
 type TopNBreakdownQuery = import__gscdump_contracts_archetypes.TopNBreakdownQuery;
 type TwoDimensionDetailQuery = import__gscdump_contracts_archetypes.TwoDimensionDetailQuery;
-export { ARCHETYPE_EXECUTION_CLASS, type AddPartnerTeamMemberParams, type AnalyticsClient, type AnalyticsClientOptions, type AnalyticsFetch, type AnalyticsFetchOptions, type AnalyticsHeaders, type ArbitrarySqlQuery, type ArchetypeExecutionClass, type ArchetypeFacet, type ArchetypeQuery, type ArchetypeQueryBase, type ArchetypeResult, type ArchetypeResultRow, type ArchetypeResultSource, type AuxCloudOnlyQuery, type BackfillRange, type BackfillResponse, type BindPartnerSiteTeamParams, type BuilderState, type BulkRegisterPartnerSiteResult, type BulkRegisterPartnerSitesParams, type BulkRegisterPartnerSitesResponse, CANONICAL_WEBHOOK_EVENTS, COMPARE_OPTIONS, COUNTRY_NAMES, CWV_GOOD_CLS, CWV_GOOD_INP, CWV_GOOD_LCP, CWV_POOR_CLS, CWV_POOR_INP, CWV_POOR_LCP, type CalendarPeriod, type CanonicalDailyRow, type CanonicalWebhookEventType, type ClassifySearchConsoleStageInput, type CompareMode, type CreatePartnerTeamParams, type CreateWebhookEnvelopeOptions, type CustomPeriod, type CwvBucket, type DailyAnonInput, type DataDetailOptions, type DataQueryOptions, type DateRange, type DateRangeResult, type DeletePartnerUserResponse, type EntityDailySparklineQuery, type EntityDailyTimeseriesQuery, GSC_COLUMN_OPTIONS, GSC_PERIOD_OPTIONS, GSC_PERIOD_OPTIONS_LONG, GSC_STABLE_LATENCY_DAYS, type GscAnalyzerAccent, type GscAnalyzerCapabilities, type GscAnalyzerCapability, type GscAnalyzerDefinition, type GscAnalyzerDefinitionWithCapability, type GscAnalyzerInsightCard, type GscAnalyzerKind, type GscAnalyzerPanelResult, type GscAnalyzerPanelSpec, type GscAnalyzerStatTile, type GscClassifiedError, type GscColumn, type GscColumnOption, type GscComparisonFilter, type GscConsoleUrlOpts, type GscDailySummary, type GscErrorStatus, type GscRowTotals, type GscdumpAnalysisParams, type GscdumpAnalysisPreset, type GscdumpAnalysisResponse, type GscdumpAnalysisSourcesResponse, type GscdumpAvailableSite, type GscdumpCanonicalMismatchesResponse, type GscdumpDataDetailResponse, type GscdumpDataResponse, type GscdumpDataRow, type GscdumpDateRangeParams, type GscdumpIndexPercentResponse, type GscdumpIndexingDiagnosticsResponse, type GscdumpIndexingResponse, type GscdumpIndexingUrlStatus, type GscdumpIndexingUrlsResponse, type GscdumpKeywordSparklinesParams, type GscdumpKeywordSparklinesResponse, type GscdumpMeta, type GscdumpPageTrendParams, type GscdumpPageTrendResponse, type GscdumpPermissionRecovery, type GscdumpQueryTrendParams, type GscdumpQueryTrendResponse, type GscdumpSiteRegistration, type GscdumpSitemap, type GscdumpSitemapChangesResponse, type GscdumpSitemapHistory, type GscdumpSitemapsResponse, type GscdumpSyncStatusResponse, type GscdumpTeamMemberRow, type GscdumpTeamRow, type GscdumpTopAssociationParams, type GscdumpTopAssociationResponse, type GscdumpTotals, type GscdumpUserRegistration, type GscdumpUserSettings, type GscdumpUserSite, type GscdumpUserStatus, type GscdumpUserTokenUpdate, type HealthStage, type HealthVerdict, type IndexingDiagnosticsParams, type IndexingIssue, type IndexingIssueDetail, type IndexingUrlsParams, type InspectionHistoryResponse, type InspectionIndex, type IssueGroup, type IssueSeverity, type MultiSeriesStackedDailyQuery, PERIOD_PRESETS, PartnerApiError, type PartnerClient, type PartnerClientOptions, type PartnerErrorInfo, type PartnerErrorKind, type PartnerFetch, type PartnerFetchOptions, type PartnerHeaders, type PartnerLifecycleAccount, type PartnerLifecycleResponse, type PartnerLifecycleSite, type PartnerRealtimeClient, type PartnerRealtimeEvent, type PartnerRealtimeEventType, type PartnerRealtimeHandler, type PartnerRealtimeMessage, type PartnerRealtimeOptions, type PartnerRealtimeScope, type PartnerRealtimeStatus, type PartnerWebSocketConstructor, type PartnerWebSocketLike, type PartnerWebhookData, type PartnerWebhookHeaders, type PeerBaselineInput, type PeerConfidence, type PeerStanding, type Period, type PeriodPreset, type QueryArchetype, type RawDailyRow, type ReachStage, type ReachVerdict, 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 ResolvedArchetypeQuery, type RollingPeriod, type RollupEnvelope, SITE_TYPE_BASELINE, type SearchConsoleStage, type SearchConsoleStageEvidence, type SearchConsoleStageIssue, type SearchConsoleStageKey, type SearchConsoleStagePage, type SearchConsoleStageSeverity, type SearchConsoleStageSitemap, type SearchConsoleStageSummary, type SearchConsoleStageTrajectory, type SingleRowLookupQuery, type SiteBaseline, type SiteDailyTimeseriesQuery, type SiteTriage, type SiteTriageInput, type SiteType, type SiteTypeBaseline, type TopNBreakdownQuery, type TriageEvidence, type TwoDimensionDetailQuery, 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, analyticsStatusToSyncStatus, andFilter, classifyGscError, classifyHealthStage, classifyReachStage, classifySearchConsoleStage, classifySiteTriage, coerceRowMetrics, compareRange, countryName, coverageLabel, coverageLabels, createAnalyticsClient, createGscdumpClient, createGscdumpRealtimeClient, createPartnerClient, createPartnerRealtimeClient, cwvBucket, dateFilter, defineGscAnalyzer, derivePeerStanding, deriveSiteBaseline, enrichIssueDetails, findLifecycleSite, formatPartnerError, getGscUnstableCutoffDate, gscConsoleUrl, investigationStatusConfig, isCustomPeriod, isPartnerError, issueDetails, issueGroups, issueTypeToGroup, lifecycleSiteToSyncStatus, lifecycleSiteToUserSite, normalizeSiteType, nuxtSeoTips, parseCustomPeriod, parseWebhookPayload, parseWebhookPayloadResult, partnerErrorToException, periodToDateRange, periodToDays, positionFor, reachLivenessRatio, readWebhookHeaders, serializeWebhookPayload, severityOrder, siteTypeBaseline, siteUrlToHostname, splitOpportunityTitle, summarizeDailyRows, toPartnerError, truncateQuery, verifyWebhookSignature, weightedAnonPct };
+type WireDateRange = import__gscdump_contracts_archetypes.WireDateRange;
+export { ARCHETYPE_EXECUTION_CLASS, type AddPartnerTeamMemberParams, type AnalysisSourcesOptions, type AnalyticsClient, type AnalyticsClientOptions, type AnalyticsFetch, type AnalyticsFetchOptions, type AnalyticsHeaders, type ArbitrarySqlQuery, type ArchetypeExecutionClass, type ArchetypeFacet, type ArchetypeQuery, type ArchetypeQueryBase, type ArchetypeResult, type ArchetypeResultRow, type ArchetypeResultSource, type AuxCloudOnlyQuery, type BackfillRange, type BackfillResponse, type BindPartnerSiteTeamParams, type BuilderState, type BulkRegisterPartnerSiteResult, type BulkRegisterPartnerSitesParams, type BulkRegisterPartnerSitesResponse, CANONICAL_WEBHOOK_EVENTS, COMPARE_OPTIONS, COUNTRY_NAMES, CWV_GOOD_CLS, CWV_GOOD_INP, CWV_GOOD_LCP, CWV_POOR_CLS, CWV_POOR_INP, CWV_POOR_LCP, type CalendarPeriod, type CanonicalDailyRow, type CanonicalWebhookEventType, type ClassifySearchConsoleStageInput, type CompareMode, type CreatePartnerTeamParams, type CreateWebhookEnvelopeOptions, type CustomPeriod, type CwvBucket, DEFAULT_SEARCH_TYPE, type DailyAnonInput, type DataDetailOptions, type DataQueryOptions, type DateRange, type DateRangeResult, type DeletePartnerUserResponse, type EntityDailySparklineQuery, type EntityDailyTimeseriesQuery, GSC_COLUMN_OPTIONS, GSC_PERIOD_OPTIONS, GSC_PERIOD_OPTIONS_LONG, GSC_STABLE_LATENCY_DAYS, type GscAnalyzerAccent, type GscAnalyzerCapabilities, type GscAnalyzerCapability, type GscAnalyzerDefinition, type GscAnalyzerDefinitionWithCapability, type GscAnalyzerInsightCard, type GscAnalyzerKind, type GscAnalyzerPanelResult, type GscAnalyzerPanelSpec, type GscAnalyzerStatTile, type GscClassifiedError, type GscColumn, type GscColumnOption, type GscComparisonFilter, type GscConsoleUrlOpts, type GscDailySummary, type GscErrorStatus, type GscRowTotals, type GscdumpAnalysisParams, type GscdumpAnalysisPreset, type GscdumpAnalysisResponse, type GscdumpAnalysisSourcesResponse, type GscdumpAvailableSite, type GscdumpCanonicalMismatchesResponse, type GscdumpDataDetailResponse, type GscdumpDataResponse, type GscdumpDataRow, type GscdumpDateRangeParams, type GscdumpIndexPercentResponse, type GscdumpIndexingDiagnosticsResponse, type GscdumpIndexingResponse, type GscdumpIndexingUrlStatus, type GscdumpIndexingUrlsResponse, type GscdumpKeywordSparklinesParams, type GscdumpKeywordSparklinesResponse, type GscdumpMeta, type GscdumpPageTrendParams, type GscdumpPageTrendResponse, type GscdumpPermissionRecovery, type GscdumpQueryTrendParams, type GscdumpQueryTrendResponse, type GscdumpSiteRegistration, type GscdumpSitemap, type GscdumpSitemapChangesResponse, type GscdumpSitemapHistory, type GscdumpSitemapsResponse, type GscdumpSyncStatusResponse, type GscdumpTeamMemberRow, type GscdumpTeamRow, type GscdumpTopAssociationParams, type GscdumpTopAssociationResponse, type GscdumpTotals, type GscdumpUserRegistration, type GscdumpUserSettings, type GscdumpUserSite, type GscdumpUserStatus, type GscdumpUserTokenUpdate, type HealthStage, type HealthVerdict, type IndexingDiagnosticsParams, type IndexingIssue, type IndexingIssueDetail, type IndexingUrlsParams, type InspectionHistoryResponse, type InspectionIndex, type IssueGroup, type IssueSeverity, type LifecycleSiteLike, type MultiSeriesStackedDailyQuery, PERIOD_PRESETS, PartnerApiError, type PartnerClient, type PartnerClientOptions, type PartnerErrorInfo, type PartnerErrorKind, type PartnerFetch, type PartnerFetchOptions, type PartnerHeaders, type PartnerLifecycleAccount, type PartnerLifecycleResponse, type PartnerLifecycleSite, type PartnerWebhookData, type PartnerWebhookHeaders, type PeerBaselineInput, type PeerConfidence, type PeerStanding, type Period, type PeriodOptions, type PeriodPreset, type QueryArchetype, type RawDailyRow, type ReachStage, type ReachVerdict, type RegisterPartnerSiteParams, type RegisterPartnerUserParams, type ResolvedArchetypeQuery, type RollingPeriod, type RollupEnvelope, SITE_TYPE_BASELINE, type SearchConsoleStage, type SearchConsoleStageEvidence, type SearchConsoleStageIssue, type SearchConsoleStageKey, type SearchConsoleStagePage, type SearchConsoleStageSeverity, type SearchConsoleStageSitemap, type SearchConsoleStageSummary, type SearchConsoleStageTrajectory, type SearchTypeOptions, type SingleRowLookupQuery, type SiteBaseline, type SiteDailyTimeseriesQuery, type SiteTriage, type SiteTriageInput, type SiteType, type SiteTypeBaseline, type SourceRangeOptions, type TopNBreakdownQuery, type TriageEvidence, type TwoDimensionDetailQuery, 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, type WireDateRange, analyticsStatusToSyncStatus, andFilter, arbitrarySql, auxCloudOnly, classifyGscError, classifyHealthStage, classifyReachStage, classifySearchConsoleStage, classifySiteTriage, coerceRowMetrics, compareRange, countryName, coverageLabel, coverageLabels, createAnalyticsClient, createPartnerClient, cwvBucket, dateFilter, dateRangeOptionsQuery, defineGscAnalyzer, derivePeerStanding, deriveSiteBaseline, enrichIssueDetails, entityDailySparkline, entityDailyTimeseries, findLifecycleSite, formatPartnerError, getGscUnstableCutoffDate, gscConsoleUrl, investigationStatusConfig, isCustomPeriod, isPartnerError, issueDetails, issueGroups, issueTypeToGroup, lifecycleSiteToSyncStatus, lifecycleSiteToUserSite, multiSeriesStackedDaily, normalizeSiteType, nuxtSeoTips, parseCustomPeriod, parseWebhookPayload, parseWebhookPayloadResult, partnerErrorToException, periodToDateRange, periodToDays, positionFor, reachLivenessRatio, readWebhookHeaders, searchTypeQuery, serializeWebhookPayload, severityOrder, singleRowLookup, siteDailyTimeseries, siteTypeBaseline, siteUrlToHostname, sourceInfoQuery, splitOpportunityTitle, summarizeDailyRows, tablesQuery, toPartnerError, topNBreakdown, truncateQuery, twoDimensionDetail, verifyWebhookSignature, weightedAnonPct, withDefaultSearchType };

package/dist/index.mjs

@@ -1,13 +1,13 @@
-import { __exportAll, __reExport } from "./_chunks/rolldown-runtime.mjs";
-import { query_exports } from "./query.mjs";
 import { analyticsEndpoints } from "@gscdump/contracts/analytics";
 import { err, ok, unwrapResult } from "gscdump/result";
 import { ofetch } from "ofetch";
-import { partnerEndpoints, partnerRoutes } from "@gscdump/contracts/partner";
+import { ARCHETYPE_EXECUTION_CLASS as ARCHETYPE_EXECUTION_CLASS$1, arbitrarySql as arbitrarySql$1, auxCloudOnly as auxCloudOnly$1, entityDailySparkline as entityDailySparkline$1, entityDailyTimeseries as entityDailyTimeseries$1, multiSeriesStackedDaily as multiSeriesStackedDaily$1, singleRowLookup as singleRowLookup$1, siteDailyTimeseries as siteDailyTimeseries$1, topNBreakdown as topNBreakdown$1, twoDimensionDetail as twoDimensionDetail$1 } from "@gscdump/contracts/archetypes";
+import { partnerEndpoints } from "@gscdump/contracts/partner";
 import { resolveWindow } from "@gscdump/engine/period";
 import { endOfMonth, format, startOfMonth, startOfQuarter, startOfWeek, subDays, subMonths } from "date-fns";
 import { CANONICAL_WEBHOOK_EVENTS, VALID_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION, WEBHOOK_CONTRACT_VERSION_HEADER, WEBHOOK_CONTRACT_VERSION_HEADER as WEBHOOK_CONTRACT_VERSION_HEADER$1, WEBHOOK_DELIVERY_HEADER, WEBHOOK_DELIVERY_HEADER as WEBHOOK_DELIVERY_HEADER$1, WEBHOOK_EVENT_HEADER, WEBHOOK_EVENT_HEADER as WEBHOOK_EVENT_HEADER$1, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_SIGNATURE_HEADER as WEBHOOK_SIGNATURE_HEADER$1, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TIMESTAMP_HEADER as WEBHOOK_TIMESTAMP_HEADER$1, partnerWebhookEnvelopeSchema } from "@gscdump/contracts";
 export * from "@gscdump/contracts";
+const DEFAULT_SEARCH_TYPE = "web";
 function isAnalysisSourcesOptions(value) {
 	return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -189,10 +189,10 @@ function formatPartnerError(error) {
 function partnerErrorToException(error) {
 	return error;
 }
-const TRAILING_SLASH_RE$1 = /\/+$/;
+const TRAILING_SLASH_RE = /\/+$/;
 const LEADING_SLASH_RE = /^\/+/;
 function trimApiBase(apiBase, fallback) {
-	return (apiBase ?? fallback).replace(TRAILING_SLASH_RE$1, "");
+	return (apiBase ?? fallback).replace(TRAILING_SLASH_RE, "");
 }
 function buildPath(apiBase, path) {
 	if (!apiBase) return path.startsWith("/") ? path : `/${path}`;
@@ -401,9 +401,16 @@ function weightedAnonPct(days, window = 28) {
 	}
 	return totalImpressions > 0 ? weighted / totalImpressions : null;
 }
-var archetypes_exports = /* @__PURE__ */ __exportAll({});
-import * as import__gscdump_contracts_archetypes from "@gscdump/contracts/archetypes";
-__reExport(archetypes_exports, import__gscdump_contracts_archetypes);
+const ARCHETYPE_EXECUTION_CLASS = ARCHETYPE_EXECUTION_CLASS$1;
+const arbitrarySql = arbitrarySql$1;
+const auxCloudOnly = auxCloudOnly$1;
+const entityDailySparkline = entityDailySparkline$1;
+const entityDailyTimeseries = entityDailyTimeseries$1;
+const multiSeriesStackedDaily = multiSeriesStackedDaily$1;
+const singleRowLookup = singleRowLookup$1;
+const siteDailyTimeseries = siteDailyTimeseries$1;
+const topNBreakdown = topNBreakdown$1;
+const twoDimensionDetail = twoDimensionDetail$1;
 function normalizeLifecycleUrl(url) {
 	return (url || "").replace(/^sc-domain:/, "").replace(/^https?:\/\//, "").replace(/^www\./, "").replace(/\/$/, "").toLowerCase();
 }
@@ -861,7 +868,6 @@ function createPartnerClient(options = {}) {
 		}
 	};
 }
-const createGscdumpClient = createPartnerClient;
 const COUNTRY_NAMES = {
 	US: "United States",
 	GB: "United Kingdom",
@@ -968,10 +974,11 @@ function classifyGscError(e) {
 		code,
 		message
 	};
-	if (code === 429) {
-		const retry = e?.data?.retryAfter;
+	if (code === 429 || code === 503) {
+		const data = e?.data;
+		const retry = data?.retryAfter ?? data?.retryAfterSeconds;
 		return {
-			status: "rate-limited",
+			status: code === 429 ? "rate-limited" : "network",
 			code,
 			message,
 			retryAfter: typeof retry === "number" ? retry : void 0
@@ -1491,8 +1498,14 @@ function parseCustomPeriod(p) {
 		end
 	};
 }
-function todayInPST() {
-	return /* @__PURE__ */ new Date(`${(0, query_exports.currentPstDate)()}T00:00:00`);
+function todayInTimezone(timezone = "America/Los_Angeles", now = /* @__PURE__ */ new Date()) {
+	const date = new Intl.DateTimeFormat("en-CA", {
+		timeZone: timezone,
+		year: "numeric",
+		month: "2-digit",
+		day: "2-digit"
+	}).format(now);
+	return /* @__PURE__ */ new Date(`${date}T00:00:00`);
 }
 const ROLLING_TO_UPSTREAM = {
 	"7d": "last-7d",
@@ -1534,7 +1547,9 @@ function buildResultFromIso(start, end) {
 		days
 	};
 }
-function periodToDateRange(period, stableData = true) {
+function periodToDateRange(period, stableDataOrOptions = true) {
+	const options = typeof stableDataOrOptions === "boolean" ? { stableData: stableDataOrOptions } : stableDataOrOptions;
+	const stableData = options.stableData ?? true;
 	const custom = parseCustomPeriod(period);
 	if (custom) {
 		const result = buildResultFromIso(custom.start, custom.end);
@@ -1547,7 +1562,7 @@ function periodToDateRange(period, stableData = true) {
 		};
 		return result;
 	}
-	const today = todayInPST();
+	const today = todayInTimezone(options.timezone, options.now);
 	const end = stableData ? subDays(today, 3) : subDays(today, 1);
 	const endIso = fmt(end);
 	const upstreamPreset = ROLLING_TO_UPSTREAM[period] ?? CALENDAR_TO_UPSTREAM[period];
@@ -1574,8 +1589,8 @@ function periodToDateRange(period, stableData = true) {
 	}
 	return buildResultFromIso(fmt(start), endIso);
 }
-function periodToDays(period) {
-	return periodToDateRange(period).days;
+function periodToDays(period, stableDataOrOptions = true) {
+	return periodToDateRange(period, stableDataOrOptions).days;
 }
 function compareRange(range, mode) {
 	if (mode === "none") return null;
@@ -1593,189 +1608,6 @@ function getGscUnstableCutoffDate() {
 	const cutoff = new Date(y, m - 1, d - 3);
 	return `${cutoff.getFullYear()}-${String(cutoff.getMonth() + 1).padStart(2, "0")}-${String(cutoff.getDate()).padStart(2, "0")}`;
 }
-function resolveReconnect(reconnect) {
-	const opts = reconnect === false ? { enabled: false } : reconnect === true || reconnect == null ? {} : reconnect;
-	return {
-		enabled: opts.enabled ?? true,
-		baseDelayMs: opts.baseDelayMs ?? 1e3,
-		maxDelayMs: opts.maxDelayMs ?? 3e4,
-		maxRetries: opts.maxRetries ?? Number.POSITIVE_INFINITY,
-		jitter: opts.jitter ?? true
-	};
-}
-const HTTP_PROTOCOL_RE = /^http/i;
-const API_SUFFIX_RE = /\/api\/?$/;
-const TRAILING_SLASH_RE = /\/+$/;
-function inferWsBase(options) {
-	if (options.wsBase) return options.wsBase.replace(TRAILING_SLASH_RE, "");
-	if (!options.apiBase) return "";
-	return options.apiBase.replace(API_SUFFIX_RE, "").replace(TRAILING_SLASH_RE, "").replace(HTTP_PROTOCOL_RE, (m) => m.toLowerCase() === "https" ? "wss" : "ws");
-}
-function wsPath(scope) {
-	return scope === "partner" ? partnerRoutes.realtime.partner : partnerRoutes.realtime.user;
-}
-function buildWsUrl(options) {
-	const scope = options.scope ?? "partner";
-	const base = inferWsBase(options);
-	if (!base) return wsPath(scope);
-	return `${base}${wsPath(scope)}`;
-}
-function parseMessage(raw) {
-	if (typeof raw !== "string") return null;
-	try {
-		return JSON.parse(raw);
-	} catch {
-		return null;
-	}
-}
-function isRealtimeEvent(message) {
-	return "event" in message && message.event !== "auth.required" && message.event !== "connected";
-}
-function getWebSocketCtor(options) {
-	const ctor = options.WebSocket ?? globalThis.WebSocket;
-	if (!ctor) throw new Error("WebSocket is not available; pass options.WebSocket");
-	return ctor;
-}
-function createPartnerRealtimeClient(options) {
-	let socket = null;
-	let status = "idle";
-	const reconnect = resolveReconnect(options.reconnect);
-	const setTimer = options.setTimeout ?? ((handler, ms) => setTimeout(handler, ms));
-	const clearTimer = options.clearTimeout ?? ((handle) => clearTimeout(handle));
-	let manualClose = false;
-	let reconnectAttempts = 0;
-	let reconnectTimer = null;
-	const statusHandlers = /* @__PURE__ */ new Set();
-	const messageHandlers = /* @__PURE__ */ new Set();
-	const eventHandlers = /* @__PURE__ */ new Set();
-	const errorHandlers = /* @__PURE__ */ new Set();
-	function setStatus(next) {
-		status = next;
-		for (const handler of statusHandlers) handler(next);
-	}
-	function sendJson(payload) {
-		if (!socket) throw new Error("Partner realtime client is not connected");
-		socket.send(JSON.stringify(payload));
-	}
-	function authPayload() {
-		const payload = {
-			type: "auth",
-			apiKey: options.apiKey
-		};
-		if (options.userId != null) payload.userId = options.userId;
-		return payload;
-	}
-	function subscribe(siteIds) {
-		sendJson({
-			type: "subscribe",
-			siteIds
-		});
-	}
-	function clearReconnectTimer() {
-		if (reconnectTimer != null) {
-			clearTimer(reconnectTimer);
-			reconnectTimer = null;
-		}
-	}
-	function backoffDelay(attempt) {
-		const exp = Math.min(reconnect.maxDelayMs, reconnect.baseDelayMs * 2 ** attempt);
-		if (!reconnect.jitter) return exp;
-		return Math.round(exp / 2 + Math.random() * (exp / 2));
-	}
-	function openSocket() {
-		if (socket) return socket;
-		clearReconnectTimer();
-		manualClose = false;
-		socket = new (getWebSocketCtor(options))(buildWsUrl(options), options.protocols);
-		setStatus("connecting");
-		socket.onopen = () => {
-			setStatus("open");
-			sendJson(authPayload());
-		};
-		socket.onmessage = (event) => {
-			const message = parseMessage(event.data);
-			if (!message) return;
-			if ("event" in message && message.event === "connected") {
-				reconnectAttempts = 0;
-				setStatus("authenticated");
-				if (options.siteIds?.length) subscribe(options.siteIds);
-			}
-			for (const handler of messageHandlers) handler(message);
-			if (isRealtimeEvent(message)) for (const handler of eventHandlers) handler(message);
-		};
-		socket.onerror = (event) => {
-			setStatus("error");
-			for (const handler of errorHandlers) handler(event);
-		};
-		socket.onclose = (event) => {
-			socket = null;
-			setStatus("closed");
-			for (const handler of messageHandlers) handler({
-				type: "error",
-				message: `WebSocket closed: ${JSON.stringify(event)}`
-			});
-			scheduleReconnect();
-		};
-		return socket;
-	}
-	function scheduleReconnect() {
-		if (!reconnect.enabled || manualClose || reconnectTimer != null) return;
-		if (reconnectAttempts >= reconnect.maxRetries) {
-			const err = /* @__PURE__ */ new Error(`Partner realtime reconnect exhausted after ${reconnectAttempts} attempts`);
-			for (const handler of errorHandlers) handler(err);
-			return;
-		}
-		const delay = backoffDelay(reconnectAttempts);
-		reconnectAttempts += 1;
-		setStatus("connecting");
-		reconnectTimer = setTimer(() => {
-			reconnectTimer = null;
-			openSocket();
-		}, delay);
-	}
-	return {
-		get status() {
-			return status;
-		},
-		get socket() {
-			return socket;
-		},
-		connect() {
-			return openSocket();
-		},
-		close(code, reason) {
-			manualClose = true;
-			clearReconnectTimer();
-			const ws = socket;
-			socket = null;
-			setStatus("closed");
-			if (!ws) return;
-			if (ws.readyState === 0) ws.onopen = () => ws.close(code, reason);
-			else ws.close(code, reason);
-		},
-		ping() {
-			sendJson({ type: "ping" });
-		},
-		subscribe,
-		onStatus(handler) {
-			statusHandlers.add(handler);
-			return () => statusHandlers.delete(handler);
-		},
-		onMessage(handler) {
-			messageHandlers.add(handler);
-			return () => messageHandlers.delete(handler);
-		},
-		onEvent(handler) {
-			eventHandlers.add(handler);
-			return () => eventHandlers.delete(handler);
-		},
-		onError(handler) {
-			errorHandlers.add(handler);
-			return () => errorHandlers.delete(handler);
-		}
-	};
-}
-const createGscdumpRealtimeClient = createPartnerRealtimeClient;
 function formatSearchConsoleCount(value) {
 	return new Intl.NumberFormat("en").format(Math.max(0, Math.round(value)));
 }
@@ -2526,5 +2358,4 @@ function readWebhookHeaders(headers) {
 		signature: headers.signature ?? null
 	};
 }
-var ARCHETYPE_EXECUTION_CLASS = archetypes_exports.ARCHETYPE_EXECUTION_CLASS;
-export { ARCHETYPE_EXECUTION_CLASS, CANONICAL_WEBHOOK_EVENTS, COMPARE_OPTIONS, COUNTRY_NAMES, CWV_GOOD_CLS, CWV_GOOD_INP, CWV_GOOD_LCP, CWV_POOR_CLS, CWV_POOR_INP, CWV_POOR_LCP, GSC_COLUMN_OPTIONS, GSC_PERIOD_OPTIONS, GSC_PERIOD_OPTIONS_LONG, GSC_STABLE_LATENCY_DAYS, PERIOD_PRESETS, PartnerApiError, SITE_TYPE_BASELINE, VALID_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION, WEBHOOK_CONTRACT_VERSION_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, analyticsStatusToSyncStatus, andFilter, classifyGscError, classifyHealthStage, classifyReachStage, classifySearchConsoleStage, classifySiteTriage, coerceRowMetrics, compareRange, countryName, coverageLabel, coverageLabels, createAnalyticsClient, createGscdumpClient, createGscdumpRealtimeClient, createPartnerClient, createPartnerRealtimeClient, cwvBucket, dateFilter, defineGscAnalyzer, derivePeerStanding, deriveSiteBaseline, enrichIssueDetails, findLifecycleSite, formatPartnerError, getGscUnstableCutoffDate, gscConsoleUrl, investigationStatusConfig, isCustomPeriod, isPartnerError, issueDetails, issueGroups, issueTypeToGroup, lifecycleSiteToSyncStatus, lifecycleSiteToUserSite, normalizeSiteType, nuxtSeoTips, parseCustomPeriod, parseWebhookPayload, parseWebhookPayloadResult, partnerErrorToException, periodToDateRange, periodToDays, positionFor, reachLivenessRatio, readWebhookHeaders, serializeWebhookPayload, severityOrder, siteTypeBaseline, siteUrlToHostname, splitOpportunityTitle, summarizeDailyRows, toPartnerError, truncateQuery, verifyWebhookSignature, weightedAnonPct };
+export { ARCHETYPE_EXECUTION_CLASS, CANONICAL_WEBHOOK_EVENTS, COMPARE_OPTIONS, COUNTRY_NAMES, CWV_GOOD_CLS, CWV_GOOD_INP, CWV_GOOD_LCP, CWV_POOR_CLS, CWV_POOR_INP, CWV_POOR_LCP, DEFAULT_SEARCH_TYPE, GSC_COLUMN_OPTIONS, GSC_PERIOD_OPTIONS, GSC_PERIOD_OPTIONS_LONG, GSC_STABLE_LATENCY_DAYS, PERIOD_PRESETS, PartnerApiError, SITE_TYPE_BASELINE, VALID_WEBHOOK_EVENTS, WEBHOOK_CONTRACT_VERSION, WEBHOOK_CONTRACT_VERSION_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, analyticsStatusToSyncStatus, andFilter, arbitrarySql, auxCloudOnly, classifyGscError, classifyHealthStage, classifyReachStage, classifySearchConsoleStage, classifySiteTriage, coerceRowMetrics, compareRange, countryName, coverageLabel, coverageLabels, createAnalyticsClient, createPartnerClient, cwvBucket, dateFilter, dateRangeOptionsQuery, defineGscAnalyzer, derivePeerStanding, deriveSiteBaseline, enrichIssueDetails, entityDailySparkline, entityDailyTimeseries, findLifecycleSite, formatPartnerError, getGscUnstableCutoffDate, gscConsoleUrl, investigationStatusConfig, isCustomPeriod, isPartnerError, issueDetails, issueGroups, issueTypeToGroup, lifecycleSiteToSyncStatus, lifecycleSiteToUserSite, multiSeriesStackedDaily, normalizeSiteType, nuxtSeoTips, parseCustomPeriod, parseWebhookPayload, parseWebhookPayloadResult, partnerErrorToException, periodToDateRange, periodToDays, positionFor, reachLivenessRatio, readWebhookHeaders, searchTypeQuery, serializeWebhookPayload, severityOrder, singleRowLookup, siteDailyTimeseries, siteTypeBaseline, siteUrlToHostname, sourceInfoQuery, splitOpportunityTitle, summarizeDailyRows, tablesQuery, toPartnerError, topNBreakdown, truncateQuery, twoDimensionDetail, verifyWebhookSignature, weightedAnonPct, withDefaultSearchType };

package/dist/query.mjs

@@ -1,6 +1,2 @@
-import { __exportAll, __reExport } from "./_chunks/rolldown-runtime.mjs";
 export * from "gscdump/query";
-var query_exports = /* @__PURE__ */ __exportAll({});
-import * as import_gscdump_query from "gscdump/query";
-__reExport(query_exports, import_gscdump_query);
-export { query_exports };
+export {};

package/dist/v1/index.d.mts

@@ -71,7 +71,21 @@ declare function isGscdumpV1Error(error: unknown): error is GscdumpV1Error;
 interface GscdumpV1Client {
   execute: <TId extends GscdumpV1OperationId>(operation: TId, input: GscdumpV1OperationInput<TId>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<TId>>;
   getUserLifecycle: (input: GscdumpV1OperationInput<'partner.users.lifecycle.get'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.users.lifecycle.get'>>;
+  listAvailableSites: (input: GscdumpV1OperationInput<'partner.users.sites.available.list'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.users.sites.available.list'>>;
+  createSite: (input: GscdumpV1OperationInput<'partner.users.sites.create'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.users.sites.create'>>;
+  createUser: (input: GscdumpV1OperationInput<'partner.users.create'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.users.create'>>;
+  updateUserTokens: (input: GscdumpV1OperationInput<'partner.users.tokens.update'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.users.tokens.update'>>;
+  getSiteIndexing: (input: GscdumpV1OperationInput<'partner.sites.indexing.get'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.sites.indexing.get'>>;
+  listSiteIndexingUrls: (input: GscdumpV1OperationInput<'partner.sites.indexing.urls.list'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.sites.indexing.urls.list'>>;
+  getSiteIndexingDiagnostics: (input: GscdumpV1OperationInput<'partner.sites.indexing.diagnostics.get'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.sites.indexing.diagnostics.get'>>;
+  getSiteSitemaps: (input: GscdumpV1OperationInput<'partner.sites.sitemaps.get'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.sites.sitemaps.get'>>;
+  getSiteSitemapChanges: (input: GscdumpV1OperationInput<'partner.sites.sitemaps.changes.get'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.sites.sitemaps.changes.get'>>;
+  getSiteAnalysis: (input: GscdumpV1OperationInput<'partner.sites.analysis.get'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.sites.analysis.get'>>;
+  getSiteAnalysisBundle: (input: GscdumpV1OperationInput<'partner.sites.analysis.bundle.get'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.sites.analysis.bundle.get'>>;
+  deleteSite: (input: GscdumpV1OperationInput<'partner.sites.delete'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'partner.sites.delete'>>;
   queryAnalyticsRows: (input: GscdumpV1OperationInput<'analytics.rows.query'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'analytics.rows.query'>>;
+  queryAnalyticsReport: (input: GscdumpV1OperationInput<'analytics.reports.query'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'analytics.reports.query'>>;
+  queryAnalyticsReportDetail: (input: GscdumpV1OperationInput<'analytics.reports.detail.query'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'analytics.reports.detail.query'>>;
   getRealtimeStreamHead: (input?: GscdumpV1OperationInput<'realtime.stream.head.get'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'realtime.stream.head.get'>>;
   createRealtimeTicket: (input: GscdumpV1OperationInput<'realtime.tickets.create'>, options?: GscdumpV1ExecuteOptions) => Promise<GscdumpV1OperationResponse<'realtime.tickets.create'>>;
 }

package/dist/v1/index.mjs

@@ -363,7 +363,21 @@ function createGscdumpV1Client(options) {
 	return {
 		execute,
 		getUserLifecycle: (input, executeOptions) => execute("partner.users.lifecycle.get", input, executeOptions),
+		listAvailableSites: (input, executeOptions) => execute("partner.users.sites.available.list", input, executeOptions),
+		createSite: (input, executeOptions) => execute("partner.users.sites.create", input, executeOptions),
+		createUser: (input, executeOptions) => execute("partner.users.create", input, executeOptions),
+		updateUserTokens: (input, executeOptions) => execute("partner.users.tokens.update", input, executeOptions),
+		getSiteIndexing: (input, executeOptions) => execute("partner.sites.indexing.get", input, executeOptions),
+		listSiteIndexingUrls: (input, executeOptions) => execute("partner.sites.indexing.urls.list", input, executeOptions),
+		getSiteIndexingDiagnostics: (input, executeOptions) => execute("partner.sites.indexing.diagnostics.get", input, executeOptions),
+		getSiteSitemaps: (input, executeOptions) => execute("partner.sites.sitemaps.get", input, executeOptions),
+		getSiteSitemapChanges: (input, executeOptions) => execute("partner.sites.sitemaps.changes.get", input, executeOptions),
+		getSiteAnalysis: (input, executeOptions) => execute("partner.sites.analysis.get", input, executeOptions),
+		getSiteAnalysisBundle: (input, executeOptions) => execute("partner.sites.analysis.bundle.get", input, executeOptions),
+		deleteSite: (input, executeOptions) => execute("partner.sites.delete", input, executeOptions),
 		queryAnalyticsRows: (input, executeOptions) => execute("analytics.rows.query", input, executeOptions),
+		queryAnalyticsReport: (input, executeOptions) => execute("analytics.reports.query", input, executeOptions),
+		queryAnalyticsReportDetail: (input, executeOptions) => execute("analytics.reports.detail.query", input, executeOptions),
 		getRealtimeStreamHead: (input = {}, executeOptions) => execute("realtime.stream.head.get", input, executeOptions),
 		createRealtimeTicket: (input, executeOptions) => execute("realtime.tickets.create", input, executeOptions)
 	};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/sdk",
   "type": "module",
-  "version": "0.39.0",
+  "version": "0.40.2",
   "description": "Consumer SDK for hosted gscdump.com integrations.",
   "author": {
     "name": "Harlan Wilton",
@@ -49,10 +49,10 @@
     "date-fns": "^4.4.0",
     "ofetch": "^1.5.1",
     "zod": "^4.4.3",
-    "@gscdump/contracts": "0.39.0",
-    "@gscdump/analysis": "0.39.0",
-    "@gscdump/engine": "0.39.0",
-    "gscdump": "0.39.0"
+    "@gscdump/contracts": "0.40.2",
+    "@gscdump/engine": "0.40.2",
+    "gscdump": "0.40.2",
+    "@gscdump/analysis": "0.40.2"
   },
   "devDependencies": {
     "typescript": "^6.0.3",

package/dist/_chunks/rolldown-runtime.mjs

@@ -1,25 +0,0 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-export { __exportAll, __reExport };