The changelog is here: https://github.com/typesense/typesense-js/releases The main reason we're switching from 1.x to 2.x is because in 2.x we're now doing URL encoding of collection names, alias names, etc inside of the library. Earlier you had to do it outside of the library if your collection name had special characters. If you're not doing external URL encoding, then it should be a seemless change to upgrade to 2.x