luchy 1.0.1 → 1.2.0

package/dist/api/schema.d.ts

@@ -185,65 +185,42 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/analytics/query": {
+    "/health": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
-        put?: never;
-        /** @description Metrics for the key's project. */
-        post: {
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
                 path?: never;
                 cookie?: never;
             };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["AnalyticsQueryRequest"];
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Query result */
+                /** @description Health check endpoint */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["AnalyticsQueryResponse"];
-                    };
-                };
-                /** @description Invalid request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ValidationErrorResponse"];
-                    };
-                };
-                /** @description Internal server error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ServerErrorResponse"];
+                        "application/json": components["schemas"]["HealthResponse"];
                     };
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/analytics/sql": {
+    "/analytics.query": {
         parameters: {
             query?: never;
             header?: never;
@@ -252,120 +229,199 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** @description Read-only SQL over the whole database — not scoped to the key’s project. Luchy is single-owner, so any valid query key may use it; filter on project_id yourself. */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: {
-                content: {
-                    "application/json": components["schemas"]["SqlRequest"];
-                };
-            };
-            responses: {
-                /** @description Rows */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["SqlResponse"];
-                    };
-                };
-                /** @description Invalid request */
-                400: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ValidationErrorResponse"];
-                    };
-                };
-                /** @description Internal server error */
-                500: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["ServerErrorResponse"];
-                    };
-                };
-            };
+        /**
+         * Metrics for the project over a time range: totals, an optional breakdown, time series and a comparison with another period.
+         * @description Every requested metric is computed. visitors = distinct coalesce(user, visitor_hash); users = distinct identified users; avg_duration in seconds; bounce_rate in %.
+         *
+         *     Add `granularity` for a zero-filled time series and `compare: "previous_period"` to also get the period before with deltas; the result renders as a chart.
+         *
+         *     Example — who used the app this week vs last: `{ metrics: ["users", "events"], granularity: "day", compare: "previous_period" }`.
+         *
+         *     Anything this cannot express goes through `analytics.sql`.
+         *
+         *     Requires the `analytics:read` permission.
+         */
+        post: operations["analytics.query"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/analytics.sql": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
         };
+        get?: never;
+        put?: never;
+        /**
+         * Run one read-only SELECT or WITH statement over the analytics database, for anything `analytics.query` cannot express.
+         * @description Not scoped to a project: filter on `project_id = ?` and pass the current project's id (MCP: it's in the server instructions) in `params`. Rows are capped by `limit`.
+         *
+         *     Luchy analytics database (SQLite / Cloudflare D1). Read-only: one SELECT or WITH statement.
+         *     Timestamps are ISO-8601 UTC strings ('2025-01-31T12:00:00.000Z'); compare them as strings or use datetime()/strftime().
+         *     Not scoped to a project: filter on project_id.
+         *
+         *     projects — one tracked site/app
+         *       id TEXT PK, name TEXT, created_at TEXT
+         *
+         *     sessions — one visit by one (user, actor) or one anonymous visitor; 30 min idle timeout, 24 h cap
+         *       id TEXT PK, project_id TEXT -> projects.id
+         *       visitor_hash TEXT   anonymous browser id (sha256 of a daily salt, project, ip, user agent); rotates daily
+         *       user TEXT           app-provided user id (signed identity), NULL when anonymous
+         *       actor TEXT          the real person when impersonating (user = who is viewed as), else NULL
+         *       started_at TEXT, last_seen_at TEXT   duration = (julianday(last_seen_at) - julianday(started_at)) * 86400 seconds
+         *       browser TEXT, os TEXT, device TEXT ('desktop' | 'mobile' | 'tablet' | ...), country TEXT (ISO 3166-1 alpha-2), language TEXT
+         *       entry_page TEXT     pathname of the first event
+         *
+         *     events — everything that happened, pageviews included
+         *       id TEXT PK, project_id TEXT -> projects.id, session_id TEXT -> sessions.id
+         *       type TEXT           'pageview' for pageviews; otherwise sender-defined ('server', 'click', ...) or NULL
+         *       name TEXT           'pageview' for pageviews; event name otherwise ('__pageleave' marks a page exit)
+         *       pathname TEXT, referrer TEXT
+         *       tenant TEXT         the consumer's client/workspace from the signed identity
+         *       payload TEXT        JSON object of props: json_extract(payload, '$.role')
+         *       created_at TEXT
+         *
+         *     people — person profiles sent via identify; one row per (project, user)
+         *       project_id TEXT -> projects.id, user TEXT (same id as sessions.user)
+         *       traits TEXT         JSON object (name, email, ...): json_extract(traits, '$.email')
+         *       created_at TEXT, updated_at TEXT
+         *
+         *     Conventions
+         *       visitors = COUNT(DISTINCT coalesce(s.user, s.visitor_hash)); users = COUNT(DISTINCT s.user)
+         *       Join: FROM events e JOIN sessions s ON s.id = e.session_id
+         *       Profiles: LEFT JOIN people p ON p.project_id = s.project_id AND p.user = s.user
+         *       Alias duplicate column names: rows are objects keyed by column name.
+         *
+         *     Requires the `analytics:read` permission.
+         */
+        post: operations["analytics.sql"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/analytics/schema": {
+    "/analytics.people": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** @description Tables, columns and conventions for writing /analytics/sql queries. */
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Schema documentation */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["AnalyticsSchemaResponse"];
-                    };
-                };
-            };
+        get?: never;
+        put?: never;
+        /**
+         * Identified people active in the period or the one before, with sessions and actions this period vs the previous one. Quiet people (active before, not now) come last.
+         * @description Requires the `analytics:read` permission.
+         */
+        post: operations["analytics.people"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/analytics.customers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
         };
