core/src

Mostlyright TypeScript SDK

---

Mostlyright TypeScript SDK / core/src

core/src

Classes

AuthenticationError

Defined in: packages-ts/core/src/exceptions/index.ts:723

Base HTTP-layer marker. Subclass of MostlyRightError so callers that catch MostlyRightError also catch transport errors.

Extends

• TherminalError

Constructors

new AuthenticationError()

new AuthenticationError(message, options): AuthenticationError

Defined in: packages-ts/core/src/exceptions/index.ts:726

Parameters

message

string = "Authentication required"

options

TherminalErrorOptions = {}

Returns

AuthenticationError

Overrides

TherminalError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "HTTP_UNAUTHORIZED"

Defined in: packages-ts/core/src/exceptions/index.ts:724

Subclass override — the stable string enum surfaced via errorCode.

Overrides

TherminalError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

TherminalError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

TherminalError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

TherminalError.source

statusCode

readonly statusCode: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:669

Inherited from

TherminalError.statusCode

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

TherminalError.toDict

---

DataAvailabilityError

Defined in: packages-ts/core/src/exceptions/index.ts:233

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• MostlyRightError

Extended by

• NwpNotAvailableError
• ClimateGapsNotImplementedError

Constructors

new DataAvailabilityError()

new DataAvailabilityError(options): DataAvailabilityError

Defined in: packages-ts/core/src/exceptions/index.ts:239

Parameters

options

DataAvailabilityErrorOptions

Returns

DataAvailabilityError

Overrides

MostlyRightError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "DATA_AVAILABILITY"

Defined in: packages-ts/core/src/exceptions/index.ts:234

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

hint

readonly hint: string

Defined in: packages-ts/core/src/exceptions/index.ts:237

reason

readonly reason: "model_unavailable" | "out_of_window" | "cache_miss" | "source_404" | "source_5xx" | "rate_limited"

Defined in: packages-ts/core/src/exceptions/index.ts:236

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

DeferredMarketError

Defined in: packages-ts/core/src/exceptions/index.ts:641

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• MostlyRightError

Constructors

new DeferredMarketError()

new DeferredMarketError(message, options): DeferredMarketError

Defined in: packages-ts/core/src/exceptions/index.ts:130

Parameters

message

string = ""

options

MostlyRightErrorOptions = {}

Returns

DeferredMarketError

Inherited from

MostlyRightError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "DEFERRED_MARKET"

Defined in: packages-ts/core/src/exceptions/index.ts:642

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

ForbiddenError

Defined in: packages-ts/core/src/exceptions/index.ts:731

Base HTTP-layer marker. Subclass of MostlyRightError so callers that catch MostlyRightError also catch transport errors.

Extends

• TherminalError

Constructors

new ForbiddenError()

new ForbiddenError(message, options): ForbiddenError

Defined in: packages-ts/core/src/exceptions/index.ts:734

Parameters

message

string = "Access denied"

options

TherminalErrorOptions = {}

Returns

ForbiddenError

Overrides

TherminalError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "HTTP_FORBIDDEN"

Defined in: packages-ts/core/src/exceptions/index.ts:732

Subclass override — the stable string enum surfaced via errorCode.

Overrides

TherminalError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

TherminalError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

TherminalError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

TherminalError.source

statusCode

readonly statusCode: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:669

Inherited from

TherminalError.statusCode

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

TherminalError.toDict

---

IssuedAtMissingError

Defined in: packages-ts/core/src/exceptions/index.ts:492

A forecast row would land with issuedAt = null.

Phase 20 OM-04. Origin: Tarabcak/mostlyright#70 — the legacy seamless-feed bug where /forecast_series proxied Open-Meteo’s seamless endpoint without preserving issued_at, silently using post-snapshot model runs in training data.

Extends

• SchemaValidationError

Constructors

new IssuedAtMissingError()

new IssuedAtMissingError(message, options): IssuedAtMissingError

Defined in: packages-ts/core/src/exceptions/index.ts:497

Parameters

message

string

options

IssuedAtMissingErrorOptions = {}

Returns

IssuedAtMissingError

Overrides

SchemaValidationError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "ISSUED_AT_MISSING"

Defined in: packages-ts/core/src/exceptions/index.ts:493

Subclass override — the stable string enum surfaced via errorCode.

Overrides

SchemaValidationError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

SchemaValidationError.errorCode

quarantineCount

readonly quarantineCount: number

Defined in: packages-ts/core/src/exceptions/index.ts:372

Inherited from

SchemaValidationError.quarantineCount

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

SchemaValidationError.requestId

sampleViolations

readonly sampleViolations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:373

Inherited from

SchemaValidationError.sampleViolations

schemaId

readonly schemaId: string

Defined in: packages-ts/core/src/exceptions/index.ts:370

Inherited from

SchemaValidationError.schemaId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

SchemaValidationError.source

violatingCountRows

readonly violatingCountRows: number

Defined in: packages-ts/core/src/exceptions/index.ts:495

violations

readonly violations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:371

Inherited from

SchemaValidationError.violations

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

SchemaValidationError.toDict

---

LeakageError

Defined in: packages-ts/core/src/exceptions/index.ts:451

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• MostlyRightError

Extended by

• OpenMeteoSeamlessLeakageError

Constructors

new LeakageError()

new LeakageError(message, options): LeakageError

Defined in: packages-ts/core/src/exceptions/index.ts:458

Parameters

message

string

options

LeakageErrorOptions

Returns

LeakageError

Overrides

MostlyRightError.constructor

Properties

asOf

readonly asOf: string

Defined in: packages-ts/core/src/exceptions/index.ts:454

defaultErrorCode

static defaultErrorCode: string = "LEAKAGE_DETECTED"

Defined in: packages-ts/core/src/exceptions/index.ts:452

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

sampleViolations

readonly sampleViolations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:456

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

violatingCount

readonly violatingCount: number

Defined in: packages-ts/core/src/exceptions/index.ts:455

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

LiveStreamError

Defined in: packages-ts/core/src/exceptions/index.ts:759

Base class for mostlyright.live.stream / live.latest failures.

Mirrors Python LiveStreamError. Live-streaming errors are a separate sub-tree from SourceUnavailableError because the recovery path differs — stream() swallows empty-tick errors and waits for the next polite-floor cycle. Only latest() raises NoLiveDataError on empty responses.

Extends

• MostlyRightError

Extended by

• NoLiveDataError

Constructors

new LiveStreamError()

new LiveStreamError(message, options): LiveStreamError

Defined in: packages-ts/core/src/exceptions/index.ts:130

Parameters

message

string = ""

options

MostlyRightErrorOptions = {}

Returns

LiveStreamError

Inherited from

MostlyRightError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "LIVE_STREAM_ERROR"

Defined in: packages-ts/core/src/exceptions/index.ts:760

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

MostlyRightError

Defined in: packages-ts/core/src/exceptions/index.ts:122

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• Error

Extended by

• SourceUnavailableError
• DataAvailabilityError
• SchemaValidationError
• SourceMismatchError
• LeakageError
• TemporalDriftError
• PayloadTooLargeError
• DeferredMarketError
• PolymarketEventError
• TherminalError
• LiveStreamError
• UnknownSchemaError

