@auxilium/datalynk-client 1.5.2 → 1.6.0

package/dist/index.cjs

@@ -3106,6 +3106,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
       // [ Callback, Re-subscribe ]
       __publicField(this, "retry");
       __publicField(this, "socket");
+      __publicField(this, "connectGeneration", 0);
       __publicField(this, "open", false);
       this.api = api;
       this.options = options;
@@ -3114,7 +3115,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
         this.options.url = origin.replace("http", "ws").replace(/:\d+/g, "") + `/s/`;
       }
       if (this.options.url !== false)
-        api.token$.pipe(filter((u) => u !== void 0), distinctUntilChanged()).subscribe(() => this.connect());
+        api.token$.pipe(filter((u) => u !== void 0), distinctUntilChanged()).subscribe(() => void this.connect());
     }
     /**
      * Add listener for all socket events
@@ -3136,6 +3137,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
      */
     close() {
       var _a;
+      if (this.options.authentication === "ticket") this.connectGeneration++;
       if (this.open) console.debug("Datalynk socket: disconnected");
       this.open = false;
       (_a = this.socket) == null ? void 0 : _a.close();
@@ -3148,6 +3150,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
      * @param {number} timeout Retry to connect every x seconds
      */
     connect(timeout = 30) {
+      if (this.options.authentication === "ticket") return this.connectWithTicket(timeout);
       if (this.options.url === false) return console.warn("Datalynk socket disabled");
       if (this.open) this.close();
       this.retry = setTimeout(() => {
@@ -3177,6 +3180,80 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
         };
       }
     }
+    /**
+     * Ticket-authenticated connection path, used only once a chat-capable host switches
+     * this instance to `authentication: 'ticket'` (see Api.openChat). Entirely separate
+     * from the token path above so existing non-chat consumers are never affected.
+     */
+    async connectWithTicket(timeout = 30) {
+      var _a;
+      if (this.options.url === false) return console.warn("Datalynk socket disabled");
+      const generation = ++this.connectGeneration;
+      if (this.open || this.socket) {
+        this.open = false;
+        (_a = this.socket) == null ? void 0 : _a.close();
+        this.socket = void 0;
+      }
+      if (this.retry) clearTimeout(this.retry);
+      this.retry = setTimeout(() => {
+        if (this.open || generation !== this.connectGeneration) return;
+        void this.connect(timeout);
+      }, timeout * 1e3);
+      if (!this.api.online || !this.api.token) return;
+      let socketUrl = this.normalizeUrl(String(this.options.url || ""));
+      try {
+        const response = await this.api.request({ "$/chat/socketTicket": {} }, { noOptimize: true });
+        if (generation !== this.connectGeneration) return;
+        if (response == null ? void 0 : response.ticket) socketUrl += `${socketUrl.includes("?") ? "&" : "?"}ticket=${encodeURIComponent(response.ticket)}`;
+        else throw new Error("Missing socket ticket");
+      } catch (_) {
+        if (generation !== this.connectGeneration) return;
+        this.scheduleReconnect(generation, timeout);
+        return;
+      }
+      if (generation !== this.connectGeneration) return;
+      this.socket = new WebSocket(socketUrl);
+      this.socket.onopen = () => void 0;
+      this.socket.onclose = () => {
+        this.open = false;
+        this.socket = void 0;
+        this.scheduleReconnect(generation, timeout);
+      };
+      this.socket.onerror = () => {
+      };
+      this.socket.onmessage = (message) => {
+        var _a2;
+        let payload;
+        try {
+          payload = JSON.parse(message.data);
+        } catch {
+          return;
+        }
+        if (payload.connected != void 0) {
+          if (payload.connected) {
+            this.open = true;
+            if (this.retry) clearTimeout(this.retry);
+            this.retry = null;
+            console.debug("Datalynk socket: connected");
+            this.listeners.forEach((l) => l[1]());
+          } else {
+            this.open = false;
+            console.warn(`Datalynk socket failed: ${payload.error || "authentication failed"}`);
+            (_a2 = this.socket) == null ? void 0 : _a2.close();
+          }
+        } else {
+          this.listeners.forEach((l) => l[0](payload));
+        }
+      };
+    }
+    scheduleReconnect(generation, timeout) {
+      if (generation !== this.connectGeneration || this.options.url === false) return;
+      if (this.retry) clearTimeout(this.retry);
+      this.retry = setTimeout(() => {
+        if (generation !== this.connectGeneration) return;
+        void this.connect(timeout);
+      }, timeout * 1e3);
+    }
     /**
      * Send data to socket server
      *
@@ -3203,6 +3280,17 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
         unsubscribe();
       };
     }
+    normalizeUrl(value) {
+      let url = value.replace(/^http:\/\//i, "ws://").replace(/^https:\/\//i, "wss://");
+      try {
+        const parsed = new URL(url);
+        if (parsed.pathname === "/" || parsed.pathname === "") parsed.pathname = "/s/";
+        else if (parsed.pathname === "/s") parsed.pathname = "/s/";
+        url = parsed.toString();
+      } catch {
+      }
+      return url;
+    }
   }
   class Superuser {
     constructor(api) {
@@ -3234,7 +3322,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
       } });
     }
   }
-  const version = "1.5.2";
+  const version = "1.6.0";
   class WebRtc {
     constructor(api) {
       __publicField(this, "ice");
@@ -3801,6 +3889,10 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
       __publicField(this, "tokenStorageListener", null);
       /** Pending requests cache */
       __publicField(this, "pending", {});
+      __publicField(this, "chatModulePromise", null);
+      __publicField(this, "chatInstance", null);
+      __publicField(this, "chatLauncherHost", null);
+      __publicField(this, "chatLauncherButton", null);
       /** Helpers */
       /** Authentication */
       __publicField(this, "auth");
@@ -3855,6 +3947,8 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
         offline: [],
         origin: typeof location !== "undefined" ? location.host : "Unknown",
         saveSession: true,
+        manageSession: true,
+        chat: false,
         replayOfflineQueue: true,
         watchTokenExpiry: true,
         serviceWorker: "/service.worker.mjs",
@@ -3886,9 +3980,9 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
           window.addEventListener("storage", this.tokenStorageListener);
         }
       }
