Class MEPClient

Sub-client for MEP-related European Parliament API endpoints.

Handles all MEP data fetching: active lists, individual profiles, incoming/outgoing/homonym lists, and financial declarations.

Hierarchy (View Summary)

BaseEPClient
- MEPClient

Constructors

constructor

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

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

`Private`buildMEPParams

buildMEPParams(
    params: {
        active?: boolean;
        committee?: string;
        country?: string;
        group?: string;
        limit?: number;
        offset?: number;
    },
): Record<string, unknown>
Private
Maps getMEPs params to EP API query parameters.
Parameters
- params: {
      active?: boolean;
      committee?: string;
      country?: string;
      group?: string;
      limit?: number;
      offset?: number;
  }
Returns Record<string, unknown>
- Defined in clients/ep/mepClient.ts:69

clearCache

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

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

`Private`fetchAllCurrentMEPs

fetchAllCurrentMEPs(): Promise<MEP[]>
Fetch all current MEPs in paginated batches (max 100 per request).

Returns Promise<MEP[]>
- Defined in clients/ep/mepClient.ts:108

`Private`filterMEPs

filterMEPs(
    meps: MEP[],
    country: string | undefined,
    group: string | undefined,
): MEP[]
Apply optional client-side country and group filters to an MEP array.
Parameters
- meps: MEP[]
- country: string | undefined
- group: string | undefined
Returns MEP[]
- Defined in clients/ep/mepClient.ts:88

`Protected`get

get<T extends Record<string, unknown>>(
endpoint: string,
params?: Record<string, unknown>,
): 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
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:553

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:622

getCurrentMEPs

getCurrentMEPs(
    params?: {
        country?: string;
        group?: string;
        limit?: number;
        offset?: number;
    },
): Promise<PaginatedResponse<MEP>>
Returns all currently active MEPs for today's date.

Unlike getMEPs(), this uses GET /meps/show-current which returns api:country-of-representation and api:political-group in responses. Optional country and group filters are applied client-side after fetch.

EP API Endpoint: GET /meps/show-current
Parameters
- params: { country?: string; group?: string; limit?: number; offset?: number } = {}
  Optional filters and pagination
  - Optionalcountry?: string
    ISO 3166-1 alpha-2 country code for client-side filtering
  - Optionalgroup?: string
    Political group identifier for client-side filtering
  - Optionallimit?: number
    Maximum results to return (default 50)
  - Optionaloffset?: number
    Pagination offset (default 0)
Returns Promise<PaginatedResponse<MEP>>
- Defined in clients/ep/mepClient.ts:238

getHomonymMEPs

