@adonis-agora/media 0.1.0

package/dist/src/errors.js

@@ -0,0 +1,29 @@
+export class MimeNotAllowedError extends Error {
+    code = 'E_MEDIA_MIME_NOT_ALLOWED';
+    constructor(collection, mimeType) {
+        super(`MIME type "${mimeType}" is not allowed in collection "${collection}"`);
+        this.name = 'MimeNotAllowedError';
+    }
+}
+export class MediaNotFoundError extends Error {
+    code = 'E_MEDIA_RECORD_NOT_FOUND';
+    constructor(id) {
+        super(`Media record not found: ${id}`);
+        this.name = 'MediaNotFoundError';
+    }
+}
+export class ConversionNotDefinedError extends Error {
+    code = 'E_MEDIA_CONVERSION_NOT_DEFINED';
+    constructor(collection, conversion) {
+        super(`Conversion "${conversion}" is not defined for collection "${collection}"`);
+        this.name = 'ConversionNotDefinedError';
+    }
+}
+export class ImageProcessorMissingError extends Error {
+    code = 'E_MEDIA_IMAGE_PROCESSOR_MISSING';
+    constructor() {
+        super('No ImageProcessor was configured; conversions are unavailable');
+        this.name = 'ImageProcessorMissingError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,YAAY,UAAkB,EAAE,QAAgB;QAC9C,KAAK,CAAC,cAAc,QAAQ,mCAAmC,UAAU,GAAG,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,0BAA0B,CAAC;IAC3C,YAAY,EAAU;QACpB,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,GAAG,gCAAgC,CAAC;IACjD,YAAY,UAAkB,EAAE,UAAkB;QAChD,KAAK,CAAC,eAAe,UAAU,oCAAoC,UAAU,GAAG,CAAC,CAAC;QAClF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,iCAAiC,CAAC;IAClD;QACE,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF"}

package/dist/src/image_processor.d.ts

@@ -0,0 +1,21 @@
+export interface ConversionPreset {
+    name: string;
+    width?: number;
+    height?: number;
+    fit?: 'cover' | 'contain' | 'fill' | 'inside' | 'outside';
+    format?: 'jpeg' | 'png' | 'webp' | 'avif';
+    quality?: number;
+    /** Generate eagerly on attach instead of lazily on first access. */
+    eager?: boolean;
+}
+export interface ConversionResult {
+    data: Buffer;
+    /** Actual output format/extension (e.g. `webp`). */
+    format: string;
+    contentType: string;
+}
+/** Pluggable image transform engine (default impl: `@adonis-agora/media/processors/sharp`). */
+export interface ImageProcessor {
+    convert(input: Buffer, preset: ConversionPreset): Promise<ConversionResult>;
+}
+//# sourceMappingURL=image_processor.d.ts.map

package/dist/src/image_processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image_processor.d.ts","sourceRoot":"","sources":["../../src/image_processor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC1D,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC7E"}

package/dist/src/image_processor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=image_processor.js.map

package/dist/src/image_processor.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,20 @@
+export { defineConfig, stores, processors } from './define_config.js';
+export type { MediaConfig, StoreContext, StoreFactory, LucidStoreConfig, MemoryStoreConfig, ImageProcessorFactory, } from './define_config.js';
+export { MediaManager } from './media_manager.js';
+export type { MediaManagerOptions } from './media_manager.js';
+export { MediaLibrary } from './media_library.js';
+export type { MediaLibraryOptions, AttachInput, OwnerMediaBinding } from './media_library.js';
+export { Attachment, AttachmentManager, } from './attachment.js';
+export type { AttachmentData, AttachmentVariant, AttachmentManagerOptions, CreateAttachmentInput, CreateAttachmentOptions, } from './attachment.js';
+export { StorageManager } from './storage_manager.js';
+export type { StorageManagerOptions } from './storage_manager.js';
+export type { MediaRecord, MediaConversion } from './media_record.js';
+export type { MediaStore } from './media_store.js';
+export { MediaCollectionRegistry } from './media_collection.js';
+export type { MediaCollectionConfig } from './media_collection.js';
+export type { ConversionPreset, ConversionResult, ImageProcessor } from './image_processor.js';
+export type { Disk, DiskResolver, DiskWriteOptions, DiskMetaData, SignedUrlOptions, } from './types.js';
+export { publishMedia } from './diagnostics.js';
+export type { MediaDiagnosticEvent, MediaDiagnosticPayloads, AttachPayload, DeletePayload, ConversionPayload, AttachmentCreatePayload, AttachmentDeletePayload, } from './diagnostics.js';
+export { MimeNotAllowedError, MediaNotFoundError, ConversionNotDefinedError, ImageProcessorMissingError, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EACL,UAAU,EACV,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC/F,YAAY,EACV,IAAI,EACJ,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,13 @@
+// Config idiom
+export { defineConfig, stores, processors } from './define_config.js';
+// Manager + layers
+export { MediaManager } from './media_manager.js';
+export { MediaLibrary } from './media_library.js';
+export { Attachment, AttachmentManager, } from './attachment.js';
+export { StorageManager } from './storage_manager.js';
+export { MediaCollectionRegistry } from './media_collection.js';
+// Diagnostics
+export { publishMedia } from './diagnostics.js';
+// Errors
+export { MimeNotAllowedError, MediaNotFoundError, ConversionNotDefinedError, ImageProcessorMissingError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAUtE,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EACL,UAAU,EACV,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAMtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAWhE,cAAc;AACd,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAWhD,SAAS;AACT,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAC"}

package/dist/src/media_collection.d.ts

@@ -0,0 +1,19 @@
+import type { ConversionPreset } from './image_processor.js';
+export interface MediaCollectionConfig {
+    name: string;
+    /** Single-file collection: attaching replaces any existing media. */
+    single?: boolean;
+    /** Target disk for this collection (defaults to the storage default disk). */
+    disk?: string;
+    /** Allowed MIME types; when set, other types are rejected on attach. */
+    acceptsMimeTypes?: string[];
+    /** Image conversion presets available for this collection. */
+    conversions?: ConversionPreset[];
+}
+export declare class MediaCollectionRegistry {
+    private readonly map;
+    constructor(collections?: MediaCollectionConfig[]);
+    /** Registered config for a collection, or a permissive default. */
+    get(name: string): MediaCollectionConfig;
+}
+//# sourceMappingURL=media_collection.d.ts.map

package/dist/src/media_collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_collection.d.ts","sourceRoot":"","sources":["../../src/media_collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA4C;gBAEpD,WAAW,GAAE,qBAAqB,EAAO;IAIrD,mEAAmE;IACnE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB;CAGzC"}

package/dist/src/media_collection.js

@@ -0,0 +1,12 @@
+export class MediaCollectionRegistry {
+    map = new Map();
+    constructor(collections = []) {
+        for (const c of collections)
+            this.map.set(c.name, c);
+    }
+    /** Registered config for a collection, or a permissive default. */
+    get(name) {
+        return this.map.get(name) ?? { name };
+    }
+}
+//# sourceMappingURL=media_collection.js.map

package/dist/src/media_collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_collection.js","sourceRoot":"","sources":["../../src/media_collection.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,uBAAuB;IACjB,GAAG,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEhE,YAAY,cAAuC,EAAE;QACnD,KAAK,MAAM,CAAC,IAAI,WAAW;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,mEAAmE;IACnE,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/src/media_library.d.ts

@@ -0,0 +1,71 @@
+import type { Readable } from 'node:stream';
+import type { ImageProcessor } from './image_processor.js';
+import { type MediaCollectionConfig } from './media_collection.js';
+import type { MediaRecord } from './media_record.js';
+import type { MediaStore } from './media_store.js';
+import type { StorageManager } from './storage_manager.js';
+export interface MediaLibraryOptions {
+    storage: StorageManager;
+    store: MediaStore;
+    collections?: MediaCollectionConfig[];
+    /** Engine for image conversions. Required only if collections define conversions. */
+    imageProcessor?: ImageProcessor;
+    /** Emit `agora:media:*` diagnostics events (default true). */
+    emitDiagnostics?: boolean;
+    /** Injectable for deterministic tests. Defaults to `randomUUID`. */
+    idGenerator?: () => string;
+    /** Injectable for deterministic tests. Defaults to `() => new Date()`. */
+    clock?: () => Date;
+}
+export interface AttachInput {
+    ownerType: string;
+    ownerId: string;
+    collection: string;
+    fileName: string;
+    mimeType: string;
+    contents: Buffer | Readable;
+    /** Known byte size; when omitted it is read back from the disk after writing. */
+    size?: number;
+    name?: string;
+    customProperties?: Record<string, unknown>;
+    /** Disk override (else collection disk, else storage default). */
+    disk?: string;
+}
+/**
+ * An owning entity bound to the library, so collection operations don't repeat
+ * `ownerType`/`ownerId`. Obtained from {@link MediaLibrary.for}.
+ */
+export interface OwnerMediaBinding {
+    attach(input: Omit<AttachInput, 'ownerType' | 'ownerId'>): Promise<MediaRecord>;
+    list(collection?: string): Promise<MediaRecord[]>;
+}
+export declare class MediaLibrary {
+    private readonly storage;
+    private readonly store;
+    private readonly collections;
+    private readonly imageProcessor;
+    private readonly emitDiagnostics;
+    private readonly newId;
+    private readonly now;
+    constructor(options: MediaLibraryOptions);
+    private emit;
+    attach(input: AttachInput): Promise<MediaRecord>;
+    /** Generate (if absent) and persist a named conversion; returns the updated record. Lazy entry point. */
+    ensureConversion(id: string, conversionName: string): Promise<MediaRecord>;
+    list(ownerType: string, ownerId: string, collection?: string): Promise<MediaRecord[]>;
+    find(id: string): Promise<MediaRecord | null>;
+    /**
+     * Bind an owning entity so collection operations don't repeat its type/id:
+     * `const m = media.library.for('Post', post.id); await m.attach({ collection, ... })`.
+     */
+    for(ownerType: string, ownerId: string | number): OwnerMediaBinding;
+    delete(id: string): Promise<void>;
+    /**
+     * Public URL for a media record or one of its conversions. When a conversion is
+     * requested and not yet generated, it is produced lazily (and cached) first.
+     */
+    url(id: string, conversion?: string): Promise<string>;
+    /** Signed, expiring URL for a media record or one of its conversions. */
+    signedUrl(id: string, expiresIn: string | number, conversion?: string): Promise<string>;
+}
+//# sourceMappingURL=media_library.d.ts.map

package/dist/src/media_library.d.ts.map

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

package/dist/src/media_library.js

@@ -0,0 +1,176 @@
+import { randomUUID } from 'node:crypto';
+import { asBuffer, toBytes } from './contents.js';
+import { publishMedia } from './diagnostics.js';
+import { ConversionNotDefinedError, ImageProcessorMissingError, MediaNotFoundError, MimeNotAllowedError, } from './errors.js';
+import { MediaCollectionRegistry } from './media_collection.js';
+export class MediaLibrary {
+    storage;
+    store;
+    collections;
+    imageProcessor;
+    emitDiagnostics;
+    newId;
+    now;
+    constructor(options) {
+        this.storage = options.storage;
+        this.store = options.store;
+        this.collections = new MediaCollectionRegistry(options.collections ?? []);
+        this.imageProcessor = options.imageProcessor;
+        this.emitDiagnostics = options.emitDiagnostics ?? true;
+        this.newId = options.idGenerator ?? (() => randomUUID());
+        this.now = options.clock ?? (() => new Date());
+    }
+    emit(event, payload) {
+        if (this.emitDiagnostics)
+            publishMedia(event, payload);
+    }
+    async attach(input) {
+        const config = this.collections.get(input.collection);
+        if (config.acceptsMimeTypes && !config.acceptsMimeTypes.includes(input.mimeType)) {
+            throw new MimeNotAllowedError(input.collection, input.mimeType);
+        }
+        // A single-file collection replaces whatever is already there.
+        if (config.single) {
+            const existing = await this.store.listByOwner(input.ownerType, input.ownerId, input.collection);
+            for (const record of existing)
+                await this.delete(record.id);
+        }
+        const disk = input.disk ?? config.disk ?? this.storage.defaultDisk;
+        const id = this.newId();
+        const path = `${input.ownerType}/${input.ownerId}/${input.collection}/${id}/${input.fileName}`;
+        const bytes = await toBytes(input.contents);
+        await this.storage.disk(disk).put(path, bytes, { contentType: input.mimeType });
+        const size = input.size ?? (await this.storage.disk(disk).getMetaData(path)).contentLength;
+        const order = await this.store.nextOrder(input.ownerType, input.ownerId, input.collection);
+        const timestamp = this.now();
+        const saved = await this.store.save({
+            id,
+            ownerType: input.ownerType,
+            ownerId: input.ownerId,
+            collection: input.collection,
+            name: input.name ?? stripExtension(input.fileName),
+            fileName: input.fileName,
+            mimeType: input.mimeType,
+            size,
+            disk,
+            path,
+            order,
+            customProperties: input.customProperties ?? {},
+            conversions: {},
+            createdAt: timestamp,
+            updatedAt: timestamp,
+        });
+        this.emit('attach', {
+            id: saved.id,
+            ownerType: saved.ownerType,
+            ownerId: saved.ownerId,
+            collection: saved.collection,
+            disk: saved.disk,
+            path: saved.path,
+            size: saved.size,
+            mimeType: saved.mimeType,
+        });
+        // Eager presets are generated synchronously on attach; lazy ones on first `url()`.
+        const eager = (config.conversions ?? []).filter((p) => p.eager);
+        if (eager.length === 0)
+            return saved;
+        let current = saved;
+        for (const preset of eager)
+            current = await this.ensureConversion(saved.id, preset.name);
+        return current;
+    }
+    /** Generate (if absent) and persist a named conversion; returns the updated record. Lazy entry point. */
+    async ensureConversion(id, conversionName) {
+        const record = await this.store.find(id);
+        if (!record)
+            throw new MediaNotFoundError(id);
+        if (record.conversions[conversionName])
+            return record;
+        const preset = (this.collections.get(record.collection).conversions ?? []).find((p) => p.name === conversionName);
+        if (!preset)
+            throw new ConversionNotDefinedError(record.collection, conversionName);
+        if (!this.imageProcessor)
+            throw new ImageProcessorMissingError();
+        const original = asBuffer(await this.storage.disk(record.disk).getBytes(record.path));
+        const result = await this.imageProcessor.convert(original, preset);
+        const dir = record.path.slice(0, record.path.lastIndexOf('/'));
+        const conversionPath = `${dir}/conversions/${conversionName}.${result.format}`;
+        await this.storage.disk(record.disk).put(conversionPath, result.data, {
+            contentType: result.contentType,
+        });
+        const updated = await this.store.save({
+            ...record,
+            conversions: {
+                ...record.conversions,
+                [conversionName]: { path: conversionPath, disk: record.disk },
+            },
+            updatedAt: this.now(),
+        });
+        this.emit('conversion', { id, conversion: conversionName, path: conversionPath });
+        return updated;
+    }
+    list(ownerType, ownerId, collection) {
+        return this.store.listByOwner(ownerType, ownerId, collection);
+    }
+    find(id) {
+        return this.store.find(id);
+    }
+    /**
+     * Bind an owning entity so collection operations don't repeat its type/id:
+     * `const m = media.library.for('Post', post.id); await m.attach({ collection, ... })`.
+     */
+    for(ownerType, ownerId) {
+        const ownerId_ = String(ownerId);
+        return {
+            attach: (input) => this.attach({ ...input, ownerType, ownerId: ownerId_ }),
+            list: (collection) => this.list(ownerType, ownerId_, collection),
+        };
+    }
+    async delete(id) {
+        const record = await this.store.find(id);
+        if (!record)
+            return;
+        await this.storage.disk(record.disk).delete(record.path);
+        for (const conversion of Object.values(record.conversions)) {
+            await this.storage.disk(conversion.disk).delete(conversion.path);
+        }
+        await this.store.delete(id);
+        this.emit('delete', { id, ownerType: record.ownerType, ownerId: record.ownerId });
+    }
+    /**
+     * Public URL for a media record or one of its conversions. When a conversion is
+     * requested and not yet generated, it is produced lazily (and cached) first.
+     */
+    async url(id, conversion) {
+        if (conversion) {
+            const record = await this.ensureConversion(id, conversion);
+            const variant = record.conversions[conversion];
+            if (!variant)
+                throw new MediaNotFoundError(`${id}#${conversion}`);
+            return this.storage.disk(variant.disk).getUrl(variant.path);
+        }
+        const record = await this.store.find(id);
+        if (!record)
+            throw new MediaNotFoundError(id);
+        return this.storage.disk(record.disk).getUrl(record.path);
+    }
+    /** Signed, expiring URL for a media record or one of its conversions. */
+    async signedUrl(id, expiresIn, conversion) {
+        if (conversion) {
+            const record = await this.ensureConversion(id, conversion);
+            const variant = record.conversions[conversion];
+            if (!variant)
+                throw new MediaNotFoundError(`${id}#${conversion}`);
+            return this.storage.disk(variant.disk).getSignedUrl(variant.path, { expiresIn });
+        }
+        const record = await this.store.find(id);
+        if (!record)
+            throw new MediaNotFoundError(id);
+        return this.storage.disk(record.disk).getSignedUrl(record.path, { expiresIn });
+    }
+}
+function stripExtension(fileName) {
+    const dot = fileName.lastIndexOf('.');
+    return dot > 0 ? fileName.slice(0, dot) : fileName;
+}
+//# sourceMappingURL=media_library.js.map

package/dist/src/media_library.js.map

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

package/dist/src/media_manager.d.ts

@@ -0,0 +1,38 @@
+import { AttachmentManager } from './attachment.js';
+import type { ImageProcessor } from './image_processor.js';
+import type { MediaCollectionConfig } from './media_collection.js';
+import { MediaLibrary } from './media_library.js';
+import type { MediaStore } from './media_store.js';
+import { StorageManager } from './storage_manager.js';
+import type { DiskResolver } from './types.js';
+export interface MediaManagerOptions {
+    /** Default disk name (resolved by `resolve`). */
+    defaultDisk: string;
+    /** Resolves a disk by name — `(name) => drive.use(name)` in production. */
+    resolve: DiskResolver;
+    store: MediaStore;
+    imageProcessor?: ImageProcessor;
+    collections?: MediaCollectionConfig[];
+    attachmentKeyPrefix?: string;
+    emitDiagnostics?: boolean;
+}
+/**
+ * The singleton bound into the AdonisJS container as `MediaManager`. Composes the two layers over a
+ * shared {@link StorageManager}: {@link MediaLibrary} (owner collections + conversions) and
+ * {@link AttachmentManager} (column attachments).
+ *
+ * ```ts
+ * const media = await app.container.make(MediaManager)
+ * await media.library.attach({ ownerType: 'Post', ownerId: '1', collection: 'gallery', ... })
+ * const att = await media.attachments.createFromFile({ fileName, mimeType, contents })
+ * ```
+ */
+export declare class MediaManager {
+    readonly storage: StorageManager;
+    readonly library: MediaLibrary;
+    readonly attachments: AttachmentManager;
+    constructor(options: MediaManagerOptions);
+    /** Resolve a raw disk by name (escape hatch to the underlying Drive disk). */
+    disk(name?: string): import("./types.js").Disk;
+}
+//# sourceMappingURL=media_manager.d.ts.map

package/dist/src/media_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_manager.d.ts","sourceRoot":"","sources":["../../src/media_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;gBAE5B,OAAO,EAAE,mBAAmB;IAuBxC,8EAA8E;IAC9E,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM;CAGnB"}

package/dist/src/media_manager.js

@@ -0,0 +1,46 @@
+import { AttachmentManager } from './attachment.js';
+import { MediaLibrary } from './media_library.js';
+import { StorageManager } from './storage_manager.js';
+/**
+ * The singleton bound into the AdonisJS container as `MediaManager`. Composes the two layers over a
+ * shared {@link StorageManager}: {@link MediaLibrary} (owner collections + conversions) and
+ * {@link AttachmentManager} (column attachments).
+ *
+ * ```ts
+ * const media = await app.container.make(MediaManager)
+ * await media.library.attach({ ownerType: 'Post', ownerId: '1', collection: 'gallery', ... })
+ * const att = await media.attachments.createFromFile({ fileName, mimeType, contents })
+ * ```
+ */
+export class MediaManager {
+    storage;
+    library;
+    attachments;
+    constructor(options) {
+        this.storage = new StorageManager({ default: options.defaultDisk, resolve: options.resolve });
+        this.library = new MediaLibrary({
+            storage: this.storage,
+            store: options.store,
+            ...(options.collections !== undefined ? { collections: options.collections } : {}),
+            ...(options.imageProcessor !== undefined ? { imageProcessor: options.imageProcessor } : {}),
+            ...(options.emitDiagnostics !== undefined
+                ? { emitDiagnostics: options.emitDiagnostics }
+                : {}),
+        });
+        this.attachments = new AttachmentManager({
+            storage: this.storage,
+            ...(options.imageProcessor !== undefined ? { imageProcessor: options.imageProcessor } : {}),
+            ...(options.attachmentKeyPrefix !== undefined
+                ? { keyPrefix: options.attachmentKeyPrefix }
+                : {}),
+            ...(options.emitDiagnostics !== undefined
+                ? { emitDiagnostics: options.emitDiagnostics }
+                : {}),
+        });
+    }
+    /** Resolve a raw disk by name (escape hatch to the underlying Drive disk). */
+    disk(name) {
+        return this.storage.disk(name);
+    }
+}
+//# sourceMappingURL=media_manager.js.map

package/dist/src/media_manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_manager.js","sourceRoot":"","sources":["../../src/media_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAetD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,YAAY;IACd,OAAO,CAAiB;IACxB,OAAO,CAAe;IACtB,WAAW,CAAoB;IAExC,YAAY,OAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9F,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC;YAC9B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,GAAG,IAAI,iBAAiB,CAAC;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,CAAC,mBAAmB,KAAK,SAAS;gBAC3C,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,mBAAmB,EAAE;gBAC5C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,IAAI,CAAC,IAAa;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/src/media_record.d.ts

@@ -0,0 +1,25 @@
+export interface MediaConversion {
+    path: string;
+    disk: string;
+}
+/** A stored file associated with an owning entity (spatie media-library style). */
+export interface MediaRecord {
+    id: string;
+    ownerType: string;
+    ownerId: string;
+    collection: string;
+    /** Logical display name (defaults to the file name without extension). */
+    name: string;
+    fileName: string;
+    mimeType: string;
+    size: number;
+    disk: string;
+    path: string;
+    order: number;
+    customProperties: Record<string, unknown>;
+    /** Generated variants keyed by conversion name (e.g. `thumb`). */
+    conversions: Record<string, MediaConversion>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=media_record.d.ts.map

package/dist/src/media_record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_record.d.ts","sourceRoot":"","sources":["../../src/media_record.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB"}

package/dist/src/media_record.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=media_record.js.map

package/dist/src/media_record.js.map

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

package/dist/src/media_store.d.ts

@@ -0,0 +1,16 @@
+import type { MediaRecord } from './media_record.js';
+/**
+ * Persistence SPI for media records. Implemented per backend as a POJO that receives
+ * its connection in the constructor. Ships with an in-memory driver (`@adonis-agora/media/testing`)
+ * and a Lucid driver (`@adonis-agora/media/stores/lucid`).
+ */
+export interface MediaStore {
+    save(record: MediaRecord): Promise<MediaRecord>;
+    find(id: string): Promise<MediaRecord | null>;
+    /** Records for an owner, optionally a single collection, ordered by `order` asc. */
+    listByOwner(ownerType: string, ownerId: string, collection?: string): Promise<MediaRecord[]>;
+    delete(id: string): Promise<void>;
+    /** Next `order` value for appending to a collection (0-based). */
+    nextOrder(ownerType: string, ownerId: string, collection: string): Promise<number>;
+}
+//# sourceMappingURL=media_store.d.ts.map

package/dist/src/media_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_store.d.ts","sourceRoot":"","sources":["../../src/media_store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9C,oFAAoF;IACpF,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,kEAAkE;IAClE,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpF"}

package/dist/src/media_store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=media_store.js.map

package/dist/src/media_store.js.map

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

package/dist/src/processors/factory.d.ts

@@ -0,0 +1,22 @@
+import type { ImageProcessor } from '../image_processor.js';
+/**
+ * A configured image processor: a lazy thunk the media provider calls at boot. The sharp factory
+ * imports `sharp` only inside the thunk, so the heavy peer is loaded only when selected.
+ */
+export type ImageProcessorFactory = () => Promise<ImageProcessor>;
+/**
+ * The image-processor factory namespace used in `config/media.ts`:
+ *
+ * ```ts
+ * import { defineConfig, processors } from '@adonis-agora/media'
+ *
+ * export default defineConfig({
+ *   imageProcessor: processors.sharp(),
+ * })
+ * ```
+ */
+export declare const processors: {
+    /** sharp-backed resize/crop/format/quality (needs the optional `sharp` peer). */
+    sharp(): ImageProcessorFactory;
+};
+//# sourceMappingURL=factory.d.ts.map

package/dist/src/processors/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/processors/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;AAElE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU;IACrB,iFAAiF;aACxE,qBAAqB;CAM/B,CAAC"}