@civiq/entity-resolution 0.1.0

package/dist/fec-entity-resolution.js

@@ -0,0 +1,407 @@
+/**
+ * Copyright (c) 2019-2025 Mark Sandford
+ * Licensed under the MIT License. See LICENSE and NOTICE files.
+ */
+/**
+ * FEC Entity Resolution & Name Standardization
+ *
+ * Handles entity matching, name normalization, and deduplication for:
+ * - Individual contributors with name variants (JOHN SMITH vs John Smith vs J. Smith)
+ * - Organizations/employers with variations (GOOGLE INC. vs Google Inc vs Google)
+ * - Recipients/disbursement entities (consulting firms, vendors)
+ *
+ * Uses string similarity algorithms and business rule heuristics to match entities.
+ */
+import { getLogger } from './logger';
+/**
+ * Common abbreviations used in FEC/lobbying data.
+ * Maps normalized short forms to canonical full names.
+ */
+const COMMON_ABBREVIATIONS = {
+    jnj: 'johnson and johnson',
+    jj: 'johnson and johnson',
+    'j and j': 'johnson and johnson',
+    gm: 'general motors',
+    ge: 'general electric',
+    ibm: 'international business machines',
+    att: 'at and t',
+    'at t': 'at and t',
+    jpmorgan: 'jpmorgan chase',
+    jpm: 'jpmorgan chase',
+    bofa: 'bank of america',
+    pg: 'procter and gamble',
+    'p and g': 'procter and gamble',
+    msft: 'microsoft',
+    amzn: 'amazon',
+    goog: 'alphabet',
+    aapl: 'apple',
+    pfizer: 'pfizer',
+    raytheon: 'raytheon technologies',
+    lockmart: 'lockheed martin',
+    ba: 'boeing',
+};
+/**
+ * Expand a cleaned name using the abbreviation map.
+ * Returns the canonical form if found, otherwise returns the original.
+ */
+function expandAbbreviation(cleanedName) {
+    const lower = cleanedName.toLowerCase();
+    if (COMMON_ABBREVIATIONS[lower]) {
+        return COMMON_ABBREVIATIONS[lower].toUpperCase();
+    }
+    return cleanedName;
+}
+/**
+ * Remove common noise from names for better matching
+ */
+function cleanNameForMatching(name) {
+    return (name
+        .trim()
+        .toUpperCase()
+        // Remove common suffixes
+        .replace(/\s+(INC\.?|LLC\.?|LLP\.?|CORP\.?|CORPORATION|COMPANY|CO\.?|LTD\.?)$/i, '')
+        // Normalize ampersand to AND before stripping punctuation
+        .replace(/&/g, ' AND ')
+        // Remove punctuation except spaces
+        .replace(/[^\w\s]/g, '')
+        // Normalize multiple spaces
+        .replace(/\s+/g, ' ')
+        .trim());
+}
+/**
+ * Standardize individual names to canonical form
+ * Handles: LAST, FIRST MIDDLE -> First Middle Last
+ */
+function standardizeIndividualName(name) {
+    const cleaned = name.trim();
+    // Check if name is in "LAST, FIRST" format
+    if (cleaned.includes(',')) {
+        const parts = cleaned.split(',').map(p => p.trim());
+        if (parts.length === 2) {
+            const [last, first] = parts;
+            return `${first} ${last}`.replace(/\s+/g, ' ').trim();
+        }
+    }
+    // Already in "First Last" format
+    return cleaned.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Calculate Levenshtein distance for string similarity
+ * Used to detect typos and minor variations
+ */
+function levenshteinDistance(a, b) {
+    const matrix = [];
+    for (let i = 0; i <= b.length; i++) {
+        matrix[i] = [i];
+    }
+    for (let j = 0; j <= a.length; j++) {
+        matrix[0][j] = j;
+    }
+    for (let i = 1; i <= b.length; i++) {
+        for (let j = 1; j <= a.length; j++) {
+            if (b.charAt(i - 1) === a.charAt(j - 1)) {
+                matrix[i][j] = matrix[i - 1][j - 1];
+            }
+            else {
+                matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, // substitution
+                matrix[i][j - 1] + 1, // insertion
+                matrix[i - 1][j] + 1 // deletion
+                );
+            }
+        }
+    }
+    return matrix[b.length][a.length];
+}
+/**
+ * Calculate similarity ratio between two strings (0-1)
+ */
+function similarityRatio(a, b) {
+    const distance = levenshteinDistance(a, b);
+    const maxLength = Math.max(a.length, b.length);
+    return maxLength === 0 ? 1 : 1 - distance / maxLength;
+}
+/**
+ * Detect if name represents an individual or organization
+ */
+function detectEntityType(name) {
+    const cleaned = name.toUpperCase();
+    // Organization indicators
+    const orgIndicators = [
+        'INC',
+        'LLC',
+        'LLP',
+        'CORP',
+        'CORPORATION',
+        'COMPANY',
+        'CO',
+        'LTD',
+        'PARTNERSHIP',
+        'COMMITTEE',
+        'PAC',
+        'FUND',
+        'FOUNDATION',
+        'ASSOCIATION',
+        'SOCIETY',
+        'INSTITUTE',
+        'COUNCIL',
+        'GROUP',
+    ];
+    if (orgIndicators.some(indicator => cleaned.includes(indicator))) {
+        return 'organization';
+    }
+    // Individual indicators (comma-separated name format)
+    if (cleaned.includes(',')) {
+        return 'individual';
+    }
+    // Count words - individuals typically have 2-4 words
+    const wordCount = cleaned.split(/\s+/).length;
+    if (wordCount >= 2 && wordCount <= 4) {
+        return 'individual';
+    }
+    return 'unknown';
+}
+/**
+ * Check if two entities should be considered the same based on name similarity
+ * and metadata matching
+ */
+export function entitiesMatch(entity1, entity2, threshold = 0.85) {
+    const name1 = cleanNameForMatching(entity1.name);
+    const name2 = cleanNameForMatching(entity2.name);
+    // Exact match
+    if (name1 === name2) {
+        return true;
+    }
+    // Expand common abbreviations before similarity comparison
+    const expanded1 = expandAbbreviation(name1);
+    const expanded2 = expandAbbreviation(name2);
+    // Re-check exact match after expansion
+    if (expanded1 === expanded2) {
+        return true;
+    }
+    // Calculate similarity using expanded forms
+    const similarity = similarityRatio(expanded1, expanded2);
+    // High similarity threshold for base match
+    if (similarity < threshold) {
+        return false;
+    }
+    // Additional metadata checks to confirm match
+    let metadataMatches = 0;
+    let metadataChecks = 0;
+    // Check employer match (for individuals)
+    if (entity1.employer && entity2.employer) {
+        metadataChecks++;
+        const emp1 = cleanNameForMatching(entity1.employer);
+        const emp2 = cleanNameForMatching(entity2.employer);
+        if (emp1 === emp2 || similarityRatio(emp1, emp2) > 0.8) {
+            metadataMatches++;
+        }
+    }
+    // Check location match
+    if (entity1.state && entity2.state) {
+        metadataChecks++;
+        if (entity1.state.toUpperCase() === entity2.state.toUpperCase()) {
+            metadataMatches++;
+            // Same city is strong confirmation
+            if (entity1.city && entity2.city) {
+                metadataChecks++;
+                const city1 = cleanNameForMatching(entity1.city);
+                const city2 = cleanNameForMatching(entity2.city);
+                if (city1 === city2) {
+                    metadataMatches++;
+                }
+            }
+        }
+    }
+    // If we have metadata, require at least 50% match
+    if (metadataChecks > 0) {
+        return metadataMatches / metadataChecks >= 0.5;
+    }
+    // No metadata, rely on name similarity
+    return similarity >= threshold;
+}
+/**
+ * Normalize a single entity name and metadata
+ */
+export function normalizeEntity(name, metadata) {
+    const entityType = detectEntityType(name);
+    let displayName;
+    let normalizedName;
+    if (entityType === 'individual') {
+        displayName = standardizeIndividualName(name);
+        normalizedName = cleanNameForMatching(displayName);
+    }
+    else {
+        displayName = name.trim();
+        normalizedName = cleanNameForMatching(name);
+    }
+    return {
+        normalizedName,
+        displayName,
+        rawVariants: [name],
+        entityType,
+        metadata: metadata || {},
+    };
+}
+/**
+ * Deduplicate and aggregate contributions by entity
+ */
+export function deduplicateContributions(contributions) {
+    const entityMap = new Map();
+    getLogger().debug(`[Entity Resolution] Deduplicating ${contributions.length} contributions`);
+    for (const contrib of contributions) {
+        if (!contrib.contributor_name?.trim()) {
+            continue;
+        }
+        const metadata = {
+            employer: contrib.contributor_employer,
+            occupation: contrib.contributor_occupation,
+            city: contrib.contributor_city,
+            state: contrib.contributor_state,
+            zip: contrib.contributor_zip,
+        };
+        const normalized = normalizeEntity(contrib.contributor_name, metadata);
+        // Check if we already have a matching entity
+        let matchedKey = null;
+        for (const [key, existing] of entityMap.entries()) {
+            if (entitiesMatch({
+                name: normalized.normalizedName,
+                employer: metadata.employer,
+                city: metadata.city,
+                state: metadata.state,
+                zip: metadata.zip,
+            }, {
+                name: existing.normalizedName,
+                employer: existing.metadata.employer,
+                city: existing.metadata.city,
+                state: existing.metadata.state,
+                zip: existing.metadata.zip,
+            })) {
+                matchedKey = key;
+                break;
+            }
+        }
+        if (matchedKey) {
+            // Add to existing entity
+            const existing = entityMap.get(matchedKey);
+            existing.totalAmount += contrib.contribution_receipt_amount;
+            existing.transactionCount++;
+            existing.transactions.push({
+                amount: contrib.contribution_receipt_amount,
+                date: contrib.contribution_receipt_date,
+                rawName: contrib.contributor_name,
+            });
+            // Add variant if not already present
+            if (!existing.rawVariants.includes(contrib.contributor_name)) {
+                existing.rawVariants.push(contrib.contributor_name);
+            }
+            // Update metadata if more complete
+            if (!existing.metadata.employer && metadata.employer) {
+                existing.metadata.employer = metadata.employer;
+            }
+            if (!existing.metadata.occupation && metadata.occupation) {
+                existing.metadata.occupation = metadata.occupation;
+            }
+        }
+        else {
+            // Create new entity
+            entityMap.set(normalized.normalizedName, {
+                ...normalized,
+                totalAmount: contrib.contribution_receipt_amount,
+                transactionCount: 1,
+                transactions: [
+                    {
+                        amount: contrib.contribution_receipt_amount,
+                        date: contrib.contribution_receipt_date,
+                        rawName: contrib.contributor_name,
+                    },
+                ],
+            });
+        }
+    }
+    const result = Array.from(entityMap.values());
+    getLogger().debug(`[Entity Resolution] Deduplicated ${contributions.length} contributions into ${result.length} unique entities`);
+    return result;
+}
+/**
+ * Deduplicate and aggregate disbursements by recipient
+ */
+export function deduplicateDisbursements(disbursements) {
+    const entityMap = new Map();
+    getLogger().debug(`[Entity Resolution] Deduplicating ${disbursements.length} disbursements`);
+    for (const disb of disbursements) {
+        if (!disb.recipient_name?.trim()) {
+            continue;
+        }
+        const metadata = {
+            city: disb.recipient_city,
+            state: disb.recipient_state,
+        };
+        const normalized = normalizeEntity(disb.recipient_name, metadata);
+        // Check if we already have a matching entity
+        let matchedKey = null;
+        for (const [key, existing] of entityMap.entries()) {
+            if (entitiesMatch({
+                name: normalized.normalizedName,
+                city: metadata.city,
+                state: metadata.state,
+            }, {
+                name: existing.normalizedName,
+                city: existing.metadata.city,
+                state: existing.metadata.state,
+            })) {
+                matchedKey = key;
+                break;
+            }
+        }
+        if (matchedKey) {
+            // Add to existing entity
+            const existing = entityMap.get(matchedKey);
+            existing.totalAmount += disb.disbursement_amount;
+            existing.transactionCount++;
+            existing.transactions.push({
+                amount: disb.disbursement_amount,
+                date: disb.disbursement_date,
+                rawName: disb.recipient_name,
+            });
+            // Add variant if not already present
+            if (!existing.rawVariants.includes(disb.recipient_name)) {
+                existing.rawVariants.push(disb.recipient_name);
+            }
+        }
+        else {
+            // Create new entity
+            entityMap.set(normalized.normalizedName, {
+                ...normalized,
+                totalAmount: disb.disbursement_amount,
+                transactionCount: 1,
+                transactions: [
+                    {
+                        amount: disb.disbursement_amount,
+                        date: disb.disbursement_date,
+                        rawName: disb.recipient_name,
+                    },
+                ],
+            });
+        }
+    }
+    const result = Array.from(entityMap.values());
+    getLogger().debug(`[Entity Resolution] Deduplicated ${disbursements.length} disbursements into ${result.length} unique entities`);
+    return result;
+}
+/**
+ * Standardize employer/organization names for industry analysis
+ */
+export function standardizeEmployerName(employer) {
+    const cleaned = employer.trim();
+    const entityType = detectEntityType(cleaned);
+    if (entityType === 'organization') {
+        // Return cleaned form without corporate suffixes
+        return cleanNameForMatching(cleaned)
+            .split(' ')
+            .map(word => word.charAt(0) + word.slice(1).toLowerCase())
+            .join(' ');
+    }
+    // Keep original for individuals or unknown
+    return cleaned;
+}
+//# sourceMappingURL=fec-entity-resolution.js.map

