@rovela-ai/sdk 0.4.3 → 0.5.0

package/dist/analytics/server/queries.js

@@ -0,0 +1,470 @@
+/**
+ * @rovela-ai/sdk/analytics/server/queries
+ *
+ * Per-store analytics read + write helpers. Reads from the store's own Neon
+ * branch via `getDb()` (no tenant filtering). Each read returns a typed
+ * payload ready for the dashboard.
+ *
+ * Writes are best-effort: `recordEvent` swallows failures so an analytics
+ * outage NEVER breaks customer flows (checkout, cart, browse). The endpoint
+ * + webhook callers rely on that contract.
+ */
+import { sql } from 'drizzle-orm';
+import { getDb } from '../../core/db/client';
+import { ensureAnalyticsTable } from '../../core/db/queries';
+// =============================================================================
+// DB resolution — every read helper accepts an optional `db` param so the
+// platform side (which iterates over merchant stores) can pass a per-store
+// Drizzle client built via `createDb(project.databaseUrl)`. Defaults to
+// `getDb()` (env's DATABASE_URL) for the storefront-side admin dashboard.
+// =============================================================================
+function resolveDb(db) {
+    return db ?? getDb();
+}
+// =============================================================================
+// Period helpers
+// =============================================================================
+const PERIOD_DAYS = {
+    today: 1,
+    '7d': 7,
+    '30d': 30,
+    '90d': 90,
+};
+export function periodToDays(period) {
+    return PERIOD_DAYS[period];
+}
+function pctDelta(current, prior) {
+    if (prior === 0)
+        return null;
+    return (current - prior) / prior;
+}
+/**
+ * Insert a single event. Never throws — analytics MUST NEVER break the
+ * customer flow. The caller is the track endpoint OR the Stripe webhook
+ * wrapper; both have a "don't fail the user request on analytics failure"
+ * contract.
+ *
+ * For `purchase` / `refund` events, the partial unique index on `order_id`
+ * absorbs Stripe at-least-once webhook redelivery via ON CONFLICT.
+ */
+export async function recordEvent(input) {
+    try {
+        await ensureAnalyticsTable();
+        const db = getDb();
+        const e = input.event;
+        const isDedupable = e.event === 'purchase' || e.event === 'refund';
+        // Sparse-column extraction — TS narrowing keeps the union types honest.
+        const productId = 'product_id' in e ? e.product_id : null;
+        const variantId = 'variant_id' in e ? e.variant_id ?? null : null;
+        const categoryId = 'category_id' in e ? e.category_id ?? null : null;
+        const orderId = 'order_id' in e ? e.order_id : null;
+        const valueCents = 'value_cents' in e ? e.value_cents : null;
+        const quantity = 'quantity' in e ? e.quantity : null;
+        const currency = 'currency' in e ? e.currency : null;
+        if (isDedupable && orderId) {
+            // ON CONFLICT DO NOTHING via the partial unique index keyed on
+            // (order_id) WHERE event = 'purchase' OR 'refund'.
+            await db.execute(sql `
+        INSERT INTO analytics_events
+          (visitor_id, session_id, event, path, referrer,
+           product_id, variant_id, category_id, order_id,
+           value_cents, quantity, currency,
+           utm_source, utm_medium, utm_campaign, device, country)
+        VALUES
+          (${e.visitor_id}, ${e.session_id}, ${e.event}, ${e.path}, ${e.referrer ?? null},
+           ${productId}, ${variantId}, ${categoryId}, ${orderId},
+           ${valueCents}, ${quantity}, ${currency},
+           ${e.utm_source ?? null}, ${e.utm_medium ?? null}, ${e.utm_campaign ?? null},
+           ${input.device}, ${input.country})
+        ON CONFLICT DO NOTHING
+      `);
+        }
+        else {
+            await db.execute(sql `
+        INSERT INTO analytics_events
+          (visitor_id, session_id, event, path, referrer,
+           product_id, variant_id, category_id, order_id,
+           value_cents, quantity, currency,
+           utm_source, utm_medium, utm_campaign, device, country)
+        VALUES
+          (${e.visitor_id}, ${e.session_id}, ${e.event}, ${e.path}, ${e.referrer ?? null},
+           ${productId}, ${variantId}, ${categoryId}, ${orderId},
+           ${valueCents}, ${quantity}, ${currency},
+           ${e.utm_source ?? null}, ${e.utm_medium ?? null}, ${e.utm_campaign ?? null},
+           ${input.device}, ${input.country})
+      `);
+        }
+    }
+    catch (err) {
+        // Best-effort: never bubble to the caller. The track endpoint catches and
+        // returns 204 even on insert failure, so client tracking remains lossless
+        // from the visitor's perspective.
+        console.error('[analytics.recordEvent] insert failed:', err);
+    }
+}
+async function fetchOverview(start, end, db) {
+    const rows = (await db.execute(sql `
+    SELECT
+      COUNT(DISTINCT visitor_id) FILTER (WHERE event = 'page_view') AS visitors,
+      COUNT(DISTINCT session_id) FILTER (WHERE event = 'page_view') AS sessions,
+      COUNT(*)                  FILTER (WHERE event = 'page_view') AS pageviews,
+      COUNT(*)                  FILTER (WHERE event = 'purchase')  AS purchases
+    FROM analytics_events
+    WHERE ts >= ${start.toISOString()} AND ts < ${end.toISOString()}
+  `));
+    const r = rows.rows?.[0] ?? { visitors: 0, sessions: 0, pageviews: 0, purchases: 0 };
+    const sessions = Number(r.sessions);
+    const purchases = Number(r.purchases);
+    return {
+        visitors: Number(r.visitors),
+        sessions,
+        pageviews: Number(r.pageviews),
+        conversionRate: sessions === 0 ? null : purchases / sessions,
+    };
+}
+async function fetchTrend(start, end, db) {
+    const rows = (await db.execute(sql `
+    SELECT
+      date_trunc('day', ts)::date::text AS date,
+      COUNT(DISTINCT visitor_id) AS visitors
+    FROM analytics_events
+    WHERE event = 'page_view'
+      AND ts >= ${start.toISOString()} AND ts < ${end.toISOString()}
+    GROUP BY 1
+    ORDER BY 1
+  `));
+    return (rows.rows ?? []).map((r) => ({
+        date: r.date,
+        visitors: Number(r.visitors),
+    }));
+}
+async function fetchTopPages(start, end, db) {
+    const rows = (await db.execute(sql `
+    SELECT path, COUNT(*) AS views
+    FROM analytics_events
+    WHERE event = 'page_view'
+      AND ts >= ${start.toISOString()} AND ts < ${end.toISOString()}
+    GROUP BY path
+    ORDER BY views DESC
+    LIMIT 10
+  `));
+    return (rows.rows ?? []).map((r) => ({ path: r.path, views: Number(r.views) }));
+}
+async function fetchTopProducts(start, end, db) {
+    const rows = (await db.execute(sql `
+    SELECT
+      product_id::text AS product_id,
+      COUNT(*) FILTER (WHERE event = 'view_item')    AS views,
+      COUNT(*) FILTER (WHERE event = 'add_to_cart')  AS adds,
+      COUNT(*) FILTER (WHERE event = 'purchase')     AS purchases
+    FROM analytics_events
+    WHERE product_id IS NOT NULL
+      AND ts >= ${start.toISOString()} AND ts < ${end.toISOString()}
+    GROUP BY product_id
+    ORDER BY views DESC, adds DESC
+    LIMIT 10
+  `));
+    return (rows.rows ?? []).map((r) => ({
+        productId: r.product_id,
+        views: Number(r.views),
+        addsToCart: Number(r.adds),
+        purchases: Number(r.purchases),
+    }));
+}
+async function fetchSources(start, end, db) {
+    // Group by UTM source if present, else by referrer host, else 'direct'.
+    const rows = (await db.execute(sql `
+    SELECT
+      COALESCE(NULLIF(utm_source, ''), NULLIF(referrer, ''), 'direct') AS source,
+      COUNT(DISTINCT visitor_id) AS visitors
+    FROM analytics_events
+    WHERE event = 'page_view'
+      AND ts >= ${start.toISOString()} AND ts < ${end.toISOString()}
+    GROUP BY 1
+    ORDER BY visitors DESC
+    LIMIT 8
+  `));
+    return (rows.rows ?? []).map((r) => ({
+        source: r.source,
+        visitors: Number(r.visitors),
+    }));
+}
+async function fetchDevices(start, end, db) {
+    const rows = (await db.execute(sql `
+    SELECT
+      COALESCE(NULLIF(device, ''), 'unknown') AS device,
+      COUNT(DISTINCT visitor_id) AS visitors
+    FROM analytics_events
+    WHERE event = 'page_view'
+      AND ts >= ${start.toISOString()} AND ts < ${end.toISOString()}
+    GROUP BY 1
+    ORDER BY visitors DESC
+  `));
+    return (rows.rows ?? []).map((r) => ({
+        device: r.device,
+        visitors: Number(r.visitors),
+    }));
+}
+/**
+ * Dashboard payload. Period-scoped current + prior windows for delta-vs-prior
+ * KPIs. All seven panels fan out in one Promise.all (~150ms warm Neon).
+ *
+ * @param db Optional Drizzle client. Default: `getDb()` (env DATABASE_URL).
+ *           Platform-side passes `createDb(project.databaseUrl)` to read
+ *           from a merchant's branch.
+ */
+export async function getAnalyticsDashboard(period, db) {
+    const dbRef = resolveDb(db);
+    // Pre-provisioned platform stores already have the table; the self-heal
+    // here is a no-op then. New stores get it created on first call.
+    // Skipped when caller passes a `db` — caller (platform) shouldn't trigger
+    // schema mutations against arbitrary merchant branches from a Rovela
+    // platform request. The storefront-side AnalyticsProvider track endpoint
+    // already runs the ensure path on first write.
+    if (!db) {
+        await ensureAnalyticsTable();
+    }
+    const days = periodToDays(period);
+    const now = new Date();
+    const start = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const priorStart = new Date(start.getTime() - days * 24 * 60 * 60 * 1000);
+    const [current, prior, trend, topPages, topProducts, sources, devices] = await Promise.all([
+        fetchOverview(start, now, dbRef),
+        fetchOverview(priorStart, start, dbRef),
+        fetchTrend(start, now, dbRef),
+        fetchTopPages(start, now, dbRef),
+        fetchTopProducts(start, now, dbRef),
+        fetchSources(start, now, dbRef),
+        fetchDevices(start, now, dbRef),
+    ]);
+    const overview = {
+        current,
+        prior,
+        deltas: {
+            visitors: pctDelta(current.visitors, prior.visitors),
+            sessions: pctDelta(current.sessions, prior.sessions),
+            pageviews: pctDelta(current.pageviews, prior.pageviews),
+            conversionRate: current.conversionRate === null || prior.conversionRate === null
+                ? null
+                : pctDelta(current.conversionRate, prior.conversionRate),
+        },
+    };
+    return {
+        period,
+        overview,
+        trend,
+        topPages,
+        topProducts,
+        sources,
+        devices,
+    };
+}
+// =============================================================================
+// Platform-side compact summary (per-store overview card)
+// =============================================================================
+/**
+ * 7-day visitor + conversion summary for the Rovela platform's per-store
+ * Traffic card. Fast (3 small aggregates) — the platform fan-outs across
+ * every store the user can see, so we keep this tight.
+ */
+export async function getTrafficSummary7d(db) {
+    const dbRef = resolveDb(db);
+    if (!db) {
+        await ensureAnalyticsTable();
+    }
+    const now = new Date();
+    const sevenDaysAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+    const fourteenDaysAgo = new Date(now.getTime() - 14 * 24 * 60 * 60 * 1000);
+    const [current, prior] = await Promise.all([
+        fetchOverview(sevenDaysAgo, now, dbRef),
+        fetchOverview(fourteenDaysAgo, sevenDaysAgo, dbRef),
+    ]);
+    return {
+        visitors7d: current.visitors,
+        visitorsPrior7d: prior.visitors,
+        delta: pctDelta(current.visitors, prior.visitors),
+        conversionRate7d: current.conversionRate,
+    };
+}
+const EVENT_LOG_SORT_COLUMNS = new Set([
+    'ts',
+    'event',
+    'path',
+    'referrer',
+    'country',
+]);
+export async function getEventsLog(options, db) {
+    const dbRef = resolveDb(db);
+    if (!db) {
+        await ensureAnalyticsTable();
+    }
+    const days = periodToDays(options.period);
+    const now = new Date();
+    const start = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const limit = Math.min(Math.max(options.limit ?? 50, 1), 200);
+    // Fetch one extra row to detect "is there a next page". The extra row is
+    // sliced off before returning.
+    const fetchLimit = limit + 1;
+    const sortBy = EVENT_LOG_SORT_COLUMNS.has(options.sortBy)
+        ? options.sortBy
+        : 'ts';
+    const sortDir = options.sortDir === 'asc' ? 'asc' : 'desc';
+    // Cursor predicate — only meaningful for the default ts-desc sort because
+    // mixing sort + cursor on arbitrary columns is error-prone. For non-ts
+    // sorts we ignore the cursor and just return the first page; the UI
+    // disables paginate-by-cursor when a custom sort is active.
+    const cursorBigInt = options.cursor && /^\d+$/.test(options.cursor)
+        ? options.cursor
+        : null;
+    const orderClause = sortBy === 'ts'
+        ? sortDir === 'asc'
+            ? sql `ts ASC, id ASC`
+            : sql `ts DESC, id DESC`
+        : sortBy === 'event'
+            ? sortDir === 'asc'
+                ? sql `event ASC, ts DESC`
+                : sql `event DESC, ts DESC`
+            : sortBy === 'path'
+                ? sortDir === 'asc'
+                    ? sql `path ASC, ts DESC`
+                    : sql `path DESC, ts DESC`
+                : sortBy === 'referrer'
+                    ? sortDir === 'asc'
+                        ? sql `referrer ASC NULLS LAST, ts DESC`
+                        : sql `referrer DESC NULLS LAST, ts DESC`
+                    : sortDir === 'asc'
+                        ? sql `country ASC NULLS LAST, ts DESC`
+                        : sql `country DESC NULLS LAST, ts DESC`;
+    const cursorClause = sortBy === 'ts' && cursorBigInt
+        ? sortDir === 'desc'
+            ? sql `AND id < ${cursorBigInt}::bigint`
+            : sql `AND id > ${cursorBigInt}::bigint`
+        : sql ``;
+    const heartbeatClause = options.hideHeartbeats
+        ? sql `AND event <> 'session_heartbeat'`
+        : sql ``;
+    const result = (await dbRef.execute(sql `
+    SELECT id, ts, event, path, referrer, country, session_id, visitor_id,
+           product_id, value_cents, currency, device
+    FROM analytics_events
+    WHERE ts >= ${start.toISOString()} AND ts < ${now.toISOString()}
+    ${cursorClause}
+    ${heartbeatClause}
+    ORDER BY ${orderClause}
+    LIMIT ${fetchLimit}
+  `));
+    const allRows = result.rows ?? [];
+    const hasMore = allRows.length > limit;
+    const slice = hasMore ? allRows.slice(0, limit) : allRows;
+    // Cursor for next page is only stable for ts-sorted pagination.
+    const nextCursor = hasMore && sortBy === 'ts' ? String(slice[slice.length - 1].id) : null;
+    const mapped = slice.map((r) => ({
+        id: String(r.id),
+        ts: timestampToIso(r.ts),
+        event: r.event,
+        path: r.path,
+        referrer: r.referrer,
+        country: r.country,
+        sessionId: r.session_id,
+        visitorId: r.visitor_id,
+        productId: r.product_id,
+        valueCents: r.value_cents === null ? null : Number(r.value_cents),
+        currency: r.currency,
+        device: r.device,
+    }));
+    return { rows: mapped, nextCursor };
+}
+const VISITOR_SORT_COLUMNS = new Set([
+    'last_seen',
+    'first_seen',
+    'sessions',
+    'pageviews',
+    'country',
+]);
+function timestampToIso(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    return String(value ?? '');
+}
+export async function getVisitorsList(options, db) {
+    const dbRef = resolveDb(db);
+    if (!db) {
+        await ensureAnalyticsTable();
+    }
+    const days = periodToDays(options.period);
+    const now = new Date();
+    const start = new Date(now.getTime() - days * 24 * 60 * 60 * 1000);
+    const limit = Math.min(Math.max(options.limit ?? 50, 1), 200);
+    const fetchLimit = limit + 1;
+    const offset = options.cursor && /^\d+$/.test(options.cursor)
+        ? Number(options.cursor)
+        : 0;
+    const sortBy = VISITOR_SORT_COLUMNS.has(options.sortBy)
+        ? options.sortBy
+        : 'last_seen';
+    const sortDir = options.sortDir === 'asc' ? 'asc' : 'desc';
+    const orderClause = sortBy === 'last_seen'
+        ? sortDir === 'asc'
+            ? sql `last_seen ASC`
+            : sql `last_seen DESC`
+        : sortBy === 'first_seen'
+            ? sortDir === 'asc'
+                ? sql `first_seen ASC`
+                : sql `first_seen DESC`
+            : sortBy === 'sessions'
+                ? sortDir === 'asc'
+                    ? sql `sessions ASC`
+                    : sql `sessions DESC`
+                : sortBy === 'pageviews'
+                    ? sortDir === 'asc'
+                        ? sql `pageviews ASC`
+                        : sql `pageviews DESC`
+                    : sortDir === 'asc'
+                        ? sql `country ASC NULLS LAST`
+                        : sql `country DESC NULLS LAST`;
+    // First-touch attribution via a correlated subquery scoped to the same
+    // period window. Cheap because (visitor_id, ts) is indexed.
+    const result = (await dbRef.execute(sql `
+    SELECT
+      ae.visitor_id,
+      MIN(ae.ts)                                         AS first_seen,
+      MAX(ae.ts)                                         AS last_seen,
+      COUNT(DISTINCT ae.session_id)                      AS sessions,
+      COUNT(*) FILTER (WHERE ae.event = 'page_view')     AS pageviews,
+      COUNT(*) FILTER (WHERE ae.event = 'purchase')      AS purchases,
+      MAX(ae.country)                                    AS country,
+      (
+        SELECT COALESCE(NULLIF(sub.utm_source, ''),
+                        NULLIF(sub.referrer, ''),
+                        'direct')
+        FROM analytics_events sub
+        WHERE sub.visitor_id = ae.visitor_id
+          AND sub.ts >= ${start.toISOString()}
+          AND sub.ts < ${now.toISOString()}
+        ORDER BY sub.ts ASC
+        LIMIT 1
+      )                                                  AS initial_source
+    FROM analytics_events ae
+    WHERE ae.ts >= ${start.toISOString()} AND ae.ts < ${now.toISOString()}
+    GROUP BY ae.visitor_id
+    ORDER BY ${orderClause}
+    LIMIT ${fetchLimit}
+    OFFSET ${offset}
+  `));
+    const allRows = result.rows ?? [];
+    const hasMore = allRows.length > limit;
+    const slice = hasMore ? allRows.slice(0, limit) : allRows;
+    const nextCursor = hasMore ? String(offset + limit) : null;
+    const mapped = slice.map((r) => ({
+        visitorId: r.visitor_id,
+        firstSeen: timestampToIso(r.first_seen),
+        lastSeen: timestampToIso(r.last_seen),
+        sessions: Number(r.sessions),
+        pageviews: Number(r.pageviews),
+        purchases: Number(r.purchases),
+        country: r.country,
+        initialSource: r.initial_source ?? 'direct',
+    }));
+    return { rows: mapped, nextCursor };
+}
+//# sourceMappingURL=queries.js.map

