@pelatform/storage 1.0.1 → 1.0.3

package/README.md

@@ -1,10 +1,258 @@
 # @pelatform/storage
 
-A comprehensive storage utilities for SaaS applications. This package provides a unified interface for working with various storage providers including AWS S3, Cloudflare R2, MinIO, DigitalOcean Spaces, Supabase, and Cloudinary Storage.
-
 [![Version](https://img.shields.io/npm/v/@pelatform/storage.svg)](https://www.npmjs.com/package/@pelatform/storage)
-[![License](https://img.shields.io/npm/l/@pelatform/storage.svg)](https://github.com/devpelatform/storage/blob/main/LICENSE)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A comprehensive storage utilities package for SaaS applications. This package provides a unified interface for working with various storage providers including AWS S3, Cloudflare R2, MinIO, DigitalOcean Spaces, Supabase Storage, and Cloudinary.
+
+## Installation
+
+```bash
+npm install @pelatform/storage
+# or
+bun add @pelatform/storage
+
+# Install peer dependencies for the provider(s) you need
+npm install @aws-sdk/client-s3 @aws-sdk/s3-request-presigner  # For S3-compatible providers
+npm install cloudinary  # For Cloudinary
+```
+
+## Quick Start
+
+### S3-Compatible Storage (AWS, R2, MinIO, etc.)
+
+```typescript
+import { S3Storage } from "@pelatform/storage/s3";
+
+const storage = new S3Storage({
+  provider: "aws", // or 'cloudflare-r2', 'minio', 'digitalocean', 'supabase'
+  region: "us-east-1",
+  bucket: "my-bucket",
+  accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+  secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+});
+
+// Upload a file
+await storage.upload({
+  key: "documents/file.pdf",
+  file: fileBuffer,
+  contentType: "application/pdf",
+});
+
+// Download a file
+const result = await storage.download({ key: "documents/file.pdf" });
+
+// Generate a presigned URL (temporary access)
+const url = await storage.getPresignedUrl({
+  key: "documents/file.pdf",
+  operation: "get",
+  expiresIn: 3600, // 1 hour
+});
+```
+
+### Cloudinary Storage
+
+```typescript
+import { CloudinaryStorage } from "@pelatform/storage/cloudinary";
+
+const storage = new CloudinaryStorage({
+  provider: "cloudinary",
+  cloudName: process.env.CLOUDINARY_CLOUD_NAME,
+  apiKey: process.env.CLOUDINARY_API_KEY,
+  apiSecret: process.env.CLOUDINARY_API_SECRET,
+});
+
+// Upload an image
+await storage.upload({
+  key: "images/photo.jpg",
+  file: imageBuffer,
+  contentType: "image/jpeg",
+});
+```
+
+## Key Features
+
+- **Unified Interface**: Single API for multiple storage providers
+- **S3-Compatible Providers**: AWS S3, Cloudflare R2, MinIO, DigitalOcean Spaces, Supabase Storage
+- **Cloudinary Support**: Image and media management with built-in optimizations
+- **File Operations**: Upload, download, delete, copy, move, and check existence
+- **Folder Operations**: Create, delete, list, and manage folders
+- **Presigned URLs**: Generate time-limited access URLs for secure sharing
+- **Public URLs**: Get public access URLs with optional CDN support
+- **Type-Safe**: Full TypeScript support with comprehensive types
+- **Flexible Configuration**: Support for custom endpoints and CDN URLs
+
+## Supported Providers
+
+### S3-Compatible
+
+- **AWS S3** - Amazon's object storage service
+- **Cloudflare R2** - Cloudflare's S3-compatible storage (no egress fees)
+- **MinIO** - Self-hosted S3-compatible storage
+- **DigitalOcean Spaces** - DigitalOcean's object storage
+- **Supabase Storage** - Supabase's S3-compatible storage
+
+### Other Providers
+
+- **Cloudinary** - Image and video management platform
+
+## Configuration
+
+### AWS S3
+
+```typescript
+const storage = new S3Storage({
+  provider: "aws",
+  region: "us-east-1",
+  bucket: "my-bucket",
+  accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+  secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+  publicUrl: "https://cdn.example.com", // Optional CDN URL
+});
+```
+
+### Cloudflare R2
+
+```typescript
+const storage = new S3Storage({
+  provider: "cloudflare-r2",
+  region: "auto",
+  bucket: "my-bucket",
+  accessKeyId: process.env.R2_ACCESS_KEY_ID,
+  secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
+  endpoint: "https://<account-id>.r2.cloudflarestorage.com",
+});
+```
+
+### MinIO
+
+```typescript
+const storage = new S3Storage({
+  provider: "minio",
+  region: "us-east-1",
+  bucket: "my-bucket",
+  accessKeyId: "minioadmin",
+  secretAccessKey: "minioadmin",
+  endpoint: "http://localhost:9000",
+  forcePathStyle: true, // Required for MinIO
+});
+```
+
+## Basic Usage
+
+### File Operations
+
+```typescript
+// Upload with options
+await storage.upload({
+  key: "uploads/document.pdf",
+  file: buffer,
+  contentType: "application/pdf",
+  metadata: { userId: "123", category: "documents" },
+  cacheControl: "max-age=31536000",
+});
+
+// Download file
+const { content, metadata } = await storage.download({
+  key: "uploads/document.pdf",
+});
+
+// Check if file exists
+const exists = await storage.exists("uploads/document.pdf");
+
+// Delete file
+await storage.delete({ key: "uploads/document.pdf" });
+
+// Copy file
+await storage.copy({
+  sourceKey: "uploads/old.pdf",
+  destinationKey: "uploads/new.pdf",
+});
+
+// Move file
+await storage.move({
+  sourceKey: "uploads/temp.pdf",
+  destinationKey: "uploads/final.pdf",
+});
+
+// List files
+const files = await storage.list({
+  prefix: "uploads/",
+  maxKeys: 100,
+});
+```
+
+### Folder Operations
+
+```typescript
+// Create folder
+await storage.createFolder({ path: "documents/" });
+
+// Delete folder (recursive)
+await storage.deleteFolder({
+  path: "documents/",
+  recursive: true,
+});
+
+// List folders
+const folders = await storage.listFolders({
+  prefix: "uploads/",
+});
+
+// Check if folder exists
+const exists = await storage.folderExists("documents/");
+```
+
+### URL Generation
+
+```typescript
+// Get public URL
+const publicUrl = storage.getPublicUrl("images/photo.jpg");
+
+// Generate presigned URL for download
+const downloadUrl = await storage.getPresignedUrl({
+  key: "documents/private.pdf",
+  operation: "get",
+  expiresIn: 3600, // 1 hour
+});
+
+// Generate presigned URL for upload
+const uploadUrl = await storage.getPresignedUrl({
+  key: "uploads/new-file.pdf",
+  operation: "put",
+  expiresIn: 900, // 15 minutes
+  contentType: "application/pdf",
+});
+```
+
+## API Reference
+
+### File Operations
+
+- `upload(options)` - Upload a file
+- `download(options)` - Download a file
+- `delete(options)` - Delete a file
+- `exists(key)` - Check if file exists
+- `copy(options)` - Copy a file
+- `move(options)` - Move a file
+- `list(options)` - List files with prefix
+- `getPresignedUrl(options)` - Generate presigned URL
+- `getPublicUrl(key)` - Get public URL
+
+### Folder Operations
+
+- `createFolder(options)` - Create a folder
+- `deleteFolder(options)` - Delete a folder
+- `listFolders(options)` - List folders
+- `folderExists(path)` - Check if folder exists
+
+## Links
+
+- [npm Package](https://www.npmjs.com/package/@pelatform/storage)
+- [Contributing Guide](../../CONTRIBUTING.md)
+- [Code of Conduct](../../CODE_OF_CONDUCT.md)
+- [License](../../LICENSE)
 
-## Getting Started
+## License
 
-Visit https://devpelatform.github.io/storage to get started with this package.
+MIT © [Pelatform Inc.](../../LICENSE)

package/dist/{chunk-ZTZZCC52.js → chunk-NNFNVWIN.js}

@@ -31,11 +31,15 @@ function getRequiredEnvVar(key) {
 }
 function getBooleanEnvVar(key, defaultValue = false) {
   const value = getEnvVar(key);
-  if (!value) return defaultValue;
+  if (!value) {
+    return defaultValue;
+  }
   return value.toLowerCase() === "true" || value === "1";
 }
 function loadS3Config() {
-  const provider = getRequiredEnvVar(ENV_VARS.PELATFORM_S3_PROVIDER);
+  const provider = getRequiredEnvVar(
+    ENV_VARS.PELATFORM_S3_PROVIDER
+  );
   const validProviders = [
     "aws",
     "cloudflare-r2",
@@ -75,15 +79,15 @@ function loadStorageConfig() {
   if (provider) {
     if (provider === "cloudinary") {
       return loadCloudinaryConfig();
-    } else {
-      return loadS3Config();
     }
+    return loadS3Config();
   }
   const hasCloudinaryVars = getEnvVar(ENV_VARS.PELATFORM_CLOUDINARY_CLOUD_NAME) && getEnvVar(ENV_VARS.PELATFORM_CLOUDINARY_API_KEY) && getEnvVar(ENV_VARS.PELATFORM_CLOUDINARY_API_SECRET);
   const hasS3Vars = getEnvVar(ENV_VARS.PELATFORM_S3_BUCKET) && getEnvVar(ENV_VARS.PELATFORM_S3_ACCESS_KEY_ID) && getEnvVar(ENV_VARS.PELATFORM_S3_SECRET_ACCESS_KEY);
   if (hasCloudinaryVars) {
     return loadCloudinaryConfig();
-  } else if (hasS3Vars) {
+  }
+  if (hasS3Vars) {
     const config = loadS3Config();
     if (!config.provider) {
       config.provider = "aws";
@@ -107,11 +111,17 @@ function isStorageConfigured() {
 }
 function getStorageProvider() {
   const provider = getEnvVar(ENV_VARS.PELATFORM_S3_PROVIDER);
-  if (provider) return provider;
+  if (provider) {
+    return provider;
+  }
   const hasCloudinaryVars = getEnvVar(ENV_VARS.PELATFORM_CLOUDINARY_CLOUD_NAME);
   const hasS3Vars = getEnvVar(ENV_VARS.PELATFORM_S3_BUCKET);
-  if (hasCloudinaryVars) return "cloudinary";
-  if (hasS3Vars) return "aws";
+  if (hasCloudinaryVars) {
+    return "cloudinary";
+  }
+  if (hasS3Vars) {
+    return "aws";
+  }
   return void 0;
 }
 function validateS3EnvVars() {

package/dist/{chunk-KJMGBTTL.js → chunk-VZDXZ6EA.js}

@@ -26,13 +26,13 @@ function validateFileType(fileName, allowedTypes) {
   const extension = fileName.split(".").pop()?.toLowerCase();
   const isValidMime = allowedTypes.some((type) => {
     if (type.includes("*")) {
-      const baseType = type.split("/")[0];
+      const baseType = type.split("/")[0] ?? "";
       return mimeType.startsWith(baseType);
     }
     return mimeType === type;
   });
   const isValidExtension = extension && allowedTypes.includes(`.${extension}`);
-  if (!isValidMime && !isValidExtension) {
+  if (!(isValidMime || isValidExtension)) {
     return {
       valid: false,
       error: `File type not allowed. Allowed types: ${allowedTypes.join(", ")}`
@@ -41,11 +41,13 @@ function validateFileType(fileName, allowedTypes) {
   return { valid: true };
 }
 function formatFileSize(bytes) {
-  if (bytes === 0) return "0 Bytes";
+  if (bytes === 0) {
+    return "0 Bytes";
+  }
   const k = 1024;
   const sizes = ["Bytes", "KB", "MB", "GB", "TB"];
   const i = Math.floor(Math.log(bytes) / Math.log(k));
-  return `${parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`;
+  return `${Number.parseFloat((bytes / k ** i).toFixed(2))} ${sizes[i]}`;
 }
 function sanitizeFileName(fileName) {
   return fileName.replace(/[^a-zA-Z0-9.-]/g, "_").replace(/_{2,}/g, "_").replace(/^_|_$/g, "").toLowerCase();
@@ -68,11 +70,10 @@ function parseS3Url(url) {
           bucket: pathParts2[0],
           key: pathParts2.slice(1).join("/")
         };
-      } else {
-        const bucket = urlObj.hostname.split(".")[0];
-        const key = urlObj.pathname.substring(1);
-        return { bucket, key };
       }
+      const bucket = urlObj.hostname.split(".")[0];
+      const key = urlObj.pathname.substring(1);
+      return { bucket, key };
     }
     const pathParts = urlObj.pathname.split("/").filter(Boolean);
     return {
@@ -138,19 +139,18 @@ function extractS3Info(url) {
     if (urlObj.hostname.includes("amazonaws.com")) {
       if (urlObj.hostname.startsWith("s3")) {
         const pathParts2 = urlObj.pathname.split("/").filter(Boolean);
-        const region = urlObj.hostname.split(".")[1];
+        const region2 = urlObj.hostname.split(".")[1];
         return {
           bucket: pathParts2[0],
           key: pathParts2.slice(1).join("/"),
-          region
+          region: region2
         };
-      } else {
-        const hostParts = urlObj.hostname.split(".");
-        const bucket = hostParts[0];
-        const region = hostParts[2];
-        const key = urlObj.pathname.substring(1);
-        return { bucket, key, region };
       }
+      const hostParts = urlObj.hostname.split(".");
+      const bucket = hostParts[0];
+      const region = hostParts[2];
+      const key = urlObj.pathname.substring(1);
+      return { bucket, key, region };
     }
     const pathParts = urlObj.pathname.split("/").filter(Boolean);
     return {
@@ -273,7 +273,7 @@ function getFileName(key) {
   return lastSlashIndex === -1 ? normalizedKey : normalizedKey.substring(lastSlashIndex + 1);
 }
 function base64ToBuffer(base64) {
-  const cleanBase64 = base64.includes(",") ? base64.split(",")[1] : base64;
+  const cleanBase64 = base64.includes(",") ? base64.split(",")[1] ?? "" : base64;
   return Buffer.from(cleanBase64, "base64");
 }
 function bufferToBase64(buffer, includeDataUrl = false, mimeType) {
@@ -301,7 +301,9 @@ function validateBatchFiles(files, options) {
     return files.map((file) => ({
       valid: false,
       fileName: file.name,
-      errors: [`Maximum ${options.maxFiles} files allowed, but ${files.length} files provided`]
+      errors: [
+        `Maximum ${options.maxFiles} files allowed, but ${files.length} files provided`
+      ]
     }));
   }
   for (const file of files) {
@@ -347,25 +349,35 @@ function detectFileTypeFromContent(buffer) {
     return "image/webp";
   }
   if (header[0] === 80 && header[1] === 75 && (header[2] === 3 || header[2] === 5)) {
-    const zipContent = buffer.toString("utf8", 0, Math.min(buffer.length, 1e3));
-    if (zipContent.includes("word/"))
+    const zipContent = buffer.toString(
+      "utf8",
+      0,
+      Math.min(buffer.length, 1e3)
+    );
+    if (zipContent.includes("word/")) {
       return "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-    if (zipContent.includes("xl/"))
+    }
+    if (zipContent.includes("xl/")) {
       return "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
-    if (zipContent.includes("ppt/"))
+    }
+    if (zipContent.includes("ppt/")) {
       return "application/vnd.openxmlformats-officedocument.presentationml.presentation";
+    }
     return "application/zip";
   }
   if (header.subarray(4, 8).toString() === "ftyp") {
     return "video/mp4";
   }
-  if (header[0] === 255 && (header[1] & 224) === 224 || header.subarray(0, 3).toString() === "ID3") {
+  if (header[0] !== void 0 && header[1] !== void 0 && header[0] === 255 && (header[1] & 224) === 224 || header.subarray(0, 3).toString() === "ID3") {
     return "audio/mpeg";
   }
   let isText = true;
   const sampleSize = Math.min(buffer.length, 512);
   for (let i = 0; i < sampleSize; i++) {
     const byte = buffer[i];
+    if (byte === void 0) {
+      continue;
+    }
     if (byte === 0 || byte < 32 && byte !== 9 && byte !== 10 && byte !== 13) {
       isText = false;
       break;

package/dist/cloudinary.d.ts

@@ -1,4 +1,4 @@
-import { A as StorageInterface, C as CloudinaryConfig, U as UploadOptions, e as UploadResult, D as DownloadOptions, f as DownloadResult, g as DeleteOptions, h as DeleteResult, B as BatchDeleteOptions, i as BatchDeleteResult, L as ListOptions, o as ListResult, E as ExistsResult, j as CopyOptions, k as CopyResult, M as MoveOptions, l as MoveResult, m as DuplicateOptions, n as DuplicateResult, P as PresignedUrlOptions, p as PresignedUrlResult, q as CreateFolderOptions, r as CreateFolderResult, s as DeleteFolderOptions, t as DeleteFolderResult, u as ListFoldersOptions, v as ListFoldersResult, w as FolderExistsResult, R as RenameFolderOptions, x as RenameFolderResult, y as CopyFolderOptions, z as CopyFolderResult } from './storage-interface-UizTndyU.js';
+import { S as StorageInterface, C as CloudinaryConfig, U as UploadOptions, a as UploadResult, D as DownloadOptions, b as DownloadResult, c as DeleteOptions, d as DeleteResult, B as BatchDeleteOptions, e as BatchDeleteResult, L as ListOptions, f as ListResult, E as ExistsResult, g as CopyOptions, h as CopyResult, M as MoveOptions, i as MoveResult, j as DuplicateOptions, k as DuplicateResult, P as PresignedUrlOptions, l as PresignedUrlResult, m as CreateFolderOptions, n as CreateFolderResult, o as DeleteFolderOptions, p as DeleteFolderResult, q as ListFoldersOptions, r as ListFoldersResult, F as FolderExistsResult, R as RenameFolderOptions, s as RenameFolderResult, t as CopyFolderOptions, u as CopyFolderResult } from './storage-interface-CoYx1E3B.js';
 
 /**
  * Cloudinary storage service implementation

package/dist/cloudinary.js

@@ -1,6 +1,6 @@
 import {
   loadCloudinaryConfig
-} from "./chunk-ZTZZCC52.js";
+} from "./chunk-NNFNVWIN.js";
 
 // src/providers/cloudinary.ts
 import { v2 as cloudinary } from "cloudinary";
@@ -30,11 +30,13 @@ var CloudinaryProvider = class {
       } else if (options.contentType?.startsWith("video/")) {
         resourceType = "video";
       }
-      const keyParts = options.key.split("/");
+      const keyParts = options.key.split("/").filter(Boolean);
       let folder = "";
       let publicId = options.key;
       if (keyParts.length > 1) {
         folder = keyParts.slice(0, -1).join("/");
+      }
+      if (keyParts.length > 0) {
         publicId = keyParts[keyParts.length - 1];
       }
       const uploadOptions = {
@@ -294,10 +296,12 @@ var CloudinaryProvider = class {
   async listFolders(_options) {
     try {
       const result = await cloudinary.api.root_folders();
-      const folders = (result.folders || []).map((folder) => ({
-        name: folder.name,
-        path: folder.path
-      }));
+      const folders = (result.folders || []).map(
+        (folder) => ({
+          name: folder.name,
+          path: folder.path
+        })
+      );
       return {
         success: true,
         folders,

package/dist/helpers.d.ts

@@ -420,7 +420,7 @@ declare function validateBucketName(bucketName: string): {
  * // Returns: 'attachment; filename="filename.txt"'
  * ```
  */
-declare function getContentDisposition(fileName: string, disposition?: 'inline' | 'attachment'): string;
+declare function getContentDisposition(fileName: string, disposition?: "inline" | "attachment"): string;
 /**
  * Check if file is an image based on MIME type
  * @param fileName File name or path
@@ -659,7 +659,7 @@ declare function bufferToBase64(buffer: Buffer, includeDataUrl?: boolean, mimeTy
  * }
  * ```
  */
-declare function generateFileHash(content: Buffer | string, algorithm?: 'md5' | 'sha1' | 'sha256'): Promise<string>;
+declare function generateFileHash(content: Buffer | string, algorithm?: "md5" | "sha1" | "sha256"): Promise<string>;
 /**
  * Generate multiple unique keys at once for batch operations
  * @param fileNames Array of file names

package/dist/helpers.js

@@ -31,7 +31,7 @@ import {
   validateFileType,
   validateS3Config,
   validateS3Key
-} from "./chunk-KJMGBTTL.js";
+} from "./chunk-VZDXZ6EA.js";
 export {
   base64ToBuffer,
   bufferToBase64,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as S3Config, C as CloudinaryConfig, a as StorageConfig } from './storage-interface-UizTndyU.js';
-export { B as BatchDeleteOptions, i as BatchDeleteResult, y as CopyFolderOptions, z as CopyFolderResult, j as CopyOptions, k as CopyResult, q as CreateFolderOptions, r as CreateFolderResult, s as DeleteFolderOptions, t as DeleteFolderResult, g as DeleteOptions, h as DeleteResult, D as DownloadOptions, f as DownloadResult, m as DuplicateOptions, n as DuplicateResult, E as ExistsResult, F as FileInfo, w as FolderExistsResult, d as FolderInfo, u as ListFoldersOptions, v as ListFoldersResult, L as ListOptions, o as ListResult, M as MoveOptions, l as MoveResult, P as PresignedUrlOptions, p as PresignedUrlResult, R as RenameFolderOptions, x as RenameFolderResult, b as S3ProviderType, A as StorageInterface, c as StorageProvider, U as UploadOptions, e as UploadResult } from './storage-interface-UizTndyU.js';
+import { v as S3Config, C as CloudinaryConfig, w as StorageConfig } from './storage-interface-CoYx1E3B.js';
+export { B as BatchDeleteOptions, e as BatchDeleteResult, t as CopyFolderOptions, u as CopyFolderResult, g as CopyOptions, h as CopyResult, m as CreateFolderOptions, n as CreateFolderResult, o as DeleteFolderOptions, p as DeleteFolderResult, c as DeleteOptions, d as DeleteResult, D as DownloadOptions, b as DownloadResult, j as DuplicateOptions, k as DuplicateResult, E as ExistsResult, z as FileInfo, F as FolderExistsResult, A as FolderInfo, q as ListFoldersOptions, r as ListFoldersResult, L as ListOptions, f as ListResult, M as MoveOptions, i as MoveResult, P as PresignedUrlOptions, l as PresignedUrlResult, R as RenameFolderOptions, s as RenameFolderResult, x as S3ProviderType, S as StorageInterface, y as StorageProvider, U as UploadOptions, a as UploadResult } from './storage-interface-CoYx1E3B.js';
 
 /**
  * Storage configuration from environment variables

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   loadStorageConfig,
   validateCloudinaryEnvVars,
   validateS3EnvVars
-} from "./chunk-ZTZZCC52.js";
+} from "./chunk-NNFNVWIN.js";
 export {
   ENV_VARS,
   getStorageEnvVars,

package/dist/s3.d.ts

@@ -1,4 +1,4 @@
-import { A as StorageInterface, S as S3Config, U as UploadOptions, e as UploadResult, D as DownloadOptions, f as DownloadResult, g as DeleteOptions, h as DeleteResult, B as BatchDeleteOptions, i as BatchDeleteResult, L as ListOptions, o as ListResult, E as ExistsResult, j as CopyOptions, k as CopyResult, M as MoveOptions, l as MoveResult, m as DuplicateOptions, n as DuplicateResult, P as PresignedUrlOptions, p as PresignedUrlResult, q as CreateFolderOptions, r as CreateFolderResult, s as DeleteFolderOptions, t as DeleteFolderResult, u as ListFoldersOptions, v as ListFoldersResult, w as FolderExistsResult, R as RenameFolderOptions, x as RenameFolderResult, y as CopyFolderOptions, z as CopyFolderResult } from './storage-interface-UizTndyU.js';
+import { S as StorageInterface, v as S3Config, U as UploadOptions, a as UploadResult, D as DownloadOptions, b as DownloadResult, c as DeleteOptions, d as DeleteResult, B as BatchDeleteOptions, e as BatchDeleteResult, L as ListOptions, f as ListResult, E as ExistsResult, g as CopyOptions, h as CopyResult, M as MoveOptions, i as MoveResult, j as DuplicateOptions, k as DuplicateResult, P as PresignedUrlOptions, l as PresignedUrlResult, m as CreateFolderOptions, n as CreateFolderResult, o as DeleteFolderOptions, p as DeleteFolderResult, q as ListFoldersOptions, r as ListFoldersResult, F as FolderExistsResult, R as RenameFolderOptions, s as RenameFolderResult, t as CopyFolderOptions, u as CopyFolderResult } from './storage-interface-CoYx1E3B.js';
 
 /**
  * S3 storage service implementation

package/dist/s3.js

@@ -1,10 +1,10 @@
-import {
-  loadS3Config
-} from "./chunk-ZTZZCC52.js";
 import {
   buildPublicUrl,
   getMimeType
-} from "./chunk-KJMGBTTL.js";
+} from "./chunk-VZDXZ6EA.js";
+import {
+  loadS3Config
+} from "./chunk-NNFNVWIN.js";
 
 // src/providers/s3.ts
 import { S3Client } from "@aws-sdk/client-s3";
@@ -74,7 +74,9 @@ var FileOperations = class {
       const reader = result.Body.transformToWebStream().getReader();
       while (true) {
         const { done, value } = await reader.read();
-        if (done) break;
+        if (done) {
+          break;
+        }
         chunks.push(value);
       }
       const data = Buffer.concat(chunks);
@@ -124,7 +126,9 @@ var FileOperations = class {
         }
       });
       const result = await this.client.send(command);
-      const deleted = result.Deleted?.map((obj) => obj.Key).filter(Boolean);
+      const deleted = result.Deleted?.map((obj) => obj.Key).filter(
+        Boolean
+      );
       const errors = result.Errors?.map((err) => ({
         key: err.Key || "",
         error: err.Message || "Unknown error"
@@ -349,33 +353,32 @@ var FolderOperations = class {
             deletedFiles: []
           };
         }
-        const deleteCommand = new DeleteObjectsCommand2({
+        const deleteCommand2 = new DeleteObjectsCommand2({
           Bucket: this.config.bucket,
           Delete: {
             Objects: listResult.Contents.map((obj) => ({ Key: obj.Key })),
             Quiet: false
           }
         });
-        const deleteResult = await this.client.send(deleteCommand);
+        const deleteResult = await this.client.send(deleteCommand2);
         const deletedFiles = deleteResult.Deleted?.map((obj) => obj.Key).filter(Boolean) || [];
         return {
           success: true,
           deletedFiles
         };
-      } else {
-        const deleteCommand = new DeleteObjectsCommand2({
-          Bucket: this.config.bucket,
-          Delete: {
-            Objects: [{ Key: folderPath }],
-            Quiet: false
-          }
-        });
-        await this.client.send(deleteCommand);
-        return {
-          success: true,
-          deletedFiles: [folderPath]
-        };
       }
+      const deleteCommand = new DeleteObjectsCommand2({
+        Bucket: this.config.bucket,
+        Delete: {
+          Objects: [{ Key: folderPath }],
+          Quiet: false
+        }
+      });
+      await this.client.send(deleteCommand);
+      return {
+        success: true,
+        deletedFiles: [folderPath]
+      };
     } catch (error) {
       return {
         success: false,
@@ -559,7 +562,7 @@ var S3Provider = class {
         secretAccessKey: config.secretAccessKey
       },
       endpoint: config.endpoint,
-      forcePathStyle: config.forcePathStyle || false
+      forcePathStyle: config.forcePathStyle
     });
     this.fileOps = new FileOperations(this.client, this.config);
     this.folderOps = new FolderOperations(this.client, this.config);

package/dist/{storage-interface-UizTndyU.d.ts → storage-interface-CoYx1E3B.d.ts}

@@ -6,12 +6,12 @@
  * S3-compatible provider types
  * @public
  */
-type S3ProviderType = 'aws' | 'cloudflare-r2' | 'minio' | 'digitalocean' | 'supabase' | 'custom';
+type S3ProviderType = "aws" | "cloudflare-r2" | "minio" | "digitalocean" | "supabase" | "custom";
 /**
  * All supported storage provider types
  * @public
  */
-type StorageProvider = S3ProviderType | 'cloudinary';
+type StorageProvider = S3ProviderType | "cloudinary";
 /**
  * Union type for all storage configurations
  * @public
@@ -45,7 +45,7 @@ interface S3Config {
  */
 interface CloudinaryConfig {
     /** Provider type (always 'cloudinary') */
-    provider: 'cloudinary';
+    provider: "cloudinary";
     /** Cloudinary cloud name */
     cloudName: string;
     /** Cloudinary API key */
@@ -104,7 +104,7 @@ interface UploadOptions {
     metadata?: Record<string, string>;
     cacheControl?: string;
     contentDisposition?: string;
-    acl?: 'private' | 'public-read' | 'public-read-write';
+    acl?: "private" | "public-read" | "public-read-write";
     expires?: Date;
 }
 interface UploadResult {
@@ -153,7 +153,7 @@ interface CopyOptions {
     sourceKey: string;
     destinationKey: string;
     metadata?: Record<string, string>;
-    metadataDirective?: 'COPY' | 'REPLACE';
+    metadataDirective?: "COPY" | "REPLACE";
 }
 interface CopyResult {
     success: boolean;
@@ -164,7 +164,7 @@ interface MoveOptions {
     sourceKey: string;
     destinationKey: string;
     metadata?: Record<string, string>;
-    metadataDirective?: 'COPY' | 'REPLACE';
+    metadataDirective?: "COPY" | "REPLACE";
 }
 interface MoveResult {
     success: boolean;
@@ -194,7 +194,7 @@ interface ListResult {
 }
 interface PresignedUrlOptions {
     key: string;
-    operation: 'get' | 'put';
+    operation: "get" | "put";
     expiresIn?: number;
     contentType?: string;
 }
@@ -313,4 +313,4 @@ interface StorageInterface {
     copyFolder(options: CopyFolderOptions): Promise<CopyFolderResult>;
 }
 
-export type { StorageInterface as A, BatchDeleteOptions as B, CloudinaryConfig as C, DownloadOptions as D, ExistsResult as E, FileInfo as F, ListOptions as L, MoveOptions as M, PresignedUrlOptions as P, RenameFolderOptions as R, S3Config as S, UploadOptions as U, StorageConfig as a, S3ProviderType as b, StorageProvider as c, FolderInfo as d, UploadResult as e, DownloadResult as f, DeleteOptions as g, DeleteResult as h, BatchDeleteResult as i, CopyOptions as j, CopyResult as k, MoveResult as l, DuplicateOptions as m, DuplicateResult as n, ListResult as o, PresignedUrlResult as p, CreateFolderOptions as q, CreateFolderResult as r, DeleteFolderOptions as s, DeleteFolderResult as t, ListFoldersOptions as u, ListFoldersResult as v, FolderExistsResult as w, RenameFolderResult as x, CopyFolderOptions as y, CopyFolderResult as z };
+export type { FolderInfo as A, BatchDeleteOptions as B, CloudinaryConfig as C, DownloadOptions as D, ExistsResult as E, FolderExistsResult as F, ListOptions as L, MoveOptions as M, PresignedUrlOptions as P, RenameFolderOptions as R, StorageInterface as S, UploadOptions as U, UploadResult as a, DownloadResult as b, DeleteOptions as c, DeleteResult as d, BatchDeleteResult as e, ListResult as f, CopyOptions as g, CopyResult as h, MoveResult as i, DuplicateOptions as j, DuplicateResult as k, PresignedUrlResult as l, CreateFolderOptions as m, CreateFolderResult as n, DeleteFolderOptions as o, DeleteFolderResult as p, ListFoldersOptions as q, ListFoldersResult as r, RenameFolderResult as s, CopyFolderOptions as t, CopyFolderResult as u, S3Config as v, StorageConfig as w, S3ProviderType as x, StorageProvider as y, FileInfo as z };

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@pelatform/storage",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Storage utilities for SaaS applications.",
-  "author": "Pelatform Dev",
+  "author": "Pelatform",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,10 +26,20 @@
       "default": "./dist/helpers.js"
     }
   },
-  "homepage": "https://devpelatform.github.io/storage",
+  "scripts": {
+    "clean": "rimraf dist",
+    "clean:all": "rimraf .turbo dist node_modules",
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "types:check": "tsc --noEmit"
+  },
+  "repository": "github:devpelatform/toolkits",
+  "homepage": "https://github.com/devpelatform/toolkits",
+  "bugs": {
+    "url": "https://github.com/devpelatform/toolkits/issues"
+  },
   "files": [
-    "dist/*",
-    "README.md"
+    "dist"
   ],
   "keywords": [
     "pelatform",
@@ -44,15 +54,19 @@
     "mime-types": "^3.0.2"
   },
   "devDependencies": {
+    "@aws-sdk/client-s3": "^3.943.0",
+    "@aws-sdk/s3-request-presigner": "^3.943.0",
+    "@pelatform/tsconfig": "0.1.0",
     "@types/mime-types": "^3.0.1",
     "@types/node": "^24.10.1",
+    "cloudinary": "^2.8.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {
-    "@aws-sdk/client-s3": ">=3.0.0",
-    "@aws-sdk/s3-request-presigner": ">=3.0.0",
-    "cloudinary": ">=2.0.0"
+    "@aws-sdk/client-s3": ">=3.8.0",
+    "@aws-sdk/s3-request-presigner": ">=3.8.0",
+    "cloudinary": ">=2.8.0"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-s3": {
@@ -66,13 +80,12 @@
     }
   },
   "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "scripts": {
-    "clean": "rimraf dist",
-    "clean:all": "rimraf .turbo dist node_modules",
-    "dev": "tsup --watch",
-    "build": "tsup --clean",
-    "types:check": "tsc --noEmit"
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,cjs,mjs,cts,mts}": "biome check --write --no-errors-on-unmatched",
+    "*.{md,yml,yaml}": "prettier --write",
+    "*.{json,jsonc,html}": "biome format --write --no-errors-on-unmatched"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Pelatform
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.