@yolk-sdk/emulators 0.1.0-canary.96

package/dist/microsoft/api.mjs

@@ -0,0 +1,178 @@
+import { answeredOutsideCore, handlerFailedResponse } from "../emulator-http.mjs";
+import { codes, decodeSegment, errorContext, graphError, microsoftEmulatorBasePath, parseJsonText, parsePreferences } from "./graph.mjs";
+import { calendarView, cancelEvent, createEvent, deleteEvent, getEvent, updateEvent } from "./calendar.mjs";
+import { copyItem, copyMonitor, createFolder, deleteItem, getItem, listChildren } from "./drive.mjs";
+import { batch, createDraft, getAttachment, listAttachments, listFolderMessages, moveMessage, updateMessage } from "./mail.mjs";
+//#region src/microsoft/api.ts
+const listRangeCase = "microsoft.calendar.list-range-returns-events";
+const precisionCase = "microsoft.calendar.timestamp-precision";
+const createEventCase = "microsoft.calendar.create-returns-event-id";
+const cancelCase = "microsoft.calendar.cancel-semantics";
+const attachmentsCase = "microsoft.outlook.attachments-listing";
+const contentIdCase = "microsoft.outlook.attachment-content-id";
+const pagingCase = "microsoft.outlook.paging-next-link";
+const immutableIdCase = "microsoft.outlook.immutable-id-survives-move";
+const concurrentCase = "microsoft.outlook.concurrent-writes-same-message";
+const folderCase = "microsoft.onedrive.create-folder-roundtrip";
+const copyCase = "microsoft.onedrive.copy-accepted-monitor";
+const route = (method, path, write, caseIds, handler, queryKeys = [], auth = true) => ({
+	method,
+	path,
+	kind: "connector",
+	write,
+	caseIds,
+	evidence: "unverified",
+	queryKeys,
+	auth,
+	handler
+});
+const graph = (path) => `${microsoftEmulatorBasePath}${path}`;
+/** Folder message listing: the paging fixture's `$select`, `$top`, and `$skip`. */
+const paging = [
+	"$select",
+	"$top",
+	"$skip"
+];
+/** Calendar views and children listings: their fixtures send `$select` and `$top`, never `$skip`. */
+const onePage = ["$select", "$top"];
+/** The route table: evidence plus handler. `microsoftEmulatorRoutes` is its evidence part. */
+const microsoftApiRoutes = [
+	route("GET", graph("/users/{userId}/calendars/{calendarId}/calendarView"), false, [listRangeCase, precisionCase], calendarView, [
+		"startDateTime",
+		"endDateTime",
+		...onePage
+	]),
+	route("POST", graph("/users/{userId}/calendars/{calendarId}/events"), true, [createEventCase, cancelCase], createEvent),
+	route("GET", graph("/users/{userId}/events/{eventId}"), false, [
+		precisionCase,
+		createEventCase,
+		cancelCase
+	], getEvent, ["$select"]),
+	route("PATCH", graph("/users/{userId}/events/{eventId}"), true, [createEventCase], updateEvent),
+	route("DELETE", graph("/users/{userId}/events/{eventId}"), true, [createEventCase, cancelCase], deleteEvent),
+	route("POST", graph("/users/{userId}/events/{eventId}/cancel"), true, [cancelCase], cancelEvent),
+	route("GET", graph("/users/{userId}/mailFolders/{folderId}/messages"), false, [pagingCase], listFolderMessages, paging),
+	route("POST", graph("/users/{userId}/messages"), true, [immutableIdCase, concurrentCase], createDraft),
+	route("PATCH", graph("/users/{userId}/messages/{messageId}"), true, [immutableIdCase, concurrentCase], updateMessage),
+	route("POST", graph("/users/{userId}/messages/{messageId}/move"), true, [immutableIdCase], moveMessage),
+	route("GET", graph("/users/{userId}/messages/{messageId}/attachments"), false, [attachmentsCase, contentIdCase], listAttachments, ["$select"]),
+	route("GET", graph("/users/{userId}/messages/{messageId}/attachments/{attachmentId}"), false, [attachmentsCase, contentIdCase], getAttachment),
+	route("POST", graph("/$batch"), true, [immutableIdCase, concurrentCase], batch),
+	route("GET", graph("/drives/{driveId}/items/{itemId}"), false, [folderCase, copyCase], getItem, ["$select"]),
+	route("GET", graph("/drives/{driveId}/items/{itemId}/children"), false, [folderCase, copyCase], listChildren, onePage),
+	route("POST", graph("/drives/{driveId}/items/{itemId}/children"), true, [folderCase, copyCase], createFolder),
+	route("DELETE", graph("/drives/{driveId}/items/{itemId}"), true, [folderCase, copyCase], deleteItem),
+	route("POST", graph("/drives/{driveId}/items/{itemId}/copy"), true, [copyCase], copyItem, ["@microsoft.graph.conflictBehavior"]),
+	route("GET", "/personal/{site}/_api/v2.0/monitor/{monitorId}", false, [copyCase], copyMonitor, [], false)
+];
+const templatePattern = (template) => new RegExp(`^${template.split(/(\{[A-Za-z]+\})/).map((part) => /^\{[A-Za-z]+\}$/.test(part) ? "([^/]+)" : part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("")}$`);
+const templateNames = (template) => [...template.matchAll(/\{([A-Za-z]+)\}/g)].map((match) => match[1] ?? "");
+const compiledRoutes = microsoftApiRoutes.map((candidate) => ({
+	route: candidate,
+	pattern: templatePattern(candidate.path),
+	names: templateNames(candidate.path)
+}));
+/**
+* The route answering `method` + raw (percent-encoded) `path` with its decoded parameters, or
+* `undefined` (fail closed; also for a parameter that is not valid percent-encoding).
+*/
+const matchMicrosoftRoute = (method, path) => {
+	for (const candidate of compiledRoutes) {
+		if (candidate.route.method !== method.toUpperCase()) continue;
+		const match = candidate.pattern.exec(path);
+		if (match === null) continue;
+		const params = {};
+		for (const [index, name] of candidate.names.entries()) {
+			const value = decodeSegment(match[index + 1] ?? "");
+			if (value === void 0) return void 0;
+			params[name] = value;
+		}
+		return {
+			route: candidate.route,
+			params
+		};
+	}
+};
+/** Header the wrapper sets on core requests: the ledger sequence number (for error ids). */
+const requestSeqHeader = "x-emulator-request-seq";
+const delay = (ms) => new Promise((resolve) => {
+	setTimeout(resolve, ms);
+});
+/** The first query key the route does not emulate, or `undefined`. */
+const unsupportedQueryKey = (query, allowed) => [...query.keys()].find((candidate) => !allowed.includes(candidate));
+/** `{Name}` path templates become `:Name` core route parameters. */
+const corePath = (template) => template.replace(/\{([A-Za-z]+)\}/g, ":$1");
+/**
+* One core request: re-match, check the query allowlist and `If-Match`, then plan, fault, and
+* commit. The handler runs on drafts: a shallow copy of the state (handlers replace whole lists
+* and counters, never edit them in place) and copies of the copy monitors and their counter. A
+* refusal (any answer that is not 2xx) is sent as is and uses up no fault; a successful answer asks
+* `decideFault`, and only an unfaulted one commits the drafts (and then holds a written message
+* for `conflictWindowMs`). Plan, fault decision, and commit run synchronously together, so no
+* other request interleaves.
+*/
+const handle = async (raw, state, env, decideFault) => {
+	const url = new URL(raw.url);
+	const headers = raw.headers;
+	const seq = Number(headers.get("x-emulator-request-seq") ?? "0");
+	const error = (status, code, message) => graphError(errorContext(env.now(), Number.isSafeInteger(seq) ? seq : 0, headers.get("client-request-id")), status, code, message);
+	const matched = matchMicrosoftRoute(raw.method, url.pathname);
+	if (matched === void 0) return error(404, codes.unknownRoute, "Synthetic: no emulated Microsoft Graph route.");
+	const unsupported = unsupportedQueryKey(url.searchParams, matched.route.queryKeys);
+	if (unsupported !== void 0) return error(400, codes.unsupportedQuery, `Synthetic: query parameter ${unsupported} is not emulated on this route.`);
+	if (headers.has("if-match")) return error(400, codes.unsupportedValue, "Synthetic: conditional requests (If-Match) are not emulated.");
+	const text = await raw.text();
+	const request = {
+		params: matched.params,
+		path: url.pathname,
+		query: url.searchParams,
+		body: text === "" ? void 0 : parseJsonText(text),
+		prefer: parsePreferences(headers.get("prefer")),
+		error
+	};
+	const draft = { ...state };
+	const monitors = new Map([...env.monitors].map(([id, monitor]) => [id, { ...monitor }]));
+	const monitorCounter = { next: env.monitorCounter.next };
+	const answer = matched.route.handler(draft, request, {
+		...env,
+		monitors,
+		monitorCounter
+	});
+	const response = answer instanceof Response ? answer : answer.response;
+	if (!response.ok) return response;
+	if (decideFault(headers.get("x-emulator-job-id"))) return answeredOutsideCore();
+	Object.assign(state, draft);
+	env.monitors.clear();
+	for (const [id, monitor] of monitors) env.monitors.set(id, monitor);
+	env.monitorCounter.next = monitorCounter.next;
+	if (answer instanceof Response) return answer;
+	env.messageLocks.add(answer.holds);
+	try {
+		if (env.conflictWindowMs > 0) await delay(env.conflictWindowMs);
+		return answer.response;
+	} finally {
+		env.messageLocks.delete(answer.holds);
+	}
+};
+/**
+* Register every route of the table on the core app, over the generation's state. Each handler
+* re-matches the raw request path against the same table the wrapper ledgers (so parameters are
+* decoded once, failing closed on invalid percent-encoding), checks the route's query allowlist
+* and refuses `If-Match` (no fixture sends one) before the handler runs, then plans, faults, and
+* commits (see `handle`). A handler that throws answers `handlerFailedResponse()` (nothing
+* written), which the wrapper turns into its Graph error envelope 500 with `responseError` in the
+* ledger.
+*/
+const registerMicrosoftApi = (app, state, env, decideFault) => {
+	for (const apiRoute of microsoftApiRoutes) app.on(apiRoute.method, corePath(apiRoute.path), async (context) => {
+		try {
+			return await handle(context.req.raw, state, env, decideFault);
+		} catch {
+			return handlerFailedResponse();
+		}
+	});
+};
+//#endregion
+export { matchMicrosoftRoute, microsoftApiRoutes, microsoftEmulatorBasePath, registerMicrosoftApi, requestSeqHeader };
+
+//# sourceMappingURL=api.mjs.map

