@krantho/api 0.0.0-stage → 1.0.1

package/dist/handlers/media-folders.js

@@ -0,0 +1,119 @@
+import { requireRole } from '../permissions.js';
+import { hasMediaStorage, MEDIA_NOT_CONFIGURED, requireParam, validateRequestBody, } from '../validators.js';
+const FOLDERS_NOT_CONFIGURED = {
+    status: 501,
+    body: { error: 'Media folder storage not configured' },
+};
+/** GET /api/media/folders — list folder tree */
+export const mediaFolders = async (_req, ctx) => {
+    if (!ctx.mediaFolderStorage)
+        return FOLDERS_NOT_CONFIGURED;
+    const folders = await ctx.mediaFolderStorage.listFolders();
+    return { status: 200, body: { folders } };
+};
+/** POST /api/media/folders — create folder */
+export const mediaFolderCreate = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return denied;
+    if (!ctx.mediaFolderStorage)
+        return FOLDERS_NOT_CONFIGURED;
+    const bodyCheck = validateRequestBody(req.body);
+    if (!bodyCheck.isValid)
+        return bodyCheck.response;
+    const payload = bodyCheck.body;
+    const name = payload['name'];
+    if (typeof name !== 'string' || name.trim().length === 0) {
+        return { status: 400, body: { error: 'Folder name is required' } };
+    }
+    const parentId = typeof payload['parentId'] === 'string' ? payload['parentId'] : null;
+    try {
+        const folder = await ctx.mediaFolderStorage.createFolder(name, parentId);
+        return { status: 201, body: folder };
+    }
+    catch (err) {
+        return {
+            status: 400,
+            body: { error: err instanceof Error ? err.message : 'Failed to create folder' },
+        };
+    }
+};
+/** PUT /api/media/folders/:id — rename folder */
+export const mediaFolderRename = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return denied;
+    if (!ctx.mediaFolderStorage)
+        return FOLDERS_NOT_CONFIGURED;
+    const idResult = requireParam(req.params, 'id');
+    if (!idResult.isValid)
+        return idResult.response;
+    const id = idResult.value;
+    const bodyCheck = validateRequestBody(req.body);
+    if (!bodyCheck.isValid)
+        return bodyCheck.response;
+    const payload = bodyCheck.body;
+    const name = payload['name'];
+    if (typeof name !== 'string' || name.trim().length === 0) {
+        return { status: 400, body: { error: 'Folder name is required' } };
+    }
+    const folder = await ctx.mediaFolderStorage.renameFolder(id, name);
+    if (!folder) {
+        return { status: 404, body: { error: 'Folder not found' } };
+    }
+    return { status: 200, body: folder };
+};
+/** DELETE /api/media/folders/:id — delete empty folder */
+export const mediaFolderDelete = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    if (!ctx.mediaFolderStorage)
+        return FOLDERS_NOT_CONFIGURED;
+    const idResult = requireParam(req.params, 'id');
+    if (!idResult.isValid)
+        return idResult.response;
+    const id = idResult.value;
+    try {
+        await ctx.mediaFolderStorage.deleteFolder(id);
+        return { status: 200, body: { id, message: 'Deleted' } };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Failed to delete folder';
+        if (message.includes('not found')) {
+            return { status: 404, body: { error: message } };
+        }
+        return { status: 409, body: { error: message } };
+    }
+};
+/** PUT /api/media/:id/move — move media item to a folder */
+export const mediaMove = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return denied;
+    if (!hasMediaStorage(ctx))
+        return MEDIA_NOT_CONFIGURED;
+    const idResult = requireParam(req.params, 'id');
+    if (!idResult.isValid)
+        return idResult.response;
+    const id = idResult.value;
+    const bodyCheck = validateRequestBody(req.body);
+    if (!bodyCheck.isValid)
+        return bodyCheck.response;
+    const payload = bodyCheck.body;
+    const folderId = typeof payload['folderId'] === 'string' ? payload['folderId'] : null;
+    // Validate folder exists (if moving to a folder, not root)
+    if (folderId && ctx.mediaFolderStorage) {
+        const folders = await ctx.mediaFolderStorage.listFolders();
+        const exists = folders.some((f) => f.id === folderId);
+        if (!exists) {
+            return { status: 404, body: { error: 'Target folder not found' } };
+        }
+    }
+    const item = await ctx.mediaStorage.update(id, { folder: folderId });
+    if (!item) {
+        return { status: 404, body: { error: 'Media item not found' } };
+    }
+    return { status: 200, body: item };
+};
+//# sourceMappingURL=media-folders.js.map

