nylas 5.17.0 → 6.0.0.beta.2

data/lib/nylas/resources/smart_compose.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Smart Compose API
+  class SmartCompose < Resource
+    include ApiOperations::Post
+
+    # Compose a message.
+    #
+    # @param identifier [String] Grant ID or email account to generate a message suggestion for.
+    # @param request_body [Hash] The prompt that smart compose will use to generate a message suggestion.
+    # @return [Array(Hash, String)] The generated message and API Request ID.
+    def compose_message(identifier:, request_body:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/messages/smart-compose",
+        request_body: request_body
+      )
+    end
+
+    # Compose a message reply.
+    #
+    # @param identifier [String] Grant ID or email account to generate a message suggestion for.
+    # @param message_id [String] The id of the message to reply to.
+    # @param request_body [Hash] The prompt that smart compose will use to generate a message reply.
+    # @return [Array(Hash, String)] The generated message reply and API Request ID.
+    def compose_message_reply(identifier:, message_id:, request_body:)
+      post(
+        path: "#{api_uri}/v3/grants/#{identifier}/messages/#{message_id}/smart-compose",
+        request_body: request_body
+      )
+    end
+  end
+end

data/lib/nylas/resources/threads.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Nylas Threads API
+  class Threads < Resource
+    include ApiOperations::Get
+    include ApiOperations::Put
+    include ApiOperations::Delete
+
+    # Return all threads.
+    #
+    # @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 threads and API Request ID.
+    def list(identifier:, query_params: nil)
+      get(
+        path: "#{api_uri}/v3/grants/#{identifier}/threads",
+        query_params: query_params
+      )
+    end
+
+    # Return an thread.
+    #
+    # @param identifier [String] Grant ID or email account to query.
+    # @param thread_id [String] The id of the thread to return.
+    # @return [Array(Hash, String)] The thread and API request ID.
+    def find(identifier:, thread_id:)
+      get(
+        path: "#{api_uri}/v3/grants/#{identifier}/threads/#{thread_id}"
+      )
+    end
+
+    # Update an thread.
+    #
+    # @param identifier [String] Grant ID or email account in which to update the thread.
+    # @param thread_id [String] The id of the thread to update.
+    # @param request_body [Hash] The values to update the thread with
+    # @return [Array(Hash, String)] The updated thread and API Request ID.
+    def update(identifier:, thread_id:, request_body:)
+      put(
+        path: "#{api_uri}/v3/grants/#{identifier}/threads/#{thread_id}",
+        request_body: request_body
+      )
+    end
+
+    # Delete an thread.
+    #
+    # @param identifier [String] Grant ID or email account from which to delete the thread.
+    # @param thread_id [String] The id of the thread to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(identifier:, thread_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/grants/#{identifier}/threads/#{thread_id}"
+      )
+
+      [true, request_id]
+    end
+  end
+end

