@warlock.js/core 5.31.0 → 5.32.0

package/esm/storage/drivers/cloud-driver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-driver.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/cloud-driver.ts"],"sourcesContent":["import crypto from \"crypto\";\nimport { createRequire } from \"module\";\nimport type { Readable } from \"stream\";\nimport { storageDriverContext } from \"../context/storage-driver-context\";\nimport type {\n  CloudStorageDriverContract,\n  CloudStorageDriverOptions,\n  CloudStorageFileData,\n  DeleteManyResult,\n  FileVisibility,\n  ListOptions,\n  PresignedOptions,\n  PresignedUploadOptions,\n  PutOptions,\n  StorageDriverType,\n  StorageFileInfo,\n} from \"../types\";\nimport { getMimeType } from \"../utils/mime\";\nimport { StorageCapabilityError } from \"../utils/storage-capability-error\";\n\n// ============================================================\n// Lazy-loaded S3 SDK Types\n// ============================================================\n\n/**\n * Cached S3 SDK modules (loaded once, reused)\n */\nlet S3Client: typeof import(\"@aws-sdk/client-s3\");\nlet S3Storage: typeof import(\"@aws-sdk/lib-storage\");\nlet S3Presigner: typeof import(\"@aws-sdk/s3-request-presigner\");\n\nlet isModuleExists: boolean | null = null;\n\n/**\n * Installation instructions for S3 SDK packages\n */\nconst S3_INSTALL_INSTRUCTIONS = `\nCloud storage requires the AWS S3 SDK packages.\nInstall them with:\n\n  warlock add s3\n\n(raw packages: @aws-sdk/client-s3, @aws-sdk/lib-storage, @aws-sdk/s3-request-presigner)\n`.trim();\n\n/**\n * Atomic initialization promise to handle concurrent calls to loadS3\n */\nlet initializationPromise: Promise<void> | null = null;\n\n/**\n * Load S3 modules lazily\n *\n * @example\n * await loadS3();\n * if (isModuleExists) {\n *   // Safe to use S3Client, S3Storage, S3Presigner\n * }\n */\nexport async function loadS3(): Promise<void> {\n  // If already successfully loaded, no need to do anything\n  if (isModuleExists === true) return;\n\n  // If currently loading, return the existing promise so the caller waits\n  if (initializationPromise) return initializationPromise;\n\n  initializationPromise = (async () => {\n    try {\n      // Use Promise.all to load modules in parallel for efficiency\n      const [client, storage, presigner] = await Promise.all([\n        import(\"@aws-sdk/client-s3\"),\n        import(\"@aws-sdk/lib-storage\"),\n        import(\"@aws-sdk/s3-request-presigner\"),\n      ]);\n\n      S3Client = client;\n      S3Storage = storage;\n      S3Presigner = presigner;\n\n      isModuleExists = true;\n    } catch {\n      // Mark as failed if any import fails (usually means packages aren't installed)\n      isModuleExists = false;\n    }\n  })();\n\n  return initializationPromise;\n}\n\nloadS3();\n\n/**\n * Synchronous fallback loader.\n *\n * `loadS3()` above is async and fire-and-forget at module load, so on the\n * very first *synchronous* `CloudDriver` construction the dynamic `import()`\n * microtask has not yet resolved — `isModuleExists` is still `null` even when\n * the SDK is genuinely installed. The constructor's install-check would then\n * throw the misleading \"SDK not installed\" error.\n *\n * This probes the modules synchronously via `require` (the AWS SDK ships\n * CJS-compatible builds) so a present SDK resolves the install-check\n * immediately, without waiting on the async path. Returns `true` when all\n * three modules loaded, `false` otherwise. Only invoked while\n * `isModuleExists` is still indeterminate.\n */\nfunction loadS3Sync(): boolean {\n  if (isModuleExists !== null) {\n    return isModuleExists;\n  }\n\n  try {\n    // `createRequire` gives an ESM-safe synchronous `require` regardless of\n    // whether this module runs as CJS or ESM at runtime.\n    const req = createRequire(import.meta.url);\n    S3Client = req(\"@aws-sdk/client-s3\");\n    S3Storage = req(\"@aws-sdk/lib-storage\");\n    S3Presigner = req(\"@aws-sdk/s3-request-presigner\");\n    isModuleExists = true;\n  } catch {\n    isModuleExists = false;\n  }\n\n  return isModuleExists;\n}\n\n// ============================================================\n// CloudDriver Base Class\n// ============================================================\n\n/**\n * Base abstract class for all S3-compatible cloud storage drivers\n *\n * This class contains all shared logic for S3-compatible storage services\n * including AWS S3, Cloudflare R2, DigitalOcean Spaces, and others.\n *\n * **Important:** S3 SDK packages are lazy-loaded on first use.\n * Users must install them separately:\n * ```\n * npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n * ```\n *\n * Subclasses must implement:\n * - `name`: Driver identifier (e.g., \"s3\", \"r2\", \"spaces\")\n * - `url()`: Returns the public URL for a file (provider-specific format)\n */\nexport abstract class CloudDriver<\n  TOptions extends Partial<CloudStorageDriverOptions> = CloudStorageDriverOptions,\n> implements CloudStorageDriverContract {\n  /**\n   * S3-compatible client (lazy-loaded)\n   */\n  protected client!: InstanceType<typeof import(\"@aws-sdk/client-s3\").S3Client>;\n\n  /**\n   * Retry configuration\n   */\n  protected retryConfig: {\n    maxRetries: number;\n    initialDelayMs: number;\n    maxDelayMs: number;\n    backoffMultiplier: number;\n  };\n\n  /**\n   * How object visibility is applied: per-object ACLs (default), bucket\n   * policy (no per-object ACL is sent), or unsupported (\"none\").\n   * Buckets with ACLs disabled (S3 BucketOwnerEnforced, R2) need\n   * \"policy\" or \"none\".\n   */\n  protected get visibilityMode(): \"acl\" | \"policy\" | \"none\" {\n    return (this.options as { visibilityMode?: \"acl\" | \"policy\" | \"none\" }).visibilityMode ?? \"acl\";\n  }\n\n  /**\n   * Resolve the ACL to send on a put for the requested visibility.\n   *\n   * @throws {StorageCapabilityError} When public is requested but the driver has no visibility support\n   */\n  protected resolveAcl(visibility?: FileVisibility): \"public-read\" | undefined {\n    if (visibility !== \"public\") return undefined;\n\n    if (this.visibilityMode === \"none\") {\n      throw new StorageCapabilityError(\"public visibility\", this.name);\n    }\n\n    return this.visibilityMode === \"acl\" ? \"public-read\" : undefined;\n  }\n\n  public constructor(public options: TOptions) {\n    // The async loadS3() may not have resolved yet on the first synchronous\n    // construction. When the flag is still indeterminate, probe synchronously\n    // so a genuinely-installed SDK never triggers the misleading throw below.\n    if (isModuleExists === null) {\n      loadS3Sync();\n    }\n\n    if (!isModuleExists) {\n      throw new Error(S3_INSTALL_INSTRUCTIONS);\n    }\n\n    // Any remaining option is an S3ClientConfig option (forcePathStyle,\n    // requestHandler, maxAttempts, ...) and is passed through to the SDK.\n    const {\n      bucket: _bucket,\n      accessKeyId,\n      secretAccessKey,\n      endpoint: _endpoint,\n      prefix: _prefix,\n      urlPrefix: _urlPrefix,\n      retry: _retry,\n      accountId: _accountId,\n      publicDomain: _publicDomain,\n      driver: _driver,\n      visibilityMode: _visibilityMode,\n      ...clientOptions\n    } = this.options as TOptions & Record<string, unknown>;\n\n    this.client = new S3Client.S3Client({\n      ...clientOptions,\n      region: this.options.region!,\n      // Without static keys the SDK default provider chain applies\n      // (IAM role, ECS task role, IRSA, SSO profile).\n      ...(accessKeyId && secretAccessKey && { credentials: { accessKeyId, secretAccessKey } }),\n      ...(this.getEndpoint() && { endpoint: this.getEndpoint() }),\n    } as import(\"@aws-sdk/client-s3\").S3ClientConfig);\n\n    // Initialize retry configuration\n    this.retryConfig = {\n      maxRetries: this.options.retry?.maxRetries ?? 3,\n      initialDelayMs: this.options.retry?.initialDelayMs ?? 1000,\n      maxDelayMs: this.options.retry?.maxDelayMs ?? 10000,\n      backoffMultiplier: this.options.retry?.backoffMultiplier ?? 2,\n    };\n  }\n\n  /**\n   * Driver name identifier\n   */\n  public abstract readonly name: StorageDriverType;\n\n  /**\n   * Get public URL for file\n   * Must be implemented by subclasses with provider-specific format\n   */\n  public abstract url(location: string): string;\n\n  /**\n   * Get endpoint URL\n   * Can be overridden by subclasses for provider-specific endpoints\n   */\n  protected getEndpoint(): string | undefined {\n    return this.options.endpoint;\n  }\n\n  // ============================================================\n  // Helper Methods\n  // ============================================================\n\n  /**\n   * Apply prefix to location path\n   *\n   * Priority: context prefix > driver options prefix > no prefix\n   * This allows multi-tenant scenarios where context overrides driver config.\n   *\n   * @param location - Original location path\n   * @returns Location with prefix applied if one exists\n   */\n  public applyPrefix(location: string): string {\n    // Check context prefix first (highest priority)\n    const contextPrefix = storageDriverContext.getPrefix();\n    const prefix = contextPrefix || this.options.prefix;\n\n    if (!prefix) {\n      return location;\n    }\n\n    const cleanPrefix = prefix.replace(/\\/+$/, \"\");\n    const cleanLocation = location.replace(/^\\/+/, \"\");\n\n    // Avoid double-prefixing\n    if (cleanLocation.startsWith(cleanPrefix + \"/\") || cleanLocation === cleanPrefix) {\n      return cleanLocation;\n    }\n\n    return `${cleanPrefix}/${cleanLocation}`;\n  }\n\n  /**\n   * Normalize storage path (remove double slashes, sanitize)\n   * @internal\n   */\n  protected normalizePath(path: string): string {\n    return path\n      .replace(/\\/+/g, \"/\") // Remove multiple slashes\n      .replace(/^\\//, \"\") // Remove leading slash\n      .trim();\n  }\n\n  /**\n   * Execute an operation with retry logic\n   *\n   * Retries on transient errors with exponential backoff.\n   *\n   * @param operation - Async operation to execute\n   * @param operationName - Name for logging\n   * @returns Result of the operation\n   * @internal\n   */\n  protected async withRetry<T>(\n    operation: () => Promise<T>,\n    operationName: string = \"operation\",\n  ): Promise<T> {\n    const { maxRetries, initialDelayMs, backoffMultiplier, maxDelayMs } = this.retryConfig;\n\n    let lastError: unknown;\n\n    // maxRetries counts retries, not attempts: 0 means a single attempt\n    const attempts = maxRetries + 1;\n\n    for (let attempt = 0; attempt < attempts; attempt++) {\n      try {\n        return await operation();\n      } catch (error) {\n        lastError = error;\n\n        // Don't retry on the last attempt\n        if (attempt === attempts - 1) {\n          break;\n        }\n\n        // Check if error is retryable\n        if (!this.isRetryableError(error)) {\n          throw error; // Non-retryable error, fail immediately\n        }\n\n        // Calculate delay with exponential backoff\n        const delayMs = Math.min(initialDelayMs * Math.pow(backoffMultiplier, attempt), maxDelayMs);\n\n        // Wait before retrying\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n    }\n\n    // Rethrow the original error so name/$metadata survive\n    throw lastError;\n  }\n\n  /**\n   * Check if an error is retryable\n   *\n   * Retries on:\n   * - Network errors\n   * - 5xx server errors\n   * - Rate limiting (429)\n   * - Timeout errors\n   *\n   * Does NOT retry on:\n   * - 4xx client errors (except 429)\n   * - Authentication errors\n   * - Not found errors\n   *\n   * @param error - Error to check\n   * @returns true if error is retryable\n   * @internal\n   */\n  protected isRetryableError(error: any): boolean {\n    // Network errors\n    if (error.code === \"ECONNRESET\" || error.code === \"ETIMEDOUT\" || error.code === \"ENOTFOUND\") {\n      return true;\n    }\n\n    // S3 SDK errors\n    if (error.name === \"NetworkingError\" || error.name === \"TimeoutError\") {\n      return true;\n    }\n\n    // HTTP status codes\n    const statusCode = error.$metadata?.httpStatusCode || error.statusCode;\n    if (statusCode) {\n      // 5xx server errors are retryable\n      if (statusCode >= 500 && statusCode < 600) {\n        return true;\n      }\n\n      // 429 Too Many Requests is retryable\n      if (statusCode === 429) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  // ============================================================\n  // Core File Operations\n  // ============================================================\n\n  /**\n   * Put file to cloud storage\n   */\n  public async put(\n    file: Buffer,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const hash = this.calculateHash(file);\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        Body: file,\n        ContentType: mimeType,\n        CacheControl: options?.cacheControl,\n        ContentDisposition: options?.contentDisposition,\n        Metadata: options?.metadata,\n        ACL: this.resolveAcl(options?.visibility),\n      });\n\n      const result = await this.client.send(command);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: file.length,\n        hash,\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"put\");\n  }\n\n  /**\n   * Atomically put a file only if the key does not exist (S3 conditional\n   * write, `If-None-Match: *`).\n   *\n   * HTTP 412 (PreconditionFailed) and 409 (ConditionalRequestConflict, a\n   * concurrent conditional write in flight) mean \"already exists\" and return\n   * `null`. Every other error throws.\n   */\n  public async putIfAbsent(\n    file: Buffer | string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData | null> {\n    const body = typeof file === \"string\" ? Buffer.from(file) : file;\n\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n\n      location = this.applyPrefix(location);\n\n      const hash = this.calculateHash(body);\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        Body: body,\n        ContentType: mimeType,\n        CacheControl: options?.cacheControl,\n        ContentDisposition: options?.contentDisposition,\n        Metadata: options?.metadata,\n        ACL: this.resolveAcl(options?.visibility),\n        IfNoneMatch: \"*\",\n      });\n\n      let result;\n\n      try {\n        result = await this.client.send(command);\n      } catch (error: any) {\n        const status = error?.$metadata?.httpStatusCode;\n\n        if (\n          status === 412 ||\n          status === 409 ||\n          error?.name === \"PreconditionFailed\" ||\n          error?.name === \"ConditionalRequestConflict\"\n        ) {\n          return null;\n        }\n\n        throw error;\n      }\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: body.length,\n        hash,\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"putIfAbsent\");\n  }\n\n  /**\n   * Put file from a readable stream (for large files)\n   * Uses S3 multipart upload for efficient streaming\n   */\n  public async putStream(\n    stream: Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    // Not wrapped in withRetry: a retry would replay an already-consumed\n    // stream, and lib-storage already retries individual parts.\n    {\n      const { Upload } = S3Storage;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const upload = new Upload({\n        client: this.client,\n        params: {\n          Bucket: this.options.bucket,\n          Key: location,\n          Body: stream,\n          ContentType: mimeType,\n          CacheControl: options?.cacheControl,\n          ContentDisposition: options?.contentDisposition,\n          Metadata: options?.metadata,\n          ACL: this.resolveAcl(options?.visibility),\n        },\n      });\n\n      const result = await upload.done();\n\n      // Get file info for size and hash\n      const info = await this.metadata(location);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: info.size,\n        hash: info.etag?.replace(/\"/g, \"\") || \"\",\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }\n  }\n\n  /**\n   * Get file contents as Buffer\n   */\n  public async get(location: string): Promise<Buffer> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return Buffer.from(await result.Body.transformToByteArray());\n    }, \"get\");\n  }\n\n  /**\n   * Get file as a readable stream (for large files)\n   */\n  public async getStream(location: string): Promise<Readable> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return result.Body as Readable;\n    }, \"getStream\");\n  }\n\n  /**\n   * Delete a file\n   */\n  public async delete(location: string): Promise<boolean> {\n    return this.withRetry(async () => {\n      const { DeleteObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new DeleteObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n\n      return true;\n    }, \"delete\");\n  }\n\n  /**\n   * Delete multiple files at once (uses batch delete for efficiency)\n   */\n  public async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    if (locations.length === 0) {\n      return [];\n    }\n\n    return this.withRetry(async () => {\n      const { DeleteObjectsCommand } = S3Client;\n\n      // Apply storage prefix to all locations\n      const prefixedLocations = locations.map((loc) => this.applyPrefix(loc));\n\n      const command = new DeleteObjectsCommand({\n        Bucket: this.options.bucket,\n        Delete: {\n          Objects: prefixedLocations.map((Key) => ({ Key })),\n          Quiet: false,\n        },\n      });\n\n      const result = await this.client.send(command);\n      const results: DeleteManyResult[] = [];\n\n      // Process successful deletes\n      for (const deleted of result.Deleted || []) {\n        if (deleted.Key) {\n          results.push({ location: deleted.Key, deleted: true });\n        }\n      }\n\n      // Process errors\n      for (const error of result.Errors || []) {\n        if (error.Key) {\n          results.push({\n            location: error.Key,\n            deleted: false,\n            error: error.Message || \"Unknown error\",\n          });\n        }\n      }\n\n      return results;\n    }, \"deleteMany\");\n  }\n\n  /**\n   * Delete directory (recursively deletes all objects with matching prefix)\n   *\n   * S3/R2 doesn't have true directories - only key prefixes.\n   * This method lists all objects with the prefix and deletes them in batches.\n   *\n   * @param directoryPath - Directory prefix to delete\n   * @returns true when all objects are deleted\n   */\n  public async deleteDirectory(directoryPath: string): Promise<boolean> {\n    const { ListObjectsV2Command, DeleteObjectsCommand } = S3Client;\n\n    // Apply storage prefix\n    directoryPath = this.applyPrefix(directoryPath);\n\n    // Ensure directory path ends with / for proper prefix matching\n    const prefix = directoryPath.endsWith(\"/\") ? directoryPath : `${directoryPath}/`;\n\n    // Drive the loop with the ListObjectsV2 IsTruncated / ContinuationToken\n    // contract rather than guessing termination from page size. Each page\n    // carries its own ContinuationToken so we never re-list page one.\n    let continuationToken: string | undefined;\n\n    do {\n      const listResult = await this.withRetry(\n        () =>\n          this.client.send(\n            new ListObjectsV2Command({\n              Bucket: this.options.bucket,\n              Prefix: prefix,\n              ContinuationToken: continuationToken,\n            }),\n          ),\n        \"deleteDirectory:list\",\n      );\n\n      const keys = (listResult.Contents || [])\n        .map((object) => object.Key)\n        .filter((key): key is string => Boolean(key));\n\n      if (keys.length > 0) {\n        // Delete the raw keys directly — they already carry the full prefix\n        // from the listing, so we bypass deleteMany's applyPrefix step.\n        await this.withRetry(\n          () =>\n            this.client.send(\n              new DeleteObjectsCommand({\n                Bucket: this.options.bucket,\n                Delete: {\n                  Objects: keys.map((Key) => ({ Key })),\n                  Quiet: true,\n                },\n              }),\n            ),\n          \"deleteDirectory:delete\",\n        );\n      }\n\n      continuationToken = listResult.IsTruncated ? listResult.NextContinuationToken : undefined;\n    } while (continuationToken);\n\n    return true;\n  }\n\n  /**\n   * Check if file exists\n   */\n  public async exists(location: string): Promise<boolean> {\n    // No retry for exists - it should be fast and failure means non-existent\n    try {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n      return true;\n    } catch (error) {\n      // Only a definite \"not found\" means absent; credential/network/5xx\n      // errors must surface, otherwise `if (!exists) put()` overwrites.\n      const { name, $metadata } = (error ?? {}) as {\n        name?: string;\n        $metadata?: { httpStatusCode?: number };\n      };\n\n      if (name === \"NotFound\" || name === \"NoSuchKey\" || $metadata?.httpStatusCode === 404) {\n        return false;\n      }\n\n      throw error;\n    }\n  }\n\n  // ============================================================\n  // URL Operations\n  // ============================================================\n\n  /**\n   * Get a temporary presigned URL (alias for getPresignedUrl)\n   */\n  public async temporaryUrl(location: string, expiresIn = 3600): Promise<string> {\n    return this.getPresignedUrl(location, { expiresIn });\n  }\n\n  /**\n   * Get presigned URL for downloading\n   */\n  public async getPresignedUrl(location: string, options?: PresignedOptions): Promise<string> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUrl\");\n  }\n\n  /**\n   * Get presigned URL for uploading\n   */\n  public async getPresignedUploadUrl(\n    location: string,\n    options?: PresignedUploadOptions,\n  ): Promise<string> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ContentType: options?.contentType,\n        Metadata: options?.metadata,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUploadUrl\");\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file info/metadata without downloading\n   */\n  public async metadata(location: string): Promise<StorageFileInfo> {\n    return this.withRetry(async () => {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n      const name = location.split(\"/\").pop() || \"\";\n\n      return {\n        path: location,\n        name,\n        size: result.ContentLength || 0,\n        isDirectory: false,\n        lastModified: result.LastModified,\n        mimeType: result.ContentType || this.guessMimeType(location),\n        etag: result.ETag,\n        storageClass: result.StorageClass,\n      };\n    }, \"metadata\");\n  }\n\n  /**\n   * Get file size in bytes (shortcut for metadata().size)\n   */\n  public async size(location: string): Promise<number> {\n    const info = await this.metadata(location);\n    return info.size;\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Build a URL-encoded CopySource (\"bucket/key\") as the SDK requires\n   */\n  protected copySource(key: string): string {\n    const encodedKey = key.split(\"/\").map(encodeURIComponent).join(\"/\");\n\n    return `${this.options.bucket}/${encodedKey}`;\n  }\n\n  /**\n   * Copy file to a new location\n   */\n  public async copy(from: string, to: string): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand, HeadObjectCommand } = S3Client;\n\n      // CopyObject drops the ACL, so a public source would silently become private\n      const visibility = await this.getVisibility(from).catch(() => \"private\" as const);\n\n      // Apply storage prefix to both paths\n      from = this.applyPrefix(from);\n      to = this.applyPrefix(to);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: this.copySource(from),\n        Key: to,\n        ...(this.visibilityMode === \"acl\" &&\n          visibility === \"public\" && { ACL: \"public-read\" as const }),\n      });\n\n      const result = await this.client.send(command);\n\n      // Get file metadata\n      const headCommand = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: to,\n      });\n      const headResult = await this.client.send(headCommand);\n\n      return {\n        path: to,\n        url: this.url(to),\n        size: headResult.ContentLength || 0,\n        hash: headResult.ETag?.replace(/\"/g, \"\") || \"\",\n        mimeType: headResult.ContentType || this.guessMimeType(to),\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.CopyObjectResult?.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"copy\");\n  }\n\n  /**\n   * Move file to a new location\n   */\n  public async move(from: string, to: string): Promise<CloudStorageFileData> {\n    const file = await this.copy(from, to);\n    await this.delete(from);\n    return file;\n  }\n\n  /**\n   * List files in a directory\n   */\n  public async list(directory: string, options?: ListOptions): Promise<StorageFileInfo[]> {\n    return this.withRetry(async () => {\n      const { ListObjectsV2Command } = S3Client;\n\n      // Apply storage prefix\n      directory = this.applyPrefix(directory);\n\n      // A directory prefix must end in \"/\" so \"images\" doesn't match \"images-old/…\"\n      if (directory && directory !== \"/\" && !directory.endsWith(\"/\")) {\n        directory = `${directory}/`;\n      }\n\n      const command = new ListObjectsV2Command({\n        Bucket: this.options.bucket,\n        Prefix: directory,\n        MaxKeys: options?.limit,\n        ContinuationToken: options?.cursor,\n        Delimiter: options?.recursive ? undefined : \"/\",\n      });\n\n      const result = await this.client.send(command);\n      const files: StorageFileInfo[] = [];\n\n      // Add files\n      for (const object of result.Contents || []) {\n        if (!object.Key) continue;\n\n        files.push({\n          path: object.Key,\n          name: object.Key.split(\"/\").pop() || \"\",\n          size: object.Size || 0,\n          isDirectory: false,\n          lastModified: object.LastModified,\n          etag: object.ETag,\n          storageClass: object.StorageClass,\n        });\n      }\n\n      // Add directories\n      for (const prefix of result.CommonPrefixes || []) {\n        if (!prefix.Prefix) continue;\n\n        files.push({\n          path: prefix.Prefix,\n          name: prefix.Prefix.split(\"/\").filter(Boolean).pop() || \"\",\n          size: 0,\n          isDirectory: true,\n        });\n      }\n\n      return files;\n    }, \"list\");\n  }\n\n  // ============================================================\n  // Cloud-Specific Operations\n  // ============================================================\n\n  /**\n   * Get bucket name\n   */\n  public getBucket(): string {\n    return this.options.bucket!;\n  }\n\n  /**\n   * Get region\n   */\n  public getRegion(): string {\n    return this.options.region!;\n  }\n\n  /**\n   * Set storage class (e.g., STANDARD, GLACIER, etc.)\n   */\n  public async setStorageClass(location: string, storageClass: string): Promise<void> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: this.copySource(location),\n        Key: location,\n        StorageClass: storageClass as any,\n        MetadataDirective: \"COPY\",\n      });\n\n      await this.client.send(command);\n    }, \"setStorageClass\");\n  }\n\n  /**\n   * Set file visibility (public or private)\n   */\n  public async setVisibility(location: string, visibility: FileVisibility): Promise<void> {\n    if (this.visibilityMode !== \"acl\") {\n      throw new StorageCapabilityError(\"setVisibility\", this.name);\n    }\n\n    return this.withRetry(async () => {\n      const { PutObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ACL: visibility === \"public\" ? \"public-read\" : \"private\",\n      });\n\n      await this.client.send(command);\n    }, \"setVisibility\");\n  }\n\n  /**\n   * Get file visibility\n   */\n  public async getVisibility(location: string): Promise<FileVisibility> {\n    return this.withRetry(async () => {\n      const { GetObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      // Check if any grant allows public read\n      const hasPublicRead = result.Grants?.some(\n        (grant) =>\n          grant.Grantee?.URI === \"http://acs.amazonaws.com/groups/global/AllUsers\" &&\n          grant.Permission === \"READ\",\n      );\n\n      return hasPublicRead ? \"public\" : \"private\";\n    }, \"getVisibility\");\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Calculate SHA-256 hash\n   */\n  protected calculateHash(buffer: Buffer): string {\n    return crypto.createHash(\"sha256\").update(new Uint8Array(buffer)).digest(\"hex\");\n  }\n\n  /**\n   * Guess MIME type from file extension\n   */\n  protected guessMimeType(location: string): string {\n    return getMimeType(location);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"cloud-driver.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/cloud-driver.ts"],"sourcesContent":["import crypto from \"crypto\";\nimport { createRequire } from \"module\";\nimport type { Readable } from \"stream\";\nimport { storageDriverContext } from \"../context/storage-driver-context\";\nimport type {\n  CloudStorageDriverContract,\n  CloudStorageDriverOptions,\n  CloudStorageFileData,\n  DeleteManyResult,\n  FileVisibility,\n  ListOptions,\n  PresignedOptions,\n  PresignedUploadOptions,\n  PutOptions,\n  StorageDriverType,\n  StorageFileInfo,\n} from \"../types\";\nimport { getMimeType } from \"../utils/mime\";\nimport { StorageCapabilityError } from \"../utils/storage-capability-error\";\n\n// ============================================================\n// Lazy-loaded S3 SDK Types\n// ============================================================\n\n/**\n * Cached S3 SDK modules (loaded once, reused)\n */\nlet S3Client: typeof import(\"@aws-sdk/client-s3\");\nlet S3Storage: typeof import(\"@aws-sdk/lib-storage\");\nlet S3Presigner: typeof import(\"@aws-sdk/s3-request-presigner\");\n\nlet isModuleExists: boolean | null = null;\n\n/**\n * Installation instructions for S3 SDK packages\n */\nconst S3_INSTALL_INSTRUCTIONS = `\nCloud storage requires the AWS S3 SDK packages.\nInstall them with:\n\n  warlock add s3\n\n(raw packages: @aws-sdk/client-s3, @aws-sdk/lib-storage, @aws-sdk/s3-request-presigner)\n`.trim();\n\n/**\n * Atomic initialization promise to handle concurrent calls to loadS3\n */\nlet initializationPromise: Promise<void> | null = null;\n\n/**\n * Load S3 modules lazily\n *\n * @example\n * await loadS3();\n * if (isModuleExists) {\n *   // Safe to use S3Client, S3Storage, S3Presigner\n * }\n */\nexport async function loadS3(): Promise<void> {\n  // If already successfully loaded, no need to do anything\n  if (isModuleExists === true) return;\n\n  // If currently loading, return the existing promise so the caller waits\n  if (initializationPromise) return initializationPromise;\n\n  initializationPromise = (async () => {\n    try {\n      // Use Promise.all to load modules in parallel for efficiency\n      const [client, storage, presigner] = await Promise.all([\n        import(\"@aws-sdk/client-s3\"),\n        import(\"@aws-sdk/lib-storage\"),\n        import(\"@aws-sdk/s3-request-presigner\"),\n      ]);\n\n      S3Client = client;\n      S3Storage = storage;\n      S3Presigner = presigner;\n\n      isModuleExists = true;\n    } catch {\n      // Mark as failed if any import fails (usually means packages aren't installed)\n      isModuleExists = false;\n    }\n  })();\n\n  return initializationPromise;\n}\n\nloadS3();\n\n/**\n * Synchronous fallback loader.\n *\n * `loadS3()` above is async and fire-and-forget at module load, so on the\n * very first *synchronous* `CloudDriver` construction the dynamic `import()`\n * microtask has not yet resolved — `isModuleExists` is still `null` even when\n * the SDK is genuinely installed. The constructor's install-check would then\n * throw the misleading \"SDK not installed\" error.\n *\n * This probes the modules synchronously via `require` (the AWS SDK ships\n * CJS-compatible builds) so a present SDK resolves the install-check\n * immediately, without waiting on the async path. Returns `true` when all\n * three modules loaded, `false` otherwise. Only invoked while\n * `isModuleExists` is still indeterminate.\n */\nfunction loadS3Sync(): boolean {\n  if (isModuleExists !== null) {\n    return isModuleExists;\n  }\n\n  try {\n    // `createRequire` gives an ESM-safe synchronous `require` regardless of\n    // whether this module runs as CJS or ESM at runtime.\n    const req = createRequire(import.meta.url);\n    S3Client = req(\"@aws-sdk/client-s3\");\n    S3Storage = req(\"@aws-sdk/lib-storage\");\n    S3Presigner = req(\"@aws-sdk/s3-request-presigner\");\n    isModuleExists = true;\n  } catch {\n    isModuleExists = false;\n  }\n\n  return isModuleExists;\n}\n\n// ============================================================\n// CloudDriver Base Class\n// ============================================================\n\n/**\n * Base abstract class for all S3-compatible cloud storage drivers\n *\n * This class contains all shared logic for S3-compatible storage services\n * including AWS S3, Cloudflare R2, DigitalOcean Spaces, and others.\n *\n * **Important:** S3 SDK packages are lazy-loaded on first use.\n * Users must install them separately:\n * ```\n * npm install @aws-sdk/client-s3 @aws-sdk/lib-storage @aws-sdk/s3-request-presigner\n * ```\n *\n * Subclasses must implement:\n * - `name`: Driver identifier (e.g., \"s3\", \"r2\", \"spaces\")\n * - `url()`: Returns the public URL for a file (provider-specific format)\n */\nexport abstract class CloudDriver<\n  TOptions extends Partial<CloudStorageDriverOptions> = CloudStorageDriverOptions,\n> implements CloudStorageDriverContract {\n  /**\n   * S3-compatible client (lazy-loaded)\n   */\n  protected client!: InstanceType<typeof import(\"@aws-sdk/client-s3\").S3Client>;\n\n  /**\n   * Retry configuration\n   */\n  protected retryConfig: {\n    maxRetries: number;\n    initialDelayMs: number;\n    maxDelayMs: number;\n    backoffMultiplier: number;\n  };\n\n  /**\n   * How object visibility is applied: per-object ACLs (default), bucket\n   * policy (no per-object ACL is sent), or unsupported (\"none\").\n   * Buckets with ACLs disabled (S3 BucketOwnerEnforced, R2) need\n   * \"policy\" or \"none\".\n   */\n  protected get visibilityMode(): \"acl\" | \"policy\" | \"none\" {\n    return (this.options as { visibilityMode?: \"acl\" | \"policy\" | \"none\" }).visibilityMode ?? \"acl\";\n  }\n\n  /**\n   * Resolve the ACL to send on a put for the requested visibility.\n   *\n   * @throws {StorageCapabilityError} When public is requested but the driver has no visibility support\n   */\n  protected resolveAcl(visibility?: FileVisibility): \"public-read\" | undefined {\n    if (visibility !== \"public\") return undefined;\n\n    if (this.visibilityMode === \"none\") {\n      throw new StorageCapabilityError(\"public visibility\", this.name);\n    }\n\n    return this.visibilityMode === \"acl\" ? \"public-read\" : undefined;\n  }\n\n  public constructor(public options: TOptions) {\n    // The async loadS3() may not have resolved yet on the first synchronous\n    // construction. When the flag is still indeterminate, probe synchronously\n    // so a genuinely-installed SDK never triggers the misleading throw below.\n    if (isModuleExists === null) {\n      loadS3Sync();\n    }\n\n    if (!isModuleExists) {\n      throw new Error(S3_INSTALL_INSTRUCTIONS);\n    }\n\n    // Any remaining option is an S3ClientConfig option (forcePathStyle,\n    // requestHandler, maxAttempts, ...) and is passed through to the SDK.\n    const {\n      bucket: _bucket,\n      accessKeyId,\n      secretAccessKey,\n      endpoint: _endpoint,\n      prefix: _prefix,\n      urlPrefix: _urlPrefix,\n      retry: _retry,\n      accountId: _accountId,\n      publicDomain: _publicDomain,\n      driver: _driver,\n      visibilityMode: _visibilityMode,\n      ...clientOptions\n    } = this.options as TOptions & Record<string, unknown>;\n\n    this.client = new S3Client.S3Client({\n      ...clientOptions,\n      region: this.options.region!,\n      // Without static keys the SDK default provider chain applies\n      // (IAM role, ECS task role, IRSA, SSO profile).\n      ...(accessKeyId && secretAccessKey && { credentials: { accessKeyId, secretAccessKey } }),\n      ...(this.getEndpoint() && { endpoint: this.getEndpoint() }),\n    } as import(\"@aws-sdk/client-s3\").S3ClientConfig);\n\n    // Initialize retry configuration\n    this.retryConfig = {\n      maxRetries: this.options.retry?.maxRetries ?? 3,\n      initialDelayMs: this.options.retry?.initialDelayMs ?? 1000,\n      maxDelayMs: this.options.retry?.maxDelayMs ?? 10000,\n      backoffMultiplier: this.options.retry?.backoffMultiplier ?? 2,\n    };\n  }\n\n  /**\n   * Driver name identifier\n   */\n  public abstract readonly name: StorageDriverType;\n\n  /**\n   * Get public URL for file\n   * Must be implemented by subclasses with provider-specific format\n   */\n  public abstract url(location: string): string;\n\n  /**\n   * Get endpoint URL\n   * Can be overridden by subclasses for provider-specific endpoints\n   */\n  protected getEndpoint(): string | undefined {\n    return this.options.endpoint;\n  }\n\n  // ============================================================\n  // Helper Methods\n  // ============================================================\n\n  /**\n   * Apply prefix to location path\n   *\n   * Priority: context prefix > driver options prefix > no prefix\n   * This allows multi-tenant scenarios where context overrides driver config.\n   *\n   * @param location - Original location path\n   * @returns Location with prefix applied if one exists\n   */\n  public applyPrefix(location: string): string {\n    // Check context prefix first (highest priority)\n    const contextPrefix = storageDriverContext.getPrefix();\n    const prefix = contextPrefix || this.options.prefix;\n\n    if (!prefix) {\n      return location;\n    }\n\n    const cleanPrefix = prefix.replace(/\\/+$/, \"\");\n    const cleanLocation = location.replace(/^\\/+/, \"\");\n\n    // Avoid double-prefixing\n    if (cleanLocation.startsWith(cleanPrefix + \"/\") || cleanLocation === cleanPrefix) {\n      return cleanLocation;\n    }\n\n    return `${cleanPrefix}/${cleanLocation}`;\n  }\n\n  /**\n   * Normalize storage path (remove double slashes, sanitize)\n   * @internal\n   */\n  protected normalizePath(path: string): string {\n    return path\n      .replace(/\\/+/g, \"/\") // Remove multiple slashes\n      .replace(/^\\//, \"\") // Remove leading slash\n      .trim();\n  }\n\n  /**\n   * Execute an operation with retry logic\n   *\n   * Retries on transient errors with exponential backoff.\n   *\n   * @param operation - Async operation to execute\n   * @param operationName - Name for logging\n   * @returns Result of the operation\n   * @internal\n   */\n  protected async withRetry<T>(\n    operation: () => Promise<T>,\n    operationName: string = \"operation\",\n  ): Promise<T> {\n    const { maxRetries, initialDelayMs, backoffMultiplier, maxDelayMs } = this.retryConfig;\n\n    let lastError: unknown;\n\n    // maxRetries counts retries, not attempts: 0 means a single attempt\n    const attempts = maxRetries + 1;\n\n    for (let attempt = 0; attempt < attempts; attempt++) {\n      try {\n        return await operation();\n      } catch (error) {\n        lastError = error;\n\n        // Don't retry on the last attempt\n        if (attempt === attempts - 1) {\n          break;\n        }\n\n        // Check if error is retryable\n        if (!this.isRetryableError(error)) {\n          throw error; // Non-retryable error, fail immediately\n        }\n\n        // Calculate delay with exponential backoff\n        const delayMs = Math.min(initialDelayMs * Math.pow(backoffMultiplier, attempt), maxDelayMs);\n\n        // Wait before retrying\n        await new Promise((resolve) => setTimeout(resolve, delayMs));\n      }\n    }\n\n    // Rethrow the original error so name/$metadata survive\n    throw lastError;\n  }\n\n  /**\n   * Check if an error is retryable\n   *\n   * Retries on:\n   * - Network errors\n   * - 5xx server errors\n   * - Rate limiting (429)\n   * - Timeout errors\n   *\n   * Does NOT retry on:\n   * - 4xx client errors (except 429)\n   * - Authentication errors\n   * - Not found errors\n   *\n   * @param error - Error to check\n   * @returns true if error is retryable\n   * @internal\n   */\n  protected isRetryableError(error: any): boolean {\n    // Network errors\n    if (error.code === \"ECONNRESET\" || error.code === \"ETIMEDOUT\" || error.code === \"ENOTFOUND\") {\n      return true;\n    }\n\n    // S3 SDK errors\n    if (error.name === \"NetworkingError\" || error.name === \"TimeoutError\") {\n      return true;\n    }\n\n    // HTTP status codes\n    const statusCode = error.$metadata?.httpStatusCode || error.statusCode;\n    if (statusCode) {\n      // 5xx server errors are retryable\n      if (statusCode >= 500 && statusCode < 600) {\n        return true;\n      }\n\n      // 429 Too Many Requests is retryable\n      if (statusCode === 429) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  // ============================================================\n  // Core File Operations\n  // ============================================================\n\n  /**\n   * Put file to cloud storage\n   */\n  public async put(\n    file: Buffer,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const hash = this.calculateHash(file);\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        Body: file,\n        ContentType: mimeType,\n        CacheControl: options?.cacheControl,\n        ContentDisposition: options?.contentDisposition,\n        Metadata: options?.metadata,\n        ACL: this.resolveAcl(options?.visibility),\n      });\n\n      const result = await this.client.send(command);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: file.length,\n        hash,\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"put\");\n  }\n\n  /**\n   * Atomically put a file only if the key does not exist (S3 conditional\n   * write, `If-None-Match: *`).\n   *\n   * HTTP 412 (PreconditionFailed) and 409 (ConditionalRequestConflict, a\n   * concurrent conditional write in flight) mean \"already exists\" and return\n   * `null`. Every other error throws.\n   */\n  public async putIfAbsent(\n    file: Buffer | string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData | null> {\n    const body = typeof file === \"string\" ? Buffer.from(file) : file;\n\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n\n      location = this.applyPrefix(location);\n\n      const hash = this.calculateHash(body);\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        Body: body,\n        ContentType: mimeType,\n        CacheControl: options?.cacheControl,\n        ContentDisposition: options?.contentDisposition,\n        Metadata: options?.metadata,\n        ACL: this.resolveAcl(options?.visibility),\n        IfNoneMatch: \"*\",\n      });\n\n      let result;\n\n      try {\n        result = await this.client.send(command);\n      } catch (error: any) {\n        const status = error?.$metadata?.httpStatusCode;\n\n        if (\n          status === 412 ||\n          status === 409 ||\n          error?.name === \"PreconditionFailed\" ||\n          error?.name === \"ConditionalRequestConflict\"\n        ) {\n          return null;\n        }\n\n        throw error;\n      }\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: body.length,\n        hash,\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"putIfAbsent\");\n  }\n\n  /**\n   * Put file from a readable stream (for large files)\n   * Uses S3 multipart upload for efficient streaming\n   */\n  public async putStream(\n    stream: Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<CloudStorageFileData> {\n    // Not wrapped in withRetry: a retry would replay an already-consumed\n    // stream, and lib-storage already retries individual parts.\n    {\n      const { Upload } = S3Storage;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const mimeType = options?.mimeType || this.guessMimeType(location);\n\n      const upload = new Upload({\n        client: this.client,\n        params: {\n          Bucket: this.options.bucket,\n          Key: location,\n          Body: stream,\n          ContentType: mimeType,\n          CacheControl: options?.cacheControl,\n          ContentDisposition: options?.contentDisposition,\n          Metadata: options?.metadata,\n          ACL: this.resolveAcl(options?.visibility),\n        },\n      });\n\n      const result = await upload.done();\n\n      // Get file info for size and hash\n      const info = await this.metadata(location);\n\n      return {\n        path: location,\n        url: this.url(location),\n        size: info.size,\n        hash: info.etag?.replace(/\"/g, \"\") || \"\",\n        mimeType,\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.ETag,\n        versionId: result.VersionId,\n      };\n    }\n  }\n\n  /**\n   * Get file contents as Buffer\n   */\n  public async get(location: string): Promise<Buffer> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return Buffer.from(await result.Body.transformToByteArray());\n    }, \"get\");\n  }\n\n  /**\n   * Get file as a readable stream (for large files)\n   */\n  public async getStream(location: string): Promise<Readable> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      if (!result.Body) {\n        throw new Error(`File not found: ${location}`);\n      }\n\n      return result.Body as Readable;\n    }, \"getStream\");\n  }\n\n  /**\n   * Delete a file\n   */\n  public async delete(location: string): Promise<boolean> {\n    return this.withRetry(async () => {\n      const { DeleteObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new DeleteObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n\n      return true;\n    }, \"delete\");\n  }\n\n  /**\n   * Delete multiple files at once (uses batch delete for efficiency)\n   */\n  public async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    if (locations.length === 0) {\n      return [];\n    }\n\n    return this.withRetry(async () => {\n      const { DeleteObjectsCommand } = S3Client;\n\n      // Apply storage prefix to all locations\n      const prefixedLocations = locations.map((loc) => this.applyPrefix(loc));\n\n      const command = new DeleteObjectsCommand({\n        Bucket: this.options.bucket,\n        Delete: {\n          Objects: prefixedLocations.map((Key) => ({ Key })),\n          Quiet: false,\n        },\n      });\n\n      const result = await this.client.send(command);\n      const results: DeleteManyResult[] = [];\n\n      // Process successful deletes\n      for (const deleted of result.Deleted || []) {\n        if (deleted.Key) {\n          results.push({ location: deleted.Key, deleted: true });\n        }\n      }\n\n      // Process errors\n      for (const error of result.Errors || []) {\n        if (error.Key) {\n          results.push({\n            location: error.Key,\n            deleted: false,\n            error: error.Message || \"Unknown error\",\n          });\n        }\n      }\n\n      return results;\n    }, \"deleteMany\");\n  }\n\n  /**\n   * Delete directory (recursively deletes all objects with matching prefix)\n   *\n   * S3/R2 doesn't have true directories - only key prefixes.\n   * This method lists all objects with the prefix and deletes them in batches.\n   *\n   * @param directoryPath - Directory prefix to delete\n   * @returns true when all objects are deleted\n   */\n  public async deleteDirectory(directoryPath: string): Promise<boolean> {\n    const { ListObjectsV2Command, DeleteObjectsCommand } = S3Client;\n\n    // Apply storage prefix\n    directoryPath = this.applyPrefix(directoryPath);\n\n    // Ensure directory path ends with / for proper prefix matching\n    const prefix = directoryPath.endsWith(\"/\") ? directoryPath : `${directoryPath}/`;\n\n    // Drive the loop with the ListObjectsV2 IsTruncated / ContinuationToken\n    // contract rather than guessing termination from page size. Each page\n    // carries its own ContinuationToken so we never re-list page one.\n    let continuationToken: string | undefined;\n\n    do {\n      const listResult = await this.withRetry(\n        () =>\n          this.client.send(\n            new ListObjectsV2Command({\n              Bucket: this.options.bucket,\n              Prefix: prefix,\n              ContinuationToken: continuationToken,\n            }),\n          ),\n        \"deleteDirectory:list\",\n      );\n\n      const keys = (listResult.Contents || [])\n        .map((object) => object.Key)\n        .filter((key): key is string => Boolean(key));\n\n      if (keys.length > 0) {\n        // Delete the raw keys directly — they already carry the full prefix\n        // from the listing, so we bypass deleteMany's applyPrefix step.\n        await this.withRetry(\n          () =>\n            this.client.send(\n              new DeleteObjectsCommand({\n                Bucket: this.options.bucket,\n                Delete: {\n                  Objects: keys.map((Key) => ({ Key })),\n                  Quiet: true,\n                },\n              }),\n            ),\n          \"deleteDirectory:delete\",\n        );\n      }\n\n      continuationToken = listResult.IsTruncated ? listResult.NextContinuationToken : undefined;\n    } while (continuationToken);\n\n    return true;\n  }\n\n  /**\n   * Check if file exists\n   */\n  public async exists(location: string): Promise<boolean> {\n    // No retry for exists - it should be fast and failure means non-existent\n    try {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      await this.client.send(command);\n      return true;\n    } catch (error) {\n      // Only a definite \"not found\" means absent; credential/network/5xx\n      // errors must surface, otherwise `if (!exists) put()` overwrites.\n      const { name, $metadata } = (error ?? {}) as {\n        name?: string;\n        $metadata?: { httpStatusCode?: number };\n      };\n\n      if (name === \"NotFound\" || name === \"NoSuchKey\" || $metadata?.httpStatusCode === 404) {\n        return false;\n      }\n\n      throw error;\n    }\n  }\n\n  // ============================================================\n  // URL Operations\n  // ============================================================\n\n  /**\n   * Get a temporary presigned URL (alias for getPresignedUrl)\n   */\n  public async temporaryUrl(location: string, expiresIn = 3600): Promise<string> {\n    return this.getPresignedUrl(location, { expiresIn });\n  }\n\n  /**\n   * Get presigned URL for downloading\n   */\n  public async getPresignedUrl(location: string, options?: PresignedOptions): Promise<string> {\n    return this.withRetry(async () => {\n      const { GetObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUrl\");\n  }\n\n  /**\n   * Get presigned URL for uploading\n   */\n  public async getPresignedUploadUrl(\n    location: string,\n    options?: PresignedUploadOptions,\n  ): Promise<string> {\n    return this.withRetry(async () => {\n      const { PutObjectCommand } = S3Client;\n      const { getSignedUrl } = S3Presigner;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ContentType: options?.contentType,\n        Metadata: options?.metadata,\n      });\n\n      return getSignedUrl(this.client, command, {\n        expiresIn: options?.expiresIn || 3600,\n      });\n    }, \"getPresignedUploadUrl\");\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file info/metadata without downloading\n   */\n  public async metadata(location: string): Promise<StorageFileInfo> {\n    return this.withRetry(async () => {\n      const { HeadObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n      const name = location.split(\"/\").pop() || \"\";\n\n      return {\n        path: location,\n        name,\n        size: result.ContentLength || 0,\n        isDirectory: false,\n        lastModified: result.LastModified,\n        mimeType: result.ContentType || this.guessMimeType(location),\n        etag: result.ETag,\n        storageClass: result.StorageClass,\n      };\n    }, \"metadata\");\n  }\n\n  /**\n   * Get file size in bytes (shortcut for metadata().size)\n   */\n  public async size(location: string): Promise<number> {\n    const info = await this.metadata(location);\n    return info.size;\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Build a URL-encoded CopySource (\"bucket/key\") as the SDK requires\n   */\n  protected copySource(key: string): string {\n    const encodedKey = key.split(\"/\").map(encodeURIComponent).join(\"/\");\n\n    return `${this.options.bucket}/${encodedKey}`;\n  }\n\n  /**\n   * Copy file to a new location\n   */\n  public async copy(from: string, to: string): Promise<CloudStorageFileData> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand, HeadObjectCommand } = S3Client;\n\n      // CopyObject drops the ACL, so a public source would silently become private\n      const visibility = await this.getVisibility(from).catch(() => \"private\" as const);\n\n      // Apply storage prefix to both paths\n      from = this.applyPrefix(from);\n      to = this.applyPrefix(to);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: this.copySource(from),\n        Key: to,\n        ...(this.visibilityMode === \"acl\" &&\n          visibility === \"public\" && { ACL: \"public-read\" as const }),\n      });\n\n      const result = await this.client.send(command);\n\n      // Get file metadata\n      const headCommand = new HeadObjectCommand({\n        Bucket: this.options.bucket,\n        Key: to,\n      });\n      const headResult = await this.client.send(headCommand);\n\n      return {\n        path: to,\n        url: this.url(to),\n        size: headResult.ContentLength || 0,\n        hash: headResult.ETag?.replace(/\"/g, \"\") || \"\",\n        mimeType: headResult.ContentType || this.guessMimeType(to),\n        driver: this.name,\n        bucket: this.options.bucket!,\n        region: this.options.region!,\n        etag: result.CopyObjectResult?.ETag,\n        versionId: result.VersionId,\n      };\n    }, \"copy\");\n  }\n\n  /**\n   * Move file to a new location\n   */\n  public async move(from: string, to: string): Promise<CloudStorageFileData> {\n    const file = await this.copy(from, to);\n    await this.delete(from);\n    return file;\n  }\n\n  /**\n   * List files in a directory\n   */\n  public async list(directory: string, options?: ListOptions): Promise<StorageFileInfo[]> {\n    return this.withRetry(async () => {\n      const { ListObjectsV2Command } = S3Client;\n\n      // Apply storage prefix\n      directory = this.applyPrefix(directory);\n\n      // A directory prefix must end in \"/\" so \"images\" doesn't match \"images-old/…\"\n      if (directory && directory !== \"/\" && !directory.endsWith(\"/\")) {\n        directory = `${directory}/`;\n      }\n\n      const command = new ListObjectsV2Command({\n        Bucket: this.options.bucket,\n        Prefix: directory,\n        MaxKeys: options?.limit,\n        ContinuationToken: options?.cursor,\n        Delimiter: options?.recursive ? undefined : \"/\",\n      });\n\n      const result = await this.client.send(command);\n      const files: StorageFileInfo[] = [];\n\n      // Add files\n      for (const object of result.Contents || []) {\n        if (!object.Key) continue;\n\n        files.push({\n          path: object.Key,\n          name: object.Key.split(\"/\").pop() || \"\",\n          size: object.Size || 0,\n          isDirectory: false,\n          lastModified: object.LastModified,\n          etag: object.ETag,\n          storageClass: object.StorageClass,\n        });\n      }\n\n      // Add directories\n      for (const prefix of result.CommonPrefixes || []) {\n        if (!prefix.Prefix) continue;\n\n        files.push({\n          path: prefix.Prefix,\n          name: prefix.Prefix.split(\"/\").filter(Boolean).pop() || \"\",\n          size: 0,\n          isDirectory: true,\n        });\n      }\n\n      return files;\n    }, \"list\");\n  }\n\n  // ============================================================\n  // Cloud-Specific Operations\n  // ============================================================\n\n  /**\n   * Get bucket name\n   */\n  public getBucket(): string {\n    return this.options.bucket!;\n  }\n\n  /**\n   * Get region\n   */\n  public getRegion(): string {\n    return this.options.region!;\n  }\n\n  /**\n   * Set storage class (e.g., STANDARD, GLACIER, etc.)\n   */\n  public async setStorageClass(location: string, storageClass: string): Promise<void> {\n    return this.withRetry(async () => {\n      const { CopyObjectCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new CopyObjectCommand({\n        Bucket: this.options.bucket,\n        CopySource: this.copySource(location),\n        Key: location,\n        StorageClass: storageClass as any,\n        MetadataDirective: \"COPY\",\n      });\n\n      await this.client.send(command);\n    }, \"setStorageClass\");\n  }\n\n  /**\n   * Set file visibility (public or private)\n   */\n  public async setVisibility(location: string, visibility: FileVisibility): Promise<void> {\n    if (this.visibilityMode !== \"acl\") {\n      throw new StorageCapabilityError(\"setVisibility\", this.name);\n    }\n\n    return this.withRetry(async () => {\n      const { PutObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new PutObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n        ACL: visibility === \"public\" ? \"public-read\" : \"private\",\n      });\n\n      await this.client.send(command);\n    }, \"setVisibility\");\n  }\n\n  /**\n   * Get file visibility\n   */\n  public async getVisibility(location: string): Promise<FileVisibility> {\n    return this.withRetry(async () => {\n      const { GetObjectAclCommand } = S3Client;\n\n      // Apply storage prefix\n      location = this.applyPrefix(location);\n\n      const command = new GetObjectAclCommand({\n        Bucket: this.options.bucket,\n        Key: location,\n      });\n\n      const result = await this.client.send(command);\n\n      // Check if any grant allows public read\n      const hasPublicRead = result.Grants?.some(\n        (grant) =>\n          grant.Grantee?.URI === \"http://acs.amazonaws.com/groups/global/AllUsers\" &&\n          grant.Permission === \"READ\",\n      );\n\n      return hasPublicRead ? \"public\" : \"private\";\n    }, \"getVisibility\");\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Calculate SHA-256 hash\n   */\n  protected calculateHash(buffer: Buffer): string {\n    return crypto.createHash(\"sha256\").update(new Uint8Array(buffer)).digest(\"hex\");\n  }\n\n  /**\n   * Guess MIME type from file extension\n   */\n  protected guessMimeType(location: string): string {\n    return getMimeType(location);\n  }\n}\n"],"mappings":"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"}

