@mano8/astro-media-m8 0.1.0-alpha.1

package/dist/src/runtime/upload/uploadController.js

@@ -0,0 +1,217 @@
+import { abortUpload, completeUpload, initiateUpload } from "../api/uploads.js";
+import { getObject } from "../api/objects.js";
+import { getMediaConfig } from "../config.js";
+import { ApiError } from "../errors.js";
+export class UploadError extends Error {
+    kind;
+    cause;
+    constructor(kind, message, cause) {
+        super(message);
+        this.name = "UploadError";
+        this.kind = kind;
+        this.cause = cause;
+    }
+}
+const PENDING_SCAN_STATES = new Set(["pending"]);
+const PENDING_OBJECT_STATES = new Set(["pending_upload", "uploaded", "processing"]);
+/**
+ * Compute a lowercase hex SHA-256 of a blob using Web Crypto. Returns `null`
+ * when the platform has no `crypto.subtle` (e.g. non-secure context).
+ */
+export async function sha256Hex(blob) {
+    const subtle = globalThis.crypto?.subtle;
+    if (!subtle)
+        return null;
+    const digest = await subtle.digest("SHA-256", await blob.arrayBuffer());
+    return Array.from(new Uint8Array(digest))
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+}
+/**
+ * Upload a blob to MinIO/S3 via a presigned POST policy. The bearer token is
+ * never attached here — storage authenticates the signed `upload_fields` only.
+ * Uses `XMLHttpRequest` for progress events, falling back to `fetch` when XHR
+ * is unavailable (e.g. SSR).
+ */
+export function putToStorage(presigned, file, options = {}) {
+    const form = new FormData();
+    for (const [key, value] of Object.entries(presigned.upload_fields)) {
+        form.append(key, value);
+    }
+    form.append("file", file);
+    const Xhr = globalThis.XMLHttpRequest;
+    if (!Xhr) {
+        return fetch(presigned.upload_url, { method: "POST", body: form }).then((response) => {
+            if (!response.ok) {
+                throw new UploadError("storage", `Storage upload failed with ${response.status}`);
+            }
+        });
+    }
+    return new Promise((resolve, reject) => {
+        const xhr = new Xhr();
+        xhr.open("POST", presigned.upload_url);
+        xhr.upload.onprogress = (event) => {
+            if (event.lengthComputable)
+                options.onProgress?.(event.loaded, event.total);
+        };
+        xhr.onload = () => {
+            if (xhr.status >= 200 && xhr.status < 300)
+                resolve();
+            else
+                reject(new UploadError("storage", `Storage upload failed with ${xhr.status}`));
+        };
+        xhr.onerror = () => reject(new UploadError("storage", "Storage upload network error"));
+        xhr.onabort = () => reject(new UploadError("abort", "Upload aborted"));
+        if (options.signal) {
+            if (options.signal.aborted) {
+                xhr.abort();
+            }
+            else {
+                options.signal.addEventListener("abort", () => xhr.abort(), { once: true });
+            }
+        }
+        xhr.send(form);
+    });
+}
+export class MediaUploadController {
+    input;
+    listeners = new Set();
+    controller = new AbortController();
+    loaded = 0;
+    total;
+    currentState = "idle";
+    object;
+    sessionId;
+    constructor(input) {
+        this.input = input;
+        this.total = input.file.size;
+    }
+    get state() {
+        return this.currentState;
+    }
+    on(_event, listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    abort() {
+        this.controller.abort();
+    }
+    emit(state) {
+        this.currentState = state;
+        const progress = {
+            state,
+            loaded: this.loaded,
+            total: this.total,
+            fraction: this.total > 0 ? Math.min(1, this.loaded / this.total) : null,
+            object: this.object
+        };
+        for (const listener of this.listeners)
+            listener(progress);
+    }
+    async start() {
+        const { input } = this;
+        const filename = input.filename ?? input.file.name;
+        const mimeType = input.mimeType ?? input.file.type;
+        if (!filename)
+            throw new UploadError("api", "A filename is required to upload");
+        if (!mimeType)
+            throw new UploadError("api", "A MIME type is required to upload");
+        let presigned;
+        try {
+            this.emit("initiating");
+            presigned = await initiateUpload({
+                category: input.category,
+                visibility: input.visibility,
+                original_filename: filename,
+                mime_type: mimeType,
+                expected_size_bytes: input.file.size
+            });
+            this.sessionId = presigned.session_id;
+        }
+        catch (error) {
+            this.emit("failed");
+            throw new UploadError("api", "Failed to initiate upload", error);
+        }
+        try {
+            this.emit("uploading");
+            await putToStorage(presigned, input.file, {
+                signal: this.controller.signal,
+                onProgress: (loaded, total) => {
+                    this.loaded = loaded;
+                    this.total = total;
+                    this.emit("uploading");
+                }
+            });
+        }
+        catch (error) {
+            await this.safeAbort();
+            if (error instanceof UploadError && error.kind === "abort") {
+                this.emit("aborted");
+                throw error;
+            }
+            this.emit("failed");
+            throw error instanceof UploadError
+                ? error
+                : new UploadError("storage", "Storage upload failed", error);
+        }
+        let sha256 = null;
+        if (input.checksum === "sha256") {
+            sha256 = await sha256Hex(input.file);
+        }
+        let object;
+        try {
+            this.emit("completing");
+            const response = await completeUpload(presigned.session_id, sha256 ? { sha256 } : {});
+            object = response.media_object;
+            this.object = object;
+        }
+        catch (error) {
+            this.emit("failed");
+            throw new UploadError("api", "Failed to complete upload", error);
+        }
+        if (input.waitForScan) {
+            this.emit("scanning");
+            object = await this.pollUntilScanned(object.id);
+            this.object = object;
+        }
+        this.emit("ready");
+        return object;
+    }
+    async pollUntilScanned(objectId) {
+        const polling = getMediaConfig().polling;
+        const intervalMs = this.input.scanIntervalMs ?? polling.uploadScanMs;
+        const timeoutMs = this.input.scanTimeoutMs ?? polling.timeoutMs;
+        const deadline = Date.now() + timeoutMs;
+        for (;;) {
+            if (this.controller.signal.aborted)
+                throw new UploadError("abort", "Upload aborted");
+            const object = await getObject(objectId);
+            if (object.status === "rejected" || object.scan_status === "infected" || object.scan_status === "quarantined") {
+                throw new UploadError("scan", `Object rejected by scan (${object.scan_status})`);
+            }
+            const stillPending = PENDING_OBJECT_STATES.has(object.status) || PENDING_SCAN_STATES.has(object.scan_status);
+            if (!stillPending)
+                return object;
+            if (Date.now() + intervalMs >= deadline) {
+                throw new UploadError("scan", "Timed out waiting for scan to finish");
+            }
+            await new Promise((resolve) => setTimeout(resolve, intervalMs));
+        }
+    }
+    async safeAbort() {
+        // Only ever called after `initiate` has set the session id.
+        try {
+            await abortUpload(this.sessionId);
+        }
+        catch (error) {
+            // Best-effort cleanup; surface API aborts only via logs, not by masking
+            // the original failure.
+            if (!(error instanceof ApiError))
+                throw error;
+        }
+    }
+}
+export function createMediaUploadController(input) {
+    return new MediaUploadController(input);
+}
+//# sourceMappingURL=uploadController.js.map

package/dist/src/runtime/upload/uploadController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadController.js","sourceRoot":"","sources":["../../../../src/runtime/upload/uploadController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAoBxC,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IACtB,KAAK,CAAW;IAEzB,YAAY,IAAqB,EAAE,OAAe,EAAE,KAAe;QACjE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AA6BD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACjD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;AAEpF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAU;IACxC,MAAM,MAAM,GAAI,UAAU,CAAC,MAA6B,EAAE,MAAM,CAAC;IACjE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACjD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAiC,EACjC,IAAU,EACV,UAA0F,EAAE;IAE5F,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;QACnE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE1B,MAAM,GAAG,GAAI,UAAyD,CAAC,cAAc,CAAC;IACtF,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;YACnF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,WAAW,CAAC,SAAS,EAAE,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACpF,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;QACvC,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,KAAK,EAAE,EAAE;YAChC,IAAI,KAAK,CAAC,gBAAgB;gBAAE,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9E,CAAC,CAAC;QACF,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE;YAChB,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG;gBAAE,OAAO,EAAE,CAAC;;gBAChD,MAAM,CAAC,IAAI,WAAW,CAAC,SAAS,EAAE,8BAA8B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACtF,CAAC,CAAC;QACF,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,SAAS,EAAE,8BAA8B,CAAC,CAAC,CAAC;QACvF,GAAG,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;QACvE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC3B,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,qBAAqB;IASH;IARrB,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC/B,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAC5C,MAAM,GAAG,CAAC,CAAC;IACX,KAAK,CAAS;IACd,YAAY,GAAgB,MAAM,CAAC;IAC3C,MAAM,CAAqB;IACnB,SAAS,CAAU;IAE3B,YAA6B,KAA4B;QAA5B,UAAK,GAAL,KAAK,CAAuB;QACvD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,EAAE,CAAC,MAAkB,EAAE,QAA0B;QAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAEO,IAAI,CAAC,KAAkB;QAC7B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,MAAM,QAAQ,GAAmB;YAC/B,KAAK;YACL,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;YACvE,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;QACF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACnD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,WAAW,CAAC,KAAK,EAAE,kCAAkC,CAAC,CAAC;QAChF,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,WAAW,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;QAEjF,IAAI,SAAiC,CAAC;QACtC,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxB,SAAS,GAAG,MAAM,cAAc,CAAC;gBAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,iBAAiB,EAAE,QAAQ;gBAC3B,SAAS,EAAE,QAAQ;gBACnB,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI;aACrC,CAAC,CAAC;YACH,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC;QACxC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpB,MAAM,IAAI,WAAW,CAAC,KAAK,EAAE,2BAA2B,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACvB,MAAM,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE;gBACxC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM;gBAC9B,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;oBAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;oBACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;oBACnB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBACzB,CAAC;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC3D,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACrB,MAAM,KAAK,CAAC;YACd,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpB,MAAM,KAAK,YAAY,WAAW;gBAChC,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,WAAW,CAAC,SAAS,EAAE,uBAAuB,EAAE,KAAK,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,MAAM,GAAkB,IAAI,CAAC;QACjC,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,MAAyB,CAAC;QAC9B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxB,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACtF,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpB,MAAM,IAAI,WAAW,CAAC,KAAK,EAAE,2BAA2B,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtB,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,QAAgB;QAC7C,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC,OAAO,CAAC;QACzC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAExC,SAAS,CAAC;YACR,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;YACzC,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,WAAW,KAAK,UAAU,IAAI,MAAM,CAAC,WAAW,KAAK,aAAa,EAAE,CAAC;gBAC9G,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,4BAA4B,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;YACnF,CAAC;YACD,MAAM,YAAY,GAChB,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAC1F,IAAI,CAAC,YAAY;gBAAE,OAAO,MAAM,CAAC;YACjC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC;gBACxC,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,sCAAsC,CAAC,CAAC;YACxE,CAAC;YACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,4DAA4D;QAC5D,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,IAAI,CAAC,SAAmB,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,wEAAwE;YACxE,wBAAwB;YACxB,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC;gBAAE,MAAM,KAAK,CAAC;QAChD,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B,CAAC,KAA4B;IACtE,OAAO,IAAI,qBAAqB,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC"}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@mano8/astro-media-m8",
+  "version": "0.1.0-alpha.1",
+  "description": "Astro integration and headless client for media-service-m8.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mano8/astro-media-m8.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "astro-integration",
+    "astro",
+    "media",
+    "uploads",
+    "media-service-m8"
+  ],
+  "files": [
+    "dist",
+    "src/routes",
+    "src/scaffold/styles",
+    "registry.json",
+    "registry/r",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": "./dist/src/integration.js",
+    "./api": "./dist/src/runtime/api/index.js",
+    "./client": "./dist/src/runtime/client.js",
+    "./schemas": "./dist/src/runtime/schemas.js",
+    "./auth-adapter": "./dist/src/runtime/authAdapter.js",
+    "./upload": "./dist/src/runtime/upload/index.js",
+    "./hooks": "./dist/src/runtime/hooks/index.js",
+    "./react": "./dist/src/runtime/react/index.js",
+    "./default-ui": "./dist/src/runtime/react/default-ui/index.js",
+    "./list-params": "./dist/src/runtime/listParams.js",
+    "./routes": "./dist/src/runtime/routes.js",
+    "./routes/upload.astro": "./src/routes/upload.astro",
+    "./routes/library.astro": "./src/routes/library.astro",
+    "./routes/object/[id].astro": "./src/routes/object/[id].astro",
+    "./routes/presets.astro": "./src/routes/presets.astro",
+    "./routes/admin/media.astro": "./src/routes/admin/media.astro",
+    "./middleware": "./dist/src/middleware.js",
+    "./internal-server": "./dist/src/runtime/api/internal.server.js",
+    "./compatibility": "./dist/src/runtime/compatibility.js"
+  },
+  "types": "./dist/src/integration.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && npm run build:registry",
+    "build:registry": "node scripts/build-registry.mjs",
+    "test": "vitest run --coverage",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test:unit": "vitest run"
+  },
+  "peerDependencies": {
+    "@mano8/astro-auth-m8": "^0.1.0-alpha.1",
+    "@tanstack/react-query": "^5.101.1",
+    "astro": "^5.0.0 || ^6.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "zod": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@mano8/astro-auth-m8": "^0.1.0-alpha.1",
+    "@tanstack/react-query": "^5.101.1",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.0.0",
+    "@vitest/coverage-v8": "^4.1.9",
+    "astro": "^6.0.0",
+    "jsdom": "^29.1.1",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.9",
+    "zod": "^4.0.0"
+  },
+  "overrides": {
+    "esbuild": "^0.28.1"
+  },
+  "mediaServiceM8": {
+    "contract": "media-service-m8@0.0",
+    "testedServiceVersion": "0.0.10",
+    "serviceVersionRange": ">=0.0.10 <0.1.0"
+  }
+}

