contentful 11.9.0-testing-oidc-trusted-publishing.1 → 11.10.0

package/README.md

@@ -31,8 +31,8 @@
 <a href="LICENSE">
     <img src="https://img.shields.io/badge/license-MIT-brightgreen.svg" alt="MIT License" />
   </a>
-  <a href="https://circleci.com/gh/contentful/contentful.js">
-    <img src="https://circleci.com/gh/contentful/contentful.js.svg?style=svg" alt="Build Status">
+  <a href="https://github.com/contentful/contentful.js/actions?query=branch%3Amaster">
+    <img src="https://github.com/contentful/contentful.js/actions/workflows/main.yaml/badge.svg">
   </a>
  <a href="https://www.npmjs.com/package/contentful">
     <img src="https://img.shields.io/npm/v/contentful.svg" alt="NPM">
@@ -68,17 +68,20 @@ JavaScript library for the Contentful [Content Delivery API](https://www.content
   - [Your first request](#your-first-request)
   - [Using this library with the Preview API](#using-this-library-with-the-preview-api)
   - [Authentication](#authentication)
+  - [Cursor-based Pagination](#cursor-based-pagination)
 - [Documentation \& References](#documentation--references)
   - [Configuration](#configuration)
     - [Request configuration options](#request-configuration-options)
     - [Response configuration options](#response-configuration-options)
+  - [Timeline Preview](#timeline-preview)
+    - [Example](#example)
   - [Client chain modifiers](#client-chain-modifiers)
     - [Entries](#entries)
-      - [Example](#example)
-    - [Assets](#assets)
       - [Example](#example-1)
-    - [Sync](#sync)
+    - [Assets](#assets)
       - [Example](#example-2)
+    - [Sync](#sync)
+      - [Example](#example-3)
   - [Reference documentation](#reference-documentation)
   - [Tutorials \& other resources](#tutorials--other-resources)
   - [Troubleshooting](#troubleshooting)
@@ -133,6 +136,7 @@ In order to get started with the Contentful JS library you'll need not only to i
 - [Your first request](#your-first-request)
 - [Using this library with the Preview API](#using-this-library-with-the-preview-api)
 - [Authentication](#authentication)
+- [Cursor-based pagination](#cursor-based-pagination)
 - [Documentation & References](#documentation--references)
 
 ### Installation
@@ -227,6 +231,29 @@ Don't forget to also get your Space ID.
 
 For more information, check the [Contentful REST API reference on Authentication](https://www.contentful.com/developers/docs/references/authentication/).
 
+### Cursor-based Pagination
+
+Cursor-based pagination is supported on collection endpoints for entries and assets:
+
+```js
+const response = await client.getEntriesWithCursor({ limit: 10 })
+console.log(response.items) // Array of items
+console.log(response.pages?.next) // Cursor for next page
+```
+
+Use the value from `response.pages.next` to fetch the next page or `response.pages.prev` to fetch the previous page.
+
+```js
+const nextPageResponse = await client.getEntriesWithCursor({
+  limit: 10,
+  pageNext: response.pages?.next,
+})
+
+console.log(nextPageResponse.items) // Array of items
+console.log(nextPageResponse.pages?.next) // Cursor for next page
+console.log(nextPageResponse.pages?.prev) // Cursor for prev page
+```
+
 ## Documentation & References
 
 - [Configuration](#configuration)
@@ -292,11 +319,9 @@ const client = contentful.createClient({
   accessToken: 'preview_0b7f6x59a0',
   host: 'preview.contentful.com',
   // either release or timestamp or both can be passed as a valid config
-  alphaFeatures: {
-    timelinePreview: {
-      release: { lte: 'black-friday' },
-      timestamp: { lte: '2025-11-29T08:46:15Z' },
-    },
+  timelinePreview: {
+    release: { lte: 'black-friday' },
+    timestamp: { lte: '2025-11-29T08:46:15Z' },
   },
 })
 ```