npien 1.0.0__tar.gz

npien-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 npien contributors
+
+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.

npien-1.0.0/PKG-INFO

@@ -0,0 +1,235 @@
+Metadata-Version: 2.4
+Name: npien
+Version: 1.0.0
+Summary: NAT-piercing NET: serverless P2P UDP hole punching with rooms, STUN and optional end-to-end encryption
+Author: npien contributors
+License: MIT
+Keywords: p2p,nat,stun,udp,hole-punching,networking,e2ee
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: cryptography>=41
+Dynamic: license-file
+
+# npien
+
+**NAT-piercing NET** — sunucusuz (serverless) P2P UDP hole punching, oda sistemi,
+Google STUN sunucuları ve isteğe bağlı uçtan uca şifreleme.
+
+`npien`, iki Python sürecinin NAT arkasından doğrudan birbirine UDP paketi
+göndermesini sağlar. STUN keşfi, delik açma (hole punching), paket çerçeveleme,
+parçalama (fragmentation), keep-alive ve şifreleme kütüphanenin içinde yapılır.
+
+## Özellikler
+
+- Google STUN sunucuları ile dış IP/port keşfi (RFC 5389, yerleşik istemci)
+- UDP hole punching: aynı anda iki tarafa HELLO paketleri ile NAT eşlemesi açma
+- Oda (room) sistemi: `npien.connect("492109")`
+- Peer ticket: sunucu olmadan uç nokta paylaşımı (`npn1.<payload>.<hmac>`)
+- Yerel keşif: aynı makinede kayıt defteri (registry), LAN'de UDP broadcast
+- İsteğe bağlı E2EE: X25519 anahtar anlaşması + AES-256-GCM (`npien.advsecure()`)
+- Büyük mesajlar için otomatik parçalama ve birleştirme
+- Keep-alive / zaman aşımı yönetimi ve `on_message` callback'leri
+- IPv4, Python 3.10+
+
+## Kurulum
+
+```bash
+pip install -e .
+```
+
+Bağımlılık: `cryptography` (E2EE için). STUN istemcisi kütüphanenin içindedir;
+`pystun3` gerekmez.
+
+## Hızlı başlangıç
+
+### Aynı odada iki taraf
+
+```python
+import npien
+
+npien.set_appid("testprogram")
+npien.connect("492109")
+npien.send("merhaba")
+veri, adres = npien.receive(timeout=10)
+print(adres, veri.decode())
+```
+
+`connect("492109")` önce yerel kayıt defterine ve LAN'e bakar. İnternet üzerinden
+iki farklı ağ arasında uç noktaların bir şekilde paylaşılması gerekir; bunun için
+ticket kullanın:
+
+### Ticket ile bağlanma
+
+```python
+# B tarafı: dinle ve ticket üret
+import npien
+
+npien.set_appid("testprogram")
+npien.listen("492109")
+print("TICKET:", npien.create_ticket("492109"))
+```
+
+```python
+# A tarafı: ticket'ı paylaşılan kanaldan (sohbet, e-posta, QR...) al
+import npien
+
+npien.set_appid("testprogram")
+npien.connect("492109", ticket="npn1....")
+npien.send("selam")
+```
+
+Ticket, hedefin dış IP/portu, yerel adresi ve açık anahtarını taşır. Aynı ticket
+ile iki taraf aynı anda `connect(...)` de çağırabilir; delik açma simetriktir.
+
+### Uçtan uca şifreleme
+
+```python
+import npien
+
+npien.set_appid("testprogram")
+npien.connect("492109", ticket=ticket)
+npien.advsecure()          # giden mesajlar AES-256-GCM ile şifrelenir
+npien.send("gizli mesaj")
+```
+
+Anahtarlar X25519 ECDH ile her iki tarafta bağımsız olarak türetilir; mesajlar
+ağda asla açık metin olarak dolaşmaz. Karşı taraf `advsecure()` çağırmasa bile
+şifreli paketleri çözebilir; iki yönlü gizlilik için iki taraf da açmalıdır.
+
+### Sınıf tabanlı kullanım (çoklu örnek)
+
+```python
+from npien import Npien
+
+sunucu = Npien(appid="testprogram", name="sunucu")
+sunucu.listen("492109")
+ticket = sunucu.create_ticket("492109")
+
+istemci = Npien(appid="testprogram", name="istemci")
+istemci.connect("492109", ticket=ticket)
+istemci.advsecure()
+istemci.send(b"merhaba")
+veri, adres = sunucu.receive(timeout=10)
+
+istemci.close()
+sunucu.close()
+```
+
+### Callback ile mesaj alma
+
+```python
+@npien.on_message
+def mesaj_geldi(veri: bytes, adres: tuple[str, int]):
+    print(adres, veri.decode(errors="replace"))
+```
+
+Callback'ler transport thread'inde çalışır; ağır işleri ayrı bir thread/kuyruğa
+devredin.
+
+## API
+
+### Modül seviyesi (varsayılan örnek)
+
+| Fonksiyon | Açıklama |
+| --- | --- |
+| `set_appid(appid)` | Uygulama kimliğini ayarlar. Ticket HMAC'i ve oda ad alanı buna bağlıdır. |
+| `set_name(name)` | Görünen ad (HELLO/ticket içinde taşınır). |
+| `listen(room, advertise=True)` | Odayı dinlemeye başlar; `advertise` ise kendi ticket'ını kayıt defterine yazar. |
+| `join_room(room)` | `listen` ile aynı. |
+| `connect(room, peer=None, ticket=None, tickets=None, timeout=8.0, discover=True)` | Odaya bağlanır; bağlı peer'ların listesini döner. |
+| `send(data, to=None)` | Varsayılan olarak odadaki tüm peer'lara gönderir. `to` bir oda adı veya `(ip, port)` olabilir. |
+| `sendto(data, peer)` | Belirli bir peer'a gönderir. |
+| `receive(timeout=None)` | `(bytes, (ip, port))` döner. |
+| `receive_nowait()` | Bloklamadan dener; mesaj yoksa `TimeoutError`. |
+| `advsecure(enabled=True)` | Giden mesajlarda E2EE'yi açar/kapatır. |
+| `create_ticket(room)` | Paylaşılabilir ticket üretir; STUN keşfini tetikler. |
+| `add_peer(ticket)` | Ticket'ı kayıt defterine ekler (odadaki diğer süreçler bulabilir). |
+| `known_peers(room)` | Kayıt defterindeki ticket'ları döner. |
+| `peers(room=None)` | Bağlı/bağlanan peer'ların `PeerInfo` listesi. |
+| `on_message(callback)` | Gelen her mesaj için callback kaydeder. |
+| `get_stun_info()` | Dış IP/port, yerel adres, NAT tipi ve STUN sunucuları. |
+| `connection_info()` | Uygulama, oda, güvenlik ve peer özeti. |
+| `disconnect(target=None)` | Peer/peer'ları ayırır. |
+| `close()` | Kaynakları kapatır ve kayıt defteri girdilerini siler. |
+
+### `connect` parametreleri
+
+- `peer`: `("1.2.3.4", 5678)` veya `"1.2.3.4:5678"` ya da bunların listesi.
+- `ticket` / `tickets`: `create_ticket` çıktısı; açık anahtar pinlenir.
+- `timeout`: delik açma için toplam süre (saniye).
+- `discover`: `True` ise kayıt defteri + LAN broadcast keşfi yapılır.
+
+## Nasıl çalışır?
+
+1. **STUN**: Ana UDP soketi ile Google STUN sunucularına Binding Request
+   gönderilir; XOR-MAPPED-ADDRESS'ten dış uç nokta öğrenilir. Aynı soket
+   kullanıldığı için NAT eşlemesi hole punching ile birebir aynıdır.
+2. **Ticket**: Dış adres, yerel adres, uygulama kimliği, oda ve X25519 açık
+   anahtarı HMAC-SHA256 ile imzalanarak tek bir metne paketlenir.
+3. **Hole punching**: Her iki taraf aday adreslere (dış + yerel) 250 ms'de bir
+   HELLO gönderir. NAT eşlemesi açılınca HELLO/HELLO_ACK alışverişi oturumu kurar.
+4. **Oturum**: Oturum kimliği iki açık anahtarın sıralı hash'inden türer. Anahtar
+   X25519 + HKDF-SHA256 ile türetilir.
+5. **Veri**: `NPN1` başlıklı paketler; 1200 baytlık datagramlara parçalanır.
+   Şifreli modda AES-256-GCM (12 baytlık nonce, oturuma bağlı AAD) kullanılır.
+6. **Canlılık**: 10 saniyede bir PING/PONG; 45 saniye sessiz peer düşürülür.
+7. **Keşif**: Aynı makinede `~/.npien/registry` altındaki kilitli JSON kayıtları;
+   LAN'de 47777/UDP broadcast ve ticket yanıtları. `NPIEN_HOME` ve
+   `NPIEN_DISCOVERY_PORT` ile değiştirilebilir.
+
+Paket başlığı (28 bayt):
+
+```text
+NPN1 | version | type | flags | reserved | session(8) | msg_id(8) | frag_index(2) | frag_count(2)
+```
+
+## Sınırlamalar
+
+- **Simetrik NAT**: Her hedef için farklı dış port atayan NAT'larda doğrudan
+  hole punching çoğu zaman başarısız olur. Bu durumda TURN benzeri bir relay
+  gerekir; `npien` şu an relay içermez.
+- **Sinyalleşme**: İnternet üzerinde iki tarafın uç noktalarını öğrenmesi için
+  bir paylaşım kanalı (ticket) gerekir. LAN içinde broadcast, aynı makinede
+  kayıt defteri otomatik çalışır.
+- **Güvenilirlik**: UDP semantiği geçerlidir; sıralama/teslim garantisi yoktur.
+  Uygulama katmanında gerekirse yeniden gönderim ekleyin.
+- **Kimlik doğrulama**: Ticket ile açık anahtar pinlenir. Ticket'ı güvenilir bir
+  kanaldan paylaşın; aksi halde TOFU (ilk kullanımda güven) geçerlidir ve aktif
+  MITM engellenemez.
+- IPv4 ve tek ağ arayüzü varsayılır.
+
+## Test
+
+```bash
+python -m pytest -q
+```
+
+Testler; paket çerçeveleme, şifreleme/ticket doğrulama, STUN ayrıştırma, kayıt
+defteri ve gerçek UDP loopback üzerinden hole punching + şifreli mesajlaşmayı
+kapsar.
+
+## Örnek uygulama
+
+`examples/chat.py`:
+
+```bash
+python examples/chat.py --room 492109 --name ali --secure
+# başka terminal / makine:
+python examples/chat.py --room 492109 --name ayse --ticket "npn1...." --secure
+```
+
+## Lisans
+
+MIT

