gdc-common-utils-ts 2.1.0 → 2.3.0

package/dist/models/confidential-storage.d.ts

@@ -134,6 +134,7 @@ export interface ConfidentialBlobInfo {
     contentType?: string;
 }
 export interface ConfidentialStorageDoc {
+    /** Vault primary key for the persisted confidential record. Keep this as an opaque technical id; HMAC is reserved for indexed attributes, not for the document key itself. */
     id: string;
     status: string;
     /**
@@ -149,7 +150,7 @@ export interface ConfidentialStorageDoc {
     chunks?: number;
     /** A number that MUST be incremented each time the document is updated. */
     sequence: number;
-    /** Contains an array of indexed attributes protected with HMAC for blind queries. */
+    /** Contains an array of indexed attributes protected with HMAC for blind queries. This is the place for blind-search protection, not `id`. */
     indexed?: IndexedData;
     /** The main, potentially encrypted, content of the document. */
     content?: Record<string, any>;

package/dist/models/consent-rule.d.ts

@@ -16,9 +16,17 @@ export declare enum ClaimConsent {
     'identifier' = "Consent.identifier",
     'eventBasedOn' = "Consent.event-basedon",
     'sourceReference' = "Consent.source-reference",
+    'containedReferenceList' = "Consent.contained-reference-list",
+    /**
+     * @deprecated Use `containedReferenceList`.
+     */
+    'containedResourceList' = "Consent.contained-resource-list",
+    /**
+     * @deprecated Use `containedReferenceList`.
+     */
     'containedDocuments' = "Consent.contained-documents",
     /**
-     * @deprecated Use `containedDocuments`.
+     * @deprecated Use `containedReferenceList`.
      */
     'attachmentContentIds' = "Consent.attachment-content-ids",
     'attachmentContentType' = "Consent.attachment-contenttype",
@@ -128,6 +136,8 @@ export interface ConsentRule {
      * Derived from the `org.hl7.fhir.api.Consent.identifier` claim.
      */
     'Consent.identifier': string;
+    'Consent.contained-reference-list'?: string;
+    'Consent.contained-resource-list'?: string;
     'Consent.contained-documents'?: string;
     'Consent.attachment-content-ids'?: string;
     'Consent.attachment-contenttype'?: string;

package/dist/models/consent-rule.js

@@ -18,9 +18,17 @@ export var ClaimConsent;
     ClaimConsent["identifier"] = "Consent.identifier";
     ClaimConsent["eventBasedOn"] = "Consent.event-basedon";
     ClaimConsent["sourceReference"] = "Consent.source-reference";
+    ClaimConsent["containedReferenceList"] = "Consent.contained-reference-list";
+    /**
+     * @deprecated Use `containedReferenceList`.
+     */
+    ClaimConsent["containedResourceList"] = "Consent.contained-resource-list";
+    /**
+     * @deprecated Use `containedReferenceList`.
+     */
     ClaimConsent["containedDocuments"] = "Consent.contained-documents";
     /**
-     * @deprecated Use `containedDocuments`.
+     * @deprecated Use `containedReferenceList`.
      */
     ClaimConsent["attachmentContentIds"] = "Consent.attachment-content-ids";
     ClaimConsent["attachmentContentType"] = "Consent.attachment-contenttype";

package/dist/models/device-license.d.ts

@@ -42,6 +42,16 @@ export interface DeviceLicense {
      * @example "acme"
      */
     tenantId: string;
+    /**
+     * Organization that owns this seat pool.
+     *
+     * This is essential for hosted individual organizations because many
+     * households can share one UNID tenant vault. It is distinct from
+     * `subjectId`, which identifies the member currently assigned to the seat.
+     */
+    ownerOrganizationId?: string;
+    /** Subject/card DID made accessible when this member invitation is accepted. */
+    authorizedSubjectDid?: string;
     /**
      * Identifier for the purchase order or invoice that generated this license.
      * All licenses created from the same purchase will share the same orderId.
@@ -116,6 +126,16 @@ export interface DeviceLicense {
      * Populated when the status becomes 'issued'.
      */
     subjectId?: string;
+    /** Verified email selected from the invited contact, when email is used. */
+    issuedToEmail?: string;
+    /** Verified ITU telephone selected from the invited contact, when phone is used. */
+    issuedToPhone?: string;
+    /** Canonical FHIR v3 or ISCO role used to choose the owning license pool. */
+    issuedToRole?: string;
+    /** Relationship invitation workflow that reserved this seat. */
+    invitationId?: string;
+    /** RelatedPerson/contact selected before the invitation was sent. */
+    relatedPersonId?: string;
     /**
      * The unique identifier (`client_id`) of the device registered with this license.
      * Populated when the status becomes 'active'.

package/dist/models/index.d.ts

@@ -1,7 +1,9 @@
 export * from './actor-session';
 export * from './aes';
 export * from './auth';
+export * from './authority-resolution';
 export * from './bundle';
+export * from './bundle-editor-types';
 export * from './comm';
 export * from './clinical-sections';
 export * from './clinical-sections.en';

package/dist/models/index.js

@@ -1,7 +1,9 @@
 export * from './actor-session.js';
 export * from './aes.js';
 export * from './auth.js';
+export * from './authority-resolution.js';
 export * from './bundle.js';
+export * from './bundle-editor-types.js';
 export * from './comm.js';
 export * from './clinical-sections.js';
 export * from './clinical-sections.en.js';

package/dist/models/individual-onboarding.d.ts

@@ -73,9 +73,27 @@ export interface IndividualFormTemplateFields {
     controllerSexAtBirth?: BirthSex | string;
     controllerIsSubject?: boolean;
     subjectAlternateName?: string;
+    /**
+     * Birth date for the indexed subject.
+     *
+     * Canonical downstream target:
+     * - `org.schema.Organization.member.birthDate`
+     *
+     * When `controllerIsSubject=true`, controller date fields may also be used
+     * as the subject seed for self-registration flows.
+     */
     subjectDateOfBirth?: string;
     subjectEmail?: string;
     subjectFamilyName?: string;
+    /**
+     * Gender for the indexed subject.
+     *
+     * Canonical downstream target:
+     * - `org.schema.Organization.member.gender`
+     *
+     * When `controllerIsSubject=true`, controller gender fields may also be used
+     * as the subject seed for self-registration flows.
+     */
     subjectGender?: GenderIdentity | string;
     subjectGivenName?: string;
     subjectIdType?: IdKindValue | string;

package/dist/models/interoperable-claims/allergy-intolerance-claims.d.ts

@@ -11,9 +11,20 @@ export declare const AllergyIntoleranceClaim: {
     readonly ClinicalStatus: "AllergyIntolerance.clinical-status";
     readonly VerificationStatus: "AllergyIntolerance.verification-status";
     readonly Category: "AllergyIntolerance.category";
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    readonly ContainedReferenceList: "AllergyIntolerance.contained-reference-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedResourceList: "AllergyIntolerance.contained-resource-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
     readonly ContainedDocuments: "AllergyIntolerance.contained-documents";
     /**
-     * @deprecated Use `ContainedDocuments`.
+     * @deprecated Use `ContainedReferenceList`.
      */
     readonly AttachmentContentIds: "AllergyIntolerance.attachment-content-ids";
     readonly Criticality: "AllergyIntolerance.criticality";

package/dist/models/interoperable-claims/allergy-intolerance-claims.js

@@ -13,9 +13,20 @@ export const AllergyIntoleranceClaim = {
     ClinicalStatus: 'AllergyIntolerance.clinical-status',
     VerificationStatus: 'AllergyIntolerance.verification-status',
     Category: 'AllergyIntolerance.category',
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    ContainedReferenceList: 'AllergyIntolerance.contained-reference-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    ContainedResourceList: 'AllergyIntolerance.contained-resource-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
     ContainedDocuments: 'AllergyIntolerance.contained-documents',
     /**
-     * @deprecated Use `ContainedDocuments`.
+     * @deprecated Use `ContainedReferenceList`.
      */
     AttachmentContentIds: 'AllergyIntolerance.attachment-content-ids',
     Criticality: 'AllergyIntolerance.criticality',

package/dist/models/interoperable-claims/condition-claims.d.ts

@@ -6,9 +6,20 @@ export declare const ConditionClaim: {
     readonly VerificationStatus: "Condition.verification-status";
     readonly Category: "Condition.category";
     readonly Code: "Condition.code";
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    readonly ContainedReferenceList: "Condition.contained-reference-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedResourceList: "Condition.contained-resource-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
     readonly ContainedDocuments: "Condition.contained-documents";
     /**
-     * @deprecated Use `ContainedDocuments`.
+     * @deprecated Use `ContainedReferenceList`.
      */
     readonly AttachmentContentIds: "Condition.attachment-content-ids";
     readonly Severity: "Condition.severity";

package/dist/models/interoperable-claims/condition-claims.js

@@ -8,9 +8,20 @@ export const ConditionClaim = {
     VerificationStatus: 'Condition.verification-status',
     Category: 'Condition.category',
     Code: 'Condition.code',
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    ContainedReferenceList: 'Condition.contained-reference-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    ContainedResourceList: 'Condition.contained-resource-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
     ContainedDocuments: 'Condition.contained-documents',
     /**
-     * @deprecated Use `ContainedDocuments`.
+     * @deprecated Use `ContainedReferenceList`.
      */
     AttachmentContentIds: 'Condition.attachment-content-ids',
     Severity: 'Condition.severity',

package/dist/models/interoperable-claims/diagnostic-report-claims.d.ts

@@ -17,6 +17,17 @@ export declare const DiagnosticReportClaim: {
     readonly PresentedFormContentType: "DiagnosticReport.presented-form-contenttype";
     readonly PresentedFormData: "DiagnosticReport.presented-form-data";
     readonly PresentedFormUrl: "DiagnosticReport.presented-form-url";
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    readonly ContainedReferenceList: "DiagnosticReport.contained-reference-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedResourceList: "DiagnosticReport.contained-resource-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
     readonly ContainedDocuments: "DiagnosticReport.contained-documents";
 };
 /**
@@ -31,7 +42,7 @@ export declare const DiagnosticReportClaim: {
  *   - `get/set/add/removeDiagnosticReportResultList`
  *   - `get/set/add/removeDiagnosticReportPerformerList`
  *   - `get/set/add/removeDiagnosticReportSpecimenList`
- *   - `get/set/add/removeDiagnosticReportContainedDocuments`
+ *   - `get/set/add/removeDiagnosticReportContainedResourceReferences`
  *   - `get/setDiagnosticReportPresentedFormContentType`
  *   - `get/setDiagnosticReportPresentedFormData`
  *   - `get/setDiagnosticReportPresentedFormUrl`
@@ -87,7 +98,7 @@ export declare const DiagnosticReportSearchParamToClaimKey: Record<DiagnosticRep
  *
  * Do not invent camelCase names. Prefer official FHIR search parameter names
  * or explicit attachment aliases such as `presented-form-*` and
- * `contained-documents`.
+ * `contained-reference-list`.
  *
  * Keep `DiagnosticReport` paused at the typing/mapping layer until:
  * 1. `claims-helpers-diagnostic-report.ts` exists

package/dist/models/interoperable-claims/diagnostic-report-claims.js

@@ -18,6 +18,17 @@ export const DiagnosticReportClaim = {
     PresentedFormContentType: 'DiagnosticReport.presented-form-contenttype',
     PresentedFormData: 'DiagnosticReport.presented-form-data',
     PresentedFormUrl: 'DiagnosticReport.presented-form-url',
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     */
+    ContainedReferenceList: 'DiagnosticReport.contained-reference-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    ContainedResourceList: 'DiagnosticReport.contained-resource-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
     ContainedDocuments: 'DiagnosticReport.contained-documents',
 };
 export const DiagnosticReportClaimSpecs = [
@@ -96,7 +107,7 @@ export const DiagnosticReportSearchParamToClaimKey = {
  *
  * Do not invent camelCase names. Prefer official FHIR search parameter names
  * or explicit attachment aliases such as `presented-form-*` and
- * `contained-documents`.
+ * `contained-reference-list`.
  *
  * Keep `DiagnosticReport` paused at the typing/mapping layer until:
  * 1. `claims-helpers-diagnostic-report.ts` exists

package/dist/models/interoperable-claims/document-reference-claims.d.ts

@@ -22,6 +22,7 @@ export declare const DocumentReferenceClaim: {
     readonly Relation: "DocumentReference.relation";
     readonly Subject: "DocumentReference.subject";
     readonly Type: "DocumentReference.type";
+    readonly UserSelected: "DocumentReference.user-selected";
 };
 export type DocumentReferenceClaimKey = typeof DocumentReferenceClaim[keyof typeof DocumentReferenceClaim];
 /**

package/dist/models/interoperable-claims/document-reference-claims.js

@@ -24,6 +24,7 @@ export const DocumentReferenceClaim = {
     Relation: 'DocumentReference.relation',
     Subject: 'DocumentReference.subject',
     Type: 'DocumentReference.type',
+    UserSelected: 'DocumentReference.user-selected',
 };
 /**
  * Human-readable reference for UI/docs generators.
@@ -52,6 +53,7 @@ export const DocumentReferenceClaimSpecs = [
     { key: DocumentReferenceClaim.Relation, meaning: 'Relation type to related document.', example: 'appends' },
     { key: DocumentReferenceClaim.Subject, meaning: 'URN for the section in the individual index.', example: 'urn:uhix:section:vitals' },
     { key: DocumentReferenceClaim.Type, meaning: 'Lower-level, sector-specific type.', example: 'http://hl7.org/fhir/ValueSet/c80-doc-typecodes|34133-9' },
+    { key: DocumentReferenceClaim.UserSelected, meaning: 'Custom provenance flag telling whether the document was explicitly created or selected by the end user/controller.', example: 'true' },
 ];
 /**
  * Optional mapping helper when converting claims-first payloads to strict FHIR JSON.
@@ -86,4 +88,5 @@ export const DocumentReferenceClaimToFhirPath = {
     [DocumentReferenceClaim.Relation]: 'DocumentReference.relatesTo.code',
     [DocumentReferenceClaim.Subject]: 'DocumentReference.subject.reference',
     [DocumentReferenceClaim.Type]: 'DocumentReference.type.coding',
+    [DocumentReferenceClaim.UserSelected]: 'DocumentReference.user-selected',
 };

package/dist/models/interoperable-claims/medication-statement-claims.d.ts

@@ -14,6 +14,7 @@ export declare const MedicationStatementClaim: {
     readonly PartOf: "MedicationStatement.part-of";
     readonly Source: "MedicationStatement.source";
     readonly MedicationText: "MedicationStatement.medication-text";
+    readonly UserSelected: "MedicationStatement.user-selected";
     /**
      * Free-text clinical note.
      *
@@ -27,6 +28,22 @@ export declare const MedicationStatementClaim: {
      * `TimingPeriodUnit`, and `DosagePatientInstructionText`.
      */
     readonly Note: "MedicationStatement.note";
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     *
+     * Values may be:
+     * - `urn:uuid:*`
+     * - `ResourceType/urn:uuid:*`
+     * - another canonical local resource reference used inside the same bundle
+     */
+    readonly ContainedReferenceList: "MedicationStatement.contained-reference-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    readonly ContainedResourceList: "MedicationStatement.contained-resource-list";
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
     readonly ContainedDocuments: "MedicationStatement.contained-documents";
     /**
      * @deprecated Use `ContainedDocuments`.

package/dist/models/interoperable-claims/medication-statement-claims.js

@@ -16,6 +16,7 @@ export const MedicationStatementClaim = {
     PartOf: 'MedicationStatement.part-of',
     Source: 'MedicationStatement.source',
     MedicationText: 'MedicationStatement.medication-text',
+    UserSelected: 'MedicationStatement.user-selected',
     /**
      * Free-text clinical note.
      *
@@ -29,6 +30,22 @@ export const MedicationStatementClaim = {
      * `TimingPeriodUnit`, and `DosagePatientInstructionText`.
      */
     Note: 'MedicationStatement.note',
+    /**
+     * Canonical CSV/list of related contained resource references or identifiers.
+     *
+     * Values may be:
+     * - `urn:uuid:*`
+     * - `ResourceType/urn:uuid:*`
+     * - another canonical local resource reference used inside the same bundle
+     */
+    ContainedReferenceList: 'MedicationStatement.contained-reference-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
+    ContainedResourceList: 'MedicationStatement.contained-resource-list',
+    /**
+     * @deprecated Use `ContainedReferenceList`.
+     */
     ContainedDocuments: 'MedicationStatement.contained-documents',
     /**
      * @deprecated Use `ContainedDocuments`.

package/dist/models/interoperable-claims/related-person-claims.d.ts

@@ -6,11 +6,24 @@ export declare const RelatedPersonClaim: {
     readonly Active: "RelatedPerson.active";
     readonly Patient: "RelatedPerson.patient";
     readonly Relationship: "RelatedPerson.relationship";
+    /**
+     * GDC flat-claim extension for comma-separated functional HL7 role codes.
+     * FHIR R4 RelatedPerson has no native `role` property; relationship/kinship
+     * remains in `RelatedPerson.relationship`.
+     */
+    readonly Role: "RelatedPerson.role";
     readonly Name: "RelatedPerson.name";
     readonly Telecom: "RelatedPerson.telecom";
     readonly Gender: "RelatedPerson.gender";
     readonly BirthDate: "RelatedPerson.birthdate";
     readonly Address: "RelatedPerson.address";
+    /** Logical kind used when a RelatedPerson record acts as a related entity. */
+    readonly RelatedEntityType: "RelatedPerson.related-entity-type";
+    /**
+     * Original public values used to calculate the Consent rule/asset id.
+     * These values must not be replaced by the opaque RelatedPerson resource id.
+     */
+    readonly ActorIdentifier: "RelatedPerson.actor-identifier";
 };
 export type RelatedPersonClaimKey = typeof RelatedPersonClaim[keyof typeof RelatedPersonClaim];
 export declare const RelatedPersonClaimSpecs: ClaimSpec[];

package/dist/models/interoperable-claims/related-person-claims.js

@@ -7,11 +7,24 @@ export const RelatedPersonClaim = {
     Active: 'RelatedPerson.active',
     Patient: 'RelatedPerson.patient',
     Relationship: 'RelatedPerson.relationship',
+    /**
+     * GDC flat-claim extension for comma-separated functional HL7 role codes.
+     * FHIR R4 RelatedPerson has no native `role` property; relationship/kinship
+     * remains in `RelatedPerson.relationship`.
+     */
+    Role: 'RelatedPerson.role',
     Name: 'RelatedPerson.name',
     Telecom: 'RelatedPerson.telecom',
     Gender: 'RelatedPerson.gender',
     BirthDate: 'RelatedPerson.birthdate',
     Address: 'RelatedPerson.address',
+    /** Logical kind used when a RelatedPerson record acts as a related entity. */
+    RelatedEntityType: 'RelatedPerson.related-entity-type',
+    /**
+     * Original public values used to calculate the Consent rule/asset id.
+     * These values must not be replaced by the opaque RelatedPerson resource id.
+     */
+    ActorIdentifier: 'RelatedPerson.actor-identifier',
 };
 export const RelatedPersonClaimSpecs = [
     { key: RelatedPersonClaim.IdentifierValue, meaning: 'Business identifier value.', example: 'rel-001' },
@@ -19,9 +32,12 @@ export const RelatedPersonClaimSpecs = [
     { key: RelatedPersonClaim.Active, meaning: 'Active flag.', example: 'true' },
     { key: RelatedPersonClaim.Patient, meaning: 'Linked patient reference.', example: 'did:web:patient.example.org' },
     { key: RelatedPersonClaim.Relationship, meaning: 'Relationship token.', example: 'http://terminology.hl7.org/CodeSystem/v3-RoleCode|MTH' },
+    { key: RelatedPersonClaim.Role, meaning: 'Comma-separated functional HL7 role values; this is a GDC flat-claim extension, not a native FHIR R4 RelatedPerson property. Known codes resolve to their canonical RoleClass or RoleCode system.', example: 'CAREGIVER,ECON,BILL' },
     { key: RelatedPersonClaim.Name, meaning: 'Display name.', example: 'Jane Doe' },
     { key: RelatedPersonClaim.Telecom, meaning: 'Contact value.', example: 'mailto:jane@example.org' },
     { key: RelatedPersonClaim.Gender, meaning: 'Administrative gender.', example: 'female' },
     { key: RelatedPersonClaim.BirthDate, meaning: 'Birth date.', example: '1980-02-01' },
     { key: RelatedPersonClaim.Address, meaning: 'Display address.', example: '123 Main St, Vancouver' },
+    { key: RelatedPersonClaim.RelatedEntityType, meaning: 'Logical related-entity kind.', example: 'country-set' },
+    { key: RelatedPersonClaim.ActorIdentifier, meaning: 'Original public Consent actor identifiers as CSV.', example: 'ES,PT' },
 ];

package/dist/utils/allergy-intolerance-entry-editor.d.ts

@@ -0,0 +1,51 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor';
+/**
+ * Typed editor for one staged AllergyIntolerance resource entry.
+ *
+ * Use this from frontend/BFF bundle-authoring flows when the caller needs one
+ * allergy row with canonical claims-first accessors.
+ */
+export declare class AllergyIntoleranceEntryEditor extends ClinicalResourceEntryEditor {
+    /** Writes the canonical allergy identifier. */
+    setIdentifier(identifier?: string | null): this;
+    /** Reads the canonical allergy identifier. */
+    getIdentifier(): string | undefined;
+    /** Ensures the allergy entry has one canonical `urn:uuid:*` identifier. */
+    ensureIdentifier(): string;
+    /** Writes the subject/patient reference for the allergy entry. */
+    setSubject(subject?: string | null): this;
+    /** Reads the subject/patient reference for the allergy entry. */
+    getSubject(): string | undefined;
+    /** Writes the coded allergy substance. */
+    setCode(code?: string | null): this;
+    /** Reads the coded allergy substance. */
+    getCode(): string | undefined;
+    /** Writes the clinical status. */
+    setClinicalStatus(status?: string | null): this;
+    /** Reads the clinical status. */
+    getClinicalStatus(): string | undefined;
+    /** Writes the verification status. */
+    setVerificationStatus(status?: string | null): this;
+    /** Reads the verification status. */
+    getVerificationStatus(): string | undefined;
+    /** Writes the allergy category. */
+    setCategory(category?: string | null): this;
+    /** Reads the allergy category. */
+    getCategory(): string | undefined;
+    /** Writes the allergy criticality. */
+    setCriticality(criticality?: string | null): this;
+    /** Reads the allergy criticality. */
+    getCriticality(): string | undefined;
+    /** Writes the onset date/time. */
+    setOnsetDateTime(value?: string | null): this;
+    /** Reads the onset date/time. */
+    getOnsetDateTime(): string | undefined;
+    /** Writes the recorder reference. */
+    setRecorder(reference?: string | null): this;
+    /** Reads the recorder reference. */
+    getRecorder(): string | undefined;
+    /** Writes the linked contained-document identifier list. */
+    setContainedDocumentIdentifierList(identifiers: readonly string[]): this;
+    /** Reads the linked contained-document identifier list. */
+    getContainedDocumentIdentifierList(): string[];
+}

package/dist/utils/allergy-intolerance-entry-editor.js

@@ -0,0 +1,55 @@
+import { ClinicalResourceEntryEditor } from './clinical-resource-entry-editor.js';
+import { AllergyIntoleranceClaim } from '../models/interoperable-claims/allergy-intolerance-claims.js';
+import { BundleEditableResourceTypes } from '../models/bundle-editor-types.js';
+import { registerBundleEntryEditor } from './bundle-editor-registry.js';
+/**
+ * Typed editor for one staged AllergyIntolerance resource entry.
+ *
+ * Use this from frontend/BFF bundle-authoring flows when the caller needs one
+ * allergy row with canonical claims-first accessors.
+ */
+export class AllergyIntoleranceEntryEditor extends ClinicalResourceEntryEditor {
+    /** Writes the canonical allergy identifier. */
+    setIdentifier(identifier) { return this.setIdentifierValue(AllergyIntoleranceClaim.Identifier, identifier); }
+    /** Reads the canonical allergy identifier. */
+    getIdentifier() { return this.getIdentifierValue(AllergyIntoleranceClaim.Identifier); }
+    /** Ensures the allergy entry has one canonical `urn:uuid:*` identifier. */
+    ensureIdentifier() { return this.ensureIdentifierValue(AllergyIntoleranceClaim.Identifier); }
+    /** Writes the subject/patient reference for the allergy entry. */
+    setSubject(subject) { return this.setSubjectClaims(AllergyIntoleranceClaim.Subject, AllergyIntoleranceClaim.Patient, subject); }
+    /** Reads the subject/patient reference for the allergy entry. */
+    getSubject() { return this.getSubjectClaims(AllergyIntoleranceClaim.Subject, AllergyIntoleranceClaim.Patient); }
+    /** Writes the coded allergy substance. */
+    setCode(code) { return this.setScalarClaim(AllergyIntoleranceClaim.Code, code); }
+    /** Reads the coded allergy substance. */
+    getCode() { return this.getScalarClaim(AllergyIntoleranceClaim.Code); }
+    /** Writes the clinical status. */
+    setClinicalStatus(status) { return this.setScalarClaim(AllergyIntoleranceClaim.ClinicalStatus, status); }
+    /** Reads the clinical status. */
+    getClinicalStatus() { return this.getScalarClaim(AllergyIntoleranceClaim.ClinicalStatus); }
+    /** Writes the verification status. */
+    setVerificationStatus(status) { return this.setScalarClaim(AllergyIntoleranceClaim.VerificationStatus, status); }
+    /** Reads the verification status. */
+    getVerificationStatus() { return this.getScalarClaim(AllergyIntoleranceClaim.VerificationStatus); }
+    /** Writes the allergy category. */
+    setCategory(category) { return this.setScalarClaim(AllergyIntoleranceClaim.Category, category); }
+    /** Reads the allergy category. */
+    getCategory() { return this.getScalarClaim(AllergyIntoleranceClaim.Category); }
+    /** Writes the allergy criticality. */
+    setCriticality(criticality) { return this.setScalarClaim(AllergyIntoleranceClaim.Criticality, criticality); }
+    /** Reads the allergy criticality. */
+    getCriticality() { return this.getScalarClaim(AllergyIntoleranceClaim.Criticality); }
+    /** Writes the onset date/time. */
+    setOnsetDateTime(value) { return this.setScalarClaim(AllergyIntoleranceClaim.OnsetDateTime, value); }
+    /** Reads the onset date/time. */
+    getOnsetDateTime() { return this.getScalarClaim(AllergyIntoleranceClaim.OnsetDateTime); }
+    /** Writes the recorder reference. */
+    setRecorder(reference) { return this.setScalarClaim(AllergyIntoleranceClaim.Recorder, reference); }
+    /** Reads the recorder reference. */
+    getRecorder() { return this.getScalarClaim(AllergyIntoleranceClaim.Recorder); }
+    /** Writes the linked contained-document identifier list. */
+    setContainedDocumentIdentifierList(identifiers) { return this.setCsvClaimList(AllergyIntoleranceClaim.ContainedReferenceList, identifiers); }
+    /** Reads the linked contained-document identifier list. */
+    getContainedDocumentIdentifierList() { return this.getCsvClaimList(AllergyIntoleranceClaim.ContainedReferenceList); }
+}
+registerBundleEntryEditor(BundleEditableResourceTypes.allergyIntolerance, AllergyIntoleranceEntryEditor);

package/dist/utils/authority-resolution.d.ts

@@ -0,0 +1,37 @@
+import type { AuthorityCatalogRecord, AuthorityResolution, AuthorityResolutionInput } from '../models/authority-resolution';
+/**
+ * Builds one authority/root `did:web` from a bare host authority or URL.
+ *
+ * Examples:
+ * - `https://gw.example.org` -> `did:web:gw.example.org`
+ * - `localhost:3300` -> `did:web:localhost%3A3300`
+ */
+export declare function buildAuthorityDidWeb(input: {
+    authority: string;
+}): string;
+/**
+ * Normalizes one authority base URL from either an explicit URL or one
+ * authority/root `did:web`.
+ */
+export declare function resolveAuthorityBaseUrl(input: {
+    authorityBaseUrl?: string;
+    authorityDidWeb?: string;
+}): string | undefined;
+/**
+ * Builds one compatibility authority resolution when the caller only knows:
+ * - tenant context
+ * - one base URL or one root authority `did:web`
+ *
+ * This helper intentionally keeps the current hosted-DID fallback in one place
+ * so app code does not have to hand-invent `did:web` strings.
+ */
+export declare function buildLegacyAuthorityResolution(input: AuthorityResolutionInput & Readonly<{
+    tenantId: string;
+    jurisdiction: string;
+    sector: string;
+}>): AuthorityResolution;
+/**
+ * Converts one resolution into a catalog-style record so runtimes can preload
+ * legacy fallback data into a shared resolver cache.
+ */
+export declare function authorityResolutionToCatalogRecord(resolution: AuthorityResolution): AuthorityCatalogRecord;