@bobfrankston/gcal 0.1.11 → 0.1.13

package/gcal.ts

@@ -90,14 +90,17 @@ async function listEvents(
     accessToken: string,
     calendarId = 'primary',
     maxResults = 10,
-    timeMin?: string
+    timeMin?: string,
+    timeMax?: string
 ): Promise<GoogleEvent[]> {
     const params = new URLSearchParams({
         maxResults: maxResults.toString(),
         singleEvents: 'true',
-        orderBy: 'startTime',
-        timeMin: timeMin || new Date().toISOString()
+        orderBy: 'startTime'
     });
+    if (timeMin) params.set('timeMin', timeMin);
+    if (timeMax) params.set('timeMax', timeMax);
+    if (!timeMin && !timeMax) params.set('timeMin', new Date().toISOString());
 
     const url = `${CALENDAR_API_BASE}/calendars/${encodeURIComponent(calendarId)}/events?${params}`;
     const res = await apiFetch(url, accessToken);
@@ -228,6 +231,7 @@ Usage:
 
 Commands:
   list [n]                           List upcoming n events (default: 10)
+  past [n]                           List past n events (default: 10)
   add <title> <when> [duration]      Add event
   del|delete <id> [id2...]           Delete event(s) by ID (prefix match)
   import <file.ics>                  Import events from ICS file
@@ -239,6 +243,7 @@ Options:
   -defaultUser <email>     Set default user for future use
   -c, -calendar <id>       Calendar ID (default: primary)
   -n <count>               Number of events to list
+  -r, -reminder <time>     Reminder before event (10, 30m, 1h, 1d)
   -v, -verbose             Show event IDs and links
 
 Examples:
@@ -247,7 +252,7 @@ Examples:
   gcal add "Dentist" "Friday 3pm" "1h"
   gcal add "Lunch" "1/14/2026 12:00" "1h"
   gcal add "Meeting" "tomorrow 10:00"
-  gcal add "Appointment" "jan 15 2pm"
+  gcal add "Appointment" "jan 15 2pm" -r 1h
   gcal -defaultUser bob@gmail.com         Set default user
 
 File Association (Windows):
@@ -266,6 +271,20 @@ interface ParsedArgs {
     help: boolean;
     verbose: boolean;
     icsFile: string;  /** Direct .ics file path */
+    reminder: number; /** Reminder in minutes, -1 = not set */
+}
+
+/** Parse reminder string: number (minutes), or suffix m/h/d */
+function parseReminder(val: string): number {
+    const match = val.match(/^(\d+)(m|h|d)?$/i);
+    if (!match) return -1;
+    const num = parseInt(match[1]);
+    const unit = (match[2] || 'm').toLowerCase();
+    switch (unit) {
+        case 'h': return num * 60;
+        case 'd': return num * 60 * 24;
+        default: return num;
+    }
 }
 
 function parseArgs(argv: string[]): ParsedArgs {
@@ -278,7 +297,8 @@ function parseArgs(argv: string[]): ParsedArgs {
         count: 10,
         help: false,
         verbose: false,
-        icsFile: ''
+        icsFile: '',
+        reminder: -1
     };
 
     const unknown: string[] = [];
@@ -308,6 +328,11 @@ function parseArgs(argv: string[]): ParsedArgs {
             case '--verbose':
                 result.verbose = true;
                 break;
+            case '-r':
+            case '-reminder':
+            case '--reminder':
+                result.reminder = parseReminder(argv[++i] || '');
+                break;
             case '-h':
             case '-help':
             case '--help':
@@ -472,6 +497,57 @@ async function main(): Promise<void> {
             break;
         }
 
+        case 'past': {
+            const count = parsed.args[0] ? parseInt(parsed.args[0]) : parsed.count;
+            const token = await getAccessToken(user, false);
+            // Get events before now, then reverse to show most recent first
+            const now = new Date();
+            const thirtyDaysAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+            const events = await listEvents(token, parsed.calendar, count, thirtyDaysAgo.toISOString(), now.toISOString());
+            events.reverse();  // Most recent first
+
+            if (events.length === 0) {
+                console.log('No past events found in last 30 days.');
+            } else {
+                console.log(`\nPast events (${events.length}):\n`);
+
+                // Build table data (same format as list)
+                const rows: string[][] = [];
+                for (const event of events) {
+                    const shortId = (event.id || '').slice(0, 8);
+                    const start = event.start ? formatDateTime(event.start) : '?';
+                    const duration = (event.start && event.end) ? formatDuration(event.start, event.end) : '';
+                    const summary = event.summary || '(no title)';
+                    const loc = event.location || '';
+                    if (parsed.verbose) {
+                        rows.push([shortId, start, duration, summary, loc, event.htmlLink || '']);
+                    } else {
+                        rows.push([shortId, start, duration, summary, loc]);
+                    }
+                }
+
+                // Calculate column widths
+                const headers = parsed.verbose
+                    ? ['ID', 'When', 'Dur', 'Event', 'Location', 'Link']
+                    : ['ID', 'When', 'Dur', 'Event', 'Location'];
+                const colWidths = headers.map((h, i) =>
+                    Math.max(h.length, ...rows.map(r => (r[i] || '').length))
+                );
+
+                // Print header
+                const headerLine = headers.map((h, i) => h.padEnd(colWidths[i])).join('  ');
+                console.log(headerLine);
+                console.log(colWidths.map(w => '-'.repeat(w)).join('  '));
+
+                // Print rows
+                for (const row of rows) {
+                    const line = row.map((cell, i) => (cell || '').padEnd(colWidths[i])).join('  ');
+                    console.log(line);
+                }
+            }
+            break;
+        }
+
         case 'add': {
             if (parsed.args.length < 2) {
                 console.error('Usage: gcal add <title> <when> [duration]');
@@ -496,10 +572,22 @@ async function main(): Promise<void> {
                 }
             };
 
+            if (parsed.reminder >= 0) {
+                event.reminders = {
+                    useDefault: false,
+                    overrides: [{ method: 'popup', minutes: parsed.reminder }]
+                };
+            }
+
             const token = await getAccessToken(user, true);
             const created = await createEvent(token, event, parsed.calendar);
             console.log(`\nEvent created: ${created.summary}`);
             console.log(`  When: ${formatDateTime(created.start)} - ${formatDateTime(created.end)}`);
+            if (parsed.reminder >= 0) {
+                const mins = parsed.reminder;
+                const reminderStr = mins >= 1440 ? `${mins / 1440}d` : mins >= 60 ? `${mins / 60}h` : `${mins}m`;
+                console.log(`  Reminder: ${reminderStr} before`);
+            }
             if (created.htmlLink) {
                 console.log(`  Link: ${created.htmlLink}`);
             }

package/glib/gutils.ts

@@ -298,16 +298,19 @@ export function parseDateTime(input: string): Date {
         }
     }
 
-    // Handle time only (HH:mm) - assume today
+    // Handle time only (HH:mm) - assume today, or tomorrow if time already passed
     const timeMatch = input.match(/^(\d{1,2}):(\d{2})$/);
     if (timeMatch) {
         const [, hour, min] = timeMatch;
         const d = new Date(now);
         d.setHours(parseInt(hour), parseInt(min), 0, 0);
+        if (d <= now) {
+            d.setDate(d.getDate() + 1);  // Time passed, use tomorrow
+        }
         return d;
     }
 
-    // Handle time with am/pm (2pm, 10am, 2:30pm) - assume today
+    // Handle time with am/pm (2pm, 10am, 2:30pm) - assume today, or tomorrow if time already passed
     const ampmMatch = lower.match(/^(\d{1,2})(?::(\d{2}))?\s*(am|pm)$/);
     if (ampmMatch) {
         const [, hour, min, ampm] = ampmMatch;
@@ -316,6 +319,9 @@ export function parseDateTime(input: string): Date {
         if (ampm === 'am' && h === 12) h = 0;
         const d = new Date(now);
         d.setHours(h, parseInt(min || '0'), 0, 0);
+        if (d <= now) {
+            d.setDate(d.getDate() + 1);  // Time passed, use tomorrow
+        }
         return d;
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/gcal",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Google Calendar CLI tool with ICS import support",
   "type": "module",
   "main": "gcal.ts",
@@ -43,6 +43,9 @@
     "@bobfrankston/oauthsupport": "^1.0.5",
     "ical.js": "^2.1.0"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   ".dependencies": {
     "@bobfrankston/oauthsupport": "file:../../../projects/OAuth/OauthSupport",
     "ical.js": "^2.1.0"