emdash 0.28.1 → 0.30.0

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

@@ -1,8 +1,9 @@
-import "../../../base64-CmWvODNW.mjs";
-import "../../../types-CuW0zWDA.mjs";
-import { r as handleError } from "../../../error-CkAseSqZ.mjs";
-import { $ as createMenuBody, A as searchRebuildBody, At as fieldListResponseSchema, B as updateSectionBody, Bt as DEFAULT_MAX_UPLOAD_SIZE, C as userDetailSchema, Ct as collectionGetQuery, D as usersListQuery, Dt as collectionWithFieldsResponseSchema, E as userUpdateBody, F as siteSettingsSchema, Ft as orphanedTableListResponseSchema, G as taxonomyListResponseSchema, H as createTermBody, Ht as mediaConfirmBody, I as createSectionBody, J as termResponseSchema, K as termGetResponseSchema, Kt as mediaListQuery, L as sectionListResponseSchema, Mn as deleteResponseSchema, Mt as fieldResponseSchema, N as searchSuggestQuery, O as searchEnableBody, Ot as createCollectionBody, P as settingsUpdateBody, Pt as orphanRegisterBody, Q as updateTermBody, Qt as mediaUploadUrlResponseSchema, R as sectionSchema, Rt as updateCollectionBody, S as allowedDomainUpdateBody, T as userSchema, Tt as collectionResponseSchema, Ut as mediaConfirmResponseSchema, Wt as mediaExistingResponseSchema, Xt as mediaUpdateBody, Yt as mediaResponseSchema, Zt as mediaUploadUrlBody, _ as widgetAreaSchema, _t as commentSchema, a as notFoundPruneBody, an as contentListResponseSchema, b as widgetSchema, cn as contentResponseSchema, ct as updateMenuBody, d as redirectsListQuery, en as contentAuthorsResponseSchema, et as createMenuItemBody, f as updateRedirectBody, fn as contentTermsBody, ft as adminCommentListResponseSchema, g as updateWidgetBody, gn as contentUpdateBody, gt as commentListQuery, h as reorderWidgetsBody, hn as contentTrashQuery, ht as commentCountsResponseSchema, i as notFoundListResponseSchema, in as contentListQuery, j as searchResponseSchema, jt as fieldReorderBody, k as searchQuery, kn as apiErrorSchema, kt as createFieldBody, l as redirectListResponseSchema, ln as contentScheduleBody, lt as updateMenuItemBody, m as createWidgetBody, mn as contentTranslationsResponseSchema, mt as commentBulkResponseSchema, nn as contentCreateBody, ot as menuWithItemsSchema, p as createWidgetAreaBody, pt as commentBulkBody, q as termListResponseSchema, qt as mediaListResponseSchema, r as notFoundListQuery, rn as contentItemSchema, rt as menuListItemSchema, s as notFoundSummaryResponseSchema, st as reorderMenuItemsBody, t as createRedirectBody, tn as contentCompareResponseSchema, tt as menuItemSchema, u as redirectSchema, v as widgetAreaWithWidgetsAndCountSchema, vn as trashedContentListResponseSchema, vt as commentStatusBody, w as userListResponseSchema, wt as collectionListResponseSchema, x as allowedDomainCreateBody, xt as publicCommentListResponseSchema, y as widgetAreaWithWidgetsSchema, yt as createCommentBody, z as sectionsListQuery, zn as successEnvelope, zt as updateFieldBody } from "../../../redirects-DXEXBAII.mjs";
-import "../../../status-CqJQX1QN.mjs";
+import "../../../base64-B-PsqheR.mjs";
+import "../../../types-D1iJ3DpO.mjs";
+import { r as handleError } from "../../../error-CEGF6UZb.mjs";
+import { C as mediaUsageDetailsResponseSchema, E as mediaUsageRepairBody, I as deleteResponseSchema, N as apiErrorSchema, O as mediaUsageRepairResponseSchema, S as mediaUsageDetailsQuery, U as successEnvelope, _ as mediaUpdateBody, a as mediaConfirmResponseSchema, d as mediaListReadResponseSchema, f as mediaListResponseSchema, g as mediaResponseSchema, h as mediaReadResponseSchema, i as mediaConfirmBody, l as mediaListQuery, n as DEFAULT_MAX_UPLOAD_SIZE, o as mediaExistingResponseSchema, s as mediaGetQuery, v as mediaUploadUrlBody, y as mediaUploadUrlResponseSchema } from "../../../media-kIV1IxFf.mjs";
+import { $ as createMenuBody, $t as contentTermsBody, A as searchRebuildBody, At as fieldListResponseSchema, B as updateSectionBody, C as userDetailSchema, Ct as collectionGetQuery, D as usersListQuery, Dt as collectionWithFieldsResponseSchema, E as userUpdateBody, F as siteSettingsSchema, Ft as orphanedTableListResponseSchema, G as taxonomyListResponseSchema, Gt as contentListQuery, H as createTermBody, Ht as contentCompareResponseSchema, I as createSectionBody, J as termResponseSchema, K as termGetResponseSchema, Kt as contentListResponseSchema, L as sectionListResponseSchema, Mt as fieldResponseSchema, N as searchSuggestQuery, O as searchEnableBody, Ot as createCollectionBody, P as settingsUpdateBody, Pt as orphanRegisterBody, Q as updateTermBody, R as sectionSchema, Rt as updateCollectionBody, S as allowedDomainUpdateBody, T as userSchema, Tt as collectionResponseSchema, Ut as contentCreateBody, Vt as contentAuthorsResponseSchema, Wt as contentItemSchema, Xt as contentScheduleBody, Yt as contentResponseSchema, _ as widgetAreaSchema, _t as commentSchema, a as notFoundPruneBody, an as trashedContentListResponseSchema, b as widgetSchema, ct as updateMenuBody, d as redirectsListQuery, et as createMenuItemBody, f as updateRedirectBody, ft as adminCommentListResponseSchema, g as updateWidgetBody, gt as commentListQuery, h as reorderWidgetsBody, ht as commentCountsResponseSchema, i as notFoundListResponseSchema, j as searchResponseSchema, jt as fieldReorderBody, k as searchQuery, kt as createFieldBody, l as redirectListResponseSchema, lt as updateMenuItemBody, m as createWidgetBody, mt as commentBulkResponseSchema, nn as contentTrashQuery, ot as menuWithItemsSchema, p as createWidgetAreaBody, pt as commentBulkBody, q as termListResponseSchema, r as notFoundListQuery, rn as contentUpdateBody, rt as menuListItemSchema, s as notFoundSummaryResponseSchema, st as reorderMenuItemsBody, t as createRedirectBody, tn as contentTranslationsResponseSchema, tt as menuItemSchema, u as redirectSchema, v as widgetAreaWithWidgetsAndCountSchema, vt as commentStatusBody, w as userListResponseSchema, wt as collectionListResponseSchema, x as allowedDomainCreateBody, xt as publicCommentListResponseSchema, y as widgetAreaWithWidgetsSchema, yt as createCommentBody, z as sectionsListQuery, zt as updateFieldBody } from "../../../redirects-BBq3n2Rj.mjs";
+import "../../../status-COfycGIU.mjs";
 import { z } from "zod";
 import { globalRegistry } from "zod/v4/core";
 import { globalRegistry as globalRegistry$1, object, registry, toJSONSchema } from "zod/v4";
