@the-situation/indexer 0.17.1 → 0.18.0

package/dist/warehouse/analytics-helpers.js

@@ -0,0 +1,142 @@
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const SLUG_RE = /^[a-z][a-z0-9_-]*$/;
+export function parseNumeric(raw) {
+    if (raw == null)
+        return null;
+    if (typeof raw === 'number') {
+        return Number.isFinite(raw) ? raw : null;
+    }
+    if (typeof raw === 'string') {
+        const trimmed = raw.trim();
+        if (trimmed.length === 0)
+            return null;
+        const v = Number(trimmed);
+        return Number.isFinite(v) ? v : null;
+    }
+    if (typeof raw === 'bigint') {
+        const v = Number(raw);
+        return Number.isFinite(v) ? v : null;
+    }
+    return null;
+}
+export function parseAnalyticsFilters(q) {
+    let domain;
+    if (q.domain == null || q.domain === '') {
+        domain = 'all';
+    }
+    else if (typeof q.domain !== 'string') {
+        throw new Error('domain must be a string');
+    }
+    else {
+        domain = q.domain.toLowerCase();
+        if (domain !== 'all' && !SLUG_RE.test(domain)) {
+            throw new Error(`Invalid domain slug: ${q.domain}`);
+        }
+    }
+    const from = parseDateOrNull(q.from, 'from');
+    const to = parseDateOrNull(q.to, 'to');
+    if (from && to && from > to) {
+        throw new Error(`Invalid window: from (${from}) is after to (${to})`);
+    }
+    return { domain, from, to };
+}
+function parseDateOrNull(raw, name) {
+    if (raw == null || raw === '')
+        return null;
+    if (typeof raw !== 'string') {
+        throw new Error(`${name} must be a string YYYY-MM-DD`);
+    }
+    if (!ISO_DATE_RE.test(raw)) {
+        throw new Error(`${name} must match YYYY-MM-DD (got "${raw}")`);
+    }
+    // Validate calendar correctness — Date.parse accepts overflow in some impls
+    const ms = Date.parse(`${raw}T00:00:00Z`);
+    if (!Number.isFinite(ms)) {
+        throw new Error(`Invalid date: ${raw}`);
+    }
+    return raw;
+}
+/**
+ * First week_offset in the cohort where retentionPct strictly drops below 50%.
+ * Returns null if the cohort never reaches half-life within its observed window.
+ *
+ * Performance: O(N log N) once for the sort. Cohorts are small (typically < 100
+ * weeks of observations), so this is negligible.
+ */
+export function computeCohortHalfLife(cohort) {
+    if (cohort.retention.length === 0)
+        return null;
+    const sorted = [...cohort.retention].sort((a, b) => a.weekOffset - b.weekOffset);
+    for (const r of sorted) {
+        if (r.retentionPct < 50)
+            return r.weekOffset;
+    }
+    return null;
+}
+export function shapeCohortRows(rows) {
+    // Group by cohort_week.
+    const grouped = new Map();
+    for (const row of rows) {
+        const week = toDateString(row.cohort_week);
+        let bucket = grouped.get(week);
+        if (!bucket) {
+            bucket = { cohortSize: row.cohort_size, retention: [] };
+            grouped.set(week, bucket);
+        }
+        // Cohort size should be constant across rows for the same cohort; defend
+        // against drift by taking the max (paranoid).
+        if (row.cohort_size > bucket.cohortSize) {
+            bucket.cohortSize = row.cohort_size;
+        }
+        const pct = bucket.cohortSize > 0 ? (row.retained / bucket.cohortSize) * 100 : 0;
+        bucket.retention.push({
+            weekOffset: row.week_offset,
+            retained: row.retained,
+            retentionPct: pct,
+        });
+    }
+    const out = [];
+    for (const [week, bucket] of grouped) {
+        bucket.retention.sort((a, b) => a.weekOffset - b.weekOffset);
+        out.push({
+            cohortWeek: week,
+            cohortSize: bucket.cohortSize,
+            retention: bucket.retention,
+        });
+    }
+    // Newest cohorts first
+    out.sort((a, b) => (a.cohortWeek > b.cohortWeek ? -1 : 1));
+    return out;
+}
+export function toDateString(value) {
+    if (value == null)
+        return '';
+    if (typeof value === 'string') {
+        // Postgres DATE comes back as 'YYYY-MM-DD' string — passthrough.
+        if (ISO_DATE_RE.test(value))
+            return value;
+        // Some drivers return a Date as ISO string.
+        return value.slice(0, 10);
+    }
+    const yyyy = value.getUTCFullYear();
+    const mm = String(value.getUTCMonth() + 1).padStart(2, '0');
+    const dd = String(value.getUTCDate()).padStart(2, '0');
+    return `${yyyy}-${mm}-${dd}`;
+}
+export function dateToUnixSeconds(value) {
+    if (value == null)
+        return null;
+    if (value instanceof Date) {
+        return Math.floor(value.getTime() / 1000);
+    }
+    const ms = Date.parse(value);
+    if (!Number.isFinite(ms))
+        return null;
+    return Math.floor(ms / 1000);
+}
+export function parseEntityType(raw) {
+    if (raw === 'lp')
+        return 'lp';
+    return 'trader';
+}
+//# sourceMappingURL=analytics-helpers.js.map

