@the-situation/indexer 0.17.1 → 0.18.1

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: {
@@ -112,10 +112,10 @@ export declare const adminSubscriptionRoutes: (db: DatabaseService, adminApiKey:
                         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"}

package/dist/api/routes/analytics.js

@@ -0,0 +1,122 @@
+/**
+ * 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 { parseAnalyticsFilters, parseEntityType, } from '../../warehouse/analytics-helpers';
+const ADDRESS_RE = /^0x[0-9a-fA-F]+$/;
+const SLUG_RE = /^[a-z][a-z0-9_-]*$/;
+const NOT_CONFIGURED_BODY = {
+    error: 'Analytics warehouse is not configured (set WAREHOUSE_DATABASE_URL).',
+};
+/**
+ * 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 const analyticsRoutes = (repo) => new Elysia()
+    .get('/api/analytics/overview', async ({ set }) => {
+    if (!repo) {
+        set.status = 503;
+        return NOT_CONFIGURED_BODY;
+    }
+    return repo.getOverview();
+})
+    .get('/api/analytics/domains', async ({ set }) => {
+    if (!repo) {
+        set.status = 503;
+        return NOT_CONFIGURED_BODY;
+    }
+    return repo.getDomains();
+})
+    .get('/api/analytics/domains/:slug', async ({ params, set }) => {
+    if (!repo) {
+        set.status = 503;
+        return NOT_CONFIGURED_BODY;
+    }
+    const slug = String(params.slug ?? '').toLowerCase();
+    if (!SLUG_RE.test(slug)) {
+        set.status = 400;
+        return { error: `Invalid domain slug: ${slug}` };
+    }
+    const detail = await repo.getDomainDetail(slug);
+    if (!detail) {
+        set.status = 404;
+        return { error: `Domain not found: ${slug}` };
+    }
+    return detail;
+})
+    .get('/api/analytics/cohorts', async ({ query, set }) => {
+    if (!repo) {
+        set.status = 503;
+        return NOT_CONFIGURED_BODY;
+    }
+    const q = query;
+    try {
+        const filters = parseAnalyticsFilters({ domain: q.domain });
+        const entityType = parseEntityType(q.entityType ?? q.entity_type);
+        return await repo.getCohorts({ entityType, domain: filters.domain });
+    }
+    catch (err) {
+        set.status = 400;
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+})
+    .get('/api/analytics/roi', async ({ query, set }) => {
+    if (!repo) {
+        set.status = 503;
+        return NOT_CONFIGURED_BODY;
+    }
+    const q = query;
+    try {
+        const filters = parseAnalyticsFilters({ domain: q.domain });
+        const entityType = parseEntityType(q.entityType ?? q.entity_type);
+        return await repo.getRoi({ entityType, domain: filters.domain });
+    }
+    catch (err) {
+        set.status = 400;
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+})
+    .get('/api/analytics/leaderboard', async ({ query, set }) => {
+    if (!repo) {
+        set.status = 503;
+        return NOT_CONFIGURED_BODY;
+    }
+    const q = query;
+    try {
+        const filters = parseAnalyticsFilters(q);
+        const limit = Math.min(Math.max(1, Number.parseInt(q.limit ?? '50', 10) || 50), 500);
+        return await repo.getLeaderboard({ ...filters, limit });
+    }
+    catch (err) {
+        set.status = 400;
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+})
+    .get('/api/analytics/traders/:address', async ({ params, set }) => {
+    if (!repo) {
+        set.status = 503;
+        return NOT_CONFIGURED_BODY;
+    }
+    const address = String(params.address ?? '');
+    if (!ADDRESS_RE.test(address)) {
+        set.status = 400;
+        return { error: `Invalid address: ${address}` };
+    }
+    return await repo.getTraderAnalytics(address);
+});
+//# sourceMappingURL=analytics.js.map

package/dist/api/routes/analytics.js.map

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

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

@@ -1,4 +1,5 @@
 export { activityFeedRoutes } from './activity-feed';
+export { analyticsRoutes } from './analytics';
 export { adminRoutes } from './admin';
 export { adminSubscriptionRoutes } from './admin-subscriptions';
 export { healthRoutes } from './health';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/routes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/routes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC"}

package/dist/api/routes/index.js

@@ -1,4 +1,5 @@
 export { activityFeedRoutes } from './activity-feed';
+export { analyticsRoutes } from './analytics';
 export { adminRoutes } from './admin';
 export { adminSubscriptionRoutes } from './admin-subscriptions';
 export { healthRoutes } from './health';

package/dist/api/routes/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/routes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/routes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC"}

package/dist/api/routes/lp-history.d.ts

@@ -29,8 +29,8 @@ export declare const lpHistoryRoutes: (db: DatabaseService) => Elysia<"", {
                             get: {
                                 body: unknown;
                                 params: {
-                                    provider: string;
                                     address: string;
+                                    provider: string;
                                 } & {};
                                 query: unknown;
                                 headers: unknown;

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

@@ -1,9 +1,21 @@
 /**
- * GET /api/rankings — global leaderboard.
+ * GET /api/rankings — leaderboard with optional ?domain=&from=&to= filters.
+ *
+ * Filter behaviour:
+ *   - No filters → SQLite-backed lifetime leaderboard (current behaviour).
+ *   - domain=<slug>, from=, to= → routed to the warehouse-backed analytics
+ *     leaderboard, which knows how to slice by domain & time-window. Response
+ *     shape stays compatible (RankingEntry[]) so existing webapp consumers
+ *     don't break.
+ *
+ * If filters are passed but the warehouse is not configured, we 503 — the
+ * filtered view requires the warehouse to be running.
  */
 import { Elysia } from 'elysia';
 import type { DatabaseService } from '../../services/Database';
-export declare const rankingRoutes: (db: DatabaseService) => Elysia<"", {
+import type { RankingEntry } from '../../types/api';
+import type { AnalyticsRepository } from '../../warehouse/repositories/analytics';
+export declare const rankingRoutes: (db: DatabaseService, analytics: AnalyticsRepository | null) => Elysia<"", {
     decorator: {};
     store: {};
     derive: {};
@@ -27,7 +39,9 @@ export declare const rankingRoutes: (db: DatabaseService) => Elysia<"", {
                 query: unknown;
                 headers: unknown;
                 response: {
-                    200: import("../../types").RankingEntry[];
+                    200: RankingEntry[] | {
+                        error: string;
+                    };
                 };
             };
         };

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

@@ -1 +1 @@
-{"version":3,"file":"rankings.d.ts","sourceRoot":"","sources":["../../../src/api/routes/rankings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,eAAO,MAAM,aAAa,GAAI,IAAI,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK7C,CAAC"}
+{"version":3,"file":"rankings.d.ts","sourceRoot":"","sources":["../../../src/api/routes/rankings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAGlF,eAAO,MAAM,aAAa,GACxB,IAAI,eAAe,EACnB,WAAW,mBAAmB,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CnC,CAAC"}

package/dist/api/routes/rankings.js

@@ -1,10 +1,49 @@
 /**
- * GET /api/rankings — global leaderboard.
+ * GET /api/rankings — leaderboard with optional ?domain=&from=&to= filters.
+ *
+ * Filter behaviour:
+ *   - No filters → SQLite-backed lifetime leaderboard (current behaviour).
+ *   - domain=<slug>, from=, to= → routed to the warehouse-backed analytics
+ *     leaderboard, which knows how to slice by domain & time-window. Response
+ *     shape stays compatible (RankingEntry[]) so existing webapp consumers
+ *     don't break.
+ *
+ * If filters are passed but the warehouse is not configured, we 503 — the
+ * filtered view requires the warehouse to be running.
  */
 import { Elysia } from 'elysia';
-export const rankingRoutes = (db) => new Elysia().get('/api/rankings', ({ query }) => {
-    const typedQuery = query;
-    const limit = Math.min(Math.max(1, parseInt(typedQuery.limit ?? '50', 10) || 50), 200);
-    return db.rankings.getLeaderboard(limit);
+import { parseAnalyticsFilters } from '../../warehouse/analytics-helpers';
+export const rankingRoutes = (db, analytics) => new Elysia().get('/api/rankings', async ({ query, set }) => {
+    const q = query;
+    const limit = Math.min(Math.max(1, parseInt(q.limit ?? '50', 10) || 50), 200);
+    const wantsFiltered = (q.domain != null && q.domain !== '' && q.domain !== 'all') ||
+        q.from != null ||
+        q.to != null;
+    if (!wantsFiltered) {
+        return db.rankings.getLeaderboard(limit);
+    }
+    if (!analytics) {
+        set.status = 503;
+        return {
+            error: 'Filtered rankings require the analytics warehouse, which is not configured.',
+        };
+    }
+    let filters;
+    try {
+        filters = parseAnalyticsFilters(q);
+    }
+    catch (err) {
+        set.status = 400;
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+    const result = await analytics.getLeaderboard({ ...filters, limit });
+    // Backwards-compatible shape — webapp's existing useLeaderboard consumes RankingEntry[].
+    const compat = result.entries.map((e) => ({
+        trader: e.trader,
+        totalPnl: e.totalPnl,
+        marketsTraded: e.marketsTraded,
+        totalTrades: e.totalTrades,
+    }));
+    return compat;
 });
 //# sourceMappingURL=rankings.js.map

package/dist/api/routes/rankings.js.map

@@ -1 +1 @@
-{"version":3,"file":"rankings.js","sourceRoot":"","sources":["../../../src/api/routes/rankings.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAmB,EAAE,EAAE,CACnD,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IAC9C,MAAM,UAAU,GAAG,KAAoC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IACvF,OAAO,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC"}
+{"version":3,"file":"rankings.js","sourceRoot":"","sources":["../../../src/api/routes/rankings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,EAAmB,EACnB,SAAqC,EACrC,EAAE,CACF,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE;IACzD,MAAM,CAAC,GAAG,KAKT,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IAE9E,MAAM,aAAa,GACjB,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC;QAC3D,CAAC,CAAC,IAAI,IAAI,IAAI;QACd,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC;IAEf,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;QACjB,OAAO;YACL,KAAK,EAAE,6EAA6E;SACrF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;QACjB,OAAO,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACrE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,cAAc,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACrE,yFAAyF;IACzF,MAAM,MAAM,GAAmB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,aAAa,EAAE,CAAC,CAAC,aAAa;QAC9B,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC,CAAC,CAAC;IACJ,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC"}

package/dist/api/routes/trader-stats.d.ts

@@ -1,9 +1,16 @@
 /**
  * GET /api/positions/:trader/stats — aggregated trader statistics.
+ *
+ * Optional ?domain=<slug> routes the request to the warehouse-backed analytics
+ * trader endpoint and returns a domain-filtered subset of the same fields.
+ * Time-window filters (?from=, ?to=) are accepted but currently apply only to
+ * the warehouse path — they sum daily fact rows in the window.
  */
 import { Elysia } from 'elysia';
 import type { DatabaseService } from '../../services/Database';
-export declare const traderStatsRoutes: (db: DatabaseService) => Elysia<"", {
+import type { TraderStatsResponse } from '../../types/api';
+import type { AnalyticsRepository } from '../../warehouse/repositories/analytics';
+export declare const traderStatsRoutes: (db: DatabaseService, analytics: AnalyticsRepository | null) => Elysia<"", {
     decorator: {};
     store: {};
     derive: {};
@@ -31,7 +38,9 @@ export declare const traderStatsRoutes: (db: DatabaseService) => Elysia<"", {
                         query: unknown;
                         headers: unknown;
                         response: {
-                            200: import("../../types").TraderStatsResponse;
+                            200: TraderStatsResponse | {
+                                error: string;
+                            };
                             422: {
                                 type: "validation";
                                 on: string;

package/dist/api/routes/trader-stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trader-stats.d.ts","sourceRoot":"","sources":["../../../src/api/routes/trader-stats.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE/D,eAAO,MAAM,iBAAiB,GAAI,IAAI,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGjD,CAAC"}
+{"version":3,"file":"trader-stats.d.ts","sourceRoot":"","sources":["../../../src/api/routes/trader-stats.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAGlF,eAAO,MAAM,iBAAiB,GAC5B,IAAI,eAAe,EACnB,WAAW,mBAAmB,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0EnC,CAAC"}

package/dist/api/routes/trader-stats.js

@@ -1,8 +1,78 @@
 /**
  * GET /api/positions/:trader/stats — aggregated trader statistics.
+ *
+ * Optional ?domain=<slug> routes the request to the warehouse-backed analytics
+ * trader endpoint and returns a domain-filtered subset of the same fields.
+ * Time-window filters (?from=, ?to=) are accepted but currently apply only to
+ * the warehouse path — they sum daily fact rows in the window.
  */
 import { Elysia } from 'elysia';
-export const traderStatsRoutes = (db) => new Elysia().get('/api/positions/:trader/stats', ({ params }) => {
-    return db.rankings.getTraderStats(params.trader);
+import { parseAnalyticsFilters } from '../../warehouse/analytics-helpers';
+export const traderStatsRoutes = (db, analytics) => new Elysia().get('/api/positions/:trader/stats', async ({ params, query, set }) => {
+    const q = query;
+    const wantsFiltered = (q.domain != null && q.domain !== '' && q.domain !== 'all') ||
+        q.from != null ||
+        q.to != null;
+    if (!wantsFiltered) {
+        return db.rankings.getTraderStats(params.trader);
+    }
+    if (!analytics) {
+        set.status = 503;
+        return {
+            error: 'Filtered trader stats require the analytics warehouse, which is not configured.',
+        };
+    }
+    let filters;
+    try {
+        filters = parseAnalyticsFilters(q);
+    }
+    catch (err) {
+        set.status = 400;
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+    const traderAnalytics = await analytics.getTraderAnalytics(params.trader);
+    if (!traderAnalytics.lifetime) {
+        // Trader has never traded — return zero stats consistent with TraderStatsResponse shape.
+        const empty = {
+            trader: params.trader,
+            totalPnl: 0,
+            unrealizedPnl: 0,
+            biggestWin: 0,
+            totalTrades: 0,
+            marketsTraded: 0,
+            firstTradeAt: null,
+            lastTradeAt: null,
+        };
+        return empty;
+    }
+    if (filters.domain !== 'all') {
+        // Domain-filtered slice — read from perDomain.
+        const domainSlice = traderAnalytics.perDomain.find((d) => d.slug === filters.domain);
+        const stats = {
+            trader: params.trader,
+            // P&L is not currently tracked per-domain; expose lifetime totals so the
+            // client can show "domain stats + portfolio P&L". This is honest about
+            // current capability — no fake per-domain P&L.
+            totalPnl: traderAnalytics.lifetime.totalPnl,
+            unrealizedPnl: traderAnalytics.lifetime.unrealizedPnl,
+            biggestWin: 0,
+            totalTrades: domainSlice?.tradeCount ?? 0,
+            marketsTraded: domainSlice?.marketsTraded ?? 0,
+            firstTradeAt: traderAnalytics.lifetime.firstTradeAt,
+            lastTradeAt: traderAnalytics.lifetime.lastTradeAt,
+        };
+        return stats;
+    }
+    const stats = {
+        trader: params.trader,
+        totalPnl: traderAnalytics.lifetime.totalPnl,
+        unrealizedPnl: traderAnalytics.lifetime.unrealizedPnl,
+        biggestWin: 0,
+        totalTrades: traderAnalytics.lifetime.totalTrades,
+        marketsTraded: traderAnalytics.lifetime.marketsTraded,
+        firstTradeAt: traderAnalytics.lifetime.firstTradeAt,
+        lastTradeAt: traderAnalytics.lifetime.lastTradeAt,
+    };
+    return stats;
 });
 //# sourceMappingURL=trader-stats.js.map