contemble 0.1.3 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 99fe1246d4eccb72cd14d795ff92c7fa39280a8f03f3c818c9365bf5813079b9
-  data.tar.gz: 16c7878a6a9e7539d92b8416183d8533cea6cace9d63e5e9822e8703e8e077ec
+  metadata.gz: a7e43e5e52bb7623cf2f0f5caccaa49c4ee477fd6aa8084fb22f69c2ef1c85df
+  data.tar.gz: b99068ed77740799c1b7f523358bae21721d50524fd91e77dec9675c05a0c7e0
 SHA512:
-  metadata.gz: e8d15a8ec3cd72266ac8b5e0092e404f865d4f91b0b4ec9d245f66bb51c94c7271448d7dd90ba2c7e7cc40f38d74a70ebd504cd369269c1ebdd76e00f3823ec9
-  data.tar.gz: 5f37a5a2585b0f7ef02fa6e0e593d18d58f36fd19f87952d36f278362e8958db0879eb33c94392896e462b2dc507024ec1ad25cfcc6cee561f3771ca68f1fa88
+  metadata.gz: a8ad1c2765315049eee9d9e8ba2b07c8a9027302ae5508de1cf9507a0b99c2664fa66a39f92698f144c22cca505781d2e3ed22a1f238cd698df58512e417c358
+  data.tar.gz: d29318b90501772eb58a3eb799bc9a71e4095f2790a5c9a9fe4446e9414b70e413c2f24ee0bd70eccc505f424450ff53c6d3ce43e85cf031fcfb24fc26a47328

data/README.md

@@ -37,11 +37,21 @@ posts = client.collections.posts
 # Get posts from specific collection
 posts = client.collections.posts(collection_name: "blog")
 
+# Get posts with pagination
+result = client.collections.posts(collection_name: "blog", page: 2, per_page: 50)
+result["data"] # Array of posts
+result["meta"]["pagination"]["page"] # Current page
+result["meta"]["pagination"]["pageCount"] # Total pages
+result["meta"]["pagination"]["total"] # Total posts
+
 # Get individual post
 post = client.posts.show(slug: "post-slug")
 
 # Get sitemap XML
 sitemap_xml = client.sitemap.xml
+
+# Get article schema
+article_schema = client.schema.article(slug: "post-slug")
 ```
 
 ### Available Data
@@ -65,6 +75,48 @@ sitemap_xml = client.sitemap.xml
 
 Each post includes a `url` field for easy linking based on your configured `post_path`.
 
+### Pagination
+
+By default, `posts()` returns the first 20 posts. Pagination metadata is included in the response body.
+
+```ruby
+# Get page 2 with 50 posts per page
+result = client.collections.posts(collection_name: "blog", page: 2, per_page: 50)
+
+# Access posts
+result["data"]
+
+# Access pagination metadata
+result["meta"]["pagination"]["page"]       # Current page (2)
+result["meta"]["pagination"]["pageSize"]   # Posts per page (50)
+result["meta"]["pagination"]["pageCount"]  # Total pages available
+result["meta"]["pagination"]["total"]      # Total number of posts
+```
+
+Response format:
+
+```json
+{
+  "data": [
+    {
+      "slug": "post-slug",
+      "title": "Post Title",
+      ...
+    }
+  ],
+  "meta": {
+    "pagination": {
+      "page": 2,
+      "pageSize": 50,
+      "pageCount": 10,
+      "total": 500
+    }
+  }
+}
+```
+
+Maximum posts per page is 100. Defaults: `page: 1`, `per_page: 20`.
+
 **Sitemap XML** returns ready-to-use XML that can be saved to a file, proxied through your server, or included in your sitemap index.
 
 ### Sitemap Usage
@@ -87,6 +139,24 @@ end
 
 The sitemap URLs will use your configured base URL from your Contemble team settings. For large teams with many posts, this will automatically return a sitemap index that references multiple sitemap files.
 
+### Schema Usage
+
+```ruby
+client = Contemble::Client.new(api_key: "your_api_key")
+
+# Get JSON-LD schema for a specific article
+schema = client.schema.article(slug: "my-post")
+
+# Use in your Rails template
+content_for :head do
+  content_tag :script, type: "application/ld+json" do
+    raw schema.to_json
+  end
+end
+```
+
+**Article Schema** returns JSON-LD structured data including headline, description, dates, images, and publisher information for SEO rich snippets.
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/contemble/client.rb

@@ -25,6 +25,10 @@ module Contemble
       @sitemap ||= Resources::Sitemap.new(self)
     end
 
+    def schema
+      @schema ||= Resources::Schema.new(self)
+    end
+
     def get(path, params = {})
       uri = URI("#{@base_url}#{path}")
       uri.query = URI.encode_www_form(params) unless params.empty?

data/lib/contemble/resources.rb

@@ -11,25 +11,30 @@ module Contemble
         @client.get("/collections")
       end
 
-      def posts(collection_name: nil)
-        posts = if collection_name
-                  @client.get("/collections/#{collection_name}")
-        else
-                  collections = list
-                  all_posts = []
+      def posts(collection_name: nil, page: 1, per_page: 20)
+        if collection_name
+          response = @client.get("/collections/#{collection_name}?page=#{page}&per_page=#{per_page}")
 
-                  collections.each do |collection|
-                    posts = @client.get("/collections/#{collection["name"]}")
-                    all_posts.concat(posts)
-                  end
+          posts_data = response["data"].map do |post|
+            post.merge("url" => "#{Contemble.post_path}/#{post["slug"]}")
+          end
 
-                  all_posts
-        end
+          {
+            "data" => posts_data,
+            "meta" => response["meta"]
+          }
+        else
+          collections = list
+          all_posts = []
 
-        posts.map do |post|
-          post.merge(
-            "url" => "#{Contemble.post_path}/#{post["slug"]}"
-          )
+          collections.each do |collection|
+            response = @client.get("/collections/#{collection["name"]}?page=#{page}&per_page=#{per_page}")
+            all_posts.concat(response["data"])
+          end
+
+          all_posts.map do |post|
+            post.merge("url" => "#{Contemble.post_path}/#{post["slug"]}")
+          end
         end
       end
     end
@@ -40,7 +45,8 @@ module Contemble
       end
 
       def show(slug:)
-        @client.get("/posts/#{slug}")
+        response = @client.get("/posts/#{slug}")
+        response["data"]
       end
     end
 
@@ -53,5 +59,15 @@ module Contemble
         @client.get_xml("/sitemap.xml")
       end
     end
+
+    class Schema
+      def initialize(client)
+        @client = client
+      end
+
+      def article(slug:)
+        @client.get("/posts/#{slug}/schema")
+      end
+    end
   end
 end

data/lib/contemble/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Contemble
-  VERSION = "0.1.3"
+  VERSION = "0.1.5"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: contemble
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - contemble