package/dist/warehouse/analytics-helpers.js.map

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

package/dist/warehouse/backfill.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Market → domain backfill.
+ *
+ * Reads `markets.category` and `markets.topics` from the SQLite OLTP store and
+ * writes a `market_domains` row for each (market, domain) pair into Postgres.
+ *
+ * Behaviour:
+ *  - For each market, classify category + each topic via `classifyTopic`.
+ *  - Deduplicate domain slugs.
+ *  - Always insert at least one row per market — falls back to `other` when
+ *    no rule matches.
+ *  - The first slug found becomes the primary; subsequent slugs are secondary.
+ *  - `source = 'auto'` for backfilled rows. Manual admin assignments use
+ *    `source = 'manual'` and are NEVER overwritten by this job.
+ *
+ * Safe to re-run: only auto-assigned rows are touched. Manual overrides survive.
+ */
+import type { SQL } from 'bun';
+import type { Database as SqliteDatabase } from 'bun:sqlite';
+export interface BackfillResult {
+    readonly markets: number;
+    readonly assignments: number;
+    readonly fallbacks: number;
+}
+export declare function backfillMarketDomains(sqlite: SqliteDatabase, pg: SQL): Promise<BackfillResult>;
+//# sourceMappingURL=backfill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backfill.d.ts","sourceRoot":"","sources":["../../src/warehouse/backfill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,YAAY,CAAC;AAS7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,EAAE,EAAE,GAAG,GACN,OAAO,CAAC,cAAc,CAAC,CAkDzB"}

package/dist/warehouse/backfill.js

@@ -0,0 +1,77 @@
+import { classifyTopic } from './seed-domains';
+export async function backfillMarketDomains(sqlite, pg) {
+    const rows = sqlite
+        .query('SELECT address, category, topics FROM markets')
+        .all();
+    let assignmentCount = 0;
+    let fallbackCount = 0;
+    for (const market of rows) {
+        const slugs = collectSlugs(market);
+        if (slugs.length === 0) {
+            slugs.push('other');
+            fallbackCount += 1;
+        }
+        // Drop existing auto rows for this market — manual assignments stay.
+        await pg `
+      DELETE FROM market_domains
+      WHERE market_address = ${market.address} AND source = 'auto'
+    `;
+        const existingManual = await pg `
+      SELECT domain_slug, is_primary FROM market_domains
+      WHERE market_address = ${market.address} AND source = 'manual'
+    `;
+        const manualSlugs = new Set(existingManual.map((r) => r.domain_slug));
+        const hasManualPrimary = existingManual.some((r) => r.is_primary);
+        let primaryAssigned = hasManualPrimary;
+        for (const slug of slugs) {
+            if (manualSlugs.has(slug)) {
+                // Already manually set; skip.
+                continue;
+            }
+            const isPrimary = !primaryAssigned;
+            primaryAssigned = primaryAssigned || isPrimary;
+            await pg `
+        INSERT INTO market_domains (market_address, domain_slug, is_primary, source, assigned_at)
+        VALUES (${market.address}, ${slug}, ${isPrimary}, 'auto', now())
+        ON CONFLICT (market_address, domain_slug) DO NOTHING
+      `;
+            assignmentCount += 1;
+        }
+    }
+    return {
+        markets: rows.length,
+        assignments: assignmentCount,
+        fallbacks: fallbackCount,
+    };
+}
+function collectSlugs(market) {
+    const slugs = [];
+    const seen = new Set();
+    const candidates = [];
+    if (market.category && market.category.trim().length > 0) {
+        candidates.push(market.category);
+    }
+    try {
+        const topics = JSON.parse(market.topics);
+        for (const t of topics) {
+            if (typeof t === 'string' && t.trim().length > 0) {
+                candidates.push(t);
+            }
+        }
+    }
+    catch {
+        // ignore malformed topics JSON
+    }
+    for (const candidate of candidates) {
+        const slug = classifyTopic(candidate);
+        if (slug === 'other') {
+            continue;
+        }
+        if (!seen.has(slug)) {
+            seen.add(slug);
+            slugs.push(slug);
+        }
+    }
+    return slugs;
+}
+//# sourceMappingURL=backfill.js.map

