feat: new pagination logic

Author: thejoeker12

.github/workflows/release-please.yml

@@ -16,5 +16,5 @@ jobs:
     steps:
     - uses: googleapis/[email protected]
       with:
-        release-type: simple
-        token: ${{ secrets.RELEASE_PLEASE_PAT }}
+        release-type: go
+        token: ${{ secrets.RELEASE_PLEASE_PAT }}

CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [2.0.1](https://github.com/deploymenttheory/go-api-sdk-jamfpro/compare/v2.0.0...v2.0.1) (2025-04-17)
+
+
+### Bug Fixes
+
+* release please to release type go ([af961b5](https://github.com/deploymenttheory/go-api-sdk-jamfpro/commit/af961b5cb3de7c9df1ec53b1dcf60aecfbae00f9))
+
+## [2.0.0](https://github.com/deploymenttheory/go-api-sdk-jamfpro/compare/v1.27.1...v2.0.0) (2025-04-17)
+
+
+### ⚠ BREAKING CHANGES
+
+* Pagination func filter passing refactored ([#760](https://github.com/deploymenttheory/go-api-sdk-jamfpro/issues/760))
+
+### Features
+
+* Pagination func filter passing refactored ([#760](https://github.com/deploymenttheory/go-api-sdk-jamfpro/issues/760)) ([5199c4e](https://github.com/deploymenttheory/go-api-sdk-jamfpro/commit/5199c4e81489c30b8da64849d29fec5919b80a9f))
+
 ## [1.27.1](https://github.com/deploymenttheory/go-api-sdk-jamfpro/compare/v1.27.0...v1.27.1) (2025-04-14)
 
 

docs/url_queries.md

@@ -0,0 +1,77 @@
+# Querying the Jamf Pro API with RSQL
+
+Jamf Pro's **Jamf Pro API (v1+)** supports querying resources using **RSQL filters** via HTTP requests. This guide explains how to construct API queries using URLs with RSQL in Go.
+
+
+## 📘 Basic URL Format
+
+Jamf Pro API endpoints follow this pattern:
+
+```
+https://<jamf-host>/api/<resource-path>?page=0&page-size=50&sort=fieldName:asc&filter=<rsql-expression>
+```
+
+- `page`: zero-based page index.
+- `page-size`: number of results per page.
+- `sort`: optional; `fieldName:asc` or `fieldName:desc`.
+- `filter`: your RSQL query string (URL-encoded).
+
+---
+
+## 🔍 Example: Query Computers by Name
+
+**Goal:** Find all computers whose name contains `test`.
+
+**Endpoint:**
+
+```
+GET /api/v1/computers-inventory
+```
+
+**RSQL Filter:**
+
+```
+general.name==*test*
+```
+
+**Full URL (URL-encoded):**
+
+```
+https://your-jamf-url.com/api/v1/computers-inventory?filter=general.name%3D%3D%2Atest%2A
+```
+
+
+
+## 🧑‍💻 Creating an RSQL Query using `url.Values{}` in Go
+
+```go
+import (
+	"net/http"
+	"net/url"
+)
+
+func buildJamfQuery() (*http.Request, error) {
+	baseURL := "https://your-jamf-url.com/api/v1/computers-inventory"
+
+	params := url.Values{}
+	params.Set("page", "0")
+	params.Set("page-size", "50")
+	params.Set("sort", "general.name:asc")
+	params.Set("filter", `general.name==*test*`)
+
+	fullURL := baseURL + "?" + params.Encode()
+
+	req, err := http.NewRequest("GET", fullURL, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
+	return req, nil
+}
+```
+
+- `url.Values{}.Encode()` handles correct URL encoding for you.
+- The RSQL filter will be encoded automatically (e.g. `==` → `%3D%3D`, `*` → `%2A`).
+
+---

examples/bookmarks/GetBookmarks/GetBookmarks.go

@@ -4,6 +4,7 @@ import (
 	"encoding/json"
 	"fmt"
 	"log"
+	"net/url"
 
 	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
 )
@@ -18,8 +19,10 @@ func main() {
 		log.Fatalf("Failed to initialize Jamf Pro client: %v", err)
 	}
 
+	// For more information on how to add parameters to this request, see docs/url_queries.md
+
 	// Call function
-	bookmarksList, err := client.GetBookmarks("")
+	bookmarksList, err := client.GetBookmarks(url.Values{})
 	if err != nil {
 		log.Fatalf("Error fetching accounts: %v", err)
 	}

examples/buildings/GetBuildingResourceHistoryByID/GetBuildingResourceHistoryByID.go

@@ -3,6 +3,7 @@ package main
 import (
 	"fmt"
 	"log"
+	"net/url"
 
 	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
 )
@@ -18,8 +19,9 @@ func main() {
 	}
 
 	// Example: Fetch the resource history of a building by ID
+	// For more information on how to add parameters to this request, see docs/url_queries.md
 	buildingID := "" // Replace with a real building ID
-	history, err := client.GetBuildingResourceHistoryByID(buildingID, "")
+	history, err := client.GetBuildingResourceHistoryByID(buildingID, url.Values{})
 	if err != nil {
 		log.Fatalf("Error fetching building resource history: %v", err)
 	}

examples/buildings/GetBuildings/GetBuildings.go

@@ -4,6 +4,7 @@ import (
 	"encoding/json"
 	"fmt"
 	"log"
+	"net/url"
 
 	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
 )
@@ -18,8 +19,10 @@ func main() {
 		log.Fatalf("Failed to initialize Jamf Pro client: %v", err)
 	}
 
+	// For more information on how to add parameters to this request, see docs/url_queries.md
+
 	// Call GetBuildings function
-	accountsList, err := client.GetBuildings("")
+	accountsList, err := client.GetBuildings(url.Values{})
 	if err != nil {
 		log.Fatalf("Error fetching accounts: %v", err)
 	}

examples/categories/GetCategories/GetCategories.go

@@ -3,6 +3,7 @@ package main
 import (
 	"fmt"
 	"log"
+	"net/url"
 
 	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
 )
@@ -18,9 +19,10 @@ func main() {
 	}
 
 	// Define the sort and filter query parameters
-	// none
+	// For more information on how to add parameters to this request, see docs/url_queries.md
+
 	// Call the GetCategories function
-	categories, err := client.GetCategories("") // Will return all results by default
+	categories, err := client.GetCategories(url.Values{}) // Will return all results by default
 	if err != nil {
 		fmt.Printf("Error fetching categories: %v\n", err)
 		return

examples/cloud_idp/GetCloudIdentityProviders/GetCloudIdentityProviders.go

@@ -4,6 +4,7 @@ import (
 	"encoding/json"
 	"fmt"
 	"log"
+	"net/url"
 
 	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
 )
@@ -19,10 +20,11 @@ func main() {
 	}
 
 	// Optional: Define sort filter (e.g., "id:asc" or "displayName:desc")
-	sortFilter := "id:desc"
+	// For more information on how to add parameters to this request, see docs/url_queries.md
+	params := url.Values{}
 
 	// Call GetCloudIdentityProviders function
-	cloudIdps, err := client.GetCloudIdentityProviders(sortFilter)
+	cloudIdps, err := client.GetCloudIdentityProviders(params)
 	if err != nil {
 		log.Fatalf("Error fetching cloud identity providers: %v", err)
 	}

examples/computer_extension_attributes/GetComputerExtensionAttributes/GetComputerExtensionAttributes.go

@@ -4,6 +4,7 @@ import (
 	"encoding/xml"
 	"fmt"
 	"log"
+	"net/url"
 
 	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
 )
@@ -19,7 +20,8 @@ func main() {
 	}
 
 	// Call GetComputerExtensionAttributes function
-	attributes, err := client.GetComputerExtensionAttributes("")
+	// For more information on how to add parameters to this request, see docs/url_queries.md
+	attributes, err := client.GetComputerExtensionAttributes(url.Values{})
 	if err != nil {
 		log.Fatalf("Error fetching Computer Extension Attributes: %v", err)
 	}

examples/computer_inventory/GetComputersFileVaultInventory/GetComputersFileVaultInventory.go

@@ -4,6 +4,7 @@ import (
 	"encoding/json"
 	"fmt"
 	"log"
+	"net/url"
 
 	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
 )
@@ -19,10 +20,12 @@ func main() {
 	}
 
 	// Sort filter
-	sortFilter := "sort=id:desc"
+	// For more information on how to add parameters to this request, see docs/url_queries.md
+	params := url.Values{}
+	params.Add("sort", "id:desc")
 
 	// Call the GetComputersFileVaultInventory function
-	fileVaultInventory, err := client.GetComputersFileVaultInventory(sortFilter)
+	fileVaultInventory, err := client.GetComputersFileVaultInventory(params)
 	if err != nil {
 		log.Fatalf("Error fetching FileVault inventory: %v", err)
 	}