@yolk-sdk/emulators 0.1.0-canary.96

package/dist/microsoft/drive.mjs

@@ -0,0 +1,298 @@
+import { bodyObject, codes, collection, emptyResponse, entity, invalidValue, isJsonObject, jsonResponse, metadataContext, nestedObject, notEmulated, nowTimestamp, odataKey, padded, personalSite, project, selectSuffix, selectedFields, singlePage } from "./graph.mjs";
+import { Predicate } from "effect";
+//#region src/microsoft/drive.ts
+/**
+* Microsoft Graph emulator OneDrive routes (internal): item read, children listing, folder
+* create, delete, and the asynchronous copy with its monitor URL. Wire shapes follow the
+* synthetic OneDrive conformance fixtures.
+*
+* Deleted items are removed with their subtree (no recycle bin is emulated). Folder create and
+* copy take `@microsoft.graph.conflictBehavior` `fail` only, as the fixtures send it, and only for
+* a name that is free: no fixture records a name conflict, so one fails closed (400). Children
+* listings need `$top` and answer one page (no `$skip`, no `@odata.nextLink`), as the fixtures
+* record them. A copy takes what the copy fixture sends (a file, `parentReference { driveId, id }`
+* on the same drive, no new `name`; anything else is not emulated) and answers 202 with one
+* monitor `Location` on the SharePoint origin; the monitor needs no credentials, answers `inProgress` (202) for `copyInProgressPolls` polls (default 0), then runs
+* the copy and answers `completed` (200) with the new item's `resourceId`, as the fixture's first
+* poll does. No fixture records a failed copy: when the copy can no longer run (source or
+* destination gone, or the name taken), the monitor answers 400 not emulated.
+*
+* @experimental
+*/
+const itemFields = [
+	"id",
+	"name",
+	"size",
+	"webUrl",
+	"createdDateTime",
+	"lastModifiedDateTime",
+	"eTag",
+	"cTag",
+	"parentReference",
+	"file",
+	"folder",
+	"package",
+	"remoteItem",
+	"shared",
+	"deleted"
+];
+const notFound = (request) => request.error(404, codes.driveItemNotFound, "The resource could not be found.");
+const childrenOf = (state, id) => state.driveItems.filter((item) => item.parentId === id);
+/** The item and its descendants. */
+const subtreeOf = (state, root) => [root, ...childrenOf(state, root.id).flatMap((child) => subtreeOf(state, child))];
+/** Folders report the size of their contents. */
+const sizeOf = (state, item) => item.kind === "file" ? item.size : childrenOf(state, item.id).reduce((sum, child) => sum + sizeOf(state, child), 0);
+/** Names from below the root down to the item (empty for the root). */
+const pathNames = (state, item) => {
+	const parent = item.parentId === null ? void 0 : state.driveItems.find((candidate) => candidate.id === item.parentId);
+	return parent === void 0 ? [] : [...pathNames(state, parent), item.name];
+};
+/** A stable synthetic GUID for an item's `eTag`/`cTag` (FNV-1a over the id). */
+const itemGuid = (id) => {
+	let hash = 2166136261;
+	for (const character of id) hash = Math.imul(hash ^ (character.codePointAt(0) ?? 0), 16777619) >>> 0;
+	return `${hash.toString(16).padStart(8, "0")}-0000-4000-8000-000000000000`;
+};
+/** The full item, in the fixture key order. */
+const renderItem = (state, env, item) => {
+	const site = personalSite(state.user);
+	const names = pathNames(state, item);
+	const parentPath = names.slice(0, -1);
+	const parentReference = item.parentId === null ? {
+		driveType: state.drive.driveType,
+		driveId: state.drive.id
+	} : {
+		driveType: state.drive.driveType,
+		driveId: state.drive.id,
+		id: item.parentId,
+		path: `/drive/root:${parentPath.map((name) => `/${name}`).join("")}`
+	};
+	const base = {
+		id: item.id,
+		name: item.name,
+		size: sizeOf(state, item),
+		webUrl: `${env.sharePointOrigin}/personal/${site}/Documents${names.map((name) => `/${encodeURIComponent(name)}`).join("")}`,
+		createdDateTime: item.createdDateTime,
+		lastModifiedDateTime: item.lastModifiedDateTime,
+		eTag: `"{${itemGuid(item.id)}},1"`,
+		cTag: `"c:{${itemGuid(item.id)}},0"`,
+		parentReference
+	};
+	if (item.kind === "folder") return {
+		...base,
+		folder: { childCount: childrenOf(state, item.id).length }
+	};
+	return {
+		...base,
+		file: {
+			mimeType: item.mimeType ?? "application/octet-stream",
+			hashes: item.quickXorHash === null ? {} : { quickXorHash: item.quickXorHash }
+		}
+	};
+};
+/** `drives('{driveId}')`, the context prefix of every OneDrive route. */
+const driveContext = (request) => `drives${odataKey(request.params.driveId ?? "")}`;
+/** `drives('{driveId}')/items('{itemId}')/children`. */
+const childrenContext = (request) => `${driveContext(request)}/items${odataKey(request.params.itemId ?? "")}/children`;
+/** The drive of the `{driveId}` segment, or 404. */
+const driveProblem = (state, request) => request.params.driveId === state.drive.id ? void 0 : notFound(request);
+/** The item of an id segment (`root` names the drive root). */
+const findItem = (state, id) => {
+	const resolved = id.toLowerCase() === "root" ? state.drive.rootId : id;
+	return state.driveItems.find((item) => item.id === resolved);
+};
+/** `GET /drives/{driveId}/items/{itemId}` (`$select`). */
+const getItem = (state, request, env) => {
+	const drive = driveProblem(state, request);
+	if (drive !== void 0) return drive;
+	const fields = selectedFields(request, itemFields);
+	if (fields instanceof Response) return fields;
+	const item = findItem(state, request.params.itemId ?? "");
+	const context = metadataContext(env, `${driveContext(request)}/items${selectSuffix(fields)}/$entity`);
+	return item === void 0 ? notFound(request) : jsonResponse(200, entity(context, project(renderItem(state, env, item), fields)));
+};
+const byName = (left, right) => left.name.localeCompare(right.name, "en", { sensitivity: "base" }) || left.id.localeCompare(right.id);
+/** The largest children `$top` a fixture sends (`$top=200`, create-folder and copy cases). */
+const childrenMaxTop = 200;
+/**
+* `GET /drives/{driveId}/items/{itemId}/children`: by name, at most `$top` (one page only;
+* `$top` required, at most `childrenMaxTop`).
+*/
+const listChildren = (state, request, env) => {
+	const drive = driveProblem(state, request);
+	if (drive !== void 0) return drive;
+	const fields = selectedFields(request, itemFields);
+	if (fields instanceof Response) return fields;
+	const parent = findItem(state, request.params.itemId ?? "");
+	if (parent === void 0) return notFound(request);
+	if (parent.kind !== "folder") return notEmulated(request, "children of a file are not emulated.");
+	const page = singlePage([...childrenOf(state, parent.id)].sort(byName), request, childrenMaxTop);
+	if (page instanceof Response) return page;
+	return jsonResponse(200, collection(metadataContext(env, `${childrenContext(request)}${selectSuffix(fields)}`), page.map((item) => project(renderItem(state, env, item), fields)), void 0));
+};
+const invalidNamePattern = /["*:<>?/\\|]/;
+const nameProblem = (request, name) => Predicate.isString(name) && name.trim() !== "" && name.trim() === name && !invalidNamePattern.test(name) && name !== "." && name !== ".." && !name.endsWith(".") ? name : invalidValue(request, "the item name is empty or has characters OneDrive does not allow.");
+const nameTaken = (state, parentId, name) => childrenOf(state, parentId).some((child) => child.name.toLowerCase() === name.toLowerCase());
+const nextItemId = (state) => {
+	let number = state.counters.nextItemNumber;
+	let id = `01SYNTHETICITEM${padded(number, 17)}`;
+	while (state.driveItems.some((item) => item.id === id)) {
+		number += 1;
+		id = `01SYNTHETICITEM${padded(number, 17)}`;
+	}
+	state.counters = {
+		...state.counters,
+		nextItemNumber: number + 1
+	};
+	return id;
+};
+const nameConflict = (request) => notEmulated(request, "name conflicts are not emulated (the name is already taken).");
+/** Only `fail`, as the fixtures send it; anything else (or none) is not emulated. */
+const conflictBehaviorProblem = (request, value) => value === "fail" ? void 0 : notEmulated(request, "@microsoft.graph.conflictBehavior must be fail (other or missing values are not emulated).");
+/**
+* `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.
+*/
+const createFolder = (state, request, env) => {
+	const drive = driveProblem(state, request);
+	if (drive !== void 0) return drive;
+	const parent = findItem(state, request.params.itemId ?? "");
+	if (parent === void 0) return notFound(request);
+	if (parent.kind !== "folder") return invalidValue(request, "the parent item is not a folder.");
+	const fields = bodyObject(request, [
+		"name",
+		"folder",
+		"@microsoft.graph.conflictBehavior"
+	]);
+	if (fields instanceof Response) return fields;
+	if (fields.folder === void 0) return notEmulated(request, "only folder creation (a folder facet) is emulated here.");
+	const folderFacet = fields.folder;
+	if (!isJsonObject(folderFacet) || Object.keys(folderFacet).length > 0) return notEmulated(request, "the folder facet must be {}.");
+	const name = nameProblem(request, fields.name);
+	if (name instanceof Response) return name;
+	const behavior = conflictBehaviorProblem(request, fields["@microsoft.graph.conflictBehavior"]);
+	if (behavior !== void 0) return behavior;
+	if (nameTaken(state, parent.id, name)) return nameConflict(request);
+	const now = nowTimestamp(env);
+	const folder = {
+		id: nextItemId(state),
+		parentId: parent.id,
+		name,
+		kind: "folder",
+		size: 0,
+		mimeType: null,
+		quickXorHash: null,
+		createdDateTime: now,
+		lastModifiedDateTime: now
+	};
+	state.driveItems = [...state.driveItems, folder];
+	return jsonResponse(201, entity(metadataContext(env, `${childrenContext(request)}/$entity`), renderItem(state, env, folder)));
+};
+/** `DELETE /drives/{driveId}/items/{itemId}`: 204; the item and its subtree are removed. */
+const deleteItem = (state, request) => {
+	const drive = driveProblem(state, request);
+	if (drive !== void 0) return drive;
+	const item = findItem(state, request.params.itemId ?? "");
+	if (item === void 0) return notFound(request);
+	if (item.parentId === null) return notEmulated(request, "deleting the drive root is not emulated.");
+	const removed = new Set(subtreeOf(state, item).map((entry) => entry.id));
+	state.driveItems = state.driveItems.filter((entry) => !removed.has(entry.id));
+	return emptyResponse(204);
+};
+const monitorPath = (state, id) => `/personal/${personalSite(state.user)}/_api/v2.0/monitor/${id}`;
+/**
+* `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).
+*/
+const copyItem = (state, request, env) => {
+	const drive = driveProblem(state, request);
+	if (drive !== void 0) return drive;
+	const source = findItem(state, request.params.itemId ?? "");
+	if (source === void 0) return notFound(request);
+	if (source.kind !== "file") return notEmulated(request, "copying a folder is not emulated (the fixture copies a file).");
+	const behavior = conflictBehaviorProblem(request, request.query.get("@microsoft.graph.conflictBehavior") ?? void 0);
+	if (behavior !== void 0) return behavior;
+	const fields = bodyObject(request, ["parentReference"]);
+	if (fields instanceof Response) return fields;
+	const reference = nestedObject(request, fields.parentReference, ["driveId", "id"], "parentReference { driveId, id }");
+	if (reference instanceof Response) return reference;
+	if (reference.driveId === void 0) return notEmulated(request, "copies without parentReference.driveId are not emulated.");
+	if (!Predicate.isString(reference.id) || !Predicate.isString(reference.driveId)) return invalidValue(request, "parentReference must be { driveId, id } with string values.");
+	if (reference.driveId !== state.drive.id) return notEmulated(request, "copies to another drive are not emulated.");
+	const destination = findItem(state, reference.id);
+	if (destination === void 0) return notFound(request);
+	if (destination.kind !== "folder") return invalidValue(request, "the destination is not a folder.");
+	const number = env.monitorCounter.next;
+	env.monitorCounter.next += 1;
+	const monitor = {
+		id: `00000000-0000-4000-8000-${padded(number, 12)}`,
+		sourceId: source.id,
+		destinationParentId: destination.id,
+		pollsLeft: env.copyInProgressPolls,
+		resourceId: void 0
+	};
+	env.monitors.set(monitor.id, monitor);
+	return emptyResponse(202, { location: `${env.sharePointOrigin}${monitorPath(state, monitor.id)}` });
+};
+/** Copy the file `item` under `parentId` with a fresh id and its name; returns the new id. */
+const copyFile = (state, env, item, parentId) => {
+	const now = nowTimestamp(env);
+	const copy = {
+		...item,
+		id: nextItemId(state),
+		parentId,
+		createdDateTime: now,
+		lastModifiedDateTime: now
+	};
+	state.driveItems = [...state.driveItems, copy];
+	return copy.id;
+};
+/**
+* Run a monitored copy: its `resourceId`, or why it cannot run (the source or destination is
+* gone, or the name is taken; no fixture records a failed copy).
+*/
+const runCopy = (state, env, monitor) => {
+	const source = findItem(state, monitor.sourceId);
+	const destination = findItem(state, monitor.destinationParentId);
+	if (source === void 0 || destination === void 0 || destination.kind !== "folder") return { problem: "the copy source or destination no longer exists" };
+	if (nameTaken(state, destination.id, source.name)) return { problem: "the copy name is already taken in the destination" };
+	return copyFile(state, env, source, destination.id);
+};
+const monitorContentType = "application/json;odata.metadata=minimal;odata.streaming=true";
+/**
+* `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.
+*/
+const copyMonitor = (state, request, env) => {
+	const monitor = env.monitors.get(request.params.monitorId ?? "");
+	if (monitor === void 0 || request.params.site !== personalSite(state.user)) return notFound(request);
+	const context = `${env.sharePointOrigin}/personal/${personalSite(state.user)}/_api/v2.0/$metadata#oneDrive.asynchronousOperationStatus`;
+	const headers = { "content-type": monitorContentType };
+	if (monitor.resourceId === void 0 && monitor.pollsLeft > 0) {
+		monitor.pollsLeft -= 1;
+		return jsonResponse(202, {
+			"@odata.context": context,
+			percentageComplete: 0,
+			status: "inProgress"
+		}, headers);
+	}
+	const resourceId = monitor.resourceId ?? runCopy(state, env, monitor);
+	if (!Predicate.isString(resourceId)) return notEmulated(request, `${resourceId.problem} (failed copies are not emulated).`);
+	monitor.resourceId = resourceId;
+	return jsonResponse(200, {
+		"@odata.context": context,
+		percentageComplete: 100,
+		resourceId,
+		status: "completed"
+	}, headers);
+};
+//#endregion
+export { copyItem, copyMonitor, createFolder, deleteItem, getItem, listChildren };
+
+//# sourceMappingURL=drive.mjs.map

package/dist/microsoft/drive.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive.mjs","names":[],"sources":["../../src/microsoft/drive.ts"],"sourcesContent":["/**\n * Microsoft Graph emulator OneDrive routes (internal): item read, children listing, folder\n * create, delete, and the asynchronous copy with its monitor URL. Wire shapes follow the\n * synthetic OneDrive conformance fixtures.\n *\n * Deleted items are removed with their subtree (no recycle bin is emulated). Folder create and\n * copy take `@microsoft.graph.conflictBehavior` `fail` only, as the fixtures send it, and only for\n * a name that is free: no fixture records a name conflict, so one fails closed (400). Children\n * listings need `$top` and answer one page (no `$skip`, no `@odata.nextLink`), as the fixtures\n * record them. A copy takes what the copy fixture sends (a file, `parentReference { driveId, id }`\n * on the same drive, no new `name`; anything else is not emulated) and answers 202 with one\n * monitor `Location` on the SharePoint origin; the monitor needs no credentials, answers `inProgress` (202) for `copyInProgressPolls` polls (default 0), then runs\n * the copy and answers `completed` (200) with the new item's `resourceId`, as the fixture's first\n * poll does. No fixture records a failed copy: when the copy can no longer run (source or\n * destination gone, or the name taken), the monitor answers 400 not emulated.\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  isJsonObject,\n  jsonResponse,\n  metadataContext,\n  nestedObject,\n  notEmulated,\n  nowTimestamp,\n  odataKey,\n  padded,\n  personalSite,\n  project,\n  selectSuffix,\n  selectedFields,\n  singlePage,\n  type CopyMonitor,\n  type MicrosoftApiEnv,\n  type RouteHandler,\n  type RouteRequest\n} from './graph.ts'\nimport type { MicrosoftEmulatorDriveItem, MicrosoftEmulatorState } from './state.ts'\n\nconst itemFields: ReadonlyArray<string> = [\n  'id',\n  'name',\n  'size',\n  'webUrl',\n  'createdDateTime',\n  'lastModifiedDateTime',\n  'eTag',\n  'cTag',\n  'parentReference',\n  'file',\n  'folder',\n  'package',\n  'remoteItem',\n  'shared',\n  'deleted'\n]\n\nconst notFound = (request: RouteRequest): Response =>\n  request.error(404, codes.driveItemNotFound, 'The resource could not be found.')\n\nconst childrenOf = (state: MicrosoftEmulatorState, id: string) =>\n  state.driveItems.filter(item => item.parentId === id)\n\n/** The item and its descendants. */\nconst subtreeOf = (\n  state: MicrosoftEmulatorState,\n  root: MicrosoftEmulatorDriveItem\n): ReadonlyArray<MicrosoftEmulatorDriveItem> => [\n  root,\n  ...childrenOf(state, root.id).flatMap(child => subtreeOf(state, child))\n]\n\n/** Folders report the size of their contents. */\nconst sizeOf = (state: MicrosoftEmulatorState, item: MicrosoftEmulatorDriveItem): number =>\n  item.kind === 'file'\n    ? item.size\n    : childrenOf(state, item.id).reduce((sum, child) => sum + sizeOf(state, child), 0)\n\n/** Names from below the root down to the item (empty for the root). */\nconst pathNames = (\n  state: MicrosoftEmulatorState,\n  item: MicrosoftEmulatorDriveItem\n): ReadonlyArray<string> => {\n  const parent =\n    item.parentId === null\n      ? undefined\n      : state.driveItems.find(candidate => candidate.id === item.parentId)\n\n  return parent === undefined ? [] : [...pathNames(state, parent), item.name]\n}\n\n/** A stable synthetic GUID for an item's `eTag`/`cTag` (FNV-1a over the id). */\nconst itemGuid = (id: string): string => {\n  let hash = 0x811c9dc5\n\n  for (const character of id) {\n    hash = Math.imul(hash ^ (character.codePointAt(0) ?? 0), 0x01000193) >>> 0\n  }\n\n  return `${hash.toString(16).padStart(8, '0')}-0000-4000-8000-000000000000`\n}\n\n/** The full item, in the fixture key order. */\nconst renderItem = (\n  state: MicrosoftEmulatorState,\n  env: MicrosoftApiEnv,\n  item: MicrosoftEmulatorDriveItem\n): Schema.JsonObject => {\n  const site = personalSite(state.user)\n  const names = pathNames(state, item)\n  const parentPath = names.slice(0, -1)\n\n  const parentReference: Schema.JsonObject =\n    item.parentId === null\n      ? { driveType: state.drive.driveType, driveId: state.drive.id }\n      : {\n          driveType: state.drive.driveType,\n          driveId: state.drive.id,\n          id: item.parentId,\n          path: `/drive/root:${parentPath.map(name => `/${name}`).join('')}`\n        }\n\n  const base = {\n    id: item.id,\n    name: item.name,\n    size: sizeOf(state, item),\n    webUrl: `${env.sharePointOrigin}/personal/${site}/Documents${names.map(name => `/${encodeURIComponent(name)}`).join('')}`,\n    createdDateTime: item.createdDateTime,\n    lastModifiedDateTime: item.lastModifiedDateTime,\n    eTag: `\"{${itemGuid(item.id)}},1\"`,\n    cTag: `\"c:{${itemGuid(item.id)}},0\"`,\n    parentReference\n  }\n\n  if (item.kind === 'folder') {\n    return { ...base, folder: { childCount: childrenOf(state, item.id).length } }\n  }\n\n  return {\n    ...base,\n    file: {\n      mimeType: item.mimeType ?? 'application/octet-stream',\n      hashes: item.quickXorHash === null ? {} : { quickXorHash: item.quickXorHash }\n    }\n  }\n}\n\n/** `drives('{driveId}')`, the context prefix of every OneDrive route. */\nconst driveContext = (request: RouteRequest): string =>\n  `drives${odataKey(request.params.driveId ?? '')}`\n\n/** `drives('{driveId}')/items('{itemId}')/children`. */\nconst childrenContext = (request: RouteRequest): string =>\n  `${driveContext(request)}/items${odataKey(request.params.itemId ?? '')}/children`\n\n/** The drive of the `{driveId}` segment, or 404. */\nconst driveProblem = (state: MicrosoftEmulatorState, request: RouteRequest) =>\n  request.params.driveId === state.drive.id ? undefined : notFound(request)\n\n/** The item of an id segment (`root` names the drive root). */\nconst findItem = (\n  state: MicrosoftEmulatorState,\n  id: string\n): MicrosoftEmulatorDriveItem | undefined => {\n  const resolved = id.toLowerCase() === 'root' ? state.drive.rootId : id\n\n  return state.driveItems.find(item => item.id === resolved)\n}\n\n/** `GET /drives/{driveId}/items/{itemId}` (`$select`). */\nexport const getItem: RouteHandler = (state, request, env) => {\n  const drive = driveProblem(state, request)\n\n  if (drive !== undefined) return drive\n\n  const fields = selectedFields(request, itemFields)\n\n  if (fields instanceof Response) return fields\n\n  const item = findItem(state, request.params.itemId ?? '')\n\n  const context = metadataContext(\n    env,\n    `${driveContext(request)}/items${selectSuffix(fields)}/$entity`\n  )\n\n  return item === undefined\n    ? notFound(request)\n    : jsonResponse(200, entity(context, project(renderItem(state, env, item), fields)))\n}\n\nconst byName = (left: MicrosoftEmulatorDriveItem, right: MicrosoftEmulatorDriveItem) =>\n  left.name.localeCompare(right.name, 'en', { sensitivity: 'base' }) ||\n  left.id.localeCompare(right.id)\n\n/** The largest children `$top` a fixture sends (`$top=200`, create-folder and copy cases). */\nconst childrenMaxTop = 200\n\n/**\n * `GET /drives/{driveId}/items/{itemId}/children`: by name, at most `$top` (one page only;\n * `$top` required, at most `childrenMaxTop`).\n */\nexport const listChildren: RouteHandler = (state, request, env) => {\n  const drive = driveProblem(state, request)\n\n  if (drive !== undefined) return drive\n\n  const fields = selectedFields(request, itemFields)\n\n  if (fields instanceof Response) return fields\n\n  const parent = findItem(state, request.params.itemId ?? '')\n\n  if (parent === undefined) return notFound(request)\n\n  if (parent.kind !== 'folder') return notEmulated(request, 'children of a file are not emulated.')\n\n  const page = singlePage([...childrenOf(state, parent.id)].sort(byName), request, childrenMaxTop)\n\n  if (page instanceof Response) return page\n\n  return jsonResponse(\n    200,\n    collection(\n      metadataContext(env, `${childrenContext(request)}${selectSuffix(fields)}`),\n      page.map(item => project(renderItem(state, env, item), fields)),\n      undefined\n    )\n  )\n}\n\nconst invalidNamePattern = /[\"*:<>?/\\\\|]/\n\nconst nameProblem = (request: RouteRequest, name: unknown): string | Response =>\n  Predicate.isString(name) &&\n  name.trim() !== '' &&\n  name.trim() === name &&\n  !invalidNamePattern.test(name) &&\n  name !== '.' &&\n  name !== '..' &&\n  !name.endsWith('.')\n    ? name\n    : invalidValue(request, 'the item name is empty or has characters OneDrive does not allow.')\n\nconst nameTaken = (state: MicrosoftEmulatorState, parentId: string, name: string): boolean =>\n  childrenOf(state, parentId).some(child => child.name.toLowerCase() === name.toLowerCase())\n\nconst nextItemId = (state: MicrosoftEmulatorState): string => {\n  let number = state.counters.nextItemNumber\n  let id = `01SYNTHETICITEM${padded(number, 17)}`\n\n  while (state.driveItems.some(item => item.id === id)) {\n    number += 1\n    id = `01SYNTHETICITEM${padded(number, 17)}`\n  }\n\n  state.counters = { ...state.counters, nextItemNumber: number + 1 }\n\n  return id\n}\n\nconst nameConflict = (request: RouteRequest): Response =>\n  notEmulated(request, 'name conflicts are not emulated (the name is already taken).')\n\n/** Only `fail`, as the fixtures send it; anything else (or none) is not emulated. */\nconst conflictBehaviorProblem = (request: RouteRequest, value: unknown): Response | undefined =>\n  value === 'fail'\n    ? undefined\n    : notEmulated(\n        request,\n        '@microsoft.graph.conflictBehavior must be fail (other or missing values are not emulated).'\n      )\n\n/**\n * `POST /drives/{driveId}/items/{itemId}/children` with a `folder` facet and\n * `@microsoft.graph.conflictBehavior: fail`: 201 with the folder. A taken name, and creating\n * files here, are not emulated.\n */\nexport const createFolder: RouteHandler = (state, request, env) => {\n  const drive = driveProblem(state, request)\n\n  if (drive !== undefined) return drive\n\n  const parent = findItem(state, request.params.itemId ?? '')\n\n  if (parent === undefined) return notFound(request)\n\n  if (parent.kind !== 'folder') return invalidValue(request, 'the parent item is not a folder.')\n\n  const fields = bodyObject(request, ['name', 'folder', '@microsoft.graph.conflictBehavior'])\n\n  if (fields instanceof Response) return fields\n\n  if (fields.folder === undefined) {\n    return notEmulated(request, 'only folder creation (a folder facet) is emulated here.')\n  }\n\n  const folderFacet = fields.folder\n\n  if (!isJsonObject(folderFacet) || Object.keys(folderFacet).length > 0) {\n    return notEmulated(request, 'the folder facet must be {}.')\n  }\n\n  const name = nameProblem(request, fields.name)\n\n  if (name instanceof Response) return name\n\n  const behavior = conflictBehaviorProblem(request, fields['@microsoft.graph.conflictBehavior'])\n\n  if (behavior !== undefined) return behavior\n\n  if (nameTaken(state, parent.id, name)) return nameConflict(request)\n\n  const now = nowTimestamp(env)\n\n  const folder: MicrosoftEmulatorDriveItem = {\n    id: nextItemId(state),\n    parentId: parent.id,\n    name,\n    kind: 'folder',\n    size: 0,\n    mimeType: null,\n    quickXorHash: null,\n    createdDateTime: now,\n    lastModifiedDateTime: now\n  }\n\n  state.driveItems = [...state.driveItems, folder]\n\n  return jsonResponse(\n    201,\n    entity(\n      metadataContext(env, `${childrenContext(request)}/$entity`),\n      renderItem(state, env, folder)\n    )\n  )\n}\n\n/** `DELETE /drives/{driveId}/items/{itemId}`: 204; the item and its subtree are removed. */\nexport const deleteItem: RouteHandler = (state, request) => {\n  const drive = driveProblem(state, request)\n\n  if (drive !== undefined) return drive\n\n  const item = findItem(state, request.params.itemId ?? '')\n\n  if (item === undefined) return notFound(request)\n\n  if (item.parentId === null)\n    return notEmulated(request, 'deleting the drive root is not emulated.')\n\n  const removed = new Set(subtreeOf(state, item).map(entry => entry.id))\n\n  state.driveItems = state.driveItems.filter(entry => !removed.has(entry.id))\n\n  return emptyResponse(204)\n}\n\nconst monitorPath = (state: MicrosoftEmulatorState, id: string) =>\n  `/personal/${personalSite(state.user)}/_api/v2.0/monitor/${id}`\n\n/**\n * `POST /drives/{driveId}/items/{itemId}/copy` (`{ parentReference: { driveId, id } }`, query\n * `@microsoft.graph.conflictBehavior=fail`): 202 with an empty body and one monitor `Location`.\n * The copy itself runs when the monitor reports completion. Only what the copy fixture sends is\n * emulated: a file source, a destination on the same drive named by `driveId` and `id`, and the\n * source's name (a new `name`, a folder source, or a missing `driveId` fail closed).\n */\nexport const copyItem: RouteHandler = (state, request, env) => {\n  const drive = driveProblem(state, request)\n\n  if (drive !== undefined) return drive\n\n  const source = findItem(state, request.params.itemId ?? '')\n\n  if (source === undefined) return notFound(request)\n\n  if (source.kind !== 'file') {\n    return notEmulated(request, 'copying a folder is not emulated (the fixture copies a file).')\n  }\n\n  const behavior = conflictBehaviorProblem(\n    request,\n    request.query.get('@microsoft.graph.conflictBehavior') ?? undefined\n  )\n\n  if (behavior !== undefined) return behavior\n\n  // A new `name` fails here too: the fixture's copy keeps the source's name.\n  const fields = bodyObject(request, ['parentReference'])\n\n  if (fields instanceof Response) return fields\n\n  const reference = nestedObject(\n    request,\n    fields.parentReference,\n    ['driveId', 'id'],\n    'parentReference { driveId, id }'\n  )\n\n  if (reference instanceof Response) return reference\n\n  if (reference.driveId === undefined) {\n    return notEmulated(request, 'copies without parentReference.driveId are not emulated.')\n  }\n\n  if (!Predicate.isString(reference.id) || !Predicate.isString(reference.driveId)) {\n    return invalidValue(request, 'parentReference must be { driveId, id } with string values.')\n  }\n\n  if (reference.driveId !== state.drive.id) {\n    return notEmulated(request, 'copies to another drive are not emulated.')\n  }\n\n  const destination = findItem(state, reference.id)\n\n  if (destination === undefined) return notFound(request)\n\n  if (destination.kind !== 'folder') {\n    return invalidValue(request, 'the destination is not a folder.')\n  }\n\n  const number = env.monitorCounter.next\n\n  env.monitorCounter.next += 1\n\n  const monitor: CopyMonitor = {\n    id: `00000000-0000-4000-8000-${padded(number, 12)}`,\n    sourceId: source.id,\n    destinationParentId: destination.id,\n    pollsLeft: env.copyInProgressPolls,\n    resourceId: undefined\n  }\n\n  env.monitors.set(monitor.id, monitor)\n\n  return emptyResponse(202, {\n    location: `${env.sharePointOrigin}${monitorPath(state, monitor.id)}`\n  })\n}\n\n/** Copy the file `item` under `parentId` with a fresh id and its name; returns the new id. */\nconst copyFile = (\n  state: MicrosoftEmulatorState,\n  env: MicrosoftApiEnv,\n  item: MicrosoftEmulatorDriveItem,\n  parentId: string\n): string => {\n  const now = nowTimestamp(env)\n\n  const copy: MicrosoftEmulatorDriveItem = {\n    ...item,\n    id: nextItemId(state),\n    parentId,\n    createdDateTime: now,\n    lastModifiedDateTime: now\n  }\n\n  state.driveItems = [...state.driveItems, copy]\n\n  return copy.id\n}\n\n/**\n * Run a monitored copy: its `resourceId`, or why it cannot run (the source or destination is\n * gone, or the name is taken; no fixture records a failed copy).\n */\nconst runCopy = (\n  state: MicrosoftEmulatorState,\n  env: MicrosoftApiEnv,\n  monitor: CopyMonitor\n): string | { readonly problem: string } => {\n  const source = findItem(state, monitor.sourceId)\n  const destination = findItem(state, monitor.destinationParentId)\n\n  if (source === undefined || destination === undefined || destination.kind !== 'folder') {\n    return { problem: 'the copy source or destination no longer exists' }\n  }\n\n  if (nameTaken(state, destination.id, source.name)) {\n    return { problem: 'the copy name is already taken in the destination' }\n  }\n\n  return copyFile(state, env, source, destination.id)\n}\n\nconst monitorContentType = 'application/json;odata.metadata=minimal;odata.streaming=true'\n\n/**\n * `GET /personal/{site}/_api/v2.0/monitor/{monitorId}` on the SharePoint origin (no credentials\n * needed, like the real capability URL): `inProgress` (202) while polls remain, then the copy runs\n * once and every later poll answers `completed` (200, `resourceId`). A copy that cannot run\n * answers 400 not emulated (failed copies are not emulated) and stays pending.\n */\nexport const copyMonitor: RouteHandler = (state, request, env) => {\n  const monitor = env.monitors.get(request.params.monitorId ?? '')\n\n  if (monitor === undefined || request.params.site !== personalSite(state.user)) {\n    return notFound(request)\n  }\n\n  const context = `${env.sharePointOrigin}/personal/${personalSite(state.user)}/_api/v2.0/$metadata#oneDrive.asynchronousOperationStatus`\n  const headers = { 'content-type': monitorContentType }\n\n  if (monitor.resourceId === undefined && monitor.pollsLeft > 0) {\n    monitor.pollsLeft -= 1\n\n    return jsonResponse(\n      202,\n      { '@odata.context': context, percentageComplete: 0, status: 'inProgress' },\n      headers\n    )\n  }\n\n  const resourceId = monitor.resourceId ?? runCopy(state, env, monitor)\n\n  if (!Predicate.isString(resourceId)) {\n    return notEmulated(request, `${resourceId.problem} (failed copies are not emulated).`)\n  }\n\n  monitor.resourceId = resourceId\n\n  return jsonResponse(\n    200,\n    {\n      '@odata.context': context,\n      percentageComplete: 100,\n      resourceId,\n      status: 'completed'\n    },\n    headers\n  )\n}\n"],"mappings":"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"}

