@openmrs/esm-stock-management-app 1.0.1-pre.327

package/src/stock-items/stock-items-table.resource.ts

@@ -0,0 +1,58 @@
+import { StockItemFilter, useStockItems } from "./stock-items.resource";
+import { useEffect, useMemo, useState } from "react";
+import { useTranslation } from "react-i18next";
+import { ResourceRepresentation } from "../core/api/api";
+import { usePagination } from "@openmrs/esm-framework";
+
+export function useStockItemsPages(v?: ResourceRepresentation) {
+  const { t } = useTranslation();
+
+  const pageSizes = [10, 20, 30, 40, 50];
+  const [currentPage, setCurrentPage] = useState(1);
+  const [currentPageSize, setPageSize] = useState(10);
+  const [searchString, setSearchString] = useState(null);
+
+  // Drug filter type
+  const [isDrug, setDrug] = useState("");
+
+  const [stockItemFilter, setStockItemFilter] = useState<StockItemFilter>({
+    startIndex: currentPage - 1,
+    v: v || ResourceRepresentation.Default,
+    limit: 10,
+    q: null,
+    totalCount: true,
+  });
+
+  const { items, isLoading, isError } = useStockItems(stockItemFilter);
+  const pagination = usePagination(items.results, currentPageSize);
+
+  useEffect(() => {
+    setStockItemFilter({
+      startIndex: currentPage - 1,
+      v: ResourceRepresentation.Default,
+      limit: currentPageSize,
+      q: searchString,
+      totalCount: true,
+      isDrug: isDrug,
+    });
+  }, [searchString, currentPage, currentPageSize, isDrug]);
+
+  return {
+    items: pagination.results,
+    pagination,
+    totalCount: items.totalCount,
+    currentPageSize,
+    currentPage,
+    setCurrentPage,
+    setPageSize,
+    pageSizes,
+    isLoading,
+    isError,
+    isDrug,
+    setDrug: (drug: string) => {
+      setCurrentPage(1);
+      setDrug(drug);
+    },
+    setSearchString,
+  };
+}

package/src/stock-items/stock-items-table.scss

@@ -0,0 +1,66 @@
+@use '@carbon/styles/scss/spacing';
+@use '@carbon/styles/scss/type';
+@import "~@openmrs/esm-styleguide/src/vars";
+@import '../root.scss';
+.headerBtnContainer {
+    background-color: $ui-background;
+    padding: spacing.$spacing-05;
+    text-align: right;
+  }
+
+  .tileContainer {
+    background-color: $ui-02;
+    border-top: 1px solid $ui-03;
+    padding: 5rem 0;
+  }
+  
+  .tile {
+    margin: auto;
+    width: fit-content;
+  }
+  
+  .tileContent {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+  }
+  .content {
+    @include type.type-style('heading-compact-02');
+    color: $text-02;
+    margin-bottom: 0.5rem;
+  }
+  
+  .helper {
+    @include type.type-style('body-compact-01');
+    color: $text-02;
+  }
+  
+  .separator {
+    @include type.type-style('body-compact-02');
+    color: $text-02;
+    width: 80%;
+    margin: 1.5rem auto;
+    overflow: hidden;
+    text-align: center;
+  
+    &::before,
+    &::after {
+      background-color: $text-03;
+      content: '';
+      display: inline-block;
+      height: 1px;
+      position: relative;
+      vertical-align: middle;
+      width: 50%;
+    }
+  
+    &::before {
+      right: 0.5rem;
+      margin-left: -50%;
+    }
+  
+    &::after {
+      left: 0.5rem;
+      margin-right: -50%;
+    }
+  }

package/src/stock-items/stock-items.component.tsx

@@ -0,0 +1,12 @@
+import React from "react";
+import StockItemsTableComponent from "./stock-items-table.component";
+
+const StockItems = () => {
+  return (
+    <div style={{ margin: "5px" }}>
+      <StockItemsTableComponent />
+    </div>
+  );
+};
+
+export default StockItems;

package/src/stock-items/stock-items.resource.ts

