gscdump 3.0.0 → 3.1.0

package/README.md

@@ -89,6 +89,12 @@ const evidence = await client.getIndexingEvidence(
 
 if (evidence.ok)
   console.log(evidence.value)
+
+const [pages, queries, crawl] = await Promise.all([
+  client.getPageStats('https://example.com/'),
+  client.getQueryStats('https://example.com/'),
+  client.getCrawlStats('https://example.com/'),
+])
 ```
 
 Sitemap XML reading and traversal lives in `sitemapd`. Product feed scoping and

package/dist/bing/client.mjs

@@ -1,5 +1,5 @@
 import { err, ok } from "../core/result.mjs";
-import { normalizeBingCrawlIssue, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo } from "./normalize.mjs";
+import { normalizeBingCrawlIssue, normalizeBingCrawlStats, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingQueryStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo } from "./normalize.mjs";
 const DEFAULT_BING_WEBMASTER_API_URL = "https://www.bing.com/webmaster/api.svc/json";
 const DEFAULT_BING_CHILD_PAGE_LIMIT = 100;
 const BING_MAX_CHILD_PAGE_COUNT = 65536;
@@ -206,6 +206,14 @@ function bingWebmaster(options) {
 			query: { siteUrl },
 			signal: callOptions?.signal
 		}),
+		getQueryStats: (siteUrl, callOptions) => request("GetQueryStats", parseList(normalizeBingQueryStats), {
+			query: { siteUrl },
+			signal: callOptions?.signal
+		}),
+		getCrawlStats: (siteUrl, callOptions) => request("GetCrawlStats", parseList(normalizeBingCrawlStats), {
+			query: { siteUrl },
+			signal: callOptions?.signal
+		}),
 		getCrawlIssues: (siteUrl, callOptions) => request("GetCrawlIssues", parseList(normalizeBingCrawlIssue), {
 			query: { siteUrl },
 			signal: callOptions?.signal

package/dist/bing/index.d.mts

@@ -1,4 +1,4 @@
-import { BingCallOptions, BingChildrenFilters, BingChildrenOptions, BingCrawlDateFilter, BingCrawlEvidence, BingCrawlIssue, BingCrawlIssueWire, BingDiscoveredDateFilter, BingDocumentFilter, BingEvidenceError, BingFetch, BingHttpCodeFilter, BingIndexingEvidence, BingOperation, BingPageStats, BingProviderError, BingQueryStatsWire, BingSite, BingSiteWire, BingUnknownEvidence, BingUrlInfo, BingUrlInfoWire, BingUrlTrafficInfo, BingUrlTrafficInfoWire, BingUrlWithCrawlIssues, BingWebmasterClient, BingWebmasterOptions, BingWireResponse } from "./types.mjs";
+import { BingCallOptions, BingChildrenFilters, BingChildrenOptions, BingCrawlDateFilter, BingCrawlEvidence, BingCrawlIssue, BingCrawlIssueWire, BingCrawlStats, BingCrawlStatsWire, BingDiscoveredDateFilter, BingDocumentFilter, BingEvidenceError, BingFetch, BingHttpCodeFilter, BingIndexingEvidence, BingOperation, BingPageStats, BingProviderError, BingQueryStats, BingQueryStatsWire, BingSite, BingSiteWire, BingUnknownEvidence, BingUrlInfo, BingUrlInfoWire, BingUrlTrafficInfo, BingUrlTrafficInfoWire, BingUrlWithCrawlIssues, BingWebmasterClient, BingWebmasterOptions, BingWireResponse } from "./types.mjs";
 import { DEFAULT_BING_CHILD_PAGE_LIMIT, DEFAULT_BING_WEBMASTER_API_URL, bingWebmaster } from "./client.mjs";
-import { normalizeBingCrawlIssue, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo } from "./normalize.mjs";
-export { type BingCallOptions, type BingChildrenFilters, type BingChildrenOptions, type BingCrawlDateFilter, type BingCrawlEvidence, type BingCrawlIssue, type BingCrawlIssueWire, type BingDiscoveredDateFilter, type BingDocumentFilter, type BingEvidenceError, type BingFetch, type BingHttpCodeFilter, type BingIndexingEvidence, type BingOperation, type BingPageStats, type BingProviderError, type BingQueryStatsWire, type BingSite, type BingSiteWire, type BingUnknownEvidence, type BingUrlInfo, type BingUrlInfoWire, type BingUrlTrafficInfo, type BingUrlTrafficInfoWire, type BingUrlWithCrawlIssues, type BingWebmasterClient, type BingWebmasterOptions, type BingWireResponse, DEFAULT_BING_CHILD_PAGE_LIMIT, DEFAULT_BING_WEBMASTER_API_URL, bingWebmaster, normalizeBingCrawlIssue, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo };
+import { normalizeBingCrawlIssue, normalizeBingCrawlStats, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingQueryStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo } from "./normalize.mjs";
+export { type BingCallOptions, type BingChildrenFilters, type BingChildrenOptions, type BingCrawlDateFilter, type BingCrawlEvidence, type BingCrawlIssue, type BingCrawlIssueWire, type BingCrawlStats, type BingCrawlStatsWire, type BingDiscoveredDateFilter, type BingDocumentFilter, type BingEvidenceError, type BingFetch, type BingHttpCodeFilter, type BingIndexingEvidence, type BingOperation, type BingPageStats, type BingProviderError, type BingQueryStats, type BingQueryStatsWire, type BingSite, type BingSiteWire, type BingUnknownEvidence, type BingUrlInfo, type BingUrlInfoWire, type BingUrlTrafficInfo, type BingUrlTrafficInfoWire, type BingUrlWithCrawlIssues, type BingWebmasterClient, type BingWebmasterOptions, type BingWireResponse, DEFAULT_BING_CHILD_PAGE_LIMIT, DEFAULT_BING_WEBMASTER_API_URL, bingWebmaster, normalizeBingCrawlIssue, normalizeBingCrawlStats, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingQueryStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo };

package/dist/bing/index.mjs

@@ -1,3 +1,3 @@
-import { normalizeBingCrawlIssue, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo } from "./normalize.mjs";
+import { normalizeBingCrawlIssue, normalizeBingCrawlStats, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingQueryStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo } from "./normalize.mjs";
 import { DEFAULT_BING_CHILD_PAGE_LIMIT, DEFAULT_BING_WEBMASTER_API_URL, bingWebmaster } from "./client.mjs";
-export { DEFAULT_BING_CHILD_PAGE_LIMIT, DEFAULT_BING_WEBMASTER_API_URL, bingWebmaster, normalizeBingCrawlIssue, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo };
+export { DEFAULT_BING_CHILD_PAGE_LIMIT, DEFAULT_BING_WEBMASTER_API_URL, bingWebmaster, normalizeBingCrawlIssue, normalizeBingCrawlStats, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingQueryStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo };

package/dist/bing/normalize.d.mts

@@ -1,9 +1,11 @@
 import { Result } from "../core/result.mjs";
-import { BingEvidenceError, BingIndexingEvidence, BingPageStats, BingSite, BingUrlInfo, BingUrlTrafficInfo, BingUrlWithCrawlIssues } from "./types.mjs";
+import { BingCrawlStats, BingEvidenceError, BingIndexingEvidence, BingPageStats, BingQueryStats, BingSite, BingUrlInfo, BingUrlTrafficInfo, BingUrlWithCrawlIssues } from "./types.mjs";
 declare function normalizeBingSite(value: unknown): Result<BingSite, 'invalid-payload'>;
 declare function normalizeBingUrlInfo(value: unknown): Result<BingUrlInfo, 'invalid-payload'>;
 declare function normalizeBingUrlTrafficInfo(value: unknown): Result<BingUrlTrafficInfo, 'invalid-payload'>;
 declare function normalizeBingPageStats(value: unknown): Result<BingPageStats, 'invalid-payload'>;
+declare function normalizeBingQueryStats(value: unknown): Result<BingQueryStats, 'invalid-payload'>;
+declare function normalizeBingCrawlStats(value: unknown): Result<BingCrawlStats, 'invalid-payload'>;
 declare function normalizeBingCrawlIssue(value: unknown): Result<BingUrlWithCrawlIssues, 'invalid-payload'>;
 declare function normalizeBingIndexingEvidence(info: BingUrlInfo | null, url: string, observedAt: Date): Result<BingIndexingEvidence, BingEvidenceError>;
-export { normalizeBingCrawlIssue, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo };
+export { normalizeBingCrawlIssue, normalizeBingCrawlStats, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingQueryStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo };

package/dist/bing/normalize.mjs

@@ -7,6 +7,15 @@ function isRecord(value) {
 function isNonNegativeInteger(value) {
 	return typeof value === "number" && Number.isInteger(value) && value >= 0;
 }
+function isNonNegativeNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0;
+}
+function isBingAveragePosition(value) {
+	return value === -1 || isNonNegativeNumber(value);
+}
+function normalizeBingAveragePosition(value) {
+	return value === -1 ? null : value;
+}
 function parseBingDate(value) {
 	if (value === void 0 || value === null) return ok(void 0);
 	if (typeof value !== "string") return err("invalid-date");
@@ -51,17 +60,57 @@ function normalizeBingUrlTrafficInfo(value) {
 		url: value.Url
 	});
 }
-function normalizeBingPageStats(value) {
-	if (!isRecord(value) || !isNonNegativeInteger(value.AvgClickPosition) || !isNonNegativeInteger(value.AvgImpressionPosition) || !isNonNegativeInteger(value.Clicks) || !isNonNegativeInteger(value.Impressions) || typeof value.Query !== "string") return err("invalid-payload");
+function normalizeBingTrafficStats(value) {
+	if (!isRecord(value) || !isBingAveragePosition(value.AvgClickPosition) || !isBingAveragePosition(value.AvgImpressionPosition) || !isNonNegativeInteger(value.Clicks) || !isNonNegativeInteger(value.Impressions) || typeof value.Query !== "string") return err("invalid-payload");
 	const date = parseBingDate(value.Date);
 	if (!date.ok || !date.value) return err("invalid-payload");
 	return ok({
-		averageClickPosition: value.AvgClickPosition,
-		averageImpressionPosition: value.AvgImpressionPosition,
+		averageClickPosition: normalizeBingAveragePosition(value.AvgClickPosition),
+		averageImpressionPosition: normalizeBingAveragePosition(value.AvgImpressionPosition),
 		clicks: value.Clicks,
 		date: date.value,
-		impressions: value.Impressions,
-		query: value.Query
+		dimension: value.Query,
+		impressions: value.Impressions
+	});
+}
+function normalizeBingPageStats(value) {
+	const parsed = normalizeBingTrafficStats(value);
+	if (!parsed.ok) return parsed;
+	const { dimension, ...stats } = parsed.value;
+	return ok({
+		...stats,
+		page: dimension
+	});
+}
+function normalizeBingQueryStats(value) {
+	const parsed = normalizeBingTrafficStats(value);
+	if (!parsed.ok) return parsed;
+	const { dimension, ...stats } = parsed.value;
+	return ok({
+		...stats,
+		query: dimension
+	});
+}
+function normalizeBingCrawlStats(value) {
+	if (!isRecord(value) || !isNonNegativeInteger(value.AllOtherCodes) || !isNonNegativeInteger(value.BlockedByRobotsTxt) || !isNonNegativeInteger(value.Code2xx) || !isNonNegativeInteger(value.Code301) || !isNonNegativeInteger(value.Code302) || !isNonNegativeInteger(value.Code4xx) || !isNonNegativeInteger(value.Code5xx) || value.ConnectionTimeout !== void 0 && !isNonNegativeInteger(value.ConnectionTimeout) || !isNonNegativeInteger(value.ContainsMalware) || !isNonNegativeInteger(value.CrawlErrors) || !isNonNegativeInteger(value.CrawledPages) || value.DnsFailures !== void 0 && !isNonNegativeInteger(value.DnsFailures) || !isNonNegativeInteger(value.InIndex) || !isNonNegativeInteger(value.InLinks)) return err("invalid-payload");
+	const date = parseBingDate(value.Date);
+	if (!date.ok || !date.value) return err("invalid-payload");
+	return ok({
+		allOtherCodes: value.AllOtherCodes,
+		blockedByRobotsTxt: value.BlockedByRobotsTxt,
+		code2xx: value.Code2xx,
+		code301: value.Code301,
+		code302: value.Code302,
+		code4xx: value.Code4xx,
+		code5xx: value.Code5xx,
+		...value.ConnectionTimeout === void 0 ? {} : { connectionTimeout: value.ConnectionTimeout },
+		containsMalware: value.ContainsMalware,
+		crawlErrors: value.CrawlErrors,
+		crawledPages: value.CrawledPages,
+		date: date.value,
+		...value.DnsFailures === void 0 ? {} : { dnsFailures: value.DnsFailures },
+		inIndex: value.InIndex,
+		inLinks: value.InLinks
 	});
 }
 const CRAWL_ISSUES = {
@@ -121,4 +170,4 @@ function normalizeBingIndexingEvidence(info, url, observedAt) {
 		url
 	});
 }
-export { normalizeBingCrawlIssue, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo };
+export { normalizeBingCrawlIssue, normalizeBingCrawlStats, normalizeBingIndexingEvidence, normalizeBingPageStats, normalizeBingQueryStats, normalizeBingSite, normalizeBingUrlInfo, normalizeBingUrlTrafficInfo };

package/dist/bing/types.d.mts

@@ -33,6 +33,24 @@ interface BingQueryStatsWire {
   Impressions: number;
   Query: string;
 }
+interface BingCrawlStatsWire {
+  __type?: string;
+  AllOtherCodes: number;
+  BlockedByRobotsTxt: number;
+  Code2xx: number;
+  Code301: number;
+  Code302: number;
+  Code4xx: number;
+  Code5xx: number;
+  ConnectionTimeout?: number;
+  ContainsMalware: number;
+  CrawlErrors: number;
+  CrawledPages: number;
+  Date: string;
+  DnsFailures?: number;
+  InIndex: number;
+  InLinks: number;
+}
 interface BingCrawlIssueWire {
   __type?: string;
   HttpCode: number;
@@ -64,13 +82,38 @@ interface BingUrlTrafficInfo {
   url: string;
 }
 interface BingPageStats {
-  averageClickPosition: number;
-  averageImpressionPosition: number;
+  averageClickPosition: number | null;
+  averageImpressionPosition: number | null;
+  clicks: number;
+  date: string;
+  impressions: number;
+  page: string;
+}
+interface BingQueryStats {
+  averageClickPosition: number | null;
+  averageImpressionPosition: number | null;
   clicks: number;
   date: string;
   impressions: number;
   query: string;
 }
+interface BingCrawlStats {
+  allOtherCodes: number;
+  blockedByRobotsTxt: number;
+  code2xx: number;
+  code301: number;
+  code302: number;
+  code4xx: number;
+  code5xx: number;
+  connectionTimeout?: number;
+  containsMalware: number;
+  crawlErrors: number;
+  crawledPages: number;
+  date: string;
+  dnsFailures?: number;
+  inIndex: number;
+  inLinks: number;
+}
 type BingCrawlIssue = 'none' | '301' | '302' | '4xx' | '5xx' | 'blocked-by-robots-txt' | 'contains-malware' | 'important-url-blocked-by-robots-txt' | 'dns-errors' | 'timeout-errors' | 'unknown';
 interface BingUrlWithCrawlIssues {
   httpCode: number;
@@ -143,7 +186,7 @@ interface BingEvidenceError {
   reason: 'not-a-page';
   url: string;
 }
-type BingOperation = 'GetUserSites' | 'GetUrlInfo' | 'GetUrlTrafficInfo' | 'GetChildrenUrlInfo' | 'GetPageStats' | 'GetCrawlIssues';
+type BingOperation = 'GetUserSites' | 'GetUrlInfo' | 'GetUrlTrafficInfo' | 'GetChildrenUrlInfo' | 'GetPageStats' | 'GetQueryStats' | 'GetCrawlStats' | 'GetCrawlIssues';
 interface BingCallOptions {
   signal?: AbortSignal;
 }
@@ -169,6 +212,8 @@ interface BingWebmasterClient {
   getUrlTrafficInfo: (siteUrl: string, url: string, options?: BingCallOptions) => Promise<Result<BingUrlTrafficInfo | null, BingProviderError>>;
   getChildrenUrlInfo: (siteUrl: string, url: string, options?: BingChildrenOptions) => Promise<Result<BingUrlInfo[], BingProviderError>>;
   getPageStats: (siteUrl: string, options?: BingCallOptions) => Promise<Result<BingPageStats[], BingProviderError>>;
+  getQueryStats: (siteUrl: string, options?: BingCallOptions) => Promise<Result<BingQueryStats[], BingProviderError>>;
+  getCrawlStats: (siteUrl: string, options?: BingCallOptions) => Promise<Result<BingCrawlStats[], BingProviderError>>;
   getCrawlIssues: (siteUrl: string, options?: BingCallOptions) => Promise<Result<BingUrlWithCrawlIssues[], BingProviderError>>;
 }
 type BingFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
@@ -178,4 +223,4 @@ interface BingWebmasterOptions {
   clock?: () => Date;
   fetch?: BingFetch;
 }
-export { BingCallOptions, BingChildrenFilters, BingChildrenOptions, BingCrawlDateFilter, BingCrawlEvidence, BingCrawlIssue, BingCrawlIssueWire, BingDiscoveredDateFilter, BingDocumentFilter, BingEvidenceError, BingFetch, BingHttpCodeFilter, BingIndexingEvidence, BingOperation, BingPageStats, BingProviderError, BingQueryStatsWire, BingSite, BingSiteWire, BingUnknownEvidence, BingUrlInfo, BingUrlInfoWire, BingUrlTrafficInfo, BingUrlTrafficInfoWire, BingUrlWithCrawlIssues, BingWebmasterClient, BingWebmasterOptions, BingWireResponse };
+export { BingCallOptions, BingChildrenFilters, BingChildrenOptions, BingCrawlDateFilter, BingCrawlEvidence, BingCrawlIssue, BingCrawlIssueWire, BingCrawlStats, BingCrawlStatsWire, BingDiscoveredDateFilter, BingDocumentFilter, BingEvidenceError, BingFetch, BingHttpCodeFilter, BingIndexingEvidence, BingOperation, BingPageStats, BingProviderError, BingQueryStats, BingQueryStatsWire, BingSite, BingSiteWire, BingUnknownEvidence, BingUrlInfo, BingUrlInfoWire, BingUrlTrafficInfo, BingUrlTrafficInfoWire, BingUrlWithCrawlIssues, BingWebmasterClient, BingWebmasterOptions, BingWireResponse };

package/dist/client.d.mts

@@ -0,0 +1,4 @@
+import { Auth, AuthClient, AuthOptions, CallOptions, DEFAULT_GSC_REQUEST_TIMEOUT_MS, GoogleSearchConsoleClient, GoogleSearchConsoleClientOptions, QueryReturn, VerificationMethod, VerificationSite, VerificationSiteType, VerificationToken, VerificationWebResource, createAuth, createFetch, googleSearchConsole } from "./core/client.mjs";
+import { GSC_INDEXING_SCOPE, GSC_READ_SCOPE, GSC_SITE_VERIFICATION_SCOPE, GSC_WRITE_SCOPE, hasGoogleScope } from "./core/scope-values.mjs";
+import { hasGscReadScope, hasGscWriteScope, hasIndexingScope } from "./core/scopes.mjs";
+export { type Auth, type AuthClient, type AuthOptions, type CallOptions, DEFAULT_GSC_REQUEST_TIMEOUT_MS, GSC_INDEXING_SCOPE, GSC_READ_SCOPE, GSC_SITE_VERIFICATION_SCOPE, GSC_WRITE_SCOPE, type GoogleSearchConsoleClient, type GoogleSearchConsoleClientOptions, type QueryReturn, type VerificationMethod, type VerificationSite, type VerificationSiteType, type VerificationToken, type VerificationWebResource, createAuth, createFetch, googleSearchConsole, hasGoogleScope, hasGscReadScope, hasGscWriteScope, hasIndexingScope };

package/dist/client.mjs

@@ -0,0 +1,4 @@
+import { GSC_INDEXING_SCOPE, GSC_READ_SCOPE, GSC_SITE_VERIFICATION_SCOPE, GSC_WRITE_SCOPE, hasGoogleScope } from "./core/scope-values.mjs";
+import { hasGscReadScope, hasGscWriteScope, hasIndexingScope } from "./core/scopes.mjs";
+import { DEFAULT_GSC_REQUEST_TIMEOUT_MS, createAuth, createFetch, googleSearchConsole } from "./core/client.mjs";
+export { DEFAULT_GSC_REQUEST_TIMEOUT_MS, GSC_INDEXING_SCOPE, GSC_READ_SCOPE, GSC_SITE_VERIFICATION_SCOPE, GSC_WRITE_SCOPE, createAuth, createFetch, googleSearchConsole, hasGoogleScope, hasGscReadScope, hasGscWriteScope, hasIndexingScope };

package/dist/contracts.d.mts

@@ -1,3 +1,4 @@
+import { GscSearchType, GscSearchType as GscSearchType$1 } from "@gscdump/contracts/search-types";
 import { ColumnDef, ColumnType, Row, TableName, TableSchema, TenantCtx } from "@gscdump/contracts";
 type GscSearchAnalyticsDimension = 'page' | 'query' | 'country' | 'device' | 'date' | 'hour' | 'searchAppearance';
 type GscDataState = 'final' | 'all' | 'hourly_all';
@@ -17,7 +18,6 @@ interface GscSearchAnalyticsFilterGroup {
   groupType?: 'and' | 'or';
   filters: GscSearchAnalyticsFilter[];
 }
-type GscSearchType = 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
 type GscAggregationType = 'auto' | 'byPage' | 'byProperty' | 'byNewsShowcasePanel';
 type GscResponseAggregationType = 'auto' | 'byPage' | 'byProperty' | 'byNewsShowcasePanel';
 interface GscSearchAnalyticsRequest {
@@ -28,7 +28,7 @@ interface GscSearchAnalyticsRequest {
   rowLimit?: number;
   startRow?: number;
   /** GSC search corpus. Maps to wire field `type` (the API still accepts the deprecated `searchType` alias). */
-  type?: GscSearchType;
+  type?: GscSearchType$1;
   dataState?: GscDataState;
   aggregationType?: GscAggregationType;
 }
@@ -44,4 +44,4 @@ interface GscSearchAnalyticsResponse {
   responseAggregationType?: GscResponseAggregationType;
   metadata?: GscSearchAnalyticsMetadata;
 }
-export { type ColumnDef, type ColumnType, GscAggregationType, GscDataState, GscResponseAggregationType, GscSearchAnalyticsDimension, GscSearchAnalyticsFilter, GscSearchAnalyticsFilterGroup, GscSearchAnalyticsFilterOperator, GscSearchAnalyticsMetadata, GscSearchAnalyticsRequest, GscSearchAnalyticsResponse, GscSearchAnalyticsRow, GscSearchType, type Row, type TableName, type TableSchema, type TenantCtx };
+export { type ColumnDef, type ColumnType, GscAggregationType, GscDataState, GscResponseAggregationType, GscSearchAnalyticsDimension, GscSearchAnalyticsFilter, GscSearchAnalyticsFilterGroup, GscSearchAnalyticsFilterOperator, GscSearchAnalyticsMetadata, GscSearchAnalyticsRequest, GscSearchAnalyticsResponse, GscSearchAnalyticsRow, type GscSearchType, type Row, type TableName, type TableSchema, type TenantCtx };

package/dist/core/window.d.mts

@@ -0,0 +1,20 @@
+type WindowPreset = 'last-7d' | 'last-28d' | 'last-30d' | 'last-90d' | 'last-180d' | 'last-365d' | 'mtd' | 'ytd' | 'custom';
+type ComparisonMode = 'none' | 'prev-period' | 'yoy';
+interface ResolveWindowOptions {
+  preset: WindowPreset;
+  comparison?: ComparisonMode;
+  anchor?: string;
+  start?: string;
+  end?: string;
+}
+interface ResolvedWindow {
+  start: string;
+  end: string;
+  days: number;
+  comparison?: {
+    start: string;
+    end: string;
+  };
+}
+declare function resolveWindow(opts: ResolveWindowOptions): ResolvedWindow;
+export { ComparisonMode, ResolveWindowOptions, ResolvedWindow, WindowPreset, resolveWindow };

package/dist/core/window.mjs

@@ -0,0 +1,63 @@
+import { addDays, countDays, toIsoDate } from "./gsc-dates.mjs";
+function resolveWindow(opts) {
+	const anchor = opts.anchor ? /* @__PURE__ */ new Date(`${opts.anchor}T00:00:00Z`) : /* @__PURE__ */ new Date();
+	const anchorIso = toIsoDate(anchor);
+	let start;
+	let end;
+	switch (opts.preset) {
+		case "last-7d":
+			end = anchorIso;
+			start = addDays(anchorIso, -6);
+			break;
+		case "last-28d":
+			end = anchorIso;
+			start = addDays(anchorIso, -27);
+			break;
+		case "last-30d":
+			end = anchorIso;
+			start = addDays(anchorIso, -29);
+			break;
+		case "last-90d":
+			end = anchorIso;
+			start = addDays(anchorIso, -89);
+			break;
+		case "last-180d":
+			end = anchorIso;
+			start = addDays(anchorIso, -179);
+			break;
+		case "last-365d":
+			end = anchorIso;
+			start = addDays(anchorIso, -364);
+			break;
+		case "mtd":
+			end = anchorIso;
+			start = toIsoDate(new Date(Date.UTC(anchor.getUTCFullYear(), anchor.getUTCMonth(), 1)));
+			break;
+		case "ytd":
+			end = anchorIso;
+			start = toIsoDate(new Date(Date.UTC(anchor.getUTCFullYear(), 0, 1)));
+			break;
+		case "custom":
+			if (!opts.start || !opts.end) throw new Error("resolveWindow: preset=custom requires start and end");
+			start = opts.start;
+			end = opts.end;
+	}
+	const days = countDays(start, end);
+	const result = {
+		start,
+		end,
+		days
+	};
+	if (opts.comparison === "prev-period") {
+		const previousEnd = addDays(start, -1);
+		result.comparison = {
+			start: addDays(previousEnd, -(days - 1)),
+			end: previousEnd
+		};
+	} else if (opts.comparison === "yoy") result.comparison = {
+		start: addDays(start, -365),
+		end: addDays(end, -365)
+	};
+	return result;
+}
+export { resolveWindow };

package/dist/dates.d.mts

@@ -1,3 +1,5 @@
+import { Period, ResolvedAnalyticsRange } from "./core/types.mjs";
 import { DAYS_PER_RANGE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_RETENTION_MONTHS, MS_PER_DAY, addDays, countDays, daysAgo, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getLatestGscDate, getNextDate, getOldestGscDate, getPendingDates, getPstDate, groupIntoRanges, toIsoDate } from "./core/gsc-dates.mjs";
+import { ComparisonMode, ResolveWindowOptions, ResolvedWindow, WindowPreset, resolveWindow } from "./core/window.mjs";
 import { currentPstDate, daysAgoPst } from "./query/utils/dayjs.mjs";
-export { DAYS_PER_RANGE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_RETENTION_MONTHS, MS_PER_DAY, addDays, countDays, currentPstDate, daysAgoPst, daysAgo as daysAgoUtc, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getLatestGscDate, getNextDate, getOldestGscDate, getPendingDates, getPstDate, groupIntoRanges, toIsoDate };
+export { type ComparisonMode, DAYS_PER_RANGE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_RETENTION_MONTHS, MS_PER_DAY, type Period, type ResolveWindowOptions, type ResolvedAnalyticsRange, type ResolvedWindow, type WindowPreset, addDays, countDays, currentPstDate, daysAgoPst, daysAgo as daysAgoUtc, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getLatestGscDate, getNextDate, getOldestGscDate, getPendingDates, getPstDate, groupIntoRanges, resolveWindow, toIsoDate };

package/dist/dates.mjs

@@ -1,3 +1,4 @@
 import { DAYS_PER_RANGE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_RETENTION_MONTHS, MS_PER_DAY, addDays, countDays, daysAgo, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getLatestGscDate, getNextDate, getOldestGscDate, getPendingDates, getPstDate, groupIntoRanges, toIsoDate } from "./core/gsc-dates.mjs";
 import { currentPstDate, daysAgoPst } from "./query/utils/dayjs.mjs";
-export { DAYS_PER_RANGE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_RETENTION_MONTHS, MS_PER_DAY, addDays, countDays, currentPstDate, daysAgoPst, daysAgo as daysAgoUtc, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getLatestGscDate, getNextDate, getOldestGscDate, getPendingDates, getPstDate, groupIntoRanges, toIsoDate };
+import { resolveWindow } from "./core/window.mjs";
+export { DAYS_PER_RANGE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_RETENTION_MONTHS, MS_PER_DAY, addDays, countDays, currentPstDate, daysAgoPst, daysAgo as daysAgoUtc, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getLatestGscDate, getNextDate, getOldestGscDate, getPendingDates, getPstDate, groupIntoRanges, resolveWindow, toIsoDate };

package/dist/errors.d.mts

@@ -0,0 +1,2 @@
+import { GscApiError, GscApiErrorInfo, GscError, GscErrorKind, classifyError, gscErrorToException, isPermissionDeniedError, parseGoogleError, rethrowAsGscApiError } from "./core/errors.mjs";
+export { GscApiError, type GscApiErrorInfo, type GscError, type GscErrorKind, classifyError, gscErrorToException, isPermissionDeniedError, parseGoogleError, rethrowAsGscApiError };

package/dist/errors.mjs

@@ -0,0 +1,2 @@
+import { GscApiError, classifyError, gscErrorToException, isPermissionDeniedError, parseGoogleError, rethrowAsGscApiError } from "./core/errors.mjs";
+export { GscApiError, classifyError, gscErrorToException, isPermissionDeniedError, parseGoogleError, rethrowAsGscApiError };

package/dist/index.d.mts

@@ -1,11 +1,13 @@
 import { Err, Ok, Result, err, isErr, isOk, ok, unwrapResult } from "./core/result.mjs";
-import { BackfillProgress, DAYS_PER_RANGE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_RETENTION_MONTHS, MS_PER_DAY, addDays, countDays, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getLatestGscDate, getNextDate, getOldestGscDate, getPendingDates, getPreviousDate, getPstDate, groupIntoRanges, isValidGscDate, toIsoDate } from "./core/gsc-dates.mjs";
-import { runSequentialBatch } from "./api/batch.mjs";
 import { AmpInspectionResult, AmpIssue, ApiSite, ApiSitemap, ApiSitemapContent, DataRow, DimensionFilter, DimensionFilterGroup, IndexStatusResult, InspectUrlIndexResponse, MobileUsabilityIssue, MobileUsabilityResult, Period, PublishUrlNotificationResponse, RequiredNonNullable, ResolvedAnalyticsRange, RichResultsDetectedItem, RichResultsIssue, RichResultsItem, RichResultsResult, SearchAnalyticsMetadata, SearchAnalyticsQuery, SearchAnalyticsResponse, Site, SiteAnalytics, UrlInspectionResult, UrlNotification, UrlNotificationMetadata } from "./core/types.mjs";
 import { Auth, AuthClient, AuthOptions, CallOptions, DEFAULT_GSC_REQUEST_TIMEOUT_MS, GoogleSearchConsoleClient, GoogleSearchConsoleClientOptions, QueryReturn, VerificationMethod, VerificationSite, VerificationSiteType, VerificationToken, VerificationWebResource, createAuth, createFetch, googleSearchConsole } from "./core/client.mjs";
+import { GSC_INDEXING_SCOPE, GSC_READ_SCOPE, GSC_SITE_VERIFICATION_SCOPE, GSC_WRITE_SCOPE, hasGoogleScope } from "./core/scope-values.mjs";
+import { hasGscReadScope, hasGscWriteScope, hasIndexingScope } from "./core/scopes.mjs";
+import { BackfillProgress, DAYS_PER_RANGE, GSC_FINALIZED_LAG_DAYS, GSC_FRESHEST_LAG_DAYS, GSC_RETENTION_MONTHS, MS_PER_DAY, addDays, countDays, generateGscDateRange, getBackfillProgress, getDateRange, getFreshestGscDate, getLatestGscDate, getNextDate, getOldestGscDate, getPendingDates, getPreviousDate, getPstDate, groupIntoRanges, isValidGscDate, toIsoDate } from "./core/gsc-dates.mjs";
+import { GscApiError, GscApiErrorInfo, GscError, GscErrorKind, classifyError, gscErrorToException, isPermissionDeniedError, parseGoogleError, rethrowAsGscApiError } from "./core/errors.mjs";
+import { runSequentialBatch } from "./api/batch.mjs";
 import { IndexingMetadata, IndexingNotificationType, IndexingResult, batchRequestIndexing, getIndexingMetadata, requestIndexing } from "./api/indexing.mjs";
 import { BatchInspectUrlsFlatSettledOptions, IndexingEligibility, IndexingIneligibleReason, InspectUrlFlatSettledResult, InspectUrlResult, InspectionPriority, LegacyInspectionPriority, MAX_FLAT_INSPECTION_BATCH_CONCURRENCY, ParsedIndexingResult, ValueWeightedInspectionPriority, batchInspectUrls, batchInspectUrlsFlatSettled, canUseUrlInspection, getIndexingEligibility, getNextCheckAfter, getNextCheckPriority, inspectUrl, inspectUrlFlat } from "./api/inspection.mjs";
-import { GscApiError, GscApiErrorInfo, GscError, GscErrorKind, classifyError, gscErrorToException, isPermissionDeniedError, parseGoogleError, rethrowAsGscApiError } from "./core/errors.mjs";
 import { OAuthTokenInfo, OAuthTokens, exchangeAuthCodeResult, introspectAccessToken, introspectAccessTokenResult, refreshAccessToken, revokeOAuthToken, revokeOAuthTokenResult } from "./api/oauth.mjs";
 import { FetchSitesWithSitemapsOptions, addSite, deleteSite, deleteSitemap, fetchSitemap, fetchSitemaps, fetchSites, fetchSitesWithSitemaps, submitSitemap } from "./api/sites.mjs";
 import { getVerificationToken, getVerifiedSite, listVerifiedSites, resolveVerificationTarget, siteUrlToVerificationSite, unverifySite, verificationMethodsFor, verifySite } from "./api/verification.mjs";
@@ -13,8 +15,6 @@ import { CanonicalDifferenceKind, classifyCanonicalDifference, isCanonicalMismat
 import { INDEXING_ISSUE_FILTERS, INDEXING_ISSUE_LABELS, INDEXING_ISSUE_SEVERITY, IndexingIssueType, KNOWN_COVERAGE_STATES, KNOWN_PAGE_FETCH_STATES, UnmappedInspectionReasons, isFragmentUrl, unmappedInspectionReasons } from "./core/indexing-issues.mjs";
 import { GscPropertyCandidate, findBestGscProperty, findExactGscProperty, formatGscPropertyCandidates, gscPropertyMatchesTarget, isVerifiedGscPermission, isVerifiedGscProperty, matchGscSite, pickBestGscProperty } from "./core/property.mjs";
 import { URL_INSPECTION_EFFECTIVE_LIMIT } from "./core/quota.mjs";
-import { GSC_INDEXING_SCOPE, GSC_READ_SCOPE, GSC_SITE_VERIFICATION_SCOPE, GSC_WRITE_SCOPE, hasGoogleScope } from "./core/scope-values.mjs";
-import { hasGscReadScope, hasGscWriteScope, hasIndexingScope } from "./core/scopes.mjs";
 import { ParsedGscSiteUrl, normalizeGscSiteUrl, normalizeRegistrationTarget, parseGscSiteUrl } from "./core/site-url.mjs";
 import { normalizeUrl } from "./normalize.mjs";
 import { 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 } from "./onboarding.mjs";

package/dist/indexing.d.mts

@@ -0,0 +1,5 @@
+import { UrlInspectionResult } from "./core/types.mjs";
+import { runSequentialBatch } from "./api/batch.mjs";
+import { IndexingMetadata, IndexingNotificationType, IndexingResult, batchRequestIndexing, getIndexingMetadata, requestIndexing } from "./api/indexing.mjs";
+import { BatchInspectUrlsFlatSettledOptions, IndexingEligibility, IndexingIneligibleReason, InspectUrlFlatSettledResult, InspectUrlResult, InspectionPriority, LegacyInspectionPriority, MAX_FLAT_INSPECTION_BATCH_CONCURRENCY, ParsedIndexingResult, ValueWeightedInspectionPriority, batchInspectUrls, batchInspectUrlsFlatSettled, canUseUrlInspection, getIndexingEligibility, getNextCheckAfter, getNextCheckPriority, inspectUrl, inspectUrlFlat } from "./api/inspection.mjs";
+export { type BatchInspectUrlsFlatSettledOptions, type IndexingEligibility, type IndexingIneligibleReason, type IndexingMetadata, type IndexingNotificationType, type IndexingResult, type InspectUrlFlatSettledResult, type InspectUrlResult, type InspectionPriority, type LegacyInspectionPriority, MAX_FLAT_INSPECTION_BATCH_CONCURRENCY, type ParsedIndexingResult, type UrlInspectionResult, type ValueWeightedInspectionPriority, batchInspectUrls, batchInspectUrlsFlatSettled, batchRequestIndexing, canUseUrlInspection, getIndexingEligibility, getIndexingMetadata, getNextCheckAfter, getNextCheckPriority, inspectUrl, inspectUrlFlat, requestIndexing, runSequentialBatch };

package/dist/indexing.mjs

@@ -0,0 +1,4 @@
+import { runSequentialBatch } from "./api/batch.mjs";
+import { batchRequestIndexing, getIndexingMetadata, requestIndexing } from "./api/indexing.mjs";
+import { MAX_FLAT_INSPECTION_BATCH_CONCURRENCY, batchInspectUrls, batchInspectUrlsFlatSettled, canUseUrlInspection, getIndexingEligibility, getNextCheckAfter, getNextCheckPriority, inspectUrl, inspectUrlFlat } from "./api/inspection.mjs";
+export { MAX_FLAT_INSPECTION_BATCH_CONCURRENCY, batchInspectUrls, batchInspectUrlsFlatSettled, batchRequestIndexing, canUseUrlInspection, getIndexingEligibility, getIndexingMetadata, getNextCheckAfter, getNextCheckPriority, inspectUrl, inspectUrlFlat, requestIndexing, runSequentialBatch };

package/dist/query/constants.d.mts

@@ -1,19 +1,11 @@
 import _default from "./utils/countries.mjs";
+import { GSC_SEARCH_TYPES as SearchTypes, GscSearchType as SearchType } from "@gscdump/contracts/search-types";
 declare const Devices: {
   readonly MOBILE: "MOBILE";
   readonly DESKTOP: "DESKTOP";
   readonly TABLET: "TABLET";
 };
 type Device = typeof Devices[keyof typeof Devices];
-declare const SearchTypes: {
-  readonly WEB: "web";
-  readonly IMAGE: "image";
-  readonly VIDEO: "video";
-  readonly NEWS: "news";
-  readonly DISCOVER: "discover";
-  readonly GOOGLE_NEWS: "googleNews";
-};
-type SearchType = typeof SearchTypes[keyof typeof SearchTypes];
 declare const Countries: { [K in (typeof _default)[number]["alpha-3"]]: Lowercase<K>; };
 type Country = typeof Countries[keyof typeof Countries];
-export { Countries, Country, Device, Devices, SearchType, SearchTypes };
+export { Countries, Country, Device, Devices, type SearchType, SearchTypes };

package/dist/query/constants.mjs

@@ -1,16 +1,9 @@
 import countries_default from "./utils/countries.mjs";
+import { GSC_SEARCH_TYPES as SearchTypes } from "@gscdump/contracts/search-types";
 const Devices = {
 	MOBILE: "MOBILE",
 	DESKTOP: "DESKTOP",
 	TABLET: "TABLET"
 };
-const SearchTypes = {
-	WEB: "web",
-	IMAGE: "image",
-	VIDEO: "video",
-	NEWS: "news",
-	DISCOVER: "discover",
-	GOOGLE_NEWS: "googleNews"
-};
 const Countries = Object.fromEntries(countries_default.map((c) => [c["alpha-3"], c["alpha-3"].toLowerCase()]));
 export { Countries, Devices, SearchTypes };

package/dist/query/index.d.mts

@@ -1,7 +1,7 @@
-import { currentPstDate } from "./utils/dayjs.mjs";
 import { Countries, Country, Device, Devices, SearchType, SearchTypes } from "./constants.mjs";
 import { BuilderState, Column, Dimension, DimensionValueMap, Filter, FilterInput, GSCResult, GSCRow, InternalFilter, JsonFilter, JsonInternalFilter, Metric, MetricColumn, QueryParam, QueryParamName, QueryParamValueMap } from "./types.mjs";
 import { GSCQueryBuilder, gsc } from "./builder.mjs";
+import { currentPstDate } from "./utils/dayjs.mjs";
 import { clicks, country, ctr, date, device, hour, impressions, page, position, query, queryCanonical, searchAppearance, searchType } from "./columns.mjs";
 import { QueryError, QueryErrorKind, UnresolvableDatasetError, UnsupportedLogicalCapabilityError, isQueryError, queryErrorToException, queryErrors } from "./errors.mjs";
 import { and, between, contains, eq, gt, gte, inArray, like, lt, lte, ne, not, notRegex, or, regex, topLevel } from "./operators.mjs";

package/dist/sites.d.mts

@@ -0,0 +1,5 @@
+import { ApiSite, ApiSitemap, Site } from "./core/types.mjs";
+import { VerificationMethod, VerificationSite, VerificationToken, VerificationWebResource } from "./core/client.mjs";
+import { FetchSitesWithSitemapsOptions, addSite, deleteSite, deleteSitemap, fetchSitemap, fetchSitemaps, fetchSites, fetchSitesWithSitemaps, submitSitemap } from "./api/sites.mjs";
+import { getVerificationToken, getVerifiedSite, listVerifiedSites, resolveVerificationTarget, siteUrlToVerificationSite, unverifySite, verificationMethodsFor, verifySite } from "./api/verification.mjs";
+export { type ApiSite, type ApiSitemap, type FetchSitesWithSitemapsOptions, type Site, type VerificationMethod, type VerificationSite, type VerificationToken, type VerificationWebResource, addSite, deleteSite, deleteSitemap, fetchSitemap, fetchSitemaps, fetchSites, fetchSitesWithSitemaps, getVerificationToken, getVerifiedSite, listVerifiedSites, resolveVerificationTarget, siteUrlToVerificationSite, submitSitemap, unverifySite, verificationMethodsFor, verifySite };

package/dist/sites.mjs

@@ -0,0 +1,3 @@
+import { addSite, deleteSite, deleteSitemap, fetchSitemap, fetchSitemaps, fetchSites, fetchSitesWithSitemaps, submitSitemap } from "./api/sites.mjs";
+import { getVerificationToken, getVerifiedSite, listVerifiedSites, resolveVerificationTarget, siteUrlToVerificationSite, unverifySite, verificationMethodsFor, verifySite } from "./api/verification.mjs";
+export { addSite, deleteSite, deleteSitemap, fetchSitemap, fetchSitemaps, fetchSites, fetchSitesWithSitemaps, getVerificationToken, getVerifiedSite, listVerifiedSites, resolveVerificationTarget, siteUrlToVerificationSite, submitSitemap, unverifySite, verificationMethodsFor, verifySite };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gscdump",
   "type": "module",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "Direct Google Search Console and Bing Webmaster clients with typed queries and Indexing Evidence",
   "author": {
     "name": "Harlan Wilton",
@@ -48,6 +48,16 @@
       "import": "./dist/bing/index.mjs",
       "default": "./dist/bing/index.mjs"
     },
+    "./client": {
+      "types": "./dist/client.d.mts",
+      "import": "./dist/client.mjs",
+      "default": "./dist/client.mjs"
+    },
+    "./indexing": {
+      "types": "./dist/indexing.d.mts",
+      "import": "./dist/indexing.mjs",
+      "default": "./dist/indexing.mjs"
+    },
     "./query/plan": {
       "types": "./dist/query/plan.d.mts",
       "import": "./dist/query/plan.mjs",
@@ -68,6 +78,11 @@
       "import": "./dist/dates.mjs",
       "default": "./dist/dates.mjs"
     },
+    "./errors": {
+      "types": "./dist/errors.d.mts",
+      "import": "./dist/errors.mjs",
+      "default": "./dist/errors.mjs"
+    },
     "./normalize": {
       "types": "./dist/normalize.d.mts",
       "import": "./dist/normalize.mjs",
@@ -78,6 +93,11 @@
       "import": "./dist/sitemap-identity.mjs",
       "default": "./dist/sitemap-identity.mjs"
     },
+    "./sites": {
+      "types": "./dist/sites.d.mts",
+      "import": "./dist/sites.mjs",
+      "default": "./dist/sites.mjs"
+    },
     "./tenant": {
       "types": "./dist/tenant.d.mts",
       "import": "./dist/tenant.mjs",
@@ -94,7 +114,7 @@
   },
   "dependencies": {
     "ofetch": "^1.5.1",
-    "@gscdump/contracts": "^3.0.0"
+    "@gscdump/contracts": "^3.1.0"
   },
   "scripts": {
     "dev": "obuild --stub",