@warlock.js/core 5.31.0 → 5.33.0

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

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

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

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

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

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

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

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

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

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

package/esm/storage/index.d.mts

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

package/esm/storage/index.mjs

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"scoped-storage.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/storage/scoped-storage.ts"],"mappings":"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"}
+{"version":3,"file":"scoped-storage.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/storage/scoped-storage.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;qBA2Ca,yBAAyB;;;;;YAK1B,SAAS;;;;;;EAOnB,YAAmB,QAAQ;;;;;;MAahB,QAAQ;;;;;;;;MAWR,iBAAiB;;;;;;;;;;MAajB,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCd,IACX,MAAM,eAAe,kBAAkB,UACvC,kBACA,UAAU,aACT,QAAQ;;;;;;;;;;;EAgBE,YACX,mBACA,kBACA,UAAU,aACT,QAAQ;;;;;;;;;;EAaE,YACX,MAAM,iBACN,kBACA,UAAU,aACT,QAAQ;;;;EAeJ;;;;;;;;;;;;;;;;;;;;EAuBM,UACX,QAAQ,UACR,kBACA,UAAU,aACT,QAAQ;;;;;;;;;;;;;;;;;;;;;;;EA2BE,WACX,aACA,kBACA,UAAU,oBACT,QAAQ;;;;;;;;;;;;;;;;;EAuCE,cACX,iBACA,kBACA,UAAU,aACT,QAAQ;;;;;;;;;;;;;;;;;EAsCE,IAAI,mBAAmB,QAAQ;;;;;;;;;;;;;;;;;EAoB/B,UAAU,mBAAmB,QAAQ;;;;;;;;;;;;;;;;;EAoBrC,OAAO,mBAAmB,cAAc;;;;;;;;;;;;;;;;;;;;;;;EA2BxC,WAAW,sBAAsB,QAAQ;;;;;;EASzC,gBAAgB,wBAAwB;;;;;;;;;;;;;;EAiBxC,OAAO,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAwB1B,KAAK,eAAe,aAAa,aAAa,QAAQ;;;;;;;;;;;;;;;;;;;;;EA0BtD,KAAK,eAAe,aAAa,aAAa,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;EA6BtD,cACX,cACA,YACA;IAAY;MACX;;;;;;;;;;;;;;;;;;EA0CU,cACX,cACA,YACA;IAAY;MACX;;;;;;;;;;;;;;;;;;;;;;;;;EAkCU,aACX,sBACA,qBACA,UAAU,sBACT,QAAQ;;;;;;;;UAkDG;;;;;;;;;;;;;;;EAsCD,eAAe,eAAe;;;;;;;;;;;;;;;;;;;;;;;EAqC9B,KAAK,oBAAoB,UAAU,cAAc,QAAQ;;;;;;;;;;;;;;;;;;EAyB/D,IAAI;;;;;;;;;;;;;;;;;;;;;EAwBE,aAAa,kBAAkB,qBAAqB;;;;;;;;;;;;;;;;;;;EA0BpD,SAAS,mBAAmB,QAAQ;;;;;;;;;;EAapC,KAAK,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EA0B9B,KAAK,mBAAmB;;;;;;;;YAef,SAAS,MAAM,eAAe,kBAAkB,WAAW,QAAQ;;;;;;;;YA2BzE,WAAW,iBAAiB,SAAS;;;;;;;;YAgB/B,eAAe,QAAQ,WAAW,QAAQ;;;;;;;;;;;;;;;;EAuBnD,QAAQ,gBAAgB;;;;;;;;;;;;;;;;EAmBxB,OAAO,kBAAkB"}

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

@@ -1,6 +1,5 @@
 import { CloudStorageFileData, FileVisibility, StorageDriverContract, StorageFileData, StorageFileInfo } from "./types.mjs";
 import { Readable } from "stream";
-
 //#region ../../packages/core/src/storage/storage-file.d.ts
 /**
  * StorageFile class - OOP wrapper for storage file operations
@@ -28,7 +27,7 @@ import { Readable } from "stream";
  * const stream = await file.stream();
  * ```
  */
