gdc-common-utils-ts 2.0.18 → 2.2.2

package/dist/utils/communication-editor.js

@@ -0,0 +1,97 @@
+// Copyright 2026 Conectate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+import { CommunicationClaimsContext, } from '../models/communication-attached-bundle-session.js';
+import { BundleReader } from './bundle-reader.js';
+import { CommunicationAttachedBundleSession } from './communication-attached-bundle-session.js';
+import { getCommunicationClaimsListFromDidcommPayload, getFirstCommunicationClaimsFromDidcommPayload, } from './communication-didcomm-payload.js';
+import { CommunicationClaim } from '../models/interoperable-claims/communication-claims.js';
+/**
+ * Public high-level editor for one delivery `Communication`.
+ *
+ * Teaching contract:
+ * - use this name in tutorials when the caller is authoring one outer
+ *   `Communication`
+ * - keep `CommunicationAttachedBundleSession` as the lower-level compatibility
+ *   implementation detail underneath
+ */
+export class CommunicationEditor extends CommunicationAttachedBundleSession {
+    constructor(options = {}) {
+        super({
+            ...options,
+            communicationClaims: {
+                '@context': CommunicationClaimsContext,
+                ...(options.communicationClaims || {}),
+            },
+        });
+    }
+    /** Materializes one immutable snapshot of the current Communication claims. */
+    done() {
+        return this.getCommunicationClaims();
+    }
+    /** Returns one reader over the current Communication snapshot. */
+    toReader() {
+        return new CommunicationReader(this.getCommunicationClaims());
+    }
+}
+/**
+ * Public high-level reader for one delivery `Communication`.
+ */
+export class CommunicationReader {
+    session;
+    constructor(communicationClaims) {
+        this.session = new CommunicationAttachedBundleSession({ communicationClaims });
+    }
+    /** Reads the first delivery `Communication` carried in one DIDComm/plain payload. */
+    static fromDidcommPayload(payload) {
+        return new CommunicationReader(getFirstCommunicationClaimsFromDidcommPayload(payload));
+    }
+    /** Reads every delivery `Communication` carried in one DIDComm/plain payload. */
+    static listFromDidcommPayload(payload) {
+        return getCommunicationClaimsListFromDidcommPayload(payload)
+            .map((communicationClaims) => new CommunicationReader(communicationClaims));
+    }
+    getCommunicationClaims() {
+        return this.session.getCommunicationClaims();
+    }
+    getCommunicationIdentifier() {
+        return this.session.getCommunicationIdentifier();
+    }
+    getCommunicationSubject() {
+        return this.session.getCommunicationSubject();
+    }
+    getCommunicationCategoryList() {
+        return this.session.getCommunicationCategoryList();
+    }
+    getCommunicationTopic() {
+        return this.session.getCommunicationTopic();
+    }
+    getCommunicationText() {
+        return this.session.getCommunicationText();
+    }
+    getAttachmentContentType() {
+        return String(this.getCommunicationClaims()[CommunicationClaim.ContentAttachmentType] || '').trim();
+    }
+    getAttachmentTitle() {
+        return String(this.getCommunicationClaims()[CommunicationClaim.ContentAttachmentTitle] || '').trim();
+    }
+    getAttachmentUrl() {
+        return String(this.getCommunicationClaims()[CommunicationClaim.ContentAttachmentUrl] || '').trim();
+    }
+    getAttachmentDataBase64() {
+        return String(this.getCommunicationClaims()[CommunicationClaim.ContentAttachmentData] || '').trim();
+    }
+    getAttachedBundle() {
+        return this.session.getAttachedBundle();
+    }
+    getAttachedBundleReader() {
+        return new BundleReader(this.getAttachedBundle());
+    }
+    getAttachedBundleResourceIds(filters = {}) {
+        return this.getAttachedBundleReader().getResourceIds(filters);
+    }
+    getAttachedBundleEntriesByIds(resourceIds) {
+        return this.getAttachedBundleReader().getEntriesByIds(resourceIds);
+    }
+    getAttachedBundleEntryUrl(resourceId) {
+        return this.getAttachedBundleReader().getEntryUrl(resourceId);
+    }
+}

