trmnl-api 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6159aaeff6f5885bfb0b4b94feb6f4d99fe55c3e4ae6b87c64009eda6014c397
-  data.tar.gz: c86fe1cc48d9521ea6130951469d3c78505c297fe2b1ac03ae188582268213bf
+  metadata.gz: 168b5086d30774ef88cc9d12ae187ffa4da349bfe10456c64a5e2fe7e94372a3
+  data.tar.gz: d7c785269f0ddf0238d399a352cef774c9081bb6706a238cf9ead6bcc413ff0e
 SHA512:
-  metadata.gz: d2d17033a2207edd65d2c0fe14fc07bd68e31fc520467833be1cbcd35f8d752b299c72d7394c67f8463ba18d9fbd1aa3854ba7610012383eabe2c1e1dd9341be
-  data.tar.gz: 0e8e4a98208e47f3ed3eeab06e06b82f0e7693349108a74b59a0590ff06e839f1d4f671fde9233b3dceee71421d463f4beacd41ce3397b6b01277286ed139f9f
+  metadata.gz: 4b6cdd52fa7cc10214220a4906298a1d2243d1da94f8854d1dd1eb67cdcd70a761655a717630bb561151e84c01b8926e7b9fac65e1cd84c9fb7590cddc164f7e
+  data.tar.gz: 732532ba60f51c994898d1a982f404ba0d38b419ccc2c6cc95b46548234c51e1b40eedeeda6b4047d81b46f03408b4fccaa8dc8bef3b85dbcef70c0a4a355576

data/README.adoc

@@ -3,17 +3,18 @@
 :figure-caption!:
 
 :trmnl_link: link:https://usetrmnl.com[TRMNL]
+:trmnl_api_link: link:https://usetrmnl.com/api-docs/index.html[TRMNL API]
 :dry_monads_link: link:https://dry-rb.org/gems/dry-monads[Dry Monads]
 
 = TRMNL API
 
-A monadic {trmnl_link} API client. You can use this client in your own code to interact with our APIs for any/all devices that you own.
+A monadic {trmnl_api_link} client. You can use this client in your own code to interact with our APIs for any/all devices that you own.
 
 toc::[]
 
 == Features
 
-* Provides {trmnl_link} API access.
+* Provides {trmnl_api_link} access.
 
 == Requirements
 
