@jrmc/adonis-attachment 5.2.1 → 6.0.0-alpha.1

package/build/src/adapters/adonis_drive_storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adonis_drive_storage.js","sourceRoot":"","sources":["../../../src/adapters/adonis_drive_storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAmB/C,MAAM,OAAO,kBAAkB;IACpB,MAAM,CAAoB;IAC1B,WAAW,CAAoB;IAExC,YAAY,KAAyB,EAAE,WAAoB;QACzD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAuB;QAC1C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CACzC,GAAG,EACH,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CACxB,CAAA;QAED,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAA;QACnF,CAAC;QAED,OAAO,IAAI,kBAAkB,CAC3B,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,eAAe,CAAC,CAAuB,EACjE,MAAM,CAAC,MAAM,CAAC,OAAO,CACtB,CAAA;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAA2B;QACrC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IAC/D,CAAC;IAED,IAAI,CAAC,QAAyB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC/D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAyB;QACpC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC5D,CAAC;CACF"}

package/build/src/adapters/local_file_storage.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { ApplicationService } from '@adonisjs/core/types';
+import type { AttachmentStorage, StorageLocation, WriteAttachmentInput } from '../core/storage.js';
+export type LocalFileStorageOptions = {
+    location: string;
+    disk?: string;
+};
+/**
+ * Stores attachment bytes on the local filesystem without requiring Drive.
+ */
+export declare class LocalFileStorage implements AttachmentStorage {
+    #private;
+    readonly defaultDisk: string;
+    constructor(options: LocalFileStorageOptions);
+    static fromApp(app: ApplicationService): LocalFileStorage;
+    write(input: WriteAttachmentInput): Promise<void>;
+    read(location: StorageLocation): Promise<Uint8Array>;
+    remove(location: StorageLocation): Promise<void>;
+}
+//# sourceMappingURL=local_file_storage.d.ts.map

package/build/src/adapters/local_file_storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_file_storage.d.ts","sourceRoot":"","sources":["../../../src/adapters/local_file_storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAElG,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;;IAExD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;gBAEhB,OAAO,EAAE,uBAAuB;IAK5C,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,kBAAkB,GAAG,gBAAgB;IAInD,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAIpD,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBvD"}

package/build/src/adapters/local_file_storage.js

