@startupjs-ui/file-input 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [0.1.9](https://github.com/startupjs/startupjs-ui/compare/v0.1.8...v0.1.9) (2026-01-16)
+
+**Note:** Version bump only for package @startupjs-ui/file-input
+
+
+
+
+
 ## [0.1.8](https://github.com/startupjs/startupjs-ui/compare/v0.1.7...v0.1.8) (2026-01-08)
 
 **Note:** Version bump only for package @startupjs-ui/file-input

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@startupjs-ui/file-input",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "publishConfig": {
     "access": "public"
   },
@@ -28,6 +28,7 @@
     "sharp": "^0.34.5"
   },
   "peerDependencies": {
+    "@aws-sdk/client-s3": "*",
     "@azure/storage-blob": "*",
     "mongodb": "*",
     "react": "*",
@@ -35,6 +36,9 @@
     "startupjs": "*"
   },
   "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
     "@azure/storage-blob": {
       "optional": true
     },
@@ -42,5 +46,5 @@
       "optional": true
     }
   },
-  "gitHead": "377cf459b4b85dc030aeb78621f7c28a0885c7f6"
+  "gitHead": "215449157f986f8cd7139ebe27015db5f39da4ce"
 }

package/providers/awsS3.js

@@ -0,0 +1,241 @@
+import { $, sub } from 'startupjs'
+import { S3Client, GetObjectCommand, PutObjectCommand, DeleteObjectCommand, HeadObjectCommand } from '@aws-sdk/client-s3'
+
+// AWS S3 Configuration from environment variables
+const AWS_REGION = process.env.AWS_REGION
+const AWS_ACCESS_KEY_ID = process.env.AWS_ACCESS_KEY_ID
+const AWS_SECRET_ACCESS_KEY = process.env.AWS_SECRET_ACCESS_KEY
+const AWS_S3_BUCKET_NAME = process.env.AWS_S3_BUCKET_NAME
+const AWS_S3_ENDPOINT = process.env.AWS_S3_ENDPOINT // Optional: for MinIO, LocalStack, etc.
+
+let s3Client
+let bucketName
+
+export function validateSupport () {
+  if (!AWS_REGION) {
+    throw new Error(ERRORS.awsRegionNotAvailable)
+  }
+  if (!AWS_ACCESS_KEY_ID) {
+    throw new Error(ERRORS.awsAccessKeyNotAvailable)
+  }
+  if (!AWS_SECRET_ACCESS_KEY) {
+    throw new Error(ERRORS.awsSecretKeyNotAvailable)
+  }
+  if (!AWS_S3_BUCKET_NAME) {
+    throw new Error(ERRORS.awsBucketNotAvailable)
+  }
+
+  // Initialize the S3Client once
+  if (!s3Client) {
+    console.log('[@startupjs-ui] FileInput: Connecting to AWS S3', {
+      region: AWS_REGION,
+      bucket: AWS_S3_BUCKET_NAME,
+      endpoint: AWS_S3_ENDPOINT
+    })
+
+    const clientConfig = {
+      region: AWS_REGION,
+      credentials: {
+        accessKeyId: AWS_ACCESS_KEY_ID,
+        secretAccessKey: AWS_SECRET_ACCESS_KEY
+      }
+    }
+
+    // Support for custom endpoints (like MinIO, LocalStack, etc.)
+    if (AWS_S3_ENDPOINT) {
+      clientConfig.endpoint = AWS_S3_ENDPOINT
+      clientConfig.forcePathStyle = true
+    }
+
+    s3Client = new S3Client(clientConfig)
+    bucketName = AWS_S3_BUCKET_NAME
+  }
+}
+
+export async function getFileBlob (fileId, options = {}) {
+  validateSupport()
+
+  const { range } = options
+  const filePath = await getFilePath(fileId)
+  const params = {
+    Bucket: bucketName,
+    Key: filePath
+  }
+
+  try {
+    // Get file info first to validate range
+    const headCommand = new HeadObjectCommand(params)
+    const headResponse = await s3Client.send(headCommand)
+    const actualFileSize = headResponse.ContentLength
+
+    if (range) {
+      console.log('[AWS S3] Using Range request for optimal streaming:', { fileId, range, filePath })
+
+      // Validate range boundaries
+      if (range.start >= actualFileSize || range.start < 0) {
+        console.log('[AWS S3] Range start out of bounds:', { start: range.start, actualFileSize })
+        throw new Error('Range start out of bounds')
+      }
+
+      // Ensure end is within file bounds
+      const adjustedEnd = Math.min(range.end, actualFileSize - 1)
+
+      // Ensure end is not before start
+      if (adjustedEnd < range.start) {
+        console.log('[AWS S3] Invalid range:', { start: range.start, end: adjustedEnd, actualFileSize })
+        throw new Error('Invalid range')
+      }
+
+      console.log('[AWS S3] Downloading object with range:', {
+        start: range.start,
+        end: adjustedEnd,
+        actualFileSize,
+        originalEnd: range.end
+      })
+
+      // Download with range
+      params.Range = `bytes=${range.start}-${adjustedEnd}`
+      const command = new GetObjectCommand(params)
+      const response = await s3Client.send(command)
+
+      // Convert stream to buffer
+      const chunks = []
+      for await (const chunk of response.Body) {
+        chunks.push(chunk)
+      }
+
+      const result = Buffer.concat(chunks)
+      const expectedSize = adjustedEnd - range.start + 1
+
+      console.log('[AWS S3] Range response:', {
+        expected: expectedSize,
+        actual: result.length,
+        start: range.start,
+        end: adjustedEnd,
+        fileId,
+        filePath
+      })
+
+      if (result.length === 0) {
+        console.warn('[AWS S3] Empty range response - this may indicate a problem')
+      }
+
+      return result
+    } else {
+      // Regular download for non-Range requests
+      const command = new GetObjectCommand(params)
+      const response = await s3Client.send(command)
+
+      const chunks = []
+      for await (const chunk of response.Body) {
+        chunks.push(chunk)
+      }
+
+      return Buffer.concat(chunks)
+    }
+  } catch (error) {
+    if (error.name === 'NoSuchKey' || error.$metadata?.httpStatusCode === 404) {
+      throw new Error(ERRORS.fileNotFound)
+    }
+    console.error('[AWS S3] Error downloading object:', error)
+    throw error
+  }
+}
+
+export async function getFileSize (fileId, options) {
+  validateSupport()
+
+  const filePath = await getFilePath(fileId)
+  const params = {
+    Bucket: bucketName,
+    Key: filePath
+  }
+
+  try {
+    const command = new HeadObjectCommand(params)
+    const response = await s3Client.send(command)
+    return response.ContentLength
+  } catch (error) {
+    if (error.name === 'NoSuchKey' || error.$metadata?.httpStatusCode === 404) {
+      throw new Error(ERRORS.fileNotFound)
+    }
+    console.error('[AWS S3] Error getting object size:', error)
+    throw error
+  }
+}
+
+export async function saveFileBlob (fileId, blob, options = {}) {
+  validateSupport()
+  const filePath = generateFilePath(fileId, options)
+  const params = {
+    Bucket: bucketName,
+    Key: filePath,
+    Body: blob
+  }
+
+  try {
+    // Upload object (overwrites if exists)
+    const command = new PutObjectCommand(params)
+    await s3Client.send(command)
+    console.log('[AWS S3] Object uploaded successfully:', filePath)
+  } catch (error) {
+    console.error('[AWS S3] Error uploading object:', error)
+    throw error
+  }
+}
+
+export async function deleteFile (fileId, options) {
+  validateSupport()
+
+  const filePath = await getFilePath(fileId)
+  const params = {
+    Bucket: bucketName,
+    Key: filePath
+  }
+
+  try {
+    const command = new DeleteObjectCommand(params)
+    await s3Client.send(command)
+    console.log('[AWS S3] Object deleted successfully:', filePath)
+  } catch (error) {
+    if (error.name === 'NoSuchKey' || error.$metadata?.httpStatusCode === 404) {
+      throw new Error(ERRORS.fileNotFound)
+    }
+    console.error('[AWS S3] Error deleting object:', error)
+    throw error
+  }
+}
+
+async function getFilePath (fileId) {
+  const $file = await sub($.files[fileId])
+  const file = $file.get()
+  return generateFilePath(fileId, file)
+}
+
+function generateFilePath (fileId, options) {
+  const { filename, path, setUniqName } = options
+  const newFilename = setUniqName ? fileId : filename || fileId
+  return path ? path + newFilename : newFilename
+}
+
+const ERRORS = {
+  awsRegionNotAvailable: `
+    AWS S3 region is not available.
+    Make sure you have configured the AWS_REGION environment variable.
+  `,
+  awsAccessKeyNotAvailable: `
+    AWS access key ID is not available.
+    Make sure you have configured the AWS_ACCESS_KEY_ID environment variable.
+  `,
+  awsSecretKeyNotAvailable: `
+    AWS secret access key is not available.
+    Make sure you have configured the AWS_SECRET_ACCESS_KEY environment variable.
+  `,
+  awsBucketNotAvailable: `
+    AWS S3 bucket name is not available.
+    Make sure you have configured the AWS_S3_BUCKET_NAME environment variable.
+  `,
+  fileNotFound: `
+    File not found in AWS S3.
+  `
+}

