@adonis-agora/media 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Davi Carvalho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/configure.d.ts

@@ -0,0 +1,13 @@
+import type Configure from '@adonisjs/core/commands/configure';
+/**
+ * `node ace configure @adonis-agora/media` — auto-wires the package:
+ *
+ * 1. registers the media service provider in `adonisrc.ts`;
+ * 2. publishes `config/media.ts`;
+ * 3. publishes the Lucid migration for the optional `lucid` store (run
+ *    `node ace migration:run`; delete it if you only use the in-memory store).
+ *
+ * Requires `@adonisjs/drive` to be installed and configured first (`node ace add @adonisjs/drive`).
+ */
+export declare function configure(command: Configure): Promise<void>;
+//# sourceMappingURL=configure.d.ts.map

package/dist/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAG/D;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBASjD"}

package/dist/configure.js

@@ -0,0 +1,20 @@
+import { stubsRoot } from './stubs/main.js';
+/**
+ * `node ace configure @adonis-agora/media` — auto-wires the package:
+ *
+ * 1. registers the media service provider in `adonisrc.ts`;
+ * 2. publishes `config/media.ts`;
+ * 3. publishes the Lucid migration for the optional `lucid` store (run
+ *    `node ace migration:run`; delete it if you only use the in-memory store).
+ *
+ * Requires `@adonisjs/drive` to be installed and configured first (`node ace add @adonisjs/drive`).
+ */
+export async function configure(command) {
+    const codemods = await command.createCodemods();
+    await codemods.updateRcFile((rcFile) => {
+        rcFile.addProvider('@adonis-agora/media/media_provider');
+    });
+    await codemods.makeUsingStub(stubsRoot, 'config/media.stub', {});
+    await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_media_table.stub', {});
+}
+//# sourceMappingURL=configure.js.map

package/dist/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,6CAA6C,EAAE,EAAE,CAAC,CAAC;AAC7F,CAAC"}

package/dist/providers/media_provider.d.ts

@@ -0,0 +1,20 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/**
+ * Wires `@adonis-agora/media` into the AdonisJS application: binds a singleton {@link MediaManager}
+ * built from `config/media.ts`. Storage is delegated to `@adonisjs/drive` — the manager resolves disks
+ * from the booted Drive manager, so this package never reimplements disk drivers. The selected store
+ * (`memory` / `lucid`) and image processor (`processors.sharp()`) are built lazily from the config so
+ * their peer dependencies (`@adonisjs/lucid`, `sharp`) load only when chosen.
+ *
+ * ```ts
+ * const media = await app.container.make(MediaManager)
+ * await media.library.attach({ ownerType: 'Post', ownerId: '1', collection: 'gallery', ... })
+ * ```
+ */
+export default class MediaProvider {
+    #private;
+    protected app: ApplicationService;
+    constructor(app: ApplicationService);
+    register(): void;
+}
+//# sourceMappingURL=media_provider.d.ts.map

package/dist/providers/media_provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_provider.d.ts","sourceRoot":"","sources":["../../providers/media_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAY/D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;;IACpB,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,QAAQ;CAuDT"}

package/dist/providers/media_provider.js

