@eggjs/multipart 5.0.0-beta.18 → 5.0.0-beta.20

package/dist/LimitError-BZqeZJ5w.js

@@ -0,0 +1,15 @@
+//#region src/lib/LimitError.ts
+var LimitError = class extends Error {
+	code;
+	status;
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+		this.status = 413;
+		this.name = this.constructor.name;
+		Error.captureStackTrace(this, this.constructor);
+	}
+};
+
+//#endregion
+export { LimitError };

package/dist/MultipartFileTooLargeError-CFG577Bz.js

@@ -0,0 +1,17 @@
+//#region src/lib/MultipartFileTooLargeError.ts
+var MultipartFileTooLargeError = class extends Error {
+	status;
+	fields;
+	filename;
+	constructor(message, fields, filename) {
+		super(message);
+		this.name = this.constructor.name;
+		this.status = 413;
+		this.fields = fields;
+		this.filename = filename;
+		Error.captureStackTrace(this, this.constructor);
+	}
+};
+
+//#endregion
+export { MultipartFileTooLargeError };

package/dist/app/extend/context.d.ts

@@ -1,101 +1,2 @@
-import { Readable } from "node:stream";
-import { Context } from "egg";
-
-//#region src/app/extend/context.d.ts
-interface EggFile {
-  field: string;
-  filename: string;
-  encoding: string;
-  mime: string;
-  filepath: string;
-}
-interface MultipartFileStream extends Readable {
-  fields: Record<string, any>;
-  filename: string;
-  fieldname: string;
-  mime: string;
-  mimeType: string;
-  transferEncoding: string;
-  encoding: string;
-  truncated: boolean;
-}
-interface MultipartOptions {
-  autoFields?: boolean;
-  /**
-   * required file submit, default is true
-   */
-  requireFile?: boolean;
-  /**
-   * default charset encoding
-   */
-  defaultCharset?: string;
-  /**
-   * compatible with defaultCharset
-   * @deprecated use `defaultCharset` instead
-   */
-  defCharset?: string;
-  defaultParamCharset?: string;
-  /**
-   * compatible with defaultParamCharset
-   * @deprecated use `defaultParamCharset` instead
-   */
-  defParamCharset?: string;
-  limits?: {
-    fieldNameSize?: number;
-    fieldSize?: number;
-    fields?: number;
-    fileSize?: number;
-    files?: number;
-    parts?: number;
-    headerPairs?: number;
-  };
-  checkFile?(fieldname: string, file: any, filename: string, encoding: string, mimetype: string): void | Error;
-}
-declare class MultipartContext extends Context {
-  /**
-   * create multipart.parts instance, to get separated files.
-   * @function Context#multipart
-   * @param {Object} [options] - override default multipart configurations
-   *  - {Boolean} options.autoFields
-   *  - {String} options.defaultCharset
-   *  - {String} options.defaultParamCharset
-   *  - {Object} options.limits
-   *  - {Function} options.checkFile
-   * @return {Yieldable | AsyncIterable<Yieldable>} parts
-   */
-  multipart(options?: MultipartOptions): AsyncIterable<MultipartFileStream>;
-  /**
-   * save request multipart data and files to `ctx.request`
-   * @function Context#saveRequestFiles
-   * @param {Object} options - { limits, checkFile, ... }
-   */
-  saveRequestFiles(options?: MultipartOptions): Promise<void>;
-  /**
-   * get upload file stream
-   * @example
-   * ```js
-   * const stream = await ctx.getFileStream();
-   * // get other fields
-   * console.log(stream.fields);
-   * ```
-   * @function Context#getFileStream
-   * @param {Object} options
-   *  - {Boolean} options.requireFile - required file submit, default is true
-   *  - {String} options.defaultCharset
-   *  - {String} options.defaultParamCharset
-   *  - {Object} options.limits
-   *  - {Function} options.checkFile
-   * @return {ReadStream} stream
-   * @since 1.0.0
-   * @deprecated Not safe enough, use `ctx.multipart()` instead
-   */
-  getFileStream(options?: MultipartOptions): Promise<MultipartFileStream>;
-  /**
-   * clean up request tmp files helper
-   * @function Context#cleanupRequestFiles
-   * @param {Array<String>} [files] - file paths need to cleanup, default is `ctx.request.files`.
-   */
-  cleanupRequestFiles(files?: EggFile[]): Promise<void>;
-}
-//#endregion
+import { EggFile, MultipartContext, MultipartFileStream, MultipartOptions } from "../../context-COfddVcC.js";
 export { EggFile, MultipartFileStream, MultipartOptions, MultipartContext as default };

package/dist/app/extend/context.js

@@ -1,199 +1,6 @@
-import { humanizeBytes } from "../../lib/utils.js";
-import { LimitError } from "../../lib/LimitError.js";
-import { MultipartFileTooLargeError } from "../../lib/MultipartFileTooLargeError.js";
-import path from "node:path";
-import assert from "node:assert";
-import { randomUUID } from "node:crypto";
-import fs from "node:fs/promises";
-import { createWriteStream } from "node:fs";
-import { PassThrough, Readable } from "node:stream";
-import { pipeline } from "node:stream/promises";
-import parse from "co-busboy";
-import dayjs from "dayjs";
-import { Context } from "egg";
+import "../../utils-BwL2JNe7.js";
+import "../../LimitError-BZqeZJ5w.js";
+import "../../MultipartFileTooLargeError-CFG577Bz.js";
+import { MultipartContext } from "../../context-CLeGGj9o.js";
 