-      if (this.options.watchTokenExpiry)
+      if (this.options.manageSession !== false && this.options.watchTokenExpiry)
         this.token$.pipe(distinctUntilChanged()).subscribe((token) => this.scheduleTokenExpiry(token));
-      this.socket = new Socket(this, { url: options.socket });
+      this.socket = new Socket(this, { url: options.socket, authentication: options.socketAuthentication, realm: options.socketRealm });
       this.gps = new Gps(this, options.gps);
       this.auth = new Auth(this);
       this.files = new Files(this);
@@ -3929,6 +4023,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
           })();
         }
       }
+      this.setupChatLauncher();
     }
     /** Is token expired */
     get expired() {
@@ -4000,7 +4095,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
       var _a;
       if (this.recovery && token !== this.recovery.token)
         this.cancelRecovery(errorFromCode(401, "Session changed during API recovery"));
-      if (token && this.isTokenExpired(token)) {
+      if (this.options.manageSession !== false && token && this.isTokenExpired(token)) {
         if (this.adoptStoredToken(token)) return;
         if (this.shouldDeferLocalExpiry()) {
           this.deferOfflineExpiry(token);
@@ -4018,6 +4113,138 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
       }
       if (token && ((_a = this.options) == null ? void 0 : _a.replayOfflineQueue) !== false) void this.replayPendingQueue();
     }
+    /** Mount the optional launcher without loading or initializing the chat bundle. */
+    setupChatLauncher() {
+      if (!this.options.chat || typeof document === "undefined") return;
+      const mount = () => {
+        if (this.chatLauncherHost || !document.body || document.querySelector("[data-datalynk-chat-launcher]")) return;
+        const host = document.createElement("div");
+        host.setAttribute("data-datalynk-chat-launcher", "");
+        const root = host.attachShadow({ mode: "open" });
+        root.innerHTML = `
+				<style>
+					:host {
+						all: initial;
+						position: fixed;
+						right: 20px;
+						bottom: 20px;
+						z-index: 2147482999;
+						pointer-events: none;
+					}
+					button {
+						display: grid;
+						place-items: center;
+						width: 52px;
+						height: 52px;
+						padding: 0;
+						border: 1px solid #2f596d;
+						border-radius: 50%;
+						background: #3f6f85;
+						color: #fff;
+						box-shadow: 0 4px 14px rgb(15 42 54 / 24%);
+						cursor: pointer;
+						pointer-events: auto;
+						transition: background-color 120ms ease-out, box-shadow 120ms ease-out, transform 120ms ease-out;
+					}
+					button:hover { background: #315d71; box-shadow: 0 6px 18px rgb(15 42 54 / 30%); }
+					button:active { transform: translateY(1px); }
+					button:focus-visible { outline: 3px solid #f2c94c; outline-offset: 3px; }
+					button:disabled { cursor: wait; opacity: .72; }
+					.status {
+						position: absolute;
+						right: 62px;
+						bottom: 7px;
+						width: max-content;
+						max-width: min(260px, calc(100vw - 94px));
+						padding: 9px 11px;
+						border: 1px solid #c6d3d9;
+						border-radius: 6px;
+						background: #fff;
+						box-shadow: 0 3px 12px rgb(15 42 54 / 16%);
+						color: #263942;
+						font: 600 13px/1.35 "Segoe UI", Arial, sans-serif;
+						pointer-events: none;
+					}
+					.status:empty { display: none; }
+					svg { width: 25px; height: 25px; }
+					@media (max-width: 600px) { :host { right: 12px; bottom: 12px; } }
+					@media (prefers-reduced-motion: reduce) { button { transition: none; } }
+				</style>
+				<button type="button" aria-label="Open Datalynk Chat" title="Chat">
+					<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false">
+						<path fill="currentColor" d="M4 4h16a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H9l-5 3v-3a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2Zm2.5 8.25a1.25 1.25 0 1 0 0-2.5 1.25 1.25 0 0 0 0 2.5Zm5.5 0a1.25 1.25 0 1 0 0-2.5 1.25 1.25 0 0 0 0 2.5Zm5.5 0a1.25 1.25 0 1 0 0-2.5 1.25 1.25 0 0 0 0 2.5Z"/>
+					</svg>
+				</button>
+				<span class="status" role="status" aria-live="polite"></span>`;
+        const button = root.querySelector("button");
+        button.addEventListener("click", () => void this.openChatFromLauncher());
+        document.body.appendChild(host);
+        this.chatLauncherHost = host;
+        this.chatLauncherButton = button;
+      };
+      if (document.body) mount();
+      else document.addEventListener("DOMContentLoaded", mount, { once: true });
+    }
+    async openChatFromLauncher() {
+      const button = this.chatLauncherButton;
+      if (!button) return;
+      const status = button.getRootNode().querySelector(".status");
+      button.disabled = true;
+      button.setAttribute("aria-busy", "true");
+      status.textContent = "Opening chat…";
+      try {
+        await this.openChat();
+        status.textContent = "";
+      } catch (error) {
+        button.disabled = false;
+        button.removeAttribute("aria-busy");
+        status.textContent = "Chat is unavailable for this session.";
+        console.error("Unable to open Datalynk Chat.", error);
+      }
+    }
+    restoreChatLauncher() {
+      if (!this.chatLauncherHost || !this.chatLauncherButton) return;
+      this.chatLauncherHost.hidden = false;
+      this.chatLauncherButton.disabled = false;
+      this.chatLauncherButton.removeAttribute("aria-busy");
+      this.chatLauncherButton.focus();
+    }
+    /** Lazily load and construct chat. No chat code or requests run before this call. */
+    async chat() {
+      if (this.chatInstance) return this.chatInstance;
+      const client = await this.loadChatModule();
+      return this.chatInstance || (this.chatInstance = new client.Chat(this));
+    }
+    /** Lazily load, authorize, and open the reusable chat window. */
+    async openChat(options = {}) {
+      const client = await this.loadChatModule();
+      const chat = await this.chat();
+      if (!await chat.available()) throw new Error("Chat is disabled or this session is not authorized.");
+      if (this.socket.options.authentication !== "ticket") {
+        this.socket.options.authentication = "ticket";
+        void this.socket.connect();
+      }
+      const onClose = options.onClose;
+      const chatWindow = client.openChat(chat, {
+        ...options,
+        onClose: () => {
+          this.restoreChatLauncher();
+          onClose == null ? void 0 : onClose();
+        }
+      });
+      if (this.chatLauncherHost) this.chatLauncherHost.hidden = true;
+      return chatWindow;
+    }
+    loadChatModule() {
+      if (!this.chatModulePromise) {
+        const moduleUrl = this.options.chatModule || "./chat.mjs";
+        this.chatModulePromise = import(
+          /* @vite-ignore */
+          moduleUrl
+        );
+      }
+      return this.chatModulePromise;
+    }
     async _request(req, options = {}) {
       if (this.recovery) throw errorFromCode(503, "Datalynk is unavailable");
       const retryRequest = deepCopy(req);
@@ -4034,7 +4261,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
     /** Execute exactly one HTTP API attempt. Recovery uses this directly to avoid recursive retry loops. */
     async _requestOnce(req, options = {}, recoveryAttempt = false) {
       const token = options.token || this.token;
-      if (token && this.isTokenExpired(token)) {
+      if (this.options.manageSession !== false && token && this.isTokenExpired(token)) {
         if (token === this.token) this.expireToken(token);
         throw errorFromCode(401, "Session token expired");
       }
@@ -4201,7 +4428,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
         }
         return;
       }
-      if (this.token && this.isTokenExpired(this.token)) {
+      if (this.options.manageSession !== false && this.token && this.isTokenExpired(this.token)) {
         this.expireToken(this.token);
         return;
       }
@@ -4320,6 +4547,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
     }
     async finishUnauthorizedLogout(preservePending = false) {
       var _a;
+      if (this.options.manageSession === false) return;
       if (typeof localStorage != "undefined") {
         localStorage.removeItem(this.localStorageKey);
         localStorage.removeItem("datalynk-user");