package/dist/handlers/media-folders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-folders.js","sourceRoot":"","sources":["../../src/handlers/media-folders.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,GACpB,MAAM,kBAAkB,CAAA;AAEzB,MAAM,sBAAsB,GAAgB;IAC1C,MAAM,EAAE,GAAG;IACX,IAAI,EAAE,EAAE,KAAK,EAAE,qCAAqC,EAAE;CACvD,CAAA;AAED,gDAAgD;AAChD,MAAM,CAAC,MAAM,YAAY,GAAe,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC1D,IAAI,CAAC,GAAG,CAAC,kBAAkB;QAAE,OAAO,sBAAsB,CAAA;IAE1D,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAA;IAC1D,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,CAAA;AAC3C,CAAC,CAAA;AAED,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC9D,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,CAAC,GAAG,CAAC,kBAAkB;QAAE,OAAO,sBAAsB,CAAA;IAE1D,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAA;IAEjD,MAAM,OAAO,GAAG,SAAS,CAAC,IAA+B,CAAA;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,CAAA;IACpE,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAErF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACxE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACtC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,EAAE;SAChF,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC9D,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,CAAC,GAAG,CAAC,kBAAkB;QAAE,OAAO,sBAAsB,CAAA;IAE1D,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAA;IAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAA;IAEzB,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAA;IAEjD,MAAM,OAAO,GAAG,SAAS,CAAC,IAA+B,CAAA;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC5B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,CAAA;IACpE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IAClE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAA;IAC7D,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACtC,CAAC,CAAA;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC9D,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC7C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,CAAC,GAAG,CAAC,kBAAkB;QAAE,OAAO,sBAAsB,CAAA;IAE1D,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAA;IAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAA;IAEzB,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;QAC7C,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,CAAA;IAC1D,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAA;QAC9E,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAA;QAClD,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAA;IAClD,CAAC;AACH,CAAC,CAAA;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,SAAS,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACtD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAA;IAEtD,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAA;IAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAA;IAEzB,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAA;IAEjD,MAAM,OAAO,GAAG,SAAS,CAAC,IAA+B,CAAA;IACzD,MAAM,QAAQ,GAAG,OAAO,OAAO,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAErF,2DAA2D;IAC3D,IAAI,QAAQ,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,kBAAkB,CAAC,WAAW,EAAE,CAAA;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;QACrD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,EAAE,CAAA;QACpE,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;IACpE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAA;IACjE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACpC,CAAC,CAAA"}

package/dist/handlers/media-get.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/media/:id — get a single media item */
+export declare const mediaGet: ApiHandler;
+//# sourceMappingURL=media-get.d.ts.map

package/dist/handlers/media-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-get.d.ts","sourceRoot":"","sources":["../../src/handlers/media-get.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,mDAAmD;AACnD,eAAO,MAAM,QAAQ,EAAE,UAatB,CAAA"}

package/dist/handlers/media-get.js

@@ -0,0 +1,16 @@
+import { hasMediaStorage, MEDIA_NOT_CONFIGURED, requireParam } from '../validators.js';
+/** GET /api/media/:id — get a single media item */
+export const mediaGet = async (req, ctx) => {
+    if (!hasMediaStorage(ctx))
+        return MEDIA_NOT_CONFIGURED;
+    const idResult = requireParam(req.params, 'id');
+    if (!idResult.isValid)
+        return idResult.response;
+    const id = idResult.value;
+    const item = await ctx.mediaStorage.get(id);
+    if (!item) {
+        return { status: 404, body: { error: 'Media item not found' } };
+    }
+    return { status: 200, body: item };
+};
+//# sourceMappingURL=media-get.js.map

