cognovís health

Removed before @chp/sdk 1.0.0. The Integration Layer owns no FHIR construction. Every FHIR type, profile, canonical, terminology constant and client capability comes from @cognovis/fhir-sdk; @cognovis/fhir-release is internal to it. The /emission, /deidentification, /fhir-practitioner, /projections, /patient-context, /patient-summary, /agent-context, /punktwert and /eau subpaths no longer exist; the published surface is ., /adapters, /sync, /documents, /scanner and /llm. Sections badged historical below still document a removed subpath: read them as a record of what existed, never as imports to copy.

sdk

@chp/sdk documentation.

@chp/sdk is the Practice Workspace-facing facade for the capabilities the Integration Layer still owns. Its published subpaths are ., /adapters, /sync, /documents, /scanner and /llm. Ordinary FHIR access uses @cognovis/fhir-sdk/client, which owns the generated @cognovis/fhir-release artifacts internally — applications do not import them. Prospective FHIR billing uses @cognovis/fhir-billing-sdk; the Practice Workspace owns its conditional writer gate.

Sections

SDK capabilities and boundaries.

The FHIR retirement guide explains the intentional breaking cut and canonical client boundary. The LLM Gateway section covers capability-based model routing via @chp/sdk/llm.

getting started

current

Install @chp/sdk and configure the registry.

Registry setup for npm.cognovis.de and scope mapping for @chp. The FHIR client and resource-builder walkthroughs are retired; the page records what replaced them.

Open →

resource builders

historical

Seven core resource builders with working examples.

Historical. Documents the @chp/sdk/emission builders for Patient, Practitioner, PractitionerRole, Organization, Encounter, Condition and Claim. That subpath was removed before @chp/sdk 1.0.0 and the imports on this page no longer resolve.

Open →

api examples

current

Copyable API examples for Practice Workspace workflows.

Retired. The Practice Workspace workflow examples built on removed SDK subpaths; the page now points at the canonical client contract instead.

Open →

extensions

historical

German extensions: BSNR, LANR, versichertenArt, GKV/PKV.

Historical. Documents IG-only constants as exports of @chp/sdk/emission. @chp/sdk 1.0.0 exports no terminology constants; they belong to @cognovis/fhir-sdk.

Open →

version policy

historical

Canonical base URL, version pinning, and changelog format.

Historical. The pinning rule (exact versions in 0.x) still holds, but the page states it for the removed @chp/sdk/emission surface rather than for @cognovis/fhir-sdk.

Open →

integration

current

Standalone Aidbox vs Integration Layer platform usage.

Retired. The two-mode walkthrough was written around createFhirDeClient, which @chp/sdk does not re-export; the page now points at the canonical client contract.

Open →

troubleshooting

historical

Common validation errors and fixes.

Historical. Diagnoses errors of the removed emission and FHIR-client surfaces, including an anonymization salt variable that no @chp/sdk code path reads.

Open →

fhir client api

current

FHIR facade retirement and canonical client.

The general SDK FHIR facade is retired. Use the canonical client; named Integration Layer helper capabilities retain their own contracts.

Open →

Package names

The recommended package is @chp/sdk. The registry is npm.cognovis.de — not the public npm registry. There is no low-level @chp/sdk/emission subpath; it was removed before @chp/sdk 1.0.0. FHIR construction belongs to @cognovis/fhir-sdk.

No server deps in /llm

@chp/sdk/llm excludes Hono and server-runtime symbols. js-yaml and zod are bundled inline — no separate node_modules entries are needed; consumers get them at zero extra install cost. Server-only symbols (createApp, loadCatalogFromFile) are intentionally excluded.

IG-only policy

No extension URLs are hardcoded in application code. Constants are imported from @cognovis/fhir-sdk, which sources them from the canonical IGs at fhir.cognovis.de/praxis/. @chp/sdk re-exports none of them.