package/esm/storage/drivers/do-spaces-driver.d.mts

@@ -1,6 +1,5 @@
 import { CloudStorageDriverOptions } from "../types.mjs";
 import { CloudDriver } from "./cloud-driver.mjs";
-
 //#region ../../packages/core/src/storage/drivers/do-spaces-driver.d.ts
 /**
  * DigitalOcean Spaces Storage Driver
@@ -24,7 +23,7 @@ import { CloudDriver } from "./cloud-driver.mjs";
  * });
  * ```
  */
-declare class DOSpacesDriver extends CloudDriver<CloudStorageDriverOptions> {
+export declare class DOSpacesDriver extends CloudDriver<CloudStorageDriverOptions> {
   /**
    * Driver name
    */
@@ -50,5 +49,4 @@ declare class DOSpacesDriver extends CloudDriver<CloudStorageDriverOptions> {
   url(location: string): string;
 }
 //#endregion
-export { DOSpacesDriver };
 //# sourceMappingURL=do-spaces-driver.d.mts.map

package/esm/storage/drivers/do-spaces-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"do-spaces-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/do-spaces-driver.ts"],"mappings":";;;;;;AA0BA;;;;;;;;;;;;;;;;;;AAgC6B;;cAhChB,cAAA,SAAuB,WAAA,CAAY,yBAAA;;;;WAI9B,IAAA;;;;;;;cAQG,OAAA,EAAS,yBAAA;;;;;;YAWlB,WAAA;;;;;;EASH,GAAA,CAAI,QAAA;AAAA"}
+{"version":3,"file":"do-spaces-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/do-spaces-driver.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;qBA0Ba,uBAAuB,YAAY;;;;WAI9B;;;;;;;EAQhB,YAAmB,SAAS;;;;;;YAWlB;;;;;;EASH,IAAI"}

