@strapi/upload 5.52.0 → 5.52.2

package/dist/admin/translations/ko.json.js

@@ -101,7 +101,7 @@ var ko = {
     "tabs.title": "자산을 업로드할 방법을 선택해주세요.",
     "window.confirm.close-modal.file": "확실한가요? 변경 내용이 사라집니다.",
     "window.confirm.close-modal.files": "확실하나요? 아직 업로드되지 않은 파일이 있습니다.",
-    "apiError.FileTooBig": "업로드한 파일이 허용된 최대 에셋 크기를 초과했습니다.",
+    "apiError.FileTooBig": "파일이 너무 커서 업로드할 수 없습니다. 서버에서 허용하는 최대 요청 크기를 초과했습니다.",
     "assets.uploaded": "{number, plural, one {1 개} other {# 개}}의 에셋이 업로드되었습니다",
     "asset-details.title": "파일 상세 정보",
     "asset-details.description": "파일 정보와 메타데이터를 표시합니다.",

package/dist/admin/translations/ko.json.mjs

@@ -99,7 +99,7 @@ var ko = {
     "tabs.title": "자산을 업로드할 방법을 선택해주세요.",
     "window.confirm.close-modal.file": "확실한가요? 변경 내용이 사라집니다.",
     "window.confirm.close-modal.files": "확실하나요? 아직 업로드되지 않은 파일이 있습니다.",
-    "apiError.FileTooBig": "업로드한 파일이 허용된 최대 에셋 크기를 초과했습니다.",
+    "apiError.FileTooBig": "파일이 너무 커서 업로드할 수 없습니다. 서버에서 허용하는 최대 요청 크기를 초과했습니다.",
     "assets.uploaded": "{number, plural, one {1 개} other {# 개}}의 에셋이 업로드되었습니다",
     "asset-details.title": "파일 상세 정보",
     "asset-details.description": "파일 정보와 메타데이터를 표시합니다.",

package/dist/admin/translations/nl.json.js

@@ -4,7 +4,7 @@ var nl = {
     "ai.modal.error": "Kon geen AI-metadata genereren voor de geüploade bestanden.",
     "ai.modal.title": "{count, plural, one {# bestand geüpload} other {# bestanden geüpload}}, beoordeel door AI gegenereerde metadata",
     "ai.modal.uploading.title": "Uploaden en verwerken met AI...",
-    "apiError.FileTooBig": "Het geüploade bestand overschrijdt de maximaal toegestane bestandsgrootte.",
+    "apiError.FileTooBig": "Het bestand is te groot om te uploaden. Het overschrijdt de maximale aanvraaggrootte die door de server is toegestaan.",
     "asset-details.alternativeText": "Alternatieve tekst",
     "asset-details.assetId": "Bestands-ID",
     "asset-details.caption": "Onderschrift",

package/dist/admin/translations/nl.json.mjs

@@ -2,7 +2,7 @@ var nl = {
     "ai.modal.error": "Kon geen AI-metadata genereren voor de geüploade bestanden.",
     "ai.modal.title": "{count, plural, one {# bestand geüpload} other {# bestanden geüpload}}, beoordeel door AI gegenereerde metadata",
     "ai.modal.uploading.title": "Uploaden en verwerken met AI...",
-    "apiError.FileTooBig": "Het geüploade bestand overschrijdt de maximaal toegestane bestandsgrootte.",
+    "apiError.FileTooBig": "Het bestand is te groot om te uploaden. Het overschrijdt de maximale aanvraaggrootte die door de server is toegestaan.",
     "asset-details.alternativeText": "Alternatieve tekst",
     "asset-details.assetId": "Bestands-ID",
     "asset-details.caption": "Onderschrift",

package/dist/admin/translations/pl.json.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var pl = {
-    "apiError.FileTooBig": "Przesłany plik przekracza maksymalny dozwolony rozmiar pliku.",
+    "apiError.FileTooBig": "Plik jest zbyt duży, aby go przesłać. Przekracza maksymalny rozmiar żądania dozwolony przez serwer.",
     "assets.uploaded": "{number, plural, one {# przesłany zasób} other {# przesłanych zasobów}} pomyślnie",
     "asset-details.title": "Szczegóły pliku",
     "asset-details.description": "Wyświetla informacje o pliku i jego metadane",

package/dist/admin/translations/pl.json.mjs

@@ -1,5 +1,5 @@
 var pl = {
-    "apiError.FileTooBig": "Przesłany plik przekracza maksymalny dozwolony rozmiar pliku.",
+    "apiError.FileTooBig": "Plik jest zbyt duży, aby go przesłać. Przekracza maksymalny rozmiar żądania dozwolony przez serwer.",
     "assets.uploaded": "{number, plural, one {# przesłany zasób} other {# przesłanych zasobów}} pomyślnie",
     "asset-details.title": "Szczegóły pliku",
     "asset-details.description": "Wyświetla informacje o pliku i jego metadane",

package/dist/admin/translations/pt-BR.json.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var ptBR = {
-    "apiError.FileTooBig": "O tamanho do arquivo excede o máximo permitido.",
+    "apiError.FileTooBig": "O arquivo é muito grande para ser enviado. Ele excede o tamanho máximo de requisição permitido pelo servidor.",
     "upload.generic-error": "Ocorreu um erro ao enviar o arquivo.",
     "bulk.select.label": "Selecionar todos os ativos",
     "button.next": "Próximo",

package/dist/admin/translations/pt-BR.json.mjs

@@ -1,5 +1,5 @@
 var ptBR = {
-    "apiError.FileTooBig": "O tamanho do arquivo excede o máximo permitido.",
+    "apiError.FileTooBig": "O arquivo é muito grande para ser enviado. Ele excede o tamanho máximo de requisição permitido pelo servidor.",
     "upload.generic-error": "Ocorreu um erro ao enviar o arquivo.",
     "bulk.select.label": "Selecionar todos os ativos",
     "button.next": "Próximo",

package/dist/admin/translations/ru.json.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var ru = {
-    "apiError.FileTooBig": "Загруженный файл превышает максимально допустимый размер.",
+    "apiError.FileTooBig": "Файл слишком большой для загрузки. Он превышает максимальный размер запроса, разрешённый сервером.",
     "upload.generic-error": "При загрузке файла произошла ошибка.",
     "bulk.select.label": "Выбрать все ресурсы",
     "button.next": "Далее",

package/dist/admin/translations/ru.json.mjs

@@ -1,5 +1,5 @@
 var ru = {
-    "apiError.FileTooBig": "Загруженный файл превышает максимально допустимый размер.",
+    "apiError.FileTooBig": "Файл слишком большой для загрузки. Он превышает максимальный размер запроса, разрешённый сервером.",
     "upload.generic-error": "При загрузке файла произошла ошибка.",
     "bulk.select.label": "Выбрать все ресурсы",
     "button.next": "Далее",

package/dist/admin/translations/sk.json.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var sk = {
-    "apiError.FileTooBig": "Nahrávaný súbor prekročil maximálnu povolenú veľkosť.",
+    "apiError.FileTooBig": "Súbor je príliš veľký na nahranie. Prekračuje maximálnu veľkosť požiadavky povolenú serverom.",
     "assets.uploaded": "{number, plural, one {# súbor} other {# súbory}} boli úspešne nahraté",
     "asset-details.title": "Podrobnosti súboru",
     "asset-details.description": "Zobrazuje informácie o súbore a metadáta",

package/dist/admin/translations/sk.json.mjs

@@ -1,5 +1,5 @@
 var sk = {
-    "apiError.FileTooBig": "Nahrávaný súbor prekročil maximálnu povolenú veľkosť.",
+    "apiError.FileTooBig": "Súbor je príliš veľký na nahranie. Prekračuje maximálnu veľkosť požiadavky povolenú serverom.",
     "assets.uploaded": "{number, plural, one {# súbor} other {# súbory}} boli úspešne nahraté",
     "asset-details.title": "Podrobnosti súboru",
     "asset-details.description": "Zobrazuje informácie o súbore a metadáta",

package/dist/admin/translations/tr.json.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var tr = {
-    "apiError.FileTooBig": "Yüklenen dosya azami dosya boyutunu aşıyor.",
+    "apiError.FileTooBig": "Dosya yüklenemeyecek kadar büyük. Sunucunun izin verdiği en yüksek istek boyutunu aşıyor.",
     "upload.generic-error": "Dosyayı yüklerken bir hata oluştu.",
     "bulk.select.label": "Tüm dosyaları seçin",
     "button.next": "İleri",

package/dist/admin/translations/tr.json.mjs

@@ -1,5 +1,5 @@
 var tr = {
-    "apiError.FileTooBig": "Yüklenen dosya azami dosya boyutunu aşıyor.",
+    "apiError.FileTooBig": "Dosya yüklenemeyecek kadar büyük. Sunucunun izin verdiği en yüksek istek boyutunu aşıyor.",
     "upload.generic-error": "Dosyayı yüklerken bir hata oluştu.",
     "bulk.select.label": "Tüm dosyaları seçin",
     "button.next": "İleri",

package/dist/admin/translations/uk.json.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var uk = {
-    "apiError.FileTooBig": "Завантажений файл перевищує максимально допустимий розмір активів.",
+    "apiError.FileTooBig": "Файл занадто великий для завантаження. Він перевищує максимальний розмір запиту, дозволений сервером.",
     "upload.generic-error": "Сталася помилка під час завантаження файлу.",
     "bulk.select.label": "Вибрати всі активи",
     "button.next": "Далі",

package/dist/admin/translations/uk.json.mjs

@@ -1,5 +1,5 @@
 var uk = {
-    "apiError.FileTooBig": "Завантажений файл перевищує максимально допустимий розмір активів.",
+    "apiError.FileTooBig": "Файл занадто великий для завантаження. Він перевищує максимальний розмір запиту, дозволений сервером.",
     "upload.generic-error": "Сталася помилка під час завантаження файлу.",
     "bulk.select.label": "Вибрати всі активи",
     "button.next": "Далі",

package/dist/admin/translations/zh-Hans.json.js

@@ -125,7 +125,7 @@ var zhHans = {
     "sort.updated_at_desc": "最近更新",
     "window.confirm.close-modal.file": "你确定吗？你的更改将会丢失",
     "window.confirm.close-modal.files": "你确定吗？你还有一些文件还没有被上传",
-    "apiError.FileTooBig": "上传的文件超过允许的最大资源大小",
+    "apiError.FileTooBig": "文件太大，无法上传。已超出服务器允许的最大请求大小",
     "upload.generic-error": "上传文件时发生错误",
     "bulk.select.label": "选择所有资源",
     "content.isLoading": "内容正在加载中",

package/dist/admin/translations/zh-Hans.json.mjs

@@ -123,7 +123,7 @@ var zhHans = {
     "sort.updated_at_desc": "最近更新",
     "window.confirm.close-modal.file": "你确定吗？你的更改将会丢失",
     "window.confirm.close-modal.files": "你确定吗？你还有一些文件还没有被上传",
-    "apiError.FileTooBig": "上传的文件超过允许的最大资源大小",
+    "apiError.FileTooBig": "文件太大，无法上传。已超出服务器允许的最大请求大小",
     "upload.generic-error": "上传文件时发生错误",
     "bulk.select.label": "选择所有资源",
     "content.isLoading": "内容正在加载中",

package/dist/admin/translations/zh.json.js

@@ -1,7 +1,7 @@
 'use strict';
 
 var zh = {
-    "apiError.FileTooBig": "上傳的檔案超出允許的最大素材大小。",
+    "apiError.FileTooBig": "檔案太大，無法上傳。已超出伺服器允許的最大請求大小。",
     "upload.generic-error": "上傳檔案時發生錯誤。",
     "bulk.select.label": "選取所有素材",
     "button.next": "繼續",

package/dist/admin/translations/zh.json.mjs

@@ -1,5 +1,5 @@
 var zh = {
-    "apiError.FileTooBig": "上傳的檔案超出允許的最大素材大小。",
+    "apiError.FileTooBig": "檔案太大，無法上傳。已超出伺服器允許的最大請求大小。",
     "upload.generic-error": "上傳檔案時發生錯誤。",
     "bulk.select.label": "選取所有素材",
     "button.next": "繼續",

package/dist/server/controllers/admin-file.js

@@ -56,7 +56,12 @@ var adminFile = {
         ]);
         ctx.body = body;
     },
-    async getAIMetadataCount (ctx) {
+    /**
+   * `GET /upload/ai-metadata-jobs/pending-count`
+   *
+   * How many images a backfill job would have to process, i.e. those still
+   * missing AI metadata, alongside the total image count.
+   */ async getAIMetadataPendingCount (ctx) {
         const { userAbility } = ctx.state;
         const pm = strapi.service('admin::permission').createPermissionsManager({
             ability: userAbility,
@@ -86,7 +91,14 @@ var adminFile = {
             ctx.badRequest(message);
         }
     },
-    async generateAIMetadata (ctx) {
+    /**
+   * `POST /upload/ai-metadata-jobs`
+   *
+   * Create a backfill job that generates AI metadata for every image still
+   * missing it, and return the job so the client can poll it. Processing runs
+   * detached from this request; see `generateAIMetadata` for the synchronous
+   * counterpart that works on an explicit selection.
+   */ async createAIMetadataJob (ctx) {
         const { userAbility } = ctx.state;
         const pm = strapi.service('admin::permission').createPermissionsManager({
             ability: userAbility,
@@ -135,14 +147,15 @@ var adminFile = {
         }
     },
     /**
-   * Generate AI metadata for an explicit selection of files, synchronously.
+   * `POST /upload/actions/generate-ai-metadata`
    *
-   * Unlike `generateAIMetadata`, no job is created: the request resolves once
-   * every file has been processed and reports the outcome per file, so a single
-   * bad id or a non-image in the selection never fails the whole batch.
+   * Generate AI metadata for the explicit selection of files in the body,
+   * synchronously: the request resolves once every file has been processed and
+   * reports the outcome per file, so a single bad id or a non-image in the
+   * selection never fails the whole batch.
    *
-   * @experimental
-   */ async unstable_generateAIMetadata (ctx) {
+   * For the whole-library backfill, see `createAIMetadataJob`.
+   */ async generateAIMetadata (ctx) {
         const { userAbility } = ctx.state;
         const { body } = ctx.request;
         const pm = strapi.service('admin::permission').createPermissionsManager({
@@ -163,7 +176,12 @@ var adminFile = {
             data: results
         };
     },
-    async getLatestAIMetadataJob (ctx) {
+    /**
+   * `GET /upload/ai-metadata-jobs/latest`
+   *
+   * The most recent still-active backfill job, so a client that reloads mid-run
+   * can pick the progress bar back up. 404s when nothing is running.
+   */ async getLatestAIMetadataJob (ctx) {
         if (await index.getService('aiMetadata').isEnabled() === false) {
             return ctx.notFound();
         }

package/dist/server/controllers/admin-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file.js","sources":["../../../server/src/controllers/admin-file.ts"],"sourcesContent":["import { merge } from 'lodash/fp';\nimport { async } from '@strapi/utils';\n\nimport type { Context } from 'koa';\n\nimport { getService } from '../utils';\nimport { ACTIONS, FILE_MODEL_UID } from '../constants';\nimport { findEntityAndCheckPermissions } from './utils/find-entity-and-check-permissions';\nimport { validateGenerateAIMetadataBody } from './validation/admin/ai-metadata';\n\nexport default {\n  async find(ctx: Context) {\n    const {\n      state: { userAbility },\n    } = ctx;\n\n    const defaultQuery = { populate: { folder: true } };\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.read,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    // validate the incoming user query params\n    await pm.validateQuery(ctx.query);\n\n    const query = await async.pipe(\n      // Start by sanitizing the incoming query\n      (q) => pm.sanitizeQuery(q),\n      // Add the default query which should not be validated or sanitized\n      (q) => merge(defaultQuery, q),\n      // Add the dynamic filters based on permissions' conditions\n      (q) => pm.addPermissionsQueryTo(q)\n    )(ctx.query);\n\n    const { results: files, pagination } = await getService('upload').findPage(query);\n\n    // Sign file urls for private providers\n    const signedFiles = await async.map(files, getService('file').signFileUrls);\n\n    const sanitizedFiles = await pm.sanitizeOutput(signedFiles);\n\n    return { results: sanitizedFiles, pagination };\n  },\n\n  async findOne(ctx: Context) {\n    const {\n      state: { userAbility },\n      params: { id },\n    } = ctx;\n\n    const { pm, file } = await findEntityAndCheckPermissions(\n      userAbility,\n      ACTIONS.read,\n      FILE_MODEL_UID,\n      id\n    );\n\n    const signedFile = await getService('file').signFileUrls(file);\n    ctx.body = await pm.sanitizeOutput(signedFile);\n  },\n\n  async destroy(ctx: Context) {\n    const { id } = ctx.params;\n    const { userAbility } = ctx.state;\n\n    const { pm, file } = await findEntityAndCheckPermissions(\n      userAbility,\n      ACTIONS.update,\n      FILE_MODEL_UID,\n      id\n    );\n\n    const [body] = await Promise.all([\n      pm.sanitizeOutput(file, { action: ACTIONS.read }),\n      getService('upload').remove(file),\n    ]);\n\n    ctx.body = body;\n  },\n\n  async getAIMetadataCount(ctx: Context) {\n    const { userAbility } = ctx.state;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.read,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const aiMetadataService = getService('aiMetadata');\n\n    // Check if AI service is enabled\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    try {\n      const { imagesWithoutMetadataCount, totalImages } =\n        await aiMetadataService.countImagesWithoutMetadata();\n\n      ctx.body = {\n        imagesWithoutMetadataCount,\n        totalImages,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Failed to get AI metadata count';\n\n      strapi.log.error('Failed to get AI metadata count', {\n        message,\n        error,\n      });\n\n      ctx.badRequest(message);\n    }\n  },\n\n  async generateAIMetadata(ctx: Context) {\n    const { userAbility } = ctx.state;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.update,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const aiMetadataService = getService('aiMetadata');\n\n    // Check if AI service is enabled\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    try {\n      // Get count first to check if there are images to process\n      const result = await aiMetadataService.countImagesWithoutMetadata();\n\n      if (result.imagesWithoutMetadataCount === 0) {\n        ctx.body = {\n          count: 0,\n          message: 'No images without metadata found',\n        };\n        return;\n      }\n\n      // Create job\n      const jobService = getService('aiMetadataJobs');\n      const jobId = await jobService.createJob();\n\n      // Start async processing (fire and forget)\n      aiMetadataService.processExistingFiles(jobId, ctx.state.user).catch((err: Error) => {\n        strapi.log.error('AI metadata job failed:', err);\n      });\n\n      // Return immediately with job ID\n      ctx.body = {\n        jobId,\n        status: 'pending',\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Failed to generate AI metadata';\n      const cause = error instanceof Error && error.cause ? String(error.cause) : undefined;\n\n      strapi.log.error('AI metadata generation failed in controller', {\n        message,\n        cause,\n        error,\n      });\n\n      ctx.badRequest(cause ? `${message}: ${cause}` : message);\n    }\n  },\n\n  /**\n   * Generate AI metadata for an explicit selection of files, synchronously.\n   *\n   * Unlike `generateAIMetadata`, no job is created: the request resolves once\n   * every file has been processed and reports the outcome per file, so a single\n   * bad id or a non-image in the selection never fails the whole batch.\n   *\n   * @experimental\n   */\n  async unstable_generateAIMetadata(ctx: Context) {\n    const { userAbility } = ctx.state;\n    const { body } = ctx.request;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.update,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const { fileIds } = await validateGenerateAIMetadataBody(body);\n\n    const aiMetadataService = getService('aiMetadata');\n\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    const results = await aiMetadataService.generateForFiles(fileIds, ctx.state.user);\n\n    ctx.body = { data: results };\n  },\n\n  async getLatestAIMetadataJob(ctx: Context) {\n    if ((await getService('aiMetadata').isEnabled()) === false) {\n      return ctx.notFound();\n    }\n\n    const jobService = getService('aiMetadataJobs');\n    const job = await jobService.getLatestActiveJob();\n\n    if (!job) {\n      return ctx.notFound('No active job found');\n    }\n\n    ctx.body = job;\n  },\n};\n"],"names":["find","ctx","state","userAbility","defaultQuery","populate","folder","pm","strapi","service","createPermissionsManager","ability","action","ACTIONS","read","model","FILE_MODEL_UID","isAllowed","forbidden","validateQuery","query","async","pipe","q","sanitizeQuery","merge","addPermissionsQueryTo","results","files","pagination","getService","findPage","signedFiles","map","signFileUrls","sanitizedFiles","sanitizeOutput","findOne","params","id","file","findEntityAndCheckPermissions","signedFile","body","destroy","update","Promise","all","remove","getAIMetadataCount","aiMetadataService","isEnabled","badRequest","imagesWithoutMetadataCount","totalImages","countImagesWithoutMetadata","error","message","Error","log","generateAIMetadata","result","count","jobService","jobId","createJob","processExistingFiles","user","catch","err","status","cause","String","undefined","unstable_generateAIMetadata","request","fileIds","validateGenerateAIMetadataBody","generateForFiles","data","getLatestAIMetadataJob","notFound","job","getLatestActiveJob"],"mappings":"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"}
+{"version":3,"file":"admin-file.js","sources":["../../../server/src/controllers/admin-file.ts"],"sourcesContent":["import { merge } from 'lodash/fp';\nimport { async } from '@strapi/utils';\n\nimport type { Context } from 'koa';\n\nimport { getService } from '../utils';\nimport { ACTIONS, FILE_MODEL_UID } from '../constants';\nimport { findEntityAndCheckPermissions } from './utils/find-entity-and-check-permissions';\nimport { validateGenerateAIMetadataBody } from './validation/admin/ai-metadata';\n\nexport default {\n  async find(ctx: Context) {\n    const {\n      state: { userAbility },\n    } = ctx;\n\n    const defaultQuery = { populate: { folder: true } };\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.read,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    // validate the incoming user query params\n    await pm.validateQuery(ctx.query);\n\n    const query = await async.pipe(\n      // Start by sanitizing the incoming query\n      (q) => pm.sanitizeQuery(q),\n      // Add the default query which should not be validated or sanitized\n      (q) => merge(defaultQuery, q),\n      // Add the dynamic filters based on permissions' conditions\n      (q) => pm.addPermissionsQueryTo(q)\n    )(ctx.query);\n\n    const { results: files, pagination } = await getService('upload').findPage(query);\n\n    // Sign file urls for private providers\n    const signedFiles = await async.map(files, getService('file').signFileUrls);\n\n    const sanitizedFiles = await pm.sanitizeOutput(signedFiles);\n\n    return { results: sanitizedFiles, pagination };\n  },\n\n  async findOne(ctx: Context) {\n    const {\n      state: { userAbility },\n      params: { id },\n    } = ctx;\n\n    const { pm, file } = await findEntityAndCheckPermissions(\n      userAbility,\n      ACTIONS.read,\n      FILE_MODEL_UID,\n      id\n    );\n\n    const signedFile = await getService('file').signFileUrls(file);\n    ctx.body = await pm.sanitizeOutput(signedFile);\n  },\n\n  async destroy(ctx: Context) {\n    const { id } = ctx.params;\n    const { userAbility } = ctx.state;\n\n    const { pm, file } = await findEntityAndCheckPermissions(\n      userAbility,\n      ACTIONS.update,\n      FILE_MODEL_UID,\n      id\n    );\n\n    const [body] = await Promise.all([\n      pm.sanitizeOutput(file, { action: ACTIONS.read }),\n      getService('upload').remove(file),\n    ]);\n\n    ctx.body = body;\n  },\n\n  /**\n   * `GET /upload/ai-metadata-jobs/pending-count`\n   *\n   * How many images a backfill job would have to process, i.e. those still\n   * missing AI metadata, alongside the total image count.\n   */\n  async getAIMetadataPendingCount(ctx: Context) {\n    const { userAbility } = ctx.state;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.read,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const aiMetadataService = getService('aiMetadata');\n\n    // Check if AI service is enabled\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    try {\n      const { imagesWithoutMetadataCount, totalImages } =\n        await aiMetadataService.countImagesWithoutMetadata();\n\n      ctx.body = {\n        imagesWithoutMetadataCount,\n        totalImages,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Failed to get AI metadata count';\n\n      strapi.log.error('Failed to get AI metadata count', {\n        message,\n        error,\n      });\n\n      ctx.badRequest(message);\n    }\n  },\n\n  /**\n   * `POST /upload/ai-metadata-jobs`\n   *\n   * Create a backfill job that generates AI metadata for every image still\n   * missing it, and return the job so the client can poll it. Processing runs\n   * detached from this request; see `generateAIMetadata` for the synchronous\n   * counterpart that works on an explicit selection.\n   */\n  async createAIMetadataJob(ctx: Context) {\n    const { userAbility } = ctx.state;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.update,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const aiMetadataService = getService('aiMetadata');\n\n    // Check if AI service is enabled\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    try {\n      // Get count first to check if there are images to process\n      const result = await aiMetadataService.countImagesWithoutMetadata();\n\n      if (result.imagesWithoutMetadataCount === 0) {\n        ctx.body = {\n          count: 0,\n          message: 'No images without metadata found',\n        };\n        return;\n      }\n\n      // Create job\n      const jobService = getService('aiMetadataJobs');\n      const jobId = await jobService.createJob();\n\n      // Start async processing (fire and forget)\n      aiMetadataService.processExistingFiles(jobId, ctx.state.user).catch((err: Error) => {\n        strapi.log.error('AI metadata job failed:', err);\n      });\n\n      // Return immediately with job ID\n      ctx.body = {\n        jobId,\n        status: 'pending',\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Failed to generate AI metadata';\n      const cause = error instanceof Error && error.cause ? String(error.cause) : undefined;\n\n      strapi.log.error('AI metadata generation failed in controller', {\n        message,\n        cause,\n        error,\n      });\n\n      ctx.badRequest(cause ? `${message}: ${cause}` : message);\n    }\n  },\n\n  /**\n   * `POST /upload/actions/generate-ai-metadata`\n   *\n   * Generate AI metadata for the explicit selection of files in the body,\n   * synchronously: the request resolves once every file has been processed and\n   * reports the outcome per file, so a single bad id or a non-image in the\n   * selection never fails the whole batch.\n   *\n   * For the whole-library backfill, see `createAIMetadataJob`.\n   */\n  async generateAIMetadata(ctx: Context) {\n    const { userAbility } = ctx.state;\n    const { body } = ctx.request;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.update,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const { fileIds } = await validateGenerateAIMetadataBody(body);\n\n    const aiMetadataService = getService('aiMetadata');\n\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    const results = await aiMetadataService.generateForFiles(fileIds, ctx.state.user);\n\n    ctx.body = { data: results };\n  },\n\n  /**\n   * `GET /upload/ai-metadata-jobs/latest`\n   *\n   * The most recent still-active backfill job, so a client that reloads mid-run\n   * can pick the progress bar back up. 404s when nothing is running.\n   */\n  async getLatestAIMetadataJob(ctx: Context) {\n    if ((await getService('aiMetadata').isEnabled()) === false) {\n      return ctx.notFound();\n    }\n\n    const jobService = getService('aiMetadataJobs');\n    const job = await jobService.getLatestActiveJob();\n\n    if (!job) {\n      return ctx.notFound('No active job found');\n    }\n\n    ctx.body = job;\n  },\n};\n"],"names":["find","ctx","state","userAbility","defaultQuery","populate","folder","pm","strapi","service","createPermissionsManager","ability","action","ACTIONS","read","model","FILE_MODEL_UID","isAllowed","forbidden","validateQuery","query","async","pipe","q","sanitizeQuery","merge","addPermissionsQueryTo","results","files","pagination","getService","findPage","signedFiles","map","signFileUrls","sanitizedFiles","sanitizeOutput","findOne","params","id","file","findEntityAndCheckPermissions","signedFile","body","destroy","update","Promise","all","remove","getAIMetadataPendingCount","aiMetadataService","isEnabled","badRequest","imagesWithoutMetadataCount","totalImages","countImagesWithoutMetadata","error","message","Error","log","createAIMetadataJob","result","count","jobService","jobId","createJob","processExistingFiles","user","catch","err","status","cause","String","undefined","generateAIMetadata","request","fileIds","validateGenerateAIMetadataBody","generateForFiles","data","getLatestAIMetadataJob","notFound","job","getLatestActiveJob"],"mappings":"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"}

package/dist/server/controllers/admin-file.mjs

@@ -54,7 +54,12 @@ var adminFile = {
         ]);
         ctx.body = body;
     },
-    async getAIMetadataCount (ctx) {
+    /**
+   * `GET /upload/ai-metadata-jobs/pending-count`
+   *
+   * How many images a backfill job would have to process, i.e. those still
+   * missing AI metadata, alongside the total image count.
+   */ async getAIMetadataPendingCount (ctx) {
         const { userAbility } = ctx.state;
         const pm = strapi.service('admin::permission').createPermissionsManager({
             ability: userAbility,
@@ -84,7 +89,14 @@ var adminFile = {
             ctx.badRequest(message);
         }
     },
-    async generateAIMetadata (ctx) {
+    /**
+   * `POST /upload/ai-metadata-jobs`
+   *
+   * Create a backfill job that generates AI metadata for every image still
+   * missing it, and return the job so the client can poll it. Processing runs
+   * detached from this request; see `generateAIMetadata` for the synchronous
+   * counterpart that works on an explicit selection.
+   */ async createAIMetadataJob (ctx) {
         const { userAbility } = ctx.state;
         const pm = strapi.service('admin::permission').createPermissionsManager({
             ability: userAbility,
@@ -133,14 +145,15 @@ var adminFile = {
         }
     },
     /**
-   * Generate AI metadata for an explicit selection of files, synchronously.
+   * `POST /upload/actions/generate-ai-metadata`
    *
-   * Unlike `generateAIMetadata`, no job is created: the request resolves once
-   * every file has been processed and reports the outcome per file, so a single
-   * bad id or a non-image in the selection never fails the whole batch.
+   * Generate AI metadata for the explicit selection of files in the body,
+   * synchronously: the request resolves once every file has been processed and
+   * reports the outcome per file, so a single bad id or a non-image in the
+   * selection never fails the whole batch.
    *
-   * @experimental
-   */ async unstable_generateAIMetadata (ctx) {
+   * For the whole-library backfill, see `createAIMetadataJob`.
+   */ async generateAIMetadata (ctx) {
         const { userAbility } = ctx.state;
         const { body } = ctx.request;
         const pm = strapi.service('admin::permission').createPermissionsManager({
@@ -161,7 +174,12 @@ var adminFile = {
             data: results
         };
     },
-    async getLatestAIMetadataJob (ctx) {
+    /**
+   * `GET /upload/ai-metadata-jobs/latest`
+   *
+   * The most recent still-active backfill job, so a client that reloads mid-run
+   * can pick the progress bar back up. 404s when nothing is running.
+   */ async getLatestAIMetadataJob (ctx) {
         if (await getService('aiMetadata').isEnabled() === false) {
             return ctx.notFound();
         }

package/dist/server/controllers/admin-file.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"admin-file.mjs","sources":["../../../server/src/controllers/admin-file.ts"],"sourcesContent":["import { merge } from 'lodash/fp';\nimport { async } from '@strapi/utils';\n\nimport type { Context } from 'koa';\n\nimport { getService } from '../utils';\nimport { ACTIONS, FILE_MODEL_UID } from '../constants';\nimport { findEntityAndCheckPermissions } from './utils/find-entity-and-check-permissions';\nimport { validateGenerateAIMetadataBody } from './validation/admin/ai-metadata';\n\nexport default {\n  async find(ctx: Context) {\n    const {\n      state: { userAbility },\n    } = ctx;\n\n    const defaultQuery = { populate: { folder: true } };\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.read,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    // validate the incoming user query params\n    await pm.validateQuery(ctx.query);\n\n    const query = await async.pipe(\n      // Start by sanitizing the incoming query\n      (q) => pm.sanitizeQuery(q),\n      // Add the default query which should not be validated or sanitized\n      (q) => merge(defaultQuery, q),\n      // Add the dynamic filters based on permissions' conditions\n      (q) => pm.addPermissionsQueryTo(q)\n    )(ctx.query);\n\n    const { results: files, pagination } = await getService('upload').findPage(query);\n\n    // Sign file urls for private providers\n    const signedFiles = await async.map(files, getService('file').signFileUrls);\n\n    const sanitizedFiles = await pm.sanitizeOutput(signedFiles);\n\n    return { results: sanitizedFiles, pagination };\n  },\n\n  async findOne(ctx: Context) {\n    const {\n      state: { userAbility },\n      params: { id },\n    } = ctx;\n\n    const { pm, file } = await findEntityAndCheckPermissions(\n      userAbility,\n      ACTIONS.read,\n      FILE_MODEL_UID,\n      id\n    );\n\n    const signedFile = await getService('file').signFileUrls(file);\n    ctx.body = await pm.sanitizeOutput(signedFile);\n  },\n\n  async destroy(ctx: Context) {\n    const { id } = ctx.params;\n    const { userAbility } = ctx.state;\n\n    const { pm, file } = await findEntityAndCheckPermissions(\n      userAbility,\n      ACTIONS.update,\n      FILE_MODEL_UID,\n      id\n    );\n\n    const [body] = await Promise.all([\n      pm.sanitizeOutput(file, { action: ACTIONS.read }),\n      getService('upload').remove(file),\n    ]);\n\n    ctx.body = body;\n  },\n\n  async getAIMetadataCount(ctx: Context) {\n    const { userAbility } = ctx.state;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.read,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const aiMetadataService = getService('aiMetadata');\n\n    // Check if AI service is enabled\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    try {\n      const { imagesWithoutMetadataCount, totalImages } =\n        await aiMetadataService.countImagesWithoutMetadata();\n\n      ctx.body = {\n        imagesWithoutMetadataCount,\n        totalImages,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Failed to get AI metadata count';\n\n      strapi.log.error('Failed to get AI metadata count', {\n        message,\n        error,\n      });\n\n      ctx.badRequest(message);\n    }\n  },\n\n  async generateAIMetadata(ctx: Context) {\n    const { userAbility } = ctx.state;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.update,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const aiMetadataService = getService('aiMetadata');\n\n    // Check if AI service is enabled\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    try {\n      // Get count first to check if there are images to process\n      const result = await aiMetadataService.countImagesWithoutMetadata();\n\n      if (result.imagesWithoutMetadataCount === 0) {\n        ctx.body = {\n          count: 0,\n          message: 'No images without metadata found',\n        };\n        return;\n      }\n\n      // Create job\n      const jobService = getService('aiMetadataJobs');\n      const jobId = await jobService.createJob();\n\n      // Start async processing (fire and forget)\n      aiMetadataService.processExistingFiles(jobId, ctx.state.user).catch((err: Error) => {\n        strapi.log.error('AI metadata job failed:', err);\n      });\n\n      // Return immediately with job ID\n      ctx.body = {\n        jobId,\n        status: 'pending',\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Failed to generate AI metadata';\n      const cause = error instanceof Error && error.cause ? String(error.cause) : undefined;\n\n      strapi.log.error('AI metadata generation failed in controller', {\n        message,\n        cause,\n        error,\n      });\n\n      ctx.badRequest(cause ? `${message}: ${cause}` : message);\n    }\n  },\n\n  /**\n   * Generate AI metadata for an explicit selection of files, synchronously.\n   *\n   * Unlike `generateAIMetadata`, no job is created: the request resolves once\n   * every file has been processed and reports the outcome per file, so a single\n   * bad id or a non-image in the selection never fails the whole batch.\n   *\n   * @experimental\n   */\n  async unstable_generateAIMetadata(ctx: Context) {\n    const { userAbility } = ctx.state;\n    const { body } = ctx.request;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.update,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const { fileIds } = await validateGenerateAIMetadataBody(body);\n\n    const aiMetadataService = getService('aiMetadata');\n\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    const results = await aiMetadataService.generateForFiles(fileIds, ctx.state.user);\n\n    ctx.body = { data: results };\n  },\n\n  async getLatestAIMetadataJob(ctx: Context) {\n    if ((await getService('aiMetadata').isEnabled()) === false) {\n      return ctx.notFound();\n    }\n\n    const jobService = getService('aiMetadataJobs');\n    const job = await jobService.getLatestActiveJob();\n\n    if (!job) {\n      return ctx.notFound('No active job found');\n    }\n\n    ctx.body = job;\n  },\n};\n"],"names":["find","ctx","state","userAbility","defaultQuery","populate","folder","pm","strapi","service","createPermissionsManager","ability","action","ACTIONS","read","model","FILE_MODEL_UID","isAllowed","forbidden","validateQuery","query","async","pipe","q","sanitizeQuery","merge","addPermissionsQueryTo","results","files","pagination","getService","findPage","signedFiles","map","signFileUrls","sanitizedFiles","sanitizeOutput","findOne","params","id","file","findEntityAndCheckPermissions","signedFile","body","destroy","update","Promise","all","remove","getAIMetadataCount","aiMetadataService","isEnabled","badRequest","imagesWithoutMetadataCount","totalImages","countImagesWithoutMetadata","error","message","Error","log","generateAIMetadata","result","count","jobService","jobId","createJob","processExistingFiles","user","catch","err","status","cause","String","undefined","unstable_generateAIMetadata","request","fileIds","validateGenerateAIMetadataBody","generateForFiles","data","getLatestAIMetadataJob","notFound","job","getLatestActiveJob"],"mappings":"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"}
+{"version":3,"file":"admin-file.mjs","sources":["../../../server/src/controllers/admin-file.ts"],"sourcesContent":["import { merge } from 'lodash/fp';\nimport { async } from '@strapi/utils';\n\nimport type { Context } from 'koa';\n\nimport { getService } from '../utils';\nimport { ACTIONS, FILE_MODEL_UID } from '../constants';\nimport { findEntityAndCheckPermissions } from './utils/find-entity-and-check-permissions';\nimport { validateGenerateAIMetadataBody } from './validation/admin/ai-metadata';\n\nexport default {\n  async find(ctx: Context) {\n    const {\n      state: { userAbility },\n    } = ctx;\n\n    const defaultQuery = { populate: { folder: true } };\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.read,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    // validate the incoming user query params\n    await pm.validateQuery(ctx.query);\n\n    const query = await async.pipe(\n      // Start by sanitizing the incoming query\n      (q) => pm.sanitizeQuery(q),\n      // Add the default query which should not be validated or sanitized\n      (q) => merge(defaultQuery, q),\n      // Add the dynamic filters based on permissions' conditions\n      (q) => pm.addPermissionsQueryTo(q)\n    )(ctx.query);\n\n    const { results: files, pagination } = await getService('upload').findPage(query);\n\n    // Sign file urls for private providers\n    const signedFiles = await async.map(files, getService('file').signFileUrls);\n\n    const sanitizedFiles = await pm.sanitizeOutput(signedFiles);\n\n    return { results: sanitizedFiles, pagination };\n  },\n\n  async findOne(ctx: Context) {\n    const {\n      state: { userAbility },\n      params: { id },\n    } = ctx;\n\n    const { pm, file } = await findEntityAndCheckPermissions(\n      userAbility,\n      ACTIONS.read,\n      FILE_MODEL_UID,\n      id\n    );\n\n    const signedFile = await getService('file').signFileUrls(file);\n    ctx.body = await pm.sanitizeOutput(signedFile);\n  },\n\n  async destroy(ctx: Context) {\n    const { id } = ctx.params;\n    const { userAbility } = ctx.state;\n\n    const { pm, file } = await findEntityAndCheckPermissions(\n      userAbility,\n      ACTIONS.update,\n      FILE_MODEL_UID,\n      id\n    );\n\n    const [body] = await Promise.all([\n      pm.sanitizeOutput(file, { action: ACTIONS.read }),\n      getService('upload').remove(file),\n    ]);\n\n    ctx.body = body;\n  },\n\n  /**\n   * `GET /upload/ai-metadata-jobs/pending-count`\n   *\n   * How many images a backfill job would have to process, i.e. those still\n   * missing AI metadata, alongside the total image count.\n   */\n  async getAIMetadataPendingCount(ctx: Context) {\n    const { userAbility } = ctx.state;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.read,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const aiMetadataService = getService('aiMetadata');\n\n    // Check if AI service is enabled\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    try {\n      const { imagesWithoutMetadataCount, totalImages } =\n        await aiMetadataService.countImagesWithoutMetadata();\n\n      ctx.body = {\n        imagesWithoutMetadataCount,\n        totalImages,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Failed to get AI metadata count';\n\n      strapi.log.error('Failed to get AI metadata count', {\n        message,\n        error,\n      });\n\n      ctx.badRequest(message);\n    }\n  },\n\n  /**\n   * `POST /upload/ai-metadata-jobs`\n   *\n   * Create a backfill job that generates AI metadata for every image still\n   * missing it, and return the job so the client can poll it. Processing runs\n   * detached from this request; see `generateAIMetadata` for the synchronous\n   * counterpart that works on an explicit selection.\n   */\n  async createAIMetadataJob(ctx: Context) {\n    const { userAbility } = ctx.state;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.update,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const aiMetadataService = getService('aiMetadata');\n\n    // Check if AI service is enabled\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    try {\n      // Get count first to check if there are images to process\n      const result = await aiMetadataService.countImagesWithoutMetadata();\n\n      if (result.imagesWithoutMetadataCount === 0) {\n        ctx.body = {\n          count: 0,\n          message: 'No images without metadata found',\n        };\n        return;\n      }\n\n      // Create job\n      const jobService = getService('aiMetadataJobs');\n      const jobId = await jobService.createJob();\n\n      // Start async processing (fire and forget)\n      aiMetadataService.processExistingFiles(jobId, ctx.state.user).catch((err: Error) => {\n        strapi.log.error('AI metadata job failed:', err);\n      });\n\n      // Return immediately with job ID\n      ctx.body = {\n        jobId,\n        status: 'pending',\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'Failed to generate AI metadata';\n      const cause = error instanceof Error && error.cause ? String(error.cause) : undefined;\n\n      strapi.log.error('AI metadata generation failed in controller', {\n        message,\n        cause,\n        error,\n      });\n\n      ctx.badRequest(cause ? `${message}: ${cause}` : message);\n    }\n  },\n\n  /**\n   * `POST /upload/actions/generate-ai-metadata`\n   *\n   * Generate AI metadata for the explicit selection of files in the body,\n   * synchronously: the request resolves once every file has been processed and\n   * reports the outcome per file, so a single bad id or a non-image in the\n   * selection never fails the whole batch.\n   *\n   * For the whole-library backfill, see `createAIMetadataJob`.\n   */\n  async generateAIMetadata(ctx: Context) {\n    const { userAbility } = ctx.state;\n    const { body } = ctx.request;\n\n    const pm = strapi.service('admin::permission').createPermissionsManager({\n      ability: userAbility,\n      action: ACTIONS.update,\n      model: FILE_MODEL_UID,\n    });\n\n    if (!pm.isAllowed) {\n      return ctx.forbidden();\n    }\n\n    const { fileIds } = await validateGenerateAIMetadataBody(body);\n\n    const aiMetadataService = getService('aiMetadata');\n\n    if (!(await aiMetadataService.isEnabled())) {\n      return ctx.badRequest('AI Metadata service is not enabled');\n    }\n\n    const results = await aiMetadataService.generateForFiles(fileIds, ctx.state.user);\n\n    ctx.body = { data: results };\n  },\n\n  /**\n   * `GET /upload/ai-metadata-jobs/latest`\n   *\n   * The most recent still-active backfill job, so a client that reloads mid-run\n   * can pick the progress bar back up. 404s when nothing is running.\n   */\n  async getLatestAIMetadataJob(ctx: Context) {\n    if ((await getService('aiMetadata').isEnabled()) === false) {\n      return ctx.notFound();\n    }\n\n    const jobService = getService('aiMetadataJobs');\n    const job = await jobService.getLatestActiveJob();\n\n    if (!job) {\n      return ctx.notFound('No active job found');\n    }\n\n    ctx.body = job;\n  },\n};\n"],"names":["find","ctx","state","userAbility","defaultQuery","populate","folder","pm","strapi","service","createPermissionsManager","ability","action","ACTIONS","read","model","FILE_MODEL_UID","isAllowed","forbidden","validateQuery","query","async","pipe","q","sanitizeQuery","merge","addPermissionsQueryTo","results","files","pagination","getService","findPage","signedFiles","map","signFileUrls","sanitizedFiles","sanitizeOutput","findOne","params","id","file","findEntityAndCheckPermissions","signedFile","body","destroy","update","Promise","all","remove","getAIMetadataPendingCount","aiMetadataService","isEnabled","badRequest","imagesWithoutMetadataCount","totalImages","countImagesWithoutMetadata","error","message","Error","log","createAIMetadataJob","result","count","jobService","jobId","createJob","processExistingFiles","user","catch","err","status","cause","String","undefined","generateAIMetadata","request","fileIds","validateGenerateAIMetadataBody","generateForFiles","data","getLatestAIMetadataJob","notFound","job","getLatestActiveJob"],"mappings":"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"}

package/dist/server/controllers/admin-upload.js

@@ -36,8 +36,15 @@ var adminUpload = {
         });
         ctx.body = results;
     },
-    async updateFileInfo (ctx) {
-        const { state: { userAbility, user }, query: { id }, request: { body } } = ctx;
+    /**
+   * `PUT /upload/files/:id`
+   *
+   * Update the editable metadata (`fileInfo`) of an existing file. Also reached
+   * through the `POST /upload` multiplexer, which delegates here with the id in
+   * `ctx.query` — hence the dual read below, route params winning.
+   */ async updateFileInfo (ctx) {
+        const { state: { userAbility, user }, request: { body } } = ctx;
+        const id = ctx.params?.id ?? ctx.query.id;
         if (typeof id !== 'string') {
             throw new utils.errors.ValidationError('File id is required');
         }
@@ -53,8 +60,15 @@ var adminUpload = {
             action: constants.ACTIONS.read
         });
     },
-    async replaceFile (ctx) {
-        const { state: { userAbility, user }, query: { id }, request: { body, files: { files: filesInput } = {} } } = ctx;
+    /**
+   * `POST /upload/files/:id/replace`
+   *
+   * Replace the binary content of an existing file. Also reached through the
+   * `POST /upload` multiplexer, which delegates here with the id in `ctx.query`
+   * — hence the dual read below, route params winning.
+   */ async replaceFile (ctx) {
+        const { state: { userAbility, user }, request: { body, files: { files: filesInput } = {} } } = ctx;
+        const id = ctx.params?.id ?? ctx.query.id;
         if (typeof id !== 'string') {
             throw new utils.errors.ValidationError('File id is required');
         }
@@ -156,14 +170,15 @@ var adminUpload = {
         ctx.status = 201;
     },
     /**
-   * @experimental
+   * `POST /upload/files`
+   *
    * Upload a single file and return the created File.
    *
    * Accepts one file per request (multipart `files` + `fileInfo`) and returns a
    * single `File` object. Unlike `uploadFiles`, it does **not** run AI metadata
    * generation inline — that responsibility is decoupled and will be handled by a
    * background job. Auth and permission checks mirror `POST /upload`.
-   */ async unstable_uploadFile (ctx) {
+   */ async uploadFile (ctx) {
         const { state: { userAbility, user }, request: { body, files: { files } = {} } } = ctx;
         const uploadService = index.getService('upload');
         const pm = strapi.service('admin::permission').createPermissionsManager({
@@ -227,7 +242,8 @@ var adminUpload = {
         ctx.status = 201;
     },
     /**
-   * @experimental
+   * `POST /upload/actions/upload-from-urls`
+   *
    * Upload files from URLs with SSE streaming for per-file progress
    *
    * Accepts JSON body with URLs and fetches them server-side.
@@ -237,7 +253,7 @@ var adminUpload = {
    * - file:complete  — when a file is successfully uploaded
    * - file:error     — when a URL fetch or upload fails
    * - stream:complete — final summary with all results
-   */ async unstable_uploadFromUrls (ctx) {
+   */ async uploadFromUrls (ctx) {
         const { state: { userAbility, user }, request: { body } } = ctx;
         const uploadService = index.getService('upload');
         const fileService = index.getService('file');