@the-situation/indexer 0.17.1 → 0.18.1

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.1",
+  "version": "0.18.1",
   "description": "ETL indexer and REST/WS API for The Situation prediction markets",
   "type": "module",
   "main": "./dist/index.js",