mudbase 1.1.4

data/lib/mudbase/api/files_api.rb

@@ -0,0 +1,683 @@
+=begin
+#MUDBASESDK
+
+#MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: Flutterwave only for fiat (platform subscriptions + org payment processing with 7% + $0.50 split); crypto payment processor for multi-chain checkout - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API)  ## Testing Configurations Below are example configurations for testing in different environments:  ### Production ```json {   \"scheme\": \"http\",   \"base_path\": \"\",   \"host\": \"cloud.mudbase.dev\",   \"xApiKey\": \"xApiKey\",   \"bearerToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4NWFjYmUwZTEyOTkzMmZiYjdhMGZjMiIsImVtYWlsIjoibXVkaGF4a3NlcnZpY2VzQGdtYWlsLmNvbSIsImlhdCI6MTc1MDc4MDg5OCwiZXhwIjoxNzUwODY3Mjk4fQ.sfoqzEbCuz5Y8qHkLItzrZZYC823SPT4RbO7Kucqvuc\",   \"userId\": \"685acbe0e129932fbb7a0fc2\",   \"projectId\": \"685ad30be129932fbb7a1047\",   \"collectionId\": \"685ada8fd9416ac02f171abf\",   \"documentId\": \"685ae1210136e73fa1dcaf36\",   \"apikeyId\": \"685ae8a785426b6a4190d5fc\",   \"webhookId\": \"685af3992f9c4c96514247e9\",   \"functionId\": \"685af8b85d73a104065b6a77\",   \"fileId\": \"685af8b85d73a104065b6a77\" } 
+
+The version of the OpenAPI document: 1.1.4
+Contact: support@mudbase.dev
+Generated by: https://openapi-generator.tech
+Generator version: 7.20.0
+
+=end
+
+require 'cgi'
+
+module Mudbase
+  class FilesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Confirm direct upload (scan + finalize metadata)
+    # After a client uploads directly to S3 using the presigned POST, call this endpoint to have the server scan the object, create the File record, and optionally quarantine if infected.
+    # @param confirm_direct_upload_request [ConfirmDirectUploadRequest] S3 key from presigned response, projectId, and optional originalName, contentType, size, bucket, isPublic.
+    # @param [Hash] opts the optional parameters
+    # @return [ConfirmUploadResponse]
+    def confirm_direct_upload(confirm_direct_upload_request, opts = {})
+      data, _status_code, _headers = confirm_direct_upload_with_http_info(confirm_direct_upload_request, opts)
+      data
+    end
+
+    # Confirm direct upload (scan + finalize metadata)
+    # After a client uploads directly to S3 using the presigned POST, call this endpoint to have the server scan the object, create the File record, and optionally quarantine if infected.
+    # @param confirm_direct_upload_request [ConfirmDirectUploadRequest] S3 key from presigned response, projectId, and optional originalName, contentType, size, bucket, isPublic.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(ConfirmUploadResponse, Integer, Hash)>] ConfirmUploadResponse data, response status code and response headers
+    def confirm_direct_upload_with_http_info(confirm_direct_upload_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FilesApi.confirm_direct_upload ...'
+      end
+      # verify the required parameter 'confirm_direct_upload_request' is set
+      if @api_client.config.client_side_validation && confirm_direct_upload_request.nil?
+        fail ArgumentError, "Missing the required parameter 'confirm_direct_upload_request' when calling FilesApi.confirm_direct_upload"
+      end
+      # resource path
+      local_var_path = '/api/files/upload/confirm'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(confirm_direct_upload_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ConfirmUploadResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FilesApi.confirm_direct_upload",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FilesApi#confirm_direct_upload\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Delete file
+    # Delete a file from a bucket permanently. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param file_id [String] File ID.
+    # @param [Hash] opts the optional parameters
+    # @return [MessageResponse]
+    def delete_file(project_id, bucket_id, file_id, opts = {})
+      data, _status_code, _headers = delete_file_with_http_info(project_id, bucket_id, file_id, opts)
+      data
+    end
+
+    # Delete file
+    # Delete a file from a bucket permanently. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param file_id [String] File ID.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(MessageResponse, Integer, Hash)>] MessageResponse data, response status code and response headers
+    def delete_file_with_http_info(project_id, bucket_id, file_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FilesApi.delete_file ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling FilesApi.delete_file"
+      end
+      # verify the required parameter 'bucket_id' is set
+      if @api_client.config.client_side_validation && bucket_id.nil?
+        fail ArgumentError, "Missing the required parameter 'bucket_id' when calling FilesApi.delete_file"
+      end
+      # verify the required parameter 'file_id' is set
+      if @api_client.config.client_side_validation && file_id.nil?
+        fail ArgumentError, "Missing the required parameter 'file_id' when calling FilesApi.delete_file"
+      end
+      # resource path
+      local_var_path = '/api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId}'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s)).sub('{' + 'bucketId' + '}', CGI.escape(bucket_id.to_s)).sub('{' + 'fileId' + '}', CGI.escape(file_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'MessageResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FilesApi.delete_file",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:DELETE, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FilesApi#delete_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Download file from bucket
+    # Download a file from a bucket. For public files, no authentication is required. For private files, a download token (obtained via signed URL endpoint) is required in the query parameter. Accepts: Token-based authentication via query parameter (for private files), or no authentication (for public files). 
+    # @param file_id [String] File ID to download.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token Download token for private files (from signed URL endpoint).
+    # @return [File]
+    def download_bucket_file(file_id, opts = {})
+      data, _status_code, _headers = download_bucket_file_with_http_info(file_id, opts)
+      data
+    end
+
+    # Download file from bucket
+    # Download a file from a bucket. For public files, no authentication is required. For private files, a download token (obtained via signed URL endpoint) is required in the query parameter. Accepts: Token-based authentication via query parameter (for private files), or no authentication (for public files). 
+    # @param file_id [String] File ID to download.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token Download token for private files (from signed URL endpoint).
+    # @return [Array<(File, Integer, Hash)>] File data, response status code and response headers
+    def download_bucket_file_with_http_info(file_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FilesApi.download_bucket_file ...'
+      end
+      # verify the required parameter 'file_id' is set
+      if @api_client.config.client_side_validation && file_id.nil?
+        fail ArgumentError, "Missing the required parameter 'file_id' when calling FilesApi.download_bucket_file"
+      end
+      # resource path
+      local_var_path = '/api/bucket/files/{fileId}/download'.sub('{' + 'fileId' + '}', CGI.escape(file_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'token'] = opts[:'token'] if !opts[:'token'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/octet-stream', 'application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'File'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"FilesApi.download_bucket_file",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FilesApi#download_bucket_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Generate a presigned URL for downloading a file
+    # Returns a time-limited provider-signed URL (S3) for direct download. Server enforces RBAC before issuing the URL.
+    # @param file_id [String] File ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token Optional one-time download token (if provided by upload flow).
+    # @return [SignedUrlResponse]
+    def download_file(file_id, opts = {})
+      data, _status_code, _headers = download_file_with_http_info(file_id, opts)
+      data
+    end
+
+    # Generate a presigned URL for downloading a file
+    # Returns a time-limited provider-signed URL (S3) for direct download. Server enforces RBAC before issuing the URL.
+    # @param file_id [String] File ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :token Optional one-time download token (if provided by upload flow).
+    # @return [Array<(SignedUrlResponse, Integer, Hash)>] SignedUrlResponse data, response status code and response headers
+    def download_file_with_http_info(file_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FilesApi.download_file ...'
+      end
+      # verify the required parameter 'file_id' is set
+      if @api_client.config.client_side_validation && file_id.nil?
+        fail ArgumentError, "Missing the required parameter 'file_id' when calling FilesApi.download_file"
+      end
+      # resource path
+      local_var_path = '/api/files/{fileId}/download'.sub('{' + 'fileId' + '}', CGI.escape(file_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'token'] = opts[:'token'] if !opts[:'token'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SignedUrlResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FilesApi.download_file",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FilesApi#download_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Generate presigned POST data for direct browser upload
+    # Issue a presigned POST (fields + url) for clients to upload directly to S3. The server stores the issued key with expiry and RBAC is enforced.
+    # @param generate_presigned_upload_request [GeneratePresignedUploadRequest] projectId, originalName, optional bucket, contentType, isPublic.
+    # @param [Hash] opts the optional parameters
+    # @return [PresignedPostResponse]
+    def generate_presigned_upload(generate_presigned_upload_request, opts = {})
+      data, _status_code, _headers = generate_presigned_upload_with_http_info(generate_presigned_upload_request, opts)
+      data
+    end
+
+    # Generate presigned POST data for direct browser upload
+    # Issue a presigned POST (fields + url) for clients to upload directly to S3. The server stores the issued key with expiry and RBAC is enforced.
+    # @param generate_presigned_upload_request [GeneratePresignedUploadRequest] projectId, originalName, optional bucket, contentType, isPublic.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(PresignedPostResponse, Integer, Hash)>] PresignedPostResponse data, response status code and response headers
+    def generate_presigned_upload_with_http_info(generate_presigned_upload_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FilesApi.generate_presigned_upload ...'
+      end
+      # verify the required parameter 'generate_presigned_upload_request' is set
+      if @api_client.config.client_side_validation && generate_presigned_upload_request.nil?
+        fail ArgumentError, "Missing the required parameter 'generate_presigned_upload_request' when calling FilesApi.generate_presigned_upload"
+      end
+      # resource path
+      local_var_path = '/api/files/upload/presigned'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(generate_presigned_upload_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'PresignedPostResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FilesApi.generate_presigned_upload",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FilesApi#generate_presigned_upload\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Generate signed URL for file
+    # Generate a time-limited signed URL for downloading a private file. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param file_id [String] File ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [GenerateSignedUrlRequest] :generate_signed_url_request Optional expiresIn (seconds) for the signed URL.
+    # @return [SignedUrlResponse]
+    def generate_signed_url(project_id, bucket_id, file_id, opts = {})
+      data, _status_code, _headers = generate_signed_url_with_http_info(project_id, bucket_id, file_id, opts)
+      data
+    end
+
+    # Generate signed URL for file
+    # Generate a time-limited signed URL for downloading a private file. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param file_id [String] File ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [GenerateSignedUrlRequest] :generate_signed_url_request Optional expiresIn (seconds) for the signed URL.
+    # @return [Array<(SignedUrlResponse, Integer, Hash)>] SignedUrlResponse data, response status code and response headers
+    def generate_signed_url_with_http_info(project_id, bucket_id, file_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FilesApi.generate_signed_url ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling FilesApi.generate_signed_url"
+      end
+      # verify the required parameter 'bucket_id' is set
+      if @api_client.config.client_side_validation && bucket_id.nil?
+        fail ArgumentError, "Missing the required parameter 'bucket_id' when calling FilesApi.generate_signed_url"
+      end
+      # verify the required parameter 'file_id' is set
+      if @api_client.config.client_side_validation && file_id.nil?
+        fail ArgumentError, "Missing the required parameter 'file_id' when calling FilesApi.generate_signed_url"
+      end
+      # resource path
+      local_var_path = '/api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId}/signed-url'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s)).sub('{' + 'bucketId' + '}', CGI.escape(bucket_id.to_s)).sub('{' + 'fileId' + '}', CGI.escape(file_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'generate_signed_url_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SignedUrlResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FilesApi.generate_signed_url",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FilesApi#generate_signed_url\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get file metadata
+    # Get metadata for a specific file in a bucket. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param file_id [String] File ID.
+    # @param [Hash] opts the optional parameters
+    # @return [FileResponse]
+    def get_file(project_id, bucket_id, file_id, opts = {})
+      data, _status_code, _headers = get_file_with_http_info(project_id, bucket_id, file_id, opts)
+      data
+    end
+
+    # Get file metadata
+    # Get metadata for a specific file in a bucket. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param file_id [String] File ID.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FileResponse, Integer, Hash)>] FileResponse data, response status code and response headers
+    def get_file_with_http_info(project_id, bucket_id, file_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FilesApi.get_file ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling FilesApi.get_file"
+      end
+      # verify the required parameter 'bucket_id' is set
+      if @api_client.config.client_side_validation && bucket_id.nil?
+        fail ArgumentError, "Missing the required parameter 'bucket_id' when calling FilesApi.get_file"
+      end
+      # verify the required parameter 'file_id' is set
+      if @api_client.config.client_side_validation && file_id.nil?
+        fail ArgumentError, "Missing the required parameter 'file_id' when calling FilesApi.get_file"
+      end
+      # resource path
+      local_var_path = '/api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId}'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s)).sub('{' + 'bucketId' + '}', CGI.escape(bucket_id.to_s)).sub('{' + 'fileId' + '}', CGI.escape(file_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FileResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FilesApi.get_file",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FilesApi#get_file\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # List files in bucket
+    # List files in a bucket with pagination, search, and optional type filter. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page number (1-based). (default to 1)
+    # @option opts [Integer] :limit Number of files per page. (default to 20)
+    # @option opts [String] :search Search by filename.
+    # @option opts [String] :type Filter by MIME type or file type.
+    # @return [FileListResponse]
+    def list_files(project_id, bucket_id, opts = {})
+      data, _status_code, _headers = list_files_with_http_info(project_id, bucket_id, opts)
+      data
+    end
+
+    # List files in bucket
+    # List files in a bucket with pagination, search, and optional type filter. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param [Hash] opts the optional parameters
+    # @option opts [Integer] :page Page number (1-based). (default to 1)
+    # @option opts [Integer] :limit Number of files per page. (default to 20)
+    # @option opts [String] :search Search by filename.
+    # @option opts [String] :type Filter by MIME type or file type.
+    # @return [Array<(FileListResponse, Integer, Hash)>] FileListResponse data, response status code and response headers
+    def list_files_with_http_info(project_id, bucket_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FilesApi.list_files ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling FilesApi.list_files"
+      end
+      # verify the required parameter 'bucket_id' is set
+      if @api_client.config.client_side_validation && bucket_id.nil?
+        fail ArgumentError, "Missing the required parameter 'bucket_id' when calling FilesApi.list_files"
+      end
+      # resource path
+      local_var_path = '/api/bucket/projects/{projectId}/buckets/{bucketId}/files'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s)).sub('{' + 'bucketId' + '}', CGI.escape(bucket_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page'] = opts[:'page'] if !opts[:'page'].nil?
+      query_params[:'limit'] = opts[:'limit'] if !opts[:'limit'].nil?
+      query_params[:'search'] = opts[:'search'] if !opts[:'search'].nil?
+      query_params[:'type'] = opts[:'type'] if !opts[:'type'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FileListResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FilesApi.list_files",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FilesApi#list_files\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Upload files to bucket
+    # Upload one or more files to a storage bucket using multipart/form-data. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param upload_files_to_bucket_request [UploadFilesToBucketRequest] Use multipart/form-data for file upload (files required; optional folder, tags). application/json uses the same schema for metadata-only or tooling that prefers JSON.
+    # @param [Hash] opts the optional parameters
+    # @return [FileUploadResponse]
+    def upload_files(project_id, bucket_id, upload_files_to_bucket_request, opts = {})
+      data, _status_code, _headers = upload_files_with_http_info(project_id, bucket_id, upload_files_to_bucket_request, opts)
+      data
+    end
+
+    # Upload files to bucket
+    # Upload one or more files to a storage bucket using multipart/form-data. Accepts ProjectBearerAuth (JWT) or ApiKeyAuth (X-API-Key). 
+    # @param project_id [String] Project ID.
+    # @param bucket_id [String] Bucket ID.
+    # @param upload_files_to_bucket_request [UploadFilesToBucketRequest] Use multipart/form-data for file upload (files required; optional folder, tags). application/json uses the same schema for metadata-only or tooling that prefers JSON.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(FileUploadResponse, Integer, Hash)>] FileUploadResponse data, response status code and response headers
+    def upload_files_with_http_info(project_id, bucket_id, upload_files_to_bucket_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: FilesApi.upload_files ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling FilesApi.upload_files"
+      end
+      # verify the required parameter 'bucket_id' is set
+      if @api_client.config.client_side_validation && bucket_id.nil?
+        fail ArgumentError, "Missing the required parameter 'bucket_id' when calling FilesApi.upload_files"
+      end
+      # verify the required parameter 'upload_files_to_bucket_request' is set
+      if @api_client.config.client_side_validation && upload_files_to_bucket_request.nil?
+        fail ArgumentError, "Missing the required parameter 'upload_files_to_bucket_request' when calling FilesApi.upload_files"
+      end
+      # resource path
+      local_var_path = '/api/bucket/projects/{projectId}/buckets/{bucketId}/files'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s)).sub('{' + 'bucketId' + '}', CGI.escape(bucket_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json', 'multipart/form-data'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(upload_files_to_bucket_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FileUploadResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth', 'ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"FilesApi.upload_files",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: FilesApi#upload_files\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end