@the-situation/indexer 0.17.1 → 0.18.0

package/dist/warehouse/repositories/analytics.js

@@ -0,0 +1,418 @@
+import { computeCohortHalfLife, dateToUnixSeconds, parseNumeric, shapeCohortRows, toDateString, } from '../analytics-helpers';
+export class PgAnalyticsRepository {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    async getOverview() {
+        const [totals] = (await this.sql `
+      SELECT
+        (SELECT COUNT(*) FROM trader_lifetime) AS traders,
+        (SELECT COUNT(*) FROM lp_lifetime) AS lps,
+        (SELECT COALESCE(SUM(total_trades), 0) FROM trader_lifetime) AS trades,
+        (SELECT COALESCE(SUM(total_volume), 0) FROM trader_lifetime) AS volume,
+        (SELECT COUNT(DISTINCT market_address) FROM daily_market_stats) AS active_markets
+    `);
+        const [posRoi] = (await this.sql `
+      SELECT total_users, positive_roi_pct
+      FROM roi_summary
+      WHERE domain_slug = 'all' AND entity_type = 'trader'
+    `);
+        const sevenDaysAgo = new Date(Date.now() - 7 * 86_400_000)
+            .toISOString()
+            .slice(0, 10);
+        const [newUsers] = (await this.sql `
+      SELECT
+        COALESCE(SUM(new_traders), 0) AS new_traders,
+        COALESCE(SUM(new_lps), 0) AS new_lps
+      FROM daily_platform_stats
+      WHERE date >= ${sevenDaysAgo}::date
+    `);
+        const top = (await this.sql `
+      SELECT
+        d.slug, d.name,
+        COALESCE(SUM(s.volume_collateral), 0) AS volume,
+        COALESCE(SUM(s.trade_count), 0) AS trades,
+        COALESCE(MAX(s.unique_traders), 0) AS unique_traders
+      FROM domains d
+      LEFT JOIN daily_domain_stats s ON s.domain_slug = d.slug
+      WHERE d.slug <> 'other' OR EXISTS (SELECT 1 FROM daily_domain_stats x WHERE x.domain_slug = 'other')
+      GROUP BY d.slug, d.name
+      ORDER BY volume DESC
+      LIMIT 10
+    `);
+        return {
+            totals: {
+                traders: totals?.traders ?? 0,
+                lps: totals?.lps ?? 0,
+                trades: parseNumeric(totals?.trades ?? 0) ?? 0,
+                volume: parseNumeric(totals?.volume ?? 0) ?? 0,
+                activeMarkets: totals?.active_markets ?? 0,
+            },
+            positiveRoiPct: parseNumeric(posRoi?.positive_roi_pct) ?? 0,
+            newTradersLast7d: parseNumeric(newUsers?.new_traders) ?? 0,
+            newLpsLast7d: parseNumeric(newUsers?.new_lps) ?? 0,
+            topDomainsByVolume: top.map((r) => ({
+                slug: r.slug,
+                name: r.name,
+                volume: parseNumeric(r.volume) ?? 0,
+                trades: parseNumeric(r.trades) ?? 0,
+                uniqueTraders: parseNumeric(r.unique_traders) ?? 0,
+            })),
+            computedAt: new Date().toISOString(),
+        };
+    }
+    async getDomains() {
+        const rows = (await this.sql `
+      SELECT
+        d.slug,
+        d.name,
+        d.description,
+        COALESCE(md.active_markets, 0) AS active_markets,
+        COALESCE(s.unique_traders, 0) AS unique_traders,
+        COALESCE(s.unique_lps, 0) AS unique_lps,
+        COALESCE(s.total_volume, 0) AS total_volume,
+        COALESCE(s.total_trades, 0) AS total_trades,
+        COALESCE(r.positive_roi_pct, 0) AS positive_roi_pct,
+        r.median_roi_pct
+      FROM domains d
+      LEFT JOIN (
+        SELECT domain_slug,
+               SUM(volume_collateral) AS total_volume,
+               SUM(trade_count) AS total_trades,
+               MAX(unique_traders) AS unique_traders,
+               MAX(unique_lps) AS unique_lps
+        FROM daily_domain_stats
+        GROUP BY domain_slug
+      ) s ON s.domain_slug = d.slug
+      LEFT JOIN (
+        SELECT domain_slug, COUNT(DISTINCT market_address) AS active_markets
+        FROM market_domains
+        GROUP BY domain_slug
+      ) md ON md.domain_slug = d.slug
+      LEFT JOIN roi_summary r ON r.domain_slug = d.slug AND r.entity_type = 'trader'
+      ORDER BY d.sort_order ASC, d.slug ASC
+    `);
+        const domains = rows.map((r) => ({
+            slug: r.slug,
+            name: r.name,
+            description: r.description,
+            activeMarkets: r.active_markets,
+            uniqueTraders: parseNumeric(r.unique_traders) ?? 0,
+            uniqueLps: parseNumeric(r.unique_lps) ?? 0,
+            totalVolume: parseNumeric(r.total_volume) ?? 0,
+            totalTrades: parseNumeric(r.total_trades) ?? 0,
+            positiveRoiPct: parseNumeric(r.positive_roi_pct) ?? 0,
+            medianRoiPct: parseNumeric(r.median_roi_pct),
+        }));
+        return { domains };
+    }
+    async getDomainDetail(slug) {
+        const summaries = await this.getDomains();
+        const summary = summaries.domains.find((d) => d.slug === slug);
+        if (!summary)
+            return null;
+        const ts = (await this.sql `
+      SELECT date, trade_count, volume_collateral, unique_traders, unique_lps, liquidity_net
+      FROM daily_domain_stats
+      WHERE domain_slug = ${slug}
+      ORDER BY date ASC
+    `);
+        const topTraders = (await this.sql `
+      SELECT
+        t.trader,
+        t.total_pnl,
+        t.total_trades,
+        t.total_volume,
+        t.roi_pct
+      FROM trader_lifetime t
+      WHERE t.domains_json @> ${JSON.stringify([slug])}::jsonb
+      ORDER BY t.total_pnl DESC NULLS LAST
+      LIMIT 25
+    `);
+        const topMarkets = (await this.sql `
+      SELECT
+        m.market_address,
+        SUM(m.volume_collateral) AS volume,
+        SUM(m.trade_count) AS trades,
+        MAX(m.unique_traders) AS unique_traders
+      FROM daily_market_stats m
+      JOIN market_domains md ON md.market_address = m.market_address
+      WHERE md.domain_slug = ${slug}
+      GROUP BY m.market_address
+      ORDER BY volume DESC
+      LIMIT 25
+    `);
+        return {
+            ...summary,
+            timeSeries: ts.map((r) => ({
+                date: toDateString(r.date),
+                trades: parseNumeric(r.trade_count) ?? 0,
+                volume: parseNumeric(r.volume_collateral) ?? 0,
+                uniqueTraders: parseNumeric(r.unique_traders) ?? 0,
+                uniqueLps: parseNumeric(r.unique_lps) ?? 0,
+                liquidityNet: parseNumeric(r.liquidity_net) ?? 0,
+            })),
+            topTraders: topTraders.map((r) => ({
+                trader: r.trader,
+                totalPnl: parseNumeric(r.total_pnl) ?? 0,
+                totalTrades: r.total_trades,
+                volume: parseNumeric(r.total_volume) ?? 0,
+                roiPct: parseNumeric(r.roi_pct),
+            })),
+            topMarkets: topMarkets.map((r) => ({
+                marketAddress: r.market_address,
+                volume: parseNumeric(r.volume) ?? 0,
+                trades: parseNumeric(r.trades) ?? 0,
+                uniqueTraders: parseNumeric(r.unique_traders) ?? 0,
+            })),
+        };
+    }
+    async getCohorts(filters) {
+        const rows = (await this.sql `
+      SELECT cohort_week, week_offset, cohort_size, retained
+      FROM cohort_retention
+      WHERE entity_type = ${filters.entityType}
+        AND domain_slug = ${filters.domain}
+      ORDER BY cohort_week ASC, week_offset ASC
+    `);
+        const cohorts = shapeCohortRows(rows);
+        const halfLives = [];
+        for (const c of cohorts) {
+            const hl = computeCohortHalfLife(c);
+            if (hl != null)
+                halfLives.push(hl);
+        }
+        halfLives.sort((a, b) => a - b);
+        const median = halfLives.length === 0
+            ? null
+            : halfLives[Math.floor(halfLives.length / 2)] ?? null;
+        return {
+            entityType: filters.entityType,
+            domain: filters.domain,
+            cohorts,
+            medianHalfLifeWeeks: median,
+        };
+    }
+    async getRoi(filters) {
+        const [summary] = (await this.sql `
+      SELECT total_users, positive_roi_users, positive_roi_pct,
+             median_roi_pct, p25_roi_pct, p75_roi_pct, p90_roi_pct, mean_roi_pct
+      FROM roi_summary
+      WHERE entity_type = ${filters.entityType} AND domain_slug = ${filters.domain}
+    `);
+        const histogram = (await this.sql `
+      SELECT bucket_index, bucket_lower_pct, bucket_upper_pct, user_count
+      FROM roi_distribution
+      WHERE entity_type = ${filters.entityType} AND domain_slug = ${filters.domain}
+      ORDER BY bucket_index ASC
+    `);
+        return {
+            entityType: filters.entityType,
+            domain: filters.domain,
+            summary: {
+                totalUsers: summary?.total_users ?? 0,
+                positiveRoiUsers: summary?.positive_roi_users ?? 0,
+                positiveRoiPct: parseNumeric(summary?.positive_roi_pct) ?? 0,
+                medianRoiPct: parseNumeric(summary?.median_roi_pct ?? null),
+                p25RoiPct: parseNumeric(summary?.p25_roi_pct ?? null),
+                p75RoiPct: parseNumeric(summary?.p75_roi_pct ?? null),
+                p90RoiPct: parseNumeric(summary?.p90_roi_pct ?? null),
+                meanRoiPct: parseNumeric(summary?.mean_roi_pct ?? null),
+            },
+            histogram: histogram.map((b) => ({
+                bucketIndex: b.bucket_index,
+                bucketLowerPct: parseNumeric(b.bucket_lower_pct) ?? 0,
+                bucketUpperPct: parseNumeric(b.bucket_upper_pct) ?? 0,
+                userCount: b.user_count,
+            })),
+        };
+    }
+    async getLeaderboard(filters) {
+        // Two paths: lifetime (no time-window) vs windowed (sums over daily facts).
+        const isWindowed = filters.from != null || filters.to != null;
+        const isDomainAll = filters.domain === 'all';
+        let entries;
+        if (!isWindowed && isDomainAll) {
+            // Fast path — lifetime totals.
+            const rows = (await this.sql `
+        SELECT trader, total_pnl, total_volume, total_trades,
+               markets_traded, domains_traded, roi_pct
+        FROM trader_lifetime
+        ORDER BY total_pnl DESC NULLS LAST
+        LIMIT ${filters.limit}
+      `);
+            entries = rows.map((r, i) => ({
+                rank: i + 1,
+                trader: r.trader,
+                totalPnl: parseNumeric(r.total_pnl) ?? 0,
+                totalVolume: parseNumeric(r.total_volume) ?? 0,
+                totalTrades: r.total_trades,
+                marketsTraded: r.markets_traded,
+                domainsTraded: r.domains_traded,
+                roiPct: parseNumeric(r.roi_pct),
+            }));
+        }
+        else if (!isWindowed && !isDomainAll) {
+            // Domain filter, lifetime — use daily_trader_stats to filter, then join lifetime.
+            const rows = (await this.sql `
+        SELECT
+          t.trader,
+          t.total_pnl,
+          SUM(s.volume_collateral) AS total_volume,
+          SUM(s.trade_count) AS total_trades,
+          COUNT(DISTINCT s.date) AS active_days,
+          t.markets_traded,
+          t.domains_traded,
+          t.roi_pct
+        FROM daily_trader_stats s
+        JOIN trader_lifetime t ON t.trader = s.trader
+        WHERE s.domain_slug = ${filters.domain}
+        GROUP BY t.trader, t.total_pnl, t.markets_traded, t.domains_traded, t.roi_pct
+        ORDER BY t.total_pnl DESC NULLS LAST
+        LIMIT ${filters.limit}
+      `);
+            entries = rows.map((r, i) => ({
+                rank: i + 1,
+                trader: r.trader,
+                totalPnl: parseNumeric(r.total_pnl) ?? 0,
+                totalVolume: parseNumeric(r.total_volume) ?? 0,
+                totalTrades: parseNumeric(r.total_trades) ?? 0,
+                marketsTraded: r.markets_traded,
+                domainsTraded: r.domains_traded,
+                roiPct: parseNumeric(r.roi_pct),
+            }));
+        }
+        else {
+            // Windowed — sum daily facts within (from, to). Per-trader P&L isn't
+            // computable from daily facts (no per-day P&L bucket), so we sort by
+            // windowed VOLUME and report the trader's lifetime P&L alongside.
+            const rows = (await this.sql `
+        SELECT
+          s.trader,
+          SUM(s.volume_collateral) AS total_volume,
+          SUM(s.trade_count) AS total_trades,
+          COALESCE(t.total_pnl, 0) AS total_pnl,
+          t.roi_pct AS roi_pct,
+          COALESCE(t.markets_traded, 0) AS markets_traded,
+          COALESCE(t.domains_traded, 0) AS domains_traded
+        FROM daily_trader_stats s
+        LEFT JOIN trader_lifetime t ON t.trader = s.trader
+        WHERE (${filters.domain}::text = 'all' OR s.domain_slug = ${filters.domain})
+          AND (${filters.from}::date IS NULL OR s.date >= ${filters.from}::date)
+          AND (${filters.to}::date IS NULL OR s.date < ${filters.to}::date)
+        GROUP BY s.trader, t.total_pnl, t.roi_pct, t.markets_traded, t.domains_traded
+        ORDER BY total_volume DESC
+        LIMIT ${filters.limit}
+      `);
+            entries = rows.map((r, i) => ({
+                rank: i + 1,
+                trader: r.trader,
+                totalPnl: parseNumeric(r.total_pnl) ?? 0,
+                totalVolume: parseNumeric(r.total_volume) ?? 0,
+                totalTrades: parseNumeric(r.total_trades) ?? 0,
+                marketsTraded: r.markets_traded,
+                domainsTraded: r.domains_traded,
+                roiPct: parseNumeric(r.roi_pct),
+            }));
+        }
+        return {
+            entries,
+            domain: filters.domain,
+            windowFrom: filters.from,
+            windowTo: filters.to,
+        };
+    }
+    async getTraderAnalytics(trader) {
+        const traderLower = trader.toLowerCase();
+        const [lifetime] = (await this.sql `
+      SELECT trader, first_trade_at, last_trade_at, cohort_week,
+             total_trades, buy_count, sell_count, markets_traded,
+             domains_traded, domains_json, total_volume, total_collateral_at_risk,
+             realized_pnl, unrealized_pnl, total_pnl, roi_pct, active_days
+      FROM trader_lifetime
+      WHERE LOWER(trader) = ${traderLower}
+    `);
+        const perDomain = (await this.sql `
+      SELECT
+        s.domain_slug AS slug,
+        d.name,
+        SUM(s.trade_count) AS trade_count,
+        SUM(s.volume_collateral) AS volume,
+        MAX(s.markets_traded) AS markets_traded,
+        COUNT(DISTINCT s.date) AS days_active
+      FROM daily_trader_stats s
+      JOIN domains d ON d.slug = s.domain_slug
+      WHERE LOWER(s.trader) = ${traderLower}
+      GROUP BY s.domain_slug, d.name, d.sort_order
+      ORDER BY d.sort_order ASC
+    `);
+        let cohort = null;
+        if (lifetime?.cohort_week) {
+            const cohortWeek = toDateString(lifetime.cohort_week);
+            const cohortRows = (await this.sql `
+        SELECT cohort_week, week_offset, cohort_size, retained
+        FROM cohort_retention
+        WHERE entity_type = 'trader' AND domain_slug = 'all'
+          AND cohort_week = ${cohortWeek}::date
+        ORDER BY week_offset ASC
+      `);
+            const shaped = shapeCohortRows(cohortRows);
+            const halfLife = shaped[0] ? computeCohortHalfLife(shaped[0]) : null;
+            const latest = cohortRows[cohortRows.length - 1];
+            cohort = {
+                cohortWeek,
+                halfLifeWeeks: halfLife,
+                cohortSize: cohortRows[0]?.cohort_size ?? null,
+                retainedThisWeek: latest?.retained ?? null,
+            };
+        }
+        return {
+            trader,
+            lifetime: lifetime
+                ? {
+                    firstTradeAt: dateToUnixSeconds(lifetime.first_trade_at),
+                    lastTradeAt: dateToUnixSeconds(lifetime.last_trade_at),
+                    cohortWeek: lifetime.cohort_week ? toDateString(lifetime.cohort_week) : null,
+                    totalTrades: lifetime.total_trades,
+                    buyCount: lifetime.buy_count,
+                    sellCount: lifetime.sell_count,
+                    marketsTraded: lifetime.markets_traded,
+                    domainsTraded: lifetime.domains_traded,
+                    domains: parseDomainsJson(lifetime.domains_json),
+                    totalVolume: parseNumeric(lifetime.total_volume) ?? 0,
+                    totalCollateralAtRisk: parseNumeric(lifetime.total_collateral_at_risk) ?? 0,
+                    realizedPnl: parseNumeric(lifetime.realized_pnl) ?? 0,
+                    unrealizedPnl: parseNumeric(lifetime.unrealized_pnl) ?? 0,
+                    totalPnl: parseNumeric(lifetime.total_pnl) ?? 0,
+                    roiPct: parseNumeric(lifetime.roi_pct),
+                    activeDays: lifetime.active_days,
+                }
+                : null,
+            perDomain: perDomain.map((r) => ({
+                slug: r.slug,
+                name: r.name,
+                tradeCount: parseNumeric(r.trade_count) ?? 0,
+                volume: parseNumeric(r.volume) ?? 0,
+                marketsTraded: parseNumeric(r.markets_traded) ?? 0,
+                daysActive: parseNumeric(r.days_active) ?? 0,
+            })),
+            cohort,
+        };
+    }
+}
+function parseDomainsJson(raw) {
+    if (Array.isArray(raw))
+        return raw;
+    if (typeof raw === 'string') {
+        try {
+            const parsed = JSON.parse(raw);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    return [];
+}
+//# sourceMappingURL=analytics.js.map

package/dist/warehouse/repositories/analytics.js.map

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

package/dist/warehouse/schema.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Warehouse DDL — domain taxonomy + analytics fact / lifetime / cohort / ROI tables.
+ *
+ * Idempotent: safe to run on every boot. Postgres handles `IF NOT EXISTS` cleanly,
+ * so this acts as both initial creation and a lightweight migration runner.
+ */
+import type { SQL } from 'bun';
+export declare function initializeWarehouseSchema(sql: SQL): Promise<void>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/warehouse/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/warehouse/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AA8O/B,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}

package/dist/warehouse/schema.js

@@ -0,0 +1,219 @@
+const SCHEMA_DDL = [
+    // ──────────────────────────────────────────────────────────────────────
+    // Domains — canonical taxonomy
+    // ──────────────────────────────────────────────────────────────────────
+    `CREATE TABLE IF NOT EXISTS domains (
+    slug         TEXT PRIMARY KEY,
+    name         TEXT NOT NULL,
+    description  TEXT NOT NULL DEFAULT '',
+    sort_order   INTEGER NOT NULL DEFAULT 0,
+    created_at   TIMESTAMPTZ NOT NULL DEFAULT now(),
+    updated_at   TIMESTAMPTZ NOT NULL DEFAULT now()
+  )`,
+    `CREATE TABLE IF NOT EXISTS market_domains (
+    market_address  TEXT NOT NULL,
+    domain_slug     TEXT NOT NULL REFERENCES domains(slug) ON DELETE CASCADE,
+    is_primary      BOOLEAN NOT NULL DEFAULT FALSE,
+    source          TEXT NOT NULL DEFAULT 'auto',
+    assigned_at     TIMESTAMPTZ NOT NULL DEFAULT now(),
+    PRIMARY KEY (market_address, domain_slug)
+  )`,
+    `CREATE INDEX IF NOT EXISTS idx_market_domains_domain
+    ON market_domains(domain_slug)`,
+    `CREATE INDEX IF NOT EXISTS idx_market_domains_market
+    ON market_domains(market_address)`,
+    `CREATE UNIQUE INDEX IF NOT EXISTS idx_market_domains_one_primary
+    ON market_domains(market_address) WHERE is_primary`,
+    // ──────────────────────────────────────────────────────────────────────
+    // Daily fact tables — date × dimension × metrics
+    // ──────────────────────────────────────────────────────────────────────
+    `CREATE TABLE IF NOT EXISTS daily_trader_stats (
+    date              DATE NOT NULL,
+    trader            TEXT NOT NULL,
+    domain_slug       TEXT NOT NULL REFERENCES domains(slug),
+    trade_count       INTEGER NOT NULL DEFAULT 0,
+    buy_count         INTEGER NOT NULL DEFAULT 0,
+    sell_count        INTEGER NOT NULL DEFAULT 0,
+    volume_collateral NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    realized_pnl      NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    unrealized_pnl    NUMERIC(38, 6),
+    markets_traded    INTEGER NOT NULL DEFAULT 0,
+    updated_at        TIMESTAMPTZ NOT NULL DEFAULT now(),
+    PRIMARY KEY (date, trader, domain_slug)
+  )`,
+    `CREATE INDEX IF NOT EXISTS idx_daily_trader_stats_trader
+    ON daily_trader_stats(trader, date DESC)`,
+    `CREATE INDEX IF NOT EXISTS idx_daily_trader_stats_domain_date
+    ON daily_trader_stats(domain_slug, date DESC)`,
+    `CREATE TABLE IF NOT EXISTS daily_lp_stats (
+    date              DATE NOT NULL,
+    provider          TEXT NOT NULL,
+    domain_slug       TEXT NOT NULL REFERENCES domains(slug),
+    deposit_count     INTEGER NOT NULL DEFAULT 0,
+    withdraw_count    INTEGER NOT NULL DEFAULT 0,
+    deposited         NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    withdrawn         NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    net_position      NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    unrealized_pnl    NUMERIC(38, 6),
+    markets_active    INTEGER NOT NULL DEFAULT 0,
+    updated_at        TIMESTAMPTZ NOT NULL DEFAULT now(),
+    PRIMARY KEY (date, provider, domain_slug)
+  )`,
+    `CREATE INDEX IF NOT EXISTS idx_daily_lp_stats_provider
+    ON daily_lp_stats(provider, date DESC)`,
+    `CREATE INDEX IF NOT EXISTS idx_daily_lp_stats_domain_date
+    ON daily_lp_stats(domain_slug, date DESC)`,
+    `CREATE TABLE IF NOT EXISTS daily_market_stats (
+    date              DATE NOT NULL,
+    market_address    TEXT NOT NULL,
+    trade_count       INTEGER NOT NULL DEFAULT 0,
+    unique_traders    INTEGER NOT NULL DEFAULT 0,
+    volume_collateral NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    liquidity_added   NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    liquidity_removed NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    unique_lps        INTEGER NOT NULL DEFAULT 0,
+    updated_at        TIMESTAMPTZ NOT NULL DEFAULT now(),
+    PRIMARY KEY (date, market_address)
+  )`,
+    `CREATE INDEX IF NOT EXISTS idx_daily_market_stats_market
+    ON daily_market_stats(market_address, date DESC)`,
+    `CREATE TABLE IF NOT EXISTS daily_domain_stats (
+    date              DATE NOT NULL,
+    domain_slug       TEXT NOT NULL REFERENCES domains(slug),
+    trade_count       INTEGER NOT NULL DEFAULT 0,
+    unique_traders    INTEGER NOT NULL DEFAULT 0,
+    unique_lps        INTEGER NOT NULL DEFAULT 0,
+    volume_collateral NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    liquidity_net     NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    active_markets    INTEGER NOT NULL DEFAULT 0,
+    updated_at        TIMESTAMPTZ NOT NULL DEFAULT now(),
+    PRIMARY KEY (date, domain_slug)
+  )`,
+    `CREATE INDEX IF NOT EXISTS idx_daily_domain_stats_date
+    ON daily_domain_stats(date DESC)`,
+    `CREATE TABLE IF NOT EXISTS daily_platform_stats (
+    date              DATE PRIMARY KEY,
+    trade_count       INTEGER NOT NULL DEFAULT 0,
+    unique_traders    INTEGER NOT NULL DEFAULT 0,
+    unique_lps        INTEGER NOT NULL DEFAULT 0,
+    new_traders       INTEGER NOT NULL DEFAULT 0,
+    new_lps           INTEGER NOT NULL DEFAULT 0,
+    volume_collateral NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    liquidity_net     NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    active_markets    INTEGER NOT NULL DEFAULT 0,
+    updated_at        TIMESTAMPTZ NOT NULL DEFAULT now()
+  )`,
+    // ──────────────────────────────────────────────────────────────────────
+    // Lifetime / CLTV — one row per entity
+    // ──────────────────────────────────────────────────────────────────────
+    `CREATE TABLE IF NOT EXISTS trader_lifetime (
+    trader                   TEXT PRIMARY KEY,
+    first_trade_at           TIMESTAMPTZ,
+    last_trade_at            TIMESTAMPTZ,
+    cohort_week              DATE,
+    total_trades             INTEGER NOT NULL DEFAULT 0,
+    buy_count                INTEGER NOT NULL DEFAULT 0,
+    sell_count               INTEGER NOT NULL DEFAULT 0,
+    markets_traded           INTEGER NOT NULL DEFAULT 0,
+    domains_traded           INTEGER NOT NULL DEFAULT 0,
+    domains_json             JSONB NOT NULL DEFAULT '[]'::jsonb,
+    total_volume             NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    total_collateral_at_risk NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    realized_pnl             NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    unrealized_pnl           NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    total_pnl                NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    roi_pct                  NUMERIC(10, 4),
+    active_days              INTEGER NOT NULL DEFAULT 0,
+    updated_at               TIMESTAMPTZ NOT NULL DEFAULT now()
+  )`,
+    `CREATE INDEX IF NOT EXISTS idx_trader_lifetime_pnl
+    ON trader_lifetime(total_pnl DESC)`,
+    `CREATE INDEX IF NOT EXISTS idx_trader_lifetime_roi
+    ON trader_lifetime(roi_pct DESC NULLS LAST)`,
+    `CREATE INDEX IF NOT EXISTS idx_trader_lifetime_cohort
+    ON trader_lifetime(cohort_week)`,
+    `CREATE INDEX IF NOT EXISTS idx_trader_lifetime_volume
+    ON trader_lifetime(total_volume DESC)`,
+    `CREATE TABLE IF NOT EXISTS lp_lifetime (
+    provider          TEXT PRIMARY KEY,
+    first_deposit_at  TIMESTAMPTZ,
+    last_activity_at  TIMESTAMPTZ,
+    cohort_week       DATE,
+    deposit_count     INTEGER NOT NULL DEFAULT 0,
+    withdraw_count    INTEGER NOT NULL DEFAULT 0,
+    total_deposited   NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    total_withdrawn   NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    net_position      NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    current_value     NUMERIC(38, 6),
+    unrealized_pnl    NUMERIC(38, 6),
+    realized_pnl      NUMERIC(38, 6) NOT NULL DEFAULT 0,
+    markets_provided  INTEGER NOT NULL DEFAULT 0,
+    domains_provided  INTEGER NOT NULL DEFAULT 0,
+    domains_json      JSONB NOT NULL DEFAULT '[]'::jsonb,
+    active_days       INTEGER NOT NULL DEFAULT 0,
+    roi_pct           NUMERIC(10, 4),
+    updated_at        TIMESTAMPTZ NOT NULL DEFAULT now()
+  )`,
+    `CREATE INDEX IF NOT EXISTS idx_lp_lifetime_pnl
+    ON lp_lifetime(unrealized_pnl DESC)`,
+    `CREATE INDEX IF NOT EXISTS idx_lp_lifetime_cohort
+    ON lp_lifetime(cohort_week)`,
+    // ──────────────────────────────────────────────────────────────────────
+    // Cohort retention — week × week_offset × domain
+    // ──────────────────────────────────────────────────────────────────────
+    `CREATE TABLE IF NOT EXISTS cohort_retention (
+    cohort_week     DATE NOT NULL,
+    week_offset     INTEGER NOT NULL,
+    domain_slug     TEXT NOT NULL,
+    entity_type     TEXT NOT NULL,
+    cohort_size     INTEGER NOT NULL,
+    retained        INTEGER NOT NULL,
+    updated_at      TIMESTAMPTZ NOT NULL DEFAULT now(),
+    PRIMARY KEY (cohort_week, week_offset, domain_slug, entity_type)
+  )`,
+    `CREATE INDEX IF NOT EXISTS idx_cohort_retention_lookup
+    ON cohort_retention(domain_slug, entity_type, cohort_week)`,
+    // ──────────────────────────────────────────────────────────────────────
+    // ROI distribution — bucketed histograms + summary stats
+    // ──────────────────────────────────────────────────────────────────────
+    `CREATE TABLE IF NOT EXISTS roi_distribution (
+    domain_slug       TEXT NOT NULL,
+    entity_type       TEXT NOT NULL,
+    bucket_index      INTEGER NOT NULL,
+    bucket_lower_pct  NUMERIC(10, 4) NOT NULL,
+    bucket_upper_pct  NUMERIC(10, 4) NOT NULL,
+    user_count        INTEGER NOT NULL DEFAULT 0,
+    computed_at       TIMESTAMPTZ NOT NULL DEFAULT now(),
+    PRIMARY KEY (domain_slug, entity_type, bucket_index)
+  )`,
+    `CREATE TABLE IF NOT EXISTS roi_summary (
+    domain_slug         TEXT NOT NULL,
+    entity_type         TEXT NOT NULL,
+    total_users         INTEGER NOT NULL DEFAULT 0,
+    positive_roi_users  INTEGER NOT NULL DEFAULT 0,
+    positive_roi_pct    NUMERIC(10, 4) NOT NULL DEFAULT 0,
+    median_roi_pct      NUMERIC(10, 4),
+    p25_roi_pct         NUMERIC(10, 4),
+    p75_roi_pct         NUMERIC(10, 4),
+    p90_roi_pct         NUMERIC(10, 4),
+    mean_roi_pct        NUMERIC(10, 4),
+    computed_at         TIMESTAMPTZ NOT NULL DEFAULT now(),
+    PRIMARY KEY (domain_slug, entity_type)
+  )`,
+    // ──────────────────────────────────────────────────────────────────────
+    // Aggregator bookkeeping
+    // ──────────────────────────────────────────────────────────────────────
+    `CREATE TABLE IF NOT EXISTS aggregator_state (
+    job_name         TEXT PRIMARY KEY,
+    last_event_id    BIGINT NOT NULL DEFAULT 0,
+    last_run_at      TIMESTAMPTZ,
+    last_success_at  TIMESTAMPTZ,
+    last_error       TEXT
+  )`,
+];
+export async function initializeWarehouseSchema(sql) {
+    for (const statement of SCHEMA_DDL) {
+        await sql.unsafe(statement);
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/warehouse/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/warehouse/schema.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,GAAsB;IACpC,yEAAyE;IACzE,+BAA+B;IAC/B,yEAAyE;IACzE;;;;;;;IAOE;IAEF;;;;;;;IAOE;IAEF;mCACiC;IAEjC;sCACoC;IAEpC;uDACqD;IAErD,yEAAyE;IACzE,iDAAiD;IACjD,yEAAyE;IACzE;;;;;;;;;;;;;IAaE;IAEF;6CAC2C;IAC3C;kDACgD;IAEhD;;;;;;;;;;;;;IAaE;IAEF;2CACyC;IACzC;8CAC4C;IAE5C;;;;;;;;;;;IAWE;IAEF;qDACmD;IAEnD;;;;;;;;;;;IAWE;IAEF;qCACmC;IAEnC;;;;;;;;;;;IAWE;IAEF,yEAAyE;IACzE,uCAAuC;IACvC,yEAAyE;IACzE;;;;;;;;;;;;;;;;;;;IAmBE;IAEF;uCACqC;IACrC;gDAC8C;IAC9C;oCACkC;IAClC;0CACwC;IAExC;;;;;;;;;;;;;;;;;;;IAmBE;IAEF;wCACsC;IACtC;gCAC8B;IAE9B,yEAAyE;IACzE,iDAAiD;IACjD,yEAAyE;IACzE;;;;;;;;;IASE;IAEF;+DAC6D;IAE7D,yEAAyE;IACzE,yDAAyD;IACzD,yEAAyE;IACzE;;;;;;;;;IASE;IAEF;;;;;;;;;;;;;IAaE;IAEF,yEAAyE;IACzE,yBAAyB;IACzB,yEAAyE;IACzE;;;;;;IAME;CACH,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,GAAQ;IACtD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}