@iann29/rastro 0.1.0-alpha.1 → 0.1.0-alpha.11

package/dist/component/reports.d.ts

@@ -1,3 +1,4 @@
+import type { Id } from "./_generated/dataModel.js";
 export declare const overview: import("convex/server").RegisteredQuery<"public", {
     from: number;
     interval?: "day" | "hour" | undefined;
@@ -20,12 +21,20 @@ export declare const overview: import("convex/server").RegisteredQuery<"public",
         visitors: number;
         conversions: number;
         revenueCents: number;
+        durationMs: number;
+        continuedSessions: number;
+        newVisitors: number;
     }[];
     topSources: {
         value: string;
         count: number;
         revenueCents: number;
     }[];
+    topCampaigns: {
+        value: string;
+        count: number;
+        revenueCents: number;
+    }[];
     topPages: {
         value: string;
         count: number;
@@ -56,6 +65,45 @@ export declare const overview: import("convex/server").RegisteredQuery<"public",
         count: number;
         revenueCents: number;
     }[];
+    metadata: {
+        visitors: {
+            basis: "bucketOccurrences" | "estimatedUnique";
+            exact: boolean;
+            legacyIncomplete: boolean;
+            sketchVersion: number | null;
+            precision: number | null;
+        };
+        breakdowns: {
+            topSources: "eventVolume" | "sessions";
+            topCampaigns: "eventVolume" | "sessions";
+            topPages: "eventVolume" | "pageviews";
+            topCountries: "eventVolume" | "sessions";
+            topDevices: "eventVolume" | "sessions";
+            topBrowsers: "eventVolume" | "sessions";
+            topEvents: "eventVolume";
+            topGoals: "goalCompletionVolume";
+        };
+        engagement: "counted" | "unavailable";
+        coverage: {
+            state: "complete" | "partial" | "retained" | "unavailable";
+            generation: 1 | null;
+            availableFrom: number | null;
+            availableThrough: number | null;
+            retainedBefore: number | null;
+        };
+        range: {
+            from: number;
+            to: number;
+            boundary: "inclusive";
+            timezone: string;
+        };
+        features: {
+            sessionReplay: "unsupported";
+            errorInsights: "unsupported";
+            outboundLinks: "eventVolume";
+            botDetection: "userAgent";
+        };
+    };
 }>>;
 export declare const liveVisitors: import("convex/server").RegisteredQuery<"public", {
     limit?: number | undefined;
@@ -81,7 +129,81 @@ export declare const liveVisitors: import("convex/server").RegisteredQuery<"publ
     device: string;
     pageviewCount: number;
     eventCount: number;
+    previousPath?: string | undefined;
+    movedAt?: number | undefined;
 }[]>>;
