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

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

@@ -0,0 +1,48 @@
+import { ID } from '../../../commonStateTypes/common';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { TimeEntryRangeKey, TimeEntryViewState } from './timeEntryViewState';
+export declare const initialState: TimeEntryViewState;
+export declare const fetchTimeEntriesForTask: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[taskId: string, cacheOverride?: any], {
+    taskId: string;
+    cacheOverride: any;
+}, "timeEntryView/fetchTimeEntriesForTask", never, never>, fetchTimeEntriesForTaskSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    taskId: ID;
+    timeEntryIds: ID[];
+}, "timeEntryView/fetchTimeEntriesForTaskSuccess">, fetchTimeEntriesForTaskFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    status: ZeniAPIStatus;
+    taskId: ID;
+}, "timeEntryView/fetchTimeEntriesForTaskFailure">, fetchTimeEntriesForRange: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[userId: string, startDate: string, endDate: string, cacheOverride?: any], {
+    userId: string;
+    startDate: string;
+    endDate: string;
+    cacheOverride: any;
+}, "timeEntryView/fetchTimeEntriesForRange", never, never>, fetchTimeEntriesForRangeSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    rangeKey: TimeEntryRangeKey;
+    timeEntryIds: ID[];
+}, "timeEntryView/fetchTimeEntriesForRangeSuccess">, fetchTimeEntriesForRangeFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    rangeKey: TimeEntryRangeKey;
+    status: ZeniAPIStatus;
+}, "timeEntryView/fetchTimeEntriesForRangeFailure">, logTime: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[taskId: string, minutes: number, entryDate: string, source?: "manual" | "timer" | undefined, identifier?: string | undefined], {
+    taskId: string;
+    minutes: number;
+    entryDate: string;
+    source: "manual" | "timer";
+    identifier: string | undefined;
+}, "timeEntryView/logTime", never, never>, logTimeSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    taskId: ID;
+    timeEntryId: ID;
+}, "timeEntryView/logTimeSuccess">, logTimeFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    status: ZeniAPIStatus;
+    taskId: ID;
+}, "timeEntryView/logTimeFailure">, updateTimeEntryMinutes: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[timeEntryId: string, minutes: number], {
+    timeEntryId: string;
+    minutes: number;
+}, "timeEntryView/updateTimeEntryMinutes", never, never>, deleteTimeEntry: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "timeEntryView/deleteTimeEntry">, timeEntryWriteSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    timeEntryId: ID;
+    removedFromTaskId?: ID;
+}, "timeEntryView/timeEntryWriteSuccess">, timeEntryWriteFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    status: ZeniAPIStatus;
+    timeEntryId: ID;
+}, "timeEntryView/timeEntryWriteFailure">, fetchTaskCategories: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"timeEntryView/fetchTaskCategories">, fetchTaskCategoriesSuccess: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"timeEntryView/fetchTaskCategoriesSuccess">, fetchTaskCategoriesFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "timeEntryView/fetchTaskCategoriesFailure">;
+declare const _default: import("redux").Reducer<TimeEntryViewState>;
+export default _default;

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

