emdash 0.39.0 → 0.40.0

package/dist/astro/routes/api/openapi.json.mjs

@@ -1,11 +1,26 @@
-import "../../../config-CGVeT8Hc.mjs";
+import "../../../dialect-helpers-7_IqPdh9.mjs";
+import "../../../config-CvmjJcVw.mjs";
 import "../../../base64-DvnNgP7e.mjs";
 import "../../../types-BkUg2yHx.mjs";
-import { r as handleError } from "../../../error-CCTCskie.mjs";
-import { _ as deleteResponseSchema, a as notFoundPruneBody, d as redirectsListQuery, f as updateRedirectBody, i as notFoundListResponseSchema, l as redirectListResponseSchema, m as apiErrorSchema, r as notFoundListQuery, s as notFoundSummaryResponseSchema, t as createRedirectBody, u as redirectSchema, w as successEnvelope } from "../../../redirects-BCiTaIQ-.mjs";
-import { $ as createMenuItemBody, $n as contentRevisionConditionBody, $t as mediaReplaceResponseSchema, A as createSectionBody, An as mediaUsageRepairResponseSchema, At as DEFAULT_MAX_UPLOAD_SIZE, B as taxonomyListResponseSchema, Bt as mediaFolderResponseSchema, C as searchQuery, Cn as mediaUsageDetailsResponseSchema, Ct as orphanRegisterBody, D as searchSuggestQuery, Dn as mediaUsageProgressSchema, Dt as updateCollectionBody, En as mediaUsageProgressAdvanceResponseSchema, Fn as mediaUsageWorkListQuery, Ft as mediaExistingResponseSchema, G as termReorderResponseSchema, H as termGetResponseSchema, Hn as contentAuthorsResponseSchema, Ht as mediaGetQuery, I as createTermBody, In as mediaUsageWorkListResponseSchema, It as mediaFolderBody, Jn as contentListResponseSchema, K as termResponseSchema, Kn as contentItemSchema, Kt as mediaListReadResponseSchema, L as reorderTermsBody, Ln as mediaUsageWorkRetryBody, Lt as mediaFolderIdSchema, M as sectionSchema, Mt as mediaConfirmBody, N as sectionsListQuery, Nt as mediaConfirmResponseSchema, O as settingsUpdateBody, On as mediaUsageRepairBody, Ot as updateFieldBody, P as updateSectionBody, Pt as mediaDirectUploadBody, Q as createMenuBody, Qn as contentRestoreResponseSchema, Rn as mediaUsageWorkRetryConflictSchema, Rt as mediaFolderListQuery, S as searchEnableBody, Sn as mediaUsageDetailsQuery, T as searchResponseSchema, U as termListQuery, Un as contentCompareResponseSchema, V as taxonomyResponseSchema, W as termListResponseSchema, Wn as contentCreateBody, Wt as mediaListQuery, X as updateTaxonomyDefBody, Xn as contentPublishBody, Xt as mediaReadResponseSchema, Z as updateTermBody, Zn as contentResponseSchema, Zt as mediaReplaceBody, _ as userDetailSchema, _n as mediaUsageCollectionDeletionRetryBody, _t as createCollectionBody, a as entryLockStatusSchema, an as mediaUploadResponseSchema, at as menuWithItemsSchema, b as userUpdateBody, bt as fieldReorderBody, c as createWidgetBody, cn as mediaUsageActivationAdvanceBody, cr as contentUpdateBody, ct as updateMenuItemBody, d as widgetAreaSchema, dt as collectionGetQuery, en as mediaResponseSchema, er as contentScheduleBody, et as menuItemSchema, f as widgetAreaWithWidgetsAndCountSchema, fn as mediaUsageActivationStatusSchema, ft as collectionListResponseSchema, g as allowedDomainUpdateBody, gt as collectionWithFieldsResponseSchema, h as allowedDomainCreateBody, hn as mediaUsageCollectionDeletionListResponseSchema, i as entryLockReleaseResponseSchema, ir as contentTermsResponseSchema, j as sectionListResponseSchema, k as siteSettingsSchema, l as reorderWidgetsBody, ln as mediaUsageActivationAdvanceResponseSchema, m as widgetSchema, mn as mediaUsageCollectionDeletionListQuery, mt as collectionResponseSchema, nn as mediaUpdateBody, nt as menuListItemSchema, o as entryMutationConflictSchema, on as mediaUploadUrlBody, or as contentTranslationsResponseSchema, ot as reorderMenuItemsBody, p as widgetAreaWithWidgetsSchema, pt as collectionReorderBody, qn as contentListQuery, qt as mediaListResponseSchema, rr as contentTermsBody, s as createWidgetAreaBody, sn as mediaUploadUrlResponseSchema, sr as contentTrashQuery, st as updateMenuBody, t as entryLockAcquireBody, tn as mediaStreamUploadResponseSchema, u as updateWidgetBody, un as mediaUsageActivationConflictSchema, ur as trashedContentListResponseSchema, v as userListResponseSchema, vn as mediaUsageCollectionDeletionRetryResponseSchema, vt as createFieldBody, w as searchRebuildBody, wt as orphanedTableListResponseSchema, x as usersListQuery, xt as fieldResponseSchema, y as userSchema, yt as fieldListResponseSchema, z as taxonomyDefTranslationsSchema, zn as mediaUsageWorkRetryResponseSchema, zt as mediaFolderListResponseSchema } from "../../../entry-lock-D3C99MXS.mjs";
-import { a as commentListQuery, c as createCommentBody, i as commentCountsResponseSchema, n as commentBulkBody, o as commentSchema, r as commentBulkResponseSchema, s as commentStatusBody, t as adminCommentListResponseSchema, u as publicCommentListResponseSchema } from "../../../comments-BVzzt6x5.mjs";
-import "../../../status-DLoBmcDz.mjs";
+import "../../../errors-DgE1zJGG.mjs";
+import "../../../canonical-YhEQezjg.mjs";
+import "../../../digest-BarSh-pN.mjs";
+import "../../../settings-DYidIB26.mjs";
+import "../../../site-settings-DOgRUoFX.mjs";
+import "../../../errors-BF0_LFhW.mjs";
+import { r as handleError } from "../../../error-CfvOHP0M.mjs";
+import { T as successEnvelope, _ as deleteResponseSchema, a as notFoundPruneBody, d as redirectsListQuery, f as updateRedirectBody, i as notFoundListResponseSchema, l as redirectListResponseSchema, m as apiErrorSchema, r as notFoundListQuery, s as notFoundSummaryResponseSchema, t as createRedirectBody, u as redirectSchema, x as mediaDeleteResponseSchema } from "../../../redirects-Cv9apQKj.mjs";
+import { $ as activateBlockTypeVersionBody, A as createSectionBody, At as contentItemSchema, B as taxonomyDefTranslationsSchema, C as searchQuery, Ct as updateCollectionBody, D as searchSuggestQuery, Dt as contentCompareResponseSchema, Et as contentAuthorsResponseSchema, Ft as contentResponseSchema, G as termListResponseSchema, Gt as contentTrashQuery, H as taxonomyResponseSchema, Ht as contentTermsResponseSchema, It as contentRestoreResponseSchema, Jt as trashedContentListResponseSchema, K as termReorderResponseSchema, Kt as contentUpdateBody, L as createTermBody, Lt as contentRevisionConditionBody, M as sectionSchema, Mt as contentListResponseSchema, N as sectionsListQuery, O as settingsUpdateBody, Ot as contentCreateBody, P as updateSectionBody, Pt as contentPublishBody, Q as updateTermBody, R as reorderTermsBody, Rt as contentScheduleBody, S as searchEnableBody, St as updateBlockTypeBody, T as searchResponseSchema, U as termGetResponseSchema, V as taxonomyListResponseSchema, Vt as contentTermsBody, W as termListQuery, Wt as contentTranslationsResponseSchema, Z as updateTaxonomyDefBody, _ as userDetailSchema, a as entryLockStatusSchema, at as collectionGetQuery, b as userUpdateBody, c as createWidgetBody, ct as collectionResponseSchema, d as widgetAreaSchema, dt as createBlockTypeBody, f as widgetAreaWithWidgetsAndCountSchema, ft as createCollectionBody, g as allowedDomainUpdateBody, gt as fieldResponseSchema, h as allowedDomainCreateBody, ht as fieldReorderBody, i as entryLockReleaseResponseSchema, j as sectionListResponseSchema, jt as contentListQuery, k as siteSettingsSchema, l as reorderWidgetsBody, m as widgetSchema, mt as fieldListResponseSchema, nt as blockTypeResponseSchema, o as entryMutationConflictSchema, ot as collectionListResponseSchema, p as widgetAreaWithWidgetsSchema, pt as createFieldBody, q as termResponseSchema, s as createWidgetAreaBody, st as collectionReorderBody, t as entryLockAcquireBody, tt as blockTypeListResponseSchema, u as updateWidgetBody, ut as collectionWithFieldsResponseSchema, v as userListResponseSchema, vt as orphanRegisterBody, w as searchRebuildBody, wt as updateFieldBody, x as usersListQuery, y as userSchema, yt as orphanedTableListResponseSchema } from "../../../entry-lock-BJYdBfXb.mjs";
+import { $ as mediaUsageProgressSchema, B as mediaUsageCollectionDeletionListQuery, C as mediaReplaceBody, D as mediaStreamUploadResponseSchema, E as mediaResponseSchema, F as mediaUsageActivationAdvanceResponseSchema, I as mediaUsageActivationConflictSchema, J as mediaUsageDetailsQuery, M as mediaUploadUrlBody, N as mediaUploadUrlResponseSchema, O as mediaUpdateBody, P as mediaUsageActivationAdvanceBody, Q as mediaUsageProgressAdvanceResponseSchema, R as mediaUsageActivationStatusSchema, S as mediaReadResponseSchema, T as mediaReplaceResponseSchema, U as mediaUsageCollectionDeletionRetryBody, V as mediaUsageCollectionDeletionListResponseSchema, W as mediaUsageCollectionDeletionRetryResponseSchema, Y as mediaUsageDetailsResponseSchema, a as mediaConfirmResponseSchema, c as mediaFolderBody, ct as mediaUsageWorkListQuery, d as mediaFolderListResponseSchema, dt as mediaUsageWorkRetryConflictSchema, et as mediaUsageRepairBody, f as mediaFolderResponseSchema, ft as mediaUsageWorkRetryResponseSchema, g as mediaListQuery, i as mediaConfirmBody, j as mediaUploadResponseSchema, l as mediaFolderIdSchema, lt as mediaUsageWorkListResponseSchema, m as mediaGetQuery, n as DEFAULT_MAX_UPLOAD_SIZE, nt as mediaUsageRepairResponseSchema, o as mediaDirectUploadBody, s as mediaExistingResponseSchema, u as mediaFolderListQuery, ut as mediaUsageWorkRetryBody, v as mediaListReadResponseSchema, y as mediaListResponseSchema } from "../../../media-Pu1L6xir.mjs";
+import { a as commentListQuery, c as createCommentBody, i as commentCountsResponseSchema, n as commentBulkBody, o as commentSchema, r as commentBulkResponseSchema, s as commentStatusBody, t as adminCommentListResponseSchema, u as publicCommentListResponseSchema } from "../../../comments-fHZ8ON9O.mjs";
+import { a as menuListItemSchema, c as menuWithItemsSchema, d as updateMenuBody, f as updateMenuItemBody, l as reorderMenuItemsBody, n as createMenuItemBody, r as menuItemSchema, t as createMenuBody } from "../../../menus-BM7BPLOb.mjs";
+import "../../../status-DZKIG4a9.mjs";
+import "../../../kinds-CRu_T5T5.mjs";
+import "../../../transformations-9gfpwY65.mjs";
+import "../../../version-BRZXVifl.mjs";
+import "../../../approvals-CqMfNxak.mjs";
+import "../../../plan-xjcWrAah.mjs";
+import { _ as transferOperationListResponseSchema, a as transferCapabilitiesSchema, c as transferFileUploadResponseSchema, d as transferImportCreateResponseSchema, f as transferImportExecuteBody, g as transferMissingFilesResponseSchema, h as transferImportStatusResponseSchema, i as transferApprovalResponseSchema, l as transferImportAnalyzeBody, m as transferImportReceiptResponseSchema, n as transferApprovalListQuery, o as transferExportCreateBody, p as transferImportPlanResponseSchema, r as transferApprovalListResponseSchema, s as transferExportCreateResponseSchema, t as transferAdvanceResponseSchema, u as transferImportAnalyzeResponseSchema, v as transferOperationResponseSchema, y as transferPaginationQuery } from "../../../transfer-DIGvR9Af.mjs";
 import { z } from "zod";
 import { globalRegistry } from "zod/v4/core";
 import { globalRegistry as globalRegistry$1, object, registry, toJSONSchema } from "zod/v4";
