wip-ruby 0.2.0

data/lib/wip/resources/uploads.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+require_relative "base"
+require "digest/md5"
+require "mime/types"
+
+module Wip
+  module Resources
+    # Resource for handling file uploads
+    class Uploads < Base
+      # Request a pre-signed URL for direct file upload
+      # @param filename [String] Name of the file to upload
+      # @param byte_size [Integer] Size of the file in bytes
+      # @param checksum [String] MD5 checksum of the file
+      # @param content_type [String] MIME type of the file
+      # @return [Hash] Upload credentials and information including url, headers, method, and signed_id
+      def request_upload_url(filename:, byte_size:, checksum:, content_type:)
+        response = client.post("/v1/uploads", {
+          filename: filename,
+          byte_size: byte_size,
+          checksum: checksum,
+          content_type: content_type
+        })
+        response.extract_resource
+      end
+
+      # Upload a file using the pre-signed URL
+      # @param url [String] Pre-signed URL for upload
+      # @param headers [Hash] Headers required for the upload
+      # @param file_path [String] Path to the file to upload
+      # @param method [String] HTTP method to use (from API response, defaults to PUT)
+      # @return [Boolean] Whether the upload was successful
+      def upload_file(url:, headers:, file_path:, method: "PUT")
+        # Create a separate connection for file uploads
+        # This ensures we don't interfere with the main API client's connection
+        connection = Faraday.new(url: url) do |f|
+          # Don't process response as JSON
+          f.response :raise_error
+
+          # Add logging if configured
+          if client.config.logger
+            f.response :logger, client.config.logger, { headers: true }
+          end
+
+          # Use default adapter
+          f.adapter Faraday.default_adapter
+        end
+
+        # Ensure we have Content-Length
+        file_size = File.size(file_path)
+        headers["Content-Length"] ||= file_size.to_s
+
+        # Use the HTTP method specified by the API
+        http_method = method.to_s.downcase.to_sym
+
+        # Open file in binary mode and stream it
+        File.open(file_path, "rb") do |file|
+          response = connection.public_send(http_method) do |req|
+            # Add required headers
+            headers.each { |key, value| req.headers[key] = value }
+
+            # Stream the file
+            req.body = file.read
+          end
+
+          return response.success?
+        end
+      rescue Faraday::Error => e
+        raise Error::UploadError, "Upload failed: #{e.message}"
+      rescue SystemCallError => e
+        raise Error::UploadError, "File access error: #{e.message}"
+      end
+
+      # Helper method to handle the complete upload process
+      # @param file_path [String] Path to the file to upload
+      # @return [String] The signed ID for the uploaded file
+      def upload(file_path)
+        # Validate file exists and is readable
+        unless File.file?(file_path) && File.readable?(file_path)
+          raise Error::UploadError, "File not found or not readable: #{file_path}"
+        end
+
+        # Get file information
+        file_size = File.size(file_path)
+        file_name = File.basename(file_path)
+        content_type = MIME::Types.type_for(file_path).first&.content_type || "application/octet-stream"
+        checksum = Digest::MD5.file(file_path).base64digest
+
+        # Get upload URL and credentials
+        credentials = request_upload_url(
+          filename: file_name,
+          byte_size: file_size,
+          checksum: checksum,
+          content_type: content_type
+        )
+
+        # Perform the upload using the method specified by the API
+        success = upload_file(
+          url: credentials["url"],
+          headers: credentials["headers"],
+          file_path: file_path,
+          method: credentials["method"] || "PUT"
+        )
+
+        raise Error::UploadError, "Failed to upload file" unless success
+
+        credentials["signed_id"]
+      end
+    end
+  end
+end

