This is patch release fixing minor issues

• 🔧 Fix FileObject data in upload events via http transport
• 📔 Harden documentation
• See notes from major v3 release

• 📦 Packosphere @3.0.0
• ☄️ AtmosphereJS @3.0.0
• ✨ Refactored files.veliov.com demo app and its 📦 source code

Summary

• ✨ Refactor: Hook options: protected, onBeforeRemove, onAfterRemove, onInitiateUpload, onAfterUpload, namingFunction are now async
• 🤝 Refactor: Compatibility with meteor@3 and other modern packages
• ☄️ Refactor: Match FilesCollection APIs with new *Async methods of Mongo.Collection; Deprecate callback APIs on the Server
• 👨‍💻 Refactor: Utilize node's async APIs where suitable
• 👨‍💻 Refactor: Improve pause/resume logic on connection interruption/reconnect
• 📔 Docs: Updated and refactored docs with better examples
• 📔 Docs: Refactored JSDoc matching definitions in TypeScript
• 🤓 Dev: Improved TypeScript support
• 👷‍♂️ Dev: Improved debugging logs
• 👨‍🔬 Tests: Improved test-suite
• 👷‍♂️ Git: CI GitHub Action Workflows for lint and build tests

Contributors

Special thanks to: @bratelefant @harryadel @jankapunkt @StorytellerCZ @make-github-pseudonymous-again an other contributors who helped to build and pushed v3 release forward

Major changes

FilesCollection:

• ⚠️ FilesCollection#remove() — deprecated on server, use FilesCollection#removeAsync instead
• ⚠️ FilesCollection#findOne() — deprecated on server, use FilesCollection#findOneAsync instead
• ⚠️ FilesCollection#unlink() — deprecated on server, use FilesCollection#unlinkAsync instead
• ⚠️ FilesCollection#write() — deprecated on server, use FilesCollection#writeAsync instead
• ⚠️ FilesCollection#load() — deprecated on server, use FilesCollection#loadAsync instead

FileCursor:

• ⚠️ FileCursor#remove() — deprecated on server, use FileCursor#removeAsync instead

FilesCursor:

• ⚠️ FilesCursor#remove() — deprecated on server, use FilesCursor#removeAsync instead
• ⚠️ FilesCursor#hasNext() - deprecated, use FilesCursor#hasNextAsync instead
• ⚠️ FilesCursor#count() - deprecated, use FilesCursor#countDocuments instead
• ⚠️ FilesCursor#countAsync() - deprecated, use FilesCursor#countDocuments instead

FileUpload:

• ⚠️ FileUpload#start() is now async!
• ✨ New FileUpload#remainingTime {ReactiveVar} with upload remaining time in human-readable format

Callbacks and hooks:

• ⚠️ Anywhere: this.user() is deprecated, use this.userAsync() instead
• ⚠️ Client: FileUpload now always triggers end even in the case of successful and failed uploads; Before: end event wasn't called under certain conditions
• ⚠️ Client: All errors appeared during upload in all hooks and events of FileUpload are now instance of Meteor.Error; Before: Errors had mixed type or were simply text
• ⚠️ Client: Errors are the same now (type, code, text, reason, details) within DDP and HTTP protocols; Before: DDP and HTTP protocols had different errors
• ⚠️ Client: The next private events were removed from UploadInstance Class: upload, sendEOF, prepare, sendChunk, proceedChunk

New methods

FilesCollection:

• ✨ Client: FilesCollection#insertAsync()
• ✨ Anywhere: FilesCollection#updateAsync()
• ✨ Anywhere: FilesCollection#removeAsync()
• ✨ Anywhere: FilesCollection#findOneAsync()
• ✨ Anywhere: FilesCollection#countDocuments()
• ✨ Anywhere: FilesCollection#estimatedDocumentCount()
• ✨ Server: FilesCollection#unlinkAsync()
• ✨ Server: FilesCollection#writeAsync()
• ✨ Server: FilesCollection#loadAsync()

FileUpload:

• ✨ New FileUpload#remainingTime {ReactiveVar} with upload remaining time in human-readable format

FileCursor:

• ✨ Anywhere: FileCursor#removeAsync()
• ✨ Anywhere: FileCursor#fetchAsync()
• ✨ Anywhere: FileCursor#withAsync()

FilesCursor:

