@rovela-ai/sdk 0.1.25 → 0.1.27

package/dist/media/config.js

@@ -0,0 +1,142 @@
+/**
+ * @rovela-ai/sdk/media/config
+ *
+ * Media storage configuration.
+ * Loads R2/S3 credentials from environment variables.
+ */
+// =============================================================================
+// Environment Variable Loading
+// =============================================================================
+/**
+ * Get media storage configuration from environment variables.
+ * Returns null if required variables are missing.
+ */
+export function getMediaConfig() {
+    const accountId = process.env.R2_ACCOUNT_ID;
+    const accessKeyId = process.env.R2_ACCESS_KEY_ID;
+    const secretAccessKey = process.env.R2_SECRET_ACCESS_KEY;
+    const bucketName = process.env.R2_BUCKET_NAME;
+    const publicUrl = process.env.R2_PUBLIC_URL;
+    const storeId = process.env.STORE_ID;
+    // All are required
+    if (!accountId || !accessKeyId || !secretAccessKey || !bucketName || !publicUrl || !storeId) {
+        return null;
+    }
+    return {
+        accountId,
+        accessKeyId,
+        secretAccessKey,
+        bucketName,
+        publicUrl,
+        storeId,
+    };
+}
+/**
+ * Check if media storage is configured
+ */
+export function isMediaConfigured() {
+    return getMediaConfig() !== null;
+}
+/**
+ * Get media configuration or throw an error if not configured.
+ * Use this in API routes where configuration is required.
+ */
+export function requireMediaConfig() {
+    const config = getMediaConfig();
+    if (!config) {
+        throw new Error('Media storage not configured. Required environment variables: ' +
+            'R2_ACCOUNT_ID, R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY, R2_BUCKET_NAME, R2_PUBLIC_URL, STORE_ID');
+    }
+    return config;
+}
+// =============================================================================
+// Upload Configuration
+// =============================================================================
+/**
+ * Default upload configuration
+ */
+export const defaultUploadConfig = {
+    maxSizeBytes: 10 * 1024 * 1024, // 10MB
+    allowedTypes: ['image/jpeg', 'image/png', 'image/webp', 'image/gif'],
+    maxFiles: 10,
+};
+/**
+ * Get upload configuration with optional overrides
+ */
+export function getUploadConfig(overrides) {
+    return {
+        ...defaultUploadConfig,
+        ...overrides,
+    };
+}
+// =============================================================================
+// Path Helpers
+// =============================================================================
+/**
+ * Build the storage key (path) for a file.
+ *
+ * Structure: stores/{storeId}/{folder}/{entityId?}/{filename}
+ *
+ * Examples:
+ * - stores/abc123/products/prod456/1699999999_abc123.jpg
+ * - stores/abc123/categories/cat789/cover.jpg
+ * - stores/abc123/general/1699999999_abc123.jpg
+ */
+export function buildStorageKey(storeId, folder, filename, entityId) {
+    const parts = ['stores', storeId, folder];
+    if (entityId) {
+        parts.push(entityId);
+    }
+    parts.push(filename);
+    return parts.join('/');
+}
+/**
+ * Build the public URL for a stored file
+ */
+export function buildPublicUrl(publicBaseUrl, key) {
+    // Remove trailing slash from base URL if present
+    const baseUrl = publicBaseUrl.endsWith('/') ? publicBaseUrl.slice(0, -1) : publicBaseUrl;
+    return `${baseUrl}/${key}`;
+}
+/**
+ * Extract the storage key from a public URL
+ */
+export function extractKeyFromUrl(publicBaseUrl, url) {
+    const baseUrl = publicBaseUrl.endsWith('/') ? publicBaseUrl.slice(0, -1) : publicBaseUrl;
+    if (!url.startsWith(baseUrl)) {
+        return null;
+    }
+    return url.slice(baseUrl.length + 1);
+}
+// =============================================================================
+// Content Type Mapping
+// =============================================================================
+/**
+ * Map of file extensions to MIME types
+ */
+const EXTENSION_TO_MIME = {
+    jpg: 'image/jpeg',
+    jpeg: 'image/jpeg',
+    png: 'image/png',
+    gif: 'image/gif',
+    webp: 'image/webp',
+    svg: 'image/svg+xml',
+    ico: 'image/x-icon',
+    bmp: 'image/bmp',
+    tiff: 'image/tiff',
+    tif: 'image/tiff',
+};
+/**
+ * Get MIME type from filename extension
+ */
+export function getMimeType(filename) {
+    const ext = filename.split('.').pop()?.toLowerCase() || '';
+    return EXTENSION_TO_MIME[ext] || 'application/octet-stream';
+}
+/**
+ * Check if a MIME type is an allowed image type
+ */
+export function isAllowedImageType(mimeType, config = defaultUploadConfig) {
+    return config.allowedTypes.includes(mimeType);
+}
+//# sourceMappingURL=config.js.map

