teems 0.1.0

data/lib/teems/services/token_store.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+module Teems
+  module Services
+    # Token lookup accessors for TokenStore
+    module TokenLookup
+      # Get the skype_spaces_token for refresh
+      def skype_spaces_token = load_tokens['skype_spaces_token']
+
+      # Get OIDC refresh credentials
+      def refresh_token = load_tokens['refresh_token']
+      def client_id = load_tokens['client_id']
+      def tenant_id = load_tokens['tenant_id']
+
+      def configured?
+        File.exist?(tokens_file) && !load_tokens.empty?
+      end
+
+      def token_age
+        return nil unless File.exist?(tokens_file)
+
+        tokens = load_tokens
+        timestamp = tokens['tokens_refreshed_at'] || tokens['saved_at']
+        timestamp ? Time.now - Time.parse(timestamp) : nil
+      rescue ArgumentError
+        nil
+      end
+    end
+
+    # Manages Teams authentication tokens stored in config directory
+    class TokenStore
+      include TokenLookup
+
+      TOKENS_FILE = 'tokens.json'
+
+      def initialize(paths: Support::XdgPaths.new)
+        @paths = paths
+      end
+
+      def account
+        auth, skype, name, chatsvc, presence =
+          load_tokens.values_at('auth_token', 'skype_token', 'name', 'chatsvc_token', 'skype_spaces_token')
+        return nil unless auth && skype
+
+        Models::Account.new(
+          name: name || 'default', auth_token: auth,
+          skype_token: skype, chatsvc_token: chatsvc, presence_token: presence
+        )
+      end
+
+      def save(**tokens)
+        @paths.ensure_config_dir
+        data = tokens.transform_keys(&:to_s).merge('saved_at' => Time.now.iso8601).compact
+        write_token_file(data)
+      rescue SystemCallError, IOError => e
+        warn "teems: Could not save tokens: #{e.message}"
+        false
+      end
+
+      # Update just the skype_token (used during refresh)
+      def update_skype_token(skype_token)
+        with_loaded_tokens { |data| apply_skype_token(data, skype_token) }
+      rescue SystemCallError, IOError => e
+        warn "teems: Could not update token file: #{e.message}"
+        false
+      end
+
+      # Update all tokens at once (used by OIDC refresh)
+      def update_all_tokens(**tokens)
+        with_loaded_tokens { |data| apply_all_tokens(data, tokens) }
+      rescue SystemCallError, IOError => e
+        warn "teems: Could not update token file: #{e.message}"
+        false
+      end
+
+      def clear = FileUtils.rm_f(tokens_file)
+
+      private
+
+      def with_loaded_tokens
+        data = load_tokens
+        return false if data.empty?
+
+        yield data
+      end
+
+      def tokens_file
+        @paths.config_file(TOKENS_FILE)
+      end
+
+      def apply_skype_token(data, skype_token)
+        data.merge!('skype_token' => skype_token, 'skype_token_refreshed_at' => Time.now.iso8601)
+        write_token_file(data)
+      end
+
+      def apply_all_tokens(data, tokens)
+        updates = tokens.compact.transform_keys(&:to_s).merge('tokens_refreshed_at' => Time.now.iso8601)
+        write_token_file(data.merge!(updates))
+      end
+
+      def write_token_file(data)
+        File.write(tokens_file, JSON.pretty_generate(data))
+        File.chmod(0o600, tokens_file)
+      end
+
+      def load_tokens
+        return {} unless File.exist?(tokens_file)
+
+        JSON.parse(File.read(tokens_file))
+      rescue JSON::ParserError => e
+        warn "teems: Token file corrupted (#{e.message}), please re-authenticate with: teems auth login"
+        {}
+      end
+    end
+  end
+end

data/lib/teems/support/error_logger.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Teems
+  module Support
+    # Logs errors to a file for debugging
+    module ErrorLogger
+      module_function
+
+      def log(error, paths: XdgPaths.new)
+        log_file = prepare_log_file(paths)
+        append_error_entry(log_file, error)
+      rescue SystemCallError, IOError => e
+        warn "teems: Could not write error log: #{e.message}"
+        nil
+      end
+
+      def append_error_entry(log_file, error)
+        File.open(log_file, 'a') { |file| write_entry(file, error) }
+        log_file
+      end
+
+      def prepare_log_file(paths)
+        paths.ensure_cache_dir
+        paths.cache_file('error.log')
+      end
+
+      def write_entry(file, error)
+        file.puts "#{Time.now.iso8601} - #{error.class}: #{error.message}"
+        backtrace = error.backtrace
+        file.puts backtrace.first(10).map { |line| "  #{line}" }.join("\n") if backtrace
+        file.puts
+      end
+    end
+  end
+end

