Release v1.9.0 - Expanded REST API, built-in archive viewer & extractor, drag-and-drop file movement, context menu enhancements, and thumbnail resolution fixes.

Author: Cameron Amer

CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [1.9.0] - 2026-06-16
+
+### Features & Bug Fixes
+
+- **Expanded REST API Interface**
+  - Upgraded the REST API server to a fully functional programmatic Cloud Drive interface.
+  - Implemented secure API key authentication and endpoints for file upload (via multipart forms), renaming, moving, copying, and deletion.
+  - Added folder CRUD endpoints to manage Telegram channels programmatically.
+  - Added endpoints for storage statistics, duplicate detection, empty folder discovery, and media metadata inspection.
+  - Implemented a streaming ZIP archive generation endpoint for downloading bulk files.
+
+- **Built-in Archive Viewer & Extractor**
+  - Added support for viewing the contents of ZIP, RAR, and 7Z archives directly inside the application.
+  - Implemented archive extraction capabilities to extract files to local storage or re-upload them.
+
+- **Drag and Drop Interface**
+  - Integrated drag-and-drop mechanics inside the file explorer to move files between folder views dynamically.
+
+- **Context Menu Alignment**
+  - Refined context menu positioning, boundaries, and quick-action menu options.
+
+- **Thumbnail Resolution & Scoping**
+  - Fixed duplicate thumbnail displays by scoping cache lookups and storage directories under folder-specific keys.
+
+---
+
 ## [1.8.8] - 2026-06-12
 
 ### Features & Caching Polish

REST_API_Documentation.md

@@ -36,16 +36,11 @@ Check API availability, status, and running version.
 * **Method:** `GET`
 * **Auth Required:** No
 
-#### Example Request
-```bash
-curl http://localhost:8550/api/v1/health
-```
-
 #### Response (200 OK)
 ```json
 {
   "status": "ok",
-  "version": "1.8.4"
+  "version": "1.8.8"
 }
 ```
 
@@ -68,19 +63,10 @@ Retrieve metadata for files stored in Telegram Drive.
 | `search` | String | Filter files by matching search term in filename |
 | `offset_id` | Integer | Message ID offset for pagination |
 | `sort` | String | Field to sort by: `name`, `size`, or `created_at` |
-| `order` | String | Sort order: `asc` (ascending) or `desc` (descending) |
+| `order` | String | Sort order: `asc` or `desc` |
 | `mime_type` | String | Filter files by a specific MIME type |
-| `created_after` | String | Filter files created after date (ISO format) |
-| `created_before` | String | Filter files created before date (ISO format) |
 | `size_min` | Integer | Minimum file size in bytes |
 | `size_max` | Integer | Maximum file size in bytes |
