gdc-common-utils-ts 1.20.2 → 1.23.0

package/dist/examples/shared.d.ts

@@ -18,6 +18,7 @@ export declare const EXAMPLE_ROUTE_VERSION: "v1";
 export declare const EXAMPLE_SECTOR: "health-care";
 export declare const EXAMPLE_EMAIL_CONTROLLER_ORG: "controller@acme.org";
 export declare const EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL: "ana.parent@example.org";
+export declare const EXAMPLE_INTEROPERABLE_CONTEXT_FHIR_API: "org.hl7.fhir.api";
 export declare const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_ALTERNATE_NAME: "Jane";
 export declare const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_EMAIL: "Jane.Doe@example.com";
 export declare const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_EMAIL_NORMALIZED: "jane.doe@example.com";
@@ -95,6 +96,10 @@ export declare const EXAMPLE_CONTROLLER_SAME_AS: "mailto:controller@acme.org";
 export declare const EXAMPLE_API_ORGANIZATION_DID: "did:web:api.acme.org";
 export declare const EXAMPLE_SERVICE_PUBLIC_DID: "did:web:public.acme.org";
 export declare const EXAMPLE_SUBJECT_DID: "did:web:api.acme.org:individual:123";
+export declare const EXAMPLE_SUBJECT_DID_SECONDARY: "did:web:api.acme.org:individual:456";
+export declare const EXAMPLE_SUBJECT_DID_TERTIARY: "did:web:api.acme.org:individual:789";
+export declare const EXAMPLE_SUBJECT_DID_CONDITION: "did:web:api.acme.org:individual:cond";
+export declare const EXAMPLE_SUBJECT_DID_IPS: "did:web:api.acme.org:individual:ips";
 export declare const EXAMPLE_PROFESSIONAL_DID: "did:web:api.acme.org:professional:1";
 export declare const EXAMPLE_PROVIDER_ORGANIZATION_DID: "did:web:hospital.acme.org";
 export declare const EXAMPLE_PROVIDER_ORGANIZATION_URL: "https://hospital.acme.org";
@@ -126,6 +131,11 @@ export declare const EXAMPLE_PRACTITIONER_DID: "did:web:practitioner.example";
 export declare const EXAMPLE_GENERIC_SUBJECT_DID: "did:web:subject.example";
 export declare const EXAMPLE_EMAIL_PROFESSIONAL: "doctor.oncall@example.org";
 export declare const EXAMPLE_EMAIL_RELATED_PERSON: "parent.guardian@example.org";
+export declare const EXAMPLE_RELATED_PERSON_ACTIVE_NAME: "Jose Example";
+export declare const EXAMPLE_RELATED_PERSON_INACTIVE_IDENTIFIER: "urn:uuid:related-person-002";
+export declare const EXAMPLE_RELATED_PERSON_INACTIVE_EMAIL: "caregiver.two@example.org";
+export declare const EXAMPLE_RELATED_PERSON_INACTIVE_NAME: "Maria Example";
+export declare const EXAMPLE_RELATED_PERSON_INACTIVE_RELATIONSHIP: "http://terminology.hl7.org/CodeSystem/v3-RoleCode|NMTH";
 export declare const EXAMPLE_HEALTHCARE_JURISDICTION: "ES";
 export declare const EXAMPLE_SECONDARY_HEALTHCARE_JURISDICTION: "PT";
 export declare const EXAMPLE_ORGANIZATION_CONTROLLER_ROLE: "RESPRSN";
@@ -147,12 +157,18 @@ export declare const EXAMPLE_CONSENT_PURPOSE_TREATMENT: "TREAT";
 export declare const EXAMPLE_CONSENT_PURPOSE_EMERGENCY_TREATMENT: "ETREAT";
 export declare const EXAMPLE_CONSENT_UUID: "urn:uuid:consent-example-001";
 export declare const EXAMPLE_CONSENT_IDENTIFIER: "urn:uuid:consent-example-001";
+export declare const EXAMPLE_CONSENT_IDENTIFIER_SECONDARY: "urn:uuid:consent-example-002";
 export declare const EXAMPLE_CONSENT_OPERATION_IDENTIFIER: "consent-operation-example-001";
 export declare const EXAMPLE_CONSENT_OPERATION_THREAD_ID: "thread-consent-example-001";
 export declare const EXAMPLE_CONSENT_PERIOD_START: "2026-05-20T00:00:00Z";
 export declare const EXAMPLE_COMMUNICATION_UUID: "urn:uuid:communication-example-001";
 export declare const EXAMPLE_COMMUNICATION_IDENTIFIER: "urn:uuid:communication-example-001";
 export declare const EXAMPLE_IPS_BUNDLE_NOTE_TEXT: "IPS ingestion request";
+export declare const EXAMPLE_CONTENT_TYPE_APPLICATION_JSON: "application/json";
+export declare const EXAMPLE_CONTENT_TYPE_FHIR_JSON: "application/fhir+json";
+export declare const EXAMPLE_IPS_BUNDLE_ATTACHMENT_TITLE: "IPS Document Bundle";
+export declare const EXAMPLE_BUNDLE_RESOURCE_TYPE: "Bundle";
+export declare const EXAMPLE_BUNDLE_TYPE_BATCH: "batch";
 export declare const EXAMPLE_MEDICATION_STATEMENT_UUID: "urn:uuid:medication-statement-example-001";
 export declare const EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER: "urn:uuid:medication-statement-example-001";
 export declare const EXAMPLE_MEDICATION_STATEMENT_STATUS: "active";
