zm-ruby-client 3.0.1 → 3.1.0

data/lib/zm/client/tag/tags_collection.rb

@@ -6,7 +6,7 @@ module Zm
     class TagsCollection < Base::AccountObjectsCollection
       def initialize(parent)
         @child_class = Tag
-        @builder_class = TagBuilder
+        @builder_class = TagsBuilder
         super
       end
 
@@ -15,7 +15,7 @@ module Zm
       end
 
       def build_query
-        SoapElement.mail(SoapMailConstants::GET_TAG_REQUEST)
+        SoapRequest::SoapElement.mail(SoapRequest::SoapMailConstants::GET_TAG_REQUEST)
       end
     end
   end

data/lib/zm/client/task/task.rb

@@ -4,8 +4,8 @@ module Zm
   module Client
     # class for account task
     class Task < Base::Object
-      include BelongsToFolder
-      include BelongsToTag
+      include Zm::Utils::BelongsToFolder
+      include Zm::Utils::BelongsToTag
 
       attr_accessor :uid, :priority, :ptst, :percentComplete, :name, :loc, :alarm, :isOrg,
                     :id, :invId, :compNum, :l, :status, :class, :allDay, :f, :tn, :t, :rev,

data/lib/zm/client/task/tasks_collection.rb

@@ -14,7 +14,7 @@ module Zm
         @sort_by = 'taskDueAsc'
       end
 
-      def find_each(offset: 0, limit: 500, &block)
+      def find_each(offset: 0, limit: 500, &)
         (Time.at(0).year..(Time.now.year + 10)).each do |year|
           @start_at = Time.new(year, 1, 1)
           @end_at = Time.new(year, 12, 31)
@@ -23,7 +23,7 @@ module Zm
           @limit = limit
 
           while @more
-            build_response.each { |item| block.call(item) }
+            build_response.each(&)
             @offset += @limit
           end
         end

data/lib/zm/client/token.rb

@@ -21,7 +21,10 @@ module Zm
       def metadatas
         return @metadatas if defined? @metadatas
 
-        @metadatas = decoded.split(';').to_h { |part| part.split(/=\d+:/) }.freeze
+        @metadatas = decoded.split(';').each_with_object({}) do |part, h|
+          key, value = part.split(/=\d+:/, 2)
+          h[key] = value
+        end.freeze
       end
 
       def zimbra_id

data/lib/zm/client/upload.rb

@@ -1,3 +1,181 @@
 # frozen_string_literal: true
 
