feat(chrome-extension): WebSSO with URL-based session syncing [SDK-836]

[tmilewski]

Description

Expand the ability for @clerk/chrome-extension WebSSO to sync with host applications which use URL-based session syncing.

How to Update

WebSSO Local Development Host Permissions:

Add *://localhost:*/* to the host_permissions array in your manifest.json file:

{
  "host_permissions": ["*://localhost:*/*"]
}

If you're using a local domain other than localhost, you'll want replace that entry with your domain: *://<DOMAIN>/*

{
  "host_permissions": ["*://<DOMAIN>/*"]
}

WebSSO Provider settings:

<ClerkProvider
  publishableKey={publishableKey}
  routerPush={to => navigate(to)}
  routerReplace={to => navigate(to, { replace: true })}
  syncSessionWithTab

  // tokenCache is now storageCache (See below)
  storageCache={/* ... */}

  // [Development Only]: If the host application isn't on 
  // `http://localhost`, you can provide it here:
  syncSessionHost="http://<DOMAIN>"
>

WebSSO Storage Cache Interface:

With the prop change from tokenCache to storageCache, the interface has been expanded to allow for more flexibility.

The new interface is as follows:

type StorageCache = {
  createKey: (...keys: string[]) => string;
  get: <T = any>(key: string) => Promise<T>;
  remove: (key: string) => Promise<void>;
  set: (key: string, value: string) => Promise<void>;
};

Checklist

• npm test runs as expected.
• npm run build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation
• other:

Packages affected

• @clerk/backend
• @clerk/chrome-extension
• @clerk/clerk-js
• @clerk/clerk-expo
• @clerk/fastify
• gatsby-plugin-clerk
• @clerk/localizations
• @clerk/nextjs
• @clerk/clerk-react
• @clerk/remix
• @clerk/clerk-sdk-node
• @clerk/shared
• @clerk/themes
• @clerk/types
• build/tooling/chore

[changeset-bot]

🦋 Changeset detected

Latest commit: 75c8d36

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@clerk/chrome-extension	Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[dimkl]

@SokratisVidros Could you also take a look?

[tmilewski]

!snapshot

[clerk-cookie]

Hey @tmilewski - the snapshot version command generated the following package versions:

Package	Version
@clerk/backend	1.0.1-snapshot.vb99c163
@clerk/chrome-extension	1.0.1-snapshot.vb99c163
@clerk/clerk-js	5.0.1-snapshot.vb99c163
@clerk/clerk-expo	1.0.1-snapshot.vb99c163
@clerk/fastify	1.0.1-snapshot.vb99c163
gatsby-plugin-clerk	5.0.1-snapshot.vb99c163
@clerk/localizations	2.0.1-snapshot.vb99c163
@clerk/nextjs	5.0.1-snapshot.vb99c163
@clerk/clerk-react	5.0.1-snapshot.vb99c163
@clerk/remix	4.0.1-snapshot.vb99c163
@clerk/clerk-sdk-node	5.0.1-snapshot.vb99c163
@clerk/shared	2.0.1-snapshot.vb99c163
@clerk/themes	2.0.1-snapshot.vb99c163
@clerk/types	4.0.1-snapshot.vb99c163

Tip: Use the snippet copy button below to quickly install the required packages.
@clerk/backend

npm i @clerk/backend@1.0.1-snapshot.vb99c163 --save-exact

@clerk/chrome-extension

npm i @clerk/chrome-extension@1.0.1-snapshot.vb99c163 --save-exact

@clerk/clerk-js

npm i @clerk/clerk-js@5.0.1-snapshot.vb99c163 --save-exact

@clerk/clerk-expo

npm i @clerk/clerk-expo@1.0.1-snapshot.vb99c163 --save-exact

@clerk/fastify

npm i @clerk/fastify@1.0.1-snapshot.vb99c163 --save-exact

gatsby-plugin-clerk

npm i gatsby-plugin-clerk@5.0.1-snapshot.vb99c163 --save-exact

@clerk/localizations

npm i @clerk/localizations@2.0.1-snapshot.vb99c163 --save-exact

@clerk/nextjs

npm i @clerk/nextjs@5.0.1-snapshot.vb99c163 --save-exact

@clerk/clerk-react

npm i @clerk/clerk-react@5.0.1-snapshot.vb99c163 --save-exact

@clerk/remix

npm i @clerk/remix@4.0.1-snapshot.vb99c163 --save-exact

@clerk/clerk-sdk-node

npm i @clerk/clerk-sdk-node@5.0.1-snapshot.vb99c163 --save-exact

@clerk/shared

npm i @clerk/shared@2.0.1-snapshot.vb99c163 --save-exact

@clerk/themes

npm i @clerk/themes@2.0.1-snapshot.vb99c163 --save-exact

@clerk/types

npm i @clerk/types@4.0.1-snapshot.vb99c163 --save-exact

[pavelbinar]

Hi guys 👋🏻
Can you please add storageCache to the @clerk/clerk-react as well?
I am writing an desktop app running a react app in the web-view which does not support cookies, but does the local storage.

I would like to use the ClerkProvider in @clerk/clerk-react with storageCache option.