{"id":17821526,"url":"https://github.com/a179346/nextjs-chunk-upload-action","last_synced_at":"2025-03-18T10:30:23.367Z","repository":{"id":224941273,"uuid":"764635397","full_name":"a179346/nextjs-chunk-upload-action","owner":"a179346","description":"Uploading large files with chunking using server action in Next.js","archived":false,"fork":false,"pushed_at":"2024-04-01T09:45:52.000Z","size":291,"stargazers_count":10,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-11T03:37:58.654Z","etag":null,"topics":["chunk","chunk-upload","chunked","file-upload","nextjs","react","server-action","server-actions","typescript","upload"],"latest_commit_sha":null,"homepage":"https://github.com/a179346/nextjs-chunk-upload-action","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a179346.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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-02-28T12:46:57.000Z","updated_at":"2024-12-31T02:57:42.000Z","dependencies_parsed_at":"2024-04-01T10:51:12.784Z","dependency_job_id":null,"html_url":"https://github.com/a179346/nextjs-chunk-upload-action","commit_stats":null,"previous_names":["a179346/nextjs-chunk-upload-action"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a179346%2Fnextjs-chunk-upload-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a179346%2Fnextjs-chunk-upload-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a179346%2Fnextjs-chunk-upload-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a179346%2Fnextjs-chunk-upload-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a179346","download_url":"https://codeload.github.com/a179346/nextjs-chunk-upload-action/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243922082,"owners_count":20369344,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["chunk","chunk-upload","chunked","file-upload","nextjs","react","server-action","server-actions","typescript","upload"],"created_at":"2024-10-27T17:17:59.756Z","updated_at":"2025-03-18T10:30:23.029Z","avatar_url":"https://github.com/a179346.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ch1 align=\"center\"\u003e ⭕ nextjs-chunk-upload-action ⭕\u003c/h1\u003e\n\n\u003cp\u003e\n  \u003ca href=\"https://github.com/a179346/nextjs-chunk-upload-action/actions/workflows/npm-publish.yml\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://github.com/a179346/nextjs-chunk-upload-action/actions/workflows/npm-publish.yml/badge.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/nextjs-chunk-upload-action\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://img.shields.io/npm/v/nextjs-chunk-upload-action?maxAge=3600)\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/a179346/nextjs-chunk-upload-action#readme\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/documentation-yes-brightgreen.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/a179346/nextjs-chunk-upload-action/graphs/commit-activity\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Maintenance\" src=\"https://img.shields.io/badge/Maintained%3F-yes-green.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/a179346/nextjs-chunk-upload-action/blob/master/LICENSE\" target=\"_blank\"\u003e\n    \u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/github/license/a179346/nextjs-chunk-upload-action\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003c/div\u003e\n\n\u003e Uploading large files with chunking using server action in Next.js\n\n ## 🔗 Link\n+ [Github](https://github.com/a179346/nextjs-chunk-upload-action#readme)\n+ [npm](https://www.npmjs.com/package/nextjs-chunk-upload-action)\n+ [API Reference](https://github.com/a179346/nextjs-chunk-upload-action/blob/main/docs/api-reference.md)\n\n## 📥 Install\n\n```sh\nnpm i nextjs-chunk-upload-action\n```\n\n## 📖 Example\n\nExample: [nextjs-chunk-upload-action-example](https://github.com/a179346/nextjs-chunk-upload-action-example)\n\n```ts\n// upload-form.tsx\n\n'use client';\n\nimport { ChunkUploader } from 'nextjs-chunk-upload-action';\n\nimport { chunkUploadAction } from './chunk-upload-action';\n\nexport function UploadForm() {\n  const handleFormAction = (formData: FormData) =\u003e {\n    const file = formData.get('file') as File;\n    if (!file) return;\n\n    const uploader = new ChunkUploader({\n      file,\n      onChunkUpload: chunkUploadAction,\n      metadata: { name: file.name },\n      onChunkComplete: (bytesAccepted, bytesTotal) =\u003e {\n        console.log('Progress:', `${bytesAccepted} / ${bytesTotal}`);\n      },\n      onError: error =\u003e {\n        console.error(error);\n      },\n      onSuccess: () =\u003e {\n        console.log('Upload complete');\n      },\n    });\n\n    uploader.start();\n  };\n\n  return (\n    \u003cform className=\"flex flex-col items-center justify-center\" action={handleFormAction}\u003e\n      \u003cinput name=\"file\" type=\"file\" required className=\"rounded-lg border-2 border-dashed p-4\" /\u003e\n      \u003cbutton type=\"submit\" className=\"mt-4 rounded-lg bg-blue-500 p-2 text-white\"\u003e\n        Upload\n      \u003c/button\u003e\n    \u003c/form\u003e\n  );\n}\n```\n\n```ts\n// chunk-upload-action.ts\n\n'use server';\n\nimport type { FileHandle } from 'fs/promises';\nimport { open } from 'fs/promises';\nimport { join } from 'path';\n\nimport type { ChunkUploadHandler } from 'nextjs-chunk-upload-action';\n\nexport const chunkUploadAction: ChunkUploadHandler\u003c{ name: string }\u003e = async (\n  chunkFormData,\n  metadata\n) =\u003e {\n  const blob = chunkFormData.get('blob');\n  const offset = Number(chunkFormData.get('offset'));\n  const buffer = Buffer.from(await blob.arrayBuffer());\n  const filePath = join('./uploads', metadata.name);\n\n  let fileHandle: FileHandle | undefined;\n  try {\n    fileHandle = await open(filePath, offset === 0 ? 'w' : 'r+');\n    await fileHandle.write(buffer, 0, buffer.length, offset);\n  } finally {\n    await fileHandle?.close();\n  }\n};\n```\n\n## 🤝 Contributing\n\nContributions, issues and feature requests are welcome!\u003cbr /\u003eFeel free to check [issues page](https://github.com/a179346/nextjs-chunk-upload-action/issues).\n\n## 🌟 Show your support\n\nGive a ⭐️ if this project helped you!\n\n## 📝 License\n\nCopyright © 2024 [a179346](https://github.com/a179346).\u003cbr /\u003e\nThis project is [MIT](https://github.com/a179346/nextjs-chunk-upload-action/blob/master/LICENSE) licensed.\n\n***\n_This README was generated with ❤️ by [readme-md-generator](https://github.com/kefranabg/readme-md-generator)_","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa179346%2Fnextjs-chunk-upload-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa179346%2Fnextjs-chunk-upload-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa179346%2Fnextjs-chunk-upload-action/lists"}