@@ -906,9 +921,12 @@ function standardErrors(...codes) {
 		403: "Forbidden",
 		404: "Not Found",
 		409: "Conflict",
+		410: "Gone",
+		411: "Length Required",
 		413: "Payload Too Large",
 		422: "Unprocessable Entity",
-		500: "Internal Server Error"
+		500: "Internal Server Error",
+		503: "Service Unavailable"
 	};
 	for (const code of codes) responses[String(code)] = {
 		description: errorMap[code] ?? `Error ${code}`,
@@ -1496,7 +1514,7 @@ function buildMediaPaths(maxUploadSize) {
 				responses: {
 					"200": {
 						description: "Deleted",
-						content: { [JSON_CONTENT]: { schema: successEnvelope(deleteResponseSchema) } }
+						content: { [JSON_CONTENT]: { schema: successEnvelope(mediaDeleteResponseSchema) } }
 					},
 					...authErrors,
 					...standardErrors(404, 500)
@@ -1506,7 +1524,7 @@ function buildMediaPaths(maxUploadSize) {
 		"/_emdash/api/media/{id}/usage": { get: {
 			operationId: "getMediaUsage",
 			summary: "Get media usage details",
-			description: "Returns paginated content entry groups whose current indexed sources reference a local media item. Results include aggregate coverage and are advisory during concurrent writes. Requires media read and draft-content read permission; token-authenticated callers also require admin scope.",
+			description: "Returns paginated content entry groups whose current indexed sources reference a local media item, and the site settings that select it. Results include aggregate coverage and are advisory during concurrent writes. Requires media read and draft-content read permission; token-authenticated callers also require admin scope.",
 			tags: ["Media"],
 			requestParams: {
 				path: z.object({ id: z.string().meta({ description: "Media ID" }) }),
@@ -1754,6 +1772,84 @@ function buildMediaPaths(maxUploadSize) {
 	};
 }
 const schemaPaths = {
+	"/_emdash/api/schema/block-types": {
+		get: {
+			operationId: "listBlockTypes",
+			summary: "List block types",
+			tags: ["Schema"],
+			responses: {
+				"200": {
+					description: "Block type list",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(blockTypeListResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(500)
+			}
+		},
+		post: {
+			operationId: "createBlockType",
+			summary: "Create a block type",
+			tags: ["Schema"],
+			requestBody: { content: { [JSON_CONTENT]: { schema: createBlockTypeBody } } },
+			responses: {
+				"201": {
+					description: "Created block type",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(blockTypeResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(400, 409, 500)
+			}
+		}
+	},
+	"/_emdash/api/schema/block-types/{slug}": {
+		get: {
+			operationId: "getBlockType",
+			summary: "Get a block type",
+			tags: ["Schema"],
+			requestParams: { path: z.object({ slug: z.string() }) },
+			responses: {
+				"200": {
+					description: "Block type",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(blockTypeResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(404, 500)
+			}
+		},
+		put: {
+			operationId: "updateBlockType",
+			summary: "Update a block type",
+			tags: ["Schema"],
+			requestParams: { path: z.object({ slug: z.string() }) },
+			requestBody: { content: { [JSON_CONTENT]: { schema: updateBlockTypeBody } } },
+			responses: {
+				"200": {
+					description: "Updated block type",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(blockTypeResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(400, 404, 409, 500)
+			}
+		}
+	},
+	"/_emdash/api/schema/block-types/{slug}/versions/{version}/activate": { post: {
+		operationId: "activateBlockTypeVersion",
+		summary: "Activate a block type version",
+		tags: ["Schema"],
+		requestParams: { path: z.object({
+			slug: z.string(),
+			version: z.coerce.number().int().positive()
+		}) },
+		requestBody: { content: { [JSON_CONTENT]: { schema: activateBlockTypeVersionBody } } },
+		responses: {
+			"200": {
+				description: "Activated block type",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(blockTypeResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(400, 404, 409, 500)
+		}
+	} },
 	"/_emdash/api/schema/collections": {
 		get: {
 			operationId: "listCollections",
@@ -2147,7 +2243,7 @@ const taxonomyPaths = {
 		put: {
 			operationId: "updateTaxonomy",
 			summary: "Update a taxonomy definition",
-			description: "Writes the single definition `name` + `locale` resolves to. `name` and `locale` cannot be changed — terms are keyed on `name`, and each locale is its own definition row.",
+			description: "Writes `label` and `labelSingular` to the single definition `name` + `locale` resolves to. `hierarchical` and `collections` belong to the taxonomy and change for every locale. `name` and `locale` cannot be changed — terms are keyed on `name`, and each locale is its own definition row.",
 			tags: ["Taxonomies"],
 			requestParams: {
 				path: z.object({ name: z.string().meta({ description: "Taxonomy name" }) }),
@@ -3042,6 +3138,390 @@ const userPaths = {
 		}
 	}
 };
+const TRANSFER_AUTH = "Session users need the `transfer:import` permission (admins); bearer tokens need `admin` or the scope named here.";
+const importPathParams = z.object({ id: z.string().meta({ description: "Import operation ID" }) });
+const exportPathParams = z.object({ id: z.string().meta({ description: "Export operation ID" }) });
+const EXPORT_AUTH = "Session users need the `transfer:export` permission (admins); bearer tokens need the `transfer:export` scope. Any holder of both can read any export.";
+const approvalPathParams = z.object({ id: z.string().meta({ description: "Approval ID" }) });
+const transferPaths = {
+	"/_emdash/api/admin/transfer/capabilities": { get: {
+		operationId: "getTransferCapabilities",
+		summary: "Get site transfer capabilities",
+		description: "Returns the supported package format versions, features, and limits, and whether this site can receive an import (`portableDomain`, with the reasons it cannot). Session users need `transfer:export` or `transfer:import`; bearer tokens need any transfer scope.",
+		tags: ["Transfer"],
+		responses: {
+			"200": {
+				description: "Transfer capabilities",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferCapabilitiesSchema) } }
+			},
+			...authErrors,
+			...standardErrors(500)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports": {
+		get: {
+			operationId: "listTransferImports",
+			summary: "List site imports",
+			description: `Returns imports newest first. ${TRANSFER_AUTH} Scope: \`transfer:analyze\` or \`transfer:execute\`.`,
+			tags: ["Transfer"],
+			requestParams: { query: transferPaginationQuery },
+			responses: {
+				"200": {
+					description: "One page of imports",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(transferOperationListResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(400, 500)
+			}
+		},
+		post: {
+			operationId: "createTransferImport",
+			summary: "Create a site import",
+			description: `The request body is the package's \`manifest.json\`, byte for byte (at most 8 MiB). An optional \`Idempotency-Key\` header returns the existing operation on retry; reusing a key with a different manifest fails with \`TRANSFER_IDEMPOTENCY_CONFLICT\`. The response lists the first files to upload. ${TRANSFER_AUTH} Scope: \`transfer:analyze\`.`,
+			tags: ["Transfer"],
+			requestBody: {
+				required: true,
+				content: { [JSON_CONTENT]: { schema: z.string().meta({ format: "binary" }) } }
+			},
+			responses: {
+				"200": {
+					description: "Existing import for this idempotency key",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(transferImportCreateResponseSchema) } }
+				},
+				"201": {
+					description: "Import created",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(transferImportCreateResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(400, 409, 413, 422, 500, 503)
+			}
+		}
+	},
+	"/_emdash/api/admin/transfer/imports/{id}": { get: {
+		operationId: "getTransferImport",
+		summary: "Get a site import",
+		description: `Returns the import and how many of its files are uploaded. ${TRANSFER_AUTH} Scope: \`transfer:analyze\` or \`transfer:execute\`.`,
+		tags: ["Transfer"],
+		requestParams: { path: importPathParams },
+		responses: {
+			"200": {
+				description: "Import status",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferImportStatusResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(404, 500)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports/{id}/missing": { get: {
+		operationId: "listTransferImportMissingFiles",
+		summary: "List package files still to upload",
+		description: `Returns declared files that are not uploaded yet, in path order. Uploading an index chunk declares the files it lists, so list again after each round of uploads until the list is empty. ${TRANSFER_AUTH} Scope: \`transfer:analyze\`.`,
+		tags: ["Transfer"],
+		requestParams: {
+			path: importPathParams,
+			query: transferPaginationQuery
+		},
+		responses: {
+			"200": {
+				description: "One page of missing files",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferMissingFilesResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(400, 404, 500)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports/{id}/files/{path}": { put: {
+		operationId: "uploadTransferImportFile",
+		summary: "Upload one package file",
+		description: `Streams one declared package file (\`index/…\`, \`records/…\`, or \`media/…\`; the path keeps its slashes). \`Content-Length\` is required and must equal the declared size, and the bytes must match the declared SHA-256. Media files may not exceed the site's \`maxUploadSize\`. ${TRANSFER_AUTH} Scope: \`transfer:analyze\`.`,
+		tags: ["Transfer"],
+		requestParams: { path: importPathParams.extend({ path: z.string().meta({ description: "Package file path" }) }) },
+		requestBody: {
+			required: true,
+			content: { "application/octet-stream": { schema: z.string().meta({ format: "binary" }) } }
+		},
+		responses: {
+			"200": {
+				description: "File stored and verified",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferFileUploadResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(400, 404, 409, 411, 413, 422, 500, 503)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports/{id}/analyze": { post: {
+		operationId: "analyzeTransferImport",
+		summary: "Advance import analysis",
+		description: `Runs one bounded analysis step once every file is uploaded. Call again after \`nextRequestInMs\` until it is null; the response then includes the plan and its digest. Submitted decisions are applied once the import is planned. ${TRANSFER_AUTH} Scope: \`transfer:analyze\`.`,
+		tags: ["Transfer"],
+		requestParams: { path: importPathParams },
+		requestBody: {
+			required: false,
+			content: { [JSON_CONTENT]: { schema: transferImportAnalyzeBody } }
+		},
+		responses: {
+			"200": {
+				description: "Analysis progress, or the plan",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferImportAnalyzeResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(400, 404, 409, 422, 500, 503)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports/{id}/plan": { get: {
+		operationId: "getTransferImportPlan",
+		summary: "Get an import plan",
+		description: `${TRANSFER_AUTH} Scope: \`transfer:analyze\` or \`transfer:execute\`.`,
+		tags: ["Transfer"],
+		requestParams: { path: importPathParams },
+		responses: {
+			"200": {
+				description: "The plan and its digest",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferImportPlanResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(404, 409, 500, 503)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports/{id}/cancel": { post: {
+		operationId: "cancelTransferImport",
+		summary: "Cancel a site import",
+		description: `A step in progress stops after its current batch. ${TRANSFER_AUTH} Scope: \`transfer:execute\`.`,
+		tags: ["Transfer"],
+		requestParams: { path: importPathParams },
+		responses: {
+			"200": {
+				description: "The cancelled import",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferOperationResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(404, 409, 500)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports/{id}/abandon": { post: {
+		operationId: "abandonTransferImport",
+		summary: "Abandon a failed or cancelled import",
+		description: `Lifts the site write fence after an import failed or was cancelled. Data the import already wrote stays in place. ${TRANSFER_AUTH} Scope: \`transfer:execute\`.`,
+		tags: ["Transfer"],
+		requestParams: { path: importPathParams },
+		responses: {
+			"200": {
+				description: "The abandoned import",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferOperationResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(404, 409, 500)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports/{id}/execute": { post: {
+		operationId: "executeTransferImport",
+		summary: "Start a planned import",
+		description: `Starts a planned import once the reviewed package and plan digests match. The plan must have no blockers. Then call \`advance\` until \`nextRequestInMs\` is null. ${TRANSFER_AUTH} Scope: \`transfer:execute\`.`,
+		tags: ["Transfer"],
+		requestParams: { path: importPathParams },
+		requestBody: {
+			required: true,
+			content: { [JSON_CONTENT]: { schema: transferImportExecuteBody } }
+		},
+		responses: {
+			"200": {
+				description: "The import, marked for execution",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferOperationResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(400, 404, 409, 500, 503)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports/{id}/advance": { post: {
+		operationId: "advanceTransferImport",
+		summary: "Advance an executing import",
+		description: `Runs one bounded import step. Retryable failures are recorded on the import and delay \`nextRequestInMs\`; it is null once the import has ended. While the import runs, and after it fails or is cancelled until it is abandoned, other site writes return 503 \`TRANSFER_IMPORT_IN_PROGRESS\`. ${TRANSFER_AUTH} Scope: \`transfer:execute\`.`,
+		tags: ["Transfer"],
+		requestParams: { path: importPathParams },
+		responses: {
+			"200": {
+				description: "The import after one step",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferAdvanceResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(404, 409, 500, 503)
+		}
+	} },
+	"/_emdash/api/admin/transfer/imports/{id}/receipt": { get: {
+		operationId: "getTransferImportReceipt",
+		summary: "Get an import receipt",
+		description: `The verified receipt of a complete import; its \`receiptDigest\` covers every other field. ${TRANSFER_AUTH} Scope: \`transfer:analyze\` or \`transfer:execute\`.`,
+		tags: ["Transfer"],
+		requestParams: { path: importPathParams },
+		responses: {
+			"200": {
+				description: "The receipt",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferImportReceiptResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(404, 409, 500)
+		}
+	} },
+	"/_emdash/api/admin/transfer/exports": {
+		get: {
+			operationId: "listTransferExports",
+			summary: "List site exports",
+			description: `Returns exports newest first. ${EXPORT_AUTH}`,
+			tags: ["Transfer"],
+			requestParams: { query: transferPaginationQuery },
+			responses: {
+				"200": {
+					description: "One page of exports",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(transferOperationListResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(400, 500)
+			}
+		},
+		post: {
+			operationId: "createTransferExport",
+			summary: "Start a site export",
+			description: `Creates an export; call \`advance\` until \`nextRequestInMs\` is null. An optional \`Idempotency-Key\` header returns the existing export on retry. ${EXPORT_AUTH}`,
+			tags: ["Transfer"],
+			requestBody: {
+				required: false,
+				content: { [JSON_CONTENT]: { schema: transferExportCreateBody } }
+			},
+			responses: {
+				"200": {
+					description: "Existing export for this idempotency key",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(transferExportCreateResponseSchema) } }
+				},
+				"201": {
+					description: "Export created",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(transferExportCreateResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(400, 409, 500)
+			}
+		}
+	},
+	"/_emdash/api/admin/transfer/exports/{id}": { get: {
+		operationId: "getTransferExport",
+		summary: "Get a site export",
+		description: EXPORT_AUTH,
+		tags: ["Transfer"],
+		requestParams: { path: exportPathParams },
+		responses: {
+			"200": {
+				description: "Export status",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferOperationResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(404, 500)
+		}
+	} },
+	"/_emdash/api/admin/transfer/exports/{id}/advance": { post: {
+		operationId: "advanceTransferExport",
+		summary: "Advance a site export",
+		description: `Runs one bounded export step; \`nextRequestInMs\` is null once the export has ended. ${EXPORT_AUTH}`,
+		tags: ["Transfer"],
+		requestParams: { path: exportPathParams },
+		responses: {
+			"200": {
+				description: "The export after one step",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferAdvanceResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(404, 409, 500, 503)
+		}
+	} },
+	"/_emdash/api/admin/transfer/exports/{id}/manifest": { get: {
+		operationId: "getTransferExportManifest",
+		summary: "Download an export manifest",
+		description: `The complete export's \`manifest.json\`, byte for byte; its SHA-256 is the package digest. ${EXPORT_AUTH}`,
+		tags: ["Transfer"],
+		requestParams: { path: exportPathParams },
+		responses: {
+			"200": {
+				description: "The manifest",
+				content: { [JSON_CONTENT]: { schema: z.string().meta({ format: "binary" }) } }
+			},
+			...authErrors,
+			...standardErrors(404, 409, 410, 500, 503)
+		}
+	} },
+	"/_emdash/api/admin/transfer/exports/{id}/files/{path}": { get: {
+		operationId: "downloadTransferExportFile",
+		summary: "Download one export file",
+		description: `Streams one index chunk, record chunk, or media blob listed by the export (the path keeps its slashes). \`Content-Length\` and the \`ETag\` (hex SHA-256) describe the file; the stream fails partway if the stored bytes no longer match. ${EXPORT_AUTH}`,
+		tags: ["Transfer"],
+		requestParams: { path: exportPathParams.extend({ path: z.string().meta({ description: "Package file path" }) }) },
+		responses: {
+			"200": {
+				description: "The file",
+				content: { "application/octet-stream": { schema: z.string().meta({ format: "binary" }) } }
+			},
+			...authErrors,
+			...standardErrors(404, 409, 410, 422, 500, 503)
+		}
+	} },
+	"/_emdash/api/admin/transfer/exports/{id}/archive": { get: {
+		operationId: "downloadTransferExportArchive",
+		summary: "Download an export archive",
+		description: `Streams the complete export as one \`.emdash\` tar archive, manifest first. On Workers the whole archive streams within one request; large sites should download files individually. ${EXPORT_AUTH}`,
+		tags: ["Transfer"],
+		requestParams: { path: exportPathParams },
+		responses: {
+			"200": {
+				description: "The archive",
+				content: { "application/x-tar": { schema: z.string().meta({ format: "binary" }) } }
+			},
+			...authErrors,
+			...standardErrors(404, 409, 410, 500, 503)
+		}
+	} },
+	"/_emdash/api/admin/transfer/approvals": { get: {
+		operationId: "listTransferApprovals",
+		summary: "List transfer approvals",
+		description: "Approval grants requested by MCP callers, newest first. Signed-in sessions only (`transfer:export` or `transfer:import`); bearer tokens are refused.",
+		tags: ["Transfer"],
+		requestParams: { query: transferApprovalListQuery },
+		responses: {
+			"200": {
+				description: "One page of approvals",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferApprovalListResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(400, 500)
+		}
+	} },
+	"/_emdash/api/admin/transfer/approvals/{id}/approve": { post: {
+		operationId: "approveTransferApproval",
+		summary: "Approve a transfer request",
+		description: "Approves a pending grant; the requester can use it once within 15 minutes. Signed-in sessions only, with the permission for the grant's action; bearer tokens are refused.",
+		tags: ["Transfer"],
+		requestParams: { path: approvalPathParams },
+		responses: {
+			"200": {
+				description: "The approved grant",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferApprovalResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(500)
+		}
+	} },
+	"/_emdash/api/admin/transfer/approvals/{id}/deny": { post: {
+		operationId: "denyTransferApproval",
+		summary: "Deny a transfer request",
+		description: "Denies a pending grant. Signed-in sessions only, with the permission for the grant's action; bearer tokens are refused.",
+		tags: ["Transfer"],
+		requestParams: { path: approvalPathParams },
+		responses: {
+			"200": {
+				description: "The denied grant",
+				content: { [JSON_CONTENT]: { schema: successEnvelope(transferApprovalResponseSchema) } }
+			},
+			...authErrors,
+			...standardErrors(500)
+		}
+	} }
+};
 function buildAllPaths(maxUploadSize) {
 	return {
 		...contentPaths,
@@ -3055,14 +3535,15 @@ function buildAllPaths(maxUploadSize) {
 		...settingsPaths,
 		...searchPaths,
 		...redirectPaths,
-		...userPaths
+		...userPaths,
+		...transferPaths
 	};
 }
 /**
 * Generate the OpenAPI 3.1 document for the EmDash CMS API.
 *
 * Covers: Content, Media, Schema, Comments, Taxonomies, Menus,
-* Sections, Widgets, Settings, Search, Redirects, Users.
+* Sections, Widgets, Settings, Search, Redirects, Users, Transfer.
 */
 function generateOpenApiDocument(options = {}) {
 	const maxUploadSize = options.maxUploadSize ?? DEFAULT_MAX_UPLOAD_SIZE;
@@ -3126,6 +3607,10 @@ function generateOpenApiDocument(options = {}) {
 			{
 				name: "Users",
 				description: "User management and access control"
+			},
+			{
+				name: "Transfer",
+				description: "Whole-site export and import (site packages)"
 			}
 		],
 		components: {