package/dist/utils/condition-entry-editor.d.ts

@@ -0,0 +1,30 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor';
+/**
+ * Typed editor for one staged Condition resource entry.
+ *
+ * Use this when a caller needs to stage one condition row with claims-first
+ * accessors in a bundle authoring flow.
+ */
+export declare class ConditionEntryEditor extends ClinicalResourceEntryEditor {
+    setIdentifier(identifier?: string | null): this;
+    getIdentifier(): string | undefined;
+    ensureIdentifier(): string;
+    setSubject(subject?: string | null): this;
+    getSubject(): string | undefined;
+    setCode(code?: string | null): this;
+    getCode(): string | undefined;
+    setClinicalStatus(status?: string | null): this;
+    getClinicalStatus(): string | undefined;
+    setVerificationStatus(status?: string | null): this;
+    getVerificationStatus(): string | undefined;
+    setCategory(category?: string | null): this;
+    getCategory(): string | undefined;
+    setSeverity(severity?: string | null): this;
+    getSeverity(): string | undefined;
+    setOnsetDateTime(value?: string | null): this;
+    getOnsetDateTime(): string | undefined;
+    setRecorder(reference?: string | null): this;
+    getRecorder(): string | undefined;
+    setContainedDocumentIdentifierList(identifiers: readonly string[]): this;
+    getContainedDocumentIdentifierList(): string[];
+}

package/dist/utils/condition-entry-editor.js

@@ -0,0 +1,34 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor.js';
+import { ConditionClaim } from '../models/interoperable-claims/condition-claims.js';
+import { BundleEditableResourceTypes } from '../models/bundle-editor-types.js';
+import { registerBundleEntryEditor } from './bundle-editor-registry.js';
+/**
+ * Typed editor for one staged Condition resource entry.
+ *
+ * Use this when a caller needs to stage one condition row with claims-first
+ * accessors in a bundle authoring flow.
+ */
+export class ConditionEntryEditor extends ClinicalResourceEntryEditor {
+    setIdentifier(identifier) { return this.setIdentifierValue(ConditionClaim.Identifier, identifier); }
+    getIdentifier() { return this.getIdentifierValue(ConditionClaim.Identifier); }
+    ensureIdentifier() { return this.ensureIdentifierValue(ConditionClaim.Identifier); }
+    setSubject(subject) { return this.setSubjectClaims(ConditionClaim.Subject, ConditionClaim.Subject, subject); }
+    getSubject() { return this.getSubjectClaims(ConditionClaim.Subject, ConditionClaim.Subject); }
+    setCode(code) { return this.setScalarClaim(ConditionClaim.Code, code); }
+    getCode() { return this.getScalarClaim(ConditionClaim.Code); }
+    setClinicalStatus(status) { return this.setScalarClaim(ConditionClaim.ClinicalStatus, status); }
+    getClinicalStatus() { return this.getScalarClaim(ConditionClaim.ClinicalStatus); }
+    setVerificationStatus(status) { return this.setScalarClaim(ConditionClaim.VerificationStatus, status); }
+    getVerificationStatus() { return this.getScalarClaim(ConditionClaim.VerificationStatus); }
+    setCategory(category) { return this.setScalarClaim(ConditionClaim.Category, category); }
+    getCategory() { return this.getScalarClaim(ConditionClaim.Category); }
+    setSeverity(severity) { return this.setScalarClaim(ConditionClaim.Severity, severity); }
+    getSeverity() { return this.getScalarClaim(ConditionClaim.Severity); }
+    setOnsetDateTime(value) { return this.setScalarClaim(ConditionClaim.OnsetDateTime, value); }
+    getOnsetDateTime() { return this.getScalarClaim(ConditionClaim.OnsetDateTime); }
+    setRecorder(reference) { return this.setScalarClaim(ConditionClaim.Recorder, reference); }
+    getRecorder() { return this.getScalarClaim(ConditionClaim.Recorder); }
+    setContainedDocumentIdentifierList(identifiers) { return this.setCsvClaimList(ConditionClaim.ContainedDocuments, identifiers); }
+    getContainedDocumentIdentifierList() { return this.getCsvClaimList(ConditionClaim.ContainedDocuments); }
+}
+registerBundleEntryEditor(BundleEditableResourceTypes.condition, ConditionEntryEditor);

