@bytescale/sdk 3.43.0 → 3.44.0

package/dist/browser/cjs/main.js

@@ -3084,6 +3084,14 @@ function Scheduler_createClass(Constructor, protoProps, staticProps) { if (proto
 function Scheduler_toPropertyKey(t) { var i = Scheduler_toPrimitive(t, "string"); return "symbol" == Scheduler_typeof(i) ? i : i + ""; }
 function Scheduler_toPrimitive(t, r) { if ("object" != Scheduler_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != Scheduler_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 
+/**
+ * -------------------------
+ * Q: Why not use 'setTimeout'?
+ * -------------------------
+ * A: setTimeout can be paused (e.g., during hibernation), risking JWT expiration before it triggers.
+ *    We therefore use a scheduler to check wall-clock time every second and execute the callback at the scheduled time.
+ * -------------------------
+ */
 var Scheduler = /*#__PURE__*/function () {
   function Scheduler() {
     Scheduler_classCallCheck(this, Scheduler);
@@ -3381,6 +3389,8 @@ var AuthManagerImpl = /*#__PURE__*/function () {
               ConsoleUtils.warn("Unable to refresh JWT access token: ".concat(e));
             });
           }, function (_wasThrown, _result) {
+            // 'setTimeout' can be paused (e.g., during hibernation), risking JWT expiration before it triggers. We use a
+            // scheduler to check wall-clock time every second and execute the callback at the scheduled time (below).
             session.accessTokenRefreshHandle = _this3.scheduler.schedule(expires, function () {
               _this3.refreshAccessToken(session).then(function () {},
               // Should not occur, as this method shouldn't throw errors.

package/dist/browser/esm/main.mjs

@@ -3069,6 +3069,14 @@ function Scheduler_createClass(Constructor, protoProps, staticProps) { if (proto
 function Scheduler_toPropertyKey(t) { var i = Scheduler_toPrimitive(t, "string"); return "symbol" == Scheduler_typeof(i) ? i : i + ""; }
 function Scheduler_toPrimitive(t, r) { if ("object" != Scheduler_typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != Scheduler_typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 
+/**
+ * -------------------------
+ * Q: Why not use 'setTimeout'?
+ * -------------------------
+ * A: setTimeout can be paused (e.g., during hibernation), risking JWT expiration before it triggers.
+ *    We therefore use a scheduler to check wall-clock time every second and execute the callback at the scheduled time.
+ * -------------------------
+ */
 var Scheduler = /*#__PURE__*/function () {
   function Scheduler() {
     Scheduler_classCallCheck(this, Scheduler);
@@ -3366,6 +3374,8 @@ var AuthManagerImpl = /*#__PURE__*/function () {
               ConsoleUtils.warn("Unable to refresh JWT access token: ".concat(e));
             });
           }, function (_wasThrown, _result) {
+            // 'setTimeout' can be paused (e.g., during hibernation), risking JWT expiration before it triggers. We use a
+            // scheduler to check wall-clock time every second and execute the callback at the scheduled time (below).
             session.accessTokenRefreshHandle = _this3.scheduler.schedule(expires, function () {
               _this3.refreshAccessToken(session).then(function () {},
               // Should not occur, as this method shouldn't throw errors.

package/dist/types/private/Scheduler.d.ts

@@ -1,3 +1,11 @@
+/**
+ * -------------------------
+ * Q: Why not use 'setTimeout'?
+ * -------------------------
+ * A: setTimeout can be paused (e.g., during hibernation), risking JWT expiration before it triggers.
+ *    We therefore use a scheduler to check wall-clock time every second and execute the callback at the scheduled time.
+ * -------------------------
+ */
 export declare class Scheduler {
     private callbacks;
     private nextId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytescale/sdk",
-  "version": "3.43.0",
+  "version": "3.44.0",
   "description": "Bytescale JavaScript SDK",
   "author": "Bytescale <hello@bytescale.com> (https://www.bytescale.com)",
   "license": "MIT",