@adonis-agora/media 0.1.1 → 0.2.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.d.ts","sourceRoot":"","sources":["../../src/multipart.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,mBAAmB,CASjF"}

package/dist/src/multipart.js

@@ -0,0 +1,16 @@
+/**
+ * Structural guard: does this disk implement the optional {@link MultipartUploadDisk} surface?
+ * The base {@link Disk} contract deliberately omits multipart, so the upload layer detects it here
+ * at runtime (the bundled `disks.s3()` disk provides it; the in-memory/Drive disks do not) rather
+ * than depending on it statically. A disk is treated as multipart-capable when it exposes the whole
+ * create/upload/presign/complete/abort surface.
+ */
+export function isMultipartCapable(disk) {
+    const d = disk;
+    return (typeof d.createMultipartUpload === 'function' &&
+        typeof d.presignUploadPart === 'function' &&
+        typeof d.completeMultipartUpload === 'function' &&
+        typeof d.abortMultipartUpload === 'function' &&
+        typeof d.uploadPart === 'function');
+}
+//# sourceMappingURL=multipart.js.map

package/dist/src/multipart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipart.js","sourceRoot":"","sources":["../../src/multipart.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAU;IAC3C,MAAM,CAAC,GAAG,IAAoC,CAAC;IAC/C,OAAO,CACL,OAAO,CAAC,CAAC,qBAAqB,KAAK,UAAU;QAC7C,OAAO,CAAC,CAAC,iBAAiB,KAAK,UAAU;QACzC,OAAO,CAAC,CAAC,uBAAuB,KAAK,UAAU;QAC/C,OAAO,CAAC,CAAC,oBAAoB,KAAK,UAAU;QAC5C,OAAO,CAAC,CAAC,UAAU,KAAK,UAAU,CACnC,CAAC;AACJ,CAAC"}

package/dist/src/resumable_upload.d.ts

