dce-commonkit 5.0.1 → 5.0.3

package/lib/helpers/convertDateKeyToDateInfo.d.ts

@@ -0,0 +1,9 @@
+import DateInfo from '../types/DateInfo';
+/**
+ * Convert dateKey in MM/DD/YYYY format to DateInfo object
+ * @author Gardenia Liu
+ * @param dateKey - Date string in MM/DD/YYYY format (e.g., "7/19/2025")
+ * @returns DateInfo object or null if parsing fails
+ */
+declare const convertDateKeyToDateInfo: (dateKey: string) => DateInfo | null;
+export default convertDateKeyToDateInfo;

package/lib/helpers/convertDateKeyToDateInfo.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Convert dateKey in MM/DD/YYYY format to DateInfo object
+ * @author Gardenia Liu
+ * @param dateKey - Date string in MM/DD/YYYY format (e.g., "7/19/2025")
+ * @returns DateInfo object or null if parsing fails
+ */
+var convertDateKeyToDateInfo = function (dateKey) {
+    var _a = dateKey.split('/'), monthStr = _a[0], dayStr = _a[1], yearStr = _a[2];
+    var month = Number.parseInt(monthStr, 10);
+    var day = Number.parseInt(dayStr, 10);
+    var year = Number.parseInt(yearStr, 10);
+    // Return DateInfo if parsing was successful (no NaN values)
+    if (!Number.isNaN(year) && !Number.isNaN(month) && !Number.isNaN(day)) {
+        return {
+            year: year,
+            month: month,
+            day: day,
+        };
+    }
+    return null;
+};
+exports.default = convertDateKeyToDateInfo;
+//# sourceMappingURL=convertDateKeyToDateInfo.js.map

package/lib/helpers/convertDateKeyToDateInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertDateKeyToDateInfo.js","sourceRoot":"","sources":["../../src/helpers/convertDateKeyToDateInfo.ts"],"names":[],"mappings":";;AAGA;;;;;GAKG;AACH,IAAM,wBAAwB,GAAG,UAAC,OAAe;IACzC,IAAA,KAA8B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAA/C,QAAQ,QAAA,EAAE,MAAM,QAAA,EAAE,OAAO,QAAsB,CAAC;IAEvD,IAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxC,IAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE1C,4DAA4D;IAC5D,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,OAAO;YACL,IAAI,MAAA;YACJ,KAAK,OAAA;YACL,GAAG,KAAA;SACJ,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,kBAAe,wBAAwB,CAAC"}

package/lib/helpers/getMondayOfWeek.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Get the start of the week (Monday) in string form given a specific timestamp.
+ * The format is MM/DD/YYYY.
+ * @author Allison Zhang
+ * @param timestamp the timestamp of a date within a week
+ * @returns string with format 'MM/DD/YYYY' of the Monday that starts the week
+ * that contains the timestamp
+ */
+declare const getMondayOfTimestamp: (timestamp: number) => string;
+export default getMondayOfTimestamp;

package/lib/helpers/getMondayOfWeek.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var getTimeInfoInET_1 = __importDefault(require("./getTimeInfoInET"));
+/**
+ * Get the start of the week (Monday) in string form given a specific timestamp.
+ * The format is MM/DD/YYYY.
+ * @author Allison Zhang
+ * @param timestamp the timestamp of a date within a week
+ * @returns string with format 'MM/DD/YYYY' of the Monday that starts the week
+ * that contains the timestamp
+ */
+var getMondayOfTimestamp = function (timestamp) {
+    // Get the date in ET!
+    var _a = (0, getTimeInfoInET_1.default)(timestamp), month = _a.month, day = _a.day, year = _a.year;
+    var date = new Date("".concat(month, "/").concat(day, "/").concat(year));
+    var dayOfTheWeek = date.getDay();
+    // Get the offset to the previous Monday
+    // If the day of the week is Sunda, we want the offset to be the Monday of
+    // the previous week
+    var daysPastPrevMonday = 0;
+    if (dayOfTheWeek === 0) {
+        // Handle Sunday separately: Sunday is 6 days past Monday
+        daysPastPrevMonday = 6;
+    }
+    else if (dayOfTheWeek > 1) {
+        // Tuesday - Saturday: just subtract 1 from the day of the week
+        // (dayOfTheWeek: 1 = Monday, 2 = Tuesday)
+        daysPastPrevMonday = dayOfTheWeek - 1;
+    }
+    var dayOfTheMonth = date.getDate();
+    // Get the day of the month of the previous Monday
+    date.setDate(dayOfTheMonth - daysPastPrevMonday);
+    return "".concat(date.getMonth() + 1, "/").concat(date.getDate(), "/").concat(date.getFullYear());
+};
+exports.default = getMondayOfTimestamp;
+//# sourceMappingURL=getMondayOfWeek.js.map

