@ncukondo/gcal-cli 0.2.3 → 0.3.0

package/dist/index.js

@@ -587736,7 +587736,7 @@ function errorCodeToExitCode(code) {
 // package.json
 var package_default = {
   name: "@ncukondo/gcal-cli",
-  version: "0.2.3",
+  version: "0.3.0",
   type: "module",
   exports: {
     ".": "./dist/index.js"
@@ -591873,10 +591873,194 @@ function createListCommand() {
   return cmd;
 }
 
+// src/lib/date-utils.ts
+var DATE_ONLY_RE2 = /^\d{4}-\d{2}-\d{2}$/;
+function isDateOnly(input) {
+  if (!DATE_ONLY_RE2.test(input))
+    return false;
+  const [y, m, d] = input.split("-").map(Number);
+  const date3 = new Date(Date.UTC(y, m - 1, d));
+  return date3.getUTCFullYear() === y && date3.getUTCMonth() === m - 1 && date3.getUTCDate() === d;
+}
+function addDaysToDateString(dateStr, days) {
+  const [y, m, d] = dateStr.split("-").map(Number);
+  const date3 = new Date(Date.UTC(y, m - 1, d + days));
+  return date3.toISOString().slice(0, 10);
+}
+
+// src/lib/duration.ts
+var DURATION_RE = /^(?:(\d+)d)?(?:(\d+)h)?(?:(\d+)m)?$/;
+function parseDuration(input) {
+  const match2 = DURATION_RE.exec(input);
+  if (!match2 || input === "") {
+    throw new Error(`Invalid duration: "${input}". Use formats like 30m, 1h, 2d, 1h30m.`);
+  }
+  const days = Number(match2[1] || 0);
+  const hours = Number(match2[2] || 0);
+  const minutes = Number(match2[3] || 0);
+  const ms = ((days * 24 + hours) * 60 + minutes) * 60 * 1000;
+  if (ms === 0) {
+    throw new Error("Duration must be greater than zero.");
+  }
+  return ms;
+}
+
 // src/commands/update.ts
+var MS_PER_DAY = 24 * 60 * 60 * 1000;
+function resolveTimedEvent(startStr, endStr, timezone) {
+  const parsedStart = parseDateTimeInZone(startStr, timezone);
+  const parsedEnd = parseDateTimeInZone(endStr, timezone);
+  return {
+    start: formatDateTimeInZone(parsedStart, timezone),
+    end: formatDateTimeInZone(parsedEnd, timezone),
+    allDay: false
+  };
+}
+function resolveAllDayEvent(startStr, endStr) {
+  return {
+    start: startStr,
+    end: addDaysToDateString(endStr, 1),
+    allDay: true
+  };
+}
+function resolveStartAndEnd(startStr, endStr, allDay, timezone) {
+  if (allDay) {
+    return resolveAllDayEvent(startStr, endStr);
+  }
+  return resolveTimedEvent(startStr, endStr, timezone);
+}
+function resolveStartAndDuration(startStr, durationMs, allDay, timezone) {
+  if (allDay) {
+    const days = durationMs / MS_PER_DAY;
+    return {
+      start: startStr,
+      end: addDaysToDateString(startStr, days),
+      allDay: true
+    };
+  }
+  const parsedStart = parseDateTimeInZone(startStr, timezone);
+  const endDate = new Date(parsedStart.getTime() + durationMs);
+  return {
+    start: formatDateTimeInZone(parsedStart, timezone),
+    end: formatDateTimeInZone(endDate, timezone),
+    allDay: false
+  };
+}
+function resolveStartOnly(startStr, existing, allDay, timezone) {
+  if (allDay) {
+    const existingStartMs2 = new Date(existing.start).getTime();
+    const existingEndMs2 = new Date(existing.end).getTime();
+    const durationDays = Math.round((existingEndMs2 - existingStartMs2) / MS_PER_DAY);
+    return {
+      start: startStr,
+      end: addDaysToDateString(startStr, durationDays),
+      allDay: true,
+      existingEvent: existing
+    };
+  }
+  const existingStartMs = new Date(existing.start).getTime();
+  const existingEndMs = new Date(existing.end).getTime();
+  const durationMs = existingEndMs - existingStartMs;
+  const parsedStart = parseDateTimeInZone(startStr, timezone);
+  const endDate = new Date(parsedStart.getTime() + durationMs);
+  return {
+    start: formatDateTimeInZone(parsedStart, timezone),
+    end: formatDateTimeInZone(endDate, timezone),
+    allDay: false,
+    existingEvent: existing
+  };
+}
+function resolveEndOnly(endStr, existing, allDay, timezone) {
+  if (allDay) {
+    return {
+      start: existing.start,
+      end: addDaysToDateString(endStr, 1),
+      allDay: true,
+      existingEvent: existing
+    };
+  }
+  const parsedEnd = parseDateTimeInZone(endStr, timezone);
+  return {
+    start: existing.start,
+    end: formatDateTimeInZone(parsedEnd, timezone),
+    allDay: false,
+    existingEvent: existing
+  };
+}
+function resolveDurationOnly(durationMs, existing, allDay, timezone) {
+  if (allDay) {
+    const days = durationMs / MS_PER_DAY;
+    return {
+      start: existing.start,
+      end: addDaysToDateString(existing.start, days),
+      allDay: true,
+      existingEvent: existing
+    };
+  }
+  const existingStartMs = new Date(existing.start).getTime();
+  const endDate = new Date(existingStartMs + durationMs);
+  return {
+    start: existing.start,
+    end: formatDateTimeInZone(endDate, timezone),
+    allDay: false,
+    existingEvent: existing
+  };
+}
+async function resolveTimeUpdate(opts) {
+  const { timezone, calendarId, calendarName, eventId, getEvent: getEvent2 } = opts;
+  const hasStart = opts.start !== undefined;
+  const hasEnd = opts.end !== undefined;
+  const hasDuration = opts.duration !== undefined;
+  if (!hasStart && !hasEnd && !hasDuration)
+    return null;
+  const durationMs = hasDuration ? parseDuration(opts.duration) : undefined;
+  const needExisting = hasStart && !hasEnd && !hasDuration || hasEnd && !hasStart || hasDuration && !hasStart;
+  let existing;
+  if (needExisting) {
+    existing = await getEvent2(calendarId, calendarName, eventId, timezone);
+  }
+  const allDay = hasStart ? isDateOnly(opts.start) : existing.all_day;
+  if (hasStart && hasEnd) {
+    const startIsDateOnly = isDateOnly(opts.start);
+    const endIsDateOnly = isDateOnly(opts.end);
+    if (startIsDateOnly !== endIsDateOnly) {
+      throw new ApiError("INVALID_ARGS", "--start and --end must be the same type (both date-only or both datetime)");
+    }
+  }
+  if (hasEnd && !hasStart && existing) {
+    const endIsDateOnly = isDateOnly(opts.end);
+    if (existing.all_day && !endIsDateOnly) {
+      throw new ApiError("INVALID_ARGS", "--end format (datetime) does not match existing event type (all-day). Use date-only format (YYYY-MM-DD) or provide --start to change event type.");
+    }
+    if (!existing.all_day && endIsDateOnly) {
+      throw new ApiError("INVALID_ARGS", "--end format (date-only) does not match existing event type (timed). Use datetime format (YYYY-MM-DDTHH:MM) or provide --start to change event type.");
+    }
+  }
+  if (durationMs !== undefined && allDay) {
+    if (durationMs % MS_PER_DAY !== 0) {
+      throw new ApiError("INVALID_ARGS", "All-day events require day-unit duration (e.g. 1d, 2d). Sub-day durations like hours or minutes are not allowed.");
+    }
+  }
+  if (hasStart && hasEnd) {
+    return resolveStartAndEnd(opts.start, opts.end, allDay, timezone);
+  }
+  if (hasStart && durationMs !== undefined) {
+    return resolveStartAndDuration(opts.start, durationMs, allDay, timezone);
+  }
+  if (hasStart) {
+    return resolveStartOnly(opts.start, existing, allDay, timezone);
+  }
+  if (hasEnd) {
+    return resolveEndOnly(opts.end, existing, allDay, timezone);
+  }
+  if (durationMs !== undefined) {
+    return resolveDurationOnly(durationMs, existing, allDay, timezone);
+  }
+  return null;
+}
 async function handleUpdate(opts) {
   const { api: api2, eventId, calendarId, calendarName, format: format4, timezone, write } = opts;
-  const hasUpdate = opts.title !== undefined || opts.start !== undefined || opts.end !== undefined || opts.description !== undefined || opts.busy !== undefined || opts.free !== undefined;
+  const hasUpdate = opts.title !== undefined || opts.start !== undefined || opts.end !== undefined || opts.duration !== undefined || opts.description !== undefined || opts.busy !== undefined || opts.free !== undefined;
   if (!hasUpdate) {
     throw new ApiError("INVALID_ARGS", "at least one update option must be provided");
   }
@@ -591892,19 +592076,21 @@ async function handleUpdate(opts) {
   } else if (opts.free) {
     input.transparency = "transparent";
   }
-  if (opts.start !== undefined || opts.end !== undefined) {
-    if (opts.start === undefined || opts.end === undefined) {
-      throw new ApiError("INVALID_ARGS", "start, end, and allDay must all be provided together");
-    }
-    const startStr = opts.start;
-    const endStr = opts.end;
-    const parsedStart = parseDateTimeInZone(startStr, timezone);
-    const parsedEnd = parseDateTimeInZone(endStr, timezone);
+  const timeResult = await resolveTimeUpdate(opts);
+  if (timeResult) {
     const withTime = input;
-    withTime.start = formatDateTimeInZone(parsedStart, timezone);
-    withTime.end = formatDateTimeInZone(parsedEnd, timezone);
-    withTime.allDay = false;
+    withTime.start = timeResult.start;
+    withTime.end = timeResult.end;
+    withTime.allDay = timeResult.allDay;
     input.timeZone = timezone;
+    if (timeResult.existingEvent) {
+      const existing = timeResult.existingEvent;
+      if (existing.all_day && !timeResult.allDay) {
+        opts.writeStderr("⚠ Event type changed from all-day to timed");
+      } else if (!existing.all_day && timeResult.allDay) {
+        opts.writeStderr("⚠ Event type changed from timed to all-day");
+      }
+    }
   }
   if (opts.dryRun) {
     const changes = {};
@@ -591919,6 +592105,8 @@ async function handleUpdate(opts) {
       changes.start = withTime.start;
     if (withTime.end !== undefined)
       changes.end = withTime.end;
+    if (withTime.allDay !== undefined)
+      changes.allDay = withTime.allDay;
     if (format4 === "json") {
       write(formatJsonSuccess({
         dry_run: true,
@@ -591955,51 +592143,37 @@ function createUpdateCommand() {
   const cmd = new Command("update").description("Update an existing event").argument("<event-id>", "Event ID to update");
   cmd.option("-c, --calendar <id>", "Calendar ID");
   cmd.option("-t, --title <title>", "New title");
-  cmd.option("-s, --start <datetime>", "New start datetime");
-  cmd.option("-e, --end <datetime>", "New end datetime");
+  cmd.option("-s, --start <datetime>", "Start date or datetime. Date-only (YYYY-MM-DD) → all-day. Datetime (YYYY-MM-DDTHH:MM) → timed. Can be specified alone (preserves existing duration).");
+  cmd.option("-e, --end <datetime>", "End date or datetime. Can be specified alone (preserves existing start). All-day end is inclusive.");
+  cmd.option("--duration <duration>", "Duration instead of --end (e.g. 30m, 1h, 2d, 1h30m). Mutually exclusive with --end. Can be specified alone (preserves existing start).");
   cmd.option("-d, --description <text>", "New description");
   cmd.option("--busy", "Mark as busy");
   cmd.option("--free", "Mark as free");
   cmd.option("--dry-run", "Preview without executing");
+  const endOpt = cmd.options.find((o) => o.long === "--end");
+  const durationOpt = cmd.options.find((o) => o.long === "--duration");
+  endOpt.conflicts(["duration"]);
+  durationOpt.conflicts(["end"]);
   const busyOpt = cmd.options.find((o) => o.long === "--busy");
   const freeOpt = cmd.options.find((o) => o.long === "--free");
   busyOpt.conflicts(["free"]);
   freeOpt.conflicts(["busy"]);
+  cmd.addHelpText("after", `
+Examples:
+  gcal update abc123 -t "Updated Meeting"                                    # Title only
+  gcal update abc123 -s "2026-01-24T11:00"                                   # Start only, keep duration
+  gcal update abc123 -e "2026-01-24T12:00"                                   # End only, keep start
+  gcal update abc123 --duration 2h                                           # Duration only, keep start
+  gcal update abc123 -s "2026-01-24T11:00" -e "2026-01-24T12:30"            # Start + end
+  gcal update abc123 -s "2026-01-24T10:00" --duration 30m                   # Start + duration
+  gcal update abc123 -s "2026-03-01" -e "2026-03-03"                        # All-day, 3 days (inclusive)
+  gcal update abc123 -s "2026-03-01" --duration 2d                          # All-day, 2 days
+  gcal update abc123 --free                                                  # Transparency only
+  gcal update abc123 --dry-run -t "Preview"                                  # Dry run
+`);
   return cmd;
 }
 
-// src/lib/date-utils.ts
-var DATE_ONLY_RE2 = /^\d{4}-\d{2}-\d{2}$/;
-function isDateOnly(input) {
-  if (!DATE_ONLY_RE2.test(input))
-    return false;
-  const [y, m, d] = input.split("-").map(Number);
-  const date3 = new Date(Date.UTC(y, m - 1, d));
-  return date3.getUTCFullYear() === y && date3.getUTCMonth() === m - 1 && date3.getUTCDate() === d;
-}
-function addDaysToDateString(dateStr, days) {
-  const [y, m, d] = dateStr.split("-").map(Number);
-  const date3 = new Date(Date.UTC(y, m - 1, d + days));
-  return date3.toISOString().slice(0, 10);
-}
-
-// src/lib/duration.ts
-var DURATION_RE = /^(?:(\d+)d)?(?:(\d+)h)?(?:(\d+)m)?$/;
-function parseDuration(input) {
-  const match2 = DURATION_RE.exec(input);
-  if (!match2 || input === "") {
-    throw new Error(`Invalid duration: "${input}". Use formats like 30m, 1h, 2d, 1h30m.`);
-  }
-  const days = Number(match2[1] || 0);
-  const hours = Number(match2[2] || 0);
-  const minutes = Number(match2[3] || 0);
-  const ms = ((days * 24 + hours) * 60 + minutes) * 60 * 1000;
-  if (ms === 0) {
-    throw new Error("Duration must be greater than zero.");
-  }
-  return ms;
-}
-
 // src/commands/add.ts
 async function handleAdd(options, deps) {
   if (!options.title) {
@@ -592045,12 +592219,12 @@ async function handleAdd(options, deps) {
         deps.write(formatJsonError("INVALID_ARGS", `Invalid duration: "${options.duration}". Use formats like 30m, 1h, 2d, 1h30m.`));
         return { exitCode: ExitCode.ARGUMENT };
       }
-      const MS_PER_DAY = 24 * 60 * 60 * 1000;
-      if (durationMs % MS_PER_DAY !== 0) {
+      const MS_PER_DAY2 = 24 * 60 * 60 * 1000;
+      if (durationMs % MS_PER_DAY2 !== 0) {
         deps.write(formatJsonError("INVALID_ARGS", "All-day events require day-unit duration (e.g. 1d, 2d). Sub-day durations like hours or minutes are not allowed."));
         return { exitCode: ExitCode.ARGUMENT };
       }
-      const days = durationMs / MS_PER_DAY;
+      const days = durationMs / MS_PER_DAY2;
       end = addDaysToDateString(options.start, days);
     } else {
       end = addDaysToDateString(options.start, 1);
@@ -592753,6 +592927,9 @@ ${authUrl}`);
         timezone,
         write: (msg) => process.stdout.write(msg + `
 `),
+        writeStderr: (msg) => process.stderr.write(msg + `
+`),
+        getEvent: (calId, calName, evtId, tz) => getEvent(api2, calId, calName, evtId, tz),
         ...updateOpts
       });
       process.exit(result.exitCode);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ncukondo/gcal-cli",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "type": "module",
   "exports": {
     ".": "./dist/index.js"