package/dist/media/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/media/config.ts"],"names":[],"mappings":"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"}

package/dist/media/hooks/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @rovela-ai/sdk/media/hooks
+ *
+ * React hooks for media uploads.
+ */
+export { useUpload } from './useUpload';
+export type { UseUploadOptions, UseUploadReturn } from '../types';
+//# sourceMappingURL=index.d.ts.map

package/dist/media/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/media/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA"}

package/dist/media/hooks/index.js

@@ -0,0 +1,7 @@
+/**
+ * @rovela-ai/sdk/media/hooks
+ *
+ * React hooks for media uploads.
+ */
+export { useUpload } from './useUpload';
+//# sourceMappingURL=index.js.map

package/dist/media/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/media/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}

package/dist/media/hooks/useUpload.d.ts

@@ -0,0 +1,32 @@
+import type { UseUploadOptions, UseUploadReturn } from '../types';
+/**
+ * React hook for uploading files to R2 storage.
+ *
+ * @param options - Upload configuration options
+ * @returns Upload functions and state
+ *
+ * @example
+ * ```tsx
+ * function ImageUploader() {
+ *   const { upload, isUploading, progress, error } = useUpload({
+ *     folder: 'products',
+ *     entityId: 'prod_123',
+ *     onSuccess: (result) => console.log('Uploaded:', result.url),
+ *   });
+ *
+ *   const handleFile = async (file: File) => {
+ *     const result = await upload(file);
+ *     if (result.success) {
+ *       // Use result.url
+ *     }
+ *   };
+ *
+ *   return (
+ *     <input type="file" onChange={(e) => handleFile(e.target.files[0])} />
+ *   );
+ * }
+ * ```
+ */
+export declare function useUpload(options: UseUploadOptions): UseUploadReturn;
+export default useUpload;
+//# sourceMappingURL=useUpload.d.ts.map

package/dist/media/hooks/useUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpload.d.ts","sourceRoot":"","sources":["../../../src/media/hooks/useUpload.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAMhB,MAAM,UAAU,CAAA;AAOjB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAqMpE;AAmED,eAAe,SAAS,CAAA"}

package/dist/media/hooks/useUpload.js

