basic-ftp

• Changed: Source is now written in Typescript, builds to Javascript with declaration files for npm package. Fixes #49.

• Fixed: Switch seamlessly between control and data connection for tracking timeout.

• Added: Full type-checking as part of CI with Typescript and JSDoc type declarations. Check is rigourous, settings include 'strict' and 'noImplicitAny'.
• Changed: Improved handling of unexpected server requests during transfer.

This release contains breaking changes:

• Changed: Client is now single-use only. It can't be used anymore once it closes and a new client has to be instantiated.
• Changed: All exceptions are now instances of Error, not custom error objects. Introduced FTPError for errors specific to FTP. (#37)

Non-breaking changes:

• Added: If there is a socket error outside of a task, the following task will receive it. (#43)
• Changed: Improved feedback if a developer forgets to use await or .then() for tasks. (#36)

Special thanks to @broofa for feedback and reviews.

• Fixed: Multibyte UTF-8 arriving in multiple chunks (#38)
• Fixed: Unit test throws unhandled exception (#44)
• Fixed: Provide stack trace when closing due to multiple tasks running
• Internal improvements to linting (@broofa)

• Added: Get last modification time of a file. (#32, @AnsonYeung)

• Fixed: Closing client during task will reject associated promise. (#34)

• Changed: Include hidden files in file listings, fixes removeDir and clearWorkingDir. Changes behaviour for downloadDir and list. (#29, @conlanpatrek)

• Changed: Timeout on control socket is only considered during active task, not when idle. This also fixes #27, as well as #26.

• Fixed: Regression where closed clients throws timeout because of idle socket. (#26)

• Fixed: JSDoc type annotations.
• Fixed: Minor fixes to documentation.

• Make it possible to reconnect after closing the client.

• Fixed: Make it possible to reconnect after closing the FTP context.

• Improved error handling and reporting.

• Various improvements to documentation.

• Fixed: Exception thrown if tasks will run in parallel because the user forget to use 'await'.
• Fixed: Describe in documentation what exactly happens if there is a timeout.

• Added: Use client.rename() to rename or move a file.
• Changed: Default timeout set to 30 seconds.
• Changed: Timeouts are tracked exlusively by data connection during transfer.
• Fixed: Node's socket.removeAllListeners() doesn't work, see https://github.com/nodejs/node/issues/20923
• Fixed: Node 8 is required, correct documentation and CI.

• Minor changes to documentation

• Fixed: Don't deny EPSV over IPv4. This can help in some circumstances with a NAT.

• Fixed: Don't prefer IPv6 by default.

• Added: Support IPv6 for passive mode (EPSV).
• Added: Detect automatically whether to use EPSV or PASV.
• Added: Log server IP when connected.

• Added: Convenience method client.access to simplify access to an FTP(S) server.
• Restructured API documentation.
• Stop using Yarn for internal dev-dependencies.

• Resolve simple NAT issues with PASV.
• Log socket encryption right before login.
• Fixed: Remove obsolete socket connection error listener.

• Improved documentation of client methods.
• Fixed: Reason for error when parsing PASV response was not reported.

• Mention regression in Node.js negatively affecting upload progress reporting.
• Small fixes in documentation.

• Added: Report transfer progress with client.trackProgress().
• Added: Error return codes can be ignored when removing a single file.
• Fixed: Timeout behaviour of control and data socket.

• Improve introduction.
• More unit tests.

• When downloading, handle incoming data before announcement from control socket arrives.
• More tests for uploading and downloading data including directory listings.
• Use download mechanism for directory listings as well.

• Improve documentation.
• Update linter.

• Change uploadDir() so that it reuses directories on the FTP server if they already exist. (#5)

• Fix linter complaint.

• Add method to remove a file.
• Fix listing parser autodetection by filtering out empty lines.
• Fix upload with TLS, wait for secureConnect if necessary.

• Fix TLS upgrade for data connections. (#4)

• Handle TLS upgrade error by reporting it to the current task handler.

• Add method to retrieve file size.

• Don't report unexpected positive completion codes as errors.
• Improve documentation.

• Mention DOS-style directory listing support in README.

• Add support for DOS-style directory listing.
• Select a compatible directory listing parser automatically.
• Throw an exception with a detailed description if the directory listing can't be parsed.

• Fix documentation of default arguments for login().

• Improve introduction in README

• Add default port for connect().
• Add default anonymous credentials for login().
• Improve documentation

• Accept more positive preliminary and completion replies for transfers.

• Documentation improvements
• More internal functions made available for custom extensions.

• Wait for both data and control connection reporting completion for list, upload and download.

• Add features() method to client that returns a parsed result of the FEAT command.
• Give access to internal list, upload and download functions for reuse in custom contexts.

• Handle case when downloading, a server might report transfer complete when it isn't.
• Document encoding property on FTPContext.

• Encoding can be set explicitly, defaults to UTF-8.
• Handle multiline responses arriving in multiple chunks.

• Support multiline responses.
• Get user access to some internal utility functions useful in custom contexts.

• Complete redesign: Better separation between a simple object-oriented client, clear customization points and access to internals. Better discovery of features. This release is very much not backwards-compatible.

• Add functions to upload, download and remove whole directories.
• Add function to ensure a given remote path, creating all directories as necessary.

• Differentiate between Basic API and Convenience API in documentation.

• Add convenience functions to request and change the current working directory.
• Return positive response results whenever reasonable.

• Listeners using once wherever possible.

• Fix result for send command.

• Improve documentation.

• Close sockets on timeout.

• Close data socket explicitly after upload is done.

• List: Some servers send confirmation on control socket before the data arrived.