package/dist/fec-entity-resolution.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @civiq/entity-resolution
+ *
+ * Entity resolution for civic data — committee/agency alias matching,
+ * industry taxonomy, ticker-to-sector resolution, FEC entity deduplication.
+ */
+export { configure } from './configure';
+export { setLogger, getLogger } from './logger';
+export type { Logger } from './logger';
+export { setCache, getCache } from './cache';
+export type { CacheAdapter } from './cache';
+export type { GovernmentEntityResolution, TickerResolution } from './types';
+export { IndustrySector, categorizeContribution, aggregateByIndustrySector, categorizePACByName, categorizeContributionSmart, getTopCategories, } from './industry-taxonomy';
+export type { IndustryCategory, CategorizedContribution } from './industry-taxonomy';
+export { HOUSE_COMMITTEE_MAPPINGS, SENATE_COMMITTEE_MAPPINGS, ALL_COMMITTEE_MAPPINGS, getAgenciesForCommittee, getTopicsForCommittee, getAgenciesForCommittees, getCommitteesForAgency, getTopicsForCommittees, } from './committee-agency-map';
+export type { AgencyInfo, CommitteeMapping } from './committee-agency-map';
+export { COMMITTEE_ALIASES, AGENCY_ALIASES, getAllCommitteeAliasNames, } from './committee-alias-table';
+export { resolveGovernmentEntity, resolveFilingEntities, getResolvedCommittees, } from './lobbying-committee-resolver';
+export { sicToSector } from './sic-sector-map';
+export { resolveTickerIndustry, resolveTickerIndustries } from './ticker-industry-resolver';
+export { LDA_ISSUE_POLICY_MAP, getLDAIssueLabel, getPolicyAreasForLDAIssue, getAllLDAIssueCodes, } from './lda-issue-policy-map';
+export { resolveCompanyName, resolveCompanyNames, normalizeCompanyName, companiesMatch, validateTokenOverlap, similarityRatio, } from './company-entity-resolver';
+export type { ResolvedCompany } from './company-entity-resolver';
+export { COMPANY_ALIAS_TABLE, findCompanyByAlias } from './company-alias-table';
+export type { CompanyAlias } from './company-alias-table';
+export { entitiesMatch, normalizeEntity, deduplicateContributions, deduplicateDisbursements, standardizeEmployerName, } from './fec-entity-resolution';
+export type { StandardizedEntity, AggregatedEntity } from './fec-entity-resolution';
+export { bioguideToFECMapping, getFECIdFromBioguide, hasFECMapping, addFECMapping, getBioguideFromFEC, getMappingByFEC, getMappingStats, } from './bioguide-fec-mapping';
+export type { FECMapping } from './bioguide-fec-mapping';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C,YAAY,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG5E,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAGrF,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG3E,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChF,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EACL,aAAa,EACb,eAAe,EACf,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGpF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * @civiq/entity-resolution
+ *
+ * Entity resolution for civic data — committee/agency alias matching,
+ * industry taxonomy, ticker-to-sector resolution, FEC entity deduplication.
+ */
+// ── Configuration ────────────────────────────────────────────────────
+export { configure } from './configure';
+export { setLogger, getLogger } from './logger';
+export { setCache, getCache } from './cache';
+// ── Industry Taxonomy ────────────────────────────────────────────────
+export { IndustrySector, categorizeContribution, aggregateByIndustrySector, categorizePACByName, categorizeContributionSmart, getTopCategories, } from './industry-taxonomy';
+// ── Committee-Agency Map ─────────────────────────────────────────────
+export { HOUSE_COMMITTEE_MAPPINGS, SENATE_COMMITTEE_MAPPINGS, ALL_COMMITTEE_MAPPINGS, getAgenciesForCommittee, getTopicsForCommittee, getAgenciesForCommittees, getCommitteesForAgency, getTopicsForCommittees, } from './committee-agency-map';
+// ── Committee Alias Table ────────────────────────────────────────────
+export { COMMITTEE_ALIASES, AGENCY_ALIASES, getAllCommitteeAliasNames, } from './committee-alias-table';
+// ── Lobbying Committee Resolver ──────────────────────────────────────
+export { resolveGovernmentEntity, resolveFilingEntities, getResolvedCommittees, } from './lobbying-committee-resolver';
+// ── SIC Sector Map ───────────────────────────────────────────────────
+export { sicToSector } from './sic-sector-map';
+// ── Ticker Industry Resolver ─────────────────────────────────────────
+export { resolveTickerIndustry, resolveTickerIndustries } from './ticker-industry-resolver';
+// ── LDA Issue Policy Map ─────────────────────────────────────────────
+export { LDA_ISSUE_POLICY_MAP, getLDAIssueLabel, getPolicyAreasForLDAIssue, getAllLDAIssueCodes, } from './lda-issue-policy-map';
+// ── Company Entity Resolution ────────────────────────────────────────
+export { resolveCompanyName, resolveCompanyNames, normalizeCompanyName, companiesMatch, validateTokenOverlap, similarityRatio, } from './company-entity-resolver';
+// ── Company Alias Table ─────────────────────────────────────────────
+export { COMPANY_ALIAS_TABLE, findCompanyByAlias } from './company-alias-table';
+// ── FEC Entity Resolution ────────────────────────────────────────────
+export { entitiesMatch, normalizeEntity, deduplicateContributions, deduplicateDisbursements, standardizeEmployerName, } from './fec-entity-resolution';
+// ── Bioguide-FEC Mapping ─────────────────────────────────────────────
+export { bioguideToFECMapping, getFECIdFromBioguide, hasFECMapping, addFECMapping, getBioguideFromFEC, getMappingByFEC, getMappingStats, } from './bioguide-fec-mapping';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wEAAwE;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAM7C,wEAAwE;AACxE,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,wEAAwE;AACxE,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,wEAAwE;AACxE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAEjC,wEAAwE;AACxE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAEvC,wEAAwE;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,wEAAwE;AACxE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE5F,wEAAwE;AACxE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,wEAAwE;AACxE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAGnC,uEAAuE;AACvE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhF,wEAAwE;AACxE,OAAO,EACL,aAAa,EACb,eAAe,EACf,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAGjC,wEAAwE;AACxE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,wBAAwB,CAAC"}

