contemble 0.1.4 → 0.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d24648e5804b56f09d868bc242a5111a94e1d933105c358f3ed97663e1c1a954
-  data.tar.gz: 82a446c690a080657b2fb3c82e9bac37bb84aa1313c437eebb912bf7e82e3d61
+  metadata.gz: b058a19e98e56f6ba9c49430fee756b676cbd3e48366ea721cc4719bb37f870e
+  data.tar.gz: c05b723a8c44d7c664af4d919d8b8e6efa4be1e076d7522038876bb3206b67c1
 SHA512:
-  metadata.gz: 1c4332db2ccc94acda3db69fcf3819db356639fa5e49217e396a952045ece72f00a40483c084c2b0bba022bedf2a88b4b32676c51c015c68b4dacea2bc8f5388
-  data.tar.gz: 325fdc43ec857e1f5778d4e3868e0f07a20d5f231b8c1d3e5bd2e2de9f38ab9828a1a8a2529c0acb54d79617dd46d47354f86fc5dadd1976c21e32d675c39c2c
+  metadata.gz: a7360c02eba0e5865fcb207d8e9e2058b1a9423d4e6ccbc7867eb5b52a74586349698d8a64d2a7ca0debd914f38f6ff7e7da51f7da833b1042edb33233f1a16f
+  data.tar.gz: 10ab0a8c84cfe29c3f3edb38227d8143e9d29164a5a9bd171f8484b4b664f3b66a155a0206f3599e68767ec37ca0f19eacee7404471d0f9cbaafb295f675b8aa

data/README.md

@@ -37,6 +37,13 @@ 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")
 
@@ -68,6 +75,48 @@ article_schema = client.schema.article(slug: "post-slug")
 
 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

data/lib/contemble/resources.rb

@@ -11,25 +11,32 @@ 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
+          encoded_name = URI.encode_www_form_component(collection_name)
+          response = @client.get("/collections/#{encoded_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 = []
+
+          collections.each do |collection|
+            encoded_name = URI.encode_www_form_component(collection["name"])
+            response = @client.get("/collections/#{encoded_name}?page=#{page}&per_page=#{per_page}")
+            all_posts.concat(response["data"])
+          end
 
-        posts.map do |post|
-          post.merge(
-            "url" => "#{Contemble.post_path}/#{post["slug"]}"
-          )
+          all_posts.map do |post|
+            post.merge("url" => "#{Contemble.post_path}/#{post["slug"]}")
+          end
         end
       end
     end
@@ -40,7 +47,9 @@ module Contemble
       end
 
       def show(slug:)
-        @client.get("/posts/#{slug}")
+        encoded_slug = URI.encode_www_form_component(slug)
+        response = @client.get("/posts/#{encoded_slug}")
+        response["data"]
       end
     end
 
@@ -60,7 +69,8 @@ module Contemble
       end
 
       def article(slug:)
-        @client.get("/posts/#{slug}/schema")
+        encoded_slug = URI.encode_www_form_component(slug)
+        @client.get("/posts/#{encoded_slug}/schema")
       end
     end
   end

data/lib/contemble/version.rb

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

metadata

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