@@ -0,0 +1,131 @@
+import type { StorageManager } from './storage_manager.js';
+import type { MultipartPart } from './types.js';
+/**
+ * One in-flight resumable upload. Persisted through an {@link UploadSessionStore} so a dropped
+ * connection resumes from {@link offset} rather than re-sending. Bytes accumulate as temporary
+ * parts on the target disk (native S3 multipart when the disk is multipart-capable, otherwise
+ * buffered part objects) until {@link ResumableUploadManager.complete} assembles the final object.
+ */
+export interface UploadSession {
+    id: string;
+    disk: string;
+    /** Final object key the assembled upload will be written to. */
+    key: string;
+    contentType: string | undefined;
+    /** Total expected size in bytes, if declared up front (TUS `Upload-Length`). */
+    size: number | undefined;
+    /** Bytes received so far — the resume offset. */
+    offset: number;
+    /** Number of chunk parts written so far. */
+    parts: number;
+    /** S3 (or other native-multipart) upload id, when the target disk is multipart-capable. */
+    multipartUploadId?: string;
+    /** When the session was created. */
+    createdAt?: Date;
+    /** When the session expires (TUS `expiration` extension); absent = never expires. */
+    expiresAt?: Date;
+    /** Decoded TUS `Upload-Metadata`, retained for finalization/inspection. */
+    metadata?: Record<string, string>;
+}
+/** Optional filter for {@link UploadSessionStore.list}. */
+export interface UploadSessionListFilter {
+    /** Only sessions on this disk. */
+    disk?: string;
+    /** Only sessions whose `key` starts with this prefix. */
+    keyPrefix?: string;
+}
+/**
+ * Persistence SPI for resumable upload sessions. Ships with an in-memory driver
+ * (`@adonis-agora/media/testing`) and a Lucid driver (`@adonis-agora/media/upload_sessions/lucid`),
+ * mirroring the {@link MediaStore} pattern. `addPart`/`listParts` are optional and only needed when
+ * the target disk is multipart-capable (they record the S3 part ETags for finalization).
+ */
+export interface UploadSessionStore {
+    create(session: UploadSession): Promise<UploadSession>;
+    get(id: string): Promise<UploadSession | null>;
+    update(session: UploadSession): Promise<UploadSession>;
+    delete(id: string): Promise<void>;
+    /** Record one part's ETag, keyed by partNumber (multipart-capable disks only). */
+    addPart?(id: string, part: MultipartPart): Promise<void>;
+    /** All recorded parts for a session (unordered). Used by `complete()` + resume. */
+    listParts?(id: string): Promise<MultipartPart[]>;
+    /**
+     * List currently-stored (in-progress) sessions, optionally filtered. Admin-facing (an "uploads in
+     * progress" view), not a hot path. Optional: stores that cannot enumerate omit it and callers
+     * degrade to an empty list.
+     */
+    list?(filter?: UploadSessionListFilter): Promise<UploadSession[]>;
+}
+export interface CreateUploadInput {
+    disk: string;
+    key: string;
+    size?: number;
+    contentType?: string;
+    metadata?: Record<string, string>;
+}
+export interface ResumableUploadManagerOptions {
+    storage: StorageManager;
+    sessions: UploadSessionStore;
+    /** Prefix for temporary chunk parts on the target disk (buffered path). Default `.uploads`. */
+    tmpPrefix?: string;
+    /** Session lifetime in seconds (TUS `expiration`). Omit for sessions that never expire. */
+    sessionTtlSeconds?: number;
+    idGenerator?: () => string;
+    /** Injectable clock (tests drive expiry deterministically). Default `() => new Date()`. */
+    clock?: () => Date;
+    /** Emit `upload.*` diagnostics events (default true). */
+    emitDiagnostics?: boolean;
+}
+/**
+ * Framework-agnostic resumable-upload engine — the storage core the TUS HTTP handler drives. Bytes
+ * flow through the backend in chunks; each chunk is written immediately as a part on the target disk
+ * (native S3 multipart when available, else a buffered part object), so a dropped connection resumes
+ * from `offset` without re-sending. {@link complete} assembles the parts into the final object.
+ *
+ * This never imports AdonisJS; the provider exposes it over TUS routes and {@link MediaManager}
+ * surfaces it as `media.resumable`.
+ */
+export declare class ResumableUploadManager {
+    private readonly storage;
+    private readonly sessions;
+    private readonly tmpPrefix;
+    private readonly ttlSeconds;
+    private readonly newId;
+    private readonly now;
+    private readonly emitDiagnostics;
+    constructor(options: ResumableUploadManagerOptions);
+    private partKey;
+    /** Begin a resumable upload session and reserve any native multipart upload the disk supports. */
+    createUpload(input: CreateUploadInput): Promise<UploadSession>;
+    /** Append a chunk at `offset` (must equal the session's current offset). Returns the new offset. */
+    writeChunk(id: string, offset: number, chunk: Uint8Array): Promise<{
+        offset: number;
+    }>;
+    /** Current offset, declared size, and expiry for a session (drives the TUS `HEAD` response). */
+    status(id: string): Promise<{
+        offset: number;
+        size: number | undefined;
+        expiresAt: Date | undefined;
+    }>;
+    /** Assemble all parts into the final object, clean up, and return the final key/disk/size. */
+    complete(id: string): Promise<{
+        key: string;
+        disk: string;
+        size: number;
+    }>;
+    /** Discard an in-flight session, freeing its native multipart upload or buffered parts. */
+    abort(id: string): Promise<void>;
+    /** All recorded parts for a session (multipart-capable disks). */
+    listParts(id: string): Promise<MultipartPart[]>;
+    /** In-progress sessions, optionally filtered. Empty when the store cannot enumerate. */
+    list(filter?: UploadSessionListFilter): Promise<UploadSession[]>;
+    private emit;
+    private cleanup;
+    /**
+     * Load a session, treating an expired one as gone: its native/buffered parts are cleaned up, the
+     * record is deleted, and an {@link UploadSessionExpiredError} is thrown (the TUS handler maps this
+     * to `410 Gone`).
+     */
+    private require;
+}
+//# sourceMappingURL=resumable_upload.d.ts.map

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

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

package/dist/src/resumable_upload.js