package/registry/r/admin-media-dashboard.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "admin-media-dashboard",
+  "type": "registry:component",
+  "title": "Admin Media Dashboard",
+  "description": "Media admin view whose first/landing tab is the storage dashboard and whose destructive ops live in a guarded Maintenance tab; wraps the package's MediaProvider + RequireSuperuser. Requires @fa-m8/astro-media-m8 (and a fa-auth-m8 token adapter) installed.",
+  "dependencies": [
+    "lucide-react"
+  ],
+  "registryDependencies": [
+    "tabs",
+    "./node_modules/@fa-m8/astro-media-m8/registry/r/media-dashboard-overview.json",
+    "./node_modules/@fa-m8/astro-media-m8/registry/r/media-maintenance-panel.json"
+  ],
+  "files": [
+    {
+      "path": "registry/blocks/admin/admin-media-dashboard.tsx",
+      "content": "\"use client\";\r\n\r\n// Media admin view whose FIRST/landing tab is the storage dashboard; the\r\n// destructive operations are demoted to a guarded \"Maintenance\" tab. Headless\r\n// state comes from the package (@fa-m8/astro-media-m8/react + /hooks); this file\r\n// is only the shadcn skin, copied into the consumer via the @fa-m8-media\r\n// registry. Because media-service only accepts fa-auth-m8 tokens, the auth\r\n// package must also be present (pass its adapter via `adapter`). Edit per app.\r\nimport * as React from \"react\";\r\nimport { LayoutDashboard, Wrench } from \"lucide-react\";\r\nimport {\r\n  MediaProvider,\r\n  RequireSuperuser,\r\n  type MediaContextValue,\r\n} from \"@fa-m8/astro-media-m8/react\";\r\n\r\nimport { Tabs, TabsContent, TabsList, TabsTrigger } from \"@/components/ui/tabs\";\r\nimport {\r\n  MediaDashboardOverview,\r\n  type MediaDashboardOverviewLabels,\r\n} from \"@/components/fa-media/media-dashboard-overview\";\r\nimport {\r\n  MediaMaintenancePanel,\r\n  type MediaMaintenanceLabels,\r\n} from \"@/components/fa-media/media-maintenance-panel\";\r\n\r\nexport interface AdminMediaDashboardLabels {\r\n  dashboardTab: string;\r\n  maintenanceTab: string;\r\n  forbidden: string;\r\n  overview: Partial<MediaDashboardOverviewLabels>;\r\n  maintenance: Partial<MediaMaintenanceLabels>;\r\n}\r\n\r\nconst DEFAULT_LABELS: AdminMediaDashboardLabels = {\r\n  dashboardTab: \"Dashboard\",\r\n  maintenanceTab: \"Maintenance\",\r\n  forbidden: \"You need administrator access to view this page.\",\r\n  overview: {},\r\n  maintenance: {},\r\n};\r\n\r\nexport interface AdminMediaDashboardProps {\r\n  /** Media runtime config (apiBase/v1Base/legacyBase/adminRole). */\r\n  config?: React.ComponentProps<typeof MediaProvider>[\"config\"];\r\n  /** fa-auth-backed media auth adapter (media only accepts fa-auth-m8 tokens). */\r\n  adapter?: MediaContextValue[\"adapter\"];\r\n  labels?: Partial<AdminMediaDashboardLabels>;\r\n}\r\n\r\nfunction AdminMediaShell({ labels }: { labels: AdminMediaDashboardLabels }) {\r\n  return (\r\n    <RequireSuperuser\r\n      fallback={\r\n        <div className=\"not-content mx-auto w-full max-w-md py-10 text-center text-sm text-muted-foreground\">\r\n          {labels.forbidden}\r\n        </div>\r\n      }\r\n    >\r\n      <Tabs defaultValue=\"dashboard\" className=\"not-content mx-auto w-full max-w-6xl space-y-4\">\r\n        <TabsList className=\"flex h-auto flex-wrap justify-start gap-1\">\r\n          <TabsTrigger value=\"dashboard\" className=\"gap-2\">\r\n            <LayoutDashboard className=\"size-4\" />\r\n            {labels.dashboardTab}\r\n          </TabsTrigger>\r\n          <TabsTrigger value=\"maintenance\" className=\"gap-2\">\r\n            <Wrench className=\"size-4\" />\r\n            {labels.maintenanceTab}\r\n          </TabsTrigger>\r\n        </TabsList>\r\n\r\n        <TabsContent value=\"dashboard\">\r\n          <MediaDashboardOverview labels={labels.overview} />\r\n        </TabsContent>\r\n        <TabsContent value=\"maintenance\">\r\n          <MediaMaintenancePanel labels={labels.maintenance} />\r\n        </TabsContent>\r\n      </Tabs>\r\n    </RequireSuperuser>\r\n  );\r\n}\r\n\r\nexport default function AdminMediaDashboard({\r\n  config,\r\n  adapter,\r\n  labels,\r\n}: AdminMediaDashboardProps) {\r\n  const resolved: AdminMediaDashboardLabels = {\r\n    ...DEFAULT_LABELS,\r\n    ...labels,\r\n    overview: { ...DEFAULT_LABELS.overview, ...labels?.overview },\r\n    maintenance: { ...DEFAULT_LABELS.maintenance, ...labels?.maintenance },\r\n  };\r\n  return (\r\n    <MediaProvider config={config} adapter={adapter}>\r\n      <AdminMediaShell labels={resolved} />\r\n    </MediaProvider>\r\n  );\r\n}\r\n",
+      "type": "registry:component",
+      "target": "components/fa-media/admin-media-dashboard.tsx"
+    }
+  ]
+}

