tn-elections-mcp 0.5.0

package/dist/api/gemini-pdf.js

@@ -0,0 +1,261 @@
+/**
+ * PDF financial data extraction.
+ *
+ * Primary: Gemini Flash (cheap, fast, handles PDFs natively)
+ * Fallback: Download PDF → pdftoppm → JPEG images → return as base64
+ *           for Claude to read directly via MCP image content.
+ *
+ * The fallback works because these are scanned PDFs (pdftotext returns empty).
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { writeFileSync, readFileSync, existsSync, mkdirSync, rmSync } from 'fs';
+import { join } from 'path';
+import { tmpdir } from 'os';
+const GEMINI_MODEL = 'gemini-2.5-flash';
+const MAX_PDF_SIZE = 10 * 1024 * 1024;
+const reportCache = new Map();
+const CACHE_TTL_MS = 30 * 60 * 1000;
+function getApiKey() {
+    return process.env.GEMINI_API_KEY || null;
+}
+const GEMINI_URL = `https://generativelanguage.googleapis.com/v1beta/models/${GEMINI_MODEL}:generateContent`;
+async function fetchPdf(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download PDF: ${response.status} ${response.statusText}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    if (buffer.length > MAX_PDF_SIZE) {
+        throw new Error(`PDF too large: ${(buffer.length / 1024 / 1024).toFixed(1)}MB (max ${MAX_PDF_SIZE / 1024 / 1024}MB)`);
+    }
+    return buffer;
+}
+const EXTRACTION_PROMPT = `Extract ALL data from this Tennessee campaign finance disclosure PDF into valid JSON.
+
+{
+  "candidateName": "string — full name as printed",
+  "officeSought": "string",
+  "reportPeriod": "string — e.g. 'Mid-Year 2023', 'Year-End 2025'",
+  "beginningBalance": number,
+  "totalContributions": number,
+  "totalExpenditures": number,
+  "endingBalance": number,
+  "contributions": [
+    {"date": "MM/DD/YYYY", "name": "contributor name", "address": "full address", "amount": number, "type": "Monetary", "employer": "string or null", "occupation": "string or null"}
+  ],
+  "expenditures": [
+    {"date": "MM/DD/YYYY", "payee": "payee name", "address": "full address", "amount": number, "purpose": "string or null"}
+  ],
+  "warnings": ["array of any extraction issues or unclear values"]
+}
+
+Rules:
+- Return ONLY the JSON object. No markdown fencing, no explanation.
+- Amounts must be numbers. $1,500.00 becomes 1500.00.
+- Empty sections get empty arrays.
+- If not a campaign finance report, return {"error": "Not a campaign finance report"}.
+- Include ALL itemized entries. Do not truncate.
+- Default contribution type to "Monetary" unless clearly In-Kind or Loan.`;
+function parseGeminiResponse(response) {
+    if (response.error) {
+        throw new Error(`Gemini API error: ${response.error.message}`);
+    }
+    const candidate = (response.candidates || [])[0];
+    if (!candidate)
+        throw new Error('Gemini returned no candidates');
+    const finishReason = candidate.finishReason || 'UNKNOWN';
+    const parts = candidate.content?.parts || [];
+    const texts = parts.filter(p => p.text).map(p => p.text);
+    if (texts.length === 0) {
+        throw new Error(`Gemini returned no text (finishReason: ${finishReason})`);
+    }
+    return { text: texts[texts.length - 1].trim(), finishReason };
+}
+function cleanJsonResponse(raw) {
+    let cleaned = raw;
+    if (cleaned.startsWith('```json'))
+        cleaned = cleaned.slice(7);
+    else if (cleaned.startsWith('```'))
+        cleaned = cleaned.slice(3);
+    if (cleaned.endsWith('```'))
+        cleaned = cleaned.slice(0, -3);
+    cleaned = cleaned.trim();
+    cleaned = cleaned.replace(/,\s*}/g, '}').replace(/,\s*]/g, ']');
+    return cleaned;
+}
+function determineConfidence(parsed, warnings) {
+    if (warnings.length === 0 && parsed.candidateName && parsed.endingBalance !== undefined)
+        return 'high';
+    if (warnings.length <= 2)
+        return 'medium';
+    return 'low';
+}
+function buildReport(parsed, reportName, model, extraWarnings) {
+    const geminiWarnings = Array.isArray(parsed.warnings) ? parsed.warnings.map(String) : [];
+    const allWarnings = [...extraWarnings, ...geminiWarnings];
+    return {
+        candidateName: String(parsed.candidateName || ''),
+        officeSought: String(parsed.officeSought || ''),
+        reportPeriod: String(parsed.reportPeriod || reportName),
+        beginningBalance: Number(parsed.beginningBalance) || 0,
+        totalContributions: Number(parsed.totalContributions) || 0,
+        totalExpenditures: Number(parsed.totalExpenditures) || 0,
+        endingBalance: Number(parsed.endingBalance) || 0,
+        contributions: Array.isArray(parsed.contributions)
+            ? parsed.contributions.map(c => ({
+                date: String(c.date || ''),
+                name: String(c.name || ''),
+                address: String(c.address || ''),
+                amount: Number(c.amount) || 0,
+                type: String(c.type || 'Monetary'),
+                employer: c.employer ? String(c.employer) : undefined,
+                occupation: c.occupation ? String(c.occupation) : undefined,
+            }))
+            : [],
+        expenditures: Array.isArray(parsed.expenditures)
+            ? parsed.expenditures.map(e => ({
+                date: String(e.date || ''),
+                payee: String(e.payee || ''),
+                address: String(e.address || ''),
+                amount: Number(e.amount) || 0,
+                purpose: e.purpose ? String(e.purpose) : undefined,
+            }))
+            : [],
+        extractionModel: model,
+        extractionConfidence: determineConfidence(parsed, allWarnings),
+        warnings: allWarnings,
+    };
+}
+// ============================================================
+// Primary: Gemini Flash extraction
+// ============================================================
+async function extractViaGemini(pdfBuffer, reportName) {
+    const base64Pdf = pdfBuffer.toString('base64');
+    const requestBody = {
+        contents: [{
+                parts: [
+                    { text: EXTRACTION_PROMPT },
+                    { inlineData: { mimeType: 'application/pdf', data: base64Pdf } },
+                ],
+            }],
+        generationConfig: {
+            temperature: 0.1,
+            maxOutputTokens: 65536,
+            thinkingConfig: { thinkingBudget: 0 },
+        },
+    };
+    let retried = false;
+    const doFetch = async () => {
+        const response = await fetch(GEMINI_URL, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-goog-api-key': getApiKey(),
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (!response.ok) {
+            const status = response.status;
+            if ((status === 429 || status >= 500) && !retried) {
+                retried = true;
+                await new Promise(r => setTimeout(r, 2000));
+                return doFetch();
+            }
+            const errorText = await response.text();
+            throw new Error(`Gemini API HTTP ${status}: ${errorText.slice(0, 500)}`);
+        }
+        return await response.json();
+    };
+    const geminiResult = await doFetch();
+    const { text: rawText, finishReason } = parseGeminiResponse(geminiResult);
+    const cleanedJson = cleanJsonResponse(rawText);
+    const warnings = [];
+    if (finishReason === 'MAX_TOKENS') {
+        warnings.push('Response was truncated (MAX_TOKENS). Some data may be missing.');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(cleanedJson);
+    }
+    catch {
+        throw new Error(`Failed to parse Gemini JSON. finishReason: ${finishReason}. First 500 chars: ${rawText.slice(0, 500)}`);
+    }
+    if (parsed.error) {
+        throw new Error(`Gemini extraction: ${parsed.error}`);
+    }
+    return buildReport(parsed, reportName, GEMINI_MODEL, warnings);
+}
+const execFileAsync = promisify(execFile);
+async function convertPdfToImages(pdfBuffer, maxPages = 10) {
+    const tmpDir = join(tmpdir(), `tn-elections-pdf-${Date.now()}`);
+    mkdirSync(tmpDir, { recursive: true });
+    const pdfPath = join(tmpDir, 'report.pdf');
+    writeFileSync(pdfPath, pdfBuffer);
+    try {
+        // Convert PDF pages to JPEG (async, non-blocking)
+        await execFileAsync('pdftoppm', [
+            '-f', '1', '-l', String(maxPages),
+            '-jpeg', '-jpegopt', 'quality=60', '-r', '200',
+            pdfPath, join(tmpDir, 'page'),
+        ], { timeout: 30_000 });
+        const images = [];
+        for (let i = 1; i <= maxPages; i++) {
+            // pdftoppm names files page-01.jpg, page-02.jpg, etc.
+            const padded = String(i).padStart(String(maxPages).length, '0');
+            const imgPath = join(tmpDir, `page-${padded}.jpg`);
+            if (existsSync(imgPath)) {
+                const imgBuffer = readFileSync(imgPath);
+                images.push({
+                    page: i,
+                    base64: imgBuffer.toString('base64'),
+                    mimeType: 'image/jpeg',
+                });
+            }
+        }
+        return {
+            type: 'image_fallback',
+            pageCount: images.length,
+            images,
+            message: `Gemini unavailable. Converted ${images.length} PDF page(s) to images. Please read these images to extract the campaign finance data.`,
+        };
+    }
+    finally {
+        try {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch { /* ignore cleanup errors */ }
+    }
+}
+// ============================================================
+// Public API
+// ============================================================
+export async function extractReportFromPdf(pdfUrl, reportName) {
+    // Check cache
+    const cached = reportCache.get(pdfUrl);
+    if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {
+        return cached.data;
+    }
+    const pdfBuffer = await fetchPdf(pdfUrl);
+    // Try Gemini first
+    const apiKey = getApiKey();
+    if (apiKey) {
+        try {
+            const report = await extractViaGemini(pdfBuffer, reportName);
+            reportCache.set(pdfUrl, { data: report, timestamp: Date.now() });
+            return report;
+        }
+        catch (error) {
+            // Gemini failed — fall through to image fallback
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error(`Gemini extraction failed, falling back to images: ${msg}`);
+        }
+    }
+    // Fallback: convert to images for Claude to read
+    return await convertPdfToImages(pdfBuffer);
+}
+/** Check if a result is the image fallback (not structured data) */
+export function isImageFallback(result) {
+    return 'type' in result && result.type === 'image_fallback';
+}
+//# sourceMappingURL=gemini-pdf.js.map

