@gscdump/contracts 0.21.3 → 0.22.1

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. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/contracts",
   "type": "module",
-  "version": "0.21.3",
+  "version": "0.22.1",
   "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",