@claudebernard/node-fhir-mapper 2.1.3 → 2.1.5

package/README.md

@@ -436,6 +436,45 @@ function createMedicationsFromCISCodes(codes: string[]): MappingResponse<Bundle>
 
 Similar functions for creating medications from CIP13 and CIS codes respectively. They also add a blank MedicationRequest per Medication.
 
+#### - createMedicationsFromProducts / createMedicationFromProduct
+
+```ts
+function createMedicationsFromProducts(products: Product[]): MappingResponse<Bundle> {}
+function createMedicationFromProduct(product: Product): Medication | undefined {}
+```
+
+Same as `createMedicationsFromBcbCodes`, but starting from the `Product` objects returned by the BCB APIs (`@claudebernard/types`), so the medication labels are kept along with the codes. Each Medication carries one Coding per code the Product holds — `code` for the bcb-code, `properties.codes.cip13` (or `code13`) for the cip13-code, `properties.codes.cis` for the cis-code — each with the product label as `display`, and the same label as the CodeableConcept `text` :
+
+```json
+{
+  "resourceType": "Medication",
+  "id": "95175bcb-f3cf-4eb8-83be-7956554cd0b8",
+  "code": {
+    "coding": [
+      { "system": "https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code", "code": "76461", "display": "JANUMET 50 mg/1000 mg, comprimé pelliculé" },
+      { "system": "http://terminology.hl7.org/CodeSystem/cip13-code", "code": "3400957312114", "display": "JANUMET 50 mg/1000 mg, comprimé pelliculé" },
+      { "system": "http://terminology.hl7.org/CodeSystem/cis-code", "code": "66010671", "display": "JANUMET 50 mg/1000 mg, comprimé pelliculé" }
+    ],
+    "text": "JANUMET 50 mg/1000 mg, comprimé pelliculé"
+  }
+}
+```
+
+The label is read from `labels.label`, falling back on `labels.longLabel` then `labels.shortLabel`, depending on which fields the API in use fills ; the HTML flavoured fields (`labelHtml` & co) are never used. Unlike the other creation functions, the Bundle `id` is a UUID v4 as well, so it differs from one call to the next. A Product carrying none of the three codes is skipped and reported in the `errors` field of the response ; `createMedicationFromProduct` returns `undefined` for it.
+
+##### Usage
+
+```ts
+import { medicationMapper } from '@claudebernard/fhir-mapper';
+
+const response = medicationMapper.createMedicationsFromProducts(products);
+
+if (response.result) {
+    // Bundle with the Medication resources first, then their MedicationRequest resources
+    console.log(response.result.entry?.length);
+}
+```
+
 #### - extractBcbCodesFromMedications / extractCIP13CodesFromMedications / extractCISCodesFromMedications
 
 ```ts

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Dosage, Bundle } from 'fhir/r5';
-import { CBPatient } from '@claudebernard/types';
+import { Dosage, Bundle, Medication } from 'fhir/r5';
+import { CBPatient, Product } from '@claudebernard/types';
 
 interface BCBPosologieStructuree2 {
     adequationUP?: number | null;
@@ -191,6 +191,9 @@ declare namespace patientMapper_d {
   };
 }
 
+declare const BCB_CODE_SYSTEM = "https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code";
+declare const CIP13_CODE_SYSTEM = "http://terminology.hl7.org/CodeSystem/cip13-code";
+declare const CIS_CODE_SYSTEM = "http://terminology.hl7.org/CodeSystem/cis-code";
 /**
  * Generate a hash-based ID for a medication based on its codes
  */
@@ -204,21 +207,21 @@ declare const generateMedicationId: (codes: string[], system: string) => string;
 declare function extractCodesFromMedications(bundle: Bundle, system: string): string[];
 /**
  * Extracts a list of bcb-code strings from a Bundle containing Medication resources.
- * Only codes with system "https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code" are included.
+ * Only codes with system BCB_CODE_SYSTEM are included.
  * @param bundle Bundle containing Medication resources
  * @returns List of BCB codes
  */
 declare function extractBcbCodesFromMedications(bundle: Bundle): string[];
 /**
  * Extracts a list of cip13-code strings from a Bundle containing Medication resources.
- * Only codes with system "http://terminology.hl7.org/CodeSystem/cip13-code" are included.
+ * Only codes with system CIP13_CODE_SYSTEM are included.
  * @param bundle Bundle containing Medication resources
  * @returns List of CIP13 codes
  */
 declare function extractCIP13CodesFromMedications(bundle: Bundle): string[];
 /**
  * Extracts a list of cis-code strings from a Bundle containing Medication resources.
- * Only codes with system "http://terminology.hl7.org/CodeSystem/cis-code" are included.
+ * Only codes with system CIS_CODE_SYSTEM are included.
  * @param bundle Bundle containing Medication resources
  * @returns List of CIS codes
  */
@@ -247,24 +250,64 @@ declare function createMedicationsFromCIP13Codes(cip13Codes: string[]): MappingR
  * @returns MappingResponse containing a Bundle with Medication and MedicationRequest resources
  */
 declare function createMedicationsFromCISCodes(cisCodes: string[]): MappingResponse<Bundle>;
+/**
+ * Reads the human readable label of a Product, falling back on the other plain text
+ * label fields when the preferred one is not filled by the BCB API in use.
+ * The HTML flavoured fields (labelHtml and friends) are never used.
+ * @param product Product to read the label from
+ * @returns The product label, or undefined when the Product carries none
+ */
+declare const extractProductLabel: (product: Product) => string | undefined;
+/**
+ * Creates a Medication from a Claude Bernard Product, keeping both its codes and its label.
+ * The Medication holds one Coding per code the Product carries (bcb-code, cip13-code, cis-code),
+ * each with the product label as `display`, and the same label as the CodeableConcept `text`.
+ * The Medication id is a UUID v4, so it differs from one call to the next.
+ * @param product Product to convert to a Medication resource
+ * @returns The Medication resource, or undefined when the Product carries no code at all
+ */
+declare function createMedicationFromProduct(product: Product): Medication | undefined;
+/**
+ * Creates a Bundle containing a Medication and its associated MedicationRequest for each Product.
+ * Each Medication keeps the product codes and label (see createMedicationFromProduct), and each
+ * MedicationRequest references its Medication without any dosage instruction.
+ * Products carrying no code at all are skipped and reported in the `errors` field.
+ * Every id, the Bundle one included, is a UUID v4, so they all differ from one call to
+ * the next, and every entry carries a fullUrl built as "<ResourceType>/<id>".
+ * @param products List of Products to convert to Medication / MedicationRequest resources
+ * @returns MappingResponse containing a Bundle with Medication and MedicationRequest resources
+ */
+declare function createMedicationsFromProducts(products: Product[]): MappingResponse<Bundle>;
 
+declare const medicationMapper_d_BCB_CODE_SYSTEM: typeof BCB_CODE_SYSTEM;
+declare const medicationMapper_d_CIP13_CODE_SYSTEM: typeof CIP13_CODE_SYSTEM;
+declare const medicationMapper_d_CIS_CODE_SYSTEM: typeof CIS_CODE_SYSTEM;
+declare const medicationMapper_d_createMedicationFromProduct: typeof createMedicationFromProduct;
 declare const medicationMapper_d_createMedicationsFromBcbCodes: typeof createMedicationsFromBcbCodes;
 declare const medicationMapper_d_createMedicationsFromCIP13Codes: typeof createMedicationsFromCIP13Codes;
 declare const medicationMapper_d_createMedicationsFromCISCodes: typeof createMedicationsFromCISCodes;
+declare const medicationMapper_d_createMedicationsFromProducts: typeof createMedicationsFromProducts;
 declare const medicationMapper_d_extractBcbCodesFromMedications: typeof extractBcbCodesFromMedications;
 declare const medicationMapper_d_extractCIP13CodesFromMedications: typeof extractCIP13CodesFromMedications;
 declare const medicationMapper_d_extractCISCodesFromMedications: typeof extractCISCodesFromMedications;
 declare const medicationMapper_d_extractCodesFromMedications: typeof extractCodesFromMedications;
+declare const medicationMapper_d_extractProductLabel: typeof extractProductLabel;
 declare const medicationMapper_d_generateMedicationId: typeof generateMedicationId;
 declare namespace medicationMapper_d {
   export {
+    medicationMapper_d_BCB_CODE_SYSTEM as BCB_CODE_SYSTEM,
+    medicationMapper_d_CIP13_CODE_SYSTEM as CIP13_CODE_SYSTEM,
+    medicationMapper_d_CIS_CODE_SYSTEM as CIS_CODE_SYSTEM,
+    medicationMapper_d_createMedicationFromProduct as createMedicationFromProduct,
     medicationMapper_d_createMedicationsFromBcbCodes as createMedicationsFromBcbCodes,
     medicationMapper_d_createMedicationsFromCIP13Codes as createMedicationsFromCIP13Codes,
     medicationMapper_d_createMedicationsFromCISCodes as createMedicationsFromCISCodes,
+    medicationMapper_d_createMedicationsFromProducts as createMedicationsFromProducts,
     medicationMapper_d_extractBcbCodesFromMedications as extractBcbCodesFromMedications,
     medicationMapper_d_extractCIP13CodesFromMedications as extractCIP13CodesFromMedications,
     medicationMapper_d_extractCISCodesFromMedications as extractCISCodesFromMedications,
     medicationMapper_d_extractCodesFromMedications as extractCodesFromMedications,
+    medicationMapper_d_extractProductLabel as extractProductLabel,
     medicationMapper_d_generateMedicationId as generateMedicationId,
   };
 }

package/dist/index.js

@@ -1439,6 +1439,9 @@ const generateUuidV4 = () => {
     ].join('-');
 };
 
+const BCB_CODE_SYSTEM = "https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code";
+const CIP13_CODE_SYSTEM = "http://terminology.hl7.org/CodeSystem/cip13-code";
+const CIS_CODE_SYSTEM = "http://terminology.hl7.org/CodeSystem/cis-code";
 /**
  * Generate a hash-based ID for a medication based on its codes
  */
@@ -1485,30 +1488,30 @@ function extractCodesFromMedications(bundle, system) {
 }
 /**
  * Extracts a list of bcb-code strings from a Bundle containing Medication resources.
- * Only codes with system "https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code" are included.
+ * Only codes with system BCB_CODE_SYSTEM are included.
  * @param bundle Bundle containing Medication resources
  * @returns List of BCB codes
  */
 function extractBcbCodesFromMedications(bundle) {
-    return extractCodesFromMedications(bundle, "https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code");
+    return extractCodesFromMedications(bundle, BCB_CODE_SYSTEM);
 }
 /**
  * Extracts a list of cip13-code strings from a Bundle containing Medication resources.
- * Only codes with system "http://terminology.hl7.org/CodeSystem/cip13-code" are included.
+ * Only codes with system CIP13_CODE_SYSTEM are included.
  * @param bundle Bundle containing Medication resources
  * @returns List of CIP13 codes
  */
 function extractCIP13CodesFromMedications(bundle) {
-    return extractCodesFromMedications(bundle, "http://terminology.hl7.org/CodeSystem/cip13-code");
+    return extractCodesFromMedications(bundle, CIP13_CODE_SYSTEM);
 }
 /**
  * Extracts a list of cis-code strings from a Bundle containing Medication resources.
- * Only codes with system "http://terminology.hl7.org/CodeSystem/cis-code" are included.
+ * Only codes with system CIS_CODE_SYSTEM are included.
  * @param bundle Bundle containing Medication resources
  * @returns List of CIS codes
  */
 function extractCISCodesFromMedications(bundle) {
-    return extractCodesFromMedications(bundle, "http://terminology.hl7.org/CodeSystem/cis-code");
+    return extractCodesFromMedications(bundle, CIS_CODE_SYSTEM);
 }
 /**
  * Wraps a resource into a Bundle entry, carrying its fullUrl as "<ResourceType>/<id>"
@@ -1586,7 +1589,7 @@ const createMedicationsFromCodes = (codes, system) => {
  * @returns MappingResponse containing a Bundle with Medication and MedicationRequest resources
  */
 function createMedicationsFromBcbCodes(bcbCodes) {
-    return createMedicationsFromCodes(bcbCodes, "https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code");
+    return createMedicationsFromCodes(bcbCodes, BCB_CODE_SYSTEM);
 }
 /**
  * Creates a Bundle containing Medication resources from a list of CIP13 codes.
@@ -1596,7 +1599,7 @@ function createMedicationsFromBcbCodes(bcbCodes) {
  * @returns MappingResponse containing a Bundle with Medication and MedicationRequest resources
  */
 function createMedicationsFromCIP13Codes(cip13Codes) {
-    return createMedicationsFromCodes(cip13Codes, "http://terminology.hl7.org/CodeSystem/cip13-code");
+    return createMedicationsFromCodes(cip13Codes, CIP13_CODE_SYSTEM);
 }
 /**
  * Creates a Bundle containing Medication resources from a list of CIS codes.
@@ -1606,18 +1609,138 @@ function createMedicationsFromCIP13Codes(cip13Codes) {
  * @returns MappingResponse containing a Bundle with Medication and MedicationRequest resources
  */
 function createMedicationsFromCISCodes(cisCodes) {
-    return createMedicationsFromCodes(cisCodes, "http://terminology.hl7.org/CodeSystem/cis-code");
+    return createMedicationsFromCodes(cisCodes, CIS_CODE_SYSTEM);
+}
+/**
+ * Reads the human readable label of a Product, falling back on the other plain text
+ * label fields when the preferred one is not filled by the BCB API in use.
+ * The HTML flavoured fields (labelHtml and friends) are never used.
+ * @param product Product to read the label from
+ * @returns The product label, or undefined when the Product carries none
+ */
+const extractProductLabel = (product) => {
+    const label = product.labels?.label
+        ?? product.labels?.longLabel
+        ?? product.labels?.shortLabel;
+    return label?.trim() || undefined;
+};
+/**
+ * Builds one Coding per code the Product carries (bcb-code, cip13-code, cis-code),
+ * each one carrying the product label as its display.
+ */
+const buildProductCodings = (product) => {
+    const display = extractProductLabel(product);
+    const codes = [
+        { system: BCB_CODE_SYSTEM, code: product.code },
+        { system: CIP13_CODE_SYSTEM, code: product.properties?.codes?.cip13 ?? product.code13 },
+        { system: CIS_CODE_SYSTEM, code: product.properties?.codes?.cis }
+    ];
+    return codes
+        .filter(({ code }) => !!code)
+        .map(({ system, code }) => ({ system, code, ...(display ? { display } : {}) }));
+};
+/**
+ * Creates a Medication from a Claude Bernard Product, keeping both its codes and its label.
+ * The Medication holds one Coding per code the Product carries (bcb-code, cip13-code, cis-code),
+ * each with the product label as `display`, and the same label as the CodeableConcept `text`.
+ * The Medication id is a UUID v4, so it differs from one call to the next.
+ * @param product Product to convert to a Medication resource
+ * @returns The Medication resource, or undefined when the Product carries no code at all
+ */
+function createMedicationFromProduct(product) {
+    const coding = buildProductCodings(product);
+    if (coding.length === 0) {
+        return undefined;
+    }
+    const label = extractProductLabel(product);
+    return {
+        resourceType: 'Medication',
+        id: generateUuidV4(),
+        code: {
+            coding,
+            ...(label ? { text: label } : {})
+        }
+    };
+}
+/**
+ * Creates a Bundle containing a Medication and its associated MedicationRequest for each Product.
+ * Each Medication keeps the product codes and label (see createMedicationFromProduct), and each
+ * MedicationRequest references its Medication without any dosage instruction.
+ * Products carrying no code at all are skipped and reported in the `errors` field.
+ * Every id, the Bundle one included, is a UUID v4, so they all differ from one call to
+ * the next, and every entry carries a fullUrl built as "<ResourceType>/<id>".
+ * @param products List of Products to convert to Medication / MedicationRequest resources
+ * @returns MappingResponse containing a Bundle with Medication and MedicationRequest resources
+ */
+function createMedicationsFromProducts(products) {
+    if (!products || products.length === 0) {
+        return {
+            result: {
+                resourceType: "Bundle",
+                id: generateUuidV4(),
+                type: "collection",
+                entry: []
+            },
+            errors: []
+        };
+    }
+    const errors = [];
+    const medications = [];
+    products.forEach((product, index) => {
+        const medication = createMedicationFromProduct(product);
+        if (!medication) {
+            errors.push({
+                field: `products[${index}]`,
+                message: 'Product carries no bcb-code, cip13-code nor cis-code, no Medication created'
+            });
+            return;
+        }
+        medications.push(medication);
+    });
+    const medicationRequests = medications.map(medication => ({
+        resourceType: 'MedicationRequest',
+        id: generateUuidV4(),
+        status: 'active',
+        intent: 'order',
+        medication: {
+            reference: {
+                reference: `Medication/${medication.id}`
+            }
+        },
+        subject: {
+            reference: 'Patient/unknown'
+        }
+    }));
+    const bundle = {
+        resourceType: "Bundle",
+        id: generateUuidV4(),
+        type: "collection",
+        entry: [
+            ...medications.map(medication => toBundleEntry(medication)),
+            ...medicationRequests.map(medicationRequest => toBundleEntry(medicationRequest))
+        ]
+    };
+    return {
+        result: bundle,
+        errors
+    };
 }
 
 var medicationMapper = /*#__PURE__*/Object.freeze({
     __proto__: null,
+    BCB_CODE_SYSTEM: BCB_CODE_SYSTEM,
+    CIP13_CODE_SYSTEM: CIP13_CODE_SYSTEM,
+    CIS_CODE_SYSTEM: CIS_CODE_SYSTEM,
+    createMedicationFromProduct: createMedicationFromProduct,
     createMedicationsFromBcbCodes: createMedicationsFromBcbCodes,
     createMedicationsFromCIP13Codes: createMedicationsFromCIP13Codes,
     createMedicationsFromCISCodes: createMedicationsFromCISCodes,
+    createMedicationsFromProducts: createMedicationsFromProducts,
     extractBcbCodesFromMedications: extractBcbCodesFromMedications,
     extractCIP13CodesFromMedications: extractCIP13CodesFromMedications,
     extractCISCodesFromMedications: extractCISCodesFromMedications,
     extractCodesFromMedications: extractCodesFromMedications,
+    extractProductLabel: extractProductLabel,
     generateMedicationId: generateMedicationId
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudebernard/node-fhir-mapper",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "A simple FHIR / BCB resource mapper to help stay interoperable while still using the Claude Bernard intelligence",
   "type": "module",
   "main": "dist/index.js",