Node.js Device Readiness

Important: SDK metrics are offered for general wellness and informational purposes only. SDK metrics have not been cleared by the FDA and may not be used for medical diagnosis or treatment.

Configure the SDK's authentication, metrics, and camera, then check readiness before starting a measurement:

const result = await sdk.checkDeviceReadiness();

Use result.verdict for application decisions and result.reason for the explanation and recommended next step. Keep the returned result if you need it later.

Compare the verdict explicitly, for example result.verdict === 'ready'. Every verdict string is truthy, including 'blocked'.

See Device Readiness for verdict meanings, supported inputs, and result handling.

Telemetry is on by default. When it is enabled, each check sends its full diagnostic report to Presage: device and SDK details, requested metrics and camera settings, performance measurements, and free-text diagnostic messages. The report never includes video frames or vital signs.

To turn it off, pass enableTelemetry: false when creating the SDK:

const sdk = new SmartSpectraSDK({
  // ...authentication and metrics...
  enableTelemetry: false,
});

See SDK Telemetry & Privacy for the full report contents, storage, and retention.

When the frame rate stays too low to measure reliably during a measurement, the session ends and the 'error' event receives SmartSpectraErrorCode.kSustainedLowFrameRate (14) instead of SmartSpectraErrorCode.kProcessingFailed. The message is "SmartSpectra stopped because the frame rate stayed too low to measure reliably." A frame submitted as the session ends is rejected with the same code. retryable is false when the SDK plays a video file, because the same file stops the same way; it is true for cameras and custom input: the host may offer a user-initiated fresh start; do not restart automatically. To check whether a device can sustain measurement before starting, call checkDeviceReadiness().

The SDK measures frame rate from frame timestamps: the timestamp file when one is given, otherwise the video's playback position. The interframe delay (interframeDelayMs) changes playback speed, not the measured frame rate.