package/dist/microsoft/api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.mjs","names":[],"sources":["../../src/microsoft/api.ts"],"sourcesContent":["/**\n * Microsoft Graph emulator API: the route table (with its evidence and query allowlist), route\n * matching, and the registration of the stateful handlers on the `@emulators/core` app\n * (internal; re-exported by `src/microsoft.ts`).\n *\n * Only the routes the eleven Microsoft conformance cases need are emulated, plus the copy monitor\n * URL they require; everything else fails closed. Each route lists the cases whose claims it\n * follows.\n *\n * @experimental\n */\nimport type { Hono } from '@emulators/core'\nimport { answeredOutsideCore, emulatorJobHeader, handlerFailedResponse } from '../emulator-http.ts'\nimport type { EmulatorRouteEvidence } from '../route-evidence.ts'\nimport {\n  calendarView,\n  cancelEvent,\n  createEvent,\n  deleteEvent,\n  getEvent,\n  updateEvent\n} from './calendar.ts'\nimport { copyItem, copyMonitor, createFolder, deleteItem, getItem, listChildren } from './drive.ts'\nimport {\n  codes,\n  decodeSegment,\n  errorContext,\n  graphError,\n  microsoftEmulatorBasePath,\n  parseJsonText,\n  parsePreferences,\n  type MicrosoftApiEnv,\n  type RouteHandler,\n  type RouteRequest\n} from './graph.ts'\nimport {\n  batch,\n  createDraft,\n  getAttachment,\n  listAttachments,\n  listFolderMessages,\n  moveMessage,\n  updateMessage\n} from './mail.ts'\nimport type { MicrosoftEmulatorState } from './state.ts'\n\nexport { microsoftEmulatorBasePath } from './graph.ts'\n\ntype MicrosoftApiRoute = EmulatorRouteEvidence & {\n  /**\n   * Query parameters the route emulates; any other key answers 400 before the handler runs, so\n   * a rejected request never writes. Empty by default.\n   */\n  readonly queryKeys: ReadonlyArray<string>\n  /** `false` only for the copy monitor, a pre-authenticated capability URL. */\n  readonly auth: boolean\n  readonly handler: RouteHandler\n}\n\nconst listRangeCase = 'microsoft.calendar.list-range-returns-events'\n\nconst precisionCase = 'microsoft.calendar.timestamp-precision'\n\nconst createEventCase = 'microsoft.calendar.create-returns-event-id'\n\nconst cancelCase = 'microsoft.calendar.cancel-semantics'\n\nconst attachmentsCase = 'microsoft.outlook.attachments-listing'\n\nconst contentIdCase = 'microsoft.outlook.attachment-content-id'\n\nconst pagingCase = 'microsoft.outlook.paging-next-link'\n\nconst immutableIdCase = 'microsoft.outlook.immutable-id-survives-move'\n\nconst concurrentCase = 'microsoft.outlook.concurrent-writes-same-message'\n\nconst folderCase = 'microsoft.onedrive.create-folder-roundtrip'\n\nconst copyCase = 'microsoft.onedrive.copy-accepted-monitor'\n\nconst route = (\n  method: string,\n  path: string,\n  write: boolean,\n  caseIds: ReadonlyArray<string>,\n  handler: RouteHandler,\n  queryKeys: ReadonlyArray<string> = [],\n  auth = true\n): MicrosoftApiRoute => ({\n  method,\n  path,\n  kind: 'connector',\n  write,\n  caseIds,\n  evidence: 'unverified',\n  queryKeys,\n  auth,\n  handler\n})\n\nconst graph = (path: string) => `${microsoftEmulatorBasePath}${path}`\n\n/** Folder message listing: the paging fixture's `$select`, `$top`, and `$skip`. */\nconst paging: ReadonlyArray<string> = ['$select', '$top', '$skip']\n\n/** Calendar views and children listings: their fixtures send `$select` and `$top`, never `$skip`. */\nconst onePage: ReadonlyArray<string> = ['$select', '$top']\n\n/** The route table: evidence plus handler. `microsoftEmulatorRoutes` is its evidence part. */\nexport const microsoftApiRoutes: ReadonlyArray<MicrosoftApiRoute> = [\n  route(\n    'GET',\n    graph('/users/{userId}/calendars/{calendarId}/calendarView'),\n    false,\n    [listRangeCase, precisionCase],\n    calendarView,\n    ['startDateTime', 'endDateTime', ...onePage]\n  ),\n  route(\n    'POST',\n    graph('/users/{userId}/calendars/{calendarId}/events'),\n    true,\n    [createEventCase, cancelCase],\n    createEvent\n  ),\n  route(\n    'GET',\n    graph('/users/{userId}/events/{eventId}'),\n    false,\n    [precisionCase, createEventCase, cancelCase],\n    getEvent,\n    ['$select']\n  ),\n  route('PATCH', graph('/users/{userId}/events/{eventId}'), true, [createEventCase], updateEvent),\n  route(\n    'DELETE',\n    graph('/users/{userId}/events/{eventId}'),\n    true,\n    [createEventCase, cancelCase],\n    deleteEvent\n  ),\n  route('POST', graph('/users/{userId}/events/{eventId}/cancel'), true, [cancelCase], cancelEvent),\n  route(\n    'GET',\n    graph('/users/{userId}/mailFolders/{folderId}/messages'),\n    false,\n    [pagingCase],\n    listFolderMessages,\n    paging\n  ),\n  route(\n    'POST',\n    graph('/users/{userId}/messages'),\n    true,\n    [immutableIdCase, concurrentCase],\n    createDraft\n  ),\n  route(\n    'PATCH',\n    graph('/users/{userId}/messages/{messageId}'),\n    true,\n    [immutableIdCase, concurrentCase],\n    updateMessage\n  ),\n  route(\n    'POST',\n    graph('/users/{userId}/messages/{messageId}/move'),\n    true,\n    [immutableIdCase],\n    moveMessage\n  ),\n  route(\n    'GET',\n    graph('/users/{userId}/messages/{messageId}/attachments'),\n    false,\n    [attachmentsCase, contentIdCase],\n    listAttachments,\n    ['$select']\n  ),\n  route(\n    'GET',\n    graph('/users/{userId}/messages/{messageId}/attachments/{attachmentId}'),\n    false,\n    [attachmentsCase, contentIdCase],\n    getAttachment\n  ),\n  route('POST', graph('/$batch'), true, [immutableIdCase, concurrentCase], batch),\n  route('GET', graph('/drives/{driveId}/items/{itemId}'), false, [folderCase, copyCase], getItem, [\n    '$select'\n  ]),\n  route(\n    'GET',\n    graph('/drives/{driveId}/items/{itemId}/children'),\n    false,\n    [folderCase, copyCase],\n    listChildren,\n    onePage\n  ),\n  route(\n    'POST',\n    graph('/drives/{driveId}/items/{itemId}/children'),\n    true,\n    [folderCase, copyCase],\n    createFolder\n  ),\n  route(\n    'DELETE',\n    graph('/drives/{driveId}/items/{itemId}'),\n    true,\n    [folderCase, copyCase],\n    deleteItem\n  ),\n  route('POST', graph('/drives/{driveId}/items/{itemId}/copy'), true, [copyCase], copyItem, [\n    '@microsoft.graph.conflictBehavior'\n  ]),\n  route(\n    'GET',\n    '/personal/{site}/_api/v2.0/monitor/{monitorId}',\n    false,\n    [copyCase],\n    copyMonitor,\n    [],\n    false\n  )\n]\n\nconst templatePattern = (template: string): RegExp =>\n  new RegExp(\n    `^${template\n      .split(/(\\{[A-Za-z]+\\})/)\n      .map(part =>\n        /^\\{[A-Za-z]+\\}$/.test(part) ? '([^/]+)' : part.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')\n      )\n      .join('')}$`\n  )\n\nconst templateNames = (template: string): ReadonlyArray<string> =>\n  [...template.matchAll(/\\{([A-Za-z]+)\\}/g)].map(match => match[1] ?? '')\n\nconst compiledRoutes = microsoftApiRoutes.map(candidate => ({\n  route: candidate,\n  pattern: templatePattern(candidate.path),\n  names: templateNames(candidate.path)\n}))\n\nexport type MatchedRoute = {\n  readonly route: MicrosoftApiRoute\n  /** Decoded path parameters. */\n  readonly params: Readonly<Record<string, string>>\n}\n\n/**\n * The route answering `method` + raw (percent-encoded) `path` with its decoded parameters, or\n * `undefined` (fail closed; also for a parameter that is not valid percent-encoding).\n */\nexport const matchMicrosoftRoute = (method: string, path: string): MatchedRoute | undefined => {\n  for (const candidate of compiledRoutes) {\n    if (candidate.route.method !== method.toUpperCase()) continue\n\n    const match = candidate.pattern.exec(path)\n\n    if (match === null) continue\n\n    const params: Record<string, string> = {}\n\n    for (const [index, name] of candidate.names.entries()) {\n      const value = decodeSegment(match[index + 1] ?? '')\n\n      if (value === undefined) return undefined\n\n      params[name] = value\n    }\n\n    return { route: candidate.route, params }\n  }\n\n  return undefined\n}\n\n/** Header the wrapper sets on core requests: the ledger sequence number (for error ids). */\nexport const requestSeqHeader = 'x-emulator-request-seq'\n\n/**\n * The wrapper's fault decision for the core request of job `jobId` (its `emulatorJobHeader`),\n * asked only once the route would answer successfully: `true` when a fault answers instead (it is\n * used up, and the wrapper sends its answer), `false` when none applies.\n */\nexport type MicrosoftFaultDecision = (jobId: string | null) => boolean\n\nconst delay = (ms: number): Promise<void> =>\n  new Promise(resolve => {\n    setTimeout(resolve, ms)\n  })\n\n/** The first query key the route does not emulate, or `undefined`. */\nconst unsupportedQueryKey = (\n  query: URLSearchParams,\n  allowed: ReadonlyArray<string>\n): string | undefined => [...query.keys()].find(candidate => !allowed.includes(candidate))\n\n/** `{Name}` path templates become `:Name` core route parameters. */\nconst corePath = (template: string): string => template.replace(/\\{([A-Za-z]+)\\}/g, ':$1')\n\n/**\n * One core request: re-match, check the query allowlist and `If-Match`, then plan, fault, and\n * commit. The handler runs on drafts: a shallow copy of the state (handlers replace whole lists\n * and counters, never edit them in place) and copies of the copy monitors and their counter. A\n * refusal (any answer that is not 2xx) is sent as is and uses up no fault; a successful answer asks\n * `decideFault`, and only an unfaulted one commits the drafts (and then holds a written message\n * for `conflictWindowMs`). Plan, fault decision, and commit run synchronously together, so no\n * other request interleaves.\n */\nconst handle = async (\n  raw: Request,\n  state: MicrosoftEmulatorState,\n  env: MicrosoftApiEnv,\n  decideFault: MicrosoftFaultDecision\n): Promise<Response> => {\n  const url = new URL(raw.url)\n  const headers = raw.headers\n  const seq = Number(headers.get(requestSeqHeader) ?? '0')\n\n  // Built on demand, so the clock is read only when an error is answered.\n  const error = (status: number, code: string, message: string) =>\n    graphError(\n      errorContext(\n        env.now(),\n        Number.isSafeInteger(seq) ? seq : 0,\n        headers.get('client-request-id')\n      ),\n      status,\n      code,\n      message\n    )\n\n  const matched = matchMicrosoftRoute(raw.method, url.pathname)\n\n  if (matched === undefined) {\n    return error(404, codes.unknownRoute, 'Synthetic: no emulated Microsoft Graph route.')\n  }\n\n  const unsupported = unsupportedQueryKey(url.searchParams, matched.route.queryKeys)\n\n  if (unsupported !== undefined) {\n    return error(\n      400,\n      codes.unsupportedQuery,\n      `Synthetic: query parameter ${unsupported} is not emulated on this route.`\n    )\n  }\n\n  if (headers.has('if-match')) {\n    return error(\n      400,\n      codes.unsupportedValue,\n      'Synthetic: conditional requests (If-Match) are not emulated.'\n    )\n  }\n\n  const text = await raw.text()\n\n  const request: RouteRequest = {\n    params: matched.params,\n    path: url.pathname,\n    query: url.searchParams,\n    body: text === '' ? undefined : parseJsonText(text),\n    prefer: parsePreferences(headers.get('prefer')),\n    error\n  }\n\n  const draft: MicrosoftEmulatorState = { ...state }\n  const monitors = new Map([...env.monitors].map(([id, monitor]) => [id, { ...monitor }]))\n  const monitorCounter = { next: env.monitorCounter.next }\n  const answer = matched.route.handler(draft, request, { ...env, monitors, monitorCounter })\n  const response = answer instanceof Response ? answer : answer.response\n\n  if (!response.ok) return response\n\n  if (decideFault(headers.get(emulatorJobHeader))) return answeredOutsideCore()\n\n  Object.assign(state, draft)\n  env.monitors.clear()\n\n  for (const [id, monitor] of monitors) env.monitors.set(id, monitor)\n\n  env.monitorCounter.next = monitorCounter.next\n\n  if (answer instanceof Response) return answer\n\n  env.messageLocks.add(answer.holds)\n\n  try {\n    if (env.conflictWindowMs > 0) await delay(env.conflictWindowMs)\n\n    return answer.response\n  } finally {\n    env.messageLocks.delete(answer.holds)\n  }\n}\n\n/**\n * Register every route of the table on the core app, over the generation's state. Each handler\n * re-matches the raw request path against the same table the wrapper ledgers (so parameters are\n * decoded once, failing closed on invalid percent-encoding), checks the route's query allowlist\n * and refuses `If-Match` (no fixture sends one) before the handler runs, then plans, faults, and\n * commits (see `handle`). A handler that throws answers `handlerFailedResponse()` (nothing\n * written), which the wrapper turns into its Graph error envelope 500 with `responseError` in the\n * ledger.\n */\nexport const registerMicrosoftApi = (\n  app: Hono,\n  state: MicrosoftEmulatorState,\n  env: MicrosoftApiEnv,\n  decideFault: MicrosoftFaultDecision\n): void => {\n  for (const apiRoute of microsoftApiRoutes) {\n    app.on(apiRoute.method, corePath(apiRoute.path), async context => {\n      try {\n        return await handle(context.req.raw, state, env, decideFault)\n      } catch {\n        return handlerFailedResponse()\n      }\n    })\n  }\n}\n"],"mappings":"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"}

package/dist/microsoft/calendar.d.mts

@@ -0,0 +1,30 @@
+import { RouteHandler } from "./graph.mjs";
+
+//#region src/microsoft/calendar.d.ts
+/**
+ * `GET .../calendars/{calendarId}/calendarView?startDateTime=&endDateTime=`: the events that
+ * overlap `[start, end)` (start before the range end and end after the range start), ordered by
+ * start, at most `$top` of them (more is not emulated: no fixture pages a calendar view; `$top`
+ * is required, at most `calendarViewMaxTop`).
+ */
+declare const calendarView: RouteHandler;
+/**
+ * `POST .../calendars/{calendarId}/events`: create a single-instance, attendee-free event (201
+ * with the event; the `createOmitsId` drill knob drops its `id`).
+ */
+declare const createEvent: RouteHandler;
+/** `GET /users/{userId}/events/{eventId}` (`$select`). */
+declare const getEvent: RouteHandler;
+/** `PATCH /users/{userId}/events/{eventId}`: update `subject`; 200 with the event. */
+declare const updateEvent: RouteHandler;
+/** `DELETE /users/{userId}/events/{eventId}`: 204; later reads answer 404. */
+declare const deleteEvent: RouteHandler;
+/**
+ * `POST /users/{userId}/events/{eventId}/cancel` (`{ comment? }`): 202 with an empty body, and
+ * the event is removed (not kept with `isCancelled: true`), so a later GET or DELETE answers 404,
+ * as the cancel fixture records. The emulated events have no attendees: nothing is sent.
+ */
+declare const cancelEvent: RouteHandler;
+//#endregion
+export { calendarView, cancelEvent, createEvent, deleteEvent, getEvent, updateEvent };
+//# sourceMappingURL=calendar.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.mts","names":[],"sources":["../../src/microsoft/calendar.ts"],"mappings":";;;;;AA0IA;;;;cAAa,YAAA,EAAc,YA2D1B;AAmHD;;;;AAAA,cAAa,WAAA,EAAa,YA0DzB;AAGD;AAAA,cAAa,QAAA,EAAU,YAuBtB;;cAGY,WAAA,EAAa,YAmCzB;AAtCA;AAAA,cA6CY,WAAA,EAAa,YAgBzB;;;;AAvBA;AAOD;cAuBa,WAAA,EAAa,YA0BzB"}

package/dist/microsoft/calendar.mjs

@@ -0,0 +1,271 @@
+import { bodyObject, codes, collection, emptyResponse, entity, invalidValue, jsonResponse, metadataContext, nestedObject, nextChangeKey, notEmulated, nowTimestamp, odataKey, padded, project, resolveUser, selectSuffix, selectedFields, singlePage, textBody } from "./graph.mjs";
+import { formatLocalDateTime, parseInstant } from "./state.mjs";
+import { Predicate } from "effect";
+//#region src/microsoft/calendar.ts
+/**
+* Microsoft Graph emulator calendar routes (internal): `calendarView`, event create, get, update,
+* delete, and cancel. Wire shapes follow the synthetic calendar conformance fixtures.
+*
+* Event times are stored in UTC with seven fractional digits and answered in UTC. Every calendar
+* fixture sends `Prefer: outlook.timezone="UTC"`, so every calendar route needs it; without it, or
+* with another time zone, a request is refused (fail closed). Calendar views need `$top` and answer
+* one page (no `$skip`, no `@odata.nextLink`), as the fixtures record them. Events are answered with
+* the fixture fields only (`@odata.etag`, `id`, `subject`, `start`, `end`, `isCancelled`); a create
+* takes the fixture's fields (`subject`, a text `body`, `start`, `end`, `isReminderOn`, `showAs`)
+* and an update only `subject`; anything else, including unknown nested keys, fails closed.
+*
+* @experimental
+*/
+/** The event fields the fixtures answer (and `$select`). */
+const eventFields = [
+	"id",
+	"subject",
+	"start",
+	"end",
+	"isCancelled"
+];
+const showAsValues = [
+	"free",
+	"tentative",
+	"busy",
+	"oof",
+	"workingElsewhere",
+	"unknown"
+];
+const isShowAs = (value) => showAsValues.some((candidate) => candidate === value);
+const eventTagPrefix = "DwAAABYAAAAsynthetic";
+const renderDateTime = (env, value) => {
+	const ticks = parseInstant(value, "forbidden");
+	return {
+		dateTime: ticks === void 0 ? value : formatLocalDateTime(ticks, env.drills.timestampPrecisionDigits),
+		timeZone: "UTC"
+	};
+};
+/** The event as the fixtures answer it, in their key order. */
+const renderEvent = (env, event) => ({
+	"@odata.etag": `W/"${event.changeKey}"`,
+	id: event.id,
+	subject: event.subject,
+	start: renderDateTime(env, event.start),
+	end: renderDateTime(env, event.end),
+	isCancelled: event.isCancelled
+});
+/** `users('{userId}')`, the context prefix of every calendar route. */
+const userContext = (request) => `users${odataKey(request.params.userId ?? "")}`;
+/** `users('{userId}')/calendars('{calendarId}')`. */
+const calendarContext = (request) => `${userContext(request)}/calendars${odataKey(request.params.calendarId ?? "")}`;
+/**
+* Every calendar fixture sends `Prefer: outlook.timezone="UTC"`: a request without it, or with any
+* other time zone, is not emulated.
+*/
+const timezoneProblem = (request) => {
+	const timezone = request.prefer.timezone;
+	if (timezone === void 0) return notEmulated(request, "calendar requests without Prefer: outlook.timezone=\"UTC\" are not emulated.");
+	return timezone.toUpperCase() === "UTC" ? void 0 : notEmulated(request, `outlook.timezone ${timezone} is not emulated (UTC only).`);
+};
+/** `preference-applied` on reads (which asked for UTC), as the fixtures record it. */
+const readHeaders = { "preference-applied": "outlook.timezone=\"UTC\"" };
+const findCalendar = (state, request) => state.calendars.find((calendar) => calendar.id === request.params.calendarId);
+const calendarNotFound = (request) => request.error(404, codes.mailItemNotFound, "The specified object was not found in the store.");
+const eventNotFound = calendarNotFound;
+const findEvent = (state, request) => state.events.find((event) => event.id === request.params.eventId);
+/** Ticks of a stored UTC date-time (always readable: the state schema checks the pattern). */
+const ticksOf = (value) => parseInstant(value, "forbidden") ?? BigInt(0);
+/** The largest calendar view `$top` a fixture sends (`$top=50`, list-range and precision cases). */
+const calendarViewMaxTop = 50;
+/**
+* `GET .../calendars/{calendarId}/calendarView?startDateTime=&endDateTime=`: the events that
+* overlap `[start, end)` (start before the range end and end after the range start), ordered by
+* start, at most `$top` of them (more is not emulated: no fixture pages a calendar view; `$top`
+* is required, at most `calendarViewMaxTop`).
+*/
+const calendarView = (state, request, env) => {
+	const user = resolveUser(state, request);
+	if (user instanceof Response) return user;
+	const zone = timezoneProblem(request);
+	if (zone !== void 0) return zone;
+	if (findCalendar(state, request) === void 0) return calendarNotFound(request);
+	const rawStart = request.query.get("startDateTime");
+	const rawEnd = request.query.get("endDateTime");
+	if (rawStart === null || rawEnd === null) return invalidValue(request, "calendarView needs startDateTime and endDateTime.");
+	const start = parseInstant(rawStart, "optional");
+	const end = parseInstant(rawEnd, "optional");
+	if (start === void 0 || end === void 0) return invalidValue(request, "startDateTime and endDateTime must be ISO-8601 date-times.");
+	const fields = selectedFields(request, eventFields);
+	if (fields instanceof Response) return fields;
+	const page = singlePage(env.drills.calendarRangeEmpty ? [] : state.events.filter((event) => event.calendarId === request.params.calendarId && ticksOf(event.start) < end && ticksOf(event.end) > start).sort((left, right) => left.start === right.start ? left.id.localeCompare(right.id) : left.start < right.start ? -1 : 1), request, calendarViewMaxTop);
+	if (page instanceof Response) return page;
+	return jsonResponse(200, collection(metadataContext(env, `${calendarContext(request)}/calendarView${selectSuffix(fields)}`), page.map((event) => project(renderEvent(env, event), fields)), void 0), readHeaders);
+};
+/** A `dateTimeTimeZone` write value in UTC, as a seven-digit local date-time. */
+const writeDateTime = (request, key, value) => {
+	const dateTimeZone = nestedObject(request, value, ["dateTime", "timeZone"], `${key} { dateTime, timeZone }`);
+	if (dateTimeZone instanceof Response) return dateTimeZone;
+	const { dateTime, timeZone } = dateTimeZone;
+	if (!Predicate.isString(dateTime) || !Predicate.isString(timeZone)) return invalidValue(request, `${key} must be { dateTime, timeZone } with string values.`);
+	if (timeZone.toUpperCase() !== "UTC") return notEmulated(request, `${key}.timeZone ${timeZone} is not emulated (UTC only).`);
+	const ticks = parseInstant(dateTime, "forbidden");
+	return ticks === void 0 ? invalidValue(request, `${key}.dateTime must be a local date-time without offset.`) : formatLocalDateTime(ticks, 7);
+};
+/** Event create keys, as the create fixture sends them. */
+const createEventKeys = [
+	"subject",
+	"body",
+	"start",
+	"end",
+	"isReminderOn",
+	"showAs"
+];
+/** Event update keys, as the update fixture sends them. */
+const updateEventKeys = ["subject"];
+/** The emulated event fields of a create or update body; attendees and the rest fail closed. */
+const eventWrite = (request, allowed) => {
+	const fields = bodyObject(request, allowed);
+	if (fields instanceof Response) return fields;
+	const write = {};
+	for (const [key, value] of Object.entries(fields)) switch (key) {
+		case "subject":
+			if (!Predicate.isString(value)) return invalidValue(request, "subject must be a string.");
+			write.subject = value;
+			break;
+		case "body": {
+			const content = textBody(request, value);
+			if (content instanceof Response) return content;
+			write.bodyContent = content;
+			break;
+		}
+		case "start":
+		case "end": {
+			const dateTime = writeDateTime(request, key, value);
+			if (dateTime instanceof Response) return dateTime;
+			write[key] = dateTime;
+			break;
+		}
+		case "isReminderOn":
+			if (!Predicate.isBoolean(value)) return invalidValue(request, "isReminderOn must be a boolean.");
+			write.isReminderOn = value;
+			break;
+		case "showAs":
+			if (!isShowAs(value)) return invalidValue(request, "showAs is not a Graph freeBusyStatus.");
+			write.showAs = value;
+			break;
+	}
+	return write;
+};
+/**
+* `POST .../calendars/{calendarId}/events`: create a single-instance, attendee-free event (201
+* with the event; the `createOmitsId` drill knob drops its `id`).
+*/
+const createEvent = (state, request, env) => {
+	const user = resolveUser(state, request);
+	if (user instanceof Response) return user;
+	const zone = timezoneProblem(request);
+	if (zone !== void 0) return zone;
+	if (findCalendar(state, request) === void 0) return calendarNotFound(request);
+	const write = eventWrite(request, createEventKeys);
+	if (write instanceof Response) return write;
+	if (write.start === void 0 || write.end === void 0) return invalidValue(request, "a new event needs start and end.");
+	if (write.end < write.start) return invalidValue(request, "the event end is before its start.");
+	let number = state.counters.nextEventNumber;
+	let id = `AAMkAGI2-synthetic-event-${padded(number, 4)}=`;
+	while (state.events.some((event) => event.id === id)) {
+		number += 1;
+		id = `AAMkAGI2-synthetic-event-${padded(number, 4)}=`;
+	}
+	state.counters = {
+		...state.counters,
+		nextEventNumber: number + 1
+	};
+	const now = nowTimestamp(env);
+	const event = {
+		id,
+		calendarId: request.params.calendarId ?? "",
+		subject: write.subject ?? "",
+		bodyContentType: "text",
+		bodyContent: write.bodyContent ?? "",
+		start: write.start,
+		end: write.end,
+		isCancelled: false,
+		isReminderOn: write.isReminderOn ?? true,
+		showAs: write.showAs ?? "busy",
+		changeKey: nextChangeKey(state, eventTagPrefix),
+		createdDateTime: now,
+		lastModifiedDateTime: now
+	};
+	state.events = [...state.events, event];
+	const { id: _id, ...withoutId } = renderEvent(env, event);
+	return jsonResponse(201, entity(metadataContext(env, `${calendarContext(request)}/events/$entity`), env.drills.createOmitsId ? withoutId : renderEvent(env, event)));
+};
+/** `GET /users/{userId}/events/{eventId}` (`$select`). */
+const getEvent = (state, request, env) => {
+	const user = resolveUser(state, request);
+	if (user instanceof Response) return user;
+	const zone = timezoneProblem(request);
+	if (zone !== void 0) return zone;
+	const fields = selectedFields(request, eventFields);
+	if (fields instanceof Response) return fields;
+	const event = findEvent(state, request);
+	const context = metadataContext(env, `${userContext(request)}/events${selectSuffix(fields)}/$entity`);
+	return event === void 0 ? eventNotFound(request) : jsonResponse(200, entity(context, project(renderEvent(env, event), fields)), readHeaders);
+};
+/** `PATCH /users/{userId}/events/{eventId}`: update `subject`; 200 with the event. */
+const updateEvent = (state, request, env) => {
+	const user = resolveUser(state, request);
+	if (user instanceof Response) return user;
+	const zone = timezoneProblem(request);
+	if (zone !== void 0) return zone;
+	const event = findEvent(state, request);
+	if (event === void 0) return eventNotFound(request);
+	const write = eventWrite(request, updateEventKeys);
+	if (write instanceof Response) return write;
+	const updated = {
+		...event,
+		...write
+	};
+	if (updated.end < updated.start) return invalidValue(request, "the event end is before its start.");
+	const stored = {
+		...updated,
+		changeKey: nextChangeKey(state, eventTagPrefix),
+		lastModifiedDateTime: nowTimestamp(env)
+	};
+	state.events = state.events.map((candidate) => candidate.id === stored.id ? stored : candidate);
+	return jsonResponse(200, entity(metadataContext(env, `${userContext(request)}/events/$entity`), renderEvent(env, stored)));
+};
+const removeEvent = (state, id) => {
+	state.events = state.events.filter((event) => event.id !== id);
+};
+/** `DELETE /users/{userId}/events/{eventId}`: 204; later reads answer 404. */
+const deleteEvent = (state, request) => {
+	const user = resolveUser(state, request);
+	if (user instanceof Response) return user;
+	const zone = timezoneProblem(request);
+	if (zone !== void 0) return zone;
+	const event = findEvent(state, request);
+	if (event === void 0) return eventNotFound(request);
+	removeEvent(state, event.id);
+	return emptyResponse(204);
+};
+/**
+* `POST /users/{userId}/events/{eventId}/cancel` (`{ comment? }`): 202 with an empty body, and
+* the event is removed (not kept with `isCancelled: true`), so a later GET or DELETE answers 404,
+* as the cancel fixture records. The emulated events have no attendees: nothing is sent.
+*/
+const cancelEvent = (state, request) => {
+	const user = resolveUser(state, request);
+	if (user instanceof Response) return user;
+	const zone = timezoneProblem(request);
+	if (zone !== void 0) return zone;
+	const event = findEvent(state, request);
+	if (event === void 0) return eventNotFound(request);
+	if (request.body !== void 0) {
+		const fields = bodyObject(request, ["comment"]);
+		if (fields instanceof Response) return fields;
+		if (fields.comment !== void 0 && !Predicate.isString(fields.comment)) return invalidValue(request, "comment must be a string.");
+	}
+	removeEvent(state, event.id);
+	return emptyResponse(202);
+};
+//#endregion
+export { calendarView, cancelEvent, createEvent, deleteEvent, getEvent, updateEvent };
+
+//# sourceMappingURL=calendar.mjs.map

package/dist/microsoft/calendar.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.mjs","names":[],"sources":["../../src/microsoft/calendar.ts"],"sourcesContent":["/**\n * Microsoft Graph emulator calendar routes (internal): `calendarView`, event create, get, update,\n * delete, and cancel. Wire shapes follow the synthetic calendar conformance fixtures.\n *\n * Event times are stored in UTC with seven fractional digits and answered in UTC. Every calendar\n * fixture sends `Prefer: outlook.timezone=\"UTC\"`, so every calendar route needs it; without it, or\n * with another time zone, a request is refused (fail closed). Calendar views need `$top` and answer\n * one page (no `$skip`, no `@odata.nextLink`), as the fixtures record them. Events are answered with\n * the fixture fields only (`@odata.etag`, `id`, `subject`, `start`, `end`, `isCancelled`); a create\n * takes the fixture's fields (`subject`, a text `body`, `start`, `end`, `isReminderOn`, `showAs`)\n * and an update only `subject`; anything else, including unknown nested keys, fails closed.\n *\n * @experimental\n */\nimport { Predicate } from 'effect'\nimport type * as Schema from 'effect/Schema'\nimport {\n  bodyObject,\n  codes,\n  collection,\n  emptyResponse,\n  entity,\n  invalidValue,\n  jsonResponse,\n  metadataContext,\n  nestedObject,\n  nextChangeKey,\n  notEmulated,\n  nowTimestamp,\n  odataKey,\n  padded,\n  project,\n  resolveUser,\n  selectSuffix,\n  selectedFields,\n  singlePage,\n  textBody,\n  type MicrosoftApiEnv,\n  type RouteHandler,\n  type RouteRequest\n} from './graph.ts'\nimport {\n  formatLocalDateTime,\n  parseInstant,\n  type MicrosoftEmulatorEvent,\n  type MicrosoftEmulatorState\n} from './state.ts'\n\n/** The event fields the fixtures answer (and `$select`). */\nconst eventFields: ReadonlyArray<string> = ['id', 'subject', 'start', 'end', 'isCancelled']\n\nconst showAsValues: ReadonlyArray<MicrosoftEmulatorEvent['showAs']> = [\n  'free',\n  'tentative',\n  'busy',\n  'oof',\n  'workingElsewhere',\n  'unknown'\n]\n\nconst isShowAs = (value: unknown): value is MicrosoftEmulatorEvent['showAs'] =>\n  showAsValues.some(candidate => candidate === value)\n\nconst eventTagPrefix = 'DwAAABYAAAAsynthetic'\n\nconst renderDateTime = (env: MicrosoftApiEnv, value: string) => {\n  const ticks = parseInstant(value, 'forbidden')\n\n  return {\n    dateTime:\n      ticks === undefined ? value : formatLocalDateTime(ticks, env.drills.timestampPrecisionDigits),\n    timeZone: 'UTC'\n  }\n}\n\n/** The event as the fixtures answer it, in their key order. */\nconst renderEvent = (env: MicrosoftApiEnv, event: MicrosoftEmulatorEvent): Schema.JsonObject => ({\n  '@odata.etag': `W/\"${event.changeKey}\"`,\n  id: event.id,\n  subject: event.subject,\n  start: renderDateTime(env, event.start),\n  end: renderDateTime(env, event.end),\n  isCancelled: event.isCancelled\n})\n\n/** `users('{userId}')`, the context prefix of every calendar route. */\nconst userContext = (request: RouteRequest): string =>\n  `users${odataKey(request.params.userId ?? '')}`\n\n/** `users('{userId}')/calendars('{calendarId}')`. */\nconst calendarContext = (request: RouteRequest): string =>\n  `${userContext(request)}/calendars${odataKey(request.params.calendarId ?? '')}`\n\n/**\n * Every calendar fixture sends `Prefer: outlook.timezone=\"UTC\"`: a request without it, or with any\n * other time zone, is not emulated.\n */\nconst timezoneProblem = (request: RouteRequest): Response | undefined => {\n  const timezone = request.prefer.timezone\n\n  if (timezone === undefined) {\n    return notEmulated(\n      request,\n      'calendar requests without Prefer: outlook.timezone=\"UTC\" are not emulated.'\n    )\n  }\n\n  return timezone.toUpperCase() === 'UTC'\n    ? undefined\n    : notEmulated(request, `outlook.timezone ${timezone} is not emulated (UTC only).`)\n}\n\n/** `preference-applied` on reads (which asked for UTC), as the fixtures record it. */\nconst readHeaders: HeadersInit = { 'preference-applied': 'outlook.timezone=\"UTC\"' }\n\nconst findCalendar = (state: MicrosoftEmulatorState, request: RouteRequest) =>\n  state.calendars.find(calendar => calendar.id === request.params.calendarId)\n\nconst calendarNotFound = (request: RouteRequest): Response =>\n  request.error(404, codes.mailItemNotFound, 'The specified object was not found in the store.')\n\nconst eventNotFound = calendarNotFound\n\nconst findEvent = (state: MicrosoftEmulatorState, request: RouteRequest) =>\n  state.events.find(event => event.id === request.params.eventId)\n\n/** Ticks of a stored UTC date-time (always readable: the state schema checks the pattern). */\nconst ticksOf = (value: string): bigint => parseInstant(value, 'forbidden') ?? BigInt(0)\n\n/** The largest calendar view `$top` a fixture sends (`$top=50`, list-range and precision cases). */\nconst calendarViewMaxTop = 50\n\n/**\n * `GET .../calendars/{calendarId}/calendarView?startDateTime=&endDateTime=`: the events that\n * overlap `[start, end)` (start before the range end and end after the range start), ordered by\n * start, at most `$top` of them (more is not emulated: no fixture pages a calendar view; `$top`\n * is required, at most `calendarViewMaxTop`).\n */\nexport const calendarView: RouteHandler = (state, request, env) => {\n  const user = resolveUser(state, request)\n\n  if (user instanceof Response) return user\n\n  const zone = timezoneProblem(request)\n\n  if (zone !== undefined) return zone\n\n  if (findCalendar(state, request) === undefined) return calendarNotFound(request)\n\n  const rawStart = request.query.get('startDateTime')\n  const rawEnd = request.query.get('endDateTime')\n\n  if (rawStart === null || rawEnd === null) {\n    return invalidValue(request, 'calendarView needs startDateTime and endDateTime.')\n  }\n\n  const start = parseInstant(rawStart, 'optional')\n  const end = parseInstant(rawEnd, 'optional')\n\n  if (start === undefined || end === undefined) {\n    return invalidValue(request, 'startDateTime and endDateTime must be ISO-8601 date-times.')\n  }\n\n  const fields = selectedFields(request, eventFields)\n\n  if (fields instanceof Response) return fields\n\n  const matching = env.drills.calendarRangeEmpty\n    ? []\n    : state.events\n        .filter(\n          event =>\n            event.calendarId === request.params.calendarId &&\n            ticksOf(event.start) < end &&\n            ticksOf(event.end) > start\n        )\n        .sort((left, right) =>\n          left.start === right.start\n            ? left.id.localeCompare(right.id)\n            : left.start < right.start\n              ? -1\n              : 1\n        )\n\n  const page = singlePage(matching, request, calendarViewMaxTop)\n\n  if (page instanceof Response) return page\n\n  return jsonResponse(\n    200,\n    collection(\n      metadataContext(env, `${calendarContext(request)}/calendarView${selectSuffix(fields)}`),\n      page.map(event => project(renderEvent(env, event), fields)),\n      undefined\n    ),\n    readHeaders\n  )\n}\n\n/** A `dateTimeTimeZone` write value in UTC, as a seven-digit local date-time. */\nconst writeDateTime = (\n  request: RouteRequest,\n  key: string,\n  value: Schema.Json\n): string | Response => {\n  const dateTimeZone = nestedObject(\n    request,\n    value,\n    ['dateTime', 'timeZone'],\n    `${key} { dateTime, timeZone }`\n  )\n\n  if (dateTimeZone instanceof Response) return dateTimeZone\n\n  const { dateTime, timeZone } = dateTimeZone\n\n  if (!Predicate.isString(dateTime) || !Predicate.isString(timeZone)) {\n    return invalidValue(request, `${key} must be { dateTime, timeZone } with string values.`)\n  }\n\n  if (timeZone.toUpperCase() !== 'UTC') {\n    return notEmulated(request, `${key}.timeZone ${timeZone} is not emulated (UTC only).`)\n  }\n\n  const ticks = parseInstant(dateTime, 'forbidden')\n\n  return ticks === undefined\n    ? invalidValue(request, `${key}.dateTime must be a local date-time without offset.`)\n    : formatLocalDateTime(ticks, 7)\n}\n\ntype EventWrite = {\n  subject?: string\n  bodyContent?: string\n  start?: string\n  end?: string\n  isReminderOn?: boolean\n  showAs?: MicrosoftEmulatorEvent['showAs']\n}\n\n/** Event create keys, as the create fixture sends them. */\nconst createEventKeys: ReadonlyArray<string> = [\n  'subject',\n  'body',\n  'start',\n  'end',\n  'isReminderOn',\n  'showAs'\n]\n\n/** Event update keys, as the update fixture sends them. */\nconst updateEventKeys: ReadonlyArray<string> = ['subject']\n\n/** The emulated event fields of a create or update body; attendees and the rest fail closed. */\nconst eventWrite = (\n  request: RouteRequest,\n  allowed: ReadonlyArray<string>\n): EventWrite | Response => {\n  const fields = bodyObject(request, allowed)\n\n  if (fields instanceof Response) return fields\n\n  const write: EventWrite = {}\n\n  for (const [key, value] of Object.entries(fields)) {\n    switch (key) {\n      case 'subject':\n        if (!Predicate.isString(value)) return invalidValue(request, 'subject must be a string.')\n\n        write.subject = value\n        break\n      case 'body': {\n        const content = textBody(request, value)\n\n        if (content instanceof Response) return content\n\n        write.bodyContent = content\n        break\n      }\n\n      case 'start':\n      case 'end': {\n        const dateTime = writeDateTime(request, key, value)\n\n        if (dateTime instanceof Response) return dateTime\n\n        write[key] = dateTime\n        break\n      }\n\n      case 'isReminderOn':\n        if (!Predicate.isBoolean(value)) {\n          return invalidValue(request, 'isReminderOn must be a boolean.')\n        }\n\n        write.isReminderOn = value\n        break\n      case 'showAs':\n        if (!isShowAs(value)) return invalidValue(request, 'showAs is not a Graph freeBusyStatus.')\n\n        write.showAs = value\n        break\n    }\n  }\n\n  return write\n}\n\n/**\n * `POST .../calendars/{calendarId}/events`: create a single-instance, attendee-free event (201\n * with the event; the `createOmitsId` drill knob drops its `id`).\n */\nexport const createEvent: RouteHandler = (state, request, env) => {\n  const user = resolveUser(state, request)\n\n  if (user instanceof Response) return user\n\n  const zone = timezoneProblem(request)\n\n  if (zone !== undefined) return zone\n\n  if (findCalendar(state, request) === undefined) return calendarNotFound(request)\n\n  const write = eventWrite(request, createEventKeys)\n\n  if (write instanceof Response) return write\n\n  if (write.start === undefined || write.end === undefined) {\n    return invalidValue(request, 'a new event needs start and end.')\n  }\n\n  if (write.end < write.start) return invalidValue(request, 'the event end is before its start.')\n\n  let number = state.counters.nextEventNumber\n  let id = `AAMkAGI2-synthetic-event-${padded(number, 4)}=`\n\n  while (state.events.some(event => event.id === id)) {\n    number += 1\n    id = `AAMkAGI2-synthetic-event-${padded(number, 4)}=`\n  }\n\n  state.counters = { ...state.counters, nextEventNumber: number + 1 }\n\n  const now = nowTimestamp(env)\n\n  const event: MicrosoftEmulatorEvent = {\n    id,\n    calendarId: request.params.calendarId ?? '',\n    subject: write.subject ?? '',\n    bodyContentType: 'text',\n    bodyContent: write.bodyContent ?? '',\n    start: write.start,\n    end: write.end,\n    isCancelled: false,\n    isReminderOn: write.isReminderOn ?? true,\n    showAs: write.showAs ?? 'busy',\n    changeKey: nextChangeKey(state, eventTagPrefix),\n    createdDateTime: now,\n    lastModifiedDateTime: now\n  }\n\n  state.events = [...state.events, event]\n\n  const { id: _id, ...withoutId } = renderEvent(env, event)\n  const context = metadataContext(env, `${calendarContext(request)}/events/$entity`)\n\n  return jsonResponse(\n    201,\n    entity(context, env.drills.createOmitsId ? withoutId : renderEvent(env, event))\n  )\n}\n\n/** `GET /users/{userId}/events/{eventId}` (`$select`). */\nexport const getEvent: RouteHandler = (state, request, env) => {\n  const user = resolveUser(state, request)\n\n  if (user instanceof Response) return user\n\n  const zone = timezoneProblem(request)\n\n  if (zone !== undefined) return zone\n\n  const fields = selectedFields(request, eventFields)\n\n  if (fields instanceof Response) return fields\n\n  const event = findEvent(state, request)\n\n  const context = metadataContext(\n    env,\n    `${userContext(request)}/events${selectSuffix(fields)}/$entity`\n  )\n\n  return event === undefined\n    ? eventNotFound(request)\n    : jsonResponse(200, entity(context, project(renderEvent(env, event), fields)), readHeaders)\n}\n\n/** `PATCH /users/{userId}/events/{eventId}`: update `subject`; 200 with the event. */\nexport const updateEvent: RouteHandler = (state, request, env) => {\n  const user = resolveUser(state, request)\n\n  if (user instanceof Response) return user\n\n  const zone = timezoneProblem(request)\n\n  if (zone !== undefined) return zone\n\n  const event = findEvent(state, request)\n\n  if (event === undefined) return eventNotFound(request)\n\n  const write = eventWrite(request, updateEventKeys)\n\n  if (write instanceof Response) return write\n\n  const updated: MicrosoftEmulatorEvent = { ...event, ...write }\n\n  if (updated.end < updated.start) {\n    return invalidValue(request, 'the event end is before its start.')\n  }\n\n  const stored: MicrosoftEmulatorEvent = {\n    ...updated,\n    changeKey: nextChangeKey(state, eventTagPrefix),\n    lastModifiedDateTime: nowTimestamp(env)\n  }\n\n  state.events = state.events.map(candidate => (candidate.id === stored.id ? stored : candidate))\n\n  return jsonResponse(\n    200,\n    entity(metadataContext(env, `${userContext(request)}/events/$entity`), renderEvent(env, stored))\n  )\n}\n\nconst removeEvent = (state: MicrosoftEmulatorState, id: string): void => {\n  state.events = state.events.filter(event => event.id !== id)\n}\n\n/** `DELETE /users/{userId}/events/{eventId}`: 204; later reads answer 404. */\nexport const deleteEvent: RouteHandler = (state, request) => {\n  const user = resolveUser(state, request)\n\n  if (user instanceof Response) return user\n\n  const zone = timezoneProblem(request)\n\n  if (zone !== undefined) return zone\n\n  const event = findEvent(state, request)\n\n  if (event === undefined) return eventNotFound(request)\n\n  removeEvent(state, event.id)\n\n  return emptyResponse(204)\n}\n\n/**\n * `POST /users/{userId}/events/{eventId}/cancel` (`{ comment? }`): 202 with an empty body, and\n * the event is removed (not kept with `isCancelled: true`), so a later GET or DELETE answers 404,\n * as the cancel fixture records. The emulated events have no attendees: nothing is sent.\n */\nexport const cancelEvent: RouteHandler = (state, request) => {\n  const user = resolveUser(state, request)\n\n  if (user instanceof Response) return user\n\n  const zone = timezoneProblem(request)\n\n  if (zone !== undefined) return zone\n\n  const event = findEvent(state, request)\n\n  if (event === undefined) return eventNotFound(request)\n\n  if (request.body !== undefined) {\n    const fields = bodyObject(request, ['comment'])\n\n    if (fields instanceof Response) return fields\n\n    if (fields.comment !== undefined && !Predicate.isString(fields.comment)) {\n      return invalidValue(request, 'comment must be a string.')\n    }\n  }\n\n  removeEvent(state, event.id)\n\n  return emptyResponse(202)\n}\n"],"mappings":"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"}

package/dist/microsoft/drive.d.mts

@@ -0,0 +1,36 @@
+import { RouteHandler } from "./graph.mjs";
+
+//#region src/microsoft/drive.d.ts
+/** `GET /drives/{driveId}/items/{itemId}` (`$select`). */
+declare const getItem: RouteHandler;
+/**
+ * `GET /drives/{driveId}/items/{itemId}/children`: by name, at most `$top` (one page only;
+ * `$top` required, at most `childrenMaxTop`).
+ */
+declare const listChildren: RouteHandler;
+/**
+ * `POST /drives/{driveId}/items/{itemId}/children` with a `folder` facet and
+ * `@microsoft.graph.conflictBehavior: fail`: 201 with the folder. A taken name, and creating
+ * files here, are not emulated.
+ */
+declare const createFolder: RouteHandler;
+/** `DELETE /drives/{driveId}/items/{itemId}`: 204; the item and its subtree are removed. */
+declare const deleteItem: RouteHandler;
+/**
+ * `POST /drives/{driveId}/items/{itemId}/copy` (`{ parentReference: { driveId, id } }`, query
+ * `@microsoft.graph.conflictBehavior=fail`): 202 with an empty body and one monitor `Location`.
+ * The copy itself runs when the monitor reports completion. Only what the copy fixture sends is
+ * emulated: a file source, a destination on the same drive named by `driveId` and `id`, and the
+ * source's name (a new `name`, a folder source, or a missing `driveId` fail closed).
+ */
+declare const copyItem: RouteHandler;
+/**
+ * `GET /personal/{site}/_api/v2.0/monitor/{monitorId}` on the SharePoint origin (no credentials
+ * needed, like the real capability URL): `inProgress` (202) while polls remain, then the copy runs
+ * once and every later poll answers `completed` (200, `resourceId`). A copy that cannot run
+ * answers 400 not emulated (failed copies are not emulated) and stays pending.
+ */
+declare const copyMonitor: RouteHandler;
+//#endregion
+export { copyItem, copyMonitor, createFolder, deleteItem, getItem, listChildren };
+//# sourceMappingURL=drive.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drive.d.mts","names":[],"sources":["../../src/microsoft/drive.ts"],"mappings":";;;;cAkLa,OAAA,EAAS,YAmBrB;AAnBD;;;;AAAA,cAgCa,YAAA,EAAc,YA2B1B;AA3BD;;;;AA2BC;AA3BD,cA4Ea,YAAA,EAAc,YA0D1B;;cAGY,UAAA,EAAY,YAiBxB;;AApBA;AAGD;;;;AAiBC;cAYY,QAAA,EAAU,YAuEtB;;;;AAAA;AAuDD;;cAAa,WAAA,EAAa,YAsCzB"}