@@ -0,0 +1,177 @@
+import { randomUUID } from 'node:crypto';
+import { publishMedia } from './diagnostics.js';
+import { UploadNotSupportedError, UploadOffsetConflictError, UploadSessionExpiredError, UploadSessionNotFoundError, } from './errors.js';
+import { isMultipartCapable } from './multipart.js';
+/**
+ * Framework-agnostic resumable-upload engine — the storage core the TUS HTTP handler drives. Bytes
+ * flow through the backend in chunks; each chunk is written immediately as a part on the target disk
+ * (native S3 multipart when available, else a buffered part object), so a dropped connection resumes
+ * from `offset` without re-sending. {@link complete} assembles the parts into the final object.
+ *
+ * This never imports AdonisJS; the provider exposes it over TUS routes and {@link MediaManager}
+ * surfaces it as `media.resumable`.
+ */
+export class ResumableUploadManager {
+    storage;
+    sessions;
+    tmpPrefix;
+    ttlSeconds;
+    newId;
+    now;
+    emitDiagnostics;
+    constructor(options) {
+        this.storage = options.storage;
+        this.sessions = options.sessions;
+        this.tmpPrefix = options.tmpPrefix ?? '.uploads';
+        this.ttlSeconds = options.sessionTtlSeconds;
+        this.newId = options.idGenerator ?? (() => randomUUID());
+        this.now = options.clock ?? (() => new Date());
+        this.emitDiagnostics = options.emitDiagnostics ?? true;
+    }
+    partKey(session, part) {
+        return `${this.tmpPrefix}/${session.id}/${part}`;
+    }
+    /** Begin a resumable upload session and reserve any native multipart upload the disk supports. */
+    async createUpload(input) {
+        const disk = this.storage.disk(input.disk);
+        const multipart = isMultipartCapable(disk)
+            ? {
+                multipartUploadId: (await disk.createMultipartUpload(input.key, input.contentType ? { contentType: input.contentType } : undefined)).uploadId,
+            }
+            : {};
+        const createdAt = this.now();
+        const session = await this.sessions.create({
+            id: this.newId(),
+            disk: input.disk,
+            key: input.key,
+            contentType: input.contentType,
+            size: input.size,
+            offset: 0,
+            parts: 0,
+            createdAt,
+            ...(this.ttlSeconds !== undefined
+                ? { expiresAt: new Date(createdAt.getTime() + this.ttlSeconds * 1000) }
+                : {}),
+            ...(input.metadata !== undefined ? { metadata: input.metadata } : {}),
+            ...multipart,
+        });
+        this.emit('upload.start', {
+            id: session.id,
+            disk: session.disk,
+            key: session.key,
+            mode: 'proxy',
+            size: session.size,
+            contentType: session.contentType,
+        });
+        return session;
+    }
+    /** Append a chunk at `offset` (must equal the session's current offset). Returns the new offset. */
+    async writeChunk(id, offset, chunk) {
+        const session = await this.require(id);
+        if (offset !== session.offset) {
+            throw new UploadOffsetConflictError(session.offset, offset);
+        }
+        const disk = this.storage.disk(session.disk);
+        if (session.multipartUploadId && isMultipartCapable(disk)) {
+            if (typeof this.sessions.addPart !== 'function') {
+                throw new UploadNotSupportedError(session.disk, 'resumable multipart part recording');
+            }
+            const part = await disk.uploadPart(session.key, session.multipartUploadId, session.parts + 1, chunk);
+            await this.sessions.addPart(id, part);
+        }
+        else {
+            await disk.put(this.partKey(session, session.parts), chunk);
+        }
+        session.parts += 1;
+        session.offset += chunk.byteLength;
+        await this.sessions.update(session);
+        this.emit('upload.progress', {
+            id: session.id,
+            offset: session.offset,
+            parts: session.parts,
+            size: session.size,
+        });
+        return { offset: session.offset };
+    }
+    /** Current offset, declared size, and expiry for a session (drives the TUS `HEAD` response). */
+    async status(id) {
+        const session = await this.require(id);
+        return { offset: session.offset, size: session.size, expiresAt: session.expiresAt };
+    }
+    /** Assemble all parts into the final object, clean up, and return the final key/disk/size. */
+    async complete(id) {
+        const session = await this.require(id);
+        const disk = this.storage.disk(session.disk);
+        if (session.multipartUploadId && isMultipartCapable(disk)) {
+            const parts = [...((await this.sessions.listParts?.(id)) ?? [])].sort((a, b) => a.partNumber - b.partNumber);
+            await disk.completeMultipartUpload(session.key, session.multipartUploadId, parts);
+        }
+        else {
+            const chunks = [];
+            for (let part = 0; part < session.parts; part += 1) {
+                chunks.push(Buffer.from(await disk.getBytes(this.partKey(session, part))));
+            }
+            await disk.put(session.key, new Uint8Array(Buffer.concat(chunks)), session.contentType ? { contentType: session.contentType } : {});
+        }
+        await this.cleanup(session);
+        await this.sessions.delete(id);
+        const size = session.size ?? session.offset;
+        this.emit('upload.complete', { id: session.id, disk: session.disk, key: session.key });
+        return { key: session.key, disk: session.disk, size };
+    }
+    /** Discard an in-flight session, freeing its native multipart upload or buffered parts. */
+    async abort(id) {
+        const session = await this.sessions.get(id);
+        if (!session)
+            return;
+        const disk = this.storage.disk(session.disk);
+        if (session.multipartUploadId && isMultipartCapable(disk)) {
+            await disk.abortMultipartUpload(session.key, session.multipartUploadId);
+        }
+        await this.cleanup(session);
+        await this.sessions.delete(id);
+        this.emit('upload.abort', { id: session.id, disk: session.disk, key: session.key });
+    }
+    /** All recorded parts for a session (multipart-capable disks). */
+    async listParts(id) {
+        await this.require(id);
+        return (await this.sessions.listParts?.(id)) ?? [];
+    }
+    /** In-progress sessions, optionally filtered. Empty when the store cannot enumerate. */
+    async list(filter) {
+        return (await this.sessions.list?.(filter)) ?? [];
+    }
+    emit(event, payload) {
+        if (this.emitDiagnostics)
+            publishMedia(event, payload);
+    }
+    async cleanup(session) {
+        if (session.multipartUploadId)
+            return;
+        const disk = this.storage.disk(session.disk);
+        for (let part = 0; part < session.parts; part += 1) {
+            await disk.delete(this.partKey(session, part)).catch(() => { });
+        }
+    }
+    /**
+     * Load a session, treating an expired one as gone: its native/buffered parts are cleaned up, the
+     * record is deleted, and an {@link UploadSessionExpiredError} is thrown (the TUS handler maps this
+     * to `410 Gone`).
+     */
+    async require(id) {
+        const session = await this.sessions.get(id);
+        if (!session)
+            throw new UploadSessionNotFoundError(id);
+        if (session.expiresAt && session.expiresAt.getTime() <= this.now().getTime()) {
+            const disk = this.storage.disk(session.disk);
+            if (session.multipartUploadId && isMultipartCapable(disk)) {
+                await disk.abortMultipartUpload(session.key, session.multipartUploadId).catch(() => { });
+            }
+            await this.cleanup(session);
+            await this.sessions.delete(id);
+            throw new UploadSessionExpiredError(id);
+        }
+        return session;
+    }
+}
+//# sourceMappingURL=resumable_upload.js.map