Constructors

new MostlyRightError()

new MostlyRightError(message, options): MostlyRightError

Defined in: packages-ts/core/src/exceptions/index.ts:130

Parameters

message

string = ""

options

MostlyRightErrorOptions = {}

Returns

MostlyRightError

Overrides

Error.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "MOSTLYRIGHT_ERROR"

Defined in: packages-ts/core/src/exceptions/index.ts:124

Subclass override — the stable string enum surfaced via errorCode.

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

---

NoLiveDataError

Defined in: packages-ts/core/src/exceptions/index.ts:775

mostlyright.live.latest returned no observations for the station.

Carries the resolved ICAO station and the canonical source identity tag ("awc.live" / "iem.live") so caller logs can branch by source without re-parsing the message.

Extends

• LiveStreamError

Constructors

new NoLiveDataError()

new NoLiveDataError(message, options): NoLiveDataError

Defined in: packages-ts/core/src/exceptions/index.ts:780

Parameters

message

string

options

NoLiveDataErrorOptions

Returns

NoLiveDataError

Overrides

LiveStreamError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "NO_LIVE_DATA"

Defined in: packages-ts/core/src/exceptions/index.ts:776

Subclass override — the stable string enum surfaced via errorCode.

Overrides

LiveStreamError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

LiveStreamError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

LiveStreamError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

LiveStreamError.source

station

readonly station: string

Defined in: packages-ts/core/src/exceptions/index.ts:778

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

LiveStreamError.toDict

---

NotFoundError

Defined in: packages-ts/core/src/exceptions/index.ts:684

Base HTTP-layer marker. Subclass of MostlyRightError so callers that catch MostlyRightError also catch transport errors.

Extends

• TherminalError

Constructors

new NotFoundError()

new NotFoundError(message, options): NotFoundError

Defined in: packages-ts/core/src/exceptions/index.ts:687

Parameters

message

string = "Resource not found"

options

TherminalErrorOptions = {}

Returns

NotFoundError

Overrides

TherminalError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "HTTP_NOT_FOUND"

Defined in: packages-ts/core/src/exceptions/index.ts:685

Subclass override — the stable string enum surfaced via errorCode.

Overrides

TherminalError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

TherminalError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

TherminalError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

TherminalError.source

statusCode

readonly statusCode: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:669

Inherited from

TherminalError.statusCode

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

TherminalError.toDict

---

NwpNotAvailableError

Defined in: packages-ts/core/src/exceptions/index.ts:324

Raised when the TS forecastNwp() stub is called.

Why this exists: no production-ready browser GRIB2 decoder ships in v1.x (eccodes / cfgrib are C/Python only; WASM compile-time + bundle size make a browser port impractical today). The function signature is stable so callers can write code today; v2.0+ lands the execution body.

Recommended catch pattern:

import { forecastNwp } from '@mostlyrightmd/weather';
import { NwpNotAvailableError } from '@mostlyrightmd/core';

try {
  const grid = await forecastNwp('KNYC', 'gfs');
} catch (e) {
  if (e instanceof NwpNotAvailableError) {
    console.warn(`NWP deferred to v2.0+; ${e.hint}`);
    // Fall back to iemMosForecasts() when available, else Python SDK.
  } else {
    throw e;
  }
}

See docs/nwp-forecasts.md for the full architectural rationale and the v2.0+ roadmap.

Extends

• DataAvailabilityError

Constructors

new NwpNotAvailableError()

new NwpNotAvailableError(options): NwpNotAvailableError

Defined in: packages-ts/core/src/exceptions/index.ts:330

Parameters

options

NwpNotAvailableErrorOptions

Returns

NwpNotAvailableError

Overrides

DataAvailabilityError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "NWP_NOT_AVAILABLE"

Defined in: packages-ts/core/src/exceptions/index.ts:325

Subclass override — the stable string enum surfaced via errorCode.

Overrides

DataAvailabilityError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

DataAvailabilityError.errorCode

hint

readonly hint: string

Defined in: packages-ts/core/src/exceptions/index.ts:237

Inherited from

DataAvailabilityError.hint

model

readonly model: string

Defined in: packages-ts/core/src/exceptions/index.ts:328

reason

readonly reason: "model_unavailable" | "out_of_window" | "cache_miss" | "source_404" | "source_5xx" | "rate_limited"

Defined in: packages-ts/core/src/exceptions/index.ts:236

Inherited from

DataAvailabilityError.reason

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

DataAvailabilityError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

DataAvailabilityError.source

station

readonly station: string

Defined in: packages-ts/core/src/exceptions/index.ts:327

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

DataAvailabilityError.toDict

---

OpenMeteoSeamlessLeakageError

Defined in: packages-ts/core/src/exceptions/index.ts:538

The Open-Meteo Historical Forecast (seamless) endpoint was used without allowLeakage: true.

Phase 20 D-01 (locked decision): the seamless endpoint silently stitches forecasts from multiple model cycles into a continuous timeseries; the cycle that produced each value is unrecoverable from the response. LeakageDetector rejects rows tagged source="open_meteo.seamless" whenever as_of is asserted.

Origin: Tarabcak/mostlyright#70.

Extends

• LeakageError

Constructors

new OpenMeteoSeamlessLeakageError()

new OpenMeteoSeamlessLeakageError(message, options): OpenMeteoSeamlessLeakageError

Defined in: packages-ts/core/src/exceptions/index.ts:544

Parameters

message

string

options

OpenMeteoSeamlessLeakageErrorOptions

Returns

OpenMeteoSeamlessLeakageError

Overrides

LeakageError.constructor

Properties

asOf

readonly asOf: string

Defined in: packages-ts/core/src/exceptions/index.ts:454

Inherited from

LeakageError.asOf

defaultErrorCode

static defaultErrorCode: string = "OPEN_METEO_SEAMLESS_LEAKAGE"

Defined in: packages-ts/core/src/exceptions/index.ts:539

Subclass override — the stable string enum surfaced via errorCode.

Overrides

LeakageError.defaultErrorCode

endpointUrl

readonly endpointUrl: string

Defined in: packages-ts/core/src/exceptions/index.ts:542

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

LeakageError.errorCode

model

readonly model: string

Defined in: packages-ts/core/src/exceptions/index.ts:541

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

LeakageError.requestId

sampleViolations

readonly sampleViolations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:456

Inherited from

LeakageError.sampleViolations

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

LeakageError.source

violatingCount

readonly violatingCount: number

Defined in: packages-ts/core/src/exceptions/index.ts:455

Inherited from

LeakageError.violatingCount

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

LeakageError.toDict

---

PayloadTooLargeError

Defined in: packages-ts/core/src/exceptions/index.ts:613

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• MostlyRightError

Constructors

new PayloadTooLargeError()

new PayloadTooLargeError(message, options): PayloadTooLargeError

Defined in: packages-ts/core/src/exceptions/index.ts:620

Parameters

message

string

options

PayloadTooLargeErrorOptions

Returns

PayloadTooLargeError

Overrides

MostlyRightError.constructor

Properties

acceptedModes

readonly acceptedModes: string[]