package/esm/storage/drivers/local-driver.d.mts

@@ -1,7 +1,7 @@
 import { DeleteManyResult, ListOptions, LocalStorageDriverOptions, PutOptions, StorageDriverContract, StorageDriverType, StorageFileData, StorageFileInfo, TemporaryTokenValidation } from "../types.mjs";
 import { UploadedFile } from "../../http/uploaded-file.mjs";
+import "../../http/index.mjs";
 import { Readable } from "stream";
-
 //#region ../../packages/core/src/storage/drivers/local-driver.d.ts
 /**
  * Local filesystem storage driver
@@ -12,7 +12,7 @@ import { Readable } from "stream";
  * - Batch operations
  * - Signed temporary URLs
  */
-declare class LocalDriver implements StorageDriverContract {
+export declare class LocalDriver implements StorageDriverContract {
   options: LocalStorageDriverOptions;
   /**
    * Driver name
@@ -183,5 +183,4 @@ declare class LocalDriver implements StorageDriverContract {
   protected guessMimeType(location: string): string;
 }
 //#endregion
-export { LocalDriver };
 //# sourceMappingURL=local-driver.d.mts.map

package/esm/storage/drivers/local-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"local-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/local-driver.ts"],"mappings":";;;;;;;;AA6CA;;;;;;cAAa,WAAA,YAAuB,qBAAA;EA0BR,OAAA,EAAS,yBAAA;EAqDvB;;;EAAA,SA3EI,IAAA,EAAM,iBAAA;EA8GV;;;EAAA,UAzGF,IAAA;EA6JE;;;EAAA,UAxJF,SAAA;EA2L0B;;;EAAA,UAtL1B,kBAAA;EAgO4C;;;EAAA,UA3N5C,YAAA;cAEgB,OAAA,GAAS,yBAAA;EAoT4B;;;;;;;;;EA7RxD,WAAA,CAAY,QAAA;EA6e4B;;;EAldlC,GAAA,CACX,IAAA,EAAM,MAAA,YAAkB,YAAA,EACxB,QAAA,UACA,OAAA,GAAU,UAAA,GACT,OAAA,CAAQ,eAAA;EAwjBoB;;;;;;;;EAzhBlB,WAAA,CACX,IAAA,EAAM,MAAA,WACN,QAAA,UACA,OAAA,GAAU,UAAA,GACT,OAAA,CAAQ,eAAA;EAnHuB;;;EAmKrB,SAAA,CACX,MAAA,EAAQ,QAAA,EACR,QAAA,UACA,OAAA,GAAU,UAAA,GACT,OAAA,CAAQ,eAAA;EAnKW;;;EAqMT,GAAA,CAAI,QAAA,WAAmB,OAAA,CAAQ,MAAA;EAjLlC;;;EA8LG,SAAA,CAAU,QAAA,WAAmB,OAAA,CAAQ,QAAA;EArK3C;;;EAkLM,MAAA,CAAO,QAAA,WAAmB,OAAA;EAtJb;;;EAsKb,UAAA,CAAW,SAAA,aAAsB,OAAA,CAAQ,gBAAA;EApKpD;;;;;;;EA8LW,eAAA,CAAgB,aAAA,UAAuB,OAAA;IAAY,SAAA;EAAA,IAAqB,OAAA;EA1J1E;;;;EAAA,UAqLK,oBAAA,CAAqB,SAAA,WAAoB,OAAA;EAlI7C;;;EAiJC,MAAA,CAAO,QAAA,WAAmB,OAAA;EA9G1B;;;EA0HN,GAAA,CAAI,QAAA;EA7GE;;;;;;;EAwHA,YAAA,CAAa,QAAA,UAAkB,SAAA,YAAmB,OAAA;EA3FvC;;;;;;EA6GjB,oBAAA,CAAqB,QAAA,UAAkB,SAAA;EAnFuC;;;;;;EA2GxE,sBAAA,CAAuB,KAAA,WAAgB,OAAA,CAAQ,wBAAA;EArDrD;;;EAiIM,QAAA,CAAS,QAAA,WAAmB,OAAA,CAAQ,eAAA;EAtHL;;;EA6I/B,IAAA,CAAK,QAAA,WAAmB,OAAA;EA3HS;;;EAuIjC,IAAA,CAAK,IAAA,UAAc,EAAA,WAAa,OAAA,CAAQ,eAAA;EA/GO;;;EA0I/C,IAAA,CAAK,IAAA,UAAc,EAAA,WAAa,OAAA,CAAQ,eAAA;EA9DJ;;;EA0FpC,IAAA,CAAK,SAAA,UAAmB,OAAA,GAAU,WAAA,GAAc,OAAA,CAAQ,eAAA;EAvDxD;;;EAuGN,IAAA,CAAK,QAAA;EAvGyC;;;EA8G9C,OAAA;EAnFsC;;;;;EAAA,UAgG7B,kBAAA,CAAmB,YAAA,WAAuB,OAAA;EApEG;;;;;;;EAAA,UAuFnD,eAAA,CAAgB,QAAA;EAAhB;;;EAAA,UAmBM,QAAA,CAAS,IAAA,EAAM,MAAA,YAAkB,YAAA,GAAe,OAAA,CAAQ,MAAA;EAAvB;;;EAAA,UAgBvC,aAAA,CAAc,MAAA,EAAQ,MAAA;EAAtB;;;EAAA,UAOM,QAAA,CAAS,YAAA,WAAuB,OAAA;EAAvB;;;EAAA,UAaf,aAAA,CAAc,QAAA;AAAA"}
+{"version":3,"file":"local-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/local-driver.ts"],"mappings":";;;;;;;;;;;;;;qBA6Ca,uBAAuB;EA0BR,SAAS;;;;WAtBnB,MAAM;;;;YAKZ;;;;YAKA;;;;YAKA;;;;YAKA;EAEV,YAA0B,UAAS;;;;;;;;;;EAuB5B,YAAY;;;;EA2BN,IACX,MAAM,kBAAkB,cACxB,kBACA,UAAU,aACT,QAAQ;;;;;;;;;EA+BE,YACX,MAAM,iBACN,kBACA,UAAU,aACT,QAAQ;;;;EAgDE,UACX,QAAQ,UACR,kBACA,UAAU,aACT,QAAQ;;;;EAkCE,IAAI,mBAAmB,QAAQ;;;;EAa/B,UAAU,mBAAmB,QAAQ;;;;EAarC,OAAO,mBAAmB;;;;EAgB1B,WAAW,sBAAsB,QAAQ;;;;;;;;EA0BzC,gBAAgB,uBAAuB;IAAY;MAAqB;;;;;YA2BrE,qBAAqB,oBAAoB;;;;EAe5C,OAAO,mBAAmB;;;;EAYhC,IAAI;;;;;;;;EAWE,aAAa,kBAAkB,qBAAmB;;;;;;;EAkBxD,qBAAqB,kBAAkB;;;;;;;EAwBjC,uBAAuB,gBAAgB,QAAQ;;;;EA4E/C,SAAS,mBAAmB,QAAQ;;;;EAuBpC,KAAK,mBAAmB;;;;EAYxB,KAAK,cAAc,aAAa,QAAQ;;;;EA2BxC,KAAK,cAAc,aAAa,QAAQ;;;;EA4BxC,KAAK,mBAAmB,UAAU,cAAc,QAAQ;;;;EAgD9D,KAAK;;;;EAOL;;;;;;YAaS,mBAAmB,uBAAuB;;;;;;;;YAmBhD,gBAAgB;;;;YAmBV,SAAS,MAAM,kBAAkB,eAAe,QAAQ;;;;YAgB9D,cAAc,QAAQ;;;;YAOhB,SAAS,uBAAuB;;;;YAatC,cAAc"}

package/esm/storage/drivers/local-driver.mjs

@@ -116,10 +116,12 @@ var LocalDriver = class {
 		const absolutePath = this.getAbsolutePath(location);
 		await ensureDirectoryAsync(dirname(absolutePath));
 		const hasher = crypto.createHash("sha256");
-		await pipeline(stream, new Transform({ transform(chunk, _encoding, callback) {
+		const hashTransform = new Transform({ transform(chunk, _encoding, callback) {
 			hasher.update(chunk);
 			callback(null, chunk);
-		} }), createWriteStream(absolutePath));
+		} });
+		const writeStream = createWriteStream(absolutePath);
+		await pipeline(stream, hashTransform, writeStream);
 		const hash = hasher.digest("hex");
 		const stats = await stat(absolutePath);
 		const mimeType = options?.mimeType || this.guessMimeType(location);
@@ -431,7 +433,10 @@ var LocalDriver = class {
 		const prefixedLocation = this.applyPrefix(location);
 		const resolved = resolveWithinRoot(this.root, prefixedLocation);
 		const prefix = storageDriverContext.getPrefix() || this.options.prefix;
-		if (prefix) resolveWithinRoot(resolveWithinRoot(this.root, prefix.replace(/^[\\/]+|[\\/]+$/g, "")), resolved);
+		if (prefix) {
+			const prefixRoot = resolveWithinRoot(this.root, prefix.replace(/^[\\/]+|[\\/]+$/g, ""));
+			resolveWithinRoot(prefixRoot, resolved);
+		}
 		return resolved;
 	}
 	/**

package/esm/storage/drivers/local-driver.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"local-driver.mjs","names":["fsPromises"],"sources":["../../../../../../../../../packages/core/src/storage/drivers/local-driver.ts"],"sourcesContent":["import {\n  directoryExistsAsync,\n  ensureDirectoryAsync,\n  fileExistsAsync,\n  removeDirectoryAsync,\n  unlinkAsync,\n} from \"@warlock.js/fs\";\nimport { ltrim } from \"@mongez/reinforcements\";\nimport crypto from \"crypto\";\nimport { createReadStream, createWriteStream, promises as fsPromises } from \"fs\";\nimport { copyFile, readFile, readdir, rename, stat, unlink, writeFile } from \"fs/promises\";\nimport { basename, dirname, join, resolve } from \"path\";\nimport { Transform, type Readable } from \"stream\";\nimport { pipeline } from \"stream/promises\";\nimport { log } from \"@warlock.js/logger\";\nimport { UploadedFile } from \"../../http\";\nimport { purgeImageVariantsOfFile } from \"../../http/uploads/image-variant-cache\";\nimport { storagePath } from \"../../utils/paths\";\nimport { url } from \"../../utils/urls\";\nimport { storageDriverContext } from \"../context/storage-driver-context\";\nimport { resolveWithinRoot } from \"../utils/contain-path\";\nimport { StorageError } from \"../utils/storage-error\";\nimport type {\n  DeleteManyResult,\n  ListOptions,\n  LocalStorageDriverOptions,\n  PutOptions,\n  StorageDriverContract,\n  StorageDriverType,\n  StorageFileData,\n  StorageFileInfo,\n  TemporaryTokenPayload,\n  TemporaryTokenValidation,\n} from \"../types\";\nimport { getMimeType } from \"../utils/mime\";\n\n/**\n * Local filesystem storage driver\n *\n * Stores files on the local filesystem with support for:\n * - File operations (put, get, delete, copy, move)\n * - Stream operations for large files\n * - Batch operations\n * - Signed temporary URLs\n */\nexport class LocalDriver implements StorageDriverContract {\n  /**\n   * Driver name\n   */\n  public readonly name: StorageDriverType = \"local\";\n\n  /**\n   * Root path for storage\n   */\n  protected root: string;\n\n  /**\n   * URL prefix for file URLs\n   */\n  protected urlPrefix: string = \"\";\n\n  /**\n   * URL prefix for temporary file URLs\n   */\n  protected temporaryUrlPrefix: string;\n\n  /**\n   * Secret key for signing temporary URLs\n   */\n  protected signatureKey?: string;\n\n  public constructor(public options: LocalStorageDriverOptions = {}) {\n    // Resolve the root to an absolute, normalized path up front so the\n    // path-traversal containment check (resolveWithinRoot) has a stable\n    // anchor to compare resolved locations against.\n    this.root = resolve(options.root ?? storagePath());\n    this.urlPrefix = options.urlPrefix ?? \"\";\n    this.temporaryUrlPrefix = options.temporaryUrlPrefix ?? \"/temp-files\";\n    this.signatureKey = options.signatureKey;\n  }\n\n  // ============================================================\n  // Prefix Operations\n  // ============================================================\n\n  /**\n   * Apply prefix to location path\n   *\n   * Priority: context prefix > driver options prefix > no prefix\n   * This allows multi-tenant scenarios where context overrides driver config.\n   *\n   * @param location - Original location path\n   * @returns Location with prefix applied if one exists\n   */\n  public applyPrefix(location: string): string {\n    // Check context prefix first (highest priority)\n    const contextPrefix = storageDriverContext.getPrefix();\n    const prefix = contextPrefix || this.options.prefix;\n\n    if (!prefix) {\n      return location;\n    }\n\n    const cleanPrefix = prefix.replace(/\\/+$/, \"\");\n    const cleanLocation = location.replace(/^\\/+/, \"\");\n\n    // Avoid double-prefixing\n    if (cleanLocation.startsWith(cleanPrefix + \"/\") || cleanLocation === cleanPrefix) {\n      return cleanLocation;\n    }\n\n    return `${cleanPrefix}/${cleanLocation}`;\n  }\n\n  // ============================================================\n  // Core File Operations\n  // ============================================================\n\n  /**\n   * Put file to local storage\n   */\n  public async put(\n    file: Buffer | string | UploadedFile,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFileData> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    await ensureDirectoryAsync(dirname(absolutePath));\n\n    const fileBuffer = await this.toBuffer(file);\n    const hash = this.calculateHash(fileBuffer);\n\n    await writeFile(absolutePath, new Uint8Array(fileBuffer));\n\n    const stats = await stat(absolutePath);\n    const mimeType = options?.mimeType || this.guessMimeType(location);\n\n    return {\n      path: this.applyPrefix(location),\n      url: this.url(location),\n      size: stats.size,\n      hash,\n      mimeType,\n      driver: this.name,\n    };\n  }\n\n  /**\n   * Atomically put a file only if nothing exists at `location`.\n   *\n   * Content is written to a temp file in the same directory, then hard-linked\n   * to the target. `link()` fails with EEXIST if the target exists, so exactly\n   * one concurrent caller wins, the object never appears half-written, and the\n   * check is atomic on NFS too. Returns `null` only on EEXIST; other errors throw.\n   */\n  public async putIfAbsent(\n    file: Buffer | string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFileData | null> {\n    const absolutePath = this.getAbsolutePath(location);\n    const directory = dirname(absolutePath);\n\n    await ensureDirectoryAsync(directory);\n\n    // Unlike put(), a string here is CONTENT, never a source path (matches\n    // the cloud driver): the objects this protects are small JSON bodies.\n    const fileBuffer = typeof file === \"string\" ? Buffer.from(file) : file;\n    const hash = this.calculateHash(fileBuffer);\n\n    const tempPath = join(\n      directory,\n      `.${basename(absolutePath)}.${crypto.randomBytes(8).toString(\"hex\")}.tmp`,\n    );\n\n    try {\n      await writeFile(tempPath, new Uint8Array(fileBuffer));\n\n      try {\n        await fsPromises.link(tempPath, absolutePath);\n      } catch (error: any) {\n        if (error?.code === \"EEXIST\") {\n          return null;\n        }\n\n        throw error;\n      }\n    } finally {\n      await unlink(tempPath).catch(() => undefined);\n    }\n\n    const stats = await stat(absolutePath);\n    const mimeType = options?.mimeType || this.guessMimeType(location);\n\n    return {\n      path: this.applyPrefix(location),\n      url: this.url(location),\n      size: stats.size,\n      hash,\n      mimeType,\n      driver: this.name,\n    };\n  }\n\n  /**\n   * Put file from a readable stream (for large files)\n   */\n  public async putStream(\n    stream: Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFileData> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    await ensureDirectoryAsync(dirname(absolutePath));\n\n    // Hash while streaming so large files are never read back into memory\n    const hasher = crypto.createHash(\"sha256\");\n    const hashTransform = new Transform({\n      transform(chunk, _encoding, callback) {\n        hasher.update(chunk);\n        callback(null, chunk);\n      },\n    });\n\n    const writeStream = createWriteStream(absolutePath);\n    await pipeline(stream, hashTransform, writeStream);\n\n    const hash = hasher.digest(\"hex\");\n    const stats = await stat(absolutePath);\n    const mimeType = options?.mimeType || this.guessMimeType(location);\n\n    return {\n      path: this.applyPrefix(location),\n      url: this.url(location),\n      size: stats.size,\n      hash,\n      mimeType,\n      driver: this.name,\n    };\n  }\n\n  /**\n   * Get file contents as Buffer\n   */\n  public async get(location: string): Promise<Buffer> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    if (!(await fileExistsAsync(absolutePath))) {\n      throw new Error(`File not found: ${location}`);\n    }\n\n    return readFile(absolutePath);\n  }\n\n  /**\n   * Get file as a readable stream (for large files)\n   */\n  public async getStream(location: string): Promise<Readable> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    if (!(await fileExistsAsync(absolutePath))) {\n      throw new Error(`File not found: ${location}`);\n    }\n\n    return createReadStream(absolutePath);\n  }\n\n  /**\n   * Delete a file\n   */\n  public async delete(location: string): Promise<boolean> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    if (!(await fileExistsAsync(absolutePath))) {\n      return false;\n    }\n\n    await unlinkAsync(absolutePath);\n    await this.purgeImageVariants(absolutePath);\n\n    return true;\n  }\n\n  /**\n   * Delete multiple files at once\n   */\n  public async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    const results: DeleteManyResult[] = [];\n\n    for (const location of locations) {\n      try {\n        const deleted = await this.delete(location);\n        results.push({ location, deleted });\n      } catch (error) {\n        results.push({\n          location,\n          deleted: false,\n          error: error instanceof Error ? error.message : \"Unknown error\",\n        });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Delete directory\n   *\n   * The directory path is resolved through {@link getAbsolutePath} so it is\n   * contained within the storage root — the raw, caller-supplied argument is\n   * never handed to the filesystem (preventing `../` traversal deletes).\n   */\n  public async deleteDirectory(directoryPath: string, options?: { allowRoot?: boolean }) {\n    const absolutePath = this.getAbsolutePath(directoryPath);\n\n    if (!options?.allowRoot && resolve(absolutePath) === this.root) {\n      throw new StorageError(\n        `Refusing to delete the storage root (\"${directoryPath}\"). Pass { allowRoot: true } to confirm.`,\n        { context: { directoryPath } },\n      );\n    }\n\n    // Listed before the delete: once the directory is gone there is nothing\n    // left to tell which files had cached image derivatives.\n    const files = await this.listFilesRecursively(absolutePath);\n\n    await removeDirectoryAsync(absolutePath);\n\n    for (const file of files) {\n      await this.purgeImageVariants(file);\n    }\n\n    return true;\n  }\n\n  /**\n   * Every file under `directory`, as absolute paths; empty when it cannot be\n   * read. Used to purge the image derivatives of a deleted directory's files.\n   */\n  protected async listFilesRecursively(directory: string): Promise<string[]> {\n    try {\n      const entries = await readdir(directory, { recursive: true, withFileTypes: true });\n\n      return entries\n        .filter((entry) => entry.isFile())\n        .map((entry) => join(entry.parentPath, entry.name));\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Check if file exists\n   */\n  public async exists(location: string): Promise<boolean> {\n    const absolutePath = this.getAbsolutePath(location);\n    return Boolean(await fileExistsAsync(absolutePath));\n  }\n\n  // ============================================================\n  // URL Operations\n  // ============================================================\n\n  /**\n   * Get public URL for file\n   */\n  public url(location: string): string {\n    return url(this.urlPrefix + \"/\" + ltrim(this.applyPrefix(location), \"/\"));\n  }\n\n  /**\n   * Get a temporary signed URL that expires\n   * Returns a clean URL with encoded token: {temporaryUrlPrefix}/{token}\n   *\n   * @param location - File path\n   * @param expiresIn - Seconds until expiration (default: 3600)\n   */\n  public async temporaryUrl(location: string, expiresIn = 3600): Promise<string> {\n    if (!this.signatureKey) {\n      throw new Error(\n        \"Temporary URLs require a signatureKey in LocalDriver options. \" +\n          \"Configure storage.drivers.local.signatureKey in your config.\",\n      );\n    }\n\n    const token = this.encodeTemporaryToken(location, expiresIn);\n    return `${this.temporaryUrlPrefix}/${token}`;\n  }\n\n  /**\n   * Encode a temporary token containing path, expiry, and signature\n   *\n   * @param location - File path\n   * @param expiresIn - Seconds until expiration\n   */\n  public encodeTemporaryToken(location: string, expiresIn: number): string {\n    if (!this.signatureKey) {\n      throw new Error(\"Temporary tokens require a signatureKey\");\n    }\n\n    const exp = Math.floor(Date.now() / 1000) + expiresIn;\n    const sig = crypto\n      .createHmac(\"sha256\", this.signatureKey)\n      .update(`${location}:${exp}`)\n      .digest(\"hex\");\n\n    const payload: TemporaryTokenPayload = { path: location, exp, sig };\n    const json = JSON.stringify(payload);\n\n    // Use base64url encoding (URL-safe base64)\n    return Buffer.from(json).toString(\"base64url\");\n  }\n\n  /**\n   * Validate a temporary URL token\n   * Returns a result object with validation status, file info, and convenience methods\n   *\n   * @param token - The token from the URL\n   */\n  public async validateTemporaryToken(token: string): Promise<TemporaryTokenValidation> {\n    // Check signature key\n    if (!this.signatureKey) {\n      return { valid: false, error: \"missing_key\" };\n    }\n\n    // Decode token\n    let payload: TemporaryTokenPayload;\n    try {\n      const json = Buffer.from(token, \"base64url\").toString(\"utf-8\");\n      payload = JSON.parse(json);\n    } catch {\n      return { valid: false, error: \"invalid_token\" };\n    }\n\n    // Validate payload structure\n    if (!payload.path || !payload.exp || !payload.sig) {\n      return { valid: false, error: \"invalid_token\" };\n    }\n\n    // Check expiration\n    const now = Math.floor(Date.now() / 1000);\n    if (payload.exp < now) {\n      return { valid: false, error: \"expired\" };\n    }\n\n    // Verify signature\n    const expectedSig = crypto\n      .createHmac(\"sha256\", this.signatureKey)\n      .update(`${payload.path}:${payload.exp}`)\n      .digest(\"hex\");\n\n    const sigBuffer = Buffer.from(payload.sig, \"hex\");\n    const expectedBuffer = Buffer.from(expectedSig, \"hex\");\n\n    if (sigBuffer.length !== expectedBuffer.length) {\n      return { valid: false, error: \"invalid_signature\" };\n    }\n\n    const isValidSig = crypto.timingSafeEqual(\n      new Uint8Array(sigBuffer),\n      new Uint8Array(expectedBuffer),\n    );\n\n    if (!isValidSig) {\n      return { valid: false, error: \"invalid_signature\" };\n    }\n\n    // Check file exists\n    const absolutePath = this.getAbsolutePath(payload.path);\n    if (!(await fileExistsAsync(absolutePath))) {\n      return { valid: false, error: \"file_not_found\" };\n    }\n\n    // Build successful result with convenience methods\n    const result: TemporaryTokenValidation = {\n      valid: true,\n      path: payload.path,\n      absolutePath,\n      expiresAt: new Date(payload.exp * 1000),\n      mimeType: this.guessMimeType(payload.path),\n      driver: this,\n      getFile: () => this.get(payload.path),\n      getStream: () => this.getStream(payload.path),\n    };\n\n    return result;\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file info/metadata without downloading\n   */\n  public async metadata(location: string): Promise<StorageFileInfo> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    if (!(await fileExistsAsync(absolutePath))) {\n      throw new Error(`File not found: ${absolutePath}`);\n    }\n\n    const stats = await stat(absolutePath);\n    const name = location.split(\"/\").pop() || \"\";\n\n    return {\n      path: location,\n      name,\n      size: stats.size,\n      isDirectory: stats.isDirectory(),\n      lastModified: stats.mtime,\n      mimeType: this.guessMimeType(location),\n    };\n  }\n\n  /**\n   * Get file size in bytes (shortcut for metadata().size)\n   */\n  public async size(location: string): Promise<number> {\n    const metadata = await this.metadata(location);\n    return metadata.size;\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Copy file to a new location\n   */\n  public async copy(from: string, to: string): Promise<StorageFileData> {\n    const fromPath = this.getAbsolutePath(from);\n    const toPath = this.getAbsolutePath(to);\n\n    if (!(await fileExistsAsync(fromPath))) {\n      throw new Error(`Source file not found: ${from}`);\n    }\n\n    await ensureDirectoryAsync(dirname(toPath));\n    await copyFile(fromPath, toPath);\n\n    const hash = await this.hashFile(toPath);\n    const stats = await stat(toPath);\n\n    return {\n      path: this.applyPrefix(to),\n      url: this.url(to),\n      size: stats.size,\n      hash,\n      mimeType: this.guessMimeType(to),\n      driver: this.name,\n    };\n  }\n\n  /**\n   * Move file to a new location\n   */\n  public async move(from: string, to: string): Promise<StorageFileData> {\n    const fromPath = this.getAbsolutePath(from);\n    const toPath = this.getAbsolutePath(to);\n\n    if (!(await fileExistsAsync(fromPath))) {\n      throw new Error(`Source file not found: ${from}`);\n    }\n\n    await ensureDirectoryAsync(dirname(toPath));\n    await rename(fromPath, toPath);\n    await this.purgeImageVariants(fromPath);\n\n    const hash = await this.hashFile(toPath);\n    const stats = await stat(toPath);\n\n    return {\n      path: this.applyPrefix(to),\n      url: this.url(to),\n      size: stats.size,\n      hash,\n      mimeType: this.guessMimeType(to),\n      driver: this.name,\n    };\n  }\n\n  /**\n   * List files in a directory\n   */\n  public async list(directory: string, options?: ListOptions): Promise<StorageFileInfo[]> {\n    const absolutePath = this.getAbsolutePath(directory);\n    const files: StorageFileInfo[] = [];\n\n    // A listing target is a DIRECTORY, so guard with `directoryExistsAsync`.\n    // `fileExistsAsync` resolves `false` for a folder, which would make `list`\n    // always return [] for a real, populated directory.\n    if (!(await directoryExistsAsync(absolutePath))) {\n      return files;\n    }\n\n    const entries = await readdir(absolutePath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const entryPath = join(directory, entry.name);\n      const entryStats = await stat(this.getAbsolutePath(entryPath));\n\n      files.push({\n        path: entryPath,\n        name: entry.name,\n        size: entryStats.size,\n        isDirectory: entry.isDirectory(),\n        lastModified: entryStats.mtime,\n        mimeType: entry.isFile() ? this.guessMimeType(entry.name) : undefined,\n      });\n\n      // Recursively list subdirectories if requested\n      if (options?.recursive && entry.isDirectory()) {\n        const subFiles = await this.list(entryPath, options);\n        files.push(...subFiles);\n      }\n\n      // Respect limit\n      if (options?.limit && files.length >= options.limit) {\n        break;\n      }\n    }\n\n    return files;\n  }\n\n  // ============================================================\n  // Path Operations\n  // ============================================================\n\n  /**\n   * Get absolute filesystem path for a location\n   */\n  public path(location: string): string {\n    return this.getAbsolutePath(location);\n  }\n\n  /**\n   * Get the storage root directory\n   */\n  public getRoot(): string {\n    return this.root;\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Remove the cached image derivatives of a file that was just deleted or\n   * moved away. Best effort: the file operation has already succeeded, so a\n   * cache that cannot be cleared is logged, never thrown.\n   */\n  protected async purgeImageVariants(absolutePath: string): Promise<void> {\n    try {\n      await purgeImageVariantsOfFile(this.root, absolutePath);\n    } catch (error) {\n      log.warn(\n        \"storage.local\",\n        \"purge-image-variants\",\n        `Could not remove cached image variants: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  }\n\n  /**\n   * Get absolute file path\n   *\n   * Routes through {@link resolveWithinRoot} so a location can never escape\n   * the configured storage root via `..` traversal, an absolute path, or a\n   * prefix breakout.\n   */\n  protected getAbsolutePath(location: string): string {\n    const prefixedLocation = this.applyPrefix(location);\n    const resolved = resolveWithinRoot(this.root, prefixedLocation);\n\n    // The prefix is a containment boundary too: \"../t2/x\" under prefix \"t1\"\n    // must not land in a sibling tenant's directory.\n    const prefix = storageDriverContext.getPrefix() || this.options.prefix;\n\n    if (prefix) {\n      const prefixRoot = resolveWithinRoot(this.root, prefix.replace(/^[\\\\/]+|[\\\\/]+$/g, \"\"));\n      resolveWithinRoot(prefixRoot, resolved);\n    }\n\n    return resolved;\n  }\n\n  /**\n   * Convert various input types to Buffer\n   */\n  protected async toBuffer(file: Buffer | string | UploadedFile): Promise<Buffer> {\n    if (Buffer.isBuffer(file)) {\n      return file;\n    }\n\n    // A string is always content, never a source path\n    if (typeof file === \"string\") {\n      return Buffer.from(file);\n    }\n\n    return file.buffer();\n  }\n\n  /**\n   * Calculate SHA-256 hash\n   */\n  protected calculateHash(buffer: Buffer): string {\n    return crypto.createHash(\"sha256\").update(new Uint8Array(buffer)).digest(\"hex\");\n  }\n\n  /**\n   * Calculate SHA-256 hash of a file by streaming it (constant memory)\n   */\n  protected async hashFile(absolutePath: string): Promise<string> {\n    const hasher = crypto.createHash(\"sha256\");\n\n    for await (const chunk of createReadStream(absolutePath)) {\n      hasher.update(chunk);\n    }\n\n    return hasher.digest(\"hex\");\n  }\n\n  /**\n   * Guess MIME type from file extension\n   */\n  protected guessMimeType(location: string): string {\n    return getMimeType(location);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"local-driver.mjs","names":["fsPromises"],"sources":["../../../../../../../../../packages/core/src/storage/drivers/local-driver.ts"],"sourcesContent":["import {\n  directoryExistsAsync,\n  ensureDirectoryAsync,\n  fileExistsAsync,\n  removeDirectoryAsync,\n  unlinkAsync,\n} from \"@warlock.js/fs\";\nimport { ltrim } from \"@mongez/reinforcements\";\nimport crypto from \"crypto\";\nimport { createReadStream, createWriteStream, promises as fsPromises } from \"fs\";\nimport { copyFile, readFile, readdir, rename, stat, unlink, writeFile } from \"fs/promises\";\nimport { basename, dirname, join, resolve } from \"path\";\nimport { Transform, type Readable } from \"stream\";\nimport { pipeline } from \"stream/promises\";\nimport { log } from \"@warlock.js/logger\";\nimport { UploadedFile } from \"../../http\";\nimport { purgeImageVariantsOfFile } from \"../../http/uploads/image-variant-cache\";\nimport { storagePath } from \"../../utils/paths\";\nimport { url } from \"../../utils/urls\";\nimport { storageDriverContext } from \"../context/storage-driver-context\";\nimport { resolveWithinRoot } from \"../utils/contain-path\";\nimport { StorageError } from \"../utils/storage-error\";\nimport type {\n  DeleteManyResult,\n  ListOptions,\n  LocalStorageDriverOptions,\n  PutOptions,\n  StorageDriverContract,\n  StorageDriverType,\n  StorageFileData,\n  StorageFileInfo,\n  TemporaryTokenPayload,\n  TemporaryTokenValidation,\n} from \"../types\";\nimport { getMimeType } from \"../utils/mime\";\n\n/**\n * Local filesystem storage driver\n *\n * Stores files on the local filesystem with support for:\n * - File operations (put, get, delete, copy, move)\n * - Stream operations for large files\n * - Batch operations\n * - Signed temporary URLs\n */\nexport class LocalDriver implements StorageDriverContract {\n  /**\n   * Driver name\n   */\n  public readonly name: StorageDriverType = \"local\";\n\n  /**\n   * Root path for storage\n   */\n  protected root: string;\n\n  /**\n   * URL prefix for file URLs\n   */\n  protected urlPrefix: string = \"\";\n\n  /**\n   * URL prefix for temporary file URLs\n   */\n  protected temporaryUrlPrefix: string;\n\n  /**\n   * Secret key for signing temporary URLs\n   */\n  protected signatureKey?: string;\n\n  public constructor(public options: LocalStorageDriverOptions = {}) {\n    // Resolve the root to an absolute, normalized path up front so the\n    // path-traversal containment check (resolveWithinRoot) has a stable\n    // anchor to compare resolved locations against.\n    this.root = resolve(options.root ?? storagePath());\n    this.urlPrefix = options.urlPrefix ?? \"\";\n    this.temporaryUrlPrefix = options.temporaryUrlPrefix ?? \"/temp-files\";\n    this.signatureKey = options.signatureKey;\n  }\n\n  // ============================================================\n  // Prefix Operations\n  // ============================================================\n\n  /**\n   * Apply prefix to location path\n   *\n   * Priority: context prefix > driver options prefix > no prefix\n   * This allows multi-tenant scenarios where context overrides driver config.\n   *\n   * @param location - Original location path\n   * @returns Location with prefix applied if one exists\n   */\n  public applyPrefix(location: string): string {\n    // Check context prefix first (highest priority)\n    const contextPrefix = storageDriverContext.getPrefix();\n    const prefix = contextPrefix || this.options.prefix;\n\n    if (!prefix) {\n      return location;\n    }\n\n    const cleanPrefix = prefix.replace(/\\/+$/, \"\");\n    const cleanLocation = location.replace(/^\\/+/, \"\");\n\n    // Avoid double-prefixing\n    if (cleanLocation.startsWith(cleanPrefix + \"/\") || cleanLocation === cleanPrefix) {\n      return cleanLocation;\n    }\n\n    return `${cleanPrefix}/${cleanLocation}`;\n  }\n\n  // ============================================================\n  // Core File Operations\n  // ============================================================\n\n  /**\n   * Put file to local storage\n   */\n  public async put(\n    file: Buffer | string | UploadedFile,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFileData> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    await ensureDirectoryAsync(dirname(absolutePath));\n\n    const fileBuffer = await this.toBuffer(file);\n    const hash = this.calculateHash(fileBuffer);\n\n    await writeFile(absolutePath, new Uint8Array(fileBuffer));\n\n    const stats = await stat(absolutePath);\n    const mimeType = options?.mimeType || this.guessMimeType(location);\n\n    return {\n      path: this.applyPrefix(location),\n      url: this.url(location),\n      size: stats.size,\n      hash,\n      mimeType,\n      driver: this.name,\n    };\n  }\n\n  /**\n   * Atomically put a file only if nothing exists at `location`.\n   *\n   * Content is written to a temp file in the same directory, then hard-linked\n   * to the target. `link()` fails with EEXIST if the target exists, so exactly\n   * one concurrent caller wins, the object never appears half-written, and the\n   * check is atomic on NFS too. Returns `null` only on EEXIST; other errors throw.\n   */\n  public async putIfAbsent(\n    file: Buffer | string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFileData | null> {\n    const absolutePath = this.getAbsolutePath(location);\n    const directory = dirname(absolutePath);\n\n    await ensureDirectoryAsync(directory);\n\n    // Unlike put(), a string here is CONTENT, never a source path (matches\n    // the cloud driver): the objects this protects are small JSON bodies.\n    const fileBuffer = typeof file === \"string\" ? Buffer.from(file) : file;\n    const hash = this.calculateHash(fileBuffer);\n\n    const tempPath = join(\n      directory,\n      `.${basename(absolutePath)}.${crypto.randomBytes(8).toString(\"hex\")}.tmp`,\n    );\n\n    try {\n      await writeFile(tempPath, new Uint8Array(fileBuffer));\n\n      try {\n        await fsPromises.link(tempPath, absolutePath);\n      } catch (error: any) {\n        if (error?.code === \"EEXIST\") {\n          return null;\n        }\n\n        throw error;\n      }\n    } finally {\n      await unlink(tempPath).catch(() => undefined);\n    }\n\n    const stats = await stat(absolutePath);\n    const mimeType = options?.mimeType || this.guessMimeType(location);\n\n    return {\n      path: this.applyPrefix(location),\n      url: this.url(location),\n      size: stats.size,\n      hash,\n      mimeType,\n      driver: this.name,\n    };\n  }\n\n  /**\n   * Put file from a readable stream (for large files)\n   */\n  public async putStream(\n    stream: Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFileData> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    await ensureDirectoryAsync(dirname(absolutePath));\n\n    // Hash while streaming so large files are never read back into memory\n    const hasher = crypto.createHash(\"sha256\");\n    const hashTransform = new Transform({\n      transform(chunk, _encoding, callback) {\n        hasher.update(chunk);\n        callback(null, chunk);\n      },\n    });\n\n    const writeStream = createWriteStream(absolutePath);\n    await pipeline(stream, hashTransform, writeStream);\n\n    const hash = hasher.digest(\"hex\");\n    const stats = await stat(absolutePath);\n    const mimeType = options?.mimeType || this.guessMimeType(location);\n\n    return {\n      path: this.applyPrefix(location),\n      url: this.url(location),\n      size: stats.size,\n      hash,\n      mimeType,\n      driver: this.name,\n    };\n  }\n\n  /**\n   * Get file contents as Buffer\n   */\n  public async get(location: string): Promise<Buffer> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    if (!(await fileExistsAsync(absolutePath))) {\n      throw new Error(`File not found: ${location}`);\n    }\n\n    return readFile(absolutePath);\n  }\n\n  /**\n   * Get file as a readable stream (for large files)\n   */\n  public async getStream(location: string): Promise<Readable> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    if (!(await fileExistsAsync(absolutePath))) {\n      throw new Error(`File not found: ${location}`);\n    }\n\n    return createReadStream(absolutePath);\n  }\n\n  /**\n   * Delete a file\n   */\n  public async delete(location: string): Promise<boolean> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    if (!(await fileExistsAsync(absolutePath))) {\n      return false;\n    }\n\n    await unlinkAsync(absolutePath);\n    await this.purgeImageVariants(absolutePath);\n\n    return true;\n  }\n\n  /**\n   * Delete multiple files at once\n   */\n  public async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    const results: DeleteManyResult[] = [];\n\n    for (const location of locations) {\n      try {\n        const deleted = await this.delete(location);\n        results.push({ location, deleted });\n      } catch (error) {\n        results.push({\n          location,\n          deleted: false,\n          error: error instanceof Error ? error.message : \"Unknown error\",\n        });\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Delete directory\n   *\n   * The directory path is resolved through {@link getAbsolutePath} so it is\n   * contained within the storage root — the raw, caller-supplied argument is\n   * never handed to the filesystem (preventing `../` traversal deletes).\n   */\n  public async deleteDirectory(directoryPath: string, options?: { allowRoot?: boolean }) {\n    const absolutePath = this.getAbsolutePath(directoryPath);\n\n    if (!options?.allowRoot && resolve(absolutePath) === this.root) {\n      throw new StorageError(\n        `Refusing to delete the storage root (\"${directoryPath}\"). Pass { allowRoot: true } to confirm.`,\n        { context: { directoryPath } },\n      );\n    }\n\n    // Listed before the delete: once the directory is gone there is nothing\n    // left to tell which files had cached image derivatives.\n    const files = await this.listFilesRecursively(absolutePath);\n\n    await removeDirectoryAsync(absolutePath);\n\n    for (const file of files) {\n      await this.purgeImageVariants(file);\n    }\n\n    return true;\n  }\n\n  /**\n   * Every file under `directory`, as absolute paths; empty when it cannot be\n   * read. Used to purge the image derivatives of a deleted directory's files.\n   */\n  protected async listFilesRecursively(directory: string): Promise<string[]> {\n    try {\n      const entries = await readdir(directory, { recursive: true, withFileTypes: true });\n\n      return entries\n        .filter((entry) => entry.isFile())\n        .map((entry) => join(entry.parentPath, entry.name));\n    } catch {\n      return [];\n    }\n  }\n\n  /**\n   * Check if file exists\n   */\n  public async exists(location: string): Promise<boolean> {\n    const absolutePath = this.getAbsolutePath(location);\n    return Boolean(await fileExistsAsync(absolutePath));\n  }\n\n  // ============================================================\n  // URL Operations\n  // ============================================================\n\n  /**\n   * Get public URL for file\n   */\n  public url(location: string): string {\n    return url(this.urlPrefix + \"/\" + ltrim(this.applyPrefix(location), \"/\"));\n  }\n\n  /**\n   * Get a temporary signed URL that expires\n   * Returns a clean URL with encoded token: {temporaryUrlPrefix}/{token}\n   *\n   * @param location - File path\n   * @param expiresIn - Seconds until expiration (default: 3600)\n   */\n  public async temporaryUrl(location: string, expiresIn = 3600): Promise<string> {\n    if (!this.signatureKey) {\n      throw new Error(\n        \"Temporary URLs require a signatureKey in LocalDriver options. \" +\n          \"Configure storage.drivers.local.signatureKey in your config.\",\n      );\n    }\n\n    const token = this.encodeTemporaryToken(location, expiresIn);\n    return `${this.temporaryUrlPrefix}/${token}`;\n  }\n\n  /**\n   * Encode a temporary token containing path, expiry, and signature\n   *\n   * @param location - File path\n   * @param expiresIn - Seconds until expiration\n   */\n  public encodeTemporaryToken(location: string, expiresIn: number): string {\n    if (!this.signatureKey) {\n      throw new Error(\"Temporary tokens require a signatureKey\");\n    }\n\n    const exp = Math.floor(Date.now() / 1000) + expiresIn;\n    const sig = crypto\n      .createHmac(\"sha256\", this.signatureKey)\n      .update(`${location}:${exp}`)\n      .digest(\"hex\");\n\n    const payload: TemporaryTokenPayload = { path: location, exp, sig };\n    const json = JSON.stringify(payload);\n\n    // Use base64url encoding (URL-safe base64)\n    return Buffer.from(json).toString(\"base64url\");\n  }\n\n  /**\n   * Validate a temporary URL token\n   * Returns a result object with validation status, file info, and convenience methods\n   *\n   * @param token - The token from the URL\n   */\n  public async validateTemporaryToken(token: string): Promise<TemporaryTokenValidation> {\n    // Check signature key\n    if (!this.signatureKey) {\n      return { valid: false, error: \"missing_key\" };\n    }\n\n    // Decode token\n    let payload: TemporaryTokenPayload;\n    try {\n      const json = Buffer.from(token, \"base64url\").toString(\"utf-8\");\n      payload = JSON.parse(json);\n    } catch {\n      return { valid: false, error: \"invalid_token\" };\n    }\n\n    // Validate payload structure\n    if (!payload.path || !payload.exp || !payload.sig) {\n      return { valid: false, error: \"invalid_token\" };\n    }\n\n    // Check expiration\n    const now = Math.floor(Date.now() / 1000);\n    if (payload.exp < now) {\n      return { valid: false, error: \"expired\" };\n    }\n\n    // Verify signature\n    const expectedSig = crypto\n      .createHmac(\"sha256\", this.signatureKey)\n      .update(`${payload.path}:${payload.exp}`)\n      .digest(\"hex\");\n\n    const sigBuffer = Buffer.from(payload.sig, \"hex\");\n    const expectedBuffer = Buffer.from(expectedSig, \"hex\");\n\n    if (sigBuffer.length !== expectedBuffer.length) {\n      return { valid: false, error: \"invalid_signature\" };\n    }\n\n    const isValidSig = crypto.timingSafeEqual(\n      new Uint8Array(sigBuffer),\n      new Uint8Array(expectedBuffer),\n    );\n\n    if (!isValidSig) {\n      return { valid: false, error: \"invalid_signature\" };\n    }\n\n    // Check file exists\n    const absolutePath = this.getAbsolutePath(payload.path);\n    if (!(await fileExistsAsync(absolutePath))) {\n      return { valid: false, error: \"file_not_found\" };\n    }\n\n    // Build successful result with convenience methods\n    const result: TemporaryTokenValidation = {\n      valid: true,\n      path: payload.path,\n      absolutePath,\n      expiresAt: new Date(payload.exp * 1000),\n      mimeType: this.guessMimeType(payload.path),\n      driver: this,\n      getFile: () => this.get(payload.path),\n      getStream: () => this.getStream(payload.path),\n    };\n\n    return result;\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file info/metadata without downloading\n   */\n  public async metadata(location: string): Promise<StorageFileInfo> {\n    const absolutePath = this.getAbsolutePath(location);\n\n    if (!(await fileExistsAsync(absolutePath))) {\n      throw new Error(`File not found: ${absolutePath}`);\n    }\n\n    const stats = await stat(absolutePath);\n    const name = location.split(\"/\").pop() || \"\";\n\n    return {\n      path: location,\n      name,\n      size: stats.size,\n      isDirectory: stats.isDirectory(),\n      lastModified: stats.mtime,\n      mimeType: this.guessMimeType(location),\n    };\n  }\n\n  /**\n   * Get file size in bytes (shortcut for metadata().size)\n   */\n  public async size(location: string): Promise<number> {\n    const metadata = await this.metadata(location);\n    return metadata.size;\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Copy file to a new location\n   */\n  public async copy(from: string, to: string): Promise<StorageFileData> {\n    const fromPath = this.getAbsolutePath(from);\n    const toPath = this.getAbsolutePath(to);\n\n    if (!(await fileExistsAsync(fromPath))) {\n      throw new Error(`Source file not found: ${from}`);\n    }\n\n    await ensureDirectoryAsync(dirname(toPath));\n    await copyFile(fromPath, toPath);\n\n    const hash = await this.hashFile(toPath);\n    const stats = await stat(toPath);\n\n    return {\n      path: this.applyPrefix(to),\n      url: this.url(to),\n      size: stats.size,\n      hash,\n      mimeType: this.guessMimeType(to),\n      driver: this.name,\n    };\n  }\n\n  /**\n   * Move file to a new location\n   */\n  public async move(from: string, to: string): Promise<StorageFileData> {\n    const fromPath = this.getAbsolutePath(from);\n    const toPath = this.getAbsolutePath(to);\n\n    if (!(await fileExistsAsync(fromPath))) {\n      throw new Error(`Source file not found: ${from}`);\n    }\n\n    await ensureDirectoryAsync(dirname(toPath));\n    await rename(fromPath, toPath);\n    await this.purgeImageVariants(fromPath);\n\n    const hash = await this.hashFile(toPath);\n    const stats = await stat(toPath);\n\n    return {\n      path: this.applyPrefix(to),\n      url: this.url(to),\n      size: stats.size,\n      hash,\n      mimeType: this.guessMimeType(to),\n      driver: this.name,\n    };\n  }\n\n  /**\n   * List files in a directory\n   */\n  public async list(directory: string, options?: ListOptions): Promise<StorageFileInfo[]> {\n    const absolutePath = this.getAbsolutePath(directory);\n    const files: StorageFileInfo[] = [];\n\n    // A listing target is a DIRECTORY, so guard with `directoryExistsAsync`.\n    // `fileExistsAsync` resolves `false` for a folder, which would make `list`\n    // always return [] for a real, populated directory.\n    if (!(await directoryExistsAsync(absolutePath))) {\n      return files;\n    }\n\n    const entries = await readdir(absolutePath, { withFileTypes: true });\n\n    for (const entry of entries) {\n      const entryPath = join(directory, entry.name);\n      const entryStats = await stat(this.getAbsolutePath(entryPath));\n\n      files.push({\n        path: entryPath,\n        name: entry.name,\n        size: entryStats.size,\n        isDirectory: entry.isDirectory(),\n        lastModified: entryStats.mtime,\n        mimeType: entry.isFile() ? this.guessMimeType(entry.name) : undefined,\n      });\n\n      // Recursively list subdirectories if requested\n      if (options?.recursive && entry.isDirectory()) {\n        const subFiles = await this.list(entryPath, options);\n        files.push(...subFiles);\n      }\n\n      // Respect limit\n      if (options?.limit && files.length >= options.limit) {\n        break;\n      }\n    }\n\n    return files;\n  }\n\n  // ============================================================\n  // Path Operations\n  // ============================================================\n\n  /**\n   * Get absolute filesystem path for a location\n   */\n  public path(location: string): string {\n    return this.getAbsolutePath(location);\n  }\n\n  /**\n   * Get the storage root directory\n   */\n  public getRoot(): string {\n    return this.root;\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Remove the cached image derivatives of a file that was just deleted or\n   * moved away. Best effort: the file operation has already succeeded, so a\n   * cache that cannot be cleared is logged, never thrown.\n   */\n  protected async purgeImageVariants(absolutePath: string): Promise<void> {\n    try {\n      await purgeImageVariantsOfFile(this.root, absolutePath);\n    } catch (error) {\n      log.warn(\n        \"storage.local\",\n        \"purge-image-variants\",\n        `Could not remove cached image variants: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  }\n\n  /**\n   * Get absolute file path\n   *\n   * Routes through {@link resolveWithinRoot} so a location can never escape\n   * the configured storage root via `..` traversal, an absolute path, or a\n   * prefix breakout.\n   */\n  protected getAbsolutePath(location: string): string {\n    const prefixedLocation = this.applyPrefix(location);\n    const resolved = resolveWithinRoot(this.root, prefixedLocation);\n\n    // The prefix is a containment boundary too: \"../t2/x\" under prefix \"t1\"\n    // must not land in a sibling tenant's directory.\n    const prefix = storageDriverContext.getPrefix() || this.options.prefix;\n\n    if (prefix) {\n      const prefixRoot = resolveWithinRoot(this.root, prefix.replace(/^[\\\\/]+|[\\\\/]+$/g, \"\"));\n      resolveWithinRoot(prefixRoot, resolved);\n    }\n\n    return resolved;\n  }\n\n  /**\n   * Convert various input types to Buffer\n   */\n  protected async toBuffer(file: Buffer | string | UploadedFile): Promise<Buffer> {\n    if (Buffer.isBuffer(file)) {\n      return file;\n    }\n\n    // A string is always content, never a source path\n    if (typeof file === \"string\") {\n      return Buffer.from(file);\n    }\n\n    return file.buffer();\n  }\n\n  /**\n   * Calculate SHA-256 hash\n   */\n  protected calculateHash(buffer: Buffer): string {\n    return crypto.createHash(\"sha256\").update(new Uint8Array(buffer)).digest(\"hex\");\n  }\n\n  /**\n   * Calculate SHA-256 hash of a file by streaming it (constant memory)\n   */\n  protected async hashFile(absolutePath: string): Promise<string> {\n    const hasher = crypto.createHash(\"sha256\");\n\n    for await (const chunk of createReadStream(absolutePath)) {\n      hasher.update(chunk);\n    }\n\n    return hasher.digest(\"hex\");\n  }\n\n  /**\n   * Guess MIME type from file extension\n   */\n  protected guessMimeType(location: string): string {\n    return getMimeType(location);\n  }\n}\n"],"mappings":"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"}

package/esm/storage/drivers/r2-driver.d.mts

@@ -1,6 +1,5 @@
 import { R2StorageDriverOptions } from "../types.mjs";
 import { CloudDriver } from "./cloud-driver.mjs";
-
 //#region ../../packages/core/src/storage/drivers/r2-driver.d.ts
 /**
  * Cloudflare R2 Storage Driver
@@ -24,7 +23,7 @@ import { CloudDriver } from "./cloud-driver.mjs";
  * });
  * ```
  */
-declare class R2Driver extends CloudDriver<R2StorageDriverOptions> {
+export declare class R2Driver extends CloudDriver<R2StorageDriverOptions> {
   /**
    * Driver name
    */
@@ -47,5 +46,4 @@ declare class R2Driver extends CloudDriver<R2StorageDriverOptions> {
   url(location: string): string;
 }
 //#endregion
-export { R2Driver };
 //# sourceMappingURL=r2-driver.d.mts.map

package/esm/storage/drivers/r2-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"r2-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/r2-driver.ts"],"mappings":";;;;;;AA0BA;;;;;;;;;;;AAwB6B;;;;;;;;;cAxBhB,QAAA,SAAiB,WAAW,CAAC,sBAAA;;;;WAIxB,IAAA;;;;;;YAON,WAAA;;;;;;;;;;EAaH,GAAA,CAAI,QAAA;AAAA"}
+{"version":3,"file":"r2-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/r2-driver.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;qBA0Ba,iBAAiB,YAAY;;;;WAIxB;;;;;;YAON;;;;;;;;;;EAaH,IAAI"}

package/esm/storage/drivers/s3-driver.d.mts

@@ -1,6 +1,5 @@
 import { CloudStorageDriverOptions } from "../types.mjs";
 import { CloudDriver } from "./cloud-driver.mjs";
-
 //#region ../../packages/core/src/storage/drivers/s3-driver.d.ts
 /**
  * AWS S3 Storage Driver
@@ -17,7 +16,7 @@ import { CloudDriver } from "./cloud-driver.mjs";
  * });
  * ```
  */
-declare class S3Driver extends CloudDriver<CloudStorageDriverOptions> {
+export declare class S3Driver extends CloudDriver<CloudStorageDriverOptions> {
   /**
    * Driver name
    */
@@ -32,5 +31,4 @@ declare class S3Driver extends CloudDriver<CloudStorageDriverOptions> {
   url(location: string): string;
 }
 //#endregion
-export { S3Driver };
 //# sourceMappingURL=s3-driver.d.mts.map

package/esm/storage/drivers/s3-driver.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"s3-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/s3-driver.ts"],"mappings":";;;;;;AAmBA;;;;;;;;;;AAa6B;;;cAbhB,QAAA,SAAiB,WAAW,CAAC,yBAAA;;;;WAIxB,IAAA;;;;;;;;EAST,GAAA,CAAI,QAAA;AAAA"}
+{"version":3,"file":"s3-driver.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/drivers/s3-driver.ts"],"mappings":";;;;;;;;;;;;;;;;;;qBAmBa,iBAAiB,YAAY;;;;WAIxB;;;;;;;;EAST,IAAI"}

