nuxt-media-library 0.0.59 → 0.0.60

package/README.md

@@ -316,6 +316,42 @@ name, extension, MIME type, kind, size, duration, width, height and pages.
   has none yet.
 - `useMLMediaMeta(ids, getAsset)` gives the same map for your own lists.
 
+### Error messages, in the editor's language
+
+When a backend refuses a request it answers `{ detail, reason }`: `reason`
+is a stable code (py_client `UploadRejected`: `too_large`, `mime_type`,
+`context_mismatch`, …), `detail` English text. The widgets show, first that
+applies:
+
+1. the text for a known `reason`, in the editor's language;
+2. `detail` (a 422's first `msg`);
+3. the backend's inner `message`, then the status text;
+4. the place's own fallback ("Upload failed", "Could not add the file", …).
+
+The body is read whether the module's own proxy streamed it (`err.data`) or
+an app proxy rethrew it with h3 `createError({ data })` (`err.data.data`).
+The raw "[POST] url: 400" text is never shown.
+
+The language is the app's `@nuxtjs/i18n` locale, else `mediaLibrary.locale`;
+its language part picks the texts (`ar-SA` → `ar`). Built in: `en` and `ar`.
+An app can change any text, or add a language:
+
+```ts
+mediaLibrary: {
+  locale: 'ar',                      // without @nuxtjs/i18n
+  errorTexts: {
+    ar: {
+      reasons: { too_large: 'حجم هذا الملف أكبر من المسموح.' },
+      fallbacks: { upload: 'فشل رفع الملف' },
+    },
+  },
+},
+```
+
+A reason with no text in the editor's language uses the English one, then
+`detail`. `mediaErrorMessage(err, fallback, { locale, texts })` and
+`mlErrorMessage(err, fallback)` are exported for your own pages.
+
 ### Vue installation (non-Nuxt)
 
 ```bash

package/dist/module.d.mts

@@ -1,6 +1,7 @@
 import * as _nuxt_schema from '@nuxt/schema';
 import { ServiceUploadBackend } from '../dist/runtime/utils/uploader/serviceBackends.js';
 import { MediaBackends } from '../dist/runtime/utils/backends.js';
+import { MediaErrorTextsByLocale } from '../dist/runtime/utils/errorMessage.js';
 export * from '../dist/runtime/types/resourcePolicy.js';
 export * from '../dist/runtime/types/uploader.js';
 export * from '../dist/runtime/types/preview.js';
@@ -72,6 +73,17 @@ interface ModuleOptions {
      * its routes.
      */
     backends?: MediaBackends;
+    /**
+     * Language of the widgets' error texts when the app has no i18n locale
+     * (with @nuxtjs/i18n its active locale wins). Built in: `en`, `ar`.
+     */
+    locale?: string;
+    /**
+     * The app's error texts over the built-in ones, by language:
+     * `{ ar: { reasons: { too_large: '…' }, fallbacks: { upload: '…' } } }`.
+     * `reasons` are backend reason codes (py_client `UploadRejected`).
+     */
+    errorTexts?: MediaErrorTextsByLocale;
 }
 declare const SERVICE_UPLOADS_ROUTE = "/api/media-library/service-uploads";
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;

package/dist/module.d.ts

@@ -1,6 +1,7 @@
 import * as _nuxt_schema from '@nuxt/schema';
 import { ServiceUploadBackend } from '../dist/runtime/utils/uploader/serviceBackends.js';
 import { MediaBackends } from '../dist/runtime/utils/backends.js';
+import { MediaErrorTextsByLocale } from '../dist/runtime/utils/errorMessage.js';
 export * from '../dist/runtime/types/resourcePolicy.js';
 export * from '../dist/runtime/types/uploader.js';
 export * from '../dist/runtime/types/preview.js';
@@ -72,6 +73,17 @@ interface ModuleOptions {
      * its routes.
      */
     backends?: MediaBackends;
+    /**
+     * Language of the widgets' error texts when the app has no i18n locale
+     * (with @nuxtjs/i18n its active locale wins). Built in: `en`, `ar`.
+     */
+    locale?: string;
+    /**
+     * The app's error texts over the built-in ones, by language:
+     * `{ ar: { reasons: { too_large: '…' }, fallbacks: { upload: '…' } } }`.
+     * `reasons` are backend reason codes (py_client `UploadRejected`).
+     */
+    errorTexts?: MediaErrorTextsByLocale;
 }
 declare const SERVICE_UPLOADS_ROUTE = "/api/media-library/service-uploads";
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "media-library",
   "configKey": "mediaLibrary",
-  "version": "0.0.59",
+  "version": "0.0.60",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/module.mjs

@@ -177,6 +177,9 @@ const module$1 = defineNuxtModule({
       // The backend registry (NUXT_PUBLIC_MEDIA_LIBRARY_BACKENDS): names widgets pass as `backend`.
       backends,
       // Older form, kept for code that reads it: each backend's upload routes.
+      // NUXT_PUBLIC_MEDIA_LIBRARY_LOCALE; the app's i18n locale wins at runtime.
+      locale: existingPublic.locale || options.locale || "",
+      errorTexts: { ...options.errorTexts, ...existingPublic.errorTexts },
       serviceUploadBackends: Object.fromEntries(
         Object.entries(backends).flatMap(([name, b]) => b.upload ? [[name, b.upload]] : [])
       )

package/dist/runtime/components/MLAssetManager/AssetOverview.vue

@@ -1,6 +1,7 @@
 <script setup>
 import { computed, ref, watch } from "vue";
 import { useMLResourcePolicy, Visibility } from "../../index";
+import { mlErrorMessage } from "../../utils/errorMessage";
 const props = defineProps({
   asset: { type: Object, required: true },
   manager: { type: Object, required: false }
@@ -71,7 +72,7 @@ async function changeVisibility(next) {
   try {
     await props.manager.updateAsset(props.asset.id, { visibility: next });
   } catch (err) {
-    visibilityError.value = err instanceof Error ? err.message : "Failed to update visibility";
+    visibilityError.value = mlErrorMessage(err, "updateVisibility");
   } finally {
     visibilityUpdating.value = false;
   }
@@ -138,7 +139,7 @@ async function loadPolicy() {
   try {
     policy.value = await policyApi.get(id);
   } catch (err) {
-    policyError.value = err instanceof Error ? err.message : "Failed to load policy";
+    policyError.value = mlErrorMessage(err, "loadPolicy");
     policy.value = null;
   } finally {
     policyLoading.value = false;

package/dist/runtime/components/MLMedia/ProgressVeil.d.vue.ts

@@ -16,10 +16,10 @@ type __VLS_Props = {
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     progress: number | null;
     compact: boolean;
+    detail: string;
     label: string;
     onCancel: () => void;
     onRetry: () => void;
-    detail: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/MLMedia/ProgressVeil.vue.d.ts

@@ -16,10 +16,10 @@ type __VLS_Props = {
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     progress: number | null;
     compact: boolean;
+    detail: string;
     label: string;
     onCancel: () => void;
     onRetry: () => void;
-    detail: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/MLMedia/UploadRow.vue

@@ -7,6 +7,7 @@ import { formatBytes } from "../../utils/assetFormat";
 import { isBackgroundStep, stepLabel } from "../../utils/processingSteps";
 import UploadProgress from "./UploadProgress.vue";
 import UploadSteps from "./UploadSteps.vue";
+import { mlErrorMessage } from "../../utils/errorMessage";
 const props = defineProps({
   upload: { type: Object, required: true },
   expanded: { type: Boolean, required: false }
@@ -94,8 +95,7 @@ async function retryStep() {
   try {
     await queue.retryStep(u.value);
   } catch (err) {
-    const message = err?.data?.detail ?? err?.data?.message ?? err?.statusMessage ?? "Could not retry this step";
-    toast.add({ title: "Retry failed", description: String(message), color: "error" });
+    toast.add({ title: "Retry failed", description: mlErrorMessage(err, "retryStep"), color: "error" });
   } finally {
     retrying.value = false;
   }

package/dist/runtime/components/MLMedia/UploadSteps.vue

@@ -5,6 +5,7 @@ import { useMLProcessingPipeline } from "../../composables/useMLProcessingPipeli
 import { stepLabel, usableAfterSteps } from "../../utils/processingSteps";
 import ConfigureStepModal from "../MLProcessing/Forms/ConfigureStepModal.vue";
 import UploadStep from "./UploadStep.vue";
+import { mlErrorMessage } from "../../utils/errorMessage";
 const props = defineProps({
   assetId: { type: String, required: true },
   kind: { type: [String, null], required: false }
@@ -34,8 +35,7 @@ async function onRetry(taskId) {
   try {
     await retryTask(taskId);
   } catch (err) {
-    const message = err?.data?.detail ?? err?.data?.message ?? err?.statusMessage ?? "Could not retry this step";
-    toast.add({ title: "Retry failed", description: String(message), color: "error" });
+    toast.add({ title: "Retry failed", description: mlErrorMessage(err, "retryStep"), color: "error" });
   }
 }
 async function onConfigure(taskId) {

package/dist/runtime/components/MLProcessing/Pipeline.vue

@@ -3,6 +3,7 @@ import { computed, watch } from "vue";
 import { useOverlay, useToast } from "#imports";
 import { useMLProcessingPipeline } from "../../composables/useMLProcessingPipeline";
 import ConfigureStepModal from "./Forms/ConfigureStepModal.vue";
+import { mlErrorMessage } from "../../utils/errorMessage";
 const props = defineProps({
   assetId: { type: String, required: true },
   downloadUrl: { type: [String, null], required: false },
@@ -42,8 +43,7 @@ async function onRetry(taskId) {
   try {
     await retryTask(taskId);
   } catch (err) {
-    const message = err?.data?.detail ?? err?.data?.message ?? err?.statusMessage ?? "Could not retry task";
-    toast.add({ title: "Retry failed", description: String(message), color: "error" });
+    toast.add({ title: "Retry failed", description: mlErrorMessage(err, "retryTask"), color: "error" });
   }
 }
 async function openConfigure(taskId) {

package/dist/runtime/composables/useMLAssetLibrary.js

@@ -1,5 +1,6 @@
 import { ref, watch } from "vue";
 import { $fetch } from "ofetch";
+import { mlErrorMessage } from "../utils/errorMessage.js";
 export function useMLAssetLibrary(options = {}) {
   const items = ref([]);
   const total = ref(0);
@@ -36,7 +37,7 @@ export function useMLAssetLibrary(options = {}) {
         total.value = result.total ?? 0;
       }
     } catch (err) {
-      error.value = err?.message ?? "Failed to load assets";
+      error.value = mlErrorMessage(err, "loadAssets");
     } finally {
       loading.value = false;
     }

package/dist/runtime/composables/useMLAssetManager.js

@@ -1,6 +1,7 @@
 import { computed, onUnmounted, ref, shallowReactive, shallowRef, watch, toValue } from "vue";
 import { $fetch } from "ofetch";
 import { useMLProcessingStatus } from "./useMLProcessingStatus.js";
+import { mlErrorMessage } from "../utils/errorMessage.js";
 export function useMLAssetManager(assetIds) {
   const assets = ref(/* @__PURE__ */ new Map());
   const loading = ref(false);
@@ -72,7 +73,7 @@ export function useMLAssetManager(assetIds) {
       }
       syncProcessingStreams();
     } catch (err) {
-      error.value = err?.message ?? "Failed to load assets";
+      error.value = mlErrorMessage(err, "loadAssets");
     } finally {
       loading.value = false;
     }

package/dist/runtime/composables/useMLMediaAssets.js

@@ -1,6 +1,7 @@
 import { computed, getCurrentScope, onMounted, onScopeDispose, ref, toValue, watch } from "vue";
 import { $fetch } from "ofetch";
 import { streamUrlsRefreshDelay } from "../utils/streamUrls.js";
+import { mlErrorMessage } from "../utils/errorMessage.js";
 export function useMLMediaAssets(ids) {
   const assets = ref({});
   const lookups = ref({});
@@ -46,7 +47,7 @@ export function useMLMediaAssets(ids) {
       assets.value = nextAssets;
       lookups.value = nextLookups;
     } catch (err) {
-      error.value = err?.data?.message ?? err?.message ?? "Could not load files";
+      error.value = mlErrorMessage(err, "loadFiles");
       lookups.value = { ...lookups.value, ...Object.fromEntries(list.map((id) => [id, "error"])) };
     } finally {
       const next = new Set(pending.value);

package/dist/runtime/composables/useMLMediaBrowse.js

@@ -1,5 +1,6 @@
 import { computed, onBeforeUnmount, onMounted, ref, toValue, watch } from "vue";
 import { $fetch } from "ofetch";
+import { mlErrorMessage } from "../utils/errorMessage.js";
 export function useMLMediaBrowse(filters, opts = {}) {
   const pageSize = opts.pageSize ?? 30;
   const debounceMs = opts.debounceMs ?? 300;
@@ -28,7 +29,7 @@ export function useMLMediaBrowse(filters, opts = {}) {
       page.value = n;
     } catch (err) {
       if (id !== request) return;
-      error.value = err?.data?.message ?? err?.message ?? "Could not load the library";
+      error.value = mlErrorMessage(err, "loadLibrary");
     } finally {
       if (id === request) loading.value = false;
     }

package/dist/runtime/composables/useMLProcessingStepper.js

@@ -7,6 +7,7 @@ import {
 } from "vue";
 import { $fetch } from "ofetch";
 import { useMLProcessingStatus } from "./useMLProcessingStatus.js";
+import { mlErrorMessage } from "../utils/errorMessage.js";
 function formatStepName(name) {
   return name.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
@@ -137,7 +138,7 @@ export function useMLProcessingStepper(assetId) {
       openStream();
     } catch (err) {
       step.status = "failed";
-      step.error = err?.data?.detail ?? err?.message ?? "Failed to trigger step";
+      step.error = mlErrorMessage(err, "triggerStep");
       steps.value = [...steps.value];
       recomputeLocks();
     }

package/dist/runtime/composables/useMLUploadQueue.js

@@ -6,6 +6,7 @@ import { resolveUploadTarget } from "../utils/backends.js";
 import { kindForFile, mimeForFile } from "../utils/fileAccept.js";
 import { isUsableStep, stepLabel } from "../utils/processingSteps.js";
 import { useMLProcessingStatus } from "./useMLProcessingStatus.js";
+import { mlErrorMessage } from "../utils/errorMessage.js";
 const STORAGE_KEY = "ml-upload-queue";
 const POLL_MS = 4e3;
 let seq = 0;
@@ -240,7 +241,9 @@ function createQueue() {
       } catch (err) {
         if (upload.phase === "canceled") return;
         upload.phase = "failed";
-        upload.error = err?.data?.message ?? err?.message ?? "Upload failed";
+        const cause = err?.cause && typeof err.cause === "object" ? err.cause : null;
+        const fromCause = cause ? mlErrorMessage(cause, "upload") : null;
+        upload.error = fromCause && fromCause !== mlErrorMessage(null, "upload") ? fromCause : mlErrorMessage(err, "upload");
         resolveCreated(null);
       }
     }
@@ -289,7 +292,7 @@ function createQueue() {
         upload.orphaned = false;
         upload.claimError = null;
       } else {
-        upload.claimError = err?.data?.detail ?? err?.data?.message ?? err?.statusMessage ?? err?.message ?? "Could not add the file";
+        upload.claimError = mlErrorMessage(err, "claim");
       }
     } finally {
       claiming.delete(upload.key);

package/dist/runtime/index.d.ts

@@ -28,3 +28,4 @@ export * from './utils/streamUrls.js';
 export * from './utils/webAppDeploys.js';
 export * from './composables/useMLWebAppDeploys.js';
 export * from './composables/useMLMediaMeta.js';
+export * from './utils/errorMessage.js';

package/dist/runtime/index.js

@@ -28,3 +28,4 @@ export * from "./utils/streamUrls.js";
 export * from "./utils/webAppDeploys.js";
 export * from "./composables/useMLWebAppDeploys.js";
 export * from "./composables/useMLMediaMeta.js";
+export * from "./utils/errorMessage.js";

package/dist/runtime/plugins/config.js

@@ -1,4 +1,6 @@
+import { unref } from "vue";
 import { defineNuxtPlugin, useRuntimeConfig } from "#app";
+import { configureMediaErrors } from "../utils/errorMessage.js";
 export default defineNuxtPlugin((nuxtApp) => {
   const config = useRuntimeConfig();
   const publicCfg = config.public?.mediaLibrary;
@@ -20,4 +22,9 @@ export default defineNuxtPlugin((nuxtApp) => {
     headers: publicCfg?.headers ?? {}
   };
   nuxtApp.provide("chunkUploader", cfg);
+  const ml = publicCfg;
+  configureMediaErrors(() => {
+    const i18nLocale = unref(nuxtApp.$i18n?.locale);
+    return typeof i18nLocale === "string" && i18nLocale ? i18nLocale : ml?.locale;
+  }, ml?.errorTexts);
 });

package/dist/runtime/utils/errorMessage.d.ts

@@ -0,0 +1,42 @@
+/**
+ * One reader for every error the widgets show. Backends refuse with
+ * `{ detail, reason }`: `reason` is a stable code (py_client
+ * `UploadRejected`), `detail` English text whose wording may change. The
+ * body arrives at one of two levels:
+ *
+ * - app proxy (a layer's REST proxy rethrows with h3 `createError({ data })`):
+ *   `err.data.data`, under an outer envelope whose `message` is the bare
+ *   status text ("Bad Request");
+ * - module proxy (the module streams the upstream body): `err.data`.
+ *
+ * Shown, first that applies: the text for a known `reason` in the editor's
+ * language, then `detail`, then the inner `message`, `statusMessage`, the
+ * message of an error the module threw itself, and the site's own fallback. Never blank, never the "[POST] url: 400" text.
+ */
+/** Where an error was shown; each has its own last-resort text. */
+export type MediaErrorFallback = 'upload' | 'claim' | 'retryStep' | 'retryTask' | 'triggerStep' | 'loadFiles' | 'loadLibrary' | 'loadAssets' | 'updateVisibility' | 'loadPolicy';
+export interface MediaErrorTexts {
+    /** Text per backend reason code (`too_large`, `context_mismatch`, …). */
+    reasons?: Record<string, string>;
+    /** Text per site, used when the error carries nothing to show. */
+    fallbacks?: Partial<Record<MediaErrorFallback, string>>;
+}
+/** Texts by language ("en", "ar"). */
+export type MediaErrorTextsByLocale = Record<string, MediaErrorTexts>;
+export declare const DEFAULT_ERROR_TEXTS: Record<'en' | 'ar', Required<MediaErrorTexts>>;
+export interface MediaErrorOptions {
+    /** The editor's locale ("ar-SA", "en"); its language part picks the texts. */
+    locale?: string | null;
+    /** The app's texts over the built-in ones (module option `mediaLibrary.errorTexts`). */
+    texts?: MediaErrorTextsByLocale | null;
+}
+/** "ar-SA" → "ar"; a language without texts → "en". */
+export declare function errorLanguage(locale: string | null | undefined, texts?: MediaErrorTextsByLocale | null): string;
+/** The backend's reason code, when it sent a string one. */
+export declare function errorReason(err: unknown): string | undefined;
+/** The message to show for `err` at a site; see the file's comment for the order. */
+export declare function mediaErrorMessage(err: unknown, fallback: MediaErrorFallback, options?: MediaErrorOptions): string;
+/** Where the widgets read the editor's locale and the app's texts (the module plugin calls it). */
+export declare function configureMediaErrors(locale: () => string | null | undefined, texts?: MediaErrorTextsByLocale | null): void;
+/** `mediaErrorMessage` in the app's current locale, with its texts. */
+export declare function mlErrorMessage(err: unknown, fallback: MediaErrorFallback): string;

package/dist/runtime/utils/errorMessage.js

@@ -0,0 +1,112 @@
+export const DEFAULT_ERROR_TEXTS = {
+  en: {
+    reasons: {
+      mime_type: "This file type isn't allowed here.",
+      too_large: "This file is larger than the allowed size.",
+      too_small: "This file is smaller than the minimum size.",
+      kind: "This kind of file can't be uploaded here.",
+      size_required: "The file size is missing. Please try again.",
+      not_finalized: "The upload hasn't finished processing yet. Try again in a moment.",
+      asset_mismatch: "This file doesn't match the upload. Please upload it again.",
+      visibility: "This file's visibility doesn't fit here.",
+      unknown_session: "This upload was not found or has expired. Please upload again.",
+      profile_mismatch: "This file was uploaded for a different field.",
+      context_mismatch: "This file was uploaded for a different item."
+    },
+    fallbacks: {
+      upload: "Upload failed",
+      claim: "Could not add the file",
+      retryStep: "Could not retry this step",
+      retryTask: "Could not retry task",
+      triggerStep: "Failed to trigger step",
+      loadFiles: "Could not load files",
+      loadLibrary: "Could not load the library",
+      loadAssets: "Failed to load assets",
+      updateVisibility: "Failed to update visibility",
+      loadPolicy: "Failed to load policy"
+    }
+  },
+  ar: {
+    reasons: {
+      mime_type: "\u0646\u0648\u0639 \u0647\u0630\u0627 \u0627\u0644\u0645\u0644\u0641 \u063A\u064A\u0631 \u0645\u0633\u0645\u0648\u062D \u0628\u0647 \u0647\u0646\u0627.",
+      too_large: "\u062D\u062C\u0645 \u0647\u0630\u0627 \u0627\u0644\u0645\u0644\u0641 \u0623\u0643\u0628\u0631 \u0645\u0646 \u0627\u0644\u062D\u062F \u0627\u0644\u0645\u0633\u0645\u0648\u062D \u0628\u0647.",
+      too_small: "\u062D\u062C\u0645 \u0647\u0630\u0627 \u0627\u0644\u0645\u0644\u0641 \u0623\u0635\u063A\u0631 \u0645\u0646 \u0627\u0644\u062D\u062F \u0627\u0644\u0623\u062F\u0646\u0649.",
+      kind: "\u0644\u0627 \u064A\u0645\u0643\u0646 \u0631\u0641\u0639 \u0647\u0630\u0627 \u0627\u0644\u0646\u0648\u0639 \u0645\u0646 \u0627\u0644\u0645\u0644\u0641\u0627\u062A \u0647\u0646\u0627.",
+      size_required: "\u062D\u062C\u0645 \u0627\u0644\u0645\u0644\u0641 \u063A\u064A\u0631 \u0645\u0639\u0631\u0648\u0641. \u064A\u0631\u062C\u0649 \u0627\u0644\u0645\u062D\u0627\u0648\u0644\u0629 \u0645\u0631\u0629 \u0623\u062E\u0631\u0649.",
+      not_finalized: "\u0644\u0645 \u062A\u0643\u062A\u0645\u0644 \u0645\u0639\u0627\u0644\u062C\u0629 \u0627\u0644\u0645\u0644\u0641 \u0628\u0639\u062F. \u062D\u0627\u0648\u0644 \u0645\u0631\u0629 \u0623\u062E\u0631\u0649 \u0628\u0639\u062F \u0642\u0644\u064A\u0644.",
+      asset_mismatch: "\u0647\u0630\u0627 \u0627\u0644\u0645\u0644\u0641 \u0644\u0627 \u064A\u0637\u0627\u0628\u0642 \u0639\u0645\u0644\u064A\u0629 \u0627\u0644\u0631\u0641\u0639. \u064A\u0631\u062C\u0649 \u0631\u0641\u0639\u0647 \u0645\u0631\u0629 \u0623\u062E\u0631\u0649.",
+      visibility: "\u0625\u0639\u062F\u0627\u062F\u0627\u062A \u0638\u0647\u0648\u0631 \u0647\u0630\u0627 \u0627\u0644\u0645\u0644\u0641 \u0644\u0627 \u062A\u0646\u0627\u0633\u0628 \u0647\u0630\u0627 \u0627\u0644\u0645\u0643\u0627\u0646.",
+      unknown_session: "\u0644\u0645 \u064A\u062A\u0645 \u0627\u0644\u0639\u062B\u0648\u0631 \u0639\u0644\u0649 \u0639\u0645\u0644\u064A\u0629 \u0627\u0644\u0631\u0641\u0639 \u0623\u0648 \u0627\u0646\u062A\u0647\u062A \u0635\u0644\u0627\u062D\u064A\u062A\u0647\u0627. \u064A\u0631\u062C\u0649 \u0627\u0644\u0631\u0641\u0639 \u0645\u0631\u0629 \u0623\u062E\u0631\u0649.",
+      profile_mismatch: "\u062A\u0645 \u0631\u0641\u0639 \u0647\u0630\u0627 \u0627\u0644\u0645\u0644\u0641 \u0644\u062D\u0642\u0644 \u0622\u062E\u0631.",
+      context_mismatch: "\u062A\u0645 \u0631\u0641\u0639 \u0647\u0630\u0627 \u0627\u0644\u0645\u0644\u0641 \u0644\u0639\u0646\u0635\u0631 \u0622\u062E\u0631."
+    },
+    fallbacks: {
+      upload: "\u0641\u0634\u0644 \u0631\u0641\u0639 \u0627\u0644\u0645\u0644\u0641",
+      claim: "\u062A\u0639\u0630\u0651\u0631\u062A \u0625\u0636\u0627\u0641\u0629 \u0627\u0644\u0645\u0644\u0641",
+      retryStep: "\u062A\u0639\u0630\u0651\u0631\u062A \u0625\u0639\u0627\u062F\u0629 \u0645\u062D\u0627\u0648\u0644\u0629 \u0647\u0630\u0647 \u0627\u0644\u062E\u0637\u0648\u0629",
+      retryTask: "\u062A\u0639\u0630\u0651\u0631\u062A \u0625\u0639\u0627\u062F\u0629 \u0645\u062D\u0627\u0648\u0644\u0629 \u0627\u0644\u0645\u0647\u0645\u0629",
+      triggerStep: "\u062A\u0639\u0630\u0651\u0631 \u062A\u0634\u063A\u064A\u0644 \u0627\u0644\u062E\u0637\u0648\u0629",
+      loadFiles: "\u062A\u0639\u0630\u0651\u0631 \u062A\u062D\u0645\u064A\u0644 \u0627\u0644\u0645\u0644\u0641\u0627\u062A",
+      loadLibrary: "\u062A\u0639\u0630\u0651\u0631 \u062A\u062D\u0645\u064A\u0644 \u0627\u0644\u0645\u0643\u062A\u0628\u0629",
+      loadAssets: "\u062A\u0639\u0630\u0651\u0631 \u062A\u062D\u0645\u064A\u0644 \u0627\u0644\u0645\u0644\u0641\u0627\u062A",
+      updateVisibility: "\u062A\u0639\u0630\u0651\u0631 \u062A\u062D\u062F\u064A\u062B \u0625\u0639\u062F\u0627\u062F\u0627\u062A \u0627\u0644\u0638\u0647\u0648\u0631",
+      loadPolicy: "\u062A\u0639\u0630\u0651\u0631 \u062A\u062D\u0645\u064A\u0644 \u0627\u0644\u0633\u064A\u0627\u0633\u0629"
+    }
+  }
+};
+const nonEmpty = (s) => typeof s === "string" && s ? s : void 0;
+function bodies(err) {
+  return [.../* @__PURE__ */ new Set([err, err?.data, err?.data?.data, err?.response?._data])].filter((b) => !!b && typeof b === "object");
+}
+function first(list, key) {
+  return list.map((b) => b[key]).find((v) => v != null);
+}
+function detailText(detail) {
+  if (typeof detail === "string") return nonEmpty(detail);
+  if (Array.isArray(detail)) return detail.map((d) => d && typeof d === "object" ? nonEmpty(d.msg) : void 0).find(Boolean);
+  if (detail && typeof detail === "object") return nonEmpty(detail.message);
+  return void 0;
+}
+function ownMessage(err) {
+  if (!(err instanceof Error) || err.name === "FetchError") return void 0;
+  const msg = nonEmpty(err.message);
+  return msg && !/^\[[A-Z]+\]\s/.test(msg) ? msg : void 0;
+}
+export function errorLanguage(locale, texts) {
+  const lang = (locale ?? "").toLowerCase().split(/[-_]/)[0] ?? "";
+  return lang && (lang in DEFAULT_ERROR_TEXTS || texts && lang in texts) ? lang : "en";
+}
+function textFor(kind, key, lang, texts) {
+  const pick = (l) => nonEmpty(texts?.[l]?.[kind]?.[key]) ?? nonEmpty(DEFAULT_ERROR_TEXTS[l]?.[kind]?.[key]);
+  return pick(lang) ?? (lang !== "en" ? pick("en") : void 0);
+}
+export function errorReason(err) {
+  return nonEmpty(first(bodies(err), "reason"));
+}
+export function mediaErrorMessage(err, fallback, options = {}) {
+  const lang = errorLanguage(options.locale, options.texts);
+  const list = bodies(err);
+  const reason = nonEmpty(first(list, "reason"));
+  const byReason = reason ? textFor("reasons", reason, lang, options.texts) : void 0;
+  if (byReason) return byReason;
+  const detail = detailText(first(list, "detail"));
+  if (detail) return detail;
+  const inner = list.filter((b) => b !== err).reverse().map((b) => nonEmpty(b.message)).find(Boolean);
+  const e = err;
+  return inner ?? nonEmpty(e?.statusMessage) ?? nonEmpty(e?.data?.statusMessage) ?? ownMessage(err) ?? textFor("fallbacks", fallback, lang, options.texts) ?? fallback;
+}
+let current = {
+  locale: () => null,
+  texts: null
+};
+export function configureMediaErrors(locale, texts) {
+  current = { locale, texts: texts ?? null };
+}
+export function mlErrorMessage(err, fallback) {
+  let locale = null;
+  try {
+    locale = current.locale();
+  } catch {
+  }
+  return mediaErrorMessage(err, fallback, { locale, texts: current.texts });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-media-library",
-  "version": "0.0.59",
+  "version": "0.0.60",
   "description": "Nuxt module for media library management — chunked uploads, asset previews, and resource policies",
   "repository": {
     "type": "git",