@@ -48,7 +49,7 @@ require "trmnl/api"
 This client provides access to multiple endpoints. Each endpoint will answer either a `Success` or `Failure` (as provided by {dry_monads_link}) based on result of the API call. This allows you pattern match in your own code when using each endpoint. Example:
 
 ``` ruby
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 
 case client.display token: "secret"
   in Success(payload) then puts payload
@@ -65,7 +66,7 @@ By default, you shouldn't need to change the default configuration but you can a
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new do |settings|
+client = TRMNL::API.new do |settings|
   settings.content_type = "application/json",
   settings.uri = "https://trmnl.app/api"
 end
@@ -88,7 +89,7 @@ Allows you to obtain the list of approved plugin categories. Example:
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 client.categories
 
 # Success(
@@ -106,7 +107,7 @@ Allows you to obtain current screen being displayed for your device. You must su
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 client.current_screen token: "secret"
 
 # Success(
@@ -124,7 +125,7 @@ Allows you to obtain current screen being displayed for your device with additio
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 client.display token: "secret"
 
 # Success(
@@ -147,7 +148,7 @@ Allows you to obtain the current stable firmware version. Example:
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 client.firmware
 
 # Success(#<data TRMNL::API::Models::Firmware url="https://trmnl-fw.s3.us-east-2.amazonaws.com/FW1.4.8.bin", version="1.4.8">)
@@ -159,7 +160,7 @@ Allows you obtain a list of public IP addresses for all TRMNL core servers becau
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 client.ip_addresses
 
 # Success(
@@ -182,7 +183,7 @@ Allows you to create a log entry (which is what the device reports when it captu
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 client.log token: "secret",
             log: {
               logs_array: [
@@ -221,7 +222,7 @@ Allows you to obtain the model information for all devices and screens. Example:
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 client.models
 
 # Success(
@@ -276,7 +277,7 @@ Allows you to obtain palettes details. The IDs correlate to the `palette_ids` as
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 client.palettes
 
 Success(
@@ -299,13 +300,93 @@ Success(
 )
 ----
 
+==== Recipes
+
+Allows you to obtain information about link:https://usetrmnl.com/recipes[Recipes]. Example:
+
+[source,ruby]
+----
+client = TRMNL::API.new { |settings| settings.uri = "https://usetrmnl.com" }
+
+client.recipes                     # Answers first page.
+client.recipes page: 10            # Answers page ten.
+client.recipes search: "comic"     # Answers first page of comics.
+client.recipes sort: "popularity"  # Answers first page sorted by popularity.
+
+# Success(
+#  #<data TRMNL::API::Models::Recipe:0x00010fc0
+#    data = [
+#      #<Struct:TRMNL::API::Models::Recipes::Data:0x00010fe0
+#        author = #<Struct:TRMNL::API::Models::Recipes::Author:0x00010ff0
+#          category = nil,
+#          description = nil,
+#          description_locales = {},
+#          email_address = nil,
+#          field_type = nil,
+#          github_url = nil,
+#          keyname = nil,
+#          learn_more_url = nil,
+#          name = nil,
+#          youtube_url = nil
+#        >,
+#        custom_fields = [
+#          {
+#                "keyname" => "user_location",
+#             "field_type" => "string",
+#                   "name" => "Weather Location",
+#            "placeholder" => "New York, NY",
+#            "description" => "Choose a location",
+#              "help_text" => "Please be precise...",
+#               "required" => true
+#          },
+#          {
+#                "keyname" => "metric",
+#                   "name" => "Temperature Metric",
+#            "description" => "Celsius or Fahrenheit?",
+#             "field_type" => "select",
+#                "options" => [
+#              "Fahrenheit",
+#              "Celsius"
+#            ],
+#                "default" => "Fahrenheit"
+#          }
+#        ],
+#        icon_content_type = "image/png",
+#        icon_url = "https://trmnl-public.s3.us-east-2.amazonaws.com/ajjlbek4cabcvhk3s1lxggn8cgon",
+#        id = 49610,
+#        name = "Weather Chum",
+#        published_at = 2025-05-14 05:32:00 UTC,
+#        screenshot_url = "https://trmnl.s3.us-east-2.amazonaws.com...",
+#        statistics = #<data TRMNL::API::Models::Recipes::Statistics:0x00011170
+#          forks = 1710,
+#          installs = 1
+#        >
+#      >
+#    ],
+#    meta = #<data TRMNL::API::Models::Recipes::Meta:0x00016e20
+#      current_page = 1,
+#      from = 1,
+#      next_page_url = "/recipes.json?page=2&sort_by=popularity",
+#      per_page = 25,
+#      prev_page_url = nil,
+#      to = 25,
+#      total = 678
+#    >
+#  >
+# )
+----
+
+⚠️ This _does not_ use the {trmnl_api_link} like every other endpoint documented here. Instead, you must customize the settings URI to point to the root of the TRMNL application (i.e. `https://usetrmnl.com`) instead of using the default API endpoint.
+
+You'll always get a `data` array which may or may not be filled and `meta` (metadata) for handling pagination information. You can also combine the `page`, `search`, and `page` parameters as you see fit.
+
 ==== Setup
 
 Allows you to obtain the setup response for when a new device is setup. You must supply your device's MAC Address as the `id`. Example:
 
 [source,ruby]
 ----
-client = TRMNL::API::Client.new
+client = TRMNL::API.new
 client.setup id: "A1:B2:C3:D4:E5:F6"
 
 # Success(

data/lib/trmnl/api/client.rb

@@ -7,53 +7,56 @@ module TRMNL
     # Provides the primary client for making API requests.
     class Client
       include Dependencies[:settings]
