autorender 0.1.0

data/lib/autorender/models/upload_create_from_url_response.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module Autorender
+  module Models
+    # @see Autorender::Resources::Uploads#create_from_url
+    class UploadCreateFromURLResponse < Autorender::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute custom_id
+      #
+      #   @return [String, nil]
+      required :custom_id, String, nil?: true
+
+      # @!attribute extension
+      #
+      #   @return [String]
+      required :extension, String
+
+      # @!attribute file_no
+      #
+      #   @return [String]
+      required :file_no, String
+
+      # @!attribute folder_no
+      #
+      #   @return [String, nil]
+      required :folder_no, String, nil?: true
+
+      # @!attribute height
+      #
+      #   @return [Integer, nil]
+      required :height, Integer, nil?: true
+
+      # @!attribute is_duplicate
+      #
+      #   @return [Boolean]
+      required :is_duplicate, Autorender::Internal::Type::Boolean
+
+      # @!attribute metadata
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      required :metadata, Autorender::Internal::Type::HashOf[Autorender::Internal::Type::Unknown], nil?: true
+
+      # @!attribute mime_type
+      #
+      #   @return [String]
+      required :mime_type, String
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute path
+      #
+      #   @return [String]
+      required :path, String
+
+      # @!attribute size
+      #
+      #   @return [Integer]
+      required :size, Integer
+
+      # @!attribute tags
+      #
+      #   @return [Array<String>]
+      required :tags, Autorender::Internal::Type::ArrayOf[String]
+
+      # @!attribute thumbnail
+      #
+      #   @return [String]
+      required :thumbnail, String
+
+      # @!attribute upload_source
+      #
+      #   @return [String]
+      required :upload_source, String
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute width
+      #
+      #   @return [Integer, nil]
+      required :width, Integer, nil?: true
+
+      # @!attribute workspace_id
+      #
+      #   @return [String]
+      required :workspace_id, String
+
+      # @!attribute format_
+      #
+      #   @return [String, nil]
+      optional :format_, String, api_name: :format
+
+      # @!attribute hash_
+      #
+      #   @return [String, nil]
+      optional :hash_, String, api_name: :hash
+
+      # @!attribute is_private
+      #
+      #   @return [Boolean, nil]
+      optional :is_private, Autorender::Internal::Type::Boolean
+
+      # @!method initialize(id:, created_at:, custom_id:, extension:, file_no:, folder_no:, height:, is_duplicate:, metadata:, mime_type:, name:, path:, size:, tags:, thumbnail:, upload_source:, url:, width:, workspace_id:, format_: nil, hash_: nil, is_private: nil)
+      #   Upload created
+      #
+      #   @param id [String]
+      #   @param created_at [Time]
+      #   @param custom_id [String, nil]
+      #   @param extension [String]
+      #   @param file_no [String]
+      #   @param folder_no [String, nil]
+      #   @param height [Integer, nil]
+      #   @param is_duplicate [Boolean]
+      #   @param metadata [Hash{Symbol=>Object}, nil]
+      #   @param mime_type [String]
+      #   @param name [String]
+      #   @param path [String]
+      #   @param size [Integer]
+      #   @param tags [Array<String>]
+      #   @param thumbnail [String]
+      #   @param upload_source [String]
+      #   @param url [String]
+      #   @param width [Integer, nil]
+      #   @param workspace_id [String]
+      #   @param format_ [String]
+      #   @param hash_ [String]
+      #   @param is_private [Boolean]
+    end
+  end
+end

