import {z} from 'zod' export type GetApiV1CandidateCandidateIdTotalsArgs = {page?: number | undefined, per_page?: number | undefined, election_full?: boolean | undefined, cycle?: Array | undefined, sort?: string | undefined, sort_hide_null?: boolean | undefined, sort_null_only?: boolean | undefined, sort_nulls_last?: boolean | undefined, api_key?: string | undefined, candidate_id: string}; export type GetApiV1CandidateCandidateIdTotalsOptions = {baseUrl: string, ApiKeyHeaderAuth?: string | undefined, ApiKeyQueryAuth?: string | undefined, apiKey?: string | undefined, fetch?: typeof fetch | undefined}; export const offsetInfo = z.object({count: z.number().int().optional(), is_count_exact: z.boolean().optional(), page: z.number().int().optional(), pages: z.number().int().optional(), per_page: z.number().int().optional()}); export const pacSponsorCandidate = z.object({sponsor_candidate_id: z.string().nullable().optional(), sponsor_candidate_name: z.string().max(100).nullable().optional()}); export const committeeTotals = z.object({all_loans_received: z.number().optional(), all_other_loans: z.number().optional(), allocated_federal_election_levin_share: z.number().optional(), candidate_contribution: z.number().optional(), cash_on_hand_beginning_period: z.number().optional(), committee_designation: z.string().nullable().optional(), committee_designation_full: z.string().nullable().optional(), committee_id: z.string().nullable().optional(), committee_name: z.string().nullable().optional(), committee_state: z.string().max(2).nullable().optional(), committee_type: z.string().nullable().optional(), committee_type_full: z.string().nullable().optional(), contribution_refunds: z.number().optional(), contributions: z.number().optional(), contributions_ie_and_party_expenditures_made_percent: z.number().optional(), convention_exp: z.number().optional(), coordinated_expenditures_by_party_committee: z.number().optional(), coverage_end_date: z.string().nullable().optional(), coverage_start_date: z.string().nullable().optional(), cycle: z.number().int(), disbursements: z.number().optional(), exempt_legal_accounting_disbursement: z.number().optional(), exp_prior_years_subject_limits: z.number().optional(), exp_subject_limits: z.number().optional(), fed_candidate_committee_contributions: z.number().optional(), fed_candidate_contribution_refunds: z.number().optional(), fed_disbursements: z.number().optional(), fed_election_activity: z.number().optional(), fed_operating_expenditures: z.number().optional(), fed_receipts: z.number().optional(), federal_funds: z.number().optional(), filing_frequency: z.string().max(1).nullable().optional(), filing_frequency_full: z.string().nullable().optional(), first_f1_date: z.string().nullable().optional(), first_file_date: z.string().nullable().optional(), fundraising_disbursements: z.number().optional(), independent_expenditures: z.number().optional(), individual_contributions: z.number().optional(), individual_contributions_percent: z.number().optional(), individual_itemized_contributions: z.number().optional(), individual_unitemized_contributions: z.number().optional(), itemized_convention_exp: z.number().optional(), itemized_other_disb: z.number().optional(), itemized_other_income: z.number().optional(), itemized_other_refunds: z.number().optional(), itemized_refunds_relating_convention_exp: z.number().optional(), last_beginning_image_number: z.string().optional(), last_cash_on_hand_end_period: z.number().optional(), last_debts_owed_by_committee: z.number().optional(), last_debts_owed_to_committee: z.number().optional(), last_report_type_full: z.string().nullable().optional(), last_report_year: z.number().int().nullable().optional(), loan_repayments: z.number().optional(), loan_repayments_candidate_loans: z.number().optional(), loan_repayments_made: z.number().optional(), loan_repayments_other_loans: z.number().optional(), loan_repayments_received: z.number().optional(), loans: z.number().optional(), loans_and_loan_repayments_made: z.number().optional(), loans_and_loan_repayments_received: z.number().optional(), loans_made: z.number().optional(), loans_made_by_candidate: z.number().optional(), loans_received: z.number().optional(), loans_received_from_candidate: z.number().optional(), net_contributions: z.number().optional(), net_operating_expenditures: z.number().optional(), non_allocated_fed_election_activity: z.number().optional(), offsets_to_fundraising_expenditures: z.number().optional(), offsets_to_legal_accounting: z.number().optional(), offsets_to_operating_expenditures: z.number().optional(), operating_expenditures: z.number().optional(), operating_expenditures_percent: z.number().optional(), organization_type: z.string().max(1).nullable().optional(), organization_type_full: z.string().max(100).nullable().optional(), other_disbursements: z.number().optional(), other_fed_operating_expenditures: z.number().optional(), other_fed_receipts: z.number().optional(), other_loans_received: z.number().optional(), other_political_committee_contributions: z.number().optional(), other_receipts: z.number().optional(), other_refunds: z.number().optional(), party_and_other_committee_contributions_percent: z.number().optional(), party_full: z.string().nullable().optional(), pdf_url: z.string().optional(), political_party_committee_contributions: z.number().optional(), receipts: z.number().optional(), refunded_individual_contributions: z.number().optional(), refunded_other_political_committee_contributions: z.number().optional(), refunded_political_party_committee_contributions: z.number().optional(), refunds_relating_convention_exp: z.number().optional(), repayments_loans_made_by_candidate: z.number().optional(), repayments_other_loans: z.number().optional(), report_form: z.string().optional(), shared_fed_activity: z.number().optional(), shared_fed_activity_nonfed: z.number().optional(), shared_fed_operating_expenditures: z.number().optional(), shared_nonfed_operating_expenditures: z.number().optional(), sponsor_candidate_ids: z.array(z.string()).nullable().optional(), sponsor_candidate_list: z.array(pacSponsorCandidate).optional(), total_exp_subject_limits: z.number().optional(), total_independent_contributions: z.number().optional(), total_independent_expenditures: z.number().optional(), total_offsets_to_operating_expenditures: z.number().optional(), total_transfers: z.number().optional(), transaction_coverage_date: z.string().optional(), transfers_from_affiliated_committee: z.number().optional(), transfers_from_affiliated_party: z.number().optional(), transfers_from_nonfed_account: z.number().optional(), transfers_from_nonfed_levin: z.number().optional(), transfers_from_other_authorized_committee: z.number().optional(), transfers_to_affiliated_committee: z.number().optional(), transfers_to_other_authorized_committee: z.number().optional(), treasurer_name: z.string().max(100).nullable().optional(), unitemized_convention_exp: z.number().optional(), unitemized_other_disb: z.number().optional(), unitemized_other_income: z.number().optional(), unitemized_other_refunds: z.number().optional(), unitemized_refunds_relating_convention_exp: z.number().optional()}); export const committeeTotalsPage = z.object({pagination: offsetInfo.optional(), results: z.array(committeeTotals).optional()}); export const validateResponse = async ( schema: { readonly '~standard': { readonly validate: (value: unknown) => ({ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }) | Promise<{ readonly value: Output; readonly issues?: undefined } | { readonly issues: ReadonlyArray<{ readonly message: string; readonly path?: ReadonlyArray | undefined }> }> } }, value: unknown ): Promise => { const result = await schema['~standard'].validate(value) if (result.issues !== undefined) { const detail = result.issues .map(({ message, path }) => path?.length ? `${path.map((segment) => String(typeof segment === 'object' ? segment.key : segment)).join('.')}: ${message}` : message ) .join('; ') throw new Error(`Response does not match the schema: ${detail}`, { cause: { issues: result.issues } }) } return result.value }; /** * GET /v1/candidate/{candidate_id}/totals/ */ export const getApiV1CandidateCandidateIdTotals = async (args: GetApiV1CandidateCandidateIdTotalsArgs, options: GetApiV1CandidateCandidateIdTotalsOptions) => { const {baseUrl, fetch: fetchFn = fetch, ApiKeyHeaderAuth, ApiKeyQueryAuth, apiKey} = options ?? {} const query = new URLSearchParams() const headers = new Headers() headers.set('accept', "application/json") if (args.page != null) query.append("page", String(args.page)) if (args.per_page != null) query.append("per_page", String(args.per_page)) if (args.election_full != null) query.append("election_full", String(args.election_full)) for (const item of args.cycle ?? []) query.append("cycle", String(item)) if (args.sort != null) query.append("sort", String(args.sort)) if (args.sort_hide_null != null) query.append("sort_hide_null", String(args.sort_hide_null)) if (args.sort_null_only != null) query.append("sort_null_only", String(args.sort_null_only)) if (args.sort_nulls_last != null) query.append("sort_nulls_last", String(args.sort_nulls_last)) if (args.api_key != null) query.append("api_key", String(args.api_key)) if (ApiKeyHeaderAuth !== undefined) headers.set("X-Api-Key", ApiKeyHeaderAuth) if (ApiKeyQueryAuth !== undefined) query.set("api_key", ApiKeyQueryAuth) if (apiKey !== undefined) query.set("api_key", apiKey) const url = `${baseUrl.replace(/\/+$/, '')}/v1/candidate/${encodeURIComponent(String(args.candidate_id))}/totals/${query.size > 0 ? `?${query}` : ''}` const res = await fetchFn(url, {method: "GET", headers}) if (!res.ok) throw new Error(`Request failed with status ${res.status}`, {cause: {status: res.status, body: await res.text()}}) return validateResponse(committeeTotalsPage, await res.json()) };