@staffbase/plugins-client-sdk 2.0.2 → 3.0.0-alpha.2

package/dist/plugins-client-sdk.js

@@ -2,12 +2,12 @@
  * Bundle of @staffbase/plugins-client-sdk
  * @file Staffbase plugins client SDK for JavaScript
  * @see https://github.com/Staffbase/plugins-client-sdk#readme
- * @version 2.0.1
+ * @version 3.0.0-alpha.2
  *
  * @author Stefan Staude <stefan.staude@staffbase.com>
  * @author Daniel Große <daniel.grosse@staffbase.com>
  *
- * @copyright  2024
+ * @copyright  2026
  * @license Apache-2.0
  */
 
@@ -42,6 +42,8 @@ var loglevel = {
     var undefinedType = "undefined";
     var isIE = typeof window !== undefinedType && typeof window.navigator !== undefinedType && /Trident\/|MSIE /.test(window.navigator.userAgent);
     var logMethods = ["trace", "debug", "info", "warn", "error"];
+    var _loggersByName = {};
+    var defaultLogger = null;
 
     // Cross-browser bind equivalent that works at least back to IE6
     function bindMethod(obj, methodName) {
@@ -94,23 +96,31 @@ var loglevel = {
 
     // These private functions always need `this` to be set properly
 
-    function replaceLoggingMethods(level, loggerName) {
+    function replaceLoggingMethods() {
       /*jshint validthis:true */
+      var level = this.getLevel();
+
+      // Replace the actual methods.
       for (var i = 0; i < logMethods.length; i++) {
         var methodName = logMethods[i];
-        this[methodName] = i < level ? noop : this.methodFactory(methodName, level, loggerName);
+        this[methodName] = i < level ? noop : this.methodFactory(methodName, level, this.name);
       }
 
       // Define log.log as an alias for log.debug
       this.log = this.debug;
+
+      // Return any important warnings.
+      if (typeof console === undefinedType && level < this.levels.SILENT) {
+        return "No console available for logging";
+      }
     }
 
     // In old IE versions, the console isn't present until you first open it.
     // We build realMethod() replacements here that regenerate logging methods
-    function enableLoggingWhenConsoleArrives(methodName, level, loggerName) {
+    function enableLoggingWhenConsoleArrives(methodName) {
       return function () {
         if (typeof console !== undefinedType) {
-          replaceLoggingMethods.call(this, level, loggerName);
+          replaceLoggingMethods.call(this);
           this[methodName].apply(this, arguments);
         }
       };
@@ -118,14 +128,34 @@ var loglevel = {
 
     // By default, we use closely bound real methods wherever possible, and
     // otherwise we wait for a console to appear, and then try again.
-    function defaultMethodFactory(methodName, level, loggerName) {
+    function defaultMethodFactory(methodName, _level, _loggerName) {
       /*jshint validthis:true */
       return realMethod(methodName) || enableLoggingWhenConsoleArrives.apply(this, arguments);
     }
-    function Logger(name, defaultLevel, factory) {
+    function Logger(name, factory) {
+      // Private instance variables.
       var self = this;
-      var currentLevel;
-      defaultLevel = defaultLevel == null ? "WARN" : defaultLevel;
+      /**
+       * The level inherited from a parent logger (or a global default). We
+       * cache this here rather than delegating to the parent so that it stays
+       * in sync with the actual logging methods that we have installed (the
+       * parent could change levels but we might not have rebuilt the loggers
+       * in this child yet).
+       * @type {number}
+       */
+      var inheritedLevel;
+      /**
+       * The default level for this logger, if any. If set, this overrides
+       * `inheritedLevel`.
+       * @type {number|null}
+       */
+      var defaultLevel;
+      /**
+       * A user-specific level for this logger. If set, this overrides
+       * `defaultLevel`.
+       * @type {number|null}
+       */
+      var userLevel;
       var storageKey = "loglevel";
       if (typeof name === "string") {
         storageKey += ":" + name;
@@ -158,9 +188,10 @@ var loglevel = {
         if (typeof storedLevel === undefinedType) {
           try {
             var cookie = window.document.cookie;
-            var location = cookie.indexOf(encodeURIComponent(storageKey) + "=");
+            var cookieName = encodeURIComponent(storageKey);
+            var location = cookie.indexOf(cookieName + "=");
             if (location !== -1) {
-              storedLevel = /^([^;]+)/.exec(cookie.slice(location))[1];
+              storedLevel = /^([^;]+)/.exec(cookie.slice(location + cookieName.length + 1))[1];
             }
           } catch (ignore) {}
         }
@@ -177,7 +208,6 @@ var loglevel = {
         // Use localStorage if available
         try {
           window.localStorage.removeItem(storageKey);
-          return;
         } catch (ignore) {}
 
         // Use session cookie as fallback
@@ -185,6 +215,17 @@ var loglevel = {
           window.document.cookie = encodeURIComponent(storageKey) + "=; expires=Thu, 01 Jan 1970 00:00:00 UTC";
         } catch (ignore) {}
       }
+      function normalizeLevel(input) {
+        var level = input;
+        if (typeof level === "string" && self.levels[level.toUpperCase()] !== undefined) {
+          level = self.levels[level.toUpperCase()];
+        }
+        if (typeof level === "number" && level >= 0 && level <= self.levels.SILENT) {
+          return level;
+        } else {
+          throw new TypeError("log.setLevel() called with invalid level: " + input);
+        }
+      }
 
       /*
        *
@@ -203,35 +244,34 @@ var loglevel = {
       };
       self.methodFactory = factory || defaultMethodFactory;
       self.getLevel = function () {
-        return currentLevel;
+        if (userLevel != null) {
+          return userLevel;
+        } else if (defaultLevel != null) {
+          return defaultLevel;
+        } else {
+          return inheritedLevel;
+        }
       };
       self.setLevel = function (level, persist) {
-        if (typeof level === "string" && self.levels[level.toUpperCase()] !== undefined) {
-          level = self.levels[level.toUpperCase()];
-        }
-        if (typeof level === "number" && level >= 0 && level <= self.levels.SILENT) {
-          currentLevel = level;
-          if (persist !== false) {
-            // defaults to true
-            persistLevelIfPossible(level);
-          }
-          replaceLoggingMethods.call(self, level, name);
-          if (typeof console === undefinedType && level < self.levels.SILENT) {
-            return "No console available for logging";
-          }
-        } else {
-          throw "log.setLevel() called with invalid level: " + level;
+        userLevel = normalizeLevel(level);
+        if (persist !== false) {
+          // defaults to true
+          persistLevelIfPossible(userLevel);
         }
+
+        // NOTE: in v2, this should call rebuild(), which updates children.
+        return replaceLoggingMethods.call(self);
       };
       self.setDefaultLevel = function (level) {
-        defaultLevel = level;
+        defaultLevel = normalizeLevel(level);
         if (!getPersistedLevel()) {
           self.setLevel(level, false);
         }
       };
       self.resetLevel = function () {
-        self.setLevel(defaultLevel, false);
+        userLevel = null;
         clearPersistedLevel();
+        replaceLoggingMethods.call(self);
       };
       self.enableAll = function (persist) {
         self.setLevel(self.levels.TRACE, persist);
@@ -239,13 +279,25 @@ var loglevel = {
       self.disableAll = function (persist) {
         self.setLevel(self.levels.SILENT, persist);
       };
+      self.rebuild = function () {
+        if (defaultLogger !== self) {
+          inheritedLevel = normalizeLevel(defaultLogger.getLevel());
+        }
+        replaceLoggingMethods.call(self);
+        if (defaultLogger === self) {
+          for (var childName in _loggersByName) {
+            _loggersByName[childName].rebuild();
+          }
+        }
+      };
 
-      // Initialize with the right level
+      // Initialize all the internal levels.
+      inheritedLevel = normalizeLevel(defaultLogger ? defaultLogger.getLevel() : "WARN");
       var initialLevel = getPersistedLevel();
-      if (initialLevel == null) {
-        initialLevel = defaultLevel;
+      if (initialLevel != null) {
+        userLevel = normalizeLevel(initialLevel);
       }
-      self.setLevel(initialLevel, false);
+      replaceLoggingMethods.call(self);
     }
 
     /*
@@ -254,15 +306,14 @@ var loglevel = {
      *
      */
 
-    var defaultLogger = new Logger();
-    var _loggersByName = {};
+    defaultLogger = new Logger();
     defaultLogger.getLogger = function getLogger(name) {
       if (typeof name !== "symbol" && typeof name !== "string" || name === "") {
         throw new TypeError("You must supply a name when creating a logger.");
       }
       var logger = _loggersByName[name];
       if (!logger) {
-        logger = _loggersByName[name] = new Logger(name, defaultLogger.getLevel(), defaultLogger.methodFactory);
+        logger = _loggersByName[name] = new Logger(name, defaultLogger.methodFactory);
       }
       return logger;
     };
@@ -348,7 +399,8 @@ const commands = {
   nativeShare: 'nativeShareDialog',
   langInfos: 'getLanguageInfos',
   branchDefaultLang: 'getBranchDefaultLanguage',
-  prefContentLang: 'getPreferredContentLocale'
+  prefContentLang: 'getPreferredContentLocale',
+  userContentLocale: 'getUserContentLocale'
 };
 
 /**
@@ -446,6 +498,12 @@ var locales = {
     name: 'English',
     localizedName: 'English'
   },
+  enGB: {
+    key: 'enGB',
+    locale: 'en_GB',
+    name: 'English (United Kingdom)',
+    localizedName: 'English (United Kingdom)'
+  },
   es: {
     key: 'es',
     locale: 'es_ES',
@@ -937,6 +995,16 @@ const getPreferredContentLocale$2 = content => {
   }
 };
 
+/**
+ * Get the current user's content locale, fallback to branch default locale
+ *
+ * @return {String} the user's content locale
+ */
+const getUserContentLocale$2 = () => {
+  const locale = getBranchDefaultLanguage$2().locale;
+  return locale;
+};
+
 let connection$1 = null;
 const fallbackKickIn = 500;
 
@@ -947,7 +1015,7 @@ const fallbackKickIn = 500;
  * after the time specified in fallbackKickIn runs out.
  * @return {Promise<function>} An appropriate send function
  */
-var fallback = (() => {
+var fallback = () => {
   if (connection$1) {
     return connection$1;
   }
@@ -957,7 +1025,7 @@ var fallback = (() => {
     }, fallbackKickIn);
   });
   return connection$1;
-});
+};
 
 /**
  * Send a SDK command to the Staffbase App.
@@ -991,6 +1059,8 @@ const sendMessage$2 = async function (cmd) {
       return getBranchDefaultLanguage$2();
     case commands.prefContentLang:
       return getPreferredContentLocale$2.apply(null, payload);
+    case commands.userContentLocale:
+      return getUserContentLocale$2();
     case commands.nativeUpload:
     case commands.nativeShare:
       return unSupported();
@@ -1013,7 +1083,6 @@ var protocol = {
   // send this to call a function in the frontend
   ERROR: 'ERROR' // receive this when something goes wrong
 };
-
 const invocationMapping = {
   [commands.openLink]: 'openLink',
   [commands.nativeUpload]: 'nativeFileUpload',
@@ -1449,6 +1518,15 @@ const getPreferredContentLocale$1 = async content => {
   return sendMessage(commands.prefContentLang, content);
 };
 
+/**
+ * Get the default content language configured for the branch.
+ *
+ * @return {Promise<Object>}
+ */
+const getUserContentLocale$1 = async () => {
+  return sendMessage(commands.langInfos).then(res => res.userContentLocale);
+};
+
 /**
  * Compare [semver](https://semver.org/) version strings to find greater, equal or lesser.
  * This library supports the full semver specification, including comparing versions with different number of digits like `1.0.0`, `1.0`, `1`, and pre-release versions like `1.0.0-alpha`.
@@ -1655,6 +1733,13 @@ const getContentLanguages = async () => getContentLanguages$1();
  */
 const getPreferredContentLocale = async content => getPreferredContentLocale$1(content);
 
+/**
+ * Get the current user's content locale, fallback to branch default locale
+ * @function
+ * @return {Promise<any>}
+ */
+const getUserContentLocale = async () => getUserContentLocale$1();
+
 /**
  * Open a share dialog on native devices
  *
@@ -1679,6 +1764,7 @@ exports.getBranchDefaultLanguage = getBranchDefaultLanguage;
 exports.getBranchLanguages = getBranchLanguages;
 exports.getContentLanguages = getContentLanguages;
 exports.getPreferredContentLocale = getPreferredContentLocale;
+exports.getUserContentLocale = getUserContentLocale;
 exports.isAndroidDevice = isAndroidDevice;
 exports.isIosDevice = isIosDevice;
 exports.isMobileApp = isMobileApp;