@bernierllc/file-uploader 0.1.0

package/dist/file-uploader.d.ts

@@ -0,0 +1,25 @@
+import type { IncomingMessage } from 'http';
+import type { UploadConfig, FileInfo, UploadProgress, UploadResult } from './types.js';
+/**
+ * Multipart file upload handler
+ */
+export declare class FileUploader {
+    private readonly config;
+    private readonly progressMap;
+    constructor(config?: UploadConfig);
+    /**
+     * Handle multipart form upload
+     */
+    handleMultipart(req: IncomingMessage): Promise<UploadResult[]>;
+    /**
+     * Validate file
+     */
+    validateFile(file: FileInfo): {
+        valid: boolean;
+        error?: string;
+    };
+    /**
+     * Get upload progress
+     */
+    getProgress(fileId: string): UploadProgress | null;
+}

package/dist/file-uploader.js

@@ -0,0 +1,168 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+import { createLogger } from '@bernierllc/logger';
+import Busboy from 'busboy';
+import { randomUUID } from 'crypto';
+const logger = createLogger();
+/**
+ * Multipart file upload handler
+ */
+export class FileUploader {
+    constructor(config = {}) {
+        this.progressMap = new Map();
+        this.config = {
+            maxFileSize: config.maxFileSize ?? 10 * 1024 * 1024, // 10MB default
+            maxFiles: config.maxFiles ?? 10,
+            allowedMimeTypes: config.allowedMimeTypes,
+            destination: config.destination,
+            onProgress: config.onProgress
+        };
+    }
+    /**
+     * Handle multipart form upload
+     */
+    async handleMultipart(req) {
+        return new Promise((resolve, reject) => {
+            const results = [];
+            let fileCount = 0;
+            const errors = [];
+            const bb = Busboy({ headers: req.headers });
+            bb.on('file', (fieldname, file, info) => {
+                fileCount++;
+                if (fileCount > this.config.maxFiles) {
+                    const error = new Error(`Maximum file count exceeded: ${this.config.maxFiles}`);
+                    errors.push(error);
+                    file.resume();
+                    return;
+                }
+                const fileId = randomUUID();
+                const fileInfo = {
+                    fieldname,
+                    filename: info.filename,
+                    encoding: info.encoding,
+                    mimeType: info.mimeType,
+                    size: 0
+                };
+                // Validate file
+                const validation = this.validateFile(fileInfo);
+                if (!validation.valid) {
+                    const error = new Error(validation.error || 'File validation failed');
+                    errors.push(error);
+                    file.resume();
+                    return;
+                }
+                // Track progress
+                let bytesUploaded = 0;
+                const progress = {
+                    fileId,
+                    bytesUploaded: 0,
+                    totalBytes: 0,
+                    percentage: 0
+                };
+                this.progressMap.set(fileId, progress);
+                // Collect file data
+                const chunks = [];
+                file.on('data', (chunk) => {
+                    chunks.push(chunk);
+                    bytesUploaded += chunk.length;
+                    fileInfo.size = bytesUploaded;
+                    // Update progress
+                    progress.bytesUploaded = bytesUploaded;
+                    progress.totalBytes = bytesUploaded; // Will be updated when complete
+                    progress.percentage = this.config.maxFileSize
+                        ? Math.min(100, (bytesUploaded / this.config.maxFileSize) * 100)
+                        : 0;
+                    if (this.config.onProgress) {
+                        this.config.onProgress(progress);
+                    }
+                    // Check size limit
+                    if (bytesUploaded > this.config.maxFileSize) {
+                        const error = new Error(`File size exceeded: ${this.config.maxFileSize} bytes`);
+                        errors.push(error);
+                        file.resume();
+                    }
+                });
+                file.on('end', async () => {
+                    try {
+                        const buffer = Buffer.concat(chunks);
+                        fileInfo.size = buffer.length;
+                        // Update final progress
+                        progress.totalBytes = buffer.length;
+                        progress.percentage = 100;
+                        if (this.config.onProgress) {
+                            this.config.onProgress(progress);
+                        }
+                        // Determine destination
+                        let destination;
+                        if (typeof this.config.destination === 'function') {
+                            destination = await this.config.destination(fileInfo);
+                        }
+                        else {
+                            destination = this.config.destination || `/uploads/${fileId}-${fileInfo.filename}`;
+                        }
+                        const result = {
+                            fileId,
+                            filename: fileInfo.filename,
+                            size: buffer.length,
+                            mimeType: fileInfo.mimeType,
+                            destination
+                        };
+                        results.push(result);
+                        this.progressMap.delete(fileId);
+                        logger.debug('File uploaded', { fileId, filename: fileInfo.filename, size: buffer.length });
+                    }
+                    catch (error) {
+                        const err = error instanceof Error ? error : new Error(String(error));
+                        errors.push(err);
+                        logger.error('Error processing file', err);
+                    }
+                });
+            });
+            bb.on('finish', () => {
+                if (errors.length > 0) {
+                    reject(new Error(`Upload failed: ${errors.map(e => e.message).join(', ')}`));
+                }
+                else {
+                    resolve(results);
+                }
+            });
+            bb.on('error', (error) => {
+                reject(error);
+            });
+            req.pipe(bb);
+        });
+    }
+    /**
+     * Validate file
+     */
+    validateFile(file) {
+        // Check MIME type
+        if (this.config.allowedMimeTypes && this.config.allowedMimeTypes.length > 0) {
+            if (!this.config.allowedMimeTypes.includes(file.mimeType)) {
+                return {
+                    valid: false,
+                    error: `MIME type ${file.mimeType} not allowed. Allowed types: ${this.config.allowedMimeTypes.join(', ')}`
+                };
+            }
+        }
+        // Check file size (if already known)
+        if (file.size > this.config.maxFileSize) {
+            return {
+                valid: false,
+                error: `File size ${file.size} exceeds maximum ${this.config.maxFileSize} bytes`
+            };
+        }
+        return { valid: true };
+    }
+    /**
+     * Get upload progress
+     */
+    getProgress(fileId) {
+        return this.progressMap.get(fileId) || null;
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { FileUploader } from './file-uploader.js';
+export type { UploadConfig, FileInfo, UploadProgress, UploadResult } from './types.js';

package/dist/index.js

@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+export { FileUploader } from './file-uploader.js';

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * File upload configuration
+ */
+export interface UploadConfig {
+    /** Maximum file size in bytes */
+    maxFileSize?: number;
+    /** Allowed MIME types */
+    allowedMimeTypes?: string[];
+    /** Maximum number of files */
+    maxFiles?: number;
+    /** Destination path or function */
+    destination?: string | ((file: FileInfo) => Promise<string>);
+    /** Progress callback */
+    onProgress?: (progress: UploadProgress) => void;
+}
+/**
+ * File information
+ */
+export interface FileInfo {
+    /** Form field name */
+    fieldname: string;
+    /** Original filename */
+    filename: string;
+    /** File encoding */
+    encoding: string;
+    /** MIME type */
+    mimeType: string;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Upload progress information
+ */
+export interface UploadProgress {
+    /** File identifier */
+    fileId: string;
+    /** Bytes uploaded */
+    bytesUploaded: number;
+    /** Total bytes */
+    totalBytes: number;
+    /** Percentage complete */
+    percentage: number;
+}
+/**
+ * Upload result
+ */
+export interface UploadResult {
+    /** File identifier */
+    fileId: string;
+    /** Filename */
+    filename: string;
+    /** File size */
+    size: number;
+    /** MIME type */
+    mimeType: string;
+    /** Destination path */
+    destination: string;
+    /** Optional URL */
+    url?: string;
+}

package/dist/types.js

@@ -0,0 +1,8 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+export {};

package/jest.config.cjs

@@ -0,0 +1,33 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: '<rootDir>/../../../jest-environment-node-fixed.cjs',
+  roots: ['<rootDir>/__tests__'],
+  testMatch: ['**/*.test.ts'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1'
+  },
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/index.ts'
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90
+    }
+  },
+  coverageDirectory: 'coverage',
+  verbose: true
+};
+

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@bernierllc/file-uploader",
+  "version": "0.1.0",
+  "description": "Multipart file upload handler with validation and progress tracking",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "upload",
+    "multipart",
+    "file",
+    "media",
+    "form-data"
+  ],
+  "author": "Bernier LLC",
+  "license": "SEE LICENSE IN LICENSE",
+  "dependencies": {
+    "busboy": "^1.6.0",
+    "uuid": "^9.0.0",
+    "@bernierllc/logger": "1.0.3"
+  },
+  "devDependencies": {
+    "@types/busboy": "^1.5.0",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@types/uuid": "^9.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.5.0",
+    "rimraf": "^5.0.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:run": "node --experimental-vm-modules node_modules/jest/bin/jest.js --no-watch",
+    "test:coverage": "node --experimental-vm-modules node_modules/jest/bin/jest.js --coverage --no-watch",
+    "lint": "eslint src __tests__ --ext .ts",
+    "lint:fix": "eslint src __tests__ --ext .ts --fix",
+    "clean": "rimraf dist"
+  }
+}