@@ -0,0 +1,258 @@
+'use client';
+/**
+ * @rovela-ai/sdk/media/hooks/useUpload
+ *
+ * React hook for uploading files to R2 storage via presigned URLs.
+ */
+import { useState, useCallback, useRef } from 'react';
+import { validateFile, DEFAULT_UPLOAD_CONFIG } from '../types';
+// =============================================================================
+// Hook Implementation
+// =============================================================================
+/**
+ * React hook for uploading files to R2 storage.
+ *
+ * @param options - Upload configuration options
+ * @returns Upload functions and state
+ *
+ * @example
+ * ```tsx
+ * function ImageUploader() {
+ *   const { upload, isUploading, progress, error } = useUpload({
+ *     folder: 'products',
+ *     entityId: 'prod_123',
+ *     onSuccess: (result) => console.log('Uploaded:', result.url),
+ *   });
+ *
+ *   const handleFile = async (file: File) => {
+ *     const result = await upload(file);
+ *     if (result.success) {
+ *       // Use result.url
+ *     }
+ *   };
+ *
+ *   return (
+ *     <input type="file" onChange={(e) => handleFile(e.target.files[0])} />
+ *   );
+ * }
+ * ```
+ */
+export function useUpload(options) {
+    const { folder, entityId, config, onSuccess, onError, onProgress } = options;
+    // Merge config with defaults
+    const uploadConfig = {
+        ...DEFAULT_UPLOAD_CONFIG,
+        ...config,
+    };
+    // State
+    const [status, setStatus] = useState('idle');
+    const [progress, setProgress] = useState(null);
+    const [error, setError] = useState(null);
+    // Abort controller ref for cancellation
+    const abortControllerRef = useRef(null);
+    /**
+     * Upload a single file
+     */
+    const upload = useCallback(async (file) => {
+        // Validate file
+        const validation = validateFile(file, uploadConfig);
+        if (!validation.valid) {
+            const errorMsg = validation.error || 'File validation failed';
+            setError(errorMsg);
+            setStatus('error');
+            onError?.(errorMsg);
+            return {
+                success: false,
+                filename: file.name,
+                size: file.size,
+                contentType: file.type,
+                error: errorMsg,
+            };
+        }
+        // Reset state
+        setError(null);
+        setStatus('preparing');
+        setProgress(null);
+        // Create abort controller
+        abortControllerRef.current = new AbortController();
+        const signal = abortControllerRef.current.signal;
+        try {
+            // Step 1: Get presigned URL from API
+            const presignResponse = await fetch('/api/media/presign', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    filename: file.name,
+                    contentType: file.type,
+                    folder,
+                    entityId,
+                }),
+                signal,
+            });
+            if (!presignResponse.ok) {
+                const errorData = await presignResponse.json().catch(() => ({}));
+                throw new Error(errorData.error || 'Failed to get upload URL');
+            }
+            const presignData = await presignResponse.json();
+            if (!presignData.success || !presignData.data) {
+                throw new Error(presignData.error || 'Failed to get upload URL');
+            }
+            // Step 2: Upload file directly to R2
+            setStatus('uploading');
+            // Use XMLHttpRequest for progress tracking
+            const uploadResult = await uploadWithProgress(presignData.data.uploadUrl, file, (prog) => {
+                setProgress(prog);
+                onProgress?.(prog);
+            }, signal);
+            if (!uploadResult.success) {
+                throw new Error(uploadResult.error || 'Upload failed');
+            }
+            // Success
+            setStatus('success');
+            setProgress({ loaded: file.size, total: file.size, percentage: 100 });
+            const result = {
+                success: true,
+                url: presignData.data.publicUrl,
+                filename: file.name,
+                size: file.size,
+                contentType: file.type,
+            };
+            onSuccess?.(result);
+            return result;
+        }
+        catch (err) {
+            // Handle abort
+            if (err instanceof Error && err.name === 'AbortError') {
+                setStatus('idle');
+                setError(null);
+                return {
+                    success: false,
+                    filename: file.name,
+                    size: file.size,
+                    contentType: file.type,
+                    error: 'Upload cancelled',
+                };
+            }
+            // Handle error
+            const errorMsg = err instanceof Error ? err.message : 'Upload failed';
+            setError(errorMsg);
+            setStatus('error');
+            onError?.(errorMsg);
+            return {
+                success: false,
+                filename: file.name,
+                size: file.size,
+                contentType: file.type,
+                error: errorMsg,
+            };
+        }
+        finally {
+            abortControllerRef.current = null;
+        }
+    }, [folder, entityId, uploadConfig, onSuccess, onError, onProgress]);
+    /**
+     * Upload multiple files
+     */
+    const uploadMultiple = useCallback(async (files) => {
+        // Validate max files
+        if (files.length > uploadConfig.maxFiles) {
+            const errorMsg = `Maximum ${uploadConfig.maxFiles} files allowed`;
+            setError(errorMsg);
+            onError?.(errorMsg);
+            return files.map((f) => ({
+                success: false,
+                filename: f.name,
+                size: f.size,
+                contentType: f.type,
+                error: errorMsg,
+            }));
+        }
+        // Upload sequentially to avoid overwhelming the server
+        const results = [];
+        for (const file of files) {
+            const result = await upload(file);
+            results.push(result);
+            // Stop if there's an error (optional - could continue)
+            if (!result.success) {
+                break;
+            }
+        }
+        return results;
+    }, [upload, uploadConfig.maxFiles, onError]);
+    /**
+     * Reset state to idle
+     */
+    const reset = useCallback(() => {
+        // Cancel any in-progress upload
+        if (abortControllerRef.current) {
+            abortControllerRef.current.abort();
+            abortControllerRef.current = null;
+        }
+        setStatus('idle');
+        setProgress(null);
+        setError(null);
+    }, []);
+    return {
+        upload,
+        uploadMultiple,
+        status,
+        progress,
+        isUploading: status === 'preparing' || status === 'uploading',
+        error,
+        reset,
+    };
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Upload file with progress tracking using XMLHttpRequest
+ */
+function uploadWithProgress(url, file, onProgress, signal) {
+    return new Promise((resolve) => {
+        const xhr = new XMLHttpRequest();
+        // Handle abort
+        if (signal) {
+            signal.addEventListener('abort', () => {
+                xhr.abort();
+                resolve({ success: false, error: 'Upload cancelled' });
+            });
+        }
+        // Track progress
+        xhr.upload.addEventListener('progress', (event) => {
+            if (event.lengthComputable) {
+                onProgress({
+                    loaded: event.loaded,
+                    total: event.total,
+                    percentage: Math.round((event.loaded / event.total) * 100),
+                });
+            }
+        });
+        // Handle completion
+        xhr.addEventListener('load', () => {
+            if (xhr.status >= 200 && xhr.status < 300) {
+                resolve({ success: true });
+            }
+            else {
+                resolve({ success: false, error: `Upload failed with status ${xhr.status}` });
+            }
+        });
+        // Handle error
+        xhr.addEventListener('error', () => {
+            resolve({ success: false, error: 'Network error during upload' });
+        });
+        // Handle abort
+        xhr.addEventListener('abort', () => {
+            resolve({ success: false, error: 'Upload cancelled' });
+        });
+        // Send request
+        xhr.open('PUT', url);
+        xhr.setRequestHeader('Content-Type', file.type);
+        xhr.send(file);
+    });
+}
+// =============================================================================
+// Exports
+// =============================================================================
+export default useUpload;
+//# sourceMappingURL=useUpload.js.map

