@sanity/client 7.26.2 → 8.1.0

package/src/agent/actions/AgentActionsClient.ts

@@ -1,12 +1,12 @@
-import {lastValueFrom, type Observable} from 'rxjs'
+import {type Observable} from 'rxjs'
 
 import type {ObservableSanityClient, SanityClient} from '../../SanityClient'
 import type {Any, HttpRequest, IdentifiedSanityDocumentStub} from '../../types'
-import {_generate, type GenerateInstruction} from './generate'
+import {_generate, _generateObservable, type GenerateInstruction} from './generate'
 import {_patch, type PatchDocument} from './patch'
 import {_prompt, type PromptRequest} from './prompt'
-import {_transform, type TransformDocument} from './transform'
-import {_translate, type TranslateDocument} from './translate'
+import {_transform, _transformObservable, type TransformDocument} from './transform'
+import {_translate, _translateObservable, type TranslateDocument} from './translate'
 
 /** @public */
 export class ObservableAgentsActionClient {
@@ -28,7 +28,7 @@ export class ObservableAgentsActionClient {
       ? {_id: string}
       : IdentifiedSanityDocumentStub & DocumentShape
   > {
-    return _generate(this.#client, this.#httpRequest, request)
+    return _generateObservable(this.#client, this.#httpRequest, request)
   }
 
   /**
@@ -42,7 +42,7 @@ export class ObservableAgentsActionClient {
       ? {_id: string}
       : IdentifiedSanityDocumentStub & DocumentShape
   > {
-    return _transform(this.#client, this.#httpRequest, request)
+    return _transformObservable(this.#client, this.#httpRequest, request)
   }
 
   /**
@@ -56,7 +56,7 @@ export class ObservableAgentsActionClient {
       ? {_id: string}
       : IdentifiedSanityDocumentStub & DocumentShape
   > {
-    return _translate(this.#client, this.#httpRequest, request)
+    return _translateObservable(this.#client, this.#httpRequest, request)
   }
 }
 
@@ -80,7 +80,7 @@ export class AgentActionsClient {
       ? {_id: string}
       : IdentifiedSanityDocumentStub & DocumentShape
   > {
-    return lastValueFrom(_generate(this.#client, this.#httpRequest, request))
+    return _generate(this.#client, this.#httpRequest, request)
   }
 
   /**
@@ -94,7 +94,7 @@ export class AgentActionsClient {
       ? {_id: string}
       : IdentifiedSanityDocumentStub & DocumentShape
   > {
-    return lastValueFrom(_transform(this.#client, this.#httpRequest, request))
+    return _transform(this.#client, this.#httpRequest, request)
   }
 
   /**
@@ -108,7 +108,7 @@ export class AgentActionsClient {
       ? {_id: string}
       : IdentifiedSanityDocumentStub & DocumentShape
   > {
-    return lastValueFrom(_translate(this.#client, this.#httpRequest, request))
+    return _translate(this.#client, this.#httpRequest, request)
   }
 
   /**
@@ -118,7 +118,7 @@ export class AgentActionsClient {
   prompt<const DocumentShape extends Record<string, Any>>(
     request: PromptRequest<DocumentShape>,
   ): Promise<(typeof request)['format'] extends 'json' ? DocumentShape : string> {
-    return lastValueFrom(_prompt(this.#client, this.#httpRequest, request))
+    return _prompt(this.#client, this.#httpRequest, request)
   }
 
   /**
@@ -133,6 +133,6 @@ export class AgentActionsClient {
       ? {_id: string}
       : IdentifiedSanityDocumentStub & DocumentShape
   > {
-    return lastValueFrom(_patch(this.#client, this.#httpRequest, request))
+    return _patch(this.#client, this.#httpRequest, request)
   }
 }

package/src/agent/actions/commonTypes.ts

@@ -135,7 +135,8 @@ export interface GroqAgentActionParam {
 
 /**  @beta */
 export type AgentActionTypeConfig =
-  {include: string[]; exclude?: never} | {exclude: string[]; include?: never}
+  | {include: string[]; exclude?: never}
+  | {exclude: string[]; include?: never}
 
 /**  @beta */
 export type AgentActionPathSegment = string | {_key: string}

package/src/agent/actions/generate.ts

@@ -1,6 +1,6 @@
 import {type Observable} from 'rxjs'
 
-import {_request} from '../../data/dataMethods'
+import {_request, _requestObservable} from '../../data/dataMethods'
 import type {ObservableSanityClient, SanityClient} from '../../SanityClient'
 import type {AgentActionParams, Any, HttpRequest, IdentifiedSanityDocumentStub} from '../../types'
 import {hasDataset} from '../../validators'
@@ -271,23 +271,26 @@ interface GenerateTargetDocumentRequest<T extends Record<string, Any> = Record<s
 
 /** @beta */
 export type GenerateSyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
-  GenerateExistingDocumentRequest | GenerateTargetDocumentRequest<T>
+  | GenerateExistingDocumentRequest
+  | GenerateTargetDocumentRequest<T>
 ) &
   GenerateRequestBase &
   AgentActionSync
 
 /** @beta */
 export type GenerateAsyncInstruction<T extends Record<string, Any> = Record<string, Any>> = (
-  GenerateExistingDocumentRequest | GenerateTargetDocumentRequest<T>
+  | GenerateExistingDocumentRequest
+  | GenerateTargetDocumentRequest<T>
 ) &
   GenerateRequestBase &
   AgentActionAsync
 
 /** @beta */
 export type GenerateInstruction<T extends Record<string, Any> = Record<string, Any>> =
-  GenerateSyncInstruction<T> | GenerateAsyncInstruction<T>
+  | GenerateSyncInstruction<T>
+  | GenerateAsyncInstruction<T>
 
-export function _generate<DocumentShape extends Record<string, Any>>(
+export function _generateObservable<DocumentShape extends Record<string, Any>>(
   client: SanityClient | ObservableSanityClient,
   httpRequest: HttpRequest,
   request: GenerateInstruction<DocumentShape>,
@@ -295,11 +298,28 @@ export function _generate<DocumentShape extends Record<string, Any>>(
   (typeof request)['async'] extends true
     ? {_id: string}
     : IdentifiedSanityDocumentStub & DocumentShape
+> {
+  const dataset = hasDataset(client.config())
+  return _requestObservable(client, httpRequest, {
+    method: 'POST',
+    url: `/agent/action/generate/${dataset}`,
+    body: request,
+  })
+}
+
+export function _generate<DocumentShape extends Record<string, Any>>(
+  client: SanityClient | ObservableSanityClient,
+  httpRequest: HttpRequest,
+  request: GenerateInstruction<DocumentShape>,
+): Promise<
+  (typeof request)['async'] extends true
+    ? {_id: string}
+    : IdentifiedSanityDocumentStub & DocumentShape
 > {
   const dataset = hasDataset(client.config())
   return _request(client, httpRequest, {
     method: 'POST',
-    uri: `/agent/action/generate/${dataset}`,
+    url: `/agent/action/generate/${dataset}`,
     body: request,
   })
 }

package/src/agent/actions/patch.ts

@@ -1,6 +1,6 @@
 import {type Observable} from 'rxjs'
 
-import {_request} from '../../data/dataMethods'
+import {_request, _requestObservable} from '../../data/dataMethods'
 import type {ObservableSanityClient, SanityClient} from '../../SanityClient'
 import type {
   AgentActionPath,
@@ -16,7 +16,7 @@ import type {AgentActionAsync, AgentActionSchema, AgentActionSync} from './commo
 /**  @beta */
 export type PatchOperation = 'set' | 'append' | 'mixed' | 'unset'
 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
+// oxlint-disable-next-line typescript/no-explicit-any
 type AnyNonNullable = Exclude<any, null | undefined>
 
 /**  @beta */
@@ -99,23 +99,26 @@ interface PatchTargetDocumentRequest<T extends Record<string, Any> = Record<stri
 
 /** @beta */
 export type PatchDocumentSync<T extends Record<string, Any> = Record<string, Any>> = (
-  PatchExistingDocumentRequest | PatchTargetDocumentRequest<T>
+  | PatchExistingDocumentRequest
+  | PatchTargetDocumentRequest<T>
 ) &
   PatchRequestBase &
   AgentActionSync
 
 /** @beta */
 export type PatchDocumentAsync<T extends Record<string, Any> = Record<string, Any>> = (
-  PatchExistingDocumentRequest | PatchTargetDocumentRequest<T>
+  | PatchExistingDocumentRequest
+  | PatchTargetDocumentRequest<T>
 ) &
   PatchRequestBase &
   AgentActionAsync
 
 /** @beta */
 export type PatchDocument<T extends Record<string, Any> = Record<string, Any>> =
-  PatchDocumentSync<T> | PatchDocumentAsync<T>
+  | PatchDocumentSync<T>
+  | PatchDocumentAsync<T>
 
-export function _patch<DocumentShape extends Record<string, Any>>(
+export function _patchObservable<DocumentShape extends Record<string, Any>>(
   client: SanityClient | ObservableSanityClient,
   httpRequest: HttpRequest,
   request: PatchDocument<DocumentShape>,
@@ -123,11 +126,28 @@ export function _patch<DocumentShape extends Record<string, Any>>(
   (typeof request)['async'] extends true
     ? {_id: string}
     : IdentifiedSanityDocumentStub & DocumentShape
+> {
+  const dataset = hasDataset(client.config())
+  return _requestObservable(client, httpRequest, {
+    method: 'POST',
+    url: `/agent/action/patch/${dataset}`,
+    body: request,
+  })
+}
+
+export function _patch<DocumentShape extends Record<string, Any>>(
+  client: SanityClient | ObservableSanityClient,
+  httpRequest: HttpRequest,
+  request: PatchDocument<DocumentShape>,
+): Promise<
+  (typeof request)['async'] extends true
+    ? {_id: string}
+    : IdentifiedSanityDocumentStub & DocumentShape
 > {
   const dataset = hasDataset(client.config())
   return _request(client, httpRequest, {
     method: 'POST',
-    uri: `/agent/action/patch/${dataset}`,
+    url: `/agent/action/patch/${dataset}`,
     body: request,
   })
 }

package/src/agent/actions/prompt.ts

@@ -1,6 +1,6 @@
 import {type Observable} from 'rxjs'
 
-import {_request} from '../../data/dataMethods'
+import {_request, _requestObservable} from '../../data/dataMethods'
 import type {ObservableSanityClient, SanityClient} from '../../SanityClient'
 import type {AgentActionParams, Any, HttpRequest} from '../../types'
 import {hasDataset} from '../../validators'
@@ -101,7 +101,7 @@ export interface PromptRequestBase {
  * @beta
  */
 // need the unused generic here to allow for optional callsite casting
-// eslint-disable-next-line unused-imports/no-unused-vars
+// oxlint-disable-next-line no-unused-vars
 interface PromptJsonResponse<T extends Record<string, Any> = Record<string, Any>> {
   /**
    *
@@ -120,19 +120,33 @@ interface PromptTextResponse {
 
 /** @beta */
 export type PromptRequest<T extends Record<string, Any> = Record<string, Any>> = (
-  PromptTextResponse | PromptJsonResponse<T>
+  | PromptTextResponse
+  | PromptJsonResponse<T>
 ) &
   PromptRequestBase
 
-export function _prompt<const DocumentShape extends Record<string, Any>>(
+export function _promptObservable<const DocumentShape extends Record<string, Any>>(
   client: SanityClient | ObservableSanityClient,
   httpRequest: HttpRequest,
   request: PromptRequest<DocumentShape>,
 ): Observable<(typeof request)['format'] extends 'json' ? DocumentShape : string> {
+  const dataset = hasDataset(client.config())
+  return _requestObservable(client, httpRequest, {
+    method: 'POST',
+    url: `/agent/action/prompt/${dataset}`,
+    body: request,
+  })
+}
+
+export function _prompt<const DocumentShape extends Record<string, Any>>(
+  client: SanityClient | ObservableSanityClient,
+  httpRequest: HttpRequest,
+  request: PromptRequest<DocumentShape>,
+): Promise<(typeof request)['format'] extends 'json' ? DocumentShape : string> {
   const dataset = hasDataset(client.config())
   return _request(client, httpRequest, {
     method: 'POST',
-    uri: `/agent/action/prompt/${dataset}`,
+    url: `/agent/action/prompt/${dataset}`,
     body: request,
   })
 }

package/src/agent/actions/transform.ts

@@ -1,6 +1,6 @@
 import {type Observable} from 'rxjs'
 
-import {_request} from '../../data/dataMethods'
+import {_request, _requestObservable} from '../../data/dataMethods'
 import type {ObservableSanityClient, SanityClient} from '../../SanityClient'
 import type {
   AgentActionParams,
@@ -313,7 +313,7 @@ export interface TransformTarget extends AgentActionTarget {
 
 /** @beta */
 // need the generics to hold optional call-site response generics
-// eslint-disable-next-line unused-imports/no-unused-vars
+// oxlint-disable-next-line no-unused-vars
 export type TransformDocumentSync<T extends Record<string, Any> = Record<string, Any>> =
   TransformRequestBase & AgentActionSync
 
@@ -322,9 +322,10 @@ export type TransformDocumentAsync = TransformRequestBase & AgentActionAsync
 
 /** @beta */
 export type TransformDocument<T extends Record<string, Any> = Record<string, Any>> =
-  TransformDocumentSync<T> | TransformDocumentAsync
+  | TransformDocumentSync<T>
+  | TransformDocumentAsync
 
-export function _transform<DocumentShape extends Record<string, Any>>(
+export function _transformObservable<DocumentShape extends Record<string, Any>>(
   client: SanityClient | ObservableSanityClient,
   httpRequest: HttpRequest,
   request: TransformDocument<DocumentShape>,
@@ -332,11 +333,28 @@ export function _transform<DocumentShape extends Record<string, Any>>(
   (typeof request)['async'] extends true
     ? {_id: string}
     : IdentifiedSanityDocumentStub & DocumentShape
+> {
+  const dataset = hasDataset(client.config())
+  return _requestObservable(client, httpRequest, {
+    method: 'POST',
+    url: `/agent/action/transform/${dataset}`,
+    body: request,
+  })
+}
+
+export function _transform<DocumentShape extends Record<string, Any>>(
+  client: SanityClient | ObservableSanityClient,
+  httpRequest: HttpRequest,
+  request: TransformDocument<DocumentShape>,
+): Promise<
+  (typeof request)['async'] extends true
+    ? {_id: string}
+    : IdentifiedSanityDocumentStub & DocumentShape
 > {
   const dataset = hasDataset(client.config())
   return _request(client, httpRequest, {
     method: 'POST',
-    uri: `/agent/action/transform/${dataset}`,
+    url: `/agent/action/transform/${dataset}`,
     body: request,
   })
 }

package/src/agent/actions/translate.ts

@@ -1,6 +1,6 @@
 import {type Observable} from 'rxjs'
 
-import {_request} from '../../data/dataMethods'
+import {_request, _requestObservable} from '../../data/dataMethods'
 import type {ObservableSanityClient, SanityClient} from '../../SanityClient'
 import type {
   AgentActionParams,
@@ -138,7 +138,7 @@ export interface TranslateTarget extends AgentActionTarget {
 
 /** @beta */
 // need the generics to hold optional call-site response generics
-// eslint-disable-next-line unused-imports/no-unused-vars
+// oxlint-disable-next-line no-unused-vars
 export type TranslateDocumentSync<T extends Record<string, Any> = Record<string, Any>> =
   TranslateRequestBase & AgentActionSync
 
@@ -147,9 +147,10 @@ export type TranslateDocumentAsync = TranslateRequestBase & AgentActionAsync
 
 /** @beta */
 export type TranslateDocument<T extends Record<string, Any> = Record<string, Any>> =
-  TranslateDocumentSync<T> | TranslateDocumentAsync
+  | TranslateDocumentSync<T>
+  | TranslateDocumentAsync
 
-export function _translate<DocumentShape extends Record<string, Any>>(
+export function _translateObservable<DocumentShape extends Record<string, Any>>(
   client: SanityClient | ObservableSanityClient,
   httpRequest: HttpRequest,
   request: TranslateDocument<DocumentShape>,
@@ -157,11 +158,28 @@ export function _translate<DocumentShape extends Record<string, Any>>(
   (typeof request)['async'] extends true
     ? {_id: string}
     : IdentifiedSanityDocumentStub & DocumentShape
+> {
+  const dataset = hasDataset(client.config())
+  return _requestObservable(client, httpRequest, {
+    method: 'POST',
+    url: `/agent/action/translate/${dataset}`,
+    body: request,
+  })
+}
+
+export function _translate<DocumentShape extends Record<string, Any>>(
+  client: SanityClient | ObservableSanityClient,
+  httpRequest: HttpRequest,
+  request: TranslateDocument<DocumentShape>,
+): Promise<
+  (typeof request)['async'] extends true
+    ? {_id: string}
+    : IdentifiedSanityDocumentStub & DocumentShape
 > {
   const dataset = hasDataset(client.config())
   return _request(client, httpRequest, {
     method: 'POST',
-    uri: `/agent/action/translate/${dataset}`,
+    url: `/agent/action/translate/${dataset}`,
     body: request,
   })
 }

package/src/assets/AssetsClient.ts

@@ -1,18 +1,20 @@
-import {lastValueFrom, type Observable} from 'rxjs'
-import {filter, map} from 'rxjs/operators'
+import {defer, lastValueFrom, type Observable} from 'rxjs'
+import {filter, map, mergeAll} from 'rxjs/operators'
 
-import {_requestObservable} from '../data/dataMethods'
+import {_prepareRequest, _uploadObservable} from '../data/dataMethods'
+import type {FetchRequest} from '../http/requestOptions'
 import type {ObservableSanityClient, SanityClient} from '../SanityClient'
 import type {
   Any,
   HttpRequest,
-  HttpRequestEvent,
   InitializedClientConfig,
-  ResponseEvent,
+  MediaLibraryAssetDocument,
   SanityAssetDocument,
   SanityImageAssetDocument,
   UploadBody,
   UploadClientConfig,
+  UploadEvent,
+  UploadResponseEvent,
 } from '../types'
 import * as validators from '../validators'
 
@@ -36,7 +38,7 @@ export class ObservableAssetsClient {
     assetType: 'file',
     body: UploadBody,
     options?: UploadClientConfig,
-  ): Observable<HttpRequestEvent<{document: SanityAssetDocument}>>
+  ): Observable<UploadEvent<{document: SanityAssetDocument}>>
 
   /**
    * Uploads an image asset to the configured dataset
@@ -49,7 +51,7 @@ export class ObservableAssetsClient {
     assetType: 'image',
     body: UploadBody,
     options?: UploadClientConfig,
-  ): Observable<HttpRequestEvent<{document: SanityImageAssetDocument}>>
+  ): Observable<UploadEvent<{document: SanityImageAssetDocument}>>
   /**
    * Uploads a file or an image asset to the configured dataset
    *
@@ -61,12 +63,17 @@ export class ObservableAssetsClient {
     assetType: 'file' | 'image',
     body: UploadBody,
     options?: UploadClientConfig,
-  ): Observable<HttpRequestEvent<{document: SanityAssetDocument | SanityImageAssetDocument}>>
+  ): Observable<UploadEvent<{document: SanityAssetDocument | SanityImageAssetDocument}>>
   upload(
     assetType: 'file' | 'image',
     body: UploadBody,
     options?: UploadClientConfig,
-  ): Observable<HttpRequestEvent<{document: SanityAssetDocument | SanityImageAssetDocument}>> {
+  ): Observable<
+    UploadEvent<
+      | {document: SanityAssetDocument | SanityImageAssetDocument}
+      | {asset: MediaLibraryAssetDocument}
+    >
+  > {
     return _upload(this.#client, this.#httpRequest, assetType, body, options)
   }
 }
@@ -83,6 +90,16 @@ export class AssetsClient {
   /**
    * Uploads a file asset to the configured dataset
    *
+   * Note: when the client is configured against a Media Library
+   * (`resource: {type: 'media-library', id}`), this resolves to a
+   * {@link MediaLibraryAssetDocument} at runtime, not to a
+   * {@link SanityAssetDocument}. The declared type cannot express that: the
+   * shape depends on the client's configuration rather than on the arguments,
+   * so an overload cannot discriminate it, and widening the return type into a
+   * union would be a breaking change for every existing caller. Narrow the
+   * result yourself (for example, check for `currentVersion`) if you upload to
+   * a Media Library. Typing this honestly is deferred to the next major.
+   *
    * @param assetType - Asset type (file)
    * @param body - Asset content - can be a browser File instance, a Blob, a Node.js Buffer instance or a Node.js ReadableStream.
    * @param options - Options to use for the upload
@@ -95,6 +112,10 @@ export class AssetsClient {
   /**
    * Uploads an image asset to the configured dataset
    *
+   * Note: against a Media Library this resolves to a
+   * {@link MediaLibraryAssetDocument} at runtime. See the `'file'` overload
+   * above for why the declared type cannot say so.
+   *
    * @param assetType - Asset type (image)
    * @param body - Asset content - can be a browser File instance, a Blob, a Node.js Buffer instance or a Node.js ReadableStream.
    * @param options - Options to use for the upload
@@ -120,28 +141,54 @@ export class AssetsClient {
     assetType: 'file' | 'image',
     body: UploadBody,
     options?: UploadClientConfig,
-  ): Promise<SanityAssetDocument | SanityImageAssetDocument> {
-    const observable = _upload(this.#client, this.#httpRequest, assetType, body, options)
+  ): Promise<SanityAssetDocument | SanityImageAssetDocument | MediaLibraryAssetDocument> {
+    type Doc =
+      | {document: SanityAssetDocument | SanityImageAssetDocument}
+      | {asset: MediaLibraryAssetDocument}
+    const observable = _upload<Doc>(this.#client, this.#httpRequest, assetType, body, options)
     return lastValueFrom(
       observable.pipe(
-        filter((event: Any) => event.type === 'response'),
-        map(
-          (event) =>
-            (event as ResponseEvent<{document: SanityAssetDocument | SanityImageAssetDocument}>)
-              .body.document,
-        ),
+        filter((event): event is UploadResponseEvent<Doc> => event.type === 'response'),
+        map((event) => pluckUploadedAsset(event.body)),
       ),
     )
   }
 }
 
-function _upload(
+/**
+ * Content Lake's upload endpoint responds with `{document: ...}`; the Media
+ * Library upload endpoint responds with `{asset: ...}` instead (a
+ * `sanity.asset` document, not a Content Lake asset document). Narrowing on
+ * the response body itself - rather than on the client's `resource` config -
+ * keeps this correct regardless of how the two are ever wired together.
+ */
+function isMediaLibraryUploadBody(
+  body:
+    | {document: SanityAssetDocument | SanityImageAssetDocument}
+    | {asset: MediaLibraryAssetDocument},
+): body is {asset: MediaLibraryAssetDocument} {
+  return 'asset' in body
+}
+
+function pluckUploadedAsset(
+  body:
+    | {document: SanityAssetDocument | SanityImageAssetDocument}
+    | {asset: MediaLibraryAssetDocument},
+): SanityAssetDocument | SanityImageAssetDocument | MediaLibraryAssetDocument {
+  return isMediaLibraryUploadBody(body) ? body.asset : body.document
+}
+
+function _upload<
+  T =
+    | {document: SanityAssetDocument | SanityImageAssetDocument}
+    | {asset: MediaLibraryAssetDocument},
+>(
   client: SanityClient | ObservableSanityClient,
-  httpRequest: HttpRequest,
+  _httpRequest: HttpRequest,
   assetType: 'image' | 'file',
   body: UploadBody,
   opts: UploadClientConfig = {},
-): Observable<HttpRequestEvent<{document: SanityAssetDocument | SanityImageAssetDocument}>> {
+): Observable<UploadEvent<T>> {
   validators.validateAssetType(assetType)
 
   // If an empty array is given, explicitly set `none` to override API defaults
@@ -180,15 +227,65 @@ function _upload(
     query.sourceUrl = source.url
   }
 
-  return _requestObservable(client, httpRequest, {
+  const headers: Record<string, string> = options.contentType
+    ? {'Content-Type': options.contentType}
+    : {}
+  const baseRequest = {
     tag,
     method: 'POST',
+    // Uploads have NO timeout unless the caller opts in — uploads can
+    // legitimately be slow. `0` translates to "disabled" at the request
+    // boundary, which also shields uploads from get-it's default timeout.
     timeout: options.timeout || 0,
-    uri: buildAssetUploadUrl(config, assetType),
-    headers: options.contentType ? {'Content-Type': options.contentType} : {},
+    url: buildAssetUploadUrl(config, assetType),
+    headers,
     query,
     body,
-  })
+  }
+
+  // In browsers, run uploads through `XMLHttpRequest` so we can surface
+  // per-chunk upload progress events — fetch (and therefore get-it v9) has no
+  // equivalent hook. Outside the browser (Node, edge runtimes), we fall back
+  // to the regular fetch-based path which only emits the terminal `response`
+  // event.
+  if (typeof XMLHttpRequest !== 'undefined') {
+    return defer(async () => {
+      const {uploadWithProgress} = await import('../http/browserUpload')
+      // Build the request the same way the fetch path does, so the request
+      // tag (incl. `requestTagPrefix` and validation), auth/custom headers,
+      // credentials and timeout are identical across both upload transports.
+      // The XHR API needs the query baked into the URL, though.
+      const req = _prepareRequest(client, {...baseRequest})
+      return uploadWithProgress<T>({
+        url: appendQuery(req.url, req.query),
+        method: req.method ?? 'POST',
+        headers: req.headers,
+        body,
+        withCredentials: req.credentials === 'include',
+        // XHR only has a single total-deadline timer, so a structured
+        // get-it timeout collapses to its `total` component here.
+        timeout: typeof req.timeout === 'object' ? req.timeout.total : req.timeout,
+        signal: req.signal,
+      })
+    }).pipe(mergeAll())
+  }
+
+  return _uploadObservable<T>(client, baseRequest)
+}
+
+function appendQuery(url: string, query: FetchRequest['query']): string {
+  if (!query) return url
+  const params =
+    query instanceof URLSearchParams
+      ? query
+      : new URLSearchParams(
+          Object.entries(query).flatMap(([key, value]) =>
+            value === undefined || value === null ? [] : [[key, `${value}`]],
+          ),
+        )
+  const qs = params.toString()
+  if (!qs) return url
+  return url + (url.includes('?') ? '&' : '?') + qs
 }
 
 function buildAssetUploadUrl(config: InitializedClientConfig, assetType: 'image' | 'file'): string {