@hera-al/server 1.6.12 → 1.6.13

package/bundled/google-workspace/scripts/calendar.sh

@@ -0,0 +1,508 @@
+#!/usr/bin/env bash
+# Google Calendar API client — OAuth2 REST API v3
+# Usage: calendar.sh <command> [options]
+#
+# Commands:
+#   list [--max N] [--cal ID]                     List today's events
+#   upcoming [--days N] [--max N] [--cal ID]      List upcoming events
+#   search "query" [--max N] [--cal ID]           Search events by text
+#   get <eventId> [--cal ID]                      Get event details
+#   create --summary TITLE --start ISO --end ISO  Create event
+#   update <eventId> [--summary T] [--start ISO]  Update event
+#   delete <eventId> [--cal ID]                   Delete event
+#   calendars                                      List available calendars
+#   today [--cal ID]                               Alias for list (today's events)
+#   week [--cal ID]                                Events for this week
+
+set -euo pipefail
+
+# --- Config ---
+API_BASE="https://www.googleapis.com/calendar/v3"
+TOKEN_FILE="${HOME}/.gmab-google-token.json"
+
+# --- Token management (shared pattern) ---
+get_access_token() {
+  local client_id="${GOOGLE_CLIENT_ID:-}"
+  local client_secret="${GOOGLE_CLIENT_SECRET:-}"
+  local refresh_token="${GOOGLE_REFRESH_TOKEN:-}"
+
+  if [[ -z "$refresh_token" && -f "$TOKEN_FILE" ]]; then
+    client_id=$(jq -r '.client_id // empty' "$TOKEN_FILE" 2>/dev/null || true)
+    client_secret=$(jq -r '.client_secret // empty' "$TOKEN_FILE" 2>/dev/null || true)
+    refresh_token=$(jq -r '.refresh_token // empty' "$TOKEN_FILE" 2>/dev/null || true)
+  fi
+
+  if [[ -z "$client_id" || -z "$client_secret" || -z "$refresh_token" ]]; then
+    echo "ERROR: Google credentials not configured." >&2
+    echo "Set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN" >&2
+    echo "Or run auth.sh to set up OAuth2." >&2
+    exit 1
+  fi
+
+  if [[ -f "$TOKEN_FILE" ]]; then
+    local cached_token cached_expiry
+    cached_token=$(jq -r '.access_token // empty' "$TOKEN_FILE" 2>/dev/null || true)
+    cached_expiry=$(jq -r '.expires_at // 0' "$TOKEN_FILE" 2>/dev/null || true)
+    local now
+    now=$(date +%s)
+    if [[ -n "$cached_token" && "$cached_expiry" -gt "$now" ]]; then
+      echo "$cached_token"
+      return
+    fi
+  fi
+
+  local response
+  response=$(curl -s "https://oauth2.googleapis.com/token" \
+    -d "client_id=$client_id" \
+    -d "client_secret=$client_secret" \
+    -d "refresh_token=$refresh_token" \
+    -d "grant_type=refresh_token")
+
+  local access_token
+  access_token=$(echo "$response" | jq -r '.access_token // empty')
+  local expires_in
+  expires_in=$(echo "$response" | jq -r '.expires_in // 3600')
+
+  if [[ -z "$access_token" ]]; then
+    echo "ERROR: Failed to refresh access token" >&2
+    echo "$response" >&2
+    exit 1
+  fi
+
+  local expires_at
+  expires_at=$(($(date +%s) + expires_in - 60))
+
+  if [[ -f "$TOKEN_FILE" ]]; then
+    local tmp
+    tmp=$(jq --arg at "$access_token" --argjson ea "$expires_at" \
+      '. + {access_token: $at, expires_at: $ea}' "$TOKEN_FILE")
+    echo "$tmp" > "$TOKEN_FILE"
+  else
+    jq -n \
+      --arg ci "$client_id" \
+      --arg cs "$client_secret" \
+      --arg rt "$refresh_token" \
+      --arg at "$access_token" \
+      --argjson ea "$expires_at" \
+      '{client_id: $ci, client_secret: $cs, refresh_token: $rt, access_token: $at, expires_at: $ea}' \
+      > "$TOKEN_FILE"
+  fi
+  chmod 600 "$TOKEN_FILE"
+
+  echo "$access_token"
+}
+
+# --- API helpers ---
+api_get() {
+  local path="$1"
+  local token
+  token=$(get_access_token)
+  curl -s -H "Authorization: Bearer $token" "${API_BASE}${path}"
+}
+
+api_post() {
+  local path="$1"
+  local data="${2:-}"
+  local token
+  token=$(get_access_token)
+  if [[ -n "$data" ]]; then
+    curl -s -H "Authorization: Bearer $token" \
+      -H "Content-Type: application/json" \
+      -d "$data" "${API_BASE}${path}"
+  else
+    curl -s -X POST -H "Authorization: Bearer $token" "${API_BASE}${path}"
+  fi
+}
+
+api_patch() {
+  local path="$1"
+  local data="$2"
+  local token
+  token=$(get_access_token)
+  curl -s -X PATCH -H "Authorization: Bearer $token" \
+    -H "Content-Type: application/json" \
+    -d "$data" "${API_BASE}${path}"
+}
+
+api_delete() {
+  local path="$1"
+  local token
+  token=$(get_access_token)
+  curl -s -X DELETE -H "Authorization: Bearer $token" "${API_BASE}${path}"
+}
+
+# --- Date helpers ---
+# Get ISO date for start of today (local timezone)
+today_start() {
+  if date -v0H >/dev/null 2>&1; then
+    # BSD date (macOS)
+    date -u -v0H -v0M -v0S "+%Y-%m-%dT%H:%M:%SZ"
+  else
+    # GNU date
+    date -u -d "$(date +%Y-%m-%d) 00:00:00" "+%Y-%m-%dT%H:%M:%SZ"
+  fi
+}
+
+today_end() {
+  if date -v0H >/dev/null 2>&1; then
+    date -u -v23H -v59M -v59S "+%Y-%m-%dT%H:%M:%SZ"
+  else
+    date -u -d "$(date +%Y-%m-%d) 23:59:59" "+%Y-%m-%dT%H:%M:%SZ"
+  fi
+}
+
+days_from_now() {
+  local n="$1"
+  if date -v0H >/dev/null 2>&1; then
+    date -u -v+"${n}d" -v23H -v59M -v59S "+%Y-%m-%dT%H:%M:%SZ"
+  else
+    date -u -d "+${n} days 23:59:59" "+%Y-%m-%dT%H:%M:%SZ"
+  fi
+}
+
+week_end() {
+  days_from_now 7
+}
+
+# --- Format helpers ---
+format_event() {
+  jq -r '
+    def fmt_time:
+      if .dateTime then (.dateTime | split("T") | .[1] | split("+")[0] | split("-")[0] | .[0:5])
+      elif .date then "all-day"
+      else "?"
+      end;
+
+    "  \(.start | fmt_time) — \(.end | fmt_time)  \(.summary // "(no title)")" +
+    (if .location then "\n    📍 \(.location)" else "" end) +
+    (if .description then "\n    📝 \(.description | .[0:100])" else "" end) +
+    "\n    🔑 \(.id)"
+  '
+}
+
+format_events_list() {
+  jq -r '
+    def fmt_time:
+      if .dateTime then (.dateTime | split("T") | .[1] | split("+")[0] | split("-")[0] | .[0:5])
+      elif .date then "all-day"
+      else "?"
+      end;
+
+    if (.items // []) | length == 0 then
+      "No events found."
+    else
+      (.items[] |
+        "  \(.start | fmt_time) — \(.end | fmt_time)  \(.summary // "(no title)")" +
+        (if .location then " 📍 \(.location)" else "" end) +
+        "  [\(.id)]"
+      )
+    end
+  '
+}
+
+# --- Commands ---
+
+cmd_calendars() {
+  api_get "/users/me/calendarList" | jq -r '
+    .items[] |
+    "  \(.summary)\t(\(.id))" +
+    (if .primary then " ⭐" else "" end)
+  '
+}
+
+cmd_list() {
+  local max=10
+  local cal="primary"
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --max) max="$2"; shift 2 ;;
+      --cal) cal="$2"; shift 2 ;;
+      *) shift ;;
+    esac
+  done
+
+  local time_min time_max
+  time_min=$(today_start)
+  time_max=$(today_end)
+
+  local encoded_min encoded_max
+  encoded_min=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$time_min'))")
+  encoded_max=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$time_max'))")
+
+  api_get "/calendars/${cal}/events?timeMin=${encoded_min}&timeMax=${encoded_max}&maxResults=${max}&singleEvents=true&orderBy=startTime" \
+    | format_events_list
+}
+
+cmd_today() {
+  cmd_list "$@"
+}
+
+cmd_upcoming() {
+  local max=10
+  local days=7
+  local cal="primary"
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --max) max="$2"; shift 2 ;;
+      --days) days="$2"; shift 2 ;;
+      --cal) cal="$2"; shift 2 ;;
+      *) shift ;;
+    esac
+  done
+
+  local time_min time_max
+  time_min=$(today_start)
+  time_max=$(days_from_now "$days")
+
+  local encoded_min encoded_max
+  encoded_min=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$time_min'))")
+  encoded_max=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$time_max'))")
+
+  api_get "/calendars/${cal}/events?timeMin=${encoded_min}&timeMax=${encoded_max}&maxResults=${max}&singleEvents=true&orderBy=startTime" \
+    | format_events_list
+}
+
+cmd_week() {
+  cmd_upcoming --days 7 "$@"
+}
+
+cmd_search() {
+  local query="${1:-}"
+  shift || true
+
+  if [[ -z "$query" ]]; then
+    echo "ERROR: Search query required" >&2
+    echo "Usage: calendar.sh search \"query\" [--max N]" >&2
+    exit 1
+  fi
+
+  local max=10
+  local cal="primary"
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --max) max="$2"; shift 2 ;;
+      --cal) cal="$2"; shift 2 ;;
+      *) shift ;;
+    esac
+  done
+
+  local encoded_query
+  encoded_query=$(python3 -c "import urllib.parse; print(urllib.parse.quote('$query'))")
+
+  api_get "/calendars/${cal}/events?q=${encoded_query}&maxResults=${max}&singleEvents=true&orderBy=startTime" \
+    | format_events_list
+}
+
+cmd_get() {
+  local event_id="${1:-}"
+  shift || true
+
+  if [[ -z "$event_id" ]]; then
+    echo "ERROR: Event ID required" >&2
+    exit 1
+  fi
+
+  local cal="primary"
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --cal) cal="$2"; shift 2 ;;
+      *) shift ;;
+    esac
+  done
+
+  api_get "/calendars/${cal}/events/${event_id}" | format_event
+}
+
+cmd_create() {
+  local summary="" start="" end="" location="" description="" cal="primary"
+  local all_day=false
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --summary) summary="$2"; shift 2 ;;
+      --start) start="$2"; shift 2 ;;
+      --end) end="$2"; shift 2 ;;
+      --location) location="$2"; shift 2 ;;
+      --description) description="$2"; shift 2 ;;
+      --cal) cal="$2"; shift 2 ;;
+      --all-day) all_day=true; shift ;;
+      *) shift ;;
+    esac
+  done
+
+  if [[ -z "$summary" ]]; then
+    echo "ERROR: --summary is required" >&2
+    exit 1
+  fi
+  if [[ -z "$start" ]]; then
+    echo "ERROR: --start is required (ISO 8601 datetime or YYYY-MM-DD for all-day)" >&2
+    exit 1
+  fi
+
+  # Build event JSON
+  local event_json
+  if [[ "$all_day" == true ]]; then
+    # All-day event: use date format
+    local end_date="${end:-$start}"
+    event_json=$(jq -n \
+      --arg summary "$summary" \
+      --arg start "$start" \
+      --arg e "$end_date" \
+      '{summary: $summary, start: {date: $start}, "end": {date: $e}}')
+  else
+    # Timed event: use dateTime
+    if [[ -z "$end" ]]; then
+      # Default: 1 hour after start
+      if date -v0H >/dev/null 2>&1; then
+        end=$(date -j -f "%Y-%m-%dT%H:%M:%S" "${start%%[+-]*}" -v+1H "+%Y-%m-%dT%H:%M:%S${start##*[0-9]}" 2>/dev/null || echo "$start")
+      else
+        end=$(date -d "${start} + 1 hour" --iso-8601=seconds 2>/dev/null || echo "$start")
+      fi
+    fi
+    event_json=$(jq -n \
+      --arg summary "$summary" \
+      --arg start "$start" \
+      --arg e "$end" \
+      '{summary: $summary, start: {dateTime: $start}, "end": {dateTime: $e}}')
+  fi
+
+  # Add optional fields
+  if [[ -n "$location" ]]; then
+    event_json=$(echo "$event_json" | jq --arg loc "$location" '. + {location: $loc}')
+  fi
+  if [[ -n "$description" ]]; then
+    event_json=$(echo "$event_json" | jq --arg desc "$description" '. + {description: $desc}')
+  fi
+
+  local result
+  result=$(api_post "/calendars/${cal}/events" "$event_json")
+
+  local created_id
+  created_id=$(echo "$result" | jq -r '.id // empty')
+  if [[ -n "$created_id" ]]; then
+    echo "Event created: $created_id"
+    echo "$result" | format_event
+  else
+    echo "ERROR: Failed to create event" >&2
+    echo "$result" >&2
+    exit 1
+  fi
+}
+
+cmd_update() {
+  local event_id="${1:-}"
+  shift || true
+
+  if [[ -z "$event_id" ]]; then
+    echo "ERROR: Event ID required" >&2
+    exit 1
+  fi
+
+  local summary="" start="" end="" location="" description="" cal="primary"
+
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --summary) summary="$2"; shift 2 ;;
+      --start) start="$2"; shift 2 ;;
+      --end) end="$2"; shift 2 ;;
+      --location) location="$2"; shift 2 ;;
+      --description) description="$2"; shift 2 ;;
+      --cal) cal="$2"; shift 2 ;;
+      *) shift ;;
+    esac
+  done
+
+  # Build patch JSON with only provided fields
+  local patch_json="{}"
+  if [[ -n "$summary" ]]; then
+    patch_json=$(echo "$patch_json" | jq --arg v "$summary" '. + {summary: $v}')
+  fi
+  if [[ -n "$start" ]]; then
+    patch_json=$(echo "$patch_json" | jq --arg v "$start" '. + {start: {dateTime: $v}}')
+  fi
+  if [[ -n "$end" ]]; then
+    patch_json=$(echo "$patch_json" | jq --arg v "$end" '. + {end: {dateTime: $v}}')
+  fi
+  if [[ -n "$location" ]]; then
+    patch_json=$(echo "$patch_json" | jq --arg v "$location" '. + {location: $v}')
+  fi
+  if [[ -n "$description" ]]; then
+    patch_json=$(echo "$patch_json" | jq --arg v "$description" '. + {description: $v}')
+  fi
+
+  if [[ "$patch_json" == "{}" ]]; then
+    echo "ERROR: No fields to update. Use --summary, --start, --end, --location, --description" >&2
+    exit 1
+  fi
+
+  local result
+  result=$(api_patch "/calendars/${cal}/events/${event_id}" "$patch_json")
+
+  local updated_id
+  updated_id=$(echo "$result" | jq -r '.id // empty')
+  if [[ -n "$updated_id" ]]; then
+    echo "Event updated: $updated_id"
+    echo "$result" | format_event
+  else
+    echo "ERROR: Failed to update event" >&2
+    echo "$result" >&2
+    exit 1
+  fi
+}
+
+cmd_delete() {
+  local event_id="${1:-}"
+  shift || true
+
+  if [[ -z "$event_id" ]]; then
+    echo "ERROR: Event ID required" >&2
+    exit 1
+  fi
+
+  local cal="primary"
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --cal) cal="$2"; shift 2 ;;
+      *) shift ;;
+    esac
+  done
+
+  api_delete "/calendars/${cal}/events/${event_id}"
+  echo "Event deleted: $event_id"
+}
+
+# --- Dispatch ---
+COMMAND="${1:-}"
+shift || true
+
+case "$COMMAND" in
+  list)       cmd_list "$@" ;;
+  today)      cmd_today "$@" ;;
+  upcoming)   cmd_upcoming "$@" ;;
+  week)       cmd_week "$@" ;;
+  search)     cmd_search "$@" ;;
+  get)        cmd_get "$@" ;;
+  create)     cmd_create "$@" ;;
+  update)     cmd_update "$@" ;;
+  delete)     cmd_delete "$@" ;;
+  calendars)  cmd_calendars "$@" ;;
+  *)
+    echo "Usage: calendar.sh <command> [options]" >&2
+    echo "" >&2
+    echo "Commands:" >&2
+    echo "  list [--max N] [--cal ID]                      Today's events" >&2
+    echo "  today [--cal ID]                                Alias for list" >&2
+    echo "  upcoming [--days N] [--max N] [--cal ID]        Upcoming events" >&2
+    echo "  week [--cal ID]                                 This week's events" >&2
+    echo "  search \"query\" [--max N] [--cal ID]             Search events" >&2
+    echo "  get <eventId> [--cal ID]                        Event details" >&2
+    echo "  create --summary T --start ISO [--end ISO]      Create event" >&2
+    echo "  update <eventId> [--summary T] [--start ISO]    Update event" >&2
+    echo "  delete <eventId> [--cal ID]                     Delete event" >&2
+    echo "  calendars                                        List calendars" >&2
+    exit 1
+    ;;
+esac