zm-ruby-client 0.14.0

data/lib/zm/client/appointment/appointment.rb

@@ -0,0 +1,143 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    # class for account appointment
+    class Appointment < Base::AccountObject
+
+      INSTANCE_VARIABLE_KEYS = %i[id uid name l desc start_at dur end_at tn allDay organizer timezone calItemId apptId invId rev fb transp]
+
+      attr_accessor *INSTANCE_VARIABLE_KEYS
+      attr_writer :folder
+      attr_reader :json
+      attr_reader :recipients, :attendees, :body
+
+      alias description desc
+      alias parent_id l
+
+      # def initialize(parent, json = nil)
+      def initialize(parent)
+        @parent = parent
+        @recipients = Recipients.new
+        @body = BodyMail.new
+        @attendees = Attendees.new
+        @allDay = false
+        @timezone = 'Europe/Berlin'
+        yield(self) if block_given?
+      end
+
+      def concat
+        INSTANCE_VARIABLE_KEYS.map { |key| instance_variable_get(arrow_name(key)) }
+      end
+
+      def folder
+        @folder ||= @parent.folders.all.find { |folder| folder.id == l }
+      end
+
+      def download(dest_file_path, fmt = 'ics')
+        # @parent.uploader.download_file(folder.absFolderPath, 'ics', ['appointment'], [id], dest_file_path)
+        uploader = Upload.new(@parent, RestAccountConnector.new)
+        uploader.download_file(folder.absFolderPath, fmt, ['appointment'], [id], dest_file_path)
+      end
+
+      def create!
+        jsns_builder = AppointmentJsnsBuilder.new(self)
+        rep = @parent.sacc.create_appointment(@parent.token, jsns_builder.to_jsns)
+        rep_h = rep[:Body][:CreateAppointmentResponse]
+
+        aji = AppointmentJsnsInitializer.new(@parent, rep_h)
+        aji.appointment = self
+        aji.update
+      end
+
+      def modify!
+        jsns_builder = AppointmentJsnsBuilder.new(self)
+        @parent.sacc.modify_appointment(@parent.token, jsns_builder.to_update)
+      end
+
+      def reload!
+        rep = @parent.sacc.get_msg(@parent.token, @id)
+        entry = rep[:Body][:GetMsgResponse][:m].first
+        aji = AppointmentJsnsInitializer.new(@parent, entry)
+        aji.appointment = self
+        aji.create
+      end
+
+      def delete!
+        jsns_builder = AppointmentJsnsBuilder.new(self)
+        @parent.sacc.cancel_appointment(@parent.token, jsns_builder.to_delete)
+      end
+
+      def free!
+        self.fb = 'F'
+        self.transp = 'O'
+      end
+
+      def busy!
+        self.fb = 'B'
+        self.transp = 'T'
+      end
+
+      def must_confirm!
+        self.fb = 'T'
+        self.transp = 'T'
+      end
+
+      def out_of_office!
+        self.fb = 'O'
+        self.transp = 'O'
+      end
+
+      class Organizer
+        attr_accessor :email, :display_name
+
+        def initialize(email, display_name = nil)
+          @email = email
+          @display_name = display_name
+        end
+      end
+
+      # Collection attendees
+      class Attendees
+        def initialize
+          @attendees = []
+        end
+
+        def map(&block)
+          @attendees.map(&block)
+        end
+
+        def add(attendee)
+          return unless attendee.is_a?(Attendee)
+
+          @attendees.push(attendee)
+        end
+
+        def del(attendee)
+          if attendee.is_a?(Attendee)
+            @attendees.delete(attendee)
+          elsif attendee.is_a?(String)
+            @attendees.delete_if { |at| at.email == attendee }
+          end
+        end
+
+        def clear
+          @attendees.clear
+        end
+      end
+
+      # Class one recipient for email
+      class Attendee
+        attr_accessor :email, :display_name, :role, :ptst, :rsvp
+
+        def initialize(email, display_name = nil, role = 'REQ', ptst = 'NE', rsvp = 1)
+          @email = email
+          @display_name = display_name
+          @role = role
+          @ptst = ptst
+          @rsvp = rsvp
+        end
+      end
+    end
+  end
+end

data/lib/zm/client/appointment/appointment_jsns_builder.rb

