teams-api 0.5.2 → 0.6.0

package/dist/{actions.d.ts → actions/formatters.d.ts}

@@ -1,16 +1,10 @@
 /**
- * Unified action definitions for the Teams API.
+ * Shared formatting utilities for action output.
  *
- * This is the single source of truth for all operations. CLI commands,
- * MCP tools, and programmatic usage all derive from these definitions.
- *
- * Each action declares:
- *   - name, title, description — shared help text and documentation
- *   - parameters — typed parameter definitions with descriptions and defaults
- *   - execute — the implementation, calling TeamsClient methods
- *   - formatResult — human-readable output formatter (CLI without --json)
+ * Contains HTML cleaning, quote extraction, message formatting helpers,
+ * transcript grouping, and output format dispatch.
  */
-import type { TeamsClient } from "./teams-client.js";
+import type { Message, TranscriptEntry } from "../types.js";
 export interface ActionParameter {
     /** Parameter name in camelCase (CLI flags auto-converted to kebab-case). */
     name: string;
@@ -33,7 +27,7 @@ export interface ActionDefinition {
     /** Typed parameter definitions. */
     parameters: ActionParameter[];
     /** Execute the action against a TeamsClient. */
-    execute: (client: TeamsClient, parameters: Record<string, unknown>) => Promise<unknown>;
+    execute: (client: import("../teams-client.js").TeamsClient, parameters: Record<string, unknown>) => Promise<unknown>;
     /** Format result as human-readable text (CLI output without --json). */
     formatResult: (result: unknown) => string;
     /** Format result as Markdown. */
@@ -45,5 +39,22 @@ export type OutputFormat = "json" | "text" | "md" | "toon";
 export type MessageOrder = "newest-first" | "oldest-first";
 /** Format an action result in the specified output format. */
 export declare function formatOutput(action: ActionDefinition, result: unknown, format?: OutputFormat): string;
-export declare const actions: ActionDefinition[];
-//# sourceMappingURL=actions.d.ts.map
+export declare function toonHeader(emoji: string, text: string): string;
+/** Strip HTML tags and decode entities from message content. */
+export declare function cleanContent(content: string): string;
+/** Extract quoted text from HTML blockquotes, returning quote and body separately. */
+export declare function extractQuote(content: string): {
+    quote: string | null;
+    body: string;
+};
+/** Build a map from message ID to sender display name. */
+export declare function buildSenderLookup(messages: Message[]): Map<string, string>;
+/** Format a VTT timestamp (HH:MM:SS.mmm) as a compact time string. */
+export declare function formatTimestamp(timestamp: string): string;
+/** Group consecutive entries by the same speaker for more readable output. */
+export declare function groupBySpeaker(entries: TranscriptEntry[]): Array<{
+    speaker: string;
+    startTime: string;
+    segments: string[];
+}>;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/actions/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/actions/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAK5D,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,gDAAgD;IAChD,OAAO,EAAE,CACP,MAAM,EAAE,OAAO,oBAAoB,EAAE,WAAW,EAChD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtB,wEAAwE;IACxE,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IAC1C,iCAAiC;IACjC,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;IAC5C,kDAAkD;IAClD,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;CACzC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,cAAc,CAAC;AAI3D,8DAA8D;AAC9D,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,OAAO,EACf,MAAM,GAAE,YAAqB,GAC5B,MAAM,CAWR;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,CAWA;AAED,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAM1E;AAID,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,eAAe,EAAE,GACzB,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqBnE"}

package/dist/actions/formatters.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Shared formatting utilities for action output.
+ *
+ * Contains HTML cleaning, quote extraction, message formatting helpers,
+ * transcript grouping, and output format dispatch.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatOutput = formatOutput;
+exports.toonHeader = toonHeader;
+exports.cleanContent = cleanContent;
+exports.extractQuote = extractQuote;
+exports.buildSenderLookup = buildSenderLookup;
+exports.formatTimestamp = formatTimestamp;
+exports.groupBySpeaker = groupBySpeaker;
+const html_utils_js_1 = require("../html-utils.js");
+// ── Output format dispatch ───────────────────────────────────────────
+/** Format an action result in the specified output format. */
+function formatOutput(action, result, format = "json") {
+    switch (format) {
+        case "json":
+            return JSON.stringify(result, null, 2);
+        case "text":
+            return action.formatResult(result);
+        case "md":
+            return action.formatMarkdown(result);
+        case "toon":
+            return action.formatToon(result);
+    }
+}
+// ── Shared formatting helpers ────────────────────────────────────────
+function toonHeader(emoji, text) {
+    const separator = "─".repeat(40);
+    return `\n  ${emoji} ${text}\n  ${separator}`;
+}
+/** Strip HTML tags and decode entities from message content. */
+function cleanContent(content) {
+    return (0, html_utils_js_1.decodeHtmlEntities)(content.replace(/<[^>]*>/g, "")).trim();
+}
+/** Extract quoted text from HTML blockquotes, returning quote and body separately. */
+function extractQuote(content) {
+    for (const tag of ["blockquote", "quote"]) {
+        const pattern = new RegExp(`<${tag}[^>]*>[\\s\\S]*?<\\/${tag}>`, "i");
+        const match = content.match(pattern);
+        if (match) {
+            const quote = cleanContent(match[0]);
+            const remainder = content.replace(pattern, "");
+            return { quote: quote || null, body: cleanContent(remainder) };
+        }
+    }
+    return { quote: null, body: cleanContent(content) };
+}
+/** Build a map from message ID to sender display name. */
+function buildSenderLookup(messages) {
+    const lookup = new Map();
+    for (const message of messages) {
+        lookup.set(message.id, message.senderDisplayName || "(system)");
+    }
+    return lookup;
+}
+// ── Transcript formatting helpers ────────────────────────────────────
+/** Format a VTT timestamp (HH:MM:SS.mmm) as a compact time string. */
+function formatTimestamp(timestamp) {
+    // Strip leading "00:" hours if zero, and trim milliseconds
+    const withoutMilliseconds = timestamp.replace(/\.\d+$/, "");
+    return withoutMilliseconds.replace(/^00:/, "");
+}
+/** Group consecutive entries by the same speaker for more readable output. */
+function groupBySpeaker(entries) {
+    const groups = [];
+    for (const entry of entries) {
+        const lastGroup = groups[groups.length - 1];
+        if (lastGroup && lastGroup.speaker === entry.speaker) {
+            lastGroup.segments.push(entry.text);
+        }
+        else {
+            groups.push({
+                speaker: entry.speaker,
+                startTime: entry.startTime,
+                segments: [entry.text],
+            });
+        }
+    }
+    return groups;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/actions/formatters.js.map

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

package/dist/api/chat-service.d.ts

@@ -0,0 +1,54 @@
+/**
+ * REST API layer for the Teams Chat Service.
+ *
+ * All HTTP calls to {region}.ng.msg.teams.microsoft.com/v1 are here.
+ * This module is stateless — every function takes a TeamsToken explicitly.
+ */
+import type { TeamsToken, Conversation, Message, MessageFormat, MessagesPage, Member, SentMessage, EditedMessage, DeletedMessage } from "../types.js";
+/**
+ * Fetch conversations from the Teams Chat Service.
+ * Returns one page of conversations (no built-in pagination).
+ */
+export declare function fetchConversations(token: TeamsToken, pageSize: number): Promise<Conversation[]>;
+/**
+ * Fetch one page of messages from a conversation.
+ */
+export declare function fetchMessagesPage(token: TeamsToken, conversationId: string, pageSize: number, backwardLink?: string): Promise<MessagesPage>;
+/**
+ * Fetch members of a conversation.
+ */
+export declare function fetchMembers(token: TeamsToken, conversationId: string): Promise<Member[]>;
+/**
+ * Send a message to a conversation.
+ *
+ * The `format` parameter controls how `content` is interpreted:
+ * - `"text"` — plain text, sent as-is
+ * - `"markdown"` (default) — converted from Markdown to HTML
+ * - `"html"` — raw HTML, sent as-is
+ */
+export declare function postMessage(token: TeamsToken, conversationId: string, content: string, senderDisplayName: string, format?: MessageFormat): Promise<SentMessage>;
+/**
+ * Edit an existing message in a conversation.
+ *
+ * The `format` parameter controls how `content` is interpreted:
+ * - `"text"` — plain text, sent as-is
+ * - `"markdown"` (default) — converted from Markdown to HTML
+ * - `"html"` — raw HTML, sent as-is
+ */
+export declare function editMessage(token: TeamsToken, conversationId: string, messageId: string, content: string, senderDisplayName: string, format?: MessageFormat): Promise<EditedMessage>;
+/**
+ * Delete a message from a conversation.
+ *
+ * Sends a DELETE to the Chat Service; handles empty response body.
+ */
+export declare function deleteMessage(token: TeamsToken, conversationId: string, messageId: string): Promise<DeletedMessage>;
+/**
+ * Fetch user properties for the authenticated user.
+ * Returns raw properties — display name may or may not be present.
+ */
+export declare function fetchUserProperties(token: TeamsToken): Promise<Record<string, unknown>>;
+/**
+ * Parse a raw API message object into the public Message type.
+ */
+export declare function parseRawMessage(raw: Record<string, unknown>): Message;
+//# sourceMappingURL=chat-service.d.ts.map

package/dist/api/chat-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-service.d.ts","sourceRoot":"","sources":["../../src/api/chat-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,OAAO,EACP,aAAa,EACb,YAAY,EACZ,MAAM,EAIN,WAAW,EACX,aAAa,EACb,cAAc,EACf,MAAM,aAAa,CAAC;AAerB;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CAyCzB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,YAAY,CAAC,CA6BvB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CA+BnB;AAqCD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,EACzB,MAAM,GAAE,aAA0B,GACjC,OAAO,CAAC,WAAW,CAAC,CAkDtB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,iBAAiB,EAAE,MAAM,EACzB,MAAM,GAAE,aAA0B,GACjC,OAAO,CAAC,aAAa,CAAC,CAmDxB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAqBzB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgBlC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAsCrE"}

package/dist/api/chat-service.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * REST API layer for the Teams Chat Service.
+ *
+ * All HTTP calls to {region}.ng.msg.teams.microsoft.com/v1 are here.
+ * This module is stateless — every function takes a TeamsToken explicitly.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchConversations = fetchConversations;
+exports.fetchMessagesPage = fetchMessagesPage;
+exports.fetchMembers = fetchMembers;
+exports.postMessage = postMessage;
+exports.editMessage = editMessage;
+exports.deleteMessage = deleteMessage;
+exports.fetchUserProperties = fetchUserProperties;
+exports.parseRawMessage = parseRawMessage;
+const common_js_1 = require("./common.js");
+const markdown_it_1 = __importDefault(require("markdown-it"));
+const markdownRenderer = new markdown_it_1.default({ html: true, breaks: true });
+const chatServiceBase = (region) => `https://${region}.ng.msg.teams.microsoft.com/v1`;
+function authHeaders(token) {
+    return {
+        Authentication: `skypetoken=${token.skypeToken}`,
+    };
+}
+/**
+ * Fetch conversations from the Teams Chat Service.
+ * Returns one page of conversations (no built-in pagination).
+ */
+async function fetchConversations(token, pageSize) {
+    const url = `${chatServiceBase(token.region)}/users/ME/conversations?view=mychats&pageSize=${pageSize}`;
+    const response = await (0, common_js_1.fetchWithRetry)(url, { headers: authHeaders(token) });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+        }
+        throw new Error(`Failed to fetch conversations: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return (data.conversations ?? []).map((conversation) => ({
+        id: conversation.id,
+        topic: conversation.threadProperties?.topic ??
+            conversation.properties?.displayName ??
+            "",
+        threadType: conversation.threadProperties?.threadType ?? "chat",
+        version: conversation.version,
+        lastMessageTime: conversation.properties?.lastimreceivedtime ?? null,
+        memberCount: conversation.threadProperties?.memberCount
+            ? Number(conversation.threadProperties.memberCount)
+            : null,
+    }));
+}
+/**
+ * Fetch one page of messages from a conversation.
+ */
+async function fetchMessagesPage(token, conversationId, pageSize, backwardLink) {
+    const url = backwardLink ??
+        `${chatServiceBase(token.region)}/users/ME/conversations/${encodeURIComponent(conversationId)}/messages?pageSize=${pageSize}`;
+    const response = await (0, common_js_1.fetchWithRetry)(url, { headers: authHeaders(token) });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+        }
+        throw new Error(`Failed to fetch messages: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    const messages = (data.messages ?? []).map(parseRawMessage);
+    return {
+        messages,
+        backwardLink: data._metadata?.backwardLink ?? null,
+        syncState: data._metadata?.syncState ?? null,
+    };
+}
+/**
+ * Fetch members of a conversation.
+ */
+async function fetchMembers(token, conversationId) {
+    const url = `${chatServiceBase(token.region)}/threads/${encodeURIComponent(conversationId)}/members`;
+    const response = await (0, common_js_1.fetchWithRetry)(url, { headers: authHeaders(token) });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+        }
+        throw new Error(`Failed to fetch members: ${response.status} ${response.statusText}`);
+    }
+    const data = (await response.json());
+    return (data.members ?? []).map((member) => ({
+        id: member.id,
+        displayName: member.userDisplayName ?? "",
+        role: member.role ?? "member",
+        memberType: member.id.startsWith("28:")
+            ? "bot"
+            : "person",
+    }));
+}
+/**
+ * Convert content to the appropriate format for the Teams API.
+ *
+ * - "text": sent as-is with messagetype "Text"
+ * - "markdown": converted from Markdown to HTML, sent as "RichText/Html"
+ * - "html": sent as-is with messagetype "RichText/Html"
+ */
+function resolveMessageContent(content, format) {
+    switch (format) {
+        case "text":
+            return {
+                resolvedContent: content,
+                messagetype: "Text",
+                contenttype: "text",
+            };
+        case "html":
+            return {
+                resolvedContent: content,
+                messagetype: "RichText/Html",
+                contenttype: "text",
+            };
+        case "markdown": {
+            const htmlContent = markdownRenderer.render(content);
+            return {
+                resolvedContent: htmlContent,
+                messagetype: "RichText/Html",
+                contenttype: "text",
+            };
+        }
+    }
+}
+/**
+ * Send a message to a conversation.
+ *
+ * The `format` parameter controls how `content` is interpreted:
+ * - `"text"` — plain text, sent as-is
+ * - `"markdown"` (default) — converted from Markdown to HTML
+ * - `"html"` — raw HTML, sent as-is
+ */
+async function postMessage(token, conversationId, content, senderDisplayName, format = "markdown") {
+    const url = `${chatServiceBase(token.region)}/users/ME/conversations/${encodeURIComponent(conversationId)}/messages`;
+    const clientMessageId = String(Date.now());
+    const { resolvedContent, messagetype, contenttype } = resolveMessageContent(content, format);
+    const body = {
+        content: resolvedContent,
+        messagetype,
+        contenttype,
+        clientmessageid: clientMessageId,
+        imdisplayname: senderDisplayName,
+        properties: {
+            importance: "",
+            subject: null,
+        },
+    };
+    const response = await (0, common_js_1.fetchWithRetry)(url, {
+        method: "POST",
+        headers: {
+            ...authHeaders(token),
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to send message: ${response.status} ${response.statusText} — ${errorText}`);
+    }
+    const data = (await response.json());
+    return {
+        messageId: String(data.OriginalArrivalTime),
+        arrivalTime: data.OriginalArrivalTime,
+    };
+}
+/**
+ * Edit an existing message in a conversation.
+ *
+ * The `format` parameter controls how `content` is interpreted:
+ * - `"text"` — plain text, sent as-is
+ * - `"markdown"` (default) — converted from Markdown to HTML
+ * - `"html"` — raw HTML, sent as-is
+ */
+async function editMessage(token, conversationId, messageId, content, senderDisplayName, format = "markdown") {
+    const url = `${chatServiceBase(token.region)}/users/ME/conversations/${encodeURIComponent(conversationId)}/messages/${encodeURIComponent(messageId)}`;
+    const { resolvedContent, messagetype, contenttype } = resolveMessageContent(content, format);
+    const body = {
+        content: resolvedContent,
+        messagetype,
+        contenttype,
+        skypeeditedid: messageId,
+        imdisplayname: senderDisplayName,
+    };
+    const response = await (0, common_js_1.fetchWithRetry)(url, {
+        method: "PUT",
+        headers: {
+            ...authHeaders(token),
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to edit message: ${response.status} ${response.statusText} — ${errorText}`);
+    }
+    const responseText = await response.text();
+    let editTime;
+    if (responseText) {
+        const data = JSON.parse(responseText);
+        editTime = data.edittime ?? new Date().toISOString();
+    }
+    else {
+        editTime = new Date().toISOString();
+    }
+    return {
+        messageId,
+        editTime,
+    };
+}
+/**
+ * Delete a message from a conversation.
+ *
+ * Sends a DELETE to the Chat Service; handles empty response body.
+ */
+async function deleteMessage(token, conversationId, messageId) {
+    const url = `${chatServiceBase(token.region)}/users/ME/conversations/${encodeURIComponent(conversationId)}/messages/${encodeURIComponent(messageId)}`;
+    const response = await (0, common_js_1.fetchWithRetry)(url, {
+        method: "DELETE",
+        headers: authHeaders(token),
+    });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+        }
+        const errorText = await response.text();
+        throw new Error(`Failed to delete message: ${response.status} ${response.statusText} — ${errorText}`);
+    }
+    return { messageId };
+}
+/**
+ * Fetch user properties for the authenticated user.
+ * Returns raw properties — display name may or may not be present.
+ */
+async function fetchUserProperties(token) {
+    const url = `${chatServiceBase(token.region)}/users/ME/properties`;
+    const response = await (0, common_js_1.fetchWithRetry)(url, { headers: authHeaders(token) });
+    if (!response.ok) {
+        if (response.status === 401) {
+            throw new common_js_1.ApiAuthError(`Authentication failed: ${response.status} ${response.statusText}`);
+        }
+        throw new Error(`Failed to fetch user properties: ${response.status} ${response.statusText}`);
+    }
+    return (await response.json());
+}
+/**
+ * Parse a raw API message object into the public Message type.
+ */
+function parseRawMessage(raw) {
+    const properties = (raw.properties ?? {});
+    const allEmotions = parseEmotions(properties.emotions);
+    const reactions = allEmotions.filter((emotion) => emotion.key !== "follow");
+    const followEntry = allEmotions.find((emotion) => emotion.key === "follow");
+    const followers = (followEntry?.users ?? [])
+        .filter((user) => String(user.value) === "0")
+        .map((user) => ({ mri: user.mri, time: user.time }));
+    const mentions = parseMentions(properties.mentions);
+    let quotedMessageId = null;
+    const content = String(raw.content ?? "");
+    const quoteMatch = content.match(/itemtype="http:\/\/schema\.skype\.com\/Reply"\s+itemid="(\d+)"/);
+    if (quoteMatch) {
+        quotedMessageId = quoteMatch[1];
+    }
+    return {
+        id: String(raw.id ?? ""),
+        messageType: String(raw.messagetype ?? ""),
+        senderMri: String(raw.from ?? ""),
+        senderDisplayName: String(raw.imdisplayname ?? ""),
+        content,
+        originalArrivalTime: String(raw.originalarrivaltime ?? ""),
+        composeTime: String(raw.composetime ?? ""),
+        editTime: properties.edittime ? String(properties.edittime) : null,
+        subject: properties.subject ? String(properties.subject) : null,
+        isDeleted: raw.messagetype === "MessageDelete" ||
+            String(properties.deletetime ?? "") !== "",
+        reactions,
+        followers,
+        mentions,
+        quotedMessageId,
+    };
+}
+function parseEmotions(rawEmotions) {
+    if (typeof rawEmotions === "string") {
+        try {
+            return JSON.parse(rawEmotions);
+        }
+        catch {
+            return [];
+        }
+    }
+    if (Array.isArray(rawEmotions)) {
+        return rawEmotions;
+    }
+    return [];
+}
+function parseMentions(rawMentions) {
+    let parsed;
+    if (typeof rawMentions === "string") {
+        try {
+            parsed = JSON.parse(rawMentions);
+        }
+        catch {
+            return [];
+        }
+    }
+    else if (Array.isArray(rawMentions)) {
+        parsed = rawMentions;
+    }
+    else {
+        return [];
+    }
+    return parsed.map((mention) => ({
+        id: mention.id ?? "",
+        displayName: mention.displayName ?? "",
+    }));
+}
+//# sourceMappingURL=chat-service.js.map

