@startupjs-ui/file-input 0.1.5 → 0.1.9

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 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
+
+
+
+
+
 ## [0.1.5](https://github.com/startupjs/startupjs-ui/compare/v0.1.4...v0.1.5) (2025-12-29)
 
 **Note:** Version bump only for package @startupjs-ui/file-input

package/files.plugin.js

@@ -3,7 +3,8 @@ import { createPlugin } from 'startupjs/registry'
 import busboy from 'busboy'
 import sharp from 'sharp'
 import { DELETE_FILE_URL, GET_FILE_URL, getDeleteFileUrl, getFileUrl, getUploadFileUrl, UPLOAD_SINGLE_FILE_URL } from './constants.js'
-import { deleteFile, getDefaultStorageType, getFileBlob, getFileSize, saveFileBlob } from './providers/index.js'
+import { deleteFile, getDefaultStorageType, getFileBlob, getFileSize } from './providers/index.js'
+import { uploadBuffer } from './server/index.js'
 
 export default createPlugin({
   name: 'files',
@@ -217,51 +218,19 @@ export default createPlugin({
           stream.on('data', data => buffers.push(data))
 
           stream.on('end', async () => {
-            blob = Buffer.concat(buffers)
-            meta = { filename, mimeType, encoding, storageType } // Update meta here to ensure it includes modifications for images
-
+            const blob = Buffer.concat(buffers)
+            meta = { filename, mimeType, encoding, storageType }
             if (!blob) return res.status(500).send('No file was uploaded')
 
             // extract extension from filename
             console.log('meta.filename', meta.filename)
             const extension = meta.filename?.match(/\.([^.]+)$/)?.[1]
             if (extension) meta.extension = extension
-            const create = !fileId
-            if (!fileId) fileId = $.id()
-            // try to save file to sqlite first to do an early exit if it fails
             try {
-              await saveFileBlob(storageType, fileId, blob)
+              fileId = await uploadBuffer(blob, { fileId, meta })
             } catch (err) {
               console.error(err)
-              return res.status(500).send('Error saving file')
-            }
-            if (create) {
-              const doc = { id: fileId, ...meta }
-              // if some of the meta fields were undefined, remove them from the doc
-              for (const key in meta) {
-                if (meta[key] == null) delete doc[key]
-              }
-              await $.files.addNew(doc)
-            } else {
-              const $file = await sub($.files[fileId])
-
-              // when changing storageType we should delete the file from the old storageType
-              const oldStorageType = $file.storageType.get()
-              if (oldStorageType !== meta.storageType) {
-                try {
-                  await deleteFile(oldStorageType, fileId)
-                } catch (err) {
-                  console.error(err)
-                  return res.status(500).send(`Error deleting file from old storageType ${oldStorageType}`)
-                }
-              }
-
-              const doc = { ...$file.get(), ...meta, updatedAt: Date.now() }
-              // if some of the meta fields were undefined, remove them from the doc
-              for (const key in meta) {
-                if (meta[key] == null) delete doc[key]
-              }
-              await $file.set(doc)
+              return res.status(500).send(err.message)
             }
             console.log(`Uploaded file to ${storageType}`, fileId)
             res.json({ fileId })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@startupjs-ui/file-input",
-  "version": "0.1.5",
+  "version": "0.1.9",
   "publishConfig": {
     "access": "public"
   },
@@ -9,6 +9,7 @@
   "type": "module",
   "exports": {
     ".": "./index.tsx",
+    "./server": "./server/index.js",
     "./constants": "./constants.js",
     "./deleteFile": "./deleteFile.ts",
     "./uploadFile": "./uploadFile.ts",
@@ -27,6 +28,7 @@
     "sharp": "^0.34.5"
   },
   "peerDependencies": {
+    "@aws-sdk/client-s3": "*",
     "@azure/storage-blob": "*",
     "mongodb": "*",
     "react": "*",
@@ -34,6 +36,9 @@
     "startupjs": "*"
   },
   "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": {
+      "optional": true
+    },
     "@azure/storage-blob": {
       "optional": true
     },
@@ -41,5 +46,5 @@
       "optional": true
     }
   },
-  "gitHead": "1b90893dc24a9b3ffde1284c58996b42e98913c6"
+  "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/index.js

@@ -0,0 +1 @@
+export { default as uploadBuffer } from './uploadBuffer.js'

package/server/uploadBuffer.js

@@ -0,0 +1,55 @@
+import { $, sub } from 'startupjs'
+import { deleteFile, getDefaultStorageType, saveFileBlob } from '../providers/index.js'
+
+export default async function uploadBuffer (buff, options = {}) {
+  let { fileId, meta = {} } = options
+
+  let storageType = meta.storageType
+  try {
+    storageType ??= await getDefaultStorageType()
+  } catch (err) {
+    console.error(err)
+    throw new Error('Error getting default storage type')
+  }
+
+  const create = !fileId
+  if (!fileId) fileId = $.id()
+
+  // try to save file to sqlite first to do an early exit if it fails
+  try {
+    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
+    for (const key in meta) {
+      if (meta[key] == null) delete doc[key]
+    }
+    await $.files.addNew(doc)
+  } else {
+    const $file = await sub($.files[fileId])
+
+    // when changing storageType we should delete the file from the old storageType
+    const oldStorageType = $file.storageType.get()
+    if (oldStorageType !== storageType) {
+      try {
+        await deleteFile(oldStorageType, fileId)
+      } catch (err) {
+        console.error(err)
+        throw new Error(`Error deleting file from old storageType ${oldStorageType}`)
+      }
+    }
+
+    const doc = { ...$file.get(), ...meta, storageType, updatedAt: Date.now() }
+    // if some of the meta fields were undefined, remove them from the doc
+    for (const key in meta) {
+      if (meta[key] == null) delete doc[key]
+    }
+    await $file.set(doc)
+  }
+  return fileId
+}