@creezio/observability 0.22.0

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Contrats observabilité native (vision V2).
+ */
+export declare const OBSERVABILITY_EVENT_KINDS: readonly ["activity", "plugin_usage", "control_plane"];
+export type ObservabilityEventKind = (typeof OBSERVABILITY_EVENT_KINDS)[number];
+export type ActivityAction = "login" | "logout" | "navigate" | "factory.intention" | "factory.materialize" | "factory.iterate" | "api.call" | "mcp.tool" | "custom";
+export type ControlPlaneAction = "install" | "uninstall" | "enable" | "disable" | "grant" | "write_files" | "restart" | "list";
+export type ObservabilityEvent = {
+    id: string;
+    kind: ObservabilityEventKind;
+    /** Action métier (activity / control_plane) ou outil (plugin_usage). */
+    action: string;
+    orgId: string | null;
+    userId: string | null;
+    brandId: string | null;
+    pluginId: string | null;
+    /** Payload JSON sérialisable. */
+    meta: Record<string, unknown>;
+    createdAt: string;
+};
+export type RecordObservabilityEventInput = {
+    kind: ObservabilityEventKind;
+    action: string;
+    orgId?: string | null;
+    userId?: string | null;
+    brandId?: string | null;
+    pluginId?: string | null;
+    meta?: Record<string, unknown>;
+    /** Override id / createdAt (tests). */
+    id?: string;
+    createdAt?: string;
+};
+export type ObservabilityQuery = {
+    kind?: ObservabilityEventKind;
+    orgId?: string;
+    pluginId?: string;
+    action?: string;
+    since?: string;
+    until?: string;
+    limit?: number;
+};
+export type PluginUsageAggregate = {
+    pluginId: string;
+    orgId: string | null;
+    count: number;
+    lastAt: string;
+};
+export type OrgActivityAggregate = {
+    orgId: string;
+    count: number;
+    lastAt: string;
+};
+export type ObservabilityStore = {
+    record(input: RecordObservabilityEventInput): ObservabilityEvent;
+    list(query?: ObservabilityQuery): ObservabilityEvent[];
+    aggregatePluginUsage(opts?: {
+        orgId?: string;
+        since?: string;
+        limit?: number;
+    }): PluginUsageAggregate[];
+    aggregateOrgActivity(opts?: {
+        since?: string;
+        limit?: number;
+    }): OrgActivityAggregate[];
+    count(query?: ObservabilityQuery): number;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,yBAAyB,wDAI5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,QAAQ,GACR,UAAU,GACV,mBAAmB,GACnB,qBAAqB,GACrB,iBAAiB,GACjB,UAAU,GACV,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,MAAM,kBAAkB,GAC1B,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,OAAO,GACP,aAAa,GACb,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,sBAAsB,CAAC;IAC7B,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,KAAK,EAAE,6BAA6B,GAAG,kBAAkB,CAAC;IACjE,IAAI,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IACvD,oBAAoB,CAAC,IAAI,CAAC,EAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,oBAAoB,EAAE,CAAC;IAC3B,oBAAoB,CAAC,IAAI,CAAC,EAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,oBAAoB,EAAE,CAAC;IAC3B,KAAK,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAAC;CAC3C,CAAC"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Contrats observabilité native (vision V2).
+ */
+export const OBSERVABILITY_EVENT_KINDS = [
+    "activity",
+    "plugin_usage",
+    "control_plane",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,UAAU;IACV,cAAc;IACd,eAAe;CACP,CAAC"}

package/dist/usage/adapters.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Injection host pour usage-analytics (évite imports `@/` marque).
+ */
+export type UsageAnalyticsSqliteStatement = {
+    run(...params: unknown[]): {
+        changes: number;
+        lastInsertRowid?: number | bigint;
+    };
+    get(...params: unknown[]): unknown;
+    all(...params: unknown[]): unknown[];
+};
+export type UsageAnalyticsSqliteDatabase = {
+    exec(sql: string): unknown;
+    prepare(sql: string): UsageAnalyticsSqliteStatement;
+    transaction?: <TArgs extends unknown[], TResult>(fn: (...args: TArgs) => TResult) => (...args: TArgs) => TResult;
+};
+export type UsageAnalyticsAdapters = {
+    getWriteDb: () => UsageAnalyticsSqliteDatabase;
+    /** Lecture (défaut = getWriteDb). */
+    getDb?: () => UsageAnalyticsSqliteDatabase;
+    tableExists?: (name: string) => boolean;
+};
+export declare function configureUsageAnalytics(next: UsageAnalyticsAdapters): void;
+export declare function getUsageAnalyticsAdapters(): UsageAnalyticsAdapters;
+export declare function resetUsageAnalyticsAdaptersForTests(): void;
+export declare function uaGetWriteDb(): UsageAnalyticsSqliteDatabase;
+export declare function uaGetDb(): UsageAnalyticsSqliteDatabase;
+export declare function uaQueryAll<T = Record<string, unknown>>(sql: string, params?: unknown[]): T[];
+export declare function uaQueryOne<T = Record<string, unknown>>(sql: string, params?: unknown[]): T | undefined;
+export declare function uaTableExists(name: string): boolean;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/usage/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/usage/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAClF,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,6BAA6B,CAAC;IACpD,WAAW,CAAC,EAAE,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC;CAClH,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,MAAM,4BAA4B,CAAC;IAC/C,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,4BAA4B,CAAC;IAC3C,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CACzC,CAAC;AAIF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,sBAAsB,GAAG,IAAI,CAE1E;AAED,wBAAgB,yBAAyB,IAAI,sBAAsB,CAOlE;AAED,wBAAgB,mCAAmC,IAAI,IAAI,CAE1D;AAED,wBAAgB,YAAY,IAAI,4BAA4B,CAE3D;AAED,wBAAgB,OAAO,IAAI,4BAA4B,CAGtD;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,CAAC,EAAE,CAEL;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,OAAO,EAAO,GACrB,CAAC,GAAG,SAAS,CAEf;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQnD"}

package/dist/usage/adapters.js

@@ -0,0 +1,37 @@
+/**
+ * Injection host pour usage-analytics (évite imports `@/` marque).
+ */
+let adapters = null;
+export function configureUsageAnalytics(next) {
+    adapters = next;
+}
+export function getUsageAnalyticsAdapters() {
+    if (!adapters) {
+        throw new Error("@creezio/observability usage: configureUsageAnalytics({ getWriteDb }) requis");
+    }
+    return adapters;
+}
+export function resetUsageAnalyticsAdaptersForTests() {
+    adapters = null;
+}
+export function uaGetWriteDb() {
+    return getUsageAnalyticsAdapters().getWriteDb();
+}
+export function uaGetDb() {
+    const a = getUsageAnalyticsAdapters();
+    return a.getDb ? a.getDb() : a.getWriteDb();
+}
+export function uaQueryAll(sql, params = []) {
+    return uaGetDb().prepare(sql).all(...params);
+}
+export function uaQueryOne(sql, params = []) {
+    return uaGetDb().prepare(sql).get(...params);
+}
+export function uaTableExists(name) {
+    const custom = getUsageAnalyticsAdapters().tableExists;
+    if (custom)
+        return custom(name);
+    const row = uaQueryOne(`SELECT COUNT(*) AS c FROM sqlite_master WHERE type='table' AND name=?`, [name]);
+    return (row?.c ?? 0) > 0;
+}
+//# sourceMappingURL=adapters.js.map

package/dist/usage/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/usage/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH,IAAI,QAAQ,GAAkC,IAAI,CAAC;AAEnD,MAAM,UAAU,uBAAuB,CAAC,IAA4B;IAClE,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB;IACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,yBAAyB,EAAE,CAAC,UAAU,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,MAAM,CAAC,GAAG,yBAAyB,EAAE,CAAC;IACtC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,SAAoB,EAAE;IAEtB,OAAO,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAQ,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,GAAW,EACX,SAAoB,EAAE;IAEtB,OAAO,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAkB,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC,WAAW,CAAC;IACvD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,UAAU,CACpB,uEAAuE,EACvE,CAAC,IAAI,CAAC,CACP,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/usage/http-routes.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Routes Hono usage analytics — ingest + admin (port TempoFlow — N6).
+ * Auth owner pour admin reste côté marque (montage).
+ */
+import { Hono } from "hono";
+import type { UsageUserKind } from "./usage-analytics-shared.js";
+export type UsageAnalyticsSession = {
+    sub: string;
+    email?: string | null;
+    role?: string | null;
+};
+export type UsageAnalyticsRouteDeps = {
+    getSession: (c: {
+        get: (k: string) => unknown;
+        req: {
+            header: (n: string) => string | undefined;
+        };
+    }) => Promise<UsageAnalyticsSession | null> | UsageAnalyticsSession | null;
+    getUserKind: (userId: string) => UsageUserKind | string | null | undefined;
+};
+export declare function createUsageAnalyticsIngestRoutes(deps: UsageAnalyticsRouteDeps): Hono;
+export declare function createUsageAnalyticsAdminRoutes(): Hono;
+//# sourceMappingURL=http-routes.d.ts.map

package/dist/usage/http-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-routes.d.ts","sourceRoot":"","sources":["../../src/usage/http-routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAc5B,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAE9E,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,CAAC,CAAC,EAAE;QACd,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;QAC5B,GAAG,EAAE;YAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;SAAE,CAAC;KACpD,KAAK,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,qBAAqB,GAAG,IAAI,CAAC;IAC3E,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CAC5E,CAAC;AAmBF,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,uBAAuB,GAC5B,IAAI,CAmDN;AA6BD,wBAAgB,+BAA+B,IAAI,IAAI,CAkFtD"}

package/dist/usage/http-routes.js

@@ -0,0 +1,150 @@
+/**
+ * Routes Hono usage analytics — ingest + admin (port TempoFlow — N6).
+ * Auth owner pour admin reste côté marque (montage).
+ */
+import { Hono } from "hono";
+import { getTopClicks, getTopPages, getUsageOverview, getUsageTimeline, getUserStats, insertUsageEvents, listUsageEvents, purgeUsageEvents, resolvePeriodFilters, } from "./usage-analytics.js";
+import { getProductivityReport } from "./usage-analytics-productivity.js";
+export function createUsageAnalyticsIngestRoutes(deps) {
+    const app = new Hono();
+    app.post("/events", async (c) => {
+        const session = await deps.getSession(c);
+        if (!session)
+            return c.json({ error: "Non authentifié" }, 401);
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ error: "JSON attendu" }, 400);
+        }
+        const raw = Array.isArray(body.events) ? body.events : [];
+        if (!raw.length)
+            return c.json({ ok: true, inserted: 0 });
+        if (raw.length > 100)
+            return c.json({ error: "Max 100 événements par batch" }, 400);
+        const userKind = (deps.getUserKind(session.sub) || "human");
+        const ua = c.req.header("user-agent") || null;
+        const events = raw.map((e) => ({
+            eventType: e.eventType || e.type || e.name || "event",
+            category: e.category || "ui",
+            label: e.label,
+            path: e.path,
+            referrerPath: e.referrerPath,
+            userId: session.sub,
+            username: session.email,
+            userKind,
+            userRole: session.role,
+            sessionId: e.sessionId,
+            durationMs: e.durationMs,
+            meta: e.meta || null,
+            userAgent: ua,
+            surface: e.surface || "crm",
+            createdAt: e.createdAt,
+        }));
+        try {
+            const inserted = insertUsageEvents(events);
+            return c.json({ ok: true, inserted });
+        }
+        catch (err) {
+            return c.json({ error: err instanceof Error ? err.message : "Échec insertion" }, 500);
+        }
+    });
+    return app;
+}
+function parseAdminFilters(c) {
+    const periodRaw = (c.req.query("period") || "week").toLowerCase();
+    const period = (["day", "week", "month", "year"].includes(periodRaw) ? periodRaw : "week");
+    const bounds = resolvePeriodFilters(period, c.req.query("from"), c.req.query("to"));
+    const kindRaw = (c.req.query("kind") || "all").toLowerCase();
+    const kind = (["human", "ai", "system", "unknown", "all"].includes(kindRaw)
+        ? kindRaw
+        : "all");
+    return {
+        period,
+        filters: {
+            ...bounds,
+            userId: c.req.query("userId") || undefined,
+            kind,
+            eventType: c.req.query("eventType") || undefined,
+            path: c.req.query("path") || undefined,
+            q: c.req.query("q") || undefined,
+        },
+    };
+}
+export function createUsageAnalyticsAdminRoutes() {
+    const app = new Hono();
+    app.get("/analytics/overview", (c) => {
+        const { period, filters } = parseAdminFilters(c);
+        return c.json({ periodKey: period, ...getUsageOverview(filters) });
+    });
+    app.get("/analytics/timeline", (c) => {
+        const { period, filters } = parseAdminFilters(c);
+        return c.json({
+            periodKey: period,
+            period: { from: filters.from || "", to: filters.to || "" },
+            points: getUsageTimeline(filters, period),
+        });
+    });
+    app.get("/analytics/pages", (c) => {
+        const { period, filters } = parseAdminFilters(c);
+        const limit = Number(c.req.query("limit")) || 25;
+        return c.json({
+            periodKey: period,
+            period: { from: filters.from || "", to: filters.to || "" },
+            pages: getTopPages(filters, limit),
+        });
+    });
+    app.get("/analytics/clicks", (c) => {
+        const { period, filters } = parseAdminFilters(c);
+        const limit = Number(c.req.query("limit")) || 25;
+        return c.json({
+            periodKey: period,
+            period: { from: filters.from || "", to: filters.to || "" },
+            clicks: getTopClicks(filters, limit),
+        });
+    });
+    app.get("/analytics/users", (c) => {
+        const { period, filters } = parseAdminFilters(c);
+        const limit = Number(c.req.query("limit")) || 50;
+        return c.json({
+            periodKey: period,
+            period: { from: filters.from || "", to: filters.to || "" },
+            users: getUserStats(filters, limit),
+        });
+    });
+    app.get("/analytics/events", (c) => {
+        const { period, filters } = parseAdminFilters(c);
+        const limit = Number(c.req.query("limit")) || 100;
+        const offset = Number(c.req.query("offset")) || 0;
+        const result = listUsageEvents({ ...filters, limit, offset });
+        return c.json({
+            periodKey: period,
+            period: { from: filters.from || "", to: filters.to || "" },
+            ...result,
+        });
+    });
+    app.get("/analytics/productivity", (c) => {
+        const { period, filters } = parseAdminFilters(c);
+        return c.json({
+            periodKey: period,
+            ...getProductivityReport(filters),
+        });
+    });
+    app.delete("/analytics/events", async (c) => {
+        let body = {};
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            body = {};
+        }
+        if (!body.all && !body.before) {
+            return c.json({ error: "Précisez all=true ou before=ISO" }, 400);
+        }
+        const cleared = purgeUsageEvents(body);
+        return c.json({ ok: true, cleared });
+    });
+    return app;
+}
+//# sourceMappingURL=http-routes.js.map

