git-push-time 1.1.3 → 1.1.4

package/lib/utils.js

@@ -4,7 +4,7 @@ import customParseFormat from 'dayjs/plugin/customParseFormat.js';
 dayjs.extend(customParseFormat);
 
 /**
- * Kiểm tra xem URL git có hợp lệ hay không (HTTP/HTTPS, SSH, hoặc `.git`)
+ * Check whether a Git URL is valid (HTTP/HTTPS, SSH, or `.git`).
  * @param {string} url 
  * @returns {boolean}
  */
@@ -17,12 +17,12 @@ export function isValidGitUrl(url) {
 }
 
 /**
- * Parse chuỗi thời gian thành định dạng ISO/Git hợp lệ.
- * Hỗ trợ các định dạng:
- * - "now" hoặc để trống -> Thời gian hiện tại
- * - Relative (phân biệt hoa/thường cho đơn vị 1 ký tự):
+ * Parse a date string into a valid ISO/Git timestamp.
+ * Supported formats:
+ * - "now" or blank -> current time
+ * - Relative times (single-character units are case-sensitive):
  *   s=second, m=minute, h=hour, d=day, w=week, M=month, y=year
- *   VD: "-2d", "-5h", "-30m" (phút), "-1w", "-3M"/"-3mo"/"-3month" (tháng), "-1y"
+ *   e.g. "-2d", "-5h", "-30m" (minutes), "-1w", "-3M"/"-3mo"/"-3month" (months), "-1y"
  * - Absolute: "YYYY-MM-DD HH:mm:ss", "YYYY-MM-DD HH:mm", "YYYY-MM-DD"
  *
  * @param {string} dateStr
@@ -40,15 +40,15 @@ export function parseCustomDate(dateStr) {
 
   const str = dateStr.trim();
 
-  // Kiểm tra relative time: ví dụ -2d, -5h, -30m, -1w, -3M/-3mo, -1y hoặc 2d, 5h
-  // Lưu ý: đơn vị 1 ký tự phân biệt hoa/thường (m = minute, M = month).
+  // Check relative time: e.g. -2d, -5h, -30m, -1w, -3M/-3mo, -1y, or 2d, 5h.
+  // Single-character units are case-sensitive (m = minute, M = month).
   const relativeMatch = str.match(/^([+-]?\d+)\s*(\S+)$/);
   if (relativeMatch) {
     let amount = parseInt(relativeMatch[1], 10);
     const unitRaw = relativeMatch[2];
     const unitLower = unitRaw.toLowerCase();
 
-    // Map unit: ưu tiên so khớp từ dài trước, đơn vị 1 ký tự giữ case-sensitive
+    // Match longer units first; preserve case for single-character units.
     let unit = null;
     if (['sec', 'secs', 'second', 'seconds'].includes(unitLower)) unit = 'second';
     else if (['min', 'mins', 'minute', 'minutes'].includes(unitLower)) unit = 'minute';
@@ -66,14 +66,14 @@ export function parseCustomDate(dateStr) {
     else if (unitRaw === 'y' || unitRaw === 'Y') unit = 'year';
 
     if (unit) {
-      // Nếu người dùng nhập "2d" mà không có dấu "-", mặc định hiểu là "lùi 2d" (-2d)
+      // Without a leading + or -, interpret "2d" as "2 days ago" (-2d).
       if (amount > 0 && !str.startsWith('+')) {
         amount = -amount;
       }
 
       const calculated = dayjs().add(amount, unit);
       if (!calculated.isValid()) {
-        return { valid: false, formatted: '', display: '', error: `Không thể tính toán thời gian từ '${dateStr}'` };
+        return { valid: false, formatted: '', display: '', error: `Could not calculate a date from '${dateStr}'` };
       }
 
       return {
@@ -82,10 +82,10 @@ export function parseCustomDate(dateStr) {
         display: calculated.format('YYYY-MM-DD HH:mm:ss Z')
       };
     }
-    // Rơi xuống parse absolute nếu unit không khớp (vd user gõ nhầm sẽ báo lỗi ở dưới)
+    // Fall through to absolute date parsing if the unit is unknown.
   }
 
-  // Thủ định dạng ngày giờ tuyệt đối
+  // Try absolute date and time formats.
   const formats = [
     'YYYY-MM-DD HH:mm:ss',
     'YYYY-MM-DD HH:mm',
@@ -100,7 +100,7 @@ export function parseCustomDate(dateStr) {
 
   let parsed = dayjs(str, formats, true);
   if (!parsed.isValid()) {
-    parsed = dayjs(str); // Thử parse chuẩn ISO
+    parsed = dayjs(str); // Try standard ISO parsing.
   }
 
   if (parsed.isValid()) {
@@ -115,6 +115,6 @@ export function parseCustomDate(dateStr) {
     valid: false,
     formatted: '',
     display: '',
-    error: `Định dạng ngày giờ không hợp lệ: '${dateStr}'. Ví dụ đúng: "2024-01-15 14:30:00", "-2d", "-5h", "now"`
+    error: `Invalid date or time: '${dateStr}'. Examples: "2024-01-15 14:30:00", "-2d", "-5h", "now"`
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "git-push-time",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "CLI tool to push project to Git with custom repo URL and custom commit timestamp",
   "main": "bin/index.js",
   "type": "module",