FAQ & Troubleshooting

Common Issues

"Module '.../types' has no exported member ..."

• Ensure all types used in your code are exported from src/types.ts.

"Type 'Readable' is not assignable to type 'BlobPart'"

• Only use the File class from formdata-node in Node.js, not the browser's File.
• Buffer streams before passing to File.

"Upload failed"

• Check your API URL and credentials.
• Inspect the error message for more details.

"Invalid file type"

• In the browser, only File or Blob are accepted.
• In Node.js, use Buffer or Readable.

Debugging Tips

• Use { debug: true } to enable verbose logging.
• Catch and log errors with try/catch.

Migration

• If migrating from a previous SDK version, review the new dual entrypoint structure and shared types.
• Update your imports as shown in the usage guide.

Contributing

• PRs welcome! Please follow the code style and update docs/tests as needed.