@liiift-studio/sanity-visitor-insights 0.2.0 → 0.2.2

package/dist/vercel-D19ArNAY.d.ts

@@ -1,80 +0,0 @@
-/** What this module needs from a Sanity client — kept minimal so it is trivial to stub in tests. */
-interface SanityQueryClient {
-    fetch<T>(query: string, params?: Record<string, unknown>): Promise<T>;
-}
-
-/**
- * GA4 Data API client.
- *
- * Only `runReport` and `batchRunReports` are used. `runFunnelReport` is deliberately not called:
- * it is an alpha surface with its own stricter quota, and it returns step-conversion marginals
- * rather than observed paths — drawing a flow diagram from it would imply co-occurrence that was
- * never measured. The journey report approximates instead, and says so.
- */
-
-/** A GA4 report request, narrowed to the fields this package sets. */
-interface Ga4ReportRequest {
-    dimensions?: Array<{
-        name: string;
-    }>;
-    metrics?: Array<{
-        name: string;
-    }>;
-    dateRanges: Array<{
-        startDate: string;
-        endDate: string;
-    }>;
-    dimensionFilter?: unknown;
-    orderBys?: unknown;
-    limit?: number;
-    keepEmptyRows?: boolean;
-}
-/** A parsed report row: dimension values and metric values, positionally aligned to the request. */
-interface Ga4Row {
-    dimensions: string[];
-    metrics: number[];
-}
-/** A parsed GA4 report. */
-interface Ga4Report {
-    rows: Ga4Row[];
-    /** True when GA4 withheld rows for privacy thresholding — totals are then incomplete. */
-    thresholded: boolean;
-    /** True when GA4 answered from a sample rather than the full data set. */
-    sampled: boolean;
-    /** Total row count GA4 reports, which may exceed rows returned when a limit applied. */
-    rowCount: number;
-    /**
-     * The property's configured timezone, as GA4 reports it. Worth capturing because every range
-     * is anchored to the timezone in site config, and a mismatch silently shifts day boundaries.
-     */
-    timeZone?: string;
-}
-/** A GA4 client bound to one property. */
-interface Ga4Client {
-    runReport(request: Ga4ReportRequest): Promise<Ga4Report>;
-    batchRunReports(requests: Ga4ReportRequest[]): Promise<Ga4Report[]>;
-}
-
-/**
- * Vercel Web Analytics client.
- *
- * Vercel's Web Analytics read API is not a stable, versioned public surface the way the GA4 Data
- * API is, and access depends on plan tier. This client is therefore written to degrade rather than
- * throw: a missing token, an unavailable plan, or a changed endpoint all surface as an unconfigured
- * or errored source in the report envelope, so the Measurement Health panel can say "Vercel did not
- * answer" instead of implying the site had no traffic.
- *
- * Vercel is counted here purely as a second, cookieless pageview measurement. It is never treated
- * as ground truth, and never subtracted from a GA4 session count — those are different units.
- */
-/** Daily pageview counts, keyed by ISO date. */
-interface VercelPageviews {
-    byDate: Record<string, number>;
-    total: number;
-}
-/** A Vercel client bound to one project. */
-interface VercelClient {
-    pageviews(start: string, end: string): Promise<VercelPageviews>;
-}
-
-export type { Ga4Client as G, SanityQueryClient as S, VercelClient as V, Ga4ReportRequest as a, Ga4Report as b, VercelPageviews as c };