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

package/build/src/integrations/lucid/migrate_legacy_attachment_records.js

@@ -0,0 +1,47 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { migrateLegacyAttachment, } from './migrate_legacy_attachment.js';
+/**
+ * Migrates a stream of legacy v5 JSON values into attachment-table rows.
+ * The caller owns source-model iteration and database transactions; this keeps
+ * the migration compatible with custom Lucid models and other persistence layouts.
+ */
+export async function migrateLegacyAttachmentRecords(options) {
+    const batchSize = options.batchSize ?? 100;
+    if (!Number.isSafeInteger(batchSize) || batchSize < 1) {
+        throw new Error('Legacy attachment migration batchSize must be a positive integer');
+    }
+    const result = {
+        attachments: 0,
+        variants: 0,
+        skipped: 0,
+    };
+    let batch = [];
+    for await (const record of options.records) {
+        if (record.value === null || record.value === undefined) {
+            result.skipped += 1;
+            continue;
+        }
+        const rows = migrateLegacyAttachment(record.value, {
+            owner: record.owner,
+            defaultDisk: options.defaultDisk,
+            createId: options.createId,
+        });
+        result.attachments += 1;
+        result.variants += rows.length - 1;
+        batch.push(...rows);
+        if (batch.length >= batchSize) {
+            await options.writer.insert(batch);
+            batch = [];
+        }
+    }
+    if (batch.length > 0) {
+        await options.writer.insert(batch);
+    }
+    return result;
+}
+//# sourceMappingURL=migrate_legacy_attachment_records.js.map

package/build/src/integrations/lucid/migrate_legacy_attachment_records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate_legacy_attachment_records.js","sourceRoot":"","sources":["../../../../src/integrations/lucid/migrate_legacy_attachment_records.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,uBAAuB,GAGxB,MAAM,gCAAgC,CAAA;AAyBvC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAA8C;IAE9C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAA;IAE1C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;IACrF,CAAC;IAED,MAAM,MAAM,GAAoC;QAC9C,WAAW,EAAE,CAAC;QACd,QAAQ,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;KACX,CAAA;IACD,IAAI,KAAK,GAA4B,EAAE,CAAA;IAEvC,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACxD,MAAM,CAAC,OAAO,IAAI,CAAC,CAAA;YACnB,SAAQ;QACV,CAAC;QAED,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,CAAC,KAAK,EAAE;YACjD,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAA;QAEF,MAAM,CAAC,WAAW,IAAI,CAAC,CAAA;QACvB,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;QAClC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;QAEnB,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;YAC9B,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;YAClC,KAAK,GAAG,EAAE,CAAA;QACZ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACpC,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/build/src/integrations/lucid/render_legacy_attachment_migration_script.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export type RenderLegacyAttachmentMigrationScriptOptions = {
+    defaultDisk?: string;
+};
+export declare function renderLegacyAttachmentMigrationScript(options?: RenderLegacyAttachmentMigrationScriptOptions): string;
+//# sourceMappingURL=render_legacy_attachment_migration_script.d.ts.map

package/build/src/integrations/lucid/render_legacy_attachment_migration_script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_legacy_attachment_migration_script.d.ts","sourceRoot":"","sources":["../../../../src/integrations/lucid/render_legacy_attachment_migration_script.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,4CAA4C,GAAG;IACzD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,wBAAgB,qCAAqC,CACnD,OAAO,GAAE,4CAAiD,GACzD,MAAM,CAkCR"}

package/build/src/integrations/lucid/render_legacy_attachment_migration_script.js