Defined in: packages-ts/core/src/exceptions/index.ts:618

declaredSize

readonly declaredSize: number

Defined in: packages-ts/core/src/exceptions/index.ts:616

defaultErrorCode

static defaultErrorCode: string = "PAYLOAD_TOO_LARGE"

Defined in: packages-ts/core/src/exceptions/index.ts:614

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

limit

readonly limit: number

Defined in: packages-ts/core/src/exceptions/index.ts:617

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

PolymarketEventError

Defined in: packages-ts/core/src/exceptions/index.ts:649

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• MostlyRightError

Constructors

new PolymarketEventError()

new PolymarketEventError(message, options): PolymarketEventError

Defined in: packages-ts/core/src/exceptions/index.ts:130

Parameters

message

string = ""

options

MostlyRightErrorOptions = {}

Returns

PolymarketEventError

Inherited from

MostlyRightError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "POLYMARKET_EVENT_INVALID"

Defined in: packages-ts/core/src/exceptions/index.ts:650

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

RateLimitError

Defined in: packages-ts/core/src/exceptions/index.ts:696

Base HTTP-layer marker. Subclass of MostlyRightError so callers that catch MostlyRightError also catch transport errors.

Extends

• TherminalError

Constructors

new RateLimitError()

new RateLimitError(retryAfter, options): RateLimitError

Defined in: packages-ts/core/src/exceptions/index.ts:701

Parameters

retryAfter

null | number

options

RateLimitErrorOptions = {}

Returns

RateLimitError

Overrides

TherminalError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "HTTP_RATE_LIMITED"

Defined in: packages-ts/core/src/exceptions/index.ts:697

Subclass override — the stable string enum surfaced via errorCode.

Overrides

TherminalError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

TherminalError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

TherminalError.requestId

retryAfter

readonly retryAfter: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:699

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

TherminalError.source

statusCode

readonly statusCode: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:669

Inherited from

TherminalError.statusCode

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

TherminalError.toDict

---

SchemaValidationError

Defined in: packages-ts/core/src/exceptions/index.ts:367

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• MostlyRightError

Extended by

• IssuedAtMissingError

Constructors

new SchemaValidationError()

new SchemaValidationError(message, options): SchemaValidationError

Defined in: packages-ts/core/src/exceptions/index.ts:375

Parameters

message

string

options

SchemaValidationErrorOptions

Returns

SchemaValidationError

Overrides

MostlyRightError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "SCHEMA_VALIDATION_FAILED"

Defined in: packages-ts/core/src/exceptions/index.ts:368

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

quarantineCount

readonly quarantineCount: number

Defined in: packages-ts/core/src/exceptions/index.ts:372

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

sampleViolations

readonly sampleViolations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:373

schemaId

readonly schemaId: string

Defined in: packages-ts/core/src/exceptions/index.ts:370

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

violations

readonly violations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:371

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

ServerError

Defined in: packages-ts/core/src/exceptions/index.ts:739

Base HTTP-layer marker. Subclass of MostlyRightError so callers that catch MostlyRightError also catch transport errors.

Extends

• TherminalError

Constructors

new ServerError()

new ServerError(message, options): ServerError

Defined in: packages-ts/core/src/exceptions/index.ts:742

Parameters

message

string = "Server error"

options

TherminalErrorOptions = {}

Returns

ServerError

Overrides

TherminalError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "HTTP_SERVER_ERROR"

Defined in: packages-ts/core/src/exceptions/index.ts:740

Subclass override — the stable string enum surfaced via errorCode.

Overrides

TherminalError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

TherminalError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

TherminalError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

TherminalError.source

statusCode

readonly statusCode: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:669

Inherited from

TherminalError.statusCode

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

TherminalError.toDict

---

SourceMismatchError

Defined in: packages-ts/core/src/exceptions/index.ts:407

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• MostlyRightError

Constructors

new SourceMismatchError()

new SourceMismatchError(message, options): SourceMismatchError

Defined in: packages-ts/core/src/exceptions/index.ts:422

Parameters

message

string

options

SourceMismatchErrorOptions

Returns

SourceMismatchError

Overrides

MostlyRightError.constructor

Properties

catalogWarning

readonly catalogWarning: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:420

dataSource

readonly dataSource: string

Defined in: packages-ts/core/src/exceptions/index.ts:418

defaultErrorCode

static defaultErrorCode: string = "SOURCE_MISMATCH"

Defined in: packages-ts/core/src/exceptions/index.ts:408

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

role

readonly role: null | SourceMismatchRole

Defined in: packages-ts/core/src/exceptions/index.ts:419

schemaSource

readonly schemaSource: string

Defined in: packages-ts/core/src/exceptions/index.ts:417

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

VALID_ROLES

readonly static VALID_ROLES: ReadonlySet<SourceMismatchRole>

Defined in: packages-ts/core/src/exceptions/index.ts:411

Canonical role-name vocabulary (design.md §R).

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

SourceUnavailableError

Defined in: packages-ts/core/src/exceptions/index.ts:175

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• MostlyRightError

Constructors

new SourceUnavailableError()

new SourceUnavailableError(message, options): SourceUnavailableError

Defined in: packages-ts/core/src/exceptions/index.ts:184

Parameters

message

string = ""

options

SourceUnavailableErrorOptions = {}

Returns

SourceUnavailableError

Overrides

MostlyRightError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "SOURCE_UNAVAILABLE"

Defined in: packages-ts/core/src/exceptions/index.ts:176

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

httpStatus

readonly httpStatus: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:178

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

retryable

readonly retryable: boolean

Defined in: packages-ts/core/src/exceptions/index.ts:179

retryAfterS

readonly retryAfterS: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:180

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

underlying

readonly underlying: string

Defined in: packages-ts/core/src/exceptions/index.ts:181

url

readonly url: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:182

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

StationCatalog

Defined in: packages-ts/core/src/stations/index.ts:33

Read-only view over the station registry with venue/country filters.

Lookups accept either the registry code (3-letter NWS code for US stations, ICAO for international) or the 4-letter ICAO directly, so get("NYC"), get("KNYC"), and get("EGLL") all resolve.

Constructors

new StationCatalog()

new StationCatalog(stations): StationCatalog

Defined in: packages-ts/core/src/stations/index.ts:38

Parameters

stations

readonly StationInfo[] = STATIONS

Returns

StationCatalog

Accessors

size

Get Signature

get size(): number

Defined in: packages-ts/core/src/stations/index.ts:98

Returns

number

Methods

[iterator]()

[iterator](): Iterator<StationInfo>

Defined in: packages-ts/core/src/stations/index.ts:102

Returns

Iterator<StationInfo>

filterByCountry()

filterByCountry(country): StationInfo[]

Defined in: packages-ts/core/src/stations/index.ts:78

Stations whose ISO 3166-1 alpha-2 country matches, sorted by ICAO.

Parameters

country

string

Returns

StationInfo[]

filterByVenue()

filterByVenue(venue): StationInfo[]

Defined in: packages-ts/core/src/stations/index.ts:71

Stations tagged with venue (e.g. “kalshi”), sorted by ICAO.

Parameters

venue

string

Returns

StationInfo[]

get()

