@claudebernard/web-component-fhir-utils 1.0.0

package/LICENSE.md

@@ -0,0 +1 @@
+# License

package/README.md

@@ -0,0 +1,118 @@
+# @claudebernard/web-component-fhir-utils
+
+Shared FHIR `Bundle` helpers for Claude Bernard medication web components (`bcb-medication-request-editor`, `bcb-therapeutic-alternative`) and the applications that embed them.
+
+These components take a small FHIR `collection` Bundle as input and emit a FHIR `transaction` Bundle describing exactly what changed — standard `Bundle.entry.request.method` semantics, no custom DTOs. This package gives you the two sides of that contract so you never write bespoke reconciliation code:
+
+- **Integrating an app?** Build the input Bundle, then apply the output Bundle back onto your own state.
+- **Building a component?** Use the same helpers to produce standards-compliant transaction diffs.
+
+See the full guide on the [Claude Bernard Developer Portal](https://platform.claudebernard.fr/doc) for the wider FHIR model.
+
+> **Status:** this package defines the target Bundle-in/Bundle-out contract. Check each component's own changelog for the version that adopts it — until then, refer to that component's `integration` doc for its current API.
+
+## Installation
+
+```
+npm install @claudebernard/web-component-fhir-utils
+```
+
+## Integrating an app
+
+Build the input Bundle, pushing whatever resources the component needs:
+
+```ts
+import { createCollectionBundle } from "@claudebernard/web-component-fhir-utils";
+
+const bundle = createCollectionBundle();
+bundle.entry.push({ resource: medication });
+bundle.entry.push({ resource: medicationRequest });
+```
+
+```html
+<bcb-medication-request-editor .medication="${bundle}"></bcb-medication-request-editor>
+```
+
+Apply the transaction Bundle the component emits back onto your own Bundle — this is the only integration code you need, and it never changes per component or per feature:
+
+```ts
+import { applyTransactionBundle } from "@claudebernard/web-component-fhir-utils";
+
+editor.addEventListener("fhir-changes", ({ detail }) => {
+  myPrescriptionBundle = applyTransactionBundle(myPrescriptionBundle, detail.bundle);
+});
+```
+
+`applyTransactionBundle` understands `POST` (append), `PUT` (replace by `resourceType` + `id`), and `DELETE` (remove by `resourceType` + `id`). Pass `{ onMissingTarget: "throw" }` if you'd rather fail loudly than silently insert/ignore when a `PUT`/`DELETE` targets a resource your Bundle doesn't have.
+
+## Building a component
+
+Produce diff entries with `createBundleEntry` / `createTransactionBundle`:
+
+```ts
+import { createBundleEntry, createTransactionBundle } from "@claudebernard/web-component-fhir-utils";
+
+const bundle = createTransactionBundle([
+  createBundleEntry(updatedResource, "PUT"),
+  createBundleEntry(newResource, "POST"),
+]);
+```
+
+For the common "this MedicationRequest replaces that one" case (dosage override, therapeutic alternative, ...), use `supersedeMedicationRequest` — it produces the on-hold `PUT` + linked, tagged `POST` pair as house convention dictates, so every component represents supersession the same way:
+
+```ts
+import { PriorPrescriptionReason, supersedeMedicationRequest } from "@claudebernard/web-component-fhir-utils";
+
+const entries = supersedeMedicationRequest(
+  originalMedicationRequest,
+  { dosageInstruction: newDosage },
+  PriorPrescriptionReason.DOSAGE_OVERRIDE,
+);
+```
+
+Which produces a diff shaped like this — the original request goes `on-hold` via `PUT`, the new one is created `active` via `POST` and linked back through `priorPrescription`:
+
+```json
+{
+  "resourceType": "Bundle",
+  "type": "transaction",
+  "entry": [
+    {
+      "resource": { "resourceType": "MedicationRequest", "id": "mr-123", "status": "on-hold", "...": "..." },
+      "request": { "method": "PUT", "url": "MedicationRequest/mr-123" }
+    },
+    {
+      "resource": {
+        "resourceType": "MedicationRequest",
+        "id": "mr-456",
+        "status": "active",
+        "dosageInstruction": ["..."],
+        "priorPrescription": {
+          "reference": "MedicationRequest/mr-123",
+          "extension": [{ "url": "https://platform.claudebernard.fr/fhir/StructureDefinition/prior-prescription-reason", "valueCode": "dosage-override" }]
+        }
+      },
+      "request": { "method": "POST", "url": "MedicationRequest" }
+    }
+  ]
+}
+```
+
+More worked examples (including the therapeutic-alternative case) are in the [Developer Portal](https://platform.claudebernard.fr/doc) guide.
+
+## API
+
+| Export | Purpose |
+|---|---|
+| `createCollectionBundle(resources?)` | Build the input `collection` Bundle |
+| `createBundleEntry(resource, method, url?)` | Build one transaction entry (`POST`/`PUT`/`DELETE`) |
+| `createTransactionBundle(entries)` | Wrap entries into the output `transaction` Bundle |
+| `applyTransactionBundle(target, transaction, options?)` | Apply a transaction Bundle onto a Bundle you hold |
+| `findResourceInBundle(bundle, resourceType, id)` | Look up a resource by type + id |
+| `supersedeMedicationRequest(original, changes, reason)` | Build the on-hold/`priorPrescription`/extension pair for a supersession |
+| `hasPriorPrescriptionReason(medicationRequest, reason)` | Check why a `MedicationRequest` supersedes another |
+| `PriorPrescriptionReason`, `PRIOR_PRESCRIPTION_REASON_URL`, `BCB_CODE_SYSTEM` | Shared constants |
+
+## License
+
+Copyright of Cegedim. See [LICENSE](LICENSE.md) for details.

package/dist/bundle/apply-transaction-bundle.d.ts

@@ -0,0 +1,19 @@
+import type { Bundle } from "fhir/r5";
+export interface ApplyTransactionBundleOptions {
+    /**
+     * What to do when a PUT/DELETE entry targets a resource that isn't found
+     * in the target Bundle. "append" (default) turns a missing PUT into an
+     * insert and silently ignores a missing DELETE; "throw" surfaces it as an
+     * error, useful when the caller wants to catch a sync bug between its own
+     * state and the Bundle the component was given.
+     */
+    onMissingTarget?: "append" | "throw";
+}
+/**
+ * Applies a transaction Bundle (as emitted by a component) onto a Bundle an
+ * integrator already holds, following standard FHIR
+ * `Bundle.entry.request.method` semantics. This is the one generic function
+ * integrators need — it never needs to change per component or per feature.
+ */
+export declare function applyTransactionBundle(target: Bundle, transaction: Bundle, options?: ApplyTransactionBundleOptions): Bundle;
+//# sourceMappingURL=apply-transaction-bundle.d.ts.map

package/dist/bundle/apply-transaction-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-transaction-bundle.d.ts","sourceRoot":"","sources":["../../src/bundle/apply-transaction-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA6B,MAAM,SAAS,CAAC;AAEjE,MAAM,WAAW,6BAA6B;IAC5C;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,6BAAkC,GAC1C,MAAM,CAyCR"}

package/dist/bundle/apply-transaction-bundle.js

@@ -0,0 +1,46 @@
+/**
+ * Applies a transaction Bundle (as emitted by a component) onto a Bundle an
+ * integrator already holds, following standard FHIR
+ * `Bundle.entry.request.method` semantics. This is the one generic function
+ * integrators need — it never needs to change per component or per feature.
+ */
+export function applyTransactionBundle(target, transaction, options = {}) {
+    const { onMissingTarget = "append" } = options;
+    const entries = [...(target.entry ?? [])];
+    for (const txEntry of transaction.entry ?? []) {
+        const resource = txEntry.resource;
+        const method = txEntry.request?.method;
+        if (!resource || !method) {
+            continue;
+        }
+        const index = entries.findIndex(entry => entry.resource?.resourceType === resource.resourceType && entry.resource?.id === resource.id);
+        switch (method) {
+            case "POST":
+                entries.push({ resource, fullUrl: `urn:uuid:${resource.id}` });
+                break;
+            case "PUT":
+                if (index >= 0) {
+                    entries[index] = { ...entries[index], resource };
+                }
+                else if (onMissingTarget === "append") {
+                    entries.push({ resource });
+                }
+                else {
+                    throw new Error(`applyTransactionBundle: cannot PUT ${resource.resourceType}/${resource.id}, not found in target bundle`);
+                }
+                break;
+            case "DELETE":
+                if (index >= 0) {
+                    entries.splice(index, 1);
+                }
+                else if (onMissingTarget === "throw") {
+                    throw new Error(`applyTransactionBundle: cannot DELETE ${resource.resourceType}/${resource.id}, not found in target bundle`);
+                }
+                break;
+            default:
+                break;
+        }
+    }
+    return { ...target, entry: entries };
+}
+//# sourceMappingURL=apply-transaction-bundle.js.map

package/dist/bundle/apply-transaction-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-transaction-bundle.js","sourceRoot":"","sources":["../../src/bundle/apply-transaction-bundle.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAc,EACd,WAAmB,EACnB,UAAyC,EAAE;IAE3C,MAAM,EAAE,eAAe,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC/C,MAAM,OAAO,GAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;IAEzD,KAAK,MAAM,OAAO,IAAI,WAAW,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAoC,CAAC;QAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC;QACvC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAC7B,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,KAAK,QAAQ,CAAC,YAAY,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,QAAQ,CAAC,EAAE,CACtG,CAAC;QAEF,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC/D,MAAM;YACR,KAAK,KAAK;gBACR,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;gBACnD,CAAC;qBAAM,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;oBACxC,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;gBAC7B,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,EAAE,8BAA8B,CAAC,CAAC;gBAC5H,CAAC;gBACD,MAAM;YACR,KAAK,QAAQ;gBACX,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;oBACf,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC3B,CAAC;qBAAM,IAAI,eAAe,KAAK,OAAO,EAAE,CAAC;oBACvC,MAAM,IAAI,KAAK,CAAC,yCAAyC,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,EAAE,8BAA8B,CAAC,CAAC;gBAC/H,CAAC;gBACD,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACvC,CAAC","sourcesContent":["import type { Bundle, BundleEntry, FhirResource } from \"fhir/r5\";\n\nexport interface ApplyTransactionBundleOptions {\n  /**\n   * What to do when a PUT/DELETE entry targets a resource that isn't found\n   * in the target Bundle. \"append\" (default) turns a missing PUT into an\n   * insert and silently ignores a missing DELETE; \"throw\" surfaces it as an\n   * error, useful when the caller wants to catch a sync bug between its own\n   * state and the Bundle the component was given.\n   */\n  onMissingTarget?: \"append\" | \"throw\";\n}\n\n/**\n * Applies a transaction Bundle (as emitted by a component) onto a Bundle an\n * integrator already holds, following standard FHIR\n * `Bundle.entry.request.method` semantics. This is the one generic function\n * integrators need — it never needs to change per component or per feature.\n */\nexport function applyTransactionBundle(\n  target: Bundle,\n  transaction: Bundle,\n  options: ApplyTransactionBundleOptions = {},\n): Bundle {\n  const { onMissingTarget = \"append\" } = options;\n  const entries: BundleEntry[] = [...(target.entry ?? [])];\n\n  for (const txEntry of transaction.entry ?? []) {\n    const resource = txEntry.resource as FhirResource | undefined;\n    const method = txEntry.request?.method;\n    if (!resource || !method) {\n      continue;\n    }\n\n    const index = entries.findIndex(\n      entry => entry.resource?.resourceType === resource.resourceType && entry.resource?.id === resource.id,\n    );\n\n    switch (method) {\n      case \"POST\":\n        entries.push({ resource, fullUrl: `urn:uuid:${resource.id}` });\n        break;\n      case \"PUT\":\n        if (index >= 0) {\n          entries[index] = { ...entries[index], resource };\n        } else if (onMissingTarget === \"append\") {\n          entries.push({ resource });\n        } else {\n          throw new Error(`applyTransactionBundle: cannot PUT ${resource.resourceType}/${resource.id}, not found in target bundle`);\n        }\n        break;\n      case \"DELETE\":\n        if (index >= 0) {\n          entries.splice(index, 1);\n        } else if (onMissingTarget === \"throw\") {\n          throw new Error(`applyTransactionBundle: cannot DELETE ${resource.resourceType}/${resource.id}, not found in target bundle`);\n        }\n        break;\n      default:\n        break;\n    }\n  }\n\n  return { ...target, entry: entries };\n}\n"]}

