@openedx/frontend-app-gradebook 2.0.0-alpha.0

package/README.rst

@@ -0,0 +1,279 @@
+frontend-app-gradebook
+#######################
+
+|Codecov| |npm_version| |npm_downloads| |license| |semantic-release|
+
+Purpose
+*******
+
+Gradebook allows course staff to view, filter, and override subsection grades for a course. Additionally for Masters courses, Gradebook enables bulk management of subsection grades.
+
+Jump to:
+
+- `Should I use Gradebook in my course?`_
+- Quickstart_
+
+For existing documentation see:
+
+- Basic Usage: `Review Learner Grades (read-the-docs) <https://docs.openedx.org/en/latest/educators/how-tos/data/view_learner_grades.html>`_
+- Bulk Grade Management: `Override Learner Subsection Scores in Bulk (read-the-docs) <https://docs.openedx.org/en/latest/educators/how-tos/data/manage_learner_grades.html#override-learner-subsection-scores-in-bulk>`_
+
+Branches and releases
+*********************
+
+This repository follows `OEP-10 ADR 0002
+<https://docs.openedx.org/projects/openedx-proposals/en/latest/processes/oep-0010/decisions/0002-frontend-stable-branches.html>`_:
+
+- ``master`` is the unstable development branch; every conventional commit
+  publishes a prerelease of ``@openedx/frontend-app-gradebook`` to npm.
+- ``stable`` carries the current stable major, published on the ``latest``
+  dist-tag. Older stable lines live on ``n.x`` / ``n.m.x`` branches as needed.
+- The repository no longer participates in Open edX releases by branch: the
+  legacy micro-frontend and any further ``release/RELEASENAME`` branches for it
+  live on the `legacy-mfe
+  <https://github.com/openedx/frontend-app-gradebook/tree/legacy-mfe>`_ branch.
+
+Should I use Gradebook in my course?
+*************************************
+
+What does this offer over the legacy gradebook?
+================================================
+
+This frontend app offers a great deal more granularity when searching for problems, an easy interface for editing grades, an
+audit trail for seeing who edited what grade and what reason they gave (if any) for doing so.
+
+Problems can be filtered by student as in the traditional gradebook, but can also be filtered by scores to see who
+scored within a certain range, and by assignment types (note: Not problem types, but categories like 'Exams' or
+'Homework').
+
+What does the legacy gradebook offer that this project does not?
+=================================================================
+
+This project does not (yet, at least) create any graphs, which the traditional gradebook does. It also does not give
+quick links to the problems for the instructor to visit. It expects the instructor to be familiar with the problems they
+are grading and which unit they refer to.
+
+The gradebook is expected to be much more performant for larger numbers of students as well. The Instructor Dashboard
+link for the legacy gradebook reports that "this feature is available only to courses with a small number of enrolled
+learners." However, this project comes with no such warning.
+
+Who should not change to this gradebook?
+=========================================
+
+Groups whose instructors need not ever manually override grades do not need this project, but may not be any worse off
+depending on their needs. Instructors that expect to review grades infrequently enough that not having a direct link
+to the problem in question will have a worse UX than the legacy gradebook provides. Instructors that rely on the graphs
+generated by the current gradebook might find the lack of autogenerated graphs to be frustrating.
+
+Getting Started
+***************
+
+Installation
+============
+
+To install gradebook into your project:
+
+.. code-block:: bash
+
+  npm i --save @openedx/frontend-app-gradebook
+
+Quickstart
+==========
+
+Cloning and Setup
+-----------------
+
+1. Clone your new repo:
+
+   .. code-block:: bash
+
+     git clone https://github.com/openedx/frontend-app-gradebook.git
+
+2. Use the version of Node specified in ``.nvmrc``
+
+3. Stop Tutor, if it's running:
+
+   .. code-block:: bash
+
+     tutor dev stop
+
+4. Tell Tutor that we're going to be running this repo in development mode, so it should be excluded from the container that otherwise runs every frontend app. Run this:
+
+   .. code-block:: bash
+
+     tutor mounts add /path/to/frontend-app-gradebook
+
+5. Start Tutor in development mode. This command will start the LMS and Studio,
+   and other required frontend apps like ``authn`` and ``account``, but will not start
+   Gradebook, which we're going to run on the host instead of in a container
+   managed by Tutor. Run:
+
+   .. code-block:: bash
+
+     tutor dev start lms cms mfe
+
+Startup
+-------
+
+1. Install npm dependencies:
+
+   .. code-block:: bash
+
+     cd frontend-app-gradebook && npm install
+
+2. Start the dev server:
+
+   .. code-block:: bash
+
+     npm run dev
+
+Running the UI Standalone
+==========================
+
+To install the project please refer to the `Tutor MFE plugin <https://github.com/overhangio/tutor-mfe?tab=readme-ov-file#mfe-development>`_ instructions.
+
+When not mounted, gradebook runs in the shared frontend app container at http://apps.local.openedx.io/gradebook/course-v1:edX+DemoX+Demo_Course.
+
+When mounted in the tutor ``gradebook`` container, or when running a local (host) dev server, the app runs on port **1994**, so when you go to http://apps.local.openedx.io:1994/gradebook/course-v1:edX+DemoX+Demo_Course you should see the UI (assuming you have such a Demo Course in your Tutor instance). Note that you always have to provide a course id to actually see a gradebook.
+
+Starting the dev server hot-reloads JavaScript and Sass changes, so you should (:crossed_fingers:) not need to do anything (other than wait) when making changes.
+
+Developing against a local frontend-base
+=========================================
+
+This frontend app supports `npm workspaces <https://docs.npmjs.com/cli/using-npm/workspaces>`_ so you can develop against a local ``frontend-base`` checkout and see changes reflected automatically. See the ``dev:packages`` script in ``package.json`` and the workspace-related targets in the ``Makefile``.
+
+Plugins
+*******
+
+This frontend app is built on `frontend-base <https://github.com/openedx/frontend-base>`_ and can be customized through the shell's plugin slot mechanism (``<Slot />``). Any slots this app exposes for host sites to override live under ``src/slots``.
+
+Running tests
+*************
+
+Run:
+
+.. code-block:: bash
+
+  nvm use
+
+  npm ci
+
+  npm test
+
+Directory Structure
+*******************
+
+* ``public``
+
+  * Static assets served at the site root when running the dev harness.
+
+* ``src``
+
+  * ``Main.tsx``
+
+    * Root component the routed entry lazy-loads; sets the document title with ``<Helmet>`` and mounts the app's providers around the page tree.
+
+  * ``app.ts``
+
+    * The ``App`` object consumed by ``site.config.*.tsx`` — wires ``appId``, ``routes``, and ``providers`` for frontend-base to register.
+
+  * ``routes.tsx``
+
+    * React Router route definitions for the app.
+
+  * ``providers.tsx``
+
+    * App-scoped context providers registered with frontend-base.
+
+  * ``slots``
+
+    * Slots this app exposes for host sites to plug into.
+
+  * ``components``
+
+    * Presentational and container React components.
+
+  * ``containers``
+
+    * Route-level container components.
+
+  * ``data``
+
+    * API hooks, query keys, React Query client, and shared context (filters, gradebook UI).
+
+  * ``i18n``
+
+    * i18n entry point and generated messages (managed via ``openedx translations:pull``).
+
+* ``site.config.dev.tsx``
+
+  * Dev harness configuration — registers the shell, header, footer, and this app for local development.
+
+License
+*******
+
+The code in this repository is licensed under the AGPLv3 unless otherwise
+noted.
+
+Please see `LICENSE <LICENSE>`_ for details.
+
+Contributing
+************
+
+Contributions are very welcome.  Please read `How To Contribute`_ for details.
+
+.. _How To Contribute: https://openedx.org/r/how-to-contribute
+
+This project is currently accepting all types of contributions, bug fixes,
+security fixes, maintenance work, or new features.  However, please make sure
+to have a discussion about your new feature idea with the maintainers prior to
+beginning development to maximize the chances of your change being accepted.
+You can start a conversation by creating a new issue on this repo summarizing
+your idea.
+
+Getting Help
+************
+
+If you're having trouble, we have discussion forums at
+https://discuss.openedx.org where you can connect with others in the community.
+
+Our real-time conversations are on Slack. You can request a `Slack
+invitation`_, then join our `community Slack workspace`_.  Because this is a
+frontend repository, the best place to discuss it would be in the
+`#wg-frontend channel`_.
+
+For anything non-trivial, the best path is to open an issue in this repository
+with as many details about the issue you are facing as you can provide.
+
+https://github.com/openedx/frontend-app-gradebook/issues
+
+For more information about these options, see the `Getting Help`_ page.
+
+.. _Slack invitation: https://openedx.org/slack
+.. _community Slack workspace: https://openedx.slack.com/
+.. _#wg-frontend channel: https://openedx.slack.com/archives/C04BM6YC7A6
+.. _Getting Help: https://openedx.org/community/connect
+
+The Open edX Code of Conduct
+*****************************
+
+All community members are expected to follow the `Open edX Code of Conduct`_.
+
+.. _Open edX Code of Conduct: https://openedx.org/code-of-conduct/
+
+Reporting Security Issues
+**************************
+
+Please do not report security issues in public. Please email security@openedx.org.
+
+.. |Codecov| image:: https://img.shields.io/codecov/c/gh/openedx/frontend-app-gradebook
+   :target: https://app.codecov.io/gh/openedx/frontend-app-gradebook
+.. |npm_version| image:: https://img.shields.io/npm/v/@openedx/frontend-app-gradebook.svg
+   :target: @openedx/frontend-app-gradebook
+.. |npm_downloads| image:: https://img.shields.io/npm/dt/@openedx/frontend-app-gradebook.svg
+   :target: @openedx/frontend-app-gradebook
+.. |license| image:: https://img.shields.io/npm/l/@openedx/frontend-app-gradebook.svg
+   :target: @openedx/frontend-app-gradebook
+.. |semantic-release| image:: https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg
+   :target: https://github.com/semantic-release/semantic-release

