Class VotingClient

Sub-client for voting records and speeches EP API endpoints.

Hierarchy (View Summary)

BaseEPClient
- VotingClient

Index

Constructors

constructor

new VotingClient(
config?: EPClientConfig,
shared?: EPSharedResources,
): VotingClient
Parameters
- config: EPClientConfig = {}
- Optionalshared: EPSharedResources
Returns VotingClient
Overrides BaseEPClient.constructor
- Defined in clients/ep/votingClient.ts:37

Properties

`Protected` `Readonly`baseURL

baseURL: string

European Parliament API base URL.

`Protected` `Readonly`cache

cache: LRUCache<string, Record<string, unknown>>

LRU cache for API responses.

`Protected` `Readonly`enableRetry

enableRetry: boolean

Enable automatic retry on transient failures.

`Protected` `Readonly`maxResponseBytes

maxResponseBytes: number

Maximum allowed response body size in bytes.

`Protected` `Readonly`maxRetries

maxRetries: number

Maximum number of retry attempts.

`Protected` `Readonly`rateLimiter

rateLimiter: RateLimiter

Token bucket rate limiter.

`Protected` `Readonly`timeoutMs

timeoutMs: number

Request timeout in milliseconds.

Methods

clearCache

clearCache(): void
Clears all entries from the LRU cache.

Returns void
Inherited from BaseEPClient.clearCache
- Defined in clients/ep/baseClient.ts:694

`Private`fetchVoteResultsForSession

fetchVoteResultsForSession(
sessionId: string,
apiParams: Record<string, unknown>,
): Promise<VotingRecord[]>
Private
Fetches vote results for a specific sitting/session.
Parameters
- sessionId: string
- apiParams: Record<string, unknown>
Returns Promise<VotingRecord[]>
- Defined in clients/ep/votingClient.ts:60

`Private`fetchVoteResultsFromRecentMeetings

fetchVoteResultsFromRecentMeetings(
params: { dateFrom?: string; limit?: number },
): Promise<VotingRecord[]>
Private
Fetches vote results from recent meetings when no sessionId is given.
Parameters
- params: { dateFrom?: string; limit?: number }
Returns Promise<VotingRecord[]>
- Defined in clients/ep/votingClient.ts:75

`Private`filterVotingRecords

filterVotingRecords(
records: VotingRecord[],
params: { dateFrom?: string; dateTo?: string; topic?: string },
): VotingRecord[]
Private
Applies client-side filters to voting records.
Parameters
- records: VotingRecord[]
- params: { dateFrom?: string; dateTo?: string; topic?: string }
Returns VotingRecord[]
- Defined in clients/ep/votingClient.ts:119

`Protected`get

get<T extends Record<string, unknown>>(
    endpoint: string,
    params?: Record<string, unknown>,
    minimumTimeoutMs?: number,
): Promise<T>
Protected
Executes a cached, rate-limited GET request to the EP API.
Type Parameters
- T extends Record<string, unknown>
  Expected response type (extends Record<string, unknown>)
Parameters
- endpoint: string
  API endpoint path (relative to baseURL)
- Optionalparams: Record<string, unknown>
  Optional query parameters
- OptionalminimumTimeoutMs: number
  Optional per-request minimum timeout in milliseconds. When provided, the effective timeout is Math.max(minimumTimeoutMs, this.timeoutMs), so the global timeout (set via --timeout or EP_REQUEST_TIMEOUT_MS) can still extend it beyond the per-endpoint minimum. Use for known slow EP API endpoints such as procedures/feed and events/feed.
Returns Promise<T>
Promise resolving to the typed API response

Throws
On HTTP errors, network failures, or parse failures
Inherited from BaseEPClient.get
- Defined in clients/ep/baseClient.ts:626

getCacheStats

getCacheStats(): {
    hitRate: number;
    hits: number;
    maxSize: number;
    misses: number;
    size: number;
}
Returns cache statistics for monitoring and debugging.

