arckode-framework 1.3.0 → 1.3.1

package/README.md

@@ -317,13 +317,63 @@ await mail.send({ to: 'user@example.com', subject: 'Bienvenido', html: '<p>Hola<
 ### Storage
 
 ```ts
-import { StorageService } from 'arckode-framework/storage'
-import { LocalAdapter } from 'arckode-framework/storage/local'
+import { StorageService } from 'arckode-framework/modules/storage'
+import { LocalStorageAdapter } from 'arckode-framework/modules/storage/local-adapter'
+
+// En composition-root.ts
+const storage = new StorageService(
+  new LocalStorageAdapter('./uploads', '/uploads')
+)
+
+// Subir un archivo
+const stored = await storage.upload(file, 'avatars')
+// stored.url  → '/uploads/avatars/1234567890-abc.jpg'
+// stored.path → 'avatars/1234567890-abc.jpg'
+```
+
+### File Uploads (multipart/form-data)
+
+El servidor detecta `Content-Type: multipart/form-data` automáticamente y parsea el body
+sin dependencias externas. Los archivos quedan en `req.files`, los campos de texto en `req.body`.
+
+```ts
+import type { UploadedFile } from 'arckode-framework'
+import { ValidationError } from 'arckode-framework'
 
-const storage = new StorageService(new LocalAdapter({ path: './uploads' }))
-const url = await storage.save('avatars/user.png', fileBuffer)
+router.post('/avatar', [auth.authenticate()], async (req) => {
+  const file = req.files?.['avatar']
+  if (!file) throw new ValidationError('Se requiere un archivo')
+
+  const stored = await storageService.upload(file, 'avatars')
+  return { status: 200, body: { url: stored.url } }
+})
 ```
 
+**Desde el cliente:**
+
+```ts
+const form = new FormData()
+form.append('avatar', blob, 'photo.jpg')
+await fetch('/avatar', { method: 'POST', body: form })
+```
+
+**Estructura de `UploadedFile`:**
+
+```ts
+interface UploadedFile {
+  fieldName: string     // nombre del campo en el form
+  originalName: string  // nombre del archivo enviado
+  buffer: Buffer        // contenido binario
+  mimeType: string      // 'image/jpeg', 'application/pdf', etc.
+  size: number          // bytes
+}
+```
+
+> Combiná con `bodyLimit()` para limitar el tamaño máximo:
+> ```ts
+> router.post('/avatar', [bodyLimit(5 * 1024 * 1024)], handler)  // 5MB máx
+> ```
+
 ---
 
 ## Middlewares

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arckode-framework",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "AI-first TypeScript/Bun framework. Modular, SOLID, zero magic. The AI reads the composition root and knows everything.",
   "type": "module",
   "main": "./kernel/framework.ts",
@@ -17,6 +17,7 @@
     "./adapters/mysql": "./adapters/mysql.ts",
     "./modules/mail": "./modules/mail/index.ts",
     "./modules/storage": "./modules/storage/index.ts",
+    "./modules/storage/local-adapter": "./modules/storage/local-adapter.ts",
     "./modules/queue": "./modules/queue/index.ts",
     "./testing": "./kernel/testing.ts"
   },