@warlock.js/core 4.0.174 → 4.1.2

package/esm/http/uploaded-file.mjs

@@ -0,0 +1,579 @@
+import { sanitizePath } from "../utils/paths.mjs";
+import { storage } from "../storage/storage.mjs";
+import "../storage/index.mjs";
+import { Image } from "../image/image.mjs";
+import "../image/index.mjs";
+import { uploadsConfig } from "./uploads-config.mjs";
+import path from "path";
+import { Random } from "@mongez/reinforcements";
+import dayjs from "dayjs";
+
+//#region ../../@warlock.js/core/src/http/uploaded-file.ts
+/**
+* UploadedFile - Handles multipart file uploads with storage and image integration
+*
+* Provides a fluent API for validating, transforming, and saving uploaded files
+* to various storage drivers (local, S3, R2, etc.).
+*
+* @example
+* ```typescript
+* // Simple save with random name
+* const file = await uploadedFile.save("avatars");
+*
+* // Original name with date prefix
+* const file = await uploadedFile.save("avatars", {
+*   name: "original",
+*   prefix: { format: "yyyy/mm/dd", as: "directory" }
+* });
+*
+* // With image transformations
+* const file = await uploadedFile
+*   .resize(800, 600)
+*   .quality(85)
+*   .format("webp")
+*   .save("avatars");
+*
+* // Different storage driver
+* const file = await uploadedFile.use("s3").save("avatars");
+* ```
+*/
+var UploadedFile = class {
+	/**
+	* Create a new UploadedFile instance
+	*
+	* @param fileData - Multipart file data from Fastify
+	* @throws Error if file data is invalid
+	*/
+	constructor(fileData) {
+		this.fileData = fileData;
+		this.hash = "";
+		this._storage = storage;
+		this._imageOptions = {};
+		if (!fileData?.filename) throw new Error("Invalid file data: filename is required");
+	}
+	/**
+	* Get file name (sanitized)
+	*
+	* Returns the original filename with special characters removed/replaced.
+	*/
+	get name() {
+		return sanitizePath(this.fileData.filename);
+	}
+	/**
+	* Get file MIME type
+	*
+	* @example "image/jpeg", "application/pdf"
+	*/
+	get mimeType() {
+		return this.fileData.mimetype;
+	}
+	/**
+	* Get file extension (lowercase, without dot)
+	*
+	* @example "jpg", "png", "pdf"
+	*/
+	get extension() {
+		return path.extname(this.fileData.filename).replace(".", "").toLowerCase();
+	}
+	/**
+	* Get file metadata
+	*/
+	async metadata() {
+		const data = {
+			name: this.name,
+			mimeType: this.mimeType,
+			extension: this.extension,
+			size: await this.size()
+		};
+		if (this.isImage) {
+			const dimensions = await this.dimensions();
+			data.width = dimensions.width;
+			data.height = dimensions.height;
+		}
+		return data;
+	}
+	/**
+	* Get file size in bytes
+	*
+	* Buffers the file content if not already buffered.
+	*/
+	async size() {
+		return (await this.buffer()).length;
+	}
+	/**
+	* Get file buffer
+	*
+	* Caches the buffer after first call for efficiency.
+	*/
+	async buffer() {
+		if (this.bufferedFileContent) return this.bufferedFileContent;
+		this.bufferedFileContent = await this.fileData.toBuffer();
+		return this.bufferedFileContent;
+	}
+	/**
+	* Check if file is an image based on MIME type
+	*/
+	get isImage() {
+		return this.mimeType.startsWith("image");
+	}
+	/**
+	* Check if file is a video based on MIME type
+	*/
+	get isVideo() {
+		return this.mimeType.startsWith("video");
+	}
+	/**
+	* Check if file is an audio based on MIME type
+	*/
+	get isAudio() {
+		return this.mimeType.startsWith("audio");
+	}
+	/**
+	* Select a specific storage driver for this upload
+	*
+	* Returns this instance for chaining. The driver is used
+	* when `save()` or `saveAs()` is called.
+	*
+	* @param driver - Driver name from storage configuration
+	* @returns This instance for chaining
+	*
+	* @example
+	* ```typescript
+	* await file.use("s3").save("avatars");
+	* await file.use("r2").save("cdn/images");
+	* ```
+	*/
+	use(driver) {
+		this._storage = storage.use(driver);
+		return this;
+	}
+	/**
+	* Resize the image before saving
+	*
+	* Only applies to image files. Non-image files ignore this.
+	*
+	* @param width - Target width in pixels
+	* @param height - Optional target height (maintains aspect ratio if omitted)
+	* @returns This instance for chaining
+	*
+	* @example
+	* ```typescript
+	* await file.resize(800).save("thumbnails");
+	* await file.resize(400, 400).save("avatars");
+	* ```
+	*/
+	resize(width, height) {
+		this._imageOptions.resize = {
+			width,
+			height
+		};
+		return this;
+	}
+	/**
+	* Set image output quality
+	*
+	* Quality affects file size and visual fidelity.
+	* Only applies to formats that support quality (JPEG, WebP, AVIF).
+	*
+	* @param value - Quality value (1-100)
+	* @returns This instance for chaining
+	*
+	* @example
+	* ```typescript
+	* await file.quality(85).save("images");
+	* ```
+	*/
+	quality(value) {
+		if (value < 1 || value > 100) throw new Error("Quality must be between 1 and 100");
+		this._imageOptions.quality = value;
+		return this;
+	}
+	/**
+	* Convert image to a specific format
+	*
+	* Changes the output format and updates the file extension accordingly.
+	*
+	* @param format - Target image format (jpeg, png, webp, avif, etc.)
+	* @returns This instance for chaining
+	*
+	* @example
+	* ```typescript
+	* await file.format("webp").save("images");
+	* await file.resize(800).format("avif").quality(80).save("optimized");
+	* ```
+	*/
+	format(format) {
+		this._imageOptions.format = format;
+		return this;
+	}
+	/**
+	* Rotate the image
+	*
+	* @param degrees - Rotation angle in degrees (positive = clockwise)
+	* @returns This instance for chaining
+	*
+	* @example
+	* ```typescript
+	* await file.rotate(90).save("rotated");
+	* ```
+	*/
+	rotate(degrees) {
+		this._imageOptions.rotate = degrees;
+		return this;
+	}
+	/**
+	* Apply blur effect to the image
+	*
+	* @param sigma - Blur intensity (default: 3, minimum: 0.3)
+	* @returns This instance for chaining
+	*
+	* @example
+	* ```typescript
+	* await file.blur(5).save("blurred");
+	* ```
+	*/
+	blur(sigma = 3) {
+		if (sigma < .3) throw new Error("Blur sigma must be at least 0.3");
+		this._imageOptions.blur = sigma;
+		return this;
+	}
+	/**
+	* Convert image to grayscale (black and white)
+	*
+	* @returns This instance for chaining
+	*
+	* @example
+	* ```typescript
+	* await file.grayscale().save("bw-images");
+	* ```
+	*/
+	grayscale() {
+		this._imageOptions.grayscale = true;
+		return this;
+	}
+	/**
+	* Apply full image transformations
+	*
+	* Provides complete control over image processing. Can be used with:
+	* - An options object for predefined transforms
+	* - A callback function for chained operations
+	*
+	* @param config - Transform options or callback function
+	* @returns This instance for chaining
+	*
+	* @example
+	* ```typescript
+	* // Using options object
+	* await file.transform({
+	*   resize: { width: 800, fit: "inside" },
+	*   quality: 85
+	* }).save("images");
+	*
+	* // Using callback for full control
+	* await file.transform(img =>
+	*   img.resize({ width: 800 })
+	*      .watermark("logo.png", { gravity: "southeast" })
+	*      .sharpen()
+	* ).save("products");
+	* ```
+	*/
+	transform(config) {
+		this._transformConfig = config;
+		return this;
+	}
+	/**
+	* Get an Image instance for advanced manipulation
+	*
+	* Returns an Image instance from the file buffer for manual processing.
+	* Use this when you need operations not covered by the fluent API.
+	*
+	* @returns Promise resolving to Image instance
+	*
+	* @example
+	* ```typescript
+	* const img = await file.toImage();
+	* await img
+	*   .resize({ width: 800 })
+	*   .watermark("logo.png", { gravity: "southeast" })
+	*   .save("path/to/output.jpg");
+	* ```
+	*/
+	async toImage() {
+		return new Image(await this.buffer());
+	}
+	/**
+	* Get file width and height (only for images)
+	*
+	* @returns Dimensions object, or empty object if not an image
+	*/
+	async dimensions() {
+		if (!this.isImage) return {};
+		return new Image(await this.buffer()).dimensions();
+	}
+	/**
+	* Validate file against the given options
+	*
+	* @param options - Validation rules
+	* @throws Error if validation fails
+	*
+	* @example
+	* ```typescript
+	* await file.validate({
+	*   allowedMimeTypes: ["image/jpeg", "image/png"],
+	*   maxSize: 5 * 1024 * 1024 // 5MB
+	* });
+	* ```
+	*/
+	async validate(options) {
+		const { allowedMimeTypes, allowedExtensions, maxSize } = options;
+		if (allowedMimeTypes && !allowedMimeTypes.includes(this.mimeType)) throw new Error(`Invalid file type: ${this.mimeType}. Allowed types: ${allowedMimeTypes.join(", ")}`);
+		if (allowedExtensions && !allowedExtensions.includes(this.extension)) throw new Error(`Invalid file extension: ${this.extension}. Allowed extensions: ${allowedExtensions.join(", ")}`);
+		if (maxSize) {
+			const fileSize = await this.size();
+			if (fileSize > maxSize) throw new Error(`File too large: ${fileSize} bytes. Maximum allowed: ${maxSize} bytes`);
+		}
+	}
+	/**
+	* Save the file to a directory with automatic naming
+	* Keep in mind to use only relative path to the root of storage
+	* If you are using local driver
+	* Uses the configured naming strategy and prefix options to generate
+	* the final path. Returns a StorageFile for accessing file metadata.
+	*
+	* @param directory - Target directory path
+	* @param options - Save options (name, prefix, driver, validate)
+	* @returns StorageFile instance with file metadata and operations
+	*
+	* @example
+	* ```typescript
+	* // Random name (default)
+	* await file.save("avatars");
+	* // → avatars/x7k9m2p4.jpg
+	*
+	* // Original name
+	* await file.save("avatars", { name: "original" });
+	* // → avatars/photo.jpg
+	*
+	* // With date directory
+	* await file.save("avatars", {
+	*   prefix: { format: "yyyy/mm/dd", as: "directory" }
+	* });
+	* // → avatars/2025/12/21/x7k9m2p4.jpg
+	*
+	* // Original name with datetime prefix
+	* await file.save("avatars", { name: "original", prefix: true });
+	* // → avatars/21-12-2025-16-45-30-photo.jpg
+	* ```
+	*/
+	async save(directory, options) {
+		if (options?.validate) await this.validate(options.validate);
+		const filename = this.resolveFilename(options);
+		const prefix = this.resolvePrefix(options?.prefix);
+		const location = this.buildLocation(directory, prefix, filename);
+		return this.saveToLocation(location, options?.driver);
+	}
+	/**
+	* Save the file to an explicit path
+	*
+	* Unlike `save()`, this method uses the exact path you provide.
+	* No automatic naming or prefix is applied.
+	*
+	* @param location - Full file path (directory + filename)
+	* @param options - Save options (driver, validate)
+	* @returns StorageFile instance with file metadata
+	*
+	* @example
+	* ```typescript
+	* await file.saveAs("avatars/profile-123.png");
+	* await file.saveAs("products/2025/featured-image.webp");
+	* ```
+	*/
+	async saveAs(location, options) {
+		if (options?.validate) await this.validate(options.validate);
+		return this.saveToLocation(location, options?.driver);
+	}
+	/**
+	* Get the StorageFile reference if file has been saved
+	*
+	* Returns undefined if file hasn't been saved yet.
+	*/
+	get storageFile() {
+		return this._storageFile;
+	}
+	/**
+	* Execute save to the specified location
+	* @internal
+	*/
+	async saveToLocation(location, driver) {
+		const content = await this.getProcessedContent();
+		const storageInstance = this.resolveStorage(driver);
+		const finalLocation = this.adjustLocationForFormat(location);
+		this._storageFile = await storageInstance.put(content, finalLocation, { mimeType: this.getFinalMimeType() });
+		const info = await this._storageFile.data();
+		this.hash = info.hash || "";
+		return this._storageFile;
+	}
+	/**
+	* Get processed content (with transforms applied if applicable)
+	* @internal
+	*/
+	async getProcessedContent() {
+		const content = await this.buffer();
+		if (!this.isImage || !this.hasTransforms()) return content;
+		let img = new Image(content);
+		if (typeof this._transformConfig === "function") img = this._transformConfig(img);
+		else if (this._transformConfig) img = img.apply(this._transformConfig);
+		img = this.applyImageOptions(img);
+		return img.toBuffer();
+	}
+	/**
+	* Apply high-level image options
+	* @internal
+	*/
+	applyImageOptions(img) {
+		const opts = this._imageOptions;
+		if (opts.resize) img = img.resize({
+			width: opts.resize.width,
+			height: opts.resize.height
+		});
+		if (opts.rotate !== void 0) img = img.rotate(opts.rotate);
+		if (opts.blur !== void 0) img = img.blur(opts.blur);
+		if (opts.grayscale) img = img.grayscale();
+		if (opts.quality !== void 0) img = img.quality(opts.quality);
+		if (opts.format) img = img.format(opts.format);
+		return img;
+	}
+	/**
+	* Check if any transforms are queued
+	* @internal
+	*/
+	hasTransforms() {
+		return this._transformConfig !== void 0 || Object.keys(this._imageOptions).length > 0;
+	}
+	/**
+	* Resolve storage instance to use
+	* @internal
+	*/
+	resolveStorage(driver) {
+		if (driver) return storage.use(driver);
+		return this._storage || storage;
+	}
+	/**
+	* Resolve the filename based on options and config
+	* @internal
+	*/
+	resolveFilename(options) {
+		const namingStrategy = options?.name ?? uploadsConfig("name") ?? "random";
+		let baseName;
+		if (namingStrategy === "original") baseName = path.basename(this.name, path.extname(this.name));
+		else if (namingStrategy === "random") {
+			const length = uploadsConfig("randomLength");
+			baseName = Random.string(length);
+		} else baseName = path.basename(namingStrategy, path.extname(namingStrategy));
+		const ext = this.getFinalExtension();
+		return `${baseName}.${ext}`;
+	}
+	/**
+	* Resolve prefix based on options and config
+	* @internal
+	*/
+	resolvePrefix(prefix) {
+		if (prefix === false || prefix === void 0) {
+			const configPrefix = uploadsConfig("prefix");
+			if (!configPrefix) return "";
+			prefix = configPrefix;
+		}
+		if (prefix === true) {
+			const format = uploadsConfig("defaultPrefixFormat");
+			return this.formatDatePrefix(format, "file");
+		}
+		if (typeof prefix === "string") return prefix;
+		const parts = [];
+		if (prefix.format) parts.push(this.formatDate(prefix.format));
+		if (prefix.randomLength) parts.push(Random.string(prefix.randomLength));
+		const combined = parts.join("-");
+		if ((prefix.as ?? "file") === "directory") return combined ? `${combined}/` : "";
+		return combined ? `${combined}-` : "";
+	}
+	/**
+	* Format a date prefix with the given format
+	* @internal
+	*/
+	formatDatePrefix(format, as) {
+		const formatted = this.formatDate(format);
+		return as === "directory" ? `${formatted}/` : `${formatted}-`;
+	}
+	/**
+	* Format current date using token-based format string
+	* @internal
+	*/
+	formatDate(format) {
+		return dayjs().format(format);
+	}
+	/**
+	* Build final location from directory, prefix, and filename
+	* @internal
+	*/
+	buildLocation(directory, prefix, filename) {
+		const dir = directory.replace(/\/$/, "");
+		if (prefix.endsWith("/")) return `${dir}/${prefix}${filename}`;
+		return `${dir}/${prefix}${filename}`;
+	}
+	/**
+	* Get final extension (accounting for format changes)
+	* @internal
+	*/
+	getFinalExtension() {
+		if (this._imageOptions.format) {
+			const format = this._imageOptions.format;
+			if (format === "jpeg") return "jpg";
+			return format;
+		}
+		return this.extension;
+	}
+	/**
+	* Get final MIME type (accounting for format changes)
+	* @internal
+	*/
+	getFinalMimeType() {
+		if (this._imageOptions.format) {
+			const format = this._imageOptions.format;
+			if (format === "jpeg" || format === "jpg") return "image/jpeg";
+			return `image/${format}`;
+		}
+		return this.mimeType;
+	}
+	/**
+	* Adjust location to use correct extension if format changed
+	* @internal
+	*/
+	adjustLocationForFormat(location) {
+		if (!this._imageOptions.format) return location;
+		const ext = this.getFinalExtension();
+		const currentExt = path.extname(location);
+		if (currentExt) return location.replace(currentExt, `.${ext}`);
+		return `${location}.${ext}`;
+	}
+	/**
+	* Convert to JSON representation
+	*
+	* Includes file metadata and base64 content for serialization.
+	*/
+	async toJSON() {
+		return {
+			name: this.name,
+			mimeType: this.mimeType,
+			extension: this.extension,
+			size: await this.size(),
+			isImage: this.isImage,
+			isVideo: this.isVideo,
+			isAudio: this.isAudio,
+			dimensions: this.isImage ? await this.dimensions() : void 0,
+			base64: (await this.buffer()).toString("base64")
+		};
+	}
+};
+
+//#endregion
+export { UploadedFile };
+//# sourceMappingURL=uploaded-file.mjs.map

