gdc-common-utils-ts 1.14.9 → 1.14.10

package/README.md

@@ -95,7 +95,7 @@ import { JweObject, JwtCompactParts } from 'gdc-common-utils-ts/models';
 - [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
+  - canonical 101 for requesting IPS, editing IPS-style bundles in `Communication.content-attachment-data`, and reading resources by section
 
 ## Dataspace Protocol And Discovery
 

package/dist/examples/communication-bundle-document-request.js

@@ -39,7 +39,7 @@ export function buildExampleIpsBundleDocumentRequestFromDoctor() {
         sender: EXAMPLE_EMAIL_PROFESSIONAL,
         requesterKind: BundleDocumentRequesterKinds.Employee,
         requesterIdentifier: EXAMPLE_EMAIL_PROFESSIONAL,
-        requesterRole: HealthcareActorRoles.Physician,
+        requesterRole: HealthcareActorRoles.GeneralistMedicalPractitioner,
         documentType: DocumentTypeLoincOntology.IPS,
         sections,
         summaryOperationRequestReferencePath,
@@ -49,7 +49,7 @@ export function buildExampleIpsBundleDocumentRequestFromDoctor() {
         sender: EXAMPLE_EMAIL_PROFESSIONAL,
         requesterKind: BundleDocumentRequesterKinds.Employee,
         requesterIdentifier: EXAMPLE_EMAIL_PROFESSIONAL,
-        requesterRole: HealthcareActorRoles.Physician,
+        requesterRole: HealthcareActorRoles.GeneralistMedicalPractitioner,
         documentType: DocumentTypeLoincOntology.IPS,
         sections,
         text: String(claims[CommunicationClaim.Text] || ''),

package/dist/examples/shared.d.ts

@@ -110,8 +110,8 @@ export declare const EXAMPLE_MEDICATION_PARACETAMOL_TEXT: "Paracetamol 600 mg";
 export declare const EXAMPLE_MEDICATION_PARACETAMOL_IDENTIFIER_PREFIX: "urn:uuid:med-paracetamol";
 export declare const EXAMPLE_MEDICATION_PARACETAMOL_EFFECTIVE: "2026-06-01T12:00:00Z";
 export declare const EXAMPLE_MEDICATION_PARACETAMOL_NOTE: "Take every 8 hours as needed. Keep a 4 hour gap from ibuprofen.";
-export declare const EXAMPLE_IPS_BUNDLE_REFERENCE_URL: "individual/org.hl7.fhir.r4/Bundle?type=document&composition.subject=did:web:api.acme.org:individual:123&composition.type=http://loinc.org|60591-5";
-export declare const EXAMPLE_IPS_BUNDLE_REFERENCE_ABSOLUTE_URL: "https://provider.example.org/acme-id/cds-ES/v1/health-care/individual/org.hl7.fhir.r4/Bundle?type=document&composition.subject=did:web:api.acme.org:individual:123&composition.type=http://loinc.org|60591-5";
+export declare const EXAMPLE_IPS_BUNDLE_REFERENCE_URL: "individual/org.hl7.fhir.r4/Bundle/_search?type=document&composition.subject=did:web:api.acme.org:individual:123&composition.type=http://loinc.org|60591-5";
+export declare const EXAMPLE_IPS_BUNDLE_REFERENCE_ABSOLUTE_URL: "https://provider.example.org/acme-id/cds-ES/v1/health-care/individual/org.hl7.fhir.r4/Bundle/_search?type=document&composition.subject=did:web:api.acme.org:individual:123&composition.type=http://loinc.org|60591-5";
 export type ExampleDateRange = Readonly<{
     start: string;
     end: string;

package/dist/examples/shared.js

@@ -116,7 +116,7 @@ export const EXAMPLE_MEDICATION_PARACETAMOL_TEXT = 'Paracetamol 600 mg';
 export const EXAMPLE_MEDICATION_PARACETAMOL_IDENTIFIER_PREFIX = 'urn:uuid:med-paracetamol';
 export const EXAMPLE_MEDICATION_PARACETAMOL_EFFECTIVE = '2026-06-01T12:00:00Z';
 export const EXAMPLE_MEDICATION_PARACETAMOL_NOTE = 'Take every 8 hours as needed. Keep a 4 hour gap from ibuprofen.';
-export const EXAMPLE_IPS_BUNDLE_REFERENCE_URL = `individual/org.hl7.fhir.r4/Bundle?type=document&composition.subject=${EXAMPLE_SUBJECT_DID}&composition.type=http://loinc.org|60591-5`;
+export const EXAMPLE_IPS_BUNDLE_REFERENCE_URL = `individual/org.hl7.fhir.r4/Bundle/_search?type=document&composition.subject=${EXAMPLE_SUBJECT_DID}&composition.type=http://loinc.org|60591-5`;
 export const EXAMPLE_IPS_BUNDLE_REFERENCE_ABSOLUTE_URL = `https://provider.example.org/acme-id/cds-ES/v1/health-care/${EXAMPLE_IPS_BUNDLE_REFERENCE_URL}`;
 export const EXAMPLE_CLINICAL_DATE_RANGE = {
     start: '2026-01-01',

package/dist/utils/communication-bundle-document-request.d.ts

@@ -136,8 +136,8 @@ export declare function buildBundleSearchReferenceUrl(input: Readonly<{
  */
 export declare function createSummaryOperationRequestParameters(subjectIdOrInput: string | CreateSummaryOperationParametersInput, filterSections?: string[]): ReadonlyArray<ParameterData>;
 /**
- * Flattens semantic summary-operation parameters to the relative search path
- * currently stored in `Communication.content-reference`.
+ * Flattens semantic summary-operation parameters to the relative `Bundle/_search`
+ * path currently stored in `Communication.content-reference`.
  */
 export declare function createSummaryOperationRequestReferencePath(parameters: ReadonlyArray<ParameterData>): string;
 /**
@@ -187,8 +187,10 @@ export declare const communication: Readonly<{
      */
     newIpsSummarySearchCommunication: typeof createIpsSummarySearchCommunicationClaims;
     /**
-     * Frontend-facing IPS helper: creates the DIDComm-ready message to request
-     * an IPS summary/search using an already-generated reference path.
+     * Compatibility helper for current DIDComm transport flows.
+     *
+     * Prefer `newIpsSummarySearchCommunication(...)` in `common-utils` 101 docs.
+     * DIDComm/outbox orchestration belongs to the next SDK layer.
      */
     newIpsSummarySearchDidcommMessage: typeof createIpsSummarySearchDidcommMessage;
     /**

package/dist/utils/communication-bundle-document-request.js

@@ -235,8 +235,8 @@ export function createSummaryOperationRequestParameters(subjectIdOrInput, filter
     ];
 }
 /**
- * Flattens semantic summary-operation parameters to the relative search path
- * currently stored in `Communication.content-reference`.
+ * Flattens semantic summary-operation parameters to the relative `Bundle/_search`
+ * path currently stored in `Communication.content-reference`.
  */
 export function createSummaryOperationRequestReferencePath(parameters) {
     const params = ['type=document'];
@@ -258,7 +258,7 @@ export function createSummaryOperationRequestReferencePath(parameters) {
             params.push(`composition.section=${String(parameter.value || '').trim()}`);
         }
     }
-    return `individual/org.hl7.fhir.r4/Bundle?${params.filter(Boolean).join('&')}`;
+    return `individual/org.hl7.fhir.r4/Bundle/_search?${params.filter(Boolean).join('&')}`;
 }
 /**
  * Resolves the full runtime URL to call GW CORE from the provider sector DID
@@ -323,8 +323,10 @@ export const communication = Object.freeze({
      */
     newIpsSummarySearchCommunication: createIpsSummarySearchCommunicationClaims,
     /**
-     * Frontend-facing IPS helper: creates the DIDComm-ready message to request
-     * an IPS summary/search using an already-generated reference path.
+     * Compatibility helper for current DIDComm transport flows.
+     *
+     * Prefer `newIpsSummarySearchCommunication(...)` in `common-utils` 101 docs.
+     * DIDComm/outbox orchestration belongs to the next SDK layer.
      */
     newIpsSummarySearchDidcommMessage: createIpsSummarySearchDidcommMessage,
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdc-common-utils-ts",
-  "version": "1.14.9",
+  "version": "1.14.10",
   "publishConfig": {
     "access": "public"
   },