package/dist/Main.d.ts

@@ -0,0 +1,3 @@
+import './style.scss';
+declare const Main: () => import("react").JSX.Element;
+export default Main;

package/dist/Main.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CurrentAppProvider, PageWrap, getSiteConfig, useIntl } from '@openedx/frontend-base';
+import { Helmet } from 'react-helmet';
+import { appId } from './constants';
+import { FiltersProvider } from './data/filtersContext';
+import { GradebookUiProvider } from './data/gradebookUiContext';
+import GradebookPage from './containers/GradebookPage';
+import messages from './messages';
+import './style.scss';
+const Main = () => {
+    const { formatMessage } = useIntl();
+    return (_jsxs(CurrentAppProvider, { appId: appId, children: [_jsx(Helmet, { children: _jsx("title", { children: formatMessage(messages['gradebook.page.title'], {
+                        siteName: getSiteConfig().siteName,
+                    }) }) }), _jsx(FiltersProvider, { children: _jsx(GradebookUiProvider, { children: _jsx(PageWrap, { children: _jsx(GradebookPage, {}) }) }) })] }));
+};
+export default Main;
+//# sourceMappingURL=Main.js.map

package/dist/Main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Main.js","sourceRoot":"","sources":["../src/Main.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,aAAa,MAAM,+BAA+B,CAAC;AAC1D,OAAO,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,cAAc,CAAC;AAEtB,MAAM,IAAI,GAAG,GAAG,EAAE;IAChB,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAAC;IACpC,OAAO,CACL,MAAC,kBAAkB,IAAC,KAAK,EAAE,KAAK,aAC9B,KAAC,MAAM,cACL,0BACG,aAAa,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE;wBAC/C,QAAQ,EAAE,aAAa,EAAE,CAAC,QAAQ;qBACnC,CAAC,GACI,GACD,EACT,KAAC,eAAe,cACd,KAAC,mBAAmB,cAClB,KAAC,QAAQ,cACP,KAAC,aAAa,KAAG,GACR,GACS,GACN,IACC,CACtB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,IAAI,CAAC","sourcesContent":["import { CurrentAppProvider, PageWrap, getSiteConfig, useIntl } from '@openedx/frontend-base';\nimport { Helmet } from 'react-helmet';\nimport { appId } from './constants';\nimport { FiltersProvider } from '@src/data/filtersContext';\nimport { GradebookUiProvider } from '@src/data/gradebookUiContext';\nimport GradebookPage from '@src/containers/GradebookPage';\nimport messages from './messages';\nimport './style.scss';\n\nconst Main = () => {\n  const { formatMessage } = useIntl();\n  return (\n    <CurrentAppProvider appId={appId}>\n      <Helmet>\n        <title>\n          {formatMessage(messages['gradebook.page.title'], {\n            siteName: getSiteConfig().siteName,\n          })}\n        </title>\n      </Helmet>\n      <FiltersProvider>\n        <GradebookUiProvider>\n          <PageWrap>\n            <GradebookPage />\n          </PageWrap>\n        </GradebookUiProvider>\n      </FiltersProvider>\n    </CurrentAppProvider>\n  );\n};\n\nexport default Main;\n"]}