package/lib/helpers/getMondayOfWeek.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMondayOfWeek.js","sourceRoot":"","sources":["../../src/helpers/getMondayOfWeek.ts"],"names":[],"mappings":";;;;;AAAA,sEAAgD;AAEhD;;;;;;;GAOG;AACH,IAAM,oBAAoB,GAAG,UAAC,SAAiB;IAC7C,sBAAsB;IAChB,IAAA,KAIF,IAAA,yBAAe,EAAC,SAAS,CAAC,EAH5B,KAAK,WAAA,EACL,GAAG,SAAA,EACH,IAAI,UACwB,CAAC;IAC/B,IAAM,IAAI,GAAG,IAAI,IAAI,CAAC,UAAG,KAAK,cAAI,GAAG,cAAI,IAAI,CAAE,CAAC,CAAC;IAEjD,IAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IACnC,wCAAwC;IAExC,0EAA0E;IAC1E,oBAAoB;IACpB,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAC3B,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,yDAAyD;QACzD,kBAAkB,GAAG,CAAC,CAAC;IACzB,CAAC;SAAM,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QAC5B,+DAA+D;QAC/D,0CAA0C;QAC1C,kBAAkB,GAAG,YAAY,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,IAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IACrC,kDAAkD;IAClD,IAAI,CAAC,OAAO,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAC;IACjD,OAAO,UAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,cAAI,IAAI,CAAC,OAAO,EAAE,cAAI,IAAI,CAAC,WAAW,EAAE,CAAE,CAAC;AAC1E,CAAC,CAAC;AAEF,kBAAe,oBAAoB,CAAC"}

package/lib/index.d.ts

@@ -25,6 +25,7 @@ import getPartOfDay from './helpers/getPartOfDay';
 import stringsToHumanReadableList from './helpers/stringsToHumanReadableList';
 import onlyKeepLetters from './helpers/onlyKeepLetters';
 import parallelLimit from './helpers/parallelLimit';
+import getMondayOfTimestamp from './helpers/getMondayOfWeek';
 import getMonthName from './helpers/getMonthName';
 import genCSV from './helpers/genCSV';
 import extractProp from './helpers/extractProp';
@@ -47,6 +48,7 @@ import getWordCount from './helpers/getWordCount';
 import cloneDeep from './helpers/cloneDeep';
 import getTimestampFromTimeInfoInET from './helpers/getTimestampFromTimeInfoInET';
 import spaceAtCapitals from './helpers/spaceAtCapitals';
+import convertDateKeyToDateInfo from './helpers/convertDateKeyToDateInfo';
 import ParamType from './types/ParamType';
 import DayOfWeek from './types/DayOfWeek';
 import Log from './types/Log';
@@ -69,4 +71,4 @@ import ContextFilterState from './types/LogReviewerFilterState/ContextFilterStat
 import TagFilterState from './types/LogReviewerFilterState/TagFilterState';
 import ActionErrorFilterState from './types/LogReviewerFilterState/ActionErrorFilterState';
 import AdvancedFilterState from './types/LogReviewerFilterState/AdvancedFilterState';
