gscdump 0.24.1 → 0.25.0

package/dist/index.d.mts

@@ -762,6 +762,7 @@ declare function normalizeGscSiteUrl(siteUrl: string): string;
  * Returns lowercase hostname stripped of protocol, or null if unparseable.
  */
 declare function normalizeRegistrationTarget(inputUrl: string): string | null;
+declare function normalizeUrl(input: string): string;
 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_OPTIONAL_INDEXING_SCOPE: "https://www.googleapis.com/auth/indexing";
@@ -893,4 +894,29 @@ interface FetchSitemapUrlsOptions extends DiscoverSitemapOptions {
  * `<loc>https://...</loc>` shape but doesn't validate the schema.
  */
 declare function fetchSitemapUrls(sitemapUrl: string, options?: FetchSitemapUrlsOptions): Promise<string[]>;
-export { AccountNextAction, AccountStatus, AnalyticsNextAction, AnalyticsStatus, ApiSite, ApiSitemap, ApiSitemapContent, Auth, AuthClient, AuthOptions, BackfillProgress, CallOptions, DAYS_PER_RANGE, DataRow, DimensionFilter, DimensionFilterGroup, DiscoverSitemapOptions, FetchSitemapUrlsOptions, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_QUOTAS, GSC_RETENTION_MONTHS, GoogleSearchConsoleClient, GoogleSearchConsoleClientOptions, GscApiError, GscApiErrorInfo, GscError, GscErrorKind, GscPropertyCandidate, GscdumpApiOptions, INDEXING_ISSUE_FILTERS, INDEXING_ISSUE_LABELS, INDEXING_ISSUE_SEVERITY, IndexStatusResult, IndexingEligibility, IndexingIneligibleReason, IndexingIssueType, IndexingMetadata, IndexingNextAction, IndexingNotificationType, IndexingResult, IndexingStatus, InspectUrlIndexResponse, InspectUrlResult, InspectionPriority, LifecycleError, LifecycleErrorCode, LifecycleProgress, LifecycleWebhookEnvelope, LifecycleWebhookEvent, MS_PER_DAY, MobileUsabilityResult, OAuthTokens, ParsedGscSiteUrl, ParsedIndexingResult, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite, Period, PropertyNextAction, PropertyStatus, PublishUrlNotificationResponse, QueryReturn, QuerySourceMode, RequiredNonNullable, ResolvedAnalyticsRange, RichResultsResult, SearchAnalyticsQuery, SearchAnalyticsResponse, Site, SiteAnalytics, SitemapNextAction, SitemapStatus, URL_INSPECTION_DAILY_LIMIT, URL_INSPECTION_EFFECTIVE_LIMIT, UrlInspectionResult, UrlNotificationMetadata, VerificationMethod, VerificationSite, VerificationSiteType, VerificationToken, VerificationWebResource, accountNextActions, accountStatuses, addDays, addSite, analyticsNextActions, analyticsStatuses, batchInspectUrls, batchRequestIndexing, canUseUrlInspection, classifyError, countDays, createAuth, createFetch, daysAgo, deleteSite, deleteSitemap, discoverSitemap, exchangeAuthCode, fetchSitemap, fetchSitemapUrls, fetchSitemaps, fetchSites, fetchSitesWithSitemaps, findBestGscProperty, findExactGscProperty, formatErrorForCli, formatGscPropertyCandidates, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getIndexingEligibility, getIndexingMetadata, getLatestGscDate, getNextCheckAfter, getNextCheckPriority, getNextDate, getOldestGscDate, getPendingDates, getPreviousDate, getPstDate, getVerificationToken, getVerifiedSite, googleSearchConsole, grantedScopeList, groupIntoRanges, gscPropertyMatchesTarget, gscdumpApi, hasGscReadScope, hasGscWriteScope, hasIndexingScope, hasOptionalIndexingScope, hasRequiredAnalyticsScope, indexingNextActions, indexingStatuses, inspectUrl, inspectUrlFlat, isPermissionDeniedError, isValidGscDate, isVerifiedGscPermission, isVerifiedGscProperty, lifecycleErrorCodes, lifecycleWebhookEvents, listVerifiedSites, matchGscSite, normalizeGscSiteUrl, normalizeRegistrationTarget, parseGoogleError, parseGrantedScopes, parseGscSiteUrl, pickBestGscProperty, progressBar, propertyNextActions, propertyStatuses, querySourceModes, refreshAccessToken, requestIndexing, rethrowAsGscApiError, rowWithMetricDefaults, runSequentialBatch, siteUrlToVerificationSite, sitemapNextActions, sitemapStatuses, storageError, submitSitemap, toIsoDate, unverifySite, verificationMethodsFor, verifySite };
+declare function encodeSiteId(siteUrl: string): string;
+/**
+ * Best-effort inverse of `encodeSiteId` for the common prefixes. Lossy
+ * (`encodeSiteId` collapses non-word chars to `_` and strips trailing
+ * underscores), but round-trips domain properties + https origins cleanly —
+ * the only two shapes GSC hands out in practice.
+ *
+ * Returns the input unchanged when neither prefix is recognised, so callers
+ * can pass through canonical site URLs without branching.
+ */
+declare function decodeSiteId(encoded: string): string;
+/**
+ * Normalize a siteUrl to the form Google APIs expect: domain properties get
+ * the `sc-domain:` prefix added if missing, URL properties pass through.
+ * Idempotent — safe to call on already-prefixed values.
+ */
+declare function normalizeSiteUrl(siteUrl: string): string;
+/**
+ * Equivalence key for matching two URLs that point at the same resource
+ * across protocol (http/https), www. prefix, trailing slash, and casing.
+ * Returns `null` for unparseable input.
+ *
+ * Example: `https://www.Example.com/Foo/` → `example.com/foo`
+ */
+declare function urlMatchKey(url: string): string | null;
+export { AccountNextAction, AccountStatus, AnalyticsNextAction, AnalyticsStatus, ApiSite, ApiSitemap, ApiSitemapContent, Auth, AuthClient, AuthOptions, BackfillProgress, CallOptions, DAYS_PER_RANGE, DataRow, DimensionFilter, DimensionFilterGroup, DiscoverSitemapOptions, FetchSitemapUrlsOptions, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_QUOTAS, GSC_RETENTION_MONTHS, GoogleSearchConsoleClient, GoogleSearchConsoleClientOptions, GscApiError, GscApiErrorInfo, GscError, GscErrorKind, GscPropertyCandidate, GscdumpApiOptions, INDEXING_ISSUE_FILTERS, INDEXING_ISSUE_LABELS, INDEXING_ISSUE_SEVERITY, IndexStatusResult, IndexingEligibility, IndexingIneligibleReason, IndexingIssueType, IndexingMetadata, IndexingNextAction, IndexingNotificationType, IndexingResult, IndexingStatus, InspectUrlIndexResponse, InspectUrlResult, InspectionPriority, LifecycleError, LifecycleErrorCode, LifecycleProgress, LifecycleWebhookEnvelope, LifecycleWebhookEvent, MS_PER_DAY, MobileUsabilityResult, OAuthTokens, ParsedGscSiteUrl, ParsedIndexingResult, PartnerLifecycleAccount, PartnerLifecycleResponse, PartnerLifecycleSite, Period, PropertyNextAction, PropertyStatus, PublishUrlNotificationResponse, QueryReturn, QuerySourceMode, RequiredNonNullable, ResolvedAnalyticsRange, RichResultsResult, SearchAnalyticsQuery, SearchAnalyticsResponse, Site, SiteAnalytics, SitemapNextAction, SitemapStatus, URL_INSPECTION_DAILY_LIMIT, URL_INSPECTION_EFFECTIVE_LIMIT, UrlInspectionResult, UrlNotificationMetadata, VerificationMethod, VerificationSite, VerificationSiteType, VerificationToken, VerificationWebResource, accountNextActions, accountStatuses, addDays, addSite, analyticsNextActions, analyticsStatuses, batchInspectUrls, batchRequestIndexing, canUseUrlInspection, classifyError, countDays, createAuth, createFetch, daysAgo, decodeSiteId, deleteSite, deleteSitemap, discoverSitemap, encodeSiteId, exchangeAuthCode, fetchSitemap, fetchSitemapUrls, fetchSitemaps, fetchSites, fetchSitesWithSitemaps, findBestGscProperty, findExactGscProperty, formatErrorForCli, formatGscPropertyCandidates, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getIndexingEligibility, getIndexingMetadata, getLatestGscDate, getNextCheckAfter, getNextCheckPriority, getNextDate, getOldestGscDate, getPendingDates, getPreviousDate, getPstDate, getVerificationToken, getVerifiedSite, googleSearchConsole, grantedScopeList, groupIntoRanges, gscPropertyMatchesTarget, gscdumpApi, hasGscReadScope, hasGscWriteScope, hasIndexingScope, hasOptionalIndexingScope, hasRequiredAnalyticsScope, indexingNextActions, indexingStatuses, inspectUrl, inspectUrlFlat, isPermissionDeniedError, isValidGscDate, isVerifiedGscPermission, isVerifiedGscProperty, lifecycleErrorCodes, lifecycleWebhookEvents, listVerifiedSites, matchGscSite, normalizeGscSiteUrl, normalizeRegistrationTarget, normalizeSiteUrl, normalizeUrl, parseGoogleError, parseGrantedScopes, parseGscSiteUrl, pickBestGscProperty, progressBar, propertyNextActions, propertyStatuses, querySourceModes, refreshAccessToken, requestIndexing, rethrowAsGscApiError, rowWithMetricDefaults, runSequentialBatch, siteUrlToVerificationSite, sitemapNextActions, sitemapStatuses, storageError, submitSitemap, toIsoDate, unverifySite, urlMatchKey, verificationMethodsFor, verifySite };

package/dist/index.mjs

@@ -2847,6 +2847,21 @@ function formatGscPropertyCandidates(candidates) {
 }
 const URL_INSPECTION_DAILY_LIMIT = 2e3;
 const URL_INSPECTION_EFFECTIVE_LIMIT = 1800;
+const URL_PROTOCOL_RE = /^[a-z][a-z0-9+.-]*:\/\//i;
+function normalizeUrl(input) {
+	if (!input) return input;
+	if (!URL_PROTOCOL_RE.test(input)) return input.startsWith("/") ? input : `/${input}`;
+	const parsed = safeParse(input);
+	if (!parsed) return input;
+	return `${parsed.pathname}${parsed.search}${parsed.hash}`;
+}
+function safeParse(input) {
+	try {
+		return new URL(input);
+	} catch {
+		return null;
+	}
+}
 const GSCDUMP_ONBOARDING_CONTRACT_VERSION = "2026-05-11";
 const GSCDUMP_REQUIRED_ANALYTICS_SCOPE = "https://www.googleapis.com/auth/webmasters.readonly";
 const GSCDUMP_OPTIONAL_INDEXING_SCOPE = "https://www.googleapis.com/auth/indexing";
@@ -3035,4 +3050,26 @@ async function fetchSitemapUrls(sitemapUrl, options = {}) {
 	await visit(sitemapUrl, 0);
 	return out;
 }
-export { DAYS_PER_RANGE, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_QUOTAS, GSC_RETENTION_MONTHS, GscApiError, INDEXING_ISSUE_FILTERS, INDEXING_ISSUE_LABELS, INDEXING_ISSUE_SEVERITY, MS_PER_DAY, URL_INSPECTION_DAILY_LIMIT, URL_INSPECTION_EFFECTIVE_LIMIT, accountNextActions, accountStatuses, addDays, addSite, analyticsNextActions, analyticsStatuses, batchInspectUrls, batchRequestIndexing, canUseUrlInspection, classifyError, countDays, createAuth, createFetch, daysAgo, deleteSite, deleteSitemap, discoverSitemap, exchangeAuthCode, fetchSitemap, fetchSitemapUrls, fetchSitemaps, fetchSites, fetchSitesWithSitemaps, findBestGscProperty, findExactGscProperty, formatErrorForCli, formatGscPropertyCandidates, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getIndexingEligibility, getIndexingMetadata, getLatestGscDate, getNextCheckAfter, getNextCheckPriority, getNextDate, getOldestGscDate, getPendingDates, getPreviousDate, getPstDate, getVerificationToken, getVerifiedSite, googleSearchConsole, grantedScopeList, groupIntoRanges, gscPropertyMatchesTarget, gscdumpApi, hasGscReadScope, hasGscWriteScope, hasIndexingScope, hasOptionalIndexingScope, hasRequiredAnalyticsScope, indexingNextActions, indexingStatuses, inspectUrl, inspectUrlFlat, isPermissionDeniedError, isValidGscDate, isVerifiedGscPermission, isVerifiedGscProperty, lifecycleErrorCodes, lifecycleWebhookEvents, listVerifiedSites, matchGscSite, normalizeGscSiteUrl, normalizeRegistrationTarget, parseGoogleError, parseGrantedScopes, parseGscSiteUrl, pickBestGscProperty, progressBar, propertyNextActions, propertyStatuses, querySourceModes, refreshAccessToken, requestIndexing, rethrowAsGscApiError, rowWithMetricDefaults, runSequentialBatch, siteUrlToVerificationSite, sitemapNextActions, sitemapStatuses, storageError, submitSitemap, toIsoDate, unverifySite, verificationMethodsFor, verifySite };
+const SC_DOMAIN_RE = /^sc-domain:/;
+const PROTOCOL_RE = /^https?:\/\//;
+const NON_ID_RE = /[^\w.-]/g;
+const TRAILING_UNDERSCORES_RE = /_+$/;
+function encodeSiteId(siteUrl) {
+	return siteUrl.replace(SC_DOMAIN_RE, "d_").replace(PROTOCOL_RE, "h_").replace(NON_ID_RE, "_").replace(TRAILING_UNDERSCORES_RE, "");
+}
+function decodeSiteId(encoded) {
+	if (encoded.startsWith("d_")) return `sc-domain:${encoded.slice(2)}`;
+	if (encoded.startsWith("h_")) return `https://${encoded.slice(2)}/`;
+	return encoded;
+}
+function normalizeSiteUrl(siteUrl) {
+	if (siteUrl.startsWith("sc-domain:")) return siteUrl;
+	if (siteUrl.startsWith("http://") || siteUrl.startsWith("https://")) return siteUrl;
+	return `sc-domain:${siteUrl}`;
+}
+function urlMatchKey(url) {
+	const u = URL.parse(url);
+	if (!u) return null;
+	return [u.hostname.replace(/^www\./, ""), u.pathname.replace(/\/$/, "") || "/"].join("").toLowerCase();
+}
+export { DAYS_PER_RANGE, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_QUOTAS, GSC_RETENTION_MONTHS, GscApiError, INDEXING_ISSUE_FILTERS, INDEXING_ISSUE_LABELS, INDEXING_ISSUE_SEVERITY, MS_PER_DAY, URL_INSPECTION_DAILY_LIMIT, URL_INSPECTION_EFFECTIVE_LIMIT, accountNextActions, accountStatuses, addDays, addSite, analyticsNextActions, analyticsStatuses, batchInspectUrls, batchRequestIndexing, canUseUrlInspection, classifyError, countDays, createAuth, createFetch, daysAgo, decodeSiteId, deleteSite, deleteSitemap, discoverSitemap, encodeSiteId, exchangeAuthCode, fetchSitemap, fetchSitemapUrls, fetchSitemaps, fetchSites, fetchSitesWithSitemaps, findBestGscProperty, findExactGscProperty, formatErrorForCli, formatGscPropertyCandidates, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getIndexingEligibility, getIndexingMetadata, getLatestGscDate, getNextCheckAfter, getNextCheckPriority, getNextDate, getOldestGscDate, getPendingDates, getPreviousDate, getPstDate, getVerificationToken, getVerifiedSite, googleSearchConsole, grantedScopeList, groupIntoRanges, gscPropertyMatchesTarget, gscdumpApi, hasGscReadScope, hasGscWriteScope, hasIndexingScope, hasOptionalIndexingScope, hasRequiredAnalyticsScope, indexingNextActions, indexingStatuses, inspectUrl, inspectUrlFlat, isPermissionDeniedError, isValidGscDate, isVerifiedGscPermission, isVerifiedGscProperty, lifecycleErrorCodes, lifecycleWebhookEvents, listVerifiedSites, matchGscSite, normalizeGscSiteUrl, normalizeRegistrationTarget, normalizeSiteUrl, normalizeUrl, parseGoogleError, parseGrantedScopes, parseGscSiteUrl, pickBestGscProperty, progressBar, propertyNextActions, propertyStatuses, querySourceModes, refreshAccessToken, requestIndexing, rethrowAsGscApiError, rowWithMetricDefaults, runSequentialBatch, siteUrlToVerificationSite, sitemapNextActions, sitemapStatuses, storageError, submitSitemap, toIsoDate, unverifySite, urlMatchKey, verificationMethodsFor, verifySite };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gscdump",
   "type": "module",
-  "version": "0.24.1",
+  "version": "0.25.0",
   "description": "Google Search Console API wrapper with typed query builder, streaming pagination, and SEO analysis functions",
   "author": {
     "name": "Harlan Wilton",
@@ -51,36 +51,6 @@
       "types": "./dist/contracts.d.mts",
       "import": "./dist/contracts.mjs",
       "default": "./dist/contracts.mjs"
-    },
-    "./driver": {
-      "types": "./dist/driver.d.mts",
-      "import": "./dist/driver.mjs",
-      "default": "./dist/driver.mjs"
-    },
-    "./tenant": {
-      "types": "./dist/tenant.d.mts",
-      "import": "./dist/tenant.mjs",
-      "default": "./dist/tenant.mjs"
-    },
-    "./normalize": {
-      "types": "./dist/normalize.d.mts",
-      "import": "./dist/normalize.mjs",
-      "default": "./dist/normalize.mjs"
-    },
-    "./url": {
-      "types": "./dist/url.d.mts",
-      "import": "./dist/url.mjs",
-      "default": "./dist/url.mjs"
-    },
-    "./sitemap": {
-      "types": "./dist/sitemap.d.mts",
-      "import": "./dist/sitemap.mjs",
-      "default": "./dist/sitemap.mjs"
-    },
-    "./onboarding": {
-      "types": "./dist/onboarding.d.mts",
-      "import": "./dist/onboarding.mjs",
-      "default": "./dist/onboarding.mjs"
     }
   },
   "main": "./dist/index.mjs",
