express-storage 1.0.0

package/dist/types/storage.types.d.ts

@@ -0,0 +1,70 @@
+import { Request } from 'express';
+export type StorageDriver = 's3' | 's3-presigned' | 'gcs' | 'gcs-presigned' | 'oci' | 'oci-presigned' | 'local';
+export interface FileUploadResult {
+    success: boolean;
+    fileName?: string;
+    fileUrl?: string;
+    error?: string;
+}
+export interface PresignedUrlResult {
+    success: boolean;
+    uploadUrl?: string;
+    viewUrl?: string;
+    error?: string;
+}
+export interface StorageConfig {
+    driver: StorageDriver;
+    bucketName?: string | undefined;
+    localPath?: string | undefined;
+    presignedUrlExpiry?: number | undefined;
+    awsRegion?: string | undefined;
+    awsAccessKey?: string | undefined;
+    awsSecretKey?: string | undefined;
+    gcsProjectId?: string | undefined;
+    gcsCredentials?: string | undefined;
+    ociRegion?: string | undefined;
+    ociCredentials?: string | undefined;
+}
+export interface SingleFileInput {
+    type: 'single';
+    file: Express.Multer.File;
+}
+export interface MultipleFilesInput {
+    type: 'multiple';
+    files: Express.Multer.File[];
+}
+export type FileInput = SingleFileInput | MultipleFilesInput;
+export interface IStorageDriver {
+    upload(file: Express.Multer.File): Promise<FileUploadResult>;
+    uploadMultiple(files: Express.Multer.File[]): Promise<FileUploadResult[]>;
+    generateUploadUrl(fileName: string): Promise<PresignedUrlResult>;
+    generateViewUrl(fileName: string): Promise<PresignedUrlResult>;
+    generateMultipleUploadUrls(fileNames: string[]): Promise<PresignedUrlResult[]>;
+    generateMultipleViewUrls(fileNames: string[]): Promise<PresignedUrlResult[]>;
+    delete(fileName: string): Promise<boolean>;
+    deleteMultiple(fileNames: string[]): Promise<boolean[]>;
+}
+export interface StorageRequest extends Request {
+    storage?: {
+        files?: Express.Multer.File[];
+        uploadResults?: FileUploadResult[];
+    };
+}
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+}
+export interface EnvironmentConfig {
+    FILE_DRIVER: string;
+    BUCKET_NAME?: string | undefined;
+    LOCAL_PATH?: string | undefined;
+    PRESIGNED_URL_EXPIRY?: string | undefined;
+    AWS_REGION?: string | undefined;
+    AWS_ACCESS_KEY?: string | undefined;
+    AWS_SECRET_KEY?: string | undefined;
+    GCS_PROJECT_ID?: string | undefined;
+    GCS_CREDENTIALS?: string | undefined;
+    OCI_REGION?: string | undefined;
+    OCI_CREDENTIALS?: string | undefined;
+}
+//# sourceMappingURL=storage.types.d.ts.map

package/dist/types/storage.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.types.d.ts","sourceRoot":"","sources":["../../src/types/storage.types.ts"],"names":[],"mappings":"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"}

package/dist/types/storage.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=storage.types.js.map

package/dist/types/storage.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.types.js","sourceRoot":"","sources":["../../src/types/storage.types.ts"],"names":[],"mappings":""}

package/dist/utils/config.utils.d.ts

@@ -0,0 +1,21 @@
+import { StorageConfig, EnvironmentConfig, ValidationResult } from '../types/storage.types.js';
+/**
+ * Load environment configuration
+ */
+export declare function loadEnvironmentConfig(): EnvironmentConfig;
+/**
+ * Convert environment config to storage config
+ */
+export declare function environmentToStorageConfig(envConfig: EnvironmentConfig): StorageConfig;
+/**
+ * Validate storage configuration
+ */
+export declare function validateStorageConfig(config: StorageConfig): ValidationResult;
+/**
+ * Load and validate configuration from environment
+ */
+export declare function loadAndValidateConfig(): {
+    config: StorageConfig;
+    validation: ValidationResult;
+};
+//# sourceMappingURL=config.utils.d.ts.map

package/dist/utils/config.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.utils.d.ts","sourceRoot":"","sources":["../../src/utils/config.utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAgC/F;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,CAoBzD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,iBAAiB,GAAG,aAAa,CAwBtF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAuC7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,gBAAgB,CAAA;CAAE,CAM/F"}