package/registry/r/data-table.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "data-table",
+  "type": "registry:component",
+  "title": "Data Table",
+  "description": "Generic pure-shadcn data table (sorting, filtering, pagination) built on @tanstack/react-table.",
+  "dependencies": [
+    "@tanstack/react-table"
+  ],
+  "registryDependencies": [
+    "table",
+    "button",
+    "input"
+  ],
+  "files": [
+    {
+      "path": "registry/blocks/data-table/data-table.tsx",
+      "content": "\"use client\";\n\n// Generic, pure-shadcn data table (sorting + filtering + pagination) built on\n// @tanstack/react-table and the shadcn `table` primitive. Copied into the\n// consumer via the @fa-m8-media registry; edit freely per app.\nimport * as React from \"react\";\nimport {\n  type ColumnDef,\n  type ColumnFiltersState,\n  type SortingState,\n  flexRender,\n  getCoreRowModel,\n  getFilteredRowModel,\n  getPaginationRowModel,\n  getSortedRowModel,\n  useReactTable,\n} from \"@tanstack/react-table\";\n\nimport { Button } from \"@/components/ui/button\";\nimport { Input } from \"@/components/ui/input\";\nimport {\n  Table,\n  TableBody,\n  TableCell,\n  TableHead,\n  TableHeader,\n  TableRow,\n} from \"@/components/ui/table\";\n\nexport interface DataTableProps<TData, TValue> {\n  columns: ColumnDef<TData, TValue>[];\n  data: TData[];\n  /** Column id to wire the search box to; omit to hide the filter input. */\n  filterColumn?: string;\n  filterPlaceholder?: string;\n  /** Page size for client-side pagination. Defaults to 10. */\n  pageSize?: number;\n  /** Rendered when there are no rows. */\n  emptyMessage?: string;\n}\n\nexport function DataTable<TData, TValue>({\n  columns,\n  data,\n  filterColumn,\n  filterPlaceholder = \"Filter…\",\n  pageSize = 10,\n  emptyMessage = \"No results.\",\n}: DataTableProps<TData, TValue>) {\n  const [sorting, setSorting] = React.useState<SortingState>([]);\n  const [columnFilters, setColumnFilters] = React.useState<ColumnFiltersState>([]);\n\n  const table = useReactTable({\n    data,\n    columns,\n    getCoreRowModel: getCoreRowModel(),\n    getPaginationRowModel: getPaginationRowModel(),\n    getSortedRowModel: getSortedRowModel(),\n    getFilteredRowModel: getFilteredRowModel(),\n    onSortingChange: setSorting,\n    onColumnFiltersChange: setColumnFilters,\n    initialState: { pagination: { pageSize } },\n    state: { sorting, columnFilters },\n  });\n\n  const filterCol = filterColumn ? table.getColumn(filterColumn) : undefined;\n\n  return (\n    <div className=\"space-y-3\">\n      {filterCol ? (\n        <Input\n          value={(filterCol.getFilterValue() as string) ?? \"\"}\n          onChange={(event) => filterCol.setFilterValue(event.target.value)}\n          placeholder={filterPlaceholder}\n          className=\"max-w-sm\"\n          aria-label={filterPlaceholder}\n        />\n      ) : null}\n\n      <div className=\"rounded-md border\">\n        <Table>\n          <TableHeader>\n            {table.getHeaderGroups().map((headerGroup) => (\n              <TableRow key={headerGroup.id}>\n                {headerGroup.headers.map((header) => (\n                  <TableHead key={header.id}>\n                    {header.isPlaceholder\n                      ? null\n                      : flexRender(\n                          header.column.columnDef.header,\n                          header.getContext(),\n                        )}\n                  </TableHead>\n                ))}\n              </TableRow>\n            ))}\n          </TableHeader>\n          <TableBody>\n            {table.getRowModel().rows.length ? (\n              table.getRowModel().rows.map((row) => (\n                <TableRow\n                  key={row.id}\n                  data-state={row.getIsSelected() && \"selected\"}\n                >\n                  {row.getVisibleCells().map((cell) => (\n                    <TableCell key={cell.id}>\n                      {flexRender(cell.column.columnDef.cell, cell.getContext())}\n                    </TableCell>\n                  ))}\n                </TableRow>\n              ))\n            ) : (\n              <TableRow>\n                <TableCell colSpan={columns.length} className=\"h-24 text-center\">\n                  {emptyMessage}\n                </TableCell>\n              </TableRow>\n            )}\n          </TableBody>\n        </Table>\n      </div>\n\n      {table.getPageCount() > 1 ? (\n        <div className=\"flex items-center justify-end gap-2\">\n          <Button\n            variant=\"outline\"\n            size=\"sm\"\n            onClick={() => table.previousPage()}\n            disabled={!table.getCanPreviousPage()}\n          >\n            Previous\n          </Button>\n          <span className=\"text-sm text-muted-foreground\">\n            Page {table.getState().pagination.pageIndex + 1} of{\" \"}\n            {table.getPageCount()}\n          </span>\n          <Button\n            variant=\"outline\"\n            size=\"sm\"\n            onClick={() => table.nextPage()}\n            disabled={!table.getCanNextPage()}\n          >\n            Next\n          </Button>\n        </div>\n      ) : null}\n    </div>\n  );\n}\n",
+      "type": "registry:component",
+      "target": "components/fa-media/data-table.tsx"
+    }
+  ]
+}

