@od-oneapp/storage 2026.1.1301

package/dist/health-check-D7LnnDec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-D7LnnDec.mjs","names":["require","loadProvider"],"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 * Lazy shim around the monorepo integration package.\n *\n * Why:\n * - `@integrations/*` packages are monorepo-private and may not be installed in extracted apps.\n * - This avoids hard module resolution failures during bundling/build; the integration is only\n *   required if the provider is instantiated.\n */\n\nimport { createRequire } from 'node:module';\n\nimport type { StorageProvider } from '../types';\n\nconst require = createRequire(import.meta.url);\n\nfunction loadProvider(): new (...args: unknown[]) => StorageProvider {\n  const mod = require('@integrations/cloudflare/storage-provider/images') as {\n    CloudflareImagesProvider: new (...args: unknown[]) => StorageProvider;\n  };\n  return mod.CloudflareImagesProvider;\n}\n\nexport const CloudflareImagesProvider: new (...args: unknown[]) => StorageProvider =\n  class CloudflareImagesProviderShim {\n    constructor(...args: unknown[]) {\n      const Provider = loadProvider();\n      // eslint-disable-next-line no-constructor-return\n      return new Provider(...args) as unknown as StorageProvider;\n    }\n  } as unknown as new (...args: unknown[]) => StorageProvider;\n","/**\n * @fileoverview Cloudflare R2 storage provider\n *\n * Lazy shim around the monorepo integration package.\n *\n * Why:\n * - `@integrations/*` packages are monorepo-private and may not be installed in extracted apps.\n * - This avoids hard module resolution failures during bundling/build; the integration is only\n *   required if the provider is instantiated.\n */\n\nimport { createRequire } from 'node:module';\n\nimport type { StorageProvider } from '../types';\n\nconst require = createRequire(import.meta.url);\n\nfunction loadProvider(): new (...args: unknown[]) => StorageProvider {\n  const mod = require('@integrations/cloudflare/storage-provider/r2') as {\n    CloudflareR2Provider: new (...args: unknown[]) => StorageProvider;\n  };\n  return mod.CloudflareR2Provider;\n}\n\nexport const CloudflareR2Provider: new (...args: unknown[]) => StorageProvider = class CloudflareR2ProviderShim {\n  constructor(...args: unknown[]) {\n    const Provider = loadProvider();\n    // eslint-disable-next-line no-constructor-return\n    return new Provider(...args) as unknown as StorageProvider;\n  }\n} 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 '@repo/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/dist/health-check-im_huJ59.d.mts

@@ -0,0 +1,116 @@
+import { ListOptions, MultiStorageConfig, MultipartUploadOptions, MultipartUploadResult as MultipartUploadResult$1, StorageCapabilities, StorageObject, StorageProvider, UploadOptions } from "./types.mjs";
+
+//#region providers/cloudflare-images.d.ts
+declare const CloudflareImagesProvider: new (...args: unknown[]) => StorageProvider;
+//#endregion
+//#region src/multi-storage.d.ts
+declare class MultiStorageManager {
+  private providers;
+  private defaultProvider;
+  private routing;
+  constructor(config: MultiStorageConfig);
+  private createProvider;
+  private getProviderForKey;
+  private isImageFile;
+  private isDocumentFile;
+  getProvider(name: string): StorageProvider | undefined;
+  delete(key: string): Promise<void>;
+  download(key: string): Promise<Blob>;
+  exists(key: string): Promise<boolean>;
+  getMetadata(key: string): Promise<StorageObject>;
+  getUrl(key: string, options?: {
+    expiresIn?: number;
+  }): Promise<string>;
+  list(options?: ListOptions & {
+    provider?: string;
+  }): Promise<StorageObject[]>;
+  upload(key: string, data: ArrayBuffer | Blob | Buffer | File | ReadableStream, options?: UploadOptions & {
+    provider?: string;
+  }): Promise<StorageObject>;
+  getCloudflareImagesProvider(): Promise<InstanceType<typeof CloudflareImagesProvider> | undefined>;
+  getProviderNames(): string[];
+}
+//#endregion
+//#region providers/cloudflare-r2.d.ts
+declare const CloudflareR2Provider: new (...args: unknown[]) => StorageProvider;
+//#endregion
+//#region src/multipart.d.ts
+interface MultipartUploadState {
+  uploadId: string;
+  key: string;
+  provider: string;
+  parts: Array<{
+    partNumber: number;
+    etag?: string;
+    size: number;
+    uploaded: boolean;
+  }>;
+  totalSize: number;
+  uploadedSize: number;
+  completed: boolean;
+  aborted: boolean;
+  error?: string;
+}
+interface MultipartUploadResult extends MultipartUploadResult$1 {
+  parts: Array<{
+    partNumber: number;
+    etag: string;
+    size: number;
+  }>;
+  totalParts: number;
+}
+declare class MultipartUploadManager {
+  private provider;
+  private state;
+  private abortController;
+  constructor(provider: StorageProvider);
+  supportsMultipart(): boolean;
+  createUpload(key: string, totalSize: number, options?: MultipartUploadOptions): Promise<MultipartUploadState>;
+  uploadPart(partNumber: number, data: ArrayBuffer | Blob | Buffer, options?: UploadOptions): Promise<{
+    etag: string;
+    partNumber: number;
+    size: number;
+  }>;
+  completeUpload(): Promise<MultipartUploadResult>;
+  abortUpload(): Promise<void>;
+  getState(): MultipartUploadState | null;
+  resumeUpload(state: MultipartUploadState): Promise<void>;
+  uploadFile(key: string, data: ArrayBuffer | Blob | Buffer, options?: MultipartUploadOptions): Promise<MultipartUploadResult>;
+  private uploadPartWithRetry;
+  private calculatePartSize;
+  private getProviderName;
+}
+declare function createMultipartUploadManager(provider: StorageProvider): MultipartUploadManager;
+declare function hasMultipartSupport(provider: StorageProvider): boolean;
+declare function getOptimalPartSize(fileSize: number, userPartSize?: number): number;
+//#endregion
+//#region src/capabilities.d.ts
+declare function hasCapability(provider: StorageProvider, capability: keyof StorageCapabilities): boolean;
+declare function hasAllCapabilities(provider: StorageProvider, capabilities: Array<keyof StorageCapabilities>): boolean;
+declare function hasAnyCapability(provider: StorageProvider, capabilities: Array<keyof StorageCapabilities>): boolean;
+declare function getProviderCapabilities(provider: StorageProvider): StorageCapabilities;
+declare function describeProviderCapabilities(provider: StorageProvider): string;
+declare function validateProviderCapabilities(provider: StorageProvider, requiredCapabilities: Array<keyof StorageCapabilities>): void;
+declare function getBestProvider(providers: StorageProvider[], requiredCapabilities: Array<keyof StorageCapabilities>): StorageProvider | null;
+declare function getCapabilityMatrix(providers: Array<{
+  name: string;
+  provider: StorageProvider;
+}>): Record<string, StorageCapabilities>;
+declare function checkProviderSuitability(provider: StorageProvider, fileSize: number, fileType: string): {
+  suitable: boolean;
+  recommendations: string[];
+  warnings: string[];
+};
+//#endregion
+//#region src/health-check.d.ts
+interface HealthCheckResult {
+  status: 'healthy' | 'degraded' | 'unhealthy';
+  latencyMs: number;
+  error?: string;
+  details?: Record<string, unknown>;
+}
+declare function checkProviderHealth(provider: StorageProvider): Promise<HealthCheckResult>;
+declare function storageHealthCheck(provider: StorageProvider): Promise<HealthCheckResult>;
+//#endregion
+export { getOptimalPartSize as _, describeProviderCapabilities as a, MultiStorageManager as b, getProviderCapabilities as c, hasCapability as d, validateProviderCapabilities as f, createMultipartUploadManager as g, MultipartUploadState as h, checkProviderSuitability as i, hasAllCapabilities as l, MultipartUploadResult as m, checkProviderHealth as n, getBestProvider as o, MultipartUploadManager as p, storageHealthCheck as r, getCapabilityMatrix as s, HealthCheckResult as t, hasAnyCapability as u, hasMultipartSupport as v, CloudflareImagesProvider as x, CloudflareR2Provider as y };
+//# sourceMappingURL=health-check-im_huJ59.d.mts.map

package/dist/health-check-im_huJ59.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-im_huJ59.d.mts","names":[],"sources":["../providers/cloudflare-images.ts","../src/multi-storage.ts","../providers/cloudflare-r2.ts","../src/multipart.ts","../src/capabilities.ts","../src/health-check.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,60 @@
+//#region env.d.ts
+declare const env: Readonly<{
+  VERCEL_BLOB_READ_WRITE_TOKEN?: string | undefined;
+  CLOUDFLARE_IMAGES_ACCOUNT_ID?: string | undefined;
+  CLOUDFLARE_IMAGES_API_TOKEN?: string | undefined;
+  CLOUDFLARE_IMAGES_DELIVERY_URL?: string | undefined;
+  CLOUDFLARE_IMAGES_SIGNING_KEY?: string | undefined;
+  R2_ACCESS_KEY_ID?: string | undefined;
+  R2_ACCOUNT_ID?: string | undefined;
+  R2_BUCKET?: string | undefined;
+  R2_SECRET_ACCESS_KEY?: string | undefined;
+  R2_CREDENTIALS?: {
+    bucket: string;
+    accountId: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    name?: string | undefined;
+  }[] | undefined;
+  STORAGE_CONFIG?: any;
+  STORAGE_PROVIDER?: "vercel-blob" | "cloudflare-r2" | "cloudflare-images" | "multi" | undefined;
+  STORAGE_LOG_LEVEL: "error" | "info" | "warn";
+  STORAGE_LOG_PERFORMANCE: boolean;
+  STORAGE_LOG_PROVIDER: "console" | "sentry" | "pino";
+  STORAGE_MAX_FILE_SIZE: number;
+  STORAGE_MAX_FILES_PER_UPLOAD: number;
+  STORAGE_RATE_LIMIT_REQUESTS: number;
+  STORAGE_RATE_LIMIT_WINDOW_MS: number;
+  STORAGE_ENFORCE_AUTH: boolean;
+  STORAGE_ENABLE_RATE_LIMIT: boolean;
+  STORAGE_ENFORCE_CSRF: boolean;
+}>;
+declare function safeEnv(): typeof env;
+declare function getEnvWithDefaults(): {
+  VERCEL_BLOB_READ_WRITE_TOKEN: string;
+  CLOUDFLARE_IMAGES_ACCOUNT_ID: string;
+  CLOUDFLARE_IMAGES_API_TOKEN: string;
+  CLOUDFLARE_IMAGES_DELIVERY_URL: string;
+  CLOUDFLARE_IMAGES_SIGNING_KEY: string;
+  R2_ACCESS_KEY_ID: string;
+  R2_ACCOUNT_ID: string;
+  R2_BUCKET: string;
+  R2_SECRET_ACCESS_KEY: string;
+  R2_CREDENTIALS: string;
+  STORAGE_CONFIG: string;
+  STORAGE_LOG_LEVEL: string;
+  STORAGE_LOG_PERFORMANCE: boolean;
+  STORAGE_LOG_PROVIDER: string;
+  STORAGE_PROVIDER: string;
+  STORAGE_MAX_FILE_SIZE: number;
+  STORAGE_MAX_FILES_PER_UPLOAD: number;
+  STORAGE_RATE_LIMIT_REQUESTS: number;
+  STORAGE_RATE_LIMIT_WINDOW_MS: number;
+  STORAGE_ENFORCE_AUTH: boolean;
+  STORAGE_ENABLE_RATE_LIMIT: boolean;
+  STORAGE_ENFORCE_CSRF: boolean;
+};
+type Env = typeof env;
+//#endregion
+export { Env, env, getEnvWithDefaults, safeEnv };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../env.ts"],"mappings":";cAmBa,GAAA,EAAG,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+GA,OAAA,CAAA,UAAkB,GAAA;AAAA,iBAWlB,kBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;KAwCJ,GAAA,UAAa,GAAA"}

package/dist/index.mjs

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

package/dist/keys.d.mts

@@ -0,0 +1,37 @@
+//#region keys.d.ts
+type KeyPattern = 'timestamped' | 'uuid' | 'random' | 'custom';
+interface KeyGenerationOptions {
+  pattern?: KeyPattern;
+  prefix?: string;
+  suffix?: string;
+  extension?: string;
+  includeTimestamp?: boolean;
+  customFormat?: (base: string) => string;
+}
+declare function generateStorageKey(options?: KeyGenerationOptions): string;
+declare function parseStorageKey(key: string): {
+  prefix?: string;
+  path: string;
+  filename: string;
+  name: string;
+  extension: string;
+  isTimestamped: boolean;
+  isUuid: boolean;
+};
+declare function validateStorageKey(key: string, options?: {
+  required?: boolean;
+  maxLength?: number;
+  allowedExtensions?: string[];
+  forbiddenPatterns?: RegExp[];
+  allowEmpty?: boolean;
+}): {
+  valid: boolean;
+  errors: string[];
+};
+declare function normalizeStorageKey(key: string): string;
+declare function sanitizeStorageKey(key: string): string;
+declare function generateMultipleKeys(count: number, options?: KeyGenerationOptions): string[];
+declare function isKeyPattern(key: string, pattern: KeyPattern): boolean;
+//#endregion
+export { KeyGenerationOptions, KeyPattern, generateMultipleKeys, generateStorageKey, isKeyPattern, normalizeStorageKey, parseStorageKey, sanitizeStorageKey, validateStorageKey };
+//# sourceMappingURL=keys.d.mts.map

package/dist/keys.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.mts","names":[],"sources":["../keys.ts"],"mappings":";KAwBY,UAAA;AAAA,UAKK,oBAAA;EACf,OAAA,GAAU,UAAA;EACV,MAAA;EACA,MAAA;EACA,SAAA;EACA,gBAAA;EACA,YAAA,IAAgB,IAAA;AAAA;AAAA,iBA2BF,kBAAA,CAAmB,OAAA,GAAS,oBAAA;AAAA,iBAqF5B,eAAA,CAAgB,GAAA;EAC9B,MAAA;EACA,IAAA;EACA,QAAA;EACA,IAAA;EACA,SAAA;EACA,aAAA;EACA,MAAA;AAAA;AAAA,iBAwDc,kBAAA,CACd,GAAA,UACA,OAAA;EACE,QAAA;EACA,SAAA;EACA,iBAAA;EACA,iBAAA,GAAoB,MAAA;EACpB,UAAA;AAAA;EAEC,KAAA;EAAgB,MAAA;AAAA;AAAA,iBA0FL,mBAAA,CAAoB,GAAA;AAAA,iBAwBpB,kBAAA,CAAmB,GAAA;AAAA,iBA8BnB,oBAAA,CAAqB,KAAA,UAAe,OAAA,GAAS,oBAAA;AAAA,iBA6B7C,YAAA,CAAa,GAAA,UAAa,OAAA,EAAS,UAAA"}

package/dist/keys.mjs

@@ -0,0 +1,253 @@
+//#region keys.ts
+/**
+* @fileoverview Storage Key Generation and Management Utilities
+* Storage Key Generation and Management Utilities
+*
+* Provides utilities for generating, parsing, and validating storage keys
+* with support for various patterns and path normalization.
+*/
+/**
+* Generate a cryptographically secure alphanumeric string
+*
+* @param length - Length of the string to generate
+* @returns Alphanumeric string (0-9a-zA-Z)
+*/
+function generateAlphanumeric(length) {
+	const chars = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
+	const randomValues = new Uint8Array(length);
+	crypto.getRandomValues(randomValues);
+	return Array.from(randomValues, (byte) => chars[byte % 62]).join("");
+}
+/**
+* Generate a storage key using various patterns
+*
+* @param options - Key generation options
+* @returns Generated storage key
+*
+* @example
+* ```typescript
+* // Timestamped key
+* generateStorageKey({ pattern: 'timestamped', prefix: 'uploads' })
+* // → "uploads/2024/01/15/abc123.jpg"
+*
+* // UUID key
+* generateStorageKey({ pattern: 'uuid', extension: 'pdf' })
+* // → "550e8400-e29b-41d4-a716-446655440000.pdf"
+*
+* // Custom pattern
+* generateStorageKey({
+*   pattern: 'custom',
+*   customFormat: (base) => `user-${base}-${Date.now()}`
+* })
+* // → "user-abc123-1705123456789"
+* ```
+*/
+function generateStorageKey(options = {}) {
+	const { pattern = "random", prefix = "", suffix = "", extension = "", includeTimestamp = false, customFormat } = options;
+	let baseKey;
+	switch (pattern) {
+		case "timestamped":
+			const now = /* @__PURE__ */ new Date();
+			baseKey = `${now.getFullYear()}/${(now.getMonth() + 1).toString().padStart(2, "0")}/${now.getDate().toString().padStart(2, "0")}/${generateAlphanumeric(6)}`;
+			break;
+		case "uuid":
+			baseKey = crypto.randomUUID();
+			break;
+		case "random":
+			baseKey = generateAlphanumeric(12);
+			break;
+		case "custom":
+			if (!customFormat) throw new Error("customFormat is required for custom pattern");
+			baseKey = customFormat(generateAlphanumeric(8));
+			break;
+		default: baseKey = generateAlphanumeric(12);
+	}
+	if (includeTimestamp && pattern !== "timestamped") baseKey = `${baseKey}-${Date.now()}`;
+	if (extension) {
+		const ext = extension.startsWith(".") ? extension : `.${extension}`;
+		baseKey = `${baseKey}${ext}`;
+	}
+	let finalKey = baseKey;
+	if (prefix) finalKey = `${prefix}/${finalKey}`;
+	if (suffix) finalKey = `${finalKey.replace(/\.[^/.]+$/, "")}-${suffix}${finalKey.match(/\.[^/.]+$/)?.[0] ?? ""}`;
+	return finalKey;
+}
+/**
+* Parse a storage key to extract components
+*
+* @param key - Storage key to parse
+* @returns Parsed key components
+*
+* @example
+* ```typescript
+* parseStorageKey('uploads/2024/01/15/abc123.jpg')
+* // → {
+* //   prefix: 'uploads',
+* //   path: '2024/01/15',
+* //   filename: 'abc123.jpg',
+* //   name: 'abc123',
+* //   extension: '.jpg',
+* //   isTimestamped: true
+* // }
+* ```
+*/
+function parseStorageKey(key) {
+	if (!key || typeof key !== "string") throw new Error("Invalid storage key: must be a non-empty string");
+	if (key.length > 1024) throw new Error("Storage key exceeds maximum length (1024 characters)");
+	const parts = key.split("/");
+	const filename = parts[parts.length - 1] ?? "";
+	const pathParts = parts.slice(0, -1);
+	const prefix = pathParts.length > 1 ? pathParts[0] : void 0;
+	const path = pathParts.length > 1 ? pathParts.slice(1).join("/") : pathParts.join("/");
+	const lastDotIndex = filename.lastIndexOf(".");
+	const name = lastDotIndex > 0 ? filename.substring(0, lastDotIndex) : filename;
+	return {
+		prefix,
+		path,
+		filename,
+		name,
+		extension: lastDotIndex > 0 ? filename.substring(lastDotIndex) : "",
+		isTimestamped: /^\d{4}\/\d{2}\/\d{2}\//.test(key),
+		isUuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(name)
+	};
+}
+/**
+* Validate a storage key
+*
+* @param key - Storage key to validate
+* @param options - Validation options
+* @returns Validation result
+*
+* @example
+* ```typescript
+* validateStorageKey('uploads/file.jpg', { maxLength: 100 })
+* // → { valid: true, errors: [] }
+*
+* validateStorageKey('', { required: true })
+* // → { valid: false, errors: ['Key cannot be empty'] }
+* ```
+*/
+function validateStorageKey(key, options = {}) {
+	const { required = true, maxLength = 1024, allowedExtensions = [], forbiddenPatterns = [], allowEmpty = false } = options;
+	const errors = [];
+	if (allowEmpty && (!key || key.trim() === "")) return {
+		valid: true,
+		errors: []
+	};
+	if (required && (!key || key.trim() === "")) {
+		errors.push("Key cannot be empty");
+		return {
+			valid: false,
+			errors
+		};
+	}
+	if (!allowEmpty && (!key || key.trim() === "")) {
+		errors.push("Key cannot be empty");
+		return {
+			valid: false,
+			errors
+		};
+	}
+	if (key.length > maxLength) errors.push(`Key exceeds maximum length of ${maxLength} characters`);
+	for (const pattern of forbiddenPatterns) if (pattern.test(key)) errors.push(`Key matches forbidden pattern: ${pattern.source}`);
+	if (/[<>:"|?*]/.test(key)) errors.push("Key contains invalid characters: < > : \" | ? *");
+	if (key.includes("//")) errors.push("Key contains double slashes");
+	if (key.startsWith("/") || key.endsWith("/")) errors.push("Key should not start or end with slashes");
+	if (key.includes("../") || key.includes("./")) errors.push("Key contains relative path traversal");
+	if (allowedExtensions.length > 0) {
+		const extension = key.match(/\.[^/.]+$/)?.[0]?.toLowerCase();
+		if (extension && !allowedExtensions.includes(extension)) errors.push(`File extension ${extension} is not allowed. Allowed: ${allowedExtensions.join(", ")}`);
+	}
+	return {
+		valid: errors.length === 0,
+		errors
+	};
+}
+/**
+* Normalize a storage key path
+*
+* @param key - Storage key to normalize
+* @returns Normalized storage key
+*
+* @example
+* ```typescript
+* normalizeStorageKey('uploads//folder///file.jpg')
+* // → "uploads/folder/file.jpg"
+*
+* normalizeStorageKey('/uploads/file.jpg/')
+* // → "uploads/file.jpg"
+* ```
+*/
+function normalizeStorageKey(key) {
+	if (!key || typeof key !== "string") return "";
+	return key.replace(/\/+/g, "/").replace(/^\/+/, "").replace(/\/+$/, "").trim();
+}
+/**
+* Sanitize a storage key by removing dangerous characters
+*
+* @param key - Storage key to sanitize
+* @returns Sanitized storage key
+*
+* @example
+* ```typescript
+* sanitizeStorageKey('uploads/file<script>.jpg')
+* // → "uploads/filescript.jpg"
+* ```
+*/
+function sanitizeStorageKey(key) {
+	if (!key || typeof key !== "string") return "";
+	return key.replace(/[<>:"|?*]/g, "").replace(/[^\w\s.-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-+|-+$/g, "");
+}
+/**
+* Generate multiple storage keys
+*
+* @param count - Number of keys to generate
+* @param options - Key generation options
+* @returns Array of generated storage keys
+*
+* @example
+* ```typescript
+* generateMultipleKeys(3, { pattern: 'uuid', prefix: 'uploads' })
+* // → [
+* //   "uploads/550e8400-e29b-41d4-a716-446655440000",
+* //   "uploads/6ba7b810-9dad-11d1-80b4-00c04fd430c8",
+* //   "uploads/6ba7b811-9dad-11d1-80b4-00c04fd430c8"
+* // ]
+* ```
+*/
+function generateMultipleKeys(count, options = {}) {
+	if (count <= 0) return [];
+	const keys = [];
+	for (let i = 0; i < count; i++) keys.push(generateStorageKey(options));
+	return keys;
+}
+/**
+* Check if a storage key follows a specific pattern
+*
+* @param key - Storage key to check
+* @param pattern - Pattern to match against
+* @returns True if key matches pattern
+*
+* @example
+* ```typescript
+* isKeyPattern('uploads/2024/01/15/file.jpg', 'timestamped')
+* // → true
+*
+* isKeyPattern('550e8400-e29b-41d4-a716-446655440000', 'uuid')
+* // → true
+* ```
+*/
+function isKeyPattern(key, pattern) {
+	const parsed = parseStorageKey(key);
+	switch (pattern) {
+		case "timestamped": return parsed.isTimestamped;
+		case "uuid": return parsed.isUuid;
+		case "random": return !parsed.isTimestamped && !parsed.isUuid;
+		case "custom": return !parsed.isTimestamped && !parsed.isUuid;
+		default: return false;
+	}
+}
+
+//#endregion
+export { generateMultipleKeys, generateStorageKey, isKeyPattern, normalizeStorageKey, parseStorageKey, sanitizeStorageKey, validateStorageKey };
+//# sourceMappingURL=keys.mjs.map

package/dist/keys.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.mjs","names":[],"sources":["../keys.ts"],"sourcesContent":["/**\n * @fileoverview Storage Key Generation and Management Utilities\n * Storage Key Generation and Management Utilities\n *\n * Provides utilities for generating, parsing, and validating storage keys\n * with support for various patterns and path normalization.\n */\n\n/**\n * Generate a cryptographically secure alphanumeric string\n *\n * @param length - Length of the string to generate\n * @returns Alphanumeric string (0-9a-zA-Z)\n */\nfunction generateAlphanumeric(length: number): string {\n  const chars = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';\n  const randomValues = new Uint8Array(length);\n  crypto.getRandomValues(randomValues);\n  return Array.from(randomValues, (byte) => chars[byte % chars.length]).join('');\n}\n\n/**\n * Storage key generation patterns\n */\nexport type KeyPattern = 'timestamped' | 'uuid' | 'random' | 'custom';\n\n/**\n * Options for key generation\n */\nexport interface KeyGenerationOptions {\n  pattern?: KeyPattern;\n  prefix?: string;\n  suffix?: string;\n  extension?: string;\n  includeTimestamp?: boolean;\n  customFormat?: (base: string) => string;\n}\n\n/**\n * Generate a storage key using various patterns\n *\n * @param options - Key generation options\n * @returns Generated storage key\n *\n * @example\n * ```typescript\n * // Timestamped key\n * generateStorageKey({ pattern: 'timestamped', prefix: 'uploads' })\n * // → \"uploads/2024/01/15/abc123.jpg\"\n *\n * // UUID key\n * generateStorageKey({ pattern: 'uuid', extension: 'pdf' })\n * // → \"550e8400-e29b-41d4-a716-446655440000.pdf\"\n *\n * // Custom pattern\n * generateStorageKey({\n *   pattern: 'custom',\n *   customFormat: (base) => `user-${base}-${Date.now()}`\n * })\n * // → \"user-abc123-1705123456789\"\n * ```\n */\nexport function generateStorageKey(options: KeyGenerationOptions = {}): string {\n  const {\n    pattern = 'random',\n    prefix = '',\n    suffix = '',\n    extension = '',\n    includeTimestamp = false,\n    customFormat,\n  } = options;\n\n  let baseKey: string;\n\n  switch (pattern) {\n    case 'timestamped':\n      const now = new Date();\n      const year = now.getFullYear();\n      const month = (now.getMonth() + 1).toString().padStart(2, '0');\n      const day = now.getDate().toString().padStart(2, '0');\n      const randomId = generateAlphanumeric(6);\n      baseKey = `${year}/${month}/${day}/${randomId}`;\n      break;\n\n    case 'uuid':\n      baseKey = crypto.randomUUID();\n      break;\n\n    case 'random':\n      baseKey = generateAlphanumeric(12);\n      break;\n\n    case 'custom':\n      if (!customFormat) {\n        throw new Error('customFormat is required for custom pattern');\n      }\n      baseKey = customFormat(generateAlphanumeric(8));\n      break;\n\n    default:\n      baseKey = generateAlphanumeric(12);\n  }\n\n  // Add timestamp if requested\n  if (includeTimestamp && pattern !== 'timestamped') {\n    baseKey = `${baseKey}-${Date.now()}`;\n  }\n\n  // Add extension\n  if (extension) {\n    const ext = extension.startsWith('.') ? extension : `.${extension}`;\n    baseKey = `${baseKey}${ext}`;\n  }\n\n  // Add prefix and suffix\n  let finalKey = baseKey;\n  if (prefix) {\n    finalKey = `${prefix}/${finalKey}`;\n  }\n  if (suffix) {\n    const nameWithoutExt = finalKey.replace(/\\.[^/.]+$/, '');\n    const ext = finalKey.match(/\\.[^/.]+$/)?.[0] ?? '';\n    finalKey = `${nameWithoutExt}-${suffix}${ext}`;\n  }\n\n  return finalKey;\n}\n\n/**\n * Parse a storage key to extract components\n *\n * @param key - Storage key to parse\n * @returns Parsed key components\n *\n * @example\n * ```typescript\n * parseStorageKey('uploads/2024/01/15/abc123.jpg')\n * // → {\n * //   prefix: 'uploads',\n * //   path: '2024/01/15',\n * //   filename: 'abc123.jpg',\n * //   name: 'abc123',\n * //   extension: '.jpg',\n * //   isTimestamped: true\n * // }\n * ```\n */\nexport function parseStorageKey(key: string): {\n  prefix?: string;\n  path: string;\n  filename: string;\n  name: string;\n  extension: string;\n  isTimestamped: boolean;\n  isUuid: boolean;\n} {\n  // Input validation\n  if (!key || typeof key !== 'string') {\n    throw new Error('Invalid storage key: must be a non-empty string');\n  }\n\n  // Prevent DoS via extremely long keys (max 1024 characters)\n  if (key.length > 1024) {\n    throw new Error('Storage key exceeds maximum length (1024 characters)');\n  }\n\n  const parts = key.split('/');\n  const filename = parts[parts.length - 1] ?? '';\n  const pathParts = parts.slice(0, -1);\n\n  // Extract prefix (first part if multiple parts)\n  const prefix = pathParts.length > 1 ? pathParts[0] : undefined;\n  const path = pathParts.length > 1 ? pathParts.slice(1).join('/') : pathParts.join('/');\n\n  // Extract filename components\n  const lastDotIndex = filename.lastIndexOf('.');\n  const name = lastDotIndex > 0 ? filename.substring(0, lastDotIndex) : filename;\n  const extension = lastDotIndex > 0 ? filename.substring(lastDotIndex) : '';\n\n  // Detect patterns\n  const isTimestamped = /^\\d{4}\\/\\d{2}\\/\\d{2}\\//.test(key);\n  const isUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(name);\n\n  return {\n    prefix,\n    path,\n    filename,\n    name,\n    extension,\n    isTimestamped,\n    isUuid,\n  };\n}\n\n/**\n * Validate a storage key\n *\n * @param key - Storage key to validate\n * @param options - Validation options\n * @returns Validation result\n *\n * @example\n * ```typescript\n * validateStorageKey('uploads/file.jpg', { maxLength: 100 })\n * // → { valid: true, errors: [] }\n *\n * validateStorageKey('', { required: true })\n * // → { valid: false, errors: ['Key cannot be empty'] }\n * ```\n */\nexport function validateStorageKey(\n  key: string,\n  options: {\n    required?: boolean;\n    maxLength?: number;\n    allowedExtensions?: string[];\n    forbiddenPatterns?: RegExp[];\n    allowEmpty?: boolean;\n  } = {},\n): { valid: boolean; errors: string[] } {\n  const {\n    required = true,\n    maxLength = 1024,\n    allowedExtensions = [],\n    forbiddenPatterns = [],\n    allowEmpty = false,\n  } = options;\n\n  const errors: string[] = [];\n\n  // If allowEmpty is explicitly set to true, empty keys are valid\n  if (allowEmpty && (!key || key.trim() === '')) {\n    return { valid: true, errors: [] };\n  }\n\n  // Check if key is provided\n  if (required && (!key || key.trim() === '')) {\n    errors.push('Key cannot be empty');\n    return { valid: false, errors };\n  }\n\n  if (!allowEmpty && (!key || key.trim() === '')) {\n    errors.push('Key cannot be empty');\n    return { valid: false, errors };\n  }\n\n  // Check length\n  if (key.length > maxLength) {\n    errors.push(`Key exceeds maximum length of ${maxLength} characters`);\n  }\n\n  // Check for forbidden patterns\n  for (const pattern of forbiddenPatterns) {\n    if (pattern.test(key)) {\n      errors.push(`Key matches forbidden pattern: ${pattern.source}`);\n    }\n  }\n\n  // Check for invalid characters\n  if (/[<>:\"|?*]/.test(key)) {\n    errors.push('Key contains invalid characters: < > : \" | ? *');\n  }\n\n  // Check for double slashes\n  if (key.includes('//')) {\n    errors.push('Key contains double slashes');\n  }\n\n  // Check for leading/trailing slashes\n  if (key.startsWith('/') || key.endsWith('/')) {\n    errors.push('Key should not start or end with slashes');\n  }\n\n  // Check for relative path traversal\n  if (key.includes('../') || key.includes('./')) {\n    errors.push('Key contains relative path traversal');\n  }\n\n  // Check file extension if specified\n  if (allowedExtensions.length > 0) {\n    const extension = key.match(/\\.[^/.]+$/)?.[0]?.toLowerCase();\n    if (extension && !allowedExtensions.includes(extension)) {\n      errors.push(\n        `File extension ${extension} is not allowed. Allowed: ${allowedExtensions.join(', ')}`,\n      );\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors,\n  };\n}\n\n/**\n * Normalize a storage key path\n *\n * @param key - Storage key to normalize\n * @returns Normalized storage key\n *\n * @example\n * ```typescript\n * normalizeStorageKey('uploads//folder///file.jpg')\n * // → \"uploads/folder/file.jpg\"\n *\n * normalizeStorageKey('/uploads/file.jpg/')\n * // → \"uploads/file.jpg\"\n * ```\n */\nexport function normalizeStorageKey(key: string): string {\n  if (!key || typeof key !== 'string') {\n    return '';\n  }\n\n  return key\n    .replace(/\\/+/g, '/') // Replace multiple slashes with single slash\n    .replace(/^\\/+/, '') // Remove leading slashes\n    .replace(/\\/+$/, '') // Remove trailing slashes\n    .trim();\n}\n\n/**\n * Sanitize a storage key by removing dangerous characters\n *\n * @param key - Storage key to sanitize\n * @returns Sanitized storage key\n *\n * @example\n * ```typescript\n * sanitizeStorageKey('uploads/file<script>.jpg')\n * // → \"uploads/filescript.jpg\"\n * ```\n */\nexport function sanitizeStorageKey(key: string): string {\n  if (!key || typeof key !== 'string') {\n    return '';\n  }\n\n  return key\n    .replace(/[<>:\"|?*]/g, '') // Remove dangerous characters\n    .replace(/[^\\w\\s.-]/g, '') // Keep only word chars, spaces, dots, hyphens\n    .replace(/\\s+/g, '-') // Replace spaces with hyphens\n    .replace(/-+/g, '-') // Replace multiple hyphens with single hyphen\n    .replace(/^-+|-+$/g, ''); // Remove leading/trailing hyphens\n}\n\n/**\n * Generate multiple storage keys\n *\n * @param count - Number of keys to generate\n * @param options - Key generation options\n * @returns Array of generated storage keys\n *\n * @example\n * ```typescript\n * generateMultipleKeys(3, { pattern: 'uuid', prefix: 'uploads' })\n * // → [\n * //   \"uploads/550e8400-e29b-41d4-a716-446655440000\",\n * //   \"uploads/6ba7b810-9dad-11d1-80b4-00c04fd430c8\",\n * //   \"uploads/6ba7b811-9dad-11d1-80b4-00c04fd430c8\"\n * // ]\n * ```\n */\nexport function generateMultipleKeys(count: number, options: KeyGenerationOptions = {}): string[] {\n  if (count <= 0) {\n    return [];\n  }\n\n  const keys: string[] = [];\n  for (let i = 0; i < count; i++) {\n    keys.push(generateStorageKey(options));\n  }\n\n  return keys;\n}\n\n/**\n * Check if a storage key follows a specific pattern\n *\n * @param key - Storage key to check\n * @param pattern - Pattern to match against\n * @returns True if key matches pattern\n *\n * @example\n * ```typescript\n * isKeyPattern('uploads/2024/01/15/file.jpg', 'timestamped')\n * // → true\n *\n * isKeyPattern('550e8400-e29b-41d4-a716-446655440000', 'uuid')\n * // → true\n * ```\n */\nexport function isKeyPattern(key: string, pattern: KeyPattern): boolean {\n  const parsed = parseStorageKey(key);\n\n  switch (pattern) {\n    case 'timestamped':\n      return parsed.isTimestamped;\n    case 'uuid':\n      return parsed.isUuid;\n    case 'random':\n      return !parsed.isTimestamped && !parsed.isUuid;\n    case 'custom':\n      return !parsed.isTimestamped && !parsed.isUuid;\n    default:\n      return false;\n  }\n}\n"],"mappings":"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"}