package/dist/bundle/create-collection-bundle.d.ts

@@ -0,0 +1,14 @@
+import type { Bundle, FhirResource } from "fhir/r5";
+/**
+ * Builds the small FHIR `collection` Bundle a component expects as input:
+ * integrators create it once, then push whatever resources are relevant
+ * to the edit onto `.entry`, or pass them up front.
+ *
+ *   const bundle = createCollectionBundle();
+ *   bundle.entry.push({ resource: medication });
+ *   bundle.entry.push({ resource: medicationRequest });
+ */
+export declare function createCollectionBundle(resources?: FhirResource[]): Bundle & {
+    entry: NonNullable<Bundle["entry"]>;
+};
+//# sourceMappingURL=create-collection-bundle.d.ts.map

package/dist/bundle/create-collection-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-collection-bundle.d.ts","sourceRoot":"","sources":["../../src/bundle/create-collection-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,YAAY,EAAO,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;CAAE,CAMvH"}

package/dist/bundle/create-collection-bundle.js

@@ -0,0 +1,17 @@
+/**
+ * Builds the small FHIR `collection` Bundle a component expects as input:
+ * integrators create it once, then push whatever resources are relevant
+ * to the edit onto `.entry`, or pass them up front.
+ *
+ *   const bundle = createCollectionBundle();
+ *   bundle.entry.push({ resource: medication });
+ *   bundle.entry.push({ resource: medicationRequest });
+ */
+export function createCollectionBundle(resources = []) {
+    return {
+        resourceType: "Bundle",
+        type: "collection",
+        entry: resources.map(resource => ({ resource })),
+    };
+}
+//# sourceMappingURL=create-collection-bundle.js.map