package/dist/handlers/media-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-get.js","sourceRoot":"","sources":["../../src/handlers/media-get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEtF,mDAAmD;AACnD,MAAM,CAAC,MAAM,QAAQ,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACrD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAA;IAEtD,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAA;IAC/C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAA;IAEzB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAA;IACjE,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACpC,CAAC,CAAA"}

package/dist/handlers/media-image-info.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/media/:id/image/info — variant metadata from cache (no image bytes) */
+export declare const mediaImageInfo: ApiHandler;
+//# sourceMappingURL=media-image-info.d.ts.map

package/dist/handlers/media-image-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-image-info.d.ts","sourceRoot":"","sources":["../../src/handlers/media-image-info.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,mFAAmF;AACnF,eAAO,MAAM,cAAc,EAAE,UA4B5B,CAAA"}

package/dist/handlers/media-image-info.js

@@ -0,0 +1,32 @@
+import { imageRevision, resolveVariant, variantCacheKey } from '../image-url.js';
+import { hasMediaStorage, MEDIA_NOT_CONFIGURED, requireParam } from '../validators.js';
+/** GET /api/media/:id/image/info — variant metadata from cache (no image bytes) */
+export const mediaImageInfo = async (req, ctx) => {
+    if (!hasMediaStorage(ctx))
+        return MEDIA_NOT_CONFIGURED;
+    if (!ctx.imageCache) {
+        return { status: 501, body: { error: 'Image optimizer not configured' } };
+    }
+    const idResult = requireParam(req.params, 'id');
+    if (!idResult.isValid)
+        return idResult.response;
+    const item = await ctx.mediaStorage.get(idResult.value);
+    if (!item)
+        return { status: 404, body: { error: 'Media item not found' } };
+    const variant = resolveVariant(item, req.query, req.headers);
+    const cached = ctx.imageCache.get(variantCacheKey(item.id, variant, imageRevision(item)));
+    if (!cached) {
+        return { status: 404, body: { error: 'Variant not cached — request the image first' } };
+    }
+    return {
+        status: 200,
+        body: {
+            preset: variant.preset,
+            format: variant.format,
+            contentType: cached.contentType,
+            bytes: cached.bytes.byteLength,
+            etag: cached.etag,
+        },
+    };
+};
+//# sourceMappingURL=media-image-info.js.map

package/dist/handlers/media-image-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-image-info.js","sourceRoot":"","sources":["../../src/handlers/media-image-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEhF,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAEtF,mFAAmF;AACnF,MAAM,CAAC,MAAM,cAAc,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC3D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAA;IACtD,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,gCAAgC,EAAE,EAAE,CAAA;IAC3E,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAC/C,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAA;IAE/C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IACvD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAA;IAE1E,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IAC5D,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACzF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,8CAA8C,EAAE,EAAE,CAAA;IACzF,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE;YACJ,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU;YAC9B,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/handlers/media-image.d.ts

@@ -0,0 +1,11 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * GET|HEAD /api/media/:id/image — an image variant.
+ *
+ * Without `rev` (the stable URL content embeds) it answers an uncached 302 to
+ * the versioned URL of the current revision, negotiating the format there. With
+ * the current `rev` and an explicit `fmt` it serves the bytes as immutable; a
+ * stale revision redirects to the current one.
+ */
+export declare const mediaImage: ApiHandler;
+//# sourceMappingURL=media-image.d.ts.map

package/dist/handlers/media-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-image.d.ts","sourceRoot":"","sources":["../../src/handlers/media-image.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAc,UAAU,EAA2B,MAAM,aAAa,CAAA;AAkBlF;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,UAyBxB,CAAA"}

package/dist/handlers/media-image.js