data/lib/teems/support/help_formatter.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module Teems
+  module Support
+    # Formats help text for commands
+    class HelpFormatter
+      def initialize(usage)
+        @usage = usage
+        @description = nil
+        @sections = []
+        @notes = []
+      end
+
+      def description(text)
+        @description = text
+      end
+
+      def note(text)
+        @notes << text
+      end
+
+      def section(title)
+        section = Section.new(title)
+        yield section
+        @sections << section
+      end
+
+      def render
+        lines = build_help_lines
+        @notes.each { |note| lines << "Note: #{note}" }
+        lines.join("\n")
+      end
+
+      def build_help_lines
+        lines = [@usage, '']
+        lines.push(@description, '') if @description
+        @sections.each { |section| lines.push(section.render, '') }
+        lines
+      end
+
+      # Section within help text
+      class Section
+        ITEM_RENDERERS = {
+          option: ->(args) { "  #{args[0].ljust(20)} #{args[1]}" },
+          item: ->(args) { "  #{args[0].ljust(20)} #{args[1]}" },
+          text: ->(args) { "  #{args.first}" }
+        }.freeze
+
+        def initialize(title)
+          @title = title
+          @items = []
+        end
+
+        def option(flags, description)
+          @items << [:option, flags, description]
+        end
+
+        def item(label, description)
+          @items << [:item, label, description]
+        end
+
+        def text(content)
+          @items << [:text, content]
+        end
+
+        def render
+          lines = ["#{@title}:"]
+          @items.each { |type, *args| lines << render_item(type, args) }
+          lines.join("\n")
+        end
+
+        private
+
+        def render_item(type, args)
+          ITEM_RENDERERS[type]&.call(args)
+        end
+      end
+    end
+  end
+end

data/lib/teems/support/timezone.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Teems
+  module Support
+    # Shared timezone detection logic for calendar and schedule commands
+    module Timezone
+      TIMEZONE_MAP = {
+        'EST' => 'America/New_York', 'EDT' => 'America/New_York',
+        'CST' => 'America/Chicago', 'CDT' => 'America/Chicago',
+        'MST' => 'America/Denver', 'MDT' => 'America/Denver',
+        'PST' => 'America/Los_Angeles', 'PDT' => 'America/Los_Angeles',
+        'AKST' => 'America/Anchorage', 'AKDT' => 'America/Anchorage',
+        'HST' => 'Pacific/Honolulu', 'UTC' => 'UTC', 'GMT' => 'UTC'
+      }.freeze
+
+      def detect_timezone
+        tz_from_env || tz_from_system
+      end
+
+      def short_tz_label
+        abbrev = tz_from_system_abbrev
+        abbrev.gsub(/[DS](?=T$)/, '')
+      end
+
+      private
+
+      def tz_from_system_abbrev
+        Time.now.strftime('%Z')
+      end
+
+      def tz_from_env
+        tz_env = ENV.fetch('TZ', nil)
+        return nil if tz_env.to_s.empty?
+        return tz_env if tz_env.include?('/')
+
+        TIMEZONE_MAP[tz_env]
+      end
+
+      def tz_from_system
+        TIMEZONE_MAP[Time.now.strftime('%Z')] || 'UTC'
+      end
+    end
+  end
+end

data/lib/teems/support/xdg_paths.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Teems
+  module Support
+    # XDG-compliant paths for config, cache, and data directories
+    class XdgPaths
+      def config_dir
+        @config_dir ||= File.join(
+          ENV.fetch('XDG_CONFIG_HOME', File.join(Dir.home, '.config')),
+          'teems'
+        )
+      end
+
+      def cache_dir
+        @cache_dir ||= File.join(
+          ENV.fetch('XDG_CACHE_HOME', File.join(Dir.home, '.cache')),
+          'teems'
+        )
+      end
+
+      def data_dir
+        @data_dir ||= File.join(
+          ENV.fetch('XDG_DATA_HOME', File.join(Dir.home, '.local', 'share')),
+          'teems'
+        )
+      end
+
+      def config_file(filename)
+        File.join(config_dir, filename)
+      end
+
+      def cache_file(filename)
+        File.join(cache_dir, filename)
+      end
+
+      def data_file(filename)
+        File.join(data_dir, filename)
+      end
+
+      def ensure_config_dir
+        FileUtils.mkdir_p(config_dir)
+      rescue SystemCallError => e
+        warn "teems: Could not create config directory #{config_dir}: #{e.message}"
+        raise
+      end
+
+      def ensure_cache_dir
+        FileUtils.mkdir_p(cache_dir)
+      rescue SystemCallError => e
+        warn "teems: Could not create cache directory #{cache_dir}: #{e.message}"
+        raise
+      end
+
+      def ensure_data_dir
+        FileUtils.mkdir_p(data_dir)
+      rescue SystemCallError => e
+        warn "teems: Could not create data directory #{data_dir}: #{e.message}"
+        raise
+      end
+    end
+  end
+end

