teems 0.1.0 → 0.3.0

data/lib/teems/commands/ooo.rb

@@ -15,9 +15,14 @@ module Teems
 
       ON OPTIONS:
         --message TEXT       Auto-reply and status message
-        --start DATE         Schedule start (YYYY-MM-DD), enables scheduled mode
-        --end DATE           Schedule end (YYYY-MM-DD), required with --start
-        --event              Create an all-day OOO calendar event for notify list
+        --start TIME         Schedule start; enables scheduled mode. Formats:
+                               YYYY-MM-DD              (all-day)
+                               YYYY-MM-DD HH:MM        (timed)
+                               "today HH:MM", "tomorrow HH:MM", HH:MM
+        --end TIME           Schedule end, required with --start.
+                             Must match --start style (date or timed).
+        --event              Create an OOO calendar event for notify list
+        --invite EMAILS      Comma-separated invitees; overrides config notify list
         --no-status          Skip setting Teams status/presence
 
       CONFIGURATION:
@@ -38,10 +43,43 @@ module Teems
         teems ooo on                       # Enable OOO (always on)
         teems ooo on --message "Vacation"  # Custom message
         teems ooo on --start 2026-04-14 --end 2026-04-18
+        teems ooo on --start "today 14:00" --end "today 17:00" \\
+          --message "Dr appt"
         teems ooo off                      # Disable OOO
         teems ooo config                   # Show config
     HELP
 
+    # A parsed --start or --end value. Produces ISO datetime strings for
+    # auto-reply schedules and calendar events. Kind is :timed, :date, or
+    # :unscheduled; value is a Time, Date, or nil respectively.
+    OooScheduleEntry = Data.define(:kind, :value) do
+      def timed? = kind == :timed
+      def all_day? = kind == :date
+      def unscheduled? = kind == :unscheduled
+
+      def reply_start_iso
+        timed? ? value.strftime('%Y-%m-%dT%H:%M:%S') : "#{value}T00:00:00"
+      end
+
+      def reply_end_iso
+        timed? ? value.strftime('%Y-%m-%dT%H:%M:%S') : "#{value}T23:59:59"
+      end
+
+      def event_start_iso
+        base = value || Date.today
+        timed? ? base.strftime('%Y-%m-%dT%H:%M:%S') : "#{base}T00:00:00"
+      end
+
+      def event_end_iso
+        base = value || Date.today
+        return base.strftime('%Y-%m-%dT%H:%M:%S') if timed?
+
+        "#{base + 1}T00:00:00"
+      end
+    end
+
+    UNSCHEDULED_OOO_SCHEDULE = OooScheduleEntry.new(kind: :unscheduled, value: nil)
+
     # Displays current OOO status (auto-reply + presence)
     module OooDisplay
       private
@@ -90,13 +128,20 @@ module Teems
       end
 
       def render_schedule(replies)
-        start_dt = replies.dig('scheduledStartDateTime', 'dateTime')
-        end_dt = replies.dig('scheduledEndDateTime', 'dateTime')
-        puts "  Schedule: #{format_dt(start_dt)} to #{format_dt(end_dt)}" if start_dt
+        start_entry = replies['scheduledStartDateTime']
+        return unless start_entry
+
+        start_str = format_schedule_dt(start_entry)
+        end_str = format_schedule_dt(replies['scheduledEndDateTime'])
+        puts "  Schedule: #{start_str} to #{end_str} #{short_tz_label}"
       end
 
-      def format_dt(raw)
-        Time.parse(raw).strftime('%Y-%m-%d %H:%M')
+      def format_schedule_dt(entry)
+        return '' unless entry
+
+        raw = entry['dateTime']
+        time = entry['timeZone'] == 'UTC' ? Time.parse("#{raw} UTC").getlocal : Time.parse(raw)
+        time.strftime('%Y-%m-%d %H:%M')
       rescue ArgumentError
         raw.to_s
       end
@@ -118,6 +163,60 @@ module Teems
       end
     end
 