package/esm/storage/index.d.mts

@@ -15,4 +15,5 @@ import { CloudDriver, loadS3 } from "./drivers/cloud-driver.mjs";
 import { DOSpacesDriver } from "./drivers/do-spaces-driver.mjs";
 import { LocalDriver } from "./drivers/local-driver.mjs";
 import { R2Driver } from "./drivers/r2-driver.mjs";
-import { S3Driver } from "./drivers/s3-driver.mjs";
+import { S3Driver } from "./drivers/s3-driver.mjs";
+export { CloudDriver, CloudStorageDriverContract, CloudStorageDriverOptions, CloudStorageFileData, DOSpacesDriver, DeleteManyResult, EventSubscription, FileVisibility, ListOptions, LocalDriver, LocalStorageDriverOptions, MimeTypes, PresignedOptions, PresignedUploadOptions, PutDirectoryOptions, PutDirectoryResult, PutFromUrlOptions, PutOptions, R2Driver, R2StorageDriverOptions, S3Driver, SafeFetchOptions, SafeFetchResult, ScopedStorage, ScopedStorageContract, Storage, StorageCapabilityError, StorageConfigurations, StorageCopyEventPayload, StorageDriverConfig, StorageDriverContextStore, StorageDriverContract, StorageDriverName, StorageDriverRegistry, StorageDriverType, StorageError, StorageErrorOptions, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFile, StorageFileData, StorageFileInfo, StorageManagerContract, StorageNotInitializedError, StoragePutEventPayload, TemporaryTokenError, TemporaryTokenPayload, TemporaryTokenValidation, getMimeType, isPrivateOrReservedIp, loadS3, resolveWithinRoot, safeFetchToBuffer, storage, storageConfig, storageConfigurations, storageDriverContext };

