@od-oneapp/storage 2026.2.1701 → 2026.2.2301-canary

package/health-check-Dij2-CYd.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-Dij2-CYd.mjs","names":["CloudflareImagesProvider","CloudflareImagesProviderInternal","CloudflareR2Provider","CloudflareR2ProviderInternal","CloudflareR2Provider","CloudflareImagesProvider"],"sources":["../providers/cloudflare-images.ts","../providers/cloudflare-r2.ts","../src/constants.ts","../src/multi-storage.ts","../src/multipart.ts","../src/capabilities.ts","../src/health-check.ts"],"sourcesContent":["/**\n * @fileoverview Cloudflare Images storage provider\n *\n * Static import from the monorepo integration package.\n * The integration code is bundled into the published package by tsdown.\n */\n\nimport { CloudflareImagesProvider as CloudflareImagesProviderInternal } from '@od-oneapp/integration-cloudflare/storage-provider/images';\n\nimport type { StorageProvider } from '../types';\n\nexport const CloudflareImagesProvider: new (...args: unknown[]) => StorageProvider =\n  CloudflareImagesProviderInternal as unknown as new (...args: unknown[]) => StorageProvider;\n","/**\n * @fileoverview Cloudflare R2 storage provider\n *\n * Static import from the monorepo integration package.\n * The integration code is bundled into the published package by tsdown.\n */\n\nimport { CloudflareR2Provider as CloudflareR2ProviderInternal } from '@od-oneapp/integration-cloudflare/storage-provider/r2';\n\nimport type { StorageProvider } from '../types';\n\nexport const CloudflareR2Provider: new (...args: unknown[]) => StorageProvider =\n  CloudflareR2ProviderInternal as unknown as new (...args: unknown[]) => StorageProvider;\n","/**\n * @fileoverview Storage Package Constants\n *\n * Centralized constants for storage operations to avoid magic numbers\n * and improve maintainability.\n *\n * Includes:\n * - URL expiration times\n * - File size limits\n * - Multipart upload thresholds\n * - Retry configuration\n * - Rate limiting settings\n *\n * @module @repo/storage/constants\n */\n\nexport const STORAGE_CONSTANTS = {\n  // URL Expiration Times (seconds)\n  DEFAULT_URL_EXPIRY_SECONDS: 3600, // 1 hour\n  PRODUCT_URL_EXPIRY_SECONDS: 3600, // 1 hour for product photos\n  UPLOAD_URL_EXPIRY_SECONDS: 1800, // 30 minutes for uploads\n  ADMIN_URL_EXPIRY_SECONDS: 7200, // 2 hours for admin operations\n\n  // File Size Limits (bytes)\n  MULTIPART_THRESHOLD_BYTES: 100 * 1024 * 1024, // 100MB - use multipart above this\n  DEFAULT_PART_SIZE_BYTES: 5 * 1024 * 1024, // 5MB default part size\n  DEFAULT_MAX_PART_SIZE_BYTES: 25 * 1024 * 1024, // 25MB max part size\n  DEFAULT_QUEUE_SIZE: 4, // Concurrent upload parts\n\n  // Batch Operations\n  DEFAULT_BATCH_SIZE: 5, // Process 5 items concurrently\n  MAX_BATCH_SIZE: 50, // Maximum batch size\n\n  // Timeouts (milliseconds)\n  DEFAULT_REQUEST_TIMEOUT_MS: 30000, // 30 seconds\n  DEFAULT_UPLOAD_TIMEOUT_MS: 300000, // 5 minutes for uploads\n  DEFAULT_DOWNLOAD_TIMEOUT_MS: 60000, // 1 minute for downloads\n\n  // Retry Configuration\n  DEFAULT_MAX_RETRIES: 3,\n  RETRY_BASE_DELAY_MS: 1000, // 1 second base delay\n\n  // Key Validation\n  MAX_KEY_LENGTH: 1024,\n  MAX_FILENAME_LENGTH: 255,\n\n  // Rate Limiting (requests per window)\n  DEFAULT_RATE_LIMIT_REQUESTS: 100,\n  DEFAULT_RATE_LIMIT_WINDOW_MS: 60 * 1000, // 1 minute\n\n  // Health Check\n  HEALTH_CHECK_KEY: '__health_check__',\n} as const;\n\n/**\n * File size thresholds for multipart upload decisions\n */\nexport const MULTIPART_THRESHOLDS = {\n  SMALL_FILE: 100 * 1024 * 1024, // < 100MB - use simple upload\n  MEDIUM_FILE: 1024 * 1024 * 1024, // < 1GB - use 10MB parts\n  LARGE_FILE: Infinity, // >= 1GB - use 25MB parts\n} as const;\n\n/**\n * Part sizes based on file size\n */\nexport const PART_SIZES = {\n  SMALL: 5 * 1024 * 1024, // 5MB for files < 100MB\n  MEDIUM: 10 * 1024 * 1024, // 10MB for files < 1GB\n  LARGE: 25 * 1024 * 1024, // 25MB for files >= 1GB\n} as const;\n\n/**\n * Default storage capabilities for providers that don't implement getCapabilities()\n * Single source of truth for capability defaults\n */\nexport const DEFAULT_STORAGE_CAPABILITIES = {\n  multipart: false,\n  presignedUrls: false,\n  progressTracking: false,\n  abortSignal: false,\n  metadata: false,\n  customDomains: false,\n  edgeCompatible: false,\n  versioning: false,\n  encryption: false,\n  directoryListing: false,\n} as const;\n","/**\n * @fileoverview Multi-storage provider manager\n *\n * Manages multiple storage providers with routing and fallback capabilities.\n * Allows using different providers for different use cases or as backups.\n *\n * Features:\n * - Provider routing based on key patterns\n * - Fallback to default provider\n * - Unified API across multiple providers\n *\n * @module @repo/storage/multi-storage\n */\n\nimport { CloudflareImagesProvider } from '../providers/cloudflare-images';\nimport { CloudflareR2Provider } from '../providers/cloudflare-r2';\nimport { VercelBlobProvider } from '../providers/vercel-blob';\nimport {\n  type ListOptions,\n  type MultiStorageConfig,\n  type StorageConfig,\n  type StorageObject,\n  type StorageProvider,\n  type UploadOptions,\n} from '../types';\n\nexport class MultiStorageManager {\n  private providers: Map<string, StorageProvider> = new Map();\n  private defaultProvider: string;\n  private routing: MultiStorageConfig['routing'];\n\n  constructor(config: MultiStorageConfig) {\n    // Initialize all providers\n    for (const [name, providerConfig] of Object.entries(config.providers)) {\n      this.providers.set(name, this.createProvider(providerConfig));\n    }\n\n    // Set default provider\n    const firstProvider = Object.keys(config.providers)[0];\n    this.defaultProvider = config.defaultProvider ?? firstProvider ?? '';\n    if (!this.defaultProvider) {\n      throw new Error('No storage providers configured');\n    }\n\n    this.routing = config.routing;\n  }\n\n  private createProvider(config: StorageConfig): StorageProvider {\n    switch (config.provider) {\n      case 'multi':\n        throw new Error('Multi provider cannot be nested');\n\n      case 'cloudflare-r2':\n        if (!config.cloudflareR2) {\n          throw new Error('Cloudflare R2 configuration is required');\n        }\n        // Handle array of R2 configs\n        if (Array.isArray(config.cloudflareR2)) {\n          if (config.cloudflareR2.length === 0) {\n            throw new Error('No R2 configurations provided');\n          }\n          const firstR2Config = config.cloudflareR2[0];\n          if (!firstR2Config) {\n            throw new Error('First R2 configuration is undefined');\n          }\n          // Use first one for single provider (backward compatibility)\n          return new CloudflareR2Provider(firstR2Config);\n        }\n        return new CloudflareR2Provider(config.cloudflareR2);\n\n      case 'cloudflare-images':\n        if (!config.cloudflareImages) {\n          throw new Error('Cloudflare Images configuration is required');\n        }\n        return new CloudflareImagesProvider(config.cloudflareImages);\n\n      case 'vercel-blob':\n        if (!config.vercelBlob?.token) {\n          throw new Error('Vercel Blob token is required');\n        }\n        return new VercelBlobProvider(config.vercelBlob.token);\n\n      default:\n        throw new Error(`Unknown storage provider: ${config.provider}`);\n    }\n  }\n\n  private getProviderForKey(key: string): { provider: StorageProvider; providerName: string } {\n    // Check routing rules\n    if (this.routing) {\n      // Check file type routing\n      const extension = key.split('.').pop()?.toLowerCase();\n\n      // Image routing\n      if (this.routing.images && this.isImageFile(extension)) {\n        const provider = this.providers.get(this.routing.images);\n        if (provider) {\n          return { provider, providerName: this.routing.images };\n        }\n      }\n\n      // Document routing\n      if (this.routing.documents && this.isDocumentFile(extension)) {\n        const provider = this.providers.get(this.routing.documents);\n        if (provider) {\n          return { provider, providerName: this.routing.documents };\n        }\n      }\n\n      // Custom routing rules\n      for (const [pattern, providerName] of Object.entries(this.routing)) {\n        if (pattern !== 'images' && pattern !== 'documents' && providerName) {\n          // Simple pattern matching (could be enhanced with regex)\n          if (key.includes(pattern)) {\n            const provider = this.providers.get(providerName);\n            if (provider) {\n              return { provider, providerName };\n            }\n          }\n        }\n      }\n    }\n\n    // Fall back to default provider\n    const provider = this.providers.get(this.defaultProvider);\n    if (!provider) {\n      throw new Error(`Default provider '${this.defaultProvider}' not found`);\n    }\n\n    return { provider, providerName: this.defaultProvider };\n  }\n\n  private isImageFile(extension?: string): boolean {\n    const imageExtensions = ['jpg', 'jpeg', 'png', 'gif', 'webp', 'avif', 'svg', 'ico'];\n    return extension ? imageExtensions.includes(extension) : false;\n  }\n\n  private isDocumentFile(extension?: string): boolean {\n    const documentExtensions = ['pdf', 'doc', 'docx', 'xls', 'xlsx', 'ppt', 'pptx', 'txt', 'csv'];\n    return extension ? documentExtensions.includes(extension) : false;\n  }\n\n  // Get a specific provider by name\n  getProvider(name: string): StorageProvider | undefined {\n    return this.providers.get(name);\n  }\n\n  // Storage operations that route to appropriate provider\n  async delete(key: string): Promise<void> {\n    const { provider } = this.getProviderForKey(key);\n    return provider.delete(key);\n  }\n\n  async download(key: string): Promise<Blob> {\n    const { provider } = this.getProviderForKey(key);\n    return provider.download(key);\n  }\n\n  async exists(key: string): Promise<boolean> {\n    const { provider } = this.getProviderForKey(key);\n    return provider.exists(key);\n  }\n\n  async getMetadata(key: string): Promise<StorageObject> {\n    const { provider } = this.getProviderForKey(key);\n    return provider.getMetadata(key);\n  }\n\n  async getUrl(key: string, options?: { expiresIn?: number }): Promise<string> {\n    const { provider } = this.getProviderForKey(key);\n    return provider.getUrl(key, options);\n  }\n\n  async list(options?: ListOptions & { provider?: string }): Promise<StorageObject[]> {\n    // If specific provider requested, use it\n    if (options?.provider) {\n      const provider = this.providers.get(options.provider);\n      if (!provider) {\n        throw new Error(`Provider '${options.provider}' not found`);\n      }\n      return provider.list(options);\n    }\n\n    // Otherwise, list from all providers\n    const allResults: StorageObject[] = [];\n    for (const provider of this.providers.values()) {\n      const results = await provider.list(options);\n      allResults.push(...results);\n    }\n    return allResults;\n  }\n\n  async upload(\n    key: string,\n    data: ArrayBuffer | Blob | Buffer | File | ReadableStream,\n    options?: UploadOptions & { provider?: string },\n  ): Promise<StorageObject> {\n    let provider: StorageProvider;\n\n    // If specific provider requested, use it\n    if (options?.provider) {\n      const requestedProvider = this.providers.get(options.provider);\n      if (!requestedProvider) {\n        throw new Error(`Provider '${options.provider}' not found`);\n      }\n      provider = requestedProvider;\n    } else {\n      // Otherwise, use routing logic\n      const { provider: routedProvider } = this.getProviderForKey(key);\n      provider = routedProvider;\n    }\n\n    return provider.upload(key, data, options);\n  }\n\n  // Extended methods for Cloudflare Images\n  async getCloudflareImagesProvider(): Promise<InstanceType<typeof CloudflareImagesProvider> | undefined> {\n    for (const provider of this.providers.values()) {\n      if (provider instanceof CloudflareImagesProvider) {\n        return provider;\n      }\n    }\n    return undefined;\n  }\n\n  // Get all provider names\n  getProviderNames(): string[] {\n    return Array.from(this.providers.keys());\n  }\n}\n","/**\n * @fileoverview Unified Multipart Upload Manager\n *\n * Provides a consistent interface for multipart uploads across all storage providers.\n * Handles provider-specific differences and provides retry logic, progress tracking,\n * and error recovery.\n *\n * Features:\n * - Automatic part size calculation\n * - Concurrent part uploads\n * - Progress tracking\n * - Resume support\n * - Error recovery\n *\n * @module @repo/storage/multipart\n */\n\nimport { logWarn } from '@od-oneapp/shared/logs';\n\nimport {\n  type MultipartUploadResult as BaseMultipartUploadResult,\n  type MultipartUploadOptions,\n  type StorageProvider,\n  type UploadOptions,\n  type UploadProgress,\n} from '../types';\n\nimport { MULTIPART_THRESHOLDS, PART_SIZES, STORAGE_CONSTANTS } from './constants';\n\nexport interface MultipartUploadState {\n  uploadId: string;\n  key: string;\n  provider: string;\n  parts: Array<{\n    partNumber: number;\n    etag?: string;\n    size: number;\n    uploaded: boolean;\n  }>;\n  totalSize: number;\n  uploadedSize: number;\n  completed: boolean;\n  aborted: boolean;\n  error?: string;\n}\n\n/**\n * Extended multipart upload result with detailed part information\n * Extends the base MultipartUploadResult from types.ts\n */\nexport interface MultipartUploadResult extends BaseMultipartUploadResult {\n  parts: Array<{ partNumber: number; etag: string; size: number }>;\n  totalParts: number;\n}\n\nexport class MultipartUploadManager {\n  private provider: StorageProvider;\n  private state: MultipartUploadState | null = null;\n  private abortController: AbortController | null = null;\n\n  constructor(provider: StorageProvider) {\n    this.provider = provider;\n  }\n\n  /**\n   * Check if provider supports multipart uploads\n   */\n  supportsMultipart(): boolean {\n    const capabilities = this.provider.getCapabilities?.();\n    return capabilities?.multipart ?? false;\n  }\n\n  /**\n   * Create a new multipart upload\n   *\n   * @param key - Storage key\n   * @param totalSize - Total file size in bytes\n   * @param options - Upload options\n   * @returns Upload state\n   */\n  async createUpload(\n    key: string,\n    totalSize: number,\n    options: MultipartUploadOptions = {},\n  ): Promise<MultipartUploadState> {\n    if (!this.supportsMultipart()) {\n      throw new Error('Provider does not support multipart uploads');\n    }\n\n    if (this.state && !this.state.completed && !this.state.aborted) {\n      throw new Error('Upload already in progress. Abort current upload first.');\n    }\n\n    // Calculate optimal part size\n    const partSize = this.calculatePartSize(totalSize, options.partSize);\n    const totalParts = Math.ceil(totalSize / partSize);\n\n    // Create multipart upload\n    const uploadOptions: UploadOptions = {\n      onProgress: options.onProgress\n        ? (progress: UploadProgress) => {\n            options.onProgress?.({\n              key: progress.key,\n              loaded: progress.loaded,\n              total: progress.total,\n              part: progress.part ?? 0,\n              percentage: progress.percentage ?? 0,\n            });\n          }\n        : undefined,\n    };\n    const result = await this.provider.createMultipartUpload?.(key, uploadOptions);\n\n    if (!result) {\n      throw new Error('Failed to create multipart upload');\n    }\n\n    // Initialize state\n    this.state = {\n      uploadId: result.uploadId,\n      key: result.key,\n      provider: this.getProviderName(),\n      parts: Array.from({ length: totalParts }, (_, i) => ({\n        partNumber: i + 1,\n        size: i === totalParts - 1 ? totalSize - i * partSize : partSize,\n        uploaded: false,\n      })),\n      totalSize,\n      uploadedSize: 0,\n      completed: false,\n      aborted: false,\n    };\n\n    this.abortController = new AbortController();\n\n    return this.state;\n  }\n\n  /**\n   * Upload a part\n   *\n   * @param partNumber - Part number (1-based)\n   * @param data - Part data\n   * @param options - Upload options\n   * @returns Upload result\n   */\n  async uploadPart(\n    partNumber: number,\n    data: ArrayBuffer | Blob | Buffer,\n    options: UploadOptions = {},\n  ): Promise<{ etag: string; partNumber: number; size: number }> {\n    if (!this.state) {\n      throw new Error('No active upload. Call createUpload first.');\n    }\n\n    if (this.state.completed || this.state.aborted) {\n      throw new Error('Upload is completed or aborted');\n    }\n\n    const part = this.state.parts.find(p => p.partNumber === partNumber);\n    if (!part) {\n      throw new Error(`Part ${partNumber} not found`);\n    }\n\n    if (part.uploaded) {\n      throw new Error(`Part ${partNumber} already uploaded`);\n    }\n\n    // Check abort signal\n    if (this.abortController?.signal.aborted) {\n      throw new Error('Upload aborted');\n    }\n\n    try {\n      // Upload part with retry logic\n      const result = await this.uploadPartWithRetry(partNumber, data, options);\n\n      // Update state\n      part.etag = result.etag;\n      part.uploaded = true;\n      this.state.uploadedSize += part.size;\n\n      // Report progress\n      if (options.onProgress) {\n        options.onProgress({\n          key: this.state.key,\n          loaded: this.state.uploadedSize,\n          total: this.state.totalSize,\n          part: partNumber,\n          percentage: (this.state.uploadedSize / this.state.totalSize) * 100,\n        });\n      }\n\n      return result;\n    } catch (error) {\n      this.state.error = error instanceof Error ? error.message : String(error);\n      throw error;\n    }\n  }\n\n  /**\n   * Complete the multipart upload\n   *\n   * @returns Final upload result\n   */\n  async completeUpload(): Promise<MultipartUploadResult> {\n    if (!this.state) {\n      throw new Error('No active upload. Call createUpload first.');\n    }\n\n    if (this.state.completed) {\n      throw new Error('Upload already completed');\n    }\n\n    if (this.state.aborted) {\n      throw new Error('Upload was aborted');\n    }\n\n    // Check if all parts are uploaded\n    const unuploadedParts = this.state.parts.filter(p => !p.uploaded);\n    if (unuploadedParts.length > 0) {\n      throw new Error(`Upload incomplete: ${unuploadedParts.length} parts not uploaded`);\n    }\n\n    try {\n      // Complete multipart upload\n      const parts = this.state.parts\n        .filter(p => p.etag)\n        .map(p => ({ partNumber: p.partNumber, etag: p.etag ?? '' }))\n        .filter(p => p.etag !== '');\n\n      const result = await this.provider.completeMultipartUpload?.(this.state.uploadId, parts);\n\n      if (!result) {\n        throw new Error('Failed to complete multipart upload');\n      }\n\n      // Update state\n      this.state.completed = true;\n\n      return {\n        ...result,\n        key: result.key ?? this.state.key,\n        uploadId: this.state.uploadId,\n        parts: this.state.parts\n          .filter(p => p.etag)\n          .map(p => ({\n            partNumber: p.partNumber,\n            etag: p.etag ?? '',\n            size: p.size,\n          })),\n        totalParts: this.state.parts.length,\n      };\n    } catch (error) {\n      this.state.error = error instanceof Error ? error.message : String(error);\n      throw error;\n    }\n  }\n\n  /**\n   * Abort the multipart upload\n   */\n  async abortUpload(): Promise<void> {\n    if (!this.state) {\n      return;\n    }\n\n    if (this.state.completed) {\n      return;\n    }\n\n    // Signal abort\n    this.abortController?.abort();\n    this.state.aborted = true;\n\n    try {\n      // Abort on provider\n      await this.provider.abortMultipartUpload?.(this.state.uploadId);\n    } catch (error) {\n      // Log error but don't throw - we want to clean up state\n\n      // Use structured logging instead of console.warn\n      logWarn('Failed to abort upload on provider', {\n        error: error instanceof Error ? error.message : String(error),\n        uploadId: this.state.uploadId,\n        key: this.state.key,\n      });\n    }\n\n    // Reset state\n    this.state = null;\n    this.abortController = null;\n  }\n\n  /**\n   * Get current upload state\n   */\n  getState(): MultipartUploadState | null {\n    return this.state;\n  }\n\n  /**\n   * Resume upload from state (for recovery)\n   *\n   * @param state - Previous upload state\n   */\n  async resumeUpload(state: MultipartUploadState): Promise<void> {\n    if (this.state && !this.state.completed && !this.state.aborted) {\n      throw new Error('Upload already in progress');\n    }\n\n    this.state = { ...state };\n    this.abortController = new AbortController();\n  }\n\n  /**\n   * Upload file in chunks automatically\n   *\n   * @param key - Storage key\n   * @param data - File data\n   * @param options - Upload options\n   * @returns Upload result\n   */\n  async uploadFile(\n    key: string,\n    data: ArrayBuffer | Blob | Buffer,\n    options: MultipartUploadOptions = {},\n  ): Promise<MultipartUploadResult> {\n    const totalSize =\n      data instanceof ArrayBuffer\n        ? data.byteLength\n        : data instanceof Buffer\n          ? data.length\n          : (data as Blob).size;\n\n    // Create upload\n    await this.createUpload(key, totalSize, options);\n\n    const partSize = this.calculatePartSize(totalSize, options.partSize);\n    const totalParts = Math.ceil(totalSize / partSize);\n\n    // Upload parts\n    for (let i = 0; i < totalParts; i++) {\n      const start = i * partSize;\n      const end = Math.min(start + partSize, totalSize);\n      const partData = data.slice(start, end);\n\n      await this.uploadPart(i + 1, partData, {\n        onProgress: options.onProgress\n          ? (progress: UploadProgress) => {\n              options.onProgress?.({\n                key: progress.key,\n                loaded: progress.loaded,\n                total: progress.total,\n                part: progress.part ?? 0,\n                percentage: progress.percentage ?? 0,\n              });\n            }\n          : undefined,\n      });\n    }\n\n    // Complete upload\n    return await this.completeUpload();\n  }\n\n  private async uploadPartWithRetry(\n    partNumber: number,\n    data: ArrayBuffer | Blob | Buffer,\n    options: UploadOptions,\n    maxRetries: number = 3,\n  ): Promise<{ etag: string; partNumber: number; size: number }> {\n    let lastError: Error | null = null;\n\n    for (let attempt = 1; attempt <= maxRetries; attempt++) {\n      try {\n        if (!this.state?.uploadId) {\n          throw new Error('Upload ID not initialized');\n        }\n\n        const result = await this.provider.uploadPart?.(this.state.uploadId, partNumber, data, {\n          ...options,\n          abortSignal: this.abortController?.signal,\n        });\n\n        if (!result) {\n          throw new Error('Failed to upload part');\n        }\n\n        return {\n          etag: result.etag ?? '',\n          partNumber: result.partNumber ?? partNumber,\n          size:\n            data instanceof ArrayBuffer\n              ? data.byteLength\n              : data instanceof Buffer\n                ? data.length\n                : (data as Blob).size,\n        };\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error(String(error));\n\n        // Don't retry on abort\n        if (this.abortController?.signal.aborted) {\n          throw lastError;\n        }\n\n        // Don't retry on validation errors\n        if (lastError.message.includes('validation') || lastError.message.includes('invalid')) {\n          throw lastError;\n        }\n\n        // Wait before retry (exponential backoff)\n        if (attempt < maxRetries) {\n          await new Promise(resolve =>\n            setTimeout(resolve, Math.pow(2, attempt) * STORAGE_CONSTANTS.RETRY_BASE_DELAY_MS),\n          );\n        }\n      }\n    }\n\n    throw lastError ?? new Error('Upload failed after retries');\n  }\n\n  private calculatePartSize(totalSize: number, userPartSize?: number): number {\n    if (userPartSize) {\n      return Math.min(userPartSize, totalSize);\n    }\n\n    // Use constants for part size thresholds\n    if (totalSize < MULTIPART_THRESHOLDS.SMALL_FILE) {\n      return PART_SIZES.SMALL;\n    } else if (totalSize < MULTIPART_THRESHOLDS.MEDIUM_FILE) {\n      return PART_SIZES.MEDIUM;\n    } else {\n      // Scale part size to ensure we never exceed 10,000 parts (S3/R2 limit)\n      const maxParts = 9999; // Stay safely under 10,000 limit\n      const minPartSize = Math.ceil(totalSize / maxParts);\n      return Math.max(PART_SIZES.LARGE, minPartSize);\n    }\n  }\n\n  private getProviderName(): string {\n    return this.provider.constructor.name;\n  }\n}\n\n/**\n * Create a multipart upload manager for a provider\n *\n * @param provider - Storage provider\n * @returns Multipart upload manager\n */\nexport function createMultipartUploadManager(provider: StorageProvider): MultipartUploadManager {\n  if (!hasMultipartSupport(provider)) {\n    throw new Error('The provided storage provider does not support multipart uploads');\n  }\n  return new MultipartUploadManager(provider);\n}\n\n/**\n * Determines whether the given storage provider supports multipart uploads.\n *\n * @param provider - The storage provider to check\n * @returns `true` if the provider supports multipart uploads, `false` otherwise.\n */\nexport function hasMultipartSupport(provider: StorageProvider): boolean {\n  const capabilities = provider.getCapabilities?.();\n  return capabilities?.multipart ?? false;\n}\n\n/**\n * Selects an appropriate multipart upload part size for a file.\n *\n * If `userPartSize` is provided, it will be capped at the file size; otherwise the part size\n * is chosen from configured thresholds for small, medium, or large files.\n *\n * @param fileSize - File size in bytes\n * @param userPartSize - Optional user-specified part size in bytes; capped to `fileSize` when provided\n * @returns The selected part size in bytes\n */\nexport function getOptimalPartSize(fileSize: number, userPartSize?: number): number {\n  if (userPartSize) {\n    return Math.min(userPartSize, fileSize);\n  }\n\n  if (fileSize < MULTIPART_THRESHOLDS.SMALL_FILE) {\n    return PART_SIZES.SMALL;\n  } else if (fileSize < MULTIPART_THRESHOLDS.MEDIUM_FILE) {\n    return PART_SIZES.MEDIUM;\n  } else {\n    // Scale part size to ensure we never exceed 10,000 parts (S3/R2 limit)\n    const maxParts = 9999; // Stay safely under 10,000 limit\n    const minPartSize = Math.ceil(fileSize / maxParts);\n    return Math.max(PART_SIZES.LARGE, minPartSize);\n  }\n}\n","/**\n * @fileoverview Storage Provider Capabilities Utilities\n *\n * Provides utilities for checking storage provider capabilities and feature support.\n * Helps determine which features are available for each provider.\n *\n * @module @repo/storage/capabilities\n */\n\nimport { DEFAULT_STORAGE_CAPABILITIES, MULTIPART_THRESHOLDS } from './constants';\n\nimport type { StorageCapabilities, StorageProvider } from '../types';\n\n/**\n * Check if a storage provider has a specific capability\n * @param provider - The storage provider to check\n * @param capability - The capability to check for\n * @returns True if the provider supports the capability\n */\nexport function hasCapability(\n  provider: StorageProvider,\n  capability: keyof StorageCapabilities,\n): boolean {\n  const capabilities = provider.getCapabilities?.();\n  return capabilities?.[capability] ?? false;\n}\n\n/**\n * Check if a storage provider supports multiple capabilities\n * @param provider - The storage provider to check\n * @param capabilities - Array of capabilities to check for\n * @returns True if the provider supports all capabilities\n */\nexport function hasAllCapabilities(\n  provider: StorageProvider,\n  capabilities: Array<keyof StorageCapabilities>,\n): boolean {\n  return capabilities.every(capability => hasCapability(provider, capability));\n}\n\n/**\n * Check if a storage provider supports any of the specified capabilities\n * @param provider - The storage provider to check\n * @param capabilities - Array of capabilities to check for\n * @returns True if the provider supports at least one capability\n */\nexport function hasAnyCapability(\n  provider: StorageProvider,\n  capabilities: Array<keyof StorageCapabilities>,\n): boolean {\n  return capabilities.some(capability => hasCapability(provider, capability));\n}\n\n/**\n * Get all capabilities supported by a storage provider\n * @param provider - The storage provider to check\n * @returns Object with all capabilities and their support status\n */\nexport function getProviderCapabilities(provider: StorageProvider): StorageCapabilities {\n  return provider.getCapabilities?.() ?? { ...DEFAULT_STORAGE_CAPABILITIES };\n}\n\n/**\n * Get a human-readable description of provider capabilities\n * @param provider - The storage provider to describe\n * @returns String describing the provider's capabilities\n */\nexport function describeProviderCapabilities(provider: StorageProvider): string {\n  const capabilities = getProviderCapabilities(provider);\n  const supportedFeatures: string[] = [];\n  const unsupportedFeatures: string[] = [];\n\n  if (capabilities.multipart) supportedFeatures.push('multipart uploads');\n  else unsupportedFeatures.push('multipart uploads');\n\n  if (capabilities.presignedUrls) supportedFeatures.push('presigned URLs');\n  else unsupportedFeatures.push('presigned URLs');\n\n  if (capabilities.progressTracking) supportedFeatures.push('progress tracking');\n  else unsupportedFeatures.push('progress tracking');\n\n  if (capabilities.abortSignal) supportedFeatures.push('abort signals');\n  else unsupportedFeatures.push('abort signals');\n\n  if (capabilities.metadata) supportedFeatures.push('metadata');\n  else unsupportedFeatures.push('metadata');\n\n  if (capabilities.customDomains) supportedFeatures.push('custom domains');\n  else unsupportedFeatures.push('custom domains');\n\n  if (capabilities.edgeCompatible) supportedFeatures.push('edge runtime');\n  else unsupportedFeatures.push('edge runtime');\n\n  let description = `Provider supports: ${supportedFeatures.join(', ')}`;\n\n  if (unsupportedFeatures.length > 0) {\n    description += `\\nProvider does not support: ${unsupportedFeatures.join(', ')}`;\n  }\n\n  return description;\n}\n\n/**\n * Validate that a provider supports the required capabilities for an operation\n * @param provider - The storage provider to validate\n * @param requiredCapabilities - Capabilities required for the operation\n * @throws Error if provider doesn't support required capabilities\n */\nexport function validateProviderCapabilities(\n  provider: StorageProvider,\n  requiredCapabilities: Array<keyof StorageCapabilities>,\n): void {\n  const missingCapabilities = requiredCapabilities.filter(\n    capability => !hasCapability(provider, capability),\n  );\n\n  if (missingCapabilities.length > 0) {\n    const providerName = provider.constructor.name;\n    throw new Error(\n      `Provider ${providerName} does not support required capabilities: ${missingCapabilities.join(', ')}`,\n    );\n  }\n}\n\n/**\n * Get the best provider for a specific use case based on capabilities\n * @param providers - Array of storage providers to choose from\n * @param requiredCapabilities - Capabilities required for the use case\n * @returns The best provider or null if none meet the requirements\n */\nexport function getBestProvider(\n  providers: StorageProvider[],\n  requiredCapabilities: Array<keyof StorageCapabilities>,\n): StorageProvider | null {\n  const suitableProviders = providers.filter(provider =>\n    hasAllCapabilities(provider, requiredCapabilities),\n  );\n\n  if (suitableProviders.length === 0) {\n    return null;\n  }\n\n  // If multiple providers are suitable, prefer edge-compatible ones\n  const edgeCompatible = suitableProviders.filter(provider =>\n    hasCapability(provider, 'edgeCompatible'),\n  );\n\n  return edgeCompatible.length > 0 ? (edgeCompatible[0] ?? null) : (suitableProviders[0] ?? null);\n}\n\n/**\n * Builds a map from provider names to their reported storage capabilities.\n *\n * @param providers - Array of entries each containing a `name` (used as the map key) and a `provider` instance\n * @returns A mapping from each provider name to its `StorageCapabilities`\n */\nexport function getCapabilityMatrix(\n  providers: Array<{ name: string; provider: StorageProvider }>,\n): Record<string, StorageCapabilities> {\n  const matrix: Record<string, StorageCapabilities> = {};\n\n  for (const { name, provider } of providers) {\n    matrix[name] = getProviderCapabilities(provider);\n  }\n\n  return matrix;\n}\n\n/**\n * Evaluate a storage provider's suitability for a specific file and produce actionable recommendations and warnings.\n *\n * @param provider - The storage provider to evaluate\n * @param fileSize - File size in bytes\n * @param fileType - MIME type of the file\n * @returns An object with `suitable` (`true` if there are no warnings, `false` otherwise), `recommendations` (suggested actions to improve handling), and `warnings` (issues that reduce suitability)\n */\nexport function checkProviderSuitability(\n  provider: StorageProvider,\n  fileSize: number,\n  fileType: string,\n): {\n  suitable: boolean;\n  recommendations: string[];\n  warnings: string[];\n} {\n  const capabilities = getProviderCapabilities(provider);\n  const recommendations: string[] = [];\n  const warnings: string[] = [];\n\n  // Check file size suitability\n  if (fileSize > MULTIPART_THRESHOLDS.SMALL_FILE) {\n    // > 100MB\n    if (!capabilities.multipart) {\n      warnings.push('Large file detected but provider does not support multipart uploads');\n    } else {\n      recommendations.push('Use multipart upload for this large file');\n    }\n  }\n\n  // Check file type suitability\n  if (fileType.startsWith('image/')) {\n    if (capabilities.metadata) {\n      recommendations.push('Consider storing image metadata for better organization');\n    }\n  }\n\n  if (fileType.startsWith('video/')) {\n    if (!capabilities.multipart) {\n      warnings.push('Video files are typically large and benefit from multipart uploads');\n    }\n  }\n\n  // Check edge compatibility\n  if (fileType.startsWith('text/') && !capabilities.edgeCompatible) {\n    recommendations.push('Text files could be processed in edge runtime for better performance');\n  }\n\n  const suitable = warnings.length === 0;\n\n  return {\n    suitable,\n    recommendations,\n    warnings,\n  };\n}\n","/**\n * @fileoverview Health check utilities for storage providers\n *\n * Provides health check functionality to verify storage provider availability\n * and performance. Useful for monitoring and alerting.\n *\n * @module @repo/storage/health-check\n */\n\nimport type { StorageProvider } from '../types';\n\n/**\n * Health check result with status and metrics\n */\nexport interface HealthCheckResult {\n  status: 'healthy' | 'degraded' | 'unhealthy';\n  latencyMs: number;\n  error?: string;\n  details?: Record<string, unknown>;\n}\n\n/**\n * Check the health of a storage provider\n *\n * @param provider - The storage provider to check\n * @returns Health check result with status and latency\n */\nexport async function checkProviderHealth(provider: StorageProvider): Promise<HealthCheckResult> {\n  const startTime = Date.now();\n\n  try {\n    // Perform a lightweight operation to check provider health\n    // Using list with limit 1 as a health check probe\n    await provider.list({ limit: 1 });\n\n    const latencyMs = Date.now() - startTime;\n\n    // Define health thresholds\n    const HEALTHY_THRESHOLD_MS = 1000; // < 1s is healthy\n    const DEGRADED_THRESHOLD_MS = 3000; // 1-3s is degraded\n\n    let status: 'healthy' | 'degraded' | 'unhealthy';\n    if (latencyMs < HEALTHY_THRESHOLD_MS) {\n      status = 'healthy';\n    } else if (latencyMs < DEGRADED_THRESHOLD_MS) {\n      status = 'degraded';\n    } else {\n      status = 'unhealthy';\n    }\n\n    return {\n      status,\n      latencyMs,\n      details: {\n        provider: provider.constructor.name,\n        threshold_healthy_ms: HEALTHY_THRESHOLD_MS,\n        threshold_degraded_ms: DEGRADED_THRESHOLD_MS,\n      },\n    };\n  } catch (error) {\n    const latencyMs = Date.now() - startTime;\n    return {\n      status: 'unhealthy',\n      latencyMs,\n      error: error instanceof Error ? error.message : String(error),\n      details: {\n        provider: provider.constructor.name,\n      },\n    };\n  }\n}\n\n/**\n * Perform a comprehensive health check on storage system\n *\n * @param provider - The storage provider to check\n * @returns Detailed health check result\n */\nexport async function storageHealthCheck(provider: StorageProvider): Promise<HealthCheckResult> {\n  return checkProviderHealth(provider);\n}\n"],"mappings":"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"}

package/index.mjs

@@ -1,3 +1,3 @@
-import { n as getEnvWithDefaults, r as safeEnv, t as env } from "./env-DQI-n3Mw.mjs";
+import { n as getEnvWithDefaults, r as safeEnv, t as env } from "./env-d2CieWaM.mjs";
 
 export { env, getEnvWithDefaults, safeEnv };

package/package.json

@@ -1,65 +1,61 @@
 {
   "name": "@od-oneapp/storage",
-  "version": "2026.2.1701",
+  "version": "2026.2.2301-canary",
   "description": "File storage package",
   "type": "module",
   "sideEffects": false,
   "exports": {
     ".": {
+      "types": "./env.d.mts",
       "import": "./env.mjs",
-      "types": "./env.d.mts"
+      "default": "./env.mjs"
     },
     "./client": {
+      "types": "./client.d.mts",
       "import": "./client.mjs",
-      "types": "./client.d.mts"
+      "default": "./client.mjs"
     },
     "./server": {
+      "types": "./server.d.mts",
       "import": "./server.mjs",
-      "types": "./server.d.mts"
+      "default": "./server.mjs"
     },
     "./client/next": {
+      "types": "./client-next.d.mts",
       "import": "./client-next.mjs",
-      "types": "./client-next.d.mts"
+      "default": "./client-next.mjs"
     },
     "./server/next": {
+      "types": "./server-next.d.mts",
       "import": "./server-next.mjs",
-      "types": "./server-next.d.mts"
+      "default": "./server-next.mjs"
     },
     "./server/edge": {
+      "types": "./server-edge.d.mts",
       "import": "./server-edge.mjs",
-      "types": "./server-edge.d.mts"
+      "default": "./server-edge.mjs"
     },
     "./env": {
+      "types": "./env.d.mts",
       "import": "./env.mjs",
-      "types": "./env.d.mts"
+      "default": "./env.mjs"
     },
     "./keys": {
+      "types": "./keys.d.mts",
       "import": "./keys.mjs",
-      "types": "./keys.d.mts"
+      "default": "./keys.mjs"
     },
     "./types": {
+      "types": "./types.d.mts",
       "import": "./types.mjs",
-      "types": "./types.d.mts"
+      "default": "./types.mjs"
     },
     "./validation": {
+      "types": "./validation.d.mts",
       "import": "./validation.mjs",
-      "types": "./validation.d.mts"
+      "default": "./validation.mjs"
     }
   },
-  "dependencies": {
-    "@aws-sdk/client-s3": "^3.987.0",
-    "@aws-sdk/lib-storage": "^3.987.0",
-    "@aws-sdk/s3-request-presigner": "^3.987.0",
-    "@smithy/node-http-handler": "^4.4.10",
-    "jose": "^6.1.3",
-    "zod": "4.3.6",
-    "@t3-oss/env-core": "^0.13.10",
-    "@vercel/blob": "^2.2.0",
-    "nanoid": "^5.1.6",
-    "@od-oneapp/shared": "2026.2.1701"
-  },
-  "peerDependencies": {},
-  "peerDependenciesMeta": {},
   "repository": {
     "type": "git",
     "url": "https://github.com/OneDigital-Product/monorepo.git",
@@ -121,5 +117,16 @@
       }
     },
     "registry": "https://registry.npmjs.org/"
+  },
+  "main": "./env.mjs",
+  "types": "./env.d.mts",
+  "dependencies": {
+    "@od-oneapp/integration-cloudflare": "canary",
+    "@od-oneapp/shared": "canary",
+    "@t3-oss/env-core": "^0.13.10",
+    "@vercel/blob": "^2.2.0",
+    "nanoid": "^5.1.6",
+    "tsdown": "^0.20.3",
+    "zod": "4.3.6"
   }
 }

