@yolk-sdk/emulators 0.1.0-canary.96

package/dist/microsoft/graph.mjs

@@ -0,0 +1,264 @@
+import { Predicate, Result } from "effect";
+import * as Schema from "effect/Schema";
+//#region src/microsoft/graph.ts
+/**
+* Shared Microsoft Graph emulator wire helpers (internal): the error envelope and codes, JSON
+* responses, `@odata.context`, `$select` projection, `$top`/`$skip` paging with
+* `@odata.nextLink` (folder messages only), single-page `$top` collections (`$top` always required
+* and capped at the largest value a fixture sends to the route), the `Prefer` header, strict nested
+* body objects, and the route handler contract.
+*
+* @experimental
+*/
+/**
+* Error codes the emulator answers with. `ErrorItemNotFound`, `itemNotFound`, and
+* `ErrorIrresolvableConflict` are copied from the fixtures; `InvalidAuthenticationToken` (missing
+* bearer), `ErrorInvalidUser` (a user other than the seeded mailbox), and `TooManyRequests` (the
+* default 429 fault body) are documented Graph codes no fixture records; the `Synthetic*` codes
+* are emulator codes for requests it refuses to emulate (fail closed) or cannot answer.
+*/
+const microsoftEmulatorErrorCodes = {
+	mailItemNotFound: "ErrorItemNotFound",
+	driveItemNotFound: "itemNotFound",
+	conflict: "ErrorIrresolvableConflict",
+	unauthenticated: "InvalidAuthenticationToken",
+	invalidUser: "ErrorInvalidUser",
+	rateLimited: "TooManyRequests",
+	unknownRoute: "SyntheticRouteNotEmulated",
+	unsupportedQuery: "SyntheticQueryNotEmulated",
+	unsupportedValue: "SyntheticValueNotEmulated",
+	invalidRequest: "SyntheticInvalidRequest",
+	invalidBody: "SyntheticInvalidBody",
+	upstreamError: "SyntheticUpstreamError"
+};
+const codes = microsoftEmulatorErrorCodes;
+/** Graph JSON content type, as the fixtures record it. */
+const graphContentType = "application/json; odata.metadata=minimal; odata.streaming=true; IEEE754Compatible=false; charset=utf-8";
+const jsonResponse = (status, body, headers = {}) => {
+	const responseHeaders = new Headers(headers);
+	if (!responseHeaders.has("content-type")) responseHeaders.set("content-type", graphContentType);
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: responseHeaders
+	});
+};
+/** Graph API version prefix of every Graph route. */
+const microsoftEmulatorBasePath = "/v1.0";
+/** A percent-decoded path segment, or `undefined` for invalid percent-encoding. */
+const decodeSegment = (segment) => {
+	try {
+		return decodeURIComponent(segment);
+	} catch {
+		return;
+	}
+};
+/**
+* An OData key segment as the fixtures write it in `@odata.context`: `('ada%40example.test')`,
+* `('b%21synthetic-drive-0001')` (percent-encoded, including `!'()*`).
+*/
+const odataKey = (value) => `('${encodeURIComponent(value).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`)}')`;
+/** `(a,b,c)` for a `$select`, empty without one, as the fixture contexts write it. */
+const selectSuffix = (fields) => fields === void 0 ? "" : `(${fields.join(",")})`;
+/** The fixture `@odata.context` URL: `{graphOrigin}/v1.0/$metadata#{path}`. */
+const metadataContext = (env, path) => `${env.graphOrigin}${microsoftEmulatorBasePath}/$metadata#${path}`;
+/** An entity body with its `@odata.context` first, as the fixtures record it. */
+const entity = (context, body) => ({
+	"@odata.context": context,
+	...body
+});
+/** A bodiless success (204 delete, 202 cancel/copy), as the fixtures record them. */
+const emptyResponse = (status, headers = {}) => new Response(null, {
+	status,
+	headers
+});
+/** The Graph error envelope `{ error: { code, message, innerError } }`. */
+const graphError = (context, status, code, message) => jsonResponse(status, { error: {
+	code,
+	message,
+	innerError: {
+		date: context.date,
+		"request-id": context.requestId,
+		"client-request-id": context.clientRequestId
+	}
+} });
+const padded = (value, width) => String(value).padStart(width, "0");
+/** A synthetic request id for ledger sequence `seq`. */
+const syntheticRequestId = (seq) => `00000000-0000-4000-8000-${padded(seq % 0xe8d4a51000, 12)}`;
+const clientRequestIdPattern = /^[A-Za-z0-9-]{1,64}$/;
+/** The error context of one request; `client-request-id` is echoed only when it is plain. */
+const errorContext = (now, seq, clientRequestId) => {
+	const requestId = syntheticRequestId(seq);
+	return {
+		date: (/* @__PURE__ */ new Date(Math.floor(now / 1e3) * 1e3)).toISOString().slice(0, 19),
+		requestId,
+		clientRequestId: clientRequestId !== null && clientRequestIdPattern.test(clientRequestId) ? clientRequestId : requestId
+	};
+};
+const unquote = (value) => value.length >= 2 && value.startsWith("\"") && value.endsWith("\"") ? value.slice(1, -1) : value;
+/** Parse `Prefer`: comma-separated `name=value` preferences. */
+const parsePreferences = (header) => {
+	let immutableId = false;
+	let timezone;
+	for (const part of (header ?? "").split(",")) {
+		const separator = part.indexOf("=");
+		const name = (separator === -1 ? part : part.slice(0, separator)).trim().toLowerCase();
+		const value = separator === -1 ? "" : unquote(part.slice(separator + 1).trim());
+		if (name === "idtype" && value.toLowerCase() === "immutableid") immutableId = true;
+		if (name === "outlook.timezone") timezone = value;
+	}
+	return {
+		immutableId,
+		timezone
+	};
+};
+const isJsonObject = (value) => value !== void 0 && value !== null && Predicate.isObject(value) && !Array.isArray(value);
+const decodeJsonText = Schema.decodeUnknownResult(Schema.fromJsonString(Schema.Json));
+/** Parsed JSON, or `undefined` for invalid JSON. */
+const parseJsonText = (text) => {
+	const result = decodeJsonText(text);
+	return Result.isSuccess(result) ? result.success : void 0;
+};
+/** The user a `/users/{userId}` segment names (id, `mail`, or UPN, case-insensitive). */
+const resolveUser = (state, request) => {
+	const userId = (request.params.userId ?? "").toLowerCase();
+	const user = state.user;
+	return [
+		user.id,
+		user.mail,
+		user.userPrincipalName
+	].some((candidate) => candidate.toLowerCase() === userId) ? user : request.error(404, codes.invalidUser, "Synthetic: the requested user is not emulated.");
+};
+/** The `$select` fields, `undefined` without `$select`, or a 400 for a field not emulated. */
+const selectedFields = (request, allowed) => {
+	const raw = request.query.get("$select");
+	if (raw === null) return void 0;
+	const fields = raw.split(",").map((field) => field.trim());
+	const unknown = fields.find((field) => !allowed.includes(field));
+	return unknown === void 0 ? fields : request.error(400, codes.unsupportedQuery, `Synthetic: $select field '${unknown}' is not emulated on this resource.`);
+};
+/** Annotations and the id are always returned, whatever `$select` names. */
+const alwaysReturned = [
+	"@odata.etag",
+	"@odata.type",
+	"@odata.mediaContentType",
+	"id"
+];
+/** Keep only the selected keys (plus annotations and `id`); everything without `$select`. */
+const project = (full, fields) => fields === void 0 ? full : Object.fromEntries(Object.entries(full).filter(([key]) => alwaysReturned.includes(key) || fields.includes(key)));
+const integerQuery = (request, key, minimum, maximum) => {
+	const raw = request.query.get(key);
+	if (raw === null) return void 0;
+	const value = Number(raw);
+	return /^\d+$/.test(raw) && value >= minimum && value <= maximum ? value : request.error(400, codes.invalidRequest, `Synthetic: ${key} must be an integer from ${minimum} to ${maximum}.`);
+};
+/**
+* The required `$top` of a collection whose fixtures always send it: a positive integer (400
+* invalid otherwise), and 400 not emulated when it is missing or above `maxTop`, the largest
+* `$top` any fixture sends to that route.
+*/
+const requiredTop = (request, maxTop) => {
+	const top = integerQuery(request, "$top", 1, Number.MAX_SAFE_INTEGER);
+	if (top instanceof Response) return top;
+	if (top === void 0) return notEmulated(request, "requests without $top are not emulated on this collection.");
+	return top > maxTop ? notEmulated(request, `$top above ${maxTop} (the largest page size a fixture sends) is not emulated on this collection.`) : top;
+};
+/**
+* One `$top`/`$skip` page of `items`. `$top` is required and at most `maxTop` (see
+* `requiredTop`); no fixture records a default page size.
+*/
+const pageOf = (items, request, maxTop) => {
+	const top = requiredTop(request, maxTop);
+	if (top instanceof Response) return top;
+	const skip = integerQuery(request, "$skip", 0, Number.MAX_SAFE_INTEGER);
+	if (skip instanceof Response) return skip;
+	const start = skip ?? 0;
+	const end = start + top;
+	return {
+		items: items.slice(start, end),
+		top,
+		nextSkip: end < items.length ? end : void 0
+	};
+};
+/**
+* A collection whose fixtures send `$top` and never page (calendar views, children listings):
+* the items, or 400 not emulated without `$top`, with `$top` above `maxTop` (see `requiredTop`),
+* or with more items than `$top` (no fixture records a default page size or a second page of
+* these collections).
+*/
+const singlePage = (items, request, maxTop) => {
+	const top = requiredTop(request, maxTop);
+	if (top instanceof Response) return top;
+	return items.length > top ? notEmulated(request, `more than $top (${top}) results: paging this collection is not emulated.`) : items;
+};
+/**
+* The `@odata.nextLink` of a page: the configured Graph origin, the request's raw path (so
+* `/users/ada%40example.test` keeps its `%40`), the carried query keys, then `$top` and `$skip`,
+* encoded like the fixtures (`%24select=id%2Csubject...`). `undefined` on the last page or when
+* the `omitNextLink` drill knob is set. Clients follow it unchanged (opaque).
+*/
+const nextLinkOf = (env, request, page, carried) => {
+	if (page.nextSkip === void 0 || env.drills.omitNextLink) return void 0;
+	const params = new URLSearchParams();
+	for (const key of carried) {
+		const value = request.query.get(key);
+		if (value !== null) params.set(key, value);
+	}
+	params.set("$top", String(page.top));
+	params.set("$skip", String(page.nextSkip));
+	return `${env.graphOrigin}${request.path}?${params.toString()}`;
+};
+/** `{ @odata.context, value, @odata.nextLink? }`, as the fixture pages record them. */
+const collection = (context, value, nextLink) => nextLink === void 0 ? {
+	"@odata.context": context,
+	value
+} : {
+	"@odata.context": context,
+	value,
+	"@odata.nextLink": nextLink
+};
+/** A write body that is a JSON object with only `allowed` keys, or a 400. */
+const bodyObject = (request, allowed) => {
+	if (!isJsonObject(request.body)) return request.error(400, codes.invalidBody, "Synthetic: the request body must be a JSON object.");
+	const unknown = Object.keys(request.body).find((key) => !allowed.includes(key));
+	return unknown === void 0 ? request.body : request.error(400, codes.unsupportedValue, `Synthetic: property '${unknown}' is not emulated on this request.`);
+};
+/** 400 for an invalid value. */
+const invalidValue = (request, message) => request.error(400, codes.invalidRequest, `Synthetic: ${message}`);
+/** 400 for a valid Graph request the emulator does not emulate (fail closed). */
+const notEmulated = (request, message) => request.error(400, codes.unsupportedValue, `Synthetic: ${message}`);
+/**
+* A nested JSON object with only `allowed` keys (fail closed on anything else, before any write),
+* or a 400. `expected` names the expected object in the error message.
+*/
+const nestedObject = (request, value, allowed, expected) => {
+	if (!isJsonObject(value)) return invalidValue(request, `expected ${expected}.`);
+	const unknown = Object.keys(value).find((key) => !allowed.includes(key));
+	return unknown === void 0 ? value : notEmulated(request, `property '${unknown}' is not emulated in ${expected}.`);
+};
+/**
+* An `itemBody` write value, `{ contentType, content }` with only those keys. The fixtures write
+* text bodies only (`Text`/`text`); any other content type is not emulated.
+*/
+const textBody = (request, value) => {
+	const body = nestedObject(request, value, ["contentType", "content"], "body { contentType, content }");
+	if (body instanceof Response) return body;
+	if (!Predicate.isString(body.contentType) || !Predicate.isString(body.content)) return invalidValue(request, "body must be { contentType, content } with string values.");
+	return body.contentType.toLowerCase() === "text" ? body.content : notEmulated(request, `body contentType ${body.contentType} is not emulated (text only).`);
+};
+/** A Graph timestamp (`2026-09-29T10:00:00Z`) from the emulator clock. */
+const nowTimestamp = (env) => (/* @__PURE__ */ new Date(Math.floor(env.now() / 1e3) * 1e3)).toISOString().replace(".000Z", "Z");
+/** The next change key (bumps the counter). */
+const nextChangeKey = (state, prefix) => {
+	const number = state.counters.nextChangeKeyNumber;
+	state.counters = {
+		...state.counters,
+		nextChangeKeyNumber: number + 1
+	};
+	return `${prefix}${padded(number, 4)}`;
+};
+/** The `personal/{site}` segment of the mailbox owner (`ada@example.test` → `ada_example_test`). */
+const personalSite = (user) => user.mail.toLowerCase().replace(/[^a-z0-9]/g, "_");
+//#endregion
+export { bodyObject, codes, collection, decodeSegment, emptyResponse, entity, errorContext, graphContentType, graphError, invalidValue, isJsonObject, jsonResponse, metadataContext, microsoftEmulatorBasePath, microsoftEmulatorErrorCodes, nestedObject, nextChangeKey, nextLinkOf, notEmulated, nowTimestamp, odataKey, padded, pageOf, parseJsonText, parsePreferences, personalSite, project, resolveUser, selectSuffix, selectedFields, singlePage, syntheticRequestId, textBody };
+
+//# sourceMappingURL=graph.mjs.map

