BROKENXAPI 2.0.0__tar.gz

brokenxapi-2.0.0/BROKENXAPI.egg-info/PKG-INFO

@@ -0,0 +1,277 @@
+Metadata-Version: 2.4
+Name: BROKENXAPI
+Version: 2.0.0
+Summary: Official async Python SDK and CLI for BrokenX YouTube API
+Author-email: Mr Broken <brokenxnetwork@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Mr Broken
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/BrokenXNetwork/BROKENXAPI
+Project-URL: Repository, https://github.com/BrokenXNetwork/BROKENXAPI
+Project-URL: Documentation, https://brokenxapi-docs.vercel.app
+Project-URL: Issues, https://github.com/BrokenXNetwork/BROKENXAPI/issues
+Keywords: brokenx,youtube,api,async,sdk,cli,aiohttp,telegram
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Multimedia :: Video
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: license-file
+
+# 🚀 BROKENXAPI
+
+**Official Async Python SDK for BrokenX YouTube API**
+
+<p align="center">
+  <strong>Fast • Secure • Async • Production-Ready</strong>
+</p>
+
+---
+
+## 📌 Overview
+
+**BROKENXAPI** is the official asynchronous Python SDK for the **BrokenX YouTube API**,
+designed for developers who want a **simple, secure, and scalable** way to search and download YouTube media via BrokenX’s backend infrastructure.
+
+The SDK abstracts all backend complexity and exposes a **clean, minimal interface** that works with nothing more than an API key.
+
+> ⚠️ Backend logic, infrastructure, and internal mechanisms are intentionally not exposed.
+
+---
+
+## ✨ Key Features
+
+* ⚡ **Async-first** (built on `aiohttp`)
+* 🔐 **Secure header-based authentication**
+* 🧼 **Clean SDK interface** (no base URLs or backend details required)
+* 🚫 **No logic exposure** (protected client implementation)
+* 📦 **PyPI-ready & production-stable**
+* 📡 **Telegram-backed media delivery**
+* 🧠 **Rate-limit & usage tracking enforced server-side**
+
+---
+
+## 📦 Installation
+
+Install directly from PyPI:
+
+```bash
+pip install BROKENXAPI
+```
+
+### Requirements
+
+* Python **3.8+**
+* Valid **BROKENXAPI** key
+* Internet access
+
+---
+
+## 🔑 Authentication
+
+BROKENXAPI uses **header-based authentication**.
+
+You only need to provide your API key when creating the client.
+
+```text
+Authorization: Bearer YOUR_API_KEY
+```
+
+* API keys are issued by **Broken X Network**
+* Never share your API key publicly
+* Rate limits are enforced automatically
+
+---
+
+## 🚀 Quick Start
+
+```python
+import asyncio
+from brokenxapi import BrokenXAPI
+
+async def main():
+    async with BrokenXAPI(
+        api_key="BROKENXAPI-XXXX"
+    ) as api:
+
+        result = await api.search("Arijit Singh")
+        print(result)
+
+asyncio.run(main())
+```
+
+That’s it.
+No base URL. No configuration. No setup noise.
+
+---
+
+## 🔍 Search API
+
+Search YouTube content using BrokenX backend.
+
+### Example
+
+```python
+await api.search("lofi beats", video=False)
+```
+
+### Parameters
+
+| Name    | Type   | Description                     |
+| ------- | ------ | ------------------------------- |
+| `query` | `str`  | Search keyword                  |
+| `video` | `bool` | `False` = audio, `True` = video |
+
+### Response (Example)
+
+```json
+{
+  "success": true,
+  "status": "found",
+  "title": "Lofi Beats",
+  "video_id": "abcd1234",
+  "duration": "3:24",
+  "thumbnail": "https://...",
+  "stream_url": "https://youtube.com/watch?v=abcd1234"
+}
+```
+
+---
+
+## ⬇️ Download API
+
+Download audio or video using BrokenX’s processing pipeline.
+
+### Audio Download
+
+```python
+await api.download("VIDEO_ID", media_type="audio")
+```
+
+### Video Download
+
+```python
+await api.download("VIDEO_ID", media_type="video")
+```
+
+### Notes
+
+* Files are delivered via **Telegram hosting**
+* Cached results may be returned instantly
+* Backend handles format selection and optimization
+
+---
+
+## ⚠️ Error Handling
+
+All SDK errors inherit from `BrokenXAPIError`.
+
+```python
+from brokenxapi.exceptions import BrokenXAPIError
+
+try:
+    await api.download("invalid_id")
+except BrokenXAPIError as e:
+    print("Error:", e)
+```
+
+### Common Errors
+
+* Invalid API key
+* Rate limit exceeded
+* Backend processing failure
+* Network errors
+
+---
+
+## 🧠 Design Philosophy
+
+BROKENXAPI follows a **backend-first security model**:
+
+* SDK = **thin, controlled client**
+* Backend = **source of truth**
+* Logic is intentionally protected
+* API keys are validated server-side only
+
+> Even if the SDK is copied, backend security remains intact.
+
+---
+
+## 📁 Documentation
+
+Full documentation is available in the [`docs/`](./docs) directory:
+
+* Installation
+* Authentication
+* Search API
+* Download API
+* Examples
+* Changelog
+
+---
+
+## 🧩 Versioning
+
+This project follows **semantic versioning**.
+
+| Version | Meaning          |
+| ------- | ---------------- |
+| `MAJOR` | Breaking changes |
+| `MINOR` | New features     |
+| `PATCH` | Bug fixes        |
+
+Current version: **v2.0.0**
+
+---
+
+## 📜 License
+
+This project is licensed under the **MIT License**.
+
+```
+© 2025–2026 MR BROKEN
+All Rights Reserved
+```
+
+---
+
+## 🏁 Final Notes
+
+* BROKENXAPI is designed for **developers, bots, and backend services**
+* Not intended for browser-side usage
+* Abuse, scraping, or misuse may result in key revocation
+
+---
+

