nylas-legacy 5.17.0 → 5.18.0

data/lib/nylas-legacy/webhook.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+module WebhookState
+  # Module representing the possible 'state' values in a Webhook
+  # @see https://developer.nylas.com/docs/api#post/a/client_id/webhooks
+
+  ACTIVE = "active"
+  INACTIVE = "inactive"
+end
+
+module WebhookTrigger
+  # Module representing the possible 'trigger' values in a Webhook
+  # @see https://developer.nylas.com/docs/api#post/a/client_id/webhooks
+
+  ACCOUNT_CONNECTED = "account.connected"
+  ACCOUNT_RUNNING = "account.running"
+  ACCOUNT_STOPPED = "account.stopped"
+  ACCOUNT_INVALID = "account.invalid"
+  ACCOUNT_SYNC_ERROR = "account.sync_error"
+  MESSAGE_CREATED = "message.created"
+  MESSAGE_OPENED = "message.opened"
+  MESSAGE_LINK_CLICKED = "message.link_clicked"
+  MESSAGE_UPDATED = "message.updated"
+  MESSAGE_BOUNCED = "message.bounced"
+  THREAD_REPLIED = "thread.replied"
+  CONTACT_CREATED = "contact.created"
+  CONTACT_UPDATED = "contact.updated"
+  CONTACT_DELETED = "contact.deleted"
+  CALENDAR_CREATED = "calendar.created"
+  CALENDAR_UPDATED = "calendar.updated"
+  CALENDAR_DELETED = "calendar.deleted"
+  EVENT_CREATED = "event.created"
+  EVENT_UPDATED = "event.updated"
+  EVENT_DELETED = "event.deleted"
+  JOB_SUCCESSFUL = "job.successful"
+  JOB_FAILED = "job.failed"
+  JOB_DELAYED = "job.delayed"
+  JOB_CANCELLED = "job.cancelled"
+end
+
+module NylasLegacy
+  # Represents a webhook attached to your application.
+  # @see https://docs.nylas.com/reference#webhooks
+  class Webhook
+    require "openssl"
+    include Model
+    self.creatable = true
+    self.listable = true
+    self.showable = true
+    self.updatable = true
+    self.destroyable = true
+    self.auth_method = HttpClient::AuthMethod::BASIC
+    attribute :id, :string, read_only: true
+    attribute :application_id, :string, read_only: true
+
+    attribute :callback_url, :string
+    attribute :state, :string
+    attribute :version, :string, read_only: true
+    has_n_of_attribute :triggers, :string
+
+    STATE = [:inactive].freeze
+
+    def save
+      result = if persisted?
+                 update_call(update_payload)
+               else
+                 create
+               end
+
+      attributes.merge(result)
+    end
+
+    def save_all_attributes
+      save
+    end
+
+    def update(**data)
+      raise ArgumentError, "Only 'state' is allowed to be updated" if data.length > 1 || !data.key?(:state)
+
+      attributes.merge(**data)
+      payload = JSON.dump(data)
+      update_call(payload)
+
+      true
+    end
+
+    def update_all_attributes(**data)
+      update(**data)
+    end
+
+    def self.resources_path(api:)
+      "/a/#{api.app_id}/webhooks"
+    end
+
+    # Verify incoming webhook signature came from Nylas
+    # @param nylas_signature [str] The signature to verify
+    # @param raw_body [str] The raw body from the payload
+    # @param client_secret [str] Client secret of the app receiving the webhook
+    # @return [Boolean] True if the webhook signature was verified from Nylas
+    def self.verify_webhook_signature(nylas_signature, raw_body, client_secret)
+      digest = OpenSSL::HMAC.hexdigest("SHA256", client_secret, raw_body)
+      digest == nylas_signature
+    end
+
+    private
+
+    def update_payload
+      JSON.dump({ state: state })
+    end
+  end
+end