package/src/file-uploader.ts

@@ -0,0 +1,198 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+import { createLogger } from '@bernierllc/logger';
+import Busboy from 'busboy';
+import type { IncomingMessage } from 'http';
+import { randomUUID } from 'crypto';
+import type { UploadConfig, FileInfo, UploadProgress, UploadResult } from './types.js';
+
+const logger = createLogger();
+
+/**
+ * Multipart file upload handler
+ */
+export class FileUploader {
+  private readonly config: Required<Pick<UploadConfig, 'maxFileSize' | 'maxFiles'>> & Partial<UploadConfig>;
+  private readonly progressMap = new Map<string, UploadProgress>();
+
+  constructor(config: UploadConfig = {}) {
+    this.config = {
+      maxFileSize: config.maxFileSize ?? 10 * 1024 * 1024, // 10MB default
+      maxFiles: config.maxFiles ?? 10,
+      allowedMimeTypes: config.allowedMimeTypes,
+      destination: config.destination,
+      onProgress: config.onProgress
+    };
+  }
+
+  /**
+   * Handle multipart form upload
+   */
+  async handleMultipart(req: IncomingMessage): Promise<UploadResult[]> {
+    return new Promise((resolve, reject) => {
+      const results: UploadResult[] = [];
+      let fileCount = 0;
+      const errors: Error[] = [];
+
+      const bb = Busboy({ headers: req.headers });
+
+      bb.on('file', (fieldname, file, info) => {
+        fileCount++;
+
+        if (fileCount > this.config.maxFiles) {
+          const error = new Error(`Maximum file count exceeded: ${this.config.maxFiles}`);
+          errors.push(error);
+          file.resume();
+          return;
+        }
+
+        const fileId = randomUUID();
+        const fileInfo: FileInfo = {
+          fieldname,
+          filename: info.filename,
+          encoding: info.encoding,
+          mimeType: info.mimeType,
+          size: 0
+        };
+
+        // Validate file
+        const validation = this.validateFile(fileInfo);
+        if (!validation.valid) {
+          const error = new Error(validation.error || 'File validation failed');
+          errors.push(error);
+          file.resume();
+          return;
+        }
+
+        // Track progress
+        let bytesUploaded = 0;
+        const progress: UploadProgress = {
+          fileId,
+          bytesUploaded: 0,
+          totalBytes: 0,
+          percentage: 0
+        };
+        this.progressMap.set(fileId, progress);
+
+        // Collect file data
+        const chunks: Buffer[] = [];
+
+        file.on('data', (chunk: Buffer) => {
+          chunks.push(chunk);
+          bytesUploaded += chunk.length;
+          fileInfo.size = bytesUploaded;
+
+          // Update progress
+          progress.bytesUploaded = bytesUploaded;
+          progress.totalBytes = bytesUploaded; // Will be updated when complete
+          progress.percentage = this.config.maxFileSize
+            ? Math.min(100, (bytesUploaded / this.config.maxFileSize) * 100)
+            : 0;
+
+          if (this.config.onProgress) {
+            this.config.onProgress(progress);
+          }
+
+          // Check size limit
+          if (bytesUploaded > this.config.maxFileSize) {
+            const error = new Error(`File size exceeded: ${this.config.maxFileSize} bytes`);
+            errors.push(error);
+            file.resume();
+          }
+        });
+
+        file.on('end', async () => {
+          try {
+            const buffer = Buffer.concat(chunks as readonly Uint8Array[]);
+            fileInfo.size = buffer.length;
+
+            // Update final progress
+            progress.totalBytes = buffer.length;
+            progress.percentage = 100;
+            if (this.config.onProgress) {
+              this.config.onProgress(progress);
+            }
+
+            // Determine destination
+            let destination: string;
+            if (typeof this.config.destination === 'function') {
+              destination = await this.config.destination(fileInfo);
+            } else {
+              destination = this.config.destination || `/uploads/${fileId}-${fileInfo.filename}`;
+            }
+
+            const result: UploadResult = {
+              fileId,
+              filename: fileInfo.filename,
+              size: buffer.length,
+              mimeType: fileInfo.mimeType,
+              destination
+            };
+
+            results.push(result);
+            this.progressMap.delete(fileId);
+
+            logger.debug('File uploaded', { fileId, filename: fileInfo.filename, size: buffer.length });
+          } catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            errors.push(err);
+            logger.error('Error processing file', err);
+          }
+        });
+      });
+
+      bb.on('finish', () => {
+        if (errors.length > 0) {
+          reject(new Error(`Upload failed: ${errors.map(e => e.message).join(', ')}`));
+        } else {
+          resolve(results);
+        }
+      });
+
+      bb.on('error', (error) => {
+        reject(error);
+      });
+
+      req.pipe(bb);
+    });
+  }
+
+  /**
+   * Validate file
+   */
+  validateFile(file: FileInfo): { valid: boolean; error?: string } {
+    // Check MIME type
+    if (this.config.allowedMimeTypes && this.config.allowedMimeTypes.length > 0) {
+      if (!this.config.allowedMimeTypes.includes(file.mimeType)) {
+        return {
+          valid: false,
+          error: `MIME type ${file.mimeType} not allowed. Allowed types: ${this.config.allowedMimeTypes.join(', ')}`
+        };
+      }
+    }
+
+    // Check file size (if already known)
+    if (file.size > this.config.maxFileSize) {
+      return {
+        valid: false,
+        error: `File size ${file.size} exceeds maximum ${this.config.maxFileSize} bytes`
+      };
+    }
+
+    return { valid: true };
+  }
+
+  /**
+   * Get upload progress
+   */
+  getProgress(fileId: string): UploadProgress | null {
+    return this.progressMap.get(fileId) || null;
+  }
+}
+