get(code): StationInfo

Defined in: packages-ts/core/src/stations/index.ts:60

Return the station for code (registry code or ICAO).

Parameters

code

string

Returns

StationInfo

Throws

if no station matches.

has()

has(code): boolean

Defined in: packages-ts/core/src/stations/index.ts:94

True iff code resolves to a station (by registry code or ICAO).

Parameters

code

string

Returns

boolean

venues()

venues(): ReadonlySet<string>

Defined in: packages-ts/core/src/stations/index.ts:85

Union of all venue tags present in the catalog.

Returns

ReadonlySet<string>

---

TemporalDriftError

Defined in: packages-ts/core/src/exceptions/index.ts:576

Base class for all mostlyright structured errors.

errorCode is a stable enum (e.g. “SOURCE_UNAVAILABLE”) used by callers / agents to branch on without parsing message text. source is the source id involved (e.g. “iem.archive”) when applicable, and requestId correlates a JSON-RPC / MCP request id when applicable.

Extends

• MostlyRightError

Constructors

new TemporalDriftError()

new TemporalDriftError(message, options): TemporalDriftError

Defined in: packages-ts/core/src/exceptions/index.ts:584

Parameters

message

string

options

TemporalDriftErrorOptions

Returns

TemporalDriftError

Overrides

MostlyRightError.constructor

Properties

assertedRange

readonly assertedRange: [string, string]

Defined in: packages-ts/core/src/exceptions/index.ts:580

defaultErrorCode

static defaultErrorCode: string = "TEMPORAL_DRIFT"

Defined in: packages-ts/core/src/exceptions/index.ts:577

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

sampleViolations

readonly sampleViolations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:582

schemaId

readonly schemaId: string

Defined in: packages-ts/core/src/exceptions/index.ts:579

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

violatingRows

readonly violatingRows: number

Defined in: packages-ts/core/src/exceptions/index.ts:581

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

TherminalError

Defined in: packages-ts/core/src/exceptions/index.ts:666

Base HTTP-layer marker. Subclass of MostlyRightError so callers that catch MostlyRightError also catch transport errors.

Extends

• MostlyRightError

Extended by

• NotFoundError
• RateLimitError
• ValidationError
• AuthenticationError
• ForbiddenError
• ServerError

Constructors

new TherminalError()

new TherminalError(message, options): TherminalError

Defined in: packages-ts/core/src/exceptions/index.ts:671

Parameters

message

string

options

TherminalErrorOptions = {}

Returns

TherminalError

Overrides

MostlyRightError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "HTTP_ERROR"

Defined in: packages-ts/core/src/exceptions/index.ts:667

Subclass override — the stable string enum surfaced via errorCode.

Overrides

MostlyRightError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

MostlyRightError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

MostlyRightError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

MostlyRightError.source

statusCode

readonly statusCode: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:669

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

MostlyRightError.toDict

---

ValidationError

Defined in: packages-ts/core/src/exceptions/index.ts:715

Base HTTP-layer marker. Subclass of MostlyRightError so callers that catch MostlyRightError also catch transport errors.

Extends

• TherminalError

Constructors

new ValidationError()

new ValidationError(message, options): ValidationError

Defined in: packages-ts/core/src/exceptions/index.ts:718

Parameters

message

string = "Invalid request"

options

TherminalErrorOptions = {}

Returns

ValidationError

Overrides

TherminalError.constructor

Properties

defaultErrorCode

static defaultErrorCode: string = "HTTP_BAD_REQUEST"

Defined in: packages-ts/core/src/exceptions/index.ts:716

Subclass override — the stable string enum surfaced via errorCode.

Overrides

TherminalError.defaultErrorCode

errorCode

readonly errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:126

Inherited from

TherminalError.errorCode

requestId

readonly requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:128

Inherited from

TherminalError.requestId

source

readonly source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:127

Inherited from

TherminalError.source

statusCode

readonly statusCode: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:669

Inherited from

TherminalError.statusCode

Methods

toDict()

toDict(): Record<string, unknown>

Defined in: packages-ts/core/src/exceptions/index.ts:157

Return a JSON-safe dict suitable for MCP error.data.

Returns

Record<string, unknown>

Inherited from

TherminalError.toDict

Interfaces

DataAvailabilityErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:228

Extends

• MostlyRightErrorOptions

Properties

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

hint

hint: string

Defined in: packages-ts/core/src/exceptions/index.ts:230

reason

reason: "model_unavailable" | "out_of_window" | "cache_miss" | "source_404" | "source_5xx" | "rate_limited"

Defined in: packages-ts/core/src/exceptions/index.ts:229

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

---

FetchWithRetryOptions

Defined in: packages-ts/core/src/internal/http.ts:38

Properties

baseDelayMs?

optional baseDelayMs: number

Defined in: packages-ts/core/src/internal/http.ts:40

Base backoff delay in milliseconds (default 1000).

body?

optional body: null | BodyInit

Defined in: packages-ts/core/src/internal/http.ts:56

Optional request body (forwarded to fetch).

headers?

optional headers: Record<string, string>

Defined in: packages-ts/core/src/internal/http.ts:50

Request headers.

maxRetries?

optional maxRetries: number

Defined in: packages-ts/core/src/internal/http.ts:42

Total attempts (default 3).

method?

optional method: string

Defined in: packages-ts/core/src/internal/http.ts:54

HTTP method (default GET).

retryStatuses?

optional retryStatuses: ReadonlySet<number>

Defined in: packages-ts/core/src/internal/http.ts:46

Statuses that trigger a retry. Default {429, 500, 502, 503, 504}.

signal?

optional signal: AbortSignal

Defined in: packages-ts/core/src/internal/http.ts:48

Caller-supplied abort signal (composed with per-attempt timeout).

timeoutMs?

optional timeoutMs: number

Defined in: packages-ts/core/src/internal/http.ts:44

Per-attempt timeout in milliseconds (default 60_000).

userAgent?

optional userAgent: string

Defined in: packages-ts/core/src/internal/http.ts:52

Convenience: set the User-Agent header.

---

ForecastIemMosV1

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:5

Properties

apparent_temp_c?

optional apparent_temp_c: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:9

units: celsius

cape_jkg?

optional cape_jkg: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:13

units: J/kg

cloud_cover_pct?

optional cloud_cover_pct: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:17

units: percent

dew_point_c?

optional dew_point_c: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:21

units: celsius

direct_radiation_wm2?

optional direct_radiation_wm2: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:25

units: W/m^2

forecast_hour

forecast_hour: number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:29

units: hours — (valid_at - issued_at).total_seconds() / 3600

freezing_level_m?

optional freezing_level_m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:33

units: meters

issued_at?

optional issued_at: null | string

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:37

model run time (knowledge_time). Nullable to accommodate Phase 20 open_meteo.seamless rows whose cycle is unrecoverable from the response. LeakageDetector + assert_issued_at_populated() are the runtime gates that reject null issued_at in training-data paths.

model

model: string

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:41

e.g. NBE, GFS, LAV, MET, gfs_global, ecmwf_ifs025

precip_probability?

optional precip_probability: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:45

units: probability — bounded [0, 1]