data/lib/nylas-legacy/when.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module NylasLegacy
+  require "tzinfo"
+
+  # Structure to represent all the Nylas time types.
+  # @see https://docs.nylas.com/reference#section-time
+  class When
+    extend Forwardable
+
+    include Model::Attributable
+
+    attribute :object, :string, read_only: true
+
+    # when object == 'date'
+    attribute :date, :date
+
+    # when object == 'datespan'
+    attribute :start_date, :date
+    attribute :end_date, :date
+
+    # when object == 'time'
+    attribute :time, :unix_timestamp
+    # Timezone must be set to a valid IANA database timezone name
+    attribute :timezone, :string
+
+    # when object == 'timespan'
+    attribute :start_time, :unix_timestamp
+    attribute :end_time, :unix_timestamp
+    # Both timezone fields must be set to a valid IANA database timezone name
+    attribute :start_timezone, :string
+    attribute :end_timezone, :string
+
+    def_delegators :range, :cover?
+
+    def as_timespan
+      return unless object == "timespan"
+
+      Timespan.new(object: object, start_time: start_time, end_time: end_time)
+    end
+
+    def range
+      case object
+      when "timespan"
+        Range.new(start_time, end_time)
+      when "datespan"
+        Range.new(start_date, end_date)
+      when "date"
+        Range.new(date, date)
+      when "time"
+        Range.new(time, time)
+      end
+    end
+
+    # Validates the When object
+    # @return [Boolean] True if the When is valid
+    # @raise [ArgumentError] If any of the timezone fields are not valid IANA database names
+    def valid?
+      validate_timezone(timezone) if timezone
+      validate_timezone(start_timezone) if start_timezone
+      validate_timezone(end_timezone) if end_timezone
+
+      true
+    end
+
+    private
+
+    def validate_timezone(timezone_var)
+      return if TZInfo::Timezone.all_identifiers.include?(timezone_var)
+
+      raise ArgumentError,
+            format("The timezone provided (%s) is not a valid IANA timezone database name", timezone_var)
+    end
+  end
+end