data/lib/autorender/models/upload_create_params.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Autorender
+  module Models
+    # @see Autorender::Resources::Uploads#create
+    class UploadCreateParams < Autorender::Internal::Type::BaseModel
+      extend Autorender::Internal::Type::RequestParameters::Converter
+      include Autorender::Internal::Type::RequestParameters
+
+      # @!attribute file
+      #   File to upload.
+      #
+      #   @return [Pathname, StringIO, IO, String, Autorender::FilePart]
+      required :file, Autorender::Internal::Type::FileInput
+
+      # @!attribute file_name
+      #   File name (e.g. product.jpg)
+      #
+      #   @return [String]
+      required :file_name, String
+
+      # @!attribute custom_id
+      #   Custom identifier
+      #
+      #   @return [String, nil]
+      optional :custom_id, String
+
+      # @!attribute folder
+      #   Optional folder path
+      #
+      #   @return [String, nil]
+      optional :folder, String
+
+      # @!attribute metadata
+      #   JSON string of metadata
+      #
+      #   @return [String, nil]
+      optional :metadata, String
+
+      # @!attribute random_prefix
+      #   true/false to append random suffix
+      #
+      #   @return [String, nil]
+      optional :random_prefix, String
+
+      # @!attribute tags
+      #   Comma-separated tags
+      #
+      #   @return [String, nil]
+      optional :tags, String
+
+      # @!attribute transform
+      #   Transform string (w_300,h_300,c_crop,...)
+      #
+      #   @return [String, nil]
+      optional :transform, String
+
+      # @!attribute webhook_url
+      #   URL to notify on success
+      #
+      #   @return [String, nil]
+      optional :webhook_url, String
+
+      # @!method initialize(file:, file_name:, custom_id: nil, folder: nil, metadata: nil, random_prefix: nil, tags: nil, transform: nil, webhook_url: nil, request_options: {})
+      #   @param file [Pathname, StringIO, IO, String, Autorender::FilePart] File to upload.
+      #
+      #   @param file_name [String] File name (e.g. product.jpg)
+      #
+      #   @param custom_id [String] Custom identifier
+      #
+      #   @param folder [String] Optional folder path
+      #
+      #   @param metadata [String] JSON string of metadata
+      #
+      #   @param random_prefix [String] true/false to append random suffix
+      #
+      #   @param tags [String] Comma-separated tags
+      #
+      #   @param transform [String] Transform string (w_300,h_300,c_crop,...)
+      #
+      #   @param webhook_url [String] URL to notify on success
+      #
+      #   @param request_options [Autorender::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/autorender/models/upload_create_response.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module Autorender
+  module Models
+    # @see Autorender::Resources::Uploads#create
+    class UploadCreateResponse < Autorender::Internal::Type::BaseModel
+      # @!attribute id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute custom_id
+      #
+      #   @return [String, nil]
+      required :custom_id, String, nil?: true
+
+      # @!attribute extension
+      #
+      #   @return [String]
+      required :extension, String
+
+      # @!attribute file_no
+      #
+      #   @return [String]
+      required :file_no, String
+
+      # @!attribute folder_no
+      #
+      #   @return [String, nil]
+      required :folder_no, String, nil?: true
+
+      # @!attribute height
+      #
+      #   @return [Integer, nil]
+      required :height, Integer, nil?: true
+
+      # @!attribute is_duplicate
+      #
+      #   @return [Boolean]
+      required :is_duplicate, Autorender::Internal::Type::Boolean
+
+      # @!attribute metadata
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      required :metadata, Autorender::Internal::Type::HashOf[Autorender::Internal::Type::Unknown], nil?: true
+
+      # @!attribute mime_type
+      #
+      #   @return [String]
+      required :mime_type, String
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute path
+      #
+      #   @return [String]
+      required :path, String
+
+      # @!attribute size
+      #
+      #   @return [Integer]
+      required :size, Integer
+
+      # @!attribute tags
+      #
+      #   @return [Array<String>]
+      required :tags, Autorender::Internal::Type::ArrayOf[String]
+
+      # @!attribute thumbnail
+      #
+      #   @return [String]
+      required :thumbnail, String
+
+      # @!attribute upload_source
+      #
+      #   @return [String]
+      required :upload_source, String
+
+      # @!attribute url
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute width
+      #
+      #   @return [Integer, nil]
+      required :width, Integer, nil?: true
+
+      # @!attribute workspace_id
+      #
+      #   @return [String]
+      required :workspace_id, String
+
+      # @!attribute format_
+      #
+      #   @return [String, nil]
+      optional :format_, String, api_name: :format
+
+      # @!attribute hash_
+      #
+      #   @return [String, nil]
+      optional :hash_, String, api_name: :hash
+
+      # @!attribute is_private
+      #
+      #   @return [Boolean, nil]
+      optional :is_private, Autorender::Internal::Type::Boolean
+
+      # @!method initialize(id:, created_at:, custom_id:, extension:, file_no:, folder_no:, height:, is_duplicate:, metadata:, mime_type:, name:, path:, size:, tags:, thumbnail:, upload_source:, url:, width:, workspace_id:, format_: nil, hash_: nil, is_private: nil)
+      #   Upload created
+      #
+      #   @param id [String]
+      #   @param created_at [Time]
+      #   @param custom_id [String, nil]
+      #   @param extension [String]
+      #   @param file_no [String]
+      #   @param folder_no [String, nil]
+      #   @param height [Integer, nil]
+      #   @param is_duplicate [Boolean]
+      #   @param metadata [Hash{Symbol=>Object}, nil]
+      #   @param mime_type [String]
+      #   @param name [String]
+      #   @param path [String]
+      #   @param size [Integer]
+      #   @param tags [Array<String>]
+      #   @param thumbnail [String]
+      #   @param upload_source [String]
+      #   @param url [String]
+      #   @param width [Integer, nil]
+      #   @param workspace_id [String]
+      #   @param format_ [String]
+      #   @param hash_ [String]
+      #   @param is_private [Boolean]
+    end
+  end
+end