+    # Parses and validates --start/--end into @schedule_start and @schedule_end.
+    # Each parsed value is a tuple: [:date, Date] for all-day or [:timed, Time] for timed.
+    module OooSchedule
+      private
+
+      def validate_create_options
+        start_raw = @options[:start]
+        end_raw = @options[:end]
+        return unless start_raw
+        return missing_end_error unless end_raw
+
+        parse_schedule_pair(start_raw, end_raw)
+      end
+
+      def missing_end_error
+        error('--end is required when using --start')
+        1
+      end
+
+      def parse_schedule_pair(start_raw, end_raw)
+        @schedule_start = parse_schedule_value(start_raw)
+        return invalid_schedule_error(:start, start_raw) unless @schedule_start
+
+        @schedule_end = parse_schedule_value(end_raw)
+        return invalid_schedule_error(:end, end_raw) unless @schedule_end
+
+        return mixed_schedule_error if schedule_kind(@schedule_start) != schedule_kind(@schedule_end)
+
+        nil
+      end
+
+      def parse_schedule_value(raw)
+        time = parse_time_input(raw)
+        return OooScheduleEntry.new(kind: :timed, value: time) if time
+
+        OooScheduleEntry.new(kind: :date, value: Date.parse(raw))
+      rescue Date::Error
+        nil
+      end
+
+      def invalid_schedule_error(key, raw)
+        error("Invalid value for --#{key}: #{raw}. " \
+              "Use YYYY-MM-DD, HH:MM, 'today HH:MM', 'tomorrow HH:MM', or 'YYYY-MM-DD HH:MM'")
+        1
+      end
+
+      def mixed_schedule_error
+        error('--start and --end must both be dates or both include a time')
+        1
+      end
+
+      def schedule_kind(parsed) = parsed.kind
+    end
+
     # Enables/disables OOO: auto-reply, status message, presence, calendar event
     module OooActions
       private
@@ -139,28 +238,6 @@ module Teems
         results.values.all? ? 0 : 1
       end
 
-      def validate_create_options
-        validate_schedule_dates || validate_date_format(:start) || validate_date_format(:end)
-      end
-
-      def validate_schedule_dates
-        return unless @options[:start] && !@options[:end]
-
-        error('--end is required when using --start')
-        1
-      end
-
-      def validate_date_format(key)
-        value = @options[key]
-        return unless value
-
-        Date.parse(value)
-        nil
-      rescue ArgumentError
-        error("Invalid date for --#{key}: #{value}. Expected format: YYYY-MM-DD")
-        1
-      end
-
       def execute_ooo_steps
         results = {}
         results[:auto_reply] = set_auto_reply
@@ -261,37 +338,29 @@ module Teems
       end
 
       def add_schedule(settings)
-        tz = detect_timezone
-        settings[:scheduledStartDateTime] = { dateTime: "#{@options[:start]}T00:00:00", timeZone: tz }
-        settings[:scheduledEndDateTime] = { dateTime: "#{@options[:end]}T23:59:59", timeZone: tz }
+        timezone = detect_timezone
+        settings[:scheduledStartDateTime] = { dateTime: @schedule_start.reply_start_iso, timeZone: timezone }
+        settings[:scheduledEndDateTime] = { dateTime: @schedule_end.reply_end_iso, timeZone: timezone }
       end
 
       def build_ooo_event
+        timezone = detect_timezone
         { subject: status_message_text,
-          start: ooo_event_time(:start),
-          end: ooo_event_time(:end),
-          isAllDay: true,
-          showAs: 'free',
-          isReminderOn: false,
-          isOnlineMeeting: false,
+          start: { dateTime: @schedule_start.event_start_iso, timeZone: timezone },
+          end: { dateTime: @schedule_end.event_end_iso, timeZone: timezone },
+          isAllDay: !@schedule_start.timed?, showAs: 'free',
+          isReminderOn: false, isOnlineMeeting: false,
           transactionId: SecureRandom.uuid,
           attendees: notify_list.map { |email| ooo_attendee(email) },
           responseRequested: false }
       end
 
-      def ooo_event_time(field)
-        date = @options[field] || Date.today.to_s
-        end_date = field == :end ? (Date.parse(date) + 1).to_s : date
-        tz = detect_timezone
-        { dateTime: "#{end_date}T00:00:00", timeZone: tz }
-      end
-
       def ooo_attendee(email)
         { emailAddress: { address: email }, type: 'required' }
       end
 
       def notify_list
-        @notify_list ||= ooo_config('notify') || []
+        @notify_list ||= @options[:invite] || ooo_config('notify') || []
       end
 
       def ooo_config(key)
@@ -302,20 +371,27 @@ module Teems
     # Manage out-of-office: auto-reply, status, presence, and calendar event
     class Ooo < Base
       include Support::Timezone
+      include Support::TimeParsing
       include OooDisplay
+      include OooSchedule
       include OooActions
       include OooBuildHelpers
 
       def initialize(args, runner:)
         @options = {}
+        @schedule_start = UNSCHEDULED_OOO_SCHEDULE
+        @schedule_end = UNSCHEDULED_OOO_SCHEDULE
         super
       end
 