package/dist/analytics/server/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/analytics/server/queries.ts"],"names":[],"mappings":"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"}

package/dist/analytics/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * @rovela-ai/sdk/analytics/types
+ *
+ * Event vocabulary for the storefront analytics tracker. GA4-shaped.
+ *
+ * Discriminated union — every event type lists its required fields explicitly.
+ * The server's track endpoint validates against this shape; unknown events are
+ * rejected with 400. New events must be added BOTH to the union below AND to
+ * the CHECK constraint in `ensureAnalyticsTable()` (core/db/queries.ts).
+ *
+ * Identity fields (`visitor_id`, `session_id`) are supplied by the client
+ * tracker, not declared on each event. Server-derived fields (`device`,
+ * `country`, `ts`) are added during the INSERT and not part of the wire shape.
+ */
+/** Event kinds. Keep in lockstep with the SQL CHECK constraint
+ *  (core/db/queries.ts `ensureAnalyticsTable`). */
+export type AnalyticsEventKind = 'page_view' | 'session_start' | 'session_heartbeat' | 'session_end' | 'view_item_list' | 'view_item' | 'select_item' | 'add_to_cart' | 'view_cart' | 'begin_checkout' | 'add_shipping_info' | 'purchase' | 'refund';
+/** Identity envelope present on every wire event. */
+export interface AnalyticsIdentity {
+    visitor_id: string;
+    session_id: string;
+}
+/** Shared optional context every event may carry. */
+export interface AnalyticsCommon {
+    path: string;
+    referrer?: string | null;
+    utm_source?: string | null;
+    utm_medium?: string | null;
+    utm_campaign?: string | null;
+}
+/** Per-event-type payload, before identity + server-derived fields are merged. */
+export type AnalyticsPayload = ({
+    event: 'page_view';
+} & AnalyticsCommon) | ({
+    event: 'session_start';
+} & AnalyticsCommon) | ({
+    event: 'session_heartbeat';
+} & AnalyticsCommon) | ({
+    event: 'session_end';
+} & AnalyticsCommon) | ({
+    event: 'view_item_list';
+    category_id: string;
+} & AnalyticsCommon) | ({
+    event: 'view_item';
+    product_id: string;
+    value_cents: number;
+    currency: string;
+} & AnalyticsCommon) | ({
+    event: 'select_item';
+    product_id: string;
+    category_id?: string | null;
+} & AnalyticsCommon) | ({
+    event: 'add_to_cart';
+    product_id: string;
+    variant_id?: string | null;
+    quantity: number;
+    value_cents: number;
+    currency: string;
+} & AnalyticsCommon) | ({
+    event: 'view_cart';
+    value_cents: number;
+    currency: string;
+} & AnalyticsCommon) | ({
+    event: 'begin_checkout';
+    value_cents: number;
+    currency: string;
+} & AnalyticsCommon) | ({
+    event: 'add_shipping_info';
+    value_cents: number;
+    currency: string;
+} & AnalyticsCommon) | ({
+    event: 'purchase';
+    order_id: string;
+    value_cents: number;
+    currency: string;
+} & AnalyticsCommon) | ({
+    event: 'refund';
+    order_id: string;
+    value_cents: number;
+    currency: string;
+} & AnalyticsCommon);
+/** Full wire event = identity + payload. */
+export type AnalyticsWireEvent = AnalyticsIdentity & AnalyticsPayload;
+export type AnalyticsPeriod = 'today' | '7d' | '30d' | '90d';
+/** Primary KPI row — visitors / sessions / pageviews / conversion. */
+export interface AnalyticsOverview {
+    visitors: number;
+    sessions: number;
+    pageviews: number;
+    /** Decimal ratio. `purchases / sessions`. null when sessions=0. */
+    conversionRate: number | null;
+}
+export interface AnalyticsOverviewWithDeltas {
+    current: AnalyticsOverview;
+    prior: AnalyticsOverview;
+    /** Decimal delta against prior (e.g. +0.18 = +18%). null when prior=0. */
+    deltas: {
+        visitors: number | null;
+        sessions: number | null;
+        pageviews: number | null;
+        conversionRate: number | null;
+    };
+}
+export interface AnalyticsTrendPoint {
+    date: string;
+    visitors: number;
+}
+export interface AnalyticsTopPage {
+    path: string;
+    views: number;
+}
+export interface AnalyticsTopProduct {
+    productId: string;
+    views: number;
+    addsToCart: number;
+    purchases: number;
+}
+export interface AnalyticsSourceBucket {
+    source: string;
+    visitors: number;
+}
+export interface AnalyticsDeviceBucket {
+    device: string;
+    visitors: number;
+}
+export interface AnalyticsDashboardPayload {
+    period: AnalyticsPeriod;
+    overview: AnalyticsOverviewWithDeltas;
+    trend: AnalyticsTrendPoint[];
+    topPages: AnalyticsTopPage[];
+    topProducts: AnalyticsTopProduct[];
+    sources: AnalyticsSourceBucket[];
+    devices: AnalyticsDeviceBucket[];
+}
+export interface AnalyticsTrafficSummary {
+    visitors7d: number;
+    visitorsPrior7d: number;
+    /** Decimal delta against prior 7d. null when prior=0. */
+    delta: number | null;
+    /** Decimal ratio. null when sessions=0. */
+    conversionRate7d: number | null;
+}
+export interface AnalyticsEventLogRow {
+    /** Row id — opaque, used for cursor pagination. Encoded as string in JSON to
+     *  preserve precision for clients (bigserial > Number.MAX_SAFE_INTEGER one
+     *  day, far away but cheap to future-proof). */
+    id: string;
+    ts: string;
+    event: AnalyticsEventKind;
+    path: string;
+    referrer: string | null;
+    country: string | null;
+    sessionId: string;
+    visitorId: string;
+    /** Optional commerce context — populated for view_item / add_to_cart /
+     *  purchase / refund / etc. */
+    productId: string | null;
+    valueCents: number | null;
+    currency: string | null;
+    device: string | null;
+}
+export type AnalyticsSortDir = 'asc' | 'desc';
+export interface AnalyticsEventsLogPage {
+    rows: AnalyticsEventLogRow[];
+    /** Cursor for the next page (the `id` of the last row, ascending sort order).
+     *  null when there's no more data. */
+    nextCursor: string | null;
+}
+export interface AnalyticsVisitorRow {
+    visitorId: string;
+    firstSeen: string;
+    lastSeen: string;
+    sessions: number;
+    pageviews: number;
+    purchases: number;
+    country: string | null;
+    /** First touch attribution — utm_source if present, else referrer host,
+     *  else 'direct'. */
+    initialSource: string;
+}
+export interface AnalyticsVisitorsPage {
+    rows: AnalyticsVisitorRow[];
+    /** Offset cursor (string for symmetry with events). null when no more. */
+    nextCursor: string | null;
+}
+//# sourceMappingURL=types.d.ts.map