data/lib/autorender/models.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Autorender
+  [Autorender::Internal::Type::BaseModel, *Autorender::Internal::Type::BaseModel.subclasses].each do |cls|
+    cls.define_sorbet_constant!(:OrHash) { T.type_alias { T.any(cls, Autorender::Internal::AnyHash) } }
+  end
+
+  Autorender::Internal::Util.walk_namespaces(Autorender::Models).each do |mod|
+    case mod
+    in Autorender::Internal::Type::Enum | Autorender::Internal::Type::Union
+      mod.constants.each do |name|
+        case mod.const_get(name)
+        in true | false
+          mod.define_sorbet_constant!(:TaggedBoolean) { T.type_alias { T::Boolean } }
+          mod.define_sorbet_constant!(:OrBoolean) { T.type_alias { T::Boolean } }
+        in Integer
+          mod.define_sorbet_constant!(:TaggedInteger) { T.type_alias { Integer } }
+          mod.define_sorbet_constant!(:OrInteger) { T.type_alias { Integer } }
+        in Float
+          mod.define_sorbet_constant!(:TaggedFloat) { T.type_alias { Float } }
+          mod.define_sorbet_constant!(:OrFloat) { T.type_alias { Float } }
+        in Symbol
+          mod.define_sorbet_constant!(:TaggedSymbol) { T.type_alias { Symbol } }
+          mod.define_sorbet_constant!(:OrSymbol) { T.type_alias { T.any(Symbol, String) } }
+        else
+        end
+      end
+    else
+    end
+  end
+
+  Autorender::Internal::Util.walk_namespaces(Autorender::Models)
+                            .lazy
+                            .grep(Autorender::Internal::Type::Union)
+                            .each do |mod|
+    const = :Variants
+    next if mod.sorbet_constant_defined?(const)
+
+    mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
+  end
+
+  FileDeleteParams = Autorender::Models::FileDeleteParams
+
+  FileListParams = Autorender::Models::FileListParams
+
+  FileRenameParams = Autorender::Models::FileRenameParams
+
+  FileRetrieveParams = Autorender::Models::FileRetrieveParams
+
+  FolderCreateParams = Autorender::Models::FolderCreateParams
+
+  FolderDeleteParams = Autorender::Models::FolderDeleteParams
+
+  FolderListParams = Autorender::Models::FolderListParams
+
+  FolderRenameParams = Autorender::Models::FolderRenameParams
+
+  MultipartUploadCompleteParams = Autorender::Models::MultipartUploadCompleteParams
+
+  MultipartUploadStartParams = Autorender::Models::MultipartUploadStartParams
+
+  UploadCreateFromURLParams = Autorender::Models::UploadCreateFromURLParams
+
+  UploadCreateParams = Autorender::Models::UploadCreateParams
+end