@@ -0,0 +1,125 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    # class for account appointment
+    class AppointmentJsnsBuilder
+
+      def initialize(appointment)
+        @appointment = appointment
+      end
+
+      def to_delete
+        {
+          comp: 0,
+          id: @appointment.id
+        }
+      end
+
+      def to_jsns
+        {
+          m: {
+            l: @appointment.l,
+            su: @appointment.name,
+            e: recipients_to_jsns,
+            mp: body_to_jsns,
+            inv: {
+              comp: comp_to_jsns
+            }
+          }
+        }
+      end
+
+      alias to_create to_jsns
+
+      def to_update
+        jsns = to_jsns
+        jsns[:comp] = 0
+        jsns[:id] = @appointment.id
+        jsns[:m][:inv][:uid] = @appointment.uid
+        jsns
+      end
+
+      def recipients_to_jsns
+        @appointment.recipients.map do |recipient|
+          {
+            t: recipient.field,
+            a: recipient.email,
+            p: recipient.display_name
+          }.reject { |_, v| v.nil? }
+        end
+      end
+
+      def body_to_jsns
+        [
+          {
+            ct: 'multipart/alternative',
+            mp: [body_text_jsns, body_html_jsns]
+          }
+        ]
+      end
+
+      def body_text_jsns
+        { ct: 'text/plain', content: { _content: @appointment.body.text } }
+      end
+
+      def body_html_jsns
+        { ct: 'text/html', content: { _content: @appointment.body.html } }
+      end
+
+      def comp_to_jsns
+        [
+          {
+            allDay: @appointment.allDay,
+            at: attendees_to_jsns,
+            e: end_at_jsns,
+            s: start_at_jsns,
+            or: organizer_to_jsns,
+            name: @appointment.name,
+            fb: @appointment.fb,
+            transp: @appointment.transp
+          }.reject { |_, v| v.nil? }
+        ]
+      end
+
+      def attendees_to_jsns
+        @appointment.attendees.map do |attendee|
+          {
+            a: attendee.email,
+            d: attendee.display_name,
+            role: attendee.role,
+            ptst: attendee.ptst,
+            rsvp: attendee.rsvp
+          }.reject { |_, v| v.nil? }
+        end
+      end
+
+      def end_at_jsns
+        {
+          d: @appointment.end_at.strftime(time_format),
+          tz: @appointment.timezone
+        }
+      end
+
+      def start_at_jsns
+        {
+          d: @appointment.start_at.strftime(time_format),
+          tz: @appointment.timezone
+        }
+      end
+
+      def organizer_to_jsns
+        return nil if @appointment.organizer.nil?
+
+        {
+          a: @appointment.organizer.email,
+          d: @appointment.organizer.display_name
+        }.reject { |_, v| v.nil? }
+      end
+
+      def time_format
+        @time_format ||= @appointment.allDay ? '%Y%m%d' : '%Y%m%dT%H%M00'
+      end
+    end
+  end
+end