precipitation_mm?

optional precipitation_mm: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:49

units: mm

pressure_msl_hpa?

optional pressure_msl_hpa: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:53

units: hPa

retrieved_at

retrieved_at: string

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:57

wall-clock time the row was fetched from upstream

shortwave_radiation_wm2?

optional shortwave_radiation_wm2: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:61

units: W/m^2

sky_cover_pct?

optional sky_cover_pct: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:65

units: percent — bounded [0, 100]

snow_depth_m?

optional snow_depth_m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:69

units: meters

source

source: string

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:73

iem.archive | open_meteo.previous_runs | open_meteo.single_run | open_meteo.live

station

station: string

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:74

surface_pressure_hpa?

optional surface_pressure_hpa: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:78

units: hPa

temp_c?

optional temp_c: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:82

units: celsius

valid_at

valid_at: string

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:86

forecast target time (event_time)

visibility_m?

optional visibility_m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:90

units: meters

weather_code?

optional weather_code: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:94

units: WMO 4677 — WMO weather code (clear, fog, rain, snow, etc.)

wind_dir_deg?

optional wind_dir_deg: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:98

units: degrees

wind_gusts_ms?

optional wind_gusts_ms: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:102

units: m/s

wind_speed_ms?

optional wind_speed_ms: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.iem_mos.v1.ts:106

units: m/s

---

ForecastNwpV1

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:5

Properties

cloud_ceiling_m?

optional cloud_ceiling_m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:9

units: m

cloud_cover_pct?

optional cloud_cover_pct: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:13

units: percent

dewpoint_k_2m?

optional dewpoint_k_2m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:17

units: K

forecast_hour

forecast_hour: number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:21

units: hours — lead time in hours (alias: fxx)

grid_dist_km

grid_dist_km: number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:25

units: km — great-circle distance from station to nearest grid cell

grid_kind

grid_kind: string

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:29

grid-projection label (lambert_conformal_conus, regular_latlon_global_0p25, …)

issued_at

issued_at: string

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:33

model run / cycle reference time

mirror

mirror: "aws_bdp" | "azure_bdp" | "ecmwf_aws" | "ecmwf_azure" | "ecmwf_data_portal" | "ecmwf_gcp" | "gcp_bdp" | "msc" | "nomads"

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:37

NOAA BDP mirror that served the underlying bytes

model

model: "cfs" | "ecmwf_aifs_ens" | "ecmwf_aifs_single" | "ecmwf_ifs_ens" | "ecmwf_ifs_hres" | "gdas" | "gdps" | "gefs" | "geps" | "gfs" | "hafs" | "hiresw" | "hrdps" | "href" | "hrrr" | "hrrrak" | "nam" | "nbm" | "rap" | "rdps" | "reps" | "rrfs" | "rtma" | "urma"

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:47

precip_mm_1h?

optional precip_mm_1h: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:75

units: mm

pressure_pa_mslp?

optional pressure_pa_mslp: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:79

units: Pa

pressure_pa_surface?

optional pressure_pa_surface: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:83

units: Pa

qc_status

qc_status: "clean" | "flagged" | "suspect"

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:87

inline physics-bounds verdict; finer-grained QC lands in Phase 3.4

relative_humidity_pct_2m?

optional relative_humidity_pct_2m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:91

units: percent

retrieved_at

retrieved_at: string

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:95

wall-clock UTC when the bytes were fetched

station

station: string

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:96

temp_k_2m?

optional temp_k_2m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:100

units: K

valid_at

valid_at: string

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:104

forecast target time = issued_at + forecast_hour

visibility_m?

optional visibility_m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:108

units: m

wind_gust_ms?

optional wind_gust_ms: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:112

units: m/s

wind_u_ms_10m?

optional wind_u_ms_10m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:116

units: m/s

wind_v_ms_10m?

optional wind_v_ms_10m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast_nwp.v1.ts:120

units: m/s

---

ForecastStationV1

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:5

Properties

apparent_temp_c?

optional apparent_temp_c: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:9

units: celsius

cape_jkg?

optional cape_jkg: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:13

units: J/kg

cloud_cover_pct?

optional cloud_cover_pct: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:17

units: percent

dew_point_c?

optional dew_point_c: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:21

units: celsius

direct_radiation_wm2?

optional direct_radiation_wm2: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:25

units: W/m^2

forecast_hour

forecast_hour: number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:29

units: hours — (valid_at - issued_at).total_seconds() / 3600

freezing_level_m?

optional freezing_level_m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:33

units: meters

issued_at?

optional issued_at: null | string

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:37

model run time (knowledge_time). Nullable to accommodate Phase 20 open_meteo.seamless rows whose cycle is unrecoverable from the response. LeakageDetector + assert_issued_at_populated() are the runtime gates that reject null issued_at in training-data paths.

model

model: string

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:41

e.g. NBE, GFS, LAV, MET, gfs_global, ecmwf_ifs025

precip_probability?

optional precip_probability: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:45

units: probability — bounded [0, 1]

precipitation_mm?

optional precipitation_mm: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:49

units: mm

pressure_msl_hpa?

optional pressure_msl_hpa: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:53

units: hPa

retrieved_at

retrieved_at: string

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:57

wall-clock time the row was fetched from upstream

shortwave_radiation_wm2?

optional shortwave_radiation_wm2: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:61

units: W/m^2

sky_cover_pct?

optional sky_cover_pct: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:65

units: percent — bounded [0, 100]

snow_depth_m?

optional snow_depth_m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:69

units: meters

source

source: string

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:73

iem.archive | open_meteo.previous_runs | open_meteo.single_run | open_meteo.live

station

station: string

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:74

surface_pressure_hpa?

optional surface_pressure_hpa: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:78

units: hPa

temp_c?

optional temp_c: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:82

units: celsius

valid_at

valid_at: string

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:86

forecast target time (event_time)

visibility_m?

optional visibility_m: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:90

units: meters

weather_code?

optional weather_code: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:94

units: WMO 4677 — WMO weather code (clear, fog, rain, snow, etc.)

wind_dir_deg?

optional wind_dir_deg: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:98

units: degrees

wind_gusts_ms?

optional wind_gusts_ms: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:102

units: m/s

wind_speed_ms?

optional wind_speed_ms: null | number

Defined in: packages-ts/core/src/schemas/generated/forecast.station.v1.ts:106

units: m/s

---

IssuedAtMissingErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:479

Extends

• MostlyRightErrorOptions

Properties

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

sampleViolations?

optional sampleViolations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:481

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

violatingCount?

optional violatingCount: number

Defined in: packages-ts/core/src/exceptions/index.ts:480

---

LeakageErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:445

Extends

• MostlyRightErrorOptions

Properties

asOf

asOf: string

Defined in: packages-ts/core/src/exceptions/index.ts:446

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

sampleViolations?

optional sampleViolations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:448

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

violatingCount

violatingCount: number

Defined in: packages-ts/core/src/exceptions/index.ts:447

---

MostlyRightErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:108

Extended by