package/dist/bundle/create-collection-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-collection-bundle.js","sourceRoot":"","sources":["../../src/bundle/create-collection-bundle.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAA4B,EAAE;IACnE,OAAO;QACL,YAAY,EAAE,QAAQ;QACtB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;KACjD,CAAC;AACJ,CAAC","sourcesContent":["import type { Bundle, FhirResource } from \"fhir/r5\";\n\n/**\n * Builds the small FHIR `collection` Bundle a component expects as input:\n * integrators create it once, then push whatever resources are relevant\n * to the edit onto `.entry`, or pass them up front.\n *\n *   const bundle = createCollectionBundle();\n *   bundle.entry.push({ resource: medication });\n *   bundle.entry.push({ resource: medicationRequest });\n */\nexport function createCollectionBundle(resources: FhirResource[] = []): Bundle & { entry: NonNullable<Bundle[\"entry\"]> } {\n  return {\n    resourceType: \"Bundle\",\n    type: \"collection\",\n    entry: resources.map(resource => ({ resource })),\n  };\n}\n"]}

package/dist/bundle/create-transaction-bundle.d.ts

@@ -0,0 +1,14 @@
+import type { Bundle, BundleEntry, FhirResource } from "fhir/r5";
+export type TransactionMethod = "POST" | "PUT" | "DELETE";
+/**
+ * Builds a single transaction Bundle entry with standard FHIR
+ * `Bundle.entry.request` semantics (method + url).
+ */
+export declare function createBundleEntry(resource: FhirResource, method: TransactionMethod, url?: string): BundleEntry;
+/**
+ * Wraps a list of entries (built with `createBundleEntry`, or one of the
+ * higher-level helpers such as `supersedeMedicationRequest`) into the
+ * `transaction`-type Bundle a component emits as its output.
+ */
+export declare function createTransactionBundle(entries: BundleEntry[]): Bundle;
+//# sourceMappingURL=create-transaction-bundle.d.ts.map