brokenxapi-2.0.0/BROKENXAPI.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+BROKENXAPI.egg-info/PKG-INFO
+BROKENXAPI.egg-info/SOURCES.txt
+BROKENXAPI.egg-info/dependency_links.txt
+BROKENXAPI.egg-info/entry_points.txt
+BROKENXAPI.egg-info/not-zip-safe
+BROKENXAPI.egg-info/requires.txt
+BROKENXAPI.egg-info/top_level.txt
+brokenxapi/__init__.py
+brokenxapi/__version__.py
+brokenxapi/cli.py
+brokenxapi/exceptions.py
+brokenxapi/models.py

brokenxapi-2.0.0/BROKENXAPI.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

brokenxapi-2.0.0/BROKENXAPI.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+brokenx = brokenxapi.cli:main

brokenxapi-2.0.0/BROKENXAPI.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

brokenxapi-2.0.0/BROKENXAPI.egg-info/requires.txt

@@ -0,0 +1 @@
+aiohttp>=3.8.0

brokenxapi-2.0.0/BROKENXAPI.egg-info/top_level.txt

@@ -0,0 +1 @@
+brokenxapi

brokenxapi-2.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mr Broken
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

brokenxapi-2.0.0/PKG-INFO

@@ -0,0 +1,277 @@
+Metadata-Version: 2.4
+Name: BROKENXAPI
+Version: 2.0.0
+Summary: Official async Python SDK and CLI for BrokenX YouTube API
+Author-email: Mr Broken <brokenxnetwork@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2026 Mr Broken
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/BrokenXNetwork/BROKENXAPI
+Project-URL: Repository, https://github.com/BrokenXNetwork/BROKENXAPI
+Project-URL: Documentation, https://brokenxapi-docs.vercel.app
+Project-URL: Issues, https://github.com/BrokenXNetwork/BROKENXAPI/issues
+Keywords: brokenx,youtube,api,async,sdk,cli,aiohttp,telegram
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Multimedia :: Video
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: license-file
+
+# 🚀 BROKENXAPI
+
+**Official Async Python SDK for BrokenX YouTube API**
+
+<p align="center">
+  <strong>Fast • Secure • Async • Production-Ready</strong>
+</p>
+
+---
+
+## 📌 Overview
+
+**BROKENXAPI** is the official asynchronous Python SDK for the **BrokenX YouTube API**,
+designed for developers who want a **simple, secure, and scalable** way to search and download YouTube media via BrokenX’s backend infrastructure.
+
+The SDK abstracts all backend complexity and exposes a **clean, minimal interface** that works with nothing more than an API key.
+
+> ⚠️ Backend logic, infrastructure, and internal mechanisms are intentionally not exposed.
+
+---
+
+## ✨ Key Features
+
+* ⚡ **Async-first** (built on `aiohttp`)
+* 🔐 **Secure header-based authentication**
+* 🧼 **Clean SDK interface** (no base URLs or backend details required)
+* 🚫 **No logic exposure** (protected client implementation)
+* 📦 **PyPI-ready & production-stable**
+* 📡 **Telegram-backed media delivery**
+* 🧠 **Rate-limit & usage tracking enforced server-side**
+
+---
+
+## 📦 Installation
+
+Install directly from PyPI:
+
+```bash
+pip install BROKENXAPI
+```
+
+### Requirements
+
+* Python **3.8+**
+* Valid **BROKENXAPI** key
+* Internet access
+
+---
+
+## 🔑 Authentication
+
+BROKENXAPI uses **header-based authentication**.
+
+You only need to provide your API key when creating the client.
+
+```text
+Authorization: Bearer YOUR_API_KEY
+```
+
+* API keys are issued by **Broken X Network**
+* Never share your API key publicly
+* Rate limits are enforced automatically
+
+---
+
+## 🚀 Quick Start
+
+```python
+import asyncio
+from brokenxapi import BrokenXAPI
+
+async def main():
+    async with BrokenXAPI(
+        api_key="BROKENXAPI-XXXX"
+    ) as api:
+
+        result = await api.search("Arijit Singh")
+        print(result)
+
+asyncio.run(main())
+```
+
+That’s it.
+No base URL. No configuration. No setup noise.
+
+---
+
+## 🔍 Search API
+
+Search YouTube content using BrokenX backend.
+
+### Example
+
+```python
+await api.search("lofi beats", video=False)
+```
+
+### Parameters
+
+| Name    | Type   | Description                     |
+| ------- | ------ | ------------------------------- |
+| `query` | `str`  | Search keyword                  |
+| `video` | `bool` | `False` = audio, `True` = video |
+
+### Response (Example)
+
+```json
+{
+  "success": true,
+  "status": "found",
+  "title": "Lofi Beats",
+  "video_id": "abcd1234",
+  "duration": "3:24",
+  "thumbnail": "https://...",
+  "stream_url": "https://youtube.com/watch?v=abcd1234"
+}
+```
+
+---
+
+## ⬇️ Download API
+
+Download audio or video using BrokenX’s processing pipeline.
+
+### Audio Download
+
+```python
+await api.download("VIDEO_ID", media_type="audio")
+```
+
+### Video Download
+
+```python
+await api.download("VIDEO_ID", media_type="video")
+```
+
+### Notes
+
+* Files are delivered via **Telegram hosting**
+* Cached results may be returned instantly
+* Backend handles format selection and optimization
+
+---
+
+## ⚠️ Error Handling
+
+All SDK errors inherit from `BrokenXAPIError`.
+
+```python
+from brokenxapi.exceptions import BrokenXAPIError
+
+try:
+    await api.download("invalid_id")
+except BrokenXAPIError as e:
+    print("Error:", e)
+```
+
+### Common Errors
+
+* Invalid API key
+* Rate limit exceeded
+* Backend processing failure
+* Network errors
+
+---
+
+## 🧠 Design Philosophy
+
+BROKENXAPI follows a **backend-first security model**:
+
+* SDK = **thin, controlled client**
+* Backend = **source of truth**
+* Logic is intentionally protected
+* API keys are validated server-side only
+
+> Even if the SDK is copied, backend security remains intact.
+
+---
+
+## 📁 Documentation
+
+Full documentation is available in the [`docs/`](./docs) directory:
+
+* Installation
+* Authentication
+* Search API
+* Download API
+* Examples
+* Changelog
+
+---
+
+## 🧩 Versioning
+
+This project follows **semantic versioning**.
+
+| Version | Meaning          |
+| ------- | ---------------- |
+| `MAJOR` | Breaking changes |
+| `MINOR` | New features     |
+| `PATCH` | Bug fixes        |
+
+Current version: **v2.0.0**
+
+---
+
+## 📜 License
+
+This project is licensed under the **MIT License**.
+
+```
+© 2025–2026 MR BROKEN
+All Rights Reserved
+```
+
+---
+
+## 🏁 Final Notes
+
+* BROKENXAPI is designed for **developers, bots, and backend services**
+* Not intended for browser-side usage
+* Abuse, scraping, or misuse may result in key revocation
+
+---
+