Returns { hitRate: number; hits: number; maxSize: number; misses: number; size: number }
{ size, maxSize, hitRate, hits, misses }
Inherited from BaseEPClient.getCacheStats
- Defined in clients/ep/baseClient.ts:703

getSpeechById

getSpeechById(speechId: string): Promise<Speech>
Returns a single speech by ID. EP API Endpoint: GET /speeches/{speech-id}
Parameters
- speechId: string
Returns Promise<Speech>
- Defined in clients/ep/votingClient.ts:240

getSpeeches

getSpeeches(
    params?: {
        dateFrom?: string;
        dateTo?: string;
        limit?: number;
        offset?: number;
        year?: number;
    },
): Promise<PaginatedResponse<Speech>>
Returns plenary speeches. EP API Endpoint: GET /speeches

The EP API supports filtering by year (recommended for annual counts).
Parameters
- params: {
      dateFrom?: string;
      dateTo?: string;
      limit?: number;
      offset?: number;
      year?: number;
  } = {}
Returns Promise<PaginatedResponse<Speech>>
- Defined in clients/ep/votingClient.ts:210

getVotingRecords

getVotingRecords(
    params: {
        dateFrom?: string;
        dateTo?: string;
        limit?: number;
        offset?: number;
        sessionId?: string;
        topic?: string;
    },
): Promise<PaginatedResponse<VotingRecord>>
Retrieves voting records with filtering by session, topic, and date.

EP API Endpoint: GET /meetings/{sitting-id}/vote-results
Parameters
- params: {
      dateFrom?: string;
      dateTo?: string;
      limit?: number;
      offset?: number;
      sessionId?: string;
      topic?: string;
  }
  sessionId, topic, dateFrom, dateTo, limit, offset
Returns Promise<PaginatedResponse<VotingRecord>>
Paginated voting records list

Security
Audit logged per GDPR Article 30
- Defined in clients/ep/votingClient.ts:152

`Private`transformSpeech

transformSpeech(apiData: Record<string, unknown>): Speech
Parameters
- apiData: Record<string, unknown>
Returns Speech
- Defined in clients/ep/votingClient.ts:50

`Private`transformVoteResult

transformVoteResult(
apiData: Record<string, unknown>,
sessionId: string,
): VotingRecord
Parameters
- apiData: Record<string, unknown>
- sessionId: string
Returns VotingRecord
- Defined in clients/ep/votingClient.ts:43

Class VotingClient

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns VotingClient

Properties

Protected ReadonlybaseURL

Protected Readonlycache

Protected ReadonlyenableRetry

Protected ReadonlymaxResponseBytes

Protected ReadonlymaxRetries

Protected ReadonlyrateLimiter

Protected ReadonlytimeoutMs

Methods

clearCache

Returns void

PrivatefetchVoteResultsForSession

Parameters

Returns Promise<VotingRecord[]>

PrivatefetchVoteResultsFromRecentMeetings

Parameters

Returns Promise<VotingRecord[]>

PrivatefilterVotingRecords

Parameters

Returns VotingRecord[]

Protectedget

Type Parameters

Parameters

Returns Promise<T>

Throws

getCacheStats

Returns { hitRate: number; hits: number; maxSize: number; misses: number; size: number }

getSpeechById

Parameters

Returns Promise<Speech>

getSpeeches

Parameters

Returns Promise<PaginatedResponse<Speech>>

getVotingRecords

Parameters

Returns Promise<PaginatedResponse<VotingRecord>>

Security

PrivatetransformSpeech

Parameters

Returns Speech

PrivatetransformVoteResult

Parameters

Returns VotingRecord

Settings

On This Page

`Protected` `Readonly`baseURL

`Protected` `Readonly`cache

`Protected` `Readonly`enableRetry

`Protected` `Readonly`maxResponseBytes

`Protected` `Readonly`maxRetries

`Protected` `Readonly`rateLimiter

`Protected` `Readonly`timeoutMs

`Private`fetchVoteResultsForSession

`Private`fetchVoteResultsFromRecentMeetings

`Private`filterVotingRecords

`Protected`get

`Private`transformSpeech

`Private`transformVoteResult