@appweaver/cli 1.0.15 → 1.0.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appweaver/cli",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "Appweaver - the backend framework for AI-first development (@cli)",
   "author": "Luka Matosevic",
   "license": "MIT",

package/skill/SKILL.md

@@ -212,7 +212,8 @@ export default createModel({
   files: {
     photo: {
       mimeType: 'image/*',
-      maxSize: '2 MB'
+      maxSize: '2 MB',
+      image: { quality: 80, maxWidth: 1200 }
     }
   },
   create: {
@@ -333,7 +334,8 @@ export default createAuthModel({
   files: {
     avatar: {
       mimeType: 'image/(png|jpeg|gif)',
-      maxSize: '2 MB'
+      maxSize: '2 MB',
+      image: { quality: 80, maxHeight: 800, fit: 'inside' }
     }
   }
 });

package/skill/references/resources.md

@@ -434,7 +434,13 @@ const config = {
     photo: {
       mimeType: 'image/*',
       namePattern: 'photos/{userId}-{name}-{hash}.{extension}',
-      maxSize: '2 MB'
+      maxSize: '2 MB',
+      image: {
+        quality: 80,
+        maxWidth: 1200,
+        maxHeight: 1200,
+        fit: 'inside'
+      }
     },
     documents: {
       mimeType: 'application/pdf',
@@ -445,14 +451,16 @@ const config = {
 };
 ```
 
-| Property      | Type               | Description                                                             |
-|---------------|--------------------|-------------------------------------------------------------------------|
-| `mimeType`    | string \| RegExp   | Allowed MIME types (glob patterns like `'image/*'` supported).          |
-| `namePattern` | string \| function | File naming pattern or function (available variables are listed below). |
-| `array`       | boolean            | Allow multiple files.                                                   |
-| `maxSize`     | number \| string   | Maximum file size (e.g. `'2 MB'`, `5242880`).                           |
-| `maxCount`    | number             | Maximum number of files (for array fields).                             |
-| `output`      | RelationOutput     | When to include file info in output.                                    |
+| Property            | Type                   | Description                                                                                                 |
+|---------------------|------------------------|-------------------------------------------------------------------------------------------------------------|
+| `mimeType`          | string \| RegExp       | Allowed MIME types (glob patterns like `'image/*'` supported).                                              |
+| `namePattern`       | string \| function     | File naming pattern or function (available variables are listed below).                                     |
+| `array`             | boolean                | Allow multiple files.                                                                                       |
+| `maxSize`           | number \| string       | Maximum file size (e.g. `'2 MB'`, `5242880`).                                                               |
+| `maxCount`          | number                 | Maximum number of files (for array fields).                                                                 |
+| `output`            | RelationOutput         | When to include file info in output.                                                                        |
+| `onResourceDeleted` | `'delete'` \| `'keep'` | When the owning resource is deleted. `'delete'` (default) removes files from storage, `'keep'` leaves them. |
+| `image`             | ImageConfig            | Image compression and resize settings. Only applies to image MIME types (excluding GIF).                    |
 
 #### Available namePattern variables
 
@@ -482,6 +490,49 @@ Default pattern is: `{name}-{hash}.{extension}`.
 | `uuid`          | string | Generated random UUID.                      |
 | `hash`          | string | Generated random hash (32 bytes).           |
 
+#### Image compression
+
+Configure automatic image compression and resizing by adding the `image` property to a file field. Processing only
+applies to supported image MIME types: `image/jpeg`, `image/png`, `image/webp`, `image/avif`, `image/tiff`. GIF files
+are passed through unchanged.
+
+| Property    | Type     | Description                                                                                                    |
+|-------------|----------|----------------------------------------------------------------------------------------------------------------|
+| `quality`   | number   | Compression quality (1-100). Applies to JPEG, PNG, WebP, AVIF, and TIFF.                                       |
+| `width`     | number   | Exact resize width in pixels.                                                                                  |
+| `height`    | number   | Exact resize height in pixels.                                                                                 |
+| `maxWidth`  | number   | Maximum width. Only downscales if the image exceeds this dimension.                                            |
+| `maxHeight` | number   | Maximum height. Only downscales if the image exceeds this dimension.                                           |
+| `fit`       | ImageFit | How the image fits the target dimensions: `'inside'` (default), `'contain'`, `'cover'`, `'fill'`, `'outside'`. |
+
+`width`/`height` take precedence over `maxWidth`/`maxHeight`. When using `maxWidth`/`maxHeight`, images smaller than
+the specified dimensions are not enlarged.
+
+```ts
+// Compress and limit dimensions
+const config = {
+  files: {
+    avatar: {
+      mimeType: 'image/*',
+      maxSize: '5 MB',
+      image: { quality: 80, maxWidth: 800, maxHeight: 800 }
+    }
+  }
+};
+```
+
+```ts
+// Exact resize for thumbnails
+const config = {
+  files: {
+    thumbnail: {
+      mimeType: 'image/jpeg',
+      image: { quality: 70, width: 200, height: 200, fit: 'inside' }
+    }
+  }
+}
+```
+
 ### Virtual fields
 
 Virtual fields are computed values not stored in the database. They can appear in input DTOs (to receive data) and/or

package/skill/references/storage.md

@@ -249,3 +249,32 @@ await fileService.deleteFile(
   postClient // ResourceClient
 );
 ```
+
+### Deleting all files on resource deletion
+
+When a resource is deleted, files belonging to file fields configured with `onResourceDeleted: 'delete'` can be
+automatically cleaned up. This is handled by `deleteResourceFiles()`, which is called automatically by the framework's
+delete route handler.
+
+To enable automatic file cleanup, set `onResourceDeleted: 'delete'` on the file field in your model config:
+
+```ts
+const config = {
+  files: {
+    coverImage: {
+      mimeType: 'image/*',
+      onResourceDeleted: 'delete' // default: files removed when resource is deleted
+    },
+    documents: {
+      array: true,
+      onResourceDeleted: 'keep' // opt out: files are kept
+    }
+  }
+};
+```
+
+You can also call `deleteResourceFiles` manually if needed:
+
+```ts
+await fileService.deleteResourceFiles('Post', postId);
+```