@warlock.js/core 4.8.1 → 4.9.0

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

@@ -1,7 +1,7 @@
 import { CloudDriver } from "./cloud-driver.mjs";
 import { ltrim } from "@mongez/reinforcements";
 
-//#region ../@warlock.js/core/src/storage/drivers/s3-driver.ts
+//#region ../core/src/storage/drivers/s3-driver.ts
 /**
 * AWS S3 Storage Driver
 *

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

@@ -1 +1 @@
-{"version":3,"file":"s3-driver.mjs","names":[],"sources":["../../../../../../../../@warlock.js/core/src/storage/drivers/s3-driver.ts"],"sourcesContent":["import { ltrim } from \"@mongez/reinforcements\";\nimport type { CloudStorageDriverOptions } from \"../types\";\nimport { CloudDriver } from \"./cloud-driver\";\n\n/**\n * AWS S3 Storage Driver\n *\n * URL Pattern: https://{bucket}.s3.{region}.amazonaws.com/{key}\n *\n * @example\n * ```typescript\n * const driver = new S3Driver({\n *   bucket: \"my-bucket\",\n *   region: \"us-east-1\",\n *   accessKeyId: process.env.AWS_ACCESS_KEY_ID,\n *   secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\n * });\n * ```\n */\nexport class S3Driver extends CloudDriver<CloudStorageDriverOptions> {\n  /**\n   * Driver name\n   */\n  public readonly name = \"s3\";\n\n  /**\n   * Get public URL for file\n   *\n   * URL formats:\n   * - With urlPrefix: {urlPrefix}/{key}\n   * - Default: https://{bucket}.s3.{region}.amazonaws.com/{key}\n   */\n  public url(location: string): string {\n    // 1. Use urlPrefix if configured (e.g. a CDN domain) — return it directly\n    // so the bucket-host URL below is NOT appended (which would yield a\n    // double-host URL like https://bucket.s3.../https://cdn.../key).\n    if (this.options.urlPrefix) {\n      const prefix = this.options.urlPrefix.replace(/\\/+$/, \"\");\n      return `${prefix}/${ltrim(location, \"/\")}`;\n    }\n\n    // 2. Default S3 URL\n    return `https://${this.options.bucket}.s3.${this.options.region}.amazonaws.com/${location}`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,IAAa,WAAb,cAA8B,YAAuC;;;cAI5C;;;;;;;;;CASvB,AAAO,IAAI,UAA0B;EAInC,IAAI,KAAK,QAAQ,WAEf,OAAO,GADQ,KAAK,QAAQ,UAAU,QAAQ,QAAQ,EACvC,EAAE,GAAG,MAAM,UAAU,GAAG;EAIzC,OAAO,WAAW,KAAK,QAAQ,OAAO,MAAM,KAAK,QAAQ,OAAO,iBAAiB;CACnF;AACF"}
+{"version":3,"file":"s3-driver.mjs","names":[],"sources":["../../../../../../../../core/src/storage/drivers/s3-driver.ts"],"sourcesContent":["import { ltrim } from \"@mongez/reinforcements\";\nimport type { CloudStorageDriverOptions } from \"../types\";\nimport { CloudDriver } from \"./cloud-driver\";\n\n/**\n * AWS S3 Storage Driver\n *\n * URL Pattern: https://{bucket}.s3.{region}.amazonaws.com/{key}\n *\n * @example\n * ```typescript\n * const driver = new S3Driver({\n *   bucket: \"my-bucket\",\n *   region: \"us-east-1\",\n *   accessKeyId: process.env.AWS_ACCESS_KEY_ID,\n *   secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,\n * });\n * ```\n */\nexport class S3Driver extends CloudDriver<CloudStorageDriverOptions> {\n  /**\n   * Driver name\n   */\n  public readonly name = \"s3\";\n\n  /**\n   * Get public URL for file\n   *\n   * URL formats:\n   * - With urlPrefix: {urlPrefix}/{key}\n   * - Default: https://{bucket}.s3.{region}.amazonaws.com/{key}\n   */\n  public url(location: string): string {\n    // 1. Use urlPrefix if configured (e.g. a CDN domain) — return it directly\n    // so the bucket-host URL below is NOT appended (which would yield a\n    // double-host URL like https://bucket.s3.../https://cdn.../key).\n    if (this.options.urlPrefix) {\n      const prefix = this.options.urlPrefix.replace(/\\/+$/, \"\");\n      return `${prefix}/${ltrim(location, \"/\")}`;\n    }\n\n    // 2. Default S3 URL\n    return `https://${this.options.bucket}.s3.${this.options.region}.amazonaws.com/${location}`;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,IAAa,WAAb,cAA8B,YAAuC;;;cAI5C;;;;;;;;;CASvB,AAAO,IAAI,UAA0B;EAInC,IAAI,KAAK,QAAQ,WAEf,OAAO,GADQ,KAAK,QAAQ,UAAU,QAAQ,QAAQ,EACvC,EAAE,GAAG,MAAM,UAAU,GAAG;EAIzC,OAAO,WAAW,KAAK,QAAQ,OAAO,MAAM,KAAK,QAAQ,OAAO,iBAAiB;CACnF;AACF"}

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

@@ -3,7 +3,7 @@ import { DeleteManyResult, ListOptions, PutDirectoryOptions, PutDirectoryResult,
 import { UploadedFile } from "../http/uploaded-file.mjs";
 import { Readable } from "stream";
 
-//#region ../@warlock.js/core/src/storage/scoped-storage.d.ts
+//#region ../core/src/storage/scoped-storage.d.ts
 /**
  * ScopedStorage - Base class for storage operations
  *

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

@@ -1 +1 @@
-{"version":3,"file":"scoped-storage.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/scoped-storage.ts"],"mappings":"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"}
+{"version":3,"file":"scoped-storage.d.mts","names":[],"sources":["../../../../../../../core/src/storage/scoped-storage.ts"],"mappings":"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"}

package/esm/storage/scoped-storage.mjs

@@ -5,7 +5,7 @@ import { fileExistsAsync } from "@warlock.js/fs";
 import { createReadStream } from "fs";
 import fs$1 from "fs/promises";
 
-//#region ../@warlock.js/core/src/storage/scoped-storage.ts
+//#region ../core/src/storage/scoped-storage.ts
 /**
 * ScopedStorage - Base class for storage operations
 *

package/esm/storage/scoped-storage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"scoped-storage.mjs","names":["fs"],"sources":["../../../../../../../@warlock.js/core/src/storage/scoped-storage.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { createReadStream } from \"fs\";\nimport fs from \"fs/promises\";\nimport path from \"path\";\nimport type { Readable } from \"stream\";\nimport type { UploadedFile } from \"../http\";\nimport { StorageFile } from \"./storage-file\";\nimport type {\n  DeleteManyResult,\n  ListOptions,\n  PutDirectoryOptions,\n  PutDirectoryResult,\n  PutFromUrlOptions,\n  PutOptions,\n  ScopedStorageContract,\n  StorageDriverContract,\n  StorageDriverType,\n  StorageFileInfo,\n} from \"./types\";\nimport { safeFetchToBuffer } from \"./utils/safe-fetch\";\n\n/**\n * ScopedStorage - Base class for storage operations\n *\n * Wraps a storage driver and provides a consistent, developer-friendly API\n * that returns `StorageFile` instances instead of raw data objects.\n *\n * This class serves as the base for both direct driver usage and the\n * full `Storage` manager class.\n *\n * @example\n * ```typescript\n * // Using via storage.use()\n * const s3Storage = storage.use(\"s3\");\n * const file = await s3Storage.put(buffer, \"images/photo.jpg\");\n *\n * // file is a StorageFile instance with rich API\n * console.log(file.name);       // \"photo.jpg\"\n * console.log(file.url);        // \"https://...\"\n * await file.copy(\"backup/photo.jpg\");\n * ```\n */\nexport class ScopedStorage implements ScopedStorageContract {\n  /**\n   * The underlying storage driver instance\n   * @internal\n   */\n  protected _driver: StorageDriverContract;\n\n  /**\n   * Create a new ScopedStorage instance\n   *\n   * @param driver - The storage driver to wrap\n   */\n  public constructor(driver: StorageDriverContract) {\n    this._driver = driver;\n  }\n\n  // ============================================================\n  // Properties\n  // ============================================================\n\n  /**\n   * Get the driver name\n   *\n   * @returns The name identifier of the underlying driver (e.g., \"local\", \"s3\", \"r2\")\n   */\n  public get name(): StorageDriverType {\n    return this.activeDriver.name;\n  }\n\n  /**\n   * Get the default driver instance\n   *\n   * Use this for advanced operations that require direct driver access.\n   *\n   * @returns The raw storage driver\n   */\n  public get defaultDriver(): StorageDriverContract {\n    return this._driver;\n  }\n\n  /**\n   * Get the currently active driver\n   *\n   * Returns the driver being used for storage operations.\n   * Can be overridden in subclasses for dynamic driver resolution (e.g., multi-tenant contexts).\n   *\n   * @returns The active storage driver\n   */\n  public get activeDriver(): StorageDriverContract {\n    return this._driver;\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Store a file in storage\n   *\n   * Accepts multiple input types and stores the file at the specified location.\n   * Returns a `StorageFile` instance for further operations.\n   *\n   * @param file - File content as Buffer, string path, UploadedFile, or Readable stream\n   * @param location - Destination path in storage (e.g., \"uploads/images/photo.jpg\")\n   * @param options - Optional storage options\n   * @returns StorageFile instance with cached metadata\n   *\n   * @example\n   * ```typescript\n   * // From buffer\n   * const file = await storage.put(buffer, \"documents/report.pdf\");\n   *\n   * // From uploaded file\n   * const file = await storage.put(uploadedFile, \"avatars/user-123.jpg\");\n   *\n   * // With options\n   * const file = await storage.put(buffer, \"images/photo.jpg\", {\n   *   mimeType: \"image/jpeg\",\n   *   cacheControl: \"max-age=31536000\"\n   * });\n   * ```\n   */\n  public async put(\n    file: UploadedFile | Buffer | string | Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    const buffer = await this.toBuffer(file);\n    const data = await this.activeDriver.put(buffer, location, options);\n    return StorageFile.fromData(data, this.activeDriver);\n  }\n\n  /**\n   * Store a file from a readable stream\n   *\n   * Optimized for large files - streams data directly without full buffering.\n   * Ideal for file uploads, remote file fetching, or processing pipelines.\n   *\n   * @param stream - Readable stream of file content\n   * @param location - Destination path in storage\n   * @param options - Optional storage options\n   * @returns StorageFile instance with cached metadata\n   *\n   * @example\n   * ```typescript\n   * import { createReadStream } from \"fs\";\n   *\n   * const stream = createReadStream(\"./large-video.mp4\");\n   * const file = await storage.putStream(stream, \"videos/upload.mp4\");\n   * ```\n   */\n  public async putStream(\n    stream: Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    const data = await this.activeDriver.putStream(stream, location, options);\n    return StorageFile.fromData(data, this.activeDriver);\n  }\n\n  /**\n   * Store a file from a URL\n   *\n   * Downloads the file from the URL and stores it. The download is\n   * SSRF-guarded by default: the URL scheme must be https/http, the host\n   * must not resolve to a private / loopback / link-local / cloud-metadata\n   * address, the body is capped, and the request times out. Tune or relax\n   * via the {@link PutFromUrlOptions} guard fields.\n   *\n   * @param url - URL to download from\n   * @param location - Destination path in storage\n   * @param options - Storage + outbound-download guard options\n   * @returns StorageFile instance\n   *\n   * @example\n   * ```typescript\n   * const file = await storage.putFromUrl(\n   *   \"https://example.com/image.jpg\",\n   *   \"images/downloaded.jpg\"\n   * );\n   * ```\n   */\n  public async putFromUrl(\n    url: string,\n    location: string,\n    options?: PutFromUrlOptions,\n  ): Promise<StorageFile> {\n    const { allowPrivateHosts, maxBytes, timeoutMs, allowedSchemes, ...putOptions } =\n      options ?? {};\n\n    const result = await safeFetchToBuffer(url, {\n      allowPrivateHosts,\n      maxBytes,\n      timeoutMs,\n      allowedSchemes,\n    });\n\n    if (!result.ok) {\n      throw new Error(`Failed to fetch file from ${url}: ${result.statusText}`);\n    }\n\n    if (!result.contentType) {\n      throw new Error(`Failed to fetch file from ${url}: missing content-type header`);\n    }\n\n    const mimeType = putOptions.mimeType || result.contentType;\n\n    return this.put(result.buffer, location, { ...putOptions, mimeType });\n  }\n\n  /**\n   * Store a file from base64 data URL\n   *\n   * @param dataUrl - Data URL (data:image/png;base64,iVBORw0KG...)\n   * @param location - Destination path in storage\n   * @param options - Optional storage options\n   * @returns StorageFile instance\n   *\n   * @example\n   * ```typescript\n   * const file = await storage.putFromBase64(\n   *   \"data:image/png;base64,iVBORw0KGgoAAAANS...\",\n   *   \"images/upload.png\"\n   * );\n   * ```\n   */\n  public async putFromBase64(\n    dataUrl: string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    // Parse data URL: data:image/png;base64,iVBORw0KG...\n    const matches = dataUrl.match(/^data:([^;]+);base64,(.+)$/);\n\n    if (!matches) {\n      throw new Error(\"Invalid base64 data URL format. Expected: data:mime/type;base64,<data>\");\n    }\n\n    const [, mimeType, base64Data] = matches;\n    const buffer = Buffer.from(base64Data, \"base64\");\n\n    return this.put(buffer, location, {\n      ...options,\n      mimeType: options?.mimeType || mimeType,\n    });\n  }\n\n  /**\n   * Retrieve file contents as a Buffer\n   *\n   * Downloads the entire file into memory. For large files,\n   * consider using `getStream()` instead.\n   *\n   * @param location - Path to the file in storage\n   * @returns Buffer containing file contents\n   * @throws Error if file not found\n   *\n   * @example\n   * ```typescript\n   * const buffer = await storage.get(\"documents/report.pdf\");\n   * const content = buffer.toString(\"utf-8\");\n   * ```\n   */\n  public async get(location: string): Promise<Buffer> {\n    return this.activeDriver.get(location);\n  }\n\n  /**\n   * Retrieve file contents as a readable stream\n   *\n   * Streams file data without loading entire file into memory.\n   * Ideal for large files or when piping to a response.\n   *\n   * @param location - Path to the file in storage\n   * @returns Readable stream of file contents\n   * @throws Error if file not found\n   *\n   * @example\n   * ```typescript\n   * const stream = await storage.getStream(\"videos/large.mp4\");\n   * stream.pipe(response.raw);\n   * ```\n   */\n  public async getStream(location: string): Promise<Readable> {\n    return this.activeDriver.getStream(location);\n  }\n\n  /**\n   * Delete a file from storage\n   *\n   * @param location - Path to the file, or a StorageFile instance\n   * @returns `true` if deleted, `false` if file not found\n   *\n   * @example\n   * ```typescript\n   * // By path\n   * await storage.delete(\"temp/old-file.txt\");\n   *\n   * // From StorageFile instance\n   * const file = await storage.put(buffer, \"temp/file.txt\");\n   * await storage.delete(file);\n   * ```\n   */\n  public async delete(location: string | StorageFile): Promise<boolean> {\n    const path = typeof location === \"string\" ? location : location.path;\n    return this.activeDriver.delete(path);\n  }\n\n  /**\n   * Delete multiple files at once\n   *\n   * Performs batch deletion for efficiency. Returns results for each file\n   * including success/failure status.\n   *\n   * @param locations - Array of file paths to delete\n   * @returns Array of delete results with status for each file\n   *\n   * @example\n   * ```typescript\n   * const results = await storage.deleteMany([\n   *   \"temp/file1.txt\",\n   *   \"temp/file2.txt\",\n   *   \"temp/file3.txt\"\n   * ]);\n   *\n   * for (const result of results) {\n   *   console.log(`${result.location}: ${result.deleted ? \"deleted\" : result.error}`);\n   * }\n   * ```\n   */\n  public async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    return this.activeDriver.deleteMany(locations);\n  }\n\n  /**\n   * Delete a directory\n   *\n   * @param directoryPath - Path to the directory\n   */\n  public async deleteDirectory(directoryPath: string): Promise<boolean> {\n    return await this.activeDriver.deleteDirectory(directoryPath);\n  }\n\n  /**\n   * Check if a file exists in storage\n   *\n   * @param location - Path to check\n   * @returns `true` if file exists, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * if (await storage.exists(\"config/settings.json\")) {\n   *   const config = await storage.get(\"config/settings.json\");\n   * }\n   * ```\n   */\n  public async exists(location: string): Promise<boolean> {\n    return this.activeDriver.exists(location);\n  }\n\n  /**\n   * Copy a file to a new location\n   *\n   * Creates a copy of the file at the destination path.\n   * The original file remains unchanged.\n   *\n   * @param from - Source path or StorageFile instance\n   * @param to - Destination path\n   * @returns StorageFile instance at the new location\n   *\n   * @example\n   * ```typescript\n   * // Copy by path\n   * const backup = await storage.copy(\"documents/report.pdf\", \"backups/report.pdf\");\n   *\n   * // Copy from StorageFile\n   * const original = await storage.file(\"documents/report.pdf\");\n   * const backup = await storage.copy(original, \"backups/report.pdf\");\n   * ```\n   */\n  public async copy(from: string | StorageFile, to: string): Promise<StorageFile> {\n    const fromPath = typeof from === \"string\" ? from : from.path;\n    const data = await this.activeDriver.copy(fromPath, to);\n    return StorageFile.fromData(data, this.activeDriver);\n  }\n\n  /**\n   * Move a file to a new location\n   *\n   * Moves the file to the destination path. The original file\n   * is deleted after successful copy.\n   *\n   * @param from - Source path or StorageFile instance\n   * @param to - Destination path\n   * @returns StorageFile instance at the new location\n   *\n   * @example\n   * ```typescript\n   * // Move by path\n   * const file = await storage.move(\"uploads/temp.jpg\", \"images/photo.jpg\");\n   *\n   * // Move from StorageFile\n   * const temp = await storage.file(\"uploads/temp.jpg\");\n   * const final = await storage.move(temp, \"images/photo.jpg\");\n   * ```\n   */\n  public async move(from: string | StorageFile, to: string): Promise<StorageFile> {\n    const fromPath = typeof from === \"string\" ? from : from.path;\n    const data = await this.activeDriver.move(fromPath, to);\n    return StorageFile.fromData(data, this.activeDriver);\n  }\n\n  /**\n   * Copy an entire directory recursively\n   *\n   * Copies all files from the source directory to the destination directory,\n   * preserving the directory structure.\n   *\n   * @param from - Source directory path\n   * @param to - Destination directory path\n   * @param options - Optional concurrency control\n   * @returns Number of files copied\n   *\n   * @example\n   * ```typescript\n   * // Copy entire directory\n   * const count = await storage.copyDirectory(\"uploads/temp\", \"uploads/final\");\n   * console.log(`Copied ${count} files`);\n   *\n   * // With concurrency limit\n   * const count = await storage.copyDirectory(\"large-dir\", \"backup\", {\n   *   concurrency: 10\n   * });\n   * ```\n   */\n  public async copyDirectory(\n    from: string,\n    to: string,\n    options?: { concurrency?: number },\n  ): Promise<number> {\n    const concurrency = options?.concurrency || 5;\n\n    // List all files recursively\n    const files = await this.list(from, { recursive: true });\n    const filesToCopy = files.filter((f) => !f.isDirectory);\n\n    // Copy files in batches for efficiency\n    let copied = 0;\n    for (let i = 0; i < filesToCopy.length; i += concurrency) {\n      const batch = filesToCopy.slice(i, i + concurrency);\n      await Promise.all(\n        batch.map(async (file) => {\n          // Calculate relative path and new destination\n          const relativePath = file.path.substring(from.length).replace(/^\\//, \"\");\n          const newPath = `${to}/${relativePath}`;\n          await this.copy(file.path, newPath);\n          copied++;\n        }),\n      );\n    }\n\n    return copied;\n  }\n\n  /**\n   * Move an entire directory recursively\n   *\n   * Moves all files from the source directory to the destination directory,\n   * then deletes the source directory.\n   *\n   * @param from - Source directory path\n   * @param to - Destination directory path\n   * @param options - Optional concurrency control\n   * @returns Number of files moved\n   *\n   * @example\n   * ```typescript\n   * const count = await storage.moveDirectory(\"uploads/temp\", \"uploads/final\");\n   * console.log(`Moved ${count} files`);\n   * ```\n   */\n  public async moveDirectory(\n    from: string,\n    to: string,\n    options?: { concurrency?: number },\n  ): Promise<number> {\n    // Copy all files first\n    const count = await this.copyDirectory(from, to, options);\n\n    // Delete source directory\n    await this.deleteDirectory(from);\n\n    return count;\n  }\n\n  /**\n   * Upload a local filesystem directory into storage\n   *\n   * Recursively walks the local directory, applies an optional filter, then\n   * streams each file into storage. Uploads run in concurrent batches for\n   * efficiency. Failures are collected — a single failed file never aborts\n   * the entire operation (mirrors the contract of `deleteMany`).\n   *\n   * @param localDirPath  - Absolute path of the local directory to upload\n   * @param destination   - Target prefix in storage (e.g. \"uploads/assets\")\n   * @param options       - Concurrency, filter, progress callback, put options\n   * @returns             - { uploaded, failed, total }\n   *\n   * @example\n   * ```typescript\n   * const result = await storage.putDirectory(\"./public/assets\", \"cdn/assets\", {\n   *   concurrency: 10,\n   *   filter: (_, rel) => !rel.startsWith(\".\"),\n   *   onProgress: (done, total) => console.log(`${done}/${total}`),\n   * });\n   *\n   * console.log(`Uploaded: ${result.uploaded.length}, Failed: ${result.failed.length}`);\n   * ```\n   */\n  public async putDirectory(\n    localDirPath: string,\n    destination: string,\n    options?: PutDirectoryOptions,\n  ): Promise<PutDirectoryResult> {\n    const concurrency = options?.concurrency ?? 5;\n\n    // Collect all local file paths recursively\n    const localFiles = await this.walkLocalDirectory(localDirPath);\n\n    // Apply the user-supplied filter if any\n    const filteredFiles = options?.filter\n      ? localFiles.filter(({ absolute, relative }) => options.filter!(absolute, relative))\n      : localFiles;\n\n    const total = filteredFiles.length;\n    const uploaded: StorageFile[] = [];\n    const failed: Array<{ localPath: string; error: Error }> = [];\n    let doneCount = 0;\n\n    // Upload in concurrent batches\n    for (let i = 0; i < filteredFiles.length; i += concurrency) {\n      const batch = filteredFiles.slice(i, i + concurrency);\n\n      await Promise.all(\n        batch.map(async ({ absolute, relative }) => {\n          const storagePath = `${destination.replace(/\\/$/, \"\")}/${relative}`;\n\n          try {\n            const stream = createReadStream(absolute);\n            const file = await this.putStream(stream, storagePath, options?.putOptions);\n            uploaded.push(file);\n            doneCount++;\n            options?.onProgress?.(doneCount, total, file);\n          } catch (err) {\n            failed.push({\n              localPath: absolute,\n              error: err instanceof Error ? err : new Error(String(err)),\n            });\n          }\n        }),\n      );\n    }\n\n    return { uploaded, failed, total };\n  }\n\n  /**\n   * Walk a local directory recursively and return all file paths\n   *\n   * @param dirPath - Absolute local directory path\n   * @returns Array of { absolute, relative } file path pairs\n   * @internal\n   */\n  private async walkLocalDirectory(\n    dirPath: string,\n    baseDir?: string,\n  ): Promise<Array<{ absolute: string; relative: string }>> {\n    const root = baseDir ?? dirPath;\n    const entries = await fs.readdir(dirPath, { withFileTypes: true });\n    const results: Array<{ absolute: string; relative: string }> = [];\n\n    for (const entry of entries) {\n      const absolute = path.join(dirPath, entry.name);\n      const relative = path.relative(root, absolute).replace(/\\\\/g, \"/\");\n\n      if (entry.isDirectory()) {\n        const nested = await this.walkLocalDirectory(absolute, root);\n        results.push(...nested);\n      } else if (entry.isFile()) {\n        results.push({ absolute, relative });\n      }\n      // Symlinks are intentionally skipped\n    }\n\n    return results;\n  }\n\n  /**\n   * Empty a directory without deleting the directory itself\n   *\n   * Deletes all files within the directory but preserves the directory structure.\n   *\n   * @param path - Directory path to empty\n   * @returns Number of files deleted\n   *\n   * @example\n   * ```typescript\n   * const count = await storage.emptyDirectory(\"uploads/temp\");\n   * console.log(`Deleted ${count} files`);\n   * ```\n   */\n  public async emptyDirectory(path: string): Promise<number> {\n    // List all files in directory\n    const files = await this.list(path, { recursive: true });\n    const filePaths = files.filter((f) => !f.isDirectory).map((f) => f.path);\n\n    if (filePaths.length === 0) {\n      return 0;\n    }\n\n    // Delete all files\n    await this.deleteMany(filePaths);\n\n    return filePaths.length;\n  }\n\n  /**\n   * List files in a directory\n   *\n   * Returns file information for all files in the specified directory.\n   * Supports recursive listing and pagination.\n   *\n   * @param directory - Directory path (defaults to root)\n   * @param options - List options (recursive, limit, cursor)\n   * @returns Array of file information objects\n   *\n   * @example\n   * ```typescript\n   * // List all files in uploads\n   * const files = await storage.list(\"uploads\");\n   *\n   * // Recursive listing with limit\n   * const files = await storage.list(\"uploads\", {\n   *   recursive: true,\n   *   limit: 100\n   * });\n   * ```\n   */\n  public async list(directory?: string, options?: ListOptions): Promise<StorageFileInfo[]> {\n    return this.activeDriver.list(directory || \"\", options);\n  }\n\n  // ============================================================\n  // URL Operations\n  // ============================================================\n\n  /**\n   * Get the public URL for a file\n   *\n   * Returns the URL where the file can be accessed. For local storage,\n   * this is typically a path prefix. For cloud storage, this is the\n   * bucket URL or CDN URL.\n   *\n   * @param location - File path\n   * @returns Public URL string\n   *\n   * @example\n   * ```typescript\n   * const url = storage.url(\"images/photo.jpg\");\n   * // Local: \"/uploads/images/photo.jpg\"\n   * // S3: \"https://bucket.s3.amazonaws.com/images/photo.jpg\"\n   * ```\n   */\n  public url(location: string): string {\n    return this.activeDriver.url(location);\n  }\n\n  /**\n   * Get a temporary signed URL with expiration\n   *\n   * Creates a URL that provides temporary access to the file.\n   * For cloud storage, this uses presigned URLs.\n   * For local storage, this uses HMAC-signed tokens.\n   *\n   * @param location - File path\n   * @param expiresIn - Seconds until URL expires (default: 3600)\n   * @returns Signed URL string\n   *\n   * @example\n   * ```typescript\n   * // URL valid for 1 hour\n   * const url = await storage.temporaryUrl(\"private/document.pdf\");\n   *\n   * // URL valid for 24 hours\n   * const url = await storage.temporaryUrl(\"private/document.pdf\", 86400);\n   * ```\n   */\n  public async temporaryUrl(location: string, expiresIn?: number): Promise<string> {\n    return this.activeDriver.temporaryUrl(location, expiresIn);\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file metadata without downloading the file\n   *\n   * Retrieves information about a file including size, last modified date,\n   * and MIME type without downloading the file contents.\n   *\n   * @param location - File path\n   * @returns File information object\n   * @throws Error if file not found\n   *\n   * @example\n   * ```typescript\n   * const info = await storage.metadata(\"documents/report.pdf\");\n   * console.log(`Size: ${info.size} bytes`);\n   * console.log(`Type: ${info.mimeType}`);\n   * console.log(`Modified: ${info.lastModified}`);\n   * ```\n   */\n  public async metadata(location: string): Promise<StorageFileInfo> {\n    return this.activeDriver.metadata(location);\n  }\n\n  /**\n   * Get file size in bytes\n   *\n   * Shortcut for `metadata(location).size`.\n   *\n   * @param location - File path\n   * @returns File size in bytes\n   * @throws Error if file not found\n   */\n  public async size(location: string): Promise<number> {\n    return this.activeDriver.size(location);\n  }\n\n  /**\n   * Get a StorageFile instance for OOP-style operations\n   *\n   * Creates a `StorageFile` wrapper for the specified path,\n   * allowing fluent method chaining for file operations.\n   *\n   * @param location - File path\n   * @returns StorageFile instance\n   *\n   * @example\n   * ```typescript\n   * const file = await storage.file(\"uploads/image.jpg\");\n   *\n   * // Properties\n   * console.log(file.name);       // \"image.jpg\"\n   * console.log(file.extension);  // \"jpg\"\n   *\n   * // Operations\n   * await file.copy(\"backup/image.jpg\");\n   * await file.delete();\n   * ```\n   */\n  public file(location: string): StorageFile {\n    return new StorageFile(location, this.activeDriver);\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Convert various input types to Buffer\n   *\n   * @param file - Input file in various formats\n   * @returns Buffer containing file contents\n   * @internal\n   */\n  protected async toBuffer(file: UploadedFile | Buffer | string | Readable): Promise<Buffer> {\n    // Already a buffer\n    if (Buffer.isBuffer(file)) {\n      return file;\n    }\n\n    // Readable stream - collect into buffer\n    if (this.isReadable(file)) {\n      return this.streamToBuffer(file as Readable);\n    }\n\n    // String content\n    if (typeof file === \"string\") {\n      if (await fileExistsAsync(file)) {\n        return fs.readFile(file);\n      }\n\n      return Buffer.from(file);\n    }\n\n    // UploadedFile\n    return (file as UploadedFile).buffer();\n  }\n\n  /**\n   * Check if value is a Readable stream\n   *\n   * @param value - Value to check\n   * @returns True if value is a Readable stream\n   * @internal\n   */\n  protected isReadable(value: unknown): value is Readable {\n    return (\n      typeof value === \"object\" &&\n      value !== null &&\n      \"pipe\" in value &&\n      typeof (value as Readable).pipe === \"function\"\n    );\n  }\n\n  /**\n   * Convert a Readable stream to Buffer\n   *\n   * @param stream - Readable stream\n   * @returns Buffer containing stream contents\n   * @internal\n   */\n  protected async streamToBuffer(stream: Readable): Promise<Buffer> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n    }\n    return Buffer.concat(chunks as unknown as Uint8Array[]);\n  }\n\n  /**\n   * Prepend a prefix to a location path\n   *\n   * Useful for organizing files into directories.\n   *\n   * @param prefix - Prefix to add (e.g., \"uploads\")\n   * @param location - Original location path\n   * @returns Combined path with prefix\n   *\n   * @example\n   * ```typescript\n   * storage.prepend(\"uploads\", \"image.jpg\"); // \"uploads/image.jpg\"\n   * storage.prepend(\"uploads/\", \"/image.jpg\"); // \"uploads/image.jpg\"\n   * ```\n   */\n  public prepend(prefix: string, location: string): string {\n    return `${prefix.replace(/\\/$/, \"\")}/${location.replace(/^\\//, \"\")}`;\n  }\n\n  /**\n   * Append a suffix to a location path (before extension)\n   *\n   * Useful for creating variants of files (thumbnails, etc.).\n   *\n   * @param location - Original location path\n   * @param suffix - Suffix to add before extension\n   * @returns Path with suffix added before extension\n   *\n   * @example\n   * ```typescript\n   * storage.append(\"image.jpg\", \"_thumb\"); // \"image_thumb.jpg\"\n   * storage.append(\"document.pdf\", \"_v2\"); // \"document_v2.pdf\"\n   * ```\n   */\n  public append(location: string, suffix: string): string {\n    const lastDot = location.lastIndexOf(\".\");\n    if (lastDot === -1) {\n      return `${location}${suffix}`;\n    }\n    return `${location.substring(0, lastDot)}${suffix}${location.substring(lastDot)}`;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"scoped-storage.mjs","names":["fs"],"sources":["../../../../../../../core/src/storage/scoped-storage.ts"],"sourcesContent":["import { fileExistsAsync } from \"@warlock.js/fs\";\nimport { createReadStream } from \"fs\";\nimport fs from \"fs/promises\";\nimport path from \"path\";\nimport type { Readable } from \"stream\";\nimport type { UploadedFile } from \"../http\";\nimport { StorageFile } from \"./storage-file\";\nimport type {\n  DeleteManyResult,\n  ListOptions,\n  PutDirectoryOptions,\n  PutDirectoryResult,\n  PutFromUrlOptions,\n  PutOptions,\n  ScopedStorageContract,\n  StorageDriverContract,\n  StorageDriverType,\n  StorageFileInfo,\n} from \"./types\";\nimport { safeFetchToBuffer } from \"./utils/safe-fetch\";\n\n/**\n * ScopedStorage - Base class for storage operations\n *\n * Wraps a storage driver and provides a consistent, developer-friendly API\n * that returns `StorageFile` instances instead of raw data objects.\n *\n * This class serves as the base for both direct driver usage and the\n * full `Storage` manager class.\n *\n * @example\n * ```typescript\n * // Using via storage.use()\n * const s3Storage = storage.use(\"s3\");\n * const file = await s3Storage.put(buffer, \"images/photo.jpg\");\n *\n * // file is a StorageFile instance with rich API\n * console.log(file.name);       // \"photo.jpg\"\n * console.log(file.url);        // \"https://...\"\n * await file.copy(\"backup/photo.jpg\");\n * ```\n */\nexport class ScopedStorage implements ScopedStorageContract {\n  /**\n   * The underlying storage driver instance\n   * @internal\n   */\n  protected _driver: StorageDriverContract;\n\n  /**\n   * Create a new ScopedStorage instance\n   *\n   * @param driver - The storage driver to wrap\n   */\n  public constructor(driver: StorageDriverContract) {\n    this._driver = driver;\n  }\n\n  // ============================================================\n  // Properties\n  // ============================================================\n\n  /**\n   * Get the driver name\n   *\n   * @returns The name identifier of the underlying driver (e.g., \"local\", \"s3\", \"r2\")\n   */\n  public get name(): StorageDriverType {\n    return this.activeDriver.name;\n  }\n\n  /**\n   * Get the default driver instance\n   *\n   * Use this for advanced operations that require direct driver access.\n   *\n   * @returns The raw storage driver\n   */\n  public get defaultDriver(): StorageDriverContract {\n    return this._driver;\n  }\n\n  /**\n   * Get the currently active driver\n   *\n   * Returns the driver being used for storage operations.\n   * Can be overridden in subclasses for dynamic driver resolution (e.g., multi-tenant contexts).\n   *\n   * @returns The active storage driver\n   */\n  public get activeDriver(): StorageDriverContract {\n    return this._driver;\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Store a file in storage\n   *\n   * Accepts multiple input types and stores the file at the specified location.\n   * Returns a `StorageFile` instance for further operations.\n   *\n   * @param file - File content as Buffer, string path, UploadedFile, or Readable stream\n   * @param location - Destination path in storage (e.g., \"uploads/images/photo.jpg\")\n   * @param options - Optional storage options\n   * @returns StorageFile instance with cached metadata\n   *\n   * @example\n   * ```typescript\n   * // From buffer\n   * const file = await storage.put(buffer, \"documents/report.pdf\");\n   *\n   * // From uploaded file\n   * const file = await storage.put(uploadedFile, \"avatars/user-123.jpg\");\n   *\n   * // With options\n   * const file = await storage.put(buffer, \"images/photo.jpg\", {\n   *   mimeType: \"image/jpeg\",\n   *   cacheControl: \"max-age=31536000\"\n   * });\n   * ```\n   */\n  public async put(\n    file: UploadedFile | Buffer | string | Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    const buffer = await this.toBuffer(file);\n    const data = await this.activeDriver.put(buffer, location, options);\n    return StorageFile.fromData(data, this.activeDriver);\n  }\n\n  /**\n   * Store a file from a readable stream\n   *\n   * Optimized for large files - streams data directly without full buffering.\n   * Ideal for file uploads, remote file fetching, or processing pipelines.\n   *\n   * @param stream - Readable stream of file content\n   * @param location - Destination path in storage\n   * @param options - Optional storage options\n   * @returns StorageFile instance with cached metadata\n   *\n   * @example\n   * ```typescript\n   * import { createReadStream } from \"fs\";\n   *\n   * const stream = createReadStream(\"./large-video.mp4\");\n   * const file = await storage.putStream(stream, \"videos/upload.mp4\");\n   * ```\n   */\n  public async putStream(\n    stream: Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    const data = await this.activeDriver.putStream(stream, location, options);\n    return StorageFile.fromData(data, this.activeDriver);\n  }\n\n  /**\n   * Store a file from a URL\n   *\n   * Downloads the file from the URL and stores it. The download is\n   * SSRF-guarded by default: the URL scheme must be https/http, the host\n   * must not resolve to a private / loopback / link-local / cloud-metadata\n   * address, the body is capped, and the request times out. Tune or relax\n   * via the {@link PutFromUrlOptions} guard fields.\n   *\n   * @param url - URL to download from\n   * @param location - Destination path in storage\n   * @param options - Storage + outbound-download guard options\n   * @returns StorageFile instance\n   *\n   * @example\n   * ```typescript\n   * const file = await storage.putFromUrl(\n   *   \"https://example.com/image.jpg\",\n   *   \"images/downloaded.jpg\"\n   * );\n   * ```\n   */\n  public async putFromUrl(\n    url: string,\n    location: string,\n    options?: PutFromUrlOptions,\n  ): Promise<StorageFile> {\n    const { allowPrivateHosts, maxBytes, timeoutMs, allowedSchemes, ...putOptions } =\n      options ?? {};\n\n    const result = await safeFetchToBuffer(url, {\n      allowPrivateHosts,\n      maxBytes,\n      timeoutMs,\n      allowedSchemes,\n    });\n\n    if (!result.ok) {\n      throw new Error(`Failed to fetch file from ${url}: ${result.statusText}`);\n    }\n\n    if (!result.contentType) {\n      throw new Error(`Failed to fetch file from ${url}: missing content-type header`);\n    }\n\n    const mimeType = putOptions.mimeType || result.contentType;\n\n    return this.put(result.buffer, location, { ...putOptions, mimeType });\n  }\n\n  /**\n   * Store a file from base64 data URL\n   *\n   * @param dataUrl - Data URL (data:image/png;base64,iVBORw0KG...)\n   * @param location - Destination path in storage\n   * @param options - Optional storage options\n   * @returns StorageFile instance\n   *\n   * @example\n   * ```typescript\n   * const file = await storage.putFromBase64(\n   *   \"data:image/png;base64,iVBORw0KGgoAAAANS...\",\n   *   \"images/upload.png\"\n   * );\n   * ```\n   */\n  public async putFromBase64(\n    dataUrl: string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    // Parse data URL: data:image/png;base64,iVBORw0KG...\n    const matches = dataUrl.match(/^data:([^;]+);base64,(.+)$/);\n\n    if (!matches) {\n      throw new Error(\"Invalid base64 data URL format. Expected: data:mime/type;base64,<data>\");\n    }\n\n    const [, mimeType, base64Data] = matches;\n    const buffer = Buffer.from(base64Data, \"base64\");\n\n    return this.put(buffer, location, {\n      ...options,\n      mimeType: options?.mimeType || mimeType,\n    });\n  }\n\n  /**\n   * Retrieve file contents as a Buffer\n   *\n   * Downloads the entire file into memory. For large files,\n   * consider using `getStream()` instead.\n   *\n   * @param location - Path to the file in storage\n   * @returns Buffer containing file contents\n   * @throws Error if file not found\n   *\n   * @example\n   * ```typescript\n   * const buffer = await storage.get(\"documents/report.pdf\");\n   * const content = buffer.toString(\"utf-8\");\n   * ```\n   */\n  public async get(location: string): Promise<Buffer> {\n    return this.activeDriver.get(location);\n  }\n\n  /**\n   * Retrieve file contents as a readable stream\n   *\n   * Streams file data without loading entire file into memory.\n   * Ideal for large files or when piping to a response.\n   *\n   * @param location - Path to the file in storage\n   * @returns Readable stream of file contents\n   * @throws Error if file not found\n   *\n   * @example\n   * ```typescript\n   * const stream = await storage.getStream(\"videos/large.mp4\");\n   * stream.pipe(response.raw);\n   * ```\n   */\n  public async getStream(location: string): Promise<Readable> {\n    return this.activeDriver.getStream(location);\n  }\n\n  /**\n   * Delete a file from storage\n   *\n   * @param location - Path to the file, or a StorageFile instance\n   * @returns `true` if deleted, `false` if file not found\n   *\n   * @example\n   * ```typescript\n   * // By path\n   * await storage.delete(\"temp/old-file.txt\");\n   *\n   * // From StorageFile instance\n   * const file = await storage.put(buffer, \"temp/file.txt\");\n   * await storage.delete(file);\n   * ```\n   */\n  public async delete(location: string | StorageFile): Promise<boolean> {\n    const path = typeof location === \"string\" ? location : location.path;\n    return this.activeDriver.delete(path);\n  }\n\n  /**\n   * Delete multiple files at once\n   *\n   * Performs batch deletion for efficiency. Returns results for each file\n   * including success/failure status.\n   *\n   * @param locations - Array of file paths to delete\n   * @returns Array of delete results with status for each file\n   *\n   * @example\n   * ```typescript\n   * const results = await storage.deleteMany([\n   *   \"temp/file1.txt\",\n   *   \"temp/file2.txt\",\n   *   \"temp/file3.txt\"\n   * ]);\n   *\n   * for (const result of results) {\n   *   console.log(`${result.location}: ${result.deleted ? \"deleted\" : result.error}`);\n   * }\n   * ```\n   */\n  public async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    return this.activeDriver.deleteMany(locations);\n  }\n\n  /**\n   * Delete a directory\n   *\n   * @param directoryPath - Path to the directory\n   */\n  public async deleteDirectory(directoryPath: string): Promise<boolean> {\n    return await this.activeDriver.deleteDirectory(directoryPath);\n  }\n\n  /**\n   * Check if a file exists in storage\n   *\n   * @param location - Path to check\n   * @returns `true` if file exists, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * if (await storage.exists(\"config/settings.json\")) {\n   *   const config = await storage.get(\"config/settings.json\");\n   * }\n   * ```\n   */\n  public async exists(location: string): Promise<boolean> {\n    return this.activeDriver.exists(location);\n  }\n\n  /**\n   * Copy a file to a new location\n   *\n   * Creates a copy of the file at the destination path.\n   * The original file remains unchanged.\n   *\n   * @param from - Source path or StorageFile instance\n   * @param to - Destination path\n   * @returns StorageFile instance at the new location\n   *\n   * @example\n   * ```typescript\n   * // Copy by path\n   * const backup = await storage.copy(\"documents/report.pdf\", \"backups/report.pdf\");\n   *\n   * // Copy from StorageFile\n   * const original = await storage.file(\"documents/report.pdf\");\n   * const backup = await storage.copy(original, \"backups/report.pdf\");\n   * ```\n   */\n  public async copy(from: string | StorageFile, to: string): Promise<StorageFile> {\n    const fromPath = typeof from === \"string\" ? from : from.path;\n    const data = await this.activeDriver.copy(fromPath, to);\n    return StorageFile.fromData(data, this.activeDriver);\n  }\n\n  /**\n   * Move a file to a new location\n   *\n   * Moves the file to the destination path. The original file\n   * is deleted after successful copy.\n   *\n   * @param from - Source path or StorageFile instance\n   * @param to - Destination path\n   * @returns StorageFile instance at the new location\n   *\n   * @example\n   * ```typescript\n   * // Move by path\n   * const file = await storage.move(\"uploads/temp.jpg\", \"images/photo.jpg\");\n   *\n   * // Move from StorageFile\n   * const temp = await storage.file(\"uploads/temp.jpg\");\n   * const final = await storage.move(temp, \"images/photo.jpg\");\n   * ```\n   */\n  public async move(from: string | StorageFile, to: string): Promise<StorageFile> {\n    const fromPath = typeof from === \"string\" ? from : from.path;\n    const data = await this.activeDriver.move(fromPath, to);\n    return StorageFile.fromData(data, this.activeDriver);\n  }\n\n  /**\n   * Copy an entire directory recursively\n   *\n   * Copies all files from the source directory to the destination directory,\n   * preserving the directory structure.\n   *\n   * @param from - Source directory path\n   * @param to - Destination directory path\n   * @param options - Optional concurrency control\n   * @returns Number of files copied\n   *\n   * @example\n   * ```typescript\n   * // Copy entire directory\n   * const count = await storage.copyDirectory(\"uploads/temp\", \"uploads/final\");\n   * console.log(`Copied ${count} files`);\n   *\n   * // With concurrency limit\n   * const count = await storage.copyDirectory(\"large-dir\", \"backup\", {\n   *   concurrency: 10\n   * });\n   * ```\n   */\n  public async copyDirectory(\n    from: string,\n    to: string,\n    options?: { concurrency?: number },\n  ): Promise<number> {\n    const concurrency = options?.concurrency || 5;\n\n    // List all files recursively\n    const files = await this.list(from, { recursive: true });\n    const filesToCopy = files.filter((f) => !f.isDirectory);\n\n    // Copy files in batches for efficiency\n    let copied = 0;\n    for (let i = 0; i < filesToCopy.length; i += concurrency) {\n      const batch = filesToCopy.slice(i, i + concurrency);\n      await Promise.all(\n        batch.map(async (file) => {\n          // Calculate relative path and new destination\n          const relativePath = file.path.substring(from.length).replace(/^\\//, \"\");\n          const newPath = `${to}/${relativePath}`;\n          await this.copy(file.path, newPath);\n          copied++;\n        }),\n      );\n    }\n\n    return copied;\n  }\n\n  /**\n   * Move an entire directory recursively\n   *\n   * Moves all files from the source directory to the destination directory,\n   * then deletes the source directory.\n   *\n   * @param from - Source directory path\n   * @param to - Destination directory path\n   * @param options - Optional concurrency control\n   * @returns Number of files moved\n   *\n   * @example\n   * ```typescript\n   * const count = await storage.moveDirectory(\"uploads/temp\", \"uploads/final\");\n   * console.log(`Moved ${count} files`);\n   * ```\n   */\n  public async moveDirectory(\n    from: string,\n    to: string,\n    options?: { concurrency?: number },\n  ): Promise<number> {\n    // Copy all files first\n    const count = await this.copyDirectory(from, to, options);\n\n    // Delete source directory\n    await this.deleteDirectory(from);\n\n    return count;\n  }\n\n  /**\n   * Upload a local filesystem directory into storage\n   *\n   * Recursively walks the local directory, applies an optional filter, then\n   * streams each file into storage. Uploads run in concurrent batches for\n   * efficiency. Failures are collected — a single failed file never aborts\n   * the entire operation (mirrors the contract of `deleteMany`).\n   *\n   * @param localDirPath  - Absolute path of the local directory to upload\n   * @param destination   - Target prefix in storage (e.g. \"uploads/assets\")\n   * @param options       - Concurrency, filter, progress callback, put options\n   * @returns             - { uploaded, failed, total }\n   *\n   * @example\n   * ```typescript\n   * const result = await storage.putDirectory(\"./public/assets\", \"cdn/assets\", {\n   *   concurrency: 10,\n   *   filter: (_, rel) => !rel.startsWith(\".\"),\n   *   onProgress: (done, total) => console.log(`${done}/${total}`),\n   * });\n   *\n   * console.log(`Uploaded: ${result.uploaded.length}, Failed: ${result.failed.length}`);\n   * ```\n   */\n  public async putDirectory(\n    localDirPath: string,\n    destination: string,\n    options?: PutDirectoryOptions,\n  ): Promise<PutDirectoryResult> {\n    const concurrency = options?.concurrency ?? 5;\n\n    // Collect all local file paths recursively\n    const localFiles = await this.walkLocalDirectory(localDirPath);\n\n    // Apply the user-supplied filter if any\n    const filteredFiles = options?.filter\n      ? localFiles.filter(({ absolute, relative }) => options.filter!(absolute, relative))\n      : localFiles;\n\n    const total = filteredFiles.length;\n    const uploaded: StorageFile[] = [];\n    const failed: Array<{ localPath: string; error: Error }> = [];\n    let doneCount = 0;\n\n    // Upload in concurrent batches\n    for (let i = 0; i < filteredFiles.length; i += concurrency) {\n      const batch = filteredFiles.slice(i, i + concurrency);\n\n      await Promise.all(\n        batch.map(async ({ absolute, relative }) => {\n          const storagePath = `${destination.replace(/\\/$/, \"\")}/${relative}`;\n\n          try {\n            const stream = createReadStream(absolute);\n            const file = await this.putStream(stream, storagePath, options?.putOptions);\n            uploaded.push(file);\n            doneCount++;\n            options?.onProgress?.(doneCount, total, file);\n          } catch (err) {\n            failed.push({\n              localPath: absolute,\n              error: err instanceof Error ? err : new Error(String(err)),\n            });\n          }\n        }),\n      );\n    }\n\n    return { uploaded, failed, total };\n  }\n\n  /**\n   * Walk a local directory recursively and return all file paths\n   *\n   * @param dirPath - Absolute local directory path\n   * @returns Array of { absolute, relative } file path pairs\n   * @internal\n   */\n  private async walkLocalDirectory(\n    dirPath: string,\n    baseDir?: string,\n  ): Promise<Array<{ absolute: string; relative: string }>> {\n    const root = baseDir ?? dirPath;\n    const entries = await fs.readdir(dirPath, { withFileTypes: true });\n    const results: Array<{ absolute: string; relative: string }> = [];\n\n    for (const entry of entries) {\n      const absolute = path.join(dirPath, entry.name);\n      const relative = path.relative(root, absolute).replace(/\\\\/g, \"/\");\n\n      if (entry.isDirectory()) {\n        const nested = await this.walkLocalDirectory(absolute, root);\n        results.push(...nested);\n      } else if (entry.isFile()) {\n        results.push({ absolute, relative });\n      }\n      // Symlinks are intentionally skipped\n    }\n\n    return results;\n  }\n\n  /**\n   * Empty a directory without deleting the directory itself\n   *\n   * Deletes all files within the directory but preserves the directory structure.\n   *\n   * @param path - Directory path to empty\n   * @returns Number of files deleted\n   *\n   * @example\n   * ```typescript\n   * const count = await storage.emptyDirectory(\"uploads/temp\");\n   * console.log(`Deleted ${count} files`);\n   * ```\n   */\n  public async emptyDirectory(path: string): Promise<number> {\n    // List all files in directory\n    const files = await this.list(path, { recursive: true });\n    const filePaths = files.filter((f) => !f.isDirectory).map((f) => f.path);\n\n    if (filePaths.length === 0) {\n      return 0;\n    }\n\n    // Delete all files\n    await this.deleteMany(filePaths);\n\n    return filePaths.length;\n  }\n\n  /**\n   * List files in a directory\n   *\n   * Returns file information for all files in the specified directory.\n   * Supports recursive listing and pagination.\n   *\n   * @param directory - Directory path (defaults to root)\n   * @param options - List options (recursive, limit, cursor)\n   * @returns Array of file information objects\n   *\n   * @example\n   * ```typescript\n   * // List all files in uploads\n   * const files = await storage.list(\"uploads\");\n   *\n   * // Recursive listing with limit\n   * const files = await storage.list(\"uploads\", {\n   *   recursive: true,\n   *   limit: 100\n   * });\n   * ```\n   */\n  public async list(directory?: string, options?: ListOptions): Promise<StorageFileInfo[]> {\n    return this.activeDriver.list(directory || \"\", options);\n  }\n\n  // ============================================================\n  // URL Operations\n  // ============================================================\n\n  /**\n   * Get the public URL for a file\n   *\n   * Returns the URL where the file can be accessed. For local storage,\n   * this is typically a path prefix. For cloud storage, this is the\n   * bucket URL or CDN URL.\n   *\n   * @param location - File path\n   * @returns Public URL string\n   *\n   * @example\n   * ```typescript\n   * const url = storage.url(\"images/photo.jpg\");\n   * // Local: \"/uploads/images/photo.jpg\"\n   * // S3: \"https://bucket.s3.amazonaws.com/images/photo.jpg\"\n   * ```\n   */\n  public url(location: string): string {\n    return this.activeDriver.url(location);\n  }\n\n  /**\n   * Get a temporary signed URL with expiration\n   *\n   * Creates a URL that provides temporary access to the file.\n   * For cloud storage, this uses presigned URLs.\n   * For local storage, this uses HMAC-signed tokens.\n   *\n   * @param location - File path\n   * @param expiresIn - Seconds until URL expires (default: 3600)\n   * @returns Signed URL string\n   *\n   * @example\n   * ```typescript\n   * // URL valid for 1 hour\n   * const url = await storage.temporaryUrl(\"private/document.pdf\");\n   *\n   * // URL valid for 24 hours\n   * const url = await storage.temporaryUrl(\"private/document.pdf\", 86400);\n   * ```\n   */\n  public async temporaryUrl(location: string, expiresIn?: number): Promise<string> {\n    return this.activeDriver.temporaryUrl(location, expiresIn);\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file metadata without downloading the file\n   *\n   * Retrieves information about a file including size, last modified date,\n   * and MIME type without downloading the file contents.\n   *\n   * @param location - File path\n   * @returns File information object\n   * @throws Error if file not found\n   *\n   * @example\n   * ```typescript\n   * const info = await storage.metadata(\"documents/report.pdf\");\n   * console.log(`Size: ${info.size} bytes`);\n   * console.log(`Type: ${info.mimeType}`);\n   * console.log(`Modified: ${info.lastModified}`);\n   * ```\n   */\n  public async metadata(location: string): Promise<StorageFileInfo> {\n    return this.activeDriver.metadata(location);\n  }\n\n  /**\n   * Get file size in bytes\n   *\n   * Shortcut for `metadata(location).size`.\n   *\n   * @param location - File path\n   * @returns File size in bytes\n   * @throws Error if file not found\n   */\n  public async size(location: string): Promise<number> {\n    return this.activeDriver.size(location);\n  }\n\n  /**\n   * Get a StorageFile instance for OOP-style operations\n   *\n   * Creates a `StorageFile` wrapper for the specified path,\n   * allowing fluent method chaining for file operations.\n   *\n   * @param location - File path\n   * @returns StorageFile instance\n   *\n   * @example\n   * ```typescript\n   * const file = await storage.file(\"uploads/image.jpg\");\n   *\n   * // Properties\n   * console.log(file.name);       // \"image.jpg\"\n   * console.log(file.extension);  // \"jpg\"\n   *\n   * // Operations\n   * await file.copy(\"backup/image.jpg\");\n   * await file.delete();\n   * ```\n   */\n  public file(location: string): StorageFile {\n    return new StorageFile(location, this.activeDriver);\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Convert various input types to Buffer\n   *\n   * @param file - Input file in various formats\n   * @returns Buffer containing file contents\n   * @internal\n   */\n  protected async toBuffer(file: UploadedFile | Buffer | string | Readable): Promise<Buffer> {\n    // Already a buffer\n    if (Buffer.isBuffer(file)) {\n      return file;\n    }\n\n    // Readable stream - collect into buffer\n    if (this.isReadable(file)) {\n      return this.streamToBuffer(file as Readable);\n    }\n\n    // String content\n    if (typeof file === \"string\") {\n      if (await fileExistsAsync(file)) {\n        return fs.readFile(file);\n      }\n\n      return Buffer.from(file);\n    }\n\n    // UploadedFile\n    return (file as UploadedFile).buffer();\n  }\n\n  /**\n   * Check if value is a Readable stream\n   *\n   * @param value - Value to check\n   * @returns True if value is a Readable stream\n   * @internal\n   */\n  protected isReadable(value: unknown): value is Readable {\n    return (\n      typeof value === \"object\" &&\n      value !== null &&\n      \"pipe\" in value &&\n      typeof (value as Readable).pipe === \"function\"\n    );\n  }\n\n  /**\n   * Convert a Readable stream to Buffer\n   *\n   * @param stream - Readable stream\n   * @returns Buffer containing stream contents\n   * @internal\n   */\n  protected async streamToBuffer(stream: Readable): Promise<Buffer> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n    }\n    return Buffer.concat(chunks as unknown as Uint8Array[]);\n  }\n\n  /**\n   * Prepend a prefix to a location path\n   *\n   * Useful for organizing files into directories.\n   *\n   * @param prefix - Prefix to add (e.g., \"uploads\")\n   * @param location - Original location path\n   * @returns Combined path with prefix\n   *\n   * @example\n   * ```typescript\n   * storage.prepend(\"uploads\", \"image.jpg\"); // \"uploads/image.jpg\"\n   * storage.prepend(\"uploads/\", \"/image.jpg\"); // \"uploads/image.jpg\"\n   * ```\n   */\n  public prepend(prefix: string, location: string): string {\n    return `${prefix.replace(/\\/$/, \"\")}/${location.replace(/^\\//, \"\")}`;\n  }\n\n  /**\n   * Append a suffix to a location path (before extension)\n   *\n   * Useful for creating variants of files (thumbnails, etc.).\n   *\n   * @param location - Original location path\n   * @param suffix - Suffix to add before extension\n   * @returns Path with suffix added before extension\n   *\n   * @example\n   * ```typescript\n   * storage.append(\"image.jpg\", \"_thumb\"); // \"image_thumb.jpg\"\n   * storage.append(\"document.pdf\", \"_v2\"); // \"document_v2.pdf\"\n   * ```\n   */\n  public append(location: string, suffix: string): string {\n    const lastDot = location.lastIndexOf(\".\");\n    if (lastDot === -1) {\n      return `${location}${suffix}`;\n    }\n    return `${location.substring(0, lastDot)}${suffix}${location.substring(lastDot)}`;\n  }\n}\n"],"mappings":"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"}

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

@@ -1,7 +1,7 @@
 import { CloudStorageFileData, FileVisibility, StorageDriverContract, StorageFileData, StorageFileInfo } from "./types.mjs";
 import { Readable } from "stream";
 
-//#region ../@warlock.js/core/src/storage/storage-file.d.ts
+//#region ../core/src/storage/storage-file.d.ts
 /**
  * StorageFile class - OOP wrapper for storage file operations
  *

package/esm/storage/storage-file.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-file.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/storage-file.ts"],"mappings":";;;;;;AAqCA;;;;;;;;;;;;;;;;;;;;;;;;cAAa,WAAA;EA6P6B;;;EAAA,UAzP9B,KAAA;EAkS8C;;;EAAA,UA7R9C,OAAA,EAAS,qBAAA;EA4VX;;;EAAA,UAvVE,KAAA,GAAQ,eAAA;EAgWe;;;EAAA,UA3VvB,QAAA;EAmXQ;;;;;;;cA1WC,IAAA,UAAc,MAAA,EAAQ,qBAAA,EAAuB,IAAA,GAAO,eAAA;EAnB7D;;;EAAA,IAgCC,IAAA;EAtBD;;;EAAA,IA6BC,IAAA;EApBsB;;;EAAA,IA2BtB,SAAA;EAPA;;;EAAA,IAcA,SAAA;EAcA;;;EAAA,IAPA,MAAA;EA6CE;;;EAAA,IAtCF,SAAA;EA0DU;;;EAAA,IAnDV,GAAA;EAmEkB;;;EAAA,IA3DlB,YAAA;EAiFE;;;EAAA,IArEF,IAAA;EA6EY;;;EAlEV,IAAA,IAAQ,OAAA,CAAQ,eAAA;EAkFhB;;;EA9DA,IAAA,IAAQ,OAAA;EAoFR;;;EA5EA,QAAA,IAAY,OAAA;EAwFF;;;EAhFV,YAAA,IAAgB,OAAA,CAAQ,IAAA;EA2FW;;;EAlFnC,IAAA,IAAQ,OAAA;EA4GR;;;EA/FA,QAAA,IAAY,OAAA,CAAQ,MAAA;EAyGV;;;EAjGV,MAAA,IAAU,OAAA,CAAQ,QAAA;EAkHyB;;;EA1G3C,IAAA,IAAQ,OAAA;EA0IR;;;EAlIA,MAAA,IAAU,OAAA;EAgKT;;;EAxJD,OAAA,IAAW,OAAA;EA0Jd;;;;;EA5IG,YAAA,CAAa,SAAA,YAAmB,OAAA;EA4JhC;;;EAhJA,MAAA,IAAU,OAAA;EAgKV;;;;;;EArJA,IAAA,CAAK,WAAA,WAAsB,OAAA,CAAQ,WAAA;EAsL5B;;;;;;EA1KP,IAAA,CAAK,WAAA,WAAsB,OAAA;EA8LtC;;;;;;EAhLW,MAAA,CAAO,OAAA,WAAkB,OAAA;EAqMvB;;;;;EA3LF,MAAA,IAAU,OAAA;;;;;;;EAiBV,aAAA,CAAc,UAAA,EAAY,cAAA,GAAiB,OAAA;;;;;;EAgB3C,aAAA,IAAiB,OAAA,CAAQ,cAAA;;;;;;;EAgBzB,eAAA,CAAgB,YAAA,WAAuB,OAAA;;;;YAkB1C,gBAAA;;;;;;;SAYI,QAAA,CACZ,IAAA,EAAM,eAAA,GAAkB,oBAAA,EACxB,MAAA,EAAQ,qBAAA,GACP,WAAA;;;;EAOU,QAAA,IAAY,OAAA,CAAQ,eAAA;;;;EAQpB,OAAA,IAAO,OAAA;;;;EAQP,UAAA,IAAU,OAAA;;;;EAQV,KAAA,IAAK,OAAA;;;;EAQL,OAAA,IAAO,OAAA;;;;EAYP,KAAA,IAAK,OAAA;;;;EAaL,OAAA,IAAO,OAAA;;;;EAQP,OAAA,IAAO,OAAA;;;;EAQb,MAAA;IACL,IAAA;IACA,IAAA;IACA,SAAA;IACA,MAAA;IACA,GAAA;IACA,IAAA;IACA,IAAA;IACA,QAAA;EAAA;;;;EAiBK,QAAA;AAAA"}
+{"version":3,"file":"storage-file.d.mts","names":[],"sources":["../../../../../../../core/src/storage/storage-file.ts"],"mappings":";;;;;;AAqCA;;;;;;;;;;;;;;;;;;;;;;;;cAAa,WAAA;EA6P6B;;;EAAA,UAzP9B,KAAA;EAkS8C;;;EAAA,UA7R9C,OAAA,EAAS,qBAAA;EA4VX;;;EAAA,UAvVE,KAAA,GAAQ,eAAA;EAgWe;;;EAAA,UA3VvB,QAAA;EAmXQ;;;;;;;cA1WC,IAAA,UAAc,MAAA,EAAQ,qBAAA,EAAuB,IAAA,GAAO,eAAA;EAnB7D;;;EAAA,IAgCC,IAAA;EAtBD;;;EAAA,IA6BC,IAAA;EApBsB;;;EAAA,IA2BtB,SAAA;EAPA;;;EAAA,IAcA,SAAA;EAcA;;;EAAA,IAPA,MAAA;EA6CE;;;EAAA,IAtCF,SAAA;EA0DU;;;EAAA,IAnDV,GAAA;EAmEkB;;;EAAA,IA3DlB,YAAA;EAiFE;;;EAAA,IArEF,IAAA;EA6EY;;;EAlEV,IAAA,IAAQ,OAAA,CAAQ,eAAA;EAkFhB;;;EA9DA,IAAA,IAAQ,OAAA;EAoFR;;;EA5EA,QAAA,IAAY,OAAA;EAwFF;;;EAhFV,YAAA,IAAgB,OAAA,CAAQ,IAAA;EA2FW;;;EAlFnC,IAAA,IAAQ,OAAA;EA4GR;;;EA/FA,QAAA,IAAY,OAAA,CAAQ,MAAA;EAyGV;;;EAjGV,MAAA,IAAU,OAAA,CAAQ,QAAA;EAkHyB;;;EA1G3C,IAAA,IAAQ,OAAA;EA0IR;;;EAlIA,MAAA,IAAU,OAAA;EAgKT;;;EAxJD,OAAA,IAAW,OAAA;EA0Jd;;;;;EA5IG,YAAA,CAAa,SAAA,YAAmB,OAAA;EA4JhC;;;EAhJA,MAAA,IAAU,OAAA;EAgKV;;;;;;EArJA,IAAA,CAAK,WAAA,WAAsB,OAAA,CAAQ,WAAA;EAsL5B;;;;;;EA1KP,IAAA,CAAK,WAAA,WAAsB,OAAA;EA8LtC;;;;;;EAhLW,MAAA,CAAO,OAAA,WAAkB,OAAA;EAqMvB;;;;;EA3LF,MAAA,IAAU,OAAA;;;;;;;EAiBV,aAAA,CAAc,UAAA,EAAY,cAAA,GAAiB,OAAA;;;;;;EAgB3C,aAAA,IAAiB,OAAA,CAAQ,cAAA;;;;;;;EAgBzB,eAAA,CAAgB,YAAA,WAAuB,OAAA;;;;YAkB1C,gBAAA;;;;;;;SAYI,QAAA,CACZ,IAAA,EAAM,eAAA,GAAkB,oBAAA,EACxB,MAAA,EAAQ,qBAAA,GACP,WAAA;;;;EAOU,QAAA,IAAY,OAAA,CAAQ,eAAA;;;;EAQpB,OAAA,IAAO,OAAA;;;;EAQP,UAAA,IAAU,OAAA;;;;EAQV,KAAA,IAAK,OAAA;;;;EAQL,OAAA,IAAO,OAAA;;;;EAYP,KAAA,IAAK,OAAA;;;;EAaL,OAAA,IAAO,OAAA;;;;EAQP,OAAA,IAAO,OAAA;;;;EAQb,MAAA;IACL,IAAA;IACA,IAAA;IACA,SAAA;IACA,MAAA;IACA,GAAA;IACA,IAAA;IACA,IAAA;IACA,QAAA;EAAA;;;;EAiBK,QAAA;AAAA"}

package/esm/storage/storage-file.mjs

@@ -1,6 +1,6 @@
 import { basename, dirname, extname } from "path";
 
-//#region ../@warlock.js/core/src/storage/storage-file.ts
+//#region ../core/src/storage/storage-file.ts
 /**
 * StorageFile class - OOP wrapper for storage file operations
 *

package/esm/storage/storage-file.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage-file.mjs","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/storage-file.ts"],"sourcesContent":["import { basename, dirname, extname } from \"path\";\nimport type { Readable } from \"stream\";\nimport type {\n  CloudStorageDriverContract,\n  CloudStorageFileData,\n  FileVisibility,\n  StorageDriverContract,\n  StorageFileData,\n  StorageFileInfo,\n} from \"./types\";\n\n/**\n * StorageFile class - OOP wrapper for storage file operations\n *\n * Provides a fluent interface for working with files in storage,\n * wrapping the underlying driver operations.\n *\n * @example\n * ```typescript\n * const file = await storage.put(buffer, \"uploads/image.jpg\");\n *\n * // Properties (sync, from cached data)\n * file.name        // \"image.jpg\"\n * file.extension   // \"jpg\"\n * file.path        // \"uploads/image.jpg\"\n * file.hash        // \"sha256:abc123...\"\n *\n * // Operations\n * await file.copy(\"uploads/backup.jpg\")\n * await file.move(\"archive/image.jpg\")\n * await file.delete()\n *\n * // Content\n * const buffer = await file.contents();\n * const stream = await file.stream();\n * ```\n */\nexport class StorageFile {\n  /**\n   * Relative file path\n   */\n  protected _path: string;\n\n  /**\n   * The driver instance\n   */\n  protected _driver: StorageDriverContract;\n\n  /**\n   * Cached file data (from put operations or lazy loaded)\n   */\n  protected _data?: StorageFileData;\n\n  /**\n   * Whether the file has been deleted\n   */\n  protected _deleted = false;\n\n  /**\n   * Create a new StorageFile instance\n   *\n   * @param path - Relative file path\n   * @param driver - Driver instance\n   * @param data - Optional initial data from put/copy operations\n   */\n  public constructor(path: string, driver: StorageDriverContract, data?: StorageFileData) {\n    this._path = path;\n    this._driver = driver;\n    this._data = data;\n  }\n\n  // ============================================================\n  // Properties\n  // ============================================================\n\n  /**\n   * Get the relative file path\n   */\n  public get path(): string {\n    return this._path;\n  }\n\n  /**\n   * Get the file name (with extension)\n   */\n  public get name(): string {\n    return basename(this._path);\n  }\n\n  /**\n   * Get the file extension (without dot)\n   */\n  public get extension(): string {\n    return extname(this._path).slice(1).toLowerCase();\n  }\n\n  /**\n   * Get the directory path\n   */\n  public get directory(): string {\n    return dirname(this._path);\n  }\n\n  /**\n   * Get the driver name\n   */\n  public get driver(): string {\n    return this._driver.name;\n  }\n\n  /**\n   * Check if file has been deleted\n   */\n  public get isDeleted(): boolean {\n    return this._deleted;\n  }\n\n  /**\n   * Get public URL (sync if data cached, otherwise computed)\n   */\n  public get url(): string {\n    this.ensureNotDeleted();\n    return this._data?.url || this._driver.url(this._path);\n  }\n\n  /**\n   * Get the absolute filesystem path (local driver only)\n   */\n  public get absolutePath(): string | undefined {\n    this.ensureNotDeleted();\n    if (\"path\" in this._driver && typeof this._driver.path === \"function\") {\n      return this._driver.path(this._path);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Get file hash (SHA-256, available from put operations)\n   */\n  public get hash(): string | undefined {\n    return this._data?.hash;\n  }\n\n  // ============================================================\n  // Data Methods (Lazy Loaded)\n  // ============================================================\n\n  /**\n   * Get cached file data, or fetch it if not available\n   */\n  public async data(): Promise<StorageFileData> {\n    this.ensureNotDeleted();\n    if (!this._data) {\n      // Fetch info and construct data\n      const info = await this.metadata();\n      this._data = {\n        path: info.path,\n        url: this._driver.url(this._path),\n        size: info.size,\n        hash: \"\", // Not available from metadata\n        mimeType: info.mimeType || \"application/octet-stream\",\n        driver: this._driver.name,\n      };\n    }\n    return this._data;\n  }\n\n  /**\n   * Get file size in bytes\n   */\n  public async size(): Promise<number> {\n    const data = await this.data();\n    return data.size;\n  }\n\n  /**\n   * Get MIME type\n   */\n  public async mimeType(): Promise<string> {\n    const data = await this.data();\n    return data.mimeType;\n  }\n\n  /**\n   * Get last modified date (fetches from driver)\n   */\n  public async lastModified(): Promise<Date | undefined> {\n    this.ensureNotDeleted();\n    const info = await this.metadata();\n    return info.lastModified;\n  }\n\n  /**\n   * Get ETag (cloud drivers, fetches from driver)\n   */\n  public async etag(): Promise<string | undefined> {\n    this.ensureNotDeleted();\n    const info = await this.metadata();\n    return info.etag;\n  }\n\n  // ============================================================\n  // Content Methods\n  // ============================================================\n\n  /**\n   * Get file contents as Buffer\n   */\n  public async contents(): Promise<Buffer> {\n    this.ensureNotDeleted();\n    return this._driver.get(this._path);\n  }\n\n  /**\n   * Get file contents as readable stream\n   */\n  public async stream(): Promise<Readable> {\n    this.ensureNotDeleted();\n    return this._driver.getStream(this._path);\n  }\n\n  /**\n   * Get file contents as UTF-8 text\n   */\n  public async text(): Promise<string> {\n    const buffer = await this.contents();\n    return buffer.toString(\"utf-8\");\n  }\n\n  /**\n   * Get file contents as base64 string\n   */\n  public async base64(): Promise<string> {\n    const buffer = await this.contents();\n    return buffer.toString(\"base64\");\n  }\n\n  /**\n   * Get file contents as data URL\n   */\n  public async dataUrl(): Promise<string> {\n    const [buffer, data] = await Promise.all([this.contents(), this.data()]);\n    return `data:${data.mimeType};base64,${buffer.toString(\"base64\")}`;\n  }\n\n  // ============================================================\n  // URL Methods\n  // ============================================================\n\n  /**\n   * Get a temporary signed URL\n   *\n   * @param expiresIn - Seconds until expiration (default: 3600)\n   */\n  public async temporaryUrl(expiresIn = 3600): Promise<string> {\n    this.ensureNotDeleted();\n    return this._driver.temporaryUrl(this._path, expiresIn);\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Check if the file exists\n   */\n  public async exists(): Promise<boolean> {\n    if (this._deleted) return false;\n    return this._driver.exists(this._path);\n  }\n\n  /**\n   * Copy the file to a new location\n   *\n   * @param destination - Destination path\n   * @returns New StorageFile instance at destination\n   */\n  public async copy(destination: string): Promise<StorageFile> {\n    this.ensureNotDeleted();\n    const result = await this._driver.copy(this._path, destination);\n    return new StorageFile(destination, this._driver, result);\n  }\n\n  /**\n   * Move the file to a new location\n   *\n   * @param destination - Destination path\n   * @returns This StorageFile instance with updated path\n   */\n  public async move(destination: string): Promise<this> {\n    this.ensureNotDeleted();\n    const result = await this._driver.move(this._path, destination);\n    this._path = destination;\n    this._data = result; // Update cached data\n    return this;\n  }\n\n  /**\n   * Rename the file (move within same directory)\n   *\n   * @param newName - New file name\n   * @returns This StorageFile instance with updated path\n   */\n  public async rename(newName: string): Promise<this> {\n    const newPath = this.directory === \".\" ? newName : `${this.directory}/${newName}`;\n    return this.move(newPath);\n  }\n\n  /**\n   * Delete the file\n   *\n   * @returns true if deleted, false if not found\n   */\n  public async delete(): Promise<boolean> {\n    this.ensureNotDeleted();\n    const result = await this._driver.delete(this._path);\n    this._deleted = true;\n    return result;\n  }\n\n  // ============================================================\n  // Cloud-Specific Methods\n  // ============================================================\n\n  /**\n   * Set file visibility (cloud drivers only)\n   *\n   * @param visibility - \"public\" or \"private\"\n   * @throws Error if driver doesn't support visibility\n   */\n  public async setVisibility(visibility: FileVisibility): Promise<this> {\n    this.ensureNotDeleted();\n\n    if (!(\"setVisibility\" in this._driver)) {\n      throw new Error(\"setVisibility is only available for cloud storage drivers\");\n    }\n\n    await (this._driver as CloudStorageDriverContract).setVisibility(this._path, visibility);\n    return this;\n  }\n\n  /**\n   * Get file visibility (cloud drivers only)\n   *\n   * @throws Error if driver doesn't support visibility\n   */\n  public async getVisibility(): Promise<FileVisibility> {\n    this.ensureNotDeleted();\n\n    if (!(\"getVisibility\" in this._driver)) {\n      throw new Error(\"getVisibility is only available for cloud storage drivers\");\n    }\n\n    return (this._driver as CloudStorageDriverContract).getVisibility(this._path);\n  }\n\n  /**\n   * Set storage class (cloud drivers only)\n   *\n   * @param storageClass - Storage class (e.g., \"STANDARD\", \"GLACIER\")\n   * @throws Error if driver doesn't support storage class\n   */\n  public async setStorageClass(storageClass: string): Promise<this> {\n    this.ensureNotDeleted();\n\n    if (!(\"setStorageClass\" in this._driver)) {\n      throw new Error(\"setStorageClass is only available for cloud storage drivers\");\n    }\n\n    await (this._driver as CloudStorageDriverContract).setStorageClass(this._path, storageClass);\n    return this;\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Ensure the file has not been deleted\n   */\n  protected ensureNotDeleted(): void {\n    if (this._deleted) {\n      throw new Error(`File \"${this._path}\" has been deleted`);\n    }\n  }\n\n  /**\n   * Create a StorageFile instance from StorageFileData\n   *\n   * @param data - Storage file data from put/copy/move operations\n   * @param driver - Driver instance\n   */\n  public static fromData(\n    data: StorageFileData | CloudStorageFileData,\n    driver: StorageDriverContract,\n  ): StorageFile {\n    return new StorageFile(data.path, driver, data);\n  }\n\n  /**\n   * Get file metadata\n   */\n  public async metadata(): Promise<StorageFileInfo> {\n    this.ensureNotDeleted();\n    return this._driver.metadata(this._path);\n  }\n\n  /**\n   * Determine if this file is an image type\n   */\n  public async isImage() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"image/\");\n  }\n\n  /**\n   * Determine if this file is a document type\n   */\n  public async isDocument() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"application/\");\n  }\n\n  /**\n   * Determine if this file is a pdf type\n   */\n  public async isPdf() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"application/pdf\");\n  }\n\n  /**\n   * Determine if this file is an excel file (any support excel file)\n   */\n  public async isExcel() {\n    const metadata = await this.metadata();\n    return (\n      metadata.mimeType!.startsWith(\n        \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n      ) || metadata.mimeType!.startsWith(\"application/vnd.ms-excel\")\n    );\n  }\n\n  /**\n   * Determine if this file is a doc file\n   */\n  public async isDoc() {\n    const metadata = await this.metadata();\n    return (\n      metadata.mimeType!.startsWith(\"application/msword\") ||\n      metadata.mimeType!.startsWith(\n        \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n      )\n    );\n  }\n\n  /**\n   * Determine if this file is an audio type\n   */\n  public async isAudio() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"audio/\");\n  }\n\n  /**\n   * Determine if this file is a video type\n   */\n  public async isVideo() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"video/\");\n  }\n\n  /**\n   * Convert to plain object (returns cached data or constructs it)\n   */\n  public toJSON(): {\n    path: string;\n    name: string;\n    extension: string;\n    driver: string;\n    url: string;\n    hash?: string;\n    size?: number;\n    mimeType?: string;\n  } {\n    return {\n      path: this._path,\n      name: this.name,\n      extension: this.extension,\n      driver: this._driver.name,\n      url: this._deleted ? \"\" : this.url,\n      hash: this._data?.hash,\n      size: this._data?.size,\n      mimeType: this._data?.mimeType,\n    };\n  }\n\n  /**\n   * String representation\n   */\n  public toString(): string {\n    return this._path;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"storage-file.mjs","names":[],"sources":["../../../../../../../core/src/storage/storage-file.ts"],"sourcesContent":["import { basename, dirname, extname } from \"path\";\nimport type { Readable } from \"stream\";\nimport type {\n  CloudStorageDriverContract,\n  CloudStorageFileData,\n  FileVisibility,\n  StorageDriverContract,\n  StorageFileData,\n  StorageFileInfo,\n} from \"./types\";\n\n/**\n * StorageFile class - OOP wrapper for storage file operations\n *\n * Provides a fluent interface for working with files in storage,\n * wrapping the underlying driver operations.\n *\n * @example\n * ```typescript\n * const file = await storage.put(buffer, \"uploads/image.jpg\");\n *\n * // Properties (sync, from cached data)\n * file.name        // \"image.jpg\"\n * file.extension   // \"jpg\"\n * file.path        // \"uploads/image.jpg\"\n * file.hash        // \"sha256:abc123...\"\n *\n * // Operations\n * await file.copy(\"uploads/backup.jpg\")\n * await file.move(\"archive/image.jpg\")\n * await file.delete()\n *\n * // Content\n * const buffer = await file.contents();\n * const stream = await file.stream();\n * ```\n */\nexport class StorageFile {\n  /**\n   * Relative file path\n   */\n  protected _path: string;\n\n  /**\n   * The driver instance\n   */\n  protected _driver: StorageDriverContract;\n\n  /**\n   * Cached file data (from put operations or lazy loaded)\n   */\n  protected _data?: StorageFileData;\n\n  /**\n   * Whether the file has been deleted\n   */\n  protected _deleted = false;\n\n  /**\n   * Create a new StorageFile instance\n   *\n   * @param path - Relative file path\n   * @param driver - Driver instance\n   * @param data - Optional initial data from put/copy operations\n   */\n  public constructor(path: string, driver: StorageDriverContract, data?: StorageFileData) {\n    this._path = path;\n    this._driver = driver;\n    this._data = data;\n  }\n\n  // ============================================================\n  // Properties\n  // ============================================================\n\n  /**\n   * Get the relative file path\n   */\n  public get path(): string {\n    return this._path;\n  }\n\n  /**\n   * Get the file name (with extension)\n   */\n  public get name(): string {\n    return basename(this._path);\n  }\n\n  /**\n   * Get the file extension (without dot)\n   */\n  public get extension(): string {\n    return extname(this._path).slice(1).toLowerCase();\n  }\n\n  /**\n   * Get the directory path\n   */\n  public get directory(): string {\n    return dirname(this._path);\n  }\n\n  /**\n   * Get the driver name\n   */\n  public get driver(): string {\n    return this._driver.name;\n  }\n\n  /**\n   * Check if file has been deleted\n   */\n  public get isDeleted(): boolean {\n    return this._deleted;\n  }\n\n  /**\n   * Get public URL (sync if data cached, otherwise computed)\n   */\n  public get url(): string {\n    this.ensureNotDeleted();\n    return this._data?.url || this._driver.url(this._path);\n  }\n\n  /**\n   * Get the absolute filesystem path (local driver only)\n   */\n  public get absolutePath(): string | undefined {\n    this.ensureNotDeleted();\n    if (\"path\" in this._driver && typeof this._driver.path === \"function\") {\n      return this._driver.path(this._path);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Get file hash (SHA-256, available from put operations)\n   */\n  public get hash(): string | undefined {\n    return this._data?.hash;\n  }\n\n  // ============================================================\n  // Data Methods (Lazy Loaded)\n  // ============================================================\n\n  /**\n   * Get cached file data, or fetch it if not available\n   */\n  public async data(): Promise<StorageFileData> {\n    this.ensureNotDeleted();\n    if (!this._data) {\n      // Fetch info and construct data\n      const info = await this.metadata();\n      this._data = {\n        path: info.path,\n        url: this._driver.url(this._path),\n        size: info.size,\n        hash: \"\", // Not available from metadata\n        mimeType: info.mimeType || \"application/octet-stream\",\n        driver: this._driver.name,\n      };\n    }\n    return this._data;\n  }\n\n  /**\n   * Get file size in bytes\n   */\n  public async size(): Promise<number> {\n    const data = await this.data();\n    return data.size;\n  }\n\n  /**\n   * Get MIME type\n   */\n  public async mimeType(): Promise<string> {\n    const data = await this.data();\n    return data.mimeType;\n  }\n\n  /**\n   * Get last modified date (fetches from driver)\n   */\n  public async lastModified(): Promise<Date | undefined> {\n    this.ensureNotDeleted();\n    const info = await this.metadata();\n    return info.lastModified;\n  }\n\n  /**\n   * Get ETag (cloud drivers, fetches from driver)\n   */\n  public async etag(): Promise<string | undefined> {\n    this.ensureNotDeleted();\n    const info = await this.metadata();\n    return info.etag;\n  }\n\n  // ============================================================\n  // Content Methods\n  // ============================================================\n\n  /**\n   * Get file contents as Buffer\n   */\n  public async contents(): Promise<Buffer> {\n    this.ensureNotDeleted();\n    return this._driver.get(this._path);\n  }\n\n  /**\n   * Get file contents as readable stream\n   */\n  public async stream(): Promise<Readable> {\n    this.ensureNotDeleted();\n    return this._driver.getStream(this._path);\n  }\n\n  /**\n   * Get file contents as UTF-8 text\n   */\n  public async text(): Promise<string> {\n    const buffer = await this.contents();\n    return buffer.toString(\"utf-8\");\n  }\n\n  /**\n   * Get file contents as base64 string\n   */\n  public async base64(): Promise<string> {\n    const buffer = await this.contents();\n    return buffer.toString(\"base64\");\n  }\n\n  /**\n   * Get file contents as data URL\n   */\n  public async dataUrl(): Promise<string> {\n    const [buffer, data] = await Promise.all([this.contents(), this.data()]);\n    return `data:${data.mimeType};base64,${buffer.toString(\"base64\")}`;\n  }\n\n  // ============================================================\n  // URL Methods\n  // ============================================================\n\n  /**\n   * Get a temporary signed URL\n   *\n   * @param expiresIn - Seconds until expiration (default: 3600)\n   */\n  public async temporaryUrl(expiresIn = 3600): Promise<string> {\n    this.ensureNotDeleted();\n    return this._driver.temporaryUrl(this._path, expiresIn);\n  }\n\n  // ============================================================\n  // File Operations\n  // ============================================================\n\n  /**\n   * Check if the file exists\n   */\n  public async exists(): Promise<boolean> {\n    if (this._deleted) return false;\n    return this._driver.exists(this._path);\n  }\n\n  /**\n   * Copy the file to a new location\n   *\n   * @param destination - Destination path\n   * @returns New StorageFile instance at destination\n   */\n  public async copy(destination: string): Promise<StorageFile> {\n    this.ensureNotDeleted();\n    const result = await this._driver.copy(this._path, destination);\n    return new StorageFile(destination, this._driver, result);\n  }\n\n  /**\n   * Move the file to a new location\n   *\n   * @param destination - Destination path\n   * @returns This StorageFile instance with updated path\n   */\n  public async move(destination: string): Promise<this> {\n    this.ensureNotDeleted();\n    const result = await this._driver.move(this._path, destination);\n    this._path = destination;\n    this._data = result; // Update cached data\n    return this;\n  }\n\n  /**\n   * Rename the file (move within same directory)\n   *\n   * @param newName - New file name\n   * @returns This StorageFile instance with updated path\n   */\n  public async rename(newName: string): Promise<this> {\n    const newPath = this.directory === \".\" ? newName : `${this.directory}/${newName}`;\n    return this.move(newPath);\n  }\n\n  /**\n   * Delete the file\n   *\n   * @returns true if deleted, false if not found\n   */\n  public async delete(): Promise<boolean> {\n    this.ensureNotDeleted();\n    const result = await this._driver.delete(this._path);\n    this._deleted = true;\n    return result;\n  }\n\n  // ============================================================\n  // Cloud-Specific Methods\n  // ============================================================\n\n  /**\n   * Set file visibility (cloud drivers only)\n   *\n   * @param visibility - \"public\" or \"private\"\n   * @throws Error if driver doesn't support visibility\n   */\n  public async setVisibility(visibility: FileVisibility): Promise<this> {\n    this.ensureNotDeleted();\n\n    if (!(\"setVisibility\" in this._driver)) {\n      throw new Error(\"setVisibility is only available for cloud storage drivers\");\n    }\n\n    await (this._driver as CloudStorageDriverContract).setVisibility(this._path, visibility);\n    return this;\n  }\n\n  /**\n   * Get file visibility (cloud drivers only)\n   *\n   * @throws Error if driver doesn't support visibility\n   */\n  public async getVisibility(): Promise<FileVisibility> {\n    this.ensureNotDeleted();\n\n    if (!(\"getVisibility\" in this._driver)) {\n      throw new Error(\"getVisibility is only available for cloud storage drivers\");\n    }\n\n    return (this._driver as CloudStorageDriverContract).getVisibility(this._path);\n  }\n\n  /**\n   * Set storage class (cloud drivers only)\n   *\n   * @param storageClass - Storage class (e.g., \"STANDARD\", \"GLACIER\")\n   * @throws Error if driver doesn't support storage class\n   */\n  public async setStorageClass(storageClass: string): Promise<this> {\n    this.ensureNotDeleted();\n\n    if (!(\"setStorageClass\" in this._driver)) {\n      throw new Error(\"setStorageClass is only available for cloud storage drivers\");\n    }\n\n    await (this._driver as CloudStorageDriverContract).setStorageClass(this._path, storageClass);\n    return this;\n  }\n\n  // ============================================================\n  // Utilities\n  // ============================================================\n\n  /**\n   * Ensure the file has not been deleted\n   */\n  protected ensureNotDeleted(): void {\n    if (this._deleted) {\n      throw new Error(`File \"${this._path}\" has been deleted`);\n    }\n  }\n\n  /**\n   * Create a StorageFile instance from StorageFileData\n   *\n   * @param data - Storage file data from put/copy/move operations\n   * @param driver - Driver instance\n   */\n  public static fromData(\n    data: StorageFileData | CloudStorageFileData,\n    driver: StorageDriverContract,\n  ): StorageFile {\n    return new StorageFile(data.path, driver, data);\n  }\n\n  /**\n   * Get file metadata\n   */\n  public async metadata(): Promise<StorageFileInfo> {\n    this.ensureNotDeleted();\n    return this._driver.metadata(this._path);\n  }\n\n  /**\n   * Determine if this file is an image type\n   */\n  public async isImage() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"image/\");\n  }\n\n  /**\n   * Determine if this file is a document type\n   */\n  public async isDocument() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"application/\");\n  }\n\n  /**\n   * Determine if this file is a pdf type\n   */\n  public async isPdf() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"application/pdf\");\n  }\n\n  /**\n   * Determine if this file is an excel file (any support excel file)\n   */\n  public async isExcel() {\n    const metadata = await this.metadata();\n    return (\n      metadata.mimeType!.startsWith(\n        \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n      ) || metadata.mimeType!.startsWith(\"application/vnd.ms-excel\")\n    );\n  }\n\n  /**\n   * Determine if this file is a doc file\n   */\n  public async isDoc() {\n    const metadata = await this.metadata();\n    return (\n      metadata.mimeType!.startsWith(\"application/msword\") ||\n      metadata.mimeType!.startsWith(\n        \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n      )\n    );\n  }\n\n  /**\n   * Determine if this file is an audio type\n   */\n  public async isAudio() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"audio/\");\n  }\n\n  /**\n   * Determine if this file is a video type\n   */\n  public async isVideo() {\n    const metadata = await this.metadata();\n    return metadata.mimeType!.startsWith(\"video/\");\n  }\n\n  /**\n   * Convert to plain object (returns cached data or constructs it)\n   */\n  public toJSON(): {\n    path: string;\n    name: string;\n    extension: string;\n    driver: string;\n    url: string;\n    hash?: string;\n    size?: number;\n    mimeType?: string;\n  } {\n    return {\n      path: this._path,\n      name: this.name,\n      extension: this.extension,\n      driver: this._driver.name,\n      url: this._deleted ? \"\" : this.url,\n      hash: this._data?.hash,\n      size: this._data?.size,\n      mimeType: this._data?.mimeType,\n    };\n  }\n\n  /**\n   * String representation\n   */\n  public toString(): string {\n    return this._path;\n  }\n}\n"],"mappings":"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"}

package/esm/storage/storage.d.mts

@@ -5,7 +5,7 @@ import { UploadedFile } from "../http/uploaded-file.mjs";
 import { EventSubscription } from "@mongez/events";
 import { Readable } from "stream";
 
-//#region ../@warlock.js/core/src/storage/storage.d.ts
+//#region ../core/src/storage/storage.d.ts
 /**
  * Storage Manager
  *

package/esm/storage/storage.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.mts","names":[],"sources":["../../../../../../../@warlock.js/core/src/storage/storage.ts"],"mappings":"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"}
+{"version":3,"file":"storage.d.mts","names":[],"sources":["../../../../../../../core/src/storage/storage.ts"],"mappings":"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"}

package/esm/storage/storage.mjs

@@ -11,7 +11,7 @@ import path from "path";
 import events from "@mongez/events";
 import fs from "fs";
 
-//#region ../@warlock.js/core/src/storage/storage.ts
+//#region ../core/src/storage/storage.ts
 /**
 * Storage Manager
 *