luchy 0.2.0 → 1.1.0

package/dist/api/schema.d.ts

@@ -118,7 +118,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/query": {
+    "/ingest/identify": {
         parameters: {
             query?: never;
             header?: never;
@@ -127,6 +127,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
+        /** @description Stores person profile traits. Requires the project's secret key (`lsk_…`) as the bearer token; the public ingest key is rejected. */
         post: {
             parameters: {
                 query?: never;
@@ -136,17 +137,17 @@ export interface paths {
             };
             requestBody?: {
                 content: {
-                    "application/json": components["schemas"]["QueryRequest"];
+                    "application/json": components["schemas"]["IdentifyInput"];
                 };
             };
             responses: {
-                /** @description Query executed successfully */
+                /** @description Profile stored */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["QueryResponse"];
+                        "application/json": components["schemas"]["IdentifyResponse"];
                     };
                 };
                 /** @description Invalid request body or validation error */
@@ -158,6 +159,15 @@ export interface paths {
                         "application/json": components["schemas"]["ValidationErrorResponse"];
                     };
                 };
+                /** @description Missing or invalid secret key */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
                 /** @description Internal server error */
                 500: {
                     headers: {
@@ -210,6 +220,214 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/analytics.query": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * 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.people": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        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;
+        /**
+         * 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;
+    };
+    "/analytics.person": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        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;
+        /**
+         * 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;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -275,6 +493,15 @@ export interface components {
              * @example https://google.com
              */
             referrer?: string;
+            /**
+             * @description Pageview properties
+             * @example {
+             *       "plan": "pro"
+             *     }
+             */
+            payload?: {
+                [key: string]: string | number | boolean;
+            };
             /**
              * @description The user agent string
              * @example Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36
@@ -286,10 +513,20 @@ export interface components {
              */
             language?: string;
             /**
-             * @description The user country code
+             * @description The user country code. Wins over the country Cloudflare infers from the request.
              * @example US
              */
             country?: string;
+            /**
+             * @description Signed identity token (`base64url(json).base64url(hmac)`). An invalid token is ignored and the event is stored anonymously.
+             * @example eyJ1IjoidV8xIn0.3q2-7w
+             */
+            identity?: string;
+            /**
+             * @description Client IP, for server-side senders. Only used to derive the daily visitor hash; never stored. Defaults to the connecting IP.
+             * @example 203.0.113.7
+             */
+            ip?: string;
         };
         /** @description Event tracking data */
         EventInput: {
@@ -339,98 +576,55 @@ export interface components {
              */
             language?: string;
             /**
-             * @description The user country code
+             * @description The user country code. Wins over the country Cloudflare infers from the request.
              * @example US
              */
             country?: string;
+            /**
+             * @description Signed identity token (`base64url(json).base64url(hmac)`). An invalid token is ignored and the event is stored anonymously.
+             * @example eyJ1IjoidV8xIn0.3q2-7w
+             */
+            identity?: string;
+            /**
+             * @description Client IP, for server-side senders. Only used to derive the daily visitor hash; never stored. Defaults to the connecting IP.
+             * @example 203.0.113.7
+             */
+            ip?: string;
         };
-        /**
-         * Analytics Query Request
-         * @description Query parameters for analytics data
-         */
-        QueryRequest: {
-            /** @description Time range for the query */
-            date_range: string | {
-                /**
-                 * @description Start date (ISO 8601)
-                 * @example 2025-01-01
-                 */
-                from: string;
-                /**
-                 * @description End date (ISO 8601)
-                 * @example 2025-01-31
-                 */
-                to: string;
-            };
-            /** @description Timezone (e.g., America/Santo_Domingo) */
-            tz?: string;
-            /**
-             * @description Metrics to calculate
-             * @example [
-             *       "pageviews",
-             *       "visitors"
-             *     ]
-             */
-            metrics: ("pageviews" | "visitors" | "sessions" | "visit:bounce_rate" | "visit:avg_duration" | "events")[];
-            /**
-             * @description Dimensions to group by
-             * @example [
-             *       "event:page"
-             *     ]
-             */
-            dimensions?: ("event:page" | "visit:country_name" | "visit:source" | "visit:referrer" | "visit:device" | "visit:browser" | "event:name")[];
-            /**
-             * @description Filters to apply
-             * @example []
-             */
-            filters?: (("equals" | "not_equals" | "contains" | "starts_with" | "in" | "not_in" | "between" | "is_not") | string | (string | number | string[] | number[] | string[]))[][] | (("equals" | "not_equals" | "contains" | "starts_with" | "in" | "not_in" | "between" | "is_not") | string | (string | number | string[] | number[] | string[]))[][];
-            /**
-             * @description Ordering criteria
-             * @example []
-             */
-            order_by?: (string | ("asc" | "desc"))[][] | (string | ("asc" | "desc"))[][];
-            /** @description Pagination options */
-            pagination?: {
-                /**
-                 * @default 100
-                 * @example 50
-                 */
-                limit: number;
-                /**
-                 * @default 0
-                 * @example 0
-                 */
-                offset: number;
-            };
-            /** @description Additional data to include in response */
-            include?: {
-                /** @default false */
-                time_labels: boolean;
-                /** @default false */
-                total_rows: boolean;
-                /**
-                 * @default daily
-                 * @enum {string}
-                 */
-                granularity: "hourly" | "daily" | "weekly" | "monthly" | "yearly";
-            };
+        /** @description Profile stored */
+        IdentifyResponse: {
+            /** @example true */
+            success: boolean;
         };
-        /**
-         * Analytics Query Response
-         * @description Analytics query results
-         */
-        QueryResponse: {
-            /** @description Query results */
-            results: {
-                dimensions: string[];
-                metrics: number[];
-                time_series?: number[];
-            }[];
-            /** @description Metadata about the query */
-            meta: {
-                time_labels?: string[];
-                total_rows?: number;
-                query: components["schemas"]["QueryRequest"];
+        /** @description Error response */
+        ErrorResponse: {
+            /**
+             * @description Error message
+             * @example Invalid request body
+             */
+            error: string;
+            /**
+             * @description Detailed error information
+             * @example Invalid JSON format
+             */
+            details: string;
+        };
+        /** @description Person profile traits */
+        IdentifyInput: {
+            /**
+             * @description The stable user id, the same one identity tokens carry as `user`.
+             * @example usr_7Hq2mXk9
+             */
+            user: string;
+            /**
+             * @description Merged into the stored profile. `null` deletes a trait. The dashboard labels a person by `name`, else `email`, else the id.
+             * @example {
+             *       "name": "María Pérez",
+             *       "email": "maria@example.com"
+             *     }
+             */
+            traits: {
+                [key: string]: string | number | boolean | null;
             };
         };
         /** @description Health check response */
@@ -446,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"];
+        };
+    };
+}