Class NessyClient

Official Node.js / TypeScript client for the NessyAPI clinical decision support platform.

The client is server-side only — it refuses to run in browsers because API keys would leak to end users. If you truly need to call from a trusted intranet client, pass { allowBrowser: true } (not recommended).

Zero runtime dependencies: uses the built-in fetch (Node 18.17+) and node:crypto. Works in Node, Bun, Deno, and Cloudflare Workers.

Example: Quickstart

import { NessyClient } from "@nessyapi/sdk";

const client = new NessyClient({ apiKey: process.env.NESSYAPI_KEY! });

const session = await client.sessions.create({
  chiefComplaint: "headache",
  age: 35,
  sex: "male",
});

// Answer the current question
const response = await client.sessions.answer(
  session.session_id,
  session.current_question!.question_id,
  { rawText: "started yesterday, mild pressure" }
);

if (response.is_complete) {
  const results = await client.sessions.finalize(session.session_id);
  console.log(results.triage_level, results.differentials);
}

Example: Error handling

import { NessyRateLimitError, NessyValidationError } from "@nessyapi/sdk";

try {
  await client.sessions.create({ chiefComplaint: "headache" });
} catch (err) {
  if (err instanceof NessyRateLimitError) {
    await sleep(err.retryAfterMs);
  } else if (err instanceof NessyValidationError) {
    console.error("Invalid input:", err.fieldErrors);
  } else {
    throw err;
  }
}

Example: Custom fetch (for undici Agent, proxies, testing)

import { Agent, fetch } from "undici";
const agent = new Agent({ keepAliveTimeout: 10_000 });
const client = new NessyClient({
  apiKey,
  fetch: (url, init) => fetch(url, { ...init, dispatcher: agent }),
});

Constructors

constructor

Properties

sessions patients admin audit webhooks team schema account

Methods

toJSON

Constructors

constructor

Properties

Readonlysessions

sessions: SessionsResource

Readonlypatients

patients: PatientsResource

Readonlyadmin

admin: AdminResource

Readonlyaudit

audit: AuditResource

Readonlywebhooks

webhooks: WebhooksResource

Readonlyteam

team: TeamResource

Readonlyschema

schema: SchemaResource

Readonlyaccount

account: AccountResource

Methods

toJSON

  • toJSON(): Record<string, unknown>

    Returns Record<string, unknown>

Settings

Member Visibility

On This Page

Constructors
Properties
Methods