msteams 0.1.0

package/README.md

@@ -0,0 +1,107 @@
+# teams-api
+
+`teams.cloud.microsoft.har` から Teams Web API の認証情報と実行コンテキストを抽出し、読み取り専用 API を呼び出すためのクライアントです。
+
+## Install
+
+```bash
+bun install
+```
+
+## Quick Start
+
+```ts
+import { TeamsApiClient } from './index.ts'
+
+const client = await TeamsApiClient.fromHarFile('./teams.cloud.microsoft.har')
+
+const bootstrap = await client.listBootstrap()
+console.log('teams:', bootstrap.teams?.length ?? 0)
+console.log('chats:', bootstrap.chats?.length ?? 0)
+
+const notifications = await client.listNotificationMessages({ pageSize: 20 })
+console.log('notification messages:', notifications.messages?.length ?? 0)
+```
+
+Cookie だけで開始する場合:
+
+```ts
+import { TeamsApiClient } from './index.ts'
+
+const client = TeamsApiClient.fromCookie(process.env.TEAMS_COOKIE ?? '')
+const auth = await client.refreshSkypeTokenFromCookie()
+console.log(auth.source, auth.expiresAt)
+```
+
+HAR から認証関連 JS を抽出して調べる場合:
+
+```bash
+bun run example/extract-auth-js.ts ./teams.cloud.microsoft.har ./example/har-js 8
+# 出力されたファイルは bunx oxfmt で整形
+```
+
+## 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
+
+```bash
+bun run src/cli/index.ts [options] <command> [arguments]
+```
+
+またはインストール後:
+
+```bash
+teams [options] <command> [arguments]
+```
+
+### 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 を自動推定します。

package/dist/TeamsClient-D4-exLIC.mjs

