feat: check for custom sw install path

src/widget/widget-config.js

@@ -4,6 +4,7 @@
 export const WIDGET_BASE_URL = `${process.env.STATIC_FILE_ORIGIN}/widget.js`
 
 const CLIENT_KEY_IDENTIFIER = 'integration'
+const INSTALL_PATH_KEY = 'installPath'
 
 export function isWidgetUrl (url) {
     const { href } = new URL(url)
@@ -14,6 +15,7 @@ function getConf (urlObj, conf = {}) {
     const [_, queryStr] = urlObj.href.split(/#|[?]/)
     const searchParams = new URLSearchParams(queryStr)
     conf.clientKey = searchParams.get(CLIENT_KEY_IDENTIFIER)
+    conf.installPath = searchParams.get(INSTALL_PATH_KEY) ?? '/'
     return conf
 }
 

src/widget/widget.js

@@ -10,9 +10,12 @@ const MDN_SW_DOCS_URL = 'https://developer.mozilla.org/en-US/docs/Web' +
                         '#Why_is_my_service_worker_failing_to_register'
 
 async function installSw (conf) {
-    const { clientId, clientKey } = conf
+    const { clientId, clientKey, installPath } = conf
     try {
-        const path = `${SW_PATH}?clientId=${clientId}&clientKey=${clientKey}`
+        let path = `${SW_PATH}?clientId=${clientId}&clientKey=${clientKey}`
+        if (installPath !== '/') {
+            path = installPath + path
+        }
         await navigator.serviceWorker.register(path)
     } catch (err) {
         console.warn(
@@ -55,17 +58,16 @@ function initWidget () {
     }
 
     const config = widgetConfigFromScriptTag()
-    const clientKey = config.clientKey
+    config.clientId = getRetrievalClientId()
+
     addHeadElement('link', {
         href: process.env.L1_ORIGIN,
         crossOrigin: '',
         rel: 'preconnect',
         id: 'saturn-preconnect'
     })
 
-    const clientId = getRetrievalClientId()
-    const conf = { clientId, clientKey }
-    installSw(conf)
+    installSw(config)
 }
 
 initWidget()

test/widget-config.spec.js

@@ -0,0 +1,24 @@
+import assert from 'node:assert/strict'
+import { describe, it } from 'node:test'
+import { widgetConfigFromUrl } from '#src/widget/widget-config.js'
+
+describe('widget-config', () => {
+    it('should get default config from URL', () => {
+        const clientKey = 'abc123'
+        const url = `https://portal.saturn.tech/widget.js#integration=${clientKey}`
+
+        const config = widgetConfigFromUrl(url)
+        assert.strictEqual(config.clientKey, clientKey)
+        assert.strictEqual(config.installPath, '/')
+    })
+
+    it('should get config from URL', () => {
+        const clientKey = 'abc123'
+        const installPath = '/test'
+        const url = `https://portal.saturn.tech/widget.js#integration=${clientKey}&installPath=${installPath}`
+
+        const config = widgetConfigFromUrl(url)
+        assert.strictEqual(config.clientKey, clientKey)
+        assert.strictEqual(config.installPath, installPath)
+    })
+})