package/registry/r/media-dashboard-overview.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "media-dashboard-overview",
+  "type": "registry:component",
+  "title": "Media Admin Dashboard Overview",
+  "description": "Media storage dashboard (stat cards + chart + subscriptions table) driven by the package's useMediaAdmin hook. Requires @fa-m8/astro-media-m8 installed.",
+  "dependencies": [
+    "lucide-react",
+    "@tanstack/react-table"
+  ],
+  "registryDependencies": [
+    "card",
+    "button",
+    "skeleton",
+    "./node_modules/@fa-m8/astro-media-m8/registry/r/media-storage-chart.json",
+    "./node_modules/@fa-m8/astro-media-m8/registry/r/data-table.json"
+  ],
+  "files": [
+    {
+      "path": "registry/blocks/admin/media-dashboard-overview.tsx",
+      "content": "\"use client\";\r\n\r\n// Media admin landing view: a storage dashboard built from the package's\r\n// headless `useMediaAdmin` hook. Logic stays a live dependency\r\n// (@fa-m8/astro-media-m8/hooks); this file is only the shadcn skin and is copied\r\n// into the consumer via the @fa-m8-media registry — edit freely per app.\r\nimport * as React from \"react\";\r\nimport {\r\n  Boxes,\r\n  HardDrive,\r\n  Trash2,\r\n  Clock,\r\n  Database,\r\n  CloudOff,\r\n} from \"lucide-react\";\r\nimport { useMediaAdmin } from \"@fa-m8/astro-media-m8/hooks\";\r\nimport type { SubscriptionPublic } from \"@fa-m8/astro-media-m8/schemas\";\r\nimport type { ColumnDef } from \"@tanstack/react-table\";\r\n\r\nimport { Card, CardContent, CardHeader, CardTitle } from \"@/components/ui/card\";\r\nimport { Button } from \"@/components/ui/button\";\r\nimport { Skeleton } from \"@/components/ui/skeleton\";\r\nimport {\r\n  MediaStorageChart,\r\n  humanizeBytes,\r\n} from \"@/components/fa-media/media-storage-chart\";\r\nimport { DataTable } from \"@/components/fa-media/data-table\";\r\n\r\nexport interface MediaDashboardOverviewLabels {\r\n  title: string;\r\n  subtitle: string;\r\n  totalObjects: string;\r\n  totalBytes: string;\r\n  deletedObjects: string;\r\n  staleSessions: string;\r\n  dbOrphans: string;\r\n  storageOrphans: string;\r\n  storageByCategory: string;\r\n  storageEmpty: string;\r\n  subscriptionsTitle: string;\r\n  subUrl: string;\r\n  subEvents: string;\r\n  subStatus: string;\r\n  subActive: string;\r\n  subInactive: string;\r\n  subActions: string;\r\n  subDelete: string;\r\n  subEmpty: string;\r\n  error: string;\r\n}\r\n\r\nconst DEFAULT_LABELS: MediaDashboardOverviewLabels = {\r\n  title: \"Overview\",\r\n  subtitle: \"Storage and processing at a glance.\",\r\n  totalObjects: \"Objects\",\r\n  totalBytes: \"Storage used\",\r\n  deletedObjects: \"Deleted\",\r\n  staleSessions: \"Stale uploads\",\r\n  dbOrphans: \"DB orphans\",\r\n  storageOrphans: \"Storage orphans\",\r\n  storageByCategory: \"Storage by category\",\r\n  storageEmpty: \"No stored objects yet.\",\r\n  subscriptionsTitle: \"Webhook subscriptions\",\r\n  subUrl: \"Endpoint\",\r\n  subEvents: \"Events\",\r\n  subStatus: \"Status\",\r\n  subActive: \"Active\",\r\n  subInactive: \"Inactive\",\r\n  subActions: \"Actions\",\r\n  subDelete: \"Delete\",\r\n  subEmpty: \"No webhook subscriptions.\",\r\n  error: \"Could not load admin data.\",\r\n};\r\n\r\nexport interface MediaDashboardOverviewProps {\r\n  labels?: Partial<MediaDashboardOverviewLabels>;\r\n}\r\n\r\nfunction StatCard({\r\n  label,\r\n  value,\r\n  icon: Icon,\r\n}: {\r\n  label: string;\r\n  value: React.ReactNode;\r\n  icon: React.ComponentType<{ className?: string }>;\r\n}) {\r\n  return (\r\n    <Card className=\"h-full\">\r\n      <CardHeader className=\"flex flex-row items-center justify-between space-y-0 pb-2\">\r\n        <CardTitle className=\"text-sm font-medium text-muted-foreground\">\r\n          {label}\r\n        </CardTitle>\r\n        <Icon className=\"size-4 text-muted-foreground\" />\r\n      </CardHeader>\r\n      <CardContent>\r\n        <div className=\"text-2xl font-semibold tabular-nums\">{value}</div>\r\n      </CardContent>\r\n    </Card>\r\n  );\r\n}\r\n\r\nexport function MediaDashboardOverview({\r\n  labels,\r\n}: MediaDashboardOverviewProps) {\r\n  const t = { ...DEFAULT_LABELS, ...labels };\r\n  const {\r\n    stats,\r\n    stale,\r\n    orphans,\r\n    subscriptions,\r\n    error,\r\n    loadStats,\r\n    loadStale,\r\n    loadOrphans,\r\n    loadSubscriptions,\r\n    removeSubscription,\r\n  } = useMediaAdmin();\r\n  const [ready, setReady] = React.useState(false);\r\n\r\n  React.useEffect(() => {\r\n    let cancelled = false;\r\n    void Promise.allSettled([\r\n      loadStats(),\r\n      loadStale(),\r\n      loadOrphans(),\r\n      loadSubscriptions(),\r\n    ]).finally(() => {\r\n      if (!cancelled) setReady(true);\r\n    });\r\n    return () => {\r\n      cancelled = true;\r\n    };\r\n    // The hook callbacks are stable for a given superuser identity; run once.\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  }, []);\r\n\r\n  const storageData = (stats?.by_category ?? []).map((row) => ({\r\n    category: row.category,\r\n    bytes: row.total_bytes,\r\n    count: row.count,\r\n  }));\r\n\r\n  const columns = React.useMemo<ColumnDef<SubscriptionPublic>[]>(\r\n    () => [\r\n      { accessorKey: \"url\", header: t.subUrl },\r\n      {\r\n        accessorKey: \"event_types\",\r\n        header: t.subEvents,\r\n        cell: ({ row }) => row.original.event_types.join(\", \") || \"*\",\r\n      },\r\n      {\r\n        accessorKey: \"active\",\r\n        header: t.subStatus,\r\n        cell: ({ row }) => (row.original.active ? t.subActive : t.subInactive),\r\n      },\r\n      {\r\n        id: \"actions\",\r\n        header: t.subActions,\r\n        cell: ({ row }) => (\r\n          <Button\r\n            variant=\"ghost\"\r\n            size=\"sm\"\r\n            className=\"text-destructive hover:text-destructive\"\r\n            onClick={() => void removeSubscription(row.original.id)}\r\n          >\r\n            {t.subDelete}\r\n          </Button>\r\n        ),\r\n      },\r\n    ],\r\n    [t, removeSubscription],\r\n  );\r\n\r\n  if (!ready) {\r\n    return (\r\n      <div className=\"not-content space-y-4\" aria-busy=\"true\">\r\n        <div className=\"grid auto-rows-fr gap-4 sm:grid-cols-2 lg:grid-cols-3\">\r\n          {[0, 1, 2, 3, 4, 5].map((i) => (\r\n            <Skeleton key={i} className=\"h-28 w-full\" />\r\n          ))}\r\n        </div>\r\n        <Skeleton className=\"h-64 w-full\" />\r\n      </div>\r\n    );\r\n  }\r\n\r\n  if (error && !stats) {\r\n    return (\r\n      <Card role=\"alert\" className=\"border-destructive/50\">\r\n        <CardContent className=\"py-6 text-sm text-destructive\">\r\n          {t.error}\r\n        </CardContent>\r\n      </Card>\r\n    );\r\n  }\r\n\r\n  return (\r\n    <div className=\"not-content space-y-6\">\r\n      <div className=\"space-y-1\">\r\n        <h2 className=\"text-xl font-semibold tracking-tight\">{t.title}</h2>\r\n        <p className=\"text-sm text-muted-foreground\">{t.subtitle}</p>\r\n      </div>\r\n\r\n      <div className=\"grid auto-rows-fr gap-4 sm:grid-cols-2 lg:grid-cols-3\">\r\n        <StatCard\r\n          label={t.totalObjects}\r\n          value={(stats?.total_objects ?? 0).toLocaleString()}\r\n          icon={Boxes}\r\n        />\r\n        <StatCard\r\n          label={t.totalBytes}\r\n          value={humanizeBytes(stats?.total_bytes ?? 0)}\r\n          icon={HardDrive}\r\n        />\r\n        <StatCard\r\n          label={t.deletedObjects}\r\n          value={(stats?.deleted_objects ?? 0).toLocaleString()}\r\n          icon={Trash2}\r\n        />\r\n        <StatCard\r\n          label={t.staleSessions}\r\n          value={(stale?.count ?? 0).toLocaleString()}\r\n          icon={Clock}\r\n        />\r\n        <StatCard\r\n          label={t.dbOrphans}\r\n          value={(orphans?.db_orphan_count ?? 0).toLocaleString()}\r\n          icon={Database}\r\n        />\r\n        <StatCard\r\n          label={t.storageOrphans}\r\n          value={(orphans?.storage_orphan_count ?? 0).toLocaleString()}\r\n          icon={CloudOff}\r\n        />\r\n      </div>\r\n\r\n      <Card>\r\n        <CardHeader>\r\n          <CardTitle className=\"text-base\">{t.storageByCategory}</CardTitle>\r\n        </CardHeader>\r\n        <CardContent>\r\n          {storageData.length ? (\r\n            <MediaStorageChart\r\n              data={storageData}\r\n              bytesLabel={t.totalBytes}\r\n              className=\"aspect-auto h-64 w-full\"\r\n            />\r\n          ) : (\r\n            <p className=\"py-8 text-center text-sm text-muted-foreground\">\r\n              {t.storageEmpty}\r\n            </p>\r\n          )}\r\n        </CardContent>\r\n      </Card>\r\n\r\n      <Card>\r\n        <CardHeader>\r\n          <CardTitle className=\"text-base\">{t.subscriptionsTitle}</CardTitle>\r\n        </CardHeader>\r\n        <CardContent>\r\n          <DataTable\r\n            columns={columns}\r\n            data={subscriptions?.items ?? []}\r\n            filterColumn=\"url\"\r\n            filterPlaceholder={t.subUrl}\r\n            emptyMessage={t.subEmpty}\r\n          />\r\n        </CardContent>\r\n      </Card>\r\n    </div>\r\n  );\r\n}\r\n",
+      "type": "registry:component",
+      "target": "components/fa-media/media-dashboard-overview.tsx"
+    }
+  ]
+}