brokenxapi-2.0.0/README.md

@@ -0,0 +1,225 @@
+# 🚀 BROKENXAPI
+
+**Official Async Python SDK for BrokenX YouTube API**
+
+<p align="center">
+  <strong>Fast • Secure • Async • Production-Ready</strong>
+</p>
+
+---
+
+## 📌 Overview
+
+**BROKENXAPI** is the official asynchronous Python SDK for the **BrokenX YouTube API**,
+designed for developers who want a **simple, secure, and scalable** way to search and download YouTube media via BrokenX’s backend infrastructure.
+
+The SDK abstracts all backend complexity and exposes a **clean, minimal interface** that works with nothing more than an API key.
+
+> ⚠️ Backend logic, infrastructure, and internal mechanisms are intentionally not exposed.
+
+---
+
+## ✨ Key Features
+
+* ⚡ **Async-first** (built on `aiohttp`)
+* 🔐 **Secure header-based authentication**
+* 🧼 **Clean SDK interface** (no base URLs or backend details required)
+* 🚫 **No logic exposure** (protected client implementation)
+* 📦 **PyPI-ready & production-stable**
+* 📡 **Telegram-backed media delivery**
+* 🧠 **Rate-limit & usage tracking enforced server-side**
+
+---
+
+## 📦 Installation
+
+Install directly from PyPI:
+
+```bash
+pip install BROKENXAPI
+```
+
+### Requirements
+
+* Python **3.8+**
+* Valid **BROKENXAPI** key
+* Internet access
+
+---
+
+## 🔑 Authentication
+
+BROKENXAPI uses **header-based authentication**.
+
+You only need to provide your API key when creating the client.
+
+```text
+Authorization: Bearer YOUR_API_KEY
+```
+
+* API keys are issued by **Broken X Network**
+* Never share your API key publicly
+* Rate limits are enforced automatically
+
+---
+
+## 🚀 Quick Start
+
+```python
+import asyncio
+from brokenxapi import BrokenXAPI
+
+async def main():
+    async with BrokenXAPI(
+        api_key="BROKENXAPI-XXXX"
+    ) as api:
+
+        result = await api.search("Arijit Singh")
+        print(result)
+
+asyncio.run(main())
+```
+
+That’s it.
+No base URL. No configuration. No setup noise.
+
+---
+
+## 🔍 Search API
+
+Search YouTube content using BrokenX backend.
+
+### Example
+
+```python
+await api.search("lofi beats", video=False)
+```
+
+### Parameters
+
+| Name    | Type   | Description                     |
+| ------- | ------ | ------------------------------- |
+| `query` | `str`  | Search keyword                  |
+| `video` | `bool` | `False` = audio, `True` = video |
+
+### Response (Example)
+
+```json
+{
+  "success": true,
+  "status": "found",
+  "title": "Lofi Beats",
+  "video_id": "abcd1234",
+  "duration": "3:24",
+  "thumbnail": "https://...",
+  "stream_url": "https://youtube.com/watch?v=abcd1234"
+}
+```
+
+---
+
+## ⬇️ Download API
+
+Download audio or video using BrokenX’s processing pipeline.
+
+### Audio Download
+
+```python
+await api.download("VIDEO_ID", media_type="audio")
+```
+
+### Video Download
+
+```python
+await api.download("VIDEO_ID", media_type="video")
+```
+
+### Notes
+
+* Files are delivered via **Telegram hosting**
+* Cached results may be returned instantly
+* Backend handles format selection and optimization
+
+---
+
+## ⚠️ Error Handling
+
+All SDK errors inherit from `BrokenXAPIError`.
+
+```python
+from brokenxapi.exceptions import BrokenXAPIError
+
+try:
+    await api.download("invalid_id")
+except BrokenXAPIError as e:
+    print("Error:", e)
+```
+
+### Common Errors
+
+* Invalid API key
+* Rate limit exceeded
+* Backend processing failure
+* Network errors
+
+---
+
+## 🧠 Design Philosophy
+
+BROKENXAPI follows a **backend-first security model**:
+
+* SDK = **thin, controlled client**
+* Backend = **source of truth**
+* Logic is intentionally protected
+* API keys are validated server-side only
+
+> Even if the SDK is copied, backend security remains intact.
+
+---
+
+## 📁 Documentation
+
+Full documentation is available in the [`docs/`](./docs) directory:
+
+* Installation
+* Authentication
+* Search API
+* Download API
+* Examples
+* Changelog
+
+---
+
+## 🧩 Versioning
+
+This project follows **semantic versioning**.
+
+| Version | Meaning          |
+| ------- | ---------------- |
+| `MAJOR` | Breaking changes |
+| `MINOR` | New features     |
+| `PATCH` | Bug fixes        |
+
+Current version: **v2.0.0**
+
+---
+
+## 📜 License
+
+This project is licensed under the **MIT License**.
+
+```
+© 2025–2026 MR BROKEN
+All Rights Reserved
+```
+
+---
+
+## 🏁 Final Notes
+
+* BROKENXAPI is designed for **developers, bots, and backend services**
+* Not intended for browser-side usage
+* Abuse, scraping, or misuse may result in key revocation
+
+---
+

