emuhealth 0.4.0 → 0.6.0

package/README.md

@@ -37,7 +37,15 @@ All services listen on IPv4 loopback (`127.0.0.1`) by default. No config file ne
 
 Health and life science services use a fixed range starting at `http://localhost:4100`. Each health service keeps its port no matter which other services run or how many upstream services exist.
 
-- **FHIR R4** on `http://localhost:4100` (create, read, update, JSON Patch, delete, versioning, `_history`, search, batch and transaction Bundles, and a CapabilityStatement at `/metadata`, `Patient/$everything`; starts with 5 generated synthetic patients; SMART App Launch with patient and practitioner pickers, an EHR launch simulator, PKCE, and scope and patient enforcement for presented tokens)
+- **FHIR R4** on `http://localhost:4100` (create, read, update, JSON Patch, delete, versioning, `_history`, search, batch and transaction Bundles, and a CapabilityStatement at `/metadata`, `Patient/$everything`, Bulk Data `$export` with NDJSON output; starts with 5 generated synthetic patients; SMART App Launch with patient and practitioner pickers, an EHR launch simulator, PKCE, SMART Backend Services with `private_key_jwt`, and scope and patient enforcement for presented tokens; terminology fixtures with `CodeSystem/$lookup` and `$validate-code`; browse it at `/_inspector`)
+- **Epic** on `http://localhost:4101` (the FHIR R4 server under Epic's `/api/FHIR/R4` base, OAuth 2.0 at `/oauth2/authorize` and `/oauth2/token` with SMART App Launch and Backend Services, `__epic.dstu2.patient` in token responses, Epic's informational OperationOutcome on empty searches, and Schedules and Slots with `Appointment/$find` and `Appointment/$book`)
+- **openFDA** on `http://localhost:4102` (`/drug/label.json`, `/drug/event.json`, and `/drug/enforcement.json`, `/device/enforcement.json`, `/food/enforcement.json` recalls with the openFDA query language: `search` with fields, phrases, `.exact`, ranges, `AND`/`OR`/`NOT`, plus `sort`, `count`, `limit`, and `skip`; synthetic labels, adverse event reports, and recalls; browse them at `/_inspector`)
+- **RxNav** on `http://localhost:4103` (the RxNorm REST API under `/REST`: `rxcui`, `drugs`, `properties`, `related`, `allrelated`, `ndcs`, `approximateTerm`, `spellingsuggestions`, and `displaynames`, with or without `.json`, over a verified RxNorm subset plus concepts you add; browse it at `/_inspector`)
+- **ClinicalTrials.gov** on `http://localhost:4104` (API v2 under `/api/v2`: `/studies` with `query.*`, `filter.overallStatus`, `filter.ids`, `filter.advanced` `AREA[]` clauses, `sort`, `fields`, `pageSize`, `pageToken`, and `countTotal`, plus `/studies/{nctId}`, `/version`, and `/stats/size`; synthetic studies with `NCT99` ids; browse them at `/_inspector`)
+- **NCBI E-utilities** on `http://localhost:4105` (`/entrez/eutils/einfo`, `esearch` with field tags, `AND`/`OR`/`NOT`, date ranges, paging, and `usehistory`, `esummary`, `efetch` with PubMed XML and abstract text, and `elink` between Gene and PubMed, in JSON or XML; synthetic PubMed articles and a small set of real human genes; browse them at `/_inspector`)
+- **NPPES NPI Registry** on `http://localhost:4106` (`/api/?version=2.1` with `number`, `enumeration_type`, names and organization names with `*` wildcards, `taxonomy_description`, `city`, `state`, `postal_code`, `limit`, and `skip`, and the registry's `Errors` responses; synthetic providers whose NPIs have valid check digits but start with 0, so they never match a real provider; browse them at `/_inspector`)
+- **Benchling** on `http://localhost:4107` (API v2 under `/api/v2` with an API key as the Basic auth username or a client credentials token: DNA and AA sequences with filters, `nextToken` paging, create, update, archive, and registration through `registries/{id}:register-entities` and `tasks`, notebook `entries`, `assay-results` with schemas, `events`, and Svix-signed webhooks; a synthetic tenant; browse it at `/_inspector`)
+- **REDCap** on `http://localhost:4108` (`POST /api/` with a token and `content`: `version`, `project`, `metadata`, `instrument`, `exportFieldNames`, and `record` export with `records`, `fields`, `forms`, `filterLogic`, labels, and flat or EAV output, import with validation against the data dictionary, and delete, in JSON, CSV, or XML; a synthetic project; browse it at `/_inspector`)
 
 Stripe webhooks configured with a secret include a `Stripe-Signature` header signed over the timestamp and raw request body.
 

package/THIRD_PARTY_NOTICES.md

@@ -42,8 +42,9 @@ SOFTWARE.
 
 The emuhealth synthetic data generator in
 `packages/@emuhealth/fhir-core/src/generator.ts` uses a small number of codes from
-the following code systems to make generated records realistic. No full code
-system is redistributed.
+the following code systems to make generated records realistic, and the RxNav
+emulator in `packages/@emuhealth/rxnav` serves the same small RxNorm subset. No
+full code system is redistributed.
 
 ### LOINC
 
@@ -60,8 +61,16 @@ Medicine (NLM), National Institutes of Health, Department of Health and Human
 Services; NLM is not responsible for the product and does not endorse or
 recommend this or any other product.
 
-### ICD-10-CM and CVX
+### ICD-10-CM, ICD-10-PCS, CVX, and CDC Race and Ethnicity
 
-ICD-10-CM codes are published by the National Center for Health Statistics and
-CVX codes by the Centers for Disease Control and Prevention. Both are U.S.
-government works in the public domain.
+ICD-10-CM codes are published by the National Center for Health Statistics,
+ICD-10-PCS codes by the Centers for Medicare & Medicaid Services, and CVX codes
+and the Race and Ethnicity code set by the Centers for Disease Control and
+Prevention. All are U.S. government works in the public domain.
+
+### NCBI Gene
+
+The E-utilities emulator in `packages/@emuhealth/ncbi` includes the ids, symbols,
+names, and chromosomal locations of ten human genes as published by the National
+Center for Biotechnology Information (NCBI), a U.S. government work in the public
+domain. The gene summaries were written for emuhealth.

package/dist/api.d.ts

@@ -249,7 +249,7 @@ declare function defineConfig<Definitions extends Record<string, EmulatorDefinit
     tokens?: EmulateConfig["tokens"];
 }): typeof config;
 
