test_sdk 0.0.4

data/lib/test_sdk/file/client.rb

@@ -0,0 +1,692 @@
+# frozen_string_literal: true
+
+require_relative "../../requests"
+require_relative "../types/file_type"
+require_relative "../types/create_file_response"
+require_relative "../../core/file_utilities"
+require_relative "../types/create_file_for_signed_url_response"
+require_relative "../types/paginated_response_file_response"
+require_relative "../types/file_response"
+require "json"
+require_relative "../types/gcs_signed_url_response"
+require "async"
+
+module NewDemoApiClient
+  class FileClient
+    # @return [NewDemoApiClient::RequestClient]
+    attr_reader :request_client
+
+    # @param request_client [NewDemoApiClient::RequestClient]
+    # @return [NewDemoApiClient::FileClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # Upload a file for a specific group and deal. Creates a file entry as well as
+    #  uploads its contents.
+    #  NOTE: Uploads are limited to 10 GB. For larger file uploads use the signed-url
+    #  upload endpoint.
+    #
+    # @param deal_id [Integer]
+    # @param group_id [Integer]
+    # @param file [String, IO]
+    # @param name [String]
+    # @param filetype [NewDemoApiClient::FileType]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::CreateFileResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.upload(
+    #    deal_id: 1,
+    #    group_id: 1,
+    #    file: my_file.txt
+    #  )
+    def upload(deal_id:, group_id:, file:, name:, filetype:, request_options: nil)
+      response = @request_client.conn.post do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = {
+          **(request_options&.additional_body_parameters || {}),
+          file: NewDemoApiClient::FileUtilities.as_faraday_multipart(file_like: file),
+          name: name,
+          filetype: filetype
+        }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{group_id}/file"
+      end
+      NewDemoApiClient::CreateFileResponse.from_json(json_object: response.body)
+    end
+
+    # Create a new file entry for a specific group and deal. Requires the contents to
+    #  be uploaded separately via signed-url.
+    #
+    # @param deal_id [Integer]
+    # @param group_id [Integer]
+    # @param name [String] The huamn-readable name of the file
+    # @param type [NewDemoApiClient::FileType] The type of the file
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::CreateFileForSignedURLResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.create_file_entry(
+    #    deal_id: 1,
+    #    group_id: 1,
+    #    name: "name"
+    #  )
+    def create_file_entry(deal_id:, group_id:, name:, type: nil, request_options: nil)
+      response = @request_client.conn.post do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = { **(request_options&.additional_body_parameters || {}), name: name, type: type }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{group_id}/file/entry"
+      end
+      NewDemoApiClient::CreateFileForSignedURLResponse.from_json(json_object: response.body)
+    end
+
+    # Get all files for a specific group and deal.
+    #
+    # @param deal_id [Integer]
+    # @param group_id [Integer]
+    # @param sort_by [String]
+    # @param sort_order [String]
+    # @param page [Integer]
+    # @param page_size [Integer]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::PaginatedResponseFileResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.list(deal_id: 1, group_id: 1)
+    def list(deal_id:, group_id:, sort_by: nil, sort_order: nil, page: nil, page_size: nil, request_options: nil)
+      response = @request_client.conn.get do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        req.params = {
+          **(request_options&.additional_query_parameters || {}),
+          "sort_by": sort_by,
+          "sort_order": sort_order,
+          "page": page,
+          "page_size": page_size
+        }.compact
+        unless request_options.nil? || request_options&.additional_body_parameters.nil?
+          req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+        end
+        req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{group_id}/file/all"
+      end
+      NewDemoApiClient::PaginatedResponseFileResponse.from_json(json_object: response.body)
+    end
+
+    # Get a file by its ID for a specific group and deal.
+    #
+    # @param deal_id [Integer]
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::FileResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.get(
+    #    deal_id: 1,
+    #    file_id: 1,
+    #    group_id: 1
+    #  )
+    def get(deal_id:, file_id:, group_id:, request_options: nil)
+      response = @request_client.conn.get do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        unless request_options.nil? || request_options&.additional_body_parameters.nil?
+          req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+        end
+        req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{file_id}/file/#{group_id}"
+      end
+      NewDemoApiClient::FileResponse.from_json(json_object: response.body)
+    end
+
+    # Update a file by its ID for a specific group and deal.
+    #
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param deal_id [Integer]
+    # @param type [NewDemoApiClient::FileType]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::FileResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.update(
+    #    file_id: 1,
+    #    group_id: 1,
+    #    deal_id: 1
+    #  )
+    def update(file_id:, group_id:, deal_id:, type: nil, request_options: nil)
+      response = @request_client.conn.put do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        req.body = { **(request_options&.additional_body_parameters || {}), type: type }.compact
+        req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{file_id}/deal/#{group_id}/file/#{deal_id}"
+      end
+      NewDemoApiClient::FileResponse.from_json(json_object: response.body)
+    end
+
+    # Delete a file by its ID for a specific group and deal.
+    #
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param deal_id [Integer]
+    # @param archive [Boolean]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [Object]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.delete(
+    #    file_id: 1,
+    #    group_id: 1,
+    #    deal_id: 1
+    #  )
+    def delete(file_id:, group_id:, deal_id:, archive: nil, request_options: nil)
+      response = @request_client.conn.delete do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        req.params = { **(request_options&.additional_query_parameters || {}), "archive": archive }.compact
+        unless request_options.nil? || request_options&.additional_body_parameters.nil?
+          req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+        end
+        req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{file_id}/deal/#{group_id}/file/#{deal_id}"
+      end
+      JSON.parse(response.body)
+    end
+
+    # Download a file by its ID for a specific group and deal.
+    #  NOTE: Downloads are limited to 10 GB. For larger file downloads use the
+    #  signed-url download endpoint.
+    #
+    # @param deal_id [Integer]
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [Object]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.download(
+    #    deal_id: 1,
+    #    file_id: 1,
+    #    group_id: 1
+    #  )
+    def download(deal_id:, file_id:, group_id:, request_options: nil)
+      response = @request_client.conn.get do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        unless request_options.nil? || request_options&.additional_query_parameters.nil?
+          req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+        end
+        unless request_options.nil? || request_options&.additional_body_parameters.nil?
+          req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+        end
+        req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{file_id}/file/#{group_id}/download"
+      end
+      JSON.parse(response.body)
+    end
+
+    # Get a signed URL to read a file by its ID for a specific group and deal.
+    #
+    # @param deal_id [Integer]
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param content_type [String]
+    # @param download [Boolean]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::GcsSignedURLResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.read_url(
+    #    deal_id: 1,
+    #    file_id: 1,
+    #    group_id: 1
+    #  )
+    def read_url(deal_id:, file_id:, group_id:, content_type: nil, download: nil, request_options: nil)
+      response = @request_client.conn.get do |req|
+        req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+        req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+        req.headers = {
+      **(req.headers || {}),
+      **@request_client.get_headers,
+      **(request_options&.additional_headers || {})
+        }.compact
+        req.params = {
+          **(request_options&.additional_query_parameters || {}),
+          "content_type": content_type,
+          "download": download
+        }.compact
+        unless request_options.nil? || request_options&.additional_body_parameters.nil?
+          req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+        end
+        req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{file_id}/file/#{group_id}/signed-url"
+      end
+      NewDemoApiClient::GcsSignedURLResponse.from_json(json_object: response.body)
+    end
+  end
+
+  class AsyncFileClient
+    # @return [NewDemoApiClient::AsyncRequestClient]
+    attr_reader :request_client
+
+    # @param request_client [NewDemoApiClient::AsyncRequestClient]
+    # @return [NewDemoApiClient::AsyncFileClient]
+    def initialize(request_client:)
+      @request_client = request_client
+    end
+
+    # Upload a file for a specific group and deal. Creates a file entry as well as
+    #  uploads its contents.
+    #  NOTE: Uploads are limited to 10 GB. For larger file uploads use the signed-url
+    #  upload endpoint.
+    #
+    # @param deal_id [Integer]
+    # @param group_id [Integer]
+    # @param file [String, IO]
+    # @param name [String]
+    # @param filetype [NewDemoApiClient::FileType]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::CreateFileResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.upload(
+    #    deal_id: 1,
+    #    group_id: 1,
+    #    file: my_file.txt
+    #  )
+    def upload(deal_id:, group_id:, file:, name:, filetype:, request_options: nil)
+      Async do
+        response = @request_client.conn.post do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = {
+            **(request_options&.additional_body_parameters || {}),
+            file: NewDemoApiClient::FileUtilities.as_faraday_multipart(file_like: file),
+            name: name,
+            filetype: filetype
+          }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{group_id}/file"
+        end
+        NewDemoApiClient::CreateFileResponse.from_json(json_object: response.body)
+      end
+    end
+
+    # Create a new file entry for a specific group and deal. Requires the contents to
+    #  be uploaded separately via signed-url.
+    #
+    # @param deal_id [Integer]
+    # @param group_id [Integer]
+    # @param name [String] The huamn-readable name of the file
+    # @param type [NewDemoApiClient::FileType] The type of the file
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::CreateFileForSignedURLResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.create_file_entry(
+    #    deal_id: 1,
+    #    group_id: 1,
+    #    name: "name"
+    #  )
+    def create_file_entry(deal_id:, group_id:, name:, type: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.post do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = { **(request_options&.additional_body_parameters || {}), name: name, type: type }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{group_id}/file/entry"
+        end
+        NewDemoApiClient::CreateFileForSignedURLResponse.from_json(json_object: response.body)
+      end
+    end
+
+    # Get all files for a specific group and deal.
+    #
+    # @param deal_id [Integer]
+    # @param group_id [Integer]
+    # @param sort_by [String]
+    # @param sort_order [String]
+    # @param page [Integer]
+    # @param page_size [Integer]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::PaginatedResponseFileResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.list(deal_id: 1, group_id: 1)
+    def list(deal_id:, group_id:, sort_by: nil, sort_order: nil, page: nil, page_size: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "sort_by": sort_by,
+            "sort_order": sort_order,
+            "page": page,
+            "page_size": page_size
+          }.compact
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{group_id}/file/all"
+        end
+        NewDemoApiClient::PaginatedResponseFileResponse.from_json(json_object: response.body)
+      end
+    end
+
+    # Get a file by its ID for a specific group and deal.
+    #
+    # @param deal_id [Integer]
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::FileResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.get(
+    #    deal_id: 1,
+    #    file_id: 1,
+    #    group_id: 1
+    #  )
+    def get(deal_id:, file_id:, group_id:, request_options: nil)
+      Async do
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{file_id}/file/#{group_id}"
+        end
+        NewDemoApiClient::FileResponse.from_json(json_object: response.body)
+      end
+    end
+
+    # Update a file by its ID for a specific group and deal.
+    #
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param deal_id [Integer]
+    # @param type [NewDemoApiClient::FileType]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::FileResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.update(
+    #    file_id: 1,
+    #    group_id: 1,
+    #    deal_id: 1
+    #  )
+    def update(file_id:, group_id:, deal_id:, type: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.put do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = { **(request_options&.additional_body_parameters || {}), type: type }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{file_id}/deal/#{group_id}/file/#{deal_id}"
+        end
+        NewDemoApiClient::FileResponse.from_json(json_object: response.body)
+      end
+    end
+
+    # Delete a file by its ID for a specific group and deal.
+    #
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param deal_id [Integer]
+    # @param archive [Boolean]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [Object]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.delete(
+    #    file_id: 1,
+    #    group_id: 1,
+    #    deal_id: 1
+    #  )
+    def delete(file_id:, group_id:, deal_id:, archive: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.delete do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          req.params = { **(request_options&.additional_query_parameters || {}), "archive": archive }.compact
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{file_id}/deal/#{group_id}/file/#{deal_id}"
+        end
+        parsed_json = JSON.parse(response.body)
+        parsed_json
+      end
+    end
+
+    # Download a file by its ID for a specific group and deal.
+    #  NOTE: Downloads are limited to 10 GB. For larger file downloads use the
+    #  signed-url download endpoint.
+    #
+    # @param deal_id [Integer]
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [Object]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.download(
+    #    deal_id: 1,
+    #    file_id: 1,
+    #    group_id: 1
+    #  )
+    def download(deal_id:, file_id:, group_id:, request_options: nil)
+      Async do
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{file_id}/file/#{group_id}/download"
+        end
+        parsed_json = JSON.parse(response.body)
+        parsed_json
+      end
+    end
+
+    # Get a signed URL to read a file by its ID for a specific group and deal.
+    #
+    # @param deal_id [Integer]
+    # @param file_id [Integer]
+    # @param group_id [Integer]
+    # @param content_type [String]
+    # @param download [Boolean]
+    # @param request_options [NewDemoApiClient::RequestOptions]
+    # @return [NewDemoApiClient::GcsSignedURLResponse]
+    # @example
+    #  api = NewDemoApiClient::Client.new(
+    #    base_url: "https://api.example.com",
+    #    environment: NewDemoApiClient::Environment::DEFAULT,
+    #    token: "YOUR_AUTH_TOKEN"
+    #  )
+    #  api.file.read_url(
+    #    deal_id: 1,
+    #    file_id: 1,
+    #    group_id: 1
+    #  )
+    def read_url(deal_id:, file_id:, group_id:, content_type: nil, download: nil, request_options: nil)
+      Async do
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.token unless request_options&.token.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "content_type": content_type,
+            "download": download
+          }.compact
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/api/v1/group/#{deal_id}/deal/#{file_id}/file/#{group_id}/signed-url"
+        end
+        NewDemoApiClient::GcsSignedURLResponse.from_json(json_object: response.body)
+      end
+    end
+  end
+end