@the-situation/indexer 0.17.0 → 0.18.0

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"}

package/dist/warehouse/seed-domains.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Canonical domain taxonomy seed.
+ *
+ * The slugs below are the only values analytics queries should group by.
+ * `markets.category` and `markets.topics` (the existing free-form fields in
+ * SQLite) are mapped into these slugs by `backfillMarketDomains`.
+ *
+ * To add a new domain: append to CANONICAL_DOMAINS, run the indexer once.
+ * To remap topics → domain: edit TOPIC_TO_DOMAIN and re-run the backfill.
+ */
+import type { SQL } from 'bun';
+export interface CanonicalDomain {
+    readonly slug: string;
+    readonly name: string;
+    readonly description: string;
+    readonly sortOrder: number;
+}
+export declare const CANONICAL_DOMAINS: readonly CanonicalDomain[];
+/**
+ * Map a free-form topic or category string to a canonical domain slug.
+ * Returns 'other' if no rule matches.
+ */
+export declare function classifyTopic(raw: string): string;
+/**
+ * Insert canonical domains, idempotent. Updates name/description/sort_order
+ * if a slug already exists.
+ */
+export declare function seedCanonicalDomains(sql: SQL): Promise<void>;
+//# sourceMappingURL=seed-domains.d.ts.map

package/dist/warehouse/seed-domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-domains.d.ts","sourceRoot":"","sources":["../../src/warehouse/seed-domains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAmE9C,CAAC;AAqHX;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkBjD;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlE"}

package/dist/warehouse/seed-domains.js

