From 02b1711795944439cc077982265da18104d5aec3 Mon Sep 17 00:00:00 2001
From: Josemar Luedke <jluedke@underline.com>
Date: Sat, 13 Dec 2025 17:21:47 -0800
Subject: [PATCH 1/2] refactor(core)!: rename module path from go-paging to
 paging-go/v2
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update all import paths across the codebase to use the new module path
github.com/nrfta/paging-go/v2, aligning with organizational naming standards
where tool names follow the pattern {name}-{language}.

Changes:
- Update go.mod module declaration
- Replace all imports: github.com/nrfta/go-paging → github.com/nrfta/paging-go/v2
- Update imports across 23 Go files (core, cursor, offset, quotafill, sqlboiler, tests)
- No functional changes to the codebase

BREAKING CHANGE: Module path has changed from github.com/nrfta/go-paging to
github.com/nrfta/paging-go/v2. All consumers must update their imports and
run `go get -u github.com/nrfta/paging-go/v2` to upgrade to v2.0.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 connection_test.go                         |  4 ++--
 cursor/encoder.go                          |  2 +-
 cursor/encoder_test.go                     |  2 +-
 cursor/paginator.go                        |  2 +-
 cursor/paginator_test.go                   |  4 ++--
 cursor/schema.go                           |  2 +-
 cursor/schema_test.go                      |  4 ++--
 go.mod                                     |  2 +-
 offset/cursor_test.go                      |  2 +-
 offset/paginator.go                        |  2 +-
 offset/paginator_test.go                   |  4 ++--
 page_args_test.go                          |  2 +-
 quotafill/cursor_test.go                   |  6 +++---
 quotafill/quotafill.go                     |  4 ++--
 quotafill/quotafill_test.go                |  6 +++---
 sqlboiler/cursor.go                        |  2 +-
 sqlboiler/cursor_test.go                   |  4 ++--
 sqlboiler/fetcher.go                       |  2 +-
 sqlboiler/offset.go                        |  2 +-
 sqlboiler/offset_test.go                   |  4 ++--
 tests/cursor_integration_test.go           |  8 ++++----
 tests/offset_integration_test.go           |  8 ++++----
 tests/quotafill_cursor_integration_test.go | 10 +++++-----
 tests/security_test.go                     | 12 ++++++------
 24 files changed, 50 insertions(+), 50 deletions(-)

diff --git a/connection_test.go b/connection_test.go
index b5b9495..c95d23b 100644
--- a/connection_test.go
+++ b/connection_test.go
@@ -6,8 +6,8 @@ import (
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/offset"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/offset"
 )
 
 // Mock database models
diff --git a/cursor/encoder.go b/cursor/encoder.go
index 5b4bbe1..228a0e6 100644
--- a/cursor/encoder.go
+++ b/cursor/encoder.go
@@ -50,7 +50,7 @@ import (
 	"encoding/base64"
 	"encoding/json"
 
-	"github.com/nrfta/go-paging"
+	"github.com/nrfta/paging-go/v2"
 )
 
 // CompositeCursorEncoder encodes multiple column values into an opaque cursor string.
diff --git a/cursor/encoder_test.go b/cursor/encoder_test.go
index f3a7880..e152264 100644
--- a/cursor/encoder_test.go
+++ b/cursor/encoder_test.go
@@ -6,7 +6,7 @@ import (
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 
-	"github.com/nrfta/go-paging/cursor"
+	"github.com/nrfta/paging-go/v2/cursor"
 )
 
 // testUser is a simple test struct for cursor encoding
diff --git a/cursor/paginator.go b/cursor/paginator.go
index a2697df..da574f2 100644
--- a/cursor/paginator.go
+++ b/cursor/paginator.go
@@ -3,7 +3,7 @@ package cursor
 import (
 	"fmt"
 
-	"github.com/nrfta/go-paging"
+	"github.com/nrfta/paging-go/v2"
 )
 
 const defaultLimitVal = 50
