nylas 5.17.0 → 6.0.3

data/lib/nylas/resources/connectors.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Connectors API
+  class Connectors < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Patch
+    include ApiOperations::Delete
+
+    # Access the Credentials API
+    attr_reader :credentials
+
+    # Initializes Connectors.
+    def initialize(sdk_instance)
+      super(sdk_instance)
+
+      @credentials = Credentials.new(sdk_instance)
+    end
+
+    # Return all connectors.
+    #
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Array(Hash), String)] The list of connectors and API Request ID.
+    def list(query_params: nil)
+      get(
+        path: "#{api_uri}/v3/connectors",
+        query_params: query_params
+      )
+    end
+
+    # Return a connector.
+    #
+    # @param provider [String] The provider associated to the connector to retrieve.
+    # @return [Array(Hash, String)] The connector and API request ID.
+    def find(provider:)
+      get(
+        path: "#{api_uri}/v3/connectors/#{provider}"
+      )
+    end
+
+    # Create a connector.
+    #
+    # @param request_body [Hash] The values to create the connector with.
+    # @return [Array(Hash, String)] The created connector and API Request ID.
+    def create(request_body:)
+      post(
+        path: "#{api_uri}/v3/connectors",
+        request_body: request_body
+      )
+    end
+
+    # Update a connector.
+    #
+    # @param provider [String] The provider associated to the connector to update.
+    # @param request_body [Hash] The values to update the connector with
+    # @return [Array(Hash, String)] The updated connector and API Request ID.
+    def update(provider:, request_body:)
+      patch(
+        path: "#{api_uri}/v3/connectors/#{provider}",
+        request_body: request_body
+      )
+    end
+
+    # Delete a connector.
+    #
+    # @param provider [String] The provider associated to the connector to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(provider:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/connectors/#{provider}"
+      )
+
+      [true, request_id]
+    end
+  end
+end

data/lib/nylas/resources/contacts.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Contact API
+  class Contacts < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Put
+    include ApiOperations::Delete
+
+    # Return all contacts.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Array(Hash), String, String)] The list of contacts, API Request ID, and next cursor.
+    def list(identifier:, query_params: nil)
+      get_list(
+        path: "#{api_uri}/v3/grants/#{identifier}/contacts",
+        query_params: query_params
+      )
+    end
+
+    # Return a contact.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param contact_id [String] The id of the contact to return.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Hash, String)] The contact and API request ID.
+    def find(identifier:, contact_id:, query_params: nil)
+      get(
+        path: "#{api_uri}/v3/grants/#{identifier}/contacts/#{contact_id}",
+        query_params: query_params
+      )
+    end
+
+    # Create a contact.
+    #
+    # @param identifier [String] Grant ID or email account in which to create the object.
+    # @param request_body [Hash] The values to create the contact with.
+    # @return [Array(Hash, String)] The created contact and API Request ID.
+    def create(identifier:, request_body:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/contacts",
+        request_body: request_body
+      )
+    end
+
+    # Update a contact.
+    #
+    # @param identifier [String] Grant ID or email account in which to update an object.
+    # @param contact_id [String] The id of the contact to update.
+    # @param request_body [Hash] The values to update the contact with
+    # @return [Array(Hash, String)] The updated contact and API Request ID.
+    def update(identifier:, contact_id:, request_body:)
+      put(
+        path: "#{api_uri}/v3/grants/#{identifier}/contacts/#{contact_id}",
+        request_body: request_body
+      )
+    end
+
+    # Delete a contact.
+    #
+    # @param identifier [String] Grant ID or email account from which to delete an object.
+    # @param contact_id [String] The id of the contact to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(identifier:, contact_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/grants/#{identifier}/contacts/#{contact_id}"
+      )
+
+      [true, request_id]
+    end
+
+    # Return all contact groups.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Array(Hash), String, String)] The list of contact groups and API Request ID.
+    def list_groups(identifier:, query_params: nil)
+      get_list(
+        path: "#{api_uri}/v3/grants/#{identifier}/contacts/groups",
+        query_params: query_params
+      )
+    end
+  end
+end