@@ -0,0 +1,223 @@
+export const CANONICAL_DOMAINS = [
+    {
+        slug: 'politics',
+        name: 'Politics',
+        description: 'Elections, legislation, polls, and policy outcomes.',
+        sortOrder: 10,
+    },
+    {
+        slug: 'economics',
+        name: 'Economics',
+        description: 'Macroeconomic indicators, inflation, GDP, employment, rates.',
+        sortOrder: 20,
+    },
+    {
+        slug: 'crypto',
+        name: 'Crypto',
+        description: 'On-chain metrics, token prices, protocol-level outcomes.',
+        sortOrder: 30,
+    },
+    {
+        slug: 'weather',
+        name: 'Weather & Climate',
+        description: 'Temperature, precipitation, storm tracks, climate indicators.',
+        sortOrder: 40,
+    },
+    {
+        slug: 'sports',
+        name: 'Sports',
+        description: 'Match outcomes, season standings, performance metrics.',
+        sortOrder: 50,
+    },
+    {
+        slug: 'geopolitics',
+        name: 'Geopolitics',
+        description: 'International relations, conflicts, treaties, diplomatic outcomes.',
+        sortOrder: 60,
+    },
+    {
+        slug: 'science',
+        name: 'Science & Tech Research',
+        description: 'Scientific results, peer-reviewed claims, technology breakthroughs.',
+        sortOrder: 70,
+    },
+    {
+        slug: 'technology',
+        name: 'Technology & Industry',
+        description: 'Product launches, company outcomes, industry events.',
+        sortOrder: 80,
+    },
+    {
+        slug: 'culture',
+        name: 'Culture',
+        description: 'Awards, entertainment, social trends, cultural events.',
+        sortOrder: 90,
+    },
+    {
+        slug: 'entertainment',
+        name: 'Entertainment & Media',
+        description: 'Box office, streaming, music charts, media releases.',
+        sortOrder: 100,
+    },
+    {
+        slug: 'other',
+        name: 'Other',
+        description: 'Markets that have not been mapped to a specific domain yet.',
+        sortOrder: 9999,
+    },
+];
+/**
+ * Lowercase substring → canonical slug. The first match wins. Order matters:
+ * put more specific matches first.
+ *
+ * Applied to (a) `markets.category` (lowercased) and (b) each entry in
+ * `markets.topics` (lowercased) — see `backfillMarketDomains`.
+ */
+const TOPIC_TO_DOMAIN = [
+    // ── politics ──
+    ['election', 'politics'],
+    ['president', 'politics'],
+    ['senate', 'politics'],
+    ['congress', 'politics'],
+    ['parliament', 'politics'],
+    ['vote', 'politics'],
+    ['poll', 'politics'],
+    ['republican', 'politics'],
+    ['democrat', 'politics'],
+    ['politic', 'politics'],
+    // ── economics ──
+    ['inflation', 'economics'],
+    ['cpi', 'economics'],
+    ['ppi', 'economics'],
+    ['gdp', 'economics'],
+    ['unemployment', 'economics'],
+    ['jobs', 'economics'],
+    ['payroll', 'economics'],
+    ['fed', 'economics'],
+    ['interest rate', 'economics'],
+    ['fomc', 'economics'],
+    ['recession', 'economics'],
+    ['economic', 'economics'],
+    ['econ', 'economics'],
+    // ── crypto ──
+    ['bitcoin', 'crypto'],
+    ['ethereum', 'crypto'],
+    ['btc', 'crypto'],
+    ['eth', 'crypto'],
+    ['solana', 'crypto'],
+    ['starknet', 'crypto'],
+    ['stablecoin', 'crypto'],
+    ['defi', 'crypto'],
+    ['token', 'crypto'],
+    ['crypto', 'crypto'],
+    // ── weather ──
+    ['hurricane', 'weather'],
+    ['typhoon', 'weather'],
+    ['storm', 'weather'],
+    ['temperature', 'weather'],
+    ['snowfall', 'weather'],
+    ['rainfall', 'weather'],
+    ['climate', 'weather'],
+    ['weather', 'weather'],
+    // ── sports ──
+    ['nba', 'sports'],
+    ['nfl', 'sports'],
+    ['mlb', 'sports'],
+    ['nhl', 'sports'],
+    ['soccer', 'sports'],
+    ['football', 'sports'],
+    ['premier league', 'sports'],
+    ['champions league', 'sports'],
+    ['world cup', 'sports'],
+    ['olympic', 'sports'],
+    ['tennis', 'sports'],
+    ['ufc', 'sports'],
+    ['mma', 'sports'],
+    ['sport', 'sports'],
+    // ── geopolitics ──
+    ['ukraine', 'geopolitics'],
+    ['russia', 'geopolitics'],
+    ['china', 'geopolitics'],
+    ['nato', 'geopolitics'],
+    ['un security', 'geopolitics'],
+    ['ceasefire', 'geopolitics'],
+    ['sanction', 'geopolitics'],
+    ['treaty', 'geopolitics'],
+    ['geopolitic', 'geopolitics'],
+    // ── science ──
+    ['nasa', 'science'],
+    ['spacex', 'science'],
+    ['rocket', 'science'],
+    ['vaccine', 'science'],
+    ['nobel', 'science'],
+    ['physics', 'science'],
+    ['biology', 'science'],
+    ['research', 'science'],
+    ['science', 'science'],
+    // ── technology ──
+    ['ai model', 'technology'],
+    ['gpt', 'technology'],
+    ['claude', 'technology'],
+    ['gemini', 'technology'],
+    ['ipo', 'technology'],
+    ['layoff', 'technology'],
+    ['acquisition', 'technology'],
+    ['apple', 'technology'],
+    ['google', 'technology'],
+    ['microsoft', 'technology'],
+    ['tech', 'technology'],
+    ['technology', 'technology'],
+    // ── culture / entertainment ──
+    ['oscar', 'entertainment'],
+    ['grammy', 'entertainment'],
+    ['emmy', 'entertainment'],
+    ['box office', 'entertainment'],
+    ['netflix', 'entertainment'],
+    ['streaming', 'entertainment'],
+    ['movie', 'entertainment'],
+    ['album', 'entertainment'],
+    ['entertain', 'entertainment'],
+    ['celebrity', 'culture'],
+    ['culture', 'culture'],
+];
+/**
+ * Map a free-form topic or category string to a canonical domain slug.
+ * Returns 'other' if no rule matches.
+ */
+export function classifyTopic(raw) {
+    const lower = raw.toLowerCase().trim();
+    if (lower.length === 0) {
+        return 'other';
+    }
+    // Direct slug match (already canonical)
+    for (const domain of CANONICAL_DOMAINS) {
+        if (lower === domain.slug || lower === domain.name.toLowerCase()) {
+            return domain.slug;
+        }
+    }
+    // Substring rules
+    for (const [needle, slug] of TOPIC_TO_DOMAIN) {
+        if (lower.includes(needle)) {
+            return slug;
+        }
+    }
+    return 'other';
+}
+/**
+ * Insert canonical domains, idempotent. Updates name/description/sort_order
+ * if a slug already exists.
+ */
+export async function seedCanonicalDomains(sql) {
+    for (const domain of CANONICAL_DOMAINS) {
+        await sql `
+      INSERT INTO domains (slug, name, description, sort_order, updated_at)
+      VALUES (${domain.slug}, ${domain.name}, ${domain.description}, ${domain.sortOrder}, now())
+      ON CONFLICT (slug) DO UPDATE SET
+        name = EXCLUDED.name,
+        description = EXCLUDED.description,
+        sort_order = EXCLUDED.sort_order,
+        updated_at = now()
+    `;
+    }
+}
+//# sourceMappingURL=seed-domains.js.map

package/dist/warehouse/seed-domains.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-situation/indexer",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "ETL indexer and REST/WS API for The Situation prediction markets",
   "type": "module",
   "main": "./dist/index.js",