@@ -0,0 +1,116 @@
+import { computeEtag } from '../image-optimizer.js';
+import { imageRevision, resolveVariant, variantCacheKey, variantUrl } from '../image-url.js';
+import { hasMediaStorage, MEDIA_NOT_CONFIGURED, requireParam } from '../validators.js';
+/** A versioned URL never changes content, so any cache may keep it for a year */
+const IMMUTABLE = 'public, max-age=31536000, s-maxage=31536000, immutable';
+const ORIGINAL_NOT_FOUND = {
+    status: 404,
+    body: { error: 'Original file not found' },
+};
+/**
+ * GET|HEAD /api/media/:id/image — an image variant.
+ *
+ * Without `rev` (the stable URL content embeds) it answers an uncached 302 to
+ * the versioned URL of the current revision, negotiating the format there. With
+ * the current `rev` and an explicit `fmt` it serves the bytes as immutable; a
+ * stale revision redirects to the current one.
+ */
+export const mediaImage = async (req, ctx) => {
+    if (!hasMediaStorage(ctx))
+        return MEDIA_NOT_CONFIGURED;
+    if (!ctx.imageOptimizer || !ctx.imageCache) {
+        return { status: 501, body: { error: 'Image optimizer not configured' } };
+    }
+    const idResult = requireParam(req.params, 'id');
+    if (!idResult.isValid)
+        return idResult.response;
+    const item = await ctx.mediaStorage.get(idResult.value);
+    if (!item)
+        return { status: 404, body: { error: 'Media item not found' } };
+    const variant = resolveVariant(item, req.query, req.headers);
+    const rev = imageRevision(item);
+    if (req.query['rev'] !== rev || req.query['fmt'] !== variant.format) {
+        return redirectToVariant(item.id, variant, rev);
+    }
+    const imageCtx = {
+        ...ctx,
+        imageOptimizer: ctx.imageOptimizer,
+        imageCache: ctx.imageCache,
+    };
+    if (variant.format === 'original')
+        return serveSvg(req, imageCtx, item);
+    return serveVariant(req, imageCtx, item, { ...variant, format: variant.format }, rev);
+};
+/** 302 to the versioned URL; never cached, and its target depends on Accept */
+function redirectToVariant(id, variant, rev) {
+    return {
+        status: 302,
+        body: null,
+        headers: {
+            location: variantUrl(id, variant, rev),
+            'cache-control': 'no-cache',
+            vary: 'Accept',
+        },
+    };
+}
+/** A raster variant at the current revision, from the cache or rendered now */
+async function serveVariant(req, ctx, item, variant, rev) {
+    const cacheKey = variantCacheKey(item.id, variant, rev);
+    const cached = ctx.imageCache.get(cacheKey);
+    if (cached)
+        return bytesResponse(req, cached.bytes, cached.contentType, cached.etag);
+    const original = await readOriginal(ctx, item.id);
+    if (!original.ok)
+        return original.response;
+    try {
+        const rendered = await ctx.imageOptimizer.generateVariant(original.bytes, variant.preset, variant.format, {
+            crop: item.crop ?? undefined,
+            hotspot: item.hotspot ?? undefined,
+            aspectRatio: variant.aspect,
+        });
+        const etag = computeEtag(rendered.bytes);
+        ctx.imageCache.set(cacheKey, { bytes: rendered.bytes, contentType: rendered.contentType, etag });
+        return bytesResponse(req, rendered.bytes, rendered.contentType, etag);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Image processing failed';
+        return { status: 500, body: { error: message } };
+    }
+}
+/** An SVG as stored: it scales by itself, so there is nothing to render */
+async function serveSvg(req, ctx, item) {
+    const original = await readOriginal(ctx, item.id);
+    if (!original.ok)
+        return original.response;
+    return bytesResponse(req, original.bytes, 'image/svg+xml', computeEtag(original.bytes));
+}
+async function readOriginal(ctx, id) {
+    try {
+        const bytes = await ctx.mediaStorage.readOriginal(id);
+        return bytes ? { ok: true, bytes } : { ok: false, response: ORIGINAL_NOT_FOUND };
+    }
+    catch {
+        return {
+            ok: false,
+            response: { status: 500, body: { error: 'Failed to load original image' } },
+        };
+    }
+}
+/** 200 with immutable caching and an ETag, or 304 when the client already has it */
+function bytesResponse(req, bytes, contentType, etag) {
+    const quoted = `"${etag}"`;
+    if (req.headers?.['if-none-match'] === quoted) {
+        return { status: 304, body: null, headers: { etag: quoted, 'cache-control': IMMUTABLE } };
+    }
+    return {
+        status: 200,
+        body: req.method === 'HEAD' ? null : bytes,
+        headers: {
+            'content-type': contentType,
+            'content-length': String(bytes.byteLength),
+            'cache-control': IMMUTABLE,
+            etag: quoted,
+        },
+    };
+}
+//# sourceMappingURL=media-image.js.map