+        get?: never;
         put?: never;
-        post?: never;
+        /**
+         * Customers (the `tenant` of events) active in the period or the one before: people and actions this period vs the previous one.
+         * @description Requires the `analytics:read` permission.
+         */
+        post: operations["analytics.customers"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/health": {
+    "/analytics.person": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody?: never;
-            responses: {
-                /** @description Health check endpoint */
-                200: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": components["schemas"]["HealthResponse"];
-                    };
-                };
-            };
+        get?: never;
+        put?: never;
+        /**
+         * One person, all time: profile traits, customers, who acted as them, and their latest sessions with what they did.
+         * @description Requires the `analytics:read` permission.
+         */
+        post: operations["analytics.person"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/analytics.live": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
         };
+        get?: never;
         put?: never;
-        post?: never;
+        /**
+         * Who is on the site right now: open sessions with their current page, top pages, countries and referrers.
+         * @description Requires the `analytics:read` permission.
+         */
+        post: operations["analytics.live"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/admin.projects": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * List every project (tracked site or app) with its id. Use the id as ?project=<id> on /mcp or /api to switch project.
+         * @description Requires the `admin` permission.
+         */
+        post: operations["admin.projects"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/admin.keys": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * The current project's ingest keys (public, for the browser script) and its secret key (signs identities, authenticates identify).
+         * @description Query keys (`wak_…`) live in the willy.im IdP and are managed from the dashboard; they are not listed here.
+         *
+         *     Requires the `admin` permission.
+         */
+        post: operations["admin.keys"];
         delete?: never;
         options?: never;
         head?: never;
@@ -568,158 +624,8 @@ export interface components {
              *     }
              */
             traits: {
-                [key: string]: string | number | boolean | unknown | unknown;
-            };
-        };
-        AnalyticsPeriod: {
-            from: string;
-            to: string;
-            totals: {
-                events?: number;
-                pageviews?: number;
-                sessions?: number;
-                visitors?: number;
-                users?: number;
-                avg_duration?: number;
-                bounce_rate?: number;
-            };
-            rows?: {
-                events?: number;
-                pageviews?: number;
-                sessions?: number;
-                visitors?: number;
-                users?: number;
-                avg_duration?: number;
-                bounce_rate?: number;
-                key: string | number | unknown;
-            }[];
-            series?: {
-                events?: number;
-                pageviews?: number;
-                sessions?: number;
-                visitors?: number;
-                users?: number;
-                avg_duration?: number;
-                bounce_rate?: number;
-                bucket: string;
-            }[];
-        };
-        AnalyticsQueryResponse: {
-            current: components["schemas"]["AnalyticsPeriod"];
-            previous?: components["schemas"]["AnalyticsPeriod"];
-            delta?: {
-                events?: {
-                    abs: number;
-                    /** @description null when previous is 0 */
-                    pct: number | null;
-                };
-                pageviews?: {
-                    abs: number;
-                    /** @description null when previous is 0 */
-                    pct: number | null;
-                };
-                sessions?: {
-                    abs: number;
-                    /** @description null when previous is 0 */
-                    pct: number | null;
-                };
-                visitors?: {
-                    abs: number;
-                    /** @description null when previous is 0 */
-                    pct: number | null;
-                };
-                users?: {
-                    abs: number;
-                    /** @description null when previous is 0 */
-                    pct: number | null;
-                };
-                avg_duration?: {
-                    abs: number;
-                    /** @description null when previous is 0 */
-                    pct: number | null;
-                };
-                bounce_rate?: {
-                    abs: number;
-                    /** @description null when previous is 0 */
-                    pct: number | null;
-                };
-            };
-        };
-        AnalyticsQueryRequest: {
-            /**
-             * @description Inclusive start (ISO 8601)
-             * @example 2025-01-01T00:00:00Z
-             */
-            from: string;
-            /**
-             * @description Exclusive end (ISO 8601)
-             * @example 2025-02-01T00:00:00Z
-             */
-            to: string;
-            /**
-             * @description IANA timezone for buckets, hour and weekday. Default UTC.
-             * @example America/Santo_Domingo
-             */
-            tz?: string;
-            /**
-             * @description Every metric is computed. visitors = distinct coalesce(user, visitor_hash); avg_duration in seconds; bounce_rate in %.
-             * @example [
-             *       "pageviews",
-             *       "visitors"
-             *     ]
-             */
-            metrics: ("events" | "pageviews" | "sessions" | "visitors" | "users" | "avg_duration" | "bounce_rate")[];
-            /**
-             * @description A fixed field or `props.<key>` (a key of the event payload). `hour` and `weekday` (0 = Sunday) are in `tz`.
-             * @example tenant
-             */
-            breakdown?: ("page" | "event" | "type" | "source" | "referrer" | "country" | "device" | "browser" | "os" | "tenant" | "user" | "actor" | "hour" | "weekday") | string;
-            /**
-             * @description [field, op, value]; `in` takes a list.
-             * @example [
-             *       [
-             *         "props.role",
-             *         "eq",
-             *         "admin"
-             *       ]
-             *     ]
-             */
-            filters?: ((("page" | "event" | "type" | "source" | "referrer" | "country" | "device" | "browser" | "os" | "tenant" | "user" | "actor" | "hour" | "weekday") | string) | ("eq" | "neq" | "in") | (string | number | boolean | unknown | (string | number | boolean | unknown | unknown)[] | unknown))[][];
-            /**
-             * @description Adds a zero-filled time series
-             * @enum {string}
-             */
-            granularity?: "hour" | "day" | "week" | "month";
-            /** @description Also runs the query on another range and returns deltas */
-            compare?: "previous_period" | {
-                /** @example 2025-01-01T00:00:00Z */
-                from: string;
-                /** @example 2025-02-01T00:00:00Z */
-                to: string;
+                [key: string]: string | number | boolean | null;
             };
-            /** @description Max breakdown rows (default 100) */
-            limit?: number;
-        };
-        SqlResponse: {
-            columns: string[];
-            rows: {
-                [key: string]: unknown;
-            }[];
-            truncated: boolean;
-        };
-        SqlRequest: {
-            /**
-             * @description One SELECT or WITH statement. See GET /analytics/schema.
-             * @example SELECT tenant, COUNT(*) AS actions FROM events WHERE project_id = ? GROUP BY tenant
-             */
-            query: string;
-            /** @description Bound to `?` placeholders in order */
-            params?: (string | number | boolean | unknown | unknown)[];
-            /** @description Max rows (default 1000) */
-            limit?: number;
-        };
-        AnalyticsSchemaResponse: {
-            doc: string;
         };
         /** @description Health check response */
         HealthResponse: {
@@ -734,12 +640,586 @@ export interface components {
              */
             timestamp: string;
         };
+        Error: {
+            error: string;
+        };
+        InvalidInput: {
+            error: string;
+            fields: {
+                [key: string]: string[];
+            };
+        };
+    };
+    responses: {
+        /** @description The input doesn't match the method's schema. `fields` maps each field to its errors. */
+        InvalidInput: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["InvalidInput"];
+            };
+        };
+        /** @description No credentials, or invalid or expired ones. */
+        Unauthorized: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description The caller lacks the permission. */
+        Forbidden: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description No such record. */
+        NotFound: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
+        /** @description The record's state doesn't allow this. */
+        Conflict: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Error"];
+            };
+        };
     };
