fhir-data-utils-ts 0.2.4 → 0.3.1

package/dist/claims/composition-claims.js

@@ -0,0 +1,27 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/composition-claims.ts
+export const CompositionClaim = {
+    Subject: 'Composition.subject',
+    Section: 'Composition.section',
+    Author: 'Composition.author',
+    /** CSV of Composition.attester.party references, aligned with AttesterMode and AttesterTime. */
+    Attester: 'Composition.attester',
+    /** CSV of required R4 Composition.attester.mode values, one per attester. */
+    AttesterMode: 'Composition.attester-mode',
+    /** CSV of optional R4 Composition.attester.time values, positionally aligned with AttesterMode. */
+    AttesterTime: 'Composition.attester-time',
+    /** Composition.custodian Organization reference. */
+    Custodian: 'Composition.custodian',
+    Date: 'Composition.date',
+    Entry: 'Composition.entry',
+    Type: 'Composition.type',
+    Identifier: 'Composition.identifier',
+    Title: 'Composition.title',
+};
+/** Canonical FHIR R4 Composition.attester.mode codes. */
+export const CompositionAttesterModes = Object.freeze({
+    Personal: 'personal',
+    Professional: 'professional',
+    Legal: 'legal',
+    Official: 'official',
+});

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

@@ -0,0 +1,79 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const ConditionClaim: {
+    readonly Identifier: "Condition.identifier";
+    readonly Subject: "Condition.subject";
+    readonly ClinicalStatus: "Condition.clinical-status";
+    readonly VerificationStatus: "Condition.verification-status";
+    readonly Category: "Condition.category";
+    readonly Code: "Condition.code";
+    /** Local-language label projected to FHIR `Condition.code.text`. */
+    readonly CodeText: "Condition.code-text";
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    readonly CodeTextLocal: "Condition.code-text";
+    /** English/international terminology label projected to `code.coding.display`. */
+    readonly CodeDisplay: "Condition.code-display";
+    /**
+     * 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 `ContainedReferenceList`.
+     */
+    readonly AttachmentContentIds: "Condition.attachment-content-ids";
+    readonly Severity: "Condition.severity";
+    readonly OnsetDateTime: "Condition.onset-datetime";
+    readonly RecordedDate: "Condition.recorded-date";
+    readonly Asserter: "Condition.asserter";
+    readonly Recorder: "Condition.recorder";
+};
+export type ConditionClaimKey = typeof ConditionClaim[keyof typeof ConditionClaim];
+export declare enum ConditionClaimsFhirApi {
+    Identifier = "org.hl7.fhir.api.Condition.identifier",
+    Subject = "org.hl7.fhir.api.Condition.subject",
+    ClinicalStatus = "org.hl7.fhir.api.Condition.clinical-status",
+    VerificationStatus = "org.hl7.fhir.api.Condition.verification-status",
+    Category = "org.hl7.fhir.api.Condition.category",
+    Code = "org.hl7.fhir.api.Condition.code",
+    CodeText = "org.hl7.fhir.api.Condition.code-text",
+    CodeDisplay = "org.hl7.fhir.api.Condition.code-display",
+    Severity = "org.hl7.fhir.api.Condition.severity",
+    OnsetDateTime = "org.hl7.fhir.api.Condition.onset-datetime",
+    Recorder = "org.hl7.fhir.api.Condition.recorder"
+}
+export declare const ConditionSearchParamNames: {
+    readonly Identifier: "identifier";
+    readonly Subject: "subject";
+    readonly ClinicalStatus: "clinical-status";
+    readonly VerificationStatus: "verification-status";
+    readonly Category: "category";
+    readonly Code: "code";
+    readonly CodeText: "code-text";
+    readonly CodeDisplay: "code-display";
+    readonly Severity: "severity";
+    readonly OnsetDateTime: "onset-datetime";
+    readonly Recorder: "recorder";
+};
+export type ConditionSearchParamName = typeof ConditionSearchParamNames[keyof typeof ConditionSearchParamNames];
+export declare const ConditionSearchParamToClaimKey: Record<ConditionSearchParamName, ConditionClaimsFhirApi>;
+export declare const ConditionClaimsFhirApiMap: {
+    "org.hl7.fhir.api.Condition.identifier": StringConstructor;
+    "org.hl7.fhir.api.Condition.subject": StringConstructor;
+    "org.hl7.fhir.api.Condition.clinical-status": StringConstructor;
+    "org.hl7.fhir.api.Condition.verification-status": StringConstructor;
+    "org.hl7.fhir.api.Condition.category": StringConstructor;
+    "org.hl7.fhir.api.Condition.code": StringConstructor;
+    "org.hl7.fhir.api.Condition.code-text": StringConstructor;
+    "org.hl7.fhir.api.Condition.code-display": StringConstructor;
+    "org.hl7.fhir.api.Condition.severity": StringConstructor;
+    "org.hl7.fhir.api.Condition.onset-datetime": StringConstructor;
+    "org.hl7.fhir.api.Condition.recorder": StringConstructor;
+};
+export declare const ConditionClaimSpecs: ClaimSpec[];