package/dist/app.d.ts

@@ -0,0 +1,3 @@
+import { App } from '@openedx/frontend-base';
+declare const app: App;
+export default app;

package/dist/app.js

@@ -0,0 +1,10 @@
+import { appId } from './constants';
+import routes from './routes';
+import providers from './providers';
+const app = {
+    appId,
+    routes,
+    providers,
+};
+export default app;
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,MAAM,GAAG,GAAQ;IACf,KAAK;IACL,MAAM;IACN,SAAS;CACV,CAAC;AAEF,eAAe,GAAG,CAAC","sourcesContent":["import { App } from '@openedx/frontend-base';\nimport { appId } from './constants';\nimport routes from './routes';\nimport providers from './providers';\n\nconst app: App = {\n  appId,\n  routes,\n  providers,\n};\n\nexport default app;\n"]}

package/dist/components/BulkManagementHistoryView/BulkManagementAlerts.d.ts

@@ -0,0 +1,5 @@
+export function BulkManagementAlerts(): import("react").JSX.Element;
+export namespace BulkManagementAlerts {
+    let propTypes: {};
+}
+export default BulkManagementAlerts;

package/dist/components/BulkManagementHistoryView/BulkManagementAlerts.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { FormattedMessage } from '@openedx/frontend-base';
+import { Alert } from '@openedx/paragon';
+import { useGradebookUi } from '../../data/gradebookUiContext';
+import messages from './messages';
+/**
+ * <BulkManagementAlerts />
+ * Alerts to display at the top of the BulkManagement tab.
+ */
+export const BulkManagementAlerts = () => {
+    const { csvUploadSuccess, csvUploadErrorMessages } = useGradebookUi();
+    // Mirrors the old `selectors.grades.bulkImportError` string formatting.
+    const bulkImportError = csvUploadErrorMessages.length
+        ? `Errors while processing: ${csvUploadErrorMessages.join('; ')};`
+        : '';
+    return (_jsxs(_Fragment, { children: [_jsx(Alert, { variant: "danger", show: !!bulkImportError, dismissible: false, children: bulkImportError }), _jsx(Alert, { variant: "success", show: csvUploadSuccess, dismissible: false, children: _jsx(FormattedMessage, Object.assign({}, messages.successDialog)) })] }));
+};
+BulkManagementAlerts.propTypes = {};
+export default BulkManagementAlerts;
+//# sourceMappingURL=BulkManagementAlerts.js.map