-//#region src/app/extend/context.ts
-const HAS_CONSUMED = Symbol("Context#multipartHasConsumed");
-var MultipartContext = class extends Context {
-	/**
-	* create multipart.parts instance, to get separated files.
-	* @function Context#multipart
-	* @param {Object} [options] - override default multipart configurations
-	*  - {Boolean} options.autoFields
-	*  - {String} options.defaultCharset
-	*  - {String} options.defaultParamCharset
-	*  - {Object} options.limits
-	*  - {Function} options.checkFile
-	* @return {Yieldable | AsyncIterable<Yieldable>} parts
-	*/
-	multipart(options = {}) {
-		const ctx = this;
-		if (!ctx.is("multipart")) ctx.throw(400, "Content-Type must be multipart/*");
-		assert(!ctx[HAS_CONSUMED], "the multipart request can't be consumed twice");
-		ctx[HAS_CONSUMED] = true;
-		const { autoFields, defaultCharset, defaultParamCharset, checkFile } = ctx.app.config.multipart;
-		const { fieldNameSize, fieldSize, fields, fileSize, files } = ctx.app.config.multipart;
-		options = extractOptions(options);
-		const parseOptions = Object.assign({
-			autoFields,
-			defCharset: defaultCharset,
-			defParamCharset: defaultParamCharset,
-			checkFile
-		}, options);
-		parseOptions.limits = Object.assign({
-			fieldNameSize,
-			fieldSize,
-			fields,
-			fileSize,
-			files
-		}, options.limits);
-		const parts = parse(this, parseOptions);
-		parts[Symbol.asyncIterator] = async function* () {
-			let part;
-			do {
-				part = await parts();
-				if (!part) continue;
-				if (Array.isArray(part)) {
-					if (part[3]) throw new LimitError("Request_fieldSize_limit", "Reach fieldSize limit");
-				} else {
-					if (!part.filename) {
-						ctx.coreLogger.debug("[egg-multipart] file field `%s` is upload without file stream, will drop it.", part.fieldname);
-						await pipeline(part, new PassThrough());
-						continue;
-					}
-					if (part.truncated) throw new LimitError("Request_fileSize_limit", "Reach fileSize limit");
-					else part.once("limit", function() {
-						this.emit("error", new LimitError("Request_fileSize_limit", "Reach fileSize limit"));
-						this.resume();
-					});
-				}
-				yield part;
-			} while (part !== void 0);
-		};
-		return parts;
-	}
-	/**
-	* save request multipart data and files to `ctx.request`
-	* @function Context#saveRequestFiles
-	* @param {Object} options - { limits, checkFile, ... }
-	*/
-	async saveRequestFiles(options = {}) {
-		const ctx = this;
-		const allowArrayField = ctx.app.config.multipart.allowArrayField;
-		let storeDir;
-		const requestBody = {};
-		const requestFiles = [];
-		options.autoFields = false;
-		const parts = ctx.multipart(options);
-		try {
-			for await (const part of parts) if (Array.isArray(part)) {
-				const [fieldName, fieldValue] = part;
-				if (!allowArrayField) requestBody[fieldName] = fieldValue;
-				else if (!requestBody[fieldName]) requestBody[fieldName] = fieldValue;
-				else if (!Array.isArray(requestBody[fieldName])) requestBody[fieldName] = [requestBody[fieldName], fieldValue];
-				else requestBody[fieldName].push(fieldValue);
-			} else {
-				const { filename, fieldname, encoding, mime } = part;
-				if (!storeDir) {
-					storeDir = path.join(ctx.app.config.multipart.tmpdir, dayjs().format("YYYY/MM/DD/HH"));
-					await fs.mkdir(storeDir, { recursive: true });
-				}
-				const filepath = path.join(storeDir, randomUUID() + path.extname(filename));
-				const target = createWriteStream(filepath);
-				await pipeline(part, target);
-				const meta = {
-					filepath,
-					field: fieldname,
-					filename,
-					encoding,
-					mime,
-					fieldname,
-					transferEncoding: encoding,
-					mimeType: mime
-				};
-				requestFiles.push(meta);
-			}
-		} catch (err) {
-			await ctx.cleanupRequestFiles(requestFiles);
-			throw err;
-		}
-		ctx.request.body = requestBody;
-		ctx.request.files = requestFiles;
-	}
-	/**
-	* get upload file stream
-	* @example
-	* ```js
-	* const stream = await ctx.getFileStream();
-	* // get other fields
-	* console.log(stream.fields);
-	* ```
-	* @function Context#getFileStream
-	* @param {Object} options
-	*  - {Boolean} options.requireFile - required file submit, default is true
-	*  - {String} options.defaultCharset
-	*  - {String} options.defaultParamCharset
-	*  - {Object} options.limits
-	*  - {Function} options.checkFile
-	* @return {ReadStream} stream
-	* @since 1.0.0
-	* @deprecated Not safe enough, use `ctx.multipart()` instead
-	*/
-	async getFileStream(options = {}) {
-		options.autoFields = true;
-		const parts = this.multipart(options);
-		let stream = await parts();
-		if (options.requireFile !== false) {
-			if (!stream || !stream.filename) this.throw(400, "Can't found upload file");
-		}
-		if (!stream) stream = Readable.from([]);
-		if (stream.truncated) throw new LimitError("Request_fileSize_limit", "Request file too large, please check multipart config");
-		stream.fields = parts.field;
-		stream.once("limit", () => {
-			const err = new MultipartFileTooLargeError("Request file too large, please check multipart config", stream.fields, stream.filename);
-			if (stream.listenerCount("error") > 0) {
-				stream.emit("error", err);
-				this.coreLogger.warn(err);
-			} else {
-				this.coreLogger.error(err);
-				stream.on("error", () => {});
-			}
-			stream.resume();
-		});
-		return stream;
-	}
-	/**
-	* clean up request tmp files helper
-	* @function Context#cleanupRequestFiles
-	* @param {Array<String>} [files] - file paths need to cleanup, default is `ctx.request.files`.
-	*/
-	async cleanupRequestFiles(files) {
-		if (!files || !files.length) files = this.request.files;
-		if (Array.isArray(files)) for (const file of files) try {
-			await fs.rm(file.filepath, {
-				force: true,
-				recursive: true
-			});
-		} catch (err) {
-			this.coreLogger.warn("[egg-multipart-cleanupRequestFiles-error] file: %j, error: %s", file, err);
-		}
-	}
-};
-function extractOptions(options = {}) {
-	const opts = {};
-	if (typeof options.autoFields === "boolean") opts.autoFields = options.autoFields;
-	if (options.limits) opts.limits = options.limits;
-	if (options.checkFile) opts.checkFile = options.checkFile;
-	if (options.defCharset) opts.defCharset = options.defCharset;
-	if (options.defParamCharset) opts.defParamCharset = options.defParamCharset;
-	if (options.defaultCharset) opts.defCharset = options.defaultCharset;
-	if (options.defaultParamCharset) opts.defParamCharset = options.defaultParamCharset;
-	if (options.limits) {
-		const limits = opts.limits = { ...options.limits };
-		for (const key in limits) if (key.endsWith("Size") && limits[key]) limits[key] = humanizeBytes(limits[key]);
-	}
-	return opts;
-}
-
-//#endregion
 export { MultipartContext as default };

