chore: update SDK to v0.3.0

Author: github-actions[bot]

conf.py

@@ -21,8 +21,8 @@
 project = "X API SDK"
 copyright = "2024, X Developer Platform"
 author = "X Developer Platform"
-release = "0.2.7-beta"
-version = "0.2.7-beta"
+release = "0.3.0"
+version = "0.3.0"
 
 # -- General configuration ----------------------------------------------------
 

pyproject.toml

@@ -14,7 +14,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "xdk"
-version = "0.2.7-beta"
+version = "0.3.0"
 description = "Python SDK for the X API"
 authors = [
     {name = "X Developer Platform", email = "devs@x.com"},

scripts/process-for-mintlify.py

@@ -24,9 +24,9 @@
 MINTLIFY_CONFIG = {
     "outputDir": "mintlify-docs",
     "baseUrl": "https://docs.x.com",
-    "title": "X API SDK v0.2.7-beta",
+    "title": "X API SDK v0.3.0",
     "description": "Python SDK for the X API with comprehensive pagination, authentication, and streaming support.",
-    "version": "0.2.7-beta",
+    "version": "0.3.0",
     "githubUrl": "https://github.com/xdevplatform/xdk",
 }
 
@@ -1270,36 +1270,40 @@ def process_docs():
 3. Initiate the flow, direct user to auth URL and handle callback.
 **Example** (using a web server for callback):
 ```python
-from xdk.auth import OAuth2PKCE
+from xdk.oauth2_auth import OAuth2PKCEAuth
 from urllib.parse import urlparse
 import webbrowser
 # Step 1: Create PKCE instance
-auth = OAuth2PKCE(
-    client_id="your_client_id",
-    redirect_uri="http://localhost:8080/callback",
-    scopes=["tweet.read", "users.read", "offline.access"]  # Adjust scopes as needed
+auth = OAuth2PKCEAuth(
+    client_id="YOUR_CLIENT_ID",
+    redirect_uri="YOUR_CALLBACK_URL",
+    scope="tweet.read users.read offline.access"
 )
 # Step 2: Get authorization URL
-auth_url = auth.get_authorization_url()
+auth_url, state = auth.get_authorization_url()
 print(f"Visit this URL to authorize: {auth_url}")
 webbrowser.open(auth_url)
 # Step 3: Handle callback (in a real app, use a web framework like Flask)
 # Assume callback_url = "http://localhost:8080/callback?code=AUTH_CODE_HERE"
 callback_url = input("Paste the full callback URL here: ")
-parsed = urlparse(callback_url)
-code = parsed.query.split("=")[1]
 # Step 4: Exchange code for tokens
-tokens = auth.fetch_token(authorization_code=code)
+tokens = auth.fetch_token(authorization_response=callback_url)
 access_token = tokens["access_token"]
 refresh_token = tokens["refresh_token"]  # Store for renewal
 # Step 5: Create client
-client = Client(oauth2_access_token=access_token)
+# Option 1: Use bearer_token (OAuth2 access tokens work as bearer tokens)
+client = Client(bearer_token=access_token)
+# Option 2: Pass the full token dict for automatic refresh support
+# client = Client(token=tokens)
 ```
 **Token Refresh** (automatic in SDK for long-lived sessions):
 ```python
 # If access token expires, refresh using stored refresh_token
-tokens = auth.refresh_token(refresh_token=refresh_token)
-client = Client(oauth2_access_token=tokens["access_token"])
+# The refresh_token method uses the stored token from the OAuth2PKCEAuth instance
+tokens = auth.refresh_token()
+# Use the refreshed token
+client = Client(bearer_token=tokens["access_token"])
+# Or pass the full token dict: client = Client(token=tokens)
 ```
 ### 3. OAuth 1.0a User Context
 For legacy endpoints that require OAuth 1.0 support.