@servicetitan/docs-uikit 33.0.1 → 33.1.1

package/docs/ajax-handlers/ajax-handlers.mdx

@@ -8,5 +8,6 @@ title: AJAX Handlers
 
 ## API
 
-- [withMicroservice](./with-microservice.mdx) - Use `withMicroservice` to wrap components and authenticate requests to protected resources with support for Bearer and Token Server authentication.
-- [initAjaxHandlersParseDates](./init-ajax-handlers-parse-dates.mdx) - Use `initAjaxHandlersParseDates` to automatically transform date strings in axios responses into JavaScript Date objects.
+- [withMicroservice](./with-microservice.mdx) - Use to wrap components and authenticate requests to protected resources with support for Bearer and Token Server authentication.
+- [initAjaxHandlersLoginRequired](./init-ajax-handlers-login-required.mdx) - Use to register handler for invalid TokenServer session.
+- [initAjaxHandlersParseDates](./init-ajax-handlers-parse-dates.mdx) - Use to automatically transform date strings in axios responses into JavaScript Date objects.

package/docs/ajax-handlers/init-ajax-handlers-login-required.mdx

@@ -0,0 +1,23 @@
+---
+title: initAjaxHandlersLoginRequired
+---
+
+`initAjaxHandlersLoginRequired` registers a function that handles when a TokenServer session is not valid and the current application session must be terminated and the user forced to login again.
+
+It sometimes happens that a user's application session is active but their authentication cookie on the TokenServer domain is missing, due to manual deletion, browser cleanup, etc. When this occurs, the TokenServer silent login fails and, because the main application session is active, reloading the page doesn't force the user to (re)login and get a valid TokenServer cookie.
+
+Use `initAjaxHandlersLoginRequired` to detect when this happens and force the user to login again.
+
+## Usage
+
+Call this function once in your application's initialization code, before loading any MFEs.
+
+```tsx
+import { initAjaxHandlersLoginRequired } from '@servicetitan/ajax-handlers';
+
+// Register handler for "login required" scenario
+
+initAjaxHandlersLoginRequired(() => {
+    window.location.assign('/#/Auth/Logout');
+});
+```

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicetitan/docs-uikit",
-    "version": "33.0.1",
+    "version": "33.1.1",
     "description": "",
     "repository": {
         "type": "git",
@@ -16,5 +16,5 @@
     "cli": {
         "webpack": false
     },
-    "gitHead": "6a140ed15688cc4915d3d0e52000c2f8c1f381ca"
+    "gitHead": "36ff4078b07d6c86bdf968b7f8b3c0adbe03fd4c"
 }