package/dist/bundle/create-transaction-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-transaction-bundle.d.ts","sourceRoot":"","sources":["../../src/bundle/create-transaction-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEjE,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAS1D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAQ9G;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAMtE"}

package/dist/bundle/create-transaction-bundle.js

@@ -0,0 +1,32 @@
+function defaultUrlFor(resource, method) {
+    if (method === "POST") {
+        return resource.resourceType;
+    }
+    return `${resource.resourceType}/${resource.id}`;
+}
+/**
+ * Builds a single transaction Bundle entry with standard FHIR
+ * `Bundle.entry.request` semantics (method + url).
+ */
+export function createBundleEntry(resource, method, url) {
+    return {
+        resource,
+        request: {
+            method,
+            url: url ?? defaultUrlFor(resource, method),
+        },
+    };
+}
+/**
+ * Wraps a list of entries (built with `createBundleEntry`, or one of the
+ * higher-level helpers such as `supersedeMedicationRequest`) into the
+ * `transaction`-type Bundle a component emits as its output.
+ */
+export function createTransactionBundle(entries) {
+    return {
+        resourceType: "Bundle",
+        type: "transaction",
+        entry: entries,
+    };
+}
+//# sourceMappingURL=create-transaction-bundle.js.map

package/dist/bundle/create-transaction-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-transaction-bundle.js","sourceRoot":"","sources":["../../src/bundle/create-transaction-bundle.ts"],"names":[],"mappings":"AAIA,SAAS,aAAa,CAAC,QAAsB,EAAE,MAAyB;IACtE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC,YAAY,CAAC;IAC/B,CAAC;IACD,OAAO,GAAG,QAAQ,CAAC,YAAY,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAsB,EAAE,MAAyB,EAAE,GAAY;IAC/F,OAAO;QACL,QAAQ;QACR,OAAO,EAAE;YACP,MAAM;YACN,GAAG,EAAE,GAAG,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC5C;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAsB;IAC5D,OAAO;QACL,YAAY,EAAE,QAAQ;QACtB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,OAAO;KACf,CAAC;AACJ,CAAC","sourcesContent":["import type { Bundle, BundleEntry, FhirResource } from \"fhir/r5\";\n\nexport type TransactionMethod = \"POST\" | \"PUT\" | \"DELETE\";\n\nfunction defaultUrlFor(resource: FhirResource, method: TransactionMethod): string {\n  if (method === \"POST\") {\n    return resource.resourceType;\n  }\n  return `${resource.resourceType}/${resource.id}`;\n}\n\n/**\n * Builds a single transaction Bundle entry with standard FHIR\n * `Bundle.entry.request` semantics (method + url).\n */\nexport function createBundleEntry(resource: FhirResource, method: TransactionMethod, url?: string): BundleEntry {\n  return {\n    resource,\n    request: {\n      method,\n      url: url ?? defaultUrlFor(resource, method),\n    },\n  };\n}\n\n/**\n * Wraps a list of entries (built with `createBundleEntry`, or one of the\n * higher-level helpers such as `supersedeMedicationRequest`) into the\n * `transaction`-type Bundle a component emits as its output.\n */\nexport function createTransactionBundle(entries: BundleEntry[]): Bundle {\n  return {\n    resourceType: \"Bundle\",\n    type: \"transaction\",\n    entry: entries,\n  };\n}\n"]}

package/dist/bundle/find-resource-in-bundle.d.ts

@@ -0,0 +1,7 @@
+import type { Bundle, FhirResource } from "fhir/r5";
+/**
+ * Finds a resource of a given type/id inside a Bundle's entries.
+ * Used both to build transaction diffs and to apply them.
+ */
+export declare function findResourceInBundle<T extends FhirResource = FhirResource>(bundle: Bundle | null | undefined, resourceType: T["resourceType"], id: string | undefined): T | undefined;
+//# sourceMappingURL=find-resource-in-bundle.d.ts.map

package/dist/bundle/find-resource-in-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-resource-in-bundle.d.ts","sourceRoot":"","sources":["../../src/bundle/find-resource-in-bundle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EACxE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,YAAY,EAAE,CAAC,CAAC,cAAc,CAAC,EAC/B,EAAE,EAAE,MAAM,GAAG,SAAS,GACrB,CAAC,GAAG,SAAS,CAOf"}

package/dist/bundle/find-resource-in-bundle.js

@@ -0,0 +1,11 @@
+/**
+ * Finds a resource of a given type/id inside a Bundle's entries.
+ * Used both to build transaction diffs and to apply them.
+ */
+export function findResourceInBundle(bundle, resourceType, id) {
+    if (!id) {
+        return undefined;
+    }
+    return bundle?.entry?.find(entry => entry.resource?.resourceType === resourceType && entry.resource?.id === id)?.resource;
+}
+//# sourceMappingURL=find-resource-in-bundle.js.map

package/dist/bundle/find-resource-in-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-resource-in-bundle.js","sourceRoot":"","sources":["../../src/bundle/find-resource-in-bundle.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAiC,EACjC,YAA+B,EAC/B,EAAsB;IAEtB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,EAAE,KAAK,EAAE,IAAI,CACxB,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,YAAY,KAAK,YAAY,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CACpF,EAAE,QAAyB,CAAC;AAC/B,CAAC","sourcesContent":["import type { Bundle, FhirResource } from \"fhir/r5\";\n\n/**\n * Finds a resource of a given type/id inside a Bundle's entries.\n * Used both to build transaction diffs and to apply them.\n */\nexport function findResourceInBundle<T extends FhirResource = FhirResource>(\n  bundle: Bundle | null | undefined,\n  resourceType: T[\"resourceType\"],\n  id: string | undefined,\n): T | undefined {\n  if (!id) {\n    return undefined;\n  }\n  return bundle?.entry?.find(\n    entry => entry.resource?.resourceType === resourceType && entry.resource?.id === id,\n  )?.resource as T | undefined;\n}\n"]}

package/dist/bundle/supersede-resource.d.ts