• SourceUnavailableErrorOptions
• DataAvailabilityErrorOptions
• NwpNotAvailableErrorOptions
• SchemaValidationErrorOptions
• SourceMismatchErrorOptions
• LeakageErrorOptions
• IssuedAtMissingErrorOptions
• OpenMeteoSeamlessLeakageErrorOptions
• TemporalDriftErrorOptions
• PayloadTooLargeErrorOptions
• TherminalErrorOptions
• NoLiveDataErrorOptions

Properties

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

---

NoLiveDataErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:763

Extends

• MostlyRightErrorOptions

Properties

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

source

source: string

Defined in: packages-ts/core/src/exceptions/index.ts:765

Overrides

MostlyRightErrorOptions.source

station

station: string

Defined in: packages-ts/core/src/exceptions/index.ts:764

---

NwpNotAvailableErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:286

Extends

• MostlyRightErrorOptions

Properties

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

hint

hint: string

Defined in: packages-ts/core/src/exceptions/index.ts:292

Operator-actionable hint. Required (matches DataAvailabilityError contract).

model

model: string

Defined in: packages-ts/core/src/exceptions/index.ts:290

NWP model the caller asked for (e.g. "gfs", "hrrr").

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

station

station: string

Defined in: packages-ts/core/src/exceptions/index.ts:288

Station the caller asked for (echoed back for log/error attribution).

---

ObservationLedgerV1

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:5

Properties

as_of_time?

optional as_of_time: null | string

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:6

dewpoint_c?

optional dewpoint_c: null | number

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:10

units: celsius

ingestion_id?

optional ingestion_id: null | string

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:11

observation_kind?

optional observation_kind: null | "METAR" | "SPECI"

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:12

observation_quality?

optional observation_quality: null | "clean" | "flagged" | "suspect"

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:16

Lineage row-quality flag per LINEAGE-01; distinct from qc_status enum slot AND distinct from the obs_qc_status bitmask column per QC-05.

observation_type

observation_type: "METAR" | "SPECI"

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:17

observed_at

observed_at: string

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:18

parser_name?

optional parser_name: null | "ghcnh" | "iem" | "mostlyright_v1" | "ncei"

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:19

parser_version?

optional parser_version: null | string

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:20

provenance?

optional provenance: null | "legacy" | "reingested"

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:21

qc_status?

optional qc_status: null | "clean" | "flagged" | "suspect"

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:22

source

source: "ghcnh" | "iem" | "ncei" | "awc"

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:26

ncei reserved per D-2.1-09; never written in v0.1.0.

source_received_at?

optional source_received_at: null | string

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:27

station_code

station_code: string

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:28

temp_c?

optional temp_c: null | number

Defined in: packages-ts/core/src/schemas/generated/observation_ledger.v1.ts:32

units: celsius

---

ObservationQcV1

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:5

Properties

as_of_time?

optional as_of_time: null | string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:6

detector_metadata?

optional detector_metadata: null | string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:10

JSON-serialized detector payload; shape per qc_system.

field

field: string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:14

Observation column the rule evaluated (e.g. temp_c).

flag

flag: "clean" | "flagged" | "suspect"

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:15

ingestion_id?

optional ingestion_id: null | string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:16

observation_kind?

optional observation_kind: null | "METAR" | "SPECI"

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:17

observed_at

observed_at: string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:18

parser_name?

optional parser_name: null | string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:19

qc_system

qc_system: string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:20

qc_version

qc_version: string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:21

rule_id

rule_id: string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:22

source

source: "ghcnh" | "iem" | "ncei" | "awc"

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:23

station_code

station_code: string

Defined in: packages-ts/core/src/schemas/generated/observation_qc.v1.ts:24

---

ObservationV1

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:5

Properties

dew_point_c?

optional dew_point_c: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:9

units: celsius — bounded

event_time

event_time: string

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:13

observation valid time

metar_raw?

optional metar_raw: null | string

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:17

raw METAR text if source has it; null for AWC JSON (structured-only)

observation_type

observation_type: "METAR" | "SPECI"

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:21

METAR | SPECI; defaults METAR when source can’t distinguish (e.g. AWC JSON)

precip_mm_1h?

optional precip_mm_1h: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:25

units: mm — hourly precip (METAR p01i, converted from inches)

sky_base_1_m?

optional sky_base_1_m: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:29

units: meters — first cloud layer base height (converted from feet)

sky_base_2_m?

optional sky_base_2_m: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:33

units: meters

sky_base_3_m?

optional sky_base_3_m: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:37

units: meters

sky_base_4_m?

optional sky_base_4_m: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:41

units: meters

sky_cover_1?

optional sky_cover_1: null | "BKN" | "CLR" | "FEW" | "OVC" | "SCT" | "VV"

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:45

first cloud layer cover code

sky_cover_2?

optional sky_cover_2: null | "BKN" | "CLR" | "FEW" | "OVC" | "SCT" | "VV"

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:49

second layer; null if not present

sky_cover_3?

optional sky_cover_3: null | "BKN" | "CLR" | "FEW" | "OVC" | "SCT" | "VV"

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:53

third layer; null if not present

sky_cover_4?

optional sky_cover_4: null | "BKN" | "CLR" | "FEW" | "OVC" | "SCT" | "VV"

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:57

fourth layer; null if not present

slp_hpa?

optional slp_hpa: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:61

units: hPa — sea-level pressure (canonical aviation unit, not converted across modes)

station

station: string

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:65

ICAO/ASOS station ID (e.g. KORD)

temp_c?

optional temp_c: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:69

units: celsius — bounded TEMP_MIN_C..TEMP_MAX_C

visibility_m?

optional visibility_m: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:73

units: meters — converted from statute miles

wind_dir_deg?

optional wind_dir_deg: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:77

units: degrees — 0-360, bounded

wind_gust_ms?

optional wind_gust_ms: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:81

units: m/s — converted from kt

wind_speed_ms?

optional wind_speed_ms: null | number

Defined in: packages-ts/core/src/schemas/generated/observation.v1.ts:85

units: m/s — converted from kt

---

OpenMeteoSeamlessLeakageErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:520

Extends

• MostlyRightErrorOptions

Properties

asOf?

optional asOf: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:523

endpointUrl

endpointUrl: string

Defined in: packages-ts/core/src/exceptions/index.ts:522

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

model

model: string

Defined in: packages-ts/core/src/exceptions/index.ts:521

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

---

PayloadTooLargeErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:607

Extends

• MostlyRightErrorOptions

Properties

acceptedModes?

optional acceptedModes: string[]

Defined in: packages-ts/core/src/exceptions/index.ts:610

declaredSize

declaredSize: number

Defined in: packages-ts/core/src/exceptions/index.ts:608

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

limit

limit: number

Defined in: packages-ts/core/src/exceptions/index.ts:609

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

---

QcAlphaRule

Defined in: packages-ts/core/src/data/generated/qc-alpha-rules.ts:5

Properties

bit_position

bit_position: number

Defined in: packages-ts/core/src/data/generated/qc-alpha-rules.ts:7

description

description: string

Defined in: packages-ts/core/src/data/generated/qc-alpha-rules.ts:8

field

field: string

Defined in: packages-ts/core/src/data/generated/qc-alpha-rules.ts:9

rule_id

rule_id: string

