gdc-common-utils-ts 2.1.0 → 2.2.2

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;
+}

package/dist/utils/diagnostic-report-entry-editor.js

@@ -0,0 +1,136 @@
+/**
+ * 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.js';
+import { DiagnosticReportClaim } from '../models/interoperable-claims/diagnostic-report-claims.js';
+import { BundleEditableResourceTypes } from '../models/bundle-editor-types.js';
+import { registerBundleEntryEditor } from './bundle-editor-registry.js';
+/**
+ * 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 class DiagnosticReportEntryEditor extends ClinicalResourceEntryEditor {
+    /** Overrides the canonical identifier when import or migration logic needs one explicit public id. */
+    setIdentifier(identifier) {
+        return this.setIdentifierValue(DiagnosticReportClaim.Identifier, identifier);
+    }
+    /** Returns the canonical identifier currently exposed for this report. */
+    getIdentifier() {
+        return this.getIdentifierValue(DiagnosticReportClaim.Identifier);
+    }
+    /** Ensures the entry has one synchronized canonical identifier across public claim, `resource.id`, and `fullUrl`. */
+    ensureIdentifier() {
+        return this.ensureIdentifierValue(DiagnosticReportClaim.Identifier);
+    }
+    /** Sets the subject or patient reference for this report. */
+    setSubject(subject) {
+        return this.setSubjectClaims(DiagnosticReportClaim.Subject, DiagnosticReportClaim.Patient, subject);
+    }
+    /** Returns the subject or patient reference for this report. */
+    getSubject() {
+        return this.getSubjectClaims(DiagnosticReportClaim.Subject, DiagnosticReportClaim.Patient);
+    }
+    /** Sets the report status. */
+    setStatus(status) {
+        return this.setScalarClaim(DiagnosticReportClaim.Status, status);
+    }
+    /** Returns the report status. */
+    getStatus() {
+        return this.getScalarClaim(DiagnosticReportClaim.Status);
+    }
+    /** Sets the report date or effective time. */
+    setDate(date) {
+        return this.setScalarClaim(DiagnosticReportClaim.Date, date);
+    }
+    /** Returns the report date or effective time. */
+    getDate() {
+        return this.getScalarClaim(DiagnosticReportClaim.Date);
+    }
+    /** Sets the report category. */
+    setCategory(category) {
+        return this.setScalarClaim(DiagnosticReportClaim.Category, category);
+    }
+    /** Returns the report category. */
+    getCategory() {
+        return this.getScalarClaim(DiagnosticReportClaim.Category);
+    }
+    /** Sets the main report code. */
+    setCode(code) {
+        return this.setScalarClaim(DiagnosticReportClaim.Code, code);
+    }
+    /** Returns the main report code. */
+    getCode() {
+        return this.getScalarClaim(DiagnosticReportClaim.Code);
+    }
+    /** Sets the encounter reference linked to this report. */
+    setEncounter(reference) {
+        return this.setScalarClaim(DiagnosticReportClaim.Encounter, reference);
+    }
+    /** Returns the encounter reference linked to this report. */
+    getEncounter() {
+        return this.getScalarClaim(DiagnosticReportClaim.Encounter);
+    }
+    /** Replaces the performer reference list. */
+    setPerformerList(references) {
+        return this.setCsvClaimList(DiagnosticReportClaim.Performer, references);
+    }
+    /** Returns the performer reference list. */
+    getPerformerList() {
+        return this.getCsvClaimList(DiagnosticReportClaim.Performer);
+    }
+    /** Replaces the result reference list, often Observation references. */
+    setResultList(references) {
+        return this.setCsvClaimList(DiagnosticReportClaim.Result, references);
+    }
+    /** Returns the result reference list. */
+    getResultList() {
+        return this.getCsvClaimList(DiagnosticReportClaim.Result);
+    }
+    /** Replaces the specimen reference list. */
+    setSpecimenList(references) {
+        return this.setCsvClaimList(DiagnosticReportClaim.Specimen, references);
+    }
+    /** Returns the specimen reference list. */
+    getSpecimenList() {
+        return this.getCsvClaimList(DiagnosticReportClaim.Specimen);
+    }
+    /** @deprecated Use the shared contained-resource reference surface on `ClinicalResourceEntryEditor`. */
+    setContainedDocumentIdentifierList(identifiers) {
+        return this.setCsvClaimList(DiagnosticReportClaim.ContainedDocuments, identifiers);
+    }
+    /** @deprecated Use the shared contained-resource reference surface on `ClinicalResourceEntryEditor`. */
+    getContainedDocumentIdentifierList() {
+        return this.getCsvClaimList(DiagnosticReportClaim.ContainedDocuments);
+    }
+    /** Sets the MIME type for one attached presented form. */
+    setPresentedFormContentType(contentType) {
+        return this.setScalarClaim(DiagnosticReportClaim.PresentedFormContentType, contentType);
+    }
+    /** Returns the MIME type for the attached presented form. */
+    getPresentedFormContentType() {
+        return this.getScalarClaim(DiagnosticReportClaim.PresentedFormContentType);
+    }
+    /** Sets the inline base64 payload for one attached presented form. */
+    setPresentedFormData(data) {
+        return this.setScalarClaim(DiagnosticReportClaim.PresentedFormData, data);
+    }
+    /** Returns the inline base64 payload for the attached presented form. */
+    getPresentedFormData() {
+        return this.getScalarClaim(DiagnosticReportClaim.PresentedFormData);
+    }
+    /** Sets the external URL for one attached presented form. */
+    setPresentedFormUrl(url) {
+        return this.setScalarClaim(DiagnosticReportClaim.PresentedFormUrl, url);
+    }
+    /** Returns the external URL for the attached presented form. */
+    getPresentedFormUrl() {
+        return this.getScalarClaim(DiagnosticReportClaim.PresentedFormUrl);
+    }
+}
+registerBundleEntryEditor(BundleEditableResourceTypes.diagnosticReport, DiagnosticReportEntryEditor);

