msteams-mcp 0.2.1

package/dist/types/errors.js

@@ -0,0 +1,132 @@
+/**
+ * Error taxonomy for MCP operations.
+ *
+ * Provides machine-readable error codes that help LLMs
+ * understand failures and take appropriate action.
+ */
+/** Enumeration of all error types in the system. */
+export var ErrorCode;
+(function (ErrorCode) {
+    /** No valid authentication token or session. */
+    ErrorCode["AUTH_REQUIRED"] = "AUTH_REQUIRED";
+    /** Token has expired and needs refresh. */
+    ErrorCode["AUTH_EXPIRED"] = "AUTH_EXPIRED";
+    /** Rate limited by the API. */
+    ErrorCode["RATE_LIMITED"] = "RATE_LIMITED";
+    /** Requested resource was not found. */
+    ErrorCode["NOT_FOUND"] = "NOT_FOUND";
+    /** Invalid input parameters. */
+    ErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    /** API returned an error response. */
+    ErrorCode["API_ERROR"] = "API_ERROR";
+    /** Browser automation failed. */
+    ErrorCode["BROWSER_ERROR"] = "BROWSER_ERROR";
+    /** Network or connection error. */
+    ErrorCode["NETWORK_ERROR"] = "NETWORK_ERROR";
+    /** Operation timed out. */
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    /** Unknown or unexpected error. */
+    ErrorCode["UNKNOWN"] = "UNKNOWN";
+})(ErrorCode || (ErrorCode = {}));
+/**
+ * Creates a standardised MCP error.
+ */
+export function createError(code, message, options = {}) {
+    const defaultSuggestions = getDefaultSuggestions(code);
+    return {
+        code,
+        message,
+        retryable: options.retryable ?? isRetryableByDefault(code),
+        retryAfterMs: options.retryAfterMs,
+        suggestions: options.suggestions ?? defaultSuggestions,
+    };
+}
+/**
+ * Returns default suggestions for each error code.
+ */
+function getDefaultSuggestions(code) {
+    switch (code) {
+        case ErrorCode.AUTH_REQUIRED:
+            return ['Call teams_login to authenticate'];
+        case ErrorCode.AUTH_EXPIRED:
+            return ['Call teams_login to refresh authentication'];
+        case ErrorCode.RATE_LIMITED:
+            return ['Wait before retrying', 'Reduce request frequency'];
+        case ErrorCode.NOT_FOUND:
+            return ['Check the ID/query is correct', 'Verify the resource exists'];
+        case ErrorCode.INVALID_INPUT:
+            return ['Check the input parameters', 'Review the tool documentation'];
+        case ErrorCode.API_ERROR:
+            return ['Retry the request', 'Check teams_status for system health'];
+        case ErrorCode.BROWSER_ERROR:
+            return ['Call teams_login to restart browser session'];
+        case ErrorCode.NETWORK_ERROR:
+            return ['Check network connectivity', 'Retry the request'];
+        case ErrorCode.TIMEOUT:
+            return ['Retry the request', 'Use smaller page sizes'];
+        case ErrorCode.UNKNOWN:
+            return ['Check teams_status', 'Try teams_login if authentication issues'];
+    }
+}
+/**
+ * Determines if an error code is retryable by default.
+ */
+function isRetryableByDefault(code) {
+    switch (code) {
+        case ErrorCode.RATE_LIMITED:
+        case ErrorCode.NETWORK_ERROR:
+        case ErrorCode.TIMEOUT:
+        case ErrorCode.API_ERROR:
+            return true;
+        default:
+            return false;
+    }
+}
+/**
+ * Classifies an HTTP status code into an error code.
+ */
+export function classifyHttpError(status, message) {
+    switch (status) {
+        case 401:
+            return ErrorCode.AUTH_EXPIRED;
+        case 403:
+            return ErrorCode.AUTH_REQUIRED;
+        case 404:
+            return ErrorCode.NOT_FOUND;
+        case 429:
+            return ErrorCode.RATE_LIMITED;
+        case 400:
+        case 422:
+            return ErrorCode.INVALID_INPUT;
+        default:
+            if (status >= 500)
+                return ErrorCode.API_ERROR;
+            if (message?.includes('timeout'))
+                return ErrorCode.TIMEOUT;
+            if (message?.includes('network') || message?.includes('ECONNRESET')) {
+                return ErrorCode.NETWORK_ERROR;
+            }
+            return ErrorCode.UNKNOWN;
+    }
+}
+/**
+ * Extracts retry-after value from response headers.
+ */
+export function extractRetryAfter(headers) {
+    const retryAfter = headers.get('Retry-After');
+    if (!retryAfter)
+        return undefined;
+    // Could be seconds (number) or HTTP date
+    const seconds = parseInt(retryAfter, 10);
+    if (!isNaN(seconds)) {
+        return seconds * 1000;
+    }
+    // Try parsing as HTTP date
+    try {
+        const date = new Date(retryAfter);
+        return Math.max(0, date.getTime() - Date.now());
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/types/result.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Result type for operations that can fail.
+ *
+ * Provides a discriminated union for success/failure that
+ * forces callers to handle errors explicitly.
+ */
+import type { McpError } from './errors.js';
+/** Successful result with a value. */
+export interface Ok<T> {
+    ok: true;
+    value: T;
+}
+/** Failed result with an error. */
+export interface Err<E = McpError> {
+    ok: false;
+    error: E;
+}
+/** A result that can be either a success or failure. */
+export type Result<T, E = McpError> = Ok<T> | Err<E>;
+/**
+ * Creates a successful result.
+ */
+export declare function ok<T>(value: T): Ok<T>;
+/**
+ * Creates a failed result.
+ */
+export declare function err<E = McpError>(error: E): Err<E>;
+/**
+ * Unwraps a result, throwing if it's an error.
+ */
+export declare function unwrap<T>(result: Result<T>): T;
+/**
+ * Unwraps a result with a default value for errors.
+ */
+export declare function unwrapOr<T>(result: Result<T>, defaultValue: T): T;
+/**
+ * Maps a successful result to a new value.
+ */
+export declare function map<T, U>(result: Result<T>, fn: (value: T) => U): Result<U>;
+/**
+ * Maps a successful result to a new result (flatMap).
+ */
+export declare function andThen<T, U>(result: Result<T>, fn: (value: T) => Result<U>): Result<U>;

package/dist/types/result.js

@@ -0,0 +1,51 @@
+/**
+ * Result type for operations that can fail.
+ *
+ * Provides a discriminated union for success/failure that
+ * forces callers to handle errors explicitly.
+ */
+/**
+ * Creates a successful result.
+ */
+export function ok(value) {
+    return { ok: true, value };
+}
+/**
+ * Creates a failed result.
+ */
+export function err(error) {
+    return { ok: false, error };
+}
+/**
+ * Unwraps a result, throwing if it's an error.
+ */
+export function unwrap(result) {
+    if (result.ok) {
+        return result.value;
+    }
+    throw new Error(result.error.message);
+}
+/**
+ * Unwraps a result with a default value for errors.
+ */
+export function unwrapOr(result, defaultValue) {
+    return result.ok ? result.value : defaultValue;
+}
+/**
+ * Maps a successful result to a new value.
+ */
+export function map(result, fn) {
+    if (result.ok) {
+        return ok(fn(result.value));
+    }
+    return result;
+}
+/**
+ * Maps a successful result to a new result (flatMap).
+ */
+export function andThen(result, fn) {
+    if (result.ok) {
+        return fn(result.value);
+    }
+    return result;
+}

package/dist/types/server.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Server interface types.
+ *
+ * Extracted to a shared module to avoid circular dependencies between
+ * server.ts and tools/index.ts.
+ */
+import type { BrowserManager } from '../browser/context.js';
+/**
+ * Interface for the TeamsServer class.
+ *
+ * This interface is used by tool handlers to interact with the server
+ * without creating circular dependencies.
+ */
+export interface TeamsServer {
+    /** Ensures a browser is running and authenticated. */
+    ensureBrowser(headless?: boolean): Promise<BrowserManager>;
+    /** Resets browser state (clears manager and initialisation flag). */
+    resetBrowserState(): void;
+    /** Gets the current browser manager, if any. */
+    getBrowserManager(): BrowserManager | null;
+    /** Sets the browser manager. */
+    setBrowserManager(manager: BrowserManager): void;
+    /** Marks the server as initialised. */
+    markInitialised(): void;
+    /** Checks if the server is initialised. */
+    isInitialisedState(): boolean;
+}

package/dist/types/server.js

@@ -0,0 +1,7 @@
+/**
+ * Server interface types.
+ *
+ * Extracted to a shared module to avoid circular dependencies between
+ * server.ts and tools/index.ts.
+ */
+export {};

package/dist/types/teams.d.ts

@@ -0,0 +1,85 @@
+/**
+ * TypeScript interfaces for Teams data structures.
+ */
+/** A link extracted from message content. */
+export interface ExtractedLink {
+    url: string;
+    text: string;
+}
+export interface TeamsSearchResult {
+    id: string;
+    type: 'message' | 'file' | 'person';
+    content: string;
+    sender?: string;
+    timestamp?: string;
+    channelName?: string;
+    teamName?: string;
+    conversationId?: string;
+    messageId?: string;
+    /** Direct link to open this message in Teams */
+    messageLink?: string;
+    /** Links extracted from message content */
+    links?: ExtractedLink[];
+}
+export interface TeamsMessage {
+    id: string;
+    content: string;
+    sender: string;
+    timestamp: string;
+    channelName?: string;
+    teamName?: string;
+    replyCount?: number;
+    reactions?: TeamsReaction[];
+}
+export interface TeamsReaction {
+    type: string;
+    count: number;
+}
+export interface InterceptedRequest {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    postData?: string;
+    timestamp: Date;
+}
+export interface InterceptedResponse {
+    url: string;
+    status: number;
+    headers: Record<string, string>;
+    body?: string;
+    timestamp: Date;
+}
+export interface SearchApiEndpoint {
+    url: string;
+    method: string;
+    description: string;
+    requestFormat?: unknown;
+    responseFormat?: unknown;
+}
+/** Pagination options for search requests. */
+export interface SearchPaginationOptions {
+    /** Starting offset (0-based). Default: 0 */
+    from?: number;
+    /** Page size. Default: 25 */
+    size?: number;
+    /** Maximum total results to fetch across all pages. */
+    maxResults?: number;
+}
+/** Pagination metadata returned with search results. */
+export interface SearchPaginationResult {
+    /** Number of results returned in this response. */
+    returned: number;
+    /** Starting offset used for this request. */
+    from: number;
+    /** Page size requested. */
+    size: number;
+    /** Total results available (if known). */
+    total?: number;
+    /** Whether more results are available. */
+    hasMore: boolean;
+}
+/** Search results with pagination metadata. */
+export interface TeamsSearchResultsWithPagination {
+    results: TeamsSearchResult[];
+    pagination: SearchPaginationResult;
+}

package/dist/types/teams.js

@@ -0,0 +1,4 @@
+/**
+ * TypeScript interfaces for Teams data structures.
+ */
+export {};

package/dist/utils/api-config.d.ts

@@ -0,0 +1,103 @@
+/**
+ * API endpoint configuration and header utilities.
+ *
+ * Centralises all API URLs and common request headers.
+ *
+ * Region and base URLs are extracted from the user's session via DISCOVER-REGION-GTM,
+ * supporting different Teams environments (commercial, GCC, GCC-High, etc.).
+ */
+/** Default Teams base URL (commercial cloud). */
+export declare const DEFAULT_TEAMS_BASE_URL = "https://teams.microsoft.com";
+/** Default Substrate base URL (commercial cloud). */
+export declare const DEFAULT_SUBSTRATE_BASE_URL = "https://substrate.office.com";
+/**
+ * Substrate API endpoints.
+ *
+ * Note: Substrate URLs may differ for GCC/GCC-High tenants. The base URL is
+ * hardcoded to substrate.office.com as we haven't found a config source for it.
+ * If issues are reported from government cloud users, we may need to add config.
+ */
+export declare const SUBSTRATE_API: {
+    /** Full-text message search. */
+    readonly search: "https://substrate.office.com/searchservice/api/v2/query";
+    /** People and message typeahead suggestions. */
+    readonly suggestions: "https://substrate.office.com/search/api/v1/suggestions";
+    /** Frequent contacts list. */
+    readonly frequentContacts: "https://substrate.office.com/search/api/v1/suggestions?scenario=peoplecache";
+    /** People search. */
+    readonly peopleSearch: "https://substrate.office.com/search/api/v1/suggestions?scenario=powerbar";
+    /** Channel search (org-wide, not just user's teams). */
+    readonly channelSearch: "https://substrate.office.com/search/api/v1/suggestions?scenario=powerbar&setflight=TurnOffMPLSuppressionTeams,EnableTeamsChannelDomainPowerbar&domain=TeamsChannel";
+};
+/**
+ * Chat service API endpoint builders.
+ *
+ * All functions accept an optional `baseUrl` parameter to support different
+ * Teams environments. If not provided, uses DEFAULT_TEAMS_BASE_URL.
+ */
+export declare const CHATSVC_API: {
+    /**
+     * Get messages URL for a conversation.
+     *
+     * For thread replies in channels, provide replyToMessageId to append
+     * `;messageid={id}` to the conversation path. This tells Teams the message
+     * is a reply to an existing thread rather than a new top-level post.
+     */
+    readonly messages: (region: string, conversationId: string, replyToMessageId?: string, baseUrl?: string) => string;
+    /** Get conversation metadata URL. */
+    readonly conversation: (region: string, conversationId: string, baseUrl?: string) => string;
+    /** Save/unsave message metadata URL. */
+    readonly messageMetadata: (region: string, conversationId: string, messageId: string, baseUrl?: string) => string;
+    /** Edit a specific message URL. */
+    readonly editMessage: (region: string, conversationId: string, messageId: string, baseUrl?: string) => string;
+    /** Delete a specific message URL (soft delete). */
+    readonly deleteMessage: (region: string, conversationId: string, messageId: string, baseUrl?: string) => string;
+    /** Get consumption horizons (read receipts) for a thread. */
+    readonly consumptionHorizons: (region: string, threadId: string, baseUrl?: string) => string;
+    /** Update consumption horizon (mark as read) for a conversation. */
+    readonly updateConsumptionHorizon: (region: string, conversationId: string, baseUrl?: string) => string;
+    /** Activity feed (notifications) messages. */
+    readonly activityFeed: (region: string, baseUrl?: string) => string;
+    /** Message emotions (reactions) URL. */
+    readonly messageEmotions: (region: string, conversationId: string, messageId: string, baseUrl?: string) => string;
+    /** Create a new thread (group chat). */
+    readonly createThread: (region: string, baseUrl?: string) => string;
+};
+/**
+ * Calendar/Meeting API endpoints.
+ *
+ * The mt/part endpoints use partitioned regions (e.g., amer-02, emea-03).
+ * Some tenants use non-partitioned URLs (e.g., /api/mt/emea).
+ * The correct format is extracted from the user's session via DISCOVER-REGION-GTM.
+ */
+export declare const CALENDAR_API: {
+    /**
+     * Get calendar view (meetings) for a date range.
+     *
+     * Uses OData-style query parameters for filtering and pagination.
+     *
+     * @param regionPartition - The full region-partition (e.g., "amer-02") or just region (e.g., "emea")
+     * @param hasPartition - Whether the tenant uses partitioned URLs
+     * @param baseUrl - Teams base URL (from config or default)
+     */
+    readonly calendarView: (regionPartition: string, hasPartition: boolean, baseUrl?: string) => string;
+};
+/** CSA (Chat Service Aggregator) API endpoints. */
+export declare const CSA_API: {
+    /** Conversation folders (favourites) URL. */
+    readonly conversationFolders: (region: string, baseUrl?: string) => string;
+    /** Teams list (all teams/channels user is a member of). */
+    readonly teamsList: (region: string, baseUrl?: string) => string;
+    /** Custom emoji metadata. */
+    readonly customEmojis: (region: string, baseUrl?: string) => string;
+};
+/** Common request headers for Teams API calls. */
+export declare function getTeamsHeaders(baseUrl?: string): HeadersInit;
+/** Headers for Bearer token authentication. */
+export declare function getBearerHeaders(token: string, baseUrl?: string): HeadersInit;
+/** Headers for Skype token + Bearer authentication. */
+export declare function getSkypeAuthHeaders(skypeToken: string, authToken: string, baseUrl?: string): HeadersInit;
+/** Headers for CSA API (Skype token + CSA Bearer). */
+export declare function getCsaHeaders(skypeToken: string, csaToken: string, baseUrl?: string): HeadersInit;
+/** Client version header for messaging API. */
+export declare function getMessagingHeaders(skypeToken: string, authToken: string, baseUrl?: string): HeadersInit;

package/dist/utils/api-config.js

@@ -0,0 +1,158 @@
+/**
+ * API endpoint configuration and header utilities.
+ *
+ * Centralises all API URLs and common request headers.
+ *
+ * Region and base URLs are extracted from the user's session via DISCOVER-REGION-GTM,
+ * supporting different Teams environments (commercial, GCC, GCC-High, etc.).
+ */
+import { NOTIFICATIONS_ID } from '../constants.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Default URLs (fallbacks when session config unavailable)
+// ─────────────────────────────────────────────────────────────────────────────
+/** Default Teams base URL (commercial cloud). */
+export const DEFAULT_TEAMS_BASE_URL = 'https://teams.microsoft.com';
+/** Default Substrate base URL (commercial cloud). */
+export const DEFAULT_SUBSTRATE_BASE_URL = 'https://substrate.office.com';
+// ─────────────────────────────────────────────────────────────────────────────
+// Substrate API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Substrate API endpoints.
+ *
+ * Note: Substrate URLs may differ for GCC/GCC-High tenants. The base URL is
+ * hardcoded to substrate.office.com as we haven't found a config source for it.
+ * If issues are reported from government cloud users, we may need to add config.
+ */
+export const SUBSTRATE_API = {
+    /** Full-text message search. */
+    search: `${DEFAULT_SUBSTRATE_BASE_URL}/searchservice/api/v2/query`,
+    /** People and message typeahead suggestions. */
+    suggestions: `${DEFAULT_SUBSTRATE_BASE_URL}/search/api/v1/suggestions`,
+    /** Frequent contacts list. */
+    frequentContacts: `${DEFAULT_SUBSTRATE_BASE_URL}/search/api/v1/suggestions?scenario=peoplecache`,
+    /** People search. */
+    peopleSearch: `${DEFAULT_SUBSTRATE_BASE_URL}/search/api/v1/suggestions?scenario=powerbar`,
+    /** Channel search (org-wide, not just user's teams). */
+    channelSearch: `${DEFAULT_SUBSTRATE_BASE_URL}/search/api/v1/suggestions?scenario=powerbar&setflight=TurnOffMPLSuppressionTeams,EnableTeamsChannelDomainPowerbar&domain=TeamsChannel`,
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Chatsvc API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Chat service API endpoint builders.
+ *
+ * All functions accept an optional `baseUrl` parameter to support different
+ * Teams environments. If not provided, uses DEFAULT_TEAMS_BASE_URL.
+ */
+export const CHATSVC_API = {
+    /**
+     * Get messages URL for a conversation.
+     *
+     * For thread replies in channels, provide replyToMessageId to append
+     * `;messageid={id}` to the conversation path. This tells Teams the message
+     * is a reply to an existing thread rather than a new top-level post.
+     */
+    messages: (region, conversationId, replyToMessageId, baseUrl = DEFAULT_TEAMS_BASE_URL) => {
+        const conversationPath = replyToMessageId
+            ? `${conversationId};messageid=${replyToMessageId}`
+            : conversationId;
+        return `${baseUrl}/api/chatsvc/${region}/v1/users/ME/conversations/${encodeURIComponent(conversationPath)}/messages`;
+    },
+    /** Get conversation metadata URL. */
+    conversation: (region, conversationId, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/chatsvc/${region}/v1/users/ME/conversations/${encodeURIComponent(conversationId)}`,
+    /** Save/unsave message metadata URL. */
+    messageMetadata: (region, conversationId, messageId, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/chatsvc/${region}/v1/users/ME/conversations/${encodeURIComponent(conversationId)}/rcmetadata/${messageId}`,
+    /** Edit a specific message URL. */
+    editMessage: (region, conversationId, messageId, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/chatsvc/${region}/v1/users/ME/conversations/${encodeURIComponent(conversationId)}/messages/${messageId}`,
+    /** Delete a specific message URL (soft delete). */
+    deleteMessage: (region, conversationId, messageId, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/chatsvc/${region}/v1/users/ME/conversations/${encodeURIComponent(conversationId)}/messages/${messageId}?behavior=softDelete`,
+    /** Get consumption horizons (read receipts) for a thread. */
+    consumptionHorizons: (region, threadId, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/chatsvc/${region}/v1/threads/${encodeURIComponent(threadId)}/consumptionhorizons`,
+    /** Update consumption horizon (mark as read) for a conversation. */
+    updateConsumptionHorizon: (region, conversationId, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/chatsvc/${region}/v1/users/ME/conversations/${encodeURIComponent(conversationId)}/properties?name=consumptionhorizon`,
+    /** Activity feed (notifications) messages. */
+    activityFeed: (region, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/chatsvc/${region}/v1/users/ME/conversations/${encodeURIComponent(NOTIFICATIONS_ID)}/messages`,
+    /** Message emotions (reactions) URL. */
+    messageEmotions: (region, conversationId, messageId, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/chatsvc/${region}/v1/users/ME/conversations/${encodeURIComponent(conversationId)}/messages/${messageId}/properties?name=emotions`,
+    /** Create a new thread (group chat). */
+    createThread: (region, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/chatsvc/${region}/v1/threads`,
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Calendar API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Calendar/Meeting API endpoints.
+ *
+ * The mt/part endpoints use partitioned regions (e.g., amer-02, emea-03).
+ * Some tenants use non-partitioned URLs (e.g., /api/mt/emea).
+ * The correct format is extracted from the user's session via DISCOVER-REGION-GTM.
+ */
+export const CALENDAR_API = {
+    /**
+     * Get calendar view (meetings) for a date range.
+     *
+     * Uses OData-style query parameters for filtering and pagination.
+     *
+     * @param regionPartition - The full region-partition (e.g., "amer-02") or just region (e.g., "emea")
+     * @param hasPartition - Whether the tenant uses partitioned URLs
+     * @param baseUrl - Teams base URL (from config or default)
+     */
+    calendarView: (regionPartition, hasPartition, baseUrl = DEFAULT_TEAMS_BASE_URL) => hasPartition
+        ? `${baseUrl}/api/mt/part/${regionPartition}/v2.1/me/calendars/calendarView`
+        : `${baseUrl}/api/mt/${regionPartition}/v2.1/me/calendars/calendarView`,
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// CSA API
+// ─────────────────────────────────────────────────────────────────────────────
+/** CSA (Chat Service Aggregator) API endpoints. */
+export const CSA_API = {
+    /** Conversation folders (favourites) URL. */
+    conversationFolders: (region, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/csa/${region}/api/v1/teams/users/me/conversationFolders?supportsAdditionalSystemGeneratedFolders=true&supportsSliceItems=true`,
+    /** Teams list (all teams/channels user is a member of). */
+    teamsList: (region, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/csa/${region}/api/v3/teams/users/me?isPrefetch=false&enableMembershipSummary=true`,
+    /** Custom emoji metadata. */
+    customEmojis: (region, baseUrl = DEFAULT_TEAMS_BASE_URL) => `${baseUrl}/api/csa/${region}/api/v1/customemoji/metadata`,
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Request Headers
+// ─────────────────────────────────────────────────────────────────────────────
+/** Common request headers for Teams API calls. */
+export function getTeamsHeaders(baseUrl = DEFAULT_TEAMS_BASE_URL) {
+    return {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json',
+        'Origin': baseUrl,
+        'Referer': `${baseUrl}/`,
+    };
+}
+/** Headers for Bearer token authentication. */
+export function getBearerHeaders(token, baseUrl = DEFAULT_TEAMS_BASE_URL) {
+    return {
+        ...getTeamsHeaders(baseUrl),
+        'Authorization': `Bearer ${token}`,
+    };
+}
+/** Headers for Skype token + Bearer authentication. */
+export function getSkypeAuthHeaders(skypeToken, authToken, baseUrl = DEFAULT_TEAMS_BASE_URL) {
+    return {
+        ...getTeamsHeaders(baseUrl),
+        'Authentication': `skypetoken=${skypeToken}`,
+        'Authorization': `Bearer ${authToken}`,
+    };
+}
+/** Headers for CSA API (Skype token + CSA Bearer). */
+export function getCsaHeaders(skypeToken, csaToken, baseUrl = DEFAULT_TEAMS_BASE_URL) {
+    return {
+        ...getTeamsHeaders(baseUrl),
+        'Authentication': `skypetoken=${skypeToken}`,
+        'Authorization': `Bearer ${csaToken}`,
+    };
+}
+/** Client version header for messaging API. */
+export function getMessagingHeaders(skypeToken, authToken, baseUrl = DEFAULT_TEAMS_BASE_URL) {
+    return {
+        ...getSkypeAuthHeaders(skypeToken, authToken, baseUrl),
+        'X-Ms-Client-Version': '1415/1.0.0.2025010401',
+    };
+}