data/lib/nylas/resources/credentials.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Connectors API
+  class Credentials < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Patch
+    include ApiOperations::Delete
+
+    # Return all credentials.
+    #
+    # @param provider [String] The provider associated to the credential to list from
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Array(Hash), String)] The list of credentials and API Request ID.
+    def list(provider:, query_params: nil)
+      get(
+        path: "#{api_uri}/v3/connectors/#{provider}/creds",
+        query_params: query_params
+      )
+    end
+
+    # Return a connector.
+    #
+    # @param provider [String] The provider associated to the connector to retrieve.
+    # @param credential_id [String] The id of the credentials to retrieve.
+    # @return [Array(Hash, String)] The connector and API request ID.
+    def find(provider:, credential_id:)
+      get(
+        path: "#{api_uri}/v3/connectors/#{provider}/creds/#{credential_id}"
+      )
+    end
+
+    # Create a connector.
+    #
+    # @param provider [String] The provider associated to the credential being created
+    # @param request_body [Hash] The values to create the connector with.
+    # @return [Array(Hash, String)] The created connector and API Request ID.
+    def create(provider:, request_body:)
+      post(
+        path: "#{api_uri}/v3/connectors/#{provider}/creds",
+        request_body: request_body
+      )
+    end
+
+    # Update a connector.
+    #
+    # @param provider [String] The provider associated to the connector to update from.
+    # @param credential_id [String] The id of the credentials to update.
+    # @param request_body [Hash] The values to update the connector with
+    # @return [Array(Hash, String)] The updated connector and API Request ID.
+    def update(provider:, credential_id:, request_body:)
+      patch(
+        path: "#{api_uri}/v3/connectors/#{provider}/creds/#{credential_id}",
+        request_body: request_body
+      )
+    end
+
+    # Delete a connector.
+    #
+    # @param provider [String] The provider associated to the connector to delete.
+    # @param credential_id [String] The id of the credentials to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(provider:, credential_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/connectors/#{provider}/creds/#{credential_id}"
+      )
+
+      [true, request_id]
+    end
+  end
+end

data/lib/nylas/resources/drafts.rb

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+require_relative "../utils/file_utils"
+
+module Nylas
+  # Nylas Drafts API
+  class Drafts < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Put
+    include ApiOperations::Delete
+
+    # Return all drafts.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Array(Hash), String, String)] The list of drafts, API Request ID, and next cursor.
+    def list(identifier:, query_params: nil)
+      get_list(
+        path: "#{api_uri}/v3/grants/#{identifier}/drafts",
+        query_params: query_params
+      )
+    end
+
+    # Return an draft.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param draft_id [String] The id of the draft to return.
+    # @return [Array(Hash, String)] The draft and API request ID.
+    def find(identifier:, draft_id:)
+      get(
+        path: "#{api_uri}/v3/grants/#{identifier}/drafts/#{draft_id}"
+      )
+    end
+
+    # Create an draft.
+    #
+    # @param identifier [String] Grant ID or email account in which to create the draft.
+    # @param request_body [Hash] The values to create the message with.
+    #   If you're attaching files, you must pass an array of [File] objects, or
+    #   you can use {FileUtils::attach_file_request_builder} to build each object attach.
+    # @return [Array(Hash, String)] The created draft and API Request ID.
+    def create(identifier:, request_body:)
+      payload = request_body
+      opened_files = []
+
+      # Use form data only if the attachment size is greater than 3mb
+      attachments = request_body[:attachments] || request_body["attachments"] || []
+      attachment_size = attachments&.sum { |attachment| attachment[:size] || 0 } || 0
+
+      if attachment_size >= FileUtils::FORM_DATA_ATTACHMENT_SIZE
+        payload, opened_files = FileUtils.build_form_request(request_body)
+      end
+
+      response = post(
+        path: "#{api_uri}/v3/grants/#{identifier}/drafts",
+        request_body: payload
+      )
+
+      opened_files.each(&:close)
+
+      response
+    end
+
+    # Update an draft.
+    #
+    # @param identifier [String] Grant ID or email account in which to update the draft.
+    # @param draft_id [String] The id of the draft to update.
+    # @param request_body [Hash] The values to create the message with.
+    #   If you're attaching files, you must pass an array of [File] objects, or
+    #   you can use {FileUtils::attach_file_request_builder} to build each object attach.
+    # @return [Array(Hash, String)] The updated draft and API Request ID.
+    def update(identifier:, draft_id:, request_body:)
+      payload = request_body
+      opened_files = []
+
+      # Use form data only if the attachment size is greater than 3mb
+      attachments = request_body[:attachments] || request_body["attachments"] || []
+      attachment_size = attachments&.sum { |attachment| attachment[:size] || 0 } || 0
+
+      if attachment_size >= FileUtils::FORM_DATA_ATTACHMENT_SIZE
+        payload, opened_files = FileUtils.build_form_request(request_body)
+      end
+
+      response = put(
+        path: "#{api_uri}/v3/grants/#{identifier}/drafts/#{draft_id}",
+        request_body: payload
+      )
+
+      opened_files.each(&:close)
+
+      response
+    end
+
+    # Delete an draft.
+    #
+    # @param identifier [String] Grant ID or email account from which to delete an object.
+    # @param draft_id [String] The id of the draft to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(identifier:, draft_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/grants/#{identifier}/drafts/#{draft_id}"
+      )
+
+      [true, request_id]
+    end
+
+    # Send an draft.
+    #
+    # @param identifier [String] Grant ID or email account from which to send the draft.
+    # @param draft_id [String] The id of the draft to send.
+    # @return [Array(Hash, String)] The sent message draft and the API Request ID.
+    def send(identifier:, draft_id:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/drafts/#{draft_id}"
+      )
+    end
+  end
+end

