openstates-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/search-people.tool.js

@@ -0,0 +1,193 @@
+/**
+ * @fileoverview Search state legislators and officials by name, jurisdiction, chamber, or district.
+ * @module mcp-server/tools/definitions/search-people
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenStatesApiService } from '../../../services/openstates/openstates-service.js';
+const PersonIncludeEnum = z.enum([
+    'other_names',
+    'other_identifiers',
+    'links',
+    'sources',
+    'offices',
+]);
+export const searchPeople = tool('openstates_search_people', {
+    title: 'Search People',
+    description: 'Search state legislators and officials by name, jurisdiction, chamber, district, or party. Supports name substring matching (case-insensitive). Use org_classification to target a specific chamber: "upper" for Senate, "lower" for House/Assembly, "legislature" for all legislators, "executive" for governors and executive officials. Use include=offices to get phone, fax, and address. Use include=links for website and social links. Strongly recommend providing jurisdiction to scope results — omitting it returns legislators across all states.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        jurisdiction: z
+            .string()
+            .optional()
+            .describe('State name, abbreviation, or OCD-ID. Strongly recommended — omitting returns legislators across all states.'),
+        name: z
+            .string()
+            .optional()
+            .describe('Name or partial name to match (case-insensitive substring).'),
+        org_classification: z
+            .enum(['legislature', 'executive', 'lower', 'upper', 'government'])
+            .optional()
+            .describe('Filter by role type. "upper" = Senate, "lower" = House/Assembly, "legislature" = all legislators, "executive" = governors and executive officials.'),
+        district: z
+            .string()
+            .optional()
+            .describe('District label (e.g., "1", "37", "At-Large"). Formats vary by state.'),
+        include: z
+            .array(PersonIncludeEnum)
+            .optional()
+            .describe('Related data to inline. "offices" includes phone, fax, and address. "links" includes website and social links.'),
+        page: z.coerce.number().int().min(1).default(1).describe('Page number (1-indexed).'),
+        per_page: z.coerce
+            .number()
+            .int()
+            .min(1)
+            .max(20)
+            .default(10)
+            .describe('Results per page. Maximum 20.'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            id: z.string().describe('OCD person ID.'),
+            name: z.string().describe('Full name.'),
+            party: z.string().describe('Primary party label. Empty string when unknown.'),
+            current_role: z
+                .object({
+                title: z.string().describe('Role title (e.g., "Senator", "Representative").'),
+                org_classification: z
+                    .string()
+                    .describe('Chamber classification (e.g., "upper", "lower").'),
+                district: z
+                    .string()
+                    .nullable()
+                    .describe('District label or null when undistricted.'),
+            })
+                .nullable()
+                .describe('Current role or null when no active role is recorded.'),
+            jurisdiction: z
+                .object({
+                id: z.string().describe('OCD jurisdiction ID.'),
+                name: z.string().describe('Jurisdiction name.'),
+            })
+                .describe('Home jurisdiction.'),
+            given_name: z.string().describe('Given (first) name.'),
+            family_name: z.string().describe('Family (last) name.'),
+            email: z.string().describe('Email address. Empty string when not available.'),
+            openstates_url: z.string().describe('Open States profile URL.'),
+            offices: z
+                .array(z
+                .object({
+                name: z.string().describe('Office name or label.'),
+                classification: z.string().describe('Office type.'),
+                voice: z.string().optional().describe('Phone number when available.'),
+                fax: z.string().optional().describe('Fax number when available.'),
+                address: z.string().optional().describe('Mailing address when available.'),
+            })
+                .describe('Contact office record.'))
+                .optional()
+                .describe('Contact offices when include=offices is requested.'),
+            links: z
+                .array(z
+                .object({
+                url: z.string().describe('Link URL.'),
+                note: z.string().describe('Link description (e.g., "website", "twitter").'),
+            })
+                .describe('External link record.'))
+                .optional()
+                .describe('Website and social links when include=links is requested.'),
+        })
+            .describe('Legislator record.'))
+            .describe('Legislators matching the search criteria.'),
+        pagination: z
+            .object({
+            page: z.number().describe('Current page.'),
+            per_page: z.number().describe('Results per page.'),
+            max_page: z.number().describe('Total pages.'),
+            total_items: z.number().describe('Total matching legislators.'),
+        })
+            .describe('Pagination metadata.'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when results are empty. Absent when results are returned.'),
+    }),
+    async handler(input, ctx) {
+        const svc = getOpenStatesApiService();
+        const result = await svc.searchPeople({
+            jurisdiction: input.jurisdiction,
+            name: input.name,
+            org_classification: input.org_classification,
+            district: input.district,
+            include: input.include && input.include.length > 0 ? input.include : undefined,
+            page: input.page,
+            per_page: input.per_page,
+        }, ctx);
+        ctx.log.info('Searched people', {
+            jurisdiction: input.jurisdiction,
+            count: result.results.length,
+            total: result.pagination.total_items,
+        });
+        if (result.results.length === 0) {
+            const filters = [];
+            if (input.jurisdiction)
+                filters.push(`jurisdiction="${input.jurisdiction}"`);
+            if (input.name)
+                filters.push(`name="${input.name}"`);
+            if (input.org_classification)
+                filters.push(`org_classification="${input.org_classification}"`);
+            if (input.district)
+                filters.push(`district="${input.district}"`);
+            return {
+                results: [],
+                pagination: result.pagination,
+                message: `No legislators matched ${filters.join(', ')}. Try broadening the name filter, checking the jurisdiction, or removing the district filter.`,
+            };
+        }
+        return { results: result.results, pagination: result.pagination };
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.pagination.total_items} legislators** (page ${result.pagination.page}/${result.pagination.max_page}, per page ${result.pagination.per_page}, showing ${result.results.length})`,
+        ];
+        if (result.message) {
+            lines.push('');
+            lines.push(`> ${result.message}`);
+        }
+        for (const person of result.results) {
+            lines.push('');
+            lines.push(`## ${person.name}`);
+            lines.push(`**ID:** ${person.id}`);
+            lines.push(`**Given name:** ${person.given_name} | **Family name:** ${person.family_name}`);
+            lines.push(`**Party:** ${person.party || 'Not available'}`);
+            lines.push(`**Jurisdiction:** ${person.jurisdiction.name} (${person.jurisdiction.id})`);
+            if (person.current_role) {
+                const district = person.current_role.district
+                    ? ` — District ${person.current_role.district}`
+                    : '';
+                lines.push(`**Role:** ${person.current_role.title} (${person.current_role.org_classification})${district}`);
+            }
+            if (person.email)
+                lines.push(`**Email:** ${person.email}`);
+            if (person.openstates_url)
+                lines.push(`**URL:** ${person.openstates_url}`);
+            if (person.offices?.length) {
+                for (const office of person.offices) {
+                    const parts = [`${office.name} [${office.classification}]`];
+                    if (office.voice)
+                        parts.push(`Phone: ${office.voice}`);
+                    if (office.fax)
+                        parts.push(`Fax: ${office.fax}`);
+                    if (office.address)
+                        parts.push(`Address: ${office.address}`);
+                    lines.push(`**Office:** ${parts.join(' | ')}`);
+                }
+            }
+            if (person.links?.length) {
+                lines.push(`**Links:** ${person.links.map((l) => `${l.note}: ${l.url}`).join(', ')}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-people.tool.js.map

package/dist/mcp-server/tools/definitions/search-people.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-people.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-people.tool.ts"],"names":[],"mappings":"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"}

package/dist/services/openstates/openstates-service.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Open States API v3 REST client — auth, pagination, retry, response normalization.
+ * @module services/openstates/openstates-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import type { ServerConfig } from '../../config/server-config.js';
+import type { Bill, BillListResponse, BillSearchParams, Committee, CommitteeListResponse, CommitteeSearchParams, Event, EventListResponse, EventSearchParams, Jurisdiction, JurisdictionListParams, JurisdictionListResponse, PeopleSearchParams, PersonListResponse } from './types.js';
+export declare class OpenStatesApiService {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(_appConfig: AppConfig, _storage: StorageService, serverConfig: ServerConfig);
+    private buildUrl;
+    private fetchJson;
+    searchBills(params: BillSearchParams, ctx: Context): Promise<BillListResponse>;
+    getBillByPath(jurisdiction: string, session: string, billId: string, include: string[] | undefined, ctx: Context): Promise<Bill>;
+    getBillById(openstatesId: string, include: string[] | undefined, ctx: Context): Promise<Bill>;
+    searchPeople(params: PeopleSearchParams, ctx: Context): Promise<PersonListResponse>;
+    getPeopleByGeo(lat: number, lng: number, include: string[] | undefined, ctx: Context): Promise<PersonListResponse>;
+    searchCommittees(params: CommitteeSearchParams, ctx: Context): Promise<CommitteeListResponse>;
+    getCommittee(committeeId: string, include: string[] | undefined, ctx: Context): Promise<Committee>;
+    searchEvents(params: EventSearchParams, ctx: Context): Promise<EventListResponse>;
+    getEvent(eventId: string, include: string[] | undefined, ctx: Context): Promise<Event>;
+    listJurisdictions(params: JurisdictionListParams, ctx: Context): Promise<JurisdictionListResponse>;
+    getJurisdiction(jurisdictionId: string, include: string[] | undefined, ctx: Context): Promise<Jurisdiction>;
+}
+export declare function initOpenStatesApiService(appConfig: AppConfig, storage: StorageService, serverConfig: ServerConfig): void;
+export declare function getOpenStatesApiService(): OpenStatesApiService;
+//# sourceMappingURL=openstates-service.d.ts.map

package/dist/services/openstates/openstates-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openstates-service.d.ts","sourceRoot":"","sources":["../../../src/services/openstates/openstates-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EACV,IAAI,EACJ,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,EACL,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAElB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AA0CpB,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY;IAOvF,OAAO,CAAC,QAAQ;YAeF,SAAS;IAwCjB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsB9E,aAAa,CACjB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC;IAWV,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,IAAI,CAAC;IAUV,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsBnF,cAAc,CAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,kBAAkB,CAAC;IAcxB,gBAAgB,CACpB,MAAM,EAAE,qBAAqB,EAC7B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,qBAAqB,CAAC;IA2B3B,YAAY,CAChB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,SAAS,CAAC;IAYf,YAAY,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAejF,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC;IAQtF,iBAAiB,CACrB,MAAM,EAAE,sBAAsB,EAC9B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,wBAAwB,CAAC;IAY9B,eAAe,CACnB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,EAC7B,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,YAAY,CAAC;CAKzB;AAMD,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,YAAY,GACzB,IAAI,CAEN;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAO9D"}

package/dist/services/openstates/openstates-service.js

@@ -0,0 +1,246 @@
+/**
+ * @fileoverview Open States API v3 REST client — auth, pagination, retry, response normalization.
+ * @module services/openstates/openstates-service
+ */
+import { httpErrorFromResponse, withRetry } from '@cyanheads/mcp-ts-core/utils';
+/** Normalize the upstream `party` field — may be string or array of objects. */
+function normalizeParty(party) {
+    if (!party)
+        return '';
+    if (typeof party === 'string')
+        return party;
+    // Array of party objects — prefer the one with no end_date (current)
+    const active = party.find((p) => !p.end_date);
+    return active?.name ?? party[0]?.name ?? '';
+}
+/** Normalize a raw membership record — API returns `person: {id, name}` not flat `person_id`. */
+function normalizeMembership(raw) {
+    const person = raw['person'];
+    return {
+        person_id: person?.id ?? raw['person_id'] ?? '',
+        person_name: raw['person_name'] ?? person?.name ?? '',
+        role: raw['role'] ?? '',
+    };
+}
+function normalizePerson(raw) {
+    const person = {
+        id: raw.id,
+        name: raw.name,
+        party: normalizeParty(raw.party),
+        current_role: raw.current_role ?? null,
+        jurisdiction: raw.jurisdiction ?? { id: '', name: '' },
+        given_name: raw.given_name ?? '',
+        family_name: raw.family_name ?? '',
+        email: raw.email ?? '',
+        openstates_url: raw.openstates_url ?? '',
+    };
+    if (raw.offices?.length)
+        person.offices = raw.offices;
+    if (raw.links?.length)
+        person.links = raw.links;
+    return person;
+}
+export class OpenStatesApiService {
+    baseUrl;
+    apiKey;
+    constructor(_appConfig, _storage, serverConfig) {
+        this.baseUrl = serverConfig.apiBaseUrl.replace(/\/$/, '');
+        this.apiKey = serverConfig.apiKey;
+    }
+    // --- Internal HTTP plumbing ---
+    buildUrl(path, params = {}) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null)
+                continue;
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    url.searchParams.append(key, String(item));
+                }
+            }
+            else {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        return url.toString();
+    }
+    async fetchJson(url, ctx) {
+        return withRetry(async () => {
+            const response = await fetch(url, {
+                headers: {
+                    'X-API-KEY': this.apiKey,
+                    Accept: 'application/json',
+                },
+                signal: ctx.signal,
+            });
+            if (!response.ok) {
+                throw await httpErrorFromResponse(response, {
+                    service: 'OpenStates',
+                    data: { url },
+                });
+            }
+            const text = await response.text();
+            // HTML error page detection
+            if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                const { serviceUnavailable } = await import('@cyanheads/mcp-ts-core/errors');
+                throw serviceUnavailable('Open States API returned HTML instead of JSON — likely rate-limited or unavailable.', { url });
+            }
+            return JSON.parse(text);
+        }, {
+            operation: 'OpenStatesApiService.fetchJson',
+            baseDelayMs: 1500,
+            signal: ctx.signal,
+        });
+    }
+    // --- Bills ---
+    async searchBills(params, ctx) {
+        const queryParams = {
+            jurisdiction: params.jurisdiction,
+            q: params.q,
+            session: params.session,
+            chamber: params.chamber,
+            classification: params.classification,
+            subject: params.subject,
+            sponsor: params.sponsor,
+            sponsor_classification: params.sponsor_classification,
+            sort: params.sort,
+            action_since: params.action_since,
+            updated_since: params.updated_since,
+            include: params.include,
+            page: params.page ?? 1,
+            per_page: params.per_page ?? 10,
+        };
+        const url = this.buildUrl('/bills', queryParams);
+        ctx.log.debug('Searching bills', { url: url.replace(this.apiKey, '[redacted]') });
+        return this.fetchJson(url, ctx);
+    }
+    async getBillByPath(jurisdiction, session, billId, include, ctx) {
+        const encodedJur = encodeURIComponent(jurisdiction);
+        const encodedSession = encodeURIComponent(session);
+        const encodedBillId = encodeURIComponent(billId);
+        const url = this.buildUrl(`/bills/${encodedJur}/${encodedSession}/${encodedBillId}`, {
+            include,
+        });
+        ctx.log.debug('Fetching bill by path', { jurisdiction, session, billId });
+        return this.fetchJson(url, ctx);
+    }
+    async getBillById(openstatesId, include, ctx) {
+        // OCD bill IDs are like "ocd-bill/..." — strip the prefix for URL routing
+        // The API accepts the full OCD ID in the path
+        const url = this.buildUrl(`/bills/${openstatesId}`, { include });
+        ctx.log.debug('Fetching bill by OCD ID', { openstatesId });
+        return this.fetchJson(url, ctx);
+    }
+    // --- People ---
+    async searchPeople(params, ctx) {
+        const queryParams = {
+            jurisdiction: params.jurisdiction,
+            name: params.name,
+            org_classification: params.org_classification,
+            district: params.district,
+            include: params.include,
+            page: params.page ?? 1,
+            per_page: params.per_page ?? 10,
+        };
+        const url = this.buildUrl('/people', queryParams);
+        ctx.log.debug('Searching people', { jurisdiction: params.jurisdiction });
+        const raw = await this.fetchJson(url, ctx);
+        return {
+            results: raw.results.map(normalizePerson),
+            pagination: raw.pagination,
+        };
+    }
+    async getPeopleByGeo(lat, lng, include, ctx) {
+        const url = this.buildUrl('/people.geo', { lat, lng, include });
+        ctx.log.debug('Fetching legislators by geo', { lat, lng });
+        const raw = await this.fetchJson(url, ctx);
+        // geo endpoint doesn't return pagination — synthesize one
+        const results = raw.results.map(normalizePerson);
+        return {
+            results,
+            pagination: { page: 1, per_page: results.length, max_page: 1, total_items: results.length },
+        };
+    }
+    // --- Committees ---
+    async searchCommittees(params, ctx) {
+        const queryParams = {
+            jurisdiction: params.jurisdiction,
+            classification: params.classification,
+            chamber: params.chamber,
+            parent: params.parent,
+            include: params.include,
+            page: params.page ?? 1,
+            per_page: params.per_page ?? 10,
+        };
+        const url = this.buildUrl('/committees', queryParams);
+        ctx.log.debug('Searching committees', { jurisdiction: params.jurisdiction });
+        const raw = await this.fetchJson(url, ctx);
+        return {
+            pagination: raw.pagination,
+            results: raw.results.map((c) => {
+                const memberships = Array.isArray(c['memberships'])
+                    ? c['memberships'].map(normalizeMembership)
+                    : undefined;
+                return { ...c, memberships };
+            }),
+        };
+    }
+    async getCommittee(committeeId, include, ctx) {
+        const url = this.buildUrl(`/committees/${encodeURIComponent(committeeId)}`, { include });
+        ctx.log.debug('Fetching committee', { committeeId });
+        const raw = await this.fetchJson(url, ctx);
+        const memberships = Array.isArray(raw['memberships'])
+            ? raw['memberships'].map(normalizeMembership)
+            : undefined;
+        return { ...raw, memberships };
+    }
+    // --- Events ---
+    async searchEvents(params, ctx) {
+        const queryParams = {
+            jurisdiction: params.jurisdiction,
+            after: params.after,
+            before: params.before,
+            require_bills: params.require_bills ? 'true' : undefined,
+            include: params.include,
+            page: params.page ?? 1,
+            per_page: params.per_page ?? 10,
+        };
+        const url = this.buildUrl('/events', queryParams);
+        ctx.log.debug('Searching events', { jurisdiction: params.jurisdiction });
+        return this.fetchJson(url, ctx);
+    }
+    async getEvent(eventId, include, ctx) {
+        const url = this.buildUrl(`/events/${encodeURIComponent(eventId)}`, { include });
+        ctx.log.debug('Fetching event', { eventId });
+        return this.fetchJson(url, ctx);
+    }
+    // --- Jurisdictions ---
+    async listJurisdictions(params, ctx) {
+        const queryParams = {
+            classification: params.classification ?? 'state',
+            include: params.include,
+            page: params.page ?? 1,
+            per_page: params.per_page ?? 52,
+        };
+        const url = this.buildUrl('/jurisdictions', queryParams);
+        ctx.log.debug('Listing jurisdictions', { classification: params.classification });
+        return this.fetchJson(url, ctx);
+    }
+    async getJurisdiction(jurisdictionId, include, ctx) {
+        const url = this.buildUrl(`/jurisdictions/${encodeURIComponent(jurisdictionId)}`, { include });
+        ctx.log.debug('Fetching jurisdiction', { jurisdictionId });
+        return this.fetchJson(url, ctx);
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initOpenStatesApiService(appConfig, storage, serverConfig) {
+    _service = new OpenStatesApiService(appConfig, storage, serverConfig);
+}
+export function getOpenStatesApiService() {
+    if (!_service) {
+        throw new Error('OpenStatesApiService not initialized — call initOpenStatesApiService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=openstates-service.js.map

package/dist/services/openstates/openstates-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openstates-service.js","sourceRoot":"","sources":["../../../src/services/openstates/openstates-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAqBhF,gFAAgF;AAChF,SAAS,cAAc,CAAC,KAAyB;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,qEAAqE;IACrE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9C,OAAO,MAAM,EAAE,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,iGAAiG;AACjG,SAAS,mBAAmB,CAAC,GAA4B;IAKvD,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAA+C,CAAC;IAC3E,OAAO;QACL,SAAS,EAAE,MAAM,EAAE,EAAE,IAAK,GAAG,CAAC,WAAW,CAAwB,IAAI,EAAE;QACvE,WAAW,EAAG,GAAG,CAAC,aAAa,CAAwB,IAAI,MAAM,EAAE,IAAI,IAAI,EAAE;QAC7E,IAAI,EAAG,GAAG,CAAC,MAAM,CAAwB,IAAI,EAAE;KAChD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAc;IACrC,MAAM,MAAM,GAAW;QACrB,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC;QAChC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,IAAI;QACtC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACtD,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;QAChC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;QAClC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;QACtB,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;KACzC,CAAC;IACF,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM;QAAE,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IACtD,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM;QAAE,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,OAAO,oBAAoB;IACd,OAAO,CAAS;IAChB,MAAM,CAAS;IAEhC,YAAY,UAAqB,EAAE,QAAwB,EAAE,YAA0B;QACrF,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IACpC,CAAC;IAED,iCAAiC;IAEzB,QAAQ,CAAC,IAAY,EAAE,SAAkC,EAAE;QACjE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC,CAAC;QAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,SAAS,CAAI,GAAW,EAAE,GAAY;QAClD,OAAO,SAAS,CACd,KAAK,IAAI,EAAE;YACT,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE;oBACP,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,MAAM,EAAE,kBAAkB;iBAC3B;gBACD,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,MAAM,qBAAqB,CAAC,QAAQ,EAAE;oBAC1C,OAAO,EAAE,YAAY;oBACrB,IAAI,EAAE,EAAE,GAAG,EAAE;iBACd,CAAC,CAAC;YACL,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,4BAA4B;YAC5B,IAAI,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnD,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;gBAC7E,MAAM,kBAAkB,CACtB,qFAAqF,EACrF,EAAE,GAAG,EAAE,CACR,CAAC;YACJ,CAAC;YAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;QAC/B,CAAC,EACD;YACE,SAAS,EAAE,gCAAgC;YAC3C,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CACF,CAAC;IACJ,CAAC;IAED,gBAAgB;IAEhB,KAAK,CAAC,WAAW,CAAC,MAAwB,EAAE,GAAY;QACtD,MAAM,WAAW,GAA4B;YAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,sBAAsB,EAAE,MAAM,CAAC,sBAAsB;YACrD,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAChC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC,SAAS,CAAmB,GAAG,EAAE,GAAG,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,YAAoB,EACpB,OAAe,EACf,MAAc,EACd,OAA6B,EAC7B,GAAY;QAEZ,MAAM,UAAU,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACnD,MAAM,aAAa,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,UAAU,IAAI,cAAc,IAAI,aAAa,EAAE,EAAE;YACnF,OAAO;SACR,CAAC,CAAC;QACH,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,SAAS,CAAO,GAAG,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,WAAW,CACf,YAAoB,EACpB,OAA6B,EAC7B,GAAY;QAEZ,0EAA0E;QAC1E,8CAA8C;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACjE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,SAAS,CAAO,GAAG,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,iBAAiB;IAEjB,KAAK,CAAC,YAAY,CAAC,MAA0B,EAAE,GAAY;QACzD,MAAM,WAAW,GAA4B;YAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;YAC7C,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAChC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAG7B,GAAG,EAAE,GAAG,CAAC,CAAC;QACb,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;YACzC,UAAU,EAAE,GAAG,CAAC,UAAU;SAC3B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,GAAW,EACX,GAAW,EACX,OAA6B,EAC7B,GAAY;QAEZ,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QAChE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAA2B,GAAG,EAAE,GAAG,CAAC,CAAC;QACrE,0DAA0D;QAC1D,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACjD,OAAO;YACL,OAAO;YACP,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE;SAC5F,CAAC;IACJ,CAAC;IAED,qBAAqB;IAErB,KAAK,CAAC,gBAAgB,CACpB,MAA6B,EAC7B,GAAY;QAEZ,MAAM,WAAW,GAA4B;YAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAChC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QACtD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAC7E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAG7B,GAAG,EAAE,GAAG,CAAC,CAAC;QACb,OAAO;YACL,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC7B,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;oBACjD,CAAC,CAAE,CAAC,CAAC,aAAa,CAA+B,CAAC,GAAG,CAAC,mBAAmB,CAAC;oBAC1E,CAAC,CAAC,SAAS,CAAC;gBACd,OAAO,EAAE,GAAG,CAAC,EAAE,WAAW,EAA8C,CAAC;YAC3E,CAAC,CAAC;SACH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,WAAmB,EACnB,OAA6B,EAC7B,GAAY;QAEZ,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,kBAAkB,CAAC,WAAW,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACzF,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACrD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAA0B,GAAG,EAAE,GAAG,CAAC,CAAC;QACpE,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACnD,CAAC,CAAE,GAAG,CAAC,aAAa,CAA+B,CAAC,GAAG,CAAC,mBAAmB,CAAC;YAC5E,CAAC,CAAC,SAAS,CAAC;QACd,OAAO,EAAE,GAAG,GAAG,EAAE,WAAW,EAAe,CAAC;IAC9C,CAAC;IAED,iBAAiB;IAEjB,KAAK,CAAC,YAAY,CAAC,MAAyB,EAAE,GAAY;QACxD,MAAM,WAAW,GAA4B;YAC3C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YACxD,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAChC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAClD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC,SAAS,CAAoB,GAAG,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,OAA6B,EAAE,GAAY;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,kBAAkB,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACjF,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,SAAS,CAAQ,GAAG,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,wBAAwB;IAExB,KAAK,CAAC,iBAAiB,CACrB,MAA8B,EAC9B,GAAY;QAEZ,MAAM,WAAW,GAA4B;YAC3C,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,OAAO;YAChD,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAChC,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;QACzD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC,SAAS,CAA2B,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,cAAsB,EACtB,OAA6B,EAC7B,GAAY;QAEZ,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,kBAAkB,kBAAkB,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/F,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC,SAAS,CAAe,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;CACF;AAED,gCAAgC;AAEhC,IAAI,QAA0C,CAAC;AAE/C,MAAM,UAAU,wBAAwB,CACtC,SAAoB,EACpB,OAAuB,EACvB,YAA0B;IAE1B,QAAQ,GAAG,IAAI,oBAAoB,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,mFAAmF,CACpF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}