@gscdump/sdk 0.26.10 → 0.27.0

package/dist/index.d.mts

@@ -1,40 +1,53 @@
 import { query_d_exports } from "./_chunks/query.mjs";
-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, 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 { Result } from "gscdump/result";
-import { BuilderState as BuilderState$1, Dimension, Metric, SearchType } from "gscdump/query";
+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, 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 { ActionSource } from "@gscdump/analysis";
 import { AnalysisTool } from "@gscdump/engine/analysis-types";
 export * from "@gscdump/contracts";
-type PartnerFetch = <T = unknown>(request: string, options?: PartnerFetchOptions) => Promise<T>;
-type PartnerHeaders = HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
-interface PartnerFetchOptions {
+type PartnerErrorKind = 'auth' | 'rate-limit' | 'provisioning' | 'permission' | 'network' | 'validation' | 'not-found' | 'server' | 'unknown';
+interface PartnerErrorInfo {
+  kind: PartnerErrorKind;
+  statusCode?: number;
+  message: string;
+  data?: unknown;
+}
+declare class PartnerApiError extends Error {
+  readonly kind: PartnerErrorKind;
+  readonly statusCode?: number;
+  readonly data?: unknown;
+  constructor(info: PartnerErrorInfo);
+}
+declare function toPartnerError(error: unknown): PartnerApiError;
+/** Narrow an unknown error to the modelled `PartnerApiError`. */
+declare function isPartnerError(error: unknown): error is PartnerApiError;
+/** Human-readable, log-friendly rendering of a modelled partner failure. */
+declare function formatPartnerError(error: PartnerApiError): string;
+/**
+ * Re-raise a modelled `PartnerApiError` as itself. The error variant of every
+ * `*Result` core already IS the throwable `PartnerApiError`, so the throwing
+ * wrappers preserve the exact identity/message existing call sites and tests
+ * assert (`rejects.toThrow(PartnerApiError)`, `toThrow('Invalid webhook signature')`).
+ */
+declare function partnerErrorToException(error: PartnerApiError): PartnerApiError;
+type HostedFetch = <T = unknown>(request: string, options?: HostedFetchOptions) => Promise<T>;
+type HostedHeaders = HeadersInit | (() => HeadersInit | Promise<HeadersInit>);
+interface HostedFetchOptions {
   method?: string;
   headers?: HeadersInit;
   query?: Record<string, unknown>;
   body?: unknown;
   [key: string]: unknown;
 }
-interface PartnerClientOptions {
-  /**
-   * Origin API base. Use `/api` for same-origin Nitro routes, or pass a full
-   * remote origin base from the host app. The client has no baked-in origin.
-   */
+interface HostedClientOptions {
   apiBase?: string;
-  /** Convenience auth hook. Equivalent to supplying `headers: { 'x-api-key': apiKey }`. */
-  apiKey?: string;
-  /** Any ofetch-compatible instance: global `$fetch`, `useGscFetch()`, or a custom test fake. */
-  fetch?: PartnerFetch;
-  /** Static or lazy headers. Lazy headers are resolved on every operation. */
-  headers?: PartnerHeaders;
-  /** Validate request payloads and response bodies with exported Zod schemas. */
+  fetch?: HostedFetch;
+  headers?: HostedHeaders;
   validate?: boolean | 'request' | 'response';
 }
-declare function createPartnerClient(options?: PartnerClientOptions): PartnerClient$1;
-declare const createGscdumpClient: typeof createPartnerClient;
-type AnalyticsFetch = PartnerFetch;
-type AnalyticsHeaders = PartnerHeaders;
-type AnalyticsFetchOptions = PartnerFetchOptions;
-interface AnalyticsClientOptions {
+type AnalyticsFetch = HostedFetch;
+type AnalyticsHeaders = HostedHeaders;
+type AnalyticsFetchOptions = HostedFetchOptions;
+interface AnalyticsClientOptions extends HostedClientOptions {
   apiBase?: string;
   fetch?: AnalyticsFetch;
   headers?: AnalyticsHeaders;
@@ -116,234 +129,27 @@ interface DailyAnonInput {
   anonymizedImpressionsPct: number;
 }
 declare function weightedAnonPct(days: readonly DailyAnonInput[] | null | undefined, window?: number): number | null;
-/** The archetype identifiers. */
-type QueryArchetype = 'site-daily-timeseries' | 'entity-daily-timeseries' | 'entity-daily-sparkline' | 'top-n-breakdown' | 'single-row-lookup' | 'multi-series-stacked-daily' | 'two-dimension-detail' | 'arbitrary-sql' | 'aux-cloud-only';
-/**
- * Where an archetype can run.
- * - `r2-sql`     — expressible in R2 SQL directly (plain GROUP BY + aggregate).
- * - `r2-sql-resolved` — R2-SQL-expressible only AFTER the resolver pre-resolves
- *                  entity selections to a literal `IN` list (no `FROM`
- *                  subquery in R2 SQL). Archetypes 2, 3, 4.
- * - `duckdb`     — needs window functions / `QUALIFY` / `COUNT(DISTINCT)` /
- *                  `OFFSET`; server tail must use DuckDB-over-Iceberg-files.
- * - `cloud-only` — not an Iceberg query (aux data: canonicals, sitemaps,
- *                  indexing). Always served by the existing cloud endpoints.
- */
-type ArchetypeExecutionClass = 'r2-sql' | 'r2-sql-resolved' | 'duckdb' | 'cloud-only';
-/** Static execution-class tag per archetype. The server-tail router reads this. */
-declare const ARCHETYPE_EXECUTION_CLASS: Record<QueryArchetype, ArchetypeExecutionClass>;
-/** Date window every archetype query is scoped to. */
-interface DateRange {
-  /** `YYYY-MM-DD` inclusive. */
-  start: string;
-  /** `YYYY-MM-DD` inclusive. */
-  end: string;
-}
-/**
- * A post-window predicate layered onto an archetype's `WHERE` clause, on top of
- * the site/searchType/date partition. The cross-cutting facet mechanism behind
- * the dashboard's Country/Device/Brand filters:
- * - `eq`       — exact column match (e.g. `country = 'ind'`, `device = 'MOBILE'`).
- * - `regex`    — case-insensitive regex on a text column, e.g. brand
- *                classification on `query`. DuckDB `regexp_matches(LOWER(col), …)`.
- * - `notRegex` — its negation (non-brand traffic).
- *
- * `regex`/`notRegex` require DuckDB execution — R2 SQL has no regex — so the
- * router escalates any query carrying one to the `duckdb` class.
- */
-interface ArchetypeFacet {
-  column: Dimension;
-  op: 'eq' | 'regex' | 'notRegex';
-  value: string;
-}
-/** Fields common to every archetype query input. */
-interface ArchetypeQueryBase {
-  archetype: QueryArchetype;
-  siteId: string;
-  searchType: SearchType;
-  range: DateRange;
-  /**
-   * Optional prior window for YoY / period-over-period comparison. Widest
-   * supported total span is ~24 months (12-month period + YoY).
-   */
-  compareRange?: DateRange;
+import * as import__gscdump_contracts_archetypes from "@gscdump/contracts/archetypes";
+type PartnerFetch = HostedFetch;
+type PartnerHeaders = HostedHeaders;
+type PartnerFetchOptions = HostedFetchOptions;
+interface PartnerClientOptions extends HostedClientOptions {
   /**
-   * Cross-cutting Country/Device/Brand filters applied as extra `WHERE`
-   * predicates. Applied by `top-n-breakdown` and the daily-timeseries
-   * archetypes; ignored by fully-specified shapes (`single-row-lookup`).
-   */
-  facets?: readonly ArchetypeFacet[];
-}
-/**
- * Whole-site metrics grouped by date. Reads `dates`, the authoritative daily
- * total table (site totals + anonymized impressions + device pivot).
- * R2 SQL: `GROUP BY date`.
- */
-interface SiteDailyTimeseriesQuery extends ArchetypeQueryBase {
-  archetype: 'site-daily-timeseries';
-  metrics: readonly Metric[];
-}
-/**
- * Daily metrics for ONE resolved entity (a page or query). The resolver must
- * resolve `entity.value` to a literal before hitting R2 SQL.
- */
-interface EntityDailyTimeseriesQuery extends ArchetypeQueryBase {
-  archetype: 'entity-daily-timeseries';
-  entity: {
-    dimension: Extract<Dimension, 'page' | 'query'>;
-    value: string;
-  };
-  metrics: readonly Metric[];
-}
-/**
- * Compact daily series for the top-N entities at once (sparkline column in a
- * table). Resolver pre-resolves the top-N entity list to a literal `IN`.
- */
-interface EntityDailySparklineQuery extends ArchetypeQueryBase {
-  archetype: 'entity-daily-sparkline';
-  dimension: Extract<Dimension, 'page' | 'query' | 'queryCanonical'>;
-  /** Entity values already resolved by the resolver layer. */
-  entities: readonly string[];
-  /** Single metric the sparkline plots. */
-  metric: Metric;
-}
-/**
- * Ranked breakdown over one dimension. `GROUP BY` + `ORDER BY` + `LIMIT`.
- * Device breakdowns read the wide `dates` table and unpivot its device columns
- * (`clicks_desktop`, `impressions_mobile`, etc.) at query time.
- * `offset` pagination is UNVERIFIED in R2 SQL (POC) — when set, the router
- * may escalate to `duckdb`.
- */
-interface TopNBreakdownQuery extends ArchetypeQueryBase {
-  archetype: 'top-n-breakdown';
-  dimension: Dimension;
-  metrics: readonly Metric[];
-  /** Sort column + direction. */
-  orderBy: {
-    metric: Metric;
-    dir: 'asc' | 'desc';
-  };
-  limit: number;
-  /** Pagination offset. Non-zero may force `duckdb` execution. */
-  offset?: number;
-  /**
-   * Request the full unwindowed group count (`meta.totalRows`) so paginated /
-   * load-more tables know how many rows exist beyond the current `limit`.
-   * Computed as `COUNT(*) OVER()` over the grouped result, which requires a
-   * window function — so a query with `includeTotal` is escalated to `duckdb`
-   * on the server tail (R2 SQL cannot express it). Not honoured for the
-   * `device` dimension, which has at most a handful of rows.
-   */
-  includeTotal?: boolean;
-  /**
-   * Movers mode — re-rank the breakdown by period-over-period movement instead
-   * of by `orderBy`. Requires `compareRange` (the previous-period CTE supplies
-   * the deltas); ignored without it. Forces `duckdb` on the server tail (CTE +
-   * FULL OUTER JOIN). Used by the dashboard's Growing/Declining/New/Lost lists.
-   *  - `improving` — clicks gained vs previous, largest gain first.
-   *  - `declining` — clicks lost vs previous, largest drop first.
-   *  - `new`       — impressions appeared (zero previously), by current volume.
-   *  - `lost`      — impressions disappeared (zero now), by previous volume.
+   * Origin API base. Use `/api` for same-origin Nitro routes, or pass a full
+   * remote origin base from the host app. The client has no baked-in origin.
    */
-  movers?: 'improving' | 'declining' | 'new' | 'lost';
-}
-/** One aggregated row for a fully-specified filter. `WHERE` + `GROUP BY`. */
-interface SingleRowLookupQuery extends ArchetypeQueryBase {
-  archetype: 'single-row-lookup';
-  /** Exact dimension-value filters identifying the row. */
-  match: Partial<Record<Dimension, string>>;
-  metrics: readonly Metric[];
-}
-/**
- * Daily metrics split by a secondary dimension. `GROUP BY date, <dim>`.
- * Device split charts read `dates` and unpivot the wide device columns.
- */
-interface MultiSeriesStackedDailyQuery extends ArchetypeQueryBase {
-  archetype: 'multi-series-stacked-daily';
-  /** The series dimension, e.g. `device` or `country`. */
-  seriesDimension: Dimension;
-  metric: Metric;
-}
-/**
- * The whale archetype — `page_queries` grouped by `(url, query)`. The query ×
- * page cross no longer reads the retired `page_keywords` table name. This is
- * the reason the server tail exists. R2-SQL-expressible
- * (`GROUP BY url, query`).
- */
-interface TwoDimensionDetailQuery extends ArchetypeQueryBase {
-  archetype: 'two-dimension-detail';
-  metrics: readonly Metric[];
-  /** Optional page or query prefilter to narrow the cross. */
-  filter?: {
-    page?: string;
-    query?: string;
-  };
-  orderBy?: {
-    metric: Metric;
-    dir: 'asc' | 'desc';
-  };
-  limit?: number;
-}
-/**
- * Escape hatch — caller-supplied SQL (moving averages, ranks, window
- * functions). ALWAYS `duckdb` on the server tail; R2 SQL cannot express it.
- * In the browser, runs against the attached DuckDB-WASM views directly.
- */
-interface ArbitrarySqlQuery extends ArchetypeQueryBase {
-  archetype: 'arbitrary-sql';
-  /** SQL referencing the attached table views by their `IcebergTableName`. */
-  sql: string;
-  params?: readonly unknown[];
-}
-/**
- * Non-fact-table data: canonicals, sitemaps, indexing status. Not an Iceberg
- * query — served by the existing cloud endpoints. Present in the union so the
- * archetype router can recognise and route it without a special case.
- */
-interface AuxCloudOnlyQuery {
-  archetype: 'aux-cloud-only';
-  siteId: string;
-  /** Which aux dataset. */
-  dataset: 'canonicals' | 'sitemaps' | 'indexing';
-  params?: Record<string, unknown>;
-}
-/** Discriminated union of every archetype query input. */
-type ArchetypeQuery = SiteDailyTimeseriesQuery | EntityDailyTimeseriesQuery | EntityDailySparklineQuery | TopNBreakdownQuery | SingleRowLookupQuery | MultiSeriesStackedDailyQuery | TwoDimensionDetailQuery | ArbitrarySqlQuery | AuxCloudOnlyQuery;
-/** A single result row — dimension values plus metric values, all flat. */
-type ArchetypeResultRow = Record<string, string | number | null>;
-/** Where the result was actually computed (for diagnostics + UX). */
-type ArchetypeResultSource = 'browser' | 'server-r2-sql' | 'server-duckdb' | 'cloud';
-/** Uniform result envelope returned for any archetype. */
-interface ArchetypeResult<R extends ArchetypeResultRow = ArchetypeResultRow> {
-  archetype: QueryArchetype;
-  rows: R[];
-  source: ArchetypeResultSource;
-  meta?: {
-    rowCount: number;
-    queryMs: number;
-    /**
-     * Full unwindowed group count for a `top-n-breakdown` requested with
-     * `includeTotal`. Independent of `limit`/`offset`; lets paginated tables
-     * show "X of Y" and stop loading. Undefined when not requested.
-     */
-    totalRows?: number; /** Set when `compareRange` was supplied — the comparison-period rows. */
-    compareRows?: R[];
-    truncated?: boolean;
-  };
-}
-/**
- * Bridge: an archetype query also carries (or resolves to) a `BuilderState`,
- * so the existing query-resolver / `buildLogicalPlan` path stays the executor.
- * The resolver layer attaches this. Implementation agents: DO NOT bypass
- * `BuilderState` — the archetype is the typed front door, `BuilderState` the
- * shared backend.
- */
-interface ResolvedArchetypeQuery {
-  query: ArchetypeQuery;
-  /** Undefined only for `aux-cloud-only`, which has no `BuilderState`. */
-  builder?: BuilderState$1;
-  executionClass: ArchetypeExecutionClass;
+  apiBase?: string;
+  /** Convenience auth hook. Equivalent to supplying `headers: { 'x-api-key': apiKey }`. */
+  apiKey?: string;
+  /** Any ofetch-compatible instance: global `$fetch`, `useGscFetch()`, or a custom test fake. */
+  fetch?: PartnerFetch;
+  /** Static or lazy headers. Lazy headers are resolved on every operation. */
+  headers?: PartnerHeaders;
+  /** Validate request payloads and response bodies with exported Zod schemas. */
+  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;
@@ -366,31 +172,6 @@ declare function splitOpportunityTitle(title: string): Array<{
   text: string;
   highlight: boolean;
 }>;
-type PartnerErrorKind = 'auth' | 'rate-limit' | 'provisioning' | 'permission' | 'network' | 'validation' | 'not-found' | 'server' | 'unknown';
-interface PartnerErrorInfo {
-  kind: PartnerErrorKind;
-  statusCode?: number;
-  message: string;
-  data?: unknown;
-}
-declare class PartnerApiError extends Error {
-  readonly kind: PartnerErrorKind;
-  readonly statusCode?: number;
-  readonly data?: unknown;
-  constructor(info: PartnerErrorInfo);
-}
-declare function toPartnerError(error: unknown): PartnerApiError;
-/** Narrow an unknown error to the modelled `PartnerApiError`. */
-declare function isPartnerError(error: unknown): error is PartnerApiError;
-/** Human-readable, log-friendly rendering of a modelled partner failure. */
-declare function formatPartnerError(error: PartnerApiError): string;
-/**
- * Re-raise a modelled `PartnerApiError` as itself. The error variant of every
- * `*Result` core already IS the throwable `PartnerApiError`, so the throwing
- * wrappers preserve the exact identity/message existing call sites and tests
- * assert (`rejects.toThrow(PartnerApiError)`, `toThrow('Invalid webhook signature')`).
- */
-declare function partnerErrorToException(error: PartnerApiError): PartnerApiError;
 interface GscConsoleUrlOpts {
   /** The GSC property — either `sc-domain:example.com` or a URL-prefix. */
   siteLabel: string;
@@ -929,4 +710,24 @@ 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;
+type ArchetypeQuery = import__gscdump_contracts_archetypes.ArchetypeQuery;
+type ArchetypeQueryBase = import__gscdump_contracts_archetypes.ArchetypeQueryBase;
+type ArchetypeResult = import__gscdump_contracts_archetypes.ArchetypeResult;
+type ArchetypeResultRow = import__gscdump_contracts_archetypes.ArchetypeResultRow;
+type ArchetypeResultSource = import__gscdump_contracts_archetypes.ArchetypeResultSource;
+type AuxCloudOnlyQuery = import__gscdump_contracts_archetypes.AuxCloudOnlyQuery;
+type DateRange = import__gscdump_contracts_archetypes.DateRange;
+type EntityDailySparklineQuery = import__gscdump_contracts_archetypes.EntityDailySparklineQuery;
+type EntityDailyTimeseriesQuery = import__gscdump_contracts_archetypes.EntityDailyTimeseriesQuery;
+type MultiSeriesStackedDailyQuery = import__gscdump_contracts_archetypes.MultiSeriesStackedDailyQuery;
+type QueryArchetype = import__gscdump_contracts_archetypes.QueryArchetype;
+type ResolvedArchetypeQuery = import__gscdump_contracts_archetypes.ResolvedArchetypeQuery;
+type SingleRowLookupQuery = import__gscdump_contracts_archetypes.SingleRowLookupQuery;
+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 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 };

package/dist/index.mjs

@@ -1,9 +1,12 @@
+import { __exportAll, __reExport } from "./_chunks/chunk.mjs";
 import { query_exports } from "./query.mjs";
-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, analyticsRoutes, partnerEndpointSchemas, partnerRoutes, partnerWebhookEnvelopeSchema } from "@gscdump/contracts";
+import { analyticsEndpointSchemas, analyticsRoutes } from "@gscdump/contracts/analytics";
 import { err, ok, unwrapResult } from "gscdump/result";
 import { ofetch } from "ofetch";
+import { partnerEndpointSchemas, partnerRoutes } 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";
 var PartnerApiError = class extends Error {
 	kind;
@@ -58,30 +61,56 @@ function formatPartnerError(error) {
 function partnerErrorToException(error) {
 	return error;
 }
-const TRAILING_SLASH_RE$2 = /\/+$/;
-const LEADING_SLASH_RE$1 = /^\/+/;
-const DEFAULT_SEARCH_TYPE$1 = "web";
-function trimApiBase$1(apiBase) {
-	return (apiBase ?? "").replace(TRAILING_SLASH_RE$2, "");
+const TRAILING_SLASH_RE$1 = /\/+$/;
+const LEADING_SLASH_RE = /^\/+/;
+function trimApiBase(apiBase, fallback) {
+	return (apiBase ?? fallback).replace(TRAILING_SLASH_RE$1, "");
 }
-function buildPath$1(apiBase, path) {
+function buildPath(apiBase, path) {
 	if (!apiBase) return path.startsWith("/") ? path : `/${path}`;
-	return `${apiBase}/${path.replace(LEADING_SLASH_RE$1, "")}`;
+	return `${apiBase}/${path.replace(LEADING_SLASH_RE, "")}`;
 }
-function mergeHeaders$1(base, extra) {
+function mergeHeaders(base, extra) {
 	const headers = new Headers(base);
 	if (extra) for (const [key, value] of new Headers(extra).entries()) headers.set(key, value);
 	return headers;
 }
-async function resolveHeaders$1(options) {
-	return typeof options.headers === "function" ? await options.headers() : options.headers;
+async function resolveHeaders(options) {
+	const resolved = typeof options.headers === "function" ? await options.headers() : options.headers;
+	if (!options.apiKey) return resolved;
+	return mergeHeaders(resolved, { "x-api-key": options.apiKey });
 }
-function shouldValidate$1(options, phase) {
+function shouldValidate(options, phase) {
 	return options.validate === true || options.validate === phase;
 }
-function parseWith$1(schema, value) {
+function parseWith(schema, value) {
 	return schema ? schema.parse(value) : value;
 }
+function createHostedRequester(options, defaults) {
+	const fetchImpl = options.fetch ?? ofetch;
+	const apiBase = trimApiBase(options.apiBase, defaults.apiBase);
+	async function requestResult(path, init = {}, responseSchema) {
+		const headers = mergeHeaders(await resolveHeaders(options), init.headers);
+		try {
+			const out = await fetchImpl(buildPath(apiBase, path), {
+				...init,
+				headers
+			});
+			return ok(shouldValidate(options, "response") ? parseWith(responseSchema, out) : out);
+		} catch (error) {
+			return err(toPartnerError(error));
+		}
+	}
+	async function request(path, init = {}, responseSchema) {
+		return unwrapResult(await requestResult(path, init, responseSchema), partnerErrorToException);
+	}
+	return {
+		request,
+		requestResult,
+		shouldValidate: (phase) => shouldValidate(options, phase)
+	};
+}
+const DEFAULT_SEARCH_TYPE$1 = "web";
 function isAnalysisSourcesOptions$1(value) {
 	return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -129,35 +158,19 @@ function indexingUrlsQuery$1(params = {}) {
 	return query;
 }
 function createAnalyticsClient(options = {}) {
-	const fetchImpl = options.fetch ?? ofetch;
-	const apiBase = trimApiBase$1(options.apiBase);
-	async function requestResult(path, init = {}, responseSchema) {
-		const headers = mergeHeaders$1(await resolveHeaders$1(options), init.headers);
-		try {
-			const out = await fetchImpl(buildPath$1(apiBase, path), {
-				...init,
-				headers
-			});
-			return ok(shouldValidate$1(options, "response") ? parseWith$1(responseSchema, out) : out);
-		} catch (error) {
-			return err(toPartnerError(error));
-		}
-	}
-	async function request(path, init = {}, responseSchema) {
-		return unwrapResult(await requestResult(path, init, responseSchema), partnerErrorToException);
-	}
+	const { request, shouldValidate } = createHostedRequester(options, { apiBase: "" });
 	return {
 		whoami() {
-			return request(analyticsRoutes.whoami, {}, partnerEndpointSchemas.analyticsWhoami.response);
+			return request(analyticsRoutes.whoami, {}, analyticsEndpointSchemas.analyticsWhoami.response);
 		},
 		listSites() {
-			return request(analyticsRoutes.sites, {}, partnerEndpointSchemas.analyticsSites.response);
+			return request(analyticsRoutes.sites, {}, analyticsEndpointSchemas.analyticsSites.response);
 		},
 		getSourceInfo(siteId, options) {
-			return request(analyticsRoutes.site.sourceInfo(siteId), { query: sourceInfoQuery(options) }, partnerEndpointSchemas.analyticsSourceInfo.response);
+			return request(analyticsRoutes.site.sourceInfo(siteId), { query: sourceInfoQuery(options) }, analyticsEndpointSchemas.analyticsSourceInfo.response);
 		},
 		getAnalysisSources(siteId, tables, options) {
-			return request(analyticsRoutes.site.analysisSources(siteId), { query: tablesQuery$1(tables, options) }, partnerEndpointSchemas.analyticsAnalysisSources.response);
+			return request(analyticsRoutes.site.analysisSources(siteId), { query: tablesQuery$1(tables, options) }, analyticsEndpointSchemas.analyticsAnalysisSources.response);
 		},
 		analyze(siteId, params) {
 			return request(analyticsRoutes.site.analyze(siteId), {
@@ -169,51 +182,51 @@ function createAnalyticsClient(options = {}) {
 			return request(analyticsRoutes.site.rows(siteId), {
 				method: "POST",
 				body: withDefaultSearchType$1(state)
-			}, partnerEndpointSchemas.analyticsRows.response);
+			}, analyticsEndpointSchemas.analyticsRows.response);
 		},
 		getRollup(siteId, rollupId, params) {
-			return request(analyticsRoutes.site.rollup(siteId, rollupId), { query: params }, partnerEndpointSchemas.analyticsRollup.response);
+			return request(analyticsRoutes.site.rollup(siteId, rollupId), { query: params }, analyticsEndpointSchemas.analyticsRollup.response);
 		},
 		requestBackfill(siteId, range) {
-			const body = shouldValidate$1(options, "request") ? partnerEndpointSchemas.analyticsBackfill.body.parse(range) : range;
+			const body = shouldValidate("request") ? analyticsEndpointSchemas.analyticsBackfill.body.parse(range) : range;
 			return request(analyticsRoutes.site.backfill(siteId), {
 				method: "POST",
 				body
-			}, partnerEndpointSchemas.analyticsBackfill.response);
+			}, analyticsEndpointSchemas.analyticsBackfill.response);
 		},
 		getSitemaps(siteId) {
-			return request(analyticsRoutes.site.sitemaps(siteId), {}, partnerEndpointSchemas.analyticsSitemaps.response);
+			return request(analyticsRoutes.site.sitemaps(siteId), {}, analyticsEndpointSchemas.analyticsSitemaps.response);
 		},
 		getSitemapHistory(siteId, hash) {
-			return request(analyticsRoutes.site.sitemapHistory(siteId, hash), {}, partnerEndpointSchemas.analyticsSitemapHistory.response);
+			return request(analyticsRoutes.site.sitemapHistory(siteId, hash), {}, analyticsEndpointSchemas.analyticsSitemapHistory.response);
 		},
 		getSitemapChanges(siteId, params = {}) {
-			return request(analyticsRoutes.site.sitemapChanges(siteId), { query: params }, partnerEndpointSchemas.analyticsSitemapChanges.response);
+			return request(analyticsRoutes.site.sitemapChanges(siteId), { query: params }, analyticsEndpointSchemas.analyticsSitemapChanges.response);
 		},
 		getInspections(siteId) {
-			return request(analyticsRoutes.site.inspections(siteId), {}, partnerEndpointSchemas.analyticsInspections.response);
+			return request(analyticsRoutes.site.inspections(siteId), {}, analyticsEndpointSchemas.analyticsInspections.response);
 		},
 		getInspectionHistory(siteId, hash) {
-			return request(analyticsRoutes.site.inspectionHistory(siteId, hash), {}, partnerEndpointSchemas.analyticsInspectionHistory.response);
+			return request(analyticsRoutes.site.inspectionHistory(siteId, hash), {}, analyticsEndpointSchemas.analyticsInspectionHistory.response);
 		},
 		getIndexingUrls(siteId, params = {}) {
-			return request(analyticsRoutes.site.indexingUrls(siteId), { query: indexingUrlsQuery$1(params) }, partnerEndpointSchemas.analyticsIndexingUrls.response);
+			return request(analyticsRoutes.site.indexingUrls(siteId), { query: indexingUrlsQuery$1(params) }, analyticsEndpointSchemas.analyticsIndexingUrls.response);
 		},
 		getIndexingDiagnostics(siteId) {
-			return request(analyticsRoutes.site.indexingDiagnostics(siteId), {}, partnerEndpointSchemas.analyticsIndexingDiagnostics.response);
+			return request(analyticsRoutes.site.indexingDiagnostics(siteId), {}, analyticsEndpointSchemas.analyticsIndexingDiagnostics.response);
 		},
 		requestIndexingInspect(siteId, body) {
-			const parsed = shouldValidate$1(options, "request") ? partnerEndpointSchemas.analyticsIndexingInspect.body.parse(body) : body;
+			const parsed = shouldValidate("request") ? analyticsEndpointSchemas.analyticsIndexingInspect.body.parse(body) : body;
 			return request(analyticsRoutes.site.indexingInspect(siteId), {
 				method: "POST",
 				body: parsed
-			}, partnerEndpointSchemas.analyticsIndexingInspect.response);
+			}, analyticsEndpointSchemas.analyticsIndexingInspect.response);
 		},
 		getCountries(siteId, range) {
-			return request(analyticsRoutes.site.countries(siteId), { query: range }, partnerEndpointSchemas.analyticsCountries.response);
+			return request(analyticsRoutes.site.countries(siteId), { query: range }, analyticsEndpointSchemas.analyticsCountries.response);
 		},
 		getSearchAppearance(siteId, range) {
-			return request(analyticsRoutes.site.searchAppearance(siteId), { query: range }, partnerEndpointSchemas.analyticsSearchAppearance.response);
+			return request(analyticsRoutes.site.searchAppearance(siteId), { query: range }, analyticsEndpointSchemas.analyticsSearchAppearance.response);
 		}
 	};
 }
@@ -231,17 +244,9 @@ function weightedAnonPct(days, window = 28) {
 	}
 	return totalImpressions > 0 ? weighted / totalImpressions : null;
 }
-const ARCHETYPE_EXECUTION_CLASS = {
-	"site-daily-timeseries": "r2-sql",
-	"entity-daily-timeseries": "r2-sql-resolved",
-	"entity-daily-sparkline": "r2-sql-resolved",
-	"top-n-breakdown": "r2-sql-resolved",
-	"single-row-lookup": "r2-sql",
-	"multi-series-stacked-daily": "r2-sql",
-	"two-dimension-detail": "r2-sql",
-	"arbitrary-sql": "duckdb",
-	"aux-cloud-only": "cloud-only"
-};
+var archetypes_exports = /* @__PURE__ */ __exportAll({});
+import * as import__gscdump_contracts_archetypes from "@gscdump/contracts/archetypes";
+__reExport(archetypes_exports, import__gscdump_contracts_archetypes);
 function normalizeLifecycleUrl(url) {
 	return (url || "").replace(/^sc-domain:/, "").replace(/^https?:\/\//, "").replace(/^www\./, "").replace(/\/$/, "").toLowerCase();
 }
@@ -325,26 +330,7 @@ function findLifecycleSite(lifecycle, siteIdOrPropertyUrl) {
 	const propertyKey = normalizeGscPropertyKey(siteIdOrPropertyUrl);
 	return lifecycle.sites.find((site) => site.siteId === siteIdOrPropertyUrl || site.externalSiteId === siteIdOrPropertyUrl || !!propertyKey && normalizeGscPropertyKey(site.gscPropertyUrl) === propertyKey || !site.gscPropertyUrl && normalizeLifecycleUrl(site.requestedUrl) === normalized || !propertyKey && normalizeLifecycleUrl(site.requestedUrl) === normalized) ?? null;
 }
-const TRAILING_SLASH_RE$1 = /\/+$/;
-const LEADING_SLASH_RE = /^\/+/;
 const DEFAULT_SEARCH_TYPE = "web";
-function trimApiBase(apiBase) {
-	return (apiBase ?? "/api").replace(TRAILING_SLASH_RE$1, "");
-}
-function buildPath(apiBase, path) {
-	if (!apiBase) return `/${path.replace(LEADING_SLASH_RE, "")}`;
-	return `${apiBase}/${path.replace(LEADING_SLASH_RE, "")}`;
-}
-function mergeHeaders(base, extra) {
-	const headers = new Headers(base);
-	if (extra) for (const [key, value] of new Headers(extra).entries()) headers.set(key, value);
-	return headers;
-}
-async function resolveHeaders(options) {
-	const resolved = typeof options.headers === "function" ? await options.headers() : options.headers;
-	if (!options.apiKey) return resolved;
-	return mergeHeaders(resolved, { "x-api-key": options.apiKey });
-}
 function withDefaultSearchType(state, searchType) {
 	const scoped = state;
 	return {
@@ -452,33 +438,11 @@ function pageTrendQuery(params) {
 	if (params.prevEndDate) query.prevEndDate = params.prevEndDate;
 	return query;
 }
-function shouldValidate(options, phase) {
-	return options.validate === true || options.validate === phase;
-}
-function parseWith(schema, value) {
-	return schema ? schema.parse(value) : value;
-}
 function sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function createPartnerClient(options = {}) {
-	const fetchImpl = options.fetch ?? ofetch;
-	const apiBase = trimApiBase(options.apiBase);
-	async function requestResult(path, init = {}, responseSchema) {
-		const headers = mergeHeaders(await resolveHeaders(options), init.headers);
-		try {
-			const out = await fetchImpl(buildPath(apiBase, path), {
-				...init,
-				headers
-			});
-			return ok(shouldValidate(options, "response") ? parseWith(responseSchema, out) : out);
-		} catch (error) {
-			return err(toPartnerError(error));
-		}
-	}
-	async function request(path, init = {}, responseSchema) {
-		return unwrapResult(await requestResult(path, init, responseSchema), partnerErrorToException);
-	}
+	const { request, requestResult, shouldValidate } = createHostedRequester(options, { apiBase: "/api" });
 	async function waitForUserReadyResult(userId, waitOptions = {}) {
 		const attempts = waitOptions.attempts ?? 12;
 		const intervalMs = waitOptions.intervalMs ?? 1e3;
@@ -551,14 +515,14 @@ function createPartnerClient(options = {}) {
 	}
 	return {
 		registerUser(params) {
-			const body = shouldValidate(options, "request") ? partnerEndpointSchemas.registerUser.body.parse(params) : params;
+			const body = shouldValidate("request") ? partnerEndpointSchemas.registerUser.body.parse(params) : params;
 			return request(partnerRoutes.users.register, {
 				method: "POST",
 				body
 			}, partnerEndpointSchemas.registerUser.response);
 		},
 		updateUserTokens(userId, params) {
-			const body = shouldValidate(options, "request") ? partnerEndpointSchemas.updateUserTokens.body.parse(params) : params;
+			const body = shouldValidate("request") ? partnerEndpointSchemas.updateUserTokens.body.parse(params) : params;
 			return request(partnerRoutes.users.tokens(userId), {
 				method: "PATCH",
 				body
@@ -583,14 +547,14 @@ function createPartnerClient(options = {}) {
 			return request(partnerRoutes.users.availableSites(userId), {}, partnerEndpointSchemas.getAvailableSites.response);
 		},
 		registerSite(params) {
-			const body = shouldValidate(options, "request") ? partnerEndpointSchemas.registerSite.body.parse(params) : params;
+			const body = shouldValidate("request") ? partnerEndpointSchemas.registerSite.body.parse(params) : params;
 			return request(partnerRoutes.partner.sites.register, {
 				method: "POST",
 				body
 			}, partnerEndpointSchemas.registerSite.response);
 		},
 		bulkRegisterSites(params) {
-			const body = shouldValidate(options, "request") ? partnerEndpointSchemas.bulkRegisterSites.body.parse(params) : params;
+			const body = shouldValidate("request") ? partnerEndpointSchemas.bulkRegisterSites.body.parse(params) : params;
 			return request(partnerRoutes.partner.sites.bulkRegister, {
 				method: "POST",
 				body
@@ -609,14 +573,14 @@ function createPartnerClient(options = {}) {
 			return unwrapResult(await getSiteSyncStatusResult(siteId, userId), partnerErrorToException);
 		},
 		getData(siteId, state, queryOptions) {
-			if (shouldValidate(options, "request")) {
+			if (shouldValidate("request")) {
 				partnerEndpointSchemas.getData.state.parse(state);
 				partnerEndpointSchemas.getData.options.parse(queryOptions);
 			}
 			return request(partnerRoutes.sites.data(siteId), { query: dataQuery(state, queryOptions) }, partnerEndpointSchemas.getData.response);
 		},
 		getDataDetail(siteId, state, queryOptions) {
-			if (shouldValidate(options, "request")) {
+			if (shouldValidate("request")) {
 				partnerEndpointSchemas.getDataDetail.state.parse(state);
 				partnerEndpointSchemas.getDataDetail.options.parse(queryOptions);
 			}
@@ -624,7 +588,7 @@ function createPartnerClient(options = {}) {
 		},
 		getAnalysis(siteId, params) {
 			assertAnalysisParams(params);
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getAnalysis.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getAnalysis.query.parse(params) : params;
 			return request(partnerRoutes.sites.analysis(siteId), { query: analysisQuery(query) }, partnerEndpointSchemas.getAnalysis.response);
 		},
 		getSitemaps(siteId) {
@@ -652,14 +616,14 @@ function createPartnerClient(options = {}) {
 			return request(partnerRoutes.sites.indexing(siteId), { query: { days } }, partnerEndpointSchemas.getIndexing.response);
 		},
 		getIndexingUrls(siteId, params = {}) {
-			const parsed = shouldValidate(options, "request") ? partnerEndpointSchemas.getIndexingUrls.query.parse(params) : params;
+			const parsed = shouldValidate("request") ? partnerEndpointSchemas.getIndexingUrls.query.parse(params) : params;
 			return request(partnerRoutes.sites.indexingUrls(siteId), { query: indexingUrlsQuery(parsed) }, partnerEndpointSchemas.getIndexingUrls.response);
 		},
 		getIndexingDiagnostics(siteId) {
 			return request(partnerRoutes.sites.indexingDiagnostics(siteId), {}, partnerEndpointSchemas.getIndexingDiagnostics.response);
 		},
 		requestIndexingInspect(siteId, body) {
-			const parsed = shouldValidate(options, "request") ? partnerEndpointSchemas.getIndexingInspect.body.parse(body) : body;
+			const parsed = shouldValidate("request") ? partnerEndpointSchemas.getIndexingInspect.body.parse(body) : body;
 			return request(partnerRoutes.sites.indexingInspect(siteId), {
 				method: "POST",
 				body: parsed
@@ -669,7 +633,7 @@ function createPartnerClient(options = {}) {
 			return request(partnerRoutes.settings.user, {}, partnerEndpointSchemas.getUserSettings.response);
 		},
 		patchUserSettings(body) {
-			const parsed = shouldValidate(options, "request") ? partnerEndpointSchemas.patchUserSettings.body.parse(body) : body;
+			const parsed = shouldValidate("request") ? partnerEndpointSchemas.patchUserSettings.body.parse(body) : body;
 			return request(partnerRoutes.settings.user, {
 				method: "PATCH",
 				body: parsed
@@ -679,7 +643,7 @@ function createPartnerClient(options = {}) {
 			return request(partnerRoutes.sites.recoverPermission(siteId), { method: "POST" }, partnerEndpointSchemas.recoverPermission.response);
 		},
 		getTopAssociation(siteId, params) {
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getTopAssociation.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getTopAssociation.query.parse(params) : params;
 			return request(partnerRoutes.sites.topAssociation(siteId), { query }, partnerEndpointSchemas.getTopAssociation.response);
 		},
 		getKeywordSparklines(siteId, params) {
@@ -687,18 +651,18 @@ function createPartnerClient(options = {}) {
 				...params,
 				searchType: params.searchType ?? DEFAULT_SEARCH_TYPE
 			};
-			const body = shouldValidate(options, "request") ? partnerEndpointSchemas.getKeywordSparklines.body.parse(withSearchType) : withSearchType;
+			const body = shouldValidate("request") ? partnerEndpointSchemas.getKeywordSparklines.body.parse(withSearchType) : withSearchType;
 			return request(partnerRoutes.sites.keywordSparklines(siteId), {
 				method: "POST",
 				body
 			}, partnerEndpointSchemas.getKeywordSparklines.response);
 		},
 		getQueryTrend(siteId, params) {
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getQueryTrend.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getQueryTrend.query.parse(params) : params;
 			return request(partnerRoutes.sites.queryTrend(siteId), { query: queryTrendQuery(query) }, partnerEndpointSchemas.getQueryTrend.response);
 		},
 		getPageTrend(siteId, params) {
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getPageTrend.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getPageTrend.query.parse(params) : params;
 			return request(partnerRoutes.sites.pageTrend(siteId), { query: pageTrendQuery(query) }, partnerEndpointSchemas.getPageTrend.response);
 		},
 		getCanonicalMismatches(siteId) {
@@ -708,31 +672,31 @@ function createPartnerClient(options = {}) {
 			return request(partnerRoutes.sites.contentVelocity(siteId), { query: days == null ? void 0 : { days } });
 		},
 		getCtrCurve(siteId, params) {
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
 			return request(partnerRoutes.sites.ctrCurve(siteId), { query: dateRangeQuery(query) });
 		},
 		getDarkTraffic(siteId, params) {
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
 			return request(partnerRoutes.sites.darkTraffic(siteId), { query: dateRangeQuery(query) });
 		},
 		getDeviceGap(siteId, params) {
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
 			return request(partnerRoutes.sites.deviceGap(siteId), { query: dateRangeQuery(query) });
 		},
 		getIndexPercent(siteId, params = {}) {
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getIndexPercent.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getIndexPercent.query.parse(params) : params;
 			return request(partnerRoutes.sites.indexPercent(siteId), { query }, partnerEndpointSchemas.getIndexPercent.response);
 		},
 		getKeywordBreadth(siteId, params) {
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
 			return request(partnerRoutes.sites.keywordBreadth(siteId), { query: dateRangeQuery(query) });
 		},
 		getPositionDistribution(siteId, params) {
-			const query = shouldValidate(options, "request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
+			const query = shouldValidate("request") ? partnerEndpointSchemas.getDateRangeInsight.query.parse(params) : params;
 			return request(partnerRoutes.sites.positionDistribution(siteId), { query: dateRangeQuery(query) });
 		},
 		createTeam(params) {
-			const body = shouldValidate(options, "request") ? partnerEndpointSchemas.createTeam.body.parse(params) : params;
+			const body = shouldValidate("request") ? partnerEndpointSchemas.createTeam.body.parse(params) : params;
 			return request(partnerRoutes.teams.create, {
 				method: "POST",
 				body
@@ -751,7 +715,7 @@ function createPartnerClient(options = {}) {
 			return request(partnerRoutes.teams.members(teamId), {}, partnerEndpointSchemas.listTeamMembers.response);
 		},
 		addTeamMember(teamId, params) {
-			const body = shouldValidate(options, "request") ? partnerEndpointSchemas.addTeamMember.body.parse(params) : params;
+			const body = shouldValidate("request") ? partnerEndpointSchemas.addTeamMember.body.parse(params) : params;
 			return request(partnerRoutes.teams.members(teamId), {
 				method: "POST",
 				body
@@ -767,7 +731,7 @@ function createPartnerClient(options = {}) {
 			return request(partnerRoutes.teams.member(teamId, userId), { method: "DELETE" });
 		},
 		bindSiteToTeam(userId, siteId, params) {
-			const body = shouldValidate(options, "request") ? partnerEndpointSchemas.bindSiteToTeam.body.parse(params) : params;
+			const body = shouldValidate("request") ? partnerEndpointSchemas.bindSiteToTeam.body.parse(params) : params;
 			return request(partnerRoutes.partner.users.siteTeam(userId, siteId), {
 				method: "PATCH",
 				body
@@ -2289,4 +2253,5 @@ 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 };

package/package.json

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