clockey 0.1.0 → 1.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clockey",
-  "version": "0.1.0",
+  "version": "1.0.0",
   "description": "API-first time utilities for backend developers",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/core/date.ts

@@ -1,33 +1,34 @@
+const DAY_NAMES = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday",
+];
+
+const MONTH_NAMES = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December",
+];
+
 export function formatCurrentDate() {
   const currentDate = new Date();
-  const dayAsString = [
-    "Sunday",
-    "Monday",
-    "Tuesday",
-    "Wednesday",
-    "Thursday",
-    "Friday",
-    "Saturday",
-  ];
-
-  const monthAsString = [
-    "January",
-    "February",
-    "March",
-    "April",
-    "May",
-    "June",
-    "July",
-    "August",
-    "September",
-    "October",
-    "November",
-    "December",
-  ];
 
   const yr = currentDate.getFullYear();
-  const month = monthAsString[currentDate.getMonth()];
-  const day = dayAsString[currentDate.getDay()];
+  const month = MONTH_NAMES[currentDate.getMonth()];
+  const day = DAY_NAMES[currentDate.getDay()];
   const date = currentDate.getDate();
   const ordinal =
     date === 1 ? "st" : date === 2 ? "nd" : date === 3 ? "rd" : "th";
@@ -38,3 +39,53 @@ export function formatCurrentDate() {
     date: { yr, month, day, date, ordinal, fullDate },
   };
 }
+
+export function currentYear() {
+  return new Date().getFullYear();
+}
+
+export function currentMonth() {
+  const now = new Date();
+  const idx = now.getMonth();
+  const monthNumber = idx + 1;
+  return {
+    monthNumber,
+    monthName: MONTH_NAMES[idx],
+    monthStr: monthNumber.toString().padStart(2, "0"),
+  };
+}
+
+export function currentDay() {
+  const now = new Date();
+  const idx = now.getDay();
+  return {
+    dayIndex: idx,
+    dayName: DAY_NAMES[idx],
+  };
+}
+
+export function currentDateNumber() {
+  const d = new Date().getDate();
+  return {
+    date: d,
+    dateStr: d.toString().padStart(2, "0"),
+  };
+}
+
+export function currentOrdinal() {
+  const d = new Date().getDate();
+  const ordinal = d === 1 ? "st" : d === 2 ? "nd" : d === 3 ? "rd" : "th";
+  return { ordinal };
+}
+
+export function currentFullDate() {
+  const now = new Date();
+  const yr = now.getFullYear();
+  const month = MONTH_NAMES[now.getMonth()];
+  const day = DAY_NAMES[now.getDay()];
+  const date = now.getDate();
+  const ordinal =
+    date === 1 ? "st" : date === 2 ? "nd" : date === 3 ? "rd" : "th";
+  const fullDate = `${month} ${date}${ordinal}, ${day}, ${yr}`;
+  return { fullDate };
+}

package/src/core/time.ts

@@ -1,28 +1,80 @@
+const pad = (n: number) => n.toString().padStart(2, "0");
+
 export function formatCurrentTime() {
-  const currentTime = new Date();
+  const now = new Date();
 
-  let hrs24 = currentTime.getHours();
-  const min = currentTime.getMinutes();
-  const sec = currentTime.getSeconds();
+  const hr24 = now.getHours();
+  const min = now.getMinutes();
+  const sec = now.getSeconds();
 
-  const period = hrs24 >= 12 ? "PM" : "AM";
-  let hrs12 = hrs24 % 12;
-  if (hrs12 === 0) hrs12 = 12;
+  const period = hr24 >= 12 ? "PM" : "AM";
+  const hr12 = hr24 % 12 || 12;
 
-  const pad = (n: number) => n.toString().padStart(2, "0");
+  return {
+    hr24,
+    hr12,
+    min,
+    sec,
+    period,
+    hr24Str: pad(hr24),
+    hr12Str: pad(hr12),
+    minStr: pad(min),
+    secStr: pad(sec),
+    timeAsString24: `${pad(hr24)}:${pad(min)}:${pad(sec)}`,
+    timeAsString12: `${pad(hr12)}:${pad(min)}:${pad(sec)} ${period}`,
+  };
+}
+
+export function currentHour() {
+  const currentTime = new Date();
+  const hr24 = currentTime.getHours();
+  const hr12 = hr24 % 12 || 12;
 
-  const timeAsString24 = `${pad(hrs24)}:${pad(min)}:${pad(sec)}`;
-  const timeAsString12 = `${pad(hrs12)}:${pad(min)}:${pad(sec)} ${period}`;
+  return {
+    hour24: hr24,
+    hour12: hr12,
+    hour24Str: pad(hr24),
+    hour12Str: pad(hr12),
+  };
+}
+
+export function currentMinute() {
+  const currentTime = new Date();
+  const minute = currentTime.getMinutes();
+  return {
+    minute,
+    minuteStr: pad(minute),
+  };
+}
 
+export function currentSecond() {
+  const currentTime = new Date();
+  const second = currentTime.getSeconds();
   return {
-    time: {
-      hrs24,
-      hrs12,
-      min,
-      sec,
-      period,
-      timeAsString24,
-      timeAsString12,
-    },
+    second,
+    secondStr: pad(second),
   };
 }
