@sanity/client 6.24.3 → 6.24.4

package/dist/stega.browser.d.cts

@@ -305,6 +305,16 @@ export declare class BaseTransaction {
   protected _add(mut: Mutation): this
 }
 
+/**
+ * @public
+ * The server sent a `channelError` message. Usually indicative of a bad or malformed request
+ */
+export declare class ChannelError extends Error {
+  readonly name = 'ChannelError'
+  readonly data?: unknown
+  constructor(message: string, data: unknown)
+}
+
 /**
  * An error occurred. This is different from a network-level error (which will be emitted as 'error').
  * Possible causes are things such as malformed filters, non-existant datasets or similar.
@@ -403,6 +413,39 @@ export declare type ClientReturn<
  */
 export declare interface ClientStegaConfig extends ClientConfig {}
 
+/**
+ * Sanity API specific EventSource handler shared between the listen and live APIs
+ *
+ * Since the `EventSource` API is not provided by all environments, this function enables custom initialization of the EventSource instance
+ * for runtimes that requires polyfilling or custom setup logic (e.g. custom HTTP headers)
+ * via the passed `initEventSource` function which must return an EventSource instance.
+ *
+ * Possible errors to be thrown on the returned observable are:
+ * - {@link MessageError}
+ * - {@link MessageParseError}
+ * - {@link ChannelError}
+ * - {@link DisconnectError}
+ * - {@link ConnectionFailedError}
+ *
+ * @param initEventSource - A function that returns an EventSource instance or an Observable that resolves to an EventSource instance
+ * @param events - an array of named events from the API to listen for.
+ *
+ * @internal
+ */
+export declare function connectEventSource<EventName extends string>(
+  initEventSource: () => EventSourceInstance | Observable<EventSourceInstance>,
+  events: EventName[],
+): Observable<ServerSentEvent<EventName>>
+
+/**
+ * @public
+ * Thrown if the EventSource connection could not be established.
+ * Note that ConnectionFailedErrors are rare, and disconnects will normally be handled by the EventSource instance itself and emitted as `reconnect` events.
+ */
+export declare class ConnectionFailedError extends Error {
+  readonly name = 'ConnectionFailedError'
+}
+
 /** @public */
 export declare interface ContentSourceMap {
   mappings: ContentSourceMapMappings
@@ -734,6 +777,18 @@ export declare type DiscardAction = {
   purge?: boolean
 }
 
+/**
+ * The listener has been told to explicitly disconnect.
+ *  This is a rare situation, but may occur if the API knows reconnect attempts will fail,
+ *  eg in the case of a deleted dataset, a blocked project or similar events.
+ * @public
+ */
+export declare class DisconnectError extends Error {
+  readonly name = 'DisconnectError'
+  readonly reason?: string
+  constructor(message: string, reason?: string, options?: ErrorOptions)
+}
+
 /**
  * The listener has been told to explicitly disconnect and not reconnect.
  * This is a rare situation, but may occur if the API knows reconnect attempts will fail,
@@ -799,6 +854,16 @@ export declare interface ErrorProps {
   details: Any
 }
 
+/**
+ * @internal
+ */
+export declare type EventSourceEvent<Name extends string> = ServerSentEvent<Name>
+
+/**
+ * @internal
+ */
+export declare type EventSourceInstance = InstanceType<typeof globalThis.EventSource>
+
 /** @public */
 export declare type FilterDefault = (props: {
   /**
@@ -1020,6 +1085,7 @@ export declare type ListenEvent<R extends Record<string, Any>> =
   | DisconnectEvent
   | ReconnectEvent
   | WelcomeEvent
+  | OpenEvent
 
 /** @public */
 export declare type ListenEventName =
@@ -1151,6 +1217,24 @@ declare type Logger_2 =
       Pick<typeof console, 'debug' | 'error' | 'groupCollapsed' | 'groupEnd' | 'log' | 'table'>
     >
 
+/**
+ * @public
+ * The server sent an `error`-event to tell the client that an unexpected error has happened.
+ */
+export declare class MessageError extends Error {
+  readonly name = 'MessageError'
+  readonly data?: unknown
+  constructor(message: string, data: unknown, options?: ErrorOptions)
+}
+
+/**
+ * @public
+ * An error occurred while parsing the message sent by the server as JSON. Should normally not happen.
+ */
+export declare class MessageParseError extends Error {
+  readonly name = 'MessageParseError'
+}
+
 /** @internal */
 export declare interface MultipleActionResult {
   transactionId: string
@@ -2068,6 +2152,15 @@ export declare class ObservableUsersClient {
   ): Observable<T extends 'me' ? CurrentSanityUser : SanityUser>
 }
 
+/**
+ * The listener connection has been established
+ * note: it's usually a better option to use the 'welcome' event
+ * @public
+ */
+export declare type OpenEvent = {
+  type: 'open'
+}
+
 /** @public */
 export declare class Patch extends BasePatch {
   #private
@@ -3066,6 +3159,15 @@ export declare class ServerError extends Error {
   constructor(res: Any)
 }
 
+/**
+ * @public
+ */
+export declare interface ServerSentEvent<Name extends string> {
+  type: Name
+  id?: string
+  data?: unknown
+}
+
 /** @internal */
 export declare interface SingleActionResult {
   transactionId: string
@@ -3236,6 +3338,13 @@ export declare class Transaction extends BaseTransaction {
    * @param patchOps - Operations to perform, or a builder function
    */
   patch(documentId: string, patchOps?: PatchBuilder | PatchOperations): this
+  /**
+   * Performs a patch on the given selection. Can either be a builder function or an object of patch operations.
+   *
+   * @param selection - An object with `query` and optional `params`, defining which document(s) to patch
+   * @param patchOps - Operations to perform, or a builder function
+   */
+  patch(patch: MutationSelection, patchOps?: PatchBuilder | PatchOperations): this
   /**
    * Adds the given patch instance to the transaction.
    * The operation is added to the current transaction, ready to be commited by `commit()`

package/dist/stega.browser.d.ts

@@ -305,6 +305,16 @@ export declare class BaseTransaction {
   protected _add(mut: Mutation): this
 }
 
+/**
+ * @public
+ * The server sent a `channelError` message. Usually indicative of a bad or malformed request
+ */
+export declare class ChannelError extends Error {
+  readonly name = 'ChannelError'
+  readonly data?: unknown
+  constructor(message: string, data: unknown)
+}
+
 /**
  * An error occurred. This is different from a network-level error (which will be emitted as 'error').
  * Possible causes are things such as malformed filters, non-existant datasets or similar.
@@ -403,6 +413,39 @@ export declare type ClientReturn<
  */
 export declare interface ClientStegaConfig extends ClientConfig {}
 
+/**
+ * Sanity API specific EventSource handler shared between the listen and live APIs
+ *
+ * Since the `EventSource` API is not provided by all environments, this function enables custom initialization of the EventSource instance
+ * for runtimes that requires polyfilling or custom setup logic (e.g. custom HTTP headers)
+ * via the passed `initEventSource` function which must return an EventSource instance.
+ *
+ * Possible errors to be thrown on the returned observable are:
+ * - {@link MessageError}
+ * - {@link MessageParseError}
+ * - {@link ChannelError}
+ * - {@link DisconnectError}
+ * - {@link ConnectionFailedError}
+ *
+ * @param initEventSource - A function that returns an EventSource instance or an Observable that resolves to an EventSource instance
+ * @param events - an array of named events from the API to listen for.
+ *
+ * @internal
+ */
+export declare function connectEventSource<EventName extends string>(
+  initEventSource: () => EventSourceInstance | Observable<EventSourceInstance>,
+  events: EventName[],
+): Observable<ServerSentEvent<EventName>>
+
+/**
+ * @public
+ * Thrown if the EventSource connection could not be established.
+ * Note that ConnectionFailedErrors are rare, and disconnects will normally be handled by the EventSource instance itself and emitted as `reconnect` events.
+ */
+export declare class ConnectionFailedError extends Error {
+  readonly name = 'ConnectionFailedError'
+}
+
 /** @public */
 export declare interface ContentSourceMap {
   mappings: ContentSourceMapMappings
@@ -734,6 +777,18 @@ export declare type DiscardAction = {
   purge?: boolean
 }
 
+/**
+ * The listener has been told to explicitly disconnect.
+ *  This is a rare situation, but may occur if the API knows reconnect attempts will fail,
+ *  eg in the case of a deleted dataset, a blocked project or similar events.
+ * @public
+ */
+export declare class DisconnectError extends Error {
+  readonly name = 'DisconnectError'
+  readonly reason?: string
+  constructor(message: string, reason?: string, options?: ErrorOptions)
+}
+
 /**
  * The listener has been told to explicitly disconnect and not reconnect.
  * This is a rare situation, but may occur if the API knows reconnect attempts will fail,
@@ -799,6 +854,16 @@ export declare interface ErrorProps {
   details: Any
 }
 
+/**
+ * @internal
+ */
+export declare type EventSourceEvent<Name extends string> = ServerSentEvent<Name>
+
+/**
+ * @internal
+ */
+export declare type EventSourceInstance = InstanceType<typeof globalThis.EventSource>
+
 /** @public */
 export declare type FilterDefault = (props: {
   /**
@@ -1020,6 +1085,7 @@ export declare type ListenEvent<R extends Record<string, Any>> =
   | DisconnectEvent
   | ReconnectEvent
   | WelcomeEvent
+  | OpenEvent
 
 /** @public */
 export declare type ListenEventName =
@@ -1151,6 +1217,24 @@ declare type Logger_2 =
       Pick<typeof console, 'debug' | 'error' | 'groupCollapsed' | 'groupEnd' | 'log' | 'table'>
     >
 
+/**
+ * @public
+ * The server sent an `error`-event to tell the client that an unexpected error has happened.
+ */
+export declare class MessageError extends Error {
+  readonly name = 'MessageError'
+  readonly data?: unknown
+  constructor(message: string, data: unknown, options?: ErrorOptions)
+}
+
+/**
+ * @public
+ * An error occurred while parsing the message sent by the server as JSON. Should normally not happen.
+ */
+export declare class MessageParseError extends Error {
+  readonly name = 'MessageParseError'
+}
+
 /** @internal */
 export declare interface MultipleActionResult {
   transactionId: string
@@ -2068,6 +2152,15 @@ export declare class ObservableUsersClient {
   ): Observable<T extends 'me' ? CurrentSanityUser : SanityUser>
 }
 
+/**
+ * The listener connection has been established
+ * note: it's usually a better option to use the 'welcome' event
+ * @public
+ */
+export declare type OpenEvent = {
+  type: 'open'
+}
+
 /** @public */
 export declare class Patch extends BasePatch {
   #private
@@ -3066,6 +3159,15 @@ export declare class ServerError extends Error {
   constructor(res: Any)
 }
 
+/**
+ * @public
+ */
+export declare interface ServerSentEvent<Name extends string> {
+  type: Name
+  id?: string
+  data?: unknown
+}
+
 /** @internal */
 export declare interface SingleActionResult {
   transactionId: string
@@ -3236,6 +3338,13 @@ export declare class Transaction extends BaseTransaction {
    * @param patchOps - Operations to perform, or a builder function
    */
   patch(documentId: string, patchOps?: PatchBuilder | PatchOperations): this
+  /**
+   * Performs a patch on the given selection. Can either be a builder function or an object of patch operations.
+   *
+   * @param selection - An object with `query` and optional `params`, defining which document(s) to patch
+   * @param patchOps - Operations to perform, or a builder function
+   */
+  patch(patch: MutationSelection, patchOps?: PatchBuilder | PatchOperations): this
   /**
    * Adds the given patch instance to the transaction.
    * The operation is added to the current transaction, ready to be commited by `commit()`

package/dist/stega.d.cts

@@ -305,6 +305,16 @@ export declare class BaseTransaction {
   protected _add(mut: Mutation): this
 }
 
+/**
+ * @public
+ * The server sent a `channelError` message. Usually indicative of a bad or malformed request
+ */
+export declare class ChannelError extends Error {
+  readonly name = 'ChannelError'
+  readonly data?: unknown
+  constructor(message: string, data: unknown)
+}
+
 /**
  * An error occurred. This is different from a network-level error (which will be emitted as 'error').
  * Possible causes are things such as malformed filters, non-existant datasets or similar.
@@ -403,6 +413,39 @@ export declare type ClientReturn<
  */
 export declare interface ClientStegaConfig extends ClientConfig {}
 
+/**
+ * Sanity API specific EventSource handler shared between the listen and live APIs
+ *
+ * Since the `EventSource` API is not provided by all environments, this function enables custom initialization of the EventSource instance
+ * for runtimes that requires polyfilling or custom setup logic (e.g. custom HTTP headers)
+ * via the passed `initEventSource` function which must return an EventSource instance.
+ *
+ * Possible errors to be thrown on the returned observable are:
+ * - {@link MessageError}
+ * - {@link MessageParseError}
+ * - {@link ChannelError}
+ * - {@link DisconnectError}
+ * - {@link ConnectionFailedError}
+ *
+ * @param initEventSource - A function that returns an EventSource instance or an Observable that resolves to an EventSource instance
+ * @param events - an array of named events from the API to listen for.
+ *
+ * @internal
+ */
+export declare function connectEventSource<EventName extends string>(
+  initEventSource: () => EventSourceInstance | Observable<EventSourceInstance>,
+  events: EventName[],
+): Observable<ServerSentEvent<EventName>>
+
+/**
+ * @public
+ * Thrown if the EventSource connection could not be established.
+ * Note that ConnectionFailedErrors are rare, and disconnects will normally be handled by the EventSource instance itself and emitted as `reconnect` events.
+ */
+export declare class ConnectionFailedError extends Error {
+  readonly name = 'ConnectionFailedError'
+}
+
 /** @public */
 export declare interface ContentSourceMap {
   mappings: ContentSourceMapMappings
@@ -734,6 +777,18 @@ export declare type DiscardAction = {
   purge?: boolean
 }
 
+/**
+ * The listener has been told to explicitly disconnect.
+ *  This is a rare situation, but may occur if the API knows reconnect attempts will fail,
+ *  eg in the case of a deleted dataset, a blocked project or similar events.
+ * @public
+ */
+export declare class DisconnectError extends Error {
+  readonly name = 'DisconnectError'
+  readonly reason?: string
+  constructor(message: string, reason?: string, options?: ErrorOptions)
+}
+
 /**
  * The listener has been told to explicitly disconnect and not reconnect.
  * This is a rare situation, but may occur if the API knows reconnect attempts will fail,
@@ -799,6 +854,16 @@ export declare interface ErrorProps {
   details: Any
 }
 
+/**
+ * @internal
+ */
+export declare type EventSourceEvent<Name extends string> = ServerSentEvent<Name>
+
+/**
+ * @internal
+ */
+export declare type EventSourceInstance = InstanceType<typeof globalThis.EventSource>
+
 /** @public */
 export declare type FilterDefault = (props: {
   /**
@@ -1020,6 +1085,7 @@ export declare type ListenEvent<R extends Record<string, Any>> =
   | DisconnectEvent
   | ReconnectEvent
   | WelcomeEvent
+  | OpenEvent
 
 /** @public */
 export declare type ListenEventName =
@@ -1151,6 +1217,24 @@ declare type Logger_2 =
       Pick<typeof console, 'debug' | 'error' | 'groupCollapsed' | 'groupEnd' | 'log' | 'table'>
     >
 
+/**
+ * @public
+ * The server sent an `error`-event to tell the client that an unexpected error has happened.
+ */
+export declare class MessageError extends Error {
+  readonly name = 'MessageError'
+  readonly data?: unknown
+  constructor(message: string, data: unknown, options?: ErrorOptions)
+}
+
+/**
+ * @public
+ * An error occurred while parsing the message sent by the server as JSON. Should normally not happen.
+ */
+export declare class MessageParseError extends Error {
+  readonly name = 'MessageParseError'
+}
+
 /** @internal */
 export declare interface MultipleActionResult {
   transactionId: string
@@ -2068,6 +2152,15 @@ export declare class ObservableUsersClient {
   ): Observable<T extends 'me' ? CurrentSanityUser : SanityUser>
 }
 
+/**
+ * The listener connection has been established
+ * note: it's usually a better option to use the 'welcome' event
+ * @public
+ */
+export declare type OpenEvent = {
+  type: 'open'
+}
+
 /** @public */
 export declare class Patch extends BasePatch {
   #private
@@ -3066,6 +3159,15 @@ export declare class ServerError extends Error {
   constructor(res: Any)
 }
 
+/**
+ * @public
+ */
+export declare interface ServerSentEvent<Name extends string> {
+  type: Name
+  id?: string
+  data?: unknown
+}
+
 /** @internal */
 export declare interface SingleActionResult {
   transactionId: string
@@ -3236,6 +3338,13 @@ export declare class Transaction extends BaseTransaction {
    * @param patchOps - Operations to perform, or a builder function
    */
   patch(documentId: string, patchOps?: PatchBuilder | PatchOperations): this
+  /**
+   * Performs a patch on the given selection. Can either be a builder function or an object of patch operations.
+   *
+   * @param selection - An object with `query` and optional `params`, defining which document(s) to patch
+   * @param patchOps - Operations to perform, or a builder function
+   */
+  patch(patch: MutationSelection, patchOps?: PatchBuilder | PatchOperations): this
   /**
    * Adds the given patch instance to the transaction.
    * The operation is added to the current transaction, ready to be commited by `commit()`

package/dist/stega.d.ts

@@ -305,6 +305,16 @@ export declare class BaseTransaction {
   protected _add(mut: Mutation): this
 }
 
+/**
+ * @public
+ * The server sent a `channelError` message. Usually indicative of a bad or malformed request
+ */
+export declare class ChannelError extends Error {
+  readonly name = 'ChannelError'
+  readonly data?: unknown
+  constructor(message: string, data: unknown)
+}
+
 /**
  * An error occurred. This is different from a network-level error (which will be emitted as 'error').
  * Possible causes are things such as malformed filters, non-existant datasets or similar.
@@ -403,6 +413,39 @@ export declare type ClientReturn<
  */
 export declare interface ClientStegaConfig extends ClientConfig {}
 
+/**
+ * Sanity API specific EventSource handler shared between the listen and live APIs
+ *
+ * Since the `EventSource` API is not provided by all environments, this function enables custom initialization of the EventSource instance
+ * for runtimes that requires polyfilling or custom setup logic (e.g. custom HTTP headers)
+ * via the passed `initEventSource` function which must return an EventSource instance.
+ *
+ * Possible errors to be thrown on the returned observable are:
+ * - {@link MessageError}
+ * - {@link MessageParseError}
+ * - {@link ChannelError}
+ * - {@link DisconnectError}
+ * - {@link ConnectionFailedError}
+ *
+ * @param initEventSource - A function that returns an EventSource instance or an Observable that resolves to an EventSource instance
+ * @param events - an array of named events from the API to listen for.
+ *
+ * @internal
+ */
+export declare function connectEventSource<EventName extends string>(
+  initEventSource: () => EventSourceInstance | Observable<EventSourceInstance>,
+  events: EventName[],
+): Observable<ServerSentEvent<EventName>>
+
+/**
+ * @public
+ * Thrown if the EventSource connection could not be established.
+ * Note that ConnectionFailedErrors are rare, and disconnects will normally be handled by the EventSource instance itself and emitted as `reconnect` events.
+ */
+export declare class ConnectionFailedError extends Error {
+  readonly name = 'ConnectionFailedError'
+}
+
 /** @public */
 export declare interface ContentSourceMap {
   mappings: ContentSourceMapMappings
@@ -734,6 +777,18 @@ export declare type DiscardAction = {
   purge?: boolean
 }
 
+/**
+ * The listener has been told to explicitly disconnect.
+ *  This is a rare situation, but may occur if the API knows reconnect attempts will fail,
+ *  eg in the case of a deleted dataset, a blocked project or similar events.
+ * @public
+ */
+export declare class DisconnectError extends Error {
+  readonly name = 'DisconnectError'
+  readonly reason?: string
+  constructor(message: string, reason?: string, options?: ErrorOptions)
+}
+
 /**
  * The listener has been told to explicitly disconnect and not reconnect.
  * This is a rare situation, but may occur if the API knows reconnect attempts will fail,
@@ -799,6 +854,16 @@ export declare interface ErrorProps {
   details: Any
 }
 
+/**
+ * @internal
+ */
+export declare type EventSourceEvent<Name extends string> = ServerSentEvent<Name>
+
+/**
+ * @internal
+ */
+export declare type EventSourceInstance = InstanceType<typeof globalThis.EventSource>
+
 /** @public */
 export declare type FilterDefault = (props: {
   /**
@@ -1020,6 +1085,7 @@ export declare type ListenEvent<R extends Record<string, Any>> =
   | DisconnectEvent
   | ReconnectEvent
   | WelcomeEvent
+  | OpenEvent
 
 /** @public */
 export declare type ListenEventName =
@@ -1151,6 +1217,24 @@ declare type Logger_2 =
       Pick<typeof console, 'debug' | 'error' | 'groupCollapsed' | 'groupEnd' | 'log' | 'table'>
     >
 
+/**
+ * @public
+ * The server sent an `error`-event to tell the client that an unexpected error has happened.
+ */
+export declare class MessageError extends Error {
+  readonly name = 'MessageError'
+  readonly data?: unknown
+  constructor(message: string, data: unknown, options?: ErrorOptions)
+}
+
+/**
+ * @public
+ * An error occurred while parsing the message sent by the server as JSON. Should normally not happen.
+ */
+export declare class MessageParseError extends Error {
+  readonly name = 'MessageParseError'
+}
+
 /** @internal */
 export declare interface MultipleActionResult {
   transactionId: string
@@ -2068,6 +2152,15 @@ export declare class ObservableUsersClient {
   ): Observable<T extends 'me' ? CurrentSanityUser : SanityUser>
 }
 
+/**
+ * The listener connection has been established
+ * note: it's usually a better option to use the 'welcome' event
+ * @public
+ */
+export declare type OpenEvent = {
+  type: 'open'
+}
+
 /** @public */
 export declare class Patch extends BasePatch {
   #private
@@ -3066,6 +3159,15 @@ export declare class ServerError extends Error {
   constructor(res: Any)
 }
 
+/**
+ * @public
+ */
+export declare interface ServerSentEvent<Name extends string> {
+  type: Name
+  id?: string
+  data?: unknown
+}
+
 /** @internal */
 export declare interface SingleActionResult {
   transactionId: string
@@ -3236,6 +3338,13 @@ export declare class Transaction extends BaseTransaction {
    * @param patchOps - Operations to perform, or a builder function
    */
   patch(documentId: string, patchOps?: PatchBuilder | PatchOperations): this
+  /**
+   * Performs a patch on the given selection. Can either be a builder function or an object of patch operations.
+   *
+   * @param selection - An object with `query` and optional `params`, defining which document(s) to patch
+   * @param patchOps - Operations to perform, or a builder function
+   */
+  patch(patch: MutationSelection, patchOps?: PatchBuilder | PatchOperations): this
   /**
    * Adds the given patch instance to the transaction.
    * The operation is added to the current transaction, ready to be commited by `commit()`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/client",
-  "version": "6.24.3",
+  "version": "6.24.4",
   "description": "Client for retrieving, creating and patching data from Sanity.io",
   "keywords": [
     "sanity",
@@ -119,7 +119,7 @@
   },
   "dependencies": {
     "@sanity/eventsource": "^5.0.2",
-    "get-it": "^8.6.5",
+    "get-it": "^8.6.6",
     "rxjs": "^7.0.0"
   },
   "devDependencies": {
@@ -128,7 +128,7 @@
     "@rollup/plugin-commonjs": "^28.0.2",
     "@rollup/plugin-node-resolve": "^16.0.0",
     "@sanity/client-latest": "npm:@sanity/client@latest",
-    "@sanity/pkg-utils": "^6.13.3",
+    "@sanity/pkg-utils": "^7.0.1",
     "@types/json-diff": "^1.0.3",
     "@types/node": "^22.9.0",
     "@typescript-eslint/eslint-plugin": "^8.19.1",