package/dist/handlers/media-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-image.js","sourceRoot":"","sources":["../../src/handlers/media-image.ts"],"names":[],"mappings":"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"}

package/dist/handlers/media-info.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/media/info — the store, and the library's exact figures: files, bytes and each folder's count */
+export declare const mediaInfo: ApiHandler;
+//# sourceMappingURL=media-info.d.ts.map

package/dist/handlers/media-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-info.d.ts","sourceRoot":"","sources":["../../src/handlers/media-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,6GAA6G;AAC7G,eAAO,MAAM,SAAS,EAAE,UAevB,CAAA"}

package/dist/handlers/media-info.js

@@ -0,0 +1,18 @@
+import { hasMediaStorage, MEDIA_NOT_CONFIGURED } from '../validators.js';
+/** GET /api/media/info — the store, and the library's exact figures: files, bytes and each folder's count */
+export const mediaInfo = async (_req, ctx) => {
+    if (!hasMediaStorage(ctx))
+        return MEDIA_NOT_CONFIGURED;
+    const stats = await ctx.mediaStorage.stats();
+    return {
+        status: 200,
+        body: {
+            totalItems: stats.totalItems,
+            totalSize: stats.totalSize,
+            folderCounts: stats.byFolder,
+            storageLabel: ctx.mediaStorageLabel ?? 'Local filesystem',
+            storagePath: ctx.mediaStoragePath ?? null,
+        },
+    };
+};
+//# sourceMappingURL=media-info.js.map

package/dist/handlers/media-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-info.js","sourceRoot":"","sources":["../../src/handlers/media-info.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAExE,6GAA6G;AAC7G,MAAM,CAAC,MAAM,SAAS,GAAe,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACvD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAA;IAEtD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;IAE5C,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE;YACJ,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,YAAY,EAAE,KAAK,CAAC,QAAQ;YAC5B,YAAY,EAAE,GAAG,CAAC,iBAAiB,IAAI,kBAAkB;YACzD,WAAW,EAAE,GAAG,CAAC,gBAAgB,IAAI,IAAI;SAC1C;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/handlers/media-list.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/media — list media with pagination and search */
+export declare const mediaList: ApiHandler;
+//# sourceMappingURL=media-list.d.ts.map

package/dist/handlers/media-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-list.d.ts","sourceRoot":"","sources":["../../src/handlers/media-list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAQ7C,6DAA6D;AAC7D,eAAO,MAAM,SAAS,EAAE,UAevB,CAAA"}

package/dist/handlers/media-list.js

@@ -0,0 +1,14 @@
+import { applyListLimit, hasMediaStorage, MEDIA_NOT_CONFIGURED, parsePositiveInt, } from '../validators.js';
+/** GET /api/media — list media with pagination and search */
+export const mediaList = async (req, ctx) => {
+    if (!hasMediaStorage(ctx))
+        return MEDIA_NOT_CONFIGURED;
+    const limit = applyListLimit(parsePositiveInt(req.query['limit']), ctx.config.content.list.maxLimit);
+    const offset = parsePositiveInt(req.query['offset']);
+    const search = req.query['search'];
+    const folder = req.query['folder'];
+    const tag = req.query['tag'];
+    const result = await ctx.mediaStorage.list({ limit, offset, search, folder, tag });
+    return { status: 200, body: { items: result.items, total: result.total } };
+};
+//# sourceMappingURL=media-list.js.map

