@gscdump/contracts 0.21.3 → 0.22.4

package/dist/index.d.mts

@@ -105,7 +105,7 @@ interface LifecycleWebhookEnvelope<TData extends Record<string, unknown> = Recor
 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;
-type TableName = 'pages' | 'queries' | 'countries' | 'page_queries' | 'dates' | 'search_appearance' | 'hourly_pages';
+type TableName = 'pages' | 'queries' | 'countries' | 'page_queries' | 'dates' | 'search_appearance' | 'search_appearance_pages' | 'search_appearance_queries' | 'search_appearance_page_queries' | 'hourly_pages';
 /**
  * Temporal granularity axis. Daily callers (`'day'`, default) read/write rows
  *  keyed by `date`; hourly callers (`'hour'`) read/write rows that additionally
@@ -1525,8 +1525,8 @@ interface PartnerWebhookHeaders {
   timestamp?: string | null;
   signature?: string | null;
 }
-/** The 5 Iceberg fact tables — string-typed here to avoid an engine dep. */
-type FileResolutionTable = 'pages' | 'queries' | 'countries' | 'page_queries' | 'dates';
+/** 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';
 /** Request query params for `GET /api/sites/[siteId]/analysis-sources`. */
 interface FileResolutionRequest {
   /** `YYYY-MM-DD` inclusive. Required — no date range = no resolution. */
@@ -1559,8 +1559,14 @@ interface ResolvedParquetFile {
   /** Byte size — drives the browser-eligibility sum and OPFS quota planning. */
   bytes: number;
   /**
-   * Content hash of the file (Iceberg data-file digest). The browser
-   * verifies the OPFS-cached copy against this before attaching.
+   * Opaque content-stable identifier for this parquet file. Two requests for
+   * the same bytes MUST return the same `contentHash`; any change in bytes
+   * MUST yield a different one. The OPFS cache uses this as the file's
+   * address (encoded into the cache filename) — it is NOT required to be a
+   * SHA-256.
+   *
+   * In practice the server returns the Iceberg `data_file.file_path` object
+   * key, which is UUID-derived and content-addressed by convention.
    */
   contentHash: string;
   /** Row count, for eligibility accounting + diagnostics. */
@@ -1707,7 +1713,9 @@ declare const analyticsRoutes: {
     readonly indexingInspect: (siteId: string) => string;
     readonly countries: (siteId: string) => string;
     readonly searchAppearance: (siteId: string) => string;
+    readonly topAssociation: (siteId: string) => string;
   };
+  readonly syncProgress: "/api/sync-progress";
 };
 /**
  * GSC search-type slice validator. Mirrors the `GscSearchType` union from

package/dist/index.mjs

@@ -200,8 +200,10 @@ const analyticsRoutes = {
 		indexingDiagnostics: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/indexing/diagnostics`,
 		indexingInspect: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/indexing/inspect`,
 		countries: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/countries`,
-		searchAppearance: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/search-appearance`
-	}
+		searchAppearance: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/search-appearance`,
+		topAssociation: (siteId) => `/api/__gsc/sites/${encodeURIComponent(siteId)}/data/top-association`
+	},
+	syncProgress: "/api/sync-progress"
 };
 const WEBHOOK_CONTRACT_VERSION = "2026-05-11";
 const WEBHOOK_SIGNATURE_HEADER = "X-GSCDump-Signature";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/contracts",
   "type": "module",
-  "version": "0.21.3",
+  "version": "0.22.4",
   "description": "Shared gscdump.com API, webhook, realtime, and lifecycle contracts.",
   "author": {
     "name": "Harlan Wilton",
@@ -40,7 +40,7 @@
   },
   "devDependencies": {
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.7"
   },
   "scripts": {
     "build": "obuild",