@adonis-agora/media 0.19.0 → 0.21.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonis-agora/media",
-  "version": "0.19.0",
-  "description": "Media-library for AdonisJS — owner collections (MIME whitelist, single-file replace, ordering), image conversions (eager/lazy), pluggable content transformers (HLS video via mediabunny, metadata probe), and column attachments, all on top of @adonisjs/drive. Pluggable MediaStore (in-memory + Lucid) and ImageProcessor (sharp). Part of the Agora ecosystem.",
+  "version": "0.21.0",
+  "description": "Media-library for AdonisJS — owner collections (MIME whitelist, single-file replace, ordering), image conversions (eager/lazy), pluggable content transformers (HLS video via mediabunny, metadata probe, image blur-up placeholder), and column attachments, all on top of @adonisjs/drive. Pluggable MediaStore (in-memory + Lucid) and ImageProcessor (sharp). Part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -148,23 +148,23 @@
   "devDependencies": {
     "@adonis-agora/media-dashboard": "9.0.0",
     "@adonis-agora/media-react": "0.6.0",
-    "@adonisjs/assembler": "8.5.2",
+    "@adonisjs/assembler": "8.6.0",
     "@adonisjs/core": "7.6.0",
     "@adonisjs/drive": "4.0.0",
     "@adonisjs/lucid": "22.4.2",
-    "@aws-sdk/client-s3": "3.1151.0",
+    "@aws-sdk/client-s3": "3.1153.0",
     "@smithy/util-stream": "4.8.2",
-    "@tanstack/intent": "0.5.5",
+    "@tanstack/intent": "0.5.6",
     "@types/better-sqlite3": "9.6.0",
     "@types/node": "26.6.5",
     "aws-sdk-client-mock": "4.1.0",
     "better-sqlite3": "13.0.3",
     "luxon": "3.7.2",
-    "mediabunny": "1.55.7",
+    "mediabunny": "1.61.6",
     "sharp": "0.35.5",
     "tempura": "0.4.1",
     "typescript": "7.0.2",
-    "vitest": "5.0.4"
+    "vitest": "5.0.5"
   },
   "engines": {
     "node": ">=24"

package/skills/media-attachments-single-file/SKILL.md

@@ -125,7 +125,7 @@ give me a URL", importable unconditionally with feature detection:
 import { isSingleFileStoreAvailable, removeSingleFile, storeSingleFile } from '@adonis-agora/media/single-file'
 
 if (await isSingleFileStoreAvailable()) {
-  const { url, thumbUrl } = await storeSingleFile({
+  const { url, thumbUrl, id, placeholder } = await storeSingleFile({
     ownerType: 'User',
     ownerId: String(user.id),
     collection: 'avatar',
@@ -134,6 +134,7 @@ if (await isSingleFileStoreAvailable()) {
     contents: upload.bytes, // a Buffer
   })
   // thumbUrl is null — not an error — when the 'thumb' conversion isn't configured
+  // placeholder is `{ dataUrl, width, height, color }` or null when no placeholder transformer ran
 }
 
 // tests or multi-manager apps pass the manager explicitly:

package/skills/media-library-collections/SKILL.md

@@ -5,7 +5,7 @@ description: >-
   attachExisting / for(ownerType, ownerId), the MediaCollectionConfig policy layer
   (acceptsMimeTypes exact-match whitelist plus magic-byte signature verification,
   single:true atomic replace, append-only ordering, per-collection disk), eager vs lazy
-  ConversionPresets (width/height/fit/format/quality, webp default), ensureConversion,
+  ConversionPresets (width/height/fit/format/quality/blur, webp default), ensureConversion,
   url/signedUrl resolution, delete semantics, deterministic id retries, customProperties,
   and the MediaRecord.conversions map shared with transformers. Use when uploading files
   to entities, defining collections, generating thumbnails, or fixing
@@ -102,7 +102,8 @@ Source: `docs/collections-and-conversions.mdx`.
 
 ### Pattern 2 — eager vs lazy conversions
 
-`ConversionPreset` maps straight onto sharp. `eager: true` generates synchronously on
+`ConversionPreset` maps straight onto sharp (`blur` is gaussian blur sigma applied after the
+resize; images are auto-oriented from EXIF before resizing). `eager: true` generates synchronously on
 `attach`; the default is lazy — generated on the **first** `url(id, name)` and then cached on
 the record, so every later call is a pure lookup.
 
@@ -292,8 +293,10 @@ defineConfig({
 ```
 
 Mechanism: presets decode the original as an image through sharp; requesting one on a video
-or PDF fails inside sharp. Transformers are the seam for everything beyond images and
-persist into the same `record.conversions` namespace (name collisions throw
+or PDF fails inside sharp. Transformers are the seam for everything beyond resized image files
+(video packages, metadata probes, image placeholders — `transformers.placeholder()` is
+metadata-only and skips non-`image/*` and SVG records) and persist into the same
+`record.conversions` namespace (name collisions throw
 `TransformerConflictError` at boot).
 Source: `docs/collections-and-conversions.mdx` (warn callout), `docs/transformers.mdx`.