package/src/index.ts

@@ -0,0 +1,16 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+export { FileUploader } from './file-uploader.js';
+export type {
+  UploadConfig,
+  FileInfo,
+  UploadProgress,
+  UploadResult
+} from './types.js';
+

package/src/types.ts

@@ -0,0 +1,73 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+
+
+/**
+ * File upload configuration
+ */
+export interface UploadConfig {
+  /** Maximum file size in bytes */
+  maxFileSize?: number;
+  /** Allowed MIME types */
+  allowedMimeTypes?: string[];
+  /** Maximum number of files */
+  maxFiles?: number;
+  /** Destination path or function */
+  destination?: string | ((file: FileInfo) => Promise<string>);
+  /** Progress callback */
+  onProgress?: (progress: UploadProgress) => void;
+}
+
+/**
+ * File information
+ */
+export interface FileInfo {
+  /** Form field name */
+  fieldname: string;
+  /** Original filename */
+  filename: string;
+  /** File encoding */
+  encoding: string;
+  /** MIME type */
+  mimeType: string;
+  /** File size in bytes */
+  size: number;
+}
+
+/**
+ * Upload progress information
+ */
+export interface UploadProgress {
+  /** File identifier */
+  fileId: string;
+  /** Bytes uploaded */
+  bytesUploaded: number;
+  /** Total bytes */
+  totalBytes: number;
+  /** Percentage complete */
+  percentage: number;
+}
+
+/**
+ * Upload result
+ */
+export interface UploadResult {
+  /** File identifier */
+  fileId: string;
+  /** Filename */
+  filename: string;
+  /** File size */
+  size: number;
+  /** MIME type */
+  mimeType: string;
+  /** Destination path */
+  destination: string;
+  /** Optional URL */
+  url?: string;
+}
+

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "lib": ["ES2020"],
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "allowSyntheticDefaultImports": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "__tests__"]
+}
+