@ada-support/web-storage 1.4.8 → 1.5.1

package/dist/ada-web-storage-list.html

@@ -41,6 +41,12 @@ border: 1px solid;
 <td>Session (as long as the browser application is open)</td>
 </tr>
 <tr>
+<td>__Host-ada-session-[session ID]-[generation]</td>
+<td>Stores the rotating session refresh credential in a server-set HttpOnly cookie. Used to authenticate the visitor's generative chat session with Ada. Set on the bot's Ada subdomain.</td>
+<td>Cookie (essential, security)</td>
+<td>Session (up to 7 days)</td>
+</tr>
+<tr>
 <td>__Secure-[alphanumeric ID]</td>
 <td>Used by Youtube to deliver relevant advertisements</td>
 <td>Cookie (marketing)</td>
@@ -233,6 +239,12 @@ border: 1px solid;
 <td>Persistent</td>
 </tr>
 <tr>
+<td>liveChatTransition</td>
+<td>Records when the live-agent connection state above last changed, so another Ada product on the same domain can tell a current handoff from a stale flag.</td>
+<td>Web Storage (functional)</td>
+<td>Persistent</td>
+</tr>
+<tr>
 <td>messagingAuthState</td>
 <td>Stores the messaging authentication state (its owner chatter, a short-lived messaging access token and expiry, a rotating session refresh token, and a refresh counter) used to authenticate the visitor's generative chat session with Ada. Set on the bot's Ada subdomain.</td>
 <td>Web Storage (functional)</td>

package/dist/storage-keys.d.ts

@@ -11,6 +11,15 @@ export interface MessagingAuthState {
     sessionRefreshToken: string;
     refreshGeneration: number;
 }
+/**
+ * When the live-chat pair (`inLiveChat`/`liveChatPending`) last changed, and to what.
+ * Named for the same reason as `MessagingAuthState` above — `generate-html.ts` truncates
+ * an inline object value at its first `}`.
+ */
+export interface LiveChatTransition {
+    open: boolean;
+    at: number;
+}
 /**
  * IMPORTANT
  * You most likely don't need to modify anything here.
@@ -54,6 +63,8 @@ export interface StorageValueByKey {
     inLiveChat: boolean;
     /** Indicates whether user is waiting to connect to a live agent. */
     liveChatPending: boolean;
+    /** Records when the live-agent connection state above last changed, so another Ada product on the same domain can tell a current handoff from a stale flag. */
+    liveChatTransition: LiveChatTransition;
     /** Used to implement Chat reconnection after an interruption. */
     netDisruptionMsgStartTime: number;
     /** Stores Chat iFrame parent window origin. */

package/dist/third-party-items.d.ts

@@ -6,8 +6,9 @@ interface WebStorageItem {
     duration: string;
 }
 /**
- * This is the list of third party cookies and local storage items that we don't use directly,
- * but must include in the list: https://static.ada.support/ada-web-storage-list.html
+ * Manually listed cookies and local storage items for the disclosure list:
+ * https://static.ada.support/ada-web-storage-list.html
+ * Includes Ada-set cookies and third-party items outside this package's Web Storage API.
  */
 export declare const THIRD_PARTY_ITEMS: WebStorageItem[];
 export {};

package/dist/third-party-items.js

@@ -2,10 +2,18 @@
 exports.__esModule = true;
 exports.THIRD_PARTY_ITEMS = void 0;
 /**
- * This is the list of third party cookies and local storage items that we don't use directly,
- * but must include in the list: https://static.ada.support/ada-web-storage-list.html
+ * Manually listed cookies and local storage items for the disclosure list:
+ * https://static.ada.support/ada-web-storage-list.html
+ * Includes Ada-set cookies and third-party items outside this package's Web Storage API.
  */
 exports.THIRD_PARTY_ITEMS = [
+    {
+        keyName: "__Host-ada-session-[session ID]-[generation]",
+        description: "Stores the rotating session refresh credential in a server-set HttpOnly cookie. Used to authenticate the visitor's generative chat session with Ada. Set on the bot's Ada subdomain.",
+        type: "Cookie",
+        duration: "Session (up to 7 days)",
+        purpose: ["Essential", "Security"]
+    },
     {
         keyName: "vuid",
         description: "Used by Vimeo to store the user’s usage history (loaded only if a video has been included).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ada-support/web-storage",
-  "version": "1.4.8",
+  "version": "1.5.1",
   "description": "A package to provide access to Web Storage API",
   "main": "dist/index.js",
   "publishConfig": {

package/src/storage-keys.ts

@@ -13,6 +13,16 @@ export interface MessagingAuthState {
 	refreshGeneration: number;
 }
 
+/**
+ * When the live-chat pair (`inLiveChat`/`liveChatPending`) last changed, and to what.
+ * Named for the same reason as `MessagingAuthState` above — `generate-html.ts` truncates
+ * an inline object value at its first `}`.
+ */
+export interface LiveChatTransition {
+	open: boolean;
+	at: number;
+}
+
 /**
  * IMPORTANT
  * You most likely don't need to modify anything here.
@@ -72,6 +82,9 @@ export interface StorageValueByKey {
 	/** Indicates whether user is waiting to connect to a live agent. */
 	liveChatPending: boolean;
 
+	/** Records when the live-agent connection state above last changed, so another Ada product on the same domain can tell a current handoff from a stale flag. */
+	liveChatTransition: LiveChatTransition;
+
 	/** Used to implement Chat reconnection after an interruption. */
 	netDisruptionMsgStartTime: number;
 

package/src/third-party-items.ts

@@ -9,10 +9,19 @@ interface WebStorageItem {
 }
 
 /**
- * This is the list of third party cookies and local storage items that we don't use directly,
- * but must include in the list: https://static.ada.support/ada-web-storage-list.html
+ * Manually listed cookies and local storage items for the disclosure list:
+ * https://static.ada.support/ada-web-storage-list.html
+ * Includes Ada-set cookies and third-party items outside this package's Web Storage API.
  */
 export const THIRD_PARTY_ITEMS: WebStorageItem[] = [
+	{
+		keyName: "__Host-ada-session-[session ID]-[generation]",
+		description:
+			"Stores the rotating session refresh credential in a server-set HttpOnly cookie. Used to authenticate the visitor's generative chat session with Ada. Set on the bot's Ada subdomain.",
+		type: "Cookie",
+		duration: "Session (up to 7 days)",
+		purpose: ["Essential", "Security"],
+	},
 	{
 		keyName: "vuid",
 		description: