@thrustdevs/esm-medical-supply-orders-app 1.0.2-pre.6

package/jest.config.js

@@ -0,0 +1,8 @@
+const rootConfig = require('../../jest.config.js');
+
+const packageConfig = {
+  ...rootConfig,
+  collectCoverage: false,
+};
+
+module.exports = packageConfig;

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@thrustdevs/esm-medical-supply-orders-app",
+  "version": "1.0.2-pre.6",
+  "description": "Medical Supply Orders app for KenyaEMR",
+  "browser": "dist/kenyaemr-esm-medical-supply-orders-app.js",
+  "main": "src/index.ts",
+  "source": true,
+  "license": "MPL-2.0",
+  "homepage": "https://github.com/palladiumkenya/kenyaemr-esm-orders#readme",
+  "scripts": {
+    "start": "openmrs develop",
+    "serve": "webpack serve --mode=development",
+    "debug": "npm run serve",
+    "build": "webpack --mode production",
+    "analyze": "webpack --mode=production --env.analyze=true",
+    "lint": "eslint src --ext ts,tsx --ignore-pattern '**/*.test.ts' --ignore-pattern '**/*.test.tsx' --ignore-pattern '**/__tests__/**'",
+    "typescript": "tsc",
+    "extract-translations": "i18next 'src/**/*.component.tsx' 'src/index.ts' --config ../../tools/i18next-parser.config.js",
+    "test": "cross-env TZ=UTC jest --config jest.config.js --verbose false --passWithNoTests",
+    "test:watch": "cross-env TZ=UTC jest --watch --config jest.config.js",
+    "coverage": "yarn test --coverage"
+  },
+  "browserslist": [
+    "extends browserslist-config-openmrs"
+  ],
+  "keywords": [
+    "openmrs"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/palladiumkenya/kenyaemr-esm-orders#readme"
+  },
+  "bugs": {
+    "url": "git+https://github.com/palladiumkenya/kenyaemr-esm-orders#readme"
+  },
+  "dependencies": {
+    "fuzzy": "^0.1.3",
+    "lodash-es": "^4.17.15",
+    "react-to-print": "^2.14.13"
+  },
+  "peerDependencies": {
+    "@carbon/react": "^1.x",
+    "@openmrs/esm-framework": "6.x",
+    "@openmrs/esm-patient-common-lib": "9.x",
+    "react": "^18.1.0",
+    "react-i18next": "11.x",
+    "react-router-dom": "6.x",
+    "swr": "2.x"
+  },
+  "devDependencies": {
+    "@openmrs/esm-patient-common-lib": "^9.2.2",
+    "webpack": "^5.74.0"
+  },
+  "stableVersion": "1.0.1"
+}

package/src/config-schema.ts

@@ -0,0 +1,39 @@
+import { Type } from '@openmrs/esm-framework';
+
+export const configSchema = {
+  medicalSupplyQuantityUnitsConceptSetUuid: {
+    _type: Type.String,
+    _description: 'Medical Supply Quantity Units Concept SET UUID',
+    _default: '162402AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA',
+  },
+  orders: {
+    medicalSupplyOrderTypeUuid: {
+      _type: Type.UUID,
+      _description: "UUID for the 'Medical Supply' order type",
+      _default: 'dab3ab30-2feb-48ec-b4af-8332a0831b49',
+    },
+    medicalSupplyOrderableConcepts: {
+      _type: Type.Array,
+      _description:
+        'UUIDs of concepts that represent orderable medical supply. If an empty array `[]` is provided, every concept with class `Medical supply` will be considered orderable.',
+      _elements: {
+        _type: Type.UUID,
+      },
+      _default: [],
+    },
+  },
+};
+
+interface OrderReason {
+  medicalSupplyUuid: string;
+  required: boolean;
+  orderReasons: Array<string>;
+}
+export type MedicalSupplyConfig = {
+  medicalSupplyQuantityUnitsConceptSetUuid: string;
+  orders: {
+    medicalSupplyOrderableConcepts: Array<string>;
+    medicalSupplyOrderTypeUuid: string;
+  };
+  medicalSupplyWithOrderReasons: Array<OrderReason>;
+};

package/src/constants.ts

@@ -0,0 +1 @@
+export const moduleName = '@openmrs/esm-medical-supply-app';

package/src/declarations.d.ts

@@ -0,0 +1,6 @@
+declare module '@carbon/react';
+declare module '*.css';
+declare module '*.scss';
+declare module '*.png';
+
+declare type SideNavProps = object;

package/src/form/add-medical-supply-order/api.ts