data/lib/nylas/resources/events.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Events API
+  class Events < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Put
+    include ApiOperations::Delete
+
+    # Return all events.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param query_params [Hash] Query params to pass to the request.
+    # @return [Array(Array(Hash), String, String)] The list of events, API Request ID, and next cursor.
+    def list(identifier:, query_params:)
+      get_list(
+        path: "#{api_uri}/v3/grants/#{identifier}/events",
+        query_params: query_params
+      )
+    end
+
+    # Return an event.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param event_id [String] The id of the event to return.
+    # @param query_params [Hash] The query parameters to include in the request
+    # @return [Array(Hash, String)] The event and API request ID.
+    def find(identifier:, event_id:, query_params:)
+      get(
+        path: "#{api_uri}/v3/grants/#{identifier}/events/#{event_id}",
+        query_params: query_params
+      )
+    end
+
+    # Create an event.
+    #
+    # @param identifier [String] Grant ID or email account in which to create the object.
+    # @param request_body [Hash] The values to create the event with.
+    # @param query_params [Hash] The query parameters to include in the request.
+    # @return [Array(Hash, String)] The created event and API Request ID.
+    def create(identifier:, request_body:, query_params:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/events",
+        query_params: query_params,
+        request_body: request_body
+      )
+    end
+
+    # Update an event.
+    #
+    # @param identifier [String] Grant ID or email account in which to update an object.
+    # @param event_id [String] The id of the event to update.
+    # @param request_body [Hash] The values to update the event with
+    # @param query_params [Hash] The query parameters to include in the request
+    # @return [Array(Hash, String)] The updated event and API Request ID.
+    def update(identifier:, event_id:, request_body:, query_params:)
+      put(
+        path: "#{api_uri}/v3/grants/#{identifier}/events/#{event_id}",
+        query_params: query_params,
+        request_body: request_body
+      )
+    end
+
+    # Delete an event.
+    #
+    # @param identifier [String] Grant ID or email account from which to delete an object.
+    # @param event_id [String] The id of the event to delete.
+    # @param query_params [Hash] The query parameters to include in the request
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(identifier:, event_id:, query_params:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/grants/#{identifier}/events/#{event_id}",
+        query_params: query_params
+      )
+
+      [true, request_id]
+    end
+
+    # Send RSVP. Allows users to respond to events they have been added to as an attendee.
+    #
+    # @param identifier [String] Grant ID or email account from which to send RSVP with.
+    # @param event_id [String] The id of the event to respond to.
+    # @param request_body [Hash] The status values to send the RSVP with.
+    # @param query_params [Hash] The query parameters to include in the request
+    # @return [(Hash, String)] Response object with the API Request ID.
+    def send_rsvp(identifier:, event_id:, request_body:, query_params:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/events/#{event_id}/send-rsvp",
+        query_params: query_params,
+        request_body: request_body
+      )
+    end
+  end
+end

