@gscdump/contracts 3.4.4 → 3.6.0

package/README.md

@@ -2,33 +2,23 @@
 
 Shared protocol contracts for gscdump.com integrations.
 
-> The executable public v1 registry is exported from
-> `@gscdump/contracts/v1`. Existing root route/endpoint exports still describe
-> the legacy host during the release and cutover overlap. See the
-> [integration guide](../../docs/guides/hosted-v1.md),
-> [v1 contract](../../docs/hosted-api-v1.md), and
-> [producer inventory](../../docs/hosted-api-inventory.md).
+Use `@gscdump/contracts/v1` for operation definitions, request and response schemas, and protocol constants.
+The registry describes 55 HTTP operations and the realtime protocol.
+For HTTP calls, install [`@gscdump/sdk`](../sdk/README.md).
 
-This package contains types, route metadata, Zod schemas, shared storage/query
-primitives, event names, and contract versions. It has no HTTP client, no
-websocket client, no queueing, and no producer behavior.
-
-Used by:
-
-- `@gscdump/sdk` for consuming gscdump.com
-- gscdump.com route/webhook/realtime contract tests
-- CLI and MCP integrations that need protocol validation
+```bash
+npm install @gscdump/contracts
+```
 
-Producer behavior such as DB reads, auth, queues, webhook delivery, retries,
-and storage remains in gscdump.com.
+The root also exports shared types and legacy route metadata.
+Use the [v1 guide](../../docs/guides/hosted-v1.md) for new integrations.
+The [producer inventory](../../docs/hosted-api-inventory.md) records remaining legacy mismatches.
 
-## Public v1 bar
+## Operation contracts
 
-Each public operation has one executable descriptor covering its
-surface/version, method/path, query or mutation semantics, credential classes,
-static scopes, ownership policy, request/response schemas, consistency,
-idempotency, and errors. V1 has no schema-less descriptor and no two logical
-operations sharing an ambiguous method/path.
+Each operation has one descriptor with its method, path, schemas, credentials, scopes, ownership rules, consistency, and retry behavior.
+Descriptors distinguish queries from mutations independently of HTTP method.
+Every public operation has schemas and a unique method/path pair.
 
 Response object schemas are additive for consumers: parsers accept unknown
 object keys while validating known fields. Producer contract tests remain
@@ -36,7 +26,7 @@ strict against the documented current schema, and enum values remain closed.
 Every `user_key` query declares primary read consistency with no caller
 override.
 
-Framework adapters use the registry mechanics exported from
+Framework adapters use
 `@gscdump/contracts/v1/http`:
 
 - `listHttpOperations(protocol)` produces the canonical surface/operation
@@ -45,8 +35,8 @@ Framework adapters use the registry mechanics exported from
   and surface-relative path; it decodes and parses path parameters through the
   descriptor, rejects unsafe segments, and returns the canonical path.
 
-Consumer authorization stays app-owned. A browser proxy selects its explicit
-operation-ID allowlist, then passes only those entries to the resolver.
+Your application owns authorization.
+A browser proxy must pass only its allowed operations to the resolver.
 
 Consumers that only need operation metadata and paths can avoid the schema
 runtime:

package/dist/archetypes.d.mts

@@ -1,18 +1,18 @@
 import { GscSearchType } from "./search-types.mjs";
 import { BuilderStateWire, Dimension, Metric } from "./types.mjs";
