mudbase-sdk 1.1.8 → 1.2.1

package/src/apis/StorageApi.ts

@@ -0,0 +1,1119 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * MUDBASESDK
+ * MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: Flutterwave only for fiat (platform subscriptions + org payment processing with 7% + $0.50 split); crypto payment processor for multi-chain checkout - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API) 
+ *
+ * The version of the OpenAPI document: 1.2.1
+ * Contact: support@mudbase.dev
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import * as runtime from '../runtime';
+import type {
+  AuthRegister429Response,
+  BucketListResponse,
+  BucketResponse,
+  ConfirmUploadResponse,
+  CreateBucketRequest,
+  FileListResponse,
+  FileResponse,
+  FileUploadResponse,
+  MessageResponse,
+  PresignedPostResponse,
+  SignedUrlResponse,
+  StorageConfirmUpload400Response,
+  StorageConfirmUploadRequest,
+  StorageDownloadBucketFile403Response,
+  StorageDownloadBucketFile404Response,
+  StorageGetPresignedUploadRequest,
+  StorageGetSignedUrlRequest,
+  UpdateBucketRequest,
+  UploadFilesToBucketRequest,
+} from '../models/index';
+import {
+    AuthRegister429ResponseFromJSON,
+    AuthRegister429ResponseToJSON,
+    BucketListResponseFromJSON,
+    BucketListResponseToJSON,
+    BucketResponseFromJSON,
+    BucketResponseToJSON,
+    ConfirmUploadResponseFromJSON,
+    ConfirmUploadResponseToJSON,
+    CreateBucketRequestFromJSON,
+    CreateBucketRequestToJSON,
+    FileListResponseFromJSON,
+    FileListResponseToJSON,
+    FileResponseFromJSON,
+    FileResponseToJSON,
+    FileUploadResponseFromJSON,
+    FileUploadResponseToJSON,
+    MessageResponseFromJSON,
+    MessageResponseToJSON,
+    PresignedPostResponseFromJSON,
+    PresignedPostResponseToJSON,
+    SignedUrlResponseFromJSON,
+    SignedUrlResponseToJSON,
+    StorageConfirmUpload400ResponseFromJSON,
+    StorageConfirmUpload400ResponseToJSON,
+    StorageConfirmUploadRequestFromJSON,
+    StorageConfirmUploadRequestToJSON,
+    StorageDownloadBucketFile403ResponseFromJSON,
+    StorageDownloadBucketFile403ResponseToJSON,
+    StorageDownloadBucketFile404ResponseFromJSON,
+    StorageDownloadBucketFile404ResponseToJSON,
+    StorageGetPresignedUploadRequestFromJSON,
+    StorageGetPresignedUploadRequestToJSON,
+    StorageGetSignedUrlRequestFromJSON,
+    StorageGetSignedUrlRequestToJSON,
+    UpdateBucketRequestFromJSON,
+    UpdateBucketRequestToJSON,
+    UploadFilesToBucketRequestFromJSON,
+    UploadFilesToBucketRequestToJSON,
+} from '../models/index';
+
+export interface StorageConfirmUploadOperationRequest {
+    storageConfirmUploadRequest: StorageConfirmUploadRequest;
+}
+
+export interface StorageCreateBucketRequest {
+    projectId: string;
+    createBucketRequest: CreateBucketRequest;
+}
+
+export interface StorageDeleteBucketRequest {
+    projectId: string;
+    bucketId: string;
+}
+
+export interface StorageDeleteFileRequest {
+    projectId: string;
+    bucketId: string;
+    fileId: string;
+}
+
+export interface StorageDownloadBucketFileRequest {
+    fileId: string;
+    token?: string;
+}
+
+export interface StorageDownloadFileRequest {
+    fileId: string;
+    token?: string;
+}
+
+export interface StorageGetBucketRequest {
+    projectId: string;
+    bucketId: string;
+}
+
+export interface StorageGetFileRequest {
+    projectId: string;
+    bucketId: string;
+    fileId: string;
+}
+
+export interface StorageGetPresignedUploadOperationRequest {
+    storageGetPresignedUploadRequest: StorageGetPresignedUploadRequest;
+}
+
+export interface StorageGetSignedUrlOperationRequest {
+    projectId: string;
+    bucketId: string;
+    fileId: string;
+    storageGetSignedUrlRequest?: StorageGetSignedUrlRequest;
+}
+
+export interface StorageListBucketsRequest {
+    projectId: string;
+    page?: number;
+    limit?: number;
+    search?: string;
+}
+
+export interface StorageListFilesRequest {
+    projectId: string;
+    bucketId: string;
+    page?: number;
+    limit?: number;
+    search?: string;
+    type?: string;
+}
+
+export interface StorageUpdateBucketRequest {
+    projectId: string;
+    bucketId: string;
+    updateBucketRequest: UpdateBucketRequest;
+}
+
+export interface StorageUploadFilesRequest {
+    projectId: string;
+    bucketId: string;
+    uploadFilesToBucketRequest: UploadFilesToBucketRequest;
+}
+
+/**
+ * 
+ */
+export class StorageApi extends runtime.BaseAPI {
+
+    /**
+     * Creates request options for storageConfirmUpload without sending the request
+     */
+    async storageConfirmUploadRequestOpts(requestParameters: StorageConfirmUploadOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['storageConfirmUploadRequest'] == null) {
+            throw new runtime.RequiredError(
+                'storageConfirmUploadRequest',
+                'Required parameter "storageConfirmUploadRequest" was null or undefined when calling storageConfirmUpload().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuth authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/files/upload/confirm`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: StorageConfirmUploadRequestToJSON(requestParameters['storageConfirmUploadRequest']),
+        };
+    }
+
+    /**
+     * After a client uploads directly to S3 using the presigned POST, call this endpoint to have the server scan the object, create the File record, and optionally quarantine if infected.
+     * Confirm direct upload (scan + finalize metadata)
+     */
+    async storageConfirmUploadRaw(requestParameters: StorageConfirmUploadOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<ConfirmUploadResponse>> {
+        const requestOptions = await this.storageConfirmUploadRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => ConfirmUploadResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * After a client uploads directly to S3 using the presigned POST, call this endpoint to have the server scan the object, create the File record, and optionally quarantine if infected.
+     * Confirm direct upload (scan + finalize metadata)
+     */
+    async storageConfirmUpload(requestParameters: StorageConfirmUploadOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<ConfirmUploadResponse> {
+        const response = await this.storageConfirmUploadRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageCreateBucket without sending the request
+     */
+    async storageCreateBucketRequestOpts(requestParameters: StorageCreateBucketRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageCreateBucket().'
+            );
+        }
+
+        if (requestParameters['createBucketRequest'] == null) {
+            throw new runtime.RequiredError(
+                'createBucketRequest',
+                'Required parameter "createBucketRequest" was null or undefined when calling storageCreateBucket().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuth authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: CreateBucketRequestToJSON(requestParameters['createBucketRequest']),
+        };
+    }
+
+    /**
+     * Create a new storage bucket in a project. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Create a new bucket
+     */
+    async storageCreateBucketRaw(requestParameters: StorageCreateBucketRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BucketResponse>> {
+        const requestOptions = await this.storageCreateBucketRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BucketResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Create a new storage bucket in a project. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Create a new bucket
+     */
+    async storageCreateBucket(requestParameters: StorageCreateBucketRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BucketResponse> {
+        const response = await this.storageCreateBucketRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageDeleteBucket without sending the request
+     */
+    async storageDeleteBucketRequestOpts(requestParameters: StorageDeleteBucketRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageDeleteBucket().'
+            );
+        }
+
+        if (requestParameters['bucketId'] == null) {
+            throw new runtime.RequiredError(
+                'bucketId',
+                'Required parameter "bucketId" was null or undefined when calling storageDeleteBucket().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets/{bucketId}`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+        urlPath = urlPath.replace(`{${"bucketId"}}`, encodeURIComponent(String(requestParameters['bucketId'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Delete a storage bucket permanently. This is a destructive operation that will also delete all files in the bucket. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Delete bucket
+     */
+    async storageDeleteBucketRaw(requestParameters: StorageDeleteBucketRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessageResponse>> {
+        const requestOptions = await this.storageDeleteBucketRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => MessageResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Delete a storage bucket permanently. This is a destructive operation that will also delete all files in the bucket. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Delete bucket
+     */
+    async storageDeleteBucket(requestParameters: StorageDeleteBucketRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessageResponse> {
+        const response = await this.storageDeleteBucketRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageDeleteFile without sending the request
+     */
+    async storageDeleteFileRequestOpts(requestParameters: StorageDeleteFileRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageDeleteFile().'
+            );
+        }
+
+        if (requestParameters['bucketId'] == null) {
+            throw new runtime.RequiredError(
+                'bucketId',
+                'Required parameter "bucketId" was null or undefined when calling storageDeleteFile().'
+            );
+        }
+
+        if (requestParameters['fileId'] == null) {
+            throw new runtime.RequiredError(
+                'fileId',
+                'Required parameter "fileId" was null or undefined when calling storageDeleteFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId}`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+        urlPath = urlPath.replace(`{${"bucketId"}}`, encodeURIComponent(String(requestParameters['bucketId'])));
+        urlPath = urlPath.replace(`{${"fileId"}}`, encodeURIComponent(String(requestParameters['fileId'])));
+
+        return {
+            path: urlPath,
+            method: 'DELETE',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Delete a file from a bucket permanently. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Delete file
+     */
+    async storageDeleteFileRaw(requestParameters: StorageDeleteFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<MessageResponse>> {
+        const requestOptions = await this.storageDeleteFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => MessageResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Delete a file from a bucket permanently. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Delete file
+     */
+    async storageDeleteFile(requestParameters: StorageDeleteFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<MessageResponse> {
+        const response = await this.storageDeleteFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageDownloadBucketFile without sending the request
+     */
+    async storageDownloadBucketFileRequestOpts(requestParameters: StorageDownloadBucketFileRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['fileId'] == null) {
+            throw new runtime.RequiredError(
+                'fileId',
+                'Required parameter "fileId" was null or undefined when calling storageDownloadBucketFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['token'] != null) {
+            queryParameters['token'] = requestParameters['token'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/bucket/files/{fileId}/download`;
+        urlPath = urlPath.replace(`{${"fileId"}}`, encodeURIComponent(String(requestParameters['fileId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Download a file from a bucket. For public files, no authentication is required. For private files, a download token (obtained via signed URL endpoint) is required in the query parameter. Accepts: Token-based authentication via query parameter (for private files), or no authentication (for public files). 
+     * Download file from bucket
+     */
+    async storageDownloadBucketFileRaw(requestParameters: StorageDownloadBucketFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<Blob>> {
+        const requestOptions = await this.storageDownloadBucketFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.BlobApiResponse(response);
+    }
+
+    /**
+     * Download a file from a bucket. For public files, no authentication is required. For private files, a download token (obtained via signed URL endpoint) is required in the query parameter. Accepts: Token-based authentication via query parameter (for private files), or no authentication (for public files). 
+     * Download file from bucket
+     */
+    async storageDownloadBucketFile(requestParameters: StorageDownloadBucketFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<Blob> {
+        const response = await this.storageDownloadBucketFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageDownloadFile without sending the request
+     */
+    async storageDownloadFileRequestOpts(requestParameters: StorageDownloadFileRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['fileId'] == null) {
+            throw new runtime.RequiredError(
+                'fileId',
+                'Required parameter "fileId" was null or undefined when calling storageDownloadFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['token'] != null) {
+            queryParameters['token'] = requestParameters['token'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuth authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/files/{fileId}/download`;
+        urlPath = urlPath.replace(`{${"fileId"}}`, encodeURIComponent(String(requestParameters['fileId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Returns a time-limited provider-signed URL (S3) for direct download. Server enforces RBAC before issuing the URL.
+     * Generate a presigned URL for downloading a file
+     */
+    async storageDownloadFileRaw(requestParameters: StorageDownloadFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SignedUrlResponse>> {
+        const requestOptions = await this.storageDownloadFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SignedUrlResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Returns a time-limited provider-signed URL (S3) for direct download. Server enforces RBAC before issuing the URL.
+     * Generate a presigned URL for downloading a file
+     */
+    async storageDownloadFile(requestParameters: StorageDownloadFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SignedUrlResponse> {
+        const response = await this.storageDownloadFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageGetBucket without sending the request
+     */
+    async storageGetBucketRequestOpts(requestParameters: StorageGetBucketRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageGetBucket().'
+            );
+        }
+
+        if (requestParameters['bucketId'] == null) {
+            throw new runtime.RequiredError(
+                'bucketId',
+                'Required parameter "bucketId" was null or undefined when calling storageGetBucket().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuth authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets/{bucketId}`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+        urlPath = urlPath.replace(`{${"bucketId"}}`, encodeURIComponent(String(requestParameters['bucketId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Retrieve metadata and configuration for a single storage bucket, including name, project, public/private status, and settings. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Get bucket details
+     */
+    async storageGetBucketRaw(requestParameters: StorageGetBucketRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BucketResponse>> {
+        const requestOptions = await this.storageGetBucketRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BucketResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Retrieve metadata and configuration for a single storage bucket, including name, project, public/private status, and settings. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Get bucket details
+     */
+    async storageGetBucket(requestParameters: StorageGetBucketRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BucketResponse> {
+        const response = await this.storageGetBucketRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageGetFile without sending the request
+     */
+    async storageGetFileRequestOpts(requestParameters: StorageGetFileRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageGetFile().'
+            );
+        }
+
+        if (requestParameters['bucketId'] == null) {
+            throw new runtime.RequiredError(
+                'bucketId',
+                'Required parameter "bucketId" was null or undefined when calling storageGetFile().'
+            );
+        }
+
+        if (requestParameters['fileId'] == null) {
+            throw new runtime.RequiredError(
+                'fileId',
+                'Required parameter "fileId" was null or undefined when calling storageGetFile().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuth authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId}`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+        urlPath = urlPath.replace(`{${"bucketId"}}`, encodeURIComponent(String(requestParameters['bucketId'])));
+        urlPath = urlPath.replace(`{${"fileId"}}`, encodeURIComponent(String(requestParameters['fileId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * Get metadata for a specific file in a bucket. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Get file metadata
+     */
+    async storageGetFileRaw(requestParameters: StorageGetFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileResponse>> {
+        const requestOptions = await this.storageGetFileRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Get metadata for a specific file in a bucket. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Get file metadata
+     */
+    async storageGetFile(requestParameters: StorageGetFileRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileResponse> {
+        const response = await this.storageGetFileRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageGetPresignedUpload without sending the request
+     */
+    async storageGetPresignedUploadRequestOpts(requestParameters: StorageGetPresignedUploadOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['storageGetPresignedUploadRequest'] == null) {
+            throw new runtime.RequiredError(
+                'storageGetPresignedUploadRequest',
+                'Required parameter "storageGetPresignedUploadRequest" was null or undefined when calling storageGetPresignedUpload().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuth authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/files/upload/presigned`;
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: StorageGetPresignedUploadRequestToJSON(requestParameters['storageGetPresignedUploadRequest']),
+        };
+    }
+
+    /**
+     * Issue a presigned POST (fields + url) for clients to upload directly to S3. The server stores the issued key with expiry and RBAC is enforced.
+     * Generate presigned POST data for direct browser upload
+     */
+    async storageGetPresignedUploadRaw(requestParameters: StorageGetPresignedUploadOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PresignedPostResponse>> {
+        const requestOptions = await this.storageGetPresignedUploadRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => PresignedPostResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Issue a presigned POST (fields + url) for clients to upload directly to S3. The server stores the issued key with expiry and RBAC is enforced.
+     * Generate presigned POST data for direct browser upload
+     */
+    async storageGetPresignedUpload(requestParameters: StorageGetPresignedUploadOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PresignedPostResponse> {
+        const response = await this.storageGetPresignedUploadRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageGetSignedUrl without sending the request
+     */
+    async storageGetSignedUrlRequestOpts(requestParameters: StorageGetSignedUrlOperationRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageGetSignedUrl().'
+            );
+        }
+
+        if (requestParameters['bucketId'] == null) {
+            throw new runtime.RequiredError(
+                'bucketId',
+                'Required parameter "bucketId" was null or undefined when calling storageGetSignedUrl().'
+            );
+        }
+
+        if (requestParameters['fileId'] == null) {
+            throw new runtime.RequiredError(
+                'fileId',
+                'Required parameter "fileId" was null or undefined when calling storageGetSignedUrl().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuth authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets/{bucketId}/files/{fileId}/signed-url`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+        urlPath = urlPath.replace(`{${"bucketId"}}`, encodeURIComponent(String(requestParameters['bucketId'])));
+        urlPath = urlPath.replace(`{${"fileId"}}`, encodeURIComponent(String(requestParameters['fileId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: StorageGetSignedUrlRequestToJSON(requestParameters['storageGetSignedUrlRequest']),
+        };
+    }
+
+    /**
+     * Generate a time-limited signed URL for downloading a private file. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Generate signed URL for file
+     */
+    async storageGetSignedUrlRaw(requestParameters: StorageGetSignedUrlOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<SignedUrlResponse>> {
+        const requestOptions = await this.storageGetSignedUrlRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => SignedUrlResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Generate a time-limited signed URL for downloading a private file. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Generate signed URL for file
+     */
+    async storageGetSignedUrl(requestParameters: StorageGetSignedUrlOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<SignedUrlResponse> {
+        const response = await this.storageGetSignedUrlRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageListBuckets without sending the request
+     */
+    async storageListBucketsRequestOpts(requestParameters: StorageListBucketsRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageListBuckets().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['page'] != null) {
+            queryParameters['page'] = requestParameters['page'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['search'] != null) {
+            queryParameters['search'] = requestParameters['search'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List all storage buckets in a project with pagination and search. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * List buckets in a project
+     */
+    async storageListBucketsRaw(requestParameters: StorageListBucketsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BucketListResponse>> {
+        const requestOptions = await this.storageListBucketsRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BucketListResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List all storage buckets in a project with pagination and search. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * List buckets in a project
+     */
+    async storageListBuckets(requestParameters: StorageListBucketsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BucketListResponse> {
+        const response = await this.storageListBucketsRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageListFiles without sending the request
+     */
+    async storageListFilesRequestOpts(requestParameters: StorageListFilesRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageListFiles().'
+            );
+        }
+
+        if (requestParameters['bucketId'] == null) {
+            throw new runtime.RequiredError(
+                'bucketId',
+                'Required parameter "bucketId" was null or undefined when calling storageListFiles().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['page'] != null) {
+            queryParameters['page'] = requestParameters['page'];
+        }
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['search'] != null) {
+            queryParameters['search'] = requestParameters['search'];
+        }
+
+        if (requestParameters['type'] != null) {
+            queryParameters['type'] = requestParameters['type'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets/{bucketId}/files`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+        urlPath = urlPath.replace(`{${"bucketId"}}`, encodeURIComponent(String(requestParameters['bucketId'])));
+
+        return {
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        };
+    }
+
+    /**
+     * List files in a bucket with pagination, search, and optional type filter. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * List files in bucket
+     */
+    async storageListFilesRaw(requestParameters: StorageListFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileListResponse>> {
+        const requestOptions = await this.storageListFilesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileListResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * List files in a bucket with pagination, search, and optional type filter. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * List files in bucket
+     */
+    async storageListFiles(requestParameters: StorageListFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileListResponse> {
+        const response = await this.storageListFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageUpdateBucket without sending the request
+     */
+    async storageUpdateBucketRequestOpts(requestParameters: StorageUpdateBucketRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageUpdateBucket().'
+            );
+        }
+
+        if (requestParameters['bucketId'] == null) {
+            throw new runtime.RequiredError(
+                'bucketId',
+                'Required parameter "bucketId" was null or undefined when calling storageUpdateBucket().'
+            );
+        }
+
+        if (requestParameters['updateBucketRequest'] == null) {
+            throw new runtime.RequiredError(
+                'updateBucketRequest',
+                'Required parameter "updateBucketRequest" was null or undefined when calling storageUpdateBucket().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets/{bucketId}`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+        urlPath = urlPath.replace(`{${"bucketId"}}`, encodeURIComponent(String(requestParameters['bucketId'])));
+
+        return {
+            path: urlPath,
+            method: 'PATCH',
+            headers: headerParameters,
+            query: queryParameters,
+            body: UpdateBucketRequestToJSON(requestParameters['updateBucketRequest']),
+        };
+    }
+
+    /**
+     * Update bucket configuration (name, public/private status, settings). Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Update bucket
+     */
+    async storageUpdateBucketRaw(requestParameters: StorageUpdateBucketRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<BucketResponse>> {
+        const requestOptions = await this.storageUpdateBucketRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => BucketResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Update bucket configuration (name, public/private status, settings). Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Update bucket
+     */
+    async storageUpdateBucket(requestParameters: StorageUpdateBucketRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<BucketResponse> {
+        const response = await this.storageUpdateBucketRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+    /**
+     * Creates request options for storageUploadFiles without sending the request
+     */
+    async storageUploadFilesRequestOpts(requestParameters: StorageUploadFilesRequest): Promise<runtime.RequestOpts> {
+        if (requestParameters['projectId'] == null) {
+            throw new runtime.RequiredError(
+                'projectId',
+                'Required parameter "projectId" was null or undefined when calling storageUploadFiles().'
+            );
+        }
+
+        if (requestParameters['bucketId'] == null) {
+            throw new runtime.RequiredError(
+                'bucketId',
+                'Required parameter "bucketId" was null or undefined when calling storageUploadFiles().'
+            );
+        }
+
+        if (requestParameters['uploadFilesToBucketRequest'] == null) {
+            throw new runtime.RequiredError(
+                'uploadFilesToBucketRequest',
+                'Required parameter "uploadFilesToBucketRequest" was null or undefined when calling storageUploadFiles().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+        headerParameters['Content-Type'] = 'application/json';
+
+        if (this.configuration && this.configuration.apiKey) {
+            headerParameters["X-API-Key"] = await this.configuration.apiKey("X-API-Key"); // ApiKeyAuth authentication
+        }
+
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("BearerToken", []);
+
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+
+        let urlPath = `/api/bucket/projects/{projectId}/buckets/{bucketId}/files`;
+        urlPath = urlPath.replace(`{${"projectId"}}`, encodeURIComponent(String(requestParameters['projectId'])));
+        urlPath = urlPath.replace(`{${"bucketId"}}`, encodeURIComponent(String(requestParameters['bucketId'])));
+
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: UploadFilesToBucketRequestToJSON(requestParameters['uploadFilesToBucketRequest']),
+        };
+    }
+
+    /**
+     * Upload one or more files to a storage bucket using multipart/form-data. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Upload files to bucket
+     */
+    async storageUploadFilesRaw(requestParameters: StorageUploadFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FileUploadResponse>> {
+        const requestOptions = await this.storageUploadFilesRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FileUploadResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * Upload one or more files to a storage bucket using multipart/form-data. Accepts BearerToken (JWT) or ApiKeyAuth (X-API-Key). 
+     * Upload files to bucket
+     */
+    async storageUploadFiles(requestParameters: StorageUploadFilesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FileUploadResponse> {
+        const response = await this.storageUploadFilesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
+}