coffee-time 1.2.0-beta.1 → 1.2.0-beta.3

package/README.md

@@ -34,13 +34,22 @@ Start a continuous break loop with a required interval (minutes):
 coffee-time start --interval 45
 ```
 
+Add a lightweight countdown ping every minute:
+
+```bash
+coffee-time start --interval 45 --status
+```
+
 ---
 
 ## What happens
 
 * Prints a single startup line:
   `Coffee breaks scheduled every 45 minutes. Press Ctrl+C to stop.`
+* Optional status flag (`--status`) prints a countdown update every minute:
+  `⏳ Next break in 44:00`
 * Waits 45 minutes, then triggers a break notification.
+* After each break, countdown updates continue when `--status` is enabled.
 * Immediately schedules the next interval and repeats until you stop it (`Ctrl+C`).
 
 ---

package/bin/coffee-time.js

@@ -24,11 +24,14 @@ function parseArgs(argv) {
   }
 
   let intervalMinutes;
+  let showStatus = false;
   for (let i = 0; i < rest.length; i += 1) {
     const token = rest[i];
     if (token === '--interval') {
       intervalMinutes = rest[i + 1];
       i += 1;
+    } else if (token === '--status') {
+      showStatus = true;
     } else {
       console.error(`Unknown option: ${token}`);
       printUsage();
@@ -48,7 +51,7 @@ function parseArgs(argv) {
     process.exit(USAGE_ERROR);
   }
 
-  return parsedInterval;
+  return { intervalMinutes: parsedInterval, showStatus };
 }
 
 function sendDesktopNotification(message) {
@@ -86,35 +89,99 @@ function attemptNotification(command, args) {
   });
 }
 
-function notify(intervalMinutes) {
+function notify(intervalMinutes, logLine = console.log) {
   const message = `Time for a coffee break! (${intervalMinutes} min interval)`;
-  console.log(`☕ ${message}`);
+  logLine(`☕ ${message}`);
   sendDesktopNotification(message).catch(() => {});
 }
 
-function startLoop(intervalMinutes) {
+function formatRemaining(remainingMs) {
+  const totalSeconds = Math.max(0, Math.ceil(remainingMs / 1000));
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  return `${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`;
+}
+
+function printCoffeeArt() {
+  const artLines = [
+    '   ( (',
+    '    ) )',
+    '  ........',
+    '  |      |]',
+    '  \\      /',
+    "   '----'",
+  ];
+  console.log(artLines.join('\n'));
+}
+
+function startLoop(intervalMinutes, options = {}) {
+  const { showStatus = false } = options;
+  let statusLength = 0;
+  let statusActive = false;
+
+  const logLine = (message) => {
+    if (statusActive) {
+      process.stdout.write('\n');
+      statusActive = false;
+      statusLength = 0;
+    }
+    console.log(message);
+  };
+
   console.log(`Coffee breaks scheduled every ${intervalMinutes} minutes. Press Ctrl+C to stop.`);
+  printCoffeeArt();
 
+  const startedAt = Date.now();
   const intervalMs = intervalMinutes * 60 * 1000;
-  let nextTime = Date.now() + intervalMs;
+  let nextTime = startedAt + intervalMs;
   let timeoutId = null;
+  let statusIntervalId = null;
+  let statusTimeoutId = null;
+
+  const logStatus = () => {
+    const remaining = nextTime - Date.now();
+    const message = `⏳ Next break in ${formatRemaining(remaining)}`;
+    const paddedMessage = message.padEnd(statusLength, ' ');
+    process.stdout.write(`\r${paddedMessage}`);
+    statusLength = message.length;
+    statusActive = true;
+  };
 
   function scheduleNext() {
     const delay = Math.max(0, nextTime - Date.now());
     timeoutId = setTimeout(() => {
-      notify(intervalMinutes);
+      notify(intervalMinutes, logLine);
       nextTime += intervalMs;
+      if (showStatus) {
+        logStatus();
+      }
       scheduleNext();
     }, delay);
   }
 
   scheduleNext();
 
+  if (showStatus) {
+    const elapsed = Date.now() - startedAt;
+    const firstDelay = Math.max(0, 60 * 1000 - (elapsed % (60 * 1000)));
+
+    statusTimeoutId = setTimeout(() => {
+      logStatus();
+      statusIntervalId = setInterval(logStatus, 60 * 1000);
+    }, firstDelay);
+  }
+
   const handleExit = () => {
     if (timeoutId) {
       clearTimeout(timeoutId);
     }
-    console.log('\nStopped. Stay fresh ☕');
+    if (statusTimeoutId) {
+      clearTimeout(statusTimeoutId);
+    }
+    if (statusIntervalId) {
+      clearInterval(statusIntervalId);
+    }
+    logLine('\nStopped. Stay fresh ☕');
     process.exit(0);
   };
 
@@ -124,8 +191,8 @@ function startLoop(intervalMinutes) {
 
 function main() {
   try {
-    const intervalMinutes = parseArgs(process.argv);
-    startLoop(intervalMinutes);
+    const { intervalMinutes, showStatus } = parseArgs(process.argv);
+    startLoop(intervalMinutes, { showStatus });
   } catch (error) {
     console.error('Unexpected error:', error.message);
     process.exit(1);

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.2.0-beta.1",
+  "version": "1.2.0-beta.3",
   "description": "Lightweight CLI to schedule coffee breaks at a fixed interval.",
   "bin": {
     "coffee-time": "./bin/coffee-time.js"
@@ -12,6 +12,10 @@
   "type": "commonjs",
   "scripts": {
     "start": "node ./bin/coffee-time.js"
+  },
+   "repository": {
+    "type": "git",
+    "url": "https://github.com/tborges/coffee-time"
   },
    "keywords": [
     "Coffee Time",