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

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

@@ -0,0 +1,15 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { Attachment } from './attachment.js';
+/**
+ * Read boundary used by asynchronous workers. Lucid, another ORM, or no database
+ * can implement it according to the application's persistence model.
+ */
+export interface AttachmentRepository {
+    findById(id: string): Promise<Attachment | null>;
+}
+//# sourceMappingURL=attachment_repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_repository.d.ts","sourceRoot":"","sources":["../../../src/core/attachment_repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;CACjD"}

package/build/src/core/attachment_repository.js

@@ -0,0 +1,8 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export {};
+//# sourceMappingURL=attachment_repository.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { AttachmentDraft, type Attachment, type CreateAttachmentInput } from './attachment.js';
+import { type AttachmentPersistenceOptions } from './attachment_options.js';
+import type { AttachmentQueue } from './queue.js';
+import type { AttachmentStorage } from './storage.js';
+export type AttachmentServiceOptions = {
+    storage: AttachmentStorage;
+    queue: AttachmentQueue;
+    defaultDisk: string;
+    createId?: () => string;
+    defaults?: AttachmentPersistenceOptions;
+};
+/**
+ * Creates files and delegates persistence to the configured storage backend.
+ * Database persistence deliberately remains the responsibility of the caller.
+ */
+export declare class AttachmentService {
+    #private;
+    constructor(options: AttachmentServiceOptions);
+    createDraft(input: CreateAttachmentInput, options?: AttachmentPersistenceOptions): AttachmentDraft;
+    /**
+     * Backward-compatible immediate persistence for direct service consumers.
+     */
+    create(input: CreateAttachmentInput): Promise<Attachment>;
+    remove(attachment: Attachment): Promise<void>;
+    read(attachment: Attachment): Promise<Uint8Array>;
+    scheduleVariantGeneration(attachment: Attachment, variantKeys?: readonly string[]): Promise<void>;
+}
+//# sourceMappingURL=attachment_service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_service.d.ts","sourceRoot":"","sources":["../../../src/core/attachment_service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EAEf,KAAK,UAAU,EAEf,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAIL,KAAK,4BAA4B,EAElC,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,iBAAiB,CAAA;IAC1B,KAAK,EAAE,eAAe,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,4BAA4B,CAAA;CACxC,CAAA;AAED;;;GAGG;AACH,qBAAa,iBAAiB;;gBAMhB,OAAO,EAAE,wBAAwB;IAO7C,WAAW,CACT,KAAK,EAAE,qBAAqB,EAC5B,OAAO,GAAE,4BAAiC,GACzC,eAAe;IAgBlB;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAmC/D,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAIjD,yBAAyB,CACvB,UAAU,EAAE,UAAU,EACtB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;CAOjB"}

package/build/src/core/attachment_service.js