@@ -0,0 +1,19 @@
+import type { BundleEntry, MedicationRequest } from "fhir/r5";
+import { PriorPrescriptionReason } from "../constants/prior-prescription.const";
+/**
+ * Checks whether a MedicationRequest is the result of a supersession for a
+ * given reason (e.g. a dosage override, or a therapeutic-alternative swap),
+ * as tagged by `supersedeMedicationRequest`.
+ */
+export declare function hasPriorPrescriptionReason(medicationRequest: MedicationRequest | null | undefined, reason: PriorPrescriptionReason): boolean;
+/**
+ * Standard house pattern for representing "this MedicationRequest replaces
+ * that one" as a transaction Bundle diff: the original is put `on-hold` via
+ * PUT, and a new `active` MedicationRequest is created via POST, linked back
+ * through `priorPrescription` and tagged with why via the
+ * `prior-prescription-reason` extension.
+ *
+ * Returns the two entries ready to hand to `createTransactionBundle`.
+ */
+export declare function supersedeMedicationRequest(original: MedicationRequest, changes: Partial<MedicationRequest>, reason: PriorPrescriptionReason): BundleEntry[];
+//# sourceMappingURL=supersede-resource.d.ts.map

package/dist/bundle/supersede-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersede-resource.d.ts","sourceRoot":"","sources":["../../src/bundle/supersede-resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAiC,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAG/G;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EACvD,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACnC,MAAM,EAAE,uBAAuB,GAC9B,WAAW,EAAE,CAsBf"}

package/dist/bundle/supersede-resource.js

@@ -0,0 +1,41 @@
+import { PRIOR_PRESCRIPTION_REASON_URL } from "../constants/prior-prescription.const";
+import { createBundleEntry } from "./create-transaction-bundle";
+/**
+ * Checks whether a MedicationRequest is the result of a supersession for a
+ * given reason (e.g. a dosage override, or a therapeutic-alternative swap),
+ * as tagged by `supersedeMedicationRequest`.
+ */
+export function hasPriorPrescriptionReason(medicationRequest, reason) {
+    const extension = medicationRequest?.priorPrescription?.extension?.find(ext => ext.url === PRIOR_PRESCRIPTION_REASON_URL);
+    return extension?.valueCode === reason;
+}
+/**
+ * Standard house pattern for representing "this MedicationRequest replaces
+ * that one" as a transaction Bundle diff: the original is put `on-hold` via
+ * PUT, and a new `active` MedicationRequest is created via POST, linked back
+ * through `priorPrescription` and tagged with why via the
+ * `prior-prescription-reason` extension.
+ *
+ * Returns the two entries ready to hand to `createTransactionBundle`.
+ */
+export function supersedeMedicationRequest(original, changes, reason) {
+    if (!original.id) {
+        throw new Error("supersedeMedicationRequest: original MedicationRequest must have an id");
+    }
+    const onHoldOriginal = { ...original, status: "on-hold" };
+    const superseding = {
+        ...structuredClone(original),
+        ...changes,
+        id: crypto.randomUUID(),
+        status: "active",
+        priorPrescription: {
+            reference: `MedicationRequest/${original.id}`,
+            extension: [{ url: PRIOR_PRESCRIPTION_REASON_URL, valueCode: reason }],
+        },
+    };
+    return [
+        createBundleEntry(onHoldOriginal, "PUT"),
+        createBundleEntry(superseding, "POST"),
+    ];
+}
+//# sourceMappingURL=supersede-resource.js.map