@@ -902,6 +903,7 @@ function standardErrors(...codes) {
 		403: "Forbidden",
 		404: "Not Found",
 		409: "Conflict",
+		413: "Payload Too Large",
 		500: "Internal Server Error"
 	};
 	for (const code of codes) responses[String(code)] = {
@@ -1244,30 +1246,35 @@ function buildMediaPaths(maxUploadSize) {
 		"/_emdash/api/media": { get: {
 			operationId: "listMedia",
 			summary: "List media items",
+			description: "Lists media items. Set `includeUsage=1` to attach coverage-aware advisory usage counts; a count may be null when the caller cannot read draft-derived usage.",
 			tags: ["Media"],
 			requestParams: { query: mediaListQuery },
 			responses: {
 				"200": {
 					description: "Media list",
-					content: { [JSON_CONTENT]: { schema: successEnvelope(mediaListResponseSchema) } }
+					content: { [JSON_CONTENT]: { schema: successEnvelope(mediaListReadResponseSchema) } }
 				},
 				...authErrors,
-				...standardErrors(500)
+				...standardErrors(400, 500)
 			}
 		} },
 		"/_emdash/api/media/{id}": {
 			get: {
 				operationId: "getMedia",
 				summary: "Get a media item",
+				description: "Gets a media item. Set `includeUsage=1` to attach a coverage-aware advisory usage count; the count may be null when the caller cannot read draft-derived usage.",
 				tags: ["Media"],
-				requestParams: { path: z.object({ id: z.string().meta({ description: "Media ID" }) }) },
+				requestParams: {
+					path: z.object({ id: z.string().meta({ description: "Media ID" }) }),
+					query: mediaGetQuery
+				},
 				responses: {
 					"200": {
 						description: "Media item",
-						content: { [JSON_CONTENT]: { schema: successEnvelope(mediaResponseSchema) } }
+						content: { [JSON_CONTENT]: { schema: successEnvelope(mediaReadResponseSchema) } }
 					},
 					...authErrors,
-					...standardErrors(404, 500)
+					...standardErrors(400, 404, 500)
 				}
 			},
 			put: {
@@ -1300,6 +1307,42 @@ 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.",
+			tags: ["Media"],
+			requestParams: {
+				path: z.object({ id: z.string().meta({ description: "Media ID" }) }),
+				query: mediaUsageDetailsQuery
+			},
+			responses: {
+				"200": {
+					description: "Entry-grouped media usage details",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(mediaUsageDetailsResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(400, 404, 500)
+			}
+		} },
+		"/_emdash/api/admin/media-usage/repair": { post: {
+			operationId: "repairMediaUsage",
+			summary: "Repair media usage indexes",
+			description: "Repairs content media usage indexes for one collection or all collections. The request succeeds with HTTP 200 when a structured repair result is produced; inspect `data.status` because it may be `failed` or `stale`.",
+			tags: ["Media"],
+			requestBody: {
+				required: true,
+				content: { [JSON_CONTENT]: { schema: mediaUsageRepairBody } }
+			},
+			responses: {
+				"200": {
+					description: "Media usage repair result",
+					content: { [JSON_CONTENT]: { schema: successEnvelope(mediaUsageRepairResponseSchema) } }
+				},
+				...authErrors,
+				...standardErrors(400, 413, 500)
+			}
+		} },
 		"/_emdash/api/media/upload-url": { post: {
 			operationId: "getMediaUploadUrl",
 			summary: "Get a signed URL for direct upload",
@@ -2539,12 +2582,13 @@ function buildAllPaths(maxUploadSize) {
 * Sections, Widgets, Settings, Search, Redirects, Users.
 */
 function generateOpenApiDocument(options = {}) {
+	const maxUploadSize = options.maxUploadSize ?? DEFAULT_MAX_UPLOAD_SIZE;
 	return createDocument({
 		openapi: "3.1.0",
 		info: {
 			title: "EmDash CMS API",
 			version: "0.1.0",
-			description: "REST API for the EmDash CMS. All endpoints require authentication and return responses wrapped in a `{ data }` envelope."
+			description: "REST API for the EmDash CMS. All endpoints require authentication and return responses wrapped in a `{ success, data }` envelope."
 		},
 		servers: [{
 			url: "{baseUrl}",
@@ -2601,21 +2645,24 @@ function generateOpenApiDocument(options = {}) {
 				description: "User management and access control"
 			}
 		],
-		components: { securitySchemes: {
-			session: {
-				type: "apiKey",
-				in: "cookie",
-				name: "emdash_session",
-				description: "Session cookie set by the auth endpoints"
-			},
-			bearer: {
-				type: "http",
-				scheme: "bearer",
-				description: "OAuth2 or API token"
+		components: {
+			schemas: { MediaListResponse: mediaListResponseSchema },
+			securitySchemes: {
+				session: {
+					type: "apiKey",
+					in: "cookie",
+					name: "emdash_session",
+					description: "Session cookie set by the auth endpoints"
+				},
+				bearer: {
+					type: "http",
+					scheme: "bearer",
+					description: "OAuth2 or API token"
+				}
 			}
-		} },
+		},
 		security: [{ session: [] }, { bearer: [] }],
-		paths: buildAllPaths(options.maxUploadSize ?? DEFAULT_MAX_UPLOAD_SIZE)
+		paths: buildAllPaths(maxUploadSize)
 	});
 }