package/esm/storage/index.mjs

@@ -16,4 +16,4 @@ import { R2Driver } from "./drivers/r2-driver.mjs";
 import { S3Driver } from "./drivers/s3-driver.mjs";
 import { Storage, storage } from "./storage.mjs";
 
-export {  };
+export { CloudDriver, DOSpacesDriver, LocalDriver, MimeTypes, R2Driver, S3Driver, ScopedStorage, Storage, StorageCapabilityError, StorageError, StorageFile, StorageNotInitializedError, getMimeType, isPrivateOrReservedIp, loadS3, resolveWithinRoot, safeFetchToBuffer, storage, storageConfig, storageConfigurations, storageDriverContext };

package/esm/storage/local-disk-roots.mjs

@@ -1,5 +1,5 @@
 import { storagePath, uploadsPath } from "../utils/paths.mjs";
-import config from "@mongez/config";
+import baseConfig from "@mongez/config";
 
 //#region ../../packages/core/src/storage/local-disk-roots.ts
 let runtimeConfigurations;
@@ -9,7 +9,7 @@ function registerLocalDiskConfigurations(read) {
 }
 /** Configured and runtime-registered local roots, without instantiating any drivers. */
 function configuredLocalDiskRoots() {
-	const configured = config.get("storage.drivers", {});
+	const configured = baseConfig.get("storage.drivers", {});
 	const runtime = runtimeConfigurations?.();
 	const entries = [...Object.values(configured), ...runtime?.values() ?? []];
 	if (!Object.hasOwn(configured, "local") && !runtime?.has("local")) entries.push({

package/esm/storage/local-disk-roots.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"local-disk-roots.mjs","names":[],"sources":["../../../../../../../../packages/core/src/storage/local-disk-roots.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { storagePath, uploadsPath } from \"../utils/paths\";\nimport type { StorageDriverConfig } from \"./types\";\n\nlet runtimeConfigurations: (() => ReadonlyMap<string, StorageDriverConfig>) | undefined;\n\n/** The first manager is the singleton; keep storage out of cache-housekeeping imports. */\nexport function registerLocalDiskConfigurations(\n  read: () => ReadonlyMap<string, StorageDriverConfig>,\n): void {\n  runtimeConfigurations ??= read;\n}\n\n/** Configured and runtime-registered local roots, without instantiating any drivers. */\nexport function configuredLocalDiskRoots(): string[] {\n  const configured = config.get(\"storage.drivers\", {}) as Record<string, StorageDriverConfig>;\n  const runtime = runtimeConfigurations?.();\n  const entries = [...Object.values(configured), ...(runtime?.values() ?? [])];\n  if (!Object.hasOwn(configured, \"local\") && !runtime?.has(\"local\")) {\n    entries.push({ driver: \"local\", root: uploadsPath() });\n  }\n  return entries\n    .filter((entry) => entry.driver === \"local\")\n    .map((entry) => entry.root ?? storagePath());\n}\n"],"mappings":";;;;AAIA,IAAI;;AAGJ,SAAgB,gCACd,MACM;CACN,0BAA0B;AAC5B;;AAGA,SAAgB,2BAAqC;CACnD,MAAM,aAAa,OAAO,IAAI,mBAAmB,CAAC,CAAC;CACnD,MAAM,UAAU,wBAAwB;CACxC,MAAM,UAAU,CAAC,GAAG,OAAO,OAAO,UAAU,GAAG,GAAI,SAAS,OAAO,KAAK,CAAC,CAAE;CAC3E,IAAI,CAAC,OAAO,OAAO,YAAY,OAAO,KAAK,CAAC,SAAS,IAAI,OAAO,GAC9D,QAAQ,KAAK;EAAE,QAAQ;EAAS,MAAM,YAAY;CAAE,CAAC;CAEvD,OAAO,QACJ,QAAQ,UAAU,MAAM,WAAW,OAAO,CAAC,CAC3C,KAAK,UAAU,MAAM,QAAQ,YAAY,CAAC;AAC/C"}
+{"version":3,"file":"local-disk-roots.mjs","names":["config"],"sources":["../../../../../../../../packages/core/src/storage/local-disk-roots.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { storagePath, uploadsPath } from \"../utils/paths\";\nimport type { StorageDriverConfig } from \"./types\";\n\nlet runtimeConfigurations: (() => ReadonlyMap<string, StorageDriverConfig>) | undefined;\n\n/** The first manager is the singleton; keep storage out of cache-housekeeping imports. */\nexport function registerLocalDiskConfigurations(\n  read: () => ReadonlyMap<string, StorageDriverConfig>,\n): void {\n  runtimeConfigurations ??= read;\n}\n\n/** Configured and runtime-registered local roots, without instantiating any drivers. */\nexport function configuredLocalDiskRoots(): string[] {\n  const configured = config.get(\"storage.drivers\", {}) as Record<string, StorageDriverConfig>;\n  const runtime = runtimeConfigurations?.();\n  const entries = [...Object.values(configured), ...(runtime?.values() ?? [])];\n  if (!Object.hasOwn(configured, \"local\") && !runtime?.has(\"local\")) {\n    entries.push({ driver: \"local\", root: uploadsPath() });\n  }\n  return entries\n    .filter((entry) => entry.driver === \"local\")\n    .map((entry) => entry.root ?? storagePath());\n}\n"],"mappings":";;;;AAIA,IAAI;;AAGJ,SAAgB,gCACd,MACM;CACN,0BAA0B;AAC5B;;AAGA,SAAgB,2BAAqC;CACnD,MAAM,aAAaA,WAAO,IAAI,mBAAmB,CAAC,CAAC;CACnD,MAAM,UAAU,wBAAwB;CACxC,MAAM,UAAU,CAAC,GAAG,OAAO,OAAO,UAAU,GAAG,GAAI,SAAS,OAAO,KAAK,CAAC,CAAE;CAC3E,IAAI,CAAC,OAAO,OAAO,YAAY,OAAO,KAAK,CAAC,SAAS,IAAI,OAAO,GAC9D,QAAQ,KAAK;EAAE,QAAQ;EAAS,MAAM,YAAY;CAAE,CAAC;CAEvD,OAAO,QACJ,QAAQ,UAAU,MAAM,WAAW,OAAO,CAAC,CAC3C,KAAK,UAAU,MAAM,QAAQ,YAAY,CAAC;AAC/C"}

package/esm/storage/scoped-storage.d.mts

@@ -1,8 +1,8 @@
 import { StorageFile } from "./storage-file.mjs";
 import { DeleteManyResult, ListOptions, PutDirectoryOptions, PutDirectoryResult, PutFromUrlOptions, PutOptions, ScopedStorageContract, StorageDriverContract, StorageDriverType, StorageFileInfo } from "./types.mjs";
 import { UploadedFile } from "../http/uploaded-file.mjs";
+import "../http/index.mjs";
 import { Readable } from "stream";
-
 //#region ../../packages/core/src/storage/scoped-storage.d.ts
 /**
  * ScopedStorage - Base class for storage operations
@@ -25,7 +25,7 @@ import { Readable } from "stream";
  * await file.copy("backup/photo.jpg");
  * ```
  */
-declare class ScopedStorage implements ScopedStorageContract {
+export declare class ScopedStorage implements ScopedStorageContract {
   /**
    * The underlying storage driver instance
    * @internal
@@ -576,5 +576,4 @@ declare class ScopedStorage implements ScopedStorageContract {
   append(location: string, suffix: string): string;
 }
 //#endregion
-export { ScopedStorage };
 //# sourceMappingURL=scoped-storage.d.mts.map