nylas 6.0.0.beta.1 → 6.0.0.beta.3

data/lib/nylas/resources/calendars.rb

@@ -1,31 +1,101 @@
 # frozen_string_literal: true
 
 require_relative "resource"
-require_relative "../handler/grants_api_operations"
+require_relative "../handler/api_operations"
 
 module Nylas
-  # Calendars
+  # Nylas Calendar API
   class Calendars < Resource
-    include GrantsApiOperations::Create
-    include GrantsApiOperations::Update
-    include GrantsApiOperations::List
-    include GrantsApiOperations::Destroy
-    include GrantsApiOperations::Find
-
-    # Initializes Calendars.
-    def initialize(sdk_instance)
-      super("calendars", sdk_instance)
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Put
+    include ApiOperations::Delete
+
+    # Return all calendars.
+    #
+    # @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)] The list of calendars and API Request ID.
+    def list(identifier:, query_params: nil)
+      get(
+        path: "#{api_uri}/v3/grants/#{identifier}/calendars",
+        query_params: query_params
+      )
+    end
+
+    # Return a calendar.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param calendar_id [String] The id of the calendar to return.
+    #   Use "primary" to refer to the primary calendar associated with grant.
+    # @return [Array(Hash, String)] The calendar and API request ID.
+    def find(identifier:, calendar_id:)
+      get(
+        path: "#{api_uri}/v3/grants/#{identifier}/calendars/#{calendar_id}"
+      )
+    end
+
+    # Create a calendar.
+    #
+    # @param identifier [String] Grant ID or email account in which to create the object.
+    # @param request_body [Hash] The values to create the calendar with.
+    # @return [Array(Hash, String)] The created calendar and API Request ID.
+    def create(identifier:, request_body:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/calendars",
+        request_body: request_body
+      )
+    end
+
+    # Update a calendar.
+    #
+    # @param identifier [String] Grant ID or email account in which to update an object.
+    # @param calendar_id [String] The id of the calendar to update.
+    #   Use "primary" to refer to the primary calendar associated with grant.
+    # @param request_body [Hash] The values to update the calendar with
+    # @return [Array(Hash, String)] The updated calendar and API Request ID.
+    def update(identifier:, calendar_id:, request_body:)
+      put(
+        path: "#{api_uri}/v3/grants/#{identifier}/calendars/#{calendar_id}",
+        request_body: request_body
+      )
+    end
+
+    # Delete a calendar.
+    #
+    # @param identifier [String] Grant ID or email account from which to delete an object.
+    # @param calendar_id [String] The id of the calendar to delete.
+    #   Use "primary" to refer to the primary calendar associated with grant.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(identifier:, calendar_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/grants/#{identifier}/calendars/#{calendar_id}"
+      )
+
+      [true, request_id]
     end
 
     # Checks multiple calendars to find available time slots for a single meeting.
     #
-    # @param request_body [Hash, nil] Request body to pass to the request.
+    # @param request_body [Hash] Request body to pass to the request.
     # @return [Array(Hash, String)] Availability object and API request ID.
-    def get_availability(request_body: nil)
+    def get_availability(request_body:)
       post(
         path: "#{api_uri}/v3/calendars/availability",
         request_body: request_body
       )
     end
+
+    # Get the free/busy schedule for a list of email addresses.
+    #
+    # @param identifier [str] The identifier of the grant to act upon.
+    # @param request_body [Hash] Request body to pass to the request.
+    # @return [Array(Array(Hash), String)] The free/busy response.
+    def get_free_busy(identifier:, request_body:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/calendars/free-busy",
+        request_body: request_body
+      )
+    end
   end
 end

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::Put
+    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:)
+      put(
+        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)] The list of contacts and API Request ID.
+    def list(identifier:, query_params: nil)
+      get(
+        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)] The list of contact groups and API Request ID.
+    def contact_groups(identifier:, query_params: nil)
+      get(
+        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::Put
+    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:)
+      put(
+        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,102 @@
+# 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)] The list of drafts and API Request ID.
+    def list(identifier:, query_params: nil)
+      get(
+        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:)
+      form_body, opened_files = FileUtils.build_form_request(request_body)
+      response = post(
+        path: "#{api_uri}/v3/grants/#{identifier}/drafts",
+        request_body: form_body
+      )
+
+      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:)
+      form_body, opened_files = FileUtils.build_form_request(request_body)
+
+      response = put(
+        path: "#{api_uri}/v3/grants/#{identifier}/drafts/#{draft_id}",
+        request_body: form_body
+      )
+
+      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

@@ -1,20 +1,98 @@
 # frozen_string_literal: true
 
 require_relative "resource"
-require_relative "../handler/grants_api_operations"
+require_relative "../handler/api_operations"
 
 module Nylas
-  # Events
+  # Nylas Events API
   class Events < Resource
-    include GrantsApiOperations::Create
-    include GrantsApiOperations::Update
-    include GrantsApiOperations::List
-    include GrantsApiOperations::Destroy
-    include GrantsApiOperations::Find
-
-    # Initializes Events.
-    def initialize(sdk_instance)
-      super("events", sdk_instance)
+    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)] The list of events and API Request ID.
+    def list(identifier:, query_params:)
+      get(
+        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] 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)] The list of folders and API Request ID.
+    def list(identifier:)
+      get(
+        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