+      SPLIT_OOO_EMAILS = ->(raw) { raw ? raw.split(',').map(&:strip).reject(&:empty?) : [] }
+
       OOO_OPTIONS = {
         '--message' => ->(opts, args) { opts[:message] = args.shift },
         '--start' => ->(opts, args) { opts[:start] = args.shift },
         '--end' => ->(opts, args) { opts[:end] = args.shift },
         '--event' => ->(opts, _args) { opts[:event] = true },
+        '--invite' => ->(opts, args) { opts[:invite] = SPLIT_OOO_EMAILS.call(args.shift) },
         '--no-status' => ->(opts, _args) { opts[:no_status] = true }
       }.freeze
 

data/lib/teems/runner.rb

@@ -3,6 +3,7 @@
 module Teems
   # API factory methods for Runner, extracted to keep method count manageable
   module ApiFactories
+    def meetings_api = Api::Meetings.new(api_client, account)
     def channels_api = Api::Channels.new(api_client, account)
     def chats_api = Api::Chats.new(api_client, account)
     def messages_api = Api::Messages.new(api_client, account)
@@ -56,6 +57,11 @@ module Teems
       Formatters::MessageFormatter.new(output: @output, cache_store: cache_store)
     end
 
+    # Safari JS runner for SharePoint automation
+    def safari_js_runner
+      Services::SafariJsRunner.new(output: @output)
+    end
+
     # Token extractor for Safari automation
     def token_extractor(auth_mode: :default)
       Services::TokenExtractor.new(output: @output, auth_mode: auth_mode)

data/lib/teems/services/api_client.rb

@@ -162,9 +162,9 @@ module Teems
         run_request(path, get_http_for_endpoint(endpoint_key)) { |http| http.request(req) }
       end
 
-      def delete(url, endpoint_key:, account:)
-        uri = URI(url)
-        run_request(uri.path, get_http_for_endpoint(endpoint_key)) do |http|
+      def delete(endpoint_key, path, account:)
+        uri = URI("#{resolve_endpoint(endpoint_key)}#{path}")
+        run_request(path, get_http_for_endpoint(endpoint_key)) do |http|
           req = Net::HTTP::Delete.new(uri)
           apply_auth(req, account, endpoint_key)
           http.request(req)

data/lib/teems/services/safari_js_runner.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require 'open3'
+
+module Teems
+  module Services
+    # Runs JavaScript in Safari's current tab via AppleScript
+    class SafariJsRunner
+      def initialize(output: nil)
+        @output = output
+      end
+
+      def available? = system('which', 'osascript', out: File::NULL, err: File::NULL)
+
+      def execute_js(js_code)
+        escaped = escape_js(js_code)
+        run_applescript(safari_js_script(escaped))
+      end
+
+      def navigate(url)
+        run_applescript(navigate_script(url))
+      end
+
+      def wait_for_load(timeout: 15)
+        timeout.times do
+          sleep 1
+          return if execute_js('document.readyState') == 'complete'
+        end
+        raise Teems::Error, 'Timed out waiting for page to load'
+      end
+
+      def page_url
+        run_applescript(page_url_script)
+      end
+
+      private
+
+      def escape_js(js_code)
+        js_code.gsub('\\', '\\\\\\\\').gsub('"', '\\"').gsub("\n", '\\n')
+      end
+
+      def safari_js_script(escaped_js)
+        <<~APPLESCRIPT
+          tell application "Safari"
+            if (count of windows) > 0 then
+              return do JavaScript "#{escaped_js}" in current tab of front window
+            end if
+            return ""
+          end tell
+        APPLESCRIPT
+      end
+
+      def navigate_script(url)
+        safe = escape_for_applescript(url)
+        "tell application \"Safari\"\nactivate\n" \
+          "if (count of windows) = 0 then\nmake new document with properties {URL:\"#{safe}\"}\n" \
+          "else\nset URL of current tab of front window to \"#{safe}\"\n" \
+          "end if\nend tell\n"
+      end
+
+      def escape_for_applescript(str)
+        str.gsub('\\', '\\\\\\\\').gsub('"', '\\"')
+      end
+
+      def page_url_script
+        <<~APPLESCRIPT
+          tell application "Safari"
+            if (count of windows) > 0 then
+              return URL of current tab of front window
+            end if
+            return ""
+          end tell
+        APPLESCRIPT
+      end
+
+      def run_applescript(script)
+        out, _err, status = Open3.capture3('osascript', '-e', script)
+        return nil unless status.success?
+
+        out.strip
+      rescue IOError, SystemCallError => e
+        log("AppleScript execution failed: #{e.message}")
+        nil
+      end
+
+      def log(message) = @output&.debug(message)
+    end
+  end
+end