@@ -0,0 +1,41 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export function renderLegacyAttachmentMigrationScript(options = {}) {
+    const defaultDisk = options.defaultDisk ?? 'public';
+    return `import { randomUUID } from 'node:crypto'
+
+import {
+  AttachmentModel,
+  migrateLegacyAttachmentRecords,
+  type LegacyAttachmentMigrationRecord,
+} from '@jrmc/adonis-attachment/lucid'
+
+async function main(): Promise<void> {
+  const result = await migrateLegacyAttachmentRecords({
+    records: legacyAttachmentRecords(),
+    defaultDisk: '${defaultDisk}',
+    createId: randomUUID,
+    writer: {
+      insert: (rows) => AttachmentModel.createMany(rows),
+    },
+  })
+
+  console.info(
+    \`Migrated \${result.attachments} attachments and \${result.variants} variants; skipped \${result.skipped} empty values.\`
+  )
+}
+
+async function* legacyAttachmentRecords(): AsyncGenerator<LegacyAttachmentMigrationRecord> {
+  // Iterate over the legacy model and yield one value per attachment field.
+  // Example owner: { type: 'users', id: user.id.toString(), field: 'avatar' }
+  throw new Error('Implement legacyAttachmentRecords before running this script')
+}
+
+void main()
+`;
+}
+//# sourceMappingURL=render_legacy_attachment_migration_script.js.map

package/build/src/integrations/lucid/render_legacy_attachment_migration_script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render_legacy_attachment_migration_script.js","sourceRoot":"","sources":["../../../../src/integrations/lucid/render_legacy_attachment_migration_script.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,UAAU,qCAAqC,CACnD,UAAwD,EAAE;IAE1D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAA;IAEnD,OAAO;;;;;;;;;;;oBAWW,WAAW;;;;;;;;;;;;;;;;;;;CAmB9B,CAAA;AACD,CAAC"}

package/build/src/queues/adonis_queue.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { AttachmentJob, AttachmentQueue } from '../core/queue.js';
+export type AdonisQueueDispatcher = {
+    toQueue(name: string): AdonisQueueDispatcher;
+    run(): Promise<unknown>;
+};
+export type AdonisAttachmentJob = {
+    dispatch(payload: AttachmentJob): AdonisQueueDispatcher;
+};
+export type AdonisAttachmentQueueOptions = {
+    job: AdonisAttachmentJob;
+    queue?: string;
+};
+/**
+ * Dispatches attachment jobs through an application-defined @adonisjs/queue Job class.
+ */
+export declare class AdonisAttachmentQueue implements AttachmentQueue {
+    #private;
+    constructor(options: AdonisAttachmentQueueOptions);
+    enqueue(job: AttachmentJob): Promise<void>;
+}
+//# sourceMappingURL=adonis_queue.d.ts.map

package/build/src/queues/adonis_queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adonis_queue.d.ts","sourceRoot":"","sources":["../../../src/queues/adonis_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEtE,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAAA;IAC5C,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,qBAAqB,CAAA;CACxD,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,GAAG,EAAE,mBAAmB,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,eAAe;;gBAI/C,OAAO,EAAE,4BAA4B;IAK3C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjD"}

package/build/src/queues/adonis_queue.js