-| `fields` | String | Comma-separated list of fields to include in response |
-
-#### Example Request
-```bash
-curl -H "X-API-Key: YOUR_API_KEY" \
-  "http://localhost:8550/api/v1/files?page=1&limit=20"
-```
 
 #### Response (200 OK)
 ```json
@@ -102,12 +88,6 @@ Retrieve detailed metadata for a specific file.
 * **Method:** `GET`
 * **Auth Required:** Yes
 
-#### Example Request
-```bash
-curl -H "X-API-Key: YOUR_API_KEY" \
-  http://localhost:8550/api/v1/files/123
-```
-
 #### Response (200 OK)
 ```json
 {
@@ -129,18 +109,6 @@ Stream or download a file directly from Telegram Drive.
 * **Method:** `GET`
 * **Auth Required:** Yes
 
-#### Features Supported
-* **HTTP Range Requests** (e.g., seeking in videos/audios)
-* **Resumable Downloads**
-* **Direct Content Streaming**
-
-#### Example Request
-```bash
-curl -H "X-API-Key: YOUR_API_KEY" \
-  -o file.bin \
-  http://localhost:8550/api/v1/files/123/download
-```
-
 ---
 
 ### 5. Search Files
@@ -155,127 +123,202 @@ Search files by filename with optional filtering.
 | Parameter | Type | Description |
 | :--- | :--- | :--- |
 | `q` | String | **Required.** Search query string |
-| `folder_id` | Integer | Optional folder ID filter |
-| `recursive` | Boolean | Perform recursive search across folders |
 
-#### Example Request
-```bash
-curl -H "X-API-Key: YOUR_API_KEY" \
-  "http://localhost:8550/api/v1/files/search?q=python"
-```
+---
+
+### 6. Upload File
+Upload a file to Telegram Drive.
+
+* **URL:** `/files`
+* **Method:** `POST`
+* **Auth Required:** Yes
+* **Content-Type:** `multipart/form-data`
+
+#### Form Fields
+* `file`: Binary file content
+* `folder_id` (Optional): ID of target folder/channel
 
 #### Response (200 OK)
 ```json
-[
-  {
-    "id": 123,
-    "name": "python-guide.pdf",
-    "size": 204800
-  }
-]
+{
+  "id": 123,
+  "folder_id": 456,
+  "name": "uploaded_file.txt",
+  "size": 1024,
+  "mime_type": "text/plain",
+  "created_at": "2026-06-16T01:00:00Z"
+}
 ```
 
 ---
 
-### 6. Bulk Operations
-Perform action operations (such as move or delete) across multiple files.
+### 7. Delete File
+Delete a specific file.
 
-* **URL:** `/files/bulk`
+* **URL:** `/files/{message_id}`
+* **Method:** `DELETE`
+* **Auth Required:** Yes
+
+#### Query Parameters
+* `folder_id` (Optional): ID of folder containing the file
+
+---
+
+### 8. Copy File
+Forward a file/message to another folder.
+
+* **URL:** `/files/{message_id}/copy`
 * **Method:** `POST`
 * **Auth Required:** Yes
 
-#### Bulk Delete Request Body
+#### Request Body
 ```json
 {
-  "action": "delete",
-  "file_ids": [123, 124, 125]
+  "folder_id": 789,
+  "source_folder_id": 456
 }
 ```
 
-#### Example Delete Request
-```bash
-curl -X POST \
-  -H "Content-Type: application/json" \
-  -H "X-API-Key: YOUR_API_KEY" \
-  -d '{"action":"delete","file_ids":[123,124]}' \
-  http://localhost:8550/api/v1/files/bulk
-```
+---
+
+### 9. Update File (Rename / Move)
+Rename (edit description) or move a file.
+
+* **URL:** `/files/{message_id}`
+* **Method:** `PATCH`
+* **Auth Required:** Yes
 
-#### Bulk Move Request Body
+#### Request Body (All fields optional)
 ```json
 {
-  "action": "move",
-  "file_ids": [123],
-  "folder_id": 111,
-  "payload": {
-    "folder_id": 222
-  }
+  "name": "new_name.txt",
+  "folder_id": 789,
+  "source_folder_id": 456
 }
 ```
 
-#### Example Move Request
-```bash
-curl -X POST \
-  -H "Content-Type: application/json" \
-  -H "X-API-Key: YOUR_API_KEY" \
-  -d '{"action":"move","file_ids":[123],"folder_id":111,"payload":{"folder_id":222}}' \
-  http://localhost:8550/api/v1/files/bulk
-```
+---
+
+### 10. Folder Management
+
+#### List Folders
+* **URL:** `/folders`
+* **Method:** `GET`
+
+#### Create Folder
+* **URL:** `/folders`
+* **Method:** `POST`
+* Request Body: `{"name": "New Folder"}`
+
+#### Rename Folder
+* **URL:** `/folders/{folder_id}`
+* **Method:** `PATCH`
+* Request Body: `{"name": "New Folder Name"}`
+
+#### Delete Folder
+* **URL:** `/folders/{folder_id}`
+* **Method:** `DELETE`
+
+---
+
+### 11. Storage Stats & Analytics
+
+#### Storage Stats
+Retrieve total storage consumed, file counts, and breakdown by folders and MIME types.
+* **URL:** `/storage/stats`
+* **Method:** `GET`
 
 #### Response (200 OK)
 ```json
 {
-  "success": true,
-  "count": 1
+  "total_storage_used_bytes": 10485760,
+  "total_file_count": 12,
+  "folders": [
+    { "id": 456, "name": "Documents", "file_count": 5, "size_bytes": 5242880 }
+  ],
+  "mime_types": [
+    { "mime_type": "application/pdf", "file_count": 5, "size_bytes": 5242880 }
+  ]
 }
 ```
 
+#### Duplicate Files Finder
+List groups of files with identical filenames and sizes.
+* **URL:** `/storage/duplicates`
+* **Method:** `GET`
+
+#### Empty Folders
+List folders that do not contain any files.
+* **URL:** `/folders/empty`
+* **Method:** `GET`
+
 ---
 
-## Error Responses
+### 12. File Media & Thumbnails
 
-The API returns standardized JSON error formats on failure:
+#### Get File Thumbnail
+Return the raw binary image data for a file's thumbnail.
+* **URL:** `/files/{message_id}/thumbnail`
+* **Method:** `GET`
+* Query Param: `folder_id` (Optional)
+
+#### Get Extended Media Info
+Return video duration, resolution, audio title, or audio performer metadata.
+* **URL:** `/files/{message_id}/media-info`
+* **Method:** `GET`
+* Query Param: `folder_id` (Optional)
+
+---
+
+### 13. Bulk Operations
+Perform action operations (such as move, delete, or archive) across multiple files.
 
-### Unauthorized (Invalid API Key)
-* **Status:** `401 Unauthorized`
+* **URL:** `/files/bulk`
+* **Method:** `POST`
+* **Auth Required:** Yes
+
+#### Bulk Archive (Zip Download)
+Download selected files as a zip archive stream.
 ```json
 {
-  "error": {
-    "code": "UNAUTHORIZED",
-    "message": "Invalid API key"
-  }
+  "action": "archive",
+  "file_ids": [123, 124, 125],
+  "folder_id": 456
 }
 ```
 
-### Missing API Key
-* **Status:** `401 Unauthorized`
+#### Bulk Delete
 ```json
 {
-  "error": {
-    "code": "UNAUTHORIZED",
-    "message": "Missing X-API-Key header"
-  }
+  "action": "delete",
+  "file_ids": [123, 124, 125],
+  "folder_id": 456
 }
 ```
 
-### File Not Found
-* **Status:** `404 Not Found`
+#### Bulk Move
 ```json
 {
-  "error": {
-    "code": "NOT_FOUND",
-    "message": "File not found"
+  "action": "move",
+  "file_ids": [123],
+  "folder_id": 111,
+  "payload": {
+    "folder_id": 222
   }
 }
 ```
 
-### Invalid Request Action
-* **Status:** `400 Bad Request`
+---
+
+## Error Responses
+
+The API returns standardized JSON error formats on failure:
+
 ```json
 {
   "error": {
-    "code": "INVALID_ACTION",
-    "message": "Unsupported bulk action"
+    "code": "UNAUTHORIZED",
+    "message": "Invalid API key"
   }
 }
 ```

app/package.json

@@ -1,7 +1,7 @@
 {
   "name": "app",
   "private": true,
-  "version": "1.8.8",
+  "version": "1.9.0",
   "type": "module",
   "scripts": {
     "dev": "vite",