google-calendar-apimatic-sdk 1.0.0

data/lib/calendar_api/logging/configuration/api_logging_configuration.rb

@@ -0,0 +1,186 @@
+# calendar_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module CalendarApi
+  # Initializes a new instance of RequestLoggingConfiguration.
+  class RequestLoggingConfiguration < CoreLibrary::ApiRequestLoggingConfiguration
+    # @param log_body [Boolean] Indicates whether the message body should be logged. Default is false.
+    # @param log_headers [Boolean] Indicates whether the message headers should be logged. Default is false.
+    # @param headers_to_exclude [Array<String>] Array of headers not displayed in logging. Default is an empty array.
+    # @param headers_to_include [Array<String>] Array of headers to be displayed in logging. Default is an empty array.
+    # @param headers_to_unmask [Array<String>] Array of headers which values are non-sensitive to display in logging.
+    #   Default is an empty array.
+    def initialize(log_body: false, log_headers: false, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil,
+                   include_query_in_path: false)
+      super(
+        log_body,
+        log_headers,
+        headers_to_exclude,
+        headers_to_include,
+        headers_to_unmask,
+        include_query_in_path
+      )
+    end
+
+    def clone_with(log_body: nil, log_headers: nil, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil, include_query_in_path: nil)
+      log_body ||= self.log_body
+      log_headers ||= self.log_headers
+      headers_to_include ||= self.headers_to_include
+      headers_to_exclude ||= self.headers_to_exclude
+      headers_to_unmask ||= self.headers_to_unmask
+      include_query_in_path ||= self.include_query_in_path
+
+      RequestLoggingConfiguration.new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask,
+        include_query_in_path: include_query_in_path
+      )
+    end
+
+    def self.from_env
+      log_body = ENV['REQUEST_LOG_BODY']
+      log_headers = ENV['REQUEST_LOG_HEADERS']
+      headers_to_include = ENV['REQUEST_HEADERS_TO_INCLUDE']
+      headers_to_exclude = ENV['REQUEST_HEADERS_TO_EXCLUDE']
+      headers_to_unmask = ENV['REQUEST_HEADERS_TO_UNMASK']
+      include_query_in_path = ENV['REQUEST_INCLUDE_QUERY_IN_PATH']
+
+      new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask,
+        include_query_in_path: include_query_in_path
+      )
+    end
+
+    def self.any_logging_configured?
+      %w[
+        REQUEST_LOG_BODY
+        REQUEST_LOG_HEADERS
+        REQUEST_HEADERS_TO_INCLUDE
+        REQUEST_HEADERS_TO_EXCLUDE
+        REQUEST_HEADERS_TO_UNMASK
+        REQUEST_INCLUDE_QUERY_IN_PATH
+      ].any? { |key| ENV.key?(key) && !ENV[key].nil? && !ENV[key].empty? }
+    end
+  end
+
+  # Initializes a new instance of ResponseLoggingConfiguration.
+  class ResponseLoggingConfiguration < CoreLibrary::ApiResponseLoggingConfiguration
+    def initialize(log_body: false, log_headers: false, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil)
+      super(
+        log_body,
+        log_headers,
+        headers_to_exclude,
+        headers_to_include,
+        headers_to_unmask
+      )
+    end
+
+    def clone_with(log_body: nil, log_headers: nil, headers_to_include: nil,
+                   headers_to_exclude: nil, headers_to_unmask: nil)
+      log_body ||= self.log_body
+      log_headers ||= self.log_headers
+      headers_to_include ||= self.headers_to_include
+      headers_to_exclude ||= self.headers_to_exclude
+      headers_to_unmask ||= self.headers_to_unmask
+
+      ResponseLoggingConfiguration.new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask
+      )
+    end
+
+    def self.from_env
+      log_body = ENV['RESPONSE_LOG_BODY']
+      log_headers = ENV['RESPONSE_LOG_HEADERS']
+      headers_to_include = ENV['RESPONSE_HEADERS_TO_INCLUDE']
+      headers_to_exclude = ENV['RESPONSE_HEADERS_TO_EXCLUDE']
+      headers_to_unmask = ENV['RESPONSE_HEADERS_TO_UNMASK']
+
+      new(
+        log_body: log_body,
+        log_headers: log_headers,
+        headers_to_include: headers_to_include,
+        headers_to_exclude: headers_to_exclude,
+        headers_to_unmask: headers_to_unmask
+      )
+    end
+
+    def self.any_logging_configured?
+      %w[
+        RESPONSE_LOG_BODY
+        RESPONSE_LOG_HEADERS
+        RESPONSE_HEADERS_TO_INCLUDE
+        RESPONSE_HEADERS_TO_EXCLUDE
+        RESPONSE_HEADERS_TO_UNMASK
+      ].any? { |key| ENV.key?(key) && !ENV[key].nil? && !ENV[key].empty? }
+    end
+  end
+
+  # Initializes a new instance of LoggingConfiguration.
+  class LoggingConfiguration < CoreLibrary::ApiLoggingConfiguration
+    def initialize(logger: nil, log_level: nil, mask_sensitive_headers: true,
+                   request_logging_config: nil,
+                   response_logging_config: nil)
+      request_logging_config ||= RequestLoggingConfiguration.new
+      response_logging_config ||= ResponseLoggingConfiguration.new
+      super(
+        logger,
+        log_level,
+        request_logging_config,
+        response_logging_config,
+        mask_sensitive_headers
+      )
+    end
+
+    def clone_with(logger: nil, log_level: nil, mask_sensitive_headers: nil,
+                   request_logging_config: nil, response_logging_config: nil)
+      logger ||= self.logger
+      log_level ||= self.log_level
+      mask_sensitive_headers ||= self.mask_sensitive_headers
+      request_logging_config ||= self.request_logging_config.clone
+      response_logging_config ||= self.response_logging_config.clone
+
+      LoggingConfiguration.new(
+        logger: logger,
+        log_level: log_level,
+        mask_sensitive_headers: mask_sensitive_headers,
+        request_logging_config: request_logging_config,
+        response_logging_config: response_logging_config
+      )
+    end
+
+    def self.from_env
+      log_level = ENV['LOG_LEVEL']
+      mask_sensitive_headers = ENV['MASK_SENSITIVE_HEADERS']
+
+      new(
+        log_level: log_level,
+        mask_sensitive_headers: mask_sensitive_headers,
+        request_logging_config: RequestLoggingConfiguration.from_env,
+        response_logging_config: ResponseLoggingConfiguration.from_env
+      )
+    end
+
+    def self.any_logging_configured?
+      RequestLoggingConfiguration.any_logging_configured? ||
+        ResponseLoggingConfiguration.any_logging_configured? ||
+        ENV.key?('LOG_LEVEL') ||
+        ENV.key?('MASK_SENSITIVE_HEADERS')
+    end
+  end
+end