@@ -0,0 +1,164 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchTaskCategoriesFailure = exports.fetchTaskCategoriesSuccess = exports.fetchTaskCategories = exports.timeEntryWriteFailure = exports.timeEntryWriteSuccess = exports.deleteTimeEntry = exports.updateTimeEntryMinutes = exports.logTimeFailure = exports.logTimeSuccess = exports.logTime = exports.fetchTimeEntriesForRangeFailure = exports.fetchTimeEntriesForRangeSuccess = exports.fetchTimeEntriesForRange = exports.fetchTimeEntriesForTaskFailure = exports.fetchTimeEntriesForTaskSuccess = exports.fetchTimeEntriesForTask = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const rootActions_1 = require("../../../rootActions");
+const NOT_STARTED = { fetchState: 'Not-Started', error: undefined };
+exports.initialState = {
+    timeEntryIdsByTaskId: {},
+    fetchStateByTaskId: {},
+    timeEntryIdsByRangeKey: {},
+    fetchStateByRangeKey: {},
+    saveStateByTaskId: {},
+    saveStateByTimeEntryId: {},
+    taskCategoryFetchState: NOT_STARTED,
+};
+const timeEntryView = (0, toolkit_1.createSlice)({
+    name: 'timeEntryView',
+    initialState: exports.initialState,
+    reducers: {
+        fetchTimeEntriesForTask: {
+            prepare(taskId, cacheOverride = false) {
+                return { payload: { taskId, cacheOverride } };
+            },
+            reducer(draft, action) {
+                draft.fetchStateByTaskId[action.payload.taskId] = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+        },
+        fetchTimeEntriesForTaskSuccess(draft, action) {
+            const { taskId, timeEntryIds } = action.payload;
+            // Replaced, not merged: the server is authoritative about which entries
+            // a task has, and a merge would resurrect one that was just deleted.
+            draft.timeEntryIdsByTaskId[taskId] = timeEntryIds;
+            draft.fetchStateByTaskId[taskId] = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        fetchTimeEntriesForTaskFailure(draft, action) {
+            draft.fetchStateByTaskId[action.payload.taskId] = {
+                fetchState: 'Error',
+                error: action.payload.status,
+            };
+        },
+        fetchTimeEntriesForRange: {
+            prepare(userId, startDate, endDate, cacheOverride = false) {
+                return { payload: { userId, startDate, endDate, cacheOverride } };
+            },
+            reducer(draft, action) {
+                const { userId, startDate, endDate } = action.payload;
+                draft.fetchStateByRangeKey[`${userId}_${startDate}_${endDate}`] = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+        },
+        fetchTimeEntriesForRangeSuccess(draft, action) {
+            const { rangeKey, timeEntryIds } = action.payload;
+            draft.timeEntryIdsByRangeKey[rangeKey] = timeEntryIds;
+            draft.fetchStateByRangeKey[rangeKey] = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        fetchTimeEntriesForRangeFailure(draft, action) {
+            draft.fetchStateByRangeKey[action.payload.rangeKey] = {
+                fetchState: 'Error',
+                error: action.payload.status,
+            };
+        },
+        logTime: {
+            prepare(taskId, minutes, entryDate, source = 'manual', identifier) {
+                return { payload: { taskId, minutes, entryDate, source, identifier } };
+            },
+            reducer(draft, action) {
+                draft.saveStateByTaskId[action.payload.taskId] = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+        },
+        logTimeSuccess(draft, action) {
+            const { taskId, timeEntryId } = action.payload;
+            draft.saveStateByTaskId[taskId] = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+            const existing = draft.timeEntryIdsByTaskId[taskId] ?? [];
+            // Guarded against a duplicate id: a retried write with the same
+            // deterministic identifier returns the SAME entry, and pushing it twice
+            // would double it in the breakdown even though the server has one row.
+            if (!existing.includes(timeEntryId)) {
+                draft.timeEntryIdsByTaskId[taskId] = [...existing, timeEntryId];
+            }
+        },
+        logTimeFailure(draft, action) {
+            draft.saveStateByTaskId[action.payload.taskId] = {
+                fetchState: 'Error',
+                error: action.payload.status,
+            };
+        },
+        updateTimeEntryMinutes: {
+            prepare(timeEntryId, minutes) {
+                return { payload: { timeEntryId, minutes } };
+            },
+            reducer(draft, action) {
+                draft.saveStateByTimeEntryId[action.payload.timeEntryId] = {
+                    fetchState: 'In-Progress',
+                    error: undefined,
+                };
+            },
+        },
+        deleteTimeEntry(draft, action) {
+            draft.saveStateByTimeEntryId[action.payload] = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        timeEntryWriteSuccess(draft, action) {
+            const { timeEntryId, removedFromTaskId } = action.payload;
+            draft.saveStateByTimeEntryId[timeEntryId] = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+            if (removedFromTaskId != null) {
+                draft.timeEntryIdsByTaskId[removedFromTaskId] = (draft.timeEntryIdsByTaskId[removedFromTaskId] ?? []).filter((candidate) => candidate !== timeEntryId);
+            }
+        },
+        timeEntryWriteFailure(draft, action) {
+            draft.saveStateByTimeEntryId[action.payload.timeEntryId] = {
+                fetchState: 'Error',
+                error: action.payload.status,
+            };
+        },
+        fetchTaskCategories(draft) {
+            draft.taskCategoryFetchState = {
+                fetchState: 'In-Progress',
+                error: undefined,
+            };
+        },
+        fetchTaskCategoriesSuccess(draft) {
+            draft.taskCategoryFetchState = {
+                fetchState: 'Completed',
+                error: undefined,
+            };
+        },
+        fetchTaskCategoriesFailure(draft, action) {
+            draft.taskCategoryFetchState = {
+                fetchState: 'Error',
+                error: action.payload,
+            };
+        },
+    },
+    extraReducers: (builder) => {
+        builder.addCase(rootActions_1.clearAll, (draft) => {
+            Object.assign(draft, exports.initialState);
+        });
+    },
+});
+_a = timeEntryView.actions, exports.fetchTimeEntriesForTask = _a.fetchTimeEntriesForTask, exports.fetchTimeEntriesForTaskSuccess = _a.fetchTimeEntriesForTaskSuccess, exports.fetchTimeEntriesForTaskFailure = _a.fetchTimeEntriesForTaskFailure, exports.fetchTimeEntriesForRange = _a.fetchTimeEntriesForRange, exports.fetchTimeEntriesForRangeSuccess = _a.fetchTimeEntriesForRangeSuccess, exports.fetchTimeEntriesForRangeFailure = _a.fetchTimeEntriesForRangeFailure, exports.logTime = _a.logTime, exports.logTimeSuccess = _a.logTimeSuccess, exports.logTimeFailure = _a.logTimeFailure, exports.updateTimeEntryMinutes = _a.updateTimeEntryMinutes, exports.deleteTimeEntry = _a.deleteTimeEntry, exports.timeEntryWriteSuccess = _a.timeEntryWriteSuccess, exports.timeEntryWriteFailure = _a.timeEntryWriteFailure, exports.fetchTaskCategories = _a.fetchTaskCategories, exports.fetchTaskCategoriesSuccess = _a.fetchTaskCategoriesSuccess, exports.fetchTaskCategoriesFailure = _a.fetchTaskCategoriesFailure;
+exports.default = timeEntryView.reducer;

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/lib/zeniAPI.d.ts

@@ -25,7 +25,7 @@ export interface RESTAPIEndpoints {
     readonly tenantMicroServiceBaseUrl: string;
 }
 export interface ZeniAPI<ResponseType = FetchResponse> {
-    apiEndPoints: RESTAPIEndpoints;
+    readonly apiEndPoints: RESTAPIEndpoints;
     readonly sessionId?: string;
     readonly tenantId?: string;
     readonly userId?: string;
@@ -40,7 +40,7 @@ export interface ZeniAPI<ResponseType = FetchResponse> {
     update(userId?: string, sessionId?: string, tenantId?: string): void;
 }
 export declare class ZeniAPIClient implements ZeniAPI {
-    apiEndPoints: RESTAPIEndpoints;
+    readonly apiEndPoints: RESTAPIEndpoints;
     userId?: string | undefined;
     sessionId?: string | undefined;
     tenantId?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeniai/client-epic-state",
-  "version": "5.3.7-betaRD0",
+  "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",
@@ -53,31 +53,6 @@
     "url": "https://github.com/zeni-ai/client-epic-state/issues"
   },
   "homepage": "https://github.com/zeni-ai/client-epic-state#readme",
-  "devDependencies": {
-    "@eslint/js": "^9.24.0",
-    "@liveblocks/client": "^2.23.0",
-    "@trivago/prettier-plugin-sort-imports": "^5.2.2",
-    "@types/big.js": "^6.2.2",
-    "@types/lodash": "^4.17.23",
-    "@types/node": "^20.19.0",
-    "@types/url-parse": "^1.4.11",
-    "@typescript-eslint/eslint-plugin": "^8.56.0",
-    "@typescript-eslint/parser": "^8.56.0",
-    "concurrently": "^9.1.2",
-    "eslint": "^9.24.0",
-    "eslint-config-prettier": "^10.0.2",
-    "eslint-plugin-perfectionist": "^4.15.0",
-    "eslint-plugin-unused-imports": "^4.1.4",
-    "globals": "^16.0.0",
-    "knip": "^6.21.0",
-    "madge": "^8.0.0",
-    "prettier": "^3.5.3",
-    "rimraf": "^6.0.1",
-    "semver": "^7.7.1",
-    "typescript": "^5.7.3",
-    "vite": "^7.3.5",
-    "vitest": "^4.1.11"
-  },
   "dependencies": {
     "@redux-devtools/extension": "^3.3.0",
     "@reduxjs/toolkit": "^1.6.2",

package/lib/esm/sessionEndpointsLoader.js

@@ -1,7 +0,0 @@
-let sessionEndpointsLoader;
-export function setSessionEndpointsLoader(loader) {
-    sessionEndpointsLoader = loader;
-}
-export function getSessionEndpointsLoader() {
-    return sessionEndpointsLoader;
-}

package/lib/sessionEndpointsLoader.d.ts

@@ -1,9 +0,0 @@
-/**
- * Called after sign-in, before the user's tenants are fetched. The app uses it
- * to fetch the endpoints that are only served to a signed-in session and to
- * hand them to `updateZeniAPIEndpoints`. Without a loader, tenants are fetched
- * straight away with the endpoints given to `initialize`.
- */
-export type SessionEndpointsLoader = (userId: string, sessionId?: string) => Promise<void>;
-export declare function setSessionEndpointsLoader(loader: SessionEndpointsLoader | undefined): void;
-export declare function getSessionEndpointsLoader(): SessionEndpointsLoader | undefined;

package/lib/sessionEndpointsLoader.js

@@ -1,11 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setSessionEndpointsLoader = setSessionEndpointsLoader;
-exports.getSessionEndpointsLoader = getSessionEndpointsLoader;
-let sessionEndpointsLoader;
-function setSessionEndpointsLoader(loader) {
-    sessionEndpointsLoader = loader;
-}
-function getSessionEndpointsLoader() {
-    return sessionEndpointsLoader;
-}