Class CommitteeClient

Sub-client for committee/corporate-body EP API endpoints.

Hierarchy (View Summary)

BaseEPClient
- CommitteeClient

Index

Constructors

constructor

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

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`fetchCommitteeDirectly

fetchCommitteeDirectly(bodyId: string): Promise<Committee | null>
Private
Attempts a direct corporate-body lookup by ID.
Parameters
- bodyId: string
Returns Promise<Committee | null>
- Defined in clients/ep/committeeClient.ts:68

`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

getCommitteeInfo

getCommitteeInfo(
params: { abbreviation?: string; id?: string },
): Promise<Committee>
Retrieves committee (corporate body) information by ID or abbreviation.

EP API Endpoint: GET /corporate-bodies/{body-id} or GET /corporate-bodies
Parameters
- params: { abbreviation?: string; id?: string }
  id or abbreviation of the committee
Returns Promise<Committee>
Committee information

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

getCorporateBodiesFeed

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

getCurrentCorporateBodies

getCurrentCorporateBodies(
params?: { limit?: number; offset?: number },
): Promise<PaginatedResponse<Committee>>
Returns the list of all current EP Corporate Bodies for today's date. EP API Endpoint: GET /corporate-bodies/show-current
Parameters
- params: { limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<Committee>>
- Defined in clients/ep/committeeClient.ts:154

`Private`resolveCommittee

resolveCommittee(searchTerm: string): Promise<Committee>
Private
Resolves a committee by trying direct lookup then list search.
Parameters
- searchTerm: string
Returns Promise<Committee>
Throws
If committee not found
- Defined in clients/ep/committeeClient.ts:52

`Private`searchCommitteeInList

searchCommitteeInList(searchTerm: string): Promise<Committee | null>
Private
Searches the corporate-bodies list for a matching committee.
Parameters
- searchTerm: string
Returns Promise<Committee | null>
- Defined in clients/ep/committeeClient.ts:88

`Private`transformCorporateBody

transformCorporateBody(apiData: Record<string, unknown>): Committee
Parameters
- apiData: Record<string, unknown>
Returns Committee
- Defined in clients/ep/committeeClient.ts:41

Class CommitteeClient

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns CommitteeClient

Properties

Protected ReadonlybaseURL

Protected Readonlycache

Protected ReadonlyenableRetry

Protected ReadonlymaxResponseBytes

Protected ReadonlymaxRetries

Protected ReadonlyrateLimiter

Protected ReadonlytimeoutMs

Methods

clearCache

Returns void

PrivatefetchCommitteeDirectly

Parameters

Returns Promise<Committee | null>

Protectedget

Type Parameters

Parameters

Returns Promise<T>

Throws

getCacheStats

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

getCommitteeInfo

Parameters

Returns Promise<Committee>

Security

getCorporateBodiesFeed

Parameters

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

getCurrentCorporateBodies

Parameters

Returns Promise<PaginatedResponse<Committee>>

PrivateresolveCommittee

Parameters

Returns Promise<Committee>

Throws

PrivatesearchCommitteeInList

Parameters

Returns Promise<Committee | null>

PrivatetransformCorporateBody

Parameters

Returns Committee

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`fetchCommitteeDirectly

`Protected`get

`Private`resolveCommittee

`Private`searchCommitteeInList

`Private`transformCorporateBody