@creezio/observability 0.22.0

package/dist/usage/usage-analytics-productivity.js

@@ -0,0 +1,317 @@
+/**
+ * Agrégations productivité : heatmap, heures actives, pauses, score.
+ * Basé sur les événements usage_events (heartbeats, clics, pages, idle…).
+ */
+import { uaQueryAll as queryAll } from "./adapters.js";
+import { ensureUsageAnalyticsSchema, } from "./usage-analytics.js";
+/** Seuil pause courte (gap activité). */
+export const BREAK_MIN_MS = 5 * 60_000;
+/** Au-delà → coupure de journée / session, pas une pause. */
+export const BREAK_MAX_MS = 4 * 60 * 60_000;
+/** Granularité activité (fallback sans heartbeat). */
+const BUCKET_MS = 5 * 60_000;
+function buildWhere(filters) {
+    const parts = ["1=1"];
+    const params = [];
+    if (filters.from) {
+        parts.push("created_at >= ?");
+        params.push(filters.from);
+    }
+    if (filters.to) {
+        parts.push("created_at <= ?");
+        params.push(filters.to);
+    }
+    if (filters.userId) {
+        parts.push("user_id = ?");
+        params.push(filters.userId);
+    }
+    if (filters.kind && filters.kind !== "all") {
+        parts.push("user_kind = ?");
+        params.push(filters.kind);
+    }
+    return { sql: parts.join(" AND "), params };
+}
+function dayKey(d) {
+    return d.toISOString().slice(0, 10);
+}
+function scoreProductivity(input) {
+    const activeHours = input.activeMs / 3_600_000;
+    const expectedPerDay = 6.5; // journée type CRM
+    const coverage = input.daysActive > 0
+        ? Math.min(1, activeHours / (expectedPerDay * input.daysActive))
+        : 0;
+    const focus = input.activeMs + input.idleMs > 0
+        ? input.activeMs / (input.activeMs + input.idleMs)
+        : 0;
+    const density = activeHours > 0 ? Math.min(1, (input.clicks + input.events * 0.15) / (activeHours * 40)) : 0;
+    const raw = coverage * 0.45 + focus * 0.35 + density * 0.2;
+    return Math.round(Math.max(0, Math.min(100, raw * 100)));
+}
+function analyzeUserEvents(userId, username, kind, events, period) {
+    const sorted = [...events].sort((a, b) => a.created_at.localeCompare(b.created_at));
+    const heatmapMap = new Map();
+    const dailyMap = new Map();
+    const ensureDay = (date) => {
+        let d = dailyMap.get(date);
+        if (!d) {
+            d = {
+                activeBuckets: new Set(),
+                heartbeatMs: 0,
+                idleMs: 0,
+                events: 0,
+                clicks: 0,
+                pageViews: 0,
+                heartbeats: 0,
+                firstSeen: null,
+                lastSeen: null,
+                times: [],
+            };
+            dailyMap.set(date, d);
+        }
+        return d;
+    };
+    for (const e of sorted) {
+        const t = new Date(e.created_at);
+        if (Number.isNaN(t.getTime()))
+            continue;
+        const date = dayKey(t);
+        const day = ensureDay(date);
+        day.events += 1;
+        day.times.push(t.getTime());
+        if (!day.firstSeen)
+            day.firstSeen = e.created_at;
+        day.lastSeen = e.created_at;
+        if (e.event_type === "ui.click")
+            day.clicks += 1;
+        if (e.event_type === "page.view")
+            day.pageViews += 1;
+        if (e.event_type === "presence.heartbeat") {
+            day.heartbeats += 1;
+            day.heartbeatMs += Math.min(e.duration_ms || 60_000, 120_000);
+        }
+        if (e.event_type === "presence.idle" && e.duration_ms) {
+            day.idleMs += e.duration_ms;
+        }
+        // Bucket activité 5 min
+        const bucket = Math.floor(t.getTime() / BUCKET_MS);
+        day.activeBuckets.add(bucket);
+        const weekday = t.getUTCDay();
+        const hour = t.getUTCHours();
+        const hk = `${weekday}:${hour}`;
+        let cell = heatmapMap.get(hk);
+        if (!cell) {
+            cell = { weekday, hour, events: 0, activeMs: 0 };
+            heatmapMap.set(hk, cell);
+        }
+        cell.events += 1;
+        if (e.event_type === "presence.heartbeat") {
+            cell.activeMs += Math.min(e.duration_ms || 60_000, 120_000);
+        }
+    }
+    // Pauses + focus blocks depuis timestamps
+    const allTimes = sorted
+        .map((e) => new Date(e.created_at).getTime())
+        .filter((n) => !Number.isNaN(n));
+    const breaks = [];
+    const focusBlocks = [];
+    let blockStart = allTimes[0] ?? 0;
+    let blockEvents = 0;
+    let last = allTimes[0] ?? 0;
+    for (let i = 0; i < allTimes.length; i++) {
+        const cur = allTimes[i];
+        if (i === 0) {
+            blockStart = cur;
+            blockEvents = 1;
+            last = cur;
+            continue;
+        }
+        const gap = cur - last;
+        if (gap >= BREAK_MIN_MS && gap <= BREAK_MAX_MS) {
+            // clôturer focus block
+            if (last > blockStart) {
+                focusBlocks.push({
+                    startedAt: new Date(blockStart).toISOString(),
+                    endedAt: new Date(last).toISOString(),
+                    durationMs: last - blockStart,
+                    events: blockEvents,
+                });
+            }
+            breaks.push({
+                startedAt: new Date(last).toISOString(),
+                endedAt: new Date(cur).toISOString(),
+                durationMs: gap,
+                day: dayKey(new Date(last)),
+            });
+            blockStart = cur;
+            blockEvents = 1;
+        }
+        else if (gap > BREAK_MAX_MS) {
+            if (last > blockStart) {
+                focusBlocks.push({
+                    startedAt: new Date(blockStart).toISOString(),
+                    endedAt: new Date(last).toISOString(),
+                    durationMs: last - blockStart,
+                    events: blockEvents,
+                });
+            }
+            blockStart = cur;
+            blockEvents = 1;
+        }
+        else {
+            blockEvents += 1;
+        }
+        last = cur;
+    }
+    if (allTimes.length && last > blockStart) {
+        focusBlocks.push({
+            startedAt: new Date(blockStart).toISOString(),
+            endedAt: new Date(last).toISOString(),
+            durationMs: last - blockStart,
+            events: blockEvents,
+        });
+    }
+    const breakMsByDay = new Map();
+    for (const b of breaks) {
+        const cur = breakMsByDay.get(b.day) || { ms: 0, n: 0 };
+        cur.ms += b.durationMs;
+        cur.n += 1;
+        breakMsByDay.set(b.day, cur);
+    }
+    const daily = Array.from(dailyMap.entries())
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([date, d]) => {
+        const bucketActive = d.activeBuckets.size * BUCKET_MS;
+        const activeMs = d.heartbeatMs > 0 ? d.heartbeatMs : bucketActive;
+        const br = breakMsByDay.get(date) || { ms: 0, n: 0 };
+        return {
+            date,
+            activeMs,
+            idleMs: d.idleMs,
+            breakMs: br.ms,
+            breaksCount: br.n,
+            events: d.events,
+            clicks: d.clicks,
+            pageViews: d.pageViews,
+            heartbeats: d.heartbeats,
+            firstSeen: d.firstSeen,
+            lastSeen: d.lastSeen,
+            productivityScore: scoreProductivity({
+                activeMs,
+                idleMs: d.idleMs,
+                events: d.events,
+                clicks: d.clicks,
+                daysActive: 1,
+            }),
+        };
+    });
+    const activeMs = daily.reduce((s, d) => s + d.activeMs, 0);
+    const idleMs = daily.reduce((s, d) => s + d.idleMs, 0);
+    const breakMs = breaks.reduce((s, b) => s + b.durationMs, 0);
+    const clicks = daily.reduce((s, d) => s + d.clicks, 0);
+    const pageViews = daily.reduce((s, d) => s + d.pageViews, 0);
+    const eventsCount = daily.reduce((s, d) => s + d.events, 0);
+    const daysActive = daily.filter((d) => d.activeMs > 0 || d.events > 0).length;
+    const heatmap = Array.from(heatmapMap.values()).sort((a, b) => a.weekday - b.weekday || a.hour - b.hour);
+    let peakHour = null;
+    let peakWeekday = null;
+    let peakVal = -1;
+    for (const c of heatmap) {
+        const v = c.activeMs + c.events * 1000;
+        if (v > peakVal) {
+            peakVal = v;
+            peakHour = c.hour;
+            peakWeekday = c.weekday;
+        }
+    }
+    const activeHours = activeMs / 3_600_000;
+    const summary = {
+        userId,
+        username,
+        kind,
+        activeMs,
+        idleMs,
+        breakMs,
+        avgActivePerDayMs: daysActive > 0 ? Math.round(activeMs / daysActive) : 0,
+        avgBreakMs: breaks.length ? Math.round(breakMs / breaks.length) : 0,
+        breaksCount: breaks.length,
+        focusBlocksCount: focusBlocks.length,
+        avgFocusBlockMs: focusBlocks.length
+            ? Math.round(focusBlocks.reduce((s, f) => s + f.durationMs, 0) / focusBlocks.length)
+            : 0,
+        peakHour,
+        peakWeekday,
+        eventsPerActiveHour: activeHours > 0 ? Math.round((eventsCount / activeHours) * 10) / 10 : 0,
+        focusRatio: activeMs + idleMs > 0
+            ? Math.round((activeMs / (activeMs + idleMs)) * 1000) / 1000
+            : 0,
+        productivityScore: scoreProductivity({
+            activeMs,
+            idleMs,
+            events: eventsCount,
+            clicks,
+            daysActive: Math.max(daysActive, 1),
+        }),
+        daysActive,
+        events: eventsCount,
+        clicks,
+        pageViews,
+    };
+    // Cap listes pour l'API
+    const recentBreaks = breaks.slice(-40).reverse();
+    const topFocus = [...focusBlocks].sort((a, b) => b.durationMs - a.durationMs).slice(0, 20);
+    return {
+        summary,
+        heatmap,
+        daily,
+        breaks: recentBreaks,
+        focusBlocks: topFocus,
+    };
+}
+export function getProductivityReport(filters) {
+    ensureUsageAnalyticsSchema();
+    const { sql, params } = buildWhere(filters);
+    const rows = queryAll(`SELECT created_at, event_type, duration_ms, user_id, username, user_kind
+     FROM usage_events
+     WHERE ${sql}
+       AND user_id IS NOT NULL
+       AND event_type NOT IN ('session.context')
+     ORDER BY created_at ASC
+     LIMIT 50000`, params);
+    const period = { from: filters.from || "", to: filters.to || "" };
+    const byUser = new Map();
+    for (const r of rows) {
+        if (!r.user_id)
+            continue;
+        const list = byUser.get(r.user_id) || [];
+        list.push(r);
+        byUser.set(r.user_id, list);
+    }
+    const leaderboard = [];
+    let detail = null;
+    for (const [uid, evs] of Array.from(byUser.entries())) {
+        const username = evs.find((e) => e.username)?.username || uid;
+        const kind = evs.find((e) => e.user_kind)?.user_kind || "human";
+        const analyzed = analyzeUserEvents(uid, username, kind, evs, period);
+        if (analyzed.summary)
+            leaderboard.push(analyzed.summary);
+        if (filters.userId && uid === filters.userId)
+            detail = analyzed;
+    }
+    leaderboard.sort((a, b) => b.productivityScore - a.productivityScore || b.activeMs - a.activeMs);
+    // Sans userId : rapport du top user pour la heatmap, + leaderboard
+    if (!detail && leaderboard[0]) {
+        const topId = leaderboard[0].userId;
+        const evs = byUser.get(topId) || [];
+        detail = analyzeUserEvents(topId, leaderboard[0].username, leaderboard[0].kind, evs, period);
+    }
+    return {
+        period,
+        summary: detail?.summary || null,
+        heatmap: detail?.heatmap || [],
+        daily: detail?.daily || [],
+        breaks: detail?.breaks || [],
+        focusBlocks: detail?.focusBlocks || [],
+        leaderboard,
+    };
+}
+//# sourceMappingURL=usage-analytics-productivity.js.map