package/dist/components/BulkManagementHistoryView/BulkManagementAlerts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkManagementAlerts.js","sourceRoot":"","sources":["../../../src/components/BulkManagementHistoryView/BulkManagementAlerts.jsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,QAAQ,MAAM,YAAY,CAAC;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,EAAE;IACvC,MAAM,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,GAAG,cAAc,EAAE,CAAC;IACtE,wEAAwE;IACxE,MAAM,eAAe,GAAG,sBAAsB,CAAC,MAAM;QACnD,CAAC,CAAC,4BAA4B,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAClE,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,CACL,8BACE,KAAC,KAAK,IACJ,OAAO,EAAC,QAAQ,EAChB,IAAI,EAAE,CAAC,CAAC,eAAe,EACvB,WAAW,EAAE,KAAK,YAEjB,eAAe,GACV,EACR,KAAC,KAAK,IACJ,OAAO,EAAC,SAAS,EACjB,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,KAAK,YAElB,KAAC,gBAAgB,oBAAK,QAAQ,CAAC,aAAa,EAAI,GAC1C,IACP,CACJ,CAAC;AACJ,CAAC,CAAC;AAEF,oBAAoB,CAAC,SAAS,GAAG,EAAE,CAAC;AAEpC,eAAe,oBAAoB,CAAC","sourcesContent":["import { FormattedMessage } from '@openedx/frontend-base';\n\nimport { Alert } from '@openedx/paragon';\n\nimport { useGradebookUi } from '@src/data/gradebookUiContext';\nimport messages from './messages';\n\n/**\n * <BulkManagementAlerts />\n * Alerts to display at the top of the BulkManagement tab.\n */\nexport const BulkManagementAlerts = () => {\n  const { csvUploadSuccess, csvUploadErrorMessages } = useGradebookUi();\n  // Mirrors the old `selectors.grades.bulkImportError` string formatting.\n  const bulkImportError = csvUploadErrorMessages.length\n    ? `Errors while processing: ${csvUploadErrorMessages.join('; ')};`\n    : '';\n\n  return (\n    <>\n      <Alert\n        variant=\"danger\"\n        show={!!bulkImportError}\n        dismissible={false}\n      >\n        {bulkImportError}\n      </Alert>\n      <Alert\n        variant=\"success\"\n        show={csvUploadSuccess}\n        dismissible={false}\n      >\n        <FormattedMessage {...messages.successDialog} />\n      </Alert>\n    </>\n  );\n};\n\nBulkManagementAlerts.propTypes = {};\n\nexport default BulkManagementAlerts;\n"]}

package/dist/components/BulkManagementHistoryView/BulkManagementHistoryView.scss

@@ -0,0 +1,6 @@
+.bulk-management-history-view {
+  .help-text {
+    margin-bottom: 40px;
+    max-width: 70%;
+  }
+}

package/dist/components/BulkManagementHistoryView/HistoryTable.d.ts

@@ -0,0 +1,33 @@
+export function mapHistoryRows({ resultsSummary, originalFilename, user, ...rest }: {
+    [x: string]: any;
+    resultsSummary: any;
+    originalFilename: any;
+    user: any;
+}): {
+    resultsSummary: import("react").JSX.Element;
+    filename: import("react").JSX.Element;
+    user: import("react").JSX.Element;
+};
+export function HistoryTable({ bulkManagementHistory, }: {
+    bulkManagementHistory: any;
+}): import("react").JSX.Element;
+export namespace HistoryTable {
+    namespace defaultProps {
+        let bulkManagementHistory: never[];
+    }
+    namespace propTypes {
+        let bulkManagementHistory_1: PropTypes.Requireable<(PropTypes.InferProps<{
+            originalFilename: PropTypes.Validator<string>;
+            user: PropTypes.Validator<string>;
+            timeUploaded: PropTypes.Validator<string>;
+            resultsSummary: PropTypes.Requireable<PropTypes.InferProps<{
+                rowId: PropTypes.Validator<number>;
+                text: PropTypes.Validator<string>;
+            }>>;
+        }> | null | undefined)[]>;
+        export { bulkManagementHistory_1 as bulkManagementHistory };
+    }
+}
+export function HistoryTableContainer(): import("react").JSX.Element;
+export default HistoryTableContainer;
+import PropTypes from 'prop-types';

package/dist/components/BulkManagementHistoryView/HistoryTable.js

@@ -0,0 +1,53 @@
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { jsx as _jsx } from "react/jsx-runtime";
+import PropTypes from 'prop-types';
+import { DataTable } from '@openedx/paragon';
+import { bulkManagementColumns } from '../../data/constants/app';
+import { useBulkManagementHistoryEntries } from './data/apiHook';
+import ResultsSummary from './ResultsSummary';
+export const mapHistoryRows = (_a) => {
+    var { resultsSummary, originalFilename, user } = _a, rest = __rest(_a, ["resultsSummary", "originalFilename", "user"]);
+    return (Object.assign({ resultsSummary: (_jsx(ResultsSummary, Object.assign({}, resultsSummary))), filename: (_jsx("span", { className: "wrap-text-in-cell", children: originalFilename })), user: (_jsx("span", { className: "wrap-text-in-cell", children: user })) }, rest));
+};
+/**
+ * <HistoryTable />
+ * Table with history of bulk management uploads, including a results summary which
+ * displays total, skipped, and failed uploads
+ */
+export const HistoryTable = ({ bulkManagementHistory, }) => (_jsx(DataTable, { data: bulkManagementHistory.map(mapHistoryRows), hasFixedColumnWidths: true, columns: bulkManagementColumns, className: "table-striped", itemCount: bulkManagementHistory.length }));
+HistoryTable.defaultProps = {
+    bulkManagementHistory: [],
+};
+HistoryTable.propTypes = {
+    // redux
+    bulkManagementHistory: PropTypes.arrayOf(PropTypes.shape({
+        originalFilename: PropTypes.string.isRequired,
+        user: PropTypes.string.isRequired,
+        timeUploaded: PropTypes.string.isRequired,
+        resultsSummary: PropTypes.shape({
+            rowId: PropTypes.number.isRequired,
+            text: PropTypes.string.isRequired,
+        }),
+    })),
+};
+/**
+ * <HistoryTableContainer />
+ * Supplies the bulk-management history (now from React Query) to the
+ * presentational <HistoryTable />.
+ */
+export const HistoryTableContainer = () => {
+    const bulkManagementHistory = useBulkManagementHistoryEntries();
+    return _jsx(HistoryTable, { bulkManagementHistory: bulkManagementHistory });
+};
+export default HistoryTableContainer;
+//# sourceMappingURL=HistoryTable.js.map

package/dist/components/BulkManagementHistoryView/HistoryTable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HistoryTable.js","sourceRoot":"","sources":["../../../src/components/BulkManagementHistoryView/HistoryTable.jsx"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AAEjE,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAK9B,EAAE,EAAE;QAL0B,EAC7B,cAAc,EACd,gBAAgB,EAChB,IAAI,OAEL,EADI,IAAI,cAJsB,8CAK9B,CADQ;IACH,OAAA,iBACJ,cAAc,EAAE,CAAC,KAAC,cAAc,oBAAK,cAAc,EAAI,CAAC,EACxD,QAAQ,EAAE,CAAC,eAAM,SAAS,EAAC,mBAAmB,YAAE,gBAAgB,GAAQ,CAAC,EACzE,IAAI,EAAE,CAAC,eAAM,SAAS,EAAC,mBAAmB,YAAE,IAAI,GAAQ,CAAC,IACtD,IAAI,EACP,CAAA;CAAA,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAC3B,qBAAqB,GACtB,EAAE,EAAE,CAAC,CACJ,KAAC,SAAS,IACR,IAAI,EAAE,qBAAqB,CAAC,GAAG,CAAC,cAAc,CAAC,EAC/C,oBAAoB,QACpB,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAC,eAAe,EACzB,SAAS,EAAE,qBAAqB,CAAC,MAAM,GACvC,CACH,CAAC;AACF,YAAY,CAAC,YAAY,GAAG;IAC1B,qBAAqB,EAAE,EAAE;CAC1B,CAAC;AACF,YAAY,CAAC,SAAS,GAAG;IACvB,QAAQ;IACR,qBAAqB,EAAE,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;QACvD,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU;QAC7C,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU;QACjC,YAAY,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU;QACzC,cAAc,EAAE,SAAS,CAAC,KAAK,CAAC;YAC9B,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU;YAClC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU;SAClC,CAAC;KACH,CAAC,CAAC;CACJ,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,EAAE;IACxC,MAAM,qBAAqB,GAAG,+BAA+B,EAAE,CAAC;IAChE,OAAO,KAAC,YAAY,IAAC,qBAAqB,EAAE,qBAAqB,GAAI,CAAC;AACxE,CAAC,CAAC;AAEF,eAAe,qBAAqB,CAAC","sourcesContent":["import PropTypes from 'prop-types';\n\nimport { DataTable } from '@openedx/paragon';\n\nimport { bulkManagementColumns } from '@src/data/constants/app';\nimport { useBulkManagementHistoryEntries } from './data/apiHook';\n\nimport ResultsSummary from './ResultsSummary';\n\nexport const mapHistoryRows = ({\n  resultsSummary,\n  originalFilename,\n  user,\n  ...rest\n}) => ({\n  resultsSummary: (<ResultsSummary {...resultsSummary} />),\n  filename: (<span className=\"wrap-text-in-cell\">{originalFilename}</span>),\n  user: (<span className=\"wrap-text-in-cell\">{user}</span>),\n  ...rest,\n});\n\n/**\n * <HistoryTable />\n * Table with history of bulk management uploads, including a results summary which\n * displays total, skipped, and failed uploads\n */\nexport const HistoryTable = ({\n  bulkManagementHistory,\n}) => (\n  <DataTable\n    data={bulkManagementHistory.map(mapHistoryRows)}\n    hasFixedColumnWidths\n    columns={bulkManagementColumns}\n    className=\"table-striped\"\n    itemCount={bulkManagementHistory.length}\n  />\n);\nHistoryTable.defaultProps = {\n  bulkManagementHistory: [],\n};\nHistoryTable.propTypes = {\n  // redux\n  bulkManagementHistory: PropTypes.arrayOf(PropTypes.shape({\n    originalFilename: PropTypes.string.isRequired,\n    user: PropTypes.string.isRequired,\n    timeUploaded: PropTypes.string.isRequired,\n    resultsSummary: PropTypes.shape({\n      rowId: PropTypes.number.isRequired,\n      text: PropTypes.string.isRequired,\n    }),\n  })),\n};\n\n/**\n * <HistoryTableContainer />\n * Supplies the bulk-management history (now from React Query) to the\n * presentational <HistoryTable />.\n */\nexport const HistoryTableContainer = () => {\n  const bulkManagementHistory = useBulkManagementHistoryEntries();\n  return <HistoryTable bulkManagementHistory={bulkManagementHistory} />;\n};\n\nexport default HistoryTableContainer;\n"]}