data/lib/wip/resources/users.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require_relative "base"
+require_relative "../models/user"
+require_relative "../models/project"
+require_relative "../models/todo"
+require_relative "../models/collection"
+
+module Wip
+  module Resources
+    # Resource for interacting with users
+    #
+    # @example Get a user's details
+    #   client.users.find("username")
+    #
+    # @example List a user's projects
+    #   client.users.projects("username")
+    #
+    # @example List a user's todos
+    #   client.users.todos("username", since: "2024-01-01")
+    #
+    # @note For authenticated user operations, use the Viewer resource instead.
+    # @see Viewer
+    class Users < Base
+      # Get a single user by username
+      # @param username [String] The username
+      # @return [Models::User] The user
+      def find(username)
+        path = build_path("/v1/users/{username}", username: username)
+        response = client.get(path)
+        Models::User.from_json(response.extract_resource)
+      end
+
+      # List projects for a user
+      # @param username [String] The username
+      # @param limit [Integer] Number of items to return (default: 25)
+      # @param starting_after [String] Cursor for pagination
+      # @return [Models::Collection<Models::Project>] The paginated projects
+      def projects(username, limit: nil, starting_after: nil)
+        path = build_path("/v1/users/{username}/projects", username: username)
+        params = extract_pagination_params(limit: limit, starting_after: starting_after)
+        response = client.get(path, params)
+        Models::Collection.from_json(response.extract_resource, item_class: Models::Project)
+      end
+
+      # List todos for a user
+      # @param username [String] The username
+      # @param limit [Integer] Number of items to return (default: 25)
+      # @param starting_after [String] Cursor for pagination
+      # @param since [Time, Date, String, Integer] Filter todos created since this date
+      # @param before [Time, Date, String, Integer] Filter todos created before this date (maps to API's `until` param)
+      # @return [Models::Collection<Models::Todo>] The paginated todos
+      def todos(username, limit: nil, starting_after: nil, since: nil, before: nil)
+        path = build_path("/v1/users/{username}/todos", username: username)
+        params = extract_todo_params(limit: limit, starting_after: starting_after, since: since, before: before)
+        response = client.get(path, params)
+        Models::Collection.from_json(response.extract_resource, item_class: Models::Todo)
+      end
+    end
+  end
+end

data/lib/wip/resources/viewer.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative "base"
+require_relative "../models/user"
+require_relative "../models/project"
+require_relative "../models/todo"
+require_relative "../models/collection"
+
+module Wip
+  module Resources
+    # Resource for interacting with the authenticated user (viewer)
+    #
+    # @example Get the authenticated user
+    #   client.viewer.me
+    #
+    # @example List your todos
+    #   client.viewer.todos(limit: 10)
+    #
+    # @example List your projects
+    #   client.viewer.projects
+    class Viewer < Base
+      # Get the authenticated user's details
+      # @return [Models::User] The authenticated user
+      def me
+        response = client.get("/v1/users/me")
+        Models::User.from_json(response.extract_resource)
+      end
+
+      # List todos for the authenticated user
+      # @param limit [Integer] Number of items to return (default: 25)
+      # @param starting_after [String] Cursor for pagination
+      # @param since [Time, Date, String, Integer] Filter todos created since this date
+      # @param before [Time, Date, String, Integer] Filter todos created before this date (maps to API's `until` param)
+      # @return [Models::Collection<Models::Todo>] The paginated todos
+      def todos(limit: nil, starting_after: nil, since: nil, before: nil)
+        params = extract_todo_params(limit: limit, starting_after: starting_after, since: since, before: before)
+        response = client.get("/v1/users/me/todos", params)
+        Models::Collection.from_json(response.extract_resource, item_class: Models::Todo)
+      end
+
+      # List projects for the authenticated user
+      # @param limit [Integer] Number of items to return (default: 25)
+      # @param starting_after [String] Cursor for pagination
+      # @return [Models::Collection<Models::Project>] The paginated projects
+      def projects(limit: nil, starting_after: nil)
+        params = extract_pagination_params(limit: limit, starting_after: starting_after)
+        response = client.get("/v1/users/me/projects", params)
+        Models::Collection.from_json(response.extract_resource, item_class: Models::Project)
+      end
+    end
+  end
+end

data/lib/wip/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Wip
+  VERSION = "0.2.0"
+end

data/lib/wip-ruby.rb

@@ -0,0 +1 @@
+require_relative "wip"

data/lib/wip.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative "wip/version"
+require_relative "wip/configuration"
+require_relative "wip/error"
+require_relative "wip/http_client"
+require_relative "wip/client"
+
+# Models
+require_relative "wip/models/base"
+require_relative "wip/models/collection"
+require_relative "wip/models/concerns/reactable"
+require_relative "wip/models/user"
+require_relative "wip/models/project"
+require_relative "wip/models/todo"
+require_relative "wip/models/comment"
+require_relative "wip/models/reaction"
+
+module Wip
+  class << self
+    # Returns the global configuration
+    # @return [Wip::Configuration]
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # Configure the gem
+    # @yield [config] Configuration instance
+    # @example
+    #   Wip.configure do |config|
+    #     config.api_key = "your-api-key"
+    #     config.base_url = "https://api.wip.co"
+    #   end
+    def configure
+      yield(configuration)
+    end
+
+    # Returns a new API client instance
+    # @return [Wip::Client]
+    def client
+      @client ||= Client.new(configuration)
+    end
+
+    # Reset the client and configuration
+    # Useful for testing
+    def reset!
+      @configuration = nil
+      @client = nil
+    end
+  end
+end

data/sig/wip/ruby.rbs

@@ -0,0 +1,6 @@
+module Wip
+  module Ruby
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end