npien-1.0.0/README.md

@@ -0,0 +1,211 @@
+# npien
+
+**NAT-piercing NET** — sunucusuz (serverless) P2P UDP hole punching, oda sistemi,
+Google STUN sunucuları ve isteğe bağlı uçtan uca şifreleme.
+
+`npien`, iki Python sürecinin NAT arkasından doğrudan birbirine UDP paketi
+göndermesini sağlar. STUN keşfi, delik açma (hole punching), paket çerçeveleme,
+parçalama (fragmentation), keep-alive ve şifreleme kütüphanenin içinde yapılır.
+
+## Özellikler
+
+- Google STUN sunucuları ile dış IP/port keşfi (RFC 5389, yerleşik istemci)
+- UDP hole punching: aynı anda iki tarafa HELLO paketleri ile NAT eşlemesi açma
+- Oda (room) sistemi: `npien.connect("492109")`
+- Peer ticket: sunucu olmadan uç nokta paylaşımı (`npn1.<payload>.<hmac>`)
+- Yerel keşif: aynı makinede kayıt defteri (registry), LAN'de UDP broadcast
+- İsteğe bağlı E2EE: X25519 anahtar anlaşması + AES-256-GCM (`npien.advsecure()`)
+- Büyük mesajlar için otomatik parçalama ve birleştirme
+- Keep-alive / zaman aşımı yönetimi ve `on_message` callback'leri
+- IPv4, Python 3.10+
+
+## Kurulum
+
+```bash
+pip install -e .
+```
+
+Bağımlılık: `cryptography` (E2EE için). STUN istemcisi kütüphanenin içindedir;
+`pystun3` gerekmez.
+
+## Hızlı başlangıç
+
+### Aynı odada iki taraf
+
+```python
+import npien
+
+npien.set_appid("testprogram")
+npien.connect("492109")
+npien.send("merhaba")
+veri, adres = npien.receive(timeout=10)
+print(adres, veri.decode())
+```
+
+`connect("492109")` önce yerel kayıt defterine ve LAN'e bakar. İnternet üzerinden
+iki farklı ağ arasında uç noktaların bir şekilde paylaşılması gerekir; bunun için
+ticket kullanın:
+
+### Ticket ile bağlanma
+
+```python
+# B tarafı: dinle ve ticket üret
+import npien
+
+npien.set_appid("testprogram")
+npien.listen("492109")
+print("TICKET:", npien.create_ticket("492109"))
+```
+
+```python
+# A tarafı: ticket'ı paylaşılan kanaldan (sohbet, e-posta, QR...) al
+import npien
+
+npien.set_appid("testprogram")
+npien.connect("492109", ticket="npn1....")
+npien.send("selam")
+```
+
+Ticket, hedefin dış IP/portu, yerel adresi ve açık anahtarını taşır. Aynı ticket
+ile iki taraf aynı anda `connect(...)` de çağırabilir; delik açma simetriktir.
+
+### Uçtan uca şifreleme
+
+```python
+import npien
+
+npien.set_appid("testprogram")
+npien.connect("492109", ticket=ticket)
+npien.advsecure()          # giden mesajlar AES-256-GCM ile şifrelenir
+npien.send("gizli mesaj")
+```
+
+Anahtarlar X25519 ECDH ile her iki tarafta bağımsız olarak türetilir; mesajlar
+ağda asla açık metin olarak dolaşmaz. Karşı taraf `advsecure()` çağırmasa bile
+şifreli paketleri çözebilir; iki yönlü gizlilik için iki taraf da açmalıdır.
+
+### Sınıf tabanlı kullanım (çoklu örnek)
+
+```python
+from npien import Npien
+
+sunucu = Npien(appid="testprogram", name="sunucu")
+sunucu.listen("492109")
+ticket = sunucu.create_ticket("492109")
+
+istemci = Npien(appid="testprogram", name="istemci")
+istemci.connect("492109", ticket=ticket)
+istemci.advsecure()
+istemci.send(b"merhaba")
+veri, adres = sunucu.receive(timeout=10)
+
+istemci.close()
+sunucu.close()
+```
+
+### Callback ile mesaj alma
+
+```python
+@npien.on_message
+def mesaj_geldi(veri: bytes, adres: tuple[str, int]):
+    print(adres, veri.decode(errors="replace"))
+```
+
+Callback'ler transport thread'inde çalışır; ağır işleri ayrı bir thread/kuyruğa
+devredin.
+
+## API
+
+### Modül seviyesi (varsayılan örnek)
+
+| Fonksiyon | Açıklama |
+| --- | --- |
+| `set_appid(appid)` | Uygulama kimliğini ayarlar. Ticket HMAC'i ve oda ad alanı buna bağlıdır. |
+| `set_name(name)` | Görünen ad (HELLO/ticket içinde taşınır). |
+| `listen(room, advertise=True)` | Odayı dinlemeye başlar; `advertise` ise kendi ticket'ını kayıt defterine yazar. |
+| `join_room(room)` | `listen` ile aynı. |
+| `connect(room, peer=None, ticket=None, tickets=None, timeout=8.0, discover=True)` | Odaya bağlanır; bağlı peer'ların listesini döner. |
+| `send(data, to=None)` | Varsayılan olarak odadaki tüm peer'lara gönderir. `to` bir oda adı veya `(ip, port)` olabilir. |
+| `sendto(data, peer)` | Belirli bir peer'a gönderir. |
+| `receive(timeout=None)` | `(bytes, (ip, port))` döner. |
+| `receive_nowait()` | Bloklamadan dener; mesaj yoksa `TimeoutError`. |
+| `advsecure(enabled=True)` | Giden mesajlarda E2EE'yi açar/kapatır. |
+| `create_ticket(room)` | Paylaşılabilir ticket üretir; STUN keşfini tetikler. |
+| `add_peer(ticket)` | Ticket'ı kayıt defterine ekler (odadaki diğer süreçler bulabilir). |
+| `known_peers(room)` | Kayıt defterindeki ticket'ları döner. |
+| `peers(room=None)` | Bağlı/bağlanan peer'ların `PeerInfo` listesi. |
+| `on_message(callback)` | Gelen her mesaj için callback kaydeder. |
+| `get_stun_info()` | Dış IP/port, yerel adres, NAT tipi ve STUN sunucuları. |
+| `connection_info()` | Uygulama, oda, güvenlik ve peer özeti. |
+| `disconnect(target=None)` | Peer/peer'ları ayırır. |
+| `close()` | Kaynakları kapatır ve kayıt defteri girdilerini siler. |
+
+### `connect` parametreleri
+
+- `peer`: `("1.2.3.4", 5678)` veya `"1.2.3.4:5678"` ya da bunların listesi.
+- `ticket` / `tickets`: `create_ticket` çıktısı; açık anahtar pinlenir.
+- `timeout`: delik açma için toplam süre (saniye).
+- `discover`: `True` ise kayıt defteri + LAN broadcast keşfi yapılır.
+
+## Nasıl çalışır?
+
+1. **STUN**: Ana UDP soketi ile Google STUN sunucularına Binding Request
+   gönderilir; XOR-MAPPED-ADDRESS'ten dış uç nokta öğrenilir. Aynı soket
+   kullanıldığı için NAT eşlemesi hole punching ile birebir aynıdır.
+2. **Ticket**: Dış adres, yerel adres, uygulama kimliği, oda ve X25519 açık
+   anahtarı HMAC-SHA256 ile imzalanarak tek bir metne paketlenir.
+3. **Hole punching**: Her iki taraf aday adreslere (dış + yerel) 250 ms'de bir
+   HELLO gönderir. NAT eşlemesi açılınca HELLO/HELLO_ACK alışverişi oturumu kurar.
+4. **Oturum**: Oturum kimliği iki açık anahtarın sıralı hash'inden türer. Anahtar
+   X25519 + HKDF-SHA256 ile türetilir.
+5. **Veri**: `NPN1` başlıklı paketler; 1200 baytlık datagramlara parçalanır.
+   Şifreli modda AES-256-GCM (12 baytlık nonce, oturuma bağlı AAD) kullanılır.
+6. **Canlılık**: 10 saniyede bir PING/PONG; 45 saniye sessiz peer düşürülür.
+7. **Keşif**: Aynı makinede `~/.npien/registry` altındaki kilitli JSON kayıtları;
+   LAN'de 47777/UDP broadcast ve ticket yanıtları. `NPIEN_HOME` ve
+   `NPIEN_DISCOVERY_PORT` ile değiştirilebilir.
+
+Paket başlığı (28 bayt):
+
+```text
+NPN1 | version | type | flags | reserved | session(8) | msg_id(8) | frag_index(2) | frag_count(2)
+```
+
+## Sınırlamalar
+
+- **Simetrik NAT**: Her hedef için farklı dış port atayan NAT'larda doğrudan
+  hole punching çoğu zaman başarısız olur. Bu durumda TURN benzeri bir relay
+  gerekir; `npien` şu an relay içermez.
+- **Sinyalleşme**: İnternet üzerinde iki tarafın uç noktalarını öğrenmesi için
+  bir paylaşım kanalı (ticket) gerekir. LAN içinde broadcast, aynı makinede
+  kayıt defteri otomatik çalışır.
+- **Güvenilirlik**: UDP semantiği geçerlidir; sıralama/teslim garantisi yoktur.
+  Uygulama katmanında gerekirse yeniden gönderim ekleyin.
+- **Kimlik doğrulama**: Ticket ile açık anahtar pinlenir. Ticket'ı güvenilir bir
+  kanaldan paylaşın; aksi halde TOFU (ilk kullanımda güven) geçerlidir ve aktif
+  MITM engellenemez.
+- IPv4 ve tek ağ arayüzü varsayılır.
+
+## Test
+
+```bash
+python -m pytest -q
+```
+
+Testler; paket çerçeveleme, şifreleme/ticket doğrulama, STUN ayrıştırma, kayıt
+defteri ve gerçek UDP loopback üzerinden hole punching + şifreli mesajlaşmayı
+kapsar.
+
+## Örnek uygulama
+
+`examples/chat.py`:
+
+```bash
+python examples/chat.py --room 492109 --name ali --secure
+# başka terminal / makine:
+python examples/chat.py --room 492109 --name ayse --ticket "npn1...." --secure
+```
+
+## Lisans
+
+MIT

