@gakr-gakr/msteams 0.1.0

package/src/user-agent.ts

@@ -0,0 +1,53 @@
+import { createRequire } from "node:module";
+import { getMSTeamsRuntime } from "./runtime.js";
+
+let cachedUserAgent: string | undefined;
+
+function resolveTeamsSdkVersion(): string {
+  try {
+    const require = createRequire(import.meta.url);
+    const pkg = require("@microsoft/teams.apps/package.json") as { version?: string };
+    return pkg.version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+function resolveAutoBotVersion(): string {
+  try {
+    return getMSTeamsRuntime().version;
+  } catch {
+    return "unknown";
+  }
+}
+
+/**
+ * Build a combined User-Agent string that preserves the Teams SDK identity
+ * and appends the AutoBot version.
+ *
+ * Format: "teams.ts[apps]/<sdk-version> AutoBot/<autobot-version>"
+ * Example: "teams.ts[apps]/2.0.5 AutoBot/2026.3.22"
+ *
+ * This lets the Teams backend track SDK usage while also identifying the
+ * host application.
+ */
+/** Reset the cached User-Agent (for testing). */
+export function resetUserAgentCache(): void {
+  cachedUserAgent = undefined;
+}
+
+export function buildUserAgent(): string {
+  if (cachedUserAgent) {
+    return cachedUserAgent;
+  }
+  cachedUserAgent = `teams.ts[apps]/${resolveTeamsSdkVersion()} AutoBot/${resolveAutoBotVersion()}`;
+  return cachedUserAgent;
+}
+
+export function ensureUserAgentHeader(headers?: HeadersInit): Headers {
+  const nextHeaders = new Headers(headers);
+  if (!nextHeaders.has("User-Agent")) {
+    nextHeaders.set("User-Agent", buildUserAgent());
+  }
+  return nextHeaders;
+}

package/src/webhook-timeouts.ts

@@ -0,0 +1,27 @@
+import type { Server } from "node:http";
+
+const MSTEAMS_WEBHOOK_INACTIVITY_TIMEOUT_MS = 30_000;
+const MSTEAMS_WEBHOOK_REQUEST_TIMEOUT_MS = 30_000;
+const MSTEAMS_WEBHOOK_HEADERS_TIMEOUT_MS = 15_000;
+
+type ApplyMSTeamsWebhookTimeoutsOpts = {
+  inactivityTimeoutMs?: number;
+  requestTimeoutMs?: number;
+  headersTimeoutMs?: number;
+};
+
+export function applyMSTeamsWebhookTimeouts(
+  httpServer: Server,
+  opts?: ApplyMSTeamsWebhookTimeoutsOpts,
+): void {
+  const inactivityTimeoutMs = opts?.inactivityTimeoutMs ?? MSTEAMS_WEBHOOK_INACTIVITY_TIMEOUT_MS;
+  const requestTimeoutMs = opts?.requestTimeoutMs ?? MSTEAMS_WEBHOOK_REQUEST_TIMEOUT_MS;
+  const headersTimeoutMs = Math.min(
+    opts?.headersTimeoutMs ?? MSTEAMS_WEBHOOK_HEADERS_TIMEOUT_MS,
+    requestTimeoutMs,
+  );
+
+  httpServer.setTimeout(inactivityTimeoutMs);
+  httpServer.requestTimeout = requestTimeoutMs;
+  httpServer.headersTimeout = headersTimeoutMs;
+}

package/src/welcome-card.ts

@@ -0,0 +1,57 @@
+/**
+ * Builds an Adaptive Card for welcoming users when the bot is added to a conversation.
+ */
+
+const DEFAULT_PROMPT_STARTERS = [
+  "What can you do?",
+  "Summarize my last meeting",
+  "Help me draft an email",
+];
+
+type WelcomeCardOptions = {
+  /** Bot display name. Falls back to "AutoBot". */
+  botName?: string;
+  /** Custom prompt starters. Falls back to defaults. */
+  promptStarters?: string[];
+};
+
+/**
+ * Build a welcome Adaptive Card for 1:1 personal chats.
+ */
+export function buildWelcomeCard(options?: WelcomeCardOptions): Record<string, unknown> {
+  const botName = options?.botName || "AutoBot";
+  const starters = options?.promptStarters?.length
+    ? options.promptStarters
+    : DEFAULT_PROMPT_STARTERS;
+
+  return {
+    type: "AdaptiveCard",
+    version: "1.5",
+    body: [
+      {
+        type: "TextBlock",
+        text: `Hi! I'm ${botName}.`,
+        weight: "bolder",
+        size: "medium",
+      },
+      {
+        type: "TextBlock",
+        text: "I can help you with questions, tasks, and more. Here are some things to try:",
+        wrap: true,
+      },
+    ],
+    actions: starters.map((label) => ({
+      type: "Action.Submit",
+      title: label,
+      data: { msteams: { type: "imBack", value: label } },
+    })),
+  };
+}
+
+/**
+ * Build a brief welcome message for group chats (when the bot is @mentioned).
+ */
+export function buildGroupWelcomeText(botName?: string): string {
+  const name = botName || "AutoBot";
+  return `Hi! I'm ${name}. Mention me with @${name} to get started.`;
+}

package/test-api.ts

@@ -0,0 +1 @@
+export { msteamsPlugin } from "./src/channel.js";

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "extends": "../tsconfig.package-boundary.base.json",
+  "compilerOptions": {
+    "rootDir": "."
+  },
+  "include": ["./*.ts", "./src/**/*.ts"],
+  "exclude": [
+    "./**/*.test.ts",
+    "./dist/**",
+    "./node_modules/**",
+    "./src/test-support/**",
+    "./src/**/*test-helpers.ts",
+    "./src/**/*test-harness.ts",
+    "./src/**/*test-support.ts"
+  ]
+}