package/dist/usage/usage-analytics-productivity.js.map

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

package/dist/usage/usage-analytics-shared.d.ts

@@ -0,0 +1,5 @@
+/** Types / helpers partagés client + serveur (sans dépendance SQLite). */
+export type UsageUserKind = "human" | "ai" | "system" | "unknown";
+export type UsagePeriod = "day" | "week" | "month" | "year";
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=usage-analytics-shared.d.ts.map

package/dist/usage/usage-analytics-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-analytics-shared.d.ts","sourceRoot":"","sources":["../../src/usage/usage-analytics-shared.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAajD"}

package/dist/usage/usage-analytics-shared.js

@@ -0,0 +1,20 @@
+/** Types / helpers partagés client + serveur (sans dépendance SQLite). */
+export function formatDuration(ms) {
+    if (!ms || ms < 0)
+        return "0s";
+    const s = Math.round(ms / 1000);
+    if (s < 60)
+        return `${s}s`;
+    const m = Math.floor(s / 60);
+    const rs = s % 60;
+    if (m < 60)
+        return rs ? `${m}m ${rs}s` : `${m}m`;
+    const h = Math.floor(m / 60);
+    const rm = m % 60;
+    if (h < 48)
+        return rm ? `${h}h ${rm}m` : `${h}h`;
+    const d = Math.floor(h / 24);
+    const rh = h % 24;
+    return rh ? `${d}j ${rh}h` : `${d}j`;
+}
+//# sourceMappingURL=usage-analytics-shared.js.map