package/dist/warehouse/backfill.js.map

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

package/dist/warehouse/connection.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Postgres warehouse connection (Bun.sql).
+ *
+ * The warehouse holds derived analytics tables (domains, daily fact tables,
+ * cohort retention, ROI distributions) that are populated by the aggregator
+ * job from the SQLite OLTP store. SQLite remains the source of truth for raw
+ * events; Postgres is the OLAP layer.
+ *
+ * Bun.sql is the project standard (see CLAUDE.md). Do not introduce `pg` or
+ * `postgres.js`.
+ */
+import { SQL } from 'bun';
+export interface Warehouse {
+    readonly sql: SQL;
+    readonly close: () => Promise<void>;
+}
+export declare function createWarehouse(url: string): Promise<Warehouse>;
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/warehouse/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAUrE"}

package/dist/warehouse/connection.js

@@ -0,0 +1,24 @@
+/**
+ * Postgres warehouse connection (Bun.sql).
+ *
+ * The warehouse holds derived analytics tables (domains, daily fact tables,
+ * cohort retention, ROI distributions) that are populated by the aggregator
+ * job from the SQLite OLTP store. SQLite remains the source of truth for raw
+ * events; Postgres is the OLAP layer.
+ *
+ * Bun.sql is the project standard (see CLAUDE.md). Do not introduce `pg` or
+ * `postgres.js`.
+ */
+import { SQL } from 'bun';
+export async function createWarehouse(url) {
+    const sql = new SQL(url);
+    // Ping to fail fast on bad credentials / unreachable host.
+    await sql `SELECT 1`;
+    return {
+        sql,
+        close: async () => {
+            await sql.end();
+        },
+    };
+}
+//# sourceMappingURL=connection.js.map

package/dist/warehouse/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/warehouse/connection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAO1B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,2DAA2D;IAC3D,MAAM,GAAG,CAAA,UAAU,CAAC;IACpB,OAAO;QACL,GAAG;QACH,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/warehouse/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Warehouse barrel export.
+ *
+ * The warehouse is the Postgres OLAP layer that sits next to the SQLite OLTP
+ * store. It holds derived analytics tables (domains, daily fact tables,
+ * lifetime/CLTV, cohort retention, ROI distributions). All writes flow through
+ * the aggregator job; reads are exposed via `/api/analytics/*` and via the
+ * domain/time-window-filtered variants of `/api/rankings` and `/api/positions/:trader/stats`.
+ */
+export { createWarehouse, type Warehouse } from './connection';
+export { initializeWarehouseSchema } from './schema';
+export { CANONICAL_DOMAINS, classifyTopic, seedCanonicalDomains, type CanonicalDomain, } from './seed-domains';
+export { backfillMarketDomains, type BackfillResult } from './backfill';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/warehouse/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/warehouse/index.js

@@ -0,0 +1,14 @@
+/**
+ * Warehouse barrel export.
+ *
+ * The warehouse is the Postgres OLAP layer that sits next to the SQLite OLTP
+ * store. It holds derived analytics tables (domains, daily fact tables,
+ * lifetime/CLTV, cohort retention, ROI distributions). All writes flow through
+ * the aggregator job; reads are exposed via `/api/analytics/*` and via the
+ * domain/time-window-filtered variants of `/api/rankings` and `/api/positions/:trader/stats`.
+ */
+export { createWarehouse } from './connection';
+export { initializeWarehouseSchema } from './schema';
+export { CANONICAL_DOMAINS, classifyTopic, seedCanonicalDomains, } from './seed-domains';
+export { backfillMarketDomains } from './backfill';
+//# sourceMappingURL=index.js.map