package/dist/usage/http-routes.js.map

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

package/dist/usage/index.d.ts

@@ -0,0 +1,11 @@
+export { configureUsageAnalytics, getUsageAnalyticsAdapters, resetUsageAnalyticsAdaptersForTests, type UsageAnalyticsAdapters, type UsageAnalyticsSqliteDatabase, type UsageAnalyticsSqliteStatement, } from "./adapters.js";
+export { configureUsageAnalyticsUiBrand, getUsageAnalyticsUiBrand, resetUsageAnalyticsUiBrandForTests, type FleetActionPayload, type UsageAnalyticsUiBrand, } from "./ui-brand.js";
+export type { UsagePeriod, UsageUserKind } from "./usage-analytics-shared.js";
+export { formatDuration } from "./usage-analytics-shared.js";
+export type { UsageEventInput, UsageEventRow, UsageFilters, UsageOverview, TimelineBucket, PageStat, ClickStat, UserStat, } from "./usage-analytics.js";
+export { usageAnalyticsReady, ensureUsageAnalyticsSchema, insertUsageEvents, recordUsageEvent, resolvePeriodFilters, getUsageOverview, getUsageTimeline, getTopPages, getTopClicks, getUserStats, listUsageEvents, purgeUsageEvents, } from "./usage-analytics.js";
+export type { HeatmapCell, DailyProductivity, BreakSpan, FocusBlock, ProductivitySummary, ProductivityReport, } from "./usage-analytics-productivity.js";
+export { BREAK_MIN_MS, BREAK_MAX_MS, getProductivityReport, } from "./usage-analytics-productivity.js";
+export type { UsageAnalyticsSession, UsageAnalyticsRouteDeps, } from "./http-routes.js";
+export { createUsageAnalyticsIngestRoutes, createUsageAnalyticsAdminRoutes, } from "./http-routes.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/usage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,mCAAmC,EACnC,KAAK,sBAAsB,EAC3B,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,GACnC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,kCAAkC,EAClC,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,YAAY,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAG3C,YAAY,EACV,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,kBAAkB,CAAC"}

