Microsoft.Exchange.WebServices

Kind: Service

Source: Pams/Logic/Pams.Email/Pams.Email.csproj (line 1)

Part of: Pams

NuGet package dependency

Microsoft.Exchange.WebServices is a NuGet package dependency in Pams.Email.csproj that provides the Exchange Web Services client API. The Pams.Email component uses it to connect to Microsoft Exchange, authenticate requests, and read or send email data through EWS.

Diagram

mermaid
flowchart LR
  PamsEmail[Pams.Email] --> EwsPackage[Microsoft.Exchange.WebServices]
  EwsPackage --> EwsClient[ExchangeService Client]
  EwsClient --> Exchange[Microsoft Exchange EWS Endpoint]
  Exchange --> Mailbox[Mailbox Data]

Usage

ts
const ewsEndpoint = process.env.EXCHANGE_EWS_URL;
const accessToken = process.env.EXCHANGE_ACCESS_TOKEN;

async function getInboxMessages() {
  const response = await fetch(`${ewsEndpoint}/EWS/Exchange.asmx`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${accessToken}`,
      "Content-Type": "text/xml; charset=utf-8",
      SOAPAction:
        "http://schemas.microsoft.com/exchange/services/2006/messages/FindItem",
    },
    body: `<?xml version="1.0" encoding="utf-8"?>
      <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
                     xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
        <soap:Body>
          <FindItem xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
                    Traversal="Shallow">
            <ItemShape>
              <t:BaseShape>IdOnly</t:BaseShape>
            </ItemShape>
            <ParentFolderIds>
              <t:DistinguishedFolderId Id="inbox" />
            </ParentFolderIds>
          </FindItem>
        </soap:Body>
      </soap:Envelope>`,
  });

  if (!response.ok) {
    throw new Error(`EWS request failed: ${response.status}`);
  }

  return response.text();
}

AI Coding Instructions

• Keep EWS package references in Pams.Email.csproj aligned with the APIs used by the email component.
• Configure Exchange endpoint and authentication values through application configuration or environment variables; do not embed credentials in source code.
• Handle SOAP faults and non-success HTTP responses before processing Exchange mailbox data.
• Treat this as a legacy-format dependency and avoid changing package versions without validating Exchange compatibility.

Used by

1 reference from 1 file. Each is a place in this repository where the symbol is actually used — go read one rather than trusting an example.

Injected or called by (1)

• Pams.Email — Pams/Logic/Pams.Email/Pams.Email.csproj:1