@@ -164,6 +180,15 @@ export declare const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF: "application/p
 export declare const EXAMPLE_DOCUMENT_REFERENCE_URL: "https://example.org/prescription.pdf";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION: "Prescription PDF";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_DATE: "2026-06-12T10:00:00Z";
+export declare const EXAMPLE_CLINICAL_EVENT_DATE_TIME: "2026-06-01T10:00:00Z";
+export declare const EXAMPLE_VITAL_SIGNS_EFFECTIVE_DATE_TIME: "2026-06-11T08:30:00Z";
+export declare const EXAMPLE_VITAL_SIGNS_PANEL_DATE_TIME: "2026-06-11T09:00:00Z";
+export declare const EXAMPLE_VAULT_PRIMARY_DATE_TIME: "2026-06-11T10:00:00Z";
+export declare const EXAMPLE_VAULT_SECONDARY_DATE_TIME: "2026-06-11T10:05:00Z";
+export declare const EXAMPLE_VAULT_IPS_DATE_TIME: "2026-06-11T11:00:00Z";
+export declare const EXAMPLE_VAULT_TERTIARY_DATE_TIME: "2026-06-11T12:00:00Z";
+export declare const EXAMPLE_VAULT_QUATERNARY_DATE_TIME: "2026-06-11T13:00:00Z";
+export declare const EXAMPLE_VAULT_CONDITION_DATE_TIME: "2026-06-11T14:00:00Z";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_HASH: "z-document-reference-example-hash";
 export declare const EXAMPLE_DOCUMENT_REFERENCE_LANGUAGE: "en";
 export declare const EXAMPLE_CONSENT_ATTACHMENT_CONTENT_TYPE: "application/pdf";
@@ -172,10 +197,87 @@ export declare const EXAMPLE_CONTENT_ADDRESSED_CONSENT_IDENTIFIER: "zQmYwAPJzv5C
 export declare const EXAMPLE_CONTENT_ADDRESSED_SOURCE_REFERENCE: "zQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWv";
 export declare const EXAMPLE_CONTENT_ADDRESSED_EVIDENCE_RECORD_IDENTIFIER: "zQmXh8Y3mJQ4d7MmX7o9nP5sQ2uT1vW6xY8zA3bC4dE5fG";
 export declare const EXAMPLE_EMPLOYEE_ACTIVATION_CODE: "ACT-001";
+export declare const EXAMPLE_LICENSE_OFFER_ID: "urn:offer:family-003";
+export declare const EXAMPLE_LICENSE_INVALID_OFFER_ID: "urn:offer:invalid-001";
+export declare const EXAMPLE_LICENSE_ACCEPTED_OFFER_ID: "urn:offer:family-003";
+export declare const EXAMPLE_LICENSE_AMOUNT: "9.99";
+export declare const EXAMPLE_LICENSE_CURRENCY: "EUR";
+export declare const EXAMPLE_LICENSE_PLAN_NAME: "Family starter";
+export declare const EXAMPLE_LICENSE_SKU: "FAM-START";
+export declare const EXAMPLE_LICENSE_PAYMENT_METHOD_INVOICE: "invoice";
+export declare const EXAMPLE_LICENSE_CHECKOUT_URL: "https://pay.example/offer-001";
+export declare const EXAMPLE_LICENSE_PAYMENT_URL: "https://pay.example/invoice-001";
+export declare const EXAMPLE_LICENSE_INVOICE_ID: "invoice-001";
+export declare const EXAMPLE_INVOICE_DATE: "2026-06-11T10:00:00Z";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_PRODUCT_CODE: "08412345678903";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_PRODUCT_NAME: "Sterile saline bottle 500 mL";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_CATEGORY: "medical-supplies";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_SUPPLIER_PRODUCT_CODE: "IMP-SAL-500";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_IDENTIFIER: "chargeitem-001";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_STATUS: "billable";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_PART_OF: "invoice-001";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_QUANTITY: "3|bottle";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_QUANTITY_NUMBER: "3";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_QUANTITY_UNIT: "bottle";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_CODE_TEXT: "Botella de suero salino est\u00E9ril 500 mL";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_ITEMS_PER_UNIT: "24";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_ITEMS_QUANTITY: "500|mL";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_ITEMS_QUANTITY_NUMBER: "500";
+export declare const EXAMPLE_INVOICE_CHARGEITEM_ITEMS_QUANTITY_UNIT: "mL";
+export declare const EXAMPLE_LICENSE_PLAN_DEFAULT: "default";
+export declare const EXAMPLE_LICENSE_RENEWAL_CYCLE_YEARLY: "12m";
+export declare const EXAMPLE_LICENSE_SUBJECT_ID_ACTIVE: "urn:uuid:employee-controller-active-001";
+export declare const EXAMPLE_LICENSE_SUBJECT_ID_AVAILABLE: "urn:uuid:subject-license-available-001";
+export declare const EXAMPLE_LICENSE_SEAT_UUID_ACTIVE: "8a8a5e1b-0d8e-4a7c-8c39-3b8034440001";
+export declare const EXAMPLE_LICENSE_SEAT_UUID_SECONDARY: "8a8a5e1b-0d8e-4a7c-8c39-3b8034440002";
+export declare const EXAMPLE_LICENSE_SEAT_UUID_AVAILABLE: "8a8a5e1b-0d8e-4a7c-8c39-3b8034440009";
+export declare const EXAMPLE_JOB_IDENTIFIER_LICENSE_SEARCH: "job-license-search-001";
+export declare const EXAMPLE_THREAD_IDENTIFIER_LICENSE_SEARCH: "thid-license-search-001";
+export declare const EXAMPLE_RELATED_PERSON_IDENTIFIER: "rel-001";
 export declare const EXAMPLE_DEVICE_CLIENT_ID: "did:web:device-001";
 export declare const EXAMPLE_LIVE_GW_BASE_URL_LOCAL: "http://127.0.0.1:3000";
 export declare const EXAMPLE_LIVE_GW_BASE_URL_DOCKER: "http://127.0.0.1:8000";
 export declare const EXAMPLE_MEDICATION_DOSE_UNIT_MG: "mg";