-    responses: never;
     parameters: never;
     requestBodies: never;
     headers: never;
     pathItems: never;
 }
 export type $defs = Record<string, never>;
-export type operations = Record<string, never>;
+export interface operations {
+    "analytics.query": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description Inclusive start (ISO 8601). Default: 7 days before `to`. */
+                    from?: string;
+                    /** @description Exclusive end (ISO 8601). Default: now. */
+                    to?: string;
+                    /** @description IANA timezone for buckets, hour and weekday. Default UTC. */
+                    tz?: string;
+                    /** @description e.g. ["pageviews", "visitors"] */
+                    metrics: ("events" | "pageviews" | "sessions" | "visitors" | "users" | "avg_duration" | "bounce_rate")[];
+                    /** @description A fixed field or `props.<key>` (a key of the event payload). `hour` and `weekday` (0 = Sunday) are in `tz`. */
+                    breakdown?: ("page" | "event" | "type" | "source" | "referrer" | "country" | "device" | "browser" | "os" | "tenant" | "user" | "actor" | "hour" | "weekday") | string;
+                    /** @description [field, op, value]; `in` takes a list. e.g. [["props.role", "eq", "admin"]] */
+                    filters?: [
+                        ("page" | "event" | "type" | "source" | "referrer" | "country" | "device" | "browser" | "os" | "tenant" | "user" | "actor" | "hour" | "weekday") | string,
+                        "eq" | "neq" | "in",
+                        (string | number | boolean | null) | (string | number | boolean | null)[]
+                    ][];
+                    /**
+                     * @description Adds a zero-filled time series
+                     * @enum {string}
+                     */
+                    granularity?: "hour" | "day" | "week" | "month";
+                    /** @description Also runs the query on another range and returns deltas */
+                    compare?: "previous_period" | {
+                        from: string;
+                        to: string;
+                    };
+                    /** @description Max breakdown rows (default 100) */
+                    limit?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description The totals in one line, for reading aloud */
+                        summary: string;
+                        current: {
+                            from: string;
+                            to: string;
+                            totals: {
+                                events?: number;
+                                pageviews?: number;
+                                sessions?: number;
+                                visitors?: number;
+                                users?: number;
+                                avg_duration?: number;
+                                bounce_rate?: number;
+                            };
+                            rows?: {
+                                events?: number;
+                                pageviews?: number;
+                                sessions?: number;
+                                visitors?: number;
+                                users?: number;
+                                avg_duration?: number;
+                                bounce_rate?: number;
+                                key: (string | number) | null;
+                            }[];
+                            series?: {
+                                events?: number;
+                                pageviews?: number;
+                                sessions?: number;
+                                visitors?: number;
+                                users?: number;
+                                avg_duration?: number;
+                                bounce_rate?: number;
+                                bucket: string;
+                            }[];
+                        };
+                        previous?: {
+                            from: string;
+                            to: string;
+                            totals: {
+                                events?: number;
+                                pageviews?: number;
+                                sessions?: number;
+                                visitors?: number;
+                                users?: number;
+                                avg_duration?: number;
+                                bounce_rate?: number;
+                            };
+                            rows?: {
+                                events?: number;
+                                pageviews?: number;
+                                sessions?: number;
+                                visitors?: number;
+                                users?: number;
+                                avg_duration?: number;
+                                bounce_rate?: number;
+                                key: (string | number) | null;
+                            }[];
+                            series?: {
+                                events?: number;
+                                pageviews?: number;
+                                sessions?: number;
+                                visitors?: number;
+                                users?: number;
+                                avg_duration?: number;
+                                bounce_rate?: number;
+                                bucket: string;
+                            }[];
+                        };
+                        delta?: {
+                            events?: {
+                                abs: number;
+                                /** @description null when the previous value is 0 */
+                                pct: number | null;
+                            };
+                            pageviews?: {
+                                abs: number;
+                                /** @description null when the previous value is 0 */
+                                pct: number | null;
+                            };
+                            sessions?: {
+                                abs: number;
+                                /** @description null when the previous value is 0 */
+                                pct: number | null;
+                            };
+                            visitors?: {
+                                abs: number;
+                                /** @description null when the previous value is 0 */
+                                pct: number | null;
+                            };
+                            users?: {
+                                abs: number;
+                                /** @description null when the previous value is 0 */
+                                pct: number | null;
+                            };
+                            avg_duration?: {
+                                abs: number;
+                                /** @description null when the previous value is 0 */
+                                pct: number | null;
+                            };
+                            bounce_rate?: {
+                                abs: number;
+                                /** @description null when the previous value is 0 */
+                                pct: number | null;
+                            };
+                        };
+                    };
+                };
+            };
+            400: components["responses"]["InvalidInput"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    "analytics.sql": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description e.g. SELECT tenant, COUNT(*) AS actions FROM events WHERE project_id = ? GROUP BY tenant */
+                    query: string;
+                    /** @description Bound to `?` placeholders in order */
+                    params?: (string | number | boolean | null)[];
+                    /** @description Max rows (default 1000) */
+                    limit?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        columns: string[];
+                        rows: {
+                            [key: string]: unknown;
+                        }[];
+                        truncated: boolean;
+                    };
+                };
+            };
+            400: components["responses"]["InvalidInput"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    "analytics.people": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @description Inclusive start (ISO 8601). Default: 7 days before `to`. */
+                    from?: string;
+                    /** @description Exclusive end (ISO 8601). Default: now. */
+                    to?: string;
+                    /** @description IANA timezone for buckets, hour and weekday. Default UTC. */
+                    tz?: string;
+                    /** @description Only people acting for this customer */
+                    tenant?: string;
+                    limit?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        from: string;
+                        to: string;
+                        people: {
+                            user: string;
+                            name: string;
+                            email: string | null;
+                            tenant: string | null;
+                            lastSeen: string;
+                            sessions: number;
+                            actions: number;
+                            pageviews: number;
+                            helpedSessions: number;
+                            previousActions: number;
+                            quiet: boolean;
+                        }[];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidInput"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    "analytics.customers": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @description Inclusive start (ISO 8601). Default: 7 days before `to`. */
+                    from?: string;
+                    /** @description Exclusive end (ISO 8601). Default: now. */
+                    to?: string;
+                    /** @description IANA timezone for buckets, hour and weekday. Default UTC. */
+                    tz?: string;
+                    limit?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        from: string;
+                        to: string;
+                        customers: {
+                            tenant: string;
+                            people: number;
+                            previousPeople: number;
+                            actions: number;
+                            previousActions: number;
+                            helpedSessions: number;
+                            lastSeen: string;
+                            quiet: boolean;
+                        }[];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidInput"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    "analytics.person": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": {
+                    /** @description The app-provided user id */
+                    user: string;
+                    /** @description Latest sessions to include (default 30) */
+                    sessions?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        user: string;
+                        name: string;
+                        email: string | null;
+                        traits: {
+                            [key: string]: string | number | boolean;
+                        };
+                        firstSeen: string;
+                        lastSeen: string;
+                        sessions: number;
+                        actions: number;
+                        tenants: {
+                            tenant: string;
+                            actions: number;
+                        }[];
+                        actors: {
+                            id: string;
+                            name: string;
+                            email: string | null;
+                        }[];
+                        timeline: {
+                            id: string;
+                            startedAt: string;
+                            lastSeenAt: string | null;
+                            actor: {
+                                id: string;
+                                name: string;
+                                email: string | null;
+                            } | null;
+                            browser: string | null;
+                            os: string | null;
+                            device: string | null;
+                            country: string | null;
+                            events: {
+                                id: string;
+                                type: string | null;
+                                name: string;
+                                pathname: string;
+                                tenant: string | null;
+                                props: {
+                                    [key: string]: unknown;
+                                };
+                                createdAt: string;
+                            }[];
+                        }[];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidInput"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    "analytics.live": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    /** @description How recent a pageview counts as live (default 5) */
+                    windowMinutes?: number;
+                };
+            };
+        };
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        /** @description People on the site right now */
+                        count: number;
+                        sessions: {
+                            id: string;
+                            user: {
+                                id: string;
+                                name: string;
+                                email: string | null;
+                            } | null;
+                            actor: {
+                                id: string;
+                                name: string;
+                                email: string | null;
+                            } | null;
+                            country: string | null;
+                            browser: string | null;
+                            os: string | null;
+                            device: string | null;
+                            currentPage: string;
+                            referrer: string | null;
+                            startedAt: string;
+                        }[];
+                        pages: {
+                            count: number;
+                            pathname: string;
+                        }[];
+                        countries: {
+                            count: number;
+                            country: string;
+                        }[];
+                        referrers: {
+                            count: number;
+                            referrer: string;
+                        }[];
+                    };
+                };
+            };
+            400: components["responses"]["InvalidInput"];
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    "admin.projects": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        projects: {
+                            id: string;
+                            name: string;
+                            createdAt: string;
+                        }[];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+    "admin.keys": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        ingestKeys: {
+                            id: string;
+                            name: string | null;
+                            createdAt: string;
+                        }[];
+                        secretKey: string | null;
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            403: components["responses"]["Forbidden"];
+            404: components["responses"]["NotFound"];
+            409: components["responses"]["Conflict"];
+        };
+    };
+}