Class CommitteeClient

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

Hierarchy (View Summary)

BaseEPClient
- CommitteeClient

Index

Constructors

constructor

Properties

baseURL cache enableRetry maxResponseBytes maxRetries rateLimiter timeoutMs

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

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

applyCommitteeMemberships(
committee: Committee,
membershipSummary: CommitteeMembershipSummary,
): Committee
Parameters
- committee: Committee
- membershipSummary: CommitteeMembershipSummary
Returns Committee
- Defined in clients/ep/committeeClient.ts:439

`Private`applyMembershipRole

applyMembershipRole(summary: MembershipRoleSummary, roleCode: string): void
Parameters
- summary: MembershipRoleSummary
- roleCode: string
Returns void
- Defined in clients/ep/committeeClient.ts:376

clearCache

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

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

`Private`collectCommitteeOrganizationCandidates

collectCommitteeOrganizationCandidates(
apiData: Record<string, unknown>,
committeeAbbreviation: string,
): string[]
Parameters
- apiData: Record<string, unknown>
- committeeAbbreviation: string
Returns string[]
- Defined in clients/ep/committeeClient.ts:117

`Private`collectMembershipsFromBatch

collectMembershipsFromBatch(
    meps: unknown[],
    organizationCandidates: string[],
    abortSignal?: AbortSignal,
): Promise<
    {
        memberIds: Set<string>;
        memberships: CommitteeMembership[];
        viceChairIds: Set<string>;
        chairId?: string;
    },
>
Parameters
- meps: unknown[]
- organizationCandidates: string[]
- OptionalabortSignal: AbortSignal
Returns Promise<
    {
        memberIds: Set<string>;
        memberships: CommitteeMembership[];
        viceChairIds: Set<string>;
        chairId?: string;
    },
>
- Defined in clients/ep/committeeClient.ts:212

`Private`enrichCommitteeMembership

enrichCommitteeMembership(
    committee: Committee,
    apiData: Record<string, unknown>,
    abortSignal?: AbortSignal,
): Promise<Committee>
Parameters
- committee: Committee
- apiData: Record<string, unknown>
- OptionalabortSignal: AbortSignal
Returns Promise<Committee>
- Defined in clients/ep/committeeClient.ts:139

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

`Private`extractMembershipSummary

extractMembershipSummary(
details: Record<string, unknown>,
organizationCandidates: string[],
): MembershipRoleSummary
Parameters
- details: Record<string, unknown>
- organizationCandidates: string[]
Returns MembershipRoleSummary
- Defined in clients/ep/committeeClient.ts:343

`Private`extractReferenceValue

extractReferenceValue(value: unknown): string
Parameters
- value: unknown
Returns string
- Defined in clients/ep/committeeClient.ts:63

`Private`fetchCommitteeDirectly

fetchCommitteeDirectly(
    bodyId: string,
    abortSignal?: AbortSignal,
    includeMemberships?: boolean,
): Promise<Committee | null>
Attempts a direct corporate-body lookup by ID.
Parameters
- bodyId: string
- OptionalabortSignal: AbortSignal
- includeMemberships: boolean = true
Returns Promise<Committee | null>

Private
- Defined in clients/ep/committeeClient.ts:491

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

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

`Private`getCommitteeFilterValue

getCommitteeFilterValue(committee: Committee): string
Parameters
- committee: Committee
Returns string
- Defined in clients/ep/committeeClient.ts:105

getCommitteeInfo

getCommitteeInfo(
    params: {
        abbreviation?: string;
        abortSignal?: AbortSignal;
        id?: string;
        includeMemberships?: boolean;
    },
): 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;
      abortSignal?: AbortSignal;
      id?: string;
      includeMemberships?: boolean;
  }
  id or abbreviation of the committee, with optional abortSignal
Returns Promise<Committee>
Committee information

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

getCorporateBodies

getCorporateBodies(
params?: { abortSignal?: AbortSignal; limit?: number; offset?: number },
): Promise<PaginatedResponse<Committee>>
Returns the list of all EP Corporate Bodies. EP API Endpoint: GET /corporate-bodies
Parameters
- params: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<Committee>>
- Defined in clients/ep/committeeClient.ts:584

getCorporateBodiesFeed

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

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

getCorporateBodyById