package/dist/components/BulkManagementHistoryView/ResultsSummary.d.ts

@@ -0,0 +1,16 @@
+export default ResultsSummary;
+/**
+ * <ResultsSummary {...{ courseId, rowId, text }} />
+ * displays a result summary cell for a single bulk management upgrade history entry.
+ * @param {string} courseId - course identifier
+ * @param {number} rowId - row/error identifier
+ * @param {string} text - summary string
+ */
+declare function ResultsSummary({ rowId, text, }: string): import("react").JSX.Element;
+declare namespace ResultsSummary {
+    namespace propTypes {
+        let rowId: PropTypes.Validator<number>;
+        let text: PropTypes.Validator<string>;
+    }
+}
+import PropTypes from 'prop-types';

package/dist/components/BulkManagementHistoryView/ResultsSummary.js

@@ -0,0 +1,19 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import PropTypes from 'prop-types';
+import { Hyperlink, Icon } from '@openedx/paragon';
+import { Download } from '@openedx/paragon/icons';
+import lms from '../../data/services/lms';
+/**
+ * <ResultsSummary {...{ courseId, rowId, text }} />
+ * displays a result summary cell for a single bulk management upgrade history entry.
+ * @param {string} courseId - course identifier
+ * @param {number} rowId - row/error identifier
+ * @param {string} text - summary string
+ */
+const ResultsSummary = ({ rowId, text, }) => (_jsxs(Hyperlink, { destination: lms.urls.bulkGradesUrlByRow(rowId), target: "_blank", showLaunchIcon: false, children: [_jsx(Icon, { src: Download, className: "d-inline-block" }), text] }));
+ResultsSummary.propTypes = {
+    rowId: PropTypes.number.isRequired,
+    text: PropTypes.string.isRequired,
+};
+export default ResultsSummary;
+//# sourceMappingURL=ResultsSummary.js.map