Defined in: packages-ts/core/src/data/generated/qc-alpha-rules.ts:6

---

RateLimitErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:692

Extends

• TherminalErrorOptions

Properties

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

TherminalErrorOptions.errorCode

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

TherminalErrorOptions.requestId

retryAfter?

optional retryAfter: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:693

Overrides

TherminalErrorOptions.retryAfter

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

TherminalErrorOptions.source

statusCode?

optional statusCode: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:658

Inherited from

TherminalErrorOptions.statusCode

---

SchemaValidationErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:360

Extends

• MostlyRightErrorOptions

Properties

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

quarantineCount?

optional quarantineCount: number

Defined in: packages-ts/core/src/exceptions/index.ts:363

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

sampleViolations?

optional sampleViolations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:364

schemaId

schemaId: string

Defined in: packages-ts/core/src/exceptions/index.ts:361

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

violations?

optional violations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:362

---

SettlementCliV1

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:5

Properties

cli_data_quality

cli_data_quality: "clean" | "flagged_instrument" | "flagged_late" | "flagged_other" | "missing"

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:9

NWS CLI data-quality marker (Pitfall 6/16). Allows downstream code to filter or weight settlement rows by issuer quality without re-parsing the product header.

event_time

event_time: string

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:13

00:00 local time on observation_date converted to UTC; for sort/join only

observation_date

observation_date: string

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:17

local climate day per NWS convention (no timezone applied to the date itself)

precipitation_in?

optional precipitation_in: null | number

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:21

units: inches

product_release_time

product_release_time: string

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:25

parsed from CLI product header (_climate.py::_parse_product_timestamp)

report_type

report_type: "correction" | "final" | "preliminary"

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:29

preliminary | final | correction; dedup priority preliminary < final < correction

settlement_finality

settlement_finality: "final" | "provisional" | "superseded"

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:33

provisional | final | superseded. Kalshi NHIGH/NLOW settlement contractually requires ‘final’; ‘provisional’ values are kept for early-look research only.

snowfall_in?

optional snowfall_in: null | number

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:37

units: inches

station

station: string

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:41

ICAO/ASOS station ID

station_tz

station_tz: string

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:45

IANA timezone for the station (e.g. America/Chicago for KORD). Required for local-climate-day semantics; see §U.

temp_max_F?

optional temp_max_F: null | number

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:49

units: fahrenheit — daily high (uppercase F for consistency with obs imperial mode)

temp_min_F?

optional temp_min_F: null | number

Defined in: packages-ts/core/src/schemas/generated/settlement.cli.v1.ts:53

units: fahrenheit — daily low

---

SourceMismatchErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:400

Extends

• MostlyRightErrorOptions

Properties

catalogWarning?

optional catalogWarning: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:404

dataSource

dataSource: string

Defined in: packages-ts/core/src/exceptions/index.ts:402

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

role?

optional role: null | SourceMismatchRole

Defined in: packages-ts/core/src/exceptions/index.ts:403

schemaSource

schemaSource: string

Defined in: packages-ts/core/src/exceptions/index.ts:401

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

---

SourceUnavailableErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:167

Extends

• MostlyRightErrorOptions

Properties

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

httpStatus?

optional httpStatus: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:168

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

retryable?

optional retryable: boolean

Defined in: packages-ts/core/src/exceptions/index.ts:169

retryAfterS?

optional retryAfterS: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:170

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

underlying?

optional underlying: string

Defined in: packages-ts/core/src/exceptions/index.ts:171

url?

optional url: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:172

---

StationInfo

Defined in: packages-ts/core/src/data/generated/stations.ts:5

Properties

code

code: null | string

Defined in: packages-ts/core/src/data/generated/stations.ts:6

country

country: null | string

Defined in: packages-ts/core/src/data/generated/stations.ts:13

ghcnh_id

ghcnh_id: null | string

Defined in: packages-ts/core/src/data/generated/stations.ts:7

icao

icao: string

Defined in: packages-ts/core/src/data/generated/stations.ts:8

latitude

latitude: null | number

Defined in: packages-ts/core/src/data/generated/stations.ts:11

longitude

longitude: null | number

Defined in: packages-ts/core/src/data/generated/stations.ts:12

name

name: null | string

Defined in: packages-ts/core/src/data/generated/stations.ts:9

tz

tz: string

Defined in: packages-ts/core/src/data/generated/stations.ts:10

venues

venues: readonly string[]

Defined in: packages-ts/core/src/data/generated/stations.ts:14

---

TemporalDriftErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:569

Extends

• MostlyRightErrorOptions

Properties

assertedRange

assertedRange: [string, string]

Defined in: packages-ts/core/src/exceptions/index.ts:571

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

sampleViolations?

optional sampleViolations: Record<string, unknown>[]

Defined in: packages-ts/core/src/exceptions/index.ts:573

schemaId

schemaId: string

Defined in: packages-ts/core/src/exceptions/index.ts:570

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

violatingRows

violatingRows: number

Defined in: packages-ts/core/src/exceptions/index.ts:572

---

TherminalErrorOptions

Defined in: packages-ts/core/src/exceptions/index.ts:657

Extends

• MostlyRightErrorOptions

Extended by

• RateLimitErrorOptions

Properties

errorCode?

optional errorCode: string

Defined in: packages-ts/core/src/exceptions/index.ts:109

Inherited from

MostlyRightErrorOptions.errorCode

requestId?

optional requestId: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:111

Inherited from

MostlyRightErrorOptions.requestId

retryAfter?

optional retryAfter: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:659

source?

optional source: null | string

Defined in: packages-ts/core/src/exceptions/index.ts:110

Inherited from

MostlyRightErrorOptions.source

statusCode?

optional statusCode: null | number

Defined in: packages-ts/core/src/exceptions/index.ts:658

Type Aliases

DataAvailabilityReason

DataAvailabilityReason: typeof DATA_AVAILABILITY_REASONS[number]

Defined in: packages-ts/core/src/exceptions/index.ts:226

---

SourceMismatchRole

SourceMismatchRole: "observations" | "forecasts" | "settlement"

Defined in: packages-ts/core/src/exceptions/index.ts:398

---

Station

Station: StationInfo

Defined in: packages-ts/core/src/stations/index.ts:24

Variables

_CLI_PUBLICATION_DELAY_HOURS

const _CLI_PUBLICATION_DELAY_HOURS: 10 = 10.0

Defined in: packages-ts/core/src/snapshot.ts:134

NWS CLI typical publication delay: 10 h after midnight LST.

---

_JAN_REF

const _JAN_REF: Date

Defined in: packages-ts/core/src/snapshot.ts:131

Reference UTC moment in January (no DST in Northern Hemisphere US).

---

_MARKET_CLOSE_HOUR_LST

const _MARKET_CLOSE_HOUR_LST: 16 = 16

Defined in: packages-ts/core/src/snapshot.ts:137

Kalshi market typical close time (LST).

---

_MARKET_CLOSE_MINUTE_LST

const _MARKET_CLOSE_MINUTE_LST: 30 = 30

Defined in: packages-ts/core/src/snapshot.ts:138

---

_STATION_TZ

const _STATION_TZ: Readonly<Record<string, string>>