data/lib/autorender/request_options.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Autorender
+  # Specify HTTP behaviour to use for a specific request. These options supplement
+  # or override those provided at the client level.
+  #
+  # When making a request, you can pass an actual {RequestOptions} instance, or
+  # simply pass a Hash with symbol keys matching the attributes on this class.
+  class RequestOptions < Autorender::Internal::Type::BaseModel
+    # @api private
+    #
+    # @param opts [Autorender::RequestOptions, Hash{Symbol=>Object}]
+    #
+    # @raise [ArgumentError]
+    def self.validate!(opts)
+      case opts
+      in Autorender::RequestOptions | Hash
+        opts.to_h.each_key do |k|
+          unless fields.include?(k)
+            raise ArgumentError.new("Request `opts` keys must be one of #{fields.keys}, got #{k.inspect}")
+          end
+        end
+      else
+        raise ArgumentError.new("Request `opts` must be a Hash or RequestOptions, got #{opts.inspect}")
+      end
+    end
+
+    # @!attribute idempotency_key
+    #   Idempotency key to send with request and all associated retries. Will only be
+    #   sent for write requests.
+    #
+    #   @return [String, nil]
+    optional :idempotency_key, String
+
+    # @!attribute extra_query
+    #   Extra query params to send with the request. These are `.merge`’d into any
+    #   `query` given at the client level.
+    #
+    #   @return [Hash{String=>Array<String>, String, nil}, nil]
+    optional :extra_query, Autorender::Internal::Type::HashOf[Autorender::Internal::Type::ArrayOf[String]]
+
+    # @!attribute extra_headers
+    #   Extra headers to send with the request. These are `.merged`’d into any
+    #   `extra_headers` given at the client level.
+    #
+    #   @return [Hash{String=>String, nil}, nil]
+    optional :extra_headers, Autorender::Internal::Type::HashOf[String, nil?: true]
+
+    # @!attribute extra_body
+    #   Extra data to send with the request. These are deep merged into any data
+    #   generated as part of the normal request.
+    #
+    #   @return [Object, nil]
+    optional :extra_body, Autorender::Internal::Type::HashOf[Autorender::Internal::Type::Unknown]
+
+    # @!attribute max_retries
+    #   Maximum number of retries to attempt after a failed initial request.
+    #
+    #   @return [Integer, nil]
+    optional :max_retries, Integer
+
+    # @!attribute timeout
+    #   Request timeout in seconds.
+    #
+    #   @return [Float, nil]
+    optional :timeout, Float
+
+    # @!method initialize(values = {})
+    #   Returns a new instance of RequestOptions.
+    #
+    #   @param values [Hash{Symbol=>Object}]
+
+    define_sorbet_constant!(:OrHash) do
+      T.type_alias { T.any(Autorender::RequestOptions, Autorender::Internal::AnyHash) }
+    end
+  end
+end

data/lib/autorender/resources/files.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+module Autorender
+  module Resources
+    # File management endpoints (API key required)
+    class Files
+      # Get file details
+      #
+      # @overload retrieve(file_no, request_options: {})
+      #
+      # @param file_no [String]
+      # @param request_options [Autorender::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Autorender::Models::FileRetrieveResponse]
+      #
+      # @see Autorender::Models::FileRetrieveParams
+      def retrieve(file_no, params = {})
+        @client.request(
+          method: :get,
+          path: ["api/v1/files/%1$s", file_no],
+          model: Autorender::Models::FileRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # List/search files with pagination, filtering, and sorting.
+      #
+      # @overload list(folder_no: nil, limit: nil, page: nil, search: nil, sort: nil, request_options: {})
+      #
+      # @param folder_no [String] Filter by folder number
+      #
+      # @param limit [Integer]
+      #
+      # @param page [Integer]
+      #
+      # @param search [String] Partial name match (case-insensitive)
+      #
+      # @param sort [Symbol, Autorender::Models::FileListParams::Sort]
+      #
+      # @param request_options [Autorender::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Autorender::Models::FileListResponse]
+      #
+      # @see Autorender::Models::FileListParams
+      def list(params = {})
+        parsed, options = Autorender::FileListParams.dump_request(params)
+        query = Autorender::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "api/v1/files",
+          query: query,
+          model: Autorender::Models::FileListResponse,
+          options: options
+        )
+      end
+
+      # Delete file
+      #
+      # @overload delete(file_no, request_options: {})
+      #
+      # @param file_no [String]
+      # @param request_options [Autorender::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Autorender::Models::FileDeleteParams
+      def delete(file_no, params = {})
+        @client.request(
+          method: :delete,
+          path: ["api/v1/files/%1$s", file_no],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # Rename file
+      #
+      # @overload rename(file_no, name:, request_options: {})
+      #
+      # @param file_no [String]
+      #
+      # @param name [String] New file name without extension or path separators
+      #
+      # @param request_options [Autorender::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Autorender::Models::FileRenameResponse]
+      #
+      # @see Autorender::Models::FileRenameParams
+      def rename(file_no, params)
+        parsed, options = Autorender::FileRenameParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["api/v1/files/%1$s/rename", file_no],
+          body: parsed,
+          model: Autorender::Models::FileRenameResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Autorender::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end