package/dist/bundle/supersede-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supersede-resource.js","sourceRoot":"","sources":["../../src/bundle/supersede-resource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAA2B,MAAM,uCAAuC,CAAC;AAC/G,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,iBAAuD,EACvD,MAA+B;IAE/B,MAAM,SAAS,GAAG,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,IAAI,CACrE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,6BAA6B,CACjD,CAAC;IACF,OAAO,SAAS,EAAE,SAAS,KAAK,MAAM,CAAC;AACzC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACxC,QAA2B,EAC3B,OAAmC,EACnC,MAA+B;IAE/B,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IAED,MAAM,cAAc,GAAsB,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAE7E,MAAM,WAAW,GAAsB;QACrC,GAAG,eAAe,CAAC,QAAQ,CAAC;QAC5B,GAAG,OAAO;QACV,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,MAAM,EAAE,QAAQ;QAChB,iBAAiB,EAAE;YACjB,SAAS,EAAE,qBAAqB,QAAQ,CAAC,EAAE,EAAE;YAC7C,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,6BAA6B,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;SACvE;KACF,CAAC;IAEF,OAAO;QACL,iBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC;QACxC,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC;KACvC,CAAC;AACJ,CAAC","sourcesContent":["import type { BundleEntry, MedicationRequest } from \"fhir/r5\";\nimport { PRIOR_PRESCRIPTION_REASON_URL, PriorPrescriptionReason } from \"../constants/prior-prescription.const\";\nimport { createBundleEntry } from \"./create-transaction-bundle\";\n\n/**\n * Checks whether a MedicationRequest is the result of a supersession for a\n * given reason (e.g. a dosage override, or a therapeutic-alternative swap),\n * as tagged by `supersedeMedicationRequest`.\n */\nexport function hasPriorPrescriptionReason(\n  medicationRequest: MedicationRequest | null | undefined,\n  reason: PriorPrescriptionReason,\n): boolean {\n  const extension = medicationRequest?.priorPrescription?.extension?.find(\n    ext => ext.url === PRIOR_PRESCRIPTION_REASON_URL,\n  );\n  return extension?.valueCode === reason;\n}\n\n/**\n * Standard house pattern for representing \"this MedicationRequest replaces\n * that one\" as a transaction Bundle diff: the original is put `on-hold` via\n * PUT, and a new `active` MedicationRequest is created via POST, linked back\n * through `priorPrescription` and tagged with why via the\n * `prior-prescription-reason` extension.\n *\n * Returns the two entries ready to hand to `createTransactionBundle`.\n */\nexport function supersedeMedicationRequest(\n  original: MedicationRequest,\n  changes: Partial<MedicationRequest>,\n  reason: PriorPrescriptionReason,\n): BundleEntry[] {\n  if (!original.id) {\n    throw new Error(\"supersedeMedicationRequest: original MedicationRequest must have an id\");\n  }\n\n  const onHoldOriginal: MedicationRequest = { ...original, status: \"on-hold\" };\n\n  const superseding: MedicationRequest = {\n    ...structuredClone(original),\n    ...changes,\n    id: crypto.randomUUID(),\n    status: \"active\",\n    priorPrescription: {\n      reference: `MedicationRequest/${original.id}`,\n      extension: [{ url: PRIOR_PRESCRIPTION_REASON_URL, valueCode: reason }],\n    },\n  };\n\n  return [\n    createBundleEntry(onHoldOriginal, \"PUT\"),\n    createBundleEntry(superseding, \"POST\"),\n  ];\n}\n"]}

package/dist/constants/prior-prescription.const.d.ts

@@ -0,0 +1,8 @@
+export declare const BCB_CODE_SYSTEM = "https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code";
+export declare const PRIOR_PRESCRIPTION_REASON_URL = "https://platform.claudebernard.fr/fhir/StructureDefinition/prior-prescription-reason";
+export declare const PriorPrescriptionReason: {
+    readonly DOSAGE_OVERRIDE: "dosage-override";
+    readonly THERAPEUTIC_ALTERNATIVE: "therapeutic-alternative";
+};
+export type PriorPrescriptionReason = typeof PriorPrescriptionReason[keyof typeof PriorPrescriptionReason];
+//# sourceMappingURL=prior-prescription.const.d.ts.map

package/dist/constants/prior-prescription.const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prior-prescription.const.d.ts","sourceRoot":"","sources":["../../src/constants/prior-prescription.const.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,+DAA+D,CAAC;AAE5F,eAAO,MAAM,6BAA6B,yFAAyF,CAAC;AAEpI,eAAO,MAAM,uBAAuB;;;CAG1B,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,MAAM,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/constants/prior-prescription.const.js

@@ -0,0 +1,7 @@
+export const BCB_CODE_SYSTEM = "https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code";
+export const PRIOR_PRESCRIPTION_REASON_URL = "https://platform.claudebernard.fr/fhir/StructureDefinition/prior-prescription-reason";
+export const PriorPrescriptionReason = {
+    DOSAGE_OVERRIDE: "dosage-override",
+    THERAPEUTIC_ALTERNATIVE: "therapeutic-alternative",
+};
+//# sourceMappingURL=prior-prescription.const.js.map

