Breaking changes in version 4? about intercom-node

[colmdoyle]

Great callout @hugihlynsson, and definitely on us to fix for you.

tldr - Yes, 4.0.0 is definitely a breaking change, the biggest ones being that as of API v2.6 client.conversations.list now uses a cursor based pagination system instead of just page numbers.

Also we spotted a typo in one of our enum value, so if you rely on that you'll start seeing TS errors

[SeanHealy33]

Hi @hugihlynsson to go a bit deeper on the specific changes to conversations

OLD

const response = await client.conversations.list({
    order: Order.DESC,
    sort: SortBy.UpdatedAt,
    page: 1,
    perPage: 10,
});

NEW

const response = await client.conversations.list({
    startingAfter: 'WzE2NzA0MjI1MjkwMDAsMjQzMTY3NzA2ODcsMl0=',
    perPage: 10,
});

The new list uses a startingAfter param to get the next page instead of the old page parameter (the next starting_after key is provided on each page as you get it). As of 4.0 we also removed page order and sort from the list method here since they no longer do anything as of API Version 2.6

[colmdoyle]

Hope that clears it up a bit more for you @hugihlynsson, feel free to reopen this issue and tag me if you've any more questions

[hugihlynsson]

That's the info we needed. Thanks!