coffee-time 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Troy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,42 @@
+# coffee-time
+
+A lightweight CLI that schedules recurring coffee breaks while you code.
+
+## Why
+Long uninterrupted work sessions hurt focus. `coffee-time` keeps a reliable, low-noise loop that nudges you to step away at predictable intervals.
+
+## Install
+```
+npm install -g .
+```
+
+## Usage
+Start a continuous break loop with a required interval (minutes):
+```
+coffee-time start --interval 45
+```
+
+### What happens
+- Prints a single startup line: `Coffee breaks scheduled every 45 minutes. Press Ctrl+C to stop.`
+- Waits 45 minutes, then triggers a break notification.
+- Immediately schedules the next interval and repeats until you stop it (Ctrl+C).
+
+### Interval rules
+- Integer minutes only, must be >= 1.
+- Invalid values print a clear error to stderr and exit with code `2`.
+
+### Notifications
+- Always prints a console message on each break: `☕ Time for a coffee break! (45 min interval)`.
+- Attempts a desktop notification where available:
+  - macOS: `osascript -e 'display notification ...'`
+  - Linux: `notify-send` (if installed)
+  - Windows: toast via PowerShell (best-effort)
+- Missing notification tools never crash the app; console output is the fallback.
+
+### Stopping
+Press `Ctrl+C` to stop cleanly. Exits with code `0` and prints `Stopped. Stay fresh ☕`.
+
+### Exit codes
+- `0` — normal exit (including Ctrl+C)
+- `2` — usage/argument error
+- `>0` — unexpected runtime error

package/bin/coffee-time.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+
+const USAGE_ERROR = 2;
+
+function printUsage() {
+  console.error('Usage: coffee-time start --interval <minutes>');
+}
+
+function parseArgs(argv) {
+  const args = argv.slice(2);
+
+  if (args.length === 0) {
+    printUsage();
+    process.exit(USAGE_ERROR);
+  }
+
+  const [command, ...rest] = args;
+  if (command !== 'start') {
+    console.error(`Unknown command: ${command}`);
+    printUsage();
+    process.exit(USAGE_ERROR);
+  }
+
+  let intervalMinutes;
+  for (let i = 0; i < rest.length; i += 1) {
+    const token = rest[i];
+    if (token === '--interval') {
+      intervalMinutes = rest[i + 1];
+      i += 1;
+    } else {
+      console.error(`Unknown option: ${token}`);
+      printUsage();
+      process.exit(USAGE_ERROR);
+    }
+  }
+
+  if (intervalMinutes === undefined) {
+    console.error('Missing required option: --interval <minutes>');
+    printUsage();
+    process.exit(USAGE_ERROR);
+  }
+
+  const parsedInterval = Number(intervalMinutes);
+  if (!Number.isInteger(parsedInterval) || parsedInterval < 1) {
+    console.error('Invalid interval. Provide an integer value >= 1 minute.');
+    process.exit(USAGE_ERROR);
+  }
+
+  return parsedInterval;
+}
+
+function sendDesktopNotification(message) {
+  const platform = process.platform;
+
+  if (platform === 'darwin') {
+    return attemptNotification('osascript', [
+      '-e',
+      `display notification "${message}" with title "coffee-time"`,
+    ]);
+  }
+
+  if (platform === 'linux') {
+    return attemptNotification('notify-send', ['coffee-time', message]);
+  }
+
+  if (platform === 'win32') {
+    const script = `Add-Type -AssemblyName System.Windows.Forms;` +
+      `$notify = New-Object System.Windows.Forms.NotifyIcon;` +
+      `$notify.Icon = [System.Drawing.SystemIcons]::Information;` +
+      `$notify.Visible = $true;` +
+      `$notify.ShowBalloonTip(10000, 'coffee-time', '${message}', [System.Windows.Forms.ToolTipIcon]::Info);`;
+    return attemptNotification('powershell.exe', ['-NoProfile', '-Command', script]);
+  }
+
+  return Promise.resolve();
+}
+
+function attemptNotification(command, args) {
+  return new Promise((resolve) => {
+    const child = spawn(command, args, { stdio: 'ignore' });
+
+    child.on('error', () => resolve());
+    child.on('exit', () => resolve());
+  });
+}
+
+function notify(intervalMinutes) {
+  const message = `Time for a coffee break! (${intervalMinutes} min interval)`;
+  console.log(`☕ ${message}`);
+  sendDesktopNotification(message).catch(() => {});
+}
+
+function startLoop(intervalMinutes) {
+  console.log(`Coffee breaks scheduled every ${intervalMinutes} minutes. Press Ctrl+C to stop.`);
+
+  const intervalMs = intervalMinutes * 60 * 1000;
+  let nextTime = Date.now() + intervalMs;
+  let timeoutId = null;
+
+  function scheduleNext() {
+    const delay = Math.max(0, nextTime - Date.now());
+    timeoutId = setTimeout(() => {
+      notify(intervalMinutes);
+      nextTime += intervalMs;
+      scheduleNext();
+    }, delay);
+  }
+
+  scheduleNext();
+
+  const handleExit = () => {
+    if (timeoutId) {
+      clearTimeout(timeoutId);
+    }
+    console.log('\nStopped. Stay fresh ☕');
+    process.exit(0);
+  };
+
+  process.on('SIGINT', handleExit);
+  process.on('SIGTERM', handleExit);
+}
+
+function main() {
+  try {
+    const intervalMinutes = parseArgs(process.argv);
+    startLoop(intervalMinutes);
+  } catch (error) {
+    console.error('Unexpected error:', error.message);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "coffee-time",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "1.0.0",
+  "description": "Lightweight CLI to schedule coffee breaks at a fixed interval.",
+  "bin": {
+    "coffee-time": "./bin/coffee-time.js"
+  },
+  "license": "MIT",
+  "type": "commonjs",
+  "scripts": {
+    "start": "node ./bin/coffee-time.js"
+  }
+}