+      include Inspectable[:endpoints]
+
+      ENDPOINTS = {
+        categories: Endpoints::Category,
+        current_screen: Endpoints::CurrentScreen,
+        display: Endpoints::Display,
+        firmware: Endpoints::Firmware,
+        ip_addresses: Endpoints::IPAddress,
+        log: Endpoints::Log,
+        models: Endpoints::Model,
+        palettes: Endpoints::Palette,
+        recipes: Endpoints::Recipe,
+        setup: Endpoints::Setup
+      }.freeze
+
+      def initialize(requester: Requester, endpoints: ENDPOINTS, **)
+        super(**)
 
-      include Endpoints::Dependencies[
-        endpoint_categories: :categories,
-        endpoint_current_screen: :current_screen,
-        endpoint_display: :display,
-        endpoint_firmware: :firmware,
-        endpoint_ip_addresses: :ip_addresses,
-        endpoint_log: :log,
-        endpoint_models: :models,
-        endpoint_palettes: :palettes,
-        endpoint_setup: :setup
-      ]
-
-      include Inspectable[
-        endpoint_categories: :type,
-        endpoint_current_screen: :type,
-        endpoint_display: :type,
-        endpoint_firmware: :type,
-        endpoint_ip_addresses: :type,
-        endpoint_log: :type,
-        endpoint_models: :type,
-        endpoint_palettes: :type,
-        endpoint_setup: :type
-      ]
-
-      def initialize(**)
-        super
         yield settings if block_given?
+
+        requester = requester.new(settings:)
+
+        @endpoints = endpoints.each.with_object({}) do |(key, value), all|
+          all[key] = value.new requester:
+        end
       end
 
-      def categories = endpoint_categories.call
+      def categories = endpoints.fetch(__method__).call
+
+      def current_screen(**) = endpoints.fetch(__method__).call(**)
+
+      def display(**) = endpoints.fetch(__method__).call(**)
+
+      def firmware = endpoints.fetch(__method__).call
 
-      def current_screen(**) = endpoint_current_screen.call(**)
+      def ip_addresses = endpoints.fetch(__method__).call
 
-      def display(**) = endpoint_display.call(**)
+      def log(**) = endpoints.fetch(__method__).call(**)
 
-      def firmware = endpoint_firmware.call
+      def models(**) = endpoints.fetch(__method__).call(**)
 
-      def ip_addresses = endpoint_ip_addresses.call
+      def palettes = endpoints.fetch(__method__).call
 
-      def log(**) = endpoint_log.call(**)
+      def recipes(**) = endpoints.fetch(__method__).call(**)
 
-      def models(**) = endpoint_models.call(**)
+      def setup(**) = endpoints.fetch(__method__).call(**)
 
-      def palettes = endpoint_palettes.call
+      private
 
-      def setup(**) = endpoint_setup.call(**)
+      attr_reader :endpoints
     end
   end
 end

data/lib/trmnl/api/container.rb

@@ -10,7 +10,7 @@ module TRMNL
     module Container
       extend Containable
 
-      register(:settings) { TRMNL::API::Configuration::Loader.new.call }
+      register(:settings, as: :fresh) { TRMNL::API::Configuration::Loader.new.call }
       register(:requester) { API::Requester.new }
       register(:logger) { Cogger.new id: "trmnl-api", formatter: :json }
 
@@ -27,6 +27,7 @@ module TRMNL
         register :ip_address, Contracts::IPAddress
         register :model, Contracts::Model
         register :palette, Contracts::Palette
+        register :recipe, Contracts::Recipe
         register :setup, Contracts::Setup
       end
 
@@ -37,6 +38,7 @@ module TRMNL
         register :ip_address, Models::IPAddress
         register :model, Models::Model
         register :palette, Models::Palette
+        register :recipe, Models::Recipe
         register :setup, Models::Setup
       end
     end

