sdkrouter 0.1.13__tar.gz → 0.1.17__tar.gz

{sdkrouter-0.1.13 → sdkrouter-0.1.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sdkrouter
-Version: 0.1.13
+Version: 0.1.17
 Summary: Unified SDK for AI services with OpenAI compatibility
 Project-URL: Homepage, https://github.com/markolofsen/sdkrouter
 Project-URL: Documentation, https://sdkrouter.com
@@ -17,17 +17,14 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
-Requires-Dist: beautifulsoup4>=4.12.0
 Requires-Dist: httpx<1.0.0,>=0.28.0
-Requires-Dist: lxml>=5.3.0
-Requires-Dist: markdownify>=0.14.0
 Requires-Dist: openai<3.0.0,>=2.0.0
 Requires-Dist: pydantic-settings>=2.7.0
 Requires-Dist: pydantic<3.0.0,>=2.10.0
 Requires-Dist: rich>=14.0.0
+Requires-Dist: sdkrouter-tools>=0.1.0
 Requires-Dist: tenacity>=9.1.0
 Requires-Dist: tiktoken>=0.8.0
-Requires-Dist: toon-python>=0.1.2
 Provides-Extra: dev
 Requires-Dist: build>=1.2.0; extra == 'dev'
 Requires-Dist: ipykernel>=6.0.0; extra == 'dev'
@@ -750,6 +747,284 @@ result = client.embeddings.create(
 | `openai/text-embedding-3-large` | 3072 | Higher quality |
 | `openai/text-embedding-ada-002` | 1536 | Legacy |
 
+### Payments (Crypto)
+
+Accept cryptocurrency payments and manage withdrawals:
+
+```python
+# Get current balance
+balance = client.payments.get_balance()
+print(f"Balance: ${balance.balance_usd}")
+print(f"Total deposited: ${balance.total_deposited}")
+
+# List available currencies
+currencies = client.payments.list_currencies()
+for c in currencies.results:
+    print(f"{c.code}: {c.name} ({c.network})")
+
+# Get deposit estimate
+estimate = client.payments.get_deposit_estimate(
+    currency_code="USDTTRC20",
+    amount_usd=100.00,
+)
+print(f"Crypto amount: {estimate.crypto_amount}")
+```
+
+#### Create Payment Invoice
+
+```python
+# Create a payment invoice
+result = client.payments.create(
+    amount_usd="25.00",
+    currency_code="USDTTRC20",
+    description="Premium subscription",
+    client_reference_id="order_12345",
+)
+
+if result.success:
+    payment = result.payment
+    print(f"Pay {payment.pay_amount} to: {payment.pay_address}")
+    print(f"Payment URL: {payment.payment_url}")
+    print(f"Expires: {payment.expires_at}")
+
+# Check payment status
+status = client.payments.check_status(payment.id, refresh=True)
+print(f"Status: {status.status}")
+if status.transaction_hash:
+    print(f"Transaction: {status.transaction_hash}")
+
+# List all payments
+payments = client.payments.list(page=1, page_size=10)
+for p in payments.results:
+    print(f"{p.internal_payment_id}: ${p.amount_usd} - {p.status}")
+```
+
+#### Transaction History
+
+```python
+# List transactions
+transactions = client.payments.list_transactions(page=1, page_size=10)
+for tx in transactions.results:
+    sign = "+" if float(tx.amount_usd) > 0 else ""
+    print(f"{tx.transaction_type}: {sign}${tx.amount_usd}")
+    print(f"Balance after: ${tx.balance_after}")
+```
+
+#### Withdrawals
+
+```python
+# Get withdrawal estimate
+estimate = client.payments.get_withdrawal_estimate(
+    currency_code="USDTTRC20",
+    amount_usd=50.00,
+)
+print(f"Network fee: ${estimate.network_fee_usd}")
+print(f"Final amount: ${estimate.final_amount_usd}")
+
+# Create withdrawal request
+result = client.payments.create_withdrawal(
+    amount_usd="50.00",
+    currency_code="USDTTRC20",
+    wallet_address="TYourWalletAddress123",
+)
+if result.success:
+    print(f"Withdrawal ID: {result.withdrawal.internal_withdrawal_id}")
+    print(f"Status: {result.withdrawal.status}")  # pending (requires admin approval)
+
+# List withdrawals
+withdrawals = client.payments.list_withdrawals()
+for w in withdrawals.results:
+    print(f"{w.internal_withdrawal_id}: ${w.amount_usd} - {w.status}")
+```
+
+#### Provider Credentials
+
+```python
+# List provider credentials
+credentials = client.payments.list_credentials()
+for cred in credentials.results:
+    print(f"{cred.name}: {cred.provider.name}")
+    print(f"Total payments: {cred.total_payments}")
+    print(f"Total volume: ${cred.total_volume_usd}")
+
+# Test credential connection
+test = client.payments.test_credential(cred.id)
+print(f"Connection: {'OK' if test.success else 'Failed'}")
+```
+
+#### Payments API Summary
+
+| Method | Description |
+|--------|-------------|
+| `get_balance()` | Current balance and totals |
+| `list_currencies()` | Available cryptocurrencies |
+| `get_deposit_estimate(...)` | Estimate crypto amount for USD |
+| `create(...)` | Create payment invoice |
+| `check_status(id)` | Check payment status |
+| `list()` | List all payments |
+| `list_transactions()` | Transaction history |
+| `get_withdrawal_estimate(...)` | Estimate withdrawal fees |
+| `create_withdrawal(...)` | Request withdrawal |
+| `list_withdrawals()` | List withdrawals |
+| `list_credentials()` | Provider credentials |
+| `test_credential(id)` | Test provider connection |
+
+### Proxies
+
+Manage proxies with rotation, assignments, and health monitoring:
+
+```python
+# List all proxies
+proxies = client.proxies.list(page=1, page_size=10)
+for p in proxies.results:
+    print(f"{p.host}:{p.port} - {p.country} - {p.status}")
+    print(f"Success rate: {p.success_rate}%")
+
+# Get healthy proxies (active, good success rate, fast response)
+healthy = client.proxies.get_healthy()
+for p in healthy:
+    print(f"{p.host}:{p.port}")
+
+# Get Korean proxies
+korean = client.proxies.get_korean()
+
+# Get performance statistics
+stats = client.proxies.get_performance_stats()
+print(f"Stats: {stats}")
+```
+
+#### Create and Update Proxies
+
+```python
+# Create a new proxy
+proxy = client.proxies.create(
+    host="192.168.1.100",
+    port=8080,
+    proxy_type="http",      # http, https, socks4, socks5
+    proxy_mode="static",    # static, rotating, mobile
+    country="KR",
+    username="user",
+    password="pass",
+    is_active=True,
+)
+print(f"Created: {proxy.id}")
+
+# Update proxy
+updated = client.proxies.update(
+    proxy.id,
+    status="active",
+    max_concurrent_requests=100,
+)
+
+# Delete proxy
+client.proxies.delete(proxy.id)
+```
+
+#### Rotation Configurations
+
+Configure automatic proxy rotation based on criteria:
+
+```python
+# List rotation configurations
+rotations = client.proxies.list_rotations()
+for r in rotations.results:
+    print(f"{r.name}: {r.allowed_countries}")
+
+# Create rotation configuration
+rotation = client.proxies.create_rotation(
+    name="Korean Fast Proxies",
+    allowed_countries=["KR"],
+    min_success_rate=95.0,
+    max_response_time_ms=1000,
+    rotation_interval_minutes=30,
+    is_active=True,
+)
+
+# Get available proxies matching rotation criteria
+available = client.proxies.get_available_proxies_for_rotation(rotation.id)
+print(f"Available: {len(available)} proxies")
+
+# Update rotation
+client.proxies.update_rotation(rotation.id, is_active=False)
+
+# Delete rotation
+client.proxies.delete_rotation(rotation.id)
+```
+
+#### Proxy Assignments
+
+Track proxy usage by parser:
+
+```python
+# List assignments
+assignments = client.proxies.list_assignments()
+for a in assignments.results:
+    print(f"{a.parser_id} -> {a.proxy.host}:{a.proxy.port}")
+
+# Get active assignments
+active = client.proxies.get_active_assignments()
+
+# Create assignment
+assignment = client.proxies.create_assignment(
+    proxy=proxy.id,
+    parser_id="encar_parser",
+    is_active=True,
+    priority=5,
+)
+
+# Update assignment
+client.proxies.update_assignment(assignment.id, priority=10)
+
+# Delete assignment
+client.proxies.delete_assignment(assignment.id)
+```
+
+#### Proxy Tests
+
+Test proxy connectivity and performance:
+
+```python
+# List recent tests
+tests = client.proxies.list_tests()
+for t in tests.results:
+    status = "PASS" if t.is_successful else "FAIL"
+    print(f"[{status}] {t.proxy.host} - {t.response_time_ms}ms")
+
+# Run a test
+test = client.proxies.create_test(
+    proxy=proxy.id,
+    test_type="connectivity",  # connectivity, speed, anonymity, geolocation
+)
+print(f"Test {'passed' if test.is_successful else 'failed'}")
+print(f"Response time: {test.response_time_ms}ms")
+```
+
+#### Proxies API Summary
+
+| Method | Description |
+|--------|-------------|
+| `list()` | List all proxies |
+| `get(id)` | Get proxy details |
+| `create(...)` | Create new proxy |
+| `update(id, ...)` | Update proxy |
+| `delete(id)` | Delete proxy |
+| `get_healthy()` | Get healthy proxies |
+| `get_korean()` | Get Korean proxies |
+| `get_by_country(code)` | Get by country |
+| `get_performance_stats()` | Overall stats |
+| `list_rotations()` | List rotation configs |
+| `create_rotation(...)` | Create rotation |
+| `update_rotation(id, ...)` | Update rotation |
+| `delete_rotation(id)` | Delete rotation |
+| `get_available_proxies_for_rotation(id)` | Matching proxies |
+| `list_assignments()` | List assignments |
+| `create_assignment(...)` | Create assignment |
+| `update_assignment(id, ...)` | Update assignment |
+| `delete_assignment(id)` | Delete assignment |
+| `get_active_assignments()` | Active assignments |
+| `list_tests()` | List tests |
+| `create_test(...)` | Run proxy test |
+
 ### LLM Models API
 
 ```python
@@ -943,6 +1218,31 @@ gen.cost_usd       # str (decimal)
 gen.duration_ms    # int
 ```
 
+### Helpers
+
+Re-exported parsing utilities from `sdkrouter_cleaner`:
+
+```python
+from sdkrouter import json_to_toon, JsonCleaner, html_to_text, extract_links, extract_images
+
+# Convert JSON/dict to TOON format
+toon_str = json_to_toon({"name": "Product", "price": 29.99})
+
+# Clean and normalize messy JSON strings
+cleaner = JsonCleaner()
+cleaned = cleaner.clean(messy_json_string)
+
+# Extract plain text from HTML
+text = html_to_text("<p>Hello <b>world</b></p>")
+# "Hello world"
+
+# Extract all links from HTML
+links = extract_links("<a href='/page'>Link</a>", base_url="https://example.com")
+
+# Extract all image URLs from HTML
+images = extract_images("<img src='/img.png'>", base_url="https://example.com")
+```
+
 ## Exports
 
 ```python
@@ -976,6 +1276,12 @@ from sdkrouter import (
     AudioAnalysisFrame,
     TranscriptionResponse,
     VerboseTranscriptionResponse,
+    # Helpers
+    json_to_toon,
+    JsonCleaner,
+    html_to_text,
+    extract_links,
+    extract_images,
     # And more...
 )
 ```

{sdkrouter-0.1.13 → sdkrouter-0.1.17}/README.md

@@ -706,6 +706,284 @@ result = client.embeddings.create(
 | `openai/text-embedding-3-large` | 3072 | Higher quality |
 | `openai/text-embedding-ada-002` | 1536 | Legacy |
 
+### Payments (Crypto)
+
+Accept cryptocurrency payments and manage withdrawals:
+
+```python
+# Get current balance
+balance = client.payments.get_balance()
+print(f"Balance: ${balance.balance_usd}")
+print(f"Total deposited: ${balance.total_deposited}")
+
+# List available currencies
+currencies = client.payments.list_currencies()
+for c in currencies.results:
+    print(f"{c.code}: {c.name} ({c.network})")
+
+# Get deposit estimate
+estimate = client.payments.get_deposit_estimate(
+    currency_code="USDTTRC20",
+    amount_usd=100.00,
+)
+print(f"Crypto amount: {estimate.crypto_amount}")
+```
+
+#### Create Payment Invoice
+
+```python
+# Create a payment invoice
+result = client.payments.create(
+    amount_usd="25.00",
+    currency_code="USDTTRC20",
+    description="Premium subscription",
+    client_reference_id="order_12345",
+)
+
+if result.success:
+    payment = result.payment
+    print(f"Pay {payment.pay_amount} to: {payment.pay_address}")
+    print(f"Payment URL: {payment.payment_url}")
+    print(f"Expires: {payment.expires_at}")
+
+# Check payment status
+status = client.payments.check_status(payment.id, refresh=True)
+print(f"Status: {status.status}")
+if status.transaction_hash:
+    print(f"Transaction: {status.transaction_hash}")
+
+# List all payments
+payments = client.payments.list(page=1, page_size=10)
+for p in payments.results:
+    print(f"{p.internal_payment_id}: ${p.amount_usd} - {p.status}")
+```
+
+#### Transaction History
+
+```python
+# List transactions
+transactions = client.payments.list_transactions(page=1, page_size=10)
+for tx in transactions.results:
+    sign = "+" if float(tx.amount_usd) > 0 else ""
+    print(f"{tx.transaction_type}: {sign}${tx.amount_usd}")
+    print(f"Balance after: ${tx.balance_after}")
+```
+
+#### Withdrawals
+
+```python
+# Get withdrawal estimate
+estimate = client.payments.get_withdrawal_estimate(
+    currency_code="USDTTRC20",
+    amount_usd=50.00,
+)
+print(f"Network fee: ${estimate.network_fee_usd}")
+print(f"Final amount: ${estimate.final_amount_usd}")
+
+# Create withdrawal request
+result = client.payments.create_withdrawal(
+    amount_usd="50.00",
+    currency_code="USDTTRC20",
+    wallet_address="TYourWalletAddress123",
+)
+if result.success:
+    print(f"Withdrawal ID: {result.withdrawal.internal_withdrawal_id}")
+    print(f"Status: {result.withdrawal.status}")  # pending (requires admin approval)
+
+# List withdrawals
+withdrawals = client.payments.list_withdrawals()
+for w in withdrawals.results:
+    print(f"{w.internal_withdrawal_id}: ${w.amount_usd} - {w.status}")
+```
+
+#### Provider Credentials
+
+```python
+# List provider credentials
+credentials = client.payments.list_credentials()
+for cred in credentials.results:
+    print(f"{cred.name}: {cred.provider.name}")
+    print(f"Total payments: {cred.total_payments}")
+    print(f"Total volume: ${cred.total_volume_usd}")
+
+# Test credential connection
+test = client.payments.test_credential(cred.id)
+print(f"Connection: {'OK' if test.success else 'Failed'}")
+```
+
+#### Payments API Summary
+
+| Method | Description |
+|--------|-------------|
+| `get_balance()` | Current balance and totals |
+| `list_currencies()` | Available cryptocurrencies |
+| `get_deposit_estimate(...)` | Estimate crypto amount for USD |
+| `create(...)` | Create payment invoice |
+| `check_status(id)` | Check payment status |
+| `list()` | List all payments |
+| `list_transactions()` | Transaction history |
+| `get_withdrawal_estimate(...)` | Estimate withdrawal fees |
+| `create_withdrawal(...)` | Request withdrawal |
+| `list_withdrawals()` | List withdrawals |
+| `list_credentials()` | Provider credentials |
+| `test_credential(id)` | Test provider connection |
+
+### Proxies
+
+Manage proxies with rotation, assignments, and health monitoring:
+
+```python
+# List all proxies
+proxies = client.proxies.list(page=1, page_size=10)
+for p in proxies.results:
+    print(f"{p.host}:{p.port} - {p.country} - {p.status}")
+    print(f"Success rate: {p.success_rate}%")
+
+# Get healthy proxies (active, good success rate, fast response)
+healthy = client.proxies.get_healthy()
+for p in healthy:
+    print(f"{p.host}:{p.port}")
+
+# Get Korean proxies
+korean = client.proxies.get_korean()
+
+# Get performance statistics
+stats = client.proxies.get_performance_stats()
+print(f"Stats: {stats}")
+```
+
+#### Create and Update Proxies
+
+```python
+# Create a new proxy
+proxy = client.proxies.create(
+    host="192.168.1.100",
+    port=8080,
+    proxy_type="http",      # http, https, socks4, socks5
+    proxy_mode="static",    # static, rotating, mobile
+    country="KR",
+    username="user",
+    password="pass",
+    is_active=True,
+)
+print(f"Created: {proxy.id}")
+
+# Update proxy
+updated = client.proxies.update(
+    proxy.id,
+    status="active",
+    max_concurrent_requests=100,
+)
+
+# Delete proxy
+client.proxies.delete(proxy.id)
+```
+
+#### Rotation Configurations
+
+Configure automatic proxy rotation based on criteria:
+
+```python
+# List rotation configurations
+rotations = client.proxies.list_rotations()
+for r in rotations.results:
+    print(f"{r.name}: {r.allowed_countries}")
+
+# Create rotation configuration
+rotation = client.proxies.create_rotation(
+    name="Korean Fast Proxies",
+    allowed_countries=["KR"],
+    min_success_rate=95.0,
+    max_response_time_ms=1000,
+    rotation_interval_minutes=30,
+    is_active=True,
+)
+
+# Get available proxies matching rotation criteria
+available = client.proxies.get_available_proxies_for_rotation(rotation.id)
+print(f"Available: {len(available)} proxies")
+
+# Update rotation
+client.proxies.update_rotation(rotation.id, is_active=False)
+
+# Delete rotation
+client.proxies.delete_rotation(rotation.id)
+```
+
+#### Proxy Assignments
+
+Track proxy usage by parser:
+
+```python
+# List assignments
+assignments = client.proxies.list_assignments()
+for a in assignments.results:
+    print(f"{a.parser_id} -> {a.proxy.host}:{a.proxy.port}")
+
+# Get active assignments
+active = client.proxies.get_active_assignments()
+
+# Create assignment
+assignment = client.proxies.create_assignment(
+    proxy=proxy.id,
+    parser_id="encar_parser",
+    is_active=True,
+    priority=5,
+)
+
+# Update assignment
+client.proxies.update_assignment(assignment.id, priority=10)
+
+# Delete assignment
+client.proxies.delete_assignment(assignment.id)
+```
+
+#### Proxy Tests
+
+Test proxy connectivity and performance:
+
+```python
+# List recent tests
+tests = client.proxies.list_tests()
+for t in tests.results:
+    status = "PASS" if t.is_successful else "FAIL"
+    print(f"[{status}] {t.proxy.host} - {t.response_time_ms}ms")
+
+# Run a test
+test = client.proxies.create_test(
+    proxy=proxy.id,
+    test_type="connectivity",  # connectivity, speed, anonymity, geolocation
+)
+print(f"Test {'passed' if test.is_successful else 'failed'}")
+print(f"Response time: {test.response_time_ms}ms")
+```
+
+#### Proxies API Summary
+
+| Method | Description |
+|--------|-------------|
+| `list()` | List all proxies |
+| `get(id)` | Get proxy details |
+| `create(...)` | Create new proxy |
+| `update(id, ...)` | Update proxy |
+| `delete(id)` | Delete proxy |
+| `get_healthy()` | Get healthy proxies |
+| `get_korean()` | Get Korean proxies |
+| `get_by_country(code)` | Get by country |
+| `get_performance_stats()` | Overall stats |
+| `list_rotations()` | List rotation configs |
+| `create_rotation(...)` | Create rotation |
+| `update_rotation(id, ...)` | Update rotation |
+| `delete_rotation(id)` | Delete rotation |
+| `get_available_proxies_for_rotation(id)` | Matching proxies |
+| `list_assignments()` | List assignments |
+| `create_assignment(...)` | Create assignment |
+| `update_assignment(id, ...)` | Update assignment |
+| `delete_assignment(id)` | Delete assignment |
+| `get_active_assignments()` | Active assignments |
+| `list_tests()` | List tests |
+| `create_test(...)` | Run proxy test |
+
 ### LLM Models API
 
 ```python
@@ -899,6 +1177,31 @@ gen.cost_usd       # str (decimal)
 gen.duration_ms    # int
 ```
 
+### Helpers
+
+Re-exported parsing utilities from `sdkrouter_cleaner`:
+
+```python
+from sdkrouter import json_to_toon, JsonCleaner, html_to_text, extract_links, extract_images
+
+# Convert JSON/dict to TOON format
+toon_str = json_to_toon({"name": "Product", "price": 29.99})
+
+# Clean and normalize messy JSON strings
+cleaner = JsonCleaner()
+cleaned = cleaner.clean(messy_json_string)
+
+# Extract plain text from HTML
+text = html_to_text("<p>Hello <b>world</b></p>")
+# "Hello world"
+
+# Extract all links from HTML
+links = extract_links("<a href='/page'>Link</a>", base_url="https://example.com")
+
+# Extract all image URLs from HTML
+images = extract_images("<img src='/img.png'>", base_url="https://example.com")
+```
+
 ## Exports
 
 ```python
@@ -932,6 +1235,12 @@ from sdkrouter import (
     AudioAnalysisFrame,
     TranscriptionResponse,
     VerboseTranscriptionResponse,
+    # Helpers
+    json_to_toon,
+    JsonCleaner,
+    html_to_text,
+    extract_links,
+    extract_images,
     # And more...
 )
 ```

{sdkrouter-0.1.13 → sdkrouter-0.1.17}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sdkrouter"
-version = "0.1.13"
+version = "0.1.17"
 description = "Unified SDK for AI services with OpenAI compatibility"
 readme = "README.md"
 license = "MIT"
@@ -29,13 +29,10 @@ dependencies = [
     "httpx>=0.28.0,<1.0.0",
     "pydantic>=2.10.0,<3.0.0",
     "pydantic-settings>=2.7.0",
-    "beautifulsoup4>=4.12.0",
-    "markdownify>=0.14.0",
     "rich>=14.0.0",
     "tenacity>=9.1.0",
-    "toon-python>=0.1.2",
-    "lxml>=5.3.0",
     "tiktoken>=0.8.0",
+    "sdkrouter-tools>=0.1.0",
 ]
 
 [project.optional-dependencies]