@@ -0,0 +1,22 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+/**
+ * Dispatches attachment jobs through an application-defined @adonisjs/queue Job class.
+ */
+export class AdonisAttachmentQueue {
+    #job;
+    #queue;
+    constructor(options) {
+        this.#job = options.job;
+        this.#queue = options.queue;
+    }
+    async enqueue(job) {
+        const dispatcher = this.#job.dispatch(job);
+        await (this.#queue ? dispatcher.toQueue(this.#queue) : dispatcher).run();
+    }
+}
+//# sourceMappingURL=adonis_queue.js.map

package/build/src/queues/adonis_queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adonis_queue.js","sourceRoot":"","sources":["../../../src/queues/adonis_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACvB,IAAI,CAAqB;IACzB,MAAM,CAAoB;IAEnC,YAAY,OAAqC;QAC/C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAA;QACvB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC1C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAA;IAC1E,CAAC;CACF"}

package/build/src/queues/memory_queue.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { AttachmentJob, AttachmentJobHandler, AttachmentQueue } from '../core/queue.js';
+export type MemoryAttachmentQueueOptions = {
+    handler: AttachmentJobHandler;
+    concurrency?: number;
+    onFailure?: (job: AttachmentJob, error: unknown) => void | Promise<void>;
+};
+/**
+ * In-process default queue for local development and applications without a worker.
+ */
+export declare class MemoryAttachmentQueue implements AttachmentQueue {
+    #private;
+    constructor(options: MemoryAttachmentQueueOptions);
+    enqueue(job: AttachmentJob): Promise<void>;
+    drain(): Promise<void>;
+}
+//# sourceMappingURL=memory_queue.d.ts.map

package/build/src/queues/memory_queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_queue.d.ts","sourceRoot":"","sources":["../../../src/queues/memory_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE5F,MAAM,MAAM,4BAA4B,GAAG;IACzC,OAAO,EAAE,oBAAoB,CAAA;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzE,CAAA;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,eAAe;;gBAQ/C,OAAO,EAAE,4BAA4B;IAU3C,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA0C7B"}

package/build/src/queues/memory_queue.js

@@ -0,0 +1,67 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+/**
+ * In-process default queue for local development and applications without a worker.
+ */
+export class MemoryAttachmentQueue {
+    #handler;
+    #onFailure;
+    #concurrency;
+    #pending = [];
+    #active = 0;
+    #drainWaiters = [];
+    constructor(options) {
+        if (!Number.isInteger(options.concurrency ?? 1) || (options.concurrency ?? 1) < 1) {
+            throw new Error('Memory queue concurrency must be a positive integer');
+        }
+        this.#handler = options.handler;
+        this.#onFailure = options.onFailure;
+        this.#concurrency = options.concurrency ?? 1;
+    }
+    async enqueue(job) {
+        this.#pending.push(job);
+        this.#process();
+    }
+    async drain() {
+        if (this.#pending.length === 0 && this.#active === 0) {
+            return;
+        }
+        await new Promise((resolve) => this.#drainWaiters.push(resolve));
+    }
+    #process() {
+        while (this.#active < this.#concurrency) {
+            const job = this.#pending.shift();
+            if (!job) {
+                this.#resolveDrainWaiters();
+                return;
+            }
+            this.#active += 1;
+            void this.#run(job);
+        }
+    }
+    async #run(job) {
+        try {
+            await this.#handler(job);
+        }
+        catch (error) {
+            await this.#onFailure?.(job, error);
+        }
+        finally {
+            this.#active -= 1;
+            this.#process();
+        }
+    }
+    #resolveDrainWaiters() {
+        if (this.#active !== 0 || this.#pending.length !== 0) {
+            return;
+        }
+        const waiters = this.#drainWaiters;
+        this.#drainWaiters = [];
+        waiters.forEach((resolve) => resolve());
+    }
+}
+//# sourceMappingURL=memory_queue.js.map

package/build/src/queues/memory_queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory_queue.js","sourceRoot":"","sources":["../../../src/queues/memory_queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;GAEG;AACH,MAAM,OAAO,qBAAqB;IACvB,QAAQ,CAAsB;IAC9B,UAAU,CAA4E;IACtF,YAAY,CAAQ;IACpB,QAAQ,GAAoB,EAAE,CAAA;IACvC,OAAO,GAAG,CAAC,CAAA;IACX,aAAa,GAAsB,EAAE,CAAA;IAErC,YAAY,OAAqC;QAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAClF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAA;QACxE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAA;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAA;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACvB,IAAI,CAAC,QAAQ,EAAE,CAAA;IACjB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;YACrD,OAAM;QACR,CAAC;QAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;IACxE,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;YAEjC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,IAAI,CAAC,oBAAoB,EAAE,CAAA;gBAC3B,OAAM;YACR,CAAC;YAED,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;YACjB,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAkB;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACrC,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,IAAI,CAAC,CAAA;YACjB,IAAI,CAAC,QAAQ,EAAE,CAAA;QACjB,CAAC;IACH,CAAC;IAED,oBAAoB;QAClB,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrD,OAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAA;QAClC,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QACvB,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;IACzC,CAAC;CACF"}

