@bobfrankston/gcal 0.1.7 → 0.1.9

package/gcal.ts

@@ -90,7 +90,8 @@ async function listEvents(
     accessToken: string,
     calendarId = 'primary',
     maxResults = 10,
-    timeMin?: string
+    timeMin?: string,
+    timeMax?: string
 ): Promise<GoogleEvent[]> {
     const params = new URLSearchParams({
         maxResults: maxResults.toString(),
@@ -98,6 +99,9 @@ async function listEvents(
         orderBy: 'startTime',
         timeMin: timeMin || new Date().toISOString()
     });
+    if (timeMax) {
+        params.set('timeMax', timeMax);
+    }
 
     const url = `${CALENDAR_API_BASE}/calendars/${encodeURIComponent(calendarId)}/events?${params}`;
     const res = await apiFetch(url, accessToken);
@@ -239,14 +243,19 @@ Options:
   -defaultUser <email>     Set default user for future use
   -c, -calendar <id>       Calendar ID (default: primary)
   -n <count>               Number of events to list
+  -after <when>            List events after this date/time
+  -before <when>           List events before this date/time
   -v, -verbose             Show event IDs and links
 
 Examples:
   gcal meeting.ics                        Import ICS file
   gcal list                               List next 10 events
+  gcal list -after tomorrow -before "jan 30"
   gcal add "Dentist" "Friday 3pm" "1h"
   gcal add "Lunch" "1/14/2026 12:00" "1h"
-  gcal add "Meeting" "tomorrow 10:00"
+  gcal add "Meeting" "tomorrow 10am"
+  gcal add "Call" "3pm" "30m"
+  gcal add "Appointment" "jan 15 2pm"
   gcal -defaultUser bob@gmail.com         Set default user
 
 File Association (Windows):
@@ -265,6 +274,8 @@ interface ParsedArgs {
     help: boolean;
     verbose: boolean;
     icsFile: string;  /** Direct .ics file path */
+    after: string;    /** Filter: events after this date/time */
+    before: string;   /** Filter: events before this date/time */
 }
 
 function parseArgs(argv: string[]): ParsedArgs {
@@ -277,7 +288,9 @@ function parseArgs(argv: string[]): ParsedArgs {
         count: 10,
         help: false,
         verbose: false,
-        icsFile: ''
+        icsFile: '',
+        after: '',
+        before: ''
     };
 
     const unknown: string[] = [];
@@ -302,6 +315,14 @@ function parseArgs(argv: string[]): ParsedArgs {
             case '-n':
                 result.count = parseInt(argv[++i]) || 10;
                 break;
+            case '-after':
+            case '--after':
+                result.after = argv[++i] || '';
+                break;
+            case '-before':
+            case '--before':
+                result.before = argv[++i] || '';
+                break;
             case '-v':
             case '-verbose':
             case '--verbose':
@@ -427,7 +448,9 @@ async function main(): Promise<void> {
         case 'list': {
             const count = parsed.args[0] ? parseInt(parsed.args[0]) : parsed.count;
             const token = await getAccessToken(user, false);
-            const events = await listEvents(token, parsed.calendar, count);
+            const timeMin = parsed.after ? parseDateTime(parsed.after).toISOString() : undefined;
+            const timeMax = parsed.before ? parseDateTime(parsed.before).toISOString() : undefined;
+            const events = await listEvents(token, parsed.calendar, count, timeMin, timeMax);
 
             if (events.length === 0) {
                 console.log('No upcoming events found.');
@@ -483,6 +506,32 @@ async function main(): Promise<void> {
             const durationMins = parseDuration(duration);
             const endTime = new Date(startTime.getTime() + durationMins * 60 * 1000);
 
+            // Check for suspicious dates (likely parsing errors)
+            const now = new Date();
+            const twoYearsFromNow = new Date(now);
+            twoYearsFromNow.setFullYear(twoYearsFromNow.getFullYear() + 2);
+
+            let warning = '';
+            if (startTime < now) {
+                warning = `Date is in the past: ${formatDateTime({ dateTime: startTime.toISOString() })}`;
+            } else if (startTime > twoYearsFromNow) {
+                warning = `Date is more than 2 years away: ${formatDateTime({ dateTime: startTime.toISOString() })}`;
+            }
+
+            if (warning) {
+                console.log(`\nWarning: ${warning}`);
+                console.log(`Input was: "${when}"`);
+                const readline = await import('readline');
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                const response = await new Promise<string>(resolve => {
+                    rl.question('Continue? (y/N) ', answer => { rl.close(); resolve(answer); });
+                });
+                if (response.toLowerCase() !== 'y') {
+                    console.log('Cancelled.');
+                    process.exit(0);
+                }
+            }
+
             const event: GoogleEvent = {
                 summary: title,
                 start: {

package/glib/gutils.ts

@@ -259,6 +259,26 @@ export function parseDateTime(input: string): Date {
         return d;
     }
 
+    // Handle month names: "jan 15", "jan 15 2026", "jan 15 3pm", "january 15 2026 3pm"
+    const months = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
+    const monthMatch = lower.match(/^(jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)[a-z]*\s+(\d{1,2})(?:\s+(\d{4}))?(?:\s+(?:at\s+)?(\d{1,2})(?::(\d{2}))?\s*(am|pm)?)?$/i);
+    if (monthMatch) {
+        const [, month, day, year, hour, min, ampm] = monthMatch;
+        const monthIndex = months.findIndex(m => month.toLowerCase().startsWith(m));
+        const d = new Date(parseInt(year || now.getFullYear().toString()), monthIndex, parseInt(day));
+        if (hour) {
+            let h = parseInt(hour);
+            if (ampm?.toLowerCase() === 'pm' && h < 12) h += 12;
+            if (ampm?.toLowerCase() === 'am' && h === 12) h = 0;
+            d.setHours(h, parseInt(min || '0'), 0, 0);
+        } else {
+            d.setHours(0, 0, 0, 0);
+        }
+        if (!isNaN(d.getTime())) {
+            return d;
+        }
+    }
+
     // Handle explicit date/time formats: "MM/DD/YYYY HH:mm" or "YYYY-MM-DD HH:mm"
     const dateTimeMatch = input.match(/^(\d{1,2})\/(\d{1,2})\/(\d{4})\s+(\d{1,2}):(\d{2})$/);
     if (dateTimeMatch) {
@@ -287,6 +307,29 @@ export function parseDateTime(input: string): Date {
         return d;
     }
 
+    // Handle time with am/pm: "10am", "3pm", "10:30am", "3:45pm" - assume today
+    const timeAmPmMatch = lower.match(/^(\d{1,2})(?::(\d{2}))?\s*(am|pm)$/);
+    if (timeAmPmMatch) {
+        const [, hour, min, ampm] = timeAmPmMatch;
+        const d = new Date(now);
+        let h = parseInt(hour);
+        if (ampm === 'pm' && h < 12) h += 12;
+        if (ampm === 'am' && h === 12) h = 0;
+        d.setHours(h, parseInt(min || '0'), 0, 0);
+        return d;
+    }
+
+    // Handle bare hour: "10", "14" - interpret as today at that hour (not a month)
+    const bareHourMatch = input.match(/^(\d{1,2})$/);
+    if (bareHourMatch) {
+        const hour = parseInt(bareHourMatch[1]);
+        if (hour >= 0 && hour <= 23) {
+            const d = new Date(now);
+            d.setHours(hour, 0, 0, 0);
+            return d;
+        }
+    }
+
     // Try native Date parsing
     const parsed = new Date(input);
     if (!isNaN(parsed.getTime())) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/gcal",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Google Calendar CLI tool with ICS import support",
   "type": "module",
   "main": "gcal.ts",
@@ -23,7 +23,8 @@
     "preversion": "npm run check && git add -A",
     "postversion": "git push && git push --tags",
     "release": "npm run prerelease:local && npm version patch && npm publish --access public",
-    "release:local": "npm run prerelease:local && npm version patch && npm publish --access public --ignore-scripts"
+    "release:local": "npm run prerelease:local && npm version patch && npm publish --access public --ignore-scripts",
+    "installer": "npm run release && npm install -g ."
   },
   "keywords": [
     "google",