package/dist/constants/prior-prescription.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prior-prescription.const.js","sourceRoot":"","sources":["../../src/constants/prior-prescription.const.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,4DAA4D,CAAC;AAE5F,MAAM,CAAC,MAAM,6BAA6B,GAAG,sFAAsF,CAAC;AAEpI,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,eAAe,EAAE,iBAAiB;IAClC,uBAAuB,EAAE,yBAAyB;CAC1C,CAAC","sourcesContent":["export const BCB_CODE_SYSTEM = \"https://platform.claudebernard.fr/fhir/CodeSystem/bcb-code\";\n\nexport const PRIOR_PRESCRIPTION_REASON_URL = \"https://platform.claudebernard.fr/fhir/StructureDefinition/prior-prescription-reason\";\n\nexport const PriorPrescriptionReason = {\n  DOSAGE_OVERRIDE: \"dosage-override\",\n  THERAPEUTIC_ALTERNATIVE: \"therapeutic-alternative\",\n} as const;\n\nexport type PriorPrescriptionReason = typeof PriorPrescriptionReason[keyof typeof PriorPrescriptionReason];\n"]}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./constants/prior-prescription.const";
+export * from "./bundle/create-collection-bundle";
+export * from "./bundle/create-transaction-bundle";
+export * from "./bundle/apply-transaction-bundle";
+export * from "./bundle/find-resource-in-bundle";
+export * from "./bundle/supersede-resource";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./constants/prior-prescription.const";
+export * from "./bundle/create-collection-bundle";
+export * from "./bundle/create-transaction-bundle";
+export * from "./bundle/apply-transaction-bundle";
+export * from "./bundle/find-resource-in-bundle";
+export * from "./bundle/supersede-resource";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC","sourcesContent":["export * from \"./constants/prior-prescription.const\";\nexport * from \"./bundle/create-collection-bundle\";\nexport * from \"./bundle/create-transaction-bundle\";\nexport * from \"./bundle/apply-transaction-bundle\";\nexport * from \"./bundle/find-resource-in-bundle\";\nexport * from \"./bundle/supersede-resource\";\n"]}

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@claudebernard/web-component-fhir-utils",
+  "version": "1.0.0",
+  "description": "Shared FHIR Bundle utilities (collection/transaction bundles, prior-prescription linking) for Claude Bernard web components and their integrators.",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "module": "dist/index.js",
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./constants/prior-prescription": {
+      "types": "./dist/constants/prior-prescription.const.d.ts",
+      "import": "./dist/constants/prior-prescription.const.js"
+    },
+    "./bundle/create-collection-bundle": {
+      "types": "./dist/bundle/create-collection-bundle.d.ts",
+      "import": "./dist/bundle/create-collection-bundle.js"
+    },
+    "./bundle/create-transaction-bundle": {
+      "types": "./dist/bundle/create-transaction-bundle.d.ts",
+      "import": "./dist/bundle/create-transaction-bundle.js"
+    },
+    "./bundle/apply-transaction-bundle": {
+      "types": "./dist/bundle/apply-transaction-bundle.d.ts",
+      "import": "./dist/bundle/apply-transaction-bundle.js"
+    },
+    "./bundle/find-resource-in-bundle": {
+      "types": "./dist/bundle/find-resource-in-bundle.d.ts",
+      "import": "./dist/bundle/find-resource-in-bundle.js"
+    },
+    "./bundle/supersede-resource": {
+      "types": "./dist/bundle/supersede-resource.d.ts",
+      "import": "./dist/bundle/supersede-resource.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "claude-bernard",
+    "fhir",
+    "typescript",
+    "web-components"
+  ],
+  "author": "Claude Bernard",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@types/fhir": "^0.0.41"
+  },
+  "devDependencies": {
+    "@stylistic/eslint-plugin": "^5.9.0",
+    "@types/fhir": "^0.0.41",
+    "@types/node": "^25.3.0",
+    "@typescript-eslint/eslint-plugin": "8.65.0",
+    "@typescript-eslint/parser": "8.65.0",
+    "@vitest/coverage-v8": "^4.1.10",
+    "eslint": "^9.38.0",
+    "eslint-plugin-import": "2.32.0",
+    "typescript": "~5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "release": {
+    "tagFormat": "${version}",
+    "branches": ["master"],
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      "@semantic-release/changelog",
+      [
+        "semantic-release-replace-plugin",
+        {
+          "replacements": [
+            {
+              "files": ["package.json"],
+              "from": "\"version\": \"\\d+\\.\\d+\\.\\d+\"",
+              "to": "\"version\": \"${nextRelease.version}\"",
+              "results": [
+                {
+                  "file": "package.json",
+                  "hasChanged": true
+                }
+              ]
+            }
+          ]
+        }
+      ],
+      [
+        "@semantic-release/git",
+        {
+          "message": "chore(release): ${nextRelease.version} [skip ci on prod]",
+          "assets": ["package.json", "CHANGELOG.md"]
+        }
+      ],
+      "@semantic-release/gitlab"
+    ]
+  }
+}