Add events import function to the RubySDK (#513)

* Add events import function to the RubySDK

* PR comments resolve

---------

Co-authored-by: Aaron de Mello <314152+AaronDDM@users.noreply.github.com>

Author: kraju3

lib/nylas/resources/events.rb

@@ -94,5 +94,19 @@ def send_rsvp(identifier:, event_id:, request_body:, query_params:)
         request_body: request_body
       )
     end
+
+    # Returns a list of recurring events, recurring event exceptions, and single events
+    # from the specified calendar within a given time frame. This is useful when you
+    # want to import, store, and synchronize events from the time frame to your application
+    #
+    # @param identifier [String] Grant ID or email account to import events from.
+    # @param query_params [Hash] The query parameters to include in the request
+    # @return [(Array(Hash), String, String)] The list of events, API Request ID, and next cursor.
+    def list_import_events(identifier:, query_params:)
+      get_list(
+        path: "#{api_uri}/v3/grants/#{identifier}/events/import",
+        query_params: query_params
+      )
+    end
   end
 end

spec/nylas/resources/events_spec.rb

@@ -174,4 +174,38 @@
                        query_params: query_params)
     end
   end
+
+  describe "#events_import" do
+    let(:identifier) { "grant-123" }
+    let(:query_params) { { calendar_id: "cal-123", start_time: 1234567890, end_time: 1234599999 } }
+
+    it "calls get_list with the correct parameters" do
+      allow(events).to receive(:get_list)
+        .with(
+          path: "#{api_uri}/v3/grants/#{identifier}/events/import",
+          query_params: query_params
+        )
+        .and_return([[], "request-id", "next-cursor"])
+
+      result = events.list_import_events(identifier: identifier, query_params: query_params)
+      expect(result).to eq([[], "request-id", "next-cursor"])
+    end
+
+    it "returns events, request_id and cursor" do
+      expected_response = [
+        [{ "id" => "event-123", "title" => "Test Event" }],
+        "request-id-abc",
+        "next-cursor-xyz"
+      ]
+
+      allow(events).to receive(:get_list).and_return(expected_response)
+
+      response = events.list_import_events(identifier: identifier, query_params: query_params)
+
+      expect(response).to eq(expected_response)
+      expect(response[0]).to be_an(Array)
+      expect(response[1]).to be_a(String)
+      expect(response[2]).to be_a(String)
+    end
+  end
 end