package/dist/industry-taxonomy.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Copyright (c) 2019-2025 Mark Sandford
+ * Licensed under the MIT License. See LICENSE and NOTICE files.
+ */
+/**
+ * Industry sector enumeration
+ */
+export declare enum IndustrySector {
+    AGRIBUSINESS = "Agribusiness",
+    COMMUNICATIONS_ELECTRONICS = "Communications/Electronics",
+    CONSTRUCTION = "Construction",
+    DEFENSE = "Defense",
+    ENERGY_NATURAL_RESOURCES = "Energy/Natural Resources",
+    FINANCE_INSURANCE_REAL_ESTATE = "Finance/Insurance/Real Estate",
+    HEALTH = "Health",
+    LAWYERS_LOBBYISTS = "Lawyers & Lobbyists",
+    TRANSPORTATION = "Transportation",
+    MISC_BUSINESS = "Misc Business",
+    LABOR = "Labor",
+    IDEOLOGY_SINGLE_ISSUE = "Ideology/Single-Issue",
+    OTHER = "Other"
+}
+/**
+ * Detailed industry category under each sector
+ */
+export interface IndustryCategory {
+    sector: IndustrySector;
+    category: string;
+    keywords: string[];
+    occupationKeywords?: string[];
+}
+/**
+ * Categorized contribution with industry classification
+ */
+export interface CategorizedContribution {
+    sector: IndustrySector;
+    category: string;
+    confidence: 'high' | 'medium' | 'low';
+    matchedKeyword?: string;
+    matchSource: 'employer' | 'occupation' | 'inferred';
+}
+/**
+ * Categorize a contribution based on employer and occupation
+ */
+export declare function categorizeContribution(employer?: string, occupation?: string): CategorizedContribution;
+/**
+ * Aggregate contributions by industry sector.
+ * Uses smart categorization when contributor_name is available,
+ * falling back to PAC name matching for unclassified contributions.
+ */
+export declare function aggregateByIndustrySector(contributions: Array<{
+    contributor_employer?: string;
+    contributor_occupation?: string;
+    contributor_name?: string;
+    contribution_receipt_amount: number;
+}>): Array<{
+    sector: IndustrySector;
+    totalAmount: number;
+    contributionCount: number;
+    percentage: number;
+    categories: Map<string, {
+        amount: number;
+        count: number;
+    }>;
+}>;
+/**
+ * Categorize a PAC/committee by its name
+ * Used for committee-to-committee transfers and PAC contributions
+ */
+export declare function categorizePACByName(committeeName?: string): CategorizedContribution;
+/**
+ * Smart categorization: tries employer/occupation first, then falls back to contributor name (for PACs)
+ */
+export declare function categorizeContributionSmart(employer?: string, occupation?: string, contributorName?: string): CategorizedContribution;
+/**
+ * Get top categories across all sectors
+ */
+export declare function getTopCategories(contributions: Array<{
+    contributor_employer?: string;
+    contributor_occupation?: string;
+    contributor_name?: string;
+    contribution_receipt_amount: number;
+}>, limit?: number): Array<{
+    sector: IndustrySector;
+    category: string;
+    totalAmount: number;
+    contributionCount: number;
+    percentage: number;
+}>;
+//# sourceMappingURL=industry-taxonomy.d.ts.map