data/lib/teems/support/time_parsing.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Teems
+  module Support
+    # Shared time-input parsing for commands that accept schedule inputs
+    # like "HH:MM", "today HH:MM", "tomorrow HH:MM", and "YYYY-MM-DD HH:MM".
+    module TimeParsing
+      private
+
+      def parse_time_input(raw)
+        date, time_str = split_time_input(raw)
+        return unless time_str
+
+        date.is_a?(String) ? parse_absolute_time(date, time_str) : parse_relative_time(date, time_str)
+      end
+
+      def split_time_input(raw)
+        base = Date.today
+        split_tomorrow_time(raw, base) || split_today_time(raw, base) || split_absolute_time(raw)
+      end
+
+      def split_tomorrow_time(raw, base)
+        return unless raw.start_with?('tomorrow ')
+
+        [base + 1, raw.delete_prefix('tomorrow ')]
+      end
+
+      def split_today_time(raw, base)
+        return unless raw.match?(/\A(?:today\s+)?\d{1,2}:\d{2}\z/)
+
+        [base, raw.delete_prefix('today ')]
+      end
+
+      def split_absolute_time(raw)
+        return unless raw.match?(/\A\d{4}-\d{2}-\d{2}\s+\d{1,2}:\d{2}\z/)
+
+        raw.split(/\s+/, 2)
+      end
+
+      def parse_relative_time(date, time_str)
+        hour, min = time_str.split(':').map(&:to_i)
+        Time.new(date.year, date.month, date.day, hour, min, 0)
+      rescue ArgumentError
+        nil
+      end
+
+      def parse_absolute_time(date_str, time_str)
+        date = Date.parse(date_str)
+        parse_relative_time(date, time_str)
+      rescue Date::Error
+        nil
+      end
+    end
+  end
+end

data/lib/teems/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Teems
-  VERSION = '0.1.0'
+  VERSION = '0.3.0'
 end

data/lib/teems.rb

@@ -67,6 +67,7 @@ module Teems
     autoload :TeamsUrlParser, 'teems/services/teams_url_parser'
     autoload :SyncStore, 'teems/services/sync_store'
     autoload :SyncDirNaming, 'teems/services/sync_dir_naming'
+    autoload :SafariJsRunner, 'teems/services/safari_js_runner'
     autoload :SyncEngine, 'teems/services/sync_engine'
   end
 
@@ -93,6 +94,7 @@ module Teems
     autoload :Who, 'teems/commands/who'
     autoload :Ooo, 'teems/commands/ooo'
     autoload :Org, 'teems/commands/org'
+    autoload :Meeting, 'teems/commands/meeting'
     autoload :Status, 'teems/commands/status'
   end
 
@@ -103,6 +105,7 @@ module Teems
     autoload :Channels, 'teems/api/channels'
     autoload :Chats, 'teems/api/chats'
     autoload :Files, 'teems/api/files'
+    autoload :Meetings, 'teems/api/meetings'
     autoload :Messages, 'teems/api/messages'
     autoload :Users, 'teems/api/users'
   end
@@ -113,5 +116,6 @@ module Teems
     autoload :HelpFormatter, 'teems/support/help_formatter'
     autoload :ErrorLogger, 'teems/support/error_logger'
     autoload :Timezone, 'teems/support/timezone'
+    autoload :TimeParsing, 'teems/support/time_parsing'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: teems
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Eric Boehs
@@ -28,6 +28,7 @@ files:
 - lib/teems/api/chats.rb
 - lib/teems/api/client.rb
 - lib/teems/api/files.rb
+- lib/teems/api/meetings.rb
 - lib/teems/api/messages.rb
 - lib/teems/api/users.rb
 - lib/teems/api/users_mailbox.rb
@@ -40,6 +41,9 @@ files:
 - lib/teems/commands/channels.rb
 - lib/teems/commands/chats.rb
 - lib/teems/commands/help.rb
+- lib/teems/commands/meeting.rb
+- lib/teems/commands/meeting_recording.rb
+- lib/teems/commands/meeting_transcript.rb
 - lib/teems/commands/messages.rb
 - lib/teems/commands/ooo.rb
 - lib/teems/commands/org.rb
@@ -66,6 +70,7 @@ files:
 - lib/teems/services/configuration.rb
 - lib/teems/services/file_downloader.rb
 - lib/teems/services/headless_extract.rb
+- lib/teems/services/safari_js_runner.rb
 - lib/teems/services/safari_oauth.rb
 - lib/teems/services/sync_dir_naming.rb
 - lib/teems/services/sync_engine.rb
@@ -78,6 +83,7 @@ files:
 - lib/teems/services/token_store.rb
 - lib/teems/support/error_logger.rb
 - lib/teems/support/help_formatter.rb
+- lib/teems/support/time_parsing.rb
 - lib/teems/support/timezone.rb
 - lib/teems/support/xdg_paths.rb
 - lib/teems/version.rb
@@ -104,7 +110,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.10
 specification_version: 4
 summary: A command-line interface for Microsoft Teams
 test_files: []