brokenxapi-2.0.0/brokenxapi/__init__.py

@@ -0,0 +1,4 @@
+from .client import BrokenXAPI
+
+__all__ = ["BrokenXAPI"]
+

brokenxapi-2.0.0/brokenxapi/__version__.py

@@ -0,0 +1,2 @@
+__version__ = "2.0.0"
+

brokenxapi-2.0.0/brokenxapi/cli.py

@@ -0,0 +1,129 @@
+import argparse
+import asyncio
+import json
+import os
+import sys
+import stat
+import importlib.metadata
+from pathlib import Path
+
+from brokenxapi import BrokenXAPI
+from brokenxapi.exceptions import BrokenXAPIError
+
+CONFIG_DIR = Path.home() / ".brokenx"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+
+# ---------------- CONFIG HELPERS ----------------
+
+def save_api_key(api_key: str):
+    CONFIG_DIR.mkdir(exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps({"api_key": api_key}))
+    CONFIG_FILE.chmod(stat.S_IRUSR | stat.S_IWUSR)  # 600
+
+
+def load_api_key():
+    if not CONFIG_FILE.exists():
+        return None
+    try:
+        data = json.loads(CONFIG_FILE.read_text())
+        return data.get("api_key")
+    except Exception:
+        return None
+
+
+def require_api_key():
+    key = load_api_key()
+    if not key:
+        print(
+            "❌ Not authenticated.\n"
+            "Run: brokenx auth <YOUR_API_KEY>",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    return key
+
+
+# ---------------- CLI CORE ----------------
+
+async def run_cli():
+    parser = argparse.ArgumentParser(
+        prog="brokenx",
+        description="BROKENXAPI Command Line Interface",
+    )
+
+    parser.add_argument(
+        "-v", "--version",
+        action="store_true",
+        help="Show BROKENXAPI version",
+    )
+
+    sub = parser.add_subparsers(dest="command")
+
+    # ---------- AUTH ----------
+    auth_cmd = sub.add_parser("auth", help="Authenticate with API key")
+    auth_cmd.add_argument("api_key", help="Your BROKENXAPI key")
+
+    # ---------- SEARCH ----------
+    search_cmd = sub.add_parser("search", help="Search YouTube")
+    search_cmd.add_argument("query", help="Search query")
+
+    # ---------- DOWNLOAD ----------
+    download_cmd = sub.add_parser("download", help="Download media")
+    download_cmd.add_argument("video_id", help="YouTube video ID")
+    download_cmd.add_argument(
+        "-v", "--video",
+        action="store_true",
+        help="Download video instead of audio",
+    )
+
+    args = parser.parse_args()
+
+    # ---------------- VERSION ----------------
+    if args.version:
+        print(importlib.metadata.version("BROKENXAPI"))
+        return
+
+    # ---------------- AUTH ----------------
+    if args.command == "auth":
+        try:
+            # 🔍 Verify key by doing a lightweight call
+            async with BrokenXAPI(api_key=args.api_key) as api:
+                await api.search("test")  # harmless validation
+            save_api_key(args.api_key)
+            print("✅ Authentication successful. API key saved.")
+        except BrokenXAPIError as e:
+            print(f"❌ Authentication failed: {e}", file=sys.stderr)
+            sys.exit(1)
+        return
+
+    # ---------------- OTHER COMMANDS ----------------
+    api_key = require_api_key()
+
+    async with BrokenXAPI(api_key=api_key) as api:
+        if args.command == "search":
+            result = await api.search(args.query)
+            print(json.dumps(result, indent=2))
+            return
+
+        if args.command == "download":
+            media_type = "video" if args.video else "audio"
+            result = await api.download(args.video_id, media_type)
+            print(json.dumps(result, indent=2))
+            return
+
+    parser.print_help()
+
+
+def main():
+    try:
+        asyncio.run(run_cli())
+    except KeyboardInterrupt:
+        pass
+    except BrokenXAPIError as e:
+        print(f"❌ {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

brokenxapi-2.0.0/brokenxapi/exceptions.py

@@ -0,0 +1,11 @@
+class BrokenXAPIError(Exception):
+    pass
+
+class AuthenticationError(BrokenXAPIError):
+    pass
+
+class RateLimitError(BrokenXAPIError):
+    pass
+
+class ServerError(BrokenXAPIError):
+    pass

brokenxapi-2.0.0/brokenxapi/models.py

@@ -0,0 +1,19 @@
+from typing import TypedDict
+
+class DownloadResponse(TypedDict, total=False):
+    success: bool
+    status: str
+    video_id: str
+    type: str
+    telegram_url: str
+    thumbnail: str
+    source: str
+
+class SearchResponse(TypedDict, total=False):
+    success: bool
+    status: str
+    title: str
+    video_id: str
+    duration: str
+    thumbnail: str
+    stream_url: str

brokenxapi-2.0.0/pyproject.toml

@@ -0,0 +1,70 @@
+[project]
+name = "BROKENXAPI"
+dynamic = ["version"]
+description = "Official async Python SDK and CLI for BrokenX YouTube API"
+readme = "README.md"
+license = { file = "LICENSE" }
+
+authors = [
+    { name = "Mr Broken", email = "brokenxnetwork@gmail.com" }
+]
+
+keywords = [
+    "brokenx",
+    "youtube",
+    "api",
+    "async",
+    "sdk",
+    "cli",
+    "aiohttp",
+    "telegram"
+]
+
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Multimedia :: Video",
+
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+
+    "Framework :: AsyncIO"
+]
+
+requires-python = ">=3.8"
+
+dependencies = [
+    "aiohttp>=3.8.0"
+]
+
+[project.urls]
+Homepage = "https://github.com/BrokenXNetwork/BROKENXAPI"
+Repository = "https://github.com/BrokenXNetwork/BROKENXAPI"
+Documentation = "https://brokenxapi-docs.vercel.app"
+Issues = "https://github.com/BrokenXNetwork/BROKENXAPI/issues"
+
+# ---------------- CLI ENTRY ----------------
+[project.scripts]
+brokenx = "brokenxapi.cli:main"
+
+# ---------------- SETUPTOOLS ----------------
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+include = ["brokenxapi*"]
+
+# ---------------- BUILD SYSTEM ----------------
+[build-system]
+requires = ["setuptools>=69.0", "wheel>=0.43.0"]
+build-backend = "setuptools.build_meta"

brokenxapi-2.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

brokenxapi-2.0.0/setup.py

@@ -0,0 +1,15 @@
+from setuptools import setup
+import os
+
+about = {}
+
+here = os.path.abspath(os.path.dirname(__file__))
+version_file = os.path.join(here, "brokenxapi", "__version__.py")
+
+with open(version_file, encoding="utf-8") as f:
+    exec(f.read(), about)
+
+setup(
+    version=about["__version__"],
+    zip_safe=False,
+)