@relyio/sdk 0.15.0 → 0.17.0

package/dist/{chunk-3BHDGUNS.cjs → chunk-6E22GYPB.cjs}

@@ -1,11 +1,18 @@
 'use strict';
 
 var chunkLSRPMNPT_cjs = require('./chunk-LSRPMNPT.cjs');
+var chunk6PTRZP5U_cjs = require('./chunk-6PTRZP5U.cjs');
 var chunkTZL374LS_cjs = require('./chunk-TZL374LS.cjs');
 var chunkMWMSFIWN_cjs = require('./chunk-MWMSFIWN.cjs');
 
 /* RelyIO SDK - Built with ❤️ by the RelyIO Team */
 
+// src/config/key-kind.ts
+var PUBLISHABLE_KEY_PREFIX = "rly_pub_";
+var isPublishableKey = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((apiKey) => apiKey?.startsWith(PUBLISHABLE_KEY_PREFIX) === true, "isPublishableKey");
+var PREVIEW_KEY_PREFIX = "rly_prev_";
+var isPreviewKey = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((apiKey) => apiKey?.startsWith(PREVIEW_KEY_PREFIX) === true, "isPreviewKey");
+
 // src/errors/sdk-error.ts
 var _SDKError = class _SDKError extends Error {
   constructor(message, statusCode, cause, context) {
@@ -59,19 +66,84 @@ var _SDKError = class _SDKError extends Error {
     return this.code === errorType;
   }
   /**
-   * Create a new error with additional context
+   * Create a copy of this error with additional context.
+   *
+   * The copy is made from this error's own properties, not by calling a constructor: subclasses
+   * declare constructors of their own (violations, a timeout, a feature, a failed index second),
+   * and no single argument order fits them all. Rebuilding through the base order put the status
+   * code in the subclass's second slot. Copying keeps every field, the subclass's own included, and
+   * the original `timestamp` and `stack`, since it is the same failure.
+   *
+   * `Object.create` runs no constructor, so a `#private` field would not survive the copy; none
+   * exist in this directory. `stack` is not an own property on V8 and is copied by hand below.
    */
   withContext(context) {
-    const Constructor = this.constructor;
-    return new Constructor(this.message, this.statusCode, this.cause, {
-      ...this.context,
-      ...context
+    return Object.create(Object.getPrototypeOf(this), {
+      ...Object.getOwnPropertyDescriptors(this),
+      stack: { value: this.stack, writable: true, enumerable: false, configurable: true },
+      context: {
+        value: { ...this.context, ...context },
+        writable: true,
+        enumerable: true,
+        configurable: true
+      }
     });
   }
 };
 chunkMWMSFIWN_cjs.__name(_SDKError, "SDKError");
 var SDKError = _SDKError;
 
+// src/errors/content-errors.ts
+var _ResourceNotFoundError = class _ResourceNotFoundError extends SDKError {
+  constructor(message = "Resource not found", statusCode = 404, cause, context) {
+    super(message, statusCode, cause, context);
+    chunkMWMSFIWN_cjs.__publicField(this, "code", "RESOURCE_NOT_FOUND");
+    chunkMWMSFIWN_cjs.__publicField(this, "retryable", false);
+  }
+  getUserMessage() {
+    const resourceType = this.context?.resourceType;
+    const resourceId = this.context?.resourceId;
+    if (resourceType != null && resourceId != null) {
+      return `${resourceType} with ID "${resourceId}" was not found.`;
+    }
+    return "The requested resource was not found.";
+  }
+};
+chunkMWMSFIWN_cjs.__name(_ResourceNotFoundError, "ResourceNotFoundError");
+var ResourceNotFoundError = _ResourceNotFoundError;
+var _ResourceConflictError = class _ResourceConflictError extends SDKError {
+  constructor(message = "Resource conflict", statusCode = 409, cause, context) {
+    super(message, statusCode, cause, context);
+    chunkMWMSFIWN_cjs.__publicField(this, "code", "RESOURCE_CONFLICT");
+    chunkMWMSFIWN_cjs.__publicField(this, "retryable", false);
+  }
+  getUserMessage() {
+    return "The resource could not be created or updated due to a conflict.";
+  }
+};
+chunkMWMSFIWN_cjs.__name(_ResourceConflictError, "ResourceConflictError");
+var ResourceConflictError = _ResourceConflictError;
+var _ResourceExpiredError = class _ResourceExpiredError extends SDKError {
+  constructor(message = "Resource has expired", statusCode = 410, cause, context) {
+    super(message, statusCode, cause, context);
+    chunkMWMSFIWN_cjs.__publicField(this, "code", "RESOURCE_EXPIRED");
+    chunkMWMSFIWN_cjs.__publicField(this, "retryable", false);
+  }
+  getUserMessage() {
+    return "The resource is no longer available.";
+  }
+};
+chunkMWMSFIWN_cjs.__name(_ResourceExpiredError, "ResourceExpiredError");
+var ResourceExpiredError = _ResourceExpiredError;
+function isResourceNotFound(error) {
+  return error instanceof ResourceNotFoundError;
+}
+chunkMWMSFIWN_cjs.__name(isResourceNotFound, "isResourceNotFound");
+function isMissingEntry(error) {
+  return error instanceof ResourceNotFoundError && error.context?.resourceType === "entry";
+}
+chunkMWMSFIWN_cjs.__name(isMissingEntry, "isMissingEntry");
+
 // src/errors/contract-errors.ts
 var _MissingApiKeyError = class _MissingApiKeyError extends SDKError {
   constructor(message = "No API key was sent", context) {
@@ -184,7 +256,7 @@ var _TransactionRolledBackError = class _TransactionRolledBackError extends SDKE
     this.failedIndex = failedIndex;
   }
   getUserMessage() {
-    return this.failedIndex === void 0 ? "The batch was rolled back; nothing was written." : `The batch was rolled back at operation ${this.failedIndex}; nothing was written.`;
+    return this.failedIndex === void 0 ? "The batch was rolled back; nothing was written." : `The batch was rolled back; nothing was written. This refusal is for operation ${this.failedIndex} of the batch, which is not necessarily the one that failed.`;
   }
 };
 chunkMWMSFIWN_cjs.__name(_TransactionRolledBackError, "TransactionRolledBackError");
@@ -258,57 +330,6 @@ var _InvalidApiKeyError = class _InvalidApiKeyError extends SDKError {
 chunkMWMSFIWN_cjs.__name(_InvalidApiKeyError, "InvalidApiKeyError");
 var InvalidApiKeyError = _InvalidApiKeyError;
 
-// src/errors/content-errors.ts
-var _ResourceNotFoundError = class _ResourceNotFoundError extends SDKError {
-  constructor(message = "Resource not found", statusCode = 404, cause, context) {
-    super(message, statusCode, cause, context);
-    chunkMWMSFIWN_cjs.__publicField(this, "code", "RESOURCE_NOT_FOUND");
-    chunkMWMSFIWN_cjs.__publicField(this, "retryable", false);
-  }
-  getUserMessage() {
-    const resourceType = this.context?.resourceType;
-    const resourceId = this.context?.resourceId;
-    if (resourceType != null && resourceId != null) {
-      return `${resourceType} with ID "${resourceId}" was not found.`;
-    }
-    return "The requested resource was not found.";
-  }
-};
-chunkMWMSFIWN_cjs.__name(_ResourceNotFoundError, "ResourceNotFoundError");
-var ResourceNotFoundError = _ResourceNotFoundError;
-var _ResourceConflictError = class _ResourceConflictError extends SDKError {
-  constructor(message = "Resource conflict", statusCode = 409, cause, context) {
-    super(message, statusCode, cause, context);
-    chunkMWMSFIWN_cjs.__publicField(this, "code", "RESOURCE_CONFLICT");
-    chunkMWMSFIWN_cjs.__publicField(this, "retryable", false);
-  }
-  getUserMessage() {
-    return "The resource could not be created or updated due to a conflict.";
-  }
-};
-chunkMWMSFIWN_cjs.__name(_ResourceConflictError, "ResourceConflictError");
-var ResourceConflictError = _ResourceConflictError;
-var _ResourceExpiredError = class _ResourceExpiredError extends SDKError {
-  constructor(message = "Resource has expired", statusCode = 410, cause, context) {
-    super(message, statusCode, cause, context);
-    chunkMWMSFIWN_cjs.__publicField(this, "code", "RESOURCE_EXPIRED");
-    chunkMWMSFIWN_cjs.__publicField(this, "retryable", false);
-  }
-  getUserMessage() {
-    return "The resource is no longer available.";
-  }
-};
-chunkMWMSFIWN_cjs.__name(_ResourceExpiredError, "ResourceExpiredError");
-var ResourceExpiredError = _ResourceExpiredError;
-function isResourceNotFound(error) {
-  return error instanceof ResourceNotFoundError;
-}
-chunkMWMSFIWN_cjs.__name(isResourceNotFound, "isResourceNotFound");
-function isMissingEntry(error) {
-  return error instanceof ResourceNotFoundError && error.context?.resourceType === "entry";
-}
-chunkMWMSFIWN_cjs.__name(isMissingEntry, "isMissingEntry");
-
 // src/errors/network-errors.ts
 var _NetworkError = class _NetworkError extends SDKError {
   constructor(message = "Network request failed", statusCode, cause, context) {
@@ -416,229 +437,6 @@ var _InvalidPayloadError = class _InvalidPayloadError extends BaseValidationErro
 chunkMWMSFIWN_cjs.__name(_InvalidPayloadError, "InvalidPayloadError");
 var InvalidPayloadError = _InvalidPayloadError;
 
-// ../../platform/api-contract/dist/chunk-46347LG2.js
-function defineRoute(route) {
-  if (route.kind === "raw" && route.standardShape === void 0) {
-    throw new Error("kind 'raw' requires a named StandardShape");
-  }
-  if (route.kind === "raw" && route.success === 302 && !route.headers.some((header) => header.name === "Location")) {
-    throw new Error("a raw route declaring success 302 must declare its 'Location' header");
-  }
-  if (route.kind === "stream" && route.stream === void 0) {
-    throw new Error("kind 'stream' requires a StreamDeclaration");
-  }
-  if (route.kind === "collection" && route.page === void 0) {
-    throw new Error("kind 'collection' requires a page dialect");
-  }
-  if (route.queues === true) {
-    if (route.kind !== "object" && route.kind !== "empty") {
-      throw new Error(
-        `kind '${route.kind}' cannot declare \`queues\`: only an object or empty route answers 202 beside its own status`
-      );
-    }
-    if (route.kind === "object" && route.success === 202) {
-      throw new Error("a route whose own status is 202 cannot also declare `queues`");
-    }
-  }
-  if ((route.kind === "object" || route.kind === "collection") && route.negotiated !== void 0) {
-    refuseMismatchedAlternate(route, route.negotiated["text/event-stream"]);
-  }
-  return route;
-}
-chunkMWMSFIWN_cjs.__name(defineRoute, "defineRoute");
-function refuseMismatchedAlternate(route, stream) {
-  if (stream.kind !== "stream") {
-    throw new Error("a negotiated 'text/event-stream' alternate must be kind 'stream'");
-  }
-  if (stream.stream.mediaType !== "text/event-stream") {
-    throw new Error(
-      `a negotiated 'text/event-stream' alternate declares media type "${stream.stream.mediaType}"`
-    );
-  }
-  const own = [...new Set(route.codes)].sort();
-  const alternate = [...new Set(stream.codes)].sort();
-  if (own.length !== alternate.length || own.some((code, index) => code !== alternate[index])) {
-    throw new Error(
-      `a negotiated alternate refuses with [${alternate.join(", ")}] while its route refuses with [${own.join(", ")}]; one route refuses with one set of codes on every transport`
-    );
-  }
-}
-chunkMWMSFIWN_cjs.__name(refuseMismatchedAlternate, "refuseMismatchedAlternate");
-
-// ../../platform/api-contract/dist/index.js
-var HEADER_RETRY_AFTER = { name: "Retry-After" };
-var HEADER_IF_MATCH = {
-  name: "If-Match"};
-function entityTag(parts) {
-  return `"${parts.entryUid}:${parts.locale}:${parts.version}:${parts.sharedVersion}"`;
-}
-chunkMWMSFIWN_cjs.__name(entityTag, "entityTag");
-var HEADER_IDEMPOTENCY_KEY = {
-  name: "Idempotency-Key"};
-var FRESH_PARAMETER = "_fresh";
-var VISITOR_LIVE_PATH = "/visitor/changes";
-var VISITOR_QUERY = {
-  /** The publishable key. */
-  key: "key",
-  /** A dataset id or name the key reaches; absent, the key's default dataset. */
-  dataset: "dataset",
-  /** The cursor to continue from; absent, the socket starts now. */
-  since: "since",
-  /** Comma-separated content types to keep; absent keeps every type. */
-  types: "types",
-  /** Comma-separated entry ids to keep; absent keeps every entry. */
-  ids: "ids",
-  /** The poll's client id. Required on a poll, and not read on a socket. */
-  client: "client"
-};
-var VISITOR_CURSOR = /^[\w.~-]{1,256}$/;
-var VISITOR_POLL_INTERVAL_MS = 15e3;
-var VISITOR_KEEPALIVE = { request: "ping", response: "pong" };
-var VISITOR_FRAMES = {
-  opened: "feed.opened",
-  changes: "feed.changes",
-  resync: "feed.resync"
-};
-defineRoute({
-  kind: "object",
-  headers: [HEADER_RETRY_AFTER],
-  codes: [
-    "REQUEST_INVALID",
-    "MISSING_API_KEY",
-    "INVALID_API_KEY",
-    "ACCESS_DENIED",
-    "METHOD_NOT_ALLOWED",
-    "SERVICE_INDETERMINATE",
-    "USAGE_QUOTA_EXCEEDED",
-    "RATE_LIMIT_EXCEEDED"
-  ]
-});
-var VISITOR_CLOSE_CODES = {
-  /** A query the door cannot read: a malformed `since`, filter, `dataset` or `client`. */
-  requestInvalid: 4400,
-  /** No publishable key, or one that is unknown, revoked, expired, a secret key or a preview key. */
-  keyRefused: 4401,
-  /** The page's `Origin` is absent, or not on the key's allowed origins. */
-  originRefused: 4403,
-  /** `dataset` names nothing the key reaches. */
-  datasetRefused: 4404,
-  /** The key's scope, the project's counter or the feed could not be reached just now. */
-  unavailable: 1013,
-  /**
-   * The project holds as many visitor connections as its plan allows — Starter's 100 — or its
-   * Organization is suspended. As HTTP's 402: more needs a bigger plan, or visitors leaving.
-   */
-  allowanceReached: 4402,
-  /** This client's address holds as many connections to the project as one address may. */
-  addressLimitReached: 4429,
-  /** The project is at its per-project safety ceiling — Pro's 50,000 — whatever it would pay for. */
-  ceilingReached: 4503
-};
-var VISITOR_CLOSE_RETRY = {
-  4400: "stop",
-  4401: "stop",
-  4403: "stop",
-  4404: "stop",
-  1013: "retry",
-  4402: "back-off",
-  4429: "back-off",
-  4503: "back-off"
-};
-var VISITOR_POLL_RETRY = {
-  REQUEST_INVALID: "stop",
-  MISSING_API_KEY: "stop",
-  INVALID_API_KEY: "stop",
-  ACCESS_DENIED: "stop",
-  METHOD_NOT_ALLOWED: "stop",
-  SERVICE_INDETERMINATE: "retry",
-  USAGE_QUOTA_EXCEEDED: "back-off",
-  RATE_LIMIT_EXCEEDED: "back-off"
-};
-var VISITOR_ADMISSION_RETRY_AFTER_SECONDS = 60;
-function parseVisitorFrame(text) {
-  let value;
-  try {
-    value = JSON.parse(text);
-  } catch {
-    return null;
-  }
-  if (!isRecord2(value) || !isCursor(value.cursor)) return null;
-  switch (value.type) {
-    case VISITOR_FRAMES.opened: {
-      return hasOnly(value, ["type", "cursor"]) ? { type: VISITOR_FRAMES.opened, cursor: value.cursor } : null;
-    }
-    case VISITOR_FRAMES.changes: {
-      const changes = hasOnly(value, ["type", "changes", "cursor"]) ? readVisitorChanges(value.changes) : null;
-      return changes === null ? null : { type: VISITOR_FRAMES.changes, changes, cursor: value.cursor };
-    }
-    case VISITOR_FRAMES.resync: {
-      return hasOnly(value, ["type", "reason", "cursor"]) && isResyncReason(value.reason) ? { type: VISITOR_FRAMES.resync, reason: value.reason, cursor: value.cursor } : null;
-    }
-    default: {
-      return null;
-    }
-  }
-}
-chunkMWMSFIWN_cjs.__name(parseVisitorFrame, "parseVisitorFrame");
-function readVisitorPollAnswer(value) {
-  if (!isRecord2(value) || !isCursor(value.cursor)) return null;
-  if (value.kind === "resync") {
-    return hasOnly(value, ["kind", "reason", "cursor"]) && isResyncReason(value.reason) ? { kind: "resync", reason: value.reason, cursor: value.cursor } : null;
-  }
-  if (value.kind !== "changes" || !hasOnly(value, ["kind", "changes", "cursor"])) return null;
-  const changes = readVisitorChanges(value.changes);
-  return changes === null ? null : { kind: "changes", changes, cursor: value.cursor };
-}
-chunkMWMSFIWN_cjs.__name(readVisitorPollAnswer, "readVisitorPollAnswer");
-var CHANGE_KINDS = /* @__PURE__ */ new Set([
-  "published",
-  "updated",
-  "unpublished",
-  "deleted"
-]);
-var RESYNC_REASONS = /* @__PURE__ */ new Set([
-  "retention",
-  "dataset-replaced",
-  "ahead-of-head",
-  "foreign-cursor",
-  "too-far-behind"
-]);
-function isResyncReason(value) {
-  return typeof value === "string" && RESYNC_REASONS.has(value);
-}
-chunkMWMSFIWN_cjs.__name(isResyncReason, "isResyncReason");
-function readVisitorChanges(value) {
-  if (!Array.isArray(value)) return null;
-  const changes = [];
-  for (const item of value) {
-    if (!isRecord2(item) || !hasOnly(item, ["entryId", "contentType", "locale", "kind"])) return null;
-    const { entryId, contentType, locale, kind } = item;
-    if (!isNonEmptyString2(entryId) || !isNonEmptyString2(contentType)) return null;
-    if (locale !== null && typeof locale !== "string") return null;
-    if (typeof kind !== "string" || !CHANGE_KINDS.has(kind)) return null;
-    changes.push({ entryId, contentType, locale, kind });
-  }
-  return changes;
-}
-chunkMWMSFIWN_cjs.__name(readVisitorChanges, "readVisitorChanges");
-function isCursor(value) {
-  return typeof value === "string" && VISITOR_CURSOR.test(value);
-}
-chunkMWMSFIWN_cjs.__name(isCursor, "isCursor");
-function isRecord2(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-chunkMWMSFIWN_cjs.__name(isRecord2, "isRecord2");
-function isNonEmptyString2(value) {
-  return typeof value === "string" && value.length > 0;
-}
-chunkMWMSFIWN_cjs.__name(isNonEmptyString2, "isNonEmptyString2");
-function hasOnly(value, keys) {
-  const present = Object.keys(value);
-  return present.length === keys.length && present.every((key) => keys.includes(key));
-}
-chunkMWMSFIWN_cjs.__name(hasOnly, "hasOnly");
-
 // ../../platform/api-contract/dist/client/index.js
 var _a;
 var ContractBodyError = (_a = class extends Error {
@@ -718,7 +516,7 @@ var _ErrorMapper = class _ErrorMapper {
       return new NetworkError(`HTTP ${status}: ${statusText}`.trim(), status, void 0, context);
     }
     const retryAfterMs = parseRetryAfterMs(
-      headerValue(headers, HEADER_RETRY_AFTER.name),
+      headerValue(headers, chunk6PTRZP5U_cjs.HEADER_RETRY_AFTER.name),
       Date.now()
     );
     return this.fromContractCode(refusal, status, context, retryAfterMs);
@@ -776,9 +574,13 @@ var _ErrorMapper = class _ErrorMapper {
       }
       case "RESOURCE_CONFLICT": {
         const expectedVersion = detailNumber(refusal, "expectedVersion");
-        const guidance = expectedVersion === void 0 ? message : `${message.endsWith(".") ? message : `${message}.`} ${STALE_VERSION_GUIDANCE}`;
+        const blockage = blockageOf(refusal);
+        const guidance = blockage !== void 0 || expectedVersion === void 0 ? message : `${message.endsWith(".") ? message : `${message}.`} ${STALE_VERSION_GUIDANCE}`;
         return new ResourceConflictError(guidance, 409, void 0, {
           ...context,
+          // What stands in the way, as a declared kind a program switches on: `draft-exists`,
+          // `release-locked` or `slug-taken` from the Content API (REL-2446).
+          blockage,
           expectedVersion,
           actualVersion: detailNumber(refusal, "actualVersion"),
           // The shared fields' counter, which the `If-Match` tag carries beside the locale's and a
@@ -788,7 +590,10 @@ var _ErrorMapper = class _ErrorMapper {
         });
       }
       case "RESOURCE_EXPIRED": {
-        return new ResourceExpiredError(message, 410, void 0, context);
+        return new ResourceExpiredError(message, 410, void 0, {
+          ...context,
+          reason: detailString(refusal, "reason")
+        });
       }
       case "REQUEST_TIMEOUT": {
         return new TimeoutError(message, void 0, status, void 0, context);
@@ -875,6 +680,15 @@ function detailNumber(refusal, key) {
   return typeof value === "number" ? value : void 0;
 }
 chunkMWMSFIWN_cjs.__name(detailNumber, "detailNumber");
+function blockageOf(refusal) {
+  const blockage = detailBag(refusal)?.blockage;
+  if (typeof blockage !== "object" || blockage === null) return void 0;
+  const { kind, facts } = blockage;
+  if (typeof kind !== "string") return void 0;
+  const named = typeof facts === "object" && facts !== null && !Array.isArray(facts) ? facts : {};
+  return { kind, facts: named };
+}
+chunkMWMSFIWN_cjs.__name(blockageOf, "blockageOf");
 function violationsOf(refusal) {
   const issues = detailBag(refusal)?.issues;
   if (!Array.isArray(issues)) return [];
@@ -934,6 +748,7 @@ var DECLARED_PATHS = {
   "/v1/{contentType}/{id}/file/multipart/sign-part": true,
   "/v1/{contentType}/{id}/file/presign": true,
   "/v1/{contentType}/{id}/file/url": true,
+  "/v1/{contentType}/{id}/shared-versions/{versionNumber}/restore": true,
   "/v1/{contentType}/{id}/versions": true,
   "/v1/{contentType}/{id}/versions/{versionNumber}": true,
   "/v1/{contentType}/{id}/versions/{versionNumber}/restore": true,
@@ -1018,42 +833,6 @@ function readQuery(searchParams) {
 }
 chunkMWMSFIWN_cjs.__name(readQuery, "readQuery");
 
-// src/http/abortable-sleep.ts
-function sleep(ms, signal) {
-  return new Promise((resolve) => {
-    if (isAborted(signal)) {
-      resolve();
-      return;
-    }
-    const done = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name(() => {
-      clearTimeout(timer);
-      signal?.removeEventListener("abort", done);
-      resolve();
-    }, "done");
-    const timer = setTimeout(done, ms);
-    signal?.addEventListener("abort", done, { once: true });
-  });
-}
-chunkMWMSFIWN_cjs.__name(sleep, "sleep");
-function isAborted(signal) {
-  return signal?.aborted === true;
-}
-chunkMWMSFIWN_cjs.__name(isAborted, "isAborted");
-
-// src/http/request-timeout.ts
-var MAX_TIMER_DELAY_MS = 2147483647;
-function isTimerDelay(value) {
-  return typeof value === "number" && value >= 1 && value <= MAX_TIMER_DELAY_MS;
-}
-chunkMWMSFIWN_cjs.__name(isTimerDelay, "isTimerDelay");
-function assertRequestTimeout(timeout) {
-  if (isTimerDelay(timeout)) return;
-  throw new Error(
-    `timeout must be a number of milliseconds from 1 to ${MAX_TIMER_DELAY_MS} \u2014 a timer given 0, NaN, Infinity or more fires at once and ends every request \u2014 and got ${String(timeout)}`
-  );
-}
-chunkMWMSFIWN_cjs.__name(assertRequestTimeout, "assertRequestTimeout");
-
 // src/errors/instructed-delay.ts
 function serviceInstructedDelayMs(error, nowMs) {
   if (error instanceof ServiceIndeterminateError) {
@@ -1080,9 +859,20 @@ var IDEMPOTENT_METHODS = /* @__PURE__ */ new Set([
 ]);
 function isReplaySafe(request) {
   if (IDEMPOTENT_METHODS.has(request.method.toUpperCase())) return true;
-  return headerValue(request.headers, HEADER_IDEMPOTENCY_KEY.name) !== void 0;
+  return headerValue(request.headers, chunk6PTRZP5U_cjs.HEADER_IDEMPOTENCY_KEY.name) !== void 0;
 }
 chunkMWMSFIWN_cjs.__name(isReplaySafe, "isReplaySafe");
+var UNREACHABLE_CODES = /* @__PURE__ */ new Set(["ECONNREFUSED", "ENOTFOUND"]);
+function isUnreachableHost(error, depth = 0) {
+  if (depth > 4 || typeof error !== "object" || error === null) return false;
+  const { code, cause, errors } = error;
+  if (typeof code === "string" && UNREACHABLE_CODES.has(code)) return true;
+  if (Array.isArray(errors) && errors.length > 0) {
+    if (errors.every((one) => isUnreachableHost(one, depth + 1))) return true;
+  }
+  return isUnreachableHost(cause, depth + 1);
+}
+chunkMWMSFIWN_cjs.__name(isUnreachableHost, "isUnreachableHost");
 var _DefaultRetryPolicy = class _DefaultRetryPolicy {
   constructor(config) {
     chunkMWMSFIWN_cjs.__publicField(this, "config");
@@ -1091,6 +881,7 @@ var _DefaultRetryPolicy = class _DefaultRetryPolicy {
   shouldRetry(attempt, error, request) {
     if (attempt >= this.config.maxAttempts) return false;
     if (!ErrorMapper.isRetryable(error)) return false;
+    if (isUnreachableHost(error)) return false;
     return isReplaySafe(request);
   }
   delayFor(attempt, error) {
@@ -1103,6 +894,86 @@ var _DefaultRetryPolicy = class _DefaultRetryPolicy {
 };
 chunkMWMSFIWN_cjs.__name(_DefaultRetryPolicy, "DefaultRetryPolicy");
 var DefaultRetryPolicy = _DefaultRetryPolicy;
+function retryPolicyFor(maxAttempts) {
+  return new DefaultRetryPolicy({
+    maxAttempts,
+    baseDelay: 1e3,
+    maxDelay: 1e4,
+    backoffFactor: 2,
+    jitter: true
+  });
+}
+chunkMWMSFIWN_cjs.__name(retryPolicyFor, "retryPolicyFor");
+
+// src/config/preview-read.ts
+var derived = /* @__PURE__ */ new Set();
+var unknown = /* @__PURE__ */ new Map();
+var announced = /* @__PURE__ */ new Set();
+function noteDerivedPreview(dataset) {
+  derived.add(dataset);
+}
+chunkMWMSFIWN_cjs.__name(noteDerivedPreview, "noteDerivedPreview");
+function isDerivedPreview(dataset) {
+  return derived.has(dataset);
+}
+chunkMWMSFIWN_cjs.__name(isDerivedPreview, "isDerivedPreview");
+function isUnknownPreview(dataset) {
+  const since = unknown.get(dataset);
+  if (since === void 0) return false;
+  if (Date.now() - since < chunk6PTRZP5U_cjs.UNKNOWN_PREVIEW_RECHECK_MS) return true;
+  unknown.delete(dataset);
+  return false;
+}
+chunkMWMSFIWN_cjs.__name(isUnknownPreview, "isUnknownPreview");
+function rememberUnknownPreview(dataset) {
+  unknown.set(dataset, Date.now());
+  if (announced.has(dataset)) return;
+  announced.add(dataset);
+  console.info(
+    `[RelyIO] No preview dataset "${dataset}" exists for this deployment's branch \u2014 reading the key's default dataset instead, and asking again in a minute.`
+  );
+}
+chunkMWMSFIWN_cjs.__name(rememberUnknownPreview, "rememberUnknownPreview");
+function answersUnknownDataset(error, dataset) {
+  return error instanceof ResourceNotFoundError && error.context?.resourceType === "dataset" && error.context.resourceId === dataset;
+}
+chunkMWMSFIWN_cjs.__name(answersUnknownDataset, "answersUnknownDataset");
+
+// src/http/abortable-sleep.ts
+function sleep(ms, signal) {
+  return new Promise((resolve) => {
+    if (isAborted(signal)) {
+      resolve();
+      return;
+    }
+    const done = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name(() => {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", done);
+      resolve();
+    }, "done");
+    const timer = setTimeout(done, ms);
+    signal?.addEventListener("abort", done, { once: true });
+  });
+}
+chunkMWMSFIWN_cjs.__name(sleep, "sleep");
+function isAborted(signal) {
+  return signal?.aborted === true;
+}
+chunkMWMSFIWN_cjs.__name(isAborted, "isAborted");
+
+// src/http/request-timeout.ts
+var MAX_TIMER_DELAY_MS = 2147483647;
+function isTimerDelay(value) {
+  return typeof value === "number" && value >= 1 && value <= MAX_TIMER_DELAY_MS;
+}
+chunkMWMSFIWN_cjs.__name(isTimerDelay, "isTimerDelay");
+function assertRequestTimeout(timeout) {
+  if (isTimerDelay(timeout)) return;
+  throw new Error(
+    `timeout must be a number of milliseconds from 1 to ${MAX_TIMER_DELAY_MS} \u2014 a timer given 0, NaN, Infinity or more fires at once and ends every request \u2014 and got ${String(timeout)}`
+  );
+}
+chunkMWMSFIWN_cjs.__name(assertRequestTimeout, "assertRequestTimeout");
 
 // src/http/http-client.ts
 var _HttpClient = class _HttpClient {
@@ -1118,33 +989,6 @@ var _HttpClient = class _HttpClient {
     this.connection = connectionFor(config);
     this.announce();
   }
-  /**
-   * A view of this client that sends every request through it with `headers` added — beneath the
-   * request's own, over this client's — and changes nothing else: its key, base URL, timeout,
-   * retries and `fetch` are this client's as they are when each request is sent, so a later
-   * `configure()` or `setApiKey()` on this client reaches the view, and one on the view reaches
-   * this client. `client.with({ dataset })` is one (REL-2417).
-   */
-  withHeaders(headers) {
-    const view = new _HttpClient(this.connection.config);
-    view.view = { client: this, headers: { ...headers } };
-    return view;
-  }
-  /**
-   * Run on `config` from now on: every later request — whoever holds this client — is sent to its
-   * `baseUrl`, with its headers, key and dataset, its timeout and retries, through its `fetch`, and
-   * logged by its `debug` options.
-   *
-   * The client's own `updateConfig()` calls this rather than building a second client, so a
-   * `content()` or other sub-client taken before the update sends through the update too. Anything
-   * set on this client since it was last configured — `setDefaultHeaders()`, `setBaseUrl()` — is
-   * replaced by what `config` says.
-   */
-  configure(config) {
-    if (this.view !== void 0) return this.view.client.configure(config);
-    this.connection = connectionFor(config);
-    this.announce();
-  }
   announce() {
     this.log("debug", "HttpClient initialized", {
       baseUrl: this.connection.baseUrl,
@@ -1153,6 +997,20 @@ var _HttpClient = class _HttpClient {
       environment: chunkTZL374LS_cjs.isBrowser() ? "browser" : "node"
     });
   }
+  /**
+   * Send bytes to an address that is not a RelyIO route — an asset upload's presigned `PUT` and its
+   * multipart parts — through the client's configured `fetch`, so a wrapper that records, proxies or
+   * forbids network access sees every request this client makes (REL-2671). Nothing else is added: no
+   * key, no retry, no timeout, because the address belongs to the storage service, not to RelyIO.
+   *
+   * Static so the instances a customer holds stay `send` and `fetchPayload` (REL-3107). The `fetch`
+   * is read per call, from the client a view sends through, like the requests are.
+   */
+  static transfer(client, url, init) {
+    const owner = client.view?.client ?? client;
+    const send = owner.connection.config.fetch ?? globalThis.fetch;
+    return send(url, init);
+  }
   /**
    * Call a route the committed document declares, and get back the body that
    * document says it serves.
@@ -1222,6 +1080,11 @@ var _HttpClient = class _HttpClient {
     if (config.method === "DELETE" && mergedConfig.headers) {
       mergedConfig.headers = layerHeaders(mergedConfig.headers, { "Content-Type": null });
     }
+    let preview = derivedPreviewIn(mergedConfig.headers);
+    if (preview !== void 0 && (isUnknownPreview(preview) || !isPreviewKey(headerValue(mergedConfig.headers, API_KEY_HEADER)))) {
+      mergedConfig.headers = layerHeaders(mergedConfig.headers ?? {}, { [DATASET_HEADER]: null });
+      preview = void 0;
+    }
     for (let attempt = 1; ; attempt++) {
       try {
         const response = await this.makeRequest(mergedConfig.url, mergedConfig);
@@ -1250,6 +1113,10 @@ var _HttpClient = class _HttpClient {
           method: mergedConfig.method,
           attempt
         });
+        if (preview !== void 0 && answersUnknownDataset(sdkError, preview)) {
+          rememberUnknownPreview(preview);
+          return this.request(config);
+        }
         this.log("error", "Request failed after all retries", {
           error: sdkError.toJSON(),
           url: mergedConfig.url
@@ -1258,122 +1125,6 @@ var _HttpClient = class _HttpClient {
       }
     }
   }
-  /**
-   * Make a GET request
-   */
-  async get(url, params) {
-    return this.request({
-      method: "GET",
-      url,
-      params
-    });
-  }
-  /**
-   * Make a POST request
-   */
-  async post(url, data, params) {
-    return this.request({
-      method: "POST",
-      url,
-      body: data,
-      params
-    });
-  }
-  /**
-   * Make a PUT request
-   */
-  async put(url, data, params) {
-    return this.request({
-      method: "PUT",
-      url,
-      body: data,
-      params
-    });
-  }
-  /**
-   * Make a DELETE request
-   */
-  async delete(url, params) {
-    return this.request({
-      method: "DELETE",
-      url,
-      params
-    });
-  }
-  /**
-   * Make a PATCH request
-   */
-  async patch(url, data, params) {
-    return this.request({
-      method: "PATCH",
-      url,
-      body: data,
-      params
-    });
-  }
-  /**
-   * Add headers to every later request, each replacing any header of the same name — the name
-   * matched without regard to case — until the client is next configured.
-   */
-  setDefaultHeaders(headers) {
-    if (this.view !== void 0) return this.view.client.setDefaultHeaders(headers);
-    this.connection = {
-      ...this.connection,
-      defaultHeaders: layerHeaders(this.connection.defaultHeaders, headers)
-    };
-  }
-  /**
-   * Replace the key every later request sends as `X-API-Key`, and the `apiKey` the configuration
-   * reports.
-   *
-   * The key is read the way construction reads it (`presentKey`): an absent, empty or blank key is
-   * no key, so the header is dropped and the next request is refused with `MissingApiKeyError`
-   * before anything is sent. A key header of any other spelling — one given in `headers` — goes
-   * too, from the headers sent and from the headers the configuration reports, so the old key is
-   * never sent beside the new one.
-   *
-   * The configuration is the one the owning `TypedRelyIOClient` holds (it hands its own to the
-   * constructor), so its `getConfig().apiKey` — what a surface reads to decide a key's kind — is the
-   * key sent from here on.
-   *
-   * This replaced `setAuthToken`, which added `Authorization: Bearer` beside an `X-API-Key` it
-   * never touched: the API reads `X-API-Key` first, so the old key was the one used (REL-1385).
-   */
-  setApiKey(apiKey) {
-    if (this.view !== void 0) return this.view.client.setApiKey(apiKey);
-    const { config } = this.connection;
-    config.apiKey = apiKey;
-    config.headers = layerHeaders(config.headers, { [API_KEY_HEADER]: null });
-    this.connection = {
-      ...this.connection,
-      defaultHeaders: layerHeaders(this.connection.defaultHeaders, {
-        [API_KEY_HEADER]: presentKey(apiKey) ?? null
-      })
-    };
-  }
-  /**
-   * Get current default headers
-   */
-  getDefaultHeaders() {
-    if (this.view !== void 0) {
-      return layerHeaders(this.view.client.getDefaultHeaders(), this.view.headers);
-    }
-    return { ...this.connection.defaultHeaders };
-  }
-  /**
-   * Update base URL
-   */
-  setBaseUrl(baseUrl) {
-    if (this.view !== void 0) return this.view.client.setBaseUrl(baseUrl);
-    this.connection = { ...this.connection, baseUrl };
-  }
-  /**
-   * Get current base URL
-   */
-  getBaseUrl() {
-    if (this.view !== void 0) return this.view.client.getBaseUrl();
-    return this.connection.baseUrl;
-  }
   /**
    * One attempt.
    *
@@ -1519,10 +1270,11 @@ var _HttpClient = class _HttpClient {
     if (contentType.includes("text/")) {
       return await response.text();
     }
+    const text = await response.text();
     try {
-      return await response.json();
+      return JSON.parse(text);
     } catch {
-      return await response.text();
+      return text;
     }
   }
   resolveUrl(url) {
@@ -1577,8 +1329,73 @@ var _HttpClient = class _HttpClient {
 };
 chunkMWMSFIWN_cjs.__name(_HttpClient, "HttpClient");
 var HttpClient = _HttpClient;
+var _ControlledHttpClient = class _ControlledHttpClient extends HttpClient {
+  /**
+   * A view of this client that sends every request through it with `headers` added — beneath the
+   * request's own, over this client's — and changes nothing else: its key, base URL, timeout,
+   * retries and `fetch` are this client's as they are when each request is sent, so a later
+   * `configure()` or `setApiKey()` on this client reaches the view, and one on the view reaches
+   * this client. `client.with({ dataset })` is one (REL-2417).
+   */
+  withHeaders(headers) {
+    const view = new _ControlledHttpClient(this.connection.config);
+    view.view = { client: this, headers: { ...headers } };
+    return view;
+  }
+  /**
+   * Run on `config` from now on: every later request — whoever holds this client — is sent to its
+   * `baseUrl`, with its headers, key and dataset, its timeout and retries, through its `fetch`, and
+   * logged by its `debug` options.
+   *
+   * The client's own `updateConfig()` calls this rather than building a second client, so a
+   * `content()` or other sub-client taken before the update sends through the update too. Anything
+   * set on this client since it was last configured — `setApiKey()` — is replaced by what `config`
+   * says.
+   */
+  configure(config) {
+    if (this.view !== void 0) return this.view.client.configure(config);
+    this.connection = connectionFor(config);
+    this.announce();
+  }
+  /**
+   * Replace the key every later request sends as `X-API-Key`, and the `apiKey` the configuration
+   * reports.
+   *
+   * The key is read the way construction reads it (`presentKey`): an absent, empty or blank key is
+   * no key, so the header is dropped and the next request is refused with `MissingApiKeyError`
+   * before anything is sent. A key header of any other spelling — one given in `headers` — goes
+   * too, from the headers sent and from the headers the configuration reports, so the old key is
+   * never sent beside the new one.
+   *
+   * The configuration is the one the owning `TypedRelyIOClient` holds (it hands its own to the
+   * constructor), so its `getConfig().apiKey` — what a surface reads to decide a key's kind — is the
+   * key sent from here on.
+   *
+   * This replaced `setAuthToken`, which added `Authorization: Bearer` beside an `X-API-Key` it
+   * never touched: the API reads `X-API-Key` first, so the old key was the one used (REL-1385).
+   */
+  setApiKey(apiKey) {
+    if (this.view !== void 0) return this.view.client.setApiKey(apiKey);
+    const { config } = this.connection;
+    config.apiKey = apiKey;
+    config.headers = layerHeaders(config.headers, { [API_KEY_HEADER]: null });
+    this.connection = {
+      ...this.connection,
+      defaultHeaders: layerHeaders(this.connection.defaultHeaders, {
+        [API_KEY_HEADER]: presentKey(apiKey) ?? null
+      })
+    };
+  }
+};
+chunkMWMSFIWN_cjs.__name(_ControlledHttpClient, "ControlledHttpClient");
+var ControlledHttpClient = _ControlledHttpClient;
 var API_KEY_HEADER = "X-API-Key";
 var DATASET_HEADER = "X-RelyIO-Dataset";
+function derivedPreviewIn(headers) {
+  const dataset = headerValue(headers, DATASET_HEADER);
+  return dataset !== void 0 && isDerivedPreview(dataset) ? dataset : void 0;
+}
+chunkMWMSFIWN_cjs.__name(derivedPreviewIn, "derivedPreviewIn");
 var BROWSER_CONTROLLED_HEADERS = /* @__PURE__ */ new Set([
   "user-agent",
   "referer",
@@ -1607,13 +1424,7 @@ function connectionFor(config) {
     // The policy, not a predicate over `(error, attempt)`: whether a request may be sent again is a
     // property of the **route** as much as of the refusal, and a callback that never sees the
     // request cannot express that.
-    retryPolicy: new DefaultRetryPolicy({
-      maxAttempts: config.retryAttempts,
-      baseDelay: 1e3,
-      maxDelay: 1e4,
-      backoffFactor: 2,
-      jitter: true
-    })
+    retryPolicy: retryPolicyFor(config.retryAttempts)
   };
 }
 chunkMWMSFIWN_cjs.__name(connectionFor, "connectionFor");
@@ -1642,7 +1453,7 @@ chunkMWMSFIWN_cjs.__name(credentialsModeFor, "credentialsModeFor");
 // src/http/write-options.ts
 function versionCheckOf(entry) {
   const { id, locale, version, sharedVersion } = entry._metadata;
-  return { id, locale, ifMatch: entityTag({ entryUid: id, locale, version, sharedVersion }) };
+  return { id, locale, ifMatch: chunk6PTRZP5U_cjs.entityTag({ entryUid: id, locale, version, sharedVersion }) };
 }
 chunkMWMSFIWN_cjs.__name(versionCheckOf, "versionCheckOf");
 function mintIdempotencyKey() {
@@ -1654,11 +1465,11 @@ chunkMWMSFIWN_cjs.__name(mintIdempotencyKey, "mintIdempotencyKey");
 function writeHeaders(options) {
   const headers = {};
   if (options?.ifMatch !== void 0) {
-    headers[HEADER_IF_MATCH.name] = options.ifMatch;
+    headers[chunk6PTRZP5U_cjs.HEADER_IF_MATCH.name] = options.ifMatch;
   }
   const idempotencyKey = options?.idempotencyKey ?? mintIdempotencyKey();
   if (idempotencyKey !== void 0) {
-    headers[HEADER_IDEMPOTENCY_KEY.name] = idempotencyKey;
+    headers[chunk6PTRZP5U_cjs.HEADER_IDEMPOTENCY_KEY.name] = idempotencyKey;
   }
   return Object.keys(headers).length > 0 ? headers : void 0;
 }
@@ -1755,7 +1566,7 @@ function writeDocumentTerms(query, options, clientLocale) {
     query.include = options.include.join(",");
   }
   writeLocale(query, options.locale ?? clientLocale);
-  if (typeof options.fresh === "string") query[FRESH_PARAMETER] = options.fresh;
+  if (typeof options.fresh === "string") query[chunk6PTRZP5U_cjs.FRESH_PARAMETER] = options.fresh;
 }
 chunkMWMSFIWN_cjs.__name(writeDocumentTerms, "writeDocumentTerms");
 function writeLocale(query, locale) {
@@ -1773,6 +1584,10 @@ function writeLocale(query, locale) {
   query.locales = locale.join(",");
 }
 chunkMWMSFIWN_cjs.__name(writeLocale, "writeLocale");
+function signalOf(options) {
+  return options.signal === void 0 ? {} : { signal: options.signal };
+}
+chunkMWMSFIWN_cjs.__name(signalOf, "signalOf");
 function readHeaders(options) {
   const headers = {};
   if (options.dataset !== void 0) headers[DATASET_HEADER] = options.dataset;
@@ -1826,7 +1641,8 @@ var _EntryHandle = class _EntryHandle {
       {
         path: { contentType: this.typeName },
         query: listQuery(options, this.clientLocale()),
-        headers: readHeaders(options)
+        headers: readHeaders(options),
+        ...signalOf(options)
       }
     );
     return response.body;
@@ -1881,7 +1697,8 @@ var _EntryHandle = class _EntryHandle {
       return await this.httpClient.fetchPayload("/v1/{contentType}/{id}", "get", {
         path: { contentType: this.typeName, id: idOrSlug },
         query: entryQuery(options, this.clientLocale()),
-        headers: readHeaders(options)
+        headers: readHeaders(options),
+        ...signalOf(options)
       });
     } catch (error) {
       if (isMissingEntry(error)) return null;
@@ -1919,7 +1736,10 @@ var EntryHandle = _EntryHandle;
 // src/content/content-client.ts
 var _ContentClient = class _ContentClient extends EntryHandle {
   /**
-   * Create a new content entry.
+   * Create a new content entry, published. The answer's `_metadata.warnings` lists each reference
+   * the content type declares `weak` that the create made live while the entry it points at is
+   * unpublished (`REFERENCE_NOT_PUBLISHED`) — `[]` when there are none; the create is never refused
+   * for them.
    *
    * `locale` defaults to the client's own, and `dataset` to the client's (`client.with({ dataset })`
    * sets it for every call).
@@ -1948,7 +1768,7 @@ var _ContentClient = class _ContentClient extends EntryHandle {
    * Versions are numbered per locale, so this is one locale's timeline: `locale` defaults to the
    * client's own, else the schema default; no fallback is applied, and a locale
    * with no history returns an empty array rather than another locale's rows. Every row names the
-   * locale it belongs to.
+   * locale it belongs to, and holds that locale's fields under `fields`.
    */
   async versions(id, options) {
     const locale = callLocale(options?.locale, this.clientLocale());
@@ -1969,6 +1789,9 @@ var _ContentClient = class _ContentClient extends EntryHandle {
    * There is no `null`: a version the locale does not have, an entry that is not there, a type the
    * schema does not declare and a dataset with no schema all throw `ResourceNotFoundError`, its
    * `context.resourceType` naming which (REL-2409 Q12).
+   *
+   * It answers the version, not the entry: that locale's own fields as the version stored them, and
+   * `_metadata` with `status: 'version'` ({@link ContentVersion}).
    */
   async version(id, options) {
     const locale = callLocale(options.locale, this.clientLocale());
@@ -2024,7 +1847,8 @@ var _ContentClient = class _ContentClient extends EntryHandle {
     const response = await this.httpClient.send("/v1/{contentType}/{id}/children", "get", {
       path: { contentType: this.typeName, id },
       query: childrenQuery(options, this.clientLocale()),
-      headers: readHeaders(options)
+      headers: readHeaders(options),
+      ...signalOf(options)
     });
     return response.body;
   }
@@ -2558,7 +2382,7 @@ var _AssetUploadBuilder = class _AssetUploadBuilder {
     }
     const total = this.file.size;
     this.emitProgress(0, total);
-    const uploadResponse = await fetch(presigned.uploadUrl, {
+    const uploadResponse = await HttpClient.transfer(this.httpClient, presigned.uploadUrl, {
       method: presigned.method,
       headers: presigned.headers,
       body: this.file
@@ -2625,7 +2449,10 @@ var _AssetUploadBuilder = class _AssetUploadBuilder {
     for (let attempt = 0; attempt <= this._maxPartRetries; attempt += 1) {
       try {
         const { url } = await fileBuilder.signPart({ ...target, partNumber });
-        const response = await fetch(url, { method: "PUT", body: blob });
+        const response = await HttpClient.transfer(this.httpClient, url, {
+          method: "PUT",
+          body: blob
+        });
         if (!response.ok) {
           const retriable = response.status >= 500 || response.status === 408 || response.status === 429;
           if (!retriable) {
@@ -2810,14 +2637,18 @@ var _SingletonClient = class _SingletonClient extends DocumentHandle {
       return await this.httpClient.fetchPayload("/v1/singletons/{key}", "get", {
         path: { key: this.name },
         query: documentQuery(options, this.clientLocale()),
-        headers: readHeaders(options)
+        headers: readHeaders(options),
+        ...signalOf(options)
       });
     } catch (error) {
       if (isMissingEntry(error)) return null;
       throw error;
     }
   }
-  /** The API publishes on PATCH: there is no separate publish route. */
+  /**
+   * The API publishes on PATCH: there is no separate publish route. The answer's `_metadata` also
+   * lists the links the write left pointing nowhere and its `warnings` (REL-3097).
+   */
   patch(write, options) {
     return this.httpClient.fetchPayload(
       "/v1/singletons/{key}",
@@ -2833,14 +2664,10 @@ var _SingletonClient = class _SingletonClient extends DocumentHandle {
     return this.httpClient.fetchPayload("/v1/singletons/{key}/versions", "get", { path: { key: this.name }, query });
   }
   readVersion(versionNumber, query) {
-    return this.httpClient.fetchPayload(
-      "/v1/singletons/{key}/versions/{versionNumber}",
-      "get",
-      {
-        path: { key: this.name, versionNumber },
-        query
-      }
-    );
+    return this.httpClient.fetchPayload("/v1/singletons/{key}/versions/{versionNumber}", "get", {
+      path: { key: this.name, versionNumber },
+      query
+    });
   }
 };
 chunkMWMSFIWN_cjs.__name(_SingletonClient, "SingletonClient");
@@ -2873,22 +2700,19 @@ var _SettingsClient = class _SettingsClient extends DocumentHandle {
       {
         path: { groupId: this.name },
         query: documentQuery(options, this.clientLocale()),
-        headers: readHeaders(options)
+        headers: readHeaders(options),
+        ...signalOf(options)
       }
     );
   }
   async reset(...args) {
     const [first, second] = args;
     const write = first !== void 0 && isRead(first) ? { ...versionCheckOf(first), options: second } : { locale: this.localeOf(first?.locale), ifMatch: void 0, options: first };
-    return this.httpClient.fetchPayload(
-      "/v1/settings/{groupId}/reset",
-      "post",
-      {
-        path: { groupId: this.name },
-        query: write.locale === void 0 ? void 0 : { locale: write.locale },
-        headers: DocumentHandle.headersOf(write, write.options)
-      }
-    );
+    return this.httpClient.fetchPayload("/v1/settings/{groupId}/reset", "post", {
+      path: { groupId: this.name },
+      query: write.locale === void 0 ? void 0 : { locale: write.locale },
+      headers: DocumentHandle.headersOf(write, write.options)
+    });
   }
   /** The group's default values, as the schema declares them. */
   async getDefaults() {
@@ -2924,7 +2748,7 @@ var SettingsClient = _SettingsClient;
 
 // src/changes/changes.ts
 var CHANGES_POLL_TIMEOUT_MS = 25e3 + 5e3;
-var EXPIRED_REASONS = {
+var EXPIRED_REASONS2 = {
   retention: "retention",
   "dataset-replaced": "dataset-replaced",
   "ahead-of-head": "ahead-of-head",
@@ -2944,7 +2768,7 @@ var _ChangesExpiredError = class _ChangesExpiredError extends ResourceExpiredErr
      */
     chunkMWMSFIWN_cjs.__publicField(this, "fresh");
     this.name = "ChangesExpiredError";
-    this.reason = expiredReasonOf(message);
+    this.reason = expiredReasonOf(context?.reason);
     this.fresh = fresh;
   }
   /** The base class rebuilds from its four arguments, which would drop the position resynced to. */
@@ -2974,16 +2798,16 @@ var _ChangesExpiredError = class _ChangesExpiredError extends ResourceExpiredErr
       `The live edge cannot list the changes since this cursor (${reason}). Refetch everything derived from the feed; it continues from the position it sent.`,
       410,
       void 0,
-      { transport: "live-edge" },
+      { transport: "live-edge", reason },
       cursor
     );
   }
 };
 chunkMWMSFIWN_cjs.__name(_ChangesExpiredError, "ChangesExpiredError");
 var ChangesExpiredError = _ChangesExpiredError;
-function expiredReasonOf(message) {
-  for (const reason of Object.values(EXPIRED_REASONS)) {
-    if (message.includes(`(${reason})`)) return reason;
+function expiredReasonOf(named) {
+  for (const reason of Object.values(EXPIRED_REASONS2)) {
+    if (named === reason) return reason;
   }
   return "unknown";
 }
@@ -3063,10 +2887,6 @@ async function pollOnce(http, since, options) {
 }
 chunkMWMSFIWN_cjs.__name(pollOnce, "pollOnce");
 
-// src/config/key-kind.ts
-var PUBLISHABLE_KEY_PREFIX = "rly_pub_";
-var isPublishableKey = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((apiKey) => apiKey?.startsWith(PUBLISHABLE_KEY_PREFIX) === true, "isPublishableKey");
-
 // src/errors/live-errors.ts
 var _LiveEdgeError = class _LiveEdgeError extends SDKError {
   constructor(message, end, retry, options = {}) {
@@ -3082,19 +2902,6 @@ var _LiveEdgeError = class _LiveEdgeError extends SDKError {
     this.retryable = retry !== "stop";
     this.retryAfterMs = options.retryAfterMs;
   }
-  /**
-   * The base class rebuilds an error through its own four-argument constructor, which this class
-   * does not have; rebuilt that way, `end` would be a string and `retry` a number.
-   */
-  withContext(context) {
-    const rebuilt = new _LiveEdgeError(this.message, this.end, this.retry, {
-      ...this.statusCode === void 0 ? {} : { statusCode: this.statusCode },
-      ...this.cause === void 0 ? {} : { cause: this.cause },
-      ...this.retryAfterMs === void 0 ? {} : { retryAfterMs: this.retryAfterMs },
-      context: { ...this.context, ...context }
-    });
-    return rebuilt;
-  }
   getUserMessage() {
     return this.message;
   }
@@ -3114,8 +2921,8 @@ var HTTP_SCHEME_OF = {
 };
 function liveEdgeAddress(config) {
   if (config.liveUrl !== void 0) return readLiveUrl(config.liveUrl);
-  const derived = originOf(config.baseUrl);
-  const edge = derived === void 0 ? void 0 : LIVE_EDGE_OF_API[derived];
+  const derived2 = originOf(config.baseUrl);
+  const edge = derived2 === void 0 ? void 0 : LIVE_EDGE_OF_API[derived2];
   if (edge !== void 0) return { ok: true, url: new URL(edge) };
   return {
     ok: false,
@@ -3154,7 +2961,7 @@ chunkMWMSFIWN_cjs.__name(originOf, "originOf");
 
 // src/changes/live-edge.ts
 var LIVE_KEEPALIVE_INTERVAL_MS = 3e4;
-var LIVE_SOCKET_OPEN_TIMEOUT_MS = VISITOR_POLL_INTERVAL_MS;
+var LIVE_SOCKET_OPEN_TIMEOUT_MS = chunk6PTRZP5U_cjs.VISITOR_POLL_INTERVAL_MS;
 var LIVE_POLLS_BEFORE_SOCKET = 4;
 async function* subscribeLiveEdge(client, options = {}) {
   const { signal } = options;
@@ -3224,12 +3031,12 @@ async function* followSocket(socket, reach, options) {
           return "unopened";
         }
         case "message": {
-          if (event.data === VISITOR_KEEPALIVE.response) continue;
-          const frame = typeof event.data === "string" ? parseVisitorFrame(event.data) : null;
+          if (event.data === chunk6PTRZP5U_cjs.VISITOR_KEEPALIVE.response) continue;
+          const frame = typeof event.data === "string" ? chunk6PTRZP5U_cjs.parseVisitorFrame(event.data) : null;
           if (frame === null)
             throw unreadable(`a frame the wire does not declare: ${sample(event.data)}`);
           switch (frame.type) {
-            case VISITOR_FRAMES.opened: {
+            case chunk6PTRZP5U_cjs.VISITOR_FRAMES.opened: {
               caughtUp = true;
               inbox.caughtUp();
               reach.position = frame.cursor;
@@ -3237,7 +3044,7 @@ async function* followSocket(socket, reach, options) {
               options.reached?.(frame.cursor);
               continue;
             }
-            case VISITOR_FRAMES.changes: {
+            case chunk6PTRZP5U_cjs.VISITOR_FRAMES.changes: {
               const prior = reach.position;
               if (prior === void 0) throw unreadable("changes before the socket had a position");
               for (const change of changesOf(frame.changes, frame.cursor, prior)) {
@@ -3248,7 +3055,7 @@ async function* followSocket(socket, reach, options) {
               if (frame.changes.length === 0) options.reached?.(frame.cursor);
               continue;
             }
-            case VISITOR_FRAMES.resync: {
+            case chunk6PTRZP5U_cjs.VISITOR_FRAMES.resync: {
               await expire(frame.reason, frame.cursor, options);
               if (isAborted(signal)) return "aborted";
               reach.position = frame.cursor;
@@ -3320,7 +3127,7 @@ function socketInbox(socket, signal) {
           return;
         }
         heard = false;
-        if (socket.readyState === SOCKET_OPEN) socket.send(VISITOR_KEEPALIVE.request);
+        if (socket.readyState === SOCKET_OPEN) socket.send(chunk6PTRZP5U_cjs.VISITOR_KEEPALIVE.request);
       }, LIVE_KEEPALIVE_INTERVAL_MS);
     },
     caughtUp() {
@@ -3356,28 +3163,27 @@ var AFTER_A_CLOSE = {
   "back-off": "Retrying after a back-off of at least a minute, without polling, which the same admission refuses."
 };
 function closeRetryOf(code) {
-  if (hasOwn(VISITOR_CLOSE_RETRY, code)) return VISITOR_CLOSE_RETRY[code];
+  if (hasOwn(chunk6PTRZP5U_cjs.VISITOR_CLOSE_RETRY, code)) return chunk6PTRZP5U_cjs.VISITOR_CLOSE_RETRY[code];
   return code < 4e3 ? "retry" : "stop";
 }
 chunkMWMSFIWN_cjs.__name(closeRetryOf, "closeRetryOf");
 var CLOSE_MEANING = {
-  [VISITOR_CLOSE_CODES.requestInvalid]: "the edge could not read the request \u2014 a malformed cursor or filter",
-  [VISITOR_CLOSE_CODES.keyRefused]: "the key is not a publishable key the edge accepts \u2014 unknown, revoked or expired",
-  [VISITOR_CLOSE_CODES.originRefused]: "this page\u2019s origin is not on the publishable key\u2019s allowed origins",
-  [VISITOR_CLOSE_CODES.datasetRefused]: "`dataset` names no dataset the key reaches",
-  // Also how the edge hands a connection on when the project's live objects move to another
-  // placement (reason `moved`, REL-1514): either way the same request succeeds again shortly.
-  [VISITOR_CLOSE_CODES.unavailable]: "the edge could not serve this connection just now \u2014 it could not reach what it needed, or it moved the project\u2019s live connections elsewhere",
-  [VISITOR_CLOSE_CODES.allowanceReached]: "the project holds as many live connections as its plan allows",
-  [VISITOR_CLOSE_CODES.addressLimitReached]: "this address holds as many live connections to the project as one address may",
-  [VISITOR_CLOSE_CODES.ceilingReached]: "the project is at its safety ceiling of live connections"
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.requestInvalid]: "the edge could not read the request \u2014 a malformed cursor or filter",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.keyRefused]: "the key is not a publishable key the edge accepts \u2014 unknown, revoked or expired",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.originRefused]: "this page\u2019s origin is not on the publishable key\u2019s allowed origins",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.datasetRefused]: "`dataset` names no dataset the key reaches",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.unavailable]: "the edge could not serve this connection just now \u2014 it could not reach what it needed",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.allowanceReached]: "the project holds as many live connections as its plan allows",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.addressLimitReached]: "this address holds as many live connections to the project as one address may",
+  [chunk6PTRZP5U_cjs.VISITOR_CLOSE_CODES.ceilingReached]: "the project is at its safety ceiling of live connections"
 };
 async function* followPolls(client, request, reach, options) {
   const { signal } = options;
+  let starting = reach.position === void 0;
   for (let poll = 0; poll < LIVE_POLLS_BEFORE_SOCKET; poll += 1) {
     if (isAborted(signal)) return "aborted";
     const answer = await pollOnce2(client, request, reach.position, signal);
-    if (answer === void 0) return "aborted";
+    if (answer === void 0 || isAborted(signal)) return "aborted";
     options.opened?.();
     if (answer.kind === "resync") {
       await expire(answer.reason, answer.cursor, options);
@@ -3394,9 +3200,10 @@ async function* followPolls(client, request, reach, options) {
         if (isAborted(signal)) return "aborted";
       }
       reach.position = answer.cursor;
-      if (answer.changes.length === 0) options.reached?.(answer.cursor);
+      if (starting) options.reached?.(answer.cursor);
     }
-    await sleep(VISITOR_POLL_INTERVAL_MS, signal);
+    starting = false;
+    await sleep(chunk6PTRZP5U_cjs.VISITOR_POLL_INTERVAL_MS, signal);
   }
   return isAborted(signal) ? "aborted" : "socket";
 }
@@ -3438,7 +3245,7 @@ async function pollOnce2(client, request, since, signal) {
     }
     const body = parseJson(text);
     if (!response.ok) throw refusedPoll(response, body, context);
-    const answer = readVisitorPollAnswer(isRecord(body) ? body["data"] : void 0);
+    const answer = chunk6PTRZP5U_cjs.readVisitorPollAnswer(isRecord(body) ? body["data"] : void 0);
     if (answer === null)
       throw unreadable(`a poll answer the wire does not declare: ${sample(text)}`);
     return answer;
@@ -3458,13 +3265,13 @@ function refusedPoll(response, body, context) {
     { ...context, method: "GET" }
   );
   const refusal = readError(body);
-  if (refusal === void 0 || !hasOwn(VISITOR_POLL_RETRY, refusal.code)) return mapped;
+  if (refusal === void 0 || !hasOwn(chunk6PTRZP5U_cjs.VISITOR_POLL_RETRY, refusal.code)) return mapped;
   const code = refusal.code;
   const retryAfterMs = parseRetryAfterMs(headerValue(headers, "Retry-After"), Date.now());
   return new LiveEdgeError(
     `The live edge refused a poll (${code}): ${refusal.messages[0] ?? mapped.message}`,
     { kind: "refused", code },
-    VISITOR_POLL_RETRY[code],
+    chunk6PTRZP5U_cjs.VISITOR_POLL_RETRY[code],
     {
       statusCode: response.status,
       cause: mapped,
@@ -3492,17 +3299,17 @@ function edgeRequest(client, filter) {
 chunkMWMSFIWN_cjs.__name(edgeRequest, "edgeRequest");
 function edgeUrl(request, since, transport, clientId) {
   const url = new URL(request.base.href);
-  url.pathname = `${url.pathname.replace(/\/+$/, "")}${VISITOR_LIVE_PATH}`;
+  url.pathname = `${url.pathname.replace(/\/+$/, "")}${chunk6PTRZP5U_cjs.VISITOR_LIVE_PATH}`;
   if (transport === "socket") url.protocol = url.protocol === "http:" ? "ws:" : "wss:";
   const query = new URLSearchParams();
-  if (request.key !== void 0) query.set(VISITOR_QUERY.key, request.key);
+  if (request.key !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.key, request.key);
   if (request.dataset !== void 0 && request.dataset !== "") {
-    query.set(VISITOR_QUERY.dataset, request.dataset);
+    query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.dataset, request.dataset);
   }
-  if (since !== void 0) query.set(VISITOR_QUERY.since, since);
-  if (request.types !== void 0) query.set(VISITOR_QUERY.types, request.types.join(","));
-  if (request.ids !== void 0) query.set(VISITOR_QUERY.ids, request.ids.join(","));
-  if (transport === "poll" && clientId !== void 0) query.set(VISITOR_QUERY.client, clientId);
+  if (since !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.since, since);
+  if (request.types !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.types, request.types.join(","));
+  if (request.ids !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.ids, request.ids.join(","));
+  if (transport === "poll" && clientId !== void 0) query.set(chunk6PTRZP5U_cjs.VISITOR_QUERY.client, clientId);
   url.search = query.toString();
   return url.href;
 }
@@ -3587,8 +3394,9 @@ chunkMWMSFIWN_cjs.__name(given, "given");
 function transportOf(options) {
   const headers = readHeaders(options);
   return {
+    ...signalOf(options),
     ...headers === void 0 ? {} : { headers },
-    ...typeof options.fresh === "string" ? { query: { [FRESH_PARAMETER]: options.fresh } } : {}
+    ...typeof options.fresh === "string" ? { query: { [chunk6PTRZP5U_cjs.FRESH_PARAMETER]: options.fresh } } : {}
   };
 }
 chunkMWMSFIWN_cjs.__name(transportOf, "transportOf");
@@ -3664,7 +3472,7 @@ chunkMWMSFIWN_cjs.__name(runSimilar, "runSimilar");
 // src/batch/batch-operations.ts
 var VERBS = ["create", "update", "replace", "delete", "singleton"];
 async function runBatch(http, operations, options, clientLocale) {
-  const { atomic, dryRun, stopOnError, returnData, dataset } = options;
+  const { atomic, dryRun, stopOnError, returnData, dataset, signal } = options;
   const runOptions = {
     ...atomic === void 0 ? {} : { atomic },
     ...dryRun === void 0 ? {} : { dryRun },
@@ -3677,7 +3485,8 @@ async function runBatch(http, operations, options, clientLocale) {
       operations: operations.map((operation, index) => operationOf(operation, index, clientLocale)),
       ...Object.keys(runOptions).length === 0 ? {} : { options: runOptions }
     },
-    ...headers === void 0 ? {} : { headers }
+    ...headers === void 0 ? {} : { headers },
+    ...signalOf({ signal })
   });
   return response.body;
 }
@@ -3757,7 +3566,7 @@ async function runAdhocQuery(http, query, clientLocale) {
   const order = sort === void 0 ? [] : Object.entries(sort).flatMap(
     ([field, direction]) => direction === void 0 ? [] : [{ [field]: direction }]
   );
-  const fetch2 = {
+  const fetch = {
     contentType: query.from,
     ...where === void 0 || Object.keys(where).length === 0 ? {} : { where },
     ...include === void 0 || include.length === 0 ? {} : { include: [...include] },
@@ -3765,14 +3574,14 @@ async function runAdhocQuery(http, query, clientLocale) {
     ...limit === void 0 ? {} : { limit },
     ...page === void 0 ? {} : { offset: offsetOf(page, limit) }
   };
-  const locale = query.locale ?? clientLocale;
-  const parameters = {
-    ...query.params,
-    ...locale === void 0 || locale === "" ? {} : { locale }
-  };
+  const terms = {};
+  if (query.cursor !== void 0) terms.cursor = query.cursor;
+  writeLocale(terms, query.locale ?? clientLocale);
+  if (typeof query.fresh === "string") terms[chunk6PTRZP5U_cjs.FRESH_PARAMETER] = query.fresh;
+  const parameters = { ...query.params };
   const body = {
     query: {
-      fetch: fetch2,
+      fetch,
       ...aggregate === void 0 ? {} : { aggregate },
       ...select === void 0 || select.length === 0 ? {} : { select: Object.fromEntries(select.map((field) => [field, field])) },
       ...fullText === void 0 ? {} : { fullText }
@@ -3782,8 +3591,9 @@ async function runAdhocQuery(http, query, clientLocale) {
   const headers = readHeaders(query);
   const response = await http.send("/v1/query", "post", {
     body,
+    ...Object.keys(terms).length === 0 ? {} : { query: terms },
     ...headers === void 0 ? {} : { headers },
-    ...typeof query.fresh === "string" ? { query: { [FRESH_PARAMETER]: query.fresh } } : {}
+    ...signalOf(query)
   });
   return response.body;
 }
@@ -3800,6 +3610,9 @@ function offsetOf(page, limit) {
 chunkMWMSFIWN_cjs.__name(offsetOf, "offsetOf");
 async function runNamedQuery(http, name, options, clientLocale) {
   const locale = options.locale ?? clientLocale;
+  const terms = {};
+  if (locale !== void 0 && locale !== "") terms.locale = locale;
+  if (typeof options.fresh === "string") terms[chunk6PTRZP5U_cjs.FRESH_PARAMETER] = options.fresh;
   const headers = readHeaders(options);
   const response = await http.send(
     "/v1/queries/{name}",
@@ -3807,8 +3620,9 @@ async function runNamedQuery(http, name, options, clientLocale) {
     {
       path: { name },
       body: options.params === void 0 ? {} : { params: options.params },
-      ...locale === void 0 || locale === "" ? {} : { query: { locale } },
-      ...headers === void 0 ? {} : { headers }
+      ...Object.keys(terms).length === 0 ? {} : { query: terms },
+      ...headers === void 0 ? {} : { headers },
+      ...signalOf(options)
     }
   );
   return response.body;
@@ -3916,6 +3730,17 @@ function resolveDevOverride(dev) {
 }
 chunkMWMSFIWN_cjs.__name(resolveDevOverride, "resolveDevOverride");
 
+// src/config/preview-environment.ts
+function readPreviewAtRequest() {
+  const env = typeof process === "undefined" ? void 0 : process.env;
+  return chunk6PTRZP5U_cjs.previewAtRequest(isEnvironment(env) ? env : {});
+}
+chunkMWMSFIWN_cjs.__name(readPreviewAtRequest, "readPreviewAtRequest");
+function isEnvironment(value) {
+  return typeof value === "object" && value !== null;
+}
+chunkMWMSFIWN_cjs.__name(isEnvironment, "isEnvironment");
+
 // src/config/types.ts
 var DEFAULT_CONFIG = {
   baseUrl: "https://api.relyio.com",
@@ -3937,12 +3762,6 @@ var DEFAULT_CONFIG = {
     // 50MB
     strategies: ["memory", "stale-while-revalidate"]
   },
-  realtime: {
-    enabled: true,
-    maxReconnectAttempts: 10,
-    reconnectDelay: 1e3,
-    heartbeatInterval: 3e4
-  },
   debug: {
     enabled: false,
     logRequests: false,
@@ -3994,7 +3813,7 @@ chunkMWMSFIWN_cjs.__name(withoutKeyHeader, "withoutKeyHeader");
 function withHandshake(configured) {
   const dev = resolveDevOverride(configured.dev);
   const merged = withDefaults(
-    configured,
+    withPreview(configured),
     dev.state === "active" ? { apiKey: dev.apiKey, dataset: dev.sandbox.datasetId } : {},
     DEFAULT_CONFIG
   );
@@ -4019,6 +3838,22 @@ function withHandshake(configured) {
   return { config: merged, sandbox: sandboxStateOf(dev), configured };
 }
 chunkMWMSFIWN_cjs.__name(withHandshake, "withHandshake");
+var previewNotified = false;
+function withPreview(configured) {
+  if (configured.dataset !== void 0 || !isPreviewKey(configured.apiKey)) return configured;
+  const preview = readPreviewAtRequest();
+  if (preview.state !== "preview") return configured;
+  const dataset = chunk6PTRZP5U_cjs.previewDatasetSlug(preview.branch);
+  noteDerivedPreview(dataset);
+  if (!previewNotified) {
+    previewNotified = true;
+    console.info(
+      `[RelyIO] ${preview.host} preview deployment of "${preview.branch}" \u2014 reading its preview dataset "${dataset}".`
+    );
+  }
+  return { ...configured, dataset };
+}
+chunkMWMSFIWN_cjs.__name(withPreview, "withPreview");
 function withDefaults(base, given2, defaults) {
   const merged = new Map(Object.entries(base));
   const givenValues = new Map(Object.entries(given2 ?? {}));
@@ -4085,7 +3920,7 @@ var _TypedRelyIOClient = class _TypedRelyIOClient {
     this.config = resolved.config;
     this.configured = resolved.configured;
     this._sandbox = resolved.sandbox;
-    this.httpClient = new HttpClient(this.config);
+    this.httpClient = new ControlledHttpClient(this.config);
   }
   // ============================================================================
   // CORE CLIENTS
@@ -4110,14 +3945,16 @@ var _TypedRelyIOClient = class _TypedRelyIOClient {
   /**
    * Run a query in one call (REL-2421, REL-2409 Q22):
    *
-   * - `query({ from, … })` runs one inline, with `list`'s option names — `where` (the query
-   *   route's dialect), `include`, `select`, `sort`, `limit`, `page`, `locale`, `dataset`, `fresh` —
-   *   plus `aggregate`, `params` and `fullText`;
+   * - `query({ from, … })` runs one inline, with `list`'s options — `where`, `include`, `select`
+   *   (beside `include`), `sort`, `limit`, `cursor`, `page`, `locale` (a code, a list or `'*'`),
+   *   `dataset`, `fresh` — plus `aggregate`, `params` and `fullText`. It answers a list's envelope,
+   *   `{ data, page, meta }` (REL-2460);
    * - `query(name, { params, … })` runs the saved query the schema declares under `name`, its
-   *   `params` typed from that declaration.
+   *   `params` typed from that declaration. It answers the API's body,
+   *   `{ data: { result, metadata } }`.
    *
-   * Both answer the API's body, `{ data: { result, metadata } }`. See {@link QueryCall}. Every query
-   * is sent in the client's locale as it is then, unless it names its own.
+   * See {@link QueryCall}. Every query is sent in the client's locale as it is then, unless it names
+   * its own.
    */
   get query() {
     const call = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((target, options = {}) => typeof target === "string" ? runNamedQuery(this.httpClient, target, options, this.currentLocale()) : runAdhocQuery(this.httpClient, target, this.currentLocale()), "call");
@@ -4302,7 +4139,7 @@ var _TypedRelyIOClient = class _TypedRelyIOClient {
    * edge's URL. On a server, follow `changes()` with it instead.
    */
   liveChanges(options = {}) {
-    const { apiKey, dataset, baseUrl, liveUrl, fetch: fetch2, webSocket, timeout } = this.getConfig();
+    const { apiKey, dataset, baseUrl, liveUrl, fetch, webSocket, timeout } = this.getConfig();
     this._liveClientId ?? (this._liveClientId = randomClientId());
     return subscribeLiveEdge(
       {
@@ -4310,7 +4147,7 @@ var _TypedRelyIOClient = class _TypedRelyIOClient {
         dataset,
         baseUrl,
         liveUrl,
-        fetch: fetch2,
+        fetch,
         webSocket,
         timeout,
         clientId: this._liveClientId
@@ -4419,9 +4256,9 @@ var _TypedRelyIOClient = class _TypedRelyIOClient {
    * - an option you name replaces the value the client holds;
    * - an option left out, or given as `undefined`, keeps the value the client holds;
    * - an option with no default given as `null` is cleared — `locale`, `dataset`, `apiKey`, `dev`,
-   *   `fetch`, `browser.onCorsError`, `realtime.wsUrl`, `debug.logger` — so the client runs as though
+   *   `fetch`, `browser.onCorsError`, `debug.logger` — so the client runs as though
    *   it had never been given one. An option with a default takes no `null`;
-   * - a bag of options you name — `browser`, `cache`, `realtime`, `debug` — keeps every field of it
+   * - a bag of options you name — `browser`, `cache`, `debug` — keeps every field of it
    *   you do not name, so `updateConfig({ browser: { includeCredentials: true } })` keeps a
    *   configured `onCorsError`;
    * - `headers` is laid over the headers the client sends, a name matched without regard to case: a
@@ -4605,6 +4442,7 @@ exports.BaseValidationError = BaseValidationError;
 exports.ChangesExpiredError = ChangesExpiredError;
 exports.ConnectionError = ConnectionError;
 exports.ContentClient = ContentClient;
+exports.DefaultRetryPolicy = DefaultRetryPolicy;
 exports.ErrorMapper = ErrorMapper;
 exports.FileUploadError = FileUploadError;
 exports.FileValidationError = FileValidationError;
@@ -4617,6 +4455,7 @@ exports.LiveEdgeError = LiveEdgeError;
 exports.MethodNotAllowedError = MethodNotAllowedError;
 exports.MissingApiKeyError = MissingApiKeyError;
 exports.NetworkError = NetworkError;
+exports.PREVIEW_KEY_PREFIX = PREVIEW_KEY_PREFIX;
 exports.PUBLISHABLE_KEY_PREFIX = PUBLISHABLE_KEY_PREFIX;
 exports.PayloadTooLargeError = PayloadTooLargeError;
 exports.PlanFeatureUnavailableError = PlanFeatureUnavailableError;
@@ -4635,18 +4474,20 @@ exports.TransactionRolledBackError = TransactionRolledBackError;
 exports.TypedRelyIOClient = TypedRelyIOClient;
 exports.UnknownContractError = UnknownContractError;
 exports.UsageQuotaExceededError = UsageQuotaExceededError;
-exports.VISITOR_ADMISSION_RETRY_AFTER_SECONDS = VISITOR_ADMISSION_RETRY_AFTER_SECONDS;
 exports.ValidationError = ValidationError;
 exports.createClient = createClient;
 exports.isAborted = isAborted;
 exports.isAssetEntry = isAssetEntry;
 exports.isMissingEntry = isMissingEntry;
+exports.isPreviewKey = isPreviewKey;
 exports.isPublishableKey = isPublishableKey;
+exports.isReplaySafe = isReplaySafe;
 exports.isResourceNotFound = isResourceNotFound;
 exports.matchRoute = matchRoute;
+exports.retryPolicyFor = retryPolicyFor;
 exports.serviceInstructedDelayMs = serviceInstructedDelayMs;
 exports.sleep = sleep;
 exports.validateFile = validateFile;
 exports.versionCheckOf = versionCheckOf;
-//# sourceMappingURL=chunk-3BHDGUNS.cjs.map
-//# sourceMappingURL=chunk-3BHDGUNS.cjs.map
+//# sourceMappingURL=chunk-6E22GYPB.cjs.map
+//# sourceMappingURL=chunk-6E22GYPB.cjs.map