@ampath/esm-reports-app 1.0.0-next.8 → 1.0.0-next.80

package/src/root.scss

@@ -1,10 +1,25 @@
 @use '@carbon/layout';
 @use '@carbon/type';
+@use '@openmrs/esm-styleguide/src/vars' as *;
+
+/* Single gutter for every route, so the dashboard and the individual reports
+   all clear the left nav by the same amount. */
+.page {
+  box-sizing: border-box;
+  min-height: 100%;
+  padding: 0 layout.$spacing-06;
+}
 
 .container {
   padding: layout.$spacing-07;
 }
 
+@media (max-width: $breakpoint-tablet-max) {
+  .page {
+    padding: 0 layout.$spacing-05;
+  }
+}
+
 .welcome {
   @include type.type-style('heading-04');
   margin: layout.$spacing-05 0;
@@ -13,3 +28,24 @@
 .explainer {
   margin-bottom: layout.$spacing-07;
 }
+
+/* Printing a report should put the report on the paper, not the application
+   around it. Every route renders inside `.page`, so the chrome is hidden once
+   here; the filter bar hides itself (see report-filters.scss), and a report
+   with its own sheet geometry (MOH-731) refines this further. */
+
+@media print {
+
+  .page,
+  .page * {
+    visibility: visible;
+  }
+
+  .page {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    padding: 0;
+  }
+}

package/src/routes.json

@@ -9,6 +9,7 @@
       "name": "ampath-reports-dashboard-link",
       "component": "reportsDashboardLink",
       "slot": "homepage-dashboard-slot",
+      "privileges": ["O3 View Reports Dashboard"],
       "meta": {
         "name": "reports",
         "slot": "ampath-reports-dashboard-slot",
@@ -20,7 +21,8 @@
     {
       "component": "root",
       "name": "ampath-reports-dashboard-root",
-      "slot": "ampath-reports-dashboard-slot"
+      "slot": "ampath-reports-dashboard-slot",
+      "privileges": ["O3 View Reports Dashboard"]
     }
   ],
   "pages": []

package/src/utils/format-indicator.ts

@@ -0,0 +1,39 @@
+const PREFIX_LABELS: Record<string, string> = {
+    total: 'total',
+    positive: 'positive',
+    min: 'lowest',
+    max: 'highest',
+};
+
+/** Reads like the form row it was drilled from: `positive_urine_ketones_with_members`
+    becomes "Urine Ketones (positive)" rather than the raw indicator key. */
+export function formatIndicatorName(indicator: string): string {
+    if (!indicator) {
+        return '';
+    }
+
+    const parts = indicator.includes("__")
+        ? indicator.split("__").slice(1)
+        : [indicator];
+
+    return parts
+        .map(part => {
+            // the retrieval-layer suffixes carry no meaning for the reader
+            part = part.replace(/_with_members$/, "");
+            const prefix = part.split("_")[0];
+            const qualifier = PREFIX_LABELS[prefix];
+            if (qualifier) {
+                part = part.slice(prefix.length + 1);
+            }
+            const name = part
+                .split("_")
+                .map(word =>
+                    word.length === 1
+                        ? word.toUpperCase()
+                        : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()
+                )
+                .join(" ");
+            return qualifier ? `${name} (${qualifier})` : name;
+        })
+        .join(" ");
+}

package/src/utils/get-base-url.ts

@@ -1,12 +1,44 @@
 import { getConfig } from '@openmrs/esm-framework';
-import { moduleName } from '../index';
+import { configSectionName } from '../index';
 
-export async function getEtlBaseUrl() {
-  const { etlBaseUrl } = await getConfig(moduleName);
-  return etlBaseUrl ?? null;
+/**
+ * The ETL host every report reads from, taken from this module's frontend
+ * configuration (`etlBaseUrl`).
+ *
+ * Throws when it is unset rather than returning an empty string: an empty base
+ * collapses every report URL onto the OpenMRS root, which surfaces as a bare
+ * 404 that reads like a missing endpoint instead of missing configuration.
+ */
+export async function getEtlBaseUrl(): Promise<string> {
+  const { etlBaseUrl } = await getConfig(configSectionName);
+  const baseUrl = typeof etlBaseUrl === 'string' ? etlBaseUrl.trim() : '';
+
+  if (!baseUrl) {
+    throw new Error(
+      `The ETL base URL is not configured. Set "etlBaseUrl" for ${configSectionName} in the frontend configuration.`,
+    );
+  }
+
+  // trailing slash trimmed so callers can join with a leading slash safely
+  return baseUrl.replace(/\/+$/, '');
 }
 
-export async function getSubDomain() {
-  const { subDomain } = await getConfig(moduleName);
-  return subDomain ?? null;
+export type EtlQueryParams = Record<string, string | number | undefined | null>;
+
+/**
+ * Builds a report URL from the configured ETL base, a path and its query
+ * parameters. Blank parameters are dropped rather than sent as empty values.
+ */
+export async function buildEtlUrl(path: string, params: EtlQueryParams = {}): Promise<string> {
+  const baseUrl = await getEtlBaseUrl();
+
+  const query = new URLSearchParams(
+    Object.entries(params)
+      .filter(([, value]) => value !== undefined && value !== null && value !== '')
+      .map(([key, value]) => [key, String(value)]),
+  ).toString();
+
+  const url = `${baseUrl}/${path.replace(/^\/+/, '')}`;
+
+  return query ? `${url}?${query}` : url;
 }

package/src/utils/utils.ts

@@ -1,7 +1,36 @@
+import { openmrsFetch } from '@openmrs/esm-framework';
+
 export const getCell = (key = "", label = "", colSpan = 1, rowSpan = 1, strong = false) => ({
     key,
     label,
     strong,
     colSpan,
     rowSpan
-});
+});
+
+export async function getJson<T>(url: string, payload: Record<string, unknown> | null = null): Promise<T> {
+  let requestUrl = url;
+
+  if (payload && Object.keys(payload).length > 0) {
+    const queryString = new URLSearchParams(
+      Object.entries(payload).filter(([, value]) => value !== undefined && value !== null) as Array<[string, string]>,
+    ).toString();
+
+    if (queryString) {
+      requestUrl = `${url}?${queryString}`;
+    }
+  }
+
+  const response = await openmrsFetch(requestUrl);
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Request failed with ${response.status}: ${errorText}`);
+  }
+
+  if (response.status === 204 || response.headers.get('content-length') === '0') {
+    return Promise.resolve({} as T);
+  }
+
+  return response.json() as Promise<T>;
+}

package/tsconfig.json

@@ -5,7 +5,7 @@
     "allowSyntheticDefaultImports": true,
     "jsx": "react",
     "skipLibCheck": true,
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "lib": [
       "dom",
       "es5",

package/webpack.config.js

@@ -1 +1,22 @@
-module.exports = require('openmrs/default-webpack-config');
+const path = require('path');
+const config = (module.exports = require('openmrs/default-webpack-config'));
+config.watchConfig.ignored = ['.git', 'test-results', `${path.resolve(__dirname, 'dist')}/**`];
+config.overrides.resolve = {
+  fallback: {
+    crypto: false,
+    stream: false,
+    os: false,
+    path: false,
+    zlib: false,
+    https: false,
+    http: false,
+    util: false,
+    url: false,
+  },
+  extensions: ['.tsx', '.ts', '.jsx', '.js', '.scss'],
+  alias: {
+    '@openmrs/esm-framework': '@openmrs/esm-framework/src/internal',
+  },
+};
+
+module.exports = config;