package/dist/usage/index.js

@@ -0,0 +1,7 @@
+export { configureUsageAnalytics, getUsageAnalyticsAdapters, resetUsageAnalyticsAdaptersForTests, } from "./adapters.js";
+export { configureUsageAnalyticsUiBrand, getUsageAnalyticsUiBrand, resetUsageAnalyticsUiBrandForTests, } from "./ui-brand.js";
+export { formatDuration } from "./usage-analytics-shared.js";
+export { usageAnalyticsReady, ensureUsageAnalyticsSchema, insertUsageEvents, recordUsageEvent, resolvePeriodFilters, getUsageOverview, getUsageTimeline, getTopPages, getTopClicks, getUserStats, listUsageEvents, purgeUsageEvents, } from "./usage-analytics.js";
+export { BREAK_MIN_MS, BREAK_MAX_MS, getProductivityReport, } from "./usage-analytics-productivity.js";
+export { createUsageAnalyticsIngestRoutes, createUsageAnalyticsAdminRoutes, } from "./http-routes.js";
+//# sourceMappingURL=index.js.map

package/dist/usage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/usage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,mCAAmC,GAIpC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,kCAAkC,GAGnC,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAY7D,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,qBAAqB,GACtB,MAAM,mCAAmC,CAAC;AAO3C,OAAO,EACL,gCAAgC,EAChC,+BAA+B,GAChC,MAAM,kBAAkB,CAAC"}