package/dist/src/resumable_upload.js.map

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

package/dist/src/services/main.d.ts

@@ -0,0 +1,14 @@
+import { MediaManager } from '../media_manager.js';
+/**
+ * Service-singleton for the {@link MediaManager}, resolved from the container once the app has
+ * booted. Import it for a ready-to-use manager instead of resolving the binding by hand:
+ *
+ * ```ts
+ * import media from '@adonis-agora/media/services/main'
+ *
+ * await media.library.attach({ ownerType: 'Post', ownerId: '1', collection: 'gallery', ... })
+ * ```
+ */
+declare let media: MediaManager;
+export { media as default };
+//# sourceMappingURL=main.d.ts.map

package/dist/src/services/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/services/main.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;;;GASG;AACH,QAAA,IAAI,KAAK,EAAE,YAAY,CAAC;AAMxB,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAC"}

package/dist/src/services/main.js

@@ -0,0 +1,18 @@
+import app from '@adonisjs/core/services/app';
+import { MediaManager } from '../media_manager.js';
+/**
+ * Service-singleton for the {@link MediaManager}, resolved from the container once the app has
+ * booted. Import it for a ready-to-use manager instead of resolving the binding by hand:
+ *
+ * ```ts
+ * import media from '@adonis-agora/media/services/main'
+ *
+ * await media.library.attach({ ownerType: 'Post', ownerId: '1', collection: 'gallery', ... })
+ * ```
+ */
+let media;
+await app.booted(async () => {
+    media = await app.container.make(MediaManager);
+});
+export { media as default };
+//# sourceMappingURL=main.js.map

package/dist/src/services/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/services/main.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,6BAA6B,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;;;GASG;AACH,IAAI,KAAmB,CAAC;AAExB,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IAC1B,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE,CAAC"}

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

@@ -21,9 +21,6 @@ export interface LucidStoreConfig {
     /** Table name. Default `media`. */
     table?: string;
 }
