gdc-common-utils-ts 1.14.2 → 1.14.4

package/README.md

@@ -94,6 +94,8 @@ import { JweObject, JwtCompactParts } from 'gdc-common-utils-ts/models';
     `internet-first` discovery seeding by `jurisdiction + version + networkType`
 - [docs/consent-access-matrix-task.md](docs/consent-access-matrix-task.md)
   - next-step design/task document for active consent aggregation, explicit deny precedence, controller views, permission-request communications, and SMART access evaluation
+- [docs/IPS_BUNDLE_101.md](docs/IPS_BUNDLE_101.md)
+  - quick guide for editing IPS-like bundle history in `Communication.content-attachment-data`, reading `resource.meta.claims`, and building frontend cards by section
 
 ## Dataspace Protocol And Discovery
 
@@ -111,6 +113,8 @@ Main entry points:
 - [`src/utils/dataspace-discovery-defaults.ts`](src/utils/dataspace-discovery-defaults.ts)
   - defaults registry for ICAs and hosting operators plus the backend
     `default-first` bootstrap plan used to unblock portal integration
+  - includes authority-based helpers so integrators can seed from a single
+    domain/IP instead of manually assembling `did:web` and discovery URLs
 - [`src/examples/dataspace-discovery.ts`](src/examples/dataspace-discovery.ts)
   - synthetic provider/operator examples that distinguish discovery URL from
     derived catalog artifact URL

package/dist/constants/healthcare.d.ts