data/lib/nylas/resources/webhooks.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require_relative "resource"
+require_relative "../handler/api_operations"
+
+module Nylas
+  # Module representing the possible 'trigger' values in a Webhook.
+  # @see https://developer.nylas.com/docs/api#post/a/client_id/webhooks
+  module WebhookTrigger
+    CALENDAR_CREATED = "calendar.created"
+    CALENDAR_UPDATED = "calendar.updated"
+    CALENDAR_DELETED = "calendar.deleted"
+    EVENT_CREATED = "event.created"
+    EVENT_UPDATED = "event.updated"
+    EVENT_DELETED = "event.deleted"
+    GRANT_CREATED = "grant.created"
+    GRANT_UPDATED = "grant.updated"
+    GRANT_DELETED = "grant.deleted"
+    GRANT_EXPIRED = "grant.expired"
+    MESSAGE_SEND_SUCCESS = "message.send_success"
+    MESSAGE_SEND_FAILED = "message.send_failed"
+  end
+
+  # Nylas Webhooks API
+  class Webhooks < Resource
+    include ApiOperations::Get
+    include ApiOperations::Post
+    include ApiOperations::Put
+    include ApiOperations::Delete
+
+    # Return all webhooks.
+    #
+    # @return [Array(Array(Hash), String)] The list of webhooks and API Request ID.
+    def list
+      get(
+        path: "#{api_uri}/v3/webhooks"
+      )
+    end
+
+    # Return a webhook.
+    #
+    # @param webhook_id [String] The id of the webhook to return.
+    # @return [Array(Hash, String)] The webhook and API request ID.
+    def find(webhook_id:)
+      get(
+        path: "#{api_uri}/v3/webhooks/#{webhook_id}"
+      )
+    end
+
+    # Create a webhook.
+    #
+    # @param request_body [Hash] The values to create the webhook with.
+    # @return [Array(Hash, String)] The created webhook and API Request ID.
+    def create(request_body:)
+      post(
+        path: "#{api_uri}/v3/webhooks",
+        request_body: request_body
+      )
+    end
+
+    # Update a webhook.
+    #
+    # @param webhook_id [String] The id of the webhook to update.
+    # @param request_body [Hash] The values to update the webhook with
+    # @return [Array(Hash, String)] The updated webhook and API Request ID.
+    def update(webhook_id:, request_body:)
+      put(
+        path: "#{api_uri}/v3/webhooks/#{webhook_id}",
+        request_body: request_body
+      )
+    end
+
+    # Delete a webhook.
+    #
+    # @param webhook_id [String] The id of the webhook to delete.
+    # @return [Array(TrueClass, String)] True and the API Request ID for the delete operation.
+    def destroy(webhook_id:)
+      _, request_id = delete(
+        path: "#{api_uri}/v3/webhooks/#{webhook_id}"
+      )
+
+      [true, request_id]
+    end
+  end
+end

data/lib/nylas/utils/file_utils.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require "mime/types"
+
+module Nylas
+  # A collection of file-related utilities.
+  module FileUtils
+    # Build a form request for the API.
+    # @param request_body The values to create the message with.
+    # @return The form data to send to the API and the opened files.
+    # @!visibility private
+    def self.build_form_request(request_body)
+      attachments = request_body.delete(:attachments) || request_body.delete("attachments") || []
+      message_payload = request_body.to_json
+
+      # Prepare the data to return
+      form_data = {}
+      opened_files = []
+
+      attachments.each_with_index do |attachment, index|
+        file = attachment[:content] || attachment["content"]
+        form_data.merge!({ "file#{index}" => file })
+        opened_files << file
+      end
+
+      form_data.merge!({ "multipart" => true, "message" => message_payload })
+
+      [form_data, opened_files]
+    end
+
+    # Build the request to attach a file to a message/draft object.
+    # @param file_path [String] The path to the file to attach.
+    # @return [Hash] The request that will attach the file to the message/draft
+    def self.attach_file_request_builder(file_path)
+      filename = File.basename(file_path)
+      content_type = MIME::Types.type_for(file_path).first.to_s
+      content_type = "application/octet-stream" if content_type.empty?
+      size = File.size(file_path)
+      content = File.new(file_path, "rb")
+
+      {
+        filename: filename,
+        content_type: content_type,
+        size: size,
+        content: content
+      }
+    end
+  end
+end

data/lib/nylas/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Nylas
-  VERSION = "5.17.0"
+  VERSION = "6.0.0.beta.2"
 end

data/lib/nylas.rb

@@ -7,15 +7,14 @@ require "rest-client"
 #   See https://github.com/sparklemotion/http-cookie/issues/27
 #   and https://github.com/sparklemotion/http-cookie/issues/6
 #
-# CookieJar uses unsafe class caching for dynamically loading cookie jars
-# If 2 rest-client instances are instantiated at the same time, (in threads)
-# non-deterministic behaviour can occur whereby the Hash cookie jar isn't
-# properly loaded and cached.
-# Forcing an instantiation of the jar onload will force the CookieJar to load
-# before the system has a chance to spawn any threads.
-# Note this should technically be fixed in rest-client itself however that
-# library appears to be stagnant so we're forced to fix it here
-# This object should get GC'd as it's not referenced by anything
+# CookieJar uses unsafe class caching for dynamically loading cookie jars.
+# If two rest-client instances are instantiated at the same time (in threads), non-deterministic
+# behaviour can occur whereby the Hash cookie jar isn't properly loaded and cached.
+# Forcing an instantiation of the jar onload will force the CookieJar to load before the system has
+# a chance to spawn any threads.
+# Note that this should technically be fixed in rest-client itself, however that library appears to
+# be stagnant so we're forced to fix it here.
+# This object should get GC'd as it's not referenced by anything.
 HTTP::CookieJar.new
 
 require "ostruct"