@@ -0,0 +1,71 @@
+import { MediaManager } from '../src/media_manager.js';
+/**
+ * Wires `@adonis-agora/media` into the AdonisJS application: binds a singleton {@link MediaManager}
+ * built from `config/media.ts`. Storage is delegated to `@adonisjs/drive` — the manager resolves disks
+ * from the booted Drive manager, so this package never reimplements disk drivers. The selected store
+ * (`memory` / `lucid`) and image processor (`processors.sharp()`) are built lazily from the config so
+ * their peer dependencies (`@adonisjs/lucid`, `sharp`) load only when chosen.
+ *
+ * ```ts
+ * const media = await app.container.make(MediaManager)
+ * await media.library.attach({ ownerType: 'Post', ownerId: '1', collection: 'gallery', ... })
+ * ```
+ */
+export default class MediaProvider {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    register() {
+        this.app.container.singleton(MediaManager, async () => {
+            const config = this.app.config.get('media', {});
+            // Resolve disks from Drive without a hard dependency: import its service lazily. The Drive
+            // disk satisfies our structural `Disk` (getBytes/put/getUrl/...); cast via `unknown` because
+            // Drive's full surface is wider than the subset we use.
+            const drive = (await import('@adonisjs/drive/services/main'))
+                .default;
+            const resolve = (name) => drive.use(name);
+            const ctx = { app: this.app };
+            const store = await this.#resolveStore(config, ctx);
+            const imageProcessor = await this.#resolveImageProcessor(config);
+            const defaultDisk = config.disk ?? (await this.#resolveDefaultDiskName());
+            return new MediaManager({
+                defaultDisk,
+                resolve,
+                store,
+                ...(imageProcessor !== undefined ? { imageProcessor } : {}),
+                ...(config.collections !== undefined ? { collections: config.collections } : {}),
+                ...(config.attachmentKeyPrefix !== undefined
+                    ? { attachmentKeyPrefix: config.attachmentKeyPrefix }
+                    : {}),
+                ...(config.emitDiagnostics !== undefined
+                    ? { emitDiagnostics: config.emitDiagnostics }
+                    : {}),
+            });
+        });
+    }
+    /** Build the configured store; defaults to the in-memory store when none is selected. */
+    async #resolveStore(config, ctx) {
+        const name = config.store;
+        if (name && config.stores?.[name]) {
+            return config.stores[name](ctx);
+        }
+        const { InMemoryMediaStore } = await import('../src/testing/in_memory_media_store.js');
+        return new InMemoryMediaStore();
+    }
+    /** A config `imageProcessor` may be a ready instance or a lazy factory thunk. */
+    async #resolveImageProcessor(config) {
+        const ip = config.imageProcessor;
+        if (!ip)
+            return undefined;
+        if (typeof ip === 'function')
+            return ip();
+        return ip;
+    }
+    /** When the config doesn't name a disk, fall back to Drive's configured default disk name. */
+    async #resolveDefaultDiskName() {
+        const driveConfig = this.app.config.get('drive', {});
+        return driveConfig.default ?? 'default';
+    }
+}
+//# sourceMappingURL=media_provider.js.map

package/dist/providers/media_provider.js.map

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

package/dist/src/attachment.d.ts

@@ -0,0 +1,83 @@
+import type { Readable } from 'node:stream';
+import type { ConversionPreset, ImageProcessor } from './image_processor.js';
+import type { StorageManager } from './storage_manager.js';
+export interface AttachmentVariant {
+    disk: string;
+    path: string;
+    size: number;
+    mimeType: string;
+}
+/** Plain, JSON-serializable shape stored in a model column. */
+export interface AttachmentData {
+    name: string;
+    disk: string;
+    path: string;
+    size: number;
+    mimeType: string;
+    variants: Record<string, AttachmentVariant>;
+    meta: Record<string, unknown>;
+}
+/**
+ * A file attached to a model as a column value (adonis-attachment style). Pure value
+ * object — it carries disk + path + variant metadata and serializes to JSON. URL
+ * resolution and deletion go through {@link AttachmentManager} (which holds the disks).
+ */
+export declare class Attachment {
+    readonly name: string;
+    readonly disk: string;
+    readonly path: string;
+    readonly size: number;
+    readonly mimeType: string;
+    readonly variants: Record<string, AttachmentVariant>;
+    readonly meta: Record<string, unknown>;
+    constructor(data: AttachmentData);
+    toJSON(): AttachmentData;
+    /** Rebuild from a stored column value; returns null for null/undefined. */
+    static fromJSON(json: AttachmentData | null | undefined): Attachment | null;
+}
+export interface CreateAttachmentInput {
+    fileName: string;
+    mimeType: string;
+    contents: Buffer | Readable;
+    size?: number;
+}
+export interface CreateAttachmentOptions {
+    disk?: string;
+    /** Key prefix on the disk. Default `attachments`. */
+    keyPrefix?: string;
+    /** Image variants to generate eagerly (needs an ImageProcessor). */
+    variants?: ConversionPreset[];
+    /** Display name override (defaults to the file name). */
+    name?: string;
+    meta?: Record<string, unknown>;
+}
+export interface AttachmentManagerOptions {
+    storage: StorageManager;
+    imageProcessor?: ImageProcessor;
+    keyPrefix?: string;
+    idGenerator?: () => string;
+    /** Emit `agora:media:attachment.*` diagnostics events (default true). */
+    emitDiagnostics?: boolean;
+}
+/**
+ * Creates and resolves {@link Attachment}s — the adonis-attachment-style API.
+ * `createFromFile` uploads the bytes (and any variants) and returns a value object
+ * you assign to a model column.
+ */
+export declare class AttachmentManager {
+    private readonly storage;
+    private readonly imageProcessor;
+    private readonly keyPrefix;
+    private readonly newId;
+    private readonly emitDiagnostics;
+    constructor(options: AttachmentManagerOptions);
+    createFromFile(input: CreateAttachmentInput, options?: CreateAttachmentOptions): Promise<Attachment>;
+    /** Public URL for the attachment, or a named variant. */
+    url(attachment: Attachment, variant?: string): Promise<string>;
+    /** Signed, expiring URL (presign-capable disks). */
+    signedUrl(attachment: Attachment, expiresIn: string | number, variant?: string): Promise<string>;
+    /** Remove the attachment and all its variants from storage. */
+    delete(attachment: Attachment): Promise<void>;
+    private resolve;
+}
+//# sourceMappingURL=attachment.d.ts.map

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

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