-declare const HEALTH_SERVICE_NAME_LIST: readonly ["fhir"];
+declare const HEALTH_SERVICE_NAME_LIST: readonly ["fhir", "epic", "openfda", "rxnav", "clinicaltrials", "ncbi", "nppes", "benchling", "redcap"];
 type HealthServiceName = (typeof HEALTH_SERVICE_NAME_LIST)[number];
 
 declare const SERVICE_NAME_LIST: readonly ["vercel", "github", "google", "slack", "apple", "microsoft", "okta", "aws", "resend", "stripe", "mongoatlas", "clerk", "linear", "twilio"];

package/dist/api.js

@@ -1158,6 +1158,8 @@ body{
 .inspector-table tbody tr{transition:background .1s;}
 .inspector-table tbody tr:hover{background:#0a3300;}
 .inspector-empty{color:#1a8c00;text-align:center;padding:20px 0;font-size:.8125rem;}
+.inspector-section a{color:#33ff00;text-decoration:underline;text-decoration-color:#1a8c00;text-underline-offset:2px;}
+.inspector-section a:hover{text-decoration-color:#33ff00;}
 
 .checkout-layout{
   display:flex;min-height:calc(100vh - 42px);
@@ -1940,14 +1942,24 @@ function defineConfig(config) {
 }
 
 // src/registry-health.ts
-var HEALTH_SERVICE_NAME_LIST = ["fhir"];
+var HEALTH_SERVICE_NAME_LIST = [
+  "fhir",
+  "epic",
+  "openfda",
+  "rxnav",
+  "clinicaltrials",
+  "ncbi",
+  "nppes",
+  "benchling",
+  "redcap"
+];
 var HEALTH_SERVICE_NAMES = HEALTH_SERVICE_NAME_LIST;
 var HEALTH_SERVICE_REGISTRY = {
   fhir: {
     label: "FHIR R4 server emulator",
-    endpoints: "create, read, vread, update (including create on update), JSON Patch, logical delete, _history, search with includes and chaining, batch and transaction Bundles, CapabilityStatement at /metadata, Patient/$everything, SMART App Launch, ETag and If-Match, generated synthetic patients",
+    endpoints: "create, read, vread, update (including create on update), JSON Patch, logical delete, _history, search with includes and chaining, batch and transaction Bundles, CapabilityStatement at /metadata, Patient/$everything, Bulk Data $export, SMART App Launch and Backend Services, ETag and If-Match, generated synthetic patients, terminology $lookup and $validate-code, inspector at /_inspector",
     async load() {
-      const mod = await import("./dist-NSZJMYCW.js");
+      const mod = await import("./dist-JJIQYFJ4.js");
       return { plugin: mod.fhirPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback() {
@@ -1967,6 +1979,159 @@ var HEALTH_SERVICE_REGISTRY = {
         ]
       }
     }
+  },
+  epic: {
+    label: "Epic FHIR R4 emulator",
+    endpoints: "Epic URL shape (/api/FHIR/R4) over the full FHIR server, OAuth 2.0 at /oauth2/authorize and /oauth2/token with SMART App Launch and Backend Services, __epic.dstu2.patient in token responses, informational OperationOutcome (4101) on empty searches, Schedules and Slots with Appointment/$find and Appointment/$book, generated synthetic patients, inspector at /_inspector",
+    async load() {
+      const mod = await import("./dist-65JH5Z2J.js");
+      return { plugin: mod.epicPlugin, seedFromConfig: mod.seedFromConfig };
+    },
+    defaultFallback() {
+      return { login: "epic-user", id: 1, scopes: [] };
+    },
+    initConfig: {
+      epic: {
+        generate: { patients: 5, seed: 1 },
+        scheduling: { days: 10 },
+        smart: { clients: [{ client_id: "my-epic-app", redirect_uris: ["http://localhost:3000/callback"] }] }
+      }
+    }
+  },
+  openfda: {
+    label: "openFDA API emulator",
+    endpoints: "drug labels (/drug/label.json), adverse event reports (/drug/event.json), and recalls (/drug/enforcement.json, /device/enforcement.json, /food/enforcement.json) with the openFDA query language (search, sort, count, limit, skip), synthetic datasets, inspector at /_inspector",
+    async load() {
+      const mod = await import("./dist-WRDU25DF.js");
+      return { plugin: mod.openfdaPlugin, seedFromConfig: mod.seedFromConfig };
+    },
+    defaultFallback() {
+      return { login: "openfda-user", id: 1, scopes: [] };
+    },
+    initConfig: {
+      openfda: {
+        generate: { seed: 1, events: 300 }
+      }
+    }
+  },
+  rxnav: {
+    label: "NLM RxNav (RxNorm API) emulator",
+    endpoints: "RxNorm REST API under /REST: rxcui by name, drugs, properties, related and allrelated concepts, ndcs, approximateTerm, spellingsuggestions, displaynames, with or without .json; built-in RxNorm subset plus configured concepts; inspector at /_inspector",
+    async load() {
+      const mod = await import("./dist-HUDK42DK.js");
+      return { plugin: mod.rxnavPlugin, seedFromConfig: mod.seedFromConfig };
+    },
+    defaultFallback() {
+      return { login: "rxnav-user", id: 1, scopes: [] };
+    },
+    initConfig: {
+      rxnav: {
+        concepts: [
+          {
+            rxcui: "900001",
+            name: "examplemab",
+            tty: "IN"
+          }
+        ]
+      }
+    }
+  },
+  clinicaltrials: {
+    label: "ClinicalTrials.gov API v2 emulator",
+    endpoints: "ClinicalTrials.gov API v2 under /api/v2: studies search (query.cond, query.term, query.intr, query.titles, query.locn, query.spons, query.id, filter.overallStatus, filter.ids, filter.advanced AREA[], sort, fields, pageSize, pageToken, countTotal), single studies, version, stats/size; synthetic studies in the NCT99 range; inspector at /_inspector",
+    async load() {
+      const mod = await import("./dist-MRCWT2JC.js");
+      return { plugin: mod.clinicaltrialsPlugin, seedFromConfig: mod.seedFromConfig };
+    },
+    defaultFallback() {
+      return { login: "clinicaltrials-user", id: 1, scopes: [] };
+    },
+    initConfig: {
+      clinicaltrials: {
+        generate: {
+          studies: 60,
+          seed: 1
+        }
+      }
+    }
+  },
+  ncbi: {
+    label: "NCBI E-utilities emulator (PubMed and Gene)",
+    endpoints: "E-utilities under /entrez/eutils: einfo, esearch (field tags, AND/OR/NOT, [dp] ranges, retstart/retmax, usehistory WebEnv), esummary, efetch (PubMed XML and abstract text), elink (gene and pubmed), GET or POST, JSON or XML; synthetic PubMed articles and real human genes; inspector at /_inspector",
+    async load() {
+      const mod = await import("./dist-MD4P4BXL.js");
+      return { plugin: mod.ncbiPlugin, seedFromConfig: mod.seedFromConfig };
+    },
+    defaultFallback() {
+      return { login: "ncbi-user", id: 1, scopes: [] };
+    },
+    initConfig: {
+      ncbi: {
+        generate: {
+          articles: 80,
+          seed: 1
+        }
+      }
+    }
+  },
+  nppes: {
+    label: "NPPES NPI Registry API emulator",
+    endpoints: "NPI Registry API at /api/?version=2.1: number, enumeration_type, first_name, last_name, organization_name (trailing * wildcards), taxonomy_description, address_purpose, city, state, postal_code, country_code, limit (max 200), skip; the registry's Errors shapes; synthetic providers with NPIs that start with 0; inspector at /_inspector",
+    async load() {
+      const mod = await import("./dist-WDXPM6L6.js");
+      return { plugin: mod.nppesPlugin, seedFromConfig: mod.seedFromConfig };
+    },
+    defaultFallback() {
+      return { login: "nppes-user", id: 1, scopes: [] };
+    },
+    initConfig: {
+      nppes: {
+        generate: {
+          individuals: 40,
+          organizations: 15,
+          seed: 1
+        }
+      }
+    }
+  },
+  benchling: {
+    label: "Benchling API v2 emulator",
+    endpoints: "Benchling API v2 under /api/v2 with API key (Basic) or client credentials (Bearer) auth: dna-sequences and aa-sequences (list, filter, page, create, update, archive), entries, registries and register-entities with tasks, assay-results and schemas, projects, folders, events, Svix-signed webhooks; synthetic tenant; inspector at /_inspector",
+    async load() {
+      const mod = await import("./dist-JAQBQLBJ.js");
+      return { plugin: mod.benchlingPlugin, seedFromConfig: mod.seedFromConfig };
+    },
+    defaultFallback() {
+      return { login: "benchling-user", id: 1, scopes: [] };
+    },
+    initConfig: {
+      benchling: {
+        generate: {
+          seed: 1,
+          dnaSequences: 10
+        },
+        webhooks: []
+      }
+    }
+  },
+  redcap: {
+    label: "REDCap API emulator",
+    endpoints: "REDCap API at POST /api/ with token and content: version, project, metadata, instrument, exportFieldNames, record export (records, fields, forms, filterLogic, rawOrLabel, flat or eav), record import (json or csv, overwriteBehavior, forceAutoNumber, returnContent), record delete, generateNextRecordName; json, csv, or xml; synthetic classic project; inspector at /_inspector",
+    async load() {
+      const mod = await import("./dist-CLJBPXNS.js");
+      return { plugin: mod.redcapPlugin, seedFromConfig: mod.seedFromConfig };
+    },
+    defaultFallback() {
+      return { login: "redcap-user", id: 1, scopes: [] };
+    },
+    initConfig: {
+      redcap: {
+        generate: {
+          records: 20,
+          seed: 1
+        }
+      }
+    }
   }
 };
 var HEALTH_PORT_OFFSET = 100;
@@ -1999,7 +2164,7 @@ var SERVICE_REGISTRY = {
     label: "Vercel REST API emulator",
     endpoints: "projects, deployments, domains, env vars, users, teams, file uploads, protection bypass, blob storage",
     async load() {
-      const mod = await import("./dist-YK2XJNH7.js");
+      const mod = await import("./dist-4CPLP2NQ.js");
       return { plugin: mod.vercelPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback(cfg) {
@@ -2026,7 +2191,7 @@ var SERVICE_REGISTRY = {
     label: "GitHub REST API emulator",
     endpoints: "users, repos, issues, PRs, comments, reviews, labels, milestones, branches, git data, orgs, teams, releases, webhooks, search, actions, checks, rate limit",
     async load() {
-      const mod = await import("./dist-M5TIXC2F.js");
+      const mod = await import("./dist-RWIGUWMG.js");
       return {
         plugin: mod.githubPlugin,
         seedFromConfig: mod.seedFromConfig,
@@ -2090,7 +2255,7 @@ var SERVICE_REGISTRY = {
     label: "Google OAuth 2.0 / OpenID Connect + Gmail, Calendar, and Drive emulator",
     endpoints: "OAuth authorize, token exchange, userinfo, RS256 OIDC discovery and JWKS, token revocation, Gmail messages/drafts/threads/labels/history/settings, Calendar discovery/lists/events/freebusy, Drive files/uploads",
     async load() {
-      const mod = await import("./dist-575EVZLI.js");
+      const mod = await import("./dist-IJ7LRDHX.js");
       return { plugin: mod.googlePlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback(cfg) {
@@ -2172,7 +2337,7 @@ var SERVICE_REGISTRY = {
     label: "Slack API emulator",
     endpoints: "auth, chat, conversations, users, profiles, presence, files, pins, bookmarks, views, reactions, team, OAuth, incoming webhooks, inspector",
     async load() {
-      const mod = await import("./dist-IMIDQ6CJ.js");
+      const mod = await import("./dist-UKXOY2NR.js");
       return { plugin: mod.slackPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback() {
@@ -2253,7 +2418,7 @@ var SERVICE_REGISTRY = {
     label: "Apple Sign In / OAuth emulator",
     endpoints: "OAuth authorize, token exchange, JWKS",
     async load() {
-      const mod = await import("./dist-L3SNHIRB.js");
+      const mod = await import("./dist-6TPEFTAK.js");
       return { plugin: mod.applePlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback(cfg) {
@@ -2278,7 +2443,7 @@ var SERVICE_REGISTRY = {
     label: "Microsoft Entra ID OAuth 2.0 / OpenID Connect emulator",
     endpoints: "OAuth authorize, token exchange, userinfo, OIDC discovery, Graph /me, logout, token revocation",
     async load() {
-      const mod = await import("./dist-ZGCIWJJM.js");
+      const mod = await import("./dist-TOCHFEDO.js");
       return { plugin: mod.microsoftPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback(cfg) {
@@ -2303,7 +2468,7 @@ var SERVICE_REGISTRY = {
     label: "Okta OAuth 2.0 / OpenID Connect + management API emulator",
     endpoints: "OIDC discovery, JWKS, OAuth authorize/token/userinfo/introspect/revoke/logout, users, groups, apps, authorization servers",
     async load() {
-      const mod = await import("./dist-EUMN2OAH.js");
+      const mod = await import("./dist-DVBHDPLP.js");
       return { plugin: mod.oktaPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback(cfg) {
@@ -2331,7 +2496,7 @@ var SERVICE_REGISTRY = {
     label: "AWS cloud service emulator",
     endpoints: "S3 (buckets, objects), SQS (queues, messages), Cognito (User Pools, OAuth, JWTs, Identity Pools), IAM (users, roles, access keys), STS (assume role, caller identity)",
     async load() {
-      const mod = await import("./dist-22OZW7MU.js");
+      const mod = await import("./dist-AZA2TRAN.js");
       return { plugin: mod.awsPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback() {
@@ -2353,7 +2518,7 @@ var SERVICE_REGISTRY = {
     label: "Resend email API emulator",
     endpoints: "emails with idempotency, recipient restrictions, send attempts, domains, contacts, API keys, inbox UI",
     async load() {
-      const mod = await import("./dist-B4K5JXTS.js");
+      const mod = await import("./dist-UFXXFP3R.js");
       return { plugin: mod.resendPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback() {
@@ -2370,7 +2535,7 @@ var SERVICE_REGISTRY = {
     label: "Stripe payments emulator",
     endpoints: "customers, payment methods, customer sessions, payment intents, charges, products, prices, checkout sessions, webhooks",
     async load() {
-      const mod = await import("./dist-KRJZAPPL.js");
+      const mod = await import("./dist-DWUKLYZG.js");
       return { plugin: mod.stripePlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback() {
@@ -2407,7 +2572,7 @@ var SERVICE_REGISTRY = {
     label: "Clerk authentication and user management emulator",
     endpoints: "OIDC discovery, JWKS, OAuth authorize/token/userinfo, users, email addresses, organizations, memberships, invitations, sessions",
     async load() {
-      const mod = await import("./dist-YMRASK5I.js");
+      const mod = await import("./dist-QUEHZ2IC.js");
       return { plugin: mod.clerkPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback(cfg) {
@@ -2446,7 +2611,7 @@ var SERVICE_REGISTRY = {
     label: "Linear GraphQL API emulator",
     endpoints: "GraphQL, OAuth, issues, teams, users, workflow states, comments, labels, projects, cycles, webhooks, agents, inspector",
     async load() {
-      const mod = await import("./dist-ATXASBBA.js");
+      const mod = await import("./dist-6OM56NLC.js");
       return { plugin: mod.linearPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback(cfg) {
@@ -2511,7 +2676,7 @@ var SERVICE_REGISTRY = {
     label: "Twilio API emulator",
     endpoints: "accounts, API keys, phone numbers, Programmable Messaging, Messaging Services, Verify, Voice, webhooks, simulator, inspector",
     async load() {
-      const mod = await import("./dist-KAYD3L2O.js");
+      const mod = await import("./dist-KQGIGONJ.js");
       return { plugin: mod.twilioPlugin, seedFromConfig: mod.seedFromConfig };
     },
     defaultFallback(cfg) {