package/dist/microsoft/graph.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.mjs","names":[],"sources":["../../src/microsoft/graph.ts"],"sourcesContent":["/**\n * Shared Microsoft Graph emulator wire helpers (internal): the error envelope and codes, JSON\n * responses, `@odata.context`, `$select` projection, `$top`/`$skip` paging with\n * `@odata.nextLink` (folder messages only), single-page `$top` collections (`$top` always required\n * and capped at the largest value a fixture sends to the route), the `Prefer` header, strict nested\n * body objects, and the route handler contract.\n *\n * @experimental\n */\nimport { Predicate, Result } from 'effect'\nimport * as Schema from 'effect/Schema'\nimport type { MicrosoftEmulatorState, MicrosoftEmulatorUser } from './state.ts'\n\n/**\n * Error codes the emulator answers with. `ErrorItemNotFound`, `itemNotFound`, and\n * `ErrorIrresolvableConflict` are copied from the fixtures; `InvalidAuthenticationToken` (missing\n * bearer), `ErrorInvalidUser` (a user other than the seeded mailbox), and `TooManyRequests` (the\n * default 429 fault body) are documented Graph codes no fixture records; the `Synthetic*` codes\n * are emulator codes for requests it refuses to emulate (fail closed) or cannot answer.\n */\nexport const microsoftEmulatorErrorCodes = {\n  mailItemNotFound: 'ErrorItemNotFound',\n  driveItemNotFound: 'itemNotFound',\n  conflict: 'ErrorIrresolvableConflict',\n  unauthenticated: 'InvalidAuthenticationToken',\n  invalidUser: 'ErrorInvalidUser',\n  rateLimited: 'TooManyRequests',\n  unknownRoute: 'SyntheticRouteNotEmulated',\n  unsupportedQuery: 'SyntheticQueryNotEmulated',\n  unsupportedValue: 'SyntheticValueNotEmulated',\n  invalidRequest: 'SyntheticInvalidRequest',\n  invalidBody: 'SyntheticInvalidBody',\n  upstreamError: 'SyntheticUpstreamError'\n} as const\n\nexport const codes = microsoftEmulatorErrorCodes\n\n/** Graph JSON content type, as the fixtures record it. */\nexport const graphContentType =\n  'application/json; odata.metadata=minimal; odata.streaming=true; IEEE754Compatible=false; charset=utf-8'\n\nexport const jsonResponse = (\n  status: number,\n  body: unknown,\n  headers: HeadersInit = {}\n): Response => {\n  const responseHeaders = new Headers(headers)\n\n  if (!responseHeaders.has('content-type')) responseHeaders.set('content-type', graphContentType)\n\n  return new Response(JSON.stringify(body), { status, headers: responseHeaders })\n}\n\n/** Graph API version prefix of every Graph route. */\nexport const microsoftEmulatorBasePath = '/v1.0'\n\n/** A percent-decoded path segment, or `undefined` for invalid percent-encoding. */\nexport const decodeSegment = (segment: string): string | undefined => {\n  try {\n    return decodeURIComponent(segment)\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * An OData key segment as the fixtures write it in `@odata.context`: `('ada%40example.test')`,\n * `('b%21synthetic-drive-0001')` (percent-encoded, including `!'()*`).\n */\nexport const odataKey = (value: string): string =>\n  `('${encodeURIComponent(value).replace(\n    /[!'()*]/g,\n    character => `%${character.charCodeAt(0).toString(16).toUpperCase()}`\n  )}')`\n\n/** `(a,b,c)` for a `$select`, empty without one, as the fixture contexts write it. */\nexport const selectSuffix = (fields: ReadonlyArray<string> | undefined): string =>\n  fields === undefined ? '' : `(${fields.join(',')})`\n\n/** The fixture `@odata.context` URL: `{graphOrigin}/v1.0/$metadata#{path}`. */\nexport const metadataContext = (env: MicrosoftApiEnv, path: string): string =>\n  `${env.graphOrigin}${microsoftEmulatorBasePath}/$metadata#${path}`\n\n/** An entity body with its `@odata.context` first, as the fixtures record it. */\nexport const entity = (context: string, body: Schema.JsonObject): Schema.JsonObject => ({\n  '@odata.context': context,\n  ...body\n})\n\n/** A bodiless success (204 delete, 202 cancel/copy), as the fixtures record them. */\nexport const emptyResponse = (status: number, headers: HeadersInit = {}): Response =>\n  new Response(null, { status, headers })\n\n/** Where a Graph error envelope's `innerError` values come from. */\nexport type ErrorContext = {\n  /** `innerError.date` (`YYYY-MM-DDTHH:MM:SS`, UTC). */\n  readonly date: string\n  readonly requestId: string\n  readonly clientRequestId: string\n}\n\n/** The Graph error envelope `{ error: { code, message, innerError } }`. */\nexport const graphError = (\n  context: ErrorContext,\n  status: number,\n  code: string,\n  message: string\n): Response =>\n  jsonResponse(status, {\n    error: {\n      code,\n      message,\n      innerError: {\n        date: context.date,\n        'request-id': context.requestId,\n        'client-request-id': context.clientRequestId\n      }\n    }\n  })\n\nexport const padded = (value: number, width: number): string => String(value).padStart(width, '0')\n\n/** A synthetic request id for ledger sequence `seq`. */\nexport const syntheticRequestId = (seq: number): string =>\n  `00000000-0000-4000-8000-${padded(seq % 1_000_000_000_000, 12)}`\n\nconst clientRequestIdPattern = /^[A-Za-z0-9-]{1,64}$/\n\n/** The error context of one request; `client-request-id` is echoed only when it is plain. */\nexport const errorContext = (\n  now: number,\n  seq: number,\n  clientRequestId: string | null\n): ErrorContext => {\n  const requestId = syntheticRequestId(seq)\n\n  return {\n    date: new Date(Math.floor(now / 1000) * 1000).toISOString().slice(0, 19),\n    requestId,\n    clientRequestId:\n      clientRequestId !== null && clientRequestIdPattern.test(clientRequestId)\n        ? clientRequestId\n        : requestId\n  }\n}\n\n/** The parsed `Prefer` preferences the emulator reads (others are ignored, as Graph does). */\nexport type Preferences = {\n  /** `IdType=\"ImmutableId\"`: answer message ids in immutable form. */\n  readonly immutableId: boolean\n  /** `outlook.timezone`, when sent. */\n  readonly timezone: string | undefined\n}\n\nconst unquote = (value: string): string =>\n  value.length >= 2 && value.startsWith('\"') && value.endsWith('\"') ? value.slice(1, -1) : value\n\n/** Parse `Prefer`: comma-separated `name=value` preferences. */\nexport const parsePreferences = (header: string | null): Preferences => {\n  let immutableId = false\n  let timezone: string | undefined\n\n  for (const part of (header ?? '').split(',')) {\n    const separator = part.indexOf('=')\n    const name = (separator === -1 ? part : part.slice(0, separator)).trim().toLowerCase()\n    const value = separator === -1 ? '' : unquote(part.slice(separator + 1).trim())\n\n    if (name === 'idtype' && value.toLowerCase() === 'immutableid') immutableId = true\n\n    if (name === 'outlook.timezone') timezone = value\n  }\n\n  return { immutableId, timezone }\n}\n\n/** One routed API request, as the handlers see it. */\nexport type RouteRequest = {\n  /** Decoded path parameters. */\n  readonly params: Readonly<Record<string, string>>\n  /** Raw (still percent-encoded) path, for example `/v1.0/users/ada%40example.test/...`. */\n  readonly path: string\n  readonly query: URLSearchParams\n  /** Parsed JSON body; `undefined` when absent. */\n  readonly body: Schema.Json | undefined\n  readonly prefer: Preferences\n  /** A Graph error envelope response for this request. */\n  readonly error: (status: number, code: string, message: string) => Response\n}\n\n/** Drill knobs (tests only): each makes the emulator disagree with one conformance claim. */\nexport type MicrosoftEmulatorDrills = {\n  /** `true`: `calendarView` answers an empty `value` for every range. */\n  readonly calendarRangeEmpty?: boolean\n  /** `true`: event create answers 201 without the new event's `id` (the event is still created). */\n  readonly createOmitsId?: boolean\n  /** Fractional digits of event `dateTime` values (Graph uses 7); `3` drills the precision case. */\n  readonly timestampPrecisionDigits?: number\n  /** `true`: folder message pages never carry `@odata.nextLink`. */\n  readonly omitNextLink?: boolean\n}\n\n/** A OneDrive copy the monitor reports on (runtime-only, like the ledger; not in the state). */\nexport type CopyMonitor = {\n  readonly id: string\n  readonly sourceId: string\n  readonly destinationParentId: string\n  /** In-progress answers left before the copy runs and completes. */\n  pollsLeft: number\n  /** Set once the copy ran and completed. */\n  resourceId: string | undefined\n}\n\nexport type MicrosoftApiEnv = {\n  /** Clock in epoch milliseconds (timestamps of created items). */\n  readonly now: () => number\n  /** Origin of `@odata.nextLink` values, for example `https://graph.microsoft.com`. */\n  readonly graphOrigin: string\n  /** Origin of OneDrive `webUrl` values and copy monitor URLs. */\n  readonly sharePointOrigin: string\n  readonly drills: Required<MicrosoftEmulatorDrills>\n  /** In-progress monitor answers before a copy completes (default 0: the first poll completes). */\n  readonly copyInProgressPolls: number\n  /** How long a message write holds its message; a concurrent write in that time loses (409). */\n  readonly conflictWindowMs: number\n  /** Immutable ids of messages with a write in flight (runtime-only). */\n  readonly messageLocks: Set<string>\n  /** Copy monitors by id (runtime-only; cleared by reset and seed). */\n  readonly monitors: Map<string, CopyMonitor>\n  readonly monitorCounter: { next: number }\n}\n\n/**\n * A message write's answer and the message it holds once committed: the write holds it for\n * `conflictWindowMs` before answering, so an overlapping write to it gets 409.\n */\nexport type HeldAnswer = {\n  readonly response: Response\n  /** Immutable id of the message held. */\n  readonly holds: string\n}\n\n/**\n * A route handler. It runs on a draft of the state and of the copy monitors (see\n * `registerMicrosoftApi`) and decides the whole answer synchronously; it replaces whole state lists\n * and counters, never editing them in place. Any answer that is not 2xx is a refusal.\n */\nexport type RouteHandler = (\n  state: MicrosoftEmulatorState,\n  request: RouteRequest,\n  env: MicrosoftApiEnv\n) => Response | HeldAnswer\n\nexport const isJsonObject = (value: Schema.Json | undefined): value is Schema.JsonObject =>\n  value !== undefined && value !== null && Predicate.isObject(value) && !Array.isArray(value)\n\nconst decodeJsonText = Schema.decodeUnknownResult(Schema.fromJsonString(Schema.Json))\n\n/** Parsed JSON, or `undefined` for invalid JSON. */\nexport const parseJsonText = (text: string): Schema.Json | undefined => {\n  const result = decodeJsonText(text)\n\n  return Result.isSuccess(result) ? result.success : undefined\n}\n\n/** The user a `/users/{userId}` segment names (id, `mail`, or UPN, case-insensitive). */\nexport const resolveUser = (\n  state: MicrosoftEmulatorState,\n  request: RouteRequest\n): MicrosoftEmulatorUser | Response => {\n  const userId = (request.params.userId ?? '').toLowerCase()\n  const user = state.user\n\n  return [user.id, user.mail, user.userPrincipalName].some(\n    candidate => candidate.toLowerCase() === userId\n  )\n    ? user\n    : request.error(404, codes.invalidUser, 'Synthetic: the requested user is not emulated.')\n}\n\n/** The `$select` fields, `undefined` without `$select`, or a 400 for a field not emulated. */\nexport const selectedFields = (\n  request: RouteRequest,\n  allowed: ReadonlyArray<string>\n): ReadonlyArray<string> | undefined | Response => {\n  const raw = request.query.get('$select')\n\n  if (raw === null) return undefined\n\n  const fields = raw.split(',').map(field => field.trim())\n  const unknown = fields.find(field => !allowed.includes(field))\n\n  return unknown === undefined\n    ? fields\n    : request.error(\n        400,\n        codes.unsupportedQuery,\n        `Synthetic: $select field '${unknown}' is not emulated on this resource.`\n      )\n}\n\n/** Annotations and the id are always returned, whatever `$select` names. */\nconst alwaysReturned: ReadonlyArray<string> = [\n  '@odata.etag',\n  '@odata.type',\n  '@odata.mediaContentType',\n  'id'\n]\n\n/** Keep only the selected keys (plus annotations and `id`); everything without `$select`. */\nexport const project = (\n  full: Schema.JsonObject,\n  fields: ReadonlyArray<string> | undefined\n): Schema.JsonObject =>\n  fields === undefined\n    ? full\n    : Object.fromEntries(\n        Object.entries(full).filter(([key]) => alwaysReturned.includes(key) || fields.includes(key))\n      )\n\nconst integerQuery = (\n  request: RouteRequest,\n  key: string,\n  minimum: number,\n  maximum: number\n): number | undefined | Response => {\n  const raw = request.query.get(key)\n\n  if (raw === null) return undefined\n\n  const value = Number(raw)\n\n  return /^\\d+$/.test(raw) && value >= minimum && value <= maximum\n    ? value\n    : request.error(\n        400,\n        codes.invalidRequest,\n        `Synthetic: ${key} must be an integer from ${minimum} to ${maximum}.`\n      )\n}\n\n/**\n * The required `$top` of a collection whose fixtures always send it: a positive integer (400\n * invalid otherwise), and 400 not emulated when it is missing or above `maxTop`, the largest\n * `$top` any fixture sends to that route.\n */\nconst requiredTop = (request: RouteRequest, maxTop: number): number | Response => {\n  const top = integerQuery(request, '$top', 1, Number.MAX_SAFE_INTEGER)\n\n  if (top instanceof Response) return top\n\n  if (top === undefined) {\n    return notEmulated(request, 'requests without $top are not emulated on this collection.')\n  }\n\n  return top > maxTop\n    ? notEmulated(\n        request,\n        `$top above ${maxTop} (the largest page size a fixture sends) is not emulated on this collection.`\n      )\n    : top\n}\n\nexport type Page<A> = {\n  readonly items: ReadonlyArray<A>\n  readonly top: number\n  /** `$skip` of the next page, when there is one. */\n  readonly nextSkip: number | undefined\n}\n\n/**\n * One `$top`/`$skip` page of `items`. `$top` is required and at most `maxTop` (see\n * `requiredTop`); no fixture records a default page size.\n */\nexport const pageOf = <A>(\n  items: ReadonlyArray<A>,\n  request: RouteRequest,\n  maxTop: number\n): Page<A> | Response => {\n  const top = requiredTop(request, maxTop)\n\n  if (top instanceof Response) return top\n\n  const skip = integerQuery(request, '$skip', 0, Number.MAX_SAFE_INTEGER)\n\n  if (skip instanceof Response) return skip\n\n  const start = skip ?? 0\n  const end = start + top\n\n  return {\n    items: items.slice(start, end),\n    top,\n    nextSkip: end < items.length ? end : undefined\n  }\n}\n\n/**\n * A collection whose fixtures send `$top` and never page (calendar views, children listings):\n * the items, or 400 not emulated without `$top`, with `$top` above `maxTop` (see `requiredTop`),\n * or with more items than `$top` (no fixture records a default page size or a second page of\n * these collections).\n */\nexport const singlePage = <A>(\n  items: ReadonlyArray<A>,\n  request: RouteRequest,\n  maxTop: number\n): ReadonlyArray<A> | Response => {\n  const top = requiredTop(request, maxTop)\n\n  if (top instanceof Response) return top\n\n  return items.length > top\n    ? notEmulated(\n        request,\n        `more than $top (${top}) results: paging this collection is not emulated.`\n      )\n    : items\n}\n\n/**\n * The `@odata.nextLink` of a page: the configured Graph origin, the request's raw path (so\n * `/users/ada%40example.test` keeps its `%40`), the carried query keys, then `$top` and `$skip`,\n * encoded like the fixtures (`%24select=id%2Csubject...`). `undefined` on the last page or when\n * the `omitNextLink` drill knob is set. Clients follow it unchanged (opaque).\n */\nexport const nextLinkOf = (\n  env: MicrosoftApiEnv,\n  request: RouteRequest,\n  page: Page<unknown>,\n  carried: ReadonlyArray<string>\n): string | undefined => {\n  if (page.nextSkip === undefined || env.drills.omitNextLink) return undefined\n\n  const params = new URLSearchParams()\n\n  for (const key of carried) {\n    const value = request.query.get(key)\n\n    if (value !== null) params.set(key, value)\n  }\n\n  params.set('$top', String(page.top))\n  params.set('$skip', String(page.nextSkip))\n\n  return `${env.graphOrigin}${request.path}?${params.toString()}`\n}\n\n/** `{ @odata.context, value, @odata.nextLink? }`, as the fixture pages record them. */\nexport const collection = (\n  context: string,\n  value: ReadonlyArray<unknown>,\n  nextLink: string | undefined\n) =>\n  nextLink === undefined\n    ? { '@odata.context': context, value }\n    : { '@odata.context': context, value, '@odata.nextLink': nextLink }\n\n/** A write body that is a JSON object with only `allowed` keys, or a 400. */\nexport const bodyObject = (\n  request: RouteRequest,\n  allowed: ReadonlyArray<string>\n): Schema.JsonObject | Response => {\n  if (!isJsonObject(request.body)) {\n    return request.error(\n      400,\n      codes.invalidBody,\n      'Synthetic: the request body must be a JSON object.'\n    )\n  }\n\n  const unknown = Object.keys(request.body).find(key => !allowed.includes(key))\n\n  return unknown === undefined\n    ? request.body\n    : request.error(\n        400,\n        codes.unsupportedValue,\n        `Synthetic: property '${unknown}' is not emulated on this request.`\n      )\n}\n\n/** 400 for an invalid value. */\nexport const invalidValue = (request: RouteRequest, message: string): Response =>\n  request.error(400, codes.invalidRequest, `Synthetic: ${message}`)\n\n/** 400 for a valid Graph request the emulator does not emulate (fail closed). */\nexport const notEmulated = (request: RouteRequest, message: string): Response =>\n  request.error(400, codes.unsupportedValue, `Synthetic: ${message}`)\n\n/**\n * A nested JSON object with only `allowed` keys (fail closed on anything else, before any write),\n * or a 400. `expected` names the expected object in the error message.\n */\nexport const nestedObject = (\n  request: RouteRequest,\n  value: Schema.Json | undefined,\n  allowed: ReadonlyArray<string>,\n  expected: string\n): Schema.JsonObject | Response => {\n  if (!isJsonObject(value)) return invalidValue(request, `expected ${expected}.`)\n\n  const unknown = Object.keys(value).find(key => !allowed.includes(key))\n\n  return unknown === undefined\n    ? value\n    : notEmulated(request, `property '${unknown}' is not emulated in ${expected}.`)\n}\n\n/**\n * An `itemBody` write value, `{ contentType, content }` with only those keys. The fixtures write\n * text bodies only (`Text`/`text`); any other content type is not emulated.\n */\nexport const textBody = (\n  request: RouteRequest,\n  value: Schema.Json | undefined\n): string | Response => {\n  const body = nestedObject(\n    request,\n    value,\n    ['contentType', 'content'],\n    'body { contentType, content }'\n  )\n\n  if (body instanceof Response) return body\n\n  if (!Predicate.isString(body.contentType) || !Predicate.isString(body.content)) {\n    return invalidValue(request, 'body must be { contentType, content } with string values.')\n  }\n\n  return body.contentType.toLowerCase() === 'text'\n    ? body.content\n    : notEmulated(request, `body contentType ${body.contentType} is not emulated (text only).`)\n}\n\n/** A Graph timestamp (`2026-09-29T10:00:00Z`) from the emulator clock. */\nexport const nowTimestamp = (env: MicrosoftApiEnv): string =>\n  new Date(Math.floor(env.now() / 1000) * 1000).toISOString().replace('.000Z', 'Z')\n\n/** The next change key (bumps the counter). */\nexport const nextChangeKey = (state: MicrosoftEmulatorState, prefix: string): string => {\n  const number = state.counters.nextChangeKeyNumber\n\n  state.counters = { ...state.counters, nextChangeKeyNumber: number + 1 }\n\n  return `${prefix}${padded(number, 4)}`\n}\n\n/** The `personal/{site}` segment of the mailbox owner (`ada@example.test` → `ada_example_test`). */\nexport const personalSite = (user: MicrosoftEmulatorUser): string =>\n  user.mail.toLowerCase().replace(/[^a-z0-9]/g, '_')\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAoBA,MAAa,8BAA8B;CACzC,kBAAkB;CAClB,mBAAmB;CACnB,UAAU;CACV,iBAAiB;CACjB,aAAa;CACb,aAAa;CACb,cAAc;CACd,kBAAkB;CAClB,kBAAkB;CAClB,gBAAgB;CAChB,aAAa;CACb,eAAe;AACjB;AAEA,MAAa,QAAQ;;AAGrB,MAAa,mBACX;AAEF,MAAa,gBACX,QACA,MACA,UAAuB,CAAC,MACX;CACb,MAAM,kBAAkB,IAAI,QAAQ,OAAO;CAE3C,IAAI,CAAC,gBAAgB,IAAI,cAAc,GAAG,gBAAgB,IAAI,gBAAgB,gBAAgB;CAE9F,OAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;EAAE;EAAQ,SAAS;CAAgB,CAAC;AAChF;;AAGA,MAAa,4BAA4B;;AAGzC,MAAa,iBAAiB,YAAwC;CACpE,IAAI;EACF,OAAO,mBAAmB,OAAO;CACnC,QAAQ;EACN;CACF;AACF;;;;;AAMA,MAAa,YAAY,UACvB,KAAK,mBAAmB,KAAK,EAAE,QAC7B,aACA,cAAa,IAAI,UAAU,WAAW,CAAC,EAAE,SAAS,EAAE,EAAE,YAAY,GACpE,EAAE;;AAGJ,MAAa,gBAAgB,WAC3B,WAAW,KAAA,IAAY,KAAK,IAAI,OAAO,KAAK,GAAG,EAAE;;AAGnD,MAAa,mBAAmB,KAAsB,SACpD,GAAG,IAAI,cAAc,0BAA0B,aAAa;;AAG9D,MAAa,UAAU,SAAiB,UAAgD;CACtF,kBAAkB;CAClB,GAAG;AACL;;AAGA,MAAa,iBAAiB,QAAgB,UAAuB,CAAC,MACpE,IAAI,SAAS,MAAM;CAAE;CAAQ;AAAQ,CAAC;;AAWxC,MAAa,cACX,SACA,QACA,MACA,YAEA,aAAa,QAAQ,EACnB,OAAO;CACL;CACA;CACA,YAAY;EACV,MAAM,QAAQ;EACd,cAAc,QAAQ;EACtB,qBAAqB,QAAQ;CAC/B;AACF,EACF,CAAC;AAEH,MAAa,UAAU,OAAe,UAA0B,OAAO,KAAK,EAAE,SAAS,OAAO,GAAG;;AAGjG,MAAa,sBAAsB,QACjC,2BAA2B,OAAO,MAAM,cAAmB,EAAE;AAE/D,MAAM,yBAAyB;;AAG/B,MAAa,gBACX,KACA,KACA,oBACiB;CACjB,MAAM,YAAY,mBAAmB,GAAG;CAExC,OAAO;EACL,uBAAM,IAAI,KAAK,KAAK,MAAM,MAAM,GAAI,IAAI,GAAI,GAAE,YAAY,EAAE,MAAM,GAAG,EAAE;EACvE;EACA,iBACE,oBAAoB,QAAQ,uBAAuB,KAAK,eAAe,IACnE,kBACA;CACR;AACF;AAUA,MAAM,WAAW,UACf,MAAM,UAAU,KAAK,MAAM,WAAW,IAAG,KAAK,MAAM,SAAS,IAAG,IAAI,MAAM,MAAM,GAAG,EAAE,IAAI;;AAG3F,MAAa,oBAAoB,WAAuC;CACtE,IAAI,cAAc;CAClB,IAAI;CAEJ,KAAK,MAAM,SAAS,UAAU,IAAI,MAAM,GAAG,GAAG;EAC5C,MAAM,YAAY,KAAK,QAAQ,GAAG;EAClC,MAAM,QAAQ,cAAc,KAAK,OAAO,KAAK,MAAM,GAAG,SAAS,GAAG,KAAK,EAAE,YAAY;EACrF,MAAM,QAAQ,cAAc,KAAK,KAAK,QAAQ,KAAK,MAAM,YAAY,CAAC,EAAE,KAAK,CAAC;EAE9E,IAAI,SAAS,YAAY,MAAM,YAAY,MAAM,eAAe,cAAc;EAE9E,IAAI,SAAS,oBAAoB,WAAW;CAC9C;CAEA,OAAO;EAAE;EAAa;CAAS;AACjC;AA+EA,MAAa,gBAAgB,UAC3B,UAAU,KAAA,KAAa,UAAU,QAAQ,UAAU,SAAS,KAAK,KAAK,CAAC,MAAM,QAAQ,KAAK;AAE5F,MAAM,iBAAiB,OAAO,oBAAoB,OAAO,eAAe,OAAO,IAAI,CAAC;;AAGpF,MAAa,iBAAiB,SAA0C;CACtE,MAAM,SAAS,eAAe,IAAI;CAElC,OAAO,OAAO,UAAU,MAAM,IAAI,OAAO,UAAU,KAAA;AACrD;;AAGA,MAAa,eACX,OACA,YACqC;CACrC,MAAM,UAAU,QAAQ,OAAO,UAAU,IAAI,YAAY;CACzD,MAAM,OAAO,MAAM;CAEnB,OAAO;EAAC,KAAK;EAAI,KAAK;EAAM,KAAK;CAAiB,EAAE,MAClD,cAAa,UAAU,YAAY,MAAM,MAC3C,IACI,OACA,QAAQ,MAAM,KAAK,MAAM,aAAa,gDAAgD;AAC5F;;AAGA,MAAa,kBACX,SACA,YACiD;CACjD,MAAM,MAAM,QAAQ,MAAM,IAAI,SAAS;CAEvC,IAAI,QAAQ,MAAM,OAAO,KAAA;CAEzB,MAAM,SAAS,IAAI,MAAM,GAAG,EAAE,KAAI,UAAS,MAAM,KAAK,CAAC;CACvD,MAAM,UAAU,OAAO,MAAK,UAAS,CAAC,QAAQ,SAAS,KAAK,CAAC;CAE7D,OAAO,YAAY,KAAA,IACf,SACA,QAAQ,MACN,KACA,MAAM,kBACN,6BAA6B,QAAQ,oCACvC;AACN;;AAGA,MAAM,iBAAwC;CAC5C;CACA;CACA;CACA;AACF;;AAGA,MAAa,WACX,MACA,WAEA,WAAW,KAAA,IACP,OACA,OAAO,YACL,OAAO,QAAQ,IAAI,EAAE,QAAQ,CAAC,SAAS,eAAe,SAAS,GAAG,KAAK,OAAO,SAAS,GAAG,CAAC,CAC7F;AAEN,MAAM,gBACJ,SACA,KACA,SACA,YACkC;CAClC,MAAM,MAAM,QAAQ,MAAM,IAAI,GAAG;CAEjC,IAAI,QAAQ,MAAM,OAAO,KAAA;CAEzB,MAAM,QAAQ,OAAO,GAAG;CAExB,OAAO,QAAQ,KAAK,GAAG,KAAK,SAAS,WAAW,SAAS,UACrD,QACA,QAAQ,MACN,KACA,MAAM,gBACN,cAAc,IAAI,2BAA2B,QAAQ,MAAM,QAAQ,EACrE;AACN;;;;;;AAOA,MAAM,eAAe,SAAuB,WAAsC;CAChF,MAAM,MAAM,aAAa,SAAS,QAAQ,GAAG,OAAO,gBAAgB;CAEpE,IAAI,eAAe,UAAU,OAAO;CAEpC,IAAI,QAAQ,KAAA,GACV,OAAO,YAAY,SAAS,4DAA4D;CAG1F,OAAO,MAAM,SACT,YACE,SACA,cAAc,OAAO,6EACvB,IACA;AACN;;;;;AAaA,MAAa,UACX,OACA,SACA,WACuB;CACvB,MAAM,MAAM,YAAY,SAAS,MAAM;CAEvC,IAAI,eAAe,UAAU,OAAO;CAEpC,MAAM,OAAO,aAAa,SAAS,SAAS,GAAG,OAAO,gBAAgB;CAEtE,IAAI,gBAAgB,UAAU,OAAO;CAErC,MAAM,QAAQ,QAAQ;CACtB,MAAM,MAAM,QAAQ;CAEpB,OAAO;EACL,OAAO,MAAM,MAAM,OAAO,GAAG;EAC7B;EACA,UAAU,MAAM,MAAM,SAAS,MAAM,KAAA;CACvC;AACF;;;;;;;AAQA,MAAa,cACX,OACA,SACA,WACgC;CAChC,MAAM,MAAM,YAAY,SAAS,MAAM;CAEvC,IAAI,eAAe,UAAU,OAAO;CAEpC,OAAO,MAAM,SAAS,MAClB,YACE,SACA,mBAAmB,IAAI,mDACzB,IACA;AACN;;;;;;;AAQA,MAAa,cACX,KACA,SACA,MACA,YACuB;CACvB,IAAI,KAAK,aAAa,KAAA,KAAa,IAAI,OAAO,cAAc,OAAO,KAAA;CAEnE,MAAM,SAAS,IAAI,gBAAgB;CAEnC,KAAK,MAAM,OAAO,SAAS;EACzB,MAAM,QAAQ,QAAQ,MAAM,IAAI,GAAG;EAEnC,IAAI,UAAU,MAAM,OAAO,IAAI,KAAK,KAAK;CAC3C;CAEA,OAAO,IAAI,QAAQ,OAAO,KAAK,GAAG,CAAC;CACnC,OAAO,IAAI,SAAS,OAAO,KAAK,QAAQ,CAAC;CAEzC,OAAO,GAAG,IAAI,cAAc,QAAQ,KAAK,GAAG,OAAO,SAAS;AAC9D;;AAGA,MAAa,cACX,SACA,OACA,aAEA,aAAa,KAAA,IACT;CAAE,kBAAkB;CAAS;AAAM,IACnC;CAAE,kBAAkB;CAAS;CAAO,mBAAmB;AAAS;;AAGtE,MAAa,cACX,SACA,YACiC;CACjC,IAAI,CAAC,aAAa,QAAQ,IAAI,GAC5B,OAAO,QAAQ,MACb,KACA,MAAM,aACN,oDACF;CAGF,MAAM,UAAU,OAAO,KAAK,QAAQ,IAAI,EAAE,MAAK,QAAO,CAAC,QAAQ,SAAS,GAAG,CAAC;CAE5E,OAAO,YAAY,KAAA,IACf,QAAQ,OACR,QAAQ,MACN,KACA,MAAM,kBACN,wBAAwB,QAAQ,mCAClC;AACN;;AAGA,MAAa,gBAAgB,SAAuB,YAClD,QAAQ,MAAM,KAAK,MAAM,gBAAgB,cAAc,SAAS;;AAGlE,MAAa,eAAe,SAAuB,YACjD,QAAQ,MAAM,KAAK,MAAM,kBAAkB,cAAc,SAAS;;;;;AAMpE,MAAa,gBACX,SACA,OACA,SACA,aACiC;CACjC,IAAI,CAAC,aAAa,KAAK,GAAG,OAAO,aAAa,SAAS,YAAY,SAAS,EAAE;CAE9E,MAAM,UAAU,OAAO,KAAK,KAAK,EAAE,MAAK,QAAO,CAAC,QAAQ,SAAS,GAAG,CAAC;CAErE,OAAO,YAAY,KAAA,IACf,QACA,YAAY,SAAS,aAAa,QAAQ,uBAAuB,SAAS,EAAE;AAClF;;;;;AAMA,MAAa,YACX,SACA,UACsB;CACtB,MAAM,OAAO,aACX,SACA,OACA,CAAC,eAAe,SAAS,GACzB,+BACF;CAEA,IAAI,gBAAgB,UAAU,OAAO;CAErC,IAAI,CAAC,UAAU,SAAS,KAAK,WAAW,KAAK,CAAC,UAAU,SAAS,KAAK,OAAO,GAC3E,OAAO,aAAa,SAAS,2DAA2D;CAG1F,OAAO,KAAK,YAAY,YAAY,MAAM,SACtC,KAAK,UACL,YAAY,SAAS,oBAAoB,KAAK,YAAY,8BAA8B;AAC9F;;AAGA,MAAa,gBAAgB,yBAC3B,IAAI,KAAK,KAAK,MAAM,IAAI,IAAI,IAAI,GAAI,IAAI,GAAI,GAAE,YAAY,EAAE,QAAQ,SAAS,GAAG;;AAGlF,MAAa,iBAAiB,OAA+B,WAA2B;CACtF,MAAM,SAAS,MAAM,SAAS;CAE9B,MAAM,WAAW;EAAE,GAAG,MAAM;EAAU,qBAAqB,SAAS;CAAE;CAEtE,OAAO,GAAG,SAAS,OAAO,QAAQ,CAAC;AACrC;;AAGA,MAAa,gBAAgB,SAC3B,KAAK,KAAK,YAAY,EAAE,QAAQ,cAAc,GAAG"}

package/dist/microsoft/mail.d.mts

@@ -0,0 +1,48 @@
+import { RouteHandler } from "./graph.mjs";
+
+//#region src/microsoft/mail.d.ts
+/**
+ * `GET /users/{userId}/mailFolders/{folderId}/messages`: newest `receivedDateTime` first, one
+ * `$top`/`$skip` page with an opaque `@odata.nextLink` on the configured Graph origin. The folder
+ * is named by id (a well-known name or an unknown id is not emulated), and `$top` is required, at
+ * most `folderMessagesMaxTop`, as the paging fixture sends it.
+ */
+declare const listFolderMessages: RouteHandler;
+/**
+ * `POST /users/{userId}/messages`: a new draft in Drafts (201 with the message). Never sent. New
+ * drafts have no attachments (`hasAttachments: false`, as the fixtures record).
+ */
+declare const createDraft: RouteHandler;
+/**
+ * `PATCH /users/{userId}/messages/{messageId}`: update a draft's `subject` or `isRead`; 200 with
+ * the message.
+ */
+declare const updateMessage: RouteHandler;
+/**
+ * `POST /users/{userId}/messages/{messageId}/move` with `{ destinationId: 'deleteditems' }`, the
+ * only destination a fixture sends: 201 with the moved draft, which keeps its (immutable) id. Any
+ * other destination (another well-known name such as `inbox` or `drafts`, or a folder id) is not
+ * emulated (400) and moves nothing.
+ */
+declare const moveMessage: RouteHandler;
+/**
+ * `GET /users/{userId}/messages/{messageId}/attachments`: every attachment, inline ones included,
+ * in one response (the fixtures send only `$select`: no `$top`, `$skip`, or `@odata.nextLink`).
+ * `$select` accepts only base `attachment` properties, so a listing never carries `contentId`.
+ */
+declare const listAttachments: RouteHandler;
+/** `GET /users/{userId}/messages/{messageId}/attachments/{attachmentId}`: the file attachment. */
+declare const getAttachment: RouteHandler;
+/**
+ * `POST /$batch`: at most 20 subrequests with unique ids, each a message `permanentDelete` with
+ * `Prefer: IdType="ImmutableId"`, answered `{ responses: [{ id, status: 204, headers: {} }] }` as
+ * the fixtures record. Every subrequest is checked before any runs: anything else (another
+ * route, an unknown user or message, a message named twice, a message with a write in flight, a
+ * message that is not a draft, or one with attachments) refuses the whole batch with 400 and
+ * deletes nothing, because no fixture records a failed subrequest or deletes anything but a
+ * case-created draft (which has no attachments).
+ */
+declare const batch: RouteHandler;
+//#endregion
+export { batch, createDraft, getAttachment, listAttachments, listFolderMessages, moveMessage, updateMessage };
+//# sourceMappingURL=mail.d.mts.map

package/dist/microsoft/mail.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.d.mts","names":[],"sources":["../../src/microsoft/mail.ts"],"mappings":";;;;;AAqOA;;;;cAAa,kBAAA,EAAoB,YAiDhC;AA2HD;;;;AAAA,cAAa,WAAA,EAAa,YAgEzB;AAoBD;;;;AAAA,cAAa,aAAA,EAAe,YAqC3B;AAQD;;;;AAiDC;AAoCD;AArFA,cAAa,WAAA,EAAa,YAiDzB;;;AAoEA;AAGD;;cAnCa,eAAA,EAAiB,YAgC7B;;cAGY,aAAA,EAAe,YA2B3B;AA4ED;;;;AA+EC;;;;;AA/ED,cAAa,KAAA,EAAO,YA+EnB"}