package/dist/app/middleware/multipart.d.ts

@@ -1,4 +1,4 @@
-import { MultipartConfig } from "../../config/config.default.js";
+import { MultipartConfig } from "../../config.default-CPo4ogXL.js";
 import { Application, MiddlewareFunc } from "egg";
 
 //#region src/app/middleware/multipart.d.ts

package/dist/app/schedule/clean_tmpdir.d.ts

@@ -14,7 +14,7 @@ declare const _default: (app: Application) => {
     pathName?: string;
     app: Application;
     service: egg0.Controller;
-    "#logger"?: egg_lib_core_base_context_logger0.BaseContextLogger;
+    "__#private@#logger"?: egg_lib_core_base_context_logger0.BaseContextLogger;
     get logger(): egg_lib_core_base_context_logger0.BaseContextLogger;
     config: Record<string, any>;
   };

package/dist/app.js

@@ -1,4 +1,4 @@
-import { normalizeOptions } from "./lib/utils.js";
+import { normalizeOptions } from "./utils-BwL2JNe7.js";
 
 //#region src/app.ts
 var AppBootHook = class {

package/dist/config/config.default.d.ts

@@ -1,92 +1,2 @@
-import { Context, EggAppInfo } from "egg";
-import { PathMatchingPattern } from "egg-path-matching";
-
-//#region src/config/config.default.d.ts
-type MatchItem = string | RegExp | ((ctx: Context) => boolean);
-interface MultipartConfig {
-  /**
-   * which mode to handle multipart request, default is `stream`, the hard way.
-   * If set mode to `file`, it's the easy way to handle multipart request and save it to local files.
-   * If you don't know the Node.js Stream work, maybe you should use the `file` mode to get started.
-   */
-  mode: 'stream' | 'file';
-  /**
-   * special url to use file mode when global `mode` is `stream`.
-   */
-  fileModeMatch?: PathMatchingPattern;
-  /**
-   * Auto set fields to parts, default is `false`.
-   * Only work on `stream` mode.
-   * If set true，all fields will be auto handle and can access by `parts.fields`
-   */
-  autoFields: boolean;
-  /**
-   * default charset encoding, don't change it before you real know about it
-   * Default is `utf8`
-   */
-  defaultCharset: string;
-  /**
-   * For multipart forms, the default character set to use for values of part header parameters (e.g. filename)
-   * that are not extended parameters (that contain an explicit charset), don't change it before you real know about it
-   * Default is `utf8`
-   */
-  defaultParamCharset: string;
-  /**
-   * Max field name size (in bytes), default is `100`
-   */
-  fieldNameSize: number;
-  /**
-   * Max field value size (in bytes), default is `100kb`
-   */
-  fieldSize: string | number;
-  /**
-   * Max number of non-file fields, default is `10`
-   */
-  fields: number;
-  /**
-   * Max file size (in bytes), default is `10mb`
-   */
-  fileSize: string | number;
-  /**
-   * Max number of file fields, default is `10`
-   */
-  files: number;
-  /**
-   * Add more ext file names to the `whitelist`, default is `[]`, only valid when `whitelist` is `null`
-   */
-  fileExtensions: string[];
-  /**
-   * The white ext file names, default is `null`
-   */
-  whitelist: string[] | ((filename: string) => boolean) | null;
-  /**
-   * Allow array field, default is `false`
-   */
-  allowArrayField: boolean;
-  /**
-   * The directory for temporary files. Only work on `file` mode.
-   * Default is `os.tmpdir()/egg-multipart-tmp/${appInfo.name}`
-   */
-  tmpdir: string;
-  /**
-   * The schedule for cleaning temporary files. Only work on `file` mode.
-   */
-  cleanSchedule: {
-    /**
-     * The cron expression for the schedule.
-     * Default is `0 30 4 * * *`
-     * @see https://github.com/eggjs/egg/tree/next/plugins/schedule#cron-style-scheduling
-     */
-    cron: string;
-    /**
-     * Default is `false`
-     */
-    disable: boolean;
-  };
-  checkFile?(fieldname: string, file: any, filename: string, encoding: string, mimetype: string): void | Error;
-}
-declare const _default: (appInfo: EggAppInfo) => {
-  multipart: MultipartConfig;
-};
-//#endregion
+import { MatchItem, MultipartConfig, _default } from "../config.default-CPo4ogXL.js";
 export { MatchItem, MultipartConfig, _default as default };

package/dist/config/config.default.js

@@ -1,28 +1,3 @@
-import path from "node:path";
-import os from "node:os";
+import { config_default_default } from "../config.default-AMmYIt7n.js";
 
-//#region src/config/config.default.ts
-var config_default_default = (appInfo) => {
-	return { multipart: {
-		mode: "stream",
-		autoFields: false,
-		defaultCharset: "utf8",
-		defaultParamCharset: "utf8",
-		fieldNameSize: 100,
-		fieldSize: "100kb",
-		fields: 10,
-		fileSize: "10mb",
-		files: 10,
-		fileExtensions: [],
-		whitelist: null,
-		allowArrayField: false,
-		tmpdir: path.join(os.tmpdir(), "egg-multipart-tmp", appInfo.name),
-		cleanSchedule: {
-			cron: "0 30 4 * * *",
-			disable: false
-		}
-	} };
-};
-
-//#endregion
 export { config_default_default as default };

package/dist/config.default-AMmYIt7n.js

@@ -0,0 +1,28 @@
+import path from "node:path";
+import os from "node:os";
+
+//#region src/config/config.default.ts
+var config_default_default = (appInfo) => {
+	return { multipart: {
+		mode: "stream",
+		autoFields: false,
+		defaultCharset: "utf8",
+		defaultParamCharset: "utf8",
+		fieldNameSize: 100,
+		fieldSize: "100kb",
+		fields: 10,
+		fileSize: "10mb",
+		files: 10,
+		fileExtensions: [],
+		whitelist: null,
+		allowArrayField: false,
+		tmpdir: path.join(os.tmpdir(), "egg-multipart-tmp", appInfo.name),
+		cleanSchedule: {
+			cron: "0 30 4 * * *",
+			disable: false
+		}
+	} };
+};
+
+//#endregion
+export { config_default_default };

package/dist/config.default-CPo4ogXL.d.ts

@@ -0,0 +1,92 @@
+import { Context, EggAppInfo } from "egg";
+import { PathMatchingPattern } from "egg-path-matching";
+
+//#region src/config/config.default.d.ts
+type MatchItem = string | RegExp | ((ctx: Context) => boolean);
+interface MultipartConfig {
+  /**
+   * which mode to handle multipart request, default is `stream`, the hard way.
+   * If set mode to `file`, it's the easy way to handle multipart request and save it to local files.
+   * If you don't know the Node.js Stream work, maybe you should use the `file` mode to get started.
+   */
+  mode: 'stream' | 'file';
+  /**
+   * special url to use file mode when global `mode` is `stream`.
+   */
+  fileModeMatch?: PathMatchingPattern;
+  /**
+   * Auto set fields to parts, default is `false`.
+   * Only work on `stream` mode.
+   * If set true，all fields will be auto handle and can access by `parts.fields`
+   */
+  autoFields: boolean;
+  /**
+   * default charset encoding, don't change it before you real know about it
+   * Default is `utf8`
+   */
+  defaultCharset: string;
+  /**
+   * For multipart forms, the default character set to use for values of part header parameters (e.g. filename)
+   * that are not extended parameters (that contain an explicit charset), don't change it before you real know about it
+   * Default is `utf8`
+   */
+  defaultParamCharset: string;
+  /**
+   * Max field name size (in bytes), default is `100`
+   */
+  fieldNameSize: number;
+  /**
+   * Max field value size (in bytes), default is `100kb`
+   */
+  fieldSize: string | number;
+  /**
+   * Max number of non-file fields, default is `10`
+   */
+  fields: number;
+  /**
+   * Max file size (in bytes), default is `10mb`
+   */
+  fileSize: string | number;
+  /**
+   * Max number of file fields, default is `10`
+   */
+  files: number;
+  /**
+   * Add more ext file names to the `whitelist`, default is `[]`, only valid when `whitelist` is `null`
+   */
+  fileExtensions: string[];
+  /**
+   * The white ext file names, default is `null`
+   */
+  whitelist: string[] | ((filename: string) => boolean) | null;
+  /**
+   * Allow array field, default is `false`
+   */
+  allowArrayField: boolean;
+  /**
+   * The directory for temporary files. Only work on `file` mode.
+   * Default is `os.tmpdir()/egg-multipart-tmp/${appInfo.name}`
+   */
+  tmpdir: string;
+  /**
+   * The schedule for cleaning temporary files. Only work on `file` mode.
+   */
+  cleanSchedule: {
+    /**
+     * The cron expression for the schedule.
+     * Default is `0 30 4 * * *`
+     * @see https://github.com/eggjs/egg/tree/next/plugins/schedule#cron-style-scheduling
+     */
+    cron: string;
+    /**
+     * Default is `false`
+     */
+    disable: boolean;
+  };
+  checkFile?(fieldname: string, file: any, filename: string, encoding: string, mimetype: string): void | Error;
+}
+declare const _default: (appInfo: EggAppInfo) => {
+  multipart: MultipartConfig;
+};
+//#endregion
+export { MatchItem, MultipartConfig, _default };

package/dist/context-CLeGGj9o.js

@@ -0,0 +1,199 @@
+import { humanizeBytes } from "./utils-BwL2JNe7.js";
+import { LimitError } from "./LimitError-BZqeZJ5w.js";
+import { MultipartFileTooLargeError } from "./MultipartFileTooLargeError-CFG577Bz.js";
+import path from "node:path";
+import assert from "node:assert";
+import { randomUUID } from "node:crypto";
+import fs from "node:fs/promises";
+import { createWriteStream } from "node:fs";
+import { PassThrough, Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import parse from "co-busboy";
+import dayjs from "dayjs";
+import { Context } from "egg";
+
+//#region src/app/extend/context.ts
+const HAS_CONSUMED = Symbol("Context#multipartHasConsumed");
+var MultipartContext = class extends Context {
+	/**
+	* create multipart.parts instance, to get separated files.
+	* @function Context#multipart
+	* @param {Object} [options] - override default multipart configurations
+	*  - {Boolean} options.autoFields
+	*  - {String} options.defaultCharset
+	*  - {String} options.defaultParamCharset
+	*  - {Object} options.limits
+	*  - {Function} options.checkFile
+	* @return {Yieldable | AsyncIterable<Yieldable>} parts
+	*/
+	multipart(options = {}) {
+		const ctx = this;
+		if (!ctx.is("multipart")) ctx.throw(400, "Content-Type must be multipart/*");
+		assert(!ctx[HAS_CONSUMED], "the multipart request can't be consumed twice");
+		ctx[HAS_CONSUMED] = true;
+		const { autoFields, defaultCharset, defaultParamCharset, checkFile } = ctx.app.config.multipart;
+		const { fieldNameSize, fieldSize, fields, fileSize, files } = ctx.app.config.multipart;
+		options = extractOptions(options);
+		const parseOptions = Object.assign({
+			autoFields,
+			defCharset: defaultCharset,
+			defParamCharset: defaultParamCharset,
+			checkFile
+		}, options);
+		parseOptions.limits = Object.assign({
+			fieldNameSize,
+			fieldSize,
+			fields,
+			fileSize,
+			files
+		}, options.limits);
+		const parts = parse(this, parseOptions);
+		parts[Symbol.asyncIterator] = async function* () {
+			let part;
+			do {
+				part = await parts();
+				if (!part) continue;
+				if (Array.isArray(part)) {
+					if (part[3]) throw new LimitError("Request_fieldSize_limit", "Reach fieldSize limit");
+				} else {
+					if (!part.filename) {
+						ctx.coreLogger.debug("[egg-multipart] file field `%s` is upload without file stream, will drop it.", part.fieldname);
+						await pipeline(part, new PassThrough());
+						continue;
+					}
+					if (part.truncated) throw new LimitError("Request_fileSize_limit", "Reach fileSize limit");
+					else part.once("limit", function() {
+						this.emit("error", new LimitError("Request_fileSize_limit", "Reach fileSize limit"));
+						this.resume();
+					});
+				}
+				yield part;
+			} while (part !== void 0);
+		};
+		return parts;
+	}
+	/**
+	* save request multipart data and files to `ctx.request`
+	* @function Context#saveRequestFiles
+	* @param {Object} options - { limits, checkFile, ... }
+	*/
+	async saveRequestFiles(options = {}) {
+		const ctx = this;
+		const allowArrayField = ctx.app.config.multipart.allowArrayField;
+		let storeDir;
+		const requestBody = {};
+		const requestFiles = [];
+		options.autoFields = false;
+		const parts = ctx.multipart(options);
+		try {
+			for await (const part of parts) if (Array.isArray(part)) {
+				const [fieldName, fieldValue] = part;
+				if (!allowArrayField) requestBody[fieldName] = fieldValue;
+				else if (!requestBody[fieldName]) requestBody[fieldName] = fieldValue;
+				else if (!Array.isArray(requestBody[fieldName])) requestBody[fieldName] = [requestBody[fieldName], fieldValue];
+				else requestBody[fieldName].push(fieldValue);
+			} else {
+				const { filename, fieldname, encoding, mime } = part;
+				if (!storeDir) {
+					storeDir = path.join(ctx.app.config.multipart.tmpdir, dayjs().format("YYYY/MM/DD/HH"));
+					await fs.mkdir(storeDir, { recursive: true });
+				}
+				const filepath = path.join(storeDir, randomUUID() + path.extname(filename));
+				const target = createWriteStream(filepath);
+				await pipeline(part, target);
+				const meta = {
+					filepath,
+					field: fieldname,
+					filename,
+					encoding,
+					mime,
+					fieldname,
+					transferEncoding: encoding,
+					mimeType: mime
+				};
+				requestFiles.push(meta);
+			}
+		} catch (err) {
+			await ctx.cleanupRequestFiles(requestFiles);
+			throw err;
+		}
+		ctx.request.body = requestBody;
+		ctx.request.files = requestFiles;
+	}
+	/**
+	* get upload file stream
+	* @example
+	* ```js
+	* const stream = await ctx.getFileStream();
+	* // get other fields
+	* console.log(stream.fields);
+	* ```
+	* @function Context#getFileStream
+	* @param {Object} options
+	*  - {Boolean} options.requireFile - required file submit, default is true
+	*  - {String} options.defaultCharset
+	*  - {String} options.defaultParamCharset
+	*  - {Object} options.limits
+	*  - {Function} options.checkFile
+	* @return {ReadStream} stream
+	* @since 1.0.0
+	* @deprecated Not safe enough, use `ctx.multipart()` instead
+	*/
+	async getFileStream(options = {}) {
+		options.autoFields = true;
+		const parts = this.multipart(options);
+		let stream = await parts();
+		if (options.requireFile !== false) {
+			if (!stream || !stream.filename) this.throw(400, "Can't found upload file");
+		}
+		if (!stream) stream = Readable.from([]);
+		if (stream.truncated) throw new LimitError("Request_fileSize_limit", "Request file too large, please check multipart config");
+		stream.fields = parts.field;
+		stream.once("limit", () => {
+			const err = new MultipartFileTooLargeError("Request file too large, please check multipart config", stream.fields, stream.filename);
+			if (stream.listenerCount("error") > 0) {
+				stream.emit("error", err);
+				this.coreLogger.warn(err);
+			} else {
+				this.coreLogger.error(err);
+				stream.on("error", () => {});
+			}
+			stream.resume();
+		});
+		return stream;
+	}
+	/**
+	* clean up request tmp files helper
+	* @function Context#cleanupRequestFiles
+	* @param {Array<String>} [files] - file paths need to cleanup, default is `ctx.request.files`.
+	*/
+	async cleanupRequestFiles(files) {
+		if (!files || !files.length) files = this.request.files;
+		if (Array.isArray(files)) for (const file of files) try {
+			await fs.rm(file.filepath, {
+				force: true,
+				recursive: true
+			});
+		} catch (err) {
+			this.coreLogger.warn("[egg-multipart-cleanupRequestFiles-error] file: %j, error: %s", file, err);
+		}
+	}
+};
+function extractOptions(options = {}) {
+	const opts = {};
+	if (typeof options.autoFields === "boolean") opts.autoFields = options.autoFields;
+	if (options.limits) opts.limits = options.limits;
+	if (options.checkFile) opts.checkFile = options.checkFile;
+	if (options.defCharset) opts.defCharset = options.defCharset;
+	if (options.defParamCharset) opts.defParamCharset = options.defParamCharset;
+	if (options.defaultCharset) opts.defCharset = options.defaultCharset;
+	if (options.defaultParamCharset) opts.defParamCharset = options.defaultParamCharset;
+	if (options.limits) {
+		const limits = opts.limits = { ...options.limits };
+		for (const key in limits) if (key.endsWith("Size") && limits[key]) limits[key] = humanizeBytes(limits[key]);
+	}
+	return opts;
+}
+
+//#endregion
+export { MultipartContext };

package/dist/context-COfddVcC.d.ts

@@ -0,0 +1,101 @@
+import { Readable } from "node:stream";
+import { Context } from "egg";
+
+//#region src/app/extend/context.d.ts
+interface EggFile {
+  field: string;
+  filename: string;
+  encoding: string;
+  mime: string;
+  filepath: string;
+}
+interface MultipartFileStream extends Readable {
+  fields: Record<string, any>;
+  filename: string;
+  fieldname: string;
+  mime: string;
+  mimeType: string;
+  transferEncoding: string;
+  encoding: string;
+  truncated: boolean;
+}
+interface MultipartOptions {
+  autoFields?: boolean;
+  /**
+   * required file submit, default is true
+   */
+  requireFile?: boolean;
+  /**
+   * default charset encoding
+   */
+  defaultCharset?: string;
+  /**
+   * compatible with defaultCharset
+   * @deprecated use `defaultCharset` instead
+   */
+  defCharset?: string;
+  defaultParamCharset?: string;
+  /**
+   * compatible with defaultParamCharset
+   * @deprecated use `defaultParamCharset` instead
+   */
+  defParamCharset?: string;
+  limits?: {
+    fieldNameSize?: number;
+    fieldSize?: number;
+    fields?: number;
+    fileSize?: number;
+    files?: number;
+    parts?: number;
+    headerPairs?: number;
+  };
+  checkFile?(fieldname: string, file: any, filename: string, encoding: string, mimetype: string): void | Error;
+}
+declare class MultipartContext extends Context {
+  /**
+   * create multipart.parts instance, to get separated files.
+   * @function Context#multipart
+   * @param {Object} [options] - override default multipart configurations
+   *  - {Boolean} options.autoFields
+   *  - {String} options.defaultCharset
+   *  - {String} options.defaultParamCharset
+   *  - {Object} options.limits
+   *  - {Function} options.checkFile
+   * @return {Yieldable | AsyncIterable<Yieldable>} parts
+   */
+  multipart(options?: MultipartOptions): AsyncIterable<MultipartFileStream>;
+  /**
+   * save request multipart data and files to `ctx.request`
+   * @function Context#saveRequestFiles
+   * @param {Object} options - { limits, checkFile, ... }
+   */
+  saveRequestFiles(options?: MultipartOptions): Promise<void>;
+  /**
+   * get upload file stream
+   * @example
+   * ```js
+   * const stream = await ctx.getFileStream();
+   * // get other fields
+   * console.log(stream.fields);
+   * ```
+   * @function Context#getFileStream
+   * @param {Object} options
+   *  - {Boolean} options.requireFile - required file submit, default is true
+   *  - {String} options.defaultCharset
+   *  - {String} options.defaultParamCharset
+   *  - {Object} options.limits
+   *  - {Function} options.checkFile
+   * @return {ReadStream} stream
+   * @since 1.0.0
+   * @deprecated Not safe enough, use `ctx.multipart()` instead
+   */
+  getFileStream(options?: MultipartOptions): Promise<MultipartFileStream>;
+  /**
+   * clean up request tmp files helper
+   * @function Context#cleanupRequestFiles
+   * @param {Array<String>} [files] - file paths need to cleanup, default is `ctx.request.files`.
+   */
+  cleanupRequestFiles(files?: EggFile[]): Promise<void>;
+}
+//#endregion
+export { EggFile, MultipartContext, MultipartFileStream, MultipartOptions };

package/dist/index.d.ts

@@ -1 +1,3 @@
-export { };
+import "./context-COfddVcC.js";
+import "./config.default-CPo4ogXL.js";
+import "./types-DNLuS6JZ.js";

package/dist/index.js

@@ -1,3 +1,8 @@
-import "./app/extend/context.js";
+import "./utils-BwL2JNe7.js";
+import "./config.default-AMmYIt7n.js";
+import "./LimitError-BZqeZJ5w.js";
+import "./MultipartFileTooLargeError-CFG577Bz.js";
+import "./context-CLeGGj9o.js";
+import "./types-BsuPrIpu.js";
 
 export {  };

package/dist/lib/LimitError.js

@@ -1,15 +1,3 @@
-//#region src/lib/LimitError.ts
-var LimitError = class extends Error {
-	code;
-	status;
-	constructor(code, message) {
-		super(message);
-		this.code = code;
-		this.status = 413;
-		this.name = this.constructor.name;
-		Error.captureStackTrace(this, this.constructor);
-	}
-};
+import { LimitError } from "../LimitError-BZqeZJ5w.js";
 
-//#endregion
 export { LimitError };

package/dist/lib/MultipartFileTooLargeError.js

@@ -1,17 +1,3 @@
-//#region src/lib/MultipartFileTooLargeError.ts
-var MultipartFileTooLargeError = class extends Error {
-	status;
-	fields;
-	filename;
-	constructor(message, fields, filename) {
-		super(message);
-		this.name = this.constructor.name;
-		this.status = 413;
-		this.fields = fields;
-		this.filename = filename;
-		Error.captureStackTrace(this, this.constructor);
-	}
-};
+import { MultipartFileTooLargeError } from "../MultipartFileTooLargeError-CFG577Bz.js";
 
-//#endregion
 export { MultipartFileTooLargeError };

package/dist/lib/utils.d.ts

@@ -1,4 +1,4 @@
-import { MultipartConfig } from "../config/config.default.js";
+import { MultipartConfig } from "../config.default-CPo4ogXL.js";
 
 //#region src/lib/utils.d.ts
 declare const whitelist: string[];

package/dist/lib/utils.js

@@ -1,71 +1,3 @@
-import path from "node:path";
-import assert from "node:assert";
-import bytes from "bytes";
+import { humanizeBytes, normalizeOptions, whitelist } from "../utils-BwL2JNe7.js";
 
-//#region src/lib/utils.ts
-const whitelist = [
-	".jpg",
-	".jpeg",
-	".png",
-	".gif",
-	".bmp",
-	".wbmp",
-	".webp",
-	".tif",
-	".psd",
-	".svg",
-	".js",
-	".jsx",
-	".json",
-	".css",
-	".less",
-	".html",
-	".htm",
-	".xml",
-	".zip",
-	".gz",
-	".tgz",
-	".gzip",
-	".mp3",
-	".mp4",
-	".avi"
-];
-function humanizeBytes(size) {
-	if (typeof size === "number") return size;
-	return bytes(size);
-}
-function normalizeOptions(options) {
-	options.fileSize = humanizeBytes(options.fileSize);
-	options.fieldSize = humanizeBytes(options.fieldSize);
-	options.fieldNameSize = humanizeBytes(options.fieldNameSize);
-	options.mode = options.mode || "stream";
-	assert(["stream", "file"].includes(options.mode), `Expect mode to be 'stream' or 'file', but got '${options.mode}'`);
-	if (options.mode === "file") assert(!options.fileModeMatch, "`fileModeMatch` options only work on stream mode, please remove it");
-	if (Array.isArray(options.whitelist)) options.whitelist = options.whitelist.map((extname) => extname.toLowerCase());
-	if (Array.isArray(options.fileExtensions)) options.fileExtensions = options.fileExtensions.map((extname) => {
-		return extname.startsWith(".") || extname === "" ? extname.toLowerCase() : `.${extname.toLowerCase()}`;
-	});
-	function checkExt(fileName) {
-		if (typeof options.whitelist === "function") return options.whitelist(fileName);
-		const extname = path.extname(fileName).toLowerCase();
-		if (Array.isArray(options.whitelist)) return options.whitelist.includes(extname);
-		return whitelist.includes(extname) || options.fileExtensions.includes(extname);
-	}
-	options.checkFile = (_fieldName, fileStream, fileName) => {
-		if (!fileStream || !fileName) return;
-		try {
-			if (!checkExt(fileName)) {
-				const err = /* @__PURE__ */ new Error("Invalid filename: " + fileName);
-				Reflect.set(err, "status", 400);
-				return err;
-			}
-		} catch (err) {
-			err.status = 400;
-			return err;
-		}
-	};
-	return options;
-}
-
-//#endregion
 export { humanizeBytes, normalizeOptions, whitelist };

package/dist/types-BsuPrIpu.js

@@ -0,0 +1 @@
+export {  };

package/dist/types-DNLuS6JZ.d.ts

@@ -0,0 +1,24 @@
+import { EggFile, MultipartFileStream, MultipartOptions } from "./context-COfddVcC.js";
+import { MultipartConfig } from "./config.default-CPo4ogXL.js";
+
+//#region src/types.d.ts
+declare module 'egg' {
+  interface EggAppConfig {
+    /**
+     * multipart parser options
+     * @member Config#multipart
+     */
+    multipart: MultipartConfig;
+  }
+  interface Request {
+    /**
+     * Files Object Array
+     */
+    files?: EggFile[];
+  }
+  interface Context {
+    saveRequestFiles(options?: MultipartOptions): Promise<void>;
+    getFileStream(options?: MultipartOptions): Promise<MultipartFileStream>;
+    cleanupRequestFiles(files?: EggFile[]): Promise<void>;
+  }
+}

package/dist/types.d.ts

@@ -1,24 +1,3 @@
-import { EggFile, MultipartFileStream, MultipartOptions } from "./app/extend/context.js";
-import { MultipartConfig } from "./config/config.default.js";
-
-//#region src/types.d.ts
-declare module 'egg' {
-  interface EggAppConfig {
-    /**
-     * multipart parser options
-     * @member Config#multipart
-     */
-    multipart: MultipartConfig;
-  }
-  interface Request {
-    /**
-     * Files Object Array
-     */
-    files?: EggFile[];
-  }
-  interface Context {
-    saveRequestFiles(options?: MultipartOptions): Promise<void>;
-    getFileStream(options?: MultipartOptions): Promise<MultipartFileStream>;
-    cleanupRequestFiles(files?: EggFile[]): Promise<void>;
-  }
-}
+import "./context-COfddVcC.js";
+import "./config.default-CPo4ogXL.js";
+import "./types-DNLuS6JZ.js";

package/dist/types.js

@@ -1 +1,3 @@
+import "./types-BsuPrIpu.js";
+
 export {  };

package/dist/utils-BwL2JNe7.js

@@ -0,0 +1,71 @@
+import path from "node:path";
+import assert from "node:assert";
+import bytes from "bytes";
+
+//#region src/lib/utils.ts
+const whitelist = [
+	".jpg",
+	".jpeg",
+	".png",
+	".gif",
+	".bmp",
+	".wbmp",
+	".webp",
+	".tif",
+	".psd",
+	".svg",
+	".js",
+	".jsx",
+	".json",
+	".css",
+	".less",
+	".html",
+	".htm",
+	".xml",
+	".zip",
+	".gz",
+	".tgz",
+	".gzip",
+	".mp3",
+	".mp4",
+	".avi"
+];
+function humanizeBytes(size) {
+	if (typeof size === "number") return size;
+	return bytes(size);
+}
+function normalizeOptions(options) {
+	options.fileSize = humanizeBytes(options.fileSize);
+	options.fieldSize = humanizeBytes(options.fieldSize);
+	options.fieldNameSize = humanizeBytes(options.fieldNameSize);
+	options.mode = options.mode || "stream";
+	assert(["stream", "file"].includes(options.mode), `Expect mode to be 'stream' or 'file', but got '${options.mode}'`);
+	if (options.mode === "file") assert(!options.fileModeMatch, "`fileModeMatch` options only work on stream mode, please remove it");
+	if (Array.isArray(options.whitelist)) options.whitelist = options.whitelist.map((extname) => extname.toLowerCase());
+	if (Array.isArray(options.fileExtensions)) options.fileExtensions = options.fileExtensions.map((extname) => {
+		return extname.startsWith(".") || extname === "" ? extname.toLowerCase() : `.${extname.toLowerCase()}`;
+	});
+	function checkExt(fileName) {
+		if (typeof options.whitelist === "function") return options.whitelist(fileName);
+		const extname = path.extname(fileName).toLowerCase();
+		if (Array.isArray(options.whitelist)) return options.whitelist.includes(extname);
+		return whitelist.includes(extname) || options.fileExtensions.includes(extname);
+	}
+	options.checkFile = (_fieldName, fileStream, fileName) => {
+		if (!fileStream || !fileName) return;
+		try {
+			if (!checkExt(fileName)) {
+				const err = /* @__PURE__ */ new Error("Invalid filename: " + fileName);
+				Reflect.set(err, "status", 400);
+				return err;
+			}
+		} catch (err) {
+			err.status = 400;
+			return err;
+		}
+	};
+	return options;
+}
+
+//#endregion
+export { humanizeBytes, normalizeOptions, whitelist };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eggjs/multipart",
-  "version": "5.0.0-beta.18",
+  "version": "5.0.0-beta.20",
   "description": "multipart plugin for egg",
   "eggPlugin": {
     "name": "multipart",
@@ -52,21 +52,21 @@
     "egg-path-matching": "^2.0.0"
   },
   "peerDependencies": {
-    "egg": "4.1.0-beta.18"
+    "egg": "4.1.0-beta.20"
   },
   "devDependencies": {
     "@types/bytes": "^3.1.5",
-    "@types/node": "24.5.2",
+    "@types/node": "^24.6.2",
     "formstream": "^1.5.1",
     "is-type-of": "^2.2.0",
     "stream-wormhole": "^2.0.1",
     "tsdown": "^0.15.4",
-    "typescript": "5.9.2",
+    "typescript": "^5.9.3",
     "urllib": "^4.8.2",
-    "vitest": "4.0.0-beta.13",
-    "@eggjs/mock": "7.0.0-beta.18",
-    "@eggjs/tsconfig": "3.1.0-beta.18",
-    "@eggjs/schedule": "6.0.0-beta.18"
+    "vitest": "4.0.0-beta.16",
+    "@eggjs/mock": "7.0.0-beta.20",
+    "@eggjs/schedule": "6.0.0-beta.20",
+    "@eggjs/tsconfig": "3.1.0-beta.20"
   },
   "files": [
     "dist"