-declare class StorageFile {
+export declare class StorageFile {
   /**
    * Relative file path
    */
@@ -248,5 +247,4 @@ declare class StorageFile {
   toString(): string;
 }
 //#endregion
-export { StorageFile };
 //# sourceMappingURL=storage-file.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"storage-file.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/storage/storage-file.ts"],"mappings":";;;;;;AAqCA;;;;;;;;;;;;;;;;;;;;;;;;cAAa,WAAA;EA6P6B;;;EAAA,UAzP9B,KAAA;EAkS8C;;;EAAA,UA7R9C,OAAA,EAAS,qBAAA;EA4VX;;;EAAA,UAvVE,KAAA,GAAQ,eAAA;EAgWe;;;EAAA,UA3VvB,QAAA;EAmXQ;;;;;;;cA1WC,IAAA,UAAc,MAAA,EAAQ,qBAAA,EAAuB,IAAA,GAAO,eAAA;EAnB7D;;;EAAA,IAgCC,IAAA;EAtBD;;;EAAA,IA6BC,IAAA;EApBsB;;;EAAA,IA2BtB,SAAA;EAPA;;;EAAA,IAcA,SAAA;EAcA;;;EAAA,IAPA,MAAA;EA6CE;;;EAAA,IAtCF,SAAA;EA0DU;;;EAAA,IAnDV,GAAA;EAmEkB;;;EAAA,IA3DlB,YAAA;EAiFE;;;EAAA,IArEF,IAAA;EA6EY;;;EAlEV,IAAA,IAAQ,OAAA,CAAQ,eAAA;EAkFhB;;;EA9DA,IAAA,IAAQ,OAAA;EAoFR;;;EA5EA,QAAA,IAAY,OAAA;EAwFF;;;EAhFV,YAAA,IAAgB,OAAA,CAAQ,IAAA;EA2FW;;;EAlFnC,IAAA,IAAQ,OAAA;EA4GR;;;EA/FA,QAAA,IAAY,OAAA,CAAQ,MAAA;EAyGV;;;EAjGV,MAAA,IAAU,OAAA,CAAQ,QAAA;EAkHyB;;;EA1G3C,IAAA,IAAQ,OAAA;EA0IR;;;EAlIA,MAAA,IAAU,OAAA;EAgKT;;;EAxJD,OAAA,IAAW,OAAA;EA0Jd;;;;;EA5IG,YAAA,CAAa,SAAA,YAAmB,OAAA;EA4JhC;;;EAhJA,MAAA,IAAU,OAAA;EAgKV;;;;;;EArJA,IAAA,CAAK,WAAA,WAAsB,OAAA,CAAQ,WAAA;EAsL5B;;;;;;EA1KP,IAAA,CAAK,WAAA,WAAsB,OAAA;EA8LtC;;;;;;EAhLW,MAAA,CAAO,OAAA,WAAkB,OAAA;EAqMvB;;;;;EA3LF,MAAA,IAAU,OAAA;;;;;;;EAiBV,aAAA,CAAc,UAAA,EAAY,cAAA,GAAiB,OAAA;;;;;;EAgB3C,aAAA,IAAiB,OAAA,CAAQ,cAAA;;;;;;;EAgBzB,eAAA,CAAgB,YAAA,WAAuB,OAAA;;;;YAkB1C,gBAAA;;;;;;;SAYI,QAAA,CACZ,IAAA,EAAM,eAAA,GAAkB,oBAAA,EACxB,MAAA,EAAQ,qBAAA,GACP,WAAA;;;;EAOU,QAAA,IAAY,OAAA,CAAQ,eAAA;;;;EAQpB,OAAA,IAAO,OAAA;;;;EAQP,UAAA,IAAU,OAAA;;;;EAQV,KAAA,IAAK,OAAA;;;;EAQL,OAAA,IAAO,OAAA;;;;EAYP,KAAA,IAAK,OAAA;;;;EAaL,OAAA,IAAO,OAAA;;;;EAQP,OAAA,IAAO,OAAA;;;;EAQb,MAAA;IACL,IAAA;IACA,IAAA;IACA,SAAA;IACA,MAAA;IACA,GAAA;IACA,IAAA;IACA,IAAA;IACA,QAAA;EAAA;;;;EAiBK,QAAA;AAAA"}
+{"version":3,"file":"storage-file.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/storage/storage-file.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAqCa;;;;YAID;;;;YAKA,SAAS;;;;YAKT,QAAQ;;;;YAKR;;;;;;;;EASV,YAAmB,cAAc,QAAQ,uBAAuB,OAAO;;;;MAa5D;;;;MAOA;;;;MAOA;;;;MAOA;;;;MAOA;;;;MAOA;;;;MAOA;;;;MAQA;;;;MAYA;;;;EAWE,QAAQ,QAAQ;;;;EAoBhB,QAAQ;;;;EAQR,YAAY;;;;EAQZ,gBAAgB,QAAQ;;;;EASxB,QAAQ;;;;EAaR,YAAY,QAAQ;;;;EAQpB,UAAU,QAAQ;;;;EAQlB,QAAQ;;;;EAQR,UAAU;;;;EAQV,WAAW;;;;;;EAcX,aAAa,qBAAmB;;;;EAYhC,UAAU;;;;;;;EAWV,KAAK,sBAAsB,QAAQ;;;;;;;EAYnC,KAAK,sBAAsB;;;;;;;EAc3B,OAAO,kBAAkB;;;;;;EAUzB,UAAU;;;;;;;EAiBV,cAAc,YAAY,iBAAiB;;;;;;EAgB3C,iBAAiB,QAAQ;;;;;;;EAgBzB,gBAAgB,uBAAuB;;;;YAkB1C;;;;;;;SAYI,SACZ,MAAM,kBAAkB,sBACxB,QAAQ,wBACP;;;;EAOU,YAAY,QAAQ;;;;EAQpB,WAAO;;;;EAQP,cAAU;;;;EAQV,SAAK;;;;EAQL,WAAO;;;;EAYP,SAAK;;;;EAaL,WAAO;;;;EAQP,WAAO;;;;EAQb;IACL;IACA;IACA;IACA;IACA;IACA;IACA;IACA;;;;;EAiBK"}

package/esm/storage/storage.d.mts

@@ -2,9 +2,9 @@ import { StorageFile } from "./storage-file.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 "../http/index.mjs";
 import { EventSubscription } from "@mongez/events";
 import { Readable } from "stream";
-
 //#region ../../packages/core/src/storage/storage.d.ts
 /**
  * Storage Manager
@@ -46,7 +46,7 @@ import { Readable } from "stream";
  * });
  * ```
  */
-declare class Storage extends ScopedStorage implements StorageManagerContract {
+export declare class Storage extends ScopedStorage implements StorageManagerContract {
   /**
    * Registered drivers (cached instances)
    * @internal
@@ -618,7 +618,6 @@ declare class Storage extends ScopedStorage implements StorageManagerContract {
  * const file = await storage.put(buffer, "uploads/file.txt");
  * ```
  */
-declare const storage: Storage;
+export declare const storage: Storage;
 //#endregion
-export { Storage, storage };
 //# sourceMappingURL=storage.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"storage.d.mts","names":[],"sources":["../../../../../../../../packages/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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAmFa,gBAAgB,yBAAyB;;;;;YAK1C,SAAO,YAAA;;;;;YAMP,SAAO,YAAA;;;;;YAMP,mBAAoB;;;;;UAMtB;;;;;;EAOR;;;;;;EAWa,QAAQ;;;;MAoBV;;;;;;EASJ,eAAe;;;;EAOf,kBAAkB;;;;EAOlB;;;;;;;;;;;MAkBa,gBAAgB;;;;;YAmB1B;;;;;;;;;;;;;;;;YAiCA;;;;;;;;;;;;;;;;;;;;;;;EAgCH,IAAI,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;EAqB9B,UAAU,MAAM,oBAAoB;;;;EAOpC,KAAK;;;;;;;;;;;;;;EAmBL,SAAS,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAiCnC,SAAS,MAAM,mBAAmB,QAAQ;;;;;;;;;;;;;EAkB1C,WAAW,MAAM;;;;;;EAWX,WAAW;;;;;YAQd,cAAc,QAAQ,wBAAwB,UAAU;;;;;;;;;;;;;;;;;;;;;;;EA8B3D,GAAG,UAAU,sBAAsB,qBACxC,OAAO,kBACP,SAAS,oBAAoB,KAC5B;;;;;;;;;;;;EAeI,IAAI,OAAO;;;;;YASF,KAAK,UAAU,qBAC7B,OAAO,kBACP,SAAS,IACR;;;;;;;;;;;EAqBmB,IACpB,MAAM,eAAe,kBAAkB,UACvC,kBACA,UAAU,aACT,QAAQ;;;;;;;;;;;EAqCW,YACpB,MAAM,iBACN,kBACA,UAAU,aACT,QAAQ;;;;;;;;;;;EA8CW,UACpB,QAAQ,mBACR,kBACA,UAAU,aACT,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;EAiDE,WACX,aACA,kBACA,UAAU,oBACT,QAAQ;;;;;;;;;;;;;;;;;;;;;;;EA6CE,cACX,gBACA,kBACA,UAAU,aACT,QAAQ;;;;;;;;;EA6BW,IAAI,mBAAmB,QAAQ;;;;;;;;;;;;;;;EAkBxC,QAAQ,mBAAmB;;;;;;;EAWlB,UAAU,mBAAmB,QAAQ;;;;;;;;;EAYrC,OAAO,mBAAmB,cAAc;;;;;;;EA2BxC,WAAW,sBAAsB,QAAQ;;;;;;;EAUzC,OAAO,mBAAmB;;;;;;;;;;EAa1B,KAAK,eAAe,aAAa,aAAa,QAAQ;;;;;;;;;;EAmCtD,KAAK,eAAe,aAAa,aAAa,QAAQ;;;;;;;;EAiCtD,KACpB,oBACA,UAAU,cACT,QAAQ;;;;;;;EAcW,SAAS,mBAAmB,QAAQ;;;;;;;EAUpC,KAAK,mBAAmB;;;;;;;;;;EAiBjC,KAAK,mBAAmB;;;;;;;;;;;;;;;;;;EA+BxB,gBAAgB,kBAAkB,UAAU,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EAgC/D,sBACX,kBACA,UAAU,yBACT;;;;;;;;;EAkBU,aAAa;;;;;;;;;EAkBb,aAAa;;;;;;;;;;EAmBb,gBAAgB,kBAAkB,uBAAuB;;;;;;;;;;EAmBzD,cAAc,kBAAkB,YAAY,iBAAiB;;;;;;;;;;EAmB7D,cAAc,mBAAmB,QAAQ;;;;;;;;;;EAmBhC,aAAa,kBAAkB,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B7D,uBAAuB,gBAAgB,QAAQ;;;;;YAwBlD,aACR,QAAQ,sBACP,4BAA4B,4BAA4B;;;;;YAgEjD,oBAAoB,QAAQ,qBAAqB;;;;;YA0BjD,cAAc,eAAe;;;;;;;;;;;;;;qBAkD5B,SAAO"}