package/build/src/sources/attachment_manager.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { Readable } from 'node:stream';
+import type { Attachment, CreateAttachmentInput } from '../core/attachment.js';
+import type { AttachmentService } from '../core/attachment_service.js';
+export type MultipartAttachmentFile = {
+    tmpPath?: string;
+    clientName: string;
+    type?: string;
+    subtype?: string;
+};
+export type AttachmentSourceOptions = Omit<CreateAttachmentInput, 'body' | 'originalName' | 'mimeType'> & {
+    originalName?: string;
+    mimeType?: string;
+    maxBytes?: number;
+};
+export type AttachmentSourceResponse = {
+    ok: boolean;
+    status: number;
+    statusText: string;
+    headers: Pick<Headers, 'get'>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+};
+export type AttachmentSourceFetch = (input: URL | string) => Promise<AttachmentSourceResponse>;
+export type AttachmentManagerOptions = {
+    maxBytes?: number;
+    fetch?: AttachmentSourceFetch;
+};
+/**
+ * Normalizes common input sources before delegating storage to AttachmentService.
+ * It does not inspect media metadata; the media pipeline owns that concern.
+ */
+export declare class AttachmentManager {
+    #private;
+    constructor(attachments: Pick<AttachmentService, 'create'>, options?: AttachmentManagerOptions);
+    createFromBuffer(input: Uint8Array, options?: AttachmentSourceOptions): Promise<Attachment>;
+    createFromBase64(input: string, options?: AttachmentSourceOptions): Promise<Attachment>;
+    createFromPath(input: string, options?: AttachmentSourceOptions): Promise<Attachment>;
+    createFromStream(input: Readable, options?: AttachmentSourceOptions): Promise<Attachment>;
+    createFromUrl(input: URL | string, options?: AttachmentSourceOptions): Promise<Attachment>;
+    createFromFile(input: MultipartAttachmentFile, options?: AttachmentSourceOptions): Promise<Attachment>;
+    createFromFiles(inputs: readonly MultipartAttachmentFile[], options?: AttachmentSourceOptions): Promise<Attachment[]>;
+}
+export declare class AttachmentSourceError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=attachment_manager.d.ts.map

package/build/src/sources/attachment_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_manager.d.ts","sourceRoot":"","sources":["../../../src/sources/attachment_manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,cAAc,GAAG,UAAU,CAAC,GAAG;IACxG,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC7B,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CACpC,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,GAAG,GAAG,MAAM,KAChB,OAAO,CAAC,wBAAwB,CAAC,CAAA;AAEtC,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,qBAAqB,CAAA;CAC9B,CAAA;AAED;;;GAGG;AACH,qBAAa,iBAAiB;;gBAKhB,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAE,wBAA6B;IAUlG,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ/F,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,UAAU,CAAC;IAUrF,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,UAAU,CAAC;IAazF,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,UAAU,CAAC;IAmB7F,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBpG,cAAc,CAAC,KAAK,EAAE,uBAAuB,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,UAAU,CAAC;IAY1G,eAAe,CACb,MAAM,EAAE,SAAS,uBAAuB,EAAE,EAC1C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,UAAU,EAAE,CAAC;CAoCzB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B"}

package/build/src/sources/attachment_manager.js