package/registry/r/media-maintenance-panel.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "media-maintenance-panel",
+  "type": "registry:component",
+  "title": "Media Admin Maintenance Panel",
+  "description": "Media admin danger zone (purge-stale / repair-orphans / purge-expired), each behind a shadcn alert-dialog confirmation, driven by useMediaAdmin. Requires @fa-m8/astro-media-m8 installed.",
+  "dependencies": [
+    "lucide-react"
+  ],
+  "registryDependencies": [
+    "card",
+    "button",
+    "alert-dialog"
+  ],
+  "files": [
+    {
+      "path": "registry/blocks/admin/media-maintenance-panel.tsx",
+      "content": "\"use client\";\r\n\r\n// Media admin \"Maintenance / Danger zone\": the destructive storage operations,\r\n// each behind a shadcn `alert-dialog` confirmation. Logic stays a live\r\n// dependency (@fa-m8/astro-media-m8/hooks); this file is only the shadcn skin,\r\n// copied into the consumer via the @fa-m8-media registry — edit freely per app.\r\nimport * as React from \"react\";\r\nimport { AlertTriangle } from \"lucide-react\";\r\nimport { useMediaAdmin } from \"@fa-m8/astro-media-m8/hooks\";\r\n\r\nimport { Card, CardContent, CardDescription, CardHeader, CardTitle } from \"@/components/ui/card\";\r\nimport { Button } from \"@/components/ui/button\";\r\nimport {\r\n  AlertDialog,\r\n  AlertDialogAction,\r\n  AlertDialogCancel,\r\n  AlertDialogContent,\r\n  AlertDialogDescription,\r\n  AlertDialogFooter,\r\n  AlertDialogHeader,\r\n  AlertDialogTitle,\r\n  AlertDialogTrigger,\r\n} from \"@/components/ui/alert-dialog\";\r\n\r\nexport interface MediaMaintenanceLabels {\r\n  title: string;\r\n  subtitle: string;\r\n  confirmTitle: string;\r\n  cancel: string;\r\n  confirm: string;\r\n  running: string;\r\n  done: string;\r\n  error: string;\r\n  purgeStaleTitle: string;\r\n  purgeStaleDescription: string;\r\n  repairTitle: string;\r\n  repairDescription: string;\r\n  purgeExpiredTitle: string;\r\n  purgeExpiredDescription: string;\r\n}\r\n\r\nconst DEFAULT_LABELS: MediaMaintenanceLabels = {\r\n  title: \"Maintenance\",\r\n  subtitle: \"Destructive storage operations. Each action is irreversible.\",\r\n  confirmTitle: \"Are you sure?\",\r\n  cancel: \"Cancel\",\r\n  confirm: \"Run\",\r\n  running: \"Running…\",\r\n  done: \"Done.\",\r\n  error: \"Operation failed.\",\r\n  purgeStaleTitle: \"Purge stale uploads\",\r\n  purgeStaleDescription:\r\n    \"Delete upload sessions that expired before completing. Frees reserved storage keys.\",\r\n  repairTitle: \"Repair orphans\",\r\n  repairDescription:\r\n    \"Reconcile DB and storage, deleting storage-orphan bytes that have no matching object record.\",\r\n  purgeExpiredTitle: \"Purge expired (retention)\",\r\n  purgeExpiredDescription:\r\n    \"Hard-delete soft-deleted objects past their retention window. Cannot be undone.\",\r\n};\r\n\r\nexport interface MediaMaintenancePanelProps {\r\n  labels?: Partial<MediaMaintenanceLabels>;\r\n}\r\n\r\ntype OpState = { status: \"idle\" | \"running\" | \"done\" | \"error\"; message?: string };\r\n\r\nfunction DangerAction({\r\n  title,\r\n  description,\r\n  labels,\r\n  run,\r\n}: {\r\n  title: string;\r\n  description: string;\r\n  labels: MediaMaintenanceLabels;\r\n  run: () => Promise<unknown>;\r\n}) {\r\n  const [state, setState] = React.useState<OpState>({ status: \"idle\" });\r\n\r\n  const onConfirm = async () => {\r\n    setState({ status: \"running\" });\r\n    try {\r\n      await run();\r\n      setState({ status: \"done\", message: labels.done });\r\n    } catch (err) {\r\n      setState({\r\n        status: \"error\",\r\n        message: err instanceof Error ? err.message : labels.error,\r\n      });\r\n    }\r\n  };\r\n\r\n  return (\r\n    <div className=\"flex flex-col gap-3 rounded-md border p-4 sm:flex-row sm:items-center sm:justify-between\">\r\n      <div className=\"min-w-0 space-y-1\">\r\n        <p className=\"text-sm font-medium\">{title}</p>\r\n        <p className=\"text-sm text-muted-foreground\">{description}</p>\r\n        {state.status === \"done\" ? (\r\n          <p className=\"text-sm text-emerald-600\">{state.message}</p>\r\n        ) : null}\r\n        {state.status === \"error\" ? (\r\n          <p className=\"text-sm text-destructive\" role=\"alert\">\r\n            {state.message}\r\n          </p>\r\n        ) : null}\r\n      </div>\r\n      <AlertDialog>\r\n        <AlertDialogTrigger asChild>\r\n          <Button variant=\"destructive\" disabled={state.status === \"running\"}>\r\n            {state.status === \"running\" ? labels.running : labels.confirm}\r\n          </Button>\r\n        </AlertDialogTrigger>\r\n        <AlertDialogContent>\r\n          <AlertDialogHeader>\r\n            <AlertDialogTitle>{labels.confirmTitle}</AlertDialogTitle>\r\n            <AlertDialogDescription>{description}</AlertDialogDescription>\r\n          </AlertDialogHeader>\r\n          <AlertDialogFooter>\r\n            <AlertDialogCancel>{labels.cancel}</AlertDialogCancel>\r\n            <AlertDialogAction onClick={() => void onConfirm()}>\r\n              {labels.confirm}\r\n            </AlertDialogAction>\r\n          </AlertDialogFooter>\r\n        </AlertDialogContent>\r\n      </AlertDialog>\r\n    </div>\r\n  );\r\n}\r\n\r\nexport function MediaMaintenancePanel({ labels }: MediaMaintenancePanelProps) {\r\n  const t = { ...DEFAULT_LABELS, ...labels };\r\n  const { purgeStale, repair, purgeExpiredObjects } = useMediaAdmin();\r\n\r\n  return (\r\n    <Card className=\"not-content border-destructive/40\">\r\n      <CardHeader>\r\n        <CardTitle className=\"flex items-center gap-2 text-base text-destructive\">\r\n          <AlertTriangle className=\"size-4\" />\r\n          {t.title}\r\n        </CardTitle>\r\n        <CardDescription>{t.subtitle}</CardDescription>\r\n      </CardHeader>\r\n      <CardContent className=\"space-y-3\">\r\n        <DangerAction\r\n          title={t.purgeStaleTitle}\r\n          description={t.purgeStaleDescription}\r\n          labels={t}\r\n          run={() => purgeStale()}\r\n        />\r\n        <DangerAction\r\n          title={t.repairTitle}\r\n          description={t.repairDescription}\r\n          labels={t}\r\n          run={() => repair(true)}\r\n        />\r\n        <DangerAction\r\n          title={t.purgeExpiredTitle}\r\n          description={t.purgeExpiredDescription}\r\n          labels={t}\r\n          run={() => purgeExpiredObjects()}\r\n        />\r\n      </CardContent>\r\n    </Card>\r\n  );\r\n}\r\n",
+      "type": "registry:component",
+      "target": "components/fa-media/media-maintenance-panel.tsx"
+    }
+  ]
+}