@@ -3,6 +3,12 @@ import { type DataspaceSector } from './sectors';
 export type HealthcareSectionDescriptor = Readonly<{
     system: typeof LOINC_SYSTEM_URL;
     code: string;
+    attributeValue: string;
+    /**
+     * @deprecated Use `attributeValue`.
+     * Kept as compatibility alias because this token is a reusable claim value,
+     * not a claim key/attribute name.
+     */
     claim: string;
     i18nKey: `org.loinc.${string}`;
     titleEn?: string;
@@ -34,6 +40,12 @@ export declare const HealthcareBasicSections: Readonly<{
     PatientSummaryDocument: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -41,6 +53,12 @@ export declare const HealthcareBasicSections: Readonly<{
     AllergiesAndIntolerances: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -48,6 +66,12 @@ export declare const HealthcareBasicSections: Readonly<{
     HistoryOfMedicationUse: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -55,6 +79,12 @@ export declare const HealthcareBasicSections: Readonly<{
     ProblemList: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -62,6 +92,12 @@ export declare const HealthcareBasicSections: Readonly<{
     Results: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -69,6 +105,12 @@ export declare const HealthcareBasicSections: Readonly<{
     Procedures: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -76,6 +118,12 @@ export declare const HealthcareBasicSections: Readonly<{
     Immunizations: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -83,6 +131,12 @@ export declare const HealthcareBasicSections: Readonly<{
     MedicalDevices: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -90,6 +144,12 @@ export declare const HealthcareBasicSections: Readonly<{
     FunctionalStatus: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -97,6 +157,12 @@ export declare const HealthcareBasicSections: Readonly<{
     PlanOfCare: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -104,6 +170,12 @@ export declare const HealthcareBasicSections: Readonly<{
     SocialHistory: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -111,6 +183,12 @@ export declare const HealthcareBasicSections: Readonly<{
     VitalSigns: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -120,6 +198,12 @@ export declare const HealthcareAdditionalSections: Readonly<{
     AdvanceDirectives: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -127,6 +211,12 @@ export declare const HealthcareAdditionalSections: Readonly<{
     DiagnosticImaging: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -134,6 +224,12 @@ export declare const HealthcareAdditionalSections: Readonly<{
     HistoryOfPastIllness: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -141,6 +237,12 @@ export declare const HealthcareAdditionalSections: Readonly<{
     ReasonForReferral: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -148,6 +250,12 @@ export declare const HealthcareAdditionalSections: Readonly<{
     ChiefComplaint: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -155,6 +263,12 @@ export declare const HealthcareAdditionalSections: Readonly<{
     HealthcareGeneral: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -164,6 +278,12 @@ export declare const HealthcareAllSections: Readonly<{
     AdvanceDirectives: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -171,6 +291,12 @@ export declare const HealthcareAllSections: Readonly<{
     DiagnosticImaging: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -178,6 +304,12 @@ export declare const HealthcareAllSections: Readonly<{
     HistoryOfPastIllness: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -185,6 +317,12 @@ export declare const HealthcareAllSections: Readonly<{
     ReasonForReferral: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -192,6 +330,12 @@ export declare const HealthcareAllSections: Readonly<{
     ChiefComplaint: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -199,6 +343,12 @@ export declare const HealthcareAllSections: Readonly<{
     HealthcareGeneral: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -206,6 +356,12 @@ export declare const HealthcareAllSections: Readonly<{
     PatientSummaryDocument: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -213,6 +369,12 @@ export declare const HealthcareAllSections: Readonly<{
     AllergiesAndIntolerances: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -220,6 +382,12 @@ export declare const HealthcareAllSections: Readonly<{
     HistoryOfMedicationUse: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -227,6 +395,12 @@ export declare const HealthcareAllSections: Readonly<{
     ProblemList: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -234,6 +408,12 @@ export declare const HealthcareAllSections: Readonly<{
     Results: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -241,6 +421,12 @@ export declare const HealthcareAllSections: Readonly<{
     Procedures: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -248,6 +434,12 @@ export declare const HealthcareAllSections: Readonly<{
     Immunizations: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -255,6 +447,12 @@ export declare const HealthcareAllSections: Readonly<{
     MedicalDevices: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -262,6 +460,12 @@ export declare const HealthcareAllSections: Readonly<{
     FunctionalStatus: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -269,6 +473,12 @@ export declare const HealthcareAllSections: Readonly<{
     PlanOfCare: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -276,6 +486,12 @@ export declare const HealthcareAllSections: Readonly<{
     SocialHistory: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -283,6 +499,12 @@ export declare const HealthcareAllSections: Readonly<{
     VitalSigns: Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -301,6 +523,12 @@ export declare const HealthcareSectionsByFamily: Readonly<{
     readonly summary: Readonly<Record<string, Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -308,6 +536,12 @@ export declare const HealthcareSectionsByFamily: Readonly<{
     readonly management: Readonly<Record<string, Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;
@@ -315,6 +549,12 @@ export declare const HealthcareSectionsByFamily: Readonly<{
     readonly subjectMatterDomain: Readonly<Record<string, Readonly<{
         system: typeof LOINC_SYSTEM_URL;
         code: string;
+        attributeValue: string;
+        /**
+         * @deprecated Use `attributeValue`.
+         * Kept as compatibility alias because this token is a reusable claim value,
+         * not a claim key/attribute name.
+         */
         claim: string;
         i18nKey: `org.loinc.${string}`;
         titleEn?: string;

package/dist/constants/healthcare.js

@@ -10,10 +10,12 @@ export const HealthcareRoleFamilies = Object.freeze({
     LegalRepresentativeHl7: 'legalRepresentativeHl7',
 });
 function defineSection(code, titleEn) {
+    const attributeValue = `LOINC|${code}`;
     return Object.freeze({
         system: LOINC_SYSTEM_URL,
         code,
-        claim: `LOINC|${code}`,
+        attributeValue,
+        claim: attributeValue,
         i18nKey: loincI18nKey(code),
         titleEn,
     });
@@ -264,11 +266,11 @@ export function getHealthcareRolesBySector(sector, family) {
     return HealthcareRolesBySector[sector]?.[family] || {};
 }
 export const HealthcareConsentActions = Object.freeze({
-    PatientSummaryDocument: HealthcareBasicSections.PatientSummaryDocument.claim,
-    AllergiesAndIntolerances: HealthcareBasicSections.AllergiesAndIntolerances.claim,
-    HistoryOfMedicationUse: HealthcareBasicSections.HistoryOfMedicationUse.claim,
-    ProblemList: HealthcareBasicSections.ProblemList.claim,
-    Results: HealthcareBasicSections.Results.claim,
-    Procedures: HealthcareBasicSections.Procedures.claim,
-    Immunizations: HealthcareBasicSections.Immunizations.claim,
+    PatientSummaryDocument: HealthcareBasicSections.PatientSummaryDocument.attributeValue,
+    AllergiesAndIntolerances: HealthcareBasicSections.AllergiesAndIntolerances.attributeValue,
+    HistoryOfMedicationUse: HealthcareBasicSections.HistoryOfMedicationUse.attributeValue,
+    ProblemList: HealthcareBasicSections.ProblemList.attributeValue,
+    Results: HealthcareBasicSections.Results.attributeValue,
+    Procedures: HealthcareBasicSections.Procedures.attributeValue,
+    Immunizations: HealthcareBasicSections.Immunizations.attributeValue,
 });

package/dist/examples/communication-bundle-session.js

@@ -5,7 +5,7 @@ import { CommunicationCategoryCodes } from '../constants/communication.js';
 import { ClaimConsent } from '../models/consent-rule.js';
 import { CommunicationClaim } from '../models/interoperable-claims/communication-claims.js';
 import { MedicationStatementClaim } from '../models/interoperable-claims/medication-statement-claims.js';
-import { EXAMPLE_COMMUNICATION_IDENTIFIER, EXAMPLE_CONSENT_DATE, EXAMPLE_CONSENT_IDENTIFIER, EXAMPLE_CONSENT_PERIOD_END, EXAMPLE_CONSENT_PERIOD_START, EXAMPLE_CONSENT_PURPOSE_TREATMENT, EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_IPS_BUNDLE_NOTE_TEXT, EXAMPLE_MEDICATION_STATEMENT_CODE, EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER, EXAMPLE_MEDICATION_STATEMENT_STATUS, EXAMPLE_MEDICATION_STATEMENT_TEXT, EXAMPLE_SUBJECT_DID, } from './shared.js';
+import { EXAMPLE_COMMUNICATION_IDENTIFIER, EXAMPLE_CONSENT_DATE, EXAMPLE_CONSENT_IDENTIFIER, EXAMPLE_CONSENT_PERIOD_END, EXAMPLE_CONSENT_PERIOD_START, EXAMPLE_CONSENT_PURPOSE_TREATMENT, EXAMPLE_EMAIL_PROFESSIONAL, EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN, EXAMPLE_IPS_BUNDLE_NOTE_TEXT, EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER, EXAMPLE_MEDICATION_STATEMENT_STATUS, EXAMPLE_MEDICATION_STATEMENT_TEXT, EXAMPLE_SUBJECT_DID, } from './shared.js';
 import { CommunicationBundleSession } from '../utils/communication-bundle-session.js';
 /**
  * First developer use case:
@@ -15,7 +15,7 @@ import { CommunicationBundleSession } from '../utils/communication-bundle-sessio
  * - release active entry memory when finished
  */
 export function buildConsentEditingCommunicationSessionExample() {
-    const session = new CommunicationBundleSession({
+    const bundleEditor = new CommunicationBundleSession({
         communicationClaims: {
             '@context': 'org.hl7.fhir.r4',
             [CommunicationClaim.Identifier]: EXAMPLE_COMMUNICATION_IDENTIFIER,
@@ -24,7 +24,7 @@ export function buildConsentEditingCommunicationSessionExample() {
             [CommunicationClaim.Text]: EXAMPLE_IPS_BUNDLE_NOTE_TEXT,
         },
     });
-    session.upsertActiveConsentEntry({
+    bundleEditor.upsertActiveConsentEntry({
         claims: {
             '@context': 'org.hl7.fhir.api',
             [ClaimConsent.decision]: 'permit',
@@ -34,16 +34,16 @@ export function buildConsentEditingCommunicationSessionExample() {
             [ClaimConsent.periodStart]: EXAMPLE_CONSENT_PERIOD_START,
             [ClaimConsent.periodEnd]: EXAMPLE_CONSENT_PERIOD_END,
             [ClaimConsent.purpose]: EXAMPLE_CONSENT_PURPOSE_TREATMENT,
-            [ClaimConsent.action]: HealthcareBasicSections.AllergiesAndIntolerances.claim,
+            [ClaimConsent.action]: HealthcareBasicSections.AllergiesAndIntolerances.attributeValue,
             [ClaimConsent.actorIdentifier]: EXAMPLE_EMAIL_PROFESSIONAL,
             [ClaimConsent.actorRole]: EXAMPLE_HEALTHCARE_ACTOR_ROLE_PHYSICIAN,
         },
         fullUrl: `urn:uuid:${EXAMPLE_CONSENT_IDENTIFIER}`,
     });
-    session.saveAndReleaseActiveEntry();
+    bundleEditor.saveAndReleaseActiveEntry();
     return {
-        communicationClaims: session.getCommunicationClaims(),
-        bundleInMemory: session.getBundleInMemory(),
+        communicationClaims: bundleEditor.getCommunicationClaims(),
+        bundleInMemory: bundleEditor.getBundleInMemory(),
     };
 }
 /**
@@ -53,7 +53,7 @@ export function buildConsentEditingCommunicationSessionExample() {
  * - apply save/release lifecycle consistently
  */
 export function buildMedicationEditingCommunicationSessionExample() {
-    const session = new CommunicationBundleSession({
+    const bundleEditor = new CommunicationBundleSession({
         communicationClaims: {
             '@context': 'org.hl7.fhir.r4',
             [CommunicationClaim.Identifier]: EXAMPLE_COMMUNICATION_IDENTIFIER,
@@ -62,20 +62,19 @@ export function buildMedicationEditingCommunicationSessionExample() {
             [CommunicationClaim.Text]: EXAMPLE_IPS_BUNDLE_NOTE_TEXT,
         },
     });
-    session.upsertActiveMedicationStatementEntry({
+    bundleEditor.upsertActiveMedicationStatementEntry({
         claims: {
             '@context': 'org.hl7.fhir.api',
             [MedicationStatementClaim.Identifier]: EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER,
             [MedicationStatementClaim.Subject]: EXAMPLE_SUBJECT_DID,
             [MedicationStatementClaim.Status]: EXAMPLE_MEDICATION_STATEMENT_STATUS,
-            [MedicationStatementClaim.Code]: EXAMPLE_MEDICATION_STATEMENT_CODE,
             [MedicationStatementClaim.MedicationText]: EXAMPLE_MEDICATION_STATEMENT_TEXT,
         },
         fullUrl: `urn:uuid:${EXAMPLE_MEDICATION_STATEMENT_IDENTIFIER}`,
     });
-    session.saveAndReleaseActiveEntry();
+    bundleEditor.saveAndReleaseActiveEntry();
     return {
-        communicationClaims: session.getCommunicationClaims(),
-        bundleInMemory: session.getBundleInMemory(),
+        communicationClaims: bundleEditor.getCommunicationClaims(),
+        bundleInMemory: bundleEditor.getBundleInMemory(),
     };
 }

package/dist/examples/index.d.ts

@@ -12,3 +12,4 @@ export * from './lifecycle';
 export * from './api-flow-examples';
 export * from './contract-examples';
 export * from './communication-bundle-session';
+export * from './ips-bundle';

package/dist/examples/index.js

@@ -12,3 +12,4 @@ export * from './lifecycle.js';
 export * from './api-flow-examples.js';
 export * from './contract-examples.js';
 export * from './communication-bundle-session.js';
+export * from './ips-bundle.js';

package/dist/examples/ips-bundle.d.ts

@@ -0,0 +1,25 @@
+import { BundleEntry, BundleJsonApi } from '../models/bundle';
+import { toClinicalResourceCardViews, toClinicalResourceCommonViews } from '../utils/clinical-resource-view';
+export type IpsClinicalHistoryBundleExample = Readonly<{
+    communicationClaims: Record<string, unknown>;
+    bundleInMemory: BundleJsonApi<BundleEntry>;
+}>;
+export type IpsBundleFrontCardsExample = Readonly<{
+    communicationClaims: Record<string, unknown>;
+    bundleInMemory: BundleJsonApi<BundleEntry>;
+    medicationEntryIds: string[];
+    allergyEntryIds: string[];
+    conditionEntryIds: string[];
+    cardViews: ReturnType<typeof toClinicalResourceCardViews>;
+    commonViews: ReturnType<typeof toClinicalResourceCommonViews>;
+}>;
+/**
+ * Builds a minimal IPS-like history bundle with common clinical resource types
+ * authored as `resource.meta.claims`.
+ */
+export declare function buildIpsClinicalHistoryBundleExample(): IpsClinicalHistoryBundleExample;
+/**
+ * Builds the bundle plus section-level ids and UI-friendly card/common views
+ * for frontend resource cards.
+ */
+export declare function buildIpsBundleFrontCardsExample(): IpsBundleFrontCardsExample;