@@ -0,0 +1,169 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { basename, extname } from 'node:path';
+import { readFile, stat } from 'node:fs/promises';
+/**
+ * Normalizes common input sources before delegating storage to AttachmentService.
+ * It does not inspect media metadata; the media pipeline owns that concern.
+ */
+export class AttachmentManager {
+    #attachments;
+    #maxBytes;
+    #fetch;
+    constructor(attachments, options = {}) {
+        if (options.maxBytes !== undefined && (!Number.isSafeInteger(options.maxBytes) || options.maxBytes < 1)) {
+            throw new Error('Attachment source maxBytes must be a positive integer');
+        }
+        this.#attachments = attachments;
+        this.#maxBytes = options.maxBytes;
+        this.#fetch = options.fetch ?? globalThis.fetch;
+    }
+    createFromBuffer(input, options = {}) {
+        return this.#create(input, {
+            originalName: options.originalName ?? 'attachment.bin',
+            mimeType: options.mimeType ?? mimeTypeFromName(options.originalName),
+            options,
+        });
+    }
+    createFromBase64(input, options = {}) {
+        const parsed = parseBase64(input);
+        return this.#create(parsed.body, {
+            originalName: options.originalName ?? 'attachment.bin',
+            mimeType: options.mimeType ?? parsed.mimeType ?? mimeTypeFromName(options.originalName),
+            options,
+        });
+    }
+    async createFromPath(input, options = {}) {
+        const file = await stat(input);
+        this.#assertSize(file.size, options.maxBytes);
+        const body = await readFile(input);
+        const originalName = options.originalName ?? basename(input);
+        return this.#create(body, {
+            originalName,
+            mimeType: options.mimeType ?? mimeTypeFromName(originalName),
+            options,
+        });
+    }
+    async createFromStream(input, options = {}) {
+        const chunks = [];
+        let size = 0;
+        for await (const chunk of input) {
+            const bytes = typeof chunk === 'string' ? Buffer.from(chunk) : new Uint8Array(chunk);
+            size += bytes.byteLength;
+            this.#assertSize(size, options.maxBytes);
+            chunks.push(bytes);
+        }
+        const originalName = options.originalName ?? 'attachment.bin';
+        return this.#create(Buffer.concat(chunks), {
+            originalName,
+            mimeType: options.mimeType ?? mimeTypeFromName(originalName),
+            options,
+        });
+    }
+    async createFromUrl(input, options = {}) {
+        const response = await this.#fetch(input);
+        if (!response.ok) {
+            throw new AttachmentSourceError(`Unable to download attachment source: ${response.status} ${response.statusText}`);
+        }
+        const contentLength = response.headers.get('content-length');
+        if (contentLength && Number.isSafeInteger(Number(contentLength))) {
+            this.#assertSize(Number(contentLength), options.maxBytes);
+        }
+        const body = new Uint8Array(await response.arrayBuffer());
+        const url = typeof input === 'string' ? new URL(input) : input;
+        const originalName = options.originalName ?? (basename(url.pathname) || 'attachment.bin');
+        return this.#create(body, {
+            originalName,
+            mimeType: options.mimeType ?? normalizeMimeType(response.headers.get('content-type')) ?? mimeTypeFromName(originalName),
+            options,
+        });
+    }
+    createFromFile(input, options = {}) {
+        if (!input.tmpPath) {
+            throw new AttachmentSourceError('Multipart attachment file has no temporary path');
+        }
+        return this.createFromPath(input.tmpPath, {
+            ...options,
+            originalName: options.originalName ?? input.clientName,
+            mimeType: options.mimeType ?? multipartMimeType(input),
+        });
+    }
+    createFromFiles(inputs, options = {}) {
+        return Promise.all(inputs.map((input) => this.createFromFile(input, options)));
+    }
+    async #create(body, input) {
+        this.#assertSize(body.byteLength, input.options.maxBytes);
+        return this.#attachments.create({
+            body,
+            originalName: input.originalName,
+            mimeType: input.mimeType,
+            ...(input.options.disk ? { disk: input.options.disk } : {}),
+            ...(input.options.folder ? { folder: input.options.folder } : {}),
+            ...(input.options.metadata ? { metadata: input.options.metadata } : {}),
+        });
+    }
+    #assertSize(size, override) {
+        if (override !== undefined && (!Number.isSafeInteger(override) || override < 1)) {
+            throw new Error('Attachment source maxBytes must be a positive integer');
+        }
+        const maxBytes = override === undefined
+            ? this.#maxBytes
+            : this.#maxBytes === undefined
+                ? override
+                : Math.min(override, this.#maxBytes);
+        if (maxBytes !== undefined && size > maxBytes) {
+            throw new AttachmentSourceError(`Attachment source exceeds the ${maxBytes}-byte limit`);
+        }
+    }
+}
+export class AttachmentSourceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AttachmentSourceError';
+    }
+}
+function parseBase64(input) {
+    const dataUri = /^data:([^;,]+)?;base64,([A-Za-z0-9+/\s]*={0,2})$/i.exec(input);
+    const mimeType = dataUri?.[1];
+    const value = (dataUri?.[2] ?? input).replaceAll(/\s/g, '');
+    if (!isBase64(value)) {
+        throw new AttachmentSourceError('Attachment source must be valid Base64 data');
+    }
+    return { body: Buffer.from(value, 'base64'), ...(mimeType ? { mimeType } : {}) };
+}
+function isBase64(value) {
+    return value.length > 0 && /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value);
+}
+function multipartMimeType(input) {
+    return input.type && input.subtype
+        ? `${input.type}/${input.subtype}`
+        : mimeTypeFromName(input.clientName);
+}
+function normalizeMimeType(value) {
+    const mimeType = value?.split(';')[0]?.trim();
+    return mimeType || undefined;
+}
+function mimeTypeFromName(name) {
+    switch (extname(name ?? '').slice(1).toLowerCase()) {
+        case 'avif': return 'image/avif';
+        case 'gif': return 'image/gif';
+        case 'jpeg':
+        case 'jpg': return 'image/jpeg';
+        case 'png': return 'image/png';
+        case 'svg': return 'image/svg+xml';
+        case 'webp': return 'image/webp';
+        case 'pdf': return 'application/pdf';
+        case 'doc': return 'application/msword';
+        case 'docx': return 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+        case 'mp4': return 'video/mp4';
+        case 'webm': return 'video/webm';
+        case 'mp3': return 'audio/mpeg';
+        case 'wav': return 'audio/wav';
+        default: return 'application/octet-stream';
+    }
+}
+//# sourceMappingURL=attachment_manager.js.map