package/server-edge.mjs

@@ -1,6 +1,6 @@
-import { r as safeEnv } from "./env-DQI-n3Mw.mjs";
+import { r as safeEnv } from "./env-d2CieWaM.mjs";
 import { generateMultipleKeys, generateStorageKey, isKeyPattern, normalizeStorageKey, parseStorageKey, sanitizeStorageKey, validateStorageKey } from "./keys.mjs";
-import { t as VercelBlobProvider } from "./vercel-blob-DA8HaYuw.mjs";
+import { t as VercelBlobProvider } from "./vercel-blob-DrfolJEu.mjs";
 
 //#region src/server-edge.ts
 /**

package/server-next.mjs

@@ -1,11 +1,10 @@
-import { a as getBestProvider, b as CloudflareImagesProvider, c as hasAllCapabilities, d as validateProviderCapabilities, f as MultipartUploadManager, g as MultiStorageManager, h as hasMultipartSupport, i as describeProviderCapabilities, l as hasAnyCapability, m as getOptimalPartSize, n as storageHealthCheck, o as getCapabilityMatrix, p as createMultipartUploadManager, r as checkProviderSuitability, s as getProviderCapabilities, t as checkProviderHealth, u as hasCapability, v as STORAGE_CONSTANTS, y as CloudflareR2Provider } from "./health-check-Cow8MNnJ.mjs";
-import { r as safeEnv, t as env } from "./env-DQI-n3Mw.mjs";
+import { i as logError, r as safeEnv, t as env } from "./env-d2CieWaM.mjs";
 import { sanitizeStorageKey, validateStorageKey } from "./keys.mjs";
 import { ConfigError, DownloadError, NetworkError, ProviderError, StorageError, StorageErrorCode, UploadError, ValidationError, createStorageError, formatFileSize, getErrorCode, getQuotaInfo, isQuotaExceeded, isRetryableError, parseFileSize, validateFileSize, validateMimeType, validateUploadOptions, validateUrlForSSRF } from "./validation.mjs";
-import { t as VercelBlobProvider } from "./vercel-blob-DA8HaYuw.mjs";
+import { a as getBestProvider, b as CloudflareImagesProvider, c as hasAllCapabilities, d as validateProviderCapabilities, f as MultipartUploadManager, g as MultiStorageManager, h as hasMultipartSupport, i as describeProviderCapabilities, l as hasAnyCapability, m as getOptimalPartSize, n as storageHealthCheck, o as getCapabilityMatrix, p as createMultipartUploadManager, r as checkProviderSuitability, s as getProviderCapabilities, t as checkProviderHealth, u as hasCapability, v as STORAGE_CONSTANTS, y as CloudflareR2Provider } from "./health-check-Dij2-CYd.mjs";
+import { t as VercelBlobProvider } from "./vercel-blob-DrfolJEu.mjs";
 import { createStorageProvider, getMultiStorage, getProviderCapabilitiesFromConfig, getStorage, initializeMultiStorage, initializeStorage, multiStorage, resetStorageState, storage, validateStorageConfig } from "./server.mjs";
 import { handleUpload } from "@vercel/blob/client";
-import { logError, logWarn } from "@od-oneapp/shared/logs";
 
 //#region src/auth-helpers.ts
 /**