-export { ErrorWithCode, MINUTE_IN_MS, HOUR_IN_MS, DAY_IN_MS, LOG_REVIEW_ROUTE_PATH_PREFIX, LOG_ROUTE_PATH, LOG_REVIEW_STATUS_ROUTE, LOG_REVIEW_GET_LOGS_ROUTE, SELECT_ADMIN_CHECK_ROUTE, CommonKitErrorCode, ParamType, DayOfWeek, Log, LogType, LogSource, LogAction, LogBuiltInMetadata, LogMetadataType, LogFunction, LogTypeSpecificInfo, LogMainInfo, LogSourceSpecificInfo, LogLevel, LogMetadataContextMap, LogMetadataTargetMap, LogReviewerFilterState, DateFilterState, ContextFilterState, TagFilterState, ActionErrorFilterState, AdvancedFilterState, abbreviate, avg, ceilToNumDecimals, floorToNumDecimals, forceNumIntoBounds, padDecimalZeros, padZerosLeft, roundToNumDecimals, sum, waitMs, getOrdinal, getTimeInfoInET, startMinWait, getHumanReadableDate, getPartOfDay, stringsToHumanReadableList, onlyKeepLetters, parallelLimit, getMonthName, genCSV, extractProp, compareArraysByProp, genCommaList, validateEmail, validatePhoneNumber, validateString, getLocalTimeInfo, idify, prefixWithAOrAn, everyAsync, filterAsync, forEachAsync, mapAsync, someAsync, capitalize, shuffleArray, getWordCount, cloneDeep, getTimestampFromTimeInfoInET, spaceAtCapitals, };
+export { ErrorWithCode, MINUTE_IN_MS, HOUR_IN_MS, DAY_IN_MS, LOG_REVIEW_ROUTE_PATH_PREFIX, LOG_ROUTE_PATH, LOG_REVIEW_STATUS_ROUTE, LOG_REVIEW_GET_LOGS_ROUTE, SELECT_ADMIN_CHECK_ROUTE, CommonKitErrorCode, ParamType, DayOfWeek, Log, LogType, LogSource, LogAction, LogBuiltInMetadata, LogMetadataType, LogFunction, LogTypeSpecificInfo, LogMainInfo, LogSourceSpecificInfo, LogLevel, LogMetadataContextMap, LogMetadataTargetMap, LogReviewerFilterState, DateFilterState, ContextFilterState, TagFilterState, ActionErrorFilterState, AdvancedFilterState, abbreviate, avg, ceilToNumDecimals, floorToNumDecimals, forceNumIntoBounds, padDecimalZeros, padZerosLeft, roundToNumDecimals, sum, waitMs, getOrdinal, getTimeInfoInET, convertDateKeyToDateInfo, startMinWait, getHumanReadableDate, getPartOfDay, stringsToHumanReadableList, onlyKeepLetters, parallelLimit, getMondayOfTimestamp, getMonthName, genCSV, extractProp, compareArraysByProp, genCommaList, validateEmail, validatePhoneNumber, validateString, getLocalTimeInfo, idify, prefixWithAOrAn, everyAsync, filterAsync, forEachAsync, mapAsync, someAsync, capitalize, shuffleArray, getWordCount, cloneDeep, getTimestampFromTimeInfoInET, spaceAtCapitals, };

package/lib/index.js

