Update documentation for ScopedEndpoint attribute

docs/extensions.md

···
 
 ### Documenting Scope Requirements
 
-Use the `#[RequiresScope]` attribute to document which OAuth scopes your extension methods require. This helps with documentation and enables scope checking in authenticated mode:
+Use the `#[ScopedEndpoint]` attribute to document which OAuth scopes your extension methods require. This helps with documentation and enables scope checking in authenticated mode:
 
 ```php
-use SocialDept\AtpClient\Attributes\RequiresScope;
+use SocialDept\AtpClient\Attributes\ScopedEndpoint;
 use SocialDept\AtpClient\Client\Requests\Request;
 use SocialDept\AtpClient\Enums\Scope;
 
 class BskyMetricsClient extends Request
 {
-    #[RequiresScope(Scope::TransitionGeneric, granular: 'rpc:app.bsky.feed.getTimeline')]
+    #[ScopedEndpoint(Scope::TransitionGeneric, granular: 'rpc:app.bsky.feed.getTimeline')]
     public function getTimelineMetrics(): array
     {
         $timeline = $this->atp->bsky->feed->getTimeline();
         // Process and return metrics...
     }
 
-    // Methods without #[RequiresScope] work in both public and authenticated modes
+    // Methods without #[ScopedEndpoint] work in both public and authenticated modes
     public function getPublicPostMetrics(string $uri): array
     {
         $thread = $this->atp->bsky->feed->getPostThread($uri);
···
 }
 ```
 
-Methods with `#[RequiresScope]` indicate they require authentication, while methods without it can work in public mode. See [scopes.md](scopes.md) for full documentation on scope handling.
+Methods with `#[ScopedEndpoint]` indicate they require authentication, while methods without it can work in public mode. See [scopes.md](scopes.md) for full documentation on scope handling.
 
 ## Available Domains
 

docs/scopes.md

···
 Scope::identity('handle')                                 // Identity attribute access
 ```
 
-### RequiresScope Attribute
+### ScopedEndpoint Attribute
 
 ```php
-use SocialDept\AtpClient\Attributes\RequiresScope;
+use SocialDept\AtpClient\Attributes\ScopedEndpoint;
 use SocialDept\AtpClient\Enums\Scope;
 
-#[RequiresScope(Scope::TransitionGeneric)]
+#[ScopedEndpoint(Scope::TransitionGeneric)]
 public function getTimeline(): GetTimelineResponse
 {
     // Method implementation
···
 'identity:handle'                              // Manage handle
 ```
 
-## The RequiresScope Attribute
+## The ScopedEndpoint Attribute
 
-The `#[RequiresScope]` attribute documents and optionally enforces scope requirements on methods.
+The `#[ScopedEndpoint]` attribute documents and optionally enforces scope requirements on methods.
 
 ### Basic Usage
 
···
 
 namespace App\Atp;
 
-use SocialDept\AtpClient\Attributes\RequiresScope;
+use SocialDept\AtpClient\Attributes\ScopedEndpoint;
 use SocialDept\AtpClient\Client\Requests\Request;
 use SocialDept\AtpClient\Enums\Scope;
 
 class CustomClient extends Request
 {
-    #[RequiresScope(Scope::TransitionGeneric)]
+    #[ScopedEndpoint(Scope::TransitionGeneric)]
     public function getTimeline(): array
     {
         return $this->atp->client->get('app.bsky.feed.getTimeline')->json();
···
 Document the future granular scope that will replace the transition scope:
 
 ```php
-#[RequiresScope(
+#[ScopedEndpoint(
     Scope::TransitionGeneric,
     granular: 'rpc:app.bsky.feed.getTimeline'
 )]
···
 Add a human-readable description for documentation:
 
 ```php
-#[RequiresScope(
+#[ScopedEndpoint(
     Scope::TransitionGeneric,
     granular: 'rpc:app.bsky.feed.getTimeline',
     description: 'Access to the user\'s home timeline'
···
 When a method requires multiple scopes, all must be present:
 
 ```php
-#[RequiresScope([Scope::TransitionGeneric, Scope::TransitionEmail])]
+#[ScopedEndpoint([Scope::TransitionGeneric, Scope::TransitionEmail])]
 public function getEmailPreferences(): array
 {
     // Requires BOTH scopes
···
 Use multiple attributes for alternative scope requirements:
 
 ```php
-#[RequiresScope(Scope::Atproto)]
-#[RequiresScope(Scope::TransitionGeneric)]
+#[ScopedEndpoint(Scope::Atproto)]
+#[ScopedEndpoint(Scope::TransitionGeneric)]
 public function getProfile(string $actor): ProfileViewDetailed
 {
     // Either scope satisfies the requirement
···
 $client->bsky->feed->getTimeline();  // Requires transition:generic scope
 ```
 
-Methods that work in public mode typically don't have `#[RequiresScope]` attributes, while authenticated-only methods do.
+Methods that work in public mode typically don't have `#[ScopedEndpoint]` attributes, while authenticated-only methods do.
 
 ## Exception Handling
 
···
 
 ### 1. Document All Scope Requirements
 
-Always add `#[RequiresScope]` to methods that require authentication:
+Always add `#[ScopedEndpoint]` to methods that require authentication:
 
 ```php
-#[RequiresScope(
+#[ScopedEndpoint(
     Scope::TransitionGeneric,
     granular: 'rpc:app.bsky.feed.getTimeline',
     description: 'Fetches the authenticated user\'s home timeline'
···
 
 ```php
 // Good
-#[RequiresScope(Scope::TransitionGeneric)]
+#[ScopedEndpoint(Scope::TransitionGeneric)]
 
 // Avoid
-#[RequiresScope('transition:generic')]
+#[ScopedEndpoint('transition:generic')]
 ```
 
 ### 3. Request Minimal Scopes