@sanity/client 6.22.1 → 6.22.2-canary.1

package/dist/index.browser.d.cts

@@ -919,10 +919,17 @@ export declare class LiveClient {
    */
   events({
     includeDrafts,
+    tag: _tag,
   }?: {
     /** @alpha this API is experimental and may change or even be removed */
     includeDrafts?: boolean
-  }): Observable<LiveEventMessage | LiveEventRestart>
+    /**
+     * Optional request tag for the listener. Use to identify the request in logs.
+     *
+     * @defaultValue `undefined`
+     */
+    tag?: string
+  }): Observable<LiveEventMessage | LiveEventRestart | LiveEventReconnect | LiveEventWelcome>
 }
 
 /** @public */
@@ -932,9 +939,20 @@ export declare interface LiveEventMessage {
   tags: SyncTag[]
 }
 
+/** @public */
+export declare interface LiveEventReconnect {
+  type: 'reconnect'
+}
+
 /** @public */
 export declare interface LiveEventRestart {
   type: 'restart'
+  id: string
+}
+
+/** @public */
+export declare interface LiveEventWelcome {
+  type: 'welcome'
 }
 
 /** @public */

package/dist/index.browser.d.ts

@@ -919,10 +919,17 @@ export declare class LiveClient {
    */
   events({
     includeDrafts,
+    tag: _tag,
   }?: {
     /** @alpha this API is experimental and may change or even be removed */
     includeDrafts?: boolean
-  }): Observable<LiveEventMessage | LiveEventRestart>
+    /**
+     * Optional request tag for the listener. Use to identify the request in logs.
+     *
+     * @defaultValue `undefined`
+     */
+    tag?: string
+  }): Observable<LiveEventMessage | LiveEventRestart | LiveEventReconnect | LiveEventWelcome>
 }
 
 /** @public */
@@ -932,9 +939,20 @@ export declare interface LiveEventMessage {
   tags: SyncTag[]
 }
 
+/** @public */
+export declare interface LiveEventReconnect {
+  type: 'reconnect'
+}
+
 /** @public */
 export declare interface LiveEventRestart {
   type: 'restart'
+  id: string
+}
+
+/** @public */
+export declare interface LiveEventWelcome {
+  type: 'welcome'
 }
 
 /** @public */

package/dist/index.browser.js

@@ -927,27 +927,33 @@ class LiveClient {
    * Requires `apiVersion` to be `2021-03-26` or later.
    */
   events({
-    includeDrafts = !1
+    includeDrafts = !1,
+    tag: _tag
   } = {}) {
-    const { apiVersion: _apiVersion, token } = this.#client.config(), apiVersion = _apiVersion.replace(/^v/, "");
+    const {
+      apiVersion: _apiVersion,
+      token,
+      withCredentials,
+      requestTagPrefix
+    } = this.#client.config(), apiVersion = _apiVersion.replace(/^v/, "");
     if (apiVersion !== "X" && apiVersion < requiredApiVersion)
       throw new Error(
         `The live events API requires API version ${requiredApiVersion} or later. The current API version is ${apiVersion}. Please update your API version to use this feature.`
       );
-    if (includeDrafts && !token)
+    if (includeDrafts && !token && !withCredentials)
       throw new Error(
-        "The live events API requires a token when 'includeDrafts: true'. Please update your client configuration. The token should have the lowest possible access role."
+        "The live events API requires a token or withCredentials when 'includeDrafts: true'. Please update your client configuration. The token should have the lowest possible access role."
       );
     if (includeDrafts && apiVersion !== "X")
       throw new Error(
         "The live events API requires API version X when 'includeDrafts: true'. This API is experimental and may change or even be removed."
       );
-    const path = _getDataUrl(this.#client, "live/events"), url = new URL(this.#client.getUrl(path, !1));
-    includeDrafts && url.searchParams.set("includeDrafts", "true");
-    const listenFor = ["restart", "message"], esOptions = {};
+    const path = _getDataUrl(this.#client, "live/events"), url = new URL(this.#client.getUrl(path, !1)), tag = _tag && requestTagPrefix ? [requestTagPrefix, _tag].join(".") : _tag;
+    tag && url.searchParams.set("tag", tag), includeDrafts && url.searchParams.set("includeDrafts", "true");
+    const listenFor = ["restart", "message", "welcome", "reconnect"], esOptions = {};
     return includeDrafts && token && (esOptions.headers = {
       Authorization: `Bearer ${token}`
-    }), new Observable((observer) => {
+    }), includeDrafts && withCredentials && (esOptions.withCredentials = !0), new Observable((observer) => {
       let es, reconnectTimer, stopped = !1, unsubscribed = !1;
       open();
       function onError(evt) {
@@ -972,7 +978,7 @@ class LiveClient {
         }
       }
       async function getEventSource() {
-        const EventSourceImplementation = typeof EventSource > "u" || esOptions.headers ? (await import("@sanity/eventsource")).default : EventSource;
+        const EventSourceImplementation = typeof EventSource > "u" || esOptions.headers || esOptions.withCredentials ? (await import("@sanity/eventsource")).default : EventSource;
         if (unsubscribed)
           return;
         const evs = new EventSourceImplementation(url.toString(), esOptions);