@zeniai/client-epic-state 5.3.7 → 5.3.8-beta0DI

package/lib/view/taskManager/timeEntryView/timeEntryViewSelector.d.ts

@@ -0,0 +1,24 @@
+import { FetchState, ID } from '../../../commonStateTypes/common';
+import { TimeEntry } from '../../../entity/timeEntry/timeEntryState';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { RootState } from '../../../rootStateTypes';
+import { TimeEntryRangeKey } from './timeEntryViewState';
+export interface TimeEntryListView {
+    fetchState: FetchState;
+    timeEntries: TimeEntry[];
+    totalMinutes: number;
+    error?: ZeniAPIStatus;
+}
+/** Every entry on one task, all users — the task detail breakdown. */
+export declare function getTimeEntriesForTask(state: RootState, taskId: ID): TimeEntryListView;
+export interface TimesheetWeekView extends TimeEntryListView {
+    /** Minutes per `YYYY-MM-DD`. The weekly grid is a column per day, so the
+     *  grouping belongs here rather than in every consumer. */
+    minutesByDate: Record<string, number>;
+    rangeKey: TimeEntryRangeKey;
+}
+/** One user's week — the timesheet grid. */
+export declare function getTimeEntriesForRange(state: RootState, userId: ID, startDate: string, endDate: string): TimesheetWeekView;
+/** Save state for the row the user is editing, so two rows saving at once do
+ *  not share one spinner. */
+export declare function getTimeEntrySaveState(state: RootState, taskId: ID): FetchState;

package/lib/view/taskManager/timeEntryView/timeEntryViewSelector.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTimeEntriesForTask = getTimeEntriesForTask;
+exports.getTimeEntriesForRange = getTimeEntriesForRange;
+exports.getTimeEntrySaveState = getTimeEntrySaveState;
+const timeEntrySelector_1 = require("../../../entity/timeEntry/timeEntrySelector");
+const timeEntryViewState_1 = require("./timeEntryViewState");
+const byEntryDateThenCreate = (left, right) => left.entryDate.valueOf() - right.entryDate.valueOf() ||
+    left.createTime.valueOf() - right.createTime.valueOf();
+const sumMinutes = (entries) => entries.reduce((total, entry) => total + (entry.minutes || 0), 0);
+/** Every entry on one task, all users — the task detail breakdown. */
+function getTimeEntriesForTask(state, taskId) {
+    const { timeEntryIdsByTaskId, fetchStateByTaskId } = state.timeEntryViewState;
+    const timeEntries = (0, timeEntrySelector_1.getTimeEntriesByIds)(state.timeEntryState, timeEntryIdsByTaskId[taskId] ?? []).sort(byEntryDateThenCreate);
+    return {
+        timeEntries,
+        totalMinutes: sumMinutes(timeEntries),
+        fetchState: fetchStateByTaskId[taskId]?.fetchState ?? 'Not-Started',
+        error: fetchStateByTaskId[taskId]?.error,
+    };
+}
+/** One user's week — the timesheet grid. */
+function getTimeEntriesForRange(state, userId, startDate, endDate) {
+    const rangeKey = (0, timeEntryViewState_1.toTimeEntryRangeKey)(userId, startDate, endDate);
+    const { timeEntryIdsByRangeKey, fetchStateByRangeKey } = state.timeEntryViewState;
+    const timeEntries = (0, timeEntrySelector_1.getTimeEntriesByIds)(state.timeEntryState, timeEntryIdsByRangeKey[rangeKey] ?? []).sort(byEntryDateThenCreate);
+    const minutesByDate = {};
+    timeEntries.forEach((entry) => {
+        const key = entry.entryDate.format('YYYY-MM-DD');
+        minutesByDate[key] = (minutesByDate[key] ?? 0) + (entry.minutes || 0);
+    });
+    return {
+        rangeKey,
+        timeEntries,
+        minutesByDate,
+        totalMinutes: sumMinutes(timeEntries),
+        fetchState: fetchStateByRangeKey[rangeKey]?.fetchState ?? 'Not-Started',
+        error: fetchStateByRangeKey[rangeKey]?.error,
+    };
+}
+/** Save state for the row the user is editing, so two rows saving at once do
+ *  not share one spinner. */
+function getTimeEntrySaveState(state, taskId) {
+    return (state.timeEntryViewState.saveStateByTaskId[taskId]?.fetchState ??
+        'Not-Started');
+}

package/lib/view/taskManager/timeEntryView/timeEntryViewState.d.ts

@@ -0,0 +1,21 @@
+import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
+/** Mon-Fri is quoted to people inclusively, so the key is both ends. */
+export type TimeEntryRangeKey = `${string}_${string}_${string}`;
+export declare const toTimeEntryRangeKey: (userId: ID, startDate: string, endDate: string) => TimeEntryRangeKey;
+export interface TimeEntryViewState {
+    fetchStateByRangeKey: Record<TimeEntryRangeKey, FetchStateAndError>;
+    fetchStateByTaskId: Record<ID, FetchStateAndError>;
+    /** Per task, because two rows can be saving at once on the board and a
+     *  single flag would make one row's spinner answer for the other. */
+    saveStateByTaskId: Record<ID, FetchStateAndError>;
+    /** Per entry, for edits and deletes addressed by entry id. */
+    saveStateByTimeEntryId: Record<ID, FetchStateAndError>;
+    taskCategoryFetchState: FetchStateAndError;
+    /** Ids per (user, start, end). Keyed by the window rather than by user so
+     *  two weeks open at once do not overwrite each other. */
+    timeEntryIdsByRangeKey: Record<TimeEntryRangeKey, ID[]>;
+    /** Ids per task, so the detail breakdown does not scan every entry in the
+     *  store. Replaced wholesale on fetch — the server is authoritative about
+     *  which entries a task has. */
+    timeEntryIdsByTaskId: Record<ID, ID[]>;
+}

package/lib/view/taskManager/timeEntryView/timeEntryViewState.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toTimeEntryRangeKey = void 0;
+const toTimeEntryRangeKey = (userId, startDate, endDate) => `${userId}_${startDate}_${endDate}`;
+exports.toTimeEntryRangeKey = toTimeEntryRangeKey;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeniai/client-epic-state",
-  "version": "5.3.7",
+  "version": "5.3.8-beta0DI",
   "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
   "main": "lib/index.js",
   "module": "lib/esm/index.js",