@dhis2/analytics 28.1.3 → 29.0.1

package/build/cjs/components/Interpretations/InterpretationsProvider/__tests__/hooks.spec.js

@@ -0,0 +1,565 @@
+"use strict";
+
+var _react = require("@testing-library/react");
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _react2 = _interopRequireDefault(require("react"));
+var mockData = _interopRequireWildcard(require("../../../../__fixtures__/interpretationsMockData.js"));
+var _hooks = require("../hooks.js");
+var _InterpretationsProvider = require("../InterpretationsProvider.js");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const mockQuery = jest.fn();
+const mockMutate = jest.fn();
+
+// Mock the useDataEngine hook to return our mock
+jest.mock('@dhis2/app-runtime', () => ({
+  useDataEngine: () => ({
+    ...jest.requireActual('@dhis2/app-runtime'),
+    query: mockQuery,
+    mutate: mockMutate
+  })
+}));
+const createMockImplementation = (data, shouldError = false) => () => new Promise((resolve, reject) => {
+  if (shouldError) {
+    const msg = typeof data === 'string' ? data : 'OOPSIE';
+    reject(new Error(msg));
+  } else {
+    resolve(data);
+  }
+});
+
+// Test wrapper component that properly pre-populates manager
+const createWrapper = (initialInterpretations = []) => {
+  const InterpretationsPopulator = ({
+    children
+  }) => {
+    const manager = (0, _hooks.useInterpretationsManager)();
+    if (initialInterpretations.length > 0 && manager.interpretations.size === 0) {
+      manager.currentType = mockData.visualization.type;
+      manager.currentVisualizationId = mockData.visualization.id;
+      manager.resetInterpretations(initialInterpretations);
+      manager.activeInterpretationId = initialInterpretations[0].id;
+    }
+    return children;
+  };
+  const TestWrapper = ({
+    children
+  }) => {
+    return /*#__PURE__*/_react2.default.createElement(_InterpretationsProvider.InterpretationsProvider, {
+      currentUser: mockData.currentUser
+    }, /*#__PURE__*/_react2.default.createElement(InterpretationsPopulator, null, children));
+  };
+  const propTypes = {
+    children: _propTypes.default.node
+  };
+  TestWrapper.propTypes = propTypes;
+  InterpretationsPopulator.propTypes = propTypes;
+  return TestWrapper;
+};
+
+// Custom hook to test interpretation-focused hooks (with pre-populated manager)
+const useAllHooks = (visualizationType, visualizationId, interpretationId) => {
+  // Not used directly but useful here to test things like unsubscriptions etc
+  const manager = (0, _hooks.useInterpretationsManager)();
+  // Core data hooks - no manual population needed since manager is pre-populated
+  const currentUser = (0, _hooks.useInterpretationsCurrentUser)();
+  const interpretationsList = (0, _hooks.useInterpretationsList)(visualizationType, visualizationId);
+  const activeInterpretation = (0, _hooks.useActiveInterpretation)(interpretationId);
+  const interpretation = (0, _hooks.useInterpretation)(interpretationId);
+
+  // Like hook (includes mutation)
+  const like = (0, _hooks.useLike)(interpretationId);
+
+  // Access hooks
+  const interpretationAccess = (0, _hooks.useInterpretationAccess)(interpretation);
+  const commentAccess = (0, _hooks.useCommentAccess)(mockData.interpretationDetails.comments[0], true); // Mock comment access
+
+  // Mutation hooks
+  const [createInterpretation, createState] = (0, _hooks.useCreateInterpretation)({
+    type: visualizationType,
+    id: visualizationId,
+    text: 'New interpretation'
+  });
+
+  /* Note that we are NOT deleting the active interpretation but another one!
+   * Some of the hooks used in the modal in in this test hook require the
+   * presence of an active interpretation and will crash without it. This is
+   * not a problem when the components are actually used int an app, because
+   * the modal closes when the active interpretation is removed.  */
+  const [deleteInterpretation, deleteState] = (0, _hooks.useDeleteInterpretation)({
+    id: mockData.interpretations[1].id
+  });
+  const [updateInterpretationText, updateState] = (0, _hooks.useUpdateInterpretationText)({
+    id: interpretationId,
+    text: 'Updated text'
+  });
+  const [addComment, addCommentState] = (0, _hooks.useAddCommentToActiveInterpretation)({
+    text: 'New comment'
+  });
+  const [deleteComment, deleteCommentState] = (0, _hooks.useDeleteCommentFromActiveInterpretation)({
+    id: 'commentid1'
+  });
+  const [updateComment, updateCommentState] = (0, _hooks.useUpdateCommentForActiveInterpretation)({
+    id: 'commentid1',
+    text: 'Updated comment'
+  });
+  return {
+    manager,
+    // Data hooks
+    currentUser,
+    interpretationsList,
+    activeInterpretation,
+    interpretation,
+    // Access hooks
+    interpretationAccess,
+    commentAccess,
+    // Like is also a mutation but does not implement the useInterpretationsManagerMutation internally
+    like,
+    // Mutation hooks
+    mutations: {
+      createInterpretation,
+      createState,
+      deleteInterpretation,
+      deleteState,
+      updateInterpretationText,
+      updateState,
+      addComment,
+      addCommentState,
+      deleteComment,
+      deleteCommentState,
+      updateComment,
+      updateCommentState
+    }
+  };
+};
+
+/* Extracted to as function because it is reused by all other tests
+ * apart from the list test */
+const shouldLoadActiveInterpretation = async () => {
+  mockQuery.mockImplementationOnce(createMockImplementation({
+    interpretations: {
+      interpretations: mockData.interpretations
+    }
+  }));
+  mockQuery.mockImplementationOnce(createMockImplementation({
+    interpretation: mockData.interpretationDetails
+  }));
+  const renderHookResult = (0, _react.renderHook)(() => useAllHooks(mockData.visualization.type, mockData.visualization.id, mockData.interpretationDetails.id), {
+    wrapper: createWrapper(mockData.interpretations)
+  });
+  const {
+    result
+  } = renderHookResult;
+  expect(result.current.activeInterpretation.loading).toBe(true);
+  expect(result.current.activeInterpretation.data).toBeUndefined();
+  expect(result.current.activeInterpretation.error).toBeUndefined();
+  await (0, _react.waitFor)(() => {
+    expect(result.current.activeInterpretation.loading).toBe(false);
+    expect(result.current.activeInterpretation.error).toBeUndefined();
+    expect(result.current.activeInterpretation.data).toEqual(mockData.interpretationDetails);
+  });
+  return renderHookResult;
+};
+describe('Interpretations hooks integration tests', () => {
+  beforeEach(() => {
+    mockQuery.mockClear();
+    mockMutate.mockClear();
+  });
+  describe('Listing interpretations', () => {
+    test('should show loading state then load interpretations list successfully', async () => {
+      mockQuery.mockImplementationOnce(createMockImplementation({
+        interpretations: {
+          interpretations: mockData.interpretations
+        }
+      }));
+      const {
+        result
+      } = (0, _react.renderHook)(() => (0, _hooks.useInterpretationsList)(mockData.visualization.type, mockData.visualization.id), {
+        wrapper: createWrapper()
+      });
+      expect(result.current.loading).toBe(true);
+      expect(result.current.data).toBeUndefined();
+      expect(result.current.error).toBeUndefined();
+      await (0, _react.waitFor)(() => {
+        expect(result.current.loading).toBe(false);
+        expect(result.current.data).toEqual({
+          '2025-09-01': ['interpretation4'],
+          '2025-09-02': ['interpretation3'],
+          '2025-09-03': ['interpretation2'],
+          '2025-09-04': ['interpretation1']
+        });
+        expect(result.current.error).toBeUndefined();
+      });
+    });
+    test('should handle interpretations list loading error', async () => {
+      const consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
+      const errorMsg = 'Failed to load interpretations';
+      try {
+        mockQuery.mockImplementationOnce(createMockImplementation(errorMsg, true));
+        const {
+          result
+        } = (0, _react.renderHook)(() => (0, _hooks.useInterpretationsList)(mockData.visualization.type, mockData.visualization.id), {
+          wrapper: createWrapper()
+        });
+        expect(result.current.loading).toBe(true);
+        expect(result.current.data).toBeUndefined();
+        expect(result.current.error).toBeUndefined();
+        await (0, _react.waitFor)(() => {
+          expect(result.current.loading).toBe(false);
+          expect(result.current.error).toEqual(new Error(errorMsg));
+          expect(result.current.data).toBeUndefined();
+        });
+      } finally {
+        consoleErrorSpy.mockRestore();
+      }
+    });
+    test('should reload when type/id changes', async () => {
+      // First load with initial params
+      mockQuery.mockImplementationOnce(createMockImplementation({
+        interpretations: {
+          interpretations: mockData.interpretations
+        }
+      }));
+      const {
+        result,
+        rerender
+      } = (0, _react.renderHook)(({
+        type,
+        id
+      }) => (0, _hooks.useInterpretationsList)(type, id), {
+        wrapper: createWrapper(),
+        initialProps: {
+          type: mockData.visualization.type,
+          id: mockData.visualization.id
+        }
+      });
+      await (0, _react.waitFor)(() => {
+        expect(result.current.loading).toBe(false);
+        expect(result.current.data).toEqual({
+          '2025-09-01': ['interpretation4'],
+          '2025-09-02': ['interpretation3'],
+          '2025-09-03': ['interpretation2'],
+          '2025-09-04': ['interpretation1']
+        });
+      });
+
+      // Mock second call with empty result
+      mockQuery.mockImplementationOnce(createMockImplementation({
+        interpretations: {
+          interpretations: []
+        }
+      }));
+
+      // Change type/id to trigger reload
+      rerender({
+        type: 'TABLE',
+        id: 'newViz456'
+      });
+
+      // Should show loading again
+      expect(result.current.loading).toBe(true);
+      await (0, _react.waitFor)(() => {
+        expect(result.current.loading).toBe(false);
+        expect(result.current.data).toEqual({});
+      });
+
+      // Verify that mockQuery was called twice
+      expect(mockQuery).toHaveBeenCalledTimes(2);
+    });
+  });
+  describe('Loading active interpretation', () => {
+    test('should load active interpretation', async () => {
+      await shouldLoadActiveInterpretation();
+    });
+    test('should handle active interpretation loading error', async () => {
+      const consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
+      const errorMsg = 'Failed to load interpretation details';
+      try {
+        mockQuery.mockImplementationOnce(createMockImplementation({
+          interpretations: {
+            interpretations: mockData.interpretations
+          }
+        }));
+        mockQuery.mockImplementationOnce(createMockImplementation(errorMsg, true));
+        const {
+          result
+        } = (0, _react.renderHook)(() => useAllHooks(mockData.visualization.type, mockData.visualization.id, mockData.interpretationDetails.id), {
+          wrapper: createWrapper(mockData.interpretations)
+        });
+        expect(result.current.activeInterpretation.loading).toBe(true);
+        expect(result.current.activeInterpretation.data).toBeUndefined();
+        expect(result.current.activeInterpretation.error).toBeUndefined();
+        await (0, _react.waitFor)(() => {
+          expect(result.current.activeInterpretation.loading).toBe(false);
+          expect(result.current.activeInterpretation.error).toEqual(new Error(errorMsg));
+          expect(result.current.activeInterpretation.data).toBeUndefined();
+        });
+      } finally {
+        consoleErrorSpy.mockRestore();
+      }
+    });
+    test('should reload when interpretation ID changes', async () => {
+      // Mock first interpretation load
+      mockQuery.mockImplementationOnce(createMockImplementation({
+        interpretations: {
+          interpretations: mockData.interpretations
+        }
+      }));
+      mockQuery.mockImplementationOnce(createMockImplementation({
+        interpretation: mockData.interpretationDetails
+      }));
+      const {
+        result,
+        rerender
+      } = (0, _react.renderHook)(({
+        interpretationId
+      }) => useAllHooks(mockData.visualization.type, mockData.visualization.id, interpretationId), {
+        wrapper: createWrapper(mockData.interpretations),
+        initialProps: {
+          interpretationId: mockData.interpretationDetails.id
+        }
+      });
+      await (0, _react.waitFor)(() => {
+        expect(result.current.activeInterpretation.loading).toBe(false);
+        expect(result.current.activeInterpretation.data).toEqual(mockData.interpretationDetails);
+      });
+
+      // Mock second interpretation load
+      const secondInterpretation = mockData.interpretations[1];
+      mockQuery.mockImplementationOnce(createMockImplementation({
+        interpretation: secondInterpretation
+      }));
+
+      // Change interpretation ID to trigger reload
+      rerender({
+        interpretationId: secondInterpretation.id
+      });
+
+      // Should show loading again
+      expect(result.current.activeInterpretation.loading).toBe(true);
+      await (0, _react.waitFor)(() => {
+        expect(result.current.activeInterpretation.loading).toBe(false);
+        expect(result.current.activeInterpretation.data).toEqual(secondInterpretation);
+      });
+
+      // Verify that mockQuery was called for both interpretations
+      expect(mockQuery).toHaveBeenCalledTimes(3); // 1 for list + 2 for interpretations
+    });
+  });
+  describe('Interpretation subscription', () => {
+    // Update behaviour is tested in the mutation hooks
+    it('observers subscribe when mounting and unsubscribes when unmounting', async () => {
+      const {
+        result,
+        unmount
+      } = await shouldLoadActiveInterpretation();
+      const manager = result.current.manager;
+      const initialObserversCount = manager.interpretationObservers.get(mockData.interpretationDetails.id).size;
+
+      // useInterpretation (1), useActiveInterpretation(2)
+      expect(initialObserversCount).toBe(2);
+      expect(typeof manager.interpretationsListCallback).toBe('function');
+      unmount();
+      const newObserversCount = manager.interpretationObservers.get(mockData.interpretationDetails.id).size;
+      expect(newObserversCount).toBe(0);
+      expect(manager.interpretationsListCallback).toBe(null);
+    });
+  });
+  describe('Access and current user hooks', () => {
+    test('useInterpretationAccess returns a valid access result', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      expect(result.current.interpretationAccess).toEqual({
+        comment: true,
+        delete: true,
+        edit: true,
+        share: true
+      });
+    });
+    test('useCommentAccess returns a valid access result', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      expect(result.current.commentAccess).toEqual({
+        delete: true,
+        edit: true
+      });
+    });
+    test('useInterpretationsCurrentUser returns the current user', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      expect(result.current.currentUser).toEqual(mockData.currentUser);
+    });
+  });
+  describe('Generic mutation behaviour', () => {
+    /* The following hooks all simply call `useInterpretationsManagerMutation`
+     * with a different `methodname`:
+     * - useCreateInterpretation
+     * - useUpdateInterpretationText
+     * - useDeleteInterpretation
+     * - useAddCommentToActiveInterpretation
+     * - useUpdateCommentForActiveInterpretation
+     * - useDeleteCommentFromActiveInterpretation
+     * So we only have to test one to test the shared behaviour */
+    it('can complete successfully after loading', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      mockMutate.mockImplementationOnce(createMockImplementation({}));
+      expect(result.current.mutations.deleteState.loading).toBe(false);
+      expect(result.current.mutations.deleteState.error).toBe(undefined);
+      expect(result.current.mutations.deleteState.data).toBe(undefined);
+      (0, _react.act)(() => {
+        result.current.mutations.deleteInterpretation();
+      });
+      await (0, _react.waitFor)(() => {
+        expect(result.current.mutations.deleteState.loading).toBe(true);
+        expect(result.current.mutations.deleteState.error).toBe(undefined);
+        expect(result.current.mutations.deleteState.data).toBe(undefined);
+      });
+      await (0, _react.waitFor)(() => {
+        expect(result.current.mutations.deleteState.loading).toBe(false);
+        expect(result.current.mutations.deleteState.error).toBe(undefined);
+        expect(result.current.mutations.deleteState.data).toBe(null);
+      });
+    });
+    it('can return an error after loading', async () => {
+      const consoleErrorSpy = jest.spyOn(console, 'error').mockImplementation(() => {});
+      const errorMsg = 'Failed to delete interpretation';
+      try {
+        const {
+          result
+        } = await shouldLoadActiveInterpretation();
+        mockMutate.mockImplementationOnce(createMockImplementation(errorMsg, true));
+        expect(result.current.mutations.deleteState.loading).toBe(false);
+        expect(result.current.mutations.deleteState.error).toBe(undefined);
+        expect(result.current.mutations.deleteState.data).toBe(undefined);
+        (0, _react.act)(() => {
+          result.current.mutations.deleteInterpretation();
+        });
+        await (0, _react.waitFor)(() => {
+          expect(result.current.mutations.deleteState.loading).toBe(true);
+          expect(result.current.mutations.deleteState.error).toBe(undefined);
+          expect(result.current.mutations.deleteState.data).toBe(undefined);
+        });
+        await (0, _react.waitFor)(() => {
+          expect(result.current.mutations.deleteState.loading).toBe(false);
+          expect(result.current.mutations.deleteState.error).toEqual(new Error(errorMsg));
+          expect(result.current.mutations.deleteState.data).toBe(undefined);
+        });
+      } finally {
+        consoleErrorSpy.mockRestore();
+      }
+    });
+  });
+  describe('Like behaviour', () => {
+    test('Interpretation like can be toggled', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      expect(result.current.like.isLikedByCurrentUser).toBe(true);
+      expect(result.current.like.toggleLikeInProgress).toBe(false);
+      (0, _react.act)(() => {
+        result.current.like.toggleLike();
+      });
+      await (0, _react.waitFor)(() => {
+        expect(result.current.like.toggleLikeInProgress).toBe(true);
+        expect(result.current.like.isLikedByCurrentUser).toBe(true);
+      });
+      await (0, _react.waitFor)(() => {
+        expect(result.current.like.toggleLikeInProgress).toBe(false);
+        expect(result.current.like.isLikedByCurrentUser).toBe(false);
+        // This is also reflected in the interpretation observers
+        expect(result.current.interpretation.likes).toBe(0);
+        expect(result.current.interpretation.likedBy).toEqual([]);
+        expect(result.current.activeInterpretation.data.likes).toBe(0);
+        expect(result.current.activeInterpretation.data.likedBy).toEqual([]);
+      });
+    });
+  });
+  describe('State synchronization', () => {
+    const computeListLength = idsByDate => Object.values(idsByDate).reduce((total, idList) => total + idList.length, 0);
+    test('Creating an interpretation updates the list', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      mockMutate.mockImplementationOnce(createMockImplementation({}));
+      mockQuery.mockImplementationOnce(createMockImplementation({
+        interpretations: {
+          interpretations: mockData.interpretations.concat(mockData.newInterpretation)
+        }
+      }));
+      const initialListLength = computeListLength(result.current.interpretationsList.data);
+      (0, _react.act)(() => {
+        result.current.mutations.createInterpretation();
+      });
+      await (0, _react.waitFor)(() => {
+        expect(computeListLength(result.current.interpretationsList.data)).toEqual(initialListLength + 1);
+      });
+    });
+    test('Deleting an interpretation updates the list', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      mockMutate.mockImplementationOnce(createMockImplementation({}));
+      const initialListLength = computeListLength(result.current.interpretationsList.data);
+      (0, _react.act)(() => {
+        result.current.mutations.deleteInterpretation();
+      });
+      await (0, _react.waitFor)(() => {
+        expect(computeListLength(result.current.interpretationsList.data)).toBe(initialListLength - 1);
+      });
+    });
+    test('Updating an interpretation text updates the (active) interpretation', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      mockMutate.mockImplementationOnce(createMockImplementation({}));
+      (0, _react.act)(() => {
+        result.current.mutations.updateInterpretationText();
+      });
+      await (0, _react.waitFor)(() => {
+        expect(result.current.interpretation.text).toBe('Updated text');
+        expect(result.current.activeInterpretation.data.text).toBe('Updated text');
+      });
+    });
+    /* Note that adding/removing likes also updates the interpretation state, but this
+     * behaviour is asserted in the "Like behaviour" tests above */
+    test('Adding a comment to an interpretation updates the (active) interpretation', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      mockMutate.mockImplementationOnce(createMockImplementation({}));
+      mockQuery.mockImplementationOnce(createMockImplementation({
+        interpretation: {
+          ...mockData.interpretationDetails,
+          comments: [...mockData.interpretationDetails.comments, mockData.newComment]
+        }
+      }));
+      const initialCommentsLength = result.current.interpretation.comments.length;
+      (0, _react.act)(() => {
+        result.current.mutations.addComment();
+      });
+      await (0, _react.waitFor)(() => {
+        expect(result.current.interpretation.comments.length).toBe(initialCommentsLength + 1);
+        expect(result.current.activeInterpretation.data.comments.length).toBe(initialCommentsLength + 1);
+      });
+    });
+    test('Removing a comment from an interpretation updates the (active) interpretation', async () => {
+      const {
+        result
+      } = await shouldLoadActiveInterpretation();
+      mockMutate.mockImplementationOnce(createMockImplementation({}));
+      const initialCommentsLength = result.current.interpretation.comments.length;
+      (0, _react.act)(() => {
+        result.current.mutations.deleteComment();
+      });
+      await (0, _react.waitFor)(() => {
+        expect(result.current.interpretation.comments.length).toBe(initialCommentsLength - 1);
+        expect(result.current.activeInterpretation.data.comments.length).toBe(initialCommentsLength - 1);
+      });
+    });
+  });
+});

package/build/cjs/components/Interpretations/InterpretationsProvider/groupInterpretationIdsByDate.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.groupInterpretationIdsByDate = void 0;
+const groupInterpretationIdsByDate = interpretations => interpretations.sort((a, b) => new Date(b.created) - new Date(a.created)).reduce((dateGroups, interpretation) => {
+  const dateKey = interpretation.created.split('T')[0];
+  if (dateKey in dateGroups) {
+    dateGroups[dateKey].push(interpretation.id);
+  } else {
+    dateGroups[dateKey] = [interpretation.id];
+  }
+  return dateGroups;
+}, {});
+exports.groupInterpretationIdsByDate = groupInterpretationIdsByDate;