gscdump 0.6.3 → 0.7.2

package/dist/contracts.d.mts

@@ -1,69 +1,11 @@
-declare const _default: {
-  name: string;
-  'alpha-2': string;
-  'alpha-3': string;
-  'country-code': string;
-}[];
-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];
-interface DimensionValueMap {
-  query: string;
-  queryCanonical: string;
-  page: string;
-  country: Country;
-  device: Device;
-  searchAppearance: string;
-  date: string;
-}
-type Dimension = keyof DimensionValueMap;
-interface QueryParamValueMap {
-  searchType: SearchType;
-}
-type QueryParamName = keyof QueryParamValueMap;
-type FilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'includingRegex' | 'excludingRegex';
-type DateOperator = 'gte' | 'gt' | 'lte' | 'lt' | 'between';
-type MetricOperator = 'metricGte' | 'metricGt' | 'metricLte' | 'metricLt' | 'metricBetween';
-type SpecialOperator = 'topLevel';
-interface InternalFilter {
-  dimension: Dimension | QueryParamName | Metric;
-  operator: FilterOperator | DateOperator | MetricOperator | SpecialOperator;
-  expression: string;
-  expression2?: string;
-}
-interface Filter<C = object> {
-  readonly __filterBrand: 'gscdump.Filter';
-  readonly _constraints: C;
-  readonly _filters: InternalFilter[];
-  readonly _nestedGroups?: Filter<any>[];
-  readonly _groupType?: 'and' | 'or';
-}
-type Metric = 'clicks' | 'impressions' | 'ctr' | 'position';
-interface BuilderState {
-  dimensions: Dimension[];
-  metrics?: Metric[];
-  filter?: Filter<any>;
-  orderBy?: {
-    column: Metric | 'date';
-    dir: 'asc' | 'desc';
-  };
-  rowLimit?: number;
-  startRow?: number;
-}
+/**
+ * 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. */
@@ -90,47 +32,4 @@ interface TenantCtx {
   userId: string;
   siteId?: string;
 }
-type AnalysisTool = 'striking-distance' | 'opportunity' | 'movers' | 'decay' | 'zero-click' | 'brand' | 'cannibalization' | 'clustering' | 'concentration' | 'seasonality' | 'trends' | 'ctr-anomaly' | 'position-volatility' | 'long-tail' | 'intent-atlas' | 'query-migration' | 'bayesian-ctr' | 'stl-decompose' | 'change-point' | 'bipartite-pagerank' | 'survival' | 'position-distribution' | 'ctr-curve' | 'dark-traffic' | 'content-velocity' | 'keyword-breadth' | 'device-gap' | 'data-query' | 'data-detail';
-interface AnalysisParams {
-  type: AnalysisTool;
-  startDate?: string;
-  endDate?: string;
-  prevStartDate?: string;
-  prevEndDate?: string;
-  brandTerms?: string[];
-  limit?: number;
-  offset?: number;
-  /** Sort column. Each analyzer enforces its own whitelist. */
-  sortBy?: string;
-  /** Sort direction. Default per-analyzer. */
-  sortDir?: 'asc' | 'desc';
-  minPosition?: number;
-  maxPosition?: number;
-  minImpressions?: number;
-  maxCtr?: number;
-  minPages?: number;
-  maxPositionSpread?: number;
-  minClusterSize?: number;
-  clusterBy?: 'prefix' | 'intent' | 'both';
-  dimension?: 'pages' | 'keywords';
-  topN?: number;
-  metric?: 'clicks' | 'impressions';
-  changeThreshold?: number;
-  minPreviousClicks?: number;
-  threshold?: number;
-  weeks?: number;
-  minWeeksWithData?: number;
-  /** content-velocity lookback window in days (max 365, default 90). */
-  days?: number;
-  /** data-query / data-detail primary BuilderState. */
-  q?: BuilderState;
-  /** data-query / data-detail optional comparison-period BuilderState. */
-  qc?: BuilderState;
-  /** data-query comparison filter applied to joined current/previous rows. */
-  comparisonFilter?: 'new' | 'lost' | 'improving' | 'declining';
-}
-interface AnalysisResult {
-  results: Record<string, unknown>[];
-  meta: Record<string, unknown>;
-}
-export { AnalysisParams, AnalysisResult, AnalysisTool, ColumnDef, ColumnType, Row, type TableName, TableSchema, TenantCtx };
+export { ColumnDef, ColumnType, Row, TableName, TableSchema, TenantCtx };

package/dist/query/index.d.mts

