Class PlenaryClient

Sub-client for plenary sessions and meeting-related EP API endpoints.

Hierarchy (View Summary)

BaseEPClient
- PlenaryClient

Constructors

constructor

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

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

buildMeetingsAPIParams(
    params: {
        dateFrom?: string;
        dateTo?: string;
        limit?: number;
        offset?: number;
    },
): Record<string, unknown>
Private
Maps internal params to EP API query parameters for meetings.
Parameters
- params: { dateFrom?: string; dateTo?: string; limit?: number; offset?: number }
Returns Record<string, unknown>
- Defined in clients/ep/plenaryClient.ts:69

clearCache

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

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

`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:496

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

getEventById

getEventById(eventId: string): Promise<EPEvent>
Returns a single EP event by ID. EP API Endpoint: GET /events/{event-id}
Parameters
- eventId: string
Returns Promise<EPEvent>
- Defined in clients/ep/plenaryClient.ts:312

getEvents

getEvents(
    params?: {
        dateFrom?: string;
        dateTo?: string;
        limit?: number;
        offset?: number;
    },
): Promise<PaginatedResponse<EPEvent>>
Returns EP events (hearings, conferences, etc.). EP API Endpoint: GET /events
Parameters
- params: { dateFrom?: string; dateTo?: string; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<EPEvent>>
- Defined in clients/ep/plenaryClient.ts:285

getMeetingActivities

getMeetingActivities(
sittingId: string,
params?: { limit?: number; offset?: number },
): Promise<PaginatedResponse<MeetingActivity>>
Returns activities linked to a specific meeting (plenary sitting). EP API Endpoint: GET /meetings/{sitting-id}/activities
Parameters
- sittingId: string
- params: { limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MeetingActivity>>
- Defined in clients/ep/plenaryClient.ts:135

getMeetingById

getMeetingById(eventId: string): Promise<PlenarySession>
Returns a single EP meeting by ID. EP API Endpoint: GET /meetings/{event-id}
Parameters
- eventId: string
Returns Promise<PlenarySession>
- Defined in clients/ep/plenaryClient.ts:270

getMeetingDecisions

getMeetingDecisions(
sittingId: string,
params?: { limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns decisions made in a specific meeting (plenary sitting). EP API Endpoint: GET /meetings/{sitting-id}/decisions
Parameters
- sittingId: string
- params: { limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/ep/plenaryClient.ts:162

getMeetingForeseenActivities

getMeetingForeseenActivities(
sittingId: string,
params?: { limit?: number; offset?: number },
): Promise<PaginatedResponse<MeetingActivity>>
Returns foreseen activities linked to a specific meeting. EP API Endpoint: GET /meetings/{sitting-id}/foreseen-activities
Parameters
- sittingId: string
- params: { limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<MeetingActivity>>
- Defined in clients/ep/plenaryClient.ts:189

getMeetingPlenarySessionDocumentItems

getMeetingPlenarySessionDocumentItems(
sittingId: string,
params?: { limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns plenary session document items for a specific meeting. EP API Endpoint: GET /meetings/{sitting-id}/plenary-session-document-items
Parameters
- sittingId: string
- params: { limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/ep/plenaryClient.ts:243

getMeetingPlenarySessionDocuments

getMeetingPlenarySessionDocuments(
sittingId: string,
params?: { limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns plenary session documents for a specific meeting. EP API Endpoint: GET /meetings/{sitting-id}/plenary-session-documents
Parameters
- sittingId: string
- params: { limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/ep/plenaryClient.ts:216

getPlenarySessions

getPlenarySessions(
    params: {
        dateFrom?: string;
        dateTo?: string;
        limit?: number;
        location?: string;
        offset?: number;
    },
): Promise<PaginatedResponse<PlenarySession>>
Retrieves plenary sessions with date and location filtering.

EP API Endpoint: GET /meetings
Parameters
- params: {
      dateFrom?: string;
      dateTo?: string;
      limit?: number;
      location?: string;
      offset?: number;
  }
  dateFrom, dateTo, location, limit, offset
Returns Promise<PaginatedResponse<PlenarySession>>
Paginated plenary session list
- Defined in clients/ep/plenaryClient.ts:93

`Private`transformDocument

transformDocument(apiData: Record<string, unknown>): LegislativeDocument
Parameters
- apiData: Record<string, unknown>
Returns LegislativeDocument
- Defined in clients/ep/plenaryClient.ts:59

`Private`transformEvent

transformEvent(apiData: Record<string, unknown>): EPEvent
Parameters
- apiData: Record<string, unknown>
Returns EPEvent
- Defined in clients/ep/plenaryClient.ts:51

`Private`transformMeetingActivity

transformMeetingActivity(apiData: Record<string, unknown>): MeetingActivity
Parameters
- apiData: Record<string, unknown>
Returns MeetingActivity
- Defined in clients/ep/plenaryClient.ts:55

`Private`transformPlenarySession

transformPlenarySession(apiData: Record<string, unknown>): PlenarySession
Parameters
- apiData: Record<string, unknown>
Returns PlenarySession
- Defined in clients/ep/plenaryClient.ts:47

Class PlenaryClient

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns PlenaryClient

Properties

Protected ReadonlybaseURL

Protected Readonlycache

Protected ReadonlyenableRetry

Protected ReadonlymaxResponseBytes

Protected ReadonlymaxRetries

Protected ReadonlyrateLimiter

Protected ReadonlytimeoutMs

Methods

PrivatebuildMeetingsAPIParams

Parameters

Returns Record<string, unknown>

clearCache

Returns void

Protectedget

Type Parameters

Parameters

Returns Promise<T>

Throws

getCacheStats

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

getEventById

Parameters

Returns Promise<EPEvent>

getEvents

Parameters

Returns Promise<PaginatedResponse<EPEvent>>

getMeetingActivities

Parameters

Returns Promise<PaginatedResponse<MeetingActivity>>

getMeetingById

Parameters

Returns Promise<PlenarySession>

getMeetingDecisions

Parameters

Returns Promise<PaginatedResponse<LegislativeDocument>>

getMeetingForeseenActivities

Parameters

Returns Promise<PaginatedResponse<MeetingActivity>>

getMeetingPlenarySessionDocumentItems

Parameters

Returns Promise<PaginatedResponse<LegislativeDocument>>

getMeetingPlenarySessionDocuments

Parameters

Returns Promise<PaginatedResponse<LegislativeDocument>>

getPlenarySessions

Parameters

Returns Promise<PaginatedResponse<PlenarySession>>

PrivatetransformDocument

Parameters

Returns LegislativeDocument

PrivatetransformEvent

Parameters

Returns EPEvent

PrivatetransformMeetingActivity

Parameters

Returns MeetingActivity

PrivatetransformPlenarySession

Parameters

Returns PlenarySession

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

`Protected`get

`Private`transformDocument

`Private`transformEvent

`Private`transformMeetingActivity

`Private`transformPlenarySession