dato-rails 0.5.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 911f15a149ea496d7b60b9d1890fbc5014152c8f2c87e86d62025ca974415a6b
-  data.tar.gz: e043584a63573e2ba261a4a314b09a33de91f8259a9bc5ecb070590e9e6762bc
+  metadata.gz: 7753883f681ceec3735a3ada67751e4ef59256775f99ddc4916c469e42119d83
+  data.tar.gz: 721f2b1c13b67796a74626bb9844b9d07aa6b0911f068e926fa1154cb4a76960
 SHA512:
-  metadata.gz: 9693562a097f1663f46df5736ebb61beee103ef34127eff8dc19e681390612cb66da1b5bde29dd62cbdc0c3d764d782d1201e7483b0f70659bdd44f6d5de7064
-  data.tar.gz: efd0f16c08406b2c2e0440d5980f70c1a783189e280ccf53fac37149a8308e9ace91eeecd59790d3e21278915348c1d1263bc074330cd801783210d2cd01e1e2
+  metadata.gz: 24b79eac4a15ca805d42151faa392f4174cdb53ccd5a9f253021d6f37c80736ace8a14ce04331e22acdaeb855abe39d99a7b3702fee140d49c6d586448d10791
+  data.tar.gz: fcf8912566cc3a242290a53b82e8337fe3306a7d6aea2073caba9ed8027923424ab173048974abdbd799f5843bb095711ada2ab415f6956e80a54ab479105e26

data/README.md

@@ -26,7 +26,7 @@ The gem is made of two parts:
 
 ## GraphQL client
 