+/**
+ * Every route the sites served in the range and the transitions between
+ * them, read from the daily route rollups newest day first. Exits and
+ * bounces are derived rather than counted: a session enters once, leaves
+ * once, and every later pageview is a transition, so per route
+ * `exits = entries + transitionsIn - transitionsOut` and
+ * `bounces = entries - continued` hold without a session-end hook. The
+ * report never falls back to raw telemetry; days it could not cover are
+ * declared through `coverage` and `window`.
+ */
+export declare const siteMap: import("convex/server").RegisteredQuery<"public", {
+    from: number;
+    siteIds: import("convex/values").GenericId<"sites">[];
+    to: number;
+}, Promise<{
+    from: number;
+    to: number;
+    window: {
+        from: number;
+        to: number;
+    } | null;
+    routes: {
+        route: string;
+        pageviews: number;
+        visitors: number;
+        entries: number;
+        exits: number;
+        bounces: number;
+        transitionsIn: number;
+        transitionsOut: number;
+        dwellMs: number;
+        dwellSamples: number;
+        daily: {
+            bucketStart: number;
+            pageviews: number;
+        }[];
+    }[];
+    transitions: {
+        from: string;
+        to: string;
+        count: number;
+    }[];
+    truncated: {
+        routes: boolean;
+        transitions: boolean;
+    };
+    metadata: {
+        basis: "dailyRollup";
+        coverage: {
+            state: "complete" | "partial" | "unavailable";
+            generation: 1;
+            availableFrom: number | null;
+            availableThrough: number | null;
+            retainedBefore: number | null;
+        };
+        range: {
+            from: number;
+            to: number;
+            boundary: "inclusive";
+            timezone: string;
+        };
+        visitors: {
+            basis: "estimatedUnique";
+            exact: boolean;
+        };
+        limits: {
+            routesPerDay: number;
+            transitionSlots: number;
+            rows: number;
+        };
+    };
+}>>;
 export declare const listSessions: import("convex/server").RegisteredQuery<"public", {
     from: number;
     paginationOpts: {
@@ -127,6 +249,7 @@ export declare const listSessions: import("convex/server").RegisteredQuery<"publ
         utmMedium?: string | undefined;
         utmSource?: string | undefined;
         visitorId: string;
+        visitorKey?: string | undefined;
     }[];
     isDone: boolean;
     continueCursor: string;
@@ -146,8 +269,11 @@ export declare const sessionJourney: import("convex/server").RegisteredQuery<"pu
     to: number;
 }, Promise<{
     page: {
-        _creationTime: number;
         _id: string;
+        _creationTime: number;
+        siteId: Id<"sites">;
+        sessionId: string;
+        visitorId: string;
         country?: string | undefined;
         city?: string | undefined;
         latitude?: number | undefined;
@@ -165,12 +291,11 @@ export declare const sessionJourney: import("convex/server").RegisteredQuery<"pu
         referrer?: string | undefined;
         revenueCents?: number | undefined;
         sequence: number;
-        sessionId: string;
-        siteId: import("convex/values").GenericId<"sites">;
         target?: string | undefined;
         timestamp: number;
-        type: "click" | "conversion" | "custom" | "heartbeat" | "outbound" | "pageview";
-        visitorId: string;
+        type: "click" | "conversion" | "custom" | "heartbeat" | "leave" | "outbound" | "pageview" | "vital";
+        value?: number | undefined;
+        visitorKey?: string | undefined;
     }[];
     isDone: boolean;
     continueCursor: string;
@@ -217,8 +342,11 @@ export declare const visitorJourney: import("convex/server").RegisteredQuery<"pu
     to: number;
     visitorId: string;
 }, Promise<{
-    _creationTime: number;
     _id: string;
+    _creationTime: number;
+    siteId: Id<"sites">;
+    sessionId: string;
+    visitorId: string;
     country?: string | undefined;
     city?: string | undefined;
     latitude?: number | undefined;
@@ -236,12 +364,11 @@ export declare const visitorJourney: import("convex/server").RegisteredQuery<"pu
     referrer?: string | undefined;
     revenueCents?: number | undefined;
     sequence: number;
-    sessionId: string;
-    siteId: import("convex/values").GenericId<"sites">;
     target?: string | undefined;
     timestamp: number;
-    type: "click" | "conversion" | "custom" | "heartbeat" | "outbound" | "pageview";
-    visitorId: string;
+    type: "click" | "conversion" | "custom" | "heartbeat" | "leave" | "outbound" | "pageview" | "vital";
+    value?: number | undefined;
+    visitorKey?: string | undefined;
 }[]>>;
 export declare const goalsReport: import("convex/server").RegisteredQuery<"public", {
     from: number;
@@ -263,6 +390,22 @@ export declare const goalsReport: import("convex/server").RegisteredQuery<"publi
         updatedAt: number;
     }[];
     truncated: boolean;
+    metadata: {
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            state: "complete" | "partial" | "retained" | "unavailable";
+            generation: 1 | null;
+            availableFrom: number | null;
+            availableThrough: number | null;
+            retainedBefore: number | null;
+        };
+        range: {
+            from: number;
+            to: number;
+            boundary: "inclusive";
+            timezone: string;
+        };
+    };
 }>>;
 export declare const funnelsReport: import("convex/server").RegisteredQuery<"public", {
     from: number;
@@ -278,6 +421,22 @@ export declare const funnelsReport: import("convex/server").RegisteredQuery<"pub
         completions: number;
     }[];
     truncated: boolean;
+    metadata: {
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            state: "complete" | "partial" | "retained" | "unavailable";
+            generation: 1 | null;
+            availableFrom: number | null;
+            availableThrough: number | null;
+            retainedBefore: number | null;
+        };
+        range: {
+            from: number;
+            to: number;
+            boundary: "inclusive";
+            timezone: string;
+        };
+    };
     active: boolean;
     conversionWindowMs: number;
     createdAt: number;