+export declare const EXAMPLE_OBSERVATION_IDENTIFIER: "urn:uuid:observation-example-001";
+export declare const EXAMPLE_OBSERVATION_IDENTIFIER_IPS: "vs-1";
+export declare const EXAMPLE_OBSERVATION_PANEL_IDENTIFIER: "urn:uuid:observation-panel-example-001";
+export declare const EXAMPLE_OBSERVATION_COMPONENT_IDENTIFIER: "urn:uuid:observation-component-example-001";
+export declare const EXAMPLE_OBSERVATION_COMPONENT_IDENTIFIER_SECONDARY: "urn:uuid:observation-component-example-002";
+export declare const EXAMPLE_IPS_COMPOSITION_IDENTIFIER: "ips-composition";
+export declare const EXAMPLE_CONDITION_IDENTIFIER: "condition-example-001";
+export declare const EXAMPLE_VITAL_SIGNS_NOTE: "Measured after rest.";
+export declare const EXAMPLE_FHIR_STATUS_FINAL: "final";
+export declare const EXAMPLE_FHIR_STATUS_ACTIVE: "active";
+export declare const EXAMPLE_FHIR_VERIFICATION_STATUS_CONFIRMED: "confirmed";
+export declare const EXAMPLE_VITAL_SIGN_VALUE_HEART_RATE: 68;
+export declare const EXAMPLE_VITAL_SIGN_VALUE_SYSTOLIC: 120;
+export declare const EXAMPLE_VITAL_SIGN_VALUE_DIASTOLIC: 78;
+export declare const EXAMPLE_VITAL_SIGN_VALUE_BODY_TEMPERATURE: 37.1;
+export declare const EXAMPLE_VITAL_SIGN_UNIT_BEATS_PER_MINUTE: "/min";
+export declare const EXAMPLE_OBSERVATION_CATEGORY_VITAL_SIGNS: "http://terminology.hl7.org/CodeSystem/observation-category|vital-signs";
+export declare const EXAMPLE_VITAL_SIGN_CODE_HEART_RATE: "8867-4";
+export declare const EXAMPLE_VITAL_SIGN_CODE_BODY_TEMPERATURE: "8310-5";
+export declare const EXAMPLE_VITAL_SIGN_CODE_BLOOD_PRESSURE_PANEL: "85354-9";
+export declare const EXAMPLE_VITAL_SIGN_CODE_SYSTOLIC_BLOOD_PRESSURE: "8480-6";
+export declare const EXAMPLE_VITAL_SIGN_CODE_DIASTOLIC_BLOOD_PRESSURE: "8462-4";
+export declare const EXAMPLE_VITAL_SIGN_DISPLAY_HEART_RATE: "Heart rate";
+export declare const EXAMPLE_VITAL_SIGN_DISPLAY_BODY_TEMPERATURE: "Body temperature";
+export declare const EXAMPLE_VITAL_SIGN_DISPLAY_VITAL_SIGNS: "Vital Signs";
+export declare const EXAMPLE_VITAL_SIGN_DISPLAY_BLOOD_PRESSURE_PANEL: "Blood pressure panel";
+/** Shared composite tag summary used by blood-pressure parent observation indexing examples. */
+export declare const EXAMPLE_OBSERVATION_COMPONENT_TAGS_BLOOD_PRESSURE: "bp-systolic,bp-diastolic";
+/** Shared component code summary used by blood-pressure parent observation indexing examples. */
+export declare const EXAMPLE_OBSERVATION_COMPONENT_CODE_VALUES_BLOOD_PRESSURE: "8480-6,8462-4";
+/** Shared human-readable component-name summary used by blood-pressure parent observation indexing examples. */
+export declare const EXAMPLE_OBSERVATION_COMPONENT_NAMES_BLOOD_PRESSURE: "Systolic blood pressure,Diastolic blood pressure";
+export declare const EXAMPLE_SOCIAL_HISTORY_CATEGORY: "http://terminology.hl7.org/CodeSystem/observation-category|social-history";
+export declare const EXAMPLE_OBSERVATION_CODE_TOBACCO_SMOKING_STATUS: "72166-2";
+export declare const EXAMPLE_OBSERVATION_DISPLAY_TOBACCO_SMOKING_STATUS: "Tobacco smoking status";
+export declare const EXAMPLE_OBSERVATION_VALUE_CONCEPT_NEVER_SMOKER_CODE: "266919005";
+export declare const EXAMPLE_OBSERVATION_VALUE_CONCEPT_NEVER_SMOKER_DISPLAY: "Never smoker";
+export declare const EXAMPLE_OBSERVATION_VALUE_CONCEPT_NEVER_SMOKER: "http://snomed.info/sct|266919005";
+export declare const EXAMPLE_CONDITION_CODE: "http://snomed.info/sct|44054006";
+export declare const EXAMPLE_MEDICATION_CODE_RXNORM: "http://www.nlm.nih.gov/research/umls/rxnorm|860975";
 export declare const EXAMPLE_MEDICATION_TIMING_PERIOD_UNIT_HOURS: "h";
 export declare const EXAMPLE_MEDICATION_IBUPROFEN_TEXT: "Ibuprofen 400 mg";
 export declare const EXAMPLE_MEDICATION_IBUPROFEN_IDENTIFIER_PREFIX: "urn:uuid:med-ibuprofen";