diff --git a/cursor/paginator_test.go b/cursor/paginator_test.go
index 9d02fc1..9e2577a 100644
--- a/cursor/paginator_test.go
+++ b/cursor/paginator_test.go
@@ -4,8 +4,8 @@ import (
 	"errors"
 	"time"
 
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/cursor"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/cursor"
 
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
diff --git a/cursor/schema.go b/cursor/schema.go
index d1703ba..80c629d 100644
--- a/cursor/schema.go
+++ b/cursor/schema.go
@@ -6,7 +6,7 @@ import (
 	"errors"
 	"fmt"
 
-	"github.com/nrfta/go-paging"
+	"github.com/nrfta/paging-go/v2"
 )
 
 // Direction represents the sort direction for a field.
diff --git a/cursor/schema_test.go b/cursor/schema_test.go
index f2e6351..bd519f7 100644
--- a/cursor/schema_test.go
+++ b/cursor/schema_test.go
@@ -3,8 +3,8 @@ package cursor_test
 import (
 	"time"
 
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/cursor"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/cursor"
 
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
diff --git a/go.mod b/go.mod
index 7600d83..2df24d7 100644
--- a/go.mod
+++ b/go.mod
@@ -1,4 +1,4 @@
-module github.com/nrfta/go-paging
+module github.com/nrfta/paging-go/v2
 
 go 1.24.9
 
diff --git a/offset/cursor_test.go b/offset/cursor_test.go
index d95a847..89ba4bd 100644
--- a/offset/cursor_test.go
+++ b/offset/cursor_test.go
@@ -4,7 +4,7 @@ import (
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 
-	"github.com/nrfta/go-paging/offset"
+	"github.com/nrfta/paging-go/v2/offset"
 )
 
 var _ = Describe("Cursor Encoding/Decoding", func() {
diff --git a/offset/paginator.go b/offset/paginator.go
index 94442b4..e76f317 100644
--- a/offset/paginator.go
+++ b/offset/paginator.go
@@ -14,7 +14,7 @@ package offset
 import (
 	"strings"
 
-	"github.com/nrfta/go-paging"
+	"github.com/nrfta/paging-go/v2"
 
 	"github.com/aarondl/sqlboiler/v4/queries/qm"
 )
diff --git a/offset/paginator_test.go b/offset/paginator_test.go
index a57a01f..e719077 100644
--- a/offset/paginator_test.go
+++ b/offset/paginator_test.go
@@ -1,8 +1,8 @@
 package offset_test
 
 import (
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/offset"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/offset"
 
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
diff --git a/page_args_test.go b/page_args_test.go
index 1d5a317..28158ae 100644
--- a/page_args_test.go
+++ b/page_args_test.go
@@ -4,7 +4,7 @@ import (
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 
-	"github.com/nrfta/go-paging"
+	"github.com/nrfta/paging-go/v2"
 )
 
 var _ = Describe("PageArgs", func() {
diff --git a/quotafill/cursor_test.go b/quotafill/cursor_test.go
index cc5fc6b..bbc6e61 100644
--- a/quotafill/cursor_test.go
+++ b/quotafill/cursor_test.go
@@ -4,9 +4,9 @@ import (
 	"context"
 	"testing"
 
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/cursor"
-	"github.com/nrfta/go-paging/quotafill"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/cursor"
+	"github.com/nrfta/paging-go/v2/quotafill"
 )
 
 func TestCursorGeneration(t *testing.T) {
diff --git a/quotafill/quotafill.go b/quotafill/quotafill.go
index 44a90e7..2329443 100644
--- a/quotafill/quotafill.go
+++ b/quotafill/quotafill.go
@@ -6,8 +6,8 @@ import (
 	"fmt"
 	"time"
 
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/cursor"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/cursor"
 )
 
 // Default configuration values
diff --git a/quotafill/quotafill_test.go b/quotafill/quotafill_test.go
index e92795b..e806a88 100644
--- a/quotafill/quotafill_test.go
+++ b/quotafill/quotafill_test.go
@@ -6,9 +6,9 @@ import (
 	"testing"
 	"time"
 
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/cursor"
-	"github.com/nrfta/go-paging/quotafill"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/cursor"
+	"github.com/nrfta/paging-go/v2/quotafill"
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 )
diff --git a/sqlboiler/cursor.go b/sqlboiler/cursor.go
index d4dec88..330f833 100644
--- a/sqlboiler/cursor.go
+++ b/sqlboiler/cursor.go
@@ -7,7 +7,7 @@ import (
 
 	"github.com/aarondl/sqlboiler/v4/queries"
 	"github.com/aarondl/sqlboiler/v4/queries/qm"
-	"github.com/nrfta/go-paging"
+	"github.com/nrfta/paging-go/v2"
 )
 
 // CursorToQueryMods converts FetchParams into SQLBoiler query mods for cursor-based pagination.
diff --git a/sqlboiler/cursor_test.go b/sqlboiler/cursor_test.go
index 236f7cd..ec0fd1b 100644
--- a/sqlboiler/cursor_test.go
+++ b/sqlboiler/cursor_test.go
@@ -3,8 +3,8 @@ package sqlboiler_test
 import (
 	"time"
 
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/sqlboiler"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/sqlboiler"
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 )
diff --git a/sqlboiler/fetcher.go b/sqlboiler/fetcher.go
index da5837b..4085424 100644
--- a/sqlboiler/fetcher.go
+++ b/sqlboiler/fetcher.go
@@ -32,7 +32,7 @@ import (
 	"context"
 
 	"github.com/aarondl/sqlboiler/v4/queries/qm"
-	"github.com/nrfta/go-paging"
+	"github.com/nrfta/paging-go/v2"
 )
 
 // QueryFunc executes a SQLBoiler query and returns results.
diff --git a/sqlboiler/offset.go b/sqlboiler/offset.go
index a8c685a..a06c2e2 100644
--- a/sqlboiler/offset.go
+++ b/sqlboiler/offset.go
@@ -4,7 +4,7 @@ import (
 	"strings"
 
 	"github.com/aarondl/sqlboiler/v4/queries/qm"
-	"github.com/nrfta/go-paging"
+	"github.com/nrfta/paging-go/v2"
 )
 
 // OffsetToQueryMods converts FetchParams into SQLBoiler query mods for offset pagination.
diff --git a/sqlboiler/offset_test.go b/sqlboiler/offset_test.go
index 637109d..efa4a3b 100644
--- a/sqlboiler/offset_test.go
+++ b/sqlboiler/offset_test.go
@@ -1,8 +1,8 @@
 package sqlboiler_test
 
 import (
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/sqlboiler"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/sqlboiler"
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 )
diff --git a/tests/cursor_integration_test.go b/tests/cursor_integration_test.go
index 6885af1..8706867 100644
--- a/tests/cursor_integration_test.go
+++ b/tests/cursor_integration_test.go
@@ -5,10 +5,10 @@ import (
 	"time"
 
 	"github.com/aarondl/sqlboiler/v4/queries/qm"
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/cursor"
-	"github.com/nrfta/go-paging/sqlboiler"
-	"github.com/nrfta/go-paging/tests/models"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/cursor"
+	"github.com/nrfta/paging-go/v2/sqlboiler"
+	"github.com/nrfta/paging-go/v2/tests/models"
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 )
diff --git a/tests/offset_integration_test.go b/tests/offset_integration_test.go
index 92094c7..bc13797 100644
--- a/tests/offset_integration_test.go
+++ b/tests/offset_integration_test.go
@@ -4,10 +4,10 @@ import (
 	"context"
 
 	"github.com/aarondl/sqlboiler/v4/queries/qm"
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/offset"
-	"github.com/nrfta/go-paging/sqlboiler"
-	"github.com/nrfta/go-paging/tests/models"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/offset"
+	"github.com/nrfta/paging-go/v2/sqlboiler"
+	"github.com/nrfta/paging-go/v2/tests/models"
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 )
diff --git a/tests/quotafill_cursor_integration_test.go b/tests/quotafill_cursor_integration_test.go
index ef5ce1c..b8a811e 100644
--- a/tests/quotafill_cursor_integration_test.go
+++ b/tests/quotafill_cursor_integration_test.go
@@ -6,11 +6,11 @@ import (
 	"time"
 
 	"github.com/aarondl/sqlboiler/v4/queries/qm"
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/cursor"
-	"github.com/nrfta/go-paging/quotafill"
-	"github.com/nrfta/go-paging/sqlboiler"
-	"github.com/nrfta/go-paging/tests/models"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/cursor"
+	"github.com/nrfta/paging-go/v2/quotafill"
+	"github.com/nrfta/paging-go/v2/sqlboiler"
+	"github.com/nrfta/paging-go/v2/tests/models"
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 )
diff --git a/tests/security_test.go b/tests/security_test.go
index ce3f04d..b408773 100644
--- a/tests/security_test.go
+++ b/tests/security_test.go
@@ -4,12 +4,12 @@ import (
 	"context"
 	"strings"
 
-	"github.com/nrfta/go-paging"
-	"github.com/nrfta/go-paging/cursor"
-	"github.com/nrfta/go-paging/offset"
-	"github.com/nrfta/go-paging/quotafill"
-	"github.com/nrfta/go-paging/sqlboiler"
-	"github.com/nrfta/go-paging/tests/models"
+	"github.com/nrfta/paging-go/v2"
+	"github.com/nrfta/paging-go/v2/cursor"
+	"github.com/nrfta/paging-go/v2/offset"
+	"github.com/nrfta/paging-go/v2/quotafill"
+	"github.com/nrfta/paging-go/v2/sqlboiler"
+	"github.com/nrfta/paging-go/v2/tests/models"
 
 	"github.com/aarondl/sqlboiler/v4/queries/qm"
 

From 235f5a316a0ba8edbd513adb509ff8709eae9107 Mon Sep 17 00:00:00 2001
From: Josemar Luedke <jluedke@underline.com>
Date: Sat, 13 Dec 2025 17:22:07 -0800
Subject: [PATCH 2/2] docs!: update for v2.0 module rename to paging-go/v2
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update all documentation to reflect the new module path and v2.0 release:

README.md:
- Update repository title: go-paging → paging-go
- Update badge URL to match new repository name
- Update install command: go get github.com/nrfta/paging-go/v2
- Replace all import examples throughout usage sections
- Update gqlgen.yml configuration examples

MIGRATION.md:
- Rename guide: "v0.3.0 to v1.0" → "v0.3.0 to v2.0"
- Add breaking changes summary table showing module path migration
- Update all code examples with new import paths
- Document combined changes: modular architecture + repository rename
- Clarify that v2.0 includes both architectural improvements and naming alignment

BREAKING CHANGE: All documentation now references github.com/nrfta/paging-go/v2.
Users upgrading from v0.3.0 must update both their imports and module references
to the new v2.0 module path.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
---
 MIGRATION.md | 58 ++++++++++++++++++++++++++++++++++++----------------
 README.md    | 26 +++++++++++------------
 2 files changed, 53 insertions(+), 31 deletions(-)

diff --git a/MIGRATION.md b/MIGRATION.md
index 6f509df..2e1ffb4 100644
--- a/MIGRATION.md
+++ b/MIGRATION.md
@@ -1,15 +1,35 @@
-# Migration Guide: v0.3.0 to v1.0
+# Migration Guide: v0.3.0 to v2.0
 
-This guide helps you migrate from go-paging v0.3.0 to the new v1.0 modular architecture.
+This guide helps you migrate from go-paging v0.3.0 to paging-go v2.0.
+
+## Overview
+
+v2.0 combines two major improvements:
+
+1. **Modular architecture** - Separate packages for offset, cursor, and quota-fill pagination
+2. **Repository rename** - Aligned with organizational naming standards: `go-paging` → `paging-go/v2`
+3. **API consistency** - Type rename: `OrderBy` → `Sort`
+4. **Schema pattern** - Ensures encoder/sort order consistency for cursor and quota-fill
+
+## Breaking Changes Summary
+
+| Change | Old (v0.3.0) | New (v2.0) |
+|--------|-------------|-----------|
+| **Module path** | `github.com/nrfta/go-paging` | `github.com/nrfta/paging-go/v2` |
+| **Constructor** | `paging.NewOffsetPaginator()` | `offset.New()` |
+| **Type** | `paging.OffsetPaginator` | `offset.Paginator` |
+| **Sort type** | `paging.OrderBy` | `paging.Sort` |
+| **Cursor encoding** | `paging.EncodeOffsetCursor()` | `offset.EncodeCursor()` |
 
 ## Quick Summary
 
 **What you need to change:**
 
-1. Add import: `"github.com/nrfta/go-paging/offset"`
-2. Change: `paging.NewOffsetPaginator(...)` → `offset.New(...)`
-3. Change: `paging.OffsetPaginator` → `offset.Paginator`
-4. **New (Recommended):** Use `offset.BuildConnection()` to eliminate boilerplate
+1. Update imports: `"github.com/nrfta/go-paging"` → `"github.com/nrfta/paging-go/v2/offset"`
+2. Change constructor: `paging.NewOffsetPaginator(...)` → `offset.New(...)`
+3. Change type: `paging.OffsetPaginator` → `offset.Paginator`
+4. Rename sort type: `paging.OrderBy` → `paging.Sort`
+5. **New (Recommended):** Use `offset.BuildConnection()` to eliminate 60-80% of boilerplate
 
 **What stays the same:**
 
@@ -54,8 +74,8 @@ Add the offset package import:
 
 ```go
 import (
-    "github.com/nrfta/go-paging"
-    "github.com/nrfta/go-paging/offset"  // Add this
+    "github.com/nrfta/paging-go/v2"
+    "github.com/nrfta/paging-go/v2/offset"  // Add this
 )
 ```
 
@@ -185,7 +205,7 @@ import (
     "context"
     "database/sql"
 
-    "github.com/nrfta/go-paging"
+    "github.com/nrfta/paging-go/v2"
     "github.com/my-user/my-app/models"
 )
 
@@ -237,8 +257,8 @@ import (
     "context"
     "database/sql"
 
-    "github.com/nrfta/go-paging"
-    "github.com/nrfta/go-paging/offset"
+    "github.com/nrfta/paging-go/v2"
+    "github.com/nrfta/paging-go/v2/offset"
     "github.com/my-user/my-app/models"
 )
 
@@ -343,7 +363,7 @@ if page != nil && page.After != nil {
 fetchParams := paging.FetchParams{
     Limit:   limit + 1,  // Manual N+1
     Cursor:  cursorPos,
-    OrderBy: []paging.OrderBy{
+    OrderBy: []paging.Sort{
         {Column: "created_at", Desc: true},
         {Column: "id", Desc: true},
     },
@@ -355,11 +375,11 @@ users, _ := fetcher.Fetch(ctx, fetchParams)
 
 ```go
 // ✅ N+1 handled automatically!
-orderBy := []paging.OrderBy{
+sorts := []paging.Sort{
     {Column: "created_at", Desc: true},
     {Column: "id", Desc: true},
 }
-fetchParams := cursor.BuildFetchParams(page, encoder, orderBy)
+fetchParams := cursor.BuildFetchParams(page, encoder, sorts)
 users, _ := fetcher.Fetch(ctx, fetchParams)
 ```
 
@@ -409,7 +429,7 @@ type UserEdge {
 ```yaml
 models:
   UserConnection:
-    model: github.com/nrfta/go-paging.Connection[github.com/my-user/my-app/domain.User]
+    model: github.com/nrfta/paging-go/v2.Connection[github.com/my-user/my-app/domain.User]
 ```
 
 ## Advanced: SQLBoiler Adapter (for library authors)
@@ -445,11 +465,13 @@ The new modular architecture provides:
 
 ## Migration Checklist
 
-- [ ] Update imports to include `"github.com/nrfta/go-paging/offset"`
+- [ ] Update module import: `"github.com/nrfta/go-paging"` → `"github.com/nrfta/paging-go/v2"`
+- [ ] Update subpackage imports: `"github.com/nrfta/go-paging/offset"` → `"github.com/nrfta/paging-go/v2/offset"`
 - [ ] Replace `paging.NewOffsetPaginator()` with `offset.New()`
-- [ ] Update type references from `paging.OffsetPaginator` to `offset.Paginator`
+- [ ] Update type references: `paging.OffsetPaginator` → `offset.Paginator`
+- [ ] Rename sort type: `paging.OrderBy` → `paging.Sort`
 - [ ] Replace manual edge/node building with `offset.BuildConnection()`
-- [ ] Update cursor function calls (if used): `paging.EncodeOffsetCursor` → `offset.EncodeCursor`
+- [ ] Update cursor functions (if used): `paging.EncodeOffsetCursor` → `offset.EncodeCursor`
 - [ ] Run tests to verify everything works
 - [ ] Enjoy 60-80% less boilerplate code! 🎉
 
diff --git a/README.md b/README.md
index 729de47..7a57839 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# go-paging ![](https://github.com/nrfta/go-paging/workflows/CI/badge.svg)
+# paging-go ![](https://github.com/nrfta/paging-go/workflows/CI/badge.svg)
 
 Type-safe Relay pagination for [SQLBoiler](https://github.com/aarondl/sqlboiler) and [gqlgen](https://github.com/99designs/gqlgen/).
 
@@ -7,7 +7,7 @@ Supports three pagination strategies: offset (traditional LIMIT/OFFSET), cursor
 ## Install
 
 ```sh
-go get -u "github.com/nrfta/go-paging"
+go get -u "github.com/nrfta/paging-go/v2"
 ```
 
 ## Migration from v0.3.0
@@ -15,7 +15,7 @@ go get -u "github.com/nrfta/go-paging"
 Breaking changes in v1.0 moved from monolithic API to modular package structure. See [MIGRATION.md](./MIGRATION.md) for details.
 
 Quick summary:
-1. Add strategy import: `"github.com/nrfta/go-paging/offset"`
+1. Add strategy import: `"github.com/nrfta/paging-go/v2/offset"`
 2. Change constructor: `paging.NewOffsetPaginator()` → `offset.New()`
 3. Use builder: `offset.BuildConnection()` eliminates 60-80% of boilerplate
 
@@ -29,9 +29,9 @@ Add [this schema](./schema.graphql) and configure gqlgen:
 # gqlgen.yml
 models:
   PageArgs:
-    model: github.com/nrfta/go-paging.PageArgs
+    model: github.com/nrfta/paging-go/v2.PageArgs
   PageInfo:
-    model: github.com/nrfta/go-paging.PageInfo
+    model: github.com/nrfta/paging-go/v2.PageInfo
 ```
 
 ### PageInfo Resolver
@@ -39,7 +39,7 @@ models:
 ```go
 package resolvers
 
-import "github.com/nrfta/go-paging"
+import "github.com/nrfta/paging-go/v2"
 
 func (r *RootResolver) PageInfo() PageInfoResolver {
   return paging.NewPageInfoResolver()
@@ -55,8 +55,8 @@ package resolvers
 
 import (
   "context"
-  "github.com/nrfta/go-paging"
-  "github.com/nrfta/go-paging/offset"
+  "github.com/nrfta/paging-go/v2"
+  "github.com/nrfta/paging-go/v2/offset"
   "github.com/my-user/my-app/models"
 )
 
@@ -135,8 +135,8 @@ High-performance keyset pagination using composite indexes. Provides O(1) perfor
 
 ```go
 import (
-  "github.com/nrfta/go-paging/cursor"
-  "github.com/nrfta/go-paging/sqlboiler"
+  "github.com/nrfta/paging-go/v2/cursor"
+  "github.com/nrfta/paging-go/v2/sqlboiler"
 )
 
 func (r *queryResolver) Users(ctx context.Context, page *paging.PageArgs) (*paging.Connection[*User], error) {
@@ -337,9 +337,9 @@ This creates poor UX: uneven layouts, unpredictable "Load More" behavior, multip
 
 ```go
 import (
-  "github.com/nrfta/go-paging/cursor"
-  "github.com/nrfta/go-paging/quotafill"
-  "github.com/nrfta/go-paging/sqlboiler"
+  "github.com/nrfta/paging-go/v2/cursor"
+  "github.com/nrfta/paging-go/v2/quotafill"
+  "github.com/nrfta/paging-go/v2/sqlboiler"
 )
 
 func (r *queryResolver) Organizations(ctx context.Context, page *paging.PageArgs) (*paging.Connection[*Organization], error) {