@jrmc/adonis-attachment 2.3.2 → 2.4.0

package/README.md

@@ -8,10 +8,10 @@ Project sample : [adonis-starter-kit](https://github.com/batosai/adonis-starter-
 
 [View documentation](https://adonis-attachment.jrmc.dev/)
 
-[Discord](https://discord.gg/89eMn2vB)
-
 [ChangeLog](https://adonis-attachment.jrmc.dev/changelog.html)
 
+[Discord](https://discord.gg/89eMn2vB)
+
 ⚠️ [Breaking change](https://adonis-attachment.jrmc.dev/changelog.html) version 2, include [@adonisjs/drive](https://docs.adonisjs.com/guides/digging-deeper/drive)
 
 ## Roadmap
@@ -23,9 +23,9 @@ Project sample : [adonis-starter-kit](https://github.com/batosai/adonis-starter-
   - [x] documents thumbnail
   - [x] videos thumbnail
 - [ ] command regenerate
-- [ ] command make:convert
+- [x] command make:convert
 - [x] adonis-drive/flydrive
-- [ ] jobs queue
+- [x] jobs queue
 - [x] serialize
 
 
@@ -46,11 +46,11 @@ Simple upload file
 import { BaseModel } from '@adonisjs/lucid/orm'
 import { compose } from '@adonisjs/core/helpers'
 import { attachment, Attachmentable } from '@jrmc/adonis-attachment'
-import type { Attachment } from '@jrmc/adonis-attachment/types/attachment' // [!code highlight]
+import type { Attachment } from '@jrmc/adonis-attachment/types/attachment'
 
-class User extends compose(BaseModel, Attachmentable) { // [!code highlight]
-  @attachment() // [!code highlight]
-  declare avatar: Attachment // [!code highlight]
+class User extends compose(BaseModel, Attachmentable) {
+  @attachment()
+  declare avatar: Attachment
 }
 ```
 
@@ -58,14 +58,14 @@ class User extends compose(BaseModel, Attachmentable) { // [!code highlight]
 
 ```ts
 // app/controllers/users_controller.ts
-import { attachmentManager } from '@jrmc/adonis-attachment' // [!code focus]
+import { attachmentManager } from '@jrmc/adonis-attachment'
 
 class UsersController {
   public store({ request }: HttpContext) {
-    const avatar = request.file('avatar')! // [!code focus]
+    const avatar = request.file('avatar')!
     const user = new User()
 
-    user.avatar = await attachmentManager.createFromFile(avatar) // [!code focus]
+    user.avatar = await attachmentManager.createFromFile(avatar)
     await user.save()
   }
 }

package/build/commands/commands.json

@@ -0,0 +1 @@
+{"commands":[{"commandName":"make:converter","description":"Create a new media converter class","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"The name of the converter","type":"string"}],"options":{},"filePath":"make/converter.js"}],"version":1}

package/build/commands/main.d.ts

@@ -0,0 +1,4 @@
+import { CommandMetaData, Command } from '@adonisjs/ace/types';
+
+export function getMetaData(): Promise<CommandMetaData[]>
+export function getCommand(metaData: CommandMetaData): Promise<Command | null>

package/build/commands/main.js

@@ -0,0 +1,36 @@
+import { readFile } from 'node:fs/promises'
+
+/**
+ * In-memory cache of commands after they have been loaded
+ */
+let commandsMetaData
+
+/**
+ * Reads the commands from the "./commands.json" file. Since, the commands.json
+ * file is generated automatically, we do not have to validate its contents
+ */
+export async function getMetaData() {
+  if (commandsMetaData) {
+    return commandsMetaData
+  }
+
+  const commandsIndex = await readFile(new URL('./commands.json', import.meta.url), 'utf-8')
+  commandsMetaData = JSON.parse(commandsIndex).commands
+
+  return commandsMetaData
+}
+
+/**
+ * Imports the command by lookingup its path from the commands
+ * metadata
+ */
+export async function getCommand(metaData) {
+  const commands = await getMetaData()
+  const command = commands.find(({ commandName }) => metaData.commandName === commandName)
+  if (!command) {
+    return null
+  }
+
+  const { default: commandConstructor } = await import(new URL(command.filePath, import.meta.url).href)
+  return commandConstructor
+}

package/build/commands/make/converter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { BaseCommand } from '@adonisjs/core/ace';
+/**
+ * The make controller command to create an HTTP controller
+ */
+export default class MakeConverter extends BaseCommand {
+    static commandName: string;
+    static description: string;
+    name: string;
+    protected stubPath: string;
+    run(): Promise<void>;
+}

package/build/commands/make/converter.js

@@ -0,0 +1,31 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { stubsRoot } from '../../stubs/main.js';
+import { args, BaseCommand } from '@adonisjs/core/ace';
+/**
+ * The make controller command to create an HTTP controller
+ */
+export default class MakeConverter extends BaseCommand {
+    static commandName = 'make:converter';
+    static description = 'Create a new media converter class';
+    stubPath = 'make/converter/main.stub';
+    async run() {
+        const codemods = await this.createCodemods();
+        await codemods.makeUsingStub(stubsRoot, this.stubPath, {
+            name: this.name,
+        });
+    }
+}
+__decorate([
+    args.string({ description: 'The name of the converter' })
+], MakeConverter.prototype, "name", void 0);

package/build/configure.js

@@ -16,5 +16,6 @@ export async function configure(command) {
      */
     await codemods.updateRcFile((rcFile) => {
         rcFile.addProvider('@jrmc/adonis-attachment/attachment_provider');
+        rcFile.addCommand('@jrmc/adonis-attachment/commands');
     });
 }

package/build/src/attachment_manager.d.ts

@@ -8,10 +8,12 @@ import type { DriveService, SignedURLOptions } from '@adonisjs/drive/types';
 import type { MultipartFile } from '@adonisjs/core/bodyparser';
 import type { AttachmentBase, Attachment as AttachmentType } from './types/attachment.js';
 import type { ResolvedAttachmentConfig } from './types/config.js';
+import { DeferQueue } from '@poppinss/defer';
 import { Attachment } from './attachments/attachment.js';
 import Converter from './converters/converter.js';
 export declare class AttachmentManager {
     #private;
+    queue: DeferQueue;
     constructor(config: ResolvedAttachmentConfig, drive: DriveService);
     getConfig(): ResolvedAttachmentConfig;
     createFromDbResponse(response: any): Attachment | null;

package/build/src/attachment_manager.js

@@ -4,17 +4,21 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
+import { DeferQueue } from '@poppinss/defer';
 import * as errors from './errors.js';
 import { Attachment } from './attachments/attachment.js';
 import { createAttachmentAttributes, isBase64 } from './utils/helpers.js';
 import { exif } from './adapters/exif.js';
 const REQUIRED_ATTRIBUTES = ['name', 'size', 'extname', 'mimeType'];
 export class AttachmentManager {
+    queue;
     #config;
     #drive;
     constructor(config, drive) {
         this.#drive = drive;
         this.#config = config;
+        const concurrency = this.#config.queue?.concurrency || 1;
+        this.queue = new DeferQueue({ concurrency });
     }
     getConfig() {
         return this.#config;

package/build/src/converter_manager.d.ts

@@ -1,6 +1,6 @@
 import type { ConverterInitializeAttributes } from './types/converter.js';
 export declare class ConverterManager {
     #private;
-    constructor({ record, attributeName, key, converter }: ConverterInitializeAttributes);
+    constructor({ record, attributeName }: ConverterInitializeAttributes);
     save(): Promise<void>;
 }

package/build/src/converter_manager.js

@@ -1,35 +1,44 @@
 import db from '@adonisjs/lucid/services/db';
 import attachmentManager from '../services/main.js';
+import * as errors from './errors.js';
+import { getOptions } from './utils/helpers.js';
 export class ConverterManager {
-    #key;
-    #input;
     #record;
     #attributeName;
-    #converter;
-    constructor({ record, attributeName, key, converter }) {
-        this.#key = key;
+    constructor({ record, attributeName }) {
         this.#record = record;
         this.#attributeName = attributeName;
-        this.#input = record.$attributes[attributeName].input;
-        this.#converter = converter;
     }
     async save() {
-        const record = this.#record;
-        const attribute = this.#attributeName;
-        await record.refresh();
-        const output = await this.#converter.handle({
-            input: this.#input,
-            options: this.#converter.options,
-        });
-        const Model = record.constructor;
-        const id = record.$attributes['id'];
-        const attachment = record.$attributes[attribute];
+        const options = getOptions(this.#record, this.#attributeName);
+        const attachment = this.#record.$attributes[this.#attributeName];
+        const input = attachment.input;
+        const Model = this.#record.constructor;
+        const id = this.#record.$attributes['id'];
         const data = {};
-        const variant = await attachment.createVariant(this.#key, output);
-        await attachmentManager.save(variant);
-        data[attribute] = JSON.stringify(attachment.toObject());
+        if (options.variants) {
+            for (const option of options.variants) {
+                const converter = (await attachmentManager.getConverter(option));
+                if (attachment && converter) {
+                    const output = await converter.handle({
+                        input,
+                        options: converter.options,
+                    });
+                    if (output === undefined) {
+                        throw new errors.E_CANNOT_PATH_BY_CONVERTER();
+                    }
+                    const variant = await attachment.createVariant(option, output);
+                    await attachmentManager.save(variant);
+                }
+            }
+        }
+        data[this.#attributeName] = JSON.stringify(attachment.toObject());
         const trx = await db.transaction();
-        trx.after('rollback', () => attachmentManager.delete(variant));
+        trx.after('rollback', () => {
+            for (const variant of attachment.variants) {
+                attachmentManager.delete(variant);
+            }
+        });
         try {
             await trx.query().from(Model.table).where('id', id).update(data);
             return await trx.commit();

package/build/src/converters/autodetect_converter.d.ts

@@ -7,5 +7,5 @@
 import type { ConverterAttributes } from '../types/converter.js';
 import Converter from './converter.js';
 export default class AutodetectConverter extends Converter {
-    handle({ input, options }: ConverterAttributes): Promise<any>;
+    handle({ input, options }: ConverterAttributes): Promise<false | import("../types/input.js").Input | undefined>;
 }

package/build/src/converters/document_thumbnail_converter.d.ts

@@ -8,6 +8,6 @@ import type { ConverterAttributes } from '../types/converter.js';
 import type { Input } from '../types/input.js';
 import Converter from './converter.js';
 export default class DocumentThumbnailConverter extends Converter {
-    handle({ input, options }: ConverterAttributes): Promise<any>;
+    handle({ input, options }: ConverterAttributes): Promise<Input>;
     documentToImage(LibreOfficeFileConverter: any, input: Input): Promise<any>;
 }

package/build/src/converters/document_thumbnail_converter.js

@@ -4,28 +4,22 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
-import logger from '@adonisjs/core/services/logger';
 import Converter from './converter.js';
 import ImageConverter from './image_converter.js';
 import { use } from '../utils/helpers.js';
 export default class DocumentThumbnailConverter extends Converter {
     async handle({ input, options }) {
-        try {
-            const lib = await use('libreoffice-file-converter');
-            const LibreOfficeFileConverter = lib.LibreOfficeFileConverter;
-            const outputBuffer = await this.documentToImage(LibreOfficeFileConverter, input);
-            if (options && outputBuffer) {
-                const converter = new ImageConverter();
-                return await converter.handle({
-                    input: outputBuffer,
-                    options,
-                });
-            }
-            return outputBuffer;
-        }
-        catch (err) {
-            logger.error({ err });
+        const lib = await use('libreoffice-file-converter');
+        const LibreOfficeFileConverter = lib.LibreOfficeFileConverter;
+        const outputBuffer = await this.documentToImage(LibreOfficeFileConverter, input);
+        if (options && outputBuffer) {
+            const converter = new ImageConverter();
+            return await converter.handle({
+                input: outputBuffer,
+                options,
+            });
         }
+        return outputBuffer;
     }
     async documentToImage(LibreOfficeFileConverter, input) {
         let binaryPaths = undefined;

package/build/src/converters/image_converter.d.ts

@@ -5,7 +5,8 @@
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
 import type { ConverterAttributes } from '../types/converter.js';
+import type { Input } from '../types/input.js';
 import Converter from './converter.js';
 export default class ImageConverter extends Converter {
-    handle({ input, options }: ConverterAttributes): Promise<any>;
+    handle({ input, options }: ConverterAttributes): Promise<Input>;
 }

package/build/src/converters/image_converter.js

@@ -4,29 +4,23 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
-import logger from '@adonisjs/core/services/logger';
 import Converter from './converter.js';
 import { use } from '../utils/helpers.js';
 export default class ImageConverter extends Converter {
     async handle({ input, options }) {
-        try {
-            const sharp = await use('sharp');
-            const resize = options?.resize || {};
-            let format = options?.format || 'webp';
-            let formatoptions = {};
-            if (typeof format !== 'string') {
-                formatoptions = format?.options;
-                format = format.format;
-            }
-            const buffer = await sharp(input)
-                .withMetadata()
-                .resize(resize)
-                .toFormat(format, formatoptions)
-                .toBuffer();
-            return buffer;
-        }
-        catch (err) {
-            logger.error({ err });
+        const sharp = await use('sharp');
+        const resize = options?.resize || {};
+        let format = options?.format || 'webp';
+        let formatoptions = {};
+        if (typeof format !== 'string') {
+            formatoptions = format?.options;
+            format = format.format;
         }
+        const buffer = await sharp(input)
+            .withMetadata()
+            .resize(resize)
+            .toFormat(format, formatoptions)
+            .toBuffer();
+        return buffer;
     }
 }

package/build/src/converters/pdf_thumbnail_converter.d.ts

@@ -8,6 +8,6 @@ import type { ConverterAttributes } from '../types/converter.js';
 import type { Input } from '../types/input.js';
 import Converter from './converter.js';
 export default class PdfThumbnailConverter extends Converter {
-    handle({ input, options }: ConverterAttributes): Promise<any>;
+    handle({ input, options }: ConverterAttributes): Promise<Input>;
     pdfToImage(Poppler: any, input: Input): Promise<string>;
 }

package/build/src/converters/pdf_thumbnail_converter.js

@@ -7,28 +7,22 @@
 import os from 'node:os';
 import path from 'node:path';
 import { cuid } from '@adonisjs/core/helpers';
-import logger from '@adonisjs/core/services/logger';
 import Converter from './converter.js';
 import ImageConverter from './image_converter.js';
 import { use } from '../utils/helpers.js';
 export default class PdfThumbnailConverter extends Converter {
     async handle({ input, options }) {
-        try {
-            const nodePoppler = await use('node-poppler');
-            const Poppler = nodePoppler.Poppler;
-            const filePath = await this.pdfToImage(Poppler, input);
-            if (options && filePath) {
-                const converter = new ImageConverter();
-                return await converter.handle({
-                    input: filePath,
-                    options,
-                });
-            }
-            return filePath;
-        }
-        catch (err) {
-            logger.error({ err });
+        const nodePoppler = await use('node-poppler');
+        const Poppler = nodePoppler.Poppler;
+        const filePath = await this.pdfToImage(Poppler, input);
+        if (options && filePath) {
+            const converter = new ImageConverter();
+            return await converter.handle({
+                input: filePath,
+                options,
+            });
         }
+        return filePath;
     }
     async pdfToImage(Poppler, input) {
         let binPath = null;

package/build/src/converters/video_thumbnail_converter.d.ts

@@ -8,6 +8,6 @@ import type { ConverterAttributes } from '../types/converter.js';
 import type { Input } from '../types/input.js';
 import Converter from './converter.js';
 export default class VideoThumbnailConvert extends Converter {
-    handle({ input, options }: ConverterAttributes): Promise<any>;
+    handle({ input, options }: ConverterAttributes): Promise<false | Input>;
     videoToImage(ffmpeg: Function, input: Input): Promise<string | false>;
 }

package/build/src/converters/video_thumbnail_converter.js

@@ -7,28 +7,22 @@
 import os from 'node:os';
 import path from 'node:path';
 import { cuid } from '@adonisjs/core/helpers';
-import logger from '@adonisjs/core/services/logger';
 import Converter from './converter.js';
 import ImageConverter from './image_converter.js';
 import { bufferToTempFile, use } from '../utils/helpers.js';
 export default class VideoThumbnailConvert extends Converter {
     async handle({ input, options }) {
-        try {
-            const ffmpeg = await use('fluent-ffmpeg');
-            const filePath = await this.videoToImage(ffmpeg, input);
-            if (options && filePath) {
-                const converter = new ImageConverter();
-                return await converter.handle({
-                    input: filePath,
-                    options,
-                });
-            }
-            else {
-                return filePath;
-            }
+        const ffmpeg = await use('fluent-ffmpeg');
+        const filePath = await this.videoToImage(ffmpeg, input);
+        if (options && filePath) {
+            const converter = new ImageConverter();
+            return await converter.handle({
+                input: filePath,
+                options,
+            });
         }
-        catch (err) {
-            logger.error({ err });
+        else {
+            return filePath;
         }
     }
     async videoToImage(ffmpeg, input) {
@@ -36,7 +30,7 @@ export default class VideoThumbnailConvert extends Converter {
         if (Buffer.isBuffer(input)) {
             file = await bufferToTempFile(input);
         }
-        return new Promise((resolve) => {
+        return new Promise((resolve, reject) => {
             const folder = os.tmpdir();
             const filename = `${cuid()}.png`;
             const ff = ffmpeg(file);
@@ -49,8 +43,12 @@ export default class VideoThumbnailConvert extends Converter {
                 count: 1,
                 filename,
                 folder,
-            }).on('end', () => {
+            })
+                .on('end', () => {
                 resolve(path.join(folder, filename));
+            })
+                .on('error', (err) => {
+                reject(err);
             });
         });
     }

package/build/src/errors.d.ts

@@ -44,6 +44,14 @@ export declare const E_MISSING_PACKAGE: new (args: [key: string], options?: Erro
  * Unable to create Attachment Object
  */
 export declare const E_CANNOT_CREATE_ATTACHMENT: new (args: [key: string], options?: ErrorOptions) => import("@adonisjs/core/exceptions").Exception;
+/**
+ * Unable to create variant
+ */
+export declare const E_CANNOT_CREATE_VARIANT: new (args: [key: string], options?: ErrorOptions) => import("@adonisjs/core/exceptions").Exception;
+/**
+ * Missing path
+ */
+export declare const E_CANNOT_PATH_BY_CONVERTER: new (args?: any, options?: ErrorOptions) => import("@adonisjs/core/exceptions").Exception;
 /**
  * Is not a Buffer
  */

package/build/src/errors.js

@@ -42,6 +42,14 @@ export const E_MISSING_PACKAGE = createError('Missing package, please install "%
  * Unable to create Attachment Object
  */
 export const E_CANNOT_CREATE_ATTACHMENT = createError('Cannot create attachment from database response. Missing attribute "%s"', 'E_CANNOT_CREATE_ATTACHMENT');
+/**
+ * Unable to create variant
+ */
+export const E_CANNOT_CREATE_VARIANT = createError('Cannot create variant. "%s"', 'E_CANNOT_CREATE_VARIANT');
+/**
+ * Missing path
+ */
+export const E_CANNOT_PATH_BY_CONVERTER = createError('Path not found', 'E_CANNOT_PATH_BY_CONVERTER');
 /**
  * Is not a Buffer
  */

package/build/src/types/config.d.ts

@@ -13,6 +13,9 @@ type ConverterConfig = {
     converter: () => Promise<ImportConverter>;
     options?: ConverterOptions;
 };
+type Queue = {
+    concurrency: number;
+};
 export type BinPaths = {
     ffmpegPath?: string;
     ffprobePath?: string;
@@ -25,6 +28,7 @@ export type AttachmentConfig = {
     rename?: boolean;
     preComputeUrl?: boolean;
     converters?: ConverterConfig[];
+    queue?: Queue;
 };
 export type ResolvedConverter = {
     key: string;
@@ -36,5 +40,6 @@ export type ResolvedAttachmentConfig = {
     rename?: boolean;
     preComputeUrl?: boolean;
     converters?: ResolvedConverter[];
+    queue?: Queue;
 };
 export {};

package/build/src/types/converter.d.ts

@@ -15,8 +15,6 @@ export type Converter = {
 export type ConverterInitializeAttributes = {
     record: ModelWithAttachment;
     attributeName: string;
-    key: string;
-    converter: Converter;
 };
 export type ConverterAttributes = {
     input: Input;

package/build/src/utils/actions.js

@@ -7,6 +7,7 @@
 import attachmentManager from '../../services/main.js';
 import { getOptions } from './helpers.js';
 import { ConverterManager } from '../converter_manager.js';
+import { E_CANNOT_CREATE_VARIANT } from '../errors.js';
 /**
  * During commit, we should cleanup the old detached files
  */
@@ -45,7 +46,6 @@ export async function persistAttachment(modelInstance, attributeName) {
      * If there is a new file and its local then we must save this
      * file.
      */
-    // if (newFile && newFile.isLocal) {
     if (newFile) {
         newFile.setOptions(options);
         modelInstance.$attachments.attached.push(newFile);
@@ -72,20 +72,19 @@ export async function preComputeUrl(modelInstance, attributeName) {
  * Launch converter by variant option
  */
 export async function generateVariants(modelInstance, attributeName) {
-    const options = getOptions(modelInstance, attributeName);
-    if (options.variants) {
-        options.variants.forEach(async (option) => {
-            const attachment = modelInstance.$attributes[attributeName];
-            const converter = await attachmentManager.getConverter(option);
-            if (attachment && converter) {
+    attachmentManager.queue.push({
+        name: `${modelInstance.constructor.name}-${attributeName}`,
+        async run() {
+            try {
                 const converterManager = new ConverterManager({
                     record: modelInstance,
                     attributeName,
-                    key: option,
-                    converter,
                 });
-                converterManager.save();
+                await converterManager.save();
             }
-        });
-    }
+            catch (err) {
+                throw new E_CANNOT_CREATE_VARIANT([err.message]);
+            }
+        },
+    });
 }

package/build/stubs/make/converter/main.stub

@@ -0,0 +1,20 @@
+{{#var entity = generators.createEntity(name)}}
+{{#var modelConverterName = string(entity.name).removeSuffix('converter').pascalCase().suffix(string.pascalCase('converter')).toString()}}
+{{#var modelConverterFileName = string(entity.name).snakeCase().suffix('_converter').ext('.ts').toString()}}
+{{{
+  exports({ to: app.makePath('app/converters', entity.path, modelConverterFileName) })
+}}}
+
+import type { ConverterAttributes } from '@jrmc/adonis-attachment/types/converter'
+import type { Input } from '@jrmc/adonis-attachment/types/input'
+
+import logger from '@adonisjs/core/services/logger'
+import Converter from '@jrmc/adonis-attachment/converters/converter'
+
+export default class {{ modelConverterName }} extends Converter {
+  async handle({ input }: ConverterAttributes): Promise<Input> {
+    logger.info('Input path %s', input)
+
+    return input
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jrmc/adonis-attachment",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "type": "module",
   "description": "Turn any field on your Lucid model to an attachment data type",
   "engines": {
@@ -11,6 +11,7 @@
     "type": "git",
     "url": "https://github.com/batosai/adonis-attachment.git"
   },
+  "homepage": "https://adonis-attachment.jrmc.dev",
   "author": "Jeremy Chaufourier jeremy@chaufourier.fr",
   "license": "MIT",
   "keywords": [
@@ -21,7 +22,7 @@
     "image-attachment",
     "image-manipulation",
     "responsive-images",
-    "responsive-image",
+    "upload",
     "resize-images",
     "optimize-images",
     "image",
@@ -36,10 +37,12 @@
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "build": "npm run clean && tsc && npm run copyfiles",
+    "build": "npm run clean && tsc",
+    "postbuild": "npm run copyfiles && npm run index:commands",
     "prepublishOnly": "npm run build",
     "clean": "del-cli build",
     "copyfiles": "copyfiles \"stubs/**/**/*.stub\" build",
+    "index:commands": "adonis-kit index build/commands",
     "format": "prettier --write .",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
@@ -52,10 +55,14 @@
     "./decorators": "./build/src/decorators/attachment.js",
     "./services/*": "./build/services/*.js",
     "./converters/*": "./build/src/converters/*.js",
+    "./providers/*": "./build/providers/*.js",
+    "./commands": "./build/commands/main.js",
+    "./commands/*": "./build/commands/*.js",
     "./attachment_service": "./build/services/attachment_service.js",
     "./attachment_provider": "./build/providers/attachment_provider.js"
   },
   "dependencies": {
+    "@poppinss/defer": "^1.1.0",
     "exifreader": "^4.23.3",
     "file-type": "^19.4.0"
   },