package/dist/api/gemini-pdf.js.map

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

package/dist/api/sos-client.d.ts

@@ -0,0 +1,15 @@
+/**
+ * TN Secretary of State candidate filings client.
+ * Fetches xlsx files from sos.tn.gov and parses them into typed candidate data.
+ * No auth, no sessions — just static page scraping + xlsx download.
+ */
+import type { SosCandidateIndex } from '../types.js';
+/**
+ * Fetch and parse all SOS candidate filing data for a given election year.
+ *
+ * 1. Fetches the HTML page listing xlsx/pdf download links
+ * 2. Downloads all xlsx files in parallel
+ * 3. Parses each into typed candidate records
+ * 4. Caches the combined result for 15 minutes
+ */
+export declare function getFiledCandidates(year?: number): Promise<SosCandidateIndex>;

package/dist/api/sos-client.js

@@ -0,0 +1,74 @@
+/**
+ * TN Secretary of State candidate filings client.
+ * Fetches xlsx files from sos.tn.gov and parses them into typed candidate data.
+ * No auth, no sessions — just static page scraping + xlsx download.
+ */
+import { parseCandidateListPage, parseXlsx } from '../parsers/sos-xlsx.js';
+const TIMEOUT_MS = 15_000;
+const CACHE_TTL_MS = 15 * 60 * 1000; // 15 minutes
+const cache = new Map();
+function buildPageUrl(year) {
+    return `https://sos.tn.gov/elections/${year}-candidate-lists`;
+}
+async function fetchWithTimeout(url) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status} fetching ${url}`);
+        }
+        return response;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Fetch and parse all SOS candidate filing data for a given election year.
+ *
+ * 1. Fetches the HTML page listing xlsx/pdf download links
+ * 2. Downloads all xlsx files in parallel
+ * 3. Parses each into typed candidate records
+ * 4. Caches the combined result for 15 minutes
+ */
+export async function getFiledCandidates(year = 2026) {
+    // Check cache
+    const cached = cache.get(year);
+    if (cached && Date.now() - cached.fetchedAt < CACHE_TTL_MS) {
+        return cached;
+    }
+    // Fetch the HTML page
+    const pageUrl = buildPageUrl(year);
+    const pageResponse = await fetchWithTimeout(pageUrl);
+    const html = await pageResponse.text();
+    // Parse office categories with xlsx/pdf URLs
+    const offices = parseCandidateListPage(html);
+    if (offices.length === 0) {
+        throw new Error(`No candidate list files found at ${pageUrl}. The page may have changed structure or the year may not be available.`);
+    }
+    // Download all xlsx files in parallel (small files, ~10-18KB each)
+    const xlsxResults = await Promise.all(offices.map(async (office) => {
+        const response = await fetchWithTimeout(office.xlsxUrl);
+        const buffer = await response.arrayBuffer();
+        return { office, buffer };
+    }));
+    // Parse each xlsx file
+    const allCandidates = xlsxResults.flatMap(({ office, buffer }) => {
+        const candidates = parseXlsx(buffer, office.name, year);
+        office.candidateCount = candidates.length;
+        return candidates;
+    });
+    const index = {
+        year,
+        offices,
+        candidates: allCandidates,
+        fetchedAt: Date.now(),
+    };
+    // Cache (don't cache empty results — might be a fetch issue)
+    if (allCandidates.length > 0) {
+        cache.set(year, index);
+    }
+    return index;
+}
+//# sourceMappingURL=sos-client.js.map

package/dist/api/sos-client.js.map

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

package/dist/api/sumner-client.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sumner County campaign finance client.
+ * Scrapes static HTML pages from votesumnertn.org.
+ * No auth, no session management, UTF-8.
+ */
+import type { SumnerCyclePage, SumnerElectionCycle, SumnerReportData } from '../types.js';
+import type { PdfImageFallback } from './gemini-pdf.js';
+import { resolveCycle } from '../data/sumner-cycles.js';
+export declare function listCycles(): SumnerElectionCycle[];
+export { resolveCycle };
+export declare function getCycleCandidates(cycleInput: string): Promise<SumnerCyclePage>;
+export declare function getReport(pdfUrl: string, reportName: string): Promise<SumnerReportData | PdfImageFallback>;

package/dist/api/sumner-client.js

@@ -0,0 +1,57 @@
+/**
+ * Sumner County campaign finance client.
+ * Scrapes static HTML pages from votesumnertn.org.
+ * No auth, no session management, UTF-8.
+ */
+import { SUMNER_CYCLES, resolveCycle } from '../data/sumner-cycles.js';
+import { parseSumnerCyclePage } from '../parsers/sumner-html.js';
+import { extractReportFromPdf } from './gemini-pdf.js';
+const TIMEOUT_MS = 15_000;
+const cyclePageCache = new Map();
+const CACHE_TTL_MS = 15 * 60 * 1000;
+async function fetchPage(url) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+    try {
+        const response = await fetch(url, {
+            signal: controller.signal,
+            headers: { 'Accept': 'text/html' },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status} fetching ${url}`);
+        }
+        return await response.text();
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export function listCycles() {
+    return SUMNER_CYCLES;
+}
+export { resolveCycle };
+export async function getCycleCandidates(cycleInput) {
+    const cycle = resolveCycle(cycleInput);
+    if (!cycle) {
+        const available = SUMNER_CYCLES.map(c => c.year).join(', ');
+        throw new Error(`Cycle "${cycleInput}" not found. Available: ${available}`);
+    }
+    const cached = cyclePageCache.get(cycle.year);
+    if (cached && Date.now() - cached.timestamp < CACHE_TTL_MS) {
+        return cached.data;
+    }
+    const html = await fetchPage(cycle.url);
+    const result = parseSumnerCyclePage(html, cycle);
+    if (result.candidates.length === 0) {
+        result.candidates = []; // ensure empty array not undefined
+        // Don't cache empty results — might be a parsing issue
+    }
+    else {
+        cyclePageCache.set(cycle.year, { data: result, timestamp: Date.now() });
+    }
+    return result;
+}
+export async function getReport(pdfUrl, reportName) {
+    return extractReportFromPdf(pdfUrl, reportName);
+}
+//# sourceMappingURL=sumner-client.js.map