-/** Options for the in-memory media store (single-process, non-durable). */
-export interface MemoryStoreConfig {
-}
 /**
  * The store factory namespace used in `config/media.ts`:
  *
@@ -44,8 +41,19 @@ export interface MemoryStoreConfig {
  */
 export declare const stores: {
     /** In-memory store — single-process, non-durable. Handy for tests and scratch apps. */
-    memory(_config?: MemoryStoreConfig): StoreFactory;
+    memory(): StoreFactory;
     /** Persist media records in SQL via `@adonisjs/lucid`. */
     lucid(config?: LucidStoreConfig): StoreFactory;
 };
+/**
+ * Build the media store selected by `config.store` from the `config.stores` map. When a store IS
+ * named but has no matching factory (a typo or a missing `stores` entry), this THROWS a
+ * {@link StoreNotConfiguredError} rather than silently falling back to the in-memory store — a
+ * non-durable fallback would lose data on restart. Only the zero-config path (no `store` named at
+ * all) resolves to the in-memory store.
+ */
+export declare function resolveStore(config: {
+    store?: string;
+    stores?: Record<string, StoreFactory>;
+}, ctx: StoreContext): Promise<MediaStore>;
 //# sourceMappingURL=factory.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtE,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;CAEjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM;IACjB,uFAAuF;qBACvE,iBAAiB,GAAQ,YAAY;IAOrD,0DAA0D;mBAC5C,gBAAgB,GAAQ,YAAY;CAUnD,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtE,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM;IACjB,uFAAuF;cAC7E,YAAY;IAOtB,0DAA0D;mBAC5C,gBAAgB,GAAQ,YAAY;CAUnD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAAE,EACjE,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,UAAU,CAAC,CASrB"}

package/dist/src/stores/factory.js