package/dist/components/BulkManagementHistoryView/ResultsSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultsSummary.js","sourceRoot":"","sources":["../../../src/components/BulkManagementHistoryView/ResultsSummary.jsx"],"names":[],"mappings":";AAAA,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,GAAG,MAAM,wBAAwB,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,cAAc,GAAG,CAAC,EACtB,KAAK,EACL,IAAI,GACL,EAAE,EAAE,CAAC,CACJ,MAAC,SAAS,IACR,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAC/C,MAAM,EAAC,QAAQ,EACf,cAAc,EAAE,KAAK,aAErB,KAAC,IAAI,IAAC,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAC,gBAAgB,GAAG,EACjD,IAAI,IACK,CACb,CAAC;AAEF,cAAc,CAAC,SAAS,GAAG;IACzB,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU;IAClC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,UAAU;CAClC,CAAC;AAEF,eAAe,cAAc,CAAC","sourcesContent":["import PropTypes from 'prop-types';\n\nimport { Hyperlink, Icon } from '@openedx/paragon';\nimport { Download } from '@openedx/paragon/icons';\n\nimport lms from '@src/data/services/lms';\n\n/**\n * <ResultsSummary {...{ courseId, rowId, text }} />\n * displays a result summary cell for a single bulk management upgrade history entry.\n * @param {string} courseId - course identifier\n * @param {number} rowId - row/error identifier\n * @param {string} text - summary string\n */\nconst ResultsSummary = ({\n  rowId,\n  text,\n}) => (\n  <Hyperlink\n    destination={lms.urls.bulkGradesUrlByRow(rowId)}\n    target=\"_blank\"\n    showLaunchIcon={false}\n  >\n    <Icon src={Download} className=\"d-inline-block\" />\n    {text}\n  </Hyperlink>\n);\n\nResultsSummary.propTypes = {\n  rowId: PropTypes.number.isRequired,\n  text: PropTypes.string.isRequired,\n};\n\nexport default ResultsSummary;\n"]}