package/dist/claims/condition-claims.js

@@ -0,0 +1,104 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/condition-claims.ts
+// Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
+export const ConditionClaim = {
+    Identifier: 'Condition.identifier',
+    Subject: 'Condition.subject',
+    ClinicalStatus: 'Condition.clinical-status',
+    VerificationStatus: 'Condition.verification-status',
+    Category: 'Condition.category',
+    Code: 'Condition.code',
+    /** Local-language label projected to FHIR `Condition.code.text`. */
+    CodeText: 'Condition.code-text',
+    /** Alias that makes the local-language purpose explicit to UI authors. */
+    CodeTextLocal: 'Condition.code-text',
+    /** English/international terminology label projected to `code.coding.display`. */
+    CodeDisplay: 'Condition.code-display',
+    /**
+     * 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 `ContainedReferenceList`.
+     */
+    AttachmentContentIds: 'Condition.attachment-content-ids',
+    Severity: 'Condition.severity',
+    OnsetDateTime: 'Condition.onset-datetime',
+    RecordedDate: 'Condition.recorded-date',
+    Asserter: 'Condition.asserter',
+    Recorder: 'Condition.recorder',
+};
+export var ConditionClaimsFhirApi;
+(function (ConditionClaimsFhirApi) {
+    ConditionClaimsFhirApi["Identifier"] = "org.hl7.fhir.api.Condition.identifier";
+    ConditionClaimsFhirApi["Subject"] = "org.hl7.fhir.api.Condition.subject";
+    ConditionClaimsFhirApi["ClinicalStatus"] = "org.hl7.fhir.api.Condition.clinical-status";
+    ConditionClaimsFhirApi["VerificationStatus"] = "org.hl7.fhir.api.Condition.verification-status";
+    ConditionClaimsFhirApi["Category"] = "org.hl7.fhir.api.Condition.category";
+    ConditionClaimsFhirApi["Code"] = "org.hl7.fhir.api.Condition.code";
+    ConditionClaimsFhirApi["CodeText"] = "org.hl7.fhir.api.Condition.code-text";
+    ConditionClaimsFhirApi["CodeDisplay"] = "org.hl7.fhir.api.Condition.code-display";
+    ConditionClaimsFhirApi["Severity"] = "org.hl7.fhir.api.Condition.severity";
+    ConditionClaimsFhirApi["OnsetDateTime"] = "org.hl7.fhir.api.Condition.onset-datetime";
+    ConditionClaimsFhirApi["Recorder"] = "org.hl7.fhir.api.Condition.recorder";
+})(ConditionClaimsFhirApi || (ConditionClaimsFhirApi = {}));
+export const ConditionSearchParamNames = {
+    Identifier: 'identifier',
+    Subject: 'subject',
+    ClinicalStatus: 'clinical-status',
+    VerificationStatus: 'verification-status',
+    Category: 'category',
+    Code: 'code',
+    CodeText: 'code-text',
+    CodeDisplay: 'code-display',
+    Severity: 'severity',
+    OnsetDateTime: 'onset-datetime',
+    Recorder: 'recorder',
+};
+export const ConditionSearchParamToClaimKey = {
+    [ConditionSearchParamNames.Identifier]: ConditionClaimsFhirApi.Identifier,
+    [ConditionSearchParamNames.Subject]: ConditionClaimsFhirApi.Subject,
+    [ConditionSearchParamNames.ClinicalStatus]: ConditionClaimsFhirApi.ClinicalStatus,
+    [ConditionSearchParamNames.VerificationStatus]: ConditionClaimsFhirApi.VerificationStatus,
+    [ConditionSearchParamNames.Category]: ConditionClaimsFhirApi.Category,
+    [ConditionSearchParamNames.Code]: ConditionClaimsFhirApi.Code,
+    [ConditionSearchParamNames.CodeText]: ConditionClaimsFhirApi.CodeText,
+    [ConditionSearchParamNames.CodeDisplay]: ConditionClaimsFhirApi.CodeDisplay,
+    [ConditionSearchParamNames.Severity]: ConditionClaimsFhirApi.Severity,
+    [ConditionSearchParamNames.OnsetDateTime]: ConditionClaimsFhirApi.OnsetDateTime,
+    [ConditionSearchParamNames.Recorder]: ConditionClaimsFhirApi.Recorder,
+};
+export const ConditionClaimsFhirApiMap = {
+    [ConditionClaimsFhirApi.Identifier]: String,
+    [ConditionClaimsFhirApi.Subject]: String,
+    [ConditionClaimsFhirApi.ClinicalStatus]: String,
+    [ConditionClaimsFhirApi.VerificationStatus]: String,
+    [ConditionClaimsFhirApi.Category]: String,
+    [ConditionClaimsFhirApi.Code]: String,
+    [ConditionClaimsFhirApi.CodeText]: String,
+    [ConditionClaimsFhirApi.CodeDisplay]: String,
+    [ConditionClaimsFhirApi.Severity]: String,
+    [ConditionClaimsFhirApi.OnsetDateTime]: String,
+    [ConditionClaimsFhirApi.Recorder]: String,
+};
+export const ConditionClaimSpecs = [
+    { key: ConditionClaim.Identifier, meaning: 'Business identifier for condition record.', example: 'COND-0001' },
+    { key: ConditionClaim.Subject, meaning: 'Patient subject reference.', example: 'Patient/pat-123' },
+    { key: ConditionClaim.ClinicalStatus, meaning: 'Clinical status code.', example: 'active' },
+    { key: ConditionClaim.VerificationStatus, meaning: 'Verification status code.', example: 'confirmed' },
+    { key: ConditionClaim.Category, meaning: 'Condition category code.', example: 'problem-list-item' },
+    { key: ConditionClaim.Code, meaning: 'Condition code.', example: 'http://snomed.info/sct|44054006' },
+    { key: ConditionClaim.CodeText, meaning: 'Local-language condition label matching the resource language.', example: 'Diabetes mellitus tipo 2' },
+    { key: ConditionClaim.CodeDisplay, meaning: 'English/international terminology display.', example: 'Type 2 diabetes mellitus' },
+    { key: ConditionClaim.Severity, meaning: 'Condition severity code.', example: 'http://snomed.info/sct|24484000' },
+    { key: ConditionClaim.OnsetDateTime, meaning: 'Onset date/time.', example: '2026-01-03T09:30:00Z' },
+    { key: ConditionClaim.Recorder, meaning: 'Recorder reference.', example: 'Practitioner/prac-2' },
+];