@@ -289,35 +391,35 @@ export declare function buildExampleCommunicationIngestionPayload({ subjectDid,
         data: {
             type: string;
             resource: {
-                resourceType: string;
+                resourceType: "Communication";
                 status: string;
                 subject: {
                     reference: string;
                 };
                 category: {
                     coding: {
-                        system: string;
+                        system: "http://terminology.hl7.org/CodeSystem/communication-category";
                         code: string;
                     }[];
                 }[];
                 payload: {
                     contentAttachment: {
-                        contentType: string;
-                        title: string;
+                        contentType: "application/fhir+json";
+                        title: "IPS Document Bundle";
                         data: string;
                     };
                 }[];
                 note: {
-                    text: string;
+                    text: "IPS ingestion request";
                 }[];
                 meta: {
                     claims: {
-                        '@context': string;
+                        '@context': "org.hl7.fhir.r4";
                         "Communication.category": string;
                         "Communication.subject": "did:web:api.acme.org:individual:123";
                         "Communication.sent": string;
-                        "Communication.content-attachment-type": string;
-                        "Communication.text": string;
+                        "Communication.content-attachment-type": "application/fhir+json";
+                        "Communication.text": "IPS ingestion request";
                     };
                 };
             };

package/dist/examples/shared.js

@@ -2,9 +2,14 @@
 // Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
 import { DataspaceSectors } from '../constants/sectors.js';
 import { HostNetworkTypes } from '../constants/network.js';
+import { FhirCodeSystems } from '../constants/fhir-code-systems.js';
+import { Format } from '../constants/Schemas.js';
+import { ResourceTypesFhirR4 } from '../constants/fhir-resource-types.js';
 import { BirthSex, GenderIdentity } from '../constants/identity-gender.js';
 import { IdKind } from '../constants/identity-identifiers.js';
-import { HealthcareActorRoles, HealthcareBasicSections, HealthcareConsentPurposes, } from '../constants/healthcare.js';
+import { HealthcareActorRoles, HealthcareBasicSections, HealthcareConsentPurposes, HealthcareDocumentTypes, } from '../constants/healthcare.js';
+import { CommunicationCategoryCodes } from '../constants/communication.js';
+import { LOINC_SYSTEM_URL } from '../models/clinical-sections.js';
 import { CommunicationClaim } from '../models/interoperable-claims/communication-claims.js';
 import { MedicationStatementClaim, MedicationStatementClaimsFhirApiExtended, } from '../models/interoperable-claims/medication-statement-claims.js';
 import { medicationStatementFlatToFhirR4 } from '../utils/clinical-resource-converters.js';
@@ -26,6 +31,7 @@ export const EXAMPLE_ROUTE_VERSION = 'v1';
 export const EXAMPLE_SECTOR = DataspaceSectors.HealthCare;
 export const EXAMPLE_EMAIL_CONTROLLER_ORG = 'controller@acme.org';
 export const EXAMPLE_EMAIL_CONTROLLER_INDIVIDUAL = 'ana.parent@example.org';
+export const EXAMPLE_INTEROPERABLE_CONTEXT_FHIR_API = Format.FHIR_API;
 export const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_ALTERNATE_NAME = 'Jane';
 export const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_EMAIL = 'Jane.Doe@example.com';
 export const EXAMPLE_SELF_REGISTERED_INDIVIDUAL_EMAIL_NORMALIZED = 'jane.doe@example.com';
@@ -103,6 +109,10 @@ export const EXAMPLE_CONTROLLER_SAME_AS = `mailto:${EXAMPLE_CONTROLLER_EMAIL}`;
 export const EXAMPLE_API_ORGANIZATION_DID = 'did:web:api.acme.org';
 export const EXAMPLE_SERVICE_PUBLIC_DID = 'did:web:public.acme.org';
 export const EXAMPLE_SUBJECT_DID = 'did:web:api.acme.org:individual:123';
+export const EXAMPLE_SUBJECT_DID_SECONDARY = 'did:web:api.acme.org:individual:456';
+export const EXAMPLE_SUBJECT_DID_TERTIARY = 'did:web:api.acme.org:individual:789';
+export const EXAMPLE_SUBJECT_DID_CONDITION = 'did:web:api.acme.org:individual:cond';
+export const EXAMPLE_SUBJECT_DID_IPS = 'did:web:api.acme.org:individual:ips';
 export const EXAMPLE_PROFESSIONAL_DID = 'did:web:api.acme.org:professional:1';
 export const EXAMPLE_PROVIDER_ORGANIZATION_DID = 'did:web:hospital.acme.org';
 export const EXAMPLE_PROVIDER_ORGANIZATION_URL = 'https://hospital.acme.org';
@@ -134,6 +144,11 @@ export const EXAMPLE_PRACTITIONER_DID = 'did:web:practitioner.example';
 export const EXAMPLE_GENERIC_SUBJECT_DID = 'did:web:subject.example';
 export const EXAMPLE_EMAIL_PROFESSIONAL = 'doctor.oncall@example.org';
 export const EXAMPLE_EMAIL_RELATED_PERSON = 'parent.guardian@example.org';
+export const EXAMPLE_RELATED_PERSON_ACTIVE_NAME = 'Jose Example';
+export const EXAMPLE_RELATED_PERSON_INACTIVE_IDENTIFIER = 'urn:uuid:related-person-002';
+export const EXAMPLE_RELATED_PERSON_INACTIVE_EMAIL = 'caregiver.two@example.org';
+export const EXAMPLE_RELATED_PERSON_INACTIVE_NAME = 'Maria Example';
+export const EXAMPLE_RELATED_PERSON_INACTIVE_RELATIONSHIP = 'http://terminology.hl7.org/CodeSystem/v3-RoleCode|NMTH';
 export const EXAMPLE_HEALTHCARE_JURISDICTION = 'ES';
 export const EXAMPLE_SECONDARY_HEALTHCARE_JURISDICTION = EXAMPLE_SECONDARY_EU_COUNTRY;
 export const EXAMPLE_ORGANIZATION_CONTROLLER_ROLE = 'RESPRSN';
@@ -155,12 +170,18 @@ export const EXAMPLE_CONSENT_PURPOSE_TREATMENT = HealthcareConsentPurposes.Treat
 export const EXAMPLE_CONSENT_PURPOSE_EMERGENCY_TREATMENT = HealthcareConsentPurposes.EmergencyTreatment;
 export const EXAMPLE_CONSENT_UUID = 'urn:uuid:consent-example-001';
 export const EXAMPLE_CONSENT_IDENTIFIER = EXAMPLE_CONSENT_UUID;
+export const EXAMPLE_CONSENT_IDENTIFIER_SECONDARY = 'urn:uuid:consent-example-002';
 export const EXAMPLE_CONSENT_OPERATION_IDENTIFIER = 'consent-operation-example-001';
 export const EXAMPLE_CONSENT_OPERATION_THREAD_ID = 'thread-consent-example-001';
 export const EXAMPLE_CONSENT_PERIOD_START = '2026-05-20T00:00:00Z';
 export const EXAMPLE_COMMUNICATION_UUID = 'urn:uuid:communication-example-001';
 export const EXAMPLE_COMMUNICATION_IDENTIFIER = EXAMPLE_COMMUNICATION_UUID;
 export const EXAMPLE_IPS_BUNDLE_NOTE_TEXT = 'IPS ingestion request';
+export const EXAMPLE_CONTENT_TYPE_APPLICATION_JSON = 'application/json';
+export const EXAMPLE_CONTENT_TYPE_FHIR_JSON = 'application/fhir+json';
+export const EXAMPLE_IPS_BUNDLE_ATTACHMENT_TITLE = 'IPS Document Bundle';
+export const EXAMPLE_BUNDLE_RESOURCE_TYPE = 'Bundle';
+export const EXAMPLE_BUNDLE_TYPE_BATCH = 'batch';
 export const EXAMPLE_MEDICATION_STATEMENT_UUID = 'urn:uuid:medication-statement-example-001';
 export const EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER = EXAMPLE_MEDICATION_STATEMENT_UUID;
 export const EXAMPLE_MEDICATION_STATEMENT_STATUS = 'active';
@@ -172,6 +193,15 @@ export const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF = 'application/pdf';
 export const EXAMPLE_DOCUMENT_REFERENCE_URL = 'https://example.org/prescription.pdf';
 export const EXAMPLE_DOCUMENT_REFERENCE_DESCRIPTION = 'Prescription PDF';
 export const EXAMPLE_DOCUMENT_REFERENCE_DATE = '2026-06-12T10:00:00Z';
+export const EXAMPLE_CLINICAL_EVENT_DATE_TIME = '2026-06-01T10:00:00Z';
+export const EXAMPLE_VITAL_SIGNS_EFFECTIVE_DATE_TIME = '2026-06-11T08:30:00Z';
+export const EXAMPLE_VITAL_SIGNS_PANEL_DATE_TIME = '2026-06-11T09:00:00Z';
+export const EXAMPLE_VAULT_PRIMARY_DATE_TIME = '2026-06-11T10:00:00Z';
+export const EXAMPLE_VAULT_SECONDARY_DATE_TIME = '2026-06-11T10:05:00Z';
+export const EXAMPLE_VAULT_IPS_DATE_TIME = '2026-06-11T11:00:00Z';
+export const EXAMPLE_VAULT_TERTIARY_DATE_TIME = '2026-06-11T12:00:00Z';
+export const EXAMPLE_VAULT_QUATERNARY_DATE_TIME = '2026-06-11T13:00:00Z';
+export const EXAMPLE_VAULT_CONDITION_DATE_TIME = '2026-06-11T14:00:00Z';
 export const EXAMPLE_DOCUMENT_REFERENCE_CONTENT_HASH = 'z-document-reference-example-hash';
 export const EXAMPLE_DOCUMENT_REFERENCE_LANGUAGE = 'en';
 export const EXAMPLE_CONSENT_ATTACHMENT_CONTENT_TYPE = EXAMPLE_DOCUMENT_REFERENCE_CONTENT_TYPE_PDF;
@@ -180,10 +210,87 @@ export const EXAMPLE_CONTENT_ADDRESSED_CONSENT_IDENTIFIER = 'zQmYwAPJzv5CZsnAzt8
 export const EXAMPLE_CONTENT_ADDRESSED_SOURCE_REFERENCE = 'zQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWvM9dQmWv';
 export const EXAMPLE_CONTENT_ADDRESSED_EVIDENCE_RECORD_IDENTIFIER = 'zQmXh8Y3mJQ4d7MmX7o9nP5sQ2uT1vW6xY8zA3bC4dE5fG';
 export const EXAMPLE_EMPLOYEE_ACTIVATION_CODE = 'ACT-001';
+export const EXAMPLE_LICENSE_OFFER_ID = 'urn:offer:family-003';
+export const EXAMPLE_LICENSE_INVALID_OFFER_ID = 'urn:offer:invalid-001';
+export const EXAMPLE_LICENSE_ACCEPTED_OFFER_ID = EXAMPLE_LICENSE_OFFER_ID;
+export const EXAMPLE_LICENSE_AMOUNT = '9.99';
+export const EXAMPLE_LICENSE_CURRENCY = 'EUR';
+export const EXAMPLE_LICENSE_PLAN_NAME = 'Family starter';
+export const EXAMPLE_LICENSE_SKU = 'FAM-START';
+export const EXAMPLE_LICENSE_PAYMENT_METHOD_INVOICE = 'invoice';
+export const EXAMPLE_LICENSE_CHECKOUT_URL = 'https://pay.example/offer-001';
+export const EXAMPLE_LICENSE_PAYMENT_URL = 'https://pay.example/invoice-001';
+export const EXAMPLE_LICENSE_INVOICE_ID = 'invoice-001';
+export const EXAMPLE_INVOICE_DATE = '2026-06-11T10:00:00Z';
+export const EXAMPLE_INVOICE_CHARGEITEM_PRODUCT_CODE = '08412345678903';
+export const EXAMPLE_INVOICE_CHARGEITEM_PRODUCT_NAME = 'Sterile saline bottle 500 mL';
+export const EXAMPLE_INVOICE_CHARGEITEM_CATEGORY = 'medical-supplies';
+export const EXAMPLE_INVOICE_CHARGEITEM_SUPPLIER_PRODUCT_CODE = 'IMP-SAL-500';
+export const EXAMPLE_INVOICE_CHARGEITEM_IDENTIFIER = 'chargeitem-001';
+export const EXAMPLE_INVOICE_CHARGEITEM_STATUS = 'billable';
+export const EXAMPLE_INVOICE_CHARGEITEM_PART_OF = EXAMPLE_LICENSE_INVOICE_ID;
+export const EXAMPLE_INVOICE_CHARGEITEM_QUANTITY = '3|bottle';
+export const EXAMPLE_INVOICE_CHARGEITEM_QUANTITY_NUMBER = '3';
+export const EXAMPLE_INVOICE_CHARGEITEM_QUANTITY_UNIT = 'bottle';
+export const EXAMPLE_INVOICE_CHARGEITEM_CODE_TEXT = 'Botella de suero salino estéril 500 mL';
+export const EXAMPLE_INVOICE_CHARGEITEM_ITEMS_PER_UNIT = '24';
+export const EXAMPLE_INVOICE_CHARGEITEM_ITEMS_QUANTITY = '500|mL';
+export const EXAMPLE_INVOICE_CHARGEITEM_ITEMS_QUANTITY_NUMBER = '500';
+export const EXAMPLE_INVOICE_CHARGEITEM_ITEMS_QUANTITY_UNIT = 'mL';
+export const EXAMPLE_LICENSE_PLAN_DEFAULT = 'default';
+export const EXAMPLE_LICENSE_RENEWAL_CYCLE_YEARLY = '12m';
+export const EXAMPLE_LICENSE_SUBJECT_ID_ACTIVE = 'urn:uuid:employee-controller-active-001';
+export const EXAMPLE_LICENSE_SUBJECT_ID_AVAILABLE = 'urn:uuid:subject-license-available-001';
+export const EXAMPLE_LICENSE_SEAT_UUID_ACTIVE = '8a8a5e1b-0d8e-4a7c-8c39-3b8034440001';
+export const EXAMPLE_LICENSE_SEAT_UUID_SECONDARY = '8a8a5e1b-0d8e-4a7c-8c39-3b8034440002';
+export const EXAMPLE_LICENSE_SEAT_UUID_AVAILABLE = '8a8a5e1b-0d8e-4a7c-8c39-3b8034440009';
+export const EXAMPLE_JOB_IDENTIFIER_LICENSE_SEARCH = 'job-license-search-001';
+export const EXAMPLE_THREAD_IDENTIFIER_LICENSE_SEARCH = 'thid-license-search-001';
+export const EXAMPLE_RELATED_PERSON_IDENTIFIER = 'rel-001';
 export const EXAMPLE_DEVICE_CLIENT_ID = 'did:web:device-001';
 export const EXAMPLE_LIVE_GW_BASE_URL_LOCAL = 'http://127.0.0.1:3000';
 export const EXAMPLE_LIVE_GW_BASE_URL_DOCKER = 'http://127.0.0.1:8000';
 export const EXAMPLE_MEDICATION_DOSE_UNIT_MG = 'mg';
+export const EXAMPLE_OBSERVATION_IDENTIFIER = 'urn:uuid:observation-example-001';
+export const EXAMPLE_OBSERVATION_IDENTIFIER_IPS = 'vs-1';
+export const EXAMPLE_OBSERVATION_PANEL_IDENTIFIER = 'urn:uuid:observation-panel-example-001';
+export const EXAMPLE_OBSERVATION_COMPONENT_IDENTIFIER = 'urn:uuid:observation-component-example-001';
+export const EXAMPLE_OBSERVATION_COMPONENT_IDENTIFIER_SECONDARY = 'urn:uuid:observation-component-example-002';
+export const EXAMPLE_IPS_COMPOSITION_IDENTIFIER = 'ips-composition';
+export const EXAMPLE_CONDITION_IDENTIFIER = 'condition-example-001';
+export const EXAMPLE_VITAL_SIGNS_NOTE = 'Measured after rest.';
+export const EXAMPLE_FHIR_STATUS_FINAL = 'final';
+export const EXAMPLE_FHIR_STATUS_ACTIVE = 'active';
+export const EXAMPLE_FHIR_VERIFICATION_STATUS_CONFIRMED = 'confirmed';
+export const EXAMPLE_VITAL_SIGN_VALUE_HEART_RATE = 68;
+export const EXAMPLE_VITAL_SIGN_VALUE_SYSTOLIC = 120;
+export const EXAMPLE_VITAL_SIGN_VALUE_DIASTOLIC = 78;
+export const EXAMPLE_VITAL_SIGN_VALUE_BODY_TEMPERATURE = 37.1;
+export const EXAMPLE_VITAL_SIGN_UNIT_BEATS_PER_MINUTE = '/min';
+export const EXAMPLE_OBSERVATION_CATEGORY_VITAL_SIGNS = 'http://terminology.hl7.org/CodeSystem/observation-category|vital-signs';
+export const EXAMPLE_VITAL_SIGN_CODE_HEART_RATE = '8867-4';
+export const EXAMPLE_VITAL_SIGN_CODE_BODY_TEMPERATURE = '8310-5';
+export const EXAMPLE_VITAL_SIGN_CODE_BLOOD_PRESSURE_PANEL = '85354-9';
+export const EXAMPLE_VITAL_SIGN_CODE_SYSTOLIC_BLOOD_PRESSURE = '8480-6';
+export const EXAMPLE_VITAL_SIGN_CODE_DIASTOLIC_BLOOD_PRESSURE = '8462-4';
+export const EXAMPLE_VITAL_SIGN_DISPLAY_HEART_RATE = 'Heart rate';
+export const EXAMPLE_VITAL_SIGN_DISPLAY_BODY_TEMPERATURE = 'Body temperature';
+export const EXAMPLE_VITAL_SIGN_DISPLAY_VITAL_SIGNS = 'Vital Signs';
+export const EXAMPLE_VITAL_SIGN_DISPLAY_BLOOD_PRESSURE_PANEL = 'Blood pressure panel';
+/** Shared composite tag summary used by blood-pressure parent observation indexing examples. */
+export const EXAMPLE_OBSERVATION_COMPONENT_TAGS_BLOOD_PRESSURE = 'bp-systolic,bp-diastolic';
+/** Shared component code summary used by blood-pressure parent observation indexing examples. */
+export const EXAMPLE_OBSERVATION_COMPONENT_CODE_VALUES_BLOOD_PRESSURE = `${EXAMPLE_VITAL_SIGN_CODE_SYSTOLIC_BLOOD_PRESSURE},${EXAMPLE_VITAL_SIGN_CODE_DIASTOLIC_BLOOD_PRESSURE}`;
+/** Shared human-readable component-name summary used by blood-pressure parent observation indexing examples. */
+export const EXAMPLE_OBSERVATION_COMPONENT_NAMES_BLOOD_PRESSURE = 'Systolic blood pressure,Diastolic blood pressure';
+export const EXAMPLE_SOCIAL_HISTORY_CATEGORY = 'http://terminology.hl7.org/CodeSystem/observation-category|social-history';
+export const EXAMPLE_OBSERVATION_CODE_TOBACCO_SMOKING_STATUS = '72166-2';
+export const EXAMPLE_OBSERVATION_DISPLAY_TOBACCO_SMOKING_STATUS = 'Tobacco smoking status';
+export const EXAMPLE_OBSERVATION_VALUE_CONCEPT_NEVER_SMOKER_CODE = '266919005';
+export const EXAMPLE_OBSERVATION_VALUE_CONCEPT_NEVER_SMOKER_DISPLAY = 'Never smoker';
+export const EXAMPLE_OBSERVATION_VALUE_CONCEPT_NEVER_SMOKER = `${FhirCodeSystems.SnomedCt}|${EXAMPLE_OBSERVATION_VALUE_CONCEPT_NEVER_SMOKER_CODE}`;
+export const EXAMPLE_CONDITION_CODE = 'http://snomed.info/sct|44054006';
+export const EXAMPLE_MEDICATION_CODE_RXNORM = 'http://www.nlm.nih.gov/research/umls/rxnorm|860975';
 export const EXAMPLE_MEDICATION_TIMING_PERIOD_UNIT_HOURS = 'h';
 export const EXAMPLE_MEDICATION_IBUPROFEN_TEXT = 'Ibuprofen 400 mg';
 export const EXAMPLE_MEDICATION_IBUPROFEN_IDENTIFIER_PREFIX = 'urn:uuid:med-ibuprofen';
@@ -236,33 +343,33 @@ export function buildExampleCommunicationIngestionPayload({ subjectDid = EXAMPLE
                 {
                     type: 'Communication-ingestion-request-v1.0',
                     resource: {
-                        resourceType: 'Communication',
+                        resourceType: ResourceTypesFhirR4.Communication,
                         status: 'completed',
                         subject: { reference: `Patient/${subjectDid}` },
                         category: [{
                                 coding: [{
-                                        system: 'http://terminology.hl7.org/CodeSystem/communication-category',
-                                        code: 'notification',
+                                        system: CommunicationCategoryCodes.Notification.system,
+                                        code: CommunicationCategoryCodes.Notification.code,
                                     }],
                             }],
                         payload: [
                             {
                                 contentAttachment: {
-                                    contentType: 'application/fhir+json',
-                                    title: 'IPS Document Bundle',
+                                    contentType: EXAMPLE_CONTENT_TYPE_FHIR_JSON,
+                                    title: EXAMPLE_IPS_BUNDLE_ATTACHMENT_TITLE,
                                     data: ipsBundleBase64,
                                 },
                             },
                         ],
-                        note: [{ text: 'IPS ingestion request' }],
+                        note: [{ text: EXAMPLE_IPS_BUNDLE_NOTE_TEXT }],
                         meta: {
                             claims: {
-                                '@context': 'org.hl7.fhir.r4',
-                                [CommunicationClaim.Category]: 'http://terminology.hl7.org/CodeSystem/communication-category|notification',
+                                '@context': Format.FHIR_R4,
+                                [CommunicationClaim.Category]: CommunicationCategoryCodes.Notification.claim,
                                 [CommunicationClaim.Subject]: subjectDid,
                                 [CommunicationClaim.Sent]: sent,
-                                [CommunicationClaim.ContentAttachmentType]: 'application/fhir+json',
-                                [CommunicationClaim.Text]: 'IPS ingestion request',
+                                [CommunicationClaim.ContentAttachmentType]: EXAMPLE_CONTENT_TYPE_FHIR_JSON,
+                                [CommunicationClaim.Text]: EXAMPLE_IPS_BUNDLE_NOTE_TEXT,
                             },
                         },
                     },
@@ -331,7 +438,7 @@ export function buildExampleLiveMedicationCases(seed = Date.now()) {
 export function buildExampleMedicationIpsDocumentBundle(input) {
     const subjectDid = input.subjectDid || EXAMPLE_SUBJECT_DID;
     const medicationClaims = {
-        '@context': 'org.hl7.fhir.api',
+        '@context': Format.FHIR_API,
         [MedicationStatementClaim.Identifier]: input.medication.identifier,
         [MedicationStatementClaim.Subject]: subjectDid,
         [MedicationStatementClaim.Status]: EXAMPLE_MEDICATION_STATEMENT_STATUS,
@@ -353,22 +460,27 @@ export function buildExampleMedicationIpsDocumentBundle(input) {
         claims: medicationClaims,
     };
     return {
-        resourceType: 'Bundle',
+        resourceType: ResourceTypesFhirR4.Bundle,
         type: 'document',
         entry: [
             {
                 resource: {
-                    resourceType: 'Composition',
+                    resourceType: ResourceTypesFhirR4.Composition,
                     id: `composition-${input.medication.identifier}`,
                     status: 'final',
                     subject: { reference: subjectDid },
-                    type: { coding: [{ system: 'http://loinc.org', code: '60591-5' }] },
+                    type: {
+                        coding: [{
+                                system: HealthcareDocumentTypes.IPS.system,
+                                code: HealthcareDocumentTypes.IPS.code,
+                            }],
+                    },
                     section: [
                         {
                             code: {
                                 coding: [{
-                                        system: 'http://loinc.org',
-                                        code: '10160-0',
+                                        system: LOINC_SYSTEM_URL,
+                                        code: HealthcareBasicSections.HistoryOfMedicationUse.code,
                                     }],
                             },
                             entry: [

package/dist/examples/vital-signs.d.ts

@@ -0,0 +1,56 @@
+import type { BundleEntry, BundleJsonApi } from '../models/bundle';
+import type { BuildVitalSignObservationClaimsInput } from '../utils/individual-bundle-vault';
+/**
+ * Shared example inputs for authoring vital-sign Observations in claims-first
+ * flows.
+ *
+ * Reference:
+ * - HL7 CIMI Vital Signs with Qualifying Elements IG
+ *   https://build.fhir.org/ig/HL7/cimi-vital-signs/
+ *
+ * These examples intentionally cover only direct vital-sign authoring inputs
+ * that a person or simple frontend form would create:
+ * - heart rate
+ * - body temperature
+ * - systolic blood pressure
+ * - diastolic blood pressure
+ *
+ * Panel/group authoring is excluded on purpose because panels are typically
+ * imported from external FHIR systems or composed by professional workflows.
+ */
+/** Example claims-first input for one heart rate Observation (LOINC 8867-4, UCUM /min). */
+export declare const EXAMPLE_VITAL_SIGN_HEART_RATE_INPUT: BuildVitalSignObservationClaimsInput;
+/** Example claims-first input for one body temperature Observation (LOINC 8310-5, UCUM Cel). */
+export declare const EXAMPLE_VITAL_SIGN_BODY_TEMPERATURE_INPUT: BuildVitalSignObservationClaimsInput;
+/** Example claims-first input for one systolic blood pressure Observation (LOINC 8480-6, UCUM mm[Hg]). */
+export declare const EXAMPLE_VITAL_SIGN_SYSTOLIC_BLOOD_PRESSURE_INPUT: BuildVitalSignObservationClaimsInput;
+/** Example claims-first input for one diastolic blood pressure Observation (LOINC 8462-4, UCUM mm[Hg]). */
+export declare const EXAMPLE_VITAL_SIGN_DIASTOLIC_BLOOD_PRESSURE_INPUT: BuildVitalSignObservationClaimsInput;
+/**
+ * Builds one high-level bundle entry for a vital-sign Observation.
+ *
+ * This is the preferred copy-paste pattern for frontend flows:
+ * 1. author flat claims with `buildVitalSignObservationClaims(...)`
+ * 2. convert them to one FHIR R4 `Observation`
+ * 3. keep the claims in `resource.meta.claims`
+ * 4. append the entry to a `Bundle.data` array
+ */
+export declare function buildVitalSignObservationEntry(input: BuildVitalSignObservationClaimsInput): BundleEntry;
+/**
+ * Builds a high-level bundle with one entry per directly authored vital sign.
+ *
+ * Included examples:
+ * - heart rate
+ * - body temperature
+ * - systolic blood pressure
+ * - diastolic blood pressure
+ *
+ * Panels are intentionally excluded because the app user normally authors
+ * simple observations, not professional/imported panel structures.
+ */
+export declare function buildExampleVitalSignsObservationBundle(): BundleJsonApi<BundleEntry>;
+/**
+ * Builds the same vital-sign bundle through `CommunicationAttachedBundleSession`
+ * for flows that already use the in-memory bundle editor/session abstraction.
+ */
+export declare function buildExampleVitalSignsObservationBundleSession(): BundleJsonApi<BundleEntry>;