getHomonymMEPs(
params?: { limit?: number; offset?: number },
): Promise<PaginatedResponse<MEP>>
Returns homonym MEPs for the current parliamentary term. EP API Endpoint: GET /meps/show-homonyms
Parameters
- params: { limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MEP>>
- Defined in clients/ep/mepClient.ts:318

getIncomingMEPs

getIncomingMEPs(
params?: { limit?: number; offset?: number },
): Promise<PaginatedResponse<MEP>>
Returns all incoming MEPs for the current parliamentary term. EP API Endpoint: GET /meps/show-incoming
Parameters
- params: { limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MEP>>
- Defined in clients/ep/mepClient.ts:274

getMEPDeclarationById

getMEPDeclarationById(docId: string): Promise<MEPDeclaration>
Returns a single MEP declaration by document ID. EP API Endpoint: GET /meps-declarations/{doc-id}
Parameters
- docId: string
Returns Promise<MEPDeclaration>
Gdpr
Declarations contain personal financial data – access is audit-logged
- Defined in clients/ep/mepClient.ts:401

getMEPDeclarations

getMEPDeclarations(
params?: { limit?: number; offset?: number; year?: number },
): Promise<PaginatedResponse<MEPDeclaration>>
Returns MEP declarations of financial interests. EP API Endpoint: GET /meps-declarations
Parameters
- params: { limit?: number; offset?: number; year?: number } = {}
Returns Promise<PaginatedResponse<MEPDeclaration>>
Gdpr
Declarations contain personal financial data – access is audit-logged
- Defined in clients/ep/mepClient.ts:341

getMEPDeclarationsFeed

getMEPDeclarationsFeed(
params?: { startDate?: string; timeframe?: string; workType?: string },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated MEP declarations via the feed endpoint. EP API Endpoint: GET /meps-declarations/feed
Parameters
- params: { startDate?: string; timeframe?: string; workType?: string } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/ep/mepClient.ts:383

getMEPDetails

getMEPDetails(id: string): Promise<MEPDetails>
Retrieves detailed information about a specific MEP.

Supports numeric ID ("124936"), person URI ("person/124936"), or MEP-prefixed ID ("MEP-124936").
Parameters
- id: string
  MEP identifier in any supported format
Returns Promise<MEPDetails>
Detailed MEP information

Security
Personal data access logged per GDPR Article 30
- Defined in clients/ep/mepClient.ts:194

getMEPs

getMEPs(
    params: {
        active?: boolean;
        committee?: string;
        country?: string;
        group?: string;
        limit?: number;
        offset?: number;
    },
): Promise<PaginatedResponse<MEP>>
Retrieves Members of the European Parliament with filtering and pagination.
Parameters
- params: {
      active?: boolean;
      committee?: string;
      country?: string;
      group?: string;
      limit?: number;
      offset?: number;
  }
  Country, group, committee, active status, limit, offset
Returns Promise<PaginatedResponse<MEP>>
Paginated MEP list

Security
Personal data access logged per GDPR Article 30
- Defined in clients/ep/mepClient.ts:149

getMEPsFeed

getMEPsFeed(
params?: { startDate?: string; timeframe?: string },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated MEPs via the feed endpoint. EP API Endpoint: GET /meps/feed
Parameters
- params: { startDate?: string; timeframe?: string } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/ep/mepClient.ts:368

getOutgoingMEPs

getOutgoingMEPs(
params?: { limit?: number; offset?: number },
): Promise<PaginatedResponse<MEP>>
Returns all outgoing MEPs for the current parliamentary term. EP API Endpoint: GET /meps/show-outgoing
Parameters
- params: { limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MEP>>
- Defined in clients/ep/mepClient.ts:296

`Private`paginateFiltered

paginateFiltered(
    meps: MEP[],
    limit: number,
    offset: number,
    filtered: boolean,
): PaginatedResponse<MEP>
Build paginated result from filtered MEPs.
Parameters
- meps: MEP[]
- limit: number
- offset: number
- filtered: boolean
Returns PaginatedResponse<MEP>
- Defined in clients/ep/mepClient.ts:131

`Private`transformMEP

transformMEP(apiData: Record<string, unknown>): MEP
Parameters
- apiData: Record<string, unknown>
Returns MEP
- Defined in clients/ep/mepClient.ts:51

`Private`transformMEPDeclaration

transformMEPDeclaration(apiData: Record<string, unknown>): MEPDeclaration
Parameters
- apiData: Record<string, unknown>
Returns MEPDeclaration
- Defined in clients/ep/mepClient.ts:59

`Private`transformMEPDetails

transformMEPDetails(apiData: Record<string, unknown>): MEPDetails
Parameters
- apiData: Record<string, unknown>
Returns MEPDetails
- Defined in clients/ep/mepClient.ts:55

Class MEPClient

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns MEPClient

Properties

Protected ReadonlybaseURL

Protected Readonlycache

Protected ReadonlyenableRetry

Protected ReadonlymaxResponseBytes

Protected ReadonlymaxRetries

Protected ReadonlyrateLimiter

Protected ReadonlytimeoutMs

Methods

PrivatebuildMEPParams

Parameters

Returns Record<string, unknown>

clearCache

Returns void

PrivatefetchAllCurrentMEPs

Returns Promise<MEP[]>

PrivatefilterMEPs

Parameters

Returns MEP[]

Protectedget

Type Parameters

Parameters

Returns Promise<T>

Throws

getCacheStats

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

getCurrentMEPs

Parameters

Optionalcountry?: string

Optionalgroup?: string

Optionallimit?: number

Optionaloffset?: number

Returns Promise<PaginatedResponse<MEP>>

getHomonymMEPs

Parameters

Returns Promise<PaginatedResponse<MEP>>

getIncomingMEPs

Parameters

Returns Promise<PaginatedResponse<MEP>>

getMEPDeclarationById

Parameters

Returns Promise<MEPDeclaration>

Gdpr

getMEPDeclarations

Parameters

Returns Promise<PaginatedResponse<MEPDeclaration>>

Gdpr

getMEPDeclarationsFeed

Parameters

Returns Promise<JSONLDResponse<Record<string, unknown>>>

getMEPDetails

Parameters

Returns Promise<MEPDetails>

Security

getMEPs

Parameters

Returns Promise<PaginatedResponse<MEP>>

Security

getMEPsFeed

Parameters

Returns Promise<JSONLDResponse<Record<string, unknown>>>

getOutgoingMEPs

Parameters

Returns Promise<PaginatedResponse<MEP>>

PrivatepaginateFiltered

Parameters

Returns PaginatedResponse<MEP>

PrivatetransformMEP

Parameters

Returns MEP

`Protected` `Readonly`baseURL

`Protected` `Readonly`cache

`Protected` `Readonly`enableRetry

`Protected` `Readonly`maxResponseBytes

`Protected` `Readonly`maxRetries

`Protected` `Readonly`rateLimiter

`Protected` `Readonly`timeoutMs

`Private`buildMEPParams

`Private`fetchAllCurrentMEPs

`Private`filterMEPs

`Protected`get

`Optional`country?: string

`Optional`group?: string

`Optional`limit?: number

`Optional`offset?: number

`Private`paginateFiltered

`Private`transformMEP

`Private`transformMEPDeclaration

`Private`transformMEPDetails