data/lib/calendar_api/logging/sdk_logger.rb

@@ -0,0 +1,17 @@
+# calendar_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module CalendarApi
+  # Represents the generic logger facade
+  class AbstractLogger < Logger
+    # Logs a message with a specified log level and additional parameters.
+    # @param level [Symbol] The log level of the message.
+    # @param message [String] The message to log.
+    # @param params [Hash] Additional parameters to include in the log message.
+    def log(level, message, params)
+      raise NotImplementedError, 'This method needs to be implemented in a child class.'
+    end
+  end
+end

data/lib/calendar_api/models/attachment.rb

@@ -0,0 +1,115 @@
+# calendar_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module CalendarApi
+  # A file attachment for an event.
+  class Attachment < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # URL link to the attachment. Required when adding an attachment.
+    # @return [String]
+    attr_accessor :file_url
+
+    # Attachment title.
+    # @return [String]
+    attr_accessor :title
+
+    # Internet media type (MIME type) of the attachment.
+    # @return [String]
+    attr_accessor :mime_type
+
+    # URL link to the attachment's icon.
+    # @return [String]
+    attr_accessor :icon_link
+
+    # ID of the attached file. Only populated for Google Drive files.
+    # @return [String]
+    attr_accessor :file_id
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['file_url'] = 'fileUrl'
+      @_hash['title'] = 'title'
+      @_hash['mime_type'] = 'mimeType'
+      @_hash['icon_link'] = 'iconLink'
+      @_hash['file_id'] = 'fileId'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        file_url
+        title
+        mime_type
+        icon_link
+        file_id
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(file_url: SKIP, title: SKIP, mime_type: SKIP,
+                   icon_link: SKIP, file_id: SKIP, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @file_url = file_url unless file_url == SKIP
+      @title = title unless title == SKIP
+      @mime_type = mime_type unless mime_type == SKIP
+      @icon_link = icon_link unless icon_link == SKIP
+      @file_id = file_id unless file_id == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      file_url = hash.key?('fileUrl') ? hash['fileUrl'] : SKIP
+      title = hash.key?('title') ? hash['title'] : SKIP
+      mime_type = hash.key?('mimeType') ? hash['mimeType'] : SKIP
+      icon_link = hash.key?('iconLink') ? hash['iconLink'] : SKIP
+      file_id = hash.key?('fileId') ? hash['fileId'] : SKIP
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      Attachment.new(file_url: file_url,
+                     title: title,
+                     mime_type: mime_type,
+                     icon_link: icon_link,
+                     file_id: file_id,
+                     additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} file_url: #{@file_url}, title: #{@title}, mime_type: #{@mime_type},"\
+      " icon_link: #{@icon_link}, file_id: #{@file_id}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} file_url: #{@file_url.inspect}, title: #{@title.inspect}, mime_type:"\
+      " #{@mime_type.inspect}, icon_link: #{@icon_link.inspect}, file_id: #{@file_id.inspect},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/calendar_api/models/attendee.rb

@@ -0,0 +1,167 @@
+# calendar_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module CalendarApi
+  # An attendee of an event.
+  class Attendee < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The attendee's Profile ID.
+    # @return [String]
+    attr_accessor :id
+
+    # The attendee's email address. Required when adding an attendee.
+    # @return [String]
+    attr_accessor :email
+
+    # The attendee's name.
+    # @return [String]
+    attr_accessor :display_name
+
+    # Whether the attendee is the organizer of the event.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :organizer
+
+    # Whether this entry represents the calendar on which this copy of the event
+    # appears.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :mself
+
+    # Whether the attendee is a resource (e.g. a room).
+    # @return [TrueClass | FalseClass]
+    attr_accessor :resource
+
+    # Whether this is an optional attendee.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :optional
+
+    # The attendee's response status.
+    # @return [ResponseStatus]
+    attr_accessor :response_status
+
+    # The attendee's response comment.
+    # @return [String]
+    attr_accessor :comment
+
+    # Number of additional guests the attendee is bringing.
+    # @return [Integer]
+    attr_accessor :additional_guests
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['id'] = 'id'
+      @_hash['email'] = 'email'
+      @_hash['display_name'] = 'displayName'
+      @_hash['organizer'] = 'organizer'
+      @_hash['mself'] = 'self'
+      @_hash['resource'] = 'resource'
+      @_hash['optional'] = 'optional'
+      @_hash['response_status'] = 'responseStatus'
+      @_hash['comment'] = 'comment'
+      @_hash['additional_guests'] = 'additionalGuests'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        id
+        email
+        display_name
+        organizer
+        mself
+        resource
+        optional
+        response_status
+        comment
+        additional_guests
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(id: SKIP, email: SKIP, display_name: SKIP, organizer: SKIP,
+                   mself: SKIP, resource: SKIP, optional: false,
+                   response_status: SKIP, comment: SKIP, additional_guests: 0,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @id = id unless id == SKIP
+      @email = email unless email == SKIP
+      @display_name = display_name unless display_name == SKIP
+      @organizer = organizer unless organizer == SKIP
+      @mself = mself unless mself == SKIP
+      @resource = resource unless resource == SKIP
+      @optional = optional unless optional == SKIP
+      @response_status = response_status unless response_status == SKIP
+      @comment = comment unless comment == SKIP
+      @additional_guests = additional_guests unless additional_guests == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      id = hash.key?('id') ? hash['id'] : SKIP
+      email = hash.key?('email') ? hash['email'] : SKIP
+      display_name = hash.key?('displayName') ? hash['displayName'] : SKIP
+      organizer = hash.key?('organizer') ? hash['organizer'] : SKIP
+      mself = hash.key?('self') ? hash['self'] : SKIP
+      resource = hash.key?('resource') ? hash['resource'] : SKIP
+      optional = hash['optional'] ||= false
+      response_status =
+        hash.key?('responseStatus') ? hash['responseStatus'] : SKIP
+      comment = hash.key?('comment') ? hash['comment'] : SKIP
+      additional_guests = hash['additionalGuests'] ||= 0
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      Attendee.new(id: id,
+                   email: email,
+                   display_name: display_name,
+                   organizer: organizer,
+                   mself: mself,
+                   resource: resource,
+                   optional: optional,
+                   response_status: response_status,
+                   comment: comment,
+                   additional_guests: additional_guests,
+                   additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, email: #{@email}, display_name: #{@display_name}, organizer:"\
+      " #{@organizer}, mself: #{@mself}, resource: #{@resource}, optional: #{@optional},"\
+      " response_status: #{@response_status}, comment: #{@comment}, additional_guests:"\
+      " #{@additional_guests}, additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, email: #{@email.inspect}, display_name:"\
+      " #{@display_name.inspect}, organizer: #{@organizer.inspect}, mself: #{@mself.inspect},"\
+      " resource: #{@resource.inspect}, optional: #{@optional.inspect}, response_status:"\
+      " #{@response_status.inspect}, comment: #{@comment.inspect}, additional_guests:"\
+      " #{@additional_guests.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/calendar_api/models/auto_decline_mode.rb

@@ -0,0 +1,40 @@
+# calendar_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module CalendarApi
+  # Whether to auto-decline conflicting meeting invitations.
+  class AutoDeclineMode
+    AUTO_DECLINE_MODE = [
+      # TODO: Write general description for DECLINENONE
+      DECLINENONE = 'declineNone'.freeze,
+
+      # TODO: Write general description for DECLINEALLCONFLICTINGINVITATIONS
+      DECLINEALLCONFLICTINGINVITATIONS = 'declineAllConflictingInvitations'.freeze,
+
+      # TODO: Write general description for DECLINEONLYNEWCONFLICTINGINVITATIONS
+      DECLINEONLYNEWCONFLICTINGINVITATIONS = 'declineOnlyNewConflictingInvitations'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      AUTO_DECLINE_MODE.include?(value)
+    end
+
+    def self.from_value(value, default_value = DECLINENONE)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'declinenone' then DECLINENONE
+      when 'declineallconflictinginvitations' then DECLINEALLCONFLICTINGINVITATIONS
+      when 'declineonlynewconflictinginvitations' then DECLINEONLYNEWCONFLICTINGINVITATIONS
+      else
+        default_value
+      end
+    end
+  end
+end

data/lib/calendar_api/models/base_model.rb

@@ -0,0 +1,110 @@
+# calendar_api
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module CalendarApi
+  # Base model.
+  # rubocop:disable all
+  class BaseModel < CoreLibrary::BaseModel
+    # Returns a Hash representation of the current object.
+    def to_hash
+      # validating the model being serialized
+      self.class.validate(self) if self.class.respond_to?(:validate)
+
+      hash = {}
+      instance_variables.each do |name|
+        value = instance_variable_get(name)
+        name = name[1..]
+        if name == 'additional_properties'
+          additional_properties = process_additional_properties(value, self.class.names)
+          hash.merge!(additional_properties)
+        else
+          key = self.class.names.key?(name) ? self.class.names[name] : name
+          optional_fields = self.class.optionals
+          nullable_fields = self.class.nullables
+          if value.nil?
+            next unless nullable_fields.include?(name)
+
+            if !optional_fields.include?(name) && !nullable_fields.include?(name)
+              raise ArgumentError,
+                    "`#{name}` cannot be nil in `#{self.class}`. Please specify a valid value."
+            end
+          end
+
+          hash[key] = nil
+          unless value.nil?
+            if respond_to?("to_custom_#{name}")
+              if (value.instance_of? Array) || (value.instance_of? Hash)
+                params = [hash, key]
+                hash[key] = send("to_custom_#{name}", *params)
+              else
+                hash[key] = send("to_custom_#{name}")
+              end
+            elsif respond_to?("to_union_type_#{name}")
+              hash[key] = send("to_union_type_#{name}")
+            elsif value.instance_of? Array
+              hash[key] = value.map { |v| v.is_a?(BaseModel) ? v.to_hash : v }
+            elsif value.instance_of? Hash
+              hash[key] = {}
+              value.each do |k, v|
+                hash[key][k] = v.is_a?(BaseModel) ? v.to_hash : v
+              end
+            else
+              hash[key] = value.is_a?(BaseModel) ? value.to_hash : value
+            end
+          end
+        end
+      end
+      hash
+    end
+
+    # Processes additional properties, ensuring no conflicts with existing properties.
+    def process_additional_properties(additional_properties, existing_prop_names)
+      hash = {}
+      additional_properties.each do |name, value|
+        check_for_conflict(name, existing_prop_names)
+
+        hash[name] = if value.is_a?(Array)
+                       process_array(value)
+                     elsif value.is_a?(Hash)
+                       process_hash(value)
+                     else
+                       process_basic_value(value)
+                     end
+      end
+      hash
+    end
+
+    # Checks if an additional property conflicts with a model's existing property.
+    def check_for_conflict(name, existing_prop_names)
+      return unless existing_prop_names.key?(name)
+
+      raise ArgumentError, "An additional property key, '#{name}' conflicts with one of the model's properties"
+    end
+
+    # Processes an array of values, recursively calling `to_hash` on BaseModel objects.
+    def process_array(value)
+      value.map { |v| v.is_a?(BaseModel) ? v.to_hash : v }
+    end
+
+    # Processes a hash of values, recursively calling `to_hash` on BaseModel objects.
+    def process_hash(value)
+      value.transform_values do |v|
+        v.is_a?(BaseModel) ? v.to_hash : v
+      end
+    end
+
+    # Processes a basic value (non-array, non-hash).
+    def process_basic_value(value)
+      value.is_a?(BaseModel) ? value.to_hash : value
+    end
+
+    # Returns a JSON representation of the curent object.
+    def to_json(options = {})
+      hash = to_hash
+      hash.to_json(options)
+    end
+  end
+  # rubocop:enable all
+end