Skip to main content

Interface: SeasonLoaderOptions

Defined in: src/core/releases.ts:153

Options for a per-season loader.

Remarks​

seasons is validated before any fetch: a missing value, a non-integer, or a string that is not a 4-digit year rejects with SdvError (so null, "" or true never become season 0 / 1).

Extends​

Properties​

columns?​

optional columns?: readonly string[]

Defined in: src/core/releases.ts:128

Read only these columns (the rest are not decoded). Default: all.

Inherited from​

ReleaseLoaderOptions.columns


format?​

optional format?: "rows" | "columns"

Defined in: src/core/releases.ts:133

"rows" (default): an array of row objects. "columns": one array per column ({ [column]: values[] }) — about 4x lighter on the heap.

Inherited from​

ReleaseLoaderOptions.format


maxCells?​

optional maxCells?: number

Defined in: src/core/releases.ts:141

Refuse (with a catchable SdvError) to decode more than this many cells (rows × leaf columns, a running total over the seasons) — each season's parquet footer is checked before that season is decoded. Default: scaled to the V8 heap limit (see BYTES_PER_CELL; a measured heuristic — long-string-only selections cost more per cell); Infinity disables the check.

Inherited from​

ReleaseLoaderOptions.maxCells


seasons​

seasons: number | number[]

Defined in: src/core/releases.ts:155

One season or a list of seasons: integers or 4-digit year strings (2024, "2024").


timeoutMs?​

optional timeoutMs?: number

Defined in: src/core/releases.ts:143

Download timeout in milliseconds (default RELEASE_TIMEOUT_MS).

Inherited from​

ReleaseLoaderOptions.timeoutMs