package/dist/claims/consent-claims.d.ts

@@ -0,0 +1,195 @@
+export declare enum ClaimConsent {
+    'decision' = "Consent.decision",
+    'status' = "Consent.status",
+    'action' = "Consent.action",
+    'category' = "Consent.category",
+    'categoryText' = "Consent.category-text",
+    'categoryDisplay' = "Consent.category-display",
+    'resourceType' = "Consent.resource-type",
+    'subject' = "Consent.subject",
+    'patient' = "Consent.patient",
+    'actorIdentifier' = "Consent.actor-identifier",
+    'actorRole' = "Consent.actor-role",
+    'date' = "Consent.date",
+    'periodStart' = "Consent.period-start",
+    'periodEnd' = "Consent.period-end",
+    'dataPeriodStart' = "Consent.data-period-start",
+    'dataPeriodEnd' = "Consent.data-period-end",
+    'grantor' = "Consent.grantor",
+    'grantee' = "Consent.grantee",
+    'manager' = "Consent.manager",
+    'controller' = "Consent.controller",
+    'verifiedBy' = "Consent.verified-by",
+    'verifiedDate' = "Consent.verified-date",
+    'purpose' = "Consent.purpose",
+    'identifier' = "Consent.identifier",
+    'eventBasedOn' = "Consent.event-basedon",
+    'sourceReference' = "Consent.source-reference",
+    'scope' = "Consent.scope",
+    'scopeDisplay' = "Consent.scope-display",
+    'policyRule' = "Consent.policy-rule",
+    'provisionCode' = "Consent.provision-code",
+    'provisionCodeDisplay' = "Consent.provision-code-display",
+    'securityLabel' = "Consent.security-label",
+    'documentType' = "Consent.document-type",
+    'containedReferenceList' = "Consent.contained-reference-list",
+    /**
+     * @deprecated Use `containedReferenceList`.
+     */
+    'containedResourceList' = "Consent.contained-resource-list",
+    /**
+     * @deprecated Use `containedReferenceList`.
+     */
+    'containedDocuments' = "Consent.contained-documents",
+    /**
+     * @deprecated Use `containedReferenceList`.
+     */
+    'attachmentContentIds' = "Consent.attachment-content-ids",
+    'attachmentContentType' = "Consent.attachment-contenttype",
+    'attachmentData' = "Consent.attachment-data",
+    'attachmentId' = "Consent.attachment-id"
+}
+/** Canonical resource-catalog name used consistently by the package. */
+export declare const ConsentClaim: typeof ClaimConsent;
+export declare const ConsentDecisions: Readonly<{
+    readonly Permit: "permit";
+    readonly Deny: "deny";
+}>;
+export type ConsentDecision = typeof ConsentDecisions[keyof typeof ConsentDecisions];
+/**
+ * Canonical FHIR R5 Consent lifecycle states.
+ *
+ * `draft` is the only state used for a professional permission request. A
+ * draft is carried to the controller for review and must never participate in
+ * authorization evaluation. Only `active` consent rules can grant access.
+ */
+export declare const ConsentStatuses: Readonly<{
+    readonly Draft: "draft";
+    readonly Active: "active";
+    readonly Inactive: "inactive";
+    readonly NotDone: "not-done";
+    readonly EnteredInError: "entered-in-error";
+    readonly Unknown: "unknown";
+}>;
+export type ConsentStatus = typeof ConsentStatuses[keyof typeof ConsentStatuses];
+/**
+ * Defines the structured, query-optimized format for storing a single, atomic consent rule
+ * in the vault (e.g., Firestore, CouchDB).
+ *
+ * This object is the "Query" model in a CQRS (Command Query Responsibility Segregation) pattern.
+ * It is generated by the `ConsentManager` from the "Command" - a set of interoperable claims
+ * provided in the `meta.claims` block of an incoming FHIR Consent resource.
+ *
+ * The backend's authorization engine queries against collections of these objects for high-speed
+ * access decisions. The original FHIR Consent resource may be stored separately for auditing.
+ *
+ * All fields are derived from claims using the reverse-DNS format, e.g., the `decision` field
+ * is populated from the `org.hl7.fhir.api.Consent.decision` claim.
+ */
+export interface ConsentRule {
+    /**
+     * JSON-LD context to define the vocabulary for the rule.
+     * Value MUST be "org.hl7.fhir.api".
+     */
+    '@context': 'org.hl7.fhir.api';
+    /** FHIR Consent lifecycle state; authorization evaluators accept only `active`. */
+    'Consent.status'?: ConsentStatus;
+    /**
+     * The decision of the rule: permit or deny.
+     * Derived from the `org.hl7.fhir.api.Consent.decision` claim.
+     */
+    'Consent.decision': ConsentDecision;
+    /**
+     * The data sections this rule applies to, as a comma-separated list of coded values.
+     * Derived from the `org.hl7.fhir.api.Consent.action` claim.
+     * Example claim: "LOINC|48765-2,SNOMED|12345"
+     */
+    'Consent.action': string;
+    /**
+     * The type of consent document, as a comma-serpareted list of coded values.
+     * Used for classifying the consent itself (e.g., for release of information).
+     * Derived from the `org.hl7.fhir.api.Consent.category` claim.
+     * Example claim: "LOINC|59284-0,LOINC|57016-8"
+     */
+    'Consent.category'?: string;
+    /**
+     * The subject of the consent.
+     * Derived from the `org.hl7.fhir.api.Consent.patient.identifier` claim.
+     */
+    'Consent.subject': string;
+    /**
+     * The identifier of the actor (jurisdiction, organization, professional) this rule applies to.
+     * This is the party whose access is being controlled.
+     * Derived from a claim like `org.hl7.fhir.api.Consent.actor.reference.identifier`.
+     * e.g., "urn:iso:3166-2:ES-CT", "did:web:hospital.example.com", "urn:email:dr-smith@example.com"
+     */
+    'Consent.actor-identifier': string;
+    /**
+     * The role of the actor this rule applies to.
+     * Derived from a claim like `org.hl7.fhir.api.Consent.actor.role`.
+     * e.g., "doctor", "nurse"
+     */
+    'Consent.actor-role': string;
+    /**
+     * The date the consent was granted (ISO 8601 Date).
+     * Derived from the `org.hl7.fhir.api.Consent.date` claim.
+     */
+    'Consent.date': string;
+    /**
+     * Start of the consent's validity period (ISO 8601 DateTime).
+     * Note: This is different from the date the consent was signed.
+     * Derived from the start of the `org.hl7.fhir.api.Consent.period` claim.
+     */
+    'Consent.period-start'?: string;
+    /**
+     * End of the consent's validity period (ISO 8601 DateTime).
+     * Derived from the end of the `org.hl7.fhir.api.Consent.period` claim.
+     */
+    'Consent.period-end'?: string;
+    /** Timeframe of the governed data; distinct from Consent validity. */
+    'Consent.data-period-start'?: string;
+    'Consent.data-period-end'?: string;
+    /** R5 grantor, grantee, workflow manager and enforcement controller references. */
+    'Consent.grantor'?: string;
+    'Consent.grantee'?: string;
+    'Consent.manager'?: string;
+    'Consent.controller'?: string;
+    /**
+     * The party to whom the consent is granted.
+     * Use both 'Consent.actor-identifier' and 'Consent.actor-role' instead.
+     * Derived from the `org.hl7.fhir.api.Consent.grantee` claim.
+     */
+    /**
+     * The DID of the entity (person or system) that verified the consent.
+     * Derived from the `org.hl7.fhir.api.Consent.verified-by` claim.
+     */
+    'Consent.verified-by'?: string;
+    /**
+     * The date the consent was verified (ISO 8601 DateTime).
+     * Derived from the `org.hl7.fhir.api.Consent.verified-date` claim.
+     */
+    'Consent.verified-date'?: string;
+    /**
+     * The purpose of use for this rule.
+     * Derived from the `org.hl7.fhir.api.Consent.purpose` claim.
+     * e.g., "ETREAT", "CAREMGT"
+     */
+    'Consent.purpose': string;
+    /**
+     * The original Consent resource ID for auditing.
+     * Derived from the `org.hl7.fhir.api.Consent.identifier` claim.
+     */
+    'Consent.identifier': string;
+    /** Governed FHIR resource types and security/content classifications. */
+    'Consent.resource-type'?: string;
+    'Consent.security-label'?: string;
+    'Consent.document-type'?: string;
+    'Consent.provision-code'?: string;
+    'Consent.contained-reference-list'?: string;
+    'Consent.contained-resource-list'?: string;
+    'Consent.contained-documents'?: string;
+    'Consent.attachment-content-ids'?: string;
+    'Consent.attachment-contenttype'?: string;
+    'Consent.attachment-data'?: string;
+    'Consent.attachment-id'?: string;
+}

