@sentroy-co/client-sdk 2.4.5 → 2.5.2

package/dist/react/lib/UploadQueuePanel.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UploadQueuePanel = UploadQueuePanel;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("motion/react");
+const utils_1 = require("./utils");
+function UploadQueuePanel({ entries, onCancel, onRemove, onClearDone, className, }) {
+    if (entries.length === 0)
+        return null;
+    const active = entries.filter((e) => e.status === "queued" || e.status === "uploading").length;
+    const done = entries.filter((e) => e.status === "done").length;
+    const failed = entries.filter((e) => e.status === "error" || e.status === "canceled").length;
+    // Aggregate progress (toplam loaded / toplam total)
+    const totalLoaded = entries.reduce((s, e) => s + e.loaded, 0);
+    const totalSize = entries.reduce((s, e) => s + e.total, 0);
+    const aggPercent = totalSize > 0 ? Math.round((totalLoaded / totalSize) * 100) : 0;
+    return ((0, jsx_runtime_1.jsxs)(react_1.motion.div, { initial: { opacity: 0, y: 8 }, animate: { opacity: 1, y: 0 }, transition: { duration: 0.25, ease: [0.22, 1, 0.36, 1] }, className: (0, utils_1.cn)("border-t bg-card/50 backdrop-blur-sm", className), children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center justify-between gap-3 border-b px-3 py-2", children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-3 text-xs", children: [active > 0 && ((0, jsx_runtime_1.jsxs)("span", { className: "flex items-center gap-1.5 text-foreground", children: [(0, jsx_runtime_1.jsxs)("span", { className: "relative flex size-2", children: [(0, jsx_runtime_1.jsx)("span", { className: "absolute inline-flex h-full w-full animate-ping rounded-full bg-blue-400 opacity-75" }), (0, jsx_runtime_1.jsx)("span", { className: "relative inline-flex size-2 rounded-full bg-blue-500" })] }), active, " uploading"] })), done > 0 && ((0, jsx_runtime_1.jsxs)("span", { className: "text-emerald-600 dark:text-emerald-400", children: [done, " done"] })), failed > 0 && ((0, jsx_runtime_1.jsxs)("span", { className: "text-destructive", children: [failed, " failed"] }))] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex items-center gap-2 text-xs", children: [totalSize > 0 && ((0, jsx_runtime_1.jsxs)("span", { className: "tabular-nums text-muted-foreground", children: [(0, utils_1.formatBytes)(totalLoaded), " / ", (0, utils_1.formatBytes)(totalSize), " \u00B7", " ", aggPercent, "%"] })), (done > 0 || failed > 0) && ((0, jsx_runtime_1.jsx)("button", { type: "button", onClick: onClearDone, className: "rounded-md border px-2 py-0.5 text-[10px] hover:bg-muted/50", children: "Clear" }))] })] }), (0, jsx_runtime_1.jsx)("div", { className: "max-h-48 overflow-y-auto py-1", children: (0, jsx_runtime_1.jsx)(react_1.AnimatePresence, { initial: false, children: entries.map((entry, i) => ((0, jsx_runtime_1.jsx)(UploadRow, { entry: entry, index: i, onCancel: () => onCancel(entry.id), onRemove: () => onRemove(entry.id) }, entry.id))) }) })] }));
+}
+function UploadRow({ entry, index, onCancel, onRemove, }) {
+    const percent = entry.total > 0 ? Math.round((entry.loaded / entry.total) * 100) : 0;
+    const isTerminal = entry.status === "done" ||
+        entry.status === "error" ||
+        entry.status === "canceled";
+    return ((0, jsx_runtime_1.jsxs)(react_1.motion.div, { layout: true, initial: { opacity: 0, x: -8 }, animate: { opacity: 1, x: 0 }, exit: { opacity: 0, height: 0 }, transition: {
+            duration: 0.22,
+            ease: [0.22, 1, 0.36, 1],
+            delay: index < 5 ? index * 0.04 : 0,
+        }, className: (0, utils_1.cn)("flex items-center gap-3 px-3 py-2", entry.status === "error" && "bg-destructive/5"), children: [(0, jsx_runtime_1.jsxs)("div", { className: "flex size-7 shrink-0 items-center justify-center", children: [entry.status === "uploading" && ((0, jsx_runtime_1.jsx)(CircularProgress, { percent: percent })), entry.status === "queued" && ((0, jsx_runtime_1.jsx)("span", { className: "size-2 animate-pulse rounded-full bg-muted-foreground/40" })), entry.status === "done" && (0, jsx_runtime_1.jsx)(CheckmarkAnim, {}), entry.status === "error" && ((0, jsx_runtime_1.jsx)("span", { className: "text-base text-destructive", children: "!" })), entry.status === "canceled" && ((0, jsx_runtime_1.jsx)("span", { className: "text-xs text-muted-foreground", children: "\u00D7" }))] }), (0, jsx_runtime_1.jsxs)("div", { className: "flex min-w-0 flex-1 flex-col", children: [(0, jsx_runtime_1.jsx)("span", { className: "truncate text-xs font-medium", title: entry.file.name, children: entry.file.name }), (0, jsx_runtime_1.jsxs)("span", { className: "text-[10px] tabular-nums text-muted-foreground", children: [entry.status === "uploading" && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, utils_1.formatBytes)(entry.loaded), " / ", (0, utils_1.formatBytes)(entry.total), " \u00B7", " ", percent, "%"] })), entry.status === "queued" && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, utils_1.formatBytes)(entry.total), " \u00B7 queued"] })), entry.status === "done" && ((0, jsx_runtime_1.jsxs)("span", { className: "text-emerald-600 dark:text-emerald-400", children: ["uploaded \u00B7 ", (0, utils_1.formatBytes)(entry.total)] })), entry.status === "error" && ((0, jsx_runtime_1.jsx)("span", { className: "text-destructive", children: entry.error ?? "failed" })), entry.status === "canceled" && (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: "canceled" })] })] }), (0, jsx_runtime_1.jsx)("button", { type: "button", onClick: isTerminal ? onRemove : onCancel, className: "rounded-md p-1 text-muted-foreground transition-colors hover:bg-muted/50 hover:text-foreground", "aria-label": isTerminal ? "Remove from list" : "Cancel upload", children: (0, jsx_runtime_1.jsx)("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", className: "size-3.5", children: (0, jsx_runtime_1.jsx)("path", { d: "M18 6 6 18M6 6l12 12" }) }) })] }));
+}
+function CircularProgress({ percent }) {
+    const radius = 10;
+    const circumference = 2 * Math.PI * radius;
+    const offset = circumference - (percent / 100) * circumference;
+    return ((0, jsx_runtime_1.jsxs)("svg", { viewBox: "0 0 24 24", className: "size-6 -rotate-90", children: [(0, jsx_runtime_1.jsx)("circle", { cx: "12", cy: "12", r: radius, fill: "none", stroke: "currentColor", strokeWidth: "2", className: "text-muted/40" }), (0, jsx_runtime_1.jsx)(react_1.motion.circle, { cx: "12", cy: "12", r: radius, fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeDasharray: circumference, initial: false, animate: { strokeDashoffset: offset }, transition: { duration: 0.3, ease: "easeOut" }, className: "text-blue-500" })] }));
+}
+function CheckmarkAnim() {
+    return ((0, jsx_runtime_1.jsx)(react_1.motion.svg, { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", className: "size-5 text-emerald-500", initial: { scale: 0.6, opacity: 0 }, animate: { scale: 1, opacity: 1 }, transition: { duration: 0.3, ease: [0.34, 1.56, 0.64, 1] }, children: (0, jsx_runtime_1.jsx)(react_1.motion.path, { d: "M20 6 9 17l-5-5", initial: { pathLength: 0 }, animate: { pathLength: 1 }, transition: { duration: 0.4, ease: "easeOut", delay: 0.05 } }) }));
+}
+//# sourceMappingURL=UploadQueuePanel.js.map

package/dist/react/lib/UploadQueuePanel.js.map

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

package/dist/react/lib/use-upload-queue.d.ts

@@ -0,0 +1,51 @@
+import type { Sentroy } from "../..";
+import type { Media } from "../../types";
+/**
+ * Tek dosyalık upload entry — UI tarafında queue listesi olarak render edilir.
+ *
+ * State machine:
+ *   queued → uploading → done | error | canceled
+ * `error` ve `canceled` terminal; `done` terminal + `media` set olur.
+ */
+export interface UploadEntry {
+    id: string;
+    file: File;
+    status: "queued" | "uploading" | "done" | "error" | "canceled";
+    loaded: number;
+    total: number;
+    /** Server response — done iken non-null. */
+    media?: Media;
+    error?: string;
+    /** Per-entry cancel handle (XHR abort'u tetikler). */
+    cancel: () => void;
+}
+export interface UseUploadQueueOptions {
+    /** Aynı anda kaç dosya yüklensin. Default 3. */
+    concurrency?: number;
+    /** Dosya başarıyla yüklendiğinde tetiklenir — caller refresh edebilir. */
+    onUploaded?: (media: Media) => void;
+}
+export interface UseUploadQueueResult {
+    entries: UploadEntry[];
+    /** Yeni dosyaları queue'ya ekler ve worker'ı tetikler. */
+    enqueue: (bucketSlug: string, files: File[]) => void;
+    /** Bir entry'i iptal eder (uploading ise XHR abort, queued ise drop). */
+    cancel: (id: string) => void;
+    /** Tek bir entry'i listeden temizler (terminal state'tekiler için). */
+    remove: (id: string) => void;
+    /** Done/error/canceled olanları listeden temizler. */
+    clearDone: () => void;
+    /** Aktif (queued + uploading) entry sayısı. */
+    activeCount: number;
+}
+/**
+ * Upload queue hook — concurrency-pooled, per-entry progress + cancel.
+ *
+ * Storage app'in `apps/storage/lib/upload-client.ts` + `FileUploader` queue
+ * davranışını SDK'ya taşır. SDK consumer'ı (MediaManager veya 3rd-party)
+ * `entries` array'ini render eder, `enqueue`/`cancel`/`remove` çağırır.
+ *
+ * onUploaded: caller refresh için kullanır (örn `setRefreshKey + 1`).
+ */
+export declare function useUploadQueue(client: Sentroy, opts?: UseUploadQueueOptions): UseUploadQueueResult;
+//# sourceMappingURL=use-upload-queue.d.ts.map

package/dist/react/lib/use-upload-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-upload-queue.d.ts","sourceRoot":"","sources":["../../../src/react/lib/use-upload-queue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAA;IAC9D,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,0DAA0D;IAC1D,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAA;IACpD,yEAAyE;IACzE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,uEAAuE;IACvE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,sDAAsD;IACtD,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,OAAO,EACf,IAAI,GAAE,qBAA0B,GAC/B,oBAAoB,CAgMtB"}

package/dist/react/lib/use-upload-queue.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useUploadQueue = useUploadQueue;
+const react_1 = require("react");
+/**
+ * Upload queue hook — concurrency-pooled, per-entry progress + cancel.
+ *
+ * Storage app'in `apps/storage/lib/upload-client.ts` + `FileUploader` queue
+ * davranışını SDK'ya taşır. SDK consumer'ı (MediaManager veya 3rd-party)
+ * `entries` array'ini render eder, `enqueue`/`cancel`/`remove` çağırır.
+ *
+ * onUploaded: caller refresh için kullanır (örn `setRefreshKey + 1`).
+ */
+function useUploadQueue(client, opts = {}) {
+    const concurrency = opts.concurrency ?? 3;
+    const [entries, setEntries] = (0, react_1.useState)([]);
+    const entriesRef = (0, react_1.useRef)([]);
+    entriesRef.current = entries;
+    const onUploadedRef = (0, react_1.useRef)(opts.onUploaded);
+    onUploadedRef.current = opts.onUploaded;
+    // Worker pump — queued entry varsa ve aktif < concurrency ise başlat.
+    const pumpRef = (0, react_1.useRef)(() => { });
+    /**
+     * Aktif (in-flight) upload sayısını synchronous olarak takip eden ref.
+     * `entries` state setEntries ile async güncellendiğinden, recursive
+     * `pump` çağrılarında `entries.filter(e => e.status === "uploading")`
+     * eski listeyi görür → aynı queued entry birden çok kez başlatılır
+     * (Chrome side `ERR_INSUFFICIENT_RESOURCES`). Ref ile incre/decre
+     * synchronous; concurrency limiti gerçekten devreye girer.
+     */
+    const inFlightRef = (0, react_1.useRef)(0);
+    /**
+     * Henüz başlatılmamış queued entry id'lerinin sıralı listesi. setEntries
+     * async olduğu için listeden seçim yapmak yarış koşulu üretir; ref
+     * üzerinden FIFO push/shift hem deterministik hem hızlı.
+     */
+    const queueRef = (0, react_1.useRef)([]);
+    const updateEntry = (0, react_1.useCallback)((id, patch) => {
+        setEntries((prev) => prev.map((e) => (e.id === id ? { ...e, ...patch } : e)));
+    }, []);
+    pumpRef.current = () => {
+        // Slot doluysa veya queue boşsa erken dön.
+        if (inFlightRef.current >= concurrency)
+            return;
+        const nextId = queueRef.current.shift();
+        if (!nextId)
+            return;
+        // Slot'u synchronously rezerve et — bir sonraki pump çağrısı bu
+        // entry'i tekrar shift edemez.
+        inFlightRef.current++;
+        const entry = entriesRef.current.find((e) => e.id === nextId);
+        if (!entry) {
+            // Cancel öncesi remove edilmiş; slot'u iade et ve pump'a devam.
+            inFlightRef.current--;
+            pumpRef.current?.();
+            return;
+        }
+        // Mark uploading
+        updateEntry(entry.id, { status: "uploading" });
+        const bucketSlug = bucketMapRef.current[entry.id];
+        if (!bucketSlug) {
+            updateEntry(entry.id, { status: "error", error: "No bucket" });
+            inFlightRef.current--;
+            pumpRef.current?.();
+            return;
+        }
+        const controller = new AbortController();
+        cancelMapRef.current[entry.id] = () => controller.abort();
+        client.media
+            .upload(bucketSlug, { body: entry.file, filename: entry.file.name }, {
+            onProgress: (loaded, total) => {
+                updateEntry(entry.id, { loaded, total });
+            },
+            signal: controller.signal,
+        })
+            .then((media) => {
+            updateEntry(entry.id, {
+                status: "done",
+                media,
+                loaded: entry.file.size,
+                total: entry.file.size,
+            });
+            onUploadedRef.current?.(media);
+        })
+            .catch((err) => {
+            const aborted = err?.message === "Upload aborted";
+            updateEntry(entry.id, {
+                status: aborted ? "canceled" : "error",
+                error: aborted
+                    ? undefined
+                    : (err?.message ?? "Upload failed"),
+            });
+        })
+            .finally(() => {
+            delete cancelMapRef.current[entry.id];
+            inFlightRef.current--;
+            // Slot açıldı, sıradakini başlat.
+            pumpRef.current?.();
+        });
+        // Aynı tick'te kalan slot'ları doldur — concurrency artık
+        // synchronously inFlightRef ile guard'lı, çift başlatma yok.
+        if (inFlightRef.current < concurrency)
+            pumpRef.current?.();
+    };
+    const bucketMapRef = (0, react_1.useRef)({});
+    const cancelMapRef = (0, react_1.useRef)({});
+    const enqueue = (0, react_1.useCallback)((bucketSlug, files) => {
+        if (files.length === 0)
+            return;
+        const newEntries = files.map((file) => {
+            const id = `up-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+            bucketMapRef.current[id] = bucketSlug;
+            // FIFO queue — pump bu sıradan shift eder; setEntries async
+            // güncellemesinden bağımsız synchronous source-of-truth.
+            queueRef.current.push(id);
+            return {
+                id,
+                file,
+                status: "queued",
+                loaded: 0,
+                total: file.size,
+                cancel: () => {
+                    const c = cancelMapRef.current[id];
+                    if (c)
+                        c();
+                    else {
+                        queueRef.current = queueRef.current.filter((qid) => qid !== id);
+                        setEntries((prev) => prev.map((e) => e.id === id && e.status === "queued"
+                            ? { ...e, status: "canceled" }
+                            : e));
+                    }
+                },
+            };
+        });
+        setEntries((prev) => [...prev, ...newEntries]);
+        // pump on next tick — state update'ten sonra entriesRef güncel olsun.
+        // pumpRef kendi içinde sequential pump zincirini sürdürür (her
+        // başarılı slot rezervasyonundan sonra bir dahaki pump'ı çağırır),
+        // dolayısıyla burada tek tetikleme yeterli.
+        Promise.resolve().then(() => pumpRef.current?.());
+    }, []);
+    const cancel = (0, react_1.useCallback)((id) => {
+        const c = cancelMapRef.current[id];
+        if (c)
+            c();
+        else {
+            queueRef.current = queueRef.current.filter((qid) => qid !== id);
+            setEntries((prev) => prev.map((e) => e.id === id && e.status === "queued"
+                ? { ...e, status: "canceled" }
+                : e));
+        }
+    }, []);
+    const remove = (0, react_1.useCallback)((id) => {
+        setEntries((prev) => prev.filter((e) => e.id !== id));
+        queueRef.current = queueRef.current.filter((qid) => qid !== id);
+        delete bucketMapRef.current[id];
+        delete cancelMapRef.current[id];
+    }, []);
+    const clearDone = (0, react_1.useCallback)(() => {
+        setEntries((prev) => prev.filter((e) => e.status !== "done" &&
+            e.status !== "error" &&
+            e.status !== "canceled"));
+    }, []);
+    const activeCount = entries.filter((e) => e.status === "queued" || e.status === "uploading").length;
+    return { entries, enqueue, cancel, remove, clearDone, activeCount };
+}
+//# sourceMappingURL=use-upload-queue.js.map

package/dist/react/lib/use-upload-queue.js.map

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

package/dist/resources/media.d.ts

@@ -29,7 +29,14 @@ export declare class MediaResource {
      * })
      * ```
      */
-    upload(bucketSlug: string, params: UploadMediaParams): Promise<Media>;
+    upload(bucketSlug: string, params: UploadMediaParams, opts?: {
+        /** Bytes loaded / total — XHR `upload.onprogress` event'inden gelir.
+         *  Verilmesse fetch tabanlı path kullanılır (progress yok). */
+        onProgress?: (loaded: number, total: number) => void;
+        /** AbortController.signal — kullanıcı iptal ettiğinde XHR cancel
+         *  edilir, promise reject. */
+        signal?: AbortSignal;
+    }): Promise<Media>;
     /**
      * Delete a file. Cascades through the CDN: S3 objects (original +
      * thumbnails) are removed, then the Media record. If any S3 delete

package/dist/resources/media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/resources/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,KAAK,EACV,KAAK,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,UAAU,CAAA;AAEjB,qBAAa,aAAa;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC,0CAA0C;IACpC,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC;IAO3B,iCAAiC;IAC3B,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAM9D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,KAAK,CAAC;IAqBjB;;;;OAIG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhE;;;;;;;;OAQG;IACG,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,GACvC,OAAO,CAAC,IAAI,CAAC;CAejB"}
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/resources/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,KAAK,EACV,KAAK,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EAClB,MAAM,UAAU,CAAA;AAEjB,qBAAa,aAAa;IACZ,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAEpC,0CAA0C;IACpC,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC;IAO3B,iCAAiC;IAC3B,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAM9D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,MAAM,CACV,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,iBAAiB,EACzB,IAAI,CAAC,EAAE;QACL;uEAC+D;QAC/D,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;QACpD;sCAC8B;QAC9B,MAAM,CAAC,EAAE,WAAW,CAAA;KACrB,GACA,OAAO,CAAC,KAAK,CAAC;IAsBjB;;;;OAIG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhE;;;;;;;;OAQG;IACG,QAAQ,CACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,GACvC,OAAO,CAAC,IAAI,CAAC;CAejB"}

package/dist/resources/media.js

@@ -36,7 +36,7 @@ class MediaResource {
      * })
      * ```
      */
-    async upload(bucketSlug, params) {
+    async upload(bucketSlug, params, opts) {
         const form = new FormData();
         const filename = params.filename ||
             params.body.name ||
@@ -53,7 +53,11 @@ class MediaResource {
             form.append("caption", params.caption);
         if (params.tags?.length)
             form.append("tags", params.tags.join(","));
-        return this.http.postForm(`/buckets/${encodeURIComponent(bucketSlug)}/media`, form);
+        const path = `/buckets/${encodeURIComponent(bucketSlug)}/media`;
+        if (opts?.onProgress || opts?.signal) {
+            return this.http.postFormWithProgress(path, form, opts);
+        }
+        return this.http.postForm(path, form);
     }
     /**
      * Delete a file. Cascades through the CDN: S3 objects (original +

package/dist/resources/media.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentroy-co/client-sdk",
-  "version": "2.4.5",
+  "version": "2.5.2",
   "description": "TypeScript SDK for the Sentroy platform — REST resources + React components.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,6 +19,11 @@
       "types": "./dist/types.d.ts",
       "import": "./dist/types.js",
       "require": "./dist/types.js"
+    },
+    "./react/crop": {
+      "types": "./dist/react/crop/index.d.ts",
+      "import": "./dist/react/crop/index.js",
+      "require": "./dist/react/crop/index.js"
     }
   },
   "files": [
@@ -71,5 +76,9 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "typescript": "^5.5.4"
+  },
+  "dependencies": {
+    "motion": "^12.38.0",
+    "react-easy-crop": "^5.5.7"
   }
 }

package/src/http.ts

@@ -166,4 +166,89 @@ export class HttpClient {
       clearTimeout(timer)
     }
   }
+
+  /**
+   * XHR-tabanlı multipart upload — `fetch` progress event veremiyor, XHR
+   * `upload.onprogress` ile bytes loaded/total event'i tetikler. Caller
+   * `onProgress` ve `signal` (AbortController) verir.
+   *
+   * Cookie auth (`token` undefined) için `withCredentials = true`. Timeout
+   * uygulanmaz (büyük dosyalar için 30sn'de patlayıp kaybolmasın); caller
+   * istiyorsa `signal` ile kendi timeout'unu kurar.
+   */
+  async postFormWithProgress<T>(
+    path: string,
+    form: FormData,
+    opts: {
+      onProgress?: (loaded: number, total: number) => void
+      signal?: AbortSignal
+    } = {},
+  ): Promise<T> {
+    const url = this.buildUrl(path)
+    return new Promise<T>((resolve, reject) => {
+      const xhr = new XMLHttpRequest()
+      xhr.open("POST", url, true)
+      if (this.token) {
+        xhr.setRequestHeader("Authorization", `Bearer ${this.token}`)
+      } else {
+        xhr.withCredentials = true
+      }
+
+      if (opts.signal) {
+        if (opts.signal.aborted) {
+          reject(new SentroyError(0, null, "Upload aborted"))
+          return
+        }
+        opts.signal.addEventListener(
+          "abort",
+          () => {
+            try {
+              xhr.abort()
+            } catch {
+              /* noop */
+            }
+            reject(new SentroyError(0, null, "Upload aborted"))
+          },
+          { once: true },
+        )
+      }
+
+      if (opts.onProgress) {
+        xhr.upload.addEventListener("progress", (e) => {
+          if (e.lengthComputable) {
+            opts.onProgress!(e.loaded, e.total)
+          }
+        })
+      }
+
+      xhr.addEventListener("load", () => {
+        let json: { data?: T; error?: string } = {}
+        try {
+          json = JSON.parse(xhr.responseText) as { data?: T; error?: string }
+        } catch {
+          /* fall through with empty object */
+        }
+        if (xhr.status >= 200 && xhr.status < 300 && json.data !== undefined) {
+          resolve(json.data)
+        } else {
+          reject(
+            new SentroyError(
+              xhr.status,
+              json,
+              json.error || `Upload failed with status ${xhr.status}`,
+            ),
+          )
+        }
+      })
+
+      xhr.addEventListener("error", () =>
+        reject(new SentroyError(0, null, "Upload network error")),
+      )
+      xhr.addEventListener("timeout", () =>
+        reject(new SentroyError(0, null, "Upload timed out")),
+      )
+
+      xhr.send(form)
+    })
+  }
 }

package/src/react/MediaManager.tsx

@@ -9,6 +9,8 @@ import type { Sentroy } from ".."
 import type { Bucket, Media } from "../types"
 import { Lightbox } from "./lib/Lightbox"
 import { useMediaList } from "./lib/use-media-list"
+import { useUploadQueue } from "./lib/use-upload-queue"
+import { UploadQueuePanel } from "./lib/UploadQueuePanel"
 import { pickPresetThumbnailUrl } from "../thumbnails"
 import {
   cn,
@@ -97,6 +99,20 @@ export interface MediaManagerProps {
   showDetailsPane?: boolean
   /** Toolbar'da bucket selector görünsün mü (default true). */
   showBucketSelector?: boolean
+  /**
+   * Yükleme öncesi her dosya için çağrılan async hook. Caller dosyayı
+   * dönüştürebilir (örn. image crop), `null` döndürerek skip edebilir.
+   * Verilmezse dosyalar olduğu gibi yüklenir.
+   *
+   * @example Image crop
+   * ```ts
+   * preprocessFile={async (file) => {
+   *   if (!file.type.startsWith("image/")) return file
+   *   return await openCropDialog(file) // ya orijinal File ya cropped File
+   * }}
+   * ```
+   */
+  preprocessFile?: (file: File) => Promise<File | null>
 }
 
 const KIND_FILTERS: Array<{ value: MediaKind | "all"; label: string }> = [
@@ -126,6 +142,7 @@ export function MediaManager(props: MediaManagerProps) {
     classNames: cls = {},
     showDetailsPane = true,
     showBucketSelector = true,
+    preprocessFile,
   } = props
 
   // ── Bucket state ───────────────────────────────────────────────────────
@@ -237,24 +254,29 @@ export function MediaManager(props: MediaManagerProps) {
 
   // ── Upload ─────────────────────────────────────────────────────────────
   const fileInputRef = useRef<HTMLInputElement | null>(null)
-  const [uploading, setUploading] = useState(false)
   const [dragOver, setDragOver] = useState(false)
 
+  // Queue: per-file progress + abort + concurrency-pooled. Pre-upload hook
+  // (`preprocessFile`) image crop gibi caller-side transform yapabilir;
+  // null dönerse dosya skip, File dönerse o swap'lenir.
+  const queue = useUploadQueue(client, {
+    concurrency: 3,
+    onUploaded: () => setRefreshKey((k) => k + 1),
+  })
+  const uploading = queue.activeCount > 0
+
   const uploadFiles = useCallback(
     async (files: FileList | File[]) => {
       if (!activeBucketSlug) return
-      setUploading(true)
-      try {
-        const list = Array.from(files)
-        for (const file of list) {
-          await client.media.upload(activeBucketSlug, { body: file })
-        }
-        setRefreshKey((k) => k + 1)
-      } finally {
-        setUploading(false)
+      const incoming = Array.from(files)
+      const processed: File[] = []
+      for (const file of incoming) {
+        const out = preprocessFile ? await preprocessFile(file) : file
+        if (out) processed.push(out)
       }
+      if (processed.length > 0) queue.enqueue(activeBucketSlug, processed)
     },
-    [client, activeBucketSlug],
+    [activeBucketSlug, queue, preprocessFile],
   )
 
   // ── Delete ─────────────────────────────────────────────────────────────
@@ -638,6 +660,14 @@ export function MediaManager(props: MediaManagerProps) {
         />
       )}
 
+      {/* Upload queue panel — entries varsa görünür, alttan slide-in */}
+      <UploadQueuePanel
+        entries={queue.entries}
+        onCancel={queue.cancel}
+        onRemove={queue.remove}
+        onClearDone={queue.clearDone}
+      />
+
       {/* Lightbox */}
       {lightboxIdx !== null && visibleItems[lightboxIdx] && (
         <Lightbox