data/lib/zm/client/appointment/appointment_jsns_initializer.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    # class for account appointment
+    class AppointmentJsnsInitializer
+
+      attr_accessor :appointment
+
+      def initialize(parent, json)
+        @parent = parent
+        @json = json
+      end
+
+      def update
+        return false if @appointment.nil?
+
+        @appointment.calItemId = @json[:calItemId]
+        @appointment.apptId = @json[:apptId]
+        @appointment.invId = @json[:invId]
+        @appointment.id = @json[:invId]
+        @appointment.rev = @json[:rev]
+
+        true
+      end
+
+      def create
+        @appointment ||= Appointment.new(@parent)
+
+        @appointment.id = @json[:id]
+        @appointment.tn = @json[:tn]
+        @appointment.l = @json[:l].to_i
+        @appointment.uid = @json[:uid]
+
+        if inv.nil?
+          init_from_search
+        else
+          init_from_inv
+        end
+
+        @appointment
+      end
+
+      def inv
+        @inv ||= @json[:inv]&.first
+      end
+
+      def init_from_search
+        @appointment.organizer = Zm::Client::Appointment::Organizer.new(search_organizer_name) unless search_organizer_name.nil?
+        @appointment.name = @json[:name]
+        @appointment.id = @json[:invId]
+        @appointment.desc = @json[:fr]
+        @appointment.allDay = @json[:allDay] unless @json[:allDay].nil?
+        search_make_date
+      end
+
+      def init_from_inv
+        @appointment.uid = comp[:uid]
+        @appointment.fb = comp[:fb]
+        @appointment.transp = comp[:transp]
+        @appointment.timezone = tz[:id]
+        @appointment.name = comp[:name]
+        @appointment.desc = comp[:desc].first[:_content] unless comp[:desc].nil?
+        @appointment.apptId = comp[:apptId]
+        @appointment.allDay = comp[:allDay] unless comp[:allDay].nil?
+
+        @appointment.organizer = Zm::Client::Appointment::Organizer.new(comp_organizer_name) unless comp_organizer_name.nil?
+
+        attendees.each do |attendee|
+          @appointment.attendees.add(Zm::Client::Appointment::Attendee.new(attendee[:a]))
+        end
+
+        comp_make_date
+      end
+
+      def search_make_date
+        return if @json[:inst].nil? || @json[:inst].first.empty? || @json[:dur].nil?
+
+        @appointment.start_at = Time.at(@json[:inst].first[:s] / 1000)
+        @appointment.end_at = Time.at((@json[:inst].first[:s] + @json[:dur]) / 1000)
+        @appointment.dur = @json[:dur] / 1000
+      end
+
+      def comp_make_date
+        if comp_start_h[:u].nil?
+          @appointment.start_at = Time.parse(comp_start_h[:d])
+          @appointment.end_at = Time.parse(comp_end_h[:d])
+        else
+          @appointment.start_at = Time.at(comp_start_h[:u] / 1000)
+          @appointment.end_at = Time.at(comp_end_h[:u] / 1000)
+        end
+      end
+
+      def comp_start_h
+        @comp_start_h ||= comp[:s].first
+      end
+
+      def comp_end_h
+        @comp_end_h ||= comp[:e].first
+      end
+
+      def tz
+        @tz ||= inv[:tz]&.first || { id: 'Europe/Berlin' }
+      end
+
+      def comp
+        raise Zm::Client::ZmError, 'invalid appointment received' if inv[:comp].nil?
+
+        @comp ||= inv[:comp].first
+      end
+
+      def comp_organizer_name
+        return nil if comp[:or].nil?
+
+        @comp_organizer_name ||= comp[:or][:a]
+      end
+
+      def search_organizer_name
+        return nil if @json[:or].nil?
+
+        @search_organizer_name ||= @json[:or][:a]
+      end
+
+      def attendees
+        @attendees ||= comp[:at] || []
+      end
+    end
+  end
+end

data/lib/zm/client/appointment/appointments_builder.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    # class factory [appointments]
+    class AppointmentsBuilder < Base::ObjectsBuilder
+      def initialize(parent, json)
+        @parent = parent
+        @json = json
+      end
+
+      def make
+        root.map do |s|
+          # Appointment.new(@parent, s)
+          # Appointment.new(@parent)
+          AppointmentJsnsInitializer.new(@parent, s).create
+        end
+      end
+
+      def ids
+        root.map { |s| s[:id] }
+      end
+
+      def root
+        root = @json[:Body][:SearchResponse][:appt]
+        return [] if root.nil?
+
+        root = [root] unless root.is_a?(Array)
+        root
+      end
+    end
+  end
+end

data/lib/zm/client/appointment/appointments_collection.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    # collection of appointments
+    class AppointmentsCollection < Base::ObjectsCollection
+      attr_accessor :more
+
+      def initialize(parent)
+        @parent = parent
+        @more = true
+        reset_query_params
+      end
+
+      def find(id)
+        rep = @parent.sacc.get_msg(@parent.token, id)
+        entry = rep[:Body][:GetMsgResponse][:m].first
+        AppointmentJsnsInitializer.new(@parent, entry).create
+      end
+
+      def new
+        appointment = Appointment.new(@parent)
+        yield(appointment) if block_given?
+        appointment
+      end
+
+      def start_at(start_at)
+        @start_at = start_at
+        self
+      end
+
+      def end_at(end_at)
+        @end_at = end_at
+        self
+      end
+
+      def folders(folders)
+        @folders = folders
+        @folder_ids = @folders.map(&:id)
+        self
+      end
+
+      def folder_ids(folder_ids)
+        @folder_ids = folder_ids
+        self
+      end
+
+      def where(query)
+        @query = query
+        self
+      end
+
+      def ids
+        search_builder.ids
+      end
+
+      private
+
+      def search_response
+        rep = @parent.sacc.search(@parent.token, 'appointment', @offset, @limit, 'dateAsc', query, build_options)
+        @more = rep[:Body][:SearchResponse][:more]
+        rep
+      end
+
+      def search_builder
+        AppointmentsBuilder.new(@parent, search_response)
+      end
+
+      def build_response
+        appointments = search_builder.make
+        appointments.each { |appo| appo.folder = find_folder(appo) } unless @folders.empty?
+        appointments
+      end
+
+      def build_options
+        return {} if !@start_at.is_a?(Time) && !@end_at.is_a?(Time)
+
+        {
+          calExpandInstStart: (@start_at.to_f * 1000).to_i,
+          calExpandInstEnd: (@end_at.to_f * 1000).to_i,
+        }
+      end
+
+      def query
+        return @query unless @query.nil?
+
+        return nil if @folder_ids.empty?
+
+        @folder_ids.map { |id| %Q{inid:"#{id}"} }.join(' OR ')
+      end
+
+      def find_folder(appointment)
+        @folders.find { |folder| folder.id == appointment.l }
+      end
+
+      def reset_query_params
+        super
+        @start_at = nil
+        @end_at = nil
+        @query = nil
+        @folder_ids = []
+        @folders = []
+      end
+    end
+  end
+end