package/dist/src/attachment.js

@@ -0,0 +1,144 @@
+import { randomUUID } from 'node:crypto';
+import { asBuffer, toBytes } from './contents.js';
+import { publishMedia } from './diagnostics.js';
+/**
+ * A file attached to a model as a column value (adonis-attachment style). Pure value
+ * object — it carries disk + path + variant metadata and serializes to JSON. URL
+ * resolution and deletion go through {@link AttachmentManager} (which holds the disks).
+ */
+export class Attachment {
+    name;
+    disk;
+    path;
+    size;
+    mimeType;
+    variants;
+    meta;
+    constructor(data) {
+        this.name = data.name;
+        this.disk = data.disk;
+        this.path = data.path;
+        this.size = data.size;
+        this.mimeType = data.mimeType;
+        this.variants = data.variants;
+        this.meta = data.meta;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            disk: this.disk,
+            path: this.path,
+            size: this.size,
+            mimeType: this.mimeType,
+            variants: this.variants,
+            meta: this.meta,
+        };
+    }
+    /** Rebuild from a stored column value; returns null for null/undefined. */
+    static fromJSON(json) {
+        return json ? new Attachment(json) : null;
+    }
+}
+/**
+ * Creates and resolves {@link Attachment}s — the adonis-attachment-style API.
+ * `createFromFile` uploads the bytes (and any variants) and returns a value object
+ * you assign to a model column.
+ */
+export class AttachmentManager {
+    storage;
+    imageProcessor;
+    keyPrefix;
+    newId;
+    emitDiagnostics;
+    constructor(options) {
+        this.storage = options.storage;
+        this.imageProcessor = options.imageProcessor;
+        this.keyPrefix = options.keyPrefix ?? 'attachments';
+        this.newId = options.idGenerator ?? (() => randomUUID());
+        this.emitDiagnostics = options.emitDiagnostics ?? true;
+    }
+    async createFromFile(input, options = {}) {
+        const disk = options.disk ?? this.storage.defaultDisk;
+        const prefix = options.keyPrefix ?? this.keyPrefix;
+        const id = this.newId();
+        const dir = `${prefix}/${id}`;
+        const path = `${dir}/${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 variants = {};
+        const presets = options.variants ?? [];
+        if (presets.length > 0) {
+            if (!this.imageProcessor) {
+                throw new Error('AttachmentManager: variants requested but no ImageProcessor was configured');
+            }
+            const original = asBuffer(await this.storage.disk(disk).getBytes(path));
+            for (const preset of presets) {
+                const result = await this.imageProcessor.convert(original, preset);
+                const variantPath = `${dir}/variants/${preset.name}.${result.format}`;
+                await this.storage.disk(disk).put(variantPath, result.data, {
+                    contentType: result.contentType,
+                });
+                variants[preset.name] = {
+                    disk,
+                    path: variantPath,
+                    size: result.data.byteLength,
+                    mimeType: result.contentType,
+                };
+            }
+        }
+        const attachment = new Attachment({
+            name: options.name ?? input.fileName,
+            disk,
+            path,
+            size,
+            mimeType: input.mimeType,
+            variants,
+            meta: options.meta ?? {},
+        });
+        if (this.emitDiagnostics) {
+            publishMedia('attachment.create', {
+                disk,
+                path,
+                size,
+                mimeType: attachment.mimeType,
+                name: attachment.name,
+                variants: Object.keys(variants),
+            });
+        }
+        return attachment;
+    }
+    /** Public URL for the attachment, or a named variant. */
+    async url(attachment, variant) {
+        const target = this.resolve(attachment, variant);
+        return this.storage.disk(target.disk).getUrl(target.path);
+    }
+    /** Signed, expiring URL (presign-capable disks). */
+    async signedUrl(attachment, expiresIn, variant) {
+        const target = this.resolve(attachment, variant);
+        return this.storage.disk(target.disk).getSignedUrl(target.path, { expiresIn });
+    }
+    /** Remove the attachment and all its variants from storage. */
+    async delete(attachment) {
+        await this.storage.disk(attachment.disk).delete(attachment.path);
+        for (const variant of Object.values(attachment.variants)) {
+            await this.storage.disk(variant.disk).delete(variant.path);
+        }
+        if (this.emitDiagnostics) {
+            publishMedia('attachment.delete', {
+                disk: attachment.disk,
+                path: attachment.path,
+                variants: Object.keys(attachment.variants),
+            });
+        }
+    }
+    resolve(attachment, variant) {
+        if (!variant)
+            return { disk: attachment.disk, path: attachment.path };
+        const v = attachment.variants[variant];
+        if (!v)
+            throw new Error(`Attachment has no variant "${variant}"`);
+        return { disk: v.disk, path: v.path };
+    }
+}
+//# sourceMappingURL=attachment.js.map

package/dist/src/attachment.js.map

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

package/dist/src/contents.d.ts

@@ -0,0 +1,9 @@
+import type { Readable } from 'node:stream';
+/**
+ * Coerce attach/create inputs (a `Buffer` or a `Readable`) to a `Uint8Array` for the disk's `put`,
+ * which (matching flydrive) does not accept a stream. A `Buffer` is already a `Uint8Array`.
+ */
+export declare function toBytes(contents: Buffer | Readable): Promise<Uint8Array>;
+/** Read back disk bytes as a Node `Buffer` for the image processor (which works on Buffers). */
+export declare function asBuffer(bytes: Uint8Array): Buffer;
+//# sourceMappingURL=contents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contents.d.ts","sourceRoot":"","sources":["../../src/contents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAK9E;AAED,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAElD"}

package/dist/src/contents.js

@@ -0,0 +1,17 @@
+/**
+ * Coerce attach/create inputs (a `Buffer` or a `Readable`) to a `Uint8Array` for the disk's `put`,
+ * which (matching flydrive) does not accept a stream. A `Buffer` is already a `Uint8Array`.
+ */
+export async function toBytes(contents) {
+    if (Buffer.isBuffer(contents))
+        return contents;
+    const chunks = [];
+    for await (const chunk of contents)
+        chunks.push(Buffer.from(chunk));
+    return Buffer.concat(chunks);
+}
+/** Read back disk bytes as a Node `Buffer` for the image processor (which works on Buffers). */
+export function asBuffer(bytes) {
+    return Buffer.isBuffer(bytes) ? bytes : Buffer.from(bytes);
+}
+//# sourceMappingURL=contents.js.map

package/dist/src/contents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.js","sourceRoot":"","sources":["../../src/contents.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAA2B;IACvD,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC/C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,QAAQ,CAAC,KAAiB;IACxC,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC"}

package/dist/src/define_config.d.ts

@@ -0,0 +1,58 @@
+import type { ImageProcessor } from './image_processor.js';
+import type { MediaCollectionConfig } from './media_collection.js';
+import { processors } from './processors/factory.js';
+import type { ImageProcessorFactory } from './processors/factory.js';
+import { stores } from './stores/factory.js';
+import type { LucidStoreConfig, MemoryStoreConfig, StoreContext, StoreFactory } from './stores/factory.js';
+/**
+ * Shape of `config/media.ts`. Storage is delegated to `@adonisjs/drive` — the `disk` is the name of a
+ * disk in your `config/drive.ts`; omit it to use Drive's default disk. Pick a `store` by name from the
+ * `stores` map (built with the {@link stores} factory so each peer is imported lazily). Conversions need
+ * an `imageProcessor` (use `processors.sharp()` for the optional sharp peer, or pass your own instance).
+ *
+ * ```ts
+ * import { defineConfig, stores, processors } from '@adonis-agora/media'
+ *
+ * export default defineConfig({
+ *   disk: 's3',
+ *   store: 'lucid',
+ *   stores: {
+ *     memory: stores.memory(),
+ *     lucid: stores.lucid({ connection: 'pg' }),
+ *   },
+ *   imageProcessor: processors.sharp(),
+ *   collections: [
+ *     { name: 'avatar', single: true, acceptsMimeTypes: ['image/png', 'image/jpeg'] },
+ *     { name: 'gallery', conversions: [{ name: 'thumb', width: 200 }, { name: 'og', width: 1200, eager: true }] },
+ *   ],
+ * })
+ * ```
+ */
+export interface MediaConfig {
+    /**
+     * Name of the `@adonisjs/drive` disk media is written to. Omit to use Drive's default disk. A
+     * collection may override it per-collection, and each `attach` call may override it per-call.
+     */
+    disk?: string;
+    /** Name of the media store (a key of {@link stores}). Defaults to `memory` (single-process). */
+    store?: string;
+    /** Named media stores, built with the {@link stores} factory. */
+    stores?: Record<string, StoreFactory>;
+    /**
+     * The image conversion engine. Either a ready {@link ImageProcessor} instance or an
+     * {@link ImageProcessorFactory} built with the {@link processors} factory (e.g. `processors.sharp()`)
+     * so the heavy peer is imported lazily. Required only if any collection defines conversions.
+     */
+    imageProcessor?: ImageProcessor | ImageProcessorFactory;
+    /** Collection definitions (MIME whitelist, single-file replace, conversions). */
+    collections?: MediaCollectionConfig[];
+    /** Key prefix for column attachments created via the `AttachmentManager`. Default `attachments`. */
+    attachmentKeyPrefix?: string;
+    /** Emit `agora:media:*` diagnostics events (default true). */
+    emitDiagnostics?: boolean;
+}
+/** Identity helper giving `config/media.ts` full type-checking. */
+export declare function defineConfig(config?: MediaConfig): MediaConfig;
+export { stores, processors };
+export type { StoreContext, StoreFactory, LucidStoreConfig, MemoryStoreConfig, ImageProcessorFactory, };
+//# sourceMappingURL=define_config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,GAAG,qBAAqB,CAAC;IACxD,iFAAiF;IACjF,WAAW,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACtC,oGAAoG;IACpG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,MAAM,GAAE,WAAgB,GAAG,WAAW,CAElE;AAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC9B,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,CAAC"}

package/dist/src/define_config.js

@@ -0,0 +1,8 @@
+import { processors } from './processors/factory.js';
+import { stores } from './stores/factory.js';
+/** Identity helper giving `config/media.ts` full type-checking. */
+export function defineConfig(config = {}) {
+    return config;
+}
+export { stores, processors };
+//# sourceMappingURL=define_config.js.map

package/dist/src/define_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAwD7C,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,SAAsB,EAAE;IACnD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC"}

package/dist/src/diagnostics.d.ts

@@ -0,0 +1,49 @@
+export type MediaDiagnosticEvent = 'attach' | 'delete' | 'conversion' | 'attachment.create' | 'attachment.delete';
+export interface AttachPayload {
+    id: string;
+    ownerType: string;
+    ownerId: string;
+    collection: string;
+    disk: string;
+    path: string;
+    size: number;
+    mimeType: string;
+}
+export interface DeletePayload {
+    id: string;
+    ownerType: string;
+    ownerId: string;
+}
+export interface ConversionPayload {
+    id: string;
+    conversion: string;
+    path: string;
+}
+export interface AttachmentCreatePayload {
+    disk: string;
+    path: string;
+    size: number;
+    mimeType: string;
+    name: string;
+    variants: string[];
+}
+export interface AttachmentDeletePayload {
+    disk: string;
+    path: string;
+    variants: string[];
+}
+/** Maps each event to its payload type, so {@link publishMedia} is checked at the call site. */
+export interface MediaDiagnosticPayloads {
+    attach: AttachPayload;
+    delete: DeletePayload;
+    conversion: ConversionPayload;
+    'attachment.create': AttachmentCreatePayload;
+    'attachment.delete': AttachmentDeletePayload;
+}
+/**
+ * Publish a media event on `agora:media:<event>` via the structural diagnostics slot.
+ * No-op when diagnostics isn't installed (the slot is empty) — and it never throws back
+ * into the library.
+ */
+export declare function publishMedia<E extends MediaDiagnosticEvent>(event: E, payload: MediaDiagnosticPayloads[E]): void;
+//# sourceMappingURL=diagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AACD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,gGAAgG;AAChG,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,mBAAmB,EAAE,uBAAuB,CAAC;IAC7C,mBAAmB,EAAE,uBAAuB,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,oBAAoB,EACzD,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,IAAI,CASN"}

package/dist/src/diagnostics.js

@@ -0,0 +1,24 @@
+/**
+ * The `@adonis-agora/diagnostics` emit capability, published on this global slot at that
+ * package's module load. `@adonis-agora/media` reads it STRUCTURALLY — it never imports or
+ * depends on the diagnostics package. When diagnostics isn't installed the slot is empty
+ * and emitting is an inert no-op.
+ */
+const EMIT_SLOT = Symbol.for('@agora/diagnostics:emit');
+/**
+ * Publish a media event on `agora:media:<event>` via the structural diagnostics slot.
+ * No-op when diagnostics isn't installed (the slot is empty) — and it never throws back
+ * into the library.
+ */
+export function publishMedia(event, payload) {
+    const emit = globalThis[EMIT_SLOT];
+    if (typeof emit === 'function') {
+        try {
+            emit('media', event, payload);
+        }
+        catch {
+            // diagnostics must never break a media operation
+        }
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/src/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AAqDxD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAQ,EACR,OAAmC;IAEnC,MAAM,IAAI,GAAI,UAAsC,CAAC,SAAS,CAAuB,CAAC;IACtF,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/errors.d.ts

@@ -0,0 +1,17 @@
+export declare class MimeNotAllowedError extends Error {
+    readonly code = "E_MEDIA_MIME_NOT_ALLOWED";
+    constructor(collection: string, mimeType: string);
+}
+export declare class MediaNotFoundError extends Error {
+    readonly code = "E_MEDIA_RECORD_NOT_FOUND";
+    constructor(id: string);
+}
+export declare class ConversionNotDefinedError extends Error {
+    readonly code = "E_MEDIA_CONVERSION_NOT_DEFINED";
+    constructor(collection: string, conversion: string);
+}
+export declare class ImageProcessorMissingError extends Error {
+    readonly code = "E_MEDIA_IMAGE_PROCESSOR_MISSING";
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAIjD;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,8BAA8B;gBAC/B,EAAE,EAAE,MAAM;CAIvB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,oCAAoC;gBACrC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAInD;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,IAAI,qCAAqC;;CAKnD"}