package/esm/http/uploaded-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploaded-file.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/http/uploaded-file.ts"],"sourcesContent":["import type { MultipartFile } from \"@fastify/multipart\";\nimport { Random } from \"@mongez/reinforcements\";\nimport dayjs from \"dayjs\";\nimport path from \"path\";\nimport { Image, type ImageFormat, type ImageTransformOptions } from \"../image\";\nimport { storage, type ScopedStorage, type StorageDriverName, type StorageFile } from \"../storage\";\nimport { sanitizePath } from \"../utils/paths\";\nimport { uploadsConfig } from \"./uploads-config\";\nimport type {\n  FileNamingStrategy,\n  ImageTransformCallback,\n  PrefixConfig,\n  SaveAsOptions,\n  SaveOptions,\n  UploadedFileImageOptions,\n} from \"./uploads-types\";\n\ntype UploadedFileMetadata = {\n  name: string;\n  mimeType: string;\n  extension: string;\n  size: number;\n  width?: number;\n  height?: number;\n};\n\n/**\n * Options for validating file before saving\n */\nexport type FileValidationOptions = {\n  /**\n   * List of allowed MIME types\n   *\n   * @example [\"image/jpeg\", \"image/png\", \"image/webp\"]\n   */\n  allowedMimeTypes?: string[];\n\n  /**\n   * List of allowed file extensions (without dot)\n   *\n   * @example [\"jpg\", \"jpeg\", \"png\", \"webp\"]\n   */\n  allowedExtensions?: string[];\n\n  /**\n   * Maximum file size in bytes\n   *\n   * @example 5 * 1024 * 1024 // 5MB\n   */\n  maxSize?: number;\n};\n\n/**\n * UploadedFile - Handles multipart file uploads with storage and image integration\n *\n * Provides a fluent API for validating, transforming, and saving uploaded files\n * to various storage drivers (local, S3, R2, etc.).\n *\n * @example\n * ```typescript\n * // Simple save with random name\n * const file = await uploadedFile.save(\"avatars\");\n *\n * // Original name with date prefix\n * const file = await uploadedFile.save(\"avatars\", {\n *   name: \"original\",\n *   prefix: { format: \"yyyy/mm/dd\", as: \"directory\" }\n * });\n *\n * // With image transformations\n * const file = await uploadedFile\n *   .resize(800, 600)\n *   .quality(85)\n *   .format(\"webp\")\n *   .save(\"avatars\");\n *\n * // Different storage driver\n * const file = await uploadedFile.use(\"s3\").save(\"avatars\");\n * ```\n */\nexport class UploadedFile {\n  /**\n   * File buffered content\n   * @internal\n   */\n  protected bufferedFileContent?: Buffer;\n\n  /**\n   * Upload file hash (SHA-256)\n   *\n   * Populated after file is saved.\n   */\n  public hash = \"\";\n\n  /**\n   * Selected storage driver\n   * @internal\n   */\n  protected _storage: ScopedStorage = storage;\n\n  /**\n   * Saved StorageFile reference\n   * @internal\n   */\n  protected _storageFile?: StorageFile;\n\n  /**\n   * Queued image options (high-level API)\n   * @internal\n   */\n  protected _imageOptions: UploadedFileImageOptions = {};\n\n  /**\n   * Full transform options or callback\n   * @internal\n   */\n  protected _transformConfig?: ImageTransformOptions | ImageTransformCallback;\n\n  /**\n   * Create a new UploadedFile instance\n   *\n   * @param fileData - Multipart file data from Fastify\n   * @throws Error if file data is invalid\n   */\n  public constructor(protected readonly fileData: MultipartFile) {\n    if (!fileData?.filename) {\n      throw new Error(\"Invalid file data: filename is required\");\n    }\n  }\n\n  // ============================================================\n  // File Properties\n  // ============================================================\n\n  /**\n   * Get file name (sanitized)\n   *\n   * Returns the original filename with special characters removed/replaced.\n   */\n  public get name(): string {\n    return sanitizePath(this.fileData.filename);\n  }\n\n  /**\n   * Get file MIME type\n   *\n   * @example \"image/jpeg\", \"application/pdf\"\n   */\n  public get mimeType(): string {\n    return this.fileData.mimetype;\n  }\n\n  /**\n   * Get file extension (lowercase, without dot)\n   *\n   * @example \"jpg\", \"png\", \"pdf\"\n   */\n  public get extension(): string {\n    return path.extname(this.fileData.filename).replace(\".\", \"\").toLowerCase();\n  }\n\n  /**\n   * Get file metadata\n   */\n  public async metadata(): Promise<UploadedFileMetadata> {\n    const data: UploadedFileMetadata = {\n      name: this.name,\n      mimeType: this.mimeType,\n      extension: this.extension,\n      size: await this.size(),\n    };\n\n    if (this.isImage) {\n      const dimensions = await this.dimensions();\n      data.width = dimensions.width;\n      data.height = dimensions.height;\n    }\n\n    return data;\n  }\n\n  /**\n   * Get file size in bytes\n   *\n   * Buffers the file content if not already buffered.\n   */\n  public async size(): Promise<number> {\n    const file = await this.buffer();\n    return file.length;\n  }\n\n  /**\n   * Get file buffer\n   *\n   * Caches the buffer after first call for efficiency.\n   */\n  public async buffer(): Promise<Buffer> {\n    if (this.bufferedFileContent) {\n      return this.bufferedFileContent;\n    }\n\n    this.bufferedFileContent = await this.fileData.toBuffer();\n    return this.bufferedFileContent;\n  }\n\n  // ============================================================\n  // File Type Checks\n  // ============================================================\n\n  /**\n   * Check if file is an image based on MIME type\n   */\n  public get isImage(): boolean {\n    return this.mimeType.startsWith(\"image\");\n  }\n\n  /**\n   * Check if file is a video based on MIME type\n   */\n  public get isVideo(): boolean {\n    return this.mimeType.startsWith(\"video\");\n  }\n\n  /**\n   * Check if file is an audio based on MIME type\n   */\n  public get isAudio(): boolean {\n    return this.mimeType.startsWith(\"audio\");\n  }\n\n  // ============================================================\n  // Storage Driver Selection\n  // ============================================================\n\n  /**\n   * Select a specific storage driver for this upload\n   *\n   * Returns this instance for chaining. The driver is used\n   * when `save()` or `saveAs()` is called.\n   *\n   * @param driver - Driver name from storage configuration\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * await file.use(\"s3\").save(\"avatars\");\n   * await file.use(\"r2\").save(\"cdn/images\");\n   * ```\n   */\n  public use(driver: StorageDriverName): this {\n    this._storage = storage.use(driver) as ScopedStorage;\n    return this;\n  }\n\n  // ============================================================\n  // High-Level Image Transform API\n  // ============================================================\n\n  /**\n   * Resize the image before saving\n   *\n   * Only applies to image files. Non-image files ignore this.\n   *\n   * @param width - Target width in pixels\n   * @param height - Optional target height (maintains aspect ratio if omitted)\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * await file.resize(800).save(\"thumbnails\");\n   * await file.resize(400, 400).save(\"avatars\");\n   * ```\n   */\n  public resize(width: number, height?: number): this {\n    this._imageOptions.resize = { width, height };\n    return this;\n  }\n\n  /**\n   * Set image output quality\n   *\n   * Quality affects file size and visual fidelity.\n   * Only applies to formats that support quality (JPEG, WebP, AVIF).\n   *\n   * @param value - Quality value (1-100)\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * await file.quality(85).save(\"images\");\n   * ```\n   */\n  public quality(value: number): this {\n    if (value < 1 || value > 100) {\n      throw new Error(\"Quality must be between 1 and 100\");\n    }\n    this._imageOptions.quality = value;\n    return this;\n  }\n\n  /**\n   * Convert image to a specific format\n   *\n   * Changes the output format and updates the file extension accordingly.\n   *\n   * @param format - Target image format (jpeg, png, webp, avif, etc.)\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * await file.format(\"webp\").save(\"images\");\n   * await file.resize(800).format(\"avif\").quality(80).save(\"optimized\");\n   * ```\n   */\n  public format(format: ImageFormat): this {\n    this._imageOptions.format = format;\n    return this;\n  }\n\n  /**\n   * Rotate the image\n   *\n   * @param degrees - Rotation angle in degrees (positive = clockwise)\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * await file.rotate(90).save(\"rotated\");\n   * ```\n   */\n  public rotate(degrees: number): this {\n    this._imageOptions.rotate = degrees;\n    return this;\n  }\n\n  /**\n   * Apply blur effect to the image\n   *\n   * @param sigma - Blur intensity (default: 3, minimum: 0.3)\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * await file.blur(5).save(\"blurred\");\n   * ```\n   */\n  public blur(sigma = 3): this {\n    if (sigma < 0.3) {\n      throw new Error(\"Blur sigma must be at least 0.3\");\n    }\n    this._imageOptions.blur = sigma;\n    return this;\n  }\n\n  /**\n   * Convert image to grayscale (black and white)\n   *\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * await file.grayscale().save(\"bw-images\");\n   * ```\n   */\n  public grayscale(): this {\n    this._imageOptions.grayscale = true;\n    return this;\n  }\n\n  // ============================================================\n  // Full Transform Control\n  // ============================================================\n\n  /**\n   * Apply full image transformations\n   *\n   * Provides complete control over image processing. Can be used with:\n   * - An options object for predefined transforms\n   * - A callback function for chained operations\n   *\n   * @param config - Transform options or callback function\n   * @returns This instance for chaining\n   *\n   * @example\n   * ```typescript\n   * // Using options object\n   * await file.transform({\n   *   resize: { width: 800, fit: \"inside\" },\n   *   quality: 85\n   * }).save(\"images\");\n   *\n   * // Using callback for full control\n   * await file.transform(img =>\n   *   img.resize({ width: 800 })\n   *      .watermark(\"logo.png\", { gravity: \"southeast\" })\n   *      .sharpen()\n   * ).save(\"products\");\n   * ```\n   */\n  public transform(config: ImageTransformOptions | ImageTransformCallback): this {\n    this._transformConfig = config;\n    return this;\n  }\n\n  /**\n   * Get an Image instance for advanced manipulation\n   *\n   * Returns an Image instance from the file buffer for manual processing.\n   * Use this when you need operations not covered by the fluent API.\n   *\n   * @returns Promise resolving to Image instance\n   *\n   * @example\n   * ```typescript\n   * const img = await file.toImage();\n   * await img\n   *   .resize({ width: 800 })\n   *   .watermark(\"logo.png\", { gravity: \"southeast\" })\n   *   .save(\"path/to/output.jpg\");\n   * ```\n   */\n  public async toImage(): Promise<Image> {\n    return new Image(await this.buffer());\n  }\n\n  // ============================================================\n  // Image Metadata\n  // ============================================================\n\n  /**\n   * Get file width and height (only for images)\n   *\n   * @returns Dimensions object, or empty object if not an image\n   */\n  public async dimensions(): Promise<{ width?: number; height?: number }> {\n    if (!this.isImage) {\n      return {};\n    }\n\n    return new Image(await this.buffer()).dimensions();\n  }\n\n  // ============================================================\n  // Validation\n  // ============================================================\n\n  /**\n   * Validate file against the given options\n   *\n   * @param options - Validation rules\n   * @throws Error if validation fails\n   *\n   * @example\n   * ```typescript\n   * await file.validate({\n   *   allowedMimeTypes: [\"image/jpeg\", \"image/png\"],\n   *   maxSize: 5 * 1024 * 1024 // 5MB\n   * });\n   * ```\n   */\n  public async validate(options: FileValidationOptions): Promise<void> {\n    const { allowedMimeTypes, allowedExtensions, maxSize } = options;\n\n    if (allowedMimeTypes && !allowedMimeTypes.includes(this.mimeType)) {\n      throw new Error(\n        `Invalid file type: ${this.mimeType}. Allowed types: ${allowedMimeTypes.join(\", \")}`,\n      );\n    }\n\n    if (allowedExtensions && !allowedExtensions.includes(this.extension)) {\n      throw new Error(\n        `Invalid file extension: ${this.extension}. Allowed extensions: ${allowedExtensions.join(\", \")}`,\n      );\n    }\n\n    if (maxSize) {\n      const fileSize = await this.size();\n      if (fileSize > maxSize) {\n        throw new Error(`File too large: ${fileSize} bytes. Maximum allowed: ${maxSize} bytes`);\n      }\n    }\n  }\n\n  // ============================================================\n  // Save Operations\n  // ============================================================\n\n  /**\n   * Save the file to a directory with automatic naming\n   * Keep in mind to use only relative path to the root of storage\n   * If you are using local driver\n   * Uses the configured naming strategy and prefix options to generate\n   * the final path. Returns a StorageFile for accessing file metadata.\n   *\n   * @param directory - Target directory path\n   * @param options - Save options (name, prefix, driver, validate)\n   * @returns StorageFile instance with file metadata and operations\n   *\n   * @example\n   * ```typescript\n   * // Random name (default)\n   * await file.save(\"avatars\");\n   * // → avatars/x7k9m2p4.jpg\n   *\n   * // Original name\n   * await file.save(\"avatars\", { name: \"original\" });\n   * // → avatars/photo.jpg\n   *\n   * // With date directory\n   * await file.save(\"avatars\", {\n   *   prefix: { format: \"yyyy/mm/dd\", as: \"directory\" }\n   * });\n   * // → avatars/2025/12/21/x7k9m2p4.jpg\n   *\n   * // Original name with datetime prefix\n   * await file.save(\"avatars\", { name: \"original\", prefix: true });\n   * // → avatars/21-12-2025-16-45-30-photo.jpg\n   * ```\n   */\n  public async save(directory: string, options?: SaveOptions): Promise<StorageFile> {\n    // Validate if requested\n    if (options?.validate) {\n      await this.validate(options.validate);\n    }\n\n    // Resolve filename and prefix\n    const filename = this.resolveFilename(options);\n    const prefix = this.resolvePrefix(options?.prefix);\n    const location = this.buildLocation(directory, prefix, filename);\n\n    return this.saveToLocation(location, options?.driver);\n  }\n\n  /**\n   * Save the file to an explicit path\n   *\n   * Unlike `save()`, this method uses the exact path you provide.\n   * No automatic naming or prefix is applied.\n   *\n   * @param location - Full file path (directory + filename)\n   * @param options - Save options (driver, validate)\n   * @returns StorageFile instance with file metadata\n   *\n   * @example\n   * ```typescript\n   * await file.saveAs(\"avatars/profile-123.png\");\n   * await file.saveAs(\"products/2025/featured-image.webp\");\n   * ```\n   */\n  public async saveAs(location: string, options?: SaveAsOptions): Promise<StorageFile> {\n    // Validate if requested\n    if (options?.validate) {\n      await this.validate(options.validate);\n    }\n\n    return this.saveToLocation(location, options?.driver);\n  }\n\n  /**\n   * Get the StorageFile reference if file has been saved\n   *\n   * Returns undefined if file hasn't been saved yet.\n   */\n  public get storageFile(): StorageFile | undefined {\n    return this._storageFile;\n  }\n\n  // ============================================================\n  // Internal Helpers\n  // ============================================================\n\n  /**\n   * Execute save to the specified location\n   * @internal\n   */\n  protected async saveToLocation(\n    location: string,\n    driver?: StorageDriverName,\n  ): Promise<StorageFile> {\n    // Get file content (apply transforms if image)\n    const content = await this.getProcessedContent();\n\n    // Select storage\n    const storageInstance = this.resolveStorage(driver);\n\n    // Determine final location (adjust extension if format changed)\n    const finalLocation = this.adjustLocationForFormat(location);\n\n    // Save to storage\n    this._storageFile = await storageInstance.put(content, finalLocation, {\n      mimeType: this.getFinalMimeType(),\n    });\n\n    // Store hash from StorageFile\n    const info = await this._storageFile.data();\n    this.hash = info.hash || \"\";\n\n    return this._storageFile;\n  }\n\n  /**\n   * Get processed content (with transforms applied if applicable)\n   * @internal\n   */\n  protected async getProcessedContent(): Promise<Buffer> {\n    const content = await this.buffer();\n\n    // If not an image or no transforms, return as-is\n    if (!this.isImage || !this.hasTransforms()) {\n      return content;\n    }\n\n    // Create Image and apply transforms\n    let img = new Image(content);\n\n    // Apply transform callback or options\n    if (typeof this._transformConfig === \"function\") {\n      img = this._transformConfig(img);\n    } else if (this._transformConfig) {\n      img = img.apply(this._transformConfig);\n    }\n\n    // Apply high-level options on top\n    img = this.applyImageOptions(img);\n\n    return img.toBuffer();\n  }\n\n  /**\n   * Apply high-level image options\n   * @internal\n   */\n  protected applyImageOptions(img: Image): Image {\n    const opts = this._imageOptions;\n\n    if (opts.resize) {\n      img = img.resize({ width: opts.resize.width, height: opts.resize.height });\n    }\n\n    if (opts.rotate !== undefined) {\n      img = img.rotate(opts.rotate);\n    }\n\n    if (opts.blur !== undefined) {\n      img = img.blur(opts.blur);\n    }\n\n    if (opts.grayscale) {\n      img = img.grayscale();\n    }\n\n    if (opts.quality !== undefined) {\n      img = img.quality(opts.quality);\n    }\n\n    if (opts.format) {\n      img = img.format(opts.format);\n    }\n\n    return img;\n  }\n\n  /**\n   * Check if any transforms are queued\n   * @internal\n   */\n  protected hasTransforms(): boolean {\n    return this._transformConfig !== undefined || Object.keys(this._imageOptions).length > 0;\n  }\n\n  /**\n   * Resolve storage instance to use\n   * @internal\n   */\n  protected resolveStorage(driver?: StorageDriverName): ScopedStorage | typeof storage {\n    if (driver) {\n      return storage.use(driver) as ScopedStorage;\n    }\n\n    return this._storage || storage;\n  }\n\n  /**\n   * Resolve the filename based on options and config\n   * @internal\n   */\n  protected resolveFilename(options?: SaveOptions): string {\n    const namingStrategy: FileNamingStrategy = options?.name ?? uploadsConfig(\"name\") ?? \"random\";\n    let baseName: string;\n\n    if (namingStrategy === \"original\") {\n      baseName = path.basename(this.name, path.extname(this.name));\n    } else if (namingStrategy === \"random\") {\n      const length = uploadsConfig(\"randomLength\");\n      baseName = Random.string(length);\n    } else {\n      // Custom name - strip extension if provided, we'll add it\n      baseName = path.basename(namingStrategy, path.extname(namingStrategy));\n    }\n\n    // Get extension (may be changed by format transform)\n    const ext = this.getFinalExtension();\n\n    return `${baseName}.${ext}`;\n  }\n\n  /**\n   * Resolve prefix based on options and config\n   * @internal\n   */\n  protected resolvePrefix(prefix?: PrefixConfig): string {\n    // No prefix\n    if (prefix === false || prefix === undefined) {\n      const configPrefix = uploadsConfig(\"prefix\");\n      if (!configPrefix) {\n        return \"\";\n      }\n      // Use config prefix if no explicit prefix provided\n      prefix = configPrefix;\n    }\n\n    // Boolean true = use default format\n    if (prefix === true) {\n      const format = uploadsConfig(\"defaultPrefixFormat\")!;\n      return this.formatDatePrefix(format, \"file\");\n    }\n\n    // String = static prefix\n    if (typeof prefix === \"string\") {\n      return prefix;\n    }\n\n    // PrefixOptions object\n    const parts: string[] = [];\n\n    // Add date format if specified\n    if (prefix.format) {\n      parts.push(this.formatDate(prefix.format));\n    }\n\n    // Add random string if specified\n    if (prefix.randomLength) {\n      parts.push(Random.string(prefix.randomLength));\n    }\n\n    const combined = parts.join(\"-\");\n    const as = prefix.as ?? \"file\";\n\n    if (as === \"directory\") {\n      return combined ? `${combined}/` : \"\";\n    }\n\n    return combined ? `${combined}-` : \"\";\n  }\n\n  /**\n   * Format a date prefix with the given format\n   * @internal\n   */\n  protected formatDatePrefix(format: string, as: \"file\" | \"directory\"): string {\n    const formatted = this.formatDate(format);\n    return as === \"directory\" ? `${formatted}/` : `${formatted}-`;\n  }\n\n  /**\n   * Format current date using token-based format string\n   * @internal\n   */\n  protected formatDate(format: string): string {\n    return dayjs().format(format);\n  }\n\n  /**\n   * Build final location from directory, prefix, and filename\n   * @internal\n   */\n  protected buildLocation(directory: string, prefix: string, filename: string): string {\n    // Clean up directory (remove trailing slash)\n    const dir = directory.replace(/\\/$/, \"\");\n\n    // If prefix ends with /, it's a directory\n    if (prefix.endsWith(\"/\")) {\n      return `${dir}/${prefix}${filename}`;\n    }\n\n    // Otherwise prefix is part of filename\n    return `${dir}/${prefix}${filename}`;\n  }\n\n  /**\n   * Get final extension (accounting for format changes)\n   * @internal\n   */\n  protected getFinalExtension(): string {\n    if (this._imageOptions.format) {\n      // Map formats to extensions\n      const format = this._imageOptions.format;\n\n      if (format === \"jpeg\") return \"jpg\";\n\n      return format;\n    }\n\n    return this.extension;\n  }\n\n  /**\n   * Get final MIME type (accounting for format changes)\n   * @internal\n   */\n  protected getFinalMimeType(): string {\n    if (this._imageOptions.format) {\n      const format = this._imageOptions.format;\n\n      if (format === \"jpeg\" || format === \"jpg\") return \"image/jpeg\";\n\n      return `image/${format}`;\n    }\n\n    return this.mimeType;\n  }\n\n  /**\n   * Adjust location to use correct extension if format changed\n   * @internal\n   */\n  protected adjustLocationForFormat(location: string): string {\n    if (!this._imageOptions.format) {\n      return location;\n    }\n\n    const ext = this.getFinalExtension();\n    const currentExt = path.extname(location);\n\n    if (currentExt) {\n      return location.replace(currentExt, `.${ext}`);\n    }\n\n    return `${location}.${ext}`;\n  }\n\n  // ============================================================\n  // Serialization\n  // ============================================================\n\n  /**\n   * Convert to JSON representation\n   *\n   * Includes file metadata and base64 content for serialization.\n   */\n  public async toJSON() {\n    return {\n      name: this.name,\n      mimeType: this.mimeType,\n      extension: this.extension,\n      size: await this.size(),\n      isImage: this.isImage,\n      isVideo: this.isVideo,\n      isAudio: this.isAudio,\n      dimensions: this.isImage ? await this.dimensions() : undefined,\n      base64: (await this.buffer()).toString(\"base64\"),\n    };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgFA,IAAa,eAAb,MAA0B;;;;;;;CA4CxB,AAAO,YAAY,AAAmB,UAAyB;EAAzB;cAhCxB;kBAMsB;uBAYgB,CAAC;EAenD,IAAI,CAAC,UAAU,UACb,MAAM,IAAI,MAAM,yCAAyC;CAE7D;;;;;;CAWA,IAAW,OAAe;EACxB,OAAO,aAAa,KAAK,SAAS,QAAQ;CAC5C;;;;;;CAOA,IAAW,WAAmB;EAC5B,OAAO,KAAK,SAAS;CACvB;;;;;;CAOA,IAAW,YAAoB;EAC7B,OAAO,KAAK,QAAQ,KAAK,SAAS,QAAQ,EAAE,QAAQ,KAAK,EAAE,EAAE,YAAY;CAC3E;;;;CAKA,MAAa,WAA0C;EACrD,MAAM,OAA6B;GACjC,MAAM,KAAK;GACX,UAAU,KAAK;GACf,WAAW,KAAK;GAChB,MAAM,MAAM,KAAK,KAAK;EACxB;EAEA,IAAI,KAAK,SAAS;GAChB,MAAM,aAAa,MAAM,KAAK,WAAW;GACzC,KAAK,QAAQ,WAAW;GACxB,KAAK,SAAS,WAAW;EAC3B;EAEA,OAAO;CACT;;;;;;CAOA,MAAa,OAAwB;EAEnC,QAAO,MADY,KAAK,OAAO,GACnB;CACd;;;;;;CAOA,MAAa,SAA0B;EACrC,IAAI,KAAK,qBACP,OAAO,KAAK;EAGd,KAAK,sBAAsB,MAAM,KAAK,SAAS,SAAS;EACxD,OAAO,KAAK;CACd;;;;CASA,IAAW,UAAmB;EAC5B,OAAO,KAAK,SAAS,WAAW,OAAO;CACzC;;;;CAKA,IAAW,UAAmB;EAC5B,OAAO,KAAK,SAAS,WAAW,OAAO;CACzC;;;;CAKA,IAAW,UAAmB;EAC5B,OAAO,KAAK,SAAS,WAAW,OAAO;CACzC;;;;;;;;;;;;;;;;CAqBA,AAAO,IAAI,QAAiC;EAC1C,KAAK,WAAW,QAAQ,IAAI,MAAM;EAClC,OAAO;CACT;;;;;;;;;;;;;;;;CAqBA,AAAO,OAAO,OAAe,QAAuB;EAClD,KAAK,cAAc,SAAS;GAAE;GAAO;EAAO;EAC5C,OAAO;CACT;;;;;;;;;;;;;;;CAgBA,AAAO,QAAQ,OAAqB;EAClC,IAAI,QAAQ,KAAK,QAAQ,KACvB,MAAM,IAAI,MAAM,mCAAmC;EAErD,KAAK,cAAc,UAAU;EAC7B,OAAO;CACT;;;;;;;;;;;;;;;CAgBA,AAAO,OAAO,QAA2B;EACvC,KAAK,cAAc,SAAS;EAC5B,OAAO;CACT;;;;;;;;;;;;CAaA,AAAO,OAAO,SAAuB;EACnC,KAAK,cAAc,SAAS;EAC5B,OAAO;CACT;;;;;;;;;;;;CAaA,AAAO,KAAK,QAAQ,GAAS;EAC3B,IAAI,QAAQ,IACV,MAAM,IAAI,MAAM,iCAAiC;EAEnD,KAAK,cAAc,OAAO;EAC1B,OAAO;CACT;;;;;;;;;;;CAYA,AAAO,YAAkB;EACvB,KAAK,cAAc,YAAY;EAC/B,OAAO;CACT;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCA,AAAO,UAAU,QAA8D;EAC7E,KAAK,mBAAmB;EACxB,OAAO;CACT;;;;;;;;;;;;;;;;;;CAmBA,MAAa,UAA0B;EACrC,OAAO,IAAI,MAAM,MAAM,KAAK,OAAO,CAAC;CACtC;;;;;;CAWA,MAAa,aAA2D;EACtE,IAAI,CAAC,KAAK,SACR,OAAO,CAAC;EAGV,OAAO,IAAI,MAAM,MAAM,KAAK,OAAO,CAAC,EAAE,WAAW;CACnD;;;;;;;;;;;;;;;CAoBA,MAAa,SAAS,SAA+C;EACnE,MAAM,EAAE,kBAAkB,mBAAmB,YAAY;EAEzD,IAAI,oBAAoB,CAAC,iBAAiB,SAAS,KAAK,QAAQ,GAC9D,MAAM,IAAI,MACR,sBAAsB,KAAK,SAAS,mBAAmB,iBAAiB,KAAK,IAAI,GACnF;EAGF,IAAI,qBAAqB,CAAC,kBAAkB,SAAS,KAAK,SAAS,GACjE,MAAM,IAAI,MACR,2BAA2B,KAAK,UAAU,wBAAwB,kBAAkB,KAAK,IAAI,GAC/F;EAGF,IAAI,SAAS;GACX,MAAM,WAAW,MAAM,KAAK,KAAK;GACjC,IAAI,WAAW,SACb,MAAM,IAAI,MAAM,mBAAmB,SAAS,2BAA2B,QAAQ,OAAO;EAE1F;CACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCA,MAAa,KAAK,WAAmB,SAA6C;EAEhF,IAAI,SAAS,UACX,MAAM,KAAK,SAAS,QAAQ,QAAQ;EAItC,MAAM,WAAW,KAAK,gBAAgB,OAAO;EAC7C,MAAM,SAAS,KAAK,cAAc,SAAS,MAAM;EACjD,MAAM,WAAW,KAAK,cAAc,WAAW,QAAQ,QAAQ;EAE/D,OAAO,KAAK,eAAe,UAAU,SAAS,MAAM;CACtD;;;;;;;;;;;;;;;;;CAkBA,MAAa,OAAO,UAAkB,SAA+C;EAEnF,IAAI,SAAS,UACX,MAAM,KAAK,SAAS,QAAQ,QAAQ;EAGtC,OAAO,KAAK,eAAe,UAAU,SAAS,MAAM;CACtD;;;;;;CAOA,IAAW,cAAuC;EAChD,OAAO,KAAK;CACd;;;;;CAUA,MAAgB,eACd,UACA,QACsB;EAEtB,MAAM,UAAU,MAAM,KAAK,oBAAoB;EAG/C,MAAM,kBAAkB,KAAK,eAAe,MAAM;EAGlD,MAAM,gBAAgB,KAAK,wBAAwB,QAAQ;EAG3D,KAAK,eAAe,MAAM,gBAAgB,IAAI,SAAS,eAAe,EACpE,UAAU,KAAK,iBAAiB,EAClC,CAAC;EAGD,MAAM,OAAO,MAAM,KAAK,aAAa,KAAK;EAC1C,KAAK,OAAO,KAAK,QAAQ;EAEzB,OAAO,KAAK;CACd;;;;;CAMA,MAAgB,sBAAuC;EACrD,MAAM,UAAU,MAAM,KAAK,OAAO;EAGlC,IAAI,CAAC,KAAK,WAAW,CAAC,KAAK,cAAc,GACvC,OAAO;EAIT,IAAI,MAAM,IAAI,MAAM,OAAO;EAG3B,IAAI,OAAO,KAAK,qBAAqB,YACnC,MAAM,KAAK,iBAAiB,GAAG;OAC1B,IAAI,KAAK,kBACd,MAAM,IAAI,MAAM,KAAK,gBAAgB;EAIvC,MAAM,KAAK,kBAAkB,GAAG;EAEhC,OAAO,IAAI,SAAS;CACtB;;;;;CAMA,AAAU,kBAAkB,KAAmB;EAC7C,MAAM,OAAO,KAAK;EAElB,IAAI,KAAK,QACP,MAAM,IAAI,OAAO;GAAE,OAAO,KAAK,OAAO;GAAO,QAAQ,KAAK,OAAO;EAAO,CAAC;EAG3E,IAAI,KAAK,WAAW,QAClB,MAAM,IAAI,OAAO,KAAK,MAAM;EAG9B,IAAI,KAAK,SAAS,QAChB,MAAM,IAAI,KAAK,KAAK,IAAI;EAG1B,IAAI,KAAK,WACP,MAAM,IAAI,UAAU;EAGtB,IAAI,KAAK,YAAY,QACnB,MAAM,IAAI,QAAQ,KAAK,OAAO;EAGhC,IAAI,KAAK,QACP,MAAM,IAAI,OAAO,KAAK,MAAM;EAG9B,OAAO;CACT;;;;;CAMA,AAAU,gBAAyB;EACjC,OAAO,KAAK,qBAAqB,UAAa,OAAO,KAAK,KAAK,aAAa,EAAE,SAAS;CACzF;;;;;CAMA,AAAU,eAAe,QAA4D;EACnF,IAAI,QACF,OAAO,QAAQ,IAAI,MAAM;EAG3B,OAAO,KAAK,YAAY;CAC1B;;;;;CAMA,AAAU,gBAAgB,SAA+B;EACvD,MAAM,iBAAqC,SAAS,QAAQ,cAAc,MAAM,KAAK;EACrF,IAAI;EAEJ,IAAI,mBAAmB,YACrB,WAAW,KAAK,SAAS,KAAK,MAAM,KAAK,QAAQ,KAAK,IAAI,CAAC;OACtD,IAAI,mBAAmB,UAAU;GACtC,MAAM,SAAS,cAAc,cAAc;GAC3C,WAAW,OAAO,OAAO,MAAM;EACjC,OAEE,WAAW,KAAK,SAAS,gBAAgB,KAAK,QAAQ,cAAc,CAAC;EAIvE,MAAM,MAAM,KAAK,kBAAkB;EAEnC,OAAO,GAAG,SAAS,GAAG;CACxB;;;;;CAMA,AAAU,cAAc,QAA+B;EAErD,IAAI,WAAW,SAAS,WAAW,QAAW;GAC5C,MAAM,eAAe,cAAc,QAAQ;GAC3C,IAAI,CAAC,cACH,OAAO;GAGT,SAAS;EACX;EAGA,IAAI,WAAW,MAAM;GACnB,MAAM,SAAS,cAAc,qBAAqB;GAClD,OAAO,KAAK,iBAAiB,QAAQ,MAAM;EAC7C;EAGA,IAAI,OAAO,WAAW,UACpB,OAAO;EAIT,MAAM,QAAkB,CAAC;EAGzB,IAAI,OAAO,QACT,MAAM,KAAK,KAAK,WAAW,OAAO,MAAM,CAAC;EAI3C,IAAI,OAAO,cACT,MAAM,KAAK,OAAO,OAAO,OAAO,YAAY,CAAC;EAG/C,MAAM,WAAW,MAAM,KAAK,GAAG;EAG/B,KAFW,OAAO,MAAM,YAEb,aACT,OAAO,WAAW,GAAG,SAAS,KAAK;EAGrC,OAAO,WAAW,GAAG,SAAS,KAAK;CACrC;;;;;CAMA,AAAU,iBAAiB,QAAgB,IAAkC;EAC3E,MAAM,YAAY,KAAK,WAAW,MAAM;EACxC,OAAO,OAAO,cAAc,GAAG,UAAU,KAAK,GAAG,UAAU;CAC7D;;;;;CAMA,AAAU,WAAW,QAAwB;EAC3C,OAAO,MAAM,EAAE,OAAO,MAAM;CAC9B;;;;;CAMA,AAAU,cAAc,WAAmB,QAAgB,UAA0B;EAEnF,MAAM,MAAM,UAAU,QAAQ,OAAO,EAAE;EAGvC,IAAI,OAAO,SAAS,GAAG,GACrB,OAAO,GAAG,IAAI,GAAG,SAAS;EAI5B,OAAO,GAAG,IAAI,GAAG,SAAS;CAC5B;;;;;CAMA,AAAU,oBAA4B;EACpC,IAAI,KAAK,cAAc,QAAQ;GAE7B,MAAM,SAAS,KAAK,cAAc;GAElC,IAAI,WAAW,QAAQ,OAAO;GAE9B,OAAO;EACT;EAEA,OAAO,KAAK;CACd;;;;;CAMA,AAAU,mBAA2B;EACnC,IAAI,KAAK,cAAc,QAAQ;GAC7B,MAAM,SAAS,KAAK,cAAc;GAElC,IAAI,WAAW,UAAU,WAAW,OAAO,OAAO;GAElD,OAAO,SAAS;EAClB;EAEA,OAAO,KAAK;CACd;;;;;CAMA,AAAU,wBAAwB,UAA0B;EAC1D,IAAI,CAAC,KAAK,cAAc,QACtB,OAAO;EAGT,MAAM,MAAM,KAAK,kBAAkB;EACnC,MAAM,aAAa,KAAK,QAAQ,QAAQ;EAExC,IAAI,YACF,OAAO,SAAS,QAAQ,YAAY,IAAI,KAAK;EAG/C,OAAO,GAAG,SAAS,GAAG;CACxB;;;;;;CAWA,MAAa,SAAS;EACpB,OAAO;GACL,MAAM,KAAK;GACX,UAAU,KAAK;GACf,WAAW,KAAK;GAChB,MAAM,MAAM,KAAK,KAAK;GACtB,SAAS,KAAK;GACd,SAAS,KAAK;GACd,SAAS,KAAK;GACd,YAAY,KAAK,UAAU,MAAM,KAAK,WAAW,IAAI;GACrD,SAAS,MAAM,KAAK,OAAO,GAAG,SAAS,QAAQ;EACjD;CACF;AACF"}