package/dist/industry-taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"industry-taxonomy.d.ts","sourceRoot":"","sources":["../src/industry-taxonomy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH;;GAEG;AACH,oBAAY,cAAc;IACxB,YAAY,iBAAiB;IAC7B,0BAA0B,+BAA+B;IACzD,YAAY,iBAAiB;IAC7B,OAAO,YAAY;IACnB,wBAAwB,6BAA6B;IACrD,6BAA6B,kCAAkC;IAC/D,MAAM,WAAW;IACjB,iBAAiB,wBAAwB;IACzC,cAAc,mBAAmB;IACjC,aAAa,kBAAkB;IAC/B,KAAK,UAAU;IACf,qBAAqB,0BAA0B;IAC/C,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,UAAU,GAAG,YAAY,GAAG,UAAU,CAAC;CACrD;AA4aD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,uBAAuB,CA+FzB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,KAAK,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B,EAAE,MAAM,CAAC;CACrC,CAAC,GACD,KAAK,CAAC;IACP,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D,CAAC,CAuDD;AAiUD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,uBAAuB,CA6FnF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,GACvB,uBAAuB,CAqBzB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,KAAK,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2BAA2B,EAAE,MAAM,CAAC;CACrC,CAAC,EACF,KAAK,GAAE,MAAW,GACjB,KAAK,CAAC;IACP,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CA4CD"}