{"id":26628124,"url":"https://github.com/briso10-dev/nodejs-buckets3","last_synced_at":"2026-02-19T12:02:48.832Z","repository":{"id":283374234,"uuid":"840145934","full_name":"Briso10-dev/nodeJS-bucketS3","owner":"Briso10-dev","description":"Uploading an object into a bucket S3 using AWS SDK for nodejs","archived":false,"fork":false,"pushed_at":"2025-03-19T22:11:59.000Z","size":1497,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-20T07:40:01.707Z","etag":null,"topics":["aws","javascript","nodejs","s3-bucket"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Briso10-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-09T04:23:59.000Z","updated_at":"2025-03-19T22:12:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"d761c545-8f02-47a0-964c-085c9edec0eb","html_url":"https://github.com/Briso10-dev/nodeJS-bucketS3","commit_stats":null,"previous_names":["briso10-dev/nodejs-buckets3"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Briso10-dev/nodeJS-bucketS3","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Briso10-dev%2FnodeJS-bucketS3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Briso10-dev%2FnodeJS-bucketS3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Briso10-dev%2FnodeJS-bucketS3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Briso10-dev%2FnodeJS-bucketS3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Briso10-dev","download_url":"https://codeload.github.com/Briso10-dev/nodeJS-bucketS3/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Briso10-dev%2FnodeJS-bucketS3/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29612510,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T10:52:55.328Z","status":"ssl_error","status_checked_at":"2026-02-19T10:52:26.323Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","javascript","nodejs","s3-bucket"],"created_at":"2025-03-24T12:28:03.031Z","updated_at":"2026-02-19T12:02:48.814Z","avatar_url":"https://github.com/Briso10-dev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AWS S3 Bucket File Manager\n\nA Node.js application demonstrating AWS S3 bucket operations using the AWS SDK for JavaScript v3. This project showcases basic S3 operations like uploading files and listing bucket contents.\n\n## Features\n\n- Upload files to S3 bucket\n- List objects in S3 bucket\n- Environment-based configuration\n- Docker support for containerized deployment\n\n## Tech Stack\n\n| Technology | Version | Purpose |\n|------------|---------|----------|\n| Node.js    | 20.x    | Runtime environment |\n| AWS SDK    | ^3.627.0| S3 bucket operations |\n| Docker     | -       | Containerization |\n| dotenv     | ^16.4.5 | Environment management |\n\n## Prerequisites\n\n- Node.js 20.x or higher\n- AWS account with S3 access\n- S3 bucket created\n- AWS credentials (Access Key and Secret Key)\n\n## Installation\n\n1. Clone the repository\n```bash\ngit clone https://github.com/Briso10-dev/nodeJS-bucketS3.git\ncd nodeJS-bucketS3\n```\n\n2. Install dependencies\n```bash\nnpm install\n```\n\n3. Configure environment variables\n```bash\ncp .env.example .env\n# Edit .env with your AWS credentials\n```\n\n## Configuration\n\nCreate a `.env` file with the following variables:\n```env\nEND_POINT=your_endpoint_url\nREGION=your_region\nACCESS_KEY=your_access_key\nSECRET_KEY=your_secret_key\n```\n\n## Usage\n\n### Running Locally\n\n```bash\nnode app.mjs\n```\n\n### Using Docker\n\n1. Build the image\n```bash\ndocker build -t s3-bucket-app .\n```\n\n2. Run the container\n```bash\ndocker run --env-file .env s3-bucket-app\n```\n\n## Code Examples\n\n### Uploading a File\n```javascript\nawait uploadFile(\n  \"your-bucket-name\",\n  \"test-file.txt\",\n  \"Hello World!\"\n);\n```\n\n### Listing Bucket Contents\n```javascript\nawait listObjects(\"your-bucket-name\");\n```\n\n## Security\n\n- Environment variables for sensitive data\n- Docker non-root user implementation\n- .gitignore configured for sensitive files\n\n## Author\n\n- [@Briso10-dev](https://github.com/Briso10-dev)\n\n## License\n\nThis project is licensed under the ISC License - see the [package.json](package.json) file for details.\n\n## Contributing\n\nFeel free to contribute to this project. Any contributions you make are greatly appreciated.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbriso10-dev%2Fnodejs-buckets3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbriso10-dev%2Fnodejs-buckets3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbriso10-dev%2Fnodejs-buckets3/lists"}