data/lib/nylas-legacy.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+require "json"
+require "rest-client"
+
+# BUGFIX
+#   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
+HTTP::CookieJar.new
+
+require "ostruct"
+require "forwardable"
+
+require_relative "nylas-legacy/version"
+require_relative "nylas-legacy/errors"
+
+require_relative "nylas-legacy/logging"
+require_relative "nylas-legacy/registry"
+require_relative "nylas-legacy/types"
+require_relative "nylas-legacy/constraints"
+
+require_relative "nylas-legacy/http_client"
+require_relative "nylas-legacy/api"
+require_relative "nylas-legacy/collection"
+require_relative "nylas-legacy/model"
+
+# Attribute types supported by the API
+require_relative "nylas-legacy/email_address"
+require_relative "nylas-legacy/event"
+require_relative "nylas-legacy/file"
+require_relative "nylas-legacy/folder"
+require_relative "nylas-legacy/im_address"
+require_relative "nylas-legacy/label"
+require_relative "nylas-legacy/message_headers"
+require_relative "nylas-legacy/message_tracking"
+require_relative "nylas-legacy/participant"
+require_relative "nylas-legacy/physical_address"
+require_relative "nylas-legacy/phone_number"
+require_relative "nylas-legacy/recurrence"
+require_relative "nylas-legacy/rsvp"
+require_relative "nylas-legacy/timespan"
+require_relative "nylas-legacy/web_page"
+require_relative "nylas-legacy/nylas_date"
+require_relative "nylas-legacy/when"
+require_relative "nylas-legacy/free_busy"
+require_relative "nylas-legacy/time_slot"
+require_relative "nylas-legacy/time_slot_capacity"
+require_relative "nylas-legacy/open_hours"
+require_relative "nylas-legacy/event_conferencing"
+require_relative "nylas-legacy/event_conferencing_details"
+require_relative "nylas-legacy/event_conferencing_autocreate"
+require_relative "nylas-legacy/event_notification"
+require_relative "nylas-legacy/component"
+
+# Custom collection types
+require_relative "nylas-legacy/event_collection"
+require_relative "nylas-legacy/search_collection"
+require_relative "nylas-legacy/deltas_collection"
+require_relative "nylas-legacy/free_busy_collection"
+require_relative "nylas-legacy/calendar_collection"
+require_relative "nylas-legacy/component_collection"
+require_relative "nylas-legacy/scheduler_collection"
+require_relative "nylas-legacy/job_status_collection"
+require_relative "nylas-legacy/outbox"
+
+# Models supported by the API
+require_relative "nylas-legacy/account"
+require_relative "nylas-legacy/calendar"
+require_relative "nylas-legacy/contact"
+require_relative "nylas-legacy/contact_group"
+require_relative "nylas-legacy/current_account"
+require_relative "nylas-legacy/deltas"
+require_relative "nylas-legacy/delta"
+require_relative "nylas-legacy/draft"
+require_relative "nylas-legacy/message"
+require_relative "nylas-legacy/room_resource"
+require_relative "nylas-legacy/new_message"
+require_relative "nylas-legacy/raw_message"
+require_relative "nylas-legacy/thread"
+require_relative "nylas-legacy/webhook"
+require_relative "nylas-legacy/scheduler"
+require_relative "nylas-legacy/job_status"
+require_relative "nylas-legacy/token_info"
+require_relative "nylas-legacy/application_details"
+require_relative "nylas-legacy/outbox_message"
+require_relative "nylas-legacy/outbox_job_status"
+require_relative "nylas-legacy/send_grid_verified_status"
+
+# Neural specific types
+require_relative "nylas-legacy/neural"
+require_relative "nylas-legacy/neural_sentiment_analysis"
+require_relative "nylas-legacy/neural_ocr"
+require_relative "nylas-legacy/neural_categorizer"
+require_relative "nylas-legacy/neural_clean_conversation"
+require_relative "nylas-legacy/neural_contact_link"
+require_relative "nylas-legacy/neural_contact_name"
+require_relative "nylas-legacy/neural_signature_contact"
+require_relative "nylas-legacy/neural_signature_extraction"
+require_relative "nylas-legacy/neural_message_options"
+require_relative "nylas-legacy/categorize"
+require_relative "nylas-legacy/scheduler_config"
+require_relative "nylas-legacy/scheduler_time_slot"
+require_relative "nylas-legacy/scheduler_booking_request"
+require_relative "nylas-legacy/scheduler_booking_confirmation"
+
+require_relative "nylas-legacy/native_authentication"
+
+require_relative "nylas-legacy/filter_attributes"
+
+require_relative "nylas-legacy/services/tunnel"
+# an SDK for interacting with the Nylas API
+# @see https://docs.nylas.com/reference
+module NylasLegacy
+  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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nylas-legacy
 version: !ruby/object:Gem::Version
-  version: 5.17.0
+  version: 5.18.0
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-05-28 00:00:00.000000000 Z
+date: 2024-06-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -94,6 +94,88 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.41'
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.7
+- !ruby/object:Gem::Dependency
+  name: faye-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.1
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: tzinfo
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.0.5
+- !ruby/object:Gem::Dependency
+  name: yajl-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -321,7 +403,97 @@ email: support@nylas.com
 executables: []
 extensions: []
 extra_rdoc_files: []