@@ -0,0 +1,215 @@
+import useSWR from 'swr';
+import { type FetchResponse, openmrsFetch, restBaseUrl, showSnackbar } from '@openmrs/esm-framework';
+import type { OrderPost } from '@openmrs/esm-patient-common-lib';
+import useSWRImmutable from 'swr/immutable';
+import { type MedicalSupplyOrderBasketItem } from '../../types';
+
+export const careSettingUuid = '6f0c9a92-6f24-11e3-af88-005056821db0';
+
+export function useOrderReasons(conceptUuids: Array<string>) {
+  const shouldFetch = conceptUuids && conceptUuids.length > 0;
+  const url = shouldFetch ? getConceptReferenceUrls(conceptUuids) : null;
+  const { data, error, isLoading } = useSWRImmutable<FetchResponse<ConceptResponse>, Error>(
+    shouldFetch ? `${restBaseUrl}/${url[0]}` : null,
+    openmrsFetch,
+  );
+
+  const ob = data?.data;
+  const orderReasons = ob
+    ? Object.entries(ob).map(([key, value]) => ({
+        uuid: value.uuid,
+        display: value.display,
+      }))
+    : [];
+
+  if (error) {
+    showSnackbar({
+      title: error.name,
+      subtitle: error.message,
+      kind: 'error',
+    });
+  }
+
+  return { orderReasons: orderReasons, isLoading };
+}
+
+export interface MedicalSupplyOrderPost extends OrderPost {
+  quantity?: number;
+  quantityUnits?: string;
+}
+
+export function prepMedicalSupplyOrderPostData(
+  order: MedicalSupplyOrderBasketItem,
+  patientUuid: string,
+  encounterUuid: string,
+): MedicalSupplyOrderPost {
+  let payload = {};
+  if (order.action === 'NEW' || order.action === 'RENEW') {
+    payload = {
+      action: 'NEW',
+      type: 'medicalsupplyorder',
+      patient: patientUuid,
+      careSetting: careSettingUuid,
+      orderer: order.orderer,
+      encounter: encounterUuid,
+      concept: order.testType.conceptUuid,
+      instructions: order.instructions,
+      urgency: order.urgency,
+      quantity: order.quantity,
+      quantityUnits: order.quantityUnits,
+      brandName: order.brandName,
+    };
+    return payload;
+  } else if (order.action === 'REVISE') {
+    payload = {
+      action: 'REVISE',
+      type: 'medicalsupplyorder',
+      patient: patientUuid,
+      careSetting: order.careSetting,
+      orderer: order.orderer,
+      encounter: encounterUuid,
+      concept: order.testType.conceptUuid,
+      instructions: order.instructions,
+      urgency: order.urgency,
+      quantity: order.quantity,
+      quantityUnits: order.quantityUnits,
+      brandName: order.brandName,
+      previousOrder: order.previousOrder,
+    };
+    return payload;
+  } else if (order.action === 'DISCONTINUE') {
+    payload = {
+      action: 'DISCONTINUE',
+      type: 'medicalsupplyorder',
+      patient: patientUuid,
+      careSetting: order.careSetting,
+      orderer: order.orderer,
+      encounter: encounterUuid,
+      concept: order.testType.conceptUuid,
+      previousOrder: order.previousOrder,
+    };
+    return payload;
+  } else {
+    throw new Error(`Unknown order action: ${order.action}.`);
+  }
+}
+const chunkSize = 10;
+export function getConceptReferenceUrls(conceptUuids: Array<string>) {
+  const accumulator = [];
+  for (let i = 0; i < conceptUuids.length; i += chunkSize) {
+    accumulator.push(conceptUuids.slice(i, i + chunkSize));
+  }
+
+  return accumulator.map((partition) => `conceptreferences?references=${partition.join(',')}&v=custom:(uuid,display)`);
+}
+
+export type PostDataPrepMedicalSupplyOrderFunction = (
+  order: MedicalSupplyOrderBasketItem,
+  patientUuid: string,
+  encounterUuid: string,
+) => OrderPost;
+
+export interface ConceptAnswers {
+  display: string;
+  uuid: string;
+}
+export interface ConceptResponse {
+  uuid: string;
+  display: string;
+  datatype: {
+    uuid: string;
+    display: string;
+  };
+  answers: Array<ConceptAnswers>;
+  setMembers: Array<ConceptAnswers>;
+}
+
+export interface OpenmrsObject {
+  uuid: string;
+}
+
+export type BaseOpenmrsObject = OpenmrsObject;
+
+export interface SessionPriviledge {
+  uuid: string;
+  name: string;
+}
+
+export interface Person {
+  uuid: string;
+  display: string;
+}
+
+export interface Role {
+  role: string;
+  display: string;
+}
+export interface User {
+  uuid: string;
+  display: string;
+  givenName: string;
+  familyName: string;
+  firstName: string;
+  lastName: string;
+  person?: Person;
+  roles?: Role[];
+  privileges: SessionPriviledge[];
+}
+export interface Auditable extends OpenmrsObject {
+  creator: User;
+  dateCreated: Date;
+  changedBy: User;
+  dateChanged: Date;
+}
+export interface Retireable extends OpenmrsObject {
+  retired: boolean;
+  dateRetired: Date;
+  retiredBy: User;
+  retireReason: string;
+}
+
+export interface ConceptName extends BaseOpenmrsObject {
+  conceptNameId: number;
+  concept: Concept;
+  name: string;
+  localePreferred: boolean;
+  short: boolean;
+  preferred: boolean;
+  indexTerm: boolean;
+  synonym: boolean;
+  fullySpecifiedName: boolean;
+}
+export interface Concept extends BaseOpenmrsObject, Auditable, Retireable {
+  conceptId: number;
+  display: string;
+  set: boolean;
+  version: string;
+  names: ConceptName[];
+  name: ConceptName;
+  numeric: boolean;
+  complex: boolean;
+  shortNames: ConceptName[];
+  indexTerms: ConceptName[];
+  synonyms: ConceptName[];
+  setMembers: Concept[];
+  possibleValues: Concept[];
+  preferredName: ConceptName;
+  shortName: ConceptName;
+  fullySpecifiedName: ConceptName;
+  answers: Concept[];
+}
+
+export function useConceptById(id: string) {
+  const apiUrl = `ws/rest/v1/concept/${id}`;
+  const { data, error, isLoading } = useSWR<
+    {
+      data: Concept;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+  return {
+    items: data?.data || <Concept>{},
+    isLoading,
+    isError: error,
+  };
+}

package/src/form/add-medical-supply-order/medical-supply-order/add-medical-supply-order.scss

@@ -0,0 +1,44 @@
+@use '@carbon/styles/scss/type';
+@use '@carbon/styles/scss/spacing';
+@use '@openmrs/esm-styleguide/src/vars' as vars;
+
+.container {
+  position: relative;
+  min-height: var(--desktop-workspace-window-height);
+  background-color: white;
+  display: flex;
+  flex-direction: column;
+}
+
+.patientHeader {
+  padding: spacing.$spacing-03 spacing.$spacing-05 spacing.$spacing-06;
+  background-color: vars.$ui-01;
+
+  span:first-of-type {
+    margin-right: spacing.$spacing-03;
+  }
+
+  .text02 {
+    color: vars.$text-02;
+  }
+}
+
+.backButton {
+  padding: spacing.$spacing-03;
+
+  button {
+    display: flex;
+    padding-left: 0 !important;
+    margin: 0 spacing.$spacing-05;
+
+    svg {
+      order: 1;
+      margin-right: spacing.$spacing-03;
+      margin-left: 0 !important;
+    }
+
+    span {
+      order: 2;
+    }
+  }
+}

package/src/form/add-medical-supply-order/medical-supply-order/add-medical-supply-order.workspace.tsx

@@ -0,0 +1,67 @@
+import React, { useCallback, useState } from 'react';
+import classNames from 'classnames';
+import capitalize from 'lodash-es/capitalize';
+import { useTranslation } from 'react-i18next';
+import { Button } from '@carbon/react';
+import { ArrowLeft } from '@carbon/react/icons';
+import { age, formatDate, parseDate, useLayoutType, usePatient } from '@openmrs/esm-framework';
+import { type DefaultPatientWorkspaceProps, launchPatientWorkspace } from '@openmrs/esm-patient-common-lib';
+import { MedicalSupplyTypeSearch } from './medical-supply-type-search';
+import { MedicalSupplyOrderForm } from './medical-supply-form.component';
+import styles from './add-medical-supply-order.scss';
+import { type MedicalSupplyOrderBasketItem } from '../../../types';
+
+export interface AddMedicalSupplyOrderWorkspaceAdditionalProps {
+  order?: MedicalSupplyOrderBasketItem;
+}
+
+export interface AddMedicalSupplyOrderWorkspace
+  extends DefaultPatientWorkspaceProps,
+    AddMedicalSupplyOrderWorkspaceAdditionalProps {}
+
+export default function AddMedicalSupplyOrderWorkspace({
+  order: initialOrder,
+  closeWorkspace,
+  closeWorkspaceWithSavedChanges,
+  promptBeforeClosing,
+}: AddMedicalSupplyOrderWorkspace) {
+  const { t } = useTranslation();
+
+  const [currentMedicalSupplyOrder, setCurrentMedicalSupplyOrder] = useState(initialOrder);
+
+  const isTablet = useLayoutType() === 'tablet';
+
+  const cancelOrder = useCallback(() => {
+    closeWorkspace({
+      ignoreChanges: true,
+      onWorkspaceClose: () => launchPatientWorkspace('order-basket'),
+    });
+  }, [closeWorkspace]);
+
+  if (!currentMedicalSupplyOrder) {
+    return (
+      <>
+        <div className={styles.backButton}>
+          <Button
+            kind="ghost"
+            renderIcon={(props) => <ArrowLeft size={24} {...props} />}
+            iconDescription="Return to order basket"
+            size="sm"
+            onClick={cancelOrder}>
+            <span>{t('backToOrderBasket', 'Back to order basket')}</span>
+          </Button>
+        </div>
+        <MedicalSupplyTypeSearch openMedicalSupplyForm={setCurrentMedicalSupplyOrder} />
+      </>
+    );
+  } else {
+    return (
+      <MedicalSupplyOrderForm
+        initialOrder={currentMedicalSupplyOrder}
+        closeWorkspace={closeWorkspace}
+        closeWorkspaceWithSavedChanges={closeWorkspaceWithSavedChanges}
+        promptBeforeClosing={promptBeforeClosing}
+      />
+    );
+  }
+}