+
+// String Based Responses
+export function currentHour24Str() {
+  return currentHour().hour24Str;
+}
+
+export function currentHour12Str() {
+  return currentHour().hour12Str;
+}
+
+export function currentMinuteStr() {
+  return currentMinute().minuteStr;
+}
+
+export function currentSecondStr() {
+  return currentSecond().secondStr;
+}
+
+export function currentPeriod() {
+  const hr24 = new Date().getHours();
+  const period = hr24 >= 12 ? "PM" : "AM";
+  return { period };
+}

package/src/response/dateResponse.ts

@@ -1,4 +1,12 @@
-import { formatCurrentDate } from "../core/date";
+import {
+  formatCurrentDate,
+  currentYear,
+  currentMonth,
+  currentDay,
+  currentDateNumber,
+  currentOrdinal,
+  currentFullDate,
+} from "../core/date";
 import { ClockeyDateResponse } from "../types/date";
 
 export function getCurrentDate() {
@@ -11,3 +19,87 @@ export function getCurrentDate() {
   };
   return response;
 }
+
+export function getCurrentYear() {
+  return currentYear();
+}
+
+export function getCurrentYearResponse() {
+  const value = currentYear();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current year fetched successfully",
+    value,
+  };
+}
+
+export function getCurrentMonth() {
+  return currentMonth();
+}
+
+export function getCurrentMonthResponse() {
+  const value = currentMonth();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current month fetched successfully",
+    value,
+  };
+}
+
+export function getCurrentDay() {
+  return currentDay();
+}
+
+export function getCurrentDayResponse() {
+  const value = currentDay();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current day fetched successfully",
+    value,
+  };
+}
+
+export function getCurrentDateNumber() {
+  return currentDateNumber();
+}
+
+export function getCurrentDateNumberResponse() {
+  const value = currentDateNumber();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current date number fetched successfully",
+    value,
+  };
+}
+
+export function getCurrentOrdinal() {
+  return currentOrdinal();
+}
+
+export function getCurrentOrdinalResponse() {
+  const value = currentOrdinal();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current ordinal fetched successfully",
+    value,
+  };
+}
+
+export function getCurrentFullDate() {
+  return currentFullDate();
+}
+
+export function getCurrentFullDateResponse() {
+  const value = currentFullDate();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current full date fetched successfully",
+    value,
+  };
+}

package/src/response/timeResponse.ts

@@ -1,8 +1,24 @@
-import { formatCurrentTime } from "../core/time";
+import {
+  currentHour,
+  formatCurrentTime,
+  currentMinute,
+  currentSecond,
+  currentHour24Str,
+  currentHour12Str,
+  currentMinuteStr,
+  currentSecondStr,
+  currentPeriod,
+} from "../core/time";
 import { ClockeyTimeResponse } from "../types/time";
 
 export function getCurrentTime() {
-  const { time } = formatCurrentTime();
+  const { timeAsString24, timeAsString12 } = formatCurrentTime();
+
+  return { timeAsString12, timeAsString24 };
+}
+
+export function getCurrentTimeResponse() {
+  const time = formatCurrentTime();
   const response: ClockeyTimeResponse = {
     success: true,
     code: 200,
@@ -11,3 +27,117 @@ export function getCurrentTime() {
   };
   return response;
 }
+
+export function getCurrentHr() {
+  return currentHour();
+}
+
+export function getCurrenHrResponse() {
+  const hour = currentHour();
+  const response = {
+    success: true,
+    code: 200,
+    msg: "Current hour fetched successfully",
+    hour,
+  };
+  return response;
+}
+
+export function getCurrentMinute() {
+  return currentMinute();
+}
+
+export function getCurrentMinuteResponse() {
+  const minute = currentMinute();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current minute fetched successfully",
+    minute,
+  };
+}
+
+export function getCurrentSecond() {
+  return currentSecond();
+}
+
+export function getCurrentSecondResponse() {
+  const second = currentSecond();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current second fetched successfully",
+    second,
+  };
+}
+
+// String data type responses
+export function getCurrentHour24Str() {
+  return currentHour24Str();
+}
+
+export function getCurrentHour24StrResponse() {
+  const value = currentHour24Str();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current hour24 string fetched",
+    value,
+  };
+}
+
+export function getCurrentHour12Str() {
+  return currentHour12Str();
+}
+
+export function getCurrentHour12StrResponse() {
+  const value = currentHour12Str();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current hour12 string fetched",
+    value,
+  };
+}
+
+export function getCurrentMinuteStr() {
+  return currentMinuteStr();
+}
+
+export function getCurrentMinuteStrResponse() {
+  const value = currentMinuteStr();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current minute string fetched",
+    value,
+  };
+}
+
+export function getCurrentSecondStr() {
+  return currentSecondStr();
+}
+
+export function getCurrentSecondStrResponse() {
+  const value = currentSecondStr();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current second string fetched",
+    value,
+  };
+}
+
+export function getCurrentPeriod() {
+  return currentPeriod();
+}
+
+export function getCurrentPeriodResponse() {
+  const period = currentPeriod();
+  return {
+    success: true,
+    code: 200,
+    msg: "Current period fetched successfully",
+    period,
+  };
+}

package/src/types/time.d.ts

@@ -1,6 +1,6 @@
 export interface TimeData {
-  hrs24: number;
-  hrs12: number;
+  hr24: number;
+  hr12: number;
   min: number;
   sec: number;
   period: "AM" | "PM" | string;