package/dist/claims/consent-claims.js

@@ -0,0 +1,74 @@
+// src/models/consent-rule.ts
+export var ClaimConsent;
+(function (ClaimConsent) {
+    ClaimConsent["decision"] = "Consent.decision";
+    ClaimConsent["status"] = "Consent.status";
+    ClaimConsent["action"] = "Consent.action";
+    ClaimConsent["category"] = "Consent.category";
+    ClaimConsent["categoryText"] = "Consent.category-text";
+    ClaimConsent["categoryDisplay"] = "Consent.category-display";
+    ClaimConsent["resourceType"] = "Consent.resource-type";
+    ClaimConsent["subject"] = "Consent.subject";
+    ClaimConsent["patient"] = "Consent.patient";
+    ClaimConsent["actorIdentifier"] = "Consent.actor-identifier";
+    ClaimConsent["actorRole"] = "Consent.actor-role";
+    ClaimConsent["date"] = "Consent.date";
+    ClaimConsent["periodStart"] = "Consent.period-start";
+    ClaimConsent["periodEnd"] = "Consent.period-end";
+    ClaimConsent["dataPeriodStart"] = "Consent.data-period-start";
+    ClaimConsent["dataPeriodEnd"] = "Consent.data-period-end";
+    ClaimConsent["grantor"] = "Consent.grantor";
+    ClaimConsent["grantee"] = "Consent.grantee";
+    ClaimConsent["manager"] = "Consent.manager";
+    ClaimConsent["controller"] = "Consent.controller";
+    ClaimConsent["verifiedBy"] = "Consent.verified-by";
+    ClaimConsent["verifiedDate"] = "Consent.verified-date";
+    ClaimConsent["purpose"] = "Consent.purpose";
+    ClaimConsent["identifier"] = "Consent.identifier";
+    ClaimConsent["eventBasedOn"] = "Consent.event-basedon";
+    ClaimConsent["sourceReference"] = "Consent.source-reference";
+    ClaimConsent["scope"] = "Consent.scope";
+    ClaimConsent["scopeDisplay"] = "Consent.scope-display";
+    ClaimConsent["policyRule"] = "Consent.policy-rule";
+    ClaimConsent["provisionCode"] = "Consent.provision-code";
+    ClaimConsent["provisionCodeDisplay"] = "Consent.provision-code-display";
+    ClaimConsent["securityLabel"] = "Consent.security-label";
+    ClaimConsent["documentType"] = "Consent.document-type";
+    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 `containedReferenceList`.
+     */
+    ClaimConsent["attachmentContentIds"] = "Consent.attachment-content-ids";
+    ClaimConsent["attachmentContentType"] = "Consent.attachment-contenttype";
+    ClaimConsent["attachmentData"] = "Consent.attachment-data";
+    ClaimConsent["attachmentId"] = "Consent.attachment-id";
+})(ClaimConsent || (ClaimConsent = {}));
+/** Canonical resource-catalog name used consistently by the package. */
+export const ConsentClaim = ClaimConsent;
+export const ConsentDecisions = Object.freeze({
+    Permit: 'permit',
+    Deny: 'deny',
+});
+/**
+ * Canonical FHIR R5 Consent lifecycle states.
+ *
+ * `draft` is the only state used for a professional permission request. A
+ * draft is carried to the controller for review and must never participate in
+ * authorization evaluation. Only `active` consent rules can grant access.
+ */
+export const ConsentStatuses = Object.freeze({
+    Draft: 'draft',
+    Active: 'active',
+    Inactive: 'inactive',
+    NotDone: 'not-done',
+    EnteredInError: 'entered-in-error',
+    Unknown: 'unknown',
+});

