@hahnfeld/teams-adapter 1.0.9

package/dist/validators.js

@@ -0,0 +1,142 @@
+/**
+ * Validate bot credentials by acquiring a token from the MSA/AAD endpoint.
+ * This proves the App ID and Password are correct and the bot registration exists.
+ */
+export async function validateBotCredentials(appId, appPassword, tenantId) {
+    try {
+        const tenant = tenantId || "botframework.com";
+        const response = await fetch(`https://login.microsoftonline.com/${tenant}/oauth2/v2.0/token`, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: new URLSearchParams({
+                grant_type: "client_credentials",
+                client_id: appId,
+                client_secret: appPassword,
+                scope: "https://api.botframework.com/.default",
+            }).toString(),
+        });
+        if (response.ok) {
+            return { ok: true };
+        }
+        const data = (await response.json().catch(() => ({})));
+        if (data.error === "invalid_client") {
+            return { ok: false, error: "Invalid App ID or Password. Check your Azure Bot registration." };
+        }
+        if (data.error === "unauthorized_client") {
+            return { ok: false, error: "App ID is not authorized. Ensure it's registered as a Bot in Azure." };
+        }
+        return { ok: false, error: `Authentication failed (${response.status}). Verify your credentials.` };
+    }
+    catch (err) {
+        return { ok: false, error: `Network error: ${err.message}` };
+    }
+}
+/**
+ * Validate a tenant ID by attempting token acquisition against it.
+ * Also tries to resolve the tenant display name via the OpenID configuration.
+ */
+export async function validateTenant(appId, appPassword, tenantId) {
+    // First validate credentials work with this tenant
+    const credResult = await validateBotCredentials(appId, appPassword, tenantId);
+    if (!credResult.ok) {
+        return { ok: false, error: `Tenant validation failed: ${credResult.error}` };
+    }
+    // Try to get tenant display name via OpenID config
+    let tenantName;
+    try {
+        const oidcRes = await fetch(`https://login.microsoftonline.com/${tenantId}/v2.0/.well-known/openid-configuration`);
+        if (oidcRes.ok) {
+            const oidc = (await oidcRes.json());
+            // The issuer URL contains the tenant ID, confirming it's valid
+            if (oidc.issuer?.includes(tenantId)) {
+                tenantName = tenantId; // Display the GUID; tenant name requires Graph access
+            }
+        }
+    }
+    catch {
+        // Non-critical — we already validated the credentials
+    }
+    return { ok: true, tenantName };
+}
+/**
+ * Discover Teams and channels the bot has access to via Microsoft Graph API.
+ * Requires the bot's app registration to have Team.ReadBasic.All or similar permissions.
+ * Returns an empty array if Graph permissions aren't configured (graceful fallback).
+ */
+export async function discoverTeamsAndChannels(appId, appPassword, tenantId) {
+    try {
+        // Get a Graph token
+        const tokenRes = await fetch(`https://login.microsoftonline.com/${tenantId}/oauth2/v2.0/token`, {
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: new URLSearchParams({
+                grant_type: "client_credentials",
+                client_id: appId,
+                client_secret: appPassword,
+                scope: "https://graph.microsoft.com/.default",
+            }).toString(),
+        });
+        if (!tokenRes.ok) {
+            return { ok: false, error: "Could not acquire Graph API token. Auto-discovery requires Graph permissions." };
+        }
+        const tokenData = (await tokenRes.json());
+        const token = tokenData.access_token;
+        // List teams (requires Team.ReadBasic.All or TeamSettings.Read.All)
+        const teamsRes = await fetch("https://graph.microsoft.com/v1.0/groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team')&$select=id,displayName&$top=50", {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!teamsRes.ok) {
+            if (teamsRes.status === 403) {
+                return { ok: false, error: "Graph API permissions not configured. Add Team.ReadBasic.All to your app registration for auto-discovery." };
+            }
+            return { ok: false, error: `Graph API error (${teamsRes.status})` };
+        }
+        const teamsData = (await teamsRes.json());
+        const teams = [];
+        for (const team of (teamsData.value ?? []).slice(0, 10)) {
+            // Get channels for each team
+            try {
+                const channelsRes = await fetch(`https://graph.microsoft.com/v1.0/teams/${team.id}/channels?$select=id,displayName&$top=25`, { headers: { Authorization: `Bearer ${token}` } });
+                const channelsData = channelsRes.ok
+                    ? (await channelsRes.json())
+                    : { value: [] };
+                teams.push({
+                    id: team.id,
+                    name: team.displayName,
+                    channels: channelsData.value.map((c) => ({ id: c.id, name: c.displayName })),
+                });
+            }
+            catch {
+                teams.push({ id: team.id, name: team.displayName, channels: [] });
+            }
+        }
+        return { ok: true, teams };
+    }
+    catch (err) {
+        return { ok: false, error: `Discovery failed: ${err.message}` };
+    }
+}
+/**
+ * Parse a Teams channel link to extract team and channel IDs.
+ * Teams links look like:
+ *   https://teams.microsoft.com/l/channel/19%3A...%40thread.tacv2/General?groupId=<teamId>&tenantId=<tenantId>
+ *   https://teams.cloud.microsoft/l/channel/19%3A...%40thread.tacv2/General?groupId=<teamId>&tenantId=<tenantId>
+ */
+export function parseTeamsLink(url) {
+    try {
+        const parsed = new URL(url);
+        const groupId = parsed.searchParams.get("groupId") ?? undefined;
+        const tenantId = parsed.searchParams.get("tenantId") ?? undefined;
+        // Channel ID is in the path: /l/channel/<encodedChannelId>/...
+        let channelId;
+        const pathMatch = parsed.pathname.match(/\/l\/channel\/([^/]+)/);
+        if (pathMatch) {
+            channelId = decodeURIComponent(pathMatch[1]);
+        }
+        return { teamId: groupId, channelId, tenantId };
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@hahnfeld/teams-adapter",
+  "version": "1.0.9",
+  "description": "Teams adapter plugin for OpenACP — Adaptive Cards, commands, streaming",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "keywords": ["openacp", "openacp-plugin", "teams", "adapter", "microsoft-teams"],
+  "engines": {
+    "node": ">=20",
+    "openacp": ">=2026.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "prepublishOnly": "pnpm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hahnfeld/teams-adapter"
+  },
+  "homepage": "https://github.com/hahnfeld/teams-adapter",
+  "author": "Matt Hahnfeld",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@openacp/cli": ">=2026.0.0",
+    "@openacp/plugin-sdk": ">=2026.0.0"
+  },
+  "dependencies": {
+    "@microsoft/agents-hosting": "^1.4.0",
+    "@microsoft/teams.api": "^2.0.0",
+    "@microsoft/teams.apps": "^2.0.0",
+    "@microsoft/teams.botbuilder": "^2.0.0",
+    "botbuilder": "^4.23.0",
+    "botframework-connector": "^4.23.0",
+    "nanoid": "^5.0.0"
+  },
+  "devDependencies": {
+    "@openacp/plugin-sdk": "^2026.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0"
+  },
+  "files": ["dist"],
+  "packageManager": "pnpm@10.5.0",
+  "license": "MIT"
+}