@@ -0,0 +1,54 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname, relative, resolve, sep } from 'node:path';
+import { randomUUID } from 'node:crypto';
+/**
+ * Stores attachment bytes on the local filesystem without requiring Drive.
+ */
+export class LocalFileStorage {
+    #location;
+    defaultDisk;
+    constructor(options) {
+        this.#location = resolve(options.location);
+        this.defaultDisk = options.disk ?? 'fs';
+    }
+    static fromApp(app) {
+        return new LocalFileStorage({ location: app.makePath('storage/attachments') });
+    }
+    async write(input) {
+        const filePath = this.#resolve(input);
+        const temporaryPath = `${filePath}.${randomUUID()}.tmp`;
+        await mkdir(dirname(filePath), { recursive: true });
+        try {
+            await writeFile(temporaryPath, input.body);
+            await rename(temporaryPath, filePath);
+        }
+        catch (error) {
+            await rm(temporaryPath, { force: true }).catch(() => undefined);
+            throw error;
+        }
+    }
+    async read(location) {
+        return new Uint8Array(await readFile(this.#resolve(location)));
+    }
+    async remove(location) {
+        await rm(this.#resolve(location), { force: true });
+    }
+    #resolve(location) {
+        if (location.disk !== this.defaultDisk) {
+            throw new Error(`LocalFileStorage cannot access the "${location.disk}" disk`);
+        }
+        const filePath = resolve(this.#location, location.path);
+        const pathFromRoot = relative(this.#location, filePath);
+        if (!pathFromRoot || pathFromRoot === '..' || pathFromRoot.startsWith(`..${sep}`)) {
+            throw new Error('Attachment paths must stay inside the local storage directory');
+        }
+        return filePath;
+    }
+}
+//# sourceMappingURL=local_file_storage.js.map

package/build/src/adapters/local_file_storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local_file_storage.js","sourceRoot":"","sources":["../../../src/adapters/local_file_storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAWxC;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAClB,SAAS,CAAQ;IACjB,WAAW,CAAQ;IAE5B,YAAY,OAAgC;QAC1C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC1C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI,CAAA;IACzC,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,GAAuB;QACpC,OAAO,IAAI,gBAAgB,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAA;IAChF,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAA2B;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QACrC,MAAM,aAAa,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,MAAM,CAAA;QAEvD,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAEnD,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;YAC1C,MAAM,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,EAAE,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YAC/D,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAyB;QAClC,OAAO,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;IAChE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAyB;QACpC,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACpD,CAAC;IAED,QAAQ,CAAC,QAAyB;QAChC,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,uCAAuC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAA;QAC/E,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;QACvD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAEvD,IAAI,CAAC,YAAY,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAA;QAClF,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;CACF"}

package/build/src/controllers/attachments_controller.d.ts

@@ -1,5 +1,16 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
 import type { HttpContext } from '@adonisjs/core/http';
-export default class AttachmentsController {
-    handle({ request, response }: HttpContext): Promise<void>;
+import type { AttachmentService } from '../core/attachment_service.js';
+import type { AttachmentRepository } from '../core/attachment_repository.js';
+export declare class AttachmentsController {
+    private readonly attachments;
+    private readonly repository;
+    constructor(attachments: Pick<AttachmentService, 'read'>, repository: AttachmentRepository);
+    handle({ request, response }: HttpContext): Promise<unknown>;
 }
 //# sourceMappingURL=attachments_controller.d.ts.map

package/build/src/controllers/attachments_controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments_controller.d.ts","sourceRoot":"","sources":["../../../src/controllers/attachments_controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAqBtD,MAAM,CAAC,OAAO,OAAO,qBAAqB;IAClC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,WAAW;CAkHhD"}
+{"version":3,"file":"attachments_controller.d.ts","sourceRoot":"","sources":["../../../src/controllers/attachments_controller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAA;AAE5E,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,EAC5C,UAAU,EAAE,oBAAoB;IAG7C,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;CAUnE"}

package/build/src/controllers/attachments_controller.js

@@ -1,110 +1,23 @@
-import path from 'node:path';
-import { Readable } from 'node:stream';
-import encryption from '@adonisjs/core/services/encryption';
-import db from '@adonisjs/lucid/services/db';
-import { attachmentManager } from '@jrmc/adonis-attachment';
-import VariantGeneratorService from '../services/variant/variant_generator_service.js';
-import VariantPersisterService from '../services/variant/variant_persister_service.js';
-export default class AttachmentsController {
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export class AttachmentsController {
+    attachments;
+    repository;
+    constructor(attachments, repository) {
+        this.attachments = attachments;
+        this.repository = repository;
+    }
     async handle({ request, response }) {
-        const { key } = request.params();
-        const format = request.qs()?.variant;
-        let multiple = false;
-        const data = encryption.decrypt(key);
-        await attachmentManager.lock
-            .createLock(`attachment.${data.model}-${data.attribute}`)
-            .run(async () => {
-            const queryWithTableSelection = await db
-                .from(data.model)
-                .select(data.attribute)
-                .where(data.primaryKey, data.id)
-                .first();
-            /*
-             * 1. Get the Attachment(s)
-             */
-            const result = typeof queryWithTableSelection[data.attribute] === 'string'
-                ? JSON.parse(queryWithTableSelection[data.attribute])
-                : queryWithTableSelection[data.attribute];
-            const attachments = [];
-            let currentAttachment = null;
-            if (Array.isArray(result)) {
-                multiple = true;
-                for (const item of result) {
-                    item.folder = path.dirname(item.path);
-                    const attachment = attachmentManager.createFromDbResponse(item);
-                    if (attachment) {
-                        attachment.setOptions(data.options);
-                        attachments.push(attachment);
-                    }
-                }
-                currentAttachment = attachments[data.index || 0];
-            }
-            else {
-                result.folder = path.dirname(result.path);
-                currentAttachment = attachmentManager.createFromDbResponse(result);
-                if (currentAttachment) {
-                    currentAttachment.setOptions(data.options);
-                }
-            }
-            if (!currentAttachment) {
-                return response.notFound();
-            }
-            /*
-             * 2. Get the variant
-             */
-            let variant = currentAttachment.getVariant(format);
-            /*
-             * 3. Get the stream
-             * if variant and path, get the stream and return it
-             * if not, generate the variant
-             * if not, return the default file
-             */
-            if (!variant && format) {
-                const converter = (await attachmentManager.getConverter(format));
-                variant = await new VariantGeneratorService().generateVariant({
-                    key: format,
-                    attachment: currentAttachment,
-                    converter,
-                });
-                if (variant) {
-                    const variantPersister = new VariantPersisterService({
-                        id: data.id,
-                        modelTable: data.model,
-                        attributeName: data.attribute,
-                        multiple,
-                        primaryKey: data.primaryKey,
-                    });
-                    const attachmentsOrCurrent = attachments.length ? attachments : [currentAttachment];
-                    await variantPersister.persist({
-                        attachments: attachmentsOrCurrent,
-                        variants: [variant],
-                    });
-                }
-            }
-            /*
-             * 5. Get the stream
-             */
-            let stream;
-            let mimeType;
-            if (variant) {
-                stream = await variant.getStream();
-                mimeType = variant.mimeType;
-            }
-            else if (currentAttachment) {
-                stream = await currentAttachment.getStream();
-                mimeType = currentAttachment.mimeType;
-            }
-            /*
-             * 6. Return the stream
-             */
-            if (stream && mimeType) {
-                const readable = Readable.from(stream);
-                response.header('Content-Type', mimeType);
-                response.stream(readable);
-            }
-            else {
-                return response.notFound();
-            }
-        });
+        const attachment = await this.repository.findById(request.param('id'));
+        if (!attachment) {
+            return response.notFound();
+        }
+        response.header('content-type', attachment.mimeType);
+        return response.send(await this.attachments.read(attachment));
     }
 }
+//# sourceMappingURL=attachments_controller.js.map

package/build/src/controllers/attachments_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments_controller.js","sourceRoot":"","sources":["../../../src/controllers/attachments_controller.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,WAA4C,EAC5C,UAAgC;QADhC,gBAAW,GAAX,WAAW,CAAiC;QAC5C,eAAU,GAAV,UAAU,CAAsB;IAChD,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAe;QAC7C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;QAEtE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAA;QAC5B,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAA;QACpD,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAA;IAC/D,CAAC;CACF"}

package/build/src/core/attachment.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { AttachmentPersistenceContext, AttachmentPersistenceOptions } from './attachment_options.js';
+export type Attachment = Readonly<{
+    id: string;
+    disk: string;
+    name: string;
+    originalName: string;
+    path: string;
+    size: number;
+    extname: string;
+    mimeType: string;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type AttachmentPersistRequest<Model = any> = {
+    options?: AttachmentPersistenceOptions<Model>;
+    context?: Omit<AttachmentPersistenceContext<Model>, 'originalName'>;
+};
+export type AttachmentDraftPersistence = (draft: AttachmentDraft, request?: AttachmentPersistRequest<any>) => Promise<Attachment>;
+export type CreateAttachmentInput = {
+    body: Uint8Array;
+    originalName: string;
+    mimeType?: string;
+    disk?: string;
+    folder?: string;
+    metadata?: Record<string, unknown>;
+};
+/**
+ * A source-backed attachment that has not been written to storage yet.
+ * Its public properties become final after `persist()` resolves.
+ */
+export declare class AttachmentDraft implements Attachment {
+    #private;
+    readonly id: string;
+    disk: string;
+    name: string;
+    originalName: string;
+    path: string;
+    size: number;
+    extname: string;
+    mimeType: string;
+    metadata?: Record<string, unknown> | undefined;
+    constructor(source: CreateAttachmentInput, provisional: Attachment, options: AttachmentPersistenceOptions, persistence: AttachmentDraftPersistence);
+    get isPersisted(): boolean;
+    get source(): Readonly<CreateAttachmentInput>;
+    get options(): Readonly<AttachmentPersistenceOptions>;
+    persist(request?: AttachmentPersistRequest<any>): Promise<Attachment>;
+    toJSON(): Attachment;
+    toAttachment(): Attachment;
+}
+export declare function isAttachmentDraft(value: unknown): value is AttachmentDraft;
+export type AttachmentFactoryOptions = {
+    defaultDisk: string;
+    createId?: () => string;
+};
+export declare class AttachmentFactory {
+    #private;
+    constructor(options: AttachmentFactoryOptions);
+    create(input: CreateAttachmentInput, options?: {
+        id?: string;
+        name?: string;
+        disk?: string;
+        folder?: string;
+    }): Attachment;
+}
+//# sourceMappingURL=attachment.d.ts.map

package/build/src/core/attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../../src/core/attachment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,4BAA4B,EAC5B,4BAA4B,EAC7B,MAAM,yBAAyB,CAAA;AAEhC,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAC/C,CAAC,CAAA;AAEF,MAAM,MAAM,wBAAwB,CAAC,KAAK,GAAG,GAAG,IAAI;IAClD,OAAO,CAAC,EAAE,4BAA4B,CAAC,KAAK,CAAC,CAAA;IAC7C,OAAO,CAAC,EAAE,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,CAAA;CACpE,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG,CACvC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,wBAAwB,CAAC,GAAG,CAAC,KACpC,OAAO,CAAC,UAAU,CAAC,CAAA;AAExB,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,UAAU,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,CAAA;AAED;;;GAGG;AACH,qBAAa,eAAgB,YAAW,UAAU;;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;gBAS5C,MAAM,EAAE,qBAAqB,EAC7B,WAAW,EAAE,UAAU,EACvB,OAAO,EAAE,4BAA4B,EACrC,WAAW,EAAE,0BAA0B;IAkBzC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,MAAM,IAAI,QAAQ,CAAC,qBAAqB,CAAC,CAM5C;IAED,IAAI,OAAO,IAAI,QAAQ,CAAC,4BAA4B,CAAC,CAEpD;IAED,OAAO,CAAC,OAAO,CAAC,EAAE,wBAAwB,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAgCrE,MAAM,IAAI,UAAU;IAQpB,YAAY,IAAI,UAAU;CAa3B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;CACxB,CAAA;AAED,qBAAa,iBAAiB;;gBAIhB,OAAO,EAAE,wBAAwB;IAK7C,MAAM,CACJ,KAAK,EAAE,qBAAqB,EAC5B,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3E,UAAU;CAkBd"}

package/build/src/core/attachment.js

@@ -0,0 +1,150 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { randomUUID } from 'node:crypto';
+import { extname } from 'node:path';
+/**
+ * A source-backed attachment that has not been written to storage yet.
+ * Its public properties become final after `persist()` resolves.
+ */
+export class AttachmentDraft {
+    id;
+    disk;
+    name;
+    originalName;
+    path;
+    size;
+    extname;
+    mimeType;
+    metadata;
+    #options;
+    #source;
+    #persisted = false;
+    #persisting;
+    #persistence;
+    constructor(source, provisional, options, persistence) {
+        this.id = provisional.id;
+        this.disk = provisional.disk;
+        this.name = provisional.name;
+        this.originalName = provisional.originalName;
+        this.path = provisional.path;
+        this.size = provisional.size;
+        this.extname = provisional.extname;
+        this.mimeType = provisional.mimeType;
+        if (provisional.metadata) {
+            this.metadata = provisional.metadata;
+        }
+        this.#source = source;
+        this.#options = options;
+        this.#persistence = persistence;
+    }
+    get isPersisted() {
+        return this.#persisted;
+    }
+    get source() {
+        if (!this.#source) {
+            throw new Error('Attachment draft source is no longer available after persistence');
+        }
+        return this.#source;
+    }
+    get options() {
+        return this.#options;
+    }
+    persist(request) {
+        if (this.#persisted) {
+            return Promise.resolve(this);
+        }
+        if (!this.#persisting) {
+            this.#persisting = this.#persistence(this, request)
+                .then((attachment) => {
+                this.disk = attachment.disk;
+                this.name = attachment.name;
+                this.path = attachment.path;
+                this.size = attachment.size;
+                this.extname = attachment.extname;
+                this.mimeType = attachment.mimeType;
+                if (attachment.metadata) {
+                    this.metadata = attachment.metadata;
+                }
+                else {
+                    delete this.metadata;
+                }
+                this.#source = undefined;
+                this.#persisted = true;
+                return this;
+            })
+                .catch((error) => {
+                this.#persisting = undefined;
+                throw error;
+            });
+        }
+        return this.#persisting;
+    }
+    toJSON() {
+        if (!this.#persisted) {
+            throw new Error('Attachment drafts must be persisted before serialization');
+        }
+        return this.toAttachment();
+    }
+    toAttachment() {
+        return {
+            id: this.id,
+            disk: this.disk,
+            name: this.name,
+            originalName: this.originalName,
+            path: this.path,
+            size: this.size,
+            extname: this.extname,
+            mimeType: this.mimeType,
+            ...(this.metadata ? { metadata: this.metadata } : {}),
+        };
+    }
+}
+export function isAttachmentDraft(value) {
+    return value instanceof AttachmentDraft;
+}
+export class AttachmentFactory {
+    #defaultDisk;
+    #createId;
+    constructor(options) {
+        this.#defaultDisk = options.defaultDisk;
+        this.#createId = options.createId ?? randomUUID;
+    }
+    create(input, options = {}) {
+        const id = options.id ?? this.#createId();
+        const extension = getExtension(input.originalName);
+        const name = options.name ?? (extension ? `${id}.${extension}` : id);
+        const path = joinPath(options.folder ?? input.folder, name);
+        return {
+            id,
+            disk: options.disk ?? input.disk ?? this.#defaultDisk,
+            name,
+            originalName: input.originalName,
+            path,
+            size: input.body.byteLength,
+            extname: extension,
+            mimeType: input.mimeType ?? 'application/octet-stream',
+            ...(input.metadata ? { metadata: input.metadata } : {}),
+        };
+    }
+}
+function getExtension(fileName) {
+    return extname(fileName).slice(1).toLowerCase();
+}
+function joinPath(folder, name) {
+    if (name.includes('/') || name.includes('\\') || name === '.' || name === '..') {
+        throw new Error('Attachment names must not contain path separators');
+    }
+    if (!folder) {
+        return name;
+    }
+    const normalizedFolder = folder.replaceAll('\\', '/').replace(/^\/+|\/+$/g, '');
+    if (!normalizedFolder || normalizedFolder.split('/').includes('..')) {
+        throw new Error('Attachment folder must be a relative path without parent segments');
+    }
+    return `${normalizedFolder}/${name}`;
+}
+//# sourceMappingURL=attachment.js.map

package/build/src/core/attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.js","sourceRoot":"","sources":["../../../src/core/attachment.ts"],"names":[],"mappings":"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"}

package/build/src/core/attachment_job_processor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { Attachment } from './attachment.js';
+import type { AttachmentJob } from './queue.js';
+import type { AttachmentRepository } from './attachment_repository.js';
+export type VariantGenerationRequest = {
+    attachment: Attachment;
+    variantKeys?: readonly string[];
+};
+export interface VariantGenerator {
+    generate(request: VariantGenerationRequest): Promise<void>;
+}
+export type VariantGeneratorFactory = () => VariantGenerator | Promise<VariantGenerator>;
+export type AttachmentJobProcessorOptions = {
+    attachments: AttachmentRepository;
+    variants: VariantGenerator | VariantGeneratorFactory;
+};
+export declare class AttachmentJobProcessor {
+    #private;
+    constructor(options: AttachmentJobProcessorOptions);
+    process(job: AttachmentJob): Promise<void>;
+}
+export declare class AttachmentNotFoundError extends Error {
+    constructor(attachmentId: string);
+}
+//# sourceMappingURL=attachment_job_processor.d.ts.map

package/build/src/core/attachment_job_processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_job_processor.d.ts","sourceRoot":"","sources":["../../../src/core/attachment_job_processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAEtE,MAAM,MAAM,wBAAwB,GAAG;IACrC,UAAU,EAAE,UAAU,CAAA;IACtB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAChC,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D;AAED,MAAM,MAAM,uBAAuB,GAAG,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;AAExF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,WAAW,EAAE,oBAAoB,CAAA;IACjC,QAAQ,EAAE,gBAAgB,GAAG,uBAAuB,CAAA;CACrD,CAAA;AAED,qBAAa,sBAAsB;;gBAKrB,OAAO,EAAE,6BAA6B;IAK5C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CA8BjD;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,YAAY,EAAE,MAAM;CAIjC"}

package/build/src/core/attachment_job_processor.js

@@ -0,0 +1,47 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export class AttachmentJobProcessor {
+    #attachments;
+    #variants;
+    #resolvedVariants;
+    constructor(options) {
+        this.#attachments = options.attachments;
+        this.#variants = options.variants;
+    }
+    async process(job) {
+        switch (job.type) {
+            case 'generate-variants':
+                await this.#generateVariants(job.attachmentId, job.variantKeys);
+                return;
+        }
+    }
+    async #generateVariants(attachmentId, variantKeys) {
+        const attachment = await this.#attachments.findById(attachmentId);
+        if (!attachment) {
+            throw new AttachmentNotFoundError(attachmentId);
+        }
+        const variants = await this.#getVariants();
+        await variants.generate({
+            attachment,
+            ...(variantKeys ? { variantKeys } : {}),
+        });
+    }
+    #getVariants() {
+        if (typeof this.#variants !== 'function') {
+            return Promise.resolve(this.#variants);
+        }
+        this.#resolvedVariants ??= Promise.resolve(this.#variants());
+        return this.#resolvedVariants;
+    }
+}
+export class AttachmentNotFoundError extends Error {
+    constructor(attachmentId) {
+        super(`Attachment "${attachmentId}" was not found`);
+        this.name = 'AttachmentNotFoundError';
+    }
+}
+//# sourceMappingURL=attachment_job_processor.js.map

package/build/src/core/attachment_job_processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_job_processor.js","sourceRoot":"","sources":["../../../src/core/attachment_job_processor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,MAAM,OAAO,sBAAsB;IACxB,YAAY,CAAsB;IAClC,SAAS,CAA4C;IAC9D,iBAAiB,CAAuC;IAExD,YAAY,OAAsC;QAChD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAA;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,mBAAmB;gBACtB,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;gBAC/D,OAAM;QACV,CAAC;IACH,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,YAAoB,EAAE,WAA+B;QAC3E,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;QAEjE,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,uBAAuB,CAAC,YAAY,CAAC,CAAA;QACjD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAA;QAC1C,MAAM,QAAQ,CAAC,QAAQ,CAAC;YACtB,UAAU;YACV,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC,CAAA;IACJ,CAAC;IAED,YAAY;QACV,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YACzC,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACxC,CAAC;QAED,IAAI,CAAC,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;QAC5D,OAAO,IAAI,CAAC,iBAAiB,CAAA;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,YAAoB;QAC9B,KAAK,CAAC,eAAe,YAAY,iBAAiB,CAAC,CAAA;QACnD,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF"}

package/build/src/core/attachment_options.d.ts

@@ -0,0 +1,32 @@
+export type AttachmentPersistenceContext<Model = unknown> = {
+    model?: Model;
+    field?: string;
+    originalName: string;
+};
+export type AttachmentFolder<Model = unknown> = string | ((context: AttachmentPersistenceContext<Model>) => string | Promise<string>);
+export type AttachmentRename<Model = unknown> = boolean | ((context: AttachmentPersistenceContext<Model>) => string | Promise<string>);
+/**
+ * File-persistence settings. `null` explicitly disables an inherited setting.
+ */
+export type AttachmentPersistenceOptions<Model = unknown> = {
+    disk?: string | null;
+    folder?: AttachmentFolder<Model> | null;
+    rename?: AttachmentRename<Model> | null;
+    meta?: boolean | null;
+    preComputeUrl?: boolean | null;
+    variants?: readonly string[] | null;
+};
+export type ResolvedAttachmentPersistenceOptions<Model = unknown> = {
+    disk?: string;
+    folder?: AttachmentFolder<Model>;
+    rename?: AttachmentRename<Model>;
+    meta?: boolean;
+    preComputeUrl?: boolean;
+    variants?: readonly string[];
+};
+/**
+ * Resolves options from lowest to highest priority. An explicit `null` clears
+ * the inherited value for one setting.
+ */
+export declare function resolveAttachmentPersistenceOptions<Model = unknown>(...layers: ReadonlyArray<AttachmentPersistenceOptions<Model> | undefined>): ResolvedAttachmentPersistenceOptions<Model>;
+//# sourceMappingURL=attachment_options.d.ts.map

package/build/src/core/attachment_options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_options.d.ts","sourceRoot":"","sources":["../../../src/core/attachment_options.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,4BAA4B,CAAC,KAAK,GAAG,OAAO,IAAI;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IACxC,MAAM,GACN,CAAC,CAAC,OAAO,EAAE,4BAA4B,CAAC,KAAK,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AAEhF,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,OAAO,IACxC,OAAO,GACP,CAAC,CAAC,OAAO,EAAE,4BAA4B,CAAC,KAAK,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AAEhF;;GAEG;AACH,MAAM,MAAM,4BAA4B,CAAC,KAAK,GAAG,OAAO,IAAI;IAC1D,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IACvC,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;IACvC,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACrB,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,oCAAoC,CAAC,KAAK,GAAG,OAAO,IAAI;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B,CAAA;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,GAAG,OAAO,EACjE,GAAG,MAAM,EAAE,aAAa,CAAC,4BAA4B,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,GACxE,oCAAoC,CAAC,KAAK,CAAC,CAS7C"}

package/build/src/core/attachment_options.js

@@ -0,0 +1,24 @@
+/**
+ * Resolves options from lowest to highest priority. An explicit `null` clears
+ * the inherited value for one setting.
+ */
+export function resolveAttachmentPersistenceOptions(...layers) {
+    return {
+        ...resolveOption('disk', layers),
+        ...resolveOption('folder', layers),
+        ...resolveOption('rename', layers),
+        ...resolveOption('meta', layers),
+        ...resolveOption('preComputeUrl', layers),
+        ...resolveOption('variants', layers),
+    };
+}
+function resolveOption(key, layers) {
+    for (const layer of [...layers].reverse()) {
+        const value = layer?.[key];
+        if (value !== undefined) {
+            return value === null ? {} : { [key]: value };
+        }
+    }
+    return {};
+}
+//# sourceMappingURL=attachment_options.js.map

package/build/src/core/attachment_options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_options.js","sourceRoot":"","sources":["../../../src/core/attachment_options.ts"],"names":[],"mappings":"AAmCA;;;GAGG;AACH,MAAM,UAAU,mCAAmC,CACjD,GAAG,MAAsE;IAEzE,OAAO;QACL,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;QAChC,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC;QAClC,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC;QAClC,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;QAChC,GAAG,aAAa,CAAC,eAAe,EAAE,MAAM,CAAC;QACzC,GAAG,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC;KACrC,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CACpB,GAAQ,EACR,MAAsE;IAEtE,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;QAE1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAA;QAC/C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAA;AACX,CAAC"}