@the-situation/indexer 0.17.0 → 0.18.0

package/dist/aggregator/domains.js

@@ -0,0 +1,38 @@
+/** All primary-domain rows. */
+export async function loadMarketPrimaryDomains(pg) {
+    const rows = (await pg `
+    SELECT market_address, domain_slug
+    FROM market_domains
+    WHERE is_primary
+  `);
+    const map = new Map();
+    for (const row of rows) {
+        map.set(row.market_address, row.domain_slug);
+    }
+    return map;
+}
+/** Lookup with `'other'` fallback. */
+export function primaryDomainOf(map, marketAddress) {
+    return map.get(marketAddress) ?? 'other';
+}
+/**
+ * Returns all (market, slug) pairs — useful for "user touched N domains"
+ * style metrics. A market may be tagged with multiple domains; this returns
+ * every assignment.
+ */
+export async function loadAllMarketDomains(pg) {
+    const rows = (await pg `
+    SELECT market_address, domain_slug FROM market_domains
+  `);
+    const map = new Map();
+    for (const row of rows) {
+        let set = map.get(row.market_address);
+        if (!set) {
+            set = new Set();
+            map.set(row.market_address, set);
+        }
+        set.add(row.domain_slug);
+    }
+    return map;
+}
+//# sourceMappingURL=domains.js.map

package/dist/aggregator/domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domains.js","sourceRoot":"","sources":["../../src/aggregator/domains.ts"],"names":[],"mappings":"AAWA,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,EAAO;IACpD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAA;;;;GAIrB,CAA2D,CAAC;IAE7D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,eAAe,CAAC,GAAoB,EAAE,aAAqB;IACzE,OAAO,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,EAAO;IAEP,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAA;;GAErB,CAA2D,CAAC;IAE7D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;YACxB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAA+C,CAAC;AACzD,CAAC"}

package/dist/aggregator/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Aggregator orchestrator.
+ *
+ * Reads OLTP rows from SQLite, computes derived analytics in memory, and bulk-
+ * writes them into the Postgres warehouse. Intended to run on a non-overlapping
+ * loop (default 5 min) alongside the existing event/state/position refreshers.
+ *
+ * Strategy: full recompute per cycle. Cheap at current scale (~100k events).
+ * Switch to incremental once event volume justifies it.
+ */
+import type { SQL } from 'bun';
+import type { Database as SqliteDatabase } from 'bun:sqlite';
+export interface AggregatorRunSummary {
+    readonly events: number;
+    readonly traders: number;
+    readonly lps: number;
+    readonly dailyRows: number;
+    readonly cohortRows: number;
+    readonly roiRows: number;
+    readonly durationMs: number;
+}
+export declare function runAggregatorOnce(sqlite: SqliteDatabase, pg: SQL): Promise<AggregatorRunSummary>;
+export interface AggregatorHandles {
+    readonly stop: () => void;
+    readonly runNow: () => Promise<AggregatorRunSummary>;
+}
+/**
+ * Start a non-overlapping aggregator loop. Returns handles for shutdown.
+ */
+export declare function startAggregator(sqlite: SqliteDatabase, pg: SQL, intervalMs: number): AggregatorHandles;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aggregator/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,YAAY,CAAC;AA+B7D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,GAAG,GACN,OAAO,CAAC,oBAAoB,CAAC,CA6C/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,GAAG,EACP,UAAU,EAAE,MAAM,GACjB,iBAAiB,CA+CnB"}

package/dist/aggregator/index.js

