fix: upload URL size arg AdminForth/2032/fix-upload-plugin-and-storage-

StorageAdapter.getUploadSignedUrl gets an optional contentLength. When
it is passed, the adapter binds the upload URL to that exact size, so a
client can't declare a small file and upload a bigger one. Adapters
that ignore the argument keep working.

Author: srelon

adminforth/types/adapters/StorageAdapter.ts

@@ -15,10 +15,11 @@ export interface StorageAdapter {
    * @param key - The key of the file to be uploaded e.g. "uploads/file.txt"
    * @param expiresIn - The expiration time in seconds for the presigned URL
    * @param contentType - The content type of the file to be uploaded, e.g. "image/png"
+   * @param contentLength - Optional exact size of the file in bytes. When passed, the upload should be rejected if the body has another size.
    * 
    * @returns A promise that resolves to an object containing the upload URL and any extra parameters which should be sent with PUT multipart form data
    */
-  getUploadSignedUrl(key: string, contentType: string, expiresIn?: number): Promise<{
+  getUploadSignedUrl(key: string, contentType: string, expiresIn?: number, contentLength?: number): Promise<{
     uploadUrl: string;
     uploadExtraParams?: Record<string, string>;
   }>;