data/lib/trmnl/api/contracts/recipe.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "dry/schema"
+
+module TRMNL
+  module API
+    module Contracts
+      # Validates API response.
+      Recipe = Dry::Schema.JSON do
+        required(:data).array(:hash) do
+          required(:id).filled :integer
+          required(:name).filled :string
+          required(:screenshot_url).filled :string
+          required(:published_at).filled :time
+          optional(:icon_url).maybe :string
+          optional(:icon_content_type).maybe :string
+          required(:author_bio).maybe Recipes::Author
+          required(:custom_fields).array(:hash)
+
+          required(:stats).filled :hash do
+            required(:installs).filled :integer
+            required(:forks).filled :integer
+          end
+        end
+
+        required(:total).filled :integer
+        required(:from).filled :integer
+        required(:to).filled :integer
+        required(:per_page).filled :integer
+        required(:current_page).filled :integer
+        required(:prev_page_url).maybe :string
+        required(:next_page_url).maybe :string
+      end
+    end
+  end
+end

data/lib/trmnl/api/contracts/recipes/author.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require "dry/schema"
+
+module TRMNL
+  module API
+    module Contracts
+      module Recipes
+        # Validates API response.
+        Author = Dry::Schema.JSON do
+          required(:keyname).filled :string
+          required(:name).filled :string
+          required(:field_type).filled :string
+          optional(:category).filled :string
+          optional(:description).filled :string
+          optional(:"description-de").filled :string
+          optional(:"description-nl").filled :string
+          optional(:"description-fr").filled :string
+          optional(:"description-en").filled :string
+          optional(:"description-en-GB").filled :string
+          optional(:"description-es-ES").filled :string
+          optional(:"description-it").filled :string
+          optional(:"description-no").filled :string
+          optional(:"description-da").filled :string
+          optional(:"description-ja").filled :string
+          optional(:"description-de-AT").filled :string
+          optional(:"description-ko").filled :string
+          optional(:"description-sv").filled :string
+          optional(:"description-pt-BR").filled :string
+          optional(:"description-zh-HK").filled :string
+          optional(:"description-pl").filled :string
+          optional(:"description-uk").filled :string
+          optional(:"description-zh-CN").filled :string
+          optional(:"description-hu").filled :string
+          optional(:"description-he").filled :string
+          optional(:"description-sk").filled :string
+          optional(:"description-ru").filled :string
+          optional(:"description-is").filled :string
+          optional(:"description-id").filled :string
+          optional(:email_address).filled :string
+          optional(:learn_more_url).filled :string
+          optional(:github_url).filled :string
+          optional(:youtube_url).filled :string
+        end
+      end
+    end
+  end
+end

data/lib/trmnl/api/endpoints/container.rb

@@ -17,6 +17,7 @@ module TRMNL
         register(:log) { Log.new }
         register(:models) { Model.new }
         register(:palettes) { Palette.new }
+        register(:recipes) { Recipe.new }
         register(:setup) { Setup.new }
       end
     end

