@gscdump/sdk 0.38.2 → 0.40.1

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);
 }
@@ -49,6 +49,9 @@ function tablesQuery(tablesOrOptions, options) {
 		...dateRangeOptionsQuery(source)
 	};
 	if (tables) query.tables = Array.isArray(tables) ? [...new Set(tables.filter(Boolean))].sort().join(",") : [...new Set(tables.split(",").map((t) => t.trim()).filter(Boolean))].sort().join(",");
+	if (source?.maxBytes != null) query.maxBytes = String(Math.max(1, Math.floor(source.maxBytes)));
+	if (source?.maxRows != null) query.maxRows = String(Math.max(1, Math.floor(source.maxRows)));
+	if (source?.maxFiles != null) query.maxFiles = String(Math.max(1, Math.floor(source.maxFiles)));
 	return query;
 }
 function dataQuery(state, options) {
@@ -186,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}`;
@@ -398,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();
 }
@@ -858,7 +868,6 @@ function createPartnerClient(options = {}) {
 		}
 	};
 }
-const createGscdumpClient = createPartnerClient;
 const COUNTRY_NAMES = {
 	US: "United States",
 	GB: "United Kingdom",
@@ -965,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
@@ -1133,19 +1143,26 @@ function coerceRowMetrics(row) {
 	};
 }
 function summarizeDailyRows(raw) {
-	const daily = raw.map(coerceRowMetrics).map((r) => ({
-		date: r.date,
-		clicks: r.clicks,
-		impressions: r.impressions,
-		sum_position: r.sum_position
-	})).sort((a, b) => a.date.localeCompare(b.date));
+	const daily = [];
+	for (let index = 0; index < raw.length; index++) {
+		const row = raw[index];
+		const position = row.position ?? 0;
+		const sumPosition = row.sum_position ?? (position > 0 ? (position - 1) * row.impressions : 0);
+		daily.push({
+			date: row.date,
+			clicks: row.clicks,
+			impressions: row.impressions,
+			sum_position: sumPosition
+		});
+	}
+	daily.sort((a, b) => a.date.localeCompare(b.date));
 	let clicks = 0;
 	let impressions = 0;
 	let weightedPosition = 0;
-	for (const d of daily) {
-		clicks += d.clicks;
-		impressions += d.impressions;
-		weightedPosition += d.sum_position;
+	for (const row of daily) {
+		clicks += row.clicks;
+		impressions += row.impressions;
+		weightedPosition += row.sum_position;
 	}
 	return {
 		daily,
@@ -1481,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",
@@ -1524,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);
@@ -1537,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];
@@ -1564,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;
@@ -1583,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)));
 }
@@ -1893,120 +1735,123 @@ function totalSitemapErrors(sitemaps) {
 function signedPct1(value) {
 	return `${value >= 0 ? "+" : ""}${value.toFixed(1)}%`;
 }
+const SEARCH_CONSOLE_STAGES = {
+	not_connected: {
+		label: "Not connected",
+		severity: "neutral",
+		summary: "Search Console is not connected for this site yet.",
+		primaryAction: "Connect Google Search Console so we can read discovery, indexing, and performance data.",
+		nextStage: "waiting_for_data",
+		sprintFindingTypes: []
+	},
+	waiting_for_data: {
+		label: "Waiting for data",
+		severity: "info",
+		summary: "Search Console is connected, but there is not enough indexing data to diagnose the site yet.",
+		primaryAction: "Let the first sync finish, then make sure a sitemap is submitted.",
+		nextStage: "weak_discovery",
+		sprintFindingTypes: []
+	},
+	weak_discovery: {
+		label: "Weak discovery",
+		severity: "warning",
+		summary: "Google does not have a clean map of the pages you want indexed.",
+		primaryAction: "Submit a clean sitemap that contains only canonical, indexable 200 URLs.",
+		nextStage: "discovery_backlog",
+		sprintFindingTypes: ["search-console-stage", "sitemap-missing"]
+	},
+	discovery_backlog: {
+		label: "Discovery backlog",
+		severity: "warning",
+		summary: "Google knows these pages exist, but is not crawling them fast enough.",
+		primaryAction: "Add internal links from indexed pages and remove low-value URLs from the sitemap.",
+		nextStage: "crawl_blocked",
+		sprintFindingTypes: ["search-console-stage"]
+	},
+	crawl_blocked: {
+		label: "Crawl blocked",
+		severity: "error",
+		summary: "Google is trying to access pages, but technical access problems are blocking progress.",
+		primaryAction: "Fix robots.txt blocks, server errors, broken URLs, and access failures before content work.",
+		nextStage: "indexability_blocked",
+		sprintFindingTypes: ["search-console-stage", "noindex-block"]
+	},
+	indexability_blocked: {
+		label: "Indexability blocked",
+		severity: "error",
+		summary: "Google can reach pages, but index directives or canonical signals are preventing clean indexing.",
+		primaryAction: "Remove accidental noindex directives and make canonical signals agree.",
+		nextStage: "index_rejection",
+		sprintFindingTypes: [
+			"search-console-stage",
+			"noindex-block",
+			"canonicalisation"
+		]
+	},
+	index_rejection: {
+		label: "Index rejection",
+		severity: "warning",
+		summary: "Google is crawling pages but skipping too many of them from the index.",
+		primaryAction: "Improve or consolidate crawled-but-not-indexed pages before publishing more.",
+		nextStage: "partially_indexed",
+		sprintFindingTypes: ["search-console-stage", "pages-not-indexed"]
+	},
+	partially_indexed: {
+		label: "Partially indexed",
+		severity: "warning",
+		summary: "A meaningful share of the site is indexed, but coverage is still below a healthy level.",
+		primaryAction: "Work through the largest remaining indexing blocker first.",
+		nextStage: "indexed_invisible",
+		sprintFindingTypes: ["search-console-stage", "pages-not-indexed"]
+	},
+	indexed_invisible: {
+		label: "Indexed but invisible",
+		severity: "warning",
+		summary: "Pages are indexed, but too many are not earning impressions in Search.",
+		primaryAction: "Improve query targeting, titles, headings, internal links, and page depth.",
+		nextStage: "visible_not_clicked",
+		sprintFindingTypes: ["search-console-stage"]
+	},
+	visible_not_clicked: {
+		label: "Visible but not clicked",
+		severity: "warning",
+		summary: "Google is showing your pages, but searchers are not clicking often enough.",
+		primaryAction: "Rewrite titles and descriptions for the queries already producing impressions.",
+		nextStage: "ranking_stalled",
+		sprintFindingTypes: ["search-console-stage", "ctr-outliers"]
+	},
+	ranking_stalled: {
+		label: "Ranking but stalled",
+		severity: "info",
+		summary: "The site has search visibility, but many pages are not yet ranking in useful positions.",
+		primaryAction: "Prioritise striking-distance pages, refresh content, and add internal links.",
+		nextStage: "healthy_growth_ready",
+		sprintFindingTypes: ["striking-distance", "internal-linking"]
+	},
+	declining_visibility: {
+		label: "Declining visibility",
+		severity: "error",
+		summary: "Search visibility is dropping compared with the previous period.",
+		primaryAction: "Review affected pages, recent releases, competitors, and SERP changes before expanding.",
+		nextStage: "healthy_growth_ready",
+		sprintFindingTypes: ["search-console-stage", "negative-movers"]
+	},
+	healthy_growth_ready: {
+		label: "Healthy",
+		severity: "success",
+		summary: "Google can discover, index, and show your pages.",
+		primaryAction: "Push striking-distance pages (positions 11 to 20) and close content gaps to grow impressions.",
+		nextStage: null,
+		sprintFindingTypes: ["striking-distance", "competitor-content-gap"]
+	}
+};
 function stage(key, evidence) {
+	const definition = SEARCH_CONSOLE_STAGES[key];
 	return {
 		key,
 		evidence,
-		...{
-			not_connected: {
-				label: "Not connected",
-				severity: "neutral",
-				summary: "Search Console is not connected for this site yet.",
-				primaryAction: "Connect Google Search Console so we can read discovery, indexing, and performance data.",
-				nextStage: "waiting_for_data",
-				sprintFindingTypes: []
-			},
-			waiting_for_data: {
-				label: "Waiting for data",
-				severity: "info",
-				summary: "Search Console is connected, but there is not enough indexing data to diagnose the site yet.",
-				primaryAction: "Let the first sync finish, then make sure a sitemap is submitted.",
-				nextStage: "weak_discovery",
-				sprintFindingTypes: []
-			},
-			weak_discovery: {
-				label: "Weak discovery",
-				severity: "warning",
-				summary: "Google does not have a clean map of the pages you want indexed.",
-				primaryAction: "Submit a clean sitemap that contains only canonical, indexable 200 URLs.",
-				nextStage: "discovery_backlog",
-				sprintFindingTypes: ["search-console-stage", "sitemap-missing"]
-			},
-			discovery_backlog: {
-				label: "Discovery backlog",
-				severity: "warning",
-				summary: "Google knows these pages exist, but is not crawling them fast enough.",
-				primaryAction: "Add internal links from indexed pages and remove low-value URLs from the sitemap.",
-				nextStage: "crawl_blocked",
-				sprintFindingTypes: ["search-console-stage"]
-			},
-			crawl_blocked: {
-				label: "Crawl blocked",
-				severity: "error",
-				summary: "Google is trying to access pages, but technical access problems are blocking progress.",
-				primaryAction: "Fix robots.txt blocks, server errors, broken URLs, and access failures before content work.",
-				nextStage: "indexability_blocked",
-				sprintFindingTypes: ["search-console-stage", "noindex-block"]
-			},
-			indexability_blocked: {
-				label: "Indexability blocked",
-				severity: "error",
-				summary: "Google can reach pages, but index directives or canonical signals are preventing clean indexing.",
-				primaryAction: "Remove accidental noindex directives and make canonical signals agree.",
-				nextStage: "index_rejection",
-				sprintFindingTypes: [
-					"search-console-stage",
-					"noindex-block",
-					"canonicalisation"
-				]
-			},
-			index_rejection: {
-				label: "Index rejection",
-				severity: "warning",
-				summary: "Google is crawling pages but skipping too many of them from the index.",
-				primaryAction: "Improve or consolidate crawled-but-not-indexed pages before publishing more.",
-				nextStage: "partially_indexed",
-				sprintFindingTypes: ["search-console-stage", "pages-not-indexed"]
-			},
-			partially_indexed: {
-				label: "Partially indexed",
-				severity: "warning",
-				summary: "A meaningful share of the site is indexed, but coverage is still below a healthy level.",
-				primaryAction: "Work through the largest remaining indexing blocker first.",
-				nextStage: "indexed_invisible",
-				sprintFindingTypes: ["search-console-stage", "pages-not-indexed"]
-			},
-			indexed_invisible: {
-				label: "Indexed but invisible",
-				severity: "warning",
-				summary: "Pages are indexed, but too many are not earning impressions in Search.",
-				primaryAction: "Improve query targeting, titles, headings, internal links, and page depth.",
-				nextStage: "visible_not_clicked",
-				sprintFindingTypes: ["search-console-stage"]
-			},
-			visible_not_clicked: {
-				label: "Visible but not clicked",
-				severity: "warning",
-				summary: "Google is showing your pages, but searchers are not clicking often enough.",
-				primaryAction: "Rewrite titles and descriptions for the queries already producing impressions.",
-				nextStage: "ranking_stalled",
-				sprintFindingTypes: ["search-console-stage", "ctr-outliers"]
-			},
-			ranking_stalled: {
-				label: "Ranking but stalled",
-				severity: "info",
-				summary: "The site has search visibility, but many pages are not yet ranking in useful positions.",
-				primaryAction: "Prioritise striking-distance pages, refresh content, and add internal links.",
-				nextStage: "healthy_growth_ready",
-				sprintFindingTypes: ["striking-distance", "internal-linking"]
-			},
-			declining_visibility: {
-				label: "Declining visibility",
-				severity: "error",
-				summary: "Search visibility is dropping compared with the previous period.",
-				primaryAction: "Review affected pages, recent releases, competitors, and SERP changes before expanding.",
-				nextStage: "healthy_growth_ready",
-				sprintFindingTypes: ["search-console-stage", "negative-movers"]
-			},
-			healthy_growth_ready: {
-				label: "Healthy",
-				severity: "success",
-				summary: "Google can discover, index, and show your pages.",
-				primaryAction: "Push striking-distance pages (positions 11 to 20) and close content gaps to grow impressions.",
-				nextStage: null,
-				sprintFindingTypes: ["striking-distance", "competitor-content-gap"]
-			}
-		}[key]
+		...definition,
+		sprintFindingTypes: [...definition.sprintFindingTypes]
 	};
 }
 const ESTABLISHED_IMPRESSIONS_28D$1 = 2e4;
@@ -2039,8 +1884,13 @@ function classifySearchConsoleStage(input) {
 	const crawled = countSearchConsoleIssues(issues, "crawled_not_indexed");
 	const hardBlocks = countSearchConsoleIssues(issues, "blocked_robots", "server_error", "access_denied", "forbidden") + (input.crawlAuditBlockerCount ?? 0);
 	const canonicalMismatches = Math.min(notIndexed, input.canonicalMismatchCount ?? countSearchConsoleIssues(issues, "canonical_mismatch"));
-	const visibleNoClickPages = (input.pageInventory ?? []).filter((page) => page.impressions >= 50 && page.clicks === 0).length;
-	const poorPositionPages = (input.pageInventory ?? []).filter((page) => page.impressions >= 50 && (page.position ?? 0) > 20).length;
+	let visibleNoClickPages = 0;
+	let poorPositionPages = 0;
+	for (const page of input.pageInventory ?? []) {
+		if (page.impressions < 50) continue;
+		if (page.clicks === 0) visibleNoClickPages++;
+		if ((page.position ?? 0) > 20) poorPositionPages++;
+	}
 	const ctrOutlierCount = input.ctrOutlierCount ?? 0;
 	const traj = input.trajectory ?? null;
 	const impressions28d = input.impressions28d ?? null;
@@ -2508,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

@@ -155,11 +155,12 @@ async function resolveBaseHeaders(resolver) {
 }
 async function buildRequestHeaders(options, operation, prepared, executeOptions) {
 	try {
-		const headers = new Headers(await resolveBaseHeaders(options.headers));
+		const [baseHeaders, credential] = await Promise.all([resolveBaseHeaders(options.headers), resolveCredential(options.credential)]);
+		const headers = new Headers(baseHeaders);
 		for (const [key, value] of Object.entries(prepared.headers)) if (value !== void 0) headers.set(key, String(value));
 		headers.delete("x-api-key");
 		headers.set("accept", "application/json");
-		headers.set("authorization", `Bearer ${await resolveCredential(options.credential)}`);
+		headers.set("authorization", `Bearer ${credential}`);
 		if (executeOptions.idempotencyKey) headers.set("idempotency-key", executeOptions.idempotencyKey);
 		if (prepared.body !== void 0) headers.set("content-type", "application/json");
 		return headers;
@@ -362,11 +363,38 @@ 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)
 	};
 }
+function utf8Size(value) {
+	let bytes = 0;
+	for (let index = 0; index < value.length; index++) {
+		const code = value.charCodeAt(index);
+		if (code <= 127) bytes++;
+		else if (code <= 2047) bytes += 2;
+		else if (code >= 55296 && code <= 56319 && index + 1 < value.length && value.charCodeAt(index + 1) >= 56320 && value.charCodeAt(index + 1) <= 57343) {
+			bytes += 4;
+			index++;
+		} else bytes += 3;
+	}
+	return bytes;
+}
 const GSCDUMP_REALTIME_V1_SDK_VERSION = "0.37.7";
 var GscdumpRealtimeV1Error = class extends Error {
 	tag = "GscdumpRealtimeV1Error";
@@ -417,13 +445,14 @@ function defaultRuntime() {
 		now: () => Date.now()
 	};
 }
-function utf8Size(value) {
-	return new TextEncoder().encode(value).byteLength;
-}
+const UTF8_DECODER = new TextDecoder();
+const REALTIME_EVENT_NAMES = new Set(REALTIME_V1_EVENT_NAMES);
+const REALTIME_RESOURCE_TYPES = new Set(REALTIME_V1_RESOURCE_TYPES);
+const APPLIED_EVENT_CACHE_MAX = 1e4;
 async function messageText(raw) {
 	if (typeof raw === "string") return raw;
-	if (raw instanceof ArrayBuffer) return new TextDecoder().decode(raw);
-	if (ArrayBuffer.isView(raw)) return new TextDecoder().decode(new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength));
+	if (raw instanceof ArrayBuffer) return UTF8_DECODER.decode(raw);
+	if (ArrayBuffer.isView(raw)) return UTF8_DECODER.decode(new Uint8Array(raw.buffer, raw.byteOffset, raw.byteLength));
 	if (typeof Blob !== "undefined" && raw instanceof Blob) return raw.text();
 	throw new TypeError("Realtime frames must be text or UTF-8 binary data.");
 }
@@ -472,6 +501,7 @@ function createGscdumpRealtimeV1Client(options) {
 	const eventFailures = /* @__PURE__ */ new Map();
 	const appliedEventIds = /* @__PURE__ */ new Set();
 	const appliedEventOrder = [];
+	let appliedEventCursor = 0;
 	function getSnapshot() {
 		return {
 			transport,
@@ -605,23 +635,25 @@ function createGscdumpRealtimeV1Client(options) {
 		const key = eventDedupeKey(stream, id);
 		if (appliedEventIds.has(key)) return;
 		appliedEventIds.add(key);
-		appliedEventOrder.push(key);
-		if (appliedEventOrder.length > 1e4) {
-			const oldest = appliedEventOrder.shift();
+		if (appliedEventOrder.length < APPLIED_EVENT_CACHE_MAX) appliedEventOrder.push(key);
+		else {
+			const oldest = appliedEventOrder[appliedEventCursor];
 			if (oldest) appliedEventIds.delete(oldest);
+			appliedEventOrder[appliedEventCursor] = key;
+			appliedEventCursor = (appliedEventCursor + 1) % APPLIED_EVENT_CACHE_MAX;
 		}
 	}
 	function eventFailureKey(event) {
 		return `${event.cursor?.streamId ?? "ephemeral"}:${event.id}:${event.cursor?.sequence ?? "ephemeral"}`;
 	}
 	function eventForRequiredEffect(event) {
-		return REALTIME_V1_EVENT_NAMES.includes(event.name) && event.eventVersion === 1 ? event : {
+		return REALTIME_EVENT_NAMES.has(event.name) && event.eventVersion === 1 ? event : {
 			...event,
 			data: null
 		};
 	}
 	function eventAdvisories(event) {
-		if (!REALTIME_V1_EVENT_NAMES.includes(event.name)) observe({
+		if (!REALTIME_EVENT_NAMES.has(event.name)) observe({
 			type: "advisory",
 			code: "unknown_event",
 			event
@@ -631,7 +663,7 @@ function createGscdumpRealtimeV1Client(options) {
 			code: "unsupported_event_version",
 			event
 		});
-		if (event.changes.some((change) => !REALTIME_V1_RESOURCE_TYPES.includes(change.type))) observe({
+		if (event.changes.some((change) => !REALTIME_RESOURCE_TYPES.has(change.type))) observe({
 			type: "advisory",
 			code: "unknown_resource",
 			event
@@ -1058,7 +1090,8 @@ function createGscdumpRealtimeV1Client(options) {
 			context.lastPongAt = runtime.now();
 			return;
 		}
-		if (utf8Size(text) > GSCDUMP_REALTIME_LIMITS.outboundFrameMaxBytes) throw new GscdumpRealtimeV1Error({
+		const textBytes = utf8Size(text);
+		if (textBytes > GSCDUMP_REALTIME_LIMITS.outboundFrameMaxBytes) throw new GscdumpRealtimeV1Error({
 			code: "protocol_error",
 			message: "A server frame exceeded the v1 outbound frame limit.",
 			retryable: false,
@@ -1086,8 +1119,7 @@ function createGscdumpRealtimeV1Client(options) {
 			cause: parsed.error
 		});
 		if (parsed.data.type === "event") {
-			const eventLimit = parsed.data.delivery === "durable" ? GSCDUMP_REALTIME_LIMITS.durableEventMaxBytes : GSCDUMP_REALTIME_LIMITS.ephemeralEventMaxBytes;
-			if (utf8Size(text) > eventLimit) throw new GscdumpRealtimeV1Error({
+			if (textBytes > (parsed.data.delivery === "durable" ? GSCDUMP_REALTIME_LIMITS.durableEventMaxBytes : GSCDUMP_REALTIME_LIMITS.ephemeralEventMaxBytes)) throw new GscdumpRealtimeV1Error({
 				code: "protocol_error",
 				message: `A ${parsed.data.delivery} event exceeded its v1 size limit.`,
 				retryable: false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/sdk",
   "type": "module",
-  "version": "0.38.2",
+  "version": "0.40.1",
   "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.38.2",
-    "@gscdump/engine": "0.38.2",
-    "gscdump": "0.38.2",
-    "@gscdump/analysis": "0.38.2"
+    "@gscdump/analysis": "0.40.1",
+    "@gscdump/contracts": "0.40.1",
+    "@gscdump/engine": "0.40.1",
+    "gscdump": "0.40.1"
   },
   "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 };