@usefidel/contracts 0.9.0 → 0.10.0

package/dist/analytics.d.ts

@@ -263,7 +263,32 @@ export interface ValidationCancelledProperties {
 export interface ReportViewedProperties {
     run_id: string;
     validation_mode: ValidationMode;
-    finding_count: number;
+    /**
+     * Findings shown on the report, or `null` when the run is not complete.
+     *
+     * NOT nullable in 0.9.0, which forced an errored or still-processing run to
+     * report `0` — indistinguishable from "this report genuinely showed nothing"
+     * and dragging any average toward zero with every error view. `null` is the
+     * honest encoding of "there is no count yet".
+     *
+     * For `design_system_vs_live` this counts findings, which is a SUPERSET of
+     * violations: it includes `unused` and `scoped` rows. Use
+     * `web_validation_completed.violation_count` for violations.
+     */
+    finding_count: number | null;
+    /**
+     * Whether the viewer arrived through a share link (`?t=`), and whether they
+     * own the run.
+     *
+     * These lived on `report_viewed` before the 0.9.0 rewrite and were briefly
+     * split onto a separate untyped event — which broke the share funnel, since
+     * PostHog filters each funnel step on that step's OWN properties. Without
+     * them here, "shared-report viewers who signed up" cannot be expressed at
+     * all: the step either counts every report view (dominated by owners) or is
+     * dropped. They belong on the event they describe.
+     */
+    is_shared: boolean;
+    is_owner: boolean;
 }
 /**
  * The exhaustive event-to-property mapping.

package/package.json

@@ -7,7 +7,7 @@
     "The source of truth still lives in the monorepo at packages/contracts/."
   ],
   "name": "@usefidel/contracts",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Shared, code-free contracts between Fidel surfaces. Run-error taxonomy, theme-intake wire types, and the canonical fidel.config.json builders.",
   "license": "UNLICENSED",
   "private": false,