package/dist/usage/ui-brand.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Tokens UI / tracker usage (marque).
+ */
+export type FleetActionPayload = {
+    type: string;
+    label: string;
+    path?: string;
+    userId?: string;
+    username?: string;
+    meta?: Record<string, unknown>;
+};
+export type UsageAnalyticsUiBrand = {
+    /** Attribut data-* pour labels clics (défaut data-creezio-aid). */
+    aidAttr: string;
+    /** Classe titlebar à ignorer pour les clics. */
+    titlebarNoDragClass: string;
+    /** Miroir télémétrie flotte (optionnel). */
+    mirrorFleetAction?: (payload: FleetActionPayload) => void;
+};
+export declare function configureUsageAnalyticsUiBrand(next: Partial<UsageAnalyticsUiBrand>): void;
+export declare function getUsageAnalyticsUiBrand(): UsageAnalyticsUiBrand;
+export declare function resetUsageAnalyticsUiBrandForTests(): void;
+//# sourceMappingURL=ui-brand.d.ts.map

package/dist/usage/ui-brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-brand.d.ts","sourceRoot":"","sources":["../../src/usage/ui-brand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC3D,CAAC;AASF,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACnC,IAAI,CAEN;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,CAEhE;AAED,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}

package/dist/usage/ui-brand.js

