Class DocumentClient

Sub-client for document EP API endpoints.

Hierarchy (View Summary)

BaseEPClient
- DocumentClient

Constructors

constructor

new DocumentClient(
config?: EPClientConfig,
shared?: EPSharedResources,
): DocumentClient
Parameters
- config: EPClientConfig = {}
- Optionalshared: EPSharedResources
Returns DocumentClient
Overrides BaseEPClient.constructor
- Defined in clients/ep/documentClient.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

`Private`buildDocumentSearchParams

buildDocumentSearchParams(
    params: {
        dateFrom?: string;
        documentType?: string;
        limit?: number;
        offset?: number;
    },
): Record<string, unknown>
Builds EP API parameters for document search.
Parameters
- params: { dateFrom?: string; documentType?: string; limit?: number; offset?: number }
Returns Record<string, unknown>
Private
- Defined in clients/ep/documentClient.ts:47

clearCache

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

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

`Protected`evictFromCache

evictFromCache(endpoint: string, params?: Record<string, unknown>): void
Evicts a single cache entry matching the given endpoint and params. Sub-clients use this when they detect that a successfully-fetched payload is a content-pending sentinel that must not be served from cache for the remainder of the TTL — eviction lets availability recover as soon as the upstream document is enriched.
Parameters
- endpoint: string
  API endpoint path (same value passed to get)
- Optionalparams: Record<string, unknown>
  Optional query parameters (same value passed to get)
Returns void
Protected
Inherited from BaseEPClient.evictFromCache
- Defined in clients/ep/baseClient.ts:783

`Private`filterDocuments

filterDocuments(
documents: LegislativeDocument[],
params: { committee?: string; dateTo?: string; keyword?: string },
): LegislativeDocument[]
Applies client-side keyword, committee, and date-range filters to documents.
Parameters
- documents: LegislativeDocument[]
- params: { committee?: string; dateTo?: string; keyword?: string }
Returns LegislativeDocument[]
Private
- Defined in clients/ep/documentClient.ts:80

`Protected`get

get<T extends Record<string, unknown>>(
    endpoint: string,
    params?: Record<string, unknown>,
    minimumTimeoutMs?: number,
    abortSignal?: AbortSignal,
): Promise<T>
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.
- OptionalabortSignal: AbortSignal
  Optional caller-provided cancellation signal. When already aborted on entry the request is rejected immediately before consuming a rate-limiter token (so a cancelled fan-out does not starve the bucket). When aborted mid-flight, the underlying fetch is cancelled and the rejection is surfaced as APIError(..., 0, { cause }).
Returns Promise<T>
Promise resolving to the typed API response

Throws
On HTTP errors, network failures, parse failures, or cancellation (statusCode 0). Aborts are NOT retried.

Protected
Inherited from BaseEPClient.get
- Defined in clients/ep/baseClient.ts:685

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

getCommitteeDocumentById

getCommitteeDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single committee document by ID. EP API Endpoint: GET /committee-documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/ep/documentClient.ts:424

getCommitteeDocuments