@@ -0,0 +1,365 @@
+import { openmrsFetch } from "@openmrs/esm-framework";
+import { ResourceFilterCriteria, toQueryParams } from "../core/api/api";
+import { PageableResult } from "../core/api/types/PageableResult";
+import {
+  InventoryGroupBy,
+  StockItemDTO,
+} from "../core/api/types/stockItem/StockItem";
+import { StockItemInventory } from "../core/api/types/stockItem/StockItemInventory";
+import useSWR from "swr";
+import { StockItemTransactionDTO } from "../core/api/types/stockItem/StockItemTransaction";
+import { StockOperationItemCost } from "../core/api/types/stockOperation/StockOperationItemCost";
+import { StockBatchDTO } from "../core/api/types/stockItem/StockBatchDTO";
+import { StockItemPackagingUOMDTO } from "../core/api/types/stockItem/StockItemPackagingUOM";
+import { StockRule } from "../core/api/types/stockItem/StockRule";
+
+export interface StockItemFilter extends ResourceFilterCriteria {
+  isDrug?: string | null | undefined;
+  drugUuid?: string | null;
+  conceptUuid?: string | null;
+}
+
+export interface StockItemTransactionFilter extends ResourceFilterCriteria {
+  stockItemUuid?: string | null;
+  partyUuid?: string | null;
+  stockOperationUuid?: string | null;
+  includeBatchNo?: boolean | null;
+  dateMin?: string | null;
+  dateMax?: string | null;
+  stockBatchUuid?: string | null | undefined;
+}
+
+export interface StockItemInventoryFilter extends ResourceFilterCriteria {
+  stockItemUuid?: string | null;
+  partyUuid?: string | null;
+  locationUuid?: string | null;
+  includeBatchNo?: boolean | null;
+  stockBatchUuid?: string | null;
+  groupBy?: InventoryGroupBy | null;
+  totalBy?: InventoryGroupBy | null;
+  stockOperationUuid?: string | null;
+  date?: string | null;
+  includeStockItemName?: "true" | "false" | "0" | "1";
+  excludeExpired?: boolean | null;
+}
+
+export interface StockItemPackagingUOMFilter extends ResourceFilterCriteria {
+  stockItemUuid?: string | null | undefined;
+}
+
+export interface StockBatchFilter extends ResourceFilterCriteria {
+  stockItemUuid?: string | null | undefined;
+  excludeExpired?: boolean | null;
+  includeStockItemName?: "true" | "false" | "0" | "1";
+}
+
+export interface StockInventoryResult
+  extends PageableResult<StockItemInventory> {
+  total: StockItemInventory[];
+}
+
+export interface StockRuleFilter extends ResourceFilterCriteria {
+  stockItemUuid?: string | null;
+  locationUuid?: string | null;
+}
+
+// getStockItems
+export function useStockItems(filter: StockItemFilter) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitem${toQueryParams(filter)}`;
+  const { data, error, isLoading } = useSWR<
+    {
+      data: PageableResult<StockItemDTO>;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+
+  return {
+    items: data?.data || <PageableResult<StockItemDTO>>{},
+    isLoading,
+    isError: error,
+  };
+}
+
+// getStockItemTransactions
+export function useStockItemTransactions(filter: StockItemTransactionFilter) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitemtransaction${toQueryParams(
+    filter
+  )}`;
+  const { data, error, isLoading } = useSWR<
+    {
+      data: PageableResult<StockItemTransactionDTO>;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+
+  return {
+    items: data?.data || <PageableResult<StockItemTransactionDTO>>{},
+    isLoading,
+    isError: error,
+  };
+}
+
+// getStockItemInventory
+export function useStockItemInventory(filter: StockItemInventoryFilter) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockiteminventory${toQueryParams(
+    filter
+  )}`;
+  const { data, error, isLoading } = useSWR<
+    {
+      data: StockInventoryResult;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+
+  return {
+    items: data?.data || <StockInventoryResult>{},
+    isLoading,
+    isError: error,
+  };
+}
+
+// getStockOperationItemsCost
+export function useStockOperationItemsCost(filter: string) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockoperationitemcost?v=default&stockOperationUuid=${filter}`;
+  const { data, error, isLoading } = useSWR<
+    {
+      data: PageableResult<StockOperationItemCost>;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+  return {
+    items: data.data ? data.data : [],
+    isLoading,
+    isError: error,
+  };
+}
+
+// getStockBatches
+export function useStockBatches(filter: StockBatchFilter) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockbatch${toQueryParams(
+    filter
+  )}`;
+  const { data, error, isLoading } = useSWR<
+    {
+      data: PageableResult<StockBatchDTO>;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+  return {
+    items: data?.data || <PageableResult<StockBatchDTO>>{},
+    isLoading,
+    isError: error,
+  };
+}
+
+// getStockItemPackagingUOMs
+export function useStockItemPackagingUOMs(filter: StockItemPackagingUOMFilter) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitempackaginguom${toQueryParams(
+    filter
+  )}`;
+  const { data, error, isLoading } = useSWR<
+    {
+      data: PageableResult<StockItemPackagingUOMDTO>;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+
+  return {
+    items: data?.data || <PageableResult<StockItemPackagingUOMDTO>>{},
+    isLoading,
+    isError: error,
+  };
+}
+
+// getStockItem
+export function useStockItem(id: string) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitem/${id}?v=full`;
+  const { data, error, isLoading } = useSWR<
+    {
+      data: StockItemDTO;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+  return {
+    item: data?.data || <StockItemDTO>{},
+    isLoading,
+    isError: error,
+  };
+}
+
+// deleteStockItems
+export function deleteStockItems(ids: string[]) {
+  let otherIds = ids.reduce((p, c, i) => {
+    if (i === 0) return p;
+    p += (p.length > 0 ? "," : "") + encodeURIComponent(c);
+    return p;
+  }, "");
+  if (otherIds.length > 0) {
+    otherIds = "?ids=" + otherIds;
+  }
+
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitem/${ids[0]}${otherIds}`;
+
+  const abortController = new AbortController();
+
+  return openmrsFetch(apiUrl, {
+    method: "DELETE",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+  });
+}
+
+// deleteStockItemPackagingUnit
+export function deleteStockItemPackagingUnit(id: string) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitempackaginguom/${id}`;
+  const abortController = new AbortController();
+
+  return openmrsFetch(apiUrl, {
+    method: "DELETE",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+  });
+}
+
+// createStockItem
+export function createStockItem(item: StockItemDTO) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitem`;
+  const abortController = new AbortController();
+  delete item.isDrug;
+  return openmrsFetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+    body: item,
+  });
+}
+
+// updateStockItem
+export function updateStockItem(item: StockItemDTO) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitem/${item.uuid}`;
+  const abortController = new AbortController();
+  delete item.isDrug;
+  delete item.dateCreated;
+  return openmrsFetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+    body: item,
+  });
+}
+
+// createStockItemPackagingUnit
+export function createStockItemPackagingUnit(item: StockItemPackagingUOMDTO) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitempackaginguom`;
+  const abortController = new AbortController();
+  return openmrsFetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+    body: item,
+  });
+}
+
+// updateStockItemPackagingUnit
+export function updateStockItemPackagingUnit(item: StockItemDTO, uuid: string) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitempackaginguom/${uuid}`;
+  const abortController = new AbortController();
+  return openmrsFetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+    body: item,
+  });
+}
+
+// importStockItem
+export function importStockItem(item: FormData) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockitemimport`;
+  const abortController = new AbortController();
+  return openmrsFetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+    body: item,
+  });
+}
+
+// stock rules
+// getStockRules
+export function useStockRules(filter: StockRuleFilter) {
+  console.warn("Rules filter: " + JSON.stringify(filter));
+  const apiUrl = `ws/rest/v1/stockmanagement/stockrule${toQueryParams(filter)}`;
+  const { data, error, isLoading } = useSWR<
+    {
+      data: PageableResult<StockRule>;
+    },
+    Error
+  >(apiUrl, openmrsFetch);
+
+  // return {
+  //   items: data.data ? data.data : [],
+  //   isLoading,
+  //   isError: error,
+  // };
+
+  return {
+    items: data?.data || <PageableResult<StockRule>>{},
+    isLoading,
+    isError: error,
+  };
+}
+
+// createStockRule
+export function createStockRule(item: StockRule) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockrule`;
+  const abortController = new AbortController();
+  return openmrsFetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+    body: item,
+  });
+}
+
+// updateStockRule
+export function updateStockRule(item: StockRule, uuid: string) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockrule/${uuid}`;
+  const abortController = new AbortController();
+  return openmrsFetch(apiUrl, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+    body: item,
+  });
+}
+
+// deleteStockRule
+export function deleteStockRule(id: string) {
+  const apiUrl = `ws/rest/v1/stockmanagement/stockrule/${id}`;
+  const abortController = new AbortController();
+  return openmrsFetch(apiUrl, {
+    method: "DELETE",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    signal: abortController.signal,
+  });
+}