package/dist/components/BulkManagementHistoryView/data/api.d.ts

@@ -0,0 +1,5 @@
+/**
+ * getBulkOperationHistory()
+ * Fetches the bulk grade-override upload history for the course.
+ */
+export declare const getBulkOperationHistory: () => Promise<any>;

package/dist/components/BulkManagementHistoryView/data/api.js

@@ -0,0 +1,16 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import lms from '../../../data/services/lms';
+/**
+ * getBulkOperationHistory()
+ * Fetches the bulk grade-override upload history for the course.
+ */
+export const getBulkOperationHistory = () => __awaiter(void 0, void 0, void 0, function* () { return lms.api.fetch.gradeBulkOperationHistory(); });
+//# sourceMappingURL=api.js.map

package/dist/components/BulkManagementHistoryView/data/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../src/components/BulkManagementHistoryView/data/api.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,GAAG,MAAM,wBAAwB,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAS,EAAE,kDAAC,OAAA,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAA,GAAA,CAAC","sourcesContent":["import lms from '@src/data/services/lms';\n\n/**\n * getBulkOperationHistory()\n * Fetches the bulk grade-override upload history for the course.\n */\nexport const getBulkOperationHistory = async () => lms.api.fetch.gradeBulkOperationHistory();\n"]}

package/dist/components/BulkManagementHistoryView/data/apiHook.d.ts

@@ -0,0 +1,16 @@
+/**
+ * useBulkOperationHistory()
+ * Bulk grade-override upload history. Single-responsibility query hook: the
+ * caller decides when it may run via `courseId` and `enabled`.
+ */
+export declare const useBulkOperationHistory: (courseId: string, { enabled }?: {
+    enabled?: boolean;
+}) => import("@tanstack/react-query").UseQueryResult<any, Error>;
+/**
+ * useBulkManagementHistoryEntries()
+ * Read-model for the history table: wires the roles + assignment-types gates
+ * into `useBulkOperationHistory` and shapes the results with
+ * `transformHistoryEntry`. Replaces the former facade selector
+ * `selectors.grades.useBulkManagementHistoryEntries`.
+ */
+export declare const useBulkManagementHistoryEntries: () => any;

package/dist/components/BulkManagementHistoryView/data/apiHook.js

@@ -0,0 +1,34 @@
+import { useQuery } from '@tanstack/react-query';
+import { useAssignmentTypes, useCourseIdWithGate } from '../../../data/apiHook';
+import { getBulkOperationHistory } from './api';
+import { bulkOperationHistoryQueryKeys } from './queryKeys';
+import { transformHistoryEntry } from './utils';
+// Stable empty reference so the shaped read-model hook doesn't return a fresh
+// array on every render while the query is still loading.
+const EMPTY_ARRAY = [];
+/**
+ * useBulkOperationHistory()
+ * Bulk grade-override upload history. Single-responsibility query hook: the
+ * caller decides when it may run via `courseId` and `enabled`.
+ */
+export const useBulkOperationHistory = (courseId, { enabled = true } = {}) => useQuery({
+    queryKey: bulkOperationHistoryQueryKeys.byCourse(courseId),
+    queryFn: getBulkOperationHistory,
+    enabled: !!courseId && enabled,
+});
+/**
+ * useBulkManagementHistoryEntries()
+ * Read-model for the history table: wires the roles + assignment-types gates
+ * into `useBulkOperationHistory` and shapes the results with
+ * `transformHistoryEntry`. Replaces the former facade selector
+ * `selectors.grades.useBulkManagementHistoryEntries`.
+ */
+export const useBulkManagementHistoryEntries = () => {
+    const { courseId, enabled } = useCourseIdWithGate();
+    const { data: assignmentTypesData } = useAssignmentTypes(courseId, { enabled });
+    const { data } = useBulkOperationHistory(courseId, {
+        enabled: enabled && !!(assignmentTypesData === null || assignmentTypesData === void 0 ? void 0 : assignmentTypesData.bulkManagementAvailable),
+    });
+    return (data !== null && data !== void 0 ? data : EMPTY_ARRAY).map(transformHistoryEntry);
+};
+//# sourceMappingURL=apiHook.js.map

