spoonbot 0.1.0__tar.gz

spoonbot-0.1.0/LICENSE

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

spoonbot-0.1.0/PKG-INFO

@@ -0,0 +1,209 @@
+Metadata-Version: 2.3
+Name: spoonbot
+Version: 0.1.0
+Summary: An unofficial wrapper library that makes it easier to use the official API of the live streaming service "Spoon"
+Author: YomogiBeta
+License: MIT License
+         
+         Copyright (c) 2026 YomogiBeta
+         
+         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.
+Requires-Dist: pydantic>=2.13.5
+Requires-Dist: oauthlib>=4.0.0
+Requires-Dist: aiohttp>=3.14.3
+Requires-Dist: aiosqlite>=0.22.1
+Requires-Dist: aiomysql>=0.3.2
+Requires-Dist: uuid-utils>=1.0.0
+Requires-Dist: itsdangerous>=2.2.0
+Requires-Dist: aiohttp-sse-client2>=0.3.0
+Requires-Dist: pymysql<=1.2.0
+Requires-Dist: fastapi>=0.142.2 ; extra == 'fastapi'
+Requires-Python: >=3.13
+Provides-Extra: fastapi
+Description-Content-Type: text/markdown
+
+# Spoonbot
+
+Spoonbotは、オーディオライブプラットフォーム「Spoon」が公開している、Bot機能の提供API「[Spoon Developpers](https://developers.spooncast.net/docs/ja)」を非常に簡単に利用できるようにするラッパーライブラリです。
+
+主な特徴は以下の通りです。
+
+- **周辺処理不要**: Oauth認可、トークン管理、エラーハンドリング、再接続などSpoon Developpersを利用するために本来必要な様々な周辺処理を実装せずに済みます。
+- **直感的**: PythonでBot開発を行うときによく見られる直感的な書き方でSpoonのBotを開発できます。
+- **簡単**: 少ない記述で実装可能。水平スケールしないのであれば、内臓のSQLite3ですぐに動作します。(MySQLも利用可)
+- **型安全**: Spoon Developpersからの応答はPydanticによって検証され、エディタ補完の効くデータとして受け取ることができます。
+
+## Spoon Developpersの申請
+
+本ライブラリの使用するためには、以下の申請が完了している必要があります。
+
+<https://developers.spooncast.net/docs/ja/getting-started/app-registration>
+
+### 注意
+Spoon Developpers申請に利用したアカウントはそのままボットアカウントとして、連携先のDJのライブでチャット送信などを行います。(Botアカウントが発行されるわけではなく、自分のアカウントがBotのように振る舞うようになる。)  
+これは、本ライブラリの仕様ではなくSpoon Developpersの仕様です。詳細はSpoon Developpersにお問い合わせください。
+
+## インストール
+
+```bash
+pip install spoonbot
+```
+
+uvを利用するのであれば、
+
+```bash
+uv add spoonbot
+```
+
+## Example
+
+以下の内容で`main.py`を作成します。
+
+```python
+from spoonbot import (
+    ChatEvent,
+    SpoonBot,
+    SpoonPermission,
+)
+
+spoonbot = SpoonBot(
+    permissions=set(SpoonPermission)
+    # 権限を個別に指定する場合 ↓
+    # ここで指定しなかったとしても、チャットの送受信と連携ユーザーの情報取得権限は本ライブラリの最低要件として自動指定されます。
+    # permissions={SpoonPermission.EVENTS_LIKE, SpoonPermission.DJ_FOLLOW}
+)
+
+
+@spoonbot.chat_event
+async def hello(chat_event: ChatEvent):
+    if chat_event.chat_body.message == "Hello":
+        await spoonbot.send_chat(
+            f"Hello world {chat_event.chat_body.user.nickname}!!",
+            chat_event.authorization,
+        )
+
+spoonbot.start()
+```
+
+<details markdown="1">
+<summary>他にも、様々なイベントを受け取れます</summary>
+
+```Python
+@spoonbot.connect_event
+async def first_message(connect_event: ConnectEvent):
+    if not connect_event.reconnect:
+        await spoonbot.send_chat(
+            "I’m here!",
+            connect_event.authorization,
+        )
+
+@spoonbot.like_event
+async def like(like_event: LikeEvent):
+    await spoonbot.send_chat(
+        f"Thankyou Heart!! {like_event.like_body.user.nickname}!!",
+        like_event.authorization,
+    )
+
+
+@spoonbot.join_event
+async def join(join_event: JoinEvent):
+    await spoonbot.send_chat(
+        f"Welcome {join_event.presence_body.user.nickname}!!",
+        join_event.authorization,
+    )
+
+
+@spoonbot.gift_event
+async def gift(gift_event: GiftEvent):
+    await spoonbot.send_chat(
+        f"Thankyou gift! {gift_event.donation_body.user.nickname}!!",
+        gift_event.authorization,
+    )
+
+
+@spoonbot.follow_event
+async def follow(follow_event: FollowEvent):
+    await spoonbot.send_chat(
+        f"Thankyou follow! {follow_event.follow_body.user.nickname}!!",
+        follow_event.authorization,
+    )
+
+
+@spoonbot.end_event
+async def end(end_event: EndEvent):
+    print(f"bye {end_event.authorization.id}")
+```
+
+</details>
+
+## 必要な環境変数
+
+必須の物は必ず指定する必要があります。ただし、環境変数キーまたはSpoonBot初期荷時引数のどちらかで指定すればよいです。
+
+| 環境変数キー             | SpoonBot初期化時引数 | 説明                                                                                                                                                                                                                                                                                                         | 必須 | 
+| ------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---- | 
+| SPOON_CLIENT_ID          | spoon_client_id      | Spoon Developpersのコンソールページで発行したClient id。                                                                                                                                                                                                                                                     | ✅   | 
+| SPOON_CLIENT_SECRET      | spoon_client_secret  | `sk_live_` から始まる、Spoon Developpersのコンソールページで発行したClient Secret。この値は漏洩するとbotを乗っ取られるので、適切に管理します。                                                                                                                                                               | ✅   | 
+| SPOON_OAUTH_REDIRECT_URL | oauth_redirect_url   | Spoon Developpersのコンソールページで指定したコールバックURL。コンソールで指定したものと1字1句同じである必要があります。本ライブラリを用いて構築した場合、pathは自動的に「/oauth/callback」となります。                                                                                                      | ✅   | 
+| SPOON_SECRET_KEY         | secret_key           | ランダムな32文字以上のシークレットキーを生成して指定します。これはSpoon Developpersで発行されるものではありません。sessionのキーなどに利用するので、水平スケールする場合は全てのpodで同一のIDにする必要があります。<br>生成方法の一例: ```openssl rand -base64 22```                                         | ✅   | 
+| SPOON_BOT_COUNTRY        | country              | どの国のSpoonで提供するかを指定します。Spoon Developpersでbotを発行したドメインの国と合わせる必要があります。　JP &#124; KR                                                                                                                                                                                  | ✅   | 
+| SPOON_BOT_PORT           | port                 | spoonbotを立ち上げるポートを指定します。デフォルトは8080です。                                                                                                                                                                                                                                               |      | 
+| SPOON_BOT_NAME           | bot_name             | Oauth連携ページや、Bot招待ページにて表示される名前を指定します。デフォルトは「Spoon Bot」です。                                                                                                                                                                                                              |      | 
+|                          | bot_operation_page   | botに関する追加のページを実装し提供する場合、そのパスもしくはURLを指定してください。Bot招待ページに引数で指定したページへ遷移するボタンが出現します。 例えば、web上で入力した値を保存しておき、毎回ライブの最初に送信するといったbotを実装するとき、該当のwebページのパスまたはurlを指定するとよいでしょう。 |      |
+
+## 実行
+
+以下のコマンドで実行し、web上に公開します。必要に応じて上段にNginxなどを設ければよいと思いますが、小規模であればその必要もないと思います。
+
+```bash
+python main.py
+```
+
+または
+
+```bash
+uv run main.py
+```
+
+## 連携
+
+Botを連携するには、まず以下のURLを案内します。  
+https://{your domain}/spoonbot/connect  
+
+<img width="400" height="492" alt="spoonbot-test aakun-da f5 si_spoonbot_connect(iPhone 16)" src="https://github.com/user-attachments/assets/58e98073-f30e-4afd-87cf-28e622828f61" />
+
+「ボットを連携する」をクリックし、spoonのページで認証認可を完了すると、以下のページへ遷移します
+
+<img width="400" height="492" alt="spoonbot-test aakun-da f5 si_spoonbot_success(iPhone 16)" src="https://github.com/user-attachments/assets/3b3becba-e6cf-4e75-9209-9741c97a11c4" />
+
+「ボット招待ページへ」を押した後、先ほど連携したアカウントで、**Spoonライブ配信を開始してください。**  
+ライブ配信を開始したら、「今すぐBotを招待する」を押してください。
+
+<img width="400" height="480" alt="spoonbot-test aakun-da f5 si_spoonbot_invite(iPhone 16)" src="https://github.com/user-attachments/assets/03a6f1bc-90a0-4a71-afb5-63eca8222bc0" />
+
+**Spoon Developpersを申請したアカウントがBotとして配信に入室してきたら、連携成功です。**  
+
+<img width="552" height="135" alt="スクリーンショット 2026-11-10 210610" src="https://github.com/user-attachments/assets/1ad98723-bd5c-4b5a-bafd-a04c819d3f51" />
+
+
+
+## 最後に
+
+- このラッパーライブラリは現在ベータ版です
+- 本ライブラリは㈱Spoonlabs Japan が提供するオーディオライブプラットフォーム「Spoon」内で利用できるAPIである「[Spoon Developpers](https://developers.spooncast.net/jp)」を便利に利用できるようにしたものですが、本ライブラリおよび開発者は㈱Spoonlabs Japan とは一切関係ありません。

spoonbot-0.1.0/README.md

@@ -0,0 +1,169 @@
+# Spoonbot
+
+Spoonbotは、オーディオライブプラットフォーム「Spoon」が公開している、Bot機能の提供API「[Spoon Developpers](https://developers.spooncast.net/docs/ja)」を非常に簡単に利用できるようにするラッパーライブラリです。
+
+主な特徴は以下の通りです。
+
+- **周辺処理不要**: Oauth認可、トークン管理、エラーハンドリング、再接続などSpoon Developpersを利用するために本来必要な様々な周辺処理を実装せずに済みます。
+- **直感的**: PythonでBot開発を行うときによく見られる直感的な書き方でSpoonのBotを開発できます。
+- **簡単**: 少ない記述で実装可能。水平スケールしないのであれば、内臓のSQLite3ですぐに動作します。(MySQLも利用可)
+- **型安全**: Spoon Developpersからの応答はPydanticによって検証され、エディタ補完の効くデータとして受け取ることができます。
+
+## Spoon Developpersの申請
+
+本ライブラリの使用するためには、以下の申請が完了している必要があります。
+
+<https://developers.spooncast.net/docs/ja/getting-started/app-registration>
+
+### 注意
+Spoon Developpers申請に利用したアカウントはそのままボットアカウントとして、連携先のDJのライブでチャット送信などを行います。(Botアカウントが発行されるわけではなく、自分のアカウントがBotのように振る舞うようになる。)  
+これは、本ライブラリの仕様ではなくSpoon Developpersの仕様です。詳細はSpoon Developpersにお問い合わせください。
+
+## インストール
+
+```bash
+pip install spoonbot
+```
+
+uvを利用するのであれば、
+
+```bash
+uv add spoonbot
+```
+
+## Example
+
+以下の内容で`main.py`を作成します。
+
+```python
+from spoonbot import (
+    ChatEvent,
+    SpoonBot,
+    SpoonPermission,
+)
+
+spoonbot = SpoonBot(
+    permissions=set(SpoonPermission)
+    # 権限を個別に指定する場合 ↓
+    # ここで指定しなかったとしても、チャットの送受信と連携ユーザーの情報取得権限は本ライブラリの最低要件として自動指定されます。
+    # permissions={SpoonPermission.EVENTS_LIKE, SpoonPermission.DJ_FOLLOW}
+)
+
+
+@spoonbot.chat_event
+async def hello(chat_event: ChatEvent):
+    if chat_event.chat_body.message == "Hello":
+        await spoonbot.send_chat(
+            f"Hello world {chat_event.chat_body.user.nickname}!!",
+            chat_event.authorization,
+        )
+
+spoonbot.start()
+```
+
+<details markdown="1">
+<summary>他にも、様々なイベントを受け取れます</summary>
+
+```Python
+@spoonbot.connect_event
+async def first_message(connect_event: ConnectEvent):
+    if not connect_event.reconnect:
+        await spoonbot.send_chat(
+            "I’m here!",
+            connect_event.authorization,
+        )
+
+@spoonbot.like_event
+async def like(like_event: LikeEvent):
+    await spoonbot.send_chat(
+        f"Thankyou Heart!! {like_event.like_body.user.nickname}!!",
+        like_event.authorization,
+    )
+
+
+@spoonbot.join_event
+async def join(join_event: JoinEvent):
+    await spoonbot.send_chat(
+        f"Welcome {join_event.presence_body.user.nickname}!!",
+        join_event.authorization,
+    )
+
+
+@spoonbot.gift_event
+async def gift(gift_event: GiftEvent):
+    await spoonbot.send_chat(
+        f"Thankyou gift! {gift_event.donation_body.user.nickname}!!",
+        gift_event.authorization,
+    )
+
+
+@spoonbot.follow_event
+async def follow(follow_event: FollowEvent):
+    await spoonbot.send_chat(
+        f"Thankyou follow! {follow_event.follow_body.user.nickname}!!",
+        follow_event.authorization,
+    )
+
+
+@spoonbot.end_event
+async def end(end_event: EndEvent):
+    print(f"bye {end_event.authorization.id}")
+```
+
+</details>
+
+## 必要な環境変数
+
+必須の物は必ず指定する必要があります。ただし、環境変数キーまたはSpoonBot初期荷時引数のどちらかで指定すればよいです。
+
+| 環境変数キー             | SpoonBot初期化時引数 | 説明                                                                                                                                                                                                                                                                                                         | 必須 | 
+| ------------------------ | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---- | 
+| SPOON_CLIENT_ID          | spoon_client_id      | Spoon Developpersのコンソールページで発行したClient id。                                                                                                                                                                                                                                                     | ✅   | 
+| SPOON_CLIENT_SECRET      | spoon_client_secret  | `sk_live_` から始まる、Spoon Developpersのコンソールページで発行したClient Secret。この値は漏洩するとbotを乗っ取られるので、適切に管理します。                                                                                                                                                               | ✅   | 
+| SPOON_OAUTH_REDIRECT_URL | oauth_redirect_url   | Spoon Developpersのコンソールページで指定したコールバックURL。コンソールで指定したものと1字1句同じである必要があります。本ライブラリを用いて構築した場合、pathは自動的に「/oauth/callback」となります。                                                                                                      | ✅   | 
+| SPOON_SECRET_KEY         | secret_key           | ランダムな32文字以上のシークレットキーを生成して指定します。これはSpoon Developpersで発行されるものではありません。sessionのキーなどに利用するので、水平スケールする場合は全てのpodで同一のIDにする必要があります。<br>生成方法の一例: ```openssl rand -base64 22```                                         | ✅   | 
+| SPOON_BOT_COUNTRY        | country              | どの国のSpoonで提供するかを指定します。Spoon Developpersでbotを発行したドメインの国と合わせる必要があります。　JP &#124; KR                                                                                                                                                                                  | ✅   | 
+| SPOON_BOT_PORT           | port                 | spoonbotを立ち上げるポートを指定します。デフォルトは8080です。                                                                                                                                                                                                                                               |      | 
+| SPOON_BOT_NAME           | bot_name             | Oauth連携ページや、Bot招待ページにて表示される名前を指定します。デフォルトは「Spoon Bot」です。                                                                                                                                                                                                              |      | 
+|                          | bot_operation_page   | botに関する追加のページを実装し提供する場合、そのパスもしくはURLを指定してください。Bot招待ページに引数で指定したページへ遷移するボタンが出現します。 例えば、web上で入力した値を保存しておき、毎回ライブの最初に送信するといったbotを実装するとき、該当のwebページのパスまたはurlを指定するとよいでしょう。 |      |
+
+## 実行
+
+以下のコマンドで実行し、web上に公開します。必要に応じて上段にNginxなどを設ければよいと思いますが、小規模であればその必要もないと思います。
+
+```bash
+python main.py
+```
+
+または
+
+```bash
+uv run main.py
+```
+
+## 連携
+
+Botを連携するには、まず以下のURLを案内します。  
+https://{your domain}/spoonbot/connect  
+
+<img width="400" height="492" alt="spoonbot-test aakun-da f5 si_spoonbot_connect(iPhone 16)" src="https://github.com/user-attachments/assets/58e98073-f30e-4afd-87cf-28e622828f61" />
+
+「ボットを連携する」をクリックし、spoonのページで認証認可を完了すると、以下のページへ遷移します
+
+<img width="400" height="492" alt="spoonbot-test aakun-da f5 si_spoonbot_success(iPhone 16)" src="https://github.com/user-attachments/assets/3b3becba-e6cf-4e75-9209-9741c97a11c4" />
+
+「ボット招待ページへ」を押した後、先ほど連携したアカウントで、**Spoonライブ配信を開始してください。**  
+ライブ配信を開始したら、「今すぐBotを招待する」を押してください。
+
+<img width="400" height="480" alt="spoonbot-test aakun-da f5 si_spoonbot_invite(iPhone 16)" src="https://github.com/user-attachments/assets/03a6f1bc-90a0-4a71-afb5-63eca8222bc0" />
+
+**Spoon Developpersを申請したアカウントがBotとして配信に入室してきたら、連携成功です。**  
+
+<img width="552" height="135" alt="スクリーンショット 2026-11-10 210610" src="https://github.com/user-attachments/assets/1ad98723-bd5c-4b5a-bafd-a04c819d3f51" />
+
+
+
+## 最後に
+
+- このラッパーライブラリは現在ベータ版です
+- 本ライブラリは㈱Spoonlabs Japan が提供するオーディオライブプラットフォーム「Spoon」内で利用できるAPIである「[Spoon Developpers](https://developers.spooncast.net/jp)」を便利に利用できるようにしたものですが、本ライブラリおよび開発者は㈱Spoonlabs Japan とは一切関係ありません。

spoonbot-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[project]
+name = "spoonbot"
+version = "0.1.0"
+description = 'An unofficial wrapper library that makes it easier to use the official API of the live streaming service "Spoon"'
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "pydantic>=2.13.5",
+    "oauthlib>=4.0.0",
+    "aiohttp>=3.14.3",
+    "aiosqlite>=0.22.1",
+    "aiomysql>=0.3.2",
+    "uuid-utils>=1.0.0",
+    "itsdangerous>=2.2.0",
+    "aiohttp-sse-client2>=0.3.0",
+    "PyMySQL<=1.2.0",
+]
+
+[[project.authors]]
+name = "YomogiBeta"
+
+[project.license]
+file = "LICENSE"
+
+[project.optional-dependencies]
+fastapi = ["fastapi>=0.142.2"]
+
+[build-system]
+requires = ["uv_build>=0.13.0,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.414",
+    "ruff>=0.16.10",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "PLE",
+]

spoonbot-0.1.0/pyproject.toml.orig

@@ -0,0 +1,41 @@
+[project]
+name = "spoonbot"
+version = "0.1.0"
+description = "An unofficial wrapper library that makes it easier to use the official API of the live streaming service \"Spoon\""
+readme = "README.md"
+authors = [
+    { name = "YomogiBeta" }
+]
+license = { file = "LICENSE" }
+requires-python = ">=3.13"
+dependencies = [
+    "pydantic>=2.13.5",
+    "oauthlib>=4.0.0",
+    "aiohttp>=3.14.3",
+    "aiosqlite>=0.22.1",
+    "aiomysql>=0.3.2",
+    "uuid-utils>=1.0.0",
+    "itsdangerous>=2.2.0",
+    "aiohttp-sse-client2>=0.3.0",
+
+    # https://github.com/aio-libs/aiomysql/issues/1080
+    # https://github.com/aio-libs/aiomysql/pull/1081
+    "PyMySQL<=1.2.0"
+]
+
+[project.optional-dependencies]
+fastapi = [
+    "fastapi>=0.142.2"
+]
+
+[build-system]
+requires = ["uv_build>=0.13.0,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.414",
+    "ruff>=0.16.10",
+]
+[tool.ruff.lint]
+select = ["E", "F", "PLE"]

spoonbot-0.1.0/src/spoonbot/__init__.py

@@ -0,0 +1,25 @@
+from spoonbot.db.config.MySQLConfig import MySQLConfig
+from spoonbot.dto.event.ChatEvent import ChatEvent
+from spoonbot.dto.event.ConnectEvent import ConnectEvent
+from spoonbot.dto.event.DonationEvent import GiftEvent
+from spoonbot.dto.event.EndEvent import EndEvent
+from spoonbot.dto.event.FollowEvent import FollowEvent
+from spoonbot.dto.event.JoinEvent import JoinEvent
+from spoonbot.dto.event.LikeEvent import LikeEvent
+from spoonbot.enums.Country import Country
+from spoonbot.enums.SpoonPermission import SpoonPermission
+from spoonbot.spoon_bot import SpoonBot
+
+__all__ = [
+    "MySQLConfig",
+    "ChatEvent",
+    "ConnectEvent",
+    "GiftEvent",
+    "EndEvent",
+    "FollowEvent",
+    "JoinEvent",
+    "LikeEvent",
+    "Country",
+    "SpoonPermission",
+    "SpoonBot",
+]

spoonbot-0.1.0/src/spoonbot/config/ConstantsConfig.py

@@ -0,0 +1,21 @@
+from typing import Self
+
+from spoonbot.constants import (
+    API_BASE_URL_JP,
+    API_BASE_URL_KR,
+    OAUTH_AUTHORIZE_BASE_URL_JP,
+    OAUTH_AUTHORIZE_BASE_URL_KR,
+)
+from spoonbot.enums.Country import Country
+
+
+class ConstantsConfig:
+    def __init__(self, oauth_authorize_base_url: str, api_base_url: str) -> None:
+        self.oauth_authorize_base_url = oauth_authorize_base_url
+        self.api_base_url = api_base_url
+
+    @classmethod
+    def create(cls, country: Country) -> Self:
+        if country == Country.KR:
+            return cls(OAUTH_AUTHORIZE_BASE_URL_KR, API_BASE_URL_KR)
+        return cls(OAUTH_AUTHORIZE_BASE_URL_JP, API_BASE_URL_JP)

spoonbot-0.1.0/src/spoonbot/constants.py

@@ -0,0 +1,12 @@
+OAUTH_AUTHORIZE_BASE_URL_KR = "https://developers.spooncast.net/kr/oauth/authorize"
+OAUTH_AUTHORIZE_BASE_URL_JP = "https://developers.spooncast.net/jp/oauth/authorize"
+
+API_BASE_URL_KR = "https://kr-openapi.spooncast.net/v1/"
+API_BASE_URL_JP = "https://jp-openapi.spooncast.net/v1/"
+
+SPACE = " "
+# https://developers.spooncast.net/docs/en/api-reference/tokens
+DEFAULT_REFRESH_TOKEN_EXPIRES_IN = 60 * 60 * 24 * 30  # 30 days
+DEFAULT_SESSION_EXPIRES_IN = (
+    DEFAULT_REFRESH_TOKEN_EXPIRES_IN - 60 * 15
+)  # 29 days 23 hour 45 minutes

spoonbot-0.1.0/src/spoonbot/controller/SpoonBotController.py

@@ -0,0 +1,56 @@
+from aiohttp.web_exceptions import HTTPForbidden, HTTPUnauthorized
+from aiohttp.web_request import Request
+from aiohttp.web_response import Response, json_response
+from aiohttp.web_routedef import RouteTableDef
+
+from spoonbot.spoon_bot import SpoonBot
+
+routes = RouteTableDef()
+
+
+class SpoonBotController:
+    spoon_bot: SpoonBot
+
+    def __init__(self, spoon_bot: SpoonBot) -> None:
+        self.spoon_bot = spoon_bot
+
+        routes.get("/api/v1/csrf-token")(self.csrf_token_function())
+        routes.get("/api/v1/bot")(self.bot_information_function())
+        routes.post("/api/v1/bot/invite")(self.bot_invite_request_handler())
+
+    def csrf_token_function(self):
+        async def csrf_token_handler(request: Request) -> Response:
+            session_id = request.cookies.get("session_id")
+            if session_id is None:
+                raise HTTPUnauthorized()
+            csrf_token = await self.spoon_bot.regenerate_csrf_token(session_id)
+            return json_response({"csrf_token": csrf_token})
+
+        return csrf_token_handler
+
+    def bot_information_function(self):
+        async def bot_information_handler(_: Request) -> Response:
+            page = self.spoon_bot.get_bot_operation_page()
+            return json_response(
+                {"bot_name": self.spoon_bot.get_bot_name(), "page": page}
+            )
+
+        return bot_information_handler
+
+    def bot_invite_request_handler(self):
+        async def bot_invite_request(request: Request) -> Response:
+            session_id = request.cookies.get("session_id")
+            csrf_token = request.headers.get("X-CSRF-TOKEN")
+            if session_id is None:
+                raise HTTPUnauthorized()
+            if csrf_token is None:
+                raise HTTPForbidden(reason="Bad Request. Need X-CSRF-TOKEN")
+            result = await self.spoon_bot.start_stream_by_session(
+                session_id, csrf_token
+            )
+            return Response(status=204 if result else 409)
+
+        return bot_invite_request
+
+    def get_route(self) -> RouteTableDef:
+        return routes

spoonbot-0.1.0/src/spoonbot/controller/SpoonBotWebController.py

@@ -0,0 +1,52 @@
+import sys
+from pathlib import Path
+
+from aiohttp.web_exceptions import HTTPNotFound
+from aiohttp.web_fileresponse import FileResponse
+from aiohttp.web_request import Request
+from aiohttp.web_response import StreamResponse
+from aiohttp.web_routedef import RouteTableDef
+
+routes = RouteTableDef()
+
+
+def _get_base_dir() -> Path:
+    # PyInstaller などで実行ファイル化されている場合
+    meipass = getattr(sys, "_MEIPASS", None)
+    if meipass is not None:
+        return Path(meipass)
+
+    if getattr(sys, "frozen", False):
+        return Path(sys.executable).resolve().parent
+
+    # src/controller/xxx.py
+    return Path(__file__).resolve().parents[3]
+
+
+PAGES = {
+    "connect": "connect.html",
+    "success": "success.html",
+    "fail": "fail.html",
+    "invite": "invite.html",
+}
+ASSETS_DIR = _get_base_dir() / "assets"
+
+
+class SpoonBotWebController:
+    def __init__(self) -> None:
+        for page in PAGES:
+            routes.get(f"/spoonbot/{page}")(self.serve_page)
+        routes.static("/assets/", ASSETS_DIR)
+
+    @staticmethod
+    async def serve_page(request: Request) -> StreamResponse:
+        filename = PAGES[request.path[len("/spoonbot/") :]]
+        filepath = ASSETS_DIR / filename
+
+        if not filepath.is_file():
+            raise HTTPNotFound()
+
+        return FileResponse(filepath)
+
+    def get_route(self) -> RouteTableDef:
+        return routes