• ✨ Anywhere: FilesCursor#getAsync()
• ✨ Anywhere: FilesCursor#hasNextAsync()
• ✨ Anywhere: FilesCursor#nextAsync()
• ✨ Anywhere: FilesCursor#hasPreviousAsync()
• ✨ Anywhere: FilesCursor#previousAsync()
• ✨ Anywhere: FilesCursor#removeAsync()
• ✨ Anywhere: FilesCursor#fetchAsync()
• ✨ Anywhere: FilesCursor#firstAsync()
• ✨ Anywhere: FilesCursor#lastAsync()
• ✨ Anywhere: FilesCursor#countDocuments()
• ✨ Anywhere: FilesCursor#forEachAsync()
• ✨ Anywhere: FilesCursor#eachAsync()
• ✨ Anywhere: FilesCursor#mapAsync()
• ✨ Anywhere: FilesCursor#currentAsync()
• ✨ Anywhere: FilesCursor#observeAsync()
• ✨ Anywhere: FilesCursor#observeChangesAsync()

New features

• ✨ Client: FileUpload#remainingTime ReactiveVar — returns remaining upload time in hh:mm:ss format;

Other changes

• 🐞 Bug: Fixed #885 — Upload empty file now end upload with error
• 🐞 Bug: Fixed #901 — Caused by #894
• 🔧 Security: Fixed #894 — now x_mtok cookie is set with secure and httpOnly flags
• 🔧 Refactor: Fixed FileCursor#with implementation
• ✨ Refactor: FileUpload#abort is now async
• ✨ Server: FilesCollection#addFile is now async
• ✨ Server: FilesCollection#download is now async
• ✨ Server: WriteStream Class is now available for import
• ⚙️ Client: disableUpload option processed on the client and returns error in the end/error events, and onError hooks. Before — throws an error upon calling .insert() method

Dependencies

release:

• eventemitter3@5.0.1, was 4.0.7
• removed: abort-controller, now using native AbortController
• removed: fs-extra, now using native fs

dev:

• added: chai@4.5.0
• added: sinon@7.5.0

Major changes:

• no

Changes:

• 👨‍🔧 Fixed #870, thanks to @Gobliins
• 🤝 Compatibility with meteor@2.11.0

• 👨‍💻 Potential fix for #857 (windows); Thanks to @Leekao

Changes:

• 👨‍💻 Improve createIndex helper
• 👨‍💻 Improve error output when FileSystem destination not writable; Related to #857, thanks to @Leekao
• 🐞 Fix custom allowedOrigins option for CORS; Closing #850, thanks to @djlogan2;
• 📔 Improve AWS S3 documentation, by @xsyann;

Notes:

• 👨‍🔬 Tested with latest release of meteor@2.8.0

New features:

• ✨ opts.sanitize method, read more in Constructor docs; Thanks to @xet7 and @mfilser

Other Changes:

• 👷‍♂️ Minor codebase enhancements and cleanups

• 👨‍💻 Fix #842, a newly detected bug by @chrschae; Fixing case when namingFunction returns new nested path cause exception in .write() and .load() methods

Breaking Changes

• ⚠️ Changes in namingFunction, — now naming function acts the same on the Client and Server, upon insert, load, and write. Test your implementation with changed logic. Output of Server function supersedes Client's function output

Changes

• 📔 Merge #843 and fix #820, thanks to @Prinzhorn
• 📔 Documentation refactoring focused on examples and its simplifications
• 👨‍💻 Support nested custom path returned from namingFunction
• 👨‍💻 Fix namingFunction behavior on Client and Server in upload, load, and write methods, closing #842; Thanks to @chrschae
• 👷‍♂️ Now library exports its helpers import { FilesCollection, helpers };
• 👷‍♂️ Add .meteorignore to minimize package's footprint

• 👷‍♂️ Fix index creation (ensure)

Major changes:

• ⚠️ FSName now sanitized and limited to 28 symbols, no white-spaces allowed
• ⚠️ fileId now sanitized and limited to 20 symbols, no white-spaces allowed
• ⚠️ File extension now sanitized and limited to 20 symbols, no white-spaces allowed
• 📦 Decouple fs-extra, use native node.js fs module
• 👨‍💻 Add missing isData helper via #795, by @harryadel

Changes:

• 👷‍♂️ Fix: #827, thanks to @aertms
• 👷‍♂️ Fix: #832, thanks to @polygonwood
• 👷‍♂️ Fix: #813, thanks to @Prinzhorn
• 👨‍💻 Fix: #834, thanks to @bladerunner2020
• 📔 Fix: #803, thanks to @bartenra
• 🏗 Sanitize inputs (FSName, fileId, extension) to avoid command injection
• 📔 Improved documentation, special thanks to @Prinzhorn and @make-github-pseudonymous-again
• 📔 GridFS documentation fix: #818
• 👷‍♂️ Utilize Meteor._debug where possible instead of console.log

Other:

• 🤝 Compatibility with meteor@2.7.3