package/dist/utils/did.d.ts

@@ -59,6 +59,14 @@ export declare function createHostedDidWeb(hostDidWeb: string, tenantId: string,
     version: string;
     sector: string;
 }): string;
+/**
+ * Extracts the tenant identifier from one hosted `did:web`.
+ *
+ * This is a compatibility helper for places that still receive a full hosted
+ * DID where a route tenant id is expected. It only returns the tenant segment
+ * used by the hosted organization form.
+ */
+export declare function extractTenantIdFromHostedDidWeb(did: string): string | undefined;
 /**
  * Builds the canonical hosted provider DID root used by hosted tenant services.
  *

package/dist/utils/did.js

@@ -111,6 +111,28 @@ export function createHostedDidWeb(hostDidWeb, tenantId, context) {
     const didPath = `cds-${context.jurisdiction}:${context.version}:${context.sector}`;
     return `did:web:${hostPart}:${tenantId}:${didPath}`;
 }
+/**
+ * Extracts the tenant identifier from one hosted `did:web`.
+ *
+ * This is a compatibility helper for places that still receive a full hosted
+ * DID where a route tenant id is expected. It only returns the tenant segment
+ * used by the hosted organization form.
+ */
+export function extractTenantIdFromHostedDidWeb(did) {
+    const normalizedDid = String(did || '').trim();
+    if (!normalizedDid.startsWith('did:web:')) {
+        return undefined;
+    }
+    const didParts = normalizedDid.slice('did:web:'.length).split(':');
+    if (didParts.length < 2) {
+        return undefined;
+    }
+    const tenantId = String(didParts[1] || '').trim();
+    if (!tenantId || /^cds-/i.test(tenantId)) {
+        return undefined;
+    }
+    return decodeURIComponent(tenantId);
+}
 /**
  * Builds the canonical hosted provider DID root used by hosted tenant services.
  *

package/dist/utils/document-reference-entry-editor.d.ts

@@ -0,0 +1,62 @@
+/**
+ * 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 DocumentReference resource entry.
+ *
+ * Use this surface when the frontend needs to attach one PDF, image, VC, or
+ * other document-like payload to a clinical document or Communication flow.
+ */
+export declare class DocumentReferenceEntryEditor 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 document entry. */
+    getIdentifier(): string | undefined;
+    /** Ensures the entry has one synchronized canonical identifier across public claim, `resource.id`, and `fullUrl`. */
+    ensureIdentifier(): string;
+    /** Sets the subject reference for the attached document. */
+    setSubject(subject?: string | null): this;
+    /** Returns the subject reference for the attached document. */
+    getSubject(): string | undefined;
+    /** Sets the coded document type. */
+    setType(value?: string | null): this;
+    /** Returns the coded document type. */
+    getType(): string | undefined;
+    /** Sets the document category. */
+    setCategory(value?: string | null): this;
+    /** Returns the document category. */
+    getCategory(): string | undefined;
+    /** Sets the MIME type of the attached payload, such as PDF or image content. */
+    setContentType(value?: string | null): this;
+    /** Returns the MIME type of the attached payload. */
+    getContentType(): string | undefined;
+    /** Sets the inline base64 payload when the document travels inside the bundle. */
+    setContentData(value?: string | null): this;
+    /** Returns the inline base64 payload when present. */
+    getContentData(): string | undefined;
+    /** Sets the content hash or CID-like value used for integrity and external retrieval. */
+    setContentHash(value?: string | null): this;
+    /** Returns the content hash or CID-like value. */
+    getContentHash(): string | undefined;
+    /** Sets the external location/URL when the payload is not embedded inline. */
+    setLocation(value?: string | null): this;
+    /** Returns the external location/URL when present. */
+    getLocation(): string | undefined;
+    /** Sets the user-facing description for the attached document. */
+    setDescription(value?: string | null): this;
+    /** Returns the user-facing description for the attached document. */
+    getDescription(): string | undefined;
+    /** Sets the document date. */
+    setDate(value?: string | null): this;
+    /** Returns the document date. */
+    getDate(): string | undefined;
+    /** Sets the document author reference. */
+    setAuthor(value?: string | null): this;
+    /** Returns the document author reference. */
+    getAuthor(): string | undefined;
+}