package/src/stock-items/types.ts

@@ -0,0 +1,8 @@
+import { StockItemDTO } from "../core/api/types/stockItem/StockItem";
+import { StockOperationDTO } from "../core/api/types/stockOperation/StockOperationDTO";
+
+export type SaveStockItem = (item: StockItemDTO) => Promise<void>;
+export type SaveStockOperation = (item: StockOperationDTO) => Promise<void>;
+export type SaveStockOperationAction = (
+  item: StockOperationDTO
+) => Promise<void>;

package/src/stock-items/validationSchema.ts

@@ -0,0 +1,67 @@
+import { z } from "zod";
+
+const nullableString = z.string().max(255).nullish();
+
+// Stock item details
+export const stockItemDetailsSchema = z
+  .object({
+    isDrug: z.boolean(),
+    drugUuid: z.string().nullish(),
+    drugName: z.string().nullish(),
+    commonName: nullableString,
+    acronym: nullableString,
+    hasExpiration: z.boolean(),
+    expiryNotice: z.coerce.number().nullish(),
+    uuid: z.string().nullish(),
+    conceptUuid: z.string().nullish(),
+    conceptName: z.string().nullish(),
+    preferredVendorUuid: z.string().nullish(),
+    preferredVendorName: z.string().nullish(),
+    purchasePrice: z.number().nullish(),
+    purchasePriceUoMUuid: z.string().nullish(),
+    purchasePriceUoMName: z.string().nullish(),
+    categoryUuid: z.string().nullish(),
+    categoryName: z.string().nullish(),
+    dispensingUnitUuid: z.string().nullish(),
+    dispensingUnitName: z.string().nullish(),
+    dispensingUnitPackagingUoMUuid: z.string().nullish(),
+    dispensingUnitPackagingUoMName: z.string().nullish(),
+    defaultStockOperationsUoMUuid: z.string().nullish(),
+    defaultStockOperationsUoMName: z.string().nullish(),
+    reorderLevel: z.number().nullish(),
+    reorderLevelUoMUuid: z.string().nullish(),
+    reorderLevelUoMName: z.string().nullish(),
+    dateCreated: z.coerce.date().nullish(),
+    creatorGivenName: z.string().nullish(),
+    creatorFamilyName: z.string().nullish(),
+    voided: z.boolean().nullish(),
+  })
+  .refine(
+    ({ isDrug, drugUuid }) => {
+      return isDrug ? !!drugUuid : true;
+    },
+    {
+      message: "Drug required",
+      path: ["drugUuid"],
+    }
+  )
+  .refine(
+    ({ isDrug, dispensingUnitUuid }) => {
+      return isDrug ? !!dispensingUnitUuid : true;
+    },
+    {
+      message: "Dispensing Unit required",
+      path: ["dispensingUnitUuid"],
+    }
+  )
+  .refine(
+    ({ hasExpiration, expiryNotice }) => {
+      return hasExpiration ? !!expiryNotice : true;
+    },
+    {
+      message: "Expiry Notice required",
+      path: ["expiryNotice"],
+    }
+  );
+
+export type StockItemFormData = z.infer<typeof stockItemDetailsSchema>;