package/dist/claims/coverage-claims.d.ts

@@ -0,0 +1,16 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const CoverageClaim: {
+    readonly Identifier: "Coverage.identifier";
+    readonly Status: "Coverage.status";
+    readonly Type: "Coverage.type";
+    readonly PolicyHolder: "Coverage.policy-holder";
+    readonly Subscriber: "Coverage.subscriber";
+    readonly Beneficiary: "Coverage.beneficiary";
+    readonly Relationship: "Coverage.relationship";
+    readonly PeriodStart: "Coverage.period-start";
+    readonly PeriodEnd: "Coverage.period-end";
+    readonly Payor: "Coverage.payor";
+    readonly Class: "Coverage.class";
+};
+export type CoverageClaimKey = typeof CoverageClaim[keyof typeof CoverageClaim];
+export declare const CoverageClaimSpecs: ClaimSpec[];

package/dist/claims/coverage-claims.js

@@ -0,0 +1,28 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/coverage-claims.ts
+export const CoverageClaim = {
+    Identifier: 'Coverage.identifier',
+    Status: 'Coverage.status',
+    Type: 'Coverage.type',
+    PolicyHolder: 'Coverage.policy-holder',
+    Subscriber: 'Coverage.subscriber',
+    Beneficiary: 'Coverage.beneficiary',
+    Relationship: 'Coverage.relationship',
+    PeriodStart: 'Coverage.period-start',
+    PeriodEnd: 'Coverage.period-end',
+    Payor: 'Coverage.payor',
+    Class: 'Coverage.class',
+};
+export const CoverageClaimSpecs = [
+    { key: CoverageClaim.Identifier, meaning: 'Business identifier.', example: 'cov-001' },
+    { key: CoverageClaim.Status, meaning: 'Coverage status.', example: 'active' },
+    { key: CoverageClaim.Type, meaning: 'Coverage type token.', example: 'http://terminology.hl7.org/CodeSystem/v3-ActCode|EHCPOL' },
+    { key: CoverageClaim.PolicyHolder, meaning: 'Policy holder reference.', example: 'RelatedPerson/rel-1' },
+    { key: CoverageClaim.Subscriber, meaning: 'Subscriber reference.', example: 'RelatedPerson/rel-1' },
+    { key: CoverageClaim.Beneficiary, meaning: 'Beneficiary reference.', example: 'did:web:patient.example.org' },
+    { key: CoverageClaim.Relationship, meaning: 'Relationship token.', example: 'http://terminology.hl7.org/CodeSystem/subscriber-relationship|self' },
+    { key: CoverageClaim.PeriodStart, meaning: 'Coverage start.', example: '2026-01-01' },
+    { key: CoverageClaim.PeriodEnd, meaning: 'Coverage end.', example: '2026-12-31' },
+    { key: CoverageClaim.Payor, meaning: 'Payor references (CSV).', example: 'Organization/payer-1' },
+    { key: CoverageClaim.Class, meaning: 'Coverage class values (CSV).', example: 'group|G-001,plan|P-001' },
+];