package/registry/r/media-storage-chart.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
+  "name": "media-storage-chart",
+  "type": "registry:component",
+  "title": "Media Storage Chart",
+  "description": "shadcn chart preset (recharts) for media storage bytes per category, with a base-1024 byte humanizer.",
+  "dependencies": [
+    "recharts"
+  ],
+  "registryDependencies": [
+    "chart"
+  ],
+  "files": [
+    {
+      "path": "registry/blocks/chart/media-storage-chart.tsx",
+      "content": "\"use client\";\n\n// Pure-shadcn bar chart preset (recharts-backed) for the media admin dashboard:\n// storage bytes per category. Copied into the consumer via the @fa-m8-media\n// registry; edit freely per app.\nimport { Bar, BarChart, CartesianGrid, XAxis, YAxis } from \"recharts\";\n\nimport {\n  type ChartConfig,\n  ChartContainer,\n  ChartTooltip,\n  ChartTooltipContent,\n} from \"@/components/ui/chart\";\n\nexport interface StorageDatum {\n  category: string;\n  bytes: number;\n  count: number;\n}\n\nexport interface MediaStorageChartProps {\n  data: StorageDatum[];\n  bytesLabel?: string;\n  className?: string;\n}\n\n/** Compact, base-1024 byte humanizer shared by the axis + tooltip. */\nexport function humanizeBytes(bytes: number): string {\n  if (!Number.isFinite(bytes) || bytes <= 0) return \"0 B\";\n  const units = [\"B\", \"KB\", \"MB\", \"GB\", \"TB\", \"PB\"];\n  const exponent = Math.min(\n    units.length - 1,\n    Math.floor(Math.log(bytes) / Math.log(1024)),\n  );\n  const value = bytes / 1024 ** exponent;\n  return `${value.toFixed(value >= 10 || exponent === 0 ? 0 : 1)} ${units[exponent]}`;\n}\n\nexport function MediaStorageChart({\n  data,\n  bytesLabel = \"Storage\",\n  className,\n}: MediaStorageChartProps) {\n  const chartConfig = {\n    bytes: { label: bytesLabel, color: \"var(--chart-1)\" },\n  } satisfies ChartConfig;\n\n  return (\n    <ChartContainer config={chartConfig} className={className}>\n      <BarChart accessibilityLayer data={data}>\n        <CartesianGrid vertical={false} />\n        <XAxis\n          dataKey=\"category\"\n          tickLine={false}\n          tickMargin={10}\n          axisLine={false}\n        />\n        <YAxis\n          tickLine={false}\n          axisLine={false}\n          width={56}\n          tickFormatter={(value: number) => humanizeBytes(value)}\n        />\n        <ChartTooltip\n          content={\n            <ChartTooltipContent\n              formatter={(value) => humanizeBytes(Number(value))}\n            />\n          }\n        />\n        <Bar dataKey=\"bytes\" fill=\"var(--color-bytes)\" radius={4} />\n      </BarChart>\n    </ChartContainer>\n  );\n}\n",
+      "type": "registry:component",
+      "target": "components/fa-media/media-storage-chart.tsx"
+    }
+  ]
+}