data/lib/nylas/resources/folders.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Folder API
+  class Folders < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Put
+    include ApiOperations::Delete
+
+    # Return all folders.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @return [Array(Array(Hash), String, String)] The list of folders, API Request ID, and next cursor.
+    def list(identifier:)
+      get_list(
+        path: "#{api_uri}/v3/grants/#{identifier}/folders"
+      )
+    end
+
+    # Return a folder.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param folder_id [String] The id of the folder to return.
+    # @return [Array(Hash, String)] The folder and API request ID.
+    def find(identifier:, folder_id:)
+      get(
+        path: "#{api_uri}/v3/grants/#{identifier}/folders/#{folder_id}"
+      )
+    end
+
+    # Create a folder.
+    #
+    # @param identifier [String] Grant ID or email account in which to create the object.
+    # @param request_body [Hash] The values to create the folder with.
+    # @return [Array(Hash, String)] The created folder and API Request ID.
+    def create(identifier:, request_body:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/folders",
+        request_body: request_body
+      )
+    end
+
+    # Update a folder.
+    #
+    # @param identifier [String] Grant ID or email account in which to update an object.
+    # @param folder_id [String] The id of the folder to update.
+    # @param request_body [Hash] The values to update the folder with
+    # @return [Array(Hash, String)] The updated folder and API Request ID.
+    def update(identifier:, folder_id:, request_body:)
+      put(
+        path: "#{api_uri}/v3/grants/#{identifier}/folders/#{folder_id}",
+        request_body: request_body
+      )
+    end
+
+    # Delete a folder.
+    #
+    # @param identifier [String] Grant ID or email account from which to delete an object.
+    # @param folder_id [String] The id of the folder to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(identifier:, folder_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/grants/#{identifier}/folders/#{folder_id}"
+      )
+
+      [true, request_id]
+    end
+  end
+end

data/lib/nylas/resources/grants.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Grants
+  class Grants < Resource
+    include ApiOperations::Get
+    include ApiOperations::Put
+    include ApiOperations::Delete
+    include ApiOperations::Patch
+
+    # Return all grants.
+    #
+    # @param query_params [Hash, nil] Query params to pass to the request.
+    # @return [Array(Array(Hash), String)] The list of grants and API Request ID.
+    def list(query_params: nil)
+      get(
+        path: "#{api_uri}/v3/grants",
+        query_params: query_params
+      )
+    end
+
+    # Return a grant.
+    #
+    # @param grant_id [String] The id of the grant to return.
+    # @return [Array(Hash, String)] The grant and API request ID.
+    def find(grant_id:)
+      get(
+        path: "#{api_uri}/v3/grants/#{grant_id}"
+      )
+    end
+
+    # Update a grant.
+    #
+    # @param grant_id [String] The id of the grant to update.
+    # @param request_body [Hash] The values to update the grant with
+    # @return [Array(Hash, String)] The updated grant and API Request ID.
+    def update(grant_id:, request_body:)
+      patch(
+        path: "#{api_uri}/v3/grants/#{grant_id}",
+        request_body: request_body
+      )
+    end
+
+    # Delete a grant.
+    #
+    # @param grant_id [String] The id of the grant to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(grant_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/grants/#{grant_id}"
+      )
+
+      [true, request_id]
+    end
+  end
+end