package/dist/claims/device-claims.d.ts

@@ -0,0 +1,20 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const DeviceClaim: {
+    readonly DeviceName: "Device.device-name";
+    readonly Identifier: "Device.identifier";
+    readonly Location: "Device.location";
+    readonly Manufacturer: "Device.manufacturer";
+    readonly Model: "Device.model";
+    readonly Organization: "Device.organization";
+    readonly Patient: "Device.patient";
+    readonly SerialNumber: "Device.serial-number";
+    readonly Status: "Device.status";
+    readonly Type: "Device.type";
+    readonly TypeText: "Device.type-text";
+    readonly TypeDisplay: "Device.type-display";
+    readonly UdiCarrier: "Device.udi-carrier";
+    readonly Url: "Device.url";
+    readonly Note: "Device.note";
+};
+export type DeviceClaimKey = typeof DeviceClaim[keyof typeof DeviceClaim];
+export declare const DeviceClaimSpecs: ClaimSpec[];

package/dist/claims/device-claims.js

@@ -0,0 +1,36 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/device-claims.ts
+export const DeviceClaim = {
+    DeviceName: 'Device.device-name',
+    Identifier: 'Device.identifier',
+    Location: 'Device.location',
+    Manufacturer: 'Device.manufacturer',
+    Model: 'Device.model',
+    Organization: 'Device.organization',
+    Patient: 'Device.patient',
+    SerialNumber: 'Device.serial-number',
+    Status: 'Device.status',
+    Type: 'Device.type',
+    TypeText: 'Device.type-text',
+    TypeDisplay: 'Device.type-display',
+    UdiCarrier: 'Device.udi-carrier',
+    Url: 'Device.url',
+    Note: 'Device.note',
+};
+export const DeviceClaimSpecs = [
+    { key: DeviceClaim.DeviceName, meaning: 'Human-readable device name.', example: 'Insulin pump' },
+    { key: DeviceClaim.Identifier, meaning: 'Business identifier.', example: 'device-001' },
+    { key: DeviceClaim.Location, meaning: 'Location reference.', example: 'Location/loc-1' },
+    { key: DeviceClaim.Manufacturer, meaning: 'Manufacturer name.', example: 'Medtronic' },
+    { key: DeviceClaim.Model, meaning: 'Model number or name.', example: 'MiniMed 780G' },
+    { key: DeviceClaim.Organization, meaning: 'Owning organization reference.', example: 'Organization/org-1' },
+    { key: DeviceClaim.Patient, meaning: 'Patient reference.', example: 'did:web:patient.example.org' },
+    { key: DeviceClaim.SerialNumber, meaning: 'Serial number.', example: 'SN-12345' },
+    { key: DeviceClaim.Status, meaning: 'Device status.', example: 'active' },
+    { key: DeviceClaim.Type, meaning: 'Device type token.', example: 'http://snomed.info/sct|706172005' },
+    { key: DeviceClaim.TypeText, meaning: 'Local-language device type label.', example: 'Bomba de insulina' },
+    { key: DeviceClaim.TypeDisplay, meaning: 'Canonical/international device type display.', example: 'Insulin pump' },
+    { key: DeviceClaim.UdiCarrier, meaning: 'UDI carrier string.', example: '(01)09504000059118(17)220101(10)ABCD1234' },
+    { key: DeviceClaim.Url, meaning: 'Canonical URL.', example: 'https://device.example.org/catalogue/123' },
+    { key: DeviceClaim.Note, meaning: 'Clinical note text.', example: 'Patient-owned continuous glucose monitor.' },
+];