-require 'zm/client/upload/upload'
+module Zm
+  module Client
+    # class for upload mailbox file
+    class Upload
+      FMT_TYPES_H = {
+        'ics' => FolderView::APPOINTMENT,
+        'vcard' => FolderView::CONTACT,
+        'eml' => FolderView::MESSAGE,
+        'vcf' => FolderView::CONTACT
+      }.freeze
+
+      AUTHORIZED_FOLDER_FMT = %w[zip tgz ics csv tar xml json rss atom html ifb].freeze
+
+      AUTHORIZED_PARAMS = %i[charset auth fmt id part list types emptyname disp resolve query meta csvfmt].freeze
+
+      AUTHORIZED_RESOLVE = %w[replace modify reset skip].freeze
+
+      attr_reader :rest_connector
+      attr_accessor :charset, :auth, :emptyname, :disp
+
+      def initialize(base_url, token, is_token_admin: false, **rest_options)
+        raise Zm::Error::ZmError, 'base_url must to be present' if base_url.nil?
+
+        @charset = 'UTF-8'
+        @auth = 'co'
+        @emptyname = 'Empty'
+        @disp = 'a'
+
+        yield(self) if block_given?
+
+        @base_url = base_url
+
+        @rest_connector = Zm::Connector::RestConnector.new(**rest_options) do |conn|
+          conn.cookies = if is_token_admin
+                           "ZM_ADMIN_AUTH_TOKEN=#{token}"
+                         else
+                           "ZM_AUTH_TOKEN=#{token}"
+                         end
+        end
+      end
+
+      def download_file(dest_file_path, file_id, type, fmt: nil)
+        fmt ||= File.extname(dest_file_path)[1..]
+        type ||= FMT_TYPES_H[fmt]
+
+        raise Zm::Error::RestError, 'Invalid fmt type' if type.nil? && fmt.nil?
+
+        remote_url = download_file_url(fmt, type, file_id)
+        @rest_connector.download(remote_url, dest_file_path)
+      end
+
+      def read_file(file_id, type, fmt: nil)
+        type ||= FMT_TYPES_H[fmt]
+
+        raise Zm::Error::RestError, 'Invalid fmt type' if type.nil? && fmt.nil?
+
+        remote_url = download_file_url(fmt, type, file_id)
+        @rest_connector.read(remote_url)
+      end
+
+      def download_files(dest_file_path, file_ids, type, fmt: nil)
+        fmt ||= File.extname(dest_file_path)[1..]
+        type ||= FMT_TYPES_H[fmt]
+
+        raise Zm::Error::RestError, 'Invalid fmt type' if type.nil? && fmt.nil?
+
+        remote_url = download_files_url(fmt, type, file_ids)
+        @rest_connector.download(remote_url, dest_file_path)
+      end
+
+      def download_attachment(dest_file_path, message_id, part)
+        remote_url = download_attachment_url(message_id, part)
+        @rest_connector.download(remote_url, dest_file_path)
+      end
+
+      def download_folder(dest_file_path, folder_id, fmt: nil)
+        fmt ||= File.extname(dest_file_path)[1..]
+
+        raise Zm::Error::RestError, 'Unauthorized fmt parameter' unless AUTHORIZED_FOLDER_FMT.include?(fmt)
+
+        remote_url = download_folder_url(folder_id, fmt)
+        @rest_connector.download(remote_url, dest_file_path)
+      end
+
+      def send_file(src_file_path, folder_id, fmt: nil, type: nil, resolve: nil)
+        fmt ||= File.extname(src_file_path)[1..]
+        type ||= FMT_TYPES_H[fmt]
+        resolve ||= AUTHORIZED_RESOLVE.first
+
+        raise Zm::Error::RestError, 'Unauthorized resolve parameter' unless AUTHORIZED_RESOLVE.include?(resolve)
+
+        raise Zm::Error::RestError, 'Invalid fmt type' if type.nil? && fmt.nil?
+
+        remote_url = send_file_url(folder_id, fmt:, type:, resolve:)
+        @rest_connector.upload(remote_url, src_file_path)
+      end
+
+      def upload_attachment(src_file_path)
+        @rest_connector.upload(upload_attachment_url, src_file_path)
+      end
+
+      def build_params(**params)
+        params.select! { |k, _| AUTHORIZED_PARAMS.include?(k) }
+
+        params[:charset] ||= @charset
+        params[:auth] ||= @auth
+        params[:emptyname] ||= @emptyname
+        params[:disp] ||= @disp
+
+        params.compact!
+
+        params
+      end
+
+      def format_url_params(params)
+        URI.encode_www_form(params)
+      end
+
+      def format_url(url, str_params)
+        return url if str_params.nil? || str_params.empty?
+
+        "#{url}?#{str_params}"
+      end
+
+      def download_file_with_url(url, dest_file_path)
+        url = File.join(@base_url, url) unless url.start_with?('http://', 'https://')
+        raise Zm::Error::RestError, 'url does not match base_url origin' unless same_origin?(url)
+
+        @rest_connector.download(url, dest_file_path)
+      end
+
+      def same_origin?(url)
+        uri = URI(url)
+        base_uri = URI(@base_url)
+        uri.scheme == base_uri.scheme && uri.host == base_uri.host && uri.port == base_uri.port
+      rescue URI::InvalidURIError
+        false
+      end
+
+      def download_folder_url(folder_id, fmt)
+        h = build_params(fmt:, id: folder_id)
+
+        format_url(@base_url, format_url_params(h))
+      end
+
+      def download_file_url(fmt, type, id)
+        h = build_params(fmt:, types: type, id:)
+
+        format_url(@base_url, format_url_params(h))
+      end
+
+      def download_attachment_url(message_id, part)
+        h = build_params(id: message_id, part:)
+
+        format_url(@base_url, format_url_params(h))
+      end
+
+      def download_files_url(fmt, type, ids)
+        h = build_params(fmt:, types: type, list: ids.join(','))
+
+        format_url(@base_url, format_url_params(h))
+      end
+
+      def send_file_url(folder_id, fmt:, type:, resolve:)
+        h = build_params(fmt:, types: type, resolve:, id: folder_id)
+
+        format_url(@base_url, format_url_params(h))
+      end
+
+      def upload_attachment_url
+        h = {
+          fmt: 'extended,raw'
+        }
+
+        format_url(File.join(@base_url, 'service/upload'), format_url_params(h))
+      end
+    end
+  end
+end

