gscdump 0.11.4 → 0.12.0

package/dist/contracts.d.mts

@@ -1,14 +1,4 @@
-/**
- * Canonical cross-package contracts. Type-only — zero runtime cost.
- *
- * Imported by @gscdump/engine, @gscdump/analysis, @gscdump/cli, @gscdump/mcp,
- * @gscdump/cloud as the single source of truth for cross-cutting types so
- * schema identifiers, tenant shape, and analyzer IO can't drift across
- * packages.
- */
-/** Logical table / dataset identifier. Canonical across query builder + storage engine. */
 type TableName = 'pages' | 'keywords' | 'countries' | 'devices' | 'page_keywords' | 'search_appearance';
-/** Untyped row shape crossing storage/query boundaries. */
 type Row = Record<string, unknown>;
 type ColumnType = 'DATE' | 'VARCHAR' | 'INTEGER' | 'BIGINT' | 'DOUBLE';
 interface ColumnDef {
@@ -20,24 +10,12 @@ interface TableSchema {
   name: TableName;
   columns: ColumnDef[];
   sortKey: string[];
-  /**
-   * Monotonically increasing version. Tagged onto every manifest entry written
-   * for this table; bump when columns are added/removed/retyped so readers can
-   * detect stale on-disk data.
-   */
   version: number;
 }
-/** Tenant identity for multi-user / multi-site storage. */
 interface TenantCtx {
   userId: string;
   siteId?: string;
 }
-/**
- * Dimensions accepted by the Google Search Console Search Analytics API.
- *
- * This intentionally excludes package-only logical dimensions such as
- * `queryCanonical`; host apps must route those through an engine-backed path.
- */
 type GscSearchAnalyticsDimension = 'page' | 'query' | 'country' | 'device' | 'date' | 'searchAppearance';
 type GscSearchAnalyticsFilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'includingRegex' | 'excludingRegex';
 interface GscSearchAnalyticsFilter {
@@ -50,13 +28,6 @@ interface GscSearchAnalyticsFilterGroup {
   filters: GscSearchAnalyticsFilter[];
 }
 type GscSearchType = 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
-/**
- * Canonical host-facing Search Analytics request body.
- *
- * Google's generated client type also has deprecated/alternate fields. The
- * gscdump query builder emits `searchType`, so apps should forward that field
- * unchanged rather than translating it to `type`.
- */
 interface GscSearchAnalyticsRequest {
   startDate: string;
   endDate: string;

package/dist/index.d.mts

@@ -12,12 +12,6 @@ declare function runSequentialBatch<I, R>(items: I[], operation: (item: I, index
   concurrency?: number;
   onProgress?: (result: R, index: number, total: number) => void;
 }): Promise<R[]>;
-/**
- * Dimensions accepted by the Google Search Console Search Analytics API.
- *
- * This intentionally excludes package-only logical dimensions such as
- * `queryCanonical`; host apps must route those through an engine-backed path.
- */
 type GscSearchAnalyticsDimension = 'page' | 'query' | 'country' | 'device' | 'date' | 'searchAppearance';
 type GscSearchAnalyticsFilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'includingRegex' | 'excludingRegex';
 interface GscSearchAnalyticsFilter {
@@ -30,13 +24,6 @@ interface GscSearchAnalyticsFilterGroup {
   filters: GscSearchAnalyticsFilter[];
 }
 type GscSearchType = 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
-/**
- * Canonical host-facing Search Analytics request body.
- *
- * Google's generated client type also has deprecated/alternate fields. The
- * gscdump query builder emits `searchType`, so apps should forward that field
- * unchanged rather than translating it to `type`.
- */
 interface GscSearchAnalyticsRequest {
   startDate: string;
   endDate: string;

package/dist/query/index.d.mts

@@ -1,20 +1,5 @@
 import _dayjs, { Dayjs } from "dayjs";
-/**
- * Canonical cross-package contracts. Type-only — zero runtime cost.
- *
- * Imported by @gscdump/engine, @gscdump/analysis, @gscdump/cli, @gscdump/mcp,
- * @gscdump/cloud as the single source of truth for cross-cutting types so
- * schema identifiers, tenant shape, and analyzer IO can't drift across
- * packages.
- */
-/** Logical table / dataset identifier. Canonical across query builder + storage engine. */
 type TableName = 'pages' | 'keywords' | 'countries' | 'devices' | 'page_keywords' | 'search_appearance';
-/**
- * Dimensions accepted by the Google Search Console Search Analytics API.
- *
- * This intentionally excludes package-only logical dimensions such as
- * `queryCanonical`; host apps must route those through an engine-backed path.
- */
 type GscSearchAnalyticsDimension = 'page' | 'query' | 'country' | 'device' | 'date' | 'searchAppearance';
 type GscSearchAnalyticsFilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'includingRegex' | 'excludingRegex';
 interface GscSearchAnalyticsFilter {
@@ -27,13 +12,6 @@ interface GscSearchAnalyticsFilterGroup {
   filters: GscSearchAnalyticsFilter[];
 }
 type GscSearchType = 'web' | 'image' | 'video' | 'news' | 'discover' | 'googleNews';
-/**
- * Canonical host-facing Search Analytics request body.
- *
- * Google's generated client type also has deprecated/alternate fields. The
- * gscdump query builder emits `searchType`, so apps should forward that field
- * unchanged rather than translating it to `type`.
- */
 interface GscSearchAnalyticsRequest {
   startDate: string;
   endDate: string;

package/dist/query/plan.d.mts

@@ -1,12 +1,3 @@
-/**
- * Canonical cross-package contracts. Type-only — zero runtime cost.
- *
- * Imported by @gscdump/engine, @gscdump/analysis, @gscdump/cli, @gscdump/mcp,
- * @gscdump/cloud as the single source of truth for cross-cutting types so
- * schema identifiers, tenant shape, and analyzer IO can't drift across
- * packages.
- */
-/** Logical table / dataset identifier. Canonical across query builder + storage engine. */
 type TableName = 'pages' | 'keywords' | 'countries' | 'devices' | 'page_keywords' | 'search_appearance';
 declare const _default: {
   name: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gscdump",
   "type": "module",
-  "version": "0.11.4",
+  "version": "0.12.0",
   "description": "Google Search Console API wrapper with typed query builder, streaming pagination, and SEO analysis functions",
   "author": {
     "name": "Harlan Wilton",
@@ -107,7 +107,8 @@
     "dayjs": "^1.11.20",
     "defu": "^6.1.7",
     "ofetch": "^1.5.1",
-    "ufo": "^1.6.4"
+    "ufo": "^1.6.4",
+    "@gscdump/contracts": "0.12.0"
   },
   "devDependencies": {
     "@googleapis/indexing": "^6.0.1",