package/registry/r/registry.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry.json",
+  "name": "fa-m8-media",
+  "homepage": "https://github.com/mano8/astro-media-m8",
+  "items": [
+    {
+      "name": "data-table",
+      "type": "registry:component",
+      "title": "Data Table",
+      "description": "Generic pure-shadcn data table (sorting, filtering, pagination) built on @tanstack/react-table."
+    },
+    {
+      "name": "media-storage-chart",
+      "type": "registry:component",
+      "title": "Media Storage Chart",
+      "description": "shadcn chart preset (recharts) for media storage bytes per category, with a base-1024 byte humanizer."
+    },
+    {
+      "name": "media-dashboard-overview",
+      "type": "registry:component",
+      "title": "Media Admin Dashboard Overview",
+      "description": "Media storage dashboard (stat cards + chart + subscriptions table) driven by the package's useMediaAdmin hook. Requires @fa-m8/astro-media-m8 installed."
+    },
+    {
+      "name": "media-maintenance-panel",
+      "type": "registry:component",
+      "title": "Media Admin Maintenance Panel",
+      "description": "Media admin danger zone (purge-stale / repair-orphans / purge-expired), each behind a shadcn alert-dialog confirmation, driven by useMediaAdmin. Requires @fa-m8/astro-media-m8 installed."
+    },
+    {
+      "name": "admin-media-dashboard",
+      "type": "registry:component",
+      "title": "Admin Media Dashboard",
+      "description": "Media admin view whose first/landing tab is the storage dashboard and whose destructive ops live in a guarded Maintenance tab; wraps the package's MediaProvider + RequireSuperuser. Requires @fa-m8/astro-media-m8 (and a fa-auth-m8 token adapter) installed."
+    }
+  ]
+}