data/lib/zm/client/appointment.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'zm/client/appointment/appointment'
+require 'zm/client/appointment/appointment_jsns_builder'
+require 'zm/client/appointment/appointment_jsns_initializer'
+require 'zm/client/appointment/appointments_builder'
+require 'zm/client/appointment/appointments_collection'

data/lib/zm/client/backup/backup.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    class Backup < Base::AdminObject
+      INSTANCE_VARIABLE_KEYS = %i[label type aborted start end minRedoSeq maxRedoSeq live accounts]
+
+      attr_reader *INSTANCE_VARIABLE_KEYS
+
+      alias name label
+
+      def server
+        parent
+      end
+
+      def to_h
+        hashmap = Hash[INSTANCE_VARIABLE_KEYS.map { |key| [key, instance_variable_get(arrow_name(key))] }]
+        hashmap.delete_if { |_, v| v.nil? }
+        hashmap
+      end
+
+      def to_s
+        to_h.to_s
+      end
+
+      def start_at
+        @start_at ||= Time.at(@start / 1000)
+      rescue StandardError => e
+        nil
+      end
+
+      def end_at
+        @end_at ||= Time.at(@end / 1000)
+      rescue StandardError => e
+        nil
+      end
+
+      def full?
+        @type == Zm::Client::BackupTypes::FULL
+      end
+
+      def incremental?
+        @type == Zm::Client::BackupTypes::INCREMENTAL
+      end
+
+      def init_from_json(json)
+        @label = json[:label]
+        @type = json[:type]
+        @aborted = json[:aborted]
+        @start = json[:start].to_i
+        @end = json[:end].to_i
+        @minRedoSeq = json[:minRedoSeq]
+        @maxRedoSeq = json[:maxRedoSeq]
+        @live = json[:live]
+        @accounts = json[:accounts]
+      end
+    end
+  end
+end

data/lib/zm/client/backup/backups_builder.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    # class factory [Backup]
+    class BackupsBuilder < Base::ObjectsBuilder
+      def make
+        records = []
+        return records if json_items.nil?
+
+        json_items.each do |entry|
+          backup = Backup.new(@parent)
+          backup.init_from_json(entry)
+          records << backup
+        end
+        records
+      end
+
+      private
+
+      def json_items
+        @json_items ||= @json[:Body][json_key][:backup]
+      end
+    end
+  end
+end

data/lib/zm/client/backup/backups_collection.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    # Collection Backups
+    class BackupsCollection < Base::ObjectsCollection
+      def initialize(parent)
+        @parent = parent
+      end
+
+      private
+
+      def make_query
+        sac.backup_query(@parent.id)
+      end
+
+      def build_response
+        BackupsBuilder.new(@parent, make_query).make
+      end
+    end
+  end
+end

data/lib/zm/client/backup.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'zm/client/backup/backup'
+require 'zm/client/backup/backups_builder'
+require 'zm/client/backup/backups_collection'

data/lib/zm/client/base/account_object.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Zm
+  module Client
+    module Base
+      # Abstract Class Provisionning AccountObject
+      class AccountObject < Object
+
+        def soap_account_connector
+          @parent.soap_account_connector
+        end
+
+        alias sacc soap_account_connector
+      end
+    end
+  end
+end