warmCookies method

Future<NtsWarmCookiesOutcome> warmCookies({ required NtsServerSpec spec, Duration timeout = kDefaultTimeout, @Deprecated('Use timeout instead.') int? timeoutMs, int dnsConcurrencyCap = kDefaultDnsConcurrencyCap, int bridgeConcurrencyCap = kDefaultBridgeConcurrencyCap, DateTime? verificationTime, @Deprecated('Use verificationTime instead.') int? verificationTimeMs, })

Per-client equivalent of the top-level ntsWarmCookies. Forces a fresh NTS-KE handshake and ingests the delivered cookie pool into this client's table, replacing any previously cached session for the spec.

All arguments are validated against the FFI encoding range before dispatch on the same terms as ntsQuery / ntsWarmCookies; out-of-range values cause the returned Future to complete with NtsError.invalidSpec without reaching the Rust boundary. verificationTime carries the same cold-start clock-skew-rescue behaviour documented on ntsQuery, and the bridge admission gate on ntsQuery applies to this method unchanged (isolate-wide, shared with the top-level wrappers and every other client in the calling isolate).

Throws an NtsError on every failure path.

Implementation

Future<NtsWarmCookiesOutcome> warmCookies({
  required NtsServerSpec spec,
  Duration timeout = kDefaultTimeout,
  @Deprecated('Use timeout instead.') int? timeoutMs,
  int dnsConcurrencyCap = kDefaultDnsConcurrencyCap,
  int bridgeConcurrencyCap = kDefaultBridgeConcurrencyCap,
  DateTime? verificationTime,
  @Deprecated('Use verificationTime instead.') int? verificationTimeMs,
}) => _dispatch(
  spec: spec,
  timeout: timeout,
  timeoutMs: timeoutMs,
  dnsConcurrencyCap: dnsConcurrencyCap,
  bridgeConcurrencyCap: bridgeConcurrencyCap,
  verificationTime: verificationTime,
  verificationTimeMs: verificationTimeMs,
  call: (ffiSpec, ffiTimeoutMs, ffiVerificationMs) async => _publicWarm(
    await _inner.warmCookies(
      spec: ffiSpec,
      timeoutMs: ffiTimeoutMs,
      dnsConcurrencyCap: dnsConcurrencyCap,
      verificationTimeMs: ffiVerificationMs,
    ),
  ),
);