getCommitteeDocuments(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns committee documents. EP API Endpoint: GET /committee-documents

Note: The EP API /committee-documents endpoint does not support a year query parameter per the OpenAPI spec. Only pagination (limit/offset) is supported.
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/ep/documentClient.ts:199

getCommitteeDocumentsFeed

getCommitteeDocumentsFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated committee documents via the feed endpoint. EP API Endpoint: GET /committee-documents/feed

Fixed-window feed — no timeframe parameter. Extended timeout applied (120 s minimum).
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/ep/documentClient.ts:331

getDocumentById

getDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single document by ID. EP API Endpoint: GET /documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/ep/documentClient.ts:379

getDocumentsFeed

getDocumentsFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated documents via the feed endpoint. EP API Endpoint: GET /documents/feed

This is a fixed-window feed — the EP API does NOT accept a timeframe parameter. It returns updates from a server-defined default window (typically one month). Response times can exceed 120 s, so an extended minimum timeout is applied automatically.
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/ep/documentClient.ts:305

getExternalDocumentById

getExternalDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single external document by ID. EP API Endpoint: GET /external-documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/ep/documentClient.ts:439

getExternalDocuments

getExternalDocuments(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns all External Documents. EP API Endpoint: GET /external-documents

Note: The EP API /external-documents endpoint does not support a year query parameter per the OpenAPI spec. Only pagination (limit/offset) is supported.
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/ep/documentClient.ts:276

getExternalDocumentsFeed

getExternalDocumentsFeed(
    params?: {
        abortSignal?: AbortSignal;
        startDate?: string;
        timeframe?: string;
        workType?: string;
    },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated external documents via the feed endpoint. EP API Endpoint: GET /external-documents/feed

This is a configurable-window feed that accepts timeframe, start-date, and work-type parameters. Extended timeout applied for one-month timeframe.
Parameters
- params: {
      abortSignal?: AbortSignal;
      startDate?: string;
      timeframe?: string;
      workType?: string;
  } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/ep/documentClient.ts:358

getPlenaryDocumentById

getPlenaryDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single plenary document by ID. EP API Endpoint: GET /plenary-documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/ep/documentClient.ts:394

getPlenaryDocuments

getPlenaryDocuments(
    params?: {
        abortSignal?: AbortSignal;
        limit?: number;
        offset?: number;
        year?: number;
    },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns plenary documents. EP API Endpoint: GET /plenary-documents
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number; year?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/ep/documentClient.ts:169

getPlenaryDocumentsFeed

getPlenaryDocumentsFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated plenary documents via the feed endpoint. EP API Endpoint: GET /plenary-documents/feed

Fixed-window feed — no timeframe parameter. Extended timeout applied (120 s minimum).
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/ep/documentClient.ts:318

getPlenarySessionDocumentById

getPlenarySessionDocumentById(
docId: string,
options?: { abortSignal?: AbortSignal },
): Promise<LegislativeDocument>
Returns a single plenary session document by ID. EP API Endpoint: GET /plenary-session-documents/{doc-id}
Parameters
- docId: string
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<LegislativeDocument>
- Defined in clients/ep/documentClient.ts:409

getPlenarySessionDocumentItems

getPlenarySessionDocumentItems(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns all Plenary Session Document Items. EP API Endpoint: GET /plenary-session-documents-items
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/ep/documentClient.ts:247

getPlenarySessionDocuments

getPlenarySessionDocuments(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<LegislativeDocument>>
Returns plenary session documents. EP API Endpoint: GET /plenary-session-documents
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<LegislativeDocument>>
- Defined in clients/ep/documentClient.ts:223

getPlenarySessionDocumentsFeed

getPlenarySessionDocumentsFeed(
options?: { abortSignal?: AbortSignal },
): Promise<JSONLDResponse<Record<string, unknown>>>
Retrieves recently updated plenary session documents via the feed endpoint. EP API Endpoint: GET /plenary-session-documents/feed

Fixed-window feed — no timeframe parameter. Extended timeout applied (120 s minimum).
Parameters
- options: { abortSignal?: AbortSignal } = {}
Returns Promise<JSONLDResponse<Record<string, unknown>>>
- Defined in clients/ep/documentClient.ts:344

searchDocuments

searchDocuments(
    params: {
        keyword: string;
        abortSignal?: AbortSignal;
        committee?: string;
        dateFrom?: string;
        dateTo?: string;
        documentType?: string;
        limit?: number;
        offset?: number;
    },
): Promise<PaginatedResponse<LegislativeDocument>>
Searches legislative documents by keyword, type, date, and committee.

EP API Endpoint: GET /documents
Parameters
- params: {
      keyword: string;
      abortSignal?: AbortSignal;
      committee?: string;
      dateFrom?: string;
      dateTo?: string;
      documentType?: string;
      limit?: number;
      offset?: number;
  }
  keyword, documentType, dateFrom, dateTo, committee, limit, offset
Returns Promise<PaginatedResponse<LegislativeDocument>>
Paginated legislative documents list

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

`Private`transformDocument

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

Class DocumentClient

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns DocumentClient

Properties

Protected ReadonlybaseURL

Protected Readonlycache

Protected ReadonlyenableRetry

Protected ReadonlymaxResponseBytes

Protected ReadonlymaxRetries

Protected ReadonlyrateLimiter

Protected ReadonlytimeoutMs

Methods

PrivatebuildDocumentSearchParams

Parameters

Returns Record<string, unknown>

Private

clearCache

Returns void

ProtectedevictFromCache

Parameters

Returns void

Protected

PrivatefilterDocuments

Parameters

Returns LegislativeDocument[]

Private

Protectedget

Type Parameters

Parameters

Returns Promise<T>

Throws

Protected

getCacheStats

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

getCommitteeDocumentById

Parameters

Returns Promise<LegislativeDocument>

getCommitteeDocuments

Parameters

Returns Promise<PaginatedResponse<LegislativeDocument>>

getCommitteeDocumentsFeed

Parameters

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

getDocumentById

Parameters

Returns Promise<LegislativeDocument>

getDocumentsFeed

Parameters

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

getExternalDocumentById

Parameters

Returns Promise<LegislativeDocument>

getExternalDocuments

Parameters

Returns Promise<PaginatedResponse<LegislativeDocument>>

getExternalDocumentsFeed

Parameters

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

getPlenaryDocumentById

Parameters

Returns Promise<LegislativeDocument>

getPlenaryDocuments

Parameters

Returns Promise<PaginatedResponse<LegislativeDocument>>

getPlenaryDocumentsFeed

Parameters

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

getPlenarySessionDocumentById

Parameters

Returns Promise<LegislativeDocument>

getPlenarySessionDocumentItems

Parameters

Returns Promise<PaginatedResponse<LegislativeDocument>>

`Protected` `Readonly`baseURL

`Protected` `Readonly`cache

`Protected` `Readonly`enableRetry

`Protected` `Readonly`maxResponseBytes

`Protected` `Readonly`maxRetries

`Protected` `Readonly`rateLimiter

`Protected` `Readonly`timeoutMs

`Private`buildDocumentSearchParams

`Protected`evictFromCache

`Private`filterDocuments

`Protected`get

`Private`transformDocument