@@ -314,6 +473,100 @@ export declare const affiliatesReport: import("convex/server").RegisteredQuery<"
         updatedAt: number;
     }[];
     truncated: boolean;
+    metadata: {
+        basis: "boundedLegacy" | "dailyRollup";
+        coverage: {
+            state: "complete" | "partial" | "retained" | "unavailable";
+            generation: 1 | null;
+            availableFrom: number | null;
+            availableThrough: number | null;
+            retainedBefore: number | null;
+        };
+        range: {
+            from: number;
+            to: number;
+            boundary: "inclusive";
+            timezone: string;
+        };
+        uniqueVisitors: {
+            basis: "estimatedUnique" | "exactLegacy";
+            exact: boolean;
+        };
+    };
+}>>;
+export declare const vitalsReport: import("convex/server").RegisteredQuery<"public", {
+    from: number;
+    siteId: import("convex/values").GenericId<"sites">;
+    to: number;
+}, Promise<{
+    metrics: {
+        good: number;
+        needsImprovement: number;
+        poor: number;
+        count: number;
+        p75: number;
+        average: number;
+        metric: "CLS" | "FCP" | "INP" | "LCP" | "TTFB";
+        devices: {
+            good: number;
+            needsImprovement: number;
+            poor: number;
+            count: number;
+            p75: number;
+            average: number;
+            device: string;
+        }[];
+        pages: {
+            good: number;
+            needsImprovement: number;
+            poor: number;
+            count: number;
+            p75: number;
+            average: number;
+            page: string;
+        }[];
+        timeSeries: {
+            timestamp: number;
+            count: number;
+            p75: number;
+        }[];
+    }[];
+    truncated: boolean;
+    metadata: {
+        basis: "dailyRollup";
+        coverage: {
+            state: "complete" | "partial" | "retained" | "unavailable";
+            generation: 1 | null;
+            availableFrom: number | null;
+            availableThrough: number | null;
+            retainedBefore: number | null;
+        };
+        range: {
+            from: number;
+            to: number;
+            boundary: "inclusive";
+            timezone: string;
+        };
+    };
+}>>;
+export declare const dataCoverage: import("convex/server").RegisteredQuery<"public", {
+    from: number;
+    siteId: import("convex/values").GenericId<"sites">;
+    to: number;
+}, Promise<{
+    siteId: import("convex/values").GenericId<"sites">;
+    from: number;
+    to: number;
+    datasets: {
+        dataset: "affiliates" | "conversions" | "events" | "funnels" | "goals" | "overviewDay" | "overviewHour" | "overviewLocalDay" | "sessions" | "siteMap" | "vitals";
+        coverage: {
+            state: "complete" | "partial" | "retained" | "unavailable";
+            generation: 1 | null;
+            availableFrom: number | null;
+            availableThrough: number | null;
+            retainedBefore: number | null;
+        };
+    }[];
 }>>;
 type MetricTotals = {
     events: number;
@@ -325,6 +578,9 @@ type MetricTotals = {
     visitors: number;
     conversions: number;
     revenueCents: number;
+    durationMs: number;
+    continuedSessions: number;
+    newVisitors: number;
 };
 export {};
 //# sourceMappingURL=reports.d.ts.map

package/dist/component/reports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/component/reports.ts"],"names":[],"mappings":"AAwGA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;gBAmlBX,MAAM;mBACH,MAAM;gBACT,MAAM;sBACA,MAAM;wBACJ,MAAM;kBACZ,MAAM;kBACN,MAAM;qBACH,MAAM;sBACL,MAAM;;;eAniB0B,MAAM;eAAS,MAAM;sBAAgB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDzF,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;KAqDvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgE1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA+DzB,CAAC;AASH,eAAO,MAAM,WAAW;;;;;;;;qBAqB0B,MAAM;oBAAc,MAAM;;;;;;;;;;;GAgB1E,CAAC;AAWH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;KA0CxB,CAAC;AAYH,eAAO,MAAM,gBAAgB;;;;;;;;qBAgDV,MAAM;sBACL,MAAM;yBACH,MAAM;;;;;;;;;;;;;GAmC3B,CAAC;AAGH,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC"}
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/component/reports.ts"],"names":[],"mappings":"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"}