package/src/stock-locations/stock-locations-table.component.tsx

@@ -0,0 +1,69 @@
+import React from "react";
+import { useStockLocationPages } from "./stock-locations-table.resource";
+import {
+  Button,
+  DataTableSkeleton,
+  TableToolbarAction,
+  TableToolbarMenu,
+  TableToolbarSearch,
+  Tile,
+} from "@carbon/react";
+import styles from "../stock-items/stock-items-table.scss";
+import { ResourceRepresentation } from "../core/api/api";
+import DataList from "../core/components/table/table.component";
+import { useTranslation } from "react-i18next";
+
+interface StockLocationsTableProps {
+  status?: string;
+}
+
+const StockLocationsItems: React.FC<StockLocationsTableProps> = () => {
+  const { t } = useTranslation();
+
+  const { tableHeaders, tableRows, items, isLoadingLocations } =
+    useStockLocationPages({
+      v: ResourceRepresentation.Full,
+    });
+
+  const handleRefresh = () => {
+    // search.refetch()
+  };
+
+  const createStockItem = () => {
+    // search.refetch()
+  };
+
+  if (isLoadingLocations) {
+    return <DataTableSkeleton role="progressbar" />;
+  }
+
+  if (items?.length) {
+    return (
+      <DataList columns={tableHeaders} data={tableRows}>
+        {({ onInputChange }) => (
+          <>
+            <TableToolbarSearch persistent onChange={onInputChange} />
+            <TableToolbarMenu>
+              <TableToolbarAction onClick={handleRefresh}>
+                Refresh
+              </TableToolbarAction>
+            </TableToolbarMenu>
+            <Button onClick={createStockItem} size="md" kind="primary">
+              {t("stockmanagement.addnewlocation", "Add Location")}
+            </Button>
+          </>
+        )}
+      </DataList>
+    );
+  }
+
+  return (
+    <div className={styles.tileContainer}>
+      <Tile className={styles.tile}>
+        <p className={styles.content}>No stock items to display</p>
+      </Tile>
+    </div>
+  );
+};
+
+export default StockLocationsItems;