package/dist/microsoft/graph.d.mts

@@ -0,0 +1,198 @@
+import { MicrosoftEmulatorState, MicrosoftEmulatorUser } from "./state.mjs";
+import * as Schema from "effect/Schema";
+
+//#region src/microsoft/graph.d.ts
+/**
+ * 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.
+ */
+declare const microsoftEmulatorErrorCodes: {
+  readonly mailItemNotFound: "ErrorItemNotFound";
+  readonly driveItemNotFound: "itemNotFound";
+  readonly conflict: "ErrorIrresolvableConflict";
+  readonly unauthenticated: "InvalidAuthenticationToken";
+  readonly invalidUser: "ErrorInvalidUser";
+  readonly rateLimited: "TooManyRequests";
+  readonly unknownRoute: "SyntheticRouteNotEmulated";
+  readonly unsupportedQuery: "SyntheticQueryNotEmulated";
+  readonly unsupportedValue: "SyntheticValueNotEmulated";
+  readonly invalidRequest: "SyntheticInvalidRequest";
+  readonly invalidBody: "SyntheticInvalidBody";
+  readonly upstreamError: "SyntheticUpstreamError";
+};
+declare const codes: {
+  readonly mailItemNotFound: "ErrorItemNotFound";
+  readonly driveItemNotFound: "itemNotFound";
+  readonly conflict: "ErrorIrresolvableConflict";
+  readonly unauthenticated: "InvalidAuthenticationToken";
+  readonly invalidUser: "ErrorInvalidUser";
+  readonly rateLimited: "TooManyRequests";
+  readonly unknownRoute: "SyntheticRouteNotEmulated";
+  readonly unsupportedQuery: "SyntheticQueryNotEmulated";
+  readonly unsupportedValue: "SyntheticValueNotEmulated";
+  readonly invalidRequest: "SyntheticInvalidRequest";
+  readonly invalidBody: "SyntheticInvalidBody";
+  readonly upstreamError: "SyntheticUpstreamError";
+};
+/** Graph JSON content type, as the fixtures record it. */
+declare const graphContentType = "application/json; odata.metadata=minimal; odata.streaming=true; IEEE754Compatible=false; charset=utf-8";
+declare const jsonResponse: (status: number, body: unknown, headers?: HeadersInit) => Response;
+/** Graph API version prefix of every Graph route. */
+declare const microsoftEmulatorBasePath = "/v1.0";
+/** A percent-decoded path segment, or `undefined` for invalid percent-encoding. */
+declare const decodeSegment: (segment: string) => string | undefined;
+/**
+ * An OData key segment as the fixtures write it in `@odata.context`: `('ada%40example.test')`,
+ * `('b%21synthetic-drive-0001')` (percent-encoded, including `!'()*`).
+ */
+declare const odataKey: (value: string) => string;
+/** `(a,b,c)` for a `$select`, empty without one, as the fixture contexts write it. */
+declare const selectSuffix: (fields: ReadonlyArray<string> | undefined) => string;
+/** The fixture `@odata.context` URL: `{graphOrigin}/v1.0/$metadata#{path}`. */
+declare const metadataContext: (env: MicrosoftApiEnv, path: string) => string;
+/** An entity body with its `@odata.context` first, as the fixtures record it. */
+declare const entity: (context: string, body: Schema.JsonObject) => Schema.JsonObject;
+/** A bodiless success (204 delete, 202 cancel/copy), as the fixtures record them. */
+declare const emptyResponse: (status: number, headers?: HeadersInit) => Response;
+/** Where a Graph error envelope's `innerError` values come from. */
+type ErrorContext = {
+  /** `innerError.date` (`YYYY-MM-DDTHH:MM:SS`, UTC). */readonly date: string;
+  readonly requestId: string;
+  readonly clientRequestId: string;
+};
+/** The Graph error envelope `{ error: { code, message, innerError } }`. */
+declare const graphError: (context: ErrorContext, status: number, code: string, message: string) => Response;
+declare const padded: (value: number, width: number) => string;
+/** A synthetic request id for ledger sequence `seq`. */
+declare const syntheticRequestId: (seq: number) => string;
+/** The error context of one request; `client-request-id` is echoed only when it is plain. */
+declare const errorContext: (now: number, seq: number, clientRequestId: string | null) => ErrorContext;
+/** The parsed `Prefer` preferences the emulator reads (others are ignored, as Graph does). */
+type Preferences = {
+  /** `IdType="ImmutableId"`: answer message ids in immutable form. */readonly immutableId: boolean; /** `outlook.timezone`, when sent. */
+  readonly timezone: string | undefined;
+};
+/** Parse `Prefer`: comma-separated `name=value` preferences. */
+declare const parsePreferences: (header: string | null) => Preferences;
+/** One routed API request, as the handlers see it. */
+type RouteRequest = {
+  /** Decoded path parameters. */readonly params: Readonly<Record<string, string>>; /** Raw (still percent-encoded) path, for example `/v1.0/users/ada%40example.test/...`. */
+  readonly path: string;
+  readonly query: URLSearchParams; /** Parsed JSON body; `undefined` when absent. */
+  readonly body: Schema.Json | undefined;
+  readonly prefer: Preferences; /** A Graph error envelope response for this request. */
+  readonly error: (status: number, code: string, message: string) => Response;
+};
+/** Drill knobs (tests only): each makes the emulator disagree with one conformance claim. */
+type MicrosoftEmulatorDrills = {
+  /** `true`: `calendarView` answers an empty `value` for every range. */readonly calendarRangeEmpty?: boolean; /** `true`: event create answers 201 without the new event's `id` (the event is still created). */
+  readonly createOmitsId?: boolean; /** Fractional digits of event `dateTime` values (Graph uses 7); `3` drills the precision case. */
+  readonly timestampPrecisionDigits?: number; /** `true`: folder message pages never carry `@odata.nextLink`. */
+  readonly omitNextLink?: boolean;
+};
+/** A OneDrive copy the monitor reports on (runtime-only, like the ledger; not in the state). */
+type CopyMonitor = {
+  readonly id: string;
+  readonly sourceId: string;
+  readonly destinationParentId: string; /** In-progress answers left before the copy runs and completes. */
+  pollsLeft: number; /** Set once the copy ran and completed. */
+  resourceId: string | undefined;
+};
+type MicrosoftApiEnv = {
+  /** Clock in epoch milliseconds (timestamps of created items). */readonly now: () => number; /** Origin of `@odata.nextLink` values, for example `https://graph.microsoft.com`. */
+  readonly graphOrigin: string; /** Origin of OneDrive `webUrl` values and copy monitor URLs. */
+  readonly sharePointOrigin: string;
+  readonly drills: Required<MicrosoftEmulatorDrills>; /** In-progress monitor answers before a copy completes (default 0: the first poll completes). */
+  readonly copyInProgressPolls: number; /** How long a message write holds its message; a concurrent write in that time loses (409). */
+  readonly conflictWindowMs: number; /** Immutable ids of messages with a write in flight (runtime-only). */
+  readonly messageLocks: Set<string>; /** Copy monitors by id (runtime-only; cleared by reset and seed). */
+  readonly monitors: Map<string, CopyMonitor>;
+  readonly monitorCounter: {
+    next: number;
+  };
+};
+/**
+ * A message write's answer and the message it holds once committed: the write holds it for
+ * `conflictWindowMs` before answering, so an overlapping write to it gets 409.
+ */
+type HeldAnswer = {
+  readonly response: Response; /** Immutable id of the message held. */
+  readonly holds: string;
+};
+/**
+ * A route handler. It runs on a draft of the state and of the copy monitors (see
+ * `registerMicrosoftApi`) and decides the whole answer synchronously; it replaces whole state lists
+ * and counters, never editing them in place. Any answer that is not 2xx is a refusal.
+ */
+type RouteHandler = (state: MicrosoftEmulatorState, request: RouteRequest, env: MicrosoftApiEnv) => Response | HeldAnswer;
+declare const isJsonObject: (value: Schema.Json | undefined) => value is Schema.JsonObject;
+/** Parsed JSON, or `undefined` for invalid JSON. */
+declare const parseJsonText: (text: string) => Schema.Json | undefined;
+/** The user a `/users/{userId}` segment names (id, `mail`, or UPN, case-insensitive). */
+declare const resolveUser: (state: MicrosoftEmulatorState, request: RouteRequest) => MicrosoftEmulatorUser | Response;
+/** The `$select` fields, `undefined` without `$select`, or a 400 for a field not emulated. */
+declare const selectedFields: (request: RouteRequest, allowed: ReadonlyArray<string>) => ReadonlyArray<string> | undefined | Response;
+/** Keep only the selected keys (plus annotations and `id`); everything without `$select`. */
+declare const project: (full: Schema.JsonObject, fields: ReadonlyArray<string> | undefined) => Schema.JsonObject;
+type Page<A> = {
+  readonly items: ReadonlyArray<A>;
+  readonly top: number; /** `$skip` of the next page, when there is one. */
+  readonly nextSkip: number | undefined;
+};
+/**
+ * One `$top`/`$skip` page of `items`. `$top` is required and at most `maxTop` (see
+ * `requiredTop`); no fixture records a default page size.
+ */
+declare const pageOf: <A>(items: ReadonlyArray<A>, request: RouteRequest, maxTop: number) => Page<A> | Response;
+/**
+ * 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).
+ */
+declare const singlePage: <A>(items: ReadonlyArray<A>, request: RouteRequest, maxTop: number) => ReadonlyArray<A> | Response;
+/**
+ * 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).
+ */
+declare const nextLinkOf: (env: MicrosoftApiEnv, request: RouteRequest, page: Page<unknown>, carried: ReadonlyArray<string>) => string | undefined;
+/** `{ @odata.context, value, @odata.nextLink? }`, as the fixture pages record them. */
+declare const collection: (context: string, value: ReadonlyArray<unknown>, nextLink: string | undefined) => {
+  '@odata.context': string;
+  value: readonly unknown[];
+  '@odata.nextLink'?: undefined;
+} | {
+  '@odata.context': string;
+  value: readonly unknown[];
+  '@odata.nextLink': string;
+};
+/** A write body that is a JSON object with only `allowed` keys, or a 400. */
+declare const bodyObject: (request: RouteRequest, allowed: ReadonlyArray<string>) => Schema.JsonObject | Response;
+/** 400 for an invalid value. */
+declare const invalidValue: (request: RouteRequest, message: string) => Response;
+/** 400 for a valid Graph request the emulator does not emulate (fail closed). */
+declare const notEmulated: (request: RouteRequest, message: string) => Response;
+/**
+ * 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.
+ */
+declare const nestedObject: (request: RouteRequest, value: Schema.Json | undefined, allowed: ReadonlyArray<string>, expected: string) => Schema.JsonObject | Response;
+/**
+ * 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.
+ */
+declare const textBody: (request: RouteRequest, value: Schema.Json | undefined) => string | Response;
+/** A Graph timestamp (`2026-09-29T10:00:00Z`) from the emulator clock. */
+declare const nowTimestamp: (env: MicrosoftApiEnv) => string;
+/** The next change key (bumps the counter). */
+declare const nextChangeKey: (state: MicrosoftEmulatorState, prefix: string) => string;
+/** The `personal/{site}` segment of the mailbox owner (`ada@example.test` → `ada_example_test`). */
+declare const personalSite: (user: MicrosoftEmulatorUser) => string;
+//#endregion
+export { CopyMonitor, ErrorContext, HeldAnswer, MicrosoftApiEnv, MicrosoftEmulatorDrills, Page, Preferences, RouteHandler, RouteRequest, 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.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.mts","names":[],"sources":["../../src/microsoft/graph.ts"],"mappings":"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"}