package/dist/utils/document-reference-entry-editor.js

@@ -0,0 +1,66 @@
+/**
+ * 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.js';
+import { DocumentReferenceClaim } from '../models/interoperable-claims/document-reference-claims.js';
+import { BundleEditableResourceTypes } from '../models/bundle-editor-types.js';
+import { registerBundleEntryEditor } from './bundle-editor-registry.js';
+/**
+ * Typed editor for one staged DocumentReference resource entry.
+ *
+ * Use this surface when the frontend needs to attach one PDF, image, VC, or
+ * other document-like payload to a clinical document or Communication flow.
+ */
+export class DocumentReferenceEntryEditor extends ClinicalResourceEntryEditor {
+    /** Overrides the canonical identifier when import or migration logic needs one explicit public id. */
+    setIdentifier(identifier) { return this.setIdentifierValue(DocumentReferenceClaim.Identifier, identifier); }
+    /** Returns the canonical identifier currently exposed for this document entry. */
+    getIdentifier() { return this.getIdentifierValue(DocumentReferenceClaim.Identifier); }
+    /** Ensures the entry has one synchronized canonical identifier across public claim, `resource.id`, and `fullUrl`. */
+    ensureIdentifier() { return this.ensureIdentifierValue(DocumentReferenceClaim.Identifier); }
+    /** Sets the subject reference for the attached document. */
+    setSubject(subject) { return this.setScalarClaim(DocumentReferenceClaim.Subject, subject); }
+    /** Returns the subject reference for the attached document. */
+    getSubject() { return this.getScalarClaim(DocumentReferenceClaim.Subject); }
+    /** Sets the coded document type. */
+    setType(value) { return this.setScalarClaim(DocumentReferenceClaim.Type, value); }
+    /** Returns the coded document type. */
+    getType() { return this.getScalarClaim(DocumentReferenceClaim.Type); }
+    /** Sets the document category. */
+    setCategory(value) { return this.setScalarClaim(DocumentReferenceClaim.Category, value); }
+    /** Returns the document category. */
+    getCategory() { return this.getScalarClaim(DocumentReferenceClaim.Category); }
+    /** Sets the MIME type of the attached payload, such as PDF or image content. */
+    setContentType(value) { return this.setScalarClaim(DocumentReferenceClaim.ContentType, value); }
+    /** Returns the MIME type of the attached payload. */
+    getContentType() { return this.getScalarClaim(DocumentReferenceClaim.ContentType); }
+    /** Sets the inline base64 payload when the document travels inside the bundle. */
+    setContentData(value) { return this.setScalarClaim(DocumentReferenceClaim.ContentData, value); }
+    /** Returns the inline base64 payload when present. */
+    getContentData() { return this.getScalarClaim(DocumentReferenceClaim.ContentData); }
+    /** Sets the content hash or CID-like value used for integrity and external retrieval. */
+    setContentHash(value) { return this.setScalarClaim(DocumentReferenceClaim.ContentHash, value); }
+    /** Returns the content hash or CID-like value. */
+    getContentHash() { return this.getScalarClaim(DocumentReferenceClaim.ContentHash); }
+    /** Sets the external location/URL when the payload is not embedded inline. */
+    setLocation(value) { return this.setScalarClaim(DocumentReferenceClaim.Location, value); }
+    /** Returns the external location/URL when present. */
+    getLocation() { return this.getScalarClaim(DocumentReferenceClaim.Location); }
+    /** Sets the user-facing description for the attached document. */
+    setDescription(value) { return this.setScalarClaim(DocumentReferenceClaim.Description, value); }
+    /** Returns the user-facing description for the attached document. */
+    getDescription() { return this.getScalarClaim(DocumentReferenceClaim.Description); }
+    /** Sets the document date. */
+    setDate(value) { return this.setScalarClaim(DocumentReferenceClaim.Date, value); }
+    /** Returns the document date. */
+    getDate() { return this.getScalarClaim(DocumentReferenceClaim.Date); }
+    /** Sets the document author reference. */
+    setAuthor(value) { return this.setScalarClaim(DocumentReferenceClaim.Author, value); }
+    /** Returns the document author reference. */
+    getAuthor() { return this.getScalarClaim(DocumentReferenceClaim.Author); }
+}
+registerBundleEntryEditor(BundleEditableResourceTypes.documentReference, DocumentReferenceEntryEditor);

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

