@gscdump/nuxt 0.19.0

package/nuxt.config.ts

@@ -0,0 +1,36 @@
+// Layer-mode Nuxt config for @gscdump/nuxt.
+//
+// Consuming apps pull this in via `extends: ['@gscdump/nuxt']` in
+// their own nuxt.config.ts. Anything declared here is a shared default; hosts
+// can override in the normal Nuxt fashion (defu-merged, app config wins).
+//
+// Contract: the layer assumes every consumer is a Nuxt UI v4 app. We register
+// `@nuxt/ui` here and ship the shared main.css so hosts don't have to
+// rediscover the setup — components in this layer freely use UButton,
+// UPopover, UIcon, etc.
+
+import { fileURLToPath } from 'node:url'
+
+export default defineNuxtConfig({
+  // Register the layer's module so hooks + runtime config land on host apps
+  // without them having to wire each module individually.
+  modules: [
+    fileURLToPath(new URL('./module.ts', import.meta.url)),
+    '@nuxt/ui',
+    '@vueuse/nuxt',
+  ],
+
+  css: [
+    fileURLToPath(new URL('./app/assets/css/main.css', import.meta.url)),
+  ],
+
+  // runtimeConfig defaults live in module.ts (single source of truth).
+
+  vite: {
+    optimizeDeps: {
+      // DuckDB-WASM workers use URL imports Vite's prebundler cannot resolve.
+      // Keep them outside optimizeDeps so they stream as-is.
+      exclude: ['@duckdb/duckdb-wasm'],
+    },
+  },
+})

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@gscdump/nuxt",
+  "type": "module",
+  "version": "0.19.0",
+  "description": "Nuxt layer: GSC analytics UI + DuckDB-WASM integration. Frontend-only; server primitives live in @gscdump/analysis, @gscdump/engine-sqlite, @gscdump/cloudflare, and host apps.",
+  "author": {
+    "name": "Harlan Wilton",
+    "email": "harlan@harlanzw.com",
+    "url": "https://harlanzw.com/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/harlan-zw/gscdump.git",
+    "directory": "packages/nuxt"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./types.ts",
+      "import": "./nuxt.config.ts",
+      "default": "./nuxt.config.ts"
+    },
+    "./types": {
+      "types": "./types.ts",
+      "import": "./types.ts",
+      "default": "./types.ts"
+    },
+    "./module": {
+      "types": "./module.ts",
+      "import": "./module.ts",
+      "default": "./module.ts"
+    }
+  },
+  "main": "./nuxt.config.ts",
+  "types": "./types.ts",
+  "files": [
+    "README.md",
+    "app",
+    "module.ts",
+    "nuxt.config.ts",
+    "types.ts"
+  ],
+  "peerDependencies": {
+    "nuxt": "^4.4.6",
+    "vue": "^3.5.34"
+  },
+  "dependencies": {
+    "@duckdb/duckdb-wasm": "^1.32.0",
+    "@nuxt/ui": "^4.7.1",
+    "@unovis/ts": "^1.6.5",
+    "@unovis/vue": "^1.6.5",
+    "@vueuse/core": "^14.3.0",
+    "@vueuse/nuxt": "^14.3.0",
+    "defu": "^6.1.7",
+    "ofetch": "^1.5.1",
+    "tailwindcss": "^4.3.0",
+    "@gscdump/contracts": "0.19.0",
+    "@gscdump/analysis": "0.19.0",
+    "@gscdump/engine": "0.19.0",
+    "@gscdump/engine-duckdb-wasm": "0.19.0",
+    "@gscdump/sdk": "0.19.0",
+    "gscdump": "0.19.0"
+  },
+  "devDependencies": {
+    "@nuxt/kit": "^4.4.6",
+    "nuxt": "^4.4.6",
+    "typescript": "^6.0.3",
+    "vue": "^3.5.34"
+  },
+  "scripts": {
+    "build": "nuxt prepare",
+    "typecheck": "nuxt typecheck"
+  }
+}

package/types.ts

