tiksync 1.0.0__tar.gz

tiksync-1.0.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: tiksync
+Version: 1.0.0
+Summary: TikSync — TikTok Live SDK for Python. Real-time chat, gifts, likes & viewer events.
+Home-page: https://tiksync.com
+Author: SyncLive
+Author-email: contact@synclive.fr
+License: MIT
+Project-URL: Documentation, https://tiksync.com/docs
+Project-URL: Source, https://github.com/tiksync/tiksync-python
+Keywords: tiktok,tiktok-live,websocket,api,sdk,gifts,chat
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# TikSync Python SDK
+
+**TikTok Live SDK for Python** — Real-time chat, gifts, likes, follows & viewer events.
+
+[![PyPI](https://img.shields.io/pypi/v/tiksync.svg)](https://pypi.org/project/tiksync/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+```python
+from tiksync import TikSync
+
+client = TikSync("username", api_key="your_api_key")
+
+@client.on("chat")
+async def on_chat(data):
+    print(f"[{data['uniqueId']}] {data['comment']}")
+
+@client.on("gift")
+async def on_gift(data):
+    print(f"{data['uniqueId']} sent {data['giftName']} x{data['repeatCount']}")
+
+await client.connect()
+```
+
+## Installation
+
+```bash
+pip install tiksync
+```
+
+## Quick Start
+
+```python
+import asyncio
+from tiksync import TikSync
+
+async def main():
+    client = TikSync("charlidamelio", api_key="your_api_key")
+
+    client.on("chat", lambda data: print(f"[{data['uniqueId']}] {data['comment']}"))
+    client.on("gift", lambda data: print(f"{data['uniqueId']} sent {data['giftName']}"))
+    client.on("like", lambda data: print(f"{data['uniqueId']} liked ({data['totalLikeCount']} total)"))
+    client.on("follow", lambda data: print(f"{data['uniqueId']} followed"))
+    client.on("member", lambda data: print(f"{data['uniqueId']} joined"))
+
+    await client.connect()
+
+asyncio.run(main())
+```
+
+## REST API
+
+```python
+from tiksync import TikSyncAPI
+
+api = TikSyncAPI(api_key="your_api_key")
+health = await api.health()
+usage = await api.usage()
+signed = await api.sign("username")
+```
+
+## Events
+
+| Event | Description |
+|-------|-------------|
+| `chat` | Chat messages |
+| `gift` | Gift events with diamond values |
+| `like` | Like events |
+| `follow` | New followers |
+| `share` | Stream shares |
+| `member` | User joins |
+| `roomUser` | Viewer count updates |
+| `subscribe` | Subscriptions |
+| `streamEnd` | Stream ended |
+| `connected` | Connected to stream |
+| `disconnected` | Disconnected |
+| `error` | Connection error |
+
+## Get an API Key
+
+1. Go to [tiksync.com](https://tiksync.com)
+2. Create a free account
+3. Copy your API key
+
+Free tier includes 1,000 requests/day and 10 concurrent WebSocket connections.
+
+## License
+
+MIT — built by [SyncLive](https://synclive.fr) | [tiksync.com](https://tiksync.com)

tiksync-1.0.0/README.md

@@ -0,0 +1,88 @@
+# TikSync Python SDK
+
+**TikTok Live SDK for Python** — Real-time chat, gifts, likes, follows & viewer events.
+
+[![PyPI](https://img.shields.io/pypi/v/tiksync.svg)](https://pypi.org/project/tiksync/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+```python
+from tiksync import TikSync
+
+client = TikSync("username", api_key="your_api_key")
+
+@client.on("chat")
+async def on_chat(data):
+    print(f"[{data['uniqueId']}] {data['comment']}")
+
+@client.on("gift")
+async def on_gift(data):
+    print(f"{data['uniqueId']} sent {data['giftName']} x{data['repeatCount']}")
+
+await client.connect()
+```
+
+## Installation
+
+```bash
+pip install tiksync
+```
+
+## Quick Start
+
+```python
+import asyncio
+from tiksync import TikSync
+
+async def main():
+    client = TikSync("charlidamelio", api_key="your_api_key")
+
+    client.on("chat", lambda data: print(f"[{data['uniqueId']}] {data['comment']}"))
+    client.on("gift", lambda data: print(f"{data['uniqueId']} sent {data['giftName']}"))
+    client.on("like", lambda data: print(f"{data['uniqueId']} liked ({data['totalLikeCount']} total)"))
+    client.on("follow", lambda data: print(f"{data['uniqueId']} followed"))
+    client.on("member", lambda data: print(f"{data['uniqueId']} joined"))
+
+    await client.connect()
+
+asyncio.run(main())
+```
+
+## REST API
+
+```python
+from tiksync import TikSyncAPI
+
+api = TikSyncAPI(api_key="your_api_key")
+health = await api.health()
+usage = await api.usage()
+signed = await api.sign("username")
+```
+
+## Events
+
+| Event | Description |
+|-------|-------------|
+| `chat` | Chat messages |
+| `gift` | Gift events with diamond values |
+| `like` | Like events |
+| `follow` | New followers |
+| `share` | Stream shares |
+| `member` | User joins |
+| `roomUser` | Viewer count updates |
+| `subscribe` | Subscriptions |
+| `streamEnd` | Stream ended |
+| `connected` | Connected to stream |
+| `disconnected` | Disconnected |
+| `error` | Connection error |
+
+## Get an API Key
+
+1. Go to [tiksync.com](https://tiksync.com)
+2. Create a free account
+3. Copy your API key
+
+Free tier includes 1,000 requests/day and 10 concurrent WebSocket connections.
+
+## License
+
+MIT — built by [SyncLive](https://synclive.fr) | [tiksync.com](https://tiksync.com)

tiksync-1.0.0/setup.cfg

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

tiksync-1.0.0/setup.py

@@ -0,0 +1,33 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="tiksync",
+    version="1.0.0",
+    description="TikSync — TikTok Live SDK for Python. Real-time chat, gifts, likes & viewer events.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    author="SyncLive",
+    author_email="contact@synclive.fr",
+    url="https://tiksync.com",
+    project_urls={
+        "Documentation": "https://tiksync.com/docs",
+        "Source": "https://github.com/tiksync/tiksync-python",
+    },
+    packages=find_packages(),
+    python_requires=">=3.8",
+    install_requires=["aiohttp>=3.8"],
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "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",
+        "Topic :: Software Development :: Libraries",
+    ],
+    keywords=["tiktok", "tiktok-live", "websocket", "api", "sdk", "gifts", "chat"],
+    license="MIT",
+)

tiksync-1.0.0/tiksync/__init__.py

@@ -0,0 +1,10 @@
+from .client import TikSync, TikSyncAPI
+
+__version__ = "1.0.0"
+__all__ = ["TikSync", "TikSyncAPI"]
+
+_native = None
+try:
+    import tiksync_native as _native
+except ImportError:
+    pass

tiksync-1.0.0/tiksync/client.py

@@ -0,0 +1,159 @@
+import asyncio
+import json
+import logging
+from typing import Callable, Optional
+from urllib.parse import urlencode
+
+import aiohttp
+
+logger = logging.getLogger("tiksync")
+
+API_URL = "https://api.tiksync.com"
+
+
+class TikSyncAPI:
+    def __init__(self, api_key: str, api_url: str = API_URL):
+        self.api_key = api_key
+        self.api_url = api_url.rstrip("/")
+        self._session: Optional[aiohttp.ClientSession] = None
+
+    async def _get_session(self) -> aiohttp.ClientSession:
+        if self._session is None or self._session.closed:
+            self._session = aiohttp.ClientSession(
+                headers={"x-api-key": self.api_key}
+            )
+        return self._session
+
+    async def sign(self, unique_id: str) -> dict:
+        session = await self._get_session()
+        async with session.post(
+            f"{self.api_url}/v1/sign",
+            json={"uniqueId": unique_id},
+        ) as resp:
+            return await resp.json()
+
+    async def health(self) -> dict:
+        session = await self._get_session()
+        async with session.get(f"{self.api_url}/v1/health") as resp:
+            return await resp.json()
+
+    async def usage(self) -> dict:
+        session = await self._get_session()
+        async with session.get(
+            f"{self.api_url}/v1/usage",
+        ) as resp:
+            return await resp.json()
+
+    async def close(self):
+        if self._session and not self._session.closed:
+            await self._session.close()
+
+
+class TikSync:
+    def __init__(
+        self,
+        unique_id: str,
+        api_key: str,
+        api_url: str = API_URL,
+        max_reconnect_attempts: int = 3,
+        reconnect_delay: float = 5.0,
+    ):
+        self.unique_id = unique_id
+        self.api_key = api_key
+        self.api_url = api_url.rstrip("/")
+        self.max_reconnect_attempts = max_reconnect_attempts
+        self.reconnect_delay = reconnect_delay
+        self._listeners: dict[str, list[Callable]] = {}
+        self._ws: Optional[aiohttp.ClientWebSocketResponse] = None
+        self._session: Optional[aiohttp.ClientSession] = None
+        self._running = False
+        self._reconnect_count = 0
+        self._native = None
+
+        try:
+            from tiksync import _native
+            if _native:
+                _native.init(api_key)
+                self._native = _native
+        except Exception:
+            pass
+
+    def on(self, event: str, callback: Callable):
+        self._listeners.setdefault(event, []).append(callback)
+        return self
+
+    def _emit(self, event: str, data=None):
+        for cb in self._listeners.get(event, []):
+            if asyncio.iscoroutinefunction(cb):
+                asyncio.ensure_future(cb(data))
+            else:
+                cb(data)
+
+    async def connect(self):
+        self._running = True
+        self._reconnect_count = 0
+        await self._connect_ws()
+
+    async def _connect_ws(self):
+        params = urlencode({"uniqueId": self.unique_id})
+        ws_url = self.api_url.replace("https://", "wss://").replace("http://", "ws://")
+        url = f"{ws_url}/v1/connect?{params}"
+
+        headers = {}
+        if self.api_key:
+            headers["x-api-key"] = self.api_key
+        if self._native:
+            try:
+                sec_headers = self._native.get_connect_headers()
+                headers.update(sec_headers)
+            except Exception:
+                pass
+
+        self._session = aiohttp.ClientSession()
+        try:
+            self._ws = await self._session.ws_connect(url, headers=headers)
+            self._reconnect_count = 0
+            logger.info("Connected to %s", self.unique_id)
+            self._emit("connected", {"uniqueId": self.unique_id})
+
+            async for msg in self._ws:
+                if msg.type == aiohttp.WSMsgType.TEXT:
+                    try:
+                        event = json.loads(msg.data)
+                        event_type = event.get("type", "unknown")
+                        self._emit(event_type, event.get("data", event))
+                    except json.JSONDecodeError:
+                        logger.warning("Invalid JSON: %s", msg.data[:100])
+                elif msg.type in (aiohttp.WSMsgType.CLOSED, aiohttp.WSMsgType.ERROR):
+                    break
+
+        except Exception as e:
+            logger.error("Connection error: %s", e)
+            self._emit("error", e)
+
+        finally:
+            if self._session and not self._session.closed:
+                await self._session.close()
+
+        if self._running:
+            await self._try_reconnect()
+
+    async def _try_reconnect(self):
+        if self._reconnect_count >= self.max_reconnect_attempts:
+            logger.error("Max reconnection attempts reached")
+            self._emit("disconnected", {"reason": "max_reconnect"})
+            return
+
+        self._reconnect_count += 1
+        delay = self.reconnect_delay * self._reconnect_count
+        logger.info("Reconnecting in %.1fs (attempt %d/%d)", delay, self._reconnect_count, self.max_reconnect_attempts)
+        await asyncio.sleep(delay)
+        await self._connect_ws()
+
+    async def disconnect(self):
+        self._running = False
+        if self._ws and not self._ws.closed:
+            await self._ws.close()
+        if self._session and not self._session.closed:
+            await self._session.close()
+        self._emit("disconnected", {"reason": "manual"})

tiksync-1.0.0/tiksync.egg-info/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: tiksync
+Version: 1.0.0
+Summary: TikSync — TikTok Live SDK for Python. Real-time chat, gifts, likes & viewer events.
+Home-page: https://tiksync.com
+Author: SyncLive
+Author-email: contact@synclive.fr
+License: MIT
+Project-URL: Documentation, https://tiksync.com/docs
+Project-URL: Source, https://github.com/tiksync/tiksync-python
+Keywords: tiktok,tiktok-live,websocket,api,sdk,gifts,chat
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Libraries
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: aiohttp>=3.8
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# TikSync Python SDK
+
+**TikTok Live SDK for Python** — Real-time chat, gifts, likes, follows & viewer events.
+
+[![PyPI](https://img.shields.io/pypi/v/tiksync.svg)](https://pypi.org/project/tiksync/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+```python
+from tiksync import TikSync
+
+client = TikSync("username", api_key="your_api_key")
+
+@client.on("chat")
+async def on_chat(data):
+    print(f"[{data['uniqueId']}] {data['comment']}")
+
+@client.on("gift")
+async def on_gift(data):
+    print(f"{data['uniqueId']} sent {data['giftName']} x{data['repeatCount']}")
+
+await client.connect()
+```
+
+## Installation
+
+```bash
+pip install tiksync
+```
+
+## Quick Start
+
+```python
+import asyncio
+from tiksync import TikSync
+
+async def main():
+    client = TikSync("charlidamelio", api_key="your_api_key")
+
+    client.on("chat", lambda data: print(f"[{data['uniqueId']}] {data['comment']}"))
+    client.on("gift", lambda data: print(f"{data['uniqueId']} sent {data['giftName']}"))
+    client.on("like", lambda data: print(f"{data['uniqueId']} liked ({data['totalLikeCount']} total)"))
+    client.on("follow", lambda data: print(f"{data['uniqueId']} followed"))
+    client.on("member", lambda data: print(f"{data['uniqueId']} joined"))
+
+    await client.connect()
+
+asyncio.run(main())
+```
+
+## REST API
+
+```python
+from tiksync import TikSyncAPI
+
+api = TikSyncAPI(api_key="your_api_key")
+health = await api.health()
+usage = await api.usage()
+signed = await api.sign("username")
+```
+
+## Events
+
+| Event | Description |
+|-------|-------------|
+| `chat` | Chat messages |
+| `gift` | Gift events with diamond values |
+| `like` | Like events |
+| `follow` | New followers |
+| `share` | Stream shares |
+| `member` | User joins |
+| `roomUser` | Viewer count updates |
+| `subscribe` | Subscriptions |
+| `streamEnd` | Stream ended |
+| `connected` | Connected to stream |
+| `disconnected` | Disconnected |
+| `error` | Connection error |
+
+## Get an API Key
+
+1. Go to [tiksync.com](https://tiksync.com)
+2. Create a free account
+3. Copy your API key
+
+Free tier includes 1,000 requests/day and 10 concurrent WebSocket connections.
+
+## License
+
+MIT — built by [SyncLive](https://synclive.fr) | [tiksync.com](https://tiksync.com)

tiksync-1.0.0/tiksync.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+setup.py
+tiksync/__init__.py
+tiksync/client.py
+tiksync.egg-info/PKG-INFO
+tiksync.egg-info/SOURCES.txt
+tiksync.egg-info/dependency_links.txt
+tiksync.egg-info/requires.txt
+tiksync.egg-info/top_level.txt

tiksync-1.0.0/tiksync.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tiksync-1.0.0/tiksync.egg-info/requires.txt

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

tiksync-1.0.0/tiksync.egg-info/top_level.txt

@@ -0,0 +1 @@
+tiksync