@@ -1,3 +1,4 @@
+import { StoreNotConfiguredError } from '../errors.js';
 /**
  * The store factory namespace used in `config/media.ts`:
  *
@@ -18,7 +19,7 @@
  */
 export const stores = {
     /** In-memory store — single-process, non-durable. Handy for tests and scratch apps. */
-    memory(_config = {}) {
+    memory() {
         return async () => {
             const { InMemoryMediaStore } = await import('../testing/in_memory_media_store.js');
             return new InMemoryMediaStore();
@@ -36,4 +37,22 @@ export const stores = {
         };
     },
 };
+/**
+ * Build the media store selected by `config.store` from the `config.stores` map. When a store IS
+ * named but has no matching factory (a typo or a missing `stores` entry), this THROWS a
+ * {@link StoreNotConfiguredError} rather than silently falling back to the in-memory store — a
+ * non-durable fallback would lose data on restart. Only the zero-config path (no `store` named at
+ * all) resolves to the in-memory store.
+ */
+export async function resolveStore(config, ctx) {
+    const name = config.store;
+    if (name) {
+        const factory = config.stores?.[name];
+        if (!factory)
+            throw new StoreNotConfiguredError(name);
+        return factory(ctx);
+    }
+    const { InMemoryMediaStore } = await import('../testing/in_memory_media_store.js');
+    return new InMemoryMediaStore();
+}
 //# sourceMappingURL=factory.js.map

package/dist/src/stores/factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,uFAAuF;IACvF,MAAM,CAAC,UAA6B,EAAE;QACpC,OAAO,KAAK,IAAI,EAAE;YAChB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;YACnF,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,SAA2B,EAAE;QACjC,OAAO,KAAK,IAAI,EAAE;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC,OAAO,CAAC;YACjE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YACvD,OAAO,IAAI,eAAe,CAAC,EAAE,EAAE;gBAC7B,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjF,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;CACF,CAAC"}
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/stores/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AA2BvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,uFAAuF;IACvF,MAAM;QACJ,OAAO,KAAK,IAAI,EAAE;YAChB,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;YACnF,OAAO,IAAI,kBAAkB,EAAE,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,SAA2B,EAAE;QACjC,OAAO,KAAK,IAAI,EAAE;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC,CAAC,OAAO,CAAC;YACjE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YACvD,OAAO,IAAI,eAAe,CAAC,EAAE,EAAE;gBAC7B,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjF,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAiE,EACjE,GAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC;IAC1B,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;IACnF,OAAO,IAAI,kBAAkB,EAAE,CAAC;AAClC,CAAC"}

package/dist/src/stores/lucid.d.ts

@@ -1,6 +1,6 @@
 import type { Database } from '@adonisjs/lucid/database';
 import type { MediaRecord } from '../media_record.js';
-import type { MediaStore } from '../media_store.js';
+import { type MediaListOptions, type MediaListPage, type MediaStore } from '../media_store.js';
 export interface LucidMediaStoreOptions {
     /** The Lucid connection name. Defaults to the `Database` default connection. */
     connectionName?: string;
@@ -23,6 +23,7 @@ export declare class LucidMediaStore implements MediaStore {
     save(record: MediaRecord): Promise<MediaRecord>;
     find(id: string): Promise<MediaRecord | null>;
     listByOwner(ownerType: string, ownerId: string, collection?: string): Promise<MediaRecord[]>;
+    list(options?: MediaListOptions): Promise<MediaListPage>;
     delete(id: string): Promise<void>;
     nextOrder(ownerType: string, ownerId: string, collection: string): Promise<number>;
 }

package/dist/src/stores/lucid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lucid.d.ts","sourceRoot":"","sources":["../../../src/stores/lucid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAK9C,OAAO,CAAC,QAAQ,CAAC,EAAE;IAJrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAGjC,EAAE,EAAE,QAAQ,EAC7B,OAAO,GAAE,sBAA2B;IAMtC,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,KAAK;IAIP,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAW/C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK7C,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,EAAE,CAAC;IAOnB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAUzF"}
+{"version":3,"file":"lucid.d.ts","sourceRoot":"","sources":["../../../src/stores/lucid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,UAAU,EAIhB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAK9C,OAAO,CAAC,QAAQ,CAAC,EAAE;IAJrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;gBAGjC,EAAE,EAAE,QAAQ,EAC7B,OAAO,GAAE,sBAA2B;IAMtC,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,KAAK;IAIP,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ/C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK7C,WAAW,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,EAAE,CAAC;IAOnB,IAAI,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwC5D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAUzF"}

package/dist/src/stores/lucid.js

@@ -1,3 +1,4 @@
+import { clampMediaListLimit, decodeMediaCursor, encodeMediaCursor, } from '../media_store.js';
 /**
  * Lucid-backed {@link MediaStore}. Persists media records in a `media` table via `@adonisjs/lucid`'s
  * query builder (Knex), so it works across SQLite / Postgres / MySQL. JSON payloads
@@ -21,13 +22,9 @@ export class LucidMediaStore {
     }
     async save(record) {
         const row = toRow(record);
-        const exists = await this.query().where('id', record.id).first();
-        if (exists) {
-            await this.query().where('id', record.id).update(row);
-        }
-        else {
-            await this.client().table(this.table).insert(row);
-        }
+        // Single atomic upsert (portable Knex `INSERT ... ON CONFLICT (id) DO UPDATE`) instead of a
+        // racy read-then-branch: concurrent saves of the same id can't interleave into a lost write.
+        await this.client().table(this.table).insert(row).onConflict('id').merge();
         return { ...record };
     }
     async find(id) {
@@ -41,6 +38,44 @@ export class LucidMediaStore {
         const rows = (await q.orderBy('order', 'asc'));
         return rows.map(fromRow);
     }
+    async list(options = {}) {
+        const limit = clampMediaListLimit(options.limit);
+        let q = this.query();
+        if (options.ownerType !== undefined)
+            q = q.where('owner_type', options.ownerType);
+        if (options.ownerId !== undefined)
+            q = q.where('owner_id', options.ownerId);
+        if (options.collection !== undefined)
+            q = q.where('collection', options.collection);
+        if (options.prefix !== undefined && options.prefix !== '') {
+            q = q.where('path', 'like', `${options.prefix}%`);
+        }
+        // Keyset pagination on the (created_at desc, id desc) ordering: resume strictly *after* the cursor
+        // row, so pages don't drift or duplicate when rows are inserted concurrently.
+        const cursor = decodeMediaCursor(options.cursor);
+        if (cursor) {
+            q = q.where((builder) => {
+                builder
+                    .where('created_at', '<', cursor.createdAt)
+                    .orWhere((eq) => eq.where('created_at', cursor.createdAt).where('id', '<', cursor.id));
+            });
+        }
+        // Fetch one extra row to detect whether a further page exists without a second COUNT query.
+        const rows = (await q
+            .orderBy('created_at', 'desc')
+            .orderBy('id', 'desc')
+            .limit(limit + 1));
+        const hasMore = rows.length > limit;
+        const page = hasMore ? rows.slice(0, limit) : rows;
+        const items = page.map(fromRow);
+        const last = page[page.length - 1];
+        return {
+            items,
+            nextCursor: hasMore && last
+                ? encodeMediaCursor({ createdAt: Number(last.created_at), id: last.id })
+                : null,
+        };
+    }
     async delete(id) {
         await this.query().where('id', id).delete();
     }

package/dist/src/stores/lucid.js.map

@@ -1 +1 @@
-{"version":3,"file":"lucid.js","sourceRoot":"","sources":["../../../src/stores/lucid.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lucid.js","sourceRoot":"","sources":["../../../src/stores/lucid.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AA4B3B;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAKP;IAJF,KAAK,CAAS;IACd,cAAc,CAAqB;IAEpD,YACmB,EAAY,EAC7B,UAAkC,EAAE;QADnB,OAAE,GAAF,EAAE,CAAU;QAG7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC;QACtC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC/C,CAAC;IAEO,MAAM;QACZ,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;IAC9F,CAAC;IAEO,KAAK;QACX,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAmB;QAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,4FAA4F;QAC5F,6FAA6F;QAC7F,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3E,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAoB,CAAC;QAC5E,OAAO,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,WAAW,CACf,SAAiB,EACjB,OAAe,EACf,UAAmB;QAEnB,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC/E,IAAI,UAAU,KAAK,SAAS;YAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAe,CAAC;QAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,UAA4B,EAAE;QACvC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAClF,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC5E,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACpF,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YAC1D,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACpD,CAAC;QAED,mGAAmG;QACnG,8EAA8E;QAC9E,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,CAAC;YACX,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE;gBACtB,OAAO;qBACJ,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC;qBAC1C,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YAC3F,CAAC,CAAC,CAAC;QACL,CAAC;QAED,4FAA4F;QAC5F,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC;aAClB,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;aAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;aACrB,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAe,CAAC;QAEnC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnC,OAAO;YACL,KAAK;YACL,UAAU,EACR,OAAO,IAAI,IAAI;gBACb,CAAC,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;gBACxE,CAAC,CAAC,IAAI;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,OAAe,EAAE,UAAkB;QACpE,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE;aAC5B,KAAK,CAAC,YAAY,EAAE,SAAS,CAAC;aAC9B,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC;aAC1B,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC;aAC/B,GAAG,CAAC,oBAAoB,CAAC;aACzB,KAAK,EAAE,CAAwC,CAAC;QACnD,MAAM,GAAG,GAAG,GAAG,EAAE,SAAS,CAAC;QAC3B,OAAO,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjE,CAAC;CACF;AAED,SAAS,KAAK,CAAC,MAAmB;IAChC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,UAAU,EAAE,MAAM,CAAC,SAAS;QAC5B,QAAQ,EAAE,MAAM,CAAC,OAAO;QACxB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC;QAChE,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QACrD,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE;QACtC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAAa;IAC5B,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;QACrB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;QACtB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACxB,gBAAgB,EAAE,SAAS,CAA0B,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC/E,WAAW,EAAE,SAAS,CAAkC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5E,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC3C,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAI,KAAoB,EAAE,QAAW;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/src/telescope/dashboard.d.ts

@@ -0,0 +1,19 @@
+import type { DashboardSpec } from './telescope-sdk.js';
+/** Options for the media "Media" dashboard. */
+export interface MediaDashboardOptions {
+    /**
+     * URL template for deep-linking a completed-upload row (a `LinkSpec.href` with `{key}` placeholders
+     * filled from the row, e.g. `/media/uploads/{id}`). Omit to render plain ids with no link.
+     */
+    uploadHref?: string;
+    /** URL template for deep-linking a conversion row, e.g. `/media/{id}`. Omit for plain ids. */
+    conversionHref?: string;
+}
+/**
+ * The "Media" overview dashboard — upload health up top (active / success rate / throughput), then
+ * upload activity (over-time + recent completed uploads), then storage operations and conversions.
+ * Pure data: panels bind to the `media.*` data providers by name; the `*Href` options add an optional
+ * `LinkSpec` on the id column so a host media SPA can deep-link a row.
+ */
+export declare function mediaDashboard(opts?: MediaDashboardOptions): DashboardSpec;
+//# sourceMappingURL=dashboard.d.ts.map

package/dist/src/telescope/dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../../../src/telescope/dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,qBAA0B,GAAG,aAAa,CA4G9E"}