package/esm/http/uploads-config.d.mts

@@ -0,0 +1,30 @@
+import { UploadsConfigurations } from "./uploads-types.mjs";
+
+//#region ../../@warlock.js/core/src/http/uploads-config.d.ts
+/**
+ * Default uploads configuration values
+ *
+ * These defaults are used when no configuration is provided
+ * or when specific keys are missing from the app config.
+ */
+declare const UPLOADS_DEFAULTS: UploadsConfigurations;
+/**
+ * Get uploads configuration value
+ *
+ * Retrieves a configuration value from the `uploads` section of app config,
+ * falling back to the provided default or the built-in default.
+ *
+ * @param key - Configuration key to retrieve
+ * @param defaultValue - Optional default value if not found
+ * @returns The configuration value
+ *
+ * @example
+ * ```typescript
+ * const naming = uploadsConfig("name"); // "random" or "original"
+ * const length = uploadsConfig("randomLength", 32);
+ * ```
+ */
+declare function uploadsConfig<K extends keyof UploadsConfigurations>(key: K, defaultValue?: UploadsConfigurations[K]): UploadsConfigurations[K];
+//#endregion
+export { UPLOADS_DEFAULTS, uploadsConfig };
+//# sourceMappingURL=uploads-config.d.mts.map

package/esm/http/uploads-config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploads-config.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/http/uploads-config.ts"],"mappings":";;;;;AASA;;;;cAAa,gBAAA,EAAkB,qBAQ9B;AAkBD;;;;;;;;;;;;;;;;AAAA,iBAAgB,aAAA,iBAA8B,qBAAA,CAAA,CAC5C,GAAA,EAAK,CAAA,EACL,YAAA,GAAe,qBAAA,CAAsB,CAAA,IACpC,qBAAA,CAAsB,CAAA"}