@@ -0,0 +1,225 @@
+//#region src/auth/TokenManager.ts
+var TokenManager = class {
+	#refresh;
+	#tokenCache = /* @__PURE__ */ new Map();
+	constructor(refreshToken) {
+		this.#refresh = refreshToken;
+	}
+	async getToken(scope) {
+		return this.getTokenFromScope(scope);
+	}
+	getRefreshToken() {
+		return this.#refresh;
+	}
+	async getTokenFromScope(scope) {
+		const cached = this.#tokenCache.get(scope);
+		if (cached && cached.expiresAt > Date.now()) return cached.token;
+		const formData = new URLSearchParams();
+		formData.append("client_id", "5e3ce6c0-2b1f-4285-8d4b-75ee78787346");
+		formData.append("redirect_uri", "https://teams.cloud.microsoft/v2/auth");
+		formData.append("scope", scope);
+		formData.append("grant_type", "refresh_token");
+		formData.append("client_info", "1");
+		formData.append("x-client-SKU", "msal.js.browser");
+		formData.append("x-client-VER", "3.30.0");
+		formData.append("x-ms-lib-capability", "retry-after, h429");
+		formData.append("x-client-current-telemetry", "5|61,0,,,|");
+		formData.append("x-client-last-telemetry", "5|0|||0,0");
+		formData.append("refresh_token", this.#refresh);
+		const newToken = await fetch("https://login.microsoftonline.com/83d9219c-a57d-4d58-b3e5-4abef53925a2/oauth2/v2.0/token?client-request-id=Core-5e01fb3c-a48b-44c9-83fa-2aa7be8fd4e3", {
+			headers: {
+				"content-type": "application/x-www-form-urlencoded;charset=utf-8",
+				origin: "https://teams.cloud.microsoft"
+			},
+			referrer: "https://teams.cloud.microsoft/",
+			body: formData,
+			method: "POST",
+			mode: "cors",
+			credentials: "omit"
+		});
+		if (!newToken.ok) throw new Error(`Failed to refresh token: ${newToken.status} ${newToken.statusText}`);
+		const newTokenJson = await newToken.json();
+		this.#refresh = newTokenJson.refresh_token;
+		this.#tokenCache.set(scope, {
+			token: newTokenJson.access_token,
+			expiresAt: Date.now() + newTokenJson.expires_in * 1e3 - 300 * 1e3
+		});
+		return newTokenJson.access_token;
+	}
+};
+
+//#endregion
+//#region src/rest/constants.ts
+const TEAMS_WORKER_REFERRER = "https://teams.cloud.microsoft/v2/worker/precompiled-web-worker-8e61d59c0abedf86.js";
+const SCOPES = {
+	chats: "https://ic3.teams.office.com/.default openid profile offline_access",
+	channels: "https://chatsvcagg.teams.microsoft.com/.default openid profile offline_access",
+	users: "https://api.spaces.skype.com/.default openid profile offline_access"
+};
+
+//#endregion
+//#region src/rest/RestClient.ts
+const appendQuery = (url, query) => {
+	if (!query) return url;
+	const queryString = (query instanceof URLSearchParams ? query : new URLSearchParams(Object.entries(query).flatMap(([key, value]) => {
+		if (typeof value === "undefined") return [];
+		return [[key, String(value)]];
+	}))).toString();
+	if (!queryString) return url;
+	return `${url}${url.includes("?") ? "&" : "?"}${queryString}`;
+};
+var RestClient = class {
+	#tokenProvider;
+	#referrer;
+	constructor(tokenProvider, referrer = TEAMS_WORKER_REFERRER) {
+		this.#tokenProvider = tokenProvider;
+		this.#referrer = referrer;
+	}
+	async request(url, options) {
+		const token = await this.#tokenProvider.getTokenFromScope(options.scope);
+		const headers = new Headers(options.headers);
+		headers.set("authorization", `Bearer ${token}`);
+		const method = options.method ?? "GET";
+		const res = await fetch(appendQuery(url, options.query), {
+			method,
+			headers,
+			referrer: options.referrer ?? this.#referrer,
+			body: options.body
+		});
+		if (!res.ok) throw new Error(`Failed request ${method} ${url}: ${res.status} ${res.statusText}`);
+		return await res.json();
+	}
+};
+
+//#endregion
+//#region src/rest/routes/channels.ts
+const fetchChannel = async (rest, teamId, channelId, options) => {
+	const pageSize = options?.pageSize ?? 20;
+	return rest.request(`https://teams.cloud.microsoft/api/csa/apac/api/v1/teams/${encodeURIComponent(teamId)}/channels/${encodeURIComponent(channelId)}`, {
+		scope: SCOPES.channels,
+		query: { pageSize }
+	});
+};
+const flattenChannelMessages = (posts) => {
+	const messages = [];
+	for (const chain of posts.replyChains) {
+		if (Array.isArray(chain.messages)) {
+			messages.push(...chain.messages);
+			continue;
+		}
+		if (Array.isArray(chain.replies)) {
+			messages.push(...chain.replies);
+			continue;
+		}
+		if (chain.message) messages.push(chain.message);
+	}
+	return messages;
+};
+const fetchChannelMessages = async (rest, teamId, channelId, options) => {
+	return flattenChannelMessages(await fetchChannel(rest, teamId, channelId, options));
+};
+
+//#endregion
+//#region src/rest/routes/conversations.ts
+const fetchConversationMessages = async (rest, conversationId, options) => {
+	const { view = "msnp24Equivalent|supportsMessageProperties", pageSize = 200, startTime = 1, syncState, endTime, draftVersion } = options ?? {};
+	const query = new URLSearchParams({
+		view,
+		pageSize: `${pageSize}`,
+		startTime: `${startTime}`
+	});
+	if (syncState) query.set("syncState", syncState);
+	if (typeof endTime !== "undefined") query.set("endTime", `${endTime}`);
+	if (draftVersion) query.set("draftVersion", draftVersion);
+	const normalizedConversationId = encodeURIComponent(conversationId);
+	return rest.request(`https://teams.cloud.microsoft/api/chatsvc/jp/v1/users/ME/conversations/${normalizedConversationId}/messages`, {
+		scope: SCOPES.chats,
+		query
+	});
+};
+
+//#endregion
+//#region src/rest/routes/users.ts
+const fetchShortProfile = async (rest, mriOrEmailArray, options) => {
+	const { isMailAddress = false, skypeTeamsInfo = true, canBeSmtpAddress = false, includeIBBarredUsers = true, includeDisabledAccounts = true } = options ?? {};
+	const query = new URLSearchParams({
+		isMailAddress: `${isMailAddress}`,
+		enableGuest: "true",
+		skypeTeamsInfo: `${skypeTeamsInfo}`,
+		canBeSmtpAddress: `${canBeSmtpAddress}`,
+		includeIBBarredUsers: `${includeIBBarredUsers}`,
+		includeDisabledAccounts: `${includeDisabledAccounts}`
+	});
+	return (await rest.request("https://teams.cloud.microsoft/api/mt/apac/beta/users/fetchShortProfile", {
+		scope: SCOPES.users,
+		method: "POST",
+		query,
+		headers: { "content-type": "application/json;charset=UTF-8" },
+		body: JSON.stringify(mriOrEmailArray)
+	})).value;
+};
+const fetchCurrentUser = async (rest) => {
+	return rest.request("https://teams.cloud.microsoft/api/csa/apac/api/v3/teams/users/me", {
+		scope: SCOPES.channels,
+		query: {
+			isPrefetch: false,
+			enableMembershipSummary: true,
+			supportsAdditionalSystemGeneratedFolders: true,
+			supportsSliceItems: true,
+			enableEngageCommunities: false
+		}
+	});
+};
+const fetchPinnedChannels = async (rest) => {
+	return rest.request("https://teams.cloud.microsoft/api/csa/apac/api/v1/teams/users/me/pinnedChannels", { scope: SCOPES.channels });
+};
+
+//#endregion
+//#region src/client/TeamsClient.ts
+var TeamsClient = class {
+	rest;
+	teams;
+	constructor(tokenProvider) {
+		this.rest = new RestClient(tokenProvider);
+		this.teams = {
+			conversations: { fetchMessages: (conversationId, options) => this.fetchConversationMessages(conversationId, options) },
+			notifications: {
+				fetchMessages: (options) => this.fetchConversationMessages("48:notifications", options),
+				fetchMentions: (options) => this.fetchConversationMessages("48:mentions", options),
+				fetchAnnotations: (options) => this.fetchConversationMessages("48:annotations", options)
+			},
+			channels: {
+				fetch: (teamId, channelId, options) => this.fetchChannel(teamId, channelId, options),
+				fetchMessages: (teamId, channelId, options) => this.fetchChannelMessages(teamId, channelId, options)
+			},
+			users: {
+				fetchShortProfile: (mriOrEmailArray, options) => this.fetchShortProfile(mriOrEmailArray, options),
+				me: {
+					fetch: () => this.fetchCurrentUser(),
+					fetchPinnedChannels: () => this.fetchPinnedChannels()
+				}
+			}
+		};
+	}
+	async fetchConversationMessages(conversationId, options) {
+		return fetchConversationMessages(this.rest, conversationId, options);
+	}
+	async fetchChannel(teamId, channelId, options) {
+		return fetchChannel(this.rest, teamId, channelId, options);
+	}
+	async fetchChannelMessages(teamId, channelId, options) {
+		return fetchChannelMessages(this.rest, teamId, channelId, options);
+	}
+	async fetchShortProfile(mriOrEmailArray, options) {
+		return fetchShortProfile(this.rest, mriOrEmailArray, options);
+	}
+	async fetchCurrentUser() {
+		return fetchCurrentUser(this.rest);
+	}
+	async fetchPinnedChannels() {
+		return fetchPinnedChannels(this.rest);
+	}
+};
+
+//#endregion
+export { TokenManager as n, TeamsClient as t };

package/dist/cli/index.d.mts

@@ -0,0 +1 @@
+export { };