@@ -0,0 +1,100 @@
+import { log } from '../logger';
+import { buildDailyAggregates, } from './daily';
+import { loadMarketPrimaryDomains } from './domains';
+import { buildLPLifetime, buildTraderLifetime, } from './lifetime';
+import { buildCohortRetention, writeCohortRetention } from './cohort';
+import { buildRoi, writeRoi } from './roi';
+import { readAllEvents, readAllLPPositions, readAllPositions, } from './sources';
+import { recordAggregatorRun, writeDailyDomainStats, writeDailyLPStats, writeDailyMarketStats, writeDailyPlatformStats, writeDailyTraderStats, writeLPLifetime, writeTraderLifetime, } from './writers';
+export async function runAggregatorOnce(sqlite, pg) {
+    const start = performance.now();
+    const [events, positions, lpPositions, marketDomains] = await Promise.all([
+        Promise.resolve(readAllEvents(sqlite)),
+        Promise.resolve(readAllPositions(sqlite)),
+        Promise.resolve(readAllLPPositions(sqlite)),
+        loadMarketPrimaryDomains(pg),
+    ]);
+    const daily = buildDailyAggregates(events, marketDomains);
+    const traderLifetime = buildTraderLifetime(events, positions, marketDomains);
+    const lpLifetime = buildLPLifetime(lpPositions, marketDomains);
+    const cohort = buildCohortRetention(events, traderLifetime, lpLifetime, marketDomains);
+    const roi = buildRoi(traderLifetime, lpLifetime);
+    await writeDailyTraderStats(pg, daily.trader);
+    await writeDailyLPStats(pg, daily.lp);
+    await writeDailyMarketStats(pg, daily.market);
+    await writeDailyDomainStats(pg, daily.domain);
+    await writeDailyPlatformStats(pg, daily.platform);
+    await writeTraderLifetime(pg, traderLifetime);
+    await writeLPLifetime(pg, lpLifetime);
+    await writeCohortRetention(pg, cohort);
+    await writeRoi(pg, roi);
+    const durationMs = Math.round(performance.now() - start);
+    return {
+        events: events.length,
+        traders: traderLifetime.length,
+        lps: lpLifetime.length,
+        dailyRows: daily.trader.length +
+            daily.lp.length +
+            daily.market.length +
+            daily.domain.length +
+            daily.platform.length,
+        cohortRows: cohort.length,
+        roiRows: roi.distribution.length + roi.summary.length,
+        durationMs,
+    };
+}
+/**
+ * Start a non-overlapping aggregator loop. Returns handles for shutdown.
+ */
+export function startAggregator(sqlite, pg, intervalMs) {
+    let stopped = false;
+    let timer = null;
+    let inFlight = null;
+    async function runOnce() {
+        try {
+            const summary = await runAggregatorOnce(sqlite, pg);
+            await recordAggregatorRun(pg, 'main', true, null);
+            log.info('aggregator cycle', { ...summary });
+            return summary;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            log.error('aggregator cycle failed', { error: message });
+            try {
+                await recordAggregatorRun(pg, 'main', false, message);
+            }
+            catch {
+                // ignore — bookkeeping is best-effort
+            }
+            throw err;
+        }
+    }
+    async function loop() {
+        if (stopped)
+            return;
+        inFlight = runOnce();
+        try {
+            await inFlight;
+        }
+        catch {
+            // already logged
+        }
+        finally {
+            inFlight = null;
+        }
+        if (stopped)
+            return;
+        timer = setTimeout(loop, intervalMs);
+    }
+    // Kick off after one interval so the OLTP boot sync gets a head start.
+    timer = setTimeout(loop, intervalMs);
+    return {
+        stop: () => {
+            stopped = true;
+            if (timer != null)
+                clearTimeout(timer);
+        },
+        runNow: () => inFlight ?? runOnce(),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/aggregator/index.js.map

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

package/dist/aggregator/lifetime.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Per-entity lifetime aggregates (CLTV inputs).
+ *
+ * `trader_lifetime` is built from market_events (for activity) + user_positions
+ * (for P&L). `lp_lifetime` rolls up lp_positions across markets per provider.
+ *
+ * ROI percentage is total_pnl / total_collateral_at_risk * 100. It is NULL
+ * when the denominator is zero (no capital ever deployed).
+ */
+import { type AggEventRow, type AggLPPositionRow, type AggPositionRow } from './sources';
+import { type MarketDomainMap } from './domains';
+export interface TraderLifetimeRow {
+    readonly trader: string;
+    readonly first_trade_at: number | null;
+    readonly last_trade_at: number | null;
+    readonly cohort_week: string | null;
+    readonly total_trades: number;
+    readonly buy_count: number;
+    readonly sell_count: number;
+    readonly markets_traded: number;
+    readonly domains_traded: number;
+    readonly domains_json: readonly string[];
+    readonly total_volume: number;
+    readonly total_collateral_at_risk: number;
+    readonly realized_pnl: number;
+    readonly unrealized_pnl: number;
+    readonly total_pnl: number;
+    readonly roi_pct: number | null;
+    readonly active_days: number;
+}
+export interface LPLifetimeRow {
+    readonly provider: string;
+    readonly first_deposit_at: number | null;
+    readonly last_activity_at: number | null;
+    readonly cohort_week: string | null;
+    readonly deposit_count: number;
+    readonly withdraw_count: number;
+    readonly total_deposited: number;
+    readonly total_withdrawn: number;
+    readonly net_position: number;
+    readonly current_value: number | null;
+    readonly unrealized_pnl: number | null;
+    readonly realized_pnl: number;
+    readonly markets_provided: number;
+    readonly domains_provided: number;
+    readonly domains_json: readonly string[];
+    readonly active_days: number;
+    readonly roi_pct: number | null;
+}
+export declare function buildTraderLifetime(events: readonly AggEventRow[], positions: readonly AggPositionRow[], marketDomains: MarketDomainMap): readonly TraderLifetimeRow[];
+export declare function buildLPLifetime(lpPositions: readonly AggLPPositionRow[], marketDomains: MarketDomainMap): readonly LPLifetimeRow[];
+//# sourceMappingURL=lifetime.d.ts.map

package/dist/aggregator/lifetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifetime.d.ts","sourceRoot":"","sources":["../../src/aggregator/lifetime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EAGpB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,KAAK,eAAe,EAAmB,MAAM,WAAW,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAiDD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,SAAS,EAAE,SAAS,cAAc,EAAE,EACpC,aAAa,EAAE,eAAe,GAC7B,SAAS,iBAAiB,EAAE,CAiH9B;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,SAAS,gBAAgB,EAAE,EACxC,aAAa,EAAE,eAAe,GAC7B,SAAS,aAAa,EAAE,CAuF1B"}

package/dist/aggregator/lifetime.js

@@ -0,0 +1,222 @@
+/**
+ * Per-entity lifetime aggregates (CLTV inputs).
+ *
+ * `trader_lifetime` is built from market_events (for activity) + user_positions
+ * (for P&L). `lp_lifetime` rolls up lp_positions across markets per provider.
+ *
+ * ROI percentage is total_pnl / total_collateral_at_risk * 100. It is NULL
+ * when the denominator is zero (no capital ever deployed).
+ */
+import { TRADE_EVENT_TYPES, parseCollateralAmount, } from './sources';
+import { primaryDomainOf } from './domains';
+function dateOfUTC(ts) {
+    const d = new Date(ts * 1000);
+    const yyyy = d.getUTCFullYear();
+    const mm = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const dd = String(d.getUTCDate()).padStart(2, '0');
+    return `${yyyy}-${mm}-${dd}`;
+}
+/** ISO Monday (UTC) of the week containing the given unix-seconds timestamp. */
+function isoWeekStart(ts) {
+    const d = new Date(ts * 1000);
+    const day = d.getUTCDay(); // 0 Sun .. 6 Sat
+    const diff = day === 0 ? -6 : 1 - day;
+    const monday = new Date(d.getTime());
+    monday.setUTCDate(d.getUTCDate() + diff);
+    return dateOfUTC(Math.floor(monday.getTime() / 1000));
+}
+export function buildTraderLifetime(events, positions, marketDomains) {
+    const states = new Map();
+    for (const event of events) {
+        if (!event.trader)
+            continue;
+        if (!TRADE_EVENT_TYPES.has(event.event_type))
+            continue;
+        const trader = event.trader;
+        const collateral = parseCollateralAmount(event.collateral_posted);
+        const isSell = (event.is_position_sell ?? 0) === 1;
+        const domain = primaryDomainOf(marketDomains, event.market_address);
+        let s = states.get(trader);
+        if (!s) {
+            s = {
+                first_trade_at: event.timestamp,
+                last_trade_at: event.timestamp,
+                total_trades: 0,
+                buy_count: 0,
+                sell_count: 0,
+                markets: new Set(),
+                domains: new Set(),
+                total_volume: 0,
+                active_days: new Set(),
+            };
+            states.set(trader, s);
+        }
+        s.first_trade_at = Math.min(s.first_trade_at, event.timestamp);
+        s.last_trade_at = Math.max(s.last_trade_at, event.timestamp);
+        s.total_trades += 1;
+        if (isSell)
+            s.sell_count += 1;
+        else
+            s.buy_count += 1;
+        s.markets.add(event.market_address);
+        s.domains.add(domain);
+        s.total_volume += collateral;
+        s.active_days.add(dateOfUTC(event.timestamp));
+    }
+    // P&L from user_positions
+    const pnlByTrader = new Map();
+    for (const pos of positions) {
+        if (!pos.trader)
+            continue;
+        const realized = pos.realized_pnl ?? 0;
+        const unrealized = pos.has_position === 1 ? (pos.unrealized_pnl ?? 0) : 0;
+        const ev = pos.expected_value ?? 0;
+        const entry = pnlByTrader.get(pos.trader) ?? {
+            realized: 0,
+            unrealized: 0,
+            collateralAtRisk: 0,
+        };
+        entry.realized += realized;
+        entry.unrealized += unrealized;
+        entry.collateralAtRisk += Math.max(0, ev);
+        pnlByTrader.set(pos.trader, entry);
+    }
+    const out = [];
+    for (const [trader, s] of states) {
+        const pnl = pnlByTrader.get(trader) ?? { realized: 0, unrealized: 0, collateralAtRisk: 0 };
+        const denom = pnl.collateralAtRisk > 0 ? pnl.collateralAtRisk : s.total_volume;
+        const total_pnl = pnl.realized + pnl.unrealized;
+        const roi_pct = denom > 0 ? (total_pnl / denom) * 100 : null;
+        out.push({
+            trader,
+            first_trade_at: s.first_trade_at,
+            last_trade_at: s.last_trade_at,
+            cohort_week: isoWeekStart(s.first_trade_at),
+            total_trades: s.total_trades,
+            buy_count: s.buy_count,
+            sell_count: s.sell_count,
+            markets_traded: s.markets.size,
+            domains_traded: s.domains.size,
+            domains_json: Array.from(s.domains).sort(),
+            total_volume: s.total_volume,
+            total_collateral_at_risk: denom,
+            realized_pnl: pnl.realized,
+            unrealized_pnl: pnl.unrealized,
+            total_pnl,
+            roi_pct,
+            active_days: s.active_days.size,
+        });
+    }
+    // Traders that have positions but somehow no trade events still get a row.
+    for (const [trader, pnl] of pnlByTrader) {
+        if (states.has(trader))
+            continue;
+        const denom = pnl.collateralAtRisk;
+        const total_pnl = pnl.realized + pnl.unrealized;
+        const roi_pct = denom > 0 ? (total_pnl / denom) * 100 : null;
+        out.push({
+            trader,
+            first_trade_at: null,
+            last_trade_at: null,
+            cohort_week: null,
+            total_trades: 0,
+            buy_count: 0,
+            sell_count: 0,
+            markets_traded: 0,
+            domains_traded: 0,
+            domains_json: [],
+            total_volume: 0,
+            total_collateral_at_risk: denom,
+            realized_pnl: pnl.realized,
+            unrealized_pnl: pnl.unrealized,
+            total_pnl,
+            roi_pct,
+            active_days: 0,
+        });
+    }
+    return out;
+}
+export function buildLPLifetime(lpPositions, marketDomains) {
+    const states = new Map();
+    for (const lp of lpPositions) {
+        const domain = primaryDomainOf(marketDomains, lp.market_address);
+        let s = states.get(lp.provider);
+        if (!s) {
+            s = {
+                first_deposit_at: Number.POSITIVE_INFINITY,
+                last_activity_at: 0,
+                deposit_count: 0,
+                withdraw_count: 0,
+                total_deposited: 0,
+                total_withdrawn: 0,
+                current_value: 0,
+                current_value_known: false,
+                unrealized_pnl: 0,
+                unrealized_pnl_known: false,
+                realized_pnl: 0,
+                markets: new Set(),
+                domains: new Set(),
+                active_days: new Set(),
+            };
+            states.set(lp.provider, s);
+        }
+        if (lp.first_deposit_at != null) {
+            s.first_deposit_at = Math.min(s.first_deposit_at, lp.first_deposit_at);
+            s.active_days.add(dateOfUTC(lp.first_deposit_at));
+        }
+        if (lp.last_activity_at != null) {
+            s.last_activity_at = Math.max(s.last_activity_at, lp.last_activity_at);
+            s.active_days.add(dateOfUTC(lp.last_activity_at));
+        }
+        s.deposit_count += lp.deposit_count;
+        s.withdraw_count += lp.withdrawal_count;
+        s.total_deposited += lp.total_deposited;
+        s.total_withdrawn += lp.total_withdrawn;
+        if (lp.current_value != null) {
+            s.current_value += lp.current_value;
+            s.current_value_known = true;
+        }
+        if (lp.unrealized_pnl != null) {
+            s.unrealized_pnl += lp.unrealized_pnl;
+            s.unrealized_pnl_known = true;
+        }
+        if (lp.claim_payout != null && lp.claimed_at != null) {
+            // Claim payout - net deposited is realized P&L for this market.
+            const net = lp.total_deposited - lp.total_withdrawn;
+            s.realized_pnl += lp.claim_payout - Math.max(0, net);
+            s.active_days.add(dateOfUTC(lp.claimed_at));
+        }
+        s.markets.add(lp.market_address);
+        s.domains.add(domain);
+    }
+    const out = [];
+    for (const [provider, s] of states) {
+        const first = s.first_deposit_at === Number.POSITIVE_INFINITY ? null : s.first_deposit_at;
+        const last = s.last_activity_at === 0 ? null : s.last_activity_at;
+        const net_position = s.total_deposited - s.total_withdrawn;
+        const denom = s.total_deposited > 0 ? s.total_deposited : 0;
+        const totalReturn = s.realized_pnl + (s.unrealized_pnl_known ? s.unrealized_pnl : 0);
+        const roi_pct = denom > 0 ? (totalReturn / denom) * 100 : null;
+        out.push({
+            provider,
+            first_deposit_at: first,
+            last_activity_at: last,
+            cohort_week: first != null ? isoWeekStart(first) : null,
+            deposit_count: s.deposit_count,
+            withdraw_count: s.withdraw_count,
+            total_deposited: s.total_deposited,
+            total_withdrawn: s.total_withdrawn,
+            net_position,
+            current_value: s.current_value_known ? s.current_value : null,
+            unrealized_pnl: s.unrealized_pnl_known ? s.unrealized_pnl : null,
+            realized_pnl: s.realized_pnl,
+            markets_provided: s.markets.size,
+            domains_provided: s.domains.size,
+            domains_json: Array.from(s.domains).sort(),
+            active_days: s.active_days.size,
+            roi_pct,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=lifetime.js.map

package/dist/aggregator/lifetime.js.map

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

package/dist/aggregator/roi.d.ts

@@ -0,0 +1,42 @@
+/**
+ * ROI distribution + summary builder.
+ *
+ * Builds two outputs per (domain_slug, entity_type):
+ *   - roi_distribution: bucketed histogram (e.g. -100..-50, -50..-20, ..., 100..200, 200+)
+ *   - roi_summary:     count of users with positive ROI, percentiles (p25/p50/p75/p90), mean
+ *
+ * "Positive ROI" = roi_pct > 0. Users with NULL roi_pct (no capital ever
+ * deployed) are excluded from both the distribution and the summary.
+ *
+ * Per-domain rows are emitted by attributing each user to every domain they
+ * touched (not just primary). The 'all' bucket is the un-segmented total.
+ */
+import type { LPLifetimeRow, TraderLifetimeRow } from './lifetime';
+export interface RoiDistRow {
+    readonly domain_slug: string;
+    readonly entity_type: 'trader' | 'lp';
+    readonly bucket_index: number;
+    readonly bucket_lower_pct: number;
+    readonly bucket_upper_pct: number;
+    readonly user_count: number;
+}
+export interface RoiSummaryRow {
+    readonly domain_slug: string;
+    readonly entity_type: 'trader' | 'lp';
+    readonly total_users: number;
+    readonly positive_roi_users: number;
+    readonly positive_roi_pct: number;
+    readonly median_roi_pct: number | null;
+    readonly p25_roi_pct: number | null;
+    readonly p75_roi_pct: number | null;
+    readonly p90_roi_pct: number | null;
+    readonly mean_roi_pct: number | null;
+}
+interface BuildOutput {
+    readonly distribution: readonly RoiDistRow[];
+    readonly summary: readonly RoiSummaryRow[];
+}
+export declare function buildRoi(traderLifetime: readonly TraderLifetimeRow[], lpLifetime: readonly LPLifetimeRow[]): BuildOutput;
+export declare function writeRoi(pg: import('bun').SQL, out: BuildOutput): Promise<void>;
+export {};
+//# sourceMappingURL=roi.d.ts.map

package/dist/aggregator/roi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roi.d.ts","sourceRoot":"","sources":["../../src/aggregator/roi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AA4CD,UAAU,WAAW;IACnB,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAED,wBAAgB,QAAQ,CACtB,cAAc,EAAE,SAAS,iBAAiB,EAAE,EAC5C,UAAU,EAAE,SAAS,aAAa,EAAE,GACnC,WAAW,CAqFb;AAED,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,OAAO,KAAK,EAAE,GAAG,EACrB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAgCf"}