Defined in: packages-ts/core/src/snapshot.ts:22

---

CATALOG

const CATALOG: StationCatalog

Defined in: packages-ts/core/src/stations/index.ts:108

Process-wide default catalog over the codegen station registry.

---

CLIMATE_REPORT_TYPE_PRIORITY

const CLIMATE_REPORT_TYPE_PRIORITY: Readonly<Record<string, number>>

Defined in: packages-ts/core/src/data/generated/source-priority.ts:11

---

DATA_AVAILABILITY_REASONS

const DATA_AVAILABILITY_REASONS: readonly ["model_unavailable", "out_of_window", "cache_miss", "source_404", "source_5xx", "rate_limited"]

Defined in: packages-ts/core/src/exceptions/index.ts:217

Shared reason enum — MUST match Python EXACTLY (Phase 21 D-04).

---

LIVE_V1_POLICY

const LIVE_V1_POLICY: object

Defined in: packages-ts/core/src/data/generated/source-priority.ts:19

Type declaration

name

name: string

secondaryKey

secondaryKey: ReadonlyArray<string>

sourcePriority

sourcePriority: Readonly<Record<string, number>>

---

OBSERVATION_SOURCE_PRIORITY

const OBSERVATION_SOURCE_PRIORITY: Readonly<Record<string, number>>

Defined in: packages-ts/core/src/data/generated/source-priority.ts:5

---

QC_ALPHA_RULES

const QC_ALPHA_RULES: ReadonlyArray<QcAlphaRule>

Defined in: packages-ts/core/src/data/generated/qc-alpha-rules.ts:12

---

QC_ALPHA_RULES_BY_ID

const QC_ALPHA_RULES_BY_ID: ReadonlyMap<string, QcAlphaRule>

Defined in: packages-ts/core/src/data/generated/qc-alpha-rules.ts:45

---

STATION_BY_CODE

const STATION_BY_CODE: ReadonlyMap<string, StationInfo>

Defined in: packages-ts/core/src/data/generated/stations.ts:1190

---

STATION_BY_ICAO

const STATION_BY_ICAO: ReadonlyMap<string, StationInfo>

Defined in: packages-ts/core/src/data/generated/stations.ts:1287

---

STATIONS

const STATIONS: ReadonlyArray<StationInfo>

Defined in: packages-ts/core/src/data/generated/stations.ts:17

---

version

const version: "1.15.0" = "1.15.0"

Defined in: packages-ts/core/src/index.ts:9

Placeholder version string from the TS-W0 Wave 1 scaffold. The authoritative package version lives in package.json#version (currently 0.1.0-rc.7); this constant has not been bumped.

Functions

_lstOffsetHours()

_lstOffsetHours(stationTz): number

Defined in: packages-ts/core/src/snapshot.ts:154

Return the LOCAL STANDARD TIME UTC offset (in hours) for an IANA tz, sampled from January 15 2024 12:00 UTC so the result is never affected by DST in the Northern Hemisphere.

Implementation: format _JAN_REF in the target tz via Intl.DateTimeFormat and diff against the UTC formatted view to recover the offset.

Parameters

stationTz

string

Returns

number

---

_resolveStationTz()

_resolveStationTz(station, tzOverride?): string

Defined in: packages-ts/core/src/snapshot.ts:213

Resolve a station code (NWS 3-letter, ICAO 4-letter) to an IANA tz string. Honors tzOverride first, then the built-in _STATION_TZ map. Throws if no tz can be resolved.

Parameters

station

string

tzOverride?

string

Returns

string

---

cliAvailableAt()

cliAvailableAt(dateStr, station, delayHours, tzOverride?): Date

Defined in: packages-ts/core/src/snapshot.ts:315

Return the UTC time at which the NWS CLI for a date is expected to be available. Default delay is 10 h after midnight LST on the next day.

Parameters

dateStr

string

station

string

delayHours

number = _CLI_PUBLICATION_DELAY_HOURS

tzOverride?

string

Returns

Date

---

fetchWithRetry()

fetchWithRetry(url, opts): Promise<Response>

Defined in: packages-ts/core/src/internal/http.ts:130

GET (or other) a URL with exponential-backoff retry semantics.

Behaviour:

• signal is composed with a per-attempt timeout via AbortController.
• On retryable status (default: 429/500/502/503/504), wait baseDelayMs * 2^attempt (with ≤25% jitter) and retry, up to maxRetries total attempts.
• On 404 → NotFoundError. On 400/401/403 → ValidationError / AuthenticationError / ForbiddenError. After retry exhaustion on 429 → RateLimitError (with retryAfter honoured). After retry exhaustion on 5xx → ServerError.
• On network/transport failure: retried under the same budget, last error rethrown as a TherminalError if it isn’t one already.

Parameters

url

string

opts

FetchWithRetryOptions = {}

Returns

Promise<Response>

---

helloCore()

helloCore(): string

Defined in: packages-ts/core/src/index.ts:17

Smoke-test export from the TS-W0 Wave 1 scaffold. Returns the literal string "hello @mostlyrightmd/core". Retained so the published package has at least one importable runtime export until the scaffold is removed in a later phase.

Returns

string

---

marketCloseUtc()

marketCloseUtc(dateStr, station, tzOverride?): Date

Defined in: packages-ts/core/src/snapshot.ts:329

Return the UTC time of the Kalshi market close for a settlement date. Kalshi NHIGH/NLOW markets close at 4:30 PM LST on the day of settlement.

Parameters

dateStr

string

station

string

tzOverride?

string

Returns

Date

---

settlementDateFor()

settlementDateFor(asOf, station, tzOverride?): string

Defined in: packages-ts/core/src/snapshot.ts:267

Return the Kalshi settlement date (YYYY-MM-DD LST) for a UTC moment.

Kalshi NHIGH/NLOW contracts cover midnight–midnight LOCAL STANDARD TIME. DST is ignored: the window is always fixed to the standard UTC offset.

Parameters

asOf

string | Date

station

string

tzOverride?

string

Returns

string

---

settlementWindowUtc()

settlementWindowUtc(dateStr, station, tzOverride?): [Date, Date]

Defined in: packages-ts/core/src/snapshot.ts:286

Return UTC start/end of the Kalshi settlement window for a date. The window is midnight-midnight LST, expressed in UTC.

Parameters

dateStr

string

station

string

tzOverride?

string

Returns

[Date, Date]

---

toJsonSafe()

toJsonSafe(value, seen?): unknown

Defined in: packages-ts/core/src/exceptions/index.ts:27

Recursively coerce value into a JSON-serializable structure.

Coercion rules (mirrors Python’s to_json_safe):

• null / undefined / NaN / Infinity / -Infinity → null
• Date → ISO 8601 UTC string ending in Z
• Numeric / boolean / string scalars pass through (non-finite numbers → null)
• Arrays + plain objects → recursive (cycles → { _cycle: true, value: String(obj) })
• Dict keys MUST be strings; non-string keys throw TypeError.
• Anything else (Symbol, function, class instance without toJSON) → { _repr_only: true, value: String(value) }.

Parameters

value

unknown

seen?

WeakSet<object>

Returns

unknown