@@ -0,0 +1,93 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { AttachmentDraft, AttachmentFactory, } from './attachment.js';
+import { markAttachmentPending } from './attachment_state.js';
+import { resolveAttachmentPersistenceOptions, } from './attachment_options.js';
+/**
+ * Creates files and delegates persistence to the configured storage backend.
+ * Database persistence deliberately remains the responsibility of the caller.
+ */
+export class AttachmentService {
+    #storage;
+    #queue;
+    #factory;
+    #defaults;
+    constructor(options) {
+        this.#storage = options.storage;
+        this.#queue = options.queue;
+        this.#factory = new AttachmentFactory(options);
+        this.#defaults = options.defaults ?? {};
+    }
+    createDraft(input, options = {}) {
+        const draftOptions = {
+            ...(input.disk !== undefined ? { disk: input.disk } : {}),
+            ...(input.folder !== undefined ? { folder: input.folder } : {}),
+            ...options,
+        };
+        const provisional = this.#factory.create(input, {
+            ...(typeof draftOptions.disk === 'string' ? { disk: draftOptions.disk } : {}),
+            ...(typeof draftOptions.folder === 'string' ? { folder: draftOptions.folder } : {}),
+        });
+        return new AttachmentDraft(input, provisional, draftOptions, (draft, request) => this.#persistDraft(draft, request));
+    }
+    /**
+     * Backward-compatible immediate persistence for direct service consumers.
+     */
+    async create(input) {
+        return this.createDraft(input).persist();
+    }
+    async #persistDraft(draft, request) {
+        const source = draft.source;
+        const context = {
+            ...request?.context,
+            originalName: source.originalName,
+        };
+        const options = resolveAttachmentPersistenceOptions(this.#defaults, request?.options, draft.options);
+        const folder = await resolveFolder(options.folder, context);
+        const name = await resolveName(options.rename, context);
+        const attachment = this.#factory.create(source, {
+            id: draft.id,
+            ...(options.disk ? { disk: options.disk } : {}),
+            ...(folder ? { folder } : {}),
+            ...(name ? { name } : {}),
+        });
+        await this.#storage.write({
+            disk: attachment.disk,
+            path: attachment.path,
+            body: source.body,
+            mimeType: attachment.mimeType,
+        });
+        markAttachmentPending(draft);
+        return attachment;
+    }
+    remove(attachment) {
+        return this.#storage.remove(attachment);
+    }
+    read(attachment) {
+        return this.#storage.read({ disk: attachment.disk, path: attachment.path });
+    }
+    scheduleVariantGeneration(attachment, variantKeys) {
+        return this.#queue.enqueue({
+            type: 'generate-variants',
+            attachmentId: attachment.id,
+            ...(variantKeys ? { variantKeys } : {}),
+        });
+    }
+}
+async function resolveFolder(folder, context) {
+    if (typeof folder === 'function') {
+        return folder(context);
+    }
+    return folder;
+}
+async function resolveName(rename, context) {
+    if (typeof rename === 'function') {
+        return rename(context);
+    }
+    return rename === false ? context.originalName : undefined;
+}
+//# sourceMappingURL=attachment_service.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { Attachment } from './attachment.js';
+export declare function markAttachmentPending(attachment: Attachment): void;
+export declare function markAttachmentPersisted(attachment: Attachment): void;
+export declare function isAttachmentPending(attachment: Attachment): boolean;
+//# sourceMappingURL=attachment_state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_state.d.ts","sourceRoot":"","sources":["../../../src/core/attachment_state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAIjD,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAElE;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEnE"}

package/build/src/core/attachment_state.js

@@ -0,0 +1,17 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+const pendingAttachments = new WeakSet();
+export function markAttachmentPending(attachment) {
+    pendingAttachments.add(attachment);
+}
+export function markAttachmentPersisted(attachment) {
+    pendingAttachments.delete(attachment);
+}
+export function isAttachmentPending(attachment) {
+    return pendingAttachments.has(attachment);
+}
+//# sourceMappingURL=attachment_state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_state.js","sourceRoot":"","sources":["../../../src/core/attachment_state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAc,CAAA;AAEpD,MAAM,UAAU,qBAAqB,CAAC,UAAsB;IAC1D,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAsB;IAC5D,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAsB;IACxD,OAAO,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;AAC3C,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export { AttachmentFactory, AttachmentDraft, isAttachmentDraft, type Attachment, type AttachmentDraftPersistence, type AttachmentFactoryOptions, type AttachmentPersistRequest, type CreateAttachmentInput, } from './attachment.js';
+export { resolveAttachmentPersistenceOptions, type AttachmentFolder, type AttachmentPersistenceContext, type AttachmentPersistenceOptions, type AttachmentRename, type ResolvedAttachmentPersistenceOptions, } from './attachment_options.js';
+export { AttachmentService, type AttachmentServiceOptions } from './attachment_service.js';
+export { AttachmentJobProcessor, AttachmentNotFoundError, type AttachmentJobProcessorOptions, type VariantGenerationRequest, type VariantGenerator, type VariantGeneratorFactory, } from './attachment_job_processor.js';
+export { type AttachmentRepository } from './attachment_repository.js';
+export { type AttachmentJob, type AttachmentJobHandler, type AttachmentQueue, type GenerateVariantsJob, } from './queue.js';
+export { type AttachmentStorage, type StorageLocation, type WriteAttachmentInput, } from './storage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,KAAK,UAAU,EACf,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,mCAAmC,EACnC,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,KAAK,oCAAoC,GAC1C,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAC1F,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,6BAA6B,EAClC,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACtE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,cAAc,CAAA"}

