laravel-query-gate-sdk 1.0.1 → 1.0.2

package/README.md

@@ -385,21 +385,27 @@ console.log(posts.total)        // 100
 ```typescript
 import type { CursorPaginateResponse } from 'laravel-query-gate-sdk'
 
-// First page
+// First page (with filters)
 const posts = await queryGate<PostContract>('posts')
+  .filter('status', 'eq', 'published')
+  .sort('created_at', 'desc')
   .cursor()
   .get() as CursorPaginateResponse<Post>
+// URL: /posts?filter[status][eq]=published&sort=created_at:desc
 
-// Next page using cursor from previous response
+// Next page - only cursor is sent (filters are encoded in the cursor)
 const nextPage = await queryGate<PostContract>('posts')
   .cursor(posts.next_cursor)
   .get() as CursorPaginateResponse<Post>
+// URL: /posts?cursor=eyJjcmVhdGVkX2F0Ijoi...
 
 // Response includes: data, next_cursor, prev_cursor, next_page_url, prev_page_url
 console.log(posts.data)        // Post[]
 console.log(posts.next_cursor) // "eyJjcmVhdGVkX2F0Ijoi..."
 ```
 
+> **Note:** When navigating with a cursor, filters and sorts are not sent in the URL because Laravel's cursor already contains all query parameters encoded in base64.
+
 #### No Pagination (Fetch All)
 
 ```typescript

package/dist/index.js

@@ -241,6 +241,12 @@ function buildUrl(config, state) {
     path += `/${state.action}`;
   }
   const params = new URLSearchParams();
+  const isCursorNavigation = state.pagination?.type === "cursor" && state.pagination.cursor !== void 0 && state.pagination.cursor !== null;
+  if (isCursorNavigation) {
+    params.append("cursor", state.pagination.cursor);
+    const queryString2 = params.toString();
+    return `${baseUrl}${path}?${queryString2}`;
+  }
   for (const filter of state.filters) {
     params.append(`filter[${filter.field}][${filter.operator}]`, String(filter.value));
   }
@@ -253,10 +259,6 @@ function buildUrl(config, state) {
       if (state.pagination.page !== void 0) {
         params.append("page", String(state.pagination.page));
       }
-    } else if (state.pagination.type === "cursor") {
-      if (state.pagination.cursor !== void 0 && state.pagination.cursor !== null) {
-        params.append("cursor", state.pagination.cursor);
-      }
     }
   }
   const queryString = params.toString();

package/dist/index.mjs

@@ -185,6 +185,12 @@ function buildUrl(config, state) {
     path += `/${state.action}`;
   }
   const params = new URLSearchParams();
+  const isCursorNavigation = state.pagination?.type === "cursor" && state.pagination.cursor !== void 0 && state.pagination.cursor !== null;
+  if (isCursorNavigation) {
+    params.append("cursor", state.pagination.cursor);
+    const queryString2 = params.toString();
+    return `${baseUrl}${path}?${queryString2}`;
+  }
   for (const filter of state.filters) {
     params.append(`filter[${filter.field}][${filter.operator}]`, String(filter.value));
   }
@@ -197,10 +203,6 @@ function buildUrl(config, state) {
       if (state.pagination.page !== void 0) {
         params.append("page", String(state.pagination.page));
       }
-    } else if (state.pagination.type === "cursor") {
-      if (state.pagination.cursor !== void 0 && state.pagination.cursor !== null) {
-        params.append("cursor", state.pagination.cursor);
-      }
     }
   }
   const queryString = params.toString();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laravel-query-gate-sdk",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Contract-driven TypeScript SDK for Laravel Query Gate",
   "main": "dist/index.js",
   "module": "dist/index.mjs",