@@ -0,0 +1,18 @@
+/**
+ * Tokens UI / tracker usage (marque).
+ */
+const DEFAULT = {
+    aidAttr: "data-creezio-aid",
+    titlebarNoDragClass: "creezio-titlebar-no-drag",
+};
+let brand = { ...DEFAULT };
+export function configureUsageAnalyticsUiBrand(next) {
+    brand = { ...brand, ...next };
+}
+export function getUsageAnalyticsUiBrand() {
+    return brand;
+}
+export function resetUsageAnalyticsUiBrandForTests() {
+    brand = { ...DEFAULT };
+}
+//# sourceMappingURL=ui-brand.js.map

package/dist/usage/ui-brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-brand.js","sourceRoot":"","sources":["../../src/usage/ui-brand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAoBH,MAAM,OAAO,GAA0B;IACrC,OAAO,EAAE,kBAAkB;IAC3B,mBAAmB,EAAE,0BAA0B;CAChD,CAAC;AAEF,IAAI,KAAK,GAA0B,EAAE,GAAG,OAAO,EAAE,CAAC;AAElD,MAAM,UAAU,8BAA8B,CAC5C,IAAoC;IAEpC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kCAAkC;IAChD,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,73 @@
+import { type UsageFilters } from "./usage-analytics.js";
+/** Seuil pause courte (gap activité). */
+export declare const BREAK_MIN_MS: number;
+/** Au-delà → coupure de journée / session, pas une pause. */
+export declare const BREAK_MAX_MS: number;
+export type HeatmapCell = {
+    weekday: number;
+    hour: number;
+    events: number;
+    activeMs: number;
+};
+export type DailyProductivity = {
+    date: string;
+    activeMs: number;
+    idleMs: number;
+    breakMs: number;
+    breaksCount: number;
+    events: number;
+    clicks: number;
+    pageViews: number;
+    heartbeats: number;
+    firstSeen: string | null;
+    lastSeen: string | null;
+    productivityScore: number;
+};
+export type BreakSpan = {
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    day: string;
+};
+export type FocusBlock = {
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    events: number;
+};
+export type ProductivitySummary = {
+    userId: string;
+    username: string;
+    kind: string;
+    activeMs: number;
+    idleMs: number;
+    breakMs: number;
+    avgActivePerDayMs: number;
+    avgBreakMs: number;
+    breaksCount: number;
+    focusBlocksCount: number;
+    avgFocusBlockMs: number;
+    peakHour: number | null;
+    peakWeekday: number | null;
+    eventsPerActiveHour: number;
+    focusRatio: number;
+    productivityScore: number;
+    daysActive: number;
+    events: number;
+    clicks: number;
+    pageViews: number;
+};
+export type ProductivityReport = {
+    period: {
+        from: string;
+        to: string;
+    };
+    summary: ProductivitySummary | null;
+    heatmap: HeatmapCell[];
+    daily: DailyProductivity[];
+    breaks: BreakSpan[];
+    focusBlocks: FocusBlock[];
+    leaderboard: ProductivitySummary[];
+};
+export declare function getProductivityReport(filters: UsageFilters): ProductivityReport;
+//# sourceMappingURL=usage-analytics-productivity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usage-analytics-productivity.d.ts","sourceRoot":"","sources":["../../src/usage/usage-analytics-productivity.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAE9B,yCAAyC;AACzC,eAAO,MAAM,YAAY,QAAa,CAAC;AACvC,6DAA6D;AAC7D,eAAO,MAAM,YAAY,QAAkB,CAAC;AAa5C,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACpC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACpC,CAAC;AAgTF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,GAAG,kBAAkB,CA0D/E"}