package/dist/media/hooks/useUpload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUpload.js","sourceRoot":"","sources":["../../../src/media/hooks/useUpload.ts"],"names":[],"mappings":"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"}

package/dist/media/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @rovela-ai/sdk/media
+ *
+ * Media upload module for R2 storage.
+ *
+ * This module provides:
+ * - Server-side presigned URL generation
+ * - Client-side upload hooks and components
+ * - API route handlers for Next.js
+ *
+ * ## Quick Start
+ *
+ * 1. Add environment variables:
+ * ```env
+ * R2_ACCOUNT_ID=xxx
+ * R2_ACCESS_KEY_ID=xxx
+ * R2_SECRET_ACCESS_KEY=xxx
+ * R2_BUCKET_NAME=xxx
+ * R2_PUBLIC_URL=https://pub-xxx.r2.dev
+ * STORE_ID=xxx
+ * ```
+ *
+ * 2. Create API routes:
+ * ```typescript
+ * // app/api/media/presign/route.ts
+ * export { POST } from '@rovela-ai/sdk/media/api'
+ *
+ * // app/api/media/route.ts
+ * export { DELETE } from '@rovela-ai/sdk/media/api'
+ * ```
+ *
+ * 3. Use components:
+ * ```tsx
+ * import { ImageGalleryUpload } from '@rovela-ai/sdk/media'
+ *
+ * <ImageGalleryUpload
+ *   value={images}
+ *   onChange={setImages}
+ *   folder="products"
+ *   entityId={productId}
+ * />
+ * ```
+ *
+ * ## Module Structure
+ *
+ * - `@rovela-ai/sdk/media` - Types, config, components, hooks
+ * - `@rovela-ai/sdk/media/server` - Server-side utilities (presign, delete)
+ * - `@rovela-ai/sdk/media/api` - Next.js API route handlers
+ *
+ * @module media
+ */
+export type { MediaStorageConfig, UploadConfig, MediaFolder, PresignedUrlRequest, PresignedUrlResponse, PresignApiRequest, PresignApiResponse, DeleteApiRequest, DeleteApiResponse, MediaApiError, UploadProgress, UploadStatus, UploadResult, UploadState, UseUploadOptions, UseUploadReturn, DropZoneProps, ImageUploadProps, ImageGalleryUploadProps, FileValidation, } from './types';
+export { DEFAULT_UPLOAD_CONFIG, validateFile, generateUniqueFilename, getFileExtension } from './types';
+export { getMediaConfig, isMediaConfigured, requireMediaConfig, defaultUploadConfig, getUploadConfig, buildStorageKey, buildPublicUrl, extractKeyFromUrl, getMimeType, isAllowedImageType, } from './config';
+export { useUpload } from './hooks';
+export { DropZone, ImageUpload, ImageGalleryUpload } from './components';
+//# sourceMappingURL=index.d.ts.map

package/dist/media/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH,YAAY,EAEV,kBAAkB,EAClB,YAAY,EACZ,WAAW,EAEX,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAEb,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EAEX,gBAAgB,EAChB,eAAe,EAEf,aAAa,EACb,gBAAgB,EAChB,uBAAuB,EAEvB,cAAc,GACf,MAAM,SAAS,CAAA;AAMhB,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAMvG,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,kBAAkB,GACnB,MAAM,UAAU,CAAA;AAMjB,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAMnC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}

package/dist/media/index.js

