shoubhiksaha/notion-multipart-uploader

This is a small Node.js package that makes it easier to upload files to Notion using its API. Notion's upload process for larger files normally requires you to manually split the file into pieces, send each piece, then tell Notion you are done, and this package handles all of those steps for you so you just call one function with your file. It can handle files up to 5GB on paid Notion workspaces by splitting them into chunks and uploading up to three chunks at the same time by default, which speeds things up for bigger files. If a chunk fails to upload because of a network problem, it automatically retries with increasing delays between attempts, but it will not keep retrying if Notion returns an error caused by something like exceeding a billing limit, since retrying that kind of error would never succeed anyway. You can also set a timeout so a stuck upload gets cancelled instead of hanging forever, and cancel an upload yourself using a standard AbortSignal. The package has no external dependencies. It only uses the built in fetch and FormData features already available in modern Node.js, which keeps it lightweight. It works with any kind of file, including audio, video, images, and PDFs. Once a file finishes uploading, you get back a file ID that you can attach to a Notion page or block using the regular Notion SDK. For people who only need to upload very small files under 20MB, an older, simpler version of the package without the chunking and concurrency logic is still available to install separately. The package is released under the MIT license.