@@ -23,142 +22,25 @@ require "forwardable"
 
 require_relative "nylas/version"
 require_relative "nylas/errors"
-
-require_relative "nylas/logging"
-require_relative "nylas/registry"
-require_relative "nylas/types"
-require_relative "nylas/constraints"
-
-require_relative "nylas/http_client"
-require_relative "nylas/api"
-require_relative "nylas/collection"
-require_relative "nylas/model"
-
-# Attribute types supported by the API
-require_relative "nylas/email_address"
-require_relative "nylas/event"
-require_relative "nylas/file"
-require_relative "nylas/folder"
-require_relative "nylas/im_address"
-require_relative "nylas/label"
-require_relative "nylas/message_headers"
-require_relative "nylas/message_tracking"
-require_relative "nylas/participant"
-require_relative "nylas/physical_address"
-require_relative "nylas/phone_number"
-require_relative "nylas/recurrence"
-require_relative "nylas/rsvp"
-require_relative "nylas/timespan"
-require_relative "nylas/web_page"
-require_relative "nylas/nylas_date"
-require_relative "nylas/when"
-require_relative "nylas/free_busy"
-require_relative "nylas/time_slot"
-require_relative "nylas/time_slot_capacity"
-require_relative "nylas/open_hours"
-require_relative "nylas/event_conferencing"
-require_relative "nylas/event_conferencing_details"
-require_relative "nylas/event_conferencing_autocreate"
-require_relative "nylas/event_notification"
-require_relative "nylas/component"
-
-# Custom collection types
-require_relative "nylas/event_collection"
-require_relative "nylas/search_collection"
-require_relative "nylas/deltas_collection"
-require_relative "nylas/free_busy_collection"
-require_relative "nylas/calendar_collection"
-require_relative "nylas/component_collection"
-require_relative "nylas/scheduler_collection"
-require_relative "nylas/job_status_collection"
-require_relative "nylas/outbox"
-
-# Models supported by the API
-require_relative "nylas/account"
-require_relative "nylas/calendar"
-require_relative "nylas/contact"
-require_relative "nylas/contact_group"
-require_relative "nylas/current_account"
-require_relative "nylas/deltas"
-require_relative "nylas/delta"
-require_relative "nylas/draft"
-require_relative "nylas/message"
-require_relative "nylas/room_resource"
-require_relative "nylas/new_message"
-require_relative "nylas/raw_message"
-require_relative "nylas/thread"
-require_relative "nylas/webhook"
-require_relative "nylas/scheduler"
-require_relative "nylas/job_status"
-require_relative "nylas/token_info"
-require_relative "nylas/application_details"
-require_relative "nylas/outbox_message"
-require_relative "nylas/outbox_job_status"
-require_relative "nylas/send_grid_verified_status"
-
-# Neural specific types
-require_relative "nylas/neural"
-require_relative "nylas/neural_sentiment_analysis"
-require_relative "nylas/neural_ocr"
-require_relative "nylas/neural_categorizer"
-require_relative "nylas/neural_clean_conversation"
-require_relative "nylas/neural_contact_link"
-require_relative "nylas/neural_contact_name"
-require_relative "nylas/neural_signature_contact"
-require_relative "nylas/neural_signature_extraction"
-require_relative "nylas/neural_message_options"
-require_relative "nylas/categorize"
-require_relative "nylas/scheduler_config"
-require_relative "nylas/scheduler_time_slot"
-require_relative "nylas/scheduler_booking_request"
-require_relative "nylas/scheduler_booking_confirmation"
-
-require_relative "nylas/native_authentication"
-
-require_relative "nylas/filter_attributes"
-
-require_relative "nylas/services/tunnel"
-# an SDK for interacting with the Nylas API
-# @see https://docs.nylas.com/reference
-module Nylas
-  Types.registry[:account] = Types::ModelType.new(model: Account)
-  Types.registry[:calendar] = Types::ModelType.new(model: Calendar)
-  Types.registry[:contact] = Types::ModelType.new(model: Contact)
-  Types.registry[:delta] = DeltaType.new
-  Types.registry[:draft] = Types::ModelType.new(model: Draft)
-  Types.registry[:email_address] = Types::ModelType.new(model: EmailAddress)
-  Types.registry[:event] = Types::ModelType.new(model: Event)
-  Types.registry[:file] = Types::ModelType.new(model: File)
-  Types.registry[:folder] = Types::ModelType.new(model: Folder)
-  Types.registry[:im_address] = Types::ModelType.new(model: IMAddress)
-  Types.registry[:label] = Types::ModelType.new(model: Label)
-  Types.registry[:room_resource] = Types::ModelType.new(model: RoomResource)
-  Types.registry[:message] = Types::ModelType.new(model: Message)
-  Types.registry[:message_headers] = MessageHeadersType.new
-  Types.registry[:message_tracking] = Types::ModelType.new(model: MessageTracking)
-  Types.registry[:participant] = Types::ModelType.new(model: Participant)
-  Types.registry[:physical_address] = Types::ModelType.new(model: PhysicalAddress)
-  Types.registry[:phone_number] = Types::ModelType.new(model: PhoneNumber)
-  Types.registry[:recurrence] = Types::ModelType.new(model: Recurrence)
-  Types.registry[:thread] = Types::ModelType.new(model: Thread)
-  Types.registry[:timespan] = Types::ModelType.new(model: Timespan)
-  Types.registry[:web_page] = Types::ModelType.new(model: WebPage)
-  Types.registry[:nylas_date] = NylasDateType.new
-  Types.registry[:contact_group] = Types::ModelType.new(model: ContactGroup)
-  Types.registry[:when] = Types::ModelType.new(model: When)
-  Types.registry[:time_slot] = Types::ModelType.new(model: TimeSlot)
-  Types.registry[:time_slot_capacity] = Types::ModelType.new(model: TimeSlotCapacity)
-  Types.registry[:event_conferencing] = Types::ModelType.new(model: EventConferencing)
-  Types.registry[:event_conferencing_details] = Types::ModelType.new(model: EventConferencingDetails)
-  Types.registry[:event_conferencing_autocreate] = Types::ModelType.new(model: EventConferencingAutocreate)
-  Types.registry[:event_notification] = Types::ModelType.new(model: EventNotification)
-  Types.registry[:neural] = Types::ModelType.new(model: Neural)
-  Types.registry[:categorize] = Types::ModelType.new(model: Categorize)
-  Types.registry[:neural_signature_contact] = Types::ModelType.new(model: NeuralSignatureContact)
-  Types.registry[:neural_contact_link] = Types::ModelType.new(model: NeuralContactLink)
-  Types.registry[:neural_contact_name] = Types::ModelType.new(model: NeuralContactName)
-  Types.registry[:scheduler_config] = Types::ModelType.new(model: SchedulerConfig)
-  Types.registry[:scheduler_time_slot] = Types::ModelType.new(model: SchedulerTimeSlot)
-  Types.registry[:job_status] = Types::ModelType.new(model: JobStatus)
-  Types.registry[:outbox_message] = Types::ModelType.new(model: OutboxMessage)
-end
+require_relative "nylas/client"
+require_relative "nylas/config"
+
+require_relative "nylas/handler/http_client"
+
+require_relative "nylas/resources/applications"
+require_relative "nylas/resources/attachments"
+require_relative "nylas/resources/auth"
+require_relative "nylas/resources/calendars"
+require_relative "nylas/resources/connectors"
+require_relative "nylas/resources/credentials"
+require_relative "nylas/resources/drafts"
+require_relative "nylas/resources/events"
+require_relative "nylas/resources/folders"
+require_relative "nylas/resources/grants"
+require_relative "nylas/resources/messages"
+require_relative "nylas/resources/smart_compose"
+require_relative "nylas/resources/threads"
+require_relative "nylas/resources/redirect_uris"
+require_relative "nylas/resources/webhooks"
+
+require_relative "nylas/utils/file_utils"