msteams 0.1.0 → 0.1.2

package/LICENSE

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

package/README.md

@@ -1,107 +1,121 @@
 # teams-api
 
-`teams.cloud.microsoft.har` から Teams Web API の認証情報と実行コンテキストを抽出し、読み取り専用 API を呼び出すためのクライアントです。
+`msteams` is a lightweight TypeScript library and CLI for interacting with Microsoft Teams endpoints used by the web client.
 
-## Install
+## Warning
 
-```bash
-bun install
-```
+* Node.js is currently not supported yet. Use Bun
+* Auth token should be updated in 24 hours. Automatic token updating is working in progress.
 
-## Quick Start
+## Overview
 
-```ts
-import { TeamsApiClient } from './index.ts'
+- CLI: use the `teams` command to fetch notifications, messages, channels, and user/team data
+- Library: use `TeamsClient` and `TokenManager` to access the same endpoints from TypeScript
+- Token handling: refresh token is stored as a local profile in `~/.teams-cli/<name>.json`
+- Machine mode: use `--json` for scripts and automation
 
-const client = await TeamsApiClient.fromHarFile('./teams.cloud.microsoft.har')
+> Warning: This package uses unofficial endpoints. Behavior may change if Microsoft updates those APIs.
 
-const bootstrap = await client.listBootstrap()
-console.log('teams:', bootstrap.teams?.length ?? 0)
-console.log('chats:', bootstrap.chats?.length ?? 0)
+## Install
 
-const notifications = await client.listNotificationMessages({ pageSize: 20 })
-console.log('notification messages:', notifications.messages?.length ?? 0)
+```bash
+bun add msteams
 ```
 
-Cookie だけで開始する場合:
+```bash
+npm install msteams
+```
 
-```ts
-import { TeamsApiClient } from './index.ts'
+## CLI usage
 
-const client = TeamsApiClient.fromCookie(process.env.TEAMS_COOKIE ?? '')
-const auth = await client.refreshSkypeTokenFromCookie()
-console.log(auth.source, auth.expiresAt)
+```bash
+# Show help
+bunx --bun teams --help
 ```
 
-HAR から認証関連 JS を抽出して調べる場合:
+### Set refresh token
 
 ```bash
-bun run example/extract-auth-js.ts ./teams.cloud.microsoft.har ./example/har-js 8
-# 出力されたファイルは bunx oxfmt で整形
+bunx --bun teams set-refresh-token --refresh-token=<your_refresh_token>
 ```
 
-## Main APIs
-
-- `TeamsApiClient.fromHarFile(harPath)`
-  - `HAR` から `skypeToken` とヘッダー情報を抽出してクライアントを作成
-- `TeamsApiClient.fromCookie(cookie)`
-  - `cookie` のみでクライアントを作成。初回 API 呼び出し時、または `refreshSkypeTokenFromCookie()` で `authsvc` から `skypeToken` を取得
-- `listBootstrap()`
-  - `api/csa/{geo}/api/v3/teams/users/me` を呼び、チーム/チャット一覧を取得
-- `listTeams()`, `listChats()`
-  - `listBootstrap()` の便利ラッパー
-- `listChannelPosts(teamId, channelId)`
-  - `api/csa/{geo}/api/v1/teams/{teamId}/channels/{channelId}` を呼び、投稿スレッド（`replyChains`）を取得
-- `listChannelMessages(teamId, channelId)`
-  - `replyChains` からメッセージを平坦化
-- `getConversation(conversationId)`
-  - `api/chatsvc/{geo}/api/v1/users/ME/conversations/{conversationId}` を取得
-- `listConversationMessages(conversationId, options)`
-  - `api/chatsvc/{geo}/api/v1/users/ME/conversations/{conversationId}/messages` を取得
-- `listNotificationMessages()`, `listMentionMessages()`, `listAnnotationMessages()`
-  - それぞれ `48:notifications`, `48:mentions`, `48:annotations` の便利ラッパー
-
-## CLI Usage
+- Default profile path: `~/.teams-cli/default.json`
+- You can change the profile with `--profile`
+- You can also pass token via `--refresh-token` or `REFRESH_TOKEN`
+
+### Common commands
 
 ```bash
-bun run src/cli/index.ts [options] <command> [arguments]
+# Fetch latest notifications (default: 20)
+teams notifications [--limit N]
+
+# Fetch conversation messages
+teams messages <conversationId> [--limit N]
+
+# Fetch channel messages
+teams channel messages <channelId> [--limit N]
+
+# List teams
+teams teams list
+
+# List channels in a team
+teams teams channels <teamId>
+
+# Fetch current user snapshot
+teams me
 ```
 
