@liiift-studio/sanity-visitor-insights 0.18.0 → 0.20.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import * as sanity from 'sanity';
 import React from 'react';
-import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-B_OrmcdP.mjs';
-export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DailyPoint, j as DateRange, k as DiagnosticCheck, E as EmailCampaign, l as EventCutover, m as JourneyOutcome, n as JourneyStep, L as LandingPage, o as LicenceTierRow, P as PREEXISTING, p as REPORT_NAMES, q as ReportError, S as SiteAnalyticsConfig, r as SourceName, s as SourceRow, t as SourceStatus, u as TimelineEvent, v as TypefaceInterestRow, U as UnavailableReason, w as coverageForRange, x as estimated, y as isReportName, z as ok, B as partial, F as previousRange, G as resolveRange, H as unavailable, I as validateSiteConfig, K as valueOrNull } from './ranges-B_OrmcdP.mjs';
+import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, c as MeasurementHealthData, D as DiagnosticReport, J as JourneyData, T as TypefaceInterestData } from './ranges-BUZuS1c-.mjs';
+export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DailyPoint, j as DateRange, k as DiagnosticCheck, E as EmailCampaign, l as EventCutover, m as JourneyOutcome, n as JourneyStep, L as LandingPage, o as LicenceTierRow, P as PREEXISTING, p as REPORT_NAMES, q as ReportError, S as SiteAnalyticsConfig, r as SourceName, s as SourceRow, t as SourceStatus, u as TimelineEvent, v as TypefaceInterestRow, U as UnavailableReason, w as coverageForRange, x as estimated, y as isReportName, z as ok, B as partial, F as previousRange, G as resolveRange, H as unavailable, I as validateSiteConfig, K as valueOrNull } from './ranges-BUZuS1c-.mjs';
 
 /**
  * The Visitor Insights Studio tool.
@@ -51,6 +51,7 @@ type ReportState<T> = {
 } | {
     status: 'ready';
     envelope: ReportEnvelope<T>;
+    stale?: boolean;
 } | {
     status: 'error';
     message: string;
@@ -67,13 +68,20 @@ interface UseReportOptions {
     apiBaseUrl: string;
     report: ReportName;
     range: RangeKey;
+    /**
+     * Whether to fetch at all. Defaults to true.
+     *
+     * Lets a panel declare a secondary report it only needs on one tab, without the other four
+     * paying a request for data they will not draw.
+     */
+    enabled?: boolean;
 }
 /**
  * Fetch a report, re-fetching when the range changes.
  *
  * @returns the current state plus a `reload` for manual refresh
  */
