@maroonedsoftware/multipart 1.0.0 → 1.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maroonedsoftware/multipart",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "A robust multipart form-data and multipart/related parser for Node.js HTTP servers.",
   "author": {
     "name": "Marooned Software",
@@ -34,7 +34,7 @@
   ],
   "dependencies": {
     "@fastify/busboy": "^3.2.0",
-    "@maroonedsoftware/errors": "1.0.0"
+    "@maroonedsoftware/errors": "1.1.0"
   },
   "devDependencies": {
     "@repo/config-typescript": "0.0.0",

package/dist/multipart.related.parser.d.ts

@@ -1,120 +0,0 @@
-import { IncomingMessage } from 'node:http';
-import { FileHandler, MultipartData } from './types.js';
-import { Readable, Writable } from 'node:stream';
-/**
- * Extended Readable stream interface for multipart/related file parts.
- *
- * Provides additional metadata about the stream state including whether
- * the stream was truncated due to size limits and the total bytes read.
- */
-export interface MultipartRelatedFileStream extends Readable {
-    /** Whether the file stream was truncated due to size limits */
-    truncated: boolean;
-    /** The number of bytes that have been read from the stream so far */
-    bytesRead: number;
-}
-/**
- * Parser for multipart/related content type requests.
- *
- * The multipart/related content type is used when multiple related parts
- * need to be processed together, such as email messages with inline attachments
- * or SOAP messages with MIME attachments.
- *
- * This parser extends Writable to act as a stream destination for the incoming
- * request body, parsing parts as they arrive and invoking handlers for files.
- *
- * @extends Writable
- *
- * @example
- * ```typescript
- * import { IncomingMessage } from 'node:http';
- * import { MultipartRelatedParser } from './multipart.related.parser.js';
- *
- * async function handleRelatedContent(req: IncomingMessage) {
- *   const parser = new MultipartRelatedParser(req);
- *
- *   const parts = await parser.parse(async (fieldname, stream, filename) => {
- *     // Process each related part
- *     const content = await streamToBuffer(stream);
- *     console.log(`Received ${filename}: ${content.length} bytes`);
- *   });
- * }
- * ```
- */
-export declare class MultipartRelatedParser extends Writable {
-    private readonly req;
-    /** Map storing parsed fields and files keyed by field name */
-    private readonly fields;
-    /** Optional handler for processing file uploads */
-    private fileHandler?;
-    /** A null stream used to drain file streams when errors occur */
-    private readonly nullStream;
-    /**
-     * Creates a new MultipartRelatedParser instance.
-     *
-     * @param req - The incoming HTTP request containing multipart/related data
-     */
-    constructor(req: IncomingMessage);
-    /**
-     * Parses the multipart/related request body.
-     *
-     * @param fileHandler - A callback function to handle file parts as they are received.
-     *                      Each file part triggers the handler with the field name, stream,
-     *                      filename, encoding, and MIME type.
-     * @returns A promise that resolves to a Map of field names to their parsed data.
-     *          If multiple values exist for a field name, they are stored as an array.
-     *
-     * @throws {HttpError} 413 error if parts, files, or fields limits are exceeded
-     *
-     * @example
-     * ```typescript
-     * const parts = await parser.parse(async (fieldname, stream, filename) => {
-     *   const chunks: Buffer[] = [];
-     *   for await (const chunk of stream) {
-     *     chunks.push(chunk);
-     *   }
-     *   // Process the complete content
-     *   processContent(Buffer.concat(chunks));
-     * });
-     * ```
-     */
-    parse(fileHandler: FileHandler): Promise<Map<string, MultipartData | MultipartData[]>>;
-    /**
-     * Stores parsed data in the fields map, handling multiple values for the same field.
-     *
-     * @param name - The field name
-     * @param data - The parsed field or file data
-     */
-    private setData;
-    /**
-     * Handler for parsed form fields.
-     */
-    private onField;
-    /**
-     * Handler for parsed file uploads.
-     */
-    private onFile;
-    private resolve;
-    private reject;
-    /**
-     * Handler called when parsing completes or an error occurs.
-     */
-    private onEnd;
-    /**
-     * Handler for when the parts limit is exceeded.
-     */
-    private onPartsLimit;
-    /**
-     * Handler for when the files limit is exceeded.
-     */
-    private onFilesLimit;
-    /**
-     * Handler for when the fields limit is exceeded.
-     */
-    private onFieldsLimit;
-    /**
-     * Cleans up event listeners to prevent memory leaks.
-     */
-    private cleanup;
-}
-//# sourceMappingURL=multipart.related.parser.d.ts.map

package/dist/multipart.related.parser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multipart.related.parser.d.ts","sourceRoot":"","sources":["../src/multipart.related.parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGjD;;;;;GAKG;AACH,MAAM,WAAW,0BAA2B,SAAQ,QAAQ;IAC1D,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAmBtC,OAAO,CAAC,QAAQ,CAAC,GAAG;IAlBhC,8DAA8D;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsD;IAE7E,mDAAmD;IACnD,OAAO,CAAC,WAAW,CAAC,CAAc;IAElC,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAIxB;IAEH;;;;OAIG;gBAC0B,GAAG,EAAE,eAAe;IAIjD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,KAAK,CAAC,WAAW,EAAE,WAAW;IAS9B;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAWf;;OAEG;IACH,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IAEd;;OAEG;IACH,OAAO,CAAC,KAAK;IASb;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;IACH,OAAO,CAAC,OAAO;CAUhB"}