nylas 5.14.0 → 5.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c0c54fb8e13535027a5f3a6eda146fcf5d71c91b093877c2729d96ae0b2b1292
-  data.tar.gz: 9b9457001de3dc893352b50909269d83e418e96b4d9eb09cac23d992217af532
+  metadata.gz: b432f464fcd9fec327a4aa014c499cadcf34aa8c4626ae1585d32b4aff9c7b21
+  data.tar.gz: 5c62a00ba6e2f1de70346aa7fe4cdb7d7a129c6b91c76a35c6349e9597ab51c0
 SHA512:
-  metadata.gz: d9ba9746e31db9afd0de0e11180fd547895ee1454b8483b6234ace01a57477a6c9ba26db27ca2c7785e07cc80176b115a34ee0b1a3dc9040e5d21105f1b01704
-  data.tar.gz: d25d687696cbc5f6cc95b5e9aadaaf3ad26af664f2550436616997091a7d55d42c519424657e11f1eb008b6cb79496ab83169abc2978f8d6a9be50adc0ce6642
+  metadata.gz: 5220e063570324c94c8baf4e01645017510e497619382e2f872f110d9fbfa9f7c454b50bd87098382f0339cb6da2208eb45e3e6b622c92db330c978a85887f5e
+  data.tar.gz: 0e9388e8c5b7931212bbcdc1b21d324b4025634665aff3a3c3be7bf08f823d08c9b2b820d203287e4dfabaf3b95737a070cc8cb6957b86b80f0dd45dc5e3711d

data/lib/nylas/services/tunnel.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+require "securerandom"
+require "faye/websocket"
+require "eventmachine"
+
+module Nylas
+  # Class containing methods to spin up a developmental websocket connection to test webhooks
+  class Tunnel
+    # Open a webhook tunnel and register it with the Nylas API
+    # 1. Creates a UUID
+    # 2. Opens a websocket connection to Nylas' webhook forwarding service, with the UUID as a header
+    # 3. Creates a new webhook pointed at the forwarding service with the UUID as the path
+    # When an event is received by the forwarding service, it will push directly to this websocket connection
+    #
+    # @param api [Nylas::API] The configured Nylas API client
+    # @param config [Hash] Configuration for the webhook tunnel, including callback functions, region, and
+    #   events to subscribe to
+    def self.open_webhook_tunnel(api, config = {})
+      tunnel_id = SecureRandom.uuid
+      triggers = config[:triggers] || WebhookTrigger.constants(false).map { |c| WebhookTrigger.const_get c }
+      region = config[:region] || "us"
+      websocket_domain = "tunnel.nylas.com"
+      callback_domain = "cb.nylas.com"
+
+      EM.run do
+        setup_websocket_client(websocket_domain, api, tunnel_id, region, config)
+        register_webhook_callback(api, callback_domain, tunnel_id, triggers)
+      end
+    end
+
+    # Register callback with the Nylas forwarding service which will pass messages to the websocket
+    # @param api [Nylas::API] The configured Nylas API client
+    # @param callback_domain [String] The domain name of the callback
+    # @param tunnel_path [String] The path to the tunnel
+    # @param triggers [Array<WebhookTrigger>] The list of triggers to subscribe to
+    # @return [Nylas::Webhook] The webhook details response from the API
+    def self.register_webhook_callback(api, callback_domain, tunnel_path, triggers)
+      callback_url = "https://#{callback_domain}/#{tunnel_path}"
+
+      api.webhooks.create(
+        callback_url: callback_url,
+        state: WebhookState::ACTIVE,
+        triggers: triggers
+      )
+    end
+
+    # Setup the websocket client and register the callbacks
+    # @param websocket_domain [String] The domain of the websocket to connect to
+    # @param api [Nylas::API] The configured Nylas API client
+    # @param tunnel_id [String] The ID of the tunnel
+    # @param region [String] The Nylas region to configure for
+    # @param config [Hash] The object containing all the callback methods
+    # @return [WebSocket::Client] The configured websocket client
+    def self.setup_websocket_client(websocket_domain, api, tunnel_id, region, config)
+      ws = Faye::WebSocket::Client.new(
+        "wss://#{websocket_domain}",
+        [],
+        {
+          headers: {
+            "Client-Id" => api.client.app_id,
+            "Client-Secret" => api.client.app_secret,
+            "Tunnel-Id" => tunnel_id,
+            "Region" => region
+          }
+        }
+      )
+
+      ws.on :open do |event|
+        config[:on_open].call(event) if callable(config[:on_open])
+      end
+
+      ws.on :close do |close|
+        config[:on_close].call(close) if callable(config[:on_close])
+        EM.stop
+      end
+
+      ws.on :error do |error|
+        config[:on_error].call(error) if callable(config[:on_error])
+      end
+
+      ws.on :message do |message|
+        deltas = parse_deltas_from_message(message)
+        next if deltas.nil?
+
+        deltas.each do |delta|
+          delta = merge_and_create_delta(delta)
+          config[:on_message].call(delta) if callable(config[:on_message])
+        end
+      end
+
+      ws
+    end
+
+    # Check if the object is a method
+    # @param obj [Any] The object to check
+    # @return [Boolean] True if the object is a method
+    def self.callable(obj)
+      !obj.nil? && obj.respond_to?(:call)
+    end
+
+    # Parse deltas from the message object
+    # @param message [Any] The message object containing the deltas
+    # @return [Hash] The parsed list of deltas
+    def self.parse_deltas_from_message(message)
+      return unless message.data
+
+      json = JSON.parse(message.data)
+      JSON.parse(json["body"])["deltas"]
+    end
+
+    # Clean up and create the delta object
+    # @param delta [Hash] The hash containing the delta attributes from the API
+    # @return [Nylas::Delta] The delta object
+    def self.merge_and_create_delta(delta)
+      object_data = delta.delete("object_data")
+      attributes = object_data.delete("attributes")
+      object_data["object_attributes"] = attributes
+      delta = delta.merge(object_data).transform_keys(&:to_sym)
+      Delta.new(**delta)
+    end
+
+    private_class_method :setup_websocket_client,
+                         :callable,
+                         :parse_deltas_from_message,
+                         :merge_and_create_delta
+  end
+end

data/lib/nylas/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Nylas
-  VERSION = "5.14.0"
+  VERSION = "5.15.0"
 end

data/lib/nylas.rb

@@ -116,6 +116,8 @@ 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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nylas
 version: !ruby/object:Gem::Version
-  version: 5.14.0
+  version: 5.15.0
 platform: ruby
 authors:
 - Nylas, Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-16 00:00:00.000000000 Z
+date: 2023-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -80,20 +80,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.7.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: overcommit
   requirement: !ruby/object:Gem::Requirement
@@ -114,42 +100,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.4
+        version: 0.14.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.10.4
+        version: 0.14.1
 - !ruby/object:Gem::Dependency
   name: pry-nav
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.4
+        version: 1.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.2.4
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pry-stack_explorer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.9
+        version: 0.4.9.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.9
+        version: 0.4.9.3
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -248,6 +234,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.1.0
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.2.7
+  type: :runtime
+  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: :runtime
+  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
@@ -268,6 +282,20 @@ dependencies:
     - - "<"
       - !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: :runtime
+  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
@@ -373,6 +401,7 @@ files:
 - lib/nylas/scheduler_time_slot.rb
 - lib/nylas/search_collection.rb
 - lib/nylas/send_grid_verified_status.rb
+- lib/nylas/services/tunnel.rb
 - lib/nylas/thread.rb
 - lib/nylas/time_slot.rb
 - lib/nylas/time_slot_capacity.rb