data/lib/trmnl/api/endpoints/recipe.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "inspectable"
+require "pipeable"
+require "refinements/hash"
+
+module TRMNL
+  module API
+    module Endpoints
+      # Handles API request/response.
+      class Recipe
+        include TRMNL::API::Dependencies[
+          :requester,
+          contract: "contracts.recipe",
+          model: "models.recipe"
+        ]
+
+        include Inspectable[contract: :type]
+        include Pipeable
+
+        using Refinements::Hash
+
+        def call(**parameters)
+          parameters.transform_keys! sort: "sort-by"
+
+          pipe(
+            requester.get("recipes.json", **parameters),
+            try(:parse, catch: JSON::ParserError),
+            validate(contract, as: :to_h),
+            to(model, :for)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/trmnl/api/locale_reducer.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module TRMNL
+  module API
+    LocaleReducer = lambda do |attributes, prefix: "description-"|
+      attributes.each.with_object({}) do |(key, value), all|
+        next unless key.start_with? prefix
+
+        attributes.delete key
+        all[key.to_s.delete_prefix(prefix)] = value
+      end
+    end
+  end
+end

data/lib/trmnl/api/models/current_screen.rb

@@ -3,8 +3,8 @@
 module TRMNL
   module API
     module Models
-      # Models API response.
-      CurrentScreen = Data.define :refresh_rate, :image_url, :filename do
+      # Models the data of the API response.
+      CurrentScreen = ::Data.define :refresh_rate, :image_url, :filename do
         def self.for(attributes) = new(**attributes)
       end
     end

data/lib/trmnl/api/models/display.rb

@@ -3,7 +3,7 @@
 module TRMNL
   module API
     module Models
-      # Models data for API display responses.
+      # Models the data of the API response.
       Display = Struct.new(
         :filename,
         :firmware_url,

data/lib/trmnl/api/models/firmware.rb

@@ -3,8 +3,8 @@
 module TRMNL
   module API
     module Models
-      # Models API response.
-      Firmware = Data.define :url, :version do
+      # Models the data of the API response.
+      Firmware = ::Data.define :url, :version do
         def self.for(attributes) = new(**attributes)
       end
     end

data/lib/trmnl/api/models/ip_address.rb

@@ -3,8 +3,8 @@
 module TRMNL
   module API
     module Models
-      # IPs API response.
-      IPAddress = Data.define :version_4, :version_6 do
+      # Models the data of the API response.
+      IPAddress = ::Data.define :version_4, :version_6 do
         def self.for attributes
           new(**attributes.transform_keys(ipv4: :version_4, ipv6: :version_6))
         end

data/lib/trmnl/api/models/model.rb

@@ -3,7 +3,7 @@
 module TRMNL
   module API
     module Models
-      # Models data for API display responses.
+      # Models the data of the API response.
       Model = Struct.new(
         :name,
         :label,

data/lib/trmnl/api/models/palette.rb

@@ -3,8 +3,8 @@
 module TRMNL
   module API
     module Models
-      # IPs API response.
-      Palette = Data.define :id, :name, :grays, :colors, :framework_class do
+      # Models the data of the API response.
+      Palette = Struct.new :id, :name, :grays, :colors, :framework_class do
         def self.for(attributes) = new(**attributes)
       end
     end

data/lib/trmnl/api/models/recipe.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module TRMNL
+  module API
+    module Models
+      # Models the payload of the API response.
+      Recipe = ::Data.define :data, :meta do
+        def self.for(**attributes)
+          meta = attributes.slice :from,
+                                  :to,
+                                  :current_page,
+                                  :per_page,
+                                  :total,
+                                  :prev_page_url,
+                                  :next_page_url
+
+          data = attributes[:data].map { Recipes::Data.for(**it) }
+
+          new meta: Recipes::Meta[**meta], data:
+        end
+      end
+    end
+  end
+end

data/lib/trmnl/api/models/recipes/author.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module TRMNL
+  module API
+    module Models
+      module Recipes
+        # Models the author of the API response.
+        Author = Struct.new(
+          :keyname,
+          :name,
+          :field_type,
+          :category,
+          :description,
+          :description_locales,
+          :email_address,
+          :learn_more_url,
+          :github_url,
+          :youtube_url
+        ) do
+          def self.for(locale_reducer: LocaleReducer, **attributes)
+            description_locales = locale_reducer.call attributes
+            new(description_locales:, **attributes)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/trmnl/api/models/recipes/data.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module TRMNL
+  module API
+    module Models
+      module Recipes
+        # Models the data of the API response.
+        Data = Struct.new(
+          :id,
+          :name,
+          :icon_url,
+          :icon_content_type,
+          :screenshot_url,
+          :author,
+          :custom_fields,
+          :statistics,
+          :published_at
+        ) do
+          def self.for(**attributes)
+            new(
+              **attributes.merge!(
+                author: Author.for(**attributes.delete(:author_bio)),
+                statistics: Statistics[**attributes.delete(:stats)]
+              )
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/trmnl/api/models/recipes/meta.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module TRMNL
+  module API
+    module Models
+      module Recipes
+        # Models the metadata of the API response.
+        Meta = ::Data.define(
+          :from,
+          :to,
+          :current_page,
+          :per_page,
+          :total,
+          :prev_page_url,
+          :next_page_url
+        ) do
+          def initialize from: 0,
+                         to: 0,
+                         current_page: 0,
+                         per_page: 0,
+                         total: 0,
+                         prev_page_url: nil,
+                         next_page_url: nil
+            super
+          end
+
+          def more? = to.positive? && to < total
+
+          def next_page = current_page + 1
+        end
+      end
+    end
+  end
+end

data/lib/trmnl/api/models/recipes/statistics.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module TRMNL
+  module API
+    module Models
+      module Recipes
+        # Models the statistics of the API response.
+        Statistics = ::Data.define :installs, :forks
+      end
+    end
+  end
+end

data/lib/trmnl/api/models/setup.rb

@@ -3,8 +3,8 @@
 module TRMNL
   module API
     module Models
-      # Models API response.
-      Setup = Data.define :api_key, :friendly_id, :image_url, :message do
+      # Models the data of the API response.
+      Setup = ::Data.define :api_key, :friendly_id, :image_url, :message do
         def self.for(attributes) = new(**attributes)
       end
     end

data/lib/trmnl/api/requester.rb

@@ -23,18 +23,20 @@ module TRMNL
 
       private
 
-      attr_reader :settings, :http
-
       def call method, path, headers, **options
         http.headers(settings.headers.merge(headers))
             .public_send(method, uri(path), options)
             .then { |response| response.status.success? ? Success(response) : Failure(response) }
+      rescue HTTP::RequestError => error then handle_bad_request path, error
       rescue HTTP::ConnectionError => error then handle_bad_connection path, error
       rescue HTTP::TimeoutError => error then handle_timeout path, error
       rescue OpenSSL::SSL::SSLError => error then handle_bad_ssl path, error
       end
 
-      def uri(path) = "#{settings.uri}/#{path}"
+      def handle_bad_request path, error
+        logger.debug { error.message }
+        Failure "Unable to make request: #{uri(path).inspect}. Is the URI valid?"
+      end
 
       def handle_bad_connection path, error
         logger.debug { error.message }
@@ -51,6 +53,8 @@ module TRMNL
         Failure "Unable to secure connection: #{uri(path).inspect}. " \
                 "Is your certificate or SSL valid?"
       end
+
+      def uri(path) = "#{settings.uri}/#{path}"
     end
   end
 end

data/trmnl-api.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "trmnl-api"
-  spec.version = "0.8.0"
+  spec.version = "0.10.0"
   spec.authors = ["TRMNL"]
   spec.email = ["engineering@usetrmnl.com"]
   spec.homepage = "https://github.com/usetrmnl/trmnl-api"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trmnl-api
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.10.0
 platform: ruby
 authors:
 - TRMNL
@@ -197,6 +197,8 @@ files:
 - lib/trmnl/api/contracts/ip_address.rb
 - lib/trmnl/api/contracts/model.rb
 - lib/trmnl/api/contracts/palette.rb
+- lib/trmnl/api/contracts/recipe.rb
+- lib/trmnl/api/contracts/recipes/author.rb
 - lib/trmnl/api/contracts/setup.rb
 - lib/trmnl/api/dependencies.rb
 - lib/trmnl/api/endpoints/category.rb
@@ -209,13 +211,20 @@ files:
 - lib/trmnl/api/endpoints/log.rb
 - lib/trmnl/api/endpoints/model.rb
 - lib/trmnl/api/endpoints/palette.rb
+- lib/trmnl/api/endpoints/recipe.rb
 - lib/trmnl/api/endpoints/setup.rb
+- lib/trmnl/api/locale_reducer.rb
 - lib/trmnl/api/models/current_screen.rb
 - lib/trmnl/api/models/display.rb
 - lib/trmnl/api/models/firmware.rb
 - lib/trmnl/api/models/ip_address.rb
 - lib/trmnl/api/models/model.rb
 - lib/trmnl/api/models/palette.rb
+- lib/trmnl/api/models/recipe.rb
+- lib/trmnl/api/models/recipes/author.rb
+- lib/trmnl/api/models/recipes/data.rb
+- lib/trmnl/api/models/recipes/meta.rb
+- lib/trmnl/api/models/recipes/statistics.rb
 - lib/trmnl/api/models/setup.rb
 - lib/trmnl/api/requester.rb
 - lib/trmnl/api/types.rb
@@ -244,7 +253,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.4
 specification_version: 4
 summary: A monadic TRMNL API client.
 test_files: []