I'm looking to upgrade @intercom/messenger-js-sdk from 0.0.13 to 0.0.18 in our Angular application, but I can't find a changelog or release notes anywhere.
The npm package doesn't link to a public GitHub repository, and there's no CHANGELOG.md in the package.
Could you please:
Publish a changelog for the SDK (even just in the README)?
Or point me to where release notes are documented?
This would help developers assess upgrade risk and understand new features. I've done a diff and can see additions like hideNotifications() and whoami(), but official documentation would be appreciated.
Thanks!
Best answer by Dara K
Hey @Rasmus Skovdal
We don’t publish a public changelog for @intercom/messenger-js-sdk yet. For method coverage, use the JavaScript API docs; you’ll see additions like hideNotifications documented there.
What I can share now:
No documented breaking changes between 0.0.13 and 0.0.18.
New/covered APIs: hideNotifications is supported (docs). whoami isn’t documented on the public JS methods page, where are you seeing this?
Safe upgrade checklist:
Verify your usage of boot/update/hide/show/trackEvent/getVisitorId against the docs.
Build locally and sanity‑test: Messenger loads, events fire, unread callbacks, and any custom launchers.
If you tree‑shake or use strict TS, recheck imports/typings.
We don’t publish a public changelog for @intercom/messenger-js-sdk yet. For method coverage, use the JavaScript API docs; you’ll see additions like hideNotifications documented there.
What I can share now:
No documented breaking changes between 0.0.13 and 0.0.18.
New/covered APIs: hideNotifications is supported (docs). whoami isn’t documented on the public JS methods page, where are you seeing this?
Safe upgrade checklist:
Verify your usage of boot/update/hide/show/trackEvent/getVisitorId against the docs.
Build locally and sanity‑test: Messenger loads, events fire, unread callbacks, and any custom launchers.
If you tree‑shake or use strict TS, recheck imports/typings.
whoami is exported directly from the SDK source (index.ts) and documented in the package's own README.md (shipped with the npm package). It returns Record<string, string> | undefined and retrieves the current user info from the session.
It was added somewhere between 0.0.13 and 0.0.18 — I found it by diffing the two versions since there's no changelog. The README even includes a usage example:
import { whoami } from "@intercom/messenger-js-sdk";
var currentUser = whoami();
So it's in the SDK you ship, just not on the public JS methods docs page yet. Might be worth adding there?