data/lib/zm/client/{common/utils.rb → utils.rb}

@@ -10,9 +10,12 @@ module Zm
 
       class << self
         def format_email(email)
-          email.strip!
-          email.downcase!
-          email
+          raise ArgumentError, "email must be a String, got #{email.class}" unless email.is_a?(String)
+
+          formatted = email.strip.downcase
+          raise ArgumentError, 'email must not be empty' if formatted.empty?
+
+          formatted
         end
 
         # TODO: chercher - remplacer toutes les occurrences dans le code

data/lib/zm/client/zm_logger.rb

@@ -5,7 +5,7 @@ require 'logger'
 module Zm
   module Client
     class ZmLogger < ::Logger
-      def initialize(*args, **kwargs)
+      def initialize(*, **)
         super
         @formatter ||= ZmFormatter.new
       end

data/lib/zm/client.rb

@@ -1,13 +1,230 @@
 # frozen_string_literal: true
 
-require 'date'
-
-require 'zm/client/soap_request'
-require 'zm/modules/inspector'
-require 'zm/support/cache'
-require 'zm/client/zm_logger'
 require 'zm/client/version'
-require 'zm/client/constant'
-require 'zm/client/token'
-require 'zm/client/base'
-require 'zm/client/cluster'
+
+module Zm
+  module Client
+    autoload :DeprecatedConstants, 'zm/client/deprecated_constants'
+    extend DeprecatedConstants
+
+    autoload :Utils, 'zm/client/utils'
+    autoload :ZmLogger, 'zm/client/zm_logger'
+    autoload :Token, 'zm/client/token'
+    autoload :Upload, 'zm/client/upload'
+
+    autoload :Recipients, 'zm/client/recipients'
+    autoload :Recipient, 'zm/client/recipient'
+
+    autoload :LdapFilter, 'zm/client/ldap_filter'
+
+    autoload :BatchRequest, 'zm/client/batch_request'
+
+    autoload :MailboxItemConcern, 'zm/client/mailbox/mailbox_item_concern'
+    autoload :MailboxItemID, 'zm/client/mailbox/mailbox_item_id'
+
+    autoload :ClusterConfig, 'zm/client/cluster/cluster_config'
+    autoload :ClusterConfigDomain, 'zm/client/cluster/cluster_config'
+    autoload :ClusterConfigError, 'zm/client/cluster/cluster_config'
+    autoload :Cluster, 'zm/client/cluster/cluster'
+
+    autoload :Server, 'zm/client/server/server'
+    autoload :ServerJsnsInitializer, 'zm/client/server/server_jsns_initializer'
+    autoload :ServersBuilder, 'zm/client/server/servers_builder'
+    autoload :ServersCollection, 'zm/client/server/servers_collection'
+    autoload :ServerAccountsCollection, 'zm/client/server/server_accounts_collection'
+    autoload :ServerServices, 'zm/client/server/server_services'
+
+    autoload :Cos, 'zm/client/cos/cos'
+    autoload :CosJsnsInitializer, 'zm/client/cos/cos_jsns_initializer'
+    autoload :CosJsnsBuilder, 'zm/client/cos/cos_jsns_builder'
+    autoload :CosesBuilder, 'zm/client/cos/coses_builder'
+    autoload :CosesCollection, 'zm/client/cos/coses_collection'
+    autoload :CosServersCollection, 'zm/client/cos/cos_servers_collection'
+    autoload :CosDomainsCollection, 'zm/client/cos/cos_domains_collection'
+    autoload :CosAccountsCollection, 'zm/client/cos/cos_accounts_collection'
+
+    autoload :Domain, 'zm/client/domain/domain'
+    autoload :DomainsBuilder, 'zm/client/domain/domains_builder'
+    autoload :DomainJsnsBuilder, 'zm/client/domain/domain_jsns_builder'
+    autoload :DomainJsnsInitializer, 'zm/client/domain/domain_jsns_initializer'
+    autoload :DomainsCollection, 'zm/client/domain/domains_collection'
+    autoload :DomainAccountsCollection, 'zm/client/domain/domain_accounts_collection'
+    autoload :DomainDistributionListsCollection, 'zm/client/domain/domain_distributionlists_collection'
+    autoload :DomainResourcesCollection, 'zm/client/domain/domain_resources_collection'
+
+    autoload :Account, 'zm/client/account/account'
+    autoload :AccountJsnsBuilder, 'zm/client/account/account_jsns_builder'
+    autoload :AccountJsnsInitializer, 'zm/client/account/account_jsns_initializer'
+    autoload :AccountsBuilder, 'zm/client/account/accounts_builder'
+    autoload :AccountsCollection, 'zm/client/account/accounts_collection'
+    autoload :AccountAliasesCollection, 'zm/client/account/account_aliases_collection'
+    autoload :AccountDlsMembershipCollection, 'zm/client/account/account_dls_membership_collection'
+    autoload :AccountDlsOwnerCollection, 'zm/client/account/account_dls_owner_collection'
+
+    autoload :Resource, 'zm/client/resource/resource'
+    autoload :ResourceJsnsBuilder, 'zm/client/resource/resource_jsns_builder'
+    autoload :ResourceJsnsInitializer, 'zm/client/resource/resource_jsns_initializer'
+    autoload :ResourcesBuilder, 'zm/client/resource/resources_builder'
+    autoload :ResourcesCollection, 'zm/client/resource/resources_collection'
+
+    autoload :DistributionList, 'zm/client/distributionlist/distributionlist'
+    autoload :DistributionListJsnsBuilder, 'zm/client/distributionlist/distributionlist_jsns_builder'
+    autoload :DistributionListJsnsInitializer, 'zm/client/distributionlist/distributionlist_jsns_initializer'
+    autoload :DistributionListsBuilder, 'zm/client/distributionlist/distributionlists_builder'
+    autoload :DistributionListsCollection, 'zm/client/distributionlist/distributionlists_collection'
+    autoload :DlsMembershipCollection, 'zm/client/distributionlist/dls_membership_collection'
+    autoload :DlMembership, 'zm/client/distributionlist/dls_membership_collection'
+    autoload :DistributionListAliasesCollection, 'zm/client/distributionlist/distributionlist_aliases_collection'
+    autoload :DistributionListMembersCollection, 'zm/client/distributionlist/distributionlist_members_collection'
+    autoload :DistributionListOwnersCollection, 'zm/client/distributionlist/distributionlist_owners_collection'
+    autoload :DistributionListAcesCollection, 'zm/client/distributionlist/distributionlist_aces_collection'
+
+    autoload :License, 'zm/client/license/license'
+    autoload :LicenseJsnsInitializer, 'zm/client/license/license_jsns_initializer'
+    autoload :LicensesCollection, 'zm/client/license/licenses_collection'
+
+    autoload :MtaQueueName, 'zm/client/mta_queue/mta_queue_name'
+    autoload :MtaQueueAction, 'zm/client/mta_queue/mta_queue_action'
+
+    autoload :FolderDefault, 'zm/client/folder/folder_default'
+    autoload :FolderView, 'zm/client/folder/folder_view'
+
+    autoload :Ace, 'zm/client/ace/ace'
+    autoload :AceJsnsBuilder, 'zm/client/ace/ace_jsns_builder'
+    autoload :AceJsnsInitializer, 'zm/client/ace/ace_jsns_initializer'
+    autoload :AcesBuilder, 'zm/client/ace/aces_builder'
+    autoload :AcesCollection, 'zm/client/ace/aces_collection'
+
+    autoload :Appointment, 'zm/client/appointment/appointment'
+    autoload :AppointmentJsnsBuilder, 'zm/client/appointment/appointment_jsns_builder'
+    autoload :AppointmentJsnsInitializer, 'zm/client/appointment/appointment_jsns_initializer'
+    autoload :AppointmentsBuilder, 'zm/client/appointment/appointments_builder'
+    autoload :AppointmentsCollection, 'zm/client/appointment/appointments_collection'
+
+    autoload :Backup, 'zm/client/backup/backup'
+    autoload :BackupJsnsInitializer, 'zm/client/backup/backup_jsns_initializer'
+    autoload :BackupsBuilder, 'zm/client/backup/backups_builder'
+    autoload :BackupsCollection, 'zm/client/backup/backups_collection'
+
+    autoload :DataSource, 'zm/client/datasource/datasource'
+    autoload :DataSourceJsnsInitializer, 'zm/client/datasource/datasource_jsns_initializer'
+    autoload :DataSourceJsnsBuilder, 'zm/client/datasource/datasource_jsns_builder'
+    autoload :DataSourcesBuilder, 'zm/client/datasource/datasources_builder'
+    autoload :DataSourcesCollection, 'zm/client/datasource/datasources_collection'
+
+    autoload :Contact, 'zm/client/contact/contact'
+    autoload :ContactMembersCollection, 'zm/client/contact/contact_members_collection'
+    autoload :ModGroupContact, 'zm/client/contact/mod_group_contact'
+    autoload :ContactJsnsInitializer, 'zm/client/contact/contact_jsns_initializer'
+    autoload :ContactJsnsBuilder, 'zm/client/contact/contact_jsns_builder'
+    autoload :GroupContactJsnsBuilder, 'zm/client/contact/group_contact_jsns_builder'
+    autoload :ContactMember, 'zm/client/contact/contact_member'
+    autoload :ContactsBuilder, 'zm/client/contact/contacts_builder'
+    autoload :ContactsCollection, 'zm/client/contact/contacts_collection'
+
+    autoload :Document, 'zm/client/document/document'
+    autoload :DocumentJsnsInitializer, 'zm/client/document/document_jsns_initializer'
+    autoload :DocumentJsnsBuilder, 'zm/client/document/document_jsns_builder'
+    autoload :DocumentsBuilder, 'zm/client/document/documents_builder'
+    autoload :DocumentsCollection, 'zm/client/document/documents_collection'
+
+    autoload :FilterRule, 'zm/client/filter_rules/filter_rule'
+    autoload :FilterRuleJsnsInitializer, 'zm/client/filter_rules/filter_rule_jsns_initializer'
+    autoload :FilterRulesBuilder, 'zm/client/filter_rules/filter_rules_builder'
+    autoload :FilterRulesCollection, 'zm/client/filter_rules/filter_rules_collection'
+    autoload :OutgoingFilterRulesCollection, 'zm/client/filter_rules/outgoing_filter_rules_collection'
+
+    autoload :Task, 'zm/client/task/task'
+    autoload :TaskJsnsInitializer, 'zm/client/task/task_jsns_initializer'
+    autoload :TasksBuilder, 'zm/client/task/tasks_builder'
+    autoload :TasksCollection, 'zm/client/task/tasks_collection'
+
+    autoload :Tag, 'zm/client/tag/tag'
+    autoload :TagJsnsBuilder, 'zm/client/tag/tag_jsns_builder'
+    autoload :TagJsnsInitializer, 'zm/client/tag/tag_jsns_initializer'
+    autoload :TagsBuilder, 'zm/client/tag/tags_builder'
+    autoload :TagsCollection, 'zm/client/tag/tags_collection'
+    autoload :AccountObjectTagsCollection, 'zm/client/tag/account_object_tags_collection'
+
+    autoload :Signature, 'zm/client/signature/signature'
+    autoload :SignatureJsnsBuilder, 'zm/client/signature/signature_jsns_builder'
+    autoload :SignatureJsnsInitializer, 'zm/client/signature/signature_jsns_initializer'
+    autoload :SignaturesBuilder, 'zm/client/signature/signatures_builder'
+    autoload :SignaturesCollection, 'zm/client/signature/signatures_collection'
+
+    autoload :Share, 'zm/client/share/share'
+    autoload :ShareJsnsInitializer, 'zm/client/share/share_jsns_initializer'
+    autoload :SharesBuilder, 'zm/client/share/shares_builder'
+    autoload :SharesCollection, 'zm/client/share/shares_collection'
+    autoload :ShareMountPointsCollection, 'zm/client/share/share_mountpoints_collection'
+
+    autoload :SearchFolder, 'zm/client/search_folder/search_folder'
+    autoload :SearchFolderJsnsBuilder, 'zm/client/search_folder/search_folder_jsns_builder'
+    autoload :SearchFolderJsnsInitializer, 'zm/client/search_folder/search_folder_jsns_initializer'
+    autoload :SearchFoldersBuilder, 'zm/client/search_folder/search_folders_builder'
+    autoload :SearchFoldersCollection, 'zm/client/search_folder/search_folders_collection'
+
+    autoload :Folder, 'zm/client/folder/folder'
+    autoload :FolderJsnsBuilder, 'zm/client/folder/folder_jsns_builder'
+    autoload :FolderJsnsInitializer, 'zm/client/folder/folder_jsns_initializer'
+    autoload :FoldersJsnsBuilder, 'zm/client/folder/folders_jsns_builder'
+    autoload :FolderGrant, 'zm/client/folder/folder_grant'
+    autoload :FolderGrantsCollection, 'zm/client/folder/folder_grants_collection'
+    autoload :FolderGrantJsnsBuilder, 'zm/client/folder/folder_grant_jsns_builder'
+    autoload :FolderRetentionPolicy, 'zm/client/folder/folder_retention_policy'
+    autoload :FolderRetentionPoliciesCollection, 'zm/client/folder/folder_retention_policies_collection'
+    autoload :FoldersBuilder, 'zm/client/folder/folders_builder'
+    autoload :FoldersCollection, 'zm/client/folder/folders_collection'
+    autoload :ModDocumentFolder, 'zm/client/folder/mod_document_folder'
+
+    autoload :Identity, 'zm/client/identity/identity'
+    autoload :IdentityJsnsBuilder, 'zm/client/identity/identity_jsns_builder'
+    autoload :IdentityJsnsInitializer, 'zm/client/identity/identity_jsns_initializer'
+    autoload :IdentitiesBuilder, 'zm/client/identity/identities_builder'
+    autoload :IdentitiesCollection, 'zm/client/identity/identities_collection'
+
+    autoload :MountPoint, 'zm/client/mountpoint/mount_point'
+    autoload :MountPointJsnsBuilder, 'zm/client/mountpoint/mount_point_jsns_builder'
+    autoload :MountPointJsnsInitializer, 'zm/client/mountpoint/mount_point_jsns_initializer'
+    autoload :MountPointsBuilder, 'zm/client/mountpoint/mount_points_builder'
+    autoload :MountPointsCollection, 'zm/client/mountpoint/mount_points_collection'
+
+    autoload :Message, 'zm/client/message/message'
+    autoload :MessageFlagsCollection, 'zm/client/message/message_flags_collection'
+    autoload :MessageRecipients, 'zm/client/message/message_recipients'
+    autoload :MessageAttachmentsCollection, 'zm/client/message/message_attachments_collection'
+    autoload :Attachment, 'zm/client/message/message_attachments_collection'
+    autoload :MessageJsnsBuilder, 'zm/client/message/message_jsns_builder'
+    autoload :MessageJsnsInitializer, 'zm/client/message/message_jsns_initializer'
+    autoload :MessagesBuilder, 'zm/client/message/messages_builder'
+    autoload :MessagesCollection, 'zm/client/message/messages_collection'
+
+    autoload :MtaQueue, 'zm/client/mta_queue/mta_queue'
+    autoload :MtaQueueJsnsInitializer, 'zm/client/mta_queue/mta_queue_jsns_initializer'
+    autoload :MtaQueueJsnsBuilder, 'zm/client/mta_queue/mta_queue_jsns_builder'
+    autoload :MtaQueuesBuilder, 'zm/client/mta_queue/mta_queues_builder'
+    autoload :MtaQueuesCollection, 'zm/client/mta_queue/mta_queues_collection'
+
+    autoload :MtaQueueItem, 'zm/client/mta_queue_item/mta_queue_item'
+    autoload :MtaQueueItemJsnsInitializer, 'zm/client/mta_queue_item/mta_queue_item_jsns_initializer'
+    autoload :MtaQueueItemsBuilder, 'zm/client/mta_queue_item/mta_queue_items_builder'
+    autoload :MtaQueueItemsCollection, 'zm/client/mta_queue_item/mta_queue_items_collection'
+
+    module Base
+      autoload :BaseJsnsBuilder, 'zm/client/base/base_jsns_builder'
+      autoload :BaseAccountJsnsBuilder, 'zm/client/base/base_account_jsns_builder'
+      autoload :BaseJsnsInitializer, 'zm/client/base/base_jsns_initializer'
+      autoload :ObjectsBuilder, 'zm/client/base/objects_builder'
+      autoload :ObjectsCollection, 'zm/client/base/objects_collection'
+      autoload :AdminObjectsCollection, 'zm/client/base/admin_objects_collection'
+      autoload :AccountObjectsCollection, 'zm/client/base/account_objects_collection'
+      autoload :AccountSearchObjectsCollection, 'zm/client/base/account_search_objects_collection'
+      autoload :ZimbraAttributesCollection, 'zm/client/base/zimbra_attributes_collection'
+      autoload :ZimbraAttribute, 'zm/client/base/zimbra_attribute'
+      autoload :Object, 'zm/client/base/object'
+      autoload :MailboxObject, 'zm/client/base/mailbox_object'
+      autoload :MailboxInfosCollection, 'zm/client/base/mailbox_infos_collection'
+      autoload :MailboxPrefsCollection, 'zm/client/base/mailbox_prefs_collection'
+    end
+  end
+end

data/lib/zm/connector/network_error_handler.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Zm
+  module Connector
+    # convert Faraday network errors into Zm::Error::ConnectionError, the original error is kept as cause
+    module NetworkErrorHandler
+      NETWORK_ERRORS = [Faraday::ConnectionFailed, Faraday::TimeoutError, Faraday::SSLError].freeze
+
+      private
+
+      def handle_network_errors
+        yield
+      rescue *NETWORK_ERRORS => e
+        raise Zm::Error::ConnectionError, "#{e.class}: #{e.message}"
+      end
+    end
+  end
+end