@the-situation/indexer 0.17.0 → 0.18.0

package/dist/api/app.d.ts

@@ -5,11 +5,19 @@ import { Elysia } from 'elysia';
 import type { DatabaseService } from '../services/Database';
 import type { EventBusService } from '../services/EventBus';
 import type { VoyagerRateLimitState } from '../services/VoyagerRateLimit';
+import type { AnalyticsRepository } from '../warehouse/repositories/analytics';
 export interface AppConfig {
     readonly db: DatabaseService;
     readonly eventBus: EventBusService;
     readonly adminApiKey: string;
     readonly rateLimit: VoyagerRateLimitState;
+    /**
+     * Warehouse analytics repository. `null` (or omitted) when
+     * WAREHOUSE_DATABASE_URL is not set — analytics routes return 503 and
+     * filter-aware variants of /api/rankings, /api/positions/:trader/stats fall
+     * back to OLTP / 503 for filtered requests.
+     */
+    readonly analytics?: AnalyticsRepository | null;
 }
 export declare function createApp(config: AppConfig): Elysia<"", {
     decorator: {};
@@ -321,7 +329,9 @@ export declare function createApp(config: AppConfig): Elysia<"", {
                         query: unknown;
                         headers: unknown;
                         response: {
-                            200: import("../types").TraderStatsResponse;
+                            200: import("../types").TraderStatsResponse | {
+                                error: string;
+                            };
                             422: {
                                 type: "validation";
                                 on: string;
@@ -346,7 +356,9 @@ export declare function createApp(config: AppConfig): Elysia<"", {
                 query: unknown;
                 headers: unknown;
                 response: {
-                    200: import("../types").RankingEntry[];
+                    200: import("../types").RankingEntry[] | {
+                        error: string;
+                    };
                 };
             };
         };
@@ -527,10 +539,10 @@ export declare function createApp(config: AppConfig): Elysia<"", {
                     name: string;
                     webhook_url: string;
                     filters: {
-                        traders?: string[];
-                        eventTypes?: ("settlement" | "trade_move" | "market_created")[];
+                        eventTypes?: ("trade_move" | "settlement" | "market_created")[];
                         marketTypes?: string[];
                         marketAddresses?: string[];
+                        traders?: string[];
                         minCollateral?: number;
                     };
                 };
@@ -538,9 +550,9 @@ export declare function createApp(config: AppConfig): Elysia<"", {
                 query: unknown;
                 headers: unknown;
                 response: {
-                    200: {
+                    200: import("../types").SubscriptionResponse | {
                         error: string;
-                    } | import("../types").SubscriptionResponse;
+                    };
                     422: {
                         type: "validation";
                         on: string;
@@ -582,9 +594,9 @@ export declare function createApp(config: AppConfig): Elysia<"", {
                     query: unknown;
                     headers: unknown;
                     response: {
-                        200: {
+                        200: import("../types").SubscriptionResponse | {
                             error: string;
-                        } | import("../types").SubscriptionResponse | {
+                        } | {
                             error: string;
                         };
                         422: {
@@ -608,13 +620,13 @@ export declare function createApp(config: AppConfig): Elysia<"", {
                 put: {
                     body: {
                         name?: string;
-                        secret?: string;
                         webhook_url?: string;
+                        secret?: string;
                         filters?: {
-                            traders?: string[];
-                            eventTypes?: ("settlement" | "trade_move" | "market_created")[];
+                            eventTypes?: ("trade_move" | "settlement" | "market_created")[];
                             marketTypes?: string[];
                             marketAddresses?: string[];
+                            traders?: string[];
                             minCollateral?: number;
                         };
                         is_active?: boolean;
@@ -625,9 +637,9 @@ export declare function createApp(config: AppConfig): Elysia<"", {
                     query: unknown;
                     headers: unknown;
                     response: {
-                        200: {
+                        200: import("../types").SubscriptionResponse | {
                             error: string;
-                        } | import("../types").SubscriptionResponse | {
+                        } | {
                             error: string;
                         };
                         422: {
@@ -679,6 +691,158 @@ export declare function createApp(config: AppConfig): Elysia<"", {
             };
         };
     };
+} & {
+    api: {
+        analytics: {
+            overview: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../types").AnalyticsOverviewResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            domains: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../types").DomainsResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            domains: {
+                ":slug": {
+                    get: {
+                        body: unknown;
+                        params: {
+                            slug: string;
+                        } & {};
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            200: import("../types").DomainDetailResponse | {
+                                error: string;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            cohorts: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../types").CohortsResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            roi: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../types").RoiResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            leaderboard: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../types").AnalyticsLeaderboardResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            traders: {
+                ":address": {
+                    get: {
+                        body: unknown;
+                        params: {
+                            address: string;
+                        } & {};
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            200: import("../types").TraderAnalyticsResponse | {
+                                error: string;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
 } & {
     ws: {
         subscribe: {

package/dist/api/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/api/app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAqB1E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;CAC3C;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoB1C"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/api/app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAsB/E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACjD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqB1C"}

package/dist/api/app.js

@@ -4,7 +4,7 @@
 import { cors } from '@elysiajs/cors';
 import { Elysia } from 'elysia';
 import { errorHandler } from './middleware/error-handler';
-import { activityFeedRoutes, adminRoutes, adminSubscriptionRoutes, spiceFaucetRoutes, healthRoutes, lpHistoryRoutes, marketEventsRoutes, marketLPsRoutes, marketRoutes, marketTradersRoutes, multinoulliSnapshotsRoute, positionRoutes, rankingRoutes, traderEventsRoutes, traderStatsRoutes, wsRoutes, } from './routes';
+import { activityFeedRoutes, adminRoutes, adminSubscriptionRoutes, analyticsRoutes, spiceFaucetRoutes, healthRoutes, lpHistoryRoutes, marketEventsRoutes, marketLPsRoutes, marketRoutes, marketTradersRoutes, multinoulliSnapshotsRoute, positionRoutes, rankingRoutes, traderEventsRoutes, traderStatsRoutes, wsRoutes, } from './routes';
 export function createApp(config) {
     return new Elysia()
         .use(cors())
@@ -18,12 +18,13 @@ export function createApp(config) {
         .use(lpHistoryRoutes(config.db))
         .use(positionRoutes(config.db))
         .use(traderEventsRoutes(config.db))
-        .use(traderStatsRoutes(config.db))
-        .use(rankingRoutes(config.db))
+        .use(traderStatsRoutes(config.db, config.analytics ?? null))
+        .use(rankingRoutes(config.db, config.analytics ?? null))
         .use(activityFeedRoutes(config.db))
         .use(spiceFaucetRoutes(config.db))
         .use(adminRoutes(config.db, config.adminApiKey))
         .use(adminSubscriptionRoutes(config.db, config.adminApiKey))
+        .use(analyticsRoutes(config.analytics ?? null))
         .use(wsRoutes(config.eventBus));
 }
 //# sourceMappingURL=app.js.map

package/dist/api/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/api/app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,GACT,MAAM,UAAU,CAAC;AASlB,MAAM,UAAU,SAAS,CAAC,MAAiB;IACzC,OAAO,IAAI,MAAM,EAAE;SAChB,GAAG,CAAC,IAAI,EAAE,CAAC;SACX,GAAG,CAAC,YAAY,CAAC;SACjB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;SAC9C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC5B,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAClC,GAAG,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SACzC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SACnC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC/B,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC/B,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC9B,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAClC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SACjC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC7B,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAClC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SACjC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;SAC/C,GAAG,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;SAC3D,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/api/app.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAKhC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,GACT,MAAM,UAAU,CAAC;AAgBlB,MAAM,UAAU,SAAS,CAAC,MAAiB;IACzC,OAAO,IAAI,MAAM,EAAE;SAChB,GAAG,CAAC,IAAI,EAAE,CAAC;SACX,GAAG,CAAC,YAAY,CAAC;SACjB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;SAC9C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC5B,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAClC,GAAG,CAAC,yBAAyB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SACzC,GAAG,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SACnC,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC/B,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC/B,GAAG,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAC9B,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAClC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;SAC3D,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;SACvD,GAAG,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAClC,GAAG,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SACjC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;SAC/C,GAAG,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;SAC3D,GAAG,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;SAC9C,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/api/routes/admin-subscriptions.d.ts

@@ -28,10 +28,10 @@ export declare const adminSubscriptionRoutes: (db: DatabaseService, adminApiKey:
                     name: string;
                     webhook_url: string;
                     filters: {
-                        traders?: string[];
-                        eventTypes?: ("settlement" | "trade_move" | "market_created")[];
+                        eventTypes?: ("trade_move" | "settlement" | "market_created")[];
                         marketTypes?: string[];
                         marketAddresses?: string[];
+                        traders?: string[];
                         minCollateral?: number;
                     };
                 };
@@ -39,9 +39,9 @@ export declare const adminSubscriptionRoutes: (db: DatabaseService, adminApiKey:
                 query: unknown;
                 headers: unknown;
                 response: {
-                    200: {
+                    200: SubscriptionResponse | {
                         error: string;
-                    } | SubscriptionResponse;
+                    };
                     422: {
                         type: "validation";
                         on: string;
@@ -83,9 +83,9 @@ export declare const adminSubscriptionRoutes: (db: DatabaseService, adminApiKey:
                     query: unknown;
                     headers: unknown;
                     response: {
-                        200: {
+                        200: SubscriptionResponse | {
                             error: string;
-                        } | SubscriptionResponse | {
+                        } | {
                             error: string;
                         };
                         422: {
@@ -109,13 +109,13 @@ export declare const adminSubscriptionRoutes: (db: DatabaseService, adminApiKey:
                 put: {
                     body: {
                         name?: string;
-                        secret?: string;
                         webhook_url?: string;
+                        secret?: string;
                         filters?: {
-                            traders?: string[];
-                            eventTypes?: ("settlement" | "trade_move" | "market_created")[];
+                            eventTypes?: ("trade_move" | "settlement" | "market_created")[];
                             marketTypes?: string[];
                             marketAddresses?: string[];
+                            traders?: string[];
                             minCollateral?: number;
                         };
                         is_active?: boolean;
@@ -126,9 +126,9 @@ export declare const adminSubscriptionRoutes: (db: DatabaseService, adminApiKey:
                     query: unknown;
                     headers: unknown;
                     response: {
-                        200: {
+                        200: SubscriptionResponse | {
                             error: string;
-                        } | SubscriptionResponse | {
+                        } | {
                             error: string;
                         };
                         422: {

package/dist/api/routes/analytics.d.ts

@@ -0,0 +1,205 @@
+/**
+ * GET /api/analytics/* — analytics endpoints backed by the Postgres warehouse.
+ *
+ * Routes:
+ *   GET /api/analytics/overview               — platform-wide headline stats
+ *   GET /api/analytics/domains                — per-domain summary list
+ *   GET /api/analytics/domains/:slug          — domain detail (time-series + top-N)
+ *   GET /api/analytics/cohorts                — cohort retention curves
+ *   GET /api/analytics/roi                    — ROI distribution + summary stats
+ *   GET /api/analytics/leaderboard            — leaderboard with ?domain= and time window
+ *   GET /api/analytics/traders/:address       — per-trader analytics (per-domain + cohort)
+ *
+ * These routes are only registered when WAREHOUSE_DATABASE_URL is set.
+ *
+ * Validation errors throw via parseAnalyticsFilters / parseEntityType — the
+ * shared error-handler maps Error → 400 (we tag it explicitly via `set.status`).
+ */
+import { Elysia } from 'elysia';
+import type { AnalyticsRepository } from '../../warehouse/repositories/analytics';
+/**
+ * Registers analytics routes. When `repo` is null (warehouse not configured),
+ * every analytics route returns 503 with a clear message so consumers can
+ * fall back gracefully.
+ */
+export declare const analyticsRoutes: (repo: AnalyticsRepository | null) => Elysia<"", {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    typebox: {};
+    error: {};
+}, {
+    schema: {};
+    standaloneSchema: {};
+    macro: {};
+    macroFn: {};
+    parser: {};
+    response: {};
+}, {
+    api: {
+        analytics: {
+            overview: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../../types").AnalyticsOverviewResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            domains: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../../types").DomainsResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            domains: {
+                ":slug": {
+                    get: {
+                        body: unknown;
+                        params: {
+                            slug: string;
+                        } & {};
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            200: import("../../types").DomainDetailResponse | {
+                                error: string;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            cohorts: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../../types").CohortsResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            roi: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../../types").RoiResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            leaderboard: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: import("../../types").AnalyticsLeaderboardResponse | {
+                            error: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    api: {
+        analytics: {
+            traders: {
+                ":address": {
+                    get: {
+                        body: unknown;
+                        params: {
+                            address: string;
+                        } & {};
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            200: import("../../types").TraderAnalyticsResponse | {
+                                error: string;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+    standaloneSchema: {};
+    response: {};
+}>;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/api/routes/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/api/routes/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACV,mBAAmB,EACpB,MAAM,wCAAwC,CAAC;AAahD;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,mBAAmB,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuG1D,CAAC"}