emdash 0.29.0 → 0.30.0

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

@@ -1,8 +1,9 @@
-import "../../../base64-C74Msx8h.mjs";
-import "../../../types-Ch8pFMEm.mjs";
-import { r as handleError } from "../../../error-CfJMLSkd.mjs";
-import { $ as createMenuBody, $t as mediaResponseSchema, A as searchRebuildBody, At as fieldListResponseSchema, B as updateSectionBody, Bt as mediaUsageRepairBody, 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 mediaUsageRepairResponseSchema, I as createSectionBody, In as deleteResponseSchema, J as termResponseSchema, Jt as mediaExistingResponseSchema, K as termGetResponseSchema, Kt as mediaConfirmBody, L as sectionListResponseSchema, Mt as fieldResponseSchema, N as searchSuggestQuery, Nn as apiErrorSchema, O as searchEnableBody, Ot as createCollectionBody, P as settingsUpdateBody, Pt as orphanRegisterBody, Q as updateTermBody, R as sectionSchema, Rt as updateCollectionBody, S as allowedDomainUpdateBody, Sn as trashedContentListResponseSchema, T as userSchema, Tt as collectionResponseSchema, Un as successEnvelope, Wt as DEFAULT_MAX_UPLOAD_SIZE, Xt as mediaListQuery, Zt as mediaListResponseSchema, _ as widgetAreaSchema, _t as commentSchema, a as notFoundPruneBody, an as contentCompareResponseSchema, b as widgetSchema, bn as contentUpdateBody, cn as contentListQuery, ct as updateMenuBody, d as redirectsListQuery, en as mediaUpdateBody, et as createMenuItemBody, f as updateRedirectBody, fn as contentResponseSchema, ft as adminCommentListResponseSchema, g as updateWidgetBody, gn as contentTermsBody, gt as commentListQuery, h as reorderWidgetsBody, ht as commentCountsResponseSchema, i as notFoundListResponseSchema, in as contentAuthorsResponseSchema, j as searchResponseSchema, jt as fieldReorderBody, k as searchQuery, kt as createFieldBody, l as redirectListResponseSchema, ln as contentListResponseSchema, lt as updateMenuItemBody, m as createWidgetBody, mt as commentBulkResponseSchema, nn as mediaUploadUrlResponseSchema, on as contentCreateBody, ot as menuWithItemsSchema, p as createWidgetAreaBody, pn as contentScheduleBody, pt as commentBulkBody, q as termListResponseSchema, qt as mediaConfirmResponseSchema, r as notFoundListQuery, rt as menuListItemSchema, s as notFoundSummaryResponseSchema, sn as contentItemSchema, st as reorderMenuItemsBody, t as createRedirectBody, tn as mediaUploadUrlBody, tt as menuItemSchema, u as redirectSchema, v as widgetAreaWithWidgetsAndCountSchema, vn as contentTranslationsResponseSchema, vt as commentStatusBody, w as userListResponseSchema, wt as collectionListResponseSchema, x as allowedDomainCreateBody, xt as publicCommentListResponseSchema, y as widgetAreaWithWidgetsSchema, yn as contentTrashQuery, yt as createCommentBody, z as sectionsListQuery, zt as updateFieldBody } from "../../../redirects-CeD7K7EX.mjs";
-import "../../../status-D3Gy1Zc6.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";
@@ -1245,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: {
@@ -1301,6 +1307,24 @@ 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",
@@ -2558,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}",
@@ -2620,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)
 	});
 }