getCorporateBodyById(
bodyId: string,
options?: { abortSignal?: AbortSignal; includeMemberships?: boolean },
): Promise<Committee>
Returns a single EP Corporate Body by ID. EP API Endpoint: GET /corporate-bodies/{body-id}
Parameters
- bodyId: string
- options: { abortSignal?: AbortSignal; includeMemberships?: boolean } = {}
Returns Promise<Committee>
- Defined in clients/ep/committeeClient.ts:609

getCurrentCorporateBodies

getCurrentCorporateBodies(
params?: { abortSignal?: AbortSignal; 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: { abortSignal?: AbortSignal; limit?: number; offset?: number } = {}
Returns Promise<PaginatedResponse<Committee>>
- Defined in clients/ep/committeeClient.ts:641

`Private`getMembershipKey

getMembershipKey(membership: CommitteeMembership): string
Parameters
- membership: CommitteeMembership
Returns string
- Defined in clients/ep/committeeClient.ts:388

`Private`getMembershipRoleCode

getMembershipRoleCode(membership: Record<string, unknown>): string
Parameters
- membership: Record<string, unknown>
Returns string
- Defined in clients/ep/committeeClient.ts:434

`Private`getMEPMembershipSummary

getMEPMembershipSummary(
    mep: Record<string, unknown>,
    organizationCandidates: string[],
    abortSignal?: AbortSignal,
    inferMemberFromRoster?: boolean,
): Promise<MEPMembershipSummary>
Parameters
- mep: Record<string, unknown>
- organizationCandidates: string[]
- OptionalabortSignal: AbortSignal
- inferMemberFromRoster: boolean = false
Returns Promise<MEPMembershipSummary>
- Defined in clients/ep/committeeClient.ts:261

`Private`hasMembershipDetails

hasMembershipDetails(details: Record<string, unknown>): boolean
Parameters
- details: Record<string, unknown>
Returns boolean
- Defined in clients/ep/committeeClient.ts:334

`Private`hasMembershipSummary

hasMembershipSummary(summary: MembershipRoleSummary): boolean
Parameters
- summary: MembershipRoleSummary
Returns boolean
- Defined in clients/ep/committeeClient.ts:339

`Private`isCurrentMembership

isCurrentMembership(membership: Record<string, unknown>): boolean
Parameters
- membership: Record<string, unknown>
Returns boolean
- Defined in clients/ep/committeeClient.ts:397

`Private`isRecord

isRecord(value: unknown): value is Record<string, unknown>
Parameters
- value: unknown
Returns value is Record<string, unknown>
- Defined in clients/ep/committeeClient.ts:101

`Private`loadCommitteeMemberships

loadCommitteeMemberships(
organizationCandidates: string[],
abortSignal?: AbortSignal,
): Promise<CommitteeMembershipSummary>
Parameters
- organizationCandidates: string[]
- OptionalabortSignal: AbortSignal
Returns Promise<CommitteeMembershipSummary>
- Defined in clients/ep/committeeClient.ts:155

`Private`loadMEPMembershipSummaryFromDetails

loadMEPMembershipSummaryFromDetails(
    mepId: string,
    organizationCandidates: string[],
    abortSignal?: AbortSignal,
): Promise<MembershipRoleSummary>
Parameters
- mepId: string
- organizationCandidates: string[]
- OptionalabortSignal: AbortSignal
Returns Promise<MembershipRoleSummary>
- Defined in clients/ep/committeeClient.ts:313

`Private`matchesCommitteeOrganization

matchesCommitteeOrganization(
membership: Record<string, unknown>,
organizationCandidates: string[],
): boolean
Parameters
- membership: Record<string, unknown>
- organizationCandidates: string[]
Returns boolean
- Defined in clients/ep/committeeClient.ts:409

`Private`normalizeMembershipClassificationCode

normalizeMembershipClassificationCode(value: string): string
Parameters
- value: string
Returns string
- Defined in clients/ep/committeeClient.ts:428

`Private`normalizeMEPId

normalizeMEPId(mepId: unknown): string
Parameters
- mepId: unknown
Returns string
- Defined in clients/ep/committeeClient.ts:80

`Private`normalizeOrganizationId

normalizeOrganizationId(value: unknown): string
Parameters
- value: unknown
Returns string
- Defined in clients/ep/committeeClient.ts:92

`Private`resolveCommittee

resolveCommittee(
    searchTerm: string,
    abortSignal?: AbortSignal,
    includeMemberships?: boolean,
): Promise<Committee>
Resolves a committee by trying direct lookup then list search.
Parameters
- searchTerm: string
- OptionalabortSignal: AbortSignal
- includeMemberships: boolean = true
Returns Promise<Committee>

Throws
If committee not found

Private
- Defined in clients/ep/committeeClient.ts:471

`Private`resolveDetailMembershipSummary

resolveDetailMembershipSummary(
    mepId: string,
    organizationCandidates: string[],
    abortSignal?: AbortSignal,
): Promise<MEPMembershipSummary>
Parameters
- mepId: string
- organizationCandidates: string[]
- OptionalabortSignal: AbortSignal
Returns Promise<MEPMembershipSummary>
- Defined in clients/ep/committeeClient.ts:300

`Private`resolveRosterMembershipSummary

resolveRosterMembershipSummary(
    mepId: string,
    organizationCandidates: string[],
    abortSignal?: AbortSignal,
): Promise<MEPMembershipSummary>
Parameters
- mepId: string
- organizationCandidates: string[]
- OptionalabortSignal: AbortSignal
Returns Promise<MEPMembershipSummary>
- Defined in clients/ep/committeeClient.ts:284

`Private`searchCommitteeInList

searchCommitteeInList(
    searchTerm: string,
    abortSignal?: AbortSignal,
    includeMemberships?: boolean,
): Promise<Committee | null>
Searches the corporate-bodies list for a matching committee.
Parameters
- searchTerm: string
- OptionalabortSignal: AbortSignal
- includeMemberships: boolean = true
Returns Promise<Committee | null>

Private
- Defined in clients/ep/committeeClient.ts:524

`Private`transformCorporateBody

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

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

PrivateapplyCommitteeMemberships

Parameters

Returns Committee

PrivateapplyMembershipRole

Parameters

Returns void

clearCache

Returns void

PrivatecollectCommitteeOrganizationCandidates

Parameters

Returns string[]

PrivatecollectMembershipsFromBatch

Parameters

Returns Promise< { memberIds: Set<string>; memberships: CommitteeMembership[]; viceChairIds: Set<string>; chairId?: string; },>

PrivateenrichCommitteeMembership

Parameters

Returns Promise<Committee>

ProtectedevictFromCache

Parameters

Returns void

Protected

PrivateextractMembershipSummary

Parameters

Returns MembershipRoleSummary

PrivateextractReferenceValue

Parameters

Returns string

PrivatefetchCommitteeDirectly

Parameters

Returns Promise<Committee | null>

Private

Protectedget

Type Parameters

Parameters

Returns Promise<T>

Throws

Protected

getCacheStats

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

PrivategetCommitteeFilterValue

Parameters

Returns string

getCommitteeInfo

Parameters

Returns Promise<Committee>

Security

getCorporateBodies

Parameters

Returns Promise<PaginatedResponse<Committee>>

getCorporateBodiesFeed

Parameters

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

getCorporateBodyById

Parameters

Returns Promise<Committee>

getCurrentCorporateBodies

Parameters

Returns Promise<PaginatedResponse<Committee>>

PrivategetMembershipKey

Parameters

Returns string

`Protected` `Readonly`baseURL

`Protected` `Readonly`cache

`Protected` `Readonly`enableRetry

`Protected` `Readonly`maxResponseBytes

`Protected` `Readonly`maxRetries

`Protected` `Readonly`rateLimiter

`Protected` `Readonly`timeoutMs

`Private`applyCommitteeMemberships

`Private`applyMembershipRole

`Private`collectCommitteeOrganizationCandidates

`Private`collectMembershipsFromBatch

Returns Promise<
{
memberIds: Set<string>;
memberships: CommitteeMembership[];
viceChairIds: Set<string>;
chairId?: string;
},
>

`Private`enrichCommitteeMembership

`Protected`evictFromCache

`Private`extractMembershipSummary

`Private`extractReferenceValue

`Private`fetchCommitteeDirectly

`Protected`get

`Private`getCommitteeFilterValue

`Private`getMembershipKey

`Private`getMembershipRoleCode

`Private`getMEPMembershipSummary

`Private`hasMembershipDetails

`Private`hasMembershipSummary

`Private`isCurrentMembership

`Private`isRecord

`Private`loadCommitteeMemberships

`Private`loadMEPMembershipSummaryFromDetails

`Private`matchesCommitteeOrganization

`Private`normalizeMembershipClassificationCode

`Private`normalizeMEPId

`Private`normalizeOrganizationId

`Private`resolveCommittee

`Private`resolveDetailMembershipSummary

`Private`resolveRosterMembershipSummary

`Private`searchCommitteeInList

`Private`transformCorporateBody