@docaohuynh/ielts-api-utils 1.0.9 → 1.0.11

package/dist/src/utils/date/date-compare.util.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Compares two date strings in ISO format or null values
+ * @param date1 - First date string in ISO format or null
+ * @param date2 - Second date string in ISO format or null
+ * @returns -1 if date1 is earlier than date2, 0 if equal, 1 if date1 is later than date2
+ *          If either date is null, treats it as earlier than any valid date
+ */
+export declare function compareDates(date1: string | null, date2: string | null): number;
+/**
+ * Checks if date1 is earlier than date2
+ * @param date1 - First date string in ISO format or null
+ * @param date2 - Second date string in ISO format or null
+ * @returns true if date1 is earlier than date2, false otherwise
+ */
+export declare function isBefore(date1: string | null, date2: string | null): boolean;
+/**
+ * Checks if date1 is later than date2
+ * @param date1 - First date string in ISO format or null
+ * @param date2 - Second date string in ISO format or null
+ * @returns true if date1 is later than date2, false otherwise
+ */
+export declare function isAfter(date1: string | null, date2: string | null): boolean;
+/**
+ * Checks if two dates are equal
+ * @param date1 - First date string in ISO format or null
+ * @param date2 - Second date string in ISO format or null
+ * @returns true if dates are equal, false otherwise
+ */
+export declare function isEqual(date1: string | null, date2: string | null): boolean;

package/dist/src/utils/date/index.d.ts

@@ -0,0 +1,2 @@
+export * from './date-compare.util';
+export * from './year-range.util';

package/dist/src/utils/date/year-range.util.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Gets the start of the year (first millisecond of January 1st) for a given date.
+ * If no date is provided, uses the current date.
+ * @param dateOrTimestamp - A Date object, timestamp, or ISO string representing the date. If null/undefined, uses current date.
+ * @returns A Date object representing the start of the year
+ */
+export declare function getStartOfYear(dateOrTimestamp?: Date | number | string | null): Date;
+/**
+ * Gets the end of the year (last millisecond of December 31st) for a given date.
+ * If no date is provided, uses the current date.
+ * @param dateOrTimestamp - A Date object, timestamp, or ISO string representing the date. If null/undefined, uses current date.
+ * @returns A Date object representing the end of the year
+ */
+export declare function getEndOfYear(dateOrTimestamp?: Date | number | string | null): Date;

package/dist/src/utils/index.d.ts

@@ -6,3 +6,4 @@ export * from './list';
 export * from './time';
 export * from './request';
 export * from './slug';
+export * from './date';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docaohuynh/ielts-api-utils",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Utilities for IELTS API",
   "module": "index.ts",
   "main": "dist/index.js",
@@ -13,15 +13,15 @@
   "devDependencies": {
     "@types/bun": "latest",
     "mockdate": "^3.0.5",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.18"
   },
   "peerDependencies": {
     "typescript": "^5.9.2"
   },
   "dependencies": {
-    "@sindresorhus/slugify": "^2.2.1",
+    "@sindresorhus/slugify": "^3.0.0",
     "@types/luxon": "^3.7.1",
-    "luxon": "^3.7.1",
-    "transliteration": "^2.3.5"
+    "luxon": "^3.7.2",
+    "transliteration": "^2.6.1"
   }
 }