@civiq/entity-resolution 0.1.0

package/dist/industry-taxonomy.js

@@ -0,0 +1,1026 @@
+/**
+ * Copyright (c) 2019-2025 Mark Sandford
+ * Licensed under the MIT License. See LICENSE and NOTICE files.
+ */
+/**
+ * Industry Taxonomy & Categorization System
+ *
+ * Categorizes FEC contributor employers and occupations into standardized industry sectors.
+ * Based on OpenSecrets' 13-sector classification model with keyword-based categorization.
+ *
+ * Sectors (inspired by OpenSecrets):
+ * 1. Agribusiness
+ * 2. Communications/Electronics
+ * 3. Construction
+ * 4. Defense
+ * 5. Energy/Natural Resources
+ * 6. Finance/Insurance/Real Estate
+ * 7. Health
+ * 8. Lawyers & Lobbyists
+ * 9. Transportation
+ * 10. Misc Business
+ * 11. Labor
+ * 12. Ideology/Single-Issue
+ * 13. Other/Unknown
+ */
+import { getLogger } from './logger';
+/**
+ * Industry sector enumeration
+ */
+export var IndustrySector;
+(function (IndustrySector) {
+    IndustrySector["AGRIBUSINESS"] = "Agribusiness";
+    IndustrySector["COMMUNICATIONS_ELECTRONICS"] = "Communications/Electronics";
+    IndustrySector["CONSTRUCTION"] = "Construction";
+    IndustrySector["DEFENSE"] = "Defense";
+    IndustrySector["ENERGY_NATURAL_RESOURCES"] = "Energy/Natural Resources";
+    IndustrySector["FINANCE_INSURANCE_REAL_ESTATE"] = "Finance/Insurance/Real Estate";
+    IndustrySector["HEALTH"] = "Health";
+    IndustrySector["LAWYERS_LOBBYISTS"] = "Lawyers & Lobbyists";
+    IndustrySector["TRANSPORTATION"] = "Transportation";
+    IndustrySector["MISC_BUSINESS"] = "Misc Business";
+    IndustrySector["LABOR"] = "Labor";
+    IndustrySector["IDEOLOGY_SINGLE_ISSUE"] = "Ideology/Single-Issue";
+    IndustrySector["OTHER"] = "Other";
+})(IndustrySector || (IndustrySector = {}));
+/**
+ * Industry taxonomy database
+ * Comprehensive keyword matching for employer and occupation classification
+ */
+const INDUSTRY_CATEGORIES = [
+    // AGRIBUSINESS
+    {
+        sector: IndustrySector.AGRIBUSINESS,
+        category: 'Crop Production',
+        keywords: ['farm', 'farming', 'agriculture', 'crop', 'grain', 'wheat', 'corn', 'soybean'],
+        occupationKeywords: ['farmer', 'agricultural', 'agronomist'],
+    },
+    {
+        sector: IndustrySector.AGRIBUSINESS,
+        category: 'Livestock',
+        keywords: ['ranch', 'cattle', 'dairy', 'livestock', 'poultry', 'beef', 'pork'],
+        occupationKeywords: ['rancher', 'veterinarian'],
+    },
+    {
+        sector: IndustrySector.AGRIBUSINESS,
+        category: 'Food Processing',
+        keywords: ['food processing', 'food service', 'restaurant', 'catering', 'grocery'],
+        occupationKeywords: ['chef', 'cook', 'food service'],
+    },
+    // COMMUNICATIONS/ELECTRONICS
+    {
+        sector: IndustrySector.COMMUNICATIONS_ELECTRONICS,
+        category: 'Telecommunications',
+        keywords: [
+            'telecom',
+            'verizon',
+            'at&t',
+            'comcast',
+            'spectrum',
+            'phone',
+            'wireless',
+            'cellular',
+        ],
+        occupationKeywords: ['telecommunications'],
+    },
+    {
+        sector: IndustrySector.COMMUNICATIONS_ELECTRONICS,
+        category: 'Internet/Tech',
+        keywords: [
+            'google',
+            'amazon',
+            'microsoft',
+            'apple',
+            'facebook',
+            'meta',
+            'twitter',
+            'software',
+            'tech',
+            'technology',
+            'internet',
+            'web',
+            'digital',
+        ],
+        occupationKeywords: ['software engineer', 'developer', 'programmer', 'data scientist', 'tech'],
+    },
+    {
+        sector: IndustrySector.COMMUNICATIONS_ELECTRONICS,
+        category: 'TV/Movies/Music',
+        keywords: [
+            'television',
+            'movie',
+            'film',
+            'music',
+            'entertainment',
+            'media',
+            'broadcasting',
+            'netflix',
+            'disney',
+        ],
+        occupationKeywords: ['actor', 'producer', 'musician', 'artist'],
+    },
+    {
+        sector: IndustrySector.COMMUNICATIONS_ELECTRONICS,
+        category: 'Electronics Manufacturing',
+        keywords: ['electronics', 'semiconductor', 'chip', 'circuit', 'intel', 'nvidia', 'amd'],
+        occupationKeywords: ['electrical engineer', 'electronics'],
+    },
+    // CONSTRUCTION
+    {
+        sector: IndustrySector.CONSTRUCTION,
+        category: 'General Contractors',
+        keywords: ['construction', 'contractor', 'builder', 'building', 'developer', 'remodeling'],
+        occupationKeywords: ['contractor', 'construction', 'builder'],
+    },
+    {
+        sector: IndustrySector.CONSTRUCTION,
+        category: 'Home Builders',
+        keywords: ['home builder', 'homebuilder', 'residential construction', 'housing'],
+    },
+    {
+        sector: IndustrySector.CONSTRUCTION,
+        category: 'Construction Services',
+        keywords: ['plumbing', 'electrical', 'hvac', 'roofing', 'carpentry'],
+        occupationKeywords: ['plumber', 'electrician', 'carpenter', 'roofer'],
+    },
+    // DEFENSE
+    {
+        sector: IndustrySector.DEFENSE,
+        category: 'Defense Aerospace',
+        keywords: [
+            'boeing',
+            'lockheed',
+            'raytheon',
+            'northrop grumman',
+            'general dynamics',
+            'defense',
+            'aerospace',
+            'military',
+        ],
+        occupationKeywords: ['defense', 'military'],
+    },
+    {
+        sector: IndustrySector.DEFENSE,
+        category: 'Defense Electronics',
+        keywords: ['defense electronics', 'missile', 'weapons systems'],
+    },
+    // ENERGY/NATURAL RESOURCES
+    {
+        sector: IndustrySector.ENERGY_NATURAL_RESOURCES,
+        category: 'Oil & Gas',
+        keywords: ['oil', 'gas', 'petroleum', 'exxon', 'chevron', 'shell', 'bp', 'energy', 'drilling'],
+        occupationKeywords: ['petroleum engineer', 'oil', 'gas'],
+    },
+    {
+        sector: IndustrySector.ENERGY_NATURAL_RESOURCES,
+        category: 'Electric Utilities',
+        keywords: ['electric', 'utility', 'power', 'electricity', 'grid'],
+        occupationKeywords: ['power plant', 'utility'],
+    },
+    {
+        sector: IndustrySector.ENERGY_NATURAL_RESOURCES,
+        category: 'Renewable Energy',
+        keywords: ['solar', 'wind', 'renewable', 'clean energy', 'green energy'],
+    },
+    {
+        sector: IndustrySector.ENERGY_NATURAL_RESOURCES,
+        category: 'Mining',
+        keywords: ['mining', 'coal', 'mineral', 'extraction'],
+        occupationKeywords: ['miner', 'mining'],
+    },
+    // FINANCE/INSURANCE/REAL ESTATE
+    {
+        sector: IndustrySector.FINANCE_INSURANCE_REAL_ESTATE,
+        category: 'Commercial Banks',
+        keywords: [
+            'bank',
+            'banking',
+            'chase',
+            'wells fargo',
+            'bank of america',
+            'citibank',
+            'financial services',
+        ],
+        occupationKeywords: ['banker', 'banking'],
+    },
+    {
+        sector: IndustrySector.FINANCE_INSURANCE_REAL_ESTATE,
+        category: 'Insurance',
+        keywords: [
+            'insurance',
+            'allstate',
+            'state farm',
+            'geico',
+            'progressive',
+            'life insurance',
+            'health insurance',
+        ],
+        occupationKeywords: ['insurance', 'actuary'],
+    },
+    {
+        sector: IndustrySector.FINANCE_INSURANCE_REAL_ESTATE,
+        category: 'Real Estate',
+        keywords: ['real estate', 'realty', 'property management', 'realtor'],
+        occupationKeywords: ['realtor', 'real estate agent', 'property manager'],
+    },
+    {
+        sector: IndustrySector.FINANCE_INSURANCE_REAL_ESTATE,
+        category: 'Securities & Investment',
+        keywords: [
+            'investment',
+            'securities',
+            'hedge fund',
+            'private equity',
+            'venture capital',
+            'asset management',
+            'goldman sachs',
+            'morgan stanley',
+        ],
+        occupationKeywords: ['financial advisor', 'investment', 'trader', 'analyst'],
+    },
+    {
+        sector: IndustrySector.FINANCE_INSURANCE_REAL_ESTATE,
+        category: 'Accounting',
+        keywords: ['accounting', 'accountant', 'cpa', 'kpmg', 'deloitte', 'pwc', 'ernst & young'],
+        occupationKeywords: ['accountant', 'cpa', 'auditor'],
+    },
+    // HEALTH
+    {
+        sector: IndustrySector.HEALTH,
+        category: 'Health Professionals',
+        keywords: ['hospital', 'clinic', 'medical center', 'health system'],
+        occupationKeywords: [
+            'physician',
+            'doctor',
+            'nurse',
+            'surgeon',
+            'medical',
+            'healthcare',
+            'dentist',
+        ],
+    },
+    {
+        sector: IndustrySector.HEALTH,
+        category: 'Pharmaceuticals',
+        keywords: ['pharmaceutical', 'pharma', 'pfizer', 'merck', 'johnson & johnson', 'drug'],
+        occupationKeywords: ['pharmacist', 'pharmaceutical'],
+    },
+    {
+        sector: IndustrySector.HEALTH,
+        category: 'Health Insurance',
+        keywords: ['health insurance', 'uhc', 'aetna', 'cigna', 'anthem', 'humana'],
+    },
+    {
+        sector: IndustrySector.HEALTH,
+        category: 'Medical Devices',
+        keywords: ['medical device', 'medtronic', 'abbott'],
+    },
+    // LAWYERS & LOBBYISTS
+    {
+        sector: IndustrySector.LAWYERS_LOBBYISTS,
+        category: 'Law Firms',
+        keywords: ['law firm', 'legal', 'attorney', 'esquire'],
+        occupationKeywords: ['attorney', 'lawyer', 'legal', 'counsel', 'paralegal'],
+    },
+    {
+        sector: IndustrySector.LAWYERS_LOBBYISTS,
+        category: 'Lobbyists',
+        keywords: ['lobbying', 'government relations', 'public affairs'],
+        occupationKeywords: ['lobbyist', 'government relations'],
+    },
+    // TRANSPORTATION
+    {
+        sector: IndustrySector.TRANSPORTATION,
+        category: 'Air Transport',
+        keywords: ['airline', 'aviation', 'american airlines', 'delta', 'united airlines'],
+        occupationKeywords: ['pilot', 'flight attendant', 'aviation'],
+    },
+    {
+        sector: IndustrySector.TRANSPORTATION,
+        category: 'Automotive',
+        keywords: ['automotive', 'auto', 'ford', 'gm', 'toyota', 'honda', 'car', 'vehicle'],
+        occupationKeywords: ['automotive', 'mechanic'],
+    },
+    {
+        sector: IndustrySector.TRANSPORTATION,
+        category: 'Railroads',
+        keywords: ['railroad', 'rail', 'amtrak', 'freight rail'],
+    },
+    {
+        sector: IndustrySector.TRANSPORTATION,
+        category: 'Trucking',
+        keywords: ['trucking', 'freight', 'logistics', 'shipping', 'ups', 'fedex'],
+        occupationKeywords: ['truck driver', 'driver'],
+    },
+    // MISC BUSINESS
+    {
+        sector: IndustrySector.MISC_BUSINESS,
+        category: 'Retail',
+        keywords: ['retail', 'walmart', 'target', 'costco', 'store', 'shop', 'grocery'],
+        occupationKeywords: ['retail', 'sales', 'cashier', 'merchandis'],
+    },
+    {
+        sector: IndustrySector.MISC_BUSINESS,
+        category: 'Manufacturing',
+        keywords: ['manufacturing', 'factory', 'production', 'industrial'],
+        occupationKeywords: ['engineer', 'manufacturing'],
+    },
+    {
+        sector: IndustrySector.MISC_BUSINESS,
+        category: 'Business Services',
+        keywords: [
+            'consulting',
+            'consultant',
+            'business services',
+            'management',
+            'staffing',
+            'recruiting',
+        ],
+        occupationKeywords: [
+            'consultant',
+            'business analyst',
+            'executive',
+            'ceo',
+            'cfo',
+            'coo',
+            'cto',
+            'president',
+            'vice president',
+            'owner',
+            'partner',
+            'director',
+            'manager',
+            'founder',
+            'entrepreneur',
+            'business owner',
+            'principal',
+            'managing director',
+        ],
+    },
+    {
+        sector: IndustrySector.MISC_BUSINESS,
+        category: 'Chemical',
+        keywords: ['chemical', 'dow', 'dupont'],
+        occupationKeywords: ['chemical engineer', 'chemist'],
+    },
+    {
+        sector: IndustrySector.MISC_BUSINESS,
+        category: 'Lodging/Tourism',
+        keywords: ['hotel', 'resort', 'hospitality', 'tourism', 'marriott', 'hilton'],
+        occupationKeywords: ['hotel', 'hospitality'],
+    },
+    // LABOR
+    {
+        sector: IndustrySector.LABOR,
+        category: 'Labor Unions',
+        keywords: [
+            'union',
+            'afl-cio',
+            'teamsters',
+            'seiu',
+            'uaw',
+            'afscme',
+            'laborers',
+            'steelworkers',
+        ],
+        occupationKeywords: ['union'],
+    },
+    // IDEOLOGY/SINGLE-ISSUE
+    {
+        sector: IndustrySector.IDEOLOGY_SINGLE_ISSUE,
+        category: 'Non-Profit/Advocacy',
+        keywords: [
+            'non-profit',
+            'nonprofit',
+            'foundation',
+            'charity',
+            'advocacy',
+            'association',
+            'organization',
+        ],
+        occupationKeywords: ['nonprofit', 'advocacy'],
+    },
+    {
+        sector: IndustrySector.IDEOLOGY_SINGLE_ISSUE,
+        category: 'Education',
+        keywords: ['school', 'university', 'college', 'education', 'academic'],
+        occupationKeywords: ['teacher', 'professor', 'educator', 'principal'],
+    },
+    {
+        sector: IndustrySector.IDEOLOGY_SINGLE_ISSUE,
+        category: 'Religious Organizations',
+        keywords: ['church', 'religious', 'ministry', 'faith'],
+        occupationKeywords: ['minister', 'pastor', 'clergy'],
+    },
+    // OTHER
+    {
+        sector: IndustrySector.OTHER,
+        category: 'Government',
+        keywords: ['government', 'federal', 'state', 'city', 'county', 'municipal', 'public sector'],
+        occupationKeywords: ['government', 'public'],
+    },
+    {
+        sector: IndustrySector.OTHER,
+        category: 'Retired',
+        keywords: ['retired', 'retirement', 'retiree'],
+        occupationKeywords: ['retired', 'retiree'],
+    },
+    {
+        sector: IndustrySector.OTHER,
+        category: 'Not Employed',
+        keywords: ['not employed', 'unemployed', 'homemaker', 'home maker'],
+        occupationKeywords: ['not employed', 'homemaker', 'home maker', 'student', 'unemployed'],
+    },
+];
+/**
+ * Non-informative employer values that should be skipped for keyword matching.
+ * When these appear, fall through directly to occupation-based matching.
+ */
+const NON_INFORMATIVE_EMPLOYERS = new Set([
+    'none',
+    'n/a',
+    'na',
+    'not employed',
+    'not applicable',
+    'information requested',
+    'information requested per best efforts',
+    'info requested',
+    'refused',
+    'self',
+    'self-employed',
+    'self employed',
+    'selfemployed',
+    'independent',
+    'private',
+    'personal',
+    'individual',
+]);
+/**
+ * Categorize a contribution based on employer and occupation
+ */
+export function categorizeContribution(employer, occupation) {
+    if (!employer && !occupation) {
+        return {
+            sector: IndustrySector.OTHER,
+            category: 'Unknown',
+            confidence: 'low',
+            matchSource: 'inferred',
+        };
+    }
+    const employerLower = employer?.toLowerCase().trim() || '';
+    const occupationLower = occupation?.toLowerCase().trim() || '';
+    // Check if employer is informative (not a placeholder like "NONE" or "SELF-EMPLOYED")
+    const hasInformativeEmployer = employerLower !== '' && !NON_INFORMATIVE_EMPLOYERS.has(employerLower);
+    // Try employer match first (higher confidence) — only if employer is informative
+    if (hasInformativeEmployer) {
+        for (const industry of INDUSTRY_CATEGORIES) {
+            for (const keyword of industry.keywords) {
+                if (employerLower.includes(keyword.toLowerCase())) {
+                    return {
+                        sector: industry.sector,
+                        category: industry.category,
+                        confidence: 'high',
+                        matchedKeyword: keyword,
+                        matchSource: 'employer',
+                    };
+                }
+            }
+        }
+    }
+    // Try occupation match (medium confidence)
+    if (occupationLower) {
+        for (const industry of INDUSTRY_CATEGORIES) {
+            if (industry.occupationKeywords) {
+                for (const keyword of industry.occupationKeywords) {
+                    if (occupationLower.includes(keyword.toLowerCase())) {
+                        return {
+                            sector: industry.sector,
+                            category: industry.category,
+                            confidence: 'medium',
+                            matchedKeyword: keyword,
+                            matchSource: 'occupation',
+                        };
+                    }
+                }
+            }
+        }
+    }
+    // Handle self-employed / independent with a useful occupation
+    if (NON_INFORMATIVE_EMPLOYERS.has(employerLower) && occupationLower) {
+        // Occupation didn't match specific industries above, so classify by occupation text
+        if (['homemaker', 'home maker', 'not employed', 'unemployed'].some(v => occupationLower.includes(v))) {
+            return {
+                sector: IndustrySector.OTHER,
+                category: 'Not Employed',
+                confidence: 'medium',
+                matchedKeyword: occupationLower,
+                matchSource: 'occupation',
+            };
+        }
+        if (occupationLower.includes('student')) {
+            return {
+                sector: IndustrySector.OTHER,
+                category: 'Not Employed',
+                confidence: 'medium',
+                matchedKeyword: 'student',
+                matchSource: 'occupation',
+            };
+        }
+        // Self-employed with an unclassified occupation
+        return {
+            sector: IndustrySector.MISC_BUSINESS,
+            category: 'Business Services',
+            confidence: 'low',
+            matchedKeyword: 'self-employed',
+            matchSource: 'inferred',
+        };
+    }
+    // No match found
+    return {
+        sector: IndustrySector.OTHER,
+        category: 'Other/Unknown',
+        confidence: 'low',
+        matchSource: 'inferred',
+    };
+}
+/**
+ * Aggregate contributions by industry sector.
+ * Uses smart categorization when contributor_name is available,
+ * falling back to PAC name matching for unclassified contributions.
+ */
+export function aggregateByIndustrySector(contributions) {
+    const sectorMap = new Map();
+    let totalContributions = 0;
+    for (const contrib of contributions) {
+        const categorization = categorizeContributionSmart(contrib.contributor_employer, contrib.contributor_occupation, contrib.contributor_name);
+        const amount = contrib.contribution_receipt_amount;
+        totalContributions += amount;
+        const existing = sectorMap.get(categorization.sector) || {
+            totalAmount: 0,
+            contributionCount: 0,
+            categories: new Map(),
+        };
+        existing.totalAmount += amount;
+        existing.contributionCount++;
+        const categoryData = existing.categories.get(categorization.category) || {
+            amount: 0,
+            count: 0,
+        };
+        categoryData.amount += amount;
+        categoryData.count++;
+        existing.categories.set(categorization.category, categoryData);
+        sectorMap.set(categorization.sector, existing);
+    }
+    const result = Array.from(sectorMap.entries()).map(([sector, data]) => ({
+        sector,
+        totalAmount: data.totalAmount,
+        contributionCount: data.contributionCount,
+        percentage: totalContributions > 0 ? (data.totalAmount / totalContributions) * 100 : 0,
+        categories: data.categories,
+    }));
+    getLogger().debug(`[Industry Taxonomy] Categorized ${contributions.length} contributions into ${result.length} sectors`);
+    return result.sort((a, b) => b.totalAmount - a.totalAmount);
+}
+/**
+ * PAC/Committee Name Keywords for Industry Classification
+ * Maps committee names to industry sectors (OpenSecrets-style)
+ */
+const PAC_NAME_KEYWORDS = [
+    // HEALTH
+    {
+        sector: IndustrySector.HEALTH,
+        category: 'Health Professionals',
+        keywords: [
+            'medical',
+            'physician',
+            'doctor',
+            'nurse',
+            'dental',
+            'hospital',
+            'health',
+            'healthcare',
+            'ama ',
+            'american medical',
+        ],
+    },
+    {
+        sector: IndustrySector.HEALTH,
+        category: 'Pharmaceuticals',
+        keywords: ['pharma', 'pfizer', 'merck', 'johnson', 'lilly', 'abbvie', 'bristol', 'novartis'],
+    },
+    {
+        sector: IndustrySector.HEALTH,
+        category: 'Health Insurance',
+        keywords: ['blue cross', 'aetna', 'cigna', 'humana', 'anthem', 'kaiser', 'united health'],
+    },
+    // FINANCE
+    {
+        sector: IndustrySector.FINANCE_INSURANCE_REAL_ESTATE,
+        category: 'Commercial Banks',
+        keywords: [
+            'bank',
+            'banker',
+            'chase',
+            'wells fargo',
+            'citibank',
+            'jpmorgan',
+            'credit union',
+            'financial',
+        ],
+    },
+    {
+        sector: IndustrySector.FINANCE_INSURANCE_REAL_ESTATE,
+        category: 'Securities & Investment',
+        keywords: [
+            'goldman',
+            'morgan stanley',
+            'investment',
+            'securities',
+            'hedge',
+            'capital',
+            'blackrock',
+            'fidelity',
+        ],
+    },
+    {
+        sector: IndustrySector.FINANCE_INSURANCE_REAL_ESTATE,
+        category: 'Insurance',
+        keywords: ['insurance', 'allstate', 'state farm', 'progressive', 'geico', 'mutual', 'life ins'],
+    },
+    {
+        sector: IndustrySector.FINANCE_INSURANCE_REAL_ESTATE,
+        category: 'Real Estate',
+        keywords: ['realtor', 'real estate', 'realty', 'homebuilder', 'mortgage', 'property'],
+    },
+    // LABOR
+    {
+        sector: IndustrySector.LABOR,
+        category: 'Labor Unions',
+        keywords: [
+            'union',
+            'teamster',
+            'seiu',
+            'afscme',
+            'afl-cio',
+            'uaw',
+            'steelworker',
+            'laborer',
+            'ibew',
+            'ufcw',
+            'carpenters',
+            'plumbers',
+            'pipefitters',
+            'electrical workers',
+            'teachers',
+            'firefighter',
+            'police',
+            'working families',
+        ],
+    },
+    // LAWYERS
+    {
+        sector: IndustrySector.LAWYERS_LOBBYISTS,
+        category: 'Lawyers/Law Firms',
+        keywords: [
+            'law',
+            'lawyer',
+            'attorney',
+            'legal',
+            'trial',
+            'justice',
+            'tort',
+            'litigation',
+            'bar association',
+        ],
+    },
+    // ENERGY
+    {
+        sector: IndustrySector.ENERGY_NATURAL_RESOURCES,
+        category: 'Oil & Gas',
+        keywords: [
+            'oil',
+            'gas',
+            'petroleum',
+            'exxon',
+            'chevron',
+            'shell',
+            'bp ',
+            'conocophillips',
+            'energy',
+            'drilling',
+            'pipeline',
+        ],
+    },
+    {
+        sector: IndustrySector.ENERGY_NATURAL_RESOURCES,
+        category: 'Electric Utilities',
+        keywords: ['electric', 'utility', 'power', 'grid', 'edison', 'duke energy', 'exelon'],
+    },
+    // DEFENSE
+    {
+        sector: IndustrySector.DEFENSE,
+        category: 'Defense Aerospace',
+        keywords: [
+            'defense',
+            'lockheed',
+            'raytheon',
+            'boeing',
+            'northrop',
+            'general dynamics',
+            'bae ',
+            'l3harris',
+            'aerospace',
+            'military',
+        ],
+    },
+    // COMMUNICATIONS/TECH
+    {
+        sector: IndustrySector.COMMUNICATIONS_ELECTRONICS,
+        category: 'Internet/Tech',
+        keywords: [
+            'google',
+            'microsoft',
+            'apple',
+            'amazon',
+            'meta',
+            'facebook',
+            'tech',
+            'software',
+            'computer',
+            'internet',
+            'oracle',
+            'intel',
+            'cisco',
+            'ibm',
+        ],
+    },
+    {
+        sector: IndustrySector.COMMUNICATIONS_ELECTRONICS,
+        category: 'Telecommunications',
+        keywords: ['telecom', 'verizon', 'at&t', 'comcast', 'charter', 't-mobile', 'wireless'],
+    },
+    {
+        sector: IndustrySector.COMMUNICATIONS_ELECTRONICS,
+        category: 'TV/Movies/Music',
+        keywords: [
+            'entertainment',
+            'movie',
+            'film',
+            'television',
+            'broadcast',
+            'media',
+            'disney',
+            'warner',
+            'fox',
+            'screen actors',
+        ],
+    },
+    // TRANSPORTATION
+    {
+        sector: IndustrySector.TRANSPORTATION,
+        category: 'Air Transport',
+        keywords: ['airline', 'aviation', 'pilot', 'air transport', 'delta', 'united', 'american air'],
+    },
+    {
+        sector: IndustrySector.TRANSPORTATION,
+        category: 'Automotive',
+        keywords: [
+            'auto',
+            'automobile',
+            'car dealer',
+            'ford',
+            'gm ',
+            'general motors',
+            'toyota',
+            'honda',
+        ],
+    },
+    {
+        sector: IndustrySector.TRANSPORTATION,
+        category: 'Trucking',
+        keywords: ['trucking', 'freight', 'logistics', 'ups', 'fedex', 'shipping'],
+    },
+    {
+        sector: IndustrySector.TRANSPORTATION,
+        category: 'Railroads',
+        keywords: ['railroad', 'rail', 'amtrak', 'bnsf', 'union pacific', 'csx'],
+    },
+    // AGRIBUSINESS
+    {
+        sector: IndustrySector.AGRIBUSINESS,
+        category: 'Crop Production',
+        keywords: ['farm', 'farmer', 'agriculture', 'crop', 'grain', 'corn', 'soybean', 'cotton'],
+    },
+    {
+        sector: IndustrySector.AGRIBUSINESS,
+        category: 'Food Processing',
+        keywords: [
+            'food',
+            'restaurant',
+            'grocery',
+            'beverage',
+            'coca-cola',
+            'pepsi',
+            'tyson',
+            'cargill',
+        ],
+    },
+    // CONSTRUCTION
+    {
+        sector: IndustrySector.CONSTRUCTION,
+        category: 'General Contractors',
+        keywords: ['construction', 'contractor', 'builder', 'building trade', 'cement', 'steel'],
+    },
+    {
+        sector: IndustrySector.CONSTRUCTION,
+        category: 'Home Builders',
+        keywords: ['home builder', 'homebuilder', 'residential', 'housing'],
+    },
+    // MISC BUSINESS
+    {
+        sector: IndustrySector.MISC_BUSINESS,
+        category: 'Retail',
+        keywords: ['retail', 'walmart', 'target', 'store', 'merchant', 'shop'],
+    },
+    {
+        sector: IndustrySector.MISC_BUSINESS,
+        category: 'Manufacturing',
+        keywords: ['manufacturing', 'manufacturer', 'industrial', 'factory'],
+    },
+    {
+        sector: IndustrySector.MISC_BUSINESS,
+        category: 'Business Services',
+        keywords: ['business', 'chamber of commerce', 'nfib', 'small business'],
+    },
+    // IDEOLOGY
+    {
+        sector: IndustrySector.IDEOLOGY_SINGLE_ISSUE,
+        category: 'Pro-Israel',
+        keywords: ['israel', 'aipac', 'jewish', 'zionist'],
+    },
+    {
+        sector: IndustrySector.IDEOLOGY_SINGLE_ISSUE,
+        category: 'Gun Rights',
+        keywords: ['rifle', 'nra', 'gun', 'firearm', 'second amendment', '2nd amendment'],
+    },
+    {
+        sector: IndustrySector.IDEOLOGY_SINGLE_ISSUE,
+        category: 'Pro-Choice',
+        keywords: ['planned parenthood', 'naral', 'emily', 'pro-choice', 'reproductive'],
+    },
+    {
+        sector: IndustrySector.IDEOLOGY_SINGLE_ISSUE,
+        category: 'Environment',
+        keywords: ['environment', 'sierra', 'conservation', 'climate', 'green', 'lcv'],
+    },
+    {
+        sector: IndustrySector.IDEOLOGY_SINGLE_ISSUE,
+        category: 'Human Rights',
+        keywords: ['human rights', 'civil rights', 'aclu', 'naacp', 'equality'],
+    },
+    {
+        sector: IndustrySector.IDEOLOGY_SINGLE_ISSUE,
+        category: 'Education',
+        keywords: ['education', 'teacher', 'school', 'university', 'college', 'nea ', 'aft '],
+    },
+];
+/**
+ * Categorize a PAC/committee by its name
+ * Used for committee-to-committee transfers and PAC contributions
+ */
+export function categorizePACByName(committeeName) {
+    if (!committeeName) {
+        return {
+            sector: IndustrySector.OTHER,
+            category: 'Unknown PAC',
+            confidence: 'low',
+            matchSource: 'inferred',
+        };
+    }
+    const nameLower = committeeName.toLowerCase();
+    // Check for political party committees first
+    if (nameLower.includes('democratic') ||
+        nameLower.includes('dccc') ||
+        nameLower.includes('dscc') ||
+        nameLower.includes('dnc')) {
+        return {
+            sector: IndustrySector.OTHER,
+            category: 'Democratic Party',
+            confidence: 'high',
+            matchedKeyword: 'democratic',
+            matchSource: 'employer',
+        };
+    }
+    if (nameLower.includes('republican') ||
+        nameLower.includes('nrcc') ||
+        nameLower.includes('nrsc') ||
+        nameLower.includes('rnc')) {
+        return {
+            sector: IndustrySector.OTHER,
+            category: 'Republican Party',
+            confidence: 'high',
+            matchedKeyword: 'republican',
+            matchSource: 'employer',
+        };
+    }
+    // Check for joint fundraising/victory funds (pass-through)
+    if (nameLower.includes('victory') ||
+        nameLower.includes('joint') ||
+        nameLower.includes('senate 20') ||
+        nameLower.includes('house 20') ||
+        nameLower.includes('blue senate') ||
+        nameLower.includes('red senate') ||
+        nameLower.includes('making history') ||
+        nameLower.includes('north stars')) {
+        return {
+            sector: IndustrySector.OTHER,
+            category: 'Joint Fundraising',
+            confidence: 'medium',
+            matchedKeyword: 'joint-fund',
+            matchSource: 'employer',
+        };
+    }
+    // Check industry-specific PAC names
+    for (const pacCategory of PAC_NAME_KEYWORDS) {
+        for (const keyword of pacCategory.keywords) {
+            if (nameLower.includes(keyword.toLowerCase())) {
+                return {
+                    sector: pacCategory.sector,
+                    category: pacCategory.category,
+                    confidence: 'high',
+                    matchedKeyword: keyword,
+                    matchSource: 'employer',
+                };
+            }
+        }
+    }
+    // Generic PAC fallback
+    if (nameLower.includes('pac') || nameLower.includes('committee')) {
+        return {
+            sector: IndustrySector.OTHER,
+            category: 'Unclassified PAC',
+            confidence: 'low',
+            matchSource: 'inferred',
+        };
+    }
+    return {
+        sector: IndustrySector.OTHER,
+        category: 'Unknown',
+        confidence: 'low',
+        matchSource: 'inferred',
+    };
+}
+/**
+ * Smart categorization: tries employer/occupation first, then falls back to contributor name (for PACs)
+ */
+export function categorizeContributionSmart(employer, occupation, contributorName) {
+    // First try standard employer/occupation categorization
+    const standardResult = categorizeContribution(employer, occupation);
+    // If we got a good match, return it
+    if (standardResult.confidence !== 'low' ||
+        (standardResult.category !== 'Other/Unknown' && standardResult.category !== 'Unknown')) {
+        return standardResult;
+    }
+    // If no employer/occupation, try to categorize by contributor name (for PACs)
+    if (contributorName) {
+        const pacResult = categorizePACByName(contributorName);
+        if (pacResult.confidence !== 'low' || pacResult.category !== 'Unknown') {
+            return pacResult;
+        }
+    }
+    return standardResult;
+}
+/**
+ * Get top categories across all sectors
+ */
+export function getTopCategories(contributions, limit = 10) {
+    const categoryMap = new Map();
+    let totalContributions = 0;
+    for (const contrib of contributions) {
+        // Use smart categorization that tries employer/occupation first, then contributor name
+        const categorization = categorizeContributionSmart(contrib.contributor_employer, contrib.contributor_occupation, contrib.contributor_name);
+        const amount = contrib.contribution_receipt_amount;
+        totalContributions += amount;
+        const key = `${categorization.sector}:${categorization.category}`;
+        const existing = categoryMap.get(key) || {
+            sector: categorization.sector,
+            totalAmount: 0,
+            contributionCount: 0,
+        };
+        existing.totalAmount += amount;
+        existing.contributionCount++;
+        categoryMap.set(key, existing);
+    }
+    const result = Array.from(categoryMap.entries())
+        .map(([key, data]) => ({
+        sector: data.sector,
+        category: key.split(':')[1],
+        totalAmount: data.totalAmount,
+        contributionCount: data.contributionCount,
+        percentage: totalContributions > 0 ? (data.totalAmount / totalContributions) * 100 : 0,
+    }))
+        .sort((a, b) => b.totalAmount - a.totalAmount)
+        .slice(0, limit);
+    return result;
+}
+//# sourceMappingURL=industry-taxonomy.js.map