feat: Allow connection to be used without relay for generic cursor pagination

Author: bellini666

RELEASE.md

@@ -0,0 +1,16 @@
+Release type: minor
+
+This release moves the `Connection` implementation outside the relay package,
+allowing it to be used for general-purpose cursor pagination.
+
+The following now can be imported from `strawberry.pagination`:
+
+- `Connection` - base generic class for implementing connections
+- `ListConnection` - a limit-offset implementation of the connection
+- `connection` - field decorator for creating connections
+
+Those can still be used together with the relay package, but importing from it
+is now deprecated.
+
+You can read more about connections in the
+[Strawberry Connection Docs](https://strawberry.rocks/docs/guides/pagination/connections).

docs/errors/relay-wrong-annotation.md renamed to docs/errors/connection-wrong-annotation.md

@@ -1,33 +1,33 @@
 ---
-title: Relay wrong resolver annotation Error
+title: Connection wrong resolver annotation Error
 ---
 
-# Relay wrong resolver annotation error
+# Connection wrong resolver annotation error
 
 ## Description
 
-This error is thrown when a field on a relay connection was defined with a
-resolver that returns something that is not compatible with pagination.
+This error is thrown when a field on a connection was defined with a resolver
+that returns something that is not compatible with pagination.
 
 For example, the following code would throw this error:
 
 ```python
 from typing import Any
 
 import strawberry
-from strawberry import relay
+from strawberry.pagination import connection
 
 
 @strawberry.type
-class MyType(relay.Node): ...
+class MyType(Node): ...
 
 
 @strawberry.type
 class Query:
-    @relay.connection(relay.Connection[MyType])
+    @connection(Connection[MyType])
     def some_connection_returning_mytype(self) -> MyType: ...
 
-    @relay.connection(relay.Connection[MyType])
+    @connection(Connection[MyType])
     def some_connection_returning_any(self) -> Any: ...
 ```
 
@@ -53,22 +53,22 @@ For example:
 from typing import Any
 
 import strawberry
-from strawberry import relay
+from strawberry.pagination import connection, Connection
 
 
 @strawberry.type
-class MyType(relay.Node): ...
+class MyType: ...
 
 
 @strawberry.type
 class Query:
-    @relay.connection(relay.Connection[MyType])
+    @connection(Connection[MyType])
     def some_connection(self) -> Iterable[MyType]: ...
 ```
 
 <Note>
   Note that if you are returning a type different than the connection type, you
   will need to subclass the connection type and override its `resolve_node`
-  method to convert it to the correct type, as explained in the [relay
-  guide](../guides/relay).
+  method to convert it to the correct type, as explained in the [pagination
+  guide](../guides/pagination).
 </Note>