fhir-data-utils-ts 0.2.4 → 0.3.1

package/dist/claims/invoice-claims.js

@@ -0,0 +1,357 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/invoice-claims.ts
+/**
+ * Canonical flat claim keys for invoice-level business data.
+ *
+ * These claims are the claims-first source of truth. FHIR `Invoice` is one
+ * downstream projection built from them.
+ */
+export const InvoiceClaim = {
+    /** Stable business invoice identifier. Example: `invoice-001`. */
+    Identifier: 'Invoice.identifier',
+    /** Invoice issue date/time. Example: `2026-06-11T10:00:00Z`. */
+    Date: 'Invoice.date',
+    /** Invoice lifecycle status. Example: `issued`. */
+    Status: 'Invoice.status',
+    /** Subject or tenant context reference. Example: `did:web:host.example.com:health-care:organization:taxid:VATES-B00112233:individual:multibase:zExampleIndividualId`. */
+    Subject: 'Invoice.subject',
+    /** Billed recipient reference. Example: `did:web:portal.example.org:billing`. */
+    Recipient: 'Invoice.recipient',
+    /** Invoice issuer reference. Example: `did:web:api.acme.org`. */
+    Issuer: 'Invoice.issuer',
+    /** Human-readable issuer label. Example: `Gateway Host Services`. */
+    IssuerDisplay: 'Invoice.issuer-display',
+    /** Commercial payment method/terms. Example: `invoice`. */
+    PaymentTerms: 'Invoice.payment-terms',
+    /** Payment or settlement URL when available. Example: `https://pay.example/invoice-001`. */
+    PaymentUrl: 'Invoice.payment-url',
+    /** Net amount numeric value serialized as string. Example: `9.99`. */
+    TotalNetValue: 'Invoice.totalnet-value',
+    /** Net amount ISO currency. Example: `EUR`. */
+    TotalNetCurrency: 'Invoice.totalnet-currency',
+    /** Gross amount numeric value serialized as string. Example: `9.99`. */
+    TotalGrossValue: 'Invoice.totalgross-value',
+    /** Gross amount ISO currency. Example: `EUR`. */
+    TotalGrossCurrency: 'Invoice.totalgross-currency',
+};
+/**
+ * Contextualized FHIR-API-like invoice claims.
+ *
+ * Convention:
+ * - `org.hl7.fhir.api.Invoice.<concrete-parameter>`
+ * - scalar/string-friendly values only
+ * - invoice totals/payment URL remain extension-style operational claims
+ *   because not every business field maps to one native FHIR search parameter
+ */
+export var InvoiceClaimsFhirApiExtended;
+(function (InvoiceClaimsFhirApiExtended) {
+    InvoiceClaimsFhirApiExtended["Identifier"] = "org.hl7.fhir.api.Invoice.identifier";
+    InvoiceClaimsFhirApiExtended["Date"] = "org.hl7.fhir.api.Invoice.date";
+    InvoiceClaimsFhirApiExtended["Status"] = "org.hl7.fhir.api.Invoice.status";
+    InvoiceClaimsFhirApiExtended["Subject"] = "org.hl7.fhir.api.Invoice.subject";
+    InvoiceClaimsFhirApiExtended["Recipient"] = "org.hl7.fhir.api.Invoice.recipient";
+    InvoiceClaimsFhirApiExtended["Issuer"] = "org.hl7.fhir.api.Invoice.issuer";
+    InvoiceClaimsFhirApiExtended["IssuerDisplay"] = "org.hl7.fhir.api.Invoice.issuer-display";
+    InvoiceClaimsFhirApiExtended["PaymentTerms"] = "org.hl7.fhir.api.Invoice.payment-terms";
+    InvoiceClaimsFhirApiExtended["PaymentUrl"] = "org.hl7.fhir.api.Invoice.payment-url";
+    InvoiceClaimsFhirApiExtended["TotalNetValue"] = "org.hl7.fhir.api.Invoice.totalnet-value";
+    InvoiceClaimsFhirApiExtended["TotalNetCurrency"] = "org.hl7.fhir.api.Invoice.totalnet-currency";
+    InvoiceClaimsFhirApiExtended["TotalGrossValue"] = "org.hl7.fhir.api.Invoice.totalgross-value";
+    InvoiceClaimsFhirApiExtended["TotalGrossCurrency"] = "org.hl7.fhir.api.Invoice.totalgross-currency";
+})(InvoiceClaimsFhirApiExtended || (InvoiceClaimsFhirApiExtended = {}));
+/**
+ * Canonical non-contextualized parameter names for query builders and readers.
+ */
+export const InvoiceSearchParamNames = {
+    Identifier: 'identifier',
+    Date: 'date',
+    Status: 'status',
+    Subject: 'subject',
+    Recipient: 'recipient',
+    Issuer: 'issuer',
+    IssuerDisplay: 'issuer-display',
+    PaymentTerms: 'payment-terms',
+    PaymentUrl: 'payment-url',
+    TotalNetValue: 'totalnet-value',
+    TotalNetCurrency: 'totalnet-currency',
+    TotalGrossValue: 'totalgross-value',
+    TotalGrossCurrency: 'totalgross-currency',
+};
+/**
+ * Charge-item-level claims used when one business invoice line is represented
+ * as one claims row. The future FHIR export can compact multiple rows sharing
+ * one invoice identifier into a single `Invoice` with multiple items.
+ *
+ * Note:
+ * - FHIR `Invoice` does not expose all these details as search parameters.
+ * - `ChargeItem` is therefore modeled here as claims-first operational data.
+ */
+export const ChargeItemClaim = {
+    /** Stable invoice line identifier. Example: `chargeitem-001`. */
+    Identifier: 'ChargeItem.identifier',
+    /** Charge item lifecycle status from FHIR ChargeItemStatus. Example: `billable`. */
+    Status: 'ChargeItem.status',
+    /** Parent business aggregate identifier. Example: `invoice-001`. */
+    PartOf: 'ChargeItem.part-of',
+    /** Public code such as GTIN/UDI/barcode. Example: `08412345678903`. */
+    Code: 'ChargeItem.code',
+    /** Local-language UI/help label for the coded product. Example: `Sterile saline bottle 500 mL`. */
+    CodeText: 'ChargeItem.code-text',
+    /** Normalized aggregate reporting category. Example: `medical-supplies`. */
+    Category: 'ChargeItem.category',
+    /** Supplier or import product code. Example: `IMP-SAL-500`. */
+    SupplierProductCode: 'ChargeItem.supplier-productcode',
+    /** Compact FHIR-style quantity token for search/readback. Example: `3|bottle`. */
+    Quantity: 'ChargeItem.quantity',
+    /** Main quantity numeric scalar serialized as string. Example: `3`. */
+    QuantityNumber: 'ChargeItem.quantity-number',
+    /** Main quantity unit code or label. Example: `bottle`. */
+    QuantityUnit: 'ChargeItem.quantity-unit',
+    /** Contained items per main unit. Example: `24`. */
+    ItemsPerUnit: 'ChargeItem.items-per-unit',
+    /** Compact contained-item quantity token for search/readback. Example: `500|mL`. */
+    ItemsQuantity: 'ChargeItem.items-quantity',
+    /** Contained item numeric quantity serialized as string. Example: `500`. */
+    ItemsQuantityNumber: 'ChargeItem.items-quantity-number',
+    /** Contained item UCUM-like unit. Example: `mL`. */
+    ItemsQuantityUnit: 'ChargeItem.items-quantity-unit',
+};
+export var ChargeItemClaimsFhirApiExtended;
+(function (ChargeItemClaimsFhirApiExtended) {
+    ChargeItemClaimsFhirApiExtended["Identifier"] = "org.hl7.fhir.api.ChargeItem.identifier";
+    ChargeItemClaimsFhirApiExtended["Status"] = "org.hl7.fhir.api.ChargeItem.status";
+    ChargeItemClaimsFhirApiExtended["PartOf"] = "org.hl7.fhir.api.ChargeItem.part-of";
+    ChargeItemClaimsFhirApiExtended["Code"] = "org.hl7.fhir.api.ChargeItem.code";
+    ChargeItemClaimsFhirApiExtended["CodeText"] = "org.hl7.fhir.api.ChargeItem.code-text";
+    ChargeItemClaimsFhirApiExtended["Category"] = "org.hl7.fhir.api.ChargeItem.category";
+    ChargeItemClaimsFhirApiExtended["SupplierProductCode"] = "org.hl7.fhir.api.ChargeItem.supplier-productcode";
+    ChargeItemClaimsFhirApiExtended["Quantity"] = "org.hl7.fhir.api.ChargeItem.quantity";
+    ChargeItemClaimsFhirApiExtended["QuantityNumber"] = "org.hl7.fhir.api.ChargeItem.quantity-number";
+    ChargeItemClaimsFhirApiExtended["QuantityUnit"] = "org.hl7.fhir.api.ChargeItem.quantity-unit";
+    ChargeItemClaimsFhirApiExtended["ItemsPerUnit"] = "org.hl7.fhir.api.ChargeItem.items-per-unit";
+    ChargeItemClaimsFhirApiExtended["ItemsQuantity"] = "org.hl7.fhir.api.ChargeItem.items-quantity";
+    ChargeItemClaimsFhirApiExtended["ItemsQuantityNumber"] = "org.hl7.fhir.api.ChargeItem.items-quantity-number";
+    ChargeItemClaimsFhirApiExtended["ItemsQuantityUnit"] = "org.hl7.fhir.api.ChargeItem.items-quantity-unit";
+})(ChargeItemClaimsFhirApiExtended || (ChargeItemClaimsFhirApiExtended = {}));
+export const ChargeItemSearchParamNames = {
+    Identifier: 'identifier',
+    Status: 'status',
+    PartOf: 'part-of',
+    Code: 'code',
+    CodeText: 'code-text',
+    Category: 'category',
+    SupplierProductCode: 'supplier-productcode',
+    Quantity: 'quantity',
+    QuantityNumber: 'quantity-number',
+    QuantityUnit: 'quantity-unit',
+    ItemsPerUnit: 'items-per-unit',
+    ItemsQuantity: 'items-quantity',
+    ItemsQuantityNumber: 'items-quantity-number',
+    ItemsQuantityUnit: 'items-quantity-unit',
+};
+export const InvoiceClaimSpecs = [
+    { key: InvoiceClaim.Identifier, meaning: 'Stable business invoice identifier.', example: 'invoice-001' },
+    { key: InvoiceClaim.Date, meaning: 'Invoice issue date/time.', example: '2026-06-11T10:00:00Z' },
+    { key: InvoiceClaim.Status, meaning: 'Invoice lifecycle status.', example: 'issued' },
+    {
+        key: InvoiceClaim.Subject,
+        meaning: 'Subject or tenant context reference.',
+        example: 'did:web:host.example.com:health-care:organization:taxid:VATES-B00112233:individual:multibase:zExampleIndividualId',
+    },
+    { key: InvoiceClaim.Recipient, meaning: 'Billed recipient reference.', example: 'did:web:portal.example.org:billing' },
+    { key: InvoiceClaim.Issuer, meaning: 'Invoice issuer reference.', example: 'did:web:api.acme.org' },
+    { key: InvoiceClaim.IssuerDisplay, meaning: 'Human-readable issuer label.', example: 'Gateway Host Services' },
+    { key: InvoiceClaim.PaymentTerms, meaning: 'Commercial payment method/terms.', example: 'invoice' },
+    { key: InvoiceClaim.PaymentUrl, meaning: 'Payment or settlement URL when available.', example: 'https://pay.example/invoice-001' },
+    { key: InvoiceClaim.TotalNetValue, meaning: 'Net amount numeric value serialized as string.', example: '9.99' },
+    { key: InvoiceClaim.TotalNetCurrency, meaning: 'Net amount ISO currency.', example: 'EUR' },
+    { key: InvoiceClaim.TotalGrossValue, meaning: 'Gross amount numeric value serialized as string.', example: '9.99' },
+    { key: InvoiceClaim.TotalGrossCurrency, meaning: 'Gross amount ISO currency.', example: 'EUR' },
+];
+export const ChargeItemClaimSpecs = [
+    { key: ChargeItemClaim.Identifier, meaning: 'Stable invoice line identifier.', example: 'chargeitem-001' },
+    { key: ChargeItemClaim.Status, meaning: 'Charge item lifecycle status from FHIR ChargeItemStatus.', example: 'billable' },
+    { key: ChargeItemClaim.PartOf, meaning: 'Parent business aggregate identifier.', example: 'invoice-001' },
+    { key: ChargeItemClaim.Code, meaning: 'Public code such as GTIN/UDI/barcode.', example: '08412345678903' },
+    { key: ChargeItemClaim.CodeText, meaning: 'Local-language UI/help label for the coded product.', example: 'Botella de suero salino estéril 500 mL' },
+    { key: ChargeItemClaim.Category, meaning: 'Normalized aggregate reporting category.', example: 'medical-supplies' },
+    { key: ChargeItemClaim.SupplierProductCode, meaning: 'Supplier or import product code.', example: 'IMP-SAL-500' },
+    { key: ChargeItemClaim.Quantity, meaning: 'Compact FHIR-style quantity token for search/readback.', example: '3|bottle' },
+    { key: ChargeItemClaim.QuantityNumber, meaning: 'Main quantity numeric scalar serialized as string.', example: '3' },
+    { key: ChargeItemClaim.QuantityUnit, meaning: 'Main quantity unit code or label.', example: 'bottle' },
+    { key: ChargeItemClaim.ItemsPerUnit, meaning: 'Contained items per main unit.', example: '24' },
+    { key: ChargeItemClaim.ItemsQuantity, meaning: 'Compact contained-item quantity token for search/readback.', example: '500|mL' },
+    { key: ChargeItemClaim.ItemsQuantityNumber, meaning: 'Contained item numeric quantity serialized as string.', example: '500' },
+    { key: ChargeItemClaim.ItemsQuantityUnit, meaning: 'Contained item UCUM-like unit.', example: 'mL' },
+];
+export const InvoiceClaimToFhirPath = {
+    [InvoiceClaim.Identifier]: 'Invoice.identifier.value',
+    [InvoiceClaim.Date]: 'Invoice.date',
+    [InvoiceClaim.Status]: 'Invoice.status',
+    [InvoiceClaim.Subject]: 'Invoice.subject.reference',
+    [InvoiceClaim.Recipient]: 'Invoice.recipient.reference',
+    [InvoiceClaim.Issuer]: 'Invoice.issuer.reference',
+    [InvoiceClaim.IssuerDisplay]: 'Invoice.issuer.display',
+    [InvoiceClaim.PaymentTerms]: 'Invoice.paymentTerms',
+    [InvoiceClaim.PaymentUrl]: 'Invoice.note.text',
+    [InvoiceClaim.TotalNetValue]: 'Invoice.totalNet.value',
+    [InvoiceClaim.TotalNetCurrency]: 'Invoice.totalNet.currency',
+    [InvoiceClaim.TotalGrossValue]: 'Invoice.totalGross.value',
+    [InvoiceClaim.TotalGrossCurrency]: 'Invoice.totalGross.currency',
+};
+export function contextualizeInvoiceClaims(claims) {
+    return {
+        ...(claims[InvoiceClaim.Identifier] ? { [InvoiceClaimsFhirApiExtended.Identifier]: claims[InvoiceClaim.Identifier] } : {}),
+        ...(claims[InvoiceClaim.Date] ? { [InvoiceClaimsFhirApiExtended.Date]: claims[InvoiceClaim.Date] } : {}),
+        ...(claims[InvoiceClaim.Status] ? { [InvoiceClaimsFhirApiExtended.Status]: claims[InvoiceClaim.Status] } : {}),
+        ...(claims[InvoiceClaim.Subject] ? { [InvoiceClaimsFhirApiExtended.Subject]: claims[InvoiceClaim.Subject] } : {}),
+        ...(claims[InvoiceClaim.Recipient] ? { [InvoiceClaimsFhirApiExtended.Recipient]: claims[InvoiceClaim.Recipient] } : {}),
+        ...(claims[InvoiceClaim.Issuer] ? { [InvoiceClaimsFhirApiExtended.Issuer]: claims[InvoiceClaim.Issuer] } : {}),
+        ...(claims[InvoiceClaim.IssuerDisplay] ? { [InvoiceClaimsFhirApiExtended.IssuerDisplay]: claims[InvoiceClaim.IssuerDisplay] } : {}),
+        ...(claims[InvoiceClaim.PaymentTerms] ? { [InvoiceClaimsFhirApiExtended.PaymentTerms]: claims[InvoiceClaim.PaymentTerms] } : {}),
+        ...(claims[InvoiceClaim.PaymentUrl] ? { [InvoiceClaimsFhirApiExtended.PaymentUrl]: claims[InvoiceClaim.PaymentUrl] } : {}),
+        ...(claims[InvoiceClaim.TotalNetValue] ? { [InvoiceClaimsFhirApiExtended.TotalNetValue]: claims[InvoiceClaim.TotalNetValue] } : {}),
+        ...(claims[InvoiceClaim.TotalNetCurrency] ? { [InvoiceClaimsFhirApiExtended.TotalNetCurrency]: claims[InvoiceClaim.TotalNetCurrency] } : {}),
+        ...(claims[InvoiceClaim.TotalGrossValue] ? { [InvoiceClaimsFhirApiExtended.TotalGrossValue]: claims[InvoiceClaim.TotalGrossValue] } : {}),
+        ...(claims[InvoiceClaim.TotalGrossCurrency] ? { [InvoiceClaimsFhirApiExtended.TotalGrossCurrency]: claims[InvoiceClaim.TotalGrossCurrency] } : {}),
+    };
+}
+export function contextualizeChargeItemClaims(claims) {
+    return {
+        ...(claims[ChargeItemClaim.Identifier] ? { [ChargeItemClaimsFhirApiExtended.Identifier]: claims[ChargeItemClaim.Identifier] } : {}),
+        ...(claims[ChargeItemClaim.Status] ? { [ChargeItemClaimsFhirApiExtended.Status]: claims[ChargeItemClaim.Status] } : {}),
+        ...(claims[ChargeItemClaim.PartOf] ? { [ChargeItemClaimsFhirApiExtended.PartOf]: claims[ChargeItemClaim.PartOf] } : {}),
+        ...(claims[ChargeItemClaim.Code] ? { [ChargeItemClaimsFhirApiExtended.Code]: claims[ChargeItemClaim.Code] } : {}),
+        ...(claims[ChargeItemClaim.CodeText] ? { [ChargeItemClaimsFhirApiExtended.CodeText]: claims[ChargeItemClaim.CodeText] } : {}),
+        ...(claims[ChargeItemClaim.Category] ? { [ChargeItemClaimsFhirApiExtended.Category]: claims[ChargeItemClaim.Category] } : {}),
+        ...(claims[ChargeItemClaim.SupplierProductCode] ? { [ChargeItemClaimsFhirApiExtended.SupplierProductCode]: claims[ChargeItemClaim.SupplierProductCode] } : {}),
+        ...(claims[ChargeItemClaim.Quantity] ? { [ChargeItemClaimsFhirApiExtended.Quantity]: claims[ChargeItemClaim.Quantity] } : {}),
+        ...(claims[ChargeItemClaim.QuantityNumber] ? { [ChargeItemClaimsFhirApiExtended.QuantityNumber]: claims[ChargeItemClaim.QuantityNumber] } : {}),
+        ...(claims[ChargeItemClaim.QuantityUnit] ? { [ChargeItemClaimsFhirApiExtended.QuantityUnit]: claims[ChargeItemClaim.QuantityUnit] } : {}),
+        ...(claims[ChargeItemClaim.ItemsPerUnit] ? { [ChargeItemClaimsFhirApiExtended.ItemsPerUnit]: claims[ChargeItemClaim.ItemsPerUnit] } : {}),
+        ...(claims[ChargeItemClaim.ItemsQuantity] ? { [ChargeItemClaimsFhirApiExtended.ItemsQuantity]: claims[ChargeItemClaim.ItemsQuantity] } : {}),
+        ...(claims[ChargeItemClaim.ItemsQuantityNumber] ? { [ChargeItemClaimsFhirApiExtended.ItemsQuantityNumber]: claims[ChargeItemClaim.ItemsQuantityNumber] } : {}),
+        ...(claims[ChargeItemClaim.ItemsQuantityUnit] ? { [ChargeItemClaimsFhirApiExtended.ItemsQuantityUnit]: claims[ChargeItemClaim.ItemsQuantityUnit] } : {}),
+    };
+}
+/**
+ * Generic low-level invoice claim accessor.
+ *
+ * Prefer the explicit `getInvoice*` helpers below from application code when
+ * you want stronger autocomplete and clearer intent at the call site.
+ */
+export function getInvoiceClaim(claims, key) {
+    return claims?.[key];
+}
+/**
+ * Generic low-level charge item claim accessor.
+ *
+ * Prefer the explicit `getCode()`, `getCodeText()`, `getQuantityNumber()`,
+ * etc. helpers below from application code when you want stronger
+ * autocomplete and clearer intent at the call site.
+ */
+export function getChargeItemClaim(claims, key) {
+    return claims?.[key];
+}
+export function getInvoiceIdentifier(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.Identifier);
+}
+export function getInvoiceDate(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.Date);
+}
+export function getInvoiceStatus(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.Status);
+}
+export function getInvoiceSubject(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.Subject);
+}
+export function getInvoiceRecipient(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.Recipient);
+}
+export function getInvoiceIssuer(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.Issuer);
+}
+export function getInvoiceIssuerDisplay(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.IssuerDisplay);
+}
+export function getInvoicePaymentTerms(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.PaymentTerms);
+}
+export function getInvoicePaymentUrl(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.PaymentUrl);
+}
+export function getInvoiceTotalNetValue(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.TotalNetValue);
+}
+export function getInvoiceTotalNetCurrency(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.TotalNetCurrency);
+}
+export function getInvoiceTotalGrossValue(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.TotalGrossValue);
+}
+export function getInvoiceTotalGrossCurrency(claims) {
+    return getInvoiceClaim(claims, InvoiceClaim.TotalGrossCurrency);
+}
+export function getChargeItemIdentifier(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.Identifier);
+}
+export function getChargeItemStatus(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.Status);
+}
+export function getChargeItemPartOf(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.PartOf);
+}
+export function getCode(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.Code);
+}
+export function getCodeText(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.CodeText);
+}
+export function getCategory(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.Category);
+}
+export function getSupplierProductCode(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.SupplierProductCode);
+}
+export function getQuantity(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.Quantity);
+}
+export function getQuantityNumber(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.QuantityNumber);
+}
+export function getQuantityUnit(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.QuantityUnit);
+}
+export function getItemsPerUnit(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.ItemsPerUnit);
+}
+export function getItemsQuantity(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.ItemsQuantity);
+}
+export function getItemsQuantityNumber(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.ItemsQuantityNumber);
+}
+export function getItemsQuantityUnit(claims) {
+    return getChargeItemClaim(claims, ChargeItemClaim.ItemsQuantityUnit);
+}
+export function getChargeItemView(claims) {
+    return {
+        identifier: getChargeItemIdentifier(claims),
+        status: getChargeItemStatus(claims),
+        partOf: getChargeItemPartOf(claims),
+        code: getCode(claims),
+        codeText: getCodeText(claims),
+        category: getCategory(claims),
+        supplierProductCode: getSupplierProductCode(claims),
+        quantity: getQuantity(claims),
+        quantityNumber: getQuantityNumber(claims),
+        quantityUnit: getQuantityUnit(claims),
+        itemsPerUnit: getItemsPerUnit(claims),
+        itemsQuantity: getItemsQuantity(claims),
+        itemsQuantityNumber: getItemsQuantityNumber(claims),
+        itemsQuantityUnit: getItemsQuantityUnit(claims),
+    };
+}
+export function getChargeItemList(rows) {
+    return Array.isArray(rows) ? rows.map((row) => getChargeItemView(row)) : [];
+}

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