package/registry.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://ui.shadcn.com/schema/registry.json",
+  "name": "fa-m8-media",
+  "homepage": "https://github.com/mano8/astro-media-m8",
+  "items": [
+    {
+      "name": "data-table",
+      "type": "registry:component",
+      "title": "Data Table",
+      "description": "Generic pure-shadcn data table (sorting, filtering, pagination) built on @tanstack/react-table.",
+      "dependencies": ["@tanstack/react-table"],
+      "registryDependencies": ["table", "button", "input"],
+      "files": [
+        {
+          "path": "registry/blocks/data-table/data-table.tsx",
+          "type": "registry:component",
+          "target": "components/fa-media/data-table.tsx"
+        }
+      ]
+    },
+    {
+      "name": "media-storage-chart",
+      "type": "registry:component",
+      "title": "Media Storage Chart",
+      "description": "shadcn chart preset (recharts) for media storage bytes per category, with a base-1024 byte humanizer.",
+      "dependencies": ["recharts"],
+      "registryDependencies": ["chart"],
+      "files": [
+        {
+          "path": "registry/blocks/chart/media-storage-chart.tsx",
+          "type": "registry:component",
+          "target": "components/fa-media/media-storage-chart.tsx"
+        }
+      ]
+    },
+    {
+      "name": "media-dashboard-overview",
+      "type": "registry:component",
+      "title": "Media Admin Dashboard Overview",
+      "description": "Media storage dashboard (stat cards + chart + subscriptions table) driven by the package's useMediaAdmin hook. Requires @fa-m8/astro-media-m8 installed.",
+      "dependencies": ["lucide-react", "@tanstack/react-table"],
+      "registryDependencies": [
+        "card",
+        "button",
+        "skeleton",
+        "./node_modules/@fa-m8/astro-media-m8/registry/r/media-storage-chart.json",
+        "./node_modules/@fa-m8/astro-media-m8/registry/r/data-table.json"
+      ],
+      "files": [
+        {
+          "path": "registry/blocks/admin/media-dashboard-overview.tsx",
+          "type": "registry:component",
+          "target": "components/fa-media/media-dashboard-overview.tsx"
+        }
+      ]
+    },
+    {
+      "name": "media-maintenance-panel",
+      "type": "registry:component",
+      "title": "Media Admin Maintenance Panel",
+      "description": "Media admin danger zone (purge-stale / repair-orphans / purge-expired), each behind a shadcn alert-dialog confirmation, driven by useMediaAdmin. Requires @fa-m8/astro-media-m8 installed.",
+      "dependencies": ["lucide-react"],
+      "registryDependencies": ["card", "button", "alert-dialog"],
+      "files": [
+        {
+          "path": "registry/blocks/admin/media-maintenance-panel.tsx",
+          "type": "registry:component",
+          "target": "components/fa-media/media-maintenance-panel.tsx"
+        }
+      ]
+    },
+    {
+      "name": "admin-media-dashboard",
+      "type": "registry:component",
+      "title": "Admin Media Dashboard",
+      "description": "Media admin view whose first/landing tab is the storage dashboard and whose destructive ops live in a guarded Maintenance tab; wraps the package's MediaProvider + RequireSuperuser. Requires @fa-m8/astro-media-m8 (and a fa-auth-m8 token adapter) installed.",
+      "dependencies": ["lucide-react"],
+      "registryDependencies": [
+        "tabs",
+        "./node_modules/@fa-m8/astro-media-m8/registry/r/media-dashboard-overview.json",
+        "./node_modules/@fa-m8/astro-media-m8/registry/r/media-maintenance-panel.json"
+      ],
+      "files": [
+        {
+          "path": "registry/blocks/admin/admin-media-dashboard.tsx",
+          "type": "registry:component",
+          "target": "components/fa-media/admin-media-dashboard.tsx"
+        }
+      ]
+    }
+  ]
+}