package/dist/utils/config.utils.js

@@ -0,0 +1,128 @@
+import dotenv from 'dotenv';
+// Load environment variables
+dotenv.config();
+// Environment variable keys
+const ENV_KEYS = {
+    FILE_DRIVER: 'FILE_DRIVER',
+    BUCKET_NAME: 'BUCKET_NAME',
+    LOCAL_PATH: 'LOCAL_PATH',
+    PRESIGNED_URL_EXPIRY: 'PRESIGNED_URL_EXPIRY',
+    // AWS S3
+    AWS_REGION: 'AWS_REGION',
+    AWS_ACCESS_KEY: 'AWS_ACCESS_KEY',
+    AWS_SECRET_KEY: 'AWS_SECRET_KEY',
+    // Google Cloud Storage
+    GCS_PROJECT_ID: 'GCS_PROJECT_ID',
+    GCS_CREDENTIALS: 'GCS_CREDENTIALS',
+    // Oracle Cloud Infrastructure
+    OCI_REGION: 'OCI_REGION',
+    OCI_CREDENTIALS: 'OCI_CREDENTIALS',
+};
+// Default configuration
+const DEFAULT_CONFIG = {
+    presignedUrlExpiry: 600, // 10 minutes
+    localPath: 'public/express-storage',
+};
+/**
+ * Load environment configuration
+ */
+export function loadEnvironmentConfig() {
+    return {
+        FILE_DRIVER: process.env[ENV_KEYS.FILE_DRIVER] || '',
+        BUCKET_NAME: process.env[ENV_KEYS.BUCKET_NAME] || undefined,
+        LOCAL_PATH: process.env[ENV_KEYS.LOCAL_PATH] || undefined,
+        PRESIGNED_URL_EXPIRY: process.env[ENV_KEYS.PRESIGNED_URL_EXPIRY] || undefined,
+        // AWS S3
+        AWS_REGION: process.env[ENV_KEYS.AWS_REGION] || undefined,
+        AWS_ACCESS_KEY: process.env[ENV_KEYS.AWS_ACCESS_KEY] || undefined,
+        AWS_SECRET_KEY: process.env[ENV_KEYS.AWS_SECRET_KEY] || undefined,
+        // Google Cloud Storage
+        GCS_PROJECT_ID: process.env[ENV_KEYS.GCS_PROJECT_ID] || undefined,
+        GCS_CREDENTIALS: process.env[ENV_KEYS.GCS_CREDENTIALS] || undefined,
+        // Oracle Cloud Infrastructure
+        OCI_REGION: process.env[ENV_KEYS.OCI_REGION] || undefined,
+        OCI_CREDENTIALS: process.env[ENV_KEYS.OCI_CREDENTIALS] || undefined,
+    };
+}
+/**
+ * Convert environment config to storage config
+ */
+export function environmentToStorageConfig(envConfig) {
+    const config = {
+        driver: envConfig.FILE_DRIVER,
+        bucketName: envConfig.BUCKET_NAME,
+        localPath: envConfig.LOCAL_PATH || DEFAULT_CONFIG.localPath,
+        presignedUrlExpiry: envConfig.PRESIGNED_URL_EXPIRY
+            ? parseInt(envConfig.PRESIGNED_URL_EXPIRY, 10)
+            : DEFAULT_CONFIG.presignedUrlExpiry,
+        // AWS S3
+        awsRegion: envConfig.AWS_REGION,
+        awsAccessKey: envConfig.AWS_ACCESS_KEY,
+        awsSecretKey: envConfig.AWS_SECRET_KEY,
+        // Google Cloud Storage
+        gcsProjectId: envConfig.GCS_PROJECT_ID,
+        gcsCredentials: envConfig.GCS_CREDENTIALS,
+        // Oracle Cloud Infrastructure
+        ociRegion: envConfig.OCI_REGION,
+        ociCredentials: envConfig.OCI_CREDENTIALS,
+    };
+    return config;
+}
+/**
+ * Validate storage configuration
+ */
+export function validateStorageConfig(config) {
+    const errors = [];
+    // Validate driver
+    if (!config.driver) {
+        errors.push('FILE_DRIVER is required');
+    }
+    else if (!['s3', 's3-presigned', 'gcs', 'gcs-presigned', 'oci', 'oci-presigned', 'local'].includes(config.driver)) {
+        errors.push(`Invalid FILE_DRIVER: ${config.driver}. Must be one of: s3, s3-presigned, gcs, gcs-presigned, oci, oci-presigned, local`);
+    }
+    // Validate cloud storage requirements
+    if (config.driver?.includes('s3')) {
+        if (!config.bucketName)
+            errors.push('BUCKET_NAME is required for S3');
+        if (!config.awsRegion)
+            errors.push('AWS_REGION is required for S3');
+        if (!config.awsAccessKey)
+            errors.push('AWS_ACCESS_KEY is required for S3');
+        if (!config.awsSecretKey)
+            errors.push('AWS_SECRET_KEY is required for S3');
+    }
+    if (config.driver?.includes('gcs')) {
+        if (!config.bucketName)
+            errors.push('BUCKET_NAME is required for GCS');
+        if (!config.gcsProjectId)
+            errors.push('GCS_PROJECT_ID is required for GCS');
+        if (!config.gcsCredentials)
+            errors.push('GCS_CREDENTIALS is required for GCS');
+    }
+    if (config.driver?.includes('oci')) {
+        if (!config.bucketName)
+            errors.push('BUCKET_NAME is required for OCI');
+        if (!config.ociRegion)
+            errors.push('OCI_REGION is required for OCI');
+        if (!config.ociCredentials)
+            errors.push('OCI_CREDENTIALS is required for OCI');
+    }
+    // Validate presigned URL expiry
+    if (config.presignedUrlExpiry && config.presignedUrlExpiry <= 0) {
+        errors.push('PRESIGNED_URL_EXPIRY must be greater than 0');
+    }
+    return {
+        isValid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Load and validate configuration from environment
+ */
+export function loadAndValidateConfig() {
+    const envConfig = loadEnvironmentConfig();
+    const config = environmentToStorageConfig(envConfig);
+    const validation = validateStorageConfig(config);
+    return { config, validation };
+}
+//# sourceMappingURL=config.utils.js.map

package/dist/utils/config.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.utils.js","sourceRoot":"","sources":["../../src/utils/config.utils.ts"],"names":[],"mappings":"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"}

package/dist/utils/file.utils.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Generate unique filename with unix timestamp
+ */
+export declare function generateUniqueFileName(originalName: string): string;
+/**
+ * Sanitize filename to prevent security issues
+ */
+export declare function sanitizeFileName(fileName: string): string;
+/**
+ * Create month-based directory path
+ */
+export declare function createMonthBasedPath(basePath: string): string;
+/**
+ * Ensure directory exists, create if it doesn't
+ */
+export declare function ensureDirectoryExists(dirPath: string): void;
+/**
+ * Get file size in human readable format
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Validate file size
+ */
+export declare function validateFileSize(fileSize: number, maxSize: number): boolean;
+/**
+ * Validate file type
+ */
+export declare function validateFileType(mimeType: string, allowedTypes: string[]): boolean;
+/**
+ * Create relative URL for local files
+ */
+export declare function createLocalFileUrl(filePath: string, baseUrl?: string): string;
+/**
+ * Get file extension from filename
+ */
+export declare function getFileExtension(fileName: string): string;
+/**
+ * Check if file is an image
+ */
+export declare function isImageFile(mimeType: string): boolean;
+/**
+ * Check if file is a document
+ */
+export declare function isDocumentFile(mimeType: string): boolean;
+//# sourceMappingURL=file.utils.d.ts.map

package/dist/utils/file.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.utils.d.ts","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAOnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAElF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,MAAM,CAGjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWxD"}

package/dist/utils/file.utils.js

@@ -0,0 +1,95 @@
+import path from 'path';
+import fs from 'fs';
+/**
+ * Generate unique filename with unix timestamp
+ */
+export function generateUniqueFileName(originalName) {
+    const timestamp = Math.floor(Date.now() / 1000); // Unix timestamp
+    const extension = path.extname(originalName);
+    const sanitizedName = sanitizeFileName(originalName);
+    const baseName = path.basename(sanitizedName, extension);
+    return `${timestamp}_${baseName}${extension}`;
+}
+/**
+ * Sanitize filename to prevent security issues
+ */
+export function sanitizeFileName(fileName) {
+    return fileName
+        .replace(/[^a-zA-Z0-9.-]/g, '_') // Replace special characters with underscore
+        .replace(/_{2,}/g, '_') // Replace multiple underscores with single
+        .replace(/^_+|_+$/g, ''); // Remove leading/trailing underscores
+}
+/**
+ * Create month-based directory path
+ */
+export function createMonthBasedPath(basePath) {
+    const now = new Date();
+    const month = now.toLocaleString('en', { month: 'long' }).toLowerCase();
+    const year = now.getFullYear();
+    return path.join(basePath, month, year.toString());
+}
+/**
+ * Ensure directory exists, create if it doesn't
+ */
+export function ensureDirectoryExists(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+/**
+ * Get file size in human readable format
+ */
+export function formatFileSize(bytes) {
+    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+    if (bytes === 0)
+        return '0 Bytes';
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    return Math.round(bytes / Math.pow(1024, i) * 100) / 100 + ' ' + sizes[i];
+}
+/**
+ * Validate file size
+ */
+export function validateFileSize(fileSize, maxSize) {
+    return fileSize <= maxSize;
+}
+/**
+ * Validate file type
+ */
+export function validateFileType(mimeType, allowedTypes) {
+    return allowedTypes.includes(mimeType);
+}
+/**
+ * Create relative URL for local files
+ */
+export function createLocalFileUrl(filePath, baseUrl = '') {
+    const relativePath = filePath.replace(/^public\//, '');
+    return `${baseUrl}/${relativePath}`.replace(/\/+/g, '/');
+}
+/**
+ * Get file extension from filename
+ */
+export function getFileExtension(fileName) {
+    return path.extname(fileName).toLowerCase();
+}
+/**
+ * Check if file is an image
+ */
+export function isImageFile(mimeType) {
+    return mimeType.startsWith('image/');
+}
+/**
+ * Check if file is a document
+ */
+export function isDocumentFile(mimeType) {
+    const documentTypes = [
+        'application/pdf',
+        'application/msword',
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+        'application/vnd.ms-excel',
+        'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+        'text/plain',
+        'text/csv'
+    ];
+    return documentTypes.includes(mimeType);
+}
+//# sourceMappingURL=file.utils.js.map

package/dist/utils/file.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.utils.js","sourceRoot":"","sources":["../../src/utils/file.utils.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,YAAoB;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,iBAAiB;IAClE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IAEzD,OAAO,GAAG,SAAS,IAAI,QAAQ,GAAG,SAAS,EAAE,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,QAAQ;SACZ,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,6CAA6C;SAC7E,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,2CAA2C;SAClE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,sCAAsC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACxE,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAE/B,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,OAAe;IAChE,OAAO,QAAQ,IAAI,OAAO,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,YAAsB;IACvE,OAAO,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,UAAkB,EAAE;IACvE,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACvD,OAAO,GAAG,OAAO,IAAI,YAAY,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,aAAa,GAAG;QACpB,iBAAiB;QACjB,oBAAoB;QACpB,yEAAyE;QACzE,0BAA0B;QAC1B,mEAAmE;QACnE,YAAY;QACZ,UAAU;KACX,CAAC;IACF,OAAO,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "express-storage",
+  "version": "1.0.0",
+  "description": "A simple and powerful file upload and storage management package for Express.js applications. Supports multiple storage drivers including S3, GCS, OCI, and local storage with presigned URL support.",
+  "homepage": "https://github.com/th3hero/express-storage#readme",
+  "bugs": {
+    "url": "https://github.com/th3hero/express-storage/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/th3hero/express-storage.git"
+  },
+  "license": "MIT",
+  "author": "Alok Kumar (th3hero)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "express",
+    "file-upload",
+    "storage",
+    "s3",
+    "gcs",
+    "oci",
+    "presigned-url",
+    "typescript",
+    "multer",
+    "cloud-storage"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "type-check": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "express": "^4.21.2"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.3",
+    "@types/jest": "^30.0.0",
+    "@types/multer": "^2.0.0",
+    "@types/node": "^24.1.0",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
+    "eslint": "^9.32.0",
+    "jest": "^30.0.5",
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.4.0",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.856.0",
+    "@aws-sdk/s3-request-presigner": "^3.856.0",
+    "@google-cloud/storage": "^7.16.0",
+    "dotenv": "^17.2.1",
+    "multer": "^2.0.2",
+    "oci-sdk": "^2.114.0",
+    "tslib": "^2.8.1"
+  }
+}