package/providers/azureblob.js

@@ -23,8 +23,9 @@ export function validateSupport () {
   }
 }
 
-export async function getFileBlob (fileId, range) {
+export async function getFileBlob (fileId, options = {}) {
   validateSupport()
+  const { range } = options
   const blobClient = containerClient.getBlobClient(fileId)
 
   try {
@@ -101,7 +102,7 @@ export async function getFileBlob (fileId, range) {
   }
 }
 
-export async function getFileSize (fileId) {
+export async function getFileSize (fileId, options) {
   validateSupport()
   const blobClient = containerClient.getBlobClient(fileId)
 
@@ -117,7 +118,7 @@ export async function getFileSize (fileId) {
   }
 }
 
-export async function saveFileBlob (fileId, blob) {
+export async function saveFileBlob (fileId, blob, options) {
   validateSupport()
   const blobClient = containerClient.getBlockBlobClient(fileId)
 
@@ -131,7 +132,7 @@ export async function saveFileBlob (fileId, blob) {
   }
 }
 
-export async function deleteFile (fileId) {
+export async function deleteFile (fileId, options) {
   validateSupport()
   const blobClient = containerClient.getBlobClient(fileId)
 

package/providers/index.js

@@ -1,19 +1,19 @@
 import { mongo, sqlite } from 'startupjs/server'
 
-export async function getFileBlob (storageType, fileId, range) {
-  return (await getStorageProvider(storageType)).getFileBlob(fileId, range)
+export async function getFileBlob (storageType, fileId, options) {
+  return (await getStorageProvider(storageType)).getFileBlob(fileId, options)
 }
 
-export async function getFileSize (storageType, fileId) {
-  return (await getStorageProvider(storageType)).getFileSize(fileId)
+export async function getFileSize (storageType, fileId, options) {
+  return (await getStorageProvider(storageType)).getFileSize(fileId, options)
 }
 
-export async function saveFileBlob (storageType, fileId, blob) {
-  return (await getStorageProvider(storageType)).saveFileBlob(fileId, blob)
+export async function saveFileBlob (storageType, fileId, blob, options) {
+  return (await getStorageProvider(storageType)).saveFileBlob(fileId, blob, options)
 }
 
-export async function deleteFile (storageType, fileId) {
-  return (await getStorageProvider(storageType)).deleteFile(fileId)
+export async function deleteFile (storageType, fileId, options) {
+  return (await getStorageProvider(storageType)).deleteFile(fileId, options)
 }
 
 export async function getDefaultStorageType () {
@@ -37,6 +37,8 @@ async function getStorageProvider (storageType) {
     theModule = await import('./mongo.js')
   } else if (storageType === 'azureblob') {
     theModule = await import('./azureblob.js')
+  } else if (storageType === 's3') {
+    theModule = await import('./awsS3.js')
   } else {
     throw Error(ERRORS.unsupportedStorageType(storageType))
   }

package/providers/mongo.js

@@ -11,8 +11,9 @@ export function validateSupport () {
   }
 }
 
-export async function getFileBlob (fileId, range) {
+export async function getFileBlob (fileId, options = {}) {
   validateSupport()
+  const { range } = options
   const files = await bucket.find({ filename: fileId }).toArray()
   if (!files || files.length === 0) {
     throw new Error(ERRORS.fileNotFound)
@@ -94,7 +95,7 @@ export async function getFileBlob (fileId, range) {
   })
 }
 
-export async function getFileSize (fileId) {
+export async function getFileSize (fileId, options) {
   validateSupport()
   const files = await bucket.find({ filename: fileId }).toArray()
   if (!files || files.length === 0) {
@@ -103,7 +104,7 @@ export async function getFileSize (fileId) {
   return files[0].length
 }
 
-export async function saveFileBlob (fileId, blob) {
+export async function saveFileBlob (fileId, blob, options) {
   console.log('[MongoDB GridFS] Saving file:', {
     fileId,
     blobType: blob ? blob.constructor.name : 'undefined',
@@ -164,7 +165,7 @@ export async function saveFileBlob (fileId, blob) {
   })
 }
 
-export async function deleteFile (fileId) {
+export async function deleteFile (fileId, options) {
   validateSupport()
   const files = await bucket.find({ filename: fileId }).toArray()
   if (!files || files.length === 0) {

package/providers/sqlite.js

@@ -4,7 +4,8 @@ export async function validateSupport () {
   if (!sqlite) throw Error(ERRORS.disabled)
 }
 
-export async function getFileBlob (fileId, range) {
+export async function getFileBlob (fileId, options = {}) {
+  const { range } = options
   return await new Promise((resolve, reject) => {
     sqlite.get('SELECT * FROM files WHERE id = ?', [fileId], (err, row) => {
       if (err) return reject(err)
@@ -64,7 +65,7 @@ export async function getFileBlob (fileId, range) {
   })
 }
 
-export async function saveFileBlob (fileId, blob) {
+export async function saveFileBlob (fileId, blob, options) {
   return await new Promise((resolve, reject) => {
     sqlite.run('INSERT OR REPLACE INTO files (id, data) VALUES (?, ?)', [fileId, blob], err => {
       if (err) return reject(err)
@@ -73,7 +74,7 @@ export async function saveFileBlob (fileId, blob) {
   })
 }
 
-export async function deleteFile (fileId) {
+export async function deleteFile (fileId, options) {
   return await new Promise((resolve, reject) => {
     sqlite.run('DELETE FROM files WHERE id = ?', [fileId], err => {
       if (err) return reject(err)
@@ -82,7 +83,7 @@ export async function deleteFile (fileId) {
   })
 }
 
-export async function getFileSize (fileId) {
+export async function getFileSize (fileId, options) {
   await validateSupport()
   return await new Promise((resolve, reject) => {
     sqlite.get('SELECT data FROM files WHERE id = ?', [fileId], (err, row) => {

package/server/uploadBuffer.js

@@ -17,11 +17,12 @@ export default async function uploadBuffer (buff, options = {}) {
 
   // try to save file to sqlite first to do an early exit if it fails
   try {
-    await saveFileBlob(storageType, fileId, buff)
+    await saveFileBlob(storageType, fileId, buff, meta)
   } catch (err) {
     console.error(err)
     throw new Error('Error saving file')
   }
+
   if (create) {
     const doc = { id: fileId, ...meta, storageType }
     // if some of the meta fields were undefined, remove them from the doc