package/dist/utils/consent-claim-helpers.d.ts

@@ -77,9 +77,13 @@ export declare function removeSectors(claims: InteroperableClaims, values: strin
  * Returns linked DocumentReference identifiers carried by the consent.
  */
 export declare function getContainedDocumentIdentifierList(claims: InteroperableClaims): string[];
+export declare function getContainedResourceReferenceList(claims: InteroperableClaims): string[];
 export declare function setContainedDocumentIdentifierList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
+export declare function setContainedResourceReferenceList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
 export declare function addContainedDocumentIdentifierList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
 export declare function removeContainedDocumentIdentifierList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
+export declare function addContainedResourceReferenceList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
+export declare function removeContainedResourceReferenceList(claims: InteroperableClaims, values: string | readonly string[]): InteroperableClaims;
 /**
  * Reads the canonical consent date claim.
  */

package/dist/utils/consent-claim-helpers.js

@@ -167,13 +167,20 @@ export function removeSectors(claims, values) {
  */
 export function getContainedDocumentIdentifierList(claims) {
     return uniqueCsvLists([
+        getClaimValues(claims, ClaimConsent.containedReferenceList),
         getClaimValues(claims, ClaimConsent.containedDocuments),
         getClaimValues(claims, ClaimConsent.attachmentContentIds),
     ]);
 }
+export function getContainedResourceReferenceList(claims) {
+    return getContainedDocumentIdentifierList(claims);
+}
 export function setContainedDocumentIdentifierList(claims, values) {
     return setContainedDocuments(claims, values);
 }
+export function setContainedResourceReferenceList(claims, values) {
+    return setContainedDocuments(claims, values);
+}
 export function addContainedDocumentIdentifierList(claims, values) {
     return setContainedDocuments(claims, uniqueCsvLists([
         getContainedDocumentIdentifierList(claims),
@@ -186,11 +193,18 @@ export function removeContainedDocumentIdentifierList(claims, values) {
         .filter(Boolean));
     return setContainedDocuments(claims, getContainedDocumentIdentifierList(claims).filter((item) => !toRemove.has(item)));
 }
+export function addContainedResourceReferenceList(claims, values) {
+    return addContainedDocumentIdentifierList(claims, values);
+}
+export function removeContainedResourceReferenceList(claims, values) {
+    return removeContainedDocumentIdentifierList(claims, values);
+}
 function setContainedDocuments(claims, values) {
-    const next = setClaimValues(claims, ClaimConsent.containedDocuments, values);
+    const next = setClaimValues(claims, ClaimConsent.containedReferenceList, values);
     const cleaned = {
         ...next,
     };
+    delete cleaned[ClaimConsent.containedDocuments];
     delete cleaned[ClaimConsent.attachmentContentIds];
     return cleaned;
 }

package/dist/utils/coverage-entry-editor.d.ts

@@ -0,0 +1,51 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor';
+/**
+ * Typed editor for one staged Coverage resource entry.
+ *
+ * Use this when a caller needs to stage one coverage row with claims-first
+ * accessors in a bundle authoring flow.
+ */
+export declare class CoverageEntryEditor extends ClinicalResourceEntryEditor {
+    /** Writes the canonical coverage identifier. */
+    setIdentifier(identifier?: string | null): this;
+    /** Reads the canonical coverage identifier. */
+    getIdentifier(): string | undefined;
+    /** Ensures the coverage entry has one canonical `urn:uuid:*` identifier. */
+    ensureIdentifier(): string;
+    /** Writes the coverage status. */
+    setStatus(value?: string | null): this;
+    /** Reads the coverage status. */
+    getStatus(): string | undefined;
+    /** Writes the coverage type. */
+    setType(value?: string | null): this;
+    /** Reads the coverage type. */
+    getType(): string | undefined;
+    /** Writes the policy-holder reference. */
+    setPolicyHolder(value?: string | null): this;
+    /** Reads the policy-holder reference. */
+    getPolicyHolder(): string | undefined;
+    /** Writes the subscriber reference. */
+    setSubscriber(value?: string | null): this;
+    /** Reads the subscriber reference. */
+    getSubscriber(): string | undefined;
+    /** Writes the beneficiary reference. */
+    setBeneficiary(value?: string | null): this;
+    /** Reads the beneficiary reference. */
+    getBeneficiary(): string | undefined;
+    /** Writes the subscriber relationship. */
+    setRelationship(value?: string | null): this;
+    /** Reads the subscriber relationship. */
+    getRelationship(): string | undefined;
+    /** Writes the coverage period start. */
+    setPeriodStart(value?: string | null): this;
+    /** Reads the coverage period start. */
+    getPeriodStart(): string | undefined;
+    /** Writes the coverage period end. */
+    setPeriodEnd(value?: string | null): this;
+    /** Reads the coverage period end. */
+    getPeriodEnd(): string | undefined;
+    /** Writes the payor list. */
+    setPayorList(values: readonly string[]): this;
+    /** Reads the payor list. */
+    getPayorList(): string[];
+}

package/dist/utils/coverage-entry-editor.js

@@ -0,0 +1,55 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor.js';
+import { CoverageClaim } from '../models/interoperable-claims/coverage-claims.js';
+import { BundleEditableResourceTypes } from '../models/bundle-editor-types.js';
+import { registerBundleEntryEditor } from './bundle-editor-registry.js';
+/**
+ * Typed editor for one staged Coverage resource entry.
+ *
+ * Use this when a caller needs to stage one coverage row with claims-first
+ * accessors in a bundle authoring flow.
+ */
+export class CoverageEntryEditor extends ClinicalResourceEntryEditor {
+    /** Writes the canonical coverage identifier. */
+    setIdentifier(identifier) { return this.setIdentifierValue(CoverageClaim.Identifier, identifier); }
+    /** Reads the canonical coverage identifier. */
+    getIdentifier() { return this.getIdentifierValue(CoverageClaim.Identifier); }
+    /** Ensures the coverage entry has one canonical `urn:uuid:*` identifier. */
+    ensureIdentifier() { return this.ensureIdentifierValue(CoverageClaim.Identifier); }
+    /** Writes the coverage status. */
+    setStatus(value) { return this.setScalarClaim(CoverageClaim.Status, value); }
+    /** Reads the coverage status. */
+    getStatus() { return this.getScalarClaim(CoverageClaim.Status); }
+    /** Writes the coverage type. */
+    setType(value) { return this.setScalarClaim(CoverageClaim.Type, value); }
+    /** Reads the coverage type. */
+    getType() { return this.getScalarClaim(CoverageClaim.Type); }
+    /** Writes the policy-holder reference. */
+    setPolicyHolder(value) { return this.setScalarClaim(CoverageClaim.PolicyHolder, value); }
+    /** Reads the policy-holder reference. */
+    getPolicyHolder() { return this.getScalarClaim(CoverageClaim.PolicyHolder); }
+    /** Writes the subscriber reference. */
+    setSubscriber(value) { return this.setScalarClaim(CoverageClaim.Subscriber, value); }
+    /** Reads the subscriber reference. */
+    getSubscriber() { return this.getScalarClaim(CoverageClaim.Subscriber); }
+    /** Writes the beneficiary reference. */
+    setBeneficiary(value) { return this.setScalarClaim(CoverageClaim.Beneficiary, value); }
+    /** Reads the beneficiary reference. */
+    getBeneficiary() { return this.getScalarClaim(CoverageClaim.Beneficiary); }
+    /** Writes the subscriber relationship. */
+    setRelationship(value) { return this.setScalarClaim(CoverageClaim.Relationship, value); }
+    /** Reads the subscriber relationship. */
+    getRelationship() { return this.getScalarClaim(CoverageClaim.Relationship); }
+    /** Writes the coverage period start. */
+    setPeriodStart(value) { return this.setScalarClaim(CoverageClaim.PeriodStart, value); }
+    /** Reads the coverage period start. */
+    getPeriodStart() { return this.getScalarClaim(CoverageClaim.PeriodStart); }
+    /** Writes the coverage period end. */
+    setPeriodEnd(value) { return this.setScalarClaim(CoverageClaim.PeriodEnd, value); }
+    /** Reads the coverage period end. */
+    getPeriodEnd() { return this.getScalarClaim(CoverageClaim.PeriodEnd); }
+    /** Writes the payor list. */
+    setPayorList(values) { return this.setCsvClaimList(CoverageClaim.Payor, values); }
+    /** Reads the payor list. */
+    getPayorList() { return this.getCsvClaimList(CoverageClaim.Payor); }
+}
+registerBundleEntryEditor(BundleEditableResourceTypes.coverage, CoverageEntryEditor);

package/dist/utils/device-entry-editor.d.ts

@@ -0,0 +1,59 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor';
+/**
+ * Typed editor for one staged Device resource entry.
+ *
+ * Use this when a caller needs to stage one device row with claims-first
+ * accessors in a bundle authoring flow.
+ */
+export declare class DeviceEntryEditor extends ClinicalResourceEntryEditor {
+    /** Writes the canonical device identifier. */
+    setIdentifier(identifier?: string | null): this;
+    /** Reads the canonical device identifier. */
+    getIdentifier(): string | undefined;
+    /** Ensures the device entry has one canonical `urn:uuid:*` identifier. */
+    ensureIdentifier(): string;
+    /** Writes the patient reference for the device. */
+    setPatient(value?: string | null): this;
+    /** Reads the patient reference for the device. */
+    getPatient(): string | undefined;
+    /** Writes the device status. */
+    setStatus(value?: string | null): this;
+    /** Reads the device status. */
+    getStatus(): string | undefined;
+    /** Writes the device type. */
+    setType(value?: string | null): this;
+    /** Reads the device type. */
+    getType(): string | undefined;
+    /** Writes the manufacturer reference. */
+    setManufacturer(value?: string | null): this;
+    /** Reads the manufacturer reference. */
+    getManufacturer(): string | undefined;
+    /** Writes the model. */
+    setModel(value?: string | null): this;
+    /** Reads the model. */
+    getModel(): string | undefined;
+    /** Writes the human-readable device name. */
+    setDeviceName(value?: string | null): this;
+    /** Reads the human-readable device name. */
+    getDeviceName(): string | undefined;
+    /** Writes the serial number. */
+    setSerialNumber(value?: string | null): this;
+    /** Reads the serial number. */
+    getSerialNumber(): string | undefined;
+    /** Writes the owning organization. */
+    setOrganization(value?: string | null): this;
+    /** Reads the owning organization. */
+    getOrganization(): string | undefined;
+    /** Writes the location reference. */
+    setLocation(value?: string | null): this;
+    /** Reads the location reference. */
+    getLocation(): string | undefined;
+    /** Writes the URL reference. */
+    setUrl(value?: string | null): this;
+    /** Reads the URL reference. */
+    getUrl(): string | undefined;
+    /** Writes the note text. */
+    setNote(value?: string | null): this;
+    /** Reads the note text. */
+    getNote(): string | undefined;
+}

package/dist/utils/device-entry-editor.js

@@ -0,0 +1,63 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor.js';
+import { DeviceClaim } from '../models/interoperable-claims/device-claims.js';
+import { BundleEditableResourceTypes } from '../models/bundle-editor-types.js';
+import { registerBundleEntryEditor } from './bundle-editor-registry.js';
+/**
+ * Typed editor for one staged Device resource entry.
+ *
+ * Use this when a caller needs to stage one device row with claims-first
+ * accessors in a bundle authoring flow.
+ */
+export class DeviceEntryEditor extends ClinicalResourceEntryEditor {
+    /** Writes the canonical device identifier. */
+    setIdentifier(identifier) { return this.setIdentifierValue(DeviceClaim.Identifier, identifier); }
+    /** Reads the canonical device identifier. */
+    getIdentifier() { return this.getIdentifierValue(DeviceClaim.Identifier); }
+    /** Ensures the device entry has one canonical `urn:uuid:*` identifier. */
+    ensureIdentifier() { return this.ensureIdentifierValue(DeviceClaim.Identifier); }
+    /** Writes the patient reference for the device. */
+    setPatient(value) { return this.setScalarClaim(DeviceClaim.Patient, value); }
+    /** Reads the patient reference for the device. */
+    getPatient() { return this.getScalarClaim(DeviceClaim.Patient); }
+    /** Writes the device status. */
+    setStatus(value) { return this.setScalarClaim(DeviceClaim.Status, value); }
+    /** Reads the device status. */
+    getStatus() { return this.getScalarClaim(DeviceClaim.Status); }
+    /** Writes the device type. */
+    setType(value) { return this.setScalarClaim(DeviceClaim.Type, value); }
+    /** Reads the device type. */
+    getType() { return this.getScalarClaim(DeviceClaim.Type); }
+    /** Writes the manufacturer reference. */
+    setManufacturer(value) { return this.setScalarClaim(DeviceClaim.Manufacturer, value); }
+    /** Reads the manufacturer reference. */
+    getManufacturer() { return this.getScalarClaim(DeviceClaim.Manufacturer); }
+    /** Writes the model. */
+    setModel(value) { return this.setScalarClaim(DeviceClaim.Model, value); }
+    /** Reads the model. */
+    getModel() { return this.getScalarClaim(DeviceClaim.Model); }
+    /** Writes the human-readable device name. */
+    setDeviceName(value) { return this.setScalarClaim(DeviceClaim.DeviceName, value); }
+    /** Reads the human-readable device name. */
+    getDeviceName() { return this.getScalarClaim(DeviceClaim.DeviceName); }
+    /** Writes the serial number. */
+    setSerialNumber(value) { return this.setScalarClaim(DeviceClaim.SerialNumber, value); }
+    /** Reads the serial number. */
+    getSerialNumber() { return this.getScalarClaim(DeviceClaim.SerialNumber); }
+    /** Writes the owning organization. */
+    setOrganization(value) { return this.setScalarClaim(DeviceClaim.Organization, value); }
+    /** Reads the owning organization. */
+    getOrganization() { return this.getScalarClaim(DeviceClaim.Organization); }
+    /** Writes the location reference. */
+    setLocation(value) { return this.setScalarClaim(DeviceClaim.Location, value); }
+    /** Reads the location reference. */
+    getLocation() { return this.getScalarClaim(DeviceClaim.Location); }
+    /** Writes the URL reference. */
+    setUrl(value) { return this.setScalarClaim(DeviceClaim.Url, value); }
+    /** Reads the URL reference. */
+    getUrl() { return this.getScalarClaim(DeviceClaim.Url); }
+    /** Writes the note text. */
+    setNote(value) { return this.setScalarClaim(DeviceClaim.Note, value); }
+    /** Reads the note text. */
+    getNote() { return this.getScalarClaim(DeviceClaim.Note); }
+}
+registerBundleEntryEditor(BundleEditableResourceTypes.device, DeviceEntryEditor);

package/dist/utils/device-use-statement-entry-editor.d.ts

@@ -0,0 +1,43 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor';
+/**
+ * Typed editor for one staged DeviceUseStatement resource entry.
+ *
+ * Use this when a caller needs to stage one device-use row with claims-first
+ * accessors in a bundle authoring flow.
+ */
+export declare class DeviceUseStatementEntryEditor extends ClinicalResourceEntryEditor {
+    /** Writes the canonical device-use identifier. */
+    setIdentifier(identifier?: string | null): this;
+    /** Reads the canonical device-use identifier. */
+    getIdentifier(): string | undefined;
+    /** Ensures the device-use entry has one canonical `urn:uuid:*` identifier. */
+    ensureIdentifier(): string;
+    /** Writes the subject/patient reference. */
+    setSubject(subject?: string | null): this;
+    /** Reads the subject/patient reference. */
+    getSubject(): string | undefined;
+    /** Writes the device-use status. */
+    setStatus(value?: string | null): this;
+    /** Reads the device-use status. */
+    getStatus(): string | undefined;
+    /** Writes the linked device reference. */
+    setDevice(value?: string | null): this;
+    /** Reads the linked device reference. */
+    getDevice(): string | undefined;
+    /** Writes the recorded-on date. */
+    setRecordedOn(value?: string | null): this;
+    /** Reads the recorded-on date. */
+    getRecordedOn(): string | undefined;
+    /** Writes the timing date/time. */
+    setTimingDateTime(value?: string | null): this;
+    /** Reads the timing date/time. */
+    getTimingDateTime(): string | undefined;
+    /** Writes the reason code. */
+    setReasonCode(value?: string | null): this;
+    /** Reads the reason code. */
+    getReasonCode(): string | undefined;
+    /** Writes the source reference. */
+    setSource(value?: string | null): this;
+    /** Reads the source reference. */
+    getSource(): string | undefined;
+}

package/dist/utils/device-use-statement-entry-editor.js

@@ -0,0 +1,47 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor.js';
+import { DeviceUseStatementClaim } from '../models/interoperable-claims/device-use-statement-claims.js';
+import { BundleEditableResourceTypes } from '../models/bundle-editor-types.js';
+import { registerBundleEntryEditor } from './bundle-editor-registry.js';
+/**
+ * Typed editor for one staged DeviceUseStatement resource entry.
+ *
+ * Use this when a caller needs to stage one device-use row with claims-first
+ * accessors in a bundle authoring flow.
+ */
+export class DeviceUseStatementEntryEditor extends ClinicalResourceEntryEditor {
+    /** Writes the canonical device-use identifier. */
+    setIdentifier(identifier) { return this.setIdentifierValue(DeviceUseStatementClaim.Identifier, identifier); }
+    /** Reads the canonical device-use identifier. */
+    getIdentifier() { return this.getIdentifierValue(DeviceUseStatementClaim.Identifier); }
+    /** Ensures the device-use entry has one canonical `urn:uuid:*` identifier. */
+    ensureIdentifier() { return this.ensureIdentifierValue(DeviceUseStatementClaim.Identifier); }
+    /** Writes the subject/patient reference. */
+    setSubject(subject) { return this.setSubjectClaims(DeviceUseStatementClaim.Subject, DeviceUseStatementClaim.Subject, subject); }
+    /** Reads the subject/patient reference. */
+    getSubject() { return this.getSubjectClaims(DeviceUseStatementClaim.Subject, DeviceUseStatementClaim.Subject); }
+    /** Writes the device-use status. */
+    setStatus(value) { return this.setScalarClaim(DeviceUseStatementClaim.Status, value); }
+    /** Reads the device-use status. */
+    getStatus() { return this.getScalarClaim(DeviceUseStatementClaim.Status); }
+    /** Writes the linked device reference. */
+    setDevice(value) { return this.setScalarClaim(DeviceUseStatementClaim.Device, value); }
+    /** Reads the linked device reference. */
+    getDevice() { return this.getScalarClaim(DeviceUseStatementClaim.Device); }
+    /** Writes the recorded-on date. */
+    setRecordedOn(value) { return this.setScalarClaim(DeviceUseStatementClaim.RecordedOn, value); }
+    /** Reads the recorded-on date. */
+    getRecordedOn() { return this.getScalarClaim(DeviceUseStatementClaim.RecordedOn); }
+    /** Writes the timing date/time. */
+    setTimingDateTime(value) { return this.setScalarClaim(DeviceUseStatementClaim.TimingDateTime, value); }
+    /** Reads the timing date/time. */
+    getTimingDateTime() { return this.getScalarClaim(DeviceUseStatementClaim.TimingDateTime); }
+    /** Writes the reason code. */
+    setReasonCode(value) { return this.setScalarClaim(DeviceUseStatementClaim.ReasonCode, value); }
+    /** Reads the reason code. */
+    getReasonCode() { return this.getScalarClaim(DeviceUseStatementClaim.ReasonCode); }
+    /** Writes the source reference. */
+    setSource(value) { return this.setScalarClaim(DeviceUseStatementClaim.Source, value); }
+    /** Reads the source reference. */
+    getSource() { return this.getScalarClaim(DeviceUseStatementClaim.Source); }
+}
+registerBundleEntryEditor(BundleEditableResourceTypes.deviceUseStatement, DeviceUseStatementEntryEditor);

package/dist/utils/diagnostic-report-entry-editor.d.ts

@@ -0,0 +1,74 @@
+/**
+ * File discipline note:
+ * - Read `ARCHITECTURE.md` and `CONTRIBUTING.md` before changing this module.
+ * - Keep exactly one exported class per file.
+ * - Keep this file focused on one typed editor surface.
+ * - Move shared helpers to reusable helper/base modules instead of duplicating logic here.
+ */
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor';
+/**
+ * Typed editor for one staged DiagnosticReport resource entry.
+ *
+ * Use this surface when the frontend or BFF needs to stage one report with
+ * links to results, specimen references, or one rendered attachment.
+ */
+export declare class DiagnosticReportEntryEditor extends ClinicalResourceEntryEditor {
+    /** Overrides the canonical identifier when import or migration logic needs one explicit public id. */
+    setIdentifier(identifier?: string | null): this;
+    /** Returns the canonical identifier currently exposed for this report. */
+    getIdentifier(): string | undefined;
+    /** Ensures the entry has one synchronized canonical identifier across public claim, `resource.id`, and `fullUrl`. */
+    ensureIdentifier(): string;
+    /** Sets the subject or patient reference for this report. */
+    setSubject(subject?: string | null): this;
+    /** Returns the subject or patient reference for this report. */
+    getSubject(): string | undefined;
+    /** Sets the report status. */
+    setStatus(status?: string | null): this;
+    /** Returns the report status. */
+    getStatus(): string | undefined;
+    /** Sets the report date or effective time. */
+    setDate(date?: string | null): this;
+    /** Returns the report date or effective time. */
+    getDate(): string | undefined;
+    /** Sets the report category. */
+    setCategory(category?: string | null): this;
+    /** Returns the report category. */
+    getCategory(): string | undefined;
+    /** Sets the main report code. */
+    setCode(code?: string | null): this;
+    /** Returns the main report code. */
+    getCode(): string | undefined;
+    /** Sets the encounter reference linked to this report. */
+    setEncounter(reference?: string | null): this;
+    /** Returns the encounter reference linked to this report. */
+    getEncounter(): string | undefined;
+    /** Replaces the performer reference list. */
+    setPerformerList(references: readonly string[]): this;
+    /** Returns the performer reference list. */
+    getPerformerList(): string[];
+    /** Replaces the result reference list, often Observation references. */
+    setResultList(references: readonly string[]): this;
+    /** Returns the result reference list. */
+    getResultList(): string[];
+    /** Replaces the specimen reference list. */
+    setSpecimenList(references: readonly string[]): this;
+    /** Returns the specimen reference list. */
+    getSpecimenList(): string[];
+    /** @deprecated Use the shared contained-resource reference surface on `ClinicalResourceEntryEditor`. */
+    setContainedDocumentIdentifierList(identifiers: readonly string[]): this;
+    /** @deprecated Use the shared contained-resource reference surface on `ClinicalResourceEntryEditor`. */
+    getContainedDocumentIdentifierList(): string[];
+    /** Sets the MIME type for one attached presented form. */
+    setPresentedFormContentType(contentType?: string | null): this;
+    /** Returns the MIME type for the attached presented form. */
+    getPresentedFormContentType(): string | undefined;
+    /** Sets the inline base64 payload for one attached presented form. */
+    setPresentedFormData(data?: string | null): this;
+    /** Returns the inline base64 payload for the attached presented form. */
+    getPresentedFormData(): string | undefined;
+    /** Sets the external URL for one attached presented form. */
+    setPresentedFormUrl(url?: string | null): this;
+    /** Returns the external URL for the attached presented form. */
+    getPresentedFormUrl(): string | undefined;
+}