package/dist/usage/usage-analytics-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-analytics-shared.js","sourceRoot":"","sources":["../../src/usage/usage-analytics-shared.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAK1E,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACjD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;AACvC,CAAC"}

package/dist/usage/usage-analytics.d.ts

@@ -0,0 +1,127 @@
+import { formatDuration, type UsagePeriod, type UsageUserKind } from "./usage-analytics-shared.js";
+export type { UsagePeriod, UsageUserKind };
+export { formatDuration };
+export type UsageEventInput = {
+    eventType: string;
+    category?: string;
+    label?: string | null;
+    path?: string | null;
+    referrerPath?: string | null;
+    userId?: string | null;
+    username?: string | null;
+    userKind?: UsageUserKind | string | null;
+    userRole?: string | null;
+    sessionId?: string | null;
+    durationMs?: number | null;
+    meta?: Record<string, unknown> | null;
+    userAgent?: string | null;
+    surface?: string | null;
+    createdAt?: string | null;
+};
+export type UsageEventRow = {
+    id: number;
+    created_at: string;
+    event_type: string;
+    category: string;
+    label: string | null;
+    path: string | null;
+    referrer_path: string | null;
+    user_id: string | null;
+    username: string | null;
+    user_kind: string;
+    user_role: string | null;
+    session_id: string | null;
+    duration_ms: number | null;
+    meta_json: string | null;
+    user_agent: string | null;
+    surface: string;
+};
+export type UsageFilters = {
+    from?: string;
+    to?: string;
+    userId?: string;
+    kind?: UsageUserKind | "all";
+    eventType?: string;
+    path?: string;
+    q?: string;
+};
+export declare function usageAnalyticsReady(): boolean;
+/** Crée la table si absente (dev / avant migration Electron). */
+export declare function ensureUsageAnalyticsSchema(): void;
+export declare function insertUsageEvents(events: UsageEventInput[]): number;
+export declare function recordUsageEvent(event: UsageEventInput): void;
+export declare function resolvePeriodFilters(period: UsagePeriod | string | undefined, from?: string, to?: string): UsageFilters;
+export type UsageOverview = {
+    period: {
+        from: string;
+        to: string;
+    };
+    totals: {
+        events: number;
+        pageViews: number;
+        clicks: number;
+        sessions: number;
+        activeUsers: number;
+        activeHumans: number;
+        activeAi: number;
+        totalTimeMs: number;
+        avgSessionTimeMs: number;
+    };
+    byKind: Array<{
+        kind: string;
+        events: number;
+        users: number;
+        timeMs: number;
+    }>;
+};
+export declare function getUsageOverview(filters: UsageFilters): UsageOverview;
+export type TimelineBucket = {
+    bucket: string;
+    events: number;
+    pageViews: number;
+    clicks: number;
+    humans: number;
+    ai: number;
+    timeMs: number;
+};
+export declare function getUsageTimeline(filters: UsageFilters, period?: UsagePeriod): TimelineBucket[];
+export type PageStat = {
+    path: string;
+    views: number;
+    uniqueUsers: number;
+    avgTimeMs: number;
+    totalTimeMs: number;
+};
+export declare function getTopPages(filters: UsageFilters, limit?: number): PageStat[];
+export type ClickStat = {
+    label: string;
+    clicks: number;
+    uniqueUsers: number;
+    paths: number;
+};
+export declare function getTopClicks(filters: UsageFilters, limit?: number): ClickStat[];
+export type UserStat = {
+    userId: string;
+    username: string;
+    kind: string;
+    role: string | null;
+    events: number;
+    pageViews: number;
+    clicks: number;
+    sessions: number;
+    timeMs: number;
+    lastSeen: string | null;
+};
+export declare function getUserStats(filters: UsageFilters, limit?: number): UserStat[];
+export declare function listUsageEvents(filters: UsageFilters & {
+    limit?: number;
+    offset?: number;
+}): {
+    events: UsageEventRow[];
+    total: number;
+};
+export declare function purgeUsageEvents(opts?: {
+    before?: string;
+    all?: boolean;
+}): number;
+//# sourceMappingURL=usage-analytics.d.ts.map

package/dist/usage/usage-analytics.d.ts.map

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