package/dist/handlers/media-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-list.js","sourceRoot":"","sources":["../../src/handlers/media-list.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AAEzB,6DAA6D;AAC7D,MAAM,CAAC,MAAM,SAAS,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACtD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAA;IAEtD,MAAM,KAAK,GAAG,cAAc,CAC1B,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EACpC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CACjC,CAAA;IACD,MAAM,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IACpD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAClC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAE5B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IAElF,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAA;AAC5E,CAAC,CAAA"}

package/dist/handlers/media-register.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** POST /api/media/register — register an externally-uploaded file */
+export declare const mediaRegister: ApiHandler;
+//# sourceMappingURL=media-register.d.ts.map

package/dist/handlers/media-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-register.d.ts","sourceRoot":"","sources":["../../src/handlers/media-register.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,sEAAsE;AACtE,eAAO,MAAM,aAAa,EAAE,UA+C3B,CAAA"}

package/dist/handlers/media-register.js

@@ -0,0 +1,57 @@
+import { requireRole } from '../permissions.js';
+import { hasMediaStorage, MEDIA_NOT_CONFIGURED } from '../validators.js';
+/** POST /api/media/register — register an externally-uploaded file */
+export const mediaRegister = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return denied;
+    if (!hasMediaStorage(ctx))
+        return MEDIA_NOT_CONFIGURED;
+    const body = req.body;
+    if (!body || typeof body !== 'object') {
+        return { status: 400, body: { error: 'Request body is required' } };
+    }
+    const filename = body['filename'];
+    const url = body['url'];
+    const mimeType = body['mimeType'];
+    const size = body['size'];
+    if (typeof filename !== 'string' || !filename) {
+        return { status: 400, body: { error: 'Missing required field: filename' } };
+    }
+    if (typeof url !== 'string' || !url) {
+        return { status: 400, body: { error: 'Missing required field: url' } };
+    }
+    if (!isAbsoluteHttpUrl(url)) {
+        return { status: 400, body: { error: 'url must be an absolute http(s) URL' } };
+    }
+    if (typeof mimeType !== 'string' || !mimeType) {
+        return { status: 400, body: { error: 'Missing required field: mimeType' } };
+    }
+    if (typeof size !== 'number') {
+        return { status: 400, body: { error: 'Missing required field: size' } };
+    }
+    const width = typeof body['width'] === 'number' ? body['width'] : null;
+    const height = typeof body['height'] === 'number' ? body['height'] : null;
+    const altText = typeof body['altText'] === 'string' ? body['altText'] : undefined;
+    const item = await ctx.mediaStorage.register({
+        filename,
+        url,
+        mimeType,
+        size,
+        width,
+        height,
+        altText,
+    });
+    return { status: 201, body: item };
+};
+/** A registered file lives elsewhere: only an absolute http(s) URL can be fetched */
+function isAbsoluteHttpUrl(value) {
+    try {
+        const { protocol } = new URL(value);
+        return protocol === 'http:' || protocol === 'https:';
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=media-register.js.map

package/dist/handlers/media-register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-register.js","sourceRoot":"","sources":["../../src/handlers/media-register.ts"],"names":[],"mappings":"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"}

package/dist/handlers/media-replace.d.ts

@@ -0,0 +1,9 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * POST /api/media/:id/replace — replace the file, keep the id.
+ *
+ * The file gets a new url and the old object is deleted, so content that
+ * holds the old url (an `og-image`, a body link) is rewritten to the new one.
+ */
+export declare const mediaReplace: ApiHandler;
+//# sourceMappingURL=media-replace.d.ts.map

package/dist/handlers/media-replace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-replace.d.ts","sourceRoot":"","sources":["../../src/handlers/media-replace.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,UA6C1B,CAAA"}

package/dist/handlers/media-replace.js

@@ -0,0 +1,53 @@
+import { announceChange } from '../content-change.js';
+import { updateMediaReferences } from '../media-reference-updater.js';
+import { requireRole } from '../permissions.js';
+import { hasMediaStorage, MEDIA_NOT_CONFIGURED, requireParam } from '../validators.js';
+/**
+ * POST /api/media/:id/replace — replace the file, keep the id.
+ *
+ * The file gets a new url and the old object is deleted, so content that
+ * holds the old url (an `og-image`, a body link) is rewritten to the new one.
+ */
+export const mediaReplace = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return denied;
+    if (!hasMediaStorage(ctx))
+        return MEDIA_NOT_CONFIGURED;
+    const idResult = requireParam(req.params, 'id');
+    if (!idResult.isValid)
+        return idResult.response;
+    const id = idResult.value;
+    const file = req.files?.[0];
+    if (!file) {
+        return { status: 400, body: { error: 'No file uploaded' } };
+    }
+    const before = await ctx.mediaStorage.get(id);
+    if (!before)
+        return { status: 404, body: { error: 'Media item not found' } };
+    let item;
+    try {
+        item = await ctx.mediaStorage.replace(id, file.data, file.filename, file.mimeType);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Replace failed';
+        return { status: 400, body: { error: message } };
+    }
+    if (!item)
+        return { status: 404, body: { error: 'Media item not found' } };
+    ctx.imageCache?.invalidateSource(id);
+    await announceChange(ctx, { kind: 'media', id });
+    const { updated, failed } = await updateMediaReferences(before.url, item.url, ctx.adapter, ctx.contentConfig);
+    // Documents across collections now point at the new url
+    if (updated > 0)
+        await announceChange(ctx, { kind: 'site' });
+    if (failed.length > 0) {
+        const pages = failed.map((page) => `${page.collection}/${page.slug} (${page.locale})`);
+        const error = `The file was replaced and ${updated} page(s) use it, but ${failed.length} still point at the old file: ${pages.join(', ')}`;
+        return { status: 500, body: { error, item, _referencesUpdated: updated, failed } };
+    }
+    if (updated === 0)
+        return { status: 200, body: item };
+    return { status: 200, body: { ...item, _referencesUpdated: updated } };
+};
+//# sourceMappingURL=media-replace.js.map

package/dist/handlers/media-replace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-replace.js","sourceRoot":"","sources":["../../src/handlers/media-replace.ts"],"names":[],"mappings":"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"}

package/dist/handlers/media-tags.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/media/tags — list distinct tags */
+export declare const mediaTags: ApiHandler;
+//# sourceMappingURL=media-tags.d.ts.map

package/dist/handlers/media-tags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-tags.d.ts","sourceRoot":"","sources":["../../src/handlers/media-tags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,+CAA+C;AAC/C,eAAO,MAAM,SAAS,EAAE,UAKvB,CAAA"}

package/dist/handlers/media-tags.js

@@ -0,0 +1,9 @@
+import { hasMediaStorage, MEDIA_NOT_CONFIGURED } from '../validators.js';
+/** GET /api/media/tags — list distinct tags */
+export const mediaTags = async (_req, ctx) => {
+    if (!hasMediaStorage(ctx))
+        return MEDIA_NOT_CONFIGURED;
+    const tags = await ctx.mediaStorage.listTags();
+    return { status: 200, body: { tags } };
+};
+//# sourceMappingURL=media-tags.js.map

package/dist/handlers/media-tags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-tags.js","sourceRoot":"","sources":["../../src/handlers/media-tags.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAExE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAe,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACvD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAA;IAEtD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAA;IAC9C,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAA;AACxC,CAAC,CAAA"}

package/dist/handlers/media-update.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** PUT /api/media/:id — update media metadata */
+export declare const mediaUpdate: ApiHandler;
+//# sourceMappingURL=media-update.d.ts.map

package/dist/handlers/media-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-update.d.ts","sourceRoot":"","sources":["../../src/handlers/media-update.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAS7C,iDAAiD;AACjD,eAAO,MAAM,WAAW,EAAE,UA2DzB,CAAA"}