SDK ذخیره‌سازی full-stack فایل: یک API از سرور Next.js تا مرورگر React

ذخیره‌سازی full-stack فایل معمولاً سه پیاده‌سازی است: route آپلود سرور، فرم کلاینت و داشبورد با API دیگر. Files SDK این را یک مشکل می‌داند—یک API ذخیره‌سازی از سرور تا مرورگر.

اگر **SDK ذخیره‌سازی فایل full-stack** برای Next.js یا پورتال مشتری ارزیابی می‌کنید، این release ارزش دیدن دارد: gateway، کلاینت مرورگر، آداپتر فریم‌ورک و shadcn/ui اختیاری روی همان فعل‌ها.

یک gateway، سطح‌های متعدد

هسته: **`@files-sdk/api`**. یک endpoint برای upload و download و list و search و url و copy و move و delete و capabilities و URL امضاشده.

سرور: **`@files-sdk/next`** و **`@files-sdk/hono`** و Express و Fastify و Koa و Elysia و Nitro و SvelteKit و Astro و Bun و Deno. کلاینت: **`createFilesClient`**؛ **`useFiles`** برای React و Vue و Svelte با **`useList`** و **`useFile`** و **`useSearch`**. با **`versioning()`** یا **`softDelete()`**: نسخه‌ها، restore، سطل زباله، purge.

چرا stackهای جدا می‌شکنند

Route handler + dropzone تا presign و Range و سطل زباله یا مجوز prefix کافی است. بدون **gateway API ذخیره‌سازی فایل**، هر feature یک route جدید و auth پراکنده می‌شود.

Auth و transport

**Deny-by-default** برای هر عملیات: prefix کلید، انقضا، read-only، allowlist مبدأ. دانلود redirect یا **proxy stream**؛ proxy با **Range/206** و قطع خوانش upstream وقتی کلاینت قطع شود. آپلود **presign → complete** با fallback proxy.

آداپترهای سرور

برای **Files SDK Next.js**: یک route با مجموعه کامل فعل‌ها. همان قرارداد روی Hono و Express—auth یک‌بار، کلاینت یکسان روی Vercel یا VPS.

React hooks آپلود

**`createFilesClient`** تایپ‌شده؛ **`useFiles`** با progress و خطا. Versioning و soft delete در همان API کلاینت—not لایه admin جدا.

registry shadcn/ui

کامپوننت‌ها روی **`useFiles`**: dropzone، مرورگر + breadcrumbs، search، preview، share، progress، actions، تاریخچه نسخه، سطل زباله.

کی SDK و کی custom

• آپلود مرورگر + پردازش سرور در یک namespace
• Presign و proxy بدون دو codebase
• Versioning یا trash به‌عنوان نیاز محصول
• چند فریم‌ورک، یک سیاست bucket
• UI shadcn بدون file manager سفارشی

چک‌لیست

• mount **`@files-sdk/api`**
• قوانین deny-by-default
• Redirect در برابر proxy downloads
• **`createFilesClient`** + allowlists
• **`useFiles`** در فرم‌ها و admin
• shadcn: اول dropzone
• تست presign روی شبکه کند

برای آژانس‌ها

پورتال مشتری و کتابخانه asset با permission سفارشی گیر می‌کند. **SDK full-stack** upload و list و search و delete را یکی می‌کند.

جمع‌بندی

شرط **one-storage-API**: gateway، آداپترها، **`createFilesClient`**، **`useFiles`**، shadcn—همان فعل‌های Files. نظر دوم در معماری آپلود؟ تماس بگیرید.