Refresh session when 401 errors happens

[karreiro]

WHY are these changes introduced?

Fixes #4618

The Assets API may return 401 statuses after running for a while, and that may happen before the session gets refreshed. To prevent the development server from terminating, if we get that status, we manually refresh the session.

WHAT is this pull request doing?

This PR solves this by calling session.refresh() when it gets a 401 error. We'd face a circular dependency if we were to get the types correctly, so this PR checks the refresh at runtime and just calls it (this will no longer be necessary with #4769 solved).

How to test your changes?

• Update the SESSION_TIMEOUT_IN_MS value (in dev-server-session.ts) to 300 * 60 * 1000
• Run shopify theme dev --verbose
• Leave a bash script appending a value in the sections/announcement-bar.liquid every 5 seconds
• Notice that the session will get refreshed after a while (max wait time: ~2h)
• Here's my results (in my test, I added some extra console.log logs to make things a bit clearer)

Post-release steps

N/A

Measuring impact

How do we know this change was effective? Please choose one:

• n/a - this doesn't need measurement, e.g. a linting rule or a bug-fix
• Existing analytics will cater for this addition
• PR includes analytics changes to measure impact

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟡	Statements	72.12% (+0.08% 🔼)	8390/11633
🟡	Branches	68.56% (+0.06% 🔼)	4059/5920
🟡	Functions	71.43% (+0.06% 🔼)	2198/3077
🟡	Lines	72.53% (+0.08% 🔼)	7935/10941

Test suite run success

1901 tests passing in 867 suites.

Report generated by 🧪jest coverage report action from 45e9fa7

[frandiox]

Great job, I think this is the right approach, refreshing on demand 🎉

It would be great if we could disallow destructuring the session object somehow... but I'm not sure if we can do that in JS 🤔

this will no longer be necessary with #4769 solved).

Nice!

[frandiox]

/snapit

[github-actions]

🫰✨ Thanks @frandiox! Your snapshot has been published to npm.

Test the snapshot by intalling your package globally:

pnpm i -g @shopify/[email protected]

After installing, validate the version by running just shopify in your terminal
If the versions don't match, you might have multiple global instances installed.
Use which shopify to find out which one you are running and uninstall it.

[karreiro]

@Shopify/app-inner-loop Could you please take a look at this one to unblock merge? 🙇

[karreiro]

(I just rebased the branch because it got a conflict — it's ready to merge again)