chore: update repository name

Author: felipeadeildo

README.md

@@ -1,169 +1,159 @@
-# pytally-sdk
+# PyTally SDK
+
+> Unofficial Python SDK for the [Tally.so](https://tally.so) API.
 
 [![PyPI version](https://badge.fury.io/py/pytally-sdk.svg)](https://badge.fury.io/py/pytally-sdk)
 [![Python Versions](https://img.shields.io/pypi/pyversions/pytally-sdk.svg)](https://pypi.org/project/pytally-sdk/)
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Docs](https://img.shields.io/badge/docs-online-brightgreen)](https://pytally-sdk.fa.dev.br)
+
+---
 
-Unofficial Python SDK for the [Tally.so](https://tally.so) API.
+## Overview
 
-> **Early Development**: This SDK is currently in early development and does not yet cover the entire Tally API. We're actively working on adding more endpoints and features.
+**PyTally SDK** is a lightweight, fully typed Python client for the [Tally.so API](https://tally.so).
+It provides a clean, Pythonic interface for authenticating, querying, and managing Tally resources -- without worrying about HTTP requests or pagination.
+
+### Implemented Resources
+
+[x] Users
+[x] Organizations
+[x] Forms
+[x] Workspaces
+[x] Webhooks
+[] MCP
+---
 
 ## Installation
 
-Install the package using pip:
+### pip
 
 ```bash
 pip install pytally-sdk
 ```
 
-Or using [uv](https://github.com/astral-sh/uv):
+### uv (recommended)
 
 ```bash
 uv add pytally-sdk
 ```
 
+**Requirements:**
+Python ≥ 3.11
+`httpx` (auto-installed)
+
+---
+
 ## Quick Start
 
 ```python
 from tally import Tally
 
-# Initialize the client with your API key
-client = Tally(api_key="tly-your-api-key-here")
+client = Tally(api_key="tly_your_api_key_here")
 
-# Get current user information
 user = client.users.me()
-print(f"Hello, {user.full_name}!")
-print(f"Email: {user.email}")
-print(f"Plan: {user.subscription_plan.value}")
+print(f"Hello, {user.full_name} ({user.email})")
 ```
 
 ### With Context Manager
 
 ```python
 from tally import Tally
 
-with Tally(api_key="tly-your-api-key-here") as client:
-    user = client.users.me()
-    print(f"Organization ID: {user.organization_id}")
+with Tally(api_key="tly_your_api_key_here") as client:
+    for form in client.forms:
+        print(f"{form.name} ({form.id})")
 ```
 
-## Features
+---
 
-### Currently Implemented
+## Webhooks — Example Usage
 
-- **Authentication**: Bearer token authentication with API versioning support
-- **Users Resource**:
-  - `client.users.me()` - Get current authenticated user information
-- **Error Handling**: Comprehensive exception handling for all HTTP error codes
-- **Type Safety**: Full type hints support for better IDE experience
-- **Context Manager**: Automatic resource cleanup
+### List Webhooks
 
-### Coming Soon
+```python
+from tally import Tally
 
-- **Forms Resource**: List, retrieve, and manage forms
-- **Submissions Resource**: Access and filter form submissions
-- **Webhooks Resource**: Manage webhooks and events
-- **Organizations Resource**: Manage organization users and invites
-- **Workspaces Resource**: List and manage workspaces
+client = Tally(api_key="tly_your_api_key_here")
 
-## API Versioning
+# Get all webhooks
+for webhook in client.webhooks:
+    print(f"{webhook.url} → enabled={webhook.is_enabled}")
+```
 
-The Tally API uses date-based versioning. You can specify a specific API version when initializing the client:
+### Create a Webhook
 
 ```python
 from tally import Tally
 
-client = Tally(
-    api_key="tly-your-api-key-here",
-    api_version="2025-02-01"  # Optional: specify API version
+client = Tally(api_key="tly_your_api_key_here")
+
+webhook = client.webhooks.create(
+    url="https://your-app.com/webhooks/tally",
+    event_types=["FORM_RESPONSE"],
 )
+
+print(f"Webhook created: {webhook.id}")
 ```
 
-If not specified, the client will use the version tied to your API key.
+For complete API usage, visit the [📘 Webhooks Reference](https://pytally-sdk.fa.dev.br/api-reference/webhooks/).
 
-## Error Handling
+---
 
-The SDK provides specific exceptions for different API errors:
+## Error Handling
 
 ```python
-from tally import Tally, UnauthorizedError, RateLimitError, TallyAPIError
+from tally import Tally, UnauthorizedError, NotFoundError
 
-client = Tally(api_key="tly-your-api-key-here")
+client = Tally(api_key="tly_invalid")
 
 try:
-    user = client.users.me()
+    client.users.me()
 except UnauthorizedError:
-    print("Invalid API key!")
-except RateLimitError:
-    print("Rate limit exceeded. Please wait before retrying.")
-except TallyAPIError as e:
-    print(f"API error: {e.message} (status code: {e.status_code})")
+    print("Invalid API key.")
+except NotFoundError:
+    print("Resource not found.")
 ```
 
-## Configuration
+See [Error Handling → docs](https://pytally-sdk.fa.dev.br/error-handling/).
 
-The client accepts the following configuration options:
-
-```python
-from tally import Tally
-
-client = Tally(
-    api_key="tly-your-api-key-here",       # Required: Your Tally API key
-    api_version="2025-02-01",              # Optional: API version
-    timeout=30.0,                           # Optional: Request timeout in seconds
-    base_url="https://api.tally.so"        # Optional: Custom base URL
-)
-```
+---
 
-## Getting Your API Key
+## Documentation
 
-1. Go to [Tally Settings > API Keys](https://tally.so/settings/api-keys)
-2. Click "Create API key"
-3. Copy and store your API key securely
+👉 Full documentation and API reference available at:
+**[https://pytally-sdk.fa.dev.br](https://pytally-sdk.fa.dev.br)**
 
-> **Security Note**: Never commit your API key to version control. Use environment variables or a secure secrets manager.
+---
 
 ## Development
 
-This project uses [uv](https://github.com/astral-sh/uv) for dependency management.
+Wanna help improve the SDK?
 
 ```bash
-# Clone the repository
 git clone https://github.com/felipeadeildo/pytally.git
-
-# Install dependencies
+cd pytally
 uv sync
-
-# Run tests (coming soon)
-uv run pytest
+uv run mkdocs serve  # preview docs locally
+pre-commit install   # install pre-commit hooks
 ```
 
-## Contributing
-
-Contributions are welcome! This SDK is in early development, and we'd love your help to:
-
-- Add missing API endpoints
-- Improve documentation
-- Report bugs
-- Suggest new features
-
-Please feel free to open an issue or submit a pull request.
-
-## License
-
-This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
+---
 
-## Acknowledgments
+## 🔗 Links
 
-This is an unofficial SDK and is not affiliated with or endorsed by Tally. Tally and the Tally logo are trademarks of Tally B.V.
+* 📦 [PyPI Package](https://pypi.org/project/pytally-sdk/)
+* 💻 [GitHub Repository](https://github.com/felipeadeildo/pytally)
+* 🧾 [Tally API Reference](https://developers.tally.so/api-reference/introduction)
+* 🪲 [Issue Tracker](https://github.com/felipeadeildo/pytally/issues)
+* 📘 [Documentation](https://pytally-sdk.fa.dev.br)
 
-## Links
+---
 
-- [PyPI Package](https://pypi.org/project/pytally-sdk/)
-- [GitHub Repository](https://github.com/felipeadeildo/pytally)
-- [Tally API Documentation](https://tally.so/help/api)
-- [Issue Tracker](https://github.com/felipeadeildo/pytally/issues)
+## ⚖️ License
 
----
+Licensed under the [Apache License 2.0](https://github.com/felipeadeildo/pytally/blob/main/LICENSE).
 
-Made with ❤️ by [Felipe Adeildo](https://github.com/felipeadeildo)
+> **Disclaimer**
+> This is an unofficial SDK and is not affiliated with or endorsed by Tally.
+> “Tally” and the Tally logo are trademarks of Tally B.V.

docs/index.md

@@ -205,13 +205,13 @@ client = Tally(
 ## Links
 
 - [PyPI Package](https://pypi.org/project/pytally-sdk/)
-- [GitHub Repository](https://github.com/felipeadeildo/pytally)
+- [GitHub Repository](https://github.com/felipeadeildo/pytally-sdk)
 - [Official Tally API Documentation](https://developers.tally.so/api-reference/introduction)
-- [Issue Tracker](https://github.com/felipeadeildo/pytally/issues)
+- [Issue Tracker](https://github.com/felipeadeildo/pytally-sdk/issues)
 
 ## License
 
-This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/felipeadeildo/pytally/blob/main/LICENSE) file for details.
+This project is licensed under the Apache License 2.0 - see the [LICENSE](https://github.com/felipeadeildo/pytally-sdk/blob/main/LICENSE) file for details.
 
 !!! warning "Disclaimer"
     This is an unofficial SDK and is not affiliated with or endorsed by Tally. Tally and the Tally logo are trademarks of Tally B.V.

mkdocs.yml

@@ -4,8 +4,8 @@ site_description: Unofficial Python SDK for the Tally.so API
 site_author: Felipe Adeildo
 copyright: Copyright © 2025 Felipe Adeildo
 
-repo_url: https://github.com/felipeadeildo/pytally
-repo_name: felipeadeildo/pytally
+repo_url: https://github.com/felipeadeildo/pytally-sdk
+repo_name: felipeadeildo/pytally-sdk
 edit_uri: blob/main/docs/
 
 theme:
@@ -92,6 +92,6 @@ nav:
 extra:
   social:
     - icon: fontawesome/brands/github
-      link: https://github.com/felipeadeildo/pytally
+      link: https://github.com/felipeadeildo/pytally-sdk
     - icon: fontawesome/brands/python
       link: https://pypi.org/project/pytally-sdk/

pyproject.toml

@@ -26,9 +26,11 @@ dependencies = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/felipeadeildo/pytally"
-Repository = "https://github.com/felipeadeildo/pytally"
-Issues = "https://github.com/felipeadeildo/pytally/issues"
+Homepage = "https://github.com/felipeadeildo/pytally-sdk"
+Repository = "https://github.com/felipeadeildo/pytally-sdk"
+Issues = "https://github.com/felipeadeildo/pytally-sdk/issues"
+Documentation = "https://pytally-sdk.fa.dev.br/"
+
 
 [tool.uv.build-backend]
 module-name = "tally"

release.sh

@@ -31,4 +31,4 @@ git push origin main --tags
 
 echo ""
 echo "✨ Release v$VERSION criada com sucesso!"
-echo "🔗 Acompanhe o build em: https://github.com/felipeadeildo/pytally/actions"
+echo "🔗 Acompanhe o build em: https://github.com/felipeadeildo/pytally-sdk/actions"