@@ -0,0 +1,22 @@
+import type { ClaimSpec } from './claim-types.js';
+/**
+ * Flat claim keys for `Location`.
+ *
+ * Use this resource for offices, consultation rooms, clinics, labs, or other
+ * service/physical locations.
+ */
+export declare const LocationClaim: {
+    readonly Identifier: "Location.identifier";
+    readonly Status: "Location.status";
+    readonly Name: "Location.name";
+    readonly Description: "Location.description";
+    readonly Type: "Location.type";
+    readonly Mode: "Location.mode";
+    readonly Telecom: "Location.telecom";
+    readonly Address: "Location.address";
+    readonly PhysicalType: "Location.physical-type";
+    readonly ManagingOrganization: "Location.managing-organization";
+    readonly PartOf: "Location.part-of";
+};
+export type LocationClaimKey = typeof LocationClaim[keyof typeof LocationClaim];
+export declare const LocationClaimSpecs: ClaimSpec[];

package/dist/claims/location-claims.js

@@ -0,0 +1,34 @@
+// Copyright 2026 Conéctate Soluciones y Aplicaciones SL under the Apache License, Version 2.0.
+// File: src/models/interoperable-claims/location-claims.ts
+/**
+ * Flat claim keys for `Location`.
+ *
+ * Use this resource for offices, consultation rooms, clinics, labs, or other
+ * service/physical locations.
+ */
+export const LocationClaim = {
+    Identifier: 'Location.identifier',
+    Status: 'Location.status',
+    Name: 'Location.name',
+    Description: 'Location.description',
+    Type: 'Location.type',
+    Mode: 'Location.mode',
+    Telecom: 'Location.telecom',
+    Address: 'Location.address',
+    PhysicalType: 'Location.physical-type',
+    ManagingOrganization: 'Location.managing-organization',
+    PartOf: 'Location.part-of',
+};
+export const LocationClaimSpecs = [
+    { key: LocationClaim.Identifier, meaning: 'Business identifier.', example: 'room-201' },
+    { key: LocationClaim.Status, meaning: 'Location status.', example: 'active' },
+    { key: LocationClaim.Name, meaning: 'Display name.', example: 'Consultation Room 201' },
+    { key: LocationClaim.Description, meaning: 'Narrative description.', example: 'Second floor consultation room' },
+    { key: LocationClaim.Type, meaning: 'Location type token.', example: 'http://terminology.hl7.org/CodeSystem/v3-RoleCode|OF' },
+    { key: LocationClaim.Mode, meaning: 'Location mode.', example: 'instance' },
+    { key: LocationClaim.Telecom, meaning: 'Contact values as CSV.', example: 'tel:+16045550102' },
+    { key: LocationClaim.Address, meaning: 'Display address.', example: '123 Main St, Vancouver' },
+    { key: LocationClaim.PhysicalType, meaning: 'Physical type token.', example: 'http://terminology.hl7.org/CodeSystem/location-physical-type|ro' },
+    { key: LocationClaim.ManagingOrganization, meaning: 'Managing organization reference.', example: 'Organization/dept-cardiology-001' },
+    { key: LocationClaim.PartOf, meaning: 'Parent location reference.', example: 'Location/building-a' },
+];

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