package/build/src/sources/attachment_manager.js.map

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

package/build/src/variants/variant_converter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { Attachment } from '../core/attachment.js';
+export type VariantConversionInput = {
+    attachment: Attachment;
+    body: Uint8Array;
+};
+export type VariantConversionOutput = {
+    body: Uint8Array;
+    fileName: string;
+    mimeType: string;
+    folder?: string;
+    metadata?: Record<string, unknown>;
+};
+export interface VariantConverter {
+    key: string;
+    convert(input: VariantConversionInput): Promise<VariantConversionOutput>;
+}
+//# sourceMappingURL=variant_converter.d.ts.map

package/build/src/variants/variant_converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant_converter.d.ts","sourceRoot":"","sources":["../../../src/variants/variant_converter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,UAAU,CAAA;IACtB,IAAI,EAAE,UAAU,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,CAAA;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACzE"}

package/build/src/{types/converter.js → variants/variant_converter.js}

@@ -5,3 +5,4 @@
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
 export {};
+//# sourceMappingURL=variant_converter.js.map

package/build/src/variants/variant_converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant_converter.js","sourceRoot":"","sources":["../../../src/variants/variant_converter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/build/src/variants/variant_generation_service.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { Attachment } from '../core/attachment.js';
+import type { AttachmentService } from '../core/attachment_service.js';
+import type { VariantGenerationRequest, VariantGenerator } from '../core/attachment_job_processor.js';
+import type { VariantConverter } from './variant_converter.js';
+export type GeneratedVariant = {
+    key: string;
+    attachment: Attachment;
+};
+export type VariantGenerationServiceOptions = {
+    attachments: Pick<AttachmentService, 'create' | 'read'>;
+    converters: readonly VariantConverter[];
+};
+export declare class VariantGenerationService implements VariantGenerator {
+    #private;
+    constructor(options: VariantGenerationServiceOptions);
+    generate(request: VariantGenerationRequest): Promise<void>;
+    generateAll(request: VariantGenerationRequest): Promise<GeneratedVariant[]>;
+}
+export declare class UnknownVariantConverterError extends Error {
+    constructor(key: string);
+}
+//# sourceMappingURL=variant_generation_service.d.ts.map