package/dist/warehouse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/warehouse/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,eAAe,EAAkB,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GAErB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAuB,MAAM,YAAY,CAAC"}

package/dist/warehouse/repositories/analytics.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Analytics warehouse repository.
+ *
+ * All `/api/analytics/*` routes go through this single class. Each method
+ * takes a parsed/validated AnalyticsFilters and returns a public response
+ * shape. Methods are async (Bun.sql is async).
+ *
+ * Performance:
+ *  - Indexed lookups everywhere: see warehouse/schema.ts for column-coverage.
+ *  - The "top traders by domain" and "leaderboard with time-window" queries
+ *    can be expensive on the daily fact tables. We rely on
+ *    idx_daily_trader_stats_domain_date (covering filter + sort prefix) and
+ *    idx_trader_lifetime_pnl. With ~10k–100k traders this is sub-100ms.
+ *  - All NUMERIC columns return as strings; we coerce to JS number at the
+ *    boundary via `parseNumeric` to keep the public API plain numbers.
+ *
+ * Memory:
+ *  - We never SELECT the entire fact table — every public method has a LIMIT
+ *    clause or aggregates by date.
+ *  - Per-domain rollups for the overview endpoint sum directly in SQL; we
+ *    don't ship per-trader rows back to JS.
+ */
+import type { SQL } from 'bun';
+import type { AnalyticsFilters, AnalyticsLeaderboardResponse, AnalyticsOverviewResponse, CohortsResponse, DomainDetailResponse, DomainsResponse, EntityType, RoiResponse, TraderAnalyticsResponse } from '../../types/analytics';
+export interface AnalyticsRepository {
+    getOverview(): Promise<AnalyticsOverviewResponse>;
+    getDomains(): Promise<DomainsResponse>;
+    getDomainDetail(slug: string): Promise<DomainDetailResponse | null>;
+    getCohorts(filters: {
+        entityType: EntityType;
+        domain: string;
+    }): Promise<CohortsResponse>;
+    getRoi(filters: {
+        entityType: EntityType;
+        domain: string;
+    }): Promise<RoiResponse>;
+    getLeaderboard(filters: AnalyticsFilters & {
+        limit: number;
+    }): Promise<AnalyticsLeaderboardResponse>;
+    getTraderAnalytics(trader: string): Promise<TraderAnalyticsResponse>;
+}
+export declare class PgAnalyticsRepository implements AnalyticsRepository {
+    private readonly sql;
+    constructor(sql: SQL);
+    getOverview(): Promise<AnalyticsOverviewResponse>;
+    getDomains(): Promise<DomainsResponse>;
+    getDomainDetail(slug: string): Promise<DomainDetailResponse | null>;
+    getCohorts(filters: {
+        entityType: EntityType;
+        domain: string;
+    }): Promise<CohortsResponse>;
+    getRoi(filters: {
+        entityType: EntityType;
+        domain: string;
+    }): Promise<RoiResponse>;
+    getLeaderboard(filters: AnalyticsFilters & {
+        limit: number;
+    }): Promise<AnalyticsLeaderboardResponse>;
+    getTraderAnalytics(trader: string): Promise<TraderAnalyticsResponse>;
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/warehouse/repositories/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/warehouse/repositories/analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,KAAK,EACV,gBAAgB,EAEhB,4BAA4B,EAC5B,yBAAyB,EACzB,eAAe,EACf,oBAAoB,EAEpB,eAAe,EACf,UAAU,EACV,WAAW,EACX,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAS/B,MAAM,WAAW,mBAAmB;IAClC,WAAW,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAClD,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IACvC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IACpE,UAAU,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1F,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClF,cAAc,CACZ,OAAO,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACzC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;CACtE;AAED,qBAAa,qBAAsB,YAAW,mBAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAE/B,WAAW,IAAI,OAAO,CAAC,yBAAyB,CAAC;IA2EjD,UAAU,IAAI,OAAO,CAAC,eAAe,CAAC;IA2DtC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAmFnE,UAAU,CAAC,OAAO,EAAE;QACxB,UAAU,EAAE,UAAU,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,eAAe,CAAC;IAiCtB,MAAM,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAmDjF,cAAc,CAClB,OAAO,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,4BAA4B,CAAC;IAyHlC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;CA+G3E"}