package/dist/api/sumner-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sumner-client.js","sourceRoot":"","sources":["../../src/api/sumner-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEtD,MAAM,UAAU,GAAG,MAAM,CAAA;AACzB,MAAM,cAAc,GAAG,IAAI,GAAG,EAAwD,CAAA;AACtF,MAAM,YAAY,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAEnC,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,UAAU,CAAC,CAAA;IAChE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE;SACnC,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC,CAAA;QAC5D,CAAC;QACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAC9B,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAA;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,aAAa,CAAA;AACtB,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAA;AAEvB,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,UAAkB;IACzD,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAA;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3D,MAAM,IAAI,KAAK,CAAC,UAAU,UAAU,2BAA2B,SAAS,EAAE,CAAC,CAAA;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7C,IAAI,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QAC3D,OAAO,MAAM,CAAC,IAAI,CAAA;IACpB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACvC,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAEhD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,UAAU,GAAG,EAAE,CAAA,CAAC,mCAAmC;QAC1D,uDAAuD;IACzD,CAAC;SAAM,CAAC;QACN,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACzE,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAc,EAAE,UAAkB;IAChE,OAAO,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AACjD,CAAC"}

package/dist/api/tncamp-client.d.ts

@@ -0,0 +1,61 @@
+/**
+ * tncamp (Tennessee Registry of Election Finance) HTTP client.
+ *
+ * Session-based Java web app at apps.tn.gov/tncamp/public/.
+ * Flow: GET form → POST → 302 redirect → GET results page.
+ * Responses are Windows-1252 encoded.
+ */
+import type { TncampCandidate, TncampReport, TncampReportDetail, TncampContribution, TncampExpenditure, TncampFormOptions, TncampDistrict, TncampOffice, TncampElectionYear } from '../types.js';
+export declare function getFormOptions(): Promise<TncampFormOptions>;
+export declare function getDistricts(officeId: string): Promise<TncampDistrict[]>;
+export declare function resolveOffice(nameOrId: string): Promise<TncampOffice | null>;
+export declare function resolveDistrict(officeId: string, labelOrId: string): Promise<TncampDistrict | null>;
+export declare function resolveElectionYear(yearStr: string): Promise<TncampElectionYear | null>;
+export declare function resolveParty(nameOrId: string): Promise<{
+    id: string;
+    name: string;
+} | null>;
+export interface CandidateSearchParams {
+    name?: string;
+    searchType?: 'candidate' | 'pac' | 'both';
+    officeId?: string;
+    district?: string;
+    electionYearId?: string;
+    partyId?: string;
+}
+export declare function searchCandidates(params: CandidateSearchParams): Promise<TncampCandidate[]>;
+export declare function getCandidateReports(candidateId: number, ownerName: string): Promise<TncampReport[]>;
+export declare function getReportDetail(reportId: number): Promise<TncampReportDetail>;
+export interface ContributionSearchParams {
+    candName?: string;
+    contributorName?: string;
+    employer?: string;
+    occupation?: string;
+    zipCode?: string;
+    typeOf?: 'monetary' | 'inkind' | 'independent' | 'all';
+    amountDollars?: number;
+    amountSelection?: 'equal' | 'greater' | 'less';
+    year: string;
+    electionYearId?: string;
+}
+export interface ExpenditureSearchParams {
+    candName?: string;
+    vendorName?: string;
+    vendorZipCode?: string;
+    purpose?: string;
+    typeOf?: 'monetary' | 'inkind' | 'independent' | 'all';
+    amountDollars?: number;
+    amountSelection?: 'equal' | 'greater' | 'less';
+    year: string;
+    electionYearId?: string;
+}
+export declare function searchContributions(params: ContributionSearchParams): Promise<{
+    items: TncampContribution[];
+    totalCount: number;
+    truncated: boolean;
+}>;
+export declare function searchExpenditures(params: ExpenditureSearchParams): Promise<{
+    items: TncampExpenditure[];
+    totalCount: number;
+    truncated: boolean;
+}>;