@@ -3,8 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapAsync = exports.forEachAsync = exports.filterAsync = exports.everyAsync = exports.prefixWithAOrAn = exports.idify = exports.getLocalTimeInfo = exports.validateString = exports.validatePhoneNumber = exports.validateEmail = exports.genCommaList = exports.compareArraysByProp = exports.extractProp = exports.genCSV = exports.getMonthName = exports.parallelLimit = exports.onlyKeepLetters = exports.stringsToHumanReadableList = exports.getPartOfDay = exports.getHumanReadableDate = exports.startMinWait = exports.getTimeInfoInET = exports.getOrdinal = exports.waitMs = exports.sum = exports.roundToNumDecimals = exports.padZerosLeft = exports.padDecimalZeros = exports.forceNumIntoBounds = exports.floorToNumDecimals = exports.ceilToNumDecimals = exports.avg = exports.abbreviate = exports.LogLevel = exports.LogBuiltInMetadata = exports.LogAction = exports.LogSource = exports.LogType = exports.DayOfWeek = exports.ParamType = exports.CommonKitErrorCode = exports.SELECT_ADMIN_CHECK_ROUTE = exports.LOG_REVIEW_GET_LOGS_ROUTE = exports.LOG_REVIEW_STATUS_ROUTE = exports.LOG_ROUTE_PATH = exports.LOG_REVIEW_ROUTE_PATH_PREFIX = exports.DAY_IN_MS = exports.HOUR_IN_MS = exports.MINUTE_IN_MS = exports.ErrorWithCode = void 0;
-exports.spaceAtCapitals = exports.getTimestampFromTimeInfoInET = exports.cloneDeep = exports.getWordCount = exports.shuffleArray = exports.capitalize = exports.someAsync = void 0;
+exports.filterAsync = exports.everyAsync = exports.prefixWithAOrAn = exports.idify = exports.getLocalTimeInfo = exports.validateString = exports.validatePhoneNumber = exports.validateEmail = exports.genCommaList = exports.compareArraysByProp = exports.extractProp = exports.genCSV = exports.getMonthName = exports.getMondayOfTimestamp = exports.parallelLimit = exports.onlyKeepLetters = exports.stringsToHumanReadableList = exports.getPartOfDay = exports.getHumanReadableDate = exports.startMinWait = exports.convertDateKeyToDateInfo = exports.getTimeInfoInET = exports.getOrdinal = exports.waitMs = exports.sum = exports.roundToNumDecimals = exports.padZerosLeft = exports.padDecimalZeros = exports.forceNumIntoBounds = exports.floorToNumDecimals = exports.ceilToNumDecimals = exports.avg = exports.abbreviate = exports.LogLevel = exports.LogBuiltInMetadata = exports.LogAction = exports.LogSource = exports.LogType = exports.DayOfWeek = exports.ParamType = exports.CommonKitErrorCode = exports.SELECT_ADMIN_CHECK_ROUTE = exports.LOG_REVIEW_GET_LOGS_ROUTE = exports.LOG_REVIEW_STATUS_ROUTE = exports.LOG_ROUTE_PATH = exports.LOG_REVIEW_ROUTE_PATH_PREFIX = exports.DAY_IN_MS = exports.HOUR_IN_MS = exports.MINUTE_IN_MS = exports.ErrorWithCode = void 0;
+exports.spaceAtCapitals = exports.getTimestampFromTimeInfoInET = exports.cloneDeep = exports.getWordCount = exports.shuffleArray = exports.capitalize = exports.someAsync = exports.mapAsync = exports.forEachAsync = void 0;
 // Import errors
 var ErrorWithCode_1 = __importDefault(require("./errors/ErrorWithCode"));
 exports.ErrorWithCode = ErrorWithCode_1.default;
@@ -62,6 +62,8 @@ var onlyKeepLetters_1 = __importDefault(require("./helpers/onlyKeepLetters"));
 exports.onlyKeepLetters = onlyKeepLetters_1.default;
 var parallelLimit_1 = __importDefault(require("./helpers/parallelLimit"));
 exports.parallelLimit = parallelLimit_1.default;
+var getMondayOfWeek_1 = __importDefault(require("./helpers/getMondayOfWeek"));
+exports.getMondayOfTimestamp = getMondayOfWeek_1.default;
 var getMonthName_1 = __importDefault(require("./helpers/getMonthName"));
 exports.getMonthName = getMonthName_1.default;
 var genCSV_1 = __importDefault(require("./helpers/genCSV"));