-files: []
+files:
+- lib/nylas-legacy.rb
+- lib/nylas-legacy/account.rb
+- lib/nylas-legacy/api.rb
+- lib/nylas-legacy/application_details.rb
+- lib/nylas-legacy/calendar.rb
+- lib/nylas-legacy/calendar_collection.rb
+- lib/nylas-legacy/categorize.rb
+- lib/nylas-legacy/collection.rb
+- lib/nylas-legacy/component.rb
+- lib/nylas-legacy/component_collection.rb
+- lib/nylas-legacy/constraints.rb
+- lib/nylas-legacy/contact.rb
+- lib/nylas-legacy/contact_group.rb
+- lib/nylas-legacy/current_account.rb
+- lib/nylas-legacy/delta.rb
+- lib/nylas-legacy/deltas.rb
+- lib/nylas-legacy/deltas_collection.rb
+- lib/nylas-legacy/draft.rb
+- lib/nylas-legacy/email_address.rb
+- lib/nylas-legacy/errors.rb
+- lib/nylas-legacy/event.rb
+- lib/nylas-legacy/event_collection.rb
+- lib/nylas-legacy/event_conferencing.rb
+- lib/nylas-legacy/event_conferencing_autocreate.rb
+- lib/nylas-legacy/event_conferencing_details.rb
+- lib/nylas-legacy/event_notification.rb
+- lib/nylas-legacy/file.rb
+- lib/nylas-legacy/filter_attributes.rb
+- lib/nylas-legacy/folder.rb
+- lib/nylas-legacy/free_busy.rb
+- lib/nylas-legacy/free_busy_collection.rb
+- lib/nylas-legacy/http_client.rb
+- lib/nylas-legacy/im_address.rb
+- lib/nylas-legacy/job_status.rb
+- lib/nylas-legacy/job_status_collection.rb
+- lib/nylas-legacy/label.rb
+- lib/nylas-legacy/logging.rb
+- lib/nylas-legacy/message.rb
+- lib/nylas-legacy/message_headers.rb
+- lib/nylas-legacy/message_tracking.rb
+- lib/nylas-legacy/model.rb
+- lib/nylas-legacy/model/attributable.rb
+- lib/nylas-legacy/model/attribute_definition.rb
+- lib/nylas-legacy/model/attributes.rb
+- lib/nylas-legacy/model/list_attribute_definition.rb
+- lib/nylas-legacy/model/transferable.rb
+- lib/nylas-legacy/native_authentication.rb
+- lib/nylas-legacy/neural.rb
+- lib/nylas-legacy/neural_categorizer.rb
+- lib/nylas-legacy/neural_clean_conversation.rb
+- lib/nylas-legacy/neural_contact_link.rb
+- lib/nylas-legacy/neural_contact_name.rb
+- lib/nylas-legacy/neural_message_options.rb
+- lib/nylas-legacy/neural_ocr.rb
+- lib/nylas-legacy/neural_sentiment_analysis.rb
+- lib/nylas-legacy/neural_signature_contact.rb
+- lib/nylas-legacy/neural_signature_extraction.rb
+- lib/nylas-legacy/new_message.rb
+- lib/nylas-legacy/nylas_date.rb
+- lib/nylas-legacy/open_hours.rb
+- lib/nylas-legacy/outbox.rb
+- lib/nylas-legacy/outbox_job_status.rb
+- lib/nylas-legacy/outbox_message.rb
+- lib/nylas-legacy/participant.rb
+- lib/nylas-legacy/phone_number.rb
+- lib/nylas-legacy/physical_address.rb
+- lib/nylas-legacy/raw_message.rb
+- lib/nylas-legacy/recurrence.rb
+- lib/nylas-legacy/registry.rb
+- lib/nylas-legacy/room_resource.rb
+- lib/nylas-legacy/rsvp.rb
+- lib/nylas-legacy/scheduler.rb
+- lib/nylas-legacy/scheduler_booking_confirmation.rb
+- lib/nylas-legacy/scheduler_booking_request.rb
+- lib/nylas-legacy/scheduler_collection.rb
+- lib/nylas-legacy/scheduler_config.rb
+- lib/nylas-legacy/scheduler_time_slot.rb
+- lib/nylas-legacy/search_collection.rb
+- lib/nylas-legacy/send_grid_verified_status.rb
+- lib/nylas-legacy/services/tunnel.rb
+- lib/nylas-legacy/thread.rb
+- lib/nylas-legacy/time_slot.rb
+- lib/nylas-legacy/time_slot_capacity.rb
+- lib/nylas-legacy/timespan.rb
+- lib/nylas-legacy/token_info.rb
+- lib/nylas-legacy/types.rb
+- lib/nylas-legacy/version.rb
+- lib/nylas-legacy/web_page.rb
+- lib/nylas-legacy/webhook.rb
+- lib/nylas-legacy/when.rb
 homepage:
 licenses:
 - MIT