npien-1.0.0/npien/__init__.py

@@ -0,0 +1,148 @@
+from __future__ import annotations
+
+from .core import Npien, PeerInfo
+from .crypto import Ticket
+from .exceptions import (
+    ConnectionTimeoutError,
+    NotConnectedError,
+    NpienError,
+    PeerNotFoundError,
+    ProtocolError,
+    TicketError,
+)
+
+__version__ = "1.0.0"
+
+_default: Npien | None = None
+
+
+def default() -> Npien:
+    global _default
+    if _default is None:
+        _default = Npien()
+    return _default
+
+
+def set_appid(appid: str) -> Npien:
+    return default().set_appid(appid)
+
+
+def set_name(name: str) -> Npien:
+    return default().set_name(name)
+
+
+def connect(room: str, peer=None, ticket: str | None = None, tickets=None,
+            timeout: float = 8.0, discover: bool = True):
+    return default().connect(
+        room,
+        peer=peer,
+        ticket=ticket,
+        tickets=tickets,
+        timeout=timeout,
+        discover=discover,
+    )
+
+
+def listen(room: str, advertise: bool = True) -> Npien:
+    return default().listen(room, advertise=advertise)
+
+
+def join_room(room: str, advertise: bool = True) -> Npien:
+    return default().join_room(room, advertise=advertise)
+
+
+def send(data, to=None) -> int:
+    return default().send(data, to=to)
+
+
+def sendto(data, peer) -> int:
+    return default().sendto(data, peer)
+
+
+def receive(timeout: float | None = None):
+    return default().receive(timeout=timeout)
+
+
+def receive_nowait():
+    return default().receive_nowait()
+
+
+def advsecure(enabled: bool = True) -> Npien:
+    return default().advsecure(enabled)
+
+
+def disablesecure() -> Npien:
+    return default().disablesecure()
+
+
+def create_ticket(room: str | None = None) -> str:
+    return default().create_ticket(room)
+
+
+def add_peer(ticket: str) -> None:
+    return default().add_peer(ticket)
+
+
+def known_peers(room: str | None = None):
+    return default().known_peers(room)
+
+
+def peers(room: str | None = None):
+    return default().peers(room)
+
+
+def on_message(callback):
+    return default().on_message(callback)
+
+
+def get_stun_info() -> dict:
+    return default().get_stun_info()
+
+
+def connection_info() -> dict:
+    return default().connection_info()
+
+
+def disconnect(target=None) -> None:
+    return default().disconnect(target)
+
+
+def close() -> None:
+    global _default
+    if _default is not None:
+        _default.close()
+        _default = None
+
+
+__all__ = [
+    "Npien",
+    "PeerInfo",
+    "Ticket",
+    "NpienError",
+    "ProtocolError",
+    "TicketError",
+    "NotConnectedError",
+    "PeerNotFoundError",
+    "ConnectionTimeoutError",
+    "default",
+    "set_appid",
+    "set_name",
+    "connect",
+    "listen",
+    "join_room",
+    "send",
+    "sendto",
+    "receive",
+    "receive_nowait",
+    "advsecure",
+    "disablesecure",
+    "create_ticket",
+    "add_peer",
+    "known_peers",
+    "peers",
+    "on_message",
+    "get_stun_info",
+    "connection_info",
+    "disconnect",
+    "close",
+]