package/dist/api/chat-service.js.map

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

package/dist/api/common.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Common utilities shared across API modules.
+ *
+ * Contains error classes, retry logic, and shared helpers
+ * used by chat-service, middle-tier, substrate, and transcript modules.
+ */
+export declare class ApiAuthError extends Error {
+    constructor(message: string);
+}
+export declare class ApiRateLimitError extends Error {
+    readonly retryAfterMilliseconds: number;
+    constructor(message: string, retryAfterMilliseconds: number);
+}
+/**
+ * Wrapper around `fetch` that automatically retries on 429 (rate limit) responses.
+ *
+ * Uses the `Retry-After` header when present; otherwise applies exponential backoff
+ * starting at 2 seconds. Retries up to 5 times before throwing `ApiRateLimitError`.
+ */
+export declare function fetchWithRetry(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+//# sourceMappingURL=common.d.ts.map

package/dist/api/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/api/common.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,sBAAsB,EAAE,MAAM,CAAC;gBAEnC,OAAO,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM;CAK5D;AAqBD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,QAAQ,CAAC,CAsBnB"}

package/dist/api/common.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Common utilities shared across API modules.
+ *
+ * Contains error classes, retry logic, and shared helpers
+ * used by chat-service, middle-tier, substrate, and transcript modules.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiRateLimitError = exports.ApiAuthError = void 0;
+exports.fetchWithRetry = fetchWithRetry;
+class ApiAuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ApiAuthError";
+    }
+}
+exports.ApiAuthError = ApiAuthError;
+class ApiRateLimitError extends Error {
+    retryAfterMilliseconds;
+    constructor(message, retryAfterMilliseconds) {
+        super(message);
+        this.name = "ApiRateLimitError";
+        this.retryAfterMilliseconds = retryAfterMilliseconds;
+    }
+}
+exports.ApiRateLimitError = ApiRateLimitError;
+const MAX_RETRY_ATTEMPTS = 5;
+const INITIAL_BACKOFF_MILLISECONDS = 2_000;
+function parseRetryAfter(response) {
+    const retryAfterHeader = response.headers.get("Retry-After");
+    if (!retryAfterHeader) {
+        return INITIAL_BACKOFF_MILLISECONDS;
+    }
+    const seconds = Number(retryAfterHeader);
+    if (!Number.isNaN(seconds) && seconds > 0) {
+        return seconds * 1_000;
+    }
+    return INITIAL_BACKOFF_MILLISECONDS;
+}
+function delay(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+/**
+ * Wrapper around `fetch` that automatically retries on 429 (rate limit) responses.
+ *
+ * Uses the `Retry-After` header when present; otherwise applies exponential backoff
+ * starting at 2 seconds. Retries up to 5 times before throwing `ApiRateLimitError`.
+ */
+async function fetchWithRetry(input, init) {
+    for (let attempt = 0; attempt <= MAX_RETRY_ATTEMPTS; attempt++) {
+        const response = await fetch(input, init);
+        if (response.status !== 429) {
+            return response;
+        }
+        if (attempt === MAX_RETRY_ATTEMPTS) {
+            const errorText = await response.text();
+            throw new ApiRateLimitError(`Rate limit exceeded after ${MAX_RETRY_ATTEMPTS + 1} attempts: ${response.status} ${errorText}`, parseRetryAfter(response));
+        }
+        const retryAfterMilliseconds = parseRetryAfter(response);
+        const backoffMilliseconds = retryAfterMilliseconds * Math.pow(2, attempt);
+        await delay(backoffMilliseconds);
+    }
+    throw new Error("Unreachable: fetchWithRetry loop exited unexpectedly");
+}
+//# sourceMappingURL=common.js.map

package/dist/api/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/api/common.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA4CH,wCAyBC;AAnED,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED,MAAa,iBAAkB,SAAQ,KAAK;IAC1B,sBAAsB,CAAS;IAE/C,YAAY,OAAe,EAAE,sBAA8B;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,sBAAsB,GAAG,sBAAsB,CAAC;IACvD,CAAC;CACF;AARD,8CAQC;AAED,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAE3C,SAAS,eAAe,CAAC,QAAkB;IACzC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC7D,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,4BAA4B,CAAC;IACtC,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,OAAO,GAAG,KAAK,CAAC;IACzB,CAAC;IACD,OAAO,4BAA4B,CAAC;AACtC,CAAC;AAED,SAAS,KAAK,CAAC,YAAoB;IACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,cAAc,CAClC,KAA6B,EAC7B,IAAkB;IAElB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,kBAAkB,EAAE,OAAO,EAAE,EAAE,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,KAAK,kBAAkB,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,iBAAiB,CACzB,6BAA6B,kBAAkB,GAAG,CAAC,cAAc,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE,EAC/F,eAAe,CAAC,QAAQ,CAAC,CAC1B,CAAC;QACJ,CAAC;QAED,MAAM,sBAAsB,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,mBAAmB,GAAG,sBAAsB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1E,MAAM,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;AAC1E,CAAC"}