@warlock.js/core 5.29.0 → 5.31.0

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

@@ -1 +1 @@
-{"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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"}
+{"version":3,"file":"storage-file.mjs","names":[],"sources":["../../../../../../../../packages/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

@@ -1,11 +1,11 @@
 import { StorageFile } from "./storage-file.mjs";
-import { CloudStorageDriverContract, CloudStorageDriverOptions, DeleteManyResult, FileVisibility, ListOptions, LocalStorageDriverOptions, PresignedOptions, PresignedUploadOptions, PutFromUrlOptions, PutOptions, R2StorageDriverOptions, ScopedStorageContract, StorageDriverConfig, StorageDriverContract, StorageDriverName, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFileInfo, StorageManagerContract, TemporaryTokenValidation } from "./types.mjs";
 import { ScopedStorage } from "./scoped-storage.mjs";
+import { CloudStorageDriverContract, CloudStorageDriverOptions, DeleteManyResult, FileVisibility, ListOptions, LocalStorageDriverOptions, PresignedOptions, PresignedUploadOptions, PutFromUrlOptions, PutOptions, R2StorageDriverOptions, StorageDriverConfig, StorageDriverContract, StorageDriverName, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFileInfo, StorageManagerContract, TemporaryTokenValidation } from "./types.mjs";
 import { UploadedFile } from "../http/uploaded-file.mjs";
 import { EventSubscription } from "@mongez/events";
 import { Readable } from "stream";
 
-//#region ../core/src/storage/storage.d.ts
+//#region ../../packages/core/src/storage/storage.d.ts
 /**
  * Storage Manager
  *
@@ -79,6 +79,20 @@ declare class Storage extends ScopedStorage implements StorageManagerContract {
    * Called automatically on first driver access.
    */
   init(): Promise<void>;
+  /**
+   * Whether `init()` has run (and `reset()` has not run since).
+   */
+  get isInitialized(): boolean;
+  /**
+   * The names of every registered driver configuration, including the
+   * built-in `local` one. The test kit's storage fake reads it to replace
+   * every driver with a local one.
+   */
+  driverNames(): StorageDriverName[];
+  /**
+   * The name of the default driver, once initialized.
+   */
+  getDefaultName(): StorageDriverName | undefined;
   /**
    * Reset storage defaults
    */
@@ -137,7 +151,7 @@ declare class Storage extends ScopedStorage implements StorageManagerContract {
    * console.log(localFile.url);
    * ```
    */
-  use(name: StorageDriverName): ScopedStorageContract;
+  use(name: StorageDriverName): ScopedStorage;
   /**
    * Get a raw driver instance
    *

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

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

package/esm/storage/storage.mjs

@@ -7,6 +7,7 @@ import { safeFetchToBuffer } from "./utils/safe-fetch.mjs";
 import { ScopedStorage } from "./scoped-storage.mjs";
 import { storageDriverContext } from "./context/storage-driver-context.mjs";
 import { DOSpacesDriver } from "./drivers/do-spaces-driver.mjs";
+import { registerLocalDiskConfigurations } from "./local-disk-roots.mjs";
 import { LocalDriver } from "./drivers/local-driver.mjs";
 import { R2Driver } from "./drivers/r2-driver.mjs";
 import { S3Driver } from "./drivers/s3-driver.mjs";
@@ -14,7 +15,7 @@ import path from "path";
 import events from "@mongez/events";
 import fs from "fs";
 
-//#region ../core/src/storage/storage.ts
+//#region ../../packages/core/src/storage/storage.ts
 /**
 * Storage Manager
 *
@@ -66,6 +67,7 @@ var Storage = class extends ScopedStorage {
 		this.drivers = /* @__PURE__ */ new Map();
 		this.configs = /* @__PURE__ */ new Map();
 		this.initialized = false;
+		registerLocalDiskConfigurations(() => this.configs);
 	}
 	/**
 	* Ensure storage is initialized (lazy initialization)
@@ -81,6 +83,26 @@ var Storage = class extends ScopedStorage {
 		this._driver = this.resolveDriver(this.defaultDriverName);
 	}
 	/**
+	* Whether `init()` has run (and `reset()` has not run since).
+	*/
+	get isInitialized() {
+		return this.initialized;
+	}
+	/**
+	* The names of every registered driver configuration, including the
+	* built-in `local` one. The test kit's storage fake reads it to replace
+	* every driver with a local one.
+	*/
+	driverNames() {
+		return [...this.configs.keys()];
+	}
+	/**
+	* The name of the default driver, once initialized.
+	*/
+	getDefaultName() {
+		return this.defaultDriverName ?? void 0;
+	}
+	/**
 	* Reset storage defaults
 	*/
 	reset() {

package/esm/storage/storage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"storage.mjs","names":[],"sources":["../../../../../../../core/src/storage/storage.ts"],"sourcesContent":["import events, { type EventSubscription } from \"@mongez/events\";\nimport fs from \"fs\";\nimport path from \"path\";\nimport type { Readable } from \"stream\";\nimport type { UploadedFile } from \"../http\";\nimport { uploadsPath } from \"../utils/paths\";\nimport { storageConfig, storageConfigurations } from \"./config\";\nimport { storageDriverContext } from \"./context/storage-driver-context\";\nimport { DOSpacesDriver } from \"./drivers/do-spaces-driver\";\nimport { LocalDriver } from \"./drivers/local-driver\";\nimport { R2Driver } from \"./drivers/r2-driver\";\nimport { S3Driver } from \"./drivers/s3-driver\";\nimport { ScopedStorage } from \"./scoped-storage\";\nimport { StorageFile } from \"./storage-file\";\nimport { safeFetchToBuffer } from \"./utils/safe-fetch\";\nimport { StorageCapabilityError } from \"./utils/storage-capability-error\";\nimport { StorageNotInitializedError } from \"./utils/storage-not-initialized-error\";\nimport type {\n  CloudStorageDriverContract,\n  CloudStorageDriverOptions,\n  DeleteManyResult,\n  FileVisibility,\n  ListOptions,\n  LocalStorageDriverOptions,\n  PresignedOptions,\n  PresignedUploadOptions,\n  PutFromUrlOptions,\n  PutOptions,\n  R2StorageDriverOptions,\n  ScopedStorageContract,\n  StorageCopyEventPayload,\n  StorageDriverConfig,\n  StorageDriverContract,\n  StorageDriverName,\n  StorageEventHandler,\n  StorageEventPayload,\n  StorageEventType,\n  StorageFileInfo,\n  StorageManagerContract,\n  StoragePutEventPayload,\n  TemporaryTokenValidation,\n} from \"./types\";\n\n/**\n * Storage Manager\n *\n * Provides a unified interface for file storage operations across multiple\n * drivers (local, S3, R2, DigitalOcean Spaces). Extends `ScopedStorage` to\n * inherit all base operations while adding driver management and events.\n *\n * All operations return `StorageFile` instances for a consistent, rich DX.\n *\n * @example\n * ```typescript\n * // Basic usage (uses default driver)\n * const file = await storage.put(buffer, \"uploads/image.jpg\");\n *\n * // With options\n * const file = await storage.put(buffer, \"uploads/image.jpg\", {\n *   mimeType: \"image/jpeg\",\n *   cacheControl: \"max-age=31536000\"\n * });\n *\n * // Using specific driver (also returns StorageFile)\n * const file = await storage.use(\"s3\").put(buffer, \"path/to/file\");\n *\n * // Get raw driver for advanced use\n * const driver = storage.driver(\"s3\");\n * const data = await driver.put(buffer, \"path/to/file\"); // Returns StorageFileData\n *\n * // Stream operations for large files\n * const stream = await storage.getStream(\"large-file.zip\");\n * await storage.putStream(readableStream, \"output/file.zip\");\n *\n * // Batch operations\n * const results = await storage.deleteMany([\"file1.txt\", \"file2.txt\"]);\n *\n * // Event hooks\n * storage.on(\"afterPut\", ({ location, file }) => {\n *   console.log(`Uploaded ${location}`);\n * });\n * ```\n */\nexport class Storage extends ScopedStorage implements StorageManagerContract {\n  /**\n   * Registered drivers (cached instances)\n   * @internal\n   */\n  protected drivers = new Map<string, StorageDriverContract>();\n\n  /**\n   * Driver configurations\n   * @internal\n   */\n  protected configs = new Map<string, StorageDriverConfig>();\n\n  /**\n   * Default driver name\n   * @internal\n   */\n  protected defaultDriverName!: StorageDriverName;\n\n  /**\n   * Whether the storage has been initialized\n   * @internal\n   */\n  private initialized = false;\n\n  /**\n   * Create a new Storage manager instance\n   *\n   * Uses lazy initialization - driver is resolved on first access.\n   */\n  public constructor() {\n    // Temp placeholder - will be replaced on first access\n    super(null as unknown as StorageDriverContract);\n  }\n\n  /**\n   * Ensure storage is initialized (lazy initialization)\n   *\n   * Called automatically on first driver access.\n   */\n  public async init(): Promise<void> {\n    if (this.initialized) return;\n\n    // Mark as initialized FIRST to prevent infinite recursion\n    this.initialized = true;\n\n    // Get default driver name from config\n\n    const defaultName = storageConfig(\"default\", \"local\");\n\n    this.defaultDriverName = defaultName as StorageDriverName;\n    this.loadDriversFromConfig();\n\n    // Now set the actual driver\n    this._driver = this.resolveDriver(this.defaultDriverName);\n  }\n\n  /**\n   * Reset storage defaults\n   */\n  public reset(): void {\n    this.initialized = false;\n    this.drivers.clear();\n    this.configs.clear();\n    this.defaultDriverName = null as unknown as StorageDriverName;\n    this._driver = null as unknown as StorageDriverContract;\n  }\n\n  /**\n   * Get the currently active driver (context-aware in future)\n   *\n   * Currently returns the default driver.\n   * Will be enhanced to check AsyncLocalStorage context for multi-tenant support.\n   *\n   * @returns The active storage driver\n   * @throws {StorageNotInitializedError} When neither a context driver nor\n   * an initialized default driver is available\n   */\n  public override get activeDriver(): StorageDriverContract {\n    // Check context for tenant-specific driver\n    const contextDriver = storageDriverContext.getDriver();\n\n    if (contextDriver) return contextDriver;\n\n    if (!this._driver) throw new StorageNotInitializedError();\n\n    return this._driver;\n  }\n\n  // ============================================================\n  // Driver Management\n  // ============================================================\n\n  /**\n   * Load drivers from configuration\n   * @internal\n   */\n  protected loadDriversFromConfig(): void {\n    // `activeDriver` is a synchronous getter, so an async resolver can never be\n    // honoured. Fail loudly instead of silently ignoring it.\n    if (storageConfig(\"resolver\")) {\n      throw new Error(\n        \"storage.resolver is not supported: use storageDriverContext (per-request driver) for multi-tenant storage.\",\n      );\n    }\n\n    this.registerBuiltInLocalDriver();\n\n    const drivers = storageConfig<Record<string, StorageDriverConfig>>(\"drivers\", {});\n\n    for (const [name, config] of Object.entries(drivers)) {\n      this.configs.set(name, config);\n    }\n  }\n\n  /**\n   * Register the built-in `local` driver, rooted at `uploadsPath()`.\n   *\n   * The storage connector starts unconditionally — unlike database, cache and\n   * herald, it does not early-return when `config.get(\"storage\")` is absent —\n   * on the stated grounds that `init()` falls back to a built-in local driver so\n   * file storage works out of the box. That fallback did not exist: `init()`\n   * resolved the default driver *name* and then found no config registered\n   * under it, so **any app without `src/config/storage.ts` failed to boot**\n   * with `Storage driver \"local\" is not configured`. Only scaffolded apps, which\n   * always ship that file, hid it.\n   *\n   * Registered before the configured drivers so an app that defines its own\n   * `local` entry overrides this one rather than fighting it.\n   */\n  protected registerBuiltInLocalDriver(): void {\n    this.configs.set(\n      \"local\",\n      storageConfigurations.local({\n        root: uploadsPath(),\n        urlPrefix: \"/uploads\",\n      }),\n    );\n  }\n\n  /**\n   * Get a scoped storage for a specific driver\n   *\n   * Returns a `ScopedStorage` instance that wraps the specified driver.\n   * Operations on the returned instance also return `StorageFile` objects.\n   *\n   * @param name - Driver name as defined in configuration\n   * @returns ScopedStorage instance for the specified driver\n   *\n   * @example\n   * ```typescript\n   * // Upload to S3\n   * const s3File = await storage.use(\"s3\").put(buffer, \"images/photo.jpg\");\n   *\n   * // Upload to local\n   * const localFile = await storage.use(\"local\").put(buffer, \"temp/file.txt\");\n   *\n   * // Both return StorageFile with identical API\n   * console.log(s3File.url);\n   * console.log(localFile.url);\n   * ```\n   */\n  public use(name: StorageDriverName): ScopedStorageContract {\n    return new ScopedStorage(this.getDriver(name));\n  }\n\n  /**\n   * Get a raw driver instance\n   *\n   * Returns the underlying driver directly for advanced use cases.\n   * Unlike `use()`, calling methods on the raw driver returns\n   * `StorageFileData` instead of `StorageFile`.\n   *\n   * @param name - Driver name as defined in configuration\n   * @returns Raw driver instance implementing StorageDriverContract\n   *\n   * @example\n   * ```typescript\n   * const driver = storage.getDriver(\"s3\");\n   * const data = await driver.put(buffer, \"path/to/file\");\n   * // data is StorageFileData, not StorageFile\n   * ```\n   */\n  public getDriver(name: StorageDriverName): StorageDriverContract {\n    return this.resolveDriver(name);\n  }\n\n  /**\n   * Get root directory of current driver\n   */\n  public root(apepndedPath?: string): string {\n    const rootPath = this.activeDriver.options?.root || \"\";\n\n    return path.join(rootPath, apepndedPath || \"\");\n  }\n\n  /**\n   * Use a cloud storage driver with extended cloud capabilities\n   *\n   * @param name - Cloud driver name (s3, r2, spaces)\n   * @returns Driver instance implementing CloudStorageDriverContract\n   * @throws Error if driver doesn't support cloud operations\n   *\n   * @example\n   * ```typescript\n   * const cloudDriver = storage.useCloud(\"s3\");\n   * const presignedUrl = await cloudDriver.getPresignedUrl(\"private/doc.pdf\");\n   * ```\n   */\n  public useCloud(name: StorageDriverName): CloudStorageDriverContract {\n    const instance = this.getDriver(name);\n\n    if (!this.isCloudDriver(instance)) {\n      throw new Error(`Driver \"${name}\" does not support cloud operations`);\n    }\n\n    return instance as CloudStorageDriverContract;\n  }\n\n  /**\n   * Register a new driver configuration at runtime\n   *\n   * Allows dynamic driver registration for multi-tenancy or\n   * runtime configuration scenarios.\n   *\n   * @param name - Unique driver name\n   * @param config - Driver configuration\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * storage.register(\"tenant-s3\", {\n   *   driver: \"s3\",\n   *   bucket: \"tenant-bucket\",\n   *   region: \"us-east-1\",\n   *   accessKeyId: process.env.TENANT_AWS_KEY,\n   *   secretAccessKey: process.env.TENANT_AWS_SECRET\n   * });\n   *\n   * await storage.use(\"tenant-s3\").put(buffer, \"file.txt\");\n   * ```\n   */\n  public register(name: StorageDriverName, config: StorageDriverConfig): this {\n    this.configs.set(name, config);\n    this.drivers.delete(name); // Clear cached instance\n    return this;\n  }\n\n  /**\n   * Set the default driver name\n   *\n   * @param name - Driver name to use as default\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * storage.setDefault(\"s3\");\n   * await storage.put(buffer, \"file.txt\"); // Now uses S3\n   * ```\n   */\n  public setDefault(name: StorageDriverName): this {\n    this.defaultDriverName = name;\n    this._driver = this.getDriver(name);\n    return this;\n  }\n\n  /**\n   * Check if current driver is a cloud driver\n   *\n   * @returns Promise resolving to true if the current driver supports cloud operations\n   */\n  public async isCloud(): Promise<boolean> {\n    return this.isCloudDriver(this.activeDriver);\n  }\n\n  /**\n   * Check if a driver instance supports cloud operations\n   * @internal\n   */\n  protected isCloudDriver(driver: StorageDriverContract): driver is CloudStorageDriverContract {\n    return \"getPresignedUrl\" in driver;\n  }\n\n  // ============================================================\n  // Event System\n  // ============================================================\n\n  /**\n   * Register an event handler\n   *\n   * Subscribe to storage events for logging, analytics, or side effects.\n   *\n   * @param event - Event type to listen for\n   * @param handler - Handler function\n   * @returns Event subscription for unsubscribing\n   *\n   * @example\n   * ```typescript\n   * // Log all uploads\n   * storage.on(\"afterPut\", ({ location, file }) => {\n   *   console.log(`Uploaded ${file?.size} bytes to ${location}`);\n   * });\n   *\n   * // Track deletions\n   * storage.on(\"afterDelete\", ({ location }) => {\n   *   analytics.track(\"file_deleted\", { path: location });\n   * });\n   * ```\n   */\n  public on<T extends StorageEventPayload = StorageEventPayload>(\n    event: StorageEventType,\n    handler: StorageEventHandler<T>,\n  ): EventSubscription {\n    return events.subscribe(`storage.${event}`, handler);\n  }\n\n  /**\n   * Remove all handlers for an event type\n   *\n   * @param event - Event type to remove handlers for\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * storage.off(\"afterPut\"); // Remove all afterPut handlers\n   * ```\n   */\n  public off(event: StorageEventType): this {\n    events.off(`storage.${event}`);\n    return this;\n  }\n\n  /**\n   * Emit an event to all registered handlers\n   * @internal\n   */\n  protected async emit<T extends StorageEventPayload>(\n    event: StorageEventType,\n    payload: T,\n  ): Promise<void> {\n    // `triggerAll` is synchronous — it never awaits its handlers, so awaiting it\n    // would make async listeners fire-and-forget. `triggerAllAsync` takes the\n    // same `(event, ...args)` shape and awaits each handler in turn.\n    await events.triggerAllAsync(`storage.${event}`, payload);\n  }\n\n  // ============================================================\n  // Overridden Operations with Events\n  // ============================================================\n\n  /**\n   * Store a file in storage\n   *\n   * Extends base `put()` with event emission for beforePut/afterPut hooks.\n   *\n   * @param file - File content as Buffer, string, UploadedFile, or Readable stream\n   * @param location - Destination path\n   * @param options - Storage options (mimeType, cacheControl, etc.)\n   * @returns StorageFile instance with cached metadata\n   */\n  public override async put(\n    file: UploadedFile | Buffer | string | Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    const driver = this.activeDriver;\n    const buffer = await this.toBuffer(file);\n\n    await this.emit<StoragePutEventPayload>(\"beforePut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      size: buffer.length,\n    });\n\n    const result = await driver.put(buffer, location, options);\n\n    await this.emit<StoragePutEventPayload>(\"afterPut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    if (!result.size) {\n      result.size = buffer.length;\n    }\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * Atomically store a file only if nothing exists at `location`.\n   *\n   * Emits the same beforePut/afterPut events as `put()` when the file is\n   * written; emits nothing when the location already exists (`null`).\n   * Because the outcome is unknown until the driver returns, both events\n   * fire after the write, for the winner only.\n   *\n   * @throws StorageCapabilityError when the driver has no `putIfAbsent`\n   */\n  public override async putIfAbsent(\n    file: Buffer | string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile | null> {\n    const driver = this.activeDriver;\n\n    if (typeof driver.putIfAbsent !== \"function\") {\n      throw new StorageCapabilityError(\"putIfAbsent\", driver.name);\n    }\n\n    const result = await driver.putIfAbsent(file, location, options);\n\n    if (!result) {\n      return null;\n    }\n\n    const size = typeof file === \"string\" ? Buffer.byteLength(file) : file.length;\n\n    await this.emit<StoragePutEventPayload>(\"beforePut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      size,\n    });\n\n    await this.emit<StoragePutEventPayload>(\"afterPut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    if (!result.size) {\n      result.size = size;\n    }\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * Store a file from a readable stream (for large files)\n   *\n   * Extends base `putStream()` with event emission.\n   *\n   * @param stream - Readable stream\n   * @param location - Destination path\n   * @param options - Storage options\n   * @returns StorageFile instance with cached metadata\n   */\n  public override async putStream(\n    stream: Readable | string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    const driver = this.activeDriver;\n\n    await this.emit<StoragePutEventPayload>(\"beforePut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n    });\n\n    if (typeof stream === \"string\") {\n      stream = fs.createReadStream(stream);\n    }\n\n    const result = await driver.putStream(stream, location, options);\n\n    await this.emit<StoragePutEventPayload>(\"afterPut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * Store a file from a URL\n   *\n   * Downloads content from the URL and stores it at the specified location.\n   *\n   * The download is SSRF-guarded by default: the URL scheme must be\n   * https/http, the host must not resolve to a private / loopback /\n   * link-local / cloud-metadata address, the body is capped, and the\n   * request times out. Tune or relax via the {@link PutFromUrlOptions}\n   * guard fields.\n   *\n   * @param url - Source URL to download from\n   * @param location - Destination path\n   * @param options - Storage + outbound-download guard options\n   * @returns StorageFile instance with cached metadata\n   *\n   * @example\n   * ```typescript\n   * const file = await storage.putFromUrl(\n   *   \"https://example.com/image.jpg\",\n   *   \"downloads/image.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 } = 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 && !putOptions.mimeType) {\n      throw new Error(`Failed to fetch file from URL: missing content-type header`);\n    }\n\n    const mimeType = putOptions.mimeType || result.contentType || undefined;\n\n    return this.put(result.buffer, location, { ...putOptions, mimeType });\n  }\n\n  /**\n   * Store a file from base64 encoded string\n   *\n   * Decodes base64 content (with optional data URL prefix) and stores it.\n   *\n   * @param base64 - Base64 encoded file content (or data URL)\n   * @param location - Destination path\n   * @param options - Storage options\n   * @returns StorageFile instance with cached metadata\n   *\n   * @example\n   * ```typescript\n   * // From plain base64\n   * const file = await storage.putFromBase64(base64String, \"images/photo.jpg\");\n   *\n   * // From data URL (auto-extracts MIME type)\n   * const file = await storage.putFromBase64(\n   *   \"data:image/png;base64,iVBORw0KGgo...\",\n   *   \"images/photo.png\"\n   * );\n   * ```\n   */\n  public async putFromBase64(\n    base64: string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    let data = base64;\n    let mimeType = options?.mimeType;\n\n    if (base64.startsWith(\"data:\")) {\n      const match = base64.match(/^data:([^;]+);base64,(.+)$/);\n      if (match) {\n        const matchedMimeType = match[1];\n        const matchedData = match[2];\n\n        if (matchedMimeType !== undefined && matchedData !== undefined) {\n          mimeType = mimeType || matchedMimeType;\n          data = matchedData;\n        }\n      }\n    }\n\n    const buffer = Buffer.from(data, \"base64\");\n    return this.put(buffer, location, { ...options, mimeType });\n  }\n\n  /**\n   * Retrieve file contents as Buffer\n   *\n   * Uses the current driver (with async resolution).\n   *\n   * @param location - File path\n   * @returns Buffer containing file contents\n   */\n  public override async get(location: string): Promise<Buffer> {\n    return this.activeDriver.get(location);\n  }\n\n  /**\n   * Get JSON content from a file\n   *\n   * Downloads and parses JSON file content.\n   *\n   * @param location - File path\n   * @returns Parsed JSON content\n   *\n   * @example\n   * ```typescript\n   * const config = await storage.getJson(\"config/settings.json\");\n   * console.log(config.apiKey);\n   * ```\n   */\n  public async getJson(location: string): Promise<any> {\n    const buffer = await this.get(location);\n    return JSON.parse(buffer.toString());\n  }\n\n  /**\n   * Retrieve a file as a readable stream (for large files)\n   *\n   * @param location - File path\n   * @returns Readable stream of file contents\n   */\n  public override async getStream(location: string): Promise<Readable> {\n    return this.activeDriver.getStream(location);\n  }\n\n  /**\n   * Delete a file\n   *\n   * Extends base `delete()` with event emission.\n   *\n   * @param location - File path or StorageFile\n   * @returns true if deleted, false if not found\n   */\n  public override async delete(location: string | StorageFile): Promise<boolean> {\n    const driver = this.activeDriver;\n    const path = typeof location === \"string\" ? location : location.path;\n\n    await this.emit<StorageEventPayload>(\"beforeDelete\", {\n      driver: driver.name,\n      location: path,\n      timestamp: new Date(),\n    });\n\n    const result = await driver.delete(path);\n\n    await this.emit<StorageEventPayload>(\"afterDelete\", {\n      driver: driver.name,\n      location: path,\n      timestamp: new Date(),\n    });\n\n    return result;\n  }\n\n  /**\n   * Delete multiple files at once\n   *\n   * @param locations - Array of file paths\n   * @returns Array of delete results with status for each file\n   */\n  public override async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    return this.activeDriver.deleteMany(locations);\n  }\n\n  /**\n   * Check if a file exists\n   *\n   * @param location - File path\n   * @returns true if file exists\n   */\n  public override 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   * Extends base `copy()` with event emission.\n   *\n   * @param from - Source path or StorageFile\n   * @param to - Destination path\n   * @returns StorageFile instance at destination\n   */\n  public override async copy(from: string | StorageFile, to: string): Promise<StorageFile> {\n    const driver = this.activeDriver;\n    const fromPath = typeof from === \"string\" ? from : from.path;\n\n    await this.emit<StorageCopyEventPayload>(\"beforeCopy\", {\n      driver: driver.name,\n      location: to,\n      from: fromPath,\n      to,\n      timestamp: new Date(),\n    });\n\n    const result = await driver.copy(fromPath, to);\n\n    await this.emit<StorageCopyEventPayload>(\"afterCopy\", {\n      driver: driver.name,\n      location: to,\n      from: fromPath,\n      to,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * Move a file to a new location\n   *\n   * Extends base `move()` with event emission.\n   *\n   * @param from - Source path or StorageFile\n   * @param to - Destination path\n   * @returns StorageFile instance at destination\n   */\n  public override async move(from: string | StorageFile, to: string): Promise<StorageFile> {\n    const driver = this.activeDriver;\n    const fromPath = typeof from === \"string\" ? from : from.path;\n\n    await this.emit<StorageCopyEventPayload>(\"beforeMove\", {\n      driver: driver.name,\n      location: to,\n      from: fromPath,\n      to,\n      timestamp: new Date(),\n    });\n\n    const result = await driver.move(fromPath, to);\n\n    await this.emit<StorageCopyEventPayload>(\"afterMove\", {\n      driver: driver.name,\n      location: to,\n      from: fromPath,\n      to,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * List files in a directory\n   *\n   * @param directory - Directory path (defaults to root)\n   * @param options - List options (recursive, limit, etc.)\n   * @returns Array of file information objects\n   */\n  public override async list(\n    directory?: string,\n    options?: ListOptions,\n  ): Promise<StorageFileInfo[]> {\n    return this.activeDriver.list(directory || \"\", options);\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file metadata without downloading\n   *\n   * @param location - File path\n   * @returns File information object\n   */\n  public override async metadata(location: string): Promise<StorageFileInfo> {\n    return this.activeDriver.metadata(location);\n  }\n\n  /**\n   * Get file size in bytes\n   *\n   * @param location - File path\n   * @returns File size in bytes\n   */\n  public override async size(location: string): Promise<number> {\n    return this.activeDriver.size(location);\n  }\n\n  // ============================================================\n  // Path Operations (Local Driver Only)\n  // ============================================================\n\n  /**\n   * Get the absolute filesystem path for a location\n   *\n   * Only available for local driver.\n   *\n   * @param location - File path\n   * @throws Error if current driver is not a local driver\n   * @returns Absolute filesystem path\n   */\n  public async path(location: string): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!(\"path\" in driver) || typeof driver.path !== \"function\") {\n      throw new Error(\"path() is only available for local storage drivers\");\n    }\n\n    return driver.path(location);\n  }\n\n  // ============================================================\n  // Cloud-Specific Operations\n  // ============================================================\n\n  /**\n   * Get a presigned URL for downloading a file\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - File path\n   * @param options - Presigned URL options (expiresIn)\n   * @throws Error if current driver is not a cloud driver\n   * @returns Presigned download URL\n   *\n   * @example\n   * ```typescript\n   * const url = await storage.getPresignedUrl(\"private/document.pdf\", {\n   *   expiresIn: 3600 // 1 hour\n   * });\n   * ```\n   */\n  public async getPresignedUrl(location: string, options?: PresignedOptions): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Presigned URLs are only available for cloud storage drivers\");\n    }\n\n    return driver.getPresignedUrl(location, options);\n  }\n\n  /**\n   * Get a presigned URL for uploading a file directly to cloud storage\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - Destination path\n   * @param options - Upload options (expiresIn, contentType, metadata).\n   *   There is no size cap: a presigned PUT URL cannot enforce one — verify\n   *   the uploaded size server-side or use a presigned POST policy instead.\n   * @throws Error if current driver is not a cloud driver\n   * @returns Presigned upload URL\n   *\n   * @example\n   * ```typescript\n   * const uploadUrl = await storage.getPresignedUploadUrl(\"uploads/file.pdf\", {\n   *   expiresIn: 3600,\n   *   contentType: \"application/pdf\"\n   * });\n   *\n   * // Client can PUT directly to this URL\n   * ```\n   */\n  public async getPresignedUploadUrl(\n    location: string,\n    options?: PresignedUploadOptions,\n  ): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Presigned upload URLs are only available for cloud storage drivers\");\n    }\n\n    return driver.getPresignedUploadUrl(location, options);\n  }\n\n  /**\n   * Get the bucket name for cloud storage\n   *\n   * Only available for cloud drivers.\n   *\n   * @throws Error if current driver is not a cloud driver\n   * @returns Bucket name\n   */\n  public async getBucket(): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Bucket information is only available for cloud storage drivers\");\n    }\n\n    return driver.getBucket();\n  }\n\n  /**\n   * Get the region for cloud storage\n   *\n   * Only available for cloud drivers.\n   *\n   * @throws Error if current driver is not a cloud driver\n   * @returns Region name\n   */\n  public async getRegion(): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Region information is only available for cloud storage drivers\");\n    }\n\n    return driver.getRegion();\n  }\n\n  /**\n   * Set storage class for a file (e.g., STANDARD, GLACIER, etc.)\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - File path\n   * @param storageClass - Target storage class\n   * @throws Error if current driver is not a cloud driver\n   */\n  public async setStorageClass(location: string, storageClass: string): Promise<void> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Storage class is only available for cloud storage drivers\");\n    }\n\n    return driver.setStorageClass(location, storageClass);\n  }\n\n  /**\n   * Set file visibility (public or private)\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - File path\n   * @param visibility - \"public\" or \"private\"\n   * @throws Error if current driver is not a cloud driver\n   */\n  public async setVisibility(location: string, visibility: FileVisibility): Promise<void> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Visibility is only available for cloud storage drivers\");\n    }\n\n    return driver.setVisibility(location, visibility);\n  }\n\n  /**\n   * Get file visibility\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - File path\n   * @throws Error if current driver is not a cloud driver\n   * @returns Current visibility setting\n   */\n  public async getVisibility(location: string): Promise<FileVisibility> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Visibility is only available for cloud storage drivers\");\n    }\n\n    return driver.getVisibility(location);\n  }\n\n  /**\n   * Get a temporary signed URL\n   *\n   * Creates a URL that provides temporary access to the file.\n   *\n   * @param location - File path\n   * @param expiresIn - Seconds until expiration (default: 3600)\n   * @returns Signed URL string\n   */\n  public override async temporaryUrl(location: string, expiresIn?: number): Promise<string> {\n    return this.activeDriver.temporaryUrl(location, expiresIn);\n  }\n\n  /**\n   * Validate a temporary URL token\n   *\n   * For local driver: validates HMAC-signed tokens\n   * For cloud drivers: returns invalid (cloud validates via presigned URL)\n   *\n   * @param token - The token from the temporary URL\n   * @returns Validation result with file info and convenience methods\n   *\n   * @example\n   * ```typescript\n   * const result = await storage.validateTemporaryToken(token);\n   *\n   * if (!result.valid) {\n   *   return response.status(403).send(result.error);\n   * }\n   *\n   * // For local driver - use sendFile for efficiency\n   * if (result.absolutePath) {\n   *   return response.sendFile(result.absolutePath);\n   * }\n   *\n   * // For cloud driver - stream the file\n   * const stream = await result.getStream!();\n   * stream.pipe(response.raw);\n   * ```\n   */\n  public async validateTemporaryToken(token: string): Promise<TemporaryTokenValidation> {\n    // Check if driver supports token validation\n    if (\n      !(\"validateTemporaryToken\" in this.activeDriver) ||\n      typeof this.activeDriver.validateTemporaryToken !== \"function\"\n    ) {\n      // For cloud drivers, temporary URLs are presigned and validated by the cloud provider\n      return {\n        valid: false,\n        error: \"invalid_token\",\n      };\n    }\n\n    return this.activeDriver.validateTemporaryToken(token);\n  }\n\n  // ============================================================\n  // Configuration Parsing\n  // ============================================================\n\n  /**\n   * Parse config into driver-specific options\n   * @internal\n   */\n  protected parseOptions(\n    config: StorageDriverConfig,\n  ): LocalStorageDriverOptions | CloudStorageDriverOptions | R2StorageDriverOptions {\n    const { driver, ...options } = config;\n\n    switch (driver) {\n      case \"local\":\n        return {\n          root: options.root,\n          prefix: options.prefix,\n          urlPrefix: options.urlPrefix,\n          temporaryUrlPrefix: options.temporaryUrlPrefix,\n          signatureKey: options.signatureKey,\n        } satisfies LocalStorageDriverOptions;\n\n      case \"s3\":\n        this.validateCloudConfig(config, \"s3\");\n        return {\n          ...options,\n          bucket: options.bucket!,\n          region: options.region!,\n          accessKeyId: options.accessKeyId,\n          secretAccessKey: options.secretAccessKey,\n          endpoint: options.endpoint,\n          urlPrefix: options.urlPrefix,\n        } satisfies CloudStorageDriverOptions;\n\n      case \"r2\":\n        this.validateCloudConfig(config, \"r2\");\n        if (!options.accountId) {\n          throw new Error('R2 driver requires \"accountId\" configuration');\n        }\n\n        return {\n          ...options,\n          region: options.region || \"auto\",\n          bucket: options.bucket!,\n          accessKeyId: options.accessKeyId,\n          secretAccessKey: options.secretAccessKey,\n          endpoint: options.endpoint,\n          urlPrefix: options.urlPrefix,\n          accountId: options.accountId,\n          publicDomain: options.publicDomain,\n        } satisfies R2StorageDriverOptions;\n\n      case \"spaces\":\n        this.validateCloudConfig(config, \"spaces\");\n        return {\n          ...options,\n          bucket: options.bucket!,\n          region: options.region!,\n          accessKeyId: options.accessKeyId,\n          secretAccessKey: options.secretAccessKey,\n          endpoint: options.endpoint,\n          urlPrefix: options.urlPrefix,\n        } satisfies CloudStorageDriverOptions;\n\n      default:\n        throw new Error(`Unknown driver type: ${driver}`);\n    }\n  }\n\n  /**\n   * Validate cloud driver configuration has required fields\n   * @internal\n   */\n  protected validateCloudConfig(config: StorageDriverConfig, driverName: string): void {\n    // Credentials are optional: when absent, the AWS default provider chain\n    // applies (IAM roles, ECS task roles, IRSA, SSO profiles).\n    const required = [\"bucket\"];\n\n    if (driverName !== \"r2\") {\n      required.push(\"region\");\n    }\n\n    for (const field of required) {\n      if (!config[field as keyof StorageDriverConfig]) {\n        throw new Error(`${driverName.toUpperCase()} driver requires \"${field}\" configuration`);\n      }\n    }\n\n    if (Boolean(config.accessKeyId) !== Boolean(config.secretAccessKey)) {\n      throw new Error(\n        `${driverName.toUpperCase()} driver requires both \"accessKeyId\" and \"secretAccessKey\", or neither`,\n      );\n    }\n  }\n\n  /**\n   * Get or create driver instance from cache\n   * @internal\n   */\n  protected resolveDriver(name: string): StorageDriverContract {\n    // Ensure configs are loaded\n\n    if (this.drivers.has(name)) {\n      return this.drivers.get(name)!;\n    }\n\n    const config = this.configs.get(name);\n\n    if (!config) {\n      throw new Error(`Storage driver \"${name}\" is not configured`);\n    }\n\n    const options = this.parseOptions(config);\n    let driver: StorageDriverContract;\n\n    switch (config.driver) {\n      case \"local\":\n        driver = new LocalDriver(options as LocalStorageDriverOptions);\n        break;\n      case \"s3\":\n        driver = new S3Driver(options as CloudStorageDriverOptions);\n        break;\n      case \"r2\":\n        driver = new R2Driver(options as R2StorageDriverOptions);\n        break;\n      case \"spaces\":\n        driver = new DOSpacesDriver(options as CloudStorageDriverOptions);\n        break;\n      default:\n        throw new Error(`Unknown storage driver type: ${config.driver}`);\n    }\n\n    this.drivers.set(name, driver);\n    return driver;\n  }\n}\n\n/**\n * Singleton storage instance\n *\n * Pre-configured storage manager ready for use throughout the application.\n *\n * @example\n * ```typescript\n * import { storage } from \"@warlock.js/core\";\n *\n * const file = await storage.put(buffer, \"uploads/file.txt\");\n * ```\n */\nexport const storage = new Storage();\n"],"mappings":"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"}
+{"version":3,"file":"storage.mjs","names":[],"sources":["../../../../../../../../packages/core/src/storage/storage.ts"],"sourcesContent":["import events, { type EventSubscription } from \"@mongez/events\";\nimport fs from \"fs\";\nimport path from \"path\";\nimport type { Readable } from \"stream\";\nimport type { UploadedFile } from \"../http\";\nimport { uploadsPath } from \"../utils/paths\";\nimport { storageConfig, storageConfigurations } from \"./config\";\nimport { storageDriverContext } from \"./context/storage-driver-context\";\nimport { DOSpacesDriver } from \"./drivers/do-spaces-driver\";\nimport { LocalDriver } from \"./drivers/local-driver\";\nimport { R2Driver } from \"./drivers/r2-driver\";\nimport { S3Driver } from \"./drivers/s3-driver\";\nimport { ScopedStorage } from \"./scoped-storage\";\nimport { StorageFile } from \"./storage-file\";\nimport { registerLocalDiskConfigurations } from \"./local-disk-roots\";\nimport { safeFetchToBuffer } from \"./utils/safe-fetch\";\nimport { StorageCapabilityError } from \"./utils/storage-capability-error\";\nimport { StorageNotInitializedError } from \"./utils/storage-not-initialized-error\";\nimport type {\n  CloudStorageDriverContract,\n  CloudStorageDriverOptions,\n  DeleteManyResult,\n  FileVisibility,\n  ListOptions,\n  LocalStorageDriverOptions,\n  PresignedOptions,\n  PresignedUploadOptions,\n  PutFromUrlOptions,\n  PutOptions,\n  R2StorageDriverOptions,\n  StorageCopyEventPayload,\n  StorageDriverConfig,\n  StorageDriverContract,\n  StorageDriverName,\n  StorageEventHandler,\n  StorageEventPayload,\n  StorageEventType,\n  StorageFileInfo,\n  StorageManagerContract,\n  StoragePutEventPayload,\n  TemporaryTokenValidation,\n} from \"./types\";\n\n/**\n * Storage Manager\n *\n * Provides a unified interface for file storage operations across multiple\n * drivers (local, S3, R2, DigitalOcean Spaces). Extends `ScopedStorage` to\n * inherit all base operations while adding driver management and events.\n *\n * All operations return `StorageFile` instances for a consistent, rich DX.\n *\n * @example\n * ```typescript\n * // Basic usage (uses default driver)\n * const file = await storage.put(buffer, \"uploads/image.jpg\");\n *\n * // With options\n * const file = await storage.put(buffer, \"uploads/image.jpg\", {\n *   mimeType: \"image/jpeg\",\n *   cacheControl: \"max-age=31536000\"\n * });\n *\n * // Using specific driver (also returns StorageFile)\n * const file = await storage.use(\"s3\").put(buffer, \"path/to/file\");\n *\n * // Get raw driver for advanced use\n * const driver = storage.driver(\"s3\");\n * const data = await driver.put(buffer, \"path/to/file\"); // Returns StorageFileData\n *\n * // Stream operations for large files\n * const stream = await storage.getStream(\"large-file.zip\");\n * await storage.putStream(readableStream, \"output/file.zip\");\n *\n * // Batch operations\n * const results = await storage.deleteMany([\"file1.txt\", \"file2.txt\"]);\n *\n * // Event hooks\n * storage.on(\"afterPut\", ({ location, file }) => {\n *   console.log(`Uploaded ${location}`);\n * });\n * ```\n */\nexport class Storage extends ScopedStorage implements StorageManagerContract {\n  /**\n   * Registered drivers (cached instances)\n   * @internal\n   */\n  protected drivers = new Map<string, StorageDriverContract>();\n\n  /**\n   * Driver configurations\n   * @internal\n   */\n  protected configs = new Map<string, StorageDriverConfig>();\n\n  /**\n   * Default driver name\n   * @internal\n   */\n  protected defaultDriverName!: StorageDriverName;\n\n  /**\n   * Whether the storage has been initialized\n   * @internal\n   */\n  private initialized = false;\n\n  /**\n   * Create a new Storage manager instance\n   *\n   * Uses lazy initialization - driver is resolved on first access.\n   */\n  public constructor() {\n    // Temp placeholder - will be replaced on first access\n    super(null as unknown as StorageDriverContract);\n    registerLocalDiskConfigurations(() => this.configs);\n  }\n\n  /**\n   * Ensure storage is initialized (lazy initialization)\n   *\n   * Called automatically on first driver access.\n   */\n  public async init(): Promise<void> {\n    if (this.initialized) return;\n\n    // Mark as initialized FIRST to prevent infinite recursion\n    this.initialized = true;\n\n    // Get default driver name from config\n\n    const defaultName = storageConfig(\"default\", \"local\");\n\n    this.defaultDriverName = defaultName as StorageDriverName;\n    this.loadDriversFromConfig();\n\n    // Now set the actual driver\n    this._driver = this.resolveDriver(this.defaultDriverName);\n  }\n\n  /**\n   * Whether `init()` has run (and `reset()` has not run since).\n   */\n  public get isInitialized(): boolean {\n    return this.initialized;\n  }\n\n  /**\n   * The names of every registered driver configuration, including the\n   * built-in `local` one. The test kit's storage fake reads it to replace\n   * every driver with a local one.\n   */\n  public driverNames(): StorageDriverName[] {\n    return [...this.configs.keys()] as StorageDriverName[];\n  }\n\n  /**\n   * The name of the default driver, once initialized.\n   */\n  public getDefaultName(): StorageDriverName | undefined {\n    return this.defaultDriverName ?? undefined;\n  }\n\n  /**\n   * Reset storage defaults\n   */\n  public reset(): void {\n    this.initialized = false;\n    this.drivers.clear();\n    this.configs.clear();\n    this.defaultDriverName = null as unknown as StorageDriverName;\n    this._driver = null as unknown as StorageDriverContract;\n  }\n\n  /**\n   * Get the currently active driver (context-aware in future)\n   *\n   * Currently returns the default driver.\n   * Will be enhanced to check AsyncLocalStorage context for multi-tenant support.\n   *\n   * @returns The active storage driver\n   * @throws {StorageNotInitializedError} When neither a context driver nor\n   * an initialized default driver is available\n   */\n  public override get activeDriver(): StorageDriverContract {\n    // Check context for tenant-specific driver\n    const contextDriver = storageDriverContext.getDriver();\n\n    if (contextDriver) return contextDriver;\n\n    if (!this._driver) throw new StorageNotInitializedError();\n\n    return this._driver;\n  }\n\n  // ============================================================\n  // Driver Management\n  // ============================================================\n\n  /**\n   * Load drivers from configuration\n   * @internal\n   */\n  protected loadDriversFromConfig(): void {\n    // `activeDriver` is a synchronous getter, so an async resolver can never be\n    // honoured. Fail loudly instead of silently ignoring it.\n    if (storageConfig(\"resolver\")) {\n      throw new Error(\n        \"storage.resolver is not supported: use storageDriverContext (per-request driver) for multi-tenant storage.\",\n      );\n    }\n\n    this.registerBuiltInLocalDriver();\n\n    const drivers = storageConfig<Record<string, StorageDriverConfig>>(\"drivers\", {});\n\n    for (const [name, config] of Object.entries(drivers)) {\n      this.configs.set(name, config);\n    }\n  }\n\n  /**\n   * Register the built-in `local` driver, rooted at `uploadsPath()`.\n   *\n   * The storage connector starts unconditionally — unlike database, cache and\n   * herald, it does not early-return when `config.get(\"storage\")` is absent —\n   * on the stated grounds that `init()` falls back to a built-in local driver so\n   * file storage works out of the box. That fallback did not exist: `init()`\n   * resolved the default driver *name* and then found no config registered\n   * under it, so **any app without `src/config/storage.ts` failed to boot**\n   * with `Storage driver \"local\" is not configured`. Only scaffolded apps, which\n   * always ship that file, hid it.\n   *\n   * Registered before the configured drivers so an app that defines its own\n   * `local` entry overrides this one rather than fighting it.\n   */\n  protected registerBuiltInLocalDriver(): void {\n    this.configs.set(\n      \"local\",\n      storageConfigurations.local({\n        root: uploadsPath(),\n        urlPrefix: \"/uploads\",\n      }),\n    );\n  }\n\n  /**\n   * Get a scoped storage for a specific driver\n   *\n   * Returns a `ScopedStorage` instance that wraps the specified driver.\n   * Operations on the returned instance also return `StorageFile` objects.\n   *\n   * @param name - Driver name as defined in configuration\n   * @returns ScopedStorage instance for the specified driver\n   *\n   * @example\n   * ```typescript\n   * // Upload to S3\n   * const s3File = await storage.use(\"s3\").put(buffer, \"images/photo.jpg\");\n   *\n   * // Upload to local\n   * const localFile = await storage.use(\"local\").put(buffer, \"temp/file.txt\");\n   *\n   * // Both return StorageFile with identical API\n   * console.log(s3File.url);\n   * console.log(localFile.url);\n   * ```\n   */\n  public use(name: StorageDriverName): ScopedStorage {\n    return new ScopedStorage(this.getDriver(name));\n  }\n\n  /**\n   * Get a raw driver instance\n   *\n   * Returns the underlying driver directly for advanced use cases.\n   * Unlike `use()`, calling methods on the raw driver returns\n   * `StorageFileData` instead of `StorageFile`.\n   *\n   * @param name - Driver name as defined in configuration\n   * @returns Raw driver instance implementing StorageDriverContract\n   *\n   * @example\n   * ```typescript\n   * const driver = storage.getDriver(\"s3\");\n   * const data = await driver.put(buffer, \"path/to/file\");\n   * // data is StorageFileData, not StorageFile\n   * ```\n   */\n  public getDriver(name: StorageDriverName): StorageDriverContract {\n    return this.resolveDriver(name);\n  }\n\n  /**\n   * Get root directory of current driver\n   */\n  public root(apepndedPath?: string): string {\n    const rootPath = this.activeDriver.options?.root || \"\";\n\n    return path.join(rootPath, apepndedPath || \"\");\n  }\n\n  /**\n   * Use a cloud storage driver with extended cloud capabilities\n   *\n   * @param name - Cloud driver name (s3, r2, spaces)\n   * @returns Driver instance implementing CloudStorageDriverContract\n   * @throws Error if driver doesn't support cloud operations\n   *\n   * @example\n   * ```typescript\n   * const cloudDriver = storage.useCloud(\"s3\");\n   * const presignedUrl = await cloudDriver.getPresignedUrl(\"private/doc.pdf\");\n   * ```\n   */\n  public useCloud(name: StorageDriverName): CloudStorageDriverContract {\n    const instance = this.getDriver(name);\n\n    if (!this.isCloudDriver(instance)) {\n      throw new Error(`Driver \"${name}\" does not support cloud operations`);\n    }\n\n    return instance as CloudStorageDriverContract;\n  }\n\n  /**\n   * Register a new driver configuration at runtime\n   *\n   * Allows dynamic driver registration for multi-tenancy or\n   * runtime configuration scenarios.\n   *\n   * @param name - Unique driver name\n   * @param config - Driver configuration\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * storage.register(\"tenant-s3\", {\n   *   driver: \"s3\",\n   *   bucket: \"tenant-bucket\",\n   *   region: \"us-east-1\",\n   *   accessKeyId: process.env.TENANT_AWS_KEY,\n   *   secretAccessKey: process.env.TENANT_AWS_SECRET\n   * });\n   *\n   * await storage.use(\"tenant-s3\").put(buffer, \"file.txt\");\n   * ```\n   */\n  public register(name: StorageDriverName, config: StorageDriverConfig): this {\n    this.configs.set(name, config);\n    this.drivers.delete(name); // Clear cached instance\n    return this;\n  }\n\n  /**\n   * Set the default driver name\n   *\n   * @param name - Driver name to use as default\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * storage.setDefault(\"s3\");\n   * await storage.put(buffer, \"file.txt\"); // Now uses S3\n   * ```\n   */\n  public setDefault(name: StorageDriverName): this {\n    this.defaultDriverName = name;\n    this._driver = this.getDriver(name);\n    return this;\n  }\n\n  /**\n   * Check if current driver is a cloud driver\n   *\n   * @returns Promise resolving to true if the current driver supports cloud operations\n   */\n  public async isCloud(): Promise<boolean> {\n    return this.isCloudDriver(this.activeDriver);\n  }\n\n  /**\n   * Check if a driver instance supports cloud operations\n   * @internal\n   */\n  protected isCloudDriver(driver: StorageDriverContract): driver is CloudStorageDriverContract {\n    return \"getPresignedUrl\" in driver;\n  }\n\n  // ============================================================\n  // Event System\n  // ============================================================\n\n  /**\n   * Register an event handler\n   *\n   * Subscribe to storage events for logging, analytics, or side effects.\n   *\n   * @param event - Event type to listen for\n   * @param handler - Handler function\n   * @returns Event subscription for unsubscribing\n   *\n   * @example\n   * ```typescript\n   * // Log all uploads\n   * storage.on(\"afterPut\", ({ location, file }) => {\n   *   console.log(`Uploaded ${file?.size} bytes to ${location}`);\n   * });\n   *\n   * // Track deletions\n   * storage.on(\"afterDelete\", ({ location }) => {\n   *   analytics.track(\"file_deleted\", { path: location });\n   * });\n   * ```\n   */\n  public on<T extends StorageEventPayload = StorageEventPayload>(\n    event: StorageEventType,\n    handler: StorageEventHandler<T>,\n  ): EventSubscription {\n    return events.subscribe(`storage.${event}`, handler);\n  }\n\n  /**\n   * Remove all handlers for an event type\n   *\n   * @param event - Event type to remove handlers for\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * storage.off(\"afterPut\"); // Remove all afterPut handlers\n   * ```\n   */\n  public off(event: StorageEventType): this {\n    events.off(`storage.${event}`);\n    return this;\n  }\n\n  /**\n   * Emit an event to all registered handlers\n   * @internal\n   */\n  protected async emit<T extends StorageEventPayload>(\n    event: StorageEventType,\n    payload: T,\n  ): Promise<void> {\n    // `triggerAll` is synchronous — it never awaits its handlers, so awaiting it\n    // would make async listeners fire-and-forget. `triggerAllAsync` takes the\n    // same `(event, ...args)` shape and awaits each handler in turn.\n    await events.triggerAllAsync(`storage.${event}`, payload);\n  }\n\n  // ============================================================\n  // Overridden Operations with Events\n  // ============================================================\n\n  /**\n   * Store a file in storage\n   *\n   * Extends base `put()` with event emission for beforePut/afterPut hooks.\n   *\n   * @param file - File content as Buffer, string, UploadedFile, or Readable stream\n   * @param location - Destination path\n   * @param options - Storage options (mimeType, cacheControl, etc.)\n   * @returns StorageFile instance with cached metadata\n   */\n  public override async put(\n    file: UploadedFile | Buffer | string | Readable,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    const driver = this.activeDriver;\n    const buffer = await this.toBuffer(file);\n\n    await this.emit<StoragePutEventPayload>(\"beforePut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      size: buffer.length,\n    });\n\n    const result = await driver.put(buffer, location, options);\n\n    await this.emit<StoragePutEventPayload>(\"afterPut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    if (!result.size) {\n      result.size = buffer.length;\n    }\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * Atomically store a file only if nothing exists at `location`.\n   *\n   * Emits the same beforePut/afterPut events as `put()` when the file is\n   * written; emits nothing when the location already exists (`null`).\n   * Because the outcome is unknown until the driver returns, both events\n   * fire after the write, for the winner only.\n   *\n   * @throws StorageCapabilityError when the driver has no `putIfAbsent`\n   */\n  public override async putIfAbsent(\n    file: Buffer | string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile | null> {\n    const driver = this.activeDriver;\n\n    if (typeof driver.putIfAbsent !== \"function\") {\n      throw new StorageCapabilityError(\"putIfAbsent\", driver.name);\n    }\n\n    const result = await driver.putIfAbsent(file, location, options);\n\n    if (!result) {\n      return null;\n    }\n\n    const size = typeof file === \"string\" ? Buffer.byteLength(file) : file.length;\n\n    await this.emit<StoragePutEventPayload>(\"beforePut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      size,\n    });\n\n    await this.emit<StoragePutEventPayload>(\"afterPut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    if (!result.size) {\n      result.size = size;\n    }\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * Store a file from a readable stream (for large files)\n   *\n   * Extends base `putStream()` with event emission.\n   *\n   * @param stream - Readable stream\n   * @param location - Destination path\n   * @param options - Storage options\n   * @returns StorageFile instance with cached metadata\n   */\n  public override async putStream(\n    stream: Readable | string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    const driver = this.activeDriver;\n\n    await this.emit<StoragePutEventPayload>(\"beforePut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n    });\n\n    if (typeof stream === \"string\") {\n      stream = fs.createReadStream(stream);\n    }\n\n    const result = await driver.putStream(stream, location, options);\n\n    await this.emit<StoragePutEventPayload>(\"afterPut\", {\n      driver: driver.name,\n      location,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * Store a file from a URL\n   *\n   * Downloads content from the URL and stores it at the specified location.\n   *\n   * The download is SSRF-guarded by default: the URL scheme must be\n   * https/http, the host must not resolve to a private / loopback /\n   * link-local / cloud-metadata address, the body is capped, and the\n   * request times out. Tune or relax via the {@link PutFromUrlOptions}\n   * guard fields.\n   *\n   * @param url - Source URL to download from\n   * @param location - Destination path\n   * @param options - Storage + outbound-download guard options\n   * @returns StorageFile instance with cached metadata\n   *\n   * @example\n   * ```typescript\n   * const file = await storage.putFromUrl(\n   *   \"https://example.com/image.jpg\",\n   *   \"downloads/image.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 } = 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 && !putOptions.mimeType) {\n      throw new Error(`Failed to fetch file from URL: missing content-type header`);\n    }\n\n    const mimeType = putOptions.mimeType || result.contentType || undefined;\n\n    return this.put(result.buffer, location, { ...putOptions, mimeType });\n  }\n\n  /**\n   * Store a file from base64 encoded string\n   *\n   * Decodes base64 content (with optional data URL prefix) and stores it.\n   *\n   * @param base64 - Base64 encoded file content (or data URL)\n   * @param location - Destination path\n   * @param options - Storage options\n   * @returns StorageFile instance with cached metadata\n   *\n   * @example\n   * ```typescript\n   * // From plain base64\n   * const file = await storage.putFromBase64(base64String, \"images/photo.jpg\");\n   *\n   * // From data URL (auto-extracts MIME type)\n   * const file = await storage.putFromBase64(\n   *   \"data:image/png;base64,iVBORw0KGgo...\",\n   *   \"images/photo.png\"\n   * );\n   * ```\n   */\n  public async putFromBase64(\n    base64: string,\n    location: string,\n    options?: PutOptions,\n  ): Promise<StorageFile> {\n    let data = base64;\n    let mimeType = options?.mimeType;\n\n    if (base64.startsWith(\"data:\")) {\n      const match = base64.match(/^data:([^;]+);base64,(.+)$/);\n      if (match) {\n        const matchedMimeType = match[1];\n        const matchedData = match[2];\n\n        if (matchedMimeType !== undefined && matchedData !== undefined) {\n          mimeType = mimeType || matchedMimeType;\n          data = matchedData;\n        }\n      }\n    }\n\n    const buffer = Buffer.from(data, \"base64\");\n    return this.put(buffer, location, { ...options, mimeType });\n  }\n\n  /**\n   * Retrieve file contents as Buffer\n   *\n   * Uses the current driver (with async resolution).\n   *\n   * @param location - File path\n   * @returns Buffer containing file contents\n   */\n  public override async get(location: string): Promise<Buffer> {\n    return this.activeDriver.get(location);\n  }\n\n  /**\n   * Get JSON content from a file\n   *\n   * Downloads and parses JSON file content.\n   *\n   * @param location - File path\n   * @returns Parsed JSON content\n   *\n   * @example\n   * ```typescript\n   * const config = await storage.getJson(\"config/settings.json\");\n   * console.log(config.apiKey);\n   * ```\n   */\n  public async getJson(location: string): Promise<any> {\n    const buffer = await this.get(location);\n    return JSON.parse(buffer.toString());\n  }\n\n  /**\n   * Retrieve a file as a readable stream (for large files)\n   *\n   * @param location - File path\n   * @returns Readable stream of file contents\n   */\n  public override async getStream(location: string): Promise<Readable> {\n    return this.activeDriver.getStream(location);\n  }\n\n  /**\n   * Delete a file\n   *\n   * Extends base `delete()` with event emission.\n   *\n   * @param location - File path or StorageFile\n   * @returns true if deleted, false if not found\n   */\n  public override async delete(location: string | StorageFile): Promise<boolean> {\n    const driver = this.activeDriver;\n    const path = typeof location === \"string\" ? location : location.path;\n\n    await this.emit<StorageEventPayload>(\"beforeDelete\", {\n      driver: driver.name,\n      location: path,\n      timestamp: new Date(),\n    });\n\n    const result = await driver.delete(path);\n\n    await this.emit<StorageEventPayload>(\"afterDelete\", {\n      driver: driver.name,\n      location: path,\n      timestamp: new Date(),\n    });\n\n    return result;\n  }\n\n  /**\n   * Delete multiple files at once\n   *\n   * @param locations - Array of file paths\n   * @returns Array of delete results with status for each file\n   */\n  public override async deleteMany(locations: string[]): Promise<DeleteManyResult[]> {\n    return this.activeDriver.deleteMany(locations);\n  }\n\n  /**\n   * Check if a file exists\n   *\n   * @param location - File path\n   * @returns true if file exists\n   */\n  public override 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   * Extends base `copy()` with event emission.\n   *\n   * @param from - Source path or StorageFile\n   * @param to - Destination path\n   * @returns StorageFile instance at destination\n   */\n  public override async copy(from: string | StorageFile, to: string): Promise<StorageFile> {\n    const driver = this.activeDriver;\n    const fromPath = typeof from === \"string\" ? from : from.path;\n\n    await this.emit<StorageCopyEventPayload>(\"beforeCopy\", {\n      driver: driver.name,\n      location: to,\n      from: fromPath,\n      to,\n      timestamp: new Date(),\n    });\n\n    const result = await driver.copy(fromPath, to);\n\n    await this.emit<StorageCopyEventPayload>(\"afterCopy\", {\n      driver: driver.name,\n      location: to,\n      from: fromPath,\n      to,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * Move a file to a new location\n   *\n   * Extends base `move()` with event emission.\n   *\n   * @param from - Source path or StorageFile\n   * @param to - Destination path\n   * @returns StorageFile instance at destination\n   */\n  public override async move(from: string | StorageFile, to: string): Promise<StorageFile> {\n    const driver = this.activeDriver;\n    const fromPath = typeof from === \"string\" ? from : from.path;\n\n    await this.emit<StorageCopyEventPayload>(\"beforeMove\", {\n      driver: driver.name,\n      location: to,\n      from: fromPath,\n      to,\n      timestamp: new Date(),\n    });\n\n    const result = await driver.move(fromPath, to);\n\n    await this.emit<StorageCopyEventPayload>(\"afterMove\", {\n      driver: driver.name,\n      location: to,\n      from: fromPath,\n      to,\n      timestamp: new Date(),\n      file: result,\n    });\n\n    return StorageFile.fromData(result, driver);\n  }\n\n  /**\n   * List files in a directory\n   *\n   * @param directory - Directory path (defaults to root)\n   * @param options - List options (recursive, limit, etc.)\n   * @returns Array of file information objects\n   */\n  public override async list(\n    directory?: string,\n    options?: ListOptions,\n  ): Promise<StorageFileInfo[]> {\n    return this.activeDriver.list(directory || \"\", options);\n  }\n\n  // ============================================================\n  // Metadata Operations\n  // ============================================================\n\n  /**\n   * Get file metadata without downloading\n   *\n   * @param location - File path\n   * @returns File information object\n   */\n  public override async metadata(location: string): Promise<StorageFileInfo> {\n    return this.activeDriver.metadata(location);\n  }\n\n  /**\n   * Get file size in bytes\n   *\n   * @param location - File path\n   * @returns File size in bytes\n   */\n  public override async size(location: string): Promise<number> {\n    return this.activeDriver.size(location);\n  }\n\n  // ============================================================\n  // Path Operations (Local Driver Only)\n  // ============================================================\n\n  /**\n   * Get the absolute filesystem path for a location\n   *\n   * Only available for local driver.\n   *\n   * @param location - File path\n   * @throws Error if current driver is not a local driver\n   * @returns Absolute filesystem path\n   */\n  public async path(location: string): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!(\"path\" in driver) || typeof driver.path !== \"function\") {\n      throw new Error(\"path() is only available for local storage drivers\");\n    }\n\n    return driver.path(location);\n  }\n\n  // ============================================================\n  // Cloud-Specific Operations\n  // ============================================================\n\n  /**\n   * Get a presigned URL for downloading a file\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - File path\n   * @param options - Presigned URL options (expiresIn)\n   * @throws Error if current driver is not a cloud driver\n   * @returns Presigned download URL\n   *\n   * @example\n   * ```typescript\n   * const url = await storage.getPresignedUrl(\"private/document.pdf\", {\n   *   expiresIn: 3600 // 1 hour\n   * });\n   * ```\n   */\n  public async getPresignedUrl(location: string, options?: PresignedOptions): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Presigned URLs are only available for cloud storage drivers\");\n    }\n\n    return driver.getPresignedUrl(location, options);\n  }\n\n  /**\n   * Get a presigned URL for uploading a file directly to cloud storage\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - Destination path\n   * @param options - Upload options (expiresIn, contentType, metadata).\n   *   There is no size cap: a presigned PUT URL cannot enforce one — verify\n   *   the uploaded size server-side or use a presigned POST policy instead.\n   * @throws Error if current driver is not a cloud driver\n   * @returns Presigned upload URL\n   *\n   * @example\n   * ```typescript\n   * const uploadUrl = await storage.getPresignedUploadUrl(\"uploads/file.pdf\", {\n   *   expiresIn: 3600,\n   *   contentType: \"application/pdf\"\n   * });\n   *\n   * // Client can PUT directly to this URL\n   * ```\n   */\n  public async getPresignedUploadUrl(\n    location: string,\n    options?: PresignedUploadOptions,\n  ): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Presigned upload URLs are only available for cloud storage drivers\");\n    }\n\n    return driver.getPresignedUploadUrl(location, options);\n  }\n\n  /**\n   * Get the bucket name for cloud storage\n   *\n   * Only available for cloud drivers.\n   *\n   * @throws Error if current driver is not a cloud driver\n   * @returns Bucket name\n   */\n  public async getBucket(): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Bucket information is only available for cloud storage drivers\");\n    }\n\n    return driver.getBucket();\n  }\n\n  /**\n   * Get the region for cloud storage\n   *\n   * Only available for cloud drivers.\n   *\n   * @throws Error if current driver is not a cloud driver\n   * @returns Region name\n   */\n  public async getRegion(): Promise<string> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Region information is only available for cloud storage drivers\");\n    }\n\n    return driver.getRegion();\n  }\n\n  /**\n   * Set storage class for a file (e.g., STANDARD, GLACIER, etc.)\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - File path\n   * @param storageClass - Target storage class\n   * @throws Error if current driver is not a cloud driver\n   */\n  public async setStorageClass(location: string, storageClass: string): Promise<void> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Storage class is only available for cloud storage drivers\");\n    }\n\n    return driver.setStorageClass(location, storageClass);\n  }\n\n  /**\n   * Set file visibility (public or private)\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - File path\n   * @param visibility - \"public\" or \"private\"\n   * @throws Error if current driver is not a cloud driver\n   */\n  public async setVisibility(location: string, visibility: FileVisibility): Promise<void> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Visibility is only available for cloud storage drivers\");\n    }\n\n    return driver.setVisibility(location, visibility);\n  }\n\n  /**\n   * Get file visibility\n   *\n   * Only available for cloud drivers.\n   *\n   * @param location - File path\n   * @throws Error if current driver is not a cloud driver\n   * @returns Current visibility setting\n   */\n  public async getVisibility(location: string): Promise<FileVisibility> {\n    const driver = this.activeDriver;\n\n    if (!this.isCloudDriver(driver)) {\n      throw new Error(\"Visibility is only available for cloud storage drivers\");\n    }\n\n    return driver.getVisibility(location);\n  }\n\n  /**\n   * Get a temporary signed URL\n   *\n   * Creates a URL that provides temporary access to the file.\n   *\n   * @param location - File path\n   * @param expiresIn - Seconds until expiration (default: 3600)\n   * @returns Signed URL string\n   */\n  public override async temporaryUrl(location: string, expiresIn?: number): Promise<string> {\n    return this.activeDriver.temporaryUrl(location, expiresIn);\n  }\n\n  /**\n   * Validate a temporary URL token\n   *\n   * For local driver: validates HMAC-signed tokens\n   * For cloud drivers: returns invalid (cloud validates via presigned URL)\n   *\n   * @param token - The token from the temporary URL\n   * @returns Validation result with file info and convenience methods\n   *\n   * @example\n   * ```typescript\n   * const result = await storage.validateTemporaryToken(token);\n   *\n   * if (!result.valid) {\n   *   return response.status(403).send(result.error);\n   * }\n   *\n   * // For local driver - use sendFile for efficiency\n   * if (result.absolutePath) {\n   *   return response.sendFile(result.absolutePath);\n   * }\n   *\n   * // For cloud driver - stream the file\n   * const stream = await result.getStream!();\n   * stream.pipe(response.raw);\n   * ```\n   */\n  public async validateTemporaryToken(token: string): Promise<TemporaryTokenValidation> {\n    // Check if driver supports token validation\n    if (\n      !(\"validateTemporaryToken\" in this.activeDriver) ||\n      typeof this.activeDriver.validateTemporaryToken !== \"function\"\n    ) {\n      // For cloud drivers, temporary URLs are presigned and validated by the cloud provider\n      return {\n        valid: false,\n        error: \"invalid_token\",\n      };\n    }\n\n    return this.activeDriver.validateTemporaryToken(token);\n  }\n\n  // ============================================================\n  // Configuration Parsing\n  // ============================================================\n\n  /**\n   * Parse config into driver-specific options\n   * @internal\n   */\n  protected parseOptions(\n    config: StorageDriverConfig,\n  ): LocalStorageDriverOptions | CloudStorageDriverOptions | R2StorageDriverOptions {\n    const { driver, ...options } = config;\n\n    switch (driver) {\n      case \"local\":\n        return {\n          root: options.root,\n          prefix: options.prefix,\n          urlPrefix: options.urlPrefix,\n          temporaryUrlPrefix: options.temporaryUrlPrefix,\n          signatureKey: options.signatureKey,\n        } satisfies LocalStorageDriverOptions;\n\n      case \"s3\":\n        this.validateCloudConfig(config, \"s3\");\n        return {\n          ...options,\n          bucket: options.bucket!,\n          region: options.region!,\n          accessKeyId: options.accessKeyId,\n          secretAccessKey: options.secretAccessKey,\n          endpoint: options.endpoint,\n          urlPrefix: options.urlPrefix,\n        } satisfies CloudStorageDriverOptions;\n\n      case \"r2\":\n        this.validateCloudConfig(config, \"r2\");\n        if (!options.accountId) {\n          throw new Error('R2 driver requires \"accountId\" configuration');\n        }\n\n        return {\n          ...options,\n          region: options.region || \"auto\",\n          bucket: options.bucket!,\n          accessKeyId: options.accessKeyId,\n          secretAccessKey: options.secretAccessKey,\n          endpoint: options.endpoint,\n          urlPrefix: options.urlPrefix,\n          accountId: options.accountId,\n          publicDomain: options.publicDomain,\n        } satisfies R2StorageDriverOptions;\n\n      case \"spaces\":\n        this.validateCloudConfig(config, \"spaces\");\n        return {\n          ...options,\n          bucket: options.bucket!,\n          region: options.region!,\n          accessKeyId: options.accessKeyId,\n          secretAccessKey: options.secretAccessKey,\n          endpoint: options.endpoint,\n          urlPrefix: options.urlPrefix,\n        } satisfies CloudStorageDriverOptions;\n\n      default:\n        throw new Error(`Unknown driver type: ${driver}`);\n    }\n  }\n\n  /**\n   * Validate cloud driver configuration has required fields\n   * @internal\n   */\n  protected validateCloudConfig(config: StorageDriverConfig, driverName: string): void {\n    // Credentials are optional: when absent, the AWS default provider chain\n    // applies (IAM roles, ECS task roles, IRSA, SSO profiles).\n    const required = [\"bucket\"];\n\n    if (driverName !== \"r2\") {\n      required.push(\"region\");\n    }\n\n    for (const field of required) {\n      if (!config[field as keyof StorageDriverConfig]) {\n        throw new Error(`${driverName.toUpperCase()} driver requires \"${field}\" configuration`);\n      }\n    }\n\n    if (Boolean(config.accessKeyId) !== Boolean(config.secretAccessKey)) {\n      throw new Error(\n        `${driverName.toUpperCase()} driver requires both \"accessKeyId\" and \"secretAccessKey\", or neither`,\n      );\n    }\n  }\n\n  /**\n   * Get or create driver instance from cache\n   * @internal\n   */\n  protected resolveDriver(name: string): StorageDriverContract {\n    // Ensure configs are loaded\n\n    if (this.drivers.has(name)) {\n      return this.drivers.get(name)!;\n    }\n\n    const config = this.configs.get(name);\n\n    if (!config) {\n      throw new Error(`Storage driver \"${name}\" is not configured`);\n    }\n\n    const options = this.parseOptions(config);\n    let driver: StorageDriverContract;\n\n    switch (config.driver) {\n      case \"local\":\n        driver = new LocalDriver(options as LocalStorageDriverOptions);\n        break;\n      case \"s3\":\n        driver = new S3Driver(options as CloudStorageDriverOptions);\n        break;\n      case \"r2\":\n        driver = new R2Driver(options as R2StorageDriverOptions);\n        break;\n      case \"spaces\":\n        driver = new DOSpacesDriver(options as CloudStorageDriverOptions);\n        break;\n      default:\n        throw new Error(`Unknown storage driver type: ${config.driver}`);\n    }\n\n    this.drivers.set(name, driver);\n    return driver;\n  }\n}\n\n/**\n * Singleton storage instance\n *\n * Pre-configured storage manager ready for use throughout the application.\n *\n * @example\n * ```typescript\n * import { storage } from \"@warlock.js/core\";\n *\n * const file = await storage.put(buffer, \"uploads/file.txt\");\n * ```\n */\nexport const storage = new Storage();\n"],"mappings":"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"}

package/esm/storage/types.d.mts

@@ -1,8 +1,9 @@
 import { StorageFile } from "./storage-file.mjs";
+import { ScopedStorage } from "./scoped-storage.mjs";
 import { UploadedFile } from "../http/uploaded-file.mjs";
 import { Readable } from "stream";
 
-//#region ../core/src/storage/types.d.ts
+//#region ../../packages/core/src/storage/types.d.ts
 /**
  * Options for local storage driver
  */
@@ -986,7 +987,7 @@ interface StorageManagerContract extends ScopedStorageContract {
    * @param name - Driver name as configured
    * @returns ScopedStorage instance for the driver
    */
-  use(name: StorageDriverName): ScopedStorageContract;
+  use(name: StorageDriverName): ScopedStorage;
   /**
    * Get a raw driver instance
    *

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

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

package/esm/storage/utils/classify-ip-address.d.mts

@@ -1,4 +1,4 @@
-//#region ../core/src/storage/utils/classify-ip-address.d.ts
+//#region ../../packages/core/src/storage/utils/classify-ip-address.d.ts
 /**
  * True when `ip` is a private, loopback, link-local, unique-local,
  * carrier-grade-NAT, unspecified, or otherwise non-public address — the set

package/esm/storage/utils/classify-ip-address.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"classify-ip-address.d.mts","names":[],"sources":["../../../../../../../../core/src/storage/utils/classify-ip-address.ts"],"mappings":";;AAwKA;;;;AAAgD;;;iBAAhC,qBAAA,CAAsB,EAAU"}
+{"version":3,"file":"classify-ip-address.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/classify-ip-address.ts"],"mappings":";;AAwKA;;;;AAAgD;;;iBAAhC,qBAAA,CAAsB,EAAU"}

package/esm/storage/utils/classify-ip-address.mjs

@@ -1,6 +1,6 @@
 import { isIP } from "node:net";
 
-//#region ../core/src/storage/utils/classify-ip-address.ts
+//#region ../../packages/core/src/storage/utils/classify-ip-address.ts
 /** Parse a dotted-quad into four octets, or `null` if malformed. */
 function parseIpv4(ip) {
 	const parts = ip.split(".");

package/esm/storage/utils/classify-ip-address.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"classify-ip-address.mjs","names":[],"sources":["../../../../../../../../core/src/storage/utils/classify-ip-address.ts"],"sourcesContent":["import { isIP } from \"node:net\";\n\n/**\n * Dependency-free IP classifier for SSRF guards. Imports node built-ins only\n * so other packages (e.g. `@warlock.js/ai`) can reuse it verbatim.\n */\n\ntype Ipv4Octets = [number, number, number, number];\n\n/** Parse a dotted-quad into four octets, or `null` if malformed. */\nfunction parseIpv4(ip: string): Ipv4Octets | null {\n  const parts = ip.split(\".\");\n  if (parts.length !== 4) {\n    return null;\n  }\n\n  const octets = parts.map((part) => Number(part));\n  if (octets.some((n) => !Number.isInteger(n) || n < 0 || n > 255)) {\n    return null;\n  }\n\n  return octets as Ipv4Octets;\n}\n\nfunction isPrivateIpv4(ip: string): boolean {\n  const octets = parseIpv4(ip);\n  if (!octets) {\n    return true; // unparseable → refuse, fail closed\n  }\n\n  const [a, b] = octets;\n\n  return (\n    a === 0 || // 0.0.0.0/8 \"this network\"\n    a === 10 || // 10.0.0.0/8 private\n    a === 127 || // 127.0.0.0/8 loopback\n    (a === 100 && b >= 64 && b <= 127) || // 100.64.0.0/10 CGNAT\n    (a === 169 && b === 254) || // 169.254.0.0/16 link-local + metadata\n    (a === 172 && b >= 16 && b <= 31) || // 172.16.0.0/12 private\n    (a === 192 && b === 168) || // 192.168.0.0/16 private\n    (a === 192 && b === 0) || // 192.0.0.0/24 + 192.0.2.0/24 (IETF/test)\n    (a === 198 && (b === 18 || b === 19)) || // 198.18.0.0/15 benchmarking\n    (a === 198 && b === 51) || // 198.51.100.0/24 test-net-2\n    (a === 203 && b === 0) || // 203.0.113.0/24 test-net-3\n    a >= 224 // 224.0.0.0/4 multicast + 240.0.0.0/4 reserved + 255.255.255.255\n  );\n}\n\n/**\n * Expand an IPv6 literal into its eight 16-bit groups (`::` expanded, a\n * trailing dotted-quad folded into two groups, zone id dropped). Returns\n * `null` when it cannot be parsed.\n */\nfunction expandIpv6(ip: string): number[] | null {\n  let text = (ip.toLowerCase().split(\"%\")[0] ?? \"\").trim();\n  if (text.startsWith(\"[\") && text.endsWith(\"]\")) {\n    text = text.slice(1, -1);\n  }\n\n  const dotted = text.match(/^(.*:)(\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3})$/);\n  if (dotted) {\n    const octets = parseIpv4(dotted[2] as string);\n    if (!octets) {\n      return null;\n    }\n    const [a, b, c, d] = octets;\n    text = `${dotted[1]}${((a << 8) | b).toString(16)}:${((c << 8) | d).toString(16)}`;\n  }\n\n  const halves = text.split(\"::\");\n  if (halves.length > 2) {\n    return null;\n  }\n\n  const toGroups = (part: string): string[] => (part === \"\" ? [] : part.split(\":\"));\n  const head = toGroups(halves[0] as string);\n  const tail = halves.length === 2 ? toGroups(halves[1] as string) : [];\n\n  let groups: string[];\n  if (halves.length === 2) {\n    const missing = 8 - head.length - tail.length;\n    if (missing < 1) {\n      return null;\n    }\n    groups = [...head, ...new Array<string>(missing).fill(\"0\"), ...tail];\n  } else {\n    groups = head;\n  }\n\n  if (groups.length !== 8) {\n    return null;\n  }\n\n  const values = groups.map((group) =>\n    /^[0-9a-f]{1,4}$/.test(group) ? Number.parseInt(group, 16) : Number.NaN,\n  );\n\n  return values.some((n) => Number.isNaN(n)) ? null : values;\n}\n\n/** Build a dotted-quad from two 16-bit groups. */\nfunction toIpv4(high: number, low: number): string {\n  return `${high >> 8}.${high & 0xff}.${low >> 8}.${low & 0xff}`;\n}\n\n/**\n * Extract the IPv4 address embedded in an IPv6 one — IPv4-mapped\n * (`::ffff:a.b.c.d` / `::ffff:XXXX:XXXX`), IPv4-translated (`::ffff:0:a.b.c.d`),\n * IPv4-compatible (`::a.b.c.d`), NAT64 (`64:ff9b::/96`) and 6to4\n * (`2002::/16`) — or `null` when there is none.\n */\nfunction extractEmbeddedIpv4(g: number[]): string | null {\n  const zero = (from: number, to: number) => g.slice(from, to).every((n) => n === 0);\n\n  if (zero(0, 5) && g[5] === 0xffff) {\n    return toIpv4(g[6] as number, g[7] as number); // ::ffff:0:0/96\n  }\n  if (zero(0, 4) && g[4] === 0xffff && g[5] === 0) {\n    return toIpv4(g[6] as number, g[7] as number); // ::ffff:0:0:0/96 (SIIT)\n  }\n  if (zero(0, 6)) {\n    return toIpv4(g[6] as number, g[7] as number); // ::/96 (compatible)\n  }\n  if (g[0] === 0x64 && g[1] === 0xff9b && zero(2, 6)) {\n    return toIpv4(g[6] as number, g[7] as number); // 64:ff9b::/96 NAT64\n  }\n  if (g[0] === 0x2002) {\n    return toIpv4(g[1] as number, g[2] as number); // 2002::/16 6to4\n  }\n\n  return null;\n}\n\n// Every fallback returns `true` (\"private — refuse\"): this is an SSRF guard,\n// so an address we cannot classify must be refused, never let through.\nfunction isPrivateIpv6(ip: string): boolean {\n  const groups = expandIpv6(ip);\n  if (!groups) {\n    return true;\n  }\n\n  const embedded = extractEmbeddedIpv4(groups);\n  if (embedded !== null) {\n    return isPrivateIpv4(embedded); // also covers :: (0.0.0.0) and ::1 (0.0.0.1)\n  }\n\n  const head = groups[0] as number;\n\n  // fc00::/7 unique-local\n  if ((head & 0xfe00) === 0xfc00) {\n    return true;\n  }\n  // fe80::/10 link-local\n  if ((head & 0xffc0) === 0xfe80) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * True when `ip` is a private, loopback, link-local, unique-local,\n * carrier-grade-NAT, unspecified, or otherwise non-public address — the set\n * an SSRF guard must refuse. IPv6 is normalised first, so every spelling of\n * an embedded IPv4 (mapped, hex-mapped, compatible, NAT64, 6to4) is judged\n * by the IPv4 it carries. A non-IP string returns `false` (the caller\n * resolves hostnames via DNS first).\n */\nexport function isPrivateOrReservedIp(ip: string): boolean {\n  const family = isIP(ip);\n  if (family === 4) {\n    return isPrivateIpv4(ip);\n  }\n  if (family === 6) {\n    return isPrivateIpv6(ip);\n  }\n  return false;\n}\n"],"mappings":"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"}
+{"version":3,"file":"classify-ip-address.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/classify-ip-address.ts"],"sourcesContent":["import { isIP } from \"node:net\";\n\n/**\n * Dependency-free IP classifier for SSRF guards. Imports node built-ins only\n * so other packages (e.g. `@warlock.js/ai`) can reuse it verbatim.\n */\n\ntype Ipv4Octets = [number, number, number, number];\n\n/** Parse a dotted-quad into four octets, or `null` if malformed. */\nfunction parseIpv4(ip: string): Ipv4Octets | null {\n  const parts = ip.split(\".\");\n  if (parts.length !== 4) {\n    return null;\n  }\n\n  const octets = parts.map((part) => Number(part));\n  if (octets.some((n) => !Number.isInteger(n) || n < 0 || n > 255)) {\n    return null;\n  }\n\n  return octets as Ipv4Octets;\n}\n\nfunction isPrivateIpv4(ip: string): boolean {\n  const octets = parseIpv4(ip);\n  if (!octets) {\n    return true; // unparseable → refuse, fail closed\n  }\n\n  const [a, b] = octets;\n\n  return (\n    a === 0 || // 0.0.0.0/8 \"this network\"\n    a === 10 || // 10.0.0.0/8 private\n    a === 127 || // 127.0.0.0/8 loopback\n    (a === 100 && b >= 64 && b <= 127) || // 100.64.0.0/10 CGNAT\n    (a === 169 && b === 254) || // 169.254.0.0/16 link-local + metadata\n    (a === 172 && b >= 16 && b <= 31) || // 172.16.0.0/12 private\n    (a === 192 && b === 168) || // 192.168.0.0/16 private\n    (a === 192 && b === 0) || // 192.0.0.0/24 + 192.0.2.0/24 (IETF/test)\n    (a === 198 && (b === 18 || b === 19)) || // 198.18.0.0/15 benchmarking\n    (a === 198 && b === 51) || // 198.51.100.0/24 test-net-2\n    (a === 203 && b === 0) || // 203.0.113.0/24 test-net-3\n    a >= 224 // 224.0.0.0/4 multicast + 240.0.0.0/4 reserved + 255.255.255.255\n  );\n}\n\n/**\n * Expand an IPv6 literal into its eight 16-bit groups (`::` expanded, a\n * trailing dotted-quad folded into two groups, zone id dropped). Returns\n * `null` when it cannot be parsed.\n */\nfunction expandIpv6(ip: string): number[] | null {\n  let text = (ip.toLowerCase().split(\"%\")[0] ?? \"\").trim();\n  if (text.startsWith(\"[\") && text.endsWith(\"]\")) {\n    text = text.slice(1, -1);\n  }\n\n  const dotted = text.match(/^(.*:)(\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3})$/);\n  if (dotted) {\n    const octets = parseIpv4(dotted[2] as string);\n    if (!octets) {\n      return null;\n    }\n    const [a, b, c, d] = octets;\n    text = `${dotted[1]}${((a << 8) | b).toString(16)}:${((c << 8) | d).toString(16)}`;\n  }\n\n  const halves = text.split(\"::\");\n  if (halves.length > 2) {\n    return null;\n  }\n\n  const toGroups = (part: string): string[] => (part === \"\" ? [] : part.split(\":\"));\n  const head = toGroups(halves[0] as string);\n  const tail = halves.length === 2 ? toGroups(halves[1] as string) : [];\n\n  let groups: string[];\n  if (halves.length === 2) {\n    const missing = 8 - head.length - tail.length;\n    if (missing < 1) {\n      return null;\n    }\n    groups = [...head, ...new Array<string>(missing).fill(\"0\"), ...tail];\n  } else {\n    groups = head;\n  }\n\n  if (groups.length !== 8) {\n    return null;\n  }\n\n  const values = groups.map((group) =>\n    /^[0-9a-f]{1,4}$/.test(group) ? Number.parseInt(group, 16) : Number.NaN,\n  );\n\n  return values.some((n) => Number.isNaN(n)) ? null : values;\n}\n\n/** Build a dotted-quad from two 16-bit groups. */\nfunction toIpv4(high: number, low: number): string {\n  return `${high >> 8}.${high & 0xff}.${low >> 8}.${low & 0xff}`;\n}\n\n/**\n * Extract the IPv4 address embedded in an IPv6 one — IPv4-mapped\n * (`::ffff:a.b.c.d` / `::ffff:XXXX:XXXX`), IPv4-translated (`::ffff:0:a.b.c.d`),\n * IPv4-compatible (`::a.b.c.d`), NAT64 (`64:ff9b::/96`) and 6to4\n * (`2002::/16`) — or `null` when there is none.\n */\nfunction extractEmbeddedIpv4(g: number[]): string | null {\n  const zero = (from: number, to: number) => g.slice(from, to).every((n) => n === 0);\n\n  if (zero(0, 5) && g[5] === 0xffff) {\n    return toIpv4(g[6] as number, g[7] as number); // ::ffff:0:0/96\n  }\n  if (zero(0, 4) && g[4] === 0xffff && g[5] === 0) {\n    return toIpv4(g[6] as number, g[7] as number); // ::ffff:0:0:0/96 (SIIT)\n  }\n  if (zero(0, 6)) {\n    return toIpv4(g[6] as number, g[7] as number); // ::/96 (compatible)\n  }\n  if (g[0] === 0x64 && g[1] === 0xff9b && zero(2, 6)) {\n    return toIpv4(g[6] as number, g[7] as number); // 64:ff9b::/96 NAT64\n  }\n  if (g[0] === 0x2002) {\n    return toIpv4(g[1] as number, g[2] as number); // 2002::/16 6to4\n  }\n\n  return null;\n}\n\n// Every fallback returns `true` (\"private — refuse\"): this is an SSRF guard,\n// so an address we cannot classify must be refused, never let through.\nfunction isPrivateIpv6(ip: string): boolean {\n  const groups = expandIpv6(ip);\n  if (!groups) {\n    return true;\n  }\n\n  const embedded = extractEmbeddedIpv4(groups);\n  if (embedded !== null) {\n    return isPrivateIpv4(embedded); // also covers :: (0.0.0.0) and ::1 (0.0.0.1)\n  }\n\n  const head = groups[0] as number;\n\n  // fc00::/7 unique-local\n  if ((head & 0xfe00) === 0xfc00) {\n    return true;\n  }\n  // fe80::/10 link-local\n  if ((head & 0xffc0) === 0xfe80) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * True when `ip` is a private, loopback, link-local, unique-local,\n * carrier-grade-NAT, unspecified, or otherwise non-public address — the set\n * an SSRF guard must refuse. IPv6 is normalised first, so every spelling of\n * an embedded IPv4 (mapped, hex-mapped, compatible, NAT64, 6to4) is judged\n * by the IPv4 it carries. A non-IP string returns `false` (the caller\n * resolves hostnames via DNS first).\n */\nexport function isPrivateOrReservedIp(ip: string): boolean {\n  const family = isIP(ip);\n  if (family === 4) {\n    return isPrivateIpv4(ip);\n  }\n  if (family === 6) {\n    return isPrivateIpv6(ip);\n  }\n  return false;\n}\n"],"mappings":"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"}

package/esm/storage/utils/contain-path.d.mts

@@ -1,4 +1,4 @@
-//#region ../core/src/storage/utils/contain-path.d.ts
+//#region ../../packages/core/src/storage/utils/contain-path.d.ts
 /**
  * Resolve `location` against `root` and assert the result stays *inside*
  * `root` — the local-storage path-traversal guard.

package/esm/storage/utils/contain-path.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"contain-path.d.mts","names":[],"sources":["../../../../../../../../core/src/storage/utils/contain-path.ts"],"mappings":";;AAqBA;;;;AAAgE;;;;;;;;;;;;;iBAAhD,iBAAA,CAAkB,IAAA,UAAc,QAAgB"}
+{"version":3,"file":"contain-path.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/contain-path.ts"],"mappings":";;AAqBA;;;;AAAgE;;;;;;;;;;;;;iBAAhD,iBAAA,CAAkB,IAAA,UAAc,QAAgB"}

package/esm/storage/utils/contain-path.mjs

@@ -1,7 +1,7 @@
 import { StorageError } from "./storage-error.mjs";
 import path from "path";
 
-//#region ../core/src/storage/utils/contain-path.ts
+//#region ../../packages/core/src/storage/utils/contain-path.ts
 /**
 * Resolve `location` against `root` and assert the result stays *inside*
 * `root` — the local-storage path-traversal guard.

package/esm/storage/utils/contain-path.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"contain-path.mjs","names":[],"sources":["../../../../../../../../core/src/storage/utils/contain-path.ts"],"sourcesContent":["import path from \"path\";\nimport { StorageError } from \"./storage-error\";\n\n/**\n * Resolve `location` against `root` and assert the result stays *inside*\n * `root` — the local-storage path-traversal guard.\n *\n * Without this, a `location` like `../../etc/passwd`, `..\\..\\windows\\...`,\n * an absolute path (`/etc/passwd`, `C:\\secret`), or a prefix breakout could\n * escape the configured storage root and read or clobber arbitrary files on\n * the host.\n *\n * The check compares the relative path from `root` to the resolved target:\n * if it climbs out (`..` prefix) or is itself absolute (different drive /\n * root on Windows), the location is rejected.\n *\n * @param root - Absolute, normalized storage root.\n * @param location - Caller-supplied (already prefix-applied) location.\n * @returns The absolute, contained filesystem path.\n * @throws {StorageError} When the location escapes `root`.\n */\nexport function resolveWithinRoot(root: string, location: string): string {\n  const resolved = path.resolve(root, location);\n  const rel = path.relative(root, resolved);\n\n  if (rel !== \"\" && (rel.startsWith(\"..\") || path.isAbsolute(rel))) {\n    throw new StorageError(`Storage location escapes the storage root: \"${location}\"`, {\n      context: { location, root },\n    });\n  }\n\n  return resolved;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,kBAAkB,MAAc,UAA0B;CACxE,MAAM,WAAW,KAAK,QAAQ,MAAM,QAAQ;CAC5C,MAAM,MAAM,KAAK,SAAS,MAAM,QAAQ;CAExC,IAAI,QAAQ,OAAO,IAAI,WAAW,IAAI,KAAK,KAAK,WAAW,GAAG,IAC5D,MAAM,IAAI,aAAa,+CAA+C,SAAS,IAAI,EACjF,SAAS;EAAE;EAAU;CAAK,EAC5B,CAAC;CAGH,OAAO;AACT"}
+{"version":3,"file":"contain-path.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/storage/utils/contain-path.ts"],"sourcesContent":["import path from \"path\";\nimport { StorageError } from \"./storage-error\";\n\n/**\n * Resolve `location` against `root` and assert the result stays *inside*\n * `root` — the local-storage path-traversal guard.\n *\n * Without this, a `location` like `../../etc/passwd`, `..\\..\\windows\\...`,\n * an absolute path (`/etc/passwd`, `C:\\secret`), or a prefix breakout could\n * escape the configured storage root and read or clobber arbitrary files on\n * the host.\n *\n * The check compares the relative path from `root` to the resolved target:\n * if it climbs out (`..` prefix) or is itself absolute (different drive /\n * root on Windows), the location is rejected.\n *\n * @param root - Absolute, normalized storage root.\n * @param location - Caller-supplied (already prefix-applied) location.\n * @returns The absolute, contained filesystem path.\n * @throws {StorageError} When the location escapes `root`.\n */\nexport function resolveWithinRoot(root: string, location: string): string {\n  const resolved = path.resolve(root, location);\n  const rel = path.relative(root, resolved);\n\n  if (rel !== \"\" && (rel.startsWith(\"..\") || path.isAbsolute(rel))) {\n    throw new StorageError(`Storage location escapes the storage root: \"${location}\"`, {\n      context: { location, root },\n    });\n  }\n\n  return resolved;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,kBAAkB,MAAc,UAA0B;CACxE,MAAM,WAAW,KAAK,QAAQ,MAAM,QAAQ;CAC5C,MAAM,MAAM,KAAK,SAAS,MAAM,QAAQ;CAExC,IAAI,QAAQ,OAAO,IAAI,WAAW,IAAI,KAAK,KAAK,WAAW,GAAG,IAC5D,MAAM,IAAI,aAAa,+CAA+C,SAAS,IAAI,EACjF,SAAS;EAAE;EAAU;CAAK,EAC5B,CAAC;CAGH,OAAO;AACT"}