-declare function useReport<T>({ apiBaseUrl, report, range, custom }: UseReportOptions): {
+declare function useReport<T>({ apiBaseUrl, report, range, custom, enabled }: UseReportOptions): {
     state: ReportState<T>;
     reload: () => void;
 };
@@ -373,14 +381,6 @@ interface Series {
         source: Series['source'];
         points: SeriesPoint[];
     };
-    /**
-     * Multiplier from observed to estimated-true, where the line itself is the lossy source.
-     *
-     * This one IS a symmetric band, because it is genuine uncertainty rather than a known blind
-     * spot. The two must not look alike: one says "we do not know exactly", the other says "we know
-     * exactly, and this much was invisible".
-     */
-    grossUpFactor?: number;
 }
 /** A dated event drawn through every row, e.g. a campaign send. */
 interface TimelineMarker {
@@ -423,10 +423,29 @@ declare function CrossSourceTimeline({ series, markers, currency }: CrossSourceT
  * Compares pageviews to pageviews. Sessions and orders sit alongside as context and are never
  * subtracted from a pageview count.
  */
-declare function MeasurementHealthPanel({ data, previous }: {
+/**
+ * Overview — the five-minute read.
+ *
+ * Revenue, orders, the mailing list, the cross-source timeline and the campaign table all used to
+ * live on a tab called "Measurement health", whose own blurb announced it was about how much of
+ * reality each source sees. Four of the five questions a foundry owner opens this for were filed
+ * under plumbing, on tab four, behind a door labelled for the instrument. This is the same data,
+ * first, under a heading that says what it is.
+ */
+declare function OverviewPanel({ data, previous }: {
     data: MeasurementHealthData;
     previous?: MeasurementHealthData;
 }): React.ReactElement;
+/**
+ * Data health — the instrument, deliberately last.
+ *
+ * Everything here answers one question: can I trust the numbers on the other tabs. It was two
+ * separate tabs answering that question, which is one more than it deserves out of five.
+ */
+declare function DataHealthPanel({ data, diagnostics }: {
+    data: MeasurementHealthData;
+    diagnostics?: DiagnosticReport;
+}): React.ReactElement;
 /** Acquisition — where visitors came from, with design-industry referrers called out. */
 declare function AcquisitionPanel({ data, previous }: {
     data: AcquisitionData;
@@ -493,4 +512,4 @@ interface VisitorInsightsPluginOptions {
  */
 declare const visitorInsights: sanity.Plugin<VisitorInsightsPluginOptions>;
 
-export { AcquisitionData, AcquisitionPanel, ComparisonBar, CrossSourceTimeline, type CrossSourceTimelineProps, Delta, type DeltaProps, DiagnosticReport, DiagnosticsPanel, FunnelChart, JourneyData, JourneyPanel, MeasurementHealthData, MeasurementHealthPanel, MetricFigure, MetricValue, NoticeList, type ProportionBar, ProportionChart, type ProportionChartProps, RangeKey, ReportEnvelope, ReportName, type ReportState, type Series, type SeriesPoint, type SortColumn, SortableTable, type SortableTableProps, type TimelineMarker, TrendChart, TypefaceInterestData, TypefaceInterestPanel, type UseReportOptions, type VisitorInsightsPluginOptions, VisitorInsightsTool, type VisitorInsightsToolProps, visitorInsights as default, formatCount, formatMoney, formatPercent, useReport, visitorInsights };
+export { AcquisitionData, AcquisitionPanel, ComparisonBar, CrossSourceTimeline, type CrossSourceTimelineProps, DataHealthPanel, Delta, type DeltaProps, DiagnosticReport, DiagnosticsPanel, FunnelChart, JourneyData, JourneyPanel, MeasurementHealthData, MetricFigure, MetricValue, NoticeList, OverviewPanel, type ProportionBar, ProportionChart, type ProportionChartProps, RangeKey, ReportEnvelope, ReportName, type ReportState, type Series, type SeriesPoint, type SortColumn, SortableTable, type SortableTableProps, type TimelineMarker, TrendChart, TypefaceInterestData, TypefaceInterestPanel, type UseReportOptions, type VisitorInsightsPluginOptions, VisitorInsightsTool, type VisitorInsightsToolProps, visitorInsights as default, formatCount, formatMoney, formatPercent, useReport, visitorInsights };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as sanity from 'sanity';
 import React from 'react';
-import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, D as DiagnosticReport, J as JourneyData, c as MeasurementHealthData, T as TypefaceInterestData } from './ranges-B_OrmcdP.js';
-export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DailyPoint, j as DateRange, k as DiagnosticCheck, E as EmailCampaign, l as EventCutover, m as JourneyOutcome, n as JourneyStep, L as LandingPage, o as LicenceTierRow, P as PREEXISTING, p as REPORT_NAMES, q as ReportError, S as SiteAnalyticsConfig, r as SourceName, s as SourceRow, t as SourceStatus, u as TimelineEvent, v as TypefaceInterestRow, U as UnavailableReason, w as coverageForRange, x as estimated, y as isReportName, z as ok, B as partial, F as previousRange, G as resolveRange, H as unavailable, I as validateSiteConfig, K as valueOrNull } from './ranges-B_OrmcdP.js';
+import { R as ReportEnvelope, a as ReportName, b as RangeKey, M as MetricValue, A as AcquisitionData, c as MeasurementHealthData, D as DiagnosticReport, J as JourneyData, T as TypefaceInterestData } from './ranges-BUZuS1c-.js';
+export { C as CaptureBasis, d as CaptureEstimate, e as CaptureModel, f as CheckStatus, g as Coverage, h as CrossSourceDay, i as DailyPoint, j as DateRange, k as DiagnosticCheck, E as EmailCampaign, l as EventCutover, m as JourneyOutcome, n as JourneyStep, L as LandingPage, o as LicenceTierRow, P as PREEXISTING, p as REPORT_NAMES, q as ReportError, S as SiteAnalyticsConfig, r as SourceName, s as SourceRow, t as SourceStatus, u as TimelineEvent, v as TypefaceInterestRow, U as UnavailableReason, w as coverageForRange, x as estimated, y as isReportName, z as ok, B as partial, F as previousRange, G as resolveRange, H as unavailable, I as validateSiteConfig, K as valueOrNull } from './ranges-BUZuS1c-.js';
 
 /**
  * The Visitor Insights Studio tool.
@@ -51,6 +51,7 @@ type ReportState<T> = {
 } | {
     status: 'ready';
     envelope: ReportEnvelope<T>;
+    stale?: boolean;
 } | {
     status: 'error';
     message: string;
@@ -67,13 +68,20 @@ interface UseReportOptions {
     apiBaseUrl: string;
     report: ReportName;
     range: RangeKey;
+    /**
+     * Whether to fetch at all. Defaults to true.
+     *
+     * Lets a panel declare a secondary report it only needs on one tab, without the other four
+     * paying a request for data they will not draw.
+     */
+    enabled?: boolean;
 }
 /**
  * Fetch a report, re-fetching when the range changes.
  *
  * @returns the current state plus a `reload` for manual refresh
  */
-declare function useReport<T>({ apiBaseUrl, report, range, custom }: UseReportOptions): {
+declare function useReport<T>({ apiBaseUrl, report, range, custom, enabled }: UseReportOptions): {
     state: ReportState<T>;
     reload: () => void;
 };
@@ -373,14 +381,6 @@ interface Series {
         source: Series['source'];
         points: SeriesPoint[];
     };
-    /**
-     * Multiplier from observed to estimated-true, where the line itself is the lossy source.
-     *
-     * This one IS a symmetric band, because it is genuine uncertainty rather than a known blind
-     * spot. The two must not look alike: one says "we do not know exactly", the other says "we know
-     * exactly, and this much was invisible".
-     */
-    grossUpFactor?: number;
 }
 /** A dated event drawn through every row, e.g. a campaign send. */
 interface TimelineMarker {
@@ -423,10 +423,29 @@ declare function CrossSourceTimeline({ series, markers, currency }: CrossSourceT
  * Compares pageviews to pageviews. Sessions and orders sit alongside as context and are never
  * subtracted from a pageview count.
  */
-declare function MeasurementHealthPanel({ data, previous }: {
+/**
+ * Overview — the five-minute read.
+ *
+ * Revenue, orders, the mailing list, the cross-source timeline and the campaign table all used to
+ * live on a tab called "Measurement health", whose own blurb announced it was about how much of
+ * reality each source sees. Four of the five questions a foundry owner opens this for were filed
+ * under plumbing, on tab four, behind a door labelled for the instrument. This is the same data,
+ * first, under a heading that says what it is.
+ */
+declare function OverviewPanel({ data, previous }: {
     data: MeasurementHealthData;
     previous?: MeasurementHealthData;
 }): React.ReactElement;
+/**
+ * Data health — the instrument, deliberately last.
+ *
+ * Everything here answers one question: can I trust the numbers on the other tabs. It was two
+ * separate tabs answering that question, which is one more than it deserves out of five.
+ */
+declare function DataHealthPanel({ data, diagnostics }: {
+    data: MeasurementHealthData;
+    diagnostics?: DiagnosticReport;
+}): React.ReactElement;
 /** Acquisition — where visitors came from, with design-industry referrers called out. */
 declare function AcquisitionPanel({ data, previous }: {
     data: AcquisitionData;
@@ -493,4 +512,4 @@ interface VisitorInsightsPluginOptions {
  */
 declare const visitorInsights: sanity.Plugin<VisitorInsightsPluginOptions>;
 
-export { AcquisitionData, AcquisitionPanel, ComparisonBar, CrossSourceTimeline, type CrossSourceTimelineProps, Delta, type DeltaProps, DiagnosticReport, DiagnosticsPanel, FunnelChart, JourneyData, JourneyPanel, MeasurementHealthData, MeasurementHealthPanel, MetricFigure, MetricValue, NoticeList, type ProportionBar, ProportionChart, type ProportionChartProps, RangeKey, ReportEnvelope, ReportName, type ReportState, type Series, type SeriesPoint, type SortColumn, SortableTable, type SortableTableProps, type TimelineMarker, TrendChart, TypefaceInterestData, TypefaceInterestPanel, type UseReportOptions, type VisitorInsightsPluginOptions, VisitorInsightsTool, type VisitorInsightsToolProps, visitorInsights as default, formatCount, formatMoney, formatPercent, useReport, visitorInsights };
+export { AcquisitionData, AcquisitionPanel, ComparisonBar, CrossSourceTimeline, type CrossSourceTimelineProps, DataHealthPanel, Delta, type DeltaProps, DiagnosticReport, DiagnosticsPanel, FunnelChart, JourneyData, JourneyPanel, MeasurementHealthData, MetricFigure, MetricValue, NoticeList, OverviewPanel, type ProportionBar, ProportionChart, type ProportionChartProps, RangeKey, ReportEnvelope, ReportName, type ReportState, type Series, type SeriesPoint, type SortColumn, SortableTable, type SortableTableProps, type TimelineMarker, TrendChart, TypefaceInterestData, TypefaceInterestPanel, type UseReportOptions, type VisitorInsightsPluginOptions, VisitorInsightsTool, type VisitorInsightsToolProps, visitorInsights as default, formatCount, formatMoney, formatPercent, useReport, visitorInsights };