@@ -106,6 +108,8 @@ var getTimestampFromTimeInfoInET_1 = __importDefault(require("./helpers/getTimes
 exports.getTimestampFromTimeInfoInET = getTimestampFromTimeInfoInET_1.default;
 var spaceAtCapitals_1 = __importDefault(require("./helpers/spaceAtCapitals"));
 exports.spaceAtCapitals = spaceAtCapitals_1.default;
+var convertDateKeyToDateInfo_1 = __importDefault(require("./helpers/convertDateKeyToDateInfo"));
+exports.convertDateKeyToDateInfo = convertDateKeyToDateInfo_1.default;
 // Import types
 var ParamType_1 = __importDefault(require("./types/ParamType"));
 exports.ParamType = ParamType_1.default;

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/types/DateInfo.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bundle of all date information for an attendance record
+ * @author Gabe Abrams
+ */
+type DateInfo = {
+    year: number;
+    month: number;
+    day: number;
+};
+export default DateInfo;

package/lib/types/DateInfo.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=DateInfo.js.map

package/lib/types/DateInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateInfo.js","sourceRoot":"","sources":["../../src/types/DateInfo.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dce-commonkit",
-  "version": "5.0.1",
+  "version": "5.0.3",
   "description": "Common helpers, constants, and other resources that are shared between dce-reactkit and dce-expresskit",
   "keywords": [
     "DCE",

package/src/helpers/convertDateKeyToDateInfo.ts

@@ -0,0 +1,29 @@
+// import types
+import DateInfo from '../types/DateInfo';
+
+/**
+ * Convert dateKey in MM/DD/YYYY format to DateInfo object
+ * @author Gardenia Liu
+ * @param dateKey - Date string in MM/DD/YYYY format (e.g., "7/19/2025")
+ * @returns DateInfo object or null if parsing fails
+ */
+const convertDateKeyToDateInfo = (dateKey: string): DateInfo | null => {
+  const [monthStr, dayStr, yearStr] = dateKey.split('/');
+
+  const month = Number.parseInt(monthStr, 10);
+  const day = Number.parseInt(dayStr, 10);
+  const year = Number.parseInt(yearStr, 10);
+
+  // Return DateInfo if parsing was successful (no NaN values)
+  if (!Number.isNaN(year) && !Number.isNaN(month) && !Number.isNaN(day)) {
+    return {
+      year,
+      month,
+      day,
+    };
+  }
+
+  return null;
+};
+
+export default convertDateKeyToDateInfo;

package/src/helpers/getMondayOfWeek.ts

@@ -0,0 +1,41 @@
+import getTimeInfoInET from './getTimeInfoInET';
+
+/**
+ * Get the start of the week (Monday) in string form given a specific timestamp.
+ * The format is MM/DD/YYYY.
+ * @author Allison Zhang
+ * @param timestamp the timestamp of a date within a week
+ * @returns string with format 'MM/DD/YYYY' of the Monday that starts the week
+ * that contains the timestamp
+ */
+const getMondayOfTimestamp = (timestamp: number): string => {
+  // Get the date in ET!
+  const {
+    month,
+    day,
+    year,
+  } = getTimeInfoInET(timestamp);
+  const date = new Date(`${month}/${day}/${year}`);
+
+  const dayOfTheWeek = date.getDay();
+  // Get the offset to the previous Monday
+
+  // If the day of the week is Sunda, we want the offset to be the Monday of
+  // the previous week
+  let daysPastPrevMonday = 0;
+  if (dayOfTheWeek === 0) {
+    // Handle Sunday separately: Sunday is 6 days past Monday
+    daysPastPrevMonday = 6;
+  } else if (dayOfTheWeek > 1) {
+    // Tuesday - Saturday: just subtract 1 from the day of the week
+    // (dayOfTheWeek: 1 = Monday, 2 = Tuesday)
+    daysPastPrevMonday = dayOfTheWeek - 1;
+  }
+
+  const dayOfTheMonth = date.getDate();
+  // Get the day of the month of the previous Monday
+  date.setDate(dayOfTheMonth - daysPastPrevMonday);
+  return `${date.getMonth() + 1}/${date.getDate()}/${date.getFullYear()}`;
+};
+
+export default getMondayOfTimestamp;

package/src/index.ts

@@ -30,6 +30,7 @@ import getPartOfDay from './helpers/getPartOfDay';
 import stringsToHumanReadableList from './helpers/stringsToHumanReadableList';
 import onlyKeepLetters from './helpers/onlyKeepLetters';
 import parallelLimit from './helpers/parallelLimit';
+import getMondayOfTimestamp from './helpers/getMondayOfWeek';
 import getMonthName from './helpers/getMonthName';
 import genCSV from './helpers/genCSV';
 import extractProp from './helpers/extractProp';
@@ -52,6 +53,7 @@ import getWordCount from './helpers/getWordCount';
 import cloneDeep from './helpers/cloneDeep';
 import getTimestampFromTimeInfoInET from './helpers/getTimestampFromTimeInfoInET';
 import spaceAtCapitals from './helpers/spaceAtCapitals';
+import convertDateKeyToDateInfo from './helpers/convertDateKeyToDateInfo';
 
 // Import types
 import ParamType from './types/ParamType';
@@ -126,12 +128,14 @@ export {
   waitMs,
   getOrdinal,
   getTimeInfoInET,
+  convertDateKeyToDateInfo,
   startMinWait,
   getHumanReadableDate,
   getPartOfDay,
   stringsToHumanReadableList,
   onlyKeepLetters,
   parallelLimit,
+  getMondayOfTimestamp,
   getMonthName,
   genCSV,
   extractProp,

package/src/types/DateInfo.ts

@@ -0,0 +1,14 @@
+/**
+ * Bundle of all date information for an attendance record
+ * @author Gabe Abrams
+ */
+type DateInfo = {
+  // Year
+  year: number,
+  // Month
+  month: number,
+  // Day of month
+  day: number,
+};
+
+export default DateInfo;