-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';
-type ArchetypeExecutionClass = 'r2-sql' | 'r2-sql-resolved' | 'duckdb' | 'cloud-only';
-declare const ARCHETYPE_EXECUTION_CLASS: Record<QueryArchetype, ArchetypeExecutionClass>;
-interface DateRange {
+export 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';
+export type ArchetypeExecutionClass = 'r2-sql' | 'r2-sql-resolved' | 'duckdb' | 'cloud-only';
+export declare const ARCHETYPE_EXECUTION_CLASS: Record<QueryArchetype, ArchetypeExecutionClass>;
+export interface DateRange {
   start: string;
   end: string;
 }
-interface ArchetypeFacet {
+export interface ArchetypeFacet {
   column: Dimension;
   op: 'eq' | 'regex' | 'notRegex';
   value: string;
 }
-interface ArchetypeQueryBase {
+export interface ArchetypeQueryBase {
   archetype: QueryArchetype;
   siteId: string;
   searchType: GscSearchType;
@@ -20,11 +20,11 @@ interface ArchetypeQueryBase {
   compareRange?: DateRange;
   facets?: readonly ArchetypeFacet[];
 }
-interface SiteDailyTimeseriesQuery extends ArchetypeQueryBase {
+export interface SiteDailyTimeseriesQuery extends ArchetypeQueryBase {
   archetype: 'site-daily-timeseries';
   metrics: readonly Metric[];
 }
-interface EntityDailyTimeseriesQuery extends ArchetypeQueryBase {
+export interface EntityDailyTimeseriesQuery extends ArchetypeQueryBase {
   archetype: 'entity-daily-timeseries';
   entity: {
     dimension: Extract<Dimension, 'page' | 'query' | 'queryCanonical'>;
@@ -32,13 +32,13 @@ interface EntityDailyTimeseriesQuery extends ArchetypeQueryBase {
   };
   metrics: readonly Metric[];
 }
-interface EntityDailySparklineQuery extends ArchetypeQueryBase {
+export interface EntityDailySparklineQuery extends ArchetypeQueryBase {
   archetype: 'entity-daily-sparkline';
   dimension: Extract<Dimension, 'page' | 'query' | 'queryCanonical'>;
   entities: readonly string[];
   metric: Metric;
 }
-interface TopNBreakdownQuery extends ArchetypeQueryBase {
+export interface TopNBreakdownQuery extends ArchetypeQueryBase {
   archetype: 'top-n-breakdown';
   dimension: Dimension;
   metrics: readonly Metric[];
@@ -51,17 +51,17 @@ interface TopNBreakdownQuery extends ArchetypeQueryBase {
   includeTotal?: boolean;
   movers?: 'improving' | 'declining' | 'new' | 'lost';
 }
-interface SingleRowLookupQuery extends ArchetypeQueryBase {
+export interface SingleRowLookupQuery extends ArchetypeQueryBase {
   archetype: 'single-row-lookup';
   match: Partial<Record<Dimension, string>>;
   metrics: readonly Metric[];
 }
-interface MultiSeriesStackedDailyQuery extends ArchetypeQueryBase {
+export interface MultiSeriesStackedDailyQuery extends ArchetypeQueryBase {
   archetype: 'multi-series-stacked-daily';
   seriesDimension: Dimension;
   metric: Metric;
 }
-interface TwoDimensionDetailQuery extends ArchetypeQueryBase {
+export interface TwoDimensionDetailQuery extends ArchetypeQueryBase {
   archetype: 'two-dimension-detail';
   metrics: readonly Metric[];
   filter?: {
@@ -74,39 +74,39 @@ interface TwoDimensionDetailQuery extends ArchetypeQueryBase {
   };
   limit?: number;
 }
-interface ArbitrarySqlQuery extends ArchetypeQueryBase {
+export interface ArbitrarySqlQuery extends ArchetypeQueryBase {
   archetype: 'arbitrary-sql';
   sql: string;
   params?: readonly unknown[];
 }
-interface AuxCloudOnlyQuery {
+export interface AuxCloudOnlyQuery {
   archetype: 'aux-cloud-only';
   siteId: string;
   dataset: 'canonicals' | 'sitemaps' | 'indexing';
   params?: Record<string, unknown>;
 }
-type ArchetypeQuery = SiteDailyTimeseriesQuery | EntityDailyTimeseriesQuery | EntityDailySparklineQuery | TopNBreakdownQuery | SingleRowLookupQuery | MultiSeriesStackedDailyQuery | TwoDimensionDetailQuery | ArbitrarySqlQuery | AuxCloudOnlyQuery;
+export type ArchetypeQuery = SiteDailyTimeseriesQuery | EntityDailyTimeseriesQuery | EntityDailySparklineQuery | TopNBreakdownQuery | SingleRowLookupQuery | MultiSeriesStackedDailyQuery | TwoDimensionDetailQuery | ArbitrarySqlQuery | AuxCloudOnlyQuery;
 /** Date window accepted by the portable archetype constructors. */
-interface WireDateRange {
+export interface WireDateRange {
   start: string;
   end: string;
 }
 /** Portable constructors for the canonical hosted/browser archetype wire shapes. */
-declare function siteDailyTimeseries(siteId: string, range: WireDateRange, options?: {
+export declare function siteDailyTimeseries(siteId: string, range: WireDateRange, options?: {
   searchType?: GscSearchType;
   compareRange?: WireDateRange;
   metrics?: readonly Metric[];
 }): SiteDailyTimeseriesQuery;
-declare function entityDailyTimeseries(siteId: string, range: WireDateRange, entity: EntityDailyTimeseriesQuery['entity'], options?: {
+export declare function entityDailyTimeseries(siteId: string, range: WireDateRange, entity: EntityDailyTimeseriesQuery['entity'], options?: {
   searchType?: GscSearchType;
   compareRange?: WireDateRange;
   metrics?: readonly Metric[];
 }): EntityDailyTimeseriesQuery;
-declare function entityDailySparkline(siteId: string, range: WireDateRange, dimension: EntityDailySparklineQuery['dimension'], entities: readonly string[], options?: {
+export declare function entityDailySparkline(siteId: string, range: WireDateRange, dimension: EntityDailySparklineQuery['dimension'], entities: readonly string[], options?: {
   searchType?: GscSearchType;
   metric?: Metric;
 }): EntityDailySparklineQuery;
-interface TopNBreakdownOptions {
+export interface TopNBreakdownOptions {
   searchType?: GscSearchType;
   compareRange?: WireDateRange;
   metrics?: readonly Metric[];
@@ -117,18 +117,18 @@ interface TopNBreakdownOptions {
   includeTotal?: boolean;
   movers?: NonNullable<TopNBreakdownQuery['movers']>;
 }
-declare function topNBreakdown(siteId: string, range: WireDateRange, dimension: Dimension, options?: TopNBreakdownOptions): TopNBreakdownQuery;
-declare function singleRowLookup(siteId: string, range: WireDateRange, match: SingleRowLookupQuery['match'], options?: {
+export declare function topNBreakdown(siteId: string, range: WireDateRange, dimension: Dimension, options?: TopNBreakdownOptions): TopNBreakdownQuery;
+export declare function singleRowLookup(siteId: string, range: WireDateRange, match: SingleRowLookupQuery['match'], options?: {
   searchType?: GscSearchType;
   compareRange?: WireDateRange;
   metrics?: readonly Metric[];
 }): SingleRowLookupQuery;
-declare function multiSeriesStackedDaily(siteId: string, range: WireDateRange, seriesDimension: Dimension, options?: {
+export declare function multiSeriesStackedDaily(siteId: string, range: WireDateRange, seriesDimension: Dimension, options?: {
   searchType?: GscSearchType;
   compareRange?: WireDateRange;
   metric?: Metric;
 }): MultiSeriesStackedDailyQuery;
-interface TwoDimensionDetailOptions {
+export interface TwoDimensionDetailOptions {
   searchType?: GscSearchType;
   compareRange?: WireDateRange;
   metrics?: readonly Metric[];
@@ -137,17 +137,17 @@ interface TwoDimensionDetailOptions {
   limit?: number;
   facets?: readonly ArchetypeFacet[];
 }
-declare function twoDimensionDetail(siteId: string, range: WireDateRange, options?: TwoDimensionDetailOptions): TwoDimensionDetailQuery;
-declare function arbitrarySql(siteId: string, range: WireDateRange, sql: string, options?: {
+export declare function twoDimensionDetail(siteId: string, range: WireDateRange, options?: TwoDimensionDetailOptions): TwoDimensionDetailQuery;
+export declare function arbitrarySql(siteId: string, range: WireDateRange, sql: string, options?: {
   searchType?: GscSearchType;
   params?: readonly unknown[];
   cacheable?: boolean;
 }): ArbitrarySqlQuery & {
   cacheable?: true;
 };
-type ArchetypeResultRow = Record<string, string | number | null>;
-type ArchetypeResultSource = 'browser' | 'server-r2-sql' | 'server-duckdb' | 'cloud';
-interface ArchetypeResult<R extends ArchetypeResultRow = ArchetypeResultRow> {
+export type ArchetypeResultRow = Record<string, string | number | null>;
+export type ArchetypeResultSource = 'browser' | 'server-r2-sql' | 'server-duckdb' | 'cloud';
+export interface ArchetypeResult<R extends ArchetypeResultRow = ArchetypeResultRow> {
   archetype: QueryArchetype;
   rows: R[];
   source: ArchetypeResultSource;
@@ -159,9 +159,8 @@ interface ArchetypeResult<R extends ArchetypeResultRow = ArchetypeResultRow> {
     truncated?: boolean;
   };
 }
-interface ResolvedArchetypeQuery {
+export interface ResolvedArchetypeQuery {
   query: ArchetypeQuery;
   builder?: BuilderStateWire;
   executionClass: ArchetypeExecutionClass;
-}
-export { ARCHETYPE_EXECUTION_CLASS, ArbitrarySqlQuery, ArchetypeExecutionClass, ArchetypeFacet, ArchetypeQuery, ArchetypeQueryBase, ArchetypeResult, ArchetypeResultRow, ArchetypeResultSource, AuxCloudOnlyQuery, DateRange, EntityDailySparklineQuery, EntityDailyTimeseriesQuery, MultiSeriesStackedDailyQuery, QueryArchetype, ResolvedArchetypeQuery, SingleRowLookupQuery, SiteDailyTimeseriesQuery, TopNBreakdownOptions, TopNBreakdownQuery, TwoDimensionDetailOptions, TwoDimensionDetailQuery, WireDateRange, arbitrarySql, entityDailySparkline, entityDailyTimeseries, multiSeriesStackedDaily, singleRowLookup, siteDailyTimeseries, topNBreakdown, twoDimensionDetail };
+}

package/dist/endpoints.d.mts

@@ -1,5 +1,5 @@
 /** Canonical analytics data-plane endpoint definitions. */
-declare const analyticsEndpoints: {
+export declare const analyticsEndpoints: {
   readonly whoami: {
     method: "GET";
     path: "/api/__gsc/whoami";
@@ -510,7 +510,7 @@ declare const analyticsEndpoints: {
   };
 };
 /** Canonical partner control-plane endpoint definitions. */
-declare const partnerEndpoints: {
+export declare const partnerEndpoints: {
   readonly registerUser: {
     method: "POST";
     path: "/users/register";
@@ -1564,5 +1564,4 @@ declare const partnerEndpoints: {
       browserAnalyzerEnabled: import("zod").ZodBoolean;
     }, import("zod/v4/core").$loose>;
   };
-};
-export { analyticsEndpoints, partnerEndpoints };
+};

package/dist/file-resolution.d.mts

@@ -1,8 +1,8 @@
 import { GscSearchType } from "./search-types.mjs";
 /** The 6 Iceberg fact tables — string-typed here to avoid an engine dep. */
-type FileResolutionTable = 'pages' | 'queries' | 'countries' | 'page_queries' | 'dates' | 'search_appearance' | 'search_appearance_pages' | 'search_appearance_queries' | 'search_appearance_page_queries';
+export type FileResolutionTable = 'pages' | 'queries' | 'countries' | 'page_queries' | 'dates' | 'search_appearance' | 'search_appearance_pages' | 'search_appearance_queries' | 'search_appearance_page_queries';
 /** Request query params for `GET /api/sites/[siteId]/analysis-sources`. */
-interface FileResolutionRequest {
+export interface FileResolutionRequest {
   /** `YYYY-MM-DD` inclusive. Required — no date range = no resolution. */
   start: string;
   /** `YYYY-MM-DD` inclusive. */
@@ -29,7 +29,7 @@ interface FileResolutionRequest {
 /**
  * One compacted Iceberg parquet data file the browser should fetch into OPFS.
  */
-interface ResolvedParquetFile {
+export interface ResolvedParquetFile {
   /**
    * Same-origin URL (`/api/r2-data/<key>?...`) carrying a signed size hint
    * and a short-lived exact-key access token. Stable for the file's lifetime
@@ -53,7 +53,7 @@ interface ResolvedParquetFile {
   rowCount: number;
 }
 /** Per-table resolution result. */
-interface ResolvedTable {
+export interface ResolvedTable {
   table: FileResolutionTable;
   /**
    * `'browser'` — `files` is populated; the browser downloads + attaches.
@@ -85,7 +85,7 @@ interface ResolvedTable {
   totalRows: number;
 }
 /** Server-tail directive — how an ineligible `(site, table)` is queried. */
-interface ServerTailDirective {
+export interface ServerTailDirective {
   /**
    * `'r2-sql'`  — server runs the query via R2 SQL over the Iceberg table.
    * `'duckdb'`  — server runs DuckDB-over-Iceberg-files (caller-supplied SQL,
@@ -99,7 +99,7 @@ interface ServerTailDirective {
   endpoint: string;
 }
 /** Response body of the file-resolution endpoint. */
-interface FileResolutionResponse {
+export interface FileResolutionResponse {
   siteId: string;
   searchType: GscSearchType;
   range: {
@@ -131,25 +131,24 @@ interface FileResolutionResponse {
   };
 }
 /** One canonical query-dimension sidecar object for browser attachment. */
-interface QueryDimSourceFile {
+export interface QueryDimSourceFile {
   url: string;
   bytes: number;
   contentHash: string;
 }
 /** Response from the versioned query-dimension sidecar resolver. */
-interface QueryDimSourceResponse {
+export interface QueryDimSourceResponse {
   file: QueryDimSourceFile | null;
 }
 /** Multi-site file-resolution response. Inaccessible sites are omitted. */
-interface BulkFileResolutionResponse {
+export interface BulkFileResolutionResponse {
   generatedAt: string;
   siteCount: number;
   maxSites: number;
   results: Record<string, FileResolutionResponse>;
 }
 /** Request query for the multi-site file resolver. */
-interface BulkFileResolutionRequest extends FileResolutionRequest {
+export interface BulkFileResolutionRequest extends FileResolutionRequest {
   /** Public site ids to resolve. Partner callers must supply this list. */
   siteIds?: string[];
-}
-export { BulkFileResolutionRequest, BulkFileResolutionResponse, FileResolutionRequest, FileResolutionResponse, FileResolutionTable, QueryDimSourceFile, QueryDimSourceResponse, ResolvedParquetFile, ResolvedTable, ServerTailDirective };
+}

package/dist/onboarding.d.mts

@@ -1,51 +1,51 @@
-declare const GSCDUMP_ONBOARDING_CONTRACT_VERSION: "2026-05-11";
-declare const GSCDUMP_REQUIRED_ANALYTICS_SCOPE: "https://www.googleapis.com/auth/webmasters.readonly";
-declare const GSCDUMP_WRITE_ANALYTICS_SCOPE: "https://www.googleapis.com/auth/webmasters";
-declare const GSCDUMP_OPTIONAL_INDEXING_SCOPE: "https://www.googleapis.com/auth/indexing";
+export declare const GSCDUMP_ONBOARDING_CONTRACT_VERSION: "2026-05-11";
+export declare const GSCDUMP_REQUIRED_ANALYTICS_SCOPE: "https://www.googleapis.com/auth/webmasters.readonly";
+export declare const GSCDUMP_WRITE_ANALYTICS_SCOPE: "https://www.googleapis.com/auth/webmasters";
+export declare const GSCDUMP_OPTIONAL_INDEXING_SCOPE: "https://www.googleapis.com/auth/indexing";
 type GoogleScopesInput = string | readonly string[] | null | undefined;
-declare const accountStatuses: readonly ["disconnected", "oauth_received", "scope_missing", "refresh_missing", "db_provisioning", "ready", "reauth_required"];
-declare const accountNextActions: readonly ["connect_google", "reconnect_google", "wait_for_provisioning", "none"];
-declare const propertyStatuses: readonly ["no_local_site", "no_gsc_property", "unverified_property", "verified_candidate", "registered", "linked"];
-declare const propertyNextActions: readonly ["create_site", "verify_gsc_property", "choose_property", "register_site", "none"];
-declare const analyticsStatuses: readonly ["not_registered", "queued", "preparing", "syncing", "queryable_live", "queryable_partial", "ready", "failed"];
-declare const analyticsNextActions: readonly ["wait_for_sync", "retry_sync", "none"];
-declare const querySourceModes: readonly ["none", "live", "d1", "r2", "mixed"];
-declare const sitemapStatuses: readonly ["unknown", "discovering", "none_found", "auto_submitted", "syncing", "ready", "failed"];
-declare const sitemapNextActions: readonly ["submit_sitemap", "wait_for_sitemaps", "retry_sitemaps", "none"];
-declare const indexingStatuses: readonly ["not_requested", "missing_scope", "insufficient_permission", "waiting_for_sitemaps", "discovering", "checking", "ready", "budget_exhausted", "no_urls", "failed"];
-declare const indexingNextActions: readonly ["reconnect_google", "fix_gsc_permission", "wait_for_sitemaps", "wait_for_indexing", "retry_indexing", "none"];
-declare const lifecycleErrorCodes: readonly ["missing_refresh_token", "missing_analytics_scope", "missing_gsc_read_scope", "token_refresh_failed", "permission_lost", "insufficient_gsc_permission", "gsc_property_not_found", "gsc_property_unverified", "user_database_not_provisioned", "sync_failed", "sitemap_sync_failed", "indexing_failed"];
-type AccountStatus = typeof accountStatuses[number];
-type AccountNextAction = typeof accountNextActions[number];
-type PropertyStatus = typeof propertyStatuses[number];
-type PropertyNextAction = typeof propertyNextActions[number];
-type AnalyticsStatus = typeof analyticsStatuses[number];
-type AnalyticsNextAction = typeof analyticsNextActions[number];
-type QuerySourceMode = typeof querySourceModes[number];
-type SitemapStatus = typeof sitemapStatuses[number];
-type SitemapNextAction = typeof sitemapNextActions[number];
-type IndexingStatus = typeof indexingStatuses[number];
-type IndexingNextAction = typeof indexingNextActions[number];
-type LifecycleWebhookEvent = 'user.lifecycle.changed' | 'site.lifecycle.changed' | 'site.analytics.ready' | 'site.indexing.ready' | 'site.auth.failed' | 'job.failed';
-type LifecycleErrorCode = typeof lifecycleErrorCodes[number];
-interface LifecycleProgress {
+export declare const accountStatuses: readonly ["disconnected", "oauth_received", "scope_missing", "refresh_missing", "db_provisioning", "ready", "reauth_required"];
+export declare const accountNextActions: readonly ["connect_google", "reconnect_google", "wait_for_provisioning", "none"];
+export declare const propertyStatuses: readonly ["no_local_site", "no_gsc_property", "unverified_property", "verified_candidate", "registered", "linked"];
+export declare const propertyNextActions: readonly ["create_site", "verify_gsc_property", "choose_property", "register_site", "none"];
+export declare const analyticsStatuses: readonly ["not_registered", "queued", "preparing", "syncing", "queryable_live", "queryable_partial", "ready", "failed"];
+export declare const analyticsNextActions: readonly ["wait_for_sync", "retry_sync", "none"];
+export declare const querySourceModes: readonly ["none", "live", "d1", "r2", "mixed"];
+export declare const sitemapStatuses: readonly ["unknown", "discovering", "none_found", "auto_submitted", "syncing", "ready", "failed"];
+export declare const sitemapNextActions: readonly ["submit_sitemap", "wait_for_sitemaps", "retry_sitemaps", "none"];
+export declare const indexingStatuses: readonly ["not_requested", "missing_scope", "insufficient_permission", "waiting_for_sitemaps", "discovering", "checking", "ready", "budget_exhausted", "no_urls", "failed"];
+export declare const indexingNextActions: readonly ["reconnect_google", "fix_gsc_permission", "wait_for_sitemaps", "wait_for_indexing", "retry_indexing", "none"];
+export declare const lifecycleErrorCodes: readonly ["missing_refresh_token", "missing_analytics_scope", "missing_gsc_read_scope", "token_refresh_failed", "permission_lost", "insufficient_gsc_permission", "gsc_property_not_found", "gsc_property_unverified", "user_database_not_provisioned", "sync_failed", "sitemap_sync_failed", "indexing_failed"];
+export type AccountStatus = typeof accountStatuses[number];
+export type AccountNextAction = typeof accountNextActions[number];
+export type PropertyStatus = typeof propertyStatuses[number];
+export type PropertyNextAction = typeof propertyNextActions[number];
+export type AnalyticsStatus = typeof analyticsStatuses[number];
+export type AnalyticsNextAction = typeof analyticsNextActions[number];
+export type QuerySourceMode = typeof querySourceModes[number];
+export type SitemapStatus = typeof sitemapStatuses[number];
+export type SitemapNextAction = typeof sitemapNextActions[number];
+export type IndexingStatus = typeof indexingStatuses[number];
+export type IndexingNextAction = typeof indexingNextActions[number];
+export type LifecycleWebhookEvent = 'user.lifecycle.changed' | 'site.lifecycle.changed' | 'site.analytics.ready' | 'site.indexing.ready' | 'site.auth.failed' | 'job.failed';
+export type LifecycleErrorCode = typeof lifecycleErrorCodes[number];
+export interface LifecycleProgress {
   completed: number;
   failed: number;
   total: number;
   percent: number;
 }
-interface LifecycleError {
+export interface LifecycleError {
   code: LifecycleErrorCode;
   message: string;
   retryable: boolean;
 }
-interface PartnerLifecycleAccount {
+export interface PartnerLifecycleAccount {
   status: AccountStatus;
   grantedScopes: string[];
   missingScopes: string[];
   nextAction: AccountNextAction;
 }
-interface PartnerLifecycleSite {
+export interface PartnerLifecycleSite {
   siteId: string;
   /** Integer alias (`user_sites.int_id`) — the int JOIN key partners denormalize into their own catalog namespaces. Nullable only for pre-0029 unbackfilled rows. */
   intId: number | null;
@@ -86,7 +86,7 @@ interface PartnerLifecycleSite {
   lifecycleRevision: number;
   updatedAt: string;
 }
-interface PartnerLifecycleResponse {
+export interface PartnerLifecycleResponse {
   contractVersion: typeof GSCDUMP_ONBOARDING_CONTRACT_VERSION;
   userId: string;
   partnerId: string | null;
@@ -94,7 +94,7 @@ interface PartnerLifecycleResponse {
   account: PartnerLifecycleAccount;
   sites: PartnerLifecycleSite[];
 }
-interface LifecycleWebhookEnvelope<TData extends Record<string, unknown> = Record<string, unknown>> {
+export interface LifecycleWebhookEnvelope<TData extends Record<string, unknown> = Record<string, unknown>> {
   contractVersion: typeof GSCDUMP_ONBOARDING_CONTRACT_VERSION;
   deliveryId: string;
   event: LifecycleWebhookEvent;
@@ -107,7 +107,6 @@ interface LifecycleWebhookEnvelope<TData extends Record<string, unknown> = Recor
   occurredAt: string;
   data: TData;
 }
-declare function parseGrantedScopes(scopes: GoogleScopesInput): string[];
-declare function hasRequiredAnalyticsScope(scopes: GoogleScopesInput): boolean;
-declare function hasOptionalIndexingScope(scopes: GoogleScopesInput): boolean;
-export { AccountNextAction, AccountStatus, AnalyticsNextAction, AnalyticsStatus, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSCDUMP_WRITE_ANALYTICS_SCOPE, IndexingNextAction, IndexingStatus, LifecycleError, LifecycleErrorCode, LifecycleProgress, LifecycleWebhookEnvelope, LifecycleWebhookEvent, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite, PropertyNextAction, PropertyStatus, QuerySourceMode, SitemapNextAction, SitemapStatus, accountNextActions, accountStatuses, analyticsNextActions, analyticsStatuses, hasOptionalIndexingScope, hasRequiredAnalyticsScope, indexingNextActions, indexingStatuses, lifecycleErrorCodes, parseGrantedScopes, propertyNextActions, propertyStatuses, querySourceModes, sitemapNextActions, sitemapStatuses };
+export declare function parseGrantedScopes(scopes: GoogleScopesInput): string[];
+export declare function hasRequiredAnalyticsScope(scopes: GoogleScopesInput): boolean;
+export declare function hasOptionalIndexingScope(scopes: GoogleScopesInput): boolean;

package/dist/routes.d.mts

@@ -1,4 +1,4 @@
-declare const partnerRoutes: {
+export declare const partnerRoutes: {
   readonly partner: {
     readonly users: {
       readonly lifecycle: (userId: string) => string;
@@ -34,7 +34,7 @@ declare const partnerRoutes: {
     readonly user: "/user/settings";
   };
 };
-declare const analyticsRoutes: {
+export declare const analyticsRoutes: {
   readonly whoami: "/api/__gsc/whoami";
   readonly sites: "/api/__gsc/sites";
   readonly bulkSources: "/api/__gsc/bulk-sources";
@@ -55,5 +55,4 @@ declare const analyticsRoutes: {
     readonly topAssociation: (siteId: string) => string;
   };
   readonly syncProgress: "/api/sync-progress";
-};
-export { analyticsRoutes, partnerRoutes };
+};