@@ -0,0 +1,36 @@
+import { BundleEntryEditor } from './bundle-entry-editor';
+/**
+ * Typed editor for one staged Employee resource entry.
+ *
+ * Use this when a caller needs to stage one employee row with claims-first
+ * accessors in a bundle authoring flow.
+ */
+export declare class EmployeeEntryEditor extends BundleEntryEditor {
+    /**
+     * Writes the canonical employee identifier.
+     *
+     * The identifier is synchronized across:
+     * - `entry.fullUrl`
+     * - `resource.id`
+     * - `org.schema.Person.identifier`
+     */
+    setIdentifier(identifier?: string | null): this;
+    /** Reads the canonical employee identifier from claims, resource id, or fullUrl. */
+    getIdentifier(): string | undefined;
+    /** Ensures the employee entry carries one canonical `urn:uuid:*` identifier. */
+    ensureIdentifier(): string;
+    /** Writes the canonical employee email claim on this entry. */
+    setEmail(email: string): this;
+    /** Reads the canonical employee email claim from this entry. */
+    getEmail(): string | undefined;
+    /** Writes the canonical employee occupational role claim on this entry. */
+    setRole(role: string): this;
+    /** Reads the canonical employee occupational role claim from this entry. */
+    getRole(): string | undefined;
+    /** Writes the canonical employee `worksFor` claim on this entry. */
+    setWorksFor(worksFor: string): this;
+    /** Writes the canonical employee `memberOf` claim on this entry. */
+    setMemberOf(memberOf: string): this;
+    /** Writes the canonical employee organization tax id claim on this entry. */
+    setMemberOfOrgTaxId(taxId: string): this;
+}