package/dist/claims/device-use-statement-claims.d.ts

@@ -0,0 +1,17 @@
+import type { ClaimSpec } from './claim-types.js';
+export declare const DeviceUseStatementClaim: {
+    readonly Identifier: "DeviceUseStatement.identifier";
+    readonly Subject: "DeviceUseStatement.subject";
+    readonly Status: "DeviceUseStatement.status";
+    readonly Device: "DeviceUseStatement.device";
+    readonly DeviceDisplay: "DeviceUseStatement.device-display";
+    readonly RecordedOn: "DeviceUseStatement.recorded-on";
+    /** @deprecated Read-only key from historical persisted rows. */
+    readonly RecordedOnLegacy: "DeviceUseStatement.recordedon";
+    readonly TimingDateTime: "DeviceUseStatement.timing-datetime";
+    readonly TimingAbsentReason: "DeviceUseStatement.timing-absent-reason";
+    readonly ReasonCode: "DeviceUseStatement.reason-code";
+    readonly Source: "DeviceUseStatement.source";
+};
+export type DeviceUseStatementClaimKey = typeof DeviceUseStatementClaim[keyof typeof DeviceUseStatementClaim];
+export declare const DeviceUseStatementClaimSpecs: ClaimSpec[];

package/dist/claims/device-use-statement-claims.js