package/build/src/core/index.js

@@ -0,0 +1,11 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export { AttachmentFactory, AttachmentDraft, isAttachmentDraft, } from './attachment.js';
+export { resolveAttachmentPersistenceOptions, } from './attachment_options.js';
+export { AttachmentService } from './attachment_service.js';
+export { AttachmentJobProcessor, AttachmentNotFoundError, } from './attachment_job_processor.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAMlB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,mCAAmC,GAMpC,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAE,iBAAiB,EAAiC,MAAM,yBAAyB,CAAA;AAC1F,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GAKxB,MAAM,+BAA+B,CAAA"}

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

@@ -0,0 +1,20 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+export type GenerateVariantsJob = {
+    type: 'generate-variants';
+    attachmentId: string;
+    variantKeys?: readonly string[];
+};
+export type AttachmentJob = GenerateVariantsJob;
+/**
+ * Dispatch boundary. External queues only need to accept an AttachmentJob.
+ */
+export interface AttachmentQueue {
+    enqueue(job: AttachmentJob): Promise<void>;
+}
+export type AttachmentJobHandler = (job: AttachmentJob) => Promise<void>;
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/core/queue.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,mBAAmB,CAAA;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,mBAAmB,CAAA;AAE/C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3C;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/build/src/{types/event.js → core/queue.js}

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

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { Attachment } from './attachment.js';
+export type StorageLocation = Pick<Attachment, 'disk' | 'path'>;
+export type WriteAttachmentInput = StorageLocation & {
+    body: Uint8Array;
+    mimeType: string;
+};
+/**
+ * Storage boundary implemented by Adonis Drive or any application-specific backend.
+ */
+export interface AttachmentStorage {
+    /** Disk selected when an attachment source does not override it. */
+    defaultDisk?: string | undefined;
+    write(input: WriteAttachmentInput): Promise<void>;
+    read(location: StorageLocation): Promise<Uint8Array>;
+    remove(location: StorageLocation): Promise<void>;
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/core/storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;AAE/D,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG;IACnD,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACpD,MAAM,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjD"}

package/build/src/{types/config.js → core/storage.js}

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

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

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

package/build/src/define_config.d.ts

@@ -4,26 +4,45 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
-import type { AttachmentConfig, BinPaths, ConverterConfig, Queue } from './types/config.js';
-import { ConfigProvider } from '@adonisjs/core/types';
-import { Converter } from './types/converter.js';
+import type { ApplicationService, ConfigProvider } from '@adonisjs/core/types';
+import type { AttachmentServiceOptions } from './core/attachment_service.js';
+import type { AttachmentJobProcessor } from './core/attachment_job_processor.js';
+import type { AttachmentRepository } from './core/attachment_repository.js';
+import type { AttachmentJobHandler, AttachmentQueue } from './core/queue.js';
+import type { AttachmentStorage } from './core/storage.js';
+import type { AttachmentManagerOptions } from './sources/attachment_manager.js';
+import type { AttachmentPersistenceOptions } from './core/attachment_options.js';
+type Integration<T> = T | ((app: ApplicationService) => T | Promise<T>);
+export type AttachmentRouteConfig = false | {
+    prefix?: string;
+};
+export type ResolvedAttachmentRouteConfig = {
+    path: string;
+};
+export type AttachmentConfig = {
+    /** Overrides the storage default. Falls back to `fs` when no adapter provides one. */
+    defaultDisk?: string;
+    storage: Integration<AttachmentStorage>;
+    queue?: Integration<AttachmentQueue>;
+    jobHandler?: Integration<AttachmentJobHandler>;
+    processor?: Integration<AttachmentJobProcessor>;
+    repository?: Integration<AttachmentRepository>;
+    /** Lowest-priority defaults for file persistence. */
+    defaults?: AttachmentPersistenceOptions;
+    sources?: AttachmentManagerOptions;
+    route?: AttachmentRouteConfig;
+    queueConcurrency?: number;
+    createId?: () => string;
+};
+export type ResolvedAttachmentConfig = AttachmentServiceOptions & {
+    repository?: AttachmentRepository;
+    defaults?: AttachmentPersistenceOptions;
+    sources?: AttachmentManagerOptions;
+    route: ResolvedAttachmentRouteConfig | false;
+};
 /**
- * Config resolved by the "defineConfig" method
+ * Defers resolution of optional Adonis integrations until application boot.
  */
-export type ResolvedAttachmentConfig<KnownConverters extends Record<string, Converter>> = {
-    bin?: BinPaths;
-    meta?: boolean;
-    rename?: boolean;
-    preComputeUrl?: boolean;
-    timeout?: number;
-    converters?: {
-        [K in keyof KnownConverters]: KnownConverters[K];
-    };
-    queue?: Queue;
-    variant?: {
-        basePath?: string;
-        ignoreFolder?: boolean;
-    };
-};
-export declare function defineConfig<KnownConverter extends Record<string, ConverterConfig>>(config: AttachmentConfig<KnownConverter>): ConfigProvider<ResolvedAttachmentConfig<KnownConverter>>;
+export declare function defineConfig(config: AttachmentConfig): ConfigProvider<ResolvedAttachmentConfig>;
+export {};
 //# sourceMappingURL=define_config.d.ts.map

package/build/src/define_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAE3F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAEhD;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,eAAe,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI;IACxF,GAAG,CAAC,EAAE,QAAQ,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,eAAe,GAAG,eAAe,CAAC,CAAC,CAAC;KAAE,CAAA;IACjE,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,YAAY,CAAC,EAAE,OAAO,CAAA;KACvB,CAAA;CACF,CAAA;AAED,wBAAgB,YAAY,CAAC,cAAc,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACjF,MAAM,EAAE,gBAAgB,CAAC,cAAc,CAAC,GACvC,cAAc,CAAC,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAkC1D"}
+{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAA;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAA;AAC/E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAA;AAEhF,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,kBAAkB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAEvE,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/D,MAAM,MAAM,6BAA6B,GAAG;IAC1C,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,WAAW,CAAC,iBAAiB,CAAC,CAAA;IACvC,KAAK,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAA;IACpC,UAAU,CAAC,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAA;IAC9C,SAAS,CAAC,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAA;IAC/C,UAAU,CAAC,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAA;IAC9C,qDAAqD;IACrD,QAAQ,CAAC,EAAE,4BAA4B,CAAA;IACvC,OAAO,CAAC,EAAE,wBAAwB,CAAA;IAClC,KAAK,CAAC,EAAE,qBAAqB,CAAA;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,wBAAwB,GAAG;IAChE,UAAU,CAAC,EAAE,oBAAoB,CAAA;IACjC,QAAQ,CAAC,EAAE,4BAA4B,CAAA;IACvC,OAAO,CAAC,EAAE,wBAAwB,CAAA;IAClC,KAAK,EAAE,6BAA6B,GAAG,KAAK,CAAA;CAC7C,CAAA;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAAC,wBAAwB,CAAC,CA8B/F"}

package/build/src/define_config.js

@@ -5,32 +5,54 @@
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
 import { configProvider } from '@adonisjs/core';
+import { MemoryAttachmentQueue } from './queues/memory_queue.js';
+/**
+ * Defers resolution of optional Adonis integrations until application boot.
+ */
 export function defineConfig(config) {
-    return configProvider.create(async (_app) => {
-        const convertersList = Object.keys(config.converters || {});
-        const converters = {};
-        if (config.converters) {
-            for (let converterName of convertersList) {
-                const converter = config.converters[converterName];
-                const binConfig = config.bin;
-                if (converter.converter === undefined) {
-                    converter.converter = () => import('@jrmc/adonis-attachment/converters/autodetect_converter');
-                }
-                try {
-                    const { default: value } = await converter.converter();
-                    const { converter: _, ...opt } = converter;
-                    const options = converter.options || opt;
-                    const Converter = value;
-                    converters[converterName] = new Converter(options, binConfig);
-                }
-                catch (error) {
-                    console.error(`Failed to load converter ${converterName}:`, error);
-                }
-            }
-        }
+    return configProvider.create(async (app) => {
+        const storage = await resolveIntegration(config.storage, app);
+        const processor = config.processor
+            ? await resolveIntegration(config.processor, app)
+            : undefined;
+        const queue = config.queue
+            ? await resolveIntegration(config.queue, app)
+            : new MemoryAttachmentQueue({
+                handler: config.jobHandler
+                    ? await resolveIntegration(config.jobHandler, app)
+                    : processor
+                        ? (job) => processor.process(job)
+                        : async () => { },
+                ...(config.queueConcurrency ? { concurrency: config.queueConcurrency } : {}),
+            });
         return {
-            ...config,
-            converters,
+            defaultDisk: config.defaultDisk ?? storage.defaultDisk ?? 'fs',
+            storage,
+            queue,
+            route: resolveRoute(config.route),
+            ...(config.repository
+                ? { repository: await resolveIntegration(config.repository, app) }
+                : {}),
+            ...(config.defaults ? { defaults: config.defaults } : {}),
+            ...(config.sources ? { sources: config.sources } : {}),
+            ...(config.createId ? { createId: config.createId } : {}),
         };
     });
 }
+function resolveRoute(route) {
+    if (route === false) {
+        return false;
+    }
+    const prefix = route?.prefix ?? '/attachments';
+    if (!prefix.startsWith('/') || prefix.includes(':')) {
+        throw new Error('Attachment route prefix must start with "/" and cannot contain parameters');
+    }
+    return { path: `${prefix.replace(/\/+$/, '') || ''}/:id` };
+}
+async function resolveIntegration(integration, app) {
+    if (typeof integration === 'function') {
+        return integration(app);
+    }
+    return integration;
+}
+//# sourceMappingURL=define_config.js.map

package/build/src/define_config.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * @jrmc/adonis-attachment
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import type { LucidRow } from '@adonisjs/lucid/types/model';
+import { type Attachment } from '../../core/attachment.js';
+import type { AttachmentPersistenceOptions } from '../../core/attachment_options.js';
+export type LucidAttachmentOptions<Model = any> = AttachmentPersistenceOptions<Model> & {
+    serialize?: (value: Attachment | null | undefined) => unknown;
+    serializeAs?: string | null;
+};
+/**
+ * Persists one Attachment JSON value in a Lucid column and coordinates file cleanup.
+ */
+export declare function attachment<Model = LucidRow>(options?: LucidAttachmentOptions<Model>): PropertyDecorator;
+//# sourceMappingURL=attachment_column.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachment_column.d.ts","sourceRoot":"","sources":["../../../../src/integrations/lucid/attachment_column.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAc,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AAEvE,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAA;AAoBpF,MAAM,MAAM,sBAAsB,CAAC,KAAK,GAAG,GAAG,IAAI,4BAA4B,CAAC,KAAK,CAAC,GAAG;IACtF,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,KAAK,OAAO,CAAA;IAC7D,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B,CAAA;AAOD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,GAAG,QAAQ,EAAE,OAAO,GAAE,sBAAsB,CAAC,KAAK,CAAM,GAAG,iBAAiB,CAoB3G"}