@@ -108,7 +78,7 @@
     "defu": "^6.1.7",
     "ofetch": "^1.5.1",
     "ufo": "^1.6.4",
-    "@gscdump/contracts": "0.24.1"
+    "@gscdump/contracts": "0.25.0"
   },
   "devDependencies": {
     "@googleapis/indexing": "^6.0.1",

package/dist/driver.d.mts

@@ -1,78 +0,0 @@
-/**
- * Driver contracts: cross-package shapes returned by GSC API drivers
- * (live REST, cloud-bridged, in-memory test doubles). Consumers (cloud SDK,
- * MCP server, test fixtures) bind against these contracts so a driver swap
- * doesn't ripple through call sites.
- *
- * Edge-safe: no engine imports, no `node:*`. Driver shapes describe data
- * returned over the wire, so they belong with the REST client surface, not
- * the storage engine.
- */
-interface DriverSite {
-  siteUrl: string;
-  permissionLevel: string;
-}
-interface DriverSiteWithSync extends DriverSite {
-  siteId: string;
-  syncStatus: string | null;
-  syncProgress: {
-    total: number;
-    completed: number;
-    percent: number;
-  };
-  lastSyncAt: number | null;
-  newestDateSynced: string | null;
-  oldestDateSynced: string | null;
-}
-interface DriverQueryParams {
-  startDate: string;
-  endDate: string;
-  dimensions?: string[];
-  rowLimit?: number;
-  startRow?: number;
-  searchType?: string;
-  filters?: Array<{
-    dimension: string;
-    operator: string;
-    expression: string;
-  }>;
-}
-interface DriverQueryRow {
-  clicks: number;
-  impressions: number;
-  ctr: number;
-  position: number;
-  [key: string]: unknown;
-}
-interface DriverQueryResult {
-  rows: DriverQueryRow[];
-  meta: {
-    siteUrl: string;
-    dimensions: string[];
-    dateRange: {
-      startDate: string;
-      endDate: string;
-    };
-    rowCount: number;
-    hasMore: boolean;
-  };
-}
-interface DriverSitemap {
-  path: string;
-  type?: string;
-  isPending?: boolean;
-  errors?: number;
-  warnings?: number;
-  urlCount?: number;
-  lastDownloaded?: string | null;
-}
-interface DriverInspectResult {
-  url: string;
-  verdict: string | null;
-  coverageState: string | null;
-  indexingState: string | null;
-  lastCrawlTime: string | null;
-  isIndexed: boolean;
-  raw: unknown;
-}
-export { DriverInspectResult, DriverQueryParams, DriverQueryResult, DriverQueryRow, DriverSite, DriverSiteWithSync, DriverSitemap };

package/dist/driver.mjs

@@ -1 +0,0 @@
-export {};

package/dist/normalize.d.mts

@@ -1,2 +0,0 @@
-declare function normalizeUrl(input: string): string;
-export { normalizeUrl };

package/dist/normalize.mjs

@@ -1,16 +0,0 @@
-const URL_PROTOCOL_RE = /^[a-z][a-z0-9+.-]*:\/\//i;
-function normalizeUrl(input) {
-	if (!input) return input;
-	if (!URL_PROTOCOL_RE.test(input)) return input.startsWith("/") ? input : `/${input}`;
-	const parsed = safeParse(input);
-	if (!parsed) return input;
-	return `${parsed.pathname}${parsed.search}${parsed.hash}`;
-}
-function safeParse(input) {
-	try {
-		return new URL(input);
-	} catch {
-		return null;
-	}
-}
-export { normalizeUrl };

package/dist/onboarding.d.mts

@@ -1,107 +0,0 @@
-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_OPTIONAL_INDEXING_SCOPE: "https://www.googleapis.com/auth/indexing";
-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 lifecycleWebhookEvents: readonly ["user.lifecycle.changed", "site.lifecycle.changed", "site.analytics.ready", "site.indexing.ready", "site.auth.failed", "job.failed"];
-declare const lifecycleErrorCodes: readonly ["missing_refresh_token", "missing_analytics_scope", "missing_indexing_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 = typeof lifecycleWebhookEvents[number];
-type LifecycleErrorCode = typeof lifecycleErrorCodes[number];
-interface LifecycleProgress {
-  completed: number;
-  failed: number;
-  total: number;
-  percent: number;
-}
-interface LifecycleError {
-  code: LifecycleErrorCode;
-  message: string;
-  retryable: boolean;
-}
-interface PartnerLifecycleAccount {
-  status: AccountStatus;
-  grantedScopes: string[];
-  missingScopes: string[];
-  nextAction: AccountNextAction;
-}
-interface PartnerLifecycleSite {
-  siteId: string;
-  externalSiteId: string | null;
-  requestedUrl: string;
-  gscPropertyUrl: string | null;
-  permissionLevel: string | null;
-  property: {
-    status: PropertyStatus;
-    nextAction: PropertyNextAction;
-  };
-  analytics: {
-    status: AnalyticsStatus;
-    progress: LifecycleProgress;
-    queryable: boolean;
-    sourceMode: QuerySourceMode;
-    syncedRange: {
-      oldest: string | null;
-      newest: string | null;
-    };
-    nextAction: AnalyticsNextAction;
-  };
-  sitemaps: {
-    status: SitemapStatus;
-    discoveredCount: number;
-    nextAction: SitemapNextAction;
-  };
-  indexing: {
-    status: IndexingStatus;
-    eligible: boolean;
-    reason: string | null;
-    progress: LifecycleProgress;
-    nextAction: IndexingNextAction;
-  };
-  latestError: LifecycleError | null;
-  lifecycleRevision: number;
-  updatedAt: string;
-}
-interface PartnerLifecycleResponse {
-  contractVersion: typeof GSCDUMP_ONBOARDING_CONTRACT_VERSION;
-  userId: string;
-  partnerId: string | null;
-  account: PartnerLifecycleAccount;
-  sites: PartnerLifecycleSite[];
-}
-interface LifecycleWebhookEnvelope<TData extends Record<string, unknown> = Record<string, unknown>> {
-  contractVersion: typeof GSCDUMP_ONBOARDING_CONTRACT_VERSION;
-  deliveryId: string;
-  event: LifecycleWebhookEvent;
-  partnerId: string;
-  userId: string;
-  siteId?: string;
-  externalUserId?: string | null;
-  externalSiteId?: string | null;
-  lifecycleRevision: number;
-  occurredAt: string;
-  data: TData;
-}
-declare function parseGrantedScopes(scopes: string | null | undefined): string[];
-declare function hasRequiredAnalyticsScope(scopes: string | string[] | null | undefined): boolean;
-declare function hasOptionalIndexingScope(scopes: string | string[] | null | undefined): boolean;
-export { AccountNextAction, AccountStatus, AnalyticsNextAction, AnalyticsStatus, GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_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, lifecycleWebhookEvents, parseGrantedScopes, propertyNextActions, propertyStatuses, querySourceModes, sitemapNextActions, sitemapStatuses };

package/dist/onboarding.mjs

@@ -1,122 +0,0 @@
-const GSCDUMP_ONBOARDING_CONTRACT_VERSION = "2026-05-11";
-const GSCDUMP_REQUIRED_ANALYTICS_SCOPE = "https://www.googleapis.com/auth/webmasters.readonly";
-const GSCDUMP_OPTIONAL_INDEXING_SCOPE = "https://www.googleapis.com/auth/indexing";
-const accountStatuses = [
-	"disconnected",
-	"oauth_received",
-	"scope_missing",
-	"refresh_missing",
-	"db_provisioning",
-	"ready",
-	"reauth_required"
-];
-const accountNextActions = [
-	"connect_google",
-	"reconnect_google",
-	"wait_for_provisioning",
-	"none"
-];
-const propertyStatuses = [
-	"no_local_site",
-	"no_gsc_property",
-	"unverified_property",
-	"verified_candidate",
-	"registered",
-	"linked"
-];
-const propertyNextActions = [
-	"create_site",
-	"verify_gsc_property",
-	"choose_property",
-	"register_site",
-	"none"
-];
-const analyticsStatuses = [
-	"not_registered",
-	"queued",
-	"preparing",
-	"syncing",
-	"queryable_live",
-	"queryable_partial",
-	"ready",
-	"failed"
-];
-const analyticsNextActions = [
-	"wait_for_sync",
-	"retry_sync",
-	"none"
-];
-const querySourceModes = [
-	"none",
-	"live",
-	"d1",
-	"r2",
-	"mixed"
-];
-const sitemapStatuses = [
-	"unknown",
-	"discovering",
-	"none_found",
-	"auto_submitted",
-	"syncing",
-	"ready",
-	"failed"
-];
-const sitemapNextActions = [
-	"submit_sitemap",
-	"wait_for_sitemaps",
-	"retry_sitemaps",
-	"none"
-];
-const indexingStatuses = [
-	"not_requested",
-	"missing_scope",
-	"insufficient_permission",
-	"waiting_for_sitemaps",
-	"discovering",
-	"checking",
-	"ready",
-	"budget_exhausted",
-	"no_urls",
-	"failed"
-];
-const indexingNextActions = [
-	"reconnect_google",
-	"fix_gsc_permission",
-	"wait_for_sitemaps",
-	"wait_for_indexing",
-	"retry_indexing",
-	"none"
-];
-const lifecycleWebhookEvents = [
-	"user.lifecycle.changed",
-	"site.lifecycle.changed",
-	"site.analytics.ready",
-	"site.indexing.ready",
-	"site.auth.failed",
-	"job.failed"
-];
-const lifecycleErrorCodes = [
-	"missing_refresh_token",
-	"missing_analytics_scope",
-	"missing_indexing_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"
-];
-function parseGrantedScopes(scopes) {
-	return (scopes ?? "").split(/\s+/).map((s) => s.trim()).filter(Boolean);
-}
-function hasRequiredAnalyticsScope(scopes) {
-	return (Array.isArray(scopes) ? scopes : parseGrantedScopes(scopes)).includes(GSCDUMP_REQUIRED_ANALYTICS_SCOPE);
-}
-function hasOptionalIndexingScope(scopes) {
-	return (Array.isArray(scopes) ? scopes : parseGrantedScopes(scopes)).includes(GSCDUMP_OPTIONAL_INDEXING_SCOPE);
-}
-export { GSCDUMP_ONBOARDING_CONTRACT_VERSION, GSCDUMP_OPTIONAL_INDEXING_SCOPE, GSCDUMP_REQUIRED_ANALYTICS_SCOPE, accountNextActions, accountStatuses, analyticsNextActions, analyticsStatuses, hasOptionalIndexingScope, hasRequiredAnalyticsScope, indexingNextActions, indexingStatuses, lifecycleErrorCodes, lifecycleWebhookEvents, parseGrantedScopes, propertyNextActions, propertyStatuses, querySourceModes, sitemapNextActions, sitemapStatuses };

package/dist/sitemap.d.mts

@@ -1,26 +0,0 @@
-interface DiscoverSitemapOptions {
-  /** User-Agent sent on the discovery requests. */
-  userAgent?: string;
-  /** AbortSignal threaded through fetches; defaults to a 10s timeout per call. */
-  signal?: AbortSignal;
-}
-/**
- * Try to discover a sitemap for `domain` by checking robots.txt for a
- * `Sitemap:` directive, then a small set of common paths. Returns the first
- * URL that responds with a 2xx, or `null`.
- */
-declare function discoverSitemap(domain: string, options?: DiscoverSitemapOptions): Promise<string | null>;
-interface FetchSitemapUrlsOptions extends DiscoverSitemapOptions {
-  /** Maximum nested sitemap-index depth to follow. Default 3. */
-  maxDepth?: number;
-  /** Stop after this many URLs (across all nested sitemaps). Default unlimited. */
-  limit?: number;
-}
-/**
- * Fetch a sitemap (or sitemap index) and return the list of `<loc>` URLs.
- * Sitemap-index files are followed up to `maxDepth` levels. Duplicates are
- * de-duplicated. The XML parser is regex-based — it handles the common
- * `<loc>https://...</loc>` shape but doesn't validate the schema.
- */
-declare function fetchSitemapUrls(sitemapUrl: string, options?: FetchSitemapUrlsOptions): Promise<string[]>;
-export { DiscoverSitemapOptions, FetchSitemapUrlsOptions, discoverSitemap, fetchSitemapUrls };

package/dist/sitemap.mjs

@@ -1,68 +0,0 @@
-const FETCH_TIMEOUT_MS = 1e4;
-const COMMON_PATHS = ["/sitemap.xml", "/sitemap_index.xml"];
-const SITEMAP_DIRECTIVE_RE = /^Sitemap:\s*(\S+)/im;
-async function discoverSitemap(domain, options = {}) {
-	const userAgent = options.userAgent ?? "gscdump sitemap fetcher";
-	const baseUrl = `https://${domain}`;
-	const signalFor = () => options.signal ?? AbortSignal.timeout(FETCH_TIMEOUT_MS);
-	const robotsRes = await fetch(`${baseUrl}/robots.txt`, {
-		headers: { "User-Agent": userAgent },
-		signal: signalFor()
-	}).catch(() => null);
-	if (robotsRes?.ok) {
-		const match = (await robotsRes.text()).match(SITEMAP_DIRECTIVE_RE);
-		if (match?.[1]) {
-			if ((await fetch(match[1], {
-				method: "HEAD",
-				signal: signalFor()
-			}).catch(() => null))?.ok) return match[1];
-		}
-	}
-	for (const path of COMMON_PATHS) {
-		const url = `${baseUrl}${path}`;
-		if ((await fetch(url, {
-			method: "HEAD",
-			headers: { "User-Agent": userAgent },
-			signal: signalFor()
-		}).catch(() => null))?.ok) return url;
-	}
-	return null;
-}
-const LOC_RE = /<loc>([^<]+)<\/loc>/gi;
-const SITEMAPINDEX_RE = /<sitemapindex\b/i;
-async function fetchSitemapUrls(sitemapUrl, options = {}) {
-	const userAgent = options.userAgent ?? "gscdump sitemap fetcher";
-	const maxDepth = options.maxDepth ?? 3;
-	const limit = options.limit;
-	const signalFor = () => options.signal ?? AbortSignal.timeout(FETCH_TIMEOUT_MS);
-	const seen = /* @__PURE__ */ new Set();
-	const out = [];
-	const visit = async (url, depth) => {
-		if (limit != null && out.length >= limit) return;
-		if (depth > maxDepth) return;
-		const res = await fetch(url, {
-			headers: { "User-Agent": userAgent },
-			signal: signalFor()
-		});
-		if (!res.ok) throw new Error(`Fetch ${url} failed: ${res.status}`);
-		const text = await res.text();
-		const isIndex = SITEMAPINDEX_RE.test(text);
-		const matches = [...text.matchAll(LOC_RE)].map((m) => m[1].trim()).filter(Boolean);
-		if (isIndex) {
-			for (const child of matches) {
-				if (limit != null && out.length >= limit) return;
-				await visit(child, depth + 1);
-			}
-			return;
-		}
-		for (const u of matches) {
-			if (seen.has(u)) continue;
-			seen.add(u);
-			out.push(u);
-			if (limit != null && out.length >= limit) return;
-		}
-	};
-	await visit(sitemapUrl, 0);
-	return out;
-}
-export { discoverSitemap, fetchSitemapUrls };

package/dist/tenant.d.mts

@@ -1,18 +0,0 @@
-declare function encodeSiteId(siteUrl: string): string;
-/**
- * Best-effort inverse of `encodeSiteId` for the common prefixes. Lossy
- * (`encodeSiteId` collapses non-word chars to `_` and strips trailing
- * underscores), but round-trips domain properties + https origins cleanly —
- * the only two shapes GSC hands out in practice.
- *
- * Returns the input unchanged when neither prefix is recognised, so callers
- * can pass through canonical site URLs without branching.
- */
-declare function decodeSiteId(encoded: string): string;
-/**
- * Normalize a siteUrl to the form Google APIs expect: domain properties get
- * the `sc-domain:` prefix added if missing, URL properties pass through.
- * Idempotent — safe to call on already-prefixed values.
- */
-declare function normalizeSiteUrl(siteUrl: string): string;
-export { decodeSiteId, encodeSiteId, normalizeSiteUrl };

package/dist/tenant.mjs

@@ -1,18 +0,0 @@
-const SC_DOMAIN_RE = /^sc-domain:/;
-const PROTOCOL_RE = /^https?:\/\//;
-const NON_ID_RE = /[^\w.-]/g;
-const TRAILING_UNDERSCORES_RE = /_+$/;
-function encodeSiteId(siteUrl) {
-	return siteUrl.replace(SC_DOMAIN_RE, "d_").replace(PROTOCOL_RE, "h_").replace(NON_ID_RE, "_").replace(TRAILING_UNDERSCORES_RE, "");
-}
-function decodeSiteId(encoded) {
-	if (encoded.startsWith("d_")) return `sc-domain:${encoded.slice(2)}`;
-	if (encoded.startsWith("h_")) return `https://${encoded.slice(2)}/`;
-	return encoded;
-}
-function normalizeSiteUrl(siteUrl) {
-	if (siteUrl.startsWith("sc-domain:")) return siteUrl;
-	if (siteUrl.startsWith("http://") || siteUrl.startsWith("https://")) return siteUrl;
-	return `sc-domain:${siteUrl}`;
-}
-export { decodeSiteId, encodeSiteId, normalizeSiteUrl };

package/dist/url.d.mts

@@ -1,9 +0,0 @@
-/**
- * Equivalence key for matching two URLs that point at the same resource
- * across protocol (http/https), www. prefix, trailing slash, and casing.
- * Returns `null` for unparseable input.
- *
- * Example: `https://www.Example.com/Foo/` → `example.com/foo`
- */
-declare function urlMatchKey(url: string): string | null;
-export { urlMatchKey };

package/dist/url.mjs

@@ -1,6 +0,0 @@
-function urlMatchKey(url) {
-	const u = URL.parse(url);
-	if (!u) return null;
-	return [u.hostname.replace(/^www\./, ""), u.pathname.replace(/\/$/, "") || "/"].join("").toLowerCase();
-}
-export { urlMatchKey };