@@ -0,0 +1,15 @@
+import type { ClaimSpec } from './claim-types.js';
+/** Canonical flat claims used by a FHIR Medication graph entry. */
+export declare const MedicationClaim: Readonly<{
+    readonly Identifier: "Medication.identifier";
+    readonly Code: "Medication.code";
+    readonly CodeText: "Medication.code-text";
+    readonly CodeDisplay: "Medication.code-display";
+    readonly Manufacturer: "Medication.manufacturer";
+    readonly Form: "Medication.form";
+    readonly LotNumber: "Medication.lot-number";
+    readonly ExpirationDate: "Medication.expiration-date";
+    readonly SerialNumber: "Medication.serial-number";
+}>;
+export type MedicationClaimKey = typeof MedicationClaim[keyof typeof MedicationClaim];
+export declare const MedicationClaimSpecs: readonly ClaimSpec[];

package/dist/claims/medication-claims.js

@@ -0,0 +1,23 @@
+/** Canonical flat claims used by a FHIR Medication graph entry. */
+export const MedicationClaim = Object.freeze({
+    Identifier: 'Medication.identifier',
+    Code: 'Medication.code',
+    CodeText: 'Medication.code-text',
+    CodeDisplay: 'Medication.code-display',
+    Manufacturer: 'Medication.manufacturer',
+    Form: 'Medication.form',
+    LotNumber: 'Medication.lot-number',
+    ExpirationDate: 'Medication.expiration-date',
+    SerialNumber: 'Medication.serial-number',
+});
+export const MedicationClaimSpecs = Object.freeze([
+    { key: MedicationClaim.Identifier, meaning: 'Medication business identifier.', example: 'urn:uuid:medication-1' },
+    { key: MedicationClaim.Code, meaning: 'Medication coding token.', example: 'http://www.whocc.no/atc|J07BB02' },
+    { key: MedicationClaim.CodeText, meaning: 'Source-language medication label.', example: 'Vacuna antigripal' },
+    { key: MedicationClaim.CodeDisplay, meaning: 'Canonical terminology display.', example: 'Influenza vaccine' },
+    { key: MedicationClaim.Manufacturer, meaning: 'Manufacturer reference or governed identifier.', example: 'Organization/manufacturer-1' },
+    { key: MedicationClaim.Form, meaning: 'Medication dose-form coding token.', example: 'http://snomed.info/sct|385219001' },
+    { key: MedicationClaim.LotNumber, meaning: 'Manufacturer lot number.', example: 'LOT-1' },
+    { key: MedicationClaim.ExpirationDate, meaning: 'Batch expiration date.', example: '2027-09-21' },
+    { key: MedicationClaim.SerialNumber, meaning: 'Package serial or barcode.', example: '0123456789012' },
+]);