package/dist/components/BulkManagementHistoryView/data/apiHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiHook.js","sourceRoot":"","sources":["../../../../src/components/BulkManagementHistoryView/data/apiHook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD,8EAA8E;AAC9E,0DAA0D;AAC1D,MAAM,WAAW,GAAY,EAAE,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CACrC,QAAgB,EAChB,EAAE,OAAO,GAAG,IAAI,KAA4B,EAAE,EAC9C,EAAE,CAAC,QAAQ,CAAC;IACZ,QAAQ,EAAE,6BAA6B,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1D,OAAO,EAAE,uBAAuB;IAChC,OAAO,EAAE,CAAC,CAAC,QAAQ,IAAI,OAAO;CAC/B,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,EAAE;IAClD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACpD,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,kBAAkB,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAChF,MAAM,EAAE,IAAI,EAAE,GAAG,uBAAuB,CAAC,QAAQ,EAAE;QACjD,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,CAAA,mBAAmB,aAAnB,mBAAmB,uBAAnB,mBAAmB,CAAE,uBAAuB,CAAA;KACnE,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,aAAJ,IAAI,cAAJ,IAAI,GAAI,WAAW,CAAC,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAC1D,CAAC,CAAC","sourcesContent":["import { useQuery } from '@tanstack/react-query';\n\nimport { useAssignmentTypes, useCourseIdWithGate } from '@src/data/apiHook';\n\nimport { getBulkOperationHistory } from './api';\nimport { bulkOperationHistoryQueryKeys } from './queryKeys';\nimport { transformHistoryEntry } from './utils';\n\n// Stable empty reference so the shaped read-model hook doesn't return a fresh\n// array on every render while the query is still loading.\nconst EMPTY_ARRAY: never[] = [];\n\n/**\n * useBulkOperationHistory()\n * Bulk grade-override upload history. Single-responsibility query hook: the\n * caller decides when it may run via `courseId` and `enabled`.\n */\nexport const useBulkOperationHistory = (\n  courseId: string,\n  { enabled = true }: { enabled?: boolean } = {},\n) => useQuery({\n  queryKey: bulkOperationHistoryQueryKeys.byCourse(courseId),\n  queryFn: getBulkOperationHistory,\n  enabled: !!courseId && enabled,\n});\n\n/**\n * useBulkManagementHistoryEntries()\n * Read-model for the history table: wires the roles + assignment-types gates\n * into `useBulkOperationHistory` and shapes the results with\n * `transformHistoryEntry`. Replaces the former facade selector\n * `selectors.grades.useBulkManagementHistoryEntries`.\n */\nexport const useBulkManagementHistoryEntries = () => {\n  const { courseId, enabled } = useCourseIdWithGate();\n  const { data: assignmentTypesData } = useAssignmentTypes(courseId, { enabled });\n  const { data } = useBulkOperationHistory(courseId, {\n    enabled: enabled && !!assignmentTypesData?.bulkManagementAvailable,\n  });\n  return (data ?? EMPTY_ARRAY).map(transformHistoryEntry);\n};\n"]}

package/dist/components/BulkManagementHistoryView/data/queryKeys.d.ts

@@ -0,0 +1,5 @@
+/** Bulk grade-override upload history for the course. */
+export declare const bulkOperationHistoryQueryKeys: {
+    all: readonly ["gradebook"];
+    byCourse: (courseId: string) => readonly ["gradebook", string, "bulkOperationHistory"];
+};

package/dist/components/BulkManagementHistoryView/data/queryKeys.js

@@ -0,0 +1,7 @@
+import { BASE_KEY } from '../../../data/queryKeys';
+/** Bulk grade-override upload history for the course. */
+export const bulkOperationHistoryQueryKeys = {
+    all: BASE_KEY,
+    byCourse: (courseId) => [...BASE_KEY, courseId, 'bulkOperationHistory'],
+};
+//# sourceMappingURL=queryKeys.js.map

package/dist/components/BulkManagementHistoryView/data/queryKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryKeys.js","sourceRoot":"","sources":["../../../../src/components/BulkManagementHistoryView/data/queryKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,yDAAyD;AACzD,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,GAAG,EAAE,QAAQ;IACb,QAAQ,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,QAAQ,EAAE,sBAAsB,CAAU;CACzF,CAAC","sourcesContent":["import { BASE_KEY } from '@src/data/queryKeys';\n\n/** Bulk grade-override upload history for the course. */\nexport const bulkOperationHistoryQueryKeys = {\n  all: BASE_KEY,\n  byCourse: (courseId: string) => [...BASE_KEY, courseId, 'bulkOperationHistory'] as const,\n};\n"]}