@@ -0,0 +1,114 @@
+// Public API surface of @gscdump/nuxt.
+// Anything not exported here is considered internal and may change without a major bump.
+//
+// This package is a frontend-only Nuxt layer. Server-side primitives (auth
+// providers, query sources, GSC API helpers) live in their respective sibling
+// packages: `@gscdump/analysis` (sources), `gscdump` (GSC API client), and
+// host-specific Nitro server code in the consuming app.
+
+import type { AnalyticsClient } from '@gscdump/sdk'
+import type { $Fetch } from 'ofetch'
+import type { GscQueryDispatcher } from './app/composables/_useGscQueryDispatcher'
+import type { GscAnalyticsContext } from './app/composables/useGscAnalytics'
+import type { GscAnalyzerDefinition } from './app/composables/useGscAnalyzerDefs'
+
+export interface GscAnalyticsRuntimeConfig {
+  /**
+   * Base URL the client uses to reach the analytics API (`/api/__gsc/*`).
+   * Empty string = same-origin. Hosts running the layer as a portable client
+   * against a remote origin (e.g. an embedded dashboard pointing at
+   * https://gscdump.com) set this via `GSCDUMP_ANALYTICS_API_BASE`.
+   */
+  apiBase: string
+  /** Base URL for DuckDB-WASM worker + bundle assets. Empty = layer default. */
+  duckdbBundleBase: string
+  /** IANA tz name; empty = browser default. */
+  timezone: string
+  /** When true, layer auto-toasts classified fetch errors via Nuxt UI. */
+  toastErrors: boolean
+  /** Default engine when caller doesn't pass `opts.engine`. */
+  defaultEngine: 'auto' | 'browser' | 'server'
+}
+
+declare module '@nuxt/schema' {
+  interface PublicRuntimeConfig {
+    analytics: GscAnalyticsRuntimeConfig
+  }
+}
+
+declare module '#app' {
+  interface NuxtApp {
+    $gscAnalytics: GscAnalyticsContext
+    $gscQueryDispatcher: GscQueryDispatcher
+    $gscFetch: $Fetch
+    $gscAnalyticsClient: AnalyticsClient
+    $gscAnalyzers?: GscAnalyzerDefinition[]
+  }
+}
+
+export type {
+  GscAnalyzerBatchEntry,
+  GscAnalyzerBatchRunner,
+  GscAnalyzerBatchStatus,
+  UseGscAnalyzerBatchOptions,
+} from './app/composables/useGscAnalyzerBatch'
+export { defineGscAnalyzer } from './app/composables/useGscAnalyzerDefs'
+export type {
+  GscAnalyzerAccent,
+  GscAnalyzerCapabilities,
+  GscAnalyzerCapability,
+  GscAnalyzerDefinition,
+  GscAnalyzerDefinitionWithCapability,
+  GscAnalyzerInsightCard,
+  GscAnalyzerKind,
+  GscAnalyzerPanelResult,
+  GscAnalyzerPanelSpec,
+  GscAnalyzerStatTile,
+} from './app/composables/useGscAnalyzerDefs'
+
+export { gscPanelRunnerKey, useGscPanelRunner } from './app/composables/useGscPanelContext'
+
+export type { GscPanelRunnerContext } from './app/composables/useGscPanelContext'
+export type {
+  UseGscParquetTableOptions,
+  UseGscParquetTableReturn,
+} from './app/composables/useGscParquetTable'
+
+export type {
+  GscBackfillRunner,
+  GscQueryDecision,
+  GscQueryDecisionReason,
+  GscQueryEngine,
+  GscQueryMeta,
+  GscQueryStatus,
+  UseGscQueryOptions,
+  UseGscQueryReturn,
+} from './app/composables/useGscQuery'
+
+export type { UseGscRollupTableOptions } from './app/composables/useGscRollupTable'
+
+export type {
+  AnalysisSourcesResponse,
+  CountriesResponse,
+  CountryRow,
+  GscApiRange,
+  GscRowQueryMeta,
+  GscRowQueryResponse,
+  IndexingDiagnostics,
+  IndexingIssue,
+  IndexingIssueSeverity,
+  IndexingUrlRow,
+  IndexingUrlsResponse,
+  IndexingUrlStatus,
+  InspectionHistoryRecord,
+  InspectionHistoryResponse,
+  SearchAppearanceResponse,
+  SearchAppearanceRow,
+  SiteListItem,
+  SitemapAddedRow,
+  SitemapChangesResponse,
+  SitemapHistoryRecord,
+  SitemapHistoryResponse,
+  SitemapRemovedRow,
+  SourceInfoResponse,
+} from '@gscdump/contracts'