@iann29/rastro 0.1.0-alpha.0 → 0.1.0-alpha.10

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;
@@ -26,6 +27,11 @@ export declare const overview: import("convex/server").RegisteredQuery<"public",
         count: number;
         revenueCents: number;
     }[];
+    topCampaigns: {
+        value: string;
+        count: number;
+        revenueCents: number;
+    }[];
     topPages: {
         value: string;
         count: number;
@@ -56,6 +62,44 @@ 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";
+            topCampaigns: "eventVolume";
+            topPages: "eventVolume";
+            topCountries: "eventVolume";
+            topDevices: "eventVolume";
+            topBrowsers: "eventVolume";
+            topEvents: "eventVolume";
+            topGoals: "goalCompletionVolume";
+        };
+        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: "UTC";
+        };
+        features: {
+            sessionReplay: "unsupported";
+            errorInsights: "unsupported";
+            outboundLinks: "eventVolume";
+            botDetection: "userAgent";
+        };
+    };
 }>>;
 export declare const liveVisitors: import("convex/server").RegisteredQuery<"public", {
     limit?: number | undefined;
@@ -81,7 +125,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: "UTC";
+        };
+        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 +245,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,31 +265,33 @@ export declare const sessionJourney: import("convex/server").RegisteredQuery<"pu
     to: number;
 }, Promise<{
     page: {
+        _id: string;
         _creationTime: number;
-        _id: import("convex/values").GenericId<"events">;
-        affiliateSlug?: string | undefined;
-        browser: string;
-        city?: string | undefined;
+        siteId: Id<"sites">;
+        sessionId: string;
+        visitorId: string;
         country?: string | undefined;
-        currency?: string | undefined;
+        city?: string | undefined;
+        latitude?: number | undefined;
+        longitude?: number | undefined;
+        browser: string;
+        os: string;
         device: string;
+        affiliateSlug?: string | undefined;
+        currency?: string | undefined;
         eventId: string;
         href?: string | undefined;
-        latitude?: number | undefined;
-        longitude?: number | undefined;
         name?: string | undefined;
-        os: string;
         path: string;
         properties?: Record<string, string | number | boolean | null> | undefined;
         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,31 +338,33 @@ export declare const visitorJourney: import("convex/server").RegisteredQuery<"pu
     to: number;
     visitorId: string;
 }, Promise<{
+    _id: string;
     _creationTime: number;
-    _id: import("convex/values").GenericId<"events">;
-    affiliateSlug?: string | undefined;
-    browser: string;
-    city?: string | undefined;
+    siteId: Id<"sites">;
+    sessionId: string;
+    visitorId: string;
     country?: string | undefined;
-    currency?: string | undefined;
+    city?: string | undefined;
+    latitude?: number | undefined;
+    longitude?: number | undefined;
+    browser: string;
+    os: string;
     device: string;
+    affiliateSlug?: string | undefined;
+    currency?: string | undefined;
     eventId: string;
     href?: string | undefined;
-    latitude?: number | undefined;
-    longitude?: number | undefined;
     name?: string | undefined;
-    os: string;
     path: string;
     properties?: Record<string, string | number | boolean | null> | undefined;
     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 +386,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: "UTC";
+        };
+    };
 }>>;
 export declare const funnelsReport: import("convex/server").RegisteredQuery<"public", {
     from: number;
@@ -278,6 +417,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: "UTC";
+        };
+    };
     active: boolean;
     conversionWindowMs: number;
     createdAt: number;
@@ -314,6 +469,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: "UTC";
+        };
+        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: "UTC";
+        };
+    };
+}>>;
+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" | "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;

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

@@ -1 +1 @@
-{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/component/reports.ts"],"names":[],"mappings":"AAgGA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;gBAieX,MAAM;mBACH,MAAM;gBACT,MAAM;sBACA,MAAM;wBACJ,MAAM;kBACZ,MAAM;kBACN,MAAM;qBACH,MAAM;sBACL,MAAM;;;eAlb0B,MAAM;eAAS,MAAM;sBAAgB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDzF,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;KAqDvB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuBvB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyBzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuB1B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoCzB,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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"}