@@ -152,6 +152,14 @@ declare function lt<D extends Dimension>(column: Column<D>, value: DimensionValu
 declare function between<M extends Metric>(column: MetricColumn<M>, start: number, end: number): Filter<object>;
 declare function between<D extends Dimension>(column: Column<D>, start: DimensionValueMap[D], end: DimensionValueMap[D]): Filter<object>;
 declare function topLevel(column: Column<'page'>): Filter<object>;
+/**
+ * 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';
 type LogicalDataset = TableName;

package/dist/query/plan.d.mts

@@ -1,3 +1,13 @@
+/**
+ * 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;
   'alpha-2': string;
@@ -64,8 +74,6 @@ interface BuilderState {
   rowLimit?: number;
   startRow?: number;
 }
-/** Logical table / dataset identifier. Canonical across query builder + storage engine. */
-type TableName = 'pages' | 'keywords' | 'countries' | 'devices' | 'page_keywords' | 'search_appearance';
 type LogicalDataset = TableName;
 type ComparisonFilter = 'new' | 'lost' | 'improving' | 'declining';
 interface PlannerCapabilities {
@@ -127,4 +135,4 @@ declare class UnsupportedLogicalCapabilityError extends Error {
 }
 declare function buildLogicalPlan(state: BuilderState, capabilities?: PlannerCapabilities): LogicalQueryPlan;
 declare function buildLogicalComparisonPlan(current: BuilderState, previous: BuilderState, capabilities?: PlannerCapabilities, comparisonFilter?: ComparisonFilter): LogicalComparisonPlan;
-export { type ComparisonFilter, type LogicalComparisonPlan, type LogicalDataset, type LogicalDimensionFilter, LogicalFilterGroup, LogicalFilterLeaf, LogicalFilterNode, type LogicalMetricFilter, type LogicalQueryPlan, type PlannerCapabilities, type TableName, UnsupportedLogicalCapabilityError, buildLogicalComparisonPlan, buildLogicalPlan };
+export { ComparisonFilter, LogicalComparisonPlan, LogicalDataset, LogicalDimensionFilter, LogicalFilterGroup, LogicalFilterLeaf, LogicalFilterNode, LogicalMetricFilter, LogicalQueryPlan, PlannerCapabilities, type TableName, UnsupportedLogicalCapabilityError, buildLogicalComparisonPlan, buildLogicalPlan };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gscdump",
   "type": "module",
-  "version": "0.6.3",
+  "version": "0.7.2",
   "description": "Google Search Console API wrapper with typed query builder, streaming pagination, and SEO analysis functions",
   "author": {
     "name": "Harlan Wilton",
@@ -34,39 +34,48 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",
-      "import": "./dist/index.mjs"
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
     },
     "./query": {
       "types": "./dist/query/index.d.mts",
-      "import": "./dist/query/index.mjs"
+      "import": "./dist/query/index.mjs",
+      "default": "./dist/query/index.mjs"
     },
     "./query/plan": {
       "types": "./dist/query/plan.d.mts",
-      "import": "./dist/query/plan.mjs"
+      "import": "./dist/query/plan.mjs",
+      "default": "./dist/query/plan.mjs"
     },
     "./contracts": {
       "types": "./dist/contracts.d.mts",
-      "import": "./dist/contracts.mjs"
+      "import": "./dist/contracts.mjs",
+      "default": "./dist/contracts.mjs"
     },
     "./driver": {
       "types": "./dist/driver.d.mts",
-      "import": "./dist/driver.mjs"
+      "import": "./dist/driver.mjs",
+      "default": "./dist/driver.mjs"
     },
     "./tenant": {
       "types": "./dist/tenant.d.mts",
-      "import": "./dist/tenant.mjs"
+      "import": "./dist/tenant.mjs",
+      "default": "./dist/tenant.mjs"
     },
     "./normalize": {
       "types": "./dist/normalize.d.mts",
-      "import": "./dist/normalize.mjs"
+      "import": "./dist/normalize.mjs",
+      "default": "./dist/normalize.mjs"
     },
     "./url": {
       "types": "./dist/url.d.mts",
-      "import": "./dist/url.mjs"
+      "import": "./dist/url.mjs",
+      "default": "./dist/url.mjs"
     },
     "./sitemap": {
       "types": "./dist/sitemap.d.mts",
-      "import": "./dist/sitemap.mjs"
+      "import": "./dist/sitemap.mjs",
+      "default": "./dist/sitemap.mjs"
     }
   },
   "main": "./dist/index.mjs",