data/lib/teems/version.rb

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

data/lib/teems.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'uri'
+require 'json'
+require 'fileutils'
+require 'optparse'
+require 'time'
+require 'io/console'
+require 'digest'
+
+# Microsoft Teams CLI - A command-line interface for Microsoft Teams
+module Teems
+  # Base error class for all Teems errors
+  class Error < StandardError; end
+
+  # Error raised when a Teams API request fails (4xx/5xx responses)
+  class ApiError < Error
+    attr_reader :status_code
+
+    def initialize(message = nil, status_code: nil)
+      @status_code = status_code
+      super(message)
+    end
+
+    def not_found? = status_code == 404
+    def unauthorized? = status_code == 401
+    def forbidden? = status_code == 403
+    def rate_limited? = status_code == 429
+  end
+
+  # Error raised when required configuration is missing or invalid
+  class ConfigError < Error; end
+
+  # Error raised when authentication fails or tokens are missing
+  class AuthError < Error; end
+
+  # Error raised when token storage operations fail
+  class TokenStoreError < Error; end
+
+  autoload :VERSION, 'teems/version'
+  autoload :CLI, 'teems/cli'
+  autoload :Runner, 'teems/runner'
+
+  # Data models for Teams entities
+  module Models
+    autoload :Account, 'teems/models/account'
+    autoload :Channel, 'teems/models/channel'
+    autoload :Chat, 'teems/models/chat'
+    autoload :Event, 'teems/models/event'
+    autoload :Message, 'teems/models/message'
+    autoload :Parsing, 'teems/models/parsing'
+    autoload :User, 'teems/models/user'
+    autoload :UserProfile, 'teems/models/user_profile'
+    autoload :Duration, 'teems/models/duration'
+  end
+
+  # Application services for configuration, caching, and API communication
+  module Services
+    autoload :ApiClient, 'teems/services/api_client'
+    autoload :Configuration, 'teems/services/configuration'
+    autoload :TokenStore, 'teems/services/token_store'
+    autoload :TokenExtractor, 'teems/services/token_extractor'
+    autoload :TokenRefresher, 'teems/services/token_refresher'
+    autoload :CacheStore, 'teems/services/cache_store'
+    autoload :FileDownloader, 'teems/services/file_downloader'
+    autoload :TeamsUrlParser, 'teems/services/teams_url_parser'
+    autoload :SyncStore, 'teems/services/sync_store'
+    autoload :SyncDirNaming, 'teems/services/sync_dir_naming'
+    autoload :SyncEngine, 'teems/services/sync_engine'
+  end
+
+  # Output formatters for messages and terminal output
+  module Formatters
+    autoload :Output, 'teems/formatters/output'
+    autoload :FormatUtils, 'teems/formatters/format_utils'
+    autoload :MessageFormatter, 'teems/formatters/message_formatter'
+    autoload :MarkdownFormatter, 'teems/formatters/markdown_formatter'
+    autoload :CalendarFormatter, 'teems/formatters/calendar_formatter'
+  end
+
+  # CLI commands implementing user-facing functionality
+  module Commands
+    autoload :Base, 'teems/commands/base'
+    autoload :Activity, 'teems/commands/activity'
+    autoload :Auth, 'teems/commands/auth'
+    autoload :Cal, 'teems/commands/cal'
+    autoload :Channels, 'teems/commands/channels'
+    autoload :Chats, 'teems/commands/chats'
+    autoload :Messages, 'teems/commands/messages'
+    autoload :Sync, 'teems/commands/sync'
+    autoload :Help, 'teems/commands/help'
+    autoload :Who, 'teems/commands/who'
+    autoload :Ooo, 'teems/commands/ooo'
+    autoload :Org, 'teems/commands/org'
+    autoload :Status, 'teems/commands/status'
+  end
+
+  # Thin wrappers around Teams API endpoints
+  module Api
+    autoload :Client, 'teems/api/client'
+    autoload :Calendar, 'teems/api/calendar'
+    autoload :Channels, 'teems/api/channels'
+    autoload :Chats, 'teems/api/chats'
+    autoload :Files, 'teems/api/files'
+    autoload :Messages, 'teems/api/messages'
+    autoload :Users, 'teems/api/users'
+  end
+
+  # Utility classes for paths and helpers
+  module Support
+    autoload :XdgPaths, 'teems/support/xdg_paths'
+    autoload :HelpFormatter, 'teems/support/help_formatter'
+    autoload :ErrorLogger, 'teems/support/error_logger'
+    autoload :Timezone, 'teems/support/timezone'
+  end
+end