package/build/src/variants/variant_generation_service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant_generation_service.d.ts","sourceRoot":"","sources":["../../../src/variants/variant_generation_service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,uBAAuB,CAAA;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AACrG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,WAAW,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAA;IACvD,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAA;CACxC,CAAA;AAED,qBAAa,wBAAyB,YAAW,gBAAgB;;gBAInD,OAAO,EAAE,+BAA+B;IAK9C,QAAQ,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,WAAW,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CA0BlF;AAED,qBAAa,4BAA6B,SAAQ,KAAK;gBACzC,GAAG,EAAE,MAAM;CAIxB"}

package/build/src/variants/variant_generation_service.js

@@ -0,0 +1,44 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export class VariantGenerationService {
+    #attachments;
+    #converters;
+    constructor(options) {
+        this.#attachments = options.attachments;
+        this.#converters = new Map(options.converters.map((converter) => [converter.key, converter]));
+    }
+    async generate(request) {
+        await this.generateAll(request);
+    }
+    async generateAll(request) {
+        const source = await this.#attachments.read(request.attachment);
+        const keys = request.variantKeys ?? [...this.#converters.keys()];
+        return Promise.all(keys.map(async (key) => {
+            const converter = this.#converters.get(key);
+            if (!converter) {
+                throw new UnknownVariantConverterError(key);
+            }
+            const output = await converter.convert({ attachment: request.attachment, body: source });
+            const input = {
+                body: output.body,
+                originalName: output.fileName,
+                mimeType: output.mimeType,
+                ...(output.folder ? { folder: output.folder } : {}),
+                ...(output.metadata ? { metadata: output.metadata } : {}),
+                disk: request.attachment.disk,
+            };
+            return { key, attachment: await this.#attachments.create(input) };
+        }));
+    }
+}
+export class UnknownVariantConverterError extends Error {
+    constructor(key) {
+        super(`No variant converter is registered for "${key}"`);
+        this.name = 'UnknownVariantConverterError';
+    }
+}
+//# sourceMappingURL=variant_generation_service.js.map

package/build/src/variants/variant_generation_service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant_generation_service.js","sourceRoot":"","sources":["../../../src/variants/variant_generation_service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,MAAM,OAAO,wBAAwB;IAC1B,YAAY,CAA4C;IACxD,WAAW,CAA+B;IAEnD,YAAY,OAAwC;QAClD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,WAAW,CAAA;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAC/F,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAiC;QAC9C,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;IACjC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAiC;QACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;QAEhE,OAAO,OAAO,CAAC,GAAG,CAChB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACrB,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAE3C,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,IAAI,4BAA4B,CAAC,GAAG,CAAC,CAAA;YAC7C,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;YACxF,MAAM,KAAK,GAA0B;gBACnC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,YAAY,EAAE,MAAM,CAAC,QAAQ;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI;aAC9B,CAAA;YAED,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAA;QACnE,CAAC,CAAC,CACH,CAAA;IACH,CAAC;CACF;AAED,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IACrD,YAAY,GAAW;QACrB,KAAK,CAAC,2CAA2C,GAAG,GAAG,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAA;IAC5C,CAAC;CACF"}