-またはインストール後:
+### Common options
+
+- `--json`: output only JSON
+- `--no-color`: disable ANSI colors
+- `--profile=<name>`: use another local profile name
+- `--profile-json=<path>`: use a custom profile JSON file
+- `--refresh-token=<token>`: set token for current run
+- `--help`: show help
+
+## Library usage
+
+```ts
+import { TeamsClient, TokenManager } from 'msteams'
+
+const tokenManager = new TokenManager(process.env.REFRESH_TOKEN || '')
+const client = new TeamsClient(tokenManager)
+
+const me = await client.teams.users.me.fetch()
+console.log(me.teams?.length ?? 0, 'teams')
+```
+
+```ts
+const notifications = await client.teams.notifications.fetchMessages({ pageSize: 10 })
+console.log(notifications.messages?.length ?? 0)
+```
+
+### Exported API
+
+- `TokenManager`
+- `ScopeTokenProvider`
+- `TeamsClient`
+- `teams.conversations.fetchMessages`
+- `teams.notifications.fetchMessages`, `fetchMentions`, `fetchAnnotations`
+- `teams.channels.fetch`, `teams.channels.fetchMessages`
+- `teams.users.fetchShortProfile`
+- `teams.users.me.fetch`, `teams.users.me.fetchPinnedChannels`
+
+## Development
 
 ```bash
-teams [options] <command> [arguments]
+bun install
+bun run build
+bun run fmt
 ```
 
-### Commands
-
-- `teams notifications [--limit N]`
-  - 通知一覧を取得
-- `teams messages <conversationId> [--limit N]`
-  - 会話のメッセージを取得
-- `teams channel messages <channelId> [--limit N]`
-  - チームチャンネルのメッセージを取得（`me` 結果から `teamId` を自動解決）
-- `teams teams list`
-  - 参加チーム一覧を取得
-- `teams teams channels <teamId>`
-  - 指定チームのチャンネル一覧を取得
-- `teams me`
-  - 現在ユーザー情報（チーム/チャット含む）を取得
-- `teams set-refresh-token --refresh-token=<token> [--profile=<name>]`
-  - プロファイルへリフレッシュトークンを保存
-
-### Options
-
-- `--profile=<name>`: `~/.teams-cli/<name>.json` を使用（既定: `default`）
-- `--profile-json=<path>`: 任意の profile json を使用
-- `--refresh-token=<token>`: リフレッシュトークンを指定
-- `--json`: 機械可読 JSON で出力
-- `--no-color`: ANSI カラーを無効化
-- `--help`: ヘルプ表示
-
-## Notes
-
-- 本実装は **write 系 API を含みません**。
-- `HAR` は通常 `Authorization/Cookie` を完全に含まないため、抽出できる `skypeToken` の有効期限切れ時は再取得が必要です。
-- `cookie` 単体で動かす場合でも、内部では `https://teams.microsoft.com/api/authsvc/v1.0/authz` に対して `cookie` を使い `skypeToken` を取得してから各 API を呼びます。
-- `fromCookie()` で `endpoint.baseUrl` を上書きした場合、`endpoint.authzUrl` を未指定ならクラウド環境に応じた `authsvc` URL を自動推定します。
+The package uses `vite-plus` to build both library and CLI entry points.
+
+## Repository
+
+- https://github.com/nakasyou/teams-api
+
+## License
+
+MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "msteams",
   "private": false,
-  "version": "0.1.0",
+  "version": "0.1.2",
   "files": [
     "dist"
   ],
@@ -15,6 +15,10 @@
       "types": "./dist/index.d.mts"
     }
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nakasyou/teams-api.git"
+  },
   "type": "module",
   "scripts": {
     "cli": "bun run src/cli/index.ts",