-The GraphQL client based on [GQLi](https://github.com/contentful-labs/gqli.rb) allows to perform 
+The GraphQL client based on [GQLi](https://github.com/contentful-labs/gqli.rb) allows to perform
 queries to the GraphQL endpoint.
 Look at GQLi documentation for more information about the syntax of queries.
 You can also find some examples in specs of this library.
@@ -104,7 +104,7 @@ Dato::Config.overrides = {
 }.with_indifferent_access
 ```
 
-# Preview and live
+## Preview and live
 
 The `Dato::Client` supports both [preview](https://www.datocms.com/docs/pro-tips/how-to-manage-a-live-and-a-preview-site) and [live updates](https://www.datocms.com/docs/real-time-updates-api) features from Dato CMS.
 
@@ -134,6 +134,40 @@ render(Dato::Live.new(MyComponent, my_query, preview: true, live: true))
 
 and your component will come to life with live updates 🎉 (requires turbo).
 
+## CRUD Operations
+
+The library also provides a set of helpers to perform CRUD operations on Dato CMS.
+
+### All
+
+```ruby
+Dato::Client.new.items.all(item_type_id: '456')
+```
+
+### Find
+
+```ruby
+Dato::Client.new.items.find(item_id: '123')
+```
+
+### Create
+
+```ruby
+Dato::Client.new.items.create(attributes: { title: 'Hello world' }, item_type_id: '456')
+```
+
+### Update
+
+```ruby
+Dato::Client.new.items.update(attributes: { title: 'Hello world' }, item_id: '123')
+```
+
+### Destroy
+
+```ruby
+Dato::Client.new.items.destroy(item_id: '123')
+```
+
 ## Configuration
 
 The following options are available:
@@ -153,7 +187,7 @@ end
 
 ## Caching
 
-The library supports caching of the rendered components. 
+The library supports caching of the rendered components.
 If you enable caching, the components rendered using `Dato::Live`, will be cached.
 
 To enable caching, you need to set the `cache` option in the configuration.

data/app/components/dato/live.html.erb

@@ -16,11 +16,7 @@
 
   <%= turbo_frame_tag frame_id %>
 <% else %>
-  <% if cache? %>
-    <%= Rails.cache.fetch(cache_key, expires_in: cache_time, namespace: Dato::Config.cache_namespace) do %>
-      <% render(component_klass.new(data)) %>
-    <% end %>
-  <% else %>
-    <%= render(component_klass.new(data)) %>
+  <%= Dato::Cache.fetch(cache_key) do %>
+    <% render(component_klass.new(data)) %>
   <% end %>
 <% end %>

data/app/components/dato/live.rb

@@ -17,18 +17,10 @@ module Dato
       @live = live
     end
 
-    def cache?
-      Dato::Config.cache.present?
-    end
-
     def cache_key
       @cache_key ||= Digest::MD5.hexdigest(query.to_gql)
     end
 
-    def cache_time
-      @cache_time ||= Dato::Config.cache.is_a?(Integer) ? Dato::Config.cache : 60.minutes
-    end
-
     def data
       @data ||= dato_fetch(query, preview: preview, live: live)
     end

data/lib/dato/cache.rb

@@ -0,0 +1,25 @@
+module Dato
+  class Cache
+    def self.fetch(cache_key, &block)
+      if active?
+        Rails.cache.fetch(cache_key, expires_in: expires_in, namespace: namespace) do
+          block.call
+        end
+      else
+        block.call
+      end
+    end
+
+    def self.active?
+      Dato::Config.cache.present?
+    end
+
+    def self.expires_in
+      Dato::Config.cache.is_a?(Integer) ? Dato::Config.cache : 60.minutes
+    end
+
+    def self.namespace
+      Dato::Config.cache_namespace
+    end
+  end
+end

data/lib/dato/client.rb

@@ -1,33 +1,12 @@
 module Dato
-  class Client < GQLi::Client
+  class Client
+    delegate :live!, :execute!, :execute, to: :@gql
+    attr_reader :items, :gql
+
     def initialize(api_token = Dato::Config.api_token, validate_query: false, preview: false, live: false)
       @api_token = api_token
-      super(
-        "https://graphql#{"-listen" if live}.datocms.com/#{"preview" if preview}",
-        headers: {
-          "Authorization" => @api_token
-        },
-        validate_query: validate_query && !live
-      )
-    end
-
-    def live!(query)
-      http_response = request.post(@url, params: @params, json: {query: query.to_gql})
-
-      fail "Error: #{http_response.reason}\nBody: #{http_response.body}" if http_response.status >= 300
-
-      parsed_response = JSON.parse(http_response.to_s)
-      errors = parsed_response["errors"]
-      GQLi::Response.new(parsed_response, errors, query)
-    end
-
-    def search(query)
-      url = "https://site-api.datocms.com/search-results?query=#{query}&filter[build_trigger_id]=''"
-      response = HTTP.headers({
-        "Authorization" => "Bearer #{@api_token}",
-        "Accept" => "application/json",
-        "X-Api-Version" => 3
-      }).timeout(timeout_options).get(url)
+      @gql = Dato::Gql.new(api_token, validate_query, preview, live)
+      @items = Dato::Items.new(api_token)
     end
   end
 end

data/lib/dato/gql.rb

@@ -0,0 +1,24 @@
+module Dato
+  class Gql < GQLi::Client
+    def initialize(api_token, validate_query, preview, live)
+      @api_token = api_token
+      super(
+        "https://graphql#{"-listen" if live}.datocms.com/#{"preview" if preview}",
+        headers: {
+          "Authorization" => @api_token
+        },
+        validate_query: validate_query && !live
+      )
+    end
+
+    def live!(query)
+      http_response = request.post(@url, params: @params, json: {query: query.to_gql})
+
+      fail "Error: #{http_response.reason}\nBody: #{http_response.body}" if http_response.status >= 300
+
+      parsed_response = JSON.parse(http_response.to_s)
+      errors = parsed_response["errors"]
+      GQLi::Response.new(parsed_response, errors, query)
+    end
+  end
+end

data/lib/dato/items.rb

@@ -0,0 +1,46 @@
+module Dato
+  class Items
+    BASE_ITEM_URL = "https://site-api.datocms.com/items"
+
+    def initialize(api_token)
+      @http_headers = HTTP.headers({"Authorization" => "Bearer #{api_token}",
+                                     "Accept" => "application/json",
+                                     "X-Api-Version" => 3})
+    end
+
+    def find(item_id:)
+      @http_headers.get("#{BASE_ITEM_URL}/#{item_id}")
+    end
+
+    def all(item_type_id:)
+      @http_headers.get("#{BASE_ITEM_URL}?filter[type]=#{item_type_id}")
+    end
+
+    def create(item_type_id:, attributes:, meta: nil)
+      data = create_attributes(attributes, item_type_id)
+      data[:meta] = meta if meta
+      @http_headers.post(BASE_ITEM_URL, json: {data: data})
+    end
+
+    def update(attributes:, item_id:)
+      data = {type: "item", attributes: attributes, id: item_id}
+      @http_headers.put("#{BASE_ITEM_URL}/#{item_id}", json: {data: data})
+    end
+
+    def destroy(item_id:)
+      @http_headers.delete("#{BASE_ITEM_URL}/#{item_id}")
+    end
+
+    private
+
+    def create_attributes(attributes, item_type_id)
+      {
+        type: "item",
+        attributes: attributes,
+        relationships: {
+          item_type: {data: {type: "item_type", id: item_type_id}}
+        }
+      }
+    end
+  end
+end

data/lib/dato/version.rb

@@ -1,3 +1,3 @@
 module Dato
-  VERSION = "0.5.0"
+  VERSION = "0.7.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dato-rails
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Alessandro Rodi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-02-14 00:00:00.000000000 Z
+date: 2023-05-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-rails
@@ -209,10 +209,13 @@ files:
 - app/views/dato/live/show.html.erb
 - config/routes.rb
 - lib/dato.rb
+- lib/dato/cache.rb
 - lib/dato/client.rb
 - lib/dato/config.rb
 - lib/dato/engine.rb
 - lib/dato/fragments/responsive_image.rb
+- lib/dato/gql.rb
+- lib/dato/items.rb
 - lib/dato/version.rb
 - lib/tasks/dato/rails_tasks.rake
 homepage: https://github.com/renuo/dato-rails