@@ -0,0 +1,68 @@
+/**
+ * @rovela-ai/sdk/media
+ *
+ * Media upload module for R2 storage.
+ *
+ * This module provides:
+ * - Server-side presigned URL generation
+ * - Client-side upload hooks and components
+ * - API route handlers for Next.js
+ *
+ * ## Quick Start
+ *
+ * 1. Add environment variables:
+ * ```env
+ * R2_ACCOUNT_ID=xxx
+ * R2_ACCESS_KEY_ID=xxx
+ * R2_SECRET_ACCESS_KEY=xxx
+ * R2_BUCKET_NAME=xxx
+ * R2_PUBLIC_URL=https://pub-xxx.r2.dev
+ * STORE_ID=xxx
+ * ```
+ *
+ * 2. Create API routes:
+ * ```typescript
+ * // app/api/media/presign/route.ts
+ * export { POST } from '@rovela-ai/sdk/media/api'
+ *
+ * // app/api/media/route.ts
+ * export { DELETE } from '@rovela-ai/sdk/media/api'
+ * ```
+ *
+ * 3. Use components:
+ * ```tsx
+ * import { ImageGalleryUpload } from '@rovela-ai/sdk/media'
+ *
+ * <ImageGalleryUpload
+ *   value={images}
+ *   onChange={setImages}
+ *   folder="products"
+ *   entityId={productId}
+ * />
+ * ```
+ *
+ * ## Module Structure
+ *
+ * - `@rovela-ai/sdk/media` - Types, config, components, hooks
+ * - `@rovela-ai/sdk/media/server` - Server-side utilities (presign, delete)
+ * - `@rovela-ai/sdk/media/api` - Next.js API route handlers
+ *
+ * @module media
+ */
+// =============================================================================
+// Constants & Utilities
+// =============================================================================
+export { DEFAULT_UPLOAD_CONFIG, validateFile, generateUniqueFilename, getFileExtension } from './types';
+// =============================================================================
+// Configuration
+// =============================================================================
+export { getMediaConfig, isMediaConfigured, requireMediaConfig, defaultUploadConfig, getUploadConfig, buildStorageKey, buildPublicUrl, extractKeyFromUrl, getMimeType, isAllowedImageType, } from './config';
+// =============================================================================
+// Hooks
+// =============================================================================
+export { useUpload } from './hooks';
+// =============================================================================
+// Components
+// =============================================================================
+export { DropZone, ImageUpload, ImageGalleryUpload } from './components';
+//# sourceMappingURL=index.js.map

package/dist/media/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/media/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAmCH,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEvG,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,kBAAkB,GACnB,MAAM,UAAU,CAAA;AAEjB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEnC,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}

package/dist/media/server/delete.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @rovela-ai/sdk/media/server/delete
+ *
+ * File deletion from R2 storage.
+ * Server-side only - do not import in client components.
+ */
+import type { MediaStorageConfig } from '../types';
+/**
+ * Delete a file from R2 storage.
+ *
+ * @param url - Public URL of the file to delete
+ * @param config - Optional storage configuration override
+ * @returns True if deletion was successful
+ * @throws Error if URL is invalid or doesn't belong to this store
+ *
+ * @example
+ * ```typescript
+ * await deleteFile('https://pub-xxx.r2.dev/stores/abc123/products/img.jpg');
+ * ```
+ */
+export declare function deleteFile(url: string, config?: MediaStorageConfig): Promise<boolean>;
+/**
+ * Delete a file by its storage key.
+ * Use this when you have the key directly instead of the URL.
+ *
+ * @param key - Storage key of the file
+ * @param config - Optional storage configuration override
+ * @returns True if deletion was successful
+ */
+export declare function deleteFileByKey(key: string, config?: MediaStorageConfig): Promise<boolean>;
+/**
+ * Delete multiple files from R2 storage.
+ *
+ * @param urls - Array of public URLs to delete
+ * @param config - Optional storage configuration override
+ * @returns Object with results for each URL
+ *
+ * @example
+ * ```typescript
+ * const results = await deleteFiles([
+ *   'https://pub-xxx.r2.dev/stores/abc123/products/img1.jpg',
+ *   'https://pub-xxx.r2.dev/stores/abc123/products/img2.jpg',
+ * ]);
+ * // { succeeded: ['url1', 'url2'], failed: [] }
+ * ```
+ */
+export declare function deleteFiles(urls: string[], config?: MediaStorageConfig): Promise<{
+    succeeded: string[];
+    failed: string[];
+}>;
+/**
+ * Safely delete a file - returns false instead of throwing if file doesn't exist.
+ *
+ * @param url - Public URL of the file to delete
+ * @param config - Optional storage configuration override
+ * @returns True if deleted, false if not found or invalid
+ */
+export declare function safeDeleteFile(url: string, config?: MediaStorageConfig): Promise<boolean>;
+//# sourceMappingURL=delete.d.ts.map