@dpgradio/creative 7.0.3 → 7.0.5

package/README.md

@@ -201,6 +201,26 @@ const radioToken = await hybrid.appLoaded()
 hybrid.decodeRadioToken(radioToken)
 ```
 
+## Authentication
+
+```js
+import { authentication } from '@dpgradio/creative'
+
+// Call once, at least before requiring authentication somewhere
+authentication.initialize()
+
+// Main usage: prompts for login if needed and sets the token in the API client
+await authentication.require()
+
+
+// Potentially helpful methods (but not required for typical usage)
+authentication.isLoggedIn()
+authentication.onRadioTokenChange(callback)
+authentication.onLogin(callback)
+authentication.askForLogin() // Does the same as require(), but does not await the result
+authentication.radioToken
+```
+
 ## Sharing Generator
 
 Example:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dpgradio/creative",
-  "version": "7.0.3",
+  "version": "7.0.5",
   "description": "Support package for standalone Javascript applications",
   "main": "src/index.js",
   "scripts": {

package/src/app/authentication.js

@@ -4,6 +4,14 @@ import { onLocalStorageChange } from '../utils/onLocalStorageChange.js'
 
 export const RADIO_TOKEN_LOCAL_STORAGE_KEY = 'radio-auth-token'
 
+const inDevelopment = () => {
+  try {
+    return import.meta.env?.DEV
+  } catch (error) {
+    return false
+  }
+}
+
 class Authentication {
   constructor() {
     this.radioToken = null
@@ -19,7 +27,14 @@ class Authentication {
         this.setToken(radioToken)
       }
     })
-    hybrid.on('authenticated', ({ radioToken }) => this.setToken(radioToken))
+    hybrid.on('authenticated', ({ radioToken }) => {
+      this.setToken(radioToken)
+    })
+    // When a user logs in or out in another view of the app than the one we're currently in,
+    // we need to update the token once the user returns to this view.
+    hybrid.on('didAppear', ({ radioToken }) => {
+      this.setToken(radioToken ?? null)
+    })
     onLocalStorageChange(RADIO_TOKEN_LOCAL_STORAGE_KEY, (token) => this.setToken(token), true)
   }
 
@@ -43,7 +58,7 @@ class Authentication {
   askForLogin() {
     this.markAskingForLogin(true)
 
-    if (import.meta?.env?.DEV) {
+    if (inDevelopment()) {
       this.setToken(prompt('[DEVELOPMENT] Please enter your radio token:'))
     } else if (hybrid.isNativeApp()) {
       hybrid.call('showAuthentication', { tier: 'light' })
@@ -70,7 +85,11 @@ class Authentication {
     return new Promise((resolve, reject) => {
       const onCompletion = () => (this.radioToken ? resolve() : reject('There is no authenticated user.'))
       this.onRadioTokenChange(onCompletion)
-      this.askingForLoginListeners.push(onCompletion)
+      this.askingForLoginListeners.push((askingForLogin) => {
+        if (!askingForLogin) {
+          onCompletion()
+        }
+      })
 
       this.askForLogin()
     })

package/src/index.js

@@ -9,6 +9,8 @@ export { default as configuration, config } from './config/config.js'
 
 export { default as api } from './api/api.js'
 
+export { default as authentication } from './app/authentication.js'
+
 export { default as loadScript } from './utils/loadScript.js'
 export { default as openLink } from './utils/openLink.js'
 export { default as tap } from './utils/tap.js'