@@ -0,0 +1,28 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/device-use-statement-claims.ts
+// Always create JSDoc, do not use strings inline in keys nor values, use types instead, and reuse the data test examples.
+export const DeviceUseStatementClaim = {
+    Identifier: 'DeviceUseStatement.identifier',
+    Subject: 'DeviceUseStatement.subject',
+    Status: 'DeviceUseStatement.status',
+    Device: 'DeviceUseStatement.device',
+    DeviceDisplay: 'DeviceUseStatement.device-display',
+    RecordedOn: 'DeviceUseStatement.recorded-on',
+    /** @deprecated Read-only key from historical persisted rows. */
+    RecordedOnLegacy: 'DeviceUseStatement.recordedon',
+    TimingDateTime: 'DeviceUseStatement.timing-datetime',
+    TimingAbsentReason: 'DeviceUseStatement.timing-absent-reason',
+    ReasonCode: 'DeviceUseStatement.reason-code',
+    Source: 'DeviceUseStatement.source',
+};
+export const DeviceUseStatementClaimSpecs = [
+    { key: DeviceUseStatementClaim.Identifier, meaning: 'Business identifier for device-use record.', example: 'DUS-0001' },
+    { key: DeviceUseStatementClaim.Subject, meaning: 'Patient subject reference.', example: 'Patient/pat-123' },
+    { key: DeviceUseStatementClaim.Status, meaning: 'Use statement status.', example: 'active' },
+    { key: DeviceUseStatementClaim.Device, meaning: 'Device reference.', example: 'Device/dev-777' },
+    { key: DeviceUseStatementClaim.DeviceDisplay, meaning: 'Human-readable device name accompanying the reference.', example: 'Hip prosthesis' },
+    { key: DeviceUseStatementClaim.RecordedOn, meaning: 'Record creation date/time.', example: '2026-03-01T12:00:00Z' },
+    { key: DeviceUseStatementClaim.TimingDateTime, meaning: 'When the use happened.', example: '2026-03-01T08:00:00Z' },
+    { key: DeviceUseStatementClaim.ReasonCode, meaning: 'Reason code for use.', example: 'http://snomed.info/sct|182840001' },
+    { key: DeviceUseStatementClaim.Source, meaning: 'Source actor reference.', example: 'Practitioner/prac-8' },
+];